@cortexkit/magic-context 0.30.7 → 0.31.0

package/dist/index.js

@@ -13389,11 +13389,71 @@ var init_migrate = __esm(async () => {
   await init_sqlite();
 });
 
+// ../plugin/src/shared/logger.ts
+import * as fs from "node:fs";
+import * as path2 from "node:path";
+function ensureDir5(filePath) {
+  const dir = path2.dirname(filePath);
+  if (dir === lastEnsuredDir)
+    return;
+  try {
+    fs.mkdirSync(dir, { recursive: true });
+    lastEnsuredDir = dir;
+  } catch {}
+}
+function flush() {
+  if (flushTimer) {
+    clearTimeout(flushTimer);
+    flushTimer = null;
+  }
+  if (buffer.length === 0)
+    return;
+  const data = buffer.join("");
+  buffer = [];
+  try {
+    const logFile = getMagicContextLogPath();
+    ensureDir5(logFile);
+    fs.appendFileSync(logFile, data);
+  } catch {}
+}
+function scheduleFlush() {
+  if (flushTimer)
+    return;
+  flushTimer = setTimeout(() => {
+    flushTimer = null;
+    flush();
+  }, FLUSH_INTERVAL_MS);
+}
+function log3(message, data) {
+  if (isTestEnv)
+    return;
+  try {
+    const timestamp = new Date().toISOString();
+    const serialized = data === undefined ? "" : data instanceof Error ? ` ${data.message}${data.stack ? `
+${data.stack}` : ""}` : ` ${JSON.stringify(data)}`;
+    buffer.push(`[${timestamp}] ${message}${serialized}
+`);
+    if (buffer.length >= BUFFER_SIZE_LIMIT) {
+      flush();
+    } else {
+      scheduleFlush();
+    }
+  } catch {}
+}
+var isTestEnv = false, buffer, flushTimer = null, FLUSH_INTERVAL_MS = 500, BUFFER_SIZE_LIMIT = 50, lastEnsuredDir = null;
+var init_logger = __esm(() => {
+  init_data_path();
+  buffer = [];
+  if (!isTestEnv) {
+    process.on("exit", flush);
+  }
+});
+
 // ../plugin/src/features/magic-context/memory/project-identity.ts
 import { execFileSync as execFileSync4 } from "node:child_process";
 import { createHash } from "node:crypto";
-import { statSync as statSync5 } from "node:fs";
-import path2 from "node:path";
+import { existsSync as existsSync13, realpathSync, statSync as statSync5 } from "node:fs";
+import path3 from "node:path";
 function asError(error) {
   return error instanceof Error ? error : undefined;
 }
@@ -13431,7 +13491,7 @@ function getErrorStderr(error) {
   return "";
 }
 function directoryFallback(directory) {
-  const canonical = path2.resolve(directory);
+  const canonical = path3.resolve(directory);
   const hash = createHash("md5").update(canonical, "utf8").digest("hex").slice(0, 12);
   return `dir:${hash}`;
 }
@@ -13469,21 +13529,27 @@ function classifyGitError(error, rawDirectory) {
     return new ProjectIdentityError("permission_denied", rawDirectory, "Permission denied while spawning git", asError(error));
   }
   const stderr = getErrorStderr(error).toLowerCase();
+  if (stderr.includes("detected dubious ownership")) {
+    return new ProjectIdentityError("dubious_ownership", rawDirectory, "git refused to read the repository because it detected dubious ownership", asError(error));
+  }
   if (stderr.includes("not a git repository") || stderr.includes("does not have any commits yet") || stderr.includes("ambiguous argument 'head'") || stderr.includes("unknown revision or path")) {
     return new ProjectIdentityError("not_git_repo", rawDirectory, "Directory has no git root commit; caller may use directory fallback", asError(error));
   }
   return new ProjectIdentityError("unknown", rawDirectory, "git rev-list failed while resolving project identity", asError(error));
 }
 function resolveProjectIdentityStrict(directory) {
-  const canonical = path2.resolve(directory);
+  const canonical = path3.resolve(directory);
   const cached = identityCache.get(canonical);
   if (cached !== undefined) {
     return cached;
   }
   assertDirectoryUsable(canonical, directory);
+  if (!hasGitDir(canonical)) {
+    throw new ProjectIdentityError("not_git_repo", directory, "Directory has no git metadata; caller may use directory fallback");
+  }
   let output;
   try {
-    output = execFileSync4("git", ["rev-list", "--max-parents=0", "HEAD"], {
+    output = execFileSyncForIdentity("git", ["rev-list", "--max-parents=0", "HEAD"], {
       cwd: canonical,
       encoding: "utf8",
       env: { ...process.env, LC_ALL: "C", LANG: "C" },
@@ -13501,13 +13567,76 @@ function resolveProjectIdentityStrict(directory) {
   }
   const identity = `git:${rootCommit}`;
   identityCache.set(canonical, identity);
+  lastKnownGitIdentityCache.set(canonical, identity);
+  transientFailureCooldown.delete(canonical);
+  dubiousOwnershipFallbackDirectories.delete(canonical);
+  transientGitIdentityReuseLoggedDirectories.delete(canonical);
   return identity;
 }
 function shouldUseDirectoryFallback(error) {
-  return error.errorClass === "not_git_repo" || error.errorClass === "unknown" && error.message.startsWith("Unable to access project directory:");
+  return error.errorClass !== "permission_denied";
+}
+function getActiveCooldown(canonical) {
+  const until = transientFailureCooldown.get(canonical);
+  if (until === undefined)
+    return;
+  if (nowMs() < until)
+    return until;
+  transientFailureCooldown.delete(canonical);
+  return;
+}
+function lastKnownGitIdentity(canonical) {
+  return lastKnownGitIdentityCache.get(canonical) ?? identityCache.get(canonical);
+}
+function nearestLastKnownGitIdentity(canonical) {
+  const visited = new Set;
+  const walk = (start) => {
+    let current = start;
+    while (!visited.has(current)) {
+      visited.add(current);
+      const cached = lastKnownGitIdentity(current);
+      if (cached !== undefined)
+        return { identity: cached, source: current };
+      const parent = path3.dirname(current);
+      if (parent === current)
+        break;
+      current = parent;
+    }
+    return;
+  };
+  const exactOrAncestor = walk(canonical);
+  if (exactOrAncestor)
+    return exactOrAncestor;
+  try {
+    const realCanonical = realpathSync.native(canonical);
+    if (realCanonical !== canonical)
+      return walk(realCanonical);
+  } catch {}
+  return;
+}
+function reuseLastKnownGitIdentity(canonical) {
+  const cached = nearestLastKnownGitIdentity(canonical);
+  if (cached === undefined)
+    return;
+  if (!transientGitIdentityReuseLoggedDirectories.has(canonical)) {
+    transientGitIdentityReuseLoggedDirectories.add(canonical);
+    const sourceNote = cached.source === canonical ? "" : ` from ancestor ${cached.source}`;
+    log3(`[magic-context] git identity resolution is temporarily unavailable for ${canonical}; reusing the last successful project identity${sourceNote} to avoid splitting project-scoped memory`);
+  }
+  return cached.identity;
+}
+function formatDubiousOwnershipWarning(canonical) {
+  return `Magic Context: git refused to read ${canonical} (dubious ownership — the repo is owned by a different user). Using a directory-based project identity for now, which keeps memory separate from this repo's normal identity. Fix: git config --global --add safe.directory ${canonical}`;
+}
+function recordDubiousOwnershipFallback(canonical) {
+  dubiousOwnershipFallbackDirectories.add(canonical);
+  if (dubiousOwnershipLoggedDirectories.has(canonical))
+    return;
+  dubiousOwnershipLoggedDirectories.add(canonical);
+  log3(`[magic-context] ${formatDubiousOwnershipWarning(canonical)}`);
 }
 function resolveProjectIdentity(directory) {
-  const canonical = path2.resolve(directory);
+  const canonical = path3.resolve(directory);
   const cachedFallback = directoryFallbackCache.get(canonical);
   if (cachedFallback !== undefined) {
     if (!hasGitDir(canonical)) {
@@ -13515,13 +13644,33 @@ function resolveProjectIdentity(directory) {
     }
     directoryFallbackCache.delete(canonical);
   }
+  if (getActiveCooldown(canonical) !== undefined) {
+    if (hasGitDir(canonical)) {
+      const cachedGitIdentity = reuseLastKnownGitIdentity(canonical);
+      if (cachedGitIdentity !== undefined) {
+        return cachedGitIdentity;
+      }
+    }
+    return directoryFallback(canonical);
+  }
   try {
     return resolveProjectIdentityStrict(directory);
   } catch (error) {
     if (error instanceof ProjectIdentityError && shouldUseDirectoryFallback(error)) {
       const fallback = directoryFallback(canonical);
-      if (!hasGitDir(canonical)) {
+      const hasGitMetadata = hasGitDir(canonical);
+      if (!hasGitMetadata) {
         directoryFallbackCache.set(canonical, fallback);
+        transientFailureCooldown.delete(canonical);
+      } else {
+        transientFailureCooldown.set(canonical, nowMs() + TRANSIENT_FAILURE_COOLDOWN_MS);
+        const cachedGitIdentity = reuseLastKnownGitIdentity(canonical);
+        if (cachedGitIdentity !== undefined) {
+          return cachedGitIdentity;
+        }
+      }
+      if (error.errorClass === "dubious_ownership") {
+        recordDubiousOwnershipFallback(canonical);
       }
       return fallback;
     }
@@ -13529,17 +13678,42 @@ function resolveProjectIdentity(directory) {
   }
 }
 function hasGitDir(canonical) {
-  try {
-    statSync5(path2.join(canonical, ".git"));
+  if (hasGitDirInAncestorChain(canonical)) {
     return true;
+  }
+  try {
+    const realCanonical = realpathSync.native(canonical);
+    return realCanonical !== canonical && hasGitDirInAncestorChain(realCanonical);
   } catch {
     return false;
   }
 }
-var GIT_TIMEOUT_MS = 5000, identityCache, directoryFallbackCache, ProjectIdentityError;
+function hasGitDirInAncestorChain(startDirectory) {
+  let current = startDirectory;
+  while (true) {
+    if (existsSync13(path3.join(current, ".git"))) {
+      return true;
+    }
+    const parent = path3.dirname(current);
+    if (parent === current) {
+      return false;
+    }
+    current = parent;
+  }
+}
+var GIT_TIMEOUT_MS = 5000, TRANSIENT_FAILURE_COOLDOWN_MS, identityCache, lastKnownGitIdentityCache, directoryFallbackCache, transientFailureCooldown, dubiousOwnershipFallbackDirectories, dubiousOwnershipLoggedDirectories, dubiousOwnershipWarnedDirectories, transientGitIdentityReuseLoggedDirectories, execFileSyncForIdentity, nowMs = () => Date.now(), ProjectIdentityError;
 var init_project_identity = __esm(() => {
+  init_logger();
+  TRANSIENT_FAILURE_COOLDOWN_MS = 5 * 60 * 1000;
   identityCache = new Map;
+  lastKnownGitIdentityCache = new Map;
   directoryFallbackCache = new Map;
+  transientFailureCooldown = new Map;
+  dubiousOwnershipFallbackDirectories = new Set;
+  dubiousOwnershipLoggedDirectories = new Set;
+  dubiousOwnershipWarnedDirectories = new Set;
+  transientGitIdentityReuseLoggedDirectories = new Set;
+  execFileSyncForIdentity = execFileSync4;
   ProjectIdentityError = class ProjectIdentityError extends Error {
     errorClass;
     rawDirectory;
@@ -13681,9 +13855,9 @@ __export(exports_migrate_session, {
   planMigrateSession: () => planMigrateSession,
   applyMigrateSession: () => applyMigrateSession
 });
-import { copyFileSync, existsSync as existsSync13, realpathSync } from "node:fs";
+import { copyFileSync, existsSync as existsSync14, realpathSync as realpathSync2 } from "node:fs";
 import { homedir as homedir8 } from "node:os";
-import path3, { join as join12 } from "node:path";
+import path4, { join as join12 } from "node:path";
 function existingSessionColumns(db) {
   const rows = db.prepare("PRAGMA table_info(session)").all();
   return new Set(rows.map((r2) => r2.name).filter((n2) => typeof n2 === "string"));
@@ -13711,7 +13885,7 @@ function planMigrateSession(sessionId, rawTargetDirectory, deps) {
     ocProjectId = "global";
     ocWorktree = globalRow.worktree || "/";
   }
-  const sessionPath = path3.relative(ocWorktree, targetDirectory);
+  const sessionPath = path4.relative(ocWorktree, targetDirectory);
   const ownershipRow = deps.contextDb.prepare("SELECT project_path FROM session_projects WHERE session_id = ? AND harness = 'opencode'").get(sessionId);
   const fromMcIdentity = ownershipRow?.project_path ?? (sessionRow.directory ? deps.resolveIdentity(sessionRow.directory) : "");
   const toMcIdentity = deps.resolveIdentity(targetDirectory);
@@ -13844,8 +14018,8 @@ function realDeps(opencodeDb, contextDb) {
     opencodeDb,
     contextDb,
     resolveIdentity: resolveProjectIdentity,
-    hasGitDir: (dir) => existsSync13(join12(dir, ".git")),
-    realpath: (p2) => realpathSync(p2)
+    hasGitDir: (dir) => existsSync14(join12(dir, ".git")),
+    realpath: (p2) => realpathSync2(p2)
   };
 }
 function valueAfter(args, flag) {
@@ -13923,7 +14097,7 @@ async function runMigrateSessionCli(args) {
     return 1;
   }
   const expandedTo = toDir.startsWith("~") ? join12(homedir8(), toDir.slice(1).replace(/^[/\\]/, "")) : toDir;
-  if (!existsSync13(expandedTo)) {
+  if (!existsSync14(expandedTo)) {
     console.error(`Target directory does not exist: ${expandedTo}`);
     return 1;
   }
@@ -14071,66 +14245,6 @@ var init_compartment_storage = __esm(() => {
   insertCompartmentStatements = new WeakMap;
   insertFactStatements = new WeakMap;
 });
-// ../plugin/src/shared/logger.ts
-import * as fs from "node:fs";
-import * as path4 from "node:path";
-function ensureDir5(filePath) {
-  const dir = path4.dirname(filePath);
-  if (dir === lastEnsuredDir)
-    return;
-  try {
-    fs.mkdirSync(dir, { recursive: true });
-    lastEnsuredDir = dir;
-  } catch {}
-}
-function flush() {
-  if (flushTimer) {
-    clearTimeout(flushTimer);
-    flushTimer = null;
-  }
-  if (buffer.length === 0)
-    return;
-  const data = buffer.join("");
-  buffer = [];
-  try {
-    const logFile = getMagicContextLogPath();
-    ensureDir5(logFile);
-    fs.appendFileSync(logFile, data);
-  } catch {}
-}
-function scheduleFlush() {
-  if (flushTimer)
-    return;
-  flushTimer = setTimeout(() => {
-    flushTimer = null;
-    flush();
-  }, FLUSH_INTERVAL_MS);
-}
-function log3(message, data) {
-  if (isTestEnv)
-    return;
-  try {
-    const timestamp = new Date().toISOString();
-    const serialized = data === undefined ? "" : data instanceof Error ? ` ${data.message}${data.stack ? `
-${data.stack}` : ""}` : ` ${JSON.stringify(data)}`;
-    buffer.push(`[${timestamp}] ${message}${serialized}
-`);
-    if (buffer.length >= BUFFER_SIZE_LIMIT) {
-      flush();
-    } else {
-      scheduleFlush();
-    }
-  } catch {}
-}
-var isTestEnv = false, buffer, flushTimer = null, FLUSH_INTERVAL_MS = 500, BUFFER_SIZE_LIMIT = 50, lastEnsuredDir = null;
-var init_logger = __esm(() => {
-  init_data_path();
-  buffer = [];
-  if (!isTestEnv) {
-    process.on("exit", flush);
-  }
-});
-
 // ../plugin/src/shared/sqlite-helpers.ts
 function closeQuietly(db) {
   if (!db)
@@ -148295,6 +148409,15 @@ var init_migrations = __esm(() => {
                 );
             `);
       }
+    },
+    {
+      version: 50,
+      description: "add durable ctx-wrapup session marker",
+      up(db) {
+        if (tableExists(db, "session_meta")) {
+          ensureColumn(db, "session_meta", "wrapup_in_progress_state", "TEXT");
+        }
+      }
     }
   ];
   LATEST_MIGRATION_VERSION = MIGRATIONS.reduce((max, m3) => Math.max(max, m3.version), 0);
@@ -148346,7 +148469,7 @@ var init_tool_definition_tokens = __esm(() => {
 });
 
 // ../plugin/src/features/magic-context/tool-owner-backfill.ts
-import { existsSync as existsSync14 } from "node:fs";
+import { existsSync as existsSync15 } from "node:fs";
 import { join as join13 } from "node:path";
 function resolveOpencodeDbPath() {
   return join13(getDataDir(), "opencode", "opencode.db");
@@ -148384,7 +148507,7 @@ function runToolOwnerBackfill(db) {
     return result;
   }
   const opencodeDbPath = resolveOpencodeDbPath();
-  if (!existsSync14(opencodeDbPath)) {
+  if (!existsSync15(opencodeDbPath)) {
     log3(`[backfill] OpenCode DB not found at ${opencodeDbPath} — marking all unbackfilled sessions as skipped. Lazy adoption (defense-in-depth) handles legacy rows at runtime.`);
     markAllUnbackfilledSessionsSkipped(db);
     result.sessionsSkippedNoOcDb = countSessionsByStatus(db, "skipped");
@@ -148608,7 +148731,7 @@ var init_tool_owner_backfill = __esm(() => {
 });
 
 // ../plugin/src/features/magic-context/storage-db.ts
-import { chmodSync as chmodSync2, copyFileSync as copyFileSync2, cpSync, existsSync as existsSync15, mkdirSync as mkdirSync7, mkdtempSync } from "node:fs";
+import { chmodSync as chmodSync2, copyFileSync as copyFileSync2, cpSync, existsSync as existsSync16, mkdirSync as mkdirSync7, mkdtempSync } from "node:fs";
 import { dirname as dirname8, join as join14 } from "node:path";
 function ensureSecureStorageDir(dir) {
   mkdirSync7(dir, { recursive: true, mode: 448 });
@@ -148625,7 +148748,7 @@ function restrictDatabaseFilePermissions(dbPath) {
     return;
   for (const suffix of ["", "-wal", "-shm"]) {
     const file = `${dbPath}${suffix}`;
-    if (!existsSync15(file))
+    if (!existsSync16(file))
       continue;
     try {
       chmodSync2(file, 384);
@@ -148648,11 +148771,11 @@ function resolveDatabasePath(dbPathOverride) {
   return { dbDir, dbPath: join14(dbDir, "context.db") };
 }
 function migrateLegacyStorageIfNeeded(targetDbPath, targetDbDir) {
-  if (existsSync15(targetDbPath))
+  if (existsSync16(targetDbPath))
     return;
   const legacyDir = getLegacyOpenCodeMagicContextStorageDir();
   const legacyDbPath = join14(legacyDir, "context.db");
-  if (!existsSync15(legacyDbPath))
+  if (!existsSync16(legacyDbPath))
     return;
   log3(`[magic-context] migrating legacy plugin storage: ${legacyDir} -> ${targetDbDir} (legacy left in place as backup)`);
   ensureSecureStorageDir(targetDbDir);
@@ -148669,7 +148792,7 @@ function migrateLegacyStorageIfNeeded(targetDbPath, targetDbDir) {
   for (const suffix of ["", "-wal", "-shm"]) {
     const src = `${legacyDbPath}${suffix}`;
     const dst = join14(targetDbDir, `context.db${suffix}`);
-    if (existsSync15(src)) {
+    if (existsSync16(src)) {
       try {
         copyFileSync2(src, dst);
       } catch (error) {
@@ -148679,7 +148802,7 @@ function migrateLegacyStorageIfNeeded(targetDbPath, targetDbDir) {
   }
   const legacyModelsDir = join14(legacyDir, "models");
   const targetModelsDir = join14(targetDbDir, "models");
-  if (existsSync15(legacyModelsDir) && !existsSync15(targetModelsDir)) {
+  if (existsSync16(legacyModelsDir) && !existsSync16(targetModelsDir)) {
     try {
       cpSync(legacyModelsDir, targetModelsDir, { recursive: true });
     } catch (error) {
@@ -149270,6 +149393,7 @@ CREATE INDEX IF NOT EXISTS idx_dream_queue_pending ON dream_queue(started_at, en
       force_emergency_bypass_used INTEGER NOT NULL DEFAULT 0,
       emergency_drain_active INTEGER NOT NULL DEFAULT 0,
       historian_drain_failure_at INTEGER NOT NULL DEFAULT 0,
+      wrapup_in_progress_state TEXT,
       cached_m0_materialized_at INTEGER,
       cached_m0_session_facts_version INTEGER,
       cached_m0_upgrade_state TEXT,
@@ -149558,6 +149682,7 @@ CREATE INDEX IF NOT EXISTS idx_dream_queue_pending ON dream_queue(started_at, en
   ensureColumn(db, "session_meta", "force_emergency_bypass_used", "INTEGER NOT NULL DEFAULT 0");
   ensureColumn(db, "session_meta", "emergency_drain_active", "INTEGER NOT NULL DEFAULT 0");
   ensureColumn(db, "session_meta", "historian_drain_failure_at", "INTEGER NOT NULL DEFAULT 0");
+  ensureColumn(db, "session_meta", "wrapup_in_progress_state", "TEXT");
   ensureColumn(db, "session_meta", "cached_m0_materialized_at", "INTEGER");
   ensureColumn(db, "session_meta", "cached_m0_session_facts_version", "INTEGER");
   ensureColumn(db, "session_meta", "cached_m0_upgrade_state", "TEXT");
@@ -149742,7 +149867,7 @@ function closeDatabase() {
     }
   }
 }
-var databases, persistenceByDatabase, persistenceErrorByDatabase, pathByDatabase, lastSchemaFenceRejection = null, LATEST_SUPPORTED_VERSION = 49, PERMISSIONS_ENFORCEABLE, sqlitePragmaConfig, CHANNEL2_CLAIM_TTL_MS = 120000;
+var databases, persistenceByDatabase, persistenceErrorByDatabase, pathByDatabase, lastSchemaFenceRejection = null, LATEST_SUPPORTED_VERSION = 50, PERMISSIONS_ENFORCEABLE, sqlitePragmaConfig, CHANNEL2_CLAIM_TTL_MS = 120000;
 var init_storage_db = __esm(async () => {
   init_data_path();
   init_logger();
@@ -149779,7 +149904,7 @@ var init_storage_memory_mutation_log = __esm(() => {
 });
 
 // ../plugin/src/features/magic-context/storage-meta-persisted.ts
-var AUTO_SEARCH_NO_HINT_REASONS, DRAIN_WINDOW_MS, EMERGENCY_DRAIN_MAX_LATCH_MS;
+var AUTO_SEARCH_NO_HINT_REASONS, DRAIN_WINDOW_MS, WRAPUP_IN_PROGRESS_TTL_MS, EMERGENCY_DRAIN_MAX_LATCH_MS;
 var init_storage_meta_persisted = __esm(() => {
   init_logger();
   init_storage_meta_shared();
@@ -149792,6 +149917,7 @@ var init_storage_meta_persisted = __esm(() => {
     "too-short"
   ]);
   DRAIN_WINDOW_MS = 10 * 60 * 1000;
+  WRAPUP_IN_PROGRESS_TTL_MS = 5 * 60 * 1000;
   EMERGENCY_DRAIN_MAX_LATCH_MS = 30 * 60 * 1000;
 });
 
@@ -149917,7 +150043,7 @@ var init_storage = __esm(async () => {
 
 // ../plugin/src/features/magic-context/v22-deferred-backfill.ts
 import { createHash as createHash2 } from "node:crypto";
-import { realpathSync as realpathSync2 } from "node:fs";
+import { realpathSync as realpathSync3 } from "node:fs";
 import path5 from "node:path";
 function readMeta(db, key) {
   const row = db.prepare("SELECT value FROM schema_migrations_meta WHERE key = ?").get(key);
@@ -149938,7 +150064,10 @@ function countFailures(db) {
 }
 function classifyBackfillError(error) {
   if (error instanceof ProjectIdentityError) {
-    return { errorClass: error.errorClass, errorMessage: error.message };
+    return {
+      errorClass: error.errorClass === "dubious_ownership" ? "unknown" : error.errorClass,
+      errorMessage: error.message
+    };
   }
   if (error instanceof Error) {
     return { errorClass: "unknown", errorMessage: error.message };
@@ -149958,7 +150087,7 @@ function resolveBackfillIdentity(rawProjectPath) {
 function computeLegacyRustDirIdentity(rawProjectPath) {
   let canonical;
   try {
-    canonical = realpathSync2(rawProjectPath);
+    canonical = realpathSync3(rawProjectPath);
   } catch {
     canonical = path5.isAbsolute(rawProjectPath) ? rawProjectPath : path5.join(process.cwd(), rawProjectPath);
   }
@@ -165422,7 +165551,6 @@ var init_magic_context = __esm(() => {
     enabled: exports_external.boolean().default(true).describe("Enable magic context (default: true)"),
     auto_update: exports_external.boolean().optional().describe("Enable automatic npm self-update checks for the OpenCode plugin. Security: USER-only in config loader, so hostile project configs cannot suppress updates."),
     language: exports_external.string().trim().toLowerCase().refine((s) => isValidLanguageCode(s), 'language must be a 2-letter ISO 639-1 code (e.g. "tr", "es", "de")').optional().describe("Output language for Magic Context's generated content and guidance, as a " + '2-letter ISO 639-1 code (e.g. "tr", "es", "de", "ja", "pt"). When set, the ' + "historian, dreamer, sidekick, and the agent-guidance block instruct the model to " + "write its PROSE in this language while keeping all structural tokens (XML tags, " + "the five memory category names, code identifiers, file paths) in English. " + "USER-LEVEL ONLY (ignored in project config for security). Unset = today's " + "behavior (model mirrors the conversation; English scaffolding). Changing it " + "triggers one cache re-materialization; existing compartments/memories keep their " + "original language until naturally rewritten."),
-    ctx_reduce_enabled: exports_external.boolean().default(true).describe("When false, ctx_reduce tool is hidden, all nudges disabled, and prompt guidance about ctx_reduce stripped. Heuristic cleanup, compartments, memory, and other features still work. (default: true)"),
     historian: HistorianConfigSchema.describe("Historian agent configuration (model, fallback_models, variant, temperature, maxTokens, permission, two_pass, etc.)"),
     dreamer: DreamerConfigSchema.optional().describe("Dreamer agent + scheduling configuration (model, fallback_models, disable, schedule, tasks, etc.)"),
     cache_ttl: exports_external.union([exports_external.string(), exports_external.object({ default: exports_external.string() }).catchall(exports_external.string())]).default("5m").describe('Cache TTL: string (e.g. "5m") or per-model object ({ default: "5m", "model-id": "10m" })'),
@@ -165461,9 +165589,9 @@ var init_magic_context = __esm(() => {
     keep_subagents: exports_external.boolean().default(false).describe("Debug: keep the child sessions Magic Context spawns for its own subagents (historian, dreamer, sidekick, memory-migration) instead of deleting them on success. Useful for short-term inspection/data collection — their full transcript (prompt, tool calls, token usage, output) stays in the host session store. Kept sessions accumulate until manually cleared; leave false for normal use. Requires a restart to take effect."),
     smart_drops: exports_external.boolean().default(false).describe("Content-aware reclaim of provably-superseded tool output, layered on the existing execute-pass auto-drop. When on: superseded todowrite (keep newest 1), spent ctx_reduce (keep newest 5), and zero-value meta (bash_status, bash_kill, ctx_note read/dismiss) outputs are dropped; older edits to a file are compressed to a filePath-preserving marker while the newest edit per file stays full. Only acts on passes already busting the cache, so it never originates a cache bust. Honors the protected-tag reserve. Experimental: opt-in, default off until cache stability is proven; when off the wire is byte-identical to the positional-only reclaim. Requires a restart."),
     caveman_text_compression: exports_external.object({
-      enabled: exports_external.boolean().default(false).describe("Apply deterministic caveman-style text compression to old conversation text. Only active when ctx_reduce_enabled=false. Compresses user/assistant text in oldest-first tiers: ultra (oldest 20%), full, lite, untouched (newest 40%)."),
+      enabled: exports_external.boolean().default(false).describe("Apply deterministic caveman-style text compression to old conversation text. Active for primary sessions when enabled; never for subagents. Compresses user/assistant text in oldest-first tiers: ultra (oldest 20%), full, lite, untouched (newest 40%)."),
       min_chars: exports_external.number().min(100).max(1e4).default(500).describe("Text parts shorter than this (characters) stay untouched. Min 100, max 10000. Default: 500.")
-    }).default({ enabled: false, min_chars: 500 }).describe("Age-tier caveman compression for long user/assistant text parts. Only active when ctx_reduce_enabled is false. Oldest 20% of eligible tags (outside protected tail) go to ultra, next 20% to full, next 20% to lite, newest 40% untouched. Graduated from experimental.caveman_text_compression; opt-in, default off (lossy)."),
+    }).default({ enabled: false, min_chars: 500 }).describe("Age-tier caveman compression for long user/assistant text parts. Active for primary sessions when enabled; never for subagents. Oldest 20% of eligible tags (outside protected tail) go to ultra, next 20% to full, next 20% to lite, newest 40% untouched. Graduated from experimental.caveman_text_compression; opt-in, default off (lossy)."),
     memory: exports_external.object({
       enabled: exports_external.boolean().default(true).describe("Enable cross-session memory (default: true)"),
       injection_budget_tokens: exports_external.number().min(500).max(20000).default(4000).describe("Token budget for memory injection on session start (min: 500, max: 20000, default: 4000)"),
@@ -165497,7 +165625,7 @@ var init_magic_context = __esm(() => {
 });
 
 // ../plugin/src/config/variable.ts
-import { existsSync as existsSync16, readFileSync as readFileSync8 } from "node:fs";
+import { existsSync as existsSync17, readFileSync as readFileSync8 } from "node:fs";
 import { homedir as homedir9 } from "node:os";
 import { dirname as dirname9, isAbsolute as isAbsolute2, resolve as resolve2 } from "node:path";
 function sensitiveFilePathReason(resolvedPath) {
@@ -165572,7 +165700,7 @@ function substituteConfigVariables(input) {
     if (sensitiveReason) {
       warnings.push(`${token} resolves to a sensitive path (${sensitiveReason}: ${filePath}); ` + "inlining its contents into config — make sure this is intentional.");
     }
-    if (!existsSync16(filePath)) {
+    if (!existsSync17(filePath)) {
       warnings.push(`File not found for ${token} (resolved to ${filePath}); using empty string`);
       continue;
     }
@@ -165597,7 +165725,7 @@ var init_variable = __esm(() => {
 });
 
 // ../plugin/src/config/index.ts
-import { existsSync as existsSync17, readFileSync as readFileSync9 } from "node:fs";
+import { existsSync as existsSync18, readFileSync as readFileSync9 } from "node:fs";
 function getUserConfigBasePath() {
   return cortexKitUserConfigBasePath();
 }
@@ -165605,10 +165733,10 @@ function getProjectConfigBasePath(directory) {
   return cortexKitProjectConfigBasePath(directory);
 }
 function resolveLegacyReadFallback(sources) {
-  return { source: sources.find((s) => existsSync17(s.path)) ?? null };
+  return { source: sources.find((s) => existsSync18(s.path)) ?? null };
 }
 function loadConfigFileDetailed(configPath, source) {
-  if (!existsSync17(configPath)) {
+  if (!existsSync18(configPath)) {
     return null;
   }
   let rawText;
@@ -165823,8 +165951,8 @@ function loadPluginConfigDetailed(directory) {
   const harnessLegacy = resolveLegacyConfigSourcesForHarness(directory, "opencode");
   const userLegacyFallback = userDetected.format === "none" ? resolveLegacyReadFallback(harnessLegacy.user) : { source: null };
   const projectLegacyFallback = projectDetected.format === "none" ? resolveLegacyReadFallback(harnessLegacy.project) : { source: null };
-  const legacyUserUnmigrated = userDetected.format === "none" && !userLegacyFallback.source && legacySources.user.some((source) => existsSync17(source.path));
-  const legacyProjectUnmigrated = projectDetected.format === "none" && !projectLegacyFallback.source && legacySources.project.some((source) => existsSync17(source.path));
+  const legacyUserUnmigrated = userDetected.format === "none" && !userLegacyFallback.source && legacySources.user.some((source) => existsSync18(source.path));
+  const legacyProjectUnmigrated = projectDetected.format === "none" && !projectLegacyFallback.source && legacySources.project.some((source) => existsSync18(source.path));
   const userLoaded = userDetected.format !== "none" ? loadConfigFileDetailed(userDetected.path, "user") : userLegacyFallback.source ? loadConfigFileDetailed(userLegacyFallback.source.path, "user") : null;
   const projectLoaded = projectDetected.format !== "none" ? loadConfigFileDetailed(projectDetected.path, "project") : projectLegacyFallback.source ? loadConfigFileDetailed(projectLegacyFallback.source.path, "project") : null;
   const allWarnings = [];
@@ -166009,7 +166137,7 @@ var DEFAULT_TIMEOUT_MS = 1e4, MAX_PREVIEW_CHARS = 240;
 // ../plugin/src/shared/tui-config.ts
 import {
   chmodSync as chmodSync3,
-  existsSync as existsSync18,
+  existsSync as existsSync19,
   mkdirSync as mkdirSync8,
   readFileSync as readFileSync10,
   renameSync as renameSync3,
@@ -166059,9 +166187,9 @@ function resolveTuiConfigPath() {
   const configDir = getOpenCodeConfigPaths({ binary: "opencode" }).configDir;
   const jsoncPath = join15(configDir, "tui.jsonc");
   const jsonPath = join15(configDir, "tui.json");
-  if (existsSync18(jsoncPath))
+  if (existsSync19(jsoncPath))
     return jsoncPath;
-  if (existsSync18(jsonPath))
+  if (existsSync19(jsonPath))
     return jsonPath;
   return jsoncPath;
 }
@@ -166069,7 +166197,7 @@ function ensureTuiPluginEntry() {
   try {
     const configPath = resolveTuiConfigPath();
     let config2 = {};
-    if (existsSync18(configPath)) {
+    if (existsSync19(configPath)) {
       const raw = readFileSync10(configPath, "utf-8");
       config2 = import_comment_json6.parse(raw) ?? {};
     }
@@ -166469,7 +166597,7 @@ var init_redaction2 = __esm(() => {
 });
 
 // src/lib/diagnostics-opencode.ts
-import { existsSync as existsSync19, readdirSync as readdirSync2, readFileSync as readFileSync11, statSync as statSync7 } from "node:fs";
+import { existsSync as existsSync20, readdirSync as readdirSync2, readFileSync as readFileSync11, statSync as statSync7 } from "node:fs";
 import { createRequire as createRequire2 } from "node:module";
 import { homedir as homedir11 } from "node:os";
 import { join as join16 } from "node:path";
@@ -166490,7 +166618,7 @@ function getPluginCacheInfo() {
   let cached2;
   for (const installedPkgPath of getOpenCodePluginPackageJsonPaths()) {
     try {
-      if (existsSync19(installedPkgPath)) {
+      if (existsSync20(installedPkgPath)) {
         const pkg = JSON.parse(readFileSync11(installedPkgPath, "utf-8"));
         cached2 = typeof pkg.version === "string" ? pkg.version : undefined;
         if (cached2)
@@ -166508,7 +166636,7 @@ function getStorageDir() {
 }
 function fileSize(path6) {
   try {
-    return existsSync19(path6) ? statSync7(path6).size : 0;
+    return existsSync20(path6) ? statSync7(path6).size : 0;
   } catch {
     return 0;
   }
@@ -166520,7 +166648,7 @@ function sanitizeValue(value) {
   return sanitizeConfigValue(value);
 }
 function readConfig2(path6) {
-  if (!existsSync19(path6))
+  if (!existsSync20(path6))
     return { value: null };
   try {
     const raw = readFileSync11(path6, "utf-8");
@@ -166581,7 +166709,7 @@ function parseHistorianDumpMeta(path6) {
   }
 }
 function listDumpsInDir(dir, limit) {
-  if (!existsSync19(dir))
+  if (!existsSync20(dir))
     return { count: 0, recent: [] };
   try {
     const entries = readdirSync2(dir).filter((name2) => name2.endsWith(".xml")).map((name2) => {
@@ -166650,7 +166778,7 @@ function collectHistorianDumps(recentSessions) {
 }
 async function collectRecentSessions() {
   const opencodeDbPath = join16(homedir11(), ".local", "share", "opencode", "opencode.db");
-  if (!existsSync19(opencodeDbPath))
+  if (!existsSync20(opencodeDbPath))
     return [];
   if (typeof globalThis.Bun === "undefined") {
     return [];
@@ -166685,7 +166813,7 @@ async function collectRecentSessions() {
 }
 async function collectHistorianFailures(storageDirPath) {
   const contextDbPath = join16(storageDirPath, "context.db");
-  if (!existsSync19(contextDbPath))
+  if (!existsSync20(contextDbPath))
     return [];
   if (typeof globalThis.Bun === "undefined") {
     return [];
@@ -166719,7 +166847,7 @@ async function collectHistorianFailures(storageDirPath) {
 }
 async function collectHistorianRuns(storageDirPath) {
   const contextDbPath = join16(storageDirPath, "context.db");
-  if (!existsSync19(contextDbPath))
+  if (!existsSync20(contextDbPath))
     return [];
   if (typeof globalThis.Bun === "undefined")
     return [];
@@ -166790,7 +166918,7 @@ async function collectDiagnostics() {
   const storageDirPath = getStorageDir();
   const contextDbPath = join16(storageDirPath, "context.db");
   const logPath = getMagicContextLogPath2("opencode");
-  const logFileSize = existsSync19(logPath) ? statSync7(logPath).size : 0;
+  const logFileSize = existsSync20(logPath) ? statSync7(logPath).size : 0;
   const conflictResult = detectConflicts(process.cwd());
   const recentSessions = await collectRecentSessions();
   const openCodeDetection = detectOpenCode();
@@ -166809,14 +166937,14 @@ async function collectDiagnostics() {
     opencodeConfigHasPlugin: configHasPluginEntry(opencodeConfig.value),
     tuiConfigHasPlugin: configHasPluginEntry(tuiConfig.value),
     magicContextConfig: {
-      exists: existsSync19(configPaths.magicContextConfig),
+      exists: existsSync20(configPaths.magicContextConfig),
       ...magicContextConfig.error ? { parseError: magicContextConfig.error } : {},
       flags: sanitizeValue(magicContextConfig.value ?? {}) ?? {}
     },
     pluginCache: getPluginCacheInfo(),
     storageDir: {
       path: storageDirPath,
-      exists: existsSync19(storageDirPath),
+      exists: existsSync20(storageDirPath),
       contextDbSizeBytes: fileSize(contextDbPath)
     },
     conflicts: {
@@ -166825,7 +166953,7 @@ async function collectDiagnostics() {
     },
     logFile: {
       path: logPath,
-      exists: existsSync19(logPath),
+      exists: existsSync20(logPath),
       sizeKb: Math.round(logFileSize / 1024)
     },
     recentSessions,
@@ -166964,9 +167092,113 @@ var init_diagnostics_opencode = __esm(() => {
 });
 
 // src/lib/embedding-runtime.ts
-import { existsSync as existsSync20 } from "node:fs";
+import { spawnSync as spawnSync2 } from "node:child_process";
+import { existsSync as existsSync21 } from "node:fs";
 import { createRequire as createRequire3 } from "node:module";
 import { dirname as dirname11, join as join17, sep } from "node:path";
+function describeError(error51) {
+  const message = error51 instanceof Error ? error51.message : String(error51 ?? "unknown error");
+  const code = error51?.code;
+  return typeof code === "string" && code.length > 0 ? `${code}: ${message}` : message;
+}
+function runOnnxRuntimeNodeLoadProbeChild(packageDir) {
+  return spawnSync2("node", ["-e", ONNX_RUNTIME_NODE_LOAD_PROBE_SCRIPT], {
+    encoding: "utf8",
+    env: { ...process.env, [ONNX_LOAD_PROBE_PACKAGE_DIR_ENV]: packageDir },
+    stdio: ["ignore", "pipe", "pipe"],
+    timeout: ONNX_LOAD_PROBE_TIMEOUT_MS
+  });
+}
+function outputText(output) {
+  if (typeof output === "string")
+    return output;
+  if (Buffer.isBuffer(output))
+    return output.toString("utf8");
+  return "";
+}
+function outputSnippet(output) {
+  const normalized = outputText(output).replace(/\s+/g, " ").trim();
+  if (normalized.length <= ONNX_LOAD_PROBE_OUTPUT_LIMIT)
+    return normalized;
+  return `${normalized.slice(0, ONNX_LOAD_PROBE_OUTPUT_LIMIT)}…`;
+}
+function stderrSuffix(result) {
+  const stderr = outputSnippet(result.stderr);
+  return stderr.length > 0 ? `; stderr: ${stderr}` : "";
+}
+function stdoutSuffix(result) {
+  const stdout2 = outputSnippet(result.stdout);
+  return stdout2.length > 0 ? `; stdout: ${stdout2}` : "";
+}
+function parseOnnxProbeVerdict(output) {
+  const candidates = output.trim().split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0).reverse();
+  for (const candidate of candidates) {
+    try {
+      const parsed = JSON.parse(candidate);
+      if (typeof parsed.ok === "boolean") {
+        return {
+          ok: parsed.ok,
+          reason: typeof parsed.reason === "string" ? parsed.reason : undefined
+        };
+      }
+    } catch {}
+  }
+  return null;
+}
+function probeOnnxRuntimeNodeLoad(packageDir) {
+  const result = runOnnxRuntimeNodeLoadProbeChildForRuntime(packageDir);
+  const errorCode = result.error?.code;
+  if (errorCode === "ETIMEDOUT") {
+    return {
+      state: "load-failed",
+      packageDir,
+      reason: `probe timed out after ${ONNX_LOAD_PROBE_TIMEOUT_MS}ms${stderrSuffix(result)}`
+    };
+  }
+  if (result.error) {
+    return {
+      state: "load-failed",
+      packageDir,
+      reason: `probe process failed: ${describeError(result.error)}${stderrSuffix(result)}`
+    };
+  }
+  if (result.signal) {
+    return {
+      state: "load-failed",
+      packageDir,
+      reason: `probe terminated by signal ${result.signal}${stderrSuffix(result)}`
+    };
+  }
+  if (typeof result.status === "number" && result.status !== 0) {
+    return {
+      state: "load-failed",
+      packageDir,
+      reason: `probe exited with code ${result.status}${stderrSuffix(result)}`
+    };
+  }
+  const verdict = parseOnnxProbeVerdict(outputText(result.stdout));
+  if (verdict?.ok === true)
+    return null;
+  if (verdict?.ok === false) {
+    return {
+      state: "load-failed",
+      packageDir,
+      reason: verdict.reason ?? "onnxruntime-node failed to load"
+    };
+  }
+  return {
+    state: "load-failed",
+    packageDir,
+    reason: `probe returned no JSON verdict${stdoutSuffix(result)}${stderrSuffix(result)}`
+  };
+}
+function isLocalEmbeddingRuntimeBroken(status) {
+  return status.state === "package-missing" || status.state === "binary-missing" || status.state === "load-failed";
+}
+function formatLocalEmbeddingRuntimeDoctorWarning(status) {
+  const cause = status.state === "package-missing" ? "package is not installed" : status.state === "binary-missing" ? "expected platform binding file is absent" : `binding failed to load: ${status.reason}`;
+  return "Embedding provider: local — onnxruntime-node native binding missing — " + `${cause}; its postinstall likely failed. Embeddings will not work. ` + "Reinstall with network access to the npm registry and GitHub releases, " + "or switch `embedding.provider` to an HTTP endpoint (`openai-compatible`).";
+}
 function expectedBinaryRelPath(platform, arch) {
   const supportedPlatform = platform === "linux" || platform === "darwin" || platform === "win32";
   const supportedArch = arch === "x64" || arch === "arm64";
@@ -166976,21 +167208,21 @@ function expectedBinaryRelPath(platform, arch) {
 }
 function checkLocalEmbeddingRuntimeAt(installRoot, platform = process.platform, arch = process.arch) {
   const packageDir = join17(installRoot, "node_modules", "onnxruntime-node");
-  if (!existsSync20(join17(packageDir, "package.json"))) {
+  if (!existsSync21(join17(packageDir, "package.json"))) {
     return { state: "package-missing", packageDir };
   }
   const rel = expectedBinaryRelPath(platform, arch);
   if (rel === null) {
-    return { state: "ok", binaryPath: packageDir };
+    return probeOnnxRuntimeNodeLoad(packageDir) ?? { state: "ok", binaryPath: packageDir };
   }
   const binaryPath = join17(packageDir, rel);
-  if (!existsSync20(binaryPath)) {
+  if (!existsSync21(binaryPath)) {
     return { state: "binary-missing", packageDir, expectedBinary: binaryPath };
   }
-  return { state: "ok", binaryPath };
+  return probeOnnxRuntimeNodeLoad(packageDir) ?? { state: "ok", binaryPath };
 }
 function checkLocalEmbeddingRuntime(installRoots, platform = process.platform, arch = process.arch) {
-  const existing = installRoots.filter((root) => existsSync20(root));
+  const existing = installRoots.filter((root) => existsSync21(root));
   if (existing.length === 0) {
     return {
       state: "unknown",
@@ -167013,7 +167245,7 @@ function packageDirFromResolved(resolvedPath, packageName) {
   return idx >= 0 ? resolvedPath.slice(0, idx + marker.length) : dirname11(resolvedPath);
 }
 function checkLocalEmbeddingRuntimeByResolution(pluginDir, platform = process.platform, arch = process.arch) {
-  if (!existsSync20(join17(pluginDir, "package.json"))) {
+  if (!existsSync21(join17(pluginDir, "package.json"))) {
     return { state: "unknown", reason: "plugin package dir not found" };
   }
   let onnxDir = null;
@@ -167046,15 +167278,37 @@ function checkLocalEmbeddingRuntimeByResolution(pluginDir, platform = process.pl
   }
   const rel = expectedBinaryRelPath(platform, arch);
   if (rel === null) {
-    return { state: "ok", binaryPath: onnxDir };
+    return probeOnnxRuntimeNodeLoad(onnxDir) ?? { state: "ok", binaryPath: onnxDir };
   }
   const binaryPath = join17(onnxDir, rel);
-  if (!existsSync20(binaryPath)) {
+  if (!existsSync21(binaryPath)) {
     return { state: "binary-missing", packageDir: onnxDir, expectedBinary: binaryPath };
   }
-  return { state: "ok", binaryPath };
-}
-var init_embedding_runtime = () => {};
+  return probeOnnxRuntimeNodeLoad(onnxDir) ?? { state: "ok", binaryPath };
+}
+var ONNX_LOAD_PROBE_TIMEOUT_MS = 1e4, ONNX_LOAD_PROBE_OUTPUT_LIMIT = 800, ONNX_LOAD_PROBE_PACKAGE_DIR_ENV = "MAGIC_CONTEXT_ONNX_RUNTIME_NODE_PACKAGE_DIR", ONNX_RUNTIME_NODE_LOAD_PROBE_SCRIPT, runOnnxRuntimeNodeLoadProbeChildForRuntime;
+var init_embedding_runtime = __esm(() => {
+  ONNX_RUNTIME_NODE_LOAD_PROBE_SCRIPT = [
+    'const { createRequire } = require("node:module");',
+    'const { join } = require("node:path");',
+    "function describe(error) {",
+    '  const message = error instanceof Error ? error.message : String(error ?? "unknown error");',
+    '  const code = error && typeof error === "object" && typeof error.code === "string" ? error.code : "";',
+    '  return code ? code + ": " + message : message;',
+    "}",
+    "try {",
+    `  const packageDir = process.env.${ONNX_LOAD_PROBE_PACKAGE_DIR_ENV};`,
+    `  if (!packageDir) throw new Error("${ONNX_LOAD_PROBE_PACKAGE_DIR_ENV} is not set");`,
+    '  const req = createRequire(join(packageDir, "package.json"));',
+    "  req(packageDir);",
+    "  process.stdout.write(JSON.stringify({ ok: true }));",
+    "} catch (error) {",
+    "  process.stdout.write(JSON.stringify({ ok: false, reason: describe(error) }));",
+    "}"
+  ].join(`
+`);
+  runOnnxRuntimeNodeLoadProbeChildForRuntime = runOnnxRuntimeNodeLoadProbeChild;
+});
 
 // src/lib/issue-body.ts
 function isErrorLogLine(line) {
@@ -167498,11 +167752,11 @@ function migrateExperimentalPinKeyFilesForDoctor(mcConfig) {
 }
 
 // src/commands/doctor-opencode-cache.ts
-import { existsSync as existsSync21, readFileSync as readFileSync13, rmSync as rmSync2 } from "node:fs";
+import { existsSync as existsSync22, readFileSync as readFileSync13, rmSync as rmSync2 } from "node:fs";
 function readCachedPluginVersion(pluginCacheDir) {
   try {
     const installedPkgPath = getOpenCodePluginPackageJsonPath(pluginCacheDir);
-    if (!existsSync21(installedPkgPath))
+    if (!existsSync22(installedPkgPath))
       return;
     const pkg = JSON.parse(readFileSync13(installedPkgPath, "utf-8"));
     return typeof pkg.version === "string" ? pkg.version : undefined;
@@ -167513,7 +167767,7 @@ function readCachedPluginVersion(pluginCacheDir) {
 async function clearPluginCache(options = {}, deps = {}) {
   const remove = deps.remove ?? ((path6) => rmSync2(path6, { recursive: true, force: true }));
   const pluginCacheRoots = getOpenCodePluginCacheRoots();
-  const existingRoots = pluginCacheRoots.filter((root) => existsSync21(root));
+  const existingRoots = pluginCacheRoots.filter((root) => existsSync22(root));
   if (existingRoots.length === 0) {
     return { action: "not_found", path: pluginCacheRoots[0] ?? "" };
   }
@@ -167578,8 +167832,8 @@ var init_doctor_opencode_cache = __esm(() => {
 });
 
 // src/commands/doctor-opencode.ts
-import { execSync as execSync2, spawnSync as spawnSync2 } from "node:child_process";
-import { existsSync as existsSync22, readFileSync as readFileSync14, statSync as statSync8 } from "node:fs";
+import { execSync as execSync2, spawnSync as spawnSync3 } from "node:child_process";
+import { existsSync as existsSync23, readFileSync as readFileSync14, statSync as statSync8 } from "node:fs";
 import { createRequire as createRequire4 } from "node:module";
 import { homedir as homedir13 } from "node:os";
 import { join as join19 } from "node:path";
@@ -167678,15 +167932,15 @@ function isGhInstalled() {
 function openBrowser(url2) {
   try {
     if (process.platform === "darwin") {
-      const child = spawnSync2("open", [url2], { stdio: "ignore" });
+      const child = spawnSync3("open", [url2], { stdio: "ignore" });
       if (child.status === 0)
         return;
     } else if (process.platform === "linux") {
-      const child = spawnSync2("xdg-open", [url2], { stdio: "ignore" });
+      const child = spawnSync3("xdg-open", [url2], { stdio: "ignore" });
       if (child.status === 0)
         return;
     } else if (process.platform === "win32") {
-      const child = spawnSync2("cmd", ["/c", "start", "", url2], { stdio: "ignore" });
+      const child = spawnSync3("cmd", ["/c", "start", "", url2], { stdio: "ignore" });
       if (child.status === 0)
         return;
     }
@@ -167730,7 +167984,7 @@ async function runIssueFlow() {
     s.stop(`Report written to ${bundled.path}`);
     const shouldSubmit = await confirm2("Submit this issue on GitHub now?", true);
     if (shouldSubmit && isGhInstalled()) {
-      const result = spawnSync2("gh", [
+      const result = spawnSync3("gh", [
         "issue",
         "create",
         "-R",
@@ -167764,15 +168018,15 @@ async function runIssueFlow() {
 }
 function checkLocalEmbeddingRuntimeForDoctor() {
   const runtime = checkLocalEmbeddingRuntime(getOpenCodePluginCacheRoots());
-  if (runtime.state === "package-missing" || runtime.state === "binary-missing") {
-    log2.warn("Embedding provider: local — but the native runtime (onnxruntime-node) " + `is ${runtime.state === "package-missing" ? "not installed" : "missing its platform binary"}. ` + "Local embeddings won't work. Fix: re-run with `doctor --force` to reinstall " + "the plugin, or set `embedding.provider` to `openai-compatible` (LM Studio / " + "Ollama) or `off`. Existing memories are unaffected.");
+  if (isLocalEmbeddingRuntimeBroken(runtime)) {
+    log2.warn(formatLocalEmbeddingRuntimeDoctorWarning(runtime));
     return { issues: 1, localRuntimeBroken: true };
   }
   log2.success("Embedding provider: local (Xenova/all-MiniLM-L6-v2 bundled)");
   return { issues: 0 };
 }
 async function checkEmbeddingConfig(magicContextConfigPath) {
-  if (!existsSync22(magicContextConfigPath)) {
+  if (!existsSync23(magicContextConfigPath)) {
     return checkLocalEmbeddingRuntimeForDoctor();
   }
   let rawText;
@@ -167948,7 +168202,7 @@ async function runDoctor(options = {}) {
   } else {
     pass(`OpenCode config: ${paths.opencodeConfig}`);
   }
-  if (existsSync22(paths.magicContextConfig)) {
+  if (existsSync23(paths.magicContextConfig)) {
     pass(`Magic Context config: ${paths.magicContextConfig}`);
     try {
       const raw = readFileSync14(paths.magicContextConfig, "utf-8");
@@ -167976,7 +168230,7 @@ async function runDoctor(options = {}) {
     warn(`No magic-context.jsonc found — using defaults`);
     log2.info("  Run 'setup' to create one with model recommendations");
   }
-  if (existsSync22(paths.magicContextConfig)) {
+  if (existsSync23(paths.magicContextConfig)) {
     try {
       const mcRaw = readFileSync14(paths.magicContextConfig, "utf-8");
       const mcConfig = import_comment_json8.parse(mcRaw);
@@ -168167,7 +168421,7 @@ async function runDoctor(options = {}) {
     pass("Added TUI sidebar plugin to tui.json");
     warn("Restart OpenCode to see the sidebar");
     fixed++;
-  } else if (existsSync22(paths.tuiConfig)) {
+  } else if (existsSync23(paths.tuiConfig)) {
     try {
       const tuiRaw = readFileSync14(paths.tuiConfig, "utf-8");
       const tuiConfig = import_comment_json8.parse(tuiRaw);
@@ -168215,7 +168469,7 @@ async function runDoctor(options = {}) {
   } else {
     pass("TUI sidebar plugin configured (tui.json created)");
   }
-  if (existsSync22(paths.magicContextConfig)) {
+  if (existsSync23(paths.magicContextConfig)) {
     try {
       const mcRaw = readFileSync14(paths.magicContextConfig, "utf-8");
       const mcConfig = import_comment_json8.parse(mcRaw);
@@ -168236,7 +168490,7 @@ async function runDoctor(options = {}) {
   else
     passCount++;
   const dbPath = join19(getMagicContextStorageDir(), "context.db");
-  if (!existsSync22(dbPath)) {
+  if (!existsSync23(dbPath)) {
     log2.info(`Shared context DB not yet created at ${dbPath} (will be created on first run)`);
   } else {
     pass(`Shared context DB exists at ${dbPath}`);
@@ -168304,7 +168558,7 @@ async function runDoctor(options = {}) {
   {
     const ageWarnings = [];
     const npmrcPath = join19(homedir13(), ".npmrc");
-    if (existsSync22(npmrcPath)) {
+    if (existsSync23(npmrcPath)) {
       try {
         const npmrc = readFileSync14(npmrcPath, "utf-8");
         for (const line of npmrc.split(`
@@ -168330,7 +168584,7 @@ async function runDoctor(options = {}) {
     }
   }
   const logPath = getMagicContextLogPath2("opencode");
-  if (existsSync22(logPath)) {
+  if (existsSync23(logPath)) {
     const logStat = statSync8(logPath);
     const sizeKb = (logStat.size / 1024).toFixed(0);
     log2.info(`Log file: ${logPath} (${sizeKb} KB)`);
@@ -168405,7 +168659,7 @@ var init_doctor_opencode = __esm(async () => {
 });
 
 // ../pi-plugin/src/config/index.ts
-import { existsSync as existsSync23, readFileSync as readFileSync15 } from "node:fs";
+import { existsSync as existsSync24, readFileSync as readFileSync15 } from "node:fs";
 function getProjectConfigPaths(cwd) {
   const basePath = cortexKitProjectConfigBasePath(cwd);
   return [`${basePath}.jsonc`, `${basePath}.json`];
@@ -168415,10 +168669,10 @@ function getUserConfigPaths() {
   return [`${basePath}.jsonc`, `${basePath}.json`];
 }
 function resolveFirstExisting(paths) {
-  return paths.find((path6) => existsSync23(path6));
+  return paths.find((path6) => existsSync24(path6));
 }
 function resolvePiLegacyFallback(sources) {
-  return sources.find((source) => existsSync23(source.path)) ?? null;
+  return sources.find((source) => existsSync24(source.path)) ?? null;
 }
 function loadConfigFile(path6, scope) {
   try {
@@ -168555,7 +168809,7 @@ function loadPiConfig(opts = {}) {
     if (loaded)
       loadedFiles.push(loaded);
   }
-  const legacyProjectUnmigrated = !projectPath && !projectLegacyFallback && legacySources.project.some((source) => existsSync23(source.path));
+  const legacyProjectUnmigrated = !projectPath && !projectLegacyFallback && legacySources.project.some((source) => existsSync24(source.path));
   const userPath = resolveFirstExisting(getUserConfigPaths());
   const userLegacyFallback = userPath ? null : resolvePiLegacyFallback(harnessLegacy.user);
   const userReadPath = userPath ?? userLegacyFallback?.path;
@@ -168564,7 +168818,7 @@ function loadPiConfig(opts = {}) {
     if (loaded)
       loadedFiles.push(loaded);
   }
-  const legacyUserUnmigrated = !userPath && !userLegacyFallback && legacySources.user.some((source) => existsSync23(source.path));
+  const legacyUserUnmigrated = !userPath && !userLegacyFallback && legacySources.user.some((source) => existsSync24(source.path));
   if (userLegacyFallback) {
     warnings.push(`[user config] reading legacy config from ${userLegacyFallback.path} until migration completes; run \`npx @cortexkit/magic-context doctor\` to consolidate into the shared CortexKit location.`);
   } else if (legacyUserUnmigrated) {
@@ -168618,7 +168872,7 @@ var init_config2 = __esm(() => {
 
 // src/lib/diagnostics-pi.ts
 import { createHash as createHash3 } from "node:crypto";
-import { existsSync as existsSync24, readdirSync as readdirSync3, readFileSync as readFileSync16, statSync as statSync9 } from "node:fs";
+import { existsSync as existsSync25, readdirSync as readdirSync3, readFileSync as readFileSync16, statSync as statSync9 } from "node:fs";
 import { createRequire as createRequire5 } from "node:module";
 import { homedir as homedir14, userInfo as userInfo2 } from "node:os";
 import { join as join20 } from "node:path";
@@ -168636,7 +168890,7 @@ function getSelfVersion3() {
 }
 function fileSize2(path6) {
   try {
-    return existsSync24(path6) ? statSync9(path6).size : 0;
+    return existsSync25(path6) ? statSync9(path6).size : 0;
   } catch {
     return 0;
   }
@@ -168686,7 +168940,7 @@ function sanitizeValue2(value, key = "") {
   return value;
 }
 function readJsonc3(path6) {
-  if (!existsSync24(path6))
+  if (!existsSync25(path6))
     return { value: {} };
   try {
     return {
@@ -168706,7 +168960,7 @@ function readConfigDiagnostic(path6) {
   const parsed = readJsonc3(path6);
   return {
     path: path6,
-    exists: existsSync24(path6),
+    exists: existsSync25(path6),
     ...parsed.parseError ? { parseError: parsed.parseError } : {},
     flags: sanitizeValue2(parsed.value)
   };
@@ -168724,7 +168978,7 @@ function reverseSlugToDirectory(slug) {
 }
 function collectPiRecentSessions() {
   const sessionsRoot = join20(homedir14(), ".pi", "agent", "sessions");
-  if (!existsSync24(sessionsRoot))
+  if (!existsSync25(sessionsRoot))
     return [];
   try {
     const slugs = readdirSync3(sessionsRoot, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => entry.name);
@@ -168793,7 +169047,7 @@ function parseHistorianDumpMeta2(path6) {
   }
 }
 function listDumpsInDir2(dir, limit) {
-  if (!existsSync24(dir))
+  if (!existsSync25(dir))
     return { count: 0, recent: [] };
   try {
     const entries = readdirSync3(dir).filter((name2) => name2.endsWith(".xml")).map((name2) => {
@@ -168871,7 +169125,7 @@ async function collectDiagnostics2(cwd = process.cwd()) {
   const storageDirPath = getMagicContextStorageDir();
   const dbPath = join20(storageDirPath, "context.db");
   const logPath = getMagicContextLogPath2("pi");
-  const logFileSize = existsSync24(logPath) ? statSync9(logPath).size : 0;
+  const logFileSize = existsSync25(logPath) ? statSync9(logPath).size : 0;
   const otherPiExtensions = packages.filter((entry) => !isPiMagicContextPackageEntry(entry)).map(describePiPackageEntry);
   const recentSessions = collectPiRecentSessions();
   const historianDumps = collectPiHistorianDumps(recentSessions);
@@ -168886,7 +169140,7 @@ async function collectDiagnostics2(cwd = process.cwd()) {
     piVersion: pi ? getPiVersion(pi.path) : null,
     settings: {
       path: settingsPath,
-      exists: existsSync24(settingsPath),
+      exists: existsSync25(settingsPath),
       ...settingsParsed.parseError ? { parseError: settingsParsed.parseError } : {},
       hasMagicContextPackage: hasPiMagicContextPackage(packages),
       packages: sanitizeValue2(packages)
@@ -168902,7 +169156,7 @@ async function collectDiagnostics2(cwd = process.cwd()) {
     loadWarnings: loaded.warnings.map(sanitizeString2),
     storageDir: {
       path: storageDirPath,
-      exists: existsSync24(storageDirPath),
+      exists: existsSync25(storageDirPath),
       contextDbSizeBytes: fileSize2(dbPath)
     },
     conflicts: {
@@ -168911,7 +169165,7 @@ async function collectDiagnostics2(cwd = process.cwd()) {
     },
     logFile: {
       path: logPath,
-      exists: existsSync24(logPath),
+      exists: existsSync25(logPath),
       sizeKb: Math.round(logFileSize / 1024)
     },
     recentSessions,
@@ -169082,8 +169336,8 @@ var init_logs_pi = __esm(() => {
 });
 
 // src/commands/doctor-pi.ts
-import { execFileSync as execFileSync5, spawnSync as spawnSync3 } from "node:child_process";
-import { existsSync as existsSync25, mkdirSync as mkdirSync9, readdirSync as readdirSync4, readFileSync as readFileSync18, rmSync as rmSync3, statSync as statSync10 } from "node:fs";
+import { execFileSync as execFileSync5, spawnSync as spawnSync4 } from "node:child_process";
+import { existsSync as existsSync26, mkdirSync as mkdirSync9, readdirSync as readdirSync4, readFileSync as readFileSync18, rmSync as rmSync3, statSync as statSync10 } from "node:fs";
 import { createRequire as createRequire6 } from "node:module";
 import { homedir as homedir15 } from "node:os";
 import { dirname as dirname12, isAbsolute as isAbsolute3, join as join22 } from "node:path";
@@ -169200,13 +169454,13 @@ function piPluginDirCandidates(packages, cwd) {
   }
   dirs.push(join22(agentDir, "npm", "node_modules", PACKAGE_NAME));
   dirs.push(join22(cwd, ".pi", "npm", "node_modules", PACKAGE_NAME));
-  return dirs.filter((dir) => existsSync25(join22(dir, "package.json")));
+  return dirs.filter((dir) => existsSync26(join22(dir, "package.json")));
 }
 function projectConfigPath(cwd) {
   return resolveCortexKitProjectConfigPath(cwd);
 }
 function readConfigForEmbedding(path6, isProjectConfig) {
-  if (!existsSync25(path6))
+  if (!existsSync26(path6))
     return null;
   try {
     const rawText = readFileSync18(path6, "utf-8");
@@ -169281,7 +169535,7 @@ function cacheRoots() {
 function findPiMagicContextCacheDirs(self, force = false) {
   const found = new Map;
   const visit = (path6, depth) => {
-    if (depth < 0 || !existsSync25(path6))
+    if (depth < 0 || !existsSync26(path6))
       return;
     let stat;
     try {
@@ -169292,7 +169546,7 @@ function findPiMagicContextCacheDirs(self, force = false) {
     if (!stat.isDirectory())
       return;
     const packageJson = join22(path6, "package.json");
-    if (existsSync25(packageJson)) {
+    if (existsSync26(packageJson)) {
       try {
         const pkg = JSON.parse(readFileSync18(packageJson, "utf-8"));
         const name2 = typeof pkg.name === "string" ? pkg.name : "";
@@ -169351,7 +169605,7 @@ async function runHealthChecks(options) {
   }
   const settingsPath = getPiUserExtensionsPath();
   let packages = [];
-  if (!existsSync25(settingsPath)) {
+  if (!existsSync26(settingsPath)) {
     add(results, "warn", `Pi settings not found at ${settingsPath}`);
     repairPlan.addPackageEntry = true;
   } else {
@@ -169375,7 +169629,7 @@ async function runHealthChecks(options) {
     ["user", userConfigPath, true],
     ["project", projectPath, false]
   ]) {
-    if (!existsSync25(path6)) {
+    if (!existsSync26(path6)) {
       if (required2) {
         add(results, "warn", `No ${label} magic-context.jsonc found at ${path6}`);
         if (userConfigMigrationRefused) {
@@ -169413,7 +169667,7 @@ async function runHealthChecks(options) {
   }
   const storageDir = getMagicContextStorageDir();
   const dbPath = join22(storageDir, "context.db");
-  const existedBeforeOpen = existsSync25(dbPath);
+  const existedBeforeOpen = existsSync26(dbPath);
   if (existedBeforeOpen)
     add(results, "pass", `Shared context DB exists at ${dbPath}`);
   else
@@ -169491,8 +169745,8 @@ async function runHealthChecks(options) {
         runtimeReported = true;
         break;
       }
-      if (runtime.state === "package-missing" || runtime.state === "binary-missing") {
-        add(results, "warn", `Embedding provider: local — native runtime (onnxruntime-node) is ${runtime.state === "package-missing" ? "not installed" : "missing its platform binary"}. Local embeddings won't work. Fix: reinstall the plugin, or set ` + "`embedding.provider` to `openai-compatible` (LM Studio / Ollama) or `off`. " + "Existing memories are unaffected.");
+      if (isLocalEmbeddingRuntimeBroken(runtime)) {
+        add(results, "warn", formatLocalEmbeddingRuntimeDoctorWarning(runtime));
         runtimeReported = true;
         break;
       }
@@ -169521,7 +169775,7 @@ async function runHealthChecks(options) {
     add(results, "pass", "Pi extension cache clean (no stale cached package found)");
   }
   const logPath = getMagicContextLogPath2("pi");
-  if (existsSync25(logPath)) {
+  if (existsSync26(logPath)) {
     const stat = statSync10(logPath);
     const sizeKb = (stat.size / 1024).toFixed(0);
     const lines = readFileSync18(logPath, "utf-8").split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
@@ -169581,7 +169835,7 @@ function repair(plan, prompts) {
   }
   if (plan.writeUserConfig) {
     const configPath = getPiUserConfigPath();
-    if (!existsSync25(configPath)) {
+    if (!existsSync26(configPath)) {
       try {
         writeDefaultMagicContextConfig(configPath);
         prompts.log.success(`Wrote default Magic Context config to ${configPath}`);
@@ -169790,7 +170044,7 @@ var init_doctor_pi = __esm(async () => {
     closeDatabase,
     now: () => new Date,
     execFileSync: execFileSync5,
-    spawnSync: spawnSync3
+    spawnSync: spawnSync4
   };
 });
 
@@ -169799,7 +170053,7 @@ var exports_doctor = {};
 __export(exports_doctor, {
   runDoctor: () => runDoctor3
 });
-import { existsSync as existsSync26, rmSync as rmSync4 } from "node:fs";
+import { existsSync as existsSync27, rmSync as rmSync4 } from "node:fs";
 async function runDoctor3(options) {
   if (options.clear)
     return runClear();
@@ -169888,7 +170142,7 @@ async function runClear() {
     const s = spinner2();
     s.start(`Clearing ${item.path}`);
     try {
-      if (existsSync26(item.path)) {
+      if (existsSync27(item.path)) {
         rmSync4(item.path, { recursive: true, force: true });
       }
       s.stop(`Cleared ${item.path}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cortexkit/magic-context",
-  "version": "0.30.7",
+  "version": "0.31.0",
   "description": "Unified CLI for Magic Context — setup, doctor, and migration across OpenCode and Pi",
   "keywords": [
     "opencode",