Skip to content

Sentience Governor v0.3.0.3: Self-Converging Claude Code Hook Configuration

Choose a tag to compare

View all tags
@rohynal rohynal released this 25 Aug 02:18
v0.3.0.3
9ac6883
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Sentience Governor v0.3.0.3

This release fixes silent capture loss after a package uninstall or reinstall, by moving the Claude Code hook binding to the machine-local settings layer and keeping it current automatically.

The problem this fixes

Uninstalling or relocating the package left projects wired to a hook path that no longer existed. The hook fails open by design — it must never break your agent — so nothing visibly broke: capture just stopped, silently, while the project still looked configured.

Hook configuration is now machine-local and self-converging

  • The hook binding lives in .claude/settings.local.json — it is an absolute path to your install's binary, so it never belonged in the team-shared, committed settings.json. Sentience no longer writes the shared file at all; legacy entries there are treated as read-only migration evidence.
  • sentience init claude-code is now a convergence, not a merge: exactly one Sentience hook entry per event for the running install — stale bindings updated, partial historical installs completed, duplicates collapsed, already-current configuration a no-op.
  • Any sentience command repairs an already-configured project. Reinstall the package, run any sentience command in the project, and capture resumes — no separate repair step. This never configures a project with no Sentience configuration, and it never blocks the command you ran.
  • Hand-customised entries are respected: anything Sentience-looking that doesn't exactly match the generated shape is reported, never rewritten. Foreign hooks are never touched.

The governance output itself — events, violations, evaluation — is unchanged, and the hook runtime is byte-identical to 0.3.0.2.

Requires Claude Code v2.1.211 or later

Sentience performs no version detection and cannot determine which Claude Code version will read the configuration it writes; on older versions the integration may silently capture nothing. Earlier versions are out of scope.

Install

pip install --upgrade sentience-governor

Full details: CHANGELOG · user changelog · PR #4

Assets 2
Loading