@opensip-cli/core 0.1.0

package/dist/lib/execution/__tests__/execution.test.js

@@ -0,0 +1,254 @@
+/**
+ * Execution substrate — scheduleUnits (loop/concurrency/stop), runWithTimeout
+ * (the §4.3 timeout fix), runWithRetry (the fitness-hoisted retry), executePipeline
+ * (the combinator), and deriveRecipeId.
+ */
+import { describe, it, expect } from 'vitest';
+import { deriveRecipeId } from '../../recipe-id.js';
+import { executePipeline } from '../pipeline.js';
+import { runWithRetry } from '../retry.js';
+import { runWithTimeout } from '../run-with-timeout.js';
+import { scheduleUnits } from '../schedule.js';
+describe('deriveRecipeId', () => {
+    it('derives <prefix>_<name>, preserving existing schemes', () => {
+        expect(deriveRecipeId('RCP', 'example')).toBe('RCP_example');
+        expect(deriveRecipeId('GRCP', 'default')).toBe('GRCP_default');
+        expect(deriveRecipeId('BSCP', 'default')).toBe('BSCP_default');
+    });
+});
+describe('runWithTimeout', () => {
+    it('classifies a fast run as ok', async () => {
+        const out = await runWithTimeout({ run: () => Promise.resolve(42), timeoutMs: 1000 });
+        expect(out.status).toBe('ok');
+        expect(out.status === 'ok' && out.result).toBe(42);
+    });
+    it('ABORTS a runaway run and classifies it as timeout (the §4.3 sim fix)', async () => {
+        const out = await runWithTimeout({
+            // A run that never resolves on its own — only the timeout's abort ends it.
+            run: (signal) => new Promise((_resolve, reject) => {
+                signal.addEventListener('abort', () => reject(new Error('aborted')));
+            }),
+            timeoutMs: 20,
+        });
+        expect(out.status).toBe('timeout');
+    });
+    it('classifies a thrown domain error as error (not timeout)', async () => {
+        const out = await runWithTimeout({
+            run: () => Promise.reject(new Error('boom')),
+            timeoutMs: 1000,
+        });
+        expect(out.status).toBe('error');
+        expect(out.status === 'error' && out.error.message).toBe('boom');
+    });
+    describe('with a retry policy (the retry branch)', () => {
+        const retry = { enabled: true, maxRetries: 2, backoffMs: [0, 0] };
+        it('returns ok with the result when the retried run succeeds', async () => {
+            let calls = 0;
+            const out = await runWithTimeout({
+                run: () => {
+                    calls++;
+                    return calls < 2 ? Promise.reject(new Error('flaky')) : Promise.resolve('healed');
+                },
+                timeoutMs: 1000,
+                retry,
+            });
+            expect(out.status).toBe('ok');
+            expect(out.status === 'ok' && out.result).toBe('healed');
+            expect(calls).toBe(2);
+        });
+        it('returns error with lastError when every retried attempt throws', async () => {
+            const out = await runWithTimeout({
+                run: () => Promise.reject(new Error('always')),
+                timeoutMs: 1000,
+                retry,
+            });
+            expect(out.status).toBe('error');
+            expect(out.status === 'error' && out.error.message).toBe('always');
+        });
+        it('classifies a timeout while retrying as timeout (single-source abort)', async () => {
+            // The run rejects synchronously on each attempt without ever resolving the
+            // domain value, so retry keeps re-invoking it. Meanwhile the short timeout
+            // aborts the controller mid-retry; after retry settles, the post-run
+            // `signal.aborted` check maps the outcome to timeout, not error.
+            const out = await runWithTimeout({
+                run: () => new Promise((_resolve, reject) => {
+                    setTimeout(() => reject(new Error('slow-fail')), 20);
+                }),
+                timeoutMs: 10,
+                retry,
+            });
+            expect(out.status).toBe('timeout');
+        });
+    });
+});
+describe('runWithRetry', () => {
+    it('returns the result on first success (no retry)', async () => {
+        const out = await runWithRetry(() => Promise.resolve('ok'), {
+            enabled: true,
+            maxRetries: 2,
+            backoffMs: [0, 0],
+        });
+        expect(out).toMatchObject({ result: 'ok', wasRetried: false, retryCount: 0 });
+    });
+    it('retries on throw up to maxRetries then returns lastError', async () => {
+        let calls = 0;
+        const out = await runWithRetry(() => {
+            calls++;
+            return Promise.reject(new Error(`fail ${calls}`));
+        }, { enabled: true, maxRetries: 2, backoffMs: [0, 0] });
+        expect(calls).toBe(3); // 1 initial + 2 retries
+        expect(out.result).toBeUndefined();
+        expect(out.wasRetried).toBe(true);
+    });
+    it('does NOT retry when shouldNotRetry matches (e.g. an abort)', async () => {
+        let calls = 0;
+        class AbortLike extends Error {
+        }
+        const out = await runWithRetry(() => {
+            calls++;
+            return Promise.reject(new AbortLike());
+        }, {
+            enabled: true,
+            maxRetries: 3,
+            shouldNotRetry: (e) => e instanceof AbortLike,
+            backoffMs: [0, 0],
+        });
+        expect(calls).toBe(1);
+        expect(out.wasRetried).toBe(false);
+    });
+    it('runs once when disabled', async () => {
+        let calls = 0;
+        await runWithRetry(() => {
+            calls++;
+            return Promise.reject(new Error('x'));
+        }, { enabled: false, maxRetries: 5 });
+        expect(calls).toBe(1);
+    });
+});
+describe('scheduleUnits', () => {
+    it('runs sequential in order and stops on shouldStop', async () => {
+        const seen = [];
+        await scheduleUnits({
+            units: [1, 2, 3, 4],
+            mode: 'sequential',
+            runUnit: (u) => {
+                seen.push(u);
+                return Promise.resolve({ shouldStop: u === 2 });
+            },
+        });
+        expect(seen).toEqual([1, 2]); // stopped after unit 2
+    });
+    it('respects maxParallel concurrency in parallel mode', async () => {
+        let active = 0;
+        let maxActive = 0;
+        const runUnit = async () => {
+            active++;
+            maxActive = Math.max(maxActive, active);
+            await new Promise((r) => setTimeout(r, 5));
+            active--;
+            return { shouldStop: false };
+        };
+        await scheduleUnits({
+            units: [1, 2, 3, 4, 5, 6],
+            mode: 'parallel',
+            maxParallel: 2,
+            runUnit,
+        });
+        expect(maxActive).toBeLessThanOrEqual(2);
+    });
+    it('honours an external abort (sequential)', async () => {
+        const seen = [];
+        let aborted = false;
+        await scheduleUnits({
+            units: [1, 2, 3],
+            mode: 'sequential',
+            shouldAbort: () => aborted,
+            runUnit: (u) => {
+                seen.push(u);
+                aborted = u === 1;
+                return Promise.resolve({ shouldStop: false });
+            },
+        });
+        // Sequential checks the abort flag at the TOP of each iteration: unit 1 runs
+        // and flips `aborted`, so unit 2's top-check breaks before it launches.
+        expect(seen).toEqual([1]);
+    });
+    it('yieldBetweenUnits runs every unit in order through the macrotask-yield wrapper (sequential)', async () => {
+        // Exercises the yieldToEventLoop boundary path: each unit resolves after a
+        // setImmediate turn, so a same-thread live-progress timer could paint between
+        // units. Behaviour (order, stop policy) is unchanged from the no-yield path.
+        const seen = [];
+        await scheduleUnits({
+            units: [1, 2, 3],
+            mode: 'sequential',
+            yieldBetweenUnits: true,
+            runUnit: (u) => {
+                seen.push(u);
+                return Promise.resolve({ shouldStop: false });
+            },
+        });
+        expect(seen).toEqual([1, 2, 3]);
+    });
+    it('yieldBetweenUnits also applies in parallel mode (all units still run)', async () => {
+        const seen = [];
+        await scheduleUnits({
+            units: [1, 2, 3, 4],
+            mode: 'parallel',
+            maxParallel: 2,
+            yieldBetweenUnits: true,
+            runUnit: (u) => {
+                seen.push(u);
+                return Promise.resolve({ shouldStop: false });
+            },
+        });
+        expect([...seen].sort((a, b) => a - b)).toEqual([1, 2, 3, 4]);
+    });
+});
+describe('executePipeline (combinator)', () => {
+    it('schedules, times out, and maps outcomes', async () => {
+        const statuses = [];
+        await executePipeline({
+            units: [1, 2, 3],
+            options: { mode: 'sequential', timeout: 30 },
+            runOne: (u, signal) => u === 2
+                ? new Promise((_r, reject) => signal.addEventListener('abort', () => reject(new Error('to'))))
+                : Promise.resolve(u * 10),
+            onResult: (_u, _i, outcome) => {
+                statuses.push(outcome.status);
+                return { shouldStop: false };
+            },
+        });
+        expect(statuses).toEqual(['ok', 'timeout', 'ok']);
+    });
+    it('threads maxParallel, shouldAbort, retry, and a per-unit timeoutFor override', async () => {
+        const seen = [];
+        const timeoutUnits = [];
+        let aborted = false;
+        await executePipeline({
+            units: [1, 2, 3, 4],
+            options: {
+                mode: 'parallel',
+                maxParallel: 2,
+                timeout: 1000,
+                retry: { enabled: true, maxRetries: 1 },
+            },
+            timeoutFor: (u) => {
+                timeoutUnits.push(u);
+                return 50;
+            },
+            shouldAbort: () => aborted,
+            runOne: (u) => Promise.resolve(u),
+            onResult: (u, _i, outcome) => {
+                seen.push(u);
+                if (u === 4)
+                    aborted = true;
+                expect(outcome.status).toBe('ok');
+                return { shouldStop: false };
+            },
+        });
+        // Every scheduled unit went through the per-unit timeout override path.
+        expect(timeoutUnits.length).toBeGreaterThan(0);
+        expect(seen.length).toBeGreaterThan(0);
+    });
+});
+//# sourceMappingURL=execution.test.js.map

package/dist/lib/execution/__tests__/execution.test.js.map

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

package/dist/lib/execution/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Execution substrate (north-star §5.8, launch) — one bounded scheduler +
+ * per-unit timeout/retry that fit + sim recipes run on, so `timeout`/`maxParallel`/
+ * `stopOnFirstFailure` mean the same thing in every domain.
+ */
+export { scheduleUnits, yieldToEventLoop } from './schedule.js';
+export type { ScheduleUnitsOptions } from './schedule.js';
+export { runWithTimeout } from './run-with-timeout.js';
+export type { UnitRunOutcome, RunWithTimeoutOptions } from './run-with-timeout.js';
+export { runWithRetry } from './retry.js';
+export type { PipelineRetryOptions, PipelineRetryOutcome } from './retry.js';
+export { executePipeline } from './pipeline.js';
+export type { ExecutePipelineOptions } from './pipeline.js';
+export type { WorkflowExecutionOptions, WorkflowRetryOptions } from './options.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/execution/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/execution/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAChE,YAAY,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAE1D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnF,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,YAAY,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE7E,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,YAAY,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAE5D,YAAY,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC"}

package/dist/lib/execution/index.js

@@ -0,0 +1,10 @@
+/**
+ * Execution substrate (north-star §5.8, launch) — one bounded scheduler +
+ * per-unit timeout/retry that fit + sim recipes run on, so `timeout`/`maxParallel`/
+ * `stopOnFirstFailure` mean the same thing in every domain.
+ */
+export { scheduleUnits, yieldToEventLoop } from './schedule.js';
+export { runWithTimeout } from './run-with-timeout.js';
+export { runWithRetry } from './retry.js';
+export { executePipeline } from './pipeline.js';
+//# sourceMappingURL=index.js.map

package/dist/lib/execution/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/execution/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGhE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/lib/execution/options.d.ts

@@ -0,0 +1,32 @@
+/**
+ * WorkflowExecutionOptions — the unified execution-config shape every domain's
+ * recipe runs on (north-star §5.8, launch).
+ *
+ * Previously each domain declared its own shape — `FitnessExecutionOptions`
+ * (richest: mode/stopOnFirstFailure/timeout/maxParallel/retry×2) and
+ * `SimulationExecutionOptions` (mode/timeout/maxParallel/stopOnFirstFailure, with
+ * `timeout` silently unenforced). This is the common base they map onto so
+ * `timeout`/`maxParallel`/`stopOnFirstFailure` mean the SAME thing in every domain
+ * — the "same words, same semantics" guarantee parity promises (§4.3). A domain
+ * may carry extra fields (fitness's per-unit config) as an ADR-documented
+ * difference (§6.7); the shared base is what the execution substrate consumes.
+ */
+/** Retry policy for a unit run (off by default). */
+export interface WorkflowRetryOptions {
+    readonly enabled: boolean;
+    readonly maxRetries: number;
+}
+/** The execution config shared by fit + sim recipes; consumed by the substrate. */
+export interface WorkflowExecutionOptions {
+    /** Schedule units concurrently (bounded by `maxParallel`) or one at a time. */
+    readonly mode: 'parallel' | 'sequential';
+    /** Per-unit timeout in ms. A unit that exceeds it is aborted (sim's fix). */
+    readonly timeout?: number;
+    /** Bound on concurrent units in `parallel` mode. */
+    readonly maxParallel?: number;
+    /** Stop scheduling further units once one fails. */
+    readonly stopOnFirstFailure?: boolean;
+    /** Optional retry-on-failure (fitness uses it; sim does not). */
+    readonly retry?: WorkflowRetryOptions;
+}
+//# sourceMappingURL=options.d.ts.map

package/dist/lib/execution/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../../src/lib/execution/options.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,oDAAoD;AACpD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,mFAAmF;AACnF,MAAM,WAAW,wBAAwB;IACvC,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,YAAY,CAAC;IACzC,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,oDAAoD;IACpD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,oDAAoD;IACpD,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IACtC,iEAAiE;IACjE,QAAQ,CAAC,KAAK,CAAC,EAAE,oBAAoB,CAAC;CACvC"}

package/dist/lib/execution/options.js

@@ -0,0 +1,15 @@
+/**
+ * WorkflowExecutionOptions — the unified execution-config shape every domain's
+ * recipe runs on (north-star §5.8, launch).
+ *
+ * Previously each domain declared its own shape — `FitnessExecutionOptions`
+ * (richest: mode/stopOnFirstFailure/timeout/maxParallel/retry×2) and
+ * `SimulationExecutionOptions` (mode/timeout/maxParallel/stopOnFirstFailure, with
+ * `timeout` silently unenforced). This is the common base they map onto so
+ * `timeout`/`maxParallel`/`stopOnFirstFailure` mean the SAME thing in every domain
+ * — the "same words, same semantics" guarantee parity promises (§4.3). A domain
+ * may carry extra fields (fitness's per-unit config) as an ADR-documented
+ * difference (§6.7); the shared base is what the execution substrate consumes.
+ */
+export {};
+//# sourceMappingURL=options.js.map

package/dist/lib/execution/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../src/lib/execution/options.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/lib/execution/pipeline.d.ts

@@ -0,0 +1,36 @@
+/**
+ * executePipeline — the `ExecutionPipeline<Unit, Result>` of north-star §5.8: the
+ * convenience combinator over {@link scheduleUnits} (the bounded loop) and
+ * {@link runWithTimeout} (the per-unit timeout/retry wrapper).
+ *
+ * A tool supplies only a `runOne` (the domain run) and an `onResult` mapper (turn
+ * a classified `UnitRunOutcome` into its domain result + the stop decision); the
+ * substrate owns the loop, concurrency, timeout/abort, retry, and stop policy.
+ * `WorkflowExecutionOptions` (`timeout`/`maxParallel`/`stopOnFirstFailure`/`retry`)
+ * therefore mean the same thing in every domain.
+ *
+ * Tools with a richer per-unit lifecycle (fitness threads memory profiling +
+ * callbacks through its own `runOneCheck`) may compose `scheduleUnits` +
+ * `runWithTimeout` directly instead; both routes are "on the substrate".
+ */
+import { type UnitRunOutcome } from './run-with-timeout.js';
+import type { WorkflowExecutionOptions } from './options.js';
+export interface ExecutePipelineOptions<Unit, R> {
+    readonly units: readonly Unit[];
+    readonly options: WorkflowExecutionOptions;
+    /** The domain run for one unit, under the substrate's abort signal. */
+    readonly runOne: (unit: Unit, signal: AbortSignal) => Promise<R>;
+    /** Map a classified outcome to a domain result + whether to stop scheduling. */
+    readonly onResult: (unit: Unit, index: number, outcome: UnitRunOutcome<R>) => {
+        readonly shouldStop: boolean;
+    } | Promise<{
+        readonly shouldStop: boolean;
+    }>;
+    /** Per-unit timeout override (falls back to `options.timeout`, then 30s). */
+    readonly timeoutFor?: (unit: Unit) => number | undefined;
+    /** External abort check threaded into the scheduler. */
+    readonly shouldAbort?: () => boolean;
+}
+/** Run `units` on the substrate: scheduled, timed out, retried, and stop-policied. */
+export declare function executePipeline<Unit, R>(opts: ExecutePipelineOptions<Unit, R>): Promise<void>;
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/lib/execution/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../../src/lib/execution/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAK7D,MAAM,WAAW,sBAAsB,CAAC,IAAI,EAAE,CAAC;IAC7C,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,wBAAwB,CAAC;IAC3C,uEAAuE;IACvE,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IACjE,gFAAgF;IAChF,QAAQ,CAAC,QAAQ,EAAE,CACjB,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,KACvB;QAAE,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAClF,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,GAAG,SAAS,CAAC;IACzD,wDAAwD;IACxD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC;CACtC;AAED,sFAAsF;AACtF,wBAAsB,eAAe,CAAC,IAAI,EAAE,CAAC,EAC3C,IAAI,EAAE,sBAAsB,CAAC,IAAI,EAAE,CAAC,CAAC,GACpC,OAAO,CAAC,IAAI,CAAC,CAgBf"}

package/dist/lib/execution/pipeline.js

@@ -0,0 +1,38 @@
+/**
+ * executePipeline — the `ExecutionPipeline<Unit, Result>` of north-star §5.8: the
+ * convenience combinator over {@link scheduleUnits} (the bounded loop) and
+ * {@link runWithTimeout} (the per-unit timeout/retry wrapper).
+ *
+ * A tool supplies only a `runOne` (the domain run) and an `onResult` mapper (turn
+ * a classified `UnitRunOutcome` into its domain result + the stop decision); the
+ * substrate owns the loop, concurrency, timeout/abort, retry, and stop policy.
+ * `WorkflowExecutionOptions` (`timeout`/`maxParallel`/`stopOnFirstFailure`/`retry`)
+ * therefore mean the same thing in every domain.
+ *
+ * Tools with a richer per-unit lifecycle (fitness threads memory profiling +
+ * callbacks through its own `runOneCheck`) may compose `scheduleUnits` +
+ * `runWithTimeout` directly instead; both routes are "on the substrate".
+ */
+import { runWithTimeout } from './run-with-timeout.js';
+import { scheduleUnits } from './schedule.js';
+/** Default per-unit timeout when a recipe declares none (fitness's historical 30s). */
+const DEFAULT_TIMEOUT_MS = 30_000;
+/** Run `units` on the substrate: scheduled, timed out, retried, and stop-policied. */
+export async function executePipeline(opts) {
+    await scheduleUnits({
+        units: opts.units,
+        mode: opts.options.mode,
+        ...(opts.options.maxParallel === undefined ? {} : { maxParallel: opts.options.maxParallel }),
+        ...(opts.shouldAbort ? { shouldAbort: opts.shouldAbort } : {}),
+        runUnit: async (unit, index) => {
+            const timeoutMs = opts.timeoutFor?.(unit) ?? opts.options.timeout ?? DEFAULT_TIMEOUT_MS;
+            const outcome = await runWithTimeout({
+                run: (signal) => opts.runOne(unit, signal),
+                timeoutMs,
+                ...(opts.options.retry ? { retry: { ...opts.options.retry } } : {}),
+            });
+            return opts.onResult(unit, index, outcome);
+        },
+    });
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/lib/execution/pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../../src/lib/execution/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,cAAc,EAAuB,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAI9C,uFAAuF;AACvF,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAmBlC,sFAAsF;AACtF,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAqC;IAErC,MAAM,aAAa,CAAO;QACxB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI;QACvB,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QAC5F,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;YAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,kBAAkB,CAAC;YACxF,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC;gBACnC,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC;gBAC1C,SAAS;gBACT,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACpE,CAAC,CAAC;YACH,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QAC7C,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/lib/execution/retry.d.ts

@@ -0,0 +1,38 @@
+/**
+ * runWithRetry — the generic retry-with-backoff primitive the execution substrate
+ * uses (north-star §5.8, launch).
+ *
+ * Hoisted from fitness's `executeWithRetry` (the proven shape): retry ONLY on a
+ * thrown error, never re-throw (return `lastError` instead), and skip retry for a
+ * caller-named class of errors (fitness: an abort). The hardcoded
+ * `CheckAbortedError` check becomes a `shouldNotRetry` predicate, and the fixed
+ * backoff is configurable — so fitness re-points to this with byte-identical
+ * behaviour (default backoff `[1000, 2000]`, the same delays it used).
+ *
+ * Distinct from `withRetry` (`lib/retry.ts`), which is the network-oriented
+ * throw-on-exhaustion retry for `--report-to`; this one returns an outcome and is
+ * the per-unit execution retry.
+ */
+export interface PipelineRetryOptions {
+    /** When false (or `maxRetries <= 0`), the function runs once with no retry. */
+    readonly enabled: boolean;
+    readonly maxRetries: number;
+    /** Errors for which retry is skipped entirely (e.g. an abort). Default: none. */
+    readonly shouldNotRetry?: (error: unknown) => boolean;
+    /** Per-attempt backoff delays (ms). Default `[1000, 2000]` (last value repeats). */
+    readonly backoffMs?: readonly number[];
+}
+/** Outcome of a retry-wrapped run. `result === undefined` ⇔ every attempt threw. */
+export interface PipelineRetryOutcome<T> {
+    readonly result: T | undefined;
+    readonly lastError: unknown;
+    readonly retryCount: number;
+    readonly wasRetried: boolean;
+}
+/**
+ * Run `fn` with retry. Retries only on a thrown error (up to `maxRetries`), never
+ * re-throws, and short-circuits for `shouldNotRetry` errors. Mirrors fitness's
+ * former `executeWithRetry` exactly (same default backoff, same return shape).
+ */
+export declare function runWithRetry<T>(fn: () => Promise<T>, options: PipelineRetryOptions): Promise<PipelineRetryOutcome<T>>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/lib/execution/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../../src/lib/execution/retry.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AAKH,MAAM,WAAW,oBAAoB;IACnC,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,iFAAiF;IACjF,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IACtD,oFAAoF;IACpF,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAED,oFAAoF;AACpF,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,SAAS,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAOD;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAClC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAyBlC"}

package/dist/lib/execution/retry.js

@@ -0,0 +1,56 @@
+// @fitness-ignore-file async-waterfall-detection -- the backoff-then-retry awaits are necessarily sequential (wait, THEN re-attempt); parallelizing them would defeat retry/backoff semantics
+// @fitness-ignore-file performance-anti-patterns -- same: sequential await is the entire point of a retry/backoff loop (same waiver as lib/retry.ts and the fitness retry this hoists)
+/**
+ * runWithRetry — the generic retry-with-backoff primitive the execution substrate
+ * uses (north-star §5.8, launch).
+ *
+ * Hoisted from fitness's `executeWithRetry` (the proven shape): retry ONLY on a
+ * thrown error, never re-throw (return `lastError` instead), and skip retry for a
+ * caller-named class of errors (fitness: an abort). The hardcoded
+ * `CheckAbortedError` check becomes a `shouldNotRetry` predicate, and the fixed
+ * backoff is configurable — so fitness re-points to this with byte-identical
+ * behaviour (default backoff `[1000, 2000]`, the same delays it used).
+ *
+ * Distinct from `withRetry` (`lib/retry.ts`), which is the network-oriented
+ * throw-on-exhaustion retry for `--report-to`; this one returns an outcome and is
+ * the per-unit execution retry.
+ */
+/** Default per-attempt backoff delays (ms) — fitness's historical `[1000, 2000]`. */
+const DEFAULT_BACKOFF_MS = [1000, 2000];
+function backoff(attempt, delays) {
+    const delay = delays[attempt] ?? delays.at(-1) ?? 2000;
+    return new Promise((resolve) => setTimeout(resolve, delay));
+}
+/**
+ * Run `fn` with retry. Retries only on a thrown error (up to `maxRetries`), never
+ * re-throws, and short-circuits for `shouldNotRetry` errors. Mirrors fitness's
+ * former `executeWithRetry` exactly (same default backoff, same return shape).
+ */
+export async function runWithRetry(fn, options) {
+    const delays = options.backoffMs ?? DEFAULT_BACKOFF_MS;
+    try {
+        const result = await fn();
+        return { result, lastError: undefined, retryCount: 0, wasRetried: false };
+    }
+    catch (firstError) {
+        if (options.shouldNotRetry?.(firstError) === true) {
+            return { result: undefined, lastError: firstError, retryCount: 0, wasRetried: false };
+        }
+        if (!options.enabled || options.maxRetries <= 0) {
+            return { result: undefined, lastError: firstError, retryCount: 0, wasRetried: false };
+        }
+        let lastError = firstError;
+        for (let attempt = 0; attempt < options.maxRetries; attempt++) {
+            await backoff(attempt, delays);
+            try {
+                const result = await fn();
+                return { result, lastError: undefined, retryCount: attempt + 1, wasRetried: true };
+            }
+            catch (retryError) {
+                lastError = retryError;
+            }
+        }
+        return { result: undefined, lastError, retryCount: options.maxRetries, wasRetried: true };
+    }
+}
+//# sourceMappingURL=retry.js.map

package/dist/lib/execution/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../../src/lib/execution/retry.ts"],"names":[],"mappings":"AAAA,8LAA8L;AAC9L,uLAAuL;AACvL;;;;;;;;;;;;;;GAcG;AAEH,qFAAqF;AACrF,MAAM,kBAAkB,GAAG,CAAC,IAAI,EAAE,IAAI,CAAU,CAAC;AAoBjD,SAAS,OAAO,CAAC,OAAe,EAAE,MAAyB;IACzD,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IACvD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,EAAoB,EACpB,OAA6B;IAE7B,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,IAAI,kBAAkB,CAAC;IACvD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;QAC1B,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;IAC5E,CAAC;IAAC,OAAO,UAAU,EAAE,CAAC;QACpB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,UAAU,CAAC,KAAK,IAAI,EAAE,CAAC;YAClD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;QACxF,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,IAAI,CAAC,EAAE,CAAC;YAChD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;QACxF,CAAC;QAED,IAAI,SAAS,GAAY,UAAU,CAAC;QACpC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;YAC9D,MAAM,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC/B,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;gBAC1B,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,GAAG,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;YACrF,CAAC;YAAC,OAAO,UAAU,EAAE,CAAC;gBACpB,SAAS,GAAG,UAAU,CAAC;YACzB,CAAC;QACH,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;IAC5F,CAAC;AACH,CAAC"}

package/dist/lib/execution/run-with-timeout.d.ts

@@ -0,0 +1,46 @@
+/**
+ * runWithTimeout — the per-unit timeout/abort/retry wrapper of the execution
+ * substrate (north-star §5.8, launch).
+ *
+ * One unit's lifecycle: install an `AbortController` + `setTimeout`, run the
+ * domain function under that signal (optionally with retry), and classify the
+ * outcome as `ok` / `timeout` / `error`. The single-source abort invariant is
+ * preserved from fitness's `runOneCheck`: the controller is aborted ONLY by the
+ * timeout, so a post-run `signal.aborted` IS a timeout.
+ *
+ * This is the shared primitive that makes "a declared `timeout` actually aborts"
+ * true in every domain — the §4.3 fix for simulation, whose `runSingle` declared
+ * `execution.timeout` but never installed one.
+ */
+import { type PipelineRetryOptions } from './retry.js';
+/** Result of one unit run. `timeout` and `error` are distinct so callers can map each. */
+export type UnitRunOutcome<R> = {
+    readonly status: 'ok';
+    readonly result: R;
+    readonly durationMs: number;
+} | {
+    readonly status: 'timeout';
+    readonly durationMs: number;
+    readonly timeoutMs: number;
+} | {
+    readonly status: 'error';
+    readonly error: unknown;
+    readonly durationMs: number;
+};
+export interface RunWithTimeoutOptions<R> {
+    /** The domain run — receives the abort signal the timeout fires on. */
+    readonly run: (signal: AbortSignal) => Promise<R>;
+    /** Per-unit timeout (ms). A run that exceeds it is aborted → `status:'timeout'`. */
+    readonly timeoutMs: number;
+    /** Optional retry (fitness); omitted ⇒ the run executes exactly once. */
+    readonly retry?: PipelineRetryOptions;
+}
+/**
+ * Run one unit under a timeout, returning a classified outcome (never throws for
+ * a domain error — it is returned as `status:'error'`). Mirrors the proven
+ * timeout-detection of fitness's `runOneCheck` (clear the timer, then a
+ * `signal.aborted` check is canonical-timeout because the controller has a single
+ * abort source).
+ */
+export declare function runWithTimeout<R>(opts: RunWithTimeoutOptions<R>): Promise<UnitRunOutcome<R>>;
+//# sourceMappingURL=run-with-timeout.d.ts.map

package/dist/lib/execution/run-with-timeout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-with-timeout.d.ts","sourceRoot":"","sources":["../../../src/lib/execution/run-with-timeout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAgB,KAAK,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAErE,0FAA0F;AAC1F,MAAM,MAAM,cAAc,CAAC,CAAC,IACxB;IAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC1E;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACvF;IAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvF,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,uEAAuE;IACvE,QAAQ,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAClD,oFAAoF;IACpF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,yEAAyE;IACzE,QAAQ,CAAC,KAAK,CAAC,EAAE,oBAAoB,CAAC;CACvC;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,CAAC,EACpC,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAC7B,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAoE5B"}