[codex] add token usage diagnostics

[peyton-alt]

Summary

Adds token visibility commands for sessions and checkpoints:

• entire session tokens [session-id] reports token usage, likely contributors, limitations, and optimization recommendations for live session state.
• entire checkpoint tokens <checkpoint-id> reports committed checkpoint token usage with the same usage-first layout.
• Multi-session checkpoints are reported as checkpoint-wide aggregates with Sessions and Agents instead of attributing aggregate totals to the latest session.
• Checkpoint aggregation now preserves nested subagent token totals for diagnostics.
• Session and checkpoint help text now includes the new token commands.

Why

Users need a simple way to see where token usage went during or after a session before building broader aggregation or optimization workflows. This starts with deterministic local visibility from data Entire already captures.

Validation

• mise run check
  • fmt
  • lint
  • go test -tags=integration,authfilestore -race ./...
  • E2E canary vogon: 59 passed
  • E2E canary roger-roger: 4 passed
• git diff --check
• Real checkpoint smoke test: go run ./cmd/entire/main.go checkpoint tokens 0009b566bbbc

[cursor]

Cursor Bugbot has reviewed your changes and found 2 potential issues.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

Comment @cursor review or bugbot run to trigger another review on this PR

^{Reviewed by Cursor Bugbot for commit 9447b36. Configure here.}

[Copilot]

Pull request overview

Adds token-usage diagnostics to the CLI by introducing new tokens subcommands for both sessions and checkpoints, along with tests and updated help/ignore rules.

Changes:

• Adds entire session tokens for reporting token usage + recommendations for a session.
• Adds entire checkpoint tokens for reporting token usage + recommendations for a committed checkpoint (including multi-session aggregation).
• Updates help text/tests and expands .gitignore for additional generated artifacts.

Reviewed changes

Copilot reviewed 6 out of 7 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
t1.txt	Adds a new text file (appears unrelated to the PR’s stated goals).
cmd/entire/cli/sessions.go	Registers the new tokens subcommand under session and updates help text/examples.
cmd/entire/cli/sessions_test.go	Adds extensive coverage for session/checkpoint token reporting behaviors and ordering.
cmd/entire/cli/session_tokens.go	Implements entire session tokens report (text + JSON), contributors, and recommendation rules.
cmd/entire/cli/checkpoint_tokens.go	Implements entire checkpoint tokens report (text + JSON) and aggregation across checkpoint sessions.
cmd/entire/cli/checkpoint_group.go	Registers the new tokens subcommand under checkpoint and updates help text/examples.
.gitignore	Ignores additional generated directories (.clawpatch/, entire-external-cp-test/, skills/).