dreamcontext 0.8.7 → 0.9.0

package/dist/skill-packs/council/SKILL.md

@@ -119,8 +119,9 @@ the user. Ask:
 
 - **y** → `dreamcontext council promote <debate_id>` (writes
   `_dream_context/knowledge/decision-<slug>.md`)
-- **n / later** → leave as-is. The rem-sleep agent will pick it up during the next
-  consolidation cycle and decide based on your engagement signals.
+- **n / later** → leave as-is. The next sleep consolidation will pick it up (the
+  main agent runs `dreamcontext council list --unpromoted` during the sleep flow)
+  and decide based on your engagement signals.
 
 ## Hard rules
 

package/dist/skill-packs/council/debate-protocol.md

@@ -23,7 +23,7 @@ and idempotency notes.
 | `council synthesize <id>` | Prepare synthesis | Prints manifest. Status → `synthesizing`. |
 | `council complete <id>` | Finalize | Requires `final-report.md` to exist. |
 | `council promote <id>` | Copy to knowledge/ | Trims to Verdict + Why + Minority views + Open risks. Skips What-was-debated + Appendix. |
-| `council list [--unpromoted\|--all]` | Triage | `--unpromoted` used by rem-sleep agent. |
+| `council list [--unpromoted\|--all]` | Triage | `--unpromoted` used during the sleep consolidation (council-promote check). |
 | `council show <id>` | Inspection | Prints debate metadata + round-log. |
 
 ### Sub-agent commands

package/dist/skill-packs/excalidraw/SKILL.md

@@ -205,9 +205,13 @@ See `reference/format.md` for the exact `.excalidraw.md` anatomy reverse-enginee
 
 ## Boards as first-class knowledge in dreamcontext
 
-When the project uses dreamcontext, Excalidraw boards belong in `_dream_context/knowledge/diagrams/`.
-They are indexed and recalled just like any knowledge file — but memory extracts ONLY the
-`## Text Elements` section (never the scene JSON).
+When the project uses dreamcontext, an Excalidraw board belongs **inside the context folder it
+documents** — co-located with that context's knowledge, e.g.
+`_dream_context/knowledge/<context>/<title>/<title>.excalidraw.md`. Diagrams are NOT a segregated
+top-level dump; they live with the context they illustrate (`knowledge/**/*.md` is indexed
+recursively, so a board in a context subfolder is fully recalled). Boards are indexed and recalled
+like any knowledge file — but memory extracts ONLY the `## Text Elements` section (never the scene
+JSON).
 
 ### Required frontmatter
 
@@ -225,26 +229,29 @@ excalidraw-plugin: parsed
 
 ### Folder convention (preferred)
 
+A board lives in its own `<title>/` wrapper folder, INSIDE the context it documents:
+
 ```
-_dream_context/knowledge/diagrams/
-├── my-board/
-│   ├── my-board.excalidraw.md   ← generated board (do NOT hand-edit scene JSON)
-│   ├── my-board.board.cjs       ← generator (dark sibling — excluded from index/recall)
-│   └── my-board.json            ← spec / source of truth (dark sibling — excluded)
-├── competitors/                 ← optional category subfolder (groups many boards)
-│   └── acme/
-│       └── acme.excalidraw.md
-└── legacy-flat.excalidraw.md    ← flat layout still works; no forced migration
+_dream_context/knowledge/
+├── recall/                          ← a context folder (its knowledge + its diagram)
+│   ├── recall-engine-v2.md
+│   └── recall/
+│       ├── recall.excalidraw.md     ← generated board (do NOT hand-edit scene JSON)
+│       ├── recall.board.cjs         ← generator (dark sibling — excluded from index/recall)
+│       └── recall.json              ← spec / source of truth (dark sibling — excluded)
+├── system/
+│   └── architecture/
+│       └── architecture.excalidraw.md
+└── diagrams/                        ← LEGACY top-level tree still works (apply-diagrams maintains it)
+    └── legacy-flat.excalidraw.md
 ```
 
-**Category subfolders** are optional and free-form: `diagrams/<category>/<title>/<title>.excalidraw.md`.
-The dashboard Knowledge view renders the whole `diagrams/` subtree as a nested, collapsible folder
-tree (each board shows a sketch icon), so a large diagram set stays navigable instead of collapsing
-into one flat list. A board's own `<title>/` folder is always its innermost folder. Note: a
-`.board.cjs` that `require()`s shared helpers by relative path must use a depth that matches its
-actual location.
+Nesting is free-form, any depth — the dashboard Knowledge view renders the whole `knowledge/` tree
+as a nested, collapsible folder tree (each board shows a sketch icon), so a large diagram set stays
+navigable. A board's own `<title>/` folder is always its innermost folder. Note: a `.board.cjs`
+that `require()`s shared helpers by relative path must use a depth that matches its actual location.
 
-**Dark siblings**: tooling files inside a `diagrams/<title>/` folder are automatically excluded
+**Dark siblings**: tooling files inside a board's `<title>/` folder are automatically excluded
 from the index, recall corpus, snapshot, and dashboard list — generator scripts (`.board.cjs`),
 spec JSON, and frontmatter-less helper `.md` notes. They are tooling — they do not pollute memory.
 
@@ -254,8 +261,9 @@ detailed write-up — e.g. `acme/acme.excalidraw.md` next to `acme/acme.teardown
 teardown recall normally. Only frontmatter-less notes stay dark, so good organization no longer
 costs you recall.
 
-**Flat layout** (`diagrams/<title>.excalidraw.md`) works without any migration. Use the
-per-title folder when you want to keep the board + generator + spec together cleanly.
+**Flat legacy layout** (`diagrams/<title>.excalidraw.md`) still works without migration, but new
+boards belong in their context folder (above); use a per-title `<title>/` folder to keep the
+board + generator + spec together cleanly.
 
 ### Memory contract
 
@@ -270,18 +278,20 @@ per-title folder when you want to keep the board + generator + spec together cle
 
 | Board nature | Location | Indexed? |
 |---|---|---|
-| Canonical / source-of-truth (architecture, system flows, roadmaps, durable plans the agent should recall in future sessions) | `_dream_context/knowledge/diagrams/<title>/` | Yes — indexed, recalled |
+| Canonical / source-of-truth (architecture, system flows, roadmaps, durable plans the agent should recall in future sessions) | inside its `knowledge/<context>/<title>/` folder | Yes — indexed, recalled |
 | Temporary / scratch / exploratory / in-progress | `inbox/` or `workspace/` (dark by location) | No — not indexed, will not pollute recall |
 
-**Decision rule**: "Will a future session need to know this? → `knowledge/diagrams/`. Throwaway/working? → `inbox/` or `workspace/`."
+**Decision rule**: "Will a future session need to know this? → its context folder under `knowledge/`. Throwaway/working? → `inbox/` or `workspace/`."
 
-Promote a board from inbox/workspace to `knowledge/diagrams/` only once it becomes canonical.
+Promote a board from inbox/workspace into its context folder only once it becomes canonical.
 
-### Migration
+### Legacy `knowledge/diagrams/` + migration
 
-Flat boards in `knowledge/diagrams/` do NOT auto-migrate.
+Older projects kept all boards under a single top-level `knowledge/diagrams/` tree. That still
+indexes and renders, and `sleep-product` keeps the store organized over time — but new boards
+should go in their **context folder** (above), not the segregated dump.
 
-- `dreamcontext migrations pending` — see pending migration task instructions (including 0.7.2 diagrams-folder-convention).
-- `dreamcontext migrations apply-diagrams` — opt-in: moves flat `knowledge/diagrams/*.excalidraw.md` boards into per-title folders AND rewrites all inbound [[wikilinks]] atomically. Safe to re-run. Do NOT hand-edit wikilinks manually.
+- `dreamcontext migrations pending` — see pending migration task instructions (incl. 0.7.2 diagrams-folder-convention).
+- `dreamcontext migrations apply-diagrams` — structural/legacy: folds flat `knowledge/diagrams/*.excalidraw.md` boards into per-title folders AND rewrites inbound [[wikilinks]] atomically. Safe to re-run. Do NOT hand-edit wikilinks manually.
 
 Only organize boards you confirm are canonical knowledge. Temp/scratch boards stay in inbox/workspace.

package/dist/templates/AGENTS.md

@@ -77,7 +77,7 @@ All pass → confirm briefly, execute. No ceremony.
 | `dreamcontext-explore` | All codebase exploration | Context-accelerated search using pre-loaded knowledge |
 | `sleep-tasks` / `sleep-state` | Sleep debt prompt fires, or after major work | Always-fire specialists during sleep fan-out — own task files / (core identity + changelog + releases) respectively |
 | `sleep-product` | Conditionally during sleep fan-out (research/decision/feature signals) | Knowledge files + feature PRDs |
-| `dreamcontext-initializer` | Project lacks `_dream_context/` | Bootstraps the structure |
+| `initializer` skill | Project lacks `_dream_context/` or it's sparse | Interactive, sub-agent-driven bootstrap — OFFER to ingest the user's material (docs/wiki/export) into the knowledge/feature/task hierarchy; don't silently scaffold. Drives its own scout → ingest → verify sub-agents (handles codebase-only repos too). |
 | `Reviewer` | Code is written and ready for PR | Flags Critical/Major only. Never mid-implementation. |
 </sub_agents>
 

package/dist/templates/CLAUDE.md

@@ -77,7 +77,7 @@ All pass → confirm briefly, execute. No ceremony.
 | `dreamcontext-explore` | All codebase exploration | Context-accelerated search using pre-loaded knowledge |
 | `sleep-tasks` / `sleep-state` | Sleep debt prompt fires, or after major work | Always-fire specialists during sleep fan-out — own task files / (core identity + changelog + releases) respectively |
 | `sleep-product` | Conditionally during sleep fan-out (research/decision/feature signals) | Knowledge files + feature PRDs |
-| `dreamcontext-initializer` | Project lacks `_dream_context/` | Bootstraps the structure |
+| `initializer` skill | Project lacks `_dream_context/` or it's sparse | Interactive, sub-agent-driven bootstrap — OFFER to ingest the user's material (docs/wiki/export) into the knowledge/feature/task hierarchy; don't silently scaffold. Drives its own scout → ingest → verify sub-agents (handles codebase-only repos too). |
 | `Reviewer` | Code is written and ready for PR | Flags Critical/Major only. Never mid-implementation. |
 </sub_agents>
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dreamcontext",
-  "version": "0.8.7",
+  "version": "0.9.0",
   "description": "dreamcontext — the persistent brain for your AI agents. Remembers what you built, knows how your project works.",
   "type": "module",
   "bin": {
@@ -9,6 +9,8 @@
   "files": [
     "dist",
     "skill",
+    "skill-initializer",
+    "skill-curator",
     "skill-packs",
     "agents",
     "README.md",