@petepetrash/circuit 0.1.0

package/dist/flows/registries/compose-writers/registry.js

@@ -0,0 +1,46 @@
+// Registry of compose writers, keyed by output schema name.
+//
+// Builders come from src/flows/catalog.ts via buildComposeRegistry.
+import { buildComposeRegistry } from '../../catalog-derivations.js';
+import { flowPackages } from '../../catalog.js';
+import { flowHasReportSchemaInRuntimeFlow, reportPathForSchemaInRuntimeFlow, } from '../runtime-index.js';
+const REGISTRY = buildComposeRegistry(flowPackages);
+export function findComposeBuilder(resultSchemaName) {
+    return REGISTRY.get(resultSchemaName);
+}
+// Every registered compose builder, keyed by output schema. The compose-reads
+// collision guard enumerates these to prove no required read name shadows a
+// declared input key (mirrors listVerificationWriters for the verification side).
+export function listComposeWriters() {
+    return [...REGISTRY.entries()];
+}
+// Resolve declared reads to run-relative paths and check that each
+// required read is actually present in the compose step's reads
+// list. Required-but-missing throws with the same phrasing the
+// runner used historically so error message stability is preserved.
+// Builders that omit `reads` get an empty inputs map and resolve
+// paths themselves inside build().
+//
+// An optional read whose schema has no producer in this flow resolves to
+// undefined rather than throwing: optional genuinely means the read may be
+// absent, including in reduced flows that omit the producing stage. A
+// required read still demands exactly one producer, and an ambiguous
+// (>1 producer) schema still throws for required and optional alike.
+export function resolveComposeReadPaths(builder, flow, step) {
+    const paths = {};
+    if (builder.reads === undefined)
+        return paths;
+    for (const descriptor of builder.reads) {
+        if (!descriptor.required && !flowHasReportSchemaInRuntimeFlow(flow, descriptor.schema)) {
+            paths[descriptor.name] = undefined;
+            continue;
+        }
+        const path = reportPathForSchemaInRuntimeFlow(flow, descriptor.schema);
+        if (descriptor.required && !step.reads.includes(path)) {
+            throw new Error(`${step.writes.report.schema} requires step '${step.id}' to read ${path}`);
+        }
+        paths[descriptor.name] = step.reads.includes(path) ? path : undefined;
+    }
+    return paths;
+}
+//# sourceMappingURL=registry.js.map

package/dist/flows/registries/compose-writers/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../../src/flows/registries/compose-writers/registry.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,EAAE;AACF,oEAAoE;AAEpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAEL,gCAAgC,EAChC,gCAAgC,GACjC,MAAM,qBAAqB,CAAC;AAG7B,MAAM,QAAQ,GAAG,oBAAoB,CAAC,YAAY,CAAC,CAAC;AAEpD,MAAM,UAAU,kBAAkB,CAAC,gBAAwB;IACzD,OAAO,QAAQ,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;AACxC,CAAC;AAED,8EAA8E;AAC9E,4EAA4E;AAC5E,kFAAkF;AAClF,MAAM,UAAU,kBAAkB;IAChC,OAAO,CAAC,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;AACjC,CAAC;AAED,mEAAmE;AACnE,gEAAgE;AAChE,+DAA+D;AAC/D,oEAAoE;AACpE,iEAAiE;AACjE,mCAAmC;AACnC,EAAE;AACF,yEAAyE;AACzE,2EAA2E;AAC3E,sEAAsE;AACtE,qEAAqE;AACrE,qEAAqE;AACrE,MAAM,UAAU,uBAAuB,CACrC,OAAuB,EACvB,IAAwB,EACxB,IAAiB;IAEjB,MAAM,KAAK,GAAuC,EAAE,CAAC;IACrD,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC9C,KAAK,MAAM,UAAU,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QACvC,IAAI,CAAC,UAAU,CAAC,QAAQ,IAAI,CAAC,gCAAgC,CAAC,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACvF,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;YACnC,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,gCAAgC,CAAC,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;QACvE,IAAI,UAAU,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAa,CAAC,EAAE,CAAC;YAC/D,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,mBAAmB,IAAI,CAAC,EAAE,aAAa,IAAI,EAAE,CAAC,CAAC;QAC7F,CAAC;QACD,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IACjF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/flows/registries/compose-writers/types.d.ts

@@ -0,0 +1,30 @@
+import type { Axes } from '../../../schemas/axes.js';
+import type { LayeredConfig as LayeredConfigValue } from '../../../schemas/config.js';
+import type { PrototypeVariantConnectorPlanner } from '../../../selection/connector-planning.js';
+import type { RuntimeEvidencePolicy } from '../../../shared/relay-runtime-types.js';
+import type { RuntimeIndexedComposeStep, RuntimeIndexedFlow } from '../runtime-index.js';
+export type ComposeStep = RuntimeIndexedComposeStep;
+export interface ComposeReadDescriptor {
+    readonly name: string;
+    readonly schema: string;
+    readonly required: boolean;
+}
+export interface ComposeBuildContext {
+    readonly runFolder: string;
+    readonly flow: RuntimeIndexedFlow;
+    readonly step: ComposeStep;
+    readonly goal: string;
+    readonly axes?: Axes;
+    readonly projectRoot?: string;
+    readonly evidencePolicy?: RuntimeEvidencePolicy;
+    readonly selectionConfigLayers?: readonly LayeredConfigValue[];
+    readonly connectorPlanner?: PrototypeVariantConnectorPlanner;
+    readonly contextDeliveryActive?: boolean;
+    readonly inputs: Record<string, unknown | undefined>;
+}
+export interface ComposeBuilder {
+    readonly resultSchemaName: string;
+    readonly reads?: readonly ComposeReadDescriptor[];
+    build(context: ComposeBuildContext): unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/flows/registries/compose-writers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/flows/registries/compose-writers/types.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,IAAI,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACtF,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,0CAA0C,CAAC;AACjG,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AACpF,OAAO,KAAK,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzF,MAAM,MAAM,WAAW,GAAG,yBAAyB,CAAC;AAOpD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,CAAC,EAAE,qBAAqB,CAAC;IAChD,QAAQ,CAAC,qBAAqB,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC/D,QAAQ,CAAC,gBAAgB,CAAC,EAAE,gCAAgC,CAAC;IAS7D,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAGzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC,CAAC;CACtD;AAED,MAAM,WAAW,cAAc;IAG7B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAGlC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAIlD,KAAK,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC;CAC9C"}

package/dist/flows/registries/compose-writers/types.js

@@ -0,0 +1,22 @@
+// Compose writer registry types.
+//
+// A compose writer turns a schematic's compose step into a
+// schema-validated report. It generalizes the close-writer pattern:
+// every flow's brief, plan, intake, analysis, etc., gets its own
+// builder file under src/flows/<wf>/writers/ and is registered
+// by output schema name on the flow package. The runner relays
+// via the catalog-derived registry — it does not need to know which
+// schemas exist.
+//
+// To add a new flow's compose step, an author writes:
+//   1. The schema for the output report in src/flows/<wf>/reports.ts
+//   2. A ComposeBuilder in src/flows/<wf>/writers/<schema>.ts
+//   3. Register it on the package's `writers.compose`
+//
+// Close-with-evidence has its own registry under
+// src/flows/registries/close-writers/. The two registries are intentionally
+// kept separate because close steps have additional contract concerns
+// (evidence_links, optional reads for mode-conditional inputs)
+// that don't apply to upstream compose steps.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/flows/registries/compose-writers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/flows/registries/compose-writers/types.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,EAAE;AACF,2DAA2D;AAC3D,oEAAoE;AACpE,iEAAiE;AACjE,+DAA+D;AAC/D,+DAA+D;AAC/D,oEAAoE;AACpE,iBAAiB;AACjB,EAAE;AACF,sDAAsD;AACtD,qEAAqE;AACrE,8DAA8D;AAC9D,sDAAsD;AACtD,EAAE;AACF,iDAAiD;AACjD,4EAA4E;AAC5E,sEAAsE;AACtE,+DAA+D;AAC/D,8CAA8C"}

package/dist/flows/registries/cross-report-validators.d.ts

@@ -0,0 +1,10 @@
+import type { RuntimeIndexedFlow } from './runtime-index.js';
+export type CrossReportResult = {
+    readonly kind: 'ok';
+} | {
+    readonly kind: 'fail';
+    readonly reason: string;
+};
+export type CrossReportValidator = (flow: RuntimeIndexedFlow, runFolder: string, resultBody: string) => CrossReportResult;
+export declare function runCrossReportValidator(schemaName: string, flow: RuntimeIndexedFlow, runFolder: string, resultBody: string): CrossReportResult;
+//# sourceMappingURL=cross-report-validators.d.ts.map

package/dist/flows/registries/cross-report-validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-report-validators.d.ts","sourceRoot":"","sources":["../../../src/flows/registries/cross-report-validators.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,MAAM,MAAM,iBAAiB,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;CAAE,GACvB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvD,MAAM,MAAM,oBAAoB,GAAG,CACjC,IAAI,EAAE,kBAAkB,EACxB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,KACf,iBAAiB,CAAC;AAIvB,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,kBAAkB,EACxB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,iBAAiB,CAInB"}

package/dist/flows/registries/cross-report-validators.js

@@ -0,0 +1,31 @@
+// Cross-report validators run after `parseReport` succeeds for a
+// given schema. They enforce constraints that span more than one
+// report and therefore cannot be expressed in the single-report Zod
+// schema.
+//
+// Why a separate registry rather than a Zod superRefine: superRefine
+// only sees the report under validation, not other reports on disk.
+// The validator gets `flow` (to resolve canonical report paths)
+// and `runFolder` (to read previously-written reports).
+//
+// No-rule = pass: an unregistered schema returns `ok` because the
+// catalog has no cross-report constraints declared for it. Registered
+// validators are themselves expected to fail-closed when their required
+// upstream report is missing or malformed — silent omission would
+// re-open the gap each validator exists to close.
+//
+// Co-located on the relay report: each `CompiledFlowRelayReport`
+// optionally carries its own `crossReportValidate`. This makes the
+// invariant "validators only fire on relay-produced reports"
+// structural — there is no other place to attach one. The runtime
+// composes them into a single keyed registry through the catalog.
+import { buildCrossReportValidatorRegistry } from '../catalog-derivations.js';
+import { flowPackages } from '../catalog.js';
+const REGISTRY = buildCrossReportValidatorRegistry(flowPackages);
+export function runCrossReportValidator(schemaName, flow, runFolder, resultBody) {
+    const validator = REGISTRY.get(schemaName);
+    if (validator === undefined)
+        return { kind: 'ok' };
+    return validator(flow, runFolder, resultBody);
+}
+//# sourceMappingURL=cross-report-validators.js.map

package/dist/flows/registries/cross-report-validators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-report-validators.js","sourceRoot":"","sources":["../../../src/flows/registries/cross-report-validators.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,iEAAiE;AACjE,oEAAoE;AACpE,UAAU;AACV,EAAE;AACF,qEAAqE;AACrE,oEAAoE;AACpE,gEAAgE;AAChE,wDAAwD;AACxD,EAAE;AACF,kEAAkE;AAClE,sEAAsE;AACtE,wEAAwE;AACxE,kEAAkE;AAClE,kDAAkD;AAClD,EAAE;AACF,iEAAiE;AACjE,mEAAmE;AACnE,6DAA6D;AAC7D,kEAAkE;AAClE,kEAAkE;AAElE,OAAO,EAAE,iCAAiC,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAa7C,MAAM,QAAQ,GAAG,iCAAiC,CAAC,YAAY,CAAC,CAAC;AAEjE,MAAM,UAAU,uBAAuB,CACrC,UAAkB,EAClB,IAAwB,EACxB,SAAiB,EACjB,UAAkB;IAElB,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC3C,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACnD,OAAO,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;AAChD,CAAC"}

package/dist/flows/registries/report-schemas.d.ts

@@ -0,0 +1,10 @@
+import type { z } from 'zod';
+export type ReportParseResult = {
+    readonly kind: 'ok';
+} | {
+    readonly kind: 'fail';
+    readonly reason: string;
+};
+export declare function findReportZodSchema(schemaName: string): z.ZodType<unknown> | undefined;
+export declare function parseReport(schemaName: string, resultBody: string): ReportParseResult;
+//# sourceMappingURL=report-schemas.d.ts.map

package/dist/flows/registries/report-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-schemas.d.ts","sourceRoot":"","sources":["../../../src/flows/registries/report-schemas.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAe7B,MAAM,MAAM,iBAAiB,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;CAAE,GACvB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAMvD,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,SAAS,CAGtF;AAED,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,iBAAiB,CAkCrF"}

package/dist/flows/registries/report-schemas.js

@@ -0,0 +1,77 @@
+// Relay-report schema registry + parse helper.
+//
+// The REGISTRY is built from src/flows/catalog.ts via
+// buildReportSchemaRegistry, plus the engine-built-in schemas from
+// src/schemas/builtin-report-schemas.ts.
+//
+// Fail-closed default. When `writes.report.schema` names a schema
+// that is NOT present in the registry below, `parseReport` returns
+// a fail result and the runner aborts the step. The contract MUST at
+// src/flows/explore/contract.md does not admit a "schema unknown → pass"
+// path; a future slice that lands a schema authoring surface MUST keep
+// fail-closed as the default for unknown schema names.
+//
+// TraceEntry-surface uniformity. This content/schema-failure path does NOT
+// emit `relay.failed`; that trace_entry is reserved for connector
+// invocation exceptions, where no connector result exists. A parse
+// failure is surfaced through the reject-on-bad-verdict sequence:
+//   check.evaluated outcome=fail (reason=the parse error)
+//   → step.aborted (reason byte-identical)
+//   → run.closed outcome=aborted (reason byte-identical)
+//   → RunResult.reason mirrors the close reason.
+import { BUILTIN_REPORT_SCHEMAS } from '../../schemas/builtin-report-schemas.js';
+import { buildReportSchemaRegistry } from '../catalog-derivations.js';
+import { flowPackages } from '../catalog.js';
+// channels:'relay' on purpose — this registry only parses connector
+// relay result bodies. channel:'report' schemas (compose/close/
+// verification/checkpoint/sub-run reports) are validated by the
+// run-file validator instead; keeping them out of this registry is
+// what makes a channel:'report' name on a relay step fail closed.
+const REGISTRY = buildReportSchemaRegistry(flowPackages, {
+    channels: 'relay',
+    fixtures: BUILTIN_REPORT_SCHEMAS,
+});
+// Resolve the Zod schema for a registered report name, or undefined when
+// the schema is not registered. Used by the relay executor to convert
+// the schema to JSON Schema for connectors that support structured
+// output flags (claude-code's `--json-schema`, codex's `--output-schema`).
+export function findReportZodSchema(schemaName) {
+    if (!Object.hasOwn(REGISTRY, schemaName))
+        return undefined;
+    return REGISTRY[schemaName];
+}
+export function parseReport(schemaName, resultBody) {
+    if (!Object.hasOwn(REGISTRY, schemaName)) {
+        return {
+            kind: 'fail',
+            reason: `report schema '${schemaName}' is not registered in the report-schema registry (fail-closed default)`,
+        };
+    }
+    const schema = REGISTRY[schemaName];
+    let parsed;
+    try {
+        parsed = JSON.parse(resultBody);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return {
+            kind: 'fail',
+            reason: `report body did not parse as JSON against schema '${schemaName}' (${msg})`,
+        };
+    }
+    const result = schema.safeParse(parsed);
+    if (!result.success) {
+        const issueSummary = result.error.issues
+            .map((issue) => {
+            const path = issue.path.length > 0 ? issue.path.join('.') : '<root>';
+            return `${path}: ${issue.message}`;
+        })
+            .join('; ');
+        return {
+            kind: 'fail',
+            reason: `report body did not validate against schema '${schemaName}' (${issueSummary})`,
+        };
+    }
+    return { kind: 'ok' };
+}
+//# sourceMappingURL=report-schemas.js.map

package/dist/flows/registries/report-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-schemas.js","sourceRoot":"","sources":["../../../src/flows/registries/report-schemas.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,EAAE;AACF,sDAAsD;AACtD,mEAAmE;AACnE,yCAAyC;AACzC,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,qEAAqE;AACrE,yEAAyE;AACzE,uEAAuE;AACvE,uDAAuD;AACvD,EAAE;AACF,2EAA2E;AAC3E,kEAAkE;AAClE,mEAAmE;AACnE,kEAAkE;AAClE,0DAA0D;AAC1D,2CAA2C;AAC3C,yDAAyD;AACzD,iDAAiD;AAGjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACjF,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,oEAAoE;AACpE,gEAAgE;AAChE,gEAAgE;AAChE,mEAAmE;AACnE,kEAAkE;AAClE,MAAM,QAAQ,GAAG,yBAAyB,CAAC,YAAY,EAAE;IACvD,QAAQ,EAAE,OAAO;IACjB,QAAQ,EAAE,sBAAsB;CACjC,CAAC,CAAC;AAMH,yEAAyE;AACzE,sEAAsE;AACtE,mEAAmE;AACnE,2EAA2E;AAC3E,MAAM,UAAU,mBAAmB,CAAC,UAAkB;IACpD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC;QAAE,OAAO,SAAS,CAAC;IAC3D,OAAO,QAAQ,CAAC,UAAU,CAAuB,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,UAAkB,EAAE,UAAkB;IAChE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,CAAC;QACzC,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE,kBAAkB,UAAU,yEAAyE;SAC9G,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,QAAQ,CAAC,UAAU,CAAuB,CAAC;IAE1D,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE,qDAAqD,UAAU,MAAM,GAAG,GAAG;SACpF,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM;aACrC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YACb,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;YACrE,OAAO,GAAG,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;QACrC,CAAC,CAAC;aACD,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE,gDAAgD,UAAU,MAAM,YAAY,GAAG;SACxF,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACxB,CAAC"}

package/dist/flows/registries/runtime-index.d.ts

@@ -0,0 +1,100 @@
+import type { AcceptanceCriteria } from '../../schemas/acceptance-criteria.js';
+import type { EquipmentScope } from '../../schemas/equipment-scope.js';
+export interface RuntimeIndexedReportRef {
+    readonly path: string;
+    readonly schema: string;
+}
+export type RuntimeIndexedWrite = string | RuntimeIndexedReportRef | undefined;
+export interface RuntimeIndexedStepBase {
+    readonly id: string;
+    readonly title: string;
+    readonly executor?: string | undefined;
+    readonly protocol: string;
+    readonly reads: readonly string[];
+    readonly routes: Readonly<Record<string, string>>;
+    readonly writes: Readonly<Record<string, RuntimeIndexedWrite>>;
+    readonly check: unknown;
+    readonly selection?: unknown | undefined;
+    readonly skill_slots?: readonly unknown[] | undefined;
+    readonly equipment_scope?: EquipmentScope | undefined;
+    readonly budgets?: unknown | undefined;
+}
+export interface RuntimeIndexedComposeStep extends RuntimeIndexedStepBase {
+    readonly kind: 'compose';
+    readonly writes: RuntimeIndexedStepBase['writes'] & {
+        readonly report: RuntimeIndexedReportRef;
+    };
+}
+export interface RuntimeIndexedVerificationStep extends RuntimeIndexedStepBase {
+    readonly kind: 'verification';
+    readonly writes: RuntimeIndexedStepBase['writes'] & {
+        readonly report: RuntimeIndexedReportRef;
+    };
+}
+export interface RuntimeIndexedCheckpointStep extends RuntimeIndexedStepBase {
+    readonly kind: 'checkpoint';
+    readonly policy: {
+        readonly prompt: string;
+        readonly choices?: readonly {
+            readonly id: string;
+            readonly label?: string | undefined;
+            readonly description?: string | undefined;
+        }[] | undefined;
+        readonly choices_from?: unknown | undefined;
+        readonly safe_default_choice?: string | undefined;
+        readonly report_template?: unknown | undefined;
+    };
+    readonly writes: RuntimeIndexedStepBase['writes'] & {
+        readonly request: string;
+        readonly response: string;
+        readonly report?: RuntimeIndexedReportRef | undefined;
+    };
+}
+export interface RuntimeIndexedRelayStep extends RuntimeIndexedStepBase {
+    readonly kind: 'relay';
+    readonly role: 'researcher' | 'implementer' | 'reviewer';
+    readonly connector?: string | undefined;
+    readonly acceptance_criteria?: AcceptanceCriteria | undefined;
+    readonly check: {
+        readonly kind?: string | undefined;
+        readonly source?: unknown | undefined;
+        readonly pass: readonly string[];
+    };
+    readonly writes: RuntimeIndexedStepBase['writes'] & {
+        readonly request: string;
+        readonly receipt: string;
+        readonly result: string;
+        readonly report?: RuntimeIndexedReportRef | undefined;
+    };
+}
+export interface RuntimeIndexedSubRunStep extends RuntimeIndexedStepBase {
+    readonly kind: 'sub-run';
+}
+export interface RuntimeIndexedFanoutStep extends RuntimeIndexedStepBase {
+    readonly kind: 'fanout';
+}
+export type RuntimeIndexedStep = RuntimeIndexedComposeStep | RuntimeIndexedVerificationStep | RuntimeIndexedCheckpointStep | RuntimeIndexedRelayStep | RuntimeIndexedSubRunStep | RuntimeIndexedFanoutStep;
+export interface RuntimeIndexedFlow {
+    readonly id: string;
+    readonly version: string;
+    readonly purpose?: string | undefined;
+    readonly default_selection?: SelectionOverrideValue | undefined;
+    readonly stages: readonly {
+        readonly id: string;
+        readonly steps: readonly string[];
+        readonly selection?: SelectionOverrideValue | undefined;
+    }[];
+    readonly steps: readonly RuntimeIndexedStep[];
+}
+export interface RuntimePackageIndex {
+    readonly flow: RuntimeIndexedFlow;
+    readonly stepsById: ReadonlyMap<string, RuntimeIndexedStep>;
+    readonly reportPathBySchema: ReadonlyMap<string, string>;
+}
+export declare function requireRuntimeIndexedStep<Kind extends RuntimeIndexedStep['kind']>(index: RuntimePackageIndex, stepId: string, kind: Kind): Extract<RuntimeIndexedStep, {
+    readonly kind: Kind;
+}>;
+export declare function reportPathForSchemaInRuntimeFlow(flow: RuntimeIndexedFlow, schemaName: string): string;
+export declare function flowHasReportSchemaInRuntimeFlow(flow: RuntimeIndexedFlow, schemaName: string): boolean;
+import type { SelectionOverride as SelectionOverrideValue } from '../../schemas/selection-policy.js';
+//# sourceMappingURL=runtime-index.d.ts.map

package/dist/flows/registries/runtime-index.d.ts.map

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

package/dist/flows/registries/runtime-index.js

@@ -0,0 +1,27 @@
+export function requireRuntimeIndexedStep(index, stepId, kind) {
+    const indexedStep = index.stepsById.get(stepId);
+    if (indexedStep === undefined) {
+        throw new Error(`runtime package index has no step '${stepId}'`);
+    }
+    if (indexedStep.kind !== kind) {
+        throw new Error(`runtime package index step '${stepId}' has kind '${indexedStep.kind}', expected '${kind}'`);
+    }
+    return indexedStep;
+}
+export function reportPathForSchemaInRuntimeFlow(flow, schemaName) {
+    const matches = flow.steps.flatMap((step) => Object.values(step.writes).flatMap((write) => typeof write === 'object' && write !== null && write.schema === schemaName
+        ? [{ step, write }]
+        : []));
+    if (matches.length !== 1) {
+        throw new Error(`expected exactly one report writer for schema '${schemaName}', found ${matches.length}`);
+    }
+    const report = matches[0]?.write;
+    if (typeof report !== 'object' || report === null) {
+        throw new Error(`report writer for schema '${schemaName}' is missing a report path`);
+    }
+    return report.path;
+}
+export function flowHasReportSchemaInRuntimeFlow(flow, schemaName) {
+    return flow.steps.some((step) => Object.values(step.writes).some((write) => typeof write === 'object' && write !== null && write.schema === schemaName));
+}
+//# sourceMappingURL=runtime-index.js.map

package/dist/flows/registries/runtime-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-index.js","sourceRoot":"","sources":["../../../src/flows/registries/runtime-index.ts"],"names":[],"mappings":"AAkHA,MAAM,UAAU,yBAAyB,CACvC,KAA0B,EAC1B,MAAc,EACd,IAAU;IAEV,MAAM,WAAW,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAChD,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,sCAAsC,MAAM,GAAG,CAAC,CAAC;IACnE,CAAC;IACD,IAAI,WAAW,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACb,+BAA+B,MAAM,eAAe,WAAW,CAAC,IAAI,gBAAgB,IAAI,GAAG,CAC5F,CAAC;IACJ,CAAC;IACD,OAAO,WAAmE,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,gCAAgC,CAC9C,IAAwB,EACxB,UAAkB;IAElB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAC1C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAC3C,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,MAAM,KAAK,UAAU;QACxE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;QACnB,CAAC,CAAC,EAAE,CACP,CACF,CAAC;IACF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,kDAAkD,UAAU,YAAY,OAAO,CAAC,MAAM,EAAE,CACzF,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC;IACjC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,6BAA6B,UAAU,4BAA4B,CAAC,CAAC;IACvF,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,gCAAgC,CAC9C,IAAwB,EACxB,UAAkB;IAElB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAC9B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAC7B,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,MAAM,KAAK,UAAU,CACtF,CACF,CAAC;AACJ,CAAC"}

package/dist/flows/registries/shape-hints/from-zod.d.ts

@@ -0,0 +1,6 @@
+import type * as z4 from 'zod/v4/core';
+type ZodSchema = z4.$ZodType;
+export declare function renderShapeSkeleton(schema: ZodSchema): string;
+export declare function verdictValuesFromSchema(schema: ZodSchema): readonly string[];
+export {};
+//# sourceMappingURL=from-zod.d.ts.map

package/dist/flows/registries/shape-hints/from-zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"from-zod.d.ts","sourceRoot":"","sources":["../../../../src/flows/registries/shape-hints/from-zod.ts"],"names":[],"mappings":"AAmCA,OAAO,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAEvC,KAAK,SAAS,GAAG,EAAE,CAAC,QAAQ,CAAC;AA0I7B,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAE7D;AAOD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,MAAM,EAAE,CAI5E"}