@opensip-cli/simulation 0.1.0

package/dist/index.js

@@ -0,0 +1,53 @@
+// @fitness-ignore-file module-coupling-fan-out -- Package barrel by design: re-exports the public surface of every kind module; fan-out is the whole job of this file
+/**
+ * @opensip-cli/simulation — Simulation scenarios for codebase analysis.
+ *
+ * The package exposes two kind-specific scenario authoring entry points
+ * sharing one runtime contract:
+ *
+ *   - `defineLoadScenario`           ← BYO target + workload + assert SLO
+ *   - `defineChaosScenario`          ← BYO target + client-side faults + recovery
+ */
+// =============================================================================
+// RUNSCOPE AUGMENTATION — D7 (tool subscopes via module augmentation).
+// Side-effect import so importing the simulation package surfaces
+// `scope.simulation` on the augmented RunScope interface.
+// =============================================================================
+import './scope-augmentation.js';
+export { SCENARIO_KINDS } from './types/kind-types.js';
+// =============================================================================
+// LOAD KIND
+// =============================================================================
+export { defineLoadScenario, validateLoadScenarioConfig, } from './kinds/load/define.js';
+// =============================================================================
+// CHAOS KIND
+// =============================================================================
+export { defineChaosScenario, validateChaosScenarioConfig, } from './kinds/chaos/define.js';
+// =============================================================================
+// TOOL PLUGIN — simulation as a Tool implementation
+// =============================================================================
+// Re-exported as `tool` so the third-party plugin-discovery walker
+// (which keys on `mod.tool`) treats first-party and third-party Tool
+// packages uniformly; dedup at register-tools.ts handles the
+// duplicate-id case.
+export { simulationTool, simulationTool as tool } from './tool.js';
+export { SIMULATION_CONTRACT_VERSION } from './tool.js';
+// =============================================================================
+// SHARED INFRASTRUCTURE
+// =============================================================================
+// Authoring helpers (assertions, BYO target + fault builders) and runtime
+// utilities (result builder, metric resolver, abort/sleep helpers) shared by
+// every kind.
+export { ASSERTIONS, evaluateAssertion, evaluateOperator, getOperatorDescription, } from './framework/assertions.js';
+// BYO-target authoring surface: the `Target` seam, the neutral workload, and
+// the client-side fault vocabulary + ergonomic builders.
+export { httpTarget } from './framework/execution/http-target.js';
+export { fault } from './framework/execution/fault-builders.js';
+export { ScenarioResultBuilder, createEmptyMetrics, mergeMetrics, } from './framework/result-builder.js';
+export { resolveMetric } from './framework/resolve-metric.js';
+export { ScenarioAbortedError, scenarioAborted, validateAssertions, updateLatencyMetrics, sleepWithAbort, } from './framework/execution/execution-engine.js';
+// =============================================================================
+// RECIPES — sim recipes mirror the fitness recipe shape
+// =============================================================================
+export { defineSimulationRecipe } from './recipes/define-recipe.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sKAAsK;AACtK;;;;;;;;GAQG;AAEH,gFAAgF;AAChF,uEAAuE;AACvE,kEAAkE;AAClE,0DAA0D;AAC1D,gFAAgF;AAEhF,OAAO,yBAAyB,CAAC;AAQjC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAavD,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,OAAO,EACL,kBAAkB,EAClB,0BAA0B,GAE3B,MAAM,wBAAwB,CAAC;AAGhC,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAEhF,OAAO,EACL,mBAAmB,EACnB,2BAA2B,GAE5B,MAAM,yBAAyB,CAAC;AAGjC,gFAAgF;AAChF,oDAAoD;AACpD,gFAAgF;AAEhF,mEAAmE;AACnE,qEAAqE;AACrE,6DAA6D;AAC7D,qBAAqB;AACrB,OAAO,EAAE,cAAc,EAAE,cAAc,IAAI,IAAI,EAAE,MAAM,WAAW,CAAC;AACnE,OAAO,EAAE,2BAA2B,EAAE,MAAM,WAAW,CAAC;AAaxD,gFAAgF;AAChF,wBAAwB;AACxB,gFAAgF;AAChF,0EAA0E;AAC1E,6EAA6E;AAC7E,cAAc;AAEd,OAAO,EACL,UAAU,EAEV,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,2BAA2B,CAAC;AAEnC,6EAA6E;AAC7E,yDAAyD;AACzD,OAAO,EAAE,UAAU,EAA0B,MAAM,sCAAsC,CAAC;AAC1F,OAAO,EAAE,KAAK,EAAE,MAAM,yCAAyC,CAAC;AAKhE,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,YAAY,GACb,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,aAAa,EAA0B,MAAM,+BAA+B,CAAC;AAEtF,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,GACf,MAAM,2CAA2C,CAAC;AAEnD,gFAAgF;AAChF,wDAAwD;AACxD,gFAAgF;AAEhF,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/internal.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @opensip-cli/simulation/internal
+ *
+ * Internal simulation engine seams for package-owned tests and tool integration
+ * code that needs registry/lifecycle plumbing. This entrypoint is intentionally
+ * excluded from published package exports; production packages must use
+ * `@opensip-cli/simulation` and the Tool contract instead.
+ */
+export { ensureScenariosLoaded } from './cli/sim.js';
+export { createScenarioRegistry, currentScenarioRegistry, getRegisteredScenarios, getScenario, getScenariosByTag, getScenariosByKind, clearScenarioRegistry, } from './framework/registry.js';
+export { loadAllSimPlugins } from './plugins/loader.js';
+export { readScenarioPackagePreferences } from './plugins/scenario-package-discovery.js';
+export type { SimPluginExports } from './plugins/types.js';
+export { builtInSimulationRecipes, builtInSimulationRecipesByName, isBuiltInSimulationRecipe, } from './recipes/built-in-recipes.js';
+export { SimulationRecipeRegistry, createSimulationRecipeRegistry, currentSimulationRecipeRegistry, } from './recipes/registry.js';
+export type { SimulationRecipeDisplayInfo } from './recipes/registry.js';
+export { SimulationRecipeService } from './recipes/service.js';
+export type { SimulationRecipeServiceConfig, SimulationScenarioResult, SimulationRecipeResult, } from './recipes/service.js';
+//# sourceMappingURL=internal.d.ts.map

package/dist/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACtB,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,8BAA8B,EAAE,MAAM,yCAAyC,CAAC;AACzF,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,OAAO,EACL,wBAAwB,EACxB,8BAA8B,EAC9B,yBAAyB,GAC1B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,wBAAwB,EACxB,8BAA8B,EAC9B,+BAA+B,GAChC,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,YAAY,EACV,6BAA6B,EAC7B,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC"}

package/dist/internal.js

@@ -0,0 +1,16 @@
+/**
+ * @opensip-cli/simulation/internal
+ *
+ * Internal simulation engine seams for package-owned tests and tool integration
+ * code that needs registry/lifecycle plumbing. This entrypoint is intentionally
+ * excluded from published package exports; production packages must use
+ * `@opensip-cli/simulation` and the Tool contract instead.
+ */
+export { ensureScenariosLoaded } from './cli/sim.js';
+export { createScenarioRegistry, currentScenarioRegistry, getRegisteredScenarios, getScenario, getScenariosByTag, getScenariosByKind, clearScenarioRegistry, } from './framework/registry.js';
+export { loadAllSimPlugins } from './plugins/loader.js';
+export { readScenarioPackagePreferences } from './plugins/scenario-package-discovery.js';
+export { builtInSimulationRecipes, builtInSimulationRecipesByName, isBuiltInSimulationRecipe, } from './recipes/built-in-recipes.js';
+export { SimulationRecipeRegistry, createSimulationRecipeRegistry, currentSimulationRecipeRegistry, } from './recipes/registry.js';
+export { SimulationRecipeService } from './recipes/service.js';
+//# sourceMappingURL=internal.js.map

package/dist/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACtB,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,8BAA8B,EAAE,MAAM,yCAAyC,CAAC;AAGzF,OAAO,EACL,wBAAwB,EACxB,8BAA8B,EAC9B,yBAAyB,GAC1B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,wBAAwB,EACxB,8BAA8B,EAC9B,+BAA+B,GAChC,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC"}

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

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

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

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

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

@@ -0,0 +1,117 @@
+/**
+ * @fileoverview Behaviour + validation tests for the chaos kind against the
+ * real driver + fault model.
+ */
+import { describe, expect, it } from 'vitest';
+import { failingTarget, noopTarget } from '../../../__tests__/test-utils/targets.js';
+import { ASSERTIONS } from '../../../framework/assertions.js';
+import { fault } from '../../../framework/execution/fault-builders.js';
+import { defineChaosScenario, validateChaosScenarioConfig } from '../define.js';
+import { createChaosScenarioRunner } from '../executor.js';
+const base = (o = {}) => ({
+    id: 'c',
+    name: 'c',
+    description: 'c',
+    tags: [],
+    target: noopTarget,
+    workload: { rps: 50 },
+    duration: 0.3,
+    fault: fault.of([fault.drop()], { probability: 1 }),
+    steadyStateAssertions: [ASSERTIONS.lowErrorRate(0.5)],
+    recoveryAssertions: [ASSERTIONS.lowErrorRate(0.5)],
+    recoveryWindow: 100,
+    ...o,
+});
+describe('chaos executor', () => {
+    it('faults degrade the steady window; recovery recovers', async () => {
+        const r = await createChaosScenarioRunner(base()).run(new AbortController().signal);
+        if (r.kind !== 'chaos')
+            throw new Error('expected chaos result');
+        // probability-1 drop → all steady requests fail; recovery (bare noop) succeeds.
+        expect(r.outcome.steadyStateMetrics.failedRequests).toBeGreaterThan(0);
+        expect(r.outcome.steadyStateMetrics.successfulRequests).toBe(0);
+        expect(r.outcome.steadyStateAssertions.failed.length).toBeGreaterThan(0);
+        expect(r.outcome.recoveryMetrics.successfulRequests).toBeGreaterThan(0);
+        expect(r.outcome.recoveryAssertions.failed).toHaveLength(0);
+        expect(r.passed).toBe(false);
+        expect(r.outcome.chaosEvents.length).toBeGreaterThan(0);
+        expect(r.outcome.chaosEvents[0]?.type).toBe('drop');
+        expect(r.outcome.recoveryWindowMs).toBe(100);
+    });
+    it('passes when both windows hold (no faults injected)', async () => {
+        const r = await createChaosScenarioRunner(base({ 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.outcome.chaosEvents).toHaveLength(0);
+    });
+    it('fails recovery when the target never recovers', async () => {
+        const r = await createChaosScenarioRunner(base({
+            target: failingTarget,
+            fault: fault.of([fault.drop()], { probability: 0 }),
+            steadyStateAssertions: [ASSERTIONS.lowErrorRate(1)],
+            recoveryAssertions: [ASSERTIONS.lowErrorRate(0.1)],
+        })).run(new AbortController().signal);
+        if (r.kind !== 'chaos')
+            throw new Error('expected chaos result');
+        expect(r.outcome.recoveryAssertions.failed.length).toBeGreaterThan(0);
+        expect(r.passed).toBe(false);
+    });
+    it('honours an injected rng deterministically (no perturbation)', async () => {
+        const r = await createChaosScenarioRunner(base({ fault: fault.of([fault.drop()], { probability: 0.5 }) }), { rng: () => 0.9 }).run(new AbortController().signal);
+        if (r.kind !== 'chaos')
+            throw new Error('expected chaos result');
+        // rng always 0.9 ≥ 0.5 ⇒ never perturb.
+        expect(r.outcome.chaosEvents).toHaveLength(0);
+        expect(r.outcome.steadyStateMetrics.failedRequests).toBe(0);
+    });
+    it('throws on a pre-aborted signal', async () => {
+        const ac = new AbortController();
+        ac.abort();
+        await expect(createChaosScenarioRunner(base()).run(ac.signal)).rejects.toThrow(/abort/i);
+    });
+});
+describe('validateChaosScenarioConfig', () => {
+    it('accepts a valid config via defineChaosScenario', () => {
+        expect(defineChaosScenario(base()).kind).toBe('chaos');
+    });
+    it('rejects a non-function target', () => {
+        expect(() => validateChaosScenarioConfig(base({ target: undefined }))).toThrow(/target/);
+    });
+    it('rejects a probability outside [0,1]', () => {
+        expect(() => validateChaosScenarioConfig(base({ fault: fault.of([fault.drop()], { probability: 2 }) }))).toThrow(/probability/);
+    });
+    it('rejects an empty faults array', () => {
+        expect(() => validateChaosScenarioConfig(base({ fault: { faults: [], probability: 0.5 } }))).toThrow(/faults/);
+    });
+    it('rejects a non-positive rps', () => {
+        expect(() => validateChaosScenarioConfig(base({ workload: { rps: 0 } }))).toThrow(/rps/);
+    });
+    it('rejects empty steady-state assertions', () => {
+        expect(() => validateChaosScenarioConfig(base({ steadyStateAssertions: [] }))).toThrow(/steady/i);
+    });
+    it('rejects empty recovery assertions', () => {
+        expect(() => validateChaosScenarioConfig(base({ recoveryAssertions: [] }))).toThrow(/recovery assertion/i);
+    });
+    it('rejects an invalid recoveryWindow (negative / non-number)', () => {
+        expect(() => validateChaosScenarioConfig(base({ recoveryWindow: -1 }))).toThrow(/recoveryWindow/);
+        expect(() => validateChaosScenarioConfig(base({ recoveryWindow: 'soon' }))).toThrow(/recoveryWindow/);
+    });
+    it('rejects a negative rampUp', () => {
+        expect(() => validateChaosScenarioConfig(base({ workload: { rps: 1, rampUp: -1 } }))).toThrow(/rampUp must be non-negative/);
+    });
+    it('rejects a non-positive duration', () => {
+        expect(() => validateChaosScenarioConfig(base({ duration: 0 }))).toThrow(/duration/);
+    });
+    it('rejects a missing fault spec', () => {
+        expect(() => validateChaosScenarioConfig(base({ fault: undefined }))).toThrow(/fault spec is required/);
+    });
+    it('rejects an unknown fault kind', () => {
+        expect(() => validateChaosScenarioConfig(base({ fault: { faults: [{ kind: 'meltdown' }], probability: 0.5 } }))).toThrow(/fault kind must be one of/);
+    });
+    it('rejects a latency fault with a missing or negative ms', () => {
+        expect(() => validateChaosScenarioConfig(base({ fault: { faults: [{ kind: 'latency' }], probability: 0.5 } }))).toThrow(/latency fault requires a non-negative ms/);
+        expect(() => validateChaosScenarioConfig(base({ fault: { faults: [{ kind: 'latency', ms: -5 }], probability: 0.5 } }))).toThrow(/latency fault requires a non-negative ms/);
+    });
+});
+//# sourceMappingURL=executor.test.js.map

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

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

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

@@ -0,0 +1,48 @@
+/**
+ * @fileoverview `ChaosScenarioConfig` — author-facing configuration type.
+ *
+ * Extracted from `define.ts` into its own leaf module so `executor.ts`
+ * can reference the config shape without forming a file-level cycle:
+ *
+ *   `define.ts` → `executor.ts` (uses `createChaosScenarioRunner`)
+ *   `executor.ts` → `define.ts`  (uses `ChaosScenarioConfig`)
+ *
+ * The split inverts the dependency. Both files import the config shape from
+ * here, and nothing in this file imports back. `define.ts` re-exports
+ * `ChaosScenarioConfig` so callers keep one import path.
+ */
+import type { FaultSpec } from '../../framework/execution/fault-spec.js';
+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 chaos scenario.
+ *
+ * The `kind` discriminator is set by the entry point.
+ *
+ * Chaos drives a real BYO `target` under client-side fault injection: a
+ * steady-state window with the fault model active, then a recovery window with
+ * faults lifted. There is intentionally no custom-`execute` escape hatch — the
+ * `target` IS the BYO seam.
+ */
+export interface ChaosScenarioConfig {
+    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;
+    /** Steady-state (fault-active) window duration, in seconds. */
+    readonly duration: number;
+    /** Client-side faults injected during the steady-state window. */
+    readonly fault: FaultSpec;
+    /** Assertions evaluated on the steady-state (fault-active) metrics. */
+    readonly steadyStateAssertions: readonly ScenarioAssertion[];
+    /** Assertions evaluated on the recovery (faults-lifted) metrics. */
+    readonly recoveryAssertions: readonly ScenarioAssertion[];
+    /** Recovery window in milliseconds after faults lift. */
+    readonly recoveryWindow: number;
+}
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/kinds/chaos/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,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;;;;;;;;;GASG;AACH,MAAM,WAAW,mBAAmB;IAElC,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,+DAA+D;IAC/D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAG1B,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,uEAAuE;IACvE,QAAQ,CAAC,qBAAqB,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC7D,oEAAoE;IACpE,QAAQ,CAAC,kBAAkB,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC1D,yDAAyD;IACzD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC"}

package/dist/kinds/chaos/config.js

@@ -0,0 +1,15 @@
+/**
+ * @fileoverview `ChaosScenarioConfig` — author-facing configuration type.
+ *
+ * Extracted from `define.ts` into its own leaf module so `executor.ts`
+ * can reference the config shape without forming a file-level cycle:
+ *
+ *   `define.ts` → `executor.ts` (uses `createChaosScenarioRunner`)
+ *   `executor.ts` → `define.ts`  (uses `ChaosScenarioConfig`)
+ *
+ * The split inverts the dependency. Both files import the config shape from
+ * here, and nothing in this file imports back. `define.ts` re-exports
+ * `ChaosScenarioConfig` so callers keep one import path.
+ */
+export {};
+//# sourceMappingURL=config.js.map

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

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

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

@@ -0,0 +1,32 @@
+/**
+ * @fileoverview `defineChaosScenario` — chaos-kind entry point.
+ *
+ * The chaos kind drives a real BYO `target` under client-side fault injection
+ * with a recovery-window assertion contract. Authors supply:
+ *   - a `target` (the BYO seam) + a `workload` (rps/concurrency/ramp) + `duration`
+ *   - a `fault` spec (client-side faults + probability)
+ *   - `steadyStateAssertions` evaluated while faults are active
+ *   - `recoveryAssertions` evaluated during the post-fault recovery window
+ *   - `recoveryWindow` (ms) — how long after faults lift to evaluate recovery
+ */
+import type { ChaosScenarioConfig } from './config.js';
+import type { RunnableScenario } from '../../framework/runnable-scenario.js';
+export type { ChaosScenarioConfig } from './config.js';
+/**
+ * Validate a chaos scenario configuration. Throws on invalid input.
+ *
+ * Uniqueness against an existing scenario registry is checked at
+ * registration time, not here.
+ *
+ * @throws {ValidationError} When the chaos scenario configuration is invalid
+ */
+export declare function validateChaosScenarioConfig(config: ChaosScenarioConfig): void;
+/**
+ * Define a chaos-kind simulation scenario. Returns the scenario; the
+ * caller (typically the simulation plugin loader) is responsible for
+ * registering it into `scope.registries.scenarios`.
+ *
+ * @throws {ValidationError} When the scenario configuration is invalid
+ */
+export declare function defineChaosScenario(config: ChaosScenarioConfig): RunnableScenario;
+//# sourceMappingURL=define.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../../src/kinds/chaos/define.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAWH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAM7E,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAgFvD;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAS7E;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,gBAAgB,CAGjF"}

package/dist/kinds/chaos/define.js

@@ -0,0 +1,111 @@
+/**
+ * @fileoverview `defineChaosScenario` — chaos-kind entry point.
+ *
+ * The chaos kind drives a real BYO `target` under client-side fault injection
+ * with a recovery-window assertion contract. Authors supply:
+ *   - a `target` (the BYO seam) + a `workload` (rps/concurrency/ramp) + `duration`
+ *   - a `fault` spec (client-side faults + probability)
+ *   - `steadyStateAssertions` evaluated while faults are active
+ *   - `recoveryAssertions` evaluated during the post-fault recovery window
+ *   - `recoveryWindow` (ms) — how long after faults lift to evaluate recovery
+ */
+import { throwValidationErrors, validateScenarioMetadata, validateTargetAndWorkload, } from '../../framework/validation.js';
+import { createChaosScenarioRunner } from './executor.js';
+const VALID_FAULT_KINDS = new Set(['latency', 'abort', 'drop']);
+/**
+ * Chaos-specific workload-timing checks: `rampUp` must be non-negative and
+ * `duration` must be positive. The common `target`/`workload.rps`/
+ * `workload.concurrency` checks live in the shared
+ * `validateTargetAndWorkload`; these stay inline because chaos uses a
+ * different `rampUp` message ("must be non-negative") than load and does not
+ * cross-check `rampUp` against `duration`.
+ */
+function validateChaosWorkloadTiming(config, errors) {
+    if (config.workload?.rampUp !== undefined && config.workload.rampUp < 0) {
+        errors.push({ field: 'workload.rampUp', message: 'workload.rampUp must be non-negative' });
+    }
+    if (typeof config.duration !== 'number' || config.duration <= 0) {
+        errors.push({ field: 'duration', message: 'duration must be a positive number' });
+    }
+}
+function validateFault(config, errors) {
+    if (!config.fault) {
+        errors.push({ field: 'fault', message: 'fault spec is required for chaos scenarios' });
+        return;
+    }
+    if (typeof config.fault.probability !== 'number' ||
+        config.fault.probability < 0 ||
+        config.fault.probability > 1) {
+        errors.push({
+            field: 'fault.probability',
+            message: 'fault.probability must be in [0, 1]',
+        });
+    }
+    if (config.fault.faults.length === 0) {
+        errors.push({ field: 'fault.faults', message: 'fault.faults must be a non-empty array' });
+        return;
+    }
+    for (const [i, f] of config.fault.faults.entries()) {
+        if (!VALID_FAULT_KINDS.has(f.kind)) {
+            errors.push({
+                field: `fault.faults[${i}].kind`,
+                message: "fault kind must be one of 'latency' | 'abort' | 'drop'",
+            });
+        }
+        if (f.kind === 'latency' && (typeof f.ms !== 'number' || f.ms < 0)) {
+            errors.push({
+                field: `fault.faults[${i}].ms`,
+                message: 'latency fault requires a non-negative ms',
+            });
+        }
+    }
+}
+function validateAssertions(config, errors) {
+    if (config.steadyStateAssertions.length === 0) {
+        errors.push({
+            field: 'steadyStateAssertions',
+            message: 'at least one steady-state assertion is required',
+        });
+    }
+    if (config.recoveryAssertions.length === 0) {
+        errors.push({
+            field: 'recoveryAssertions',
+            message: 'at least one recovery assertion is required',
+        });
+    }
+    if (typeof config.recoveryWindow !== 'number' || config.recoveryWindow < 0) {
+        errors.push({
+            field: 'recoveryWindow',
+            message: 'recoveryWindow must be a non-negative number (milliseconds)',
+        });
+    }
+}
+/**
+ * Validate a chaos scenario configuration. Throws on invalid input.
+ *
+ * Uniqueness against an existing scenario registry is checked at
+ * registration time, not here.
+ *
+ * @throws {ValidationError} When the chaos scenario configuration is invalid
+ */
+export function validateChaosScenarioConfig(config) {
+    const errors = [];
+    validateScenarioMetadata(config, errors);
+    validateTargetAndWorkload(config, errors);
+    validateChaosWorkloadTiming(config, errors);
+    validateFault(config, errors);
+    validateAssertions(config, errors);
+    throwValidationErrors(errors, 'chaos');
+}
+/**
+ * Define a chaos-kind simulation scenario. Returns the scenario; the
+ * caller (typically the simulation plugin loader) is responsible for
+ * registering it into `scope.registries.scenarios`.
+ *
+ * @throws {ValidationError} When the scenario configuration is invalid
+ */
+export function defineChaosScenario(config) {
+    validateChaosScenarioConfig(config);
+    return createChaosScenarioRunner(config);
+}
+//# sourceMappingURL=define.js.map

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

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

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

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview Chaos-kind executor.
+ *
+ * Composes the real `runLoadWindow` driver with the client-side fault model:
+ * a steady-state window drives the BYO `target` wrapped by the fault model
+ * (latency/abort/drop injected at the configured probability), then a recovery
+ * window drives the bare target with faults lifted. Each window's measured
+ * metrics are scored against its assertion set; the scenario passes iff both
+ * windows hold.
+ */
+import type { ChaosScenarioConfig } from './config.js';
+import type { FaultModelDeps } from '../../framework/execution/fault-model.js';
+import type { RunnableScenario } from '../../framework/runnable-scenario.js';
+/**
+ * Build a `RunnableScenario` for a chaos-kind config.
+ *
+ * `deps.rng` is forwarded to the fault model so tests can drive the
+ * probability gate deterministically; production defaults to `Math.random`.
+ */
+export declare function createChaosScenarioRunner(config: ChaosScenarioConfig, deps?: FaultModelDeps): RunnableScenario;
+//# sourceMappingURL=executor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/kinds/chaos/executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAWH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAC/E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAsB7E;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,mBAAmB,EAC3B,IAAI,GAAE,cAAmB,GACxB,gBAAgB,CA8FlB"}

package/dist/kinds/chaos/executor.js

@@ -0,0 +1,107 @@
+/**
+ * @fileoverview Chaos-kind executor.
+ *
+ * Composes the real `runLoadWindow` driver with the client-side fault model:
+ * a steady-state window drives the BYO `target` wrapped by the fault model
+ * (latency/abort/drop injected at the configured probability), then a recovery
+ * window drives the bare target with faults lifted. Each window's measured
+ * metrics are scored against its assertion set; the scenario passes iff both
+ * windows hold.
+ */
+import { ScenarioAbortedError } from '../../framework/execution/execution-engine.js';
+import { createFaultModel } from '../../framework/execution/fault-model.js';
+import { runLoadWindow } from '../../framework/execution/run-load-window.js';
+import { buildFailedScenarioSignal, ScenarioResultBuilder, } from '../../framework/result-builder.js';
+import { createScenarioLogger } from '../../framework/scenario-logger.js';
+function evaluateAssertionsForWindow(scenarioId, metrics, durationSeconds, assertions) {
+    const built = ScenarioResultBuilder.create(scenarioId)
+        .withMetrics(metrics)
+        .withDuration(durationSeconds)
+        .evaluateAssertions(assertions)
+        .build();
+    return {
+        passed: built.assertions.passed,
+        failed: built.assertions.failed,
+    };
+}
+/**
+ * Build a `RunnableScenario` for a chaos-kind config.
+ *
+ * `deps.rng` is forwarded to the fault model so tests can drive the
+ * probability gate deterministically; production defaults to `Math.random`.
+ */
+export function createChaosScenarioRunner(config, deps = {}) {
+    return Object.freeze({
+        kind: 'chaos',
+        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);
+            }
+            const startTime = Date.now();
+            try {
+                const faultModel = createFaultModel(config.fault, deps);
+                // Steady-state window: drive the fault-decorated target.
+                const steadyStart = Date.now();
+                const steady = await runLoadWindow({ workload: config.workload }, context, {
+                    windowMs: config.duration * 1000,
+                    target: faultModel.wrap(config.target),
+                });
+                // Recovery window: faults lifted — drive the bare target.
+                const recovery = await runLoadWindow({ workload: config.workload }, context, {
+                    windowMs: config.recoveryWindow,
+                    target: config.target,
+                });
+                const steadyVerdict = evaluateAssertionsForWindow(config.id, steady.metrics, config.duration, config.steadyStateAssertions);
+                const recoveryVerdict = evaluateAssertionsForWindow(config.id, recovery.metrics, config.recoveryWindow / 1000, config.recoveryAssertions);
+                const failedAssertions = [...steadyVerdict.failed, ...recoveryVerdict.failed];
+                const passed = failedAssertions.length === 0;
+                const chaosEvents = Object.freeze(faultModel.drained().map((f) => Object.freeze({
+                    type: f.kind,
+                    atMs: Math.max(0, f.at - steadyStart),
+                    target: 'client',
+                })));
+                return Object.freeze({
+                    kind: 'chaos',
+                    scenarioId: config.id,
+                    passed,
+                    durationMs: Date.now() - startTime,
+                    // ADR-0035: surface a failed chaos scenario in the signal currency
+                    // (steady- and recovery-window assertion failures), so the host
+                    // verdict sees it. The load path emits via build(); chaos builds its
+                    // own payload, so it must emit here.
+                    signals: passed
+                        ? Object.freeze([])
+                        : Object.freeze([buildFailedScenarioSignal(config.id, failedAssertions)]),
+                    outcome: Object.freeze({
+                        steadyStateMetrics: steady.metrics,
+                        recoveryMetrics: recovery.metrics,
+                        steadyStateAssertions: steadyVerdict,
+                        recoveryAssertions: recoveryVerdict,
+                        chaosEvents,
+                        recoveryWindowMs: config.recoveryWindow,
+                    }),
+                });
+            }
+            catch (error) {
+                if (abortSignal.aborted) {
+                    throw new ScenarioAbortedError(config.id);
+                }
+                throw error;
+            }
+        },
+    });
+}
+//# sourceMappingURL=executor.js.map

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

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