@opensip-cli/simulation 0.1.0

package/dist/__tests__/tool.test.js

@@ -0,0 +1,250 @@
+/**
+ * @fileoverview Smoke tests for simulationTool — the Tool plugin
+ * descriptor wired into the CLI dispatcher.
+ *
+ * Since release 2.11.0 Phase 3 (the reference migration) sim mounts via a
+ * declarative `CommandSpec` (`simulationTool.commandSpecs`) rather than the
+ * deprecated `register()` hook. The host-owned mount path
+ * (`mountCommandSpec` → parse → handler → dispatch) is covered in
+ * `cli/src/__tests__/mount-command-spec.test.ts`; this file exercises the
+ * descriptor metadata, the declared command surface, and the command
+ * handler directly with a fake ToolCliContext (the handler is what the host
+ * invokes after parsing).
+ */
+import { readFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { enterScope, RunScope } from '@opensip-cli/core';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { ASSERTIONS } from '../framework/assertions.js';
+import { clearScenarioRegistry, currentScenarioRegistry } from '../framework/registry.js';
+import { defineLoadScenario } from '../kinds/load/define.js';
+import { simulationTool } from '../tool.js';
+import { noopTarget } from './test-utils/targets.js';
+const HERE = dirname(fileURLToPath(import.meta.url));
+const PKG = JSON.parse(readFileSync(resolve(HERE, '../../package.json'), 'utf8'));
+beforeEach(() => {
+    // Item 1: scenarioRegistry and recipe registry are per-RunScope.
+    // Construct a fresh scope (with simulation extended) and enter it via
+    // AsyncLocalStorage so the handler resolves them through currentScope()
+    // while it runs.
+    const scope = new RunScope();
+    Object.assign(scope, simulationTool.contributeScope?.() ?? {});
+    enterScope(scope);
+});
+afterEach(() => {
+    clearScenarioRegistry();
+});
+/** The single declarative `sim` command sim now exports. */
+function simSpec() {
+    const spec = simulationTool.commandSpecs?.[0];
+    if (spec === undefined)
+        throw new Error('simulationTool exposes no commandSpecs');
+    return spec;
+}
+function makeFakeContext() {
+    const rendered = [];
+    const exitCodes = [];
+    const emitted = [];
+    const delivered = [];
+    const project = {
+        cwd: '/test',
+        cwdExplicit: false,
+        projectRoot: '/test',
+        configPath: undefined,
+        walkedUp: 0,
+        scope: 'none',
+    };
+    // The handler uses currentScope() (set by enterScope in beforeEach), not
+    // cli.scope, but ToolCliContext requires a scope value; mirror project
+    // into a throwaway scope here.
+    const ctxScope = new RunScope({ projectContext: project });
+    Object.assign(ctxScope, simulationTool.contributeScope?.() ?? {});
+    const ctx = {
+        scope: ctxScope,
+        render: vi.fn((result) => {
+            rendered.push(result);
+            return Promise.resolve();
+        }),
+        registerLiveView: vi.fn(),
+        renderLive: vi.fn(() => Promise.resolve()),
+        maybeOpenReport: vi.fn(() => Promise.resolve()),
+        logger: {
+            debug: vi.fn(),
+            info: vi.fn(),
+            warn: vi.fn(),
+            error: vi.fn(),
+        },
+        setExitCode: (code) => {
+            exitCodes.push(code);
+        },
+        emitJson: (value) => {
+            emitted.push(value);
+        },
+        emitRaw: (value) => {
+            emitted.push(value);
+        },
+        emitEnvelope: (value) => {
+            emitted.push(value);
+        },
+        emitError: (detail) => {
+            exitCodes.push(detail.exitCode);
+            emitted.push(detail);
+        },
+        deliverSignals: (_envelope, opts) => {
+            delivered.push(opts);
+            return Promise.resolve({ cloudAccepted: 0 });
+        },
+        writeSarif: () => Promise.resolve(),
+        saveBaseline: () => Promise.resolve(),
+        compareBaseline: () => Promise.resolve({
+            added: [],
+            resolved: [],
+            unchanged: [],
+            degraded: false,
+        }),
+        exportBaselineSarif: () => Promise.resolve(),
+        exportBaselineFingerprints: () => Promise.resolve(),
+        toolState: {
+            get: () => Promise.resolve(undefined),
+            put: () => Promise.resolve(),
+            delete: () => Promise.resolve(),
+            list: () => Promise.resolve([]),
+        },
+        runSession: {
+            timing: {
+                startedAt: new Date().toISOString(),
+                startedAtEpochMs: Date.now(),
+                elapsedMs: () => 0,
+                snapshot: () => ({
+                    startedAt: new Date().toISOString(),
+                    completedAt: new Date().toISOString(),
+                    durationMs: 0,
+                }),
+                complete: () => ({
+                    startedAt: new Date().toISOString(),
+                    completedAt: new Date().toISOString(),
+                    durationMs: 0,
+                }),
+            },
+        },
+    };
+    return { ctx, rendered, exitCodes, emitted, delivered };
+}
+/**
+ * Register one trivial load scenario into the current scope's registry so a
+ * `sim` run has work to do. Since the zero-scenario fail-closed guard (audit
+ * P1c), a run with an empty registry returns an ErrorResult (exit 2) rather
+ * than a sim-done pass — happy-path tests must supply at least one scenario.
+ */
+function registerProbeScenario() {
+    currentScenarioRegistry().register(defineLoadScenario({
+        id: 'probe',
+        name: 'probe',
+        description: 'probe',
+        tags: [],
+        target: noopTarget,
+        workload: { rps: 1 },
+        duration: 1,
+        assertions: [ASSERTIONS.lowErrorRate(1)],
+    }));
+}
+describe('simulationTool metadata', () => {
+    it('exposes name (human), id (stable UUID), version, description', () => {
+        expect(simulationTool.metadata.name).toBe('simulation');
+        expect(simulationTool.metadata.id).toBe('715d32c2-692c-4ed4-985b-a35deaf186aa');
+        expect(simulationTool.metadata.version).toBe(PKG.version);
+        expect(simulationTool.metadata.description).toContain('simulation');
+    });
+    it('declares the user-facing sim subcommand (+ the internal worker)', () => {
+        const names = simulationTool.commands.map((c) => c.name);
+        expect(names).toContain('sim');
+        // The internal off-main-process worker (ADR-0028), forked by the live view.
+        expect(names).toContain('sim-run-worker');
+        expect(simulationTool.commands).toHaveLength(2);
+    });
+});
+describe('simulationTool command surface (Phase 3 — CommandSpec migration)', () => {
+    it('mounts via commandSpecs — the one command surface (register() removed in 3.0.0)', () => {
+        // `sim` + the internal `sim-run-worker` (ADR-0028).
+        expect(simulationTool.commandSpecs).toHaveLength(2);
+        // `register` is no longer a Tool member (3.0.0) — its absence is structural,
+        // enforced by the type system, not asserted at runtime.
+    });
+    it('declares the sim command name/description/output/scope', () => {
+        const spec = simSpec();
+        expect(spec.name).toBe('sim');
+        expect(spec.description).toBe('Run simulation scenarios');
+        // The handler owns its full output surface (TTY-vs-static branch + egress).
+        expect(spec.output).toBe('raw-stream');
+        expect(spec.scope).toBe('project');
+        expect(typeof spec.handler).toBe('function');
+    });
+    it('declares the ADR-0021 common flags and the --recipe option', () => {
+        const spec = simSpec();
+        // Cross-tool flags from the single registry (ADR-0021).
+        expect([...spec.commonFlags]).toEqual(expect.arrayContaining([
+            'cwd',
+            'json',
+            'quiet',
+            'verbose',
+            'debug',
+            'reportTo',
+            'apiKey',
+            'open',
+        ]));
+        const optionFlags = (spec.options ?? []).map((o) => o.flag);
+        expect(optionFlags).toContain('--recipe');
+        const recipe = (spec.options ?? []).find((o) => o.flag === '--recipe');
+        expect(recipe?.value).toBe('<name>');
+    });
+});
+describe('sim command handler', () => {
+    it('runs against the default recipe and renders the result', async () => {
+        const { ctx, rendered } = makeFakeContext();
+        registerProbeScenario();
+        // Non-TTY/non-json path: the handler runs the engine and renders statically.
+        await simSpec().handler({ cwd: process.cwd() }, ctx);
+        expect(rendered).toHaveLength(1);
+        const result = rendered[0];
+        expect(result.type).toBe('sim-done');
+        expect(result.recipeName).toBe('default');
+    });
+    it('emits the signal envelope through cli.emitEnvelope when --json is passed', async () => {
+        const { ctx, emitted } = makeFakeContext();
+        registerProbeScenario();
+        await simSpec().handler({ cwd: process.cwd(), json: true }, ctx);
+        // ADR-0011 (Phase 4): --json routes the SignalEnvelope (not the bespoke
+        // SimDoneResult) through the root's emitEnvelope → formatSignalJson.
+        expect(emitted).toHaveLength(1);
+        const payload = emitted[0];
+        expect(payload.schemaVersion).toBe(2);
+        expect(payload.tool).toBe('sim');
+    });
+    it('delivers static egress with the requested cwd', async () => {
+        const { ctx, delivered } = makeFakeContext();
+        registerProbeScenario();
+        await simSpec().handler({ cwd: HERE, json: true }, ctx);
+        expect(delivered).toHaveLength(1);
+        expect(delivered[0]).toMatchObject({ cwd: HERE });
+    });
+    it('returns exit code 2 in JSON mode when the recipe is unknown', async () => {
+        const { ctx, exitCodes, emitted } = makeFakeContext();
+        await simSpec().handler({ cwd: process.cwd(), json: true, recipe: 'nope' }, ctx);
+        expect(exitCodes).toContain(2);
+        expect(emitted).toHaveLength(1);
+        // 2.12.0: a failed --json run emits a structured error detail (`message`),
+        // not a bare `{ error }` (the host wraps it in a status:'error' outcome).
+        const payload = emitted[0];
+        expect(payload.message).toContain('Unknown sim recipe');
+    });
+    it('returns exit code 2 in non-JSON mode for unknown recipe', async () => {
+        const { ctx, exitCodes, rendered } = makeFakeContext();
+        await simSpec().handler({ cwd: process.cwd(), recipe: 'still-nope' }, ctx);
+        expect(exitCodes).toContain(2);
+        const errResult = rendered[0];
+        expect(errResult.type).toBe('error');
+        expect(errResult.message).toContain('still-nope');
+    });
+});
+//# sourceMappingURL=tool.test.js.map

package/dist/__tests__/tool.test.js.map

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

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

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

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

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

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

@@ -0,0 +1,94 @@
+import { mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { runWithScopeSync } from '@opensip-cli/core';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { makeSimTestScope } from '../../__tests__/test-utils/with-sim-scope.js';
+import { resolveSimRecipeSelection } from '../sim-config.js';
+/**
+ * `resolveSimRecipeSelection` reads `simulation.recipe` from the project config
+ * (permissively — sim must not depend on fitness's strict schema) and applies
+ * ADR-0022 precedence.
+ */
+describe('resolveSimRecipeSelection (ADR-0022)', () => {
+    let dir;
+    beforeEach(() => {
+        dir = mkdtempSync(join(tmpdir(), 'opensip-sim-cfg-'));
+    });
+    afterEach(() => {
+        rmSync(dir, { recursive: true, force: true });
+    });
+    const write = (yaml) => {
+        writeFileSync(join(dir, 'opensip-cli.config.yml'), yaml);
+    };
+    it('explicit --recipe wins and is strict', () => {
+        write('simulation:\n  recipe: from-config\n');
+        expect(resolveSimRecipeSelection(dir, 'explicit')).toMatchObject({
+            name: 'explicit',
+            source: 'flag',
+            tolerant: false,
+        });
+    });
+    it('reads simulation.recipe when no flag', () => {
+        write('simulation:\n  recipe: smoke\n');
+        expect(resolveSimRecipeSelection(dir, undefined)).toMatchObject({
+            name: 'smoke',
+            source: 'tool-config',
+            tolerant: true,
+        });
+    });
+    it('ignores cli.recipe now that the fallback was removed', () => {
+        write('cli:\n  recipe: opensip\n');
+        expect(resolveSimRecipeSelection(dir, undefined)).toMatchObject({
+            name: 'default',
+            source: 'builtin',
+            tolerant: true,
+        });
+    });
+    it('returns the builtin default when no config file exists', () => {
+        expect(resolveSimRecipeSelection(dir, undefined)).toMatchObject({
+            name: 'default',
+            source: 'builtin',
+            tolerant: true,
+        });
+    });
+    it('ignores a non-string simulation.recipe (malformed) and falls through', () => {
+        write('simulation:\n  recipe:\n    - not-a-string\ncli:\n  recipe: from-cli\n');
+        expect(resolveSimRecipeSelection(dir, undefined)).toMatchObject({
+            name: 'default',
+            source: 'builtin',
+        });
+    });
+    it('returns builtin default when simulation: block is not a mapping', () => {
+        write('simulation: just-a-scalar\n');
+        expect(resolveSimRecipeSelection(dir, undefined)).toMatchObject({
+            name: 'default',
+            source: 'builtin',
+        });
+    });
+    // ADR-0023, Phase 4: when a RunScope is present, sim reads `simulation.recipe`
+    // off the host-RESOLVED `scope.toolConfig.simulation` block, NOT a second YAML
+    // read. These prove the value comes from the scope (and that the on-disk file
+    // is ignored when the scope is present).
+    describe('reads simulation.recipe off scope.toolConfig.simulation', () => {
+        it('returns the resolved scope recipe, ignoring the on-disk simulation.recipe', () => {
+            // On-disk says `from-file`; a second YAML read would surface it. The scope
+            // says `from-scope` — sim must return the SCOPE value.
+            write('simulation:\n  recipe: from-file\n');
+            const scope = makeSimTestScope();
+            Object.assign(scope, { toolConfig: { simulation: { recipe: 'from-scope' } } });
+            const resolved = runWithScopeSync(scope, () => resolveSimRecipeSelection(dir, undefined));
+            expect(resolved).toMatchObject({ name: 'from-scope', source: 'tool-config' });
+        });
+        it('returns builtin default when the scope simulation block has no recipe', () => {
+            // Scope simulation block is empty → no tool recipe, so the builtin default
+            // supplies the fallback.
+            write('cli:\n  recipe: from-cli\n');
+            const scope = makeSimTestScope();
+            Object.assign(scope, { toolConfig: { simulation: {} } });
+            const resolved = runWithScopeSync(scope, () => resolveSimRecipeSelection(dir, undefined));
+            expect(resolved).toMatchObject({ name: 'default', source: 'builtin' });
+        });
+    });
+});
+//# sourceMappingURL=sim-config.test.js.map

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

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

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

@@ -0,0 +1,23 @@
+/**
+ * @fileoverview Behavioural tests for the `sim` live-view state machine
+ * (ADR-0016). Drives `<SimRunner>` directly under ink-testing-library — no real
+ * TTY `render()` host — and asserts the rendered frames reflect each phase:
+ *
+ *   - loading → running → done: the banner/run-header, the live spinner, and
+ *     the final pass/fail RunSummary, with the run's SignalEnvelope handed back
+ *     via `onEnvelope`.
+ *   - failing scenario: `setExitCode(RUNTIME_ERROR)` fires when a scenario
+ *     fails (the run still completes and shows a summary).
+ *   - unknown recipe: the error phase renders <ErrorMessage> and reports the
+ *     configuration exit code.
+ *   - `--quiet`: the banner/header block is suppressed, leaving only the
+ *     summary.
+ *   - `mini` banner with an available update: the inline UpdateHint renders.
+ *
+ * The assertions inspect event-driven frame content (labels, counters,
+ * pass/fail glyphs), never the animated spinner frame, so they're
+ * deterministic. `waitForFrame` polls the latest frame to absorb React's async
+ * re-renders.
+ */
+export {};
+//# sourceMappingURL=sim-runner.test.d.ts.map

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

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

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

@@ -0,0 +1,188 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * @fileoverview Behavioural tests for the `sim` live-view state machine
+ * (ADR-0016). Drives `<SimRunner>` directly under ink-testing-library — no real
+ * TTY `render()` host — and asserts the rendered frames reflect each phase:
+ *
+ *   - loading → running → done: the banner/run-header, the live spinner, and
+ *     the final pass/fail RunSummary, with the run's SignalEnvelope handed back
+ *     via `onEnvelope`.
+ *   - failing scenario: `setExitCode(RUNTIME_ERROR)` fires when a scenario
+ *     fails (the run still completes and shows a summary).
+ *   - unknown recipe: the error phase renders <ErrorMessage> and reports the
+ *     configuration exit code.
+ *   - `--quiet`: the banner/header block is suppressed, leaving only the
+ *     summary.
+ *   - `mini` banner with an available update: the inline UpdateHint renders.
+ *
+ * The assertions inspect event-driven frame content (labels, counters,
+ * pass/fail glyphs), never the animated spinner frame, so they're
+ * deterministic. `waitForFrame` polls the latest frame to absorb React's async
+ * re-renders.
+ */
+import { enterScope, RunScope } from '@opensip-cli/core';
+import { render } from 'ink-testing-library';
+import { afterAll, afterEach, beforeAll, describe, expect, it } from 'vitest';
+import { noopTarget } from '../../__tests__/test-utils/targets.js';
+import { ASSERTIONS } from '../../framework/assertions.js';
+import { clearScenarioRegistry, currentScenarioRegistry } from '../../framework/registry.js';
+import { defineLoadScenario } from '../../kinds/load/define.js';
+import { simulationTool } from '../../tool.js';
+import { SimRunner } from '../sim-runner.js';
+// The live runner forks `sim-run-worker` off the main process (ADR-0028), but in
+// the test runner `process.argv[1]` is vitest, not the CLI — so force the
+// in-process fallback, which exercises the SimRunner state machine directly
+// against the scope each test sets up. (The fork path is covered by a dedicated
+// subprocess harness, not the component unit tests.)
+beforeAll(() => {
+    process.env.OPENSIP_CLI_NO_WORKER = '1';
+});
+afterAll(() => {
+    delete process.env.OPENSIP_CLI_NO_WORKER;
+});
+afterEach(() => {
+    // Each test enters its own scope; clear the scenario registry between runs.
+    try {
+        clearScenarioRegistry();
+    }
+    catch {
+        // No active scope (a test that never entered one) — nothing to clear.
+    }
+});
+/** Enter a fresh scope (with the simulation subscope attached) plus any
+ *  presentation context the header branch under test needs. */
+function enterSimScope(opts = {}) {
+    const scope = new RunScope(opts);
+    Object.assign(scope, simulationTool.contributeScope?.() ?? {});
+    enterScope(scope);
+}
+function registerProbe(id = 'probe') {
+    currentScenarioRegistry().register(defineLoadScenario({
+        id,
+        name: id,
+        description: id,
+        tags: [],
+        target: noopTarget,
+        workload: { rps: 1 },
+        duration: 1,
+        assertions: [ASSERTIONS.lowErrorRate(1)],
+    }));
+}
+const baseArgs = (overrides = {}) => ({
+    json: false,
+    cwd: process.cwd(),
+    debug: false,
+    ...overrides,
+});
+/** Poll the latest frame until it contains `substr` (or time out). */
+async function waitForFrame(lastFrame, substr) {
+    for (let i = 0; i < 200; i++) {
+        if ((lastFrame() ?? '').includes(substr))
+            return;
+        await new Promise((resolve) => {
+            setTimeout(resolve, 5);
+        });
+    }
+}
+describe('<SimRunner> — live-view state machine', () => {
+    it('renders the run header, then the final pass summary, and returns the envelope', async () => {
+        enterSimScope();
+        registerProbe('runner-pass');
+        let captured;
+        const exitCodes = [];
+        const { lastFrame, unmount } = render(_jsx(SimRunner, { args: baseArgs(), setExitCode: (c) => exitCodes.push(c), onEnvelope: (e) => {
+                captured = e;
+            } }));
+        // Header (non-quiet, non-mini default) carries the tool title + recipe.
+        await waitForFrame(lastFrame, 'Simulation Scenarios');
+        expect(lastFrame()).toContain('Recipe');
+        expect(lastFrame()).toContain('default');
+        // The run completes; the summary shows the PASS verdict (ADR-0035).
+        await waitForFrame(lastFrame, 'PASS');
+        const frame = lastFrame() ?? '';
+        expect(frame).toContain('PASS');
+        // The completed run handed its envelope back to the composition root, and a
+        // green run sets no failure exit code.
+        expect(captured).toBeDefined();
+        expect(captured?.tool).toBe('sim');
+        expect(captured?.verdict.passed).toBe(true);
+        expect(exitCodes).not.toContain(1);
+        unmount();
+    });
+    it('yields a failing-verdict envelope when a scenario fails (host owns the exit)', async () => {
+        enterSimScope();
+        // A scenario whose run() rejects → recorded as failed.
+        currentScenarioRegistry().register({
+            id: 'runner-boom',
+            name: 'runner-boom',
+            description: 'boom',
+            kind: 'load',
+            tags: [],
+            run: () => Promise.reject(new Error('kaboom')),
+        });
+        const exitCodes = [];
+        let captured;
+        const { lastFrame, unmount } = render(_jsx(SimRunner, { args: baseArgs(), setExitCode: (c) => exitCodes.push(c), onEnvelope: (e) => {
+                captured = e;
+            } }));
+        await waitForFrame(lastFrame, 'FAIL');
+        // ADR-0035: the runner no longer sets the findings exit — it hands the
+        // envelope to the host (via onEnvelope → deliverSignals), which derives the
+        // exit from envelope.verdict.passed. The runner itself sets no findings code.
+        expect(exitCodes).not.toContain(1);
+        expect(captured).toBeDefined();
+        expect(captured?.verdict.summary.failed).toBe(1);
+        // A thrown scenario fails its unit → the run verdict fails → the host exits 1.
+        expect(captured?.verdict.passed).toBe(false);
+        unmount();
+    });
+    it('renders the error phase and reports the config exit code for an unknown recipe', async () => {
+        enterSimScope();
+        registerProbe('runner-unused');
+        const exitCodes = [];
+        const { lastFrame, unmount } = render(_jsx(SimRunner, { args: baseArgs({ recipe: 'does-not-exist' }), setExitCode: (c) => exitCodes.push(c) }));
+        await waitForFrame(lastFrame, 'does-not-exist');
+        expect(lastFrame()).toContain('does-not-exist');
+        // CONFIGURATION_ERROR === 2. The exit code is set in the same async tick as
+        // the error-phase transition; poll briefly to absorb the React re-render.
+        for (let i = 0; i < 50 && !exitCodes.includes(2); i++) {
+            await new Promise((resolve) => {
+                setTimeout(resolve, 5);
+            });
+        }
+        expect(exitCodes).toContain(2);
+        unmount();
+    });
+    it('suppresses the banner/header block under --quiet but still shows the summary', async () => {
+        enterSimScope();
+        registerProbe('runner-quiet');
+        const { lastFrame, unmount } = render(_jsx(SimRunner, { args: baseArgs({ quiet: true }) }));
+        await waitForFrame(lastFrame, 'PASS');
+        const frame = lastFrame() ?? '';
+        // Quiet drops the run-header chrome…
+        expect(frame).not.toContain('Simulation Scenarios');
+        // …but keeps the PASS/FAIL verdict summary.
+        expect(frame).toContain('PASS');
+        unmount();
+    });
+    it('renders the mini banner update hint when an update is available', async () => {
+        enterSimScope({
+            ui: { bannerSize: 'mini', version: '3.0.0', update: '3.1.0' },
+            projectContext: {
+                cwd: process.cwd(),
+                cwdExplicit: false,
+                projectRoot: process.cwd(),
+                configPath: undefined,
+                walkedUp: 0,
+                scope: 'none',
+            },
+        });
+        registerProbe('runner-mini');
+        const { lastFrame, unmount } = render(_jsx(SimRunner, { args: baseArgs() }));
+        // The mini banner surfaces the available update; the UpdateHint row renders.
+        await waitForFrame(lastFrame, '3.1.0');
+        expect(lastFrame()).toContain('3.1.0');
+        unmount();
+    });
+});
+//# sourceMappingURL=sim-runner.test.js.map

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

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

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

@@ -0,0 +1,12 @@
+/**
+ * `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.
+ */
+export {};
+//# sourceMappingURL=sim-worker.test.d.ts.map

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

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