dream

Maintenance pass for a markdown KB. Show a diff of every proposed change and apply nothing until the user approves, unless run with --auto. If the KB ships DREAM.md or AGENTS.md, read it first and follow its note format, tags, and sync steps.

• dream [<path>]: path, else $KB_DIR, else ask.
• dream --auto [<path>]: no prompts. Apply merges and prunes, skip contradictions.
• dream forget "<query>" [<path>]: propose deleting matching notes. Pinned notes need per-note confirmation.

A note is *.md with YAML frontmatter: name (equals filename stem), description, type, tags, created, updated, optional sources, pinned, confidence (0 to 1). Filenames are <type>-<slug>.md. No nested metadata: blocks.

The pass: