[BunsDev]

Refs #410. Stacked on #427 (#409), which is stacked on #426 (#408). Retarget to main after those merge. Classic stays the default renderer.

What this ships

The first usable Next journey (COVEN_CODE_UI=next): launch from a fresh home, see the workspace, write a multiline draft, submit, stream, scroll, inspect, cancel and quit.

• Layout (next/layout.rs) follows the accepted docs: establish the TUI v2 source and compatibility baseline #421 thresholds. Below 80x24 is Focus, and below 120x32 is Single; in both the inspector replaces the main pane. At 120x32 and up, Split shows a transcript of at least 72 columns, a divider and a 40 to 60 column inspector. Rows are given out by priority (composer, status, header, rule, main, hints), so 20x6 down to 0x0 never underflows or hides the composer.
• Workspace line: project, session title, model and familiar. The familiar is labeled (unverified) because a display name is not identity before [TUI v2][P0] T5: unify session/familiar navigation, identity visibility, and reconnect recovery #412. Optional parts are dropped from the end when they don't fit.
• One inspector (Alt+I) with Activity, Session and Views pages. A new Inspector keybinding context is layered over Chat, so Escape closes the inspector first, Tab pages through it, and every other key still edits the draft. Views lists Work, Research and Memory as unavailable with their blocking issue ([TUI v2][P1] T6: expose Psyche-backed tasks, dependency tracking, lanes, and durable goals natively #413, [TUI v2][P1] T7: add a native research workbench with source provenance, citations, and resumable artifacts #414, [TUI v2][P1] T8: add a private, read-only familiar-memory inspector and explicit context selection #415); nothing is placeholder content. Commands remain the existing Ctrl+K palette and / suggestions.
• Reading position: a scrolled reader stays on the same text while output arrives below or is removed, for example when a cancel clears live text. The offset is rescaled when the transcript rewraps and clamped to the scrollable range. A notice shows new activity and the jump-to-live key (Alt+L). Tool starts never move focus or position.
• Cancellation (Next): Escape during streaming records a request that the loop performs through the turn's cancellation token. Next shows cancelling until no worker remains, then Cancelled.. A remote-control cancel also waits for the runtime.
• Composer: the terminal cursor follows the draft for IME input, including wrapped, wide-character and taller-than-composer drafts. A non-empty draft is labeled draft not sent. Pasted newlines or / text never submit, and large pastes keep the existing placeholder.
• Fallbacks: images and documents in messages, and pending image attachments, render as text such as [image shot.png 640x480]. Voice recording shows in the status line.
• Selection: the Next transcript pane is now the selection and copy target, through Classic's row cache and highlight. Per-message hit maps stay empty, so nothing targets Classic's layout.

Classic is unchanged

Every new behavior is limited to Next. Classic's Escape and Ctrl+C handling, keys, goldens and docs match the #409 head.

A Classic bug was found and left alone. Escape during streaming only resets the screen: the turn keeps running and its output lands later, while the docs say Escape stops generation. This was reproduced on a65df294 with a fake claude. Next cancels through the turn's token. Fixing Classic the same way is a one-line change, which can be its own PR if you want it.

Review

An independent reviewer read faf60b8. The second commit resolves the findings:

Finding	Resolution
The cancel outcome was never shown because the loop cleared the status	settle_cancellation reports Cancelled.
A remote-control cancel was shown as done before the runtime stopped	note_cancellation_sent keeps it pending
A cursor in a tall draft was hidden	The composer scrolls to the cursor row
An earlier line with wide characters put the cursor on the wrong row	Rows are counted with the same walk wrap_line uses
The anchor ignored shrinking, rewrap and over-scroll	Signed correction, rescaling on width change, clamping
Inspector scroll had no upper bound	Bounded by the last drawn page
The tmux completion check was vacuous, with only one resize	The fake now finishes at 6s and is checked after 7s; resizes to 80x24, 40x12 and 120x40

The five new unit tests fail on faf60b8 and pass on the fix.

Not changed, recorded here instead:

• A user chord that starts with Alt+I or Alt+L, such as alt+i alt+j, now resolves at the first key. Rebind or unbind the new action to restore it.
• While the inspector is open, PageUp and PageDown scroll the inspector, not the Split transcript.
• Inspector hints don't consider CHAT_FIXED_ROUTES.

Verification

All results are on the head of this PR.

Check	Result
cargo test -p claurst-tui --locked --test next_shell	18 passed
cargo test --workspace --locked --no-fail-fast	2838 passed, 0 failed, 52 ignored
cargo clippy --workspace --all-targets --locked -- -D warnings	clean
Default keybinding golden	regenerated: 8 added lines, nothing else changed
tmux case 08_next_shell (real binary, fake claude, disposable home)	27/27; the quit check waits for the app to exit (51a7705)
Full tmux suite at 120x40	75/75
Full tmux suite at 80x24	69/71; both failures are the Classic help overlay (#423), same as the #409 baseline

The fake claude proves the shell journey only. It is not evidence for tools, approvals (#411), sessions (#412), tasks, research or memory.

Still open for #410

• Suspend and resume: Ctrl+Z is a plain key in raw mode in both renderers, and neither suspends. This needs a decision before it can claim parity.
• Selection is stored in screen cells, so a resize or an inspector toggle clears its meaning.
• The 180x50 navigation column: navigation is the Views page at every size, with no separate column.
• Tool rows are compact name and state only. Detail, diffs and approvals are [TUI v2][P0] T4: ship first-class tools, diffs, and authoritative approval workflows #411.
• Frame cost grows with transcript length because the whole transcript is projected and wrapped every frame: Next renders the whole transcript every frame: cost grows with transcript length #439. Follow-up after this merges, as is a Next-only jump-to-start key; today only Alt+L returns to live.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
docs	Ready	Preview	Nov 2, 2026 5:59am UTC