Skip to content

docs(demo): act 2 shows both CTX% producers via -p/-t role naming - #111

Merged
arcaven merged 1 commit into
mainfrom
feat/demo-tui-metering
Aug 5, 2026
Merged

docs(demo): act 2 shows both CTX% producers via -p/-t role naming#111
arcaven merged 1 commit into
mainfrom
feat/demo-tui-metering

Conversation

@arcaven

@arcaven arcaven commented Aug 5, 2026

Copy link
Copy Markdown
Member

The demo runbook could not show the context-feed feature that merged in #110, and act 2 still carried a TODO claiming CTX% has one producer (the heartbeat RPC) — stale twice over since the stream accountant and the statusline feed landed. This makes the demo demonstrate what the code now does, with the mode readable straight off the session table.

  • Act 2 (-p/-t naming + TUI row): the matrix gains analyst-t, the same claude binary run interactively with context_feed = "statusline". Role suffixes carry the mode (analyst-p, builder-p, scout-p, analyst-t) into every session name and event tag. The act now shows both CTX% producers in one table — verified live: analyst-p 13% via stream accountant beside analyst-t 10% via statusline feed, with the pane's own bottom line reading "CTX 10% · $0.37".
  • claude.toml squad: coders gain context_feed, so the scale/inject/chaos demo doubles as the metering demo and demo-watch's session pane gets a live CTX column.
  • Stale TODO replaced with the current three-producer state (stream accountant, statusline feed, cooperative heartbeat), noting interactive codex/opencode remain unmetered (aae-orc-7hzb).
  • Placeholders, marked PLANNED and not written: act 3 extension (shift onto a new metering contract) and act 5 Meter. The act 3 placeholder documents the frozen-runtime wrinkle — session runtime is copied at spawn, so a re-applied manifest cannot retrofit the feed onto live sessions; shift is the honest migration path. Filed as a bd bug with fix shapes.

Docs and manifests only; no code changes.

Refs: aae-orc-7hzb, finding-011

Act 2's matrix gains a fourth role: the same claude binary run as an
interactive TUI with context_feed = "statusline". Role names now carry
the mode (-p = print/headless, -t = TUI) so the session table and event
stream read at a glance. The act's punchline upgrades from "one event
vocabulary" to "one table, two CTX% producers": -p rows meter via the
stream-fed accountant, the -t row via the statusline feed. Verified
live: analyst-p 13% (stream) beside analyst-t 10% (statusline).

Also: claude.toml squad coders gain context_feed so the scale demo
doubles as the metering demo; the stale act-2 TODO claiming the
heartbeat RPC is the only context producer is replaced with the
current three-producer state; placeholders added for the planned act 3
shift-onto-feed extension and act 5 Meter, both marked not written.
The act 3 placeholder documents the frozen-runtime wrinkle (session
runtime is copied at spawn, so re-apply cannot retrofit the feed onto
live sessions) with its bd ticket.

Refs: aae-orc-7hzb, finding-011
@arcaven
arcaven merged commit 50376b2 into main Aug 5, 2026
9 checks passed
@arcaven
arcaven deleted the feat/demo-tui-metering branch August 5, 2026 19:25
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