codeam-cli 2.33.0 → 2.34.0

package/CHANGELOG.md

@@ -4,6 +4,17 @@ 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.33.0] — 2026-06-09
+
+### Added
+
+- **shared:** Beads wire types (ingest payload + action)
+- **cli:** Bundle @beads/bd + cross-OS adapter, installer & projectKey
+- **cli:** Beads bootstrap + issues.jsonl watcher -> backend
+- **cli:** Apply queued beads actions as native bd commands
+- **cli:** Gated beads orchestrator + barrel exports
+- **cli:** Wire always-on beads into the live start + command-relay path
+
 ## [2.32.10] — 2026-06-09
 
 ### Fixed

package/dist/index.js

@@ -498,7 +498,7 @@ var import_qrcode_terminal = __toESM(require("qrcode-terminal"));
 // package.json
 var package_default = {
   name: "codeam-cli",
-  version: "2.33.0",
+  version: "2.34.0",
   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",
@@ -852,6 +852,28 @@ async function postPreviewEvent(input) {
     };
   }
 }
+async function postBeadsProvisioning(input) {
+  try {
+    await _transport.postJsonAuthed(
+      `${API_BASE}/api/beads/provisioning`,
+      {
+        sessionId: input.sessionId,
+        pluginId: input.pluginId,
+        status: input.status,
+        ...input.projectKey ? { projectKey: input.projectKey } : {}
+      },
+      input.pluginAuthToken
+    );
+    return { ok: true };
+  } catch (err) {
+    const e = err;
+    return {
+      ok: false,
+      status: typeof e.statusCode === "number" ? e.statusCode : 0,
+      message: e.message || "unknown"
+    };
+  }
+}
 async function _postJsonAuthed(url, body, pluginAuthToken) {
   return new Promise((resolve7, reject) => {
     const data = JSON.stringify(body);
@@ -1162,8 +1184,8 @@ function createGetModuleFromFilename(basePath = process.argv[1] ? (0, import_pat
     return decodedFile;
   };
 }
-function normalizeWindowsPath(path49) {
-  return path49.replace(/^[A-Z]:/, "").replace(/\\/g, "/");
+function normalizeWindowsPath(path50) {
+  return path50.replace(/^[A-Z]:/, "").replace(/\\/g, "/");
 }
 
 // ../../node_modules/@posthog/core/dist/featureFlagUtils.mjs
@@ -3643,9 +3665,9 @@ async function addSourceContext(frames) {
   LRU_FILE_CONTENTS_CACHE.reduce();
   return frames;
 }
-function getContextLinesFromFile(path49, ranges, output) {
+function getContextLinesFromFile(path50, ranges, output) {
   return new Promise((resolve7) => {
-    const stream = (0, import_node_fs.createReadStream)(path49);
+    const stream = (0, import_node_fs.createReadStream)(path50);
     const lineReaded = (0, import_node_readline.createInterface)({
       input: stream
     });
@@ -3660,7 +3682,7 @@ function getContextLinesFromFile(path49, ranges, output) {
     let rangeStart = range[0];
     let rangeEnd = range[1];
     function onStreamError() {
-      LRU_FILE_CONTENTS_FS_READ_FAILED.set(path49, 1);
+      LRU_FILE_CONTENTS_FS_READ_FAILED.set(path50, 1);
       lineReaded.close();
       lineReaded.removeAllListeners();
       destroyStreamAndResolve();
@@ -3721,8 +3743,8 @@ function clearLineContext(frame) {
   delete frame.context_line;
   delete frame.post_context;
 }
-function shouldSkipContextLinesForFile(path49) {
-  return path49.startsWith("node:") || path49.endsWith(".min.js") || path49.endsWith(".min.cjs") || path49.endsWith(".min.mjs") || path49.startsWith("data:");
+function shouldSkipContextLinesForFile(path50) {
+  return path50.startsWith("node:") || path50.endsWith(".min.js") || path50.endsWith(".min.cjs") || path50.endsWith(".min.mjs") || path50.startsWith("data:");
 }
 function shouldSkipContextLinesForFrame(frame) {
   if (void 0 !== frame.lineno && frame.lineno > MAX_CONTEXTLINES_LINENO) return true;
@@ -5876,7 +5898,7 @@ function readAnonId() {
 }
 function superProperties() {
   return {
-    cliVersion: true ? "2.33.0" : "0.0.0-dev",
+    cliVersion: true ? "2.34.0" : "0.0.0-dev",
     nodeVersion: process.version,
     platform: process.platform,
     arch: process.arch,
@@ -9948,13 +9970,13 @@ function detectStartupBanner(lines) {
   while (artStart > 0 && BANNER_ART_RE.test(lines[artStart - 1])) artStart--;
   if (metaIdx - artStart < 2) return null;
   const pathLine = (lines[metaIdx + 1] ?? "").trim();
-  const path49 = pathLine && !BANNER_ART_RE.test(pathLine) ? pathLine : "";
+  const path50 = pathLine && !BANNER_ART_RE.test(pathLine) ? pathLine : "";
   return {
     title: "",
     subtitle: lines[metaIdx].trim(),
-    path: path49,
+    path: path50,
     startIdx: artStart,
-    endIdx: metaIdx + (path49 ? 1 : 0)
+    endIdx: metaIdx + (path50 ? 1 : 0)
   };
 }
 
@@ -11290,11 +11312,11 @@ function parseReview(stdout) {
   for (const line of lines) {
     const m = line.match(HUNK_LINE_RE);
     if (!m) continue;
-    const [, path49, lineNo, sevToken, message] = m;
-    if (!path49 || !lineNo || !message) continue;
+    const [, path50, lineNo, sevToken, message] = m;
+    if (!path50 || !lineNo || !message) continue;
     const cleanedMessage = message.trim().replace(/^[*-]\s+/, "");
     hunks.push({
-      path: path49.trim(),
+      path: path50.trim(),
       line: Number(lineNo),
       severity: sevToken ? SEVERITY_MAP[sevToken.toLowerCase()] : void 0,
       message: cleanedMessage
@@ -15688,9 +15710,9 @@ function extractSelectPrompt(text) {
 }
 
 // src/commands/start/handlers.ts
-var fs31 = __toESM(require("fs"));
+var fs32 = __toESM(require("fs"));
 var os25 = __toESM(require("os"));
-var path38 = __toESM(require("path"));
+var path39 = __toESM(require("path"));
 var import_crypto3 = require("crypto");
 var import_child_process15 = require("child_process");
 
@@ -17282,10 +17304,12 @@ var BdAdapter = class {
     return this.resolveBinary() !== null;
   }
   /**
-   * Run an arbitrary bd subcommand. Always injects `--global` (the home brain)
-   * unless a `beadsDir` override is set, in which case `BEADS_DIR` redirects bd
-   * to that dir instead (tests). Returns the raw result; callers decide how to
-   * interpret exit codes (e.g. `bd setup --check` uses 0/nonzero).
+   * Run an arbitrary bd subcommand against the home brain. `BEADS_DIR` is set
+   * to the configured `beadsDir` (tests) or `~/.beads` (the verified embedded
+   * home brain) so every command resolves to the same single graph regardless
+   * of the process cwd. Returns the raw result; callers decide how to interpret
+   * exit codes — note bd exits 0 even for some error states (e.g. "no beads
+   * database found"), so JSON-parsing callers must also inspect the payload.
    */
   async run(args2) {
     const binary = this.resolveBinary();
@@ -17293,14 +17317,9 @@ var BdAdapter = class {
       return { code: -1, stdout: "", stderr: "bd binary not resolved" };
     }
     const env = { ...process.env };
-    const finalArgs = [...args2];
-    if (this.opts.beadsDir) {
-      env.BEADS_DIR = this.opts.beadsDir;
-    } else if (!finalArgs.includes("--global")) {
-      finalArgs.push("--global");
-    }
-    log.trace("beads", `bd ${finalArgs.join(" ")}`);
-    return _spawnSeam.run(binary, finalArgs, { cwd: this.opts.cwd, env });
+    env.BEADS_DIR = this.opts.beadsDir ?? defaultBeadsHomeDir();
+    log.trace("beads", `bd ${args2.join(" ")} (BEADS_DIR=${env.BEADS_DIR})`);
+    return _spawnSeam.run(binary, args2, { cwd: this.opts.cwd, env });
   }
   /**
    * `bd ready --json` → typed issue array. `bd list --json` shares the shape,
@@ -17372,92 +17391,179 @@ function defaultBeadsHomeDir() {
   return path35.join(os24.homedir(), ".beads");
 }
 
-// src/beads/bootstrap.ts
-var SETUP_RECIPE = {
+// src/beads/provisioner.ts
+var fs30 = __toESM(require("fs"));
+var path36 = __toESM(require("path"));
+
+// src/beads/install-bd.ts
+var import_child_process13 = require("child_process");
+var INSTALL_SH_URL = "https://raw.githubusercontent.com/gastownhall/beads/main/scripts/install.sh";
+var INSTALL_PS1_URL = "https://raw.githubusercontent.com/gastownhall/beads/main/install.ps1";
+function resolveInstallStrategy(platform2) {
+  if (platform2 === "win32") {
+    return {
+      command: "powershell.exe",
+      args: [
+        "-NoProfile",
+        "-NonInteractive",
+        "-ExecutionPolicy",
+        "Bypass",
+        "-Command",
+        `irm ${INSTALL_PS1_URL} | iex`
+      ],
+      description: `PowerShell: irm ${INSTALL_PS1_URL} | iex (requires Go 1.24+ and Git for Windows on PATH)`
+    };
+  }
+  return {
+    command: "bash",
+    args: ["-c", `curl -fsSL ${INSTALL_SH_URL} | bash`],
+    description: `curl -fsSL ${INSTALL_SH_URL} | bash`
+  };
+}
+var _installSpawnSeam = {
+  run: _defaultInstallSpawn
+};
+function _defaultInstallSpawn(strategy) {
+  return new Promise((resolve7) => {
+    let proc;
+    try {
+      proc = (0, import_child_process13.spawn)(strategy.command, strategy.args, { env: process.env });
+    } catch (err) {
+      resolve7({ ok: false, code: -1, stderr: err.message });
+      return;
+    }
+    let stderr = "";
+    proc.stderr?.on("data", (c2) => {
+      stderr += c2.toString();
+    });
+    proc.on("error", (err) => resolve7({ ok: false, code: -1, stderr: err.message }));
+    proc.on(
+      "close",
+      (code) => resolve7({ ok: code === 0, code: code ?? -1, stderr })
+    );
+  });
+}
+async function installBd(platform2 = process.platform) {
+  const strategy = resolveInstallStrategy(platform2);
+  log.info("beads", `installing bd via ${strategy.description}`);
+  const result = await _installSpawnSeam.run(strategy);
+  if (!result.ok) {
+    log.warn(
+      "beads",
+      `bd install failed (code=${result.code}): ${result.stderr.slice(0, 200)}`
+    );
+  }
+  return result;
+}
+
+// src/beads/provisioner.ts
+var AGENT_SETUP_RECIPE = {
   claude: "claude",
   codex: "codex",
+  copilot: "copilot",
   cursor: "cursor",
-  gemini: "gemini",
   aider: "aider",
-  copilot: "copilot"
+  gemini: "gemini",
+  coderabbit: null
+};
+var _provisionSeam = {
+  install: installBd,
+  homeBrainInitialized
 };
-async function bootstrapBeads(opts) {
+function homeBrainInitialized(beadsDir) {
+  try {
+    return fs30.statSync(path36.join(beadsDir, "embeddeddolt")).isDirectory();
+  } catch {
+    return false;
+  }
+}
+async function provisionBeads(opts = {}) {
   const bd = opts.adapter ?? new BdAdapter({ cwd: opts.cwd, beadsDir: opts.beadsDir });
+  const beadsDir = opts.beadsDir ?? defaultBeadsHomeDir();
   const result = {
     bdAvailable: false,
-    serverUp: false,
-    agentsConfigured: [],
-    exportEnabled: false
+    initialized: false,
+    exportEnabled: false,
+    agentsWired: []
   };
   if (!bd.isAvailable()) {
-    log.warn("beads", "bd binary unavailable \u2014 skipping bootstrap");
-    return result;
+    log.info("beads", "bd binary missing \u2014 running OS installer fallback");
+    const install = await _provisionSeam.install();
+    if (!install.ok) {
+      log.warn("beads", `bd install failed (code=${install.code}) \u2014 beads disabled this run`);
+      return result;
+    }
   }
-  result.bdAvailable = true;
-  result.serverUp = await ensureServer(bd);
-  if (!result.serverUp) {
-    log.warn("beads", "dolt sql-server not up after start \u2014 skipping wiring this run");
+  if (!bd.isAvailable()) {
+    log.warn("beads", "bd still unavailable after install \u2014 beads disabled this run");
     return result;
   }
-  for (const agent of opts.agents) {
-    const recipe = SETUP_RECIPE[agent];
-    if (!recipe) {
-      log.trace("beads", `no bd setup recipe for agent ${agent} \u2014 skipping`);
-      continue;
+  result.bdAvailable = true;
+  if (_provisionSeam.homeBrainInitialized(beadsDir)) {
+    log.trace("beads", `home brain already initialized at ${beadsDir}`);
+    result.initialized = true;
+  } else {
+    log.info("beads", `initializing home brain at ${beadsDir}`);
+    const init = await bd.run(["init", "--skip-agents", "--skip-hooks", "--non-interactive"]);
+    if (init.code !== 0) {
+      log.warn("beads", `bd init failed (code=${init.code}): ${init.stderr.slice(0, 200)}`);
+      return result;
     }
-    const applied = await ensureRecipe(bd, recipe);
-    if (applied) result.agentsConfigured.push(agent);
+    result.initialized = true;
   }
-  result.exportEnabled = await ensureAutoExport(bd);
+  const exp = await bd.run(["config", "set", "export.auto", "true"]);
+  result.exportEnabled = exp.code === 0;
+  result.agentsWired = await setupAgents(bd, opts.agents ?? []);
   log.info(
     "beads",
-    `bootstrap done server=${result.serverUp} agents=[${result.agentsConfigured.join(",")}] export=${result.exportEnabled}`
+    `provision done initialized=${result.initialized} export=${result.exportEnabled} agentsWired=[${result.agentsWired.join(",")}]`
   );
   return result;
 }
-async function ensureServer(bd) {
-  const status2 = await bd.run(["dolt", "status"]);
-  if (status2.code === 0) {
-    log.trace("beads", "dolt sql-server already running");
-    return true;
-  }
-  log.info("beads", "dolt sql-server down \u2014 starting detached");
-  const start2 = await bd.run(["dolt", "start"]);
-  if (start2.code !== 0) {
-    log.warn("beads", `bd dolt start failed (code=${start2.code}): ${start2.stderr.slice(0, 200)}`);
-    return false;
+async function setupAgents(bd, agents) {
+  const wired = [];
+  for (const recipe of dedupeRecipes(agents)) {
+    try {
+      const check = await bd.run(["setup", recipe, "--global", "--check"]);
+      if (check.code === 0) {
+        log.trace("beads", `bd setup ${recipe} --global already installed \u2014 skipping`);
+        wired.push(recipe);
+        continue;
+      }
+      log.info("beads", `wiring agent natively: bd setup ${recipe} --global`);
+      const setup = await bd.run(["setup", recipe, "--global"]);
+      if (setup.code === 0) {
+        wired.push(recipe);
+      } else {
+        log.warn(
+          "beads",
+          `bd setup ${recipe} --global failed (code=${setup.code}): ${setup.stderr.slice(0, 200)} \u2014 non-fatal, agent runs without native bd wiring`
+        );
+      }
+    } catch (err) {
+      log.warn("beads", `bd setup ${recipe} --global threw (non-fatal)`, err);
+    }
   }
-  const recheck = await bd.run(["dolt", "status"]);
-  return recheck.code === 0;
+  return wired;
 }
-async function ensureRecipe(bd, recipe) {
-  const check = await bd.run(["setup", recipe, "--check"]);
-  if (check.code === 0) {
-    log.trace("beads", `recipe ${recipe} already configured`);
-    return false;
-  }
-  const setup = await bd.run(["setup", recipe]);
-  if (setup.code !== 0) {
-    log.warn("beads", `bd setup ${recipe} failed (code=${setup.code})`);
-    return false;
+function dedupeRecipes(agents) {
+  const seen = /* @__PURE__ */ new Set();
+  for (const agent of agents) {
+    const recipe = AGENT_SETUP_RECIPE[agent];
+    if (recipe) seen.add(recipe);
   }
-  log.info("beads", `configured agent recipe: ${recipe}`);
-  return true;
-}
-async function ensureAutoExport(bd) {
-  const res = await bd.run(["config", "set", "export.jsonl", "true"]);
-  return res.code === 0;
+  return [...seen];
 }
 
 // src/beads/watcher.ts
 var crypto3 = __toESM(require("crypto"));
-var path37 = __toESM(require("path"));
+var path38 = __toESM(require("path"));
 
 // src/beads/project-key.ts
-var import_child_process13 = require("child_process");
+var import_child_process14 = require("child_process");
 var crypto2 = __toESM(require("crypto"));
-var fs30 = __toESM(require("fs"));
-var path36 = __toESM(require("path"));
+var fs31 = __toESM(require("fs"));
+var path37 = __toESM(require("path"));
 function normalizeOrigin(raw) {
   const trimmed = raw.trim();
   if (!trimmed) return null;
@@ -17483,17 +17589,17 @@ function normalizeOrigin(raw) {
   return `${host}/${pathPart}`;
 }
 function findRepoRoot(cwd) {
-  let dir = path36.resolve(cwd);
+  let dir = path37.resolve(cwd);
   const seen = /* @__PURE__ */ new Set();
   for (let i = 0; i < 256; i++) {
     if (seen.has(dir)) return null;
     seen.add(dir);
     try {
-      const stat3 = fs30.statSync(path36.join(dir, ".git"), { throwIfNoEntry: false });
+      const stat3 = fs31.statSync(path37.join(dir, ".git"), { throwIfNoEntry: false });
       if (stat3 && (stat3.isDirectory() || stat3.isFile())) return dir;
     } catch {
     }
-    const parent = path36.dirname(dir);
+    const parent = path37.dirname(dir);
     if (parent === dir) return null;
     dir = parent;
   }
@@ -17501,10 +17607,10 @@ function findRepoRoot(cwd) {
 }
 var _execSeam2 = {
   exec: (file, args2, opts) => {
-    const out2 = (0, import_child_process13.execFileSync)(file, args2, opts);
+    const out2 = (0, import_child_process14.execFileSync)(file, args2, opts);
     return typeof out2 === "string" ? out2 : out2.toString("utf8");
   },
-  realpath: (p2) => fs30.realpathSync(p2)
+  realpath: (p2) => fs31.realpathSync(p2)
 };
 function readOrigin(cwd) {
   try {
@@ -17533,7 +17639,7 @@ function deriveProjectIdentity(cwd = process.cwd()) {
   } catch {
   }
   const hash = crypto2.createHash("sha256").update(real).digest("hex");
-  return { projectKey: `path:${hash}`, projectLabel: path36.basename(real) || "project" };
+  return { projectKey: `path:${hash}`, projectLabel: path37.basename(real) || "project" };
 }
 
 // src/services/file-watcher/transport.ts
@@ -17601,7 +17707,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 ?? path37.join(defaultBeadsHomeDir(), "issues.jsonl");
+    this.feedPath = opts.feedPath ?? path38.join(defaultBeadsHomeDir(), "issues.jsonl");
     this.apiBase = opts.apiBaseUrl ?? API_BASE4;
   }
   opts;
@@ -17772,85 +17878,12 @@ async function applyBeadsAction(action, deps) {
   return { ok: true, action: action.kind, code: 0 };
 }
 
-// src/beads/install-bd.ts
-var import_child_process14 = require("child_process");
-var INSTALL_SH_URL = "https://raw.githubusercontent.com/gastownhall/beads/main/scripts/install.sh";
-var INSTALL_PS1_URL = "https://raw.githubusercontent.com/gastownhall/beads/main/install.ps1";
-function resolveInstallStrategy(platform2) {
-  if (platform2 === "win32") {
-    return {
-      command: "powershell.exe",
-      args: [
-        "-NoProfile",
-        "-NonInteractive",
-        "-ExecutionPolicy",
-        "Bypass",
-        "-Command",
-        `irm ${INSTALL_PS1_URL} | iex`
-      ],
-      description: `PowerShell: irm ${INSTALL_PS1_URL} | iex (requires Go 1.24+ and Git for Windows on PATH)`
-    };
-  }
-  return {
-    command: "bash",
-    args: ["-c", `curl -fsSL ${INSTALL_SH_URL} | bash`],
-    description: `curl -fsSL ${INSTALL_SH_URL} | bash`
-  };
-}
-var _installSpawnSeam = {
-  run: _defaultInstallSpawn
-};
-function _defaultInstallSpawn(strategy) {
-  return new Promise((resolve7) => {
-    let proc;
-    try {
-      proc = (0, import_child_process14.spawn)(strategy.command, strategy.args, { env: process.env });
-    } catch (err) {
-      resolve7({ ok: false, code: -1, stderr: err.message });
-      return;
-    }
-    let stderr = "";
-    proc.stderr?.on("data", (c2) => {
-      stderr += c2.toString();
-    });
-    proc.on("error", (err) => resolve7({ ok: false, code: -1, stderr: err.message }));
-    proc.on(
-      "close",
-      (code) => resolve7({ ok: code === 0, code: code ?? -1, stderr })
-    );
-  });
-}
-async function installBd(platform2 = process.platform) {
-  const strategy = resolveInstallStrategy(platform2);
-  log.info("beads", `installing bd via ${strategy.description}`);
-  const result = await _installSpawnSeam.run(strategy);
-  if (!result.ok) {
-    log.warn(
-      "beads",
-      `bd install failed (code=${result.code}): ${result.stderr.slice(0, 200)}`
-    );
-  }
-  return result;
-}
-
 // src/beads/index.ts
-async function maybeStartBeads(opts) {
-  if (!opts.enabled) {
-    log.trace("beads", "beads flag off \u2014 skipping");
-    return null;
-  }
+async function startBeads(opts) {
   const adapter = new BdAdapter({ cwd: opts.cwd });
-  if (!adapter.isAvailable() && opts.allowInstall) {
-    log.info("beads", "bd not found \u2014 running OS installer");
-    await installBd();
-  }
-  if (!adapter.isAvailable()) {
-    log.warn("beads", "bd unavailable \u2014 beads disabled for this session");
-    return null;
-  }
-  const boot = await bootstrapBeads({ cwd: opts.cwd, agents: opts.agents, adapter });
-  if (!boot.serverUp) {
-    log.warn("beads", "beads server not up \u2014 watcher not started this run");
+  const provision = await provisionBeads({ cwd: opts.cwd, adapter, agents: opts.agents });
+  if (!provision.bdAvailable || !provision.initialized) {
+    log.warn("beads", "home brain not provisioned \u2014 watcher not started this run");
     return null;
   }
   const watcher = new BeadsWatcher({
@@ -17876,28 +17909,42 @@ function beadsKilled() {
   const v = process.env.CODEAM_BEADS_DISABLED;
   return !!v && v !== "0" && v.toLowerCase() !== "false";
 }
-async function startBeadsForSession(ctx) {
+async function provisionBeadsForStart(ctx) {
   if (beadsKilled()) {
-    log.trace("beads", "CODEAM_BEADS_DISABLED set \u2014 beads off for this session");
+    log.trace("beads", "CODEAM_BEADS_DISABLED set \u2014 beads off this run");
     return null;
   }
   if (!ctx.pluginAuthToken) {
-    log.trace("beads", "no pluginAuthToken on session \u2014 beads off");
+    log.trace("beads", "no pluginAuthToken \u2014 beads off");
     return null;
   }
+  const pluginAuthToken = ctx.pluginAuthToken;
+  let started = null;
   try {
-    return await maybeStartBeads({
-      enabled: true,
+    started = await startBeads({
       sessionId: ctx.sessionId,
       pluginId: ctx.pluginId,
-      pluginAuthToken: ctx.pluginAuthToken,
-      agents: ctx.agents,
-      cwd: ctx.cwd
+      pluginAuthToken,
+      cwd: ctx.cwd,
+      agents: ctx.agents
     });
   } catch (err) {
-    log.warn("beads", "startBeadsForSession failed (non-fatal)", err);
-    return null;
-  }
+    log.warn("beads", "provisionBeadsForStart failed (non-fatal)", err);
+    started = null;
+  }
+  const { projectKey } = deriveProjectIdentity(ctx.cwd);
+  void postBeadsProvisioning({
+    sessionId: ctx.sessionId,
+    pluginId: ctx.pluginId,
+    pluginAuthToken,
+    status: started ? "ready" : "failed",
+    projectKey
+  }).then((res) => {
+    if (!res.ok) {
+      log.trace("beads", `provisioning signal POST non-ok (status=${res.status}) \u2014 ignoring`);
+    }
+  });
+  return started;
 }
 var ACTION_KINDS = /* @__PURE__ */ new Set([
   "claim",
@@ -17930,7 +17977,7 @@ var pendingAttachmentFiles = /* @__PURE__ */ new Set();
 function cleanupAttachmentTempFiles() {
   for (const p2 of pendingAttachmentFiles) {
     try {
-      fs31.unlinkSync(p2);
+      fs32.unlinkSync(p2);
     } catch {
     }
   }
@@ -17939,8 +17986,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 = path38.join(os25.tmpdir(), `codeam-${(0, import_crypto3.randomUUID)()}-${safeName}`);
-    fs31.writeFileSync(tmpPath, Buffer.from(base64, "base64"));
+    const tmpPath = path39.join(os25.tmpdir(), `codeam-${(0, import_crypto3.randomUUID)()}-${safeName}`);
+    fs32.writeFileSync(tmpPath, Buffer.from(base64, "base64"));
     pendingAttachmentFiles.add(tmpPath);
     return tmpPath;
   });
@@ -17960,7 +18007,7 @@ var startTask = (ctx, _cmd, parsed) => {
     setTimeout(() => {
       for (const p2 of paths) {
         try {
-          fs31.unlinkSync(p2);
+          fs32.unlinkSync(p2);
         } catch {
         }
         pendingAttachmentFiles.delete(p2);
@@ -18533,8 +18580,8 @@ function normalizeDetectionForSpawn(detection, cwd) {
   if (args2.length === 0) return detection;
   const binName = args2[0];
   if (binName.startsWith("-")) return detection;
-  const binPath = path38.join(cwd, "node_modules", ".bin", binName);
-  if (!fs31.existsSync(binPath)) return detection;
+  const binPath = path39.join(cwd, "node_modules", ".bin", binName);
+  if (!fs32.existsSync(binPath)) return detection;
   return {
     ...detection,
     command: binPath,
@@ -18945,9 +18992,9 @@ async function dispatchCommand(ctx, cmd) {
 
 // src/services/file-watcher.service.ts
 var import_child_process16 = require("child_process");
-var fs32 = __toESM(require("fs"));
+var fs33 = __toESM(require("fs"));
 var os26 = __toESM(require("os"));
-var path39 = __toESM(require("path"));
+var path40 = __toESM(require("path"));
 var import_ignore = __toESM(require("ignore"));
 
 // src/services/file-watcher/diff-parser.ts
@@ -19090,18 +19137,18 @@ var _findGitRootSeam = {
   resolve: _defaultFindGitRoot
 };
 function _defaultFindGitRoot(startDir) {
-  let dir = path39.resolve(startDir);
+  let dir = path40.resolve(startDir);
   const seen = /* @__PURE__ */ new Set();
   for (let i = 0; i < 256; i++) {
     if (seen.has(dir)) return null;
     seen.add(dir);
     try {
-      const gitPath = path39.join(dir, ".git");
-      const stat3 = fs32.statSync(gitPath, { throwIfNoEntry: false });
+      const gitPath = path40.join(dir, ".git");
+      const stat3 = fs33.statSync(gitPath, { throwIfNoEntry: false });
       if (stat3 && (stat3.isDirectory() || stat3.isFile())) return dir;
     } catch {
     }
-    const parent = path39.dirname(dir);
+    const parent = path40.dirname(dir);
     if (parent === dir) return null;
     dir = parent;
   }
@@ -19346,7 +19393,7 @@ var FileWatcherService = class {
   }
   async emitForFile(absPath, changeType) {
     if (this.stopped) return;
-    const fileDir = path39.dirname(absPath);
+    const fileDir = path40.dirname(absPath);
     let gitRoot = this.gitRootByDir.get(fileDir);
     if (gitRoot === void 0) {
       gitRoot = findGitRoot2(fileDir);
@@ -19359,19 +19406,19 @@ var FileWatcherService = class {
       );
       return;
     }
-    const relPathInRepo = path39.relative(gitRoot, absPath);
+    const relPathInRepo = path40.relative(gitRoot, absPath);
     if (!relPathInRepo || relPathInRepo.startsWith("..")) return;
     const matcher = this.getGitIgnoreMatcher(gitRoot);
     if (matcher && matcher.ignores(relPathInRepo)) {
       log.trace(
         "fileWatcher",
-        `${relPathInRepo} ignored by ${path39.basename(gitRoot)}/.gitignore \u2014 suppressing emit`
+        `${relPathInRepo} ignored by ${path40.basename(gitRoot)}/.gitignore \u2014 suppressing emit`
       );
       return;
     }
     this.opts.onRepoDirty?.(gitRoot);
-    const repoPath = path39.relative(this.opts.workingDir, gitRoot);
-    const repoName = path39.basename(gitRoot);
+    const repoPath = path40.relative(this.opts.workingDir, gitRoot);
+    const repoName = path40.basename(gitRoot);
     let diffText = "";
     let fileStatus = "modified";
     if (changeType === "unlink") {
@@ -19546,7 +19593,7 @@ var FileWatcherService = class {
   collectGitignoreFiles(repoRoot, dir, matcher) {
     let entries;
     try {
-      entries = fs32.readdirSync(dir, { withFileTypes: true });
+      entries = fs33.readdirSync(dir, { withFileTypes: true });
     } catch {
       return;
     }
@@ -19555,16 +19602,16 @@ var FileWatcherService = class {
     );
     if (gitignoreEntry) {
       try {
-        const body = fs32.readFileSync(path39.join(dir, ".gitignore"), "utf8");
-        const rel = path39.relative(repoRoot, dir).replace(/\\/g, "/");
+        const body = fs33.readFileSync(path40.join(dir, ".gitignore"), "utf8");
+        const rel = path40.relative(repoRoot, dir).replace(/\\/g, "/");
         const prefixed = body.split(/\r?\n/).map((line) => {
           const trimmed = line.trim();
           if (!trimmed || trimmed.startsWith("#")) return line;
           if (!rel) return line;
           if (trimmed.startsWith("!")) {
-            return "!" + path39.posix.join(rel, trimmed.slice(1));
+            return "!" + path40.posix.join(rel, trimmed.slice(1));
           }
-          return path39.posix.join(rel, trimmed);
+          return path40.posix.join(rel, trimmed);
         }).join("\n");
         matcher.add(prefixed);
       } catch {
@@ -19573,7 +19620,7 @@ var FileWatcherService = class {
     for (const entry of entries) {
       if (!entry.isDirectory()) continue;
       if (entry.name === ".git") continue;
-      const childAbs = path39.join(dir, entry.name);
+      const childAbs = path40.join(dir, entry.name);
       if (isIgnoredFilePath(childAbs)) continue;
       this.collectGitignoreFiles(repoRoot, childAbs, matcher);
     }
@@ -19743,7 +19790,7 @@ var import_crypto4 = require("crypto");
 
 // src/services/turn-files/git-changeset.ts
 var import_child_process17 = require("child_process");
-var path40 = __toESM(require("path"));
+var path41 = __toESM(require("path"));
 async function collectRepoChangeset(opts) {
   const status2 = await runGit3(opts.repoRoot, ["status", "--porcelain=v1", "-z"]);
   if (status2 === null) return null;
@@ -19854,7 +19901,7 @@ function defaultRunGit(cwd, args2) {
   });
 }
 async function discoverRepos(workingDir, maxDepth = 4) {
-  const fs38 = await import("fs/promises");
+  const fs39 = await import("fs/promises");
   const out2 = [];
   await walk(workingDir, 0);
   return out2;
@@ -19862,7 +19909,7 @@ async function discoverRepos(workingDir, maxDepth = 4) {
     if (depth > maxDepth) return;
     let entries = [];
     try {
-      const dirents = await fs38.readdir(dir, { withFileTypes: true });
+      const dirents = await fs39.readdir(dir, { withFileTypes: true });
       entries = dirents.filter((d3) => !d3.name.startsWith(".") || d3.name === ".git").map((d3) => ({ name: d3.name, isDirectory: d3.isDirectory() }));
     } catch {
       return;
@@ -19873,8 +19920,8 @@ async function discoverRepos(workingDir, maxDepth = 4) {
     if (hasGit) {
       out2.push({
         repoRoot: dir,
-        repoPath: path40.relative(workingDir, dir),
-        repoName: path40.basename(dir)
+        repoPath: path41.relative(workingDir, dir),
+        repoName: path41.basename(dir)
       });
       return;
     }
@@ -19882,14 +19929,14 @@ 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 walk(path40.join(dir, entry.name), depth + 1);
+      await walk(path41.join(dir, entry.name), depth + 1);
     }
   }
 }
 
 // src/services/turn-files/files-outbox.ts
-var fs33 = __toESM(require("fs/promises"));
-var path41 = __toESM(require("path"));
+var fs34 = __toESM(require("fs/promises"));
+var path42 = __toESM(require("path"));
 var import_os7 = require("os");
 var HOME_OUTBOX_DIR = ".codeam/outbox";
 var MAX_AGE_MS = 24 * 60 * 60 * 1e3;
@@ -19922,16 +19969,16 @@ var FilesOutbox = class {
   backoffIndex = 0;
   stopped = false;
   constructor(opts) {
-    const base = opts.baseDir ?? path41.join(homeDir(), HOME_OUTBOX_DIR);
-    this.filePath = path41.join(base, `${opts.sessionId}.jsonl`);
+    const base = opts.baseDir ?? path42.join(homeDir(), HOME_OUTBOX_DIR);
+    this.filePath = path42.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 fs33.mkdir(path41.dirname(this.filePath), { recursive: true });
-    await fs33.appendFile(this.filePath, JSON.stringify(entry) + "\n", "utf8");
+    await fs34.mkdir(path42.dirname(this.filePath), { recursive: true });
+    await fs34.appendFile(this.filePath, JSON.stringify(entry) + "\n", "utf8");
     this.backoffIndex = 0;
     if (this.autoSchedule) this.scheduleFlush(0);
   }
@@ -20020,7 +20067,7 @@ var FilesOutbox = class {
   async readAll() {
     let raw = "";
     try {
-      raw = await fs33.readFile(this.filePath, "utf8");
+      raw = await fs34.readFile(this.filePath, "utf8");
     } catch {
       return [];
     }
@@ -20044,12 +20091,12 @@ var FilesOutbox = class {
   async rewrite(entries) {
     const tmpPath = `${this.filePath}.${process.pid}.tmp`;
     if (entries.length === 0) {
-      await fs33.unlink(this.filePath).catch(() => void 0);
+      await fs34.unlink(this.filePath).catch(() => void 0);
       return;
     }
     const payload = entries.map((e) => JSON.stringify(e)).join("\n") + "\n";
-    await fs33.writeFile(tmpPath, payload, "utf8");
-    await fs33.rename(tmpPath, this.filePath);
+    await fs34.writeFile(tmpPath, payload, "utf8");
+    await fs34.rename(tmpPath, this.filePath);
   }
 };
 function applyJitter(ms) {
@@ -20670,16 +20717,7 @@ async function runAcpSession(opts) {
   }).catch((err) => {
     log.warn("acpRunner", `fileWatcher.start failed: ${describeError(err)}`);
   });
-  let beads = null;
-  void startBeadsForSession({
-    sessionId: opts.sessionId,
-    pluginId: opts.pluginId,
-    pluginAuthToken: opts.pluginAuthToken,
-    agents: [opts.agent],
-    cwd: opts.cwd
-  }).then((started) => {
-    beads = started;
-  });
+  const getBeads = opts.getBeads ?? (() => null);
   const relay = new CommandRelayService(
     opts.pluginId,
     async (cmd) => {
@@ -20694,7 +20732,7 @@ async function runAcpSession(opts) {
         history,
         initialize.agentCapabilities,
         turnFiles,
-        () => beads
+        getBeads
       );
     },
     { id: opts.agent, name: opts.agent, displayName: opts.agent }
@@ -20705,7 +20743,6 @@ async function runAcpSession(opts) {
     relay.stop();
     void fileWatcher.stop();
     turnFiles.stop();
-    void beads?.watcher.stop();
     closeAllTerminals();
     await client2.stop();
     process.exit(0);
@@ -21813,8 +21850,8 @@ var OutputService = class _OutputService {
 };
 
 // src/services/history.service.ts
-var fs34 = __toESM(require("fs"));
-var path42 = __toESM(require("path"));
+var fs35 = __toESM(require("fs"));
+var path43 = __toESM(require("path"));
 var os27 = __toESM(require("os"));
 var https7 = __toESM(require("https"));
 var http7 = __toESM(require("http"));
@@ -21842,7 +21879,7 @@ function parseJsonl(filePath) {
   const messages = [];
   let raw;
   try {
-    raw = fs34.readFileSync(filePath, "utf8");
+    raw = fs35.readFileSync(filePath, "utf8");
   } catch (err) {
     if (err.code !== "ENOENT") {
       log.warn("history:parseJsonl", `read failed for ${filePath}`, err);
@@ -21977,7 +22014,7 @@ var HistoryService = class _HistoryService {
     return this._quotaPercent === null || Date.now() - this._quotaFetchedAt > ttlMs;
   }
   get projectDir() {
-    return this.runtime.resolveHistoryDir(this.cwd) ?? path42.join(os27.homedir(), ".claude", "projects", encodeCwd(this.cwd));
+    return this.runtime.resolveHistoryDir(this.cwd) ?? path43.join(os27.homedir(), ".claude", "projects", encodeCwd(this.cwd));
   }
   /** Set the current Claude conversation ID (extracted from /cost command or session start) */
   setCurrentConversationId(id) {
@@ -21989,7 +22026,7 @@ var HistoryService = class _HistoryService {
   /** Return the current message count in the active conversation. */
   getCurrentMessageCount() {
     if (!this.currentConversationId) return 0;
-    const filePath = path42.join(this.projectDir, `${this.currentConversationId}.jsonl`);
+    const filePath = path43.join(this.projectDir, `${this.currentConversationId}.jsonl`);
     return parseJsonl(filePath).length;
   }
   /**
@@ -22000,7 +22037,7 @@ var HistoryService = class _HistoryService {
     const deadline = Date.now() + timeoutMs;
     while (Date.now() < deadline) {
       if (!this.currentConversationId) return null;
-      const filePath = path42.join(this.projectDir, `${this.currentConversationId}.jsonl`);
+      const filePath = path43.join(this.projectDir, `${this.currentConversationId}.jsonl`);
       const messages = parseJsonl(filePath);
       if (messages.length > previousCount) {
         for (let i = messages.length - 1; i >= previousCount; i--) {
@@ -22026,16 +22063,16 @@ var HistoryService = class _HistoryService {
     const dir = this.projectDir;
     const cutoff = this.bootTimeMs - _HistoryService.BIRTHTIME_GRACE_MS;
     try {
-      const files = fs34.readdirSync(dir, { withFileTypes: true }).filter((e) => e.isFile() && e.name.endsWith(".jsonl")).map((e) => {
+      const files = fs35.readdirSync(dir, { withFileTypes: true }).filter((e) => e.isFile() && e.name.endsWith(".jsonl")).map((e) => {
         try {
-          const stat3 = fs34.statSync(path42.join(dir, e.name));
+          const stat3 = fs35.statSync(path43.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 = path42.basename(files[0].name, ".jsonl");
+        this.currentConversationId = path43.basename(files[0].name, ".jsonl");
       }
     } catch {
     }
@@ -22069,13 +22106,13 @@ var HistoryService = class _HistoryService {
     const cutoff = this.bootTimeMs - _HistoryService.BIRTHTIME_GRACE_MS;
     let entries;
     try {
-      entries = fs34.readdirSync(dir, { withFileTypes: true });
+      entries = fs35.readdirSync(dir, { withFileTypes: true });
     } catch {
       return null;
     }
     const files = entries.filter((e) => e.isFile() && e.name.endsWith(".jsonl")).map((e) => {
       try {
-        const stat3 = fs34.statSync(path42.join(dir, e.name));
+        const stat3 = fs35.statSync(path43.join(dir, e.name));
         return { name: e.name, mtime: stat3.mtimeMs, birthtime: stat3.birthtimeMs };
       } catch {
         return { name: e.name, mtime: 0, birthtime: 0 };
@@ -22084,12 +22121,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(path42.join(dir, targetFile));
+    return this.extractUsageFromFile(path43.join(dir, targetFile));
   }
   extractUsageFromFile(filePath) {
     let raw;
     try {
-      raw = fs34.readFileSync(filePath, "utf8");
+      raw = fs35.readFileSync(filePath, "utf8");
     } catch {
       return null;
     }
@@ -22134,9 +22171,9 @@ var HistoryService = class _HistoryService {
     let totalCost = 0;
     let files;
     try {
-      files = fs34.readdirSync(projectDir).filter((f) => f.endsWith(".jsonl")).filter((f) => {
+      files = fs35.readdirSync(projectDir).filter((f) => f.endsWith(".jsonl")).filter((f) => {
         try {
-          return fs34.statSync(path42.join(projectDir, f)).mtimeMs >= monthStartMs;
+          return fs35.statSync(path43.join(projectDir, f)).mtimeMs >= monthStartMs;
         } catch {
           return false;
         }
@@ -22147,7 +22184,7 @@ var HistoryService = class _HistoryService {
     for (const file of files) {
       let raw;
       try {
-        raw = fs34.readFileSync(path42.join(projectDir, file), "utf8");
+        raw = fs35.readFileSync(path43.join(projectDir, file), "utf8");
       } catch {
         continue;
       }
@@ -22211,7 +22248,7 @@ var HistoryService = class _HistoryService {
    * showing an empty conversation.
    */
   async loadConversation(sessionId) {
-    const filePath = path42.join(this.projectDir, `${sessionId}.jsonl`);
+    const filePath = path43.join(this.projectDir, `${sessionId}.jsonl`);
     const messages = parseJsonl(filePath);
     if (messages.length === 0) return;
     const totalBatches = Math.ceil(messages.length / CONVERSATION_BATCH_SIZE);
@@ -22265,7 +22302,7 @@ var HistoryService = class _HistoryService {
       if (!this.currentConversationId) return 0;
     }
     const sessionId = this.currentConversationId;
-    const filePath = path42.join(this.projectDir, `${sessionId}.jsonl`);
+    const filePath = path43.join(this.projectDir, `${sessionId}.jsonl`);
     const messages = parseJsonl(filePath);
     if (messages.length === 0) return 0;
     const marker = this.lastUploadedUuid.get(sessionId);
@@ -22787,6 +22824,20 @@ async function start(requestedAgent) {
     "pluginAuth",
     `boot triple sessionId=${session.id} pluginId=${pluginId} tokenLen=${tokenForLog.length} tokenHead=${tokenForLog.slice(0, 12)} tokenTail=${tokenForLog.slice(-8)} mintedEqualsCached=${refreshed === session.pluginAuthToken}`
   );
+  let beads = null;
+  const getBeads = () => beads;
+  const beadsReady = provisionBeadsForStart({
+    sessionId: session.id,
+    pluginId,
+    pluginAuthToken: session.pluginAuthToken ?? void 0,
+    cwd,
+    // Wire this session's agent natively via `bd setup <recipe> --global` so
+    // the agent actually uses bd (D12 — REVISED). Covers BOTH ACP and PTY.
+    agents: [session.agent]
+  }).then((started) => {
+    beads = started;
+    return started;
+  });
   const acpDisabled = process.env.CODEAM_ACP_DISABLED === "1";
   if (!acpDisabled && session.pluginAuthToken) {
     const adapter = getAcpAdapter(session.agent);
@@ -22797,7 +22848,8 @@ async function start(requestedAgent) {
         pluginId,
         pluginAuthToken: session.pluginAuthToken,
         adapter,
-        cwd
+        cwd,
+        getBeads
       });
       return;
     }
@@ -22859,7 +22911,6 @@ async function start(requestedAgent) {
     dirtyTracker: dirtyTracker ?? void 0
   }) : null;
   let streamingEmitter = null;
-  let beads = null;
   const agent = new AgentService(
     runtime,
     {
@@ -22910,14 +22961,7 @@ async function start(requestedAgent) {
     await dispatchCommand(ctx, cmd);
   }, runtime.meta);
   ctx.relay = relay;
-  void startBeadsForSession({
-    sessionId: session.id,
-    pluginId,
-    pluginAuthToken: session.pluginAuthToken ?? void 0,
-    agents: [session.agent],
-    cwd
-  }).then((started) => {
-    beads = started;
+  void beadsReady.then((started) => {
     ctx.beads = started;
   });
   registerTerminalHandlers({
@@ -23175,7 +23219,7 @@ async function autoLinkAfterPair(opts) {
 }
 
 // src/commands/pair-auto.ts
-var fs35 = __toESM(require("fs"));
+var fs36 = __toESM(require("fs"));
 var os28 = __toESM(require("os"));
 var import_crypto7 = require("crypto");
 
@@ -23236,6 +23280,15 @@ async function startInfraOnly(agentId) {
     pluginId,
     pluginAuthToken: session.pluginAuthToken
   }) : null;
+  let beads = null;
+  void provisionBeadsForStart({
+    sessionId: session.id,
+    pluginId,
+    pluginAuthToken: session.pluginAuthToken ?? void 0,
+    cwd
+  }).then((started) => {
+    beads = started;
+  });
   let relayRef = null;
   const ctx = {
     // Agent-touching fields are not used by any of the commands
@@ -23257,6 +23310,23 @@ async function startInfraOnly(agentId) {
   const relay = new CommandRelayService(
     pluginId,
     async (cmd) => {
+      if (cmd.type === "beads_action") {
+        if (!beads) {
+          log.trace("infra-only", "beads_action received but beads not running \u2014 dropping");
+          return;
+        }
+        const action = beadsActionFromPayload(cmd.payload);
+        if (!action) {
+          log.warn("infra-only", "malformed beads_action payload \u2014 dropping");
+          return;
+        }
+        try {
+          await handleBeadsActionCommand(action, beads);
+        } catch (err) {
+          log.warn("infra-only", "handleBeadsActionCommand failed (non-fatal)", err);
+        }
+        return;
+      }
       if (!INFRA_ONLY_COMMAND_TYPES.has(cmd.type)) {
         log.trace("infra-only", `dropping agent-only command type=${cmd.type}`);
         return;
@@ -23317,6 +23387,7 @@ async function startInfraOnly(agentId) {
     } catch {
     }
     void fileWatcher?.stop();
+    void beads?.watcher.stop();
     closeAllTerminals();
     cleanupAttachmentTempFiles();
     process.exit(0);
@@ -23344,12 +23415,12 @@ function readTokenFromArgs(args2) {
   }
   const fileFlag = args2.find((a) => a.startsWith("--token-file="));
   if (fileFlag) {
-    const path49 = fileFlag.slice("--token-file=".length);
+    const path50 = fileFlag.slice("--token-file=".length);
     try {
-      const content = fs35.readFileSync(path49, "utf8").trim();
-      if (content.length === 0) fail(`--token-file ${path49} is empty`);
+      const content = fs36.readFileSync(path50, "utf8").trim();
+      if (content.length === 0) fail(`--token-file ${path50} is empty`);
       try {
-        fs35.unlinkSync(path49);
+        fs36.unlinkSync(path50);
       } catch {
       }
       return content;
@@ -23615,7 +23686,7 @@ var import_picocolors10 = __toESM(require("picocolors"));
 var import_child_process19 = require("child_process");
 var import_util4 = require("util");
 var import_picocolors8 = __toESM(require("picocolors"));
-var path43 = __toESM(require("path"));
+var path44 = __toESM(require("path"));
 var execFileP5 = (0, import_util4.promisify)(import_child_process19.execFile);
 var MAX_BUFFER = 8 * 1024 * 1024;
 function resetStdinForChild() {
@@ -24104,7 +24175,7 @@ var GitHubCodespacesProvider = class {
     });
   }
   async uploadFile(workspaceId, remotePath, contents, options = {}) {
-    const remoteDir = path43.posix.dirname(remotePath);
+    const remoteDir = path44.posix.dirname(remotePath);
     const parts = [
       `mkdir -p ${shellQuote(remoteDir)}`,
       `cat > ${shellQuote(remotePath)}`
@@ -24174,7 +24245,7 @@ function shellQuote(s) {
 // src/services/providers/gitpod.ts
 var import_child_process20 = require("child_process");
 var import_util5 = require("util");
-var path44 = __toESM(require("path"));
+var path45 = __toESM(require("path"));
 var import_picocolors9 = __toESM(require("picocolors"));
 var execFileP6 = (0, import_util5.promisify)(import_child_process20.execFile);
 var MAX_BUFFER2 = 8 * 1024 * 1024;
@@ -24414,7 +24485,7 @@ var GitpodProvider = class {
     });
   }
   async uploadFile(workspaceId, remotePath, contents, options = {}) {
-    const remoteDir = path44.posix.dirname(remotePath);
+    const remoteDir = path45.posix.dirname(remotePath);
     const parts = [
       `mkdir -p ${shellQuote2(remoteDir)}`,
       `cat > ${shellQuote2(remotePath)}`
@@ -24450,7 +24521,7 @@ function shellQuote2(s) {
 // src/services/providers/gitlab-workspaces.ts
 var import_child_process21 = require("child_process");
 var import_util6 = require("util");
-var path45 = __toESM(require("path"));
+var path46 = __toESM(require("path"));
 var execFileP7 = (0, import_util6.promisify)(import_child_process21.execFile);
 var MAX_BUFFER3 = 8 * 1024 * 1024;
 var GITLAB_API_BASE = process.env.CODEAM_GITLAB_API_URL ?? "https://gitlab.com/api/v4";
@@ -24710,7 +24781,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 = path45.posix.dirname(remotePath);
+    const remoteDir = path46.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)}`);
@@ -24778,7 +24849,7 @@ function shellQuote3(s) {
 // src/services/providers/railway.ts
 var import_child_process22 = require("child_process");
 var import_util7 = require("util");
-var path46 = __toESM(require("path"));
+var path47 = __toESM(require("path"));
 var execFileP8 = (0, import_util7.promisify)(import_child_process22.execFile);
 var MAX_BUFFER4 = 8 * 1024 * 1024;
 function resetStdinForChild4() {
@@ -25014,7 +25085,7 @@ var RailwayProvider = class {
     if (!projectId || !serviceId) {
       throw new Error("Invalid Railway workspace id (expected projectId/serviceId).");
     }
-    const remoteDir = path46.posix.dirname(remotePath);
+    const remoteDir = path47.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)}`);
@@ -25557,8 +25628,8 @@ async function stopWorkspaceFromLocal(target) {
 var import_node_dns = require("dns");
 var import_node_util4 = require("util");
 var import_node_crypto8 = require("crypto");
-var fs36 = __toESM(require("fs"));
-var path47 = __toESM(require("path"));
+var fs37 = __toESM(require("fs"));
+var path48 = __toESM(require("path"));
 var import_picocolors12 = __toESM(require("picocolors"));
 var dnsResolveP = (0, import_node_util4.promisify)(import_node_dns.resolve);
 async function checkDns(apiBase) {
@@ -25614,13 +25685,13 @@ async function checkHealth(apiBase) {
   }
 }
 function checkConfigDir() {
-  const dir = path47.join(require("os").homedir(), ".codeam");
+  const dir = path48.join(require("os").homedir(), ".codeam");
   try {
-    fs36.mkdirSync(dir, { recursive: true, mode: 448 });
-    const probe = path47.join(dir, ".doctor-probe");
-    fs36.writeFileSync(probe, "ok", { mode: 384 });
-    const read = fs36.readFileSync(probe, "utf8");
-    fs36.unlinkSync(probe);
+    fs37.mkdirSync(dir, { recursive: true, mode: 448 });
+    const probe = path48.join(dir, ".doctor-probe");
+    fs37.writeFileSync(probe, "ok", { mode: 384 });
+    const read = fs37.readFileSync(probe, "utf8");
+    fs37.unlinkSync(probe);
     if (read !== "ok") throw new Error("write/read round-trip mismatch");
     return {
       id: "config-dir",
@@ -25684,7 +25755,7 @@ function checkNodePty() {
       detail: "not required on this platform"
     };
   }
-  const vendoredPath = path47.join(__dirname, "vendor", "node-pty");
+  const vendoredPath = path48.join(__dirname, "vendor", "node-pty");
   for (const target of [vendoredPath, "node-pty"]) {
     try {
       require(target);
@@ -25726,7 +25797,7 @@ function checkChokidar() {
 }
 async function doctor(args2 = []) {
   const json = args2.includes("--json");
-  const cliVersion = true ? "2.33.0" : "0.0.0-dev";
+  const cliVersion = true ? "2.34.0" : "0.0.0-dev";
   const apiBase = resolveApiBaseUrl();
   const diagnosticId = (0, import_node_crypto8.randomUUID)();
   log.info("doctor", `run id=${diagnosticId} cli=${cliVersion}`);
@@ -25925,7 +25996,7 @@ async function completion(args2) {
 // src/commands/version.ts
 var import_picocolors13 = __toESM(require("picocolors"));
 function version2() {
-  const v = true ? "2.33.0" : "unknown";
+  const v = true ? "2.34.0" : "unknown";
   console.log(`${import_picocolors13.default.bold("codeam-cli")} ${import_picocolors13.default.cyan(v)}`);
 }
 
@@ -26053,9 +26124,9 @@ function tryShowSubcommandHelp(cmd, args2) {
 var _subcommandHelpKeys = Object.keys(HELPS);
 
 // src/lib/updateNotifier.ts
-var fs37 = __toESM(require("fs"));
+var fs38 = __toESM(require("fs"));
 var os29 = __toESM(require("os"));
-var path48 = __toESM(require("path"));
+var path49 = __toESM(require("path"));
 var https8 = __toESM(require("https"));
 var import_node_child_process12 = require("child_process");
 var import_picocolors16 = __toESM(require("picocolors"));
@@ -26064,12 +26135,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 = path48.join(os29.homedir(), ".codeam");
-  return path48.join(dir, "update-check.json");
+  const dir = path49.join(os29.homedir(), ".codeam");
+  return path49.join(dir, "update-check.json");
 }
 function readCache() {
   try {
-    const raw = fs37.readFileSync(cachePath(), "utf8");
+    const raw = fs38.readFileSync(cachePath(), "utf8");
     const parsed = JSON.parse(raw);
     if (typeof parsed.fetchedAt !== "number" || typeof parsed.latest !== "string") return null;
     return parsed;
@@ -26080,10 +26151,10 @@ function readCache() {
 function writeCache(cache) {
   try {
     const file = cachePath();
-    fs37.mkdirSync(path48.dirname(file), { recursive: true });
+    fs38.mkdirSync(path49.dirname(file), { recursive: true });
     const tmp = `${file}.${process.pid}.tmp`;
-    fs37.writeFileSync(tmp, JSON.stringify(cache));
-    fs37.renameSync(tmp, file);
+    fs38.writeFileSync(tmp, JSON.stringify(cache));
+    fs38.renameSync(tmp, file);
   } catch {
   }
 }
@@ -26157,8 +26228,8 @@ function isLinkedInstall() {
       timeout: 2e3
     }).trim();
     if (!root) return false;
-    const pkgPath = path48.join(root, PKG_NAME);
-    return fs37.lstatSync(pkgPath).isSymbolicLink();
+    const pkgPath = path49.join(root, PKG_NAME);
+    return fs38.lstatSync(pkgPath).isSymbolicLink();
   } catch {
     return false;
   }
@@ -26194,7 +26265,7 @@ function maybeAutoUpdate(currentVersion, latest) {
     return;
   }
   try {
-    fs37.unlinkSync(cachePath());
+    fs38.unlinkSync(cachePath());
   } catch {
   }
   process.stderr.write(`  ${import_picocolors16.default.green("\u2713")} Updated. Resuming session...
@@ -26211,7 +26282,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.33.0" : null;
+  const current = true ? "2.34.0" : null;
   if (!current) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codeam-cli",
-  "version": "2.33.0",
+  "version": "2.34.0",
   "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",