Skip to content

docs: §4.5 rolling-console / agent-UI cookbook recipe#200

Merged
rorygraves merged 1 commit into
mainfrom
docs/rolling-console-recipe
May 1, 2026
Merged

docs: §4.5 rolling-console / agent-UI cookbook recipe#200
rorygraves merged 1 commit into
mainfrom
docs/rolling-console-recipe

Conversation

@rorygraves
Copy link
Copy Markdown
Contributor

Summary

  • New docs/cookbook/rolling-console.md walks the Claude-Code / Cursor-style transcript pattern: buffer + scrollOffset + autoTail model, key + mouse-wheel routing, view composition with LogView + an InputNode prompt, and bounded history.
  • Explicit framing that TermFlow owns an in-app scrollback viewport inside the alternate buffer — native terminal scrollback is the post-1.0 §5.3 idea, not the default contract.
  • Wired in from cookbook/index.md, SUMMARY.md, and the LogView section of guide/widgets.md. Links ChatStreamApp as the worked example.
  • Roadmap §4.5 marked landed; only §4.2 (release-doc sweep) remains in §4.

Test plan

  • mdbook build clean (no link warnings, no missing pages)
  • All API references (LogView.maxScroll, LogView.scrollDelta, LogView.Viewport, Prompt.handleKey, Prompt.renderWithPrefix, Layout.toBudgetedRootNode, RootNode / InputNode shapes) verified against current main
  • No code changes — ciCheck not needed for this PR

New docs/cookbook/rolling-console.md walks the Claude-Code / Cursor-
style transcript pattern: model shape (buffer + scrollOffset +
autoTail), auto-tail logic, key routing, mouse-wheel scrollback via
LogView.scrollDelta, and view composition with LogView + a bottom
InputNode prompt. Bounded history via takeRight(MaxHistory).

Recipe is explicit that TermFlow owns an in-app scrollback viewport
inside the alternate buffer; native terminal scrollback stays a
post-1.0 §5.3 idea, not the default runtime contract. Links to
ChatStreamApp as the live worked example.

Wired in from cookbook/index.md, SUMMARY.md, and the LogView section
of guide/widgets.md. mdbook + linkcheck clean. Roadmap §4.5 marked
landed; only §4.2 (release-doc sweep) remains in §4.
@rorygraves rorygraves merged commit 8df2d8e into main May 1, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant