The owner sees each chapter on the page: its issues, how many are closed, and a Close chapter button that says what stops it #12307

/next now has a Chapters section. It lists each chapter with its progress, gives the owner a Close chapter button, and names the open issues when a chapter can't close. The new test/chapters-page.test.ts passes, and so do the existing chapter and /next tests I ran (64 in all). bun scripts/gate.ts, bun x tsc --noEmit and the design lint (bun scripts/design-lint.ts) are clean. I did not run the full suite, and the screenshots the issue asks for are not in this pull.

What changed

• Section (src/web/pages/next_chapters.ts): up to ten chapters, each with issues closed against its list. Anyone who can read the repository sees the section; only a human admin of the repository gets the buttons. A repository with no chapters shows nothing. It sits inside the existing nextPage, so Server-Timing already names session and render.
• Refusal: a chapter with unfinished issues shows, for example, "v1.0.0 cannot close: 2 issues are still in its way: #12 …". Pressing Close chapter refuses with that same sentence and changes nothing.
• Close: POST /:owner/:name/chapters/:chapter/close is same-origin and closes without moving anything. It sends you back to /next, and the chapter shows a receipt with the tag.
• Undo: …/undo is available for 60 seconds. It deletes the tag and reopens the chapter. It also raises a new chapter.reopened event, listed in src/core/event_audience.ts.
• Code and docs: the logic is in src/actions/chapters.ts (stopsClose, undoableClose, reopen), src/web/pages/chapters.ts handles the two new verbs, and docs/features/chapters.md has a paragraph on it.
• Tests: test/chapters-page.test.ts covers the section and progress, the refusal text, the 403 on a cross-origin POST, the receipt, undo, and undo refused after a minute. The tests for the section and the refusal text would fail without them.

Left out

• No undo after "Ship it": a close that moved unfinished items to the next chapter (the existing Ship it button) has no undo, because that would mean moving the items back. The undo is refused with a stated reason.
• No screenshots: I couldn't capture before/after screenshots from the sandbox; the preview deploy of this pull is the place to look.
• No new page or terminal screen: none was needed, since this extends /next.

Try it: on a repository with an open chapter, open /<owner>/<name>/next and find Chapters. Close chapter should refuse naming the open issues. Finish them, then close the chapter and press Undo within a minute.

Gate is clean now (the earlier output was from before the commit message lines existed). tsc was silent too.

I fixed the gate failure from the first check run and pushed it as 14201e377. bun scripts/gate.ts now passes after the commit, and bun x tsc --noEmit reported nothing. I did not re-run the tests here, since only comments and a commit message changed.

• Comment wrapping: the over-long comment lines in src/actions/chapters.ts, src/web/pages/next_chapters.ts and test/chapters-page.test.ts are rewrapped to 100 columns, with no code changes.
• "both doors" rule: I did not add a terminal screen or a docs/features how-to. The commit has a No door: line instead: the chapters section is the owner's action on /next, and the same close and undo already go through actions/chapters.ts. If a reviewer wants the terminal screen, it is a follow-up.
• "pipeline first" rule: the commit has a Direction: line saying this user-facing change goes ahead of the pipeline items. I did not touch the pipeline.

To try it: open /alice/shop/next, find Chapters, and press Close chapter on an open chapter. A chapter that cannot close names the open issues in its way. One closed in the last minute shows its receipt and an Undo.

This round fixes four of juniper's points; the before/after screenshots (box 3, point 2) are still missing. The sandbox has no browser, so I couldn't capture them. The preview at https://lab--12307--forge-trevato-apps.open-platform.sh will show the section once the push deploys. bun scripts/gate.ts and bun x tsc --noEmit pass. So do the three chapter test files (32 tests, run directly). I did not run bun scripts/design-lint.ts to completion.

• Terminal door (point 1): the chapters screen already existed at src/tui/screens/chapters.ts, so I added keys to it rather than a new screen.

- c closes the open chapter at the cursor with nothing moving. A refused close shows the same "cannot close … still in its way: #N title" sentence the page shows. - u undoes a close within 60 s. - Live updates: a row closed in the last minute says u undoes it. Both acts go through close and reopen, which append chapter.closed and chapter.reopened. The screen follows any chapter.* event, so web viewers see the change live, and docs/features/chapters.md now names c and u.

• Receipt (point 3): the page now says "Closed v1.0.0 and tagged it. You can undo for a minute." The tag and the 8-character id are gone from the meta line. setting-list is documented in docs/design/areas/settings.md and kept. inline is not named in any design doc, so I dropped that class from the forms.
• Undo refusals (point 4): undoBlock returns moved or another_open. another_open has its own sentence: "Another chapter has been opened since, so this close cannot be taken back."
• Tests (point 5): test/chapters-page.test.ts now covers these cases:

- the moved refusal; - the another_open refusal; - a non-owner and an agent refused the undo, both through reopen and through the page POST; - anonymous POSTs to close and undo; - the chapter.reopened event being appended; - the terminal c refusal and u.

I did not check that each one fails without the change.

• Direction (point 6): noted. This round touches only the chapters section and its door.

This push fixes the gate failures from the last check. The gate, tsc and test/chapters-page.test.ts (9 tests) now pass here. I did not run the full suite, and design-lint printed no complaints.

The pull adds each chapter to /next for the owner, with its progress and a Close chapter button. The button names what stops a close, and a closed chapter can be undone for 60 seconds. The terminal gets the same through c to close and u to undo, with the same refusal sentence.

What the fix changed:

• Timers: the terminal test now waits on the work the screen tracks, through ctx.track, instead of three real setTimeout waits. It no longer depends on timing.
• Casts: key events are built as full KeyEvent records through a small press helper, replacing the as never casts.
• Comments: two comment lines in src/actions/chapters.ts and src/tui/screens/chapters.ts were rewrapped to 100 columns.

The test's stub context still goes through as unknown as Ctx, like the existing Session stub. The gate accepts that form.

I changed no behaviour and added nothing left out. To try it, open /alice/shop/next, find Chapters, and press Close chapter on an open chapter.

The branch was never rebuilt and the pod-limits change was never pushed to it. Pull #12307's head is 305bf748f, the same commit as origin/scout/12288-the-owner-sees-each-chapter-on-the-page. Commit 14201e377 is an ancestor of it, and src/web/pages/next_chapters.ts and test/chapters-page.test.ts are both there.

The diff against main is just the chapters work, 8 files:

• src/actions/chapters.ts
• src/web/pages/next_chapters.ts and src/web/pages/next.ts
• src/web/pages/chapters.ts
• src/tui/screens/chapters.ts
• src/core/event_audience.ts
• docs/features/chapters.md
• test/chapters-page.test.ts

The changes to src/kernel/vitals.ts, src/system/*, the system terminal screen and its page come from main, not from this branch. They landed there after this branch was cut, in 5e52b454d and b07067411 (#12354). A diff that compares 14201e377 with main's tip shows them; a diff that compares it with the pull's head does not. So I changed nothing and pushed nothing new.

What's on the branch, in order:

• 651a9c655: /next gets a Chapters section. Each chapter shows its progress and a Close chapter button that names the issues stopping it. A close can be undone for 60 seconds.
• 7aa68b6d9: the terminal gets the same controls. c closes a chapter and u undoes. The undo refuses on its own terms when another chapter has opened since. The receipt is said once, in words.
• 305bf748f: the chapter tests wait for the work they start instead of sleeping on timers, and they build real key events.

Checked on this head:

• bun x tsc --noEmit is clean.
• The branch merges into the current origin/main without conflicts.
• test/chapters-page.test.ts plus the other chapter and /next tests pass: 125 tests in 17 files, 0 failures, 1 skipped.
• bun scripts/gate.ts printed nothing at all.

Not in this pull: the before/after screenshots. My sandbox has no browser, so I can't take them. To see it yourself, open /alice/shop/next on the preview, find Chapters, and press Close chapter on an open chapter. Press Undo within 60 seconds. In the terminal, open Chapters and press c to close, then u to undo.

🤖 Generated with Claude Code