@opensip-cli/simulation 0.1.0

package/dist/cli/sim-runner.js

@@ -0,0 +1,175 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * sim-runner — owns the live-view state machine for `opensip sim`
+ * (ADR-0016). Before this, sim had NO live view: it ran to completion silently
+ * and printed a static envelope-to-table. It now renders the shared
+ * <LiveProgress> (pool mode) during the run, so the user sees an animated
+ * spinner + scenario `completed/total` — including for parallel recipes, where
+ * the counter advances as concurrent scenarios finish.
+ *
+ * Shared presentational primitives (Banner, RunHeader, RunSummary, LiveProgress)
+ * come from @opensip-cli/cli-ui. Effectful egress (cloud + --report-to) stays
+ * at the composition root: this runner returns the run's SignalEnvelope and the
+ * tool's registerLiveView callback delivers it once the Ink app exits.
+ *
+ * The live run executes OFF the main process (ADR-0028): it forks the CLI to the
+ * internal `sim-run-worker` subcommand and relays progress + result over IPC, so
+ * the spinner + 80ms clock never block on a synchronous chunk. It falls back to
+ * in-process when forking is disabled/unavailable (OPENSIP_CLI_NO_WORKER).
+ */
+import { mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { Banner, ClockProvider, ErrorMessage, LiveProgress, normalizeBannerSize, ProjectHeader, renderToInk, RunFooterHints, RunHeader, RunSummary, RunTimingProvider, ThemeProvider, UpdateHint, VERBOSE_DETAIL_HINT, viewFindingsGroups, } from '@opensip-cli/cli-ui';
+import { runOffThreadOrInProcess, currentScope, } from '@opensip-cli/core';
+import { Box, Static, useApp, render } from 'ink';
+import React, { useEffect, useState } from 'react';
+import { buildSimulationSessionPayload } from '../persistence/session-payload.js';
+import { executeSim } from './sim.js';
+const SIM_TOOL_TITLE = 'Simulation Scenarios';
+const SIM_TOOL_DESCRIPTION = 'Running simulation scenarios against your codebase.';
+const SIM_RUNNING_SURFACE = { shape: 'pool', label: 'Running scenarios...' };
+const SIM_LOADING_SURFACE = { shape: 'pool', label: 'Loading scenarios...' };
+const NO_PROGRESS = () => {
+    // The loading phase has no event stream yet — render a bare animated spinner.
+};
+/**
+ * Run sim through the transport, translating the engine's `(completed, total)`
+ * callback into pool ProgressEvents on the `'scenarios'` stage. Hoisted to
+ * module scope so the emit translation isn't a deeply-nested function.
+ */
+function executeSimWithProgress(args, emit) {
+    emit({ type: 'stage-start', stage: 'scenarios', label: 'Running scenarios...' });
+    return executeSim(args, {
+        onProgress: (completed, total) => emit({ type: 'stage-progress', stage: 'scenarios', completed, total }),
+    });
+}
+/** The sim live-view component (loading → running → done/error). Exported for
+ *  testing; production renders it through {@link renderSimLive}. */
+export function SimRunner({ args, setExitCode, onEnvelope, onSession, liveContext, }) {
+    const { exit } = useApp();
+    const [state, setState] = useState({ phase: 'loading' });
+    useEffect(() => {
+        let cancelled = false;
+        // Execute OFF the main process (ADR-0028): fork the CLI to `sim-run-worker`,
+        // which re-bootstraps the full scope and streams progress + the final result
+        // over IPC, so this process stays free to animate the spinner + 80ms clock.
+        // Falls back to the in-process closure (OPENSIP_CLI_NO_WORKER / fork
+        // failure) — identical result. The worker reads its serializable args spec
+        // from a temp file cleaned up after the run settles.
+        const specDir = mkdtempSync(join(tmpdir(), 'sim-worker-'));
+        const specPath = join(specDir, 'spec.json');
+        writeFileSync(specPath, JSON.stringify(args), 'utf8');
+        const run = runOffThreadOrInProcess({
+            descriptor: { command: process.argv[1] ?? '', argv: ['sim-run-worker', specPath] },
+            inProcess: (emit) => executeSimWithProgress(args, emit),
+        });
+        setState({ phase: 'running', subscribe: run.onProgress });
+        void (async () => {
+            let simResult;
+            try {
+                simResult = await run.result;
+            }
+            finally {
+                rmSync(specDir, { recursive: true, force: true });
+            }
+            const { result } = simResult;
+            if (cancelled)
+                return;
+            if (result.type === 'error') {
+                setState({ phase: 'error', result });
+                setExitCode?.(result.exitCode);
+            }
+            else {
+                // ADR-0035: the host owns the findings exit. The live renderer hands the
+                // envelope to `setUpSimLiveView` via `onEnvelope`, which calls
+                // `deliverSignals`; the root sets the exit from `envelope.verdict.passed`.
+                // Host-owned persistence (host-owned-run-timing Phase 2): surface the
+                // contribution; the host persists after the live view exits.
+                if (result.type === 'sim-done') {
+                    onSession?.({
+                        tool: 'sim',
+                        cwd: result.cwd,
+                        recipe: result.recipeName,
+                        score: result.envelope.verdict.score,
+                        passed: result.envelope.verdict.passed,
+                        payload: buildSimulationSessionPayload(result.envelope),
+                    });
+                }
+                onEnvelope?.(result.envelope);
+                setState({
+                    phase: 'done',
+                    result: {
+                        envelope: result.envelope,
+                        // duration omitted for summary (host provider supplies); keep if present for other internal use
+                        ...(result.durationMs === undefined ? {} : { durationMs: result.durationMs }),
+                        verboseDetail: result.verboseDetail,
+                    },
+                });
+            }
+            setTimeout(() => exit(), 100);
+        })();
+        return () => {
+            cancelled = true;
+        };
+    }, []);
+    if (state.phase === 'error') {
+        return _jsx(ErrorMessage, { message: state.result.message, suggestion: state.result.suggestion });
+    }
+    const scope = currentScope();
+    const ui = scope?.ui;
+    const walkedUp = scope?.projectContext?.walkedUp;
+    const bannerSize = normalizeBannerSize(ui?.bannerSize);
+    const recipe = args.recipe ?? 'default';
+    const header = args.quiet === true ? null : (_jsx(Static, { items: ['header'], children: () => (_jsxs(React.Fragment, { children: [_jsx(Banner, { size: bannerSize, version: ui?.version, projectPath: args.cwd, walkedUp: walkedUp, update: ui?.update }), bannerSize === 'mini' && ui?.update !== undefined && _jsx(UpdateHint, {}), bannerSize !== 'mini' && _jsx(ProjectHeader, { root: args.cwd, walkedUp: walkedUp }), _jsx(RunHeader, { tool: SIM_TOOL_TITLE, description: SIM_TOOL_DESCRIPTION, metadata: [{ label: 'Recipe', value: recipe }] })] }, "header")) }));
+    if (state.phase === 'loading') {
+        return (_jsxs(_Fragment, { children: [header, _jsx(Box, { paddingTop: 1, children: _jsx(LiveProgress, { surface: SIM_LOADING_SURFACE, subscribe: NO_PROGRESS }) })] }));
+    }
+    if (state.phase === 'running') {
+        return (_jsxs(_Fragment, { children: [header, _jsx(LiveProgress, { surface: SIM_RUNNING_SURFACE, subscribe: state.subscribe })] }));
+    }
+    const { summary } = state.result.envelope.verdict;
+    const { verboseDetail } = state.result;
+    const findingsDetail = verboseDetail?.kind === 'findings' && verboseDetail.groups.length > 0
+        ? verboseDetail
+        : undefined;
+    return (_jsxs(_Fragment, { children: [header, _jsxs(Box, { flexDirection: "column", children: [args.quiet !== true && findingsDetail !== undefined && (_jsx(Box, { children: renderToInk(viewFindingsGroups(findingsDetail.groups)) })), (() => {
+                        const summaryEl = (_jsx(RunSummary, { passed: state.result.envelope.verdict.passed, errors: summary.errors, warnings: summary.warnings }));
+                        return liveContext?.runSession ? (_jsx(RunTimingProvider, { timer: liveContext.runSession.timing, children: summaryEl })) : (summaryEl);
+                    })(), args.quiet !== true && (_jsx(RunFooterHints, { hints: args.verbose === true
+                            ? [
+                                {
+                                    text: 'opensip report for HTML report',
+                                    bold: ['opensip report'],
+                                },
+                            ]
+                            : [
+                                VERBOSE_DETAIL_HINT,
+                                {
+                                    text: 'opensip report for HTML report',
+                                    bold: ['opensip report'],
+                                },
+                            ] }))] })] }));
+}
+/**
+ * Render the live `sim` view. Resolves once the Ink app exits with a
+ * {@link ToolRunCompletion} carrying the run's `envelope` (for root-owned
+ * egress) and `session` contribution (persisted by the HOST after this
+ * resolves — host-owned-run-timing Phase 2; the component no longer writes the
+ * session itself).
+ */
+export async function renderSimLive(args, options, liveContext) {
+    let envelope;
+    let session;
+    const app = render(_jsx(ThemeProvider, { children: _jsx(ClockProvider, { children: _jsx(SimRunner, { args: args, setExitCode: options?.setExitCode, onEnvelope: (e) => {
+                    envelope = e;
+                }, onSession: (c) => {
+                    session = c;
+                }, liveContext: liveContext }) }) }));
+    await app.waitUntilExit();
+    process.stdout.write('\n');
+    // host-owned-run-timing Phase 3: the host persists the returned session
+    // contribution after this live renderer resolves.
+    return { envelope, session };
+}
+//# sourceMappingURL=sim-runner.js.map

package/dist/cli/sim-runner.js.map

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

package/dist/cli/sim-worker.d.ts

@@ -0,0 +1,24 @@
+/**
+ * `sim-run-worker <specPath>` — the headless sim run forked by the live view
+ * (ADR-0028). The live runner forks `node <cliScript> sim-run-worker <spec>`;
+ * because it runs through the full CLI bootstrap, the scenario registry, project,
+ * and config are populated in scope exactly as a normal `sim` run (executeSim's
+ * own `ensureScenariosLoaded` rebuilds the registry), so results are
+ * byte-identical — the reason this is a forked subcommand, not a worker thread.
+ *
+ * It is headless: instead of rendering, it streams pool progress and its final
+ * result over the fork IPC channel (`process.send`) as {@link WorkerMessage}s,
+ * which the parent's subprocess transport relays to the shared `<LiveProgress>`
+ * renderer. Persistence + egress stay on the parent (the engine is
+ * persistence-free; Phase 2). Internal command — the live runner is its only caller.
+ */
+import { type CommandSpec, type ToolCliContext } from '@opensip-cli/core';
+/**
+ * Read the sim-args spec, run `executeSim` headless, and stream progress + the
+ * final result over IPC. Never throws to the caller — a failure is sent as a
+ * `{ kind: 'error' }` message so the parent's `result` promise rejects cleanly.
+ */
+export declare function executeSimWorker(specPath: string): Promise<void>;
+/** `sim-run-worker` — [internal] headless sim run, IPC progress/result. */
+export declare const simRunWorkerCommandSpec: CommandSpec<unknown, ToolCliContext>;
+//# sourceMappingURL=sim-worker.d.ts.map

package/dist/cli/sim-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-worker.d.ts","sourceRoot":"","sources":["../../src/cli/sim-worker.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;GAaG;AAIH,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,cAAc,EAEpB,MAAM,mBAAmB,CAAC;AAgB3B;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBtE;AAED,2EAA2E;AAC3E,eAAO,MAAM,uBAAuB,EAAE,WAAW,CAAC,OAAO,EAAE,cAAc,CAgBvE,CAAC"}

package/dist/cli/sim-worker.js

@@ -0,0 +1,65 @@
+// @fitness-ignore-file detached-promises -- this worker's `send()` helper is synchronous (it calls process.send, which returns immediately); the name-based heuristic mistakes the floating send(...) IPC posts for promise-returning calls. The one genuine async call (executeSim) is awaited.
+/**
+ * `sim-run-worker <specPath>` — the headless sim run forked by the live view
+ * (ADR-0028). The live runner forks `node <cliScript> sim-run-worker <spec>`;
+ * because it runs through the full CLI bootstrap, the scenario registry, project,
+ * and config are populated in scope exactly as a normal `sim` run (executeSim's
+ * own `ensureScenariosLoaded` rebuilds the registry), so results are
+ * byte-identical — the reason this is a forked subcommand, not a worker thread.
+ *
+ * It is headless: instead of rendering, it streams pool progress and its final
+ * result over the fork IPC channel (`process.send`) as {@link WorkerMessage}s,
+ * which the parent's subprocess transport relays to the shared `<LiveProgress>`
+ * renderer. Persistence + egress stay on the parent (the engine is
+ * persistence-free; Phase 2). Internal command — the live runner is its only caller.
+ */
+import { readFileSync } from 'node:fs';
+import { defineCommand, } from '@opensip-cli/core';
+import { executeSim } from './sim.js';
+/** Post one IPC message to the parent (no-op when not forked). */
+function send(msg) {
+    process.send?.(msg);
+}
+/**
+ * Read the sim-args spec, run `executeSim` headless, and stream progress + the
+ * final result over IPC. Never throws to the caller — a failure is sent as a
+ * `{ kind: 'error' }` message so the parent's `result` promise rejects cleanly.
+ */
+export async function executeSimWorker(specPath) {
+    try {
+        const args = JSON.parse(readFileSync(specPath, 'utf8'));
+        send({
+            kind: 'progress',
+            event: { type: 'stage-start', stage: 'scenarios', label: 'Running scenarios...' },
+        });
+        const simResult = await executeSim(args, {
+            onProgress: (completed, total) => send({
+                kind: 'progress',
+                event: { type: 'stage-progress', stage: 'scenarios', completed, total },
+            }),
+        });
+        send({ kind: 'result', value: simResult });
+    }
+    catch (error) {
+        send({
+            kind: 'error',
+            message: error instanceof Error ? error.message : String(error),
+            ...(error instanceof Error && error.stack !== undefined ? { stack: error.stack } : {}),
+        });
+    }
+}
+/** `sim-run-worker` — [internal] headless sim run, IPC progress/result. */
+export const simRunWorkerCommandSpec = defineCommand({
+    name: 'sim-run-worker',
+    description: '[internal] Run sim headless and stream progress + result over IPC (forked by the live view)',
+    commonFlags: [],
+    args: [{ name: 'specPath', description: 'Path to a JSON sim-args spec file' }],
+    scope: 'project',
+    output: 'raw-stream',
+    rawStreamReason: 'worker-ipc',
+    handler: async (rawOpts) => {
+        const specPath = rawOpts._args?.[0] ?? '';
+        await executeSimWorker(specPath);
+    },
+});
+//# sourceMappingURL=sim-worker.js.map

package/dist/cli/sim-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-worker.js","sourceRoot":"","sources":["../../src/cli/sim-worker.ts"],"names":[],"mappings":"AAAA,iSAAiS;AACjS;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,EACL,aAAa,GAId,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAStC,kEAAkE;AAClE,SAAS,IAAI,CAAC,GAAkD;IAC9D,OAAO,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC;AACtB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,QAAgB;IACrD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAkB,CAAC;QACzE,IAAI,CAAC;YACH,IAAI,EAAE,UAAU;YAChB,KAAK,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,sBAAsB,EAAE;SAClF,CAAC,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,UAAU,CAAC,IAAI,EAAE;YACvC,UAAU,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,CAC/B,IAAI,CAAC;gBACH,IAAI,EAAE,UAAU;gBAChB,KAAK,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE;aACxE,CAAC;SACL,CAAC,CAAC;QACH,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC;YACH,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;YAC/D,GAAG,CAAC,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACvF,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,2EAA2E;AAC3E,MAAM,CAAC,MAAM,uBAAuB,GAAyC,aAAa,CAGxF;IACA,IAAI,EAAE,gBAAgB;IACtB,WAAW,EACT,6FAA6F;IAC/F,WAAW,EAAE,EAAE;IACf,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,mCAAmC,EAAE,CAAC;IAC9E,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,YAAY;IACpB,eAAe,EAAE,YAAY;IAC7B,OAAO,EAAE,KAAK,EAAE,OAAO,EAAiB,EAAE;QACxC,MAAM,QAAQ,GAAI,OAAyC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7E,MAAM,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC;CACF,CAAC,CAAC"}

package/dist/cli/sim.d.ts

@@ -0,0 +1,56 @@
+/**
+ * sim command — run simulation scenarios via a named recipe.
+ *
+ * Without `--recipe`, runs the built-in `default` recipe (every
+ * registered scenario, parallel mode). With `--recipe <name>`, looks
+ * the recipe up in the registry and runs it.
+ *
+ * Returns a structured `SimDoneResult` with per-scenario outcomes;
+ * callers (CLI / Tool layer) render or JSON-serialize as appropriate.
+ *
+ * Scenario loading lifecycle (mirrors fitness's `ensureChecksLoaded`):
+ *
+ *   1. .mjs plugin discovery via `loadAllSimPlugins(projectDir)`.
+ *   2. npm package discovery: `@opensip-cli/scenarios-*` packages
+ *      (or anything under `plugins.scenarioPackages` / customer scopes).
+ *   3. No-scenarios guard: `executeSim` fails the run closed with a
+ *      CONFIGURATION_ERROR (exit 2) when zero scenarios would run,
+ *      because a silent green run simulating nothing is the failure mode
+ *      the CLI exists to prevent. (The loader only structured-logs the
+ *      empty registry; the fatal decision is the command's.)
+ */
+import type { ErrorResult, SimDoneResult, ToolOptions } from '@opensip-cli/contracts';
+/**
+ * Plugin load errors recorded during the most recent ensureScenariosLoaded()
+ * call — on `scope.simulation.load` now, NOT a module singleton (audit F1). Read
+ * by the runner to fail the run if a broken plugin silently suppressed its
+ * scenarios while the CLI exits 0.
+ */
+export declare function getPluginLoadErrors(): readonly string[];
+/**
+ * Discover and load every sim plugin and scenario package for the project.
+ * Idempotent per-projectDir, memoized on `scope.simulation.load` (audit F1).
+ */
+export declare function ensureScenariosLoaded(projectDir?: string): Promise<void>;
+/** Options for {@link executeSim}. */
+export interface ExecuteSimOptions {
+    /**
+     * Live-progress callback (ADR-0016). Forwarded to the recipe service, which
+     * fires `(0, total)` at start and a monotonic `(completed, total)` per
+     * scenario. The interactive sim runner maps these to pool ProgressEvents;
+     * non-interactive callers (json / non-TTY) omit it.
+     */
+    readonly onProgress?: (completed: number, total: number) => void;
+}
+/**
+ * Run sim and return a SimDoneResult (or an ErrorResult when the
+ * recipe is missing). The caller decides what to print or render.
+ */
+export declare function executeSim(args: ToolOptions & {
+    readonly verbose?: boolean;
+}, opts?: ExecuteSimOptions): Promise<{
+    result: SimDoneResult;
+} | {
+    result: ErrorResult;
+}>;
+//# sourceMappingURL=sim.d.ts.map

package/dist/cli/sim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim.d.ts","sourceRoot":"","sources":["../../src/cli/sim.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAyBH,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EACb,WAAW,EAGZ,MAAM,wBAAwB,CAAC;AAOhC;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,SAAS,MAAM,EAAE,CAEvD;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiC9E;AAmFD,sCAAsC;AACtC,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAClE;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,WAAW,GAAG;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,EAClD,IAAI,GAAE,iBAAsB,GAC3B,OAAO,CAAC;IAAE,MAAM,EAAE,aAAa,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,CAAC,CA4H9D"}

package/dist/cli/sim.js

@@ -0,0 +1,265 @@
+/**
+ * sim command — run simulation scenarios via a named recipe.
+ *
+ * Without `--recipe`, runs the built-in `default` recipe (every
+ * registered scenario, parallel mode). With `--recipe <name>`, looks
+ * the recipe up in the registry and runs it.
+ *
+ * Returns a structured `SimDoneResult` with per-scenario outcomes;
+ * callers (CLI / Tool layer) render or JSON-serialize as appropriate.
+ *
+ * Scenario loading lifecycle (mirrors fitness's `ensureChecksLoaded`):
+ *
+ *   1. .mjs plugin discovery via `loadAllSimPlugins(projectDir)`.
+ *   2. npm package discovery: `@opensip-cli/scenarios-*` packages
+ *      (or anything under `plugins.scenarioPackages` / customer scopes).
+ *   3. No-scenarios guard: `executeSim` fails the run closed with a
+ *      CONFIGURATION_ERROR (exit 2) when zero scenarios would run,
+ *      because a silent green run simulating nothing is the failure mode
+ *      the CLI exists to prevent. (The loader only structured-logs the
+ *      empty registry; the fatal decision is the command's.)
+ */
+import { BUILTIN_DEFAULT_RECIPE, buildFindingGroups, buildSignalEnvelope, EXIT_CODES, } from '@opensip-cli/contracts';
+import { currentScope, loadCapabilityDomain, logger, resolveScopes, resolveVerdictPolicy, } from '@opensip-cli/core';
+import { currentScenarioRegistry, currentSimulationLoadState } from '../framework/registry.js';
+import { loadAllSimPlugins } from '../plugins/loader.js';
+import { readScenarioPackagePreferences } from '../plugins/scenario-package-discovery.js';
+import { currentSimulationRecipeRegistry } from '../recipes/registry.js';
+import { SimulationRecipeService } from '../recipes/service.js';
+import { resolveSimRecipeSelection } from './sim-config.js';
+// ---------------------------------------------------------------------------
+// Lazy-load simulation scenarios
+// ---------------------------------------------------------------------------
+/**
+ * Plugin load errors recorded during the most recent ensureScenariosLoaded()
+ * call — on `scope.simulation.load` now, NOT a module singleton (audit F1). Read
+ * by the runner to fail the run if a broken plugin silently suppressed its
+ * scenarios while the CLI exits 0.
+ */
+export function getPluginLoadErrors() {
+    return currentSimulationLoadState().pluginLoadErrors;
+}
+/**
+ * Discover and load every sim plugin and scenario package for the project.
+ * Idempotent per-projectDir, memoized on `scope.simulation.load` (audit F1).
+ */
+export async function ensureScenariosLoaded(projectDir) {
+    const key = projectDir ?? '';
+    const load = currentSimulationLoadState();
+    if (load.loadedFor === key)
+        return;
+    // 1. Load .mjs sim plugins — project-local scenarios/recipes + plugins.sim
+    //    packages. Scenarios self-register on import; recipes via the loader.
+    const pluginResult = await loadAllSimPlugins(projectDir);
+    load.pluginLoadErrors = pluginResult.errors;
+    for (const err of pluginResult.errors) {
+        process.stderr.write(`opensip: plugin failed to load — ${err}\n`);
+        logger.warn({ evt: 'cli.plugin.warning', module: 'cli:sim', message: err });
+    }
+    // 2. Scenario packages (+ co-located recipes → the sim-recipe domain) through
+    //    the GENERIC capability substrate (§5.3): name-pattern `<scope>/scenarios-*`
+    //    discovery, the documented plugins.{scenarioPackages,autoDiscoverScenarios,
+    //    packageScopes} keys, and the single-core guard all live in core now — sim
+    //    no longer carries a bespoke loader. Memoized per (domain, project) on the
+    //    scope capability registry, so the CLI pre-action hook and this don't
+    //    double-load.
+    await loadSimScenarioPackages(projectDir ?? '');
+    // 3. No-scenarios guard (structured-log only; executeSim owns the fatal exit).
+    if (currentScenarioRegistry().size === 0) {
+        logger.warn({
+            evt: 'cli.scenario_packages.empty',
+            module: 'cli:sim',
+            msg: 'no scenarios loaded',
+        });
+    }
+    load.loadedFor = key;
+}
+/**
+ * Drive the generic capability loader for the `sim-pack` domain. A no-op when the
+ * run carries no capability registry (a programmatic sim use that never wired the
+ * host capability plane), the domain is unregistered, or no projectDir. Scopes are
+ * merged (default `@opensip-cli` ∪ customer `packageScopes`) here so name-pattern
+ * discovery matches the prior `resolveScopes` behavior. No `@opensip-cli/config` dep.
+ */
+async function loadSimScenarioPackages(projectDir) {
+    if (projectDir === '')
+        return;
+    const registry = currentScope()?.capabilities;
+    if (!registry?.hasDomain('sim-pack') || registry.isDomainLoaded('sim-pack', projectDir))
+        return;
+    const prefs = readScenarioPackagePreferences(projectDir);
+    const scopes = resolveScopes('@opensip-cli', prefs.packageScopes ?? [], 'plugin.scenario_package.invalid_scope');
+    const preferences = {
+        ...(prefs.scenarioPackages === undefined ? {} : { packages: prefs.scenarioPackages }),
+        ...(prefs.autoDiscoverScenarios === undefined
+            ? {}
+            : { autoDiscover: prefs.autoDiscoverScenarios }),
+        scopes,
+    };
+    await loadCapabilityDomain({ registry, domainId: 'sim-pack', projectDir, preferences });
+}
+/**
+ * A scenario passes the verdict when it emitted no `critical`/`high` signals
+ * AND its own pass/fail verdict held (assertions passed, no thrown error).
+ * Mirrors {@link buildSignalEnvelope}'s "no critical/high ⇒ passed" rule and
+ * folds in the scenario's assertion verdict (a scenario can fail assertions
+ * without emitting a critical/high signal).
+ */
+function scenarioPassed(scenario, signals) {
+    const hasErrorSignal = signals.some((s) => s.severity === 'critical' || s.severity === 'high');
+    return scenario.passed && !hasErrorSignal;
+}
+/**
+ * Collapse the recipe's per-scenario results into the envelope's two
+ * orthogonal carriers (ADR-0011):
+ *
+ *   - `signals`: the flat run-wide `Signal[]`. Each scenario's signals are
+ *     remapped to `source: <scenarioId>` so the shared table formatter
+ *     (which groups by `signal.source`) attributes them to the right unit
+ *     row even if a scenario authored a divergent `source`.
+ *   - `units`: one {@link UnitResult} per scenario (`slug: scenarioId`,
+ *     `passed`, `durationMs`, `error?`) — the per-unit ran/errored/timing
+ *     facts a flat signal list cannot express.
+ *
+ * `SimulationMetrics` (load p50/p95/p99) stays a tool-specific artifact on the
+ * per-kind `result` and is NOT lifted into the envelope's core shape.
+ */
+function assembleEnvelopeInputs(scenarios) {
+    const units = [];
+    const signals = [];
+    for (const scenario of scenarios) {
+        const scenarioSignals = scenario.result?.signals ?? [];
+        // Remap source → scenarioId so per-scenario grouping is exact (the
+        // unit slug IS the scenarioId, per the migrated-tool contract).
+        for (const signal of scenarioSignals) {
+            signals.push(signal.source === scenario.scenarioId ? signal : { ...signal, source: scenario.scenarioId });
+        }
+        units.push({
+            slug: scenario.scenarioId,
+            passed: scenarioPassed(scenario, scenarioSignals),
+            durationMs: scenario.durationMs,
+            ...(scenario.error === undefined ? {} : { error: scenario.error }),
+        });
+    }
+    return { units, signals };
+}
+/**
+ * Run sim and return a SimDoneResult (or an ErrorResult when the
+ * recipe is missing). The caller decides what to print or render.
+ */
+export async function executeSim(args, opts = {}) {
+    // Lifecycle: load .mjs plugins + scenario packages before the recipe
+    // registry is read. Idempotent per project dir.
+    await ensureScenariosLoaded(args.cwd);
+    // Tool-scoped recipe resolution (ADR-0022): explicit --recipe >
+    // simulation.recipe > built-in default. A config-sourced unknown name
+    // tolerantly falls back to `default`; an explicit --recipe typo hard-fails.
+    const recipeSelection = resolveSimRecipeSelection(args.cwd, args.recipe);
+    let recipeName = recipeSelection.name;
+    let recipe = currentSimulationRecipeRegistry().loadRecipe(recipeName);
+    if (!recipe && recipeSelection.tolerant && recipeName !== BUILTIN_DEFAULT_RECIPE) {
+        logger.warn({
+            evt: 'sim.recipe.unknown_config_default',
+            module: 'cli:sim',
+            requested: recipeName,
+            fallback: BUILTIN_DEFAULT_RECIPE,
+            msg: `Configured sim recipe '${recipeName}' not found; using '${BUILTIN_DEFAULT_RECIPE}'. If '${recipeName}' is a recipe for another tool, move it under that tool's <tool>.recipe key (ADR-0022).`,
+        });
+        recipeName = BUILTIN_DEFAULT_RECIPE;
+        recipe = currentSimulationRecipeRegistry().loadRecipe(recipeName);
+    }
+    if (!recipe) {
+        return {
+            result: {
+                type: 'error',
+                message: `Unknown sim recipe '${recipeName}'.`,
+                suggestion: 'Run `opensip sim --recipes` to see available recipes.',
+                exitCode: EXIT_CODES.CONFIGURATION_ERROR,
+            },
+        };
+    }
+    const service = new SimulationRecipeService({ cwd: args.cwd, onProgress: opts.onProgress });
+    const recipeResult = await service.runRecipe(recipe);
+    const scenarios = recipeResult.scenarios;
+    // Fail closed on an empty run. Zero executed scenarios — whether because
+    // no scenario packages were loaded at all, or because the recipe selector
+    // matched none of the registered scenarios — must NOT report as a pass
+    // (exit 0). A green run that simulated nothing is the exact failure mode
+    // that masks a misconfig or missing dependency in CI. It is a
+    // configuration/unavailable condition (exit 2), distinct from an actual
+    // scenario failure (exit 1). Tailor the guidance to the cause.
+    if (scenarios.length === 0) {
+        const registryEmpty = currentScenarioRegistry().size === 0;
+        logger.warn({
+            evt: 'cli.sim.empty_run',
+            module: 'cli:sim',
+            recipeName,
+            registryEmpty,
+        });
+        return {
+            result: {
+                type: 'error',
+                message: registryEmpty
+                    ? 'No scenarios were loaded — nothing to simulate.'
+                    : `Recipe '${recipeName}' selected zero scenarios — nothing to simulate.`,
+                suggestion: registryEmpty
+                    ? 'Install at least one @opensip-cli/scenarios-* package, declare plugins.scenarioPackages in opensip-cli.config.yml, or run `opensip init` to scaffold example scenarios.'
+                    : 'Check the recipe selector — at least one registered scenario must match.',
+                exitCode: EXIT_CODES.CONFIGURATION_ERROR,
+            },
+        };
+    }
+    const passed = scenarios.filter((s) => s.passed).length;
+    const failed = scenarios.length - passed;
+    logger.info({
+        evt: 'cli.sim.complete',
+        module: 'cli:sim',
+        recipeName,
+        passed,
+        failed,
+        durationMs: recipeResult.durationMs,
+    });
+    // ADR-0011: surface every scenario's Signal[] into the one run envelope.
+    // `runId`/`createdAt` come off the live scope so cloud egress correlates
+    // with the same run id the logger stamps; `currentScope()` is bound for the
+    // whole dynamic extent of the action body (enterScope in the pre-action hook).
+    const { units, signals } = assembleEnvelopeInputs(scenarios);
+    const envelope = buildSignalEnvelope({
+        tool: 'sim',
+        recipe: recipeName,
+        runId: currentScope()?.runId ?? '',
+        createdAt: new Date().toISOString(),
+        units,
+        signals,
+        // ADR-0035: sim declares no failOn* keys, so it inherits the host fallback
+        // {1,0}. With Phase 0 (a failed scenario emits an error signal), this
+        // reproduces sim's historical `failed > 0` exit exactly. Scenario throws land
+        // in UnitResult.error (a unit fault), so runFaulted stays false here.
+        policy: resolveVerdictPolicy('simulation'),
+        runFaulted: false,
+    });
+    // ADR-0021: on --verbose, carry the per-scenario detail body so the shared
+    // resultToView seam renders it identically in a TTY and a pipe. Reuses the
+    // shared contracts mapping (sim scenario ids are the unit slugs; identity
+    // display name).
+    const verboseDetail = args.verbose === true
+        ? { kind: 'findings', groups: buildFindingGroups(units, signals) }
+        : undefined;
+    const result = {
+        type: 'sim-done',
+        recipeName,
+        cwd: args.cwd,
+        // durationMs optional on SimDoneResult (phase2 host timing); internal recipe makespan may be present.
+        ...(recipeResult.durationMs === undefined ? {} : { durationMs: recipeResult.durationMs }),
+        // ADR-0035: the run verdict is the single host verdict. With Phase 0 a failed
+        // scenario emits an error signal, so `envelope.verdict.passed` (with the {1,0}
+        // policy) is exactly the old `failed > 0`; the host derives the exit from it.
+        envelope,
+        ...(verboseDetail === undefined ? {} : { verboseDetail }),
+    };
+    // Persistence is host-owned (host-owned-run-timing Phase 3): the engine returns
+    // only the result; the sim handler RETURNS a ToolSessionContribution and the
+    // host run plane writes the generic session row. No tool-side persist helper.
+    return { result };
+}
+//# sourceMappingURL=sim.js.map

package/dist/cli/sim.js.map

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

package/dist/framework/__tests__/assertions.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=assertions.test.d.ts.map

package/dist/framework/__tests__/assertions.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertions.test.d.ts","sourceRoot":"","sources":["../../../src/framework/__tests__/assertions.test.ts"],"names":[],"mappings":""}