@cortexkit/opencode-magic-context 0.21.8 → 0.22.0

package/dist/agents/permissions.d.ts

@@ -40,16 +40,17 @@
  * # What each agent needs
  *
  *   - **historian / historian-editor / compressor**: `read` plus the
- *     read-only AFT navigation tools `aft_outline` and `aft_zoom`.
- *     The runner offloads large existing-state XML to a temp file
- *     under `<project>/.opencode/magic-context/historian/` and the
- *     prompt instructs the model to read that file. AFT navigation
- *     is allowed so historian can verify a symbol or file structure
- *     when writing accurate compartment summaries.
- *
- *   - **dreamer**: `read`, `grep`, `glob`, `bash`, the read-only AFT
- *     navigation tools `aft_outline` and `aft_zoom`, plus the Magic
- *     Context MCP tools `ctx_memory`, `ctx_search`, `ctx_note`.
+ *     read-only AFT navigation/search tools `aft_outline`, `aft_zoom`,
+ *     and `aft_search`. The runner offloads large existing-state XML to
+ *     a temp file under `<project>/.opencode/magic-context/historian/`
+ *     and the prompt instructs the model to read that file. AFT
+ *     navigation is allowed so historian can find or verify a symbol or
+ *     file structure when writing accurate compartment summaries.
+ *
+ *   - **dreamer**: `read`, `grep`, `glob`, `bash`, `write`, `edit`, the
+ *     read-only AFT navigation/search tools `aft_outline`, `aft_zoom`,
+ *     `aft_search`, plus the Magic Context MCP tools `ctx_memory`,
+ *     `ctx_search`, `ctx_note`.
  *     Dreamer task prompts in
  *     `features/magic-context/dreamer/task-prompts.ts` explicitly tell
  *     the model to grep schema files for defaults, read source to
@@ -95,7 +96,7 @@ export declare function buildAllowOnlyPermission(allowedTools: readonly string[]
  * websearch. Historian's job is summarizing the input it was given,
  * not exploring the repo.
  */
-export declare const HISTORIAN_ALLOWED_TOOLS: readonly ["read", "aft_outline", "aft_zoom"];
+export declare const HISTORIAN_ALLOWED_TOOLS: readonly ["read", "aft_outline", "aft_zoom", "aft_search"];
 /**
  * Tools the dreamer agent needs. This is the broadest hidden-agent
  * surface because dreamer's tasks legitimately require local-repo
@@ -116,15 +117,29 @@ export declare const HISTORIAN_ALLOWED_TOOLS: readonly ["read", "aft_outline", "
  *     consolidate / verify / improve / archive-stale / smart-notes
  *     dreamer child sessions, so removing it would regress real,
  *     documented dreamer behavior.
+ *   - `write` / `edit` — the maintain-docs task (`task-prompts.ts`)
+ *     explicitly instructs the model to "Write or update using the
+ *     Write tool" to keep `ARCHITECTURE.md` / `STRUCTURE.md` at the
+ *     project root synchronized. Without these tools the dreamer was
+ *     forced to emit docs through `bash` heredocs/`sed` — fragile and
+ *     hard to review. Granting `write` + `edit` lets it use the proper
+ *     file tools (which back up + validate) instead.
+ *   - `aft_search` — primary read-only code search for the verify /
+ *     improve / maintain-docs tasks; finds the symbols and call sites a
+ *     doc/memory rewrite must describe, more precisely than raw `grep`.
  *
  * Deliberately NOT allowed:
  *   - `task` — no subagent fanout from dreamer
- *   - `edit` / `write` — dreamer must not modify project files;
- *     `task-prompts.ts` explicitly states "Do not commit changes"
  *   - `webfetch` / `websearch` — out of scope; smart-note URL fetches
  *     go through `bash` + `curl` instead
+ *
+ * Note: `write` / `edit` grant general file-write capability (the
+ * permission gate is tool-level, not path-level). Dreamer is a trusted
+ * hidden agent whose prompts scope writes to docs + memory; the
+ * task-prompts still say "Do not commit changes," so it edits the
+ * working tree but never commits.
  */
-export declare const DREAMER_ALLOWED_TOOLS: readonly ["read", "grep", "glob", "bash", "aft_outline", "aft_zoom", "ctx_memory", "ctx_search", "ctx_note"];
+export declare const DREAMER_ALLOWED_TOOLS: readonly ["read", "grep", "glob", "bash", "write", "edit", "aft_outline", "aft_zoom", "aft_search", "ctx_memory", "ctx_search", "ctx_note"];
 /**
  * Tools the sidekick agent needs. Sidekick is a read-only memory
  * retriever for `/ctx-aug` — it queries the project's memory store

package/dist/agents/permissions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../src/agents/permissions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoEG;AAEH;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CACpC,YAAY,EAAE,SAAS,MAAM,EAAE,GAChC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAMlC;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,uBAAuB,8CAA+C,CAAC;AAEpF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,qBAAqB,8GAUxB,CAAC;AAEX;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,sBAAsB,kEAKzB,CAAC"}
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../src/agents/permissions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqEG;AAEH;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CACpC,YAAY,EAAE,SAAS,MAAM,EAAE,GAChC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAMlC;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,uBAAuB,4DAA6D,CAAC;AAElG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,eAAO,MAAM,qBAAqB,6IAaxB,CAAC;AAEX;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,sBAAsB,kEAKzB,CAAC"}

package/dist/config/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,kBAAkB,EAA4B,MAAM,wBAAwB,CAAC;AAG3F,MAAM,WAAW,wBAAyB,SAAQ,kBAAkB;IAChE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CACZ,MAAM,EACN;QACI,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,OAAO,CAAC;KACrB,CACJ,CAAC;CACL;AAmBD,MAAM,MAAM,WAAW,GACjB,IAAI,GACJ,0BAA0B,GAC1B,uBAAuB,GACvB,iBAAiB,GACjB,sBAAsB,CAAC;AAE7B,MAAM,WAAW,kBAAkB;IAC/B,MAAM,EAAE,wBAAwB,GAAG;QAAE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACjE,WAAW,EAAE,WAAW,CAAC;IACzB,OAAO,EAAE;QACL,UAAU,EAAE,WAAW,CAAC;QACxB,aAAa,EAAE,WAAW,CAAC;KAC9B,CAAC;IACF,oBAAoB,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9F,qBAAqB,EAAE,MAAM,EAAE,CAAC;CACnC;AAmWD,wBAAgB,gBAAgB,CAC5B,SAAS,EAAE,MAAM,GAClB,wBAAwB,GAAG;IAAE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CA2E1D;AAgDD,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,kBAAkB,CAuE9E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,kBAAkB,EAA4B,MAAM,wBAAwB,CAAC;AAG3F,MAAM,WAAW,wBAAyB,SAAQ,kBAAkB;IAChE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CACZ,MAAM,EACN;QACI,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,OAAO,CAAC;KACrB,CACJ,CAAC;CACL;AAmBD,MAAM,MAAM,WAAW,GACjB,IAAI,GACJ,0BAA0B,GAC1B,uBAAuB,GACvB,iBAAiB,GACjB,sBAAsB,CAAC;AAE7B,MAAM,WAAW,kBAAkB;IAC/B,MAAM,EAAE,wBAAwB,GAAG;QAAE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACjE,WAAW,EAAE,WAAW,CAAC;IACzB,OAAO,EAAE;QACL,UAAU,EAAE,WAAW,CAAC;QACxB,aAAa,EAAE,WAAW,CAAC;KAC9B,CAAC;IACF,oBAAoB,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9F,qBAAqB,EAAE,MAAM,EAAE,CAAC;CACnC;AAyPD,wBAAgB,gBAAgB,CAC5B,SAAS,EAAE,MAAM,GAClB,wBAAwB,GAAG;IAAE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CA2E1D;AAgDD,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,kBAAkB,CAuE9E"}

package/dist/config/migrate-experimental.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Startup-time shim for graduated experimental features (shared OpenCode + Pi).
+ *
+ * Features have graduated out of the `experimental.*` namespace across releases:
+ *  - v0.14: `experimental.user_memories` / `experimental.pin_key_files` →
+ *    `dreamer.user_memories` / `dreamer.pin_key_files`.
+ *  - this release: `experimental.temporal_awareness` / `caveman_text_compression`
+ *    → top-level keys; `experimental.auto_search` / `git_commit_indexing` →
+ *    `memory.auto_search` / `memory.git_commit_indexing`.
+ *
+ * Doctor runs an on-disk migration, but users who never run doctor would
+ * otherwise lose their opt-in/opt-out because the graduated keys are no longer
+ * in the schema — Zod silently strips unknown keys. This shim runs in-memory on
+ * every load: if the user has legacy `experimental.<graduated-key>` blocks, it
+ * reshapes the raw config so the new schema sees them at their graduated path.
+ * The on-disk file stays untouched (doctor is the tool that cleans it up), and
+ * the user's explicit intent is preserved for this session's runtime behavior.
+ *
+ * Primitive values (e.g., `experimental.user_memories: true`) are coerced to
+ * `{ enabled: <bool> }` object form so Zod accepts them. Without this coercion,
+ * the primitive would fail schema validation and fall back to the graduated
+ * default — silently flipping a user's explicit `false` to the new `true`
+ * default, or vice versa.
+ *
+ * Idempotent: if the destination path already has a value, the destination wins
+ * (the user has started graduating), merging sub-fields so nothing is lost.
+ */
+export declare function migrateLegacyExperimental(rawConfig: Record<string, unknown>, warnings: string[]): Record<string, unknown>;
+//# sourceMappingURL=migrate-experimental.d.ts.map

package/dist/config/migrate-experimental.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-experimental.d.ts","sourceRoot":"","sources":["../../src/config/migrate-experimental.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,yBAAyB,CACrC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,QAAQ,EAAE,MAAM,EAAE,GACnB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA8HzB"}

package/dist/config/schema/magic-context.d.ts

@@ -4,20 +4,6 @@ export declare const DEFAULT_EXECUTE_THRESHOLD_PERCENTAGE = 65;
 export declare const DEFAULT_HISTORIAN_TIMEOUT_MS = 300000;
 export declare const DEFAULT_HISTORY_BUDGET_PERCENTAGE = 0.15;
 export declare const DEFAULT_LOCAL_EMBEDDING_MODEL = "Xenova/all-MiniLM-L6-v2";
-/** Compressor defaults — see CompressorConfigSchema below for details. */
-export declare const DEFAULT_COMPRESSOR_MIN_COMPARTMENT_RATIO = 1000;
-export declare const DEFAULT_COMPRESSOR_MAX_MERGE_DEPTH = 5;
-export declare const DEFAULT_COMPRESSOR_COOLDOWN_MS = 600000;
-/** Max compartments merged in one LLM pass. LLM quality degrades with larger inputs,
- *  and smaller batches reduce ordinal-drift risk when the model outputs merged boundaries. */
-export declare const DEFAULT_COMPRESSOR_MAX_COMPARTMENTS_PER_PASS = 15;
-/** Number of newest compartments always excluded from compression.
- *  Protects freshly-published historian compartments from immediate re-compression,
- *  which would lose narrative quality before the agent has even used the compartment. */
-export declare const DEFAULT_COMPRESSOR_GRACE_COMPARTMENTS = 10;
-/** Output count at each depth = ceil(input / ratio).
- *  Lower ratios = gentler compression. Depth 5 is title-only (no LLM call). */
-export declare const COMPRESSOR_MERGE_RATIO_BY_DEPTH: Record<number, number>;
 export declare const DREAMER_TASKS: readonly ["consolidate", "verify", "archive-stale", "improve", "maintain-docs"];
 export declare const DreamingTaskSchema: z.ZodEnum<{
     consolidate: "consolidate";
@@ -311,6 +297,11 @@ export interface MagicContextConfig {
         enabled: boolean;
         min_clusters: number;
     };
+    /** Per-connection SQLite tuning for Magic Context's own context.db. */
+    sqlite: {
+        cache_size_mb: number;
+        mmap_size_mb: number;
+    };
     /**
      * Controls whether and where Magic Context augments the system prompt
      * (`## Magic Context` guidance, `<project-docs>`, `<user-profile>`,
@@ -332,32 +323,42 @@ export interface MagicContextConfig {
          */
         skip_signatures: string[];
     };
-    compressor: {
+    /** Inject elapsed-time markers between user messages and date ranges on
+     *  compartments so the agent has a wall-clock sense of the session.
+     *  Graduated from `experimental.temporal_awareness`; default: true. */
+    temporal_awareness: boolean;
+    /**
+     * Age-tier caveman compression for long user/assistant text parts.
+     * Graduated from `experimental.caveman_text_compression`; opt-in, default off.
+     *
+     * Only active when `ctx_reduce_enabled: false`. Buckets eligible
+     * (outside-protected-tail) messages into four age tiers by tag
+     * position — oldest 20% → ultra, next 20% → full, next 20% → lite,
+     * newest 40% → untouched — and rewrites the text part in place.
+     * Always compresses from the original source (source_contents), so
+     * tier shifts produce the same result as if the target depth were
+     * applied directly to the original text.
+     *
+     * Disabled by default because it rewrites agent-visible history.
+     */
+    caveman_text_compression: {
         enabled: boolean;
-        min_compartment_ratio: number;
-        max_merge_depth: number;
-        cooldown_ms: number;
-        max_compartments_per_pass: number;
-        grace_compartments: number;
+        /** Text parts shorter than this (characters) are left untouched. */
+        min_chars: number;
     };
-    experimental: {
-        /** Inject elapsed-time markers between user messages and date ranges on
-         *  compartments so the agent has a wall-clock sense of the session. */
-        temporal_awareness: boolean;
-        /** Index git commit messages from HEAD into a new ctx_search source so
-         *  agents can recall recent regressions, fixes, and decisions from
-         *  commit history without running git log manually. */
-        git_commit_indexing: {
-            enabled: boolean;
-            /** Days of history to index (default: 365) */
-            since_days: number;
-            /** Max commits kept per project; oldest evicted (default: 2000) */
-            max_commits: number;
-        };
+    embedding: EmbeddingConfig;
+    memory: {
+        enabled: boolean;
+        injection_budget_tokens: number;
+        auto_promote: boolean;
+        retrieval_count_promotion_threshold: number;
         /** Appends a compact hint to new user messages when ctx_search finds
-         *  highly-related memories, facts, or git commits. Does NOT inject
-         *  full content — just vague fragments that nudge the agent to run
-         *  ctx_search for full context if relevant. */
+         *  highly-related memories, conversation, or git commits. Does NOT
+         *  inject full content — just vague fragments that nudge the agent to
+         *  run ctx_search for full context if relevant. Graduated from
+         *  `experimental.auto_search`; enabled by default. Independent of
+         *  `memory.enabled` — it can still surface conversation/git hints when
+         *  the memory store is off. */
         auto_search: {
             enabled: boolean;
             /** Top hit score must exceed this threshold for the hint to fire. */
@@ -365,32 +366,19 @@ export interface MagicContextConfig {
             /** Minimum user message length in characters (skip short prompts). */
             min_prompt_chars: number;
         };
-        /**
-         * Age-tier caveman compression for long user/assistant text parts.
-         *
-         * Only active when `ctx_reduce_enabled: false`. Buckets eligible
-         * (outside-protected-tail) messages into four age tiers by tag
-         * position — oldest 20% → ultra, next 20% → full, next 20% → lite,
-         * newest 40% → untouched — and rewrites the text part in place.
-         * Always compresses from the original source (source_contents), so
-         * tier shifts produce the same result as if the target depth were
-         * applied directly to the original text.
-         *
-         * Disabled by default because it rewrites agent-visible history.
-         */
-        caveman_text_compression: {
+        /** Index git commit messages from HEAD into a new ctx_search source so
+         *  agents can recall recent regressions, fixes, and decisions from
+         *  commit history without running git log manually. Graduated from
+         *  `experimental.git_commit_indexing`; opt-in, default off. Independent
+         *  of `memory.enabled`. */
+        git_commit_indexing: {
             enabled: boolean;
-            /** Text parts shorter than this (characters) are left untouched. */
-            min_chars: number;
+            /** Days of history to index (default: 365) */
+            since_days: number;
+            /** Max commits kept per project; oldest evicted (default: 2000) */
+            max_commits: number;
         };
     };
-    embedding: EmbeddingConfig;
-    memory: {
-        enabled: boolean;
-        injection_budget_tokens: number;
-        auto_promote: boolean;
-        retrieval_count_promotion_threshold: number;
-    };
     sidekick?: SidekickConfig;
 }
 export declare const MagicContextConfigSchema: z.ZodPipe<z.ZodObject<{
@@ -559,13 +547,9 @@ export declare const MagicContextConfigSchema: z.ZodPipe<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         skip_signatures: z.ZodDefault<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>>;
-    compressor: z.ZodDefault<z.ZodObject<{
-        enabled: z.ZodDefault<z.ZodBoolean>;
-        min_compartment_ratio: z.ZodDefault<z.ZodNumber>;
-        max_merge_depth: z.ZodDefault<z.ZodNumber>;
-        cooldown_ms: z.ZodDefault<z.ZodNumber>;
-        max_compartments_per_pass: z.ZodDefault<z.ZodNumber>;
-        grace_compartments: z.ZodDefault<z.ZodNumber>;
+    sqlite: z.ZodDefault<z.ZodObject<{
+        cache_size_mb: z.ZodDefault<z.ZodNumber>;
+        mmap_size_mb: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>>;
     embedding: z.ZodDefault<z.ZodPipe<z.ZodObject<{
         provider: z.ZodDefault<z.ZodEnum<{
@@ -593,29 +577,27 @@ export declare const MagicContextConfigSchema: z.ZodPipe<z.ZodObject<{
         endpoint?: string | undefined;
         api_key?: string | undefined;
     }>>>;
-    experimental: z.ZodDefault<z.ZodObject<{
-        temporal_awareness: z.ZodDefault<z.ZodBoolean>;
-        git_commit_indexing: z.ZodDefault<z.ZodObject<{
-            enabled: z.ZodDefault<z.ZodBoolean>;
-            since_days: z.ZodDefault<z.ZodNumber>;
-            max_commits: z.ZodDefault<z.ZodNumber>;
-        }, z.core.$strip>>;
+    temporal_awareness: z.ZodDefault<z.ZodBoolean>;
+    caveman_text_compression: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        min_chars: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    memory: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        injection_budget_tokens: z.ZodDefault<z.ZodNumber>;
+        auto_promote: z.ZodDefault<z.ZodBoolean>;
+        retrieval_count_promotion_threshold: z.ZodDefault<z.ZodNumber>;
         auto_search: z.ZodDefault<z.ZodObject<{
             enabled: z.ZodDefault<z.ZodBoolean>;
             score_threshold: z.ZodDefault<z.ZodNumber>;
             min_prompt_chars: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strip>>;
-        caveman_text_compression: z.ZodDefault<z.ZodObject<{
+        git_commit_indexing: z.ZodDefault<z.ZodObject<{
             enabled: z.ZodDefault<z.ZodBoolean>;
-            min_chars: z.ZodDefault<z.ZodNumber>;
+            since_days: z.ZodDefault<z.ZodNumber>;
+            max_commits: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
-    memory: z.ZodDefault<z.ZodObject<{
-        enabled: z.ZodDefault<z.ZodBoolean>;
-        injection_budget_tokens: z.ZodDefault<z.ZodNumber>;
-        auto_promote: z.ZodDefault<z.ZodBoolean>;
-        retrieval_count_promotion_threshold: z.ZodDefault<z.ZodNumber>;
-    }, z.core.$strip>>;
     sidekick: z.ZodOptional<z.ZodObject<{
         model: z.ZodOptional<z.ZodString>;
         temperature: z.ZodOptional<z.ZodNumber>;
@@ -702,13 +684,9 @@ export declare const MagicContextConfigSchema: z.ZodPipe<z.ZodObject<{
         enabled: boolean;
         skip_signatures: string[];
     };
-    compressor: {
-        enabled: boolean;
-        min_compartment_ratio: number;
-        max_merge_depth: number;
-        cooldown_ms: number;
-        max_compartments_per_pass: number;
-        grace_compartments: number;
+    sqlite: {
+        cache_size_mb: number;
+        mmap_size_mb: number;
     };
     embedding: {
         provider: "local";
@@ -722,29 +700,27 @@ export declare const MagicContextConfigSchema: z.ZodPipe<z.ZodObject<{
         provider: "off";
         model?: undefined;
     };
-    experimental: {
-        temporal_awareness: boolean;
-        git_commit_indexing: {
-            enabled: boolean;
-            since_days: number;
-            max_commits: number;
-        };
+    temporal_awareness: boolean;
+    caveman_text_compression: {
+        enabled: boolean;
+        min_chars: number;
+    };
+    memory: {
+        enabled: boolean;
+        injection_budget_tokens: number;
+        auto_promote: boolean;
+        retrieval_count_promotion_threshold: number;
         auto_search: {
             enabled: boolean;
             score_threshold: number;
             min_prompt_chars: number;
         };
-        caveman_text_compression: {
+        git_commit_indexing: {
             enabled: boolean;
-            min_chars: number;
+            since_days: number;
+            max_commits: number;
         };
     };
-    memory: {
-        enabled: boolean;
-        injection_budget_tokens: number;
-        auto_promote: boolean;
-        retrieval_count_promotion_threshold: number;
-    };
     auto_update?: boolean | undefined;
     historian?: {
         two_pass: boolean;

package/dist/config/schema/magic-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"magic-context.d.ts","sourceRoot":"","sources":["../../../src/config/schema/magic-context.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"magic-context.d.ts","sourceRoot":"","sources":["../../../src/config/schema/magic-context.ts"],"names":[],"mappings":"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"}

package/dist/features/builtin-commands/commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../src/features/builtin-commands/commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEpD,wBAAgB,8BAA8B,IAAI,oBAAoB,CAwBrE"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../src/features/builtin-commands/commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEpD,wBAAgB,8BAA8B,IAAI,oBAAoB,CA6BrE"}

package/dist/features/magic-context/compartment-embedding.d.ts

@@ -0,0 +1,34 @@
+import type { Database } from "../../shared/sqlite";
+/**
+ * Compartment P1 embedding (v2 / E2).
+ *
+ * The LOCKED substrate decision: `p1_embedding` is computed + stored on EVERY
+ * compartment publish, even though the historian no longer uses embedding to
+ * pick its own reference block (that switched to recency). The embedding exists
+ * for two consumers:
+ *   - ctx_search semantic retrieval over compartments (E2 consumption),
+ *   - future dreamer cross-compartment linking (e.g. "key-files 2 months ago
+ *     ↔ key-files now").
+ *
+ * Fire-and-forget + best-effort, mirroring memory promotion: a missing/slow
+ * embedding provider must never block or fail a historian publish. Gated by the
+ * same `memory.enabled` / `auto_promote` flags as memory promotion (no embedding
+ * endpoint hits when memory is off).
+ */
+interface CompartmentToEmbed {
+    id: number;
+    /** P1 tier text (fullest) — the embedding source. */
+    p1: string;
+}
+/**
+ * Embed the P1 text of the given compartments and persist each vector into
+ * `compartments.p1_embedding` (+ `p1_embedding_model_id`). Best-effort per row:
+ * one failure logs and continues. Never throws.
+ *
+ * `embedTextForProject` resolves the project's configured provider/model, so the
+ * stored `model_id` stays consistent with memory embeddings for the same project
+ * (vector compatibility for cross-corpus search later).
+ */
+export declare function embedAndStoreCompartments(db: Database, sessionId: string, projectPath: string, compartments: readonly CompartmentToEmbed[]): Promise<void>;
+export {};
+//# sourceMappingURL=compartment-embedding.d.ts.map

package/dist/features/magic-context/compartment-embedding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compartment-embedding.d.ts","sourceRoot":"","sources":["../../../src/features/magic-context/compartment-embedding.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAGpD;;;;;;;;;;;;;;;GAeG;AAEH,UAAU,kBAAkB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,qDAAqD;IACrD,EAAE,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;GAQG;AACH,wBAAsB,yBAAyB,CAC3C,EAAE,EAAE,QAAQ,EACZ,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,SAAS,kBAAkB,EAAE,GAC5C,OAAO,CAAC,IAAI,CAAC,CAqBf"}

package/dist/features/magic-context/compartment-events.d.ts

@@ -0,0 +1,50 @@
+import type { Database } from "../../shared/sqlite";
+/**
+ * Compartment events storage (v2 / E2).
+ *
+ * The historian extracts discrete events (`causal_incident`,
+ * `trajectory_correction`, and any future kinds) while compartmentalizing. v2.0
+ * STORES these events but does NOT render them — they are a corpus for a future
+ * dreamer aggregation/steering feature (cross-session pattern detection). Parsed
+ * kind-agnostically (`kind` = element name, `fields` = child elements), so a new
+ * event kind or field needs no schema change — `fields` round-trips as JSON.
+ *
+ * Anchoring: `at_compartment="N"` is a 1-based index INTO THE CURRENT PUBLISH's
+ * emitted compartment list. We resolve it to the `compartment_id` of the matching
+ * persisted row at store time. When resolution fails (out-of-range index, e.g. an
+ * event anchored to a discard-last compartment), `compartment_id` is NULL and we
+ * keep the raw `at_compartment` for debugging.
+ *
+ * Durability caveat: `compartment_id` is a bare INTEGER (no FK). It points at the
+ * compartment row that existed at store time. Full/partial recomp deletes and
+ * re-inserts compartment rows, so a stored `compartment_id` can become stale
+ * (dangling) after recomp. This is acceptable for v2.0 because events are
+ * STORED-ONLY (not rendered or consumed yet); the future dreamer aggregation
+ * feature that reads events must re-anchor or tolerate dangling ids. Do NOT rely
+ * on `compartment_id` surviving recomp.
+ */
+export interface CompartmentEventInput {
+    /** Event element name, e.g. "causal_incident" | "trajectory_correction". */
+    kind: string;
+    /** 1-based index into the publish's emitted compartments; null if absent/invalid. */
+    atCompartment: number | null;
+    /** Child elements verbatim (e.g. trigger, implication). */
+    fields: Record<string, string>;
+}
+export interface StoredCompartmentEvent extends CompartmentEventInput {
+    id: number;
+    sessionId: string;
+    compartmentId: number | null;
+    createdAt: number;
+}
+/**
+ * Persist historian-extracted events for a publish.
+ *
+ * @param compartmentIds durable compartment ids for the publish's emitted
+ *   compartments, in emission order (index i → the (i+1)-th emitted compartment).
+ *   Used to resolve `at_compartment` (1-based) to a durable `compartment_id`.
+ */
+export declare function insertCompartmentEvents(db: Database, sessionId: string, events: readonly CompartmentEventInput[], compartmentIds: readonly number[]): void;
+/** Load all stored events for a session (newest first). For diagnostics / future dreamer aggregation. */
+export declare function getCompartmentEvents(db: Database, sessionId: string): StoredCompartmentEvent[];
+//# sourceMappingURL=compartment-events.d.ts.map

package/dist/features/magic-context/compartment-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compartment-events.d.ts","sourceRoot":"","sources":["../../../src/features/magic-context/compartment-events.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,MAAM,WAAW,qBAAqB;IAClC,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,qFAAqF;IACrF,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,sBAAuB,SAAQ,qBAAqB;IACjE,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACnC,EAAE,EAAE,QAAQ,EACZ,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,SAAS,qBAAqB,EAAE,EACxC,cAAc,EAAE,SAAS,MAAM,EAAE,GAClC,IAAI,CAqBN;AAED,yGAAyG;AACzG,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,sBAAsB,EAAE,CAuB9F"}

package/dist/features/magic-context/compartment-storage.d.ts

@@ -8,7 +8,19 @@ export interface Compartment {
     startMessageId: string;
     endMessageId: string;
     title: string;
+    /** v2: P1 tier text (fullest). Legacy rows: flat v1 content. Always present (NOT NULL). */
     content: string;
+    /** v2 paraphrase tiers (model B). NULL for legacy=1 rows. */
+    p1: string | null;
+    p2: string | null;
+    p3: string | null;
+    p4: string | null;
+    /** Decay-rate signal (1-100). Defaults to 50. */
+    importance: number;
+    /** Comma-separated activity types (e.g. "design,feature"). NULL for legacy rows. */
+    episodeType: string | null;
+    /** 1 = pre-v2 flat compartment (no tiers); 0 = v2 tiered. */
+    legacy: number;
     createdAt: number;
 }
 export interface SessionFact {
@@ -26,7 +38,17 @@ export interface CompartmentInput {
     startMessageId: string;
     endMessageId: string;
     title: string;
+    /** v2: P1 tier text. Legacy/compressor inserts: flat content. */
     content: string;
+    /** v2 paraphrase tiers (model B). Omitted/null for legacy or compressor inserts → stored NULL. */
+    p1?: string | null;
+    p2?: string | null;
+    p3?: string | null;
+    p4?: string | null;
+    /** Decay-rate signal (1-100). Omitted → stored 50. */
+    importance?: number | null;
+    /** Comma-separated activity types. Omitted/null → stored NULL. */
+    episodeType?: string | null;
 }
 export declare function getCompartments(db: Database, sessionId: string): Compartment[];
 export declare function getLastCompartmentEndMessage(db: Database, sessionId: string): number;

package/dist/features/magic-context/compartment-storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compartment-storage.d.ts","sourceRoot":"","sources":["../../../src/features/magic-context/compartment-storage.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"compartment-storage.d.ts","sourceRoot":"","sources":["../../../src/features/magic-context/compartment-storage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAkC,MAAM,qBAAqB,CAAC;AA8BpF,MAAM,WAAW,WAAW;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,2FAA2F;IAC3F,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;IACnB,oFAAoF;IACpF,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB;AA8ED,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB,kGAAkG;IAClG,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAgFD,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,EAAE,CAQ9E;AAED,wBAAgB,4BAA4B,CAAC,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAKpF;AAED;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CACzC,EAAE,EAAE,QAAQ,EACZ,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GACrB,WAAW,EAAE,CAQf;AAED,wBAAgB,sBAAsB,CAClC,EAAE,EAAE,QAAQ,EACZ,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,gBAAgB,EAAE,GACjC,IAAI,CAMN;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAC9B,EAAE,EAAE,QAAQ,EACZ,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,gBAAgB,EAAE,GACjC,IAAI,CAMN;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAC/B,EAAE,EAAE,QAAQ,EACZ,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,GACpD,IAAI,CAON;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,EAAE,CAM9E;AAED,wBAAgB,0BAA0B,CACtC,EAAE,EAAE,QAAQ,EACZ,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,gBAAgB,EAAE,EAChC,KAAK,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,GACpD,IAAI,CAWN;AAED,wBAAgB,sCAAsC,CAClD,EAAE,EAAE,QAAQ,EACZ,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,gBAAgB,EAAE,EAChC,KAAK,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,EACnD,iBAAiB,EAAE,MAAM,EACzB,eAAe,EAAE,MAAM,GACxB,OAAO,CAsCT;AAED,MAAM,WAAW,qBAAqB;IAClC,wEAAwE;IACxE,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrD;AAED,wBAAgB,qBAAqB,CACjC,YAAY,EAAE,WAAW,EAAE,EAC3B,KAAK,EAAE,WAAW,EAAE,EACpB,WAAW,CAAC,EAAE,MAAM,EACpB,UAAU,CAAC,EAAE,qBAAqB,GACnC,MAAM,CAmCR;AAID,MAAM,WAAW,aAAa;IAC1B,YAAY,EAAE,gBAAgB,EAAE,CAAC;IACjC,KAAK,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CAC1B;AAED,uDAAuD;AACvD,wBAAgB,qBAAqB,CACjC,EAAE,EAAE,QAAQ,EACZ,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,gBAAgB,EAAE,EAChC,KAAK,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,GACpD,IAAI,CAsCN;AAED,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAsCtF;AAED,oEAAoE;AACpE,wBAAgB,oBAAoB,CAChC,EAAE,EAAE,QAAQ,EACZ,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,GAClB;IACC,YAAY,EAAE,gBAAgB,EAAE,CAAC;IACjC,KAAK,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvD,GAAG,IAAI,CA0DP;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAWjE;AAED,0FAA0F;AAC1F,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAexE;AAID;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACjC,EAAE,EAAE,QAAQ,EACZ,SAAS,EAAE,MAAM,GAClB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAcvC;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACjC,EAAE,EAAE,QAAQ,EACZ,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GAC7C,IAAI,CASN;AAoDD,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAO/C;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAElD"}

package/dist/features/magic-context/dreamer/lease.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lease.d.ts","sourceRoot":"","sources":["../../../../src/features/magic-context/dreamer/lease.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAkBvD,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAGnD;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,CAE1D;AAED,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAOtF;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAepE;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAWlE;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAUjE"}
+{"version":3,"file":"lease.d.ts","sourceRoot":"","sources":["../../../../src/features/magic-context/dreamer/lease.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAkBvD,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAGnD;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,CAE1D;AAED,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAOtF;AA8BD,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAepE;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAWlE;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAUjE"}

package/dist/features/magic-context/dreamer/queue.d.ts

@@ -8,6 +8,7 @@ export interface DreamQueueEntry {
     startedAt: number | null;
 }
 export declare function ensureDreamQueueTable(db: Database): void;
+export declare function hasActiveDreamLease(db: Database): boolean;
 /** Enqueue a project for dreaming. Skips if the same project already has any queue entry (queued or running).
  *
  * @param force - When true (e.g. manual /ctx-dream), uses the lease TTL (2 min) as the stale threshold
@@ -39,6 +40,16 @@ export declare function removeDreamEntry(db: Database, id: number): void;
 export declare function resetDreamEntry(db: Database, id: number): void;
 /** Get the retry count for a queue entry. */
 export declare function getEntryRetryCount(db: Database, id: number): number;
-/** Clear stale started entries (stuck for more than maxAgeMs). */
-export declare function clearStaleEntries(db: Database, maxAgeMs: number): number;
+/**
+ * Clear stale started entries (stuck for more than maxAgeMs).
+ *
+ * Callers MUST gate this on `!hasActiveDreamLease(db)` — a healthy long-running
+ * dream can exceed `maxAgeMs` while still renewing its lease, and deleting its
+ * own row mid-run is the bug this guard prevents (mirrors the enqueue path).
+ *
+ * `projectIdentity` scopes the delete to one project. The shared `dream_queue`
+ * is cross-process (OpenCode + Pi); a global delete would reap other hosts'
+ * still-running rows. Omit only for the legacy "reap any" test path.
+ */
+export declare function clearStaleEntries(db: Database, maxAgeMs: number, projectIdentity?: string): number;
 //# sourceMappingURL=queue.d.ts.map

package/dist/features/magic-context/dreamer/queue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../../../src/features/magic-context/dreamer/queue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGvD,MAAM,WAAW,eAAe;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,iEAAiE;IACjE,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAexD;AAaD;;;;;GAKG;AACH,wBAAgB,YAAY,CACxB,EAAE,EAAE,QAAQ,EACZ,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,MAAM,EACd,KAAK,UAAQ,GACd,eAAe,GAAG,IAAI,CAsCxB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,QAAQ,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CA4BxF;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAa1F;AAED,yDAAyD;AACzD,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAE/D;AAED,uGAAuG;AACvG,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAI9D;AAED,6CAA6C;AAC7C,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAOnE;AAED,kEAAkE;AAClE,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMxE"}
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../../../src/features/magic-context/dreamer/queue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGvD,MAAM,WAAW,eAAe;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,iEAAiE;IACjE,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAexD;AAED,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CASzD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CACxB,EAAE,EAAE,QAAQ,EACZ,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,MAAM,EACd,KAAK,UAAQ,GACd,eAAe,GAAG,IAAI,CAsCxB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,QAAQ,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CA4BxF;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAa1F;AAED,yDAAyD;AACzD,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAE/D;AAED,uGAAuG;AACvG,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAI9D;AAED,6CAA6C;AAC7C,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAOnE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC7B,EAAE,EAAE,QAAQ,EACZ,QAAQ,EAAE,MAAM,EAChB,eAAe,CAAC,EAAE,MAAM,GACzB,MAAM,CAYR"}

package/dist/features/magic-context/dreamer/runner.d.ts

@@ -71,6 +71,17 @@ export declare function processDreamQueue(args: {
      * handler. Tests pass `undefined` to keep the legacy "dequeue any" semantics.
      */
     projectIdentity?: string;
+    /**
+     * Filesystem directory of the project THIS draining process owns. Because
+     * project identity collapses worktrees/clones to one `git:<sha>`, resolving
+     * the execution directory from the shared in-memory map can pick a stale
+     * sibling checkout ("last-registered wins"). The drain caller always knows
+     * its own live directory, so passing it here guarantees the dream runs in a
+     * checkout this process actually registered. Paired with projectIdentity
+     * (the queue filter), so the dequeued entry is guaranteed to be this
+     * project's. Falls back to the map (then the identity string) when omitted.
+     */
+    sessionDirectoryOverride?: string;
     /**
      * Resolved Dreamer fallback chain. See `runDream` for semantics. Callers
      * compute via `resolveFallbackChain(DREAMER_AGENT, pluginConfig.dreamer?.fallback_models)`.