@wolfx/opencode-magic-context 0.21.8-patch.8 → 0.22.1-patch.0

package/dist/agents/magic-context-prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"magic-context-prompt.d.ts","sourceRoot":"","sources":["../../src/agents/magic-context-prompt.ts"],"names":[],"mappings":"AAAA,wEAAwE;AAmFxE,wBAAgB,wBAAwB,CACpC,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,aAAa,EAAE,MAAM,EACrB,gBAAgB,UAAO,EACvB,cAAc,UAAQ,EACtB,iBAAiB,UAAO,EACxB,wBAAwB,UAAQ,EAChC,6BAA6B,UAAQ,GACtC,MAAM,CAiBR"}
+{"version":3,"file":"magic-context-prompt.d.ts","sourceRoot":"","sources":["../../src/agents/magic-context-prompt.ts"],"names":[],"mappings":"AAAA,wEAAwE;AA+GxE,wBAAgB,wBAAwB,CACpC,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,aAAa,EAAE,MAAM,EACrB,gBAAgB,UAAO,EACvB,cAAc,UAAQ,EACtB,iBAAiB,UAAO,EACxB,wBAAwB,UAAQ,EAChC,6BAA6B,UAAQ,GACtC,MAAM,CAiBR"}

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>/.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>/.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;AA+VD,wBAAgB,gBAAgB,CAC5B,SAAS,EAAE,MAAM,GAClB,wBAAwB,GAAG;IAAE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CA2D1D;AAgDD,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,kBAAkB,CA4D9E"}
+{"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;AAoQD,wBAAgB,gBAAgB,CAC5B,SAAS,EAAE,MAAM,GAClB,wBAAwB,GAAG;IAAE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CA2D1D;AAgDD,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,kBAAkB,CA4D9E"}

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

@@ -0,0 +1,30 @@
+/**
+ * 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`.
+ *  - fork: `experimental.text_complete_strip` → top-level `text_complete_strip`.
+ *
+ * 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;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,yBAAyB,CACrC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,QAAQ,EAAE,MAAM,EAAE,GACnB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkIzB"}

package/dist/config/schema/agent-overrides.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-overrides.d.ts","sourceRoot":"","sources":["../../../src/config/schema/agent-overrides.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,iCAAiC,+CAAgD,CAAC;AAgB/F,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkBpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC"}
+{"version":3,"file":"agent-overrides.d.ts","sourceRoot":"","sources":["../../../src/config/schema/agent-overrides.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,iCAAiC,+CAAgD,CAAC;AAgB/F,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA4BpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC"}

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

@@ -1,23 +1,10 @@
 import { z } from "zod";
 export declare const DEFAULT_NUDGE_INTERVAL_TOKENS = 10000;
 export declare const DEFAULT_EXECUTE_THRESHOLD_PERCENTAGE = 65;
+export declare const EXECUTE_THRESHOLD_CAP_MESSAGE = "execute_threshold is capped at 80% for cache safety: a single large agent step can overflow the context window before Magic Context can compact between turns, forcing OpenCode's native compaction (hard to recover from). 80% also leaves headroom below the 85%/95% emergency bands. Use a value between 20 and 80.";
 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";
@@ -255,10 +242,14 @@ export declare const EmbeddingConfigSchema: z.ZodPipe<z.ZodObject<{
     model: z.ZodOptional<z.ZodString>;
     endpoint: z.ZodOptional<z.ZodString>;
     api_key: z.ZodOptional<z.ZodString>;
+    input_type: z.ZodOptional<z.ZodString>;
+    truncate: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodTransform<{
     provider: "local";
     model: string;
 } | {
+    truncate?: string | undefined;
+    input_type?: string | undefined;
     api_key?: string | undefined;
     provider: "openai-compatible";
     model: string;
@@ -271,6 +262,8 @@ export declare const EmbeddingConfigSchema: z.ZodPipe<z.ZodObject<{
     model?: string | undefined;
     endpoint?: string | undefined;
     api_key?: string | undefined;
+    input_type?: string | undefined;
+    truncate?: string | undefined;
 }>>;
 export type EmbeddingConfig = z.infer<typeof EmbeddingConfigSchema>;
 export interface MagicContextConfig {
@@ -308,6 +301,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>`,
@@ -329,32 +327,49 @@ 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;
-        };
+    /** Custom leading prefix strip patterns for text-complete handler.
+     *  When configured, overrides the built-in §N§/§N° patterns entirely.
+     *  Falls back to built-in defaults when omitted. */
+    text_complete_strip?: {
+        enabled: boolean;
+        patterns?: string[];
+    };
+    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. */
@@ -362,38 +377,19 @@ export interface MagicContextConfig {
             /** Minimum user message length in characters (skip short prompts). */
             min_prompt_chars: number;
         };
-        /** Custom leading prefix strip patterns for text-complete handler.
-         *  When configured, overrides the built-in §N§/§N° patterns entirely. */
-        text_complete_strip?: {
-            enabled: boolean;
-            patterns?: string[];
-        };
-        /**
-         * 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<{
@@ -561,13 +557,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<{
@@ -578,10 +570,14 @@ export declare const MagicContextConfigSchema: z.ZodPipe<z.ZodObject<{
         model: z.ZodOptional<z.ZodString>;
         endpoint: z.ZodOptional<z.ZodString>;
         api_key: z.ZodOptional<z.ZodString>;
+        input_type: z.ZodOptional<z.ZodString>;
+        truncate: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>, z.ZodTransform<{
         provider: "local";
         model: string;
     } | {
+        truncate?: string | undefined;
+        input_type?: string | undefined;
         api_key?: string | undefined;
         provider: "openai-compatible";
         model: string;
@@ -594,34 +590,34 @@ export declare const MagicContextConfigSchema: z.ZodPipe<z.ZodObject<{
         model?: string | undefined;
         endpoint?: string | undefined;
         api_key?: string | undefined;
+        input_type?: string | undefined;
+        truncate?: 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>>;
+    text_complete_strip: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        patterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, 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>>;
-        text_complete_strip: z.ZodOptional<z.ZodObject<{
-            enabled: z.ZodDefault<z.ZodBoolean>;
-            patterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        }, 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>;
@@ -708,18 +704,16 @@ 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";
         model: string;
     } | {
+        truncate?: string | undefined;
+        input_type?: string | undefined;
         api_key?: string | undefined;
         provider: "openai-compatible";
         model: string;
@@ -728,32 +722,26 @@ 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;
         };
-        text_complete_strip?: {
-            enabled: boolean;
-            patterns?: string[] | undefined;
-        } | undefined;
-    };
-    memory: {
-        enabled: boolean;
-        injection_budget_tokens: number;
-        auto_promote: boolean;
-        retrieval_count_promotion_threshold: number;
     };
     historian?: {
         two_pass: boolean;
@@ -821,6 +809,10 @@ export declare const MagicContextConfigSchema: z.ZodPipe<z.ZodObject<{
         default?: number | undefined;
     } | undefined;
     protected_tags?: number | undefined;
+    text_complete_strip?: {
+        enabled: boolean;
+        patterns?: string[] | undefined;
+    } | undefined;
     sidekick?: {
         timeout_ms: number;
         model?: string | undefined;

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;