@vibecheckai/cli 3.5.0 → 3.5.2

package/bin/runners/lib/cli-errors.js

@@ -1,438 +0,0 @@
-/**
- * CLI Errors - Unified error handling and display for Vibecheck CLI
- * 
- * Provides:
- * - Beautiful error messages
- * - Error categories with icons
- * - Stack trace formatting
- * - Suggestions/fixes for common errors
- * - Debug mode output
- */
-
-"use strict";
-
-const {
-  ansi,
-  sym,
-  box,
-  padRight,
-  SUPPORTS_UNICODE,
-  formatDuration,
-} = require("./unified-cli-output");
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// ERROR CATEGORIES
-// ═══════════════════════════════════════════════════════════════════════════════
-
-const ERROR_TYPES = {
-  AUTH: {
-    code: 'AUTH',
-    icon: sym.lock,
-    color: ansi.yellow,
-    label: 'Authentication Error',
-  },
-  NETWORK: {
-    code: 'NETWORK',
-    icon: '🌐',
-    color: ansi.yellow,
-    label: 'Network Error',
-  },
-  CONFIG: {
-    code: 'CONFIG',
-    icon: sym.gear,
-    color: ansi.yellow,
-    label: 'Configuration Error',
-  },
-  PERMISSION: {
-    code: 'PERMISSION',
-    icon: sym.lock,
-    color: ansi.red,
-    label: 'Permission Error',
-  },
-  NOT_FOUND: {
-    code: 'NOT_FOUND',
-    icon: sym.search,
-    color: ansi.yellow,
-    label: 'Not Found',
-  },
-  VALIDATION: {
-    code: 'VALIDATION',
-    icon: sym.warning,
-    color: ansi.yellow,
-    label: 'Validation Error',
-  },
-  TIER: {
-    code: 'TIER',
-    icon: sym.star,
-    color: ansi.magenta,
-    label: 'Upgrade Required',
-  },
-  INTERNAL: {
-    code: 'INTERNAL',
-    icon: sym.cross,
-    color: ansi.red,
-    label: 'Internal Error',
-  },
-  TIMEOUT: {
-    code: 'TIMEOUT',
-    icon: sym.clock,
-    color: ansi.yellow,
-    label: 'Timeout Error',
-  },
-  SCAN: {
-    code: 'SCAN',
-    icon: sym.search,
-    color: ansi.red,
-    label: 'Scan Error',
-  },
-};
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// COMMON ERROR SUGGESTIONS
-// ═══════════════════════════════════════════════════════════════════════════════
-
-const ERROR_SUGGESTIONS = {
-  // Auth errors
-  'invalid api key': [
-    'Check that your API key is correct',
-    'Get a new key at: https://vibecheckai.dev/settings/keys',
-    'Run: vibecheck login',
-  ],
-  'not authenticated': [
-    'Run: vibecheck login',
-    'Or set VIBECHECK_API_KEY environment variable',
-  ],
-  'api key expired': [
-    'Your API key has expired',
-    'Get a new key at: https://vibecheckai.dev/settings/keys',
-  ],
-  
-  // Network errors
-  'enotfound': [
-    'Check your internet connection',
-    'Verify DNS settings',
-    'Try again in a few moments',
-  ],
-  'etimedout': [
-    'Request timed out - server may be slow',
-    'Check your internet connection',
-    'Try again with: --timeout 60',
-  ],
-  'econnrefused': [
-    'Could not connect to server',
-    'Check if the server is running',
-    'Verify the URL is correct',
-  ],
-  
-  // Config errors
-  'config not found': [
-    'Run: vibecheck init',
-    'Or create .vibecheckrc manually',
-  ],
-  'invalid config': [
-    'Check your .vibecheckrc file for syntax errors',
-    'Run: vibecheck doctor --fix',
-  ],
-  
-  // Permission errors
-  'eacces': [
-    'Permission denied',
-    'Check file/folder permissions',
-    'Try running with appropriate permissions',
-  ],
-  
-  // Tier errors
-  'feature requires': [
-    'This feature requires a higher tier',
-    'Upgrade at: https://vibecheckai.dev/pricing',
-  ],
-  'limit exceeded': [
-    'You have exceeded your plan limits',
-    'Upgrade for more capacity: https://vibecheckai.dev/pricing',
-  ],
-  
-  // Scan errors
-  'no files found': [
-    'No scannable files found in the project',
-    'Check that you are in the correct directory',
-    'Verify your .vibecheckignore patterns',
-  ],
-};
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// ERROR CLASS
-// ═══════════════════════════════════════════════════════════════════════════════
-
-class CLIError extends Error {
-  constructor(message, options = {}) {
-    super(message);
-    this.name = 'CLIError';
-    this.type = options.type || ERROR_TYPES.INTERNAL;
-    this.code = options.code || this.type.code;
-    this.suggestions = options.suggestions || [];
-    this.details = options.details || null;
-    this.cause = options.cause || null;
-  }
-}
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// ERROR DISPLAY
-// ═══════════════════════════════════════════════════════════════════════════════
-
-/**
- * Display a formatted error message
- * @param {Error|CLIError|string} error
- * @param {Object} options
- */
-function displayError(error, options = {}) {
-  const { showStack = false, showSuggestions = true, json = false } = options;
-  
-  // Handle string errors
-  if (typeof error === 'string') {
-    error = new CLIError(error);
-  }
-  
-  // Determine error type
-  const errorType = error.type || detectErrorType(error);
-  const config = errorType;
-  
-  // Get suggestions
-  const suggestions = error.suggestions?.length > 0 
-    ? error.suggestions 
-    : findSuggestions(error.message);
-
-  // JSON output
-  if (json) {
-    console.log(JSON.stringify({
-      success: false,
-      error: {
-        code: config.code,
-        message: error.message,
-        suggestions,
-        stack: showStack ? error.stack : undefined,
-      }
-    }, null, 2));
-    return;
-  }
-
-  // Visual output
-  console.log();
-  console.log(`  ${config.color}${config.icon}${ansi.reset} ${ansi.bold}${config.label}${ansi.reset}`);
-  console.log(`  ${ansi.gray}${box.horizontal.repeat(60)}${ansi.reset}`);
-  console.log();
-  console.log(`  ${error.message}`);
-  
-  // Details
-  if (error.details) {
-    console.log();
-    console.log(`  ${ansi.dim}Details:${ansi.reset}`);
-    if (typeof error.details === 'object') {
-      for (const [key, value] of Object.entries(error.details)) {
-        console.log(`    ${ansi.gray}${key}:${ansi.reset} ${value}`);
-      }
-    } else {
-      console.log(`    ${error.details}`);
-    }
-  }
-  
-  // Suggestions
-  if (showSuggestions && suggestions.length > 0) {
-    console.log();
-    console.log(`  ${ansi.cyan}${sym.info}${ansi.reset} ${ansi.dim}Suggestions:${ansi.reset}`);
-    for (const suggestion of suggestions) {
-      console.log(`    ${ansi.gray}${sym.arrow}${ansi.reset} ${suggestion}`);
-    }
-  }
-  
-  // Stack trace (debug mode)
-  if (showStack && error.stack) {
-    console.log();
-    console.log(`  ${ansi.dim}Stack trace:${ansi.reset}`);
-    const stackLines = error.stack.split('\n').slice(1, 6);
-    for (const line of stackLines) {
-      console.log(`  ${ansi.gray}${line.trim()}${ansi.reset}`);
-    }
-  }
-  
-  console.log();
-}
-
-/**
- * Detect error type from error object
- * @param {Error} error
- */
-function detectErrorType(error) {
-  const message = (error.message || '').toLowerCase();
-  const code = (error.code || '').toLowerCase();
-  
-  // Auth errors
-  if (message.includes('auth') || message.includes('api key') || message.includes('unauthorized') || code === 'unauthorized') {
-    return ERROR_TYPES.AUTH;
-  }
-  
-  // Network errors
-  if (code === 'enotfound' || code === 'etimedout' || code === 'econnrefused' || code === 'econnreset' ||
-      message.includes('network') || message.includes('connection')) {
-    return ERROR_TYPES.NETWORK;
-  }
-  
-  // Config errors
-  if (message.includes('config') || message.includes('.vibecheckrc')) {
-    return ERROR_TYPES.CONFIG;
-  }
-  
-  // Permission errors
-  if (code === 'eacces' || code === 'eperm' || message.includes('permission')) {
-    return ERROR_TYPES.PERMISSION;
-  }
-  
-  // Not found
-  if (code === 'enoent' || message.includes('not found') || message.includes('does not exist')) {
-    return ERROR_TYPES.NOT_FOUND;
-  }
-  
-  // Validation
-  if (message.includes('invalid') || message.includes('validation')) {
-    return ERROR_TYPES.VALIDATION;
-  }
-  
-  // Tier/upgrade
-  if (message.includes('upgrade') || message.includes('tier') || message.includes('requires')) {
-    return ERROR_TYPES.TIER;
-  }
-  
-  // Timeout
-  if (message.includes('timeout') || code === 'etimedout') {
-    return ERROR_TYPES.TIMEOUT;
-  }
-  
-  return ERROR_TYPES.INTERNAL;
-}
-
-/**
- * Find suggestions based on error message
- * @param {string} message
- */
-function findSuggestions(message) {
-  const lower = (message || '').toLowerCase();
-  
-  for (const [pattern, suggestions] of Object.entries(ERROR_SUGGESTIONS)) {
-    if (lower.includes(pattern)) {
-      return suggestions;
-    }
-  }
-  
-  return [];
-}
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// ERROR BOUNDARY
-// ═══════════════════════════════════════════════════════════════════════════════
-
-/**
- * Wrap an async function with error handling
- * @param {Function} fn - Async function to wrap
- * @param {Object} options
- */
-function withErrorHandler(fn, options = {}) {
-  return async (...args) => {
-    try {
-      return await fn(...args);
-    } catch (error) {
-      displayError(error, options);
-      
-      // Return appropriate exit code
-      const errorType = error.type || detectErrorType(error);
-      switch (errorType.code) {
-        case 'AUTH': return 10;
-        case 'NETWORK': return 11;
-        case 'CONFIG': return 12;
-        case 'PERMISSION': return 13;
-        case 'NOT_FOUND': return 14;
-        case 'VALIDATION': return 15;
-        case 'TIER': return 16;
-        case 'TIMEOUT': return 17;
-        default: return 1;
-      }
-    }
-  };
-}
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// WARNING DISPLAY
-// ═══════════════════════════════════════════════════════════════════════════════
-
-/**
- * Display a warning message
- * @param {string} message
- * @param {Object} options
- */
-function displayWarning(message, options = {}) {
-  const { suggestions = [] } = options;
-  
-  console.log(`  ${ansi.yellow}${sym.warning}${ansi.reset} ${ansi.bold}Warning${ansi.reset}`);
-  console.log(`  ${message}`);
-  
-  if (suggestions.length > 0) {
-    console.log();
-    for (const suggestion of suggestions) {
-      console.log(`    ${ansi.gray}${sym.arrow}${ansi.reset} ${suggestion}`);
-    }
-  }
-  console.log();
-}
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// CRASH REPORT
-// ═══════════════════════════════════════════════════════════════════════════════
-
-/**
- * Display a crash report for unexpected errors
- * @param {Error} error
- */
-function displayCrashReport(error) {
-  console.log();
-  console.log(`  ${ansi.red}${box.topLeft}${box.horizontal.repeat(66)}${box.topRight}${ansi.reset}`);
-  console.log(`  ${ansi.red}${box.vertical}${ansi.reset} ${ansi.bold}${ansi.red}UNEXPECTED ERROR${ansi.reset}${' '.repeat(49)}${ansi.red}${box.vertical}${ansi.reset}`);
-  console.log(`  ${ansi.red}${box.vertical}${box.horizontal.repeat(66)}${box.vertical}${ansi.reset}`);
-  console.log(`  ${ansi.red}${box.vertical}${ansi.reset}                                                                  ${ansi.red}${box.vertical}${ansi.reset}`);
-  console.log(`  ${ansi.red}${box.vertical}${ansi.reset}  An unexpected error occurred. This is likely a bug.             ${ansi.red}${box.vertical}${ansi.reset}`);
-  console.log(`  ${ansi.red}${box.vertical}${ansi.reset}                                                                  ${ansi.red}${box.vertical}${ansi.reset}`);
-  console.log(`  ${ansi.red}${box.vertical}${ansi.reset}  ${ansi.dim}Error:${ansi.reset} ${padRight(error.message?.slice(0, 50) || 'Unknown', 52)}  ${ansi.red}${box.vertical}${ansi.reset}`);
-  console.log(`  ${ansi.red}${box.vertical}${ansi.reset}                                                                  ${ansi.red}${box.vertical}${ansi.reset}`);
-  console.log(`  ${ansi.red}${box.vertical}${ansi.reset}  Please report this issue:                                       ${ansi.red}${box.vertical}${ansi.reset}`);
-  console.log(`  ${ansi.red}${box.vertical}${ansi.reset}  ${ansi.cyan}https://github.com/vibecheckai/vibecheck/issues${ansi.reset}               ${ansi.red}${box.vertical}${ansi.reset}`);
-  console.log(`  ${ansi.red}${box.vertical}${ansi.reset}                                                                  ${ansi.red}${box.vertical}${ansi.reset}`);
-  console.log(`  ${ansi.red}${box.bottomLeft}${box.horizontal.repeat(66)}${box.bottomRight}${ansi.reset}`);
-  
-  if (process.env.DEBUG || process.env.VIBECHECK_DEBUG) {
-    console.log();
-    console.log(`  ${ansi.dim}Stack trace:${ansi.reset}`);
-    const stackLines = (error.stack || '').split('\n').slice(1, 10);
-    for (const line of stackLines) {
-      console.log(`  ${ansi.gray}${line.trim()}${ansi.reset}`);
-    }
-  }
-  
-  console.log();
-}
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// EXPORTS
-// ═══════════════════════════════════════════════════════════════════════════════
-
-module.exports = {
-  // Error types
-  ERROR_TYPES,
-  CLIError,
-  
-  // Display functions
-  displayError,
-  displayWarning,
-  displayCrashReport,
-  
-  // Utilities
-  detectErrorType,
-  findSuggestions,
-  withErrorHandler,
-};