@pome-sh/cli 0.32.0 → 0.33.1

package/README.md

@@ -11,7 +11,7 @@ prints it to the terminal and records it to the dashboard, and
 
 **📚 Full documentation lives at [docs.pome.sh](https://docs.pome.sh).**
 Run `pome --help` (or `pome help <command>`) for the CLI reference, and
-`pome docs getting-started` to open the canonical quickstart.
+`pome docs getting-started` to print the quickstart's URL.
 
 ## Install
 
@@ -40,7 +40,7 @@ local/OSS package release.
 
 ```bash
 pome login                       # one-time; opens the dashboard to sign in
-pome init                        # scaffolds tasks/, examples/agents/, runs/, pome.config.json
+pome init                        # scaffolds tasks/, examples/agents/, runs/, pome.json
 pome register agent my-agent     # scopes runs to this project
 pome run tasks/01-bug-happy-path.md --agent "node examples/agents/scripted-triage-agent.ts"
 pome inspect latest              # trace/audit view of the last run
@@ -49,7 +49,7 @@ pome inspect latest              # trace/audit view of the last run
 To capture a trace without the cloud (self-host), then get a verdict later:
 
 ```bash
-pome run --local tasks/01-bug-happy-path.md   # captures a raw trace only — no verdict
+pome run --local tasks/01-bug-happy-path.md   # captures a raw trace only, no verdict
 pome eval runs/01-bug-happy-path/<run-id>         # uploads it for a cloud verdict
 ```
 

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
   "package": "pome-sh",
-  "version": "0.32.0",
-  "git_sha": "816bd6d21eb0380e78441fd7f8e419ccb9f86ba0",
-  "build_time": "2026-08-27T11:54:47.200Z"
+  "version": "0.33.1",
+  "git_sha": "15d61b80f3fb2ee0df893ca81c0c9e4d0afd0076",
+  "build_time": "2026-08-28T11:26:59.938Z"
 }

package/dist/{checks-KGDGQ35O.js → checks-CAP2CSEW.js}

@@ -183,7 +183,7 @@ async function checkTwinReachable(_configDir) {
   });
   let harness;
   try {
-    const { bootTwin } = await import('./twinHarness-TSAQYDC5.js');
+    const { bootTwin } = await import('./twinHarness-2OFWSVPK.js');
     harness = await bootTwin({
       twin: "github",
       seedState: void 0,

package/dist/{chunk-BK42YBOX.js → chunk-A2VNLUP7.js}

@@ -1,5 +1,5 @@
-import { createHostedClient, perTwinReturnedByCloud, parseTaskFile, runAgentCommand, writeRunArtifactsCore, toTwinHttpEvent, redactJsonl, uploadRunBlobs, scoreFromFinalizeResponse, scoreStatus, evaluationCounts } from './chunk-KNULR6S4.js';
-import { readSeedFileText, parseSeedFileText, soleTwinOf, seedsForTwins } from './chunk-IHKUFGYW.js';
+import { createHostedClient, perTwinReturnedByCloud, parseTaskFile, runAgentCommand, writeRunArtifactsCore, toTwinHttpEvent, redactJsonl, uploadRunBlobs, scoreFromFinalizeResponse, scoreStatus, evaluationCounts } from './chunk-YJ5PASVX.js';
+import { readSeedFileText, parseSeedFileText, soleTwinOf, seedsForTwins } from './chunk-DWOCTCSE.js';
 import { readManifest, normalizeManifestTwins } from './chunk-2V5A7NWP.js';
 import { MOUNTED_TWINS, HostedAuthError, HostedDiscardRefusedError, HostedQuotaError, HostedOrchError, HostedTrialError, agentResponseSchema, isMultiTwinSeedEnvelope } from './chunk-72CG3JNL.js';
 import { redactSecrets, redactEvent } from './chunk-SG6ZTIMT.js';

package/dist/{chunk-SDBBGCE7.js → chunk-CNG6DQWX.js}

@@ -39,7 +39,7 @@ var TWIN_REGISTRY = {
         defaultSeedState,
         GitHubDomain,
         openGitHubCloneDatabase
-      } = await import('./src-56Y2R7ZQ.js');
+      } = await import('./src-DO3BEABU.js');
       const db = openGitHubCloneDatabase();
       const domain = new GitHubDomain(db);
       domain.seed(seedState === void 0 ? defaultSeedState() : seedState);
@@ -63,7 +63,7 @@ var TWIN_REGISTRY = {
     parseSeed: async (input) => (await import('./seed-IIMBJHAJ.js')).parseSeed(input),
     seedFields: async () => Object.keys((await import('./seed-IIMBJHAJ.js')).seedSchema.shape),
     async boot({ seedState, runId, recorder }) {
-      const { createSlackTwinApp, openSlackTwinDatabase, SlackDomain } = await import('./src-SKCWAMVQ.js');
+      const { createSlackTwinApp, openSlackTwinDatabase, SlackDomain } = await import('./src-ANO374BX.js');
       const db = openSlackTwinDatabase(":memory:");
       const domain = new SlackDomain(db);
       domain.applySeed(seedState);
@@ -90,8 +90,8 @@ var TWIN_REGISTRY = {
     parseSeed: async (input) => (await import('./seed-YWDTT2WL.js')).parseSeed(input),
     seedFields: async () => Object.keys((await import('./seed-YWDTT2WL.js')).seedSchema.shape),
     async boot({ seedState, runId, recorder, twinBaseUrl }) {
-      const stripeTwin = await import('./src-PW7U25ZX.js');
-      const { createApp } = await import('./server-DMLORMOV.js');
+      const stripeTwin = await import('./src-AMLUIPYO.js');
+      const { createApp } = await import('./server-FBKFPGR4.js');
       const {
         applySeed: applyStripeSeed,
         createTwinStripeApp,
@@ -136,7 +136,7 @@ var TWIN_REGISTRY = {
     parseSeed: async (input) => (await import('./seed-NR6RUKXV.js')).parseSeed(input),
     seedFields: async () => Object.keys((await import('./seed-NR6RUKXV.js')).gmailSeedSchema.shape),
     async boot({ seedState, runId, recorder }) {
-      const { createGmailTwinApp, GmailDomain, openGmailTwinDatabase, parseSeed } = await import('./src-KSLAF3I4.js');
+      const { createGmailTwinApp, GmailDomain, openGmailTwinDatabase, parseSeed } = await import('./src-YGMRIKFV.js');
       const db = openGmailTwinDatabase(":memory:");
       const seed = parseSeed(seedState);
       const domain = new GmailDomain(db);
@@ -165,7 +165,7 @@ var TWIN_REGISTRY = {
         LinearDomain,
         openLinearTwinDatabase,
         parseSeed
-      } = await import('./src-FK536BIR.js');
+      } = await import('./src-5SOF4PDV.js');
       const db = openLinearTwinDatabase(":memory:");
       const seed = parseSeed(seedState);
       const domain = new LinearDomain(db);
@@ -181,7 +181,7 @@ var TWIN_REGISTRY = {
   }
 };
 async function createGitHubSmokeApp() {
-  const { createGitHubCloneApp } = await import('./src-56Y2R7ZQ.js');
+  const { createGitHubCloneApp } = await import('./src-DO3BEABU.js');
   return createGitHubCloneApp();
 }
 function defaultPortFor(twin, env = process.env) {

package/dist/{chunk-IHKUFGYW.js → chunk-DWOCTCSE.js}

@@ -1,4 +1,4 @@
-import { isTwinName, TWIN_REGISTRY, TWIN_NAMES } from './chunk-SDBBGCE7.js';
+import { isTwinName, TWIN_REGISTRY, TWIN_NAMES } from './chunk-CNG6DQWX.js';
 import { readFileSync } from 'node:fs';
 import { parse } from 'yaml';
 

package/dist/{chunk-KIADZ7UM.js → chunk-PNR7OHDC.js}

@@ -1,5 +1,5 @@
-import { parseTaskFile, seedStateForTwin, runAgentCommand, writeRunArtifactsCore } from './chunk-KNULR6S4.js';
-import { createRecorder, bootTwin } from './chunk-WJFRBXL5.js';
+import { parseTaskFile, seedStateForTwin, runAgentCommand, writeRunArtifactsCore } from './chunk-YJ5PASVX.js';
+import { createRecorder, bootTwin } from './chunk-T73VMABH.js';
 import { getAvailablePort } from './chunk-XDU6TD4O.js';
 import { buildEgressAllowlist, readBlockedEgress } from './chunk-CBFKZZBR.js';
 import { eventSchema } from './chunk-6KJC4BTO.js';

package/dist/{chunk-WJFRBXL5.js → chunk-T73VMABH.js}

@@ -1,5 +1,5 @@
-import { TWIN_NAMES, isTwinName, TWIN_REGISTRY } from './chunk-SDBBGCE7.js';
-import { createFileBackedRecorderStore, createRecorderStore } from './chunk-E665XWYU.js';
+import { TWIN_NAMES, isTwinName, TWIN_REGISTRY } from './chunk-CNG6DQWX.js';
+import { createFileBackedRecorderStore, createRecorderStore } from './chunk-VOHTQV4J.js';
 
 // src/recorder/recorder.ts
 function createRecorder(options = {}) {

package/dist/{chunk-E665XWYU.js → chunk-VOHTQV4J.js}

@@ -418,10 +418,6 @@ var twinMeta = z.object({
   healthz: z.custom(isFunction).optional(),
   bodyReader: z.custom(isFunction).optional(),
   middleware: z.custom(isFunction).optional(),
-  legacyMcp: z.object({
-    aliases: z.boolean().optional(),
-    missingTool: z.custom(isFunction).optional()
-  }).optional(),
   pomeHealth: z.custom(isFunction).optional(),
   unsupported: z.custom(isFunction).optional(),
   pomeRoutes: z.record(z.string(), z.custom(isFunction)).optional(),
@@ -1610,25 +1606,7 @@ function createApp(definition, options = {}) {
   }));
   session.post("/mcp/call", recorder.handle({ mutation: false }, async (c) => {
     const raw = await readBody(c);
-    let call;
-    if (definition.legacyMcp?.aliases) {
-      const rec = raw && typeof raw === "object" && !Array.isArray(raw) ? raw : {};
-      const name = rec.tool ?? rec.name;
-      if (typeof name !== "string" || name.length === 0) {
-        const missing = definition.legacyMcp.missingTool;
-        if (missing) {
-          const envelope = missing();
-          return { status: envelope.status, body: envelope.body };
-        }
-        z.object({ tool: z.string().min(1) }).parse(rec);
-      }
-      call = {
-        tool: name,
-        arguments: rec.arguments ?? rec.params ?? {}
-      };
-    } else {
-      call = z.object({ tool: z.string().min(1), arguments: jsonRecord.default({}) }).parse(raw);
-    }
+    const call = z.object({ tool: z.string().min(1), arguments: jsonRecord.default({}) }).parse(raw);
     setRecordedTool(c, call.tool);
     const tool = findTool(definition, call.tool);
     const parsed = tool.schema.parse(call.arguments);

package/dist/{chunk-KNULR6S4.js → chunk-YJ5PASVX.js}

@@ -1,9 +1,9 @@
 import { gmailSeedSchema, defaultSeedState } from './chunk-3T5XN64P.js';
 import { linearSeedSchema, defaultSeedState as defaultSeedState$1 } from './chunk-Q5NBPR57.js';
-import { isTwinName, TWIN_REGISTRY } from './chunk-SDBBGCE7.js';
+import { isTwinName, TWIN_REGISTRY } from './chunk-CNG6DQWX.js';
 import { criterionSchema, normalizeTaskConfigKeys, finalizeResponseSchema, HostedDiscardRefusedError, HostedOrchError, HostedAuthError, HostedQuotaError, submitResultResponseSchema, createEvalSessionResponseSchema, createSessionResponseSchema, sessionPublicSchema } from './chunk-72CG3JNL.js';
 import { seedSchema, parseSeed, defaultSeedState as defaultSeedState$2 } from './chunk-HJX25USP.js';
-import { toTwinHttpEventRow } from './chunk-E665XWYU.js';
+import { toTwinHttpEventRow } from './chunk-VOHTQV4J.js';
 import { redactEvent, redactSecrets } from './chunk-SG6ZTIMT.js';
 import { mkdir, appendFile, writeFile, readFile } from 'node:fs/promises';
 import { existsSync } from 'node:fs';

package/dist/{runDemo-3JEAM6CM.js → runDemo-6WD2RSIH.js}

@@ -1,17 +1,17 @@
 import { newGroupId, reassuranceBox, twinReadyLine, trialsHeaderLine, trialLine, summaryLines, evaluatingLine, criterionPhrase } from './chunk-RGZBC7NF.js';
 import { DemoCapacityError, capacityLabel, parseCapacityMarker, capacityKindFrom } from './chunk-ZX4WNSZ5.js';
-import { runTask, demoTaskPath, DEMO_TASK_NAME, DEMO_REPO } from './chunk-KIADZ7UM.js';
-import { createHostedClient, parseTaskFile, uploadRunBlobs, scoreFromFinalizeResponse, scoreStatus, outcomeOf } from './chunk-KNULR6S4.js';
+import { runTask, demoTaskPath, DEMO_TASK_NAME, DEMO_REPO } from './chunk-PNR7OHDC.js';
+import { createHostedClient, parseTaskFile, uploadRunBlobs, scoreFromFinalizeResponse, scoreStatus, outcomeOf } from './chunk-YJ5PASVX.js';
 import './chunk-NW7HGA2K.js';
 import './chunk-3T5XN64P.js';
 import './chunk-Q5NBPR57.js';
-import { bootTwin } from './chunk-WJFRBXL5.js';
-import './chunk-SDBBGCE7.js';
+import { bootTwin } from './chunk-T73VMABH.js';
+import './chunk-CNG6DQWX.js';
 import { getAvailablePort } from './chunk-XDU6TD4O.js';
 import { HostedQuotaError, HostedOrchError } from './chunk-72CG3JNL.js';
 import './chunk-CBFKZZBR.js';
 import './chunk-HJX25USP.js';
-import './chunk-E665XWYU.js';
+import './chunk-VOHTQV4J.js';
 import './chunk-6KJC4BTO.js';
 import './chunk-SG6ZTIMT.js';
 import './chunk-CF6EIU2U.js';

package/dist/{runTrialGroup-W7C4Z5DN.js → runTrialGroup-UBN46ZEJ.js}

@@ -1,15 +1,15 @@
 import { newGroupId, criterionPhrase } from './chunk-RGZBC7NF.js';
-import { runTaskHosted, resolveRunAgentIdentity } from './chunk-BK42YBOX.js';
-import { createHostedClient, parseTaskFile, outcomeOf } from './chunk-KNULR6S4.js';
-import './chunk-IHKUFGYW.js';
+import { runTaskHosted, resolveRunAgentIdentity } from './chunk-A2VNLUP7.js';
+import { createHostedClient, parseTaskFile, outcomeOf } from './chunk-YJ5PASVX.js';
+import './chunk-DWOCTCSE.js';
 import './chunk-NW7HGA2K.js';
 import './chunk-3T5XN64P.js';
 import './chunk-Q5NBPR57.js';
-import './chunk-SDBBGCE7.js';
+import './chunk-CNG6DQWX.js';
 import './chunk-2V5A7NWP.js';
 import { HostedQuotaError, HostedTrialError } from './chunk-72CG3JNL.js';
 import './chunk-HJX25USP.js';
-import './chunk-E665XWYU.js';
+import './chunk-VOHTQV4J.js';
 import './chunk-6KJC4BTO.js';
 import './chunk-SG6ZTIMT.js';
 import './chunk-CF6EIU2U.js';

package/dist/{server-DMLORMOV.js → server-FBKFPGR4.js}

@@ -1,4 +1,4 @@
-export { POME_RECORDER_EVENTS_PATH, PROVIDER_SHAPED_TEAM_ID, TwinBootError, TwinError, UnknownToolError, bearerAuth, createAdminGate, createApp, createFileBackedRecorderStore, createRecorderHandle, createRecorderStore, created, ensureTwinAuthSecret, failureInjectionMiddleware, formTokenResolver, isLoopbackHost, mintProviderToken, ok, queryTokenResolver, recordedRequestHeaders, requireAdminAuth, resolveAuthSecret, resolveRecorderStore, serve, setClientIp, setRecordedTool, toTwinHttpEventRow, twinBuildInfo, verifyProviderToken } from './chunk-E665XWYU.js';
+export { POME_RECORDER_EVENTS_PATH, PROVIDER_SHAPED_TEAM_ID, TwinBootError, TwinError, UnknownToolError, bearerAuth, createAdminGate, createApp, createFileBackedRecorderStore, createRecorderHandle, createRecorderStore, created, ensureTwinAuthSecret, failureInjectionMiddleware, formTokenResolver, isLoopbackHost, mintProviderToken, ok, queryTokenResolver, recordedRequestHeaders, requireAdminAuth, resolveAuthSecret, resolveRecorderStore, serve, setClientIp, setRecordedTool, toTwinHttpEventRow, twinBuildInfo, verifyProviderToken } from './chunk-VOHTQV4J.js';
 import './chunk-6KJC4BTO.js';
 export { redactEvent, redactSecrets } from './chunk-SG6ZTIMT.js';
 export { FAILURE_INJECTION_OVERRIDE_KEY, createFailureInjectionStore, failureInjectionRuleSchema } from './chunk-CF6EIU2U.js';

package/dist/src/cli/main.js

@@ -1,15 +1,15 @@
 #!/usr/bin/env node
-import { DEFAULT_CONTROL_PLANE_URL, DEFAULT_DASHBOARD_URL, clearLocalCredentials, friendlyHostedError, SESSION_TWIN_NAMES, runSessionCreate, runSessionList, runSessionStop, resolveCredentials, runTaskHosted, discoverRunSet, VERDICT_ARTIFACT_VERSION, persistCredentialsAfterLogin, DEFAULT_DOCS_SITE_ORIGIN, resolveSeams, resolveCachedAgentId, readLinkCache, postAgentResolver, writeLinkCache, ensurePomeGitignored } from '../../chunk-BK42YBOX.js';
-import { assetPath, runTask, resolvePackageRoot, DEMO_TASK_NAME, demoTaskPath } from '../../chunk-KIADZ7UM.js';
-import { parseTaskFile, scoreStatus, runScoreLine, readLatestRun, readMetaSummary, outcomeOf, readConfigTwins, scoreCountsSummary, markerFor, criterionMarkerLabel, twinSkipSuffix, readCodeCriteria, createHostedClient, toTwinHttpEvent, redactJsonl, scoreFromFinalizeResponse, parseGitHubSeedState, uploadRunBlobs, isPreSatisfied } from '../../chunk-KNULR6S4.js';
-import '../../chunk-IHKUFGYW.js';
+import { DEFAULT_CONTROL_PLANE_URL, DEFAULT_DASHBOARD_URL, clearLocalCredentials, friendlyHostedError, SESSION_TWIN_NAMES, runSessionCreate, runSessionList, runSessionStop, resolveCredentials, runTaskHosted, discoverRunSet, VERDICT_ARTIFACT_VERSION, persistCredentialsAfterLogin, DEFAULT_DOCS_SITE_ORIGIN, resolveSeams, resolveCachedAgentId, readLinkCache, postAgentResolver, writeLinkCache, ensurePomeGitignored } from '../../chunk-A2VNLUP7.js';
+import { assetPath, runTask, resolvePackageRoot, DEMO_TASK_NAME, demoTaskPath } from '../../chunk-PNR7OHDC.js';
+import { parseTaskFile, scoreStatus, runScoreLine, readLatestRun, readMetaSummary, outcomeOf, readConfigTwins, scoreCountsSummary, markerFor, criterionMarkerLabel, twinSkipSuffix, readCodeCriteria, createHostedClient, toTwinHttpEvent, redactJsonl, scoreFromFinalizeResponse, parseGitHubSeedState, uploadRunBlobs, isPreSatisfied } from '../../chunk-YJ5PASVX.js';
+import '../../chunk-DWOCTCSE.js';
 import '../../chunk-NW7HGA2K.js';
 import { GMAIL_CHECKS } from '../../chunk-JM6VS62R.js';
 import '../../chunk-3T5XN64P.js';
 import { LINEAR_CHECKS } from '../../chunk-TSOSDKXP.js';
 import '../../chunk-Q5NBPR57.js';
-import '../../chunk-WJFRBXL5.js';
-import { TWIN_NAME_LIST, isTwinName, createGitHubSmokeApp } from '../../chunk-SDBBGCE7.js';
+import '../../chunk-T73VMABH.js';
+import { TWIN_NAME_LIST, isTwinName, createGitHubSmokeApp } from '../../chunk-CNG6DQWX.js';
 import { readManifest, writeManifest, MANIFEST_JSON, readRequiredManifest, normalizeManifestTwins } from '../../chunk-2V5A7NWP.js';
 import '../../chunk-XDU6TD4O.js';
 import { MOUNTED_TWINS, deriveAgentSlug, exitCodeFor, HostedUsageError, HostedOrchError, HostedAuthError, HostedQuotaError } from '../../chunk-72CG3JNL.js';
@@ -18,7 +18,7 @@ import { TAPE_ASSERTABLE_TOOLS } from '../../chunk-C4BVTUA3.js';
 import { seedSchema } from '../../chunk-HJX25USP.js';
 import { SLACK_CHECKS } from '../../chunk-2ZGVDTJC.js';
 import { oneOf, defineCheck, repoRef, VACUITY_SENTINEL_NUMBER, childStatePath, VACUITY_SENTINEL, statePath, templateSlots, renderCheck, checksDigest, checkPattern, checkNearMissPattern } from '../../chunk-JWJYNAWI.js';
-import '../../chunk-E665XWYU.js';
+import '../../chunk-VOHTQV4J.js';
 import { eventSchema, isLegacyEventRow } from '../../chunk-6KJC4BTO.js';
 import { redactEvent, redactSecrets } from '../../chunk-SG6ZTIMT.js';
 import '../../chunk-CF6EIU2U.js';
@@ -821,7 +821,7 @@ async function throwForStatus(res) {
 
 // src/task/seed-verifier.ts
 async function verifySeedWithTwin(seed) {
-  const { GitHubDomain, openGitHubCloneDatabase } = await import('../../src-56Y2R7ZQ.js');
+  const { GitHubDomain, openGitHubCloneDatabase } = await import('../../src-DO3BEABU.js');
   const db = openGitHubCloneDatabase(":memory:");
   try {
     new GitHubDomain(db).seed(seed);
@@ -4622,7 +4622,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.32.0".length > 0) return "0.32.0";
+  if ("0.33.1".length > 0) return "0.33.1";
   try {
     const here = dirname(fileURLToPath(import.meta.url));
     const candidates = [
@@ -4643,9 +4643,9 @@ function readPackageVersion() {
 function createProgram() {
   const program = new Command();
   program.name("pome").description(
-    "Digital-twin testing for AI agents \u2014 `pome run` records to app.pome.sh. See `pome docs getting-started`."
+    "Test AI agents against digital twins of real SaaS APIs. Runs are recorded to app.pome.sh. Start with `pome demo`."
   ).version(PACKAGE_VERSION).showHelpAfterError("(add --help for usage)");
-  program.command("init").description("Create starter Pome config and folders").option(
+  program.command("init").summary("Set up Pome in this project").description("Create pome.json, plus starter files in a new project").option(
     "--sdk <name>",
     "Scaffold for a specific agent SDK (claude | claude-managed). Adds the SDK-specific example file and pre-fills agent.framework so the dashboard badges runs correctly."
   ).option(
@@ -4720,7 +4720,7 @@ function createProgram() {
     }
     console.error(postInitMessage);
   });
-  program.command("login").description("Sign in with Clerk and store a hosted team API key (macOS Keychain or ~/.pome/credentials.json)").option(
+  program.command("login").summary("Sign in and save an API key").description("Sign in with Clerk and store a hosted team API key (macOS Keychain or ~/.pome/credentials.json)").option(
     "--api-url <url>",
     "Control-plane base URL.",
     process.env.POME_API_URL ?? DEFAULT_CONTROL_PLANE_URL
@@ -4737,14 +4737,14 @@ function createProgram() {
       await loginWithClerk(options);
     }
   );
-  program.command("logout").description("Remove locally stored hosted credentials (Keychain entry and/or ~/.pome/credentials.json)").action(async () => {
+  program.command("logout").summary("Delete the saved API key").description("Remove locally stored hosted credentials (Keychain entry and/or ~/.pome/credentials.json)").action(async () => {
     await clearLocalCredentials();
     console.error("Removed local Pome credentials.");
     console.error(
       "Server-side keys are not auto-revoked \u2014 revoke API keys from the dashboard if this device was lost."
     );
   });
-  program.command("docs").argument("[topic]", "Topic id (e.g. getting-started, github, cli) \u2014 prints the docs.pome.sh URL").option(
+  program.command("docs").summary("Print a docs.pome.sh URL by topic").argument("[topic]", "Topic id (e.g. getting-started, github, cli) \u2014 prints the docs.pome.sh URL").option(
     "--site <origin>",
     "Override docs site origin (default https://docs.pome.sh)"
   ).option(
@@ -4756,7 +4756,7 @@ function createProgram() {
   ).action(async (topic, opts) => {
     await runDocsCommand(topic, { site: opts.site, urlOnly: Boolean(opts.url) });
   });
-  program.command("tasks").argument(
+  program.command("tasks").summary("List or copy the bundled tasks").argument(
     "[twin]",
     "Twin id (e.g. github). Omit to list available twins."
   ).option(
@@ -4781,7 +4781,7 @@ function createProgram() {
       });
     }
   );
-  const checks = program.command("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).", false).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 });
@@ -4807,7 +4807,7 @@ 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").argument("[target]", "Task .md file or directory (defaults to ./tasks)").option("--force", "Recompile even if the sidecar's source hash matches", false).option(
+  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
@@ -4825,7 +4825,7 @@ function createProgram() {
     });
     if (code !== 0) process.exitCode = code;
   });
-  const register = program.command("register").description(
+  const register = program.command("register").summary("Register an agent with Pome").description(
     "Register a cloud entity (agent, ...) and link this project to it"
   );
   register.command("agent").argument("<name>", 'Human-readable agent name (e.g. "triage-bot")').option(
@@ -4857,7 +4857,7 @@ function createProgram() {
       }
     }
   );
-  const session = program.command("sandbox").description(
+  const session = program.command("sandbox").summary("Create, list, and stop sandboxes").description(
     "Hosted sandboxes (same API as the dashboard Twins page \u2014 requires login)"
   );
   session.command("create").description("Create a hosted sandbox for one or more twins and print its connection info").option(
@@ -4972,7 +4972,7 @@ function createProgram() {
       }
     }
   );
-  program.command("run").argument(
+  program.command("run").summary("Run a task and print the score").argument(
     "[path]",
     'Task markdown file or directory. Omit to run the demo task ("that was ours, run yours"): tasks/first-run-demo.md is dropped into your project on first use with runs: 5 pinned.'
   ).option("--agent <command>", "Agent command to run").option(
@@ -5069,7 +5069,7 @@ function createProgram() {
         return;
       }
       {
-        const { runDoctorChecks } = await import('../../checks-KGDGQ35O.js');
+        const { runDoctorChecks } = await import('../../checks-CAP2CSEW.js');
         const { renderDoctorReport } = await import('../../render-ZQQ4UMNO.js');
         const doctorReport = await runDoctorChecks({ mode: useLocal ? "full" : "hosted" });
         if (!doctorReport.ok) {
@@ -5107,7 +5107,7 @@ function createProgram() {
               taskForRuns.config.runs
             );
             if (k > 1) {
-              const { runTrialGroup } = await import('../../runTrialGroup-W7C4Z5DN.js');
+              const { runTrialGroup } = await import('../../runTrialGroup-UBN46ZEJ.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({
@@ -5183,7 +5183,7 @@ function createProgram() {
       process.exitCode = worstExit;
     }
   );
-  program.command("demo").description(
+  program.command("demo").summary("Run a sample task, no account needed").description(
     "Zero-auth first-run demo: boots a local GitHub twin, runs the bundled demo agent for 5 isolated trials (model calls via pome's anonymous demo gateway), and prints per-trial verdicts evaluated in Pome cloud. No signup, no API keys; ends with a no-login preview link."
   ).option(
     "--api-url <url>",
@@ -5201,7 +5201,7 @@ function createProgram() {
         process.exitCode = 5;
         return;
       }
-      const { runDemo } = await import('../../runDemo-3JEAM6CM.js');
+      const { runDemo } = await import('../../runDemo-6WD2RSIH.js');
       const result = await runDemo({
         apiBase: opts.apiUrl.replace(/\/$/, ""),
         dashboardBase: process.env.POME_DASHBOARD_URL ?? DEFAULT_DASHBOARD_URL,
@@ -5216,16 +5216,16 @@ function createProgram() {
     const code = await runDemoAgentCommand();
     if (code !== 0) process.exitCode = code;
   });
-  program.command("doctor").description(
+  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-KGDGQ35O.js');
+    const { runDoctorChecks } = await import('../../checks-CAP2CSEW.js');
     const { renderDoctorReport } = await import('../../render-ZQQ4UMNO.js');
     const report = await runDoctorChecks();
     for (const line of renderDoctorReport(report, { passNote: true })) console.error(line);
     if (!report.ok) process.exitCode = 1;
   });
-  program.command("eval").argument(
+  program.command("eval").summary("Score a trace recorded earlier").argument(
     "[run-dir]",
     "Existing run directory (runs/<task>/<run-id>). Omit to use <artifacts-dir>/latest.json."
   ).option(
@@ -5267,7 +5267,7 @@ function createProgram() {
       for (const line of renderEvents(eventsResult.events)) console.log(line);
     }
   });
-  program.command("fix-prompt").argument(
+  program.command("fix-prompt").summary("Build a prompt for a failed run").argument(
     "[target]",
     "Artifacts root or a trial run dir (default: runs). Legacy form: a path to events.jsonl \u2014 then <task> is required."
   ).argument(
@@ -5383,7 +5383,7 @@ function createProgram() {
       })
     );
   });
-  const twin = program.command("twin").description("Manage local twins");
+  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");
   twin.command("start").argument(
     "[name]",
     `Twin name (${TWIN_NAME_LIST.join(" | ")}). Optional when --seed names exactly one twin.`
@@ -5396,7 +5396,7 @@ 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-VUCN4CFY.js');
+    const { runTwinStartCommand } = await import('../../twinStart-2ZNLS3ON.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(
@@ -5405,7 +5405,7 @@ function createProgram() {
   ).description(
     "Print a starter seed file for a twin, generated from the twin's own starting state"
   ).action(async (names, options) => {
-    const { runTwinSeedCommand } = await import('../../twinSeed-QCYKAY3I.js');
+    const { runTwinSeedCommand } = await import('../../twinSeed-2MRVMNIT.js');
     await runTwinSeedCommand(names, options);
   });
   twin.command("reset").argument("[name]", "Twin name (default: github)", "github").description("Reset standalone twin state").action(async (name) => {
@@ -5428,7 +5428,7 @@ function createProgram() {
     }
     console.log(await import('node:fs/promises').then((fs) => fs.readFile(".pome/twin-status.json", "utf8")));
   });
-  program.command("endpoints").argument("<name>", "Twin name").description("List supported endpoints").action((name) => {
+  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.");
@@ -5437,7 +5437,7 @@ function createProgram() {
       console.log(`${endpoint}  semantic`);
     }
   });
-  program.command("capture-server").description(
+  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."
   ).option("--port <port>", "TCP port to listen on (0 = ephemeral).", "8910").option(
     "--events-out <path>",

package/dist/{src-FK536BIR.js → src-5SOF4PDV.js}

@@ -3,7 +3,7 @@ import { MCP_PAGE_MAX, defaultSeedState, linearSeedSchema, notFound, badUserInpu
 export { DEFAULT_LINEAR_CLOCK, DEFAULT_LINEAR_EMAIL, DEFAULT_LINEAR_PORT, DEFAULT_LINEAR_SID, DEFAULT_LINEAR_TOKEN, LINEAR_PROVIDER_TOKEN_PREFIX, LinearTwinError, STATE_EXPORT_CAP, assertWebhookUrl, defaultSeedState, linearErrorEnvelope, linearSeedSchema, loadSeedFromEnv, parseSeed, unauthorizedEnvelope, unsupportedEnvelope, webhookUrlError } from './chunk-Q5NBPR57.js';
 import './chunk-JWJYNAWI.js';
 import { routeInputDeclarer, mountDeclaredRoute, UndeclaredInputError } from './chunk-IZFM7W2V.js';
-import { loadMcpToolFixture, deriveMcpToolTable, openTwinDatabase, defineTwin, createApp } from './chunk-E665XWYU.js';
+import { loadMcpToolFixture, deriveMcpToolTable, openTwinDatabase, defineTwin, createApp } from './chunk-VOHTQV4J.js';
 import './chunk-6KJC4BTO.js';
 import './chunk-SG6ZTIMT.js';
 import './chunk-CF6EIU2U.js';

package/dist/{src-PW7U25ZX.js → src-AMLUIPYO.js}

@@ -1,5 +1,5 @@
 import { routeInputDeclarer, bracketedQuery, integerInput, booleanInput, mountDeclaredRoute, UndeclaredInputError } from './chunk-IZFM7W2V.js';
-import { loadMcpToolFixture, openTwinDatabase, defineTwin, twinBuildInfo, deriveMcpToolTable, failureInjectionMiddleware, createApp, recordedRequestHeaders, UnknownToolError } from './chunk-E665XWYU.js';
+import { loadMcpToolFixture, openTwinDatabase, defineTwin, twinBuildInfo, deriveMcpToolTable, failureInjectionMiddleware, createApp, recordedRequestHeaders, UnknownToolError } from './chunk-VOHTQV4J.js';
 import './chunk-6KJC4BTO.js';
 import './chunk-SG6ZTIMT.js';
 import { defaultSeed, seedSchema, ensureMigratedColumns, ensureStripeTables, resetStripeTables, looksLikeApiKey, resolveSidFromKey, applySeed, newId, newClientSecret, nowUnix, requestId, nowIso } from './chunk-SLTBPJKZ.js';

package/dist/{src-SKCWAMVQ.js → src-ANO374BX.js}

@@ -3,7 +3,7 @@ import './chunk-JWJYNAWI.js';
 import { defaultSeedState, parseSeed } from './chunk-ZDS25NS5.js';
 export { defaultSeedState, loadSeedFromEnv, parseSeed, seedSchema } from './chunk-ZDS25NS5.js';
 import { routeInputDeclarer, booleanInput, integerInput, mountDeclaredRoute, UndeclaredInputError } from './chunk-IZFM7W2V.js';
-import { loadMcpToolFixture, defineTwin, queryTokenResolver, formTokenResolver, deriveMcpToolTable, UnknownToolError, openTwinDatabase, createApp, typeDisagreements } from './chunk-E665XWYU.js';
+import { loadMcpToolFixture, defineTwin, queryTokenResolver, formTokenResolver, deriveMcpToolTable, UnknownToolError, openTwinDatabase, createApp, typeDisagreements } from './chunk-VOHTQV4J.js';
 import './chunk-6KJC4BTO.js';
 import './chunk-SG6ZTIMT.js';
 import './chunk-CF6EIU2U.js';
@@ -3101,12 +3101,6 @@ var slackTwinDefinition = defineTwin({
   // engine-owned surface — official Slack SDKs default to
   // application/x-www-form-urlencoded — and malformed JSON collapses to {}.
   bodyReader: (c) => parseFormOrJson(c),
-  // Frozen legacy /mcp/call surface: {name}/{params} alias keys; a body
-  // naming no tool answers 400 {ok:false, error:"invalid_arguments"}.
-  legacyMcp: {
-    aliases: true,
-    missingTool: () => ({ status: 400, body: slackError2("invalid_arguments") })
-  },
   // Frozen /_pome/health shape: exactly {ok, twin} — no extras.
   pomeHealth: () => ({}),
   state: ({ domain }) => domain.exportState(),

package/dist/{src-56Y2R7ZQ.js → src-DO3BEABU.js}

@@ -2,7 +2,7 @@ import './chunk-C4BVTUA3.js';
 import { defaultSeedState, parseSeed } from './chunk-HJX25USP.js';
 export { defaultSeedState, parseSeed, seedSchema } from './chunk-HJX25USP.js';
 import { routeInputDeclarer, integerInput, mountDeclaredRoute, UndeclaredInputError, MalformedBodyError } from './chunk-IZFM7W2V.js';
-import { loadMcpToolFixture, defineTwin, twinBuildInfo, deriveMcpToolTable, UnknownToolError, openTwinDatabase, createApp, typeDisagreements } from './chunk-E665XWYU.js';
+import { loadMcpToolFixture, defineTwin, twinBuildInfo, deriveMcpToolTable, UnknownToolError, openTwinDatabase, createApp, typeDisagreements } from './chunk-VOHTQV4J.js';
 import './chunk-6KJC4BTO.js';
 import './chunk-SG6ZTIMT.js';
 import './chunk-CF6EIU2U.js';

package/dist/{src-KSLAF3I4.js → src-YGMRIKFV.js}

@@ -3,7 +3,7 @@ import { gmailErrorEnvelope, gmailSeedSchema, parseSeed, defaultSeedState, notFo
 export { DEFAULT_GMAIL_AGENT_EMAIL, GmailError, SEARCH_MAILBOX_MESSAGE_BUDGET, agentPathInboxMailbox, defaultSeedState, gmailErrorEnvelope, gmailSeedSchema, loadSeedFromEnv, parseSearchQuery, parseSeed, validateSearchQuery } from './chunk-3T5XN64P.js';
 import './chunk-JWJYNAWI.js';
 import { routeInputDeclarer, integerInput, booleanInput, repeatedInput, mountDeclaredRoute, UndeclaredInputError, MalformedBodyError } from './chunk-IZFM7W2V.js';
-import { loadMcpToolFixture, deriveMcpToolTable, defineTwin, openTwinDatabase, createApp } from './chunk-E665XWYU.js';
+import { loadMcpToolFixture, deriveMcpToolTable, defineTwin, openTwinDatabase, createApp } from './chunk-VOHTQV4J.js';
 import './chunk-6KJC4BTO.js';
 import './chunk-SG6ZTIMT.js';
 import './chunk-CF6EIU2U.js';

package/dist/twinHarness-2OFWSVPK.js

@@ -0,0 +1,6 @@
+export { UnsupportedTwinError, bootTwin } from './chunk-T73VMABH.js';
+export { STRIPE_LOCAL_ACCOUNT_ID } from './chunk-CNG6DQWX.js';
+import './chunk-VOHTQV4J.js';
+import './chunk-6KJC4BTO.js';
+import './chunk-SG6ZTIMT.js';
+import './chunk-CF6EIU2U.js';

package/dist/{twinSeed-QCYKAY3I.js → twinSeed-2MRVMNIT.js}

@@ -1,4 +1,4 @@
-import { TWIN_NAMES, isTwinName, TWIN_REGISTRY } from './chunk-SDBBGCE7.js';
+import { TWIN_NAMES, isTwinName, TWIN_REGISTRY } from './chunk-CNG6DQWX.js';
 import { writeFile } from 'node:fs/promises';
 
 async function generateSeedFile(twins, opts = {}) {

package/dist/{twinStart-VUCN4CFY.js → twinStart-2ZNLS3ON.js}

@@ -1,7 +1,7 @@
-import { readSeedFileText, seedForTwin, parseSeedFileText, soleTwinOf, twinsNamedBy } from './chunk-IHKUFGYW.js';
-import { bootTwin } from './chunk-WJFRBXL5.js';
-import { TWIN_REGISTRY, isTwinName, TWIN_NAMES, defaultPortFor } from './chunk-SDBBGCE7.js';
-import './chunk-E665XWYU.js';
+import { readSeedFileText, seedForTwin, parseSeedFileText, soleTwinOf, twinsNamedBy } from './chunk-DWOCTCSE.js';
+import { bootTwin } from './chunk-T73VMABH.js';
+import { TWIN_REGISTRY, isTwinName, TWIN_NAMES, defaultPortFor } from './chunk-CNG6DQWX.js';
+import './chunk-VOHTQV4J.js';
 import './chunk-6KJC4BTO.js';
 import './chunk-SG6ZTIMT.js';
 import './chunk-CF6EIU2U.js';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pome-sh/cli",
-  "version": "0.32.0",
-  "description": "Digital-twin testing for AI agents \u2014 run tasks against resettable local or hosted twins and record tool-call traces for evaluation on pome.sh.",
+  "version": "0.33.1",
+  "description": "Test AI agents against digital twins of real SaaS APIs. Records tool-call traces and scores them on pome.sh.",
   "keywords": [
     "ai",
     "agents",

package/dist/twinHarness-TSAQYDC5.js

@@ -1,6 +0,0 @@
-export { UnsupportedTwinError, bootTwin } from './chunk-WJFRBXL5.js';
-export { STRIPE_LOCAL_ACCOUNT_ID } from './chunk-SDBBGCE7.js';
-import './chunk-E665XWYU.js';
-import './chunk-6KJC4BTO.js';
-import './chunk-SG6ZTIMT.js';
-import './chunk-CF6EIU2U.js';