@zigrivers/scaffold 3.16.0 → 3.18.0

package/dist/e2e/cross-service-references.test.d.ts

@@ -0,0 +1,22 @@
+/**
+ * E2E integration tests for cross-service references (Wave 3c).
+ *
+ * Scope note: these tests exercise the full cross-reads resolver against the
+ * real filesystem (StateManager.loadStateReadOnly, migrateState, state merging,
+ * per-service cache, transitive DFS). MetaPromptFile fixtures are typed objects
+ * rather than on-disk pipeline content because Wave 3c is the first feature to
+ * use the crossReads frontmatter field — no real pipeline step uses it yet.
+ * CLI-wiring coverage (loadPipelineContext + runCommand.handler) lives in
+ * src/cli/commands/run.test.ts's "cross-reads artifact gathering (Wave 3c)"
+ * suite, which mocks resolveTransitiveCrossReads at the module boundary.
+ *
+ * Verifies:
+ *  - resolveTransitiveCrossReads returns foreign service artifacts
+ *  - transitive chain A → B → C surfaces C's artifact via B's crossReads
+ *  - the read-only loader NEVER writes to foreign state — regression test for
+ *    the Round-4 P0 (migrateState → saveState clobbering next_eligible)
+ *  - cross-reads work while a foreign service's lock is held (no deadlock,
+ *    no foreign-state write under concurrency)
+ */
+export {};
+//# sourceMappingURL=cross-service-references.test.d.ts.map

package/dist/e2e/cross-service-references.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-service-references.test.d.ts","sourceRoot":"","sources":["../../src/e2e/cross-service-references.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG"}

package/dist/e2e/cross-service-references.test.js

@@ -0,0 +1,230 @@
+/**
+ * E2E integration tests for cross-service references (Wave 3c).
+ *
+ * Scope note: these tests exercise the full cross-reads resolver against the
+ * real filesystem (StateManager.loadStateReadOnly, migrateState, state merging,
+ * per-service cache, transitive DFS). MetaPromptFile fixtures are typed objects
+ * rather than on-disk pipeline content because Wave 3c is the first feature to
+ * use the crossReads frontmatter field — no real pipeline step uses it yet.
+ * CLI-wiring coverage (loadPipelineContext + runCommand.handler) lives in
+ * src/cli/commands/run.test.ts's "cross-reads artifact gathering (Wave 3c)"
+ * suite, which mocks resolveTransitiveCrossReads at the module boundary.
+ *
+ * Verifies:
+ *  - resolveTransitiveCrossReads returns foreign service artifacts
+ *  - transitive chain A → B → C surfaces C's artifact via B's crossReads
+ *  - the read-only loader NEVER writes to foreign state — regression test for
+ *    the Round-4 P0 (migrateState → saveState clobbering next_eligible)
+ *  - cross-reads work while a foreign service's lock is held (no deadlock,
+ *    no foreign-state write under concurrency)
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { resolveTransitiveCrossReads } from '../core/assembly/cross-reads.js';
+function mkOutput() {
+    return {
+        warn: vi.fn(), info: vi.fn(), success: vi.fn(), error: vi.fn(),
+        result: vi.fn(),
+        supportsInteractivePrompts: vi.fn().mockReturnValue(false),
+        prompt: vi.fn(), confirm: vi.fn(), select: vi.fn(),
+        multiSelect: vi.fn(), multiInput: vi.fn(),
+        startSpinner: vi.fn(), stopSpinner: vi.fn(),
+        startProgress: vi.fn(), updateProgress: vi.fn(), stopProgress: vi.fn(),
+    };
+}
+function mkMetaFile(name, crossReads = []) {
+    return {
+        stepName: name,
+        filePath: `/fake/${name}.md`,
+        frontmatter: {
+            name, description: '', summary: null,
+            phase: 'architecture', order: 700,
+            dependencies: [], outputs: [], conditional: null,
+            knowledgeBase: [], reads: [], crossReads,
+            stateless: false, category: 'pipeline',
+        },
+        body: '', sections: {},
+    };
+}
+function writeState(filePath, steps) {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, JSON.stringify({
+        'schema-version': 3,
+        steps,
+        next_eligible: [],
+        in_progress: null,
+    }));
+}
+describe('Cross-service references E2E (Wave 3c)', () => {
+    let projectRoot;
+    const producerStep = 'domain-modeling'; // service-local step (not in multi-service-overlay)
+    beforeEach(() => {
+        projectRoot = path.join(os.tmpdir(), `scaffold-e2e-cross-${Date.now()}-${Math.random()}`);
+        fs.mkdirSync(path.join(projectRoot, 'docs'), { recursive: true });
+        fs.mkdirSync(path.join(projectRoot, '.scaffold', 'services', 'producer'), { recursive: true });
+        fs.mkdirSync(path.join(projectRoot, '.scaffold', 'services', 'consumer'), { recursive: true });
+        writeState(path.join(projectRoot, '.scaffold', 'state.json'), {});
+        writeState(path.join(projectRoot, '.scaffold', 'services', 'producer', 'state.json'), { [producerStep]: { status: 'completed', produces: ['docs/contracts.md'] } });
+        writeState(path.join(projectRoot, '.scaffold', 'services', 'consumer', 'state.json'), {});
+        fs.writeFileSync(path.join(projectRoot, 'docs', 'contracts.md'), 'CONTRACTS');
+    });
+    afterEach(() => fs.rmSync(projectRoot, { recursive: true, force: true }));
+    const config = {
+        version: 2, methodology: 'deep', platforms: ['claude-code'],
+        project: {
+            services: [
+                {
+                    name: 'producer', projectType: 'library',
+                    libraryConfig: { visibility: 'internal' },
+                    exports: [{ step: producerStep }],
+                },
+                {
+                    name: 'consumer', projectType: 'backend',
+                    backendConfig: { apiStyle: 'rest' },
+                },
+            ],
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        },
+    };
+    it('resolveTransitiveCrossReads returns foreign service artifact end-to-end', () => {
+        const metas = new Map([
+            [producerStep, mkMetaFile(producerStep)],
+        ]);
+        const output = mkOutput();
+        const artifacts = resolveTransitiveCrossReads([{ service: 'producer', step: producerStep }], config, projectRoot, metas, output, new Set(), new Map(), new Map());
+        expect(artifacts).toEqual([
+            expect.objectContaining({
+                stepName: `producer:${producerStep}`,
+                filePath: 'docs/contracts.md',
+                content: 'CONTRACTS',
+            }),
+        ]);
+    });
+    it('transitive chain: consumer → producer → shared-lib surfaces all artifacts', () => {
+        // A third service 'shared-lib' produces docs/shared.md; producer's
+        // domain-modeling step cross-reads shared-lib, so consumer cross-reading
+        // producer should transitively receive shared-lib's artifact too.
+        fs.mkdirSync(path.join(projectRoot, '.scaffold', 'services', 'shared-lib'), { recursive: true });
+        fs.writeFileSync(path.join(projectRoot, 'docs', 'shared.md'), 'SHARED');
+        writeState(path.join(projectRoot, '.scaffold', 'services', 'shared-lib', 'state.json'), { 'api-contracts': { status: 'completed', produces: ['docs/shared.md'] } });
+        const transitiveConfig = {
+            version: 2, methodology: 'deep', platforms: ['claude-code'],
+            project: {
+                services: [
+                    {
+                        name: 'producer', projectType: 'library',
+                        libraryConfig: { visibility: 'internal' },
+                        exports: [{ step: producerStep }],
+                    },
+                    {
+                        name: 'shared-lib', projectType: 'library',
+                        libraryConfig: { visibility: 'internal' },
+                        exports: [{ step: 'api-contracts' }],
+                    },
+                    {
+                        name: 'consumer', projectType: 'backend',
+                        backendConfig: { apiStyle: 'rest' },
+                    },
+                ],
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            },
+        };
+        // Producer's step template declares a cross-read to shared-lib:api-contracts
+        const metas = new Map([
+            [producerStep, mkMetaFile(producerStep, [{ service: 'shared-lib', step: 'api-contracts' }])],
+            ['api-contracts', mkMetaFile('api-contracts')],
+        ]);
+        const output = mkOutput();
+        const artifacts = resolveTransitiveCrossReads([{ service: 'producer', step: producerStep }], // consumer → producer
+        transitiveConfig, projectRoot, metas, output, new Set(), new Map(), new Map());
+        const paths = artifacts.map(a => a.filePath).sort();
+        expect(paths).toEqual(['docs/contracts.md', 'docs/shared.md']);
+    });
+    it('NEVER writes to foreign state file even when migrateState would apply a rename', () => {
+        // Regression for Round-4 P0. Seed producer state with a deprecated step name
+        // that migrateState would rename (testing-strategy → tdd). If loadStateReadOnly
+        // or any downstream code calls saveState, this file's mtime changes.
+        const producerStatePath = path.join(projectRoot, '.scaffold', 'services', 'producer', 'state.json');
+        writeState(producerStatePath, {
+            [producerStep]: { status: 'completed', produces: ['docs/contracts.md'] },
+            'testing-strategy': { status: 'completed', produces: ['docs/tdd.md'] },
+        });
+        // Backdate so a same-millisecond write would still be detectable
+        const backdated = new Date(Date.now() - 2000);
+        fs.utimesSync(producerStatePath, backdated, backdated);
+        const mtimeBefore = fs.statSync(producerStatePath).mtimeMs;
+        const metas = new Map([
+            [producerStep, mkMetaFile(producerStep)],
+        ]);
+        const output = mkOutput();
+        resolveTransitiveCrossReads([{ service: 'producer', step: producerStep }], config, projectRoot, metas, output, new Set(), new Map(), new Map());
+        const mtimeAfter = fs.statSync(producerStatePath).mtimeMs;
+        expect(mtimeAfter).toBe(mtimeBefore); // file NOT written
+    });
+    it('cross-read succeeds when producer service has an active lock (no deadlock, no write)', () => {
+        // Simulate a foreign service lock held by another concurrent run
+        const lockDir = path.join(projectRoot, '.scaffold', 'services', 'producer');
+        const lockPath = path.join(lockDir, 'lock.json');
+        fs.writeFileSync(lockPath, JSON.stringify({
+            pid: 999999, step: producerStep, acquired: new Date().toISOString(),
+        }));
+        const statePath = path.join(lockDir, 'state.json');
+        const backdated = new Date(Date.now() - 2000);
+        fs.utimesSync(statePath, backdated, backdated);
+        const mtimeBefore = fs.statSync(statePath).mtimeMs;
+        const metas = new Map([
+            [producerStep, mkMetaFile(producerStep)],
+        ]);
+        const output = mkOutput();
+        // Must complete without hanging on the lock — read-only loader acquires no lock.
+        const artifacts = resolveTransitiveCrossReads([{ service: 'producer', step: producerStep }], config, projectRoot, metas, output, new Set(), new Map(), new Map());
+        expect(artifacts.length).toBeGreaterThan(0);
+        // Still no write to foreign state
+        expect(fs.statSync(statePath).mtimeMs).toBe(mtimeBefore);
+    });
+    it('overlay-only crossRead (no frontmatter entry) surfaces through resolveTransitiveCrossReads (Wave 3c+1)', () => {
+        // Step B's frontmatter has no crossReads; an overlay adds one pointing at C.
+        // Passing the overlay map to the resolver must surface C's artifact.
+        fs.mkdirSync(path.join(projectRoot, '.scaffold', 'services', 'consumer2'), { recursive: true });
+        fs.writeFileSync(path.join(projectRoot, 'docs', 'extra.md'), 'EXTRA');
+        writeState(path.join(projectRoot, '.scaffold', 'services', 'consumer2', 'state.json'), { 'extra-step': { status: 'completed', produces: ['docs/extra.md'] } });
+        const configWithExtraExport = {
+            version: 2, methodology: 'deep', platforms: ['claude-code'],
+            project: {
+                services: [
+                    {
+                        name: 'producer', projectType: 'library',
+                        libraryConfig: { visibility: 'internal' },
+                        exports: [{ step: producerStep }],
+                    },
+                    {
+                        name: 'consumer2', projectType: 'library',
+                        libraryConfig: { visibility: 'internal' },
+                        exports: [{ step: 'extra-step' }],
+                    },
+                    {
+                        name: 'consumer', projectType: 'backend',
+                        backendConfig: { apiStyle: 'rest' },
+                    },
+                ],
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            },
+        };
+        const metas = new Map([
+            [producerStep, mkMetaFile(producerStep)], // no frontmatter crossReads
+        ]);
+        // Overlay adds a cross-read to producer's step
+        const overlayCrossReads = {
+            [producerStep]: [{ service: 'consumer2', step: 'extra-step' }],
+        };
+        const output = mkOutput();
+        const artifacts = resolveTransitiveCrossReads([{ service: 'producer', step: producerStep }], configWithExtraExport, projectRoot, metas, output, new Set(), new Map(), new Map(), undefined, // globalSteps
+        overlayCrossReads);
+        const paths = artifacts.map(a => a.filePath).sort();
+        // producer's own docs/contracts.md + consumer2's docs/extra.md (via overlay-added crossRead)
+        expect(paths).toEqual(['docs/contracts.md', 'docs/extra.md']);
+    });
+});
+//# sourceMappingURL=cross-service-references.test.js.map

package/dist/e2e/cross-service-references.test.js.map

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

package/dist/e2e/multi-service-pipeline.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * E2E tests for multi-service pipeline — exercises resolveOverlayState with
+ * a services[] config, verifies cross-service steps are enabled, knowledge
+ * is injected, and reads/dependencies are wired correctly.
+ *
+ * Follows the same pattern as game-pipeline.test.ts: real meta-prompts via
+ * vi.importActual, mocked detectProjectMode and discoverMetaPrompts.
+ */
+export {};
+//# sourceMappingURL=multi-service-pipeline.test.d.ts.map

package/dist/e2e/multi-service-pipeline.test.d.ts.map

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

package/dist/e2e/multi-service-pipeline.test.js

@@ -0,0 +1,185 @@
+/**
+ * E2E tests for multi-service pipeline — exercises resolveOverlayState with
+ * a services[] config, verifies cross-service steps are enabled, knowledge
+ * is injected, and reads/dependencies are wired correctly.
+ *
+ * Follows the same pattern as game-pipeline.test.ts: real meta-prompts via
+ * vi.importActual, mocked detectProjectMode and discoverMetaPrompts.
+ */
+import { describe, it, expect, vi } from 'vitest';
+// ---------------------------------------------------------------------------
+// Hoisted mocks — must appear before real imports
+// ---------------------------------------------------------------------------
+vi.mock('../../src/project/detector.js', () => ({
+    detectProjectMode: vi.fn(() => ({
+        mode: 'greenfield',
+        signals: [],
+        methodologySuggestion: 'deep',
+        sourceFileCount: 0,
+    })),
+}));
+vi.mock('../../src/core/assembly/meta-prompt-loader.js', () => ({
+    discoverMetaPrompts: vi.fn(() => new Map()),
+    discoverAllMetaPrompts: vi.fn(() => new Map()),
+}));
+// ---------------------------------------------------------------------------
+// Real imports (after mock declarations)
+// ---------------------------------------------------------------------------
+import { loadAllPresets } from '../core/assembly/preset-loader.js';
+import { resolveOverlayState } from '../core/assembly/overlay-state-resolver.js';
+import { getPackagePipelineDir, getPackageMethodologyDir } from '../utils/fs.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function createMockOutput() {
+    return {
+        success: vi.fn(),
+        info: vi.fn(),
+        warn: vi.fn(),
+        error: vi.fn(),
+        result: vi.fn(),
+        supportsInteractivePrompts: vi.fn().mockReturnValue(false),
+        prompt: vi.fn().mockResolvedValue(''),
+        confirm: vi.fn().mockResolvedValue(false),
+        select: vi.fn().mockResolvedValue(''),
+        multiSelect: vi.fn().mockResolvedValue([]),
+        multiInput: vi.fn().mockResolvedValue([]),
+        startSpinner: vi.fn(),
+        stopSpinner: vi.fn(),
+        startProgress: vi.fn(),
+        updateProgress: vi.fn(),
+        stopProgress: vi.fn(),
+    };
+}
+/**
+ * Discover real meta-prompts from the package pipeline directory
+ * and build a Map suitable for resolveOverlayState.
+ * Uses vi.importActual to bypass the vi.mock and get the real loader.
+ */
+async function discoverRealMetaPrompts() {
+    const pipelineDir = getPackagePipelineDir();
+    const actual = await vi.importActual('../core/assembly/meta-prompt-loader.js');
+    return actual.discoverMetaPrompts(pipelineDir);
+}
+/**
+ * Resolve the multi-service overlay with a given methodology against the real pipeline.
+ * Config includes a services[] array to activate the structural overlay pass.
+ */
+async function resolveMultiServiceOverlay(methodology = 'deep') {
+    const methodologyDir = getPackageMethodologyDir();
+    const realMetaPrompts = await discoverRealMetaPrompts();
+    const knownSteps = [...realMetaPrompts.keys()];
+    const presets = loadAllPresets(methodologyDir, knownSteps);
+    const output = createMockOutput();
+    const preset = methodology === 'mvp' ? presets.mvp : presets.deep;
+    const overlayState = resolveOverlayState({
+        config: {
+            version: 2,
+            methodology,
+            platforms: ['claude-code'],
+            project: {
+                services: [
+                    {
+                        name: 'api', projectType: 'backend',
+                        backendConfig: {
+                            apiStyle: 'rest', dataStore: ['relational'], authMechanism: 'jwt',
+                            asyncMessaging: 'none', deployTarget: 'container', domain: 'none',
+                        },
+                    },
+                    {
+                        name: 'web', projectType: 'web-app',
+                        webAppConfig: {
+                            deployTarget: 'container', renderingStrategy: 'spa',
+                            realtime: 'none', authFlow: 'none',
+                        },
+                    },
+                ],
+            },
+        },
+        methodologyDir,
+        metaPrompts: realMetaPrompts,
+        presetSteps: preset?.steps ?? {},
+        output,
+    });
+    return { overlayState, realMetaPrompts };
+}
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe('multi-service pipeline E2E', () => {
+    // Test 1: All 5 cross-service steps enabled when services[] present
+    it('enables cross-service steps when services[] present', async () => {
+        const { overlayState } = await resolveMultiServiceOverlay();
+        const crossServiceSteps = [
+            'service-ownership-map',
+            'inter-service-contracts',
+            'cross-service-auth',
+            'cross-service-observability',
+            'integration-test-plan',
+        ];
+        for (const step of crossServiceSteps) {
+            expect(overlayState.steps[step], `${step} should be defined`).toBeDefined();
+            expect(overlayState.steps[step].enabled, `${step} should be enabled`).toBe(true);
+        }
+    });
+    // Test 2: Cross-service steps stay disabled when no services[]
+    it('does NOT enable cross-service steps when no services[]', async () => {
+        const methodologyDir = getPackageMethodologyDir();
+        const realMetaPrompts = await discoverRealMetaPrompts();
+        const knownSteps = [...realMetaPrompts.keys()];
+        const presets = loadAllPresets(methodologyDir, knownSteps);
+        const output = createMockOutput();
+        const overlayState = resolveOverlayState({
+            config: {
+                version: 2,
+                methodology: 'deep',
+                platforms: ['claude-code'],
+                project: {
+                    projectType: 'backend',
+                    backendConfig: {
+                        apiStyle: 'rest', dataStore: ['relational'], authMechanism: 'jwt',
+                        asyncMessaging: 'none', deployTarget: 'container', domain: 'none',
+                    },
+                },
+            },
+            methodologyDir,
+            metaPrompts: realMetaPrompts,
+            presetSteps: presets.deep?.steps ?? {},
+            output,
+        });
+        const crossServiceSteps = [
+            'service-ownership-map',
+            'inter-service-contracts',
+            'cross-service-auth',
+            'cross-service-observability',
+            'integration-test-plan',
+        ];
+        for (const step of crossServiceSteps) {
+            const stepEntry = overlayState.steps[step];
+            if (stepEntry !== undefined) {
+                expect(stepEntry.enabled, `${step} should not be enabled without services[]`).toBe(false);
+            }
+            // If not present in steps at all, it defaults to disabled — also acceptable
+        }
+    });
+    // Test 3: Multi-service knowledge injected into existing steps
+    it('injects multi-service knowledge into existing steps', async () => {
+        const { overlayState } = await resolveMultiServiceOverlay();
+        expect(overlayState.knowledge['system-architecture']).toBeDefined();
+        expect(overlayState.knowledge['system-architecture']).toContain('multi-service-architecture');
+        expect(overlayState.knowledge['system-architecture']).toContain('multi-service-resilience');
+    });
+    // Test 4: Reads injected into downstream steps
+    it('injects reads into downstream steps', async () => {
+        const { overlayState } = await resolveMultiServiceOverlay();
+        expect(overlayState.reads['implementation-plan']).toBeDefined();
+        expect(overlayState.reads['implementation-plan']).toContain('service-ownership-map');
+    });
+    // Test 5: Dependencies injected into downstream steps
+    it('injects dependencies into downstream steps', async () => {
+        const { overlayState } = await resolveMultiServiceOverlay();
+        expect(overlayState.dependencies['review-security']).toBeDefined();
+        expect(overlayState.dependencies['review-security']).toContain('cross-service-auth');
+    });
+});
+//# sourceMappingURL=multi-service-pipeline.test.js.map

package/dist/e2e/multi-service-pipeline.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-service-pipeline.test.js","sourceRoot":"","sources":["../../src/e2e/multi-service-pipeline.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAEjD,8EAA8E;AAC9E,kDAAkD;AAClD,8EAA8E;AAE9E,EAAE,CAAC,IAAI,CAAC,+BAA+B,EAAE,GAAG,EAAE,CAAC,CAAC;IAC9C,iBAAiB,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;QAC9B,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,EAAE;QACX,qBAAqB,EAAE,MAAM;QAC7B,eAAe,EAAE,CAAC;KACnB,CAAC,CAAC;CACJ,CAAC,CAAC,CAAA;AAEH,EAAE,CAAC,IAAI,CAAC,+CAA+C,EAAE,GAAG,EAAE,CAAC,CAAC;IAC9D,mBAAmB,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC;IAC3C,sBAAsB,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC;CAC/C,CAAC,CAAC,CAAA;AAEH,8EAA8E;AAC9E,yCAAyC;AACzC,8EAA8E;AAE9E,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAA;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAA;AAChF,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAA;AAIhF,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,SAAS,gBAAgB;IACvB,OAAO;QACL,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE;QAChB,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE;QACb,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE;QACb,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE;QACd,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE;QACf,0BAA0B,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC;QAC1D,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACrC,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,KAAK,CAAC;QACzC,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACrC,WAAW,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAC1C,UAAU,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACzC,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE;QACrB,WAAW,EAAE,EAAE,CAAC,EAAE,EAAE;QACpB,aAAa,EAAE,EAAE,CAAC,EAAE,EAAE;QACtB,cAAc,EAAE,EAAE,CAAC,EAAE,EAAE;QACvB,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE;KACtB,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,uBAAuB;IACpC,MAAM,WAAW,GAAG,qBAAqB,EAAE,CAAA;IAC3C,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,YAAY,CAClC,wCAAwC,CACzC,CAAA;IACD,OAAO,MAAM,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAA;AAChD,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,0BAA0B,CACvC,cAA8B,MAAM;IAEpC,MAAM,cAAc,GAAG,wBAAwB,EAAE,CAAA;IACjD,MAAM,eAAe,GAAG,MAAM,uBAAuB,EAAE,CAAA;IACvD,MAAM,UAAU,GAAG,CAAC,GAAG,eAAe,CAAC,IAAI,EAAE,CAAC,CAAA;IAC9C,MAAM,OAAO,GAAG,cAAc,CAAC,cAAc,EAAE,UAAU,CAAC,CAAA;IAC1D,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAA;IAEjC,MAAM,MAAM,GAAG,WAAW,KAAK,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAA;IACjE,MAAM,YAAY,GAAG,mBAAmB,CAAC;QACvC,MAAM,EAAE;YACN,OAAO,EAAE,CAAC;YACV,WAAW;YACX,SAAS,EAAE,CAAC,aAAa,CAAC;YAC1B,OAAO,EAAE;gBACP,QAAQ,EAAE;oBACR;wBACE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS;wBACnC,aAAa,EAAE;4BACb,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,YAAY,CAAC,EAAE,aAAa,EAAE,KAAK;4BACjE,cAAc,EAAE,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM;yBAClE;qBACF;oBACD;wBACE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS;wBACnC,YAAY,EAAE;4BACZ,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,KAAK;4BACnD,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;yBACnC;qBACF;iBACF;aACF;SACF;QACD,cAAc;QACd,WAAW,EAAE,eAAe;QAC5B,WAAW,EAAE,MAAM,EAAE,KAAK,IAAI,EAAE;QAChC,MAAM;KACP,CAAC,CAAA;IAEF,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,CAAA;AAC1C,CAAC;AAED,8EAA8E;AAC9E,QAAQ;AACR,8EAA8E;AAE9E,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;IAC1C,oEAAoE;IACpE,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;QACnE,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,0BAA0B,EAAE,CAAA;QAE3D,MAAM,iBAAiB,GAAG;YACxB,uBAAuB;YACvB,yBAAyB;YACzB,oBAAoB;YACpB,6BAA6B;YAC7B,uBAAuB;SACxB,CAAA;QAED,KAAK,MAAM,IAAI,IAAI,iBAAiB,EAAE,CAAC;YACrC,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,oBAAoB,CAAC,CAAC,WAAW,EAAE,CAAA;YAC3E,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAE,CAAC,OAAO,EAAE,GAAG,IAAI,oBAAoB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACnF,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,+DAA+D;IAC/D,EAAE,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;QACtE,MAAM,cAAc,GAAG,wBAAwB,EAAE,CAAA;QACjD,MAAM,eAAe,GAAG,MAAM,uBAAuB,EAAE,CAAA;QACvD,MAAM,UAAU,GAAG,CAAC,GAAG,eAAe,CAAC,IAAI,EAAE,CAAC,CAAA;QAC9C,MAAM,OAAO,GAAG,cAAc,CAAC,cAAc,EAAE,UAAU,CAAC,CAAA;QAC1D,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAA;QAEjC,MAAM,YAAY,GAAG,mBAAmB,CAAC;YACvC,MAAM,EAAE;gBACN,OAAO,EAAE,CAAC;gBACV,WAAW,EAAE,MAAM;gBACnB,SAAS,EAAE,CAAC,aAAa,CAAC;gBAC1B,OAAO,EAAE;oBACP,WAAW,EAAE,SAAS;oBACtB,aAAa,EAAE;wBACb,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,YAAY,CAAC,EAAE,aAAa,EAAE,KAAK;wBACjE,cAAc,EAAE,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM;qBAClE;iBACF;aACF;YACD,cAAc;YACd,WAAW,EAAE,eAAe;YAC5B,WAAW,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE;YACtC,MAAM;SACP,CAAC,CAAA;QAEF,MAAM,iBAAiB,GAAG;YACxB,uBAAuB;YACvB,yBAAyB;YACzB,oBAAoB;YACpB,6BAA6B;YAC7B,uBAAuB;SACxB,CAAA;QAED,KAAK,MAAM,IAAI,IAAI,iBAAiB,EAAE,CAAC;YACrC,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YAC1C,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC5B,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,IAAI,2CAA2C,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YAC3F,CAAC;YACD,4EAA4E;QAC9E,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,+DAA+D;IAC/D,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;QACnE,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,0BAA0B,EAAE,CAAA;QAE3D,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC,CAAC,WAAW,EAAE,CAAA;QACnE,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC,CAAC,SAAS,CAAC,4BAA4B,CAAC,CAAA;QAC7F,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC,CAAC,SAAS,CAAC,0BAA0B,CAAC,CAAA;IAC7F,CAAC,CAAC,CAAA;IAEF,+CAA+C;IAC/C,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;QACnD,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,0BAA0B,EAAE,CAAA;QAE3D,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,CAAC,WAAW,EAAE,CAAA;QAC/D,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAA;IACtF,CAAC,CAAC,CAAA;IAEF,sDAAsD;IACtD,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC1D,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,0BAA0B,EAAE,CAAA;QAE3D,MAAM,CAAC,YAAY,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAC,CAAC,WAAW,EAAE,CAAA;QAClE,MAAM,CAAC,YAAY,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAA;IACtF,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/e2e/project-type-overlays.test.js

@@ -360,6 +360,74 @@ describe('backend overlay integration', () => {
         expect(overlayState.knowledge['system-architecture']).toContain('backend-architecture');
         expect(overlayState.knowledge['tech-stack']).toContain('backend-api-design');
     });
+    // -------------------------------------------------------------------------
+    // Sub-overlay: backend-fintech
+    // -------------------------------------------------------------------------
+    /**
+     * Resolve a backend overlay with an explicit domain sub-overlay selection.
+     * Mirrors `resolveResearchOverlay` but for the backend project type.
+     * A FULL typed BackendConfig literal is required because BackendConfig is
+     * inferred from BackendConfigSchema's *output* shape (all defaults resolved).
+     */
+    async function resolveBackendOverlayWithDomain(domain) {
+        const backendConfig = {
+            apiStyle: 'rest',
+            dataStore: ['relational'],
+            authMechanism: 'none',
+            asyncMessaging: 'none',
+            deployTarget: 'container',
+            domain,
+        };
+        const methodologyDir = getPackageMethodologyDir();
+        const realMetaPrompts = await discoverRealMetaPrompts();
+        const knownSteps = [...realMetaPrompts.keys()];
+        const presets = loadAllPresets(methodologyDir, knownSteps);
+        const output = createMockOutput();
+        const preset = presets.deep;
+        return resolveOverlayState({
+            config: {
+                version: 2,
+                methodology: 'deep',
+                platforms: ['claude-code'],
+                project: {
+                    projectType: 'backend',
+                    backendConfig,
+                },
+            },
+            methodologyDir,
+            metaPrompts: realMetaPrompts,
+            presetSteps: preset?.steps ?? {},
+            output,
+        });
+    }
+    it('fintech domain knowledge appended after core backend knowledge', async () => {
+        const state = await resolveBackendOverlayWithDomain('fintech');
+        // Core backend overlay entry is present in create-prd
+        expect(state.knowledge['create-prd']).toContain('backend-requirements');
+        // Fintech sub-overlay entries present on create-prd (per backend-fintech.yml)
+        expect(state.knowledge['create-prd']).toContain('backend-fintech-compliance');
+        expect(state.knowledge['create-prd']).toContain('backend-fintech-broker-integration');
+        // Domain knowledge appears AFTER core knowledge (appended)
+        const prdKnowledge = state.knowledge['create-prd'];
+        const coreIdx = prdKnowledge.indexOf('backend-requirements');
+        const domainIdx = prdKnowledge.indexOf('backend-fintech-compliance');
+        expect(domainIdx).toBeGreaterThan(coreIdx);
+        // Spot-check another step: system-architecture gets broker-integration + risk-management
+        expect(state.knowledge['system-architecture']).toContain('backend-architecture');
+        expect(state.knowledge['system-architecture']).toContain('backend-fintech-broker-integration');
+        expect(state.knowledge['system-architecture']).toContain('backend-fintech-risk-management');
+    });
+    it('backend domain=none skips fintech sub-overlay', async () => {
+        const state = await resolveBackendOverlayWithDomain('none');
+        // Core backend knowledge is present
+        expect(state.knowledge['create-prd']).toContain('backend-requirements');
+        expect(state.knowledge['system-architecture']).toContain('backend-architecture');
+        // Fintech sub-overlay entries are NOT present
+        expect(state.knowledge['create-prd']).not.toContain('backend-fintech-compliance');
+        expect(state.knowledge['create-prd']).not.toContain('backend-fintech-broker-integration');
+        expect(state.knowledge['system-architecture']).not.toContain('backend-fintech-broker-integration');
+        expect(state.knowledge['system-architecture']).not.toContain('backend-fintech-risk-management');
+    });
 });
 // ---------------------------------------------------------------------------
 // Tests — CLI