mcp: expand read tool catalog (#237) - #520

Open
willwashburn wants to merge 4 commits into
mainfrom
issue-237-mcp-read-surface
Open

mcp: expand read tool catalog (#237)#520
willwashburn wants to merge 4 commits into
mainfrom
issue-237-mcp-read-surface

Conversation

@willwashburn

@willwashburnwillwashburn commented Aug 3, 2026•
edited by cubic-dev-ai Bot
Loading

Copy link
Copy Markdown
Member

Summary

  • Adds burn__summary, burn__hotspots, burn__overhead, burn__overheadTrim, and burn__compare factories over the current @relayburn/sdk read facade.
  • Mirrors the SDK option types with MCP input schemas and runtime validation, including findings mode and compare fidelity controls.
  • Returns SDK results unchanged and documents the complete npm MCP catalog.
  • Adds per-tool and stdio catalog, invocation, and invalid-input coverage.

burn__compare is included because sdk.compare now exists on the current Node facade; the issue excluded it only while that SDK function was unavailable.

A registered default session scopes summary and hotspots to that session. Cross-session callers should start the server without a default session and pass filters explicitly.

Rust burn mcp-server catalog parity remains intentionally separate and is tracked in #519.

Verification

  • pnpm run build:napi
  • RELAYBURN_HOME= RELAYBURN_SDK_NAPI_BUILT=1 pnpm run test (SDK 11/11; MCP 37/37; no skips)
  • cargo test --workspace

Fixes#237

🤖 Generated with Claude Code.

Review in cubic

@coderabbitai

coderabbitaiBot commented Aug 3, 2026•
edited
Loading

Copy link
Copy Markdown

Warning

Review limit reached

@willwashburn, you've reached your PR review limit, so we couldn't start this review.

Next review available in:35 minutes

Limit details: You’ve used all 1 included review currently available under your plan.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 0406f907-9b2a-4deb-996a-0b839ba8551c

📥 Commits

Reviewing files that changed from the base of the PR and between 294b1d6 and a2b7fb7.

📒 Files selected for processing (16)
  • CHANGELOG.md
  • packages/mcp/CHANGELOG.md
  • packages/mcp/README.md
  • packages/mcp/src/end-to-end.test.ts
  • packages/mcp/src/index.ts
  • packages/mcp/src/tools/compare.test.ts
  • packages/mcp/src/tools/compare.ts
  • packages/mcp/src/tools/hotspots.test.ts
  • packages/mcp/src/tools/hotspots.ts
  • packages/mcp/src/tools/input.ts
  • packages/mcp/src/tools/overhead-trim.test.ts
  • packages/mcp/src/tools/overhead-trim.ts
  • packages/mcp/src/tools/overhead.test.ts
  • packages/mcp/src/tools/overhead.ts
  • packages/mcp/src/tools/summary.test.ts
  • packages/mcp/src/tools/summary.ts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

devin-ai-integration[bot]
devin-ai-integrationBot reviewed Aug 3, 2026
View reviewed changes

@devin-ai-integrationdevin-ai-integrationBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Devin Review found 2 potential issues.

Open in Devin Review

Comment threadpackages/mcp/src/tools/overhead-trim.ts Outdated
Comment threadpackages/mcp/src/tools/summary.ts Outdated
chatgpt-codex-connector[bot]
chatgpt-codex-connectorBot reviewed Aug 3, 2026
View reviewed changes

@chatgpt-codex-connectorchatgpt-codex-connectorBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit:d948ca35de

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment threadpackages/mcp/src/tools/hotspots.ts
Comment threadpackages/mcp/src/tools/overhead-trim.ts Outdated
cubic-dev-ai[bot]
cubic-dev-aiBot reviewed Aug 3, 2026
View reviewed changes

@cubic-dev-aicubic-dev-aiBot left a comment •
edited
Loading

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

2 issues found and verified against the latest diff

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.
<file name="packages/mcp/src/tools/compare.ts">
<violation number="1" location="packages/mcp/src/tools/compare.ts:59">
P2: Duplicate model names satisfy the advertised “at least two models” constraint but collapse to one model in the SDK, so `burn__compare` can return a non-comparison result. Validating at least two distinct model names (and advertising that constraint in the schema) would prevent this input from reaching the SDK.</violation>
</file>
<file name="packages/mcp/src/tools/summary.ts">
<violation number="1" location="packages/mcp/src/tools/summary.ts:53">
P2: When `session` is omitted, this falls back to `deps.defaultSessionId` while still applying any `project`/`since` filters, effectively ANDing the default session with those filters. Neither the tool description nor the `session` property description mentions this implicit scoping (unlike `createSessionCostTool`, which states its default explicitly), so a caller asking for project- or time-range-wide totals can silently receive numbers limited to just one session. Consider documenting the default-session fallback in the description, or skip applying it when `project`/`since` filters are supplied.</violation>
</file>

Reply with feedback, questions, or to request a fix.

Re-trigger cubic

Comment threadpackages/mcp/src/tools/input.ts Outdated
Comment threadpackages/mcp/src/tools/compare.ts
Comment threadpackages/mcp/src/tools/summary.ts
Comment threadpackages/mcp/src/end-to-end.test.ts Outdated
@willwashburnwillwashburn mentioned this pull request Aug 3, 2026
Closed
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@devin-ai-integrationdevin-ai-integration[bot]devin-ai-integration[bot] left review comments
@cubic-dev-aicubic-dev-ai[bot]cubic-dev-ai[bot] left review comments
@chatgpt-codex-connectorchatgpt-codex-connector[bot]chatgpt-codex-connector[bot] left review comments

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

mcp: expand tool catalog to cover the read surface (summary, hotspots, overhead, overhead trim)

1 participant

@willwashburn
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all \u003cpre\u003e\u003ccode\u003e blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks"); } } catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); } })(); (function(){ try { var __m = "github.com"; var __re = new RegExp('^' + "github\\.com" + '
Skip to content

mcp: expand read tool catalog (#237) - #520

Open
willwashburn wants to merge 4 commits into
mainfrom
issue-237-mcp-read-surface
Open

mcp: expand read tool catalog (#237)#520
willwashburn wants to merge 4 commits into
mainfrom
issue-237-mcp-read-surface

Conversation

@willwashburn

@willwashburnwillwashburn commented Aug 3, 2026•
edited by cubic-dev-ai Bot
Loading

Copy link
Copy Markdown
Member

Summary

  • Adds burn__summary, burn__hotspots, burn__overhead, burn__overheadTrim, and burn__compare factories over the current @relayburn/sdk read facade.
  • Mirrors the SDK option types with MCP input schemas and runtime validation, including findings mode and compare fidelity controls.
  • Returns SDK results unchanged and documents the complete npm MCP catalog.
  • Adds per-tool and stdio catalog, invocation, and invalid-input coverage.

burn__compare is included because sdk.compare now exists on the current Node facade; the issue excluded it only while that SDK function was unavailable.

A registered default session scopes summary and hotspots to that session. Cross-session callers should start the server without a default session and pass filters explicitly.

Rust burn mcp-server catalog parity remains intentionally separate and is tracked in #519.

Verification

  • pnpm run build:napi
  • RELAYBURN_HOME= RELAYBURN_SDK_NAPI_BUILT=1 pnpm run test (SDK 11/11; MCP 37/37; no skips)
  • cargo test --workspace

Fixes#237

🤖 Generated with Claude Code.

Review in cubic

@coderabbitai

coderabbitaiBot commented Aug 3, 2026•
edited
Loading

Copy link
Copy Markdown

Warning

Review limit reached

@willwashburn, you've reached your PR review limit, so we couldn't start this review.

Next review available in:35 minutes

Limit details: You’ve used all 1 included review currently available under your plan.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 0406f907-9b2a-4deb-996a-0b839ba8551c

📥 Commits

Reviewing files that changed from the base of the PR and between 294b1d6 and a2b7fb7.

📒 Files selected for processing (16)
  • CHANGELOG.md
  • packages/mcp/CHANGELOG.md
  • packages/mcp/README.md
  • packages/mcp/src/end-to-end.test.ts
  • packages/mcp/src/index.ts
  • packages/mcp/src/tools/compare.test.ts
  • packages/mcp/src/tools/compare.ts
  • packages/mcp/src/tools/hotspots.test.ts
  • packages/mcp/src/tools/hotspots.ts
  • packages/mcp/src/tools/input.ts
  • packages/mcp/src/tools/overhead-trim.test.ts
  • packages/mcp/src/tools/overhead-trim.ts
  • packages/mcp/src/tools/overhead.test.ts
  • packages/mcp/src/tools/overhead.ts
  • packages/mcp/src/tools/summary.test.ts
  • packages/mcp/src/tools/summary.ts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

devin-ai-integration[bot]
devin-ai-integrationBot reviewed Aug 3, 2026
View reviewed changes

@devin-ai-integrationdevin-ai-integrationBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Devin Review found 2 potential issues.

Open in Devin Review

Comment threadpackages/mcp/src/tools/overhead-trim.ts Outdated
Comment threadpackages/mcp/src/tools/summary.ts Outdated
chatgpt-codex-connector[bot]
chatgpt-codex-connectorBot reviewed Aug 3, 2026
View reviewed changes

@chatgpt-codex-connectorchatgpt-codex-connectorBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit:d948ca35de

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment threadpackages/mcp/src/tools/hotspots.ts
Comment threadpackages/mcp/src/tools/overhead-trim.ts Outdated
cubic-dev-ai[bot]
cubic-dev-aiBot reviewed Aug 3, 2026
View reviewed changes

@cubic-dev-aicubic-dev-aiBot left a comment •
edited
Loading

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

2 issues found and verified against the latest diff

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.
<file name="packages/mcp/src/tools/compare.ts">
<violation number="1" location="packages/mcp/src/tools/compare.ts:59">
P2: Duplicate model names satisfy the advertised “at least two models” constraint but collapse to one model in the SDK, so `burn__compare` can return a non-comparison result. Validating at least two distinct model names (and advertising that constraint in the schema) would prevent this input from reaching the SDK.</violation>
</file>
<file name="packages/mcp/src/tools/summary.ts">
<violation number="1" location="packages/mcp/src/tools/summary.ts:53">
P2: When `session` is omitted, this falls back to `deps.defaultSessionId` while still applying any `project`/`since` filters, effectively ANDing the default session with those filters. Neither the tool description nor the `session` property description mentions this implicit scoping (unlike `createSessionCostTool`, which states its default explicitly), so a caller asking for project- or time-range-wide totals can silently receive numbers limited to just one session. Consider documenting the default-session fallback in the description, or skip applying it when `project`/`since` filters are supplied.</violation>
</file>

Reply with feedback, questions, or to request a fix.

Re-trigger cubic

Comment threadpackages/mcp/src/tools/input.ts Outdated
Comment threadpackages/mcp/src/tools/compare.ts
Comment threadpackages/mcp/src/tools/summary.ts
Comment threadpackages/mcp/src/end-to-end.test.ts Outdated
@willwashburnwillwashburn mentioned this pull request Aug 3, 2026
Closed
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@devin-ai-integrationdevin-ai-integration[bot]devin-ai-integration[bot] left review comments
@cubic-dev-aicubic-dev-ai[bot]cubic-dev-ai[bot] left review comments
@chatgpt-codex-connectorchatgpt-codex-connector[bot]chatgpt-codex-connector[bot] left review comments

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

mcp: expand tool catalog to cover the read surface (summary, hotspots, overhead, overhead trim)

1 participant

@willwashburn
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix"); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

mcp: expand read tool catalog (#237) - #520

Open
willwashburn wants to merge 4 commits into
mainfrom
issue-237-mcp-read-surface
Open

mcp: expand read tool catalog (#237)#520
willwashburn wants to merge 4 commits into
mainfrom
issue-237-mcp-read-surface

Conversation

@willwashburn

@willwashburnwillwashburn commented Aug 3, 2026•
edited by cubic-dev-ai Bot
Loading

Copy link
Copy Markdown
Member

Summary

  • Adds burn__summary, burn__hotspots, burn__overhead, burn__overheadTrim, and burn__compare factories over the current @relayburn/sdk read facade.
  • Mirrors the SDK option types with MCP input schemas and runtime validation, including findings mode and compare fidelity controls.
  • Returns SDK results unchanged and documents the complete npm MCP catalog.
  • Adds per-tool and stdio catalog, invocation, and invalid-input coverage.

burn__compare is included because sdk.compare now exists on the current Node facade; the issue excluded it only while that SDK function was unavailable.

A registered default session scopes summary and hotspots to that session. Cross-session callers should start the server without a default session and pass filters explicitly.

Rust burn mcp-server catalog parity remains intentionally separate and is tracked in #519.

Verification

  • pnpm run build:napi
  • RELAYBURN_HOME= RELAYBURN_SDK_NAPI_BUILT=1 pnpm run test (SDK 11/11; MCP 37/37; no skips)
  • cargo test --workspace

Fixes#237

🤖 Generated with Claude Code.

Review in cubic

@coderabbitai

coderabbitaiBot commented Aug 3, 2026•
edited
Loading

Copy link
Copy Markdown

Warning

Review limit reached

@willwashburn, you've reached your PR review limit, so we couldn't start this review.

Next review available in:35 minutes

Limit details: You’ve used all 1 included review currently available under your plan.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 0406f907-9b2a-4deb-996a-0b839ba8551c

📥 Commits

Reviewing files that changed from the base of the PR and between 294b1d6 and a2b7fb7.

📒 Files selected for processing (16)
  • CHANGELOG.md
  • packages/mcp/CHANGELOG.md
  • packages/mcp/README.md
  • packages/mcp/src/end-to-end.test.ts
  • packages/mcp/src/index.ts
  • packages/mcp/src/tools/compare.test.ts
  • packages/mcp/src/tools/compare.ts
  • packages/mcp/src/tools/hotspots.test.ts
  • packages/mcp/src/tools/hotspots.ts
  • packages/mcp/src/tools/input.ts
  • packages/mcp/src/tools/overhead-trim.test.ts
  • packages/mcp/src/tools/overhead-trim.ts
  • packages/mcp/src/tools/overhead.test.ts
  • packages/mcp/src/tools/overhead.ts
  • packages/mcp/src/tools/summary.test.ts
  • packages/mcp/src/tools/summary.ts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

devin-ai-integration[bot]
devin-ai-integrationBot reviewed Aug 3, 2026
View reviewed changes

@devin-ai-integrationdevin-ai-integrationBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Devin Review found 2 potential issues.

Open in Devin Review

Comment threadpackages/mcp/src/tools/overhead-trim.ts Outdated
Comment threadpackages/mcp/src/tools/summary.ts Outdated
chatgpt-codex-connector[bot]
chatgpt-codex-connectorBot reviewed Aug 3, 2026
View reviewed changes

@chatgpt-codex-connectorchatgpt-codex-connectorBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit:d948ca35de

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment threadpackages/mcp/src/tools/hotspots.ts
Comment threadpackages/mcp/src/tools/overhead-trim.ts Outdated
cubic-dev-ai[bot]
cubic-dev-aiBot reviewed Aug 3, 2026
View reviewed changes

@cubic-dev-aicubic-dev-aiBot left a comment •
edited
Loading

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

2 issues found and verified against the latest diff

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.
<file name="packages/mcp/src/tools/compare.ts">
<violation number="1" location="packages/mcp/src/tools/compare.ts:59">
P2: Duplicate model names satisfy the advertised “at least two models” constraint but collapse to one model in the SDK, so `burn__compare` can return a non-comparison result. Validating at least two distinct model names (and advertising that constraint in the schema) would prevent this input from reaching the SDK.</violation>
</file>
<file name="packages/mcp/src/tools/summary.ts">
<violation number="1" location="packages/mcp/src/tools/summary.ts:53">
P2: When `session` is omitted, this falls back to `deps.defaultSessionId` while still applying any `project`/`since` filters, effectively ANDing the default session with those filters. Neither the tool description nor the `session` property description mentions this implicit scoping (unlike `createSessionCostTool`, which states its default explicitly), so a caller asking for project- or time-range-wide totals can silently receive numbers limited to just one session. Consider documenting the default-session fallback in the description, or skip applying it when `project`/`since` filters are supplied.</violation>
</file>

Reply with feedback, questions, or to request a fix.

Re-trigger cubic

Comment threadpackages/mcp/src/tools/input.ts Outdated
Comment threadpackages/mcp/src/tools/compare.ts
Comment threadpackages/mcp/src/tools/summary.ts
Comment threadpackages/mcp/src/end-to-end.test.ts Outdated
@willwashburnwillwashburn mentioned this pull request Aug 3, 2026
Closed
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@devin-ai-integrationdevin-ai-integration[bot]devin-ai-integration[bot] left review comments
@cubic-dev-aicubic-dev-ai[bot]cubic-dev-ai[bot] left review comments
@chatgpt-codex-connectorchatgpt-codex-connector[bot]chatgpt-codex-connector[bot] left review comments

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

mcp: expand tool catalog to cover the read surface (summary, hotspots, overhead, overhead trim)

1 participant

@willwashburn
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length \u003e 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms"); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

mcp: expand read tool catalog (#237) - #520

Open
willwashburn wants to merge 4 commits into
mainfrom
issue-237-mcp-read-surface
Open

mcp: expand read tool catalog (#237)#520
willwashburn wants to merge 4 commits into
mainfrom
issue-237-mcp-read-surface

Conversation

@willwashburn

@willwashburnwillwashburn commented Aug 3, 2026•
edited by cubic-dev-ai Bot
Loading

Copy link
Copy Markdown
Member

Summary

  • Adds burn__summary, burn__hotspots, burn__overhead, burn__overheadTrim, and burn__compare factories over the current @relayburn/sdk read facade.
  • Mirrors the SDK option types with MCP input schemas and runtime validation, including findings mode and compare fidelity controls.
  • Returns SDK results unchanged and documents the complete npm MCP catalog.
  • Adds per-tool and stdio catalog, invocation, and invalid-input coverage.

burn__compare is included because sdk.compare now exists on the current Node facade; the issue excluded it only while that SDK function was unavailable.

A registered default session scopes summary and hotspots to that session. Cross-session callers should start the server without a default session and pass filters explicitly.

Rust burn mcp-server catalog parity remains intentionally separate and is tracked in #519.

Verification

  • pnpm run build:napi
  • RELAYBURN_HOME= RELAYBURN_SDK_NAPI_BUILT=1 pnpm run test (SDK 11/11; MCP 37/37; no skips)
  • cargo test --workspace

Fixes#237

🤖 Generated with Claude Code.

Review in cubic

@coderabbitai

coderabbitaiBot commented Aug 3, 2026•
edited
Loading

Copy link
Copy Markdown

Warning

Review limit reached

@willwashburn, you've reached your PR review limit, so we couldn't start this review.

Next review available in:35 minutes

Limit details: You’ve used all 1 included review currently available under your plan.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 0406f907-9b2a-4deb-996a-0b839ba8551c

📥 Commits

Reviewing files that changed from the base of the PR and between 294b1d6 and a2b7fb7.

📒 Files selected for processing (16)
  • CHANGELOG.md
  • packages/mcp/CHANGELOG.md
  • packages/mcp/README.md
  • packages/mcp/src/end-to-end.test.ts
  • packages/mcp/src/index.ts
  • packages/mcp/src/tools/compare.test.ts
  • packages/mcp/src/tools/compare.ts
  • packages/mcp/src/tools/hotspots.test.ts
  • packages/mcp/src/tools/hotspots.ts
  • packages/mcp/src/tools/input.ts
  • packages/mcp/src/tools/overhead-trim.test.ts
  • packages/mcp/src/tools/overhead-trim.ts
  • packages/mcp/src/tools/overhead.test.ts
  • packages/mcp/src/tools/overhead.ts
  • packages/mcp/src/tools/summary.test.ts
  • packages/mcp/src/tools/summary.ts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

devin-ai-integration[bot]
devin-ai-integrationBot reviewed Aug 3, 2026
View reviewed changes

@devin-ai-integrationdevin-ai-integrationBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Devin Review found 2 potential issues.

Open in Devin Review

Comment threadpackages/mcp/src/tools/overhead-trim.ts Outdated
Comment threadpackages/mcp/src/tools/summary.ts Outdated
chatgpt-codex-connector[bot]
chatgpt-codex-connectorBot reviewed Aug 3, 2026
View reviewed changes

@chatgpt-codex-connectorchatgpt-codex-connectorBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit:d948ca35de

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment threadpackages/mcp/src/tools/hotspots.ts
Comment threadpackages/mcp/src/tools/overhead-trim.ts Outdated
cubic-dev-ai[bot]
cubic-dev-aiBot reviewed Aug 3, 2026
View reviewed changes

@cubic-dev-aicubic-dev-aiBot left a comment •
edited
Loading

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

2 issues found and verified against the latest diff

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.
<file name="packages/mcp/src/tools/compare.ts">
<violation number="1" location="packages/mcp/src/tools/compare.ts:59">
P2: Duplicate model names satisfy the advertised “at least two models” constraint but collapse to one model in the SDK, so `burn__compare` can return a non-comparison result. Validating at least two distinct model names (and advertising that constraint in the schema) would prevent this input from reaching the SDK.</violation>
</file>
<file name="packages/mcp/src/tools/summary.ts">
<violation number="1" location="packages/mcp/src/tools/summary.ts:53">
P2: When `session` is omitted, this falls back to `deps.defaultSessionId` while still applying any `project`/`since` filters, effectively ANDing the default session with those filters. Neither the tool description nor the `session` property description mentions this implicit scoping (unlike `createSessionCostTool`, which states its default explicitly), so a caller asking for project- or time-range-wide totals can silently receive numbers limited to just one session. Consider documenting the default-session fallback in the description, or skip applying it when `project`/`since` filters are supplied.</violation>
</file>

Reply with feedback, questions, or to request a fix.

Re-trigger cubic

Comment threadpackages/mcp/src/tools/input.ts Outdated
Comment threadpackages/mcp/src/tools/compare.ts
Comment threadpackages/mcp/src/tools/summary.ts
Comment threadpackages/mcp/src/end-to-end.test.ts Outdated
@willwashburnwillwashburn mentioned this pull request Aug 3, 2026
Closed
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@devin-ai-integrationdevin-ai-integration[bot]devin-ai-integration[bot] left review comments
@cubic-dev-aicubic-dev-ai[bot]cubic-dev-ai[bot] left review comments
@chatgpt-codex-connectorchatgpt-codex-connector[bot]chatgpt-codex-connector[bot] left review comments

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

mcp: expand tool catalog to cover the read surface (summary, hotspots, overhead, overhead trim)

1 participant

@willwashburn
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links"); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + '
Skip to content

mcp: expand read tool catalog (#237) - #520

Open
willwashburn wants to merge 4 commits into
mainfrom
issue-237-mcp-read-surface
Open

mcp: expand read tool catalog (#237)#520
willwashburn wants to merge 4 commits into
mainfrom
issue-237-mcp-read-surface

Conversation

@willwashburn

@willwashburnwillwashburn commented Aug 3, 2026•
edited by cubic-dev-ai Bot
Loading

Copy link
Copy Markdown
Member

Summary

  • Adds burn__summary, burn__hotspots, burn__overhead, burn__overheadTrim, and burn__compare factories over the current @relayburn/sdk read facade.
  • Mirrors the SDK option types with MCP input schemas and runtime validation, including findings mode and compare fidelity controls.
  • Returns SDK results unchanged and documents the complete npm MCP catalog.
  • Adds per-tool and stdio catalog, invocation, and invalid-input coverage.

burn__compare is included because sdk.compare now exists on the current Node facade; the issue excluded it only while that SDK function was unavailable.

A registered default session scopes summary and hotspots to that session. Cross-session callers should start the server without a default session and pass filters explicitly.

Rust burn mcp-server catalog parity remains intentionally separate and is tracked in #519.

Verification

  • pnpm run build:napi
  • RELAYBURN_HOME= RELAYBURN_SDK_NAPI_BUILT=1 pnpm run test (SDK 11/11; MCP 37/37; no skips)
  • cargo test --workspace

Fixes#237

🤖 Generated with Claude Code.

Review in cubic

@coderabbitai

coderabbitaiBot commented Aug 3, 2026•
edited
Loading

Copy link
Copy Markdown

Warning

Review limit reached

@willwashburn, you've reached your PR review limit, so we couldn't start this review.

Next review available in:35 minutes

Limit details: You’ve used all 1 included review currently available under your plan.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 0406f907-9b2a-4deb-996a-0b839ba8551c

📥 Commits

Reviewing files that changed from the base of the PR and between 294b1d6 and a2b7fb7.

📒 Files selected for processing (16)
  • CHANGELOG.md
  • packages/mcp/CHANGELOG.md
  • packages/mcp/README.md
  • packages/mcp/src/end-to-end.test.ts
  • packages/mcp/src/index.ts
  • packages/mcp/src/tools/compare.test.ts
  • packages/mcp/src/tools/compare.ts
  • packages/mcp/src/tools/hotspots.test.ts
  • packages/mcp/src/tools/hotspots.ts
  • packages/mcp/src/tools/input.ts
  • packages/mcp/src/tools/overhead-trim.test.ts
  • packages/mcp/src/tools/overhead-trim.ts
  • packages/mcp/src/tools/overhead.test.ts
  • packages/mcp/src/tools/overhead.ts
  • packages/mcp/src/tools/summary.test.ts
  • packages/mcp/src/tools/summary.ts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

devin-ai-integration[bot]
devin-ai-integrationBot reviewed Aug 3, 2026
View reviewed changes

@devin-ai-integrationdevin-ai-integrationBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Devin Review found 2 potential issues.

Open in Devin Review

Comment threadpackages/mcp/src/tools/overhead-trim.ts Outdated
Comment threadpackages/mcp/src/tools/summary.ts Outdated
chatgpt-codex-connector[bot]
chatgpt-codex-connectorBot reviewed Aug 3, 2026
View reviewed changes

@chatgpt-codex-connectorchatgpt-codex-connectorBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit:d948ca35de

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment threadpackages/mcp/src/tools/hotspots.ts
Comment threadpackages/mcp/src/tools/overhead-trim.ts Outdated
cubic-dev-ai[bot]
cubic-dev-aiBot reviewed Aug 3, 2026
View reviewed changes

@cubic-dev-aicubic-dev-aiBot left a comment •
edited
Loading

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

2 issues found and verified against the latest diff

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.
<file name="packages/mcp/src/tools/compare.ts">
<violation number="1" location="packages/mcp/src/tools/compare.ts:59">
P2: Duplicate model names satisfy the advertised “at least two models” constraint but collapse to one model in the SDK, so `burn__compare` can return a non-comparison result. Validating at least two distinct model names (and advertising that constraint in the schema) would prevent this input from reaching the SDK.</violation>
</file>
<file name="packages/mcp/src/tools/summary.ts">
<violation number="1" location="packages/mcp/src/tools/summary.ts:53">
P2: When `session` is omitted, this falls back to `deps.defaultSessionId` while still applying any `project`/`since` filters, effectively ANDing the default session with those filters. Neither the tool description nor the `session` property description mentions this implicit scoping (unlike `createSessionCostTool`, which states its default explicitly), so a caller asking for project- or time-range-wide totals can silently receive numbers limited to just one session. Consider documenting the default-session fallback in the description, or skip applying it when `project`/`since` filters are supplied.</violation>
</file>

Reply with feedback, questions, or to request a fix.

Re-trigger cubic

Comment threadpackages/mcp/src/tools/input.ts Outdated
Comment threadpackages/mcp/src/tools/compare.ts
Comment threadpackages/mcp/src/tools/summary.ts
Comment threadpackages/mcp/src/end-to-end.test.ts Outdated
@willwashburnwillwashburn mentioned this pull request Aug 3, 2026
Closed
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@devin-ai-integrationdevin-ai-integration[bot]devin-ai-integration[bot] left review comments
@cubic-dev-aicubic-dev-ai[bot]cubic-dev-ai[bot] left review comments
@chatgpt-codex-connectorchatgpt-codex-connector[bot]chatgpt-codex-connector[bot] left review comments

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

mcp: expand tool catalog to cover the read surface (summary, hotspots, overhead, overhead trim)

1 participant

@willwashburn
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default"); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

mcp: expand read tool catalog (#237) - #520

Open
willwashburn wants to merge 4 commits into
mainfrom
issue-237-mcp-read-surface
Open

mcp: expand read tool catalog (#237)#520
willwashburn wants to merge 4 commits into
mainfrom
issue-237-mcp-read-surface

Conversation

@willwashburn

@willwashburnwillwashburn commented Aug 3, 2026•
edited by cubic-dev-ai Bot
Loading

Copy link
Copy Markdown
Member

Summary

  • Adds burn__summary, burn__hotspots, burn__overhead, burn__overheadTrim, and burn__compare factories over the current @relayburn/sdk read facade.
  • Mirrors the SDK option types with MCP input schemas and runtime validation, including findings mode and compare fidelity controls.
  • Returns SDK results unchanged and documents the complete npm MCP catalog.
  • Adds per-tool and stdio catalog, invocation, and invalid-input coverage.

burn__compare is included because sdk.compare now exists on the current Node facade; the issue excluded it only while that SDK function was unavailable.

A registered default session scopes summary and hotspots to that session. Cross-session callers should start the server without a default session and pass filters explicitly.

Rust burn mcp-server catalog parity remains intentionally separate and is tracked in #519.

Verification

  • pnpm run build:napi
  • RELAYBURN_HOME= RELAYBURN_SDK_NAPI_BUILT=1 pnpm run test (SDK 11/11; MCP 37/37; no skips)
  • cargo test --workspace

Fixes#237

🤖 Generated with Claude Code.

Review in cubic

@coderabbitai

coderabbitaiBot commented Aug 3, 2026•
edited
Loading

Copy link
Copy Markdown

Warning

Review limit reached

@willwashburn, you've reached your PR review limit, so we couldn't start this review.

Next review available in:35 minutes

Limit details: You’ve used all 1 included review currently available under your plan.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 0406f907-9b2a-4deb-996a-0b839ba8551c

📥 Commits

Reviewing files that changed from the base of the PR and between 294b1d6 and a2b7fb7.

📒 Files selected for processing (16)
  • CHANGELOG.md
  • packages/mcp/CHANGELOG.md
  • packages/mcp/README.md
  • packages/mcp/src/end-to-end.test.ts
  • packages/mcp/src/index.ts
  • packages/mcp/src/tools/compare.test.ts
  • packages/mcp/src/tools/compare.ts
  • packages/mcp/src/tools/hotspots.test.ts
  • packages/mcp/src/tools/hotspots.ts
  • packages/mcp/src/tools/input.ts
  • packages/mcp/src/tools/overhead-trim.test.ts
  • packages/mcp/src/tools/overhead-trim.ts
  • packages/mcp/src/tools/overhead.test.ts
  • packages/mcp/src/tools/overhead.ts
  • packages/mcp/src/tools/summary.test.ts
  • packages/mcp/src/tools/summary.ts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

devin-ai-integration[bot]
devin-ai-integrationBot reviewed Aug 3, 2026
View reviewed changes

@devin-ai-integrationdevin-ai-integrationBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Devin Review found 2 potential issues.

Open in Devin Review

Comment threadpackages/mcp/src/tools/overhead-trim.ts Outdated
Comment threadpackages/mcp/src/tools/summary.ts Outdated
chatgpt-codex-connector[bot]
chatgpt-codex-connectorBot reviewed Aug 3, 2026
View reviewed changes

@chatgpt-codex-connectorchatgpt-codex-connectorBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit:d948ca35de

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment threadpackages/mcp/src/tools/hotspots.ts
Comment threadpackages/mcp/src/tools/overhead-trim.ts Outdated
cubic-dev-ai[bot]
cubic-dev-aiBot reviewed Aug 3, 2026
View reviewed changes

@cubic-dev-aicubic-dev-aiBot left a comment •
edited
Loading

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

2 issues found and verified against the latest diff

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.
<file name="packages/mcp/src/tools/compare.ts">
<violation number="1" location="packages/mcp/src/tools/compare.ts:59">
P2: Duplicate model names satisfy the advertised “at least two models” constraint but collapse to one model in the SDK, so `burn__compare` can return a non-comparison result. Validating at least two distinct model names (and advertising that constraint in the schema) would prevent this input from reaching the SDK.</violation>
</file>
<file name="packages/mcp/src/tools/summary.ts">
<violation number="1" location="packages/mcp/src/tools/summary.ts:53">
P2: When `session` is omitted, this falls back to `deps.defaultSessionId` while still applying any `project`/`since` filters, effectively ANDing the default session with those filters. Neither the tool description nor the `session` property description mentions this implicit scoping (unlike `createSessionCostTool`, which states its default explicitly), so a caller asking for project- or time-range-wide totals can silently receive numbers limited to just one session. Consider documenting the default-session fallback in the description, or skip applying it when `project`/`since` filters are supplied.</violation>
</file>

Reply with feedback, questions, or to request a fix.

Re-trigger cubic

Comment threadpackages/mcp/src/tools/input.ts Outdated
Comment threadpackages/mcp/src/tools/compare.ts
Comment threadpackages/mcp/src/tools/summary.ts
Comment threadpackages/mcp/src/end-to-end.test.ts Outdated
@willwashburnwillwashburn mentioned this pull request Aug 3, 2026
Closed
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@devin-ai-integrationdevin-ai-integration[bot]devin-ai-integration[bot] left review comments
@cubic-dev-aicubic-dev-ai[bot]cubic-dev-ai[bot] left review comments
@chatgpt-codex-connectorchatgpt-codex-connector[bot]chatgpt-codex-connector[bot] left review comments

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

mcp: expand tool catalog to cover the read surface (summary, hotspots, overhead, overhead trim)

1 participant

@willwashburn
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers"); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

mcp: expand read tool catalog (#237) - #520

Open
willwashburn wants to merge 4 commits into
mainfrom
issue-237-mcp-read-surface
Open

mcp: expand read tool catalog (#237)#520
willwashburn wants to merge 4 commits into
mainfrom
issue-237-mcp-read-surface

Conversation

@willwashburn

@willwashburnwillwashburn commented Aug 3, 2026•
edited by cubic-dev-ai Bot
Loading

Copy link
Copy Markdown
Member

Summary

  • Adds burn__summary, burn__hotspots, burn__overhead, burn__overheadTrim, and burn__compare factories over the current @relayburn/sdk read facade.
  • Mirrors the SDK option types with MCP input schemas and runtime validation, including findings mode and compare fidelity controls.
  • Returns SDK results unchanged and documents the complete npm MCP catalog.
  • Adds per-tool and stdio catalog, invocation, and invalid-input coverage.

burn__compare is included because sdk.compare now exists on the current Node facade; the issue excluded it only while that SDK function was unavailable.

A registered default session scopes summary and hotspots to that session. Cross-session callers should start the server without a default session and pass filters explicitly.

Rust burn mcp-server catalog parity remains intentionally separate and is tracked in #519.

Verification

  • pnpm run build:napi
  • RELAYBURN_HOME= RELAYBURN_SDK_NAPI_BUILT=1 pnpm run test (SDK 11/11; MCP 37/37; no skips)
  • cargo test --workspace

Fixes#237

🤖 Generated with Claude Code.

Review in cubic

@coderabbitai

coderabbitaiBot commented Aug 3, 2026•
edited
Loading

Copy link
Copy Markdown

Warning

Review limit reached

@willwashburn, you've reached your PR review limit, so we couldn't start this review.

Next review available in:35 minutes

Limit details: You’ve used all 1 included review currently available under your plan.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 0406f907-9b2a-4deb-996a-0b839ba8551c

📥 Commits

Reviewing files that changed from the base of the PR and between 294b1d6 and a2b7fb7.

📒 Files selected for processing (16)
  • CHANGELOG.md
  • packages/mcp/CHANGELOG.md
  • packages/mcp/README.md
  • packages/mcp/src/end-to-end.test.ts
  • packages/mcp/src/index.ts
  • packages/mcp/src/tools/compare.test.ts
  • packages/mcp/src/tools/compare.ts
  • packages/mcp/src/tools/hotspots.test.ts
  • packages/mcp/src/tools/hotspots.ts
  • packages/mcp/src/tools/input.ts
  • packages/mcp/src/tools/overhead-trim.test.ts
  • packages/mcp/src/tools/overhead-trim.ts
  • packages/mcp/src/tools/overhead.test.ts
  • packages/mcp/src/tools/overhead.ts
  • packages/mcp/src/tools/summary.test.ts
  • packages/mcp/src/tools/summary.ts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

devin-ai-integration[bot]
devin-ai-integrationBot reviewed Aug 3, 2026
View reviewed changes

@devin-ai-integrationdevin-ai-integrationBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Devin Review found 2 potential issues.

Open in Devin Review

Comment threadpackages/mcp/src/tools/overhead-trim.ts Outdated
Comment threadpackages/mcp/src/tools/summary.ts Outdated
chatgpt-codex-connector[bot]
chatgpt-codex-connectorBot reviewed Aug 3, 2026
View reviewed changes

@chatgpt-codex-connectorchatgpt-codex-connectorBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit:d948ca35de

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment threadpackages/mcp/src/tools/hotspots.ts
Comment threadpackages/mcp/src/tools/overhead-trim.ts Outdated
cubic-dev-ai[bot]
cubic-dev-aiBot reviewed Aug 3, 2026
View reviewed changes

@cubic-dev-aicubic-dev-aiBot left a comment •
edited
Loading

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

2 issues found and verified against the latest diff

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.
<file name="packages/mcp/src/tools/compare.ts">
<violation number="1" location="packages/mcp/src/tools/compare.ts:59">
P2: Duplicate model names satisfy the advertised “at least two models” constraint but collapse to one model in the SDK, so `burn__compare` can return a non-comparison result. Validating at least two distinct model names (and advertising that constraint in the schema) would prevent this input from reaching the SDK.</violation>
</file>
<file name="packages/mcp/src/tools/summary.ts">
<violation number="1" location="packages/mcp/src/tools/summary.ts:53">
P2: When `session` is omitted, this falls back to `deps.defaultSessionId` while still applying any `project`/`since` filters, effectively ANDing the default session with those filters. Neither the tool description nor the `session` property description mentions this implicit scoping (unlike `createSessionCostTool`, which states its default explicitly), so a caller asking for project- or time-range-wide totals can silently receive numbers limited to just one session. Consider documenting the default-session fallback in the description, or skip applying it when `project`/`since` filters are supplied.</violation>
</file>

Reply with feedback, questions, or to request a fix.

Re-trigger cubic

Comment threadpackages/mcp/src/tools/input.ts Outdated
Comment threadpackages/mcp/src/tools/compare.ts
Comment threadpackages/mcp/src/tools/summary.ts
Comment threadpackages/mcp/src/end-to-end.test.ts Outdated
@willwashburnwillwashburn mentioned this pull request Aug 3, 2026
Closed
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@devin-ai-integrationdevin-ai-integration[bot]devin-ai-integration[bot] left review comments
@cubic-dev-aicubic-dev-ai[bot]cubic-dev-ai[bot] left review comments
@chatgpt-codex-connectorchatgpt-codex-connector[bot]chatgpt-codex-connector[bot] left review comments

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

mcp: expand tool catalog to cover the read surface (summary, hotspots, overhead, overhead trim)

1 participant

@willwashburn
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode"); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })();
Skip to content

mcp: expand read tool catalog (#237) - #520

Open
willwashburn wants to merge 4 commits into
mainfrom
issue-237-mcp-read-surface
Open

mcp: expand read tool catalog (#237)#520
willwashburn wants to merge 4 commits into
mainfrom
issue-237-mcp-read-surface

Conversation

@willwashburn

@willwashburnwillwashburn commented Aug 3, 2026•
edited by cubic-dev-ai Bot
Loading

Copy link
Copy Markdown
Member

Summary

  • Adds burn__summary, burn__hotspots, burn__overhead, burn__overheadTrim, and burn__compare factories over the current @relayburn/sdk read facade.
  • Mirrors the SDK option types with MCP input schemas and runtime validation, including findings mode and compare fidelity controls.
  • Returns SDK results unchanged and documents the complete npm MCP catalog.
  • Adds per-tool and stdio catalog, invocation, and invalid-input coverage.

burn__compare is included because sdk.compare now exists on the current Node facade; the issue excluded it only while that SDK function was unavailable.

A registered default session scopes summary and hotspots to that session. Cross-session callers should start the server without a default session and pass filters explicitly.

Rust burn mcp-server catalog parity remains intentionally separate and is tracked in #519.

Verification

  • pnpm run build:napi
  • RELAYBURN_HOME= RELAYBURN_SDK_NAPI_BUILT=1 pnpm run test (SDK 11/11; MCP 37/37; no skips)
  • cargo test --workspace

Fixes#237

🤖 Generated with Claude Code.

Review in cubic

@coderabbitai

coderabbitaiBot commented Aug 3, 2026•
edited
Loading

Copy link
Copy Markdown

Warning

Review limit reached

@willwashburn, you've reached your PR review limit, so we couldn't start this review.

Next review available in:35 minutes

Limit details: You’ve used all 1 included review currently available under your plan.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 0406f907-9b2a-4deb-996a-0b839ba8551c

📥 Commits

Reviewing files that changed from the base of the PR and between 294b1d6 and a2b7fb7.

📒 Files selected for processing (16)
  • CHANGELOG.md
  • packages/mcp/CHANGELOG.md
  • packages/mcp/README.md
  • packages/mcp/src/end-to-end.test.ts
  • packages/mcp/src/index.ts
  • packages/mcp/src/tools/compare.test.ts
  • packages/mcp/src/tools/compare.ts
  • packages/mcp/src/tools/hotspots.test.ts
  • packages/mcp/src/tools/hotspots.ts
  • packages/mcp/src/tools/input.ts
  • packages/mcp/src/tools/overhead-trim.test.ts
  • packages/mcp/src/tools/overhead-trim.ts
  • packages/mcp/src/tools/overhead.test.ts
  • packages/mcp/src/tools/overhead.ts
  • packages/mcp/src/tools/summary.test.ts
  • packages/mcp/src/tools/summary.ts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

devin-ai-integration[bot]
devin-ai-integrationBot reviewed Aug 3, 2026
View reviewed changes

@devin-ai-integrationdevin-ai-integrationBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Devin Review found 2 potential issues.

Open in Devin Review

Comment threadpackages/mcp/src/tools/overhead-trim.ts Outdated
Comment threadpackages/mcp/src/tools/summary.ts Outdated
chatgpt-codex-connector[bot]
chatgpt-codex-connectorBot reviewed Aug 3, 2026
View reviewed changes

@chatgpt-codex-connectorchatgpt-codex-connectorBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit:d948ca35de

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment threadpackages/mcp/src/tools/hotspots.ts
Comment threadpackages/mcp/src/tools/overhead-trim.ts Outdated
cubic-dev-ai[bot]
cubic-dev-aiBot reviewed Aug 3, 2026
View reviewed changes

@cubic-dev-aicubic-dev-aiBot left a comment •
edited
Loading

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

2 issues found and verified against the latest diff

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.
<file name="packages/mcp/src/tools/compare.ts">
<violation number="1" location="packages/mcp/src/tools/compare.ts:59">
P2: Duplicate model names satisfy the advertised “at least two models” constraint but collapse to one model in the SDK, so `burn__compare` can return a non-comparison result. Validating at least two distinct model names (and advertising that constraint in the schema) would prevent this input from reaching the SDK.</violation>
</file>
<file name="packages/mcp/src/tools/summary.ts">
<violation number="1" location="packages/mcp/src/tools/summary.ts:53">
P2: When `session` is omitted, this falls back to `deps.defaultSessionId` while still applying any `project`/`since` filters, effectively ANDing the default session with those filters. Neither the tool description nor the `session` property description mentions this implicit scoping (unlike `createSessionCostTool`, which states its default explicitly), so a caller asking for project- or time-range-wide totals can silently receive numbers limited to just one session. Consider documenting the default-session fallback in the description, or skip applying it when `project`/`since` filters are supplied.</violation>
</file>

Reply with feedback, questions, or to request a fix.

Re-trigger cubic

Comment threadpackages/mcp/src/tools/input.ts Outdated
Comment threadpackages/mcp/src/tools/compare.ts
Comment threadpackages/mcp/src/tools/summary.ts
Comment threadpackages/mcp/src/end-to-end.test.ts Outdated
@willwashburnwillwashburn mentioned this pull request Aug 3, 2026
Closed
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@devin-ai-integrationdevin-ai-integration[bot]devin-ai-integration[bot] left review comments
@cubic-dev-aicubic-dev-ai[bot]cubic-dev-ai[bot] left review comments
@chatgpt-codex-connectorchatgpt-codex-connector[bot]chatgpt-codex-connector[bot] left review comments

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

mcp: expand tool catalog to cover the read surface (summary, hotspots, overhead, overhead trim)

1 participant

@willwashburn