@pome-sh/cli 0.38.0 → 0.39.1

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
   "package": "pome-sh",
-  "version": "0.38.0",
-  "git_sha": "cf682a4d73f8a19d38a0d6a934fdef5eae82bb50",
-  "build_time": "2026-08-30T04:48:25.959Z"
+  "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, isTwinName, 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';
@@ -26,7 +26,7 @@ import '../../chunk-2K6BJ3PI.js';
 import '../../chunk-FBSA5L36.js';
 import { Command } from 'commander';
 import { existsSync, readFileSync, realpathSync, statSync, constants } from 'node:fs';
-import { mkdir, readFile, rm, writeFile, readdir, copyFile, stat, cp } from 'node:fs/promises';
+import { mkdir, readFile, writeFile, readdir, copyFile, stat, cp } from 'node:fs/promises';
 import { dirname, resolve, join, basename, relative, extname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { execFile } from 'node:child_process';
@@ -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 = "cf682a4d73f8a19d38a0d6a934fdef5eae82bb50".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.38.0".length > 0) return "0.38.0";
+  if ("0.39.1".length > 0) return "0.39.1";
   try {
     const here = dirname(fileURLToPath(import.meta.url));
     const candidates = [
@@ -5703,20 +5703,24 @@ function createProgram() {
       })
     );
   });
-  const twin = program.command("twin").summary("Run a twin on this machine").description("Start and reset a twin on this machine, print its status or a starter seed file");
+  const twin = program.command("twin").summary("Run a twin on this machine").description("Start a twin on this machine, print its status or a starter seed file");
   twin.command("start").argument(
     "[name]",
     `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,36 +5732,38 @@ function createProgram() {
     const { runTwinSeedCommand } = await import('../../twinSeed-7M4GOIBS.js');
     await runTwinSeedCommand(names, options);
   });
-  twin.command("reset").argument("[name]", "Twin name", "github").summary("Reset a twin's saved state").description(
-    "Delete the twin's database under `.pome/` or `.pome-data/`, and `.pome/twin-status.json`, the one file `pome twin status` reads for every twin. A twin holding its state in memory has nothing to delete."
-  ).action(async (name) => {
-    if (!isTwinName(name)) {
-      throw new Error(`Unknown twin '${name}'. Supported: ${TWIN_NAME_LIST.join(", ")}.`);
-    }
-    const dbPaths = name === "gmail" ? [".pome/gmail.db", ".pome-data/gmail/gmail.db"] : [`.pome/${name}.db`, `.pome-data/${name}/${name}.db`];
-    for (const dbPath of dbPaths) {
-      await rm(dbPath, { force: true });
-      await rm(`${dbPath}-wal`, { force: true });
-      await rm(`${dbPath}-shm`, { force: true });
-    }
-    await rm(".pome/twin-status.json", { force: true });
-    console.log(`Standalone ${name} twin state reset.`);
-  });
-  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")));
-  });
-  program.command("endpoints").summary("List a twin's endpoints").argument("<name>", "Twin name").description("List the endpoints the github or gmail twin serves").action((name) => {
-    const endpoints = name === "github" ? SUPPORTED_GITHUB_ENDPOINTS : name === "gmail" ? SUPPORTED_GMAIL_ENDPOINTS : null;
-    if (!endpoints) {
-      throw new Error("Endpoint listing is available for: github, gmail.");
-    }
-    for (const endpoint of endpoints) {
-      console.log(`${endpoint}  semantic`);
+    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."
@@ -5798,43 +5804,6 @@ function createProgram() {
   });
   return program;
 }
-var SUPPORTED_GITHUB_ENDPOINTS = [
-  "GET /repos/:owner/:repo",
-  "GET /repos/:owner/:repo/issues",
-  "GET /repos/:owner/:repo/issues/:number",
-  "PATCH /repos/:owner/:repo/issues/:number",
-  "POST /repos/:owner/:repo/issues/:number/comments",
-  "GET /repos/:owner/:repo/labels",
-  "POST /repos/:owner/:repo/labels",
-  "GET /repos/:owner/:repo/issues/:number/labels",
-  "POST /repos/:owner/:repo/issues/:number/labels",
-  "DELETE /repos/:owner/:repo/issues/:number/labels/:name",
-  "GET /repos/:owner/:repo/collaborators",
-  "POST /repos/:owner/:repo/issues/:number/assignees"
-];
-var SUPPORTED_GMAIL_ENDPOINTS = [
-  "GET /gmail/v1/users/:userId/profile",
-  "GET|POST /gmail/v1/users/:userId/messages",
-  "GET|DELETE /gmail/v1/users/:userId/messages/:id",
-  "POST /gmail/v1/users/:userId/messages/{send,import,batchModify,batchDelete}",
-  "POST /gmail/v1/users/:userId/messages/:id/{modify,trash,untrash}",
-  "GET /gmail/v1/users/:userId/messages/:messageId/attachments/:id",
-  "GET|POST /gmail/v1/users/:userId/drafts",
-  "GET|PUT|DELETE /gmail/v1/users/:userId/drafts/:id",
-  "POST /gmail/v1/users/:userId/drafts/send",
-  "GET /gmail/v1/users/:userId/threads",
-  "GET|DELETE /gmail/v1/users/:userId/threads/:id",
-  "POST /gmail/v1/users/:userId/threads/:id/{modify,trash,untrash}",
-  "GET|POST /gmail/v1/users/:userId/labels",
-  "GET|PUT|PATCH|DELETE /gmail/v1/users/:userId/labels/:id",
-  "GET /gmail/v1/users/:userId/history",
-  "GET|POST /gmail/v1/users/:userId/settings/filters",
-  "GET|DELETE /gmail/v1/users/:userId/settings/filters/:id",
-  "GET /gmail/v1/users/:userId/settings/{forwardingAddresses,sendAs}",
-  "GET /gmail/v1/users/:userId/settings/forwardingAddresses/:email",
-  "GET /gmail/v1/users/:userId/settings/sendAs/:email",
-  "POST /upload/gmail/v1/users/:userId/{messages,drafts} (media|multipart)"
-];
 async function taskFiles(target) {
   const resolved = resolve(target);
   if (!existsSync(resolved)) {

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.38.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",