Skip to content

fix(mcp-catalog): keep an unsized project count out of context help - #2323

Merged
ScriptedAlchemy merged 1 commit into
masterfrom
fleet/beta55-context-help-text
Sep 27, 2026
Merged

ScriptedAlchemy merged 1 commit into
masterfrom
fleet/beta55-context-help-text

Conversation

@ScriptedAlchemy

Copy link
Copy Markdown
Owner

Finding (f) from running the released 1.0.0-beta.55: tracedecay tool context --help printed This project (0 nodes).

Cause

The static tool registry built the tracedecay_context definition with context_description(0, 3), the dynamic call-budget sentence filled with placeholder figures. Help renders the static registry and has no project graph to size, so it printed a node count and budget it could not compute.

Change

CONTEXT_DESCRIPTION holds the tool's purpose alone and is the static description. context_description(node_count, budget) and context_warming_description(budget) append their sentence to it, so live tools/list keeps the computed figures (or the warming variant) and help no longer invents them.

Test

context_help_describes_the_tool_without_a_project_size (core_cli_suite) runs the built binary with an isolated home and asserts the description line literally.

  • Fails with the fix reverted: … Use it for broad questions that need relationship synthesis across the code graph. This project (0 nodes) allows 3 broad context calls.
  • Passes: the line ends at … relationship synthesis across the code graph.

Journey

$ tracedecay tool context --help | sed -n 3p      # branch binary
Build an AI-ready context for a task description. Returns relevant symbols, relationships, up to three untracked project memory matches when available, and optionally code snippets. Use it for broad questions that need relationship synthesis across the code graph.

Released beta.55 printed the same line followed by This project (0 nodes) allows 3 broad context calls.

Verification

  • cargo test -p tracedecay-mcp-catalog: 29 passed (includes per_session_budget_does_not_leak_through_the_cached_registry: a budgeted registry still carries N broad context calls)
  • cargo test -p tracedecay-cli --test core_cli_suite -- cli_boundary: 3 passed
  • cargo test -p tracedecay --features test-helpers --lib -- bootstrap (warming tools/list descriptions still say 3 broad context calls and graph is still warming): 68 passed
  • cargo clippy -p tracedecay-mcp-catalog -p tracedecay-cli --all-targets -- -D warnings, with and without test-transport: clean, after rebasing onto fix(domain): box project route detail so master clippy passes #2315, which fixed fix(domain): TraceDecayError too large for clippy since 21552e3764 #2308. cargo fmt --all -- --check: clean.

`tracedecay tool context --help` printed "This project (0 nodes)
allows 3 broad context calls": the static tool registry embedded the
dynamic call-budget sentence with placeholder figures it cannot
compute. The static description now carries only the tool's purpose;
live discovery keeps adding the node count and budget (or the warming
variant) where a project graph sizes them.
@changeset-bot

changeset-bot Bot commented Sep 27, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: 3b12909

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Sep 27, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-09-27T11:33:26.820401Z 3b12909 PR opened
ℹ️ 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" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@ScriptedAlchemy
ScriptedAlchemy merged commit 5f2dfe3 into master Sep 27, 2026
1 check passed
@ScriptedAlchemy
ScriptedAlchemy deleted the fleet/beta55-context-help-text branch September 27, 2026 12:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

fix(domain): TraceDecayError too large for clippy since 21552e3764

1 participant