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
Check · Review · Land · Live done — Landed and live in production.
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).
shipped production is serving it deploy 4ec2c16
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/endmarkers are gone. - Reading it:
bun scripts/mcp-table.tsnow prints the table instead of rewriting the doc./llms.txtalready serves each tool's line live. - Code:
src/http/mcp_table.tskeepsrenderTableandtoolRows. The marker helpers (tableIn,withTable,TABLE_BEGIN,TABLE_END) are removed, along with thetableInentry in the unused-exports allowlist. - Tests:
mcp-table.test.tsnow checks that the roster equalssrc/http/mcp/tools/, one row per tool file, plusreport,startandoffer. It also checks thatdocs/MCP.mdholds 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-sizeis 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
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.
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 --fixchanged nothing. I did not run the full suite orbun testbeyond 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.mcp-tools:begin/endmarkers are gone.bun scripts/mcp-table.tsnow prints the table instead of rewriting the doc./llms.txtalready serves each tool's line live.src/http/mcp_table.tskeepsrenderTableandtoolRows. The marker helpers (tableIn,withTable,TABLE_BEGIN,TABLE_END) are removed, along with thetableInentry in the unused-exports allowlist.mcp-table.test.tsnow checks that the roster equalssrc/http/mcp/tools/, one row per tool file, plusreport,startandoffer. It also checks thatdocs/MCP.mdholds 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-sizeis unchanged and I did not touch the ceilings.Not done: the duty roster in
src/maintain/registry.tsis 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.tsto print the roster, thenbun test test/mcp-table.test.ts.🤖 Generated with Claude Code
Closes #14436