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

/llms.txt says how to report a problem or offer a change on each public app #15141

Merged opened this

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

Merged

Nothing new to change on #14857: the branch is already complete and green, so I pushed nothing this run. What is on the branch: each public repository's line in /llms.txt carries its own report URL and offer URL. Private repositories never appear.

Notes

shipped production is serving it deploy c407bfb

opened this

Nothing new to change on #14857: the branch is already complete and green, so I pushed nothing this run.

What is on the branch: each public repository's line in /llms.txt carries its own report URL and offer URL. Private repositories never appear.

What I checked this run:

  • The branch is in sync with its remote.
  • bun x tsc --noEmit is clean.
  • The 11 llms-* test files pass (36 tests), including test/llms-report.test.ts.
  • test/llms-report.test.ts uses one public and one private app and asserts both lines.
  • test/llms-budget.test.ts passes now. Before, it failed on main as well (signed-in document 80,675 bytes against an 80,500 budget).
  • The issue has no new comments.

Two things changed under me. Two commits I didn't write, 168cc837d and 92a74558b, are on the branch. They first state the report and offer URL shape once, and then restore the full URLs on each repository line, with growth bounded per line and by LLMS_LINES. I didn't go through those two commits' diff, only the branch's total change against main (src/web/standards.ts, two test files).

No look: the change is plain-text /llms.txt, which the forge can't picture, and no HTML page changed. That is also why there is no review block.

To try it: curl <origin>/llms.txt and read the ## Public repositories section.

Closes #14857

commented

Nothing new to change on #14857: the branch is already complete and green, so I pushed nothing this run.

What is on the branch: each public repository's line in /llms.txt carries its own report URL and offer URL. Private repositories never appear.

What I checked this run:

  • The branch is in sync with its remote.
  • bun x tsc --noEmit is clean.
  • The 11 llms-* test files pass (36 tests), including test/llms-report.test.ts.
  • test/llms-report.test.ts uses one public and one private app and asserts both lines.
  • test/llms-budget.test.ts passes now. Before, it failed on main as well (signed-in document 80,675 bytes against an 80,500 budget).
  • The issue has no new comments.

Two things changed under me. Two commits I didn't write, 168cc837d and 92a74558b, are on the branch. They first state the report and offer URL shape once, and then restore the full URLs on each repository line, with growth bounded per line and by LLMS_LINES. I didn't go through those two commits' diff, only the branch's total change against main (src/web/standards.ts, two test files).

No look: the change is plain-text /llms.txt, which the forge can't picture, and no HTML page changed. That is also why there is no review block.

To try it: curl <origin>/llms.txt and read the ## Public repositories section.

commented

Each public repository line in llms.txt now carries its complete report URL and its complete offer URL. The offer URL is plain text marked POST, not a markdown link.

  • What failed: the markdown link made the dead-end crawler GET /api/v1/repos/…/offers, which answers 405. That was the red deadends.test.ts finding.
  • What I changed: a repo line now reads · report · offer: POST …/offers. I updated the expected line in test/llms-report.test.ts and test/llms-forks.test.ts to match.
  • Checks: llms-report, llms-forks and deadends pass here. bun scripts/gate.ts --fix and bun x tsc --noEmit were clean. I did not run the full suite.
  • Not caused by this pull: the check log says did-you-mean, wallet, pages-budget, repo-pages-timing and page-budget are red on main at 585bc06 too. I did not touch them.
  • Not re-run: spawn-reach-door.test.ts was red on this pull in the check but green on main. It only showed up in the check's own summary, so I did not run it or diagnose it, and I don't know whether this fix clears it. I ran deadends.test.ts and spawn-reach-door.test.ts together before the fix. The log showed only the deadends failure, so I am not sure spawn-reach-door fails here at all. The forge's check on this push will tell.

No page markup changed, so there is no review block.

Approved

Preview /llms.txt shows each public repo line with its full report link and POST offer URL; the private repo is absent and the test covers one public and one private app. Plain text, no page markup, so the design principles are not touched. Next: (1) the byte-growth assertion (<200 per repo) is loose and tied to origin length; assert the per-line shape instead. (2) Wrap the long expected line in test/llms-forks.test.ts.

Sign in to join this conversation.

↑↓ navigate ↵ open ⌘↵ its app esc close

Keyboard shortcuts

Docs