@opensip-cli/simulation 0.1.0

package/dist/persistence/session-replay.js

@@ -0,0 +1,76 @@
+import { decodeSessionPayload } from '@opensip-cli/session-store';
+/**
+ * Project a stored sim session back into a {@link SignalEnvelope}/{@link SimDoneResult}.
+ *
+ * The structural decode of the opaque payload is shared across tools
+ * (`decodeSessionPayload`); this function owns only sim's projection
+ * (`tool: 'sim'`, `category: 'testing'`, signal id prefix, `sim-done` result).
+ *
+ * @throws {Error | TypeError} when the stored payload is not the expected shape
+ *   (propagated from `decodeSessionPayload`).
+ */
+export function simReplayFromSession(stored) {
+    const payload = decodeSessionPayload(stored.payload, {
+        tool: 'sim',
+        requireViolationCount: true,
+    });
+    const units = payload.checks.map((check) => ({
+        slug: check.checkSlug,
+        passed: check.passed,
+        ...(check.violationCount === undefined ? {} : { violationCount: check.violationCount }),
+        durationMs: check.durationMs,
+    }));
+    const signals = payload.checks.flatMap((check, checkIndex) => check.findings.map((finding, findingIndex) => replaySignal(stored, check.checkSlug, finding, checkIndex, findingIndex)));
+    const envelope = {
+        schemaVersion: 2,
+        tool: 'sim',
+        runId: stored.id,
+        createdAt: stored.startedAt,
+        ...(stored.recipe === undefined ? {} : { recipe: stored.recipe }),
+        verdict: {
+            score: stored.score,
+            passed: stored.passed,
+            summary: payload.summary,
+        },
+        units,
+        signals,
+    };
+    return {
+        fidelity: 'projection',
+        envelope,
+        result: {
+            type: 'sim-done',
+            recipeName: stored.recipe ?? 'default',
+            cwd: stored.cwd,
+            durationMs: stored.durationMs,
+            envelope,
+        },
+    };
+}
+function replaySignal(stored, source, finding, checkIndex, findingIndex) {
+    return {
+        id: `${stored.id}:sim:${checkIndex}:${findingIndex}`,
+        source,
+        provider: 'opensip-cli',
+        severity: finding.severity === 'error' ? 'high' : 'medium',
+        category: 'testing',
+        ruleId: finding.ruleId,
+        message: finding.message,
+        ...(finding.suggestion === undefined ? {} : { suggestion: finding.suggestion }),
+        filePath: finding.filePath ?? '',
+        ...(finding.line === undefined ? {} : { line: finding.line }),
+        ...(finding.column === undefined ? {} : { column: finding.column }),
+        ...(finding.filePath === undefined
+            ? {}
+            : {
+                code: {
+                    file: finding.filePath,
+                    ...(finding.line === undefined ? {} : { line: finding.line }),
+                    ...(finding.column === undefined ? {} : { column: finding.column }),
+                },
+            }),
+        metadata: {},
+        createdAt: stored.startedAt,
+    };
+}
+//# sourceMappingURL=session-replay.js.map

package/dist/persistence/session-replay.js.map

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

package/dist/persistence/session-replay.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Unit tests for {@link simReplayFromSession} (coverage gap).
+ *
+ * `session-payload.ts` (encode) and `session-replay.ts` (decode) are inverses,
+ * so the happy path is a round-trip: a real {@link SignalEnvelope} →
+ * `buildSimulationSessionPayload` → stored payload → `simReplayFromSession`.
+ * The remaining tests drive each validation branch with malformed payloads.
+ */
+export {};
+//# sourceMappingURL=session-replay.test.d.ts.map

package/dist/persistence/session-replay.test.d.ts.map

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

package/dist/persistence/session-replay.test.js

@@ -0,0 +1,169 @@
+/**
+ * Unit tests for {@link simReplayFromSession} (coverage gap).
+ *
+ * `session-payload.ts` (encode) and `session-replay.ts` (decode) are inverses,
+ * so the happy path is a round-trip: a real {@link SignalEnvelope} →
+ * `buildSimulationSessionPayload` → stored payload → `simReplayFromSession`.
+ * The remaining tests drive each validation branch with malformed payloads.
+ */
+import { buildSignalEnvelope } from '@opensip-cli/contracts';
+import { createSignal, HOST_VERDICT_POLICY_FALLBACK } from '@opensip-cli/core';
+import { describe, expect, it } from 'vitest';
+import { buildSimulationSessionPayload } from './session-payload.js';
+import { simReplayFromSession } from './session-replay.js';
+function storedSession(payload, overrides = {}) {
+    return {
+        id: 'SIM_1',
+        tool: 'sim',
+        cwd: '/repo',
+        startedAt: '2026-06-08T00:00:00.000Z',
+        completedAt: '2026-06-08T00:00:00.000Z',
+        score: 75,
+        passed: false,
+        durationMs: 120,
+        payload,
+        ...overrides,
+    };
+}
+function realPayload() {
+    const env = buildSignalEnvelope({
+        tool: 'sim',
+        runId: 'RUN_test',
+        createdAt: '2026-06-08T00:00:00.000Z',
+        policy: HOST_VERDICT_POLICY_FALLBACK,
+        runFaulted: false,
+        units: [
+            { slug: 'latency', passed: false, violationCount: 1, durationMs: 10 },
+            { slug: 'clean', passed: true, durationMs: 2 },
+        ],
+        signals: [
+            createSignal({
+                source: 'latency',
+                severity: 'critical',
+                ruleId: 'sim:latency',
+                message: 'too slow',
+                code: { file: 'svc.ts', line: 7, column: 1 },
+                suggestion: 'add a cache',
+            }),
+            createSignal({
+                source: 'latency',
+                severity: 'low',
+                ruleId: 'sim:latency2',
+                message: 'minor jitter',
+            }),
+        ],
+    });
+    return buildSimulationSessionPayload(env);
+}
+describe('simReplayFromSession', () => {
+    it('round-trips a stored payload back into a projection envelope + sim-done result', () => {
+        const replay = simReplayFromSession(storedSession(realPayload()));
+        expect(replay.fidelity).toBe('projection');
+        expect(replay.envelope.tool).toBe('sim');
+        expect(replay.envelope.runId).toBe('SIM_1');
+        expect(replay.envelope.units.map((u) => u.slug)).toEqual(['latency', 'clean']);
+        expect(replay.envelope.signals.map((s) => s.severity)).toEqual(['high', 'medium']);
+        const located = replay.envelope.signals.find((s) => s.ruleId === 'sim:latency');
+        expect(located?.code).toEqual({ file: 'svc.ts', line: 7, column: 1 });
+        expect(located?.suggestion).toBe('add a cache');
+        expect(replay.result.type).toBe('sim-done');
+        expect(replay.result.cwd).toBe('/repo');
+        expect(replay.result.durationMs).toBe(120);
+    });
+    it('names the recipe when present and carries it onto the envelope', () => {
+        const replay = simReplayFromSession(storedSession(realPayload(), { recipe: 'example' }));
+        expect(replay.envelope.recipe).toBe('example');
+        expect(replay.result.recipeName).toBe('example');
+    });
+    it("falls back to 'default' recipe name when no recipe is set", () => {
+        const replay = simReplayFromSession(storedSession(realPayload()));
+        expect(replay.envelope.recipe).toBeUndefined();
+        expect(replay.result.recipeName).toBe('default');
+    });
+    it('preserves a finding with no optional location fields', () => {
+        const payload = {
+            summary: { total: 1, passed: 0, failed: 1, errors: 1, warnings: 0 },
+            checks: [
+                {
+                    checkSlug: 'a',
+                    passed: false,
+                    violationCount: 1,
+                    durationMs: 1,
+                    findings: [{ ruleId: 'r', message: 'm', severity: 'error' }],
+                },
+            ],
+        };
+        const replay = simReplayFromSession(storedSession(payload));
+        const signal = replay.envelope.signals[0];
+        expect(signal?.filePath).toBe('');
+        expect(signal?.line).toBeUndefined();
+        expect(signal?.code).toBeUndefined();
+    });
+    describe('payload validation', () => {
+        const cases = [
+            { name: 'null payload', payload: null, message: /no replay payload/ },
+            { name: 'missing summary', payload: { checks: [] }, message: /summary is missing/ },
+            {
+                name: 'non-number summary field',
+                payload: {
+                    summary: { total: 'x', passed: 0, failed: 0, errors: 0, warnings: 0 },
+                    checks: [],
+                },
+                message: /total must be a number/,
+            },
+            {
+                name: 'missing checks[]',
+                payload: { summary: { total: 0, passed: 0, failed: 0, errors: 0, warnings: 0 } },
+                message: /missing checks\[\]/,
+            },
+            {
+                name: 'invalid check row',
+                payload: {
+                    summary: { total: 0, passed: 0, failed: 0, errors: 0, warnings: 0 },
+                    checks: [null],
+                },
+                message: /check row is invalid/,
+            },
+            {
+                name: 'check missing findings[]',
+                payload: {
+                    summary: { total: 0, passed: 0, failed: 0, errors: 0, warnings: 0 },
+                    checks: [{ checkSlug: 'a', passed: true, violationCount: 0, durationMs: 1 }],
+                },
+                message: /missing findings\[\]/,
+            },
+            {
+                name: 'invalid finding row',
+                payload: {
+                    summary: { total: 0, passed: 0, failed: 0, errors: 0, warnings: 0 },
+                    checks: [
+                        { checkSlug: 'a', passed: true, violationCount: 1, durationMs: 1, findings: [42] },
+                    ],
+                },
+                message: /finding is invalid/,
+            },
+            {
+                name: 'invalid finding severity',
+                payload: {
+                    summary: { total: 0, passed: 0, failed: 0, errors: 0, warnings: 0 },
+                    checks: [
+                        {
+                            checkSlug: 'a',
+                            passed: true,
+                            violationCount: 1,
+                            durationMs: 1,
+                            findings: [{ ruleId: 'r', message: 'm', severity: 'info' }],
+                        },
+                    ],
+                },
+                message: /invalid severity/,
+            },
+        ];
+        for (const { name, payload, message } of cases) {
+            it(`throws on ${name}`, () => {
+                expect(() => simReplayFromSession(storedSession(payload))).toThrow(message);
+            });
+        }
+    });
+});
+//# sourceMappingURL=session-replay.test.js.map

package/dist/persistence/session-replay.test.js.map

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

package/dist/plugins/__tests__/loader-scenarios.test.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @fileoverview Covers the simulation plugin loader's SCENARIO registration
+ * path (the recipe path is covered by ../../__tests__/plugin-loader.test.ts).
+ *
+ * A discovered `.mjs` plugin that exports a `scenarios` array drives
+ * `registerScenariosArray` → `isValidScenario` → `tryRegisterScenario`. We
+ * assert the real behaviour: well-shaped scenarios register into the live
+ * scope registry, malformed items are skipped (not registered, not fatal), and
+ * a non-array `scenarios` export is rejected without registering anything.
+ */
+export {};
+//# sourceMappingURL=loader-scenarios.test.d.ts.map

package/dist/plugins/__tests__/loader-scenarios.test.d.ts.map

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

package/dist/plugins/__tests__/loader-scenarios.test.js

@@ -0,0 +1,61 @@
+/**
+ * @fileoverview Covers the simulation plugin loader's SCENARIO registration
+ * path (the recipe path is covered by ../../__tests__/plugin-loader.test.ts).
+ *
+ * A discovered `.mjs` plugin that exports a `scenarios` array drives
+ * `registerScenariosArray` → `isValidScenario` → `tryRegisterScenario`. We
+ * assert the real behaviour: well-shaped scenarios register into the live
+ * scope registry, malformed items are skipped (not registered, not fatal), and
+ * a non-array `scenarios` export is rejected without registering anything.
+ */
+import { mkdtempSync, mkdirSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { enterScope, RunScope } from '@opensip-cli/core';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { currentScenarioRegistry } from '../../framework/registry.js';
+import { simulationTool } from '../../tool.js';
+import { loadAllSimPlugins } from '../loader.js';
+let testDir;
+beforeEach(() => {
+    const scope = new RunScope();
+    Object.assign(scope, simulationTool.contributeScope?.() ?? {});
+    enterScope(scope);
+    testDir = mkdtempSync(join(tmpdir(), 'sim-loader-scenarios-'));
+});
+afterEach(() => {
+    rmSync(testDir, { recursive: true, force: true });
+});
+function writeScenarioPlugin(body) {
+    const dir = join(testDir, 'opensip-cli', 'sim', 'scenarios');
+    mkdirSync(dir, { recursive: true });
+    writeFileSync(join(dir, 'plugin.mjs'), body);
+}
+describe('loadAllSimPlugins — scenario registration', () => {
+    it('registers well-shaped scenarios from a plugin export into the scope registry', async () => {
+        writeScenarioPlugin('export const scenarios = [' +
+            '{ id: "plug-load-1", name: "plug-load-1", kind: "load", tags: [], run: async () => ({ kind: "load", scenarioId: "plug-load-1", passed: true, durationMs: 0, signals: [] }) }' +
+            '];\n');
+        const result = await loadAllSimPlugins(testDir);
+        expect(result.totals.scenarios).toBe(1);
+        expect(currentScenarioRegistry().get('plug-load-1')).toBeDefined();
+    });
+    it('skips malformed scenario items but still registers the valid ones', async () => {
+        writeScenarioPlugin('export const scenarios = [' +
+            '{ id: "missing-run" },' + // not a valid RunnableScenario (no kind/run) → skipped
+            '{ id: "plug-load-2", name: "plug-load-2", kind: "load", tags: [], run: async () => ({ kind: "load", scenarioId: "plug-load-2", passed: true, durationMs: 0, signals: [] }) }' +
+            '];\n');
+        const result = await loadAllSimPlugins(testDir);
+        // Only the well-shaped scenario registers; the malformed item is dropped.
+        expect(result.totals.scenarios).toBe(1);
+        expect(currentScenarioRegistry().get('plug-load-2')).toBeDefined();
+        expect(currentScenarioRegistry().get('missing-run')).toBeUndefined();
+    });
+    it('rejects a non-array scenarios export without registering anything', async () => {
+        writeScenarioPlugin('export const scenarios = "not-an-array";\n');
+        const result = await loadAllSimPlugins(testDir);
+        expect(result.totals.scenarios ?? 0).toBe(0);
+        expect(currentScenarioRegistry().size).toBe(0);
+    });
+});
+//# sourceMappingURL=loader-scenarios.test.js.map

package/dist/plugins/__tests__/loader-scenarios.test.js.map

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

package/dist/plugins/__tests__/scenario-package-discovery.test.d.ts

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

package/dist/plugins/__tests__/scenario-package-discovery.test.d.ts.map

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

package/dist/plugins/__tests__/scenario-package-discovery.test.js

@@ -0,0 +1,43 @@
+import { mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { readScenarioPackagePreferences } from '../scenario-package-discovery.js';
+let testDir;
+beforeEach(() => {
+    testDir = mkdtempSync(join(tmpdir(), 'opensip-scenario-pkg-disc-'));
+});
+afterEach(() => {
+    rmSync(testDir, { recursive: true, force: true });
+});
+describe('readScenarioPackagePreferences', () => {
+    it('reads scenarioPackages and autoDiscoverScenarios from project config', () => {
+        writeFileSync(join(testDir, 'opensip-cli.config.yml'), `plugins:
+  scenarioPackages:
+    - "@opensip-cli/scenarios-load-default"
+  autoDiscoverScenarios: false
+`);
+        const prefs = readScenarioPackagePreferences(testDir);
+        expect(prefs.scenarioPackages).toEqual(['@opensip-cli/scenarios-load-default']);
+        expect(prefs.autoDiscoverScenarios).toBe(false);
+    });
+    it('reads packageScopes from project config', () => {
+        writeFileSync(join(testDir, 'opensip-cli.config.yml'), `plugins:
+  packageScopes:
+    - "@acme"
+    - "@my-org"
+`);
+        const prefs = readScenarioPackagePreferences(testDir);
+        expect(prefs.packageScopes).toEqual(['@acme', '@my-org']);
+    });
+    it('returns empty object when config has no plugins section', () => {
+        writeFileSync(join(testDir, 'opensip-cli.config.yml'), `simulation: { enabled: true }
+`);
+        const prefs = readScenarioPackagePreferences(testDir);
+        expect(prefs).toEqual({});
+    });
+    it('returns empty object when no config file exists', () => {
+        expect(readScenarioPackagePreferences(testDir)).toEqual({});
+    });
+});
+//# sourceMappingURL=scenario-package-discovery.test.js.map

package/dist/plugins/__tests__/scenario-package-discovery.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario-package-discovery.test.js","sourceRoot":"","sources":["../../../src/plugins/__tests__/scenario-package-discovery.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAErE,OAAO,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AAElF,IAAI,OAAe,CAAC;AAEpB,UAAU,CAAC,GAAG,EAAE;IACd,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,4BAA4B,CAAC,CAAC,CAAC;AACtE,CAAC,CAAC,CAAC;AAEH,SAAS,CAAC,GAAG,EAAE;IACb,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACpD,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,gCAAgC,EAAE,GAAG,EAAE;IAC9C,EAAE,CAAC,sEAAsE,EAAE,GAAG,EAAE;QAC9E,aAAa,CACX,IAAI,CAAC,OAAO,EAAE,wBAAwB,CAAC,EACvC;;;;CAIL,CACI,CAAC;QACF,MAAM,KAAK,GAAG,8BAA8B,CAAC,OAAO,CAAC,CAAC;QACtD,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,OAAO,CAAC,CAAC,qCAAqC,CAAC,CAAC,CAAC;QAChF,MAAM,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,aAAa,CACX,IAAI,CAAC,OAAO,EAAE,wBAAwB,CAAC,EACvC;;;;CAIL,CACI,CAAC;QACF,MAAM,KAAK,GAAG,8BAA8B,CAAC,OAAO,CAAC,CAAC;QACtD,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,aAAa,CACX,IAAI,CAAC,OAAO,EAAE,wBAAwB,CAAC,EACvC;CACL,CACI,CAAC;QACF,MAAM,KAAK,GAAG,8BAA8B,CAAC,OAAO,CAAC,CAAC;QACtD,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,CAAC,8BAA8B,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/plugins/loader.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @fileoverview Simulation plugin loader — adapter over core's generic
+ * loader.
+ *
+ * Core owns the discovery, dynamic-import, error-wrap, and log
+ * machinery. This file supplies the sim-specific `registerExports`
+ * callback that knows how to interpret a `SimPluginExports`-shaped
+ * module: both `scenarios: RunnableScenario[]` and
+ * `recipes: SimulationRecipe[]` are explicit arrays — the loader walks
+ * each and registers items into the simulation registries. There is no
+ * import-side-effect channel.
+ *
+ * Public API: `loadAllSimPlugins(projectDir)` — the sim equivalent of
+ * fitness's `loadAllPlugins('fit', projectDir)`.
+ */
+import type { PluginLayout, PluginLoadResult } from '@opensip-cli/core';
+/**
+ * Simulation's project-local plugin layout — user scenarios/recipes live
+ * under `<project>/opensip-cli/sim/{scenarios,recipes}/`. Exported so
+ * the `simulationTool` descriptor (`Tool.pluginLayout`) and the CLI's
+ * `plugin` command share one source of truth (ADR-0009 corollary 1).
+ */
+export declare const SIM_PLUGIN_LAYOUT: PluginLayout;
+/**
+ * Discover and load every sim-domain plugin for a project. Plugins
+ * are loaded sequentially to keep registration order deterministic.
+ *
+ * Without `projectDir`, no plugins are discovered — there is no
+ * user-global fallback, by design.
+ */
+export declare function loadAllSimPlugins(projectDir?: string): Promise<PluginLoadResult>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/plugins/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/plugins/loader.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;GAcG;AAUH,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAGjB,MAAM,mBAAmB,CAAC;AAE3B;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,YAG/B,CAAC;AAkGF;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAEtF"}

package/dist/plugins/loader.js

@@ -0,0 +1,119 @@
+// @fitness-ignore-file error-handling-quality -- tryRegisterRecipe/tryRegisterScenario translate registry throws (duplicate-id collisions) into a boolean "not newly registered" return per their documented JSDoc contract; the registry's own logging/duplicate policy is the source of truth, this layer just surfaces it as a flag.
+/**
+ * @fileoverview Simulation plugin loader — adapter over core's generic
+ * loader.
+ *
+ * Core owns the discovery, dynamic-import, error-wrap, and log
+ * machinery. This file supplies the sim-specific `registerExports`
+ * callback that knows how to interpret a `SimPluginExports`-shaped
+ * module: both `scenarios: RunnableScenario[]` and
+ * `recipes: SimulationRecipe[]` are explicit arrays — the loader walks
+ * each and registers items into the simulation registries. There is no
+ * import-side-effect channel.
+ *
+ * Public API: `loadAllSimPlugins(projectDir)` — the sim equivalent of
+ * fitness's `loadAllPlugins('fit', projectDir)`.
+ */
+import { loadAllPlugins } from '@opensip-cli/core';
+import { currentScenarioRegistry } from '../framework/registry.js';
+import { currentSimulationRecipeRegistry } from '../recipes/registry.js';
+/**
+ * Simulation's project-local plugin layout — user scenarios/recipes live
+ * under `<project>/opensip-cli/sim/{scenarios,recipes}/`. Exported so
+ * the `simulationTool` descriptor (`Tool.pluginLayout`) and the CLI's
+ * `plugin` command share one source of truth (ADR-0009 corollary 1).
+ */
+export const SIM_PLUGIN_LAYOUT = {
+    domain: 'sim',
+    userSubdirs: ['scenarios', 'recipes'],
+};
+/** Register one recipe; returns true if newly registered. Duplicate
+ *  recipes throw — caught here and reported as not-newly-registered,
+ *  matching the prior behavior of silently skipping duplicates. */
+function tryRegisterRecipe(recipe) {
+    try {
+        currentSimulationRecipeRegistry().register(recipe, { allowOverwrite: false });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Register one scenario; returns true if newly registered. Duplicate
+ *  scenarios (same id) silently skip via the registry's
+ *  `duplicatePolicy: 'silent-skip'`. A name-collision with a different
+ *  id throws — surfaced to the caller as `false`. */
+function tryRegisterScenario(scenario) {
+    const registry = currentScenarioRegistry();
+    const before = registry.size;
+    try {
+        registry.register(scenario);
+    }
+    catch {
+        return false;
+    }
+    return registry.size > before;
+}
+function isValidRecipe(value) {
+    return value !== null && typeof value === 'object' && 'id' in value && 'name' in value;
+}
+function isValidScenario(value) {
+    return (value !== null &&
+        typeof value === 'object' &&
+        'id' in value &&
+        'kind' in value &&
+        'run' in value);
+}
+function registerScenariosArray(scenariosField, ctx) {
+    if (scenariosField === undefined)
+        return 0;
+    if (!Array.isArray(scenariosField)) {
+        ctx.warn('plugin.loader.invalid_scenarios_export', `Plugin "${ctx.plugin.namespace}" exports "scenarios" but it is not an array — skipping scenario registration.`);
+        return 0;
+    }
+    let scenariosRegistered = 0;
+    for (const [index, scenario] of scenariosField.entries()) {
+        if (!isValidScenario(scenario)) {
+            ctx.warn('plugin.loader.invalid_scenario_item', `Plugin "${ctx.plugin.namespace}" scenarios[${index}] is not a valid RunnableScenario (missing id, kind, or run) — skipping.`, { index });
+            continue;
+        }
+        if (tryRegisterScenario(scenario))
+            scenariosRegistered++;
+    }
+    return scenariosRegistered;
+}
+function registerRecipesArray(recipesField, ctx) {
+    if (recipesField === undefined)
+        return 0;
+    if (!Array.isArray(recipesField)) {
+        ctx.warn('plugin.loader.invalid_recipes_export', `Plugin "${ctx.plugin.namespace}" exports "recipes" but it is not an array — skipping recipe registration.`);
+        return 0;
+    }
+    let recipesRegistered = 0;
+    for (const [index, recipe] of recipesField.entries()) {
+        if (!isValidRecipe(recipe)) {
+            ctx.warn('plugin.loader.invalid_recipe_item', `Plugin "${ctx.plugin.namespace}" recipes[${index}] is not a valid SimulationRecipe (missing id or name) — skipping.`, { index });
+            continue;
+        }
+        if (tryRegisterRecipe(recipe))
+            recipesRegistered++;
+    }
+    return recipesRegistered;
+}
+function registerSimExports(mod, ctx) {
+    const exports = mod;
+    const scenariosRegistered = registerScenariosArray(exports.scenarios, ctx);
+    const recipesRegistered = registerRecipesArray(exports.recipes, ctx);
+    return { scenarios: scenariosRegistered, recipes: recipesRegistered };
+}
+/**
+ * Discover and load every sim-domain plugin for a project. Plugins
+ * are loaded sequentially to keep registration order deterministic.
+ *
+ * Without `projectDir`, no plugins are discovered — there is no
+ * user-global fallback, by design.
+ */
+export async function loadAllSimPlugins(projectDir) {
+    return loadAllPlugins(SIM_PLUGIN_LAYOUT, projectDir, registerSimExports);
+}
+//# sourceMappingURL=loader.js.map

package/dist/plugins/loader.js.map

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

package/dist/plugins/scenario-package-discovery.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @fileoverview The `plugins.{scenarioPackages,autoDiscoverScenarios,packageScopes}`
+ * preference reader.
+ *
+ * Scenario-pack discovery + resolution (the `<scope>/scenarios-*` name-pattern
+ * walk, scope merging, explicit-name resolution, the single-core guard) lives in
+ * the GENERIC capability substrate (`@opensip-cli/core`) now. This module keeps
+ * only the sim-side reader for the documented config keys — sim resolves its own
+ * preference without depending on `@opensip-cli/config`, then hands the result
+ * to the generic loader.
+ */
+/**
+ * Read `plugins.scenarioPackages`, `plugins.autoDiscoverScenarios`, and
+ * `plugins.packageScopes` from the project's opensip-cli.config.yml without a
+ * full schema parse. Mirrors the inline-yaml-read pattern used by
+ * `readProjectPluginsList()`.
+ */
+export declare function readScenarioPackagePreferences(projectDir: string): {
+    readonly scenarioPackages?: readonly string[];
+    readonly autoDiscoverScenarios?: boolean;
+    readonly packageScopes?: readonly string[];
+};
+//# sourceMappingURL=scenario-package-discovery.d.ts.map

package/dist/plugins/scenario-package-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario-package-discovery.d.ts","sourceRoot":"","sources":["../../src/plugins/scenario-package-discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,UAAU,EAAE,MAAM,GAAG;IAClE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9C,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IACzC,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C,CAsBA"}