spec-gen-cli 1.0.0

package/dist/utils/prompts.js

@@ -0,0 +1,199 @@
+/**
+ * Interactive prompts for spec-gen CLI
+ * Uses @inquirer/prompts (same as OpenSpec)
+ */
+import { select, confirm, input } from '@inquirer/prompts';
+/**
+ * Prompt for handling existing spec files
+ */
+export async function promptOverwrite(filePath) {
+    return select({
+        message: `${filePath} already exists. What would you like to do?`,
+        choices: [
+            {
+                value: 'backup-replace',
+                name: 'Backup and replace (recommended)',
+                description: 'Backup existing file and write new content',
+            },
+            {
+                value: 'merge',
+                name: 'Merge (append generated content)',
+                description: 'Add generated content to end of existing file',
+            },
+            {
+                value: 'skip',
+                name: 'Skip this file',
+                description: 'Keep existing file unchanged',
+            },
+            {
+                value: 'skip-all',
+                name: 'Skip all existing files',
+                description: 'Keep all existing files unchanged',
+            },
+        ],
+    });
+}
+/**
+ * Confirm before overwriting multiple files
+ */
+export async function confirmOverwriteAll(count) {
+    return confirm({
+        message: `This will overwrite ${count} existing spec files. Continue?`,
+        default: false,
+    });
+}
+/**
+ * Confirm before running analysis that will take a while
+ */
+export async function confirmLongAnalysis(fileCount) {
+    return confirm({
+        message: `About to analyze ${fileCount} files. This may take a while. Continue?`,
+        default: true,
+    });
+}
+/**
+ * Confirm before making API calls
+ */
+export async function confirmGeneration(options) {
+    let message = `Ready to generate specs using ${options.model}.`;
+    if (options.estimatedTokens) {
+        message += ` Estimated ${options.estimatedTokens.toLocaleString()} tokens.`;
+    }
+    message += ' Continue?';
+    return confirm({
+        message,
+        default: true,
+    });
+}
+/**
+ * Prompt for API key when not found in environment
+ */
+export async function promptApiKey(provider) {
+    const envVar = provider === 'anthropic' ? 'ANTHROPIC_API_KEY' : 'OPENAI_API_KEY';
+    const url = provider === 'anthropic'
+        ? 'https://console.anthropic.com/'
+        : 'https://platform.openai.com/api-keys';
+    console.log(`\nNo ${envVar} found in environment.`);
+    console.log(`Get an API key at: ${url}\n`);
+    return input({
+        message: `Enter your ${provider} API key:`,
+        validate: (value) => {
+            if (!value.trim()) {
+                return 'API key is required';
+            }
+            if (provider === 'anthropic' && !value.startsWith('sk-ant-')) {
+                return 'Anthropic API keys should start with sk-ant-';
+            }
+            if (provider === 'openai' && !value.startsWith('sk-')) {
+                return 'OpenAI API keys should start with sk-';
+            }
+            return true;
+        },
+    });
+}
+/**
+ * Select LLM provider when multiple are available
+ */
+export async function selectProvider() {
+    return select({
+        message: 'Multiple API keys found. Which provider would you like to use?',
+        choices: [
+            {
+                value: 'anthropic',
+                name: 'Anthropic (Claude)',
+                description: 'Recommended for best results',
+            },
+            {
+                value: 'openai',
+                name: 'OpenAI (GPT-4)',
+                description: 'Alternative provider',
+            },
+        ],
+    });
+}
+/**
+ * Select verification sample count
+ */
+export async function selectSampleCount() {
+    const answer = await select({
+        message: 'How many files would you like to verify?',
+        choices: [
+            { value: '3', name: '3 files (quick check)' },
+            { value: '5', name: '5 files (recommended)' },
+            { value: '10', name: '10 files (thorough)' },
+            { value: 'custom', name: 'Custom number' },
+        ],
+    });
+    if (answer === 'custom') {
+        const customAnswer = await input({
+            message: 'Enter number of files to verify:',
+            validate: (value) => {
+                const num = parseInt(value, 10);
+                if (isNaN(num) || num < 1) {
+                    return 'Please enter a positive number';
+                }
+                if (num > 50) {
+                    return 'Maximum is 50 files';
+                }
+                return true;
+            },
+        });
+        return parseInt(customAnswer, 10);
+    }
+    return parseInt(answer, 10);
+}
+/**
+ * Prompt to continue after partial failure
+ */
+export async function promptContinueAfterError(stage, error) {
+    console.log(`\n⚠️  ${stage} encountered an error: ${error}\n`);
+    return confirm({
+        message: 'Would you like to continue with partial results?',
+        default: true,
+    });
+}
+/**
+ * Select domains to generate
+ */
+export async function selectDomains(availableDomains) {
+    // Use a simple confirm + input approach since inquirer checkbox is complex
+    const selectAll = await confirm({
+        message: `Found ${availableDomains.length} domains. Generate specs for all?`,
+        default: true,
+    });
+    if (selectAll) {
+        return availableDomains;
+    }
+    const selected = await input({
+        message: `Enter domains to include (comma-separated):\nAvailable: ${availableDomains.join(', ')}\n`,
+        validate: (value) => {
+            if (!value.trim()) {
+                return 'Please enter at least one domain';
+            }
+            const domains = value.split(',').map((d) => d.trim());
+            const invalid = domains.filter((d) => !availableDomains.includes(d));
+            if (invalid.length > 0) {
+                return `Unknown domains: ${invalid.join(', ')}`;
+            }
+            return true;
+        },
+    });
+    return selected.split(',').map((d) => d.trim());
+}
+/**
+ * Interactive mode flag - can be disabled for CI/non-interactive environments
+ */
+let interactiveMode = process.stdin.isTTY ?? false;
+/**
+ * Check if we're in interactive mode
+ */
+export function isInteractive() {
+    return interactiveMode;
+}
+/**
+ * Enable/disable interactive mode
+ */
+export function setInteractiveMode(enabled) {
+    interactiveMode = enabled;
+}
+//# sourceMappingURL=prompts.js.map

package/dist/utils/prompts.js.map

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

package/dist/utils/shutdown.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Graceful shutdown handling for spec-gen CLI
+ */
+export interface ShutdownState {
+    /** Current phase when interrupted */
+    phase: 'init' | 'analyze' | 'generate' | 'verify';
+    /** Files that were being processed */
+    currentFiles?: string[];
+    /** Partial results that were saved */
+    savedResults?: string;
+    /** Timestamp of interruption */
+    timestamp: number;
+}
+type CleanupCallback = () => void | Promise<void>;
+/**
+ * Manages graceful shutdown with cleanup callbacks
+ */
+export declare class ShutdownManager {
+    private callbacks;
+    private isShuttingDown;
+    private state;
+    private stateFile;
+    private handlers;
+    private handlersAttached;
+    constructor(projectPath?: string, options?: {
+        skipHandlers?: boolean;
+    });
+    private setupHandlers;
+    /**
+     * Remove all registered signal handlers (for testing)
+     */
+    removeHandlers(): void;
+    private handleShutdown;
+    /**
+     * Register a cleanup callback to run on shutdown
+     */
+    onCleanup(callback: CleanupCallback): void;
+    /**
+     * Remove a cleanup callback
+     */
+    removeCleanup(callback: CleanupCallback): void;
+    /**
+     * Set the current state for potential resume
+     */
+    setState(state: Partial<ShutdownState>): void;
+    /**
+     * Clear state (call on successful completion)
+     */
+    clearState(): void;
+    /**
+     * Save state to file for potential resume
+     */
+    private saveState;
+    /**
+     * Load previous shutdown state
+     */
+    loadState(): ShutdownState | null;
+    /**
+     * Check if there's a previous interrupted session
+     */
+    hasPreviousState(): boolean;
+    private showResumeSuggestion;
+    /**
+     * Check if shutdown is in progress
+     */
+    isInProgress(): boolean;
+}
+/**
+ * Get or create the global shutdown manager
+ */
+export declare function getShutdownManager(projectPath?: string): ShutdownManager;
+/**
+ * Register a cleanup callback with the global manager
+ */
+export declare function onShutdown(callback: CleanupCallback): void;
+/**
+ * Set current state for potential resume
+ */
+export declare function setShutdownState(state: Partial<ShutdownState>): void;
+/**
+ * Clear shutdown state (call on successful completion)
+ */
+export declare function clearShutdownState(): void;
+/**
+ * Create a scope that sets/clears state automatically
+ */
+export declare function withShutdownState<T>(state: Partial<ShutdownState>, fn: () => Promise<T>): Promise<T>;
+export {};
+//# sourceMappingURL=shutdown.d.ts.map

package/dist/utils/shutdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown.d.ts","sourceRoot":"","sources":["../../src/utils/shutdown.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,WAAW,aAAa;IAC5B,qCAAqC;IACrC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;IAClD,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,KAAK,eAAe,GAAG,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAElD;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAwD;IACxE,OAAO,CAAC,gBAAgB,CAAS;gBAErB,WAAW,GAAE,MAAsB,EAAE,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE;IAQrF,OAAO,CAAC,aAAa;IAkCrB;;OAEG;IACH,cAAc,IAAI,IAAI;YAQR,cAAc;IA6B5B;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAI1C;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAO9C;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI;IAS7C;;OAEG;IACH,UAAU,IAAI,IAAI;IAYlB;;OAEG;YACW,SAAS;IAevB;;OAEG;IACH,SAAS,IAAI,aAAa,GAAG,IAAI;IAYjC;;OAEG;IACH,gBAAgB,IAAI,OAAO;IAI3B,OAAO,CAAC,oBAAoB;IA6B5B;;OAEG;IACH,YAAY,IAAI,OAAO;CAGxB;AAKD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,eAAe,CAKxE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAE1D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI,CAEpE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EACvC,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,EAC7B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAOZ"}

package/dist/utils/shutdown.js

@@ -0,0 +1,237 @@
+/**
+ * Graceful shutdown handling for spec-gen CLI
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * Manages graceful shutdown with cleanup callbacks
+ */
+export class ShutdownManager {
+    callbacks = [];
+    isShuttingDown = false;
+    state = null;
+    stateFile;
+    handlers = new Map();
+    handlersAttached = false;
+    constructor(projectPath = process.cwd(), options) {
+        this.stateFile = path.join(projectPath, '.spec-gen', 'shutdown-state.json');
+        // Skip handlers in test environment or when explicitly disabled
+        if (!options?.skipHandlers && process.env.NODE_ENV !== 'test') {
+            this.setupHandlers();
+        }
+    }
+    setupHandlers() {
+        if (this.handlersAttached)
+            return;
+        this.handlersAttached = true;
+        const sigintHandler = () => this.handleShutdown('SIGINT');
+        const sigtermHandler = () => this.handleShutdown('SIGTERM');
+        const exceptionHandler = (error) => {
+            console.error('\n❌ Uncaught exception:', error.message);
+            this.handleShutdown('uncaughtException');
+        };
+        const rejectionHandler = (reason) => {
+            console.error('\n❌ Unhandled rejection:', reason);
+            this.handleShutdown('unhandledRejection');
+        };
+        // Store handlers for potential cleanup
+        this.handlers.set('SIGINT', sigintHandler);
+        this.handlers.set('SIGTERM', sigtermHandler);
+        this.handlers.set('uncaughtException', exceptionHandler);
+        this.handlers.set('unhandledRejection', rejectionHandler);
+        // Handle Ctrl+C
+        process.on('SIGINT', sigintHandler);
+        // Handle termination signal
+        process.on('SIGTERM', sigtermHandler);
+        // Handle uncaught exceptions
+        process.on('uncaughtException', exceptionHandler);
+        // Handle unhandled promise rejections
+        process.on('unhandledRejection', rejectionHandler);
+    }
+    /**
+     * Remove all registered signal handlers (for testing)
+     */
+    removeHandlers() {
+        for (const [event, handler] of this.handlers) {
+            process.removeListener(event, handler);
+        }
+        this.handlers.clear();
+        this.handlersAttached = false;
+    }
+    async handleShutdown(signal) {
+        if (this.isShuttingDown) {
+            console.log('\n⚠️  Force quitting...');
+            process.exit(1);
+        }
+        this.isShuttingDown = true;
+        console.log('\n\n🛑 Interrupted! Cleaning up...');
+        // Save state if we have one
+        if (this.state) {
+            await this.saveState();
+        }
+        // Run cleanup callbacks in reverse order
+        for (const callback of this.callbacks.reverse()) {
+            try {
+                await callback();
+            }
+            catch (error) {
+                console.error('Cleanup error:', error);
+            }
+        }
+        // Show resume suggestion
+        this.showResumeSuggestion();
+        process.exit(signal === 'SIGINT' ? 130 : 1);
+    }
+    /**
+     * Register a cleanup callback to run on shutdown
+     */
+    onCleanup(callback) {
+        this.callbacks.push(callback);
+    }
+    /**
+     * Remove a cleanup callback
+     */
+    removeCleanup(callback) {
+        const index = this.callbacks.indexOf(callback);
+        if (index !== -1) {
+            this.callbacks.splice(index, 1);
+        }
+    }
+    /**
+     * Set the current state for potential resume
+     */
+    setState(state) {
+        this.state = {
+            phase: state.phase ?? 'init',
+            currentFiles: state.currentFiles,
+            savedResults: state.savedResults,
+            timestamp: Date.now(),
+        };
+    }
+    /**
+     * Clear state (call on successful completion)
+     */
+    clearState() {
+        this.state = null;
+        // Remove state file if it exists
+        try {
+            if (fs.existsSync(this.stateFile)) {
+                fs.unlinkSync(this.stateFile);
+            }
+        }
+        catch {
+            // Ignore errors
+        }
+    }
+    /**
+     * Save state to file for potential resume
+     */
+    async saveState() {
+        if (!this.state)
+            return;
+        try {
+            const dir = path.dirname(this.stateFile);
+            if (!fs.existsSync(dir)) {
+                fs.mkdirSync(dir, { recursive: true });
+            }
+            fs.writeFileSync(this.stateFile, JSON.stringify(this.state, null, 2));
+            console.log(`📝 State saved to ${this.stateFile}`);
+        }
+        catch (error) {
+            console.error('Failed to save state:', error);
+        }
+    }
+    /**
+     * Load previous shutdown state
+     */
+    loadState() {
+        try {
+            if (fs.existsSync(this.stateFile)) {
+                const content = fs.readFileSync(this.stateFile, 'utf-8');
+                return JSON.parse(content);
+            }
+        }
+        catch {
+            // Ignore errors
+        }
+        return null;
+    }
+    /**
+     * Check if there's a previous interrupted session
+     */
+    hasPreviousState() {
+        return this.loadState() !== null;
+    }
+    showResumeSuggestion() {
+        if (!this.state)
+            return;
+        console.log('\n📋 To resume from where you left off:');
+        switch (this.state.phase) {
+            case 'init':
+                console.log('   Run: spec-gen init');
+                break;
+            case 'analyze':
+                console.log('   Run: spec-gen analyze');
+                if (this.state.savedResults) {
+                    console.log(`   Partial analysis saved to: ${this.state.savedResults}`);
+                }
+                break;
+            case 'generate':
+                console.log('   Run: spec-gen generate');
+                if (this.state.savedResults) {
+                    console.log(`   Partial specs saved to: ${this.state.savedResults}`);
+                }
+                break;
+            case 'verify':
+                console.log('   Run: spec-gen verify');
+                break;
+        }
+        console.log('');
+    }
+    /**
+     * Check if shutdown is in progress
+     */
+    isInProgress() {
+        return this.isShuttingDown;
+    }
+}
+// Global shutdown manager instance
+let globalManager = null;
+/**
+ * Get or create the global shutdown manager
+ */
+export function getShutdownManager(projectPath) {
+    if (!globalManager) {
+        globalManager = new ShutdownManager(projectPath);
+    }
+    return globalManager;
+}
+/**
+ * Register a cleanup callback with the global manager
+ */
+export function onShutdown(callback) {
+    getShutdownManager().onCleanup(callback);
+}
+/**
+ * Set current state for potential resume
+ */
+export function setShutdownState(state) {
+    getShutdownManager().setState(state);
+}
+/**
+ * Clear shutdown state (call on successful completion)
+ */
+export function clearShutdownState() {
+    getShutdownManager().clearState();
+}
+/**
+ * Create a scope that sets/clears state automatically
+ */
+export async function withShutdownState(state, fn) {
+    const manager = getShutdownManager();
+    manager.setState(state);
+    const result = await fn();
+    manager.clearState();
+    return result;
+}
+//# sourceMappingURL=shutdown.js.map

package/dist/utils/shutdown.js.map

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

package/package.json

@@ -0,0 +1,114 @@
+{
+  "name": "spec-gen-cli",
+  "version": "1.0.0",
+  "description": "Reverse-engineer OpenSpec specifications from existing codebases",
+  "type": "module",
+  "main": "dist/api/index.js",
+  "types": "dist/api/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/api/index.js",
+      "types": "./dist/api/index.d.ts"
+    },
+    "./cli": {
+      "import": "./dist/cli/index.js"
+    }
+  },
+  "bin": {
+    "spec-gen": "dist/cli/index.js"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "dev": "tsx watch src/cli/index.ts",
+    "build": "tsc",
+    "start": "node dist/cli/index.js",
+    "view": "tsx src/cli/index.ts view",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:openspec-compat": "vitest run --grep 'openspec' || echo 'No OpenSpec compat tests yet'",
+    "test:e2e": "vitest run --grep 'e2e' || echo 'No E2E tests yet'",
+    "test:integration": "vitest run --config vitest.integration.config.ts",
+    "lint": "eslint src",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build && npm run test:run"
+  },
+  "keywords": [
+    "openspec",
+    "spec-driven",
+    "code-analysis",
+    "documentation",
+    "reverse-engineering",
+    "specification",
+    "cli"
+  ],
+  "author": "Clay Good",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/clay-good/spec-gen"
+  },
+  "bugs": {
+    "url": "https://github.com/clay-good/spec-gen/issues"
+  },
+  "homepage": "https://github.com/clay-good/spec-gen#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.test.*",
+    "src/viewer",
+    "README.md",
+    "LICENSE"
+  ],
+  "peerDependencies": {
+    "@fission-ai/openspec": ">=0.1.0"
+  },
+  "peerDependenciesMeta": {
+    "@fission-ai/openspec": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^7.2.1",
+    "@lancedb/lancedb": "^0.26.2",
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "apache-arrow": "^21.1.0",
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "glob": "^11.0.0",
+    "ignore": "^6.0.2",
+    "ora": "^8.1.1",
+    "react": "^19.1.1",
+    "react-dom": "^19.1.1",
+    "react-force-graph-2d": "^1.27.0",
+    "tree-sitter": "^0.22.4",
+    "tree-sitter-go": "^0.23.4",
+    "tree-sitter-java": "^0.23.5",
+    "tree-sitter-python": "^0.23.6",
+    "tree-sitter-ruby": "^0.23.1",
+    "tree-sitter-rust": "^0.24.0",
+    "tree-sitter-typescript": "^0.23.2",
+    "vite": "^7.1.3",
+    "yaml": "^2.6.1"
+  },
+  "optionalDependencies": {
+    "@lancedb/lancedb-darwin-x64": "^0.22.3",
+    "@lancedb/lancedb-linux-x64-gnu": "^0.22.3"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.17.0",
+    "@types/node": "^22.10.5",
+    "@vitejs/plugin-react": "^5.0.2",
+    "@vitest/coverage-v8": "^4.0.18",
+    "eslint": "^9.17.0",
+    "memfs": "^4.15.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2",
+    "typescript-eslint": "^8.19.1",
+    "vitest": "^4.0.18"
+  }
+}