@opensip-cli/simulation 0.1.0

package/dist/kinds/chaos/result.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @fileoverview Chaos-kind result outcome.
+ *
+ * The chaos kind composes a load run with explicit failure injection +
+ * recovery assertions. The outcome carries:
+ *   - the load metrics during the steady-state phase
+ *   - the steady-state assertion verdicts (held while chaos is active)
+ *   - the recovery assertion verdicts (held after chaos lifts)
+ *   - the chaos events that fired during the run
+ */
+import type { FaultKind } from '../../framework/execution/fault-spec.js';
+import type { SimulationMetrics } from '../../types/base-types.js';
+import type { ScenarioAssertion, FailedAssertion } from '../../types/framework-types.js';
+/** A single fault occurrence recorded during the run, for diagnostics. */
+export interface ChaosEvent {
+    /** Which client-side fault fired. */
+    readonly type: FaultKind;
+    /** Milliseconds into the steady-state window when it fired. */
+    readonly atMs: number;
+    /** Where the perturbation was applied (the client request site). */
+    readonly target: string;
+}
+/** Verdict bundle for a single assertion phase (steady-state OR recovery). */
+export interface ChaosAssertionVerdict {
+    readonly passed: readonly ScenarioAssertion[];
+    readonly failed: readonly FailedAssertion[];
+}
+/** Outcome payload for a chaos-kind scenario. */
+export interface ChaosOutcome {
+    /** Aggregated metrics for the steady-state (chaos-active) window. */
+    readonly steadyStateMetrics: SimulationMetrics;
+    /** Aggregated metrics for the recovery window after chaos lifts. */
+    readonly recoveryMetrics: SimulationMetrics;
+    /** Verdicts for the steady-state assertions. */
+    readonly steadyStateAssertions: ChaosAssertionVerdict;
+    /** Verdicts for the recovery assertions. */
+    readonly recoveryAssertions: ChaosAssertionVerdict;
+    /** Chaos events recorded during the run. */
+    readonly chaosEvents: readonly ChaosEvent[];
+    /** Recovery window in ms after chaos lifts. */
+    readonly recoveryWindowMs: number;
+}
+//# sourceMappingURL=result.d.ts.map

package/dist/kinds/chaos/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../../src/kinds/chaos/result.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEzF,0EAA0E;AAC1E,MAAM,WAAW,UAAU;IACzB,qCAAqC;IACrC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,8EAA8E;AAC9E,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;CAC7C;AAED,iDAAiD;AACjD,MAAM,WAAW,YAAY;IAC3B,qEAAqE;IACrE,QAAQ,CAAC,kBAAkB,EAAE,iBAAiB,CAAC;IAC/C,oEAAoE;IACpE,QAAQ,CAAC,eAAe,EAAE,iBAAiB,CAAC;IAC5C,gDAAgD;IAChD,QAAQ,CAAC,qBAAqB,EAAE,qBAAqB,CAAC;IACtD,4CAA4C;IAC5C,QAAQ,CAAC,kBAAkB,EAAE,qBAAqB,CAAC;IACnD,4CAA4C;IAC5C,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;IAC5C,+CAA+C;IAC/C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC"}

package/dist/kinds/chaos/result.js

@@ -0,0 +1,12 @@
+/**
+ * @fileoverview Chaos-kind result outcome.
+ *
+ * The chaos kind composes a load run with explicit failure injection +
+ * recovery assertions. The outcome carries:
+ *   - the load metrics during the steady-state phase
+ *   - the steady-state assertion verdicts (held while chaos is active)
+ *   - the recovery assertion verdicts (held after chaos lifts)
+ *   - the chaos events that fired during the run
+ */
+export {};
+//# sourceMappingURL=result.js.map

package/dist/kinds/chaos/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../../src/kinds/chaos/result.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/kinds/load/__tests__/executor.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Behaviour + validation tests for the load kind against the
+ * real driver.
+ */
+export {};
+//# sourceMappingURL=executor.test.d.ts.map

package/dist/kinds/load/__tests__/executor.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.test.d.ts","sourceRoot":"","sources":["../../../../src/kinds/load/__tests__/executor.test.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/kinds/load/__tests__/executor.test.js

@@ -0,0 +1,75 @@
+/**
+ * @fileoverview Behaviour + validation tests for the load kind against the
+ * real driver.
+ */
+import { describe, expect, it } from 'vitest';
+import { countingTarget, failingTarget, noopTarget, } from '../../../__tests__/test-utils/targets.js';
+import { ASSERTIONS } from '../../../framework/assertions.js';
+import { defineLoadScenario, validateLoadScenarioConfig } from '../define.js';
+import { createLoadScenarioRunner } from '../executor.js';
+const base = (o = {}) => ({
+    id: 'l',
+    name: 'l',
+    description: 'l',
+    tags: [],
+    target: noopTarget,
+    workload: { rps: 50 },
+    duration: 0.3,
+    assertions: [ASSERTIONS.lowErrorRate(0.5)],
+    ...o,
+});
+describe('load executor', () => {
+    it('drives the target in a sustained loop (many requests, not one)', async () => {
+        const ct = countingTarget();
+        const r = await createLoadScenarioRunner(base({ target: ct.target, workload: { rps: 100 } })).run(new AbortController().signal);
+        if (r.kind !== 'load')
+            throw new Error('expected load result');
+        expect(r.outcome.metrics.totalRequests).toBeGreaterThan(5);
+        expect(ct.calls()).toBe(r.outcome.metrics.totalRequests);
+    });
+    it('passes when the target succeeds', async () => {
+        const r = await createLoadScenarioRunner(base()).run(new AbortController().signal);
+        if (r.kind !== 'load')
+            throw new Error('expected load result');
+        expect(r.passed).toBe(true);
+    });
+    it('fails when the target fails', async () => {
+        const r = await createLoadScenarioRunner(base({ target: failingTarget, assertions: [ASSERTIONS.lowErrorRate(0.1)] })).run(new AbortController().signal);
+        if (r.kind !== 'load')
+            throw new Error('expected load result');
+        expect(r.passed).toBe(false);
+    });
+    it('throws on a pre-aborted signal', async () => {
+        const ac = new AbortController();
+        ac.abort();
+        await expect(createLoadScenarioRunner(base()).run(ac.signal)).rejects.toThrow(/abort/i);
+    });
+});
+describe('validateLoadScenarioConfig', () => {
+    it('accepts a valid config via defineLoadScenario', () => {
+        expect(defineLoadScenario(base()).kind).toBe('load');
+    });
+    it('rejects a non-function target', () => {
+        expect(() => validateLoadScenarioConfig(base({ target: undefined }))).toThrow(/target/);
+    });
+    it('rejects a non-positive rps', () => {
+        expect(() => validateLoadScenarioConfig(base({ workload: { rps: 0 } }))).toThrow(/rps/);
+    });
+    it('rejects rampUp greater than duration', () => {
+        expect(() => validateLoadScenarioConfig(base({ duration: 1, workload: { rps: 1, rampUp: 5 } }))).toThrow(/rampUp/);
+    });
+    it('rejects a negative rampUp (non-negative shape check)', () => {
+        expect(() => validateLoadScenarioConfig(base({ workload: { rps: 1, rampUp: -1 } }))).toThrow(/rampUp must be a non-negative number/);
+    });
+    it('rejects a non-number rampUp', () => {
+        expect(() => validateLoadScenarioConfig(base({ workload: { rps: 1, rampUp: 'soon' } }))).toThrow(/rampUp must be a non-negative number/);
+    });
+    it('rejects a non-positive duration', () => {
+        expect(() => validateLoadScenarioConfig(base({ duration: 0 }))).toThrow(/duration/);
+        expect(() => validateLoadScenarioConfig(base({ duration: 'x' }))).toThrow(/duration/);
+    });
+    it('rejects empty assertions', () => {
+        expect(() => validateLoadScenarioConfig(base({ assertions: [] }))).toThrow(/assertion/);
+    });
+});
+//# sourceMappingURL=executor.test.js.map

package/dist/kinds/load/__tests__/executor.test.js.map

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

package/dist/kinds/load/config.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @fileoverview `LoadScenarioConfig` — author-facing configuration.
+ *
+ * Extracted from `define.ts` into its own leaf module so `executor.ts`
+ * can reference the config shape without forming a file-level cycle.
+ * See `../chaos/config.ts` for the same pattern.
+ */
+import type { Target } from '../../framework/execution/target.js';
+import type { ScenarioAssertion } from '../../types/framework-types.js';
+import type { Workload } from '../../types/workload.js';
+/**
+ * Author-facing configuration for a load scenario.
+ *
+ * The `kind` discriminator is intentionally omitted — `defineLoadScenario`
+ * sets it. The `target` is the BYO seam the driver calls once per request.
+ */
+export interface LoadScenarioConfig {
+    readonly id: string;
+    readonly name: string;
+    readonly description: string;
+    readonly tags: readonly string[];
+    /** The BYO target driven once per request (throws on failure). */
+    readonly target: Target;
+    /** Arrival-rate workload (rps + optional concurrency/ramp). */
+    readonly workload: Workload;
+    /** Window duration, in seconds. */
+    readonly duration: number;
+    readonly assertions: readonly ScenarioAssertion[];
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/kinds/load/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/kinds/load/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qCAAqC,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAExD;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IAEjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IAGjC,kEAAkE;IAClE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,+DAA+D;IAC/D,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,mCAAmC;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAG1B,QAAQ,CAAC,UAAU,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACnD"}

package/dist/kinds/load/config.js

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview `LoadScenarioConfig` — author-facing configuration.
+ *
+ * Extracted from `define.ts` into its own leaf module so `executor.ts`
+ * can reference the config shape without forming a file-level cycle.
+ * See `../chaos/config.ts` for the same pattern.
+ */
+export {};
+//# sourceMappingURL=config.js.map

package/dist/kinds/load/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/kinds/load/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/kinds/load/define.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @fileoverview `defineLoadScenario` — load-kind entry point.
+ *
+ * The load kind drives a BYO `target` at a `workload` (rps + optional
+ * concurrency/ramp) over `duration` seconds and asserts measured SLOs. The
+ * author-facing config interface is `LoadScenarioConfig` (no `kind` field — the
+ * entry point sets it). Validation runs at definition time; registration is the
+ * caller's responsibility (the simulation plugin loader walks `module.scenarios`
+ * and registers them into `scope.registries.scenarios`).
+ */
+import type { LoadScenarioConfig } from './config.js';
+import type { RunnableScenario } from '../../framework/runnable-scenario.js';
+export type { LoadScenarioConfig } from './config.js';
+/**
+ * Validate a load scenario configuration. Throws on invalid input.
+ *
+ * Uniqueness against an existing scenario registry is checked at
+ * registration time (`scope.registries.scenarios.register(...)`), not
+ * here — `defineX` returns a scenario object without touching any
+ * registry.
+ *
+ * @throws {ValidationError} When the load scenario configuration is invalid
+ */
+export declare function validateLoadScenarioConfig(config: LoadScenarioConfig): void;
+/**
+ * Define a load-kind simulation scenario.
+ *
+ * @example
+ * ```typescript
+ * export const myScenario = defineLoadScenario({
+ *   id: 'my-scenario',
+ *   name: 'My Scenario',
+ *   description: 'Drives the checkout endpoint',
+ *   tags: ['smoke'],
+ *   target: httpTarget({ url: process.env.TARGET_URL! }),
+ *   workload: { rps: 50, rampUp: 5 },
+ *   duration: 300,
+ *   assertions: [
+ *     ASSERTIONS.lowErrorRate(),
+ *     ASSERTIONS.lowLatency('p95', 500),
+ *   ],
+ * });
+ * ```
+ * @throws {ValidationError} When the scenario configuration is invalid
+ */
+export declare function defineLoadScenario(config: LoadScenarioConfig): RunnableScenario;
+//# sourceMappingURL=define.d.ts.map

package/dist/kinds/load/define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../../src/kinds/load/define.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAWH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAK7E,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAkBtD;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAiB3E;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,gBAAgB,CAI/E"}

package/dist/kinds/load/define.js

@@ -0,0 +1,76 @@
+/**
+ * @fileoverview `defineLoadScenario` — load-kind entry point.
+ *
+ * The load kind drives a BYO `target` at a `workload` (rps + optional
+ * concurrency/ramp) over `duration` seconds and asserts measured SLOs. The
+ * author-facing config interface is `LoadScenarioConfig` (no `kind` field — the
+ * entry point sets it). Validation runs at definition time; registration is the
+ * caller's responsibility (the simulation plugin loader walks `module.scenarios`
+ * and registers them into `scope.registries.scenarios`).
+ */
+import { throwValidationErrors, validateScenarioMetadata, validateTargetAndWorkload, } from '../../framework/validation.js';
+import { createLoadScenarioRunner } from './executor.js';
+function validateRampUp(config, errors) {
+    const { rampUp } = config.workload ?? {};
+    if (rampUp === undefined)
+        return;
+    if (typeof rampUp !== 'number' || rampUp < 0) {
+        errors.push({
+            field: 'workload.rampUp',
+            message: 'workload.rampUp must be a non-negative number',
+        });
+        return;
+    }
+    if (rampUp > config.duration) {
+        errors.push({ field: 'workload.rampUp', message: 'workload.rampUp cannot exceed duration' });
+    }
+}
+/**
+ * Validate a load scenario configuration. Throws on invalid input.
+ *
+ * Uniqueness against an existing scenario registry is checked at
+ * registration time (`scope.registries.scenarios.register(...)`), not
+ * here — `defineX` returns a scenario object without touching any
+ * registry.
+ *
+ * @throws {ValidationError} When the load scenario configuration is invalid
+ */
+export function validateLoadScenarioConfig(config) {
+    const errors = [];
+    validateScenarioMetadata(config, errors);
+    validateTargetAndWorkload(config, errors);
+    if (typeof config.duration !== 'number' || config.duration <= 0) {
+        errors.push({ field: 'duration', message: 'duration must be a positive number' });
+    }
+    validateRampUp(config, errors);
+    if (config.assertions.length === 0) {
+        errors.push({ field: 'assertions', message: 'at least one assertion is required' });
+    }
+    throwValidationErrors(errors, 'load');
+}
+/**
+ * Define a load-kind simulation scenario.
+ *
+ * @example
+ * ```typescript
+ * export const myScenario = defineLoadScenario({
+ *   id: 'my-scenario',
+ *   name: 'My Scenario',
+ *   description: 'Drives the checkout endpoint',
+ *   tags: ['smoke'],
+ *   target: httpTarget({ url: process.env.TARGET_URL! }),
+ *   workload: { rps: 50, rampUp: 5 },
+ *   duration: 300,
+ *   assertions: [
+ *     ASSERTIONS.lowErrorRate(),
+ *     ASSERTIONS.lowLatency('p95', 500),
+ *   ],
+ * });
+ * ```
+ * @throws {ValidationError} When the scenario configuration is invalid
+ */
+export function defineLoadScenario(config) {
+    validateLoadScenarioConfig(config);
+    return createLoadScenarioRunner(config);
+}
+//# sourceMappingURL=define.js.map

package/dist/kinds/load/define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../../../src/kinds/load/define.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,yBAAyB,GAE1B,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAUzD,SAAS,cAAc,CAAC,MAA0B,EAAE,MAAiC;IACnF,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;IACzC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO;IAEjC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7C,MAAM,CAAC,IAAI,CAAC;YACV,KAAK,EAAE,iBAAiB;YACxB,OAAO,EAAE,+CAA+C;SACzD,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IACD,IAAI,MAAM,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC7B,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,wCAAwC,EAAE,CAAC,CAAC;IAC/F,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,0BAA0B,CAAC,MAA0B;IACnE,MAAM,MAAM,GAA8B,EAAE,CAAC;IAE7C,wBAAwB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,yBAAyB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE1C,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,IAAI,CAAC,EAAE,CAAC;QAChE,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,oCAAoC,EAAE,CAAC,CAAC;IACpF,CAAC;IAED,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE/B,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,oCAAoC,EAAE,CAAC,CAAC;IACtF,CAAC;IAED,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAA0B;IAC3D,0BAA0B,CAAC,MAAM,CAAC,CAAC;IAEnC,OAAO,wBAAwB,CAAC,MAAM,CAAC,CAAC;AAC1C,CAAC"}

package/dist/kinds/load/executor.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @fileoverview Load-kind executor.
+ *
+ * Drives the BYO `target` through the shared `runLoadWindow` driver at the
+ * configured `workload`, then scores the measured metrics against the
+ * scenario's assertions. The load kind is the "default" version of the loop
+ * (no fault injection).
+ */
+import type { LoadScenarioConfig } from './config.js';
+import type { RunnableScenario } from '../../framework/runnable-scenario.js';
+/**
+ * Build a `RunnableScenario` for a load-kind config. The returned object is
+ * frozen and carries `kind: 'load'`.
+ */
+export declare function createLoadScenarioRunner(config: LoadScenarioConfig): RunnableScenario;
+//# sourceMappingURL=executor.d.ts.map

package/dist/kinds/load/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/kinds/load/executor.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AASH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAuD7E;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,kBAAkB,GAAG,gBAAgB,CAkCrF"}

package/dist/kinds/load/executor.js

@@ -0,0 +1,90 @@
+// @fitness-ignore-file null-safety -- ScenarioResultBuilder.create() returns a fluent builder; chained method calls are always safe
+// @fitness-ignore-file array-validation -- array parameters validated at API boundary
+// @fitness-ignore-file detached-promises -- ScenarioResultBuilder fluent calls and runLoadWindow delegate are synchronous outside their awaited boundaries
+/**
+ * @fileoverview Load-kind executor.
+ *
+ * Drives the BYO `target` through the shared `runLoadWindow` driver at the
+ * configured `workload`, then scores the measured metrics against the
+ * scenario's assertions. The load kind is the "default" version of the loop
+ * (no fault injection).
+ */
+import { withSpanAsync } from '@opensip-cli/core';
+import { ScenarioAbortedError } from '../../framework/execution/execution-engine.js';
+import { runLoadWindow } from '../../framework/execution/run-load-window.js';
+import { ScenarioResultBuilder } from '../../framework/result-builder.js';
+import { createScenarioLogger } from '../../framework/scenario-logger.js';
+/**
+ * Run the load window against the BYO target and wrap the measured metrics +
+ * assertion verdicts into the kind-specific envelope.
+ */
+async function executeLoad(config, context) {
+    const startTime = Date.now();
+    context.logger.info('Starting load scenario execution', {
+        duration: config.duration,
+        rps: config.workload.rps,
+    });
+    const window = await withSpanAsync('opensip-cli-simulation', 'simulation.scenario.execute', async () => runLoadWindow({ workload: config.workload }, context, {
+        windowMs: config.duration * 1000,
+        target: config.target,
+    }), {
+        'simulation.scenario.id': config.id,
+        'simulation.kind': 'load',
+    });
+    const built = ScenarioResultBuilder.create(config.id)
+        .withMetrics(window.metrics)
+        .withDuration(config.duration)
+        .evaluateAssertions(config.assertions)
+        .build();
+    return Object.freeze({
+        kind: 'load',
+        scenarioId: config.id,
+        passed: built.passed,
+        durationMs: Date.now() - startTime,
+        signals: built.signals,
+        outcome: Object.freeze({
+            metrics: built.metrics,
+            assertions: built.assertions,
+        }),
+    });
+}
+// =============================================================================
+// RUNNABLE SCENARIO FACTORY
+// =============================================================================
+/**
+ * Build a `RunnableScenario` for a load-kind config. The returned object is
+ * frozen and carries `kind: 'load'`.
+ */
+export function createLoadScenarioRunner(config) {
+    return Object.freeze({
+        kind: 'load',
+        id: config.id,
+        name: config.name,
+        description: config.description,
+        tags: Object.freeze([...config.tags]),
+        run: 
+        /** @throws {ScenarioAbortedError} When the scenario is aborted via AbortSignal */
+        async (abortSignal) => {
+            const correlationId = `scenario-${config.id}-${Date.now().toString(36)}`;
+            const context = {
+                scenarioId: config.id,
+                correlationId,
+                abortSignal,
+                logger: createScenarioLogger(config.id),
+            };
+            if (abortSignal.aborted) {
+                throw new ScenarioAbortedError(config.id);
+            }
+            try {
+                return await executeLoad(config, context);
+            }
+            catch (error) {
+                if (abortSignal.aborted) {
+                    throw new ScenarioAbortedError(config.id);
+                }
+                throw error;
+            }
+        },
+    });
+}
+//# sourceMappingURL=executor.js.map

package/dist/kinds/load/executor.js.map

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

package/dist/kinds/load/result.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview Load-kind result outcome.
+ *
+ * The load kind's outcome is the SLO-style metrics + assertion verdict that
+ * scenarios produce. Field-for-field parity with the `LoadResultPayload`
+ * metrics/assertions shape that `ScenarioResultBuilder` emits, so assertions
+ * carry through unchanged.
+ */
+import type { SimulationMetrics } from '../../types/base-types.js';
+import type { ScenarioAssertion, FailedAssertion } from '../../types/framework-types.js';
+/** Outcome payload for a load-kind scenario. */
+export interface LoadOutcome {
+    /** Final aggregated metrics from the simulation loop. */
+    readonly metrics: SimulationMetrics;
+    /** Assertions split into passed and failed buckets. */
+    readonly assertions: {
+        readonly passed: readonly ScenarioAssertion[];
+        readonly failed: readonly FailedAssertion[];
+    };
+}
+//# sourceMappingURL=result.d.ts.map

package/dist/kinds/load/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../../src/kinds/load/result.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEzF,gDAAgD;AAChD,MAAM,WAAW,WAAW;IAC1B,yDAAyD;IACzD,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,uDAAuD;IACvD,QAAQ,CAAC,UAAU,EAAE;QACnB,QAAQ,CAAC,MAAM,EAAE,SAAS,iBAAiB,EAAE,CAAC;QAC9C,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;KAC7C,CAAC;CACH"}

package/dist/kinds/load/result.js

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Load-kind result outcome.
+ *
+ * The load kind's outcome is the SLO-style metrics + assertion verdict that
+ * scenarios produce. Field-for-field parity with the `LoadResultPayload`
+ * metrics/assertions shape that `ScenarioResultBuilder` emits, so assertions
+ * carry through unchanged.
+ */
+export {};
+//# sourceMappingURL=result.js.map

package/dist/kinds/load/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../../src/kinds/load/result.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/persistence/session-payload.d.ts

@@ -0,0 +1,32 @@
+import type { SignalEnvelope } from '@opensip-cli/contracts';
+export type SimulationFindingSeverity = 'error' | 'warning';
+export interface SimulationSessionFinding {
+    readonly ruleId: string;
+    readonly message: string;
+    readonly severity: SimulationFindingSeverity;
+    readonly filePath?: string;
+    readonly line?: number;
+    readonly column?: number;
+    readonly suggestion?: string;
+}
+export interface SimulationSessionCheck {
+    readonly checkSlug: string;
+    readonly passed: boolean;
+    readonly violationCount: number;
+    readonly findings: readonly SimulationSessionFinding[];
+    readonly durationMs: number;
+}
+export interface SimulationSessionPayload {
+    /** Inner version per the payload schema evolution convention (v1 shape). */
+    readonly __version: 1;
+    readonly summary: {
+        readonly total: number;
+        readonly passed: number;
+        readonly failed: number;
+        readonly errors: number;
+        readonly warnings: number;
+    };
+    readonly checks: readonly SimulationSessionCheck[];
+}
+export declare function buildSimulationSessionPayload(envelope: SignalEnvelope): SimulationSessionPayload;
+//# sourceMappingURL=session-payload.d.ts.map

package/dist/persistence/session-payload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-payload.d.ts","sourceRoot":"","sources":["../../src/persistence/session-payload.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,wBAAwB,CAAC;AAGzE,MAAM,MAAM,yBAAyB,GAAG,OAAO,GAAG,SAAS,CAAC;AAE5D,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,yBAAyB,CAAC;IAC7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,SAAS,wBAAwB,EAAE,CAAC;IACvD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,wBAAwB;IACvC,4EAA4E;IAC5E,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,QAAQ,CAAC,MAAM,EAAE,SAAS,sBAAsB,EAAE,CAAC;CACpD;AAED,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,cAAc,GAAG,wBAAwB,CA+BhG"}

package/dist/persistence/session-payload.js

@@ -0,0 +1,46 @@
+// @fitness-ignore-file batch-operation-limits -- iterates the bounded per-run signal set grouped by source (signals emitted by a single sim run), matching the graph session-payload precedent.
+import { isErrorSignal } from '@opensip-cli/core';
+export function buildSimulationSessionPayload(envelope) {
+    const bySource = new Map();
+    for (const signal of envelope.signals) {
+        const bucket = bySource.get(signal.source);
+        if (bucket)
+            bucket.push(signal);
+        else
+            bySource.set(signal.source, [signal]);
+    }
+    const checks = envelope.units.map((unit) => {
+        const findings = findingsFor(bySource.get(unit.slug) ?? []);
+        return {
+            checkSlug: unit.slug,
+            passed: unit.passed,
+            violationCount: unit.violationCount ?? findings.length,
+            findings,
+            durationMs: unit.durationMs,
+        };
+    });
+    const { summary } = envelope.verdict;
+    return {
+        __version: 1,
+        summary: {
+            total: summary.total,
+            passed: summary.passed,
+            failed: summary.failed,
+            errors: summary.errors,
+            warnings: summary.warnings,
+        },
+        checks,
+    };
+}
+function findingsFor(signals) {
+    return signals.map((signal) => ({
+        ruleId: signal.ruleId,
+        message: signal.message,
+        severity: isErrorSignal(signal) ? 'error' : 'warning',
+        ...(signal.filePath === '' ? {} : { filePath: signal.filePath }),
+        ...(signal.line === undefined ? {} : { line: signal.line }),
+        ...(signal.column === undefined ? {} : { column: signal.column }),
+        ...(signal.suggestion === undefined ? {} : { suggestion: signal.suggestion }),
+    }));
+}
+//# sourceMappingURL=session-payload.js.map

package/dist/persistence/session-payload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-payload.js","sourceRoot":"","sources":["../../src/persistence/session-payload.ts"],"names":[],"mappings":"AAAA,gMAAgM;AAChM,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAsClD,MAAM,UAAU,6BAA6B,CAAC,QAAwB;IACpE,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC7C,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC3C,IAAI,MAAM;YAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;;YAC3B,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAgB,EAAE,EAAE;QACrD,MAAM,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC5D,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,IAAI;YACpB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,cAAc,EAAE,IAAI,CAAC,cAAc,IAAI,QAAQ,CAAC,MAAM;YACtD,QAAQ;YACR,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC,OAAO,CAAC;IACrC,OAAO;QACL,SAAS,EAAE,CAAC;QACZ,OAAO,EAAE;YACP,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B;QACD,MAAM;KACP,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,OAA0B;IAC7C,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC9B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;QACrD,GAAG,CAAC,MAAM,CAAC,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;QAChE,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QAC3D,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;QACjE,GAAG,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;KAC9E,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/persistence/session-replay.d.ts

@@ -0,0 +1,13 @@
+import type { SimDoneResult, StoredSession, ToolSessionReplay } from '@opensip-cli/contracts';
+/**
+ * Project a stored sim session back into a {@link SignalEnvelope}/{@link SimDoneResult}.
+ *
+ * The structural decode of the opaque payload is shared across tools
+ * (`decodeSessionPayload`); this function owns only sim's projection
+ * (`tool: 'sim'`, `category: 'testing'`, signal id prefix, `sim-done` result).
+ *
+ * @throws {Error | TypeError} when the stored payload is not the expected shape
+ *   (propagated from `decodeSessionPayload`).
+ */
+export declare function simReplayFromSession(stored: StoredSession): ToolSessionReplay<SimDoneResult>;
+//# sourceMappingURL=session-replay.d.ts.map

package/dist/persistence/session-replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-replay.d.ts","sourceRoot":"","sources":["../../src/persistence/session-replay.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,aAAa,EACb,aAAa,EACb,iBAAiB,EAElB,MAAM,wBAAwB,CAAC;AAGhC;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,GAAG,iBAAiB,CAAC,aAAa,CAAC,CAyC5F"}