@substrate-ai/factory 0.19.54

package/dist/scenarios/__tests__/integrity-pipeline.test.js

@@ -0,0 +1,318 @@
+/**
+ * Integration and unit tests for scenario integrity verification during pipeline runs.
+ * Story 44-4: Scenario Integrity Verification During Pipeline Runs.
+ *
+ * Tests:
+ * - AC1: Manifest captured once at run start when scenarioStore configured
+ * - AC2: verifyIntegrity() called before each tool node
+ * - AC3: Tampered (modified or deleted) file halts pipeline with scenario:integrity-failed
+ * - AC4: Unmodified scenarios emit scenario:integrity-passed and executor returns SUCCESS
+ * - AC5: Integrity check skipped for non-tool nodes
+ * - AC6: No scenarioStore → no discover(), no integrity events, backward-compatible
+ * - Unit: verifyIntegrity() delegates to verify()
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { mkdtempSync, rmSync, mkdirSync, writeFileSync, unlinkSync } from 'fs';
+import { tmpdir } from 'os';
+import { join } from 'path';
+import { parseGraph } from '../../graph/parser.js';
+import { createGraphExecutor } from '../../graph/executor.js';
+import { ScenarioStore } from '../store.js';
+import { makeEventSpy, makeMockRegistry, makeTmpDir, cleanDir, } from '../../__tests__/integration/helpers.js';
+// ---------------------------------------------------------------------------
+// Temp dir helpers
+// ---------------------------------------------------------------------------
+function createTmpDir() {
+    return mkdtempSync(join(tmpdir(), 'substrate-integrity-test-'));
+}
+function setupScenariosDir(projectRoot) {
+    const scenariosDir = join(projectRoot, '.substrate', 'scenarios');
+    mkdirSync(scenariosDir, { recursive: true });
+    return scenariosDir;
+}
+// ---------------------------------------------------------------------------
+// DOT graph fixtures
+// ---------------------------------------------------------------------------
+/** Minimal graph: start → tool node → exit */
+const TOOL_NODE_DOT = `
+digraph test_tool_integrity {
+  graph [goal="Integrity test"]
+  start [shape=Mdiamond]
+  tool1 [type=tool, label="Run scenario"]
+  exit [shape=Msquare]
+  start -> tool1
+  tool1 -> exit
+}
+`;
+/** Graph with two sequential tool nodes */
+const TWO_TOOL_NODES_DOT = `
+digraph test_two_tools {
+  graph [goal="Two tool nodes"]
+  start [shape=Mdiamond]
+  tool1 [type=tool, label="First scenario"]
+  tool2 [type=tool, label="Second scenario"]
+  exit [shape=Msquare]
+  start -> tool1
+  tool1 -> tool2
+  tool2 -> exit
+}
+`;
+/** Graph with no tool nodes: start → codergen → exit */
+const NO_TOOL_NODE_DOT = `
+digraph test_no_tool {
+  graph [goal="No tool node"]
+  start [shape=Mdiamond]
+  check [type=codergen, label="Check"]
+  exit [shape=Msquare]
+  start -> check
+  check -> exit
+}
+`;
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe('Scenario Integrity Verification (Story 44-4)', () => {
+    let tmpDir;
+    let logsRoot;
+    beforeEach(async () => {
+        tmpDir = createTmpDir();
+        logsRoot = await makeTmpDir();
+    });
+    afterEach(async () => {
+        rmSync(tmpDir, { recursive: true, force: true });
+        await cleanDir(logsRoot);
+        vi.restoreAllMocks();
+    });
+    // --------------------------------------------------------------------------
+    // Unit test: verifyIntegrity() delegates to verify()
+    // --------------------------------------------------------------------------
+    it('verifyIntegrity() delegates to verify() and returns same result', async () => {
+        const store = new ScenarioStore();
+        const scenariosDir = setupScenariosDir(tmpDir);
+        writeFileSync(join(scenariosDir, 'scenario-login.sh'), 'echo login');
+        const manifest = await store.discover(tmpDir);
+        const verifyResult = await store.verify(manifest);
+        const integrityResult = await store.verifyIntegrity(manifest);
+        expect(integrityResult).toEqual(verifyResult);
+        expect(integrityResult.valid).toBe(true);
+        expect(integrityResult.tampered).toEqual([]);
+    });
+    // --------------------------------------------------------------------------
+    // AC1: Manifest captured at pipeline start
+    // --------------------------------------------------------------------------
+    it('AC1: discover() called exactly once at run start when scenarioStore is configured', async () => {
+        const store = new ScenarioStore();
+        const discoverSpy = vi.spyOn(store, 'discover');
+        discoverSpy.mockResolvedValue({ scenarios: [], capturedAt: Date.now() });
+        const graph = parseGraph(TOOL_NODE_DOT);
+        const { registry } = makeMockRegistry();
+        const { bus } = makeEventSpy();
+        await createGraphExecutor().run(graph, {
+            runId: 'test-ac1',
+            logsRoot,
+            handlerRegistry: registry,
+            eventBus: bus,
+            scenarioStore: store,
+        });
+        expect(discoverSpy).toHaveBeenCalledTimes(1);
+    });
+    // --------------------------------------------------------------------------
+    // AC6: Backward-compatible — no scenarioStore means no integrity checks
+    // --------------------------------------------------------------------------
+    it('AC6: discover() NOT called when no scenarioStore configured', async () => {
+        const store = new ScenarioStore();
+        const discoverSpy = vi.spyOn(store, 'discover');
+        const graph = parseGraph(TOOL_NODE_DOT);
+        const { registry } = makeMockRegistry();
+        const { bus, events } = makeEventSpy();
+        const outcome = await createGraphExecutor().run(graph, {
+            runId: 'test-ac6',
+            logsRoot,
+            handlerRegistry: registry,
+            eventBus: bus,
+            // No scenarioStore — backward-compatible
+        });
+        expect(discoverSpy).not.toHaveBeenCalled();
+        expect(outcome.status).toBe('SUCCESS');
+        const integrityEvents = events.filter((e) => e.event === 'scenario:integrity-passed' || e.event === 'scenario:integrity-failed');
+        expect(integrityEvents).toHaveLength(0);
+    });
+    // --------------------------------------------------------------------------
+    // AC2: verifyIntegrity() called before each tool node
+    // --------------------------------------------------------------------------
+    it('AC2: verifyIntegrity() called once per tool node visit', async () => {
+        const store = new ScenarioStore();
+        vi.spyOn(store, 'discover').mockResolvedValue({ scenarios: [], capturedAt: Date.now() });
+        const verifySpy = vi.spyOn(store, 'verifyIntegrity');
+        verifySpy.mockResolvedValue({ valid: true, tampered: [] });
+        const graph = parseGraph(TWO_TOOL_NODES_DOT);
+        const { registry } = makeMockRegistry();
+        const { bus } = makeEventSpy();
+        await createGraphExecutor().run(graph, {
+            runId: 'test-ac2',
+            logsRoot,
+            handlerRegistry: registry,
+            eventBus: bus,
+            scenarioStore: store,
+        });
+        // Two tool nodes → verifyIntegrity called twice
+        expect(verifySpy).toHaveBeenCalledTimes(2);
+    });
+    // --------------------------------------------------------------------------
+    // AC3: Tampered scenario file halts pipeline with event
+    // --------------------------------------------------------------------------
+    it('AC3: modified scenario file → status FAIL + scenario:integrity-failed event', async () => {
+        const store = new ScenarioStore();
+        const scenariosDir = setupScenariosDir(tmpDir);
+        const scenarioFile = join(scenariosDir, 'scenario-login.sh');
+        writeFileSync(scenarioFile, 'echo login');
+        // Capture manifest before modification
+        const manifest = await store.discover(tmpDir);
+        // Modify the file to simulate tampering between iterations
+        writeFileSync(scenarioFile, 'echo TAMPERED');
+        // Mock discover() to return the original (pre-tamper) manifest
+        vi.spyOn(store, 'discover').mockResolvedValue(manifest);
+        const graph = parseGraph(TOOL_NODE_DOT);
+        const { registry } = makeMockRegistry();
+        const { bus, events } = makeEventSpy();
+        const outcome = await createGraphExecutor().run(graph, {
+            runId: 'test-ac3-modify',
+            logsRoot,
+            handlerRegistry: registry,
+            eventBus: bus,
+            scenarioStore: store,
+        });
+        expect(outcome.status).toBe('FAIL');
+        expect(outcome.failureReason).toContain('Scenario integrity violation');
+        expect(outcome.failureReason).toContain('scenario-login.sh');
+        const failedEvents = events.filter((e) => e.event === 'scenario:integrity-failed');
+        expect(failedEvents).toHaveLength(1);
+        const payload = failedEvents[0].payload;
+        expect(payload.runId).toBe('test-ac3-modify');
+        expect(payload.nodeId).toBe('tool1');
+        expect(payload.tampered).toContain('scenario-login.sh');
+    });
+    it('AC3: deleted scenario file → status FAIL + scenario:integrity-failed event', async () => {
+        const store = new ScenarioStore();
+        const scenariosDir = setupScenariosDir(tmpDir);
+        const scenarioFile = join(scenariosDir, 'scenario-deploy.sh');
+        writeFileSync(scenarioFile, 'echo deploy');
+        // Capture manifest before deletion
+        const manifest = await store.discover(tmpDir);
+        // Delete the file to simulate tampering
+        unlinkSync(scenarioFile);
+        // Mock discover() to return the original (pre-delete) manifest
+        vi.spyOn(store, 'discover').mockResolvedValue(manifest);
+        const graph = parseGraph(TOOL_NODE_DOT);
+        const { registry } = makeMockRegistry();
+        const { bus, events } = makeEventSpy();
+        const outcome = await createGraphExecutor().run(graph, {
+            runId: 'test-ac3-delete',
+            logsRoot,
+            handlerRegistry: registry,
+            eventBus: bus,
+            scenarioStore: store,
+        });
+        expect(outcome.status).toBe('FAIL');
+        expect(outcome.failureReason).toContain('scenario-deploy.sh');
+        const failedEvents = events.filter((e) => e.event === 'scenario:integrity-failed');
+        expect(failedEvents).toHaveLength(1);
+        const payload = failedEvents[0].payload;
+        expect(payload.tampered).toContain('scenario-deploy.sh');
+    });
+    // --------------------------------------------------------------------------
+    // AC4: Unmodified scenarios emit pass event and proceed
+    // --------------------------------------------------------------------------
+    it('AC4: unmodified scenarios → scenario:integrity-passed event + SUCCESS outcome', async () => {
+        const store = new ScenarioStore();
+        const scenariosDir = setupScenariosDir(tmpDir);
+        writeFileSync(join(scenariosDir, 'scenario-login.sh'), 'echo login');
+        // Capture the real manifest (files unmodified)
+        const realManifest = await store.discover(tmpDir);
+        vi.spyOn(store, 'discover').mockResolvedValue(realManifest);
+        const graph = parseGraph(TOOL_NODE_DOT);
+        const { registry } = makeMockRegistry();
+        const { bus, events } = makeEventSpy();
+        const outcome = await createGraphExecutor().run(graph, {
+            runId: 'test-ac4',
+            logsRoot,
+            handlerRegistry: registry,
+            eventBus: bus,
+            scenarioStore: store,
+        });
+        expect(outcome.status).toBe('SUCCESS');
+        const passedEvents = events.filter((e) => e.event === 'scenario:integrity-passed');
+        expect(passedEvents).toHaveLength(1);
+        const payload = passedEvents[0].payload;
+        expect(payload.runId).toBe('test-ac4');
+        expect(payload.nodeId).toBe('tool1');
+        expect(payload.scenarioCount).toBe(1);
+    });
+    // --------------------------------------------------------------------------
+    // AC5: Integrity check skipped for non-tool nodes
+    // --------------------------------------------------------------------------
+    it('AC5: verifyIntegrity() NOT called when graph has no tool nodes', async () => {
+        const store = new ScenarioStore();
+        vi.spyOn(store, 'discover').mockResolvedValue({ scenarios: [], capturedAt: Date.now() });
+        const verifySpy = vi.spyOn(store, 'verifyIntegrity');
+        const graph = parseGraph(NO_TOOL_NODE_DOT);
+        const { registry } = makeMockRegistry();
+        const { bus } = makeEventSpy();
+        const outcome = await createGraphExecutor().run(graph, {
+            runId: 'test-ac5',
+            logsRoot,
+            handlerRegistry: registry,
+            eventBus: bus,
+            scenarioStore: store,
+        });
+        expect(outcome.status).toBe('SUCCESS');
+        expect(verifySpy).not.toHaveBeenCalled();
+    });
+    // --------------------------------------------------------------------------
+    // Additional: graph:node-started not emitted when integrity check fails
+    // --------------------------------------------------------------------------
+    it('graph:node-started is NOT emitted for tool node when integrity check fails', async () => {
+        const store = new ScenarioStore();
+        const scenariosDir = setupScenariosDir(tmpDir);
+        const scenarioFile = join(scenariosDir, 'scenario-login.sh');
+        writeFileSync(scenarioFile, 'original content');
+        const manifest = await store.discover(tmpDir);
+        writeFileSync(scenarioFile, 'tampered content');
+        vi.spyOn(store, 'discover').mockResolvedValue(manifest);
+        const graph = parseGraph(TOOL_NODE_DOT);
+        const { registry } = makeMockRegistry();
+        const { bus, events } = makeEventSpy();
+        const outcome = await createGraphExecutor().run(graph, {
+            runId: 'test-no-node-started',
+            logsRoot,
+            handlerRegistry: registry,
+            eventBus: bus,
+            scenarioStore: store,
+        });
+        expect(outcome.status).toBe('FAIL');
+        // graph:node-started must NOT be emitted for the tool node
+        const nodeStartedForTool = events.filter((e) => e.event === 'graph:node-started' &&
+            e.payload.nodeId === 'tool1');
+        expect(nodeStartedForTool).toHaveLength(0);
+    });
+    // --------------------------------------------------------------------------
+    // Additional: scenario:integrity-failed not emitted when files unmodified
+    // --------------------------------------------------------------------------
+    it('scenario:integrity-failed is NOT emitted when files are unmodified', async () => {
+        const store = new ScenarioStore();
+        vi.spyOn(store, 'discover').mockResolvedValue({ scenarios: [], capturedAt: Date.now() });
+        const graph = parseGraph(TOOL_NODE_DOT);
+        const { registry } = makeMockRegistry();
+        const { bus, events } = makeEventSpy();
+        await createGraphExecutor().run(graph, {
+            runId: 'test-no-fail-event',
+            logsRoot,
+            handlerRegistry: registry,
+            eventBus: bus,
+            scenarioStore: store,
+        });
+        const failedEvents = events.filter((e) => e.event === 'scenario:integrity-failed');
+        expect(failedEvents).toHaveLength(0);
+    });
+});
+//# sourceMappingURL=integrity-pipeline.test.js.map

package/dist/scenarios/__tests__/integrity-pipeline.test.js.map

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

package/dist/scenarios/__tests__/runner-twins.test.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Unit tests for ScenarioRunner twin integration (story 47-3).
+ *
+ * Tests cover:
+ *  (a) startTwins called with correct names before scenario execution
+ *  (b) env vars from startTwins are injected into subprocess environment
+ *  (c) stopTwins called after all scenarios pass
+ *  (d) stopTwins called even when a scenario exits with non-zero code
+ *  (e) twin startup failure returns error ScenarioRunResult without executing any scenarios and without calling stopTwins
+ *  (f) manifest with no twins field triggers no coordinator calls
+ */
+export {};
+//# sourceMappingURL=runner-twins.test.d.ts.map

package/dist/scenarios/__tests__/runner-twins.test.d.ts.map

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

package/dist/scenarios/__tests__/runner-twins.test.js

@@ -0,0 +1,205 @@
+/**
+ * Unit tests for ScenarioRunner twin integration (story 47-3).
+ *
+ * Tests cover:
+ *  (a) startTwins called with correct names before scenario execution
+ *  (b) env vars from startTwins are injected into subprocess environment
+ *  (c) stopTwins called after all scenarios pass
+ *  (d) stopTwins called even when a scenario exits with non-zero code
+ *  (e) twin startup failure returns error ScenarioRunResult without executing any scenarios and without calling stopTwins
+ *  (f) manifest with no twins field triggers no coordinator calls
+ */
+import crypto from 'crypto';
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { createScenarioRunner } from '../runner.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+let tmpDir;
+function createTmpScript(content) {
+    const scriptPath = path.join(tmpDir, `scenario-${crypto.randomUUID()}.sh`);
+    fs.writeFileSync(scriptPath, content);
+    fs.chmodSync(scriptPath, 0o755);
+    const checksum = crypto.createHash('sha256').update(fs.readFileSync(scriptPath)).digest('hex');
+    return { scriptPath, checksum };
+}
+function makeMockCoordinator(overrides) {
+    return {
+        startTwins: vi.fn().mockResolvedValue({}),
+        stopTwins: vi.fn().mockResolvedValue(undefined),
+        ...overrides,
+    };
+}
+// ---------------------------------------------------------------------------
+// Setup / Teardown
+// ---------------------------------------------------------------------------
+beforeEach(() => {
+    tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'runner-twins-'));
+});
+afterEach(() => {
+    fs.rmSync(tmpDir, { recursive: true, force: true });
+});
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe('ScenarioRunner — twin integration', () => {
+    // (a) startTwins is called with correct twin names before scenario execution
+    it('(a) calls startTwins with the correct twin names before any scenario runs', async () => {
+        const callOrder = [];
+        const { scriptPath, checksum } = createTmpScript('#!/bin/sh\necho "{}"\nexit 0\n');
+        const scenarioName = path.basename(scriptPath);
+        const coordinator = {
+            startTwins: vi.fn().mockImplementation(async (names) => {
+                callOrder.push('startTwins:' + names.join(','));
+                return {};
+            }),
+            stopTwins: vi.fn().mockImplementation(async () => {
+                callOrder.push('stopTwins');
+            }),
+        };
+        const manifest = {
+            scenarios: [{ name: scenarioName, path: scriptPath, checksum }],
+            capturedAt: Date.now(),
+            twins: ['stripe', 'sendgrid'],
+        };
+        const runner = createScenarioRunner({ twinCoordinator: coordinator });
+        const result = await runner.run(manifest, tmpDir);
+        expect(coordinator.startTwins).toHaveBeenCalledWith(['stripe', 'sendgrid']);
+        expect(callOrder[0]).toBe('startTwins:stripe,sendgrid');
+        // startTwins must appear before stopTwins
+        expect(callOrder.indexOf('startTwins:stripe,sendgrid')).toBeLessThan(callOrder.indexOf('stopTwins'));
+        expect(result.summary.total).toBe(1);
+    });
+    // (b) env vars from startTwins are present in subprocess environment
+    it('(b) injects env vars from startTwins into scenario subprocess environment', async () => {
+        // Script prints an env var as JSON
+        const { scriptPath, checksum } = createTmpScript('#!/bin/sh\nprintf \'{"TWIN_INJECTED":"%s"}\' "$TWIN_URL"\n');
+        const scenarioName = path.basename(scriptPath);
+        const coordinator = makeMockCoordinator({
+            startTwins: vi.fn().mockResolvedValue({ TWIN_URL: 'http://localhost:9999' }),
+        });
+        const manifest = {
+            scenarios: [{ name: scenarioName, path: scriptPath, checksum }],
+            capturedAt: Date.now(),
+            twins: ['twin-service'],
+        };
+        const runner = createScenarioRunner({ twinCoordinator: coordinator });
+        const result = await runner.run(manifest, tmpDir);
+        expect(result.scenarios).toHaveLength(1);
+        const scenarioResult = result.scenarios[0];
+        expect(scenarioResult.status).toBe('pass');
+        expect(scenarioResult.parsedOutput).toEqual({ TWIN_INJECTED: 'http://localhost:9999' });
+    });
+    // (c) stopTwins is called after all scenarios pass
+    it('(c) calls stopTwins exactly once after all scenarios pass', async () => {
+        const { scriptPath, checksum } = createTmpScript('#!/bin/sh\necho "{}"\nexit 0\n');
+        const scenarioName = path.basename(scriptPath);
+        const coordinator = makeMockCoordinator();
+        const manifest = {
+            scenarios: [{ name: scenarioName, path: scriptPath, checksum }],
+            capturedAt: Date.now(),
+            twins: ['my-twin'],
+        };
+        const runner = createScenarioRunner({ twinCoordinator: coordinator });
+        const result = await runner.run(manifest, tmpDir);
+        expect(result.scenarios[0].status).toBe('pass');
+        expect(coordinator.stopTwins).toHaveBeenCalledTimes(1);
+    });
+    // (d) stopTwins is called even when a scenario exits with non-zero code
+    it('(d) calls stopTwins exactly once even when a scenario fails', async () => {
+        const { scriptPath, checksum } = createTmpScript('#!/bin/sh\nexit 1\n');
+        const scenarioName = path.basename(scriptPath);
+        const coordinator = makeMockCoordinator();
+        const manifest = {
+            scenarios: [{ name: scenarioName, path: scriptPath, checksum }],
+            capturedAt: Date.now(),
+            twins: ['my-twin'],
+        };
+        const runner = createScenarioRunner({ twinCoordinator: coordinator });
+        const result = await runner.run(manifest, tmpDir);
+        expect(result.scenarios[0].status).toBe('fail');
+        // stopTwins must be called regardless of scenario outcome
+        expect(coordinator.stopTwins).toHaveBeenCalledTimes(1);
+    });
+    // (e) startup failure: no scripts run, all results are fail, stopTwins not called
+    it('(e) returns error ScenarioRunResult on startup failure without running scenarios or calling stopTwins', async () => {
+        const { scriptPath, checksum } = createTmpScript('#!/bin/sh\necho "{}"\nexit 0\n');
+        const scenarioName = path.basename(scriptPath);
+        const coordinator = {
+            startTwins: vi.fn().mockRejectedValue(new Error('Docker not found — twins require Docker')),
+            stopTwins: vi.fn(),
+        };
+        const manifest = {
+            scenarios: [
+                { name: scenarioName, path: scriptPath, checksum },
+                { name: 'another.sh', path: scriptPath, checksum },
+            ],
+            capturedAt: Date.now(),
+            twins: ['stripe'],
+        };
+        const runner = createScenarioRunner({ twinCoordinator: coordinator });
+        const result = await runner.run(manifest, tmpDir);
+        // All scenarios should be failed
+        expect(result.summary.failed).toBe(2);
+        expect(result.summary.passed).toBe(0);
+        expect(result.scenarios).toHaveLength(2);
+        for (const s of result.scenarios) {
+            expect(s.status).toBe('fail');
+            expect(s.exitCode).toBe(-1);
+            expect(s.stderr).toContain('Docker not found');
+        }
+        // stopTwins must NOT be called (nothing was started)
+        expect(coordinator.stopTwins).not.toHaveBeenCalled();
+    });
+    // (f) no twins field — no coordinator calls, run completes normally
+    it('(f) does not call coordinator methods when manifest has no twins field', async () => {
+        const { scriptPath, checksum } = createTmpScript('#!/bin/sh\necho "{}"\nexit 0\n');
+        const scenarioName = path.basename(scriptPath);
+        const coordinator = makeMockCoordinator();
+        // No twins field at all
+        const manifest = {
+            scenarios: [{ name: scenarioName, path: scriptPath, checksum }],
+            capturedAt: Date.now(),
+        };
+        const runner = createScenarioRunner({ twinCoordinator: coordinator });
+        const result = await runner.run(manifest, tmpDir);
+        expect(coordinator.startTwins).not.toHaveBeenCalled();
+        expect(coordinator.stopTwins).not.toHaveBeenCalled();
+        expect(result.summary.total).toBe(1);
+        expect(result.scenarios[0].status).toBe('pass');
+    });
+    it('(f) does not call coordinator methods when manifest has twins: []', async () => {
+        const { scriptPath, checksum } = createTmpScript('#!/bin/sh\necho "{}"\nexit 0\n');
+        const scenarioName = path.basename(scriptPath);
+        const coordinator = makeMockCoordinator();
+        const manifest = {
+            scenarios: [{ name: scenarioName, path: scriptPath, checksum }],
+            capturedAt: Date.now(),
+            twins: [],
+        };
+        const runner = createScenarioRunner({ twinCoordinator: coordinator });
+        const result = await runner.run(manifest, tmpDir);
+        expect(coordinator.startTwins).not.toHaveBeenCalled();
+        expect(coordinator.stopTwins).not.toHaveBeenCalled();
+        expect(result.summary.total).toBe(1);
+    });
+    it('(f) does not call coordinator methods when no twinCoordinator is provided', async () => {
+        const { scriptPath, checksum } = createTmpScript('#!/bin/sh\necho "{}"\nexit 0\n');
+        const scenarioName = path.basename(scriptPath);
+        const manifest = {
+            scenarios: [{ name: scenarioName, path: scriptPath, checksum }],
+            capturedAt: Date.now(),
+            twins: ['stripe'],
+        };
+        // No twinCoordinator in options
+        const runner = createScenarioRunner();
+        const result = await runner.run(manifest, tmpDir);
+        // Should complete normally using existing code path
+        expect(result.summary.total).toBe(1);
+        expect(result.scenarios[0].status).toBe('pass');
+    });
+});
+//# sourceMappingURL=runner-twins.test.js.map

package/dist/scenarios/__tests__/runner-twins.test.js.map

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

package/dist/scenarios/__tests__/scorer.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Unit tests for the satisfaction scorer (story 44-5, 46-1).
+ *
+ * Covers:
+ *   AC3 — 3/4 pass → score 0.75, passes false (below 0.8 default threshold)
+ *   AC4 — 0/2 pass → score 0.0, passes false, status SUCCESS
+ *   AC7 — computeSatisfactionScore exported and accepts optional threshold
+ *   AC1–AC7 (story 46-1) — createSatisfactionScorer with weighted scoring + breakdown
+ */
+export {};
+//# sourceMappingURL=scorer.test.d.ts.map

package/dist/scenarios/__tests__/scorer.test.d.ts.map

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