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

Merged opened this

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

Merged

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.

Notes

shipped production is serving it deploy 59903fa

opened this

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.
  • The two plugin lines are drawn from HARNESS_PLUGINS through offeredPlugins. 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 from HARNESS_PLUGINS so 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-authenticate header, 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 --noEmit is clean.
  • bun test test/mcp-size.test.ts passes.
  • bun scripts/gate.ts --fix rewrapped comments in one file. I committed the result along with the test.

To try it: bun test test/llms-doors.test.ts.

Closes #13526

commented

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.
  • The two plugin lines are drawn from HARNESS_PLUGINS through offeredPlugins. 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 from HARNESS_PLUGINS so 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-authenticate header, 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 --noEmit is clean.
  • bun test test/mcp-size.test.ts passes.
  • bun scripts/gate.ts --fix rewrapped comments in one file. I committed the result along with the test.

To try it: bun test test/llms-doors.test.ts.

Approved

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.

Sign in to join this conversation.

↑↓ navigate ↵ open ⌘↵ its app esc close

Keyboard shortcuts

Docs