@opensip-cli/simulation 0.1.0

package/dist/cli/__tests__/sim-worker.test.js

@@ -0,0 +1,69 @@
+/**
+ * `sim-run-worker` — the headless sim run forked by the live view
+ * (`executeSimWorker`, ADR-0028). It reads a serializable sim-args spec, runs
+ * `executeSim` headless, streams pool progress over the fork IPC channel
+ * (`process.send`), and posts the final result. A bad spec is reported as a
+ * `{ kind: 'error' }` message, not a throw.
+ *
+ * The test stubs `process.send` (the process is not actually forked under vitest)
+ * and registers a scenario so the default recipe has work to run.
+ */
+import { mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { enterScope } from '@opensip-cli/core';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { noopTarget } from '../../__tests__/test-utils/targets.js';
+import { makeSimTestScope } from '../../__tests__/test-utils/with-sim-scope.js';
+import { ASSERTIONS } from '../../framework/assertions.js';
+import { clearScenarioRegistry, currentScenarioRegistry } from '../../framework/registry.js';
+import { defineLoadScenario } from '../../kinds/load/define.js';
+import { executeSimWorker } from '../sim-worker.js';
+let dir;
+let messages;
+beforeEach(() => {
+    enterScope(makeSimTestScope());
+    dir = mkdtempSync(join(tmpdir(), 'sim-worker-test-'));
+    messages = [];
+    // The worker posts via process.send (a no-op when not forked); stub it to capture.
+    // process.send is undefined under vitest, so deleting it in afterEach restores state.
+    process.send = vi.fn((m) => {
+        messages.push(m);
+        return true;
+    });
+});
+afterEach(() => {
+    clearScenarioRegistry();
+    delete process.send;
+    rmSync(dir, { recursive: true, force: true });
+});
+describe('executeSimWorker', () => {
+    it('runs the sim and posts progress + a result over IPC', async () => {
+        currentScenarioRegistry().register(defineLoadScenario({
+            id: 'worker-probe',
+            name: 'worker-probe',
+            description: 'worker-probe',
+            tags: [],
+            target: noopTarget,
+            workload: { rps: 1 },
+            duration: 1,
+            assertions: [ASSERTIONS.lowErrorRate(1)],
+        }));
+        const specPath = join(dir, 'spec.json');
+        writeFileSync(specPath, JSON.stringify({ json: false, cwd: dir, debug: false }), 'utf8');
+        await executeSimWorker(specPath);
+        expect(messages.some((m) => m.kind === 'progress')).toBe(true);
+        const result = messages.find((m) => m.kind === 'result');
+        expect(result?.kind).toBe('result');
+        if (result?.kind !== 'result')
+            throw new Error('no result message');
+        expect(result.value.result.type).toBe('sim-done');
+    });
+    it('reports a bad spec path as an error message, not a throw', async () => {
+        await expect(executeSimWorker(join(dir, 'missing.json'))).resolves.toBeUndefined();
+        const err = messages.find((m) => m.kind === 'error');
+        expect(err?.kind).toBe('error');
+        expect(messages.some((m) => m.kind === 'result')).toBe(false);
+    });
+});
+//# sourceMappingURL=sim-worker.test.js.map

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

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

package/dist/cli/__tests__/sim.test.d.ts

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

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

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

package/dist/cli/__tests__/sim.test.js

@@ -0,0 +1,232 @@
+import { createSignal, enterScope, generatePrefixedId } from '@opensip-cli/core';
+import { DataStoreFactory } from '@opensip-cli/datastore';
+import { SessionRepo } from '@opensip-cli/session-store';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { noopTarget } from '../../__tests__/test-utils/targets.js';
+import { makeSimTestScope } from '../../__tests__/test-utils/with-sim-scope.js';
+import { ASSERTIONS } from '../../framework/assertions.js';
+import { clearScenarioRegistry, currentScenarioRegistry } from '../../framework/registry.js';
+import { defineLoadScenario } from '../../kinds/load/define.js';
+import { buildSimulationSessionPayload } from '../../persistence/session-payload.js';
+import { executeSim } from '../sim.js';
+const args = (overrides = {}) => ({
+    json: false,
+    cwd: process.cwd(),
+    debug: false,
+    ...overrides,
+});
+/** A passing load-kind executor result carrying one signal — lets a test
+ *  exercise the envelope assembler's source-remap + critical-signal verdict
+ *  folding without running the real load loop. */
+const loadResultWithSignal = (scenarioId, source, severity, message) => ({
+    kind: 'load',
+    scenarioId,
+    passed: true,
+    durationMs: 0,
+    outcome: {
+        metrics: {
+            totalRequests: 0,
+            successfulRequests: 0,
+            failedRequests: 0,
+            avgLatencyMs: 0,
+            p50LatencyMs: 0,
+            p95LatencyMs: 0,
+            p99LatencyMs: 0,
+            errorsGenerated: 0,
+        },
+        assertions: { passed: [], failed: [] },
+    },
+    signals: [createSignal({ source, severity, ruleId: 'sim.test', message })],
+});
+beforeEach(() => {
+    // Item 1: registries are per-RunScope. Enter a fresh scope per test.
+    enterScope(makeSimTestScope());
+});
+afterEach(() => {
+    clearScenarioRegistry();
+});
+describe('executeSim', () => {
+    it('returns ErrorResult when the recipe name is unknown', async () => {
+        const { result } = await executeSim(args({ recipe: 'does-not-exist' }));
+        expect(result.type).toBe('error');
+        if (result.type === 'error') {
+            expect(result.message).toContain('does-not-exist');
+            expect(result.exitCode).toBe(2);
+        }
+    });
+    it('runs the built-in default recipe when no --recipe is passed', async () => {
+        // Register a scenario so the default recipe has something to run — an
+        // empty selection now fails closed (see the zero-scenario guard tests
+        // below), so this test must supply work to exercise the happy path.
+        currentScenarioRegistry().register(defineLoadScenario({
+            id: 'default-probe',
+            name: 'default-probe',
+            description: 'default-probe',
+            tags: [],
+            target: noopTarget,
+            workload: { rps: 1 },
+            duration: 1,
+            assertions: [ASSERTIONS.lowErrorRate(1)],
+        }));
+        const { result } = await executeSim(args());
+        expect(result.type).toBe('sim-done');
+        if (result.type === 'sim-done') {
+            expect(result.recipeName).toBe('default');
+        }
+    });
+    it('returns SimDoneResult with per-scenario outcomes', async () => {
+        currentScenarioRegistry().register(defineLoadScenario({
+            id: 'load-a',
+            name: 'load-a',
+            description: 'load a',
+            tags: ['demo'],
+            target: noopTarget,
+            workload: { rps: 1 },
+            duration: 1,
+            assertions: [ASSERTIONS.lowErrorRate(1)],
+        }));
+        const { result } = await executeSim(args());
+        expect(result.type).toBe('sim-done');
+        if (result.type === 'sim-done') {
+            // ADR-0011: per-scenario facts live on the envelope's `units` sidecar
+            // (one unit per scenario, slug === scenarioId).
+            expect(result.envelope.units).toHaveLength(1);
+            expect(result.envelope.units[0]?.slug).toBe('load-a');
+        }
+    });
+    it('marks the run verdict failed when at least one scenario fails (ADR-0035)', async () => {
+        // A bare RunnableScenario whose run() rejects to force a failure
+        currentScenarioRegistry().register({
+            id: 'crashes',
+            name: 'crashes',
+            description: 'crashes',
+            kind: 'load',
+            tags: [],
+            run: () => Promise.reject(new Error('boom')),
+        });
+        const { result } = await executeSim(args());
+        expect(result.type).toBe('sim-done');
+        if (result.type === 'sim-done') {
+            expect(result.envelope.verdict.summary.failed).toBe(1);
+            // ADR-0035: the single host verdict drives the exit (no `shouldFail` field).
+            // A crashed scenario carries a unit error → the run verdict fails.
+            expect(result.envelope.verdict.passed).toBe(false);
+        }
+    });
+    it('fails closed (exit 2) when the scenario registry is empty (audit P1c)', async () => {
+        // "Empty work is not success": with no scenarios registered at all, a run
+        // simulated nothing. That must be a configuration/unavailable error (exit
+        // 2), never a green sim-done pass that masks a misconfig/missing-dep.
+        const { result } = await executeSim(args());
+        expect(result.type).toBe('error');
+        if (result.type === 'error') {
+            expect(result.exitCode).toBe(2);
+            // Registry-empty cause → install/scaffold guidance.
+            expect(result.message).toContain('No scenarios were loaded');
+            expect(result.suggestion).toContain('init');
+        }
+    });
+    it('preserves error messages on failed scenarios', async () => {
+        currentScenarioRegistry().register({
+            id: 'msg',
+            name: 'msg',
+            description: 'msg',
+            kind: 'load',
+            tags: [],
+            run: () => Promise.reject(new Error('a-specific-message')),
+        });
+        const { result } = await executeSim(args());
+        if (result.type === 'sim-done') {
+            // The scenario's thrown error is carried on its unit (slug === scenarioId).
+            expect(result.envelope.units[0]?.error).toContain('a-specific-message');
+        }
+    });
+    it('remaps each scenario signal to source = scenarioId in the run envelope', async () => {
+        // A scenario whose result emits a signal with a DIVERGENT `source`; the
+        // envelope assembler must re-attribute it to the scenarioId so the shared
+        // grouped table credits the right unit row (ADR-0011).
+        currentScenarioRegistry().register({
+            id: 'sig-scenario',
+            name: 'sig-scenario',
+            description: 'emits a signal',
+            kind: 'load',
+            tags: [],
+            run: () => Promise.resolve(loadResultWithSignal('sig-scenario', 'some-other-source', 'low', 'fyi')),
+        });
+        const { result } = await executeSim(args());
+        expect(result.type).toBe('sim-done');
+        if (result.type === 'sim-done') {
+            const sig = result.envelope.signals.find((s) => s.message === 'fyi');
+            expect(sig?.source).toBe('sig-scenario');
+        }
+    });
+    it('fails the unit verdict when a scenario emits a critical signal even though it passed', async () => {
+        // scenarioPassed folds the no-critical/high rule into the unit verdict: a
+        // scenario can report passed:true yet still fail because it surfaced a
+        // critical signal.
+        currentScenarioRegistry().register({
+            id: 'crit-scenario',
+            name: 'crit-scenario',
+            description: 'passes but emits a critical signal',
+            kind: 'load',
+            tags: [],
+            run: () => Promise.resolve(loadResultWithSignal('crit-scenario', 'crit-scenario', 'critical', 'meltdown')),
+        });
+        const { result } = await executeSim(args());
+        expect(result.type).toBe('sim-done');
+        if (result.type === 'sim-done') {
+            const unit = result.envelope.units.find((u) => u.slug === 'crit-scenario');
+            // passed:true from the executor, but the critical signal flips the unit.
+            expect(unit?.passed).toBe(false);
+        }
+    });
+});
+/** Run a minimal sim and return its SimDoneResult — the caller persists it.
+ *  Hoisted to module scope (called inside the per-test scope from beforeEach). */
+async function simDone() {
+    currentScenarioRegistry().register(defineLoadScenario({
+        id: 'persist-probe',
+        name: 'persist-probe',
+        description: 'persist-probe',
+        tags: [],
+        target: noopTarget,
+        workload: { rps: 1 },
+        duration: 1,
+        assertions: [ASSERTIONS.lowErrorRate(1)],
+    }));
+    const { result } = await executeSim(args());
+    if (result.type !== 'sim-done')
+        throw new Error(`expected sim-done, got ${result.type}`);
+    return result;
+}
+describe('sim session contribution → SessionRepo', () => {
+    it('a sim contribution persisted via SessionRepo writes exactly one row', async () => {
+        // host-owned-run-timing Phase 3 removed the production `persistSimSession`
+        // helper — the host run plane owns persistence. This test-only write mirrors
+        // the row the host writes from the sim handler's returned ToolSessionContribution.
+        // (Best-effort persistence semantics are covered by the run-plane tests.)
+        const ds = DataStoreFactory.open({ backend: 'memory' });
+        try {
+            const result = await simDone();
+            new SessionRepo(ds).save({
+                id: generatePrefixedId('sim'),
+                tool: 'sim',
+                startedAt: '1970-01-01T00:00:00.000Z',
+                completedAt: '1970-01-01T00:00:00.000Z',
+                cwd: result.cwd,
+                recipe: result.recipeName,
+                score: result.envelope.verdict.score,
+                passed: result.envelope.verdict.passed,
+                durationMs: 0,
+                payload: buildSimulationSessionPayload(result.envelope),
+            });
+            const sessions = new SessionRepo(ds).list({ tool: 'sim' });
+            expect(sessions).toHaveLength(1);
+            expect(sessions[0]?.recipe).toBe('default');
+        }
+        finally {
+            ds.close?.();
+        }
+    });
+});
+//# sourceMappingURL=sim.test.js.map

package/dist/cli/__tests__/sim.test.js.map

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

package/dist/cli/sim-config-schema.d.ts

@@ -0,0 +1,30 @@
+/**
+ * sim-config-schema — the simulation tool's namespaced Zod config schema
+ * (launch, ADR-0023, Phase 4 Task 4.2).
+ *
+ * Describes the `simulation:` top-level block of `opensip-cli.config.yml`.
+ * Today simulation owns a single knob — the tool-scoped `recipe` default
+ * (ADR-0022) — so the schema is minimal; it grows as sim gains config.
+ *
+ * This is the schema simulation contributes to the host's composed
+ * whole-document validation. The matching namespace KEY in the config file is
+ * `simulation` (see `sim-config.ts`'s `readSimulationRecipe`), so a typo like
+ * `simulation: { recpe: ... }` now fails strict at dispatch (ADR-0023).
+ */
+import { z } from 'zod';
+import type { ToolConfigDeclaration } from '@opensip-cli/config';
+/**
+ * Zod object for the `simulation:` namespace. The `recipe` field is optional;
+ * an absent block means sim falls back to the built-in `default` recipe.
+ */
+export declare const SimulationNamespaceSchema: z.ZodObject<{
+    recipe: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * The simulation tool's contribution to the composed configuration document.
+ * `namespace: 'simulation'` (matches the config file key); the composer makes
+ * it strict (typo-rejecting) and optional. No defaults — the recipe falls back
+ * through the shared `resolveToolRecipeName` precedence when absent.
+ */
+export declare const simulationConfigDeclaration: ToolConfigDeclaration;
+//# sourceMappingURL=sim-config-schema.d.ts.map

package/dist/cli/sim-config-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-config-schema.d.ts","sourceRoot":"","sources":["../../src/cli/sim-config-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjE;;;GAGG;AACH,eAAO,MAAM,yBAAyB;;iBAGpC,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,EAAE,qBAGzC,CAAC"}

package/dist/cli/sim-config-schema.js

@@ -0,0 +1,33 @@
+/**
+ * sim-config-schema — the simulation tool's namespaced Zod config schema
+ * (launch, ADR-0023, Phase 4 Task 4.2).
+ *
+ * Describes the `simulation:` top-level block of `opensip-cli.config.yml`.
+ * Today simulation owns a single knob — the tool-scoped `recipe` default
+ * (ADR-0022) — so the schema is minimal; it grows as sim gains config.
+ *
+ * This is the schema simulation contributes to the host's composed
+ * whole-document validation. The matching namespace KEY in the config file is
+ * `simulation` (see `sim-config.ts`'s `readSimulationRecipe`), so a typo like
+ * `simulation: { recpe: ... }` now fails strict at dispatch (ADR-0023).
+ */
+import { z } from 'zod';
+/**
+ * Zod object for the `simulation:` namespace. The `recipe` field is optional;
+ * an absent block means sim falls back to the built-in `default` recipe.
+ */
+export const SimulationNamespaceSchema = z.object({
+    /** Tool-scoped default recipe for `sim` runs (ADR-0022). */
+    recipe: z.string().min(1).max(128).optional(),
+});
+/**
+ * The simulation tool's contribution to the composed configuration document.
+ * `namespace: 'simulation'` (matches the config file key); the composer makes
+ * it strict (typo-rejecting) and optional. No defaults — the recipe falls back
+ * through the shared `resolveToolRecipeName` precedence when absent.
+ */
+export const simulationConfigDeclaration = {
+    namespace: 'simulation',
+    schema: SimulationNamespaceSchema,
+};
+//# sourceMappingURL=sim-config-schema.js.map

package/dist/cli/sim-config-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-config-schema.js","sourceRoot":"","sources":["../../src/cli/sim-config-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,4DAA4D;IAC5D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;CAC9C,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAA0B;IAChE,SAAS,EAAE,YAAY;IACvB,MAAM,EAAE,yBAAyB;CAClC,CAAC"}

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

@@ -0,0 +1,22 @@
+/**
+ * sim-config — resolve the `sim` recipe default (ADR-0022).
+ *
+ * Recipes are tool-scoped: `sim` reads its own `simulation.recipe` block from
+ * `opensip-cli.config.yml`. The `simulation:` block is read permissively here
+ * (mirroring graph's `graph-config.ts`) — simulation must not depend on fitness,
+ * which owns the strict Zod config schema, so it parses its own slice of the
+ * document.
+ */
+import { type ResolvedRecipe } from '@opensip-cli/contracts';
+/**
+ * Resolve which recipe NAME a `sim` run should use, applying tool-scoped
+ * precedence (ADR-0022): explicit `--recipe` > `simulation.recipe` > built-in
+ * `default`. The caller looks up the returned `name` in the recipe registry and,
+ * when `tolerant`, falls back to `default` on a miss.
+ *
+ * @param cwd Project root for config resolution.
+ * @param explicit The `--recipe <name>` flag value (undefined when absent).
+ * @param explicitPath Optional `--config <path>` override.
+ */
+export declare function resolveSimRecipeSelection(cwd: string, explicit: string | undefined, explicitPath?: string): ResolvedRecipe;
+//# sourceMappingURL=sim-config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-config.d.ts","sourceRoot":"","sources":["../../src/cli/sim-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAyB,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AA+CpF;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,YAAY,CAAC,EAAE,MAAM,GACpB,cAAc,CAMhB"}

package/dist/cli/sim-config.js

@@ -0,0 +1,73 @@
+/**
+ * sim-config — resolve the `sim` recipe default (ADR-0022).
+ *
+ * Recipes are tool-scoped: `sim` reads its own `simulation.recipe` block from
+ * `opensip-cli.config.yml`. The `simulation:` block is read permissively here
+ * (mirroring graph's `graph-config.ts`) — simulation must not depend on fitness,
+ * which owns the strict Zod config schema, so it parses its own slice of the
+ * document.
+ */
+import { resolveToolRecipeName } from '@opensip-cli/contracts';
+import { currentScope, logger, readYamlFile, resolveProjectConfigPath } from '@opensip-cli/core';
+/** Accept anything that looks like a plain object; everything else → undefined. */
+function isPlainObject(v) {
+    return typeof v === 'object' && v !== null && !Array.isArray(v);
+}
+/**
+ * Best-effort read of `simulation.recipe` from the project config.
+ *
+ * ADR-0023, Phase 4: the resolved `simulation:` block rides on the per-run scope
+ * (`scope.toolConfig.simulation`) — the host already strict-validated +
+ * precedence-resolved the whole document before dispatch. When a scope is
+ * present (every CLI dispatch path) this reads the SCOPE value and does NOT
+ * re-read YAML. The YAML read below is the fallback for a caller with no scope
+ * (a direct unit-test call); there it stays best-effort: a missing config,
+ * malformed YAML, or no `simulation.recipe` string yields `undefined`.
+ */
+function readSimulationRecipe(cwd, explicitPath) {
+    // Scope-first: the resolved, strict-validated `simulation:` block.
+    const scoped = currentScope()?.toolConfig?.simulation;
+    if (isPlainObject(scoped)) {
+        return typeof scoped.recipe === 'string' ? scoped.recipe : undefined;
+    }
+    let filePath;
+    try {
+        filePath = resolveProjectConfigPath(cwd, explicitPath);
+    }
+    catch (error) {
+        // No config file found — expected on a config-less project; sim then uses
+        // the built-in default. Debug-only so it never adds noise. Mirrors
+        // loadGraphConfig's not-found path.
+        logger.debug({
+            evt: 'sim.config.not_found',
+            module: 'cli:sim',
+            err: error instanceof Error ? error.message : String(error),
+        });
+        return undefined;
+    }
+    const doc = readYamlFile(filePath);
+    if (!isPlainObject(doc))
+        return undefined;
+    const block = doc.simulation;
+    if (!isPlainObject(block))
+        return undefined;
+    return typeof block.recipe === 'string' ? block.recipe : undefined;
+}
+/**
+ * Resolve which recipe NAME a `sim` run should use, applying tool-scoped
+ * precedence (ADR-0022): explicit `--recipe` > `simulation.recipe` > built-in
+ * `default`. The caller looks up the returned `name` in the recipe registry and,
+ * when `tolerant`, falls back to `default` on a miss.
+ *
+ * @param cwd Project root for config resolution.
+ * @param explicit The `--recipe <name>` flag value (undefined when absent).
+ * @param explicitPath Optional `--config <path>` override.
+ */
+export function resolveSimRecipeSelection(cwd, explicit, explicitPath) {
+    const toolRecipe = readSimulationRecipe(cwd, explicitPath);
+    return resolveToolRecipeName({
+        explicit,
+        toolRecipe,
+    });
+}
+//# sourceMappingURL=sim-config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-config.js","sourceRoot":"","sources":["../../src/cli/sim-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,qBAAqB,EAAuB,MAAM,wBAAwB,CAAC;AACpF,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAEjG,mFAAmF;AACnF,SAAS,aAAa,CAAC,CAAU;IAC/B,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAS,oBAAoB,CAAC,GAAW,EAAE,YAAqB;IAC9D,mEAAmE;IACnE,MAAM,MAAM,GAAG,YAAY,EAAE,EAAE,UAAU,EAAE,UAAU,CAAC;IACtD,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,OAAO,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IACvE,CAAC;IAED,IAAI,QAAgB,CAAC;IACrB,IAAI,CAAC;QACH,QAAQ,GAAG,wBAAwB,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IACzD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,0EAA0E;QAC1E,mEAAmE;QACnE,oCAAoC;QACpC,MAAM,CAAC,KAAK,CAAC;YACX,GAAG,EAAE,sBAAsB;YAC3B,MAAM,EAAE,SAAS;YACjB,GAAG,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC5D,CAAC,CAAC;QACH,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1C,MAAM,KAAK,GAAG,GAAG,CAAC,UAAU,CAAC;IAC7B,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5C,OAAO,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AACrE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,yBAAyB,CACvC,GAAW,EACX,QAA4B,EAC5B,YAAqB;IAErB,MAAM,UAAU,GAAG,oBAAoB,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAC3D,OAAO,qBAAqB,CAAC;QAC3B,QAAQ;QACR,UAAU;KACX,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,60 @@
+/**
+ * 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 { type SignalEnvelope, type ToolOptions } from '@opensip-cli/contracts';
+import { type LiveViewContext, type ToolRunCompletion, type ToolSessionContribution } from '@opensip-cli/core';
+import React from 'react';
+/** The sim subcommand's parsed options. `quiet`/`open` are not on the base
+ *  ToolOptions (they're added by the command's `.option(...)` flags), so the
+ *  live view widens the type to read `quiet`. */
+type SimLiveArgs = ToolOptions & {
+    readonly quiet?: boolean;
+    readonly verbose?: boolean;
+};
+/** Props for {@link SimRunner}. Exported so the live-view state machine can be
+ *  driven directly under ink-testing-library without spinning up the full
+ *  `render()` host (which needs a TTY stdout). */
+export interface SimRunnerProps {
+    readonly args: SimLiveArgs;
+    readonly setExitCode?: (code: number) => void;
+    readonly onEnvelope?: (envelope: SignalEnvelope) => void;
+    /**
+     * Surfaces the run's generic-session contribution (host-owned-run-timing
+     * Phase 2). The host persists it after the live view exits — the component
+     * must NOT write the session itself.
+     */
+    readonly onSession?: (contribution: ToolSessionContribution) => void;
+    /** From host LiveViewContext — carries the run timer for the RunTimingProvider. */
+    readonly liveContext?: LiveViewContext;
+}
+/** The sim live-view component (loading → running → done/error). Exported for
+ *  testing; production renders it through {@link renderSimLive}. */
+export declare function SimRunner({ args, setExitCode, onEnvelope, onSession, liveContext, }: SimRunnerProps): React.ReactElement;
+export interface RenderSimLiveOptions {
+    readonly setExitCode?: (code: number) => void;
+}
+/**
+ * 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 declare function renderSimLive(args: SimLiveArgs, options?: RenderSimLiveOptions, liveContext?: LiveViewContext): Promise<ToolRunCompletion>;
+export {};
+//# sourceMappingURL=sim-runner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-runner.d.ts","sourceRoot":"","sources":["../../src/cli/sim-runner.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAyBH,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,WAAW,EAEjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC7B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAA8B,MAAM,OAAO,CAAC;AAUnD;;iDAEiD;AACjD,KAAK,WAAW,GAAG,WAAW,GAAG;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAoC1F;;kDAEkD;AAClD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;IACzD;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,YAAY,EAAE,uBAAuB,KAAK,IAAI,CAAC;IACrE,mFAAmF;IACnF,QAAQ,CAAC,WAAW,CAAC,EAAE,eAAe,CAAC;CACxC;AAED;oEACoE;AACpE,wBAAgB,SAAS,CAAC,EACxB,IAAI,EACJ,WAAW,EACX,UAAU,EACV,SAAS,EACT,WAAW,GACZ,EAAE,cAAc,GAAG,KAAK,CAAC,YAAY,CA8KrC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/C;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,WAAW,EACjB,OAAO,CAAC,EAAE,oBAAoB,EAC9B,WAAW,CAAC,EAAE,eAAe,GAC5B,OAAO,CAAC,iBAAiB,CAAC,CAyB5B"}