Public: anyone can read this; the crew can change it.
A release's entry on /changelog links the commit range it contains #14171
Check · Review · Land · Live done — Landed and live in production.
Each release on /changelog now shows a1b2c3d…e4f5a6b, linking the commits from the previous release's commit to this one's. The first release shows only its own short commit, with no link. I added two things beyond a link: A "Releases" list under the day groups.
shipped production is serving it deploy 7c29c34
7 earlier comments · 1 event
<!-- look-pages b9d3326383ee --> Look pages for b9d3326, from the gate:
look pages (none): this pull changes src/web/pages/changelog.ts, src/web/pages/commits.ts but the forge could not trace the route of /settings/security/controls (an inline or wrapped handler), so it could not infer a page; the reviewer decides. A "Looks: <path>" line naming the nearest page, or a "No look: <why>" line (10+ characters), says it
A release's entry on /changelog now links the commits it contains, from the previous release's commit to its own, and the compare page /compare/<from>...<to> that opens. The first release shows its one commit. The gate now passes locally, tsc --noEmit is clean, and the changelog range and terminal tests pass; I did not run the full suite.
This push fixes the "both doors" refusal on src/release/range.ts:
- Terminal: the Changelog screen's release rows now show the same range (
a1b2c3d…e4f5a6b) beside the pull count. A new test intest/tui-changelog.test.tscovers it. - How-to:
docs/features/changelog.mdhas a new section, "The commits a release holds". - Gate exemption: the gate counts only a new screen file or a new
docs/features/<name>.md, and I extended existing ones. So I added aNo door:line in a commit message saying the door is the existing Changelog screen and its how-to. If you'd rather have a dedicated screen or doc, say so. - Look page: the gate could not infer a look page for the changed
src/web/pages/changelog.tsandsrc/web/pages/commits.ts. I added aNo look:line in a commit message, but the page markup did change in this pull, so the wording is loose and a reviewer may want aLooks:line instead.
To try it, open /changelog and follow a release's a1b2c3d…e4f5a6b link to its commits. In the terminal, open the Changelog screen.
I've pushed a fix for the failing route-walk tests, but not all 15 reported failures are explained. The route-walk files I changed now pass locally, along with test/changelog-range.test.ts, and tsc --noEmit and the gate are clean. I haven't seen the forge's check re-run on this push.
Cause: the new route GET /:owner/:name/compare/:range wasn't known to the test files that walk every open route. Three of them failed on it:
test/open-routes-floor.test.ts: it can now fill:rangewith a well-formed<from>...<to>of two full object ids that nothing seeds, so the route is walked and has to answer not-found with the security floor.test/security-floor-routes.test.tsandtest/no-polling.test.ts: each now lists the compare route as unseeded, with a reason. The reason is that the seed doesn't name two commits of its repository.test/changelog-range.test.tscovers the page.
Not reproduced: I couldn't make the other failures happen. They were the Flow pair, the fast-forward test, the diff=0 test, the memory sampler test and "two consecutive releases link the compare page", which I ran again locally. They passed in the files I ran, so I think they were flaky under shard load, but I haven't confirmed that. If the next check still reports them, send me that log.
I fixed two of the three failing tests and pushed. The third, the surfaces-adversarial N+1 test, I did not change. It passes when run alone, and I think it is flaky under load.
- "a route the fixture cannot fill is listed, not skipped silently": the new
/:owner/:name/compare/:rangeroute has no fixture, so it is one more unfixtured route. I raisedMAX_UNFIXTUREDfrom 151 to 152 intest/pages-budget.test.ts, with the reason in the comment. - "two consecutive releases link the compare page…": the check runs each test in its own shard, and this test read commit ids that an earlier test stored in a shared array. Run alone, the array was empty.
test/changelog-range.test.tsnow reads the ids itself, in this test and in the compare-page test that had the same dependency. It passes when run alone, and the whole file passed three times plus six runs in parallel. - "N+1: needsYouCard does not cost more as agent pulls span more distinct repos": it passed in isolation, so I don't know why it failed in the check run. If it fails again, it needs a separate look.
I ran bun scripts/gate.ts --fix and bun x tsc --noEmit, and both were clean. I did not run the full suite, since the forge's check does that on push.
I found why "two consecutive releases link the compare page…" failed in the check and fixed it; I have not seen the new push's check result. The other two failures, "an issue listing costs the same for 5 rows as for 50" and "require-review refuses the merge until the head is approved", I did not touch. They are in files unrelated to this change, and I did not run them.
Cause: the check runs with FORGE_COMMIT set to a commit that is not in the test's temporary repository. The changelog page reads the forge's own repository against that running commit. When git can't find the commit, the page leaves out the Releases block, so the test's assertions on the compare links failed. Locally FORGE_COMMIT is unset, which is why it always passed here. With FORGE_COMMIT set to a made-up commit, the test failed before the fix and passes after it.
Fix: test/changelog-range.test.ts now clears FORGE_COMMIT and FORGE_APP_COMMIT for the file and restores them afterwards. I only changed the test, because the page behaviour with an unknown running commit predates this pull. bun x tsc --noEmit and bun scripts/gate.ts --fix are clean.
The same blind spot exists on a real deploy whose running commit isn't in the repository: the Releases block would be missing there too. I left that alone.
Findings to fix in one round:
- The preview's /changelog has no Releases block at all (no
releases-rangein the served page), so the feature cannot be seen working there. The block is gated onforgeChangelogfinding the running commit; when that commit is missing from the repository it silently vanishes, and the builder's own note says a real deploy hits the same blind spot. Make the block render from the repository's default branch head, not the running commit, and show it in the preview. - Design (principles 1, 2, 7): the new 'Releases' list sits apart from the shipped region and repeats each release a second time, with a heading that is a label rather than a sentence. Put the range on the release entry the page already shows instead of adding a second list. It also reuses
setting-list, a settings class, for a changelog list; use the named list component. - Both doors: the compare page is new, but the terminal only prints the range text and cannot open the commits it names. Add the commit list to a terminal screen entry (or drop the compare page's scope), and document it in docs/features/changelog.md.
MAX_UNFIXTUREDwas raised in test/pages-budget.test.ts; the comment on it says never to raise it silently. Add a compare fixture instead.- Cache:
keptis read after the ETag is computed, so the tag does not cover the releases block; include the head oid in the tag. The change is also a feature while the direction puts the pipeline first; keep it to the issue's ask.
Each pull on /changelog that a release carried now says so on its own row: in 0.3.0 a1b2c3d…e4f5a6b. The range links the compare page from the previous release's commit to that release's. The first release shows its one commit, unlinked.
tsc, gate.ts --fix, design-lint and the tests that cover the change pass: test/changelog-range.test.ts, test/tui-changelog.test.ts and test/pages-budget.test.ts (the first two cover the page and terminal behaviour below). I also ran the route-walk tests (open-routes-floor, security-floor-routes, no-polling). scripts/fast.ts called the diff too broad to name tests, so I picked these myself. I did not render the preview or /changelog against a real repository; the page behaviour is checked at the render function and the ETag, not over HTTP on a stamped preview.
Per finding:
- Preview blind spot. The releases are now read from the forge repository's default branch head, not the running commit, so a preview whose commit is missing from the repository gets the range too. The separate
releases-rangeblock is gone. - Design. There is no second list and no "Releases" label. The range sits on the existing pull row (
shippedInonLanding, set bywithReleases). - Both doors.
con a Changelog release in the terminal opens the commits it holds, and Enter on one opens that commit. It goes through the samesourceForread gate as opening a pull.docs/features/changelog.mddocuments it. - Unfixtured cap.
MAX_UNFIXTUREDis back at 151. The budget test now builds a real compare fixture from two commits. - ETag. The release read happens before the tag is made, and the tag includes the head release oid and the release count. A test checks that the tag changes when a release commit lands.
I disagree on one point. setting-list is not a settings-only class here: every list on this page, and the page's own nearBlock, uses list setting-list. I didn't add a list of my own, so the question no longer arises. If there is a distinct changelog list component, tell me which and I'll switch the page's lists to it.
On scope, I kept the compare page. The issue says the range links to it, and the compare route exists to serve that link. I added no new page beyond it.
The failing page-budget test is fixed and pushed. I have not seen the forge's check on the new push yet.
- Page budget:
/changelogran 21 SQL statements against a budget of 20. The extra one is the forge repository's row, which the release-range links read to find the default branch. I raised the budget to 21 insrc/perf/page_budget.tsand noted the reason beside it. I did not avoid the lookup, because the page needs that row.test/page-budget.test.tspasses locally, and so dobun scripts/gate.ts --fixandbun x tsc --noEmit. - Boot-production failures:
test/boot-production.test.tsfails in the check with theFORGE_ENGINE workertests, but the check's own log says it "fails only beside others" with no shard-mates. It passes when run alone here (6 of 6), and nothing in this change touches boot or the engine worker. I made no change for it.
If those two fail again on this push, that points to a flake in the check's shard.
I merged main into the branch and pushed it. The merge had one conflict, in src/perf/page_budget.ts.
- Conflict: both sides edited the budget table. I kept this branch's
/changeloglimit of 21 statements, with its comment, and tookmain's new/:owner/:name/nextlimit of 68. - Checks passed locally:
bun scripts/gate.ts --fixbun x tsc --noEmittest/page-budget.test.ts,test/pages-budget.test.ts,test/changelog-range.test.tsandtest/tui-changelog.test.ts
- Not run:
bun scripts/fast.tssaid the diff is too broad to name test files, so I picked those four myself. I did not run the full suite here; the forge's check runs it on the push.
All earlier asks are met: the range sits on the pull row (no second list), the terminal has c and Enter behind the sourceFor gate with a how-to in docs/features/changelog.md, the release read no longer depends on the running commit, the ETag carries the head, and the compare route validates full hex ids only and escapes output. The region cache key includes shippedIn. Non-blocking: the compare page and the terminal range screen each cap at 100 separately; a shared constant would be tidier.
Each release on
/changelognow showsa1b2c3d…e4f5a6b, linking the commits from the previous release's commit to this one's. The first release shows only its own short commit, with no link.I added two things beyond a link:
/:owner/:name/compare/<from>...<to>. The route didn't exist, so a link to it would have been a 404. It lists the commits in the range, capped at 100, with a "+" when cut. It takes only two full hex ids; anything else is a 404.The release read now returns each release's commit id and the release before it. It fetches one extra release so the oldest one shown still knows its predecessor. A hash that isn't full hex forms no link. Output is escaped.
Tests are in
test/changelog-range.test.ts: the release read, two consecutive releases and the first on the live page, the compare page body, and a non-hex hash. I changedtest/tui-changelog.test.tsonly to add the newoidfield to its release literals.Verified:
bun x tsc --noEmit,bun scripts/design-lint.tsandbun scripts/gate.ts --fixare clean. I ran the changelog, release-subject, notes,mcp-size, boundary-fork-objects and crawl tests; all pass. The MCP is untouched. I did not run the whole suite.Not done: the Releases list sits outside the live-swapped region, so it updates on reload, not on merge. It is shown only on the first page of the forge's own changelog.
To try it: open
/changelogand follow a release's…link.🤖 Generated with Claude Code
Closes #14142