@cortexkit/magic-context 0.37.0 → 0.38.0

package/dist/index.js

@@ -3067,10 +3067,11 @@ function detectOmpBinary() {
   const candidate = candidates.find((path2) => isExecutableFile(path2));
   return candidate ? { path: candidate, source: "home" } : null;
 }
-function runOmpCommand(ompPath, args, timeout = 30000) {
+function runOmpCommand(ompPath, args, timeout = 30000, overrides = {}) {
+  const deps = { ...DEFAULT_COMMAND_EXECUTION_DEPS, ...overrides };
   try {
-    const invocation = getOmpCommandInvocation(ompPath, args);
-    const result = spawnSync2(invocation.command, invocation.args, {
+    const invocation = deps.getInvocation(ompPath, args);
+    const result = deps.spawnSync(invocation.command, invocation.args, {
       encoding: "utf-8",
       timeout,
       maxBuffer: 10 * 1024 * 1024,
@@ -3161,11 +3162,15 @@ function getOmpSetting(ompPath, key) {
     return null;
   }
 }
-var OMP_PLUGIN_PACKAGE = "@cortexkit/pi-magic-context";
+var OMP_PLUGIN_PACKAGE = "@cortexkit/pi-magic-context", DEFAULT_COMMAND_EXECUTION_DEPS;
 var init_omp_helpers = __esm(() => {
   init_find_on_path();
   init_paths();
   init_pi_helpers();
+  DEFAULT_COMMAND_EXECUTION_DEPS = {
+    getInvocation: getOmpCommandInvocation,
+    spawnSync: spawnSync2
+  };
 });
 
 // src/adapters/omp.ts
@@ -3176,14 +3181,18 @@ class OmpAdapter {
   kind = "omp";
   displayName = "Oh My Pi (OMP)";
   pluginPackageName = OMP_PLUGIN_PACKAGE;
+  deps;
+  constructor(deps = {}) {
+    this.deps = { ...DEFAULT_DEPS, ...deps };
+  }
   isInstalled() {
-    return detectOmpBinary() !== null;
+    return this.deps.detectOmpBinary() !== null;
   }
   hasPluginEntry() {
-    const omp = detectOmpBinary();
+    const omp = this.deps.detectOmpBinary();
     if (!omp)
       return false;
-    return listOmpPlugins(omp.path)?.some((plugin) => plugin.name === OMP_PLUGIN_PACKAGE && plugin.enabled) ?? false;
+    return this.deps.listOmpPlugins(omp.path)?.some((plugin) => plugin.name === OMP_PLUGIN_PACKAGE && plugin.enabled) ?? false;
   }
   getConfigPaths() {
     return {
@@ -3195,10 +3204,10 @@ class OmpAdapter {
   }
   async ensurePluginEntry() {
     const configPath = getOmpPluginsLockPath();
-    const omp = detectOmpBinary();
+    const omp = this.deps.detectOmpBinary();
     if (!omp)
       return this.errorResult(configPath, "OMP binary not found");
-    const plugins = listOmpPlugins(omp.path);
+    const plugins = this.deps.listOmpPlugins(omp.path);
     if (plugins === null) {
       return this.errorResult(configPath, "`omp plugin list --json` failed");
     }
@@ -3213,16 +3222,16 @@ class OmpAdapter {
     }
     const originalRuntimeEnabled = this.readRuntimeEnabled(configPath);
     const args = installed ? ["plugin", "enable", OMP_PLUGIN_PACKAGE] : ["plugin", "install", OMP_PLUGIN_PACKAGE];
-    const result = runOmpCommand(omp.path, args, 120000);
+    const result = this.deps.runOmpCommand(omp.path, args, 120000);
     if (!result.ok) {
       return this.errorResult(configPath, result.stderr || result.stdout || `omp ${args.join(" ")} failed`);
     }
-    const enabledAfter = listOmpPlugins(omp.path)?.some((plugin) => plugin.name === OMP_PLUGIN_PACKAGE && plugin.enabled);
+    const enabledAfter = this.deps.listOmpPlugins(omp.path)?.some((plugin) => plugin.name === OMP_PLUGIN_PACKAGE && plugin.enabled);
     if (!enabledAfter) {
       if (!installed) {
-        runOmpCommand(omp.path, ["plugin", "uninstall", OMP_PLUGIN_PACKAGE], 120000);
+        this.deps.runOmpCommand(omp.path, ["plugin", "uninstall", OMP_PLUGIN_PACKAGE], 120000);
       } else if (originalRuntimeEnabled !== undefined) {
-        runOmpCommand(omp.path, ["plugin", originalRuntimeEnabled ? "enable" : "disable", OMP_PLUGIN_PACKAGE], 120000);
+        this.deps.runOmpCommand(omp.path, ["plugin", originalRuntimeEnabled ? "enable" : "disable", OMP_PLUGIN_PACKAGE], 120000);
       }
       return this.errorResult(configPath, `${OMP_PLUGIN_PACKAGE} is still disabled in the current project after \`omp ${args.join(" ")}\``);
     }
@@ -3235,10 +3244,10 @@ class OmpAdapter {
   }
   async removePluginEntry() {
     const configPath = getOmpPluginsLockPath();
-    const omp = detectOmpBinary();
+    const omp = this.deps.detectOmpBinary();
     if (!omp)
       return this.errorResult(configPath, "OMP binary not found");
-    const plugins = listOmpPlugins(omp.path);
+    const plugins = this.deps.listOmpPlugins(omp.path);
     if (plugins === null) {
       return this.errorResult(configPath, "`omp plugin list --json` failed");
     }
@@ -3251,7 +3260,7 @@ class OmpAdapter {
         configPath
       };
     }
-    const result = runOmpCommand(omp.path, ["plugin", "uninstall", OMP_PLUGIN_PACKAGE], 120000);
+    const result = this.deps.runOmpCommand(omp.path, ["plugin", "uninstall", OMP_PLUGIN_PACKAGE], 120000);
     if (!result.ok) {
       return this.errorResult(configPath, result.stderr || result.stdout || "OMP plugin uninstall failed");
     }
@@ -3273,10 +3282,10 @@ class OmpAdapter {
     return getMagicContextLogPath2("pi");
   }
   getInstalledPluginVersion() {
-    const omp = detectOmpBinary();
+    const omp = this.deps.detectOmpBinary();
     if (!omp)
       return null;
-    return listOmpPlugins(omp.path)?.find((plugin) => plugin.name === OMP_PLUGIN_PACKAGE)?.version ?? null;
+    return this.deps.listOmpPlugins(omp.path)?.find((plugin) => plugin.name === OMP_PLUGIN_PACKAGE)?.version ?? null;
   }
   readRuntimeEnabled(configPath) {
     try {
@@ -3296,9 +3305,15 @@ class OmpAdapter {
     };
   }
 }
+var DEFAULT_DEPS;
 var init_omp = __esm(() => {
   init_omp_helpers();
   init_paths();
+  DEFAULT_DEPS = {
+    detectOmpBinary,
+    listOmpPlugins,
+    runOmpCommand
+  };
 });
 
 // ../../node_modules/.bun/esprima@4.0.1/node_modules/esprima/dist/esprima.js
@@ -11160,14 +11175,16 @@ var init_atomic_write = () => {};
 import { existsSync as existsSync7, realpathSync } from "node:fs";
 import { homedir as homedir6 } from "node:os";
 import { join as join8 } from "node:path";
-function defaultDeps() {
+function defaultDeps(overrides = {}) {
+  const env = overrides.env ?? process.env;
   return {
-    exists: existsSync7,
-    isExecutable: isExecutableFile,
-    home: process.env.HOME?.trim() || homedir6(),
-    platform: process.platform,
-    env: process.env,
-    onPath: findOnPath
+    exists: overrides.exists ?? existsSync7,
+    isExecutable: overrides.isExecutable ?? isExecutableFile,
+    home: overrides.home ?? (env.HOME?.trim() || homedir6()),
+    platform: overrides.platform ?? process.platform,
+    env,
+    onPath: overrides.onPath ?? findOnPath,
+    realpath: overrides.realpath
   };
 }
 function stockCliBinary(d) {
@@ -11246,7 +11263,7 @@ function desktopAppPaths(d) {
   }
 }
 function detectOpenCodeInstallations(deps) {
-  const d = { ...defaultDeps(), ...deps };
+  const d = defaultDeps(deps);
   const installations = [];
   const seenRealpaths = new Set;
   const onPath = d.onPath("opencode");
@@ -12736,31 +12753,28 @@ var init_setup_pi = __esm(() => {
 });
 
 // src/commands/setup-omp.ts
-async function runSetup2(options = {}) {
-  return runSetup({
-    ...options,
-    env: options.env ?? OMP_ENV,
-    host: options.host ?? OMP_HOST
-  });
+function resolveDeps(overrides = {}) {
+  return { ...DEFAULT_DEPS2, ...overrides };
 }
-var OMP_ENV, OMP_HOST;
-var init_setup_omp = __esm(() => {
-  init_harness_provider_map();
-  init_omp();
-  init_omp_helpers();
-  init_paths();
-  init_setup_pi();
-  OMP_ENV = {
-    detectPiBinary: detectOmpBinary,
-    getPiVersion: getOmpVersion,
-    getAvailableModels: getOmpAvailableModels,
+function createOmpEnvironment(deps) {
+  return {
+    detectPiBinary: deps.detectOmpBinary,
+    getPiVersion: deps.getOmpVersion,
+    getAvailableModels: deps.getOmpAvailableModels,
     paths: {
       getPiAgentConfigDir: getOmpAgentDir,
       getPiUserConfigPath: getOmpUserConfigPath,
       getPiUserExtensionsPath: getOmpPluginsLockPath
     }
   };
-  OMP_HOST = {
+}
+function createOmpHost(deps) {
+  const adapterDeps = {
+    detectOmpBinary: deps.detectOmpBinary,
+    listOmpPlugins: deps.listOmpPlugins,
+    runOmpCommand: deps.runOmpCommand
+  };
+  return {
     displayName: "Oh My Pi (OMP)",
     cliName: "omp",
     packageSource: OMP_PLUGIN_PACKAGE,
@@ -12768,13 +12782,13 @@ var init_setup_omp = __esm(() => {
     minimumVersion: "17.1.7",
     versionWarning: (version, minimum) => `OMP ${version} is older than the tested minimum ${minimum}. ` + "Upgrade with `omp update` before enabling Magic Context.",
     modelRefToCanonical: ompModelRefToCanonical,
-    ensurePluginEntry: async () => new OmpAdapter().ensurePluginEntry(),
+    ensurePluginEntry: async () => new OmpAdapter(adapterDeps).ensurePluginEntry(),
     beforeWrite: async ({ binaryPath, cwd, prompts, dryRun, configureHost }) => {
-      if (!configureHost && !new OmpAdapter().hasPluginEntry()) {
+      if (!configureHost && !new OmpAdapter(adapterDeps).hasPluginEntry()) {
         return async () => {};
       }
-      const compaction = getOmpSetting(binaryPath, "compaction.enabled");
-      const memoryBackend = getOmpSetting(binaryPath, "memory.backend");
+      const compaction = deps.getOmpSetting(binaryPath, "compaction.enabled");
+      const memoryBackend = deps.getOmpSetting(binaryPath, "memory.backend");
       if (compaction === null || memoryBackend === null) {
         prompts.log.error("Could not read OMP compaction/memory settings; refusing to install two context managers blindly.");
         return false;
@@ -12813,7 +12827,7 @@ Edit those files directly, then rerun setup.`);
       const applied = [];
       const rollback = async () => {
         for (const change of [...applied].reverse()) {
-          const result = runOmpCommand(binaryPath, ["config", "set", change.key, change.from], 1e4);
+          const result = deps.runOmpCommand(binaryPath, ["config", "set", change.key, change.from], 1e4);
           if (result.ok)
             prompts.log.info(`Restored OMP ${change.key}=${change.from}`);
           else
@@ -12821,7 +12835,7 @@ Edit those files directly, then rerun setup.`);
         }
       };
       for (const change of changes) {
-        const result = runOmpCommand(binaryPath, ["config", "set", change.key, change.to], 1e4);
+        const result = deps.runOmpCommand(binaryPath, ["config", "set", change.key, change.to], 1e4);
         if (!result.ok) {
           prompts.log.error(result.stderr || `Could not set OMP ${change.key}`);
           await rollback();
@@ -12835,13 +12849,40 @@ Edit those files directly, then rerun setup.`);
     rollbackPluginEntry: async (registration) => {
       if (registration.action === "already_present")
         return;
-      const omp = detectOmpBinary();
+      const omp = deps.detectOmpBinary();
       if (!omp)
         return;
       const action = registration.action === "added" ? "uninstall" : "disable";
-      runOmpCommand(omp.path, ["plugin", action, OMP_PLUGIN_PACKAGE], 120000);
+      deps.runOmpCommand(omp.path, ["plugin", action, OMP_PLUGIN_PACKAGE], 120000);
     }
   };
+}
+async function runSetup2(options = {}) {
+  const { deps: overrides, ...setupOptions } = options;
+  const deps = overrides ? resolveDeps(overrides) : DEFAULT_DEPS2;
+  return runSetup({
+    ...setupOptions,
+    env: setupOptions.env ?? (overrides ? createOmpEnvironment(deps) : OMP_ENV),
+    host: setupOptions.host ?? (overrides ? createOmpHost(deps) : OMP_HOST)
+  });
+}
+var DEFAULT_DEPS2, OMP_ENV, OMP_HOST;
+var init_setup_omp = __esm(() => {
+  init_harness_provider_map();
+  init_omp();
+  init_omp_helpers();
+  init_paths();
+  init_setup_pi();
+  DEFAULT_DEPS2 = {
+    detectOmpBinary,
+    getOmpVersion,
+    getOmpAvailableModels,
+    getOmpSetting,
+    listOmpPlugins,
+    runOmpCommand
+  };
+  OMP_ENV = createOmpEnvironment(DEFAULT_DEPS2);
+  OMP_HOST = createOmpHost(DEFAULT_DEPS2);
 });
 
 // ../plugin/src/shared/logger.ts
@@ -28245,7 +28286,7 @@ var init_magic_context = __esm(() => {
     output_reserve: exports_external.union([
       exports_external.number().min(0),
       exports_external.object({ default: exports_external.number().min(0) }).catchall(exports_external.number().min(0))
-    ]).optional().describe('User-only output-token reservation override. Number or per-model object ({ default: 16384, "provider/model": 8192 }); 0 disables reservation. When unset, Magic Context reserves the catalog output limit (capped at 25% of context) for shared-window providers and keeps proven separate-quota Google/Gemini windows unchanged.'),
+    ]).optional().describe('User-only output-token reservation override. Number or per-model object ({ default: 16384, "provider/model": 8192 }); 0 disables reservation. Takes precedence over every derived source: an explicit value here always wins against catalog output limits, provider window-geometry facts, and the 25%-of-context fallback (usable window = context window minus this reserve). When unset, Magic Context reserves the catalog output limit (capped at 25% of context) for shared-window providers and keeps proven separate-quota Google/Gemini windows unchanged.'),
     models: exports_external.object({
       window_overlay_path: exports_external.string().trim().min(1).optional()
     }).optional().describe("User-only Fusiform window-overlay settings. The path defaults to <dataDir>/fusiform/window-overlay.json."),
@@ -28300,7 +28341,7 @@ var init_magic_context = __esm(() => {
       overlay: exports_external.boolean().default(true).describe("Pi only: show the persistent todo overlay above the editor while tasks are active.")
     }).default({ enabled: true, overlay: true }).describe("Pi-only todowrite tool and overlay controls. Pi registers tools and widgets at extension boot, so changing this after /cd requires /reload or restart."),
     pi: PiConfigSchema.describe("Pi-only child-process extension controls. This setting is user-level only; project configuration cannot choose which extensions a user's subagent children load."),
-    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."),
+    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 3), 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. 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.")
@@ -29882,10 +29923,11 @@ function runOpenCode(args, binary, timeoutMs) {
 function getOpenCodeVersion(binary) {
   return runOpenCode(["--version"], binary, OPENCODE_VERSION_PROBE_TIMEOUT_MS);
 }
-function describeOpenCodeInstallations(installations) {
+function describeOpenCodeInstallations(installations, deps = {}) {
+  const getVersion = deps.getVersion ?? getOpenCodeVersion;
   return installations.map((installation, index) => ({
     ...installation,
-    version: installation.kind === "cli" ? getOpenCodeVersion(installation.path) ?? "unknown" : "unknown",
+    version: installation.kind === "cli" ? getVersion(installation.path) ?? "unknown" : "unknown",
     active: index === 0
   }));
 }
@@ -34338,6 +34380,51 @@ function readPsProcessCommand(pid) {
     return null;
   }
 }
+function readProcessCommand(pid) {
+  if (!Number.isInteger(pid) || pid <= 0)
+    return null;
+  return rpcIdentityPlatform === "linux" ? readLinuxProcessCommand(pid) : rpcIdentityPlatform === "win32" ? readWindowsProcess(pid).command ?? null : readPsProcessCommand(pid);
+}
+function executableName(token) {
+  return (token ?? "").replace(/^['"]|['"]$/g, "").split("/").at(-1) ?? "";
+}
+function commandTokens(command) {
+  return command.toLowerCase().replaceAll("\\", "/").replaceAll("\x00", " ").split(/\s+/).map((token) => token.replace(/^['"]|['"]$/g, "")).filter(Boolean);
+}
+function commandHasOpenCodeExecutable(tokens) {
+  return tokens.findIndex((token) => {
+    const executable = executableName(token).replace(/\.(?:exe|cmd)$/, "");
+    return executable === "opencode" || executable.endsWith("/opencode");
+  });
+}
+function commandHasPiExecutable(tokens) {
+  for (let index = 0;index < tokens.length; index += 1) {
+    const executable = executableName(tokens[index]).replace(/\.(?:exe|cmd)$/, "");
+    if (["pi", "omp", "oh-my-pi"].includes(executable))
+      return true;
+    if (["node", "bun", "deno"].includes(executable)) {
+      const script = executableName(tokens[index + 1]).replace(/\.(?:exe|cmd)$/, "");
+      if (["pi", "pi.js", "pi.mjs", "pi.cjs"].includes(script) || tokens[index + 1]?.includes("pi-coding-agent")) {
+        return true;
+      }
+    }
+  }
+  return false;
+}
+function classifyProcessKind(command) {
+  if (!command)
+    return "process";
+  const tokens = commandTokens(command);
+  const openCodeIndex = commandHasOpenCodeExecutable(tokens);
+  if (openCodeIndex >= 0) {
+    const args = tokens.slice(openCodeIndex + 1);
+    if (args.some((token) => token === "serve" || token === "--serve" || token.startsWith("--serve="))) {
+      return "OpenCode server";
+    }
+    return "OpenCode instance (TUI/CLI)";
+  }
+  return commandHasPiExecutable(tokens) ? "Pi" : "process";
+}
 function commandLooksLikeOpenCode(command) {
   const normalized = command.toLowerCase();
   return OPEN_CODE_COMMAND_MARKERS.some((marker) => normalized.includes(marker));
@@ -34359,12 +34446,12 @@ function isPidIdentityPlausible(record2) {
 function commandLooksLikePi(command) {
   const normalized = command.trim().toLowerCase().replaceAll("\\", "/");
   const tokens = normalized.split(/\s+/).filter(Boolean);
-  const executableName = (token) => (token ?? "").split("/").at(-1) ?? "";
-  const first = executableName(tokens[0]).replace(/\.exe$/, "");
+  const executableName2 = (token) => (token ?? "").split("/").at(-1) ?? "";
+  const first = executableName2(tokens[0]).replace(/\.exe$/, "");
   if (["pi", "pi.cmd", "omp", "oh-my-pi"].includes(first))
     return true;
   if (["node", "bun", "deno"].includes(first)) {
-    const script = executableName(tokens[1]);
+    const script = executableName2(tokens[1]);
     return ["pi", "pi.js", "pi.mjs", "pi.cjs"].includes(script) || normalized.includes("pi-coding-agent");
   }
   return false;
@@ -34434,6 +34521,8 @@ function parseRpcPortFile(content, fallbackPid = 0) {
         port: port2,
         pid,
         started_at: Number.isFinite(startedAt) ? startedAt : 0,
+        kind: typeof parsed.kind === "string" ? parsed.kind : undefined,
+        harness: typeof parsed.harness === "string" ? parsed.harness : undefined,
         token: typeof parsed.token === "string" ? parsed.token : undefined,
         instance_id: typeof parsed.instance_id === "string" ? parsed.instance_id : undefined
       };
@@ -37048,7 +37137,7 @@ import {
   statSync as statSync7,
   unlinkSync as unlinkSync2
 } from "node:fs";
-import { basename as basename3, dirname as dirname10, join as join14 } from "node:path";
+import { basename as basename3, dirname as dirname10, join as join14, resolve as resolve5 } from "node:path";
 function getPersistedSchemaVersion(db) {
   const hasMigrationsTable = db.prepare("SELECT 1 FROM sqlite_master WHERE type = 'table' AND name = 'schema_migrations'").get();
   if (!hasMigrationsTable) {
@@ -37080,6 +37169,28 @@ function invalidDiscoveryReason(raw) {
   }
   return "parse-invalid";
 }
+function classifyDiscoveryRecordKind(record2) {
+  for (const value of [record2.kind, record2.harness]) {
+    const normalized = value?.trim().toLowerCase();
+    if (!normalized)
+      continue;
+    if (normalized === "process")
+      return "process";
+    if (normalized === "opencode server" || normalized === "server") {
+      return "OpenCode server";
+    }
+    if (normalized === "opencode instance" || normalized === "opencode instance (tui/cli)" || normalized === "opencode" || normalized === "tui" || normalized === "cli") {
+      return "OpenCode instance (TUI/CLI)";
+    }
+    if (normalized === "pi" || normalized === "pi harness" || normalized === "omp" || normalized === "oh-my-pi") {
+      return "Pi";
+    }
+  }
+  return null;
+}
+function classifyRpcProcess(record2) {
+  return classifyDiscoveryRecordKind(record2) ?? classifyProcessKind(readProcessCommand(record2.pid));
+}
 function classifyJunkDiscovery(portFile, raw, staleFiles) {
   let mtimeMs;
   try {
@@ -37132,6 +37243,7 @@ function inspectRpcServerDiscovery(storageDir) {
     return { state: "absent", serverPids: [], staleFiles: [] };
   }
   const pids = new Set;
+  const processByPid = new Map;
   const staleFiles = [];
   const inconclusivePids = new Set;
   for (const portFile of portFiles) {
@@ -37157,6 +37269,14 @@ function inspectRpcServerDiscovery(storageDir) {
     const identity = liveness === "dead" ? "implausible" : isPidIdentityPlausible(record2);
     if (liveness === "alive" && identity === "plausible") {
       pids.add(record2.pid);
+      const detected = {
+        kind: classifyRpcProcess(record2),
+        pid: record2.pid
+      };
+      const previous = processByPid.get(record2.pid);
+      if (!previous || previous.kind === "process" && detected.kind !== "process") {
+        processByPid.set(record2.pid, detected);
+      }
     } else if (liveness === "dead" || identity === "implausible") {
       staleFiles.push(portFile);
     } else {
@@ -37172,7 +37292,12 @@ function inspectRpcServerDiscovery(storageDir) {
   }
   const serverPids = [...pids].sort((a3, b2) => a3 - b2);
   if (serverPids.length > 0) {
-    return { state: "live", serverPids, staleFiles };
+    return {
+      state: "live",
+      serverPids,
+      serverProcesses: serverPids.map((pid) => processByPid.get(pid) ?? { kind: "process", pid }),
+      staleFiles
+    };
   }
   const uncertainPids = [...inconclusivePids].sort((a3, b2) => a3 - b2);
   if (uncertainPids.length > 0) {
@@ -37187,8 +37312,8 @@ function inspectRpcServerDiscovery(storageDir) {
 }
 function getLiveMigrationBlockingProcesses(storageDir) {
   const discovery = inspectRpcServerDiscovery(storageDir);
-  const openCode = discovery.state === "live" ? discovery.serverPids.map((pid) => ({ harness: "OpenCode server", pid })) : [];
-  const pi = discoverLivePiProcessIds().map((pid) => ({ harness: "Pi harness", pid }));
+  const openCode = discovery.state === "live" ? discovery.serverProcesses ?? [] : [];
+  const pi = discoverLivePiProcessIds().map((pid) => ({ kind: "Pi", pid }));
   return [...openCode, ...pi];
 }
 function applySqliteTuningPragmas(db) {
@@ -38301,7 +38426,7 @@ CREATE INDEX IF NOT EXISTS idx_dream_queue_pending ON dream_queue(started_at, en
   ensureColumn(db, "message_history_index", "harness", "TEXT NOT NULL DEFAULT 'opencode'");
   ensureColumn(db, "workspaces", "share_categories", `TEXT NOT NULL DEFAULT '["CONSTRAINTS"]'`);
 }
-var databases, pendingAsyncOpens, persistenceByDatabase, persistenceErrorByDatabase, pathByDatabase, LATEST_SUPPORTED_VERSION = 78, PERMISSIONS_ENFORCEABLE, RPC_DISCOVERY_PARSE_GRACE_MS, defaultRpcDiscoveryFs, rpcDiscoveryFs, sqlitePragmaConfig;
+var databases, pendingAsyncOpens, persistenceByDatabase, persistenceErrorByDatabase, pathByDatabase, LATEST_SUPPORTED_VERSION = 78, PERMISSIONS_ENFORCEABLE, RPC_DISCOVERY_PARSE_GRACE_MS, defaultRpcDiscoveryFs, rpcDiscoveryFs, sqlitePragmaConfig, CHANNEL2_CLAIM_TTL_MS;
 var init_storage_db = __esm(async () => {
   init_data_path();
   init_logger();
@@ -38331,6 +38456,7 @@ var init_storage_db = __esm(async () => {
     cacheSizeMb: 64,
     mmapSizeMb: 0
   };
+  CHANNEL2_CLAIM_TTL_MS = 10 * 60000;
 });
 
 // src/lib/database-access.ts
@@ -39251,7 +39377,7 @@ function printHelp() {
 }
 async function runRepairDb(options = {}) {
   const prompts = options.prompts ?? promptIO;
-  const deps = { ...DEFAULT_DEPS, ...options.deps };
+  const deps = { ...DEFAULT_DEPS3, ...options.deps };
   const storageDir = options.storageDir ?? dirname11(options.dbPath ?? join16(getMagicContextStorageDir(), "context.db"));
   const dbPath = options.dbPath ?? join16(storageDir, "context.db");
   const stamp = timestamp(deps.now());
@@ -39421,7 +39547,7 @@ async function runRepairDbCli(args, options = {}) {
   }
   return runRepairDb(options);
 }
-var ROW_COUNT_TABLES, DATABASE_SUFFIXES, RECOGNIZABLE_TABLES, REPAIR_DB_EXIT, DEFAULT_DEPS, RECOVER_UNAVAILABLE_PATTERNS;
+var ROW_COUNT_TABLES, DATABASE_SUFFIXES, RECOGNIZABLE_TABLES, REPAIR_DB_EXIT, DEFAULT_DEPS3, RECOVER_UNAVAILABLE_PATTERNS;
 var init_doctor_repair_db = __esm(async () => {
   init_migrations();
   init_data_path();
@@ -39441,7 +39567,7 @@ var init_doctor_repair_db = __esm(async () => {
     unsalvageable: 2,
     refused: 3
   };
-  DEFAULT_DEPS = {
+  DEFAULT_DEPS3 = {
     now: () => new Date,
     sqliteExecutable: defaultSqliteExecutable(),
     inspectHolders: defaultInspectHolders
@@ -41576,7 +41702,7 @@ var init_redaction2 = __esm(() => {
 import { execFileSync as execFileSync5, spawnSync as spawnSync4 } from "node:child_process";
 import { existsSync as existsSync24, mkdirSync as mkdirSync9, readFileSync as readFileSync15 } from "node:fs";
 import { createRequire as createRequire2 } from "node:module";
-import { dirname as dirname13, join as join20, resolve as resolve5 } from "node:path";
+import { dirname as dirname13, join as join20, resolve as resolve6 } from "node:path";
 function parseSemver(value) {
   const match = value?.match(/(\d+)\.(\d+)\.(\d+)/);
   return match ? [Number(match[1]), Number(match[2]), Number(match[3])] : null;
@@ -41702,8 +41828,8 @@ async function runHealthChecks(options) {
     if (!reportedAgentDir.ok) {
       add(results, "warn", "Could not verify OMP active agent directory");
     } else {
-      const reportedPath = resolve5(reportedAgentDir.stdout);
-      const expectedPath = resolve5(getOmpAgentDir());
+      const reportedPath = resolve6(reportedAgentDir.stdout);
+      const expectedPath = resolve6(getOmpAgentDir());
       if (reportedPath === expectedPath) {
         add(results, "pass", `OMP agent directory resolved to ${getOmpAgentDir()}`);
       } else {
@@ -41875,8 +42001,8 @@ async function runIssueFlow(options) {
 }
 async function runDoctor(options = {}) {
   const deps = {
-    ...DEFAULT_DEPS2,
-    prompts: options.prompts ?? DEFAULT_DEPS2.prompts,
+    ...DEFAULT_DEPS4,
+    prompts: options.prompts ?? DEFAULT_DEPS4.prompts,
     ...options.deps
   };
   const prompts = options.prompts ?? deps.prompts;
@@ -41902,7 +42028,7 @@ async function runDoctor(options = {}) {
   prompts.log.message(`Summary: PASS ${second.pass} / WARN ${second.warn} / FAIL ${second.fail}`);
   return second.fail === 0 ? 0 : 1;
 }
-var import_comment_json8, MIN_OMP_VERSION = "17.1.7", DEFAULT_DEPS2;
+var import_comment_json8, MIN_OMP_VERSION = "17.1.7", DEFAULT_DEPS4;
 var init_doctor_omp = __esm(async () => {
   init_magic_context();
   init_data_path();
@@ -41916,7 +42042,7 @@ var init_doctor_omp = __esm(async () => {
   init_redaction2();
   await init_database_access();
   import_comment_json8 = __toESM(require_src3(), 1);
-  DEFAULT_DEPS2 = {
+  DEFAULT_DEPS4 = {
     prompts: promptIO,
     detectOmpBinary,
     getOmpVersion,
@@ -43352,25 +43478,391 @@ function migrateExperimentalPinKeyFilesForDoctor(mcConfig) {
   return true;
 }
 
+// ../plugin/src/hooks/auto-update-checker/constants.ts
+import { homedir as homedir16, platform } from "node:os";
+import { join as join25 } from "node:path";
+function getOpenCodeCacheRoot() {
+  if (platform() === "win32") {
+    return join25(process.env.LOCALAPPDATA ?? homedir16(), "opencode");
+  }
+  return join25(homedir16(), ".cache", "opencode");
+}
+function getOpenCodeConfigRoot() {
+  if (platform() === "win32") {
+    return join25(process.env.APPDATA ?? join25(homedir16(), "AppData", "Roaming"), "opencode");
+  }
+  return join25(process.env.XDG_CONFIG_HOME ?? join25(homedir16(), ".config"), "opencode");
+}
+var PACKAGE_NAME = "@cortexkit/opencode-magic-context", CACHE_DIR, USER_OPENCODE_CONFIG, USER_OPENCODE_CONFIG_JSONC;
+var init_constants2 = __esm(() => {
+  CACHE_DIR = join25(getOpenCodeCacheRoot(), "packages");
+  USER_OPENCODE_CONFIG = join25(getOpenCodeConfigRoot(), "opencode.json");
+  USER_OPENCODE_CONFIG_JSONC = join25(getOpenCodeConfigRoot(), "opencode.jsonc");
+});
+// ../plugin/src/hooks/auto-update-checker/types.ts
+var NpmPackageEnvelopeSchema, OpencodePluginTupleSchema, OpencodeConfigSchema, PackageJsonSchema;
+var init_types = __esm(() => {
+  init_zod();
+  NpmPackageEnvelopeSchema = exports_external.object({
+    "dist-tags": exports_external.record(exports_external.string(), exports_external.string()).optional().default({})
+  });
+  OpencodePluginTupleSchema = exports_external.tuple([exports_external.string(), exports_external.record(exports_external.string(), exports_external.unknown())]);
+  OpencodeConfigSchema = exports_external.object({
+    plugin: exports_external.array(exports_external.union([exports_external.string(), OpencodePluginTupleSchema])).optional()
+  });
+  PackageJsonSchema = exports_external.object({
+    name: exports_external.string().optional(),
+    version: exports_external.string().optional(),
+    dependencies: exports_external.record(exports_external.string(), exports_external.string()).optional()
+  }).passthrough();
+});
+
+// ../plugin/src/hooks/auto-update-checker/checker.ts
+import {
+  accessSync as accessSync2,
+  existsSync as existsSync28,
+  constants as fsConstants,
+  readFileSync as readFileSync19,
+  renameSync as renameSync6,
+  statSync as statSync11,
+  writeFileSync as writeFileSync8
+} from "node:fs";
+import { dirname as dirname16, isAbsolute as isAbsolute4, join as join26, resolve as resolve7 } from "node:path";
+function warn(message) {
+  log3(`WARN: ${message}`);
+}
+function isString(value) {
+  return typeof value === "string";
+}
+function pluginSpecifier(entry) {
+  return typeof entry === "string" ? entry : entry[0];
+}
+function getPluginEntries(config2) {
+  const parsed = OpencodeConfigSchema.safeParse(config2);
+  if (!parsed.success)
+    return [];
+  return (parsed.data.plugin ?? []).map(pluginSpecifier).filter(isString);
+}
+function parseJsonConfig(content) {
+  try {
+    return import_comment_json11.parse(content);
+  } catch (err) {
+    warn(`[auto-update-checker] Failed to parse OpenCode config: ${String(err)}`);
+    return null;
+  }
+}
+function getSurfaceConfigPaths(directory, surface) {
+  const name = surface === "server" ? "opencode" : "tui";
+  const globalDir = dirname16(USER_OPENCODE_CONFIG);
+  const dirs = [
+    globalDir,
+    directory,
+    join26(directory, ".opencode"),
+    process.env.OPENCODE_CONFIG_DIR
+  ].filter((value) => Boolean(value));
+  const paths = [];
+  for (const dir of dirs) {
+    for (const extension of ["json", "jsonc"]) {
+      const path6 = join26(dir, `${name}.${extension}`);
+      if (!paths.includes(path6))
+        paths.push(path6);
+    }
+  }
+  return paths;
+}
+function getWinningConfig(directory, surface) {
+  let winner = null;
+  for (const path6 of getSurfaceConfigPaths(directory, surface)) {
+    try {
+      if (!existsSync28(path6))
+        continue;
+      const parsed = parseJsonConfig(readFileSync19(path6, "utf-8"));
+      const entries = getPluginEntries(parsed);
+      if (entries.some((entry) => entry === PACKAGE_NAME || entry.startsWith(`${PACKAGE_NAME}@`))) {
+        if (winner) {
+          log3(`[auto-update-checker] ${surface} config ${winner.path} is shadowed by ${path6}`);
+        }
+        winner = { path: path6, entries };
+      }
+    } catch {}
+  }
+  return winner;
+}
+function findPluginEntry(directory, surface = "server") {
+  const winner = getWinningConfig(directory, surface);
+  if (!winner)
+    return null;
+  const entry = winner.entries.find((value) => value === PACKAGE_NAME || value.startsWith(`${PACKAGE_NAME}@`));
+  if (!entry)
+    return null;
+  const pinnedVersion = entry.startsWith(`${PACKAGE_NAME}@`) ? entry.slice(PACKAGE_NAME.length + 1) : null;
+  return {
+    entry,
+    isPinned: pinnedVersion !== null && pinnedVersion !== "latest",
+    pinnedVersion: pinnedVersion && pinnedVersion !== "latest" ? pinnedVersion : null,
+    configPath: winner.path
+  };
+}
+var import_comment_json11;
+var init_checker = __esm(() => {
+  init_logger();
+  init_constants2();
+  init_types();
+  import_comment_json11 = __toESM(require_src3(), 1);
+});
+
+// src/lib/opencode-plugin-schema-fence.ts
+import { existsSync as existsSync29, readdirSync as readdirSync4, readFileSync as readFileSync20 } from "node:fs";
+import { join as join27 } from "node:path";
+import { gunzipSync } from "node:zlib";
+function readPackageVersion(packageJsonPath) {
+  try {
+    if (!existsSync29(packageJsonPath))
+      return null;
+    const packageJson = JSON.parse(readFileSync20(packageJsonPath, "utf-8"));
+    if (packageJson.name !== OPENCODE_PLUGIN_NAME || typeof packageJson.version !== "string") {
+      return null;
+    }
+    return packageJson.version;
+  } catch {
+    return null;
+  }
+}
+function readFenceValue(text3) {
+  const values = new Set;
+  for (const match of text3.matchAll(FENCE_PATTERN)) {
+    const version2 = Number.parseInt(match[1] ?? "", 10);
+    if (Number.isFinite(version2))
+      values.add(version2);
+  }
+  return values.size === 1 ? [...values][0] ?? null : null;
+}
+function readFenceFromDist(packageDirectory) {
+  const distDirectory = join27(packageDirectory, "dist");
+  if (!existsSync29(distDirectory))
+    return null;
+  const pending = [distDirectory];
+  const fenceValues = new Set;
+  while (pending.length > 0) {
+    const directory = pending.pop();
+    if (!directory)
+      continue;
+    try {
+      for (const entry of readdirSync4(directory, { withFileTypes: true })) {
+        const path6 = join27(directory, entry.name);
+        if (entry.isDirectory()) {
+          pending.push(path6);
+          continue;
+        }
+        if (!entry.isFile() || !/\.(?:[cm]?js|ts)$/.test(entry.name))
+          continue;
+        const fence = readFenceValue(readFileSync20(path6, "utf-8"));
+        if (fence !== null)
+          fenceValues.add(fence);
+      }
+    } catch {
+      return null;
+    }
+  }
+  return fenceValues.size === 1 ? [...fenceValues][0] ?? null : null;
+}
+function findInstalledPluginPackage(cacheDirectory, specifier, requestedVersion) {
+  const directCacheRoot = join27(cacheDirectory, specifier);
+  const candidates = [directCacheRoot];
+  try {
+    for (const entry of readdirSync4(cacheDirectory, { withFileTypes: true })) {
+      if (!entry.isDirectory())
+        continue;
+      const candidate = join27(cacheDirectory, entry.name);
+      if (!candidates.includes(candidate))
+        candidates.push(candidate);
+    }
+  } catch {}
+  for (const cacheRoot of candidates) {
+    const directory = join27(cacheRoot, "node_modules", ...PACKAGE_PATH_SEGMENTS);
+    const version2 = readPackageVersion(join27(directory, "package.json"));
+    if (!version2)
+      continue;
+    if (cacheRoot === directCacheRoot || EXACT_VERSION_PATTERN.test(requestedVersion) && version2 === requestedVersion) {
+      return { directory, version: version2 };
+    }
+  }
+  return null;
+}
+function readTarText(bytes, offset, length) {
+  const end = Math.min(offset + length, bytes.length);
+  let nul = offset;
+  while (nul < end && bytes[nul] !== 0)
+    nul++;
+  return new TextDecoder().decode(bytes.subarray(offset, nul));
+}
+function readTarOctal(bytes, offset, length) {
+  const value = readTarText(bytes, offset, length).trim();
+  if (!/^[0-7]+$/.test(value))
+    return null;
+  const parsed = Number.parseInt(value, 8);
+  return Number.isFinite(parsed) ? parsed : null;
+}
+function readFenceFromNpmTarball(tarball) {
+  let archive;
+  try {
+    archive = gunzipSync(tarball);
+  } catch {
+    return null;
+  }
+  const fenceValues = new Set;
+  for (let offset = 0;offset + 512 <= archive.length; ) {
+    const name = readTarText(archive, offset, 100);
+    if (!name)
+      break;
+    const prefix = readTarText(archive, offset + 345, 155);
+    const path6 = prefix ? `${prefix}/${name}` : name;
+    const size = readTarOctal(archive, offset + 124, 12);
+    if (size === null)
+      return null;
+    const contentStart = offset + 512;
+    const contentEnd = contentStart + size;
+    if (contentEnd > archive.length)
+      return null;
+    if (/^package\/dist\/.+\.(?:[cm]?js|ts)$/.test(path6)) {
+      const fence = readFenceValue(new TextDecoder().decode(archive.subarray(contentStart, contentEnd)));
+      if (fence !== null)
+        fenceValues.add(fence);
+    }
+    offset = contentStart + Math.ceil(size / 512) * 512;
+  }
+  return fenceValues.size === 1 ? [...fenceValues][0] ?? null : null;
+}
+function npmPackageVersionUrl(version2) {
+  const packagePath = encodeURIComponent(OPENCODE_PLUGIN_NAME).replace("%2F", "/");
+  return `https://registry.npmjs.org/${packagePath}/${encodeURIComponent(version2)}`;
+}
+async function resolveFenceFromNpmTarball(requestedVersion, fetchImpl) {
+  const controller = new AbortController;
+  const timeout = setTimeout(() => controller.abort(), NPM_TIMEOUT_MS);
+  try {
+    const metadataResponse = await fetchImpl(npmPackageVersionUrl(requestedVersion), {
+      signal: controller.signal,
+      headers: { Accept: "application/json" }
+    });
+    if (!metadataResponse.ok)
+      return null;
+    const metadata = await metadataResponse.json();
+    if (typeof metadata.version !== "string" || typeof metadata.dist?.tarball !== "string") {
+      return null;
+    }
+    const tarballUrl = new URL(metadata.dist.tarball);
+    if (tarballUrl.protocol !== "https:")
+      return null;
+    const tarballResponse = await fetchImpl(tarballUrl, { signal: controller.signal });
+    if (!tarballResponse.ok)
+      return null;
+    const contentLength = Number(tarballResponse.headers.get("content-length"));
+    if (Number.isFinite(contentLength) && contentLength > MAX_TARBALL_BYTES)
+      return null;
+    const tarball = new Uint8Array(await tarballResponse.arrayBuffer());
+    if (tarball.byteLength > MAX_TARBALL_BYTES)
+      return null;
+    const supportedVersion = readFenceFromNpmTarball(tarball);
+    return supportedVersion === null ? null : { version: metadata.version, supportedVersion, source: "npm-tarball" };
+  } catch {
+    return null;
+  } finally {
+    clearTimeout(timeout);
+  }
+}
+async function resolvePluginFence(specifier, requestedVersion, deps) {
+  const installed = findInstalledPluginPackage(deps.getOpenCodePluginCacheDir(), specifier, requestedVersion);
+  if (installed) {
+    const supportedVersion = readFenceFromDist(installed.directory);
+    if (supportedVersion !== null) {
+      return { version: installed.version, supportedVersion, source: "installed" };
+    }
+  }
+  return resolveFenceFromNpmTarball(requestedVersion, deps.fetch);
+}
+async function inspectPinnedOpenCodePluginSchemaFences(options, deps = {}) {
+  const findEntry = deps.findPluginEntry ?? findPluginEntry;
+  const resolutionDeps = {
+    fetch: deps.fetch ?? globalThis.fetch,
+    getOpenCodePluginCacheDir: deps.getOpenCodePluginCacheDir ?? getOpenCodePluginCacheDir
+  };
+  const resolvedBySpecifier = new Map;
+  const findings = [];
+  for (const surface of ["server", "tui"]) {
+    const entry = findEntry(options.directory, surface);
+    if (!entry?.isPinned || !entry.pinnedVersion)
+      continue;
+    let resolved = resolvedBySpecifier.get(entry.entry);
+    if (!resolved) {
+      resolved = resolvePluginFence(entry.entry, entry.pinnedVersion, resolutionDeps);
+      resolvedBySpecifier.set(entry.entry, resolved);
+    }
+    const fence = await resolved;
+    const supportedVersion = fence?.supportedVersion ?? null;
+    findings.push({
+      status: supportedVersion === null ? "unknown" : supportedVersion < options.databaseVersion ? "fail" : "pass",
+      surface,
+      specifier: entry.entry,
+      configPath: entry.configPath,
+      pinnedVersion: fence?.version ?? entry.pinnedVersion,
+      databaseVersion: options.databaseVersion,
+      supportedVersion,
+      source: fence?.source ?? null
+    });
+  }
+  return findings;
+}
+var PACKAGE_PATH_SEGMENTS, MAX_TARBALL_BYTES, NPM_TIMEOUT_MS = 5000, FENCE_PATTERN, EXACT_VERSION_PATTERN;
+var init_opencode_plugin_schema_fence = __esm(() => {
+  init_checker();
+  init_opencode_plugin_cache();
+  init_paths();
+  PACKAGE_PATH_SEGMENTS = OPENCODE_PLUGIN_NAME.split("/");
+  MAX_TARBALL_BYTES = 25 * 1024 * 1024;
+  FENCE_PATTERN = /\bLATEST_SUPPORTED_VERSION\s*=\s*(\d+)\b/g;
+  EXACT_VERSION_PATTERN = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/;
+});
+
 // ../plugin/src/features/magic-context/fail-closed-block.ts
+function normalizeFailClosedProcessKind(process3) {
+  switch (process3.kind) {
+    case "OpenCode server":
+    case "OpenCode instance (TUI/CLI)":
+    case "Pi":
+    case "process":
+      return process3.kind;
+  }
+  switch (process3.harness?.trim().toLowerCase()) {
+    case "opencode server":
+      return "OpenCode server";
+    case "opencode instance (tui/cli)":
+    case "opencode instance":
+      return "OpenCode instance (TUI/CLI)";
+    case "pi":
+    case "pi harness":
+    case "omp":
+      return "Pi";
+    default:
+      return "process";
+  }
+}
 function formatFailClosedBlockingProcesses(processes) {
   const uniqueProcesses = new Map;
   for (const process3 of processes) {
-    if (!process3.harness.trim() || !Number.isInteger(process3.pid) || process3.pid <= 0)
+    if (!Number.isInteger(process3.pid) || process3.pid <= 0)
       continue;
-    uniqueProcesses.set(`${process3.harness}\x00${process3.pid}`, {
-      harness: process3.harness.trim(),
-      pid: process3.pid
-    });
+    const kind = normalizeFailClosedProcessKind(process3);
+    uniqueProcesses.set(`${kind}\x00${process3.pid}`, { kind, pid: process3.pid });
   }
   const entries = [...uniqueProcesses.values()];
   const visible = entries.slice(0, MAX_FORMATTED_BLOCKING_PROCESSES);
-  const rendered = visible.map(({ harness, pid }) => `${harness} (PID ${pid})`);
+  const rendered = visible.map(({ kind, pid }) => `${kind} (PID ${pid})`);
   const omitted = entries.length - visible.length;
   if (omitted > 0)
     rendered.push(`${omitted} more blocking process(es)`);
   if (rendered.length === 0)
-    return "a live harness process";
+    return "a live process";
   if (rendered.length === 1)
     return rendered[0];
   const last = rendered.pop();
@@ -43380,9 +43872,9 @@ function formatFailClosedBlockingMessage(reason) {
   if (reason.kind === "migration_guard") {
     if (reason.unreadableFile) {
       const arm = reason.unreadableArm ?? "io";
-      const recovery = arm === "io" ? `If no OpenCode server is running, it is safe to delete ${reason.unreadableFile} and retry.` : `The file may be a recent incomplete write; retry after the file is older than the ten-minute grace window, or stop OpenCode before deleting it.`;
+      const recovery = arm === "io" ? `If none of these processes are running, it is safe to delete ${reason.unreadableFile} and retry.` : `The file may be a recent incomplete write; retry after the file is older than the ten-minute grace window, or stop the relevant process before deleting it.`;
       return [
-        `Magic Context cannot migrate the shared database because RPC discovery file ${reason.unreadableFile} is uncertain (${arm} arm), so the absence of a live OpenCode server cannot be proven.`,
+        `Magic Context cannot migrate the shared database because RPC discovery file ${reason.unreadableFile} is uncertain (${arm} arm), so the absence of a live process cannot be proven.`,
         recovery,
         `Recovery: ${FAIL_CLOSED_DOCTOR_COMMAND}`
       ].join(" ");
@@ -43461,13 +43953,13 @@ var init_storage_versions = __esm(async () => {
 });
 
 // src/commands/doctor-opencode-cache.ts
-import { existsSync as existsSync28, readFileSync as readFileSync19, rmSync as rmSync3 } from "node:fs";
+import { existsSync as existsSync30, readFileSync as readFileSync21, rmSync as rmSync3 } from "node:fs";
 function readCachedPluginVersion(pluginCacheDir) {
   try {
     const installedPkgPath = getOpenCodePluginPackageJsonPath(pluginCacheDir);
-    if (!existsSync28(installedPkgPath))
+    if (!existsSync30(installedPkgPath))
       return;
-    const pkg = JSON.parse(readFileSync19(installedPkgPath, "utf-8"));
+    const pkg = JSON.parse(readFileSync21(installedPkgPath, "utf-8"));
     return typeof pkg.version === "string" ? pkg.version : undefined;
   } catch {
     return;
@@ -43476,7 +43968,7 @@ function readCachedPluginVersion(pluginCacheDir) {
 async function clearPluginCache(options = {}, deps = {}) {
   const remove = deps.remove ?? ((path6) => rmSync3(path6, { recursive: true, force: true }));
   const pluginCacheRoots = getOpenCodePluginCacheRoots();
-  const existingRoots = pluginCacheRoots.filter((root) => existsSync28(root));
+  const existingRoots = pluginCacheRoots.filter((root) => existsSync30(root));
   if (existingRoots.length === 0) {
     return { action: "not_found", path: pluginCacheRoots[0] ?? "" };
   }
@@ -43544,10 +44036,10 @@ var init_doctor_opencode_cache = __esm(() => {
 
 // src/commands/doctor-opencode.ts
 import { execSync as execSync2, spawnSync as spawnSync6 } from "node:child_process";
-import { existsSync as existsSync29, readFileSync as readFileSync20, statSync as statSync11 } from "node:fs";
+import { existsSync as existsSync31, readFileSync as readFileSync22, statSync as statSync12 } from "node:fs";
 import { createRequire as createRequire5 } from "node:module";
-import { homedir as homedir16 } from "node:os";
-import { join as join25 } from "node:path";
+import { homedir as homedir17 } from "node:os";
+import { join as join28 } from "node:path";
 function resolveCompactionEnabledForDoctor() {
   try {
     const config2 = loadPluginConfig(process.cwd());
@@ -43646,15 +44138,15 @@ function getUserNpmrcPath() {
   if (custom2)
     return custom2;
   const home = process.env.HOME?.trim();
-  return join25(home || homedir16(), ".npmrc");
+  return join28(home || homedir17(), ".npmrc");
 }
 function collectNpmReleaseAgeWarnings() {
   const ageWarnings = [];
   const npmrcPath = getUserNpmrcPath();
-  if (!existsSync29(npmrcPath))
+  if (!existsSync31(npmrcPath))
     return ageWarnings;
   try {
-    const npmrc = readFileSync20(npmrcPath, "utf-8");
+    const npmrc = readFileSync22(npmrcPath, "utf-8");
     for (const line of npmrc.split(`
 `)) {
       const trimmed = line.trim();
@@ -43793,12 +44285,12 @@ function checkLocalEmbeddingRuntimeForDoctor() {
   return { issues: 0 };
 }
 async function checkEmbeddingConfig(magicContextConfigPath) {
-  if (!existsSync29(magicContextConfigPath)) {
+  if (!existsSync31(magicContextConfigPath)) {
     return checkLocalEmbeddingRuntimeForDoctor();
   }
   let rawText;
   try {
-    rawText = readFileSync20(magicContextConfigPath, "utf-8");
+    rawText = readFileSync22(magicContextConfigPath, "utf-8");
   } catch {
     log2.warn("Could not read magic-context.jsonc for embedding check");
     return { issues: 1 };
@@ -43809,7 +44301,7 @@ async function checkEmbeddingConfig(magicContextConfigPath) {
   });
   let parsedConfig;
   try {
-    parsedConfig = import_comment_json11.parse(substituted.text);
+    parsedConfig = import_comment_json12.parse(substituted.text);
   } catch (error51) {
     log2.warn(`Embedding check skipped — could not parse magic-context.jsonc: ${error51 instanceof Error ? error51.message : String(error51)}`);
     return { issues: 1 };
@@ -43921,7 +44413,7 @@ async function runDoctor2(options = {}) {
   const v22Result = await runV22BackfillCommands({
     name: "OpenCode",
     openDatabase: (readonly2 = true) => {
-      const dbPath2 = join25(getMagicContextStorageDir(), "context.db");
+      const dbPath2 = join28(getMagicContextStorageDir(), "context.db");
       v22Db = readonly2 ? openExistingContextDatabase(dbPath2, { readonly: true }) : openExistingContextDatabaseForMutation(dbPath2);
       return v22Db;
     },
@@ -43944,7 +44436,7 @@ async function runDoctor2(options = {}) {
     log2.success(msg);
     passCount++;
   };
-  const warn = (msg) => {
+  const warn2 = (msg) => {
     log2.warn(msg);
     warnCount++;
   };
@@ -43953,17 +44445,17 @@ async function runDoctor2(options = {}) {
     failCount++;
     issues++;
   };
-  const authorityDbPath = join25(getMagicContextStorageDir(), "context.db");
+  const authorityDbPath = join28(getMagicContextStorageDir(), "context.db");
   let authorityDb = null;
   try {
     authorityDb = openExistingContextDatabase(authorityDbPath, { readonly: true });
     if (authorityDb) {
-      await reportAuthorityMarkers({ db: authorityDb, info: log2.info, warn });
+      await reportAuthorityMarkers({ db: authorityDb, info: log2.info, warn: warn2 });
     } else {
       log2.info("Authority: no context database found");
     }
   } catch (error51) {
-    warn(`Authority check unavailable: ${error51 instanceof Error ? error51.message : String(error51)}`);
+    warn2(`Authority check unavailable: ${error51 instanceof Error ? error51.message : String(error51)}`);
   } finally {
     authorityDb?.close();
   }
@@ -43994,7 +44486,7 @@ async function runDoctor2(options = {}) {
   if (!npmLatest) {
     log2.info(`Magic Context CLI v${selfVersion2}; npm latest check unavailable`);
   } else if (compareVersions(selfVersion2, npmLatest) < 0) {
-    warn(`Magic Context CLI v${selfVersion2} is older than npm latest v${npmLatest}`);
+    warn2(`Magic Context CLI v${selfVersion2} is older than npm latest v${npmLatest}`);
   } else {
     pass(`Magic Context CLI v${selfVersion2} is current (npm latest v${npmLatest})`);
   }
@@ -44004,15 +44496,15 @@ async function runDoctor2(options = {}) {
   } else {
     pass(`OpenCode config: ${paths.opencodeConfig}`);
   }
-  if (existsSync29(paths.magicContextConfig)) {
+  if (existsSync31(paths.magicContextConfig)) {
     pass(`Magic Context config: ${paths.magicContextConfig}`);
     try {
-      const raw = readFileSync20(paths.magicContextConfig, "utf-8");
+      const raw = readFileSync22(paths.magicContextConfig, "utf-8");
       const substituted = substituteConfigVariables({
         text: raw,
         configPath: paths.magicContextConfig
       }).text;
-      import_comment_json11.parse(substituted);
+      import_comment_json12.parse(substituted);
       pass("magic-context.jsonc parses as valid JSONC");
     } catch (err) {
       fail(`magic-context.jsonc parse failed: ${err instanceof Error ? err.message : String(err)}`);
@@ -44021,7 +44513,7 @@ async function runDoctor2(options = {}) {
       const result = loadPluginConfig(process.cwd());
       const warnings = result.configWarnings ?? [];
       if (warnings.length > 0) {
-        warn(`Magic Context config has ${warnings.length} warning(s) — see 'magic-context doctor --issue' for details`);
+        warn2(`Magic Context config has ${warnings.length} warning(s) — see 'magic-context doctor --issue' for details`);
       } else {
         pass("Magic Context config loads successfully");
       }
@@ -44029,13 +44521,13 @@ async function runDoctor2(options = {}) {
       fail(`Could not load Magic Context config: ${err instanceof Error ? err.message : String(err)}`);
     }
   } else {
-    warn(`No magic-context.jsonc found — using defaults`);
+    warn2(`No magic-context.jsonc found — using defaults`);
     log2.info("  Run 'setup' to create one with model recommendations");
   }
-  if (existsSync29(paths.magicContextConfig)) {
+  if (existsSync31(paths.magicContextConfig)) {
     try {
-      const mcRaw = readFileSync20(paths.magicContextConfig, "utf-8");
-      const mcConfig = import_comment_json11.parse(mcRaw);
+      const mcRaw = readFileSync22(paths.magicContextConfig, "utf-8");
+      const mcConfig = import_comment_json12.parse(mcRaw);
       let mcChanged = false;
       const experimental = mcConfig.experimental;
       if (experimental && "compaction_markers" in experimental) {
@@ -44143,7 +44635,7 @@ async function runDoctor2(options = {}) {
         fixed++;
       }
       if (mcChanged) {
-        writeFileAtomic(paths.magicContextConfig, `${import_comment_json11.stringify(mcConfig, null, 2)}
+        writeFileAtomic(paths.magicContextConfig, `${import_comment_json12.stringify(mcConfig, null, 2)}
 `);
       }
     } catch {
@@ -44152,12 +44644,12 @@ async function runDoctor2(options = {}) {
   }
   if (paths.opencodeConfigFormat !== "none") {
     try {
-      const raw = readFileSync20(paths.opencodeConfig, "utf-8");
-      const config2 = import_comment_json11.parse(raw);
+      const raw = readFileSync22(paths.opencodeConfig, "utf-8");
+      const config2 = import_comment_json12.parse(raw);
       const rawPlugins = Array.isArray(config2?.plugin) ? config2.plugin : [];
       const existingIdx = rawPlugins.findIndex((entry) => matchesPluginEntry(entry, OPENCODE_PLUGIN_NAME) || isDevPathPluginEntry(entry));
       if (rawPlugins.some((entry) => isLocalPathPluginEntry(entry) && String(entry).includes("magic-context") && !isDevPathPluginEntry(entry))) {
-        warn("An unverifiable local OpenCode plugin path was ignored because its package name is not Magic Context");
+        warn2("An unverifiable local OpenCode plugin path was ignored because its package name is not Magic Context");
       }
       const configName = paths.opencodeConfigFormat === "jsonc" ? "opencode.jsonc" : "opencode.json";
       const entryAsString = (entry) => {
@@ -44177,7 +44669,7 @@ async function runDoctor2(options = {}) {
         } else {
           const isPinned = isPinnedOpenCodePluginSpecifier(oldEntryStr);
           if (isPinned && !options.force) {
-            warn(`Plugin pinned to ${oldEntryStr} in ${configName} — use 'doctor --force' to upgrade`);
+            warn2(`Plugin pinned to ${oldEntryStr} in ${configName} — use 'doctor --force' to upgrade`);
           } else {
             if (Array.isArray(oldEntry) && oldEntry.length >= 1) {
               const replacement = [...oldEntry];
@@ -44187,7 +44679,7 @@ async function runDoctor2(options = {}) {
               rawPlugins[existingIdx] = OPENCODE_PLUGIN_ENTRY_WITH_VERSION;
             }
             config2.plugin = rawPlugins;
-            writeFileAtomic(paths.opencodeConfig, `${import_comment_json11.stringify(config2, null, 2)}
+            writeFileAtomic(paths.opencodeConfig, `${import_comment_json12.stringify(config2, null, 2)}
 `);
             pass(`Upgraded plugin entry in ${configName}: ${oldEntryStr} → ${OPENCODE_PLUGIN_ENTRY_WITH_VERSION}`);
             fixed++;
@@ -44196,13 +44688,13 @@ async function runDoctor2(options = {}) {
       } else {
         rawPlugins.push(OPENCODE_PLUGIN_ENTRY_WITH_VERSION);
         config2.plugin = rawPlugins;
-        writeFileAtomic(paths.opencodeConfig, `${import_comment_json11.stringify(config2, null, 2)}
+        writeFileAtomic(paths.opencodeConfig, `${import_comment_json12.stringify(config2, null, 2)}
 `);
         pass(`Added plugin to ${configName}`);
         fixed++;
       }
     } catch {
-      warn("Could not parse opencode config to verify plugin entry");
+      warn2("Could not parse opencode config to verify plugin entry");
     }
   }
   const cwd = process.cwd();
@@ -44219,14 +44711,14 @@ async function runDoctor2(options = {}) {
       fixed++;
     }
     if (actions.length > 0) {
-      warn("Restart OpenCode for conflict fixes to take effect");
+      warn2("Restart OpenCode for conflict fixes to take effect");
     }
   } else {
     if (!compactionEnabled) {
       if (conflictResult.nativeCompaction.auto || conflictResult.nativeCompaction.prune) {
         pass("No conflicts detected (compaction, DCP, OMO hooks) — native compaction active (compaction-off mode)");
       } else {
-        warn("No compaction manager is active: Magic Context compaction is off and OpenCode auto-compaction is disabled");
+        warn2("No compaction manager is active: Magic Context compaction is off and OpenCode auto-compaction is disabled");
       }
     } else {
       pass("No conflicts detected (compaction, DCP, OMO hooks)");
@@ -44235,16 +44727,16 @@ async function runDoctor2(options = {}) {
   const tuiAdded = ensureTuiPluginEntry();
   if (tuiAdded) {
     pass("Added TUI sidebar plugin to tui.json");
-    warn("Restart OpenCode to see the sidebar");
+    warn2("Restart OpenCode to see the sidebar");
     fixed++;
-  } else if (existsSync29(paths.tuiConfig)) {
+  } else if (existsSync31(paths.tuiConfig)) {
     try {
-      const tuiRaw = readFileSync20(paths.tuiConfig, "utf-8");
-      const tuiConfig = import_comment_json11.parse(tuiRaw);
+      const tuiRaw = readFileSync22(paths.tuiConfig, "utf-8");
+      const tuiConfig = import_comment_json12.parse(tuiRaw);
       const tuiRawPlugins = Array.isArray(tuiConfig?.plugin) ? tuiConfig.plugin : [];
       const tuiIdx = tuiRawPlugins.findIndex((entry) => matchesPluginEntry(entry, OPENCODE_PLUGIN_NAME) || isDevPathPluginEntry(entry));
       if (tuiRawPlugins.some((entry) => isLocalPathPluginEntry(entry) && String(entry).includes("magic-context") && !isDevPathPluginEntry(entry))) {
-        warn("An unverifiable local TUI plugin path was ignored because its package name is not Magic Context");
+        warn2("An unverifiable local TUI plugin path was ignored because its package name is not Magic Context");
       }
       const tuiEntryAsString = (entry) => {
         if (typeof entry === "string")
@@ -44261,7 +44753,7 @@ async function runDoctor2(options = {}) {
         } else {
           const tuiPinned = isPinnedOpenCodePluginSpecifier(tuiEntryStr);
           if (tuiPinned && !options.force) {
-            warn(`TUI plugin pinned to ${tuiEntryStr} — use 'doctor --force' to upgrade`);
+            warn2(`TUI plugin pinned to ${tuiEntryStr} — use 'doctor --force' to upgrade`);
           } else if (tuiPinned && options.force) {
             if (Array.isArray(tuiEntry) && tuiEntry.length >= 1) {
               const replacement = [...tuiEntry];
@@ -44271,7 +44763,7 @@ async function runDoctor2(options = {}) {
               tuiRawPlugins[tuiIdx] = OPENCODE_PLUGIN_ENTRY_WITH_VERSION;
             }
             tuiConfig.plugin = tuiRawPlugins;
-            writeFileAtomic(paths.tuiConfig, `${import_comment_json11.stringify(tuiConfig, null, 2)}
+            writeFileAtomic(paths.tuiConfig, `${import_comment_json12.stringify(tuiConfig, null, 2)}
 `);
             pass(`Upgraded TUI plugin: ${tuiEntryStr} → ${OPENCODE_PLUGIN_ENTRY_WITH_VERSION}`);
             fixed++;
@@ -44288,10 +44780,10 @@ async function runDoctor2(options = {}) {
   } else {
     fail("Could not create or verify the TUI sidebar config");
   }
-  if (existsSync29(paths.magicContextConfig)) {
+  if (existsSync31(paths.magicContextConfig)) {
     try {
-      const mcRaw = readFileSync20(paths.magicContextConfig, "utf-8");
-      const mcConfig = import_comment_json11.parse(mcRaw);
+      const mcRaw = readFileSync22(paths.magicContextConfig, "utf-8");
+      const mcConfig = import_comment_json12.parse(mcRaw);
       const warning = checkUserMemoriesDreamerCompatibility(mcConfig);
       if (warning) {
         log2.warn(warning);
@@ -44307,8 +44799,8 @@ async function runDoctor2(options = {}) {
     warnCount++;
   else
     passCount++;
-  const dbPath = join25(getMagicContextStorageDir(), "context.db");
-  if (!existsSync29(dbPath)) {
+  const dbPath = join28(getMagicContextStorageDir(), "context.db");
+  if (!existsSync31(dbPath)) {
     log2.info(`Shared context DB not yet created at ${dbPath} (will be created on first run)`);
   } else {
     log2.info(`Shared context DB exists at ${dbPath}`);
@@ -44321,6 +44813,21 @@ async function runDoctor2(options = {}) {
         pass("Opened the shared DB with a supported schema");
         const storageVersions = readStorageVersions(db);
         log2.info(formatStorageVersions(storageVersions));
+        const pinnedPluginFenceFindings = await inspectPinnedOpenCodePluginSchemaFences({
+          directory: process.cwd(),
+          databaseVersion: storageVersions.context_db_schema_version
+        });
+        for (const finding of pinnedPluginFenceFindings) {
+          const location = `${finding.surface} entry ${finding.specifier} in ${sanitizePathString(finding.configPath)}`;
+          if (finding.status === "fail") {
+            fail(`Pinned plugin schema fence mismatch: ${location} pins plugin v${finding.pinnedVersion}, which supports through schema v${finding.supportedVersion}; shared context.db is v${finding.databaseVersion}. Recovery: unpin the entry (use @latest), or upgrade the pin to a version released after this migration that supports v${finding.databaseVersion} or later.`);
+          } else if (finding.status === "unknown") {
+            warn2(`UNKNOWN: Pinned plugin schema fence could not be resolved for ${location}; shared context.db is v${finding.databaseVersion}, so doctor cannot verify the plugin that will run. Install the pinned package and rerun doctor, or unpin/upgrade it to a version released after this migration.`);
+            issues++;
+          } else {
+            pass(`Pinned plugin schema fence: ${location} pins plugin v${finding.pinnedVersion}, which supports shared context.db v${finding.databaseVersion}.`);
+          }
+        }
         const fenceCheck = checkStorageVersionFence(storageVersions, {
           blockingProcesses: getLiveMigrationBlockingProcesses(getMagicContextStorageDir())
         });
@@ -44387,9 +44894,9 @@ ${formatDatabaseRepairGuidance(dbPath)}`);
   } else if (cacheResult.action === "up_to_date") {
     pass(`Plugin cache up to date (v${cacheResult.cached})`);
   } else if (cacheResult.action === "check_unavailable") {
-    warn(`Plugin cache version check unavailable; preserving cached plugin${cacheResult.cached ? ` (cached: ${cacheResult.cached})` : ""}. Use doctor --force to reinstall it.`);
+    warn2(`Plugin cache version check unavailable; preserving cached plugin${cacheResult.cached ? ` (cached: ${cacheResult.cached})` : ""}. Use doctor --force to reinstall it.`);
   } else if (cacheResult.action === "error") {
-    warn(`Could not clear plugin cache: ${cacheResult.error}`);
+    warn2(`Could not clear plugin cache: ${cacheResult.error}`);
     if (cacheResult.clearedPaths && cacheResult.clearedPaths.length > 0) {
       log2.info(`  Cleared roots: ${cacheResult.clearedPaths.join(", ")}`);
     }
@@ -44415,8 +44922,8 @@ ${formatDatabaseRepairGuidance(dbPath)}`);
     }
   }
   const logPath = getMagicContextLogPath2("opencode");
-  if (existsSync29(logPath)) {
-    const logStat = statSync11(logPath);
+  if (existsSync31(logPath)) {
+    const logStat = statSync12(logPath);
     const sizeKb = (logStat.size / 1024).toFixed(0);
     log2.info(`Log file: ${logPath} (${sizeKb} KB)`);
   } else {
@@ -44427,7 +44934,7 @@ ${formatDatabaseRepairGuidance(dbPath)}`);
   if (dumpBuckets.length > 0) {
     const totalCount = dumpBuckets.reduce((sum, b2) => sum + b2.count, 0);
     const sessionCount = dumpBuckets.length;
-    warn(`Historian debug dumps: ${totalCount} file(s) across ${sessionCount} project(s)`);
+    warn2(`Historian debug dumps: ${totalCount} file(s) across ${sessionCount} project(s)`);
     for (const bucket of dumpBuckets) {
       log2.info(`  [${bucket.directory}] ${bucket.count} file(s)`);
       for (const dump of bucket.recent.slice(0, 3)) {
@@ -44461,7 +44968,7 @@ ${formatDatabaseRepairGuidance(dbPath)}`);
   }
   return 0;
 }
-var import_comment_json11, CLI_PACKAGE_NAME = "@cortexkit/magic-context";
+var import_comment_json12, CLI_PACKAGE_NAME = "@cortexkit/magic-context";
 var init_doctor_opencode = __esm(async () => {
   init_config();
   init_agent_disable();
@@ -44480,6 +44987,7 @@ var init_doctor_opencode = __esm(async () => {
   init_opencode_detect();
   init_opencode_helpers();
   init_opencode_plugin_cache();
+  init_opencode_plugin_schema_fence();
   init_paths();
   init_prompts();
   init_redaction2();
@@ -44491,15 +44999,15 @@ var init_doctor_opencode = __esm(async () => {
     init_v22_backfill_commands(),
     init_doctor_authority()
   ]);
-  import_comment_json11 = __toESM(require_src3(), 1);
+  import_comment_json12 = __toESM(require_src3(), 1);
 });
 
 // src/lib/diagnostics-pi.ts
 import { createHash as createHash5 } from "node:crypto";
-import { existsSync as existsSync30, readdirSync as readdirSync4, readFileSync as readFileSync21, statSync as statSync12 } from "node:fs";
+import { existsSync as existsSync32, readdirSync as readdirSync5, readFileSync as readFileSync23, statSync as statSync13 } from "node:fs";
 import { createRequire as createRequire6 } from "node:module";
-import { homedir as homedir17, userInfo as userInfo2 } from "node:os";
-import { join as join26 } from "node:path";
+import { homedir as homedir18, userInfo as userInfo2 } from "node:os";
+import { join as join29 } from "node:path";
 function getSelfVersion3() {
   const req = createRequire6(import.meta.url);
   for (const relPath of ["../../package.json", "../package.json"]) {
@@ -44514,7 +45022,7 @@ function getSelfVersion3() {
 }
 function fileSize2(path6) {
   try {
-    return existsSync30(path6) ? statSync12(path6).size : 0;
+    return existsSync32(path6) ? statSync13(path6).size : 0;
   } catch {
     return 0;
   }
@@ -44530,7 +45038,7 @@ function redactSecretString(value) {
   return redactSecretText(value).replace(/Bearer\s+[A-Za-z0-9._~+\-/=]+/g, "Bearer <REDACTED>").replace(/sk-[A-Za-z0-9_-]{12,}/g, "sk-<REDACTED>").replace(/api[_-]?key=([^\s&]+)/gi, "api_key=<REDACTED>").replace(/token=([^\s&]+)/gi, "token=<REDACTED>");
 }
 function sanitizeString2(value) {
-  const home = process.env.HOME || homedir17();
+  const home = process.env.HOME || homedir18();
   const username = userInfo2().username;
   const userHash = `<USER:${currentUserHash()}>`;
   let sanitized = redactSecretString(value);
@@ -44566,11 +45074,11 @@ function sanitizeValue2(value, key = "") {
   return value;
 }
 function readJsonc(path6) {
-  if (!existsSync30(path6))
+  if (!existsSync32(path6))
     return { value: {} };
   try {
     return {
-      value: import_comment_json12.parse(readFileSync21(path6, "utf-8"))
+      value: import_comment_json13.parse(readFileSync23(path6, "utf-8"))
     };
   } catch (error51) {
     return {
@@ -44586,7 +45094,7 @@ function readConfigDiagnostic(path6) {
   const parsed = readJsonc(path6);
   return {
     path: path6,
-    exists: existsSync30(path6),
+    exists: existsSync32(path6),
     ...parsed.parseError ? { parseError: parsed.parseError } : {},
     flags: sanitizeValue2(parsed.value)
   };
@@ -44604,25 +45112,25 @@ function reverseSlugToDirectory(slug) {
 }
 function collectPiRecentSessions() {
   const sessionsRoot = getPiSessionsRoot();
-  if (!existsSync30(sessionsRoot))
+  if (!existsSync32(sessionsRoot))
     return [];
   try {
-    const slugs = readdirSync4(sessionsRoot, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => entry.name);
+    const slugs = readdirSync5(sessionsRoot, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => entry.name);
     const candidates = [];
     for (const slug of slugs) {
       const directory = reverseSlugToDirectory(slug);
       if (!directory)
         continue;
-      const slugDir = join26(sessionsRoot, slug);
+      const slugDir = join29(sessionsRoot, slug);
       let files;
       try {
-        files = readdirSync4(slugDir).filter((name) => name.endsWith(".jsonl"));
+        files = readdirSync5(slugDir).filter((name) => name.endsWith(".jsonl"));
       } catch {
         continue;
       }
       for (const file2 of files) {
         try {
-          const mtime = statSync12(join26(slugDir, file2)).mtimeMs;
+          const mtime = statSync13(join29(slugDir, file2)).mtimeMs;
           const sessionId = file2.replace(/\.jsonl$/, "");
           candidates.push({ sessionId, directory, mtime });
         } catch {}
@@ -44640,7 +45148,7 @@ function collectPiRecentSessions() {
 }
 function parseHistorianDumpMeta2(path6) {
   try {
-    const xml = readFileSync21(path6, "utf-8");
+    const xml = readFileSync23(path6, "utf-8");
     const parsed = parseCompartmentOutput(xml);
     const factCountByCategory = {};
     for (const fact of parsed.facts) {
@@ -44673,11 +45181,11 @@ function parseHistorianDumpMeta2(path6) {
   }
 }
 function listDumpsInDir2(dir, limit) {
-  if (!existsSync30(dir))
+  if (!existsSync32(dir))
     return { count: 0, recent: [] };
   try {
-    const entries = readdirSync4(dir).filter((name) => name.endsWith(".xml")).map((name) => {
-      const stat = statSync12(join26(dir, name));
+    const entries = readdirSync5(dir).filter((name) => name.endsWith(".xml")).map((name) => {
+      const stat = statSync13(join29(dir, name));
       return {
         name,
         mtime: stat.mtimeMs,
@@ -44686,7 +45194,7 @@ function listDumpsInDir2(dir, limit) {
     }).sort((a3, b2) => b2.mtime - a3.mtime);
     const now = Date.now();
     const recent = entries.slice(0, limit).map((entry) => {
-      const meta3 = parseHistorianDumpMeta2(join26(dir, entry.name));
+      const meta3 = parseHistorianDumpMeta2(join29(dir, entry.name));
       const summary = {
         name: entry.name,
         ageMinutes: Math.round((now - entry.mtime) / 60000),
@@ -44749,9 +45257,9 @@ async function collectDiagnostics2(cwd = process.cwd()) {
   const projectConfigPath = getProjectConfigPath(cwd);
   const loaded = loadPiConfig({ cwd });
   const storageDirPath = getMagicContextStorageDir();
-  const dbPath = join26(storageDirPath, "context.db");
+  const dbPath = join29(storageDirPath, "context.db");
   const logPath = getMagicContextLogPath2("pi");
-  const logFileSize = existsSync30(logPath) ? statSync12(logPath).size : 0;
+  const logFileSize = existsSync32(logPath) ? statSync13(logPath).size : 0;
   const otherPiExtensions = packages.filter((entry) => !isPiMagicContextPackageEntry(entry)).map(describePiPackageEntry);
   const recentSessions = collectPiRecentSessions();
   const historianDumps = collectPiHistorianDumps(recentSessions);
@@ -44766,7 +45274,7 @@ async function collectDiagnostics2(cwd = process.cwd()) {
     piVersion: pi ? getPiVersion(pi.path) : null,
     settings: {
       path: settingsPath,
-      exists: existsSync30(settingsPath),
+      exists: existsSync32(settingsPath),
       ...settingsParsed.parseError ? { parseError: settingsParsed.parseError } : {},
       hasMagicContextPackage: hasPiMagicContextPackage(packages),
       packages: sanitizeValue2(packages)
@@ -44782,7 +45290,7 @@ async function collectDiagnostics2(cwd = process.cwd()) {
     loadWarnings: loaded.warnings.map(sanitizeString2),
     storageDir: {
       path: storageDirPath,
-      exists: existsSync30(storageDirPath),
+      exists: existsSync32(storageDirPath),
       contextDbSizeBytes: fileSize2(dbPath)
     },
     conflicts: {
@@ -44791,7 +45299,7 @@ async function collectDiagnostics2(cwd = process.cwd()) {
     },
     logFile: {
       path: logPath,
-      exists: existsSync30(logPath),
+      exists: existsSync32(logPath),
       sizeKb: Math.round(logFileSize / 1024)
     },
     recentSessions,
@@ -44872,7 +45380,7 @@ function renderDiagnosticsMarkdown2(report) {
   ].join(`
 `);
 }
-var import_comment_json12;
+var import_comment_json13;
 var init_diagnostics_pi = __esm(() => {
   init_migrate_config_location();
   init_compartment_parser();
@@ -44881,12 +45389,12 @@ var init_diagnostics_pi = __esm(() => {
   init_paths();
   init_pi_helpers();
   init_redaction2();
-  import_comment_json12 = __toESM(require_src3(), 1);
+  import_comment_json13 = __toESM(require_src3(), 1);
 });
 
 // src/lib/logs-pi.ts
-import { readFileSync as readFileSync22, writeFileSync as writeFileSync8 } from "node:fs";
-import { join as join27 } from "node:path";
+import { readFileSync as readFileSync24, writeFileSync as writeFileSync9 } from "node:fs";
+import { join as join30 } from "node:path";
 function sanitizeLogContent2(content) {
   return sanitizeString2(content);
 }
@@ -44915,7 +45423,7 @@ function filterLogLinesBySession2(lines, sessionId) {
 }
 async function bundleIssueReport2(report, description, title, options = {}) {
   const LOG_TAIL_LINES = 400;
-  const allLogLines = report.logFile.exists ? readFileSync22(report.logFile.path, "utf-8").split(/\r?\n/) : [];
+  const allLogLines = report.logFile.exists ? readFileSync24(report.logFile.path, "utf-8").split(/\r?\n/) : [];
   const logLines = filterLogLinesBySession2(allLogLines, options.sessionFilter ?? null);
   const recentLog = sanitizeLogContent2(logLines.slice(-LOG_TAIL_LINES).join(`
 `)).trim();
@@ -44951,8 +45459,8 @@ async function bundleIssueReport2(report, description, title, options = {}) {
 `);
   const bodyMarkdown = capBodyToGithubLimit(rawBodyMarkdown);
   const cwd = options.cwd ?? process.cwd();
-  const path6 = join27(cwd, `magic-context-pi-issue-${formatTimestamp2(options.now ?? new Date)}.md`);
-  writeFileSync8(path6, `${bodyMarkdown}
+  const path6 = join30(cwd, `magic-context-pi-issue-${formatTimestamp2(options.now ?? new Date)}.md`);
+  writeFileSync9(path6, `${bodyMarkdown}
 `);
   return { path: path6, bodyMarkdown };
 }
@@ -44963,14 +45471,14 @@ var init_logs_pi = __esm(() => {
 
 // src/commands/doctor-pi.ts
 import { execFileSync as execFileSync6, spawnSync as spawnSync7 } from "node:child_process";
-import { existsSync as existsSync31, mkdirSync as mkdirSync11, readdirSync as readdirSync5, readFileSync as readFileSync23, rmSync as rmSync4, statSync as statSync13 } from "node:fs";
+import { existsSync as existsSync33, mkdirSync as mkdirSync11, readdirSync as readdirSync6, readFileSync as readFileSync25, rmSync as rmSync4, statSync as statSync14 } from "node:fs";
 import { createRequire as createRequire7 } from "node:module";
-import { homedir as homedir18 } from "node:os";
-import { dirname as dirname16, isAbsolute as isAbsolute4, join as join28 } from "node:path";
+import { homedir as homedir19 } from "node:os";
+import { dirname as dirname17, isAbsolute as isAbsolute5, join as join31 } from "node:path";
 function depsFrom(options) {
   return {
-    ...DEFAULT_DEPS3,
-    prompts: options.prompts ?? DEFAULT_DEPS3.prompts,
+    ...DEFAULT_DEPS5,
+    prompts: options.prompts ?? DEFAULT_DEPS5.prompts,
     ...options.deps
   };
 }
@@ -45056,7 +45564,7 @@ function summarize(results) {
 function readJsonc2(path6) {
   try {
     return {
-      value: import_comment_json13.parse(readFileSync23(path6, "utf-8"))
+      value: import_comment_json14.parse(readFileSync25(path6, "utf-8"))
     };
   } catch (error51) {
     return {
@@ -45075,28 +45583,28 @@ function piPluginDirCandidates(packages, cwd) {
     const spec = typeof entry === "string" ? entry.trim() : "";
     if (!spec || spec.startsWith("npm:"))
       continue;
-    const resolved = isAbsolute4(spec) ? spec : join28(agentDir, spec);
+    const resolved = isAbsolute5(spec) ? spec : join31(agentDir, spec);
     dirs.push(resolved);
   }
-  dirs.push(join28(agentDir, "npm", "node_modules", PACKAGE_NAME));
-  dirs.push(join28(cwd, ".pi", "npm", "node_modules", PACKAGE_NAME));
-  return dirs.filter((dir) => existsSync31(join28(dir, "package.json")));
+  dirs.push(join31(agentDir, "npm", "node_modules", PACKAGE_NAME2));
+  dirs.push(join31(cwd, ".pi", "npm", "node_modules", PACKAGE_NAME2));
+  return dirs.filter((dir) => existsSync33(join31(dir, "package.json")));
 }
 function projectConfigPath(cwd) {
   return resolveCortexKitProjectConfigPath(cwd);
 }
 function readConfigForEmbedding(path6, isProjectConfig) {
-  if (!existsSync31(path6))
+  if (!existsSync33(path6))
     return null;
   try {
-    const rawText = readFileSync23(path6, "utf-8");
+    const rawText = readFileSync25(path6, "utf-8");
     const substituted = substituteConfigVariables({
       text: rawText,
       configPath: path6,
       isProjectConfig
     });
     const rejectedKeyPaths = [];
-    const parsed = sanitizeParsedJson(import_comment_json13.parse(substituted.text), {
+    const parsed = sanitizeParsedJson(import_comment_json14.parse(substituted.text), {
       onRejectedKey: (keyPath) => rejectedKeyPaths.push(keyPath.join("."))
     });
     if (rejectedKeyPaths.length > 0) {
@@ -45167,38 +45675,38 @@ function pinnedVersionFromPackageSpecifier(specifier) {
 }
 function cacheRoots(cwd) {
   const home = process.env.HOME?.trim();
-  const cacheHome = process.env.XDG_CACHE_HOME || join28(home || homedir18(), ".cache");
+  const cacheHome = process.env.XDG_CACHE_HOME || join31(home || homedir19(), ".cache");
   const piCacheRoot = getPiCacheRoot();
   return [
-    join28(piCacheRoot, "extensions"),
-    join28(piCacheRoot, "packages"),
-    join28(cacheHome, "pi", "extensions"),
-    join28(cacheHome, "pi", "packages"),
-    join28(getPiAgentConfigDir(), "cache", "extensions"),
-    join28(getPiAgentConfigDir(), "npm", "node_modules", PACKAGE_NAME),
-    join28(cwd, ".pi", "npm", "node_modules", PACKAGE_NAME)
+    join31(piCacheRoot, "extensions"),
+    join31(piCacheRoot, "packages"),
+    join31(cacheHome, "pi", "extensions"),
+    join31(cacheHome, "pi", "packages"),
+    join31(getPiAgentConfigDir(), "cache", "extensions"),
+    join31(getPiAgentConfigDir(), "npm", "node_modules", PACKAGE_NAME2),
+    join31(cwd, ".pi", "npm", "node_modules", PACKAGE_NAME2)
   ];
 }
 function findPiMagicContextCacheDirs(cwd, expectedVersion, force = false) {
   const found = new Map;
   const visit = (path6, depth) => {
-    if (depth < 0 || !existsSync31(path6))
+    if (depth < 0 || !existsSync33(path6))
       return;
     let stat;
     try {
-      stat = statSync13(path6);
+      stat = statSync14(path6);
     } catch {
       return;
     }
     if (!stat.isDirectory())
       return;
-    const packageJson = join28(path6, "package.json");
-    if (existsSync31(packageJson)) {
+    const packageJson = join31(path6, "package.json");
+    if (existsSync33(packageJson)) {
       try {
-        const pkg = JSON.parse(readFileSync23(packageJson, "utf-8"));
+        const pkg = JSON.parse(readFileSync25(packageJson, "utf-8"));
         const name = typeof pkg.name === "string" ? pkg.name : "";
         const version2 = typeof pkg.version === "string" ? pkg.version : undefined;
-        if (name === PACKAGE_NAME) {
+        if (name === PACKAGE_NAME2) {
           if (force || !version2 || expectedVersion && version2 !== expectedVersion) {
             found.set(path6, { path: path6, version: version2 });
           }
@@ -45210,12 +45718,12 @@ function findPiMagicContextCacheDirs(cwd, expectedVersion, force = false) {
     }
     let entries = [];
     try {
-      entries = readdirSync5(path6);
+      entries = readdirSync6(path6);
     } catch {
       return;
     }
     for (const entry of entries)
-      visit(join28(path6, entry), depth - 1);
+      visit(join31(path6, entry), depth - 1);
   };
   for (const root of cacheRoots(cwd))
     visit(root, 5);
@@ -45260,7 +45768,7 @@ async function runHealthChecks2(options) {
   }
   const settingsPath = getPiUserExtensionsPath();
   let packages = [];
-  if (!existsSync31(settingsPath)) {
+  if (!existsSync33(settingsPath)) {
     add2(results, "fail", `Pi settings not found at ${settingsPath}`);
     repairPlan.addPackageEntry = true;
   } else {
@@ -45284,7 +45792,7 @@ async function runHealthChecks2(options) {
     ["user", userConfigPath, true],
     ["project", projectPath, false]
   ]) {
-    if (!existsSync31(path6)) {
+    if (!existsSync33(path6)) {
       if (required2) {
         add2(results, "warn", `No ${label} magic-context.jsonc found at ${path6}`);
         if (userConfigMigrationRefused) {
@@ -45321,8 +45829,8 @@ async function runHealthChecks2(options) {
     add2(results, "pass", `historian.model "${historianModel}" has thinking_level "${historianThinkingLevel}" configured`);
   }
   const storageDir = getMagicContextStorageDir();
-  const dbPath = join28(storageDir, "context.db");
-  const existedBeforeOpen = existsSync31(dbPath);
+  const dbPath = join31(storageDir, "context.db");
+  const existedBeforeOpen = existsSync33(dbPath);
   if (existedBeforeOpen)
     add2(results, "pass", `Shared context DB exists at ${dbPath}`);
   else
@@ -45459,10 +45967,10 @@ ${formatDatabaseRepairGuidance(dbPath)}`);
     add2(results, "pass", "Pi extension cache clean (no stale cached package found)");
   }
   const logPath = getMagicContextLogPath2("pi");
-  if (existsSync31(logPath)) {
-    const stat = statSync13(logPath);
+  if (existsSync33(logPath)) {
+    const stat = statSync14(logPath);
     const sizeKb = (stat.size / 1024).toFixed(0);
-    const lines = readFileSync23(logPath, "utf-8").split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
+    const lines = readFileSync25(logPath, "utf-8").split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
     add2(results, "info", `Log file: ${logPath} (${sizeKb} KB)`);
     const lastLine = lines.at(-1);
     add2(results, "info", `Last plugin log line: ${lastLine ? sanitizeDiagnosticText(lastLine) : "<empty log>"}`);
@@ -45497,12 +46005,12 @@ ${formatDatabaseRepairGuidance(dbPath)}`);
   return { results, repairPlan, ...summarize(results) };
 }
 function writeDefaultMagicContextConfig(path6) {
-  mkdirSync11(dirname16(path6), { recursive: true });
+  mkdirSync11(dirname17(path6), { recursive: true });
   const config2 = {
     $schema: "https://raw.githubusercontent.com/cortexkit/magic-context/master/assets/magic-context.schema.json",
     ...MagicContextConfigSchema.parse({})
   };
-  writeFileAtomic(path6, `${import_comment_json13.stringify(config2, null, 2)}
+  writeFileAtomic(path6, `${import_comment_json14.stringify(config2, null, 2)}
 `);
 }
 function repair2(plan, prompts) {
@@ -45519,7 +46027,7 @@ function repair2(plan, prompts) {
   }
   if (plan.writeUserConfig) {
     const configPath = getPiUserConfigPath();
-    if (!existsSync31(configPath)) {
+    if (!existsSync33(configPath)) {
       try {
         writeDefaultMagicContextConfig(configPath);
         prompts.log.success(`Wrote default Magic Context config to ${configPath}`);
@@ -45639,7 +46147,7 @@ async function runDoctor3(options = {}) {
   const v22Result = await runV22BackfillCommands({
     name: "Pi",
     openDatabase: (readonly2 = true) => {
-      const dbPath = join28(getMagicContextStorageDir(), "context.db");
+      const dbPath = join31(getMagicContextStorageDir(), "context.db");
       v22Db = readonly2 ? openExistingContextDatabase(dbPath, { readonly: true }) : openExistingContextDatabaseForMutation(dbPath);
       return v22Db;
     },
@@ -45704,7 +46212,7 @@ function parseDoctorArgs(args) {
 function doctor(args = []) {
   return runDoctor3(parseDoctorArgs(args));
 }
-var import_comment_json13, PACKAGE_NAME = "@cortexkit/pi-magic-context", MIN_PI_VERSION = "0.74.0", ROW_COUNT_TABLES2, DEFAULT_DEPS3;
+var import_comment_json14, PACKAGE_NAME2 = "@cortexkit/pi-magic-context", MIN_PI_VERSION = "0.74.0", ROW_COUNT_TABLES2, DEFAULT_DEPS5;
 var init_doctor_pi = __esm(async () => {
   init_migrate_config_location();
   init_project_security();
@@ -45729,14 +46237,14 @@ var init_doctor_pi = __esm(async () => {
     init_storage_versions(),
     init_v22_backfill_commands()
   ]);
-  import_comment_json13 = __toESM(require_src3(), 1);
+  import_comment_json14 = __toESM(require_src3(), 1);
   ROW_COUNT_TABLES2 = ["tags", "compartments", "memories", "notes", "dream_runs"];
-  DEFAULT_DEPS3 = {
+  DEFAULT_DEPS5 = {
     prompts: promptIO,
     collectDiagnostics: collectDiagnostics2,
     detectPiBinary,
     getPiVersion,
-    getLatestNpmVersion: () => getLatestNpmVersion(PACKAGE_NAME),
+    getLatestNpmVersion: () => getLatestNpmVersion(PACKAGE_NAME2),
     selfVersion: selfVersion2,
     probeEmbeddingEndpoint,
     openExistingContextDatabase,
@@ -45751,8 +46259,8 @@ var exports_doctor = {};
 __export(exports_doctor, {
   runDoctor: () => runDoctor4
 });
-import { existsSync as existsSync32, rmSync as rmSync5 } from "node:fs";
-import { join as join29 } from "node:path";
+import { existsSync as existsSync34, rmSync as rmSync5 } from "node:fs";
+import { join as join32 } from "node:path";
 async function runDoctor4(options) {
   if (options.clear)
     return runClear();
@@ -45770,7 +46278,7 @@ async function runDoctor4(options) {
     const result = await runV22BackfillCommands({
       name: "Magic Context",
       openDatabase: (readonly2 = true) => {
-        const dbPath = join29(getMagicContextStorageDir(), "context.db");
+        const dbPath = join32(getMagicContextStorageDir(), "context.db");
         v22Db = readonly2 ? openExistingContextDatabase(dbPath, { readonly: true }) : openExistingContextDatabaseForMutation(dbPath);
         return v22Db;
       },
@@ -45784,7 +46292,7 @@ async function runDoctor4(options) {
       return result.exitCode;
   }
   const { sweepPendingMigrations: sweepPendingMigrations2, formatMigrationSweepLines: formatMigrationSweepLines2 } = await init_migrate().then(() => exports_migrate);
-  const sweepDbPath = join29(getMagicContextStorageDir(), "context.db");
+  const sweepDbPath = join32(getMagicContextStorageDir(), "context.db");
   let sweepDb = null;
   try {
     sweepDb = openExistingContextDatabaseForMutation(sweepDbPath);
@@ -45880,7 +46388,7 @@ async function runClear() {
     const s = spinner2();
     s.start(`Clearing ${item.path}`);
     try {
-      if (existsSync32(item.path)) {
+      if (existsSync34(item.path)) {
         rmSync5(item.path, { recursive: true, force: true });
       }
       s.stop(`Cleared ${item.path}`);
@@ -46026,12 +46534,12 @@ async function main(argv = process.argv.slice(2)) {
           console.error("Usage: magic-context doctor drain-authority <project>");
           return 1;
         }
-        const [{ runDoctorDrainAuthority: runDoctorDrainAuthority2 }, { getMagicContextStorageDir: getMagicContextStorageDir2 }, { join: join30 }] = await Promise.all([
+        const [{ runDoctorDrainAuthority: runDoctorDrainAuthority2 }, { getMagicContextStorageDir: getMagicContextStorageDir2 }, { join: join33 }] = await Promise.all([
           init_doctor_authority().then(() => exports_doctor_authority),
           Promise.resolve().then(() => (init_data_path(), exports_data_path)),
           import("node:path")
         ]);
-        return runDoctorDrainAuthority2(projectRoot, join30(getMagicContextStorageDir2(), "context.db"));
+        return runDoctorDrainAuthority2(projectRoot, join33(getMagicContextStorageDir2(), "context.db"));
       }
       if (rest[0] === "merge-identity") {
         const { runMergeIdentityCli: runMergeIdentityCli2 } = await init_doctor_merge_identity().then(() => exports_doctor_merge_identity);