zam-core 0.4.1 → 0.4.3

package/dist/cli/index.js

@@ -2,7 +2,7 @@
 
 // src/cli/index.ts
 import { readFileSync as readFileSync14 } from "fs";
-import { dirname as dirname10, join as join22 } from "path";
+import { dirname as dirname10, join as join23 } from "path";
 import { fileURLToPath as fileURLToPath5 } from "url";
 import { Command as Command24 } from "commander";
 
@@ -4932,10 +4932,10 @@ var agentCommand = new Command("agent").description("Provision and inspect the a
 
 // src/cli/commands/bridge.ts
 import { execFileSync as execFileSync2 } from "child_process";
-import { randomBytes } from "crypto";
+import { randomBytes as randomBytes2 } from "crypto";
 import { readdirSync as readdirSync2, readFileSync as readFileSync10, rmSync as rmSync2 } from "fs";
-import { homedir as homedir8, tmpdir } from "os";
-import { join as join12 } from "path";
+import { homedir as homedir8, tmpdir as tmpdir2 } from "os";
+import { join as join13 } from "path";
 import { Command as Command2 } from "commander";
 
 // src/cli/llm/client.ts
@@ -4955,12 +4955,15 @@ async function getLlmConfig(db) {
 }
 async function getVisionConfig(db) {
   const base = await getLlmConfig(db);
+  const maxFramesStr = await getSetting(db, "llm.vision.max_frames");
+  const maxFrames = maxFramesStr ? parseInt(maxFramesStr, 10) : 100;
   return {
     enabled: await getSetting(db, "llm.vision.enabled") === "true",
     url: await getSetting(db, "llm.vision.url") || base.url,
     model: await getSetting(db, "llm.vision.model") || base.model,
     apiKey: await getSetting(db, "llm.vision.api_key") || base.apiKey,
-    locale: base.locale
+    locale: base.locale,
+    maxFrames: Number.isNaN(maxFrames) ? 100 : maxFrames
   };
 }
 var LANGUAGE_NAMES = {
@@ -5497,8 +5500,10 @@ async function ensureHighQualityQuestion(db, token) {
 }
 
 // src/cli/llm/vision.ts
+import { randomBytes } from "crypto";
 import { readFileSync as readFileSync9 } from "fs";
-import { basename as basename2 } from "path";
+import { tmpdir } from "os";
+import { basename as basename2, join as join12 } from "path";
 var LANGUAGE_NAMES2 = {
   en: "English",
   de: "German",
@@ -5531,15 +5536,69 @@ async function observeUiSnapshotViaLLM(db, input8) {
       "Vision observation is disabled in settings (llm.vision.enabled)"
     );
   }
-  const imageBytes = readFileSync9(input8.imagePath);
-  const imageUrl = `data:image/png;base64,${imageBytes.toString("base64")}`;
+  const imageUrls = [];
+  const isVideo = /\.(mp4|mov|m4v|avi|mkv|webm)$/i.test(input8.imagePath);
+  if (isVideo) {
+    const { mkdirSync: mkdirSync12, readdirSync: readdirSync3, rmSync: rmSync3 } = await import("fs");
+    const { execSync: execSync7 } = await import("child_process");
+    const tempDir = join12(
+      tmpdir(),
+      `zam-frames-${randomBytes(4).toString("hex")}`
+    );
+    mkdirSync12(tempDir, { recursive: true });
+    try {
+      execSync7(
+        `ffmpeg -i "${input8.imagePath}" -vf "fps=1/3,scale=1280:-1" -vsync vfr "${tempDir}/frame_%03d.png"`,
+        { stdio: "ignore" }
+      );
+      let files = readdirSync3(tempDir).filter((f) => f.endsWith(".png")).sort();
+      if (files.length === 0) {
+        execSync7(
+          `ffmpeg -i "${input8.imagePath}" -vframes 1 "${tempDir}/frame_001.png"`,
+          { stdio: "ignore" }
+        );
+        files = readdirSync3(tempDir).filter((f) => f.endsWith(".png")).sort();
+      }
+      const maxFrames = cfg.maxFrames ?? 100;
+      let sampledFiles = files;
+      if (files.length > maxFrames) {
+        if (maxFrames <= 1) {
+          sampledFiles = [files[0]];
+        } else {
+          const step = (files.length - 1) / (maxFrames - 1);
+          sampledFiles = [];
+          for (let i = 0; i < maxFrames; i++) {
+            const index = Math.round(i * step);
+            sampledFiles.push(files[index]);
+          }
+        }
+      }
+      for (const file of sampledFiles) {
+        const bytes = readFileSync9(join12(tempDir, file));
+        imageUrls.push(`data:image/png;base64,${bytes.toString("base64")}`);
+      }
+    } finally {
+      try {
+        rmSync3(tempDir, { recursive: true, force: true });
+      } catch {
+      }
+    }
+  } else {
+    const imageBytes = readFileSync9(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")}`);
+  }
+  if (imageUrls.length === 0) {
+    throw new Error("No image data available for vision analysis");
+  }
   const model = input8.model ?? cfg.model;
   const content = await requestVisionDraft({
     url: cfg.url,
     apiKey: cfg.apiKey || DEFAULT_LLM_API_KEY,
     model,
     locale: cfg.locale,
-    imageUrl,
+    imageUrls,
     input: input8
   });
   let draft;
@@ -5589,22 +5648,28 @@ async function requestVisionDraft(args) {
             content: [
               {
                 type: "text",
-                text: `Observe this Windows application snapshot for a learning session.
+                text: args.imageUrls.length > 1 ? `Observe this sequence of Windows/macOS application snapshots showing a task performed over time.
+Application process: ${args.input.application.processName}
+Window title: ${args.input.application.windowTitle ?? "(unknown)"}
+
+Return this JSON draft only:
+${schema}` : `Observe this Windows/macOS application snapshot for a learning session.
 Application process: ${args.input.application.processName}
 Window title: ${args.input.application.windowTitle ?? "(unknown)"}
 
 Return this JSON draft only:
 ${schema}`
               },
-              {
+              ...args.imageUrls.map((url) => ({
                 type: "image_url",
-                image_url: { url: args.imageUrl }
-              }
+                image_url: { url }
+              }))
             ]
           }
         ],
         temperature: 0,
-        max_tokens: args.input.maxTokens ?? 450
+        max_tokens: args.input.maxTokens ?? 450,
+        ...args.url.includes("11434") || args.url.includes("localhost") || args.url.includes("127.0.0.1") ? { options: { num_ctx: 32768 } } : {}
       }),
       locale: args.locale,
       hardTimeoutMs: args.input.hardTimeoutMs ?? 18e4
@@ -6239,7 +6304,7 @@ bridgeCommand.command("discover-skills").description(
   "20"
 ).action(async (opts) => {
   try {
-    const monitorDir = join12(homedir8(), ".zam", "monitor");
+    const monitorDir = join13(homedir8(), ".zam", "monitor");
     let files;
     try {
       files = readdirSync2(monitorDir).filter((f) => f.endsWith(".jsonl"));
@@ -6252,7 +6317,7 @@ bridgeCommand.command("discover-skills").description(
       return;
     }
     const limit = Number(opts.limit);
-    const sorted = files.map((f) => ({ name: f, path: join12(monitorDir, f) })).sort((a, b) => b.name.localeCompare(a.name)).slice(0, limit);
+    const sorted = files.map((f) => ({ name: f, path: join13(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", "");
@@ -6332,8 +6397,8 @@ bridgeCommand.command("get-observations").description("Read UI observer reports
   }
 });
 bridgeCommand.command("observe-ui-snapshot").description(
-  "Analyze a captured UI snapshot with the configured vision LLM (JSON)"
-).requiredOption("--session <id>", "Observer session ID").requiredOption("--sequence <n>", "Monotonic observation sequence number").requiredOption("--image <path>", "PNG snapshot path").requiredOption("--observed-from <iso>", "Observation window start time").requiredOption("--observed-to <iso>", "Observation window end time").requiredOption("--process-name <name>", "Observed application process name").option("--process-id <n>", "Observed application process ID").option("--window-title <title>", "Observed window title").option("--evidence-ref <ref>", "Evidence reference to put in the report").option("--model <model>", "Override configured LLM model for this request").option("--max-tokens <n>", "Model response token budget").option("--timeout <ms>", "Hard request timeout in milliseconds").option("--redacted", "Mark the snapshot evidence as redacted").option("--write-log", "Append the generated report to the session JSONL").action(async (opts) => {
+  "Analyze a captured UI snapshot or video recording with the configured vision LLM (JSON)"
+).requiredOption("--session <id>", "Observer session ID").requiredOption("--sequence <n>", "Monotonic observation sequence number").requiredOption("--image <path>", "PNG snapshot or video recording path").requiredOption("--observed-from <iso>", "Observation window start time").requiredOption("--observed-to <iso>", "Observation window end time").requiredOption("--process-name <name>", "Observed application process name").option("--process-id <n>", "Observed application process ID").option("--window-title <title>", "Observed window title").option("--evidence-ref <ref>", "Evidence reference to put in the report").option("--model <model>", "Override configured LLM model for this request").option("--max-tokens <n>", "Model response token budget").option("--timeout <ms>", "Hard request timeout in milliseconds").option("--redacted", "Mark the snapshot evidence as redacted").option("--write-log", "Append the generated report to the session JSONL").action(async (opts) => {
   const sequence = parseNonNegativeIntegerOption("sequence", opts.sequence);
   const processId = opts.processId === void 0 ? void 0 : parseNonNegativeIntegerOption("process-id", opts.processId);
   const maxTokens = opts.maxTokens === void 0 ? void 0 : parseNonNegativeIntegerOption("max-tokens", opts.maxTokens);
@@ -6754,7 +6819,7 @@ bridgeCommand.command("capture-ui").description("Capture a screenshot for agent-
         return;
       }
     }
-    const outputPath = opts.image ?? opts.output ?? join12(tmpdir(), `zam-capture-${randomBytes(4).toString("hex")}.png`);
+    const outputPath = opts.image ?? opts.output ?? join13(tmpdir2(), `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, {
@@ -6798,6 +6863,177 @@ bridgeCommand.command("capture-ui").description("Capture a screenshot for agent-
     });
   });
 });
+bridgeCommand.command("start-recording").description("Start screen recording in the background (macOS only) (JSON)").requiredOption("--session <id>", "ZAM session ID").option("--output <path>", "Video output path").action(async (opts) => {
+  const platform = process.platform;
+  if (platform !== "darwin") {
+    jsonOut2({
+      sessionId: opts.session,
+      started: false,
+      error: "Screen recording is only supported on macOS (darwin)"
+    });
+    return;
+  }
+  const sessionId = opts.session;
+  const statePath = join13(tmpdir2(), `zam-recording-${sessionId}.json`);
+  const outputPath = opts.output ?? join13(tmpdir2(), `zam-recording-${sessionId}.mov`);
+  const { existsSync: existsSync22, writeFileSync: writeFileSync12, openSync, closeSync } = await import("fs");
+  if (existsSync22(statePath)) {
+    jsonOut2({
+      sessionId,
+      started: false,
+      error: `Recording is already active for session ${sessionId}`
+    });
+    return;
+  }
+  const logPath = join13(tmpdir2(), `zam-recording-${sessionId}.log`);
+  let logFd;
+  try {
+    logFd = openSync(logPath, "w");
+  } catch (e) {
+    jsonOut2({
+      sessionId,
+      started: false,
+      error: `Failed to open log file at ${logPath}: ${e.message}`
+    });
+    return;
+  }
+  const { spawn: spawn3 } = await import("child_process");
+  const child = spawn3(
+    "ffmpeg",
+    [
+      "-y",
+      "-f",
+      "avfoundation",
+      "-r",
+      "5",
+      "-i",
+      "0",
+      "-pix_fmt",
+      "yuv420p",
+      outputPath
+    ],
+    {
+      detached: true,
+      stdio: ["pipe", logFd, logFd]
+    }
+  );
+  try {
+    closeSync(logFd);
+  } catch {
+  }
+  child.unref();
+  if (child.pid) {
+    writeFileSync12(
+      statePath,
+      JSON.stringify({
+        pid: child.pid,
+        outputPath,
+        startedAt: (/* @__PURE__ */ new Date()).toISOString()
+      }),
+      "utf8"
+    );
+    jsonOut2({
+      sessionId,
+      started: true,
+      outputPath,
+      pid: child.pid
+    });
+  } else {
+    jsonOut2({
+      sessionId,
+      started: false,
+      error: "Failed to spawn ffmpeg process"
+    });
+  }
+});
+bridgeCommand.command("stop-recording").description(
+  "Stop active screen recording and apply idle-frame compression (macOS only) (JSON)"
+).requiredOption("--session <id>", "ZAM session ID").action(async (opts) => {
+  const platform = process.platform;
+  if (platform !== "darwin") {
+    jsonOut2({
+      sessionId: opts.session,
+      stopped: false,
+      error: "Screen recording is only supported on macOS (darwin)"
+    });
+    return;
+  }
+  const sessionId = opts.session;
+  const statePath = join13(tmpdir2(), `zam-recording-${sessionId}.json`);
+  const { existsSync: existsSync22, readFileSync: readFileSync15, rmSync: rmSync3 } = await import("fs");
+  if (!existsSync22(statePath)) {
+    jsonOut2({
+      sessionId,
+      stopped: false,
+      error: `No active recording found for session ${sessionId}`
+    });
+    return;
+  }
+  const state = JSON.parse(readFileSync15(statePath, "utf8"));
+  const { pid, outputPath } = state;
+  try {
+    process.kill(pid, "SIGINT");
+  } catch (_e) {
+  }
+  const isProcessRunning = (pId) => {
+    try {
+      process.kill(pId, 0);
+      return true;
+    } catch (_e) {
+      return false;
+    }
+  };
+  let attempts = 0;
+  while (isProcessRunning(pid) && attempts < 20) {
+    await new Promise((resolve5) => setTimeout(resolve5, 250));
+    attempts++;
+  }
+  if (isProcessRunning(pid)) {
+    try {
+      process.kill(pid, "SIGKILL");
+    } catch (_e) {
+    }
+  }
+  try {
+    rmSync3(statePath, { force: true });
+  } catch {
+  }
+  if (!existsSync22(outputPath)) {
+    jsonOut2({
+      sessionId,
+      stopped: false,
+      error: `Recording file not found at ${outputPath}`
+    });
+    return;
+  }
+  const decimatedPath = outputPath.replace(/\.[^.]+$/, "-decimated.mp4");
+  const { execSync: execSync7 } = await import("child_process");
+  try {
+    execSync7(
+      `ffmpeg -y -i "${outputPath}" -vf "mpdecimate,setpts=N/FRAME_RATE/TB" -an -pix_fmt yuv420p "${decimatedPath}"`,
+      { stdio: "ignore" }
+    );
+  } catch (ffmpegErr) {
+    jsonOut2({
+      sessionId,
+      stopped: true,
+      videoPath: outputPath,
+      decimated: false,
+      warning: `mpdecimate post-processing failed: ${ffmpegErr.message}`
+    });
+    return;
+  }
+  try {
+    rmSync3(outputPath, { force: true });
+  } catch {
+  }
+  jsonOut2({
+    sessionId,
+    stopped: true,
+    videoPath: decimatedPath,
+    decimated: true
+  });
+});
 bridgeCommand.command("get-observer-policy").description(
   "Report the resolved observer policy so an agent can check before capturing (JSON)"
 ).action(async () => {
@@ -7506,18 +7742,18 @@ async function setupTurso(urlArg, tokenArg, mode) {
 // src/cli/commands/git-sync.ts
 import { execSync as execSync4 } from "child_process";
 import { chmodSync as chmodSync2, existsSync as existsSync13, writeFileSync as writeFileSync6 } from "fs";
-import { join as join13 } from "path";
+import { join as join14 } from "path";
 import { Command as Command5 } from "commander";
 function installHook2() {
-  const gitDir = join13(process.cwd(), ".git");
+  const gitDir = join14(process.cwd(), ".git");
   if (!existsSync13(gitDir)) {
     console.error(
       "Error: Current directory is not the root of a Git repository."
     );
     process.exit(1);
   }
-  const hooksDir = join13(gitDir, "hooks");
-  const hookPath = join13(hooksDir, "post-commit");
+  const hooksDir = join14(gitDir, "hooks");
+  const hookPath = join14(hooksDir, "post-commit");
   const hookContent = `#!/bin/sh
 # ZAM Spaced Repetition Auto-Stale Hook
 # Triggered automatically on git commits to decay modified concept cards.
@@ -7813,7 +8049,7 @@ goalCommand.command("status <slug> <status>").description("Update a goal's statu
 // src/cli/commands/init.ts
 import { existsSync as existsSync15, mkdirSync as mkdirSync9, writeFileSync as writeFileSync7 } from "fs";
 import { homedir as homedir9 } from "os";
-import { join as join14 } from "path";
+import { join as join15 } from "path";
 import { confirm, input as input3 } from "@inquirer/prompts";
 import { Command as Command7 } from "commander";
 var HOME2 = homedir9();
@@ -7821,10 +8057,10 @@ function printLine(char = "\u2550", len = 60, color = "\x1B[36m") {
   console.log(`${color}${char.repeat(len)}\x1B[0m`);
 }
 function bootstrapSandboxWorkspace(workspaceDir) {
-  mkdirSync9(join14(workspaceDir, "beliefs"), { recursive: true });
-  mkdirSync9(join14(workspaceDir, "goals"), { recursive: true });
-  mkdirSync9(join14(workspaceDir, "skills"), { recursive: true });
-  const worldviewFile = join14(workspaceDir, "beliefs", "worldview.md");
+  mkdirSync9(join15(workspaceDir, "beliefs"), { recursive: true });
+  mkdirSync9(join15(workspaceDir, "goals"), { recursive: true });
+  mkdirSync9(join15(workspaceDir, "skills"), { recursive: true });
+  const worldviewFile = join15(workspaceDir, "beliefs", "worldview.md");
   if (!existsSync15(worldviewFile)) {
     writeFileSync7(
       worldviewFile,
@@ -7838,7 +8074,7 @@ Here, I declare the core concepts and principles I want to master.
       "utf8"
     );
   }
-  const goalsFile = join14(workspaceDir, "goals", "goals.md");
+  const goalsFile = join15(workspaceDir, "goals", "goals.md");
   if (!existsSync15(goalsFile)) {
     writeFileSync7(
       goalsFile,
@@ -7862,7 +8098,7 @@ var initCommand = new Command7("init").description("Launch the guided interactiv
   );
   printLine();
   console.log("\n\x1B[1m[1/5] Setting up Local Workspace Sandbox\x1B[0m");
-  const defaultWorkspace = join14(HOME2, "Documents", "zam");
+  const defaultWorkspace = join15(HOME2, "Documents", "zam");
   const workspacePath = await input3({
     message: "Choose your ZAM workspace directory:",
     default: defaultWorkspace
@@ -8561,8 +8797,8 @@ ${"\u2550".repeat(50)}`);
 // src/cli/commands/monitor.ts
 import { execFileSync as execFileSync3, execSync as execSync5 } from "child_process";
 import { unlinkSync, writeFileSync as writeFileSync8 } from "fs";
-import { tmpdir as tmpdir2 } from "os";
-import { basename as basename3, join as join15 } from "path";
+import { tmpdir as tmpdir3 } from "os";
+import { basename as basename3, join as join16 } from "path";
 import { Command as Command9 } from "commander";
 function isPowerShellShell(shell) {
   return shell === "pwsh" || shell === "powershell";
@@ -8739,8 +8975,8 @@ function resolveZamInvocation(shell) {
   if (installed) {
     return isPowerShellShell(shell) ? `& ${psSingleQuoted2(installed)}` : installed;
   }
-  const projectRoot = join15(import.meta.dirname, "..", "..", "..");
-  const cliSource = join15(projectRoot, "src/cli/index.ts");
+  const projectRoot = join16(import.meta.dirname, "..", "..", "..");
+  const cliSource = join16(projectRoot, "src/cli/index.ts");
   if (isPowerShellShell(shell)) {
     return `& npx --prefix ${psSingleQuoted2(projectRoot)} tsx ${psSingleQuoted2(cliSource)}`;
   }
@@ -8830,7 +9066,7 @@ end tell` : `tell application "Terminal"
   activate
   do script "${escaped}"
 end tell`;
-  const tmpFile = join15(tmpdir2(), `zam-monitor-${sessionId}.scpt`);
+  const tmpFile = join16(tmpdir3(), `zam-monitor-${sessionId}.scpt`);
   try {
     writeFileSync8(tmpFile, appleScript);
     execSync5(`osascript ${JSON.stringify(tmpFile)}`, { stdio: "ignore" });
@@ -8946,7 +9182,7 @@ observerCommand.command("revoke <process>").description("Remove a process from o
 
 // src/cli/commands/profile.ts
 import { homedir as homedir10 } from "os";
-import { dirname as dirname5, join as join16, resolve as resolve4 } from "path";
+import { dirname as dirname5, join as join17, resolve as resolve4 } from "path";
 import { Command as Command11 } from "commander";
 var C2 = {
   reset: "\x1B[0m",
@@ -8956,7 +9192,7 @@ var C2 = {
   green: "\x1B[32m"
 };
 function defaultPersonalDir() {
-  return join16(homedir10(), "Documents", "zam");
+  return join17(homedir10(), "Documents", "zam");
 }
 function render(profile) {
   const sync = profile.syncProvider ? `${C2.green}${profile.syncProvider}${C2.reset} ${C2.dim}(good for cross-device snapshots)${C2.reset}` : `${C2.dim}local folder (use a synced folder or snapshots to move between machines)${C2.reset}`;
@@ -9677,31 +9913,31 @@ settingsCommand.command("repos").description("Show or set Personal, Team, and Or
 
 // src/cli/commands/setup.ts
 import { copyFileSync as copyFileSync2, existsSync as existsSync17, mkdirSync as mkdirSync10, writeFileSync as writeFileSync9 } from "fs";
-import { basename as basename4, dirname as dirname6, join as join17 } from "path";
+import { basename as basename4, dirname as dirname6, join as join18 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 import { Command as Command15 } from "commander";
 var packageRoot = [
   fileURLToPath2(new URL("../..", import.meta.url)),
   fileURLToPath2(new URL("../../..", import.meta.url))
-].find((candidate) => existsSync17(join17(candidate, "package.json"))) ?? fileURLToPath2(new URL("../..", import.meta.url));
+].find((candidate) => existsSync17(join18(candidate, "package.json"))) ?? fileURLToPath2(new URL("../..", import.meta.url));
 var SKILL_PAIRS = [
   {
-    from: join17(packageRoot, ".claude", "skills", "zam", "SKILL.md"),
-    to: join17(".claude", "skills", "zam", "SKILL.md")
+    from: join18(packageRoot, ".claude", "skills", "zam", "SKILL.md"),
+    to: join18(".claude", "skills", "zam", "SKILL.md")
   },
   {
-    from: join17(packageRoot, ".agent", "skills", "zam", "SKILL.md"),
-    to: join17(".agent", "skills", "zam", "SKILL.md")
+    from: join18(packageRoot, ".agent", "skills", "zam", "SKILL.md"),
+    to: join18(".agent", "skills", "zam", "SKILL.md")
   },
   {
-    from: join17(packageRoot, ".agents", "skills", "zam", "SKILL.md"),
-    to: join17(".agents", "skills", "zam", "SKILL.md")
+    from: join18(packageRoot, ".agents", "skills", "zam", "SKILL.md"),
+    to: join18(".agents", "skills", "zam", "SKILL.md")
   }
 ];
 function copySkills(force, cwd = process.cwd()) {
   let anyAction = false;
   for (const { from, to } of SKILL_PAIRS) {
-    const dest = join17(cwd, to);
+    const dest = join18(cwd, to);
     if (!existsSync17(from)) {
       console.warn(`  warn  source not found, skipping: ${from}`);
       continue;
@@ -9751,7 +9987,7 @@ async function initDatabase(skipInit) {
 }
 function writeClaudeMd(skipClaudeMd, cwd = process.cwd()) {
   if (skipClaudeMd) return;
-  const dest = join17(cwd, "CLAUDE.md");
+  const dest = join18(cwd, "CLAUDE.md");
   if (existsSync17(dest)) {
     console.log(`  skip  CLAUDE.md (already present)`);
     return;
@@ -9785,7 +10021,7 @@ Use \`zam connector setup turso\` to store cloud credentials in
 }
 function writeAgentsMd(skipAgentsMd, cwd = process.cwd()) {
   if (skipAgentsMd) return;
-  const dest = join17(cwd, "AGENTS.md");
+  const dest = join18(cwd, "AGENTS.md");
   if (existsSync17(dest)) {
     console.log(`  skip  AGENTS.md (already present)`);
     return;
@@ -9933,7 +10169,7 @@ skillCommand.command("add").description("Register a new agent skill").requiredOp
 // src/cli/commands/snapshot.ts
 import { existsSync as existsSync18, mkdirSync as mkdirSync11, readFileSync as readFileSync12, writeFileSync as writeFileSync10 } from "fs";
 import { homedir as homedir11 } from "os";
-import { dirname as dirname7, join as join18 } from "path";
+import { dirname as dirname7, join as join19 } from "path";
 import { Command as Command17 } from "commander";
 function defaultOutName() {
   const stamp = (/* @__PURE__ */ new Date()).toISOString().replace(/\.\d+Z$/, "").replace(/:/g, "-");
@@ -9953,7 +10189,7 @@ var exportCmd = new Command17("export").description("Write a portable SQL-text s
   try {
     db = await openDatabaseWithSync({ initialize: true });
     const snapshot = await exportSnapshot(db);
-    const personalDir = await getSetting(db, "personal.workspace_dir") || join18(homedir11(), "Documents", "zam");
+    const personalDir = await getSetting(db, "personal.workspace_dir") || join19(homedir11(), "Documents", "zam");
     await db.close();
     db = void 0;
     const manifest = verifySnapshot(snapshot);
@@ -9962,7 +10198,7 @@ var exportCmd = new Command17("export").description("Write a portable SQL-text s
       process.stdout.write(snapshot);
       return;
     }
-    const out = opts.out ?? join18(personalDir, "snapshots", defaultOutName());
+    const out = opts.out ?? join19(personalDir, "snapshots", defaultOutName());
     const dir = dirname7(out);
     if (dir && dir !== "." && !existsSync18(dir)) {
       mkdirSync11(dir, { recursive: true });
@@ -10349,7 +10585,7 @@ tokenCommand.command("status").description("Show full status of a token for a us
 import { spawn as spawn2, spawnSync } from "child_process";
 import { existsSync as existsSync19 } from "fs";
 import { homedir as homedir12 } from "os";
-import { dirname as dirname8, join as join19 } from "path";
+import { dirname as dirname8, join as join20 } from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
 import { Command as Command20 } from "commander";
 var C3 = {
@@ -10365,8 +10601,8 @@ function findDesktopDir() {
   for (const start of starts) {
     let dir = start;
     for (let i = 0; i < 10; i++) {
-      if (existsSync19(join19(dir, "desktop", "src-tauri", "tauri.conf.json"))) {
-        return join19(dir, "desktop");
+      if (existsSync19(join20(dir, "desktop", "src-tauri", "tauri.conf.json"))) {
+        return join20(dir, "desktop");
       }
       const parent = dirname8(dir);
       if (parent === dir) break;
@@ -10376,18 +10612,18 @@ function findDesktopDir() {
   return null;
 }
 function findBuiltApp(desktopDir) {
-  const releaseDir = join19(desktopDir, "src-tauri", "target", "release");
+  const releaseDir = join20(desktopDir, "src-tauri", "target", "release");
   if (process.platform === "win32") {
     for (const name of ["ZAM.exe", "zam.exe", "zam-desktop.exe"]) {
-      const p = join19(releaseDir, name);
+      const p = join20(releaseDir, name);
       if (existsSync19(p)) return p;
     }
   } else if (process.platform === "darwin") {
-    const app = join19(releaseDir, "bundle", "macos", "ZAM.app");
+    const app = join20(releaseDir, "bundle", "macos", "ZAM.app");
     if (existsSync19(app)) return app;
   } else {
     for (const name of ["zam", "ZAM", "zam-desktop"]) {
-      const p = join19(releaseDir, name);
+      const p = join20(releaseDir, name);
       if (existsSync19(p)) return p;
     }
   }
@@ -10395,10 +10631,10 @@ function findBuiltApp(desktopDir) {
 }
 function findInstalledApp() {
   const candidates = process.platform === "win32" ? [
-    process.env.LOCALAPPDATA && join19(process.env.LOCALAPPDATA, "Programs", "ZAM", "ZAM.exe"),
-    process.env.ProgramFiles && join19(process.env.ProgramFiles, "ZAM", "ZAM.exe"),
-    process.env["ProgramFiles(x86)"] && join19(process.env["ProgramFiles(x86)"], "ZAM", "ZAM.exe")
-  ] : process.platform === "darwin" ? ["/Applications/ZAM.app", join19(homedir12(), "Applications", "ZAM.app")] : ["/opt/ZAM/zam", "/usr/bin/zam-desktop"];
+    process.env.LOCALAPPDATA && join20(process.env.LOCALAPPDATA, "Programs", "ZAM", "ZAM.exe"),
+    process.env.ProgramFiles && join20(process.env.ProgramFiles, "ZAM", "ZAM.exe"),
+    process.env["ProgramFiles(x86)"] && join20(process.env["ProgramFiles(x86)"], "ZAM", "ZAM.exe")
+  ] : process.platform === "darwin" ? ["/Applications/ZAM.app", join20(homedir12(), "Applications", "ZAM.app")] : ["/opt/ZAM/zam", "/usr/bin/zam-desktop"];
   return candidates.find((candidate) => candidate && existsSync19(candidate)) || null;
 }
 function runNpm(args, opts) {
@@ -10410,7 +10646,7 @@ function runNpm(args, opts) {
   return res.status ?? 1;
 }
 function ensureDesktopDeps(desktopDir) {
-  if (existsSync19(join19(desktopDir, "node_modules"))) return true;
+  if (existsSync19(join20(desktopDir, "node_modules"))) return true;
   console.log(
     `${C3.cyan}Installing desktop dependencies (one-time)...${C3.reset}`
   );
@@ -10436,7 +10672,7 @@ function requireRust() {
 function hasMsvcBuildTools() {
   if (process.platform !== "win32") return true;
   const pf86 = process.env["ProgramFiles(x86)"] || "C:\\Program Files (x86)";
-  const vswhere = join19(
+  const vswhere = join20(
     pf86,
     "Microsoft Visual Studio",
     "Installer",
@@ -10474,7 +10710,7 @@ function requireMsvcOnWindows() {
   return false;
 }
 function warnIfCliMissing(repoRoot) {
-  if (!existsSync19(join19(repoRoot, "dist", "cli", "index.js"))) {
+  if (!existsSync19(join20(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}`
     );
@@ -10558,7 +10794,7 @@ var uiCommand = new Command20("ui").description("Launch the ZAM Desktop GUI (Act
     );
     const code = runNpm(["run", "tauri", "build"], { cwd: desktopDir });
     if (code === 0) {
-      const bundle = join19(
+      const bundle = join20(
         desktopDir,
         "src-tauri",
         "target",
@@ -10636,7 +10872,7 @@ ${C3.dim}After that, 'zam ui' launches it directly.${C3.reset}`
 // src/cli/commands/update.ts
 import { spawnSync as spawnSync2 } from "child_process";
 import { existsSync as existsSync20, readFileSync as readFileSync13, realpathSync } from "fs";
-import { dirname as dirname9, join as join20 } from "path";
+import { dirname as dirname9, join as join21 } from "path";
 import { fileURLToPath as fileURLToPath4 } from "url";
 import { confirm as confirm3 } from "@inquirer/prompts";
 import { Command as Command21 } from "commander";
@@ -10661,7 +10897,7 @@ function currentVersion() {
   for (const up of ["..", "../..", "../../.."]) {
     try {
       const pkg2 = JSON.parse(
-        readFileSync13(join20(here, up, "package.json"), "utf-8")
+        readFileSync13(join21(here, up, "package.json"), "utf-8")
       );
       if (pkg2.version) return pkg2.version;
     } catch {
@@ -10672,7 +10908,7 @@ function currentVersion() {
 function versionAt(dir) {
   try {
     const pkg2 = JSON.parse(
-      readFileSync13(join20(dir, "package.json"), "utf-8")
+      readFileSync13(join21(dir, "package.json"), "utf-8")
     );
     return pkg2.version ?? "unknown";
   } catch {
@@ -10752,11 +10988,11 @@ function findSourceRepo() {
   let dir = realpathSync(dirname9(fileURLToPath4(import.meta.url)));
   let parent = dirname9(dir);
   while (parent !== dir) {
-    if (existsSync20(join20(dir, ".git"))) return dir;
+    if (existsSync20(join21(dir, ".git"))) return dir;
     dir = parent;
     parent = dirname9(dir);
   }
-  return existsSync20(join20(dir, ".git")) ? dir : null;
+  return existsSync20(join21(dir, ".git")) ? dir : null;
 }
 function runGit(cwd, args, capture) {
   const res = spawnSync2("git", args, {
@@ -10821,7 +11057,7 @@ Commit or stash them, or re-run with ${C4.cyan}--force${C4.reset}.`
   console.log(`${C4.dim}\u2192 zam setup --force${C4.reset}`);
   const setup = spawnSync2(
     process.execPath,
-    [join20(src, "dist", "cli", "index.js"), "setup", "--force"],
+    [join21(src, "dist", "cli", "index.js"), "setup", "--force"],
     { cwd: process.cwd(), stdio: "inherit" }
   );
   if (setup.status !== 0) {
@@ -10933,7 +11169,7 @@ var whoamiCommand = new Command22("whoami").description("Show or set the default
 // src/cli/commands/workspace.ts
 import { execSync as execSync6 } from "child_process";
 import { existsSync as existsSync21, writeFileSync as writeFileSync11 } from "fs";
-import { join as join21 } from "path";
+import { join as join22 } from "path";
 import { confirm as confirm4, input as input7 } from "@inquirer/prompts";
 import { Command as Command23 } from "commander";
 function runGit2(cwd, args) {
@@ -10980,7 +11216,7 @@ Active workspace: \x1B[36m${workspaceDir}\x1B[0m`);
     );
     process.exit(1);
   }
-  const gitignorePath = join21(workspaceDir, ".gitignore");
+  const gitignorePath = join22(workspaceDir, ".gitignore");
   if (!existsSync21(gitignorePath)) {
     writeFileSync11(
       gitignorePath,
@@ -10988,7 +11224,7 @@ Active workspace: \x1B[36m${workspaceDir}\x1B[0m`);
       "utf8"
     );
   }
-  const hasGitRepo = existsSync21(join21(workspaceDir, ".git"));
+  const hasGitRepo = existsSync21(join22(workspaceDir, ".git"));
   if (!hasGitRepo) {
     console.log("Initializing local Git repository...");
     runGit2(workspaceDir, "init -b main");
@@ -11084,7 +11320,7 @@ Active workspace: \x1B[36m${workspaceDir}\x1B[0m`);
 // src/cli/index.ts
 var __dirname = dirname10(fileURLToPath5(import.meta.url));
 var pkg = JSON.parse(
-  readFileSync14(join22(__dirname, "..", "..", "package.json"), "utf-8")
+  readFileSync14(join23(__dirname, "..", "..", "package.json"), "utf-8")
 );
 var program = new Command24();
 program.name("zam").description(