spec-gen-cli 1.0.0

package/dist/utils/errors.js

@@ -0,0 +1,128 @@
+/**
+ * Custom error classes for spec-gen with helpful user-facing messages
+ */
+/**
+ * Base error class for spec-gen with code and suggestion
+ */
+export class SpecGenError extends Error {
+    code;
+    suggestion;
+    constructor(message, code, suggestion) {
+        super(message);
+        this.code = code;
+        this.suggestion = suggestion;
+        this.name = 'SpecGenError';
+        // Maintains proper stack trace for where error was thrown
+        Error.captureStackTrace?.(this, this.constructor);
+    }
+    /**
+     * Format error for CLI display with color support
+     */
+    format(useColor = true) {
+        const red = useColor ? '\x1b[31m' : '';
+        const yellow = useColor ? '\x1b[33m' : '';
+        const reset = useColor ? '\x1b[0m' : '';
+        const dim = useColor ? '\x1b[2m' : '';
+        let output = `${red}Error [${this.code}]:${reset} ${this.message}`;
+        if (this.suggestion) {
+            output += `\n\n${yellow}Suggestion:${reset} ${this.suggestion}`;
+        }
+        output += `\n\n${dim}For more help, see: https://github.com/clay-good/spec-gen#readme${reset}`;
+        return output;
+    }
+}
+/**
+ * Error factory functions with predefined messages and suggestions
+ */
+export const errors = {
+    noApiKey() {
+        return new SpecGenError('No API key found for LLM provider', 'NO_API_KEY', `Set ANTHROPIC_API_KEY or OPENAI_API_KEY environment variable.
+Get an API key at https://console.anthropic.com/ or https://platform.openai.com/`);
+    },
+    notARepository() {
+        return new SpecGenError('No .git directory found', 'NOT_A_REPOSITORY', `spec-gen works best in git repositories.
+Run 'git init' or use --force to continue anyway.`);
+    },
+    openspecExists(path) {
+        return new SpecGenError(`openspec/specs/ already contains specifications at ${path}`, 'OPENSPEC_EXISTS', `Use --merge to add to existing specs, or --force to overwrite.
+Existing specs will be backed up to .spec-gen/backups/`);
+    },
+    analysisTooOld(ageHours) {
+        return new SpecGenError(`Existing analysis is ${ageHours.toFixed(1)} hours old`, 'ANALYSIS_TOO_OLD', `Run 'spec-gen analyze' to refresh, or use --reanalyze flag.`);
+    },
+    noHighValueFiles() {
+        return new SpecGenError('Could not identify any high-value files to analyze', 'NO_HIGH_VALUE_FILES', `This might happen with unusual project structures.
+Try adjusting scoring in .spec-gen/config.json or use --include patterns.`);
+    },
+    llmRateLimit(attempt, maxAttempts) {
+        return new SpecGenError('API rate limit exceeded', 'LLM_RATE_LIMIT', `Waiting and retrying... (attempt ${attempt} of ${maxAttempts})
+If this persists, try a different model or wait a few minutes.`);
+    },
+    openspecValidationFailed(details) {
+        return new SpecGenError(`Generated specs failed OpenSpec validation${details ? `: ${details}` : ''}`, 'OPENSPEC_VALIDATION_FAILED', `Check .spec-gen/logs/ for details.
+This may indicate a generation bug - please report it at https://github.com/clay-good/spec-gen/issues`);
+    },
+    analysisFailed(reason) {
+        return new SpecGenError(`Static analysis failed: ${reason}`, 'ANALYSIS_FAILED', `Check that the project directory is accessible and contains source files.
+Try running with --verbose for more details.`);
+    },
+    generationFailed(reason) {
+        return new SpecGenError(`Spec generation failed: ${reason}`, 'GENERATION_FAILED', `This could be due to API issues or invalid analysis data.
+Try running 'spec-gen analyze' first, then 'spec-gen generate'.`);
+    },
+    verificationFailed(reason) {
+        return new SpecGenError(`Verification failed: ${reason}`, 'VERIFICATION_FAILED', `Ensure specs exist in openspec/specs/ directory.
+Run 'spec-gen generate' first if you haven't already.`);
+    },
+    configNotFound(path) {
+        return new SpecGenError(`Configuration file not found at ${path}`, 'CONFIG_NOT_FOUND', `Run 'spec-gen init' to create a configuration file.`);
+    },
+    invalidConfig(path, details) {
+        return new SpecGenError(`Invalid configuration file at ${path}${details ? `: ${details}` : ''}`, 'INVALID_CONFIG', `Check the configuration file format. You may need to delete it and run 'spec-gen init' again.`);
+    },
+    fileWriteError(path, reason) {
+        return new SpecGenError(`Failed to write file ${path}${reason ? `: ${reason}` : ''}`, 'FILE_WRITE_ERROR', `Check that you have write permissions for the directory.`);
+    },
+    fileReadError(path, reason) {
+        return new SpecGenError(`Failed to read file ${path}${reason ? `: ${reason}` : ''}`, 'FILE_READ_ERROR', `Check that the file exists and you have read permissions.`);
+    },
+    driftDetected(issueCount) {
+        return new SpecGenError(`Spec drift detected: ${issueCount} issue${issueCount === 1 ? '' : 's'} found`, 'DRIFT_DETECTED', `Run 'spec-gen drift' to see details, then update specs to match code changes.
+Use 'spec-gen drift --verbose' for detailed issue descriptions.`);
+    },
+    noSpecsFound() {
+        return new SpecGenError('No OpenSpec specifications found', 'NO_SPECS_FOUND', `Run 'spec-gen generate' to create specifications from your codebase.`);
+    },
+    unknown(error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return new SpecGenError(`An unexpected error occurred: ${message}`, 'UNKNOWN_ERROR', `Please report this issue at https://github.com/clay-good/spec-gen/issues`);
+    },
+};
+/**
+ * Type guard to check if an error is a SpecGenError
+ */
+export function isSpecGenError(error) {
+    return error instanceof SpecGenError;
+}
+/**
+ * Format any error for CLI display
+ */
+export function formatError(error, useColor = true) {
+    if (isSpecGenError(error)) {
+        return error.format(useColor);
+    }
+    if (error instanceof Error) {
+        return errors.unknown(error).format(useColor);
+    }
+    return errors.unknown(String(error)).format(useColor);
+}
+/**
+ * Handle errors in CLI commands by formatting and logging them
+ */
+export function handleError(error, exit = true) {
+    console.error(formatError(error, process.stdout.isTTY));
+    if (exit) {
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

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

package/dist/utils/logger.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Standardized logging interface for spec-gen
+ *
+ * Provides semantic log levels with specific visual treatments:
+ * - DISCOVERY: Finding files, detecting patterns, scanning directories
+ * - ANALYSIS: Parsing AST, building graphs, scoring significance
+ * - INFERENCE: LLM generating content, making decisions
+ * - SUCCESS: Tasks complete successfully
+ * - WARNING: Non-fatal issues, skipped files, fallback behavior
+ * - ERROR: Fatal errors, missing requirements
+ */
+import { type Ora } from 'ora';
+export type LogLevel = 'discovery' | 'analysis' | 'inference' | 'success' | 'warning' | 'error' | 'debug';
+export interface LoggerOptions {
+    quiet: boolean;
+    verbose: boolean;
+    noColor: boolean;
+    timestamps: boolean;
+}
+/**
+ * Logger class providing semantic log levels and spinner support
+ */
+export declare class Logger {
+    private options;
+    private activeSpinner;
+    constructor(options?: Partial<LoggerOptions>);
+    /**
+     * Update logger options
+     */
+    configure(options: Partial<LoggerOptions>): void;
+    /**
+     * Get current options
+     */
+    getOptions(): LoggerOptions;
+    /**
+     * Format a message with optional timestamp
+     */
+    private formatMessage;
+    /**
+     * Core log method
+     */
+    private log;
+    /**
+     * DISCOVERY - Finding files, detecting patterns, scanning directories
+     * @example logger.discovery("Discovered 847 files across 23 directories")
+     */
+    discovery(message: string): void;
+    /**
+     * ANALYSIS - Parsing AST, building graphs, scoring significance
+     * @example logger.analysis("Analyzing dependency graph...")
+     */
+    analysis(message: string): void;
+    /**
+     * INFERENCE - LLM is generating content, making decisions
+     * @example logger.inference("Inferring system intent from core modules...")
+     */
+    inference(message: string): void;
+    /**
+     * SUCCESS - Tasks complete successfully
+     * @example logger.success("Generated openspec/specs/auth/spec.md")
+     */
+    success(message: string): void;
+    /**
+     * WARNING - Non-fatal issues, skipped files, fallback behavior
+     * @example logger.warning("Skipped 12 binary files")
+     */
+    warning(message: string): void;
+    /**
+     * ERROR - Fatal errors, missing requirements
+     * @example logger.error("No .git directory found. Is this a repository?")
+     */
+    error(message: string): void;
+    /**
+     * DEBUG - Verbose debug information (only shown with --verbose)
+     * @example logger.debug("Processing file: src/utils/helper.ts")
+     */
+    debug(message: string): void;
+    /**
+     * Start a spinner for long-running operations
+     * @returns Spinner control object with succeed/fail/stop methods
+     */
+    spinner(message: string): SpinnerController;
+    /**
+     * Register an external spinner so log calls pause/resume it correctly
+     */
+    setActiveSpinner(spinner: Ora | null): void;
+    /**
+     * Clear the active spinner reference
+     */
+    clearSpinner(): void;
+    /**
+     * Print a blank line (respects quiet mode)
+     */
+    blank(): void;
+    /**
+     * Print a section header
+     */
+    section(title: string): void;
+    /**
+     * Print a key-value pair for summaries
+     */
+    info(key: string, value: string | number): void;
+    /**
+     * Print a list item
+     */
+    listItem(item: string, indent?: number): void;
+}
+/**
+ * Controller for spinner operations
+ */
+export declare class SpinnerController {
+    private spinner;
+    private logger;
+    constructor(spinner: Ora | null, logger: Logger);
+    /**
+     * Update spinner text
+     */
+    update(message: string): void;
+    /**
+     * Mark spinner as succeeded
+     */
+    succeed(message?: string): void;
+    /**
+     * Mark spinner as failed
+     */
+    fail(message?: string): void;
+    /**
+     * Mark spinner as warning
+     */
+    warn(message?: string): void;
+    /**
+     * Stop spinner without status
+     */
+    stop(): void;
+    /**
+     * Stop spinner and show info
+     */
+    info(message?: string): void;
+}
+/**
+ * Singleton logger instance for use across the application
+ */
+export declare const logger: Logger;
+/**
+ * Configure the global logger instance
+ */
+export declare function configureLogger(options: Partial<LoggerOptions>): void;
+export default logger;
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAY,EAAE,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,MAAM,QAAQ,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAE1G,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;CACrB;AAmCD;;GAEG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,aAAa,CAAoB;gBAE7B,OAAO,GAAE,OAAO,CAAC,aAAa,CAAM;IAIhD;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI;IAIhD;;OAEG;IACH,UAAU,IAAI,aAAa;IAI3B;;OAEG;IACH,OAAO,CAAC,aAAa;IAcrB;;OAEG;IACH,OAAO,CAAC,GAAG;IA8BX;;;OAGG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIhC;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI/B;;;OAGG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIhC;;;OAGG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI9B;;;OAGG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI9B;;;OAGG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI5B;;;OAGG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI5B;;;OAGG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB;IA6B3C;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI,GAAG,IAAI;IAI3C;;OAEG;IACH,YAAY,IAAI,IAAI;IAIpB;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAY5B;;OAEG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAU/C;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,MAAU,GAAG,IAAI;CAUjD;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,EAAE,GAAG,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM;IAK/C;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAM7B;;OAEG;IACH,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAS/B;;OAEG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAS5B;;OAEG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAS5B;;OAEG;IACH,IAAI,IAAI,IAAI;IAOZ;;OAEG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;CAM7B;AAED;;GAEG;AACH,eAAO,MAAM,MAAM,QAAe,CAAC;AAEnC;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI,CAErE;AAED,eAAe,MAAM,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,331 @@
+/**
+ * Standardized logging interface for spec-gen
+ *
+ * Provides semantic log levels with specific visual treatments:
+ * - DISCOVERY: Finding files, detecting patterns, scanning directories
+ * - ANALYSIS: Parsing AST, building graphs, scoring significance
+ * - INFERENCE: LLM generating content, making decisions
+ * - SUCCESS: Tasks complete successfully
+ * - WARNING: Non-fatal issues, skipped files, fallback behavior
+ * - ERROR: Fatal errors, missing requirements
+ */
+import chalk from 'chalk';
+import ora from 'ora';
+const defaultOptions = {
+    quiet: false,
+    verbose: false,
+    noColor: false,
+    timestamps: false,
+};
+/**
+ * Semantic prefixes for each log level
+ */
+const PREFIXES = {
+    discovery: '🔍',
+    analysis: '🔬',
+    inference: '🧠',
+    success: '✓',
+    warning: '⚠',
+    error: '✗',
+    debug: '→',
+};
+/**
+ * Color functions for each log level
+ */
+const COLORS = {
+    discovery: chalk.cyan,
+    analysis: chalk.yellow,
+    inference: chalk.magenta,
+    success: chalk.green,
+    warning: chalk.hex('#FFA500'), // Orange
+    error: chalk.red,
+    debug: chalk.gray,
+};
+/**
+ * Logger class providing semantic log levels and spinner support
+ */
+export class Logger {
+    options;
+    activeSpinner = null;
+    constructor(options = {}) {
+        this.options = { ...defaultOptions, ...options };
+    }
+    /**
+     * Update logger options
+     */
+    configure(options) {
+        this.options = { ...this.options, ...options };
+    }
+    /**
+     * Get current options
+     */
+    getOptions() {
+        return { ...this.options };
+    }
+    /**
+     * Format a message with optional timestamp
+     */
+    formatMessage(level, message) {
+        const prefix = PREFIXES[level];
+        const colorFn = this.options.noColor ? (s) => s : COLORS[level];
+        let formattedMessage = `${prefix} ${message}`;
+        if (this.options.timestamps) {
+            const timestamp = new Date().toISOString();
+            formattedMessage = `[${timestamp}] ${formattedMessage}`;
+        }
+        return colorFn(formattedMessage);
+    }
+    /**
+     * Core log method
+     */
+    log(level, message) {
+        // In quiet mode, only show errors
+        if (this.options.quiet && level !== 'error') {
+            return;
+        }
+        // Debug messages only show in verbose mode
+        if (level === 'debug' && !this.options.verbose) {
+            return;
+        }
+        // Pause spinner if active to prevent overlap
+        if (this.activeSpinner) {
+            this.activeSpinner.stop();
+        }
+        const formattedMessage = this.formatMessage(level, message);
+        if (level === 'error') {
+            console.error(formattedMessage);
+        }
+        else {
+            console.log(formattedMessage);
+        }
+        // Resume spinner if it was active
+        if (this.activeSpinner) {
+            this.activeSpinner.start();
+        }
+    }
+    /**
+     * DISCOVERY - Finding files, detecting patterns, scanning directories
+     * @example logger.discovery("Discovered 847 files across 23 directories")
+     */
+    discovery(message) {
+        this.log('discovery', message);
+    }
+    /**
+     * ANALYSIS - Parsing AST, building graphs, scoring significance
+     * @example logger.analysis("Analyzing dependency graph...")
+     */
+    analysis(message) {
+        this.log('analysis', message);
+    }
+    /**
+     * INFERENCE - LLM is generating content, making decisions
+     * @example logger.inference("Inferring system intent from core modules...")
+     */
+    inference(message) {
+        this.log('inference', message);
+    }
+    /**
+     * SUCCESS - Tasks complete successfully
+     * @example logger.success("Generated openspec/specs/auth/spec.md")
+     */
+    success(message) {
+        this.log('success', message);
+    }
+    /**
+     * WARNING - Non-fatal issues, skipped files, fallback behavior
+     * @example logger.warning("Skipped 12 binary files")
+     */
+    warning(message) {
+        this.log('warning', message);
+    }
+    /**
+     * ERROR - Fatal errors, missing requirements
+     * @example logger.error("No .git directory found. Is this a repository?")
+     */
+    error(message) {
+        this.log('error', message);
+    }
+    /**
+     * DEBUG - Verbose debug information (only shown with --verbose)
+     * @example logger.debug("Processing file: src/utils/helper.ts")
+     */
+    debug(message) {
+        this.log('debug', message);
+    }
+    /**
+     * Start a spinner for long-running operations
+     * @returns Spinner control object with succeed/fail/stop methods
+     */
+    spinner(message) {
+        // Don't show spinners in quiet mode or CI (timestamps mode)
+        if (this.options.quiet || this.options.timestamps) {
+            // Return a no-op controller
+            return new SpinnerController(null, this);
+        }
+        // Stop any existing spinner
+        if (this.activeSpinner) {
+            this.activeSpinner.stop();
+        }
+        const spinner = ora({
+            text: message,
+            color: 'cyan',
+            spinner: 'dots',
+        });
+        if (!this.options.noColor) {
+            spinner.start();
+        }
+        else {
+            // In no-color mode, just print the message
+            console.log(`... ${message}`);
+        }
+        this.activeSpinner = spinner;
+        return new SpinnerController(spinner, this);
+    }
+    /**
+     * Register an external spinner so log calls pause/resume it correctly
+     */
+    setActiveSpinner(spinner) {
+        this.activeSpinner = spinner;
+    }
+    /**
+     * Clear the active spinner reference
+     */
+    clearSpinner() {
+        this.activeSpinner = null;
+    }
+    /**
+     * Print a blank line (respects quiet mode)
+     */
+    blank() {
+        if (!this.options.quiet) {
+            console.log();
+        }
+    }
+    /**
+     * Print a section header
+     */
+    section(title) {
+        if (this.options.quiet)
+            return;
+        this.blank();
+        if (this.options.noColor) {
+            console.log(`=== ${title} ===`);
+        }
+        else {
+            console.log(chalk.bold.underline(title));
+        }
+        this.blank();
+    }
+    /**
+     * Print a key-value pair for summaries
+     */
+    info(key, value) {
+        if (this.options.quiet)
+            return;
+        if (this.options.noColor) {
+            console.log(`  ${key}: ${value}`);
+        }
+        else {
+            console.log(`  ${chalk.dim(key + ':')} ${value}`);
+        }
+    }
+    /**
+     * Print a list item
+     */
+    listItem(item, indent = 0) {
+        if (this.options.quiet)
+            return;
+        const prefix = '  '.repeat(indent) + '•';
+        if (this.options.noColor) {
+            console.log(`${prefix} ${item}`);
+        }
+        else {
+            console.log(`${chalk.dim(prefix)} ${item}`);
+        }
+    }
+}
+/**
+ * Controller for spinner operations
+ */
+export class SpinnerController {
+    spinner;
+    logger;
+    constructor(spinner, logger) {
+        this.spinner = spinner;
+        this.logger = logger;
+    }
+    /**
+     * Update spinner text
+     */
+    update(message) {
+        if (this.spinner) {
+            this.spinner.text = message;
+        }
+    }
+    /**
+     * Mark spinner as succeeded
+     */
+    succeed(message) {
+        if (this.spinner) {
+            this.spinner.succeed(message);
+        }
+        else if (message) {
+            this.logger.success(message);
+        }
+        this.logger.clearSpinner();
+    }
+    /**
+     * Mark spinner as failed
+     */
+    fail(message) {
+        if (this.spinner) {
+            this.spinner.fail(message);
+        }
+        else if (message) {
+            this.logger.error(message);
+        }
+        this.logger.clearSpinner();
+    }
+    /**
+     * Mark spinner as warning
+     */
+    warn(message) {
+        if (this.spinner) {
+            this.spinner.warn(message);
+        }
+        else if (message) {
+            this.logger.warning(message);
+        }
+        this.logger.clearSpinner();
+    }
+    /**
+     * Stop spinner without status
+     */
+    stop() {
+        if (this.spinner) {
+            this.spinner.stop();
+        }
+        this.logger.clearSpinner();
+    }
+    /**
+     * Stop spinner and show info
+     */
+    info(message) {
+        if (this.spinner) {
+            this.spinner.info(message);
+        }
+        this.logger.clearSpinner();
+    }
+}
+/**
+ * Singleton logger instance for use across the application
+ */
+export const logger = new Logger();
+/**
+ * Configure the global logger instance
+ */
+export function configureLogger(options) {
+    logger.configure(options);
+}
+export default logger;
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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