pome-sh 0.6.6

package/node_modules/@pome-sh/shared-types/dist/run.d.ts

@@ -0,0 +1,201 @@
+/**
+ * run — completed-run shape, criterion result, lane/step correlator output
+ *
+ * Consumed by:
+ *   - `@pome-sh/evaluator` — produces CriterionResult, satisfaction_score
+ *   - `@pome-sh/correlator` — produces `{ lanes, steps }` from RecorderEvent[]
+ *   - `pome-cloud` `runs` table writer — persists the full Run row
+ *   - dashboard `/runs/:id` — renders lane-timeline + state-inspector + handoff card
+ *
+ * Lane/Step are flat parallel arrays on Run (not nested), aligning with the
+ * `runs.lanes jsonb` + `runs.steps jsonb` two-column DB shape from FDRS-327.
+ * Cross-reference: `Lane.step_id` → `Step.id`; `Lane.request_ids[]` →
+ * `RecorderEvent.request_id`.
+ */
+import { z } from "zod";
+export declare const judgeModelSchema: z.ZodString;
+export type JudgeModel = z.infer<typeof judgeModelSchema>;
+export declare const correlatorKindSchema: z.ZodEnum<{
+    heuristic: "heuristic";
+    adapter_rich: "adapter_rich";
+    span_context: "span_context";
+}>;
+export type CorrelatorKind = z.infer<typeof correlatorKindSchema>;
+export declare const CRITERION_KINDS: readonly ["code", "model"];
+export declare const criterionKindSchema: z.ZodEnum<{
+    model: "model";
+    code: "code";
+}>;
+export type CriterionKind = z.infer<typeof criterionKindSchema>;
+export declare const criterionSchema: z.ZodObject<{
+    type: z.ZodPipe<z.ZodEnum<{
+        model: "model";
+        code: "code";
+        D: "D";
+        P: "P";
+    }>, z.ZodTransform<"model" | "code", "model" | "code" | "D" | "P">>;
+    text: z.ZodString;
+}, z.core.$strip>;
+export type Criterion = z.infer<typeof criterionSchema>;
+export declare const deterministicCriterionResultSchema: z.ZodObject<{
+    criterion: z.ZodObject<{
+        type: z.ZodPipe<z.ZodEnum<{
+            model: "model";
+            code: "code";
+            D: "D";
+            P: "P";
+        }>, z.ZodTransform<"model" | "code", "model" | "code" | "D" | "P">>;
+        text: z.ZodString;
+    }, z.core.$strip>;
+    passed: z.ZodBoolean;
+    skipped: z.ZodBoolean;
+    reason: z.ZodString;
+}, z.core.$strip>;
+export type DeterministicCriterionResult = z.infer<typeof deterministicCriterionResultSchema>;
+export declare const probabilisticCriterionResultSchema: z.ZodObject<{
+    criterion: z.ZodObject<{
+        type: z.ZodPipe<z.ZodEnum<{
+            model: "model";
+            code: "code";
+            D: "D";
+            P: "P";
+        }>, z.ZodTransform<"model" | "code", "model" | "code" | "D" | "P">>;
+        text: z.ZodString;
+    }, z.core.$strip>;
+    passed: z.ZodBoolean;
+    skipped: z.ZodBoolean;
+    reason: z.ZodString;
+    confidence: z.ZodNumber;
+    judge_model: z.ZodString;
+}, z.core.$strip>;
+export type ProbabilisticCriterionResult = z.infer<typeof probabilisticCriterionResultSchema>;
+export declare const criterionResultSchema: z.ZodUnion<readonly [z.ZodObject<{
+    criterion: z.ZodObject<{
+        type: z.ZodPipe<z.ZodEnum<{
+            model: "model";
+            code: "code";
+            D: "D";
+            P: "P";
+        }>, z.ZodTransform<"model" | "code", "model" | "code" | "D" | "P">>;
+        text: z.ZodString;
+    }, z.core.$strip>;
+    passed: z.ZodBoolean;
+    skipped: z.ZodBoolean;
+    reason: z.ZodString;
+    confidence: z.ZodNumber;
+    judge_model: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    criterion: z.ZodObject<{
+        type: z.ZodPipe<z.ZodEnum<{
+            model: "model";
+            code: "code";
+            D: "D";
+            P: "P";
+        }>, z.ZodTransform<"model" | "code", "model" | "code" | "D" | "P">>;
+        text: z.ZodString;
+    }, z.core.$strip>;
+    passed: z.ZodBoolean;
+    skipped: z.ZodBoolean;
+    reason: z.ZodString;
+}, z.core.$strip>]>;
+export type CriterionResult = z.infer<typeof criterionResultSchema>;
+export declare const stepSchema: z.ZodObject<{
+    id: z.ZodString;
+    started_at: z.ZodString;
+    ended_at: z.ZodString;
+    label: z.ZodNullable<z.ZodString>;
+    lane_ids: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type Step = z.infer<typeof stepSchema>;
+export declare const laneSchema: z.ZodObject<{
+    id: z.ZodString;
+    step_id: z.ZodString;
+    twin: z.ZodString;
+    label: z.ZodNullable<z.ZodString>;
+    request_ids: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type Lane = z.infer<typeof laneSchema>;
+export declare const runSchema: z.ZodPreprocess<z.ZodObject<{
+    id: z.ZodString;
+    session_id: z.ZodString;
+    team_id: z.ZodString;
+    task_name: z.ZodString;
+    task_hash: z.ZodString;
+    satisfaction_score: z.ZodNumber;
+    criteria_results: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        criterion: z.ZodObject<{
+            type: z.ZodPipe<z.ZodEnum<{
+                model: "model";
+                code: "code";
+                D: "D";
+                P: "P";
+            }>, z.ZodTransform<"model" | "code", "model" | "code" | "D" | "P">>;
+            text: z.ZodString;
+        }, z.core.$strip>;
+        passed: z.ZodBoolean;
+        skipped: z.ZodBoolean;
+        reason: z.ZodString;
+        confidence: z.ZodNumber;
+        judge_model: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        criterion: z.ZodObject<{
+            type: z.ZodPipe<z.ZodEnum<{
+                model: "model";
+                code: "code";
+                D: "D";
+                P: "P";
+            }>, z.ZodTransform<"model" | "code", "model" | "code" | "D" | "P">>;
+            text: z.ZodString;
+        }, z.core.$strip>;
+        passed: z.ZodBoolean;
+        skipped: z.ZodBoolean;
+        reason: z.ZodString;
+    }, z.core.$strip>]>>;
+    trace_s3_key: z.ZodNullable<z.ZodString>;
+    state_s3_key: z.ZodNullable<z.ZodString>;
+    meta_s3_key: z.ZodNullable<z.ZodString>;
+    duration_ms: z.ZodNumber;
+    agent_model: z.ZodString;
+    judge_model: z.ZodString;
+    judge_tokens_in: z.ZodNullable<z.ZodNumber>;
+    judge_tokens_out: z.ZodNullable<z.ZodNumber>;
+    agent_tokens_in: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    agent_tokens_out: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    agent_latency_p50_ms: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    agent_latency_p95_ms: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    agent_latency_max_ms: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    agent_error_count: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    agent_telemetry_span_count: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    correlator_kind: z.ZodDefault<z.ZodEnum<{
+        heuristic: "heuristic";
+        adapter_rich: "adapter_rich";
+        span_context: "span_context";
+    }>>;
+    environment: z.ZodDefault<z.ZodEnum<{
+        production: "production";
+        simulation: "simulation";
+    }>>;
+    promoted_task_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    replay_run_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    state_archive_s3_key: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    lanes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        step_id: z.ZodString;
+        twin: z.ZodString;
+        label: z.ZodNullable<z.ZodString>;
+        request_ids: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>>;
+    steps: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        started_at: z.ZodString;
+        ended_at: z.ZodString;
+        label: z.ZodNullable<z.ZodString>;
+        lane_ids: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>>;
+    summary: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    fix_prompt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    events_jsonl_url: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    created_at: z.ZodString;
+    finished_at: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>>;
+export type Run = z.infer<typeof runSchema>;

package/node_modules/@pome-sh/shared-types/dist/run.js

@@ -0,0 +1,166 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * run — completed-run shape, criterion result, lane/step correlator output
+ *
+ * Consumed by:
+ *   - `@pome-sh/evaluator` — produces CriterionResult, satisfaction_score
+ *   - `@pome-sh/correlator` — produces `{ lanes, steps }` from RecorderEvent[]
+ *   - `pome-cloud` `runs` table writer — persists the full Run row
+ *   - dashboard `/runs/:id` — renders lane-timeline + state-inspector + handoff card
+ *
+ * Lane/Step are flat parallel arrays on Run (not nested), aligning with the
+ * `runs.lanes jsonb` + `runs.steps jsonb` two-column DB shape from FDRS-327.
+ * Cross-reference: `Lane.step_id` → `Step.id`; `Lane.request_ids[]` →
+ * `RecorderEvent.request_id`.
+ */
+import { z } from "zod";
+import { twinIdSchema } from "./recorder-events.js";
+import { LEGACY_CRITERION_KIND_MAP, normalizeTaskVocabKeys } from "./task-vocab.js";
+// Judge model is a free-form string (BYOK Flavor #1, OpenAI-compatible endpoint
+// passes through); not constrained at the schema level because the customer's
+// gateway decides what model identifiers it accepts.
+export const judgeModelSchema = z.string().min(1);
+// Which server-side correlator produced a run's lanes/steps. Reconciled from
+// pome-cloud /v1 (FDRS-613): OTEL M4/M6 clients distinguish heuristic legacy
+// timelines from exact span-context timelines.
+export const correlatorKindSchema = z.enum([
+    "heuristic",
+    "adapter_rich",
+    "span_context",
+]);
+// Criterion kind — W3 vocab (FDRS-653): `code` = deterministic/code-checked
+// predicate (formerly `D`), `model` = LLM-judged (formerly `P`). The canonical
+// enum is `code | model`; the INPUT schema below additionally accepts the
+// 0.3.0-era `D` / `P` spellings and normalizes them at parse time (tolerant
+// reader — shipped CLIs vendor 0.3.0 and keep sending D/P).
+export const CRITERION_KINDS = ["code", "model"];
+export const criterionKindSchema = z.enum(CRITERION_KINDS);
+// Single source of truth for the D/P→code/model rename is
+// LEGACY_CRITERION_KIND_MAP in ./task-vocab.ts.
+const criterionKindInputSchema = z
+    .enum(["D", "P", "code", "model"])
+    .transform((kind) => kind === "D" || kind === "P" ? LEGACY_CRITERION_KIND_MAP[kind] : kind);
+export const criterionSchema = z.object({
+    // Accepts D | P | code | model; parsed output is always code | model.
+    type: criterionKindInputSchema,
+    text: z.string().min(1),
+});
+// CriterionResult shape matches OSS evaluator's emit. The full Criterion is
+// included by reference (not just text) so consumers render type-aware UI
+// without rejoining. Discriminate on `criterion.type` (no separate `kind`
+// field) — normalized to `code` / `model` (0.3.0 artifacts carrying `D` / `P`
+// parse and normalize).
+const baseCriterionResultSchema = z.object({
+    criterion: criterionSchema, // full {type, text} object
+    passed: z.boolean(),
+    skipped: z.boolean(), // true if [code] fell back to [model] but the judge was unreachable, etc.
+    reason: z.string(), // human-readable evidence
+});
+export const deterministicCriterionResultSchema = baseCriterionResultSchema.extend({
+// [code] adds nothing further; criterion.type === "code" identifies it.
+});
+export const probabilisticCriterionResultSchema = baseCriterionResultSchema.extend({
+    confidence: z.number().min(0).max(1),
+    judge_model: judgeModelSchema,
+});
+// Probabilistic FIRST: it's the strict superset (requires confidence +
+// judge_model). z.union tries branches in order and picks the first match.
+// If deterministic were first, [model] payloads would parse cleanly but
+// .extend({}) would silently strip the [model]-only fields — we'd persist them
+// as null in runs.criteria_results JSON, breaking dashboard rendering of
+// confidence + per-criterion judge_model. [code] payloads (no confidence /
+// judge_model) fail probabilistic on the required fields and fall through.
+export const criterionResultSchema = z.union([
+    probabilisticCriterionResultSchema,
+    deterministicCriterionResultSchema,
+]);
+// Step is the correlator's top-level grouping: one Step per agent assistant
+// turn (adapter-rich path) or per heuristic-clustered HTTP burst (heuristic
+// path). started_at/ended_at bound the contained events. label is null when
+// heuristic-only (no assistant message to seed it from).
+export const stepSchema = z.object({
+    id: z.string(), // matches RecorderEvent.step_id
+    started_at: z.string().datetime(),
+    ended_at: z.string().datetime(),
+    label: z.string().nullable(),
+    lane_ids: z.array(z.string()), // child lanes, render order
+});
+// Lane is the correlator's per-step sub-grouping by twin + endpoint pattern.
+// One lane = one horizontal track in lane-timeline UI. request_ids reference
+// RecorderEvent.request_id back into events.jsonl (events are the source of
+// truth; Lane just records which events belong here, time-ordered).
+export const laneSchema = z.object({
+    id: z.string(),
+    step_id: z.string(), // parent Step.id
+    twin: twinIdSchema, // matches RecorderEvent.twin
+    label: z.string().nullable(), // e.g. "POST /v1/refunds (3 calls)"
+    request_ids: z.array(z.string()), // RecorderEvent.request_id, time-ordered
+});
+// Canonical Run row. W3 vocab (FDRS-653): `task_name` / `task_hash` /
+// `promoted_task_id` are the canonical wire keys (cloud DB: `tasks` table,
+// `runs.task_name`). The exported `runSchema` below wraps this object in the
+// tolerant-reader preprocess so 0.3.0-era rows carrying `scenario_name` /
+// `scenario_hash` / `promoted_scenario_id` parse and normalize.
+const runObjectSchema = z.object({
+    id: z.string(), // run_<nanoid>
+    session_id: z.string(),
+    team_id: z.string(),
+    task_name: z.string(), // 0.3.0 alias: scenario_name
+    task_hash: z.string(), // sha256 of source markdown; 0.3.0 alias: scenario_hash
+    satisfaction_score: z.number().int().min(0).max(100), // CLI-computed (BYOK Flavor #1)
+    criteria_results: z.array(criterionResultSchema),
+    trace_s3_key: z.string().nullable(), // s3 key for tool_calls.jsonl (hosted only)
+    state_s3_key: z.string().nullable(), // s3 key for state_final.json
+    meta_s3_key: z.string().nullable(),
+    duration_ms: z.number().int(),
+    agent_model: z.string(), // which model the agent used (informational)
+    judge_model: judgeModelSchema, // which model judged [P] (free-form)
+    judge_tokens_in: z.number().int().min(0).nullable(),
+    judge_tokens_out: z.number().int().min(0).nullable(),
+    // ── FDRS-613: reconciled from pome-cloud /v1 wire truth (all additive with
+    // defaults so pre-existing Run constructors stay valid) ────────────────────
+    // Sim deep-telemetry — per-run agent telemetry rollup, computed at finalize
+    // from the agent's independently-correlated `gen_ai` span tree. Null = no
+    // instrumentation / legacy / twin-only sim (dashboard renders `·`, never `0`).
+    agent_tokens_in: z.number().int().min(0).nullable().default(null),
+    agent_tokens_out: z.number().int().min(0).nullable().default(null),
+    agent_latency_p50_ms: z.number().int().min(0).nullable().default(null),
+    agent_latency_p95_ms: z.number().int().min(0).nullable().default(null),
+    agent_latency_max_ms: z.number().int().min(0).nullable().default(null),
+    agent_error_count: z.number().int().min(0).nullable().default(null),
+    agent_telemetry_span_count: z.number().int().min(0).nullable().default(null),
+    // Which server-side correlator produced lanes/steps.
+    correlator_kind: correlatorKindSchema.default("heuristic"),
+    // M0.2 (FDRS-509) — which surface this run belongs to. 'simulation' =
+    // CLI/staging scenario run (default for every legacy row); 'production' = an
+    // ingested OTLP production trace (M2).
+    environment: z.enum(["production", "simulation"]).default("simulation"),
+    // M0.5 (FDRS-512) — replay loop linkage (prod-run → task → replay-run).
+    // W3 vocab: canonical key; 0.3.0 alias: promoted_scenario_id.
+    promoted_task_id: z.string().nullable().default(null),
+    replay_run_id: z.string().nullable().default(null),
+    // Storage key for the tar-and-upload state archive the replay engine seeds a
+    // sandbox from. Null when no archive was captured.
+    state_archive_s3_key: z.string().nullable().default(null),
+    // Correlator output. Empty arrays for legacy runs (pre-M3i / pre-M4-1).
+    lanes: z.array(laneSchema).default([]),
+    steps: z.array(stepSchema).default([]),
+    // Server-generated by the managed judge (ADR-013). 1-2 sentence concise
+    // narrative of the run. Null for pre-ADR-013 rows / legacy /result runs.
+    summary: z.string().nullable().default(null),
+    // Originally CLI-generated (BYOK Flavor #1). Null on --no-fix-prompt opt-out,
+    // LLM endpoint failure, or legacy pre-M4-1 runs.
+    fix_prompt: z.string().nullable().default(null),
+    // Storage KEY (path) of the raw events.jsonl blob — NOT a URL (dashboard mints
+    // a signed GET URL on read). FDRS-613: relaxed from `.url()` to match the
+    // pome-cloud shape, since persisted storage keys are not URLs. Null in
+    // self-host mode, on upload failure, --no-upload opt-out, or legacy runs.
+    events_jsonl_url: z.string().nullable().default(null),
+    created_at: z.string().datetime(),
+    finished_at: z.string().datetime().nullable(),
+});
+// Tolerant reader (FDRS-653): accepts both the 0.3.0 `scenario_*` and the
+// canonical `task_*` keys and normalizes to the new vocabulary. When both are
+// present, the canonical key wins. The parsed output carries `task_*` only.
+export const runSchema = z.preprocess(normalizeTaskVocabKeys, runObjectSchema);
+//# sourceMappingURL=run.js.map

package/node_modules/@pome-sh/shared-types/dist/run.js.map

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

package/node_modules/@pome-sh/shared-types/dist/task-vocab.d.ts

@@ -0,0 +1,66 @@
+/**
+ * task-vocab — the W3 "scenario → task" wire-vocabulary rename (FDRS-653).
+ *
+ * W3 decision (binding, 2026-06): everything "scenario" becomes "task" on the
+ * wire, and criterion kinds `D` / `P` become `code` / `model`. The cloud DB is
+ * already renamed (`tasks` table, `runs.task_name`); this module gives the
+ * shared trace format the same vocabulary WITHOUT breaking 0.3.0-era artifacts.
+ *
+ * Tolerant-reader contract (the 0.3.0 compatibility window):
+ *   - Canonical schemas and types use the NEW vocabulary only
+ *     (`task_name`, `task_hash`, `task_source`, `task_id`, `promoted_task_id`,
+ *     `task_step_id`, criterion kind `code` / `model`).
+ *   - Readers accept BOTH the old and the new keys and normalize to the new
+ *     vocabulary at parse time. Nothing a 0.3.0-era artifact contains becomes
+ *     invalid: shipped CLIs vendor shared-types 0.3.0 and keep sending
+ *     `scenario_*` keys and `D` / `P` criterion kinds for at least one more
+ *     release train (the CLI vendored-tarball bump rides FDRS-654/657).
+ *   - When BOTH keys are present, the new key wins (a 0.5.0-aware writer is
+ *     more authoritative about the canonical field than a mirrored legacy key).
+ *
+ * The window closes with the next major once no supported CLI emits the old
+ * vocabulary; removal of the aliases goes through the deprecation policy.
+ */
+/**
+ * Old wire key → canonical wire key for the RENAME-on-read surfaces of the
+ * /v1 contract (run / session / result wire objects):
+ *   - `scenario_name` / `scenario_hash`   — Run rows + POST /v1/sessions/{id}/result
+ *   - `scenario_source` / `scenario_id`   — POST /v1/sessions
+ *   - `promoted_scenario_id`              — Run rows (M0.5 replay-loop linkage)
+ *
+ * DELIBERATELY NOT in this map: `scenario_step_id` on RecorderEvent rows
+ * (events.jsonl). The frozen v1 event row has PRESERVE semantics — the legacy
+ * key stays as-sent while readers additionally populate `task_step_id` — which
+ * is handled by the reader schemas in `./recorder-events.ts`, NOT by this
+ * delete-the-legacy-key map.
+ */
+export declare const LEGACY_TASK_VOCAB_KEY_MAP: {
+    readonly scenario_name: "task_name";
+    readonly scenario_hash: "task_hash";
+    readonly scenario_source: "task_source";
+    readonly scenario_id: "task_id";
+    readonly promoted_scenario_id: "promoted_task_id";
+};
+/**
+ * Rename legacy `scenario_*` keys on a raw wire object to their canonical
+ * `task_*` names. Non-objects pass through untouched (the wrapped schema then
+ * reports the real type error). When both the legacy and the canonical key are
+ * present the canonical value wins and the legacy key is dropped.
+ *
+ * Used as a `z.preprocess` step in front of the canonical object schemas —
+ * this is the "tolerant reader" half of the 0.3.0 compatibility window.
+ *
+ * DO NOT apply this helper to recorder-event rows (events.jsonl). Event rows
+ * require `scenario_step_id` preserved as-sent (frozen v1 trace format), and
+ * this function's rename-and-delete semantics would strip that step linkage
+ * if the key were mapped. `scenario_step_id` is intentionally absent from
+ * `LEGACY_TASK_VOCAB_KEY_MAP`, so this function leaves it intact — event-row
+ * normalization lives in `recorderEventSchema` / `eventSchema`
+ * (`./recorder-events.ts`).
+ */
+export declare function normalizeTaskVocabKeys(value: unknown): unknown;
+/** Legacy criterion kind → canonical criterion kind (W3: D→code, P→model). */
+export declare const LEGACY_CRITERION_KIND_MAP: {
+    readonly D: "code";
+    readonly P: "model";
+};

package/node_modules/@pome-sh/shared-types/dist/task-vocab.js

@@ -0,0 +1,84 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * task-vocab — the W3 "scenario → task" wire-vocabulary rename (FDRS-653).
+ *
+ * W3 decision (binding, 2026-06): everything "scenario" becomes "task" on the
+ * wire, and criterion kinds `D` / `P` become `code` / `model`. The cloud DB is
+ * already renamed (`tasks` table, `runs.task_name`); this module gives the
+ * shared trace format the same vocabulary WITHOUT breaking 0.3.0-era artifacts.
+ *
+ * Tolerant-reader contract (the 0.3.0 compatibility window):
+ *   - Canonical schemas and types use the NEW vocabulary only
+ *     (`task_name`, `task_hash`, `task_source`, `task_id`, `promoted_task_id`,
+ *     `task_step_id`, criterion kind `code` / `model`).
+ *   - Readers accept BOTH the old and the new keys and normalize to the new
+ *     vocabulary at parse time. Nothing a 0.3.0-era artifact contains becomes
+ *     invalid: shipped CLIs vendor shared-types 0.3.0 and keep sending
+ *     `scenario_*` keys and `D` / `P` criterion kinds for at least one more
+ *     release train (the CLI vendored-tarball bump rides FDRS-654/657).
+ *   - When BOTH keys are present, the new key wins (a 0.5.0-aware writer is
+ *     more authoritative about the canonical field than a mirrored legacy key).
+ *
+ * The window closes with the next major once no supported CLI emits the old
+ * vocabulary; removal of the aliases goes through the deprecation policy.
+ */
+/**
+ * Old wire key → canonical wire key for the RENAME-on-read surfaces of the
+ * /v1 contract (run / session / result wire objects):
+ *   - `scenario_name` / `scenario_hash`   — Run rows + POST /v1/sessions/{id}/result
+ *   - `scenario_source` / `scenario_id`   — POST /v1/sessions
+ *   - `promoted_scenario_id`              — Run rows (M0.5 replay-loop linkage)
+ *
+ * DELIBERATELY NOT in this map: `scenario_step_id` on RecorderEvent rows
+ * (events.jsonl). The frozen v1 event row has PRESERVE semantics — the legacy
+ * key stays as-sent while readers additionally populate `task_step_id` — which
+ * is handled by the reader schemas in `./recorder-events.ts`, NOT by this
+ * delete-the-legacy-key map.
+ */
+export const LEGACY_TASK_VOCAB_KEY_MAP = {
+    scenario_name: "task_name",
+    scenario_hash: "task_hash",
+    scenario_source: "task_source",
+    scenario_id: "task_id",
+    promoted_scenario_id: "promoted_task_id",
+};
+/**
+ * Rename legacy `scenario_*` keys on a raw wire object to their canonical
+ * `task_*` names. Non-objects pass through untouched (the wrapped schema then
+ * reports the real type error). When both the legacy and the canonical key are
+ * present the canonical value wins and the legacy key is dropped.
+ *
+ * Used as a `z.preprocess` step in front of the canonical object schemas —
+ * this is the "tolerant reader" half of the 0.3.0 compatibility window.
+ *
+ * DO NOT apply this helper to recorder-event rows (events.jsonl). Event rows
+ * require `scenario_step_id` preserved as-sent (frozen v1 trace format), and
+ * this function's rename-and-delete semantics would strip that step linkage
+ * if the key were mapped. `scenario_step_id` is intentionally absent from
+ * `LEGACY_TASK_VOCAB_KEY_MAP`, so this function leaves it intact — event-row
+ * normalization lives in `recorderEventSchema` / `eventSchema`
+ * (`./recorder-events.ts`).
+ */
+export function normalizeTaskVocabKeys(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return value;
+    }
+    const record = value;
+    let out = null;
+    for (const [legacyKey, canonicalKey] of Object.entries(LEGACY_TASK_VOCAB_KEY_MAP)) {
+        if (legacyKey in record) {
+            out ??= { ...record };
+            if (!(canonicalKey in record)) {
+                out[canonicalKey] = record[legacyKey];
+            }
+            delete out[legacyKey];
+        }
+    }
+    return out ?? value;
+}
+/** Legacy criterion kind → canonical criterion kind (W3: D→code, P→model). */
+export const LEGACY_CRITERION_KIND_MAP = {
+    D: "code",
+    P: "model",
+};
+//# sourceMappingURL=task-vocab.js.map

package/node_modules/@pome-sh/shared-types/dist/task-vocab.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-vocab.js","sourceRoot":"","sources":["../src/task-vocab.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,aAAa,EAAE,WAAW;IAC1B,aAAa,EAAE,WAAW;IAC1B,eAAe,EAAE,aAAa;IAC9B,WAAW,EAAE,SAAS;IACtB,oBAAoB,EAAE,kBAAkB;CAChC,CAAC;AAEX;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACnD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,IAAI,GAAG,GAAmC,IAAI,CAAC;IAC/C,KAAK,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,yBAAyB,CAAC,EAAE,CAAC;QAClF,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;YACxB,GAAG,KAAK,EAAE,GAAG,MAAM,EAAE,CAAC;YACtB,IAAI,CAAC,CAAC,YAAY,IAAI,MAAM,CAAC,EAAE,CAAC;gBAC9B,GAAG,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;YACxC,CAAC;YACD,OAAO,GAAG,CAAC,SAAS,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,IAAI,KAAK,CAAC;AACtB,CAAC;AAED,8EAA8E;AAC9E,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,CAAC,EAAE,MAAM;IACT,CAAC,EAAE,OAAO;CACF,CAAC"}

package/node_modules/@pome-sh/shared-types/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@pome-sh/shared-types",
+  "version": "0.6.0",
+  "private": false,
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "package.json"
+  ],
+  "scripts": {
+    "build:runtime": "tsc -p tsconfig.runtime.json",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "build": "tsc -p tsconfig.build.json",
+    "prepublishOnly": "tsc -p tsconfig.build.json"
+  },
+  "peerDependencies": {
+    "zod": "^4.1.13"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.3",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.15",
+    "zod": "^4.1.13"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "pomeCloudRepack": "dist rebuilt from src + entry points remapped src->dist by pome-cloud scripts/repack-shared-types-tarball.ts (FDRS-654)"
+}