codehere 1.0.1 → 1.0.3

package/dist/presentation/cli/error-display.js

@@ -1,328 +0,0 @@
-/**
- * Centralized Error Display Utility
- * Provides consistent, helpful error messages with recovery suggestions
- *
- * Clean Architecture: Presentation Layer
- */
-import { ErrorType, classifyError, EnterpriseError } from '../../error-handler.js';
-import { colors, separator, newline, symbols } from '../../ui.js';
-/**
- * Determine error severity based on error type
- */
-function getErrorSeverity(errorType) {
-    switch (errorType) {
-        case ErrorType.FATAL:
-        case ErrorType.POLICY:
-            return 'critical';
-        case ErrorType.RATE_LIMIT:
-        case ErrorType.API_ERROR:
-        case ErrorType.VALIDATION:
-            return 'warning';
-        case ErrorType.NETWORK:
-        case ErrorType.RETRYABLE:
-            return 'info';
-        default:
-            return 'warning';
-    }
-}
-/**
- * Get severity label (text-based, enterprise-grade)
- */
-function getSeverityLabel(severity) {
-    switch (severity) {
-        case 'critical':
-            return colors.red('[CRITICAL] Error:');
-        case 'warning':
-            return colors.yellow('[WARNING] Error:');
-        case 'info':
-            return colors.cyan('[INFO] Error:');
-        default:
-            return colors.red('Error:');
-    }
-}
-/**
- * Extract file path from error message
- */
-function extractFilePath(errorMessage) {
-    // Patterns: "File not found: path/to/file", "in path/to/file", "at path/to/file"
-    const patterns = [
-        /(?:File|file)\s+(?:not found|error|issue)[:\s]+([^\s]+)/i,
-        /(?:in|at)\s+([^\s]+\.(ts|js|py|json|md|yaml|yml))/i,
-        /([^\s]+\.(ts|js|py|json|md|yaml|yml)(?::\d+)?)/i,
-    ];
-    for (const pattern of patterns) {
-        const match = errorMessage.match(pattern);
-        if (match && match[1]) {
-            return match[1].replace(/^["']|["']$/g, ''); // Remove quotes
-        }
-    }
-    return undefined;
-}
-/**
- * Extract line number from error message
- */
-function extractLineNumber(errorMessage) {
-    // Patterns: "line 42", ":42", "at line 42"
-    const patterns = [/(?:line|Line)\s+(\d+)/i, /:(\d+):/, /\((\d+)\)/];
-    for (const pattern of patterns) {
-        const match = errorMessage.match(pattern);
-        if (match && match[1]) {
-            const line = parseInt(match[1], 10);
-            if (!isNaN(line) && line > 0) {
-                return line;
-            }
-        }
-    }
-    return undefined;
-}
-/**
- * Get recovery commands based on error type and context
- */
-function getRecoveryCommands(errorType, errorMessage, context) {
-    const commands = [];
-    const lowerMessage = errorMessage.toLowerCase();
-    switch (errorType) {
-        case ErrorType.VALIDATION:
-            if (lowerMessage.includes('file') || lowerMessage.includes('not found')) {
-                if (context.filepath) {
-                    commands.push(`codehere trust ${context.filepath}`);
-                }
-            }
-            break;
-        case ErrorType.API_ERROR:
-            if (lowerMessage.includes('api') || lowerMessage.includes('key')) {
-                commands.push('codehere setup');
-                commands.push('codehere config --help');
-            }
-            break;
-        case ErrorType.POLICY:
-            if (context.filepath) {
-                commands.push(`codehere trust ${context.filepath}`);
-                commands.push('codehere config policies');
-            }
-            break;
-        case ErrorType.RATE_LIMIT:
-            commands.push('codehere config --help');
-            break;
-        default:
-            break;
-    }
-    return commands;
-}
-/**
- * Get help command for operation (Task 7.3: Contextual Help Integration)
- */
-function getHelpCommandForOperation(operation) {
-    const operationLower = operation.toLowerCase();
-    // Map operations to help commands
-    if (operationLower.includes('ask') || operationLower.includes('question')) {
-        return 'ask';
-    }
-    if (operationLower.includes('explain')) {
-        return 'explain';
-    }
-    if (operationLower.includes('plan')) {
-        return 'plan';
-    }
-    if (operationLower.includes('orchestrate')) {
-        return 'orchestrate';
-    }
-    if (operationLower.includes('react')) {
-        return 'react';
-    }
-    if (operationLower.includes('index')) {
-        return 'index';
-    }
-    if (operationLower.includes('setup') || operationLower.includes('config')) {
-        return 'setup';
-    }
-    if (operationLower.includes('undo')) {
-        return 'undo';
-    }
-    if (operationLower.includes('trace')) {
-        return 'trace';
-    }
-    return null;
-}
-/**
- * Get documentation link for error type
- */
-function getDocumentationLink(errorType) {
-    const baseUrl = 'https://docs.codehere.dev';
-    switch (errorType) {
-        case ErrorType.POLICY:
-            return `${baseUrl}/security-policies`;
-        case ErrorType.API_ERROR:
-        case ErrorType.RATE_LIMIT:
-            return `${baseUrl}/setup/api-keys`;
-        case ErrorType.VALIDATION:
-            return `${baseUrl}/troubleshooting`;
-        case ErrorType.NETWORK:
-            return `${baseUrl}/troubleshooting/network`;
-        default:
-            return undefined;
-    }
-}
-/**
- * Generate error code for troubleshooting
- */
-function generateErrorCode(errorType, errorMessage) {
-    const prefix = errorType.toUpperCase().substring(0, 3);
-    const hash = errorMessage.split('').reduce((acc, char) => {
-        return (acc << 5) - acc + char.charCodeAt(0);
-    }, 0);
-    const code = Math.abs(hash).toString(16).substring(0, 4).toUpperCase();
-    return `${prefix}-${code}`;
-}
-/**
- * Display error with helpful context and recovery suggestions
- */
-export function displayError(error, options = {}) {
-    const { operation = 'operation', query, showSuggestions = true, showStack = false } = options;
-    const errorType = classifyError(error);
-    const errorMessage = error instanceof Error ? error.message : String(error);
-    const isEnterpriseError = error instanceof EnterpriseError;
-    // Generate error code for troubleshooting
-    const errorCode = generateErrorCode(errorType, errorMessage);
-    // Determine error severity (based on error type)
-    const severity = getErrorSeverity(errorType);
-    // Extract file/line context from error message or options
-    const fileContext = options.filepath || extractFilePath(errorMessage);
-    const lineContext = options.lineNumber || extractLineNumber(errorMessage);
-    // Display error header
-    newline();
-    console.log(separator('═', 80));
-    // Show severity indicator (text-based, no emojis for enterprise)
-    const severityLabel = getSeverityLabel(severity);
-    if (severityLabel) {
-        console.log(severityLabel + ` ${errorMessage}`);
-    }
-    else {
-        console.log(colors.red(`Error: ${errorMessage}`));
-    }
-    if (errorCode) {
-        console.log(colors.dim(`Error Code: ${errorCode}`));
-    }
-    // Show file/line context if available
-    if (fileContext) {
-        console.log(colors.dim(`File: ${fileContext}${lineContext ? `:${lineContext}` : ''}`));
-    }
-    console.log(separator('═', 80));
-    newline();
-    // Show error type if it's an EnterpriseError
-    if (isEnterpriseError) {
-        console.log(colors.dim(`Type: ${errorType}`));
-        if (error.context?.attempt !== undefined) {
-            console.log(colors.dim(`Attempt: ${error.context.attempt + 1}/${error.context.maxRetries || '?'}`));
-        }
-        newline();
-    }
-    // Show suggestions based on error type
-    if (showSuggestions) {
-        const suggestions = getErrorSuggestions(errorType, errorMessage, { operation, query, filepath: fileContext });
-        if (suggestions.length > 0) {
-            console.log(colors.bold('Suggestions:'));
-            suggestions.forEach((suggestion) => {
-                console.log(colors.dim(`  ${symbols.bullet} ${suggestion}`));
-            });
-            newline();
-        }
-        // Show recovery commands for certain error types
-        const recoveryCommands = getRecoveryCommands(errorType, errorMessage, {
-            operation,
-            query,
-            filepath: fileContext,
-            lineNumber: lineContext,
-        });
-        if (recoveryCommands.length > 0) {
-            console.log(colors.bold('Recovery Commands:'));
-            recoveryCommands.forEach((cmd) => {
-                console.log(colors.cyan(`  $ ${cmd}`));
-            });
-            newline();
-        }
-        // Show documentation link for complex errors
-        const docLink = getDocumentationLink(errorType);
-        if (docLink) {
-            console.log(colors.dim(`Learn More: ${docLink}`));
-            newline();
-        }
-        // Contextual help suggestion (Task 7.3: Contextual Help Integration)
-        if (operation) {
-            const helpCommand = getHelpCommandForOperation(operation);
-            if (helpCommand) {
-                console.log(colors.dim(`Get help: ${colors.cyan(`codehere help ${helpCommand}`)}`));
-                newline();
-            }
-        }
-    }
-    // Show stack trace if requested (for debugging)
-    if (showStack && error instanceof Error && error.stack) {
-        console.log(colors.dim('Stack trace:'));
-        console.log(colors.dim(error.stack));
-        newline();
-    }
-}
-/**
- * Get recovery suggestions based on error type
- */
-function getErrorSuggestions(errorType, errorMessage, _context) {
-    const suggestions = [];
-    const lowerMessage = errorMessage.toLowerCase();
-    switch (errorType) {
-        case ErrorType.RATE_LIMIT:
-            suggestions.push("You've reached the API rate limit or monthly quota");
-            suggestions.push('Wait a moment and try again');
-            suggestions.push('Check your API key limits at: https://dashboard.cohere.com/api-keys');
-            suggestions.push('Consider upgrading your API key for higher limits');
-            break;
-        case ErrorType.API_ERROR:
-        case ErrorType.VALIDATION:
-            if (lowerMessage.includes('api') || lowerMessage.includes('key')) {
-                suggestions.push('Check your COHERE_API_KEY is set correctly');
-                suggestions.push('Verify your API key at: https://dashboard.cohere.com/api-keys');
-                suggestions.push('Make sure .env file exists in your project root');
-                suggestions.push('Run "codehere setup" to configure your API key');
-                suggestions.push('For troubleshooting, include the error code when reporting issues');
-            }
-            else if (lowerMessage.includes('not found') || lowerMessage.includes('missing')) {
-                suggestions.push("Make sure you're in the correct directory");
-                suggestions.push('Run "codehere trust ." to verify the path is scanned');
-            }
-            else {
-                suggestions.push('Check the error message above for specific details');
-                suggestions.push('Run "codehere setup" to verify your configuration');
-            }
-            break;
-        case ErrorType.NETWORK:
-            suggestions.push('Check your internet connection');
-            suggestions.push('Verify the API service is accessible');
-            suggestions.push('Try again in a few moments');
-            break;
-        case ErrorType.POLICY:
-            suggestions.push('The operation was blocked by safety policies');
-            suggestions.push('Review the policy reason above');
-            suggestions.push('Modify your request to comply with safety rules');
-            break;
-        case ErrorType.FATAL:
-            suggestions.push('This is a fatal error that cannot be recovered');
-            suggestions.push('Check the error message for details');
-            suggestions.push('If this persists, please report the issue');
-            break;
-        default:
-            // Generic suggestions for retryable errors
-            if (lowerMessage.includes('file') || lowerMessage.includes('path')) {
-                suggestions.push('Verify the file path is correct');
-                suggestions.push('Check file permissions');
-            }
-            else if (lowerMessage.includes('memory') || lowerMessage.includes('database')) {
-                suggestions.push('Run "codehere health" to inspect runtime state');
-            }
-            else {
-                suggestions.push('This error may be temporary - try again');
-                suggestions.push('Check the error message for specific details');
-            }
-    }
-    return suggestions;
-}
-//# sourceMappingURL=error-display.js.map