@opensip-cli/simulation 0.1.0

package/dist/tool.js

@@ -0,0 +1,347 @@
+/**
+ * simulationTool — simulation as a Tool plugin.
+ *
+ * Owns the `sim` subcommand. The Commander wiring is no longer hand-rolled:
+ * the tool exports a
+ * declarative {@link CommandSpec} (`simCommand`) and the host's
+ * `mountCommandSpec` mounts it (name/description/aliases, the ADR-0021 common
+ * flags, the `--recipe` option) and owns the parse→handler→error→exit pipeline.
+ * This file owns only the sim runner — the `runSim` handler below — which keeps
+ * the JSON/Ink dispatch, cloud egress, and report auto-open exactly as the
+ * old `register()` action body did (byte-identical behaviour).
+ */
+import { EXIT_CODES } from '@opensip-cli/contracts';
+import { defineCommand, readPackageVersion } from '@opensip-cli/core';
+import { resolveSession } from '@opensip-cli/session-store';
+import { simulationConfigDeclaration } from './cli/sim-config-schema.js';
+import { renderSimLive } from './cli/sim-runner.js';
+import { simRunWorkerCommandSpec } from './cli/sim-worker.js';
+import { executeSim } from './cli/sim.js';
+import { createScenarioRegistry, createSimulationLoadState, currentScenarioRegistry, } from './framework/registry.js';
+import { simReplayFromSession } from './persistence/session-replay.js';
+import { SIM_PLUGIN_LAYOUT } from './plugins/loader.js';
+import { createSimulationRecipeRegistry, currentSimulationRecipeRegistry, } from './recipes/registry.js';
+import { simScaffoldExamples, simStableExampleIds } from './scaffold/examples.js';
+// Side-effect import: ensures the RunScope.simulation augmentation is
+// loaded so `scope.simulation` is the correctly-typed slot here.
+import './scope-augmentation.js';
+const SIM = {
+    name: 'sim',
+    description: 'Run simulation scenarios',
+};
+const SIM_RUN_WORKER = {
+    name: 'sim-run-worker',
+    description: '[internal] Run sim headless and stream progress + result over IPC (forked by the live view)',
+};
+// Live-view key — matches the `sim` subcommand name so the dispatcher's
+// renderLive(key) lookup resolves it (ADR-0016). sim's Ink/React renderer
+// (renderSimLive) is registered directly; the prior static-only path remains
+// for json / non-TTY runs.
+const SIM_LIVE_VIEW_KEY = 'sim';
+/**
+ * Set sim's live view (ADR-0016) up on the host context — a synchronous,
+ * void-returning map write (named with the `set` prefix to signal that). Its
+ * effectful egress (cloud + `--report-to`) lives at the composition root:
+ * renderSimLive returns the run's envelope and this callback delivers it once
+ * the Ink app exits — the same contract fit uses.
+ *
+ * In the spec-mounted world there is no `register()` mount hook, so the handler
+ * sets the renderer up lazily at the top of its body (before any
+ * `cli.renderLive` lookup). `registerLiveView` is an idempotent map write, so
+ * doing this once per run — only on the interactive path that needs it — is
+ * equivalent to the old mount-time registration.
+ */
+function setUpSimLiveView(cli) {
+    cli.registerLiveView(SIM_LIVE_VIEW_KEY, async (args, liveContext) => {
+        const simArgs = args;
+        // The renderer returns a ToolRunCompletion; the HOST persists its `session`
+        // after this resolves (host-owned-run-timing Phase 2).
+        const completion = await renderSimLive(simArgs, { setExitCode: cli.setExitCode }, liveContext);
+        if (completion.envelope !== undefined) {
+            // ADR-0035: the host derives the findings exit from envelope.verdict.passed.
+            await cli.deliverSignals(completion.envelope, {
+                cwd: simArgs.cwd,
+                reportTo: simArgs.reportTo,
+                apiKey: simArgs.apiKey,
+            });
+        }
+        return completion;
+    });
+}
+/**
+ * The `sim` command handler — the former `register()` action body, lifted to a
+ * spec handler. `output: 'raw-stream'` (handler owns its own IO): the host runs
+ * this and renders nothing further, so the handler keeps full ownership of the
+ * TTY-vs-static branch, the JSON/Ink dispatch, the cloud egress, the exit-code
+ * decision, and the report auto-open.
+ */
+async function runSim(rawOpts, cli) {
+    const opts = rawOpts;
+    if (opts.show !== undefined && opts.show.length > 0) {
+        await runSimShowMode(opts, cli);
+        return;
+    }
+    // Interactive TTY (non-json): the animated live view. Egress + exit code +
+    // host session persistence are handled via the registerLiveView callback /
+    // renderSimLive (host completeLiveRender) after the Ink app exits.
+    if (opts.json !== true && process.stdout.isTTY === true) {
+        setUpSimLiveView(cli);
+        await cli.renderLive(SIM_LIVE_VIEW_KEY, opts);
+        await cli.maybeOpenReport({
+            openRequested: Boolean(opts.open),
+            jsonOutput: false,
+        });
+        return;
+    }
+    // json / non-TTY (pipe / CI): run the engine and render statically — the
+    // animated Ink view is a TTY-only affordance. Output is byte-for-byte the
+    // pre-live-view behavior.
+    const { result } = await executeSim(opts);
+    if (result.type === 'error') {
+        if (opts.json) {
+            // Structured error outcome: the host wraps and sets the exit code.
+            cli.emitError({ message: result.message, exitCode: result.exitCode });
+        }
+        else {
+            cli.setExitCode(result.exitCode);
+            await cli.render(result);
+        }
+        return;
+    }
+    // ADR-0011: one render path per mode. `--json` emits the envelope
+    // through the shared formatSignalJson; default renders the envelope-
+    // derived per-scenario table.
+    if (opts.json) {
+        cli.emitEnvelope(result.envelope);
+    }
+    else {
+        await cli.render(result);
+    }
+    // Effectful egress + host-owned findings exit live at the root (cloud sink +
+    // `--report-to` exit 4 + the verdict-derived exit, ADR-0035). Once per run.
+    await cli.deliverSignals(result.envelope, {
+        cwd: result.cwd,
+        reportTo: opts.reportTo,
+        apiKey: opts.apiKey,
+    });
+    await cli.maybeOpenReport({
+        openRequested: Boolean(opts.open),
+        jsonOutput: Boolean(opts.json),
+    });
+    // host-owned-run-timing Phase 3: RETURN the generic-session contribution; the
+    // host run plane persists it after this handler resolves (no tool-side write).
+    const { buildSimulationSessionPayload } = await import('./persistence/session-payload.js');
+    return {
+        session: {
+            tool: 'sim',
+            cwd: result.cwd,
+            recipe: result.recipeName,
+            score: result.envelope.verdict.score,
+            passed: result.envelope.verdict.passed,
+            payload: buildSimulationSessionPayload(result.envelope),
+        },
+    };
+}
+async function runSimShowMode(opts, cli) {
+    const datastore = cli.scope.datastore();
+    if (datastore === undefined) {
+        await emitSimShowError(opts, cli, 'datastore-unavailable', 'session replay requires a datastore');
+        return;
+    }
+    const resolved = resolveSession(datastore, {
+        ref: opts.show ?? 'latest',
+        tool: 'sim',
+    });
+    if (!resolved.ok) {
+        await emitSimShowError(opts, cli, resolved.reason, resolved.detail);
+        return;
+    }
+    try {
+        const replay = simReplayFromSession(resolved.session);
+        if (opts.json === true) {
+            cli.emitJson(sessionShowJson(resolved.session, replay));
+            return;
+        }
+        await cli.render(sessionReplayResult(resolved.session, replay));
+    }
+    catch (error) {
+        await emitSimShowError(opts, cli, 'decode-error', error instanceof Error ? error.message : String(error));
+    }
+}
+async function emitSimShowError(opts, cli, reason, detail) {
+    if (opts.json === true) {
+        // emitError sets the exit code itself (process exit == reported outcome).
+        cli.emitError({
+            message: detail,
+            exitCode: EXIT_CODES.CONFIGURATION_ERROR,
+            code: reason,
+        });
+        return;
+    }
+    cli.setExitCode(EXIT_CODES.CONFIGURATION_ERROR);
+    await cli.render({
+        type: 'error',
+        message: detail,
+        exitCode: EXIT_CODES.CONFIGURATION_ERROR,
+    });
+}
+function sessionShowJson(session, replay) {
+    return {
+        session: {
+            id: session.id,
+            tool: session.tool,
+            startedAt: session.startedAt,
+            completedAt: session.completedAt,
+            recipe: session.recipe,
+            cwd: session.cwd,
+            score: session.score,
+            passed: session.passed,
+            durationMs: session.durationMs,
+        },
+        fidelity: replay.fidelity,
+        envelope: replay.envelope,
+    };
+}
+/** The tool-agnostic `session-replay` view result (rendered via the shared
+ *  envelope table; no live-run footer). `cli.render` takes `unknown`. */
+function sessionReplayResult(session, replay) {
+    return {
+        type: 'session-replay',
+        session: {
+            id: session.id,
+            tool: session.tool,
+            startedAt: session.startedAt,
+            completedAt: session.completedAt,
+            ...(session.recipe === undefined ? {} : { recipe: session.recipe }),
+            score: session.score,
+            passed: session.passed,
+            durationMs: session.durationMs,
+        },
+        envelope: replay.envelope,
+        fidelity: replay.fidelity,
+    };
+}
+/**
+ * The declarative `sim` command. Replaces the hand-rolled `register()` body:
+ * the host mounts this
+ * spec, applies the ADR-0021 common flags + the `--recipe` option, and invokes
+ * `runSim`.
+ *
+ * `output: 'raw-stream'` because sim's handler owns its entire output surface —
+ * it dispatches between the interactive Ink live view and the static
+ * render/JSON path at runtime (TTY-dependent) and performs cloud egress, the
+ * report auto-open, and the exit-code decision itself. None of those are
+ * expressible through the `signal-envelope` dispatch arm (which only does
+ * `emitEnvelope`/`render`), so the host renders nothing and the handler stays
+ * authoritative — byte-identical to the former action body.
+ */
+const simCommand = defineCommand({
+    name: SIM.name,
+    description: SIM.description,
+    // ADR-0021 cross-tool flags from the single registry: --cwd, --json, --quiet,
+    // --verbose, --debug, --report-to, --api-key, --open. sim carries -v/--verbose
+    // (per-scenario detail). `cwd` is seeded with process.cwd() by the mounter.
+    commonFlags: ['cwd', 'json', 'quiet', 'verbose', 'debug', 'reportTo', 'apiKey', 'open'],
+    options: [
+        {
+            flag: '--recipe',
+            value: '<name>',
+            description: 'Run a named sim recipe (default: built-in `default`)',
+        },
+        {
+            flag: '--show',
+            value: '<session>',
+            description: 'Replay a stored sim session by id, or latest for the latest sim session',
+        },
+    ],
+    scope: 'project',
+    output: 'raw-stream',
+    rawStreamReason: 'runtime-render-dispatch',
+    handler: runSim,
+});
+/**
+ * The simulation tool's REAL registrar for its `sim-pack` capability domain
+ * (§5.3 / Phase 4). The host registers the domain from sim's manifest with a
+ * deferred placeholder, then swaps in this registrar once sim's module loads.
+ * A routed contribution (host-checked against `requiredKeys: ['id']`) is
+ * registered into THIS run's scope-owned scenario registry.
+ */
+const registerSimScenario = (contribution) => {
+    currentScenarioRegistry().register(contribution);
+};
+/**
+ * The simulation tool's registrar for its `sim-recipe` capability domain (§5.3
+ * separate-domains fold). A scenario pack's co-located `recipes` export is routed
+ * here by the SAME discovery walk that loads its scenarios. Host-checked against
+ * `requiredKeys: ['id', 'name']`; silently skips an already-registered id/name
+ * (mirroring the shared `registerRecipesFromMod` dedupe).
+ */
+const registerSimRecipe = (contribution) => {
+    const recipe = contribution;
+    const registry = currentSimulationRecipeRegistry();
+    if (registry.has(recipe.id) || registry.has(recipe.name))
+        return;
+    registry.register(recipe, { allowOverwrite: false });
+};
+/**
+ * Per-run subscope contribution (D7). Called by the CLI's pre-action-hook
+ * after constructing the scope and before entering it; the kernel installs
+ * the returned `simulation` slot. Fresh scenario + recipe registries + a fresh
+ * `ensureScenariosLoaded` lifecycle slot per run (audit F1) so concurrent scopes
+ * carry independent simulation state.
+ */
+function contributeScope() {
+    return {
+        simulation: {
+            scenarios: createScenarioRegistry(),
+            recipes: createSimulationRecipeRegistry(),
+            load: createSimulationLoadState(),
+        },
+    };
+}
+/**
+ * Per-tool contract version (ADR-0047).
+ */
+export const SIMULATION_CONTRACT_VERSION = '1.0.0';
+export const SIMULATION_STABLE_ID = '715d32c2-692c-4ed4-985b-a35deaf186aa';
+export const simulationTool = {
+    metadata: {
+        id: SIMULATION_STABLE_ID, // stable UUID (per ADR-0048; matches Checks `id` naming)
+        name: 'simulation', // human key (previously the value in `id`)
+        version: readPackageVersion(import.meta.url),
+        description: 'Run simulation scenarios against a codebase',
+    },
+    commands: [SIM, SIM_RUN_WORKER],
+    pluginLayout: SIM_PLUGIN_LAYOUT,
+    // Sim declares its command surface; the host mounts it via mountCommandSpec.
+    // The deprecated
+    // `register()` fallback is gone — sim no longer touches Commander.
+    commandSpecs: [simCommand, simRunWorkerCommandSpec],
+    contributeScope,
+    sessionReplay: {
+        tool: 'sim',
+        replaySession: simReplayFromSession,
+    },
+    // ADR-0023 Phase 4: simulation contributes its namespaced `simulation:` Zod
+    // schema so the host composes + strict-validates the whole config document
+    // before dispatch.
+    config: simulationConfigDeclaration,
+    // §5.3 Phase 4: simulation owns the `sim-pack` capability domain (declared in
+    // its manifest). It supplies the REAL registrar so the host can replace the
+    // manifest-time deferred placeholder once sim's module loads.
+    capabilityRegistrars: {
+        'sim-pack': registerSimScenario,
+        'sim-recipe': registerSimRecipe,
+    },
+    // ADR-0038: simulation owns its `init` example bytes (language-independent). The
+    // host writes each returned file under userPluginDir('sim', file.kind).
+    scaffoldExamples: simScaffoldExamples,
+    stableExampleIds: simStableExampleIds,
+    // ADR-0047: per-tool contract version for simulation's domain surface
+    // (scenarios, recipes, execution model, etc.). Independent of core
+    // TOOL_CONTRACT_VERSION. Declared under extensionPoints.
+    extensionPoints: {
+        simulationContractVersion: SIMULATION_CONTRACT_VERSION,
+    },
+};
+//# sourceMappingURL=tool.js.map

package/dist/tool.js.map

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

package/dist/types/base-types.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @fileoverview Simulation-specific type definitions.
+ *
+ * Core scenario types shared across the framework: the assertion shape and the
+ * aggregated metrics struct produced by the load-window driver.
+ */
+import type { ScenarioMetricKey } from '../framework/scenario-metric-key.js';
+/** Less-than comparison operators */
+type LessThanOperator = 'lt' | 'lte';
+/** Greater-than comparison operators */
+type GreaterThanOperator = 'gt' | 'gte';
+/** Equality comparison operators */
+type EqualityAssertionOperator = 'eq' | 'neq';
+/** All assertion comparison operators */
+export type AssertionOperator = LessThanOperator | GreaterThanOperator | EqualityAssertionOperator;
+/** A metric assertion evaluated after a scenario run */
+export interface ScenarioAssertion {
+    metric: ScenarioMetricKey;
+    operator: AssertionOperator;
+    value: number;
+    message: string;
+}
+/** Aggregated performance metrics measured during a simulation run */
+export interface SimulationMetrics {
+    totalRequests: number;
+    successfulRequests: number;
+    failedRequests: number;
+    avgLatencyMs: number;
+    p50LatencyMs: number;
+    p95LatencyMs: number;
+    p99LatencyMs: number;
+    errorsGenerated: number;
+}
+export {};
+//# sourceMappingURL=base-types.d.ts.map

package/dist/types/base-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-types.d.ts","sourceRoot":"","sources":["../../src/types/base-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAM7E,qCAAqC;AACrC,KAAK,gBAAgB,GAAG,IAAI,GAAG,KAAK,CAAC;AACrC,wCAAwC;AACxC,KAAK,mBAAmB,GAAG,IAAI,GAAG,KAAK,CAAC;AACxC,oCAAoC;AACpC,KAAK,yBAAyB,GAAG,IAAI,GAAG,KAAK,CAAC;AAC9C,yCAAyC;AACzC,MAAM,MAAM,iBAAiB,GAAG,gBAAgB,GAAG,mBAAmB,GAAG,yBAAyB,CAAC;AAEnG,wDAAwD;AACxD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD,sEAAsE;AACtE,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;CACzB"}

package/dist/types/base-types.js

@@ -0,0 +1,8 @@
+/**
+ * @fileoverview Simulation-specific type definitions.
+ *
+ * Core scenario types shared across the framework: the assertion shape and the
+ * aggregated metrics struct produced by the load-window driver.
+ */
+export {};
+//# sourceMappingURL=base-types.js.map

package/dist/types/base-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-types.js","sourceRoot":"","sources":["../../src/types/base-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/types/framework-types.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @fileoverview Cross-kind type definitions for the Simulation Framework.
+ *
+ * The framework exposes two kind-specific entry points (`defineLoadScenario`,
+ * `defineChaosScenario`). The discriminated union over kinds lives in
+ * `framework/scenario-executor-result.ts`; the cross-kind `RunnableScenario`
+ * lives in `framework/runnable-scenario.ts`.
+ *
+ * The exports below are the small set of cross-kind shapes that each kind's
+ * `define`/`executor`/`result` modules consume — execution context + logger,
+ * assertion + failed-assertion shapes, and the load result payload (produced by
+ * `ScenarioResultBuilder`).
+ */
+import type { SimulationMetrics, ScenarioAssertion as MutableScenarioAssertion } from './base-types.js';
+import type { Signal } from '@opensip-cli/core';
+/**
+ * A scenario assertion definition (readonly variant for framework use).
+ */
+export type ScenarioAssertion = Readonly<MutableScenarioAssertion>;
+/**
+ * A failed assertion with actual value.
+ */
+export interface FailedAssertion extends ScenarioAssertion {
+    readonly actual: number;
+}
+/**
+ * Context passed to scenario executors.
+ */
+export interface ScenarioExecutionContext {
+    readonly scenarioId: string;
+    readonly correlationId: string;
+    readonly abortSignal: AbortSignal;
+    readonly logger: ScenarioLogger;
+}
+/**
+ * Logger interface for scenarios.
+ */
+export interface ScenarioLogger {
+    info(message: string, data?: Record<string, unknown>): void;
+    warn(message: string, data?: Record<string, unknown>): void;
+    error(message: string, data?: Record<string, unknown>): void;
+    debug(message: string, data?: Record<string, unknown>): void;
+}
+/**
+ * Load-shaped scenario result payload, produced by `ScenarioResultBuilder`.
+ *
+ * This is the builder's output shape: the load and chaos executors build a
+ * payload of this shape and wrap it into their kind-specific
+ * `ScenarioExecutorResult` envelope (the discriminated union over kinds in
+ * `framework/scenario-executor-result.ts`).
+ */
+export interface LoadResultPayload {
+    readonly passed: boolean;
+    readonly metrics: SimulationMetrics;
+    readonly assertions: {
+        readonly passed: readonly ScenarioAssertion[];
+        readonly failed: readonly FailedAssertion[];
+    };
+    readonly signals: readonly Signal[];
+}
+export { type AssertionOperator, type SimulationMetrics } from './base-types.js';
+//# sourceMappingURL=framework-types.d.ts.map

package/dist/types/framework-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-types.d.ts","sourceRoot":"","sources":["../../src/types/framework-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,IAAI,wBAAwB,EAC9C,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAMhD;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC,wBAAwB,CAAC,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,iBAAiB;IACxD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAMD;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC9D;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE;QACnB,QAAQ,CAAC,MAAM,EAAE,SAAS,iBAAiB,EAAE,CAAC;QAC9C,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;KAC7C,CAAC;IACF,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAMD,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/types/framework-types.js

@@ -0,0 +1,15 @@
+/**
+ * @fileoverview Cross-kind type definitions for the Simulation Framework.
+ *
+ * The framework exposes two kind-specific entry points (`defineLoadScenario`,
+ * `defineChaosScenario`). The discriminated union over kinds lives in
+ * `framework/scenario-executor-result.ts`; the cross-kind `RunnableScenario`
+ * lives in `framework/runnable-scenario.ts`.
+ *
+ * The exports below are the small set of cross-kind shapes that each kind's
+ * `define`/`executor`/`result` modules consume — execution context + logger,
+ * assertion + failed-assertion shapes, and the load result payload (produced by
+ * `ScenarioResultBuilder`).
+ */
+export {};
+//# sourceMappingURL=framework-types.js.map

package/dist/types/framework-types.js.map

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

package/dist/types/kind-types.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @fileoverview Discriminator + cross-kind shared types for the scenario kind system.
+ *
+ * The standalone simulation tool supports two scenario kinds, each with its own
+ * author-facing entry point and per-kind result outcome:
+ *
+ *   - `load`           — personas + ramp + sustain + assert SLO metrics
+ *   - `chaos`          — base load + failure injection + recovery assertions
+ *
+ * The `invariant` and `fix-evaluation` kinds were removed as parent-product-coupled
+ * (standalone-CLI trim, 2026-06-05; parent DEC-338 superseded here) — they were
+ * integration harnesses for the SaaS runtime (reconciler/DBOS/audit/Postgres).
+ *
+ * The discriminator is internal to the framework. Authors call the kind-specific
+ * `defineXxxScenario` entry point; that entry point sets `kind` on the resulting
+ * `RunnableScenario`. The discriminated union over `ScenarioExecutorResult`
+ * lets persistence + dashboard code dispatch on `kind` without leaking
+ * kind-internal types.
+ */
+/** Scenario kind discriminator. */
+export type ScenarioKind = 'load' | 'chaos';
+/** All scenario kinds, frozen for runtime iteration. */
+export declare const SCENARIO_KINDS: readonly ScenarioKind[];
+//# sourceMappingURL=kind-types.d.ts.map

package/dist/types/kind-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kind-types.d.ts","sourceRoot":"","sources":["../../src/types/kind-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,mCAAmC;AACnC,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,CAAC;AAE5C,wDAAwD;AACxD,eAAO,MAAM,cAAc,EAAE,SAAS,YAAY,EAAqC,CAAC"}

package/dist/types/kind-types.js

@@ -0,0 +1,22 @@
+/**
+ * @fileoverview Discriminator + cross-kind shared types for the scenario kind system.
+ *
+ * The standalone simulation tool supports two scenario kinds, each with its own
+ * author-facing entry point and per-kind result outcome:
+ *
+ *   - `load`           — personas + ramp + sustain + assert SLO metrics
+ *   - `chaos`          — base load + failure injection + recovery assertions
+ *
+ * The `invariant` and `fix-evaluation` kinds were removed as parent-product-coupled
+ * (standalone-CLI trim, 2026-06-05; parent DEC-338 superseded here) — they were
+ * integration harnesses for the SaaS runtime (reconciler/DBOS/audit/Postgres).
+ *
+ * The discriminator is internal to the framework. Authors call the kind-specific
+ * `defineXxxScenario` entry point; that entry point sets `kind` on the resulting
+ * `RunnableScenario`. The discriminated union over `ScenarioExecutorResult`
+ * lets persistence + dashboard code dispatch on `kind` without leaking
+ * kind-internal types.
+ */
+/** All scenario kinds, frozen for runtime iteration. */
+export const SCENARIO_KINDS = Object.freeze(['load', 'chaos']);
+//# sourceMappingURL=kind-types.js.map

package/dist/types/kind-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kind-types.js","sourceRoot":"","sources":["../../src/types/kind-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,wDAAwD;AACxD,MAAM,CAAC,MAAM,cAAc,GAA4B,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC"}

package/dist/types/workload.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @fileoverview `Workload` — the neutral arrival-rate model the load-window
+ * driver consumes.
+ *
+ * Replaces the persona model (buyer/seller/admin `spawnRate`), which was
+ * parent-SaaS domain vestige the driver only ever collapsed into a single RPS
+ * number. A workload states the target request rate directly, plus an optional
+ * in-flight concurrency cap and ramp-up.
+ */
+/** Author-facing workload for a load/chaos scenario. */
+export interface Workload {
+    /** Target requests per second the driver paces toward. */
+    readonly rps: number;
+    /**
+     * Maximum in-flight requests. When omitted, derived from `rps` via
+     * {@link resolveConcurrency} so authors need only specify `rps`.
+     */
+    readonly concurrency?: number;
+    /** Linear ramp-up from 0 to `rps`, in seconds. Defaults to 0 (no ramp). */
+    readonly rampUp?: number;
+}
+/**
+ * Resolve the in-flight concurrency cap for a workload.
+ *
+ * When `concurrency` is set, it wins. Otherwise derive a bound from `rps`:
+ * roughly one in-flight slot per 5 rps (min 1). This keeps a default scenario
+ * from issuing an unbounded burst while still letting real latency overlap.
+ */
+export declare function resolveConcurrency(workload: Workload): number;
+//# sourceMappingURL=workload.d.ts.map

package/dist/types/workload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workload.d.ts","sourceRoot":"","sources":["../../src/types/workload.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,wDAAwD;AACxD,MAAM,WAAW,QAAQ;IACvB,0DAA0D;IAC1D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAE7D"}

package/dist/types/workload.js

@@ -0,0 +1,20 @@
+/**
+ * @fileoverview `Workload` — the neutral arrival-rate model the load-window
+ * driver consumes.
+ *
+ * Replaces the persona model (buyer/seller/admin `spawnRate`), which was
+ * parent-SaaS domain vestige the driver only ever collapsed into a single RPS
+ * number. A workload states the target request rate directly, plus an optional
+ * in-flight concurrency cap and ramp-up.
+ */
+/**
+ * Resolve the in-flight concurrency cap for a workload.
+ *
+ * When `concurrency` is set, it wins. Otherwise derive a bound from `rps`:
+ * roughly one in-flight slot per 5 rps (min 1). This keeps a default scenario
+ * from issuing an unbounded burst while still letting real latency overlap.
+ */
+export function resolveConcurrency(workload) {
+    return workload.concurrency ?? Math.max(1, Math.ceil(workload.rps / 5));
+}
+//# sourceMappingURL=workload.js.map

package/dist/types/workload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workload.js","sourceRoot":"","sources":["../../src/types/workload.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAeH;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAkB;IACnD,OAAO,QAAQ,CAAC,WAAW,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;AAC1E,CAAC"}