Public: anyone can read this; the crew can change it.

The rosters: generate the MCP doc roster from one file per member (child of #14248) #14440

Merged opened this

Check · Review · Land · Live done — Landed and live in production.

Merged

The MCP tool table is no longer stored in docs/MCP.md. It is built from the tool files each time it is read, so a pull that adds a tool no longer edits that shared doc. The type check passes and the MCP tests I ran pass (mcp-table, mcp-guide, mcp-doc-matches-tools, mcp-tools, mcp-size).

Notes

shipped production is serving it deploy 4ec2c16

opened this

The MCP tool table is no longer stored in docs/MCP.md. It is built from the tool files each time it is read, so a pull that adds a tool no longer edits that shared doc. The type check passes and the MCP tests I ran pass (mcp-table, mcp-guide, mcp-doc-matches-tools, mcp-tools, mcp-size). The one failure on the first run was a test I had just made obsolete, and I removed it. bun scripts/gate.ts --fix changed nothing. I did not run the full suite or bun test beyond those files.

The issue didn't say which roster "the MCP doc roster" meant. I took it to be the checked-in table in docs/MCP.md, which every tool change regenerated. I did not add a keep_plan entry or a time estimate.

  • Doc: the "Tools" section keeps its prose and points at the code. The ~200-row table and its mcp-tools:begin/end markers are gone.
  • Reading it: bun scripts/mcp-table.ts now prints the table instead of rewriting the doc. /llms.txt already serves each tool's line live.
  • Code: src/http/mcp_table.ts keeps renderTable and toolRows. The marker helpers (tableIn, withTable, TABLE_BEGIN, TABLE_END) are removed, along with the tableIn entry in the unused-exports allowlist.
  • Tests: mcp-table.test.ts now checks that the roster equals src/http/mcp/tools/, one row per tool file, plus report, start and offer. It also checks that docs/MCP.md holds no table. The two tests that parsed the table out of the doc (mcp-guide, mcp-doc-matches-tools) read the rendered roster instead. mcp-size is unchanged and I did not touch the ceilings.

Not done: the duty roster in src/maintain/registry.ts is still an explicit import list, so I left it alone. The issue says #14355 did it, but it is not built from its directory.

The pre-push hook wanted a commit saying how to try the change, so a second, empty commit carries that line.

To try it: run bun scripts/mcp-table.ts to print the roster, then bun test test/mcp-table.test.ts.

🤖 Generated with Claude Code

Closes #14436

commented

The MCP tool table is no longer stored in docs/MCP.md. It is built from the tool files each time it is read, so a pull that adds a tool no longer edits that shared doc. The type check passes and the MCP tests I ran pass (mcp-table, mcp-guide, mcp-doc-matches-tools, mcp-tools, mcp-size). The one failure on the first run was a test I had just made obsolete, and I removed it. bun scripts/gate.ts --fix changed nothing. I did not run the full suite or bun test beyond those files.

The issue didn't say which roster "the MCP doc roster" meant. I took it to be the checked-in table in docs/MCP.md, which every tool change regenerated. I did not add a keep_plan entry or a time estimate.

  • Doc: the "Tools" section keeps its prose and points at the code. The ~200-row table and its mcp-tools:begin/end markers are gone.
  • Reading it: bun scripts/mcp-table.ts now prints the table instead of rewriting the doc. /llms.txt already serves each tool's line live.
  • Code: src/http/mcp_table.ts keeps renderTable and toolRows. The marker helpers (tableIn, withTable, TABLE_BEGIN, TABLE_END) are removed, along with the tableIn entry in the unused-exports allowlist.
  • Tests: mcp-table.test.ts now checks that the roster equals src/http/mcp/tools/, one row per tool file, plus report, start and offer. It also checks that docs/MCP.md holds no table. The two tests that parsed the table out of the doc (mcp-guide, mcp-doc-matches-tools) read the rendered roster instead. mcp-size is unchanged and I did not touch the ceilings.

Not done: the duty roster in src/maintain/registry.ts is still an explicit import list, so I left it alone. The issue says #14355 did it, but it is not built from its directory.

The pre-push hook wanted a commit saying how to try the change, so a second, empty commit carries that line.

To try it: run bun scripts/mcp-table.ts to print the roster, then bun test test/mcp-table.test.ts.

🤖 Generated with Claude Code

Approved

Clean: the ~200-row generated table and its markers leave docs/MCP.md, which stops being a hot file. The marker helpers and their allowlist entry are removed with no dead code left. Tests now hold the roster equal to src/http/mcp/tools/ and keep docs/MCP.md free of a table, and I found no security surface touched. Nits, non-blocking: the ssh_keys comment in test/mcp-doc-matches-tools.test.ts still says the doc keeps its row, and the toolFiles import in test/mcp-table.test.ts sits mid-file.

Sign in to join this conversation.

↑↓ navigate ↵ open ⌘↵ its app esc close

Keyboard shortcuts

Docs