codeam-cli 2.76.7 → 2.76.9

package/dist/index.js

@@ -357,8 +357,8 @@ function defaultSpawn(timeoutMs) {
   });
 }
 function resolveConvexBin(cwd) {
-  const local = path106.join(cwd, "node_modules", ".bin", process.platform === "win32" ? "convex.cmd" : "convex");
-  if (fs92.existsSync(local)) return { cmd: local, args: [] };
+  const local = path107.join(cwd, "node_modules", ".bin", process.platform === "win32" ? "convex.cmd" : "convex");
+  if (fs93.existsSync(local)) return { cmd: local, args: [] };
   return { cmd: "npx", args: ["--yes", "convex"] };
 }
 function redact(text, key) {
@@ -489,13 +489,13 @@ async function runConvexAdminMcp(client3, id) {
   });
   await server.connect(new StdioServerTransport());
 }
-var import_node_child_process37, fs92, path106, TOOLS;
+var import_node_child_process37, fs93, path107, TOOLS;
 var init_convex_admin_mcp = __esm({
   "src/integrations/convex-admin-mcp.ts"() {
     "use strict";
     import_node_child_process37 = require("child_process");
-    fs92 = __toESM(require("fs"));
-    path106 = __toESM(require("path"));
+    fs93 = __toESM(require("fs"));
+    path107 = __toESM(require("path"));
     TOOLS = [
       {
         name: "tables",
@@ -3595,11 +3595,11 @@ function quiet(fn) {
     log.debug(TAG, "ignored sync error", err);
   }
 }
-function rmIfExistsQuiet(path108) {
+function rmIfExistsQuiet(path109) {
   try {
-    fs2.rmSync(path108, { force: true });
+    fs2.rmSync(path109, { force: true });
   } catch (err) {
-    log.debug(TAG, `rmIfExists failed for ${path108}`, err);
+    log.debug(TAG, `rmIfExists failed for ${path109}`, err);
   }
 }
 function killQuiet(target, signal = "SIGTERM") {
@@ -3765,9 +3765,9 @@ var _default = makeConfig();
 var { getConfig, ensurePluginId, addSession, removeSession, setActiveSession, getActiveSession, getActiveSessionForAgent, setDisable1mContext, setSessionAgent, setSquadAuto, getSquadAuto, clearAll, saveCliConfig, loadCliConfig } = _default;
 
 // src/commands/pair-auto.ts
-var fs63 = __toESM(require("fs"));
+var fs64 = __toESM(require("fs"));
 var os47 = __toESM(require("os"));
-var path72 = __toESM(require("path"));
+var path73 = __toESM(require("path"));
 var import_crypto4 = require("crypto");
 
 // src/services/telemetry.service.ts
@@ -3803,8 +3803,8 @@ function createGetModuleFromFilename(basePath = process.argv[1] ? (0, import_pat
     return decodedFile;
   };
 }
-function normalizeWindowsPath(path108) {
-  return path108.replace(/^[A-Z]:/, "").replace(/\\/g, "/");
+function normalizeWindowsPath(path109) {
+  return path109.replace(/^[A-Z]:/, "").replace(/\\/g, "/");
 }
 
 // ../../node_modules/@posthog/core/dist/error-tracking/index.mjs
@@ -6537,13 +6537,13 @@ var PostHogCoreStateless = class {
       sentFromRoute += batchMessages.length;
     }
   }
-  async _sendOtlpBatch({ path: path108, payload }) {
+  async _sendOtlpBatch({ path: path109, payload }) {
     if (this.disabled) return {
       kind: "fatal",
       error: new Error("The client is disabled")
     };
     const serialized = JSON.stringify(payload);
-    const url2 = `${this.host}/i/v1/${path108}?token=${encodeURIComponent(this.apiKey)}`;
+    const url2 = `${this.host}/i/v1/${path109}?token=${encodeURIComponent(this.apiKey)}`;
     const gzippedPayload = this.disableCompression ? null : await this.compressPayload(serialized);
     const fetchOptions = {
       method: "POST",
@@ -7783,14 +7783,14 @@ async function addSourceContext(frames, openSourceFile = import_promises.open, l
   LRU_FILE_CONTENTS_CACHE.reduce();
   return frames;
 }
-async function openRegularSourceFile(path108, openSourceFile, logger) {
+async function openRegularSourceFile(path109, openSourceFile, logger) {
   let fileHandle;
   let isValid = false;
   try {
-    fileHandle = await openSourceFile(path108, import_node_fs.constants.O_RDONLY | import_node_fs.constants.O_NONBLOCK);
+    fileHandle = await openSourceFile(path109, import_node_fs.constants.O_RDONLY | import_node_fs.constants.O_NONBLOCK);
     const fileStat = await fileHandle.stat();
     if (!fileStat.isFile()) return;
-    if (fileStat.size > MAX_CONTEXTLINES_FILE_SIZE) return void logger?.debug(`Skipping source context for oversized file ${path108}: ${fileStat.size} bytes exceeds ${MAX_CONTEXTLINES_FILE_SIZE}`);
+    if (fileStat.size > MAX_CONTEXTLINES_FILE_SIZE) return void logger?.debug(`Skipping source context for oversized file ${path109}: ${fileStat.size} bytes exceeds ${MAX_CONTEXTLINES_FILE_SIZE}`);
     isValid = true;
     return fileHandle;
   } catch {
@@ -7800,8 +7800,8 @@ async function openRegularSourceFile(path108, openSourceFile, logger) {
     });
   }
 }
-async function getContextLinesFromFile(path108, ranges, output, cacheKey, openSourceFile, logger) {
-  const fileHandle = await openRegularSourceFile(path108, openSourceFile, logger);
+async function getContextLinesFromFile(path109, ranges, output, cacheKey, openSourceFile, logger) {
+  const fileHandle = await openRegularSourceFile(path109, openSourceFile, logger);
   if (void 0 === fileHandle) return void LRU_FILE_CONTENTS_FS_READ_FAILED.set(cacheKey, 1);
   const openedFileHandle = fileHandle;
   return new Promise((resolve12) => {
@@ -7903,22 +7903,22 @@ function clearLineContext(frame) {
   delete frame.context_line;
   delete frame.post_context;
 }
-function shouldSkipContextLinesForFile(path108) {
-  return path108.startsWith("node:") || path108.endsWith(".min.js") || path108.endsWith(".min.cjs") || path108.endsWith(".min.mjs") || path108.startsWith("data:");
+function shouldSkipContextLinesForFile(path109) {
+  return path109.startsWith("node:") || path109.endsWith(".min.js") || path109.endsWith(".min.cjs") || path109.endsWith(".min.mjs") || path109.startsWith("data:");
 }
 function shouldSkipContextLinesForFrame(frame) {
   if (void 0 !== frame.lineno && frame.lineno > MAX_CONTEXTLINES_LINENO) return true;
   if (void 0 !== frame.colno && frame.colno > MAX_CONTEXTLINES_COLNO) return true;
   return false;
 }
-function makeSourceCacheKey(path108, basePath) {
-  if ((0, import_node_path.isAbsolute)(path108)) return JSON.stringify([
+function makeSourceCacheKey(path109, basePath) {
+  if ((0, import_node_path.isAbsolute)(path109)) return JSON.stringify([
     null,
-    path108
+    path109
   ]);
   return void 0 === basePath ? void 0 : JSON.stringify([
     basePath,
-    path108
+    path109
   ]);
 }
 function rangeExistsInContentCache(cacheKey, range) {
@@ -10579,7 +10579,7 @@ function readAnonId() {
 }
 function superProperties() {
   return {
-    cliVersion: true ? "2.76.7" : "0.0.0-dev",
+    cliVersion: true ? "2.76.9" : "0.0.0-dev",
     nodeVersion: process.version,
     platform: process.platform,
     arch: process.arch,
@@ -10824,7 +10824,7 @@ var http = __toESM(require("http"));
 // package.json
 var package_default = {
   name: "codeam-cli",
-  version: "2.76.7",
+  version: "2.76.9",
   description: "Workflow-continuity bridge for AI coding agents. Wrap Claude Code or Codex in a PTY and supervise, approve, and redirect the session from any device \u2014 async. The terminal companion for CodeAgent Mobile.",
   type: "commonjs",
   main: "dist/index.js",
@@ -12160,7 +12160,7 @@ var CommandRelayService = class _CommandRelayService {
       // fresh + clear the "CLI update available" banner after a self-update
       // (a codespace that reinstalls @latest reconnects via heartbeat, not
       // pair/reconnect). Older backends ignore the extra field.
-      ..."2.76.7" ? { ideVersion: "2.76.7" } : {}
+      ..."2.76.9" ? { ideVersion: "2.76.9" } : {}
     };
     try {
       const res = await _postJson(`${API_BASE2}/api/plugin/heartbeat`, body);
@@ -13636,9 +13636,9 @@ function closeAllTerminals() {
 }
 
 // src/commands/start/handlers.ts
-var fs62 = __toESM(require("fs"));
+var fs63 = __toESM(require("fs"));
 var os46 = __toESM(require("os"));
-var path71 = __toESM(require("path"));
+var path72 = __toESM(require("path"));
 var import_crypto3 = require("crypto");
 var import_child_process25 = require("child_process");
 
@@ -19775,8 +19775,8 @@ function pickLine(obj) {
 function toHunk(raw, groupSeverity) {
   if (!raw || typeof raw !== "object") return null;
   const o = raw;
-  const path108 = asString(pick(o, ["file_path", "filePath", "file", "path", "filename", "fileName"])) ?? asString(pick(o, ["location"])?.path);
-  if (!path108) return null;
+  const path109 = asString(pick(o, ["file_path", "filePath", "file", "path", "filename", "fileName"])) ?? asString(pick(o, ["location"])?.path);
+  if (!path109) return null;
   const message = asString(
     pick(o, [
       "comment",
@@ -19793,7 +19793,7 @@ function toHunk(raw, groupSeverity) {
   const severity = normSeverity(pick(o, ["severity", "level", "priority", "impact"])) ?? normSeverity(groupSeverity);
   const locObj = pick(o, ["location"]) ?? o;
   return {
-    path: path108.trim(),
+    path: path109.trim(),
     line: pickLine(o) ?? pickLine(locObj),
     severity,
     message: (title && message ? `${title}: ${message}` : title || message).trim() || "(no message)"
@@ -19876,10 +19876,10 @@ function parsePlain(stdout) {
   for (const line of stdout.split(/\r?\n/)) {
     const m = line.match(HUNK_LINE_RE);
     if (!m) continue;
-    const [, path108, lineNo, sevToken, message] = m;
-    if (!path108 || !lineNo || !message) continue;
+    const [, path109, lineNo, sevToken, message] = m;
+    if (!path109 || !lineNo || !message) continue;
     hunks.push({
-      path: path108.trim(),
+      path: path109.trim(),
       line: Number(lineNo),
       severity: sevToken ? SEVERITY_MAP[sevToken.toLowerCase()] : void 0,
       message: message.trim().replace(/^[*-]\s+/, "")
@@ -25130,19 +25130,67 @@ async function saveToProviderH(ctx, provider) {
   }
 }
 
+// src/scratch/auto-preview.ts
+var import_node_fs14 = __toESM(require("fs"));
+var import_node_path12 = __toESM(require("path"));
+var SERVABLE_ROOT_FILES = /* @__PURE__ */ new Set([
+  "package.json",
+  "requirements.txt",
+  "pyproject.toml",
+  "manage.py",
+  "app.py",
+  "main.py",
+  "Gemfile",
+  "go.mod",
+  "Cargo.toml",
+  "composer.json"
+]);
+var AGENT_NOTES = /* @__PURE__ */ new Set(["CLAUDE.md", "AGENTS.md", "GEMINI.md"]);
+function rootEntries(cwd) {
+  try {
+    return import_node_fs14.default.readdirSync(cwd);
+  } catch {
+    return null;
+  }
+}
+function hasServableProject(cwd) {
+  const entries2 = rootEntries(cwd);
+  if (!entries2) return false;
+  if (entries2.some((e) => SERVABLE_ROOT_FILES.has(e) || /\.html?$/i.test(e))) return true;
+  return ["public", "src"].some((dir) => import_node_fs14.default.existsSync(import_node_path12.default.join(cwd, dir, "index.html")));
+}
+function isEmptyScratchProject(cwd) {
+  if (!isScratchWorkspace(cwd)) return false;
+  const entries2 = rootEntries(cwd);
+  return entries2 !== null && entries2.every((e) => e.startsWith(".") || AGENT_NOTES.has(e));
+}
+var bringUps = /* @__PURE__ */ new Set();
+function notePreviewBringUp(sessionId) {
+  bringUps.add(sessionId);
+}
+function maybeAutoOpenScratchPreview(sessionId, bridge, cwd = process.cwd()) {
+  if (!isScratchWorkspace(cwd) || bringUps.has(sessionId)) return false;
+  if (bridge.status().status !== "idle") return false;
+  if (!hasServableProject(cwd)) return false;
+  bringUps.add(sessionId);
+  void bridge.start().catch(() => {
+  });
+  return true;
+}
+
 // src/services/preview/active-marker.ts
 var import_node_crypto11 = require("crypto");
 var import_promises5 = __toESM(require("fs/promises"));
 var import_node_os7 = __toESM(require("os"));
-var import_node_path12 = __toESM(require("path"));
+var import_node_path13 = __toESM(require("path"));
 function markerPath2(cwd, homeDir2 = import_node_os7.default.homedir()) {
-  const key = (0, import_node_crypto11.createHash)("sha256").update(import_node_path12.default.resolve(cwd)).digest("hex").slice(0, 16);
-  return import_node_path12.default.join(homeDir2, ".codeam", "preview-active", `${key}.json`);
+  const key = (0, import_node_crypto11.createHash)("sha256").update(import_node_path13.default.resolve(cwd)).digest("hex").slice(0, 16);
+  return import_node_path13.default.join(homeDir2, ".codeam", "preview-active", `${key}.json`);
 }
 async function writeActivePreviewMarker(cwd, detection, homeDir2) {
   try {
     const file = markerPath2(cwd, homeDir2);
-    await import_promises5.default.mkdir(import_node_path12.default.dirname(file), { recursive: true });
+    await import_promises5.default.mkdir(import_node_path13.default.dirname(file), { recursive: true });
     await import_promises5.default.writeFile(
       file,
       JSON.stringify({ detection, at: (/* @__PURE__ */ new Date()).toISOString() }, null, 2) + "\n",
@@ -25165,16 +25213,16 @@ async function readActivePreviewMarker(cwd, homeDir2) {
 }
 
 // src/agents/acp/guardrail-config.ts
-var fs50 = __toESM(require("fs"));
-var path58 = __toESM(require("path"));
+var fs51 = __toESM(require("fs"));
+var path59 = __toESM(require("path"));
 var os36 = __toESM(require("os"));
 var current = null;
 function guardrailConfigPath(homeDir2 = os36.homedir()) {
-  return path58.join(homeDir2, ".codeam", "guardrails.json");
+  return path59.join(homeDir2, ".codeam", "guardrails.json");
 }
 function loadGuardrailPolicy(homeDir2 = os36.homedir()) {
   try {
-    current = normalizeGuardrailPolicy(JSON.parse(fs50.readFileSync(guardrailConfigPath(homeDir2), "utf8")));
+    current = normalizeGuardrailPolicy(JSON.parse(fs51.readFileSync(guardrailConfigPath(homeDir2), "utf8")));
   } catch {
     current = { ...DEFAULT_GUARDRAIL_POLICY };
   }
@@ -25188,8 +25236,8 @@ function setGuardrailPolicy(raw, homeDir2 = os36.homedir()) {
   current = next;
   try {
     const p2 = guardrailConfigPath(homeDir2);
-    fs50.mkdirSync(path58.dirname(p2), { recursive: true });
-    fs50.writeFileSync(p2, JSON.stringify(next, null, 2));
+    fs51.mkdirSync(path59.dirname(p2), { recursive: true });
+    fs51.writeFileSync(p2, JSON.stringify(next, null, 2));
   } catch {
   }
   return next;
@@ -25205,22 +25253,22 @@ function shouldOfferOneMRecovery(opts) {
 }
 
 // src/commands/host/house-proxy-config.ts
-var fs51 = __toESM(require("fs"));
+var fs52 = __toESM(require("fs"));
 var os37 = __toESM(require("os"));
-var path59 = __toESM(require("path"));
+var path60 = __toESM(require("path"));
 function houseProxyConfigPath() {
-  return path59.join(os37.homedir(), ".codeam", "house-proxy.json");
+  return path60.join(os37.homedir(), ".codeam", "house-proxy.json");
 }
 var DEPLOY_ID_RE = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/;
 function deployHouseProxyConfigPath(deployId) {
   if (!DEPLOY_ID_RE.test(deployId) || deployId.includes("..")) return null;
-  return path59.join(os37.homedir(), ".codeam", "house-proxy", `${deployId}.json`);
+  return path60.join(os37.homedir(), ".codeam", "house-proxy", `${deployId}.json`);
 }
 function writeJson0600(file, value) {
-  fs51.mkdirSync(path59.dirname(file), { recursive: true, mode: 448 });
+  fs52.mkdirSync(path60.dirname(file), { recursive: true, mode: 448 });
   const tmp = `${file}.tmp-${process.pid}`;
-  fs51.writeFileSync(tmp, JSON.stringify(value, null, 2), { encoding: "utf8", mode: 384 });
-  fs51.renameSync(tmp, file);
+  fs52.writeFileSync(tmp, JSON.stringify(value, null, 2), { encoding: "utf8", mode: 384 });
+  fs52.renameSync(tmp, file);
   restrictToOwner(file);
 }
 function persistHouseProxyConfig(config, deployId) {
@@ -25237,7 +25285,7 @@ function persistHouseProxyConfig(config, deployId) {
 }
 function clearHouseProxyConfig(deployId) {
   try {
-    fs51.rmSync(houseProxyConfigPath(), { force: true });
+    fs52.rmSync(houseProxyConfigPath(), { force: true });
     const perDeploy = deployId ? deployHouseProxyConfigPath(deployId) : null;
     if (perDeploy) writeJson0600(perDeploy, { none: true });
   } catch {
@@ -25246,8 +25294,8 @@ function clearHouseProxyConfig(deployId) {
 function readHouseProxyChildEnv(deployId) {
   try {
     const perDeploy = deployId ? deployHouseProxyConfigPath(deployId) : null;
-    const file = perDeploy && fs51.existsSync(perDeploy) ? perDeploy : houseProxyConfigPath();
-    const raw = fs51.readFileSync(file, "utf8");
+    const file = perDeploy && fs52.existsSync(perDeploy) ? perDeploy : houseProxyConfigPath();
+    const raw = fs52.readFileSync(file, "utf8");
     const parsed = JSON.parse(raw);
     if (typeof parsed !== "object" || parsed === null) return {};
     const o = parsed;
@@ -25353,9 +25401,9 @@ function pickHouseProxyEnv(env) {
 }
 
 // src/lib/provider-routing.ts
-var fs52 = __toESM(require("fs"));
+var fs53 = __toESM(require("fs"));
 var os38 = __toESM(require("os"));
-var path60 = __toESM(require("path"));
+var path61 = __toESM(require("path"));
 var PROVIDER_BASE_URL_ENV_KEYS = [
   "ANTHROPIC_BASE_URL",
   "OPENAI_BASE_URL",
@@ -25378,14 +25426,14 @@ function redactUrlToOrigin(raw) {
 }
 function readOpencodeProviderOrigins(opts = {}) {
   const home = opts.homeDir ?? os38.homedir();
-  const readFile7 = opts.readFile ?? ((f) => fs52.readFileSync(f, "utf8"));
+  const readFile7 = opts.readFile ?? ((f) => fs53.readFileSync(f, "utf8"));
   const candidates = [];
   if (opts.cwd) {
-    candidates.push(path60.join(opts.cwd, "opencode.json"), path60.join(opts.cwd, "opencode.jsonc"));
+    candidates.push(path61.join(opts.cwd, "opencode.json"), path61.join(opts.cwd, "opencode.jsonc"));
   }
   candidates.push(
-    path60.join(home, ".config", "opencode", "opencode.json"),
-    path60.join(home, ".config", "opencode", "opencode.jsonc")
+    path61.join(home, ".config", "opencode", "opencode.json"),
+    path61.join(home, ".config", "opencode", "opencode.jsonc")
   );
   const out2 = [];
   const seen2 = /* @__PURE__ */ new Set();
@@ -25693,19 +25741,19 @@ function adapterExitMessage(opts) {
 
 // src/services/preview/start-orchestrator.ts
 var import_child_process20 = require("child_process");
-var fs55 = __toESM(require("fs"));
-var path63 = __toESM(require("path"));
+var fs56 = __toESM(require("fs"));
+var path64 = __toESM(require("path"));
 var import_which3 = __toESM(require("which"));
 
 // src/services/project-env/index.ts
 var import_fs6 = require("fs");
-var path62 = __toESM(require("path"));
+var path63 = __toESM(require("path"));
 
 // src/beads/project-key.ts
 var import_child_process19 = require("child_process");
 var crypto2 = __toESM(require("crypto"));
-var fs53 = __toESM(require("fs"));
-var path61 = __toESM(require("path"));
+var fs54 = __toESM(require("fs"));
+var path62 = __toESM(require("path"));
 function normalizeOrigin(raw) {
   const trimmed = raw.trim();
   if (!trimmed) return null;
@@ -25731,17 +25779,17 @@ function normalizeOrigin(raw) {
   return `${host2}/${pathPart}`;
 }
 function findRepoRoot(cwd) {
-  let dir = path61.resolve(cwd);
+  let dir = path62.resolve(cwd);
   const seen2 = /* @__PURE__ */ new Set();
   for (let i = 0; i < 256; i++) {
     if (seen2.has(dir)) return null;
     seen2.add(dir);
     try {
-      const stat3 = fs53.statSync(path61.join(dir, ".git"), { throwIfNoEntry: false });
+      const stat3 = fs54.statSync(path62.join(dir, ".git"), { throwIfNoEntry: false });
       if (stat3 && (stat3.isDirectory() || stat3.isFile())) return dir;
     } catch {
     }
-    const parent = path61.dirname(dir);
+    const parent = path62.dirname(dir);
     if (parent === dir) return null;
     dir = parent;
   }
@@ -25752,7 +25800,7 @@ var _execSeam3 = {
     const out2 = (0, import_child_process19.execFileSync)(file, args2, opts);
     return typeof out2 === "string" ? out2 : out2.toString("utf8");
   },
-  realpath: (p2) => fs53.realpathSync(p2)
+  realpath: (p2) => fs54.realpathSync(p2)
 };
 function readOrigin(cwd) {
   try {
@@ -25781,7 +25829,7 @@ function deriveProjectIdentity(cwd = process.cwd()) {
   } catch {
   }
   const hash = crypto2.createHash("sha256").update(real).digest("hex");
-  return { projectKey: `path:${hash}`, projectLabel: path61.basename(real) || "project" };
+  return { projectKey: `path:${hash}`, projectLabel: path62.basename(real) || "project" };
 }
 
 // src/services/project-env/index.ts
@@ -25794,7 +25842,7 @@ async function readIfExists(p2) {
 }
 async function syncProjectEnvUp(cwd, ctx) {
   if (!ctx.pluginAuthToken) return;
-  const content = await readIfExists(path62.join(cwd, ".env"));
+  const content = await readIfExists(path63.join(cwd, ".env"));
   if (content == null) return;
   try {
     const { projectKey, projectLabel } = deriveProjectIdentity(cwd);
@@ -25816,7 +25864,7 @@ async function syncProjectEnvUp(cwd, ctx) {
 }
 async function restoreProjectEnvIfMissing(cwd, ctx) {
   if (!ctx.pluginAuthToken) return false;
-  const envPath = path62.join(cwd, ".env");
+  const envPath = path63.join(cwd, ".env");
   if (await readIfExists(envPath) != null) return false;
   try {
     const { projectKey, projectLabel } = deriveProjectIdentity(cwd);
@@ -25827,7 +25875,7 @@ async function restoreProjectEnvIfMissing(cwd, ctx) {
       projectKey
     });
     if (!stored) return false;
-    const tmp = path62.join(cwd, ".env.codeam-restore.tmp");
+    const tmp = path63.join(cwd, ".env.codeam-restore.tmp");
     await import_fs6.promises.writeFile(tmp, stored.content, { encoding: "utf8", mode: 384 });
     await import_fs6.promises.rename(tmp, envPath);
     log.info("project-env", `restored .env (${stored.keyCount} vars) for ${projectLabel}`);
@@ -26591,8 +26639,8 @@ function normalizeDetectionForSpawn(detection, cwd) {
   if (args2.length === 0) return detection;
   const binName = args2[0];
   if (binName.startsWith("-")) return detection;
-  const binPath = path63.join(cwd, "node_modules", ".bin", binName);
-  if (!fs55.existsSync(binPath)) return detection;
+  const binPath = path64.join(cwd, "node_modules", ".bin", binName);
+  if (!fs56.existsSync(binPath)) return detection;
   return {
     ...detection,
     command: binPath,
@@ -27005,9 +27053,9 @@ async function bringUpPublicUrl(ctx, tunnelPort) {
 
 // src/beads/bd-adapter.ts
 var import_child_process21 = require("child_process");
-var fs56 = __toESM(require("fs"));
+var fs57 = __toESM(require("fs"));
 var os39 = __toESM(require("os"));
-var path64 = __toESM(require("path"));
+var path65 = __toESM(require("path"));
 var BD_PACKAGE = "@beads/bd";
 function resolveBundledBdBinary() {
   return _resolveSeam.resolveBundled();
@@ -27019,11 +27067,11 @@ function _defaultResolveBundled() {
   } catch {
     return null;
   }
-  const binDir = path64.join(path64.dirname(pkgJsonPath), "bin");
+  const binDir = path65.join(path65.dirname(pkgJsonPath), "bin");
   const binaryName = process.platform === "win32" ? "bd.exe" : "bd";
-  const binaryPath = path64.join(binDir, binaryName);
+  const binaryPath = path65.join(binDir, binaryName);
   try {
-    fs56.accessSync(binaryPath, fs56.constants.F_OK);
+    fs57.accessSync(binaryPath, fs57.constants.F_OK);
     return binaryPath;
   } catch {
     return null;
@@ -27033,13 +27081,13 @@ function resolveBdOnPath() {
   return _resolveSeam.resolveOnPath();
 }
 function _defaultResolveOnPath() {
-  const dirs = (process.env.PATH ?? "").split(path64.delimiter).filter(Boolean);
+  const dirs = (process.env.PATH ?? "").split(path65.delimiter).filter(Boolean);
   const candidates = process.platform === "win32" ? ["bd.exe", "bd.cmd", "bd"] : ["bd"];
   for (const dir of dirs) {
     for (const candidate of candidates) {
-      const full = path64.join(dir, candidate);
+      const full = path65.join(dir, candidate);
       try {
-        fs56.accessSync(full, fs56.constants.F_OK);
+        fs57.accessSync(full, fs57.constants.F_OK);
         return full;
       } catch {
       }
@@ -27216,9 +27264,9 @@ function coerceIssue(row, projectKey) {
 
 // src/beads/provisioner.ts
 var import_child_process24 = require("child_process");
-var fs58 = __toESM(require("fs"));
+var fs59 = __toESM(require("fs"));
 var os41 = __toESM(require("os"));
-var path66 = __toESM(require("path"));
+var path67 = __toESM(require("path"));
 
 // src/beads/install-bd.ts
 var import_child_process22 = require("child_process");
@@ -27283,9 +27331,9 @@ async function installBd(platform3 = process.platform) {
 
 // src/beads/install-dolt.ts
 var import_child_process23 = require("child_process");
-var fs57 = __toESM(require("fs"));
+var fs58 = __toESM(require("fs"));
 var os40 = __toESM(require("os"));
-var path65 = __toESM(require("path"));
+var path66 = __toESM(require("path"));
 var DOLT_INSTALL_SH_URL = "https://github.com/dolthub/dolt/releases/latest/download/install.sh";
 var DOLT_MSI_URL = "https://github.com/dolthub/dolt/releases/latest/download/dolt-windows-amd64.msi";
 function resolveDoltInstallStrategy(platform3) {
@@ -27381,7 +27429,7 @@ var _doltPathSeam = {
   },
   exists: (p2) => {
     try {
-      fs57.accessSync(p2, fs57.constants.F_OK);
+      fs58.accessSync(p2, fs58.constants.F_OK);
       return true;
     } catch {
       return false;
@@ -27392,7 +27440,7 @@ function doltBinaryNames(platform3) {
   return platform3 === "win32" ? ["dolt.exe", "dolt.cmd", "dolt"] : ["dolt"];
 }
 function knownDoltDirs(platform3) {
-  const P3 = platform3 === "win32" ? path65.win32 : path65.posix;
+  const P3 = platform3 === "win32" ? path66.win32 : path66.posix;
   const home = _doltPathSeam.homedir();
   if (platform3 === "win32") {
     return [
@@ -27408,7 +27456,7 @@ function knownDoltDirs(platform3) {
   ].filter(Boolean);
 }
 function ensureDoltResolvable(platform3 = process.platform) {
-  const P3 = platform3 === "win32" ? path65.win32 : path65.posix;
+  const P3 = platform3 === "win32" ? path66.win32 : path66.posix;
   const delim = platform3 === "win32" ? ";" : ":";
   const names = doltBinaryNames(platform3);
   const pathDirs = _doltPathSeam.getPath().split(delim).filter(Boolean);
@@ -27605,14 +27653,14 @@ var _linkSeam = {
   homedir: () => os41.homedir(),
   isWritableDir: (dir) => {
     try {
-      fs58.accessSync(dir, fs58.constants.W_OK);
+      fs59.accessSync(dir, fs59.constants.W_OK);
       return true;
     } catch {
       return false;
     }
   },
   ensureDir: (dir) => {
-    fs58.mkdirSync(dir, { recursive: true });
+    fs59.mkdirSync(dir, { recursive: true });
   },
   /**
    * A directory to symlink `bd` into so the AGENT's shell + Claude Code's
@@ -27633,9 +27681,9 @@ var _linkSeam = {
    * which `linkBdOntoPath` creates if missing.
    */
   cliBinDir: () => {
-    const pathDirs = (process.env.PATH ?? "").split(path66.delimiter).filter(Boolean);
+    const pathDirs = (process.env.PATH ?? "").split(path67.delimiter).filter(Boolean);
     const home = _linkSeam.homedir();
-    const localBin = home ? path66.join(home, ".local", "bin") : null;
+    const localBin = home ? path67.join(home, ".local", "bin") : null;
     if (localBin) {
       try {
         _linkSeam.ensureDir(localBin);
@@ -27645,16 +27693,16 @@ var _linkSeam = {
     const candidates = [];
     if (localBin) candidates.push(localBin);
     try {
-      candidates.push(path66.dirname(process.execPath));
+      candidates.push(path67.dirname(process.execPath));
     } catch {
     }
     candidates.push("/usr/local/bin");
     const entry = process.argv[1];
     if (entry) {
       try {
-        candidates.push(path66.dirname(fs58.realpathSync(entry)));
+        candidates.push(path67.dirname(fs59.realpathSync(entry)));
       } catch {
-        candidates.push(path66.dirname(entry));
+        candidates.push(path67.dirname(entry));
       }
     }
     const onPathWritable = candidates.find(
@@ -27666,20 +27714,20 @@ var _linkSeam = {
   /** Current symlink target at `linkPath`, or null when absent / not a link. */
   readlink: (linkPath) => {
     try {
-      return fs58.readlinkSync(linkPath);
+      return fs59.readlinkSync(linkPath);
     } catch {
       return null;
     }
   },
-  unlink: (linkPath) => fs58.unlinkSync(linkPath),
-  symlink: (target, linkPath) => fs58.symlinkSync(target, linkPath)
+  unlink: (linkPath) => fs59.unlinkSync(linkPath),
+  symlink: (target, linkPath) => fs59.symlinkSync(target, linkPath)
 };
 function linkBdOntoPath(binaryPath) {
   if (_linkSeam.platform() === "win32") return;
   const binDir = _linkSeam.cliBinDir();
   if (!binDir) return;
   _linkSeam.ensureDir(binDir);
-  const linkPath = path66.join(binDir, "bd");
+  const linkPath = path67.join(binDir, "bd");
   if (linkPath === binaryPath) return;
   const current2 = _linkSeam.readlink(linkPath);
   if (current2 === binaryPath) return;
@@ -27893,16 +27941,16 @@ function dedupeRecipes(agents) {
 }
 function ensureLocalGitExclude(cwd, patterns) {
   try {
-    const gitDir = path66.join(cwd, ".git");
-    if (!fs58.statSync(gitDir).isDirectory()) return;
-    const file = path66.join(gitDir, "info", "exclude");
-    fs58.mkdirSync(path66.dirname(file), { recursive: true });
-    const current2 = fs58.existsSync(file) ? fs58.readFileSync(file, "utf8") : "";
+    const gitDir = path67.join(cwd, ".git");
+    if (!fs59.statSync(gitDir).isDirectory()) return;
+    const file = path67.join(gitDir, "info", "exclude");
+    fs59.mkdirSync(path67.dirname(file), { recursive: true });
+    const current2 = fs59.existsSync(file) ? fs59.readFileSync(file, "utf8") : "";
     const have = new Set(current2.split(/\r?\n/).map((l) => l.trim()));
     const missing = patterns.filter((p2) => !have.has(p2));
     if (missing.length === 0) return;
     const prefix = current2.length > 0 && !current2.endsWith("\n") ? "\n" : "";
-    fs58.appendFileSync(file, `${prefix}# CodeAgent: beads state stays local
+    fs59.appendFileSync(file, `${prefix}# CodeAgent: beads state stays local
 ${missing.join("\n")}
 `);
   } catch {
@@ -27911,7 +27959,7 @@ ${missing.join("\n")}
 
 // src/beads/watcher.ts
 var crypto4 = __toESM(require("crypto"));
-var path67 = __toESM(require("path"));
+var path68 = __toESM(require("path"));
 var API_BASE5 = resolveApiBaseUrl();
 var DEBOUNCE_MS2 = 400;
 var ZERO_SUMMARY = {
@@ -27935,7 +27983,7 @@ var BeadsWatcher = class {
   constructor(opts) {
     this.opts = opts;
     this.bd = opts.adapter ?? new BdAdapter({ cwd: opts.cwd, beadsDir: opts.beadsDir });
-    this.feedPath = opts.feedPath ?? path67.join(opts.cwd ?? process.cwd(), ".beads", "last-touched");
+    this.feedPath = opts.feedPath ?? path68.join(opts.cwd ?? process.cwd(), ".beads", "last-touched");
     this.apiBase = opts.apiBaseUrl ?? API_BASE5;
   }
   opts;
@@ -28186,15 +28234,15 @@ async function handleBeadsActionCommand(action, started) {
 }
 
 // src/beads/config-store.ts
-var import_node_fs14 = __toESM(require("fs"));
+var import_node_fs15 = __toESM(require("fs"));
 var import_node_os8 = __toESM(require("os"));
-var import_node_path13 = __toESM(require("path"));
+var import_node_path14 = __toESM(require("path"));
 function beadsConfigPath() {
-  return import_node_path13.default.join(import_node_os8.default.homedir(), ".codeam", "beads-config.json");
+  return import_node_path14.default.join(import_node_os8.default.homedir(), ".codeam", "beads-config.json");
 }
 function readBeadsEnabled() {
   try {
-    const raw = import_node_fs14.default.readFileSync(beadsConfigPath(), "utf8");
+    const raw = import_node_fs15.default.readFileSync(beadsConfigPath(), "utf8");
     const cfg = JSON.parse(raw);
     return cfg.enabled !== false;
   } catch {
@@ -28203,10 +28251,10 @@ function readBeadsEnabled() {
 }
 function persistBeadsConfig(cfg) {
   const file = beadsConfigPath();
-  import_node_fs14.default.mkdirSync(import_node_path13.default.dirname(file), { recursive: true });
+  import_node_fs15.default.mkdirSync(import_node_path14.default.dirname(file), { recursive: true });
   const tmp = `${file}.tmp`;
-  import_node_fs14.default.writeFileSync(tmp, JSON.stringify(cfg), { mode: 384 });
-  import_node_fs14.default.renameSync(tmp, file);
+  import_node_fs15.default.writeFileSync(tmp, JSON.stringify(cfg), { mode: 384 });
+  import_node_fs15.default.renameSync(tmp, file);
   restrictToOwner(file);
 }
 
@@ -28345,12 +28393,12 @@ async function configureBeads(action, ctx, deps) {
 var import_node_os11 = __toESM(require("os"));
 
 // src/skills/materialize.ts
-var import_node_fs15 = __toESM(require("fs"));
+var import_node_fs16 = __toESM(require("fs"));
 var import_node_os9 = __toESM(require("os"));
-var import_node_path14 = __toESM(require("path"));
+var import_node_path15 = __toESM(require("path"));
 var NS = "codeam-";
 function skillDirFor(id, home = import_node_os9.default.homedir()) {
-  return import_node_path14.default.join(home, ".claude", "skills", `${NS}${id}`);
+  return import_node_path15.default.join(home, ".claude", "skills", `${NS}${id}`);
 }
 function renderSkillMd(id, description, body) {
   const desc = description.replace(/\s*\n\s*/g, " ").trim();
@@ -28367,21 +28415,21 @@ function materializeSkill(id, home = import_node_os9.default.homedir()) {
   if (!def?.delivery.skillFile) return false;
   try {
     const dir = skillDirFor(id, home);
-    import_node_fs15.default.mkdirSync(dir, { recursive: true, mode: 448 });
-    import_node_fs15.default.writeFileSync(
-      import_node_path14.default.join(dir, "SKILL.md"),
+    import_node_fs16.default.mkdirSync(dir, { recursive: true, mode: 448 });
+    import_node_fs16.default.writeFileSync(
+      import_node_path15.default.join(dir, "SKILL.md"),
       renderSkillMd(id, def.description, def.delivery.skillFile.body),
       { encoding: "utf8", mode: 384 }
     );
-    const baseDir = import_node_path14.default.resolve(dir);
-    const baseDirWithSep = baseDir + import_node_path14.default.sep;
+    const baseDir = import_node_path15.default.resolve(dir);
+    const baseDirWithSep = baseDir + import_node_path15.default.sep;
     for (const [rel, contents] of Object.entries(def.delivery.skillFile.files ?? {})) {
-      const target = import_node_path14.default.join(dir, rel);
-      if (!import_node_path14.default.resolve(target).startsWith(baseDirWithSep) && import_node_path14.default.resolve(target) !== baseDir) {
+      const target = import_node_path15.default.join(dir, rel);
+      if (!import_node_path15.default.resolve(target).startsWith(baseDirWithSep) && import_node_path15.default.resolve(target) !== baseDir) {
         continue;
       }
-      import_node_fs15.default.mkdirSync(import_node_path14.default.dirname(target), { recursive: true, mode: 448 });
-      import_node_fs15.default.writeFileSync(target, contents, { encoding: "utf8", mode: 384 });
+      import_node_fs16.default.mkdirSync(import_node_path15.default.dirname(target), { recursive: true, mode: 448 });
+      import_node_fs16.default.writeFileSync(target, contents, { encoding: "utf8", mode: 384 });
     }
     return true;
   } catch (err) {
@@ -28391,21 +28439,21 @@ function materializeSkill(id, home = import_node_os9.default.homedir()) {
 }
 function removeSkill(id, home = import_node_os9.default.homedir()) {
   try {
-    import_node_fs15.default.rmSync(skillDirFor(id, home), { recursive: true, force: true });
+    import_node_fs16.default.rmSync(skillDirFor(id, home), { recursive: true, force: true });
   } catch {
   }
 }
 
 // src/skills/manifest.ts
-var import_node_fs16 = __toESM(require("fs"));
+var import_node_fs17 = __toESM(require("fs"));
 var import_node_os10 = __toESM(require("os"));
-var import_node_path15 = __toESM(require("path"));
+var import_node_path16 = __toESM(require("path"));
 function skillsManifestPath() {
-  return import_node_path15.default.join(import_node_os10.default.homedir(), ".codeam", "skills.json");
+  return import_node_path16.default.join(import_node_os10.default.homedir(), ".codeam", "skills.json");
 }
 function readSkillsManifest() {
   try {
-    const raw = JSON.parse(import_node_fs16.default.readFileSync(skillsManifestPath(), "utf8"));
+    const raw = JSON.parse(import_node_fs17.default.readFileSync(skillsManifestPath(), "utf8"));
     if (!Array.isArray(raw?.skills)) return null;
     raw.skills = raw.skills.filter(
       (s) => Boolean(s) && typeof s === "object" && typeof s.id === "string"
@@ -28418,10 +28466,10 @@ function readSkillsManifest() {
 function persistSkillsManifest(m) {
   try {
     const file = skillsManifestPath();
-    import_node_fs16.default.mkdirSync(import_node_path15.default.dirname(file), { recursive: true, mode: 448 });
+    import_node_fs17.default.mkdirSync(import_node_path16.default.dirname(file), { recursive: true, mode: 448 });
     const tmp = `${file}.tmp-${process.pid}`;
-    import_node_fs16.default.writeFileSync(tmp, JSON.stringify(m, null, 2), { encoding: "utf8", mode: 384 });
-    import_node_fs16.default.renameSync(tmp, file);
+    import_node_fs17.default.writeFileSync(tmp, JSON.stringify(m, null, 2), { encoding: "utf8", mode: 384 });
+    import_node_fs17.default.renameSync(tmp, file);
     restrictToOwner(file);
   } catch (err) {
     log.warn(
@@ -28432,7 +28480,7 @@ function persistSkillsManifest(m) {
 }
 function clearSkillsManifest() {
   try {
-    import_node_fs16.default.rmSync(skillsManifestPath(), { force: true });
+    import_node_fs17.default.rmSync(skillsManifestPath(), { force: true });
   } catch {
   }
 }
@@ -28475,8 +28523,8 @@ function cleanupAttachmentTempFiles() {
 function saveFilesTemp(files) {
   return files.filter(({ base64 }) => base64 && base64.length > 0).map(({ filename, base64 }) => {
     const safeName = filename.replace(/[^a-zA-Z0-9._-]/g, "_").slice(0, 80);
-    const tmpPath = path71.join(os46.tmpdir(), `codeam-${(0, import_crypto3.randomUUID)()}-${safeName}`);
-    fs62.writeFileSync(tmpPath, Buffer.from(base64, "base64"));
+    const tmpPath = path72.join(os46.tmpdir(), `codeam-${(0, import_crypto3.randomUUID)()}-${safeName}`);
+    fs63.writeFileSync(tmpPath, Buffer.from(base64, "base64"));
     pendingAttachmentFiles.add(tmpPath);
     return tmpPath;
   });
@@ -28721,10 +28769,10 @@ var listFiles = async (ctx, cmd, parsed) => {
   await ctx.relay.sendResult(cmd.id, "completed", result);
 };
 var envReadH = async (ctx, cmd) => {
-  const envPath = path71.join(process.cwd(), ".env");
+  const envPath = path72.join(process.cwd(), ".env");
   await restoreProjectEnvIfMissing(process.cwd(), ctx);
   try {
-    const raw = await fs62.promises.readFile(envPath, "utf8");
+    const raw = await fs63.promises.readFile(envPath, "utf8");
     await ctx.relay.sendResult(cmd.id, "completed", {
       exists: true,
       vars: parseDotenv(raw)
@@ -28753,7 +28801,7 @@ var envParseH = async (ctx, cmd, parsed) => {
   const existing = /* @__PURE__ */ new Map();
   if (!replace) {
     try {
-      const raw = await fs62.promises.readFile(path71.join(process.cwd(), ".env"), "utf8");
+      const raw = await fs63.promises.readFile(path72.join(process.cwd(), ".env"), "utf8");
       for (const v of parseDotenv(raw)) existing.set(v.key, v.value);
     } catch {
     }
@@ -28793,15 +28841,15 @@ var envWriteH = async (ctx, cmd, parsed) => {
     }
     seen2.add(v.key);
   }
-  const envPath = path71.join(process.cwd(), ".env");
-  const tmpPath = path71.join(process.cwd(), ".env.codeam.tmp");
+  const envPath = path72.join(process.cwd(), ".env");
+  const tmpPath = path72.join(process.cwd(), ".env.codeam.tmp");
   try {
-    await fs62.promises.writeFile(tmpPath, serializeDotenv(vars), "utf8");
-    await fs62.promises.rename(tmpPath, envPath);
+    await fs63.promises.writeFile(tmpPath, serializeDotenv(vars), "utf8");
+    await fs63.promises.rename(tmpPath, envPath);
     await ctx.relay.sendResult(cmd.id, "completed", { ok: true, count: vars.length });
     void syncProjectEnvUp(process.cwd(), ctx);
   } catch (err) {
-    await fs62.promises.rm(tmpPath, { force: true }).catch(() => void 0);
+    await fs63.promises.rm(tmpPath, { force: true }).catch(() => void 0);
     await ctx.relay.sendResult(cmd.id, "failed", { error: err.message });
   }
 };
@@ -29150,9 +29198,9 @@ var CLI_UPDATE_MAX_ATTEMPTS = 3;
 function buildNpmInstallInvocation(opts) {
   const entryScript = opts?.entryScript ?? process.argv[1] ?? "";
   const execPath = opts?.execPath ?? process.execPath;
-  const exists2 = opts?.existsSync ?? fs62.existsSync;
+  const exists2 = opts?.existsSync ?? fs63.existsSync;
   const platform3 = opts?.platform ?? process.platform;
-  const p2 = platform3 === "win32" ? path71.win32 : path71.posix;
+  const p2 = platform3 === "win32" ? path72.win32 : path72.posix;
   const normalized = entryScript.split(/[\\/]/).join("/");
   const marker = "/lib/node_modules/codeam-cli/";
   const markerIdx = normalized.indexOf(marker);
@@ -29171,7 +29219,7 @@ function isPermissionError(stderr) {
 function resolveGlobalNodeModulesDir(opts) {
   const entryScript = opts?.entryScript ?? process.argv[1] ?? "";
   const platform3 = opts?.platform ?? process.platform;
-  const p2 = platform3 === "win32" ? path71.win32 : path71.posix;
+  const p2 = platform3 === "win32" ? path72.win32 : path72.posix;
   const marker = "/lib/node_modules/codeam-cli/";
   const markerIdx = entryScript.split(/[\\/]/).join("/").indexOf(marker);
   if (markerIdx <= 0) return null;
@@ -29181,9 +29229,9 @@ function resolveGlobalNodeModulesDir(opts) {
 var STALE_STAGING_AGE_MS = CLI_UPDATE_INSTALL_TIMEOUT_MS;
 function sweepStaleCliStagingDirs(nodeModulesDir, now = Date.now(), deps) {
   if (!nodeModulesDir) return 0;
-  const readdirSync17 = deps?.readdirSync ?? fs62.readdirSync;
-  const statSync16 = deps?.statSync ?? fs62.statSync;
-  const rmSync11 = deps?.rmSync ?? fs62.rmSync;
+  const readdirSync17 = deps?.readdirSync ?? fs63.readdirSync;
+  const statSync16 = deps?.statSync ?? fs63.statSync;
+  const rmSync11 = deps?.rmSync ?? fs63.rmSync;
   let removed = 0;
   let entries2;
   try {
@@ -29193,7 +29241,7 @@ function sweepStaleCliStagingDirs(nodeModulesDir, now = Date.now(), deps) {
   }
   for (const name of entries2) {
     if (!/^\.codeam-cli-/.test(name)) continue;
-    const full = path71.join(nodeModulesDir, name);
+    const full = path72.join(nodeModulesDir, name);
     try {
       const st3 = statSync16(full);
       if (now - st3.mtimeMs < STALE_STAGING_AGE_MS) continue;
@@ -29612,6 +29660,14 @@ async function resolvePreviewDetection(args2) {
       payload: originPayload(payload, origin)
     });
   };
+  if (isEmptyScratchProject(process.cwd())) {
+    log.info("preview", "detect: empty scratch project \u2014 nothing to preview yet");
+    emit2(USER_EVENTS.PREVIEW_ERROR, {
+      stage: "unsupported",
+      message: "Nothing to preview yet \u2014 this project is empty. Ask your agent to build something and it opens the preview."
+    });
+    return null;
+  }
   if (typeof runtime.generateOneShot !== "function") {
     log.info("preview", `runtime ${runtime.id} has no generateOneShot \u2014 emitting unsupported`);
     emit2(USER_EVENTS.PREVIEW_ERROR, {
@@ -29809,6 +29865,7 @@ async function offerScratchSaveOnce(ctx, pluginAuthToken) {
 }
 function startPreviewFromDetection(ctx, detection, pluginAuthToken, opts = {}) {
   previewRequestedInProcess = true;
+  notePreviewBringUp(ctx.sessionId);
   const emit2 = (type, payload) => {
     const tagged = originPayload(payload, opts.origin) ?? {};
     opts.onEvent?.(type, tagged);
@@ -30307,11 +30364,11 @@ function resolveTokenValue(args2) {
   }
   const fileFlag = args2.find((a) => a.startsWith("--token-file="));
   if (fileFlag) {
-    const path108 = fileFlag.slice("--token-file=".length);
+    const path109 = fileFlag.slice("--token-file=".length);
     try {
-      const content = fs63.readFileSync(path108, "utf8").trim();
-      if (content.length === 0) fail(`--token-file ${path108} is empty`);
-      rmIfExistsQuiet(path108);
+      const content = fs64.readFileSync(path109, "utf8").trim();
+      if (content.length === 0) fail(`--token-file ${path109} is empty`);
+      rmIfExistsQuiet(path109);
       return content;
     } catch (err) {
       fail(`Could not read --token-file: ${err.message}`);
@@ -30403,12 +30460,12 @@ async function claim(token, pluginId, pluginSecretHash) {
   }
 }
 function pairAutoLockPath() {
-  return path72.join(os47.homedir(), ".codeam", "pair-auto.lock");
+  return path73.join(os47.homedir(), ".codeam", "pair-auto.lock");
 }
 var procRoot = "/proc";
 function readProcFile(rel) {
   try {
-    return fs63.readFileSync(path72.join(procRoot, rel), "utf8");
+    return fs64.readFileSync(path73.join(procRoot, rel), "utf8");
   } catch {
     return void 0;
   }
@@ -30429,7 +30486,7 @@ function currentBootId() {
 function readLockRecord(lockPath) {
   let raw;
   try {
-    raw = fs63.readFileSync(lockPath, "utf8");
+    raw = fs64.readFileSync(lockPath, "utf8");
   } catch {
     return void 0;
   }
@@ -30478,7 +30535,7 @@ function isLiveLockHolder(rec) {
 }
 function releaseOwnLock(lockPath) {
   try {
-    if (readLockRecord(lockPath)?.pid === process.pid) fs63.unlinkSync(lockPath);
+    if (readLockRecord(lockPath)?.pid === process.pid) fs64.unlinkSync(lockPath);
   } catch {
   }
 }
@@ -30502,7 +30559,7 @@ function snapshotProcessTree(root) {
   const children = /* @__PURE__ */ new Map();
   let entries2 = [];
   try {
-    entries2 = fs63.readdirSync(procRoot).filter((e) => /^\d+$/.test(e));
+    entries2 = fs64.readdirSync(procRoot).filter((e) => /^\d+$/.test(e));
   } catch {
   }
   for (const e of entries2) {
@@ -30537,18 +30594,18 @@ function signalProcessTree(refs, signal) {
 }
 function daemonLockPath(sessionId) {
   const safe = sessionId.replace(/[^a-zA-Z0-9_-]/g, "_");
-  return path72.join(os47.homedir(), ".codeam", `daemon-${safe}.lock`);
+  return path73.join(os47.homedir(), ".codeam", `daemon-${safe}.lock`);
 }
 function acquireDaemonLock(sessionId) {
   const lockPath = daemonLockPath(sessionId);
   try {
-    fs63.mkdirSync(path72.dirname(lockPath), { recursive: true });
+    fs64.mkdirSync(path73.dirname(lockPath), { recursive: true });
     try {
-      fs63.writeFileSync(lockPath, ownLockBody(), { flag: "wx" });
+      fs64.writeFileSync(lockPath, ownLockBody(), { flag: "wx" });
     } catch (e) {
       if (e.code !== "EEXIST") throw e;
       if (isLiveLockHolder(readLockRecord(lockPath))) return false;
-      fs63.writeFileSync(lockPath, ownLockBody());
+      fs64.writeFileSync(lockPath, ownLockBody());
     }
     const release3 = () => releaseOwnLock(lockPath);
     process.once("exit", release3);
@@ -30568,13 +30625,13 @@ function acquireDaemonLock(sessionId) {
 function acquireSingletonLock() {
   const lockPath = pairAutoLockPath();
   try {
-    fs63.mkdirSync(path72.dirname(lockPath), { recursive: true });
+    fs64.mkdirSync(path73.dirname(lockPath), { recursive: true });
     try {
-      fs63.writeFileSync(lockPath, ownLockBody(), { flag: "wx" });
+      fs64.writeFileSync(lockPath, ownLockBody(), { flag: "wx" });
     } catch (e) {
       if (e.code !== "EEXIST") throw e;
       if (isLiveLockHolder(readLockRecord(lockPath))) return false;
-      fs63.writeFileSync(lockPath, ownLockBody());
+      fs64.writeFileSync(lockPath, ownLockBody());
     }
     process.once("exit", () => releaseOwnLock(lockPath));
     return true;
@@ -30991,15 +31048,15 @@ var AgentService = class _AgentService {
 };
 
 // src/agents/acp/adapters.ts
-var path73 = __toESM(require("path"));
+var path74 = __toESM(require("path"));
 
 // src/agents/kimi/installer.ts
 var import_node_child_process25 = require("child_process");
 var import_node_os12 = require("os");
-var import_node_path16 = require("path");
+var import_node_path17 = require("path");
 var INSTALL_URL2 = "https://code.kimi.com/kimi-code/install.sh";
 function kimiBinDir() {
-  return (0, import_node_path16.join)(process.env.KIMI_CODE_HOME || (0, import_node_path16.join)((0, import_node_os12.homedir)(), ".kimi-code"), "bin");
+  return (0, import_node_path17.join)(process.env.KIMI_CODE_HOME || (0, import_node_path17.join)((0, import_node_os12.homedir)(), ".kimi-code"), "bin");
 }
 function kimiRuns() {
   const r = (0, import_node_child_process25.spawnSync)("kimi", ["--version"], { stdio: "ignore", timeout: 15e3 });
@@ -31049,10 +31106,10 @@ async function ensureKimiInstalled() {
 // src/agents/opencode/installer.ts
 var import_node_child_process26 = require("child_process");
 var import_node_os13 = require("os");
-var import_node_path17 = require("path");
+var import_node_path18 = require("path");
 var INSTALL_URL3 = "https://opencode.ai/install";
 function opencodeBinDir() {
-  return (0, import_node_path17.join)(process.env.OPENCODE_HOME || (0, import_node_path17.join)((0, import_node_os13.homedir)(), ".opencode"), "bin");
+  return (0, import_node_path18.join)(process.env.OPENCODE_HOME || (0, import_node_path18.join)((0, import_node_os13.homedir)(), ".opencode"), "bin");
 }
 function opencodeRuns() {
   const r = (0, import_node_child_process26.spawnSync)("opencode", ["--version"], { stdio: "ignore", timeout: 15e3 });
@@ -31111,13 +31168,13 @@ function resolveBin(pkgName, binName) {
   try {
     const manifestPath = require_.resolve(`${pkgName}/package.json`);
     const manifest = require_(`${pkgName}/package.json`);
-    const pkgDir = path73.dirname(manifestPath);
+    const pkgDir = path74.dirname(manifestPath);
     const bin = manifest.bin;
     if (!bin) return null;
-    if (typeof bin === "string") return path73.resolve(pkgDir, bin);
+    if (typeof bin === "string") return path74.resolve(pkgDir, bin);
     const target = binName ?? Object.keys(bin)[0];
     if (!target || !bin[target]) return null;
-    return path73.resolve(pkgDir, bin[target]);
+    return path74.resolve(pkgDir, bin[target]);
   } catch {
     return null;
   }
@@ -31298,9 +31355,9 @@ async function resolveAcpAdapterWithRetry(agent, opts = {}) {
 
 // src/agents/acp/runner.ts
 var import_node_crypto15 = require("crypto");
-var fs81 = __toESM(require("fs"));
+var fs83 = __toESM(require("fs"));
 var os59 = __toESM(require("os"));
-var path92 = __toESM(require("path"));
+var path94 = __toESM(require("path"));
 
 // src/agents/acp/provider-billing-signal.ts
 var seen = /* @__PURE__ */ new Set();
@@ -31332,8 +31389,8 @@ function noteProviderBillingSignal(opts) {
 }
 
 // src/services/history.service.ts
-var fs64 = __toESM(require("fs"));
-var path74 = __toESM(require("path"));
+var fs65 = __toESM(require("fs"));
+var path75 = __toESM(require("path"));
 var https6 = __toESM(require("https"));
 var http10 = __toESM(require("http"));
 var import_zod2 = require("zod");
@@ -31394,7 +31451,7 @@ function parseJsonl(filePath) {
   const messages = [];
   let raw;
   try {
-    raw = fs64.readFileSync(filePath, "utf8");
+    raw = fs65.readFileSync(filePath, "utf8");
   } catch (err) {
     if (err.code !== "ENOENT") {
       log.warn("history:parseJsonl", `read failed for ${filePath}`, err);
@@ -31554,7 +31611,7 @@ var HistoryService = class _HistoryService {
     // session-start upload answered false, the active-conversation pointer was
     // never re-pointed after a Box wake, and the app opened an empty "New
     // conversation" over the resumed one (QA box, 2026-09-29).
-    path74.join(claudeConfigDir(), "projects", encodeCwd(this.cwd));
+    path75.join(claudeConfigDir(), "projects", encodeCwd(this.cwd));
   }
   /** Set the current Claude conversation ID (extracted from /cost command or session start) */
   setCurrentConversationId(id) {
@@ -31566,7 +31623,7 @@ var HistoryService = class _HistoryService {
   /** Return the current message count in the active conversation. */
   getCurrentMessageCount() {
     if (!this.currentConversationId) return 0;
-    const filePath = path74.join(this.projectDir, `${this.currentConversationId}.jsonl`);
+    const filePath = path75.join(this.projectDir, `${this.currentConversationId}.jsonl`);
     return parseJsonl(filePath).length;
   }
   /**
@@ -31577,7 +31634,7 @@ var HistoryService = class _HistoryService {
     const deadline = Date.now() + timeoutMs;
     while (Date.now() < deadline) {
       if (!this.currentConversationId) return null;
-      const filePath = path74.join(this.projectDir, `${this.currentConversationId}.jsonl`);
+      const filePath = path75.join(this.projectDir, `${this.currentConversationId}.jsonl`);
       const messages = parseJsonl(filePath);
       if (messages.length > previousCount) {
         for (let i = messages.length - 1; i >= previousCount; i--) {
@@ -31604,18 +31661,18 @@ var HistoryService = class _HistoryService {
     const cutoff = this.bootTimeMs - _HistoryService.BIRTHTIME_GRACE_MS;
     const oneShots = readOneShotConversations(this.cwd);
     try {
-      const files = fs64.readdirSync(dir, { withFileTypes: true }).filter(
-        (e) => e.isFile() && e.name.endsWith(".jsonl") && !oneShots.has(path74.basename(e.name, ".jsonl"))
+      const files = fs65.readdirSync(dir, { withFileTypes: true }).filter(
+        (e) => e.isFile() && e.name.endsWith(".jsonl") && !oneShots.has(path75.basename(e.name, ".jsonl"))
       ).map((e) => {
         try {
-          const stat3 = fs64.statSync(path74.join(dir, e.name));
+          const stat3 = fs65.statSync(path75.join(dir, e.name));
           return { name: e.name, mtime: stat3.mtimeMs, birthtime: stat3.birthtimeMs };
         } catch {
           return { name: e.name, mtime: 0, birthtime: 0 };
         }
       }).filter((f) => f.birthtime >= cutoff).sort((a, b) => b.mtime - a.mtime);
       if (files.length > 0) {
-        this.currentConversationId = path74.basename(files[0].name, ".jsonl");
+        this.currentConversationId = path75.basename(files[0].name, ".jsonl");
       }
     } catch {
     }
@@ -31649,13 +31706,13 @@ var HistoryService = class _HistoryService {
     const cutoff = this.bootTimeMs - _HistoryService.BIRTHTIME_GRACE_MS;
     let entries2;
     try {
-      entries2 = fs64.readdirSync(dir, { withFileTypes: true });
+      entries2 = fs65.readdirSync(dir, { withFileTypes: true });
     } catch {
       return null;
     }
     const files = entries2.filter((e) => e.isFile() && e.name.endsWith(".jsonl")).map((e) => {
       try {
-        const stat3 = fs64.statSync(path74.join(dir, e.name));
+        const stat3 = fs65.statSync(path75.join(dir, e.name));
         return { name: e.name, mtime: stat3.mtimeMs, birthtime: stat3.birthtimeMs };
       } catch {
         return { name: e.name, mtime: 0, birthtime: 0 };
@@ -31664,12 +31721,12 @@ var HistoryService = class _HistoryService {
     if (files.length === 0) return null;
     const targetFile = this.currentConversationId ? `${this.currentConversationId}.jsonl` : files[0].name;
     if (!files.some((f) => f.name === targetFile)) return null;
-    return this.extractUsageFromFile(path74.join(dir, targetFile));
+    return this.extractUsageFromFile(path75.join(dir, targetFile));
   }
   extractUsageFromFile(filePath) {
     let raw;
     try {
-      raw = fs64.readFileSync(filePath, "utf8");
+      raw = fs65.readFileSync(filePath, "utf8");
     } catch {
       return null;
     }
@@ -31721,9 +31778,9 @@ var HistoryService = class _HistoryService {
     let totalCost = 0;
     let files;
     try {
-      files = fs64.readdirSync(projectDir).filter((f) => f.endsWith(".jsonl")).filter((f) => {
+      files = fs65.readdirSync(projectDir).filter((f) => f.endsWith(".jsonl")).filter((f) => {
         try {
-          return fs64.statSync(path74.join(projectDir, f)).mtimeMs >= monthStartMs;
+          return fs65.statSync(path75.join(projectDir, f)).mtimeMs >= monthStartMs;
         } catch {
           return false;
         }
@@ -31734,7 +31791,7 @@ var HistoryService = class _HistoryService {
     for (const file of files) {
       let raw;
       try {
-        raw = fs64.readFileSync(path74.join(projectDir, file), "utf8");
+        raw = fs65.readFileSync(path75.join(projectDir, file), "utf8");
       } catch {
         continue;
       }
@@ -31813,7 +31870,7 @@ var HistoryService = class _HistoryService {
     if (this.runtime.resolveHistoryFile) {
       return this.runtime.resolveHistoryFile(this.cwd, sessionId);
     }
-    return path74.join(this.projectDir, `${sessionId}.jsonl`);
+    return path75.join(this.projectDir, `${sessionId}.jsonl`);
   }
   /**
    * Parse a conversation's messages from disk, agent-aware. Claude uses the
@@ -31851,7 +31908,7 @@ var HistoryService = class _HistoryService {
         };
       });
     }
-    return parseJsonl(path74.join(this.projectDir, `${sessionId}.jsonl`));
+    return parseJsonl(path75.join(this.projectDir, `${sessionId}.jsonl`));
   }
   /** One in-flight full upload per conversation — the baton mirror and a
    *  `get_conversation` used to upload the same transcript concurrently. */
@@ -31933,7 +31990,7 @@ var HistoryService = class _HistoryService {
     if (!filePath) return false;
     let mtimeMs;
     try {
-      mtimeMs = fs64.statSync(filePath).mtimeMs;
+      mtimeMs = fs65.statSync(filePath).mtimeMs;
     } catch {
       return false;
     }
@@ -32008,10 +32065,10 @@ var HistoryService = class _HistoryService {
 
 // src/agents/acp/client.ts
 var import_node_child_process27 = require("child_process");
-var fs65 = __toESM(require("fs/promises"));
+var fs66 = __toESM(require("fs/promises"));
 var fsSync = __toESM(require("fs"));
 var os49 = __toESM(require("os"));
-var path76 = __toESM(require("path"));
+var path77 = __toESM(require("path"));
 var import_node_stream = require("stream");
 
 // ../../node_modules/@agentclientprotocol/sdk/dist/schema/index.js
@@ -36037,7 +36094,7 @@ function createIdleTimeout(idleMs, makeError, activeIdleMs = idleMs) {
 }
 
 // src/agents/acp/internal-paths.ts
-var path75 = __toESM(require("path"));
+var path76 = __toESM(require("path"));
 var os48 = __toESM(require("os"));
 var INTERNAL_TOKENS = [".codeam", "house-claude"];
 var PROSE_ONLY_TOOL_KINDS = /* @__PURE__ */ new Set(["think", "switch_mode"]);
@@ -36052,11 +36109,11 @@ function textReferencesInternal(text) {
 }
 function pathIsInternal(p2, homeDir2 = os48.homedir()) {
   if (!p2) return false;
-  const abs = path75.resolve(p2);
-  const home = path75.resolve(homeDir2);
-  const within = (root) => abs === root || abs.startsWith(root + path75.sep);
-  if (within(path75.join(home, ".codeam", "self-hosted"))) return false;
-  return within(path75.join(home, ".codeam")) || within(path75.join(home, ".beads")) || abs === path75.join(home, ".codeam-host.log") || abs.includes(`${path75.sep}house-claude${path75.sep}`) || abs.endsWith(`${path75.sep}house-claude`);
+  const abs = path76.resolve(p2);
+  const home = path76.resolve(homeDir2);
+  const within = (root) => abs === root || abs.startsWith(root + path76.sep);
+  if (within(path76.join(home, ".codeam", "self-hosted"))) return false;
+  return within(path76.join(home, ".codeam")) || within(path76.join(home, ".beads")) || abs === path76.join(home, ".codeam-host.log") || abs.includes(`${path76.sep}house-claude${path76.sep}`) || abs.endsWith(`${path76.sep}house-claude`);
 }
 function toolCallReferencesInternal(call, homeDir2) {
   if (call.locations?.some((l) => pathIsInternal(l.path, homeDir2))) return true;
@@ -37152,7 +37209,7 @@ var AcpClient = class {
           throw new RequestError(-32002, GUARDRAIL_SECRET_READ_BLOCK_REASON, { uri: params.path });
         }
         try {
-          const content = await fs65.readFile(params.path, "utf8");
+          const content = await fs66.readFile(params.path, "utf8");
           return applyLineRange(content, params.line ?? null, params.limit ?? null);
         } catch (err) {
           const code = err.code;
@@ -37173,7 +37230,7 @@ var AcpClient = class {
           throw new RequestError(-32002, INTERNAL_BLOCK_REASON, { uri: params.path });
         }
         try {
-          await fs65.writeFile(params.path, params.content, "utf8");
+          await fs66.writeFile(params.path, params.content, "utf8");
           return {};
         } catch (err) {
           const code = err.code;
@@ -37266,25 +37323,25 @@ function knownAgentBinaryDirs() {
   out2.push("/tmp/codeam-node20/bin");
   for (const root of [
     "/usr/local/share/nvm/versions/node",
-    path76.join(home, ".nvm/versions/node")
+    path77.join(home, ".nvm/versions/node")
   ]) {
     try {
       for (const child of fsSync.readdirSync(root)) {
-        out2.push(path76.join(root, child, "bin"));
+        out2.push(path77.join(root, child, "bin"));
       }
     } catch {
     }
   }
-  out2.push(path76.join(home, ".volta/bin"));
+  out2.push(path77.join(home, ".volta/bin"));
   out2.push("/usr/local/bin");
   out2.push("/usr/bin");
-  out2.push(path76.join(home, ".local/bin"));
-  out2.push(path76.join(home, "bin"));
+  out2.push(path77.join(home, ".local/bin"));
+  out2.push(path77.join(home, "bin"));
   out2.push(...agentInstallBinDirs());
   if (process.platform === "win32") {
     const { LOCALAPPDATA, APPDATA } = process.env;
-    if (LOCALAPPDATA) out2.push(path76.join(LOCALAPPDATA, "cursor-agent"));
-    if (APPDATA) out2.push(path76.join(APPDATA, "npm"));
+    if (LOCALAPPDATA) out2.push(path77.join(LOCALAPPDATA, "cursor-agent"));
+    if (APPDATA) out2.push(path77.join(APPDATA, "npm"));
   }
   return out2.filter((p2) => {
     try {
@@ -37295,7 +37352,7 @@ function knownAgentBinaryDirs() {
   });
 }
 function expandPathForAgentBinaries(existingPath) {
-  const existing = new Set(existingPath.split(path76.delimiter).filter((p2) => p2.length > 0));
+  const existing = new Set(existingPath.split(path77.delimiter).filter((p2) => p2.length > 0));
   const additions = [];
   for (const dir of knownAgentBinaryDirs()) {
     if (!existing.has(dir)) {
@@ -37304,7 +37361,7 @@ function expandPathForAgentBinaries(existingPath) {
     }
   }
   if (additions.length === 0) return existingPath;
-  return [...additions, existingPath].filter((p2) => p2.length > 0).join(path76.delimiter);
+  return [...additions, existingPath].filter((p2) => p2.length > 0).join(path77.delimiter);
 }
 
 // src/commands/host/agent-install.ts
@@ -37576,9 +37633,9 @@ async function performAgentSwitch(deps, rawAgentId, fastPath = {}) {
 }
 
 // src/commands/host/agent-provisioning.ts
-var fs66 = __toESM(require("fs"));
+var fs67 = __toESM(require("fs"));
 var os51 = __toESM(require("os"));
-var path77 = __toESM(require("path"));
+var path78 = __toESM(require("path"));
 var PUBLIC_TO_INTERNAL_AGENT = {
   claude_code: "claude",
   claude: "claude",
@@ -37595,22 +37652,22 @@ function toInternalAgentId(publicAgentId) {
   return PUBLIC_TO_INTERNAL_AGENT[publicAgentId] ?? null;
 }
 function ensureDir(dir) {
-  fs66.mkdirSync(dir, { recursive: true, mode: 448 });
+  fs67.mkdirSync(dir, { recursive: true, mode: 448 });
 }
 function writeFile0600(filePath, contents) {
-  ensureDir(path77.dirname(filePath));
-  fs66.writeFileSync(filePath, contents, { encoding: "utf8", mode: 384 });
+  ensureDir(path78.dirname(filePath));
+  fs67.writeFileSync(filePath, contents, { encoding: "utf8", mode: 384 });
   restrictToOwner(filePath);
 }
 function rmIfExists(filePath) {
   try {
-    fs66.rmSync(filePath, { force: true });
+    fs67.rmSync(filePath, { force: true });
   } catch {
   }
 }
 var claudeProvisioner = {
   write(auth, home) {
-    const credentialsJson = path77.join(home, ".claude", ".credentials.json");
+    const credentialsJson = path78.join(home, ".claude", ".credentials.json");
     if (auth.kind === "api_key") {
       rmIfExists(credentialsJson);
       return { ANTHROPIC_API_KEY: auth.value };
@@ -37622,8 +37679,8 @@ var claudeProvisioner = {
     } else {
       rmIfExists(credentialsJson);
     }
-    const claudeJson = path77.join(home, ".claude.json");
-    if (!fs66.existsSync(claudeJson)) {
+    const claudeJson = path78.join(home, ".claude.json");
+    if (!fs67.existsSync(claudeJson)) {
       writeFile0600(
         claudeJson,
         JSON.stringify({ hasCompletedOnboarding: true, customApiKeyResponses: { approved: [] } })
@@ -37634,7 +37691,7 @@ var claudeProvisioner = {
 };
 var codexProvisioner = {
   write(auth, home) {
-    const authJson = path77.join(home, ".codex", "auth.json");
+    const authJson = path78.join(home, ".codex", "auth.json");
     if (auth.kind === "api_key") {
       writeFile0600(authJson, JSON.stringify({ auth_mode: "apikey", OPENAI_API_KEY: auth.value }));
       return { OPENAI_API_KEY: auth.value };
@@ -37657,7 +37714,7 @@ function codexLoginStamp(raw) {
 function keepsFresherCodexLogin(authJsonPath, incoming) {
   let onDisk;
   try {
-    onDisk = fs66.readFileSync(authJsonPath, "utf8");
+    onDisk = fs67.readFileSync(authJsonPath, "utf8");
   } catch {
     return false;
   }
@@ -37668,8 +37725,8 @@ function keepsFresherCodexLogin(authJsonPath, incoming) {
 }
 var geminiProvisioner = {
   write(auth, home) {
-    const settingsJson = path77.join(home, ".gemini", "settings.json");
-    const oauthCreds = path77.join(home, ".gemini", "oauth_creds.json");
+    const settingsJson = path78.join(home, ".gemini", "settings.json");
+    const oauthCreds = path78.join(home, ".gemini", "oauth_creds.json");
     if (auth.kind === "api_key") {
       rmIfExists(oauthCreds);
       writeFile0600(settingsJson, '{"security":{"auth":{"selectedType":"gemini-api-key"}}}');
@@ -37682,7 +37739,7 @@ var geminiProvisioner = {
 };
 var cursorProvisioner = {
   write(auth, home) {
-    const authJson = path77.join(home, ".config", "cursor", "auth.json");
+    const authJson = path78.join(home, ".config", "cursor", "auth.json");
     if (auth.kind === "api_key") {
       rmIfExists(authJson);
       return { CURSOR_API_KEY: auth.value };
@@ -37724,22 +37781,22 @@ max_context_size = 262144
 var kimiProvisioner = {
   write(auth, home) {
     const credentialsFiles = [
-      path77.join(home, ".kimi", "credentials", "kimi-code.json"),
-      path77.join(home, ".kimi-code", "credentials", "kimi-code.json")
+      path78.join(home, ".kimi", "credentials", "kimi-code.json"),
+      path78.join(home, ".kimi-code", "credentials", "kimi-code.json")
     ];
     if (auth.kind === "api_key") {
       credentialsFiles.forEach(rmIfExists);
       return { KIMI_API_KEY: auth.value };
     }
     credentialsFiles.forEach((f) => writeFile0600(f, auth.value));
-    writeFile0600(path77.join(home, ".kimi-code", "config.toml"), KIMI_MANAGED_CONFIG_TOML);
+    writeFile0600(path78.join(home, ".kimi-code", "config.toml"), KIMI_MANAGED_CONFIG_TOML);
     return {};
   }
 };
 var coderabbitProvisioner = {
   write(auth, home) {
-    const dir = path77.join(home, ".coderabbit");
-    const authJson = path77.join(dir, "auth.json");
+    const dir = path78.join(home, ".coderabbit");
+    const authJson = path78.join(dir, "auth.json");
     if (auth.kind === "api_key") {
       rmIfExists(authJson);
       return { CODERABBIT_API_KEY: auth.value };
@@ -37751,13 +37808,13 @@ var coderabbitProvisioner = {
       try {
         const parsed = JSON.parse(value);
         if (typeof parsed.file === "string" && typeof parsed.contents === "string") {
-          file = path77.basename(parsed.file);
+          file = path78.basename(parsed.file);
           contents = parsed.contents;
         }
       } catch {
       }
     }
-    writeFile0600(path77.join(dir, file), contents);
+    writeFile0600(path78.join(dir, file), contents);
     return {};
   }
 };
@@ -37794,8 +37851,8 @@ function provisionAgentCredentials(publicAgentId, auth, homeDir2 = os51.homedir(
 }
 
 // src/beads/workflow-hint.ts
-var fs67 = __toESM(require("fs"));
-var path78 = __toESM(require("path"));
+var fs68 = __toESM(require("fs"));
+var path79 = __toESM(require("path"));
 var BEADS_HINT_MARKER = "<!-- codeam:beads-workflow -->";
 var BEADS_HINT = `${BEADS_HINT_MARKER}
 # Beads (bd) \u2014 task tracking + persistent memory (ALWAYS use it)
@@ -37822,11 +37879,11 @@ function ensureBeadsWorkflowHint(homeDir2, file = claudeMemoryFile(homeDir2)) {
   try {
     let existing = "";
     try {
-      existing = fs67.readFileSync(file, "utf8");
+      existing = fs68.readFileSync(file, "utf8");
     } catch {
     }
     if (existing.includes(BEADS_HINT)) return;
-    fs67.mkdirSync(path78.dirname(file), { recursive: true });
+    fs68.mkdirSync(path79.dirname(file), { recursive: true });
     let next;
     const open = existing.indexOf(BEADS_HINT_MARKER);
     const close = open === -1 ? -1 : existing.indexOf(BEADS_HINT_MARKER, open + BEADS_HINT_MARKER.length);
@@ -37839,40 +37896,40 @@ ${BEADS_HINT}
 ` : `${BEADS_HINT}
 `;
     }
-    fs67.writeFileSync(file, next);
+    fs68.writeFileSync(file, next);
   } catch {
   }
 }
 
 // src/agents/agent-standard.ts
-var fs68 = __toESM(require("fs"));
-var path79 = __toESM(require("path"));
+var fs69 = __toESM(require("fs"));
+var path80 = __toESM(require("path"));
 var os52 = __toESM(require("os"));
 function ensureAgentStandard(homeDir2, file = claudeMemoryFile(homeDir2)) {
   try {
     let existing = "";
     try {
-      existing = fs68.readFileSync(file, "utf8");
+      existing = fs69.readFileSync(file, "utf8");
     } catch {
     }
     if (existing.includes(AGENT_STANDARD_MARKER)) return;
-    fs68.mkdirSync(path79.dirname(file), { recursive: true });
+    fs69.mkdirSync(path80.dirname(file), { recursive: true });
     const next = existing.trim() ? `${existing.trimEnd()}
 
 ${AGENT_STANDARD_BLOCK}
 ` : `${AGENT_STANDARD_BLOCK}
 `;
-    fs68.writeFileSync(file, next);
+    fs69.writeFileSync(file, next);
   } catch {
   }
 }
 var _agentStandardSeam = {
   isLocalSession: () => isLocalSession(),
-  markerPath: (sessionId) => path79.join(os52.homedir(), ".codeam", "agent-standard", `${sessionId}.done`),
-  exists: (p2) => fs68.existsSync(p2),
+  markerPath: (sessionId) => path80.join(os52.homedir(), ".codeam", "agent-standard", `${sessionId}.done`),
+  exists: (p2) => fs69.existsSync(p2),
   write: (p2) => {
-    fs68.mkdirSync(path79.dirname(p2), { recursive: true });
-    fs68.writeFileSync(p2, "");
+    fs69.mkdirSync(path80.dirname(p2), { recursive: true });
+    fs69.writeFileSync(p2, "");
   }
 };
 function isClaude(agent) {
@@ -37892,6 +37949,48 @@ function maybePrefaceAgentStandard(blocks, agent, sessionId, seam = _agentStanda
   blocks.unshift({ type: "text", text: AGENT_STANDARD_TEXT });
 }
 
+// src/scratch/workflow-hint.ts
+var import_node_fs18 = __toESM(require("fs"));
+var import_node_path19 = __toESM(require("path"));
+var SCRATCH_HINT_MARKER = "<!-- codeam:scratch-workflow -->";
+var SCRATCH_HINT = `${SCRATCH_HINT_MARKER}
+# From-scratch projects (CodeAgent Box)
+
+When the working directory is a project started from scratch (no git remote,
+a \`.git/codeam-scratch\` marker):
+
+- Build something small, visible and working first. As soon as it can be
+  seen, start it with the \`codeagent_preview\` \`start_preview\` tool and tell the
+  user the preview is open.
+- If the user asks what you can do or for ideas, list them in a few short
+  lines and build the first one in the same turn (unless they ask you to
+  wait), so they see something running right away.
+- Saving is the user's choice in the app (Save to GitHub / GitLab, or a ZIP).
+  Never push, create repositories or ask for git credentials yourself. Once the
+  user has seen something working, call \`suggest_save_project\` ONCE if the
+  app has not offered to save yet.
+${SCRATCH_HINT_MARKER}`;
+function ensureScratchWorkflowHint(homeDir2, file = claudeMemoryFile(homeDir2)) {
+  try {
+    let existing = "";
+    try {
+      existing = import_node_fs18.default.readFileSync(file, "utf8");
+    } catch {
+    }
+    if (existing.includes(SCRATCH_HINT)) return;
+    import_node_fs18.default.mkdirSync(import_node_path19.default.dirname(file), { recursive: true });
+    const open = existing.indexOf(SCRATCH_HINT_MARKER);
+    const close = open === -1 ? -1 : existing.indexOf(SCRATCH_HINT_MARKER, open + SCRATCH_HINT_MARKER.length);
+    const next = open !== -1 && close !== -1 ? existing.slice(0, open) + SCRATCH_HINT + existing.slice(close + SCRATCH_HINT_MARKER.length) : existing.trim() ? `${existing.trimEnd()}
+
+${SCRATCH_HINT}
+` : `${SCRATCH_HINT}
+`;
+    import_node_fs18.default.writeFileSync(file, next);
+  } catch {
+  }
+}
+
 // src/services/streaming/transport.ts
 var http11 = __toESM(require("http"));
 var https7 = __toESM(require("https"));
@@ -38565,15 +38664,15 @@ function withholdTrailingPartialFenceMarker(text) {
 
 // src/agents/acp/onboarding.ts
 var import_child_process28 = require("child_process");
-var fs69 = __toESM(require("fs"));
+var fs71 = __toESM(require("fs"));
 var os53 = __toESM(require("os"));
-var path80 = __toESM(require("path"));
+var path82 = __toESM(require("path"));
 var _onboardingSeam = {
-  markerPath: (sessionId) => path80.join(os53.homedir(), ".codeam", "welcomed", `${sessionId}.done`),
-  exists: (p2) => fs69.existsSync(p2),
+  markerPath: (sessionId) => path82.join(os53.homedir(), ".codeam", "welcomed", `${sessionId}.done`),
+  exists: (p2) => fs71.existsSync(p2),
   write: (p2) => {
-    fs69.mkdirSync(path80.dirname(p2), { recursive: true });
-    fs69.writeFileSync(p2, "");
+    fs71.mkdirSync(path82.dirname(p2), { recursive: true });
+    fs71.writeFileSync(p2, "");
   },
   disabled: () => {
     const v = process.env.CODEAM_ONBOARDING_DISABLED;
@@ -38610,7 +38709,7 @@ function resolveRepoName(cwd) {
       if (name) return name;
     }
   }
-  const base = path80.basename(cwd || "");
+  const base = path82.basename(cwd || "");
   if (base && !isUuid(base)) return base;
   return "this project";
 }
@@ -39002,14 +39101,14 @@ var import_crypto5 = require("crypto");
 
 // src/services/turn-files/git-changeset.ts
 var import_child_process29 = require("child_process");
-var fs71 = __toESM(require("fs/promises"));
+var fs73 = __toESM(require("fs/promises"));
 var import_fs7 = require("fs");
-var path82 = __toESM(require("path"));
+var path84 = __toESM(require("path"));
 
 // src/services/turn-files/review-ignore.ts
 var import_ignore2 = __toESM(require("ignore"));
-var fs70 = __toESM(require("fs"));
-var path81 = __toESM(require("path"));
+var fs72 = __toESM(require("fs"));
+var path83 = __toESM(require("path"));
 var CURATED_REVIEW_IGNORE = [
   // Google Cloud SDK (the incident) — installs a huge python tree.
   "google-cloud-sdk/",
@@ -39053,7 +39152,7 @@ var CURATED_REVIEW_IGNORE = [
 function makeReviewIgnore(repoRoot) {
   const ig = (0, import_ignore2.default)().add(CURATED_REVIEW_IGNORE);
   try {
-    const custom = fs70.readFileSync(path81.join(repoRoot, ".codeam", "reviewignore"), "utf8");
+    const custom = fs72.readFileSync(path83.join(repoRoot, ".codeam", "reviewignore"), "utf8");
     ig.add(custom);
   } catch {
   }
@@ -39088,7 +39187,7 @@ async function collectRepoChangeset(opts) {
   const rows = parseStatus(status2).filter(
     (row) => !isIgnoredFilePath(row.filePath) && !reviewIgnore(row.filePath) && // A socket, FIFO or device node is never a change to review (a
     // `cc-socks/1522.sock` reached the Files tab).
-    isReviewablePath(path82.join(opts.repoRoot, row.filePath))
+    isReviewablePath(path84.join(opts.repoRoot, row.filePath))
   );
   const MAX_CHANGESET_FILES = Math.max(1, Number(process.env.CODEAM_MAX_CHANGESET_FILES ?? 500));
   const truncated = rows.length > MAX_CHANGESET_FILES;
@@ -39105,7 +39204,7 @@ async function collectRepoChangeset(opts) {
     let stats;
     if (!truncated && row.fileStatus === "added" && numstatEntry === void 0) {
       const lineCount = await readUntrackedLineCount(
-        path82.join(opts.repoRoot, row.filePath)
+        path84.join(opts.repoRoot, row.filePath)
       );
       stats = { added: lineCount, removed: 0 };
     } else {
@@ -39136,7 +39235,7 @@ function readUntrackedLineCount(absPath) {
 }
 async function defaultReadUntrackedLineCount(absPath) {
   try {
-    const content = await fs71.readFile(absPath, "utf8");
+    const content = await fs73.readFile(absPath, "utf8");
     let count = 0;
     let pos = -1;
     while ((pos = content.indexOf("\n", pos + 1)) !== -1) {
@@ -39228,7 +39327,7 @@ function defaultRunGit(cwd, args2) {
   });
 }
 async function discoverRepos(workingDir, maxDepth = 4) {
-  const fs93 = await import("fs/promises");
+  const fs94 = await import("fs/promises");
   const out2 = [];
   await walk2(workingDir, 0);
   return out2;
@@ -39236,7 +39335,7 @@ async function discoverRepos(workingDir, maxDepth = 4) {
     if (depth2 > maxDepth) return;
     let entries2 = [];
     try {
-      const dirents = await fs93.readdir(dir, { withFileTypes: true });
+      const dirents = await fs94.readdir(dir, { withFileTypes: true });
       entries2 = dirents.filter((d3) => !d3.name.startsWith(".") || d3.name === ".git").map((d3) => ({ name: d3.name, isDirectory: d3.isDirectory() }));
     } catch {
       return;
@@ -39247,8 +39346,8 @@ async function discoverRepos(workingDir, maxDepth = 4) {
     if (hasGit) {
       out2.push({
         repoRoot: dir,
-        repoPath: path82.relative(workingDir, dir),
-        repoName: path82.basename(dir)
+        repoPath: path84.relative(workingDir, dir),
+        repoName: path84.basename(dir)
       });
       return;
     }
@@ -39256,7 +39355,7 @@ async function discoverRepos(workingDir, maxDepth = 4) {
       if (!entry.isDirectory) continue;
       if (entry.name === "node_modules") continue;
       if (entry.name === "dist" || entry.name === "build") continue;
-      await walk2(path82.join(dir, entry.name), depth2 + 1);
+      await walk2(path84.join(dir, entry.name), depth2 + 1);
     }
   }
 }
@@ -39270,8 +39369,8 @@ function isReviewablePath(absPath) {
 }
 
 // src/services/turn-files/files-outbox.ts
-var fs72 = __toESM(require("fs/promises"));
-var path83 = __toESM(require("path"));
+var fs74 = __toESM(require("fs/promises"));
+var path85 = __toESM(require("path"));
 var import_os12 = require("os");
 var HOME_OUTBOX_DIR = ".codeam/outbox";
 var MAX_AGE_MS = 24 * 60 * 60 * 1e3;
@@ -39304,16 +39403,16 @@ var FilesOutbox = class {
   backoffIndex = 0;
   stopped = false;
   constructor(opts) {
-    const base = opts.baseDir ?? path83.join(homeDir(), HOME_OUTBOX_DIR);
-    this.filePath = path83.join(base, `${opts.sessionId}.jsonl`);
+    const base = opts.baseDir ?? path85.join(homeDir(), HOME_OUTBOX_DIR);
+    this.filePath = path85.join(base, `${opts.sessionId}.jsonl`);
     this.post = opts.post;
     this.autoSchedule = opts.autoSchedule !== false;
   }
   /** Persist the entry to disk and trigger a flush. Returns once the
    *  line is durable on disk (not once the POST succeeds). */
   async enqueue(entry) {
-    await fs72.mkdir(path83.dirname(this.filePath), { recursive: true });
-    await fs72.appendFile(this.filePath, JSON.stringify(entry) + "\n", "utf8");
+    await fs74.mkdir(path85.dirname(this.filePath), { recursive: true });
+    await fs74.appendFile(this.filePath, JSON.stringify(entry) + "\n", "utf8");
     this.backoffIndex = 0;
     if (this.autoSchedule) this.scheduleFlush(0);
   }
@@ -39404,7 +39503,7 @@ var FilesOutbox = class {
   async readAll() {
     let raw = "";
     try {
-      raw = await fs72.readFile(this.filePath, "utf8");
+      raw = await fs74.readFile(this.filePath, "utf8");
     } catch {
       return [];
     }
@@ -39428,12 +39527,12 @@ var FilesOutbox = class {
   async rewrite(entries2) {
     const tmpPath = `${this.filePath}.${process.pid}.tmp`;
     if (entries2.length === 0) {
-      await fs72.unlink(this.filePath).catch(() => void 0);
+      await fs74.unlink(this.filePath).catch(() => void 0);
       return;
     }
     const payload = entries2.map((e) => JSON.stringify(e)).join("\n") + "\n";
-    await fs72.writeFile(tmpPath, payload, "utf8");
-    await fs72.rename(tmpPath, this.filePath);
+    await fs74.writeFile(tmpPath, payload, "utf8");
+    await fs74.rename(tmpPath, this.filePath);
   }
 };
 function applyJitter(ms) {
@@ -39753,15 +39852,15 @@ async function postCredentialSync(opts, fetchImpl = fetch) {
 var import_node_crypto13 = require("crypto");
 var import_promises6 = __toESM(require("fs/promises"));
 var import_node_os14 = __toESM(require("os"));
-var import_node_path18 = __toESM(require("path"));
+var import_node_path20 = __toESM(require("path"));
 function markerPath3(cwd, homeDir2 = import_node_os14.default.homedir()) {
-  const key = (0, import_node_crypto13.createHash)("sha256").update(import_node_path18.default.resolve(cwd)).digest("hex").slice(0, 16);
-  return import_node_path18.default.join(homeDir2, ".codeam", "conversation-active", `${key}.json`);
+  const key = (0, import_node_crypto13.createHash)("sha256").update(import_node_path20.default.resolve(cwd)).digest("hex").slice(0, 16);
+  return import_node_path20.default.join(homeDir2, ".codeam", "conversation-active", `${key}.json`);
 }
 async function writeActiveConversationMarker(cwd, conversationId, homeDir2) {
   try {
     const file = markerPath3(cwd, homeDir2);
-    await import_promises6.default.mkdir(import_node_path18.default.dirname(file), { recursive: true });
+    await import_promises6.default.mkdir(import_node_path20.default.dirname(file), { recursive: true });
     await import_promises6.default.writeFile(
       file,
       JSON.stringify({ conversationId, at: (/* @__PURE__ */ new Date()).toISOString() }, null, 2) + "\n",
@@ -39781,27 +39880,27 @@ async function readActiveConversationMarker(cwd, homeDir2) {
 }
 
 // src/services/turn-marker.ts
-var fs74 = __toESM(require("fs"));
+var fs76 = __toESM(require("fs"));
 var os55 = __toESM(require("os"));
-var path85 = __toESM(require("path"));
+var path87 = __toESM(require("path"));
 var depth = 0;
 function codeamHome() {
-  return path85.join(os55.homedir(), ".codeam");
+  return path87.join(os55.homedir(), ".codeam");
 }
 function turnMarkerPath(pid = process.pid, home = codeamHome()) {
-  return path85.join(home, "turns", String(pid));
+  return path87.join(home, "turns", String(pid));
 }
 function mark() {
   try {
     const file = turnMarkerPath();
-    fs74.mkdirSync(path85.dirname(file), { recursive: true });
-    fs74.writeFileSync(file, String(Date.now()));
+    fs76.mkdirSync(path87.dirname(file), { recursive: true });
+    fs76.writeFileSync(file, String(Date.now()));
   } catch {
   }
 }
 function clear() {
   try {
-    fs74.rmSync(turnMarkerPath(), { force: true });
+    fs76.rmSync(turnMarkerPath(), { force: true });
   } catch {
   }
 }
@@ -39816,7 +39915,7 @@ async function withTurnMarker(fn) {
 function isProcessMidTurn(pid, home) {
   if (!pid) return false;
   try {
-    return fs74.existsSync(turnMarkerPath(pid, home));
+    return fs76.existsSync(turnMarkerPath(pid, home));
   } catch {
     return false;
   }
@@ -39824,8 +39923,8 @@ function isProcessMidTurn(pid, home) {
 
 // src/packs/gates.ts
 var import_node_child_process28 = require("child_process");
-var fs75 = __toESM(require("fs"));
-var path86 = __toESM(require("path"));
+var fs77 = __toESM(require("fs"));
+var path88 = __toESM(require("path"));
 var defaultCommandRunner = (file, args2, cwd, timeoutMs, env) => new Promise((resolve12) => {
   (0, import_node_child_process28.execFile)(
     file,
@@ -39875,7 +39974,7 @@ async function changedFiles(run3, cwd, from, to) {
 }
 function readWorkspaceFile(cwd, relPath) {
   try {
-    return fs75.readFileSync(path86.join(cwd, relPath), "utf8");
+    return fs77.readFileSync(path88.join(cwd, relPath), "utf8");
   } catch {
     return null;
   }
@@ -39884,14 +39983,14 @@ var NO_TEST_PLACEHOLDER = 'echo "Error: no test specified"';
 var CHECKS_TIMEOUT_MS = 5 * 6e4;
 function detectChecksCommand(cwd) {
   try {
-    const cfg = JSON.parse(fs75.readFileSync(path86.join(cwd, ".codeam", "pack.json"), "utf8"));
+    const cfg = JSON.parse(fs77.readFileSync(path88.join(cwd, ".codeam", "pack.json"), "utf8"));
     if (typeof cfg.checksCommand === "string" && cfg.checksCommand.trim().length > 0) {
       return cfg.checksCommand.trim();
     }
   } catch {
   }
   try {
-    const pkg = JSON.parse(fs75.readFileSync(path86.join(cwd, "package.json"), "utf8"));
+    const pkg = JSON.parse(fs77.readFileSync(path88.join(cwd, "package.json"), "utf8"));
     const test = pkg.scripts?.test;
     if (typeof test === "string" && test.trim().length > 0 && !test.includes(NO_TEST_PLACEHOLDER)) {
       return "npm test";
@@ -39909,39 +40008,39 @@ ${res.stderr}`.trim();
 }
 
 // src/packs/run-store.ts
-var fs76 = __toESM(require("fs"));
-var path87 = __toESM(require("path"));
+var fs78 = __toESM(require("fs"));
+var path89 = __toESM(require("path"));
 var crypto5 = __toESM(require("crypto"));
 function packsDir(cwd) {
-  return path87.join(cwd, ".codeam", "packs");
+  return path89.join(cwd, ".codeam", "packs");
 }
 function runDir(cwd, runId) {
-  return path87.join(packsDir(cwd), runId);
+  return path89.join(packsDir(cwd), runId);
 }
 function newRunId() {
   return `pk_${Date.now().toString(36)}_${crypto5.randomBytes(4).toString("hex")}`;
 }
 function writeJsonAtomic(file, value) {
-  fs76.mkdirSync(path87.dirname(file), { recursive: true });
+  fs78.mkdirSync(path89.dirname(file), { recursive: true });
   const tmp = `${file}.tmp`;
-  fs76.writeFileSync(tmp, JSON.stringify(value, null, 2));
-  fs76.renameSync(tmp, file);
+  fs78.writeFileSync(tmp, JSON.stringify(value, null, 2));
+  fs78.renameSync(tmp, file);
 }
 function saveRun(cwd, state) {
-  writeJsonAtomic(path87.join(runDir(cwd, state.runId), "run.json"), state);
+  writeJsonAtomic(path89.join(runDir(cwd, state.runId), "run.json"), state);
 }
 function saveStageHandoff(cwd, runId, stageIndex, role, handoff) {
   const name = `${String(stageIndex + 1).padStart(2, "0")}-${role}.json`;
-  writeJsonAtomic(path87.join(runDir(cwd, runId), name), handoff);
+  writeJsonAtomic(path89.join(runDir(cwd, runId), name), handoff);
 }
 function loadLatestRun(cwd) {
   try {
     const dir = packsDir(cwd);
-    const entries2 = fs76.readdirSync(dir, { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => e.name).sort();
+    const entries2 = fs78.readdirSync(dir, { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => e.name).sort();
     for (let i = entries2.length - 1; i >= 0; i--) {
-      const file = path87.join(dir, entries2[i], "run.json");
+      const file = path89.join(dir, entries2[i], "run.json");
       try {
-        const parsed = JSON.parse(fs76.readFileSync(file, "utf8"));
+        const parsed = JSON.parse(fs78.readFileSync(file, "utf8"));
         if (parsed && typeof parsed.runId === "string") return parsed;
       } catch {
       }
@@ -39952,17 +40051,17 @@ function loadLatestRun(cwd) {
 }
 function ensureLedgerIgnored(cwd) {
   try {
-    const gitDir = path87.join(cwd, ".git");
-    if (!fs76.existsSync(gitDir)) return;
-    const exclude = path87.join(gitDir, "info", "exclude");
+    const gitDir = path89.join(cwd, ".git");
+    if (!fs78.existsSync(gitDir)) return;
+    const exclude = path89.join(gitDir, "info", "exclude");
     let existing = "";
     try {
-      existing = fs76.readFileSync(exclude, "utf8");
+      existing = fs78.readFileSync(exclude, "utf8");
     } catch {
     }
     if (existing.includes(".codeam/packs/")) return;
-    fs76.mkdirSync(path87.dirname(exclude), { recursive: true });
-    fs76.writeFileSync(exclude, `${existing.trimEnd()}
+    fs78.mkdirSync(path89.dirname(exclude), { recursive: true });
+    fs78.writeFileSync(exclude, `${existing.trimEnd()}
 .codeam/packs/
 `.trimStart());
   } catch {
@@ -40739,15 +40838,15 @@ var packStatusH = async (ctx) => {
 };
 
 // src/integrations/manifest.ts
-var import_node_fs17 = __toESM(require("fs"));
+var import_node_fs19 = __toESM(require("fs"));
 var import_node_os15 = __toESM(require("os"));
-var import_node_path19 = __toESM(require("path"));
+var import_node_path21 = __toESM(require("path"));
 function integrationsManifestPath() {
-  return import_node_path19.default.join(import_node_os15.default.homedir(), ".codeam", "integrations.json");
+  return import_node_path21.default.join(import_node_os15.default.homedir(), ".codeam", "integrations.json");
 }
 function readIntegrationsManifest() {
   try {
-    const raw = JSON.parse(import_node_fs17.default.readFileSync(integrationsManifestPath(), "utf8"));
+    const raw = JSON.parse(import_node_fs19.default.readFileSync(integrationsManifestPath(), "utf8"));
     if (!Array.isArray(raw?.integrations)) return null;
     return raw;
   } catch {
@@ -40757,10 +40856,10 @@ function readIntegrationsManifest() {
 function persistIntegrationsManifest(m) {
   try {
     const file = integrationsManifestPath();
-    import_node_fs17.default.mkdirSync(import_node_path19.default.dirname(file), { recursive: true, mode: 448 });
+    import_node_fs19.default.mkdirSync(import_node_path21.default.dirname(file), { recursive: true, mode: 448 });
     const tmp = `${file}.tmp-${process.pid}`;
-    import_node_fs17.default.writeFileSync(tmp, JSON.stringify(m, null, 2), { encoding: "utf8", mode: 384 });
-    import_node_fs17.default.renameSync(tmp, file);
+    import_node_fs19.default.writeFileSync(tmp, JSON.stringify(m, null, 2), { encoding: "utf8", mode: 384 });
+    import_node_fs19.default.renameSync(tmp, file);
     restrictToOwner(file);
   } catch (err) {
     log.warn(
@@ -40771,7 +40870,7 @@ function persistIntegrationsManifest(m) {
 }
 function clearIntegrationsManifest() {
   try {
-    import_node_fs17.default.rmSync(integrationsManifestPath(), { force: true });
+    import_node_fs19.default.rmSync(integrationsManifestPath(), { force: true });
   } catch {
   }
 }
@@ -40943,20 +41042,20 @@ async function mcpRouter() {
 }
 
 // src/integrations/mcp-secrets.ts
-var fs78 = __toESM(require("fs"));
+var fs80 = __toESM(require("fs"));
 var os57 = __toESM(require("os"));
-var path89 = __toESM(require("path"));
+var path91 = __toESM(require("path"));
 var MCP_SECRETS_FILE_ENV = "CODEAM_MCP_SECRETS_FILE";
 function mcpSecretsDir() {
-  return path89.join(os57.homedir(), ".codeam", "mcp-secrets");
+  return path91.join(os57.homedir(), ".codeam", "mcp-secrets");
 }
 function mcpSecretsPath(scope, pid = process.pid) {
-  return path89.join(mcpSecretsDir(), `${pid}-${scope}.json`);
+  return path91.join(mcpSecretsDir(), `${pid}-${scope}.json`);
 }
 var registeredForCleanup = /* @__PURE__ */ new Set();
 function readFileVars(file) {
   try {
-    const parsed = JSON.parse(fs78.readFileSync(file, "utf8"));
+    const parsed = JSON.parse(fs80.readFileSync(file, "utf8"));
     if (!parsed || typeof parsed !== "object") return {};
     const out2 = {};
     for (const [k2, v] of Object.entries(parsed)) {
@@ -40978,7 +41077,7 @@ function pidAlive2(pid) {
 function pruneStale(dir) {
   let names = [];
   try {
-    names = fs78.readdirSync(dir);
+    names = fs80.readdirSync(dir);
   } catch {
     return;
   }
@@ -40988,25 +41087,25 @@ function pruneStale(dir) {
     const pid = Number(m[1]);
     if (pid === process.pid || pidAlive2(pid)) continue;
     try {
-      fs78.unlinkSync(path89.join(dir, name));
+      fs80.unlinkSync(path91.join(dir, name));
     } catch {
     }
   }
 }
 function writeMcpSecrets(vars, file) {
   try {
-    const dir = path89.dirname(file);
-    fs78.mkdirSync(dir, { recursive: true, mode: 448 });
+    const dir = path91.dirname(file);
+    fs80.mkdirSync(dir, { recursive: true, mode: 448 });
     pruneStale(dir);
     const tmp = `${file}.${process.pid}.tmp`;
-    fs78.writeFileSync(tmp, JSON.stringify(vars), { mode: 384 });
-    fs78.renameSync(tmp, file);
-    fs78.chmodSync(file, 384);
+    fs80.writeFileSync(tmp, JSON.stringify(vars), { mode: 384 });
+    fs80.renameSync(tmp, file);
+    fs80.chmodSync(file, 384);
     if (!registeredForCleanup.has(file)) {
       registeredForCleanup.add(file);
       process.once("exit", () => {
         try {
-          fs78.unlinkSync(file);
+          fs80.unlinkSync(file);
         } catch {
         }
       });
@@ -41092,11 +41191,11 @@ function previewMcpServer(bridge) {
   };
 }
 function httpCall(baseUrl, token) {
-  return async (path108, method, body, timeoutMs) => {
+  return async (path109, method, body, timeoutMs) => {
     const ac = new AbortController();
     const timer = setTimeout(() => ac.abort(), timeoutMs);
     try {
-      const res = await fetch(`${baseUrl}${path108}`, {
+      const res = await fetch(`${baseUrl}${path109}`, {
         method,
         headers: { authorization: `Bearer ${token}`, "content-type": "application/json" },
         ...method === "POST" ? { body: JSON.stringify(body ?? {}) } : {},
@@ -41201,6 +41300,7 @@ var SCRATCH_TOOLS = [
     description: [
       "This session is a from-scratch project on the user's CodeAgent Box. It is NOT connected to GitHub, and nothing is saved outside this workspace yet.",
       "How to work here: build something small, visible and working. As soon as it can be seen, start it with the codeagent_preview start_preview tool and tell the user the preview is open.",
+      "If the user asks what you can do or for ideas, list them in a few short lines and build the first one in the same turn (unless they ask you to wait), so they see something running right away.",
       'Once the user has seen something working \u2014 or after a substantial change that is not saved yet \u2014 call this tool ONCE. It shows the user a "Save your project" card in the app (Save to GitHub or Download ZIP).',
       "Do not push, create repositories or ask for GitHub credentials yourself: saving is the user's choice in the app. Do not call this tool again unless there are substantial new unsaved changes."
     ].join(" "),
@@ -41223,11 +41323,11 @@ function scratchMcpServer(bridge) {
   };
 }
 function httpCall2(baseUrl, token) {
-  return async (path108, method, body, timeoutMs) => {
+  return async (path109, method, body, timeoutMs) => {
     const ac = new AbortController();
     const timer = setTimeout(() => ac.abort(), timeoutMs);
     try {
-      const res = await fetch(`${baseUrl}${path108}`, {
+      const res = await fetch(`${baseUrl}${path109}`, {
         method,
         headers: { authorization: `Bearer ${token}`, "content-type": "application/json" },
         ...method === "POST" ? { body: JSON.stringify(body ?? {}) } : {},
@@ -41353,12 +41453,12 @@ function buildIntegrationMcpServers(ctx) {
 }
 
 // src/services/local-mcp-servers.ts
-var import_node_fs18 = __toESM(require("fs"));
+var import_node_fs20 = __toESM(require("fs"));
 var import_node_os16 = __toESM(require("os"));
-var import_node_path20 = __toESM(require("path"));
+var import_node_path22 = __toESM(require("path"));
 var MAX_LOCAL_MCP_SERVERS = 10;
 function localMcpServersPath() {
-  return import_node_path20.default.join(import_node_os16.default.homedir(), ".codeam", "mcp-servers.json");
+  return import_node_path22.default.join(import_node_os16.default.homedir(), ".codeam", "mcp-servers.json");
 }
 function isStringArray(v) {
   return Array.isArray(v) && v.every((item) => typeof item === "string");
@@ -41376,7 +41476,7 @@ function isValidEntry(entry) {
 function readLocalMcpServers() {
   let raw;
   try {
-    raw = import_node_fs18.default.readFileSync(localMcpServersPath(), "utf8");
+    raw = import_node_fs20.default.readFileSync(localMcpServersPath(), "utf8");
   } catch {
     return [];
   }
@@ -41767,11 +41867,11 @@ function readJson(req) {
 var agentPreviewBridge = new AgentPreviewBridge();
 
 // src/integrations/detect-stack.ts
-var import_node_fs19 = __toESM(require("fs"));
-var import_node_path21 = __toESM(require("path"));
+var import_node_fs21 = __toESM(require("fs"));
+var import_node_path23 = __toESM(require("path"));
 function readSafe(cwd, rel) {
   try {
-    return import_node_fs19.default.readFileSync(import_node_path21.default.join(cwd, rel), "utf8");
+    return import_node_fs21.default.readFileSync(import_node_path23.default.join(cwd, rel), "utf8");
   } catch {
     return "";
   }
@@ -42419,6 +42519,9 @@ async function startTaskH(ctx) {
           `start_task \u2190 done stopReason=${reply.stopReason ?? "?"} id=${cmd.id.slice(0, 8)}`
         );
         await relay.sendResult(cmd.id, "completed", { stopReason: reply.stopReason });
+        if (reply.stopReason === "end_turn" && maybeAutoOpenScratchPreview(opts.sessionId, agentPreviewBridge)) {
+          log.info("acpRunner", "scratch: turn left a servable project and no preview \u2014 opening it");
+        }
         return;
       }
     } catch (err) {
@@ -44127,19 +44230,20 @@ async function runAcpSession(opts) {
       switchCredentialEnv = provisionAgentCredentials(agentId, auth);
     },
     provisionHouseProxy: ({ baseUrl, token, model, managedAgentId }) => {
-      const claudeConfigDir2 = path92.join(
+      const claudeConfigDir2 = path94.join(
         os59.homedir(),
         ".codeam",
         "house-claude",
         `switch-${opts.pluginId}`
       );
       try {
-        fs81.mkdirSync(claudeConfigDir2, { recursive: true, mode: 448 });
+        fs83.mkdirSync(claudeConfigDir2, { recursive: true, mode: 448 });
       } catch {
       }
-      const memoryFile = path92.join(claudeConfigDir2, "CLAUDE.md");
+      const memoryFile = path94.join(claudeConfigDir2, "CLAUDE.md");
       ensureBeadsWorkflowHint(void 0, memoryFile);
       ensureAgentStandard(void 0, memoryFile);
+      if (isScratchWorkspace(process.cwd())) ensureScratchWorkflowHint(void 0, memoryFile);
       const cfg = {
         baseUrl,
         token,
@@ -45352,45 +45456,6 @@ function startClaudeCredentialSync(opts) {
   };
 }
 
-// src/scratch/workflow-hint.ts
-var import_node_fs20 = __toESM(require("fs"));
-var import_node_path22 = __toESM(require("path"));
-var SCRATCH_HINT_MARKER = "<!-- codeam:scratch-workflow -->";
-var SCRATCH_HINT = `${SCRATCH_HINT_MARKER}
-# From-scratch projects (CodeAgent Box)
-
-When the working directory is a project started from scratch (no git remote,
-a \`.git/codeam-scratch\` marker):
-
-- Build something small, visible and working first. As soon as it can be
-  seen, start it with the \`codeagent_preview\` \`start_preview\` tool and tell the
-  user the preview is open.
-- Saving is the user's choice in the app (Save to GitHub / GitLab, or a ZIP).
-  Never push, create repositories or ask for git credentials yourself. Once the
-  user has seen something working, call \`suggest_save_project\` ONCE if the
-  app has not offered to save yet.
-${SCRATCH_HINT_MARKER}`;
-function ensureScratchWorkflowHint(homeDir2, file = claudeMemoryFile(homeDir2)) {
-  try {
-    let existing = "";
-    try {
-      existing = import_node_fs20.default.readFileSync(file, "utf8");
-    } catch {
-    }
-    if (existing.includes(SCRATCH_HINT)) return;
-    import_node_fs20.default.mkdirSync(import_node_path22.default.dirname(file), { recursive: true });
-    const open = existing.indexOf(SCRATCH_HINT_MARKER);
-    const close = open === -1 ? -1 : existing.indexOf(SCRATCH_HINT_MARKER, open + SCRATCH_HINT_MARKER.length);
-    const next = open !== -1 && close !== -1 ? existing.slice(0, open) + SCRATCH_HINT + existing.slice(close + SCRATCH_HINT_MARKER.length) : existing.trim() ? `${existing.trimEnd()}
-
-${SCRATCH_HINT}
-` : `${SCRATCH_HINT}
-`;
-    import_node_fs20.default.writeFileSync(file, next);
-  } catch {
-  }
-}
-
 // src/commands/start/pick-session.ts
 function pickPinnedSession(pinnedId, listSessions2) {
   const id = pinnedId?.trim();
@@ -45406,8 +45471,8 @@ function pickPinnedSession(pinnedId, listSessions2) {
 }
 
 // src/agents/retired-proxy-cleanup.ts
-var fs83 = __toESM(require("fs"));
-var path94 = __toESM(require("path"));
+var fs84 = __toESM(require("fs"));
+var path95 = __toESM(require("path"));
 var os60 = __toESM(require("os"));
 var RETIRED_PROXY_RE = /^https?:\/\/(?:127\.0\.0\.1|localhost|\[::1\]):8787(?:[/?#]|$)/i;
 var HEADROOM_CMD_RE = /(^|[\s/"'])headroom(\s|$)/i;
@@ -45419,10 +45484,10 @@ function isHeadroomHook(group) {
 }
 function sanitizeRetiredProxyConfig(homeDir2 = os60.homedir()) {
   const out2 = { inspected: false, changed: false, removed: [] };
-  const file = path94.join(homeDir2, ".claude", "settings.json");
+  const file = path95.join(homeDir2, ".claude", "settings.json");
   let parsed;
   try {
-    parsed = JSON.parse(fs83.readFileSync(file, "utf8"));
+    parsed = JSON.parse(fs84.readFileSync(file, "utf8"));
   } catch {
     return out2;
   }
@@ -45464,9 +45529,9 @@ function sanitizeRetiredProxyConfig(homeDir2 = os60.homedir()) {
   if (!out2.changed) return out2;
   try {
     const tmp = `${file}.codeam.tmp`;
-    fs83.writeFileSync(tmp, `${JSON.stringify(parsed, null, 2)}
+    fs84.writeFileSync(tmp, `${JSON.stringify(parsed, null, 2)}
 `, { mode: 384 });
-    fs83.renameSync(tmp, file);
+    fs84.renameSync(tmp, file);
   } catch {
     out2.changed = false;
   }
@@ -45998,7 +46063,7 @@ var AcpDriver = class {
 };
 
 // src/baton/transcript-mirror.ts
-var fs84 = __toESM(require("fs"));
+var fs85 = __toESM(require("fs"));
 var TranscriptMirror = class {
   constructor(deps) {
     this.deps = deps;
@@ -46092,7 +46157,7 @@ var TranscriptMirror = class {
   }
 };
 function defaultWatch(file, onChange) {
-  const w3 = fs84.watch(file, { persistent: false }, () => onChange());
+  const w3 = fs85.watch(file, { persistent: false }, () => onChange());
   return () => w3.close();
 }
 
@@ -46438,16 +46503,16 @@ function keepDeviceAwake(deps = {}) {
 }
 
 // src/agents/claude/onboarding.ts
-var fs85 = __toESM(require("fs"));
+var fs86 = __toESM(require("fs"));
 var os62 = __toESM(require("os"));
-var path95 = __toESM(require("path"));
+var path96 = __toESM(require("path"));
 var ONBOARDING_VERSION_SENTINEL = "9999.0.0";
 function ensureClaudeOnboarded(cwd) {
   try {
-    const file = path95.join(os62.homedir(), ".claude.json");
+    const file = path96.join(os62.homedir(), ".claude.json");
     let config = {};
     try {
-      config = JSON.parse(fs85.readFileSync(file, "utf8"));
+      config = JSON.parse(fs86.readFileSync(file, "utf8"));
     } catch {
     }
     let changed = false;
@@ -46472,8 +46537,8 @@ function ensureClaudeOnboarded(cwd) {
       }
     }
     if (!changed) return;
-    fs85.mkdirSync(path95.dirname(file), { recursive: true });
-    fs85.writeFileSync(file, JSON.stringify(config, null, 2));
+    fs86.mkdirSync(path96.dirname(file), { recursive: true });
+    fs86.writeFileSync(file, JSON.stringify(config, null, 2));
     log.info(
       "claude",
       `pre-completed Claude onboarding${cwd ? ` + trusted workspace ${cwd}` : ""}`
@@ -47265,7 +47330,7 @@ var import_picocolors10 = __toESM(require("picocolors"));
 var import_child_process30 = require("child_process");
 var import_util4 = require("util");
 var import_picocolors8 = __toESM(require("picocolors"));
-var path96 = __toESM(require("path"));
+var path97 = __toESM(require("path"));
 var execFileP6 = (0, import_util4.promisify)(import_child_process30.execFile);
 var MAX_BUFFER = 8 * 1024 * 1024;
 function resetStdinForChild() {
@@ -47754,7 +47819,7 @@ var GitHubCodespacesProvider = class {
     });
   }
   async uploadFile(workspaceId, remotePath, contents, options = {}) {
-    const remoteDir = path96.posix.dirname(remotePath);
+    const remoteDir = path97.posix.dirname(remotePath);
     const parts = [
       `mkdir -p ${shellQuote(remoteDir)}`,
       `cat > ${shellQuote(remotePath)}`
@@ -47824,7 +47889,7 @@ function shellQuote(s) {
 // src/services/providers/gitpod.ts
 var import_child_process31 = require("child_process");
 var import_util5 = require("util");
-var path97 = __toESM(require("path"));
+var path98 = __toESM(require("path"));
 var import_picocolors9 = __toESM(require("picocolors"));
 var execFileP7 = (0, import_util5.promisify)(import_child_process31.execFile);
 var MAX_BUFFER2 = 8 * 1024 * 1024;
@@ -48064,7 +48129,7 @@ var GitpodProvider = class {
     });
   }
   async uploadFile(workspaceId, remotePath, contents, options = {}) {
-    const remoteDir = path97.posix.dirname(remotePath);
+    const remoteDir = path98.posix.dirname(remotePath);
     const parts = [
       `mkdir -p ${shellQuote2(remoteDir)}`,
       `cat > ${shellQuote2(remotePath)}`
@@ -48100,7 +48165,7 @@ function shellQuote2(s) {
 // src/services/providers/gitlab-workspaces.ts
 var import_child_process32 = require("child_process");
 var import_util6 = require("util");
-var path98 = __toESM(require("path"));
+var path99 = __toESM(require("path"));
 var execFileP8 = (0, import_util6.promisify)(import_child_process32.execFile);
 var MAX_BUFFER3 = 8 * 1024 * 1024;
 var GITLAB_API_BASE = process.env.CODEAM_GITLAB_API_URL ?? "https://gitlab.com/api/v4";
@@ -48360,7 +48425,7 @@ Docs: https://docs.gitlab.com/ee/user/workspace/configuration.html`
   }
   async uploadFile(workspaceId, remotePath, contents, options = {}) {
     const sshHost = process.env.CODEAM_GITLAB_SSH_HOST ?? "workspaces.gitlab.com";
-    const remoteDir = path98.posix.dirname(remotePath);
+    const remoteDir = path99.posix.dirname(remotePath);
     const parts = [`mkdir -p ${shellQuote3(remoteDir)}`, `cat > ${shellQuote3(remotePath)}`];
     if (options.mode != null) {
       parts.push(`chmod ${options.mode.toString(8)} ${shellQuote3(remotePath)}`);
@@ -48428,7 +48493,7 @@ function shellQuote3(s) {
 // src/services/providers/railway.ts
 var import_child_process33 = require("child_process");
 var import_util7 = require("util");
-var path99 = __toESM(require("path"));
+var path100 = __toESM(require("path"));
 var execFileP9 = (0, import_util7.promisify)(import_child_process33.execFile);
 var MAX_BUFFER4 = 8 * 1024 * 1024;
 function resetStdinForChild4() {
@@ -48664,7 +48729,7 @@ var RailwayProvider = class {
     if (!projectId || !serviceId) {
       throw new Error("Invalid Railway workspace id (expected projectId/serviceId).");
     }
-    const remoteDir = path99.posix.dirname(remotePath);
+    const remoteDir = path100.posix.dirname(remotePath);
     const parts = [`mkdir -p ${shellQuote4(remoteDir)}`, `cat > ${shellQuote4(remotePath)}`];
     if (options.mode != null) {
       parts.push(`chmod ${options.mode.toString(8)} ${shellQuote4(remotePath)}`);
@@ -49204,9 +49269,9 @@ async function stopWorkspaceFromLocal(target) {
 }
 
 // src/commands/host/host-client.ts
-var fs86 = __toESM(require("fs"));
+var fs87 = __toESM(require("fs"));
 var os63 = __toESM(require("os"));
-var path100 = __toESM(require("path"));
+var path101 = __toESM(require("path"));
 var import_node_crypto16 = require("crypto");
 function sampleCpuTimes() {
   let idle = 0;
@@ -49255,7 +49320,7 @@ function apiBase() {
   return process.env.CODEAM_API_URL ?? resolveApiBaseUrl();
 }
 function hostIdentityPath() {
-  return path100.join(os63.homedir(), ".codeam", "host-agent.json");
+  return path101.join(os63.homedir(), ".codeam", "host-agent.json");
 }
 function collectOsInfo() {
   return {
@@ -49267,7 +49332,7 @@ function collectOsInfo() {
 }
 function loadHostIdentity() {
   try {
-    const raw = fs86.readFileSync(hostIdentityPath(), "utf8");
+    const raw = fs87.readFileSync(hostIdentityPath(), "utf8");
     const parsed = JSON.parse(raw);
     if (typeof parsed === "object" && parsed !== null && typeof parsed.hostId === "string" && typeof parsed.hostToken === "string" && typeof parsed.controlPluginId === "string") {
       const p2 = parsed;
@@ -49295,8 +49360,8 @@ function ensureControlPollSecret(identity, save = saveHostIdentity) {
 }
 function saveHostIdentity(identity) {
   const file = hostIdentityPath();
-  fs86.mkdirSync(path100.dirname(file), { recursive: true, mode: 448 });
-  fs86.writeFileSync(file, JSON.stringify(identity, null, 2), {
+  fs87.mkdirSync(path101.dirname(file), { recursive: true, mode: 448 });
+  fs87.writeFileSync(file, JSON.stringify(identity, null, 2), {
     encoding: "utf8",
     mode: 384
   });
@@ -49341,7 +49406,7 @@ function isTerminalEnrollError(err) {
 }
 function deleteHostIdentity() {
   try {
-    fs86.rmSync(hostIdentityPath(), { force: true });
+    fs87.rmSync(hostIdentityPath(), { force: true });
   } catch {
   }
 }
@@ -49559,8 +49624,8 @@ async function host(args2) {
 // src/commands/host-agent.ts
 var import_node_child_process35 = require("child_process");
 var os67 = __toESM(require("os"));
-var fs90 = __toESM(require("fs"));
-var path104 = __toESM(require("path"));
+var fs91 = __toESM(require("fs"));
+var path105 = __toESM(require("path"));
 
 // src/skills/persist-from-payload.ts
 function persistOrClearSkillsFromPayload(skills) {
@@ -49569,13 +49634,13 @@ function persistOrClearSkillsFromPayload(skills) {
 }
 
 // src/commands/host/session-state.ts
-var fs87 = __toESM(require("fs"));
+var fs88 = __toESM(require("fs"));
 var os64 = __toESM(require("os"));
-var path101 = __toESM(require("path"));
+var path102 = __toESM(require("path"));
 function hostSessionStatePath(env = process.env) {
   const override = env.CODEAM_HOST_SESSION_STATE_FILE;
   if (override && override.trim()) return override.trim();
-  return path101.join(os64.homedir(), ".codeam", "host-agent-sessions.json");
+  return path102.join(os64.homedir(), ".codeam", "host-agent-sessions.json");
 }
 function isRecord5(v) {
   if (typeof v !== "object" || v === null) return false;
@@ -49586,7 +49651,7 @@ function fileSessionChildStore(file = hostSessionStatePath()) {
   return {
     load() {
       try {
-        const raw = JSON.parse(fs87.readFileSync(file, "utf8"));
+        const raw = JSON.parse(fs88.readFileSync(file, "utf8"));
         return Array.isArray(raw?.sessions) ? raw.sessions.filter(isRecord5) : null;
       } catch {
         return null;
@@ -49594,18 +49659,18 @@ function fileSessionChildStore(file = hostSessionStatePath()) {
     },
     save(list) {
       try {
-        fs87.mkdirSync(path101.dirname(file), { recursive: true, mode: 448 });
+        fs88.mkdirSync(path102.dirname(file), { recursive: true, mode: 448 });
         const tmp = `${file}.${process.pid}.tmp`;
-        fs87.writeFileSync(tmp, JSON.stringify({ version: 1, sessions: list }, null, 2), {
+        fs88.writeFileSync(tmp, JSON.stringify({ version: 1, sessions: list }, null, 2), {
           mode: 384
         });
-        fs87.renameSync(tmp, file);
+        fs88.renameSync(tmp, file);
       } catch {
       }
     },
     clear() {
       try {
-        fs87.rmSync(file, { force: true });
+        fs88.rmSync(file, { force: true });
       } catch {
       }
     }
@@ -49628,10 +49693,10 @@ function planSessionResume(records, max) {
   return { resume: ordered.slice(0, bound), dropped: ordered.slice(bound) };
 }
 function pickSavedSessionForWorkspace(sessions3, cwd, deployId) {
-  const target = path101.resolve(cwd);
+  const target = path102.resolve(cwd);
   const reconnectable = (s) => !!s.pluginId && !!s.pollSecret && !!s.agent;
   const matches = sessions3.filter(
-    (s) => !!s.cwd && path101.resolve(s.cwd) === target && reconnectable(s)
+    (s) => !!s.cwd && path102.resolve(s.cwd) === target && reconnectable(s)
   );
   if (matches.length > 0) {
     matches.sort((a, b) => b.pairedAt - a.pairedAt);
@@ -49643,11 +49708,11 @@ function pickSavedSessionForWorkspace(sessions3, cwd, deployId) {
 
 // src/commands/host/git-tooling.ts
 var import_node_child_process31 = require("child_process");
-var fs88 = __toESM(require("fs"));
+var fs89 = __toESM(require("fs"));
 var os65 = __toESM(require("os"));
-var path102 = __toESM(require("path"));
+var path103 = __toESM(require("path"));
 function codeamBinDir() {
-  return process.env.CODEAM_BIN_DIR ?? path102.join(os65.homedir(), ".codeam", "bin");
+  return process.env.CODEAM_BIN_DIR ?? path103.join(os65.homedir(), ".codeam", "bin");
 }
 var FALLBACK_GH_VERSION = "2.62.0";
 var RELEASE_API = "https://api.github.com/repos/cli/cli/releases/latest";
@@ -49679,7 +49744,7 @@ async function download(url2, dest) {
     const res = await fetch(url2, { headers: { "User-Agent": "codeam-cli" } });
     if (!res.ok || !res.body) return false;
     const buf = Buffer.from(await res.arrayBuffer());
-    fs88.writeFileSync(dest, buf);
+    fs89.writeFileSync(dest, buf);
     return true;
   } catch {
     return false;
@@ -49702,8 +49767,8 @@ async function ensureGhCli(runner, token, deps = {}) {
     const version3 = await resolveVersionFn(token);
     const asset = `gh_${version3}_${osToken}_${arch2}`;
     const url2 = `https://github.com/cli/cli/releases/download/v${version3}/${asset}.${ext}`;
-    const tmpRoot = fs88.mkdtempSync(path102.join(os65.tmpdir(), "codeam-gh-"));
-    const archive = path102.join(tmpRoot, `${asset}.${ext}`);
+    const tmpRoot = fs89.mkdtempSync(path103.join(os65.tmpdir(), "codeam-gh-"));
+    const archive = path103.join(tmpRoot, `${asset}.${ext}`);
     if (!await downloadFn(url2, archive)) {
       log.warn("host-agent", "gh download failed \u2014 skipping (git pull/push still work via the credential helper)");
       return null;
@@ -49713,16 +49778,16 @@ async function ensureGhCli(runner, token, deps = {}) {
       log.warn("host-agent", `gh archive extraction failed (code=${String(extract.code)}) \u2014 skipping`);
       return null;
     }
-    const extractedBin = path102.join(tmpRoot, asset, "bin", binaryName);
-    if (!fs88.existsSync(extractedBin)) {
+    const extractedBin = path103.join(tmpRoot, asset, "bin", binaryName);
+    if (!fs89.existsSync(extractedBin)) {
       log.warn("host-agent", "gh binary not found in the extracted archive \u2014 skipping");
       return null;
     }
     const binDir = codeamBinDir();
-    fs88.mkdirSync(binDir, { recursive: true });
-    const target = path102.join(binDir, binaryName);
-    fs88.copyFileSync(extractedBin, target);
-    fs88.chmodSync(target, 493);
+    fs89.mkdirSync(binDir, { recursive: true });
+    const target = path103.join(binDir, binaryName);
+    fs89.copyFileSync(extractedBin, target);
+    fs89.chmodSync(target, 493);
     log.info("host-agent", `gh installed to ${target} (v${version3})`);
     return target;
   } catch (e) {
@@ -49759,19 +49824,19 @@ async function ensureGhAuth(runner, ghCmd, token) {
 }
 function ghConfigDir() {
   if (process.env.GH_CONFIG_DIR) return process.env.GH_CONFIG_DIR;
-  if (process.env.XDG_CONFIG_HOME) return path102.join(process.env.XDG_CONFIG_HOME, "gh");
+  if (process.env.XDG_CONFIG_HOME) return path103.join(process.env.XDG_CONFIG_HOME, "gh");
   if (process.platform === "win32" && process.env.APPDATA) {
-    return path102.join(process.env.APPDATA, "GitHub CLI");
+    return path103.join(process.env.APPDATA, "GitHub CLI");
   }
-  return path102.join(os65.homedir(), ".config", "gh");
+  return path103.join(os65.homedir(), ".config", "gh");
 }
 function writeGhHostsToken(token) {
   try {
     const dir = ghConfigDir();
-    const file = path102.join(dir, "hosts.yml");
-    if (fs88.existsSync(file)) return false;
-    fs88.mkdirSync(dir, { recursive: true, mode: 448 });
-    fs88.writeFileSync(
+    const file = path103.join(dir, "hosts.yml");
+    if (fs89.existsSync(file)) return false;
+    fs89.mkdirSync(dir, { recursive: true, mode: 448 });
+    fs89.writeFileSync(
       file,
       `github.com:
     oauth_token: ${token}
@@ -49814,8 +49879,8 @@ async function ensureGlabCli(runner, deps = {}) {
     const version3 = await resolveLatestGlabVersion();
     const asset = `glab_${version3}_${osToken}_${arch2}`;
     const url2 = `https://gitlab.com/gitlab-org/cli/-/releases/v${version3}/downloads/${asset}.${ext}`;
-    const tmpRoot = fs88.mkdtempSync(path102.join(os65.tmpdir(), "codeam-glab-"));
-    const archive = path102.join(tmpRoot, `${asset}.${ext}`);
+    const tmpRoot = fs89.mkdtempSync(path103.join(os65.tmpdir(), "codeam-glab-"));
+    const archive = path103.join(tmpRoot, `${asset}.${ext}`);
     if (!await downloadFn(url2, archive)) {
       log.warn("host-agent", "glab download failed \u2014 skipping (git push/pull still work)");
       return null;
@@ -49826,20 +49891,20 @@ async function ensureGlabCli(runner, deps = {}) {
       return null;
     }
     const candidates = [
-      path102.join(tmpRoot, "bin", binaryName),
-      path102.join(tmpRoot, asset, "bin", binaryName),
-      path102.join(tmpRoot, binaryName)
+      path103.join(tmpRoot, "bin", binaryName),
+      path103.join(tmpRoot, asset, "bin", binaryName),
+      path103.join(tmpRoot, binaryName)
     ];
-    const extractedBin = candidates.find((c2) => fs88.existsSync(c2));
+    const extractedBin = candidates.find((c2) => fs89.existsSync(c2));
     if (!extractedBin) {
       log.warn("host-agent", "glab binary not found in the extracted archive \u2014 skipping");
       return null;
     }
     const binDir = codeamBinDir();
-    fs88.mkdirSync(binDir, { recursive: true });
-    const target = path102.join(binDir, binaryName);
-    fs88.copyFileSync(extractedBin, target);
-    fs88.chmodSync(target, 493);
+    fs89.mkdirSync(binDir, { recursive: true });
+    const target = path103.join(binDir, binaryName);
+    fs89.copyFileSync(extractedBin, target);
+    fs89.chmodSync(target, 493);
     log.info("host-agent", `glab installed to ${target} (v${version3})`);
     return target;
   } catch (e) {
@@ -49921,9 +49986,9 @@ var defaultGitToolingRunner = {
 var import_node_child_process33 = require("child_process");
 
 // src/lib/updateNotifier.ts
-var fs89 = __toESM(require("fs"));
+var fs90 = __toESM(require("fs"));
 var os66 = __toESM(require("os"));
-var path103 = __toESM(require("path"));
+var path104 = __toESM(require("path"));
 var https8 = __toESM(require("https"));
 var import_node_child_process32 = require("child_process");
 var import_picocolors12 = __toESM(require("picocolors"));
@@ -49932,12 +49997,12 @@ var REGISTRY_URL = `https://registry.npmjs.org/${PKG_NAME}/latest`;
 var TTL_MS = 24 * 60 * 60 * 1e3;
 var REQUEST_TIMEOUT_MS = 1500;
 function cachePath() {
-  const dir = path103.join(os66.homedir(), ".codeam");
-  return path103.join(dir, "update-check.json");
+  const dir = path104.join(os66.homedir(), ".codeam");
+  return path104.join(dir, "update-check.json");
 }
 function readCache() {
   try {
-    const raw = fs89.readFileSync(cachePath(), "utf8");
+    const raw = fs90.readFileSync(cachePath(), "utf8");
     const parsed = JSON.parse(raw);
     if (typeof parsed.fetchedAt !== "number" || typeof parsed.latest !== "string") return null;
     return parsed;
@@ -49948,10 +50013,10 @@ function readCache() {
 function writeCache(cache) {
   try {
     const file = cachePath();
-    fs89.mkdirSync(path103.dirname(file), { recursive: true });
+    fs90.mkdirSync(path104.dirname(file), { recursive: true });
     const tmp = `${file}.${process.pid}.tmp`;
-    fs89.writeFileSync(tmp, JSON.stringify(cache));
-    fs89.renameSync(tmp, file);
+    fs90.writeFileSync(tmp, JSON.stringify(cache));
+    fs90.renameSync(tmp, file);
   } catch {
   }
 }
@@ -50025,8 +50090,8 @@ function isLinkedInstall() {
       timeout: 2e3
     }).trim();
     if (!root) return false;
-    const pkgPath = path103.join(root, PKG_NAME);
-    return fs89.lstatSync(pkgPath).isSymbolicLink();
+    const pkgPath = path104.join(root, PKG_NAME);
+    return fs90.lstatSync(pkgPath).isSymbolicLink();
   } catch {
     return false;
   }
@@ -50062,7 +50127,7 @@ function maybeAutoUpdate(currentVersion, latest) {
     return;
   }
   try {
-    fs89.unlinkSync(cachePath());
+    fs90.unlinkSync(cachePath());
   } catch {
   }
   process.stderr.write(`  ${import_picocolors12.default.green("\u2713")} Updated. Resuming session...
@@ -50078,7 +50143,7 @@ async function autoUpgradeBeforeCriticalCommand() {
   if (process.env.NODE_ENV === "test") return;
   if (process.env.CODEAM_DISABLE_UPDATE_CHECK === "1") return;
   if (process.env.CI) return;
-  const current2 = true ? "2.76.7" : null;
+  const current2 = true ? "2.76.9" : null;
   if (!current2) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -50095,7 +50160,7 @@ function checkForUpdates() {
   if (process.env.CODEAM_DISABLE_UPDATE_CHECK === "1") return;
   if (process.env.CI) return;
   if (!process.stdout.isTTY) return;
-  const current2 = true ? "2.76.7" : null;
+  const current2 = true ? "2.76.9" : null;
   if (!current2) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -50118,7 +50183,7 @@ var SELF_UPDATE_INSTALL_TIMEOUT_MS = 18e4;
 var SELF_UPDATE_LS_TIMEOUT_MS = 15e3;
 var SUDO_PREFLIGHT_TIMEOUT_MS = 5e3;
 function currentCliVersion() {
-  return true ? "2.76.7" : null;
+  return true ? "2.76.9" : null;
 }
 async function installedVersion(deps) {
   const ls = await deps.run(
@@ -50471,7 +50536,7 @@ var ORPHAN_KILL_SETTLE_MS = 500;
 function needsSelfRelaunch(env = process.env, pid = process.pid) {
   return !env.INVOCATION_ID && pid !== 1;
 }
-function isContainerEnvironment(existsSyncFn = fs90.existsSync, readFileSyncFn = (p2) => fs90.readFileSync(p2, "utf8")) {
+function isContainerEnvironment(existsSyncFn = fs91.existsSync, readFileSyncFn = (p2) => fs91.readFileSync(p2, "utf8")) {
   try {
     if (existsSyncFn("/.dockerenv")) return true;
   } catch {
@@ -50936,13 +51001,13 @@ var HostAgentSupervisor = class {
     const relay = this.relay;
     if (!relay) return;
     const raw = cmd.payload?.path;
-    const target = typeof raw === "string" && raw.trim() ? path104.resolve(raw.trim()) : os67.homedir();
+    const target = typeof raw === "string" && raw.trim() ? path105.resolve(raw.trim()) : os67.homedir();
     try {
-      const dirents = await fs90.promises.readdir(target, { withFileTypes: true });
+      const dirents = await fs91.promises.readdir(target, { withFileTypes: true });
       const entries2 = dirents.filter((d3) => !d3.name.startsWith(".")).map((d3) => ({ name: d3.name, isDir: d3.isDirectory() })).sort(
         (a, b) => a.isDir === b.isDir ? a.name.localeCompare(b.name) : a.isDir ? -1 : 1
       );
-      const parent = path104.dirname(target);
+      const parent = path105.dirname(target);
       await relay.sendResult(cmd.id, "completed", {
         path: target,
         // null at the filesystem root so the UI can hide the ".." affordance.
@@ -51290,14 +51355,14 @@ var HostAgentSupervisor = class {
           ...buildHouseProxyChildEnv({ baseUrl, token, openRouter: openRouter === true }),
           CODEAM_AUTO_TOKEN: payload.autoPairToken
         };
-        const houseConfigDir = path104.join(
+        const houseConfigDir = path105.join(
           os67.homedir(),
           ".codeam",
           "house-claude",
           payload.deployId
         );
         try {
-          fs90.mkdirSync(houseConfigDir, { recursive: true, mode: 448 });
+          fs91.mkdirSync(houseConfigDir, { recursive: true, mode: 448 });
         } catch {
         }
         childEnv.CLAUDE_CONFIG_DIR = houseConfigDir;
@@ -51331,13 +51396,13 @@ var HostAgentSupervisor = class {
           if ((payload.repoProvider ?? "github") === "gitlab") {
             const glabCmd = await ensureGlabCli(defaultGitToolingRunner);
             if (glabCmd) {
-              childEnv.PATH = `${codeamBinDir()}${path104.delimiter}${childEnv.PATH}`;
+              childEnv.PATH = `${codeamBinDir()}${path105.delimiter}${childEnv.PATH}`;
               await ensureGlabAuth(defaultGitToolingRunner, glabCmd, payload.cloneToken);
             }
           } else {
             const ghCmd = await ensureGhCli(defaultGitToolingRunner, payload.cloneToken);
             if (ghCmd) {
-              childEnv.PATH = `${codeamBinDir()}${path104.delimiter}${childEnv.PATH}`;
+              childEnv.PATH = `${codeamBinDir()}${path105.delimiter}${childEnv.PATH}`;
               await ensureGhAuth(defaultGitToolingRunner, ghCmd, payload.cloneToken);
             }
           }
@@ -51365,9 +51430,9 @@ var HostAgentSupervisor = class {
       );
       if (!payload.suppressOnboardingWelcome) {
         try {
-          const cfgDir = childEnv.CLAUDE_CONFIG_DIR || path104.join(os67.homedir(), ".claude");
-          const projectDir = path104.join(cfgDir, "projects", encodeCwd(cwd));
-          const hasPriorConversation = fs90.existsSync(projectDir) && fs90.readdirSync(projectDir).some((f) => f.endsWith(".jsonl"));
+          const cfgDir = childEnv.CLAUDE_CONFIG_DIR || path105.join(os67.homedir(), ".claude");
+          const projectDir = path105.join(cfgDir, "projects", encodeCwd(cwd));
+          const hasPriorConversation = fs91.existsSync(projectDir) && fs91.readdirSync(projectDir).some((f) => f.endsWith(".jsonl"));
           if (hasPriorConversation) {
             childEnv.CODEAM_RESUME_LATEST = "1";
             log.info(
@@ -51521,7 +51586,7 @@ var HostAgentSupervisor = class {
   fallbackResumeTarget() {
     const session = getActiveSession();
     if (!session || !session.pluginId || !session.pollSecret || !session.agent) return null;
-    const cwd = session.cwd && fs90.existsSync(session.cwd) ? session.cwd : process.cwd();
+    const cwd = session.cwd && fs91.existsSync(session.cwd) ? session.cwd : process.cwd();
     if (isFilesystemRoot(cwd)) {
       log.warn(
         "host-agent",
@@ -51561,7 +51626,7 @@ var HostAgentSupervisor = class {
       log.warn("host-agent", `self_hosted_resume ${sessionId.slice(0, 8)}: no saved pairing on this box`);
       return;
     }
-    if (!session.cwd || !fs90.existsSync(session.cwd)) {
+    if (!session.cwd || !fs91.existsSync(session.cwd)) {
       log.warn("host-agent", `self_hosted_resume ${sessionId.slice(0, 8)}: workspace is gone`);
       return;
     }
@@ -51603,7 +51668,7 @@ var HostAgentSupervisor = class {
       const persisted = new Map((this.sessionStore.load() ?? []).map((r) => [r.deployId, r.agent]));
       for (const c2 of this.children.values()) persisted.set(c2.deployId, c2.agent);
       return this.listSavedSessions().map((s) => ({ s, deployId: deployIdFromWorkspace(s.cwd) })).filter(
-        (x) => x.deployId !== null && !!x.s.cwd && fs90.existsSync(x.s.cwd)
+        (x) => x.deployId !== null && !!x.s.cwd && fs91.existsSync(x.s.cwd)
       ).map(({ s, deployId }) => {
         const agent = persisted.get(deployId);
         return { deployId, sessionId: s.id, ...agent ? { agent } : {} };
@@ -51655,7 +51720,7 @@ var HostAgentSupervisor = class {
     if (this.children.has(deployId)) return;
     const st3 = this.resumeStateFor(target);
     try {
-      const cwd = fs90.existsSync(target.cwd) ? target.cwd : process.cwd();
+      const cwd = fs91.existsSync(target.cwd) ? target.cwd : process.cwd();
       const proc = this.resumeSpawner(
         { ...readHouseProxyChildEnv(deployId), CODEAM_RESUME_SESSION_ID: session.id },
         cwd
@@ -51874,12 +51939,12 @@ var HostAgentSupervisor = class {
       this.untrackChild(deployId);
     }
     const dirs = [
-      path104.join(selfHostedWorkspaceRoot(), deployId),
-      path104.join(os67.homedir(), ".codeam", "house-claude", deployId)
+      path105.join(selfHostedWorkspaceRoot(), deployId),
+      path105.join(os67.homedir(), ".codeam", "house-claude", deployId)
     ];
     for (const dir of dirs) {
       try {
-        fs90.rmSync(dir, { recursive: true, force: true });
+        fs91.rmSync(dir, { recursive: true, force: true });
       } catch (err) {
         log.warn(
           "host-agent",
@@ -52039,8 +52104,8 @@ async function invite() {
 var import_node_dns = require("dns");
 var import_node_util11 = require("util");
 var import_node_crypto17 = require("crypto");
-var fs91 = __toESM(require("fs"));
-var path105 = __toESM(require("path"));
+var fs92 = __toESM(require("fs"));
+var path106 = __toESM(require("path"));
 var import_picocolors14 = __toESM(require("picocolors"));
 var dnsResolveP = (0, import_node_util11.promisify)(import_node_dns.resolve);
 async function checkDns(apiBase2) {
@@ -52096,13 +52161,13 @@ async function checkHealth(apiBase2) {
   }
 }
 function checkConfigDir() {
-  const dir = path105.join(require("os").homedir(), ".codeam");
+  const dir = path106.join(require("os").homedir(), ".codeam");
   try {
-    fs91.mkdirSync(dir, { recursive: true, mode: 448 });
-    const probe = path105.join(dir, ".doctor-probe");
-    fs91.writeFileSync(probe, "ok", { mode: 384 });
-    const read = fs91.readFileSync(probe, "utf8");
-    fs91.unlinkSync(probe);
+    fs92.mkdirSync(dir, { recursive: true, mode: 448 });
+    const probe = path106.join(dir, ".doctor-probe");
+    fs92.writeFileSync(probe, "ok", { mode: 384 });
+    const read = fs92.readFileSync(probe, "utf8");
+    fs92.unlinkSync(probe);
     if (read !== "ok") throw new Error("write/read round-trip mismatch");
     return {
       id: "config-dir",
@@ -52166,7 +52231,7 @@ function checkNodePty() {
       detail: "not required on this platform"
     };
   }
-  const vendoredPath = path105.join(__dirname, "vendor", "node-pty");
+  const vendoredPath = path106.join(__dirname, "vendor", "node-pty");
   for (const target of [vendoredPath, "node-pty"]) {
     try {
       require(target);
@@ -52208,7 +52273,7 @@ function checkChokidar() {
 }
 async function doctor(args2 = []) {
   const json = args2.includes("--json");
-  const cliVersion = true ? "2.76.7" : "0.0.0-dev";
+  const cliVersion = true ? "2.76.9" : "0.0.0-dev";
   const apiBase2 = resolveApiBaseUrl();
   const diagnosticId = (0, import_node_crypto17.randomUUID)();
   log.info("doctor", `run id=${diagnosticId} cli=${cliVersion}`);
@@ -52415,9 +52480,9 @@ var LAUNCHER_ENV = Object.freeze({
 });
 
 // src/integrations/mcp-run.ts
-var import_node_fs21 = require("fs");
+var import_node_fs22 = require("fs");
 var import_node_os18 = __toESM(require("os"));
-var import_node_path23 = __toESM(require("path"));
+var import_node_path24 = __toESM(require("path"));
 
 // src/integrations/token-client.ts
 var REFRESH_AHEAD_MS = 5 * 60 * 1e3;
@@ -52497,13 +52562,13 @@ function commandExists(command2) {
 }
 function localBinCandidates(command2) {
   return [
-    import_node_path23.default.join(import_node_os18.default.homedir(), ".local", "bin", command2),
-    import_node_path23.default.join(import_node_os18.default.homedir(), ".cargo", "bin", command2)
+    import_node_path24.default.join(import_node_os18.default.homedir(), ".local", "bin", command2),
+    import_node_path24.default.join(import_node_os18.default.homedir(), ".cargo", "bin", command2)
   ];
 }
 function resolveLauncherPath(command2, deps = {
   commandExists,
-  existsSync: import_node_fs21.existsSync
+  existsSync: import_node_fs22.existsSync
 }) {
   if (deps.commandExists(command2)) return command2;
   for (const candidate of localBinCandidates(command2)) {
@@ -52732,7 +52797,7 @@ async function mcpWarm(argv = [], opts = {}) {
 // src/commands/version.ts
 var import_picocolors15 = __toESM(require("picocolors"));
 function version2() {
-  const v = true ? "2.76.7" : "unknown";
+  const v = true ? "2.76.9" : "unknown";
   console.log(`${import_picocolors15.default.bold("codeam-cli")} ${import_picocolors15.default.cyan(v)}`);
 }