Inspector Date Token Summary

Traceability

• Spec ID: inspector-date-token-summary
• Status: Implemented

Intent

Move the retained Context-token evidence needed for daily triage onto the Date workbench. Reviewers should see each Session's latest Context and historical compaction snapshots without opening the Usage report, plus one honest summary for the selected UTC day.

Acceptance scenarios

• AC-1: Every Date-mode Session row and matching workbench header show the latest observed Context token value when it exists. Explicit compaction snapshots are summarized with their observed token amount and count.
• AC-2: The selected-date panel shows an aggregate of observed Context snapshots across that day's Sessions, the number of Sessions contributing token evidence, and the provider-observed compaction count.
• AC-3: Daily and per-Session summaries distinguish current Context from compaction snapshots. They never label snapshot sums as provider usage, billing, Session processed tokens, or cost.
• AC-4: Missing current or compaction-token evidence stays unavailable rather than becoming zero. A provider compaction count may remain visible even when its boundary token snapshot was not retained.
• AC-5: Standalone Inspector and native Studio render the same information hierarchy. Long values remain bounded at wide, compact, and narrow layouts, with keyboard focus and the existing Date navigation preserved.

Non-goals

• Deriving billing, cache savings, or provider total usage from Context snapshots.
• Adding token numbers inside every calendar day cell.
• Replacing the detailed Usage report or its per-boundary timestamps.

Plan

1. Add one shared presentation rule for current Context, compaction snapshots, and selected-day aggregation.
2. Render the compact Session token summary in Date navigation rows and workbench headers in standalone Inspector and Studio.
3. Extend the selected-date summary with observed snapshot totals, coverage, and compaction count.
4. Add behavioral and browser assertions, then verify responsive layouts and the real retained Session data.

Test and review evidence

• Replayed the 2026-08-31 Date scope with 18 Sessions: the selected-day summary rendered 4M snapshot-token sum, 12/18 Sessions observed, and 9 compactions. Session rows and matching workbench headers exposed the same current/compaction token evidence.
• Standalone browser checks at 2048x1100, 1024x768, and 390x844 reported zero document overflow and zero console/page errors. The daily summary remained inside the Date picker at narrow width; 12 matching row/header summaries were visible at every layout.
• Native Studio build and typecheck passed. Its focused browser scenario passed the new daily, Session-row, and workbench-header token assertions before an unrelated existing combined-process assertion expected Read · Edit · Bash while the current dirty-worktree fixture rendered only Read.
• Focused source/report suites passed 89 tests. Final npm run check passed 1,604 root tests with 2 skipped, Harness/Harness UI/Studio at 173/31/512 tests, and package verification at 627 npm and 897 runtime entries.