spec-gen-cli 1.0.0

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

@@ -0,0 +1,9 @@
+/**
+ * spec-gen init command
+ *
+ * Verifies we're in a valid project and creates .spec-gen configuration.
+ * Detects project type, existing OpenSpec setup, and prepares for analysis.
+ */
+import { Command } from 'commander';
+export declare const initCommand: Command;
+//# sourceMappingURL=init.d.ts.map

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

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

package/dist/cli/commands/init.js

@@ -0,0 +1,171 @@
+/**
+ * spec-gen init command
+ *
+ * Verifies we're in a valid project and creates .spec-gen configuration.
+ * Detects project type, existing OpenSpec setup, and prepares for analysis.
+ */
+import { Command } from 'commander';
+import { resolve, relative } from 'node:path';
+import { confirm } from '@inquirer/prompts';
+import { logger } from '../../utils/logger.js';
+import { detectProjectType, getProjectTypeName, } from '../../core/services/project-detector.js';
+import { getDefaultConfig, readSpecGenConfig, writeSpecGenConfig, specGenConfigExists, readOpenSpecConfig, openspecDirExists, openspecConfigExists, createOpenSpecStructure, } from '../../core/services/config-manager.js';
+import { gitignoreExists, isInGitignore, addToGitignore, } from '../../core/services/gitignore-manager.js';
+export const initCommand = new Command('init')
+    .description('Initialize spec-gen in the current project')
+    .option('--force', 'Overwrite existing configuration', false)
+    .option('--openspec-path <path>', 'Custom path for openspec/ output directory', './openspec')
+    .addHelpText('after', `
+Examples:
+  $ spec-gen init                    Initialize with defaults
+  $ spec-gen init --force            Overwrite existing config
+  $ spec-gen init --openspec-path ./docs/specs
+                                     Use custom output path
+
+What this command does:
+  1. Detects project type (Node.js, Python, Rust, Go, etc.)
+  2. Checks for existing OpenSpec setup
+  3. Creates .spec-gen/config.json configuration file
+  4. Updates .gitignore to exclude .spec-gen/
+  5. Prepares project for analysis
+
+After initialization, run 'spec-gen analyze' to scan your codebase.
+`)
+    .action(async (options) => {
+    const rootPath = process.cwd();
+    const openspecPath = resolve(rootPath, options.openspecPath ?? './openspec');
+    const force = options.force ?? false;
+    // Prevent path traversal — openspec directory must be within the project root
+    const relPath = relative(rootPath, openspecPath);
+    if (relPath.startsWith('..')) {
+        logger.error('OpenSpec path must be within the project directory.');
+        process.exitCode = 1;
+        return;
+    }
+    logger.section('Initializing spec-gen');
+    // Step 1: Project Detection
+    logger.discovery('Detecting project type...');
+    const detection = await detectProjectType(rootPath);
+    if (!detection.hasGit) {
+        logger.warning('No .git directory found. This may not be a repository root.');
+        logger.debug('Continuing anyway - spec-gen works without git');
+    }
+    else {
+        logger.debug('Git repository detected');
+    }
+    if (detection.projectType === 'unknown') {
+        logger.warning('Could not detect project type. No known manifest files found.');
+        logger.info('Supported', 'package.json, pyproject.toml, Cargo.toml, go.mod, pom.xml, Gemfile, composer.json');
+    }
+    else {
+        logger.success(`Detected ${getProjectTypeName(detection.projectType)} project`);
+        if (detection.manifestFile) {
+            logger.debug(`Found manifest: ${detection.manifestFile}`);
+        }
+        if (detection.confidence !== 'high') {
+            logger.debug(`Detection confidence: ${detection.confidence}`);
+        }
+    }
+    logger.blank();
+    // Step 2: Check for existing configurations
+    logger.discovery('Checking for existing configurations...');
+    const existingSpecGenConfig = await specGenConfigExists(rootPath);
+    const existingOpenspecDir = await openspecDirExists(openspecPath);
+    const existingOpenspecConfig = await openspecConfigExists(openspecPath);
+    if (existingSpecGenConfig && !force) {
+        logger.warning('.spec-gen/config.json already exists');
+        const existingConfig = await readSpecGenConfig(rootPath);
+        if (existingConfig) {
+            logger.info('Existing project type', getProjectTypeName(existingConfig.projectType));
+            logger.info('Created', existingConfig.createdAt);
+            if (existingConfig.lastRun) {
+                logger.info('Last run', existingConfig.lastRun);
+            }
+        }
+        logger.blank();
+        // Check if running in TTY for interactive prompt
+        if (process.stdin.isTTY) {
+            const overwrite = await confirm({
+                message: 'Overwrite existing configuration?',
+                default: false,
+            });
+            if (!overwrite) {
+                logger.info('Aborted', 'Use --force to overwrite without prompting');
+                return;
+            }
+        }
+        else {
+            logger.error('Configuration exists. Use --force to overwrite in non-interactive mode.');
+            process.exitCode = 1;
+            return;
+        }
+    }
+    if (existingOpenspecDir) {
+        logger.success('Found existing openspec/ directory');
+        if (existingOpenspecConfig) {
+            const openspecConfig = await readOpenSpecConfig(openspecPath);
+            if (openspecConfig?.context) {
+                logger.info('Existing context', 'Will preserve during generation');
+            }
+            logger.debug('Will integrate with existing OpenSpec setup');
+        }
+    }
+    else {
+        logger.debug('No existing openspec/ directory');
+    }
+    logger.blank();
+    // Step 3: Create configuration
+    logger.analysis('Creating configuration...');
+    const config = getDefaultConfig(detection.projectType, options.openspecPath ?? './openspec');
+    await writeSpecGenConfig(rootPath, config);
+    logger.success('Created .spec-gen/config.json');
+    // Step 4: Create OpenSpec structure if needed
+    if (!existingOpenspecDir) {
+        await createOpenSpecStructure(openspecPath);
+        logger.success(`Created ${options.openspecPath ?? './openspec'}/ directory structure`);
+    }
+    // Step 5: Update .gitignore
+    logger.blank();
+    logger.discovery('Checking .gitignore...');
+    const hasGitignore = await gitignoreExists(rootPath);
+    const alreadyIgnored = hasGitignore && (await isInGitignore(rootPath, '.spec-gen/'));
+    if (alreadyIgnored) {
+        logger.debug('.spec-gen/ already in .gitignore');
+    }
+    else if (hasGitignore) {
+        // Check if running in TTY for interactive prompt
+        let shouldAdd = true;
+        if (process.stdin.isTTY) {
+            shouldAdd = await confirm({
+                message: 'Add .spec-gen/ to .gitignore? (recommended)',
+                default: true,
+            });
+        }
+        if (shouldAdd) {
+            await addToGitignore(rootPath, '.spec-gen/', 'spec-gen analysis artifacts');
+            logger.success('Added .spec-gen/ to .gitignore');
+        }
+        else {
+            logger.warning('.spec-gen/ not added to .gitignore');
+            logger.debug('Analysis artifacts may be committed to version control');
+        }
+    }
+    else {
+        logger.debug('No .gitignore file found');
+        logger.debug('Consider creating one to exclude .spec-gen/');
+    }
+    // Step 6: Output summary
+    logger.blank();
+    logger.section('Initialization Complete');
+    logger.info('Project type', getProjectTypeName(detection.projectType));
+    logger.info('Config file', '.spec-gen/config.json');
+    logger.info('Output path', options.openspecPath ?? './openspec');
+    if (existingOpenspecDir) {
+        logger.info('Integration', 'Will add to existing OpenSpec setup');
+    }
+    logger.blank();
+    logger.success('Ready for analysis!');
+    logger.blank();
+    logger.info('Next step', "Run 'spec-gen analyze' to scan your codebase");
+});
+//# sourceMappingURL=init.js.map

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

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