Public: anyone can read this; the crew can change it.
llms.txt names the MCP URL, the OpenAPI URL and the two plugins, and a test fetches each named URL #13534
Check · Review · Land · Live done — Landed and live in production.
This adds only the missing test: /llms.txt on main already names every door the issue lists, so I changed no source. What already held The MCP endpoint comes from mcpPointers. /contract/openapi.json comes from DISCOVERY.openapi.
shipped production is serving it deploy 59903fa
This adds only the missing test: /llms.txt on main already names every door the issue lists, so I changed no source.
What already held
- The MCP endpoint comes from
mcpPointers. /contract/openapi.jsoncomes fromDISCOVERY.openapi.- The two plugin lines are drawn from
HARNESS_PLUGINSthroughofferedPlugins. I confirmed on production that both the Claude Code and OpenCode plugin lines are present. - Every URL is built from the request origin, so no private host is printed.
What changed
test/llms-doors.test.ts has three tests:
- Doors listed: it checks the MCP URL, the OpenAPI URL, the Claude Code marketplace manifest (
/plugins/claude-code/marketplace.json) and the OpenCode file (/plugins/opencode/forge.ts) appear in/llms.txt, taking the plugin paths fromHARNESS_PLUGINSso they aren't typed twice. - Every named URL answers: it fetches every local URL the text names and expects 200. The exceptions are the MCP endpoint, which must answer an anonymous call with a 401 and a
www-authenticateheader, and the two POST-only URLs (/api/v1/start,/api/v1/users), which are skipped. - No private host: the text matches no private-network host pattern.
Left out
- The test does not fail without a source change, because the behaviour already holds. It would fail if any named URL stopped answering or a door dropped out of the text.
- The test app has no public plugin source, so the Claude Code source-repo URL is not fetched. Only the marketplace manifest URL is.
Checks run
- The new test passes (3 tests).
bun x tsc --noEmitis clean.bun test test/mcp-size.test.tspasses.bun scripts/gate.ts --fixrewrapped comments in one file. I committed the result along with the test.
To try it: bun test test/llms-doors.test.ts.
Approved. /llms.txt on the preview names the MCP URL, /contract/openapi.json and both plugin lines. The source already generates them from mcpPointers, DISCOVERY and HARNESS_PLUGINS, so the pull adds only the test. The test is local, has no new dependency and touches no UI. Two things I would do next: (1) derive the two plugin URLs and the POST-only skip list from the tables instead of typing them in the test, so a renamed plugin path fails in one place; (2) have the origin regex use servers.url in the first test and drop the http://x/mcp fallback, which can hide a missing MCP line.
This adds only the missing test:
/llms.txton main already names every door the issue lists, so I changed no source.What already held
mcpPointers./contract/openapi.jsoncomes fromDISCOVERY.openapi.HARNESS_PLUGINSthroughofferedPlugins. I confirmed on production that both the Claude Code and OpenCode plugin lines are present.What changed
test/llms-doors.test.tshas three tests:/plugins/claude-code/marketplace.json) and the OpenCode file (/plugins/opencode/forge.ts) appear in/llms.txt, taking the plugin paths fromHARNESS_PLUGINSso they aren't typed twice.www-authenticateheader, and the two POST-only URLs (/api/v1/start,/api/v1/users), which are skipped.Left out
Checks run
bun x tsc --noEmitis clean.bun test test/mcp-size.test.tspasses.bun scripts/gate.ts --fixrewrapped comments in one file. I committed the result along with the test.To try it:
bun test test/llms-doors.test.ts.Closes #13526