@pome-sh/cli 0.39.0 → 0.39.1

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
   "package": "pome-sh",
-  "version": "0.39.0",
-  "git_sha": "ba0167a6952cd2e837514246b574e2bd2465ed19",
-  "build_time": "2026-08-30T05:01:31.878Z"
+  "version": "0.39.1",
+  "git_sha": "ad57e84671dd2e6a2fb0dc3b66a78d97b95ed1c7",
+  "build_time": "2026-08-30T05:08:05.900Z"
 }

package/dist/src/cli/main.js

@@ -9,7 +9,7 @@ import '../../chunk-PASFBRK4.js';
 import { LINEAR_CHECKS } from '../../chunk-TSOSDKXP.js';
 import '../../chunk-3FZY376K.js';
 import '../../chunk-5NPGY73F.js';
-import { TWIN_NAME_LIST, createGitHubSmokeApp } from '../../chunk-RPPF2KDQ.js';
+import { TWIN_NAME_LIST, TWIN_REGISTRY, createGitHubSmokeApp } from '../../chunk-RPPF2KDQ.js';
 import { readManifest, writeManifest, MANIFEST_JSON, readRequiredManifest, normalizeManifestTwins } from '../../chunk-DFOQGAKS.js';
 import '../../chunk-XDU6TD4O.js';
 import { MOUNTED_TWINS, deriveAgentSlug, exitCodeFor, HostedUsageError, HostedOrchError } from '../../chunk-NNXVR46L.js';
@@ -4575,7 +4575,7 @@ function firstSentence(description) {
 function resolveExampleRef(env = process.env) {
   const override = env.POME_EXAMPLE_REF?.trim();
   if (override) return override;
-  const baked = "ba0167a6952cd2e837514246b574e2bd2465ed19".trim() ;
+  const baked = "ad57e84671dd2e6a2fb0dc3b66a78d97b95ed1c7".trim() ;
   return FULL_SHA.test(baked) ? baked : "main";
 }
 function rawUrlFor(example, file, ref) {
@@ -4929,7 +4929,7 @@ var DEFAULT_AGENT_COMMAND = `node ${DEFAULT_AGENT_FILE}`;
 var MANIFEST_SCHEMA_URL = "https://pome.sh/schemas/v1/pome.json";
 var MAX_UNREADABLE_PATHS_SHOWN = 5;
 function readPackageVersion() {
-  if ("0.39.0".length > 0) return "0.39.0";
+  if ("0.39.1".length > 0) return "0.39.1";
   try {
     const here = dirname(fileURLToPath(import.meta.url));
     const candidates = [
@@ -5709,14 +5709,18 @@ function createProgram() {
     `Twin name (${TWIN_NAME_LIST.join(" | ")}). Optional when --seed names exactly one twin.`
   ).option(
     "--port <port>",
-    "Port to bind (default: $PORT, else GMAIL_TWIN_PORT/3336 for gmail, else 3333)"
+    // Built from the registry rather than restated: the per-twin overrides
+    // are the registry's to add, and this text went stale when linear's did.
+    `Port to bind (default: $PORT, else ${TWIN_NAME_LIST.filter(
+      (twin2) => TWIN_REGISTRY[twin2].portEnvName
+    ).map((twin2) => `${TWIN_REGISTRY[twin2].portEnvName}/${TWIN_REGISTRY[twin2].defaultPort} for ${twin2}`).join(", ")}, otherwise 3333)`
   ).option(
     "--seed <path>",
     "Boot this twin from a JSON or YAML seed file instead of its default. A seed REPLACES the default; it does not merge. Takes the per-twin envelope { <twin>: { \u2026 } } or one twin's flat seed. Overrides POME_SEED_JSON."
   ).description(
     "Start a standalone twin as a long-lived foreground server (Ctrl-C to stop)"
   ).action(async (name, options) => {
-    const { runTwinStartCommand } = await import('../../twinStart-2LICNC4D.js');
+    const { runTwinStartCommand } = await import('../../twinStart-N6HTOARC.js');
     await runTwinStartCommand(name, options);
   });
   twin.command("seed").argument("<name...>", `Twin name (${TWIN_NAME_LIST.join(" | ")}). Repeat for one file covering several.`).option("--out <path>", "Write to this file instead of stdout. Refuses to overwrite.").option(
@@ -5728,12 +5732,38 @@ function createProgram() {
     const { runTwinSeedCommand } = await import('../../twinSeed-7M4GOIBS.js');
     await runTwinSeedCommand(names, options);
   });
-  twin.command("status").description("Print standalone twin status").action(async () => {
-    if (!existsSync(".pome/twin-status.json")) {
+  twin.command("status").summary("Print the local twin's status").description(
+    "Say whether the twin `pome twin start` last booted here is still running, and print its paste-able env lines"
+  ).action(async () => {
+    const statusPath = ".pome/twin-status.json";
+    if (!existsSync(statusPath)) {
       console.log("No standalone twin status found.");
       return;
     }
-    console.log(await import('node:fs/promises').then((fs) => fs.readFile(".pome/twin-status.json", "utf8")));
+    let status;
+    let origin;
+    try {
+      status = JSON.parse(await readFile(statusPath, "utf8"));
+      if (typeof status.name !== "string" || status.name === "") throw new Error("no name");
+      origin = new URL(status.rest_url).origin;
+    } catch {
+      throw new Error(
+        `pome twin status: ${statusPath} is unreadable \u2014 start a twin with \`pome twin start <${TWIN_NAME_LIST.join("|")}>\`.`
+      );
+    }
+    const running = await fetch(`${origin}/healthz`, {
+      signal: AbortSignal.timeout(1e3)
+    }).then(
+      async (res) => res.ok && (await res.json().catch(() => ({}))).twin === status.name,
+      () => false
+    );
+    console.log(
+      running ? `${status.name} twin \u2014 running` : `${status.name} twin \u2014 not running (stale ${statusPath})`
+    );
+    const envName = TWIN_REGISTRY[status.name]?.envName ?? status.name.toUpperCase();
+    console.log(`POME_${envName}_REST_URL=${status.rest_url}`);
+    console.log(`POME_${envName}_MCP_URL=${status.mcp_url}`);
+    console.log(`POME_AUTH_TOKEN=${status.auth_token}`);
   });
   program.command("capture-server").summary("Record the agent's model calls").description(
     "Boot an HTTP CONNECT-tunnel proxy that appends one LlmCallEvent per tunnel to events.jsonl. Spawned by `pome run`; agent traffic flows via HTTPS_PROXY."

package/dist/{twinStart-2LICNC4D.js → twinStart-N6HTOARC.js}

@@ -114,6 +114,21 @@ async function runTwinStartCommand(nameArg, options) {
   const mcpUrl = `${restUrl}/mcp`;
   const server = serve({ fetch: harness.app.fetch, port, hostname: "127.0.0.1" });
   try {
+    await new Promise((resolve, reject) => {
+      const onError = (err) => {
+        reject(
+          err.code === "EADDRINUSE" ? new Error(
+            `pome twin start: port ${port} is already in use \u2014 pass --port <port>, or stop the twin using it.`
+          ) : err
+        );
+      };
+      server.once("error", onError);
+      server.once("listening", () => {
+        server.off("error", onError);
+        server.on("error", (err) => console.error(`pome twin start: server error: ${err}`));
+        resolve();
+      });
+    });
     await mkdir(".pome", { recursive: true });
     await writeFile(
       ".pome/twin-status.json",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pome-sh/cli",
-  "version": "0.39.0",
+  "version": "0.39.1",
   "description": "Test AI agents against digital twins of real SaaS APIs. Records tool-call traces and scores them on pome.sh.",
   "keywords": [
     "ai",