codeam-cli 2.39.1 → 2.39.3

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.39.2] — 2026-06-12
+
+### Added
+
+- **cli:** Pre-warm preview detection so the first Start Preview is instant
+
+## [2.39.1] — 2026-06-12
+
+### Fixed
+
+- **cli:** Disable in-session auto-provision — it starved/killed sessions ⚠️ BREAKING CHANGE
+
 ## [2.39.0] — 2026-06-12
 
 ### Added

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.39.1",
+  version: "2.39.3",
   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",
@@ -1186,8 +1186,8 @@ function createGetModuleFromFilename(basePath = process.argv[1] ? (0, import_pat
     return decodedFile;
   };
 }
-function normalizeWindowsPath(path52) {
-  return path52.replace(/^[A-Z]:/, "").replace(/\\/g, "/");
+function normalizeWindowsPath(path53) {
+  return path53.replace(/^[A-Z]:/, "").replace(/\\/g, "/");
 }
 
 // ../../node_modules/@posthog/core/dist/featureFlagUtils.mjs
@@ -3667,9 +3667,9 @@ async function addSourceContext(frames) {
   LRU_FILE_CONTENTS_CACHE.reduce();
   return frames;
 }
-function getContextLinesFromFile(path52, ranges, output) {
+function getContextLinesFromFile(path53, ranges, output) {
   return new Promise((resolve7) => {
-    const stream = (0, import_node_fs.createReadStream)(path52);
+    const stream = (0, import_node_fs.createReadStream)(path53);
     const lineReaded = (0, import_node_readline.createInterface)({
       input: stream
     });
@@ -3684,7 +3684,7 @@ function getContextLinesFromFile(path52, ranges, output) {
     let rangeStart = range[0];
     let rangeEnd = range[1];
     function onStreamError() {
-      LRU_FILE_CONTENTS_FS_READ_FAILED.set(path52, 1);
+      LRU_FILE_CONTENTS_FS_READ_FAILED.set(path53, 1);
       lineReaded.close();
       lineReaded.removeAllListeners();
       destroyStreamAndResolve();
@@ -3745,8 +3745,8 @@ function clearLineContext(frame) {
   delete frame.context_line;
   delete frame.post_context;
 }
-function shouldSkipContextLinesForFile(path52) {
-  return path52.startsWith("node:") || path52.endsWith(".min.js") || path52.endsWith(".min.cjs") || path52.endsWith(".min.mjs") || path52.startsWith("data:");
+function shouldSkipContextLinesForFile(path53) {
+  return path53.startsWith("node:") || path53.endsWith(".min.js") || path53.endsWith(".min.cjs") || path53.endsWith(".min.mjs") || path53.startsWith("data:");
 }
 function shouldSkipContextLinesForFrame(frame) {
   if (void 0 !== frame.lineno && frame.lineno > MAX_CONTEXTLINES_LINENO) return true;
@@ -5900,7 +5900,7 @@ function readAnonId() {
 }
 function superProperties() {
   return {
-    cliVersion: true ? "2.39.1" : "0.0.0-dev",
+    cliVersion: true ? "2.39.3" : "0.0.0-dev",
     nodeVersion: process.version,
     platform: process.platform,
     arch: process.arch,
@@ -9978,13 +9978,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 path52 = pathLine && !BANNER_ART_RE.test(pathLine) ? pathLine : "";
+  const path53 = pathLine && !BANNER_ART_RE.test(pathLine) ? pathLine : "";
   return {
     title: "",
     subtitle: lines[metaIdx].trim(),
-    path: path52,
+    path: path53,
     startIdx: artStart,
-    endIdx: metaIdx + (path52 ? 1 : 0)
+    endIdx: metaIdx + (path53 ? 1 : 0)
   };
 }
 
@@ -11342,11 +11342,11 @@ function parseReview(stdout) {
   for (const line of lines) {
     const m = line.match(HUNK_LINE_RE);
     if (!m) continue;
-    const [, path52, lineNo, sevToken, message] = m;
-    if (!path52 || !lineNo || !message) continue;
+    const [, path53, lineNo, sevToken, message] = m;
+    if (!path53 || !lineNo || !message) continue;
     const cleanedMessage = message.trim().replace(/^[*-]\s+/, "");
     hunks.push({
-      path: path52.trim(),
+      path: path53.trim(),
       line: Number(lineNo),
       severity: sevToken ? SEVERITY_MAP[sevToken.toLowerCase()] : void 0,
       message: cleanedMessage
@@ -19272,6 +19272,28 @@ var requestPreviewDetectH = (ctx) => {
     });
   })();
 };
+var previewPrewarmStarted = false;
+function prewarmPreviewDetection(runtime) {
+  if (previewPrewarmStarted) return;
+  previewPrewarmStarted = true;
+  if (typeof runtime.generateOneShot !== "function") return;
+  void (async () => {
+    try {
+      const cwd = process.cwd();
+      if (await readPreviewConfig(cwd)) return;
+      const raw = await runtime.generateOneShot(PREVIEW_DETECT_PROMPT).catch(() => null);
+      const detection = safeParseDetection(raw);
+      if (!detection || detection.framework === "unsupported") return;
+      await writePreviewConfig(cwd, detection);
+      log.info(
+        "preview",
+        `prewarm: cached detection (${detection.framework} on :${detection.port})`
+      );
+    } catch (err) {
+      log.info("preview", `prewarm: skipped (${String(err)})`);
+    }
+  })();
+}
 function compileReadyPattern(pattern) {
   return new RegExp(pattern, "i");
 }
@@ -19869,10 +19891,10 @@ var WINDOWS_LEGACY_JUNCTIONS = [
   /[\\/]Start Menu([\\/]|$)/i,
   /[\\/]Templates([\\/]|$)/i
 ];
-function isUnsafeWindowsWatchRoot(dir, homedir24) {
+function isUnsafeWindowsWatchRoot(dir, homedir25) {
   const norm = (p2) => p2.replace(/\//g, "\\").replace(/\\+$/, "").toLowerCase();
   const cwd = norm(dir);
-  const home = norm(homedir24);
+  const home = norm(homedir25);
   if (cwd === home) return true;
   if (/^[a-z]:$/.test(cwd)) return true;
   const sysRoots = [
@@ -21541,8 +21563,10 @@ async function runAcpSession(opts) {
     { id: opts.agent, name: opts.agent, displayName: opts.agent }
   );
   relay.start();
+  const prewarmTimer = setTimeout(() => prewarmPreviewDetection(runtime), 2e4);
   const shutdown = async (signal) => {
     showInfo(`Shutting down ACP session (${signal})\u2026`);
+    clearTimeout(prewarmTimer);
     relay.stop();
     void fileWatcher.stop();
     turnFiles.stop();
@@ -24081,6 +24105,7 @@ async function autoLinkAfterPair(opts) {
 // src/commands/pair-auto.ts
 var fs38 = __toESM(require("fs"));
 var os30 = __toESM(require("os"));
+var path46 = __toESM(require("path"));
 var import_crypto7 = require("crypto");
 
 // src/commands/start-infra-only.ts
@@ -24275,12 +24300,12 @@ function readTokenFromArgs(args2) {
   }
   const fileFlag = args2.find((a) => a.startsWith("--token-file="));
   if (fileFlag) {
-    const path52 = fileFlag.slice("--token-file=".length);
+    const path53 = fileFlag.slice("--token-file=".length);
     try {
-      const content = fs38.readFileSync(path52, "utf8").trim();
-      if (content.length === 0) fail(`--token-file ${path52} is empty`);
+      const content = fs38.readFileSync(path53, "utf8").trim();
+      if (content.length === 0) fail(`--token-file ${path53} is empty`);
       try {
-        fs38.unlinkSync(path52);
+        fs38.unlinkSync(path53);
       } catch {
       }
       return content;
@@ -24362,7 +24387,53 @@ async function claim(token, pluginId) {
     }
   }
 }
+function pairAutoLockPath() {
+  return path46.join(os30.homedir(), ".codeam", "pair-auto.lock");
+}
+function isLivePairAuto(pid) {
+  if (!Number.isInteger(pid) || pid <= 0 || pid === process.pid) return false;
+  try {
+    process.kill(pid, 0);
+  } catch (e) {
+    if (e.code !== "EPERM") return false;
+  }
+  try {
+    return fs38.readFileSync(`/proc/${pid}/cmdline`, "utf8").includes("codeam");
+  } catch {
+    return true;
+  }
+}
+function acquireSingletonLock() {
+  const lockPath = pairAutoLockPath();
+  try {
+    fs38.mkdirSync(path46.dirname(lockPath), { recursive: true });
+    try {
+      fs38.writeFileSync(lockPath, String(process.pid), { flag: "wx" });
+    } catch (e) {
+      if (e.code !== "EEXIST") throw e;
+      const holder = Number(fs38.readFileSync(lockPath, "utf8").trim());
+      if (isLivePairAuto(holder)) return false;
+      fs38.writeFileSync(lockPath, String(process.pid));
+    }
+    process.once("exit", () => {
+      try {
+        if (fs38.existsSync(lockPath) && Number(fs38.readFileSync(lockPath, "utf8").trim()) === process.pid) {
+          fs38.unlinkSync(lockPath);
+        }
+      } catch {
+      }
+    });
+    return true;
+  } catch {
+    return true;
+  }
+}
 async function pairAuto(args2) {
+  if (!acquireSingletonLock()) {
+    capture("pair_auto_deferred_singleton", {});
+    console.log("  A codeam session is already running here \u2014 deferring to it.");
+    return;
+  }
   const token = readTokenFromArgs(args2);
   const pluginId = (0, import_crypto7.randomUUID)();
   capture("pair_auto_started", { pluginId });
@@ -24546,7 +24617,7 @@ var import_picocolors10 = __toESM(require("picocolors"));
 var import_child_process22 = require("child_process");
 var import_util4 = require("util");
 var import_picocolors8 = __toESM(require("picocolors"));
-var path46 = __toESM(require("path"));
+var path47 = __toESM(require("path"));
 var execFileP5 = (0, import_util4.promisify)(import_child_process22.execFile);
 var MAX_BUFFER = 8 * 1024 * 1024;
 function resetStdinForChild() {
@@ -25035,7 +25106,7 @@ var GitHubCodespacesProvider = class {
     });
   }
   async uploadFile(workspaceId, remotePath, contents, options = {}) {
-    const remoteDir = path46.posix.dirname(remotePath);
+    const remoteDir = path47.posix.dirname(remotePath);
     const parts = [
       `mkdir -p ${shellQuote(remoteDir)}`,
       `cat > ${shellQuote(remotePath)}`
@@ -25105,7 +25176,7 @@ function shellQuote(s) {
 // src/services/providers/gitpod.ts
 var import_child_process23 = require("child_process");
 var import_util5 = require("util");
-var path47 = __toESM(require("path"));
+var path48 = __toESM(require("path"));
 var import_picocolors9 = __toESM(require("picocolors"));
 var execFileP6 = (0, import_util5.promisify)(import_child_process23.execFile);
 var MAX_BUFFER2 = 8 * 1024 * 1024;
@@ -25345,7 +25416,7 @@ var GitpodProvider = class {
     });
   }
   async uploadFile(workspaceId, remotePath, contents, options = {}) {
-    const remoteDir = path47.posix.dirname(remotePath);
+    const remoteDir = path48.posix.dirname(remotePath);
     const parts = [
       `mkdir -p ${shellQuote2(remoteDir)}`,
       `cat > ${shellQuote2(remotePath)}`
@@ -25381,7 +25452,7 @@ function shellQuote2(s) {
 // src/services/providers/gitlab-workspaces.ts
 var import_child_process24 = require("child_process");
 var import_util6 = require("util");
-var path48 = __toESM(require("path"));
+var path49 = __toESM(require("path"));
 var execFileP7 = (0, import_util6.promisify)(import_child_process24.execFile);
 var MAX_BUFFER3 = 8 * 1024 * 1024;
 var GITLAB_API_BASE = process.env.CODEAM_GITLAB_API_URL ?? "https://gitlab.com/api/v4";
@@ -25641,7 +25712,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 = path48.posix.dirname(remotePath);
+    const remoteDir = path49.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)}`);
@@ -25709,7 +25780,7 @@ function shellQuote3(s) {
 // src/services/providers/railway.ts
 var import_child_process25 = require("child_process");
 var import_util7 = require("util");
-var path49 = __toESM(require("path"));
+var path50 = __toESM(require("path"));
 var execFileP8 = (0, import_util7.promisify)(import_child_process25.execFile);
 var MAX_BUFFER4 = 8 * 1024 * 1024;
 function resetStdinForChild4() {
@@ -25945,7 +26016,7 @@ var RailwayProvider = class {
     if (!projectId || !serviceId) {
       throw new Error("Invalid Railway workspace id (expected projectId/serviceId).");
     }
-    const remoteDir = path49.posix.dirname(remotePath);
+    const remoteDir = path50.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)}`);
@@ -26489,7 +26560,7 @@ var import_node_dns = require("dns");
 var import_node_util4 = require("util");
 var import_node_crypto8 = require("crypto");
 var fs39 = __toESM(require("fs"));
-var path50 = __toESM(require("path"));
+var path51 = __toESM(require("path"));
 var import_picocolors12 = __toESM(require("picocolors"));
 var dnsResolveP = (0, import_node_util4.promisify)(import_node_dns.resolve);
 async function checkDns(apiBase) {
@@ -26545,10 +26616,10 @@ async function checkHealth(apiBase) {
   }
 }
 function checkConfigDir() {
-  const dir = path50.join(require("os").homedir(), ".codeam");
+  const dir = path51.join(require("os").homedir(), ".codeam");
   try {
     fs39.mkdirSync(dir, { recursive: true, mode: 448 });
-    const probe = path50.join(dir, ".doctor-probe");
+    const probe = path51.join(dir, ".doctor-probe");
     fs39.writeFileSync(probe, "ok", { mode: 384 });
     const read = fs39.readFileSync(probe, "utf8");
     fs39.unlinkSync(probe);
@@ -26615,7 +26686,7 @@ function checkNodePty() {
       detail: "not required on this platform"
     };
   }
-  const vendoredPath = path50.join(__dirname, "vendor", "node-pty");
+  const vendoredPath = path51.join(__dirname, "vendor", "node-pty");
   for (const target of [vendoredPath, "node-pty"]) {
     try {
       require(target);
@@ -26657,7 +26728,7 @@ function checkChokidar() {
 }
 async function doctor(args2 = []) {
   const json = args2.includes("--json");
-  const cliVersion = true ? "2.39.1" : "0.0.0-dev";
+  const cliVersion = true ? "2.39.3" : "0.0.0-dev";
   const apiBase = resolveApiBaseUrl();
   const diagnosticId = (0, import_node_crypto8.randomUUID)();
   log.info("doctor", `run id=${diagnosticId} cli=${cliVersion}`);
@@ -26856,7 +26927,7 @@ async function completion(args2) {
 // src/commands/version.ts
 var import_picocolors13 = __toESM(require("picocolors"));
 function version2() {
-  const v = true ? "2.39.1" : "unknown";
+  const v = true ? "2.39.3" : "unknown";
   console.log(`${import_picocolors13.default.bold("codeam-cli")} ${import_picocolors13.default.cyan(v)}`);
 }
 
@@ -26986,7 +27057,7 @@ var _subcommandHelpKeys = Object.keys(HELPS);
 // src/lib/updateNotifier.ts
 var fs40 = __toESM(require("fs"));
 var os31 = __toESM(require("os"));
-var path51 = __toESM(require("path"));
+var path52 = __toESM(require("path"));
 var https8 = __toESM(require("https"));
 var import_node_child_process12 = require("child_process");
 var import_picocolors16 = __toESM(require("picocolors"));
@@ -26995,8 +27066,8 @@ 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 = path51.join(os31.homedir(), ".codeam");
-  return path51.join(dir, "update-check.json");
+  const dir = path52.join(os31.homedir(), ".codeam");
+  return path52.join(dir, "update-check.json");
 }
 function readCache() {
   try {
@@ -27011,7 +27082,7 @@ function readCache() {
 function writeCache(cache) {
   try {
     const file = cachePath();
-    fs40.mkdirSync(path51.dirname(file), { recursive: true });
+    fs40.mkdirSync(path52.dirname(file), { recursive: true });
     const tmp = `${file}.${process.pid}.tmp`;
     fs40.writeFileSync(tmp, JSON.stringify(cache));
     fs40.renameSync(tmp, file);
@@ -27088,7 +27159,7 @@ function isLinkedInstall() {
       timeout: 2e3
     }).trim();
     if (!root) return false;
-    const pkgPath = path51.join(root, PKG_NAME);
+    const pkgPath = path52.join(root, PKG_NAME);
     return fs40.lstatSync(pkgPath).isSymbolicLink();
   } catch {
     return false;
@@ -27142,7 +27213,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.39.1" : null;
+  const current = true ? "2.39.3" : 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.39.1",
+  "version": "2.39.3",
   "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",