Lifetime token-counter receipts on the WSL authoring laptop, with what each counter actually counts - #270

- RTK: when rtk_database is configured, the global snapshot adds a
  client_visible view. It re-counts each retained row as a client first
  shows the output: whole up to 30,000 characters, otherwise a
  2,000-character preview (Claude Code 2.1.282 defaults, overridable).
  It reports the top-10 share and the net, and the boundary text says so.
  The view is a model: it excludes later reads of saved files, and Codex
  has its own limits.
- Headroom: record ledger_present from the path the report itself names.
  An absent ledger is labelled rather than read as a measured zero.
- Coverage-matrix boundaries and the README say the same, including
  Context Mode's lifetime = retained events x 256.

Evidence: the independently reviewed host receipts in #270.

Co-Authored-By: Claude Opus 5.5 (1M context) <[email protected]>

…client-visible RTK view, Headroom ledger presence) (#282)

* Token report: state what the RTK and Headroom counters actually count

- RTK: when rtk_database is configured, the global snapshot adds a
  client_visible view. It re-counts each retained row as a client first
  shows the output: whole up to 30,000 characters, otherwise a
  2,000-character preview (Claude Code 2.1.282 defaults, overridable).
  It reports the top-10 share and the net, and the boundary text says so.
  The view is a model: it excludes later reads of saved files, and Codex
  has its own limits.
- Headroom: record ledger_present from the path the report itself names.
  An absent ledger is labelled rather than read as a measured zero.
- Coverage-matrix boundaries and the README say the same, including
  Context Mode's lifetime = retained events x 256.

Evidence: the independently reviewed host receipts in #270.

Co-Authored-By: Claude Opus 5.5 (1M context) <[email protected]>

* Resolve the independent review of the token report semantics

- RTK: state the floor at zero (max(0, raw - filtered)) and why the
  signed client view differs from it.
  - Name the Claude Code 2.1.282 defaults and list the model's
    assumptions: ASCII, preview at most, wrapper text and saved-file
    reads not counted, script rows included.
  - Validate the client limits (inline 4000-128000).
  - Report shares as n/a on a zero total.
  - Omit the view with an issue when the configured database holds fewer
    rows than rtk gain reported.
  - View problems (sqlite, value, type, OS) are the view's own issues and
    no longer fail the rtk gain counter.
- Headroom: use only the path the report names, resolve a relative path
  from the configured project (Headroom's working directory), and label
  an absent ledger only when the reading is zero.
- HTML: the RTK card shows the client-visible net and the reporter's
  boundary; the Headroom card marks an absent ledger and shows its
  boundary.
- Tests pin the inline limit (<=), ceil, the top-ten ranking, zero
  totals, overrides, the mismatch and error paths, the Headroom path
  branches and connection closing. Seven targeted mutations are killed.

Co-Authored-By: Claude Opus 5.5 (1M context) <[email protected]>

* Resolve the second review of the token report semantics

- The component-table RTK boundary states max(0, raw - filtered).
- The boundary says "by default" only when both client limits are the
  Claude Code 2.1.282 defaults, and the preview must stay below the
  inline limit.
- The row cross-check allows 1% fewer rows than rtk gain counted, for
  retention pruning between the two reads.
- Tests cover the configured-limits wording, the preview limit and the
  pruning tolerance. A real-host refresh with the revised code exited 0
  with no issues and a client_visible block.

Co-Authored-By: Claude Opus 5.5 (1M context) <[email protected]>

* Pin the 1% row tolerance and state what it does not detect

Co-Authored-By: Claude Opus 5.5 (1M context) <[email protected]>

* Re-register the token report hashes

Co-Authored-By: Claude Opus 5.5 (1M context) <[email protected]>

---------

Co-authored-by: seathatflowsinourveins <[email protected]>
Co-authored-by: Claude Opus 5.5 (1M context) <[email protected]>