codeam-cli 2.47.1 → 2.48.0

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.47.1] — 2026-06-26
+
+### Chore
+
+- **plugins:** Cloud-fallback follow-ups — test await, validated narrowing, repoSlug+learnMoreUrl tests, path-preserving probe URL, detached-HEAD parity, drop vestigial param (#393)
+
 ## [2.47.0] — 2026-06-26
 
 ### Added

package/dist/index.js

@@ -1093,12 +1093,12 @@ var PromiseQueue = class {
     return promise;
   }
   async join() {
-    let promises2 = Object.values(this.promiseByIds);
-    let length = promises2.length;
+    let promises3 = Object.values(this.promiseByIds);
+    let length = promises3.length;
     while (length > 0) {
-      await Promise.all(promises2);
-      promises2 = Object.values(this.promiseByIds);
-      length = promises2.length;
+      await Promise.all(promises3);
+      promises3 = Object.values(this.promiseByIds);
+      length = promises3.length;
     }
   }
   get length() {
@@ -1436,8 +1436,8 @@ function safeSetTimeout(fn, timeout) {
   return t2;
 }
 var isError = (x) => x instanceof Error;
-function allSettled(promises2) {
-  return Promise.all(promises2.map((p2) => (p2 ?? Promise.resolve()).then((value) => ({
+function allSettled(promises3) {
+  return Promise.all(promises3.map((p2) => (p2 ?? Promise.resolve()).then((value) => ({
     status: "fulfilled",
     value
   }), (reason) => ({
@@ -5397,7 +5397,7 @@ function readAnonId() {
 }
 function superProperties() {
   return {
-    cliVersion: true ? "2.47.1" : "0.0.0-dev",
+    cliVersion: true ? "2.48.0" : "0.0.0-dev",
     nodeVersion: process.version,
     platform: process.platform,
     arch: process.arch,
@@ -5578,7 +5578,7 @@ var os4 = __toESM(require("os"));
 // package.json
 var package_default = {
   name: "codeam-cli",
-  version: "2.47.1",
+  version: "2.48.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",
@@ -7817,7 +7817,16 @@ var startCommandSchema = import_zod.z.object({
       })
     ).max(32).optional(),
     notes: import_zod.z.string().max(4096).nullable().optional()
-  }).optional()
+  }).optional(),
+  // `env_write` carries the full desired set of environment variables
+  // for the project `.env`. Bounded so a malformed payload can't flood
+  // the disk-side serializer. `env_read` / `preview_restart` send no payload.
+  vars: import_zod.z.array(
+    import_zod.z.object({
+      key: import_zod.z.string().min(1).max(256),
+      value: import_zod.z.string().max(32768)
+    })
+  ).max(512).optional()
 });
 function parsePayload2(schema, raw) {
   const result = schema.safeParse(raw);
@@ -13991,6 +14000,47 @@ async function writePreviewConfig(cwd, detection) {
   await import_promises3.default.writeFile(filePath, JSON.stringify(detection, null, 2) + "\n", "utf-8");
 }
 
+// src/services/preview/dotenv.ts
+var ENV_KEY_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;
+function parseDotenv(raw) {
+  const order = [];
+  const map = /* @__PURE__ */ new Map();
+  for (const rawLine of raw.split(/\r?\n/)) {
+    const line = rawLine.trim();
+    if (line === "" || line.startsWith("#")) continue;
+    const body = line.startsWith("export ") ? line.slice("export ".length).trim() : line;
+    const eq = body.indexOf("=");
+    if (eq <= 0) continue;
+    const key = body.slice(0, eq).trim();
+    if (!ENV_KEY_RE.test(key)) continue;
+    let value = body.slice(eq + 1).trim();
+    value = unquote(value);
+    if (!map.has(key)) order.push(key);
+    map.set(key, value);
+  }
+  return order.map((key) => ({ key, value: map.get(key) }));
+}
+function unquote(value) {
+  if (value.length >= 2 && value.startsWith('"') && value.endsWith('"')) {
+    return value.slice(1, -1).replace(/\\n/g, "\n").replace(/\\"/g, '"');
+  }
+  if (value.length >= 2 && value.startsWith("'") && value.endsWith("'")) {
+    return value.slice(1, -1);
+  }
+  return value;
+}
+function serializeDotenv(vars) {
+  const lines = vars.map(({ key, value }) => `${key}=${quoteIfNeeded(value)}`);
+  return `# Managed by CodeAgent
+${lines.join("\n")}${lines.length ? "\n" : ""}`;
+}
+function quoteIfNeeded(value) {
+  if (/[\s#=]/.test(value) || value.includes("\n")) {
+    return `"${value.replace(/"/g, '\\"').replace(/\n/g, "\\n")}"`;
+  }
+  return value;
+}
+
 // src/services/preview/parser.ts
 var REQUIRED_FIELDS2 = [
   "framework",
@@ -15917,6 +15967,51 @@ var listFiles = async (ctx, cmd, parsed) => {
   const result = await listProjectFiles({ query: parsed.query });
   await ctx.relay.sendResult(cmd.id, "completed", result);
 };
+var envReadH = async (ctx, cmd) => {
+  const envPath = path40.join(process.cwd(), ".env");
+  try {
+    const raw = await fs34.promises.readFile(envPath, "utf8");
+    await ctx.relay.sendResult(cmd.id, "completed", {
+      exists: true,
+      vars: parseDotenv(raw)
+    });
+  } catch (err) {
+    if (err.code === "ENOENT") {
+      await ctx.relay.sendResult(cmd.id, "completed", { exists: false, vars: [] });
+      return;
+    }
+    await ctx.relay.sendResult(cmd.id, "failed", { error: err.message });
+  }
+};
+var envWriteH = async (ctx, cmd, parsed) => {
+  const vars = parsed.vars;
+  if (!Array.isArray(vars)) {
+    await ctx.relay.sendResult(cmd.id, "failed", { error: "Missing vars" });
+    return;
+  }
+  const seen = /* @__PURE__ */ new Set();
+  for (const v of vars) {
+    if (!ENV_KEY_RE.test(v.key)) {
+      await ctx.relay.sendResult(cmd.id, "failed", { error: `Invalid key: ${v.key}` });
+      return;
+    }
+    if (seen.has(v.key)) {
+      await ctx.relay.sendResult(cmd.id, "failed", { error: `Duplicate key: ${v.key}` });
+      return;
+    }
+    seen.add(v.key);
+  }
+  const envPath = path40.join(process.cwd(), ".env");
+  const tmpPath = path40.join(process.cwd(), ".env.codeam.tmp");
+  try {
+    await fs34.promises.writeFile(tmpPath, serializeDotenv(vars), "utf8");
+    await fs34.promises.rename(tmpPath, envPath);
+    await ctx.relay.sendResult(cmd.id, "completed", { ok: true, count: vars.length });
+  } catch (err) {
+    await fs34.promises.rm(tmpPath, { force: true }).catch(() => void 0);
+    await ctx.relay.sendResult(cmd.id, "failed", { error: err.message });
+  }
+};
 var terminalOpenH = async (ctx, cmd, parsed) => {
   const r = openTerminal({
     cols: typeof parsed.cols === "number" ? parsed.cols : void 0,
@@ -16372,8 +16467,9 @@ var previewStartH = (ctx, _cmd, parsed) => {
     log.info("preview", "start: no detection in payload");
     return;
   }
-  const detection = rawDetection;
-  const pluginAuthToken = ctx.pluginAuthToken;
+  startPreviewFromDetection(ctx, rawDetection, ctx.pluginAuthToken);
+};
+function startPreviewFromDetection(ctx, detection, pluginAuthToken) {
   const emitProgress = (step, message) => {
     void postPreviewEvent({
       sessionId: ctx.sessionId,
@@ -16791,7 +16887,8 @@ var previewStartH = (ctx, _cmd, parsed) => {
       devServer,
       tunnel,
       url,
-      framework: detection.framework
+      framework: detection.framework,
+      detection
     });
     log.info("preview", `ready: ${detection.framework} at ${url}`);
     void postPreviewEvent({
@@ -16812,7 +16909,7 @@ var previewStartH = (ctx, _cmd, parsed) => {
       payload: { stage: "spawn", message: `Preview failed to start: ${message}` }
     });
   });
-};
+}
 var previewStopH = (ctx) => {
   if (!ctx.pluginAuthToken) {
     log.info("preview", "no pluginAuthToken \u2014 skipping stop");
@@ -16831,6 +16928,21 @@ var previewStopH = (ctx) => {
     });
   })();
 };
+var previewRestartH = async (ctx, cmd) => {
+  if (!ctx.pluginAuthToken) {
+    await ctx.relay.sendResult(cmd.id, "completed", { restarted: false });
+    return;
+  }
+  const preview = activePreviews.get(ctx.sessionId);
+  if (!preview) {
+    await ctx.relay.sendResult(cmd.id, "completed", { restarted: false });
+    return;
+  }
+  await killPreview(ctx.sessionId);
+  await new Promise((r) => setTimeout(r, 150));
+  startPreviewFromDetection(ctx, preview.detection, ctx.pluginAuthToken);
+  await ctx.relay.sendResult(cmd.id, "completed", { restarted: true });
+};
 var savePreviewConfigH = (_ctx, _cmd, parsed) => {
   const detection = parsed.detection;
   if (!detection) {
@@ -16880,7 +16992,10 @@ var handlers = {
   request_preview_detect: requestPreviewDetectH,
   preview_start: previewStartH,
   preview_stop: previewStopH,
-  save_preview_config: savePreviewConfigH
+  preview_restart: previewRestartH,
+  save_preview_config: savePreviewConfigH,
+  env_read: envReadH,
+  env_write: envWriteH
 };
 async function dispatchCommand(ctx, cmd) {
   if (cmd.type === "beads_action") {
@@ -18022,7 +18137,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.47.1" : null;
+  const current = true ? "2.48.0" : null;
   if (!current) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -18039,7 +18154,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.47.1" : null;
+  const current = true ? "2.48.0" : null;
   if (!current) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -18481,7 +18596,7 @@ var defaultSpawner = (env, cwd, args2 = []) => (0, import_node_child_process14.s
   detached: false
 });
 function currentCliVersion() {
-  return true ? "2.47.1" : null;
+  return true ? "2.48.0" : null;
 }
 function runCmd(cmd, args2, timeoutMs) {
   return new Promise((resolve7) => {
@@ -29849,7 +29964,7 @@ function checkChokidar() {
 }
 async function doctor(args2 = []) {
   const json = args2.includes("--json");
-  const cliVersion = true ? "2.47.1" : "0.0.0-dev";
+  const cliVersion = true ? "2.48.0" : "0.0.0-dev";
   const apiBase2 = resolveApiBaseUrl();
   const diagnosticId = (0, import_node_crypto8.randomUUID)();
   log.info("doctor", `run id=${diagnosticId} cli=${cliVersion}`);
@@ -30048,7 +30163,7 @@ async function completion(args2) {
 // src/commands/version.ts
 var import_picocolors15 = __toESM(require("picocolors"));
 function version2() {
-  const v = true ? "2.47.1" : "unknown";
+  const v = true ? "2.48.0" : "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.47.1",
+  "version": "2.48.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",