Public: anyone can read this; the crew can change it.
The role-aware manifest has a byte budget per role, pinned by a test: /llms.txt is 10.3 KB for an anonymous reader #14285
Check · Review · Land · Live — No review yet.
/llms.txt now has a byte budget per role, and a new test, test/llms-budget.test.ts, fails when any role goes over. The anonymous text is about 480 bytes smaller (8,978 → 8,500). The new test, the other llms, standards, agent-card, muse-journey, mcp-card and mcp-size tests, and tsc were green on my last full run.
look green — it answered, no tests were run, ready for a look deploy 4178897
Check passeddeploy 4178897
Website spec: 26 findings (report only)
- /board http://127.0.0.1:40897/board answered 303 — https://specification.website/
- /notes http://127.0.0.1:40897/notes answered 303 — https://specification.website/
- /review http://127.0.0.1:40897/review answered 303 — https://specification.website/
- /releases http://127.0.0.1:40897/releases answered 303 — https://specification.website/
- /system http://127.0.0.1:40897/system answered 303 — https://specification.website/
- /admin/limits http://127.0.0.1:40897/admin/limits answered 404 — https://specification.website/
- /maintenance http://127.0.0.1:40897/maintenance answered 303 — https://specification.website/
- /talk http://127.0.0.1:40897/talk answered 303 — https://specification.website/
- /flow http://127.0.0.1:40897/flow answered 303 — https://specification.website/
- /resilience http://127.0.0.1:40897/resilience answered 303 — https://specification.website/
- /boards?help http://127.0.0.1:40897/boards?help answered 303 — https://specification.website/
- /settings/crew http://127.0.0.1:40897/settings/crew answered 303 — https://specification.website/
- /settings/crew?help http://127.0.0.1:40897/settings/crew?help answered 303 — https://specification.website/
- /settings/security/controls http://127.0.0.1:40897/settings/security/controls answered 303 — https://specification.website/
- /settings/grants http://127.0.0.1:40897/settings/grants answered 303 — https://specification.website/
- /preview-admin/sample expected exactly one <h1>, found 2 — headings
- /preview-admin/sample/drop http://127.0.0.1:40897/preview-admin/sample/drop answered 303 — https://specification.website/
- /preview-admin/sample/data-move http://127.0.0.1:40897/preview-admin/sample/data-move answered 303 — https://specification.website/
- /preview-admin/sample/cut-over http://127.0.0.1:40897/preview-admin/sample/cut-over answered 303 — https://specification.website/
- /preview-admin/sample/next?pick expected exactly one <h1>, found 2 — headings
- /preview-admin/sample/bets expected exactly one <h1>, found 2 — headings
- /preview-admin/sample/waves expected exactly one <h1>, found 2 — headings
- /preview-admin/sample/space the first focusable element is not a skip link (an in-page #target link) — skip-link
- /looks/missing http://127.0.0.1:40897/looks/missing answered 404 — https://specification.website/
- /looks/failed http://127.0.0.1:40897/looks/failed answered 500 — https://specification.website/
- /nope/nothing http://127.0.0.1:40897/nope/nothing answered 404 — https://specification.website/
/llms.txt now has a byte budget per role, and a new test, test/llms-budget.test.ts, fails when any role goes over. The anonymous text is about 480 bytes smaller (8,978 → 8,500). The new test, the other llms, standards, agent-card, muse-journey, mcp-card and mcp-size tests, and tsc were green on my last full run. bun scripts/gate.ts --fix rewrapped comments in one file, and that fix is in the commit.
Sizes on the test's loopback origin (http://localhost:<port>):
| Role | Before | After | Budget |
|---|---|---|---|
| Anonymous | 8,978 | 8,500 | 8,500 |
Signed-in (rw token) | 79,396 | 79,265 | 79,300 |
| Admin | 90,829 | 90,698 | 90,700 |
- Budget rule: each budget is today's size rounded up to the next hundred, not down, because a round-down budget fails against the size it was measured from. The anonymous text has no headroom: it measures exactly 8,500.
- Production size: the 10.3 KB production figure is larger than these because production's origin is longer and the origin appears about 45 times. The ceilings are on the loopback origin, not on that figure.
- Repeated lines: none appear in the anonymous text, and the test checks that.
- Doors and guide: the test also checks that the MCP, OpenAPI and report-a-problem links are still there, and that each guide page is still linked, one line each.
What I trimmed for the anonymous reader (src/web/standards.ts):
- I dropped the "Connect an assistant that uses tools" line. It repeated the MCP URL already in the header. This one also affects signed-in readers, which is why their sizes fell by about 130 bytes.
- The "For agents with an account" section is now one API line for strangers. It points to the MCP card and to the API catalog, which lists the other discovery URLs.
- The OpenAPI line with the
?tag=list stays, so the two linestest/llms-anonymous.test.tsandtest/standards.test.tscheck are still there. - The full set of discovery lines (server card, agent card, catalog) is unchanged for signed-in readers.
Not done:
- Signed-in sizes: I didn't shrink them. At 79 KB and 91 KB, the tool list dominates, and cutting it is a separate decision. The new test only pins those sizes where they are.
- Anonymous text left in place: the Plans table and the "Run it yourself" bullet are still there. Existing tests and the three doors depend on that wording.
Try it: curl -s $FORGE_URL/llms.txt | wc -c, once without a token and once with one, then bun test test/llms-budget.test.ts.
<!-- look-pages 4178897e6351 --> Look pages for 4178897, from the gate:
look pages (inferred): this pull changes src/web/standards.ts; the forge pictures / (src/web/standards.ts), /docs (src/web/standards.ts), /explore (src/web/standards.ts) and 25 more, the pages whose routes import it. A "Looks: <path>" or "No look: <why>" line in a commit message overrides
/llms.txt now has a byte budget per role, and a new test,
test/llms-budget.test.ts, fails when any role goes over. The anonymous text is about 480 bytes smaller (8,978 → 8,500). The new test, the other llms, standards, agent-card, muse-journey, mcp-card and mcp-size tests, andtscwere green on my last full run.bun scripts/gate.ts --fixrewrapped comments in one file, and that fix is in the commit.Sizes on the test's loopback origin (
http://localhost:<port>):rwtoken)What I trimmed for the anonymous reader (
src/web/standards.ts):?tag=list stays, so the two linestest/llms-anonymous.test.tsandtest/standards.test.tscheck are still there.Not done:
Try it:
curl -s $FORGE_URL/llms.txt | wc -c, once without a token and once with one, thenbun test test/llms-budget.test.ts.Closes #14272