@cortexkit/opencode-magic-context 0.8.7 → 0.8.9

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

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../../src/features/magic-context/dreamer/runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAItC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AA0C3D,UAAU,6BAA6B;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,6BAA6B,CAAC,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAE9F;AAMD,MAAM,WAAW,cAAc;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE;QACH,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,OAAO,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAClB,EAAE,CAAC;CACP;AAiUD,wBAAsB,QAAQ,CAAC,IAAI,EAAE;IACjC,EAAE,EAAE,QAAQ,CAAC;IACb,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChC,6FAA6F;IAC7F,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wBAAwB,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,kBAAkB,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5E,uBAAuB,CAAC,EAAE,6BAA6B,CAAC;CAC3D,GAAG,OAAO,CAAC,cAAc,CAAC,CAqU1B;AA0LD,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC1C,EAAE,EAAE,QAAQ,CAAC;IACb,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChC,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,wBAAwB,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,kBAAkB,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5E,uBAAuB,CAAC,EAAE,6BAA6B,CAAC;CAC3D,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAyDjC"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../../src/features/magic-context/dreamer/runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAItC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AA2C3D,UAAU,6BAA6B;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,6BAA6B,CAAC,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAE9F;AAMD,MAAM,WAAW,cAAc;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE;QACH,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,OAAO,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAClB,EAAE,CAAC;CACP;AAiUD,wBAAsB,QAAQ,CAAC,IAAI,EAAE;IACjC,EAAE,EAAE,QAAQ,CAAC;IACb,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChC,6FAA6F;IAC7F,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wBAAwB,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,kBAAkB,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5E,uBAAuB,CAAC,EAAE,6BAA6B,CAAC;CAC3D,GAAG,OAAO,CAAC,cAAc,CAAC,CA+U1B;AA0LD,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC1C,EAAE,EAAE,QAAQ,CAAC;IACb,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChC,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,wBAAwB,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,kBAAkB,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5E,uBAAuB,CAAC,EAAE,6BAA6B,CAAC;CAC3D,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAyDjC"}

package/dist/features/magic-context/dreamer/task-prompts.d.ts

@@ -2,7 +2,10 @@ import type { DreamingTask } from "../../../config/schema/magic-context";
 export declare const DREAMER_SYSTEM_PROMPT = "You are a memory maintenance agent for the magic-context system.\nYou run during scheduled dream windows to maintain a project's cross-session memory store and codebase documentation.\n\n## Available Tools\n\n**Memory operations** (ctx_memory with extended dreamer actions):\n- `action=\"list\"` \u2014 browse all active memories, optionally filter by category\n- `action=\"update\", id=N, content=\"...\"` \u2014 rewrite a memory's content\n- `action=\"merge\", ids=[N,M,...], content=\"...\", category=\"...\"` \u2014 consolidate duplicates into one canonical memory\n- `action=\"archive\", id=N, reason=\"...\"` \u2014 archive a stale memory with provenance\n- `action=\"write\", category=\"...\", content=\"...\"` \u2014 create a new memory\n- `action=\"delete\", id=N` \u2014 permanently remove a memory\n\n**Codebase tools** (standard OpenCode tools):\n- Read files, grep, glob, bash \u2014 for verification against actual code\n\n## Rules\n\n1. **Work methodically.** Decide your own batch size based on the task \u2014 process as many items per round as makes sense.\n2. **Always verify against actual files** before declaring a memory stale or updating it.\n3. **Be conservative with archives.** Only archive when the codebase clearly contradicts the memory.\n4. **Explain reasoning briefly** before each action \u2014 one line is enough.\n5. **Use present-tense operational language** in all memory rewrites. \"X uses Y\" not \"X was changed to use Y.\"\n6. **One rule/fact per memory.** Split compound memories during improvement.\n7. **Never read or quote secrets** from .env, credentials, keys, or similar sensitive files.\n8. **Do not commit changes.** The user handles git operations.";
 export declare function buildConsolidatePrompt(projectPath: string): string;
 export declare function buildVerifyPrompt(projectPath: string): string;
-export declare function buildArchiveStalePrompt(projectPath: string): string;
+export declare function buildArchiveStalePrompt(projectPath: string, userMemories?: Array<{
+    id: number;
+    content: string;
+}>): string;
 export declare function buildImprovePrompt(projectPath: string): string;
 export declare function buildMaintainDocsPrompt(projectPath: string, lastDreamAt: string | null, existingDocs: {
     architecture: boolean;
@@ -15,5 +18,9 @@ export declare function buildDreamTaskPrompt(task: DreamingTask, args: {
         architecture: boolean;
         structure: boolean;
     };
+    userMemories?: Array<{
+        id: number;
+        content: string;
+    }>;
 }): string;
 //# sourceMappingURL=task-prompts.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"task-prompts.d.ts","sourceRoot":"","sources":["../../../../src/features/magic-context/dreamer/task-prompts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAIzE,eAAO,MAAM,qBAAqB,wqDAyB6B,CAAC;AAIhE,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CA+BlE;AAID,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAoC7D;AAID,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAsDnE;AAID,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CA0C9D;AAID,wBAAgB,uBAAuB,CACnC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,YAAY,EAAE;IAAE,YAAY,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,GAC5D,MAAM,CA+CR;AA0GD,wBAAgB,oBAAoB,CAChC,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE;IACF,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,CAAC,EAAE;QAAE,YAAY,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;CAChE,GACF,MAAM,CAiBR"}
+{"version":3,"file":"task-prompts.d.ts","sourceRoot":"","sources":["../../../../src/features/magic-context/dreamer/task-prompts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAIzE,eAAO,MAAM,qBAAqB,wqDAyB6B,CAAC;AAIhE,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CA+BlE;AAID,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAoC7D;AAID,wBAAgB,uBAAuB,CACnC,WAAW,EAAE,MAAM,EACnB,YAAY,CAAC,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,GACtD,MAAM,CA0ER;AAID,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CA0C9D;AAID,wBAAgB,uBAAuB,CACnC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,YAAY,EAAE;IAAE,YAAY,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,GAC5D,MAAM,CA+CR;AA0GD,wBAAgB,oBAAoB,CAChC,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE;IACF,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,CAAC,EAAE;QAAE,YAAY,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IAC7D,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzD,GACF,MAAM,CAiBR"}

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

@@ -1 +1 @@
-{"version":3,"file":"embedding-local.d.ts","sourceRoot":"","sources":["../../../../src/features/magic-context/memory/embedding-local.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAyH9D,qBAAa,sBAAuB,YAAW,iBAAiB;IAC5D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,WAAW,CAA8B;gBAErC,KAAK,SAAgC;IAK3C,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IA+E9B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAyBjD,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,YAAY,GAAG,IAAI,CAAC,EAAE,CAAC;IA6B7D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB9B,QAAQ,IAAI,OAAO;CAGtB"}
+{"version":3,"file":"embedding-local.d.ts","sourceRoot":"","sources":["../../../../src/features/magic-context/memory/embedding-local.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAyH9D,qBAAa,sBAAuB,YAAW,iBAAiB;IAC5D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,WAAW,CAA8B;gBAErC,KAAK,SAAgC;IAK3C,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAqG9B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAyBjD,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,YAAY,GAAG,IAAI,CAAC,EAAE,CAAC;IA6B7D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB9B,QAAQ,IAAI,OAAO;CAGtB"}

package/dist/hooks/magic-context/inject-compartments.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inject-compartments.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/inject-compartments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAS3C,OAAO,KAAK,EAAE,MAAM,EAAkB,MAAM,2CAA2C,CAAC;AAExF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,WAAW,4BAA4B;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB,EAAE,MAAM,CAAC;IAC9B,uBAAuB,EAAE,MAAM,CAAC;IAChC,gBAAgB,EAAE,MAAM,CAAC;IACzB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACvB;AAWD,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAE3D;AAED,MAAM,WAAW,0BAA0B;IACvC,QAAQ,EAAE,OAAO,CAAC;IAClB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,sBAAsB,EAAE,MAAM,CAAC;CAClC;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CA6BnE;AA+CD,wBAAgB,2BAA2B,CACvC,EAAE,EAAE,QAAQ,EACZ,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,WAAW,EAAE,EACvB,cAAc,EAAE,OAAO,EACvB,WAAW,CAAC,EAAE,MAAM,EACpB,qBAAqB,CAAC,EAAE,MAAM,GAC/B,4BAA4B,GAAG,IAAI,CAkHrC;AAED,wBAAgB,0BAA0B,CACtC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,WAAW,EAAE,EACvB,QAAQ,EAAE,4BAA4B,GACvC,0BAA0B,CAyB5B"}
+{"version":3,"file":"inject-compartments.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/inject-compartments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAS3C,OAAO,KAAK,EAAE,MAAM,EAAkB,MAAM,2CAA2C,CAAC;AAExF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,WAAW,4BAA4B;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB,EAAE,MAAM,CAAC;IAC9B,uBAAuB,EAAE,MAAM,CAAC;IAChC,gBAAgB,EAAE,MAAM,CAAC;IACzB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACvB;AAWD,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAE3D;AAED,MAAM,WAAW,0BAA0B;IACvC,QAAQ,EAAE,OAAO,CAAC;IAClB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,sBAAsB,EAAE,MAAM,CAAC;CAClC;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CA6BnE;AA8ED,wBAAgB,2BAA2B,CACvC,EAAE,EAAE,QAAQ,EACZ,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,WAAW,EAAE,EACvB,cAAc,EAAE,OAAO,EACvB,WAAW,CAAC,EAAE,MAAM,EACpB,qBAAqB,CAAC,EAAE,MAAM,GAC/B,4BAA4B,GAAG,IAAI,CAkHrC;AAED,wBAAgB,0BAA0B,CACtC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,WAAW,EAAE,EACvB,QAAQ,EAAE,4BAA4B,GACvC,0BAA0B,CAyB5B"}

package/dist/index.js

@@ -16166,6 +16166,8 @@ function cosineSimilarity(a, b) {
 }
 
 // src/features/magic-context/memory/embedding-local.ts
+import { mkdirSync } from "fs";
+import { join as join9 } from "path";
 async function withQuietConsole(fn) {
   const origWarn = console.warn;
   const origError = console.error;
@@ -16250,6 +16252,13 @@ class LocalEmbeddingProvider {
         if (LogLevel && "ERROR" in LogLevel) {
           env.logLevel = LogLevel.ERROR;
         }
+        const modelCacheDir = join9(getOpenCodeStorageDir(), "plugin", "magic-context", "models");
+        try {
+          mkdirSync(modelCacheDir, { recursive: true });
+          env.cacheDir = modelCacheDir;
+        } catch {
+          log("[magic-context] could not create model cache dir, using library default");
+        }
         const createPipeline = transformersModule.pipeline;
         const MAX_ATTEMPTS = 3;
         let lastError;
@@ -16351,6 +16360,7 @@ class LocalEmbeddingProvider {
 }
 var init_embedding_local = __esm(() => {
   init_magic_context();
+  init_data_path();
   init_logger();
 });
 
@@ -17401,11 +17411,11 @@ var init_migrations = __esm(() => {
 
 // src/features/magic-context/storage-db.ts
 import { Database as Database3 } from "bun:sqlite";
-import { mkdirSync } from "fs";
-import { join as join9 } from "path";
+import { mkdirSync as mkdirSync2 } from "fs";
+import { join as join10 } from "path";
 function resolveDatabasePath() {
-  const dbDir = join9(getOpenCodeStorageDir(), "plugin", "magic-context");
-  return { dbDir, dbPath: join9(dbDir, "context.db") };
+  const dbDir = join10(getOpenCodeStorageDir(), "plugin", "magic-context");
+  return { dbDir, dbPath: join10(dbDir, "context.db") };
 }
 function initializeDatabase(db) {
   db.run("PRAGMA journal_mode=WAL");
@@ -17720,7 +17730,7 @@ function openDatabase() {
       }
       return existing;
     }
-    mkdirSync(dbDir, { recursive: true });
+    mkdirSync2(dbDir, { recursive: true });
     const db = new Database3(dbPath);
     initializeDatabase(db);
     runMigrations(db);
@@ -18559,7 +18569,7 @@ var init_send_session_notification = __esm(() => {
 
 // src/features/magic-context/compaction-marker.ts
 import { Database as Database4 } from "bun:sqlite";
-import { join as join11 } from "path";
+import { join as join12 } from "path";
 function randomBase62(length) {
   const chars = [];
   for (let i = 0;i < length; i++) {
@@ -18579,7 +18589,7 @@ function generatePartId(timestampMs, counter = 0n) {
   return generateId("prt", timestampMs, counter);
 }
 function getOpenCodeDbPath3() {
-  return join11(getDataDir(), "opencode", "opencode.db");
+  return join12(getDataDir(), "opencode", "opencode.db");
 }
 function getWritableOpenCodeDb() {
   const dbPath = getOpenCodeDbPath3();
@@ -19472,9 +19482,9 @@ var init_compartment_runner_validation = __esm(() => {
 });
 
 // src/hooks/magic-context/compartment-runner-historian.ts
-import { mkdirSync as mkdirSync2, unlinkSync, writeFileSync } from "fs";
+import { mkdirSync as mkdirSync3, unlinkSync, writeFileSync } from "fs";
 import { tmpdir as tmpdir2 } from "os";
-import { join as join12 } from "path";
+import { join as join13 } from "path";
 async function runValidatedHistorianPass(args) {
   const firstRun = await runHistorianPrompt({
     ...args,
@@ -19677,10 +19687,10 @@ function cleanupHistorianDump(sessionId, dumpPath) {
 }
 function dumpHistorianResponse(sessionId, label, text) {
   try {
-    mkdirSync2(HISTORIAN_RESPONSE_DUMP_DIR, { recursive: true });
+    mkdirSync3(HISTORIAN_RESPONSE_DUMP_DIR, { recursive: true });
     const safeSessionId = sanitizeDumpName(sessionId);
     const safeLabel = sanitizeDumpName(label);
-    const dumpPath = join12(HISTORIAN_RESPONSE_DUMP_DIR, `${safeSessionId}-${safeLabel}-${Date.now()}.xml`);
+    const dumpPath = join13(HISTORIAN_RESPONSE_DUMP_DIR, `${safeSessionId}-${safeLabel}-${Date.now()}.xml`);
     writeFileSync(dumpPath, text, "utf8");
     sessionLog(sessionId, "compartment agent: historian response dumped", {
       label,
@@ -19704,7 +19714,7 @@ var init_compartment_runner_historian = __esm(() => {
   init_shared();
   init_assistant_message_extractor();
   init_compartment_runner_validation();
-  HISTORIAN_RESPONSE_DUMP_DIR = join12(tmpdir2(), "magic-context-historian");
+  HISTORIAN_RESPONSE_DUMP_DIR = join13(tmpdir2(), "magic-context-historian");
 });
 
 // src/hooks/magic-context/compartment-runner-state-xml.ts
@@ -19775,15 +19785,28 @@ ${sections.join(`
 `)}
 </project-memory>`;
 }
+function utilityTier(m) {
+  if (m.retrievalCount > 0)
+    return 0;
+  if (CONSTRAINT_KEYWORDS.test(m.content))
+    return 1;
+  return 2;
+}
 function trimMemoriesToBudget(sessionId, memories, budgetTokens) {
   const sorted = [...memories].sort((a, b) => {
     if (a.status === "permanent" && b.status !== "permanent")
       return -1;
     if (b.status === "permanent" && a.status !== "permanent")
       return 1;
+    const tierDiff = utilityTier(a) - utilityTier(b);
+    if (tierDiff !== 0)
+      return tierDiff;
     const seenDiff = b.seenCount - a.seenCount;
     if (seenDiff !== 0)
       return seenDiff;
+    const lenDiff = a.content.length - b.content.length;
+    if (lenDiff !== 0)
+      return lenDiff;
     return a.id - b.id;
   });
   const result = [];
@@ -19917,13 +19940,14 @@ function findFirstTextPart(parts) {
 function isDroppedPlaceholder(text) {
   return /^\[dropped \u00A7\d+\u00A7\]$/.test(text.trim());
 }
-var injectionCache, CHARS_PER_TOKEN_ESTIMATE = 4;
+var injectionCache, CHARS_PER_TOKEN_ESTIMATE = 4, CONSTRAINT_KEYWORDS;
 var init_inject_compartments = __esm(() => {
   init_compartment_storage();
   init_constants();
   init_storage_memory();
   init_logger();
   injectionCache = new Map;
+  CONSTRAINT_KEYWORDS = /\b(must|never|always|cannot|should not|must not)\b/i;
 });
 
 // src/hooks/magic-context/compartment-runner-incremental.ts
@@ -28023,10 +28047,10 @@ var require_stringify = __commonJS((exports, module) => {
     replacer = null;
     indent = EMPTY;
   };
-  var join15 = (one, two, gap) => one ? two ? one + two.trim() + LF + gap : one.trimRight() + repeat_line_breaks(Math.max(1, count_trailing_line_breaks(one, gap)), gap) : two ? two.trimRight() + repeat_line_breaks(Math.max(1, count_trailing_line_breaks(two, gap)), gap) : EMPTY;
+  var join16 = (one, two, gap) => one ? two ? one + two.trim() + LF + gap : one.trimRight() + repeat_line_breaks(Math.max(1, count_trailing_line_breaks(one, gap)), gap) : two ? two.trimRight() + repeat_line_breaks(Math.max(1, count_trailing_line_breaks(two, gap)), gap) : EMPTY;
   var join_content = (inside, value, gap) => {
     const comment = process_comments(value, PREFIX_BEFORE, gap + indent, true);
-    return join15(comment, inside, gap);
+    return join16(comment, inside, gap);
   };
   var stringify_string = (holder, key, value) => {
     const raw = get_raw_string_literal(holder, key);
@@ -28048,13 +28072,13 @@ var require_stringify = __commonJS((exports, module) => {
       if (i !== 0) {
         inside += COMMA;
       }
-      const before = join15(after_comma, process_comments(value, BEFORE(i), deeper_gap), deeper_gap);
+      const before = join16(after_comma, process_comments(value, BEFORE(i), deeper_gap), deeper_gap);
       inside += before || LF + deeper_gap;
       inside += stringify(i, value, deeper_gap) || STR_NULL;
       inside += process_comments(value, AFTER_VALUE(i), deeper_gap);
       after_comma = process_comments(value, AFTER(i), deeper_gap);
     }
-    inside += join15(after_comma, process_comments(value, PREFIX_AFTER, deeper_gap), deeper_gap);
+    inside += join16(after_comma, process_comments(value, PREFIX_AFTER, deeper_gap), deeper_gap);
     return BRACKET_OPEN + join_content(inside, value, gap) + BRACKET_CLOSE;
   };
   var object_stringify = (value, gap) => {
@@ -28075,13 +28099,13 @@ var require_stringify = __commonJS((exports, module) => {
         inside += COMMA;
       }
       first = false;
-      const before = join15(after_comma, process_comments(value, BEFORE(key), deeper_gap), deeper_gap);
+      const before = join16(after_comma, process_comments(value, BEFORE(key), deeper_gap), deeper_gap);
       inside += before || LF + deeper_gap;
       inside += quote(key) + process_comments(value, AFTER_PROP(key), deeper_gap) + COLON + process_comments(value, AFTER_COLON(key), deeper_gap) + SPACE + sv + process_comments(value, AFTER_VALUE(key), deeper_gap);
       after_comma = process_comments(value, AFTER(key), deeper_gap);
     };
     keys.forEach(iteratee);
-    inside += join15(after_comma, process_comments(value, PREFIX_AFTER, deeper_gap), deeper_gap);
+    inside += join16(after_comma, process_comments(value, PREFIX_AFTER, deeper_gap), deeper_gap);
     return CURLY_BRACKET_OPEN + join_content(inside, value, gap) + CURLY_BRACKET_CLOSE;
   };
   function stringify(key, holder, gap) {
@@ -28178,12 +28202,12 @@ var exports_tui_config = {};
 __export(exports_tui_config, {
   ensureTuiPluginEntry: () => ensureTuiPluginEntry
 });
-import { existsSync as existsSync7, mkdirSync as mkdirSync4, readFileSync as readFileSync6, writeFileSync as writeFileSync3 } from "fs";
-import { dirname as dirname2, join as join15 } from "path";
+import { existsSync as existsSync7, mkdirSync as mkdirSync5, readFileSync as readFileSync6, writeFileSync as writeFileSync3 } from "fs";
+import { dirname as dirname2, join as join16 } from "path";
 function resolveTuiConfigPath() {
   const configDir = getOpenCodeConfigPaths({ binary: "opencode" }).configDir;
-  const jsoncPath = join15(configDir, "tui.jsonc");
-  const jsonPath = join15(configDir, "tui.json");
+  const jsoncPath = join16(configDir, "tui.jsonc");
+  const jsonPath = join16(configDir, "tui.json");
   if (existsSync7(jsoncPath))
     return jsoncPath;
   if (existsSync7(jsonPath))
@@ -28204,7 +28228,7 @@ function ensureTuiPluginEntry() {
     }
     plugins.push(PLUGIN_ENTRY);
     config2.plugin = plugins;
-    mkdirSync4(dirname2(configPath), { recursive: true });
+    mkdirSync5(dirname2(configPath), { recursive: true });
     writeFileSync3(configPath, `${import_comment_json.stringify(config2, null, 2)}
 `);
     log(`[magic-context] added TUI plugin entry to ${configPath}`);
@@ -28469,58 +28493,75 @@ Check verifiable memories against actual repository state. Update stale wording,
 - No memories reference files or paths that no longer exist.
 - Updated memories use current naming and paths.`;
 }
-function buildArchiveStalePrompt(projectPath) {
+function buildArchiveStalePrompt(projectPath, userMemories) {
+  const userProfileBlock = userMemories && userMemories.length > 0 ? `
+### Global User Profile (already injected into ALL sessions across ALL projects)
+These user memories are ALREADY available to the agent globally. Project memories that merely restate the same preference/rule are redundant and should be archived \u2014 but ONLY if the project memory adds ZERO project-specific detail beyond what the global memory already says.
+
+${userMemories.map((um) => `- [U${um.id}] ${um.content}`).join(`
+`)}
+` : "";
   return `## Task: Archive Stale Memories
 
 **Project:** ${projectPath}
 
 ### Goal
-Find and archive memories that reference removed features, discontinued tools, old paths, obsolete workflows, or completed one-time instructions.
+Find and archive memories that waste the limited injection budget (~6000 tokens, fits ~150 memories).
+${userProfileBlock}
+### Archive criteria (archive IF any apply)
+
+1. **Code restatement without rationale** \u2014 merely describes what code does without explaining WHY or what would break if changed.
+   - Archive: "Tag assignment uses one DB transaction" (obvious from code)
+   - Keep: "Tag assignment uses one DB transaction because tags rows and session_meta.counter must stay in sync" (explains the constraint)
+
+2. **Redundant with other memories** \u2014 same information expressed differently. Keep the better-worded one.
+
+3. **Stale implementation detail** \u2014 references specific functions, line numbers, or internal structures that change frequently and are better found by reading code.
+   - Archive: "Function X is called at line 289 of file Y"
+   - Keep: "Feature X requires Y to be initialized before Z" (design constraint)
+
+4. **Low retrieval signal** \u2014 seen_count=1, retrieval_count=0, and no constraint language. These were promoted once but never needed again.
+
+5. **Redundant with global user profile** \u2014 ONLY if the project memory adds ZERO project-specific detail beyond what the global memory already says. A project memory that applies a global principle to a specific context (e.g., "cache awareness is highest priority" applies a general principle to THIS project's north star) is NOT redundant \u2014 it narrows the global principle.
+
+6. **Bare config defaults** \u2014 single-line values like \`enabled=true\` or \`experimental.X=false\` with no surrounding explanation or rationale.
+
+7. **Completed one-time instructions** \u2014 imperative USER_DIRECTIVES like "Add X", "Create Y", "Publish as Z" where the action has clearly been done.
+
+### Keep criteria (keep IF ANY apply \u2014 these OVERRIDE archive criteria)
+
+1. **Contains constraint/rule** \u2014 uses "must", "never", "always", "cannot", "should not". CONSTRAINTS category gets extra protection: only archive if the EXACT same constraint exists word-for-word in another memory.
+2. **Captures non-obvious design reasoning** \u2014 explains WHY, not just WHAT. Look for "because", "so that", "to prevent", "to avoid".
+3. **Project-specific behavioral rule** \u2014 even if it sounds generic, if it's in USER_DIRECTIVES it was explicitly stated by the user for this project. Only archive if: (a) the action is clearly completed, or (b) it is 100% identical in scope to a global user memory.
+4. **Post-failure learning** \u2014 memories that encode lessons learned from real bugs, regressions, or user corrections. These prevent re-encountering the same problem.
+5. **Environment/path information** \u2014 saves agent from hunting for locations.
+6. **Config defaults with context** \u2014 prevents wrong assumptions. Archive ONLY bare values with no surrounding explanation.
+7. **Known issues** \u2014 prevents re-encountering solved problems. NEVER archive KNOWN_ISSUES.
+8. **High retrieval signal** \u2014 retrieval_count > 0 means the agent actually searched for this.
+9. **Priority/philosophy statements** \u2014 "X is the highest priority" or "north star" type directives that shape all decisions.
 
 ### Process
 
 1. **List all active memories** with \`ctx_memory(action="list")\`.
-2. **Scan for staleness signals:**
-   - References to tools that no longer exist (grep the tool registry)
-   - References to files or directories that were deleted or renamed
-   - References to old repository names, branches, or workflows
-   - References to features explicitly described as "removed" or "replaced"
-   - References to config keys that no longer appear in the schema
-   - Session-local context that has no ongoing value ("in this session", "earlier today")
-   - **Completed one-time instructions** in USER_DIRECTIVES \u2014 imperative directives like "Add X", "Create Y", "License as MIT", "Publish as Z" where the action has clearly been done (check the codebase to confirm completion)
-   - **Low-value implementation minutiae** in ARCHITECTURE_DECISIONS \u2014 single-line statements that merely restate what code does without explaining WHY or capturing a non-obvious constraint. Example: "Tag assignment uses one DB transaction" just restates code behavior \u2014 this belongs in source comments, not project memory. Keep memories that explain *why* a design choice was made, *what constraint* drove it, or *what would break* if it changed.
+2. **Apply the archive and keep criteria above to each memory.**
 3. **Verify each candidate** against the codebase before archiving:
    - Check if the file/tool/path actually exists
-   - Check if the feature is mentioned in current code
-   - For USER_DIRECTIVES: verify the instructed action was completed (e.g., "License as MIT" \u2192 check LICENSE file exists)
+   - For USER_DIRECTIVES: verify the instructed action was completed
    - If the reference is ambiguous, leave it alone
 4. **Archive** with \`ctx_memory(action="archive", id=N, reason="...")\`. Always include a specific reason.
 
-### Common staleness patterns
-- Old plugin paths (e.g., \`oh-my-opencode\` references when the plugin is now \`magic-context\`)
-- Removed tools (e.g., \`ctx_recall\` was merged into \`ctx_memory\`)
-- Discontinued workflows (e.g., "replay onto integrate branch")
-- Branch-era context ("on feat/context-management")
-- Stale config keys or defaults that changed
-- Completed setup/publishing/licensing instructions that are done and won't recur
-- Implementation details that simply restate code behavior without adding design rationale
-
-### USER_DIRECTIVES handling
-- **Archive** completed one-time instructions: "License as MIT", "Publish as @cortexkit/...", "Add changelog to releases", "For the README animation, emphasize X"
-- **Keep** ongoing preferences and behavioral rules: "Ask before changing behavior when audit finding is ambiguous", "Cache awareness is the highest-priority feature"
-- **Keep** workflow preferences that apply to future work: "Always use scripts/release.sh for releases"
-- Rule of thumb: if the directive uses imperative "do this" language and the action is done, archive it. If it describes how to behave going forward, keep it.
-
-### ARCHITECTURE_DECISIONS pruning
-- **Archive** memories that only restate what code does: "Function X calls Y", "Module A imports B"
-- **Keep** memories that explain constraints, tradeoffs, or non-obvious design reasoning: "X uses Y because Z would cause cache busts"
-- **Keep** memories that warn about gotchas: "Don't use cwd fallback because it causes cross-project contamination"
-- Rule of thumb: if removing the memory would cause someone to make a wrong design decision, keep it. If it's just restating navigable code structure, archive it \u2014 ARCHITECTURE.md covers that.
+### Category-specific rules
+- **CONSTRAINTS**: archive ONLY when provably redundant with another specific constraint (not just thematically similar). Each constraint typically guards against a specific bug \u2014 losing it means the bug can return.
+- **USER_DIRECTIVES**: archive ONLY completed one-time tasks or exact duplicates of global user profile entries. Keep ongoing behavioral rules even if they have low retrieval.
+- **KNOWN_ISSUES**: NEVER archive \u2014 these prevent re-encountering bugs.
+- **ARCHITECTURE_DECISIONS**: archive code restatements freely, keep anything with "because", "so that", "to prevent", "to avoid".
+- **CONFIG_DEFAULTS**: archive bare values with no context, keep values that include rationale or prevent wrong assumptions.
 
 ### Success criteria
 - No active memories reference non-existent files, tools, or paths.
 - No completed one-time instructions remain in USER_DIRECTIVES.
 - ARCHITECTURE_DECISIONS contains design reasoning, not code restatements.
+- CONSTRAINTS are preserved unless provably duplicated.
 - Every archived memory has a specific reason.
 - Conservative \u2014 when in doubt, leave it active.`;
 }
@@ -28714,7 +28755,7 @@ function buildDreamTaskPrompt(task, args) {
     case "verify":
       return buildVerifyPrompt(args.projectPath);
     case "archive-stale":
-      return buildArchiveStalePrompt(args.projectPath);
+      return buildArchiveStalePrompt(args.projectPath, args.userMemories);
     case "improve":
       return buildImprovePrompt(args.projectPath);
     case "maintain-docs":
@@ -29317,7 +29358,6 @@ If no promotions are warranted, return empty arrays. Always consume reviewed can
     }
   }
 }
-
 // src/features/magic-context/dreamer/storage-dream-runs.ts
 var insertDreamRunStatements = new WeakMap;
 var getDreamRunsByProjectStatements = new Map;
@@ -29608,10 +29648,15 @@ async function runDream(args) {
           architecture: existsSync4(join8(docsDir, "ARCHITECTURE.md")),
           structure: existsSync4(join8(docsDir, "STRUCTURE.md"))
         } : undefined;
+        const userMemories = taskName === "archive-stale" ? getActiveUserMemories(args.db).map((um) => ({
+          id: um.id,
+          content: um.content
+        })) : undefined;
         const taskPrompt = buildDreamTaskPrompt(taskName, {
           projectPath: args.projectIdentity,
           lastDreamAt,
-          existingDocs
+          existingDocs,
+          userMemories
         });
         const createResponse = await args.client.session.create({
           body: {
@@ -30159,7 +30204,7 @@ function createCompactionHandler() {
 init_logger();
 import { existsSync as existsSync5, readFileSync as readFileSync4 } from "fs";
 import { homedir as homedir5, platform as platform2 } from "os";
-import { join as join10 } from "path";
+import { join as join11 } from "path";
 var cachedLimits = null;
 var lastLoadAttempt = 0;
 var RELOAD_INTERVAL_MS = 5 * 60 * 1000;
@@ -30170,11 +30215,11 @@ function getModelsJsonPath() {
   if (xdgCache) {
     cacheBase = xdgCache;
   } else if (os3 === "win32") {
-    cacheBase = process.env.LOCALAPPDATA ?? join10(homedir5(), "AppData", "Local");
+    cacheBase = process.env.LOCALAPPDATA ?? join11(homedir5(), "AppData", "Local");
   } else {
-    cacheBase = join10(homedir5(), ".cache");
+    cacheBase = join11(homedir5(), ".cache");
   }
-  return join10(cacheBase, "opencode", "models.json");
+  return join11(cacheBase, "opencode", "models.json");
 }
 function loadModelsDevLimits() {
   const limits = new Map;
@@ -33766,7 +33811,7 @@ init_send_session_notification();
 
 // src/hooks/magic-context/system-prompt-hash.ts
 import { existsSync as existsSync6, readFileSync as readFileSync5, realpathSync } from "fs";
-import { join as join13, resolve as resolve2, sep } from "path";
+import { join as join14, resolve as resolve2, sep } from "path";
 
 // src/agents/magic-context-prompt.ts
 function getToolHistoryGuidance(dropToolStructure) {
@@ -33986,7 +34031,7 @@ var DOC_FILES = ["ARCHITECTURE.md", "STRUCTURE.md"];
 function readProjectDocs(directory) {
   const sections = [];
   for (const filename of DOC_FILES) {
-    const filePath = join13(directory, filename);
+    const filePath = join14(directory, filename);
     try {
       if (existsSync6(filePath)) {
         const content = readFileSync5(filePath, "utf-8").trim();
@@ -36000,19 +36045,19 @@ init_model_requirements();
 
 // src/shared/rpc-server.ts
 init_logger();
-import { mkdirSync as mkdirSync3, renameSync, unlinkSync as unlinkSync2, writeFileSync as writeFileSync2 } from "fs";
+import { mkdirSync as mkdirSync4, renameSync, unlinkSync as unlinkSync2, writeFileSync as writeFileSync2 } from "fs";
 import { createServer } from "http";
 import { dirname } from "path";
 
 // src/shared/rpc-utils.ts
 import { createHash } from "crypto";
-import { join as join14 } from "path";
+import { join as join15 } from "path";
 function projectHash(directory) {
   const normalized = directory.replace(/\/+$/, "");
   return createHash("sha256").update(normalized).digest("hex").slice(0, 16);
 }
 function rpcPortFilePath(storageDir, directory) {
-  return join14(storageDir, "rpc", projectHash(directory), "port");
+  return join15(storageDir, "rpc", projectHash(directory), "port");
 }
 
 // src/shared/rpc-server.ts
@@ -36044,7 +36089,7 @@ class MagicContextRpcServer {
         this.server = server;
         try {
           const dir = dirname(this.portFilePath);
-          mkdirSync3(dir, { recursive: true });
+          mkdirSync4(dir, { recursive: true });
           const tmpPath = `${this.portFilePath}.tmp`;
           writeFileSync2(tmpPath, String(this.port), "utf-8");
           renameSync(tmpPath, this.portFilePath);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cortexkit/opencode-magic-context",
-  "version": "0.8.7",
+  "version": "0.8.9",
   "type": "module",
   "description": "OpenCode plugin for Magic Context — cross-session memory and context management",
   "main": "dist/index.js",