Skip to content

feat(session): optional git-notes checkpoint for audit trail#68

Merged
RyderFreeman4Logos merged 1 commit intomainfrom
feat/git-notes-checkpoint
Feb 13, 2026
Merged

feat(session): optional git-notes checkpoint for audit trail#68
RyderFreeman4Logos merged 1 commit intomainfrom
feat/git-notes-checkpoint

Conversation

@RyderFreeman4Logos
Copy link
Owner

Summary

  • Add csa session checkpoint --session <id> to write audit-trail git notes on session commits
  • Add csa session checkpoints to list all checkpoint notes
  • Notes target the session's specific commit (not HEAD), preserving audit integrity across multi-session repos
  • Deterministic tool attribution when sessions have multiple tools (alphabetical sort)
  • TOML-serialized CheckpointNote struct with session metadata, token usage, and timestamps

Changes

  • New: crates/csa-session/src/checkpoint.rs — core checkpoint module (~360 lines, 11 tests)
  • Modified: crates/csa-session/src/lib.rs — register checkpoint module
  • Modified: crates/cli-sub-agent/src/cli.rs — add Checkpoint and Checkpoints subcommands
  • Modified: crates/cli-sub-agent/src/main.rs — dispatch new subcommands
  • Modified: crates/cli-sub-agent/src/session_cmds.rs — handler implementations

Test plan

  • cargo clippy -p csa-session -p cli-sub-agent -- -D warnings
  • cargo test -p csa-session -p cli-sub-agent (845 unit + 8 E2E)
  • just pre-commit
  • CSA review passed (P1 HEAD-binding fix, P2 deterministic tool fix applied)
  • @codex review

🤖 Generated with Claude Code

@RyderFreeman4Logos
Copy link
Owner Author

@codex review

@chatgpt-codex-connector
Copy link

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, add credits to your account and enable them for code reviews in your settings.

1 similar comment
@chatgpt-codex-connector
Copy link

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, add credits to your account and enable them for code reviews in your settings.

[MOTIVATION]
Sessions need a lightweight audit trail that integrates with git's
native features. Git notes provide this without modifying session files.

[IMPLEMENTATION DETAILS]
- Add checkpoint module to csa-session with write/read/list operations
- Notes stored under refs/notes/csa-checkpoints namespace
- Notes target the session-specific commit (not HEAD) for correctness
- Structured TOML format: session_id, tool, status, turns, token usage
- Deterministic tool selection (alphabetical) for multi-tool sessions
- CLI: `csa session checkpoint -s <id>` and `csa session checkpoints`
- 11 tests covering roundtrip, session targeting, deterministic tools

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@RyderFreeman4Logos RyderFreeman4Logos merged commit 263cb07 into main Feb 13, 2026
0 of 5 checks passed
@RyderFreeman4Logos RyderFreeman4Logos deleted the feat/git-notes-checkpoint branch February 13, 2026 22:42
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