@opensip-cli/simulation 0.1.0

package/dist/__tests__/scenario-execution.test.js

@@ -0,0 +1,92 @@
+/**
+ * @fileoverview Integration tests that run scenarios end-to-end so the
+ * execution-engine + per-kind executor paths are exercised. Each
+ * scenario uses a tiny duration so the test runs quickly.
+ *
+ * This file focuses on actually running the executor for the load and
+ * chaos kinds.
+ */
+import { enterScope } from '@opensip-cli/core';
+import { beforeEach, describe, expect, it } from 'vitest';
+import { ASSERTIONS } from '../framework/assertions.js';
+import { fault } from '../framework/execution/fault-builders.js';
+import { ScenarioAbortedError } from '../framework/execution/scenario-aborted-error.js';
+import { defineChaosScenario } from '../kinds/chaos/define.js';
+import { defineLoadScenario } from '../kinds/load/define.js';
+import { makeSimTestScope } from './test-utils/with-sim-scope.js';
+const noopTarget = () => Promise.resolve();
+beforeEach(() => {
+    // Item 1: scenarioRegistry is per-RunScope. Enter a fresh scope.
+    enterScope(makeSimTestScope());
+});
+describe('Load scenario execution', () => {
+    it('runs to completion and returns a load-kind result', async () => {
+        const scenario = defineLoadScenario({
+            id: 'load-exec-1',
+            name: 'load-exec-1',
+            description: 'tiny load run',
+            tags: [],
+            target: noopTarget,
+            workload: { rps: 1 },
+            duration: 1,
+            assertions: [ASSERTIONS.lowErrorRate(1)],
+        });
+        const result = await scenario.run(new AbortController().signal);
+        expect(result.kind).toBe('load');
+        expect(result.scenarioId).toBe('load-exec-1');
+        expect(typeof result.passed).toBe('boolean');
+        expect(typeof result.durationMs).toBe('number');
+    });
+    it('throws ScenarioAbortedError on a pre-aborted signal', async () => {
+        const scenario = defineLoadScenario({
+            id: 'load-exec-aborted',
+            name: 'load-exec-aborted',
+            description: 'aborted',
+            tags: [],
+            target: noopTarget,
+            workload: { rps: 1 },
+            duration: 5,
+            assertions: [ASSERTIONS.lowErrorRate(1)],
+        });
+        const ac = new AbortController();
+        ac.abort();
+        await expect(scenario.run(ac.signal)).rejects.toThrow(ScenarioAbortedError);
+    });
+    it('honors an explicit workload rps + concurrency', async () => {
+        const scenario = defineLoadScenario({
+            id: 'load-targetrps',
+            name: 'load-targetrps',
+            description: 'load with explicit RPS',
+            tags: [],
+            target: noopTarget,
+            workload: { rps: 10, concurrency: 4 },
+            duration: 1,
+            assertions: [ASSERTIONS.lowErrorRate(1)],
+        });
+        const result = await scenario.run(new AbortController().signal);
+        expect(result.kind).toBe('load');
+        expect(typeof result.passed).toBe('boolean');
+    });
+});
+describe('Chaos scenario execution', () => {
+    it('runs to completion and returns a chaos-kind result', async () => {
+        const scenario = defineChaosScenario({
+            id: 'chaos-exec-1',
+            name: 'chaos-exec-1',
+            description: 'tiny chaos run',
+            tags: [],
+            target: noopTarget,
+            workload: { rps: 1 },
+            duration: 1,
+            fault: fault.of([fault.drop()], { probability: 0.1 }),
+            steadyStateAssertions: [ASSERTIONS.lowErrorRate(1)],
+            recoveryAssertions: [ASSERTIONS.lowErrorRate(1)],
+            recoveryWindow: 100,
+        });
+        const result = await scenario.run(new AbortController().signal);
+        expect(result.kind).toBe('chaos');
+        expect(result.scenarioId).toBe('chaos-exec-1');
+        expect(typeof result.passed).toBe('boolean');
+    });
+});
+//# sourceMappingURL=scenario-execution.test.js.map

package/dist/__tests__/scenario-execution.test.js.map

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

package/dist/__tests__/sim-capability-contract.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Capability contract for the `sim` tool.
+ *
+ * A Tier-2 guardrail (audit "Done Definition"): lock the promised surface so a
+ * flag can't be added/removed without an explicit contract update, and prove
+ * the scheduler applies recipe selectors BEFORE invoking any scenario runner
+ * (so a narrowed-out scenario never runs). Scoped to the non-cloud sim domain.
+ */
+export {};
+//# sourceMappingURL=sim-capability-contract.test.d.ts.map

package/dist/__tests__/sim-capability-contract.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-capability-contract.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/sim-capability-contract.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/__tests__/sim-capability-contract.test.js

@@ -0,0 +1,131 @@
+/**
+ * Capability contract for the `sim` tool.
+ *
+ * A Tier-2 guardrail (audit "Done Definition"): lock the promised surface so a
+ * flag can't be added/removed without an explicit contract update, and prove
+ * the scheduler applies recipe selectors BEFORE invoking any scenario runner
+ * (so a narrowed-out scenario never runs). Scoped to the non-cloud sim domain.
+ */
+import { commonFlags } from '@opensip-cli/contracts';
+import { runWithScope, runWithScopeSync } from '@opensip-cli/core';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { clearScenarioRegistry, currentScenarioRegistry } from '../framework/registry.js';
+import { defineSimulationRecipe } from '../recipes/define-recipe.js';
+import { SimulationRecipeService } from '../recipes/service.js';
+import { simulationTool } from '../tool.js';
+import { makeSimTestScope } from './test-utils/with-sim-scope.js';
+// ---------------------------------------------------------------------------
+// 1. Flag-surface lock
+// ---------------------------------------------------------------------------
+/**
+ * Derive the `--long` flag set sim declares from its `CommandSpec` (release
+ * 2.11.0 Phase 3): the ADR-0021 `commonFlags` keys mapped to their registry
+ * `--long` strings, plus each tool-specific `OptionSpec.flag`. This locks the
+ * exported command surface — adding/removing a flag must be a deliberate edit
+ * to the expected list below, so nothing ships undocumented or vanishes silently.
+ */
+function recordRegisteredFlags() {
+    const spec = simulationTool.commandSpecs?.[0];
+    if (spec === undefined)
+        throw new Error('simulationTool exposes no commandSpecs');
+    const flags = [];
+    for (const key of spec.commonFlags) {
+        const match = /--[a-z][a-z-]*/.exec(commonFlags[key].flags);
+        if (match)
+            flags.push(match[0]);
+    }
+    for (const opt of spec.options ?? []) {
+        const match = /--[a-z][a-z-]*/.exec(opt.flag);
+        if (match)
+            flags.push(match[0]);
+    }
+    return flags.sort();
+}
+describe('sim tool — flag-surface contract', () => {
+    it('registers exactly the documented flag set (drift fails here)', () => {
+        // Adding or removing a `sim` flag must be a deliberate change to this list,
+        // so a new flag can't ship undocumented or an old one vanish silently.
+        expect(recordRegisteredFlags()).toEqual(
+        // ADR-0011 (Phase 4): sim gained cloud egress (--report-to / --api-key)
+        // when it began emitting the signal envelope.
+        // ADR-0021: sim gained -v/--verbose (cross-tool flag parity).
+        [
+            '--cwd',
+            '--debug',
+            '--json',
+            '--open',
+            '--quiet',
+            '--verbose',
+            '--recipe',
+            '--report-to',
+            '--api-key',
+            '--show',
+        ].sort());
+    });
+});
+// ---------------------------------------------------------------------------
+// 2. Scheduler-order: filters/selectors narrow BEFORE the runner
+// ---------------------------------------------------------------------------
+/** A scenario that records execution and rejects if ever run. */
+function tripwire(id, kind, fired) {
+    return {
+        id,
+        name: id,
+        description: id,
+        kind,
+        tags: [],
+        run: () => {
+            fired.ran = true;
+            return Promise.reject(new Error(`${id} must not run — it was narrowed out before execution`));
+        },
+    };
+}
+describe('sim scheduler — narrowing precedes execution', () => {
+    let scope;
+    beforeEach(() => {
+        scope = makeSimTestScope();
+    });
+    afterEach(() => {
+        runWithScopeSync(scope, () => clearScenarioRegistry());
+    });
+    function inSimScope(fn) {
+        return runWithScope(scope, fn);
+    }
+    it('a recipe selector excludes scenarios before they run', async () => {
+        await inSimScope(async () => {
+            const fired = { ran: false };
+            currentScenarioRegistry().register(tripwire('excluded-by-selector', 'load', fired));
+            const recipe = defineSimulationRecipe({
+                id: 'URCP_sel_exclude',
+                name: 'sel-exclude',
+                displayName: 'Selector exclude',
+                description: 'x',
+                scenarios: { type: 'all', exclude: ['excluded-by-selector'] },
+                execution: { mode: 'sequential' },
+            });
+            const result = await new SimulationRecipeService().runRecipe(recipe);
+            expect(fired.ran).toBe(false);
+            expect(result.totalScenarios).toBe(0);
+        });
+    });
+    it('a kind recipe selector excludes other-kind scenarios before they run', async () => {
+        await inSimScope(async () => {
+            const fired = { ran: false };
+            currentScenarioRegistry().register(tripwire('excluded-by-kind', 'load', fired));
+            const recipe = defineSimulationRecipe({
+                id: 'URCP_kind_exclude',
+                name: 'kind-exclude',
+                displayName: 'Kind exclude',
+                description: 'x',
+                // The recipe selects only chaos scenarios; the 'load' tripwire is dropped
+                // before execution.
+                scenarios: { type: 'kind', kinds: ['chaos'] },
+                execution: { mode: 'sequential' },
+            });
+            const result = await new SimulationRecipeService().runRecipe(recipe);
+            expect(fired.ran).toBe(false);
+            expect(result.totalScenarios).toBe(0);
+        });
+    });
+});
+//# sourceMappingURL=sim-capability-contract.test.js.map

package/dist/__tests__/sim-capability-contract.test.js.map

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

package/dist/__tests__/sim-config-schema.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Unit coverage for the simulation namespace config schema (Phase 4 Task 4.2).
+ */
+export {};
+//# sourceMappingURL=sim-config-schema.test.d.ts.map

package/dist/__tests__/sim-config-schema.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-config-schema.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/sim-config-schema.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/__tests__/sim-config-schema.test.js

@@ -0,0 +1,23 @@
+/**
+ * Unit coverage for the simulation namespace config schema (Phase 4 Task 4.2).
+ */
+import { describe, expect, it } from 'vitest';
+import { SimulationNamespaceSchema, simulationConfigDeclaration, } from '../cli/sim-config-schema.js';
+describe('SimulationNamespaceSchema', () => {
+    it('accepts a block with a recipe', () => {
+        expect(SimulationNamespaceSchema.parse({ recipe: 'example' })).toEqual({ recipe: 'example' });
+    });
+    it('accepts an empty block', () => {
+        expect(SimulationNamespaceSchema.parse({})).toEqual({});
+    });
+    it('rejects a non-string recipe', () => {
+        expect(SimulationNamespaceSchema.safeParse({ recipe: 3 }).success).toBe(false);
+    });
+    it('rejects an unknown key once strict (composer behaviour)', () => {
+        expect(SimulationNamespaceSchema.strict().safeParse({ recpe: 'x' }).success).toBe(false);
+    });
+    it('declares namespace simulation', () => {
+        expect(simulationConfigDeclaration.namespace).toBe('simulation');
+    });
+});
+//# sourceMappingURL=sim-config-schema.test.js.map

package/dist/__tests__/sim-config-schema.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-config-schema.test.js","sourceRoot":"","sources":["../../src/__tests__/sim-config-schema.test.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EACL,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,6BAA6B,CAAC;AAErC,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACzC,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,CAAC,yBAAyB,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;IAChG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,MAAM,CAAC,yBAAyB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,CAAC,yBAAyB,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,CAAC,yBAAyB,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,CAAC,2BAA2B,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/sim-failure-signal.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview ADR-0035 gate precondition: a failed sim scenario must surface
+ * an error-severity signal (the signal currency), for BOTH kinds — load (via
+ * the result builder) and chaos (which builds its own payload). Before this,
+ * a failing run had `passed: false` but `signals: []`, so the host verdict
+ * computed `errors === 0` and would flip the run to PASS. These tests pin the
+ * fix against the real executors.
+ */
+export {};
+//# sourceMappingURL=sim-failure-signal.test.d.ts.map

package/dist/__tests__/sim-failure-signal.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-failure-signal.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/sim-failure-signal.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/__tests__/sim-failure-signal.test.js

@@ -0,0 +1,86 @@
+/**
+ * @fileoverview ADR-0035 gate precondition: a failed sim scenario must surface
+ * an error-severity signal (the signal currency), for BOTH kinds — load (via
+ * the result builder) and chaos (which builds its own payload). Before this,
+ * a failing run had `passed: false` but `signals: []`, so the host verdict
+ * computed `errors === 0` and would flip the run to PASS. These tests pin the
+ * fix against the real executors.
+ */
+import { isErrorSignal } from '@opensip-cli/core';
+import { describe, expect, it } from 'vitest';
+import { ASSERTIONS } from '../framework/assertions.js';
+import { fault } from '../framework/execution/fault-builders.js';
+import { buildFailedScenarioSignal } from '../framework/result-builder.js';
+import { createChaosScenarioRunner } from '../kinds/chaos/executor.js';
+import { createLoadScenarioRunner } from '../kinds/load/executor.js';
+import { failingTarget, noopTarget } from './test-utils/targets.js';
+const loadCfg = (o = {}) => ({
+    id: 'load-x',
+    name: 'load-x',
+    description: 'load-x',
+    tags: [],
+    target: noopTarget,
+    workload: { rps: 50 },
+    duration: 0.3,
+    assertions: [ASSERTIONS.lowErrorRate(0.5)],
+    ...o,
+});
+const chaosCfg = (o = {}) => ({
+    id: 'chaos-x',
+    name: 'chaos-x',
+    description: 'chaos-x',
+    tags: [],
+    target: noopTarget,
+    workload: { rps: 50 },
+    duration: 0.3,
+    fault: fault.of([fault.drop()], { probability: 1 }),
+    steadyStateAssertions: [ASSERTIONS.lowErrorRate(0.1)],
+    recoveryAssertions: [ASSERTIONS.lowErrorRate(0.5)],
+    recoveryWindow: 100,
+    ...o,
+});
+describe('ADR-0035 · failed scenario emits an error-severity signal', () => {
+    it('load: a failing scenario emits ≥1 error signal attributed to its id', async () => {
+        const r = await createLoadScenarioRunner(loadCfg({ 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);
+        const errors = r.signals.filter(isErrorSignal);
+        expect(errors.length).toBeGreaterThanOrEqual(1);
+        expect(errors[0]?.source).toBe('load-x');
+    });
+    it('load: a passing scenario emits no error signal', async () => {
+        const r = await createLoadScenarioRunner(loadCfg()).run(new AbortController().signal);
+        if (r.kind !== 'load')
+            throw new Error('expected load result');
+        expect(r.passed).toBe(true);
+        expect(r.signals.filter(isErrorSignal)).toHaveLength(0);
+    });
+    it('chaos: a failing scenario emits ≥1 error signal attributed to its id', async () => {
+        const r = await createChaosScenarioRunner(chaosCfg()).run(new AbortController().signal);
+        if (r.kind !== 'chaos')
+            throw new Error('expected chaos result');
+        expect(r.passed).toBe(false);
+        const errors = r.signals.filter(isErrorSignal);
+        expect(errors.length).toBeGreaterThanOrEqual(1);
+        expect(errors[0]?.source).toBe('chaos-x');
+    });
+    it('chaos: a passing scenario (no faults) emits no error signal', async () => {
+        const r = await createChaosScenarioRunner(chaosCfg({ fault: fault.of([fault.drop()], { probability: 0 }) })).run(new AbortController().signal);
+        if (r.kind !== 'chaos')
+            throw new Error('expected chaos result');
+        expect(r.passed).toBe(true);
+        expect(r.signals.filter(isErrorSignal)).toHaveLength(0);
+    });
+    it('buildFailedScenarioSignal: high severity, scenario-attributed, summarizes assertions', () => {
+        const sig = buildFailedScenarioSignal('s1', [
+            { metric: 'error_rate', operator: 'lte', value: 0.1, message: 'low errors', actual: 0.9 },
+        ]);
+        expect(sig.severity).toBe('high');
+        expect(isErrorSignal(sig)).toBe(true);
+        expect(sig.source).toBe('s1');
+        expect(sig.message).toContain('error_rate');
+        expect(sig.message).toContain('0.9');
+    });
+});
+//# sourceMappingURL=sim-failure-signal.test.js.map

package/dist/__tests__/sim-failure-signal.test.js.map

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

package/dist/__tests__/surviving-surface-edges.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Cross-cutting surface tests that don't belong to a single
+ * kind: the metric resolver's latency aliases, registry/recipe scope guards,
+ * and the recipe service's live-progress callback.
+ *
+ * The driver, fault model, and per-kind executor behaviour are covered by the
+ * dedicated framework/execution and per-kind executor test suites.
+ */
+export {};
+//# sourceMappingURL=surviving-surface-edges.test.d.ts.map

package/dist/__tests__/surviving-surface-edges.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surviving-surface-edges.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/surviving-surface-edges.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/__tests__/surviving-surface-edges.test.js

@@ -0,0 +1,122 @@
+/**
+ * @fileoverview Cross-cutting surface tests that don't belong to a single
+ * kind: the metric resolver's latency aliases, registry/recipe scope guards,
+ * and the recipe service's live-progress callback.
+ *
+ * The driver, fault model, and per-kind executor behaviour are covered by the
+ * dedicated framework/execution and per-kind executor test suites.
+ */
+import { enterScope, RunScope, runWithScopeSync } from '@opensip-cli/core';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { ASSERTIONS } from '../framework/assertions.js';
+import { clearScenarioRegistry, currentScenarioRegistry } from '../framework/registry.js';
+import { resolveMetric } from '../framework/resolve-metric.js';
+import { defineLoadScenario } from '../kinds/load/define.js';
+import { currentSimulationRecipeRegistry } from '../recipes/registry.js';
+import { SimulationRecipeService } from '../recipes/service.js';
+import { noopTarget } from './test-utils/targets.js';
+import { makeSimTestScope } from './test-utils/with-sim-scope.js';
+beforeEach(() => {
+    enterScope(makeSimTestScope());
+});
+afterEach(() => {
+    try {
+        clearScenarioRegistry();
+    }
+    catch {
+        // some tests deliberately run outside a scope
+    }
+});
+const loadConfig = (overrides = {}) => ({
+    id: 'load-edge',
+    name: 'load-edge',
+    description: 'load edge',
+    tags: [],
+    target: noopTarget,
+    workload: { rps: 1 },
+    duration: 1,
+    assertions: [ASSERTIONS.lowErrorRate(1)],
+    ...overrides,
+});
+// ===========================================================================
+// registry scope guards
+// ===========================================================================
+describe('scenario/recipe registry scope guards', () => {
+    it('currentScenarioRegistry throws when the active scope has no simulation subscope', () => {
+        // A bare RunScope (no simulationTool.contributeScope applied) is a real
+        // misconfiguration: the tool wasn't registered before a scenario read.
+        runWithScopeSync(new RunScope(), () => {
+            expect(() => currentScenarioRegistry()).toThrow(/scope\.simulation is missing/);
+        });
+    });
+    it('currentSimulationRecipeRegistry throws when the active scope has no simulation subscope', () => {
+        runWithScopeSync(new RunScope(), () => {
+            expect(() => currentSimulationRecipeRegistry()).toThrow(/scope\.simulation is missing/);
+        });
+    });
+    it('currentSimulationRecipeRegistry resolves the scope-bound registry inside a sim scope', () => {
+        // Inside the beforeEach sim scope the recipe registry is reachable and has
+        // the built-in default recipe.
+        expect(currentSimulationRecipeRegistry().getByName('default')).toBeDefined();
+    });
+});
+// ===========================================================================
+// resolve-metric — non-`_ms` latency aliases
+// ===========================================================================
+describe('resolveMetric — latency key aliases', () => {
+    const m = {
+        totalRequests: 100,
+        successfulRequests: 90,
+        failedRequests: 10,
+        avgLatencyMs: 41,
+        p50LatencyMs: 30,
+        p95LatencyMs: 70,
+        p99LatencyMs: 120,
+        errorsGenerated: 10,
+    };
+    it.each([
+        ['avg_latency', 41],
+        ['p50_latency', 30],
+        ['p95_latency', 70],
+        ['p99_latency', 120],
+    ])('resolves the %s alias to the corresponding *_ms field', (key, expected) => {
+        expect(resolveMetric(key, m)).toBe(expected);
+    });
+    it('resolves requests_per_second using the supplied duration', () => {
+        expect(resolveMetric('requests_per_second', m, 10)).toBeCloseTo(10);
+    });
+    it('returns 0 for errors_generated passthrough when none recorded', () => {
+        expect(resolveMetric('errors_generated', { ...m, errorsGenerated: 0 })).toBe(0);
+    });
+});
+// ===========================================================================
+// recipe service — live-progress callback
+// ===========================================================================
+describe('SimulationRecipeService — onProgress', () => {
+    it('fires (0, total) up front then a monotonic completed count per scenario', async () => {
+        currentScenarioRegistry().register(defineLoadScenario(loadConfig({ id: 'prog-a', name: 'prog-a' })));
+        currentScenarioRegistry().register(defineLoadScenario(loadConfig({ id: 'prog-b', name: 'prog-b' })));
+        const events = [];
+        const service = new SimulationRecipeService({
+            onProgress: (completed, total) => events.push([completed, total]),
+        });
+        await service.runRecipe({
+            id: 'URCP_prog',
+            name: 'prog',
+            displayName: 'Prog',
+            description: 'progress',
+            scenarios: { type: 'all' },
+            execution: { mode: 'sequential' },
+        });
+        // First event is the (0, total) kickoff.
+        expect(events[0]).toEqual([0, 2]);
+        // Final event reports both scenarios complete.
+        expect(events.at(-1)).toEqual([2, 2]);
+        // The completed counter never decreases.
+        const completedSeq = events.map(([c]) => c);
+        for (let i = 1; i < completedSeq.length; i++) {
+            expect(completedSeq[i]).toBeGreaterThanOrEqual(completedSeq[i - 1] ?? 0);
+        }
+    });
+});
+//# sourceMappingURL=surviving-surface-edges.test.js.map

package/dist/__tests__/surviving-surface-edges.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surviving-surface-edges.test.js","sourceRoot":"","sources":["../../src/__tests__/surviving-surface-edges.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAErE,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAC1F,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAMlE,UAAU,CAAC,GAAG,EAAE;IACd,UAAU,CAAC,gBAAgB,EAAE,CAAC,CAAC;AACjC,CAAC,CAAC,CAAC;AAEH,SAAS,CAAC,GAAG,EAAE;IACb,IAAI,CAAC;QACH,qBAAqB,EAAE,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,8CAA8C;IAChD,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,MAAM,UAAU,GAAG,CAAC,YAAyC,EAAE,EAAsB,EAAE,CAAC,CAAC;IACvF,EAAE,EAAE,WAAW;IACf,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,WAAW;IACxB,IAAI,EAAE,EAAE;IACR,MAAM,EAAE,UAAU;IAClB,QAAQ,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE;IACpB,QAAQ,EAAE,CAAC;IACX,UAAU,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACxC,GAAG,SAAS;CACb,CAAC,CAAC;AAEH,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E,QAAQ,CAAC,uCAAuC,EAAE,GAAG,EAAE;IACrD,EAAE,CAAC,iFAAiF,EAAE,GAAG,EAAE;QACzF,wEAAwE;QACxE,uEAAuE;QACvE,gBAAgB,CAAC,IAAI,QAAQ,EAAE,EAAE,GAAG,EAAE;YACpC,MAAM,CAAC,GAAG,EAAE,CAAC,uBAAuB,EAAE,CAAC,CAAC,OAAO,CAAC,8BAA8B,CAAC,CAAC;QAClF,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yFAAyF,EAAE,GAAG,EAAE;QACjG,gBAAgB,CAAC,IAAI,QAAQ,EAAE,EAAE,GAAG,EAAE;YACpC,MAAM,CAAC,GAAG,EAAE,CAAC,+BAA+B,EAAE,CAAC,CAAC,OAAO,CAAC,8BAA8B,CAAC,CAAC;QAC1F,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sFAAsF,EAAE,GAAG,EAAE;QAC9F,2EAA2E;QAC3E,+BAA+B;QAC/B,MAAM,CAAC,+BAA+B,EAAE,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAC/E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,8EAA8E;AAC9E,6CAA6C;AAC7C,8EAA8E;AAE9E,QAAQ,CAAC,qCAAqC,EAAE,GAAG,EAAE;IACnD,MAAM,CAAC,GAAsB;QAC3B,aAAa,EAAE,GAAG;QAClB,kBAAkB,EAAE,EAAE;QACtB,cAAc,EAAE,EAAE;QAClB,YAAY,EAAE,EAAE;QAChB,YAAY,EAAE,EAAE;QAChB,YAAY,EAAE,EAAE;QAChB,YAAY,EAAE,GAAG;QACjB,eAAe,EAAE,EAAE;KACpB,CAAC;IAEF,EAAE,CAAC,IAAI,CAA8B;QACnC,CAAC,aAAa,EAAE,EAAE,CAAC;QACnB,CAAC,aAAa,EAAE,EAAE,CAAC;QACnB,CAAC,aAAa,EAAE,EAAE,CAAC;QACnB,CAAC,aAAa,EAAE,GAAG,CAAC;KACrB,CAAC,CAAC,uDAAuD,EAAE,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE;QAC5E,MAAM,CAAC,aAAa,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,CAAC,aAAa,CAAC,qBAAqB,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,MAAM,CAAC,aAAa,CAAC,kBAAkB,EAAE,EAAE,GAAG,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,8EAA8E;AAC9E,0CAA0C;AAC1C,8EAA8E;AAE9E,QAAQ,CAAC,sCAAsC,EAAE,GAAG,EAAE;IACpD,EAAE,CAAC,yEAAyE,EAAE,KAAK,IAAI,EAAE;QACvF,uBAAuB,EAAE,CAAC,QAAQ,CAChC,kBAAkB,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,CACjE,CAAC;QACF,uBAAuB,EAAE,CAAC,QAAQ,CAChC,kBAAkB,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,CACjE,CAAC;QAEF,MAAM,MAAM,GAAuB,EAAE,CAAC;QACtC,MAAM,OAAO,GAAG,IAAI,uBAAuB,CAAC;YAC1C,UAAU,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;SAClE,CAAC,CAAC;QACH,MAAM,OAAO,CAAC,SAAS,CAAC;YACtB,EAAE,EAAE,WAAW;YACf,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,MAAM;YACnB,WAAW,EAAE,UAAU;YACvB,SAAS,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE;YAC1B,SAAS,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE;SAClC,CAAC,CAAC;QAEH,yCAAyC;QACzC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAClC,+CAA+C;QAC/C,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACtC,yCAAyC;QACzC,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;QAC5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7C,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/test-utils/targets.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @fileoverview Shared in-process `Target`s for simulation tests.
+ *
+ * These let scenario fixtures drive the real load-window driver without any
+ * network I/O. `noopTarget` always succeeds; `countingTarget` records how many
+ * times it was invoked (and how many were concurrent) for driver assertions.
+ */
+import type { Target } from '../../framework/execution/target.js';
+/** A target that always succeeds immediately. */
+export declare const noopTarget: Target;
+/** A target that always fails (throws) immediately. */
+export declare const failingTarget: Target;
+/** A counting target plus its observed call/concurrency stats. */
+export interface CountingTarget {
+    readonly target: Target;
+    /** Total invocations. */
+    calls(): number;
+    /** Peak simultaneous in-flight invocations observed. */
+    maxConcurrent(): number;
+}
+/**
+ * Build a target that resolves after `delayMs` and tracks invocation count +
+ * peak concurrency. `delayMs` defaults to 0 (resolve on the next microtask).
+ */
+export declare function countingTarget(delayMs?: number): CountingTarget;
+//# sourceMappingURL=targets.d.ts.map

package/dist/__tests__/test-utils/targets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.d.ts","sourceRoot":"","sources":["../../../src/__tests__/test-utils/targets.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qCAAqC,CAAC;AAElE,iDAAiD;AACjD,eAAO,MAAM,UAAU,EAAE,MAAgC,CAAC;AAE1D,uDAAuD;AACvD,eAAO,MAAM,aAAa,EAAE,MAAuE,CAAC;AAEpG,kEAAkE;AAClE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,yBAAyB;IACzB,KAAK,IAAI,MAAM,CAAC;IAChB,wDAAwD;IACxD,aAAa,IAAI,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,SAAI,GAAG,cAAc,CAoB1D"}

package/dist/__tests__/test-utils/targets.js

@@ -0,0 +1,38 @@
+/**
+ * @fileoverview Shared in-process `Target`s for simulation tests.
+ *
+ * These let scenario fixtures drive the real load-window driver without any
+ * network I/O. `noopTarget` always succeeds; `countingTarget` records how many
+ * times it was invoked (and how many were concurrent) for driver assertions.
+ */
+/** A target that always succeeds immediately. */
+export const noopTarget = () => Promise.resolve();
+/** A target that always fails (throws) immediately. */
+export const failingTarget = () => Promise.reject(new Error('test-target: forced failure'));
+/**
+ * Build a target that resolves after `delayMs` and tracks invocation count +
+ * peak concurrency. `delayMs` defaults to 0 (resolve on the next microtask).
+ */
+export function countingTarget(delayMs = 0) {
+    let calls = 0;
+    let inFlight = 0;
+    let peak = 0;
+    return {
+        target: async () => {
+            calls++;
+            inFlight++;
+            peak = Math.max(peak, inFlight);
+            try {
+                if (delayMs > 0) {
+                    await new Promise((resolve) => setTimeout(resolve, delayMs));
+                }
+            }
+            finally {
+                inFlight--;
+            }
+        },
+        calls: () => calls,
+        maxConcurrent: () => peak,
+    };
+}
+//# sourceMappingURL=targets.js.map

package/dist/__tests__/test-utils/targets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.js","sourceRoot":"","sources":["../../../src/__tests__/test-utils/targets.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,iDAAiD;AACjD,MAAM,CAAC,MAAM,UAAU,GAAW,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;AAE1D,uDAAuD;AACvD,MAAM,CAAC,MAAM,aAAa,GAAW,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC,CAAC;AAWpG;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,OAAO,GAAG,CAAC;IACxC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,OAAO;QACL,MAAM,EAAE,KAAK,IAAI,EAAE;YACjB,KAAK,EAAE,CAAC;YACR,QAAQ,EAAE,CAAC;YACX,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YAChC,IAAI,CAAC;gBACH,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;oBAChB,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;gBAC/D,CAAC;YACH,CAAC;oBAAS,CAAC;gBACT,QAAQ,EAAE,CAAC;YACb,CAAC;QACH,CAAC;QACD,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK;QAClB,aAAa,EAAE,GAAG,EAAE,CAAC,IAAI;KAC1B,CAAC;AACJ,CAAC"}