vibecheck-ai 2.0.1 → 5.0.0

package/bin/runners/lib/doctor/fix-script.js

@@ -0,0 +1,336 @@
+/**
+ * Fix Script Generator
+ * 
+ * Generates copy-paste friendly fix scripts from diagnostic results.
+ * Separates safe vs dangerous commands and provides clear instructions.
+ */
+
+const os = require('os');
+const path = require('path');
+const { SEVERITY, FIX_TYPE } = require('./types');
+
+const PLATFORM = os.platform();
+const IS_WINDOWS = PLATFORM === 'win32';
+const SHELL = IS_WINDOWS ? 'PowerShell' : (process.env.SHELL?.includes('zsh') ? 'zsh' : 'bash');
+
+/**
+ * Generate a complete fix script from diagnostic results
+ * @param {object[]} diagnostics - Array of diagnostic results
+ * @param {object} options - Generation options
+ * @returns {object} Fix script with safe and dangerous sections
+ */
+function generateFixScript(diagnostics, options = {}) {
+  const {
+    projectPath = process.cwd(),
+    includeDangerous = false,
+    safeOnly = true,
+    format = 'shell', // 'shell' | 'markdown' | 'json'
+  } = options;
+  
+  // Collect all fixes from diagnostics with issues
+  const allFixes = [];
+  
+  for (const diag of diagnostics) {
+    if (diag.severity === SEVERITY.PASS || diag.severity === SEVERITY.INFO) continue;
+    if (!diag.fixes || diag.fixes.length === 0) continue;
+    
+    for (const fix of diag.fixes) {
+      allFixes.push({
+        diagnosticId: diag.id,
+        diagnosticName: diag.name,
+        severity: diag.severity,
+        ...fix,
+      });
+    }
+  }
+  
+  // Separate safe and dangerous fixes
+  const safeFixes = allFixes.filter(f => !f.dangerous && f.type === FIX_TYPE.COMMAND);
+  const dangerousFixes = allFixes.filter(f => f.dangerous && f.type === FIX_TYPE.COMMAND);
+  const manualFixes = allFixes.filter(f => f.type === FIX_TYPE.MANUAL);
+  const linkFixes = allFixes.filter(f => f.type === FIX_TYPE.LINK);
+  
+  // Generate script based on format
+  switch (format) {
+    case 'markdown':
+      return generateMarkdownScript(safeFixes, dangerousFixes, manualFixes, linkFixes, projectPath, includeDangerous);
+    case 'json':
+      return generateJsonScript(safeFixes, dangerousFixes, manualFixes, linkFixes, projectPath);
+    default:
+      return generateShellScript(safeFixes, dangerousFixes, manualFixes, linkFixes, projectPath, includeDangerous);
+  }
+}
+
+function generateShellScript(safeFixes, dangerousFixes, manualFixes, linkFixes, projectPath, includeDangerous) {
+  const lines = [];
+  const timestamp = new Date().toISOString();
+  
+  // Header
+  if (IS_WINDOWS) {
+    lines.push('# ═══════════════════════════════════════════════════════════════════════════');
+    lines.push('# vibecheck Doctor - Fix Script (PowerShell)');
+    lines.push(`# Generated: ${timestamp}`);
+    lines.push(`# Project: ${projectPath}`);
+    lines.push('# ═══════════════════════════════════════════════════════════════════════════');
+    lines.push('');
+    lines.push('# To run: Copy-paste these commands into PowerShell');
+    lines.push('');
+  } else {
+    lines.push('#!/bin/bash');
+    lines.push('# ═══════════════════════════════════════════════════════════════════════════');
+    lines.push('# vibecheck Doctor - Fix Script');
+    lines.push(`# Generated: ${timestamp}`);
+    lines.push(`# Project: ${projectPath}`);
+    lines.push('# ═══════════════════════════════════════════════════════════════════════════');
+    lines.push('');
+    lines.push('set -e  # Exit on error');
+    lines.push('');
+  }
+  
+  // Safe fixes section
+  if (safeFixes.length > 0) {
+    lines.push('# ─────────────────────────────────────────────────────────────────────────────');
+    lines.push('# SAFE FIXES (recommended, no data loss risk)');
+    lines.push('# ─────────────────────────────────────────────────────────────────────────────');
+    lines.push('');
+    
+    for (const fix of safeFixes) {
+      lines.push(`# [${fix.diagnosticId}] ${fix.diagnosticName}`);
+      lines.push(`# ${fix.description}`);
+      lines.push(fix.command);
+      lines.push('');
+    }
+  } else {
+    lines.push('# No safe automated fixes available.');
+    lines.push('');
+  }
+  
+  // Dangerous fixes section
+  if (dangerousFixes.length > 0) {
+    lines.push('');
+    lines.push('# ─────────────────────────────────────────────────────────────────────────────');
+    lines.push('# ⚠️  DANGEROUS FIXES (review carefully before running)');
+    lines.push('# ─────────────────────────────────────────────────────────────────────────────');
+    lines.push('');
+    
+    if (!includeDangerous) {
+      lines.push('# UNCOMMENT BELOW TO ENABLE (at your own risk)');
+      lines.push('');
+    }
+    
+    for (const fix of dangerousFixes) {
+      const prefix = includeDangerous ? '' : '# ';
+      lines.push(`${prefix}# [${fix.diagnosticId}] ${fix.diagnosticName}`);
+      lines.push(`${prefix}# ⚠️  ${fix.description}`);
+      lines.push(`${prefix}${fix.command}`);
+      lines.push('');
+    }
+  }
+  
+  // Manual fixes section
+  if (manualFixes.length > 0) {
+    lines.push('');
+    lines.push('# ─────────────────────────────────────────────────────────────────────────────');
+    lines.push('# MANUAL FIXES (require human intervention)');
+    lines.push('# ─────────────────────────────────────────────────────────────────────────────');
+    lines.push('');
+    
+    for (const fix of manualFixes) {
+      lines.push(`# [${fix.diagnosticId}] ${fix.diagnosticName}`);
+      lines.push(`#   → ${fix.description}`);
+      lines.push('');
+    }
+  }
+  
+  // Links section
+  if (linkFixes.length > 0) {
+    lines.push('');
+    lines.push('# ─────────────────────────────────────────────────────────────────────────────');
+    lines.push('# DOCUMENTATION LINKS');
+    lines.push('# ─────────────────────────────────────────────────────────────────────────────');
+    lines.push('');
+    
+    for (const fix of linkFixes) {
+      lines.push(`# [${fix.diagnosticId}] ${fix.description}`);
+      lines.push(`#   ${fix.url}`);
+      lines.push('');
+    }
+  }
+  
+  // Footer
+  lines.push('');
+  lines.push('# ═══════════════════════════════════════════════════════════════════════════');
+  lines.push('# After running fixes, verify with: vibecheck doctor');
+  lines.push('# ═══════════════════════════════════════════════════════════════════════════');
+  
+  return {
+    script: lines.join('\n'),
+    safeFixes: safeFixes.length,
+    dangerousFixes: dangerousFixes.length,
+    manualFixes: manualFixes.length,
+    links: linkFixes.length,
+    shell: SHELL,
+    platform: PLATFORM,
+  };
+}
+
+function generateMarkdownScript(safeFixes, dangerousFixes, manualFixes, linkFixes, projectPath, includeDangerous) {
+  const lines = [];
+  const timestamp = new Date().toISOString();
+  
+  lines.push('# vibecheck Doctor - Fix Script');
+  lines.push('');
+  lines.push(`**Generated:** ${timestamp}`);
+  lines.push(`**Project:** \`${projectPath}\``);
+  lines.push(`**Platform:** ${PLATFORM}`);
+  lines.push('');
+  
+  // Safe fixes
+  if (safeFixes.length > 0) {
+    lines.push('## Safe Fixes');
+    lines.push('');
+    lines.push('These commands are safe to run and won\'t cause data loss:');
+    lines.push('');
+    
+    for (const fix of safeFixes) {
+      lines.push(`### ${fix.diagnosticName}`);
+      lines.push(`*${fix.description}*`);
+      lines.push('');
+      lines.push('```bash');
+      lines.push(fix.command);
+      lines.push('```');
+      lines.push('');
+    }
+  }
+  
+  // Dangerous fixes
+  if (dangerousFixes.length > 0) {
+    lines.push('## Dangerous Fixes');
+    lines.push('');
+    lines.push('> **Warning:** Review these commands carefully before running.');
+    lines.push('');
+    
+    for (const fix of dangerousFixes) {
+      lines.push(`### ${fix.diagnosticName}`);
+      lines.push(`*${fix.description}*`);
+      lines.push('');
+      lines.push('```bash');
+      lines.push(fix.command);
+      lines.push('```');
+      lines.push('');
+    }
+  }
+  
+  // Manual fixes
+  if (manualFixes.length > 0) {
+    lines.push('## Manual Actions Required');
+    lines.push('');
+    
+    for (const fix of manualFixes) {
+      lines.push(`- **${fix.diagnosticName}**: ${fix.description}`);
+    }
+    lines.push('');
+  }
+  
+  // Links
+  if (linkFixes.length > 0) {
+    lines.push('## Documentation');
+    lines.push('');
+    
+    for (const fix of linkFixes) {
+      lines.push(`- [${fix.description}](${fix.url})`);
+    }
+    lines.push('');
+  }
+  
+  lines.push('---');
+  lines.push('');
+  lines.push('After running fixes, verify with: `vibecheck doctor`');
+  
+  return {
+    script: lines.join('\n'),
+    safeFixes: safeFixes.length,
+    dangerousFixes: dangerousFixes.length,
+    manualFixes: manualFixes.length,
+    links: linkFixes.length,
+    format: 'markdown',
+  };
+}
+
+function generateJsonScript(safeFixes, dangerousFixes, manualFixes, linkFixes, projectPath) {
+  return {
+    generated: new Date().toISOString(),
+    project: projectPath,
+    platform: PLATFORM,
+    shell: SHELL,
+    fixes: {
+      safe: safeFixes.map(f => ({
+        id: f.diagnosticId,
+        name: f.diagnosticName,
+        description: f.description,
+        command: f.command,
+        severity: f.severity,
+      })),
+      dangerous: dangerousFixes.map(f => ({
+        id: f.diagnosticId,
+        name: f.diagnosticName,
+        description: f.description,
+        command: f.command,
+        severity: f.severity,
+      })),
+      manual: manualFixes.map(f => ({
+        id: f.diagnosticId,
+        name: f.diagnosticName,
+        description: f.description,
+      })),
+      links: linkFixes.map(f => ({
+        id: f.diagnosticId,
+        description: f.description,
+        url: f.url,
+      })),
+    },
+    summary: {
+      safeFixes: safeFixes.length,
+      dangerousFixes: dangerousFixes.length,
+      manualFixes: manualFixes.length,
+      links: linkFixes.length,
+      total: safeFixes.length + dangerousFixes.length + manualFixes.length + linkFixes.length,
+    },
+  };
+}
+
+/**
+ * Generate one-liner fix commands for quick copy-paste
+ * @param {object[]} diagnostics - Diagnostic results
+ * @param {object} options - Options
+ * @returns {string[]} Array of commands
+ */
+function generateQuickFixes(diagnostics, options = {}) {
+  const { safeOnly = true, separator = ' && ' } = options;
+  
+  const commands = [];
+  
+  for (const diag of diagnostics) {
+    if (diag.severity === SEVERITY.PASS || diag.severity === SEVERITY.INFO) continue;
+    if (!diag.fixes) continue;
+    
+    for (const fix of diag.fixes) {
+      if (fix.type !== FIX_TYPE.COMMAND) continue;
+      if (safeOnly && fix.dangerous) continue;
+      if (!fix.autoFixable && safeOnly) continue;
+      
+      commands.push(fix.command);
+    }
+  }
+  
+  return {
+    commands,
+    oneLiner: commands.join(separator),
+    count: commands.length,
+  };
+}
+
+module.exports = {
+  generateFixScript,
+  generateQuickFixes,
+};

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

@@ -0,0 +1,37 @@
+/**
+ * Doctor Service — Enterprise Environment Diagnostics
+ * 
+ * Main entry point for the Doctor service
+ */
+
+const { DoctorService, diagnose } = require('./service');
+const { SEVERITY, CATEGORY, FIX_TYPE, SEVERITY_WEIGHT, CATEGORY_META } = require('./types');
+const modules = require('./modules');
+const reporter = require('./reporter');
+const autofix = require('./autofix');
+const ui = require('./ui');
+
+module.exports = {
+  // Main service
+  DoctorService,
+  diagnose,
+  
+  // Types and constants
+  SEVERITY,
+  CATEGORY,
+  FIX_TYPE,
+  SEVERITY_WEIGHT,
+  CATEGORY_META,
+  
+  // Modules
+  modules,
+  
+  // Reporter
+  reporter,
+  
+  // Auto-fix
+  autofix,
+  
+  // UI utilities
+  ui,
+};