@specsafe/cli 0.1.0

package/dist/commands/doctor.d.ts

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

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

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

package/dist/commands/doctor.js

@@ -0,0 +1,204 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { access, readFile } from 'fs/promises';
+import { join } from 'path';
+export const doctorCommand = new Command('doctor')
+    .description('Validate project setup and report issues')
+    .action(async () => {
+    console.log(chalk.bold('\nSpecSafe Doctor 🩺\n'));
+    const results = [];
+    // Check 1: Node.js version
+    const nodeVersion = process.version;
+    const nodeMajor = parseInt(nodeVersion.slice(1).split('.')[0], 10);
+    if (nodeMajor >= 18) {
+        results.push({
+            status: 'pass',
+            message: `Node.js ${nodeVersion} (>= 18 required)`
+        });
+    }
+    else {
+        results.push({
+            status: 'error',
+            message: `Node.js ${nodeVersion} (< 18 required)`,
+            fix: 'Upgrade to Node.js 18 or higher'
+        });
+    }
+    // Check 2: Project initialized (PROJECT_STATE.md exists)
+    const projectStatePath = join(process.cwd(), 'PROJECT_STATE.md');
+    try {
+        await access(projectStatePath);
+        results.push({
+            status: 'pass',
+            message: 'PROJECT_STATE.md found'
+        });
+    }
+    catch {
+        results.push({
+            status: 'error',
+            message: 'PROJECT_STATE.md not found',
+            fix: "Run 'specsafe init' to initialize the project"
+        });
+    }
+    // Check 3: Directory structure (specs/, tests/)
+    const specsDir = join(process.cwd(), 'specs');
+    const testsDir = join(process.cwd(), 'tests');
+    try {
+        await access(specsDir);
+        results.push({
+            status: 'pass',
+            message: 'specs/ directory found'
+        });
+    }
+    catch {
+        results.push({
+            status: 'warn',
+            message: 'specs/ directory missing',
+            fix: "Run 'specsafe init' to create"
+        });
+    }
+    try {
+        await access(testsDir);
+        results.push({
+            status: 'pass',
+            message: 'tests/ directory found'
+        });
+    }
+    catch {
+        results.push({
+            status: 'warn',
+            message: 'tests/ directory missing',
+            fix: "Run 'specsafe init' to create"
+        });
+    }
+    // Check 4: Config file validation
+    const configPath = join(process.cwd(), 'specsafe.config.json');
+    try {
+        await access(configPath);
+        const configContent = await readFile(configPath, 'utf-8');
+        try {
+            const config = JSON.parse(configContent);
+            // Validate known fields
+            const knownFields = ['projectName', 'version', 'stages', 'testFramework', 'language'];
+            const unknownFields = Object.keys(config).filter(key => !knownFields.includes(key));
+            if (unknownFields.length > 0) {
+                results.push({
+                    status: 'warn',
+                    message: `Config file has unknown fields: ${unknownFields.join(', ')}`
+                });
+            }
+            else {
+                results.push({
+                    status: 'pass',
+                    message: 'Config file valid'
+                });
+            }
+        }
+        catch (parseError) {
+            results.push({
+                status: 'error',
+                message: 'Config file has invalid JSON',
+                fix: 'Fix syntax errors in specsafe.config.json'
+            });
+        }
+    }
+    catch {
+        // Config file is optional, so this is just info
+        results.push({
+            status: 'pass',
+            message: 'No config file (using defaults)'
+        });
+    }
+    // Check 5: Dependencies (@specsafe/core and @specsafe/test-gen)
+    const nodeModulesPath = join(process.cwd(), 'node_modules');
+    const corePath = join(nodeModulesPath, '@specsafe', 'core');
+    const testGenPath = join(nodeModulesPath, '@specsafe', 'test-gen');
+    try {
+        await access(corePath);
+        results.push({
+            status: 'pass',
+            message: '@specsafe/core installed'
+        });
+    }
+    catch {
+        results.push({
+            status: 'error',
+            message: '@specsafe/core not found',
+            fix: "Run 'npm install @specsafe/core'"
+        });
+    }
+    try {
+        await access(testGenPath);
+        results.push({
+            status: 'pass',
+            message: '@specsafe/test-gen installed'
+        });
+    }
+    catch {
+        results.push({
+            status: 'error',
+            message: '@specsafe/test-gen not found',
+            fix: "Run 'npm install @specsafe/test-gen'"
+        });
+    }
+    // Check 6: Git repo (recommended but not required)
+    const gitPath = join(process.cwd(), '.git');
+    try {
+        await access(gitPath);
+        results.push({
+            status: 'pass',
+            message: 'Git repository detected'
+        });
+    }
+    catch {
+        results.push({
+            status: 'warn',
+            message: 'No Git repository found',
+            fix: "Run 'git init' to initialize (recommended)"
+        });
+    }
+    // Print results
+    let passed = 0;
+    let warnings = 0;
+    let errors = 0;
+    for (const result of results) {
+        let icon;
+        let color;
+        switch (result.status) {
+            case 'pass':
+                icon = '✅';
+                color = chalk.green;
+                passed++;
+                break;
+            case 'warn':
+                icon = '⚠️';
+                color = chalk.yellow;
+                warnings++;
+                break;
+            case 'error':
+                icon = '❌';
+                color = chalk.red;
+                errors++;
+                break;
+        }
+        console.log(`  ${icon} ${color(result.message)}`);
+        if (result.fix) {
+            console.log(`     ${chalk.gray(result.fix)}`);
+        }
+    }
+    // Summary
+    console.log('');
+    const parts = [];
+    if (passed > 0)
+        parts.push(chalk.green(`${passed} passed`));
+    if (warnings > 0)
+        parts.push(chalk.yellow(`${warnings} warning${warnings > 1 ? 's' : ''}`));
+    if (errors > 0)
+        parts.push(chalk.red(`${errors} error${errors > 1 ? 's' : ''}`));
+    console.log(`  ${parts.join(', ')}`);
+    console.log('');
+    // Exit with error code if there are errors
+    if (errors > 0) {
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/init.d.ts

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

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

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

package/dist/commands/init.js

@@ -0,0 +1,80 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import { writeFile, mkdir } from 'fs/promises';
+import { ProjectTracker } from '@specsafe/core';
+export const initCommand = new Command('init')
+    .description('Initialize a new SpecSafe project')
+    .argument('[name]', 'Project name', 'my-project')
+    .action(async (name) => {
+    const spinner = ora('Initializing SpecSafe project...').start();
+    try {
+        // Create directory structure
+        await mkdir('specs/active', { recursive: true });
+        await mkdir('specs/completed', { recursive: true });
+        await mkdir('specs/archive', { recursive: true });
+        await mkdir('src', { recursive: true });
+        await mkdir('tests', { recursive: true });
+        // Create PROJECT_STATE.md
+        const tracker = new ProjectTracker(process.cwd());
+        await tracker.initialize(name);
+        // Create spec template
+        const template = `# Spec Template
+
+## Metadata
+- **ID**: SPEC-{YYYYMMDD}-{NNN}
+- **Status**: draft
+- **Priority**: P1
+
+## 1. Purpose (WHY)
+
+## 2. Scope (WHAT)
+### In Scope
+- 
+
+### Out of Scope
+- 
+
+## 3. Requirements
+| ID | Requirement | Priority | Acceptance Criteria |
+|----|-------------|----------|---------------------|
+|    |             |          |                     |
+
+## 4. Technical Approach (HOW)
+
+## 5. Test Strategy
+
+## 6. Implementation Plan
+
+## 7. Success Criteria
+- [ ] 
+
+## 8. Risks & Mitigations
+
+## 9. Notes & References
+`;
+        await writeFile('specs/template.md', template);
+        // Create config file
+        const config = {
+            projectName: name,
+            version: '1.0.0',
+            stages: ['spec', 'test', 'code', 'qa', 'complete'],
+            testFramework: 'vitest',
+            language: 'typescript'
+        };
+        await writeFile('specsafe.config.json', JSON.stringify(config, null, 2));
+        spinner.succeed(chalk.green(`Initialized SpecSafe project: ${name}`));
+        console.log('\n' + chalk.blue('Next steps:'));
+        console.log('  1. specsafe new <spec-name>  - Create a new spec');
+        console.log('  2. specsafe status             - View project status');
+        console.log('  3. Edit specs/active/ to define requirements');
+    }
+    catch (error) {
+        spinner.fail(chalk.red(`Failed to initialize: ${error.message}`));
+        if (error.message.includes('EEXIST')) {
+            console.log(chalk.gray('💡 Tip: Directory already exists. Use \'specsafe init <name>\' to create elsewhere.'));
+        }
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;KAC3C,WAAW,CAAC,mCAAmC,CAAC;KAChD,QAAQ,CAAC,QAAQ,EAAE,cAAc,EAAE,YAAY,CAAC;KAChD,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,EAAE;IAC7B,MAAM,OAAO,GAAG,GAAG,CAAC,kCAAkC,CAAC,CAAC,KAAK,EAAE,CAAC;IAEhE,IAAI,CAAC;QACH,6BAA6B;QAC7B,MAAM,KAAK,CAAC,cAAc,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,MAAM,KAAK,CAAC,iBAAiB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,MAAM,KAAK,CAAC,eAAe,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,MAAM,KAAK,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACxC,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE1C,0BAA0B;QAC1B,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAClD,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAE/B,uBAAuB;QACvB,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCtB,CAAC;QACI,MAAM,SAAS,CAAC,mBAAmB,EAAE,QAAQ,CAAC,CAAC;QAE/C,qBAAqB;QACrB,MAAM,MAAM,GAAG;YACb,WAAW,EAAE,IAAI;YACjB,OAAO,EAAE,OAAO;YAChB,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC;YAClD,aAAa,EAAE,QAAQ;YACvB,QAAQ,EAAE,YAAY;SACvB,CAAC;QACF,MAAM,SAAS,CAAC,sBAAsB,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAEzE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,iCAAiC,IAAI,EAAE,CAAC,CAAC,CAAC;QAEtE,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;QAC9C,OAAO,CAAC,GAAG,CAAC,oDAAoD,CAAC,CAAC;QAClE,OAAO,CAAC,GAAG,CAAC,wDAAwD,CAAC,CAAC;QACtE,OAAO,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC;IAChE,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,yBAAyB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAClE,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACrC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,qFAAqF,CAAC,CAAC,CAAC;QACjH,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/commands/list.d.ts

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

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

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

package/dist/commands/list.js

@@ -0,0 +1,122 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import { ProjectTracker } from '@specsafe/core';
+import { loadConfig } from '../config.js';
+export const listCommand = new Command('list')
+    .description('List all specs from PROJECT_STATE.md')
+    .option('--stage <stage>', 'Filter by stage (spec, test, code, qa, complete, archived)')
+    .option('--json', 'Output as JSON')
+    .action(async (options) => {
+    const spinner = ora('Loading specs...').start();
+    try {
+        const config = await loadConfig();
+        const tracker = new ProjectTracker(process.cwd());
+        const state = await tracker.readState();
+        if (!state) {
+            spinner.stop();
+            console.log(chalk.yellow('No SpecSafe project found.'));
+            console.log(chalk.gray('💡 Tip: Run "specsafe init" to initialize a new project.'));
+            process.exit(1);
+        }
+        spinner.stop();
+        // Filter specs if stage option is provided
+        let specs = state.specs;
+        if (options.stage) {
+            const stage = options.stage.toLowerCase();
+            const validStages = ['spec', 'test', 'code', 'qa', 'complete', 'archived'];
+            if (!validStages.includes(stage)) {
+                console.error(chalk.red(`Invalid stage: ${options.stage}`));
+                console.log(chalk.gray(`Valid stages: ${validStages.join(', ')}`));
+                process.exit(1);
+            }
+            specs = specs.filter(s => s.stage === stage);
+        }
+        // Sort by last updated (most recent first)
+        specs = specs.sort((a, b) => b.lastUpdated.getTime() - a.lastUpdated.getTime());
+        // Output as JSON if requested
+        if (options.json) {
+            const output = specs.map(s => ({
+                id: s.id,
+                name: s.name,
+                stage: s.stage,
+                progress: s.progress,
+                lastUpdated: s.lastUpdated.toISOString(),
+                createdAt: s.createdAt?.toISOString(),
+                completedAt: s.completedAt?.toISOString()
+            }));
+            console.log(JSON.stringify(output, null, 2));
+            return;
+        }
+        // Table output
+        if (specs.length === 0) {
+            console.log(chalk.yellow('\nNo specs found.'));
+            if (options.stage) {
+                console.log(chalk.gray(`No specs in stage: ${options.stage.toUpperCase()}`));
+            }
+            else {
+                console.log(chalk.gray('Create your first spec with: specsafe new <name>'));
+            }
+            console.log();
+            return;
+        }
+        console.log(chalk.bold.blue(`\n📋 ${config.projectName} - Specs (${specs.length})\n`));
+        // Print table header
+        console.log(chalk.bold('ID                 Name                           Stage      Progress  Last Updated'));
+        console.log(chalk.gray('─'.repeat(90)));
+        // Print specs
+        specs.forEach((spec) => {
+            const stageColor = getStageColor(spec.stage);
+            const id = spec.id.padEnd(18);
+            const name = spec.name.slice(0, 28).padEnd(30);
+            const stage = stageColor(spec.stage.toUpperCase().padEnd(10));
+            const progress = `${spec.progress}%`.padEnd(8);
+            const lastUpdated = spec.lastUpdated.toISOString().split('T')[0];
+            console.log(`${id} ${name} ${stage} ${progress} ${lastUpdated}`);
+        });
+        console.log();
+        // Print summary by stage
+        const stages = ['spec', 'test', 'code', 'qa', 'complete', 'archived'];
+        const byStage = stages.map(s => ({
+            stage: s,
+            count: state.specs.filter(spec => spec.stage === s).length
+        })).filter(s => s.count > 0);
+        if (byStage.length > 0 && !options.stage) {
+            console.log(chalk.bold('Summary:'));
+            byStage.forEach(({ stage, count }) => {
+                const color = getStageColor(stage);
+                console.log(`  ${color(stage.toUpperCase().padEnd(10))} ${count}`);
+            });
+            console.log();
+        }
+    }
+    catch (error) {
+        spinner.fail(chalk.red(error.message));
+        if (error.message.includes('PROJECT_STATE') || error.message.includes('not found')) {
+            console.log(chalk.gray('💡 Tip: Run "specsafe init" to initialize the project.'));
+        }
+        else if (error.message.includes('Invalid stage')) {
+            console.log(chalk.gray('💡 Tip: Valid stages: spec, test, code, qa, complete, archived'));
+        }
+        process.exit(1);
+    }
+});
+function getStageColor(stage) {
+    switch (stage) {
+        case 'complete':
+            return chalk.green;
+        case 'archived':
+            return chalk.gray;
+        case 'qa':
+            return chalk.magenta;
+        case 'code':
+            return chalk.yellow;
+        case 'test':
+            return chalk.cyan;
+        case 'spec':
+            return chalk.blue;
+        default:
+            return chalk.white;
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/list.js.map

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

package/dist/commands/new.d.ts

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

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

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

package/dist/commands/new.js

@@ -0,0 +1,141 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import { writeFile, mkdir, readdir } from 'fs/promises';
+import { join, basename } from 'path';
+import { Workflow, ProjectTracker } from '@specsafe/core';
+export const newCommand = new Command('new')
+    .description('Create a new spec')
+    .argument('<name>', 'Spec name (kebab-case)')
+    .option('-d, --description <desc>', 'Spec description')
+    .option('-a, --author <author>', 'Author name', 'developer')
+    .option('-n, --dry-run', 'Preview changes without writing files')
+    .action(async (name, options) => {
+    const spinner = ora('Creating new spec...').start();
+    try {
+        const workflow = new Workflow();
+        const tracker = new ProjectTracker(process.cwd());
+        // Generate spec ID with auto-increment to avoid collisions
+        const date = new Date().toISOString().split('T')[0].replace(/-/g, '');
+        // Check if specs/active directory exists
+        try {
+            await readdir('specs/active');
+        }
+        catch (err) {
+            if (err.code === 'ENOENT') {
+                throw new Error('specs/active/ directory not found. Run "specsafe init" first to initialize the project.');
+            }
+            throw err;
+        }
+        // List existing specs for today and find max suffix
+        let maxSuffix = 0;
+        try {
+            const files = await readdir('specs/active');
+            const todayPrefix = `SPEC-${date}-`;
+            for (const file of files) {
+                if (file.startsWith(todayPrefix) && file.endsWith('.md')) {
+                    const suffix = parseInt(file.replace(todayPrefix, '').replace('.md', ''), 10);
+                    if (!isNaN(suffix) && suffix > maxSuffix) {
+                        maxSuffix = suffix;
+                    }
+                }
+            }
+        }
+        catch {
+            // Directory doesn't exist yet, that's fine
+        }
+        const id = `SPEC-${date}-${String(maxSuffix + 1).padStart(3, '0')}`;
+        // Create spec
+        const spec = workflow.createSpec(id, name, options.description || `Spec for ${name}`, options.author, basename(process.cwd()));
+        // Create spec content
+        const specContent = `# ${name} Specification
+
+**ID:** ${id}  
+**Status:** SPEC  
+**Created:** ${new Date().toISOString().split('T')[0]}  
+**Author:** ${options.author}
+
+## 1. Purpose (WHY)
+<!-- Why are we building this? -->
+
+## 2. Scope (WHAT)
+### In Scope
+- 
+
+### Out of Scope
+- 
+
+## 3. Requirements
+### Functional Requirements
+| ID | Requirement | Priority | Acceptance Criteria |
+|----|-------------|----------|---------------------|
+| FR-1 | | P0 | |
+
+### Non-Functional Requirements
+| ID | Requirement | Metric |
+|----|-------------|--------|
+| NFR-1 | | |
+
+## 4. Technical Approach (HOW)
+
+## 5. Test Strategy (TDD)
+### Unit Tests
+- 
+
+### Integration Tests
+- 
+
+## 6. Implementation Plan
+| Phase | Task | Est. Time | Dependencies |
+|-------|------|-----------|--------------|
+| 1 | | | |
+
+## 7. Success Criteria
+- [ ] All P0 requirements met
+- [ ] All tests passing
+- [ ] Documentation complete
+
+## 8. Risks & Mitigations
+| Risk | Probability | Impact | Mitigation |
+|------|-------------|--------|------------|
+| | | | |
+
+## 9. Notes & References
+- 
+`;
+        const specPath = join('specs/active', `${id}.md`);
+        // Handle dry-run mode
+        if (options.dryRun) {
+            spinner.stop();
+            console.log(chalk.cyan('[DRY RUN] Would create the following files:\n'));
+            console.log(chalk.cyan(`  ${specPath}`));
+            console.log(chalk.cyan(`\nContent preview (first 20 lines):\n`));
+            const previewLines = specContent.split('\n').slice(0, 20).join('\n');
+            console.log(chalk.gray(previewLines));
+            if (specContent.split('\n').length > 20) {
+                console.log(chalk.gray('  ... (truncated)'));
+            }
+            console.log(chalk.cyan(`\nWould update PROJECT_STATE.md with spec: ${id}`));
+            process.exit(0);
+        }
+        // Create spec file
+        await mkdir('specs/active', { recursive: true });
+        await writeFile(specPath, specContent);
+        // Update project state
+        await tracker.addSpec(spec);
+        spinner.succeed(chalk.green(`Created spec: ${id}`));
+        console.log(chalk.blue(`  Location: ${specPath}`));
+        console.log(chalk.gray('  Edit the spec to add requirements, then run: specsafe spec <id>'));
+    }
+    catch (error) {
+        spinner.fail(chalk.red(`Failed to create spec: ${error.message}`));
+        if (error.message.includes('specs/active/')) {
+            console.log(chalk.gray('💡 Tip: Run "specsafe init" to initialize the project first.'));
+        }
+        else if (error.message.includes('already exists')) {
+            console.log(chalk.gray('💡 Tip: Use a different spec name or delete the existing spec first.'));
+        }
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=new.js.map

package/dist/commands/new.js.map

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

package/dist/commands/qa.d.ts

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

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

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