@petepetrash/circuit 0.1.0

package/dist/runtime/run-files/report-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-validator.d.ts","sourceRoot":"","sources":["../../../src/runtime/run-files/report-validator.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,eAAe,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;AAY3E,eAAO,MAAM,mBAAmB,EAAE,eAmBjC,CAAC"}

package/dist/runtime/run-files/report-validator.js

@@ -0,0 +1,29 @@
+import { buildReportSchemaRegistry } from '../../flows/catalog-derivations.js';
+import { flowPackages } from '../../flows/catalog.js';
+import { BUILTIN_REPORT_SCHEMAS } from '../../schemas/builtin-report-schemas.js';
+// channels:'relay+report' on purpose — run-file validation covers
+// EVERY report written into a run dir: compose / close / verification
+// / checkpoint / sub-run reports (channel:'report') as well as
+// materialized relay reports. parseReport's registry
+// (src/flows/registries/report-schemas.ts) stays channels:'relay'.
+const REGISTRY = buildReportSchemaRegistry(flowPackages, {
+    channels: 'relay+report',
+    fixtures: BUILTIN_REPORT_SCHEMAS,
+});
+export const validateReportValue = (schemaName, value) => {
+    if (!Object.hasOwn(REGISTRY, schemaName)) {
+        throw new Error(`report schema '${schemaName}' is not registered in the report-schema registry (fail-closed default)`);
+    }
+    const schema = REGISTRY[schemaName];
+    const result = schema.safeParse(value);
+    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('; ');
+        throw new Error(`report body did not validate against schema '${schemaName}' (${issueSummary})`);
+    }
+};
+//# sourceMappingURL=report-validator.js.map

package/dist/runtime/run-files/report-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-validator.js","sourceRoot":"","sources":["../../../src/runtime/run-files/report-validator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AAIjF,kEAAkE;AAClE,sEAAsE;AACtE,+DAA+D;AAC/D,qDAAqD;AACrD,mEAAmE;AACnE,MAAM,QAAQ,GAAG,yBAAyB,CAAC,YAAY,EAAE;IACvD,QAAQ,EAAE,cAAc;IACxB,QAAQ,EAAE,sBAAsB;CACjC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAoB,CAAC,UAAU,EAAE,KAAK,EAAE,EAAE;IACxE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CACb,kBAAkB,UAAU,yEAAyE,CACtG,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,QAAQ,CAAC,UAAU,CAAuB,CAAC;IAC1D,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACvC,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,MAAM,IAAI,KAAK,CACb,gDAAgD,UAAU,MAAM,YAAY,GAAG,CAChF,CAAC;IACJ,CAAC;AACH,CAAC,CAAC"}

package/dist/runtime/run-files/run-file-store.d.ts

@@ -0,0 +1,13 @@
+import type { RunFileRef } from '../domain/run-file.js';
+import type { ReportValidator } from './report-validator.js';
+export declare class RunFileStore {
+    readonly runDir: string;
+    private readonly validateReport?;
+    constructor(runDir: string, validateReport?: ReportValidator | undefined);
+    resolve(ref: RunFileRef | string): string;
+    writeJson(ref: RunFileRef | string, value: unknown): Promise<string>;
+    writeText(ref: RunFileRef | string, value: string): Promise<string>;
+    readText(ref: RunFileRef | string): Promise<string>;
+    readJson<T = unknown>(ref: RunFileRef | string): Promise<T>;
+}
+//# sourceMappingURL=run-file-store.d.ts.map

package/dist/runtime/run-files/run-file-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-file-store.d.ts","sourceRoot":"","sources":["../../../src/runtime/run-files/run-file-store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,qBAAa,YAAY;IAErB,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;gBADvB,MAAM,EAAE,MAAM,EACN,cAAc,CAAC,EAAE,eAAe,YAAA;IAGnD,OAAO,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM;IAInC,SAAS,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAapE,SAAS,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAWnE,QAAQ,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAInD,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;CAIlE"}

package/dist/runtime/run-files/run-file-store.js

@@ -0,0 +1,42 @@
+import { readFile } from 'node:fs/promises';
+import { writeJsonAtomic, writeTextAtomic } from '../../shared/atomic-io.js';
+import { resolveRunFilePath } from '../../shared/run-file-paths.js';
+export class RunFileStore {
+    runDir;
+    validateReport;
+    constructor(runDir, validateReport) {
+        this.runDir = runDir;
+        this.validateReport = validateReport;
+    }
+    resolve(ref) {
+        return resolveRunFilePath(this.runDir, typeof ref === 'string' ? ref : ref.path);
+    }
+    async writeJson(ref, value) {
+        if (typeof ref !== 'string' && ref.schema !== undefined) {
+            this.validateReport?.(ref.schema, value);
+        }
+        const fullPath = this.resolve(ref);
+        // Whole-file run artifacts go through atomic-io (stage to a temp sibling,
+        // then rename) so a crash mid-write can never leave a half-written file.
+        // writeJsonAtomic mkdirs the parent and emits identical bytes to the prior
+        // bare write: `${JSON.stringify(value, null, 2)}\n`.
+        writeJsonAtomic(fullPath, value);
+        return fullPath;
+    }
+    async writeText(ref, value) {
+        if (typeof ref !== 'string' && ref.schema !== undefined) {
+            throw new Error(`writeText cannot write schema-tagged run file '${ref.path}'; use writeJson after parsing and validation`);
+        }
+        const fullPath = this.resolve(ref);
+        writeTextAtomic(fullPath, value);
+        return fullPath;
+    }
+    async readText(ref) {
+        return await readFile(this.resolve(ref), 'utf8');
+    }
+    async readJson(ref) {
+        const raw = await this.readText(ref);
+        return JSON.parse(raw);
+    }
+}
+//# sourceMappingURL=run-file-store.js.map

package/dist/runtime/run-files/run-file-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-file-store.js","sourceRoot":"","sources":["../../../src/runtime/run-files/run-file-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAIpE,MAAM,OAAO,YAAY;IAEZ;IACQ;IAFnB,YACW,MAAc,EACN,cAAgC;QADxC,WAAM,GAAN,MAAM,CAAQ;QACN,mBAAc,GAAd,cAAc,CAAkB;IAChD,CAAC;IAEJ,OAAO,CAAC,GAAwB;QAC9B,OAAO,kBAAkB,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACnF,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,GAAwB,EAAE,KAAc;QACtD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACxD,IAAI,CAAC,cAAc,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC3C,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACnC,0EAA0E;QAC1E,yEAAyE;QACzE,2EAA2E;QAC3E,qDAAqD;QACrD,eAAe,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACjC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,GAAwB,EAAE,KAAa;QACrD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACxD,MAAM,IAAI,KAAK,CACb,kDAAkD,GAAG,CAAC,IAAI,+CAA+C,CAC1G,CAAC;QACJ,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACnC,eAAe,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACjC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,GAAwB;QACrC,OAAO,MAAM,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,QAAQ,CAAc,GAAwB;QAClD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAC;IAC9B,CAAC;CACF"}

package/dist/runtime/trace/trace-fields.d.ts

@@ -0,0 +1,97 @@
+import { type ResolvedConnector } from '../../schemas/connector.js';
+import type { FilesystemCapability } from '../../schemas/connector.js';
+import type { FanoutStep } from '../../schemas/step.js';
+import { RunClosedOutcome } from '../../schemas/trace-entry.js';
+import type { TraceEntry } from '../domain/trace.js';
+/**
+ * Read a non-empty string field off a trace entry.
+ *
+ * Mirrors the prior `traceString` helpers in checkpoint-resume.ts and
+ * runtime-run-folder.ts: returns the value only when it is a string with
+ * length > 0, otherwise `undefined`.
+ */
+export declare function traceString(entry: TraceEntry, key: string): string | undefined;
+/**
+ * Read a finite number field off a trace entry.
+ *
+ * Mirrors the prior `traceNumber` helper in runtime-run-folder.ts.
+ */
+export declare function traceNumber(entry: TraceEntry, key: string): number | undefined;
+/**
+ * Read a homogeneous, non-empty string-array field off a trace entry.
+ *
+ * Mirrors the prior `stringArray`/`traceStringArray` helpers: returns the
+ * array only when every element is a string AND the array is non-empty,
+ * otherwise `undefined`. Returns `readonly string[]`; the projection call
+ * sites that wanted a mutable `string[]` spread it explicitly.
+ */
+export declare function traceStringArray(entry: TraceEntry, key: string): readonly string[] | undefined;
+/**
+ * Value-level companion to {@link traceStringArray} for fields already pulled
+ * off an entry as `unknown` (e.g. `entry.branch_ids`, `entry.options`).
+ * Preserves the exact predicate the inline helpers used and returns a fresh
+ * mutable array, matching the prior progress-projection `stringArray` helper
+ * (its callers pass the result straight into mutable progress-event fields).
+ */
+export declare function stringArrayValue(value: unknown): string[] | undefined;
+/**
+ * The canonical run-closed outcome literals, sourced from the zod enum in
+ * `schemas/trace-entry.ts`. The single source of truth for the value set.
+ */
+export declare const RUN_CLOSED_OUTCOMES: ("complete" | "stopped" | "handoff" | "aborted" | "escalated")[];
+/**
+ * Type guard for an unknown value being a {@link RunClosedOutcome}. Replaces
+ * the hand-rolled `isRunClosedOutcome` chains across the runtime.
+ */
+export declare function isRunClosedOutcome(value: unknown): value is RunClosedOutcome;
+/**
+ * Read the `outcome` field off a `run.closed` entry, falling back to
+ * `'aborted'` when it is missing or unrecognized.
+ *
+ * Mirrors progress.ts `runOutcome`.
+ */
+export declare function runOutcome(entry: TraceEntry): RunClosedOutcome;
+/**
+ * Read the optional `reason` field off a trace entry as a non-empty string.
+ *
+ * Mirrors progress.ts `runReason`.
+ */
+export declare function runReason(entry: TraceEntry): string | undefined;
+/**
+ * Read a child/run outcome field as a {@link RunClosedOutcome} when
+ * recognized, otherwise `undefined` (no fallback). Mirrors progress.ts
+ * `fanoutChildOutcome` and runtime-run-folder.ts `runtimeRunOutcome`.
+ */
+export declare function optionalRunClosedOutcome(value: unknown): RunClosedOutcome | undefined;
+type ProgressRelayRole = 'researcher' | 'reviewer' | 'implementer';
+/**
+ * Read the relay `role` off a trace entry, narrowed to the progress-relevant
+ * subset. Mirrors progress.ts `relayRoleFromTrace`.
+ */
+export declare function relayRoleFromTrace(entry: TraceEntry): ProgressRelayRole | undefined;
+export type { ProgressRelayRole };
+/**
+ * Reconstruct a {@link ResolvedConnector} from a trace entry's `connector`
+ * field, validating the discriminant shape. Mirrors progress.ts
+ * `connectorFromTrace` exactly.
+ */
+export declare function connectorFromTrace(entry: TraceEntry): ResolvedConnector | undefined;
+/**
+ * Resolve the filesystem capability for a {@link ResolvedConnector}. Mirrors
+ * progress.ts `connectorFilesystemCapability`.
+ */
+export declare function connectorFilesystemCapability(connector: ResolvedConnector): FilesystemCapability;
+type FanoutJoinPolicy = FanoutStep['check']['join']['policy'];
+/**
+ * Narrow an unknown value to a fanout join policy. Mirrors progress.ts
+ * `fanoutPolicy`.
+ */
+export declare function fanoutPolicy(value: unknown): FanoutJoinPolicy | undefined;
+type FanoutBranchKind = 'relay' | 'sub-run';
+/**
+ * Narrow an unknown value to a fanout branch kind. Mirrors progress.ts
+ * `fanoutBranchKind`.
+ */
+export declare function fanoutBranchKind(value: unknown): FanoutBranchKind | undefined;
+export type { FanoutJoinPolicy, FanoutBranchKind };
+//# sourceMappingURL=trace-fields.d.ts.map

package/dist/runtime/trace/trace-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-fields.d.ts","sourceRoot":"","sources":["../../../src/runtime/trace/trace-fields.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACtF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAWrD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG9E;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG9E;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,CAE9F;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,GAAG,SAAS,CAIrE;AAID;;;GAGG;AACH,eAAO,MAAM,mBAAmB,kEAA2B,CAAC;AAE5D;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAE5E;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,gBAAgB,CAG9D;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAG/D;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,GAAG,SAAS,CAErF;AAID,KAAK,iBAAiB,GAAG,YAAY,GAAG,UAAU,GAAG,aAAa,CAAC;AAQnE;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,iBAAiB,GAAG,SAAS,CAKnF;AAED,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAIlC;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,iBAAiB,GAAG,SAAS,CAsBnF;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,iBAAiB,GAAG,oBAAoB,CAIhG;AAKD,KAAK,gBAAgB,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC;AAS9D;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,GAAG,SAAS,CAIzE;AAED,KAAK,gBAAgB,GAAG,OAAO,GAAG,SAAS,CAAC;AAE5C;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,GAAG,SAAS,CAE7E;AAED,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/runtime/trace/trace-fields.js

@@ -0,0 +1,181 @@
+// Shared, typed trace-field accessors and derivations.
+//
+// Runtime consumers (progress projection, graph runner, checkpoint resume)
+// repeatedly read individual fields off trace entries and re-derive the same
+// enums (run outcome, relay role, connector, fanout policy) inline, each with
+// its own hand-rolled narrowing. This module is the single home for those
+// reads so the behavior is defined once and audited once.
+//
+// Design constraint (REP-R1 readiness): every accessor narrows on `entry.kind`
+// or reads a field through an `unknown` view of the entry, never through a
+// `keyof TraceEntry` indexed type. That keeps each accessor valid whether
+// `TraceEntry` is the current loose runtime shape (every field optional and
+// widened) or the strict discriminated union it will become. Flipping the type
+// must not require rewriting anything here.
+//
+// Every accessor reproduces the prior inline behavior EXACTLY. Where two
+// former call sites differed (e.g. a `string[]` vs `readonly string[]`
+// return), the difference is preserved by separate, explicitly-typed helpers
+// rather than silently unified.
+import { BUILTIN_CONNECTOR_CAPABILITIES } from '../../schemas/connector.js';
+import { EnabledConnector } from '../../schemas/connector.js';
+import { RunClosedOutcome } from '../../schemas/trace-entry.js';
+function fieldView(entry) {
+    return entry;
+}
+/**
+ * Read a non-empty string field off a trace entry.
+ *
+ * Mirrors the prior `traceString` helpers in checkpoint-resume.ts and
+ * runtime-run-folder.ts: returns the value only when it is a string with
+ * length > 0, otherwise `undefined`.
+ */
+export function traceString(entry, key) {
+    const value = fieldView(entry)[key];
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+/**
+ * Read a finite number field off a trace entry.
+ *
+ * Mirrors the prior `traceNumber` helper in runtime-run-folder.ts.
+ */
+export function traceNumber(entry, key) {
+    const value = fieldView(entry)[key];
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+/**
+ * Read a homogeneous, non-empty string-array field off a trace entry.
+ *
+ * Mirrors the prior `stringArray`/`traceStringArray` helpers: returns the
+ * array only when every element is a string AND the array is non-empty,
+ * otherwise `undefined`. Returns `readonly string[]`; the projection call
+ * sites that wanted a mutable `string[]` spread it explicitly.
+ */
+export function traceStringArray(entry, key) {
+    return stringArrayValue(fieldView(entry)[key]);
+}
+/**
+ * Value-level companion to {@link traceStringArray} for fields already pulled
+ * off an entry as `unknown` (e.g. `entry.branch_ids`, `entry.options`).
+ * Preserves the exact predicate the inline helpers used and returns a fresh
+ * mutable array, matching the prior progress-projection `stringArray` helper
+ * (its callers pass the result straight into mutable progress-event fields).
+ */
+export function stringArrayValue(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    const entries = value.filter((item) => typeof item === 'string');
+    return entries.length === value.length && entries.length > 0 ? entries : undefined;
+}
+// --- Run outcome ---------------------------------------------------------
+/**
+ * The canonical run-closed outcome literals, sourced from the zod enum in
+ * `schemas/trace-entry.ts`. The single source of truth for the value set.
+ */
+export const RUN_CLOSED_OUTCOMES = RunClosedOutcome.options;
+/**
+ * Type guard for an unknown value being a {@link RunClosedOutcome}. Replaces
+ * the hand-rolled `isRunClosedOutcome` chains across the runtime.
+ */
+export function isRunClosedOutcome(value) {
+    return RUN_CLOSED_OUTCOMES.includes(value);
+}
+/**
+ * Read the `outcome` field off a `run.closed` entry, falling back to
+ * `'aborted'` when it is missing or unrecognized.
+ *
+ * Mirrors progress.ts `runOutcome`.
+ */
+export function runOutcome(entry) {
+    const outcome = fieldView(entry).outcome;
+    return isRunClosedOutcome(outcome) ? outcome : 'aborted';
+}
+/**
+ * Read the optional `reason` field off a trace entry as a non-empty string.
+ *
+ * Mirrors progress.ts `runReason`.
+ */
+export function runReason(entry) {
+    const reason = fieldView(entry).reason;
+    return typeof reason === 'string' && reason.length > 0 ? reason : undefined;
+}
+/**
+ * Read a child/run outcome field as a {@link RunClosedOutcome} when
+ * recognized, otherwise `undefined` (no fallback). Mirrors progress.ts
+ * `fanoutChildOutcome` and runtime-run-folder.ts `runtimeRunOutcome`.
+ */
+export function optionalRunClosedOutcome(value) {
+    return isRunClosedOutcome(value) ? value : undefined;
+}
+const PROGRESS_RELAY_ROLES = [
+    'researcher',
+    'reviewer',
+    'implementer',
+];
+/**
+ * Read the relay `role` off a trace entry, narrowed to the progress-relevant
+ * subset. Mirrors progress.ts `relayRoleFromTrace`.
+ */
+export function relayRoleFromTrace(entry) {
+    const role = fieldView(entry).role;
+    return PROGRESS_RELAY_ROLES.includes(role)
+        ? role
+        : undefined;
+}
+// --- Connector -----------------------------------------------------------
+/**
+ * Reconstruct a {@link ResolvedConnector} from a trace entry's `connector`
+ * field, validating the discriminant shape. Mirrors progress.ts
+ * `connectorFromTrace` exactly.
+ */
+export function connectorFromTrace(entry) {
+    const connector = fieldView(entry).connector;
+    if (connector === undefined || connector === null || typeof connector !== 'object') {
+        return undefined;
+    }
+    const record = connector;
+    if (record.kind === 'builtin' &&
+        typeof record.name === 'string' &&
+        EnabledConnector.options.includes(record.name)) {
+        return { kind: 'builtin', name: record.name };
+    }
+    if (record.kind === 'custom' &&
+        typeof record.name === 'string' &&
+        Array.isArray(record.command) &&
+        record.capabilities !== undefined) {
+        return connector;
+    }
+    return undefined;
+}
+/**
+ * Resolve the filesystem capability for a {@link ResolvedConnector}. Mirrors
+ * progress.ts `connectorFilesystemCapability`.
+ */
+export function connectorFilesystemCapability(connector) {
+    return connector.kind === 'builtin'
+        ? BUILTIN_CONNECTOR_CAPABILITIES[connector.name].filesystem
+        : connector.capabilities.filesystem;
+}
+const FANOUT_JOIN_POLICIES = [
+    'pick-winner',
+    'disjoint-merge',
+    'aggregate-only',
+    'aggregate-survivors',
+];
+/**
+ * Narrow an unknown value to a fanout join policy. Mirrors progress.ts
+ * `fanoutPolicy`.
+ */
+export function fanoutPolicy(value) {
+    return FANOUT_JOIN_POLICIES.includes(value)
+        ? value
+        : undefined;
+}
+/**
+ * Narrow an unknown value to a fanout branch kind. Mirrors progress.ts
+ * `fanoutBranchKind`.
+ */
+export function fanoutBranchKind(value) {
+    return value === 'relay' || value === 'sub-run' ? value : undefined;
+}
+//# sourceMappingURL=trace-fields.js.map

package/dist/runtime/trace/trace-fields.js.map

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

package/dist/runtime/trace/trace-store.d.ts

@@ -0,0 +1,20 @@
+import type { TraceEntry, TraceEntryInput } from '../domain/trace.js';
+export interface TraceStoreOptions {
+    readonly now?: () => Date;
+    readonly onAppend?: (entry: TraceEntry) => void | Promise<void>;
+}
+export declare class TraceStore {
+    readonly runDir: string;
+    private readonly options;
+    private readonly tracePath;
+    private entries;
+    private nextSequence;
+    private closed;
+    private appendTail;
+    private healToByteLength;
+    constructor(runDir: string, options?: TraceStoreOptions);
+    load(): Promise<readonly TraceEntry[]>;
+    append(input: TraceEntryInput): Promise<TraceEntry>;
+    getAll(): readonly TraceEntry[];
+}
+//# sourceMappingURL=trace-store.d.ts.map

package/dist/runtime/trace/trace-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-store.d.ts","sourceRoot":"","sources":["../../../src/runtime/trace/trace-store.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEtE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjE;AAED,qBAAa,UAAU;IAYnB,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAZ1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAoC;IAItD,OAAO,CAAC,gBAAgB,CAAqB;gBAGlC,MAAM,EAAE,MAAM,EACN,OAAO,GAAE,iBAAsB;IAK5C,IAAI,IAAI,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC;IA4FtC,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC;IAgDzD,MAAM,IAAI,SAAS,UAAU,EAAE;CAGhC"}

package/dist/runtime/trace/trace-store.js

@@ -0,0 +1,157 @@
+// Append-only trace.ndjson store.
+//
+// This is the sequence authority for runtime events. Callers provide event
+// bodies; TraceStore assigns contiguous sequence numbers, persists one JSON
+// object per line, rejects writes after run.closed, and lets projection hooks
+// fail without corrupting the trace.
+import { appendFile, mkdir, readFile, truncate } from 'node:fs/promises';
+import { join } from 'node:path';
+import { TraceEntry as TraceEntrySchema } from '../../schemas/trace-entry.js';
+export class TraceStore {
+    runDir;
+    options;
+    tracePath;
+    entries = [];
+    nextSequence = 0;
+    closed = false;
+    appendTail = Promise.resolve();
+    // Byte length of the last consistent (complete-line) prefix when load() drops
+    // a torn trailing line. The next append truncates the torn bytes first so it
+    // cannot concatenate onto a half-written record. undefined => nothing to heal.
+    healToByteLength;
+    constructor(runDir, options = {}) {
+        this.runDir = runDir;
+        this.options = options;
+        this.tracePath = join(runDir, 'trace.ndjson');
+    }
+    async load() {
+        await this.appendTail;
+        let raw = '';
+        try {
+            raw = await readFile(this.tracePath, 'utf8');
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                this.entries = [];
+                this.nextSequence = 0;
+                this.closed = false;
+                return this.entries;
+            }
+            throw error;
+        }
+        // Parse one JSON object per line, tolerating a torn/unparseable FINAL line —
+        // the expected artifact of a crash mid-append. Appends are serialized and
+        // each writes one complete `${json}\n`, so only the last line can be
+        // half-written; treat the trace as ending at the last complete line. The
+        // torn record names an action that never durably happened. Any earlier
+        // unparseable line is real interior corruption and must fail loud.
+        //
+        // Scan the UNFILTERED split and accumulate true on-disk byte offsets so the
+        // heal length is measured in real bytes: a stray blank line before the torn
+        // tail must not shift it (re-joining a blank-filtered line set would drop
+        // that blank's newline and truncate into the last complete record).
+        const segments = raw.split('\n');
+        let lastContentIndex = -1;
+        for (let index = segments.length - 1; index >= 0; index -= 1) {
+            if ((segments[index] ?? '').trim().length > 0) {
+                lastContentIndex = index;
+                break;
+            }
+        }
+        const rawEntries = [];
+        this.healToByteLength = undefined;
+        let byteOffset = 0;
+        for (const [index, segment] of segments.entries()) {
+            // Every segment except the last was followed by a `\n` that split removed.
+            const onDiskBytes = Buffer.byteLength(segment, 'utf8') + (index < segments.length - 1 ? 1 : 0);
+            if (segment.trim().length === 0) {
+                // A blank line. The writer never emits one, but a damaged file might;
+                // skip it without disturbing the byte accounting.
+                byteOffset += onDiskBytes;
+                continue;
+            }
+            try {
+                rawEntries.push(JSON.parse(segment));
+            }
+            catch (error) {
+                if (index === lastContentIndex) {
+                    // Torn FINAL line. Remember the clean-prefix byte length (everything
+                    // before this physical line) so the next append truncates the torn
+                    // bytes instead of concatenating onto them. load() itself stays
+                    // read-only: inspection and result regeneration must never mutate a
+                    // crashed run's trace.
+                    this.healToByteLength = byteOffset;
+                    break;
+                }
+                throw new Error(`trace entry ${index} is not valid JSON (interior corruption): ${error.message}`);
+            }
+            byteOffset += onDiskBytes;
+        }
+        const entries = [];
+        for (const [index, entry] of rawEntries.entries()) {
+            if (entry === null || typeof entry !== 'object' || Array.isArray(entry)) {
+                throw new Error(`trace entry ${index} is not an object`);
+            }
+            const candidate = TraceEntrySchema.parse(entry);
+            if (typeof candidate.sequence !== 'number' || !Number.isInteger(candidate.sequence)) {
+                throw new Error(`trace entry ${index} has no integer sequence`);
+            }
+            if (candidate.sequence !== index) {
+                throw new Error(`trace sequence mismatch at entry ${index}: expected ${index}, found ${candidate.sequence}`);
+            }
+            entries.push(candidate);
+        }
+        const closedIndex = entries.findIndex((entry) => entry.kind === 'run.closed');
+        if (closedIndex !== -1 && closedIndex !== entries.length - 1) {
+            throw new Error(`trace entry after run.closed at sequence ${closedIndex}`);
+        }
+        this.entries = entries;
+        this.nextSequence =
+            entries.length === 0 ? 0 : Math.max(...entries.map((entry) => entry.sequence)) + 1;
+        this.closed = entries.some((entry) => entry.kind === 'run.closed');
+        return this.entries;
+    }
+    async append(input) {
+        const appendOne = async () => {
+            if (this.closed) {
+                throw new Error('cannot append trace entry after run close');
+            }
+            const entry = TraceEntrySchema.parse({
+                ...input,
+                schema_version: input.schema_version ?? 1,
+                recorded_at: input.recorded_at ?? (this.options.now ?? (() => new Date()))().toISOString(),
+                sequence: this.nextSequence,
+            });
+            await mkdir(this.runDir, { recursive: true });
+            if (this.healToByteLength !== undefined) {
+                // A prior load() dropped a torn trailing line. Truncate the torn bytes
+                // before appending so the new record starts on a clean line boundary.
+                // The torn event is unrecoverable by construction: it was cut mid-write
+                // by a crash, so it never durably happened from the trace's point of
+                // view. Accepted tradeoff — the alternative is refusing to resume.
+                await truncate(this.tracePath, this.healToByteLength);
+                this.healToByteLength = undefined;
+            }
+            await appendFile(this.tracePath, `${JSON.stringify(entry)}\n`, 'utf8');
+            this.nextSequence += 1;
+            this.entries.push(entry);
+            if (entry.kind === 'run.closed') {
+                this.closed = true;
+            }
+            try {
+                await this.options.onAppend?.(entry);
+            }
+            catch {
+                // Progress/projection side channels must not corrupt trace persistence.
+            }
+            return entry;
+        };
+        const result = this.appendTail.then(appendOne, appendOne);
+        this.appendTail = result.then(() => undefined, () => undefined);
+        return await result;
+    }
+    getAll() {
+        return this.entries;
+    }
+}
+//# sourceMappingURL=trace-store.js.map

package/dist/runtime/trace/trace-store.js.map

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