Repository navigation
v2.0.3
🚀 What's Changed
This release tightens Sober's search, handoff, and hook behavior to make the agent loop more deterministic and recoverable.
🔎 Search Ladder Clarified
- Probe as Structural Search: Updated the policy spine so the default search path is now
ripgrep → Probe → mgrep. - ast-grep Reserved for Rewrites: Removed
ast-grepfrom the default search ladder and clarified its role as the deterministic rewrite/edit tool. - Semantic Search Kept Last: Kept
mgrepas a semantic/concept-query fallback only, not a replacement for exact or structural search.
📝 Project-root HANDOFF.md
- Moved Handoff to Project Root: Session continuity now uses project-root
HANDOFF.mdinstead of.claude/HANDOFF.md. - Runtime-neutral Memory: Updated commands, hooks, and templates so verified findings and next steps live in the project itself rather than in Claude-specific runtime files.
- Removed Stale Runtime File: Deleted the tracked
.claude/HANDOFF.md.
🛡️ Hook Hardening
- Defensive Hook Input Handling: Hardened Sober hooks against empty input, invalid JSON, and missing
jq. - Safer JSON Parsing: Updated hook parsing paths to avoid noisy runtime failures when host CLIs send malformed or incomplete hook payloads.
- More Recoverable Agent Loop: Hook failures now degrade more safely instead of breaking the workflow unexpectedly.
📚 README, Skills & ADR Alignment
- Layered Architecture Docs: Updated README.md and README.ko.md to present Sober's 5 invariants, L0-L6 architecture, and core loop.
- Skill Documentation Updates: Updated
observe,search-ladder, andstructure-graphskills to match the revised policy model. - Search ADR Updated: Updated
docs/adr/003-search-ladder.mdto reflect the new search ladder decision. - Template Alignment: Updated project templates to match the revised spine and project-root handoff model.
🛠️ Full Changelog
- Deleted tracked
.claude/HANDOFF.md. - Updated
.sober/AGENTS.md. - Updated
.sober/commands/analyze-failures.mdand.sober/commands/measure.md. - Updated
.sober/scripts/analyze-failures.sh. - Hardened hook scripts under
.sober/scripts/hooks/. - Hardened Codex tool failure hook under
.sober/scripts/codex-hooks/. - Updated
.sober/skills/README.mdand.sober/skills/README.ko.md. - Updated
.sober/skills/observe/SKILL.md. - Updated
.sober/skills/search-ladder/SKILL.mdand itsreferences/ladder.md. - Updated
.sober/skills/structure-graph/SKILL.md. - Updated README.md and README.ko.md.
- Updated
docs/adr/003-search-ladder.md. - Updated
project-template/AGENTS.md.tmplandproject-template/sgconfig.yml.tmpl. - Bumped package metadata for v2.0.3.