@cspeach/cli 0.6.4 → 0.7.0

package/dist/projects/__tests__/extract-spec-gap.test.js

@@ -1,122 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { readFileSync } from 'node:fs';
-import { dirname, join } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { extractSpecGap } from '../extract-spec-gap.js';
-// ESM (`"type": "module"` in package.json): __dirname is NOT defined.
-// Derive it via import.meta.url. See cspeach-cli/test/unit/skill-catalog.test.ts.
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const FIXTURE = readFileSync(join(__dirname, '..', '__fixtures__', 'spec-gap-skill-output.md'), 'utf8');
-describe('extractSpecGap', () => {
-    it('parses TL;DR title', () => {
-        const r = extractSpecGap(FIXTURE);
-        expect(r.title).toBe('Customer Aging Report');
-    });
-    it('extracts at least 7 sections', () => {
-        const r = extractSpecGap(FIXTURE);
-        expect(r.content.sections.length).toBeGreaterThanOrEqual(7);
-    });
-    it('first section is "Missing Business Questions" (after TL;DR)', () => {
-        const r = extractSpecGap(FIXTURE);
-        expect(r.content.sections[0].name).toMatch(/Missing Business Questions/i);
-    });
-    it('extracts gaps with stable gap-001, gap-002 ids', () => {
-        const r = extractSpecGap(FIXTURE);
-        const allGaps = r.content.sections.flatMap((s) => s.gaps);
-        expect(allGaps[0].id).toBe('gap-001');
-        expect(allGaps[1].id).toBe('gap-002');
-    });
-    it('parses severity from leading [BLOCKER]/[IMPORTANT]/[NICE TO KNOW]', () => {
-        const r = extractSpecGap(FIXTURE);
-        const allGaps = r.content.sections.flatMap((s) => s.gaps);
-        const blockers = allGaps.filter((g) => g.severity === 'BLOCKER');
-        const important = allGaps.filter((g) => g.severity === 'IMPORTANT');
-        const nice = allGaps.filter((g) => g.severity === 'NICE TO KNOW');
-        expect(blockers.length).toBeGreaterThan(0);
-        expect(important.length).toBeGreaterThan(0);
-        expect(nice.length).toBeGreaterThan(0);
-        expect(blockers.length + important.length + nice.length).toBe(allGaps.length);
-    });
-    it('every gap gets a matching interaction.items entry with status="open"', () => {
-        const r = extractSpecGap(FIXTURE);
-        const allGaps = r.content.sections.flatMap((s) => s.gaps);
-        expect(r.items.length).toBe(allGaps.length);
-        expect(r.items.every((i) => i.status === 'open')).toBe(true);
-        expect(r.items.every((i) => i.answer === null)).toBe(true);
-        expect(r.items.every((i) => i.comments.length === 0)).toBe(true);
-    });
-    it('extracts inferredDomain from the "Inferred Domain:" line', () => {
-        const r = extractSpecGap(FIXTURE);
-        expect(r.content.inferredDomain.length).toBeGreaterThan(0);
-    });
-    it('throws on input without TL;DR + sections', () => {
-        expect(() => extractSpecGap('Hello world')).toThrow(/not a spec-gap output/i);
-    });
-    it('parses indented gap lines (real-world model output style)', () => {
-        const indented = [
-            '## Spec Gap Analysis — Test',
-            '',
-            '### Missing Business Questions',
-            '',
-            '    1. [BLOCKER] What defines "open"?',
-            '    2. [IMPORTANT] Currency rate?',
-        ].join('\n');
-        const r = extractSpecGap(indented);
-        expect(r.content.sections).toHaveLength(1);
-        expect(r.content.sections[0].gaps).toHaveLength(2);
-        expect(r.content.sections[0].gaps[0].text).toBe('What defines "open"?');
-    });
-    it('parses tab-indented gap lines', () => {
-        const tabbed = [
-            '## Spec Gap Analysis — Test',
-            '',
-            '### Missing Business Questions',
-            '',
-            '\t1. [BLOCKER] What defines "open"?',
-        ].join('\n');
-        const r = extractSpecGap(tabbed);
-        expect(r.content.sections[0].gaps).toHaveLength(1);
-    });
-    it('parses bold-wrapped severity (real-world variant: `1. **[BLOCKER]** Text`)', () => {
-        const bolded = [
-            '## Spec Gap Analysis — Test',
-            '',
-            '### Missing Business Questions',
-            '',
-            '1. **[BLOCKER]** What is the precise definition of "open"?',
-            '2. **[IMPORTANT]** Currency rate?',
-            '3. **[NICE TO KNOW]** Saved variants?',
-        ].join('\n');
-        const r = extractSpecGap(bolded);
-        expect(r.content.sections).toHaveLength(1);
-        expect(r.content.sections[0].gaps).toHaveLength(3);
-        expect(r.content.sections[0].gaps[0].severity).toBe('BLOCKER');
-        expect(r.content.sections[0].gaps[1].severity).toBe('IMPORTANT');
-        expect(r.content.sections[0].gaps[2].severity).toBe('NICE TO KNOW');
-        expect(r.content.sections[0].gaps[0].text).toBe('What is the precise definition of "open"?');
-    });
-    it('parses indent + bold-wrapped severity together', () => {
-        const both = [
-            '## Spec Gap Analysis — Test',
-            '',
-            '### Missing Business Questions',
-            '',
-            '    1. **[BLOCKER]** Mixed-style line',
-        ].join('\n');
-        const r = extractSpecGap(both);
-        expect(r.content.sections[0].gaps).toHaveLength(1);
-        expect(r.content.sections[0].gaps[0].severity).toBe('BLOCKER');
-        expect(r.content.sections[0].gaps[0].text).toBe('Mixed-style line');
-    });
-    it('tags sections with audience derived from name', () => {
-        const r = extractSpecGap(FIXTURE);
-        const audienceBySection = Object.fromEntries(r.content.sections.map((s) => [s.name, s.audience]));
-        expect(audienceBySection['Missing Business Questions']).toBe('business');
-        expect(audienceBySection['Missing Technical Questions']).toBe('technical');
-        expect(audienceBySection['Authorization Questions']).toBe('auth');
-        expect(audienceBySection['Edge Cases Not Covered']).toBe('business');
-        expect(audienceBySection['Transport and Release Concerns']).toBe('transport');
-        expect(audienceBySection['Clean Core / API Concerns']).toBe('clean-core');
-        expect(audienceBySection['Data Assumptions to Confirm']).toBe('data');
-    });
-});

package/dist/projects/__tests__/extract-test-coverage.test.js

@@ -1,133 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { extractTestCoverage } from '../extract-test-coverage.js';
-describe('extractTestCoverage', () => {
-    const FULL_FIXTURE = `# /abap-test — ZDPR_PAYMENTS test generation
-
-<!-- csforge:test-coverage-manifest
-artefact: test-coverage
-title: ZDPR_PAYMENTS — test coverage
-detail_path: .abapforge/tests/zdpr-payments/project.json
-baseline_path: .cspeach/zdpr-payments-cca-assessment-3467-v1.cspeach.json
-baseline_sha256: a7Qj8ibfLTj49kQRTn1DOE_UAExuoBgjhaXxf33+JPY=
-transport: S4HK903401
-test_classes_generated: 14
-methods_added: 87
-coverage_pct_before: 12
-coverage_pct_after: 78
-skipped: 0
-failed: 0
-tests:
-  item-001 | ZPAYMENTS         | PROG | ZPAYMENTS_TEST          | 6 | generated
-  item-002 | ZPAYMENTS_OLD     | PROG | ZPAYMENTS_OLD_TEST      | 4 | generated
-  item-003 | ZFGPAYMENTS       | FUGR | ZFGPAYMENTS_TEST        | 8 | generated
--->
-`;
-    it('extracts title from manifest', () => {
-        const out = extractTestCoverage(FULL_FIXTURE);
-        expect(out.title).toBe('ZDPR_PAYMENTS — test coverage');
-    });
-    it('extracts detail + baseline refs', () => {
-        const out = extractTestCoverage(FULL_FIXTURE);
-        expect(out.content.detailPath).toBe('.abapforge/tests/zdpr-payments/project.json');
-        expect(out.content.baselineRef.path).toBe('.cspeach/zdpr-payments-cca-assessment-3467-v1.cspeach.json');
-        expect(out.content.baselineRef.sha256).toBe('a7Qj8ibfLTj49kQRTn1DOE_UAExuoBgjhaXxf33+JPY=');
-    });
-    it('extracts summary with coverage percentages', () => {
-        const out = extractTestCoverage(FULL_FIXTURE);
-        expect(out.content.summary).toEqual({
-            testClassesGenerated: 14,
-            methodsAdded: 87,
-            coveragePctBefore: 12,
-            coveragePctAfter: 78,
-            skipped: 0,
-            failed: 0,
-        });
-    });
-    it('parses coverage_pct=- as null (SCMP unavailable case)', () => {
-        const noCov = FULL_FIXTURE
-            .replace('coverage_pct_before: 12', 'coverage_pct_before: -')
-            .replace('coverage_pct_after: 78', 'coverage_pct_after: -');
-        const out = extractTestCoverage(noCov);
-        expect(out.content.summary.coveragePctBefore).toBeNull();
-        expect(out.content.summary.coveragePctAfter).toBeNull();
-    });
-    it('parses missing coverage fields as null', () => {
-        const minimal = `<!-- csforge:test-coverage-manifest
-artefact: test-coverage
-detail_path: x
-baseline_path: y
-test_classes_generated: 1
-methods_added: 3
--->`;
-        const out = extractTestCoverage(minimal);
-        expect(out.content.summary.coveragePctBefore).toBeNull();
-        expect(out.content.summary.coveragePctAfter).toBeNull();
-    });
-    it('extracts tests table with method counts', () => {
-        const out = extractTestCoverage(FULL_FIXTURE);
-        expect(out.content.tests).toHaveLength(3);
-        expect(out.content.tests[0]).toEqual({
-            id: 'item-001',
-            targetObjectName: 'ZPAYMENTS',
-            targetObjectType: 'PROG',
-            testClassName: 'ZPAYMENTS_TEST',
-            methodCount: 6,
-            status: 'generated',
-        });
-    });
-    it('emits one InteractionItem per test entry with matching status', () => {
-        const out = extractTestCoverage(FULL_FIXTURE);
-        expect(out.items).toHaveLength(3);
-        for (const it of out.items) {
-            expect(it.status).toBe('generated');
-            expect(it.answer).toBeNull();
-        }
-    });
-    it('coerces unknown status to pending', () => {
-        const weird = `<!-- csforge:test-coverage-manifest
-artefact: test-coverage
-detail_path: x
-baseline_path: y
-tests:
-  item-001 | ZFOO | PROG | ZFOO_TEST | 2 | half-baked
--->`;
-        const out = extractTestCoverage(weird);
-        expect(out.content.tests[0]?.status).toBe('pending');
-    });
-    it('throws when artefact field disagrees', () => {
-        const wrong = `<!-- csforge:test-coverage-manifest
-artefact: cca-assessment
-detail_path: x
-baseline_path: y
--->`;
-        expect(() => extractTestCoverage(wrong)).toThrow(/expected 'test-coverage'/);
-    });
-    it('throws when detail_path is missing', () => {
-        const noDetail = `<!-- csforge:test-coverage-manifest
-artefact: test-coverage
-baseline_path: y
--->`;
-        expect(() => extractTestCoverage(noDetail)).toThrow(/'detail_path'/);
-    });
-    it('throws when baseline_path is missing', () => {
-        const noBaseline = `<!-- csforge:test-coverage-manifest
-artefact: test-coverage
-detail_path: x
--->`;
-        expect(() => extractTestCoverage(noBaseline)).toThrow(/'baseline_path'/);
-    });
-    it('throws when no manifest block', () => {
-        expect(() => extractTestCoverage('# nothing')).toThrow(/No <!-- csforge:test-coverage-manifest --> block/);
-    });
-    it('handles non-numeric methodCount as 0', () => {
-        const weird = `<!-- csforge:test-coverage-manifest
-artefact: test-coverage
-detail_path: x
-baseline_path: y
-tests:
-  item-001 | ZFOO | PROG | ZFOO_TEST | notanumber | generated
--->`;
-        const out = extractTestCoverage(weird);
-        expect(out.content.tests[0]?.methodCount).toBe(0);
-    });
-});

package/dist/projects/__tests__/filename.test.js

@@ -1,32 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { titleSlug, projectFilename, shortId } from '../filename.js';
-describe('titleSlug', () => {
-    it('lowercases + hyphenates', () => {
-        expect(titleSlug('Customer Aging Report')).toBe('customer-aging-report');
-    });
-    it('strips punctuation', () => {
-        expect(titleSlug('FI-AR: Customer Aging!')).toBe('fi-ar-customer-aging');
-    });
-    it('collapses whitespace + trims', () => {
-        expect(titleSlug('  Multi   space  ')).toBe('multi-space');
-    });
-    it('handles unicode by transliterating common cases', () => {
-        expect(titleSlug('Müller Bericht')).toBe('muller-bericht');
-    });
-    it('caps length at 60 chars', () => {
-        const long = 'A'.repeat(200);
-        expect(titleSlug(long).length).toBeLessThanOrEqual(60);
-    });
-});
-describe('shortId', () => {
-    it('returns first 4 chars of UUID', () => {
-        expect(shortId('a1b2c3d4-1111-4111-8111-111111111111')).toBe('a1b2');
-    });
-});
-describe('projectFilename', () => {
-    it('builds canonical filename', () => {
-        expect(projectFilename({ title: 'Customer Aging Report', artefactType: 'spec-gap',
-            id: 'a1b2c3d4-1111-4111-8111-111111111111', version: 1 }))
-            .toBe('customer-aging-report-spec-gap-a1b2-v1.cspeach.json');
-    });
-});

package/dist/projects/__tests__/promote-command.test.js

@@ -1,170 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { writeFileSync, mkdtempSync, rmSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-import { runPromoteCommand } from '../promote-command.js';
-function envelopeFixture(overrides = {}) {
-    const base = {
-        schemaVersion: '1.0',
-        artefactType: 'spec-gap',
-        id: '11111111-2222-3333-4444-555555555555',
-        title: 'Customer Aging Report',
-        createdAt: '2026-05-04T12:00:00Z',
-        createdBy: { name: 'Laeeq', role: 'consultant' },
-        lastEditedAt: '2026-05-04T16:00:00Z',
-        lastEditedBy: { name: 'Sarah', role: 'BA' },
-        version: 3,
-        source: { skill: 'abap-spec-gap', skillVersion: '1.0', input: '', tokensUsed: 0, model: 'claude-opus-4-7' },
-        promotedFrom: null,
-        content: {
-            inputType: 'User Story', inferredDomain: 'FI',
-            sections: [{ name: 'G', audience: 'business', gaps: [
-                        { id: 'gap-001', severity: 'BLOCKER', text: 'Q1' },
-                        { id: 'gap-002', severity: 'IMPORTANT', text: 'Q2' },
-                    ] }],
-        },
-        interaction: { items: [
-                { id: 'gap-001', status: 'answered', answer: 'A1', answeredBy: { name: 'S', role: 'BA' }, answeredAt: '2026-05-04T16:00:00Z', comments: [] },
-                { id: 'gap-002', status: 'answered', answer: 'A2', answeredBy: { name: 'S', role: 'BA' }, answeredAt: '2026-05-04T16:00:00Z', comments: [] },
-            ] },
-        history: [
-            { at: '2026-05-04T12:00:00Z', by: { name: 'L', role: 'consultant' }, action: 'created' },
-            { at: '2026-05-04T15:00:00Z', by: { name: 'Sarah', role: 'BA' }, action: 'edited', summary: '1 gap answered' },
-            { at: '2026-05-04T16:00:00Z', by: { name: 'Sarah', role: 'BA' }, action: 'edited', summary: '1 more gap answered' },
-        ],
-    };
-    return { ...base, ...overrides };
-}
-function writeFixture(path, env) {
-    writeFileSync(path, JSON.stringify(env, null, 2), 'utf8');
-    return path;
-}
-describe('runPromoteCommand', () => {
-    it('returns snapshot + extendedSkillInput when source is fully answered', async () => {
-        const dir = mkdtempSync(`${tmpdir()}/cspeach-promote-`);
-        try {
-            const path = writeFixture(join(dir, 'src.cspeach.json'), envelopeFixture());
-            const log = [];
-            const result = await runPromoteCommand({
-                sourcePath: path,
-                targetSkill: 'abap-design',
-                prompt: async () => 'y',
-                log: (...lines) => log.push(...lines),
-            });
-            expect(result).not.toBeNull();
-            expect(result.promotedFrom.artefactType).toBe('spec-gap');
-            expect(result.promotedFrom.version).toBe(3);
-            expect(result.extendedSkillInput).toContain('Promoted from spec-gap');
-            expect(result.extendedSkillInput).toContain('gap-001: Q1 → A1');
-        }
-        finally {
-            rmSync(dir, { recursive: true, force: true });
-        }
-    });
-    it('returns null and logs error when source artefactType mismatches', async () => {
-        const dir = mkdtempSync(`${tmpdir()}/cspeach-promote-`);
-        try {
-            const designFixture = {
-                ...envelopeFixture(),
-                artefactType: 'design',
-                content: { objects: [
-                        { id: 'obj-001', name: 'ZCL_X', type: 'CLAS', package: 'P', dependsOn: [] },
-                    ] },
-                interaction: { items: [
-                        { id: 'obj-001', status: 'keep', answer: null, answeredBy: null, answeredAt: null, comments: [] },
-                    ] },
-            };
-            const path = writeFixture(join(dir, 'src.cspeach.json'), designFixture);
-            const log = [];
-            const result = await runPromoteCommand({
-                sourcePath: path,
-                targetSkill: 'abap-design',
-                prompt: async () => 'y',
-                log: (...lines) => log.push(...lines),
-            });
-            expect(result).toBeNull();
-            expect(log.join('\n')).toContain('expects a spec-gap source');
-            expect(log.join('\n')).toContain('got design');
-        }
-        finally {
-            rmSync(dir, { recursive: true, force: true });
-        }
-    });
-    it('prompts to force-promote when source has open items, returns null on "no"', async () => {
-        const dir = mkdtempSync(`${tmpdir()}/cspeach-promote-`);
-        try {
-            const partial = envelopeFixture({
-                interaction: { items: [
-                        { id: 'gap-001', status: 'open', answer: null, answeredBy: null, answeredAt: null, comments: [] },
-                        { id: 'gap-002', status: 'answered', answer: 'A2', answeredBy: { name: 'S', role: 'BA' }, answeredAt: '2026-05-04T16:00:00Z', comments: [] },
-                    ] },
-            });
-            const path = writeFixture(join(dir, 'src.cspeach.json'), partial);
-            const prompts = [];
-            const result = await runPromoteCommand({
-                sourcePath: path,
-                targetSkill: 'abap-design',
-                prompt: async (q) => { prompts.push(q); return 'n'; },
-                log: () => { },
-            });
-            expect(result).toBeNull();
-            expect(prompts.join('\n')).toMatch(/Promote anyway/i);
-        }
-        finally {
-            rmSync(dir, { recursive: true, force: true });
-        }
-    });
-    it('zero-answered source: prompts and respects "no"', async () => {
-        const dir = mkdtempSync(`${tmpdir()}/cspeach-promote-`);
-        try {
-            const empty = envelopeFixture({
-                interaction: { items: [
-                        { id: 'gap-001', status: 'open', answer: null, answeredBy: null, answeredAt: null, comments: [] },
-                        { id: 'gap-002', status: 'open', answer: null, answeredBy: null, answeredAt: null, comments: [] },
-                    ] },
-            });
-            const path = writeFixture(join(dir, 'src.cspeach.json'), empty);
-            const prompts = [];
-            const result = await runPromoteCommand({
-                sourcePath: path,
-                targetSkill: 'abap-design',
-                prompt: async (q) => { prompts.push(q); return ''; },
-                log: () => { },
-            });
-            expect(result).toBeNull();
-            expect(prompts.join('\n')).toMatch(/no answered items/i);
-        }
-        finally {
-            rmSync(dir, { recursive: true, force: true });
-        }
-    });
-    it('estimate target accepts a design source', async () => {
-        const dir = mkdtempSync(`${tmpdir()}/cspeach-promote-`);
-        try {
-            const designEnv = {
-                ...envelopeFixture(),
-                artefactType: 'design',
-                content: { objects: [
-                        { id: 'obj-001', name: 'ZCL_X', type: 'CLAS', package: 'P', dependsOn: [] },
-                    ] },
-                interaction: { items: [
-                        { id: 'obj-001', status: 'keep', answer: null, answeredBy: null, answeredAt: null, comments: [] },
-                    ] },
-            };
-            const path = writeFixture(join(dir, 'src.cspeach.json'), designEnv);
-            const result = await runPromoteCommand({
-                sourcePath: path,
-                targetSkill: 'abap-estimate',
-                prompt: async () => 'y',
-                log: () => { },
-            });
-            expect(result).not.toBeNull();
-            expect(result.promotedFrom.artefactType).toBe('design');
-            expect(result.extendedSkillInput).toContain('Promoted from design');
-            expect(result.extendedSkillInput).toContain('obj-001: ZCL_X (CLAS) → keep');
-        }
-        finally {
-            rmSync(dir, { recursive: true, force: true });
-        }
-    });
-});

package/dist/projects/__tests__/promote.test.js

@@ -1,181 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { buildPromotedFromSnapshot, validatePromotionSource } from '../promote.js';
-const SPEC_GAP_SOURCE = {
-    schemaVersion: '1.0',
-    artefactType: 'spec-gap',
-    id: '11111111-2222-3333-4444-555555555555',
-    title: 'Customer Aging Report',
-    createdAt: '2026-05-04T12:00:00Z',
-    createdBy: { name: 'Laeeq', role: 'consultant' },
-    lastEditedAt: '2026-05-04T16:00:00Z',
-    lastEditedBy: { name: 'Sarah', role: 'BA' },
-    version: 3,
-    source: { skill: 'abap-spec-gap', skillVersion: '1.0', input: '', tokensUsed: 0, model: 'claude-opus-4-7' },
-    promotedFrom: null,
-    content: {
-        inputType: 'User Story', inferredDomain: 'FI',
-        sections: [
-            { name: 'Missing Business Questions', audience: 'business', gaps: [
-                    { id: 'gap-001', severity: 'BLOCKER', text: 'What defines "open"?' },
-                    { id: 'gap-002', severity: 'IMPORTANT', text: 'Which currency rate?' },
-                ] },
-        ],
-    },
-    interaction: { items: [
-            { id: 'gap-001', status: 'answered', answer: 'BSID open items only',
-                answeredBy: { name: 'Sarah', role: 'BA' }, answeredAt: '2026-05-04T16:00:00Z',
-                comments: [{ id: 'c1', by: { name: 'Sarah', role: 'BA' }, at: '2026-05-04T16:00:00Z', text: 'Confirmed with finance' }] },
-            { id: 'gap-002', status: 'open', answer: null, answeredBy: null, answeredAt: null, comments: [] },
-        ] },
-    history: [
-        { at: '2026-05-04T12:00:00Z', by: { name: 'Laeeq', role: 'consultant' }, action: 'created' },
-        { at: '2026-05-04T15:00:00Z', by: { name: 'Sarah', role: 'BA' }, action: 'edited', summary: '1 gap answered' },
-        { at: '2026-05-04T16:00:00Z', by: { name: 'Sarah', role: 'BA' }, action: 'edited', summary: 'no changes' },
-    ],
-};
-const DESIGN_SOURCE = {
-    ...SPEC_GAP_SOURCE,
-    artefactType: 'design',
-    content: { objects: [
-            { id: 'obj-001', name: 'ZCL_AGING', type: 'CLAS', package: 'ZAGING', dependsOn: [] },
-            { id: 'obj-002', name: 'ZTBL_AGING', type: 'TABL', package: 'ZAGING', dependsOn: ['obj-001'] },
-        ] },
-    interaction: { items: [
-            { id: 'obj-001', status: 'keep', answer: null, answeredBy: null, answeredAt: null, comments: [] },
-            { id: 'obj-002', status: 'redesign', answer: 'split into two', answeredBy: { name: 'A', role: 'arch' }, answeredAt: '2026-05-04T16:00:00Z', comments: [] },
-        ] },
-};
-describe('buildPromotedFromSnapshot — spec-gap source', () => {
-    it('preserves id, title, artefactType, version', async () => {
-        const snap = await buildPromotedFromSnapshot(SPEC_GAP_SOURCE);
-        expect(snap.id).toBe(SPEC_GAP_SOURCE.id);
-        expect(snap.title).toBe('Customer Aging Report');
-        expect(snap.artefactType).toBe('spec-gap');
-        expect(snap.version).toBe(3);
-    });
-    it('emits ISO snapshottedAt', async () => {
-        const snap = await buildPromotedFromSnapshot(SPEC_GAP_SOURCE);
-        expect(snap.snapshottedAt).toMatch(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}/);
-    });
-    it('computes a 64-char hex sha256 over the canonicalised source', async () => {
-        const snap = await buildPromotedFromSnapshot(SPEC_GAP_SOURCE);
-        expect(snap.sha256).toMatch(/^[0-9a-f]{64}$/);
-    });
-    it('includes severity for spec-gap items, never comments', async () => {
-        const snap = await buildPromotedFromSnapshot(SPEC_GAP_SOURCE);
-        expect(snap.snapshot.items).toHaveLength(2);
-        expect(snap.snapshot.items[0]).toMatchObject({
-            id: 'gap-001',
-            text: 'What defines "open"?',
-            severity: 'BLOCKER',
-            status: 'answered',
-            answer: 'BSID open items only',
-        });
-        expect(snap.snapshot.items[1]).toMatchObject({
-            id: 'gap-002',
-            text: 'Which currency rate?',
-            severity: 'IMPORTANT',
-            status: 'open',
-            answer: null,
-        });
-        for (const it of snap.snapshot.items) {
-            expect(it).not.toHaveProperty('comments');
-        }
-    });
-});
-describe('buildPromotedFromSnapshot — design source', () => {
-    it('uses object name + type as text and omits severity', async () => {
-        const snap = await buildPromotedFromSnapshot(DESIGN_SOURCE);
-        expect(snap.snapshot.items).toHaveLength(2);
-        expect(snap.snapshot.items[0]).toMatchObject({
-            id: 'obj-001',
-            text: 'ZCL_AGING (CLAS)',
-            status: 'keep',
-            answer: null,
-        });
-        expect(snap.snapshot.items[0]).not.toHaveProperty('severity');
-        expect(snap.snapshot.items[1]).toMatchObject({
-            id: 'obj-002',
-            text: 'ZTBL_AGING (TABL)',
-            status: 'redesign',
-            answer: 'split into two',
-        });
-    });
-});
-describe('buildPromotedFromSnapshot — sha stability', () => {
-    it('returns the same sha for the same source content (timestamps stripped)', async () => {
-        const a = { ...SPEC_GAP_SOURCE, lastEditedAt: '2026-05-04T16:00:00Z',
-            history: [...SPEC_GAP_SOURCE.history.map((h) => ({ ...h, at: '2026-05-04T16:00:00Z' }))] };
-        const b = { ...SPEC_GAP_SOURCE, lastEditedAt: '2026-05-04T20:00:00Z',
-            history: [...SPEC_GAP_SOURCE.history.map((h) => ({ ...h, at: '2026-05-04T20:00:00Z' }))] };
-        const snapA = await buildPromotedFromSnapshot(a);
-        const snapB = await buildPromotedFromSnapshot(b);
-        expect(snapA.sha256).toBe(snapB.sha256);
-    });
-});
-describe('validatePromotionSource — predecessor type', () => {
-    it('hard-rejects when source artefactType does not match expected', () => {
-        const result = validatePromotionSource(SPEC_GAP_SOURCE, 'design');
-        expect(result.ok).toBe(false);
-        expect(result.error).toMatch(/expects a design source.*got spec-gap/);
-    });
-    it('accepts when source matches expected predecessor', () => {
-        const result = validatePromotionSource(SPEC_GAP_SOURCE, 'spec-gap');
-        expect(result.ok).toBe(true);
-        expect(result.error).toBeUndefined();
-    });
-});
-describe('validatePromotionSource — answered-state warnings', () => {
-    const fullyAnswered = {
-        ...SPEC_GAP_SOURCE,
-        interaction: { items: SPEC_GAP_SOURCE.interaction.items.map((i) => ({
-                ...i, status: 'answered', answer: 'A',
-                answeredBy: { name: 'X', role: 'BA' }, answeredAt: '2026-05-04T16:00:00Z',
-            })) },
-    };
-    const noneAnswered = {
-        ...SPEC_GAP_SOURCE,
-        interaction: { items: SPEC_GAP_SOURCE.interaction.items.map((i) => ({
-                ...i, status: 'open', answer: null, answeredBy: null, answeredAt: null,
-            })) },
-    };
-    it('emits no warning when source is fully answered', () => {
-        const r = validatePromotionSource(fullyAnswered, 'spec-gap');
-        expect(r.ok).toBe(true);
-        expect(r.warnings).toEqual([]);
-    });
-    it('emits ZERO_ANSWERED warning when no items are answered', () => {
-        const r = validatePromotionSource(noneAnswered, 'spec-gap');
-        expect(r.ok).toBe(true);
-        expect(r.warnings).toContainEqual({ kind: 'ZERO_ANSWERED', count: 2 });
-    });
-    it('emits PARTIAL_OPEN warning when some items still open', () => {
-        const r = validatePromotionSource(SPEC_GAP_SOURCE, 'spec-gap'); // 1 open, 1 answered
-        expect(r.ok).toBe(true);
-        expect(r.warnings).toContainEqual({ kind: 'PARTIAL_OPEN', openIds: ['gap-002'] });
-    });
-});
-describe('validatePromotionSource — multi-source (v0.7)', () => {
-    // The discriminated union ties artefactType ↔ content shape, but
-    // validatePromotionSource only inspects artefactType + interaction.items.
-    // Cast through unknown so tests can flip the artefactType label without
-    // having to construct a full upgrade-scan / cca-assessment content payload.
-    function withType(t) {
-        return { ...SPEC_GAP_SOURCE, artefactType: t };
-    }
-    it('accepts a source matching ANY type in the array', () => {
-        expect(validatePromotionSource(withType('upgrade-scan'), ['upgrade-scan', 'cca-assessment']).ok).toBe(true);
-        expect(validatePromotionSource(withType('cca-assessment'), ['upgrade-scan', 'cca-assessment']).ok).toBe(true);
-    });
-    it('rejects a source matching NONE of the array types', () => {
-        const r = validatePromotionSource(withType('spec-gap'), ['upgrade-scan', 'cca-assessment']);
-        expect(r.ok).toBe(false);
-        expect(r.error).toMatch(/expects one of \[upgrade-scan, cca-assessment\]/);
-        expect(r.error).toMatch(/got spec-gap/);
-    });
-    it('single-element array still produces "a <type>" phrasing in error', () => {
-        const r = validatePromotionSource(withType('spec-gap'), ['design']);
-        expect(r.ok).toBe(false);
-        expect(r.error).toMatch(/expects a design source/);
-    });
-});