dreamcontext 0.13.1 → 0.14.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dreamcontext",
-  "version": "0.13.1",
+  "version": "0.14.1",
   "description": "dreamcontext — the persistent brain for your AI agents. Remembers what you built, knows how your project works.",
   "type": "module",
   "bin": {
@@ -66,6 +66,7 @@
     "vitest": "^3.0.6"
   },
   "optionalDependencies": {
-    "node-pty": "^1.1.0"
+    "node-pty": "^1.1.0",
+    "@huggingface/transformers": "^4.2.0"
   }
 }

package/skill/SKILL.md

@@ -332,7 +332,7 @@ Status: `todo → in_progress → in_review → completed`. Sections: `why`, `us
 ## Memory & Knowledge — essentials
 
 - **Quick updates (no sleep):** edit `0.soul.md`/`1.user.md`/`2.memory.md` directly; `dreamcontext core changelog add` for code changes; `dreamcontext tasks log` for progress.
-- **Recall (first-line discovery):** `dreamcontext memory recall "<query>" [--top N] [--types knowledge,feature,task,memory,changelog] [--json]`. Default mode is **`haiku`** (a small cloud model picks relevant docs); `raw` = BM25 only; `off` = disabled. Control with `dreamcontext recall on|raw|off|status`. Auto-injected on prompts (opt out `DREAMCONTEXT_MEMORY_HOOK=0`).
+- **Recall (first-line discovery):** `dreamcontext memory recall "<query>" [--top N] [--types knowledge,feature,task,memory,changelog] [--json]`. Default mode is **`haiku`** (a small cloud model picks relevant docs); `raw` = BM25 only; `hybrid` = experimental BM25+local-embedding fusion (no LLM call); `off` = disabled. Control with `dreamcontext recall on|raw|hybrid|off|status`. Auto-injected on prompts (opt out `DREAMCONTEXT_MEMORY_HOOK=0`).
 - **Quick capture:** `dreamcontext memory remember "<text>"` writes a `type=note` CHANGELOG entry; sleep reconciles it later. (`2.memory.md` no longer has a LIFO ship-narrative section — ship events live in CHANGELOG.)
 - **Knowledge files:** index auto-loaded; create with `dreamcontext knowledge create <name>`; pin frequently-needed ones (`pinned: true`); read non-pinned on demand and `knowledge touch` after. Group a flat file into a context folder with `dreamcontext knowledge move <slug> <folder>` (atomic move + inbound `[[wikilink]]` rewrite — never `mv` + hand-edit links).
 - **Features are sleep-only** (see rule 9).

package/skill/references/cli-reference.md

@@ -145,7 +145,9 @@ Sections for `features insert`: `changelog`, `notes`, `technical_details`, `cons
 | `memory delete <slug>` | Delete a knowledge file (irreversible; recover via git). `-f/--force`. |
 | `memory list` | List the corpus by type. `--types <csv>`, `--plain`. |
 | `memory status` | Corpus size + breakdown by type. |
-| `recall status\|on\|off\|raw` | Control recall mode: `on`=haiku (default, LLM picks docs), `raw`=BM25 only, `off`=disabled. |
+| `recall status\|on\|off\|raw\|hybrid` | Control recall mode: `on`=haiku (default, LLM picks docs), `raw`=BM25 only, `hybrid`=experimental BM25+local-embedding fusion (no LLM), `off`=disabled. |
+| `embed refresh` | Bring the hybrid-recall embedding index up to date (embeds only changed chunks). `--force` re-chunks everything; `--if-present` no-ops unless a cache already exists (cron/sleep-safe). |
+| `embed status` | Embedding cache presence, model, vector count, size. |
 
 ---
 
@@ -218,6 +220,7 @@ Sync the WHOLE brain (`_dream_context/`) — tasks, knowledge, features, sleep s
 | `brain discover` | List `dreamcontext-brain`-topic repos you can access on GitHub. |
 | `brain sync` | Fetch → semantic-merge-on-conflict → commit → push (or, in `in-tree` mode, commit-only — never auto-pushes). `--pull-only` (take team content in, never push), `--push-only`, `--strict` (WARN scrub hits block too), `--resume` / `--continue` (the attended `/dream-sync` handoff — see below). |
 | `brain enable` / `brain disable` | Explicit master switch for cloud sync on this project (v3.3). |
+| `brain platform` | Carry the Claude Code layer (CLAUDE.md + `.claude/`) INSIDE the brain repo: moves them into `_dream_context/platform/` and symlinks them back from the project root, so they sync with the team. Missing root symlinks are re-created automatically by every `brain sync` (fresh clones self-wire) and flagged by `doctor`. `--status` reports without changing anything. Machine-local files (`platform/.claude/settings.local.json`, `scheduled_tasks.lock`) never sync. |
 | `brain scrub` | Dry-run the secrets/absolute-path scrub gate against the current staged tree. |
 
 **Automatic sync:** every `dreamcontext sleep done` runs a brain sync (fetch/merge/commit/push); failure never fails sleep. Session-start does a non-blocking background pull. **On an agent-class merge conflict** (two people edited the same prose section) the CLI stops at `already-awaiting-agent` and defers to the **`/dream-sync` skill** — the agent half that reads base/ours/theirs and writes the semantic merge, then `brain sync --continue`. Never drive `--resume`/`--continue` unattended.
@@ -251,7 +254,7 @@ Sync the WHOLE brain (`_dream_context/`) — tasks, knowledge, features, sleep s
 | Var | Effect |
 |---|---|
 | `DREAMCONTEXT_MEMORY_HOOK=0` | Disable auto-injected recall on prompts. |
-| `DREAMCONTEXT_RECALL_MODE=haiku\|raw\|off` | Override recall mode for the session (else uses `recall` setting; default `haiku`). |
+| `DREAMCONTEXT_RECALL_MODE=haiku\|raw\|hybrid\|off` | Override recall mode for the session (else uses `recall` setting; default `haiku`). |
 | `DREAMCONTEXT_AUTO_DASHBOARD=0` | Don't auto-open the dashboard on session start. |
 | `DREAMCONTEXT_DASHBOARD_PORT` | Default dashboard port (else 4173). |
 | `DREAMCONTEXT_AUTO_UPGRADE=0` | Disable automatic CLI self-upgrade. |

package/skill/references/integrations.md

@@ -244,6 +244,17 @@ dreamcontext brain status             # mode (separate/in-tree), remote, sync st
 - **Manual sync any time:** `dreamcontext brain sync` (or `--pull-only` to just take team content in).
 - **On a prose merge conflict** (two people edited the same `##` section of a knowledge/feature doc), the CLI resolves every deterministic file itself and stops at `already-awaiting-agent`, deferring the rest to the **`/dream-sync` skill** — the agent reads base/ours/theirs snapshots, writes the real semantic merge, and hands back with `brain sync --continue`. (`--resume`/`--continue` are attended-only; never drive them unattended.)
 
+### Platform layer — share CLAUDE.md + .claude with the team
+
+A separate-mode brain repo is rooted at `_dream_context/`, so the Claude Code files at the
+project root (CLAUDE.md, `.claude/` skills/agents/hooks) would never sync on their own.
+`dreamcontext brain platform` fixes that: it moves them into `_dream_context/platform/` and
+symlinks them back from the project root (Claude Code resolves the links transparently).
+From then on they sync with the brain like everything else; every `brain sync` re-creates
+missing root symlinks on a fresh clone, and `doctor` flags broken links. Machine-local files
+(`platform/.claude/settings.local.json`, `scheduled_tasks.lock`) stay gitignored.
+`brain platform --status` reports without changing anything.
+
 ### Editing / reconfiguring
 
 - **Turn cloud sync on/off:** `dreamcontext brain enable` / `brain disable`.

package/skill/references/knowledge-and-recall.md

@@ -55,7 +55,7 @@ The `memory` command group is your interface to the curated corpus: `knowledge/*
 | **delete** | Remove a knowledge file (irreversible; recover via git) | `dreamcontext memory delete <slug> -f` |
 | **list** | Enumerate the corpus by type | `dreamcontext memory list [--types …]` |
 | **status** | See corpus size + breakdown by type | `dreamcontext memory status` |
-| **recall mode** | Switch how recall ranks (haiku/raw/off) | `dreamcontext recall on\|raw\|off\|status` |
+| **recall mode** | Switch how recall ranks (haiku/raw/hybrid/off) | `dreamcontext recall on\|raw\|hybrid\|off\|status` |
 
 ### recall — your first-line discovery tool
 
@@ -96,6 +96,7 @@ Writes a CHANGELOG entry (`type=note`, `scope=quick`); the sleep cycle reconcile
 |---|---|---|
 | `haiku` (**default**) | A small cloud model picks 0–3 relevant docs per prompt (smarter than keywords; BM25 fallback) | `dreamcontext recall on` |
 | `raw` | BM25 keyword scoring only — no LLM call | `dreamcontext recall raw` |
+| `hybrid` (**experimental**) | BM25 + local dense embeddings fused (multilingual, no LLM call; falls back to BM25 if the model is unavailable) | `dreamcontext recall hybrid` |
 | `off` | No recall injection at all | `dreamcontext recall off` |
 | — | Inspect current mode | `dreamcontext recall status` |
 

package/skill-sync/references/merge-rules.md

@@ -30,11 +30,25 @@ returns `action:'disabled'`.
 | `overrides/**` | tracked | tracked |
 | `state/*.md` (tasks) | tracked (source of truth) | gitignored (local mirror; issues/ClickUp are source of truth) |
 | `state/.config.json`, `.active-version.json`, `.migrations.json` | tracked | tracked |
-| `state/.secrets.json`, `.sleep.json`, `.sleep-history.json`, `.agent-sessions.json`, `.session-digests/`, `.conflicts/`, `.brain-merge/`, `.version-check.json`, `.auto-upgrade.json`, `.brain-local.json`, `.tasks-map.json`, `.tasks-sync.*`, `.tasks-queue.json`, `.obsidian/`, `tmp/`, `**/.env` | gitignored | gitignored |
+| `state/.secrets.json`, `.sleep.json`, `.sleep-history.json`, `.agent-sessions.json`, `.session-digests/`, `.conflicts/`, `.brain-merge/`, `.version-check.json`, `.auto-upgrade.json`, `.brain-local.json`, `.lab-prefs.json`, `.tasks-map.json`, `.tasks-sync.*`, `.tasks-queue.json`, `.obsidian/`, `tmp/`, `**/.env`, `**/.DS_Store` | gitignored | gitignored |
+| `lab/**` (insights + cache) | tracked | tracked |
+| `lab/credentials.json` / `lab/credentials.*` (except the tracked `credentials.example.json`) | gitignored | gitignored |
+| `platform/**` (Claude Code layer: CLAUDE.md + .claude) | tracked | tracked |
+| `platform/.claude/settings.local.json`, `platform/.claude/scheduled_tasks.lock` | gitignored | gitignored |
 
 Built by `buildBrainGitignore(taskBackend)` (`src/lib/git-sync/brain-repo.ts`) and written on
 bootstrap (`brain init`/`attach`); `ensureLocalOnlyArtifacts` re-asserts it after a clone/pull.
 
+## 3b. Platform layer — CLAUDE.md + .claude travel with the brain
+
+A separate-mode brain repo is rooted at `_dream_context/`, so the Claude Code project files at
+the PROJECT root would never sync. `dreamcontext brain platform` migrates them: the real files
+move to `_dream_context/platform/{CLAUDE.md,.claude}` and the project root keeps relative
+symlinks into it (Claude Code resolves them transparently). On every `runBrainSync` the engine
+best-effort re-creates missing root symlinks (`healPlatformLinks`), so a fresh clone of the brain
+is fully wired after its first sync; `doctor` flags missing links and root-vs-platform conflicts.
+Machine-local runtime files inside `platform/.claude/` (see table) never sync.
+
 ## 4. Credential supply (GIT_ASKPASS — decision F)
 
 The token is NEVER embedded in a remote URL, env, or argv. Every networked git call runs inside

package/dist/dashboard/assets/channel-BxXtm6aL.js

@@ -1 +0,0 @@
-import{aq as o,ar as n}from"./index-CchlcoQO.js";const t=(r,a)=>o.lang.round(n.parse(r)[a]);export{t as c};

package/dist/dashboard/assets/classDiagram-6PBFFD2Q-DRDRixtt.js

@@ -1 +0,0 @@
-import{s as a,c as s,a as e,C as t}from"./chunk-4TB4RGXK-BQOhV1JT.js";import{_ as i}from"./index-CchlcoQO.js";import"./chunk-FMBD7UC4-BowamHD9.js";import"./chunk-YZCP3GAM-UDOQPnhm.js";import"./chunk-55IACEB6-DhAIH--W.js";import"./chunk-EDXVE4YY-Chs7mD-k.js";var u={parser:e,get db(){return new t},renderer:s,styles:a,init:i(r=>{r.class||(r.class={}),r.class.arrowMarkerAbsolute=r.arrowMarkerAbsolute},"init")};export{u as diagram};

package/dist/dashboard/assets/classDiagram-v2-HSJHXN6E-DRDRixtt.js

@@ -1 +0,0 @@
-import{s as a,c as s,a as e,C as t}from"./chunk-4TB4RGXK-BQOhV1JT.js";import{_ as i}from"./index-CchlcoQO.js";import"./chunk-FMBD7UC4-BowamHD9.js";import"./chunk-YZCP3GAM-UDOQPnhm.js";import"./chunk-55IACEB6-DhAIH--W.js";import"./chunk-EDXVE4YY-Chs7mD-k.js";var u={parser:e,get db(){return new t},renderer:s,styles:a,init:i(r=>{r.class||(r.class={}),r.class.arrowMarkerAbsolute=r.arrowMarkerAbsolute},"init")};export{u as diagram};

package/dist/dashboard/assets/clone-DDdzwqUk.js

@@ -1 +0,0 @@
-import{b as r}from"./graph-BJt4v-K6.js";var e=4;function a(o){return r(o,e)}export{a as c};