@opensip-cli/simulation 0.1.0

package/dist/framework/registry.js

@@ -0,0 +1,113 @@
+/**
+ * @fileoverview Cross-kind scenario registry — per-RunScope.
+ *
+ * Each `RunScope` owns its own `Registry<RunnableScenario>` (Item 1 /
+ * D7 — tool subscopes via module augmentation).
+ * The simulation tool's `contributeScope` hook constructs a fresh registry
+ * per CLI invocation and attaches it to `scope.simulation.scenarios`.
+ *
+ * Built on the kernel's unified `Registry<T>` with
+ * `duplicatePolicy: 'silent-skip'` (re-importing the same scenario is a
+ * no-op) + `nameCollisionMode: 'throw'` (two different scenario ids
+ * sharing a name would corrupt the dual-key state). This is the same
+ * shape the legacy `IdNameTagRegistry` provided (which has been deleted).
+ *
+ * Public API:
+ *   - `createScenarioRegistry()`  — factory used by `contributeScope`.
+ *   - `currentScenarioRegistry()` — reads the scope-bound registry;
+ *                                   throws when called outside a scope
+ *                                   or when `simulation` subscope is
+ *                                   absent.
+ *   - `getRegisteredScenarios()` / `getScenario` / `getScenariosByTag` /
+ *     `getScenariosByKind` / `clearScenarioRegistry` — thin helpers that
+ *     route through the scope-bound registry.
+ */
+import { Registry, currentScope } from '@opensip-cli/core';
+/** Construct a fresh `ensureScenariosLoaded` lifecycle slot for a single `RunScope` (audit F1). */
+export function createSimulationLoadState() {
+    return { loadedFor: null, pluginLoadErrors: [] };
+}
+/**
+ * Read the current scope's simulation load state (`scope.simulation.load`).
+ * Throws when no scope/subscope is active — same contract as
+ * {@link currentScenarioRegistry}.
+ *
+ * @throws {Error} When called outside `runWithScope(...)`, or when the active
+ *   scope has no simulation subscope.
+ */
+export function currentSimulationLoadState() {
+    const scope = currentScope();
+    if (!scope?.simulation) {
+        throw new Error('simulation: currentSimulationLoadState() requires an active RunScope with a ' +
+            'simulation subscope (production: the pre-action-hook; tests: makeTestScope + ' +
+            'simulationTool.contributeScope()).');
+    }
+    return scope.simulation.load;
+}
+/** Construct a fresh scenario registry for a single `RunScope`. */
+export function createScenarioRegistry() {
+    return new Registry({
+        module: 'simulation:scenarios',
+        duplicatePolicy: 'silent-skip',
+        evtPrefix: 'scenario.registry',
+        nameCollisionMode: 'throw',
+        validationCode: 'VALIDATION.REGISTRY.NAME_COLLISION',
+    });
+}
+/**
+ * Read the current scope's scenario registry. Throws when no scope is
+ * active or when the simulation subscope is missing — both indicate the
+ * caller is running outside the CLI's pre-action-hook (or the test
+ * fixture forgot to construct + enter a scope).
+ *
+ * @throws {Error} When called outside `runWithScope(...)`, or when the
+ *   active scope has no simulation subscope.
+ */
+export function currentScenarioRegistry() {
+    const scope = currentScope();
+    if (!scope) {
+        throw new Error('simulation: currentScenarioRegistry() called outside a RunScope. ' +
+            'Wrap the call site in runWithScope (production: pre-action-hook handles ' +
+            'this; tests: use makeTestScope + simulationTool.contributeScope or construct ' +
+            'a Registry directly).');
+    }
+    if (!scope.simulation) {
+        throw new Error('simulation: scope.simulation is missing. The simulation tool must be ' +
+            'registered and its contributeScope hook must run before scenario reads. ' +
+            '(production: bootstrap registers simulationTool; tests: call ' +
+            'simulationTool.contributeScope() after makeTestScope.)');
+    }
+    return scope.simulation.scenarios;
+}
+/** Get all registered scenarios from the current scope's registry. */
+export function getRegisteredScenarios() {
+    const map = new Map();
+    for (const scenario of currentScenarioRegistry().getAll()) {
+        map.set(scenario.id, scenario);
+    }
+    return map;
+}
+/** Get a scenario by id or name from the current scope's registry. */
+export function getScenario(idOrName) {
+    return currentScenarioRegistry().get(idOrName);
+}
+/** Get scenarios filtered by tag (any kind). */
+export function getScenariosByTag(tag) {
+    return currentScenarioRegistry().getByTag(tag);
+}
+/** Get scenarios filtered by kind. */
+export function getScenariosByKind(kind) {
+    return currentScenarioRegistry()
+        .getAll()
+        .filter((s) => s.kind === kind);
+}
+/**
+ * Clear the current scope's scenario registry. Used by tests, by host
+ * applications that need to swap the scenario set at runtime, and by
+ * recipe-reset code paths. The simulation engine's plugin loader
+ * re-populates it on the next load cycle.
+ */
+export function clearScenarioRegistry() {
+    currentScenarioRegistry().clear();
+}
+//# sourceMappingURL=registry.js.map

package/dist/framework/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/framework/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAM3D,mGAAmG;AACnG,MAAM,UAAU,yBAAyB;IACvC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,gBAAgB,EAAE,EAAE,EAAE,CAAC;AACnD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,0BAA0B;IACxC,MAAM,KAAK,GAAG,YAAY,EAAE,CAAC;IAC7B,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,8EAA8E;YAC5E,+EAA+E;YAC/E,oCAAoC,CACvC,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC;AAC/B,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,sBAAsB;IACpC,OAAO,IAAI,QAAQ,CAAmB;QACpC,MAAM,EAAE,sBAAsB;QAC9B,eAAe,EAAE,aAAa;QAC9B,SAAS,EAAE,mBAAmB;QAC9B,iBAAiB,EAAE,OAAO;QAC1B,cAAc,EAAE,oCAAoC;KACrD,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB;IACrC,MAAM,KAAK,GAAG,YAAY,EAAE,CAAC;IAC7B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,mEAAmE;YACjE,0EAA0E;YAC1E,+EAA+E;YAC/E,uBAAuB,CAC1B,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CACb,uEAAuE;YACrE,0EAA0E;YAC1E,+DAA+D;YAC/D,wDAAwD,CAC3D,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC;AACpC,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,sBAAsB;IACpC,MAAM,GAAG,GAAG,IAAI,GAAG,EAA4B,CAAC;IAChD,KAAK,MAAM,QAAQ,IAAI,uBAAuB,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC;QAC1D,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,WAAW,CAAC,QAAgB;IAC1C,OAAO,uBAAuB,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AACjD,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,OAAO,uBAAuB,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AACjD,CAAC;AAED,sCAAsC;AACtC,MAAM,UAAU,kBAAkB,CAAC,IAAkB;IACnD,OAAO,uBAAuB,EAAE;SAC7B,MAAM,EAAE;SACR,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AACpC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB;IACnC,uBAAuB,EAAE,CAAC,KAAK,EAAE,CAAC;AACpC,CAAC"}

package/dist/framework/resolve-metric.d.ts

@@ -0,0 +1,79 @@
+/**
+ * @fileoverview Single source of truth for resolving simulation-metric keys
+ * to numeric values.
+ *
+ * Both `validateAssertions` (in `execution/execution-engine.ts`) and
+ * `ScenarioResultBuilder.evaluateAssertions` (in `result-builder.ts`)
+ * delegate here. Before this module existed, each kept its own resolver
+ * and the two diverged — most visibly on `success_rate` when
+ * `totalRequests === 0`.
+ *
+ * ## Supported keys
+ *
+ * Computed (derived from raw counters):
+ *
+ *   - `error_rate`         — `failedRequests / totalRequests`,
+ *                            `0` when `totalRequests === 0`.
+ *   - `success_rate`       — `successfulRequests / totalRequests`,
+ *                            **`0` when `totalRequests === 0`**. See note below.
+ *   - `recovery_rate`      — `1 - failedRequests / errorsGenerated`,
+ *                            `1` when `errorsGenerated === 0` (no errors to
+ *                            recover from ⇒ trivially fully recovered).
+ *   - `requests_per_second` — `totalRequests / durationSeconds`,
+ *                             `0` when `durationSeconds` is missing or `<= 0`.
+ *
+ * Direct field accessors (passthrough to `SimulationMetrics`):
+ *
+ *   - `avg_latency_ms`, `avg_latency`           → `avgLatencyMs`
+ *   - `p50_latency_ms`, `p50_latency`           → `p50LatencyMs`
+ *   - `p95_latency_ms`, `p95_latency`           → `p95LatencyMs`
+ *   - `p99_latency_ms`, `p99_latency`           → `p99LatencyMs`
+ *   - `total_requests`                          → `totalRequests`
+ *   - `successful_requests`                     → `successfulRequests`
+ *   - `failed_requests`                         → `failedRequests`
+ *   - `errors_generated`                        → `errorsGenerated`
+ *
+ * Reserved keys (recognised at type-level, not yet populated by any executor;
+ * resolver returns `0`):
+ *
+ *   - `max_latency_ms`     — produced by `ASSERTIONS.maxLatency()`.
+ *   - `memory_mb`          — produced by `ASSERTIONS.memoryUsage()`.
+ *   - `cpu_percent`        — produced by `ASSERTIONS.cpuUsage()`.
+ *
+ * These exist so the standard ASSERTIONS factories continue to type-check.
+ * Until an executor records the underlying field on `SimulationMetrics`, the
+ * resolver returns `0` (assertions like `cpuUsage(80)` with operator `lt`
+ * therefore pass trivially). Promote a reserved key to a real one by adding
+ * the underlying field to `SimulationMetrics` and a case here.
+ *
+ * ## Note: `success_rate` with no requests
+ *
+ * When `totalRequests === 0`, `successfulRequests / totalRequests` is `0/0`.
+ * The two historical resolvers disagreed:
+ *
+ *   - The execution-engine path returned `1` (no failures ⇒ pass).
+ *   - The result-builder path returned `0` (no successes ⇒ fail).
+ *
+ * We pick **`0`**, matching the result-builder's existing pinned behaviour
+ * (see `result-builder.test.ts` "success_rate is 0 when no requests"). The
+ * rationale: a scenario that produced zero requests is misconfigured or
+ * aborted-early, and a `highSuccessRate` assertion should _fail_ in that
+ * case, not silently pass. The execution-engine path's old `1` result was
+ * the looser, more-permissive choice and is the one being tightened.
+ */
+import type { ScenarioMetricKey } from './scenario-metric-key.js';
+import type { SimulationMetrics } from '../types/base-types.js';
+export type { ScenarioMetricKey } from './scenario-metric-key.js';
+/**
+ * Resolve a metric key to its numeric value.
+ *
+ * @param metric - The metric key to resolve. See module-level docs for the
+ *   full supported set and edge-case semantics.
+ * @param metrics - The collected simulation metrics.
+ * @param durationSeconds - Required only for `requests_per_second`. When
+ *   missing or non-positive for that key, the function returns `0`.
+ * @returns The numeric value. Unknown keys (post-narrowing — should be
+ *   prevented at compile time) fall through to `0`.
+ */
+export declare function resolveMetric(metric: ScenarioMetricKey, metrics: SimulationMetrics, durationSeconds?: number): number;
+//# sourceMappingURL=resolve-metric.d.ts.map

package/dist/framework/resolve-metric.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-metric.d.ts","sourceRoot":"","sources":["../../src/framework/resolve-metric.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8DG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAOhE,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,iBAAiB,EAC1B,eAAe,CAAC,EAAE,MAAM,GACvB,MAAM,CA2DR"}

package/dist/framework/resolve-metric.js

@@ -0,0 +1,135 @@
+/**
+ * @fileoverview Single source of truth for resolving simulation-metric keys
+ * to numeric values.
+ *
+ * Both `validateAssertions` (in `execution/execution-engine.ts`) and
+ * `ScenarioResultBuilder.evaluateAssertions` (in `result-builder.ts`)
+ * delegate here. Before this module existed, each kept its own resolver
+ * and the two diverged — most visibly on `success_rate` when
+ * `totalRequests === 0`.
+ *
+ * ## Supported keys
+ *
+ * Computed (derived from raw counters):
+ *
+ *   - `error_rate`         — `failedRequests / totalRequests`,
+ *                            `0` when `totalRequests === 0`.
+ *   - `success_rate`       — `successfulRequests / totalRequests`,
+ *                            **`0` when `totalRequests === 0`**. See note below.
+ *   - `recovery_rate`      — `1 - failedRequests / errorsGenerated`,
+ *                            `1` when `errorsGenerated === 0` (no errors to
+ *                            recover from ⇒ trivially fully recovered).
+ *   - `requests_per_second` — `totalRequests / durationSeconds`,
+ *                             `0` when `durationSeconds` is missing or `<= 0`.
+ *
+ * Direct field accessors (passthrough to `SimulationMetrics`):
+ *
+ *   - `avg_latency_ms`, `avg_latency`           → `avgLatencyMs`
+ *   - `p50_latency_ms`, `p50_latency`           → `p50LatencyMs`
+ *   - `p95_latency_ms`, `p95_latency`           → `p95LatencyMs`
+ *   - `p99_latency_ms`, `p99_latency`           → `p99LatencyMs`
+ *   - `total_requests`                          → `totalRequests`
+ *   - `successful_requests`                     → `successfulRequests`
+ *   - `failed_requests`                         → `failedRequests`
+ *   - `errors_generated`                        → `errorsGenerated`
+ *
+ * Reserved keys (recognised at type-level, not yet populated by any executor;
+ * resolver returns `0`):
+ *
+ *   - `max_latency_ms`     — produced by `ASSERTIONS.maxLatency()`.
+ *   - `memory_mb`          — produced by `ASSERTIONS.memoryUsage()`.
+ *   - `cpu_percent`        — produced by `ASSERTIONS.cpuUsage()`.
+ *
+ * These exist so the standard ASSERTIONS factories continue to type-check.
+ * Until an executor records the underlying field on `SimulationMetrics`, the
+ * resolver returns `0` (assertions like `cpuUsage(80)` with operator `lt`
+ * therefore pass trivially). Promote a reserved key to a real one by adding
+ * the underlying field to `SimulationMetrics` and a case here.
+ *
+ * ## Note: `success_rate` with no requests
+ *
+ * When `totalRequests === 0`, `successfulRequests / totalRequests` is `0/0`.
+ * The two historical resolvers disagreed:
+ *
+ *   - The execution-engine path returned `1` (no failures ⇒ pass).
+ *   - The result-builder path returned `0` (no successes ⇒ fail).
+ *
+ * We pick **`0`**, matching the result-builder's existing pinned behaviour
+ * (see `result-builder.test.ts` "success_rate is 0 when no requests"). The
+ * rationale: a scenario that produced zero requests is misconfigured or
+ * aborted-early, and a `highSuccessRate` assertion should _fail_ in that
+ * case, not silently pass. The execution-engine path's old `1` result was
+ * the looser, more-permissive choice and is the one being tightened.
+ */
+/**
+ * Resolve a metric key to its numeric value.
+ *
+ * @param metric - The metric key to resolve. See module-level docs for the
+ *   full supported set and edge-case semantics.
+ * @param metrics - The collected simulation metrics.
+ * @param durationSeconds - Required only for `requests_per_second`. When
+ *   missing or non-positive for that key, the function returns `0`.
+ * @returns The numeric value. Unknown keys (post-narrowing — should be
+ *   prevented at compile time) fall through to `0`.
+ */
+export function resolveMetric(metric, metrics, durationSeconds) {
+    switch (metric) {
+        case 'error_rate': {
+            return metrics.totalRequests > 0 ? metrics.failedRequests / metrics.totalRequests : 0;
+        }
+        case 'success_rate': {
+            // See module-level docs: `0` when totalRequests === 0 (tightening choice).
+            return metrics.totalRequests > 0 ? metrics.successfulRequests / metrics.totalRequests : 0;
+        }
+        case 'recovery_rate': {
+            // No errors to recover from ⇒ trivially fully recovered (1).
+            return metrics.errorsGenerated > 0 ? 1 - metrics.failedRequests / metrics.errorsGenerated : 1;
+        }
+        case 'requests_per_second': {
+            if (durationSeconds === undefined || durationSeconds <= 0) {
+                return 0;
+            }
+            return metrics.totalRequests / durationSeconds;
+        }
+        case 'avg_latency':
+        case 'avg_latency_ms': {
+            return metrics.avgLatencyMs;
+        }
+        case 'p50_latency':
+        case 'p50_latency_ms': {
+            return metrics.p50LatencyMs;
+        }
+        case 'p95_latency':
+        case 'p95_latency_ms': {
+            return metrics.p95LatencyMs;
+        }
+        case 'p99_latency':
+        case 'p99_latency_ms': {
+            return metrics.p99LatencyMs;
+        }
+        case 'total_requests': {
+            return metrics.totalRequests;
+        }
+        case 'successful_requests': {
+            return metrics.successfulRequests;
+        }
+        case 'failed_requests': {
+            return metrics.failedRequests;
+        }
+        case 'errors_generated': {
+            return metrics.errorsGenerated;
+        }
+        case 'max_latency_ms':
+        case 'memory_mb':
+        case 'cpu_percent': {
+            // Reserved: no underlying field on SimulationMetrics yet.
+            return 0;
+        }
+        default: {
+            // Exhaustive — `ScenarioMetricKey` should narrow to never here. This
+            // branch only fires if a caller deliberately bypasses the type check.
+            return 0;
+        }
+    }
+}
+//# sourceMappingURL=resolve-metric.js.map

package/dist/framework/resolve-metric.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-metric.js","sourceRoot":"","sources":["../../src/framework/resolve-metric.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8DG;AAYH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAyB,EACzB,OAA0B,EAC1B,eAAwB;IAExB,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,OAAO,OAAO,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QACxF,CAAC;QACD,KAAK,cAAc,CAAC,CAAC,CAAC;YACpB,2EAA2E;YAC3E,OAAO,OAAO,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5F,CAAC;QACD,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,6DAA6D;YAC7D,OAAO,OAAO,CAAC,eAAe,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;QAChG,CAAC;QACD,KAAK,qBAAqB,CAAC,CAAC,CAAC;YAC3B,IAAI,eAAe,KAAK,SAAS,IAAI,eAAe,IAAI,CAAC,EAAE,CAAC;gBAC1D,OAAO,CAAC,CAAC;YACX,CAAC;YACD,OAAO,OAAO,CAAC,aAAa,GAAG,eAAe,CAAC;QACjD,CAAC;QACD,KAAK,aAAa,CAAC;QACnB,KAAK,gBAAgB,CAAC,CAAC,CAAC;YACtB,OAAO,OAAO,CAAC,YAAY,CAAC;QAC9B,CAAC;QACD,KAAK,aAAa,CAAC;QACnB,KAAK,gBAAgB,CAAC,CAAC,CAAC;YACtB,OAAO,OAAO,CAAC,YAAY,CAAC;QAC9B,CAAC;QACD,KAAK,aAAa,CAAC;QACnB,KAAK,gBAAgB,CAAC,CAAC,CAAC;YACtB,OAAO,OAAO,CAAC,YAAY,CAAC;QAC9B,CAAC;QACD,KAAK,aAAa,CAAC;QACnB,KAAK,gBAAgB,CAAC,CAAC,CAAC;YACtB,OAAO,OAAO,CAAC,YAAY,CAAC;QAC9B,CAAC;QACD,KAAK,gBAAgB,CAAC,CAAC,CAAC;YACtB,OAAO,OAAO,CAAC,aAAa,CAAC;QAC/B,CAAC;QACD,KAAK,qBAAqB,CAAC,CAAC,CAAC;YAC3B,OAAO,OAAO,CAAC,kBAAkB,CAAC;QACpC,CAAC;QACD,KAAK,iBAAiB,CAAC,CAAC,CAAC;YACvB,OAAO,OAAO,CAAC,cAAc,CAAC;QAChC,CAAC;QACD,KAAK,kBAAkB,CAAC,CAAC,CAAC;YACxB,OAAO,OAAO,CAAC,eAAe,CAAC;QACjC,CAAC;QACD,KAAK,gBAAgB,CAAC;QACtB,KAAK,WAAW,CAAC;QACjB,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,0DAA0D;YAC1D,OAAO,CAAC,CAAC;QACX,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACR,qEAAqE;YACrE,sEAAsE;YACtE,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/framework/result-builder.d.ts

@@ -0,0 +1,72 @@
+/**
+ * @fileoverview Fluent builder for scenario execution results
+ *
+ * Metrics must be set before build(). Result is immutable after build().
+ * Assertions are evaluated in order.
+ */
+import type { SimulationMetrics } from '../types/base-types.js';
+import type { ScenarioAssertion, FailedAssertion, LoadResultPayload } from '../types/framework-types.js';
+import type { Signal } from '@opensip-cli/core';
+/**
+ * Build the single error-severity signal that represents a failed scenario
+ * (ADR-0011 / ADR-0035). A failed scenario must surface in the signal currency
+ * so the host verdict — and every sink (`--json`, SARIF, cloud) — sees it; the
+ * pre-ADR-0035 sim emitted no signal on failure, leaving `errors === 0` for a
+ * run that should fail. One `high`-severity signal per failed scenario,
+ * attributed to its `scenarioId`, summarizing the failed assertions. Shared by
+ * the load path (via `build()`) and the chaos executor.
+ */
+export declare function buildFailedScenarioSignal(scenarioId: string, failedAssertions: readonly FailedAssertion[]): Signal;
+/**
+ * Builder for scenario execution results.
+ * Ensures consistent result structure across all scenarios.
+ *
+ * @example
+ * ```typescript
+ * const result = ScenarioResultBuilder.create('my-scenario')
+ *   .withMetrics(collectedMetrics)
+ *   .evaluateAssertions(scenario.assertions)
+ *   .addSignals(generatedSignals)
+ *   .build();
+ * ```
+ */
+export declare class ScenarioResultBuilder {
+    private readonly scenarioId;
+    private _metrics;
+    private _duration;
+    private readonly _passedAssertions;
+    private readonly _failedAssertions;
+    private readonly _signals;
+    private constructor();
+    /** Get the scenario ID for this builder. */
+    getScenarioId(): string;
+    /** Create a new result builder. */
+    static create(scenarioId: string): ScenarioResultBuilder;
+    /** Set the simulation metrics. */
+    withMetrics(metrics: SimulationMetrics): this;
+    /** Set the scenario duration in seconds (used for derived metrics like RPS). */
+    withDuration(seconds: number): this;
+    /** Record a passed assertion. */
+    assertionPassed(assertion: ScenarioAssertion): this;
+    /** Record a failed assertion. */
+    assertionFailed(assertion: ScenarioAssertion, actual: number): this;
+    /** Evaluate all assertions against the current metrics. */
+    evaluateAssertions(assertions: readonly ScenarioAssertion[]): this;
+    /** Add a single signal. */
+    addSignal(signal: Signal): this;
+    /** Add multiple signals. */
+    addSignals(signals: readonly Signal[]): this;
+    /** Build the final load-shaped payload. Throws if metrics are not set. */
+    build(): LoadResultPayload;
+    private resolveAssertionMetric;
+}
+/**
+ * Create an empty/initial metrics object.
+ */
+export declare function createEmptyMetrics(): SimulationMetrics;
+/**
+ * Merge multiple metrics objects.
+ * Useful for aggregating metrics from parallel execution.
+ */
+export declare function mergeMetrics(metricsList: readonly SimulationMetrics[]): SimulationMetrics;
+//# sourceMappingURL=result-builder.d.ts.map

package/dist/framework/result-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-builder.d.ts","sourceRoot":"","sources":["../../src/framework/result-builder.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AAOH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EACV,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EAClB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,MAAM,EAClB,gBAAgB,EAAE,SAAS,eAAe,EAAE,GAC3C,MAAM,CAWR;AAMD;;;;;;;;;;;;GAYG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA2B;IAC7D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAyB;IAC3D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IAEzC,OAAO;IAIP,4CAA4C;IAC5C,aAAa,IAAI,MAAM;IAIvB,mCAAmC;IACnC,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,qBAAqB;IAQxD,kCAAkC;IAClC,WAAW,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAK7C,gFAAgF;IAChF,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IASnC,iCAAiC;IACjC,eAAe,CAAC,SAAS,EAAE,iBAAiB,GAAG,IAAI;IAKnD,iCAAiC;IACjC,eAAe,CAAC,SAAS,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAKnE,2DAA2D;IAC3D,kBAAkB,CAAC,UAAU,EAAE,SAAS,iBAAiB,EAAE,GAAG,IAAI;IAyBlE,2BAA2B;IAC3B,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK/B,4BAA4B;IAC5B,UAAU,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAS5C,0EAA0E;IAE1E,KAAK,IAAI,iBAAiB;IA+B1B,OAAO,CAAC,sBAAsB;CAS/B;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,iBAAiB,CAWtD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,SAAS,iBAAiB,EAAE,GAAG,iBAAiB,CAiCzF"}

package/dist/framework/result-builder.js

@@ -0,0 +1,214 @@
+// @fitness-ignore-file batch-operation-limits -- iterates bounded collections (config entries, registry items, or small analysis results)
+/**
+ * @fileoverview Fluent builder for scenario execution results
+ *
+ * Metrics must be set before build(). Result is immutable after build().
+ * Assertions are evaluated in order.
+ */
+import { createSignal, isErrorSignal, ValidationError } from '@opensip-cli/core';
+import { evaluateAssertion } from './assertions.js';
+import { resolveMetric } from './resolve-metric.js';
+/**
+ * Build the single error-severity signal that represents a failed scenario
+ * (ADR-0011 / ADR-0035). A failed scenario must surface in the signal currency
+ * so the host verdict — and every sink (`--json`, SARIF, cloud) — sees it; the
+ * pre-ADR-0035 sim emitted no signal on failure, leaving `errors === 0` for a
+ * run that should fail. One `high`-severity signal per failed scenario,
+ * attributed to its `scenarioId`, summarizing the failed assertions. Shared by
+ * the load path (via `build()`) and the chaos executor.
+ */
+export function buildFailedScenarioSignal(scenarioId, failedAssertions) {
+    const detail = failedAssertions
+        .map((a) => `${a.metric} ${a.operator} ${String(a.value)} (actual ${String(a.actual)})`)
+        .join('; ');
+    return createSignal({
+        source: scenarioId,
+        severity: 'high',
+        category: 'resilience',
+        ruleId: `sim:${scenarioId}`,
+        message: `Scenario '${scenarioId}' failed ${String(failedAssertions.length)} assertion(s): ${detail}`,
+    });
+}
+// =============================================================================
+// RESULT BUILDER
+// =============================================================================
+/**
+ * Builder for scenario execution results.
+ * Ensures consistent result structure across all scenarios.
+ *
+ * @example
+ * ```typescript
+ * const result = ScenarioResultBuilder.create('my-scenario')
+ *   .withMetrics(collectedMetrics)
+ *   .evaluateAssertions(scenario.assertions)
+ *   .addSignals(generatedSignals)
+ *   .build();
+ * ```
+ */
+export class ScenarioResultBuilder {
+    scenarioId;
+    _metrics = null;
+    _duration = null;
+    _passedAssertions = [];
+    _failedAssertions = [];
+    _signals = [];
+    constructor(scenarioId) {
+        this.scenarioId = scenarioId;
+    }
+    /** Get the scenario ID for this builder. */
+    getScenarioId() {
+        return this.scenarioId;
+    }
+    /** Create a new result builder. */
+    static create(scenarioId) {
+        return new ScenarioResultBuilder(scenarioId);
+    }
+    // ===========================================================================
+    // METRICS
+    // ===========================================================================
+    /** Set the simulation metrics. */
+    withMetrics(metrics) {
+        this._metrics = metrics;
+        return this;
+    }
+    /** Set the scenario duration in seconds (used for derived metrics like RPS). */
+    withDuration(seconds) {
+        this._duration = seconds;
+        return this;
+    }
+    // ===========================================================================
+    // ASSERTIONS
+    // ===========================================================================
+    /** Record a passed assertion. */
+    assertionPassed(assertion) {
+        this._passedAssertions.push(assertion);
+        return this;
+    }
+    /** Record a failed assertion. */
+    assertionFailed(assertion, actual) {
+        this._failedAssertions.push({ ...assertion, actual });
+        return this;
+    }
+    /** Evaluate all assertions against the current metrics. */
+    evaluateAssertions(assertions) {
+        if (!this._metrics) {
+            // @fitness-ignore-next-line result-pattern-consistency -- builder precondition, throw is appropriate
+            throw new ValidationError('Metrics must be set before evaluating assertions. Call withMetrics() first.', { code: 'VALIDATION.RESULT_BUILDER.METRICS_REQUIRED' });
+        }
+        for (const assertion of assertions) {
+            const actual = this.resolveAssertionMetric(assertion.metric);
+            if (evaluateAssertion(assertion, actual)) {
+                this.assertionPassed(assertion);
+            }
+            else {
+                this.assertionFailed(assertion, actual);
+            }
+        }
+        return this;
+    }
+    // ===========================================================================
+    // SIGNALS
+    // ===========================================================================
+    /** Add a single signal. */
+    addSignal(signal) {
+        this._signals.push(signal);
+        return this;
+    }
+    /** Add multiple signals. */
+    addSignals(signals) {
+        this._signals.push(...signals);
+        return this;
+    }
+    // ===========================================================================
+    // BUILD
+    // ===========================================================================
+    /** Build the final load-shaped payload. Throws if metrics are not set. */
+    // @fitness-ignore-next-line result-pattern-consistency -- return type is LoadResultPayload (not canonical Result); throw is a builder precondition
+    build() {
+        if (!this._metrics) {
+            // @fitness-ignore-next-line result-pattern-consistency -- builder precondition, throw is appropriate
+            throw new ValidationError('Metrics are required. Call withMetrics() before build().', {
+                code: 'VALIDATION.RESULT_BUILDER.METRICS_REQUIRED',
+            });
+        }
+        // ADR-0035: a failed scenario must emit an error-severity signal so the host
+        // verdict sees the failure (the signal currency, not just `passed`). Append
+        // one unless the scenario already authored an error signal of its own.
+        const signals = [...this._signals];
+        if (this._failedAssertions.length > 0 && !signals.some(isErrorSignal)) {
+            signals.push(buildFailedScenarioSignal(this.scenarioId, this._failedAssertions));
+        }
+        return Object.freeze({
+            passed: this._failedAssertions.length === 0,
+            metrics: this._metrics,
+            assertions: Object.freeze({
+                passed: Object.freeze([...this._passedAssertions]),
+                failed: Object.freeze([...this._failedAssertions]),
+            }),
+            signals: Object.freeze(signals),
+        });
+    }
+    // ===========================================================================
+    // PRIVATE
+    // ===========================================================================
+    resolveAssertionMetric(metric) {
+        /* v8 ignore next 3 -- unreachable defensive guard: the only caller
+           (evaluateAssertions) already throws when `_metrics` is unset, so this
+           branch can never fire through the public API. */
+        if (!this._metrics) {
+            return 0;
+        }
+        return resolveMetric(metric, this._metrics, this._duration ?? undefined);
+    }
+}
+// =============================================================================
+// HELPER FUNCTIONS
+// =============================================================================
+/**
+ * Create an empty/initial metrics object.
+ */
+export function createEmptyMetrics() {
+    return {
+        totalRequests: 0,
+        successfulRequests: 0,
+        failedRequests: 0,
+        avgLatencyMs: 0,
+        p50LatencyMs: 0,
+        p95LatencyMs: 0,
+        p99LatencyMs: 0,
+        errorsGenerated: 0,
+    };
+}
+/**
+ * Merge multiple metrics objects.
+ * Useful for aggregating metrics from parallel execution.
+ */
+export function mergeMetrics(metricsList) {
+    if (metricsList.length === 0) {
+        return createEmptyMetrics();
+    }
+    if (metricsList.length === 1) {
+        const first = metricsList[0];
+        return first ?? createEmptyMetrics();
+    }
+    const totalRequests = metricsList.reduce((sum, m) => sum + m.totalRequests, 0);
+    const totalSuccessful = metricsList.reduce((sum, m) => sum + m.successfulRequests, 0);
+    const totalFailed = metricsList.reduce((sum, m) => sum + m.failedRequests, 0);
+    const weightedAvgLatency = totalRequests > 0
+        ? metricsList.reduce((sum, m) => sum + m.avgLatencyMs * m.totalRequests, 0) / totalRequests
+        : 0;
+    const p50 = Math.max(...metricsList.map((m) => m.p50LatencyMs));
+    const p95 = Math.max(...metricsList.map((m) => m.p95LatencyMs));
+    const p99 = Math.max(...metricsList.map((m) => m.p99LatencyMs));
+    return {
+        totalRequests,
+        successfulRequests: totalSuccessful,
+        failedRequests: totalFailed,
+        avgLatencyMs: weightedAvgLatency,
+        p50LatencyMs: p50,
+        p95LatencyMs: p95,
+        p99LatencyMs: p99,
+        errorsGenerated: metricsList.reduce((sum, m) => sum + m.errorsGenerated, 0),
+    };
+}
+//# sourceMappingURL=result-builder.js.map

package/dist/framework/result-builder.js.map

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