@substrate-ai/factory 0.19.54 → 0.20.2

package/dist/twins/__tests__/registry.test.js

@@ -1,282 +0,0 @@
-/**
- * Unit tests for TwinRegistry — discovery, validation, and health polling.
- *
- * Story 47-1.
- */
-import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
-import { tmpdir } from 'node:os';
-import { mkdir, writeFile, rm } from 'node:fs/promises';
-import { join } from 'node:path';
-import { randomUUID } from 'node:crypto';
-import { createTwinRegistry } from '../registry.js';
-import { TwinDefinitionError, TwinRegistryError } from '../types.js';
-// ---------------------------------------------------------------------------
-// Test helpers
-// ---------------------------------------------------------------------------
-let testDir;
-async function writeTwin(dir, filename, content) {
-    await writeFile(join(dir, filename), content, 'utf-8');
-}
-// ---------------------------------------------------------------------------
-// Setup / teardown
-// ---------------------------------------------------------------------------
-beforeEach(async () => {
-    testDir = join(tmpdir(), randomUUID());
-    await mkdir(testDir, { recursive: true });
-});
-afterEach(async () => {
-    await rm(testDir, { recursive: true, force: true });
-});
-// ---------------------------------------------------------------------------
-// AC1: YAML Discovery and Full-Field Parsing
-// ---------------------------------------------------------------------------
-describe('AC1: YAML discovery and full-field parsing', () => {
-    it('parses a full-field YAML twin definition correctly', async () => {
-        await writeTwin(testDir, 'stripe.yaml', `
-name: stripe
-image: stripe/stripe-mock:latest
-ports:
-  - "12111:12111"
-environment:
-  STRIPE_MOCK_PORT: "12111"
-healthcheck:
-  url: "http://localhost:12111/v1/charges"
-  interval_ms: 500
-  timeout_ms: 10000
-`);
-        const registry = createTwinRegistry();
-        await registry.discover(testDir);
-        const list = registry.list();
-        expect(list).toHaveLength(1);
-        const twin = list[0];
-        expect(twin.name).toBe('stripe');
-        expect(twin.image).toBe('stripe/stripe-mock:latest');
-        expect(twin.ports).toEqual([{ host: 12111, container: 12111 }]);
-        expect(twin.environment).toEqual({ STRIPE_MOCK_PORT: '12111' });
-        expect(twin.healthcheck).toEqual({
-            url: 'http://localhost:12111/v1/charges',
-            interval_ms: 500,
-            timeout_ms: 10000,
-        });
-    });
-    it('list() returns exactly one entry matching the file contents', async () => {
-        await writeTwin(testDir, 'postgres.yaml', `name: postgres\nimage: postgres:16\n`);
-        const registry = createTwinRegistry();
-        await registry.discover(testDir);
-        expect(registry.list()).toHaveLength(1);
-        expect(registry.list()[0].name).toBe('postgres');
-        expect(registry.list()[0].image).toBe('postgres:16');
-    });
-    it('get() returns the correct definition by name', async () => {
-        await writeTwin(testDir, 'stripe.yaml', `name: stripe\nimage: stripe/stripe-mock:latest\n`);
-        const registry = createTwinRegistry();
-        await registry.discover(testDir);
-        const twin = registry.get('stripe');
-        expect(twin).toBeDefined();
-        expect(twin.name).toBe('stripe');
-        expect(twin.image).toBe('stripe/stripe-mock:latest');
-    });
-});
-// ---------------------------------------------------------------------------
-// AC2: Required Field Validation — Descriptive Error on Missing Fields
-// ---------------------------------------------------------------------------
-describe('AC2: required field validation', () => {
-    it('throws TwinDefinitionError with file path when "name" is missing', async () => {
-        await writeTwin(testDir, 'bad.yaml', `image: postgres:16\n`);
-        const registry = createTwinRegistry();
-        await expect(registry.discover(testDir)).rejects.toThrow(TwinDefinitionError);
-        await expect(registry.discover(testDir)).rejects.toThrow(/missing required field: name/);
-        await expect(registry.discover(testDir)).rejects.toThrow(/bad\.yaml/);
-    });
-    it('throws TwinDefinitionError with file path when "image" is missing', async () => {
-        await writeTwin(testDir, 'bad.yaml', `name: postgres\n`);
-        const registry = createTwinRegistry();
-        await expect(registry.discover(testDir)).rejects.toThrow(TwinDefinitionError);
-        await expect(registry.discover(testDir)).rejects.toThrow(/missing required field: image/);
-        await expect(registry.discover(testDir)).rejects.toThrow(/bad\.yaml/);
-    });
-});
-// ---------------------------------------------------------------------------
-// AC3: Malformed YAML and Unknown Field Detection
-// ---------------------------------------------------------------------------
-describe('AC3: malformed YAML and unknown field detection', () => {
-    it('throws TwinDefinitionError on syntactically invalid YAML', async () => {
-        await writeTwin(testDir, 'invalid.yaml', `name: [unclosed bracket\nimage: test:latest\n`);
-        const registry = createTwinRegistry();
-        await expect(registry.discover(testDir)).rejects.toThrow(TwinDefinitionError);
-        await expect(registry.discover(testDir)).rejects.toThrow(/invalid\.yaml/);
-    });
-    it('throws TwinDefinitionError on unrecognised top-level field', async () => {
-        await writeTwin(testDir, 'unknown-field.yaml', `name: test\nimage: test:latest\nunknownField: oops\n`);
-        const registry = createTwinRegistry();
-        await expect(registry.discover(testDir)).rejects.toThrow(TwinDefinitionError);
-        await expect(registry.discover(testDir)).rejects.toThrow(/unknown-field\.yaml/);
-    });
-    it('still discovers valid sibling files in the SAME directory when one file is invalid', async () => {
-        // Both files in the same temp directory: bad.yaml (invalid YAML) and valid.yaml
-        await writeTwin(testDir, 'bad.yaml', `name: [unclosed`);
-        await writeTwin(testDir, 'valid.yaml', `name: postgres\nimage: postgres:16\n`);
-        const registry = createTwinRegistry();
-        let thrownError;
-        try {
-            await registry.discover(testDir);
-        }
-        catch (err) {
-            thrownError = err;
-        }
-        // The bad.yaml should cause a TwinDefinitionError to be thrown
-        expect(thrownError).toBeInstanceOf(TwinDefinitionError);
-        // The valid sibling in the same directory must still be present in the registry (AC3 fail-soft)
-        expect(registry.list()).toHaveLength(1);
-        expect(registry.list()[0].name).toBe('postgres');
-    });
-});
-// ---------------------------------------------------------------------------
-// AC4: Duplicate Twin Name Detection
-// ---------------------------------------------------------------------------
-describe('AC4: duplicate twin name detection', () => {
-    it('throws TwinRegistryError mentioning both file paths when duplicate names are found', async () => {
-        await writeTwin(testDir, 'postgres-a.yaml', `name: postgres\nimage: postgres:16\n`);
-        await writeTwin(testDir, 'postgres-b.yaml', `name: postgres\nimage: postgres:15\n`);
-        const registry = createTwinRegistry();
-        let thrownError;
-        try {
-            await registry.discover(testDir);
-        }
-        catch (err) {
-            thrownError = err;
-        }
-        expect(thrownError).toBeDefined();
-        expect(thrownError).toBeInstanceOf(TwinRegistryError);
-        expect(thrownError.message).toMatch(/postgres/);
-        expect(thrownError.message).toMatch(/postgres-a\.yaml/);
-        expect(thrownError.message).toMatch(/postgres-b\.yaml/);
-    });
-});
-// ---------------------------------------------------------------------------
-// AC5: Port Mapping Parsed into Structured Objects
-// ---------------------------------------------------------------------------
-describe('AC5: port mapping parsing', () => {
-    it('parses "5432:5432" into { host: 5432, container: 5432 }', async () => {
-        await writeTwin(testDir, 'postgres.yaml', `name: postgres\nimage: postgres:16\nports:\n  - "5432:5432"\n`);
-        const registry = createTwinRegistry();
-        await registry.discover(testDir);
-        const twin = registry.get('postgres');
-        expect(twin.ports).toEqual([{ host: 5432, container: 5432 }]);
-    });
-    it('parses multiple port mappings correctly', async () => {
-        await writeTwin(testDir, 'postgres.yaml', `name: postgres\nimage: postgres:16\nports:\n  - "5432:5432"\n  - "5433:5433"\n`);
-        const registry = createTwinRegistry();
-        await registry.discover(testDir);
-        const twin = registry.get('postgres');
-        expect(twin.ports).toHaveLength(2);
-        expect(twin.ports[0]).toEqual({ host: 5432, container: 5432 });
-        expect(twin.ports[1]).toEqual({ host: 5433, container: 5433 });
-    });
-});
-// ---------------------------------------------------------------------------
-// AC6: Optional Fields Default Correctly
-// ---------------------------------------------------------------------------
-describe('AC6: optional fields default correctly', () => {
-    it('parses a minimal definition (name + image only) without error', async () => {
-        await writeTwin(testDir, 'minimal.yaml', `name: minimal\nimage: minimal:latest\n`);
-        const registry = createTwinRegistry();
-        await expect(registry.discover(testDir)).resolves.toBeUndefined();
-        const twin = registry.get('minimal');
-        expect(twin).toBeDefined();
-    });
-    it('applies correct defaults for missing optional fields', async () => {
-        await writeTwin(testDir, 'minimal.yaml', `name: minimal\nimage: minimal:latest\n`);
-        const registry = createTwinRegistry();
-        await registry.discover(testDir);
-        const twin = registry.get('minimal');
-        expect(twin.environment).toEqual({});
-        expect(twin.ports).toEqual([]);
-        expect(twin.healthcheck).toBeUndefined();
-    });
-});
-// ---------------------------------------------------------------------------
-// AC7: Health Endpoint Polling
-// ---------------------------------------------------------------------------
-describe('AC7: health endpoint polling', () => {
-    it('resolves { healthy: true, attempts: 3 } when mockFetch returns 200 on 3rd call', async () => {
-        const registry = createTwinRegistry();
-        const twin = {
-            name: 'test',
-            image: 'test:latest',
-            ports: [],
-            environment: {},
-            healthcheck: {
-                url: 'http://localhost:9999/health',
-                interval_ms: 10,
-                timeout_ms: 500,
-            },
-        };
-        let callCount = 0;
-        const mockFetch = vi.fn().mockImplementation(async () => {
-            callCount++;
-            if (callCount < 3)
-                return { ok: false, status: 503 };
-            return { ok: true, status: 200 };
-        });
-        const result = await registry.pollHealth(twin, { fetch: mockFetch });
-        expect(result).toEqual({ healthy: true, attempts: 3 });
-    });
-    it('resolves { healthy: false, error: "..." } when mockFetch always fails and timeout elapses', async () => {
-        const registry = createTwinRegistry();
-        const twin = {
-            name: 'test',
-            image: 'test:latest',
-            ports: [],
-            environment: {},
-            healthcheck: {
-                url: 'http://localhost:9999/health',
-                interval_ms: 20,
-                // Wider margin (500ms vs 100ms) avoids flakiness under CI load while keeping the test fast
-                timeout_ms: 500,
-            },
-        };
-        const mockFetch = vi.fn().mockResolvedValue({ ok: false, status: 503 });
-        const result = await registry.pollHealth(twin, { fetch: mockFetch });
-        expect(result).toEqual({
-            healthy: false,
-            error: 'Health check timed out after 500ms',
-        });
-    });
-    it('resolves { healthy: true, attempts: 0 } when no healthcheck is defined', async () => {
-        const registry = createTwinRegistry();
-        const twin = {
-            name: 'test',
-            image: 'test:latest',
-            ports: [],
-            environment: {},
-            // healthcheck is intentionally omitted
-        };
-        const result = await registry.pollHealth(twin);
-        expect(result).toEqual({ healthy: true, attempts: 0 });
-    });
-    it('treats network errors (thrown exceptions) as non-2xx and continues polling', async () => {
-        const registry = createTwinRegistry();
-        const twin = {
-            name: 'test',
-            image: 'test:latest',
-            ports: [],
-            environment: {},
-            healthcheck: {
-                url: 'http://localhost:9999/health',
-                interval_ms: 10,
-                timeout_ms: 500,
-            },
-        };
-        let callCount = 0;
-        const mockFetch = vi.fn().mockImplementation(async () => {
-            callCount++;
-            if (callCount < 3)
-                throw new Error('ECONNREFUSED');
-            return { ok: true, status: 200 };
-        });
-        const result = await registry.pollHealth(twin, { fetch: mockFetch });
-        expect(result).toEqual({ healthy: true, attempts: 3 });
-    });
-});
-//# sourceMappingURL=registry.test.js.map

package/dist/twins/__tests__/registry.test.js.map

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

package/dist/twins/__tests__/run-state.test.d.ts

@@ -1,9 +0,0 @@
-/**
- * Unit tests for the run-state helpers.
- *
- * Mocks `node:fs/promises` to avoid real filesystem I/O.
- *
- * Story 47-5 — Task 7.
- */
-export {};
-//# sourceMappingURL=run-state.test.d.ts.map

package/dist/twins/__tests__/run-state.test.d.ts.map

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

package/dist/twins/__tests__/run-state.test.js

@@ -1,112 +0,0 @@
-/**
- * Unit tests for the run-state helpers.
- *
- * Mocks `node:fs/promises` to avoid real filesystem I/O.
- *
- * Story 47-5 — Task 7.
- */
-import { describe, it, expect, vi, beforeEach } from 'vitest';
-// ---------------------------------------------------------------------------
-// Module-level mocks — must be declared before any imports from mocked modules
-// ---------------------------------------------------------------------------
-vi.mock('node:fs/promises', () => ({
-    readFile: vi.fn(),
-    writeFile: vi.fn(),
-    unlink: vi.fn(),
-    mkdir: vi.fn(),
-}));
-// ---------------------------------------------------------------------------
-// Import mocked functions after vi.mock declarations
-// ---------------------------------------------------------------------------
-import { readFile, writeFile, unlink, mkdir } from 'node:fs/promises';
-import { runStatePath, readRunState, writeRunState, clearRunState } from '../run-state.js';
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-const PROJECT_DIR = '/test/project';
-function makeState(overrides) {
-    return {
-        composeDir: '/tmp/abc123',
-        twinNames: ['localstack', 'wiremock'],
-        startedAt: '2026-03-23T12:00:00.000Z',
-        ...overrides,
-    };
-}
-// ---------------------------------------------------------------------------
-// beforeEach: reset all mocks
-// ---------------------------------------------------------------------------
-beforeEach(() => {
-    vi.resetAllMocks();
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    vi.mocked(readFile).mockResolvedValue('');
-    vi.mocked(writeFile).mockResolvedValue(undefined);
-    vi.mocked(unlink).mockResolvedValue(undefined);
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    vi.mocked(mkdir).mockResolvedValue(undefined);
-});
-// ---------------------------------------------------------------------------
-// Tests
-// ---------------------------------------------------------------------------
-describe('runStatePath', () => {
-    it('returns path ending in .substrate/twins/.run-state.json', () => {
-        const p = runStatePath(PROJECT_DIR);
-        expect(p).toContain('.substrate');
-        expect(p).toContain('twins');
-        expect(p).toContain('.run-state.json');
-        expect(p).toBe(`${PROJECT_DIR}/.substrate/twins/.run-state.json`);
-    });
-});
-describe('readRunState', () => {
-    it('returns null when file does not exist (ENOENT)', async () => {
-        const err = Object.assign(new Error('ENOENT'), { code: 'ENOENT' });
-        vi.mocked(readFile).mockRejectedValue(err);
-        const result = await readRunState(PROJECT_DIR);
-        expect(result).toBeNull();
-    });
-    it('returns parsed TwinRunState when file contains valid JSON', async () => {
-        const state = makeState();
-        vi.mocked(readFile).mockResolvedValue(JSON.stringify(state));
-        const result = await readRunState(PROJECT_DIR);
-        expect(result).toEqual(state);
-    });
-    it('throws when the file contains invalid JSON', async () => {
-        vi.mocked(readFile).mockResolvedValue('not valid json }{');
-        await expect(readRunState(PROJECT_DIR)).rejects.toThrow();
-    });
-    it('throws on I/O errors other than ENOENT', async () => {
-        const err = Object.assign(new Error('EACCES'), { code: 'EACCES' });
-        vi.mocked(readFile).mockRejectedValue(err);
-        await expect(readRunState(PROJECT_DIR)).rejects.toMatchObject({ code: 'EACCES' });
-    });
-});
-describe('writeRunState', () => {
-    it('calls mkdir with recursive: true before writing', async () => {
-        const state = makeState();
-        await writeRunState(PROJECT_DIR, state);
-        expect(mkdir).toHaveBeenCalledWith(expect.stringContaining('.substrate'), { recursive: true });
-    });
-    it('calls writeFile with the correct JSON content and path', async () => {
-        const state = makeState();
-        await writeRunState(PROJECT_DIR, state);
-        const expectedPath = runStatePath(PROJECT_DIR);
-        const expectedContent = JSON.stringify(state, null, 2);
-        expect(writeFile).toHaveBeenCalledWith(expectedPath, expectedContent, 'utf-8');
-    });
-});
-describe('clearRunState', () => {
-    it('calls unlink with the state file path', async () => {
-        await clearRunState(PROJECT_DIR);
-        expect(unlink).toHaveBeenCalledWith(runStatePath(PROJECT_DIR));
-    });
-    it('is a no-op when file does not exist (ENOENT) — does not throw', async () => {
-        const err = Object.assign(new Error('ENOENT'), { code: 'ENOENT' });
-        vi.mocked(unlink).mockRejectedValue(err);
-        await expect(clearRunState(PROJECT_DIR)).resolves.toBeUndefined();
-    });
-    it('re-throws I/O errors other than ENOENT', async () => {
-        const err = Object.assign(new Error('EACCES'), { code: 'EACCES' });
-        vi.mocked(unlink).mockRejectedValue(err);
-        await expect(clearRunState(PROJECT_DIR)).rejects.toMatchObject({ code: 'EACCES' });
-    });
-});
-//# sourceMappingURL=run-state.test.js.map

package/dist/twins/__tests__/run-state.test.js.map

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

package/dist/twins/__tests__/templates-cli.test.d.ts

@@ -1,10 +0,0 @@
-/**
- * Integration tests for the `twins init` and `twins templates` CLI logic.
- *
- * Story 47-4 — Task 7.
- *
- * These tests invoke the underlying logic directly (not via Commander subprocess) to avoid
- * overhead and to allow precise assertion on file system state and exit codes.
- */
-export {};
-//# sourceMappingURL=templates-cli.test.d.ts.map

package/dist/twins/__tests__/templates-cli.test.d.ts.map

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

package/dist/twins/__tests__/templates-cli.test.js

@@ -1,187 +0,0 @@
-/**
- * Integration tests for the `twins init` and `twins templates` CLI logic.
- *
- * Story 47-4 — Task 7.
- *
- * These tests invoke the underlying logic directly (not via Commander subprocess) to avoid
- * overhead and to allow precise assertion on file system state and exit codes.
- */
-import { describe, it, expect, beforeEach, afterEach } from 'vitest';
-import * as fs from 'node:fs';
-import * as fsPromises from 'node:fs/promises';
-import * as os from 'node:os';
-import * as path from 'node:path';
-import yaml from 'js-yaml';
-import { getTwinTemplate, listTwinTemplates } from '../templates.js';
-import { TwinDefinitionSchema } from '../schema.js';
-/**
- * Extracted init logic from the `factory twins init` Commander action.
- * Returns stdout, stderr, and exit code without actually calling `process.exit`.
- */
-async function runInitLogic(opts, cwd) {
-    let stdout = '';
-    let stderr = '';
-    const entry = getTwinTemplate(opts.template);
-    if (!entry) {
-        const available = listTwinTemplates()
-            .map((t) => t.name)
-            .join(', ');
-        stderr = `Error: Unknown template '${opts.template}'. Available: ${available}\n`;
-        return { exitCode: 1, stdout, stderr };
-    }
-    const targetPath = path.join(cwd, '.substrate', 'twins', `${opts.template}.yaml`);
-    if (!opts.force) {
-        try {
-            await fsPromises.access(targetPath);
-            // File exists — error without --force
-            stderr = `Error: File already exists: ${targetPath} — use --force to overwrite\n`;
-            return { exitCode: 1, stdout, stderr };
-        }
-        catch {
-            // access() threw → file does not exist → proceed
-        }
-    }
-    await fsPromises.mkdir(path.dirname(targetPath), { recursive: true });
-    const yamlContent = yaml.dump(entry.definition);
-    await fsPromises.writeFile(targetPath, yamlContent, 'utf-8');
-    stdout = `Created ${targetPath}\n`;
-    return { exitCode: 0, stdout, stderr };
-}
-// ---------------------------------------------------------------------------
-// Helpers — mirror the templates action logic from factory-command.ts
-// ---------------------------------------------------------------------------
-/**
- * Extracted templates listing logic from the `factory twins templates` Commander action.
- * Returns the stdout string that would be written to process.stdout.
- */
-function runTemplatesLogic() {
-    const templates = listTwinTemplates();
-    let stdout = '';
-    for (const t of templates) {
-        stdout += `  ${t.name.padEnd(16)}  ${t.description}\n`;
-    }
-    return stdout;
-}
-// ---------------------------------------------------------------------------
-// Tests
-// ---------------------------------------------------------------------------
-let tmpDir;
-beforeEach(() => {
-    tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'twins-cli-'));
-});
-afterEach(() => {
-    fs.rmSync(tmpDir, { recursive: true, force: true });
-});
-describe('factory twins init — localstack', () => {
-    it('creates .substrate/twins/localstack.yaml', async () => {
-        const result = await runInitLogic({ template: 'localstack', force: false }, tmpDir);
-        expect(result.exitCode).toBe(0);
-        const filePath = path.join(tmpDir, '.substrate', 'twins', 'localstack.yaml');
-        expect(fs.existsSync(filePath)).toBe(true);
-        const content = fs.readFileSync(filePath, 'utf-8');
-        const parsed = yaml.load(content);
-        expect(parsed.name).toBe('localstack');
-        expect(parsed.image).toBe('localstack/localstack:latest');
-        expect(parsed.ports).toContain('4566:4566');
-        expect(parsed.healthcheck?.url).toBe('http://localhost:4566/_localstack/health');
-        // Must pass schema validation
-        expect(() => TwinDefinitionSchema.parse(parsed)).not.toThrow();
-    });
-});
-describe('factory twins init — wiremock', () => {
-    it('creates .substrate/twins/wiremock.yaml', async () => {
-        const result = await runInitLogic({ template: 'wiremock', force: false }, tmpDir);
-        expect(result.exitCode).toBe(0);
-        const filePath = path.join(tmpDir, '.substrate', 'twins', 'wiremock.yaml');
-        expect(fs.existsSync(filePath)).toBe(true);
-        const content = fs.readFileSync(filePath, 'utf-8');
-        const parsed = yaml.load(content);
-        expect(parsed.name).toBe('wiremock');
-        expect(parsed.image).toBe('wiremock/wiremock:latest');
-        expect(parsed.ports).toContain('8080:8080');
-        expect(parsed.healthcheck?.url).toBe('http://localhost:8080/__admin/health');
-        // Must pass schema validation
-        expect(() => TwinDefinitionSchema.parse(parsed)).not.toThrow();
-    });
-});
-describe('factory twins init — unknown template', () => {
-    it('exits with code 1 and mentions Available templates', async () => {
-        const result = await runInitLogic({ template: 'bogus' }, tmpDir);
-        expect(result.exitCode).toBe(1);
-        expect(result.stderr).toContain('Unknown template');
-        expect(result.stderr).toContain('bogus');
-        expect(result.stderr).toContain('Available:');
-        expect(result.stderr).toContain('localstack');
-        expect(result.stderr).toContain('wiremock');
-    });
-});
-describe('factory twins init — existing file without --force', () => {
-    it('exits with code 1 and does NOT overwrite existing file', async () => {
-        // Pre-create the file with sentinel content
-        const twinsDir = path.join(tmpDir, '.substrate', 'twins');
-        fs.mkdirSync(twinsDir, { recursive: true });
-        const filePath = path.join(twinsDir, 'localstack.yaml');
-        const sentinelContent = 'sentinel: content\n';
-        fs.writeFileSync(filePath, sentinelContent, 'utf-8');
-        const result = await runInitLogic({ template: 'localstack', force: false }, tmpDir);
-        expect(result.exitCode).toBe(1);
-        expect(result.stderr).toContain('already exists');
-        expect(result.stderr).toContain('--force');
-        // File must NOT have been overwritten
-        const actual = fs.readFileSync(filePath, 'utf-8');
-        expect(actual).toBe(sentinelContent);
-    });
-});
-describe('factory twins init — existing file with --force', () => {
-    it('overwrites the existing file with valid YAML', async () => {
-        // Pre-create the file with sentinel content
-        const twinsDir = path.join(tmpDir, '.substrate', 'twins');
-        fs.mkdirSync(twinsDir, { recursive: true });
-        const filePath = path.join(twinsDir, 'localstack.yaml');
-        fs.writeFileSync(filePath, 'sentinel: content\n', 'utf-8');
-        const result = await runInitLogic({ template: 'localstack', force: true }, tmpDir);
-        expect(result.exitCode).toBe(0);
-        const content = fs.readFileSync(filePath, 'utf-8');
-        const parsed = yaml.load(content);
-        expect(parsed.name).toBe('localstack');
-        expect(() => TwinDefinitionSchema.parse(parsed)).not.toThrow();
-    });
-});
-describe('factory twins templates — output format', () => {
-    it('outputs one line per template with name and description', () => {
-        const output = runTemplatesLogic();
-        const lines = output.split('\n').filter((l) => l.trim().length > 0);
-        // At least two entries (localstack + wiremock)
-        expect(lines.length).toBeGreaterThanOrEqual(2);
-        // Each line must be non-empty and contain a name+description pair
-        for (const line of lines) {
-            expect(line.trim().length).toBeGreaterThan(0);
-        }
-    });
-    it('includes localstack with its description on one line', () => {
-        const output = runTemplatesLogic();
-        const lines = output.split('\n').filter((l) => l.trim().length > 0);
-        const localstackLine = lines.find((l) => l.includes('localstack'));
-        expect(localstackLine).toBeDefined();
-        // Line must contain the description text
-        expect(localstackLine).toContain('LocalStack');
-    });
-    it('includes wiremock with its description on one line', () => {
-        const output = runTemplatesLogic();
-        const lines = output.split('\n').filter((l) => l.trim().length > 0);
-        const wiremockLine = lines.find((l) => l.includes('wiremock'));
-        expect(wiremockLine).toBeDefined();
-        // Line must contain the description text
-        expect(wiremockLine).toContain('WireMock');
-    });
-    it('uses padEnd(16) so name and description are tab-aligned', () => {
-        const output = runTemplatesLogic();
-        // Each line should start with two spaces and the name padded to ≥16 chars + two spaces
-        const lines = output.split('\n').filter((l) => l.trim().length > 0);
-        for (const line of lines) {
-            // Format: "  <name padEnd(16)>  <description>"
-            expect(line).toMatch(/^  \S.{14,}  \S/);
-        }
-    });
-});
-//# sourceMappingURL=templates-cli.test.js.map