Skip to content

v0.3.1 — Retrospective Claude Code session reader

Choose a tag to compare

View all tags
@rohynal rohynal released this 26 Aug 01:16
· 3 commits to main since this release
v0.3.1
9011bba
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

v0.3.1 — Retrospective Claude Code session reader

This release adds a new retrospective discovery surface for Claude Code history:

  • sentience scan
  • /sentience-review

The Reader inspects existing Claude Code transcripts and surfaces recorded write activity that crosses identifiable project boundaries or targets locations where a project cannot be identified today.

It is deliberately separate from live governance. The Reader emits no GovernanceEvent, writes no trace, does not mutate ~/.sentience, and does not participate in capture, policy evaluation, enforcement, or session management.

Highlights

  • Bounded streaming reader for large Claude Code histories
  • Project-root resolution and suppression of known Claude infrastructure noise
  • Three-state retrospective review UX
  • Read-only sentience scan path with zero writes
  • /sentience-review Claude Code skill
  • --since 7d, 30d, and all
  • JSON output for structured inspection
  • Conservative handling of Git worktrees and unidentified destinations
  • Improved ranking so weaker non_project evidence does not overshadow stronger cross-project findings
  • Reader surfaces added to command and skill discovery
  • PyPI README changelog link fixed and verified in the packaged long description

Validation

Validated against a real 39-file / 246 MB Claude Code history:

  • 78,637 records scanned
  • ~43 MB peak RSS
  • read-only transcript verification
  • real cross-project findings manually checked
  • 84 Reader tests
  • 1,140 full-suite tests
  • Python 3.10–3.13 CI matrix green

The exact release artifacts were validated on TestPyPI before merge and then published unchanged to production PyPI.

Important boundary

Sentience Reader is a retrospective reviewer, not live governance. It can show what recorded execution history reveals, but it cannot establish what you intended or authorized, or whether an action complied with policy.

Sentience Governor provides that stronger runtime evidence by evaluating declared objective, scope, execution, and policy while the agent is running.

Assets 2
Loading