vibecheck-ai 2.0.2 → 5.0.0

package/bin/runners/lib/doctor/types.js

@@ -0,0 +1,113 @@
+/**
+ * Doctor Service Types
+ * 
+ * Enterprise-grade diagnostic types and constants
+ */
+
+const SEVERITY = {
+  CRITICAL: 'critical',  // Blocks all operations
+  ERROR: 'error',        // Must fix before using vibecheck
+  WARNING: 'warning',    // Recommended to fix
+  INFO: 'info',          // Informational
+  PASS: 'pass',          // Check passed
+};
+
+const SEVERITY_WEIGHT = {
+  [SEVERITY.CRITICAL]: 0,
+  [SEVERITY.ERROR]: 0.25,
+  [SEVERITY.WARNING]: 0.75,
+  [SEVERITY.INFO]: 1,
+  [SEVERITY.PASS]: 1,
+};
+
+const CATEGORY = {
+  SYSTEM: 'system',
+  RUNTIME: 'runtime',
+  PROJECT: 'project',
+  SECURITY: 'security',
+  NETWORK: 'network',
+  DEPENDENCIES: 'dependencies',
+  VIBECHECK: 'vibecheck',
+};
+
+const CATEGORY_META = {
+  [CATEGORY.SYSTEM]: { name: 'System', icon: '💻', order: 1 },
+  [CATEGORY.RUNTIME]: { name: 'Runtime', icon: '🟢', order: 2 },
+  [CATEGORY.PROJECT]: { name: 'Project', icon: '📁', order: 3 },
+  [CATEGORY.DEPENDENCIES]: { name: 'Dependencies', icon: '📦', order: 4 },
+  [CATEGORY.SECURITY]: { name: 'Security', icon: '🔐', order: 5 },
+  [CATEGORY.NETWORK]: { name: 'Network', icon: '🌐', order: 6 },
+  [CATEGORY.VIBECHECK]: { name: 'Vibecheck', icon: '⚡', order: 7 },
+};
+
+const FIX_TYPE = {
+  COMMAND: 'command',      // Run a shell command
+  FILE_CREATE: 'file_create',
+  FILE_EDIT: 'file_edit',
+  MANUAL: 'manual',        // User must do manually
+  LINK: 'link',            // External documentation
+};
+
+/**
+ * @typedef {Object} DiagnosticResult
+ * @property {string} id - Unique diagnostic ID
+ * @property {string} name - Human readable name
+ * @property {string} category - Category from CATEGORY enum
+ * @property {string} severity - Severity from SEVERITY enum
+ * @property {string} message - Short status message
+ * @property {string} [detail] - Additional detail
+ * @property {number} durationMs - Time taken in milliseconds
+ * @property {Fix[]} [fixes] - Available fixes
+ * @property {Object} [metadata] - Additional diagnostic data
+ */
+
+/**
+ * @typedef {Object} Fix
+ * @property {string} type - Fix type from FIX_TYPE enum
+ * @property {string} description - What the fix does
+ * @property {string} [command] - Command to run (for COMMAND type)
+ * @property {string} [path] - File path (for FILE_* types)
+ * @property {string} [content] - Content (for FILE_CREATE/EDIT)
+ * @property {string} [url] - URL (for LINK type)
+ * @property {boolean} [dangerous] - Requires confirmation
+ * @property {boolean} [autoFixable] - Can be auto-fixed
+ */
+
+/**
+ * @typedef {Object} DiagnosticModule
+ * @property {string} id - Module ID
+ * @property {string} name - Module name
+ * @property {string} category - Category
+ * @property {function} check - Async check function
+ * @property {boolean} [parallel] - Can run in parallel
+ * @property {string[]} [dependsOn] - IDs this module depends on
+ */
+
+/**
+ * @typedef {Object} DoctorReport
+ * @property {string} version - Report format version
+ * @property {string} timestamp - ISO timestamp
+ * @property {number} durationMs - Total duration
+ * @property {string} projectPath - Scanned project
+ * @property {DiagnosticResult[]} diagnostics - All results
+ * @property {Summary} summary - Summary stats
+ */
+
+/**
+ * @typedef {Object} Summary
+ * @property {number} total - Total checks
+ * @property {number} passed - Passed checks
+ * @property {number} warnings - Warning count
+ * @property {number} errors - Error count
+ * @property {number} critical - Critical count
+ * @property {number} healthScore - 0-100 score
+ * @property {string} verdict - HEALTHY | DEGRADED | UNHEALTHY | CRITICAL
+ */
+
+module.exports = {
+  SEVERITY,
+  SEVERITY_WEIGHT,
+  CATEGORY,
+  CATEGORY_META,
+  FIX_TYPE,
+};

package/bin/runners/lib/doctor/ui.js

@@ -0,0 +1,263 @@
+/**
+ * Doctor CLI UI Components
+ * 
+ * Beautiful terminal output for the Doctor service
+ */
+
+const { SEVERITY, CATEGORY_META } = require('./types');
+
+// ANSI color codes
+const c = {
+  reset: '\x1b[0m',
+  bold: '\x1b[1m',
+  dim: '\x1b[2m',
+  italic: '\x1b[3m',
+  underline: '\x1b[4m',
+  
+  black: '\x1b[30m',
+  red: '\x1b[31m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  blue: '\x1b[34m',
+  magenta: '\x1b[35m',
+  cyan: '\x1b[36m',
+  white: '\x1b[37m',
+  
+  bgRed: '\x1b[41m',
+  bgGreen: '\x1b[42m',
+  bgYellow: '\x1b[43m',
+  bgBlue: '\x1b[44m',
+  bgMagenta: '\x1b[45m',
+  bgCyan: '\x1b[46m',
+};
+
+const SEVERITY_CONFIG = {
+  [SEVERITY.PASS]: { icon: '✓', color: c.green, label: 'PASS' },
+  [SEVERITY.INFO]: { icon: 'ℹ', color: c.blue, label: 'INFO' },
+  [SEVERITY.WARNING]: { icon: '!', color: c.yellow, label: 'WARN' },
+  [SEVERITY.ERROR]: { icon: '✗', color: c.red, label: 'ERROR' },
+  [SEVERITY.CRITICAL]: { icon: '⛔', color: `${c.bgRed}${c.white}`, label: 'CRIT' },
+};
+
+const BOX_CHARS = {
+  topLeft: '╔',
+  topRight: '╗',
+  bottomLeft: '╚',
+  bottomRight: '╝',
+  horizontal: '═',
+  vertical: '║',
+  lightHorizontal: '─',
+};
+
+function box(width = 74) {
+  return {
+    top: `${c.cyan}${BOX_CHARS.topLeft}${BOX_CHARS.horizontal.repeat(width)}${BOX_CHARS.topRight}${c.reset}`,
+    bottom: `${c.cyan}${BOX_CHARS.bottomLeft}${BOX_CHARS.horizontal.repeat(width)}${BOX_CHARS.bottomRight}${c.reset}`,
+    line: (content, align = 'left') => {
+      const stripped = stripAnsi(content);
+      const padding = width - stripped.length;
+      const left = align === 'center' ? Math.floor(padding / 2) : 0;
+      const right = padding - left;
+      return `${c.cyan}${BOX_CHARS.vertical}${c.reset}${' '.repeat(left)}${content}${' '.repeat(right)}${c.cyan}${BOX_CHARS.vertical}${c.reset}`;
+    },
+    empty: `${c.cyan}${BOX_CHARS.vertical}${c.reset}${' '.repeat(width)}${c.cyan}${BOX_CHARS.vertical}${c.reset}`,
+  };
+}
+
+function stripAnsi(str) {
+  return str.replace(/\x1b\[[0-9;]*m/g, '');
+}
+
+function printHeader() {
+  const b = box();
+  console.log('');
+  console.log(b.top);
+  console.log(b.empty);
+  console.log(b.line(`${c.bold}🩺 VIBECHECK DOCTOR${c.reset}`, 'center'));
+  console.log(b.line(`${c.dim}Enterprise Environment Diagnostics${c.reset}`, 'center'));
+  console.log(b.empty);
+  console.log(b.bottom);
+  console.log('');
+}
+
+function printCategoryHeader(category) {
+  const meta = CATEGORY_META[category] || { name: category, icon: '📋' };
+  console.log(`${c.cyan}${meta.icon} ${c.bold}${meta.name}${c.reset}`);
+  console.log(`${c.dim}${BOX_CHARS.lightHorizontal.repeat(50)}${c.reset}`);
+}
+
+function printDiagnostic(diagnostic, options = {}) {
+  const { showDetail = true, showFixes = true, indent = '   ' } = options;
+  const config = SEVERITY_CONFIG[diagnostic.severity] || SEVERITY_CONFIG[SEVERITY.INFO];
+  
+  // Main line
+  console.log(`${indent}${config.color}${config.icon}${c.reset} ${diagnostic.message}`);
+  
+  // Detail
+  if (showDetail && diagnostic.detail) {
+    console.log(`${indent}  ${c.dim}${diagnostic.detail}${c.reset}`);
+  }
+  
+  // First fix hint
+  if (showFixes && diagnostic.fixes && diagnostic.fixes.length > 0) {
+    const fix = diagnostic.fixes[0];
+    if (fix.command) {
+      console.log(`${indent}  ${c.cyan}→ ${fix.command}${c.reset}`);
+    } else if (fix.url) {
+      console.log(`${indent}  ${c.cyan}→ ${fix.url}${c.reset}`);
+    } else if (fix.description) {
+      console.log(`${indent}  ${c.cyan}→ ${fix.description}${c.reset}`);
+    }
+  }
+}
+
+function printProgress(name, total, current) {
+  const percent = Math.round((current / total) * 100);
+  const barWidth = 20;
+  const filled = Math.round((current / total) * barWidth);
+  const bar = '█'.repeat(filled) + '░'.repeat(barWidth - filled);
+  
+  process.stdout.write(`\r${c.dim}${name}${c.reset} [${c.cyan}${bar}${c.reset}] ${percent}%`);
+}
+
+function clearProgress() {
+  process.stdout.write('\r' + ' '.repeat(60) + '\r');
+}
+
+function printSpinner(message, frame = 0) {
+  const frames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+  process.stdout.write(`\r${c.cyan}${frames[frame % frames.length]}${c.reset} ${message}`);
+  return (frame + 1) % frames.length;
+}
+
+function printIssuesSummary(diagnostics) {
+  const critical = diagnostics.filter(d => d.severity === SEVERITY.CRITICAL);
+  const errors = diagnostics.filter(d => d.severity === SEVERITY.ERROR);
+  const warnings = diagnostics.filter(d => d.severity === SEVERITY.WARNING);
+  
+  if (critical.length === 0 && errors.length === 0 && warnings.length === 0) {
+    return;
+  }
+  
+  const b = box();
+  console.log(b.top);
+  console.log(b.line(`${c.bold}ISSUES FOUND${c.reset}`));
+  console.log(b.bottom);
+  console.log('');
+  
+  if (critical.length > 0) {
+    console.log(`${c.bgRed}${c.white}${c.bold} CRITICAL (${critical.length}) ${c.reset} — Must fix immediately\n`);
+    for (const d of critical) {
+      console.log(`   ${c.red}●${c.reset} ${c.bold}${d.name}${c.reset}`);
+      console.log(`     ${c.dim}${d.message}${c.reset}`);
+      if (d.fixes?.[0]?.command) {
+        console.log(`     ${c.cyan}→ ${d.fixes[0].command}${c.reset}`);
+      }
+      console.log('');
+    }
+  }
+  
+  if (errors.length > 0) {
+    console.log(`${c.red}${c.bold}❌ ERRORS (${errors.length})${c.reset} — Must fix before using vibecheck\n`);
+    for (const d of errors) {
+      console.log(`   ${c.red}●${c.reset} ${c.bold}${d.name}${c.reset}`);
+      console.log(`     ${c.dim}${d.message}${c.reset}`);
+      if (d.fixes?.[0]?.command) {
+        console.log(`     ${c.cyan}→ ${d.fixes[0].command}${c.reset}`);
+      }
+      console.log('');
+    }
+  }
+  
+  if (warnings.length > 0) {
+    console.log(`${c.yellow}${c.bold}⚠️  WARNINGS (${warnings.length})${c.reset} — Recommended fixes\n`);
+    for (const d of warnings) {
+      console.log(`   ${c.yellow}●${c.reset} ${c.bold}${d.name}${c.reset}`);
+      console.log(`     ${c.dim}${d.message}${c.reset}`);
+      if (d.fixes?.[0]?.command) {
+        console.log(`     ${c.cyan}→ ${d.fixes[0].command}${c.reset}`);
+      }
+      console.log('');
+    }
+  }
+}
+
+function printFinalSummary(summary, durationMs) {
+  const b = box();
+  
+  const healthColor = summary.healthScore >= 80 ? c.green 
+    : summary.healthScore >= 60 ? c.yellow 
+    : c.red;
+  const healthIcon = summary.healthScore >= 80 ? '💚' 
+    : summary.healthScore >= 60 ? '💛' 
+    : '❤️';
+  
+  const verdictColor = {
+    HEALTHY: c.green,
+    DEGRADED: c.yellow,
+    UNHEALTHY: c.red,
+    CRITICAL: `${c.bgRed}${c.white}`,
+  }[summary.verdict] || c.white;
+  
+  console.log(b.top);
+  console.log(b.empty);
+  console.log(b.line(`${healthIcon} ${c.bold}Health Score: ${healthColor}${summary.healthScore}%${c.reset}`));
+  console.log(b.line(`   ${c.bold}Verdict: ${verdictColor}${summary.verdict}${c.reset}`));
+  console.log(b.empty);
+  console.log(b.line(`${c.green}✓ ${summary.passed} passed${c.reset}  ${c.blue}ℹ ${summary.info} info${c.reset}  ${c.yellow}! ${summary.warnings} warnings${c.reset}  ${c.red}✗ ${summary.errors} errors${c.reset}  ${summary.critical > 0 ? `${c.bgRed}${c.white}⛔ ${summary.critical}${c.reset}` : ''}`));
+  console.log(b.line(`${c.dim}Completed ${summary.total} checks in ${(durationMs / 1000).toFixed(1)}s${c.reset}`));
+  console.log(b.empty);
+  console.log(b.bottom);
+  console.log('');
+  
+  // Final message
+  if (summary.critical > 0) {
+    console.log(`${c.bgRed}${c.white}${c.bold} ⛔ CRITICAL ISSUES DETECTED ${c.reset}`);
+    console.log(`${c.red}Fix critical issues immediately before proceeding.${c.reset}\n`);
+  } else if (summary.errors > 0) {
+    console.log(`${c.red}${c.bold}⚠ Fix the errors above before running vibecheck.${c.reset}\n`);
+  } else if (summary.warnings > 0) {
+    console.log(`${c.yellow}Your environment is ready, but consider fixing the warnings.${c.reset}\n`);
+  } else {
+    console.log(`${c.green}${c.bold}✓ Your environment is perfectly configured!${c.reset}\n`);
+  }
+}
+
+function printAutoFixResults(results) {
+  console.log('');
+  console.log(`${c.cyan}${c.bold}🔧 Auto-Fix Results${c.reset}`);
+  console.log(`${c.dim}${BOX_CHARS.lightHorizontal.repeat(50)}${c.reset}`);
+  
+  console.log(`   Attempted: ${results.attempted}`);
+  console.log(`   ${c.green}Succeeded: ${results.succeeded}${c.reset}`);
+  console.log(`   ${c.red}Failed: ${results.failed}${c.reset}`);
+  console.log(`   ${c.dim}Skipped: ${results.skipped}${c.reset}`);
+  console.log('');
+  
+  for (const r of results.results) {
+    const icon = r.status === 'success' ? `${c.green}✓${c.reset}` 
+      : r.status === 'failed' ? `${c.red}✗${c.reset}`
+      : `${c.dim}○${c.reset}`;
+    console.log(`   ${icon} ${r.diagnosticName}: ${r.status}`);
+    if (r.error) {
+      console.log(`     ${c.dim}${r.error}${c.reset}`);
+    }
+  }
+  console.log('');
+}
+
+module.exports = {
+  c,
+  SEVERITY_CONFIG,
+  box,
+  stripAnsi,
+  printHeader,
+  printCategoryHeader,
+  printDiagnostic,
+  printProgress,
+  clearProgress,
+  printSpinner,
+  printIssuesSummary,
+  printFinalSummary,
+  printAutoFixResults,
+};

package/bin/runners/lib/doctor-enhanced.js

@@ -0,0 +1,233 @@
+/**
+ * Enhanced Doctor Command
+ * 
+ * Self-diagnosing CLI that catches 90% of setup issues.
+ * Goal: kill support tickets by being brutally helpful.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+const c = {
+  reset: '\x1b[0m',
+  bold: '\x1b[1m',
+  dim: '\x1b[2m',
+  red: '\x1b[31m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  cyan: '\x1b[36m',
+};
+
+class DoctorEnhanced {
+  constructor(projectPath) {
+    this.projectPath = projectPath;
+    this.issues = [];
+    this.fixes = [];
+  }
+
+  async diagnose() {
+    console.log('\n🔍 vibecheck Doctor\n');
+    console.log('Checking your environment...\n');
+
+    await this.checkNodeVersion();
+    await this.checkPackageManager();
+    await this.checkRequiredBinaries();
+    await this.checkEnvVars();
+    await this.checkPermissions();
+    await this.checkProjectStructure();
+    await this.checkCanBuild();
+    await this.checkCanRun();
+
+    this.printReport();
+    return this.issues.length === 0 ? 0 : 1;
+  }
+
+  async checkNodeVersion() {
+    try {
+      const version = process.version;
+      const major = parseInt(version.slice(1).split('.')[0]);
+      
+      if (major < 18) {
+        this.issue('Node version too old', `You're running Node ${version}. vibecheck requires Node 18+.`, `nvm install 18 && nvm use 18`);
+      } else {
+        this.pass(`Node version: ${version}`);
+      }
+    } catch {
+      this.issue('Cannot detect Node version', 'Node.js may not be installed.', 'Install Node.js from nodejs.org');
+    }
+  }
+
+  async checkPackageManager() {
+    const managers = ['pnpm', 'npm', 'yarn'];
+    let found = null;
+
+    for (const mgr of managers) {
+      try {
+        execSync(`${mgr} --version`, { stdio: 'ignore' });
+        found = mgr;
+        break;
+      } catch {
+        // Not found
+      }
+    }
+
+    if (!found) {
+      this.issue('No package manager found', 'Install pnpm, npm, or yarn.', 'npm install -g pnpm');
+    } else {
+      this.pass(`Package manager: ${found}`);
+    }
+  }
+
+  async checkRequiredBinaries() {
+    const binaries = [
+      { name: 'git', required: true },
+      { name: 'playwright', required: false, check: 'npx playwright --version' },
+    ];
+
+    for (const bin of binaries) {
+      try {
+        if (bin.check) {
+          execSync(bin.check, { stdio: 'ignore' });
+        } else {
+          execSync(`which ${bin.name}`, { stdio: 'ignore' });
+        }
+        this.pass(`${bin.name} found`);
+      } catch {
+        if (bin.required) {
+          this.issue(`${bin.name} not found`, `${bin.name} is required.`, `Install ${bin.name}`);
+        } else {
+          this.warn(`${bin.name} not found`, `Optional: ${bin.name} enables runtime verification.`, `npx playwright install`);
+        }
+      }
+    }
+  }
+
+  async checkEnvVars() {
+    const required = process.env.VIBECHECK_API_KEY ? [] : ['VIBECHECK_API_KEY (optional)'];
+    const sensitive = ['API_KEY', 'SECRET', 'TOKEN', 'PASSWORD'];
+
+    // Check for common missing env vars
+    const envFile = path.join(this.projectPath, '.env');
+    if (!fs.existsSync(envFile)) {
+      this.warn('No .env file', 'Consider creating .env for local configuration.', 'touch .env');
+    }
+
+    // Check for exposed secrets (but never print them)
+    const envExample = path.join(this.projectPath, '.env.example');
+    if (fs.existsSync(envExample)) {
+      const content = fs.readFileSync(envExample, 'utf8');
+      const hasSecrets = sensitive.some(s => content.includes(s));
+      if (hasSecrets) {
+        this.pass('.env.example found');
+      }
+    }
+  }
+
+  async checkPermissions() {
+    try {
+      const testFile = path.join(this.projectPath, '.vibecheck', '.test-write');
+      fs.mkdirSync(path.dirname(testFile), { recursive: true });
+      fs.writeFileSync(testFile, 'test');
+      fs.unlinkSync(testFile);
+      this.pass('Write permissions OK');
+    } catch {
+      this.issue('No write permissions', 'Cannot write to .vibecheck directory.', `chmod -R u+w ${this.projectPath}`);
+    }
+  }
+
+  async checkProjectStructure() {
+    const packageJson = path.join(this.projectPath, 'package.json');
+    if (!fs.existsSync(packageJson)) {
+      this.issue('No package.json', 'This doesn\'t look like a Node.js project.', 'Run vibecheck init');
+      return;
+    }
+
+    this.pass('package.json found');
+
+    // Check for common project structures
+    const hasSrc = fs.existsSync(path.join(this.projectPath, 'src')) ||
+                   fs.existsSync(path.join(this.projectPath, 'app')) ||
+                   fs.existsSync(path.join(this.projectPath, 'pages'));
+    
+    if (!hasSrc) {
+      this.warn('No source directory found', 'vibecheck works best with standard project structures.', 'Consider organizing code in src/ or app/');
+    }
+  }
+
+  async checkCanBuild() {
+    try {
+      const packageJson = JSON.parse(fs.readFileSync(path.join(this.projectPath, 'package.json'), 'utf8'));
+      if (packageJson.scripts?.build) {
+        try {
+          execSync('npm run build', { cwd: this.projectPath, stdio: 'ignore', timeout: 10000 });
+          this.pass('Project builds successfully');
+        } catch {
+          this.warn('Build failed', 'Project may have build errors.', 'Run: npm run build');
+        }
+      }
+    } catch {
+      // Can't check build
+    }
+  }
+
+  async checkCanRun() {
+    // Minimal runtime check would go here
+    // For now, just pass
+    this.pass('Runtime check skipped (use --runtime for full check)');
+  }
+
+  issue(title, description, fix) {
+    this.issues.push({ type: 'error', title, description, fix });
+  }
+
+  warn(title, description, fix) {
+    this.issues.push({ type: 'warning', title, description, fix });
+  }
+
+  pass(message) {
+    // Silent pass - only show issues
+  }
+
+  printReport() {
+    if (this.issues.length === 0) {
+      console.log(`${c.green}${c.bold}✓ All checks passed!${c.reset}\n`);
+      return;
+    }
+
+    console.log('\n' + '═'.repeat(70));
+    console.log(`${c.bold}DIAGNOSIS REPORT${c.reset}`);
+    console.log('═'.repeat(70) + '\n');
+
+    const errors = this.issues.filter(i => i.type === 'error');
+    const warnings = this.issues.filter(i => i.type === 'warning');
+
+    if (errors.length > 0) {
+      console.log(`${c.red}${c.bold}❌ ERRORS (${errors.length}):${c.reset}\n`);
+      for (const issue of errors) {
+        console.log(`  ${c.bold}${issue.title}${c.reset}`);
+        console.log(`    ${c.dim}${issue.description}${c.reset}`);
+        if (issue.fix) {
+          console.log(`    ${c.cyan}→ Fix: ${issue.fix}${c.reset}`);
+        }
+        console.log('');
+      }
+    }
+
+    if (warnings.length > 0) {
+      console.log(`${c.yellow}${c.bold}⚠️  WARNINGS (${warnings.length}):${c.reset}\n`);
+      for (const issue of warnings) {
+        console.log(`  ${c.bold}${issue.title}${c.reset}`);
+        console.log(`    ${c.dim}${issue.description}${c.reset}`);
+        if (issue.fix) {
+          console.log(`    ${c.cyan}→ Fix: ${issue.fix}${c.reset}`);
+        }
+        console.log('');
+      }
+    }
+
+    console.log('═'.repeat(70) + '\n');
+  }
+}
+
+module.exports = { DoctorEnhanced };