zam-core 0.10.1 → 0.10.3

package/dist/cli/app.js

@@ -5481,20 +5481,20 @@ import { homedir as homedir5 } from "os";
 import { join as join8 } from "path";
 import { fileURLToPath } from "url";
 function getPackageSkillPath(agent = "default") {
-  const packageRoot2 = [
+  const packageRoot4 = [
     fileURLToPath(new URL("../../..", import.meta.url)),
     fileURLToPath(new URL("../..", import.meta.url)),
     fileURLToPath(new URL("..", import.meta.url))
   ].find((candidate) => existsSync7(join8(candidate, "package.json"))) ?? "";
-  if (!packageRoot2) return "";
+  if (!packageRoot4) return "";
   if (agent === "codex") {
-    const codexPath = join8(packageRoot2, ".agents", "skills", "zam", "SKILL.md");
+    const codexPath = join8(packageRoot4, ".agents", "skills", "zam", "SKILL.md");
     if (existsSync7(codexPath)) return codexPath;
     return "";
   }
   if (agent === "claude") {
     const claudePath = join8(
-      packageRoot2,
+      packageRoot4,
       ".claude",
       "skills",
       "zam",
@@ -5503,9 +5503,9 @@ function getPackageSkillPath(agent = "default") {
     if (existsSync7(claudePath)) return claudePath;
     return "";
   }
-  let path = join8(packageRoot2, ".agent", "skills", "zam", "SKILL.md");
+  let path = join8(packageRoot4, ".agent", "skills", "zam", "SKILL.md");
   if (existsSync7(path)) return path;
-  path = join8(packageRoot2, ".claude", "skills", "zam", "SKILL.md");
+  path = join8(packageRoot4, ".claude", "skills", "zam", "SKILL.md");
   if (existsSync7(path)) return path;
   return "";
 }
@@ -6808,16 +6808,16 @@ var init_kernel = __esm({
 });
 
 // src/cli/app.ts
-import { readFileSync as readFileSync18 } from "fs";
-import { dirname as dirname12, join as join27 } from "path";
-import { fileURLToPath as fileURLToPath6 } from "url";
+import { readFileSync as readFileSync20 } from "fs";
+import { dirname as dirname14, join as join29 } from "path";
+import { fileURLToPath as fileURLToPath8 } from "url";
 import { Command as Command27 } from "commander";
 
 // src/cli/commands/agent.ts
 init_kernel();
-import { existsSync as existsSync13, mkdirSync as mkdirSync8, writeFileSync as writeFileSync7 } from "fs";
-import { homedir as homedir9 } from "os";
-import { dirname as dirname5, join as join13 } from "path";
+import { existsSync as existsSync15, mkdirSync as mkdirSync10, writeFileSync as writeFileSync9 } from "fs";
+import { homedir as homedir11 } from "os";
+import { dirname as dirname7, join as join15 } from "path";
 import { Command } from "commander";
 
 // src/cli/agent-harness.ts
@@ -7040,6 +7040,18 @@ function openTerminalWindow(opts) {
 }
 
 // src/cli/agent-harness.ts
+var ANTIGRAVITY_IDE_CANDIDATE_PATHS = {
+  darwin: [
+    join12(
+      homedir8(),
+      ".antigravity-ide",
+      "antigravity-ide",
+      "bin",
+      "antigravity-ide"
+    ),
+    "/Applications/Antigravity IDE.app/Contents/Resources/app/bin/antigravity-ide"
+  ]
+};
 var AGENT_HARNESSES = [
   { id: "claude-code", label: "Claude Code", kind: "cli", command: "claude" },
   { id: "codex", label: "Codex", kind: "cli", command: "codex" },
@@ -7061,19 +7073,41 @@ var AGENT_HARNESSES = [
     id: "antigravity",
     label: "Antigravity",
     kind: "app",
-    command: "antigravity"
+    command: "antigravity",
+    candidatePaths: {
+      darwin: [
+        ...ANTIGRAVITY_IDE_CANDIDATE_PATHS.darwin ?? [],
+        "/Applications/Antigravity.app/Contents/MacOS/Antigravity"
+      ]
+    }
   },
   { id: "goose", label: "goose", kind: "cli", command: "goose" }
 ];
 function getHarness(id) {
   return AGENT_HARNESSES.find((h) => h.id === id);
 }
+function resolveAntigravityIdeExecutable(deps = {}) {
+  const find = deps.find ?? findExecutable;
+  const exists = deps.exists ?? existsSync12;
+  const platform = deps.platform ?? process.platform;
+  const found = find("antigravity-ide");
+  if (found) return found;
+  return ANTIGRAVITY_IDE_CANDIDATE_PATHS[platform]?.find((path) => exists(path)) ?? null;
+}
 function resolveHarnessExecutable(harness, overrideCommand, deps = {}) {
   const find = deps.find ?? findExecutable;
   const exists = deps.exists ?? existsSync12;
   const platform = deps.platform ?? process.platform;
   const found = find(overrideCommand || harness.command);
   if (found) return found;
+  if (!overrideCommand && harness.id === "antigravity") {
+    const foundIde = resolveAntigravityIdeExecutable({
+      find,
+      exists,
+      platform
+    });
+    if (foundIde) return foundIde;
+  }
   if (harness.kind === "app") {
     for (const candidate of harness.candidatePaths?.[platform] ?? []) {
       if (exists(candidate)) return candidate;
@@ -7118,6 +7152,76 @@ function launchHarness(harness, opts) {
     console.log(`Launched ${harness.label} in ${opts.workspace}`);
   }
 }
+function detectInstalledConnectHarnesses(options = {}) {
+  const home = options.home ?? homedir8();
+  const platform = options.platform ?? process.platform;
+  const find = options.find ?? findExecutable;
+  const exists = options.exists ?? existsSync12;
+  const detected = [];
+  const hasCommandOrPath = (command, paths = []) => Boolean(find(command)) || paths.some((path) => exists(path));
+  if (hasCommandOrPath("codex", [
+    join12(home, ".codex"),
+    ...platform === "darwin" ? ["/Applications/Codex.app"] : platform === "win32" ? [join12(home, "AppData", "Local", "Programs", "Codex")] : []
+  ])) {
+    detected.push("codex");
+  }
+  const vscodePaths = platform === "darwin" ? [
+    "/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code",
+    join12(
+      home,
+      "Applications",
+      "Visual Studio Code.app",
+      "Contents",
+      "Resources",
+      "app",
+      "bin",
+      "code"
+    )
+  ] : platform === "win32" ? [
+    join12(
+      home,
+      "AppData",
+      "Local",
+      "Programs",
+      "Microsoft VS Code",
+      "bin",
+      "code.cmd"
+    )
+  ] : ["/usr/bin/code", "/usr/local/bin/code", "/snap/bin/code"];
+  if (hasCommandOrPath("code", vscodePaths)) detected.push("vscode");
+  const copilotHome = options.copilotHome ?? join12(home, ".copilot");
+  if (hasCommandOrPath("copilot", [
+    copilotHome,
+    ...platform === "darwin" ? ["/Applications/GitHub Copilot.app"] : []
+  ])) {
+    detected.push("copilot");
+  }
+  if (hasCommandOrPath("opencode", [join12(home, ".config", "opencode")])) {
+    detected.push("opencode");
+  }
+  if (hasCommandOrPath("goose", [join12(home, ".config", "goose")])) {
+    detected.push("goose");
+  }
+  if (hasCommandOrPath("antigravity", [
+    join12(home, ".gemini", "config"),
+    ...platform === "darwin" ? [
+      join12(
+        home,
+        ".antigravity-ide",
+        "antigravity-ide",
+        "bin",
+        "antigravity-ide"
+      ),
+      "/Applications/Antigravity.app",
+      "/Applications/Antigravity IDE.app"
+    ] : []
+  ]) || find("antigravity-ide")) {
+    detected.push("antigravity");
+  }
+  const claudeDesktopPath = platform === "darwin" ? "/Applications/Claude.app" : platform === "win32" ? join12(home, "AppData", "Local", "AnthropicClaude") : join12(home, ".config", "Claude");
+  if (exists(claudeDesktopPath)) detected.push("claude-desktop");
+  return detected;
+}
 function parseMcpJsonConfig(path, content) {
   let parsed;
   try {
@@ -7248,6 +7352,36 @@ approval_mode = "prompt"
       content = existingStr ? `${existingStr.trimEnd()}
 ${block}` : block;
     }
+  } else if (harnessId === "vscode") {
+    const platform = opts.platform ?? process.platform;
+    targetPath = platform === "win32" ? join12(opts.home, "AppData", "Roaming", "Code", "User", "mcp.json") : platform === "darwin" ? join12(
+      opts.home,
+      "Library",
+      "Application Support",
+      "Code",
+      "User",
+      "mcp.json"
+    ) : join12(opts.home, ".config", "Code", "User", "mcp.json");
+    hint = "Reload VS Code after setup. ZAM Companion stays separate from the Codex chat and can be moved to any panel or sidebar.";
+    let existing = {};
+    if (exists(targetPath)) {
+      existing = parseMcpJsonConfig(targetPath, read(targetPath));
+    }
+    if (existing.servers !== void 0 && (typeof existing.servers !== "object" || existing.servers === null || Array.isArray(existing.servers))) {
+      throw new Error(
+        `Cannot update ${targetPath}: servers must be a JSON object`
+      );
+    }
+    if (existing.inputs !== void 0 && !Array.isArray(existing.inputs)) {
+      throw new Error(`Cannot update ${targetPath}: inputs must be an array`);
+    }
+    if (!existing.servers) existing.servers = {};
+    const expectedServer = { command: opts.zamPath, args: ["mcp"] };
+    const currentServer = existing.servers.zam;
+    alreadyConfigured = Array.isArray(existing.inputs) && typeof currentServer === "object" && currentServer !== null && !Array.isArray(currentServer) && JSON.stringify(currentServer) === JSON.stringify(expectedServer);
+    existing.servers.zam = expectedServer;
+    if (!existing.inputs) existing.inputs = [];
+    content = JSON.stringify(existing, null, 2);
   } else if (harnessId === "goose") {
     targetPath = join12(opts.home, ".config", "goose", "config.yaml");
     hint = "goose will load the 'zam' extension on next session start. Run 'goose configure' to manage extensions.";
@@ -7286,8 +7420,11 @@ ${zamExtension}
 `;
     }
   } else if (harnessId === "copilot") {
-    targetPath = join12(opts.home, ".copilot", "mcp-config.json");
-    hint = "GitHub Copilot CLI will load the 'zam' MCP server on next session. Use '/mcp show' in Copilot CLI to verify.";
+    targetPath = join12(
+      opts.copilotHome ?? join12(opts.home, ".copilot"),
+      "mcp-config.json"
+    );
+    hint = "Restart GitHub Copilot or start a new session to load the 'zam' MCP server and its focused Recall, Graph, and Settings canvases.";
     let existing = {};
     if (exists(targetPath)) {
       existing = parseMcpJsonConfig(targetPath, read(targetPath));
@@ -7311,6 +7448,231 @@ ${zamExtension}
   };
 }
 
+// src/cli/copilot-extension.ts
+import {
+  existsSync as existsSync13,
+  lstatSync,
+  mkdirSync as mkdirSync8,
+  readFileSync as readFileSync10,
+  writeFileSync as writeFileSync7
+} from "fs";
+import { homedir as homedir9 } from "os";
+import { dirname as dirname5, join as join13, resolve as resolve3 } from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
+var EXTENSION_NAME = "zam-mcp-apps";
+var EXTENSION_FILES = [
+  "extension.mjs",
+  "host.bundle.js",
+  "mcp-client.bundle.mjs",
+  "manifest.json"
+];
+var packageRoot = [
+  fileURLToPath2(new URL("../..", import.meta.url)),
+  fileURLToPath2(new URL("../../..", import.meta.url))
+].find((candidate) => existsSync13(join13(candidate, "package.json"))) ?? fileURLToPath2(new URL("../..", import.meta.url));
+function defaultCliEntry() {
+  return join13(dirname5(fileURLToPath2(import.meta.url)), "index.js");
+}
+function resolveCopilotHome(home = homedir9(), configuredHome = process.env.COPILOT_HOME) {
+  return configuredHome?.trim() ? resolve3(configuredHome) : join13(home, ".copilot");
+}
+function resolveCopilotZamLaunch(zamPath, options = {}) {
+  const cliEntry = options.cliEntry ?? defaultCliEntry();
+  if (existsSync13(cliEntry)) {
+    return {
+      command: options.nodePath ?? process.execPath,
+      args: [cliEntry, "mcp"]
+    };
+  }
+  return {
+    command: zamPath,
+    args: ["mcp"]
+  };
+}
+function planCopilotExtensionInstall(options) {
+  const sourceDir = options.assetsDir ?? join13(packageRoot, "dist", "copilot-extension");
+  for (const file of EXTENSION_FILES) {
+    if (!existsSync13(join13(sourceDir, file))) {
+      throw new Error(
+        `Copilot MCP Apps asset is missing: ${join13(sourceDir, file)}. Run \`npm run build\` and retry.`
+      );
+    }
+  }
+  const manifest = JSON.parse(
+    readFileSync10(join13(sourceDir, "manifest.json"), "utf8")
+  );
+  if (manifest.name !== EXTENSION_NAME || typeof manifest.version !== "string" || !manifest.version) {
+    throw new Error(
+      `Invalid Copilot MCP Apps manifest: ${join13(sourceDir, "manifest.json")}`
+    );
+  }
+  const copilotHome = resolveCopilotHome(
+    options.home,
+    options.copilotHome ?? process.env.COPILOT_HOME
+  );
+  return {
+    sourceDir,
+    destinationDir: join13(copilotHome, "extensions", EXTENSION_NAME),
+    launch: resolveCopilotZamLaunch(options.zamPath, options),
+    files: EXTENSION_FILES
+  };
+}
+function writeIfChanged(path, content) {
+  const next = Buffer.isBuffer(content) ? content : Buffer.from(content);
+  if (existsSync13(path) && readFileSync10(path).equals(next)) return false;
+  writeFileSync7(path, next);
+  return true;
+}
+function installCopilotExtension(options) {
+  const plan = planCopilotExtensionInstall(options);
+  if (options.dryRun) {
+    return { ...plan, action: "planned", changedFiles: [] };
+  }
+  const destinationExisted = existsSync13(plan.destinationDir);
+  if (destinationExisted && lstatSync(plan.destinationDir).isSymbolicLink()) {
+    throw new Error(
+      `Refusing to replace symlinked Copilot extension directory: ${plan.destinationDir}`
+    );
+  }
+  mkdirSync8(plan.destinationDir, { recursive: true });
+  const changedFiles = [];
+  for (const file of plan.files) {
+    const source = join13(plan.sourceDir, file);
+    const destination = join13(plan.destinationDir, file);
+    if (writeIfChanged(destination, readFileSync10(source))) {
+      changedFiles.push(file);
+    }
+  }
+  const launchContent = `${JSON.stringify(
+    {
+      schemaVersion: 1,
+      command: plan.launch.command,
+      args: plan.launch.args
+    },
+    null,
+    2
+  )}
+`;
+  if (writeIfChanged(join13(plan.destinationDir, "launch.json"), launchContent)) {
+    changedFiles.push("launch.json");
+  }
+  return {
+    ...plan,
+    action: !destinationExisted ? "installed" : changedFiles.length > 0 ? "updated" : "unchanged",
+    changedFiles
+  };
+}
+
+// src/cli/vscode-extension.ts
+import { execFileSync as execFileSync3 } from "child_process";
+import { existsSync as existsSync14, mkdirSync as mkdirSync9, readFileSync as readFileSync11, writeFileSync as writeFileSync8 } from "fs";
+import { homedir as homedir10 } from "os";
+import { dirname as dirname6, join as join14 } from "path";
+import { fileURLToPath as fileURLToPath3 } from "url";
+var packageRoot2 = [
+  fileURLToPath3(new URL("../..", import.meta.url)),
+  fileURLToPath3(new URL("../../..", import.meta.url))
+].find((candidate) => existsSync14(join14(candidate, "package.json"))) ?? fileURLToPath3(new URL("../..", import.meta.url));
+function resolveVscodeExecutable(options = {}) {
+  const home = options.home ?? homedir10();
+  const platform = options.platform ?? process.platform;
+  const find = options.find ?? findExecutable;
+  const exists = options.exists ?? existsSync14;
+  const found = find("code");
+  if (found) return found;
+  const candidates = platform === "darwin" ? [
+    "/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code",
+    join14(
+      home,
+      "Applications",
+      "Visual Studio Code.app",
+      "Contents",
+      "Resources",
+      "app",
+      "bin",
+      "code"
+    )
+  ] : platform === "win32" ? [
+    join14(
+      home,
+      "AppData",
+      "Local",
+      "Programs",
+      "Microsoft VS Code",
+      "bin",
+      "code.cmd"
+    )
+  ] : ["/usr/bin/code", "/usr/local/bin/code", "/snap/bin/code"];
+  return candidates.find((candidate) => exists(candidate)) ?? null;
+}
+function packageVersion() {
+  const parsed = JSON.parse(
+    readFileSync11(join14(packageRoot2, "package.json"), "utf8")
+  );
+  if (typeof parsed.version !== "string" || !parsed.version) {
+    throw new Error("Cannot determine the ZAM package version");
+  }
+  return parsed.version;
+}
+function planVscodeExtensionInstall(options) {
+  const home = options.home ?? homedir10();
+  const version = options.version ?? packageVersion();
+  const assetsDir = options.assetsDir ?? join14(packageRoot2, "dist", "vscode-extension");
+  const vsixPath = join14(assetsDir, `ZAM_Companion_${version}.vsix`);
+  if (!existsSync14(vsixPath)) {
+    throw new Error(
+      `ZAM Companion VSIX asset is missing: ${vsixPath}. Run \`npm run build\` and retry.`
+    );
+  }
+  const codePath = options.codePath ?? resolveVscodeExecutable({
+    home,
+    platform: options.platform,
+    find: options.find,
+    exists: options.exists
+  });
+  if (!codePath) {
+    throw new Error(
+      "Visual Studio Code was not detected. Install VS Code or add its 'code' command to PATH."
+    );
+  }
+  return {
+    version,
+    vsixPath,
+    codePath,
+    launchConfigPath: join14(home, ".zam", "vscode-launch.json"),
+    launch: { command: options.zamPath, args: ["mcp"] }
+  };
+}
+function installVscodeExtension(options) {
+  const plan = planVscodeExtensionInstall(options);
+  if (options.dryRun) return { ...plan, action: "planned" };
+  const launchContent = `${JSON.stringify(
+    {
+      schemaVersion: 1,
+      version: plan.version,
+      command: plan.launch.command,
+      args: plan.launch.args
+    },
+    null,
+    2
+  )}
+`;
+  const existed = existsSync14(plan.launchConfigPath);
+  const changed = !existed || readFileSync11(plan.launchConfigPath, "utf8") !== launchContent;
+  const run = options.run ?? ((command, args) => {
+    execFileSync3(command, args, { stdio: "pipe" });
+  });
+  run(plan.codePath, ["--install-extension", plan.vsixPath, "--force"]);
+  if (changed) {
+    mkdirSync9(dirname6(plan.launchConfigPath), { recursive: true });
+    writeFileSync8(plan.launchConfigPath, launchContent, "utf8");
+  }
+  return {
+    ...plan,
+    action: !existed ? "installed" : changed ? "updated" : "unchanged"
+  };
+}
+
 // src/cli/commands/agent.ts
 var C = {
   reset: "\x1B[0m",
@@ -7326,6 +7688,7 @@ var CONNECT_HARNESSES = [
   "claude-desktop",
   "antigravity",
   "codex",
+  "vscode",
   "opencode",
   "goose",
   "copilot"
@@ -7334,7 +7697,7 @@ function isConnectHarnessId(value) {
   return CONNECT_HARNESSES.includes(value);
 }
 function agentsMdPresent(cwd = process.cwd()) {
-  return existsSync13(join13(cwd, "AGENTS.md"));
+  return existsSync15(join15(cwd, "AGENTS.md"));
 }
 function printStatus() {
   const installed = hasCommand("opencode");
@@ -7440,16 +7803,34 @@ var openCmd = new Command("open").description("Open an agent harness in the work
   const workspace = opts.dir ?? process.cwd();
   launchHarness(harness, { executable, workspace, shell });
 });
-var connectCmd = new Command("connect").description("Configure the ZAM MCP server for an agent harness").argument(
-  "<harness>",
-  "Harness to connect: claude-code | claude-desktop | antigravity | codex | opencode | goose | copilot"
+var connectCmd = new Command("connect").description(
+  "Configure ZAM for detected user agent harnesses, or one explicit harness"
+).argument(
+  "[harness]",
+  "Optional harness: claude-code | claude-desktop | antigravity | codex | vscode | opencode | goose | copilot"
 ).option(
   "--print",
   "Print configuration changes instead of writing them to disk"
 ).action(async (harnessArg, opts) => {
-  if (!isConnectHarnessId(harnessArg)) {
+  let explicitHarness;
+  if (harnessArg) {
+    if (!isConnectHarnessId(harnessArg)) {
+      console.error(
+        `Unsupported harness: ${harnessArg}. Supported: ${CONNECT_HARNESSES.join(", ")}.`
+      );
+      process.exit(1);
+    } else {
+      explicitHarness = harnessArg;
+    }
+  }
+  const home = homedir11();
+  const harnesses = explicitHarness ? [explicitHarness] : detectInstalledConnectHarnesses({
+    home,
+    copilotHome: process.env.COPILOT_HOME
+  });
+  if (harnesses.length === 0) {
     console.error(
-      `Unsupported harness: ${harnessArg}. Supported: ${CONNECT_HARNESSES.join(", ")}.`
+      "No supported user-scoped agent harness was detected. Install Codex, VS Code, or another supported host, or pass a harness explicitly."
     );
     process.exit(1);
   }
@@ -7460,54 +7841,117 @@ var connectCmd = new Command("connect").description("Configure the ZAM MCP serve
     );
     zamPath = "zam";
   }
-  let result;
-  try {
-    result = connectHarnessMcp(harnessArg, {
-      zamPath,
-      cwd: process.cwd(),
-      home: homedir9()
-    });
-  } catch (error) {
-    console.error(
-      `Error preparing MCP configuration: ${error instanceof Error ? error.message : String(error)}`
-    );
-    process.exit(1);
-  }
-  if (opts.print) {
-    console.log(`Path: ${result.path}`);
-    console.log(`Content:
+  for (const harness of harnesses) {
+    let result;
+    try {
+      result = connectHarnessMcp(harness, {
+        zamPath,
+        cwd: process.cwd(),
+        home,
+        copilotHome: process.env.COPILOT_HOME
+      });
+    } catch (error) {
+      console.error(
+        `Error preparing ${harness} MCP configuration: ${error instanceof Error ? error.message : String(error)}`
+      );
+      process.exit(1);
+    }
+    let copilotExtension;
+    let vscodeExtension;
+    try {
+      if (harness === "copilot") {
+        copilotExtension = installCopilotExtension({
+          home,
+          zamPath,
+          dryRun: Boolean(opts.print)
+        });
+      } else if (harness === "vscode") {
+        vscodeExtension = installVscodeExtension({
+          home,
+          zamPath,
+          dryRun: Boolean(opts.print)
+        });
+      } else if (harness === "antigravity") {
+        const antigravityPath = resolveAntigravityIdeExecutable();
+        if (antigravityPath) {
+          vscodeExtension = installVscodeExtension({
+            home,
+            zamPath,
+            codePath: antigravityPath,
+            dryRun: Boolean(opts.print)
+          });
+        }
+      }
+    } catch (error) {
+      console.error(
+        `Error preparing ${harness} companion extension: ${error instanceof Error ? error.message : String(error)}`
+      );
+      process.exit(1);
+    }
+    if (opts.print) {
+      if (harnesses.length > 1) console.log(`${C.bold}${harness}${C.reset}`);
+      console.log(`Path: ${result.path}`);
+      console.log(`Content:
 ${result.content}`);
-    return;
-  }
-  if (result.alreadyConfigured) {
-    console.log(
-      `${C.green}\u2713${C.reset} MCP server 'zam' already configured in ${result.path}`
-    );
-    return;
+      if (copilotExtension) {
+        console.log(`Extension: ${copilotExtension.destinationDir}`);
+        console.log(
+          `Launch: ${copilotExtension.launch.command} ${copilotExtension.launch.args.join(" ")}`
+        );
+      }
+      if (vscodeExtension) {
+        console.log(`Extension: ${vscodeExtension.vsixPath}`);
+        console.log(`Launch config: ${vscodeExtension.launchConfigPath}`);
+      }
+      continue;
+    }
+    if (result.alreadyConfigured) {
+      console.log(
+        `${C.green}\u2713${C.reset} ${harness}: MCP server 'zam' already configured in ${result.path}`
+      );
+    } else {
+      try {
+        mkdirSync10(dirname7(result.path), { recursive: true });
+        writeFileSync9(result.path, result.content, "utf-8");
+        console.log(
+          `${C.green}\u2713${C.reset} ${harness}: wrote MCP configuration to ${result.path}`
+        );
+      } catch (error) {
+        console.error(
+          `Error writing ${harness} MCP configuration: ${error instanceof Error ? error.message : String(error)}`
+        );
+        process.exit(1);
+      }
+    }
+    if (copilotExtension) {
+      console.log(
+        `${C.green}\u2713${C.reset} Copilot MCP Apps extension ${copilotExtension.action} at ${copilotExtension.destinationDir}`
+      );
+    }
+    if (vscodeExtension) {
+      console.log(
+        `${C.green}\u2713${C.reset} ZAM Companion ${vscodeExtension.action} from ${vscodeExtension.vsixPath}`
+      );
+    }
+    console.log(`  ${C.dim}${result.hint}${C.reset}`);
   }
-  try {
-    mkdirSync8(dirname5(result.path), { recursive: true });
-    writeFileSync7(result.path, result.content, "utf-8");
+  if (!opts.print) {
+    const skills = distributeGlobalSkills(home);
+    const installed = skills.filter((result) => result.success).length;
     console.log(
-      `${C.green}\u2713${C.reset} Wrote MCP configuration to ${result.path}`
+      `${C.green}\u2713${C.reset} Refreshed ${installed}/${skills.length} global ZAM skill installations`
     );
-    console.log(`  ${C.dim}${result.hint}${C.reset}`);
-  } catch (error) {
-    console.error(
-      `Error writing MCP configuration: ${error instanceof Error ? error.message : String(error)}`
-    );
-    process.exit(1);
   }
 });
 var agentCommand = new Command("agent").description("Provision and inspect the agent that drives ZAM sessions").addCommand(installCmd).addCommand(statusCmd).addCommand(openCmd).addCommand(listCmd).addCommand(connectCmd).action(printStatus);
 
 // src/cli/commands/bridge.ts
 init_kernel();
-import { execFileSync as execFileSync3 } from "child_process";
+import { execFileSync as execFileSync4 } from "child_process";
 import { randomBytes as randomBytes2 } from "crypto";
-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 join20, resolve as resolve4 } from "path";
+import { existsSync as existsSync19, readdirSync as readdirSync2, readFileSync as readFileSync16, rmSync as rmSync3 } from "fs";
+import { homedir as homedir13, tmpdir as tmpdir3 } from "os";
+import { join as join22, resolve as resolve5 } from "path";
 import { Command as Command2 } from "commander";
 import { ulid as ulid9 } from "ulid";
 
@@ -7518,7 +7962,7 @@ import fs from "fs";
 // src/cli/llm/client.ts
 init_kernel();
 import { spawn as spawn2 } from "child_process";
-import { existsSync as existsSync14, readFileSync as readFileSync10, statSync as statSync2 } from "fs";
+import { existsSync as existsSync16, readFileSync as readFileSync12, statSync as statSync2 } from "fs";
 var DEFAULT_LLM_URL = "http://localhost:8000/v1";
 var DEFAULT_LLM_MAX_TOKENS = 1e4;
 var RECALL_QUESTION_MAX_OUTPUT_TOKENS = 400;
@@ -8234,7 +8678,7 @@ async function extractTextFromScanViaLLM(db, imagePath) {
       "Vision role is not enabled in settings (llm.vision.enabled)"
     );
   }
-  if (!existsSync14(imagePath)) {
+  if (!existsSync16(imagePath)) {
     throw new Error(`Scan file not found: ${imagePath}`);
   }
   const stat = statSync2(imagePath);
@@ -8255,7 +8699,7 @@ async function extractTextFromScanViaLLM(db, imagePath) {
   if (!mime) {
     throw new Error("Unsupported scan format; use PNG, JPEG, or WebP");
   }
-  const imageBytes = readFileSync10(imagePath);
+  const imageBytes = readFileSync12(imagePath);
   const dataUrl = `data:${mime};base64,${imageBytes.toString("base64")}`;
   const visionEndpoint = await getVisionConfig(db);
   const langName = LANGUAGE_NAMES[p.locale] || "English";
@@ -8472,7 +8916,7 @@ async function prepareRecallChain(db, opts) {
       } else {
         spawnLocalRunner(endpoint.url, endpoint.model, endpoint.runner);
         while (Date.now() < deadline) {
-          await new Promise((resolve10) => setTimeout(resolve10, 1e3));
+          await new Promise((resolve11) => setTimeout(resolve11, 1e3));
           if (await isLlmOnline(endpoint.url)) {
             online = true;
             break;
@@ -8687,7 +9131,7 @@ function spawnLocalRunner(url, model, hint) {
   const { runner, port } = detectRunner(url, model, hint);
   try {
     if (runner === "fastflowlm") {
-      const flmExe = existsSync14("C:\\Program Files\\flm\\flm.exe") ? "C:\\Program Files\\flm\\flm.exe" : "flm";
+      const flmExe = existsSync16("C:\\Program Files\\flm\\flm.exe") ? "C:\\Program Files\\flm\\flm.exe" : "flm";
       if (!hasCommand("flm") && flmExe === "flm") return;
       spawn2(flmExe, ["serve", model, "--port", port], {
         detached: true,
@@ -8708,7 +9152,7 @@ function spawnLocalRunner(url, model, hint) {
 async function startLocalRunner(url, model, locale, hint) {
   const { runner, port } = detectRunner(url, model, hint);
   if (runner === "fastflowlm") {
-    const flmExe = existsSync14("C:\\Program Files\\flm\\flm.exe") ? "C:\\Program Files\\flm\\flm.exe" : "flm";
+    const flmExe = existsSync16("C:\\Program Files\\flm\\flm.exe") ? "C:\\Program Files\\flm\\flm.exe" : "flm";
     if (!hasCommand("flm") && flmExe === "flm") {
       console.warn(
         "\x1B[31m\u2717 FastFlowLM is configured but could not be found on the system.\x1B[0m"
@@ -8765,7 +9209,7 @@ async function startLocalRunner(url, model, locale, hint) {
   let attempts = 0;
   const dotsPerLine = 30;
   while (true) {
-    await new Promise((resolve10) => setTimeout(resolve10, 500));
+    await new Promise((resolve11) => setTimeout(resolve11, 500));
     if (await isLlmOnline(url)) {
       if (attempts > 0) process.stdout.write("\n");
       return true;
@@ -8854,8 +9298,8 @@ async function fetchWithInteractiveTimeout(url, options = {}) {
   const dotsPerLine = 30;
   while (true) {
     let timeoutId;
-    const timeoutPromise = new Promise((resolve10) => {
-      timeoutId = setTimeout(() => resolve10("timeout"), timeoutMs);
+    const timeoutPromise = new Promise((resolve11) => {
+      timeoutId = setTimeout(() => resolve11("timeout"), timeoutMs);
     });
     const dotsInterval = setInterval(() => {
       process.stdout.write(".");
@@ -9187,8 +9631,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";
+import { mkdirSync as mkdirSync12, writeFileSync as writeFileSync10 } from "fs";
+import { join as join18 } from "path";
 
 // src/cli/knowledge-contexts.ts
 init_kernel();
@@ -9435,16 +9879,16 @@ async function resolveSuggestMinSimilarity(db) {
 }
 
 // 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";
+import { readFileSync as readFileSync13 } from "fs";
+import { dirname as dirname8, join as join16 } from "path";
+import { fileURLToPath as fileURLToPath4 } from "url";
 var GITHUB_REPO = "zam-os/zam";
 function currentVersion() {
-  const here = dirname6(fileURLToPath2(import.meta.url));
+  const here = dirname8(fileURLToPath4(import.meta.url));
   for (const up of ["..", "../..", "../../.."]) {
     try {
       const pkg2 = JSON.parse(
-        readFileSync11(join14(here, up, "package.json"), "utf-8")
+        readFileSync13(join16(here, up, "package.json"), "utf-8")
       );
       if (pkg2.version) return pkg2.version;
     } catch {
@@ -9474,16 +9918,16 @@ async function fetchLatestVersion(repo) {
 
 // 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";
+import { existsSync as existsSync17, mkdirSync as mkdirSync11 } from "fs";
+import { homedir as homedir12 } from "os";
+import { basename as basename3, join as join17, resolve as resolve4 } from "path";
 var LEGACY_WORKSPACE_DIR_KEY = "personal.workspace_dir";
 var DEFAULT_WORKSPACE_ID = "personal";
 function defaultWorkspaceDir() {
-  return join15(homedir10(), "Documents", "zam");
+  return join17(homedir12(), "Documents", "zam");
 }
 function normalizeWorkspacePath(path) {
-  const resolved = resolve3(path);
+  const resolved = resolve4(path);
   return process.platform === "win32" ? resolved.toLowerCase() : resolved;
 }
 function sameWorkspacePath(left, right) {
@@ -9512,7 +9956,7 @@ async function clearLegacyWorkspaceDir(db) {
 async function migrateLegacyWorkspaceDir(db) {
   const legacyDir = await getSetting(db, LEGACY_WORKSPACE_DIR_KEY);
   if (!legacyDir) return void 0;
-  const path = resolve3(legacyDir);
+  const path = resolve4(legacyDir);
   const existing = findWorkspaceByPath(path);
   const migrated = existing ?? {
     id: getConfiguredWorkspaces().some(
@@ -9535,13 +9979,13 @@ async function ensureActiveWorkspace(db) {
   await migrateLegacyWorkspaceDir(db);
   const active = getActiveWorkspace();
   if (active) {
-    mkdirSync9(active.path, { recursive: true });
+    mkdirSync11(active.path, { recursive: true });
     return active;
   }
   const configured = getConfiguredWorkspaces()[0];
   if (configured) {
     setActiveWorkspaceId(configured.id);
-    mkdirSync9(configured.path, { recursive: true });
+    mkdirSync11(configured.path, { recursive: true });
     return configured;
   }
   const workspace = {
@@ -9550,7 +9994,7 @@ async function ensureActiveWorkspace(db) {
     kind: "personal",
     path: defaultWorkspaceDir()
   };
-  mkdirSync9(workspace.path, { recursive: true });
+  mkdirSync11(workspace.path, { recursive: true });
   upsertConfiguredWorkspace(workspace);
   setActiveWorkspaceId(workspace.id);
   await clearLegacyWorkspaceDir(db);
@@ -9564,7 +10008,7 @@ async function activateWorkspace(db, workspace) {
 }
 async function activateWorkspacePath(db, dir, opts = {}) {
   await migrateLegacyWorkspaceDir(db);
-  const path = resolve3(dir);
+  const path = resolve4(dir);
   const existing = opts.id ? void 0 : findWorkspaceByPath(path);
   if (existing) {
     setActiveWorkspaceId(existing.id);
@@ -9589,7 +10033,7 @@ async function removeWorkspaceAndResolveActive(db, id) {
   };
 }
 function existingWorkspaceDirOrHome(workspace) {
-  return existsSync15(workspace.path) ? workspace.path : homedir10();
+  return existsSync17(workspace.path) ? workspace.path : homedir12();
 }
 
 // src/cli/bridge-handlers.ts
@@ -10361,11 +10805,11 @@ 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 backupDir = join18(targetDir, "zam-backups");
+  mkdirSync12(backupDir, { recursive: true });
   const stamp = manifest.createdAt.replace(/[:.]/g, "-");
-  const path = join16(backupDir, `zam-snapshot-${stamp}.sql`);
-  writeFileSync8(path, snapshot, "utf-8");
+  const path = join18(backupDir, `zam-snapshot-${stamp}.sql`);
+  writeFileSync10(path, snapshot, "utf-8");
   return {
     ok: true,
     path,
@@ -13050,9 +13494,9 @@ function getCurriculumProvider(id) {
 // src/cli/llm/vision.ts
 init_kernel();
 import { randomBytes } from "crypto";
-import { readFileSync as readFileSync12 } from "fs";
+import { readFileSync as readFileSync14 } from "fs";
 import { tmpdir as tmpdir2 } from "os";
-import { basename as basename4, join as join17 } from "path";
+import { basename as basename4, join as join19 } from "path";
 var LANGUAGE_NAMES2 = {
   en: "English",
   de: "German",
@@ -13088,13 +13532,13 @@ async function observeUiSnapshotViaLLM(db, input8) {
   const imageUrls = [];
   const isVideo = /\.(mp4|mov|m4v|avi|mkv|webm)$/i.test(input8.imagePath);
   if (isVideo) {
-    const { mkdirSync: mkdirSync16, readdirSync: readdirSync3, rmSync: rmSync4 } = await import("fs");
+    const { mkdirSync: mkdirSync18, readdirSync: readdirSync3, rmSync: rmSync4 } = await import("fs");
     const { execSync: execSync6 } = await import("child_process");
-    const tempDir = join17(
+    const tempDir = join19(
       tmpdir2(),
       `zam-frames-${randomBytes(4).toString("hex")}`
     );
-    mkdirSync16(tempDir, { recursive: true });
+    mkdirSync18(tempDir, { recursive: true });
     try {
       execSync6(
         `ffmpeg -i "${input8.imagePath}" -vf "fps=1/3,scale=1280:-1" -vsync vfr "${tempDir}/frame_%03d.png"`,
@@ -13123,7 +13567,7 @@ async function observeUiSnapshotViaLLM(db, input8) {
         }
       }
       for (const file of sampledFiles) {
-        const bytes = readFileSync12(join17(tempDir, file));
+        const bytes = readFileSync14(join19(tempDir, file));
         imageUrls.push(`data:image/png;base64,${bytes.toString("base64")}`);
       }
     } finally {
@@ -13133,7 +13577,7 @@ async function observeUiSnapshotViaLLM(db, input8) {
       }
     }
   } else {
-    const imageBytes = readFileSync12(input8.imagePath);
+    const imageBytes = readFileSync14(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")}`);
@@ -13602,36 +14046,36 @@ async function withProviderScope(machine, action) {
 
 // src/cli/provisioning/index.ts
 import {
-  existsSync as existsSync16,
-  lstatSync,
-  mkdirSync as mkdirSync11,
-  readFileSync as readFileSync13,
+  existsSync as existsSync18,
+  lstatSync as lstatSync2,
+  mkdirSync as mkdirSync13,
+  readFileSync as readFileSync15,
   realpathSync,
   rmSync as rmSync2,
   symlinkSync,
-  writeFileSync as writeFileSync9
+  writeFileSync as writeFileSync11
 } from "fs";
-import { basename as basename5, dirname as dirname7, join as join18 } from "path";
-import { fileURLToPath as fileURLToPath3 } from "url";
-var packageRoot = [
-  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));
+import { basename as basename5, dirname as dirname9, join as join20 } from "path";
+import { fileURLToPath as fileURLToPath5 } from "url";
+var packageRoot3 = [
+  fileURLToPath5(new URL("../..", import.meta.url)),
+  fileURLToPath5(new URL("../../..", import.meta.url))
+].find((candidate) => existsSync18(join20(candidate, "package.json"))) ?? fileURLToPath5(new URL("../..", import.meta.url));
 var ALL_SETUP_AGENTS = ["claude", "copilot", "codex", "agent"];
 var SKILL_PAIRS = [
   {
-    from: join18(packageRoot, ".claude", "skills", "zam", "SKILL.md"),
-    to: join18(".claude", "skills", "zam", "SKILL.md"),
+    from: join20(packageRoot3, ".claude", "skills", "zam", "SKILL.md"),
+    to: join20(".claude", "skills", "zam", "SKILL.md"),
     agents: ["claude", "copilot"]
   },
   {
-    from: join18(packageRoot, ".agent", "skills", "zam", "SKILL.md"),
-    to: join18(".agent", "skills", "zam", "SKILL.md"),
+    from: join20(packageRoot3, ".agent", "skills", "zam", "SKILL.md"),
+    to: join20(".agent", "skills", "zam", "SKILL.md"),
     agents: ["agent"]
   },
   {
-    from: join18(packageRoot, ".agents", "skills", "zam", "SKILL.md"),
-    to: join18(".agents", "skills", "zam", "SKILL.md"),
+    from: join20(packageRoot3, ".agents", "skills", "zam", "SKILL.md"),
+    to: join20(".agents", "skills", "zam", "SKILL.md"),
     agents: ["codex"]
   }
 ];
@@ -13661,7 +14105,7 @@ function parseSetupAgents(value) {
 }
 function pathExists(path) {
   try {
-    lstatSync(path);
+    lstatSync2(path);
     return true;
   } catch {
     return false;
@@ -13669,7 +14113,7 @@ function pathExists(path) {
 }
 function isSymbolicLink(path) {
   try {
-    return lstatSync(path).isSymbolicLink();
+    return lstatSync2(path).isSymbolicLink();
   } catch {
     return false;
   }
@@ -13690,16 +14134,16 @@ function linkPointsTo(sourceDir, destinationDir) {
 }
 function isZamSkillCopy(destinationDir) {
   try {
-    if (!lstatSync(destinationDir).isDirectory()) return false;
-    const skillFile = join18(destinationDir, "SKILL.md");
-    if (!existsSync16(skillFile)) return false;
-    return /^name:\s*zam\s*$/m.test(readFileSync13(skillFile, "utf8"));
+    if (!lstatSync2(destinationDir).isDirectory()) return false;
+    const skillFile = join20(destinationDir, "SKILL.md");
+    if (!existsSync18(skillFile)) return false;
+    return /^name:\s*zam\s*$/m.test(readFileSync15(skillFile, "utf8"));
   } catch {
     return false;
   }
 }
 function classifySkillDestination(sourceDir, destinationDir) {
-  if (!existsSync16(sourceDir)) return "source-missing";
+  if (!existsSync18(sourceDir)) return "source-missing";
   if (!isSymbolicLink(destinationDir) && pathsResolveToSameDirectory(sourceDir, destinationDir)) {
     return "source-directory";
   }
@@ -13716,9 +14160,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 = dirname7(from);
-    const destinationDir = dirname7(join18(cwd, to));
-    const label = dirname7(to);
+    const sourceDir = dirname9(from);
+    const destinationDir = dirname9(join20(cwd, to));
+    const label = dirname9(to);
     const state = classifySkillDestination(sourceDir, destinationDir);
     if (state === "source-missing") {
       if (!opts.quiet) {
@@ -13775,7 +14219,7 @@ function wireSkills(cwd = process.cwd(), agents = parseSetupAgents(), opts = {})
       if (destinationExists) {
         rmSync2(destinationDir, { recursive: true, force: true });
       }
-      mkdirSync11(dirname7(destinationDir), { recursive: true });
+      mkdirSync13(dirname9(destinationDir), { recursive: true });
       symlinkSync(
         sourceDir,
         destinationDir,
@@ -13791,8 +14235,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 = dirname7(from);
-    const destinationDir = dirname7(join18(cwd, to));
+    const sourceDir = dirname9(from);
+    const destinationDir = dirname9(join20(cwd, to));
     results.push({
       agents: pairAgents,
       source: sourceDir,
@@ -13818,15 +14262,15 @@ function upsertMarkedBlock(dest, blockBody, dryRun) {
   const block = `${ZAM_BLOCK_START}
 ${blockBody.trim()}
 ${ZAM_BLOCK_END}`;
-  if (!existsSync16(dest)) {
+  if (!existsSync18(dest)) {
     if (!dryRun) {
-      mkdirSync11(dirname7(dest), { recursive: true });
-      writeFileSync9(dest, `${block}
+      mkdirSync13(dirname9(dest), { recursive: true });
+      writeFileSync11(dest, `${block}
 `, "utf8");
     }
     return "write";
   }
-  const existing = readFileSync13(dest, "utf8");
+  const existing = readFileSync15(dest, "utf8");
   if (existing.includes(block)) return "skip";
   const start = existing.indexOf(ZAM_BLOCK_START);
   const end = existing.indexOf(ZAM_BLOCK_END);
@@ -13834,7 +14278,7 @@ ${ZAM_BLOCK_END}`;
 
 ${block}
 `;
-  if (!dryRun) writeFileSync9(dest, next, "utf8");
+  if (!dryRun) writeFileSync11(dest, next, "utf8");
   return start >= 0 && end > start ? "update" : "write";
 }
 function logInstructionAction(action, label, dryRun) {
@@ -13846,8 +14290,8 @@ function logInstructionAction(action, label, dryRun) {
 }
 function writeClaudeMd(skipClaudeMd, cwd = process.cwd(), opts = {}) {
   if (skipClaudeMd) return;
-  const dest = join18(cwd, "CLAUDE.md");
-  if (existsSync16(dest)) {
+  const dest = join20(cwd, "CLAUDE.md");
+  if (existsSync18(dest)) {
     if (!opts.updateExisting) {
       console.log(`  skip  CLAUDE.md (already present)`);
       return;
@@ -13890,14 +14334,14 @@ Use \`zam connector setup turso\` to store cloud credentials in
   if (opts.dryRun) {
     console.log(`  would write CLAUDE.md`);
   } else {
-    writeFileSync9(dest, content, "utf8");
+    writeFileSync11(dest, content, "utf8");
     console.log(`  write CLAUDE.md`);
   }
 }
 function writeAgentsMd(skipAgentsMd, cwd = process.cwd(), opts = {}) {
   if (skipAgentsMd) return;
-  const dest = join18(cwd, "AGENTS.md");
-  if (existsSync16(dest)) {
+  const dest = join20(cwd, "AGENTS.md");
+  if (existsSync18(dest)) {
     if (!opts.updateExisting) {
       console.log(`  skip  AGENTS.md (already present)`);
       return;
@@ -13947,12 +14391,12 @@ Codex discovers repository skills under \`.agents/skills/\`. Run
   if (opts.dryRun) {
     console.log(`  would write AGENTS.md`);
   } else {
-    writeFileSync9(dest, content, "utf8");
+    writeFileSync11(dest, content, "utf8");
     console.log(`  write AGENTS.md`);
   }
 }
 function writeCopilotInstructions(cwd = process.cwd(), opts = {}) {
-  const dest = join18(cwd, ".github", "copilot-instructions.md");
+  const dest = join20(cwd, ".github", "copilot-instructions.md");
   const action = upsertMarkedBlock(
     dest,
     `## ZAM learning sessions
@@ -13993,13 +14437,13 @@ async function resolveUser(opts, db, resolveOpts) {
 }
 
 // src/cli/workspaces/backup.ts
-import { mkdirSync as mkdirSync12 } from "fs";
-import { join as join19 } from "path";
+import { mkdirSync as mkdirSync14 } from "fs";
+import { join as join21 } from "path";
 async function backupDatabaseTo(db, targetDir) {
-  const backupDir = join19(targetDir, "zam-backups");
-  mkdirSync12(backupDir, { recursive: true });
+  const backupDir = join21(targetDir, "zam-backups");
+  mkdirSync14(backupDir, { recursive: true });
   const stamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
-  const dest = join19(backupDir, `zam-${stamp}.db`);
+  const dest = join21(backupDir, `zam-${stamp}.db`);
   await db.exec(`VACUUM INTO '${dest.replace(/'/g, "''")}'`);
   return dest;
 }
@@ -14130,20 +14574,20 @@ bridgeCommand.command("workspace-info").description("Report the workspace dir, i
       activeWorkspace,
       workspaceDir: activeWorkspace.path,
       defaultWorkspaceDir: defaultWorkspaceDir(),
-      dataDir: join20(homedir11(), ".zam")
+      dataDir: join22(homedir13(), ".zam")
     });
   });
 });
 function provisionConfiguredWorkspaces() {
   return getConfiguredWorkspaces().flatMap(
-    (workspace) => existsSync17(workspace.path) ? wireSkills(workspace.path, parseSetupAgents(), { quiet: true }) : []
+    (workspace) => existsSync19(workspace.path) ? wireSkills(workspace.path, parseSetupAgents(), { quiet: true }) : []
   );
 }
 function buildWorkspaceLinkHealth(workspaces) {
   const agents = parseSetupAgents();
   const map = {};
   for (const workspace of workspaces) {
-    if (!existsSync17(workspace.path)) continue;
+    if (!existsSync19(workspace.path)) continue;
     const links = inspectSkillLinks(workspace.path, agents);
     map[workspace.id] = {
       health: summarizeSkillLinkHealth(links),
@@ -14173,7 +14617,7 @@ bridgeCommand.command("workspace-list").description("List configured ZAM workspa
       activeWorkspace,
       workspaceDir: activeWorkspace.path,
       defaultWorkspaceDir: defaultWorkspaceDir(),
-      dataDir: join20(homedir11(), ".zam"),
+      dataDir: join22(homedir13(), ".zam"),
       linkHealth: buildWorkspaceLinkHealth(workspaces)
     });
   });
@@ -14188,7 +14632,7 @@ bridgeCommand.command("workspace-repair-links").description(
   if (!id) jsonError("A non-empty --id is required");
   const workspace = getConfiguredWorkspaces().find((item) => item.id === id);
   if (!workspace) jsonError(`Workspace "${id}" is not configured`);
-  if (!existsSync17(workspace.path)) {
+  if (!existsSync19(workspace.path)) {
     jsonError(`Workspace path does not exist: ${workspace.path}`);
   }
   const agents = parseSetupAgents(opts.agents);
@@ -14219,8 +14663,8 @@ function parseBridgeWorkspaceKind(value) {
 bridgeCommand.command("workspace-add").description("Register an existing directory as a ZAM workspace (JSON)").requiredOption("--path <dir>", "Existing workspace/repository directory").option("--id <id>", "Workspace id").option("--label <label>", "Human-readable label").option("--kind <kind>", "Workspace kind", "custom").action(async (opts) => {
   const raw = String(opts.path ?? "").trim();
   if (!raw) jsonError("A non-empty --path is required");
-  const path = resolve4(raw);
-  if (!existsSync17(path)) jsonError(`Workspace path does not exist: ${path}`);
+  const path = resolve5(raw);
+  if (!existsSync19(path)) jsonError(`Workspace path does not exist: ${path}`);
   const id = opts.id ? String(opts.id).trim() : void 0;
   if (opts.id && !id) jsonError("A non-empty --id is required");
   const kind = parseBridgeWorkspaceKind(opts.kind);
@@ -14264,8 +14708,8 @@ bridgeCommand.command("workspace-remove").description("Unregister a ZAM workspac
 bridgeCommand.command("set-workspace-dir").description("Set the personal workspace directory (JSON)").requiredOption("--dir <path>", "Path to the workspace directory").action(async (opts) => {
   const raw = String(opts.dir ?? "").trim();
   if (!raw) jsonError("A non-empty --dir is required");
-  const dir = resolve4(raw);
-  if (!existsSync17(dir)) jsonError(`Workspace path does not exist: ${dir}`);
+  const dir = resolve5(raw);
+  if (!existsSync19(dir)) jsonError(`Workspace path does not exist: ${dir}`);
   const skillLinks = wireSkills(dir, parseSetupAgents(), { quiet: true });
   await withDb2(async (db) => {
     const workspace = await activateWorkspacePath(db, dir);
@@ -14328,7 +14772,7 @@ bridgeCommand.command("agent-open").description("Launch an agent harness in the
       jsonError(`Workspace is not configured: ${opts.workspace}`);
     }
     const activeWorkspace = await ensureActiveWorkspace(db);
-    const workspace = opts.dir ? existsSync17(opts.dir) ? opts.dir : homedir11() : existingWorkspaceDirOrHome(configuredWorkspace ?? activeWorkspace);
+    const workspace = opts.dir ? existsSync19(opts.dir) ? opts.dir : homedir13() : existingWorkspaceDirOrHome(configuredWorkspace ?? activeWorkspace);
     launchHarness(harness, {
       executable,
       workspace,
@@ -14700,7 +15144,7 @@ bridgeCommand.command("discover-skills").description(
   "20"
 ).action(async (opts) => {
   try {
-    const monitorDir = join20(homedir11(), ".zam", "monitor");
+    const monitorDir = join22(homedir13(), ".zam", "monitor");
     let files;
     try {
       files = readdirSync2(monitorDir).filter((f) => f.endsWith(".jsonl"));
@@ -14713,7 +15157,7 @@ bridgeCommand.command("discover-skills").description(
       return;
     }
     const limit = Number(opts.limit);
-    const sorted = files.map((f) => ({ name: f, path: join20(monitorDir, f) })).sort((a, b) => b.name.localeCompare(a.name)).slice(0, limit);
+    const sorted = files.map((f) => ({ name: f, path: join22(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", "");
@@ -14825,7 +15269,7 @@ bridgeCommand.command("observe-ui-snapshot").description(
 });
 function resolveWindowsPowerShell() {
   try {
-    execFileSync3("where.exe", ["pwsh.exe"], { stdio: "ignore" });
+    execFileSync4("where.exe", ["pwsh.exe"], { stdio: "ignore" });
     return "pwsh";
   } catch {
     return "powershell";
@@ -14840,7 +15284,7 @@ function captureScreenshot(outputPath, hwnd, processName) {
     throw new Error(`Invalid process name format: ${processName}`);
   }
   if (platform === "win32") {
-    const stdout = execFileSync3(
+    const stdout = execFileSync4(
       resolveWindowsPowerShell(),
       [
         "-NoProfile",
@@ -15153,13 +15597,13 @@ Write-CaptureResult "fullscreen" $hwndVal $matchedBy
   } else if (platform === "darwin") {
     if (hwnd) {
       const parsedHwnd = hwnd.startsWith("0x") ? parseInt(hwnd, 16) : parseInt(hwnd, 10);
-      execFileSync3("screencapture", ["-l", String(parsedHwnd), outputPath], {
+      execFileSync4("screencapture", ["-l", String(parsedHwnd), outputPath], {
         stdio: "pipe"
       });
       return { method: "screencapture-window", target: null };
     } else if (processName) {
       try {
-        const windowId = execFileSync3(
+        const windowId = execFileSync4(
           "osascript",
           [
             "-e",
@@ -15168,17 +15612,17 @@ Write-CaptureResult "fullscreen" $hwndVal $matchedBy
           { encoding: "utf8", stdio: ["pipe", "pipe", "ignore"] }
         ).trim();
         if (windowId && /^\d+$/.test(windowId)) {
-          execFileSync3("screencapture", ["-l", windowId, outputPath], {
+          execFileSync4("screencapture", ["-l", windowId, outputPath], {
             stdio: "pipe"
           });
           return { method: "screencapture-window", target: null };
         }
       } catch {
       }
-      execFileSync3("screencapture", ["-x", outputPath], { stdio: "pipe" });
+      execFileSync4("screencapture", ["-x", outputPath], { stdio: "pipe" });
       return { method: "screencapture-full", target: null };
     } else {
-      execFileSync3("screencapture", ["-x", outputPath], { stdio: "pipe" });
+      execFileSync4("screencapture", ["-x", outputPath], { stdio: "pipe" });
       return { method: "screencapture-full", target: null };
     }
   } else {
@@ -15215,7 +15659,7 @@ bridgeCommand.command("capture-ui").description("Capture a screenshot for agent-
         return;
       }
     }
-    const outputPath = opts.image ?? opts.output ?? join20(tmpdir3(), `zam-capture-${randomBytes2(4).toString("hex")}.png`);
+    const outputPath = opts.image ?? opts.output ?? join22(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, {
@@ -15243,7 +15687,7 @@ bridgeCommand.command("capture-ui").description("Capture a screenshot for agent-
         return;
       }
     }
-    const imageBytes = readFileSync14(outputPath);
+    const imageBytes = readFileSync16(outputPath);
     const base64 = imageBytes.toString("base64");
     jsonOut2({
       sessionId: opts.session ?? null,
@@ -15270,11 +15714,11 @@ bridgeCommand.command("start-recording").description("Start screen recording in
     return;
   }
   const sessionId = opts.session;
-  const statePath = join20(tmpdir3(), `zam-recording-${sessionId}.json`);
+  const statePath = join22(tmpdir3(), `zam-recording-${sessionId}.json`);
   const defaultExt = platform === "win32" ? ".mkv" : ".mov";
-  const outputPath = opts.output ?? join20(tmpdir3(), `zam-recording-${sessionId}${defaultExt}`);
-  const { existsSync: existsSync26, writeFileSync: writeFileSync14, openSync, closeSync } = await import("fs");
-  if (existsSync26(statePath)) {
+  const outputPath = opts.output ?? join22(tmpdir3(), `zam-recording-${sessionId}${defaultExt}`);
+  const { existsSync: existsSync28, writeFileSync: writeFileSync16, openSync, closeSync } = await import("fs");
+  if (existsSync28(statePath)) {
     jsonOut2({
       sessionId,
       started: false,
@@ -15282,7 +15726,7 @@ bridgeCommand.command("start-recording").description("Start screen recording in
     });
     return;
   }
-  const logPath = join20(tmpdir3(), `zam-recording-${sessionId}.log`);
+  const logPath = join22(tmpdir3(), `zam-recording-${sessionId}.log`);
   let logFd;
   try {
     logFd = openSync(logPath, "w");
@@ -15328,7 +15772,7 @@ bridgeCommand.command("start-recording").description("Start screen recording in
   }
   child.unref();
   if (child.pid) {
-    writeFileSync14(
+    writeFileSync16(
       statePath,
       JSON.stringify({
         pid: child.pid,
@@ -15364,9 +15808,9 @@ bridgeCommand.command("stop-recording").description(
     return;
   }
   const sessionId = opts.session;
-  const statePath = join20(tmpdir3(), `zam-recording-${sessionId}.json`);
-  const { existsSync: existsSync26, readFileSync: readFileSync19, rmSync: rmSync4 } = await import("fs");
-  if (!existsSync26(statePath)) {
+  const statePath = join22(tmpdir3(), `zam-recording-${sessionId}.json`);
+  const { existsSync: existsSync28, readFileSync: readFileSync21, rmSync: rmSync4 } = await import("fs");
+  if (!existsSync28(statePath)) {
     jsonOut2({
       sessionId,
       stopped: false,
@@ -15374,7 +15818,7 @@ bridgeCommand.command("stop-recording").description(
     });
     return;
   }
-  const state = JSON.parse(readFileSync19(statePath, "utf8"));
+  const state = JSON.parse(readFileSync21(statePath, "utf8"));
   const { pid, outputPath } = state;
   try {
     process.kill(pid, "SIGINT");
@@ -15390,7 +15834,7 @@ bridgeCommand.command("stop-recording").description(
   };
   let attempts = 0;
   while (isProcessRunning(pid) && attempts < 20) {
-    await new Promise((resolve10) => setTimeout(resolve10, 250));
+    await new Promise((resolve11) => setTimeout(resolve11, 250));
     attempts++;
   }
   if (isProcessRunning(pid)) {
@@ -15403,7 +15847,7 @@ bridgeCommand.command("stop-recording").description(
     rmSync4(statePath, { force: true });
   } catch {
   }
-  if (!existsSync26(outputPath)) {
+  if (!existsSync28(outputPath)) {
     jsonOut2({
       sessionId,
       stopped: false,
@@ -15640,7 +16084,7 @@ bridgeCommand.command("cloud-model-hint").description("Suggest a cloud model for
 });
 bridgeCommand.command("local-llm-hints").description("Detect installed local LLM servers and suggest defaults (JSON)").action(() => {
   const profile = getSystemProfile();
-  const flmInstalled = hasCommand("flm") || existsSync17("C:\\Program Files\\flm\\flm.exe");
+  const flmInstalled = hasCommand("flm") || existsSync19("C:\\Program Files\\flm\\flm.exe");
   const ollamaInstalled = isOllamaInstalled();
   const runners = [
     { id: "flm", label: "FastFlowLM", installed: flmInstalled },
@@ -18190,26 +18634,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 writeFileSync10 } from "fs";
-import { join as join21 } from "path";
+import { chmodSync as chmodSync2, existsSync as existsSync20, writeFileSync as writeFileSync12 } from "fs";
+import { join as join23 } from "path";
 import { Command as Command6 } from "commander";
 function installHook2() {
-  const gitDir = join21(process.cwd(), ".git");
-  if (!existsSync18(gitDir)) {
+  const gitDir = join23(process.cwd(), ".git");
+  if (!existsSync20(gitDir)) {
     console.error(
       "Error: Current directory is not the root of a Git repository."
     );
     process.exit(1);
   }
-  const hooksDir = join21(gitDir, "hooks");
-  const hookPath = join21(hooksDir, "post-commit");
+  const hooksDir = join23(gitDir, "hooks");
+  const hookPath = join23(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 {
-    writeFileSync10(hookPath, hookContent, { encoding: "utf-8", flag: "w" });
+    writeFileSync12(hookPath, hookContent, { encoding: "utf-8", flag: "w" });
     try {
       chmodSync2(hookPath, "755");
     } catch (_e) {
@@ -18312,8 +18756,8 @@ ZAM Auto-Stale Complete: Scanned ${changedFiles.length} file(s).`
 
 // src/cli/commands/goal.ts
 init_kernel();
-import { existsSync as existsSync19, mkdirSync as mkdirSync13 } from "fs";
-import { resolve as resolve5 } from "path";
+import { existsSync as existsSync21, mkdirSync as mkdirSync15 } from "fs";
+import { resolve as resolve6 } from "path";
 import { input as input2 } from "@inquirer/prompts";
 import { Command as Command7 } from "commander";
 async function resolveGoalsDir() {
@@ -18326,7 +18770,7 @@ async function resolveGoalsDir() {
   } finally {
     await db?.close();
   }
-  return goalsDir ? resolve5(goalsDir) : resolve5("goals");
+  return goalsDir ? resolve6(goalsDir) : resolve6("goals");
 }
 var goalCommand = new Command7("goal").description(
   "Manage learning goals (markdown files)"
@@ -18336,7 +18780,7 @@ goalCommand.command("list").description("List all goals").option(
   "Filter by status (active, completed, paused, abandoned)"
 ).option("--tree", "Show goals as a tree with parent/child relationships").option("--json", "Output as JSON").action(async (opts) => {
   const goalsDir = await resolveGoalsDir();
-  if (!existsSync19(goalsDir)) {
+  if (!existsSync21(goalsDir)) {
     console.error(`Goals directory not found: ${goalsDir}`);
     console.error(
       "Set it with: zam settings set personal.goals_dir /path/to/goals"
@@ -18437,8 +18881,8 @@ ${"\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)) {
-    mkdirSync13(goalsDir, { recursive: true });
+  if (!existsSync21(goalsDir)) {
+    mkdirSync15(goalsDir, { recursive: true });
   }
   let slug = opts.slug;
   let title = opts.title;
@@ -18498,22 +18942,22 @@ goalCommand.command("status <slug> <status>").description("Update a goal's statu
 
 // src/cli/commands/init.ts
 init_kernel();
-import { existsSync as existsSync20, mkdirSync as mkdirSync14, writeFileSync as writeFileSync11 } from "fs";
-import { homedir as homedir12 } from "os";
-import { join as join22, resolve as resolve6 } from "path";
+import { existsSync as existsSync22, mkdirSync as mkdirSync16, writeFileSync as writeFileSync13 } from "fs";
+import { homedir as homedir14 } from "os";
+import { join as join24, resolve as resolve7 } from "path";
 import { confirm, input as input3 } from "@inquirer/prompts";
 import { Command as Command8 } from "commander";
-var HOME2 = homedir12();
+var HOME2 = homedir14();
 function printLine(char = "\u2550", len = 60, color = "\x1B[36m") {
   console.log(`${color}${char.repeat(len)}\x1B[0m`);
 }
 function bootstrapSandboxWorkspace(workspaceDir) {
-  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)) {
-    writeFileSync11(
+  mkdirSync16(join24(workspaceDir, "beliefs"), { recursive: true });
+  mkdirSync16(join24(workspaceDir, "goals"), { recursive: true });
+  mkdirSync16(join24(workspaceDir, "skills"), { recursive: true });
+  const worldviewFile = join24(workspaceDir, "beliefs", "worldview.md");
+  if (!existsSync22(worldviewFile)) {
+    writeFileSync13(
       worldviewFile,
       `# Personal Worldview
 
@@ -18525,9 +18969,9 @@ Here, I declare the core concepts and principles I want to master.
       "utf8"
     );
   }
-  const goalsFile = join22(workspaceDir, "goals", "goals.md");
-  if (!existsSync20(goalsFile)) {
-    writeFileSync11(
+  const goalsFile = join24(workspaceDir, "goals", "goals.md");
+  if (!existsSync22(goalsFile)) {
+    writeFileSync13(
       goalsFile,
       `# Personal Goals
 
@@ -18549,8 +18993,8 @@ 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 = join22(HOME2, "Documents", "zam");
-  const workspacePath = resolve6(
+  const defaultWorkspace = join24(HOME2, "Documents", "zam");
+  const workspacePath = resolve7(
     await input3({
       message: "Choose your ZAM workspace directory:",
       default: defaultWorkspace
@@ -19751,7 +20195,7 @@ observerCommand.command("revoke <process>").description("Remove a process from o
 
 // src/cli/commands/profile.ts
 init_kernel();
-import { dirname as dirname8, resolve as resolve7 } from "path";
+import { dirname as dirname10, resolve as resolve8 } from "path";
 import { Command as Command13 } from "commander";
 var C2 = {
   reset: "\x1B[0m",
@@ -19779,7 +20223,7 @@ var profileCommand = new Command13("profile").description("Show or change this m
     if (opts.mode) setInstallMode(opts.mode);
     db = await openDatabaseWithSync({ initialize: true });
     if (opts.dir) {
-      await activateWorkspacePath(db, resolve7(opts.dir), {
+      await activateWorkspacePath(db, resolve8(opts.dir), {
         kind: "personal",
         label: "Personal"
       });
@@ -19792,7 +20236,7 @@ var profileCommand = new Command13("profile").description("Show or change this m
       mode: getInstallMode(),
       personalDir,
       syncProvider: detectSyncProvider(personalDir),
-      dataDir: dirname8(dbPath),
+      dataDir: dirname10(dbPath),
       dbPath
     };
     if (opts.json) {
@@ -20181,7 +20625,7 @@ ${"\u2550".repeat(50)}`);
 
 // src/cli/commands/session.ts
 init_kernel();
-import { readFileSync as readFileSync15 } from "fs";
+import { readFileSync as readFileSync17 } from "fs";
 import { input as input6, select as select2 } from "@inquirer/prompts";
 import { Command as Command16 } from "commander";
 var sessionCommand = new Command16("session").description(
@@ -20372,7 +20816,7 @@ function loadPatternFile(path) {
   if (!path) return [];
   let parsed;
   try {
-    parsed = JSON.parse(readFileSync15(path, "utf-8"));
+    parsed = JSON.parse(readFileSync17(path, "utf-8"));
   } catch (err) {
     throw new Error(
       `Cannot read synthesis patterns from ${path}: ${err.message}`
@@ -20563,7 +21007,7 @@ sessionCommand.command("end").description("End a session and show summary").requ
 
 // src/cli/commands/settings.ts
 init_kernel();
-import { existsSync as existsSync21 } from "fs";
+import { existsSync as existsSync23 } from "fs";
 import { Command as Command17 } from "commander";
 var settingsCommand = new Command17("settings").description(
   "Manage user settings"
@@ -20728,7 +21172,7 @@ settingsCommand.command("repos").description("Show or set Personal, Team, and Or
     console.log("\nValidation:");
     for (const [name, path] of Object.entries(paths)) {
       if (path) {
-        const exists = existsSync21(path);
+        const exists = existsSync23(path);
         console.log(
           `  ${name.padEnd(9)}: ${exists ? "\x1B[32m\u2713 Valid folder\x1B[0m" : "\x1B[31m\u2717 Directory does not exist\x1B[0m"}`
         );
@@ -20741,7 +21185,7 @@ settingsCommand.command("repos").description("Show or set Personal, Team, and Or
 
 // src/cli/commands/setup.ts
 init_kernel();
-import { resolve as resolve8 } from "path";
+import { resolve as resolve9 } from "path";
 import { Command as Command18 } from "commander";
 function formatDatabaseInitTarget(target) {
   switch (target.kind) {
@@ -20801,7 +21245,7 @@ var setupCommand = new Command18("setup").description(
       console.error(`Error: ${err.message}`);
       process.exit(1);
     }
-    const target = resolve8(opts.target ?? process.cwd());
+    const target = resolve9(opts.target ?? process.cwd());
     const updateExistingInstructions = Boolean(opts.target) || opts.force;
     console.log(
       `Setting up ZAM in ${target}${opts.dryRun ? " (dry run)" : ""}
@@ -20925,8 +21369,8 @@ skillCommand.command("add").description("Register a new agent skill").requiredOp
 
 // src/cli/commands/snapshot.ts
 init_kernel();
-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 { existsSync as existsSync24, mkdirSync as mkdirSync17, readFileSync as readFileSync18, writeFileSync as writeFileSync14 } from "fs";
+import { dirname as dirname11, join as join25 } from "path";
 import { Command as Command20 } from "commander";
 function defaultOutName() {
   const stamp = (/* @__PURE__ */ new Date()).toISOString().replace(/\.\d+Z$/, "").replace(/:/g, "-");
@@ -20955,12 +21399,12 @@ var exportCmd = new Command20("export").description("Write a portable SQL-text s
       process.stdout.write(snapshot);
       return;
     }
-    const out = opts.out ?? join23(personalDir, "snapshots", defaultOutName());
-    const dir = dirname9(out);
-    if (dir && dir !== "." && !existsSync22(dir)) {
-      mkdirSync15(dir, { recursive: true });
+    const out = opts.out ?? join25(personalDir, "snapshots", defaultOutName());
+    const dir = dirname11(out);
+    if (dir && dir !== "." && !existsSync24(dir)) {
+      mkdirSync17(dir, { recursive: true });
     }
-    writeFileSync12(out, snapshot, "utf-8");
+    writeFileSync14(out, snapshot, "utf-8");
     console.log(`Snapshot written: ${out}`);
     console.log(
       `  ${total} row(s)${nonEmpty.length ? ` \u2014 ${nonEmpty.join(", ")}` : ""}`
@@ -20974,11 +21418,11 @@ var exportCmd = new Command20("export").description("Write a portable SQL-text s
 var importCmd = new Command20("import").description("Restore a snapshot into the database").argument("<file>", "Snapshot file to restore").option("--force", "Overwrite a non-empty database", false).action(async (file, opts) => {
   let db;
   try {
-    if (!existsSync22(file)) {
+    if (!existsSync24(file)) {
       console.error(`Error: Snapshot file not found: ${file}`);
       process.exit(1);
     }
-    const snapshot = readFileSync16(file, "utf-8");
+    const snapshot = readFileSync18(file, "utf-8");
     db = await openDatabaseWithSync({ initialize: true });
     const result = await importSnapshot(db, snapshot, { force: opts.force });
     await db.close();
@@ -20996,11 +21440,11 @@ var importCmd = new Command20("import").description("Restore a snapshot into the
 });
 var verifyCmd = new Command20("verify").description("Check a snapshot's manifest and checksum without importing").argument("<file>", "Snapshot file to verify").action((file) => {
   try {
-    if (!existsSync22(file)) {
+    if (!existsSync24(file)) {
       console.error(`Error: Snapshot file not found: ${file}`);
       process.exit(1);
     }
-    const manifest = verifySnapshot(readFileSync16(file, "utf-8"));
+    const manifest = verifySnapshot(readFileSync18(file, "utf-8"));
     const { total, nonEmpty } = summarize(manifest.tables);
     console.log(`Valid snapshot (format v${manifest.version})`);
     console.log(`  created: ${manifest.createdAt}`);
@@ -21549,10 +21993,10 @@ tokenCommand.command("reembed").description("Backfill or refresh semantic-search
 // src/cli/commands/ui.ts
 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 dirname10, join as join24 } from "path";
-import { fileURLToPath as fileURLToPath4 } from "url";
+import { existsSync as existsSync25 } from "fs";
+import { homedir as homedir15 } from "os";
+import { dirname as dirname12, join as join26 } from "path";
+import { fileURLToPath as fileURLToPath6 } from "url";
 import { Command as Command23 } from "commander";
 var C3 = {
   reset: "\x1B[0m",
@@ -21563,14 +22007,14 @@ var C3 = {
   dim: "\x1B[2m"
 };
 function findDesktopDir() {
-  const starts = [process.cwd(), dirname10(fileURLToPath4(import.meta.url))];
+  const starts = [process.cwd(), dirname12(fileURLToPath6(import.meta.url))];
   for (const start of starts) {
     let dir = start;
     for (let i = 0; i < 10; i++) {
-      if (existsSync23(join24(dir, "desktop", "src-tauri", "tauri.conf.json"))) {
-        return join24(dir, "desktop");
+      if (existsSync25(join26(dir, "desktop", "src-tauri", "tauri.conf.json"))) {
+        return join26(dir, "desktop");
       }
-      const parent = dirname10(dir);
+      const parent = dirname12(dir);
       if (parent === dir) break;
       dir = parent;
     }
@@ -21578,30 +22022,30 @@ function findDesktopDir() {
   return null;
 }
 function findBuiltApp(desktopDir) {
-  const releaseDir = join24(desktopDir, "src-tauri", "target", "release");
+  const releaseDir = join26(desktopDir, "src-tauri", "target", "release");
   if (process.platform === "win32") {
     for (const name of ["ZAM.exe", "zam.exe", "zam-desktop.exe"]) {
-      const p = join24(releaseDir, name);
-      if (existsSync23(p)) return p;
+      const p = join26(releaseDir, name);
+      if (existsSync25(p)) return p;
     }
   } else if (process.platform === "darwin") {
-    const app = join24(releaseDir, "bundle", "macos", "ZAM.app");
-    if (existsSync23(app)) return app;
+    const app = join26(releaseDir, "bundle", "macos", "ZAM.app");
+    if (existsSync25(app)) return app;
   } else {
     for (const name of ["zam", "ZAM", "zam-desktop"]) {
-      const p = join24(releaseDir, name);
-      if (existsSync23(p)) return p;
+      const p = join26(releaseDir, name);
+      if (existsSync25(p)) return p;
     }
   }
   return null;
 }
 function findInstalledApp() {
   const candidates = process.platform === "win32" ? [
-    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;
+    process.env.LOCALAPPDATA && join26(process.env.LOCALAPPDATA, "Programs", "ZAM", "ZAM.exe"),
+    process.env.ProgramFiles && join26(process.env.ProgramFiles, "ZAM", "ZAM.exe"),
+    process.env["ProgramFiles(x86)"] && join26(process.env["ProgramFiles(x86)"], "ZAM", "ZAM.exe")
+  ] : process.platform === "darwin" ? ["/Applications/ZAM.app", join26(homedir15(), "Applications", "ZAM.app")] : ["/opt/ZAM/zam", "/usr/bin/zam-desktop"];
+  return candidates.find((candidate) => candidate && existsSync25(candidate)) || null;
 }
 function runNpm(args, opts) {
   const res = spawnSync("npm", args, {
@@ -21612,7 +22056,7 @@ function runNpm(args, opts) {
   return res.status ?? 1;
 }
 function ensureDesktopDeps(desktopDir) {
-  if (existsSync23(join24(desktopDir, "node_modules"))) return true;
+  if (existsSync25(join26(desktopDir, "node_modules"))) return true;
   console.log(
     `${C3.cyan}Installing desktop dependencies (one-time)...${C3.reset}`
   );
@@ -21638,13 +22082,13 @@ function requireRust() {
 function hasMsvcBuildTools() {
   if (process.platform !== "win32") return true;
   const pf86 = process.env["ProgramFiles(x86)"] || "C:\\Program Files (x86)";
-  const vswhere = join24(
+  const vswhere = join26(
     pf86,
     "Microsoft Visual Studio",
     "Installer",
     "vswhere.exe"
   );
-  if (!existsSync23(vswhere)) return false;
+  if (!existsSync25(vswhere)) return false;
   const res = spawnSync(
     vswhere,
     [
@@ -21676,7 +22120,7 @@ function requireMsvcOnWindows() {
   return false;
 }
 function warnIfCliMissing(repoRoot) {
-  if (!existsSync23(join24(repoRoot, "dist", "cli", "index.js"))) {
+  if (!existsSync25(join26(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}`
     );
@@ -21739,7 +22183,7 @@ var uiCommand = new Command23("ui").description("Launch the ZAM Desktop GUI (Act
 ).option("--shortcut", "Create Desktop + Start-menu shortcuts to the GUI").action((opts) => {
   const installedApp = findInstalledApp();
   if (!opts.dev && !opts.build && !opts.shortcut && installedApp) {
-    launchApp(installedApp, homedir13());
+    launchApp(installedApp, homedir15());
     return;
   }
   const desktopDir = findDesktopDir();
@@ -21749,7 +22193,7 @@ var uiCommand = new Command23("ui").description("Launch the ZAM Desktop GUI (Act
     );
     process.exit(1);
   }
-  const repoRoot = dirname10(desktopDir);
+  const repoRoot = dirname12(desktopDir);
   if (opts.build) {
     if (!requireRust()) process.exit(1);
     if (!requireMsvcOnWindows()) process.exit(1);
@@ -21760,7 +22204,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 = join24(
+      const bundle = join26(
         desktopDir,
         "src-tauri",
         "target",
@@ -21800,7 +22244,7 @@ ${C3.green}\u2713 Done. Installer is in:${C3.reset}
       );
       process.exit(1);
     }
-    createShortcuts(shortcutTarget, dirname10(shortcutTarget));
+    createShortcuts(shortcutTarget, dirname12(shortcutTarget));
     return;
   }
   if (builtApp) {
@@ -21838,9 +22282,9 @@ ${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 readFileSync17, realpathSync as realpathSync2 } from "fs";
-import { dirname as dirname11, join as join25 } from "path";
-import { fileURLToPath as fileURLToPath5 } from "url";
+import { existsSync as existsSync26, readFileSync as readFileSync19, realpathSync as realpathSync2 } from "fs";
+import { dirname as dirname13, join as join27 } from "path";
+import { fileURLToPath as fileURLToPath7 } from "url";
 import { confirm as confirm3 } from "@inquirer/prompts";
 import { Command as Command24 } from "commander";
 var CHANNELS = [
@@ -21861,7 +22305,7 @@ var C4 = {
 function versionAt(dir) {
   try {
     const pkg2 = JSON.parse(
-      readFileSync17(join25(dir, "package.json"), "utf-8")
+      readFileSync19(join27(dir, "package.json"), "utf-8")
     );
     return pkg2.version ?? "unknown";
   } catch {
@@ -21919,14 +22363,14 @@ var checkCmd = new Command24("check").description("Check whether a newer ZAM has
   }
 );
 function findSourceRepo() {
-  let dir = realpathSync2(dirname11(fileURLToPath5(import.meta.url)));
-  let parent = dirname11(dir);
+  let dir = realpathSync2(dirname13(fileURLToPath7(import.meta.url)));
+  let parent = dirname13(dir);
   while (parent !== dir) {
-    if (existsSync24(join25(dir, ".git"))) return dir;
+    if (existsSync26(join27(dir, ".git"))) return dir;
     dir = parent;
-    parent = dirname11(dir);
+    parent = dirname13(dir);
   }
-  return existsSync24(join25(dir, ".git")) ? dir : null;
+  return existsSync26(join27(dir, ".git")) ? dir : null;
 }
 function runGit(cwd, args, capture) {
   const res = spawnSync2("git", args, {
@@ -21947,7 +22391,7 @@ function runNpm2(args, cwd) {
 function smokeTestBuild(src) {
   const res = spawnSync2(
     process.execPath,
-    [join25(src, "dist", "cli", "index.js"), "--version"],
+    [join27(src, "dist", "cli", "index.js"), "--version"],
     {
       cwd: src,
       encoding: "utf8",
@@ -22027,7 +22471,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,
-    [join25(src, "dist", "cli", "index.js"), "setup", "--force"],
+    [join27(src, "dist", "cli", "index.js"), "setup", "--force"],
     { cwd: process.cwd(), stdio: "inherit" }
   );
   if (setup.status !== 0) {
@@ -22139,15 +22583,15 @@ 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 writeFileSync13 } from "fs";
-import { homedir as homedir14 } from "os";
-import { join as join26, resolve as resolve9 } from "path";
+import { execFileSync as execFileSync5 } from "child_process";
+import { existsSync as existsSync27, writeFileSync as writeFileSync15 } from "fs";
+import { homedir as homedir16 } from "os";
+import { join as join28, resolve as resolve10 } from "path";
 import { confirm as confirm4, input as input7 } from "@inquirer/prompts";
 import { Command as Command26 } from "commander";
 function runGit2(cwd, args) {
   try {
-    return execFileSync4("git", args, {
+    return execFileSync5("git", args, {
       cwd,
       stdio: "pipe",
       encoding: "utf8"
@@ -22226,7 +22670,7 @@ workspaceCommand.command("list").description("List configured ZAM workspaces").o
   const workspaces = getConfiguredWorkspaces();
   const agents = parseSetupAgents();
   const linkHealth = Object.fromEntries(
-    workspaces.filter((workspace) => existsSync25(workspace.path)).map((workspace) => [
+    workspaces.filter((workspace) => existsSync27(workspace.path)).map((workspace) => [
       workspace.id,
       summarizeSkillLinkHealth(inspectSkillLinks(workspace.path, agents))
     ])
@@ -22268,8 +22712,8 @@ workspaceCommand.command("add <id>").description("Register an existing directory
   `Source-control provider (${WORKSPACE_SOURCE_CONTROLS.join(" | ")})`
 ).option("--scopes <list>", "Comma-separated knowledge scopes").option("--default-agent <id>", "Default agent harness for this workspace").action((id, opts) => {
   try {
-    const path = resolve9(String(opts.path));
-    if (!existsSync25(path)) {
+    const path = resolve10(String(opts.path));
+    if (!existsSync27(path)) {
       console.error(`Workspace path does not exist: ${path}`);
       process.exit(1);
     }
@@ -22363,7 +22807,7 @@ workspaceCommand.command("publish").description("Publish your local workspace sa
     );
     process.exit(1);
   }
-  if (!existsSync25(workspaceDir)) {
+  if (!existsSync27(workspaceDir)) {
     console.error(
       `\x1B[31m\u2717 Workspace directory does not exist: ${workspaceDir}\x1B[0m`
     );
@@ -22377,15 +22821,15 @@ Active workspace: \x1B[36m${workspaceDir}\x1B[0m`);
     );
     process.exit(1);
   }
-  const gitignorePath = join26(workspaceDir, ".gitignore");
-  if (!existsSync25(gitignorePath)) {
-    writeFileSync13(
+  const gitignorePath = join28(workspaceDir, ".gitignore");
+  if (!existsSync27(gitignorePath)) {
+    writeFileSync15(
       gitignorePath,
       "node_modules/\n.agent/\n.agents/\n.claude/\n.gemini/\n.goose/\n*.log\n",
       "utf8"
     );
   }
-  const hasGitRepo = existsSync25(join26(workspaceDir, ".git"));
+  const hasGitRepo = existsSync27(join28(workspaceDir, ".git"));
   if (!hasGitRepo) {
     console.log("Initializing local Git repository...");
     runGit2(workspaceDir, ["init", "-b", "main"]);
@@ -22417,7 +22861,7 @@ Active workspace: \x1B[36m${workspaceDir}\x1B[0m`);
     if (proceedGh) {
       try {
         console.log(`Creating GitHub repository ${repoName}...`);
-        execFileSync4("gh", ghRepoCreateArgs(repoName, repoVisibility), {
+        execFileSync5("gh", ghRepoCreateArgs(repoName, repoVisibility), {
           cwd: workspaceDir,
           stdio: "inherit"
         });
@@ -22472,7 +22916,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 = join26(homedir14(), ".zam");
+  const dir = join28(homedir16(), ".zam");
   console.log(opts.json ? JSON.stringify({ dataDir: dir }) : dir);
 });
 workspaceCommand.command("backup").description("Back up the local ZAM database into your workspace").option(
@@ -22513,9 +22957,9 @@ workspaceCommand.command("backup").description("Back up the local ZAM database i
 });
 
 // src/cli/app.ts
-var __dirname = dirname12(fileURLToPath6(import.meta.url));
+var __dirname = dirname14(fileURLToPath8(import.meta.url));
 var pkg = JSON.parse(
-  readFileSync18(join27(__dirname, "..", "..", "package.json"), "utf-8")
+  readFileSync20(join29(__dirname, "..", "..", "package.json"), "utf-8")
 );
 var program = new Command27();
 program.name("zam").description(