feat(logs): opt-in soft-wrap mode (w) and → truncation indicator in /ps:logs

[378-kaiabot]

Note

Automated pull request by Pi, model aperture/hf:zai-org/GLM-5.2. Implemented and validated empirically against
aliou/pi-processes. The bug was confirmed on main by the #75 repro; the fix is verified on
this branch. See the local run log for the full investigation.

Problem

In the /ps:logs overlay (and the /ps preview and dock, which share the renderer), any log line
wider than the viewport was hard-clipped to the row width with no way to see the rest and no
indication that content was lost. renderLogLine called truncateToWidth(text, textWidth, "", true)
— an empty ellipsis — and LogFileViewer.render() mapped exactly one log line to one display row,
so content beyond the viewport width was silently dropped (#75).

Confirmed before the fix: rendering the quick brown fox jumps over the lazy dog at width 10 in a
LogFileViewer produced a single row where lazy was invisible, with no marker that the line was
clipped.

Changes

• extensions/shared/truncate.ts — add wrapToWidth(text, maxWidth, contIndent = 0), a
  grapheme-aware soft-wrap sibling of truncateToWidth. Walks graphemes with the same
  Intl.Segmenter + readAnsiSequence machinery, expands tabs to 3-column stops, never splits a
  wide character across a row boundary, and carries open SGR state across wrapped chunks (each
  chunk re-opens accumulated SGR, each open chunk ends with a reset). With contIndent > 0, the
  first row wraps to maxWidth and continuation rows to maxWidth - contIndent, mirroring less.
• extensions/shared/log-line.ts — add renderLogLineWrap(line, options): same sanitize + tone
  pipeline as renderLogLine but returns string[] of display rows, prefixing every continuation
  row with a dim ↳ marker so wrapped chunks are visually distinct from new log lines. Change
  renderLogLine's ellipsis from "" to "→" so truncated lines (wrap off) are visibly marked in
  all three surfaces.
• extensions/processes-logs/components/log-file-viewer.ts — add wrapEnabled state with
  toggleWrap()/isWrapEnabled(). When wrapping, render() builds a flat display-row list from
  the visible logical lines (each row tagged with its source line for emphasis), and the viewport —
  anchorEnd, scrollBy, scrollToTop/Bottom, search jumps, and the L<end>/<total> status —
  operates on display rows via totalDisplayRows(). A wrap indicator is shown in the status bar;
  the toggle persists across tab round-trips through the existing viewer cache.
• extensions/processes-logs/components/log-overlay-component.ts — wire the w key to
  toggleWrap() and show w: wrap (accent when on) in the footer key hints.
• .changeset/log-viewer-line-wrapping.md — minor-version changeset.

Truncation remains the default for the /ps preview, the dock, and the logs overlay — wrap is
opt-in per viewer, exactly as #75 specifies.

Verification

• pnpm typecheck ✅
• pnpm lint ✅
• pnpm test ✅ (605 passed, 59 files)

Closes #75
Stacked on #93 — merge that first.

---

Run host: golden-hugo-lefevre · Session: 01a00f8d-2ec0-7125-b9b7-8f0cb1c0c50f · Model: aperture/hf:zai-org/GLM-5.2