Skip to content

v0.4.0 — Phase 4: Dream safety net

Choose a tag to compare

@CreatmanCEO CreatmanCEO released this 11 May 14:49
· 8 commits to main since this release
583603b

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 --dream mode. cc-janitor watch start --dream polls every ~/.claude/projects/*/memory/.consolidate-lock and 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 template dream-tar-compact. Raw mirrors compacted to .tar.gz after 7 days, tarballs purged after 30 days (thresholds configurable).
  • Settings-audit hook. Caches ~/.claude/settings.json:autoDreamEnabled at ~/.cc-janitor/state/autodream-last-seen.json. On flip, writes an audit-log entry (cmd=settings-observe, mode=observer) and surfaces a WARN row in cc-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-lock silently 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