codeam-cli 2.62.0 → 2.62.1

package/CHANGELOG.md

@@ -4,6 +4,12 @@ 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.62.0] — 2026-08-13
+
+### Fixed
+
+- **cli:** Make the Headroom proxy self-heal actually fire, and stop killing healthy proxies (#613)
+
 ## [2.61.99] — 2026-08-13
 
 ### Added

package/dist/index.js

@@ -8022,7 +8022,7 @@ function readAnonId() {
 }
 function superProperties() {
   return {
-    cliVersion: true ? "2.62.0" : "0.0.0-dev",
+    cliVersion: true ? "2.62.1" : "0.0.0-dev",
     nodeVersion: process.version,
     platform: process.platform,
     arch: process.arch,
@@ -8203,7 +8203,7 @@ var os4 = __toESM(require("os"));
 // package.json
 var package_default = {
   name: "codeam-cli",
-  version: "2.62.0",
+  version: "2.62.1",
   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",
@@ -8863,6 +8863,7 @@ function computePollDelay({ baseMs, failures }) {
 var fs7 = __toESM(require("fs"));
 var os7 = __toESM(require("os"));
 var path6 = __toESM(require("path"));
+var net = __toESM(require("net"));
 
 // src/services/headroom/proxy-process.ts
 var import_child_process2 = require("child_process");
@@ -9088,6 +9089,7 @@ function spawnHeadroomProxy(logging, opts = {}) {
 
 // src/services/headroom/proxy-supervisor.ts
 var PROXY_STARTUP_GRACE_MS = 45e3;
+var PRE_TURN_READY_TIMEOUT_MS = 15e4;
 async function ensureHeadroomProxy(deps) {
   if (!deps.isConfigured()) return "skip";
   let alive = false;
@@ -9119,11 +9121,19 @@ async function ensureHeadroomProxyReady(deps, opts = {}) {
   (deps.spawnProxyForce ?? deps.spawnProxy)();
   const sleep5 = opts.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
   const pollMs = opts.pollMs ?? 1500;
-  const maxPolls = Math.max(1, Math.ceil((opts.timeoutMs ?? 6e4) / pollMs));
+  const maxPolls = Math.max(1, Math.ceil((opts.timeoutMs ?? PRE_TURN_READY_TIMEOUT_MS) / pollMs));
   for (let i = 0; i < maxPolls; i += 1) {
     await sleep5(pollMs);
+    const elapsed = (i + 1) * pollMs / 1e3;
     if (await deps.probeAlive().catch(() => false)) {
-      log.info("headroom-supervisor", `proxy :8787 ready after ~${(i + 1) * pollMs / 1e3}s`);
+      log.info("headroom-supervisor", `proxy :8787 ready after ~${elapsed}s`);
+      return true;
+    }
+    if (await (deps.probePortOpen?.() ?? Promise.resolve(false)).catch(() => false)) {
+      log.info(
+        "headroom-supervisor",
+        `proxy :8787 accepting connections after ~${elapsed}s (still warming \u2014 turn is safe to send)`
+      );
       return true;
     }
   }
@@ -9166,6 +9176,20 @@ async function probeProxyAliveReal() {
     clearTimeout(timer);
   }
 }
+async function probeProxyPortOpenReal() {
+  return new Promise((resolve9) => {
+    const socket = net.connect({ host: "127.0.0.1", port: 8787 });
+    const done = (ok) => {
+      socket.removeAllListeners();
+      socket.destroy();
+      resolve9(ok);
+    };
+    socket.setTimeout(2e3);
+    socket.once("connect", () => done(true));
+    socket.once("timeout", () => done(false));
+    socket.once("error", () => done(false));
+  });
+}
 function spawnProxyReal() {
   spawnHeadroomProxy({
     tag: "headroom-supervisor",
@@ -9177,6 +9201,7 @@ function makeRealProxySupervisorDeps() {
   return {
     isConfigured: () => isHeadroomConfiguredReal(),
     probeAlive: probeProxyAliveReal,
+    probePortOpen: probeProxyPortOpenReal,
     proxyProcessAlive: () => isHeadroomProxyProcessAlive(),
     proxyStartupAgeMs: () => headroomProxyPidfileAgeMs(Date.now()),
     adoptRunningProxy: () => adoptRunningProxy(),
@@ -9587,7 +9612,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.62.0" ? { ideVersion: "2.62.0" } : {}
+      ..."2.62.1" ? { ideVersion: "2.62.1" } : {}
     }).then(() => log.trace("relay", `heartbeat ok online=${online}`)).catch((err) => log.trace("relay", `heartbeat failed online=${online}`, err));
   }
   /**
@@ -13757,7 +13782,7 @@ function subscribeToPairCompletion(pluginId, onPaired, onTimeout, pollSecret) {
     onPaired(info);
   };
   dispatchers.add(dispatch);
-  const connect = () => {
+  const connect2 = () => {
     if (stopped) return;
     const url2 = new URL(`${API_BASE5}/api/commands/pending/stream`);
     url2.searchParams.set("pluginId", pluginId);
@@ -13783,7 +13808,7 @@ function subscribeToPairCompletion(pluginId, onPaired, onTimeout, pollSecret) {
             `sse status=${res.statusCode}; will reconnect in 1s`
           );
           res.resume();
-          setTimeout(connect, 1e3);
+          setTimeout(connect2, 1e3);
           return;
         }
         let buf = "";
@@ -13798,23 +13823,23 @@ function subscribeToPairCompletion(pluginId, onPaired, onTimeout, pollSecret) {
           }
         });
         res.on("end", () => {
-          if (!stopped) setTimeout(connect, 250);
+          if (!stopped) setTimeout(connect2, 250);
         });
         res.on("error", () => {
-          if (!stopped) setTimeout(connect, 1e3);
+          if (!stopped) setTimeout(connect2, 1e3);
         });
       }
     );
     req.on("error", () => {
-      if (!stopped) setTimeout(connect, 1e3);
+      if (!stopped) setTimeout(connect2, 1e3);
     });
     req.on("timeout", () => {
       req?.destroy();
-      if (!stopped) setTimeout(connect, 250);
+      if (!stopped) setTimeout(connect2, 250);
     });
     req.end();
   };
-  connect();
+  connect2();
   timeoutTimer = setTimeout(() => {
     stop();
     onTimeout();
@@ -20790,7 +20815,7 @@ async function autoUpgradeBeforeCriticalCommand() {
   if (process.env.NODE_ENV === "test") return;
   if (process.env.CODEAM_DISABLE_UPDATE_CHECK === "1") return;
   if (process.env.CI) return;
-  const current2 = true ? "2.62.0" : null;
+  const current2 = true ? "2.62.1" : null;
   if (!current2) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -20807,7 +20832,7 @@ function checkForUpdates() {
   if (process.env.CODEAM_DISABLE_UPDATE_CHECK === "1") return;
   if (process.env.CI) return;
   if (!process.stdout.isTTY) return;
-  const current2 = true ? "2.62.0" : null;
+  const current2 = true ? "2.62.1" : null;
   if (!current2) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -20827,7 +20852,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.62.0" : null;
+  return true ? "2.62.1" : null;
 }
 function runCmd(cmd, args2, timeoutMs) {
   return new Promise((resolve9) => {
@@ -23169,10 +23194,10 @@ function parseExpoUrl(stdout) {
 }
 
 // src/services/preview/port-ready.ts
-var net = __toESM(require("net"));
+var net2 = __toESM(require("net"));
 function isPortListening(port, host2 = "127.0.0.1") {
   return new Promise((resolve9) => {
-    const socket = new net.Socket();
+    const socket = new net2.Socket();
     const done = (result) => {
       socket.removeAllListeners();
       socket.destroy();
@@ -42808,7 +42833,7 @@ function checkChokidar() {
 }
 async function doctor(args2 = []) {
   const json = args2.includes("--json");
-  const cliVersion = true ? "2.62.0" : "0.0.0-dev";
+  const cliVersion = true ? "2.62.1" : "0.0.0-dev";
   const apiBase2 = resolveApiBaseUrl();
   const diagnosticId = (0, import_node_crypto13.randomUUID)();
   log.info("doctor", `run id=${diagnosticId} cli=${cliVersion}`);
@@ -43199,7 +43224,7 @@ async function mcpRun(args2) {
 // src/commands/version.ts
 var import_picocolors15 = __toESM(require("picocolors"));
 function version2() {
-  const v = true ? "2.62.0" : "unknown";
+  const v = true ? "2.62.1" : "unknown";
   console.log(`${import_picocolors15.default.bold("codeam-cli")} ${import_picocolors15.default.cyan(v)}`);
 }
 

package/package.json

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