M7: Wrap transcript and timeline lines instead of clipping them

[Sandstorm831]

Parent

Spec #276; implementation sub-issue of M7 #275.

What to build

Long lines in the Session transcript view wrap at the view width and are never cut, because the Projection already carries full content. Timeline rows wrap instead of clipping at the terminal width; rows that advertise truncation, such as names, paths, and statuses, keep clipping with a trailing …. The timeline scroll reducer stays the owner of scroll, live edge, anchor, and new-activity count and counts display lines, so a wrapped row keeps its anchor and the count stays correct; wrapping is recomputed on resize. The Application's 160-character one-line detail cap stays (ADR 0039 replaces those rows later). If the reducer's seam changes to count display lines, the TUI guidance names the change (stories 77–79, 86).

Acceptance criteria

• Renderer tests prove Session transcript and timeline wrap, resize recomputation, and that scrolling, live-edge following, anchor, and new-activity count stay correct over wrapped rows.
• Rows that advertise truncation still clip with ….
• The one-line detail cap is unchanged.
• Prototype Crucible's launch and Run information architecture #23 evidence: keymap and focus, small terminals and resize, large content, interaction tuning, meaning without colour, and renderer and platform evidence, each shown by testRender frames with the fake Renderer Port.
• CI scenario: the transcript and timeline renderer tests are green on Windows x64, macOS arm64, and Linux x64.

Blocked by

• M7: Report structural violations from one rule catalogue in a dedicated gate step #277
• M7: Report guidance-structure violations in the contract and check Module guidance shape #278
• M7: Report vendor-provenance violations in the contract #279
• M7: Report release-workflow violations in the contract #280
• M7: Enforce unused code and clear today's findings #281
• M7: Fail lint on any warning and add two OpenCode style rules #282

Implementation packet

Owner: TUI presentation (Session transcript view, timeline rows, timeline scroll reducer)

Ratchet: renderer tests for wrap, resize, anchor, and new-activity count

Deletes: clipping of transcript and timeline content at the terminal width

Gate: ADR 0027 three-OS CI and recorded human evidence, with the slice scenario above.

Dependencies: no new runtime dependency

[Sandstorm831]

Starting context

Files are pinned at b976b6c, the main commit that closed #281. It carries the unused:check gate link. OpenCode is cited at 228e9095ba, the commit the session-screen research read.

Input	Why it matters	Authority
Spec #276 stories 77–79 and 86, Implementation Decisions › Transcript (the Session transcript view, Timeline rows, and 160-character cap bullets), Testing Decisions › Seams 4 ("transcript wrap and resize, with anchor and new-activity count"), and Further Notes › Still unknown (second bullet)	The target. The reducer stays the owner of scroll and counts display lines. Rows that advertise truncation keep …. The cap stays. The spec does not say how a line is wrapped, whether the new-activity badge counts rows or display lines, whether the anchor must survive a resize, or whether blob evidence in the same overlay wraps. The dividers, the plain labels, and the session s role headers belong to #289, which is blocked by this ticket.	Canonical spec
OpenCode session-screen research, the wrap line, and ADR 0036 › Truncation	In OpenCode only tool output is truncated. User text and assistant text wrap, and OpenTUI's default wrapMode is word. ADR 0036 is read only to avoid contradicting it.	Research; ADR 0036 advisory
OpenCode 228e9095ba packages/tui/src/routes/session/index.tsx: scrollbox :L1180-L1197, scroll commands :L751-L810, InlineToolRow :L1966-L1981, user text :L1419, reasoning header :L1678	The scrollbox scrolls laid-out, wrapped content, so its units are display lines. Line up/down is 1, page is height / 2, and half page is height / 4. The two-column icon beside a flexGrow label makes continuation lines hang under the label. wrapMode="none" is OpenCode's way to keep a header on one line.	Research
Session transcript view: transcriptLines, InspectionView with its per-line clipRunContent, loadOlder, lines and window	One overlay renders both Session transcripts and blob evidence (output, Verdict, diagnostic) through one clipped line loop. Its lines are logical lines split on \r?\n. The prepend anchor bumps top by transcriptLines(read.entries).length. Once lines wrap, that bump must count display lines at the current width, or paging older loses the anchor.	Current behavior
Timeline rows: TimelineRow, durable rows, live rows, oneLine, clipRunContent	Each row is one logical line, because whitespace is collapsed. clipRunContent keeps the … output truncated suffix at the right edge. Once nothing calls it, unused:check fails until it is deleted. The live preview row is not capped anywhere. Each Adapter accumulates the whole streamed text (Claude Code, Codex), so a wrapped preview can fill the viewport.	Current behavior
Workbench timeline: dims and onResize, innerW, chrome and viewportH, timelineRows, win, visibleRows, scrollBy, the new-activity badge, timelineRowText, the viewport	The window is taken over row indices, and the viewport holds exactly viewportH one-line rows. Its comment defers variable-height rows to this change. A resize only updates dims. The badge reads "N new activities", so its unit is rows today.	Current behavior
Timeline scroll reducer and its front-door exports	The Seam is plain numbers: (scroll, total, viewport). Read from source, not run: if total counts display lines, scrolling, the live edge, the append anchor, and the prepend bump all work with no signature change. The reducer alone cannot keep the first visible row across a rewrap. It also reports newActivity in the unit it is given. TIMELINE_PAGE is 10.	Current behavior
timelineDetail cap and RUN_TIMELINE_TRUNCATION_MARKER	Unchanged. A capped detail ends with … output truncated. Once wrapped, the marker ends the row's last display line.	Current behavior
Tests (fixtures touched): run-timeline.test.ts; in run-workbench.test.tsx, events, mountWorkbench, noOverflow, the scroll tests at L1044-L1075, L1156-L1185, and L1204-L1246, and the transcript tests at L1331-L1369 and L1411-L1430; the fake Port's resize	This is the prior art for anchor, new-activity, prepend, and large-content tests. Two tests pin the behavior this ticket deletes, and each is rewritten, not kept beside the new one. L1432-L1463 asserts "the inspection clips each line to width". L1502-L1552 matches /Assistant.*… output truncated/ on one line, which cannot match once that row, wider than 100 columns, wraps. Both files pass at b976b6c (137 tests, run 2026-09-30).	Current tests
tui notes: overflow and flexShrink guard, reducer invariant, clip is the ellipsis affordance, measured in display columns; Workbench test rule; UPSTREAM run-timeline entry	The reducer line is the one to amend if its Seam changes. Wrap widths are display columns (D5), never .length. Record any OpenCode study in UPSTREAM.	Current guidance
Three-OS check job, Test step	The CI scenario: the transcript and timeline renderer tests run in this step on Windows x64, macOS arm64, and Linux x64.	Current behavior

Reading rule

Start with the spec's Transcript bullets, then run-timeline.ts, the two render loops (InspectionView and the Workbench viewport), and the two tests to rewrite.

• The reducer stays the one owner of scroll, live edge, anchor, and new-activity count. It counts display lines. Do not use OpenTUI's <scrollbox>. If an exported reducer type or signature changes, amend the reducer line in src/tui/AGENTS.md in the same change.

• Measure wrap in display columns with string-width. Add no runtime dependency.

• The prepend bump in loadOlder counts the display lines it adds.

• Leave the Application alone: the 160-character cap and the marker text do not change, and headless does not change.

• The header, the timeline label, the overlay title and footer, and the details rows keep clip.

• Leave the transcript's role headers and the timeline labels to M7: Mark Steps and Harness Sessions with dividers and use plain labels #289.

• Delete what becomes unused, such as clipRunContent. unused:check allows no allowlist.

• Measured on 2026-09-30 in a scratch testRender probe against the installed OpenTUI 0.4.5:

  • <text> word-wraps at its container width, breaks an over-long word by characters, and counts a CJK glyph as two columns.
  • It exposes virtualLineCount only after render.
  • It never fills a line exactly. At width 30, the 30-column alpha beta gamma delta epsilon broke before epsilon, and it fit at 31.

  So a pure line count and OpenTUI's own wrap can disagree at exact-fit widths. Render one <text> per counted display line, or count what OpenTUI lays out, but do not count one way and render the other.

• Left to the implementer:

  • wrapping in pure code or reading OpenTUI's layout;
  • the hanging indent for continuation lines;
  • where the wrap helper lives.

• Open for the human (recommendation in brackets). Choices the spec leaves open, each with the drafting recommendation. They are settled with the human when this context is refreshed for ready-for-agent.

  • The new-activity badge counts [rows, since it says "activities"].
  • A resize keeps [the same first visible row].
  • Live preview, activity, and request rows [wrap in full, with no invented cap].
  • Blob evidence in the same overlay [wraps too].
  • The page step [stays TIMELINE_PAGE = 10, now in display lines; the alternative is OpenCode's own height / 2].

Owner: TUI presentation (Session transcript view, timeline rows, timeline scroll reducer)

Ratchet: renderer tests for wrap, resize, anchor, and new-activity count

Deletes: clipping of transcript and timeline content at the terminal width

Gate: ADR 0027 three-OS CI and recorded human evidence, with the slice scenario above.

Dependencies: no new runtime dependency

[Sandstorm831]

Change review

Landed in 7837c30.

Owner and Interface. TUI presentation. The timeline scroll reducer's Seam (run-timeline.ts, front door tui.ts) changed. timelineWindow and scrollTimeline now take each row's display-line count instead of a total. A paused TimelineScroll is { row, offset }, and TimelineWindow also reports that anchor. A page is half the viewport. TIMELINE_PAGE is gone. The new wrap.ts wraps one logical line in display columns, using string-width. The inspection controller takes the interior width and returns wrapped display lines. No ingress Seam changed.

Choices settled with the human

• The badge counts rows: a row counts if any of its lines is below the viewport.
• A resize keeps the same first visible row.
• Live, request, and preview rows, and blob evidence, wrap in full with no cap.
• The page step is OpenCode's height / 2, not 10 lines. With 10, a 7-line viewport skipped 3 lines per page.

Deviation from the Reading rule. The rule says "the prepend bump counts the display lines it adds". Because the anchor is a logical row, the bump counts logical lines prepended, and it holds at any width. A mutation that bumps by display lines turns the new wrapped-paging test red.

Behaviour under test (testRender with the fake Renderer Port, plus pure unit tests):

• Reducer:

  • line steps inside a row;
  • the anchor under append;
  • the anchor under a rewrap, with the offset clamped when a row shrinks;
  • an anchor past the end;
  • the badge in rows, including a row cut at the viewport bottom;
  • the half-viewport page, including odd and one-line viewports;
  • top, latest, re-attaching to the live edge, and an empty timeline.

• wrap:

  • exact fit (the OpenTUI exact-width case);
  • word breaks;
  • over-long words broken by grapheme;
  • CJK, including a glyph wider than the line;
  • tabs;
  • kept indentation;
  • the hanging indent, collapsing when the width is tiny;
  • the truncation marker kept whole.

• Timeline renderer:

  • wrap and rewrap at 100, 60, and 40 columns with no overflow;
  • continuation lines hang;
  • line steps;
  • the anchor under append, with the badge reading 1 then 4 rows;
  • the anchor across widen and narrow, with the exact line restored;
  • a 200-word preview that fills the viewport, with every word reachable;
  • a capped detail wraps and keeps all 157 characters, with the marker ending its last line.

• Transcript renderer:

  • wrap and rewrap on resize;
  • paging older over wrapped entries keeps the first visible entry;
  • a paused transcript keeps its first line across a resize;
  • a failed older read and its retry;
  • the existing large-entry and blob tests.

• The … affordance: the timeline label and the overlay title still clip at 24 and 14 columns.

• Rewritten, not kept beside the new tests:

  • "inspection clips each line to width";
  • the one-line /Assistant.*… output truncated/ match.

  The two Read Session transcripts through paged and export Resource References #124 paging tests now step by half-pages.

#23 evidence

• Keymap and focus: up, down, pageup, pagedown, home, and end are pressed through the Port.
• Small terminals and resize: 14, 24, 40, 60, and 100 columns, each with noOverflow.
• Large content: the 200-word preview, and the existing 600-line transcript and 900-line blob tests.
• Interaction tuning: the half page.
• Meaning without colour: every assertion reads character frames, and continuation lines are marked by indentation.
• Platform: the Linux gate is green, with 1209 tests and binary smoke. Windows x64 and macOS arm64 come from the three-OS check job on this push.

Left untested, on purpose. The header and details rows' … already have coverage in the existing details-panel tests. Rewrap cost on each preview token is not measured. The timeline is bounded, and every live update rewraps it in one pass.

Deleted: clipRunContent, TIMELINE_PAGE, and per-line clipping in both render loops.

Dependencies: none added.

UPSTREAM: the run-timeline entry records the #288 study of OpenCode at 228e9095ba. Taken: display lines as the unit, a 1-line step, and the height / 2 page. Changed: we wrap in our own code, the anchor and badge stay in rows, and continuation lines use a fixed hanging indent.

Guidance: src/tui/AGENTS.md amends the reducer line. It adds the wrap invariant: never let OpenTUI wrap content we count, because its word wrap breaks a line that exactly fills the width.

[Sandstorm831]

CI evidence: the three-OS Check run on 7837c30 is green on Windows x64, macOS arm64, and Linux x64 (run 36809773331). This closes the slice's CI scenario.