@cortexkit/magic-context 0.34.0 → 0.34.2

package/dist/index.js

@@ -11863,9 +11863,10 @@ function migrateLegacyExperimental(rawConfig, warnings) {
   const exp = experimental;
   const hasUM = "user_memories" in exp;
   const hasPKF = "pin_key_files" in exp;
+  const hasMural = "mural" in exp;
   const TOP_LEVEL_GRADUATED = ["temporal_awareness", "caveman_text_compression"];
   const MEMORY_GRADUATED = ["auto_search", "git_commit_indexing"];
-  const hasGraduated = TOP_LEVEL_GRADUATED.some((k) => (k in exp)) || MEMORY_GRADUATED.some((k) => (k in exp));
+  const hasGraduated = TOP_LEVEL_GRADUATED.some((k) => (k in exp)) || MEMORY_GRADUATED.some((k) => (k in exp)) || hasMural;
   if (!hasUM && !hasPKF && !hasGraduated) {
     return rawConfig;
   }
@@ -11873,6 +11874,15 @@ function migrateLegacyExperimental(rawConfig, warnings) {
   const dreamer = typeof patched.dreamer === "object" && patched.dreamer !== null ? { ...patched.dreamer } : {};
   const memory = typeof patched.memory === "object" && patched.memory !== null ? { ...patched.memory } : {};
   const newExperimental = { ...exp };
+  const coerceToObject = (value) => {
+    if (typeof value === "boolean") {
+      return { enabled: value };
+    }
+    if (typeof value === "object" && value !== null) {
+      return { ...value };
+    }
+    return;
+  };
   const relocate = (key, dest, destLabel) => {
     if (!(key in exp))
       return;
@@ -11893,15 +11903,20 @@ function migrateLegacyExperimental(rawConfig, warnings) {
     relocate(key, patched, "");
   for (const key of MEMORY_GRADUATED)
     relocate(key, memory, "memory.");
-  const coerceToObject = (value) => {
-    if (typeof value === "boolean") {
-      return { enabled: value };
-    }
-    if (typeof value === "object" && value !== null) {
-      return { ...value };
+  if (hasMural) {
+    const oldMural = coerceToObject(exp.mural);
+    const existingMural = patched.mural;
+    if (existingMural === undefined) {
+      patched.mural = oldMural ?? exp.mural;
+      warnings.push('Deprecated "experimental.mural"; use top-level "mural" instead (migrated in memory; run `doctor` to persist).');
+    } else if (oldMural !== undefined && typeof existingMural === "object" && existingMural !== null && !Array.isArray(existingMural)) {
+      patched.mural = {
+        ...oldMural,
+        ...existingMural
+      };
     }
-    return;
-  };
+    delete newExperimental.mural;
+  }
   if (hasUM) {
     const oldUM = coerceToObject(exp.user_memories);
     if (oldUM !== undefined) {
@@ -26915,12 +26930,10 @@ var init_magic_context = __esm(() => {
   MagicContextConfigSchema = exports_external.object({
     enabled: exports_external.boolean().default(true).describe("Enable magic context (default: true)"),
     allow_home_project: exports_external.boolean().default(false).describe("Allow Magic Context sessions launched from the exact canonical home directory. The home session uses its deterministic dir: identity so pre-gate memories reconnect. USER-LEVEL ONLY: project config is ignored. The home identity is excluded from registry seed exports, never resolves descendants by containment, and cannot join a workspace."),
-    experimental: exports_external.object({
-      mural: exports_external.object({
-        enabled: exports_external.boolean().default(false),
-        model: exports_external.string().trim().min(1).optional().describe("Model for the compress-cues task that compresses each memory into a mural cue. The mural image itself is rendered deterministically (no author model).")
-      }).default({ enabled: false }).describe("Experimental mural: a single deterministically-rendered image of project memories that did not fit the context budget. Cues are compressed per-memory by the compress-cues dreamer task.")
-    }).default({ mural: { enabled: false } }).describe("Experimental feature switches. User and project configuration are both accepted."),
+    mural: exports_external.object({
+      enabled: exports_external.boolean().default(false),
+      model: exports_external.string().trim().min(1).optional().describe("Model for the compress-cues task that compresses each memory into a mural cue. The mural image itself is rendered deterministically (no author model).")
+    }).default({ enabled: false }).describe("Experimental mural: a single deterministically-rendered image of project memories that did not fit the context budget. Cues are compressed per-memory by the compress-cues dreamer task."),
     transform_mode: exports_external.enum(["ts", "rust"]).default("ts").describe('Experimental: routes the entire Magic Context runtime for the project through the ck-mc Rust module over subc (requires user-level `subc` config); "ts" is the current TypeScript pipeline.'),
     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."),
@@ -27187,6 +27200,17 @@ function stripUnsafeProjectConfigFields(projectRaw) {
       warnings.push(`Ignoring historian.${removed.join("/")} from project config ` + "(security: historian model selection is user-level only; a repository cannot force extra compaction cost).");
     }
   }
+  const mural = projectRaw.mural;
+  if (isPlainObject2(mural) && "model" in mural) {
+    delete mural.model;
+    warnings.push("Ignoring mural.model from project config (security: the mural cue-compressor model is a user-level setting; a repository cannot choose where project memory is sent).");
+  }
+  const experimental = projectRaw.experimental;
+  const legacyMural = isPlainObject2(experimental) ? experimental.mural : undefined;
+  if (isPlainObject2(legacyMural) && "model" in legacyMural) {
+    delete legacyMural.model;
+    warnings.push("Ignoring experimental.mural.model from project config (security: the mural cue-compressor model is a user-level setting; use user-level mural.model).");
+  }
   for (const agentKey of HIDDEN_AGENT_KEYS) {
     const block2 = projectRaw[agentKey];
     if (!isPlainObject2(block2))
@@ -32996,6 +33020,8 @@ var init_module_transport = __esm(() => {
   init_data_path();
 });
 // ../plugin/src/shared/rpc-utils.ts
+import { execFileSync as execFileSync4 } from "node:child_process";
+import { readFileSync as readFileSync9 } from "node:fs";
 function isPidAlive(pid) {
   if (!Number.isInteger(pid) || pid <= 0)
     return false;
@@ -33006,6 +33032,76 @@ function isPidAlive(pid) {
     return err.code === "EPERM";
   }
 }
+function parseLinuxProcessStartTime(statContent, uptimeContent) {
+  const closingCommandName = statContent.lastIndexOf(")");
+  if (closingCommandName < 0)
+    return null;
+  const statFields = statContent.slice(closingCommandName + 1).trim().split(/\s+/);
+  const startTimeTicks = Number(statFields[19]);
+  const uptimeSeconds = Number(uptimeContent.trim().split(/\s+/)[0]);
+  if (!Number.isFinite(startTimeTicks) || startTimeTicks < 0 || !Number.isFinite(uptimeSeconds) || uptimeSeconds < 0) {
+    return null;
+  }
+  const processStartTime = rpcIdentityNowMs() - uptimeSeconds * 1000 + startTimeTicks / LINUX_CLOCK_TICKS_PER_SECOND * 1000;
+  return Number.isFinite(processStartTime) ? processStartTime : null;
+}
+function readLinuxProcessStartTime(pid) {
+  try {
+    const statContent = String(rpcIdentityReadFileSync(`/proc/${pid}/stat`, "utf8"));
+    const uptimeContent = String(rpcIdentityReadFileSync("/proc/uptime", "utf8"));
+    return parseLinuxProcessStartTime(statContent, uptimeContent);
+  } catch {
+    return null;
+  }
+}
+function readPsProcessStartTime(pid) {
+  try {
+    const output = rpcIdentityExecFileSync("ps", ["-p", String(pid), "-o", "lstart="], {
+      encoding: "utf8",
+      timeout: PS_PROBE_TIMEOUT_MS
+    });
+    const processStartTime = Date.parse(String(output).trim());
+    return Number.isFinite(processStartTime) ? processStartTime : null;
+  } catch {
+    return null;
+  }
+}
+function readLinuxProcessCommand(pid) {
+  try {
+    return String(rpcIdentityReadFileSync(`/proc/${pid}/cmdline`, "utf8"));
+  } catch {
+    return null;
+  }
+}
+function readPsProcessCommand(pid) {
+  try {
+    const output = rpcIdentityExecFileSync("ps", ["-p", String(pid), "-o", "command="], {
+      encoding: "utf8",
+      timeout: PS_PROBE_TIMEOUT_MS
+    });
+    return String(output);
+  } catch {
+    return null;
+  }
+}
+function commandLooksLikeOpenCode(command) {
+  const normalized = command.toLowerCase();
+  return OPEN_CODE_COMMAND_MARKERS.some((marker) => normalized.includes(marker));
+}
+function isPidIdentityPlausible(record2) {
+  if (!Number.isInteger(record2.pid) || record2.pid <= 0)
+    return false;
+  if (Number.isFinite(record2.started_at) && record2.started_at > 0) {
+    const processStartTime = rpcIdentityPlatform === "linux" ? readLinuxProcessStartTime(record2.pid) : readPsProcessStartTime(record2.pid);
+    if (processStartTime === null)
+      return true;
+    return processStartTime <= record2.started_at + RPC_IDENTITY_SKEW_TOLERANCE_MS;
+  }
+  const command = rpcIdentityPlatform === "linux" ? readLinuxProcessCommand(record2.pid) : readPsProcessCommand(record2.pid);
+  if (command === null)
+    return true;
+  return commandLooksLikeOpenCode(command);
+}
 function parseRpcPortFile(content, fallbackPid = 0) {
   const trimmed = content.trim();
   if (!trimmed)
@@ -33037,7 +33133,13 @@ function parseRpcPortFile(content, fallbackPid = 0) {
 function isValidPort(port) {
   return Number.isInteger(port) && port > 0 && port <= 65535;
 }
-var init_rpc_utils = () => {};
+var RPC_IDENTITY_SKEW_TOLERANCE_MS = 120000, LINUX_CLOCK_TICKS_PER_SECOND = 100, PS_PROBE_TIMEOUT_MS = 1000, OPEN_CODE_COMMAND_MARKERS, rpcIdentityReadFileSync, rpcIdentityExecFileSync, rpcIdentityPlatform, rpcIdentityNowMs = () => Date.now();
+var init_rpc_utils = __esm(() => {
+  OPEN_CODE_COMMAND_MARKERS = ["opencode", "node", "bun", "electron"];
+  rpcIdentityReadFileSync = readFileSync9;
+  rpcIdentityExecFileSync = execFileSync4;
+  rpcIdentityPlatform = process.platform;
+});
 // ../plugin/src/hooks/magic-context/compartment-parser.ts
 function makeTierOpenRegex(n2) {
   return new RegExp(`<p${n2}\\s*(/?)>`);
@@ -33498,7 +33600,7 @@ function installLatestAuthorityTriggers(db) {
         `);
   }
 }
-var MIGRATIONS, LATEST_MIGRATION_VERSION;
+var FORK_MIGRATION_VERSION_FLOOR = 1e4, MIGRATIONS, LATEST_MIGRATION_VERSION;
 var init_migrations = __esm(() => {
   init_compartment_parser();
   init_logger();
@@ -35421,6 +35523,15 @@ var init_migrations = __esm(() => {
           ensureColumn(db, "session_meta", "detected_context_limit_provenance", "TEXT NOT NULL DEFAULT 'unknown'");
         }
       }
+    },
+    {
+      version: 75,
+      description: "persist mural cue validation rejection latches",
+      up(db) {
+        if (!tableExists(db, "memories"))
+          return;
+        ensureColumn(db, "memories", "mural_cue_rejection_count", "INTEGER NOT NULL DEFAULT 0");
+      }
     }
   ];
   LATEST_MIGRATION_VERSION = MIGRATIONS.reduce((max, m3) => Math.max(max, m3.version), 0);
@@ -167912,7 +168023,8 @@ import {
   mkdirSync as mkdirSync7,
   mkdtempSync,
   readdirSync as readdirSync2,
-  readFileSync as readFileSync9,
+  readFileSync as readFileSync10,
+  statSync as statSync7,
   unlinkSync as unlinkSync2
 } from "node:fs";
 import { basename as basename3, dirname as dirname10, join as join12 } from "node:path";
@@ -167921,27 +168033,60 @@ function getPersistedSchemaVersion(db) {
   if (!hasMigrationsTable) {
     return 0;
   }
-  const row = db.prepare("SELECT MAX(version) AS version FROM schema_migrations").get();
+  const row = db.prepare("SELECT COALESCE(MAX(version), 0) AS version FROM schema_migrations WHERE version < ?").get(FORK_MIGRATION_VERSION_FLOOR);
   return row?.version ?? 0;
 }
-function unreadableDiscovery(path4) {
+function unreadableDiscovery(path4, arm) {
   return {
     state: "unreadable",
     serverPids: [],
     staleFiles: [],
-    unreadableFile: path4
+    unreadableFile: path4,
+    unreadableArm: arm
   };
 }
+function invalidDiscoveryReason(raw) {
+  const trimmed = raw.trim();
+  if (trimmed.startsWith("{")) {
+    try {
+      const parsed = JSON.parse(trimmed);
+      if ("pid" in parsed) {
+        const pid = Number(parsed.pid);
+        if (!Number.isInteger(pid) || pid <= 0)
+          return "invalid-pid";
+      }
+    } catch {}
+  }
+  return "parse-invalid";
+}
+function classifyJunkDiscovery(portFile, raw, staleFiles) {
+  let mtimeMs;
+  try {
+    mtimeMs = rpcDiscoveryFs.statSync(portFile).mtimeMs;
+  } catch (error51) {
+    if (error51.code === "ENOENT")
+      return null;
+    return unreadableDiscovery(portFile, "io");
+  }
+  const ageMs = Date.now() - mtimeMs;
+  if (!Number.isFinite(ageMs) || ageMs < RPC_DISCOVERY_PARSE_GRACE_MS) {
+    return unreadableDiscovery(portFile, "parse");
+  }
+  staleFiles.push(portFile);
+  const reason = invalidDiscoveryReason(raw);
+  log3(`[magic-context] removing stale RPC discovery file ${portFile}: ${reason} record older than 10 minutes`);
+  return null;
+}
 function inspectRpcServerDiscovery(storageDir) {
   const rpcRoot = join12(storageDir, "rpc");
   let projectEntries;
   try {
-    projectEntries = readdirSync2(rpcRoot, { withFileTypes: true });
+    projectEntries = rpcDiscoveryFs.readdirSync(rpcRoot, { withFileTypes: true });
   } catch (error51) {
     if (error51.code === "ENOENT") {
       return { state: "absent", serverPids: [], staleFiles: [] };
     }
-    return unreadableDiscovery(rpcRoot);
+    return unreadableDiscovery(rpcRoot, "io");
   }
   const portFiles = [];
   for (const projectEntry of projectEntries) {
@@ -167950,9 +168095,11 @@ function inspectRpcServerDiscovery(storageDir) {
     const projectDir = join12(rpcRoot, projectEntry.name);
     let entries;
     try {
-      entries = readdirSync2(projectDir);
-    } catch {
-      return unreadableDiscovery(projectDir);
+      entries = rpcDiscoveryFs.readdirSync(projectDir);
+    } catch (error51) {
+      if (error51.code === "ENOENT")
+        continue;
+      return unreadableDiscovery(projectDir, "io");
     }
     for (const entry of entries) {
       if (entry === "port" || entry.startsWith("port-") && entry.endsWith(".json")) {
@@ -167968,32 +168115,38 @@ function inspectRpcServerDiscovery(storageDir) {
   for (const portFile of portFiles) {
     let raw;
     try {
-      raw = readFileSync9(portFile, "utf8");
-    } catch {
-      return unreadableDiscovery(portFile);
+      raw = rpcDiscoveryFs.readFileSync(portFile, "utf8");
+    } catch (error51) {
+      if (error51.code === "ENOENT")
+        continue;
+      return unreadableDiscovery(portFile, "io");
     }
     const filename = basename3(portFile);
     const pidFromName = /^port-(\d+)/.exec(filename)?.[1];
-    const record2 = parseRpcPortFile(raw, pidFromName ? Number(pidFromName) : 0);
+    const fallbackPid = pidFromName ? Number(pidFromName) : 0;
+    const record2 = parseRpcPortFile(raw, fallbackPid);
     if (!record2 || !Number.isInteger(record2.pid) || record2.pid <= 0) {
-      return unreadableDiscovery(portFile);
+      const junk = classifyJunkDiscovery(portFile, raw, staleFiles);
+      if (junk)
+        return junk;
+      continue;
     }
-    if (isPidAlive(record2.pid))
+    if (isPidAlive(record2.pid) && isPidIdentityPlausible(record2))
       pids.add(record2.pid);
     else
       staleFiles.push(portFile);
   }
-  const serverPids = [...pids].sort((a3, b2) => a3 - b2);
-  if (serverPids.length > 0) {
-    return { state: "live", serverPids, staleFiles };
-  }
   for (const staleFile of staleFiles) {
     try {
-      unlinkSync2(staleFile);
+      rpcDiscoveryFs.unlinkSync(staleFile);
     } catch {
-      return unreadableDiscovery(staleFile);
+      return unreadableDiscovery(staleFile, "io");
     }
   }
+  const serverPids = [...pids].sort((a3, b2) => a3 - b2);
+  if (serverPids.length > 0) {
+    return { state: "live", serverPids, staleFiles };
+  }
   return { state: "stale", serverPids: [], staleFiles };
 }
 function getLiveMigrationBlockingProcesses(storageDir) {
@@ -168002,7 +168155,7 @@ function getLiveMigrationBlockingProcesses(storageDir) {
     return [];
   return discovery.serverPids.map((pid) => ({ harness: "OpenCode server", pid }));
 }
-var databases, pendingAsyncOpens, persistenceByDatabase, persistenceErrorByDatabase, pathByDatabase, LATEST_SUPPORTED_VERSION = 74, PERMISSIONS_ENFORCEABLE;
+var databases, pendingAsyncOpens, persistenceByDatabase, persistenceErrorByDatabase, pathByDatabase, LATEST_SUPPORTED_VERSION = 75, PERMISSIONS_ENFORCEABLE, RPC_DISCOVERY_PARSE_GRACE_MS, defaultRpcDiscoveryFs, rpcDiscoveryFs;
 var init_storage_db = __esm(async () => {
   init_data_path();
   init_logger();
@@ -168020,6 +168173,14 @@ var init_storage_db = __esm(async () => {
   persistenceErrorByDatabase = new WeakMap;
   pathByDatabase = new WeakMap;
   PERMISSIONS_ENFORCEABLE = process.platform !== "win32";
+  RPC_DISCOVERY_PARSE_GRACE_MS = 10 * 60 * 1000;
+  defaultRpcDiscoveryFs = {
+    readdirSync: (path4, options) => options?.withFileTypes ? readdirSync2(path4, { withFileTypes: true }) : readdirSync2(path4),
+    readFileSync: (path4, encoding) => String(readFileSync10(path4, encoding)),
+    statSync: (path4) => ({ mtimeMs: statSync7(path4).mtimeMs }),
+    unlinkSync: (path4) => unlinkSync2(path4)
+  };
+  rpcDiscoveryFs = defaultRpcDiscoveryFs;
 });
 
 // src/lib/database-access.ts
@@ -170037,9 +170198,9 @@ import {
   chmodSync as chmodSync3,
   existsSync as existsSync19,
   mkdirSync as mkdirSync8,
-  readFileSync as readFileSync10,
+  readFileSync as readFileSync11,
   renameSync as renameSync3,
-  statSync as statSync7,
+  statSync as statSync8,
   writeFileSync as writeFileSync6
 } from "node:fs";
 import { dirname as dirname11, join as join17 } from "node:path";
@@ -170075,8 +170236,8 @@ function writeTuiConfigAtomic(configPath, config2) {
   const tmpPath = `${configPath}.tmp`;
   writeFileSync6(tmpPath, body);
   try {
-    if (statSync7(configPath, { throwIfNoEntry: false })?.isFile()) {
-      chmodSync3(tmpPath, statSync7(configPath).mode & 511);
+    if (statSync8(configPath, { throwIfNoEntry: false })?.isFile()) {
+      chmodSync3(tmpPath, statSync8(configPath).mode & 511);
     }
   } catch {}
   renameSync3(tmpPath, configPath);
@@ -170096,7 +170257,7 @@ function ensureTuiPluginEntry(options = {}) {
     const configPath = resolveTuiConfigPath(options.configDir);
     let config2 = {};
     if (existsSync19(configPath)) {
-      const raw = readFileSync10(configPath, "utf-8");
+      const raw = readFileSync11(configPath, "utf-8");
       config2 = import_comment_json7.parse(raw) ?? {};
     }
     const plugins = Array.isArray(config2.plugin) ? [...config2.plugin] : [];
@@ -170356,7 +170517,7 @@ var init_redaction2 = __esm(() => {
 });
 
 // src/lib/diagnostics-opencode.ts
-import { existsSync as existsSync20, readdirSync as readdirSync3, readFileSync as readFileSync11, statSync as statSync8 } from "node:fs";
+import { existsSync as existsSync20, readdirSync as readdirSync3, readFileSync as readFileSync12, statSync as statSync9 } from "node:fs";
 import { createRequire as createRequire2 } from "node:module";
 import { homedir as homedir14 } from "node:os";
 import { join as join18 } from "node:path";
@@ -170378,7 +170539,7 @@ function getPluginCacheInfo() {
   for (const installedPkgPath of getOpenCodePluginPackageJsonPaths()) {
     try {
       if (existsSync20(installedPkgPath)) {
-        const pkg = JSON.parse(readFileSync11(installedPkgPath, "utf-8"));
+        const pkg = JSON.parse(readFileSync12(installedPkgPath, "utf-8"));
         cached2 = typeof pkg.version === "string" ? pkg.version : undefined;
         if (cached2)
           break;
@@ -170395,7 +170556,7 @@ function getStorageDir() {
 }
 function fileSize(path6) {
   try {
-    return existsSync20(path6) ? statSync8(path6).size : 0;
+    return existsSync20(path6) ? statSync9(path6).size : 0;
   } catch {
     return 0;
   }
@@ -170410,7 +170571,7 @@ function readConfig2(path6) {
   if (!existsSync20(path6))
     return { value: null };
   try {
-    const raw = readFileSync11(path6, "utf-8");
+    const raw = readFileSync12(path6, "utf-8");
     const value = import_comment_json8.parse(raw);
     return { value };
   } catch (error51) {
@@ -170435,7 +170596,7 @@ function configHasPluginEntry(config2) {
 }
 function parseHistorianDumpMeta(path6) {
   try {
-    const xml = readFileSync11(path6, "utf-8");
+    const xml = readFileSync12(path6, "utf-8");
     const parsed = parseCompartmentOutput(xml);
     const factCountByCategory = {};
     for (const fact of parsed.facts) {
@@ -170472,7 +170633,7 @@ function listDumpsInDir(dir, limit) {
     return { count: 0, recent: [] };
   try {
     const entries = readdirSync3(dir).filter((name2) => name2.endsWith(".xml")).map((name2) => {
-      const stat = statSync8(join18(dir, name2));
+      const stat = statSync9(join18(dir, name2));
       return {
         name: name2,
         mtime: stat.mtimeMs,
@@ -170678,7 +170839,7 @@ async function collectDiagnostics() {
   const storageDirPath = getStorageDir();
   const contextDbPath = join18(storageDirPath, "context.db");
   const logPath = getMagicContextLogPath2("opencode");
-  const logFileSize = existsSync20(logPath) ? statSync8(logPath).size : 0;
+  const logFileSize = existsSync20(logPath) ? statSync9(logPath).size : 0;
   let compactionEnabled = false;
   try {
     compactionEnabled = isCompactionEnabled(loadPluginConfig(process.cwd()));
@@ -171194,7 +171355,7 @@ var init_issue_body = __esm(() => {
 });
 
 // src/lib/logs-opencode.ts
-import { readFileSync as readFileSync12, writeFileSync as writeFileSync7 } from "node:fs";
+import { readFileSync as readFileSync13, writeFileSync as writeFileSync7 } from "node:fs";
 import { join as join20 } from "node:path";
 function sanitizeLogContent(content) {
   return sanitizeDiagnosticText(content);
@@ -171237,7 +171398,7 @@ function filterLogLinesBySession(lines, sessionId) {
 }
 async function bundleIssueReport(report, description, title, sessionFilter = null) {
   const LOG_TAIL_LINES = 400;
-  const allLogLines = report.logFile.exists ? readFileSync12(report.logFile.path, "utf-8").split(/\r?\n/) : [];
+  const allLogLines = report.logFile.exists ? readFileSync13(report.logFile.path, "utf-8").split(/\r?\n/) : [];
   const logLines = filterLogLinesBySession(allLogLines, sessionFilter);
   const recentLog = sanitizeLogContent(logLines.slice(-LOG_TAIL_LINES).join(`
 `)).trim();
@@ -171577,6 +171738,15 @@ function formatFailClosedBlockingProcesses(processes) {
 }
 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.`;
+      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.`,
+        recovery,
+        `Recovery: ${FAIL_CLOSED_DOCTOR_COMMAND}`
+      ].join(" ");
+    }
     return [
       `Magic Context cannot migrate the shared database because ${formatFailClosedBlockingProcesses(reason.blockingProcesses)} may be running an older Magic Context build that would fail against the migrated database.`,
       "Restart the blocking process (it will pick up the new build and migrate on start), or shut it down and retry.",
@@ -171585,7 +171755,7 @@ function formatFailClosedBlockingMessage(reason) {
   }
   if (reason.kind === "schema_fence") {
     return [
-      `Magic Context cannot operate: this Magic Context build is older than the database; upgrade/restart this harness (database schema v${reason.persistedVersion}, build supports through v${reason.supportedVersion}).`,
+      `Magic Context cannot operate: this Magic Context build is older than the database; upgrade/restart this harness (upstream migration lane v${reason.persistedVersion}, build supports through v${reason.supportedVersion}).`,
       `Recovery: ${FAIL_CLOSED_DOCTOR_COMMAND}`
     ].join(" ");
   }
@@ -171610,7 +171780,7 @@ function checkStorageVersionFence(versions2, options = {}) {
   if (databaseVersion > supportedVersion) {
     return {
       alarm: true,
-      message: `Storage schema fence alarm: context.db is v${databaseVersion}, but this build supports through v${supportedVersion}. ` + `${STALE_BUILD_RESTART_INSTRUCTION}.`
+      message: `Upstream migration fence alarm: context.db is v${databaseVersion}, but this build supports through v${supportedVersion}. ` + `${STALE_BUILD_RESTART_INSTRUCTION}.`
     };
   }
   if (databaseVersion < supportedVersion) {
@@ -171627,12 +171797,12 @@ function checkStorageVersionFence(versions2, options = {}) {
     }
     return {
       alarm: false,
-      message: `Storage schema migrations pending: context.db is v${databaseVersion}; this build supports through v${supportedVersion}.`
+      message: `Upstream migrations pending: context.db is v${databaseVersion}; this build supports through v${supportedVersion}.`
     };
   }
   return {
     alarm: false,
-    message: `Storage schema fence: context.db and this build are both v${supportedVersion}.`
+    message: `Upstream migration fence: context.db and this build are both v${supportedVersion}.`
   };
 }
 function readStorageVersions(db) {
@@ -171651,13 +171821,13 @@ var init_storage_versions = __esm(async () => {
 });
 
 // src/commands/doctor-opencode-cache.ts
-import { existsSync as existsSync22, readFileSync as readFileSync13, rmSync as rmSync2 } from "node:fs";
+import { existsSync as existsSync22, readFileSync as readFileSync14, rmSync as rmSync2 } from "node:fs";
 function readCachedPluginVersion(pluginCacheDir) {
   try {
     const installedPkgPath = getOpenCodePluginPackageJsonPath(pluginCacheDir);
     if (!existsSync22(installedPkgPath))
       return;
-    const pkg = JSON.parse(readFileSync13(installedPkgPath, "utf-8"));
+    const pkg = JSON.parse(readFileSync14(installedPkgPath, "utf-8"));
     return typeof pkg.version === "string" ? pkg.version : undefined;
   } catch {
     return;
@@ -171734,7 +171904,7 @@ var init_doctor_opencode_cache = __esm(() => {
 
 // src/commands/doctor-opencode.ts
 import { execSync as execSync2, spawnSync as spawnSync3 } from "node:child_process";
-import { existsSync as existsSync23, readFileSync as readFileSync14, statSync as statSync9 } from "node:fs";
+import { existsSync as existsSync23, readFileSync as readFileSync15, statSync as statSync10 } from "node:fs";
 import { createRequire as createRequire4 } from "node:module";
 import { homedir as homedir15 } from "node:os";
 import { join as join21 } from "node:path";
@@ -171844,7 +172014,7 @@ function collectNpmReleaseAgeWarnings() {
   if (!existsSync23(npmrcPath))
     return ageWarnings;
   try {
-    const npmrc = readFileSync14(npmrcPath, "utf-8");
+    const npmrc = readFileSync15(npmrcPath, "utf-8");
     for (const line of npmrc.split(`
 `)) {
       const trimmed = line.trim();
@@ -171988,7 +172158,7 @@ async function checkEmbeddingConfig(magicContextConfigPath) {
   }
   let rawText;
   try {
-    rawText = readFileSync14(magicContextConfigPath, "utf-8");
+    rawText = readFileSync15(magicContextConfigPath, "utf-8");
   } catch {
     log2.warn("Could not read magic-context.jsonc for embedding check");
     return { issues: 1 };
@@ -172197,7 +172367,7 @@ async function runDoctor(options = {}) {
   if (existsSync23(paths.magicContextConfig)) {
     pass(`Magic Context config: ${paths.magicContextConfig}`);
     try {
-      const raw = readFileSync14(paths.magicContextConfig, "utf-8");
+      const raw = readFileSync15(paths.magicContextConfig, "utf-8");
       const substituted = substituteConfigVariables({
         text: raw,
         configPath: paths.magicContextConfig
@@ -172224,7 +172394,7 @@ async function runDoctor(options = {}) {
   }
   if (existsSync23(paths.magicContextConfig)) {
     try {
-      const mcRaw = readFileSync14(paths.magicContextConfig, "utf-8");
+      const mcRaw = readFileSync15(paths.magicContextConfig, "utf-8");
       const mcConfig = import_comment_json9.parse(mcRaw);
       let mcChanged = false;
       const experimental = mcConfig.experimental;
@@ -172309,6 +172479,7 @@ async function runDoctor(options = {}) {
       if (experimental) {
         relocateGraduated("temporal_awareness", mcConfig, "");
         relocateGraduated("caveman_text_compression", mcConfig, "");
+        relocateGraduated("mural", mcConfig, "");
         const memoryDest = mcConfig.memory ?? {};
         relocateGraduated("auto_search", memoryDest, "memory.");
         relocateGraduated("git_commit_indexing", memoryDest, "memory.");
@@ -172341,7 +172512,7 @@ async function runDoctor(options = {}) {
   }
   if (paths.opencodeConfigFormat !== "none") {
     try {
-      const raw = readFileSync14(paths.opencodeConfig, "utf-8");
+      const raw = readFileSync15(paths.opencodeConfig, "utf-8");
       const config2 = import_comment_json9.parse(raw);
       const rawPlugins = Array.isArray(config2?.plugin) ? config2.plugin : [];
       const existingIdx = rawPlugins.findIndex((entry) => matchesPluginEntry(entry, OPENCODE_PLUGIN_NAME) || isDevPathPluginEntry(entry));
@@ -172427,7 +172598,7 @@ async function runDoctor(options = {}) {
     fixed++;
   } else if (existsSync23(paths.tuiConfig)) {
     try {
-      const tuiRaw = readFileSync14(paths.tuiConfig, "utf-8");
+      const tuiRaw = readFileSync15(paths.tuiConfig, "utf-8");
       const tuiConfig = import_comment_json9.parse(tuiRaw);
       const tuiRawPlugins = Array.isArray(tuiConfig?.plugin) ? tuiConfig.plugin : [];
       const tuiIdx = tuiRawPlugins.findIndex((entry) => matchesPluginEntry(entry, OPENCODE_PLUGIN_NAME) || isDevPathPluginEntry(entry));
@@ -172478,7 +172649,7 @@ async function runDoctor(options = {}) {
   }
   if (existsSync23(paths.magicContextConfig)) {
     try {
-      const mcRaw = readFileSync14(paths.magicContextConfig, "utf-8");
+      const mcRaw = readFileSync15(paths.magicContextConfig, "utf-8");
       const mcConfig = import_comment_json9.parse(mcRaw);
       const warning = checkUserMemoriesDreamerCompatibility(mcConfig);
       if (warning) {
@@ -172601,7 +172772,7 @@ async function runDoctor(options = {}) {
   }
   const logPath = getMagicContextLogPath2("opencode");
   if (existsSync23(logPath)) {
-    const logStat = statSync9(logPath);
+    const logStat = statSync10(logPath);
     const sizeKb = (logStat.size / 1024).toFixed(0);
     log2.info(`Log file: ${logPath} (${sizeKb} KB)`);
   } else {
@@ -172680,7 +172851,7 @@ var init_doctor_opencode = __esm(async () => {
 });
 
 // ../pi-plugin/src/config/index.ts
-import { existsSync as existsSync24, readFileSync as readFileSync15 } from "node:fs";
+import { existsSync as existsSync24, readFileSync as readFileSync16 } from "node:fs";
 function getProjectConfigPaths(cwd) {
   const basePath = cortexKitProjectConfigBasePath(cwd);
   return [`${basePath}.jsonc`, `${basePath}.json`];
@@ -172697,7 +172868,7 @@ function resolvePiLegacyFallback(sources) {
 }
 function loadConfigFile(path6, scope) {
   try {
-    const rawText = readFileSync15(path6, "utf-8");
+    const rawText = readFileSync16(path6, "utf-8");
     const substituted = substituteConfigVariables({
       text: rawText,
       configPath: path6,
@@ -172904,7 +173075,7 @@ var init_config2 = __esm(() => {
 
 // src/lib/diagnostics-pi.ts
 import { createHash as createHash4 } from "node:crypto";
-import { existsSync as existsSync25, readdirSync as readdirSync4, readFileSync as readFileSync16, statSync as statSync10 } from "node:fs";
+import { existsSync as existsSync25, readdirSync as readdirSync4, readFileSync as readFileSync17, statSync as statSync11 } from "node:fs";
 import { createRequire as createRequire5 } from "node:module";
 import { homedir as homedir16, userInfo as userInfo2 } from "node:os";
 import { join as join22 } from "node:path";
@@ -172922,7 +173093,7 @@ function getSelfVersion3() {
 }
 function fileSize2(path6) {
   try {
-    return existsSync25(path6) ? statSync10(path6).size : 0;
+    return existsSync25(path6) ? statSync11(path6).size : 0;
   } catch {
     return 0;
   }
@@ -172978,7 +173149,7 @@ function readJsonc(path6) {
     return { value: {} };
   try {
     return {
-      value: import_comment_json11.parse(readFileSync16(path6, "utf-8"))
+      value: import_comment_json11.parse(readFileSync17(path6, "utf-8"))
     };
   } catch (error51) {
     return {
@@ -173030,7 +173201,7 @@ function collectPiRecentSessions() {
       }
       for (const file2 of files) {
         try {
-          const mtime = statSync10(join22(slugDir, file2)).mtimeMs;
+          const mtime = statSync11(join22(slugDir, file2)).mtimeMs;
           const sessionId = file2.replace(/\.jsonl$/, "");
           candidates.push({ sessionId, directory, mtime });
         } catch {}
@@ -173048,7 +173219,7 @@ function collectPiRecentSessions() {
 }
 function parseHistorianDumpMeta2(path6) {
   try {
-    const xml = readFileSync16(path6, "utf-8");
+    const xml = readFileSync17(path6, "utf-8");
     const parsed = parseCompartmentOutput(xml);
     const factCountByCategory = {};
     for (const fact of parsed.facts) {
@@ -173085,7 +173256,7 @@ function listDumpsInDir2(dir, limit) {
     return { count: 0, recent: [] };
   try {
     const entries = readdirSync4(dir).filter((name2) => name2.endsWith(".xml")).map((name2) => {
-      const stat = statSync10(join22(dir, name2));
+      const stat = statSync11(join22(dir, name2));
       return {
         name: name2,
         mtime: stat.mtimeMs,
@@ -173159,7 +173330,7 @@ async function collectDiagnostics2(cwd = process.cwd()) {
   const storageDirPath = getMagicContextStorageDir();
   const dbPath = join22(storageDirPath, "context.db");
   const logPath = getMagicContextLogPath2("pi");
-  const logFileSize = existsSync25(logPath) ? statSync10(logPath).size : 0;
+  const logFileSize = existsSync25(logPath) ? statSync11(logPath).size : 0;
   const otherPiExtensions = packages.filter((entry) => !isPiMagicContextPackageEntry(entry)).map(describePiPackageEntry);
   const recentSessions = collectPiRecentSessions();
   const historianDumps = collectPiHistorianDumps(recentSessions);
@@ -173293,7 +173464,7 @@ var init_diagnostics_pi = __esm(() => {
 });
 
 // src/lib/logs-pi.ts
-import { readFileSync as readFileSync17, writeFileSync as writeFileSync8 } from "node:fs";
+import { readFileSync as readFileSync18, writeFileSync as writeFileSync8 } from "node:fs";
 import { join as join23 } from "node:path";
 function sanitizeLogContent2(content) {
   return sanitizeString2(content);
@@ -173323,7 +173494,7 @@ function filterLogLinesBySession2(lines, sessionId) {
 }
 async function bundleIssueReport2(report, description, title, options = {}) {
   const LOG_TAIL_LINES = 400;
-  const allLogLines = report.logFile.exists ? readFileSync17(report.logFile.path, "utf-8").split(/\r?\n/) : [];
+  const allLogLines = report.logFile.exists ? readFileSync18(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();
@@ -173370,8 +173541,8 @@ var init_logs_pi = __esm(() => {
 });
 
 // src/commands/doctor-pi.ts
-import { execFileSync as execFileSync4, spawnSync as spawnSync4 } from "node:child_process";
-import { existsSync as existsSync26, mkdirSync as mkdirSync9, readdirSync as readdirSync5, readFileSync as readFileSync18, rmSync as rmSync3, statSync as statSync11 } from "node:fs";
+import { execFileSync as execFileSync5, spawnSync as spawnSync4 } from "node:child_process";
+import { existsSync as existsSync26, mkdirSync as mkdirSync9, readdirSync as readdirSync5, readFileSync as readFileSync19, rmSync as rmSync3, statSync as statSync12 } from "node:fs";
 import { createRequire as createRequire6 } from "node:module";
 import { homedir as homedir17 } from "node:os";
 import { dirname as dirname13, isAbsolute as isAbsolute4, join as join24 } from "node:path";
@@ -173410,7 +173581,7 @@ function selfVersion() {
 }
 function getLatestNpmVersion(packageName) {
   try {
-    return execFileSync4("npm", ["view", packageName, "version"], {
+    return execFileSync5("npm", ["view", packageName, "version"], {
       encoding: "utf-8",
       stdio: ["ignore", "pipe", "ignore"],
       timeout: 1e4
@@ -173464,7 +173635,7 @@ function summarize(results) {
 function readJsonc2(path6) {
   try {
     return {
-      value: import_comment_json12.parse(readFileSync18(path6, "utf-8"))
+      value: import_comment_json12.parse(readFileSync19(path6, "utf-8"))
     };
   } catch (error51) {
     return {
@@ -173497,7 +173668,7 @@ function readConfigForEmbedding(path6, isProjectConfig) {
   if (!existsSync26(path6))
     return null;
   try {
-    const rawText = readFileSync18(path6, "utf-8");
+    const rawText = readFileSync19(path6, "utf-8");
     const substituted = substituteConfigVariables({
       text: rawText,
       configPath: path6,
@@ -173587,7 +173758,7 @@ function findPiMagicContextCacheDirs(cwd, expectedVersion, force = false) {
       return;
     let stat;
     try {
-      stat = statSync11(path6);
+      stat = statSync12(path6);
     } catch {
       return;
     }
@@ -173596,7 +173767,7 @@ function findPiMagicContextCacheDirs(cwd, expectedVersion, force = false) {
     const packageJson = join24(path6, "package.json");
     if (existsSync26(packageJson)) {
       try {
-        const pkg = JSON.parse(readFileSync18(packageJson, "utf-8"));
+        const pkg = JSON.parse(readFileSync19(packageJson, "utf-8"));
         const name2 = typeof pkg.name === "string" ? pkg.name : "";
         const version2 = typeof pkg.version === "string" ? pkg.version : undefined;
         if (name2 === PACKAGE_NAME) {
@@ -173850,9 +174021,9 @@ async function runHealthChecks(options) {
   }
   const logPath = getMagicContextLogPath2("pi");
   if (existsSync26(logPath)) {
-    const stat = statSync11(logPath);
+    const stat = statSync12(logPath);
     const sizeKb = (stat.size / 1024).toFixed(0);
-    const lines = readFileSync18(logPath, "utf-8").split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
+    const lines = readFileSync19(logPath, "utf-8").split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
     add(results, "info", `Log file: ${logPath} (${sizeKb} KB)`);
     const lastLine = lines.at(-1);
     add(results, "info", `Last plugin log line: ${lastLine ? sanitizeDiagnosticText(lastLine) : "<empty log>"}`);
@@ -174130,7 +174301,7 @@ var init_doctor_pi = __esm(async () => {
     probeEmbeddingEndpoint,
     openExistingContextDatabase,
     now: () => new Date,
-    execFileSync: execFileSync4,
+    execFileSync: execFileSync5,
     spawnSync: spawnSync4
   };
 });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cortexkit/magic-context",
-  "version": "0.34.0",
-  "description": "Unified CLI for Magic Context \u2014 setup, doctor, and migration across OpenCode and Pi",
+  "version": "0.34.2",
+  "description": "Unified CLI for Magic Context — setup, doctor, and migration across OpenCode and Pi",
   "keywords": [
     "opencode",
     "opencode-plugin",