@pome-sh/cli 0.45.1 → 0.46.0

package/dist/src/cli/main.js

@@ -1,18 +1,19 @@
 #!/usr/bin/env node
 import { getAvailablePort } from '../../chunk-XDU6TD4O.js';
-import { DEFAULT_CONTROL_PLANE_URL, DEFAULT_DASHBOARD_URL, clearLocalCredentials, friendlyHostedError, SESSION_TWIN_NAMES, runSessionCreate, runSessionList, runSessionStop, resolveCredentials, parseTaskFile, runTaskHosted, scoreStatus, runScoreLine, narratorReadingLines, readLatestRun, readMetaSummary, discoverRunSet, outcomeOf, persistCredentialsAfterLogin, DEFAULT_DOCS_SITE_ORIGIN, resolveSeams, readConfigTwins, resolveCachedAgentId, readLinkCache, seedStateForTwin, runAgentCommand, scoreCountsSummary, criterionRowLine, readCodeCriteria, postAgentResolver, writeLinkCache, ensurePomeGitignored, writeRunArtifactsCore, createHostedClient, redactJsonl, scoreFromFinalizeResponse, parseGitHubSeedState, uploadRunBlobs, isPreSatisfied } from '../../chunk-HEEFOMSZ.js';
-import '../../chunk-4LQ4IJOC.js';
-import { readManifest, writeManifest, MANIFEST_JSON, exitCodeFor, readRequiredManifest, HostedUsageError, HostedOrchError, normalizeManifestTwins } from '../../chunk-26UAPLHK.js';
-import { MOUNTED_TWINS, deriveAgentSlug } from '../../chunk-M7ATJ423.js';
-import '../../chunk-NW7HGA2K.js';
+import { DEFAULT_CONTROL_PLANE_URL, DEFAULT_DASHBOARD_URL, clearLocalCredentials, friendlyHostedError, SESSION_TWIN_NAMES, runSessionCreate, runSessionList, runSessionStop, resolveCredentials, parseTaskFile, runTaskHosted, scoreStatus, runScoreLine, narratorReadingLines, readLatestRun, readMetaSummary, discoverRunSet, outcomeOf, persistCredentialsAfterLogin, DEFAULT_DOCS_SITE_ORIGIN, resolveSeams, readConfigTwins, resolveCachedAgentId, readLinkCache, seedStateForTwin, runAgentCommand, scoreCountsSummary, criterionRowLine, readCodeCriteria, postAgentResolver, writeLinkCache, ensurePomeGitignored, writeRunArtifactsCore, createHostedClient, redactJsonl, scoreFromFinalizeResponse, parseGitHubSeedState, uploadRunBlobs, isPreSatisfied } from '../../chunk-J5IF4T3C.js';
+import { readManifest, writeManifest, MANIFEST_JSON, exitCodeFor, HostedAuthError, readRequiredManifest, HostedUsageError, HostedOrchError, normalizeManifestTwins } from '../../chunk-26UAPLHK.js';
 import { GMAIL_CHECKS } from '../../chunk-JM6VS62R.js';
 import '../../chunk-PASFBRK4.js';
 import { LINEAR_CHECKS } from '../../chunk-TSOSDKXP.js';
 import '../../chunk-3FZY376K.js';
 import { buildEgressAllowlist, readBlockedEgress } from '../../chunk-CBFKZZBR.js';
-import '../../chunk-DX2KCFJM.js';
-import { createRecorder, bootTwin } from '../../chunk-EZYVICDB.js';
-import { TWIN_NAME_LIST, TWIN_REGISTRY, createGitHubSmokeApp } from '../../chunk-BXYPNEJY.js';
+import { assetPath, resolvePackageRoot, openBrowser } from '../../chunk-TG6GFWA3.js';
+import '../../chunk-GTLGXFLQ.js';
+import '../../chunk-NW7HGA2K.js';
+import { createRecorder, bootTwin } from '../../chunk-QO6QJ6MN.js';
+import '../../chunk-4LQ4IJOC.js';
+import { MOUNTED_TWINS, deriveAgentSlug } from '../../chunk-M7ATJ423.js';
+import { TWIN_NAME_LIST, TWIN_REGISTRY, createGitHubSmokeApp } from '../../chunk-LDDR6XRN.js';
 import { TAPE_ASSERTABLE_TOOLS } from '../../chunk-C4BVTUA3.js';
 import { seedSchema } from '../../chunk-NBOQN5VX.js';
 import { SLACK_CHECKS } from '../../chunk-2ZGVDTJC.js';
@@ -31,7 +32,7 @@ import { fileURLToPath } from 'node:url';
 import { serve } from '@hono/node-server';
 import { randomBytes, randomUUID, createHash } from 'node:crypto';
 import { sign } from 'hono/jwt';
-import { execFile, spawn } from 'node:child_process';
+import { spawn } from 'node:child_process';
 import { createServer } from 'node:http';
 import { createInterface } from 'node:readline';
 import { z } from 'zod';
@@ -217,7 +218,7 @@ async function spawnCaptureServerChild(options) {
   });
   let stderrBuf = "";
   let resolved = false;
-  const readyPromise = new Promise((resolve7, reject) => {
+  const readyPromise = new Promise((resolve6, reject) => {
     const onData = (chunk) => {
       stderrBuf += chunk.toString("utf8");
       if (stderrBuf.length > 8192) stderrBuf = stderrBuf.slice(-8192);
@@ -225,7 +226,7 @@ async function spawnCaptureServerChild(options) {
       if (match) {
         resolved = true;
         cleanup();
-        resolve7(Number(match[1]));
+        resolve6(Number(match[1]));
       }
     };
     const onExit = (code, signal) => {
@@ -296,21 +297,21 @@ function makeShutdown(child, graceMs) {
   let done = null;
   return () => {
     if (done) return done;
-    done = new Promise((resolve7) => {
+    done = new Promise((resolve6) => {
       if (child.exitCode !== null || child.signalCode !== null) {
-        resolve7();
+        resolve6();
         return;
       }
       const onExit = () => {
         clearTimeout(killTimer);
-        resolve7();
+        resolve6();
       };
       child.once("exit", onExit);
       try {
         child.kill("SIGTERM");
       } catch {
         child.off("exit", onExit);
-        resolve7();
+        resolve6();
         return;
       }
       const killTimer = setTimeout(() => {
@@ -647,8 +648,8 @@ async function startCallbackServer(expectedState) {
   let rejectCode = null;
   let settled = false;
   let deliveredCode = false;
-  const codePromise = new Promise((resolve7, reject) => {
-    resolveCode = resolve7;
+  const codePromise = new Promise((resolve6, reject) => {
+    resolveCode = resolve6;
     rejectCode = reject;
   });
   const fail = (err) => {
@@ -692,9 +693,9 @@ async function startCallbackServer(expectedState) {
     succeed(code);
     void closeServer2(server);
   });
-  await new Promise((resolve7, reject) => {
+  await new Promise((resolve6, reject) => {
     server?.once("error", reject);
-    server?.listen(0, "127.0.0.1", resolve7);
+    server?.listen(0, "127.0.0.1", resolve6);
   });
   const address = server.address();
   if (!address || typeof address === "string") {
@@ -731,22 +732,8 @@ async function startCallbackServer(expectedState) {
   };
 }
 function closeServer2(server) {
-  return new Promise((resolve7) => {
-    server?.close(() => resolve7());
-  });
-}
-async function openBrowser(url) {
-  const command = process.platform === "darwin" ? "open" : process.platform === "win32" ? "powershell.exe" : "xdg-open";
-  const args = process.platform === "win32" ? ["-NoProfile", "-Command", "Start-Process", url] : [url];
-  await new Promise((resolve7) => {
-    execFile(command, args, (error) => {
-      if (error) {
-        console.error(
-          "Could not open a browser automatically \u2014 copy the URL above into a browser."
-        );
-      }
-      resolve7();
-    });
+  return new Promise((resolve6) => {
+    server?.close(() => resolve6());
   });
 }
 function normalizeBaseUrl(raw) {
@@ -891,7 +878,7 @@ var DOCS_TOPICS = [
   }
 ];
 
-// src/cli/docs.ts
+// src/cli/tty-color.ts
 function useColor() {
   return Boolean(process.stdout.isTTY && !process.env.NO_COLOR);
 }
@@ -901,6 +888,8 @@ function dim(s) {
 function bold(s) {
   return useColor() ? `\x1B[1m${s}\x1B[0m` : s;
 }
+
+// src/cli/docs.ts
 function wrapLine(text, width) {
   if (text.length <= width) return [text];
   const words = text.split(/\s+/);
@@ -954,7 +943,7 @@ function topicMatchesFilter(t, filter) {
   return t.id.includes(f) || t.title.toLowerCase().includes(f) || t.keywords.some((k) => k.toLowerCase().includes(f)) || t.path.toLowerCase().includes(f);
 }
 async function promptLine(rl, q) {
-  return await new Promise((resolve7) => rl.question(q, resolve7));
+  return await new Promise((resolve6) => rl.question(q, resolve6));
 }
 function printTopicUrl(topic, site) {
   console.log(`${site}${topic.path}`);
@@ -1112,7 +1101,7 @@ function extractJsonPayload(text) {
 
 // src/task/seed-verifier.ts
 async function verifySeedWithTwin(seed) {
-  const { GitHubDomain, openGitHubCloneDatabase } = await import('../../src-46YGR2WY.js');
+  const { GitHubDomain, openGitHubCloneDatabase } = await import('../../src-L54OSFDK.js');
   const db = openGitHubCloneDatabase(":memory:");
   try {
     new GitHubDomain(db).seed(seed);
@@ -1313,16 +1302,6 @@ function statusStamp(status) {
       return "FAIL";
   }
 }
-function resolvePackageRoot(importMetaUrl) {
-  let dir = dirname(fileURLToPath(importMetaUrl));
-  for (let i = 0; i < 6; i++) {
-    if (existsSync(join(dir, "package.json"))) return dir;
-    const parent = resolve(dir, "..");
-    if (parent === dir) break;
-    dir = parent;
-  }
-  return void 0;
-}
 
 // src/cli/tasks-catalog.ts
 var TASK_TWINS = [
@@ -1511,15 +1490,6 @@ function runnableTasks(twin) {
 
 // src/cli/tasks.ts
 var DEFAULT_DEST_DIR = "tasks";
-function useColor2() {
-  return Boolean(process.stdout.isTTY && !process.env.NO_COLOR);
-}
-function dim2(s) {
-  return useColor2() ? `\x1B[2m${s}\x1B[0m` : s;
-}
-function bold2(s) {
-  return useColor2() ? `\x1B[1m${s}\x1B[0m` : s;
-}
 async function runTasksCommand(twinArg, opts) {
   if (!opts.copy && (opts.force || opts.dest)) {
     console.error("`--force` and `--dest` only do anything with `--copy`.");
@@ -1554,36 +1524,36 @@ async function runTasksCommand(twinArg, opts) {
   printTwinTasks(twin);
 }
 function printTwinIndex() {
-  console.log(bold2("Pome tasks"));
-  console.log(dim2("Bundled task library, grouped by twin."));
+  console.log(bold("Pome tasks"));
+  console.log(dim("Bundled task library, grouped by twin."));
   console.log("");
   for (const twin of TASK_TWINS) {
     const count2 = runnableTasks(twin).length;
-    console.log(`  ${bold2(twin.id)} ${dim2(`(${count2} tasks)`)} \u2014 ${twin.label}`);
-    console.log(`    ${dim2(twin.description)}`);
+    console.log(`  ${bold(twin.id)} ${dim(`(${count2} tasks)`)} \u2014 ${twin.label}`);
+    console.log(`    ${dim(twin.description)}`);
   }
   console.log("");
   console.log(
-    dim2("Run `pome tasks <twin>` to list tasks, or add `--copy` to drop them into ./tasks/.")
+    dim("Run `pome tasks <twin>` to list tasks, or add `--copy` to drop them into ./tasks/.")
   );
 }
 function printTwinTasks(twin) {
   const runnable = runnableTasks(twin);
-  console.log(bold2(`Pome tasks \u2014 ${twin.label}`));
-  console.log(dim2(`${runnable.length} tasks bundled with this CLI.`));
+  console.log(bold(`Pome tasks \u2014 ${twin.label}`));
+  console.log(dim(`${runnable.length} tasks bundled with this CLI.`));
   console.log("");
   for (const task of runnable) {
-    console.log(`  ${bold2(task.filename)}`);
-    console.log(`    ${dim2(task.title)} \u2014 ${task.summary}`);
+    console.log(`  ${bold(task.filename)}`);
+    console.log(`    ${dim(task.title)} \u2014 ${task.summary}`);
   }
   console.log("");
   console.log(
-    dim2(
+    dim(
       `Copy locally: \`pome tasks ${twin.id} --copy\` (or \`--copy --dest <dir>\`).`
     )
   );
   if (runnable[0]) {
-    console.log(dim2(`Run one: \`pome run tasks/${runnable[0].filename}\`.`));
+    console.log(dim(`Run one: \`pome run tasks/${runnable[0].filename}\`.`));
   }
 }
 async function copyTwinTasks(twin, opts) {
@@ -1606,24 +1576,24 @@ async function copyTwinTasks(twin, opts) {
   });
   const written = outcome.copied.length + outcome.overwritten.length;
   console.log(
-    bold2(
+    bold(
       `Copied ${written} ${twin.label} task${written === 1 ? "" : "s"} into ${opts.destDir}/.`
     )
   );
   for (const file of outcome.copied) {
-    console.log(`  ${dim2("+")} ${file}`);
+    console.log(`  ${dim("+")} ${file}`);
   }
   for (const file of outcome.overwritten) {
-    console.log(`  ${dim2("~")} ${file} ${dim2("(overwritten)")}`);
+    console.log(`  ${dim("~")} ${file} ${dim("(overwritten)")}`);
   }
   for (const file of outcome.skipped) {
     console.log(
-      `  ${dim2("-")} ${file} ${dim2("(exists \u2014 pass --force to overwrite)")}`
+      `  ${dim("-")} ${file} ${dim("(exists \u2014 pass --force to overwrite)")}`
     );
   }
   for (const file of outcome.missingSources) {
     console.error(
-      `  ${dim2("!")} ${file} ${dim2("(missing from this package install)")}`
+      `  ${dim("!")} ${file} ${dim("(missing from this package install)")}`
     );
   }
   if (outcome.missingSources.length > 0) {
@@ -1634,7 +1604,7 @@ async function copyTwinTasks(twin, opts) {
   const first = runnableTasks(twin)[0]?.filename;
   if (first) {
     console.log(
-      dim2(`Next: \`pome run ${opts.destDir}/${first}\`.`)
+      dim(`Next: \`pome run ${opts.destDir}/${first}\`.`)
     );
   }
 }
@@ -3345,21 +3315,12 @@ var SUBSTRATE_HELP = {
   "seed+final": "the seed and the final state",
   tape: "the recorded call tape"
 };
-function useColor3() {
-  return Boolean(process.stdout.isTTY && !process.env.NO_COLOR);
-}
-function dim3(s) {
-  return useColor3() ? `\x1B[2m${s}\x1B[0m` : s;
-}
-function bold3(s) {
-  return useColor3() ? `\x1B[1m${s}\x1B[0m` : s;
-}
 function argFlagsFor(def) {
   return templateSlots(def.template).params.map((name) => `--arg ${name}=${def.params[name].example}`).join(" ");
 }
 function checksHeader(twin, count2, version) {
-  const label = bold3(`${twin} \u2014 ${count2} declared check${count2 === 1 ? "" : "s"}`);
-  return version === void 0 ? label : `${label} ${dim3(`(@pome-sh/twin-${twin} ${version})`)}`;
+  const label = bold(`${twin} \u2014 ${count2} declared check${count2 === 1 ? "" : "s"}`);
+  return version === void 0 ? label : `${label} ${dim(`(@pome-sh/twin-${twin} ${version})`)}`;
 }
 function jsonView(twin) {
   return {
@@ -3381,17 +3342,17 @@ function jsonView(twin) {
 async function runChecksCommand(twinArg, opts) {
   if (!twinArg) {
     if (opts.json) {
-      console.log(JSON.stringify({ twins: twinsWithChecks() }, null, 2));
+      console.log(JSON.stringify({ twins: twinsWithChecks().map(jsonView) }, null, 2));
       return;
     }
-    console.log(bold3("Pome checks"));
-    console.log(dim3("Twins that declare an assertable vocabulary."));
+    console.log(bold("Pome checks"));
+    console.log(dim("Twins that declare an assertable vocabulary."));
     console.log("");
     for (const twin2 of twinsWithChecks()) {
-      console.log(`  ${bold3(twin2)} ${dim3(`(${checksFor(twin2).length} checks)`)}`);
+      console.log(`  ${bold(twin2)} ${dim(`(${checksFor(twin2).length} checks)`)}`);
     }
     console.log("");
-    console.log(dim3("Run `pome checks <twin>` to list them."));
+    console.log(dim("Run `pome checks <twin>` to list them."));
     return;
   }
   const twin = twinArg.trim();
@@ -3408,23 +3369,23 @@ async function runChecksCommand(twinArg, opts) {
   }
   const checks = checksFor(twin);
   if (checks.length === 0) {
-    console.log(bold3(`${twin} \u2014 no declared checks yet`));
+    console.log(bold(`${twin} \u2014 no declared checks yet`));
     console.log(
-      dim3(`Its vocabulary has not been migrated. Use [model] criteria for ${twin} for now.`)
+      dim(`Its vocabulary has not been migrated. Use [model] criteria for ${twin} for now.`)
     );
     return;
   }
   console.log(checksHeader(twin, checks.length, pinnedVersion(`@pome-sh/twin-${twin}`)));
   console.log("");
   for (const def of checks) {
-    console.log(`  ${bold3(def.id)}`);
+    console.log(`  ${bold(def.id)}`);
     console.log(`    ${displaySentence(def)}`);
-    console.log(`    ${dim3(def.description)}`);
-    console.log(`    ${dim3(`needs: ${SUBSTRATE_HELP[def.substrate] ?? def.substrate}`)}`);
-    console.log(`    ${dim3(`pome checks add <file> --check ${def.id} ${argFlagsFor(def)}`)}`);
+    console.log(`    ${dim(def.description)}`);
+    console.log(`    ${dim(`needs: ${SUBSTRATE_HELP[def.substrate] ?? def.substrate}`)}`);
+    console.log(`    ${dim(`pome checks add <file> --check ${def.id} ${argFlagsFor(def)}`)}`);
     console.log("");
   }
-  console.log(dim3(`digest ${localDigest(twin)}`));
+  console.log(dim(`digest ${localDigest(twin)}`));
 }
 
 // src/task/insertCriterion.ts
@@ -4296,21 +4257,6 @@ async function runEvalCommand(runDirArg, opts) {
     process.exitCode = code;
   }
 }
-function assetPath(...segments) {
-  const root = resolvePackageRoot(import.meta.url);
-  if (!root) {
-    throw new Error(
-      `Could not locate the @pome-sh/cli package root (no enclosing package.json) while resolving the packaged asset ${segments.join("/")}.`
-    );
-  }
-  const candidate = join(root, "assets", ...segments);
-  if (!existsSync(candidate)) {
-    throw new Error(
-      `Packaged asset not found at ${candidate}. This is a packaging bug \u2014 \`assets/\` must be listed in cli/package.json \`files\`.`
-    );
-  }
-  return candidate;
-}
 
 // src/demo/task.ts
 var DEMO_TASK_NAME = "first-run-demo";
@@ -4872,7 +4818,7 @@ function firstSentence(description) {
 function resolveExampleRef(env = process.env) {
   const override = env.POME_EXAMPLE_REF?.trim();
   if (override) return override;
-  const baked = "f9ed48177ccfffac7020d1987e6ec9b810d7a4de".trim() ;
+  const baked = "c830c89c6055e3371f4693f49bffe96cf230e060".trim() ;
   return FULL_SHA.test(baked) ? baked : "main";
 }
 function rawUrlFor(example, file, ref) {
@@ -5372,7 +5318,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.45.1".length > 0) return "0.45.1";
+  if ("0.46.0".length > 0) return "0.46.0";
   try {
     const here = dirname(fileURLToPath(import.meta.url));
     const candidates = [
@@ -5421,16 +5367,32 @@ function createProgram() {
   ).option(
     "--seed <path>",
     "Boot from a JSON or YAML seed file instead of the default. A seed REPLACES the default; it does not merge. Takes the per-twin envelope { <twin>: { \u2026 } } or one twin's flat seed (several twins need the envelope, one entry per named twin). Overrides POME_SEED_JSON."
+  ).option(
+    "--no-dashboard",
+    "Do not serve the local dashboard. It is a read-only view of the tape on its own loopback port; this turns the port off."
+  ).option(
+    "--open",
+    "Open the dashboard in a browser once the twins are listening. Off by default: the URL is printed either way, and this command runs in CI."
+  ).option(
+    "--dashboard-port <port>",
+    "Bind the dashboard to this port instead of a free one. The twins' own ports are unaffected."
   ).description(
-    "Start one or more standalone twins as a long-lived foreground server (Ctrl-C to stop)"
-  ).action(async (names, options) => {
-    const { runTwinStartCommand } = await import('../../twinStart-XN3BYOUF.js');
-    await runTwinStartCommand(names, options);
-  });
+    // The db variables are the registry's, not this text's: naming them here
+    // is how the reader learns state is in memory by default BEFORE the boot
+    // banner says so.
+    `Start one or more standalone twins as a long-lived foreground server (Ctrl-C to stop). Each twin's state is in memory unless its own db variable names a file (${TWIN_NAME_LIST.map(
+      (twin2) => TWIN_REGISTRY[twin2].dbEnvName
+    ).join(", ")}); with one set, the twin's matching *_NO_SEED=1 serves what the file holds instead of re-seeding over it.`
+  ).action(
+    async (names, options) => {
+      const { runTwinStartCommand } = await import('../../twinStart-44W63TRH.js');
+      await runTwinStartCommand(names, options);
+    }
+  );
   twin.command("new-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.").summary("Print a new starter seed file for a twin").description(
     "Print a new starter seed file for a twin, generated from the twin's own starting state. One twin is flat, several are the per-twin envelope. Boot it with `twin start <twin> --seed`, seed a sandbox with `sandbox create --twin <twin> --seed`, or drop it beside a task as <task>.seed.json"
   ).action(async (names, options) => {
-    const { runTwinSeedCommand } = await import('../../twinSeed-ZFZO7BL7.js');
+    const { runTwinSeedCommand } = await import('../../twinSeed-LDKR3NPY.js');
     await runTwinSeedCommand(names, options);
   });
   twin.command("status").summary("Say whether the local twins are running").description(
@@ -5441,7 +5403,7 @@ function createProgram() {
       console.log("No standalone twin status found.");
       return;
     }
-    const { standaloneStatusEntries } = await import('../../twinStart-XN3BYOUF.js');
+    const { standaloneStatusEntries } = await import('../../twinStart-44W63TRH.js');
     let entries;
     try {
       entries = standaloneStatusEntries(JSON.parse(await readFile(statusPath, "utf8"))).map(
@@ -5477,13 +5439,15 @@ function createProgram() {
     `Twin name (${TWIN_NAME_LIST.join(" | ")}). Optional when one twin is recorded in .pome/twin-status.json.`
   ).option(
     "--diff",
-    "Also print the state diff since the twin booted \u2014 its seed, default or --seed \u2014 per collection: added, changed, removed.",
-    false
-  ).option("--json", "Print the tape (and the diff, with --diff) as one JSON envelope.", false).summary("Show what the agent did on a local twin").description(
+    "Also print the state diff since the twin booted \u2014 its seed, default or --seed \u2014 per collection: added, changed, removed."
+  ).option("--json", "Print the tape (and the diff, with --diff) as one JSON envelope.").summary("Show what the agent did on a local twin").description(
     "Print the running twin's tape: one line per request with status, fidelity and whether state changed, so a call that claimed success but landed nothing stands out. Reads the twin's address and token from .pome/twin-status.json; no account, no hosted call."
   ).action(async (name, options) => {
-    const { runTwinTapeCommand } = await import('../../twinTape-5P3HQ27N.js');
-    await runTwinTapeCommand(name, options);
+    const { runTwinTapeCommand } = await import('../../twinTape-433A4IC4.js');
+    await runTwinTapeCommand(name, {
+      diff: options.diff ?? false,
+      json: options.json ?? false
+    });
   });
   program.commandsGroup("Going further:");
   program.command("init").summary("Set up Pome in this project").description(
@@ -5584,8 +5548,7 @@ function createProgram() {
     "Override docs site origin (default https://docs.pome.sh)"
   ).option(
     "--url",
-    "Print the URL instead of opening the interactive topic picker.",
-    false
+    "Print the URL instead of opening the interactive topic picker."
   ).description(
     "Navigate canonical narrative docs on docs.pome.sh"
   ).action(async (topic, opts) => {
@@ -5596,12 +5559,10 @@ function createProgram() {
     "Twin id (e.g. github). Omit to list available twins."
   ).option(
     "--copy",
-    "Copy the twin's runnable tasks into the local project.",
-    false
+    "Copy the twin's runnable tasks into the local project."
   ).option(
     "--force",
-    "With --copy, overwrite existing files in the destination.",
-    false
+    "With --copy, overwrite existing files in the destination."
   ).option(
     "--dest <dir>",
     "With --copy, write into this directory instead of ./tasks/."
@@ -5610,16 +5571,16 @@ function createProgram() {
   ).action(
     async (twin2, opts) => {
       await runTasksCommand(twin2, {
-        copy: opts.copy,
-        force: opts.force,
+        copy: opts.copy ?? false,
+        force: opts.force ?? false,
         dest: opts.dest
       });
     }
   );
-  const checks = program.command("checks").summary("List, add, and lint a twin's checks").argument("[twin]", "Twin id (e.g. github). Omit to list twins that declare checks.").option("--json", "Emit the declaration as JSON (for skills and agents).", false).description(
+  const checks = program.command("checks").summary("List, add, and lint a twin's checks").argument("[twin]", "Twin id (e.g. github). Omit to list twins that declare checks.").option("--json", "Emit the declaration as JSON (for skills and agents).").description(
     "Browse the typed checks a twin declares \u2014 the closed set a [code] criterion is graded by"
   ).action(async (twin2, opts) => {
-    await runChecksCommand(twin2, { json: opts.json });
+    await runChecksCommand(twin2, { json: opts.json ?? false });
   });
   checks.command("add").argument("<file>", "Task markdown file to append a criterion to").option("--check <id>", "Check id (run `pome checks <twin>` to list them)").option(
     "--arg <key=value>",
@@ -5638,10 +5599,10 @@ function createProgram() {
   checks.command("lint").argument("<file...>", "Task markdown file(s) \u2014 shell globs work: tasks/*.md").description("Report [code] criteria that bind no declared check, so are never graded").action(async (files) => {
     await runChecksLintCommand(files);
   });
-  program.command("compile-seeds").summary("Compile prose seed state to JSON via Claude").argument("[target]", "Task .md file or directory (defaults to ./tasks)").option("--force", "Recompile even if the sidecar's source hash matches", false).description(
+  program.command("compile-seeds").summary("Compile prose seed state to JSON via Claude").argument("[target]", "Task .md file or directory (defaults to ./tasks)").option("--force", "Recompile even if the sidecar's source hash matches").description(
     "Compile prose `## Seed State` sections into sidecar .seed.json files \u2014 one Claude call per file, billed to your ANTHROPIC_API_KEY"
   ).action(async (target, opts) => {
-    const code = await runCompileSeeds(target, { force: opts.force });
+    const code = await runCompileSeeds(target, { force: opts.force ?? false });
     if (code !== 0) process.exitCode = code;
   });
   const register = program.command("register").summary("Register an agent with Pome").description(
@@ -5649,8 +5610,7 @@ function createProgram() {
   );
   register.command("agent").argument("<name>", 'Human-readable agent name (e.g. "triage-bot")').option(
     "--force",
-    "Re-resolve the agent even when .pome/link.json already links one",
-    false
+    "Re-resolve the agent even when .pome/link.json already links one"
   ).option(
     "--twins <list>",
     "Comma-separated services this agent may exercise (e.g. github,slack), unioned with the manifest's twins. Default: the manifest's twins, else the cloud's default enablement."
@@ -5663,12 +5623,12 @@ function createProgram() {
           apiBaseUrl: globals(cmd).apiUrl,
           dashboardBaseUrl: process.env.POME_DASHBOARD_URL ?? DEFAULT_DASHBOARD_URL,
           name,
-          force: opts.force,
+          force: opts.force ?? false,
           twins: normalizeRegisterTwins(opts.twins)
         });
       } catch (err) {
         console.error(friendlyHostedError(err));
-        process.exitCode = 2;
+        process.exitCode = exitCodeFor(err);
       }
     }
   );
@@ -5697,19 +5657,19 @@ function createProgram() {
   ).option(
     "--secrets-file <path>",
     "Write shell exports containing session secrets to a local file with mode 0600"
-  ).option("--json", "Print the sandbox as JSON instead of the human summary.", false).action(
+  ).option("--json", "Print the sandbox as JSON instead of the human summary.").action(
     async (opts, cmd) => {
       try {
         await runSessionCreate({
           apiBaseUrl: globals(cmd).apiUrl,
           twins: opts.twin ?? [],
-          json: opts.json,
+          json: opts.json ?? false,
           secretsFile: opts.secretsFile,
           seedPath: opts.seed
         });
       } catch (err) {
         console.error(friendlyHostedError(err));
-        process.exitCode = 2;
+        process.exitCode = exitCodeFor(err);
       }
     }
   );
@@ -5717,7 +5677,7 @@ function createProgram() {
     "--state <state>",
     "Filter by sandbox state: running, ready, done, expired, or all. `running` also matches the server-side `ready` state, the way the dashboard shows them in one column.",
     "running"
-  ).option("--json", "Print the sandboxes as JSON.", false).action(
+  ).option("--json", "Print the sandboxes as JSON.").action(
     async (opts, cmd) => {
       const validStates = [
         "running",
@@ -5738,18 +5698,17 @@ function createProgram() {
           apiBaseUrl: globals(cmd).apiUrl,
           limit: Number.parseInt(opts.limit, 10) || 20,
           state: opts.state,
-          json: opts.json
+          json: opts.json ?? false
         });
       } catch (err) {
         console.error(friendlyHostedError(err));
-        process.exitCode = 2;
+        process.exitCode = exitCodeFor(err);
       }
     }
   );
   session.command("stop").description("Stop a hosted sandbox").argument("<session-id>", "Sandbox id (ses_\u2026)").option(
     "--discard",
-    "Confirm destroying a session whose run has not been graded",
-    false
+    "Confirm destroying a session whose run has not been graded"
   ).action(
     async (sessionId, opts, cmd) => {
       try {
@@ -5859,7 +5818,7 @@ function createProgram() {
         return;
       }
       {
-        const { runDoctorChecks } = await import('../../checks-RDU56OGI.js');
+        const { runDoctorChecks } = await import('../../checks-FMIUVJ73.js');
         const { renderDoctorReport } = await import('../../render-ZQQ4UMNO.js');
         const doctorReport = await runDoctorChecks({ mode: useLocal ? "full" : "hosted" });
         if (!doctorReport.ok) {
@@ -5897,7 +5856,7 @@ function createProgram() {
               taskForRuns.config.runs
             );
             if (k > 1) {
-              const { runTrialGroup } = await import('../../runTrialGroup-MMTTTDWY.js');
+              const { runTrialGroup } = await import('../../runTrialGroup-FZWKPVI5.js');
               const fileForRerun = relative(process.cwd(), file);
               const rerunCommand = defaultTask ? options.trials !== void 0 ? `pome run -n ${k}` : "pome run" : `pome run ${fileForRerun && !fileForRerun.startsWith("..") ? fileForRerun : file} -n ${k}`;
               const groupResult = await runTrialGroup({
@@ -5943,6 +5902,14 @@ function createProgram() {
             if (result.exitCode !== 0) worstExit = result.exitCode;
           } catch (err) {
             const code = exitCodeFor(err);
+            if (err instanceof HostedAuthError) {
+              console.error(err.message);
+              console.error(
+                "Tip: `pome login` to run against Pome cloud (which returns a verdict), or `pome run --local <path>` to run a self-hosted twin and capture a trace only."
+              );
+              process.exitCode = code;
+              return;
+            }
             console.error(`ERROR ${file}`);
             console.error(`  ${err instanceof Error ? err.message : String(err)}`);
             if (code > worstExit) worstExit = code;
@@ -5979,7 +5946,7 @@ function createProgram() {
   program.command("doctor").summary("Check the agent and twin wiring").description(
     "Check the agent\u2194twin wiring: pome.json (or pome.yaml) present + valid, the local twin boots + serves, requests routed to the twin (not a hardcoded production host), egress floor active. On failure prints one named cause (file:line where knowable) + one concrete fix and exits non-zero."
   ).action(async () => {
-    const { runDoctorChecks } = await import('../../checks-RDU56OGI.js');
+    const { runDoctorChecks } = await import('../../checks-FMIUVJ73.js');
     const { renderDoctorReport } = await import('../../render-ZQQ4UMNO.js');
     const report = await runDoctorChecks();
     for (const line of renderDoctorReport(report, { passNote: true })) console.error(line);
@@ -6153,7 +6120,7 @@ function createProgram() {
       process.exitCode = 2;
       return;
     }
-    const { runCaptureServerCommand } = await import('../../run-WONFTZS3.js');
+    const { runCaptureServerCommand } = await import('../../run-CFA4LZWQ.js');
     const { parseAllowCsv } = await import('../../egress-4V6DVJZ7.js');
     await runCaptureServerCommand({
       port,

package/dist/{src-STAXYPD3.js → src-F5FHPGJP.js}

@@ -1,4 +1,4 @@
-import { routeInputDeclarer, bracketedQuery, integerInput, booleanInput, mountDeclaredRoute, UndeclaredInputError } from './chunk-IZFM7W2V.js';
+import { routeInputDeclarer, bracketedQuery, integerInput, booleanInput, mountDeclaredRoute, UndeclaredInputError } from './chunk-GBMPR32X.js';
 import { loadMcpToolFixture, openTwinDatabase, defineTwin, twinBuildInfo, deriveMcpToolTable, failureInjectionMiddleware, createApp, recordedRequestHeaders, UnknownToolError } from './chunk-TWURH7YM.js';
 import './chunk-7VZBAHQ2.js';
 import './chunk-SG6ZTIMT.js';