v0.4.0 — Phase 4: Dream safety net
Phase 4: Dream safety net
The first deterministic safety harness around Anthropic's Auto Dream. Snapshot before, diff after, roll back if needed.
Added — six features
- Dream snapshot harness.
cc-janitor dream history|diff|doctor|rollback|prune. Pre/post snapshots stored at~/.cc-janitor/backups/dream/<pair_id>-{pre,post}/, pairs recorded to~/.cc-janitor/dream-snapshots.jsonl. - Watcher
--dreammode.cc-janitor watch start --dreampolls every~/.claude/projects/*/memory/.consolidate-lockand writes a raw mirror around each Auto Dream cycle. cc-janitor dream doctor(10 checks). Stale.consolidate-lock, autoDream flag state, server-gate inference hint, last-dream timestamp, backup dir health + disk usage, MEMORY.md cap, memory file count, cross-file duplicate summary, settings-audit toggle warning.cc-janitor stats sleep-hygiene. Four keyword/regex/dup metrics: MEMORY.md size, relative-date density, cross-file duplicate count, contradicting-feedback pairs.cc-janitor backups tar-compact --kind dream+ new scheduler templatedream-tar-compact. Raw mirrors compacted to.tar.gzafter 7 days, tarballs purged after 30 days (thresholds configurable).- Settings-audit hook. Caches
~/.claude/settings.json:autoDreamEnabledat~/.cc-janitor/state/autodream-last-seen.json. On flip, writes an audit-log entry (cmd=settings-observe,mode=observer) and surfaces a WARN row incc-janitor dream doctor("settings autoDream toggled") asking the user to verify backups before the next Dream cycle.
Plus: 8th TUI tab (Dream) with snapshot list + diff viewer panes, optional ~/.cc-janitor/config.toml for tunable thresholds, i18n [dream] + [sleep_hygiene] tables (en + ru), three new cookbook recipes (#11 diff/rollback, #12 stale-lock diagnosis, #13 scheduled snapshot setup).
Fixed (upstream Claude Code issues)
- Closes #47959 — silent Auto Dream memory deletion
- Closes #50694 — stale
.consolidate-locksilently disables Auto Dream - Closes #38493 — missing
.dream-log.md - Closes #38461 — server-gate inference for Auto Dream flag
Stats
- 267 passing tests (+5 from Phase 3.3's 262)
- 5 new core modules:
dream_snapshot,dream_diff,dream_doctor,sleep_hygiene,settings_observer - 1 new CLI subapp (
dream), 1 new TUI screen, 1 new scheduler template - Zero new mandatory dependencies, zero Phase 1/2/3 regressions
Install
pipx install --force cc-janitor==0.4.0
# or
uv tool install cc-janitor==0.4.0
cc-janitor --version # → 0.4.0
cc-janitor dream doctor🤖 Generated with Claude Code