@specsafe/cli 0.6.0 → 0.7.1

package/dist/commands/shard.js

@@ -0,0 +1,199 @@
+/**
+ * Shard Command - Analyze and split specs into AI-consumable chunks
+ */
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'fs';
+import { resolve, basename } from 'path';
+import { ShardEngine } from '@specsafe/core';
+const VALID_STRATEGIES = new Set([
+    'by-section',
+    'by-requirement',
+    'by-scenario',
+    'auto',
+]);
+const DEFAULT_MAX_TOKENS = 2000;
+function parseStrategy(input) {
+    if (!input) {
+        return 'auto';
+    }
+    if (!VALID_STRATEGIES.has(input)) {
+        throw new Error(`Invalid strategy "${input}". Expected one of: ${Array.from(VALID_STRATEGIES).join(', ')}`);
+    }
+    return input;
+}
+function parseMaxTokens(input) {
+    const value = Number.parseInt(input, 10);
+    if (!Number.isFinite(value) || value <= 0) {
+        throw new Error(`Invalid --max-tokens value "${input}". It must be a positive integer.`);
+    }
+    return value;
+}
+function sanitizeFileSegment(value) {
+    return value.replace(/[^a-zA-Z0-9._-]+/g, '-');
+}
+export const shardCommand = new Command('shard')
+    .description('Analyze and split specs into AI-consumable chunks')
+    .argument('<spec>', 'Path to the spec file')
+    .option('-s, --strategy <strategy>', 'Sharding strategy (by-section|by-requirement|by-scenario|auto)')
+    .option('-m, --max-tokens <number>', 'Maximum tokens per shard for auto strategy', String(DEFAULT_MAX_TOKENS))
+    .option('-o, --output <dir>', 'Output directory for shard files')
+    .option('--no-preserve-context', 'Do not preserve context across shards')
+    .option('--no-include-metadata', 'Do not include metadata in shards')
+    .option('--json', 'Output as JSON')
+    .action(async (specPath, options) => {
+    try {
+        const resolvedPath = resolve(process.cwd(), specPath);
+        if (!existsSync(resolvedPath)) {
+            console.error(chalk.red(`Error: Spec file not found: ${specPath}`));
+            process.exit(1);
+        }
+        const specContent = readFileSync(resolvedPath, 'utf-8');
+        const strategy = parseStrategy(options.strategy);
+        const maxTokensPerShard = parseMaxTokens(options.maxTokens);
+        const preserveContext = options.preserveContext !== false;
+        const includeMetadata = options.includeMetadata !== false;
+        const shardOptions = {
+            strategy,
+            maxTokensPerShard,
+            preserveContext,
+            includeMetadata,
+        };
+        const engine = new ShardEngine(shardOptions);
+        const result = engine.shard(specContent, shardOptions);
+        if (!result.success) {
+            console.error(chalk.red('Error sharding spec:'), result.error);
+            process.exit(1);
+        }
+        const { plan, durationMs } = result;
+        if (options.json) {
+            console.log(JSON.stringify({
+                success: true,
+                durationMs,
+                plan: {
+                    ...plan,
+                    shards: plan.shards.map(s => ({
+                        id: s.id,
+                        type: s.type,
+                        tokenCount: s.tokenCount,
+                        priority: s.priority,
+                        sectionName: s.sectionName,
+                    })),
+                },
+            }, null, 2));
+            return;
+        }
+        displayAnalysis(plan);
+        displayShardPlan(plan);
+        if (options.output) {
+            await writeShards(plan, options.output, specPath);
+        }
+        console.log(chalk.gray(`\nCompleted in ${durationMs}ms`));
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(chalk.red('Error:'), message);
+        process.exit(1);
+    }
+});
+/**
+ * Display analysis results
+ */
+function displayAnalysis(plan) {
+    const { analysis } = plan;
+    console.log(chalk.bold.blue(`\n📊 Spec Analysis\n`));
+    console.log(chalk.gray('Complexity:'), chalk.cyan(`${analysis.complexity}/100`));
+    console.log(chalk.gray('Total Tokens:'), chalk.cyan(analysis.totalTokens.toLocaleString()));
+    console.log(chalk.gray('Sections:'), chalk.cyan(analysis.sectionCount));
+    console.log(chalk.gray('Requirements:'), chalk.cyan(analysis.requirementCount));
+    console.log(chalk.gray('Scenarios:'), chalk.cyan(analysis.scenarioCount));
+    console.log(chalk.gray('\nRecommended Strategy:'), chalk.green(analysis.recommendedStrategy));
+    console.log(chalk.gray(analysis.recommendationReason));
+}
+/**
+ * Display shard plan
+ */
+function displayShardPlan(plan) {
+    console.log(chalk.bold.blue(`\n📝 Shard Plan\n`));
+    console.log(chalk.gray('Total Shards:'), chalk.cyan(plan.shards.length));
+    console.log(chalk.gray('Estimated Tokens:'), chalk.cyan(plan.estimatedTokens.toLocaleString()));
+    if (plan.crossReferences.length > 0) {
+        console.log(chalk.gray('Cross-References:'), chalk.cyan(plan.crossReferences.length));
+    }
+    console.log(chalk.bold('\nShards:'));
+    for (const shard of plan.shards) {
+        const tokens = shard.tokenCount || 0;
+        const typeColor = shard.type === 'metadata'
+            ? chalk.gray
+            : shard.type === 'requirement'
+                ? chalk.yellow
+                : shard.type === 'scenario'
+                    ? chalk.blue
+                    : chalk.white;
+        console.log(`  ${chalk.cyan(shard.id.padEnd(20))} ${typeColor(shard.type.padEnd(12))} ${tokens
+            .toString()
+            .padStart(6)} tokens${shard.sectionName ? ` - ${chalk.gray(shard.sectionName)}` : ''}`);
+        if (shard.dependencies.length > 0) {
+            console.log(`    ${chalk.gray('└─ Dependencies:')} ${shard.dependencies.map(d => chalk.gray(d)).join(', ')}`);
+        }
+    }
+    if (plan.recommendedOrder.length > 0 && plan.recommendedOrder.length !== plan.shards.length) {
+        console.log(chalk.bold('\nRecommended Processing Order:'));
+        console.log(`  ${plan.recommendedOrder.map(id => chalk.cyan(id)).join(' → ')}`);
+    }
+    if (plan.crossReferences.length > 0) {
+        console.log(chalk.bold('\nCross-References:'));
+        for (const ref of plan.crossReferences.slice(0, 10)) {
+            console.log(`  ${chalk.cyan(ref.from)} ${chalk.gray('→')} ${chalk.cyan(ref.to)} (${chalk.yellow(ref.type)})`);
+        }
+        if (plan.crossReferences.length > 10) {
+            console.log(`  ${chalk.gray(`... and ${plan.crossReferences.length - 10} more`)}`);
+        }
+    }
+}
+/**
+ * Write shards to files
+ */
+async function writeShards(plan, outputDir, specPath) {
+    const resolvedDir = resolve(process.cwd(), outputDir);
+    if (!existsSync(resolvedDir)) {
+        mkdirSync(resolvedDir, { recursive: true });
+    }
+    const baseName = sanitizeFileSegment(basename(specPath).replace(/\.(md|txt|spec)$/i, '')) || 'spec';
+    console.log(chalk.bold.blue(`\n💾 Writing Shards\n`));
+    console.log(chalk.gray(`Output directory: ${resolvedDir}\n`));
+    for (const shard of plan.shards) {
+        const safeShardId = sanitizeFileSegment(shard.id);
+        const fileName = `${baseName}-${safeShardId}.md`;
+        const filePath = resolve(resolvedDir, fileName);
+        let content = shard.content;
+        if (shard.tokenCount && shard.type !== 'metadata') {
+            content =
+                `<!--\nShard: ${shard.id}\nType: ${shard.type}\nTokens: ${shard.tokenCount}\nPriority: ${shard.priority}\n` +
+                    (shard.sectionName ? `Section: ${shard.sectionName}\n` : '') +
+                    (shard.dependencies.length > 0 ? `Dependencies: ${shard.dependencies.join(', ')}\n` : '') +
+                    '-->\n\n' +
+                    content;
+        }
+        writeFileSync(filePath, content, 'utf-8');
+        console.log(chalk.green('✓') + ` ${fileName}`);
+    }
+    const summaryPath = resolve(resolvedDir, `${baseName}-plan.json`);
+    const summary = {
+        specPath,
+        generatedAt: new Date().toISOString(),
+        plan: {
+            ...plan,
+            shards: plan.shards.map((s) => ({
+                id: s.id,
+                type: s.type,
+                tokenCount: s.tokenCount,
+                priority: s.priority,
+                sectionName: s.sectionName,
+            })),
+        },
+    };
+    writeFileSync(summaryPath, JSON.stringify(summary, null, 2), 'utf-8');
+    console.log(chalk.green('✓') + ` ${baseName}-plan.json`);
+}
+//# sourceMappingURL=shard.js.map

package/dist/commands/shard.js.map

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

package/dist/commands/test-guide.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const testGuideCommand: Command;
+//# sourceMappingURL=test-guide.d.ts.map

package/dist/commands/test-guide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-guide.d.ts","sourceRoot":"","sources":["../../src/commands/test-guide.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgCpC,eAAO,MAAM,gBAAgB,SAuHzB,CAAC"}

package/dist/commands/test-guide.js

@@ -0,0 +1,190 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import { Workflow, ProjectTracker, generateGuide, generateGuideContent, convertToPlaywrightScenarios, generatePlaywrightScript, } from '@specsafe/core';
+import { readFile, writeFile, mkdir } from 'fs/promises';
+import { join, dirname, normalize, isAbsolute } from 'path';
+function validateSpecInput(specInput) {
+    if (specInput.endsWith('.md'))
+        return specInput;
+    if (!/^[A-Za-z0-9_-]+$/.test(specInput)) {
+        throw new Error('Invalid spec identifier. Use only letters, numbers, dash, and underscore.');
+    }
+    return specInput;
+}
+function sanitizeOutputPath(outputPath) {
+    const normalized = normalize(outputPath);
+    if (isAbsolute(normalized) || normalized.includes('..')) {
+        throw new Error('Output path must be a safe relative path');
+    }
+    return normalized;
+}
+export const testGuideCommand = new Command('test-guide')
+    .description('Generate E2E test guide from spec')
+    .argument('<spec>', 'Spec ID or path to spec file')
+    .option('-o, --output <file>', 'Output file path')
+    .option('--format <format>', 'Output format (markdown|json)', 'markdown')
+    .option('--mode <mode>', 'Automation mode (manual|playwright)', 'manual')
+    .option('--auto', 'Generate Playwright script output')
+    .option('--priority <priorities...>', 'Filter by priority (P0 P1 P2)', ['P0', 'P1', 'P2'])
+    .action(async (specInput, options) => {
+    const spinner = ora('Generating test guide...').start();
+    try {
+        specInput = validateSpecInput(specInput);
+        const workflow = new Workflow();
+        const tracker = new ProjectTracker(process.cwd());
+        await tracker.loadSpecsIntoWorkflow(workflow);
+        let specId;
+        let specContent;
+        let specPath;
+        if (specInput.endsWith('.md')) {
+            specPath = specInput;
+            try {
+                specContent = await readFile(specPath, 'utf-8');
+                specId = specInput.split('/').pop().replace('.md', '');
+            }
+            catch {
+                throw new Error(`Spec file not found: ${specPath}`);
+            }
+        }
+        else {
+            specId = specInput;
+            specPath = join('specs/active', `${specId}.md`);
+            try {
+                specContent = await readFile(specPath, 'utf-8');
+            }
+            catch {
+                throw new Error(`Spec file not found: ${specPath}`);
+            }
+        }
+        let spec = workflow.getSpec(specId);
+        if (!spec)
+            spec = parseSpecFromContent(specId, specContent);
+        spinner.text = 'Generating test content...';
+        const priorityFilter = options.priority;
+        const mode = options.auto ? 'playwright' : (options.mode ?? 'manual');
+        const guide = generateGuide(spec, {
+            priorityFilter,
+            format: options.format,
+            mode,
+        });
+        let output;
+        let outputFormat;
+        if (options.auto) {
+            const scenarios = convertToPlaywrightScenarios(guide);
+            output = generatePlaywrightScript(spec.id, scenarios);
+            outputFormat = 'js';
+        }
+        else {
+            const result = generateGuideContent(spec, {
+                priorityFilter,
+                format: options.format,
+                mode,
+            });
+            output = result.content;
+            outputFormat = result.format === 'markdown' ? 'md' : result.format;
+        }
+        spinner.stop();
+        let outputPath;
+        if (options.output) {
+            outputPath = sanitizeOutputPath(options.output);
+        }
+        else {
+            const guidesDir = join('.specsafe', 'e2e', 'guides');
+            await mkdir(guidesDir, { recursive: true });
+            const extension = outputFormat;
+            outputPath = join(guidesDir, `test-guide-${specId}.${extension}`);
+        }
+        await mkdir(dirname(outputPath), { recursive: true });
+        await writeFile(outputPath, output, 'utf-8');
+        console.log(chalk.green(`\n✅ Test guide generated: ${outputPath}`));
+        console.log(chalk.blue('\nGuide Summary:'));
+        console.log(`  Mode: ${mode}`);
+        console.log(`  Scenarios: ${guide.scenarios.length}`);
+        console.log(`  Steps: ${guide.scenarios.reduce((sum, s) => sum + s.steps.length, 0)}`);
+        console.log(`  P0 (Critical): ${guide.scenarios.filter(s => s.priority === 'P0').length}`);
+        console.log(`  P1 (High): ${guide.scenarios.filter(s => s.priority === 'P1').length}`);
+        console.log(`  P2 (Normal): ${guide.scenarios.filter(s => s.priority === 'P2').length}`);
+        console.log(chalk.blue('\nNext steps:'));
+        if (mode === 'playwright') {
+            console.log(chalk.gray(`  1. Run generated script with: npx playwright test ${outputPath}`));
+            console.log(chalk.gray('  2. Review screenshots captured at configured intervals'));
+            console.log(chalk.gray('  3. Validate assertions and adjust selectors as needed'));
+        }
+        else {
+            console.log(chalk.gray(`  1. Review the test guide: ${outputPath}`));
+            console.log(chalk.gray('  2. Execute test scenarios manually'));
+            console.log(chalk.gray('  3. Take screenshots at key steps'));
+            console.log(chalk.gray(`  4. Submit for analysis: specsafe test-submit ${specId} --screenshots ./my-screenshots/`));
+        }
+    }
+    catch (error) {
+        spinner.fail(chalk.red(error.message));
+        if (error.message.includes('not found')) {
+            console.log(chalk.gray(`\n💡 Tip: Create a spec first with 'specsafe new <name>'`));
+        }
+        process.exit(1);
+    }
+});
+function parseSpecFromContent(specId, content) {
+    const safeContent = content.slice(0, 500_000);
+    const nameMatch = safeContent.match(/^#\s+(.+?)(?:\s+Specification)?$/m);
+    const name = nameMatch ? nameMatch[1] : specId;
+    const descMatch = safeContent.match(/## Overview\n+([\s\S]*?)(?=##|$)/);
+    const description = descMatch ? descMatch[1].trim() : '';
+    const requirements = [];
+    const tableMatch = safeContent.match(/\| ID \| Requirement \| Priority \|[^|]+\|\n\|[-\s|]+\|\n([\s\S]*?)(?=\n## |\n### |$)/);
+    if (tableMatch) {
+        const rows = tableMatch[1].trim().split('\n');
+        for (const row of rows) {
+            const cells = row.split('|').map(c => c.trim()).filter(Boolean);
+            if (cells.length >= 3) {
+                const [id, text, priority] = cells;
+                requirements.push({ id, text, priority: priority || 'P1', scenarios: [] });
+            }
+        }
+    }
+    const scenariosMatch = safeContent.match(/## \d+\.\s*Scenarios\n+([\s\S]*?)(?=## \d+\.|$)/);
+    if (scenariosMatch) {
+        const scenarioBlocks = scenariosMatch[1].split(/### Scenario \d+:/);
+        for (let i = 0; i < scenarioBlocks.length; i++) {
+            const block = scenarioBlocks[i];
+            const givenMatch = block.match(/[-*]\s*\*\*Given\*\*\s*(.+)/i);
+            const whenMatch = block.match(/[-*]\s*\*\*When\*\*\s*(.+)/i);
+            const thenMatch = block.match(/[-*]\s*\*\*Then\*\*\s*(.+)/i);
+            if (givenMatch && whenMatch && thenMatch) {
+                const scenario = {
+                    id: `SC-${i + 1}`,
+                    given: givenMatch[1].trim(),
+                    when: whenMatch[1].trim(),
+                    thenOutcome: thenMatch[1].trim(),
+                };
+                if (requirements.length > 0)
+                    requirements[0].scenarios.push(scenario);
+                else
+                    requirements.push({ id: 'FR-1', text: 'Generated from scenarios', priority: 'P1', scenarios: [scenario] });
+            }
+        }
+    }
+    if (requirements.length === 0) {
+        requirements.push({
+            id: 'FR-1',
+            text: 'Feature implementation matches spec',
+            priority: 'P0',
+            scenarios: [{ id: 'SC-1', given: 'user accesses the feature', when: 'user interacts with the feature', thenOutcome: 'feature behaves as specified' }],
+        });
+    }
+    return {
+        id: specId,
+        name,
+        description,
+        stage: 'spec',
+        createdAt: new Date(),
+        updatedAt: new Date(),
+        requirements,
+        testFiles: [],
+        implementationFiles: [],
+        metadata: { author: 'unknown', project: 'unknown', tags: [] },
+    };
+}
+//# sourceMappingURL=test-guide.js.map

package/dist/commands/test-guide.js.map

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

package/dist/commands/test-report.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const testReportCommand: Command;
+//# sourceMappingURL=test-report.d.ts.map

package/dist/commands/test-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-report.d.ts","sourceRoot":"","sources":["../../src/commands/test-report.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAcpC,eAAO,MAAM,iBAAiB,SA0F1B,CAAC"}

package/dist/commands/test-report.js

@@ -0,0 +1,196 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { readFile, readdir } from 'fs/promises';
+import { join } from 'path';
+import { existsSync } from 'fs';
+function validateSpecId(specId) {
+    if (!/^[A-Za-z0-9_-]+$/.test(specId)) {
+        throw new Error('Invalid spec ID. Use only letters, numbers, dash, and underscore.');
+    }
+    return specId;
+}
+export const testReportCommand = new Command('test-report')
+    .description('View E2E test report for a spec')
+    .argument('<spec>', 'Spec ID')
+    .option('-l, --latest', 'Show only the latest report', true)
+    .option('--json', 'Output as JSON')
+    .option('--all', 'Show all reports for this spec')
+    .action(async (specId, options) => {
+    try {
+        specId = validateSpecId(specId);
+        const reportsDir = join('.specsafe', 'e2e', 'reports');
+        if (!existsSync(reportsDir)) {
+            console.log(chalk.yellow('\n⚠️  No reports directory found.'));
+            console.log(chalk.gray('   Run tests first: specsafe test-submit ' + specId + ' --screenshots ./screenshots/'));
+            return;
+        }
+        // Find reports for this spec
+        const files = await readdir(reportsDir);
+        const reportFiles = files.filter(f => f.startsWith(specId) && f.endsWith('.json'));
+        if (reportFiles.length === 0) {
+            console.log(chalk.yellow(`\n⚠️  No reports found for spec: ${specId}`));
+            console.log(chalk.gray('   Run tests first: specsafe test-submit ' + specId + ' --screenshots ./screenshots/'));
+            return;
+        }
+        // Sort by modification time (latest first)
+        const reportsWithStats = await Promise.all(reportFiles.map(async (filename) => {
+            const path = join(reportsDir, filename);
+            const content = await readFile(path, 'utf-8');
+            const report = JSON.parse(content);
+            return { filename, report, path };
+        }));
+        reportsWithStats.sort((a, b) => new Date(b.report.createdAt).getTime() - new Date(a.report.createdAt).getTime());
+        if (options.all) {
+            // Show list of all reports
+            console.log(chalk.blue(`\n📊 Test Reports for ${specId}\n`));
+            console.log(`Found ${reportsWithStats.length} report(s):\n`);
+            for (let i = 0; i < reportsWithStats.length; i++) {
+                const { report, filename } = reportsWithStats[i];
+                const date = new Date(report.createdAt).toLocaleString();
+                const passRate = (report.summary.passRate * 100).toFixed(1);
+                const statusColor = report.summary.passRate === 1 ? chalk.green :
+                    report.summary.passRate >= 0.8 ? chalk.yellow :
+                        chalk.red;
+                console.log(`${i + 1}. ${filename}`);
+                console.log(`   Date: ${date}`);
+                console.log(`   Pass Rate: ${statusColor(passRate + '%')}`);
+                console.log(`   Steps: ${report.summary.passed}/${report.summary.totalSteps} passed`);
+                if (report.summary.failed > 0) {
+                    console.log(chalk.red(`   Failed: ${report.summary.failed}`));
+                }
+                console.log();
+            }
+            console.log(chalk.gray('Use --latest to see the most recent report in detail.'));
+            return;
+        }
+        // Show latest report
+        const { report } = reportsWithStats[0];
+        if (options.json) {
+            console.log(JSON.stringify(report, null, 2));
+            return;
+        }
+        // Display formatted report
+        displayReport(report);
+    }
+    catch (error) {
+        console.error(chalk.red('Error:'), error.message);
+        process.exit(1);
+    }
+});
+/**
+ * Display a formatted test report
+ */
+function displayReport(report) {
+    const { summary } = report;
+    // Header
+    console.log(chalk.blue('\n┌─────────────────────────────────────────────────────────────┐'));
+    console.log(chalk.blue('│                    E2E Test Report                          │'));
+    console.log(chalk.blue('└─────────────────────────────────────────────────────────────┘\n'));
+    console.log(chalk.bold(`Spec ID: ${report.specId}`));
+    console.log(chalk.gray(`Report ID: ${report.reportId}`));
+    console.log(chalk.gray(`Submitted By: ${report.submittedBy}`));
+    console.log(chalk.gray(`Generated: ${new Date(report.createdAt).toLocaleString()}`));
+    console.log();
+    // Summary Box
+    const passRatePercent = (summary.passRate * 100).toFixed(1);
+    const passRateColor = summary.passRate === 1 ? chalk.green :
+        summary.passRate >= 0.8 ? chalk.yellow :
+            chalk.red;
+    console.log(chalk.bold('📊 Summary\n'));
+    console.log(`  Total Scenarios: ${summary.totalScenarios}`);
+    console.log(`  Total Steps: ${summary.totalSteps}`);
+    console.log();
+    console.log(`  ${chalk.green('✅ Passed:')}    ${summary.passed.toString().padStart(3)}`);
+    console.log(`  ${chalk.red('❌ Failed:')}    ${summary.failed.toString().padStart(3)}`);
+    console.log(`  ${chalk.yellow('⚠️  Partial:')}  ${summary.partial.toString().padStart(3)}`);
+    console.log(`  ${chalk.gray('⏭️  Skipped:')}  ${summary.skipped.toString().padStart(3)}`);
+    console.log();
+    console.log(`  Pass Rate: ${passRateColor(passRatePercent + '%')}`);
+    console.log();
+    // Issues
+    if (summary.criticalIssues > 0 || summary.highIssues > 0 ||
+        summary.mediumIssues > 0 || summary.lowIssues > 0) {
+        console.log(chalk.bold('🚨 Issues Found\n'));
+        if (summary.criticalIssues > 0) {
+            console.log(chalk.red(`  🔴 Critical: ${summary.criticalIssues}`));
+        }
+        if (summary.highIssues > 0) {
+            console.log(chalk.red(`  🟠 High: ${summary.highIssues}`));
+        }
+        if (summary.mediumIssues > 0) {
+            console.log(chalk.yellow(`  🟡 Medium: ${summary.mediumIssues}`));
+        }
+        if (summary.lowIssues > 0) {
+            console.log(chalk.gray(`  🟢 Low: ${summary.lowIssues}`));
+        }
+        console.log();
+    }
+    // Recommendations
+    if (report.recommendations && report.recommendations.length > 0) {
+        console.log(chalk.bold('💡 Recommendations\n'));
+        for (const rec of report.recommendations) {
+            console.log(`  ${rec}`);
+        }
+        console.log();
+    }
+    // Detailed Results
+    console.log(chalk.bold('📝 Detailed Results\n'));
+    // Group results by scenario
+    const resultsByScenario = new Map();
+    for (const result of report.results) {
+        if (!resultsByScenario.has(result.scenarioId)) {
+            resultsByScenario.set(result.scenarioId, []);
+        }
+        resultsByScenario.get(result.scenarioId).push(result);
+    }
+    for (const [scenarioId, results] of resultsByScenario) {
+        console.log(chalk.cyan(`  Scenario: ${scenarioId}`));
+        for (const result of results) {
+            const icon = result.status === 'pass' ? chalk.green('✅') :
+                result.status === 'fail' ? chalk.red('❌') :
+                    result.status === 'partial' ? chalk.yellow('⚠️') : chalk.gray('⏭️');
+            console.log(`    ${icon} Step ${result.stepId}: ${result.analysis.substring(0, 60)}${result.analysis.length > 60 ? '...' : ''}`);
+            if (result.issues.length > 0) {
+                for (const issue of result.issues) {
+                    const severityColor = issue.severity === 'critical' ? chalk.red :
+                        issue.severity === 'high' ? chalk.red :
+                            issue.severity === 'medium' ? chalk.yellow : chalk.gray;
+                    console.log(severityColor(`      • ${issue.severity.toUpperCase()}: ${issue.description}`));
+                }
+            }
+        }
+        console.log();
+    }
+    // Fix Suggestions
+    if (report.fixSuggestions && report.fixSuggestions.length > 0) {
+        console.log(chalk.bold('🔧 Suggested Fixes\n'));
+        for (const fix of report.fixSuggestions.slice(0, 5)) { // Show first 5
+            const priorityColor = fix.priority === 'P0' ? chalk.red :
+                fix.priority === 'P1' ? chalk.yellow : chalk.gray;
+            console.log(`  ${priorityColor(`[${fix.priority}]`)} ${fix.scenarioId} - ${fix.stepId}`);
+            console.log(`    Issue: ${fix.issue}`);
+            console.log(`    Fix: ${fix.suggestion}`);
+            console.log();
+        }
+        if (report.fixSuggestions.length > 5) {
+            console.log(chalk.gray(`  ... and ${report.fixSuggestions.length - 5} more suggestions`));
+            console.log();
+        }
+    }
+    // Footer
+    console.log(chalk.gray('─'.repeat(60)));
+    if (summary.passRate === 1) {
+        console.log(chalk.green('\n  🎉 All tests passed!'));
+    }
+    else if (summary.passRate >= 0.8) {
+        console.log(chalk.yellow('\n  ⚠️  Most tests passed. Review the failures above.'));
+    }
+    else {
+        console.log(chalk.red('\n  ❌ Significant issues found. Please fix and re-test.'));
+    }
+    // Location of full report
+    const markdownPath = join('.specsafe', 'e2e', 'reports', `${report.specId}-report.md`);
+    console.log(chalk.gray(`\n  Full report: ${markdownPath}`));
+    console.log();
+}
+//# sourceMappingURL=test-report.js.map