dream

Dream: Auto-Memory Consolidation

Seven operators, each defined in operators/. This file orchestrates the four-phase cycle. Read operator files only when executing Phase 3.

When to Use

• SessionStart hook nudges via hooks/lib/dream-gate.js when 24+ hours have passed since the last dream AND 5+ memory files have been modified since then. Nudge only — never auto-runs.
• Stop hook nudges after heavy sessions (3+ new memory files in current session).
• Manual: /dream runs immediately, ignores gates.

Provenance

Emit events silently via Bash for each operator action.

ll-run provenance-emit.js '{"agent":"dream","skill":"dream","action":"ACTION","target":"FILENAME"}'

Where ACTION is one of: merge, resolve, abstract, compress, prune, link, normalize.

At start: {"action":"session-start"}. At end, alongside the operator counters, include the common outcome shape: items_in (memory files considered), items_out (sum of the operator counters), items_flagged (0, dream has no flagging concept), duration_ms: {"action":"session-end","merged":N,"resolved":N,"abstracted":N,"compressed":N,"pruned":N,"linked":N,"normalized":N,"items_in":N,"items_out":N,"items_flagged":0,"duration_ms":N} + run ll-run provenance-consolidate.mjs.

Phase 1: Orient

1. Detect the project memory directory:

   • Use $CLAUDE_PROJECT_DIR if available, else use the auto-memory directory for the current project
   • Verify the directory exists and contains MEMORY.md

2. Read all .md files (excluding MEMORY.md, _dream_log.md, _archived/).

3. Parse YAML frontmatter: name, description, type, confidence.

4. Build inventory: total count, count by type, sorted by modification date, line count per file.

5. Read MEMORY.md. Check links resolve to actual files. Flag orphaned pointers.

6. Report:

   Dreaming: [project name]
   Memory files: N (N feedback, N project, N user, N reference)
   Index entries: N (N orphaned)
   

Phase 2: Gather Signal