@opensip-cli/simulation 0.1.0

package/dist/__tests__/test-utils/with-sim-scope.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @fileoverview Test helper — construct a RunScope with the simulation
+ * subscope attached, then run a callback inside it.
+ *
+ * After Item 1 the scenario + recipe registries are per-RunScope. Tests
+ * that touch them must build a scope first; this helper centralises the
+ * boilerplate.
+ */
+import { RunScope } from '@opensip-cli/core';
+/** Build a fresh RunScope with `scope.simulation` populated. */
+export declare function makeSimTestScope(): RunScope;
+//# sourceMappingURL=with-sim-scope.d.ts.map

package/dist/__tests__/test-utils/with-sim-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-sim-scope.d.ts","sourceRoot":"","sources":["../../../src/__tests__/test-utils/with-sim-scope.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAoB,QAAQ,EAAgB,MAAM,mBAAmB,CAAC;AAW7E,gEAAgE;AAChE,wBAAgB,gBAAgB,IAAI,QAAQ,CAI3C"}

package/dist/__tests__/test-utils/with-sim-scope.js

@@ -0,0 +1,22 @@
+/**
+ * @fileoverview Test helper — construct a RunScope with the simulation
+ * subscope attached, then run a callback inside it.
+ *
+ * After Item 1 the scenario + recipe registries are per-RunScope. Tests
+ * that touch them must build a scope first; this helper centralises the
+ * boilerplate.
+ */
+import { LanguageRegistry, RunScope, ToolRegistry } from '@opensip-cli/core';
+import { simulationTool } from '../../tool.js';
+/** Fresh scope with empty registries — local equivalent of the retired
+ *  `@opensip-cli/core/test-utils` helper (ADR-0040: that sugar moved to
+ *  `@opensip-cli/test-support`, which this package's tests cannot use
+ *  without coupling its test graph to the fitness engine). */
+const makeTestScope = () => new RunScope({ languages: new LanguageRegistry(), tools: new ToolRegistry() });
+/** Build a fresh RunScope with `scope.simulation` populated. */
+export function makeSimTestScope() {
+    const scope = makeTestScope();
+    Object.assign(scope, simulationTool.contributeScope?.() ?? {});
+    return scope;
+}
+//# sourceMappingURL=with-sim-scope.js.map

package/dist/__tests__/test-utils/with-sim-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-sim-scope.js","sourceRoot":"","sources":["../../../src/__tests__/test-utils/with-sim-scope.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE7E,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C;;;8DAG8D;AAC9D,MAAM,aAAa,GAAG,GAAa,EAAE,CACnC,IAAI,QAAQ,CAAC,EAAE,SAAS,EAAE,IAAI,gBAAgB,EAAE,EAAE,KAAK,EAAE,IAAI,YAAY,EAAE,EAAE,CAAC,CAAC;AAEjF,gEAAgE;AAChE,MAAM,UAAU,gBAAgB;IAC9B,MAAM,KAAK,GAAG,aAAa,EAAE,CAAC;IAC9B,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,cAAc,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/D,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/__tests__/tool-live-view.test.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @fileoverview Tests for simulationTool's live-view wiring (ADR-0016) — the
+ * paths the static-render tool.test.ts can't reach:
+ *
+ *   - the interactive TTY branch of the `sim` handler registers a live view
+ *     under the `sim` key, and that callback renders the live view then
+ *     delivers the returned envelope to the composition root (cloud +
+ *     --report-to egress).
+ *   - the interactive TTY action branch routes to cli.renderLive +
+ *     maybeOpenReport instead of the static executeSim path.
+ *
+ * Since release 2.11.0 Phase 3 sim mounts via a `CommandSpec`; the live-view
+ * registration moved from the (removed) `register()` mount hook into the
+ * handler's interactive branch, where it runs lazily before `cli.renderLive`.
+ * We drive the handler directly (the host invokes it post-parse) with
+ * `process.stdout.isTTY` forced on. `renderSimLive` is mocked so we exercise
+ * the wiring without spinning up a real Ink render host.
+ */
+export {};
+//# sourceMappingURL=tool-live-view.test.d.ts.map

package/dist/__tests__/tool-live-view.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-live-view.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/tool-live-view.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG"}

package/dist/__tests__/tool-live-view.test.js

@@ -0,0 +1,146 @@
+/**
+ * @fileoverview Tests for simulationTool's live-view wiring (ADR-0016) — the
+ * paths the static-render tool.test.ts can't reach:
+ *
+ *   - the interactive TTY branch of the `sim` handler registers a live view
+ *     under the `sim` key, and that callback renders the live view then
+ *     delivers the returned envelope to the composition root (cloud +
+ *     --report-to egress).
+ *   - the interactive TTY action branch routes to cli.renderLive +
+ *     maybeOpenReport instead of the static executeSim path.
+ *
+ * Since release 2.11.0 Phase 3 sim mounts via a `CommandSpec`; the live-view
+ * registration moved from the (removed) `register()` mount hook into the
+ * handler's interactive branch, where it runs lazily before `cli.renderLive`.
+ * We drive the handler directly (the host invokes it post-parse) with
+ * `process.stdout.isTTY` forced on. `renderSimLive` is mocked so we exercise
+ * the wiring without spinning up a real Ink render host.
+ */
+import { enterScope, RunScope } from '@opensip-cli/core';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { simulationTool } from '../tool.js';
+// Mock the Ink renderer so the live-view callback can run without a real
+// terminal. The mock returns a deterministic envelope.
+const fakeEnvelope = {
+    schemaVersion: 2,
+    tool: 'sim',
+    verdict: { passed: false, summary: { passed: 0, failed: 1, errors: 0, warnings: 0 } },
+};
+// host-owned-run-timing Phase 2: renderSimLive resolves a ToolRunCompletion
+// ({ envelope, session }); the tool reads `.envelope` for egress and the host
+// persists `.session`.
+vi.mock('../cli/sim-runner.js', () => ({
+    renderSimLive: vi.fn(() => Promise.resolve({ envelope: fakeEnvelope })),
+}));
+const { renderSimLive } = await import('../cli/sim-runner.js');
+beforeEach(() => {
+    const scope = new RunScope();
+    Object.assign(scope, simulationTool.contributeScope?.() ?? {});
+    enterScope(scope);
+});
+afterEach(() => {
+    vi.clearAllMocks();
+});
+/** The single declarative `sim` command sim exports. */
+function simHandler() {
+    const spec = simulationTool.commandSpecs?.[0];
+    if (spec === undefined)
+        throw new Error('simulationTool exposes no commandSpecs');
+    return spec.handler;
+}
+function makeCtx() {
+    const liveViews = new Map();
+    const delivered = [];
+    const renderLiveCalls = [];
+    const dashboardCalls = [];
+    const exitCodes = [];
+    const ctx = {
+        scope: new RunScope(),
+        render: vi.fn(() => Promise.resolve()),
+        registerLiveView: vi.fn((key, cb) => {
+            liveViews.set(key, cb);
+        }),
+        renderLive: vi.fn((key, args) => {
+            renderLiveCalls.push([key, args]);
+            return Promise.resolve();
+        }),
+        maybeOpenReport: vi.fn((arg) => {
+            dashboardCalls.push(arg);
+            return Promise.resolve();
+        }),
+        logger: { debug: vi.fn(), info: vi.fn(), warn: vi.fn(), error: vi.fn() },
+        setExitCode: (code) => exitCodes.push(code),
+        emitJson: vi.fn(),
+        emitRaw: vi.fn(),
+        emitEnvelope: vi.fn(),
+        emitError: vi.fn(),
+        deliverSignals: vi.fn((envelope, opts) => {
+            delivered.push({ envelope, opts });
+            return Promise.resolve();
+        }),
+        writeSarif: vi.fn(() => Promise.resolve()),
+    };
+    return { ctx, liveViews, delivered, renderLiveCalls, dashboardCalls, exitCodes };
+}
+describe('simulationTool live-view callback (ADR-0016)', () => {
+    const originalIsTTY = process.stdout.isTTY;
+    afterEach(() => {
+        process.stdout.isTTY = originalIsTTY;
+    });
+    it('registers a live view under the `sim` key and delivers the rendered envelope', async () => {
+        process.stdout.isTTY = true;
+        const cap = makeCtx();
+        // The interactive branch registers the live view, so run the handler once
+        // to install it, then exercise the registered callback directly.
+        await simHandler()({ cwd: '/proj' }, cap.ctx);
+        const callback = cap.liveViews.get('sim');
+        expect(callback).toBeDefined();
+        // Invoke the live-view callback the dispatcher would call.
+        await callback?.({ cwd: '/proj', reportTo: 'https://cloud.example', apiKey: 'k' });
+        // The Ink renderer ran with setExitCode wired through (once per run via the
+        // handler's renderLive, once here via the direct callback invocation).
+        expect(renderSimLive).toHaveBeenCalled();
+        // The returned envelope was delivered to the composition root with egress
+        // options derived from the args. ADR-0035: a normal run does NOT pass
+        // `runFailed` — the host derives the findings exit from envelope.verdict.passed.
+        expect(cap.delivered.length).toBeGreaterThanOrEqual(1);
+        const last = cap.delivered.at(-1);
+        expect(last?.envelope).toBe(fakeEnvelope);
+        expect(last?.opts).toMatchObject({
+            cwd: '/proj',
+            reportTo: 'https://cloud.example',
+            apiKey: 'k',
+        });
+        expect(last?.opts).not.toHaveProperty('runFailed');
+    });
+    it('does not deliver when the renderer returns no envelope', async () => {
+        process.stdout.isTTY = true;
+        // The handler's own renderLive (the live view) is dispatched through
+        // cli.renderLive (mocked to a no-op), so it does not invoke renderSimLive;
+        // only the directly-invoked callback below does, returning a completion with
+        // no envelope (host-owned-run-timing Phase 2).
+        renderSimLive.mockResolvedValueOnce({ envelope: undefined });
+        const cap = makeCtx();
+        await simHandler()({ cwd: '/proj' }, cap.ctx);
+        await cap.liveViews.get('sim')?.({ cwd: '/proj' });
+        expect(cap.delivered).toHaveLength(0);
+    });
+});
+describe('simulationTool action — interactive TTY branch', () => {
+    const originalIsTTY = process.stdout.isTTY;
+    afterEach(() => {
+        process.stdout.isTTY = originalIsTTY;
+    });
+    it('routes to renderLive + maybeOpenReport when stdout is a TTY (non-json)', async () => {
+        process.stdout.isTTY = true;
+        const cap = makeCtx();
+        await simHandler()({ open: true }, cap.ctx);
+        // Interactive path: the static executeSim render is bypassed in favour of
+        // the live view, then the report auto-open hook fires.
+        expect(cap.renderLiveCalls).toHaveLength(1);
+        expect(cap.renderLiveCalls[0]?.[0]).toBe('sim');
+        expect(cap.dashboardCalls).toHaveLength(1);
+        expect(cap.dashboardCalls[0]).toMatchObject({ openRequested: true, jsonOutput: false });
+    });
+});
+//# sourceMappingURL=tool-live-view.test.js.map

package/dist/__tests__/tool-live-view.test.js.map

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

package/dist/__tests__/tool-show-mode.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Coverage for sim's `--show` session-replay handler (`runSimShowMode`).
+ *
+ * Unlike `fit`, which exposes a dedicated `session show` command, `sim` wires
+ * replay into its run command as a `--show <session>` flag handled inside
+ * `tool.ts`. This drives that handler through the real `simSpec().handler`
+ * entry point with a fake `ToolCliContext` whose scope carries a datastore.
+ */
+export {};
+//# sourceMappingURL=tool-show-mode.test.d.ts.map

package/dist/__tests__/tool-show-mode.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-show-mode.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/tool-show-mode.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/__tests__/tool-show-mode.test.js

@@ -0,0 +1,156 @@
+/**
+ * Coverage for sim's `--show` session-replay handler (`runSimShowMode`).
+ *
+ * Unlike `fit`, which exposes a dedicated `session show` command, `sim` wires
+ * replay into its run command as a `--show <session>` flag handled inside
+ * `tool.ts`. This drives that handler through the real `simSpec().handler`
+ * entry point with a fake `ToolCliContext` whose scope carries a datastore.
+ */
+import { enterScope, RunScope } from '@opensip-cli/core';
+import { DataStoreFactory } from '@opensip-cli/datastore';
+import { SessionRepo } from '@opensip-cli/session-store';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { simulationTool } from '../tool.js';
+function simSpec() {
+    const spec = simulationTool.commandSpecs?.[0];
+    if (spec === undefined)
+        throw new Error('simulationTool exposes no commandSpecs');
+    return spec;
+}
+function simSession(overrides = {}) {
+    return {
+        id: 'SIM_1',
+        tool: 'sim',
+        cwd: '/repo',
+        startedAt: '2026-06-08T00:00:00.000Z',
+        completedAt: '2026-06-08T00:00:00.000Z',
+        score: 100,
+        passed: true,
+        durationMs: 5,
+        payload: {
+            summary: { total: 0, passed: 0, failed: 0, errors: 0, warnings: 0 },
+            checks: [],
+        },
+        ...overrides,
+    };
+}
+function makeContext(datastore) {
+    const rendered = [];
+    const emitted = [];
+    const exitCodes = [];
+    const scope = new RunScope({ datastore: () => datastore });
+    Object.assign(scope, simulationTool.contributeScope?.() ?? {});
+    const ctx = {
+        scope,
+        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: () => 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, emitted, exitCodes };
+}
+let ds;
+beforeEach(() => {
+    ds = DataStoreFactory.open({ backend: 'memory' });
+    enterScope(new RunScope({ datastore: () => ds }));
+});
+afterEach(() => {
+    ds.close();
+});
+describe('sim --show (runSimShowMode)', () => {
+    it('replays a stored session by id and renders the result (non-JSON)', async () => {
+        new SessionRepo(ds).save(simSession());
+        const { ctx, rendered } = makeContext(ds);
+        await simSpec().handler({ cwd: '/repo', show: 'SIM_1' }, ctx);
+        expect(rendered).toHaveLength(1);
+        // Replays render through the tool-agnostic session-replay view, not sim-done.
+        expect(rendered[0]).toMatchObject({
+            type: 'session-replay',
+            session: { id: 'SIM_1', tool: 'sim' },
+            envelope: { tool: 'sim' },
+        });
+    });
+    it('emits a JSON replay wrapper when --json is passed', async () => {
+        new SessionRepo(ds).save(simSession());
+        const { ctx, emitted } = makeContext(ds);
+        await simSpec().handler({ cwd: '/repo', show: 'SIM_1', json: true }, ctx);
+        expect(emitted).toHaveLength(1);
+        expect(emitted[0]).toMatchObject({
+            session: { id: 'SIM_1', tool: 'sim' },
+            fidelity: 'projection',
+            envelope: { tool: 'sim', runId: 'SIM_1' },
+        });
+    });
+    it('errors with datastore-unavailable when no datastore is present', async () => {
+        const { ctx, emitted, exitCodes } = makeContext(undefined);
+        await simSpec().handler({ cwd: '/repo', show: 'latest', json: true }, ctx);
+        expect(exitCodes).toContain(2);
+        expect(emitted[0]).toEqual({
+            message: 'session replay requires a datastore',
+            exitCode: 2,
+            code: 'datastore-unavailable',
+        });
+    });
+    it('errors (non-JSON) with a rendered error result when the session is missing', async () => {
+        const { ctx, rendered, exitCodes } = makeContext(ds);
+        await simSpec().handler({ cwd: '/repo', show: 'MISSING' }, ctx);
+        expect(exitCodes).toContain(2);
+        expect(rendered[0]).toMatchObject({ type: 'error' });
+    });
+    it('surfaces a decode-error when the stored payload is corrupt', async () => {
+        new SessionRepo(ds).save(simSession({ id: 'SIM_BAD', payload: { not: 'valid' } }));
+        const { ctx, emitted } = makeContext(ds);
+        await simSpec().handler({ cwd: '/repo', show: 'SIM_BAD', json: true }, ctx);
+        expect(emitted[0]).toMatchObject({ code: 'decode-error' });
+    });
+});
+//# sourceMappingURL=tool-show-mode.test.js.map

package/dist/__tests__/tool-show-mode.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-show-mode.test.js","sourceRoot":"","sources":["../../src/__tests__/tool-show-mode.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAEzE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAM5C,SAAS,OAAO;IACd,MAAM,IAAI,GAAG,cAAc,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC;IAC9C,IAAI,IAAI,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAClF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,UAAU,CAAC,YAAoC,EAAE;IACxD,OAAO;QACL,EAAE,EAAE,OAAO;QACX,IAAI,EAAE,KAAK;QACX,GAAG,EAAE,OAAO;QACZ,SAAS,EAAE,0BAA0B;QACrC,WAAW,EAAE,0BAA0B;QACvC,KAAK,EAAE,GAAG;QACV,MAAM,EAAE,IAAI;QACZ,UAAU,EAAE,CAAC;QACb,OAAO,EAAE;YACP,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE;YACnE,MAAM,EAAE,EAAE;SACX;QACD,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,SAAgC;IAMnD,MAAM,QAAQ,GAAc,EAAE,CAAC;IAC/B,MAAM,OAAO,GAAc,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC;IAC3D,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,cAAc,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/D,MAAM,GAAG,GAAmB;QAC1B,KAAK;QACL,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,MAAe,EAAE,EAAE;YAChC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACtB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC,CAAC;QACF,gBAAgB,EAAE,EAAE,CAAC,EAAE,EAAE;QACzB,UAAU,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QAC1C,eAAe,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QAC/C,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE;QACxE,WAAW,EAAE,CAAC,IAAY,EAAE,EAAE;YAC5B,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;QACD,QAAQ,EAAE,CAAC,KAAc,EAAE,EAAE;YAC3B,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;QACD,OAAO,EAAE,CAAC,KAAc,EAAE,EAAE;YAC1B,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;QACD,YAAY,EAAE,CAAC,KAAc,EAAE,EAAE;YAC/B,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;QACD,SAAS,EAAE,CAAC,MAAkE,EAAE,EAAE;YAChF,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAChC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;QACD,cAAc,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC;QAC3D,UAAU,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE;QACnC,YAAY,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE;QACrC,eAAe,EAAE,GAAG,EAAE,CACpB,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;QAC9E,mBAAmB,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE;QAC5C,0BAA0B,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE;QACnD,SAAS,EAAE;YACT,GAAG,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC;YACrC,GAAG,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE;YAC5B,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE;YAC/B,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;SAChC;QACD,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,gBAAgB,EAAE,IAAI,CAAC,GAAG,EAAE;gBAC5B,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;gBAClB,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC;oBACf,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;oBACnC,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;oBACrC,UAAU,EAAE,CAAC;iBACd,CAAC;gBACF,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC;oBACf,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;oBACnC,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;oBACrC,UAAU,EAAE,CAAC;iBACd,CAAC;aACH;SACF;KACF,CAAC;IACF,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AAC/C,CAAC;AAED,IAAI,EAAa,CAAC;AAElB,UAAU,CAAC,GAAG,EAAE;IACd,EAAE,GAAG,gBAAgB,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;IAClD,UAAU,CAAC,IAAI,QAAQ,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AACpD,CAAC,CAAC,CAAC;AAEH,SAAS,CAAC,GAAG,EAAE;IACb,EAAE,CAAC,KAAK,EAAE,CAAC;AACb,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,6BAA6B,EAAE,GAAG,EAAE;IAC3C,EAAE,CAAC,kEAAkE,EAAE,KAAK,IAAI,EAAE;QAChF,IAAI,WAAW,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QACvC,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC;QAE1C,MAAM,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,GAAG,CAAC,CAAC;QAE9D,MAAM,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACjC,8EAA8E;QAC9E,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;YAChC,IAAI,EAAE,gBAAgB;YACtB,OAAO,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE;YACrC,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE;SAC1B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;QACjE,IAAI,WAAW,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QACvC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC;QAEzC,MAAM,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC;QAE1E,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;YAC/B,OAAO,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE;YACrC,QAAQ,EAAE,YAAY;YACtB,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE;SAC1C,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gEAAgE,EAAE,KAAK,IAAI,EAAE;QAC9E,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;QAE3D,MAAM,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC;QAE3E,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YACzB,OAAO,EAAE,qCAAqC;YAC9C,QAAQ,EAAE,CAAC;YACX,IAAI,EAAE,uBAAuB;SAC9B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4EAA4E,EAAE,KAAK,IAAI,EAAE;QAC1F,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC;QAErD,MAAM,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,GAAG,CAAC,CAAC;QAEhE,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;QAC1E,IAAI,WAAW,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;QACnF,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC;QAEzC,MAAM,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC;QAE5E,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/tool.test.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @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).
+ */
+export {};
+//# sourceMappingURL=tool.test.d.ts.map

package/dist/__tests__/tool.test.d.ts.map

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