zam-core 0.9.4 → 0.10.0

package/dist/cli/app.js

@@ -6808,9 +6808,9 @@ var init_kernel = __esm({
 });
 
 // src/cli/app.ts
-import { readFileSync as readFileSync17 } from "fs";
-import { dirname as dirname11, join as join25 } from "path";
-import { fileURLToPath as fileURLToPath5 } from "url";
+import { readFileSync as readFileSync18 } from "fs";
+import { dirname as dirname12, join as join27 } from "path";
+import { fileURLToPath as fileURLToPath6 } from "url";
 import { Command as Command27 } from "commander";
 
 // src/cli/commands/agent.ts
@@ -7156,12 +7156,10 @@ function connectHarnessMcp(harnessId, opts) {
   let content = "";
   let alreadyConfigured = false;
   let hint = "";
-  if (harnessId === "claude-code") {
-    targetPath = join12(opts.cwd, ".mcp.json");
-    hint = "Claude Code will prompt you to approve the 'zam' MCP server on next launch.";
+  const mergeMcpServersJson = (path) => {
     let existing = {};
-    if (exists(targetPath)) {
-      existing = parseMcpJsonConfig(targetPath, read(targetPath));
+    if (exists(path)) {
+      existing = parseMcpJsonConfig(path, read(path));
     }
     if (!existing.mcpServers) {
       existing.mcpServers = {};
@@ -7170,7 +7168,29 @@ function connectHarnessMcp(harnessId, opts) {
       command: opts.zamPath,
       args: ["mcp"]
     };
-    content = JSON.stringify(existing, null, 2);
+    return JSON.stringify(existing, null, 2);
+  };
+  if (harnessId === "claude-code") {
+    targetPath = join12(opts.cwd, ".mcp.json");
+    hint = "Claude Code will prompt you to approve the 'zam' MCP server on next launch.";
+    content = mergeMcpServersJson(targetPath);
+  } else if (harnessId === "claude-desktop") {
+    const platform = opts.platform ?? process.platform;
+    targetPath = platform === "win32" ? join12(
+      opts.home,
+      "AppData",
+      "Roaming",
+      "Claude",
+      "claude_desktop_config.json"
+    ) : platform === "darwin" ? join12(
+      opts.home,
+      "Library",
+      "Application Support",
+      "Claude",
+      "claude_desktop_config.json"
+    ) : join12(opts.home, ".config", "Claude", "claude_desktop_config.json");
+    hint = "Restart Claude Desktop to load the 'zam' MCP server; MCP Apps panels render inline in the chat.";
+    content = mergeMcpServersJson(targetPath);
   } else if (harnessId === "antigravity") {
     targetPath = join12(opts.home, ".gemini", "config", "mcp_config.json");
     hint = "Shared config read by Antigravity CLI and IDE (2.0+); older IDE builds read ~/.gemini/antigravity/mcp_config.json instead. Refresh Installed MCP Servers; the first tool call may still require approval.";
@@ -7303,6 +7323,7 @@ var C = {
 var SUPPORTED_AGENTS = ["opencode"];
 var CONNECT_HARNESSES = [
   "claude-code",
+  "claude-desktop",
   "antigravity",
   "codex",
   "opencode",
@@ -7421,7 +7442,7 @@ var openCmd = new Command("open").description("Open an agent harness in the work
 });
 var connectCmd = new Command("connect").description("Configure the ZAM MCP server for an agent harness").argument(
   "<harness>",
-  "Harness to connect: claude-code | antigravity | codex | opencode | goose | copilot"
+  "Harness to connect: claude-code | claude-desktop | antigravity | codex | opencode | goose | copilot"
 ).option(
   "--print",
   "Print configuration changes instead of writing them to disk"
@@ -7484,9 +7505,9 @@ var agentCommand = new Command("agent").description("Provision and inspect the a
 init_kernel();
 import { execFileSync as execFileSync3 } from "child_process";
 import { randomBytes as randomBytes2 } from "crypto";
-import { existsSync as existsSync17, readdirSync as readdirSync2, readFileSync as readFileSync13, rmSync as rmSync3 } from "fs";
+import { existsSync as existsSync17, readdirSync as readdirSync2, readFileSync as readFileSync14, rmSync as rmSync3 } from "fs";
 import { homedir as homedir11, tmpdir as tmpdir3 } from "os";
-import { join as join18, resolve as resolve4 } from "path";
+import { join as join20, resolve as resolve4 } from "path";
 import { Command as Command2 } from "commander";
 import { ulid as ulid9 } from "ulid";
 
@@ -9101,7 +9122,7 @@ async function readWebLink(url) {
         redirect: "manual",
         signal: controller.signal,
         headers: {
-          "User-Agent": "ZAM-Content-Studio/0.9.4"
+          "User-Agent": "ZAM-Content-Studio/0.10.0"
         }
       });
       if (res.status >= 300 && res.status < 400) {
@@ -9166,6 +9187,8 @@ async function readImageOCR(db, imagePath) {
 
 // src/cli/bridge-handlers.ts
 init_kernel();
+import { mkdirSync as mkdirSync10, writeFileSync as writeFileSync8 } from "fs";
+import { join as join16 } from "path";
 
 // src/cli/knowledge-contexts.ts
 init_kernel();
@@ -9411,6 +9434,164 @@ async function resolveSuggestMinSimilarity(db) {
   return Number.isFinite(parsed) && parsed > 0 && parsed <= 1 ? parsed : 0.45;
 }
 
+// src/cli/update/latest-version.ts
+import { readFileSync as readFileSync11 } from "fs";
+import { dirname as dirname6, join as join14 } from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
+var GITHUB_REPO = "zam-os/zam";
+function currentVersion() {
+  const here = dirname6(fileURLToPath2(import.meta.url));
+  for (const up of ["..", "../..", "../../.."]) {
+    try {
+      const pkg2 = JSON.parse(
+        readFileSync11(join14(here, up, "package.json"), "utf-8")
+      );
+      if (pkg2.version) return pkg2.version;
+    } catch {
+    }
+  }
+  return "0.0.0";
+}
+async function fetchLatestVersion(repo) {
+  const res = await fetch(
+    `https://api.github.com/repos/${repo}/releases/latest`,
+    {
+      headers: {
+        Accept: "application/vnd.github+json",
+        "User-Agent": "zam-cli"
+      }
+    }
+  );
+  if (!res.ok) {
+    throw new Error(
+      `Could not reach the release server (HTTP ${res.status}). Pass --latest <version> to check offline.`
+    );
+  }
+  const data = await res.json();
+  if (!data.tag_name) throw new Error("No published release found yet.");
+  return data.tag_name;
+}
+
+// src/cli/workspaces/active.ts
+init_kernel();
+import { existsSync as existsSync15, mkdirSync as mkdirSync9 } from "fs";
+import { homedir as homedir10 } from "os";
+import { basename as basename3, join as join15, resolve as resolve3 } from "path";
+var LEGACY_WORKSPACE_DIR_KEY = "personal.workspace_dir";
+var DEFAULT_WORKSPACE_ID = "personal";
+function defaultWorkspaceDir() {
+  return join15(homedir10(), "Documents", "zam");
+}
+function normalizeWorkspacePath(path) {
+  const resolved = resolve3(path);
+  return process.platform === "win32" ? resolved.toLowerCase() : resolved;
+}
+function sameWorkspacePath(left, right) {
+  return normalizeWorkspacePath(left) === normalizeWorkspacePath(right);
+}
+function labelFromPath(path) {
+  return basename3(path) || "ZAM";
+}
+function workspaceIdFromPath(dir) {
+  const base = basename3(dir).toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+  const prefix = base || "workspace";
+  const existing = new Set(getConfiguredWorkspaces().map((item) => item.id));
+  if (!existing.has(prefix)) return prefix;
+  let index = 2;
+  while (existing.has(`${prefix}-${index}`)) index++;
+  return `${prefix}-${index}`;
+}
+function findWorkspaceByPath(dir) {
+  return getConfiguredWorkspaces().find(
+    (workspace) => sameWorkspacePath(workspace.path, dir)
+  );
+}
+async function clearLegacyWorkspaceDir(db) {
+  await deleteSetting(db, LEGACY_WORKSPACE_DIR_KEY);
+}
+async function migrateLegacyWorkspaceDir(db) {
+  const legacyDir = await getSetting(db, LEGACY_WORKSPACE_DIR_KEY);
+  if (!legacyDir) return void 0;
+  const path = resolve3(legacyDir);
+  const existing = findWorkspaceByPath(path);
+  const migrated = existing ?? {
+    id: getConfiguredWorkspaces().some(
+      (workspace) => workspace.id === DEFAULT_WORKSPACE_ID
+    ) ? workspaceIdFromPath(path) : DEFAULT_WORKSPACE_ID,
+    label: labelFromPath(path),
+    kind: "personal",
+    path
+  };
+  if (!existing) {
+    upsertConfiguredWorkspace(migrated);
+  }
+  if (!getActiveWorkspace()) {
+    setActiveWorkspaceId(migrated.id);
+  }
+  await clearLegacyWorkspaceDir(db);
+  return migrated;
+}
+async function ensureActiveWorkspace(db) {
+  await migrateLegacyWorkspaceDir(db);
+  const active = getActiveWorkspace();
+  if (active) {
+    mkdirSync9(active.path, { recursive: true });
+    return active;
+  }
+  const configured = getConfiguredWorkspaces()[0];
+  if (configured) {
+    setActiveWorkspaceId(configured.id);
+    mkdirSync9(configured.path, { recursive: true });
+    return configured;
+  }
+  const workspace = {
+    id: DEFAULT_WORKSPACE_ID,
+    label: "Personal",
+    kind: "personal",
+    path: defaultWorkspaceDir()
+  };
+  mkdirSync9(workspace.path, { recursive: true });
+  upsertConfiguredWorkspace(workspace);
+  setActiveWorkspaceId(workspace.id);
+  await clearLegacyWorkspaceDir(db);
+  return workspace;
+}
+async function activateWorkspace(db, workspace) {
+  upsertConfiguredWorkspace(workspace);
+  setActiveWorkspaceId(workspace.id);
+  await clearLegacyWorkspaceDir(db);
+  return workspace;
+}
+async function activateWorkspacePath(db, dir, opts = {}) {
+  await migrateLegacyWorkspaceDir(db);
+  const path = resolve3(dir);
+  const existing = opts.id ? void 0 : findWorkspaceByPath(path);
+  if (existing) {
+    setActiveWorkspaceId(existing.id);
+    await clearLegacyWorkspaceDir(db);
+    return existing;
+  }
+  const workspace = {
+    id: opts.id || workspaceIdFromPath(path),
+    label: opts.label || labelFromPath(path),
+    kind: opts.kind || "personal",
+    path
+  };
+  return activateWorkspace(db, workspace);
+}
+async function removeWorkspaceAndResolveActive(db, id) {
+  removeConfiguredWorkspace(id);
+  await clearLegacyWorkspaceDir(db);
+  const activeWorkspace = await ensureActiveWorkspace(db);
+  return {
+    activeWorkspace,
+    workspaces: getConfiguredWorkspaces()
+  };
+}
+function existingWorkspaceDirOrHome(workspace) {
+  return existsSync15(workspace.path) ? workspace.path : homedir10();
+}
+
 // src/cli/bridge-handlers.ts
 var BLOOM_VERBS3 = {
   1: "Remember",
@@ -10176,6 +10357,33 @@ async function sessionOpen(db, params) {
     relevant: findTokensResult
   };
 }
+async function backupCreate(db, params) {
+  const targetDir = params.dir || (await ensureActiveWorkspace(db)).path;
+  const snapshot = await exportSnapshot(db);
+  const manifest = verifySnapshot(snapshot);
+  const backupDir = join16(targetDir, "zam-backups");
+  mkdirSync10(backupDir, { recursive: true });
+  const stamp = manifest.createdAt.replace(/[:.]/g, "-");
+  const path = join16(backupDir, `zam-snapshot-${stamp}.sql`);
+  writeFileSync8(path, snapshot, "utf-8");
+  return {
+    ok: true,
+    path,
+    createdAt: manifest.createdAt,
+    checksum: manifest.checksum,
+    tables: manifest.tables
+  };
+}
+async function updateCheck(params) {
+  const current = currentVersion();
+  const latest = params.latest ?? await fetchLatestVersion(GITHUB_REPO);
+  const channel = params.channel ?? getInstallChannel();
+  return decideUpdate({
+    currentVersion: current,
+    latestVersion: latest,
+    channel
+  });
+}
 
 // src/cli/curriculum/breadcrumb.ts
 init_kernel();
@@ -12842,9 +13050,9 @@ function getCurriculumProvider(id) {
 // src/cli/llm/vision.ts
 init_kernel();
 import { randomBytes } from "crypto";
-import { readFileSync as readFileSync11 } from "fs";
+import { readFileSync as readFileSync12 } from "fs";
 import { tmpdir as tmpdir2 } from "os";
-import { basename as basename3, join as join14 } from "path";
+import { basename as basename4, join as join17 } from "path";
 var LANGUAGE_NAMES2 = {
   en: "English",
   de: "German",
@@ -12880,13 +13088,13 @@ async function observeUiSnapshotViaLLM(db, input8) {
   const imageUrls = [];
   const isVideo = /\.(mp4|mov|m4v|avi|mkv|webm)$/i.test(input8.imagePath);
   if (isVideo) {
-    const { mkdirSync: mkdirSync15, readdirSync: readdirSync3, rmSync: rmSync4 } = await import("fs");
+    const { mkdirSync: mkdirSync16, readdirSync: readdirSync3, rmSync: rmSync4 } = await import("fs");
     const { execSync: execSync6 } = await import("child_process");
-    const tempDir = join14(
+    const tempDir = join17(
       tmpdir2(),
       `zam-frames-${randomBytes(4).toString("hex")}`
     );
-    mkdirSync15(tempDir, { recursive: true });
+    mkdirSync16(tempDir, { recursive: true });
     try {
       execSync6(
         `ffmpeg -i "${input8.imagePath}" -vf "fps=1/3,scale=1280:-1" -vsync vfr "${tempDir}/frame_%03d.png"`,
@@ -12915,7 +13123,7 @@ async function observeUiSnapshotViaLLM(db, input8) {
         }
       }
       for (const file of sampledFiles) {
-        const bytes = readFileSync11(join14(tempDir, file));
+        const bytes = readFileSync12(join17(tempDir, file));
         imageUrls.push(`data:image/png;base64,${bytes.toString("base64")}`);
       }
     } finally {
@@ -12925,7 +13133,7 @@ async function observeUiSnapshotViaLLM(db, input8) {
       }
     }
   } else {
-    const imageBytes = readFileSync11(input8.imagePath);
+    const imageBytes = readFileSync12(input8.imagePath);
     const ext = input8.imagePath.split(".").pop()?.toLowerCase();
     const mime = ext === "jpg" || ext === "jpeg" ? "image/jpeg" : "image/png";
     imageUrls.push(`data:${mime};base64,${imageBytes.toString("base64")}`);
@@ -13163,7 +13371,7 @@ function buildReport(input8, draft) {
     evidence: [
       {
         type: "keyframe",
-        ref: input8.evidenceRef ?? basename3(input8.imagePath),
+        ref: input8.evidenceRef ?? basename4(input8.imagePath),
         redacted: input8.redacted ?? false
       }
     ],
@@ -13185,7 +13393,7 @@ function uncertainReport(input8, summary) {
     evidence: [
       {
         type: "keyframe",
-        ref: input8.evidenceRef ?? basename3(input8.imagePath),
+        ref: input8.evidenceRef ?? basename4(input8.imagePath),
         redacted: input8.redacted ?? false
       }
     ],
@@ -13394,36 +13602,36 @@ async function withProviderScope(machine, action) {
 
 // src/cli/provisioning/index.ts
 import {
-  existsSync as existsSync15,
+  existsSync as existsSync16,
   lstatSync,
-  mkdirSync as mkdirSync9,
-  readFileSync as readFileSync12,
+  mkdirSync as mkdirSync11,
+  readFileSync as readFileSync13,
   realpathSync,
   rmSync as rmSync2,
   symlinkSync,
-  writeFileSync as writeFileSync8
+  writeFileSync as writeFileSync9
 } from "fs";
-import { basename as basename4, dirname as dirname6, join as join15 } from "path";
-import { fileURLToPath as fileURLToPath2 } from "url";
+import { basename as basename5, dirname as dirname7, join as join18 } from "path";
+import { fileURLToPath as fileURLToPath3 } from "url";
 var packageRoot = [
-  fileURLToPath2(new URL("../..", import.meta.url)),
-  fileURLToPath2(new URL("../../..", import.meta.url))
-].find((candidate) => existsSync15(join15(candidate, "package.json"))) ?? fileURLToPath2(new URL("../..", import.meta.url));
+  fileURLToPath3(new URL("../..", import.meta.url)),
+  fileURLToPath3(new URL("../../..", import.meta.url))
+].find((candidate) => existsSync16(join18(candidate, "package.json"))) ?? fileURLToPath3(new URL("../..", import.meta.url));
 var ALL_SETUP_AGENTS = ["claude", "copilot", "codex", "agent"];
 var SKILL_PAIRS = [
   {
-    from: join15(packageRoot, ".claude", "skills", "zam", "SKILL.md"),
-    to: join15(".claude", "skills", "zam", "SKILL.md"),
+    from: join18(packageRoot, ".claude", "skills", "zam", "SKILL.md"),
+    to: join18(".claude", "skills", "zam", "SKILL.md"),
     agents: ["claude", "copilot"]
   },
   {
-    from: join15(packageRoot, ".agent", "skills", "zam", "SKILL.md"),
-    to: join15(".agent", "skills", "zam", "SKILL.md"),
+    from: join18(packageRoot, ".agent", "skills", "zam", "SKILL.md"),
+    to: join18(".agent", "skills", "zam", "SKILL.md"),
     agents: ["agent"]
   },
   {
-    from: join15(packageRoot, ".agents", "skills", "zam", "SKILL.md"),
-    to: join15(".agents", "skills", "zam", "SKILL.md"),
+    from: join18(packageRoot, ".agents", "skills", "zam", "SKILL.md"),
+    to: join18(".agents", "skills", "zam", "SKILL.md"),
     agents: ["codex"]
   }
 ];
@@ -13483,15 +13691,15 @@ function linkPointsTo(sourceDir, destinationDir) {
 function isZamSkillCopy(destinationDir) {
   try {
     if (!lstatSync(destinationDir).isDirectory()) return false;
-    const skillFile = join15(destinationDir, "SKILL.md");
-    if (!existsSync15(skillFile)) return false;
-    return /^name:\s*zam\s*$/m.test(readFileSync12(skillFile, "utf8"));
+    const skillFile = join18(destinationDir, "SKILL.md");
+    if (!existsSync16(skillFile)) return false;
+    return /^name:\s*zam\s*$/m.test(readFileSync13(skillFile, "utf8"));
   } catch {
     return false;
   }
 }
 function classifySkillDestination(sourceDir, destinationDir) {
-  if (!existsSync15(sourceDir)) return "source-missing";
+  if (!existsSync16(sourceDir)) return "source-missing";
   if (!isSymbolicLink(destinationDir) && pathsResolveToSameDirectory(sourceDir, destinationDir)) {
     return "source-directory";
   }
@@ -13508,9 +13716,9 @@ function wireSkills(cwd = process.cwd(), agents = parseSetupAgents(), opts = {})
   };
   for (const { from, to, agents: pairAgents } of SKILL_PAIRS) {
     if (!pairAgents.some((agent) => agents.has(agent))) continue;
-    const sourceDir = dirname6(from);
-    const destinationDir = dirname6(join15(cwd, to));
-    const label = dirname6(to);
+    const sourceDir = dirname7(from);
+    const destinationDir = dirname7(join18(cwd, to));
+    const label = dirname7(to);
     const state = classifySkillDestination(sourceDir, destinationDir);
     if (state === "source-missing") {
       if (!opts.quiet) {
@@ -13567,7 +13775,7 @@ function wireSkills(cwd = process.cwd(), agents = parseSetupAgents(), opts = {})
       if (destinationExists) {
         rmSync2(destinationDir, { recursive: true, force: true });
       }
-      mkdirSync9(dirname6(destinationDir), { recursive: true });
+      mkdirSync11(dirname7(destinationDir), { recursive: true });
       symlinkSync(
         sourceDir,
         destinationDir,
@@ -13583,8 +13791,8 @@ function inspectSkillLinks(cwd = process.cwd(), agents = parseSetupAgents()) {
   const results = [];
   for (const { from, to, agents: pairAgents } of SKILL_PAIRS) {
     if (!pairAgents.some((agent) => agents.has(agent))) continue;
-    const sourceDir = dirname6(from);
-    const destinationDir = dirname6(join15(cwd, to));
+    const sourceDir = dirname7(from);
+    const destinationDir = dirname7(join18(cwd, to));
     results.push({
       agents: pairAgents,
       source: sourceDir,
@@ -13610,15 +13818,15 @@ function upsertMarkedBlock(dest, blockBody, dryRun) {
   const block = `${ZAM_BLOCK_START}
 ${blockBody.trim()}
 ${ZAM_BLOCK_END}`;
-  if (!existsSync15(dest)) {
+  if (!existsSync16(dest)) {
     if (!dryRun) {
-      mkdirSync9(dirname6(dest), { recursive: true });
-      writeFileSync8(dest, `${block}
+      mkdirSync11(dirname7(dest), { recursive: true });
+      writeFileSync9(dest, `${block}
 `, "utf8");
     }
     return "write";
   }
-  const existing = readFileSync12(dest, "utf8");
+  const existing = readFileSync13(dest, "utf8");
   if (existing.includes(block)) return "skip";
   const start = existing.indexOf(ZAM_BLOCK_START);
   const end = existing.indexOf(ZAM_BLOCK_END);
@@ -13626,7 +13834,7 @@ ${ZAM_BLOCK_END}`;
 
 ${block}
 `;
-  if (!dryRun) writeFileSync8(dest, next, "utf8");
+  if (!dryRun) writeFileSync9(dest, next, "utf8");
   return start >= 0 && end > start ? "update" : "write";
 }
 function logInstructionAction(action, label, dryRun) {
@@ -13638,8 +13846,8 @@ function logInstructionAction(action, label, dryRun) {
 }
 function writeClaudeMd(skipClaudeMd, cwd = process.cwd(), opts = {}) {
   if (skipClaudeMd) return;
-  const dest = join15(cwd, "CLAUDE.md");
-  if (existsSync15(dest)) {
+  const dest = join18(cwd, "CLAUDE.md");
+  if (existsSync16(dest)) {
     if (!opts.updateExisting) {
       console.log(`  skip  CLAUDE.md (already present)`);
       return;
@@ -13658,7 +13866,7 @@ ZAM is available in this repository. Use the \`zam\` skill in Claude Code to tur
     logInstructionAction(action, "CLAUDE.md", Boolean(opts.dryRun));
     return;
   }
-  const name = basename4(cwd);
+  const name = basename5(cwd);
   const content = `# ZAM Personal Kernel \u2014 ${name}
 
 This is a ZAM personal instance. ZAM builds lasting skills through spaced
@@ -13682,14 +13890,14 @@ Use \`zam connector setup turso\` to store cloud credentials in
   if (opts.dryRun) {
     console.log(`  would write CLAUDE.md`);
   } else {
-    writeFileSync8(dest, content, "utf8");
+    writeFileSync9(dest, content, "utf8");
     console.log(`  write CLAUDE.md`);
   }
 }
 function writeAgentsMd(skipAgentsMd, cwd = process.cwd(), opts = {}) {
   if (skipAgentsMd) return;
-  const dest = join15(cwd, "AGENTS.md");
-  if (existsSync15(dest)) {
+  const dest = join18(cwd, "AGENTS.md");
+  if (existsSync16(dest)) {
     if (!opts.updateExisting) {
       console.log(`  skip  AGENTS.md (already present)`);
       return;
@@ -13708,7 +13916,7 @@ ZAM is available in this repository. Select the \`zam\` skill through \`/skills\
     logInstructionAction(action, "AGENTS.md", Boolean(opts.dryRun));
     return;
   }
-  const name = basename4(cwd);
+  const name = basename5(cwd);
   const content = `# ZAM Personal Kernel - ${name}
 
 This is a ZAM personal instance. ZAM builds lasting skills through spaced
@@ -13739,12 +13947,12 @@ Codex discovers repository skills under \`.agents/skills/\`. Run
   if (opts.dryRun) {
     console.log(`  would write AGENTS.md`);
   } else {
-    writeFileSync8(dest, content, "utf8");
+    writeFileSync9(dest, content, "utf8");
     console.log(`  write AGENTS.md`);
   }
 }
 function writeCopilotInstructions(cwd = process.cwd(), opts = {}) {
-  const dest = join15(cwd, ".github", "copilot-instructions.md");
+  const dest = join18(cwd, ".github", "copilot-instructions.md");
   const action = upsertMarkedBlock(
     dest,
     `## ZAM learning sessions
@@ -13784,134 +13992,14 @@ async function resolveUser(opts, db, resolveOpts) {
   process.exit(1);
 }
 
-// src/cli/workspaces/active.ts
-init_kernel();
-import { existsSync as existsSync16, mkdirSync as mkdirSync10 } from "fs";
-import { homedir as homedir10 } from "os";
-import { basename as basename5, join as join16, resolve as resolve3 } from "path";
-var LEGACY_WORKSPACE_DIR_KEY = "personal.workspace_dir";
-var DEFAULT_WORKSPACE_ID = "personal";
-function defaultWorkspaceDir() {
-  return join16(homedir10(), "Documents", "zam");
-}
-function normalizeWorkspacePath(path) {
-  const resolved = resolve3(path);
-  return process.platform === "win32" ? resolved.toLowerCase() : resolved;
-}
-function sameWorkspacePath(left, right) {
-  return normalizeWorkspacePath(left) === normalizeWorkspacePath(right);
-}
-function labelFromPath(path) {
-  return basename5(path) || "ZAM";
-}
-function workspaceIdFromPath(dir) {
-  const base = basename5(dir).toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
-  const prefix = base || "workspace";
-  const existing = new Set(getConfiguredWorkspaces().map((item) => item.id));
-  if (!existing.has(prefix)) return prefix;
-  let index = 2;
-  while (existing.has(`${prefix}-${index}`)) index++;
-  return `${prefix}-${index}`;
-}
-function findWorkspaceByPath(dir) {
-  return getConfiguredWorkspaces().find(
-    (workspace) => sameWorkspacePath(workspace.path, dir)
-  );
-}
-async function clearLegacyWorkspaceDir(db) {
-  await deleteSetting(db, LEGACY_WORKSPACE_DIR_KEY);
-}
-async function migrateLegacyWorkspaceDir(db) {
-  const legacyDir = await getSetting(db, LEGACY_WORKSPACE_DIR_KEY);
-  if (!legacyDir) return void 0;
-  const path = resolve3(legacyDir);
-  const existing = findWorkspaceByPath(path);
-  const migrated = existing ?? {
-    id: getConfiguredWorkspaces().some(
-      (workspace) => workspace.id === DEFAULT_WORKSPACE_ID
-    ) ? workspaceIdFromPath(path) : DEFAULT_WORKSPACE_ID,
-    label: labelFromPath(path),
-    kind: "personal",
-    path
-  };
-  if (!existing) {
-    upsertConfiguredWorkspace(migrated);
-  }
-  if (!getActiveWorkspace()) {
-    setActiveWorkspaceId(migrated.id);
-  }
-  await clearLegacyWorkspaceDir(db);
-  return migrated;
-}
-async function ensureActiveWorkspace(db) {
-  await migrateLegacyWorkspaceDir(db);
-  const active = getActiveWorkspace();
-  if (active) {
-    mkdirSync10(active.path, { recursive: true });
-    return active;
-  }
-  const configured = getConfiguredWorkspaces()[0];
-  if (configured) {
-    setActiveWorkspaceId(configured.id);
-    mkdirSync10(configured.path, { recursive: true });
-    return configured;
-  }
-  const workspace = {
-    id: DEFAULT_WORKSPACE_ID,
-    label: "Personal",
-    kind: "personal",
-    path: defaultWorkspaceDir()
-  };
-  mkdirSync10(workspace.path, { recursive: true });
-  upsertConfiguredWorkspace(workspace);
-  setActiveWorkspaceId(workspace.id);
-  await clearLegacyWorkspaceDir(db);
-  return workspace;
-}
-async function activateWorkspace(db, workspace) {
-  upsertConfiguredWorkspace(workspace);
-  setActiveWorkspaceId(workspace.id);
-  await clearLegacyWorkspaceDir(db);
-  return workspace;
-}
-async function activateWorkspacePath(db, dir, opts = {}) {
-  await migrateLegacyWorkspaceDir(db);
-  const path = resolve3(dir);
-  const existing = opts.id ? void 0 : findWorkspaceByPath(path);
-  if (existing) {
-    setActiveWorkspaceId(existing.id);
-    await clearLegacyWorkspaceDir(db);
-    return existing;
-  }
-  const workspace = {
-    id: opts.id || workspaceIdFromPath(path),
-    label: opts.label || labelFromPath(path),
-    kind: opts.kind || "personal",
-    path
-  };
-  return activateWorkspace(db, workspace);
-}
-async function removeWorkspaceAndResolveActive(db, id) {
-  removeConfiguredWorkspace(id);
-  await clearLegacyWorkspaceDir(db);
-  const activeWorkspace = await ensureActiveWorkspace(db);
-  return {
-    activeWorkspace,
-    workspaces: getConfiguredWorkspaces()
-  };
-}
-function existingWorkspaceDirOrHome(workspace) {
-  return existsSync16(workspace.path) ? workspace.path : homedir10();
-}
-
 // src/cli/workspaces/backup.ts
-import { mkdirSync as mkdirSync11 } from "fs";
-import { join as join17 } from "path";
+import { mkdirSync as mkdirSync12 } from "fs";
+import { join as join19 } from "path";
 async function backupDatabaseTo(db, targetDir) {
-  const backupDir = join17(targetDir, "zam-backups");
-  mkdirSync11(backupDir, { recursive: true });
+  const backupDir = join19(targetDir, "zam-backups");
+  mkdirSync12(backupDir, { recursive: true });
   const stamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
-  const dest = join17(backupDir, `zam-${stamp}.db`);
+  const dest = join19(backupDir, `zam-${stamp}.db`);
   await db.exec(`VACUUM INTO '${dest.replace(/'/g, "''")}'`);
   return dest;
 }
@@ -14005,6 +14093,35 @@ bridgeCommand.command("backup-db").description("Back up the local database into
     jsonOut2({ ok: true, path });
   });
 });
+bridgeCommand.command("backup-create").description(
+  "Create a portable SQL snapshot backup (kernel exportSnapshot), distinct from backup-db's VACUUM copy (JSON)"
+).option(
+  "--dir <path>",
+  "Target directory (default: workspace dir, else ~/Documents/zam)"
+).action(async (opts) => {
+  await withDb2(async (db) => {
+    try {
+      const result = await backupCreate(db, { dir: opts.dir });
+      jsonOut2(result);
+    } catch (err) {
+      jsonError(err.message);
+    }
+  });
+});
+bridgeCommand.command("update-check").description("Check whether a newer ZAM release is available (JSON)").option(
+  "--latest <version>",
+  "Compare against this version instead of fetching (offline/deterministic checks)"
+).option("--channel <channel>", "Override the detected install channel").action(async (opts) => {
+  try {
+    const result = await updateCheck({
+      latest: opts.latest,
+      channel: opts.channel
+    });
+    jsonOut2(result);
+  } catch (err) {
+    jsonError(err.message);
+  }
+});
 bridgeCommand.command("workspace-info").description("Report the workspace dir, its default, and the data dir (JSON)").action(async () => {
   await withDb2(async (db) => {
     const activeWorkspace = await ensureActiveWorkspace(db);
@@ -14013,7 +14130,7 @@ bridgeCommand.command("workspace-info").description("Report the workspace dir, i
       activeWorkspace,
       workspaceDir: activeWorkspace.path,
       defaultWorkspaceDir: defaultWorkspaceDir(),
-      dataDir: join18(homedir11(), ".zam")
+      dataDir: join20(homedir11(), ".zam")
     });
   });
 });
@@ -14056,7 +14173,7 @@ bridgeCommand.command("workspace-list").description("List configured ZAM workspa
       activeWorkspace,
       workspaceDir: activeWorkspace.path,
       defaultWorkspaceDir: defaultWorkspaceDir(),
-      dataDir: join18(homedir11(), ".zam"),
+      dataDir: join20(homedir11(), ".zam"),
       linkHealth: buildWorkspaceLinkHealth(workspaces)
     });
   });
@@ -14583,7 +14700,7 @@ bridgeCommand.command("discover-skills").description(
   "20"
 ).action(async (opts) => {
   try {
-    const monitorDir = join18(homedir11(), ".zam", "monitor");
+    const monitorDir = join20(homedir11(), ".zam", "monitor");
     let files;
     try {
       files = readdirSync2(monitorDir).filter((f) => f.endsWith(".jsonl"));
@@ -14596,7 +14713,7 @@ bridgeCommand.command("discover-skills").description(
       return;
     }
     const limit = Number(opts.limit);
-    const sorted = files.map((f) => ({ name: f, path: join18(monitorDir, f) })).sort((a, b) => b.name.localeCompare(a.name)).slice(0, limit);
+    const sorted = files.map((f) => ({ name: f, path: join20(monitorDir, f) })).sort((a, b) => b.name.localeCompare(a.name)).slice(0, limit);
     const sessionCommands = /* @__PURE__ */ new Map();
     for (const file of sorted) {
       const sessionId = file.name.replace(".jsonl", "");
@@ -15098,7 +15215,7 @@ bridgeCommand.command("capture-ui").description("Capture a screenshot for agent-
         return;
       }
     }
-    const outputPath = opts.image ?? opts.output ?? join18(tmpdir3(), `zam-capture-${randomBytes2(4).toString("hex")}.png`);
+    const outputPath = opts.image ?? opts.output ?? join20(tmpdir3(), `zam-capture-${randomBytes2(4).toString("hex")}.png`);
     const captureResult = isProvided ? { method: "provided", target: null } : captureScreenshot(outputPath, opts.hwnd, opts.processName);
     if (!isProvided) {
       const post = decidePostCapture(policy, {
@@ -15126,7 +15243,7 @@ bridgeCommand.command("capture-ui").description("Capture a screenshot for agent-
         return;
       }
     }
-    const imageBytes = readFileSync13(outputPath);
+    const imageBytes = readFileSync14(outputPath);
     const base64 = imageBytes.toString("base64");
     jsonOut2({
       sessionId: opts.session ?? null,
@@ -15153,10 +15270,10 @@ bridgeCommand.command("start-recording").description("Start screen recording in
     return;
   }
   const sessionId = opts.session;
-  const statePath = join18(tmpdir3(), `zam-recording-${sessionId}.json`);
+  const statePath = join20(tmpdir3(), `zam-recording-${sessionId}.json`);
   const defaultExt = platform === "win32" ? ".mkv" : ".mov";
-  const outputPath = opts.output ?? join18(tmpdir3(), `zam-recording-${sessionId}${defaultExt}`);
-  const { existsSync: existsSync26, writeFileSync: writeFileSync13, openSync, closeSync } = await import("fs");
+  const outputPath = opts.output ?? join20(tmpdir3(), `zam-recording-${sessionId}${defaultExt}`);
+  const { existsSync: existsSync26, writeFileSync: writeFileSync14, openSync, closeSync } = await import("fs");
   if (existsSync26(statePath)) {
     jsonOut2({
       sessionId,
@@ -15165,7 +15282,7 @@ bridgeCommand.command("start-recording").description("Start screen recording in
     });
     return;
   }
-  const logPath = join18(tmpdir3(), `zam-recording-${sessionId}.log`);
+  const logPath = join20(tmpdir3(), `zam-recording-${sessionId}.log`);
   let logFd;
   try {
     logFd = openSync(logPath, "w");
@@ -15211,7 +15328,7 @@ bridgeCommand.command("start-recording").description("Start screen recording in
   }
   child.unref();
   if (child.pid) {
-    writeFileSync13(
+    writeFileSync14(
       statePath,
       JSON.stringify({
         pid: child.pid,
@@ -15247,8 +15364,8 @@ bridgeCommand.command("stop-recording").description(
     return;
   }
   const sessionId = opts.session;
-  const statePath = join18(tmpdir3(), `zam-recording-${sessionId}.json`);
-  const { existsSync: existsSync26, readFileSync: readFileSync18, rmSync: rmSync4 } = await import("fs");
+  const statePath = join20(tmpdir3(), `zam-recording-${sessionId}.json`);
+  const { existsSync: existsSync26, readFileSync: readFileSync19, rmSync: rmSync4 } = await import("fs");
   if (!existsSync26(statePath)) {
     jsonOut2({
       sessionId,
@@ -15257,7 +15374,7 @@ bridgeCommand.command("stop-recording").description(
     });
     return;
   }
-  const state = JSON.parse(readFileSync18(statePath, "utf8"));
+  const state = JSON.parse(readFileSync19(statePath, "utf8"));
   const { pid, outputPath } = state;
   try {
     process.kill(pid, "SIGINT");
@@ -16645,6 +16762,79 @@ bridgeCommand.command("set-active-knowledge-context").description("Set the activ
     jsonOut2({ success: true, activeContext: context.name });
   });
 });
+var commanderConfiguredForJsonExecution = false;
+function ensureCommanderThrowsInsteadOfExiting() {
+  if (commanderConfiguredForJsonExecution) return;
+  bridgeCommand.exitOverride();
+  for (const sub of bridgeCommand.commands) {
+    sub.exitOverride();
+  }
+  commanderConfiguredForJsonExecution = true;
+}
+async function runBridgeCommandOnce(cmd, args) {
+  ensureCommanderThrowsInsteadOfExiting();
+  let outputBuffer = "";
+  const captureOutput = (str) => {
+    outputBuffer += str;
+  };
+  bridgeCommand.configureOutput({
+    writeOut: captureOutput,
+    writeErr: captureOutput
+  });
+  for (const sub of bridgeCommand.commands) {
+    sub.configureOutput({ writeOut: captureOutput, writeErr: captureOutput });
+  }
+  const originalLog = console.log;
+  const originalError = console.error;
+  console.log = (...logArgs) => {
+    outputBuffer += `${logArgs.map((a) => typeof a === "object" ? JSON.stringify(a) : String(a)).join(" ")}
+`;
+  };
+  console.error = (...logArgs) => {
+    outputBuffer += `${logArgs.map((a) => typeof a === "object" ? JSON.stringify(a) : String(a)).join(" ")}
+`;
+  };
+  const wasServeMode = isServeMode;
+  isServeMode = true;
+  try {
+    try {
+      await bridgeCommand.parseAsync(["node", "bridge", cmd, ...args]);
+    } catch (err) {
+      let message;
+      if (err instanceof Error && err.message.startsWith('{"error":')) {
+        try {
+          message = JSON.parse(err.message).error;
+        } catch {
+          message = err.message;
+        }
+      } else if (err?.code?.startsWith("commander.")) {
+        message = outputBuffer.trim() || err.message;
+      } else {
+        message = err.message || String(err);
+      }
+      throw new Error(message);
+    }
+  } finally {
+    console.log = originalLog;
+    console.error = originalError;
+    isServeMode = wasServeMode;
+  }
+  const trimmed = outputBuffer.trim();
+  try {
+    return JSON.parse(trimmed);
+  } catch {
+    return trimmed;
+  }
+}
+var bridgeExecutionQueue = Promise.resolve();
+function executeBridgeCommandJson(cmd, args) {
+  const run = bridgeExecutionQueue.then(() => runBridgeCommandOnce(cmd, args));
+  bridgeExecutionQueue = run.then(
+    () => void 0,
+    () => void 0
+  );
+  return run;
+}
 bridgeCommand.command("serve").description("Start the persistent JSON-RPC stdin/stdout server").option("--stdin", "Use stdin/stdout for communication").action(async (_opts) => {
   isServeMode = true;
   const {
@@ -16667,25 +16857,7 @@ bridgeCommand.command("serve").description("Start the persistent JSON-RPC stdin/
   logDiag(
     `serve start | homedir=${nodeOs.homedir()} | USERPROFILE=${process.env.USERPROFILE ?? ""} | HOME=${process.env.HOME ?? ""} | cwd=${process.cwd()}`
   );
-  bridgeCommand.exitOverride();
-  for (const cmd of bridgeCommand.commands) {
-    cmd.exitOverride();
-  }
-  let outputBuffer = "";
-  const outputOpts = {
-    writeOut: (str) => {
-      outputBuffer += str;
-    },
-    writeErr: (str) => {
-      outputBuffer += str;
-    }
-  };
-  bridgeCommand.configureOutput(outputOpts);
-  for (const cmd of bridgeCommand.commands) {
-    cmd.configureOutput(outputOpts);
-  }
   const processRequest = async (line) => {
-    outputBuffer = "";
     let requestId = null;
     try {
       const req = JSON.parse(line);
@@ -16705,49 +16877,15 @@ bridgeCommand.command("serve").description("Start the persistent JSON-RPC stdin/
           error: "Missing 'cmd' field"
         });
       }
-      const originalLog = console.log;
-      const originalError = console.error;
-      console.log = (...logArgs) => {
-        outputBuffer += `${logArgs.map((a) => typeof a === "object" ? JSON.stringify(a) : String(a)).join(" ")}
-`;
-      };
-      console.error = (...logArgs) => {
-        outputBuffer += `${logArgs.map((a) => typeof a === "object" ? JSON.stringify(a) : String(a)).join(" ")}
-`;
-      };
       try {
-        await bridgeCommand.parseAsync(["node", "bridge", cmd, ...args]);
+        const result = await executeBridgeCommandJson(cmd, args);
+        return JSON.stringify({ id: requestId, result });
       } catch (err) {
-        if (err instanceof Error && err.message.startsWith('{"error":')) {
-          try {
-            const parsed = JSON.parse(err.message);
-            return JSON.stringify({ id: requestId, error: parsed.error });
-          } catch {
-            return JSON.stringify({ id: requestId, error: err.message });
-          }
-        }
-        if (err.code?.startsWith("commander.")) {
-          return JSON.stringify({
-            id: requestId,
-            error: outputBuffer.trim() || err.message
-          });
-        }
         return JSON.stringify({
           id: requestId,
           error: err.message || String(err)
         });
-      } finally {
-        console.log = originalLog;
-        console.error = originalError;
-      }
-      let result;
-      const trimmed = outputBuffer.trim();
-      try {
-        result = JSON.parse(trimmed);
-      } catch {
-        result = trimmed;
       }
-      return JSON.stringify({ id: requestId, result });
     } catch (err) {
       return JSON.stringify({
         id: requestId,
@@ -18052,26 +18190,26 @@ var doctorCommand = new Command5("doctor").description(
 // src/cli/commands/git-sync.ts
 init_kernel();
 import { execSync as execSync5 } from "child_process";
-import { chmodSync as chmodSync2, existsSync as existsSync18, writeFileSync as writeFileSync9 } from "fs";
-import { join as join19 } from "path";
+import { chmodSync as chmodSync2, existsSync as existsSync18, writeFileSync as writeFileSync10 } from "fs";
+import { join as join21 } from "path";
 import { Command as Command6 } from "commander";
 function installHook2() {
-  const gitDir = join19(process.cwd(), ".git");
+  const gitDir = join21(process.cwd(), ".git");
   if (!existsSync18(gitDir)) {
     console.error(
       "Error: Current directory is not the root of a Git repository."
     );
     process.exit(1);
   }
-  const hooksDir = join19(gitDir, "hooks");
-  const hookPath = join19(hooksDir, "post-commit");
+  const hooksDir = join21(gitDir, "hooks");
+  const hookPath = join21(hooksDir, "post-commit");
   const hookContent = `#!/bin/sh
 # ZAM Spaced Repetition Auto-Stale Hook
 # Triggered automatically on git commits to decay modified concept cards.
 zam git-sync --commit HEAD --quiet
 `;
   try {
-    writeFileSync9(hookPath, hookContent, { encoding: "utf-8", flag: "w" });
+    writeFileSync10(hookPath, hookContent, { encoding: "utf-8", flag: "w" });
     try {
       chmodSync2(hookPath, "755");
     } catch (_e) {
@@ -18174,7 +18312,7 @@ ZAM Auto-Stale Complete: Scanned ${changedFiles.length} file(s).`
 
 // src/cli/commands/goal.ts
 init_kernel();
-import { existsSync as existsSync19, mkdirSync as mkdirSync12 } from "fs";
+import { existsSync as existsSync19, mkdirSync as mkdirSync13 } from "fs";
 import { resolve as resolve5 } from "path";
 import { input as input2 } from "@inquirer/prompts";
 import { Command as Command7 } from "commander";
@@ -18300,7 +18438,7 @@ ${"\u2500".repeat(50)}`);
 goalCommand.command("create").description("Create a new goal").option("--slug <slug>", "Goal slug (used as filename)").option("--title <title>", "Goal title").option("--parent <slug>", "Parent goal slug").option("--description <text>", "Goal description").option("--json", "Output as JSON").action(async (opts) => {
   const goalsDir = await resolveGoalsDir();
   if (!existsSync19(goalsDir)) {
-    mkdirSync12(goalsDir, { recursive: true });
+    mkdirSync13(goalsDir, { recursive: true });
   }
   let slug = opts.slug;
   let title = opts.title;
@@ -18360,9 +18498,9 @@ goalCommand.command("status <slug> <status>").description("Update a goal's statu
 
 // src/cli/commands/init.ts
 init_kernel();
-import { existsSync as existsSync20, mkdirSync as mkdirSync13, writeFileSync as writeFileSync10 } from "fs";
+import { existsSync as existsSync20, mkdirSync as mkdirSync14, writeFileSync as writeFileSync11 } from "fs";
 import { homedir as homedir12 } from "os";
-import { join as join20, resolve as resolve6 } from "path";
+import { join as join22, resolve as resolve6 } from "path";
 import { confirm, input as input3 } from "@inquirer/prompts";
 import { Command as Command8 } from "commander";
 var HOME2 = homedir12();
@@ -18370,12 +18508,12 @@ function printLine(char = "\u2550", len = 60, color = "\x1B[36m") {
   console.log(`${color}${char.repeat(len)}\x1B[0m`);
 }
 function bootstrapSandboxWorkspace(workspaceDir) {
-  mkdirSync13(join20(workspaceDir, "beliefs"), { recursive: true });
-  mkdirSync13(join20(workspaceDir, "goals"), { recursive: true });
-  mkdirSync13(join20(workspaceDir, "skills"), { recursive: true });
-  const worldviewFile = join20(workspaceDir, "beliefs", "worldview.md");
+  mkdirSync14(join22(workspaceDir, "beliefs"), { recursive: true });
+  mkdirSync14(join22(workspaceDir, "goals"), { recursive: true });
+  mkdirSync14(join22(workspaceDir, "skills"), { recursive: true });
+  const worldviewFile = join22(workspaceDir, "beliefs", "worldview.md");
   if (!existsSync20(worldviewFile)) {
-    writeFileSync10(
+    writeFileSync11(
       worldviewFile,
       `# Personal Worldview
 
@@ -18387,9 +18525,9 @@ Here, I declare the core concepts and principles I want to master.
       "utf8"
     );
   }
-  const goalsFile = join20(workspaceDir, "goals", "goals.md");
+  const goalsFile = join22(workspaceDir, "goals", "goals.md");
   if (!existsSync20(goalsFile)) {
-    writeFileSync10(
+    writeFileSync11(
       goalsFile,
       `# Personal Goals
 
@@ -18411,7 +18549,7 @@ var initCommand = new Command8("init").description("Launch the guided interactiv
   );
   printLine();
   console.log("\n\x1B[1m[1/5] Setting up Local Workspace Sandbox\x1B[0m");
-  const defaultWorkspace = join20(HOME2, "Documents", "zam");
+  const defaultWorkspace = join22(HOME2, "Documents", "zam");
   const workspacePath = resolve6(
     await input3({
       message: "Choose your ZAM workspace directory:",
@@ -19613,7 +19751,7 @@ observerCommand.command("revoke <process>").description("Remove a process from o
 
 // src/cli/commands/profile.ts
 init_kernel();
-import { dirname as dirname7, resolve as resolve7 } from "path";
+import { dirname as dirname8, resolve as resolve7 } from "path";
 import { Command as Command13 } from "commander";
 var C2 = {
   reset: "\x1B[0m",
@@ -19654,7 +19792,7 @@ var profileCommand = new Command13("profile").description("Show or change this m
       mode: getInstallMode(),
       personalDir,
       syncProvider: detectSyncProvider(personalDir),
-      dataDir: dirname7(dbPath),
+      dataDir: dirname8(dbPath),
       dbPath
     };
     if (opts.json) {
@@ -20043,7 +20181,7 @@ ${"\u2550".repeat(50)}`);
 
 // src/cli/commands/session.ts
 init_kernel();
-import { readFileSync as readFileSync14 } from "fs";
+import { readFileSync as readFileSync15 } from "fs";
 import { input as input6, select as select2 } from "@inquirer/prompts";
 import { Command as Command16 } from "commander";
 var sessionCommand = new Command16("session").description(
@@ -20234,7 +20372,7 @@ function loadPatternFile(path) {
   if (!path) return [];
   let parsed;
   try {
-    parsed = JSON.parse(readFileSync14(path, "utf-8"));
+    parsed = JSON.parse(readFileSync15(path, "utf-8"));
   } catch (err) {
     throw new Error(
       `Cannot read synthesis patterns from ${path}: ${err.message}`
@@ -20787,8 +20925,8 @@ skillCommand.command("add").description("Register a new agent skill").requiredOp
 
 // src/cli/commands/snapshot.ts
 init_kernel();
-import { existsSync as existsSync22, mkdirSync as mkdirSync14, readFileSync as readFileSync15, writeFileSync as writeFileSync11 } from "fs";
-import { dirname as dirname8, join as join21 } from "path";
+import { existsSync as existsSync22, mkdirSync as mkdirSync15, readFileSync as readFileSync16, writeFileSync as writeFileSync12 } from "fs";
+import { dirname as dirname9, join as join23 } from "path";
 import { Command as Command20 } from "commander";
 function defaultOutName() {
   const stamp = (/* @__PURE__ */ new Date()).toISOString().replace(/\.\d+Z$/, "").replace(/:/g, "-");
@@ -20817,12 +20955,12 @@ var exportCmd = new Command20("export").description("Write a portable SQL-text s
       process.stdout.write(snapshot);
       return;
     }
-    const out = opts.out ?? join21(personalDir, "snapshots", defaultOutName());
-    const dir = dirname8(out);
+    const out = opts.out ?? join23(personalDir, "snapshots", defaultOutName());
+    const dir = dirname9(out);
     if (dir && dir !== "." && !existsSync22(dir)) {
-      mkdirSync14(dir, { recursive: true });
+      mkdirSync15(dir, { recursive: true });
     }
-    writeFileSync11(out, snapshot, "utf-8");
+    writeFileSync12(out, snapshot, "utf-8");
     console.log(`Snapshot written: ${out}`);
     console.log(
       `  ${total} row(s)${nonEmpty.length ? ` \u2014 ${nonEmpty.join(", ")}` : ""}`
@@ -20840,7 +20978,7 @@ var importCmd = new Command20("import").description("Restore a snapshot into the
       console.error(`Error: Snapshot file not found: ${file}`);
       process.exit(1);
     }
-    const snapshot = readFileSync15(file, "utf-8");
+    const snapshot = readFileSync16(file, "utf-8");
     db = await openDatabaseWithSync({ initialize: true });
     const result = await importSnapshot(db, snapshot, { force: opts.force });
     await db.close();
@@ -20862,7 +21000,7 @@ var verifyCmd = new Command20("verify").description("Check a snapshot's manifest
       console.error(`Error: Snapshot file not found: ${file}`);
       process.exit(1);
     }
-    const manifest = verifySnapshot(readFileSync15(file, "utf-8"));
+    const manifest = verifySnapshot(readFileSync16(file, "utf-8"));
     const { total, nonEmpty } = summarize(manifest.tables);
     console.log(`Valid snapshot (format v${manifest.version})`);
     console.log(`  created: ${manifest.createdAt}`);
@@ -21413,8 +21551,8 @@ init_kernel();
 import { spawn as spawn3, spawnSync } from "child_process";
 import { existsSync as existsSync23 } from "fs";
 import { homedir as homedir13 } from "os";
-import { dirname as dirname9, join as join22 } from "path";
-import { fileURLToPath as fileURLToPath3 } from "url";
+import { dirname as dirname10, join as join24 } from "path";
+import { fileURLToPath as fileURLToPath4 } from "url";
 import { Command as Command23 } from "commander";
 var C3 = {
   reset: "\x1B[0m",
@@ -21425,14 +21563,14 @@ var C3 = {
   dim: "\x1B[2m"
 };
 function findDesktopDir() {
-  const starts = [process.cwd(), dirname9(fileURLToPath3(import.meta.url))];
+  const starts = [process.cwd(), dirname10(fileURLToPath4(import.meta.url))];
   for (const start of starts) {
     let dir = start;
     for (let i = 0; i < 10; i++) {
-      if (existsSync23(join22(dir, "desktop", "src-tauri", "tauri.conf.json"))) {
-        return join22(dir, "desktop");
+      if (existsSync23(join24(dir, "desktop", "src-tauri", "tauri.conf.json"))) {
+        return join24(dir, "desktop");
       }
-      const parent = dirname9(dir);
+      const parent = dirname10(dir);
       if (parent === dir) break;
       dir = parent;
     }
@@ -21440,18 +21578,18 @@ function findDesktopDir() {
   return null;
 }
 function findBuiltApp(desktopDir) {
-  const releaseDir = join22(desktopDir, "src-tauri", "target", "release");
+  const releaseDir = join24(desktopDir, "src-tauri", "target", "release");
   if (process.platform === "win32") {
     for (const name of ["ZAM.exe", "zam.exe", "zam-desktop.exe"]) {
-      const p = join22(releaseDir, name);
+      const p = join24(releaseDir, name);
       if (existsSync23(p)) return p;
     }
   } else if (process.platform === "darwin") {
-    const app = join22(releaseDir, "bundle", "macos", "ZAM.app");
+    const app = join24(releaseDir, "bundle", "macos", "ZAM.app");
     if (existsSync23(app)) return app;
   } else {
     for (const name of ["zam", "ZAM", "zam-desktop"]) {
-      const p = join22(releaseDir, name);
+      const p = join24(releaseDir, name);
       if (existsSync23(p)) return p;
     }
   }
@@ -21459,10 +21597,10 @@ function findBuiltApp(desktopDir) {
 }
 function findInstalledApp() {
   const candidates = process.platform === "win32" ? [
-    process.env.LOCALAPPDATA && join22(process.env.LOCALAPPDATA, "Programs", "ZAM", "ZAM.exe"),
-    process.env.ProgramFiles && join22(process.env.ProgramFiles, "ZAM", "ZAM.exe"),
-    process.env["ProgramFiles(x86)"] && join22(process.env["ProgramFiles(x86)"], "ZAM", "ZAM.exe")
-  ] : process.platform === "darwin" ? ["/Applications/ZAM.app", join22(homedir13(), "Applications", "ZAM.app")] : ["/opt/ZAM/zam", "/usr/bin/zam-desktop"];
+    process.env.LOCALAPPDATA && join24(process.env.LOCALAPPDATA, "Programs", "ZAM", "ZAM.exe"),
+    process.env.ProgramFiles && join24(process.env.ProgramFiles, "ZAM", "ZAM.exe"),
+    process.env["ProgramFiles(x86)"] && join24(process.env["ProgramFiles(x86)"], "ZAM", "ZAM.exe")
+  ] : process.platform === "darwin" ? ["/Applications/ZAM.app", join24(homedir13(), "Applications", "ZAM.app")] : ["/opt/ZAM/zam", "/usr/bin/zam-desktop"];
   return candidates.find((candidate) => candidate && existsSync23(candidate)) || null;
 }
 function runNpm(args, opts) {
@@ -21474,7 +21612,7 @@ function runNpm(args, opts) {
   return res.status ?? 1;
 }
 function ensureDesktopDeps(desktopDir) {
-  if (existsSync23(join22(desktopDir, "node_modules"))) return true;
+  if (existsSync23(join24(desktopDir, "node_modules"))) return true;
   console.log(
     `${C3.cyan}Installing desktop dependencies (one-time)...${C3.reset}`
   );
@@ -21500,7 +21638,7 @@ function requireRust() {
 function hasMsvcBuildTools() {
   if (process.platform !== "win32") return true;
   const pf86 = process.env["ProgramFiles(x86)"] || "C:\\Program Files (x86)";
-  const vswhere = join22(
+  const vswhere = join24(
     pf86,
     "Microsoft Visual Studio",
     "Installer",
@@ -21538,7 +21676,7 @@ function requireMsvcOnWindows() {
   return false;
 }
 function warnIfCliMissing(repoRoot) {
-  if (!existsSync23(join22(repoRoot, "dist", "cli", "index.js"))) {
+  if (!existsSync23(join24(repoRoot, "dist", "cli", "index.js"))) {
     console.warn(
       `${C3.yellow}\u26A0 CLI build not found (dist/cli/index.js). The GUI bridge needs it \u2014 run 'npm run build' at the repo root.${C3.reset}`
     );
@@ -21611,7 +21749,7 @@ var uiCommand = new Command23("ui").description("Launch the ZAM Desktop GUI (Act
     );
     process.exit(1);
   }
-  const repoRoot = dirname9(desktopDir);
+  const repoRoot = dirname10(desktopDir);
   if (opts.build) {
     if (!requireRust()) process.exit(1);
     if (!requireMsvcOnWindows()) process.exit(1);
@@ -21622,7 +21760,7 @@ var uiCommand = new Command23("ui").description("Launch the ZAM Desktop GUI (Act
     );
     const code = runNpm(["run", "tauri", "build"], { cwd: desktopDir });
     if (code === 0) {
-      const bundle = join22(
+      const bundle = join24(
         desktopDir,
         "src-tauri",
         "target",
@@ -21662,7 +21800,7 @@ ${C3.green}\u2713 Done. Installer is in:${C3.reset}
       );
       process.exit(1);
     }
-    createShortcuts(shortcutTarget, dirname9(shortcutTarget));
+    createShortcuts(shortcutTarget, dirname10(shortcutTarget));
     return;
   }
   if (builtApp) {
@@ -21700,12 +21838,11 @@ ${C3.dim}After that, 'zam ui' launches it directly.${C3.reset}`
 // src/cli/commands/update.ts
 init_kernel();
 import { spawnSync as spawnSync2 } from "child_process";
-import { existsSync as existsSync24, readFileSync as readFileSync16, realpathSync as realpathSync2 } from "fs";
-import { dirname as dirname10, join as join23 } from "path";
-import { fileURLToPath as fileURLToPath4 } from "url";
+import { existsSync as existsSync24, readFileSync as readFileSync17, realpathSync as realpathSync2 } from "fs";
+import { dirname as dirname11, join as join25 } from "path";
+import { fileURLToPath as fileURLToPath5 } from "url";
 import { confirm as confirm3 } from "@inquirer/prompts";
 import { Command as Command24 } from "commander";
-var GITHUB_REPO = "zam-os/zam";
 var CHANNELS = [
   "developer",
   "direct",
@@ -21721,48 +21858,16 @@ var C4 = {
   red: "\x1B[31m",
   yellow: "\x1B[33m"
 };
-function currentVersion() {
-  const here = dirname10(fileURLToPath4(import.meta.url));
-  for (const up of ["..", "../..", "../../.."]) {
-    try {
-      const pkg2 = JSON.parse(
-        readFileSync16(join23(here, up, "package.json"), "utf-8")
-      );
-      if (pkg2.version) return pkg2.version;
-    } catch {
-    }
-  }
-  return "0.0.0";
-}
 function versionAt(dir) {
   try {
     const pkg2 = JSON.parse(
-      readFileSync16(join23(dir, "package.json"), "utf-8")
+      readFileSync17(join25(dir, "package.json"), "utf-8")
     );
     return pkg2.version ?? "unknown";
   } catch {
     return "unknown";
   }
 }
-async function fetchLatestVersion(repo) {
-  const res = await fetch(
-    `https://api.github.com/repos/${repo}/releases/latest`,
-    {
-      headers: {
-        Accept: "application/vnd.github+json",
-        "User-Agent": "zam-cli"
-      }
-    }
-  );
-  if (!res.ok) {
-    throw new Error(
-      `Could not reach the release server (HTTP ${res.status}). Pass --latest <version> to check offline.`
-    );
-  }
-  const data = await res.json();
-  if (!data.tag_name) throw new Error("No published release found yet.");
-  return data.tag_name;
-}
 function render2(decision) {
   if (!decision.updateAvailable) {
     console.log(
@@ -21814,14 +21919,14 @@ var checkCmd = new Command24("check").description("Check whether a newer ZAM has
   }
 );
 function findSourceRepo() {
-  let dir = realpathSync2(dirname10(fileURLToPath4(import.meta.url)));
-  let parent = dirname10(dir);
+  let dir = realpathSync2(dirname11(fileURLToPath5(import.meta.url)));
+  let parent = dirname11(dir);
   while (parent !== dir) {
-    if (existsSync24(join23(dir, ".git"))) return dir;
+    if (existsSync24(join25(dir, ".git"))) return dir;
     dir = parent;
-    parent = dirname10(dir);
+    parent = dirname11(dir);
   }
-  return existsSync24(join23(dir, ".git")) ? dir : null;
+  return existsSync24(join25(dir, ".git")) ? dir : null;
 }
 function runGit(cwd, args, capture) {
   const res = spawnSync2("git", args, {
@@ -21842,7 +21947,7 @@ function runNpm2(args, cwd) {
 function smokeTestBuild(src) {
   const res = spawnSync2(
     process.execPath,
-    [join23(src, "dist", "cli", "index.js"), "--version"],
+    [join25(src, "dist", "cli", "index.js"), "--version"],
     {
       cwd: src,
       encoding: "utf8",
@@ -21922,7 +22027,7 @@ Fix it manually in ${src} (try \`npm ci && npm run build\`, and check your Node
   console.log(`${C4.dim}\u2192 zam setup --force${C4.reset}`);
   const setup = spawnSync2(
     process.execPath,
-    [join23(src, "dist", "cli", "index.js"), "setup", "--force"],
+    [join25(src, "dist", "cli", "index.js"), "setup", "--force"],
     { cwd: process.cwd(), stdio: "inherit" }
   );
   if (setup.status !== 0) {
@@ -22035,9 +22140,9 @@ var whoamiCommand = new Command25("whoami").description("Show or set the default
 // src/cli/commands/workspace.ts
 init_kernel();
 import { execFileSync as execFileSync4 } from "child_process";
-import { existsSync as existsSync25, writeFileSync as writeFileSync12 } from "fs";
+import { existsSync as existsSync25, writeFileSync as writeFileSync13 } from "fs";
 import { homedir as homedir14 } from "os";
-import { join as join24, resolve as resolve9 } from "path";
+import { join as join26, resolve as resolve9 } from "path";
 import { confirm as confirm4, input as input7 } from "@inquirer/prompts";
 import { Command as Command26 } from "commander";
 function runGit2(cwd, args) {
@@ -22272,15 +22377,15 @@ Active workspace: \x1B[36m${workspaceDir}\x1B[0m`);
     );
     process.exit(1);
   }
-  const gitignorePath = join24(workspaceDir, ".gitignore");
+  const gitignorePath = join26(workspaceDir, ".gitignore");
   if (!existsSync25(gitignorePath)) {
-    writeFileSync12(
+    writeFileSync13(
       gitignorePath,
       "node_modules/\n.agent/\n.agents/\n.claude/\n.gemini/\n.goose/\n*.log\n",
       "utf8"
     );
   }
-  const hasGitRepo = existsSync25(join24(workspaceDir, ".git"));
+  const hasGitRepo = existsSync25(join26(workspaceDir, ".git"));
   if (!hasGitRepo) {
     console.log("Initializing local Git repository...");
     runGit2(workspaceDir, ["init", "-b", "main"]);
@@ -22367,7 +22472,7 @@ Active workspace: \x1B[36m${workspaceDir}\x1B[0m`);
   }
 });
 workspaceCommand.command("data-dir").description("Print the ZAM data directory (database, credentials, config)").option("--json", "Output as JSON").action((opts) => {
-  const dir = join24(homedir14(), ".zam");
+  const dir = join26(homedir14(), ".zam");
   console.log(opts.json ? JSON.stringify({ dataDir: dir }) : dir);
 });
 workspaceCommand.command("backup").description("Back up the local ZAM database into your workspace").option(
@@ -22408,9 +22513,9 @@ workspaceCommand.command("backup").description("Back up the local ZAM database i
 });
 
 // src/cli/app.ts
-var __dirname = dirname11(fileURLToPath5(import.meta.url));
+var __dirname = dirname12(fileURLToPath6(import.meta.url));
 var pkg = JSON.parse(
-  readFileSync17(join25(__dirname, "..", "..", "package.json"), "utf-8")
+  readFileSync18(join27(__dirname, "..", "..", "package.json"), "utf-8")
 );
 var program = new Command27();
 program.name("zam").description(