@specsafe/cli 0.3.6 → 0.4.0

package/dist/commands/{test.js → test-create.js}

@@ -4,12 +4,15 @@ import ora from 'ora';
 import { Workflow, ProjectTracker, validateSpecId } from '@specsafe/core';
 import { TypeScriptTestGenerator, ScenarioParser } from '@specsafe/test-gen';
 import { loadConfig } from '../config.js';
-import { mkdir, writeFile, readFile } from 'fs/promises';
+import { mkdir, writeFile, readFile, access } from 'fs/promises';
 import { join } from 'path';
-export const testCommand = new Command('test')
-    .description('Generate tests from spec (SPEC → TEST)')
+import { confirm } from '@inquirer/prompts';
+export const testCreateCommand = new Command('test-create')
+    .description('Generate tests from spec scenarios (SPEC → TEST)')
     .argument('<id>', 'Spec ID')
     .option('-n, --dry-run', 'Preview changes without writing files')
+    .option('--scenarios-only', 'Only generate tests for specific scenarios')
+    .option('--framework <framework>', 'Override test framework')
     .action(async (id, options) => {
     const spinner = ora(`Generating tests for ${id}...`).start();
     try {
@@ -18,6 +21,8 @@ export const testCommand = new Command('test')
         const config = await loadConfig();
         const workflow = new Workflow();
         const tracker = new ProjectTracker(process.cwd());
+        // Use specified framework or fall back to config
+        const framework = options.framework || config.testFramework;
         // Load existing specs from disk
         await tracker.loadSpecsIntoWorkflow(workflow);
         // Read spec file to extract scenarios
@@ -29,8 +34,11 @@ export const testCommand = new Command('test')
         catch {
             throw new Error(`Spec file not found: ${specPath}`);
         }
-        // Use ScenarioParser to extract requirements from spec content
+        spinner.stop();
+        // Parse scenarios from spec
         const parser = new ScenarioParser();
+        let scenarios = parser.parseScenarios(specContent);
+        // Also parse requirements
         let requirements = parser.parseRequirements(specContent);
         // Fall back to basic table parsing if ScenarioParser finds nothing
         if (requirements.length === 0) {
@@ -41,12 +49,24 @@ export const testCommand = new Command('test')
                     requirements = rows.map(row => ({
                         id: row.match(/FR-\d+/)?.[0] || 'REQ-1',
                         text: row.split('|')[2]?.trim() || 'Requirement',
-                        priority: 'P0',
+                        priority: 'P1',
                         scenarios: []
                     }));
                 }
             }
         }
+        // Parse manual scenarios from markdown
+        if (scenarios.length === 0) {
+            const scenarioMatches = specContent.matchAll(/###\s*Scenario\s*\d*:?\s*(.+?)\n[\s\S]*?\*\*Given\*\*\s*(.+?)\n[\s\S]*?\*\*When\*\*\s*(.+?)\n[\s\S]*?\*\*Then\*\*\s*(.+?)(?=\n###|$)/gi);
+            for (const match of scenarioMatches) {
+                scenarios.push({
+                    id: `SC-${scenarios.length + 1}`,
+                    given: match[2].trim(),
+                    when: match[3].trim(),
+                    thenOutcome: match[4].trim()
+                });
+            }
+        }
         // Ensure spec exists in workflow
         let spec = workflow.getSpec(id);
         if (!spec) {
@@ -54,19 +74,18 @@ export const testCommand = new Command('test')
         }
         // Update spec with parsed requirements
         spec.requirements = requirements;
-        // Also parse inline scenarios from spec content
-        const generator = new TypeScriptTestGenerator({
-            framework: config.testFramework
-        });
-        const inlineScenarios = generator.parseScenarios(specContent);
-        // Add inline scenarios to requirements if they exist and requirements lack scenarios
-        if (inlineScenarios.length > 0 && spec.requirements.length > 0) {
-            // Distribute scenarios across requirements, or add to first requirement
-            const firstReq = spec.requirements[0];
-            if (firstReq.scenarios.length === 0) {
-                firstReq.scenarios = inlineScenarios;
-            }
+        // Add scenarios to requirements
+        if (scenarios.length > 0 && spec.requirements.length > 0) {
+            // Distribute scenarios across requirements
+            scenarios.forEach((scenario, index) => {
+                const reqIndex = index % spec.requirements.length;
+                spec.requirements[reqIndex].scenarios.push(scenario);
+            });
         }
+        // Display what we found
+        console.log(chalk.blue(`\n📋 Found in spec:`));
+        console.log(chalk.gray(`   ${requirements.length} requirements`));
+        console.log(chalk.gray(`   ${scenarios.length} scenarios`));
         // Move to test stage (validates requirements exist)
         try {
             workflow.moveToTest(id);
@@ -76,45 +95,75 @@ export const testCommand = new Command('test')
                 throw new Error(`Spec '${id}' not found in project state. Run 'specsafe spec ${id}' first.`);
             }
             if (moveError.message.includes('Must be in SPEC stage')) {
-                throw new Error(`Spec '${id}' is not in SPEC stage. Run 'specsafe spec ${id}' first.`);
+                // Spec might already be in test stage or beyond, that's okay
+                console.log(chalk.gray(`   Note: Spec is already in ${spec.stage.toUpperCase()} stage`));
             }
             if (moveError.message.includes('No requirements defined')) {
                 throw new Error(`Spec '${id}' has no requirements defined. Add requirements to the spec file first.`);
             }
-            throw moveError;
         }
         // Generate test code using the actual spec object
+        spinner.start('Generating test code...');
+        const generator = new TypeScriptTestGenerator({
+            framework: framework
+        });
         const testCode = generator.generate(spec);
         // Determine test file path
-        const testPath = join('tests', `${id.toLowerCase().replace(/-/g, '_')}.test.ts`);
+        const testFileName = `${id.toLowerCase().replace(/-/g, '_')}.test.ts`;
+        const testPath = join('tests', testFileName);
+        // Check if test file already exists
+        let shouldOverwrite = true;
+        try {
+            await access(testPath);
+            spinner.stop();
+            shouldOverwrite = await confirm({
+                message: `Test file ${testPath} already exists. Overwrite?`,
+                default: false
+            });
+            spinner.start();
+        }
+        catch {
+            // File doesn't exist, proceed
+        }
         // Handle dry-run mode
         if (options.dryRun) {
             spinner.stop();
-            console.log(chalk.cyan('[DRY RUN] Would generate the following test file:\n'));
+            console.log(chalk.cyan('\n[DRY RUN] Would generate the following test file:\n'));
             console.log(chalk.cyan(`  ${testPath}`));
-            console.log(chalk.cyan(`\nTest code preview (first 20 lines):\n`));
-            const previewLines = testCode.split('\n').slice(0, 20).join('\n');
+            console.log(chalk.cyan(`\nTest code preview (first 30 lines):\n`));
+            const previewLines = testCode.split('\n').slice(0, 30).join('\n');
             console.log(chalk.gray(previewLines));
-            if (testCode.split('\n').length > 20) {
+            if (testCode.split('\n').length > 30) {
                 console.log(chalk.gray('  ... (truncated)'));
             }
-            console.log(chalk.cyan(`\nFramework: ${config.testFramework}`));
+            console.log(chalk.cyan(`\nFramework: ${framework}`));
             console.log(chalk.cyan(`Requirements: ${requirements.length}`));
+            console.log(chalk.cyan(`Scenarios: ${scenarios.length}`));
             console.log(chalk.cyan(`Would update PROJECT_STATE.md for spec: ${id}`));
             process.exit(0);
         }
+        if (!shouldOverwrite) {
+            console.log(chalk.yellow('\nSkipped: Test file not modified'));
+            return;
+        }
         // Write test file
         await mkdir('tests', { recursive: true });
         await writeFile(testPath, testCode);
         // Update spec with test file reference
-        spec.testFiles.push(testPath);
+        if (!spec.testFiles.includes(testPath)) {
+            spec.testFiles.push(testPath);
+        }
         // Persist state
         await tracker.addSpec(spec);
         spinner.succeed(chalk.green(`Generated tests for ${id}`));
-        console.log(chalk.blue(`  Test file: ${testPath}`));
-        console.log(chalk.blue(`  Framework: ${config.testFramework}`));
+        console.log(chalk.blue(`\n  Test file: ${testPath}`));
+        console.log(chalk.blue(`  Framework: ${framework}`));
         console.log(chalk.blue(`  Requirements: ${requirements.length}`));
-        console.log(chalk.blue('Next: Run specsafe code <id> to start implementation'));
+        console.log(chalk.blue(`  Scenarios: ${scenarios.length}`));
+        console.log(chalk.gray('\n  Next steps:'));
+        console.log(chalk.gray(`    1. Review and customize tests in ${testPath}`));
+        console.log(chalk.gray(`    2. Run: specsafe code ${id}  → Start implementation`));
+        console.log(chalk.gray(`    3. Run: specsafe verify ${id} → Verify against tests`));
     }
     catch (error) {
         spinner.fail(chalk.red(error.message));
@@ -131,4 +180,4 @@ export const testCommand = new Command('test')
         process.exit(1);
     }
 });
-//# sourceMappingURL=test.js.map
+//# sourceMappingURL=test-create.js.map

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

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

package/dist/commands/verify.d.ts

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

package/dist/commands/verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../src/commands/verify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0BpC,eAAO,MAAM,aAAa,SAqItB,CAAC"}

package/dist/commands/verify.js

@@ -0,0 +1,288 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import { Workflow, ProjectTracker, validateSpecId } from '@specsafe/core';
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import { access } from 'fs/promises';
+import { join } from 'path';
+import { loadConfig } from '../config.js';
+const execAsync = promisify(exec);
+export const verifyCommand = new Command('verify')
+    .description('Run tests and loop on failure (TEST → CODE loop)')
+    .argument('<id>', 'Spec ID')
+    .option('-w, --watch', 'Run in watch mode for continuous feedback')
+    .option('-u, --update', 'Update snapshots if applicable')
+    .option('--ci', 'Run in CI mode (no interactive)')
+    .action(async (id, options) => {
+    const spinner = ora(`Verifying ${id}...`).start();
+    try {
+        // Validate spec ID format
+        validateSpecId(id);
+        const workflow = new Workflow();
+        const tracker = new ProjectTracker(process.cwd());
+        const config = await loadConfig();
+        // Load existing specs from disk
+        await tracker.loadSpecsIntoWorkflow(workflow);
+        // Check if spec exists
+        const spec = workflow.getSpec(id);
+        if (!spec) {
+            throw new Error(`Spec '${id}' not found. Run 'specsafe new <name>' to create it first.`);
+        }
+        // Check if spec is in the right stage
+        if (spec.stage !== 'test' && spec.stage !== 'code' && spec.stage !== 'qa') {
+            throw new Error(`Spec '${id}' is in ${spec.stage.toUpperCase()} stage. Must be in TEST, CODE, or QA stage to verify.`);
+        }
+        // Check for test files
+        if (spec.testFiles.length === 0) {
+            // Try to find test file automatically
+            const testPath = join('tests', `${id.toLowerCase().replace(/-/g, '_')}.test.ts`);
+            try {
+                await access(testPath);
+                spec.testFiles.push(testPath);
+            }
+            catch {
+                throw new Error(`No test files found for ${id}. Run 'specsafe test ${id}' to generate tests first.`);
+            }
+        }
+        spinner.text = `Running ${config.testFramework} tests...`;
+        // Run tests based on framework
+        let testResult;
+        try {
+            testResult = await runTests(config.testFramework, spec.testFiles, options);
+        }
+        catch (error) {
+            // Parse test output even if tests fail
+            testResult = parseTestOutput(error.stdout, error.stderr, config.testFramework);
+        }
+        spinner.stop();
+        // Display results
+        console.log('\n' + chalk.bold('━'.repeat(60)));
+        console.log(chalk.bold(`  Test Results for ${id}`));
+        console.log(chalk.bold('━'.repeat(60)));
+        if (testResult.passed) {
+            console.log(chalk.green(`\n  ✅ All tests passed!`));
+            console.log(chalk.green(`     ${testResult.passedTests}/${testResult.totalTests} tests passed`));
+            console.log(chalk.gray(`     Duration: ${testResult.duration}ms`));
+            // If in CODE stage, suggest moving to QA
+            if (spec.stage === 'code') {
+                console.log(chalk.blue(`\n  💡 Ready for QA! Run: specsafe qa ${id}`));
+            }
+            else if (spec.stage === 'qa') {
+                console.log(chalk.green(`\n  🎉 Ready to complete! Run: specsafe done ${id}`));
+            }
+            else {
+                console.log(chalk.blue(`\n  💡 Tests pass! Ready to implement. Run: specsafe code ${id}`));
+            }
+            console.log(chalk.bold('━'.repeat(60)));
+            return;
+        }
+        // Tests failed - show detailed output
+        console.log(chalk.red(`\n  ❌ Tests failed`));
+        console.log(chalk.red(`     ${testResult.failedTests}/${testResult.totalTests} tests failed`));
+        console.log(chalk.gray(`     ${testResult.passedTests} passed, ${testResult.skippedTests} skipped`));
+        console.log(chalk.gray(`     Duration: ${testResult.duration}ms`));
+        if (testResult.failures.length > 0) {
+            console.log(chalk.yellow(`\n  Failed Tests:\n`));
+            for (const failure of testResult.failures.slice(0, 5)) {
+                console.log(chalk.red(`  ✗ ${failure.name}`));
+                if (failure.file) {
+                    console.log(chalk.gray(`    File: ${failure.file}`));
+                }
+                console.log(chalk.gray(`    ${failure.error.split('\n')[0]}`));
+                console.log();
+            }
+            if (testResult.failures.length > 5) {
+                console.log(chalk.gray(`  ... and ${testResult.failures.length - 5} more failures`));
+            }
+        }
+        console.log(chalk.bold('━'.repeat(60)));
+        // Provide guidance for fixes
+        console.log(chalk.yellow('\n  🔧 Suggested fixes:\n'));
+        const suggestions = generateFixSuggestions(testResult.failures, spec);
+        for (const suggestion of suggestions) {
+            console.log(chalk.blue(`  • ${suggestion}`));
+        }
+        console.log(chalk.gray(`\n  💡 Run 'specsafe code ${id}' to continue development`));
+        console.log(chalk.gray(`     Then run 'specsafe verify ${id}' again`));
+        if (!options.ci) {
+            console.log(chalk.gray(`\n     Or use --watch mode for continuous feedback:`));
+            console.log(chalk.gray(`     specsafe verify ${id} --watch`));
+        }
+        // Exit with error code in CI mode
+        if (options.ci) {
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        spinner.fail(chalk.red(error.message));
+        if (error.message.includes('not found')) {
+            console.log(chalk.gray(`💡 Tip: Run 'specsafe new <name>' to create a spec first.`));
+        }
+        else if (error.message.includes('stage')) {
+            console.log(chalk.gray(`💡 Tip: Current workflow: SPEC → TEST → CODE → QA → COMPLETE`));
+        }
+        process.exit(1);
+    }
+});
+async function runTests(framework, testFiles, options) {
+    const testFilePattern = testFiles.length > 0 ? testFiles.join(' ') : '';
+    let command;
+    switch (framework) {
+        case 'vitest':
+            command = options.watch
+                ? `npx vitest ${testFilePattern}`
+                : `npx vitest run ${testFilePattern}`;
+            if (options.update)
+                command += ' --update';
+            break;
+        case 'jest':
+            command = `npx jest ${testFilePattern}`;
+            if (options.watch)
+                command += ' --watch';
+            if (options.update)
+                command += ' --updateSnapshot';
+            break;
+        case 'playwright':
+            command = `npx playwright test ${testFilePattern}`;
+            if (options.watch)
+                command += ' --ui';
+            break;
+        default:
+            // Try to detect from package.json
+            command = `npm test -- ${testFilePattern}`;
+            if (options.watch)
+                command += ' --watch';
+    }
+    try {
+        const { stdout, stderr } = await execAsync(command, {
+            timeout: options.watch ? undefined : 120000,
+            env: { ...process.env, CI: options.watch ? 'false' : 'true' }
+        });
+        return parseTestOutput(stdout, stderr, framework);
+    }
+    catch (error) {
+        // Test command failed - parse the output anyway
+        if (error.stdout || error.stderr) {
+            return parseTestOutput(error.stdout || '', error.stderr || '', framework);
+        }
+        throw error;
+    }
+}
+function parseTestOutput(stdout, stderr, framework) {
+    const output = stdout + stderr;
+    const result = {
+        passed: false,
+        totalTests: 0,
+        passedTests: 0,
+        failedTests: 0,
+        skippedTests: 0,
+        duration: 0,
+        failures: []
+    };
+    if (framework === 'vitest' || output.includes('vitest')) {
+        // Parse Vitest output
+        const passMatch = output.match(/(\d+) passed/);
+        const failMatch = output.match(/(\d+) failed/);
+        const skipMatch = output.match(/(\d+) skipped/);
+        const totalMatch = output.match(/Test Files?\s+\d+ passed \((\d+) total\)/);
+        const timeMatch = output.match(/Duration\s+(\d+)ms/);
+        if (passMatch)
+            result.passedTests = parseInt(passMatch[1], 10);
+        if (failMatch)
+            result.failedTests = parseInt(failMatch[1], 10);
+        if (skipMatch)
+            result.skippedTests = parseInt(skipMatch[1], 10);
+        if (timeMatch)
+            result.duration = parseInt(timeMatch[1], 10);
+        // Parse failures
+        const failureBlocks = output.match(/FAIL\s+[\s\S]+?(?=FAIL|Test Files|✓|passed|failed|$)/g) || [];
+        for (const block of failureBlocks) {
+            const testMatch = block.match(/FAIL\s+(.+)/);
+            const errorMatch = block.match(/AssertionError:\s*(.+)/) || block.match(/Error:\s*(.+)/);
+            if (testMatch) {
+                result.failures.push({
+                    name: testMatch[1].trim(),
+                    error: errorMatch ? errorMatch[1].trim() : 'Test failed',
+                    file: testMatch[1].trim().split(' ')[0]
+                });
+            }
+        }
+        result.totalTests = result.passedTests + result.failedTests + result.skippedTests;
+        result.passed = result.failedTests === 0 && result.totalTests > 0;
+    }
+    else if (framework === 'jest' || output.includes('jest')) {
+        // Parse Jest output
+        const passedMatch = output.match(/(\d+)\s+passed/);
+        const failedMatch = output.match(/(\d+)\s+failed/);
+        const skippedMatch = output.match(/(\d+)\s+skipped/);
+        const totalMatch = output.match(/(\d+)\s+total/);
+        if (passedMatch)
+            result.passedTests = parseInt(passedMatch[1], 10);
+        if (failedMatch)
+            result.failedTests = parseInt(failedMatch[1], 10);
+        if (skippedMatch)
+            result.skippedTests = parseInt(skippedMatch[1], 10);
+        if (totalMatch) {
+            result.totalTests = parseInt(totalMatch[1], 10);
+        }
+        else {
+            result.totalTests = result.passedTests + result.failedTests + result.skippedTests;
+        }
+        const timeMatch = output.match(/Time:\s+([\d.]+)\s*s/);
+        if (timeMatch)
+            result.duration = Math.round(parseFloat(timeMatch[1]) * 1000);
+        result.passed = result.failedTests === 0 && result.totalTests > 0;
+        // Parse Jest failures
+        const failMatches = output.matchAll(/✕\s+(.+)\s+\((.+?)\)/g);
+        for (const match of failMatches) {
+            result.failures.push({
+                name: match[1].trim(),
+                error: 'Test failed',
+                file: match[2].trim()
+            });
+        }
+    }
+    else {
+        // Generic parsing
+        const passed = output.match(/passed|✓|success/gi);
+        const failed = output.match(/failed|✕|error/gi);
+        result.passed = !!(!failed || (passed && !failed));
+        result.passedTests = passed ? passed.length : 0;
+        result.failedTests = failed ? failed.length : 0;
+        result.totalTests = result.passedTests + result.failedTests;
+    }
+    return result;
+}
+function generateFixSuggestions(failures, spec) {
+    const suggestions = [];
+    if (failures.length === 0) {
+        suggestions.push('No specific failures detected. Check test output above.');
+        return suggestions;
+    }
+    // Analyze failure patterns
+    const hasAssertionErrors = failures.some(f => f.error.toLowerCase().includes('expected') ||
+        f.error.toLowerCase().includes('assertion'));
+    const hasMissingImports = failures.some(f => f.error.toLowerCase().includes('cannot find module') ||
+        f.error.toLowerCase().includes('cannot resolve'));
+    const hasTypeErrors = failures.some(f => f.error.toLowerCase().includes('type') ||
+        f.error.toLowerCase().includes('property'));
+    if (hasMissingImports) {
+        suggestions.push('Missing imports detected. Check that all dependencies are installed: npm install');
+    }
+    if (hasTypeErrors) {
+        suggestions.push('Type errors found. Run: npx tsc --noEmit to see full type errors');
+    }
+    if (hasAssertionErrors) {
+        suggestions.push('Test assertions failing. Review the expected vs actual values above.');
+        suggestions.push('Check if implementation matches the spec requirements in ' + spec.id);
+    }
+    if (!hasMissingImports && !hasTypeErrors && !hasAssertionErrors) {
+        suggestions.push('Review the spec file: specs/active/' + spec.id + '.md');
+        suggestions.push('Ensure implementation covers all acceptance criteria');
+        suggestions.push('Check that test setup/teardown is correct');
+    }
+    suggestions.push('Run individual test: npx vitest run --reporter=verbose ' + spec.testFiles[0]);
+    return suggestions;
+}
+//# sourceMappingURL=verify.js.map

package/dist/commands/verify.js.map

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

package/dist/index.d.ts

@@ -2,6 +2,7 @@
 /**
  * SpecSafe CLI
  * Command-line interface for the SpecSafe TDD framework
+ * Version 0.4.0 - OpenSpec-style workflow
  */
 export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;GAGG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;GAIG"}

package/dist/index.js

@@ -2,6 +2,7 @@
 /**
  * SpecSafe CLI
  * Command-line interface for the SpecSafe TDD framework
+ * Version 0.4.0 - OpenSpec-style workflow
  */
 import { Command } from 'commander';
 import chalk from 'chalk';
@@ -9,14 +10,17 @@ import { initCommand } from './commands/init.js';
 import { newCommand } from './commands/new.js';
 import { statusCommand } from './commands/status.js';
 import { specCommand } from './commands/spec.js';
-import { testCommand } from './commands/test.js';
-import { codeCommand } from './commands/code.js';
+import { testCreateCommand } from './commands/test-create.js';
+import { testApplyCommand } from './commands/test-apply.js';
 import { qaCommand } from './commands/qa.js';
+import { doneCommand } from './commands/done.js';
 import { completeCommand } from './commands/complete.js';
 import { listCommand } from './commands/list.js';
 import { archiveCommand } from './commands/archive.js';
 import { doctorCommand } from './commands/doctor.js';
 import { rulesCommand } from './commands/rules.js';
+import { verifyCommand } from './commands/verify.js';
+import { exploreCommand } from './commands/explore.js';
 import { createRequire } from 'module';
 const require = createRequire(import.meta.url);
 const packageJson = require('../package.json');
@@ -24,20 +28,56 @@ const program = new Command();
 program
     .name('specsafe')
     .description('SpecSafe - Test-Driven Development framework for AI-assisted software engineering')
-    .version(packageJson.version);
+    .version(packageJson.version)
+    .option('-v, --verbose', 'Enable verbose output');
 // Add commands
 program.addCommand(initCommand);
 program.addCommand(newCommand);
 program.addCommand(statusCommand);
 program.addCommand(listCommand);
+program.addCommand(exploreCommand); // NEW: Pre-spec exploration
 program.addCommand(specCommand);
-program.addCommand(testCommand);
-program.addCommand(codeCommand);
+program.addCommand(testCreateCommand); // NEW: Generate tests from scenarios
+program.addCommand(testApplyCommand); // NEW: Run tests, loop on failure
 program.addCommand(qaCommand);
-program.addCommand(completeCommand);
+program.addCommand(verifyCommand); // NEW: Test runner with loop
+program.addCommand(doneCommand); // NEW: Complete + archive
+program.addCommand(completeCommand); // DEPRECATED: Use 'done' instead
 program.addCommand(archiveCommand);
 program.addCommand(doctorCommand);
 program.addCommand(rulesCommand);
+// Workflow command group
+program
+    .command('workflow')
+    .description('Show the SpecSafe workflow diagram')
+    .action(() => {
+    console.log(chalk.blue('\n┌─────────────────────────────────────────────────────────────┐'));
+    console.log(chalk.blue('│                    SpecSafe Workflow                        │'));
+    console.log(chalk.blue('│                       v0.4.0 - OpenSpec                    │'));
+    console.log(chalk.blue('└─────────────────────────────────────────────────────────────┘\n'));
+    console.log(chalk.white('Pre-Spec:'));
+    console.log(chalk.gray('  specsafe explore          → Think through ideas before committing\n'));
+    console.log(chalk.white('Development Cycle:'));
+    console.log(chalk.cyan('  specsafe new [feature]    → Create spec with PRD + BRD'));
+    console.log(chalk.gray('       ↓'));
+    console.log(chalk.cyan('  specsafe spec <id>        → Flesh out detailed spec'));
+    console.log(chalk.gray('       ↓'));
+    console.log(chalk.cyan('  specsafe test-create <id> → Generate tests from scenarios'));
+    console.log(chalk.gray('       ↓'));
+    console.log(chalk.cyan('  specsafe test-apply <id>  → Run tests, loop on failure'));
+    console.log(chalk.gray('       ↓ (if tests pass)'));
+    console.log(chalk.cyan('  specsafe qa <id>          → QA validation'));
+    console.log(chalk.gray('       ↓'));
+    console.log(chalk.cyan('  specsafe done <id>        → Complete & archive'));
+    console.log();
+    console.log(chalk.white('Utility Commands:'));
+    console.log(chalk.gray('  specsafe status           → View project status'));
+    console.log(chalk.gray('  specsafe list             → List all specs'));
+    console.log(chalk.gray('  specsafe doctor           → Check project health'));
+    console.log();
+    console.log(chalk.yellow('💡 The verify command is the key differentiator:'));
+    console.log(chalk.yellow('   It runs tests and provides feedback for the dev loop.\n'));
+});
 // Global error handling
 program.exitOverride();
 (async () => {