codeam-cli 2.61.38 → 2.61.40

package/CHANGELOG.md

@@ -4,6 +4,18 @@ All notable changes to `codeam-cli` are documented here.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.61.39] — 2026-07-25
+
+### Performance
+
+- **cli:** Un-gate the agent spawn from beads provisioning (codespace)
+
+## [2.61.38] — 2026-07-24
+
+### Fixed
+
+- **box:** Bake procps (`ps`) into the image — Beads/Dolt need it to manage the shared server
+
 ## [2.61.37] — 2026-07-24
 
 ### Fixed

package/dist/index.js

@@ -1453,11 +1453,11 @@ function quiet(fn) {
     log.debug(TAG, "ignored sync error", err);
   }
 }
-function rmIfExistsQuiet(path78) {
+function rmIfExistsQuiet(path79) {
   try {
-    fs2.rmSync(path78, { force: true });
+    fs2.rmSync(path79, { force: true });
   } catch (err) {
-    log.debug(TAG, `rmIfExists failed for ${path78}`, err);
+    log.debug(TAG, `rmIfExists failed for ${path79}`, err);
   }
 }
 function killQuiet(target, signal = "SIGTERM") {
@@ -1641,8 +1641,8 @@ function createGetModuleFromFilename(basePath = process.argv[1] ? (0, import_pat
     return decodedFile;
   };
 }
-function normalizeWindowsPath(path78) {
-  return path78.replace(/^[A-Z]:/, "").replace(/\\/g, "/");
+function normalizeWindowsPath(path79) {
+  return path79.replace(/^[A-Z]:/, "").replace(/\\/g, "/");
 }
 
 // ../../node_modules/@posthog/core/dist/featureFlagUtils.mjs
@@ -4122,9 +4122,9 @@ async function addSourceContext(frames) {
   LRU_FILE_CONTENTS_CACHE.reduce();
   return frames;
 }
-function getContextLinesFromFile(path78, ranges, output) {
+function getContextLinesFromFile(path79, ranges, output) {
   return new Promise((resolve8) => {
-    const stream = (0, import_node_fs.createReadStream)(path78);
+    const stream = (0, import_node_fs.createReadStream)(path79);
     const lineReaded = (0, import_node_readline.createInterface)({
       input: stream
     });
@@ -4139,7 +4139,7 @@ function getContextLinesFromFile(path78, ranges, output) {
     let rangeStart = range[0];
     let rangeEnd = range[1];
     function onStreamError() {
-      LRU_FILE_CONTENTS_FS_READ_FAILED.set(path78, 1);
+      LRU_FILE_CONTENTS_FS_READ_FAILED.set(path79, 1);
       lineReaded.close();
       lineReaded.removeAllListeners();
       destroyStreamAndResolve();
@@ -4200,8 +4200,8 @@ function clearLineContext(frame) {
   delete frame.context_line;
   delete frame.post_context;
 }
-function shouldSkipContextLinesForFile(path78) {
-  return path78.startsWith("node:") || path78.endsWith(".min.js") || path78.endsWith(".min.cjs") || path78.endsWith(".min.mjs") || path78.startsWith("data:");
+function shouldSkipContextLinesForFile(path79) {
+  return path79.startsWith("node:") || path79.endsWith(".min.js") || path79.endsWith(".min.cjs") || path79.endsWith(".min.mjs") || path79.startsWith("data:");
 }
 function shouldSkipContextLinesForFrame(frame) {
   if (void 0 !== frame.lineno && frame.lineno > MAX_CONTEXTLINES_LINENO) return true;
@@ -6355,7 +6355,7 @@ function readAnonId() {
 }
 function superProperties() {
   return {
-    cliVersion: true ? "2.61.38" : "0.0.0-dev",
+    cliVersion: true ? "2.61.40" : "0.0.0-dev",
     nodeVersion: process.version,
     platform: process.platform,
     arch: process.arch,
@@ -6536,7 +6536,7 @@ var os4 = __toESM(require("os"));
 // package.json
 var package_default = {
   name: "codeam-cli",
-  version: "2.61.38",
+  version: "2.61.40",
   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",
@@ -7707,7 +7707,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.61.38" ? { ideVersion: "2.61.38" } : {}
+      ..."2.61.40" ? { ideVersion: "2.61.40" } : {}
     }).then(() => log.trace("relay", `heartbeat ok online=${online}`)).catch((err) => log.trace("relay", `heartbeat failed online=${online}`, err));
   }
   /**
@@ -7934,10 +7934,10 @@ var WINDOWS_LEGACY_JUNCTIONS = [
   /[\\/]Start Menu([\\/]|$)/i,
   /[\\/]Templates([\\/]|$)/i
 ];
-function isUnsafeWindowsWatchRoot(dir, homedir45) {
+function isUnsafeWindowsWatchRoot(dir, homedir46) {
   const norm = (p2) => p2.replace(/\//g, "\\").replace(/\\+$/, "").toLowerCase();
   const cwd = norm(dir);
-  const home = norm(homedir45);
+  const home = norm(homedir46);
   if (cwd === home) return true;
   if (/^[a-z]:$/.test(cwd)) return true;
   const sysRoots = [
@@ -12563,10 +12563,10 @@ function buildForPlatform(platform3) {
 var import_node_crypto4 = require("crypto");
 
 // src/agents/claude/resolver.ts
-function buildClaudeLaunch(extraArgs = [], os58 = createOsStrategy()) {
-  const found = os58.findInPath("claude") ?? os58.findInPath("claude-code");
+function buildClaudeLaunch(extraArgs = [], os59 = createOsStrategy()) {
+  const found = os59.findInPath("claude") ?? os59.findInPath("claude-code");
   if (!found) return null;
-  return os58.buildLaunch(found, extraArgs);
+  return os59.buildLaunch(found, extraArgs);
 }
 
 // src/agents/claude/installer.ts
@@ -13156,8 +13156,8 @@ var ClaudeRuntimeStrategy = class {
   meta = getAgent("claude");
   mode = "interactive";
   os;
-  constructor(os58) {
-    this.os = os58;
+  constructor(os59) {
+    this.os = os59;
   }
   /**
    * Claude Code's react-ink TUI enables bracketed-paste mode at
@@ -13937,8 +13937,8 @@ function codexCredentialLocator() {
 function codexLoginLauncher() {
   return {
     async ensureInstalled() {
-      const os58 = createOsStrategy();
-      return os58.findInPath("codex") !== null;
+      const os59 = createOsStrategy();
+      return os59.findInPath("codex") !== null;
     },
     launch() {
       return (0, import_node_child_process4.spawn)("codex", ["login"], { stdio: "inherit" });
@@ -13961,8 +13961,8 @@ var CodexRuntimeStrategy = class {
   meta = getAgent("codex");
   mode = "interactive";
   os;
-  constructor(os58) {
-    this.os = os58;
+  constructor(os59) {
+    this.os = os59;
   }
   async prepareLaunch() {
     let binary = this.os.findInPath("codex");
@@ -14071,12 +14071,12 @@ var CodexRuntimeStrategy = class {
     });
   }
 };
-function resolveNpm(os58) {
-  return os58.id === "win32" ? "npm.cmd" : "npm";
+function resolveNpm(os59) {
+  return os59.id === "win32" ? "npm.cmd" : "npm";
 }
-async function installCodexViaNpm(os58) {
+async function installCodexViaNpm(os59) {
   return new Promise((resolve8, reject) => {
-    const proc = (0, import_node_child_process5.spawn)(resolveNpm(os58), ["install", "-g", "@openai/codex"], {
+    const proc = (0, import_node_child_process5.spawn)(resolveNpm(os59), ["install", "-g", "@openai/codex"], {
       stdio: "inherit"
     });
     proc.on("close", (code) => {
@@ -14093,16 +14093,16 @@ async function installCodexViaNpm(os58) {
     });
   });
 }
-function augmentNpmGlobalBin(os58) {
+function augmentNpmGlobalBin(os59) {
   try {
-    const result = (0, import_node_child_process5.spawnSync)(resolveNpm(os58), ["prefix", "-g"], {
+    const result = (0, import_node_child_process5.spawnSync)(resolveNpm(os59), ["prefix", "-g"], {
       stdio: ["ignore", "pipe", "ignore"]
     });
     if (result.status !== 0) return;
     const prefix = result.stdout.toString().trim();
     if (!prefix) return;
-    const binDir = os58.id === "win32" ? prefix : path24.join(prefix, "bin");
-    os58.augmentPath([binDir]);
+    const binDir = os59.id === "win32" ? prefix : path24.join(prefix, "bin");
+    os59.augmentPath([binDir]);
   } catch {
   }
 }
@@ -14186,9 +14186,9 @@ var import_node_child_process8 = require("child_process");
 // src/agents/coderabbit/installer.ts
 var import_node_child_process6 = require("child_process");
 var INSTALL_URL = "https://cli.coderabbit.ai/install.sh";
-async function ensureCoderabbitInstalled(os58) {
-  if (os58.findInPath("coderabbit")) return true;
-  if (os58.id === "win32") {
+async function ensureCoderabbitInstalled(os59) {
+  if (os59.findInPath("coderabbit")) return true;
+  if (os59.id === "win32") {
     console.error(
       "\n  \u2717 CodeRabbit on Windows requires WSL.\n    Install the CLI inside your WSL distribution\n    (curl -fsSL https://cli.coderabbit.ai/install.sh | sh)\n    then re-run `codeam link coderabbit` from WSL.\n"
     );
@@ -14221,8 +14221,8 @@ async function ensureCoderabbitInstalled(os58) {
     proc.on("error", () => finish(false));
   });
   if (!ok) return false;
-  os58.augmentPath([`${os58.homeDir()}/.local/bin`, "/opt/homebrew/bin"]);
-  return os58.findInPath("coderabbit") !== null;
+  os59.augmentPath([`${os59.homeDir()}/.local/bin`, "/opt/homebrew/bin"]);
+  return os59.findInPath("coderabbit") !== null;
 }
 
 // src/agents/coderabbit/link.ts
@@ -14257,10 +14257,10 @@ function coderabbitCredentialLocator() {
     validate: validateNonEmptyCredential
   };
 }
-function coderabbitLoginLauncher(os58) {
+function coderabbitLoginLauncher(os59) {
   return {
     async ensureInstalled() {
-      return ensureCoderabbitInstalled(os58);
+      return ensureCoderabbitInstalled(os59);
     },
     launch() {
       return (0, import_node_child_process7.spawn)("coderabbit", ["auth", "login"], { stdio: "inherit" });
@@ -14316,8 +14316,8 @@ function pickLine(obj) {
 function toHunk(raw, groupSeverity) {
   if (!raw || typeof raw !== "object") return null;
   const o = raw;
-  const path78 = asString(pick(o, ["file_path", "filePath", "file", "path", "filename", "fileName"])) ?? asString(pick(o, ["location"])?.path);
-  if (!path78) return null;
+  const path79 = asString(pick(o, ["file_path", "filePath", "file", "path", "filename", "fileName"])) ?? asString(pick(o, ["location"])?.path);
+  if (!path79) return null;
   const message = asString(
     pick(o, [
       "comment",
@@ -14334,7 +14334,7 @@ function toHunk(raw, groupSeverity) {
   const severity = normSeverity(pick(o, ["severity", "level", "priority", "impact"])) ?? normSeverity(groupSeverity);
   const locObj = pick(o, ["location"]) ?? o;
   return {
-    path: path78.trim(),
+    path: path79.trim(),
     line: pickLine(o) ?? pickLine(locObj),
     severity,
     message: (title && message ? `${title}: ${message}` : title || message).trim() || "(no message)"
@@ -14417,10 +14417,10 @@ function parsePlain(stdout) {
   for (const line of stdout.split(/\r?\n/)) {
     const m = line.match(HUNK_LINE_RE);
     if (!m) continue;
-    const [, path78, lineNo, sevToken, message] = m;
-    if (!path78 || !lineNo || !message) continue;
+    const [, path79, lineNo, sevToken, message] = m;
+    if (!path79 || !lineNo || !message) continue;
     hunks.push({
-      path: path78.trim(),
+      path: path79.trim(),
       line: Number(lineNo),
       severity: sevToken ? SEVERITY_MAP[sevToken.toLowerCase()] : void 0,
       message: message.trim().replace(/^[*-]\s+/, "")
@@ -14480,8 +14480,8 @@ var CoderabbitRuntimeStrategy = class {
   meta = getAgent("coderabbit");
   mode = "batch";
   os;
-  constructor(os58) {
-    this.os = os58;
+  constructor(os59) {
+    this.os = os59;
   }
   getDefaultArgs() {
     return ["review", "--agent"];
@@ -14752,10 +14752,10 @@ function cursorCredentialLocator() {
     validate: validateNonEmptyCredential
   };
 }
-function cursorLoginLauncher(os58) {
+function cursorLoginLauncher(os59) {
   return {
     async ensureInstalled() {
-      if (os58.findInPath("cursor-agent")) return true;
+      if (os59.findInPath("cursor-agent")) return true;
       console.error(
         "\n  \u2717 cursor-agent binary not on PATH.\n    Install Cursor (https://cursor.com/) and ensure the CLI\n    plugin is enabled, then re-run `codeam link cursor`.\n"
       );
@@ -14819,8 +14819,8 @@ var CursorRuntimeStrategy = class {
   meta = getAgent("cursor");
   mode = "interactive";
   os;
-  constructor(os58) {
-    this.os = os58;
+  constructor(os59) {
+    this.os = os59;
   }
   async prepareLaunch() {
     const binary = this.os.findInPath("cursor-agent");
@@ -15036,10 +15036,10 @@ function aiderCredentialLocator() {
     validate: validateNonEmptyCredential
   };
 }
-function aiderLoginLauncher(os58) {
+function aiderLoginLauncher(os59) {
   return {
     async ensureInstalled() {
-      if (os58.findInPath("aider")) return true;
+      if (os59.findInPath("aider")) return true;
       console.error(
         "\n  \u2717 aider binary not on PATH.\n    Install Aider:\n      pip install aider-chat\n    then re-run `codeam link aider`.\n"
       );
@@ -15049,7 +15049,7 @@ function aiderLoginLauncher(os58) {
       console.error(
         "\n  Aider has no interactive login flow.\n    Set ANTHROPIC_API_KEY or OPENAI_API_KEY in your shell,\n    or re-run `codeam link aider --api-key=<your-key>`.\n"
       );
-      return (0, import_node_child_process11.spawn)(os58.id === "win32" ? "cmd.exe" : "sh", os58.id === "win32" ? ["/c", "exit", "0"] : ["-c", "exit 0"], {
+      return (0, import_node_child_process11.spawn)(os59.id === "win32" ? "cmd.exe" : "sh", os59.id === "win32" ? ["/c", "exit", "0"] : ["-c", "exit 0"], {
         stdio: "ignore"
       });
     }
@@ -15121,8 +15121,8 @@ var AiderRuntimeStrategy = class {
   meta = getAgent("aider");
   mode = "interactive";
   os;
-  constructor(os58) {
-    this.os = os58;
+  constructor(os59) {
+    this.os = os59;
   }
   async prepareLaunch() {
     const binary = this.os.findInPath("aider");
@@ -15254,8 +15254,8 @@ function geminiCredentialLocator() {
 function geminiLoginLauncher() {
   return {
     async ensureInstalled() {
-      const os58 = createOsStrategy();
-      return os58.findInPath("gemini") !== null;
+      const os59 = createOsStrategy();
+      return os59.findInPath("gemini") !== null;
     },
     launch() {
       return (0, import_node_child_process12.spawn)("gemini", ["auth", "login"], { stdio: "inherit" });
@@ -15445,8 +15445,8 @@ var GeminiRuntimeStrategy = class {
   meta = getAgent("gemini");
   mode = "interactive";
   os;
-  constructor(os58) {
-    this.os = os58;
+  constructor(os59) {
+    this.os = os59;
   }
   async prepareLaunch() {
     const binary = this.os.findInPath("gemini");
@@ -15737,8 +15737,8 @@ var KimiRuntimeStrategy = class {
   meta = getAgent("kimi");
   mode = "interactive";
   os;
-  constructor(os58) {
-    this.os = os58;
+  constructor(os59) {
+    this.os = os59;
   }
   async prepareLaunch() {
     const binary = this.os.findInPath("kimi");
@@ -15851,19 +15851,19 @@ var KimiRuntimeStrategy = class {
 
 // src/agents/registry.ts
 var runtimeBuilders = {
-  claude: (os58) => new ClaudeRuntimeStrategy(os58),
-  codex: (os58) => new CodexRuntimeStrategy(os58),
-  coderabbit: (os58) => new CoderabbitRuntimeStrategy(os58),
-  cursor: (os58) => new CursorRuntimeStrategy(os58),
-  aider: (os58) => new AiderRuntimeStrategy(os58),
-  gemini: (os58) => new GeminiRuntimeStrategy(os58),
-  kimi: (os58) => new KimiRuntimeStrategy(os58)
+  claude: (os59) => new ClaudeRuntimeStrategy(os59),
+  codex: (os59) => new CodexRuntimeStrategy(os59),
+  coderabbit: (os59) => new CoderabbitRuntimeStrategy(os59),
+  cursor: (os59) => new CursorRuntimeStrategy(os59),
+  aider: (os59) => new AiderRuntimeStrategy(os59),
+  gemini: (os59) => new GeminiRuntimeStrategy(os59),
+  kimi: (os59) => new KimiRuntimeStrategy(os59)
 };
 var deployBuilders = {
   claude: () => new ClaudeDeployStrategy(),
   codex: () => new CodexDeployStrategy()
 };
-function createAgentStrategy(agent, os58 = createOsStrategy()) {
+function createAgentStrategy(agent, os59 = createOsStrategy()) {
   if (!AGENT_REGISTRY[agent]?.enabled) {
     throw new Error(
       `Agent "${agent}" is not supported in this codeam-cli version. Upgrade with 'npm i -g codeam-cli@latest'.`
@@ -15873,10 +15873,10 @@ function createAgentStrategy(agent, os58 = createOsStrategy()) {
   if (!build) {
     throw new Error(`No runtime strategy registered for agent "${agent}"`);
   }
-  return build(os58);
+  return build(os59);
 }
-function createInteractiveAgentStrategy(agent, os58 = createOsStrategy()) {
-  const s = createAgentStrategy(agent, os58);
+function createInteractiveAgentStrategy(agent, os59 = createOsStrategy()) {
+  const s = createAgentStrategy(agent, os59);
   if (s.mode !== "interactive") {
     throw new Error(
       `Agent "${agent}" is a batch agent; use createAgentStrategy + .runOneShot for one-shot reviews.`
@@ -16573,26 +16573,26 @@ function restoreCoderabbitOauthBlob(value) {
   (0, import_node_fs5.writeFileSync)(path36.join(dir, file), contents, { mode: 384 });
 }
 async function configureCoderabbit(input, deps = {}) {
-  const os58 = deps.os ?? createOsStrategy();
+  const os59 = deps.os ?? createOsStrategy();
   const ensureInstalled = deps.ensureInstalled ?? ensureCoderabbitInstalled;
   const isLoggedIn = deps.isLoggedIn ?? defaultIsLoggedIn;
   const runOAuth = deps.runOAuthLogin ?? runCoderabbitOAuthLogin;
   const snapshot = deps.snapshotDir ?? (() => snapshotCredentialDir());
   const capture2 = deps.captureCredential ?? ((b) => diffCapturedCredential(b));
   const loginWithApiKey = deps.loginWithApiKey ?? defaultLoginWithApiKey;
-  const home = os58.homeDir();
-  os58.augmentPath(
-    os58.id === "win32" ? [
+  const home = os59.homeDir();
+  os59.augmentPath(
+    os59.id === "win32" ? [
       path36.join(home, ".local", "bin"),
       path36.join(process.env.APPDATA ?? path36.join(home, "AppData", "Roaming"), "npm"),
       path36.join(home, "scoop", "shims")
     ] : [path36.join(home, ".local", "bin"), "/opt/homebrew/bin", "/usr/local/bin"]
   );
-  const installed2 = os58.findInPath("coderabbit") !== null;
+  const installed2 = os59.findInPath("coderabbit") !== null;
   const base = () => ({
     action: input.action,
     supported: true,
-    installed: os58.findInPath("coderabbit") !== null,
+    installed: os59.findInPath("coderabbit") !== null,
     loggedIn: false
   });
   if (input.action === "status") {
@@ -16606,7 +16606,7 @@ async function configureCoderabbit(input, deps = {}) {
     const key = (input.apiKey ?? "").trim();
     if (!key) return { ...res2, error: "No API key provided" };
     if (!res2.installed) {
-      const ok = await ensureInstalled(os58);
+      const ok = await ensureInstalled(os59);
       res2.installed = ok;
       if (!ok) return { ...res2, error: "CodeRabbit CLI could not be installed" };
     }
@@ -16630,7 +16630,7 @@ async function configureCoderabbit(input, deps = {}) {
     }
     if (!res2.installed) {
       deps.onEvent?.({ kind: "installing" });
-      const ok = await ensureInstalled(os58);
+      const ok = await ensureInstalled(os59);
       res2.installed = ok;
       if (!ok) return { ...res2, error: "CodeRabbit CLI could not be installed" };
     }
@@ -16660,7 +16660,7 @@ async function configureCoderabbit(input, deps = {}) {
     const res2 = base();
     if (!installed2) {
       deps.onEvent?.({ kind: "installing" });
-      const ok = await ensureInstalled(os58);
+      const ok = await ensureInstalled(os59);
       res2.installed = ok;
       if (!ok) return { ...res2, error: "CodeRabbit CLI could not be installed" };
     }
@@ -16700,7 +16700,7 @@ async function configureCoderabbit(input, deps = {}) {
   }
   const res = base();
   if (!res.installed) {
-    const ok = await ensureInstalled(os58);
+    const ok = await ensureInstalled(os59);
     res.installed = ok;
     if (!ok) return { ...res, error: "CodeRabbit CLI is not installed" };
   }
@@ -18691,7 +18691,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 current = true ? "2.61.38" : null;
+  const current = true ? "2.61.40" : null;
   if (!current) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -18708,7 +18708,7 @@ function checkForUpdates() {
   if (process.env.CODEAM_DISABLE_UPDATE_CHECK === "1") return;
   if (process.env.CI) return;
   if (!process.stdout.isTTY) return;
-  const current = true ? "2.61.38" : null;
+  const current = true ? "2.61.40" : null;
   if (!current) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -18728,7 +18728,7 @@ var SELF_UPDATE_INTERVAL_MS = 60 * 60 * 1e3;
 var SELF_UPDATE_VIEW_TIMEOUT_MS = 3e4;
 var SELF_UPDATE_INSTALL_TIMEOUT_MS = 18e4;
 function currentCliVersion() {
-  return true ? "2.61.38" : null;
+  return true ? "2.61.40" : null;
 }
 function runCmd(cmd, args2, timeoutMs) {
   return new Promise((resolve8) => {
@@ -19812,6 +19812,13 @@ var HostAgentSupervisor = class {
           report("failed", detail ? `agent exited (${code}): ${detail}` : `agent exited (${code})`);
         }
       });
+      proc.once("error", (err) => {
+        const tracked = this.children.get(payload.deployId)?.proc === proc;
+        if (tracked) this.children.delete(payload.deployId);
+        if (tracked) {
+          report("failed", `agent failed to start: ${err instanceof Error ? err.message : String(err)}`);
+        }
+      });
     } catch (err) {
       const message = err instanceof Error ? err.message : String(err);
       log.warn("host-agent", `deploy ${payload.deployId.slice(0, 8)} failed: ${message}`);
@@ -21730,11 +21737,11 @@ function resolveDoltInstallStrategy(platform3) {
 }
 var DOLT_RELEASE_BASE = "https://github.com/dolthub/dolt/releases/latest/download";
 function doltPlatformTuple(platform3, arch2) {
-  const os58 = platform3 === "win32" ? "windows" : platform3 === "darwin" ? "darwin" : "linux";
+  const os59 = platform3 === "win32" ? "windows" : platform3 === "darwin" ? "darwin" : "linux";
   const a = arch2 === "x64" ? "amd64" : arch2 === "arm64" ? "arm64" : null;
   if (!a) return null;
-  if (os58 === "windows" && a !== "amd64") return null;
-  return `${os58}-${a}`;
+  if (os59 === "windows" && a !== "amd64") return null;
+  return `${os59}-${a}`;
 }
 function resolveDoltTarballStrategy(targetDir, platform3, arch2) {
   const tuple = doltPlatformTuple(platform3, arch2);
@@ -23459,7 +23466,7 @@ var vcsAgentReviewH = async (ctx, cmd, parsed) => {
   });
   const token = ctx.pluginAuthToken;
   void (async () => {
-    const os58 = createOsStrategy();
+    const os59 = createOsStrategy();
     try {
       const report = await reviewPullRequest(
         {
@@ -23468,7 +23475,7 @@ var vcsAgentReviewH = async (ctx, cmd, parsed) => {
           baseBranch: parsed.baseBranch
         },
         {
-          runReview: (input) => new CoderabbitRuntimeStrategy(os58).runOneShot(input),
+          runReview: (input) => new CoderabbitRuntimeStrategy(os59).runOneShot(input),
           runGh: (args2) => defaultRunGh(args2),
           postReport: async (r) => {
             if (!token) return;
@@ -24494,11 +24501,11 @@ function resolveTokenValue(args2) {
   }
   const fileFlag = args2.find((a) => a.startsWith("--token-file="));
   if (fileFlag) {
-    const path78 = fileFlag.slice("--token-file=".length);
+    const path79 = fileFlag.slice("--token-file=".length);
     try {
-      const content = fs58.readFileSync(path78, "utf8").trim();
-      if (content.length === 0) fail(`--token-file ${path78} is empty`);
-      rmIfExistsQuiet(path78);
+      const content = fs58.readFileSync(path79, "utf8").trim();
+      if (content.length === 0) fail(`--token-file ${path79} is empty`);
+      rmIfExistsQuiet(path79);
       return content;
     } catch (err) {
       fail(`Could not read --token-file: ${err.message}`);
@@ -24688,7 +24695,7 @@ async function pairAuto(args2) {
       `agent "${claimed.agent}" is not supported in this codeam-cli version. Upgrade with 'npm i -g codeam-cli@latest'.`
     );
   }
-  addSession({
+  const claimedSession = {
     id: claimed.sessionId,
     pluginId,
     userName: claimed.user.name,
@@ -24699,7 +24706,8 @@ async function pairAuto(args2) {
     // SEC crit1 (#813): persist so boot-time /reconnect proves possession.
     pollSecret,
     agent: claimed.agent
-  });
+  };
+  addSession(claimedSession);
   identifyUser({
     userId: claimed.user.email,
     email: claimed.user.email,
@@ -24738,7 +24746,7 @@ async function pairAuto(args2) {
   process.once("exit", () => {
     headroomReporter?.stop();
   });
-  await start();
+  await start(void 0, claimedSession);
 }
 
 // src/services/headroom/wrap-launch.ts
@@ -31989,7 +31997,7 @@ function defaultRunGit(cwd, args2) {
   });
 }
 async function discoverRepos(workingDir, maxDepth = 4) {
-  const fs69 = await import("fs/promises");
+  const fs70 = await import("fs/promises");
   const out2 = [];
   await walk(workingDir, 0);
   return out2;
@@ -31997,7 +32005,7 @@ async function discoverRepos(workingDir, maxDepth = 4) {
     if (depth > maxDepth) return;
     let entries = [];
     try {
-      const dirents = await fs69.readdir(dir, { withFileTypes: true });
+      const dirents = await fs70.readdir(dir, { withFileTypes: true });
       entries = dirents.filter((d3) => !d3.name.startsWith(".") || d3.name === ".git").map((d3) => ({ name: d3.name, isDirectory: d3.isDirectory() }));
     } catch {
       return;
@@ -35099,6 +35107,43 @@ function fetchQuotaUsage(runtime, historySvc) {
   });
 }
 
+// src/beads/workflow-hint.ts
+var fs66 = __toESM(require("fs"));
+var path71 = __toESM(require("path"));
+var os54 = __toESM(require("os"));
+var BEADS_HINT_MARKER = "<!-- codeam:beads-workflow -->";
+var BEADS_HINT = `${BEADS_HINT_MARKER}
+# Beads (bd) \u2014 task tracking + persistent memory (ALWAYS use it)
+
+This environment uses **bd (beads)** for issue/task tracking and persistent memory.
+
+- Use \`bd\` for ALL task tracking \u2014 do NOT use TodoWrite or markdown TODO lists.
+- Run \`bd prime\` for the full workflow context + project memories. On a fresh
+  session beads may still be provisioning for a few seconds \u2014 if \`bd prime\` comes
+  back empty, retry it shortly; it works once the shared server is up.
+- \`bd ready\` (available work) \xB7 \`bd show <id>\` \xB7 \`bd update <id> --claim\` \xB7 \`bd close <id>\`.
+- Use \`bd remember "..."\` for persistent knowledge \u2014 do NOT use MEMORY.md files.
+${BEADS_HINT_MARKER}`;
+function ensureBeadsWorkflowHint(homeDir2 = os54.homedir()) {
+  try {
+    const file = path71.join(homeDir2, ".claude", "CLAUDE.md");
+    let existing = "";
+    try {
+      existing = fs66.readFileSync(file, "utf8");
+    } catch {
+    }
+    if (existing.includes(BEADS_HINT_MARKER)) return;
+    fs66.mkdirSync(path71.dirname(file), { recursive: true });
+    const next = existing.trim() ? `${existing.trimEnd()}
+
+${BEADS_HINT}
+` : `${BEADS_HINT}
+`;
+    fs66.writeFileSync(file, next);
+  } catch {
+  }
+}
+
 // src/integrations/provision.ts
 function buildMcpServersForStart(ctx) {
   const manifest = readIntegrationsManifest();
@@ -35503,7 +35548,7 @@ var AcpDriver = class {
 };
 
 // src/baton/transcript-mirror.ts
-var fs66 = __toESM(require("fs"));
+var fs67 = __toESM(require("fs"));
 var TranscriptMirror = class {
   constructor(deps) {
     this.deps = deps;
@@ -35570,7 +35615,7 @@ var TranscriptMirror = class {
   }
 };
 function defaultWatch(file, onChange) {
-  const w3 = fs66.watch(file, { persistent: false }, () => onChange());
+  const w3 = fs67.watch(file, { persistent: false }, () => onChange());
   return () => w3.close();
 }
 
@@ -35832,16 +35877,16 @@ function toEpochMs(ts) {
 }
 
 // src/agents/claude/onboarding.ts
-var fs67 = __toESM(require("fs"));
-var os55 = __toESM(require("os"));
-var path71 = __toESM(require("path"));
+var fs68 = __toESM(require("fs"));
+var os56 = __toESM(require("os"));
+var path72 = __toESM(require("path"));
 var ONBOARDING_VERSION_SENTINEL = "9999.0.0";
 function ensureClaudeOnboarded(cwd) {
   try {
-    const file = path71.join(os55.homedir(), ".claude.json");
+    const file = path72.join(os56.homedir(), ".claude.json");
     let config = {};
     try {
-      config = JSON.parse(fs67.readFileSync(file, "utf8"));
+      config = JSON.parse(fs68.readFileSync(file, "utf8"));
     } catch {
     }
     let changed = false;
@@ -35866,8 +35911,8 @@ function ensureClaudeOnboarded(cwd) {
       }
     }
     if (!changed) return;
-    fs67.mkdirSync(path71.dirname(file), { recursive: true });
-    fs67.writeFileSync(file, JSON.stringify(config, null, 2));
+    fs68.mkdirSync(path72.dirname(file), { recursive: true });
+    fs68.writeFileSync(file, JSON.stringify(config, null, 2));
     log.info(
       "claude",
       `pre-completed Claude onboarding${cwd ? ` + trusted workspace ${cwd}` : ""}`
@@ -35878,10 +35923,10 @@ function ensureClaudeOnboarded(cwd) {
 }
 
 // src/commands/start.ts
-async function start(requestedAgent) {
+async function start(requestedAgent, presetSession) {
   installRelayCrashGuards();
   showIntro();
-  const session = requestedAgent ? getActiveSessionForAgent(requestedAgent) : getActiveSession();
+  const session = presetSession ? presetSession : requestedAgent ? getActiveSessionForAgent(requestedAgent) : getActiveSession();
   if (!session) {
     if (requestedAgent) {
       const displayName = AGENT_REGISTRY[requestedAgent]?.displayName ?? requestedAgent;
@@ -35960,6 +36005,7 @@ async function start(requestedAgent) {
   if (!isLocalSession()) ensureClaudeOnboarded(cwd);
   let beads = null;
   const getBeads = () => beads;
+  ensureBeadsWorkflowHint();
   const beadsReady = provisionBeadsForStart({
     sessionId: session.id,
     pluginId,
@@ -35991,7 +36037,7 @@ async function start(requestedAgent) {
     ]) : Promise.resolve(true);
     let gateTimer;
     await Promise.race([
-      Promise.all([beadsReady.catch(() => null), depsReady, agentBinaryReady]),
+      Promise.all([depsReady, agentBinaryReady]),
       new Promise((resolve8) => {
         gateTimer = setTimeout(resolve8, GATE_TIMEOUT_MS);
       })
@@ -35999,7 +36045,7 @@ async function start(requestedAgent) {
     if (gateTimer) clearTimeout(gateTimer);
     log.info(
       "beads",
-      `agent-spawn gate released \u2014 beads ${beads ? "ready" : "pending"}; project deps provisioned`
+      `agent-spawn gate released (beads ungated, ${beads ? "already ready" : "still provisioning in background"}); project deps provisioned`
     );
   }
   if (isLocalSession() && requiresAcp(session.agent)) {
@@ -36584,7 +36630,7 @@ var import_picocolors11 = __toESM(require("picocolors"));
 var import_child_process29 = require("child_process");
 var import_util4 = require("util");
 var import_picocolors9 = __toESM(require("picocolors"));
-var path72 = __toESM(require("path"));
+var path73 = __toESM(require("path"));
 var execFileP6 = (0, import_util4.promisify)(import_child_process29.execFile);
 var MAX_BUFFER = 8 * 1024 * 1024;
 function resetStdinForChild() {
@@ -37073,7 +37119,7 @@ var GitHubCodespacesProvider = class {
     });
   }
   async uploadFile(workspaceId, remotePath, contents, options = {}) {
-    const remoteDir = path72.posix.dirname(remotePath);
+    const remoteDir = path73.posix.dirname(remotePath);
     const parts = [
       `mkdir -p ${shellQuote(remoteDir)}`,
       `cat > ${shellQuote(remotePath)}`
@@ -37143,7 +37189,7 @@ function shellQuote(s) {
 // src/services/providers/gitpod.ts
 var import_child_process30 = require("child_process");
 var import_util5 = require("util");
-var path73 = __toESM(require("path"));
+var path74 = __toESM(require("path"));
 var import_picocolors10 = __toESM(require("picocolors"));
 var execFileP7 = (0, import_util5.promisify)(import_child_process30.execFile);
 var MAX_BUFFER2 = 8 * 1024 * 1024;
@@ -37383,7 +37429,7 @@ var GitpodProvider = class {
     });
   }
   async uploadFile(workspaceId, remotePath, contents, options = {}) {
-    const remoteDir = path73.posix.dirname(remotePath);
+    const remoteDir = path74.posix.dirname(remotePath);
     const parts = [
       `mkdir -p ${shellQuote2(remoteDir)}`,
       `cat > ${shellQuote2(remotePath)}`
@@ -37419,7 +37465,7 @@ function shellQuote2(s) {
 // src/services/providers/gitlab-workspaces.ts
 var import_child_process31 = require("child_process");
 var import_util6 = require("util");
-var path74 = __toESM(require("path"));
+var path75 = __toESM(require("path"));
 var execFileP8 = (0, import_util6.promisify)(import_child_process31.execFile);
 var MAX_BUFFER3 = 8 * 1024 * 1024;
 var GITLAB_API_BASE = process.env.CODEAM_GITLAB_API_URL ?? "https://gitlab.com/api/v4";
@@ -37679,7 +37725,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 = path74.posix.dirname(remotePath);
+    const remoteDir = path75.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)}`);
@@ -37747,7 +37793,7 @@ function shellQuote3(s) {
 // src/services/providers/railway.ts
 var import_child_process32 = require("child_process");
 var import_util7 = require("util");
-var path75 = __toESM(require("path"));
+var path76 = __toESM(require("path"));
 var execFileP9 = (0, import_util7.promisify)(import_child_process32.execFile);
 var MAX_BUFFER4 = 8 * 1024 * 1024;
 function resetStdinForChild4() {
@@ -37983,7 +38029,7 @@ var RailwayProvider = class {
     if (!projectId || !serviceId) {
       throw new Error("Invalid Railway workspace id (expected projectId/serviceId).");
     }
-    const remoteDir = path75.posix.dirname(remotePath);
+    const remoteDir = path76.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)}`);
@@ -38629,8 +38675,8 @@ async function invite() {
 var import_node_dns = require("dns");
 var import_node_util5 = require("util");
 var import_node_crypto13 = require("crypto");
-var fs68 = __toESM(require("fs"));
-var path76 = __toESM(require("path"));
+var fs69 = __toESM(require("fs"));
+var path77 = __toESM(require("path"));
 var import_picocolors14 = __toESM(require("picocolors"));
 var dnsResolveP = (0, import_node_util5.promisify)(import_node_dns.resolve);
 async function checkDns(apiBase2) {
@@ -38686,13 +38732,13 @@ async function checkHealth(apiBase2) {
   }
 }
 function checkConfigDir() {
-  const dir = path76.join(require("os").homedir(), ".codeam");
+  const dir = path77.join(require("os").homedir(), ".codeam");
   try {
-    fs68.mkdirSync(dir, { recursive: true, mode: 448 });
-    const probe = path76.join(dir, ".doctor-probe");
-    fs68.writeFileSync(probe, "ok", { mode: 384 });
-    const read2 = fs68.readFileSync(probe, "utf8");
-    fs68.unlinkSync(probe);
+    fs69.mkdirSync(dir, { recursive: true, mode: 448 });
+    const probe = path77.join(dir, ".doctor-probe");
+    fs69.writeFileSync(probe, "ok", { mode: 384 });
+    const read2 = fs69.readFileSync(probe, "utf8");
+    fs69.unlinkSync(probe);
     if (read2 !== "ok") throw new Error("write/read round-trip mismatch");
     return {
       id: "config-dir",
@@ -38732,9 +38778,9 @@ function checkSessions() {
   }
 }
 function checkAgentBinaries() {
-  const os58 = createOsStrategy();
+  const os59 = createOsStrategy();
   return getEnabledAgents().map((meta) => {
-    const found = os58.findInPath(meta.binaryName);
+    const found = os59.findInPath(meta.binaryName);
     return {
       id: `agent-${meta.id}`,
       label: `Agent binary: ${meta.displayName} (${meta.binaryName})`,
@@ -38756,7 +38802,7 @@ function checkNodePty() {
       detail: "not required on this platform"
     };
   }
-  const vendoredPath = path76.join(__dirname, "vendor", "node-pty");
+  const vendoredPath = path77.join(__dirname, "vendor", "node-pty");
   for (const target of [vendoredPath, "node-pty"]) {
     try {
       require(target);
@@ -38798,7 +38844,7 @@ function checkChokidar() {
 }
 async function doctor(args2 = []) {
   const json = args2.includes("--json");
-  const cliVersion = true ? "2.61.38" : "0.0.0-dev";
+  const cliVersion = true ? "2.61.40" : "0.0.0-dev";
   const apiBase2 = resolveApiBaseUrl();
   const diagnosticId = (0, import_node_crypto13.randomUUID)();
   log.info("doctor", `run id=${diagnosticId} cli=${cliVersion}`);
@@ -39309,7 +39355,7 @@ async function mcpRun(args2) {
 // src/commands/version.ts
 var import_picocolors15 = __toESM(require("picocolors"));
 function version2() {
-  const v = true ? "2.61.38" : "unknown";
+  const v = true ? "2.61.40" : "unknown";
   console.log(`${import_picocolors15.default.bold("codeam-cli")} ${import_picocolors15.default.cyan(v)}`);
 }
 
@@ -39458,10 +39504,10 @@ var EXIT_CODE_NAMES = {
 };
 
 // src/index.ts
-var os57 = __toESM(require("os"));
+var os58 = __toESM(require("os"));
 if (!process.env.HOME) {
   try {
-    const home = os57.homedir();
+    const home = os58.homedir();
     if (home) process.env.HOME = home;
   } catch {
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codeam-cli",
-  "version": "2.61.38",
+  "version": "2.61.40",
   "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 — async. The terminal companion for CodeAgent Mobile.",
   "type": "commonjs",
   "main": "dist/index.js",