@pome-sh/cli 0.5.0 → 0.7.0

package/dist/src/runner/{runScenarioCore.d.ts → runTaskCore.d.ts}

@@ -1,10 +1,10 @@
-import type { Scenario } from "../scenario/scenarioSchema.js";
+import type { Task } from "../task/taskSchema.js";
 import { writeRunArtifactsCore } from "../recorder/artifacts.js";
 import type { RecorderEvent } from "@pome-sh/shared-types";
 export interface WriteRunInput {
     artifactsDir: string;
     runId: string;
-    scenario: Scenario;
+    scenario: Task;
     startedAt: string;
     completedAt: string;
     agentStdout: string;

package/dist/src/runner/{runScenarioHosted.d.ts → runTaskHosted.d.ts}

@@ -1,10 +1,10 @@
 import { type HostedClient } from "../hosted/client.js";
 import type { CreateSessionResponse } from "../types/shared.js";
-import type { Scenario } from "../scenario/scenarioSchema.js";
+import type { Task } from "../task/taskSchema.js";
 import type { Score } from "../hosted/evalResultView.js";
 import type { RunArtifacts } from "../recorder/artifacts.js";
-export interface RunScenarioHostedOptions {
-    scenarioPath: string;
+export interface RunTaskHostedOptions {
+    taskPath: string;
     agentCommand: string;
     artifactsDir?: string;
     hosted: {
@@ -37,8 +37,8 @@ export interface RunScenarioHostedOptions {
      *  local artifacts. Absent on single runs (verdict.json gets null). */
     groupId?: string;
 }
-export interface RunScenarioHostedResult {
-    scenario: Scenario;
+export interface RunTaskHostedResult {
+    scenario: Task;
     runId: string;
     cloudRunId: string;
     cloudDashboardUrl: string;
@@ -87,4 +87,4 @@ export declare function buildAgentEnv(params: {
     slug: string;
     signalsPath: string;
 }): Record<string, string>;
-export declare function runScenarioHosted(options: RunScenarioHostedOptions): Promise<RunScenarioHostedResult>;
+export declare function runTaskHosted(options: RunTaskHostedOptions): Promise<RunTaskHostedResult>;

package/dist/src/runner/{runScenarioHosted.js → runTaskHosted.js}

@@ -7,7 +7,7 @@ import { runAgentCommand } from "./agentRunner.js";
 import { toTwinHttpEvent, writeRunArtifactsCore } from "../recorder/artifacts.js";
 import { VERDICT_ARTIFACT_VERSION, writeVerdictArtifact, } from "../hosted/evalResultCache.js";
 import { redactEvent, redactSecrets } from "../recorder/redaction.js";
-import { parseScenarioFile } from "../scenario/parseScenario.js";
+import { parseTaskFile } from "../task/parseTask.js";
 import { createHostedClient, perTwinReturnedByCloud, } from "../hosted/client.js";
 import { ensureMcpSuffix } from "../cli/session.js";
 import { redactJsonl, scoreFromFinalizeResponse, uploadRunBlobs, } from "../hosted/uploadAndFinalize.js";
@@ -105,10 +105,10 @@ export function buildAgentEnv(params) {
     }
     return env;
 }
-export async function runScenarioHosted(options) {
-    const scenario = await parseScenarioFile(options.scenarioPath);
-    const scenarioSource = await readFile(options.scenarioPath, "utf8");
-    const scenarioHash = createHash("sha256").update(scenarioSource).digest("hex");
+export async function runTaskHosted(options) {
+    const scenario = await parseTaskFile(options.taskPath);
+    const taskSource = await readFile(options.taskPath, "utf8");
+    const taskHash = createHash("sha256").update(taskSource).digest("hex");
     const artifactsDir = options.artifactsDir ?? "runs";
     const startedAt = new Date().toISOString();
     const client = options.client ??
@@ -119,7 +119,7 @@ export async function runScenarioHosted(options) {
     // `agent_version` stamps the session; `--agent-version` overrides it. All are
     // optional during rollout — a manifest-less repo runs unattributed.
     const identity = await resolveRunAgentIdentity({
-        startDir: dirname(options.scenarioPath),
+        startDir: dirname(options.taskPath),
         apiBaseUrl: options.hosted.baseUrl,
         agentVersionOverride: options.agentVersion,
     });
@@ -138,11 +138,11 @@ export async function runScenarioHosted(options) {
     // groups mint all k sessions upfront (one shared group_id) and pass each
     // one in as `premintedSession`; the single-run path mints its own here.
     // Forward the resolved seed (sidecar -> inline JSON -> twin defaults, in that
-    // precedence; see parseScenario.resolveSeedState) so the cloud doesn't need
+    // precedence; see parseTask.resolveSeedState) so the cloud doesn't need
     // to re-extract it from the markdown. Prose `## Seed State` sections have no
     // fenced JSON to extract — cloud would 422 with "no fenced code block".
     const session = await createSessionOrExplain(client, options.premintedSession, {
-        scenarioSource,
+        taskSource,
         twins: scenario.config.twins,
         agentId,
         agentVersion,
@@ -450,9 +450,9 @@ export async function runScenarioHosted(options) {
             agentModel: options.agentModel ?? "unknown",
             agentSdk,
             criteria: criteriaDefs,
-            scenarioName: scenario.slug,
-            scenarioHash,
-            scenarioPrompt: scenario.prompt,
+            taskName: scenario.slug,
+            taskHash,
+            taskPrompt: scenario.prompt,
             expectedBehavior: scenario.expectedBehavior,
             // Explicit overrides when uploads succeeded; otherwise let cloud fall
             // back. For events.jsonl the conventional `team-<>/session-<>/events.jsonl`
@@ -504,7 +504,7 @@ export async function runScenarioHosted(options) {
                 version: VERDICT_ARTIFACT_VERSION,
                 source: "cloud-finalize",
                 task_name: scenario.slug,
-                scenario_path: options.scenarioPath,
+                scenario_path: options.taskPath,
                 group_id: options.groupId ?? null,
                 session_id: session.session_id,
                 cloud_run_id: finalized.run_id,

package/dist/src/runner/runTrialGroup.d.ts

@@ -1,5 +1,5 @@
 import { type HostedClient } from "../hosted/client.js";
-import { runScenarioHosted } from "./runScenarioHosted.js";
+import { runTaskHosted } from "./runTaskHosted.js";
 import { type TrialRow } from "./groupRender.js";
 /** Per-request transport timeout. Durable evaluation has a separate budget. */
 export declare const GROUP_FINALIZE_TIMEOUT_MS = 60000;
@@ -9,7 +9,7 @@ export declare const GROUP_FINALIZE_TIMEOUT_MS = 60000;
 export declare const LAZY_MINT_RETRY_MS = 2000;
 export declare const LAZY_MINT_MAX_ATTEMPTS = 5;
 export interface RunTrialGroupOptions {
-    scenarioPath: string;
+    taskPath: string;
     agentCommand: string;
     /** Where the agent command came from, for the header copy
      *  ("pome.json" | "--agent" | "built-in default"). */
@@ -31,11 +31,11 @@ export interface RunTrialGroupOptions {
     /** FDRS-644 — the literal command the fix handoff tells the user to
      *  re-run after their coding agent applies a fix. The caller knows the
      *  invocation shape (bare `pome run` vs an explicit path + -n); default
-     *  reconstructs it from scenarioPath + trials. */
+     *  reconstructs it from taskPath + trials. */
     rerunCommand?: string;
     out?: (line: string) => void;
     client?: HostedClient;
-    runScenarioHostedFn?: typeof runScenarioHosted;
+    runTaskHostedFn?: typeof runTaskHosted;
     groupId?: string;
     /** FDRS-663 — lazy-mint retry pause; defaults to a real setTimeout. */
     sleepFn?: (ms: number) => Promise<void>;

package/dist/src/runner/runTrialGroup.js

@@ -16,7 +16,7 @@
 //      half-group back (best-effort DELETEs) and aborts before any agent
 //      spawns.
 //   2. Run the k trials with concurrency = the number of upfront mints
-//      (= k when quota never pushed back). runScenarioHosted stays the
+//      (= k when quota never pushed back). runTaskHosted stays the
 //      isolation unit: each trial gets its session via the
 //      `premintedSession` seam, `abandonOnFailure` on, and still DELETEs
 //      its own session in its `finally` — that delete frees the quota slot
@@ -40,10 +40,10 @@ import { createHostedClient } from "../hosted/client.js";
 import { HostedQuotaError, HostedTrialError } from "../hosted/errors.js";
 import { newGroupId } from "../demo/ids.js";
 import { criterionPhrase } from "../demo/render.js";
-import { parseScenarioFile } from "../scenario/parseScenario.js";
+import { parseTaskFile } from "../task/parseTask.js";
 import { outcomeOf } from "../hosted/evalResultView.js";
 import { resolveRunAgentIdentity } from "../cli/agent-identity.js";
-import { runScenarioHosted } from "./runScenarioHosted.js";
+import { runTaskHosted } from "./runTaskHosted.js";
 import { fixHandoffLines, flagHintLine, groupExitCode, groupSummaryLines, mostCommonFailedCriterion, provisioningLine, shortReason, spawningAgentLine, trialRowLine, } from "./groupRender.js";
 /** Per-request transport timeout. Durable evaluation has a separate budget. */
 export const GROUP_FINALIZE_TIMEOUT_MS = 60_000;
@@ -57,7 +57,7 @@ export async function runTrialGroup(options) {
         throw new Error(`runTrialGroup requires k>1 (got ${options.trials}); k=1 takes the single-run path so no group is stamped.`);
     }
     const out = options.out ?? ((line) => console.error(line));
-    const runFn = options.runScenarioHostedFn ?? runScenarioHosted;
+    const runFn = options.runTaskHostedFn ?? runTaskHosted;
     const client = options.client ??
         createHostedClient({
             baseUrl: options.hosted.baseUrl,
@@ -66,12 +66,12 @@ export async function runTrialGroup(options) {
         });
     const groupId = options.groupId ?? newGroupId();
     const agentCommandSource = options.agentCommandSource ?? "pome.json";
-    const scenario = await parseScenarioFile(options.scenarioPath);
-    const scenarioSource = await readFile(options.scenarioPath, "utf8");
+    const scenario = await parseTaskFile(options.taskPath);
+    const taskSource = await readFile(options.taskPath, "utf8");
     // Same agent resolution as the single-run path (F-819): the group's trials
     // are recorded under the agent the manifest's `agent.slug` resolves to.
     const identity = await resolveRunAgentIdentity({
-        startDir: dirname(options.scenarioPath),
+        startDir: dirname(options.taskPath),
         apiBaseUrl: options.hosted.baseUrl,
         agentVersionOverride: options.agentVersion,
     });
@@ -83,7 +83,7 @@ export async function runTrialGroup(options) {
     const sleep = options.sleepFn ??
         ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
     const mintOne = () => client.createSession({
-        scenarioSource,
+        taskSource,
         twins: scenario.config.twins,
         agentId,
         agentVersion,
@@ -158,7 +158,7 @@ export async function runTrialGroup(options) {
         try {
             const session = index < sessions.length ? sessions[index] : await mintLazily();
             const result = await runFn({
-                scenarioPath: options.scenarioPath,
+                taskPath: options.taskPath,
                 agentCommand: options.agentCommand,
                 artifactsDir: options.artifactsDir,
                 hosted: options.hosted,
@@ -239,7 +239,7 @@ export async function runTrialGroup(options) {
             ? "pome fix-prompt"
             : `pome fix-prompt ${artifactsDir}`;
         const rerunCommand = options.rerunCommand ??
-            `pome run ${options.scenarioPath} -n ${options.trials}`;
+            `pome run ${options.taskPath} -n ${options.trials}`;
         for (const line of fixHandoffLines({ fixPromptCommand, rerunCommand })) {
             out(line);
         }

package/dist/src/runner/trialCount.js

@@ -2,7 +2,7 @@
 // FDRS-636 — trial-count resolution for `pome run -n k`.
 //
 // [DECISION 2026-07-05]: -n is an integer 1..20 on the hosted run path. The
-// DEFAULT is the scenario config's `runs` field (scenarioConfigSchema parses
+// DEFAULT is the scenario config's `runs` field (taskConfigSchema parses
 // it, defaulting 1; nothing consumed it before this ticket) — -n overrides;
 // both are capped at 20. k=1 keeps EXACTLY today's single-run behavior (no
 // group is ever stamped — a group of 1 would flip the reliability page off

package/dist/src/task/parseTask.d.ts

@@ -0,0 +1,9 @@
+import { type Task } from "./taskSchema.js";
+export declare function parseTaskFile(path: string): Promise<Task>;
+export declare function parseTask(markdown: string, slug?: string, sidecarSeed?: unknown, taskPath?: string): Task;
+/** The flat seed a single twin boots from. Single-twin scenarios return the
+ *  flat `seedState` as-is; multi-twin scenarios return that twin's slice of the
+ *  per-twin envelope (decided from `config.twins`, per the envelope-iff-multi-twin
+ *  rule). Used by the local runner to seed each twin harness. */
+export declare function seedStateForTwin(scenario: Task, twin: string): unknown;
+export declare function formatTaskError(error: unknown, filePath: string): string;

package/dist/src/{scenario/parseScenario.js → task/parseTask.js}

@@ -8,23 +8,23 @@ import { defaultSeedState, seedSchema } from "@pome-sh/twin-github";
 import { defaultSeedState as defaultGmailSeedState, gmailSeedSchema, } from "@pome-sh/twin-gmail";
 import { defaultSeedState as defaultLinearSeedState, linearSeedSchema as linearSeedStateSchema, } from "@pome-sh/twin-linear";
 import { parseGitHubSeedState } from "./githubSeedCompat.js";
-import { criterionSchema, scenarioConfigSchema, scenarioSchema, slackSeedStateSchema, stripeSeedStateSchema } from "./scenarioSchema.js";
-export async function parseScenarioFile(path) {
+import { criterionSchema, taskConfigSchema, taskSchema, slackSeedStateSchema, stripeSeedStateSchema } from "./taskSchema.js";
+export async function parseTaskFile(path) {
     const markdown = await readFile(path, "utf8");
     const sidecarSeed = await readSidecarSeed(path);
-    return parseScenario(markdown, slugFromPath(path), sidecarSeed, path);
+    return parseTask(markdown, slugFromPath(path), sidecarSeed, path);
 }
-export function parseScenario(markdown, slug = "scenario", sidecarSeed, scenarioPath) {
+export function parseTask(markdown, slug = "scenario", sidecarSeed, taskPath) {
     const title = markdown.match(/^#\s+(.+)$/m)?.[1]?.trim() ?? slug;
     const sections = splitSections(markdown);
     const prompt = sections.get("prompt") ?? sections.get("task") ?? "";
     const criteriaText = sections.get("success criteria") ?? sections.get("checks") ?? "";
     const configText = sections.get("config") ?? "";
     const seedText = sections.get("seed state") ?? "";
-    const config = configText.trim() ? scenarioConfigSchema.parse(parseFencedYaml(configText)) : scenarioConfigSchema.parse({});
+    const config = configText.trim() ? taskConfigSchema.parse(parseFencedYaml(configText)) : taskConfigSchema.parse({});
     const criteria = parseCriteria(criteriaText, config.twins);
-    const seedState = resolveSeedState({ sidecarSeed, seedText, config, scenarioPath });
-    return scenarioSchema.parse({
+    const seedState = resolveSeedState({ sidecarSeed, seedText, config, taskPath });
+    return taskSchema.parse({
         slug,
         title,
         setup: sections.get("setup") ?? "",
@@ -46,7 +46,7 @@ function resolveSeedState(args) {
     // validated against the in-memory twin. The `_meta` key (source hash,
     // model, etc.) is stripped before schema parsing.
     if (args.sidecarSeed !== undefined) {
-        return parseSeedStateForScenario(stripSidecarMeta(args.sidecarSeed), args.config);
+        return parseSeedStateForTask(stripSidecarMeta(args.sidecarSeed), args.config);
     }
     if (args.seedText.trim()) {
         const raw = stripFence(args.seedText);
@@ -55,10 +55,10 @@ function resolveSeedState(args) {
         // got here, the sidecar is missing — tell the user what to do instead of
         // letting JSON.parse surface "Unexpected token 'A'".
         if (!/^[\[{]/.test(raw)) {
-            throw new Error(missingSidecarMessage(args.scenarioPath));
+            throw new Error(missingSidecarMessage(args.taskPath));
         }
         try {
-            return parseSeedStateForScenario(JSON.parse(raw), args.config);
+            return parseSeedStateForTask(JSON.parse(raw), args.config);
         }
         catch (err) {
             if (err instanceof SyntaxError) {
@@ -84,7 +84,7 @@ function resolveMultiTwinSeedState(args) {
     else if (args.seedText.trim()) {
         const text = stripFence(args.seedText);
         if (!/^[\[{]/.test(text)) {
-            throw new Error(missingSidecarMessage(args.scenarioPath));
+            throw new Error(missingSidecarMessage(args.taskPath));
         }
         try {
             raw = JSON.parse(text);
@@ -155,10 +155,10 @@ function defaultSeedForTwin(twin) {
     }
     return seedSchema.parse(defaultSeedState());
 }
-function missingSidecarMessage(scenarioPath) {
-    const pathLabel = scenarioPath ?? "<task>.md";
-    const sidecarLabel = scenarioPath
-        ? scenarioPath.replace(/\.md$/i, ".seed.json")
+function missingSidecarMessage(taskPath) {
+    const pathLabel = taskPath ?? "<task>.md";
+    const sidecarLabel = taskPath
+        ? taskPath.replace(/\.md$/i, ".seed.json")
         : "<task>.seed.json";
     return [
         `Task has a prose ## Seed State section but no compiled sidecar (${sidecarLabel}). Run:`,
@@ -175,9 +175,9 @@ function stripSidecarMeta(seed) {
     }
     return seed;
 }
-async function readSidecarSeed(scenarioPath) {
-    const sidecarPath = scenarioPath.replace(/\.md$/i, ".seed.json");
-    if (sidecarPath === scenarioPath || !existsSync(sidecarPath))
+async function readSidecarSeed(taskPath) {
+    const sidecarPath = taskPath.replace(/\.md$/i, ".seed.json");
+    if (sidecarPath === taskPath || !existsSync(sidecarPath))
         return undefined;
     const raw = await readFile(sidecarPath, "utf8");
     try {
@@ -276,7 +276,7 @@ function parseFencedYaml(input) {
 // FDRS-365: scenario seed shape is FLAT per twin, disambiguated by config.twins.
 // Stripe-only scenarios parse with the Stripe schema; everything else (default
 // `["github"]`, or explicit github) parses with the GitHub schema.
-function parseSeedStateForScenario(input, config) {
+function parseSeedStateForTask(input, config) {
     if (isStripeOnly(config.twins))
         return stripeSeedStateSchema.parse(input);
     if (isSlackOnly(config.twins))
@@ -295,7 +295,7 @@ function defaultSeedStateForConfig(twins) {
     }
     if (isSlackOnly(twins)) {
         // Empty Slack seed — the twin's own `parseSeed`/`defaultSeedState` fills the
-        // world at boot. Scenarios always ship a sidecar, so this is just the
+        // world at boot. Tasks always ship a sidecar, so this is just the
         // schema-valid floor.
         return slackSeedStateSchema.parse({});
     }
@@ -329,7 +329,7 @@ function slugFromPath(path) {
         .replace(/[^a-z0-9]+/g, "-")
         .replace(/^-|-$/g, "");
 }
-export function formatScenarioError(error, filePath) {
+export function formatTaskError(error, filePath) {
     if (error instanceof z.ZodError) {
         return `Invalid task ${filePath}: ${error.issues.map((issue) => `${issue.path.join(".")}: ${issue.message}`).join("; ")}`;
     }

package/dist/src/{scenario → task}/seed-compiler-hosted.d.ts

@@ -2,7 +2,7 @@ import type { CompileResult } from "./seed-compiler.js";
 export interface CompileSeedHostedOptions {
     apiBaseUrl: string;
     twin?: "github";
-    scenarioPath?: string;
+    taskPath?: string;
     timeoutMs?: number;
 }
 export declare function compileSeedHosted(prose: string, opts: CompileSeedHostedOptions): Promise<CompileResult>;

package/dist/src/{scenario → task}/seed-compiler-hosted.js

@@ -59,7 +59,7 @@ export async function compileSeedHosted(prose, opts) {
             body: JSON.stringify({
                 prose,
                 twin: opts.twin ?? "github",
-                scenario_path: opts.scenarioPath
+                scenario_path: opts.taskPath
             }),
             signal: controller.signal
         });

package/dist/src/{scenario/scenarioSchema.d.ts → task/taskSchema.d.ts}

@@ -4,7 +4,7 @@ import { linearSeedSchema as linearSeedStateSchema } from "@pome-sh/twin-linear"
 import { criterionSchema } from "@pome-sh/shared-types";
 import { z } from "zod";
 export { criterionSchema };
-export declare const scenarioConfigSchema: z.ZodObject<{
+export declare const taskConfigSchema: z.ZodObject<{
     twins: z.ZodDefault<z.ZodArray<z.ZodString>>;
     timeout: z.ZodDefault<z.ZodNumber>;
     runs: z.ZodDefault<z.ZodNumber>;
@@ -979,7 +979,7 @@ export declare const seedEnvelopeSchema: z.ZodRecord<z.ZodString, z.ZodUnion<rea
         body: z.ZodUnknown;
     }, z.core.$strip>>>;
 }, z.core.$strict>]>>;
-export declare const scenarioSchema: z.ZodObject<{
+export declare const taskSchema: z.ZodObject<{
     slug: z.ZodString;
     title: z.ZodString;
     setup: z.ZodDefault<z.ZodString>;
@@ -1930,7 +1930,7 @@ export declare const scenarioSchema: z.ZodObject<{
     }, z.core.$strict>]>>]>;
 }, z.core.$strip>;
 export type Criterion = z.infer<typeof criterionSchema>;
-export type ScenarioConfig = z.infer<typeof scenarioConfigSchema>;
+export type TaskConfig = z.infer<typeof taskConfigSchema>;
 export type GithubSeedState = z.infer<typeof githubSeedStateSchema>;
 export type StripeSeedState = z.infer<typeof stripeSeedStateSchema>;
 export type SlackSeedState = z.infer<typeof slackSeedStateSchema>;
@@ -1939,4 +1939,4 @@ export type LinearSeedState = z.infer<typeof linearSeedStateSchema>;
 export type StripeFailureInjectionRule = z.infer<typeof stripeFailureInjectionRuleSchema>;
 export type SeedState = z.infer<typeof seedStateSchema>;
 export type SeedEnvelope = z.infer<typeof seedEnvelopeSchema>;
-export type Scenario = z.infer<typeof scenarioSchema>;
+export type Task = z.infer<typeof taskSchema>;

package/dist/src/{scenario/scenarioSchema.js → task/taskSchema.js}

@@ -10,7 +10,7 @@ import { linearSeedSchema as linearSeedStateSchema } from "@pome-sh/twin-linear"
 import { criterionSchema } from "@pome-sh/shared-types";
 import { z } from "zod";
 export { criterionSchema };
-export const scenarioConfigSchema = z.object({
+export const taskConfigSchema = z.object({
     twins: z.array(z.string()).default(["github"]),
     timeout: z.number().int().positive().default(60),
     runs: z.number().int().positive().default(1),
@@ -70,7 +70,7 @@ export const slackSeedStateSchema = z
 // Slack scenarios use the Slack seed shape (`{ users, channels, ... }`).
 // Multi-twin scenarios are not a current requirement; the wrapped
 // `{ <twin>: { seed: ... } }` form was rejected here to keep one canonical
-// shape that twin parsers already speak natively. parseScenario disambiguates
+// shape that twin parsers already speak natively. parseTask disambiguates
 // the union by `config.twins`.
 //
 // Slack arm is FIRST because it is the only `.strict()` arm: a GitHub/Stripe
@@ -87,18 +87,18 @@ export const seedStateSchema = z.union([
 // ONLY for scenarios whose `config.twins` has >1 entry (the envelope-iff-multi-twin
 // rule, decided from `twins` alone — never by sniffing the seed shape). Each value
 // is one twin's flat seed, the same shapes `seedStateSchema` unions. Single-twin
-// scenarios keep the flat shape byte-identical. parseScenario builds and validates
+// scenarios keep the flat shape byte-identical. parseTask builds and validates
 // the envelope value-by-value with each twin's own schema; this record is the outer
-// shape scenarioSchema re-validates against.
+// shape taskSchema re-validates against.
 export const seedEnvelopeSchema = z.record(z.string(), seedStateSchema);
-export const scenarioSchema = z.object({
+export const taskSchema = z.object({
     slug: z.string().min(1),
     title: z.string().min(1),
     setup: z.string().default(""),
     prompt: z.string().min(1),
     expectedBehavior: z.string().default(""),
     criteria: z.array(criterionSchema).min(1),
-    config: scenarioConfigSchema,
+    config: taskConfigSchema,
     // Flat single-twin seed OR the multi-twin per-twin envelope. Flat is tried
     // first so single-twin seeds match their strict arms; the envelope only
     // matches when the flat union can't (its keys are twin ids, not seed fields).

package/examples/agents/llm-refund-agent.ts

@@ -102,7 +102,7 @@ async function callStripeTool(name: string, input: any) {
   throw new Error(`Unknown tool ${name}`);
 }
 
-// Hero bug surfaced by scenarios/14-stripe-refund-retry.md: this agent intentionally
+// Hero bug surfaced by tasks/14-stripe-refund-retry.md: this agent intentionally
 // never sends an `Idempotency-Key` header on POST /v1/refunds. When the twin's
 // failure-injection middleware drops the first response, the LLM-driven retry
 // creates a second refund row — exactly the double-charge bug Pome is built to catch.

package/node_modules/@pome-sh/twin-gmail/CHANGELOG.md

@@ -1,5 +1,10 @@
 # @pome-sh/twin-gmail — CHANGELOG
 
+## 0.1.1 — 2026-07-21
+
+Dependency-only patch: repin `@pome-sh/sdk` to 0.5.1 (F-818 batch). No twin
+surface change.
+
 ## 0.1.0 — 2026-07-20
 
 First public release of the deterministic Gmail twin:

package/node_modules/@pome-sh/twin-gmail/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pome-sh/twin-gmail",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Deterministic Gmail-shaped twin for agent testing — SQLite-backed domain core.",
   "private": false,
   "type": "module",
@@ -47,7 +47,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pome-sh/sdk": "0.5.0",
+    "@pome-sh/sdk": "0.5.1",
     "hono": "^4.12.27",
     "zod": "^4.1.13"
   },

package/node_modules/@pome-sh/twin-slack/node_modules/@pome-sh/shared-types/dist/index.d.ts

@@ -25,3 +25,4 @@ export * from "./task.js";
 export * from "./rest.js";
 export * from "./finalize-shapes.js";
 export * from "./errors.js";
+export * from "./manifest.js";

package/node_modules/@pome-sh/twin-slack/node_modules/@pome-sh/shared-types/dist/index.js

@@ -31,4 +31,5 @@ export * from "./task.js"; // §3 TASKS — task config / task / persisted-task
 export * from "./rest.js"; // §4 PUBLIC REST API (minus finalize family)
 export * from "./finalize-shapes.js"; // §4 PUBLIC REST API — /finalize response family
 export * from "./errors.js"; // §5 ERROR ENVELOPE
+export * from "./manifest.js"; // §6 MANIFEST — pome.json/pome.yaml + slug authority (F-818)
 //# sourceMappingURL=index.js.map

package/node_modules/@pome-sh/twin-slack/node_modules/@pome-sh/shared-types/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC;;;;;;;;;;;;GAYG;AAEH,8EAA8E;AAC9E,+CAA+C;AAC/C,cAAc,sBAAsB,CAAC;AACrC,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gBAAgB,CAAC;AAC/B,gFAAgF;AAChF,6EAA6E;AAC7E,cAAc,iBAAiB,CAAC;AAEhC,6EAA6E;AAC7E,cAAc,eAAe,CAAC,CAAU,cAAc;AACtD,cAAc,eAAe,CAAC,CAAU,cAAc;AACtD,cAAc,iBAAiB,CAAC,CAAQ,yCAAyC;AACjF,cAAc,oBAAoB,CAAC,CAAK,2CAA2C;AACnF,cAAc,WAAW,CAAC,CAAc,iDAAiD;AACzF,cAAc,WAAW,CAAC,CAAc,6CAA6C;AACrF,cAAc,sBAAsB,CAAC,CAAG,iDAAiD;AACzF,cAAc,aAAa,CAAC,CAAY,oBAAoB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC;;;;;;;;;;;;GAYG;AAEH,8EAA8E;AAC9E,+CAA+C;AAC/C,cAAc,sBAAsB,CAAC;AACrC,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gBAAgB,CAAC;AAC/B,gFAAgF;AAChF,6EAA6E;AAC7E,cAAc,iBAAiB,CAAC;AAEhC,6EAA6E;AAC7E,cAAc,eAAe,CAAC,CAAU,cAAc;AACtD,cAAc,eAAe,CAAC,CAAU,cAAc;AACtD,cAAc,iBAAiB,CAAC,CAAQ,yCAAyC;AACjF,cAAc,oBAAoB,CAAC,CAAK,2CAA2C;AACnF,cAAc,WAAW,CAAC,CAAc,iDAAiD;AACzF,cAAc,WAAW,CAAC,CAAc,6CAA6C;AACrF,cAAc,sBAAsB,CAAC,CAAG,iDAAiD;AACzF,cAAc,aAAa,CAAC,CAAY,oBAAoB;AAC5D,cAAc,eAAe,CAAC,CAAU,6DAA6D"}

package/node_modules/@pome-sh/twin-slack/node_modules/@pome-sh/shared-types/dist/manifest.d.ts

@@ -0,0 +1,31 @@
+import { z } from "zod";
+export declare const SLUG_RE: RegExp;
+export declare const SLUG_MAX_LENGTH = 64;
+export declare function deriveAgentSlug(input: string): string;
+export declare const agentSlugSchema: z.ZodString;
+export declare const manifestAgentSchema: z.ZodObject<{
+    slug: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+    framework: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ManifestAgent = z.infer<typeof manifestAgentSchema>;
+export declare const manifestSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    agent: z.ZodObject<{
+        slug: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+        framework: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    command: z.ZodOptional<z.ZodString>;
+    twins: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    tasks: z.ZodOptional<z.ZodString>;
+    artifacts_dir: z.ZodDefault<z.ZodString>;
+    pass_threshold: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type Manifest = z.infer<typeof manifestSchema>;
+export type ManifestInput = z.input<typeof manifestSchema>;
+export declare function buildManifestJsonSchema(): Record<string, unknown>;

package/node_modules/@pome-sh/twin-slack/node_modules/@pome-sh/shared-types/dist/manifest.js

@@ -0,0 +1,76 @@
+// SPDX-License-Identifier: Apache-2.0
+//
+// shared-types §6 — the pome.json / pome.yaml MANIFEST (F-818, format spec
+// F-804). One canonical zod schema; JSON and YAML are interchangeable carriers
+// of the same snake_case keys (both files present is a hard error at the CLI
+// loader, not here). The `agent` block is the stable cross-carrier identity
+// contract; top-level keys are CLI run-config and may evolve faster.
+//
+// SLUG_RE and deriveAgentSlug are THE slug authority for every consumer (CLI,
+// control-plane /v1/agents, dashboard, MCP). SLUG_RE is byte-identical to the
+// pome-cloud control-plane's regex; deriveAgentSlug is a behavior-identical
+// port of packages/db/src/agent-slug.ts (equivalence pinned in
+// test/manifest.test.ts). pome-cloud imports both from here as of F-820 —
+// local and server validation must never drift again.
+import { z } from "zod";
+// Canonical agent-slug shape: kebab-case, lowercase alphanumerics, no edge or
+// doubled dashes. Length is capped separately (the regex is anchored on shape).
+export const SLUG_RE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+export const SLUG_MAX_LENGTH = 64;
+// Shared agent slug derivation for REST, dashboard, and CLI registration
+// paths. Keep this pure: validation and reserved-slug checks live at each API
+// edge. Returns "" when nothing sluggable remains — callers must check.
+//
+// The first replace collapses every non-alphanumeric run (dashes included) to
+// a single dash, so afterwards each edge carries at most one dash — the
+// anchored single-char strips are exhaustive and stay linear (the upstream
+// `/^-+|-+$/g` form is a CodeQL js/polynomial-redos finding).
+export function deriveAgentSlug(input) {
+    return input
+        .toLowerCase()
+        .trim()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-/, "")
+        .replace(/-$/, "");
+}
+export const agentSlugSchema = z
+    .string()
+    .max(SLUG_MAX_LENGTH)
+    .regex(SLUG_RE, "Agent slug must be kebab-case: lowercase letters, digits, single dashes");
+// The `agent` identity block. `slug` is the only required field in the whole
+// manifest — portable and non-sensitive. The registered `agt_` id is
+// deliberately NOT here: committed opaque ids are the fork-404 bug class; the
+// platform resolver (POST /v1/agents) maps slug → id under the caller's team.
+export const manifestAgentSchema = z.object({
+    slug: agentSlugSchema,
+    name: z.string().min(1).optional(), // display name (server display_name)
+    description: z.string().optional(), // shown on dashboard
+    version: z.string().optional(), // user-declared label; never auto-bumped
+    // Open enum by design: unknown frameworks get a did-you-mean warning at the
+    // consuming edge, never a validation error.
+    framework: z.string().min(1).optional(), // langgraph | claude-agent-sdk | openai-agents | …
+});
+export const manifestSchema = z.object({
+    // pome.json carries the editor pointer; pome.yaml uses a comment instead.
+    $schema: z.string().optional(),
+    agent: manifestAgentSchema,
+    command: z.string().min(1).optional(), // how the CLI launches the agent
+    twins: z.array(z.string().min(1)).min(1).optional(), // default twin set for runs
+    tasks: z.string().min(1).optional(), // task files directory (legacy name: scenarios)
+    artifacts_dir: z.string().min(1).default("runs"),
+    pass_threshold: z.number().int().min(0).max(100).default(100),
+});
+// The JSON Schema served at pome.sh/schemas/v1/pome.json (F-821) and resolved
+// by editors via the manifest's `$schema` pointer. `io: "input"` emits the
+// AUTHOR-side shape — run-config keys with defaults stay optional instead of
+// being promoted to required by the parsed (output) view. Shared by the
+// build-time emitter (scripts/emit-manifest-schema.mjs) and the snapshot test
+// so the two can never disagree.
+export function buildManifestJsonSchema() {
+    return {
+        $id: "https://pome.sh/schemas/v1/pome.json",
+        title: "Pome agent manifest (pome.json / pome.yaml)",
+        ...z.toJSONSchema(manifestSchema, { io: "input" }),
+    };
+}
+//# sourceMappingURL=manifest.js.map

package/node_modules/@pome-sh/twin-slack/node_modules/@pome-sh/shared-types/dist/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"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"}