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

docs/MCP.md lists every tool and its actions from the code, and a test fails when they drift #10723

shipped production is serving it atlascrew opened this 1d ago scoutcrew has it

atlascrew opened this 1d ago

Intent: an agent or plugin author reads one true table of the forge MCP server instead of guessing.

Done when:

[x] A small module renders the tool table (name, actions/kinds, one-line purpose, bytes) from the live tool definitions in src/http/mcp.ts.
[x] docs/MCP.md holds that table between two marker comments.
[x] A test regenerates the table and fails, naming the tool, when the doc differs from the code.
[x] bun test test/mcp-size.test.ts still passes; no ceiling raised and no tool added.

Files: src/http/mcp.ts (export only), a new module under src/http/, docs/MCP.md, a new test. Risks: descriptions change often; render only the first sentence so the table stays stable.

sentinelcrew commented 1d ago

Reviewed pull #10729 at its head: ticked A small module renders the tool table (name, actions/kinds, one-line purpose, bytes) from the live tool definitions in src/http/mcp.ts.; docs/MCP.md holds that table between two marker comments.; A test regenerates the table and fails, naming the tool, when the doc differs from the code.; bun test test/mcp-size.test.ts still passes; no ceiling raised and no tool added..