@substrate-ai/factory 0.19.54

package/dist/twins/__tests__/integration/e2e.test.d.ts

@@ -0,0 +1,18 @@
+/**
+ * End-to-end assembly tests for Epic 47 — Digital Twin Foundation.
+ *
+ * Assembles all Epic 47 components in a single test environment:
+ *  - TwinRegistry (in-memory, mock coordinator)
+ *  - TwinPersistenceCoordinator → MemoryDatabaseAdapter
+ *  - TwinHealthMonitor (no real health URL — no timers fired)
+ *  - ScenarioRunner with injected twinCoordinator and twinHealthMonitor
+ *
+ * Verifies:
+ *  1. Full pipeline — scenario passes, twin:stopped persisted to DB
+ *  2. Full pipeline — scenario fails, stop still called
+ *  3. No twins in manifest — no coordinator methods called
+ *
+ * Story 47-8, Task 5 (AC6).
+ */
+export {};
+//# sourceMappingURL=e2e.test.d.ts.map

package/dist/twins/__tests__/integration/e2e.test.d.ts.map

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

package/dist/twins/__tests__/integration/e2e.test.js

@@ -0,0 +1,146 @@
+/**
+ * End-to-end assembly tests for Epic 47 — Digital Twin Foundation.
+ *
+ * Assembles all Epic 47 components in a single test environment:
+ *  - TwinRegistry (in-memory, mock coordinator)
+ *  - TwinPersistenceCoordinator → MemoryDatabaseAdapter
+ *  - TwinHealthMonitor (no real health URL — no timers fired)
+ *  - ScenarioRunner with injected twinCoordinator and twinHealthMonitor
+ *
+ * Verifies:
+ *  1. Full pipeline — scenario passes, twin:stopped persisted to DB
+ *  2. Full pipeline — scenario fails, stop still called
+ *  3. No twins in manifest — no coordinator methods called
+ *
+ * Story 47-8, Task 5 (AC6).
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { createDatabaseAdapter, TypedEventBusImpl } from '@substrate-ai/core';
+import { factorySchema } from '../../../persistence/factory-schema.js';
+import { createTwinPersistenceCoordinator, getTwinRunsForRun } from '../../persistence.js';
+import { createTwinHealthMonitor } from '../../health-monitor.js';
+import { createScenarioRunner } from '../../../scenarios/runner.js';
+import { makeMockTwinManager, makeTmpScenario } from './helpers.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Flush async event-bus handlers by yielding to the macrotask queue. */
+const nextTick = () => new Promise((resolve) => setTimeout(resolve, 0));
+/** A TwinDefinition without a healthcheck URL — prevents health monitor from scheduling polls. */
+function makeLocalstackNoHealthcheck() {
+    return {
+        name: 'localstack',
+        image: 'localstack/localstack:latest',
+        ports: [{ host: 4566, container: 4566 }],
+        environment: { SERVICES: 's3' },
+    };
+}
+// ---------------------------------------------------------------------------
+// Setup / Teardown
+// ---------------------------------------------------------------------------
+let adapter;
+let eventBus;
+let cleanupFn = null;
+const TEST_RUN_ID = 'e2e-run-001';
+beforeEach(async () => {
+    adapter = createDatabaseAdapter({ backend: 'memory' });
+    await factorySchema(adapter);
+    eventBus = new TypedEventBusImpl();
+    createTwinPersistenceCoordinator(adapter, eventBus);
+    cleanupFn = null;
+});
+afterEach(() => {
+    cleanupFn?.();
+    cleanupFn = null;
+});
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe('e2e assembly — all Epic 47 components', () => {
+    it('Test 1 — full pipeline, scenario passes, twin:stopped persisted to DB', async () => {
+        const mockManager = makeMockTwinManager();
+        const coordinator = {
+            startTwins: vi.fn().mockImplementation(async () => {
+                await mockManager.start([]);
+                // Emit twin:started so TwinPersistenceCoordinator can insert the run record
+                eventBus.emit('twin:started', {
+                    twinName: 'localstack',
+                    ports: [{ host: 4566, container: 4566 }],
+                    healthStatus: 'healthy',
+                    runId: TEST_RUN_ID,
+                });
+                return { LOCALSTACK_URL: 'http://localhost:4566' };
+            }),
+            stopTwins: vi.fn().mockImplementation(async () => {
+                await mockManager.stop();
+            }),
+        };
+        // Real health monitor with no health URL — no intervals scheduled
+        const healthMonitor = createTwinHealthMonitor(eventBus, { monitorIntervalMs: 60000 });
+        healthMonitor.start([makeLocalstackNoHealthcheck()]);
+        const runner = createScenarioRunner({
+            twinCoordinator: coordinator,
+            twinHealthMonitor: healthMonitor,
+        });
+        const { manifest, cleanup } = makeTmpScenario(['localstack'], 0);
+        cleanupFn = cleanup;
+        const result = await runner.run(manifest, process.cwd());
+        expect(result.summary.passed).toBe(1);
+        // Wait for insertTwinRun to complete (fired by twin:started during startTwins)
+        await nextTick();
+        // Manually emit twin:stopped (simulating what a real TwinManager.stop() would emit)
+        eventBus.emit('twin:stopped', { twinName: 'localstack' });
+        await nextTick();
+        const summaries = await getTwinRunsForRun(adapter, TEST_RUN_ID);
+        expect(summaries).toHaveLength(1);
+        expect(summaries[0].status).toBe('stopped');
+        healthMonitor.stop();
+    });
+    it('Test 2 — full pipeline, scenario fails, stopTwins still called once', async () => {
+        const mockManager = makeMockTwinManager();
+        const coordinator = {
+            startTwins: vi.fn().mockImplementation(async () => {
+                await mockManager.start([]);
+                return {};
+            }),
+            stopTwins: vi.fn().mockImplementation(async () => {
+                await mockManager.stop();
+            }),
+        };
+        const healthMonitor = createTwinHealthMonitor(eventBus, { monitorIntervalMs: 60000 });
+        healthMonitor.start([makeLocalstackNoHealthcheck()]);
+        const runner = createScenarioRunner({
+            twinCoordinator: coordinator,
+            twinHealthMonitor: healthMonitor,
+        });
+        const { manifest, cleanup } = makeTmpScenario(['localstack'], 1);
+        cleanupFn = cleanup;
+        const result = await runner.run(manifest, process.cwd());
+        expect(result.summary.failed).toBe(1);
+        expect(mockManager.stop).toHaveBeenCalledTimes(1);
+        healthMonitor.stop();
+    });
+    it('Test 3 — no twins in manifest, no coordinator methods called', async () => {
+        const mockManager = makeMockTwinManager();
+        const coordinator = {
+            startTwins: vi.fn().mockResolvedValue({}),
+            stopTwins: vi.fn().mockResolvedValue(undefined),
+        };
+        const healthMonitor = createTwinHealthMonitor(eventBus, { monitorIntervalMs: 60000 });
+        const runner = createScenarioRunner({
+            twinCoordinator: coordinator,
+            twinHealthMonitor: healthMonitor,
+        });
+        // Manifest with no twins field
+        const { manifest, cleanup } = makeTmpScenario(undefined, 0);
+        cleanupFn = cleanup;
+        const result = await runner.run(manifest, process.cwd());
+        expect(result.summary.total).toBe(1);
+        expect(mockManager.start).not.toHaveBeenCalled();
+        expect(mockManager.stop).not.toHaveBeenCalled();
+        expect(coordinator.startTwins).not.toHaveBeenCalled();
+        expect(coordinator.stopTwins).not.toHaveBeenCalled();
+        healthMonitor.stop();
+    });
+});
+//# sourceMappingURL=e2e.test.js.map

package/dist/twins/__tests__/integration/e2e.test.js.map

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

package/dist/twins/__tests__/integration/health-monitor-integration.test.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Integration tests for TwinHealthMonitor with ScenarioRunner health gate.
+ *
+ * Verifies:
+ *  1. Unhealthy twin aborts ScenarioRunner before execution
+ *  2. Healthy twin allows runner to proceed
+ *  3. 3 consecutive failures yield twin:health-failed, polling stops
+ *  4. Success-then-fail-then-recover: status returns to healthy, no health-failed emitted
+ *  5. Polling stops after hard failure (fetch called exactly 3 times, not 4)
+ *
+ * Uses vi.useFakeTimers() for all tests to control health check polling intervals.
+ *
+ * Story 47-8, Task 3 (AC2, AC3).
+ */
+export {};
+//# sourceMappingURL=health-monitor-integration.test.d.ts.map

package/dist/twins/__tests__/integration/health-monitor-integration.test.d.ts.map

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

package/dist/twins/__tests__/integration/health-monitor-integration.test.js

@@ -0,0 +1,183 @@
+/**
+ * Integration tests for TwinHealthMonitor with ScenarioRunner health gate.
+ *
+ * Verifies:
+ *  1. Unhealthy twin aborts ScenarioRunner before execution
+ *  2. Healthy twin allows runner to proceed
+ *  3. 3 consecutive failures yield twin:health-failed, polling stops
+ *  4. Success-then-fail-then-recover: status returns to healthy, no health-failed emitted
+ *  5. Polling stops after hard failure (fetch called exactly 3 times, not 4)
+ *
+ * Uses vi.useFakeTimers() for all tests to control health check polling intervals.
+ *
+ * Story 47-8, Task 3 (AC2, AC3).
+ */
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import crypto from 'node:crypto';
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { createTwinHealthMonitor } from '../../health-monitor.js';
+import { createScenarioRunner } from '../../../scenarios/runner.js';
+import { makeLocalstackTwinDef, makeTmpScenario } from './helpers.js';
+// ---------------------------------------------------------------------------
+// Setup / Teardown
+// ---------------------------------------------------------------------------
+let cleanupFn = null;
+beforeEach(() => {
+    vi.useFakeTimers();
+    cleanupFn = null;
+});
+afterEach(() => {
+    vi.useRealTimers();
+    vi.unstubAllGlobals();
+    cleanupFn?.();
+    cleanupFn = null;
+});
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function makeSpyEventBus() {
+    return { emit: vi.fn(), on: vi.fn(), off: vi.fn() };
+}
+function makePassingScript(tmpDir) {
+    const scriptPath = path.join(tmpDir, `scenario-${crypto.randomUUID()}.sh`);
+    fs.writeFileSync(scriptPath, '#!/bin/sh\nexit 0\n');
+    fs.chmodSync(scriptPath, 0o755);
+    const checksum = crypto.createHash('sha256').update(fs.readFileSync(scriptPath)).digest('hex');
+    return { name: path.basename(scriptPath), path: scriptPath, checksum };
+}
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe('health monitor integration — ScenarioRunner health gate', () => {
+    it('Test 1 — unhealthy twin aborts ScenarioRunner before any scenario executes', async () => {
+        const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'tw-integ-hm-'));
+        cleanupFn = () => fs.rmSync(tmpDir, { recursive: true, force: true });
+        const mockMonitor = {
+            start: vi.fn(),
+            stop: vi.fn(),
+            getStatus: vi.fn().mockReturnValue({ localstack: 'unhealthy' }),
+        };
+        const scenario = makePassingScript(tmpDir);
+        const manifest = {
+            scenarios: [scenario],
+            capturedAt: Date.now(),
+            twins: ['localstack'],
+        };
+        const runner = createScenarioRunner({ twinHealthMonitor: mockMonitor });
+        const result = await runner.run(manifest, tmpDir);
+        expect(result.summary.failed).toBeGreaterThan(0);
+        expect(result.summary.passed).toBe(0);
+        expect(result.scenarios[0].stderr).toContain("Twin 'localstack' is unhealthy");
+    });
+    it('Test 2 — healthy twin allows runner to proceed normally', async () => {
+        const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'tw-integ-hm-'));
+        cleanupFn = () => fs.rmSync(tmpDir, { recursive: true, force: true });
+        const mockMonitor = {
+            start: vi.fn(),
+            stop: vi.fn(),
+            getStatus: vi.fn().mockReturnValue({ localstack: 'healthy' }),
+        };
+        const scenario = makePassingScript(tmpDir);
+        const manifest = {
+            scenarios: [scenario],
+            capturedAt: Date.now(),
+            twins: ['localstack'],
+        };
+        const runner = createScenarioRunner({ twinHealthMonitor: mockMonitor });
+        const result = await runner.run(manifest, tmpDir);
+        expect(result.summary.passed).toBeGreaterThan(0);
+        expect(result.summary.failed).toBe(0);
+    });
+});
+describe('health monitor integration — polling and failure detection', () => {
+    it('Test 3 — 3 consecutive failures emit twin:health-failed and mark twin unhealthy', async () => {
+        const mockFetch = vi.fn().mockRejectedValue(new Error('ECONNREFUSED'));
+        vi.stubGlobal('fetch', mockFetch);
+        const eventBus = makeSpyEventBus();
+        const monitor = createTwinHealthMonitor(eventBus, {
+            monitorIntervalMs: 1000,
+            maxConsecutiveFailures: 3,
+        });
+        monitor.start([makeLocalstackTwinDef()]);
+        await vi.advanceTimersByTimeAsync(3100);
+        expect(eventBus.emit).toHaveBeenCalledWith('twin:health-failed', expect.objectContaining({ twinName: 'localstack' }));
+        expect(monitor.getStatus()['localstack']).toBe('unhealthy');
+        monitor.stop();
+    });
+    it('Test 4 — success-then-fail-then-recover: status returns healthy, no health-failed emitted', async () => {
+        let callCount = 0;
+        const mockFetch = vi.fn().mockImplementation(() => {
+            callCount++;
+            if (callCount === 1) {
+                return Promise.reject(new Error('ECONNREFUSED'));
+            }
+            return Promise.resolve({ ok: true });
+        });
+        vi.stubGlobal('fetch', mockFetch);
+        const eventBus = makeSpyEventBus();
+        const monitor = createTwinHealthMonitor(eventBus, {
+            monitorIntervalMs: 1000,
+            maxConsecutiveFailures: 3,
+        });
+        monitor.start([makeLocalstackTwinDef()]);
+        // First poll (t=1000): fail → warning. Second poll (t=2000): success → healthy
+        await vi.advanceTimersByTimeAsync(2100);
+        const emitCalls = eventBus.emit.mock.calls;
+        const failedCalls = emitCalls.filter((args) => args[0] === 'twin:health-failed');
+        expect(failedCalls).toHaveLength(0);
+        expect(monitor.getStatus()['localstack']).toBe('healthy');
+        monitor.stop();
+    });
+    it('Test 5 — polling stops after hard failure — fetch called exactly 3 times, not 4', async () => {
+        const mockFetch = vi.fn().mockRejectedValue(new Error('ECONNREFUSED'));
+        vi.stubGlobal('fetch', mockFetch);
+        const eventBus = makeSpyEventBus();
+        const monitor = createTwinHealthMonitor(eventBus, {
+            monitorIntervalMs: 1000,
+            maxConsecutiveFailures: 3,
+        });
+        monitor.start([makeLocalstackTwinDef()]);
+        // Advance 4 intervals — polling stops after 3rd failure
+        await vi.advanceTimersByTimeAsync(4000);
+        expect(mockFetch).toHaveBeenCalledTimes(3);
+        monitor.stop();
+    });
+});
+describe('health monitor integration — mid-run crash detection (AC3)', () => {
+    it('AC3 — 1 success + 3 failures: 2 warnings, 1 health-failed, status unhealthy, no further polls', async () => {
+        let callCount = 0;
+        const mockFetch = vi.fn().mockImplementation(() => {
+            callCount++;
+            if (callCount === 1) {
+                return Promise.resolve({ ok: true });
+            }
+            return Promise.reject(new Error('ECONNREFUSED'));
+        });
+        vi.stubGlobal('fetch', mockFetch);
+        const eventBus = makeSpyEventBus();
+        const monitor = createTwinHealthMonitor(eventBus, {
+            monitorIntervalMs: 1000,
+            maxConsecutiveFailures: 3,
+        });
+        const { manifest, cleanup } = makeTmpScenario(['localstack']);
+        cleanupFn = cleanup;
+        monitor.start([makeLocalstackTwinDef()]);
+        // 4 polls: t=1000 success, t=2000 fail(1), t=3000 fail(2), t=4000 fail(3)=health-failed
+        await vi.advanceTimersByTimeAsync(4100);
+        const emitCalls = eventBus.emit.mock.calls;
+        const warningCalls = emitCalls.filter((args) => args[0] === 'twin:health-warning');
+        const failedCalls = emitCalls.filter((args) => args[0] === 'twin:health-failed');
+        expect(warningCalls).toHaveLength(2);
+        expect(failedCalls).toHaveLength(1);
+        expect(monitor.getStatus()['localstack']).toBe('unhealthy');
+        // Advance more — no further polls should fire
+        await vi.advanceTimersByTimeAsync(2000);
+        // Still 3 failures + 1 success = 4 calls total
+        expect(mockFetch).toHaveBeenCalledTimes(4);
+        monitor.stop();
+        void manifest; // suppress unused variable warning
+    });
+});
+//# sourceMappingURL=health-monitor-integration.test.js.map

package/dist/twins/__tests__/integration/health-monitor-integration.test.js.map

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

package/dist/twins/__tests__/integration/helpers.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Shared test helpers for Epic 47 integration tests.
+ *
+ * All factory functions create fresh instances so each test gets independent mocks.
+ * No vi.fn() calls at module level — all stubs are created inside factory functions.
+ *
+ * Story 47-8, Task 1.
+ */
+import type { TwinDefinition, TwinManager } from '../../index.js';
+import type { ScenarioManifest } from '../../../scenarios/types.js';
+/**
+ * Creates a mock TwinManager with vi.fn() stubs for start, stop, and getComposeDir.
+ * Both start and stop resolve to undefined — no Docker, no network.
+ */
+export declare function makeMockTwinManager(): TwinManager;
+/**
+ * Returns a standard LocalStack TwinDefinition with healthcheck configured.
+ */
+export declare function makeLocalstackTwinDef(): TwinDefinition;
+/**
+ * Creates a temporary shell script that echoes '{}' and exits with the given exit code.
+ * The script is placed in a fresh mkdtempSync directory prefixed with 'tw-integ-'.
+ *
+ * @param twins    - Optional twin names to include in the manifest.
+ * @param exitCode - Exit code for the script (default 0).
+ * @returns manifest and a cleanup function that removes the temp directory.
+ */
+export declare function makeTmpScenario(twins?: string[], exitCode?: number): {
+    manifest: ScenarioManifest;
+    cleanup: () => void;
+};
+//# sourceMappingURL=helpers.d.ts.map

package/dist/twins/__tests__/integration/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../../src/twins/__tests__/integration/helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AAEnE;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,WAAW,CAMjD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,cAAc,CAQtD;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,KAAK,CAAC,EAAE,MAAM,EAAE,EAChB,QAAQ,GAAE,MAAU,GACnB;IAAE,QAAQ,EAAE,gBAAgB,CAAC;IAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAuBrD"}

package/dist/twins/__tests__/integration/helpers.js

@@ -0,0 +1,67 @@
+/**
+ * Shared test helpers for Epic 47 integration tests.
+ *
+ * All factory functions create fresh instances so each test gets independent mocks.
+ * No vi.fn() calls at module level — all stubs are created inside factory functions.
+ *
+ * Story 47-8, Task 1.
+ */
+import crypto from 'node:crypto';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { vi } from 'vitest';
+/**
+ * Creates a mock TwinManager with vi.fn() stubs for start, stop, and getComposeDir.
+ * Both start and stop resolve to undefined — no Docker, no network.
+ */
+export function makeMockTwinManager() {
+    return {
+        start: vi.fn().mockResolvedValue(undefined),
+        stop: vi.fn().mockResolvedValue(undefined),
+        getComposeDir: vi.fn().mockReturnValue(null),
+    };
+}
+/**
+ * Returns a standard LocalStack TwinDefinition with healthcheck configured.
+ */
+export function makeLocalstackTwinDef() {
+    return {
+        name: 'localstack',
+        image: 'localstack/localstack:latest',
+        ports: [{ host: 4566, container: 4566 }],
+        environment: { SERVICES: 's3' },
+        healthcheck: { url: 'http://localhost:4566/health', timeout_ms: 5000 },
+    };
+}
+/**
+ * Creates a temporary shell script that echoes '{}' and exits with the given exit code.
+ * The script is placed in a fresh mkdtempSync directory prefixed with 'tw-integ-'.
+ *
+ * @param twins    - Optional twin names to include in the manifest.
+ * @param exitCode - Exit code for the script (default 0).
+ * @returns manifest and a cleanup function that removes the temp directory.
+ */
+export function makeTmpScenario(twins, exitCode = 0) {
+    const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'tw-integ-'));
+    const scriptPath = path.join(tmpDir, 'scenario-test.sh');
+    const scriptContent = `#!/bin/sh\necho "{}"\nexit ${exitCode}\n`;
+    fs.writeFileSync(scriptPath, scriptContent);
+    fs.chmodSync(scriptPath, 0o755);
+    const checksum = crypto
+        .createHash('sha256')
+        .update(fs.readFileSync(scriptPath))
+        .digest('hex');
+    const manifest = {
+        scenarios: [{ name: 'scenario-test.sh', path: scriptPath, checksum }],
+        capturedAt: Date.now(),
+        ...(twins !== undefined ? { twins } : {}),
+    };
+    return {
+        manifest,
+        cleanup: () => {
+            fs.rmSync(tmpDir, { recursive: true, force: true });
+        },
+    };
+}
+//# sourceMappingURL=helpers.js.map

package/dist/twins/__tests__/integration/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../../src/twins/__tests__/integration/helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,MAAM,MAAM,aAAa,CAAA;AAChC,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAI3B;;;GAGG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;QAC3C,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;QAC1C,aAAa,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC;KACnB,CAAA;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,8BAA8B;QACrC,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QACxC,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC/B,WAAW,EAAE,EAAE,GAAG,EAAE,8BAA8B,EAAE,UAAU,EAAE,IAAI,EAAE;KACvE,CAAA;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAgB,EAChB,WAAmB,CAAC;IAEpB,MAAM,MAAM,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,WAAW,CAAC,CAAC,CAAA;IAClE,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAA;IACxD,MAAM,aAAa,GAAG,8BAA8B,QAAQ,IAAI,CAAA;IAChE,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,aAAa,CAAC,CAAA;IAC3C,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,KAAK,CAAC,CAAA;IAC/B,MAAM,QAAQ,GAAG,MAAM;SACpB,UAAU,CAAC,QAAQ,CAAC;SACpB,MAAM,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;SACnC,MAAM,CAAC,KAAK,CAAC,CAAA;IAEhB,MAAM,QAAQ,GAAqB;QACjC,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;QACrE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;QACtB,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1C,CAAA;IAED,OAAO;QACL,QAAQ;QACR,OAAO,EAAE,GAAS,EAAE;YAClB,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;QACrD,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/twins/__tests__/integration/lifecycle.test.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Integration tests for twin lifecycle with ScenarioRunner.
+ *
+ * Verifies:
+ *  1. startTwins is called before scenario subprocess executes
+ *  2. stopTwins is called exactly once when scenario passes
+ *  3. stopTwins is called exactly once even when scenario fails
+ *  4. startup failure returns all-failed result, stopTwins NOT called
+ *  5. env vars from startTwins are injected into scenario subprocess
+ *
+ * Story 47-8, Task 2 (AC1).
+ */
+export {};
+//# sourceMappingURL=lifecycle.test.d.ts.map

package/dist/twins/__tests__/integration/lifecycle.test.d.ts.map

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

package/dist/twins/__tests__/integration/lifecycle.test.js

@@ -0,0 +1,127 @@
+/**
+ * Integration tests for twin lifecycle with ScenarioRunner.
+ *
+ * Verifies:
+ *  1. startTwins is called before scenario subprocess executes
+ *  2. stopTwins is called exactly once when scenario passes
+ *  3. stopTwins is called exactly once even when scenario fails
+ *  4. startup failure returns all-failed result, stopTwins NOT called
+ *  5. env vars from startTwins are injected into scenario subprocess
+ *
+ * Story 47-8, Task 2 (AC1).
+ */
+import crypto from 'node:crypto';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { createScenarioRunner } from '../../../scenarios/runner.js';
+import { makeTmpScenario } from './helpers.js';
+// ---------------------------------------------------------------------------
+// Setup / Teardown
+// ---------------------------------------------------------------------------
+let cleanupFn = null;
+let extraTmpDir = null;
+beforeEach(() => {
+    cleanupFn = null;
+    extraTmpDir = null;
+});
+afterEach(() => {
+    cleanupFn?.();
+    cleanupFn = null;
+    if (extraTmpDir !== null) {
+        fs.rmSync(extraTmpDir, { recursive: true, force: true });
+        extraTmpDir = null;
+    }
+});
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe('twin lifecycle integration', () => {
+    it('Test 1 — startTwins is called before scenario script executes', async () => {
+        let startWasCalled = false;
+        const callOrder = [];
+        const coordinator = {
+            startTwins: vi.fn().mockImplementation(async (names) => {
+                startWasCalled = true;
+                callOrder.push('startTwins:' + names.join(','));
+                return {};
+            }),
+            stopTwins: vi.fn().mockImplementation(async () => {
+                callOrder.push('stopTwins');
+            }),
+        };
+        const { manifest, cleanup } = makeTmpScenario(['localstack']);
+        cleanupFn = cleanup;
+        const runner = createScenarioRunner({ twinCoordinator: coordinator });
+        await runner.run(manifest, os.tmpdir());
+        expect(startWasCalled).toBe(true);
+        expect(coordinator.startTwins).toHaveBeenCalledWith(['localstack']);
+        expect(callOrder.indexOf('startTwins:localstack')).toBeLessThan(callOrder.indexOf('stopTwins'));
+    });
+    it('Test 2 — stopTwins called exactly once when scenario passes', async () => {
+        const coordinator = {
+            startTwins: vi.fn().mockResolvedValue({}),
+            stopTwins: vi.fn().mockResolvedValue(undefined),
+        };
+        const { manifest, cleanup } = makeTmpScenario(['localstack'], 0);
+        cleanupFn = cleanup;
+        const runner = createScenarioRunner({ twinCoordinator: coordinator });
+        const result = await runner.run(manifest, os.tmpdir());
+        expect(result.scenarios[0].status).toBe('pass');
+        expect(coordinator.stopTwins).toHaveBeenCalledTimes(1);
+    });
+    it('Test 3 — stopTwins called exactly once even when scenario fails', async () => {
+        const coordinator = {
+            startTwins: vi.fn().mockResolvedValue({}),
+            stopTwins: vi.fn().mockResolvedValue(undefined),
+        };
+        const { manifest, cleanup } = makeTmpScenario(['localstack'], 1);
+        cleanupFn = cleanup;
+        const runner = createScenarioRunner({ twinCoordinator: coordinator });
+        const result = await runner.run(manifest, os.tmpdir());
+        expect(result.scenarios[0].status).toBe('fail');
+        expect(coordinator.stopTwins).toHaveBeenCalledTimes(1);
+    });
+    it('Test 4 — startup failure returns all-failed result without calling stopTwins', async () => {
+        const coordinator = {
+            startTwins: vi.fn().mockRejectedValue(new Error('Docker not found')),
+            stopTwins: vi.fn().mockResolvedValue(undefined),
+        };
+        const { manifest, cleanup } = makeTmpScenario(['localstack']);
+        cleanupFn = cleanup;
+        const runner = createScenarioRunner({ twinCoordinator: coordinator });
+        const result = await runner.run(manifest, os.tmpdir());
+        expect(result.summary.failed).toBe(manifest.scenarios.length);
+        expect(result.summary.passed).toBe(0);
+        for (const scenario of result.scenarios) {
+            expect(scenario.status).toBe('fail');
+            expect(scenario.stderr).toContain('Docker not found');
+        }
+        expect(coordinator.stopTwins).not.toHaveBeenCalled();
+    });
+    it('Test 5 — env vars from startTwins are injected into scenario subprocess', async () => {
+        const coordinator = {
+            startTwins: vi.fn().mockResolvedValue({ TWIN_TEST_PORT: '19999' }),
+            stopTwins: vi.fn().mockResolvedValue(undefined),
+        };
+        // Create a script that prints the env var as JSON
+        extraTmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'tw-integ-env-'));
+        const scriptPath = path.join(extraTmpDir, 'scenario-env.sh');
+        fs.writeFileSync(scriptPath, '#!/bin/sh\nprintf \'{"v":"%s"}\' "$TWIN_TEST_PORT"\n');
+        fs.chmodSync(scriptPath, 0o755);
+        const checksum = crypto
+            .createHash('sha256')
+            .update(fs.readFileSync(scriptPath))
+            .digest('hex');
+        const manifest = {
+            scenarios: [{ name: 'scenario-env.sh', path: scriptPath, checksum }],
+            capturedAt: Date.now(),
+            twins: ['localstack'],
+        };
+        const runner = createScenarioRunner({ twinCoordinator: coordinator });
+        const result = await runner.run(manifest, extraTmpDir);
+        expect(result.scenarios[0].stdout).toContain('19999');
+    });
+});
+//# sourceMappingURL=lifecycle.test.js.map