@pome-sh/cli 0.41.0 → 0.42.1

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
   "package": "pome-sh",
-  "version": "0.41.0",
-  "git_sha": "ea56e5f03b661023c9cea61aca95323fa0a9eada",
-  "build_time": "2026-08-30T06:26:23.470Z"
+  "version": "0.42.1",
+  "git_sha": "221b0951a0c236c1470e4d9602866726ed3592ad",
+  "build_time": "2026-08-30T07:18:38.274Z"
 }

package/dist/{chunk-KD6OUKCT.js → chunk-46POYRLY.js}

@@ -1,5 +1,5 @@
 import { createHostedClient, perTwinReturnedByCloud, parseTaskFile, runAgentCommand, writeRunArtifactsCore, toTwinHttpEvent, redactJsonl, uploadRunBlobs, scoreFromFinalizeResponse, scoreStatus, evaluationCounts } from './chunk-STMGQ7GU.js';
-import { readSeedFileText, parseSeedFileText, soleTwinOf, seedsForTwins } from './chunk-VPXIGCZW.js';
+import { readSeedFileText, parseSeedFileText, soleTwinOf, twinsNamedBy, seedsForTwins } from './chunk-VPXIGCZW.js';
 import { readManifest, normalizeManifestTwins } from './chunk-DFOQGAKS.js';
 import { MOUNTED_TWINS, HostedAuthError, HostedDiscardRefusedError, HostedQuotaError, HostedOrchError, HostedTrialError, agentResponseSchema, isMultiTwinSeedEnvelope } from './chunk-NNXVR46L.js';
 import { redactSecrets, redactEvent } from './chunk-SG6ZTIMT.js';
@@ -677,8 +677,15 @@ async function resolveSessionSeed(seedPath, requestedTwins) {
   const raw = readSeedFileText(seedPath, "pome sandbox create --seed");
   const origin = `--seed ${seedPath}`;
   const file = parseSeedFileText(raw, origin);
+  const sole = soleTwinOf(file);
+  if (requestedTwins.length === 0 && sole === void 0) {
+    const named = twinsNamedBy(file);
+    throw new Error(
+      named.length === 0 ? `${origin} is a flat seed, so it does not name a twin. Pass the name: pome sandbox create --twin <${SESSION_TWIN_NAMES.join("|")}> --seed ${seedPath}` : `${origin} names ${named.length} twins (${named.join(", ")}), so it does not say which the sandbox is for. Pass the name: ${named.map((twin) => `--twin ${twin}`).join(" ")} --seed ${seedPath}`
+    );
+  }
   const twins = normalizeSessionTwins(
-    requestedTwins.length > 0 ? requestedTwins : [soleTwinOf(file) ?? ""].filter(Boolean)
+    requestedTwins.length > 0 ? requestedTwins : [sole]
   );
   const byTwin = await seedsForTwins(file, twins, origin);
   return {

package/dist/{runTrialGroup-OGTLUB2X.js → runTrialGroup-BP446HIE.js}

@@ -1,5 +1,5 @@
 import { newGroupId } from './chunk-JNXZBK3O.js';
-import { runTaskHosted, resolveRunAgentIdentity } from './chunk-KD6OUKCT.js';
+import { runTaskHosted, resolveRunAgentIdentity } from './chunk-46POYRLY.js';
 import { createHostedClient, parseTaskFile, outcomeOf, isNarrated, criterionPhrase, narratorReadingLines } from './chunk-STMGQ7GU.js';
 import './chunk-VPXIGCZW.js';
 import './chunk-NW7HGA2K.js';

package/dist/src/cli/main.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { DEFAULT_CONTROL_PLANE_URL, DEFAULT_DASHBOARD_URL, clearLocalCredentials, friendlyHostedError, SESSION_TWIN_NAMES, runSessionCreate, runSessionList, runSessionStop, resolveCredentials, runTaskHosted, discoverRunSet, persistCredentialsAfterLogin, DEFAULT_DOCS_SITE_ORIGIN, resolveSeams, resolveCachedAgentId, readLinkCache, postAgentResolver, writeLinkCache, ensurePomeGitignored } from '../../chunk-KD6OUKCT.js';
+import { DEFAULT_CONTROL_PLANE_URL, DEFAULT_DASHBOARD_URL, clearLocalCredentials, friendlyHostedError, SESSION_TWIN_NAMES, runSessionCreate, runSessionList, runSessionStop, resolveCredentials, runTaskHosted, discoverRunSet, persistCredentialsAfterLogin, DEFAULT_DOCS_SITE_ORIGIN, resolveSeams, resolveCachedAgentId, readLinkCache, postAgentResolver, writeLinkCache, ensurePomeGitignored } from '../../chunk-46POYRLY.js';
 import { assetPath, runTask, resolvePackageRoot, DEMO_TASK_NAME, demoTaskPath } from '../../chunk-WERG4AUH.js';
 import { parseTaskFile, scoreStatus, runScoreLine, narratorReadingLines, readLatestRun, readMetaSummary, outcomeOf, readConfigTwins, scoreCountsSummary, criterionRowLine, readCodeCriteria, createHostedClient, redactJsonl, scoreFromFinalizeResponse, parseGitHubSeedState, uploadRunBlobs, isPreSatisfied } from '../../chunk-STMGQ7GU.js';
 import '../../chunk-VPXIGCZW.js';
@@ -481,6 +481,12 @@ var DOCS_TOPICS = [
     path: "/docs/twins/slack",
     keywords: ["messaging", "channels", "workspace", "slack", "exfiltration"]
   },
+  {
+    id: "linear",
+    title: "Linear twin",
+    path: "/docs/twins/linear",
+    keywords: ["projects", "cycles", "linear"]
+  },
   {
     id: "gmail",
     title: "Gmail twin",
@@ -4597,7 +4603,7 @@ function firstSentence(description) {
 function resolveExampleRef(env = process.env) {
   const override = env.POME_EXAMPLE_REF?.trim();
   if (override) return override;
-  const baked = "ea56e5f03b661023c9cea61aca95323fa0a9eada".trim() ;
+  const baked = "221b0951a0c236c1470e4d9602866726ed3592ad".trim() ;
   return FULL_SHA.test(baked) ? baked : "main";
 }
 function rawUrlFor(example, file, ref) {
@@ -4951,7 +4957,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.41.0".length > 0) return "0.41.0";
+  if ("0.42.1".length > 0) return "0.42.1";
   try {
     const here = dirname(fileURLToPath(import.meta.url));
     const candidates = [
@@ -5223,7 +5229,7 @@ function createProgram() {
     (value, previous = []) => [...previous, value]
   ).option(
     "--seed <path>",
-    "Start the sandbox from a JSON or YAML seed file instead of each twin's default. A seed REPLACES the default; it does not merge. Same file `pome twin start --seed` takes; write one with `pome twin seed <name>`."
+    "Start the sandbox from a JSON or YAML seed file instead of each twin's default. A seed REPLACES the default; it does not merge. Same file `pome twin start --seed` takes; write one with `pome twin new-seed <name>`."
   ).option(
     "--secrets-file <path>",
     "Write shell exports containing session secrets to a local file with mode 0600"
@@ -5427,7 +5433,7 @@ function createProgram() {
               taskForRuns.config.runs
             );
             if (k > 1) {
-              const { runTrialGroup } = await import('../../runTrialGroup-OGTLUB2X.js');
+              const { runTrialGroup } = await import('../../runTrialGroup-BP446HIE.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({
@@ -5706,19 +5712,16 @@ function createProgram() {
   ).description(
     "Start a standalone twin as a long-lived foreground server (Ctrl-C to stop)"
   ).action(async (name, options) => {
-    const { runTwinStartCommand } = await import('../../twinStart-N6HTOARC.js');
+    const { runTwinStartCommand } = await import('../../twinStart-QQU6OIO4.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(
-    "--for-task",
-    "Emit the shape a `<task>.seed.json` sidecar takes \u2014 flat for one twin, the per-twin envelope for more, the rule the task's `## Config` twins already set. Without it you get a seed file for `--seed`, which is always the envelope."
-  ).description(
-    "Print a starter seed file for a twin, generated from the twin's own starting state"
+  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-7M4GOIBS.js');
+    const { runTwinSeedCommand } = await import('../../twinSeed-X6VHBOLM.js');
     await runTwinSeedCommand(names, options);
   });
-  twin.command("status").summary("Print the local twin's status").description(
+  twin.command("status").summary("Say whether the local twin is running").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";

package/dist/{twinSeed-7M4GOIBS.js → twinSeed-X6VHBOLM.js}

@@ -1,7 +1,7 @@
 import { TWIN_NAMES, isTwinName, TWIN_REGISTRY } from './chunk-RPPF2KDQ.js';
 import { writeFile } from 'node:fs/promises';
 
-async function generateSeedFile(twins, opts = {}) {
+async function generateSeedFile(twins) {
   if (twins.length === 0) {
     throw new Error(`No twin specified. Pass at least one of: ${TWIN_NAMES.join(", ")}.`);
   }
@@ -19,7 +19,7 @@ async function generateSeedFile(twins, opts = {}) {
     const entry = TWIN_REGISTRY[twin];
     envelope[twin] = await entry.parseSeed(await entry.defaultSeed());
   }
-  const body = opts.forTask && twins.length === 1 ? envelope[twins[0]] : envelope;
+  const body = twins.length === 1 ? envelope[twins[0]] : envelope;
   return `${JSON.stringify(body, null, 2)}
 `;
 }
@@ -36,16 +36,21 @@ async function writeSeedFile(path, text) {
   }
 }
 async function runTwinSeedCommand(names, options = {}) {
-  const text = await generateSeedFile(names, { forTask: options.forTask });
+  const text = await generateSeedFile(names);
   if (options.out === void 0) {
     process.stdout.write(text);
     return;
   }
   await writeSeedFile(options.out, text);
-  const what = options.forTask ? "task seed" : "starting seed";
-  console.error(`Wrote ${options.out} \u2014 the ${names.join(" + ")} ${what}.`);
+  console.error(`Wrote ${options.out} \u2014 the ${names.join(" + ")} starting seed.`);
   console.error(
-    options.forTask ? `Put it next to a task whose \`## Config\` reads twins: [${names.join(", ")}], named <task>.seed.json.` : `Boot it: pome twin start ${names[0]} --seed ${options.out}`
+    `Boot ${names.length === 1 ? "it" : "one"} locally: pome twin start ${names[0]} --seed ${options.out}`
+  );
+  console.error(
+    `Hosted: pome sandbox create ${names.map((twin) => `--twin ${twin}`).join(" ")} --seed ${options.out}`
+  );
+  console.error(
+    names.length === 1 ? `As a task seed: drop it beside a ${names[0]} task as <task>.seed.json.` : `As a task seed: drop it beside a task whose \`## Config\` reads twins: [${names.join(", ")}], named <task>.seed.json.`
   );
 }
 

package/dist/{twinStart-N6HTOARC.js → twinStart-QQU6OIO4.js}

@@ -152,7 +152,7 @@ async function runTwinStartCommand(nameArg, options) {
     );
   } else {
     console.log(
-      `Seed: the ${name} twin's default (pass --seed <path>, or write one with \`pome twin seed ${name}\`).`
+      `Seed: the ${name} twin's default (pass --seed <path>, or write one with \`pome twin new-seed ${name}\`).`
     );
   }
   if (resolved.source === "persisted") {

package/package.json

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