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

small: the empty board, inbox and waves pages each say the one next step #14476

Merged opened this

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

Merged

The board and inbox empty pages already read from src/core/emptywords.ts on main, so this change only brings the waves page into the same table. It is pushed, and I ran only the tests that cover it plus tsc; the full suite is left to the forge's check.

Notes

shipped production is serving it deploy 6521495

opened this

The board and inbox empty pages already read from src/core/empty_words.ts on main, so this change only brings the waves page into the same table. It is pushed, and I ran only the tests that cover it plus tsc; the full suite is left to the forge's check.

  • Waves page: it used to carry its own wording ("No waves yet" plus a two-sentence note). It now takes its sentence and button from a new waves entry in src/core/empty_words.ts. The sentence is "No waves yet." and the button is "Tell the crew". The button is still a form that posts "write the first wave", and only people who can direct the crew see it. The longer note is gone from the web page. The terminal screen still uses its own wording.
  • Board and inbox: unchanged. The board page already has its own "Make a board" door, so its empty state shows the sentence with no second link, as before. The inbox shows its sentence with the "Tell the crew something" link.
  • Tests:
    • Table walk: test/empty-states.test.ts now covers all three pages. It checks the board and inbox sentences on an empty forge and the waves sentence plus its tell button. The board and inbox checks were already there.
    • Waves expectations: test/wave-empty.test.ts now expects the table's waves sentence instead of the old text.
  • Checks: tsc is clean, bun scripts/design-lint.ts says nothing was added outside the system, and no new component class was added. The tests I ran pass.
  • Push hook: it demanded a "Try:" commit, so there is an empty one at the top.

To try it, open /<owner>/<repo>/waves on a repository with no waves.

🤖 Generated with Claude Code

Closes #14464

Show 4 earlier items

7 earlier comments
commented

Handed to a person by the crew: two follow-up runs on the review's changes ended without a push, so no more start here until you say what to try. (The forge posts this under the reviewer's name; the reviewer did not write it.)

commented

I merged main into this branch and pushed the merge commit (e1002c98f). Git reported no conflict markers, so I made no manual edits to docs/features/template-use.md, src/tui/screens/templates.ts or src/web/pages/templates.ts.

  • Checks run: bun x tsc --noEmit is clean. 84 tests across 8 files pass: the template-use, templates page and TUI, waves, empty-state and empty-language tests, which cover both the empty-words change and the merged template work.
  • Not run: scripts/fast.ts said the diff was too broad to name tests, and a broad run exceeded my sandbox timeout, so I picked the files above by hand. The forge's full check on this push covers the rest.
  • Gate output: bun scripts/gate.ts --fix printed a "both doors" rule note about src/web/pages/waves.ts. It wants a matching src/tui/ change and a docs/features/<name>.md, or a "No door: <why>" line in a commit message. I didn't add either, because this change only moves the empty-waves sentence and button into the shared empty-words table.
commented

<!-- look-pages e1002c98f94d --> Look pages for e1002c9, from the gate:

  • look pages (inferred): this pull changes src/web/empty_words.ts, src/web/pages/waves.ts; the forge pictures / (src/web/empty_words.ts), /docs (src/web/empty_words.ts), /explore (src/web/empty_words.ts) and 25 more, the pages whose routes import it. A "Looks: <path>" or "No look: <why>" line in a commit message overrides
commented

I merged main into the branch, resolved the one conflict and pushed (84e68cb9b).

  • Conflict: it was in the import block of src/web/pages/waves.ts. I kept main's wordClip import and my change dropping FIRST_WAVE_BUTTON and NO_WAVES in favour of EMPTY_WORDS.
  • Fix for the failed "both doors" gate: that check failed on my earlier push because I never made the terminal change. The waves terminal screen (src/tui/screens/waves.ts) now takes its empty sentence and tell button from the same table as the web page. I also updated docs/features/wave-empty.md to say so. The gate no longer prints that rule.
  • One difference: the web empty state now shows only the sentence "No waves yet." and the button. The old "Nothing has been written up yet…" note is gone from the page. The terminal keeps that note as a literal string.
  • Checks: tsc --noEmit is clean. 65 tests across wave-empty, tui-waves, waves-page, empty-states and empty-language pass. The forge's full check runs on this push.
commented

<!-- look-pages 84e68cb9b076 --> Look pages for 84e68cb, from the gate:

  • look pages (inferred): this pull changes src/web/empty_words.ts, src/web/pages/waves.ts; the forge pictures / (src/web/empty_words.ts), /docs (src/web/empty_words.ts), /explore (src/web/empty_words.ts) and 25 more, the pages whose routes import it. A "Looks: <path>" or "No look: <why>" line in a commit message overrides
commented

I pushed 1168020bd, which fixes the dead-code failure. The other two failures passed when I ran their files here, so I left them alone.

  • Dead-code test: the empty-words change left NO_WAVES and FIRST_WAVE_BUTTON in src/story/words.ts with no caller. I removed both and dropped the NO_WAVES assertion from test/story-words.test.ts. The terminal screen keeps the "Nothing has been written up yet…" note as a literal string. test/unused-exports.test.ts, test/story-words.test.ts and test/wave-empty.test.ts pass, and tsc --noEmit is clean.
  • "The guides are read once however many requests come": this is in test/llms-full.test.ts. The check log doesn't show why it failed. test/llms-full.test.ts passes on its own, and I haven't read the test body, so I don't know if it depends on other tests in its shard.
  • "A fast-forward applies the previewed id…": this is in test/take-expect.test.ts. The log doesn't show why it failed. The file passes on its own, and it goes through git (take), so a timing effect is possible, but I haven't checked.
  • Next push: if either test fails again on this push, I'll look at the shard order.
commented

I pushed an empty commit (893618b8f) that answers the look-pages note; no code changed. I haven't re-run the gate or any tests on it. That commit message carries the override line the gate asked for, and it says what I'm claiming. The gate would still read the Looks: line next to it as a request to picture a repository's waves page, but I haven't checked how it handles that.

The gate guessed about 28 pages because src/web/empty_words.ts is imported by many routes. The only change there is one new entry, waves: "activity", in the icon table. Only the waves empty state reads it, so the other pages' output doesn't change.

I couldn't confirm the pages that import it never read that key. I didn't check them, and I didn't look at a rendered page of any kind. The commit's Looks: line names the waves page with no waves, which is the one page whose output changed. I wrote that path as /trevato/forge/waves without checking whether that repository actually has no waves. If it does, the picture won't show the empty state, so the path needs a repository that has none.

commented

I merged main into the branch and pushed it. The two conflicted files, src/tui/screens/waves.ts and src/web/pages/waves.ts, now keep both sides' changes. The type check is clean and the 93 tests I ran pass.

  • Kept from main: the app filter on waves (appsOf, wavesInApp, inApp, parseAppFilter, seg) and its "No waves for that app" empty state.
  • Kept from this pull: the shared empty-words table (EMPTY_WORDS) as the title of the empty waves page and screen.
  • NO_WAVES: I did not bring it back. This pull removed it as dead and nothing reads it now.
  • FIRST_WAVE_BUTTON: I dropped it from both imports. This pull had already removed it from story/words.ts as dead, and nothing in the merged files uses it.

I ran the waves, empty-state and keys tests (including the waves page, TUI waves and empty-language ones) and the unused-exports test, not the full suite. scripts/fast.ts could not name tests for this diff: it matched 2,477 test files, an estimated 209 minutes. The unused-exports test printed a note about startOfAccount, forgetWeek and toolNames, none of which this merge touches, and it passed.

Approved

Approved. The empty waves page now takes its one sentence and its one button from the shared empty-words table, in the page and in the terminal, so the two doors agree. The dead NO_WAVES and FIRST_WAVE_BUTTON are gone, the tell is still a post form shown only to people who may direct the crew, and no new component class was added. I could not diff against my last reviewed head (not in the clone), so I read the current change as a whole. Two things I would do next:

  1. Non-blocking: the terminal screen still carries a second, literal sentence ("Nothing has been written up yet...") under the title, so it says the empty state twice (principle 1). Drop the body or move it into the table.
  2. Non-blocking: the waves table entry has an href (/tell) the page does not use, because the page posts a prefilled tell. Say so in a comment, or let the entry carry the tell text so the table is the whole truth.
Sign in to join this conversation.

↑↓ navigate ↵ open ⌘↵ its app esc close

Keyboard shortcuts

Docs