@opensip-cli/simulation 0.1.0

package/dist/framework/execution/__tests__/run-load-window.test.js

@@ -0,0 +1,89 @@
+/**
+ * @fileoverview Behaviour tests for the real load-window driver: it drives a
+ * BYO target, measures latency, classifies outcomes, bounds concurrency, and
+ * honours abort.
+ */
+import { describe, expect, it, vi } from 'vitest';
+import { countingTarget, failingTarget } from '../../../__tests__/test-utils/targets.js';
+import { runLoadWindow } from '../run-load-window.js';
+const ctx = (signal) => ({
+    scenarioId: 't',
+    correlationId: 'c',
+    abortSignal: signal,
+    logger: { debug: vi.fn(), info: vi.fn(), warn: vi.fn(), error: vi.fn() },
+});
+describe('runLoadWindow', () => {
+    it('drives the target and counts every resolve as a success', async () => {
+        const ct = countingTarget();
+        const r = await runLoadWindow({ workload: { rps: 50 } }, ctx(new AbortController().signal), {
+            windowMs: 300,
+            target: ct.target,
+        });
+        expect(r.metrics.totalRequests).toBeGreaterThan(0);
+        expect(ct.calls()).toBe(r.metrics.totalRequests);
+        expect(r.metrics.successfulRequests).toBe(r.metrics.totalRequests);
+        expect(r.metrics.failedRequests).toBe(0);
+    });
+    it('counts every throw as a failure + error', async () => {
+        const r = await runLoadWindow({ workload: { rps: 50 } }, ctx(new AbortController().signal), {
+            windowMs: 300,
+            target: failingTarget,
+        });
+        expect(r.metrics.totalRequests).toBeGreaterThan(0);
+        expect(r.metrics.successfulRequests).toBe(0);
+        expect(r.metrics.failedRequests).toBe(r.metrics.totalRequests);
+        expect(r.metrics.errorsGenerated).toBe(r.metrics.failedRequests);
+    });
+    it('never exceeds the workload concurrency cap', async () => {
+        const ct = countingTarget(40);
+        await runLoadWindow({ workload: { rps: 200, concurrency: 3 } }, ctx(new AbortController().signal), {
+            windowMs: 400,
+            target: ct.target,
+        });
+        expect(ct.maxConcurrent()).toBeLessThanOrEqual(3);
+        expect(ct.calls()).toBeGreaterThan(0);
+    });
+    it('records real measured latency in the snapshot', async () => {
+        const ct = countingTarget(20);
+        const r = await runLoadWindow({ workload: { rps: 20 } }, ctx(new AbortController().signal), {
+            windowMs: 300,
+            target: ct.target,
+        });
+        expect(r.metrics.p50LatencyMs).toBeGreaterThanOrEqual(15);
+    });
+    it('applies ramp-up (issues fewer requests early)', async () => {
+        const ct = countingTarget();
+        const r = await runLoadWindow({ workload: { rps: 100, rampUp: 1 } }, ctx(new AbortController().signal), {
+            windowMs: 300,
+            target: ct.target,
+        });
+        // With a 1s ramp and a 300ms window, the loop never reaches full rps, so it
+        // issues materially fewer than rps*window would suggest — but still > 0.
+        expect(r.metrics.totalRequests).toBeGreaterThan(0);
+        expect(r.metrics.totalRequests).toBeLessThan(30);
+    });
+    it('issues no requests when pre-aborted', async () => {
+        const ac = new AbortController();
+        ac.abort();
+        const ct = countingTarget();
+        const r = await runLoadWindow({ workload: { rps: 50 } }, ctx(ac.signal), {
+            windowMs: 1000,
+            target: ct.target,
+        });
+        expect(r.metrics.totalRequests).toBe(0);
+        expect(ct.calls()).toBe(0);
+    });
+    it('stops dispatching after a mid-window abort and returns promptly', async () => {
+        const ac = new AbortController();
+        const ct = countingTarget(5);
+        setTimeout(() => ac.abort(), 120);
+        const start = Date.now();
+        const r = await runLoadWindow({ workload: { rps: 100 } }, ctx(ac.signal), {
+            windowMs: 5000,
+            target: ct.target,
+        });
+        expect(Date.now() - start).toBeLessThan(2000);
+        expect(r.metrics.totalRequests).toBeGreaterThan(0);
+    });
+});
+//# sourceMappingURL=run-load-window.test.js.map

package/dist/framework/execution/__tests__/run-load-window.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-load-window.test.js","sourceRoot":"","sources":["../../../../src/framework/execution/__tests__/run-load-window.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAElD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAC;AACzF,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAItD,MAAM,GAAG,GAAG,CAAC,MAAmB,EAA4B,EAAE,CAAC,CAAC;IAC9D,UAAU,EAAE,GAAG;IACf,aAAa,EAAE,GAAG;IAClB,WAAW,EAAE,MAAM;IACnB,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE;CACzE,CAAC,CAAC;AAEH,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;QACvE,MAAM,EAAE,GAAG,cAAc,EAAE,CAAC;QAC5B,MAAM,CAAC,GAAG,MAAM,aAAa,CAAC,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,IAAI,eAAe,EAAE,CAAC,MAAM,CAAC,EAAE;YAC1F,QAAQ,EAAE,GAAG;YACb,MAAM,EAAE,EAAE,CAAC,MAAM;SAClB,CAAC,CAAC;QACH,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QACnD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QACjD,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QACnE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;QACvD,MAAM,CAAC,GAAG,MAAM,aAAa,CAAC,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,IAAI,eAAe,EAAE,CAAC,MAAM,CAAC,EAAE;YAC1F,QAAQ,EAAE,GAAG;YACb,MAAM,EAAE,aAAa;SACtB,CAAC,CAAC;QACH,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QACnD,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC7C,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QAC/D,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC1D,MAAM,EAAE,GAAG,cAAc,CAAC,EAAE,CAAC,CAAC;QAC9B,MAAM,aAAa,CACjB,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC,EAAE,EAAE,EAC1C,GAAG,CAAC,IAAI,eAAe,EAAE,CAAC,MAAM,CAAC,EACjC;YACE,QAAQ,EAAE,GAAG;YACb,MAAM,EAAE,EAAE,CAAC,MAAM;SAClB,CACF,CAAC;QACF,MAAM,CAAC,EAAE,CAAC,aAAa,EAAE,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC;QAClD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;QAC7D,MAAM,EAAE,GAAG,cAAc,CAAC,EAAE,CAAC,CAAC;QAC9B,MAAM,CAAC,GAAG,MAAM,aAAa,CAAC,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,IAAI,eAAe,EAAE,CAAC,MAAM,CAAC,EAAE;YAC1F,QAAQ,EAAE,GAAG;YACb,MAAM,EAAE,EAAE,CAAC,MAAM;SAClB,CAAC,CAAC;QACH,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;QAC7D,MAAM,EAAE,GAAG,cAAc,EAAE,CAAC;QAC5B,MAAM,CAAC,GAAG,MAAM,aAAa,CAC3B,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,EACrC,GAAG,CAAC,IAAI,eAAe,EAAE,CAAC,MAAM,CAAC,EACjC;YACE,QAAQ,EAAE,GAAG;YACb,MAAM,EAAE,EAAE,CAAC,MAAM;SAClB,CACF,CAAC;QACF,4EAA4E;QAC5E,yEAAyE;QACzE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QACnD,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;QACnD,MAAM,EAAE,GAAG,IAAI,eAAe,EAAE,CAAC;QACjC,EAAE,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,EAAE,GAAG,cAAc,EAAE,CAAC;QAC5B,MAAM,CAAC,GAAG,MAAM,aAAa,CAAC,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE;YACvE,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,EAAE,CAAC,MAAM;SAClB,CAAC,CAAC;QACH,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACxC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,KAAK,IAAI,EAAE;QAC/E,MAAM,EAAE,GAAG,IAAI,eAAe,EAAE,CAAC;QACjC,MAAM,EAAE,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;QAC7B,UAAU,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,GAAG,CAAC,CAAC;QAClC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,MAAM,aAAa,CAAC,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE;YACxE,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,EAAE,CAAC,MAAM;SAClB,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/framework/execution/execution-engine.d.ts

@@ -0,0 +1,55 @@
+/**
+ * @fileoverview Small public utilities for scenario execution.
+ *
+ * Historically this file housed the legacy `runSimulationLoop` /
+ * `createScenario` / `createStandardExecutor` orchestration model. That
+ * model was retired once both kinds (load, chaos) unified on the new
+ * `ScenarioExecutionContext` / `runLoadWindow` model in Wave 4 of the
+ * Layer 3 remediation plan; the legacy `defineScenario` alias was deleted
+ * in the same release.
+ *
+ * What remains here is a small set of stable helpers consumed across
+ * the simulation runtime:
+ *
+ *   - `validateAssertions` — evaluate assertions against metrics.
+ *   - `updateLatencyMetrics` — quick in-loop latency sample update
+ *     (rough percentiles; prefer `LatencyTracker` when accuracy matters).
+ *   - `sleepWithAbort` — abortable sleep used by both windowed runs and
+ *     scenario test fixtures.
+ *   - `scenarioAborted` — standalone abort-check helper.
+ *
+ * `ScenarioAbortedError` is re-exported here so kind executors can keep
+ * importing it from a single, stable location.
+ */
+import type { SimulationMetrics, ScenarioAssertion } from '../../types/base-types.js';
+/**
+ * Validate assertions against metrics.
+ */
+export declare function validateAssertions(metrics: SimulationMetrics, assertions: ScenarioAssertion[]): {
+    passed: boolean;
+    failed: {
+        assertion: ScenarioAssertion;
+        actual: number;
+    }[];
+};
+/**
+ * Update latency metrics with a new sample.
+ *
+ * WARNING: Percentile values (p50, p95, p99) are rough estimates derived from
+ * the running average. For accurate percentiles, use LatencyTracker instead.
+ * This function is intended for quick in-loop metric updates where
+ * maintaining a full sample set is impractical.
+ */
+export declare function updateLatencyMetrics(metrics: SimulationMetrics, latency: number): void;
+/**
+ * Sleep for a specified duration with abort support.
+ * @throws {ScenarioAbortedError} When the abort signal is triggered
+ */
+export declare function sleepWithAbort(ms: number, signal: AbortSignal): Promise<void>;
+/**
+ * Standalone checkAborted helper for use outside an execution loop.
+ * @throws {ScenarioAbortedError} When the abort signal has been triggered
+ */
+export declare function scenarioAborted(signal: AbortSignal | undefined, scenarioId?: string): void;
+export { ScenarioAbortedError } from './scenario-aborted-error.js';
+//# sourceMappingURL=execution-engine.d.ts.map

package/dist/framework/execution/execution-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-engine.d.ts","sourceRoot":"","sources":["../../../src/framework/execution/execution-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAOH,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAMtF;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,iBAAiB,EAC1B,UAAU,EAAE,iBAAiB,EAAE,GAC9B;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE;QAAE,SAAS,EAAE,iBAAiB,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,CAiBjF;AAMD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CActF;AAMD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAmB7E;AAMD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAI1F;AAED,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/framework/execution/execution-engine.js

@@ -0,0 +1,111 @@
+/**
+ * @fileoverview Small public utilities for scenario execution.
+ *
+ * Historically this file housed the legacy `runSimulationLoop` /
+ * `createScenario` / `createStandardExecutor` orchestration model. That
+ * model was retired once both kinds (load, chaos) unified on the new
+ * `ScenarioExecutionContext` / `runLoadWindow` model in Wave 4 of the
+ * Layer 3 remediation plan; the legacy `defineScenario` alias was deleted
+ * in the same release.
+ *
+ * What remains here is a small set of stable helpers consumed across
+ * the simulation runtime:
+ *
+ *   - `validateAssertions` — evaluate assertions against metrics.
+ *   - `updateLatencyMetrics` — quick in-loop latency sample update
+ *     (rough percentiles; prefer `LatencyTracker` when accuracy matters).
+ *   - `sleepWithAbort` — abortable sleep used by both windowed runs and
+ *     scenario test fixtures.
+ *   - `scenarioAborted` — standalone abort-check helper.
+ *
+ * `ScenarioAbortedError` is re-exported here so kind executors can keep
+ * importing it from a single, stable location.
+ */
+import { evaluateOperator } from '../assertions.js';
+import { resolveMetric } from '../resolve-metric.js';
+import { ScenarioAbortedError } from './scenario-aborted-error.js';
+// =============================================================================
+// ASSERTION VALIDATION
+// =============================================================================
+/**
+ * Validate assertions against metrics.
+ */
+export function validateAssertions(metrics, assertions) {
+    if (!Array.isArray(assertions)) {
+        return { passed: false, failed: [] };
+    }
+    const failed = [];
+    for (const assertion of assertions) {
+        const actual = resolveMetric(assertion.metric, metrics);
+        const passed = evaluateOperator(actual, assertion.operator, assertion.value);
+        if (!passed) {
+            failed.push({ assertion, actual });
+        }
+    }
+    return { passed: failed.length === 0, failed };
+}
+// =============================================================================
+// METRICS UTILITIES
+// =============================================================================
+/**
+ * Update latency metrics with a new sample.
+ *
+ * WARNING: Percentile values (p50, p95, p99) are rough estimates derived from
+ * the running average. For accurate percentiles, use LatencyTracker instead.
+ * This function is intended for quick in-loop metric updates where
+ * maintaining a full sample set is impractical.
+ */
+export function updateLatencyMetrics(metrics, latency) {
+    const n = metrics.totalRequests;
+    if (n === 0) {
+        metrics.avgLatencyMs = latency;
+        metrics.p50LatencyMs = latency;
+        metrics.p95LatencyMs = latency;
+        metrics.p99LatencyMs = latency;
+    }
+    else {
+        metrics.avgLatencyMs = (metrics.avgLatencyMs * (n - 1) + latency) / n;
+        // Rough estimates — use LatencyTracker.getLatencySnapshot() for real percentiles
+        metrics.p50LatencyMs = metrics.avgLatencyMs * 0.9;
+        metrics.p95LatencyMs = metrics.avgLatencyMs * 1.5;
+        metrics.p99LatencyMs = metrics.avgLatencyMs * 2;
+    }
+}
+// =============================================================================
+// SLEEP UTILITY
+// =============================================================================
+/**
+ * Sleep for a specified duration with abort support.
+ * @throws {ScenarioAbortedError} When the abort signal is triggered
+ */
+export function sleepWithAbort(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal.aborted) {
+            reject(new ScenarioAbortedError());
+            return;
+        }
+        const abortHandler = () => {
+            clearTimeout(timeout);
+            reject(new ScenarioAbortedError());
+        };
+        const timeout = setTimeout(() => {
+            signal.removeEventListener('abort', abortHandler);
+            resolve();
+        }, ms);
+        signal.addEventListener('abort', abortHandler, { once: true });
+    });
+}
+// =============================================================================
+// ABORT HELPER
+// =============================================================================
+/**
+ * Standalone checkAborted helper for use outside an execution loop.
+ * @throws {ScenarioAbortedError} When the abort signal has been triggered
+ */
+export function scenarioAborted(signal, scenarioId) {
+    if (signal?.aborted) {
+        throw new ScenarioAbortedError(scenarioId);
+    }
+}
+export { ScenarioAbortedError } from './scenario-aborted-error.js';
+//# sourceMappingURL=execution-engine.js.map

package/dist/framework/execution/execution-engine.js.map

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

package/dist/framework/execution/fault-builders.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @fileoverview `fault.*` — ergonomic builders for a {@link FaultSpec}.
+ *
+ * Authors describe client-side faults declaratively:
+ *
+ * ```ts
+ * fault.of([fault.latency({ ms: 800 }), fault.drop()], { probability: 0.1 })
+ * ```
+ */
+import type { Fault, FaultSpec } from './fault-spec.js';
+/** Builders for the client-side fault vocabulary + a `FaultSpec` assembler. */
+export declare const fault: {
+    /** Delay the real call by `ms` (a slow-dependency symptom). */
+    readonly latency: (o: {
+        ms: number;
+    }) => Fault;
+    /** Abort the in-flight request (a timeout / cancellation). */
+    readonly abort: () => Fault;
+    /** Skip the call entirely, counting a client-observed failure. */
+    readonly drop: () => Fault;
+    /** Assemble a probability-gated set of candidate faults. */
+    readonly of: (faults: readonly Fault[], o: {
+        probability: number;
+    }) => FaultSpec;
+};
+//# sourceMappingURL=fault-builders.d.ts.map

package/dist/framework/execution/fault-builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fault-builders.d.ts","sourceRoot":"","sources":["../../../src/framework/execution/fault-builders.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAExD,+EAA+E;AAC/E,eAAO,MAAM,KAAK;IAChB,+DAA+D;0BAClD;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,KAAG,KAAK;IACnC,8DAA8D;0BACnD,KAAK;IAChB,kEAAkE;yBACxD,KAAK;IACf,4DAA4D;0BAC/C,SAAS,KAAK,EAAE,KAAK;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,KAAG,SAAS;CAI7D,CAAC"}

package/dist/framework/execution/fault-builders.js

@@ -0,0 +1,24 @@
+/**
+ * @fileoverview `fault.*` — ergonomic builders for a {@link FaultSpec}.
+ *
+ * Authors describe client-side faults declaratively:
+ *
+ * ```ts
+ * fault.of([fault.latency({ ms: 800 }), fault.drop()], { probability: 0.1 })
+ * ```
+ */
+/** Builders for the client-side fault vocabulary + a `FaultSpec` assembler. */
+export const fault = {
+    /** Delay the real call by `ms` (a slow-dependency symptom). */
+    latency: (o) => ({ kind: 'latency', ms: o.ms }),
+    /** Abort the in-flight request (a timeout / cancellation). */
+    abort: () => ({ kind: 'abort' }),
+    /** Skip the call entirely, counting a client-observed failure. */
+    drop: () => ({ kind: 'drop' }),
+    /** Assemble a probability-gated set of candidate faults. */
+    of: (faults, o) => ({
+        faults,
+        probability: o.probability,
+    }),
+};
+//# sourceMappingURL=fault-builders.js.map

package/dist/framework/execution/fault-builders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fault-builders.js","sourceRoot":"","sources":["../../../src/framework/execution/fault-builders.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,+EAA+E;AAC/E,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,+DAA+D;IAC/D,OAAO,EAAE,CAAC,CAAiB,EAAS,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;IACtE,8DAA8D;IAC9D,KAAK,EAAE,GAAU,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACvC,kEAAkE;IAClE,IAAI,EAAE,GAAU,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACrC,4DAA4D;IAC5D,EAAE,EAAE,CAAC,MAAwB,EAAE,CAA0B,EAAa,EAAE,CAAC,CAAC;QACxE,MAAM;QACN,WAAW,EAAE,CAAC,CAAC,WAAW;KAC3B,CAAC;CACM,CAAC"}

package/dist/framework/execution/fault-model.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @fileoverview `FaultModel` — real client-side fault injection as a
+ * `Target` decorator.
+ *
+ * Replaces the old synthetic `injectChaos`. Where that fabricated failure
+ * outcomes, the fault model perturbs the **real** request:
+ *
+ *   - `latency` — delay the real call by `ms` (the underlying target still
+ *                 runs; the added latency shows up in the measured snapshot).
+ *   - `abort`   — abort the in-flight request, so it fails as a timeout /
+ *                 cancellation. Enforced even for targets that ignore the
+ *                 abort signal (we await the aborted call, then throw).
+ *   - `drop`    — skip the call entirely and throw, so the driver counts a
+ *                 real client-observed failure.
+ *
+ * The probability gate is driven by an injected RNG (`deps.rng`, default
+ * `Math.random`) so tests can pass a stubbed sequence and assert the exact set
+ * of perturbed requests. Fault selection among `spec.faults` is round-robin —
+ * deterministic without consuming extra RNG draws.
+ */
+import type { FaultKind, FaultSpec } from './fault-spec.js';
+import type { Target } from './target.js';
+/** A fault occurrence recorded for diagnostics (→ `ChaosEvent`). */
+export interface FiredFault {
+    readonly kind: FaultKind;
+    /** Absolute wall-clock time the fault fired (ms). */
+    readonly at: number;
+}
+/** Dependencies for the fault model. */
+export interface FaultModelDeps {
+    /** Probability-gate RNG in `[0,1)`. Defaults to `Math.random`. */
+    readonly rng?: () => number;
+}
+/** A fault model bound to a `FaultSpec`. */
+export interface FaultModel {
+    /** Decorate a target so each call may be perturbed at `spec.probability`. */
+    wrap(target: Target): Target;
+    /** The faults that fired so far, in order. */
+    drained(): readonly FiredFault[];
+}
+/**
+ * Build a fault model for a `FaultSpec`.
+ *
+ * The returned `wrap` is intended to be called once (for the steady-state
+ * window); the recovery window uses the bare target. `drained()` reports the
+ * faults that fired, for the chaos result's `ChaosEvent[]`.
+ */
+export declare function createFaultModel(spec: FaultSpec, deps?: FaultModelDeps): FaultModel;
+//# sourceMappingURL=fault-model.d.ts.map

package/dist/framework/execution/fault-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fault-model.d.ts","sourceRoot":"","sources":["../../../src/framework/execution/fault-model.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAS,SAAS,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,aAAa,CAAC;AAEzD,oEAAoE;AACpE,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,wCAAwC;AACxC,MAAM,WAAW,cAAc;IAC7B,kEAAkE;IAClE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CAC7B;AAED,4CAA4C;AAC5C,MAAM,WAAW,UAAU;IACzB,6EAA6E;IAC7E,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,8CAA8C;IAC9C,OAAO,IAAI,SAAS,UAAU,EAAE,CAAC;CAClC;AAoBD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,GAAE,cAAmB,GAAG,UAAU,CAgEvF"}

package/dist/framework/execution/fault-model.js

@@ -0,0 +1,108 @@
+/**
+ * @fileoverview `FaultModel` — real client-side fault injection as a
+ * `Target` decorator.
+ *
+ * Replaces the old synthetic `injectChaos`. Where that fabricated failure
+ * outcomes, the fault model perturbs the **real** request:
+ *
+ *   - `latency` — delay the real call by `ms` (the underlying target still
+ *                 runs; the added latency shows up in the measured snapshot).
+ *   - `abort`   — abort the in-flight request, so it fails as a timeout /
+ *                 cancellation. Enforced even for targets that ignore the
+ *                 abort signal (we await the aborted call, then throw).
+ *   - `drop`    — skip the call entirely and throw, so the driver counts a
+ *                 real client-observed failure.
+ *
+ * The probability gate is driven by an injected RNG (`deps.rng`, default
+ * `Math.random`) so tests can pass a stubbed sequence and assert the exact set
+ * of perturbed requests. Fault selection among `spec.faults` is round-robin —
+ * deterministic without consuming extra RNG draws.
+ */
+function delay(ms, signal) {
+    return new Promise((resolve) => {
+        if (signal.aborted) {
+            resolve();
+            return;
+        }
+        const timeout = setTimeout(() => {
+            signal.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timeout);
+            resolve();
+        };
+        signal.addEventListener('abort', onAbort, { once: true });
+    });
+}
+/**
+ * Build a fault model for a `FaultSpec`.
+ *
+ * The returned `wrap` is intended to be called once (for the steady-state
+ * window); the recovery window uses the bare target. `drained()` reports the
+ * faults that fired, for the chaos result's `ChaosEvent[]`.
+ */
+export function createFaultModel(spec, deps = {}) {
+    const rng = deps.rng ?? Math.random;
+    const fired = [];
+    let perturbCount = 0;
+    /**
+     * Apply a single fault to a target invocation.
+     * @throws {Error} `fault:abort` when the abort fault fires, or `fault:drop` when the drop fault fires.
+     */
+    async function applyFault(fault, target, ctx) {
+        fired.push({ kind: fault.kind, at: Date.now() });
+        switch (fault.kind) {
+            case 'latency': {
+                await delay(fault.ms, ctx.signal);
+                await target(ctx);
+                return;
+            }
+            case 'abort': {
+                // Abort the request: hand a well-behaved target an already-aborted
+                // signal so it cancels, but guarantee the request fails regardless of
+                // whether the target honours the signal (we throw deterministically).
+                const controller = new AbortController();
+                // @fitness-ignore-next-line detached-promises -- AbortController.abort() is a synchronous void call, not a promise
+                controller.abort();
+                const signal = typeof AbortSignal.any === 'function'
+                    ? AbortSignal.any([ctx.signal, controller.signal])
+                    : controller.signal;
+                // Let a signal-aware target observe the abort, but guarantee a failure:
+                // whether it rejects on the signal or ignores it and resolves, we throw.
+                try {
+                    await target({ signal, correlationId: ctx.correlationId });
+                }
+                catch {
+                    // @swallow-ok target observed the abort (or otherwise failed); we throw fault:abort below regardless.
+                }
+                throw new Error('fault:abort');
+            }
+            case 'drop': {
+                // Never reach the target; the driver counts a client-observed failure.
+                throw new Error('fault:drop');
+            }
+        }
+    }
+    return {
+        wrap(target) {
+            return async (ctx) => {
+                if (rng() >= spec.probability || spec.faults.length === 0) {
+                    await target(ctx);
+                    return;
+                }
+                const fault = spec.faults[perturbCount % spec.faults.length];
+                perturbCount++;
+                if (!fault) {
+                    await target(ctx);
+                    return;
+                }
+                await applyFault(fault, target, ctx);
+            };
+        },
+        drained() {
+            return fired;
+        },
+    };
+}
+//# sourceMappingURL=fault-model.js.map

package/dist/framework/execution/fault-model.js.map

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

package/dist/framework/execution/fault-spec.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @fileoverview `FaultSpec` — the author-facing, **client-side** fault
+ * vocabulary for the chaos kind.
+ *
+ * The harness can honestly inject only client-side perturbations of the real
+ * request stream:
+ *
+ *   - `latency` — delay the real call (a slow-dependency symptom).
+ *   - `abort`   — abort the in-flight request (a timeout / cancellation).
+ *   - `drop`    — skip the call entirely, counting a client-observed failure
+ *                 (a dropped request / open circuit).
+ *
+ * Server-side faults (kill a pod, force 500s, sever a dependency) cannot be
+ * injected honestly from the client. They are achieved by pointing the
+ * `Target` at a **fault-injectable endpoint you control** (e.g. a Toxiproxy
+ * proxy, a chaos-mesh'd staging env, a test-flagged endpoint) — the harness
+ * drives and measures around it. That pattern is documented, not expressed
+ * here.
+ *
+ * Leaf module: imports nothing from the type or runtime layers.
+ */
+/** The client-injectable fault kinds. */
+export type FaultKind = 'latency' | 'abort' | 'drop';
+/** A single client-side fault the model may apply to a request. */
+export type Fault = {
+    readonly kind: 'latency';
+    readonly ms: number;
+} | {
+    readonly kind: 'abort';
+} | {
+    readonly kind: 'drop';
+};
+/** Probability-gated set of client-side faults for a chaos scenario. */
+export interface FaultSpec {
+    /** Candidate faults; one is selected when a request is perturbed. */
+    readonly faults: readonly Fault[];
+    /** Per-request probability `[0,1]` that a fault is applied. */
+    readonly probability: number;
+}
+//# sourceMappingURL=fault-spec.d.ts.map

package/dist/framework/execution/fault-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fault-spec.d.ts","sourceRoot":"","sources":["../../../src/framework/execution/fault-spec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,yCAAyC;AACzC,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAErD,mEAAmE;AACnE,MAAM,MAAM,KAAK,GACb;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9B,wEAAwE;AACxE,MAAM,WAAW,SAAS;IACxB,qEAAqE;IACrE,QAAQ,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;IAClC,+DAA+D;IAC/D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B"}

package/dist/framework/execution/fault-spec.js

@@ -0,0 +1,23 @@
+/**
+ * @fileoverview `FaultSpec` — the author-facing, **client-side** fault
+ * vocabulary for the chaos kind.
+ *
+ * The harness can honestly inject only client-side perturbations of the real
+ * request stream:
+ *
+ *   - `latency` — delay the real call (a slow-dependency symptom).
+ *   - `abort`   — abort the in-flight request (a timeout / cancellation).
+ *   - `drop`    — skip the call entirely, counting a client-observed failure
+ *                 (a dropped request / open circuit).
+ *
+ * Server-side faults (kill a pod, force 500s, sever a dependency) cannot be
+ * injected honestly from the client. They are achieved by pointing the
+ * `Target` at a **fault-injectable endpoint you control** (e.g. a Toxiproxy
+ * proxy, a chaos-mesh'd staging env, a test-flagged endpoint) — the harness
+ * drives and measures around it. That pattern is documented, not expressed
+ * here.
+ *
+ * Leaf module: imports nothing from the type or runtime layers.
+ */
+export {};
+//# sourceMappingURL=fault-spec.js.map

package/dist/framework/execution/fault-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fault-spec.js","sourceRoot":"","sources":["../../../src/framework/execution/fault-spec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG"}

package/dist/framework/execution/http-target.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @fileoverview `httpTarget` — an HTTP `Target` factory.
+ *
+ * The smallest BYO seam is a function, but most users point at an HTTP
+ * endpoint. `httpTarget` wraps the built-in `fetch` (Node 24+) into a `Target`:
+ * it forwards `ctx.signal` (so scenario abort + `abort` faults cancel the
+ * request) and **throws on a non-OK status** so the driver classifies it as a
+ * failure.
+ *
+ * Point this only at a target you own. For server-side fault injection (kill a
+ * dependency, force 500s), put a fault-injectable proxy (e.g. Toxiproxy) in
+ * front and aim `httpTarget` at the proxy — the harness drives and measures
+ * around it.
+ */
+import type { Target } from './target.js';
+/** Options for {@link httpTarget}. */
+export interface HttpTargetOptions {
+    /** Absolute URL to request. */
+    readonly url: string;
+    /** HTTP method. Defaults to `GET`. */
+    readonly method?: string;
+    /** Request headers. */
+    readonly headers?: Record<string, string>;
+    /** Optional request body. */
+    readonly body?: string;
+    /**
+     * Predicate deciding whether a response counts as success. Defaults to
+     * `200`–`299`. A non-OK status makes the request throw (a failure).
+     */
+    readonly okStatus?: (status: number) => boolean;
+}
+/** Build an HTTP {@link Target} from a URL + method/headers/body. */
+export declare function httpTarget(opts: HttpTargetOptions): Target;
+//# sourceMappingURL=http-target.d.ts.map

package/dist/framework/execution/http-target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-target.d.ts","sourceRoot":"","sources":["../../../src/framework/execution/http-target.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,aAAa,CAAC;AAEzD,sCAAsC;AACtC,MAAM,WAAW,iBAAiB;IAChC,+BAA+B;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,uBAAuB;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,6BAA6B;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;CACjD;AAID,qEAAqE;AACrE,wBAAgB,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAsB1D"}