@pome-sh/cli 0.37.0 → 0.38.0

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
   "package": "pome-sh",
-  "version": "0.37.0",
-  "git_sha": "cc0696be326889bdad4e58559dff013f090c1310",
-  "build_time": "2026-08-30T04:33:14.394Z"
+  "version": "0.38.0",
+  "git_sha": "cf682a4d73f8a19d38a0d6a934fdef5eae82bb50",
+  "build_time": "2026-08-30T04:48:25.959Z"
 }

package/dist/src/cli/main.js

@@ -12,7 +12,7 @@ import '../../chunk-5NPGY73F.js';
 import { TWIN_NAME_LIST, isTwinName, 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, HostedAuthError, HostedQuotaError } from '../../chunk-NNXVR46L.js';
+import { MOUNTED_TWINS, deriveAgentSlug, exitCodeFor, HostedUsageError, HostedOrchError } from '../../chunk-NNXVR46L.js';
 import '../../chunk-CBFKZZBR.js';
 import { TAPE_ASSERTABLE_TOOLS } from '../../chunk-C4BVTUA3.js';
 import { seedSchema } from '../../chunk-NBOQN5VX.js';
@@ -727,99 +727,6 @@ async function compileSeed(prose, opts = {}) {
     durationMs
   };
 }
-var DEFAULT_TIMEOUT_MS = 6e4;
-var responseSchema = z.object({
-  seed: z.unknown(),
-  source_hash: z.string(),
-  model: z.string(),
-  compiled_at: z.string(),
-  cached: z.boolean().optional(),
-  // Server can return usage metadata for transparency. Optional — older
-  // server versions or cache-hit responses may omit it.
-  input_tokens: z.number().int().nonnegative().optional(),
-  output_tokens: z.number().int().nonnegative().optional(),
-  cost_cents: z.number().nonnegative().optional()
-});
-var errorBodySchema = z.object({
-  error: z.object({
-    type: z.string().optional(),
-    message: z.string().optional(),
-    request_id: z.string().optional()
-  }).optional()
-});
-async function compileSeedHosted(prose, opts) {
-  const creds = await resolveCredentials({ apiBaseUrl: opts.apiBaseUrl });
-  const t0 = Date.now();
-  const controller = new AbortController();
-  const timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
-  const timer = setTimeout(() => controller.abort(), timeoutMs);
-  let res;
-  try {
-    res = await fetch(`${creds.apiBaseUrl}/v1/scenarios/compile-seed`, {
-      method: "POST",
-      headers: {
-        "content-type": "application/json",
-        "x-api-key": creds.apiKey,
-        "user-agent": "pome-cli"
-      },
-      body: JSON.stringify({
-        prose,
-        twin: opts.twin ?? "github",
-        scenario_path: opts.taskPath
-      }),
-      signal: controller.signal
-    });
-  } catch (err) {
-    throw new HostedOrchError(
-      `Could not reach the Pome control plane at ${creds.apiBaseUrl}: ${err.message}`
-    );
-  } finally {
-    clearTimeout(timer);
-  }
-  const durationMs = Date.now() - t0;
-  if (!res.ok) {
-    await throwForStatus(res);
-  }
-  let parsed;
-  try {
-    const body = await res.json();
-    parsed = responseSchema.parse(body);
-  } catch (err) {
-    throw new HostedOrchError(
-      `Control plane returned a response we could not parse: ${err.message}`
-    );
-  }
-  const seed = parseGitHubSeedState(parsed.seed);
-  return {
-    seed,
-    inputTokens: parsed.input_tokens ?? 0,
-    outputTokens: parsed.output_tokens ?? 0,
-    model: parsed.model,
-    durationMs
-  };
-}
-async function throwForStatus(res) {
-  let body = {};
-  try {
-    body = errorBodySchema.parse(await res.json());
-  } catch {
-  }
-  const detail = body.error?.message ?? `HTTP ${res.status}`;
-  const requestId = body.error?.request_id ?? res.headers.get("x-request-id") ?? void 0;
-  if (res.status === 401 || res.status === 403) {
-    throw new HostedAuthError(`Authentication failed: ${detail}`, requestId);
-  }
-  if (res.status === 402 || res.status === 429) {
-    throw new HostedQuotaError(`Quota or rate limit hit: ${detail}`, requestId);
-  }
-  if (res.status === 502) {
-    throw new HostedOrchError(
-      `Pome's hosted seed compiler hit a temporary capacity limit. Drop \`--hosted\` (or set ANTHROPIC_API_KEY then re-run \`pome compile-seeds --force\`) to compile locally via BYOK, or retry in a minute.`,
-      requestId
-    );
-  }
-  throw new HostedOrchError(`Compile-seed failed (HTTP ${res.status}): ${detail}`, requestId);
-}
 
 // src/task/seed-verifier.ts
 async function verifySeedWithTwin(seed) {
@@ -853,14 +760,15 @@ async function runCompileSeeds(target, opts) {
     const stamp = statusStamp(r.status);
     const tail = r.message ? ` \u2014 ${r.message}` : "";
     const cost = r.inputTokens !== void 0 ? ` (${r.inputTokens} in / ${r.outputTokens} out, ${r.durationMs}ms)` : "";
-    console.error(`${stamp} ${r.path}${tail}${cost}`);
+    const line = `${stamp} ${r.path}${tail}${cost}`;
+    if (r.status === "error") console.error(line);
+    else console.log(line);
   }
   const errors = results.filter((r) => r.status === "error");
   if (errors.length > 0) {
     console.error(`
 ${errors.length} error(s).`);
-    const worstHosted = errors.reduce((max, r) => Math.max(max, r.exitCode ?? 0), 0);
-    return worstHosted > 0 ? worstHosted : 1;
+    return 1;
   }
   return 0;
 }
@@ -900,7 +808,7 @@ async function compileOne(taskPath, opts) {
       message: `hand-authored seed left untouched (${sidecarPath}) \u2014 delete it or drop its _meta to recompile`
     };
   }
-  if (!opts.force && !opts.hosted && existsSync(sidecarPath)) {
+  if (!opts.force && existsSync(sidecarPath)) {
     const cached = await readSidecarMeta(sidecarPath);
     if (cached && cached.source_hash === proseHash && cached.model === COMPILER_MODEL) {
       return { path: taskPath, status: "skipped-cached", message: `up-to-date (${sidecarPath})` };
@@ -908,13 +816,12 @@ async function compileOne(taskPath, opts) {
   }
   let result;
   try {
-    result = opts.hosted ? await compileSeedHosted(seedText, { apiBaseUrl: opts.apiBaseUrl, taskPath }) : await compileSeed(seedText);
+    result = await compileSeed(seedText);
   } catch (err) {
     return {
       path: taskPath,
       status: "error",
-      message: `compile failed: ${err.message}`,
-      exitCode: opts.hosted ? exitCodeFor(err) : void 0
+      message: `compile failed: ${err.message}`
     };
   }
   try {
@@ -1222,8 +1129,13 @@ 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`.");
+    process.exitCode = 2;
+    return;
+  }
   if (!twinArg) {
-    if (opts.copy || opts.force || opts.dest) {
+    if (opts.copy) {
       console.error("Specify a twin to copy from, e.g. `pome tasks github --copy`.");
       process.exitCode = 2;
       return;
@@ -1278,11 +1190,9 @@ function printTwinTasks(twin) {
       `Copy locally: \`pome tasks ${twin.id} --copy\` (or \`--copy --dest <dir>\`).`
     )
   );
-  console.log(
-    dim2(
-      `Run one: \`pome run tasks/${runnable[0]?.filename ?? "01-bug-happy-path.md"}\`.`
-    )
-  );
+  if (runnable[0]) {
+    console.log(dim2(`Run one: \`pome run tasks/${runnable[0].filename}\`.`));
+  }
 }
 async function copyTwinTasks(twin, opts) {
   const root = resolvePackageRoot(import.meta.url);
@@ -1302,14 +1212,18 @@ async function copyTwinTasks(twin, opts) {
     destDir,
     force: opts.force
   });
+  const written = outcome.copied.length + outcome.overwritten.length;
   console.log(
     bold2(
-      `Copied ${outcome.copied.length} ${twin.label} task${outcome.copied.length === 1 ? "" : "s"} into ${opts.destDir}/.`
+      `Copied ${written} ${twin.label} task${written === 1 ? "" : "s"} into ${opts.destDir}/.`
     )
   );
   for (const file of outcome.copied) {
     console.log(`  ${dim2("+")} ${file}`);
   }
+  for (const file of outcome.overwritten) {
+    console.log(`  ${dim2("~")} ${file} ${dim2("(overwritten)")}`);
+  }
   for (const file of outcome.skipped) {
     console.log(
       `  ${dim2("-")} ${file} ${dim2("(exists \u2014 pass --force to overwrite)")}`
@@ -1325,7 +1239,7 @@ async function copyTwinTasks(twin, opts) {
     return;
   }
   console.log("");
-  const first = outcome.copied[0] ?? outcome.skipped[0];
+  const first = runnableTasks(twin)[0]?.filename;
   if (first) {
     console.log(
       dim2(`Next: \`pome run ${opts.destDir}/${first}\`.`)
@@ -1333,7 +1247,7 @@ async function copyTwinTasks(twin, opts) {
   }
 }
 async function copyTaskFiles(input) {
-  const outcome = { copied: [], skipped: [], missingSources: [] };
+  const outcome = { copied: [], overwritten: [], skipped: [], missingSources: [] };
   for (const task of input.tasks) {
     const src = join(input.sourceDir, task.filename);
     const dest = join(input.destDir, task.filename);
@@ -1341,22 +1255,24 @@ async function copyTaskFiles(input) {
       outcome.missingSources.push(task.filename);
       continue;
     }
-    if (existsSync(dest) && !input.force) {
+    const destExists = existsSync(dest);
+    if (destExists && !input.force) {
       outcome.skipped.push(task.filename);
     } else {
       await copyFile(src, dest);
-      outcome.copied.push(task.filename);
+      (destExists ? outcome.overwritten : outcome.copied).push(task.filename);
     }
     const sidecar = task.filename.replace(/\.md$/i, ".seed.json");
     const sidecarSrc = join(input.sourceDir, sidecar);
     const sidecarDest = join(input.destDir, sidecar);
     if (!existsSync(sidecarSrc)) continue;
-    if (existsSync(sidecarDest) && !input.force) {
+    const sidecarExists = existsSync(sidecarDest);
+    if (sidecarExists && !input.force) {
       outcome.skipped.push(sidecar);
       continue;
     }
     await copyFile(sidecarSrc, sidecarDest);
-    outcome.copied.push(sidecar);
+    (sidecarExists ? outcome.overwritten : outcome.copied).push(sidecar);
   }
   return outcome;
 }
@@ -3391,11 +3307,19 @@ function formatSkewRefusal(twin, findings) {
 
 // src/cli/checks-add.ts
 function parseArgFlags(pairs) {
-  const args = {};
+  const args = /* @__PURE__ */ Object.create(null);
   for (const pair2 of pairs) {
     const eq = pair2.indexOf("=");
-    if (eq <= 0) return { error: `--arg must be key=value, got ${JSON.stringify(pair2)}` };
-    args[pair2.slice(0, eq)] = pair2.slice(eq + 1);
+    if (eq <= 0) {
+      console.error(`--arg must be key=value, got ${JSON.stringify(pair2)}`);
+      return null;
+    }
+    const key = pair2.slice(0, eq);
+    if (Object.hasOwn(args, key)) {
+      console.error(`--arg ${key} given twice. Pass each parameter once.`);
+      return null;
+    }
+    args[key] = pair2.slice(eq + 1);
   }
   return args;
 }
@@ -3454,9 +3378,10 @@ async function pickInteractively(source, seams) {
   }
   return picked;
 }
-async function promptArgs(def, seams) {
-  const args = {};
+async function promptArgs(def, seams, known) {
+  const args = { ...known };
   for (const name of templateSlots(def.template).params) {
+    if (args[name] !== void 0) continue;
     const type = def.params[name];
     const valid = new RegExp(`^${type.pattern}$`);
     for (let attempt = 0; attempt < 3; attempt += 1) {
@@ -3468,7 +3393,10 @@ async function promptArgs(def, seams) {
       }
       console.error(`  not a valid ${name} \u2014 it should look like ${type.example}`);
     }
-    if (args[name] === void 0) return { error: `Gave up on \`${name}\` after three tries.` };
+    if (args[name] === void 0) {
+      console.error(`Gave up on \`${name}\` after three tries.`);
+      return null;
+    }
   }
   return args;
 }
@@ -3486,8 +3414,10 @@ async function runChecksAddCommand(file, opts) {
   if (opts.check) {
     picked = findCheck(opts.check);
     if (!picked) {
+      const twins = readConfigTwins(source);
+      const declared = twins.flatMap((twin2) => [...checksFor(twin2)]).map((c) => c.id);
       console.error(
-        `Unknown check "${opts.check}". Run \`pome checks <twin>\` to see the declared set; github declares: ${checksFor("github").map((c) => c.id).join(", ")}.`
+        `Unknown check "${opts.check}". Run \`pome checks <twin>\` to see the declared set; this task's twins (${twins.join(", ")}) declare: ${declared.join(", ") || "none"}.`
       );
       process.exitCode = 2;
       return;
@@ -3496,14 +3426,25 @@ async function runChecksAddCommand(file, opts) {
     picked = await pickInteractively(source, seams);
     if (!picked) return;
   }
-  const parsed = opts.check ? parseArgFlags(opts.arg) : await promptArgs(picked, seams);
-  if ("error" in parsed) {
-    console.error(parsed.error);
+  const fromFlags = parseArgFlags(opts.arg);
+  if (!fromFlags) {
+    process.exitCode = 2;
+    return;
+  }
+  const args = opts.check ? fromFlags : await promptArgs(picked, seams, fromFlags);
+  if (!args) {
     process.exitCode = 2;
     return;
   }
-  const args = parsed;
   const slots = templateSlots(picked.template).params;
+  const extra = Object.keys(args).filter((key) => !slots.includes(key));
+  if (extra.length > 0) {
+    console.error(
+      `${picked.id} does not declare: ${extra.map((k) => JSON.stringify(k)).join(", ")}. It takes: ${slots.join(", ")}.`
+    );
+    process.exitCode = 2;
+    return;
+  }
   for (const name of slots) {
     const type = picked.params[name];
     const value = args[name];
@@ -3520,14 +3461,6 @@ async function runChecksAddCommand(file, opts) {
       return;
     }
   }
-  const extra = Object.keys(args).filter((key) => !slots.includes(key));
-  if (extra.length > 0) {
-    console.error(
-      `${picked.id} does not declare: ${extra.join(", ")}. It takes: ${slots.join(", ")}.`
-    );
-    process.exitCode = 2;
-    return;
-  }
   const twin = twinOf(picked.id);
   const fetchRemote = opts.fetchRemote ?? (async (t) => liveFetch(
     await resolveCredentials({
@@ -4642,7 +4575,7 @@ function firstSentence(description) {
 function resolveExampleRef(env = process.env) {
   const override = env.POME_EXAMPLE_REF?.trim();
   if (override) return override;
-  const baked = "cc0696be326889bdad4e58559dff013f090c1310".trim() ;
+  const baked = "cf682a4d73f8a19d38a0d6a934fdef5eae82bb50".trim() ;
   return FULL_SHA.test(baked) ? baked : "main";
 }
 function rawUrlFor(example, file, ref) {
@@ -4996,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.37.0".length > 0) return "0.37.0";
+  if ("0.38.0".length > 0) return "0.38.0";
   try {
     const here = dirname(fileURLToPath(import.meta.url));
     const candidates = [
@@ -5213,22 +5146,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 a task's seed state to JSON").argument("[target]", "Task .md file or directory (defaults to ./tasks)").option("--force", "Recompile even if the sidecar's source hash matches", false).option(
-    "--hosted",
-    "Compile via the Pome control plane instead of calling Anthropic directly (uses your Pome API key; no ANTHROPIC_API_KEY needed)",
-    false
-  ).option(
-    "--api-url <url>",
-    "Control-plane base URL (only relevant with --hosted).",
-    process.env.POME_API_URL ?? DEFAULT_CONTROL_PLANE_URL
-  ).description(
-    "Compile prose `## Seed State` sections into sidecar .seed.json files (local: ANTHROPIC_API_KEY; --hosted: routes through Pome cloud)"
+  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(
+    "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,
-      hosted: opts.hosted,
-      apiBaseUrl: opts.apiUrl
-    });
+    const code = await runCompileSeeds(target, { force: opts.force });
     if (code !== 0) process.exitCode = code;
   });
   const register = program.command("register").summary("Register an agent with Pome").description(

package/package.json

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