superspec 0.1.0

package/dist/cli/commands/verify.js

@@ -0,0 +1,328 @@
+import { existsSync, readFileSync, readdirSync } from 'fs';
+import { join } from 'path';
+import { glob } from 'glob';
+import { PALETTE, SYMBOLS, commandHeader, sectionDivider, createProgressBar, startSpinner, spinnerSuccess, isInteractive, selectChange, } from '../ui/index.js';
+export async function verifyCommand(id, options) {
+    const superspecPath = join(process.cwd(), 'superspec');
+    if (!existsSync(superspecPath)) {
+        console.log(PALETTE.error('SuperSpec not initialized. Run: superspec init'));
+        process.exit(1);
+    }
+    // Interactive mode if no ID provided
+    if (!id) {
+        if (!isInteractive()) {
+            console.log(PALETTE.error('Please specify a change ID to verify.'));
+            process.exit(1);
+        }
+        const changesPath = join(superspecPath, 'changes');
+        const changes = [];
+        if (existsSync(changesPath)) {
+            const entries = readdirSync(changesPath, { withFileTypes: true });
+            for (const entry of entries) {
+                if (entry.isDirectory() && entry.name !== 'archive') {
+                    changes.push(entry.name);
+                }
+            }
+        }
+        if (changes.length === 0) {
+            console.log(PALETTE.warning('No active changes found.'));
+            return;
+        }
+        id = await selectChange(changes, 'Select a change to verify:');
+    }
+    const changePath = join(superspecPath, 'changes', id);
+    const specsPath = join(changePath, 'specs');
+    if (!existsSync(changePath)) {
+        console.log(PALETTE.error(`Change not found: ${id}`));
+        process.exit(1);
+    }
+    if (!existsSync(specsPath)) {
+        console.log(PALETTE.error(`No specs found for change: ${id}`));
+        process.exit(1);
+    }
+    console.log(commandHeader(`verify ${id}`, 'Implementation verification'));
+    // Parse specs
+    const specSpinner = startSpinner('Parsing specifications...');
+    const requirements = await parseSpecs(specsPath);
+    spinnerSuccess(specSpinner, `Found ${requirements.length} requirements`);
+    // Find test files
+    const testSpinner = startSpinner('Scanning test files...');
+    const testFiles = await findTestFiles();
+    spinnerSuccess(testSpinner, `Found ${testFiles.length} test files`);
+    // Match scenarios to tests
+    const matchSpinner = startSpinner('Matching scenarios to tests...');
+    const result = await matchScenariosToTests(requirements, testFiles, options);
+    spinnerSuccess(matchSpinner, 'Analysis complete');
+    console.log();
+    // Print report
+    printVerifyReport(result, options);
+    if (result.verdict === 'fail') {
+        process.exit(1);
+    }
+}
+async function parseSpecs(specsPath) {
+    const requirements = [];
+    const entries = readdirSync(specsPath, { withFileTypes: true });
+    for (const entry of entries) {
+        if (entry.isDirectory()) {
+            const specFile = join(specsPath, entry.name, 'spec.md');
+            if (existsSync(specFile)) {
+                const content = readFileSync(specFile, 'utf-8');
+                requirements.push(...parseSpecContent(content));
+            }
+        }
+    }
+    return requirements;
+}
+function parseSpecContent(content) {
+    const requirements = [];
+    const lines = content.split('\n');
+    let currentReq = null;
+    let currentScenario = null;
+    for (const line of lines) {
+        // Match requirement
+        const reqMatch = line.match(/^### Requirement: (.+)$/);
+        if (reqMatch?.[1]) {
+            if (currentReq) {
+                if (currentScenario) {
+                    currentReq.scenarios.push(currentScenario);
+                }
+                requirements.push(currentReq);
+            }
+            currentReq = { name: reqMatch[1], scenarios: [] };
+            currentScenario = null;
+            continue;
+        }
+        // Match scenario
+        const scenarioMatch = line.match(/^#### Scenario: (.+)$/);
+        if (scenarioMatch?.[1] && currentReq) {
+            if (currentScenario) {
+                currentReq.scenarios.push(currentScenario);
+            }
+            currentScenario = { name: scenarioMatch[1], when: '', then: [] };
+            continue;
+        }
+        // Match WHEN
+        const whenMatch = line.match(/^\s*-\s*\*\*WHEN\*\*\s*(.+)$/);
+        if (whenMatch?.[1] && currentScenario) {
+            currentScenario.when = whenMatch[1];
+            continue;
+        }
+        // Match THEN
+        const thenMatch = line.match(/^\s*-\s*\*\*THEN\*\*\s*(.+)$/);
+        if (thenMatch?.[1] && currentScenario) {
+            currentScenario.then.push(thenMatch[1]);
+            continue;
+        }
+        // Match AND
+        const andMatch = line.match(/^\s*-\s*\*\*AND\*\*\s*(.+)$/);
+        if (andMatch?.[1] && currentScenario) {
+            currentScenario.then.push(andMatch[1]);
+        }
+    }
+    // Don't forget the last ones
+    if (currentReq) {
+        if (currentScenario) {
+            currentReq.scenarios.push(currentScenario);
+        }
+        requirements.push(currentReq);
+    }
+    return requirements;
+}
+async function findTestFiles() {
+    const patterns = [
+        '**/*.test.ts',
+        '**/*.test.js',
+        '**/*.spec.ts',
+        '**/*.spec.js',
+        '**/test/**/*.ts',
+        '**/test/**/*.js',
+        '**/tests/**/*.ts',
+        '**/tests/**/*.js',
+    ];
+    const files = [];
+    for (const pattern of patterns) {
+        const matches = await glob(pattern, {
+            ignore: ['node_modules/**', 'dist/**'],
+        });
+        files.push(...matches);
+    }
+    return [...new Set(files)];
+}
+async function matchScenariosToTests(requirements, testFiles, options) {
+    const allTests = [];
+    // Parse test files to find test names
+    for (const file of testFiles) {
+        if (existsSync(file)) {
+            const content = readFileSync(file, 'utf-8');
+            const lines = content.split('\n');
+            for (let i = 0; i < lines.length; i++) {
+                const line = lines[i];
+                // Match test/it/describe patterns
+                const testMatch = line?.match(/(?:test|it|describe)\s*\(\s*['"`]([^'"`]+)['"`]/);
+                if (testMatch?.[1]) {
+                    allTests.push({
+                        file,
+                        line: i + 1,
+                        name: testMatch[1],
+                        confidence: 'high',
+                    });
+                }
+            }
+        }
+    }
+    // Match scenarios to tests
+    const missingTests = [];
+    let matchedScenarios = 0;
+    for (const req of requirements) {
+        for (const scenario of req.scenarios) {
+            const match = findMatchingTest(scenario.name, allTests);
+            if (match) {
+                scenario.testMatch = match;
+                matchedScenarios++;
+            }
+            else {
+                missingTests.push(scenario);
+            }
+        }
+    }
+    // Find extra tests (not matching any scenario)
+    const matchedTestNames = new Set(requirements
+        .flatMap(r => r.scenarios)
+        .filter(s => s.testMatch)
+        .map(s => s.testMatch.name));
+    const extraTests = options.strict
+        ? allTests.filter(t => !matchedTestNames.has(t.name))
+        : [];
+    const totalScenarios = requirements.reduce((sum, r) => sum + r.scenarios.length, 0);
+    const reqsWithCoverage = requirements.filter(r => r.scenarios.every(s => s.testMatch)).length;
+    return {
+        requirements,
+        coverage: {
+            requirements: reqsWithCoverage,
+            requirementsTotal: requirements.length,
+            scenarios: matchedScenarios,
+            scenariosTotal: totalScenarios,
+        },
+        issues: {
+            missingTests,
+            extraTests,
+        },
+        verdict: missingTests.length === 0 ? 'pass' : 'fail',
+    };
+}
+function findMatchingTest(scenarioName, tests) {
+    // Normalize names for comparison
+    const normalized = scenarioName.toLowerCase().replace(/[^a-z0-9]+/g, ' ').trim();
+    const words = normalized.split(' ').filter(w => w.length > 2);
+    let bestMatch;
+    let bestScore = 0;
+    for (const test of tests) {
+        const testNormalized = test.name.toLowerCase().replace(/[^a-z0-9]+/g, ' ').trim();
+        // Exact match
+        if (testNormalized === normalized) {
+            return { ...test, confidence: 'high' };
+        }
+        // Word matching score
+        const testWords = testNormalized.split(' ').filter(w => w.length > 2);
+        const matchingWords = words.filter(w => testWords.includes(w));
+        const score = matchingWords.length / Math.max(words.length, testWords.length);
+        if (score > bestScore && score >= 0.5) {
+            bestScore = score;
+            bestMatch = {
+                ...test,
+                confidence: score >= 0.8 ? 'high' : score >= 0.6 ? 'medium' : 'low',
+            };
+        }
+    }
+    return bestMatch;
+}
+function printVerifyReport(result, options) {
+    // Coverage summary
+    console.log();
+    console.log(sectionDivider());
+    console.log();
+    console.log(`  ${PALETTE.bold(PALETTE.white('📊 Coverage Summary'))}`);
+    console.log();
+    const reqPercent = result.coverage.requirementsTotal > 0
+        ? Math.round((result.coverage.requirements / result.coverage.requirementsTotal) * 100)
+        : 0;
+    const scenarioPercent = result.coverage.scenariosTotal > 0
+        ? Math.round((result.coverage.scenarios / result.coverage.scenariosTotal) * 100)
+        : 0;
+    console.log(`  ${PALETTE.midGray('Requirements:')} ${createProgressBar(result.coverage.requirements, result.coverage.requirementsTotal, { width: 20 })} ${result.coverage.requirements}/${result.coverage.requirementsTotal} ${PALETTE.midGray(`(${reqPercent}%)`)}`);
+    console.log(`  ${PALETTE.midGray('Scenarios:   ')} ${createProgressBar(result.coverage.scenarios, result.coverage.scenariosTotal, { width: 20 })} ${result.coverage.scenarios}/${result.coverage.scenariosTotal} ${PALETTE.midGray(`(${scenarioPercent}%)`)}`);
+    // Requirement coverage detail
+    if (options.verbose) {
+        console.log();
+        console.log(sectionDivider());
+        console.log();
+        console.log(`  ${PALETTE.bold(PALETTE.white('📋 Requirement Coverage'))}`);
+        console.log();
+        for (const req of result.requirements) {
+            const allCovered = req.scenarios.every(s => s.testMatch);
+            const icon = allCovered
+                ? PALETTE.success(SYMBOLS.success)
+                : PALETTE.error(SYMBOLS.error);
+            console.log(`  ${icon} ${PALETTE.primary(req.name)}`);
+            for (const scenario of req.scenarios) {
+                const sIcon = scenario.testMatch
+                    ? PALETTE.success('  ' + SYMBOLS.success)
+                    : PALETTE.error('  ' + SYMBOLS.error);
+                if (scenario.testMatch) {
+                    const confidence = scenario.testMatch.confidence === 'high'
+                        ? ''
+                        : PALETTE.warning(` [${scenario.testMatch.confidence}]`);
+                    console.log(`  ${sIcon} ${scenario.name}${confidence}`);
+                    console.log(`      ${PALETTE.darkGray('→')} ${PALETTE.midGray(`${scenario.testMatch.file}:${scenario.testMatch.line}`)}`);
+                }
+                else {
+                    console.log(`  ${sIcon} ${scenario.name} ${PALETTE.error('(no test found)')}`);
+                }
+            }
+            console.log();
+        }
+    }
+    // Issues
+    if (result.issues.missingTests.length > 0) {
+        console.log();
+        console.log(sectionDivider());
+        console.log();
+        console.log(`  ${PALETTE.bold(PALETTE.white('⚠️  Missing Tests'))}`);
+        console.log();
+        for (const scenario of result.issues.missingTests) {
+            console.log(`  ${PALETTE.error(SYMBOLS.error)} ${scenario.name}`);
+        }
+    }
+    if (result.issues.extraTests.length > 0) {
+        console.log();
+        console.log(sectionDivider());
+        console.log();
+        console.log(`  ${PALETTE.bold(PALETTE.white('📝 Extra Tests (not in Specs)'))}`);
+        console.log();
+        const displayCount = Math.min(result.issues.extraTests.length, 10);
+        for (const test of result.issues.extraTests.slice(0, displayCount)) {
+            console.log(`  ${PALETTE.warning(SYMBOLS.warning)} ${test.name}`);
+            console.log(`    ${PALETTE.midGray(`${test.file}:${test.line}`)}`);
+        }
+        if (result.issues.extraTests.length > 10) {
+            console.log(`  ${PALETTE.midGray(`... and ${result.issues.extraTests.length - 10} more`)}`);
+        }
+    }
+    // Verdict
+    console.log();
+    console.log(sectionDivider());
+    console.log();
+    if (result.verdict === 'pass') {
+        console.log(`  ${PALETTE.success(SYMBOLS.success)} ${PALETTE.bold(PALETTE.success('READY TO ARCHIVE'))}`);
+        console.log();
+        console.log(`  ${PALETTE.midGray('Next:')} ${PALETTE.white('superspec archive <change-id>')}`);
+    }
+    else {
+        console.log(`  ${PALETTE.error(SYMBOLS.error)} ${PALETTE.bold(PALETTE.error('NEEDS WORK'))}`);
+        console.log();
+        console.log(`  ${PALETTE.midGray('Write tests for missing scenarios before archiving.')}`);
+    }
+    console.log();
+}
+//# sourceMappingURL=verify.js.map

package/dist/cli/commands/verify.js.map

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

package/dist/cli/commands/view.d.ts

@@ -0,0 +1,6 @@
+interface ViewOptions {
+    json?: boolean;
+}
+export declare function viewCommand(options: ViewOptions): Promise<void>;
+export {};
+//# sourceMappingURL=view.d.ts.map

package/dist/cli/commands/view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/view.ts"],"names":[],"mappings":"AAiBA,UAAU,WAAW;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AA8BD,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA8KrE"}

package/dist/cli/commands/view.js

@@ -0,0 +1,290 @@
+import { existsSync, readFileSync, readdirSync } from 'fs';
+import { join } from 'path';
+import matter from 'gray-matter';
+import { PALETTE, ICONS, BOX, sectionHeader, createProgressBar, startSpinner, spinnerSuccess, isInteractive, selectPrompt, displayCommand, displayStats, } from '../ui/index.js';
+export async function viewCommand(options) {
+    const superspecPath = join(process.cwd(), 'superspec');
+    if (!existsSync(superspecPath)) {
+        console.log(`  ${ICONS.error} ${PALETTE.error('SuperSpec not initialized.')}`);
+        console.log(`  ${PALETTE.dim('Run:')} ${PALETTE.accent('superspec init')}`);
+        process.exit(1);
+    }
+    const spinner = startSpinner('Loading project overview...');
+    const overview = gatherProjectOverview(superspecPath);
+    spinnerSuccess(spinner, 'Project loaded');
+    if (options.json) {
+        console.log(JSON.stringify(overview, null, 2));
+        return;
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // DASHBOARD HEADER
+    // ═══════════════════════════════════════════════════════════════════════════
+    console.log();
+    console.log(`  ${PALETTE.subtle(BOX.heavyTopLeft + BOX.heavyH.repeat(58) + BOX.heavyTopRight)}`);
+    console.log(`  ${PALETTE.subtle(BOX.heavyV)}  ${PALETTE.primary('⬡')} ${PALETTE.bold(PALETTE.white('SuperSpec Dashboard'))}${' '.repeat(36)}${PALETTE.subtle(BOX.heavyV)}`);
+    console.log(`  ${PALETTE.subtle(BOX.heavyBottomLeft + BOX.heavyH.repeat(58) + BOX.heavyBottomRight)}`);
+    // ═══════════════════════════════════════════════════════════════════════════
+    // PROJECT STATISTICS
+    // ═══════════════════════════════════════════════════════════════════════════
+    console.log(sectionHeader('Project Statistics', '📊'));
+    console.log();
+    displayStats([
+        { label: 'Main Specs', value: overview.stats.mainSpecCount },
+        { label: 'Active', value: overview.stats.activeChangeCount },
+        { label: 'Archived', value: overview.stats.archivedChangeCount },
+    ]);
+    console.log();
+    displayStats([
+        { label: 'Requirements', value: overview.stats.totalRequirements, icon: PALETTE.primary('◆') },
+        { label: 'Scenarios', value: overview.stats.totalScenarios, icon: PALETTE.accent('◆') },
+    ]);
+    // ═══════════════════════════════════════════════════════════════════════════
+    // ACTIVE CHANGES
+    // ═══════════════════════════════════════════════════════════════════════════
+    console.log(sectionHeader('Active Changes', '🔄'));
+    console.log();
+    if (overview.activeChanges.length > 0) {
+        for (const change of overview.activeChanges) {
+            const phaseIcon = getPhaseIcon(change.phase);
+            const title = change.title
+                ? PALETTE.dim(` - ${change.title.slice(0, 35)}${change.title.length > 35 ? '…' : ''}`)
+                : '';
+            console.log(`  ${PALETTE.subtle('┌─')} ${phaseIcon} ${PALETTE.bold(PALETTE.white(change.id))}${title}`);
+            // Progress bar if in execute phase
+            if (change.progress && change.progress.total > 0) {
+                const { completed, total } = change.progress;
+                const bar = createProgressBar(completed, total, { width: 18, showCount: true });
+                console.log(`  ${PALETTE.subtle('│')}   ${bar}`);
+            }
+            // Phase indicator
+            const phases = ['proposal', 'design', 'spec', 'plan', 'execute', 'verify'];
+            const currentPhaseIndex = phases.indexOf(change.phase);
+            const phaseBar = phases.map((p, i) => {
+                if (i < currentPhaseIndex)
+                    return PALETTE.success('●');
+                if (i === currentPhaseIndex)
+                    return PALETTE.accent('●');
+                return PALETTE.dark('○');
+            }).join(' ');
+            console.log(`  ${PALETTE.subtle('│')}   ${PALETTE.dim('Phase:')} ${phaseBar}`);
+            console.log(`  ${PALETTE.subtle('└─')}`);
+            console.log();
+        }
+    }
+    else {
+        console.log(`  ${PALETTE.dim('No active changes.')}`);
+        console.log();
+        displayCommand('/superspec:brainstorm', 'Start a new change');
+        console.log();
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // MAIN SPECIFICATIONS
+    // ═══════════════════════════════════════════════════════════════════════════
+    if (overview.mainSpecs.length > 0) {
+        console.log(sectionHeader('Main Specifications', '📋'));
+        console.log();
+        // Table header
+        console.log(`  ${PALETTE.bold(PALETTE.dim('Name'.padEnd(28)))} ${PALETTE.bold(PALETTE.dim('Reqs'.padStart(8)))} ${PALETTE.bold(PALETTE.dim('Scenarios'.padStart(10)))}`);
+        console.log(`  ${PALETTE.dark('─'.repeat(28))} ${PALETTE.dark('─'.repeat(8))} ${PALETTE.dark('─'.repeat(10))}`);
+        for (const spec of overview.mainSpecs.slice(0, 8)) {
+            const name = spec.name.length > 27
+                ? spec.name.slice(0, 25) + '…'
+                : spec.name;
+            console.log(`  ${PALETTE.primaryBright(name.padEnd(28))} ${PALETTE.white(String(spec.requirementCount).padStart(8))} ${PALETTE.white(String(spec.scenarioCount).padStart(10))}`);
+        }
+        if (overview.mainSpecs.length > 8) {
+            console.log(`  ${PALETTE.dim(`... and ${overview.mainSpecs.length - 8} more`)}`);
+        }
+        console.log();
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // QUICK ACTIONS
+    // ═══════════════════════════════════════════════════════════════════════════
+    console.log(sectionHeader('Quick Actions', '🚀'));
+    console.log();
+    displayCommand('superspec list', 'View all changes');
+    displayCommand('superspec list -s', 'View all specs');
+    displayCommand('superspec validate', 'Validate specs');
+    displayCommand('/superspec:brainstorm', 'Start new change');
+    console.log();
+    // ═══════════════════════════════════════════════════════════════════════════
+    // INTERACTIVE NAVIGATION
+    // ═══════════════════════════════════════════════════════════════════════════
+    if (isInteractive() && (overview.activeChanges.length > 0 || overview.mainSpecs.length > 0)) {
+        console.log(`  ${PALETTE.subtle('─'.repeat(55))}`);
+        console.log();
+        const choices = [
+            { name: `${PALETTE.primary('›')} View a change`, value: 'change' },
+            { name: `${PALETTE.primary('›')} View a spec`, value: 'spec' },
+            { name: `${PALETTE.primary('›')} Run validation`, value: 'validate' },
+            { name: PALETTE.dim('  (Exit)'), value: 'exit' },
+        ];
+        const action = await selectPrompt({
+            message: 'What would you like to do?',
+            choices,
+        });
+        if (action === 'change' && overview.activeChanges.length > 0) {
+            const { showCommand } = await import('./show.js');
+            const changeChoices = overview.activeChanges.map(c => ({
+                name: `${c.id}${c.title ? ` - ${c.title}` : ''}`,
+                value: c.id,
+            }));
+            const selectedChange = await selectPrompt({
+                message: 'Select a change:',
+                choices: [...changeChoices, { name: PALETTE.dim('(Cancel)'), value: '' }],
+            });
+            if (selectedChange) {
+                await showCommand(selectedChange, {});
+            }
+        }
+        else if (action === 'spec' && overview.mainSpecs.length > 0) {
+            const { showCommand } = await import('./show.js');
+            const specChoices = overview.mainSpecs.map(s => ({
+                name: `${s.name} (${s.requirementCount} requirements)`,
+                value: s.name,
+            }));
+            const selectedSpec = await selectPrompt({
+                message: 'Select a spec:',
+                choices: [...specChoices, { name: PALETTE.dim('(Cancel)'), value: '' }],
+            });
+            if (selectedSpec) {
+                await showCommand(selectedSpec, {});
+            }
+        }
+        else if (action === 'validate') {
+            const { validateCommand } = await import('./validate.js');
+            await validateCommand(undefined, { all: true });
+        }
+    }
+}
+function gatherProjectOverview(superspecPath) {
+    const overview = {
+        initialized: true,
+        activeChanges: [],
+        archivedChanges: 0,
+        mainSpecs: [],
+        stats: {
+            totalRequirements: 0,
+            totalScenarios: 0,
+            activeChangeCount: 0,
+            archivedChangeCount: 0,
+            mainSpecCount: 0,
+        },
+    };
+    // Gather active changes
+    const changesPath = join(superspecPath, 'changes');
+    if (existsSync(changesPath)) {
+        const entries = readdirSync(changesPath, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.isDirectory() && entry.name !== 'archive') {
+                const changePath = join(changesPath, entry.name);
+                overview.activeChanges.push(getChangeOverview(entry.name, changePath));
+            }
+        }
+    }
+    // Count archived changes
+    const archivePath = join(changesPath, 'archive');
+    if (existsSync(archivePath)) {
+        const entries = readdirSync(archivePath, { withFileTypes: true });
+        overview.archivedChanges = entries.filter(e => e.isDirectory()).length;
+    }
+    // Gather main specs
+    const specsPath = join(superspecPath, 'specs');
+    if (existsSync(specsPath)) {
+        const entries = readdirSync(specsPath, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.isDirectory()) {
+                const specFile = join(specsPath, entry.name, 'spec.md');
+                if (existsSync(specFile)) {
+                    overview.mainSpecs.push(getSpecOverview(entry.name, specFile));
+                }
+            }
+        }
+    }
+    // Calculate stats
+    overview.stats.activeChangeCount = overview.activeChanges.length;
+    overview.stats.archivedChangeCount = overview.archivedChanges;
+    overview.stats.mainSpecCount = overview.mainSpecs.length;
+    overview.stats.totalRequirements = overview.mainSpecs.reduce((sum, s) => sum + s.requirementCount, 0);
+    overview.stats.totalScenarios = overview.mainSpecs.reduce((sum, s) => sum + s.scenarioCount, 0);
+    return overview;
+}
+function getChangeOverview(id, path) {
+    const overview = {
+        id,
+        phase: 'proposal',
+        specCount: 0,
+    };
+    // Get title from proposal
+    const proposalPath = join(path, 'proposal.md');
+    if (existsSync(proposalPath)) {
+        try {
+            const content = readFileSync(proposalPath, 'utf-8');
+            const { data } = matter(content);
+            overview.title = data['title'];
+        }
+        catch { /* ignore */ }
+    }
+    // Determine phase
+    const hasDesign = existsSync(join(path, 'design.md'));
+    const hasSpecs = existsSync(join(path, 'specs'));
+    const hasPlan = existsSync(join(path, 'plan.md'));
+    const hasTasks = existsSync(join(path, 'tasks.md'));
+    if (hasTasks) {
+        const content = readFileSync(join(path, 'tasks.md'), 'utf-8');
+        const total = (content.match(/^- \[[ x]\]/gm) ?? []).length;
+        const completed = (content.match(/^- \[x\]/gm) ?? []).length;
+        overview.progress = { completed, total };
+        if (completed === total && total > 0) {
+            overview.phase = 'verify';
+        }
+        else {
+            overview.phase = 'execute';
+        }
+    }
+    else if (hasPlan) {
+        overview.phase = 'plan';
+    }
+    else if (hasSpecs) {
+        overview.phase = 'spec';
+    }
+    else if (hasDesign) {
+        overview.phase = 'design';
+    }
+    else {
+        overview.phase = 'proposal';
+    }
+    // Count specs
+    const specsPath = join(path, 'specs');
+    if (existsSync(specsPath)) {
+        const entries = readdirSync(specsPath, { withFileTypes: true });
+        overview.specCount = entries.filter(e => e.isDirectory()).length;
+    }
+    return overview;
+}
+function getSpecOverview(name, path) {
+    const overview = {
+        name,
+        requirementCount: 0,
+        scenarioCount: 0,
+    };
+    try {
+        const content = readFileSync(path, 'utf-8');
+        overview.requirementCount = (content.match(/^### Requirement:/gm) ?? []).length;
+        overview.scenarioCount = (content.match(/^#### Scenario:/gm) ?? []).length;
+    }
+    catch { /* ignore */ }
+    return overview;
+}
+function getPhaseIcon(phase) {
+    const icons = {
+        proposal: PALETTE.dark('◐'),
+        design: PALETTE.dim('◑'),
+        spec: PALETTE.primary('◐'),
+        plan: PALETTE.primaryBright('◑'),
+        execute: PALETTE.accent('◉'),
+        verify: PALETTE.success('●'),
+    };
+    return icons[phase] ?? PALETTE.dark('○');
+}
+//# sourceMappingURL=view.js.map