@vibecheckai/cli 3.2.2 → 3.2.4

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

@@ -1,262 +1,262 @@
-/**
- * Doctor Report Generator
- * 
- * Generates JSON and Markdown reports from diagnostic results
- */
-
-const fs = require('fs');
-const path = require('path');
-const { SEVERITY, SEVERITY_WEIGHT, CATEGORY_META } = require('./types');
-
-const REPORT_VERSION = '2.0.0';
-
-function calculateHealthScore(diagnostics) {
-  if (diagnostics.length === 0) return 100;
-  
-  let weightedSum = 0;
-  let totalWeight = 0;
-  
-  for (const d of diagnostics) {
-    const weight = d.category === 'security' ? 2 : 1; // Security issues count more
-    weightedSum += (SEVERITY_WEIGHT[d.severity] || 1) * weight;
-    totalWeight += weight;
-  }
-  
-  return Math.round((weightedSum / totalWeight) * 100);
-}
-
-function getVerdict(healthScore, diagnostics) {
-  const criticalCount = diagnostics.filter(d => d.severity === SEVERITY.CRITICAL).length;
-  const errorCount = diagnostics.filter(d => d.severity === SEVERITY.ERROR).length;
-  
-  if (criticalCount > 0) return 'CRITICAL';
-  if (errorCount > 0) return 'UNHEALTHY';
-  if (healthScore < 80) return 'DEGRADED';
-  return 'HEALTHY';
-}
-
-function createSummary(diagnostics) {
-  const total = diagnostics.length;
-  const passed = diagnostics.filter(d => d.severity === SEVERITY.PASS).length;
-  const info = diagnostics.filter(d => d.severity === SEVERITY.INFO).length;
-  const warnings = diagnostics.filter(d => d.severity === SEVERITY.WARNING).length;
-  const errors = diagnostics.filter(d => d.severity === SEVERITY.ERROR).length;
-  const critical = diagnostics.filter(d => d.severity === SEVERITY.CRITICAL).length;
-  
-  const healthScore = calculateHealthScore(diagnostics);
-  const verdict = getVerdict(healthScore, diagnostics);
-  
-  return {
-    total,
-    passed,
-    info,
-    warnings,
-    errors,
-    critical,
-    healthScore,
-    verdict,
-  };
-}
-
-function generateJsonReport(diagnostics, projectPath, durationMs) {
-  const summary = createSummary(diagnostics);
-  
-  return {
-    version: REPORT_VERSION,
-    timestamp: new Date().toISOString(),
-    durationMs,
-    projectPath,
-    summary,
-    diagnostics: diagnostics.map(d => ({
-      id: d.id,
-      name: d.name,
-      category: d.category,
-      severity: d.severity,
-      message: d.message,
-      detail: d.detail,
-      durationMs: d.durationMs,
-      fixes: d.fixes,
-      metadata: d.metadata,
-    })),
-  };
-}
-
-function generateMarkdownReport(diagnostics, projectPath, durationMs) {
-  const summary = createSummary(diagnostics);
-  const lines = [];
-  
-  lines.push('# 🩺 Vibecheck Doctor Report');
-  lines.push('');
-  lines.push(`**Project:** \`${projectPath}\`  `);
-  lines.push(`**Generated:** ${new Date().toISOString()}  `);
-  lines.push(`**Duration:** ${(durationMs / 1000).toFixed(1)}s`);
-  lines.push('');
-  
-  // Summary Box
-  lines.push('## Summary');
-  lines.push('');
-  lines.push(`| Metric | Value |`);
-  lines.push(`|--------|-------|`);
-  lines.push(`| Health Score | **${summary.healthScore}%** |`);
-  lines.push(`| Verdict | **${summary.verdict}** |`);
-  lines.push(`| Total Checks | ${summary.total} |`);
-  lines.push(`| ✓ Passed | ${summary.passed} |`);
-  lines.push(`| ℹ Info | ${summary.info} |`);
-  lines.push(`| ⚠ Warnings | ${summary.warnings} |`);
-  lines.push(`| ✗ Errors | ${summary.errors} |`);
-  lines.push(`| 🔴 Critical | ${summary.critical} |`);
-  lines.push('');
-  
-  // Group by category
-  const byCategory = {};
-  for (const d of diagnostics) {
-    if (!byCategory[d.category]) byCategory[d.category] = [];
-    byCategory[d.category].push(d);
-  }
-  
-  // Sort categories by order
-  const sortedCategories = Object.keys(byCategory).sort((a, b) => {
-    const orderA = CATEGORY_META[a]?.order || 99;
-    const orderB = CATEGORY_META[b]?.order || 99;
-    return orderA - orderB;
-  });
-  
-  lines.push('## Diagnostics');
-  lines.push('');
-  
-  for (const category of sortedCategories) {
-    const meta = CATEGORY_META[category] || { name: category, icon: '📋' };
-    lines.push(`### ${meta.icon} ${meta.name}`);
-    lines.push('');
-    
-    for (const d of byCategory[category]) {
-      const icon = {
-        [SEVERITY.PASS]: '✓',
-        [SEVERITY.INFO]: 'ℹ',
-        [SEVERITY.WARNING]: '⚠',
-        [SEVERITY.ERROR]: '✗',
-        [SEVERITY.CRITICAL]: '🔴',
-      }[d.severity] || '•';
-      
-      lines.push(`- ${icon} **${d.name}**: ${d.message}`);
-      
-      if (d.detail) {
-        lines.push(`  - ${d.detail}`);
-      }
-      
-      if (d.fixes && d.fixes.length > 0) {
-        for (const fix of d.fixes) {
-          if (fix.command) {
-            lines.push(`  - Fix: \`${fix.command}\``);
-          } else if (fix.url) {
-            lines.push(`  - [${fix.description}](${fix.url})`);
-          } else if (fix.description) {
-            lines.push(`  - Fix: ${fix.description}`);
-          }
-        }
-      }
-    }
-    lines.push('');
-  }
-  
-  // Issues section
-  const issues = diagnostics.filter(d => 
-    d.severity === SEVERITY.CRITICAL || 
-    d.severity === SEVERITY.ERROR || 
-    d.severity === SEVERITY.WARNING
-  );
-  
-  if (issues.length > 0) {
-    lines.push('## Issues to Fix');
-    lines.push('');
-    
-    const critical = issues.filter(d => d.severity === SEVERITY.CRITICAL);
-    const errors = issues.filter(d => d.severity === SEVERITY.ERROR);
-    const warnings = issues.filter(d => d.severity === SEVERITY.WARNING);
-    
-    if (critical.length > 0) {
-      lines.push('### 🔴 Critical');
-      for (const d of critical) {
-        lines.push(`1. **${d.name}**: ${d.message}`);
-        if (d.fixes?.[0]?.command) {
-          lines.push(`   \`\`\`bash`);
-          lines.push(`   ${d.fixes[0].command}`);
-          lines.push(`   \`\`\``);
-        }
-      }
-      lines.push('');
-    }
-    
-    if (errors.length > 0) {
-      lines.push('### ✗ Errors');
-      for (const d of errors) {
-        lines.push(`1. **${d.name}**: ${d.message}`);
-        if (d.fixes?.[0]?.command) {
-          lines.push(`   \`\`\`bash`);
-          lines.push(`   ${d.fixes[0].command}`);
-          lines.push(`   \`\`\``);
-        }
-      }
-      lines.push('');
-    }
-    
-    if (warnings.length > 0) {
-      lines.push('### ⚠ Warnings');
-      for (const d of warnings) {
-        lines.push(`1. **${d.name}**: ${d.message}`);
-        if (d.fixes?.[0]?.command) {
-          lines.push(`   \`\`\`bash`);
-          lines.push(`   ${d.fixes[0].command}`);
-          lines.push(`   \`\`\``);
-        }
-      }
-      lines.push('');
-    }
-  }
-  
-  lines.push('---');
-  lines.push(`*Generated by vibecheck doctor v${REPORT_VERSION}*`);
-  
-  return lines.join('\n');
-}
-
-function saveReports(diagnostics, projectPath, durationMs, outputDir) {
-  const jsonReport = generateJsonReport(diagnostics, projectPath, durationMs);
-  const mdReport = generateMarkdownReport(diagnostics, projectPath, durationMs);
-  
-  // Ensure output directory exists
-  const doctorDir = path.join(outputDir, 'doctor');
-  fs.mkdirSync(doctorDir, { recursive: true });
-  
-  // Save timestamped reports
-  const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
-  const jsonPath = path.join(doctorDir, `doctor_${timestamp}.json`);
-  const mdPath = path.join(doctorDir, `doctor_${timestamp}.md`);
-  
-  fs.writeFileSync(jsonPath, JSON.stringify(jsonReport, null, 2));
-  fs.writeFileSync(mdPath, mdReport);
-  
-  // Save stable pointers
-  const lastJsonPath = path.join(doctorDir, 'last_doctor.json');
-  const lastMdPath = path.join(doctorDir, 'last_doctor.md');
-  
-  fs.writeFileSync(lastJsonPath, JSON.stringify(jsonReport, null, 2));
-  fs.writeFileSync(lastMdPath, mdReport);
-  
-  return {
-    json: jsonPath,
-    md: mdPath,
-    lastJson: lastJsonPath,
-    lastMd: lastMdPath,
-  };
-}
-
-module.exports = {
-  REPORT_VERSION,
-  calculateHealthScore,
-  getVerdict,
-  createSummary,
-  generateJsonReport,
-  generateMarkdownReport,
-  saveReports,
-};
+/**
+ * Doctor Report Generator
+ * 
+ * Generates JSON and Markdown reports from diagnostic results
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { SEVERITY, SEVERITY_WEIGHT, CATEGORY_META } = require('./types');
+
+const REPORT_VERSION = '2.0.0';
+
+function calculateHealthScore(diagnostics) {
+  if (diagnostics.length === 0) return 100;
+  
+  let weightedSum = 0;
+  let totalWeight = 0;
+  
+  for (const d of diagnostics) {
+    const weight = d.category === 'security' ? 2 : 1; // Security issues count more
+    weightedSum += (SEVERITY_WEIGHT[d.severity] || 1) * weight;
+    totalWeight += weight;
+  }
+  
+  return Math.round((weightedSum / totalWeight) * 100);
+}
+
+function getVerdict(healthScore, diagnostics) {
+  const criticalCount = diagnostics.filter(d => d.severity === SEVERITY.CRITICAL).length;
+  const errorCount = diagnostics.filter(d => d.severity === SEVERITY.ERROR).length;
+  
+  if (criticalCount > 0) return 'CRITICAL';
+  if (errorCount > 0) return 'UNHEALTHY';
+  if (healthScore < 80) return 'DEGRADED';
+  return 'HEALTHY';
+}
+
+function createSummary(diagnostics) {
+  const total = diagnostics.length;
+  const passed = diagnostics.filter(d => d.severity === SEVERITY.PASS).length;
+  const info = diagnostics.filter(d => d.severity === SEVERITY.INFO).length;
+  const warnings = diagnostics.filter(d => d.severity === SEVERITY.WARNING).length;
+  const errors = diagnostics.filter(d => d.severity === SEVERITY.ERROR).length;
+  const critical = diagnostics.filter(d => d.severity === SEVERITY.CRITICAL).length;
+  
+  const healthScore = calculateHealthScore(diagnostics);
+  const verdict = getVerdict(healthScore, diagnostics);
+  
+  return {
+    total,
+    passed,
+    info,
+    warnings,
+    errors,
+    critical,
+    healthScore,
+    verdict,
+  };
+}
+
+function generateJsonReport(diagnostics, projectPath, durationMs) {
+  const summary = createSummary(diagnostics);
+  
+  return {
+    version: REPORT_VERSION,
+    timestamp: new Date().toISOString(),
+    durationMs,
+    projectPath,
+    summary,
+    diagnostics: diagnostics.map(d => ({
+      id: d.id,
+      name: d.name,
+      category: d.category,
+      severity: d.severity,
+      message: d.message,
+      detail: d.detail,
+      durationMs: d.durationMs,
+      fixes: d.fixes,
+      metadata: d.metadata,
+    })),
+  };
+}
+
+function generateMarkdownReport(diagnostics, projectPath, durationMs) {
+  const summary = createSummary(diagnostics);
+  const lines = [];
+  
+  lines.push('# 🩺 Vibecheck Doctor Report');
+  lines.push('');
+  lines.push(`**Project:** \`${projectPath}\`  `);
+  lines.push(`**Generated:** ${new Date().toISOString()}  `);
+  lines.push(`**Duration:** ${(durationMs / 1000).toFixed(1)}s`);
+  lines.push('');
+  
+  // Summary Box
+  lines.push('## Summary');
+  lines.push('');
+  lines.push(`| Metric | Value |`);
+  lines.push(`|--------|-------|`);
+  lines.push(`| Health Score | **${summary.healthScore}%** |`);
+  lines.push(`| Verdict | **${summary.verdict}** |`);
+  lines.push(`| Total Checks | ${summary.total} |`);
+  lines.push(`| ✓ Passed | ${summary.passed} |`);
+  lines.push(`| ℹ Info | ${summary.info} |`);
+  lines.push(`| ⚠ Warnings | ${summary.warnings} |`);
+  lines.push(`| ✗ Errors | ${summary.errors} |`);
+  lines.push(`| 🔴 Critical | ${summary.critical} |`);
+  lines.push('');
+  
+  // Group by category
+  const byCategory = {};
+  for (const d of diagnostics) {
+    if (!byCategory[d.category]) byCategory[d.category] = [];
+    byCategory[d.category].push(d);
+  }
+  
+  // Sort categories by order
+  const sortedCategories = Object.keys(byCategory).sort((a, b) => {
+    const orderA = CATEGORY_META[a]?.order || 99;
+    const orderB = CATEGORY_META[b]?.order || 99;
+    return orderA - orderB;
+  });
+  
+  lines.push('## Diagnostics');
+  lines.push('');
+  
+  for (const category of sortedCategories) {
+    const meta = CATEGORY_META[category] || { name: category, icon: '📋' };
+    lines.push(`### ${meta.icon} ${meta.name}`);
+    lines.push('');
+    
+    for (const d of byCategory[category]) {
+      const icon = {
+        [SEVERITY.PASS]: '✓',
+        [SEVERITY.INFO]: 'ℹ',
+        [SEVERITY.WARNING]: '⚠',
+        [SEVERITY.ERROR]: '✗',
+        [SEVERITY.CRITICAL]: '🔴',
+      }[d.severity] || '•';
+      
+      lines.push(`- ${icon} **${d.name}**: ${d.message}`);
+      
+      if (d.detail) {
+        lines.push(`  - ${d.detail}`);
+      }
+      
+      if (d.fixes && d.fixes.length > 0) {
+        for (const fix of d.fixes) {
+          if (fix.command) {
+            lines.push(`  - Fix: \`${fix.command}\``);
+          } else if (fix.url) {
+            lines.push(`  - [${fix.description}](${fix.url})`);
+          } else if (fix.description) {
+            lines.push(`  - Fix: ${fix.description}`);
+          }
+        }
+      }
+    }
+    lines.push('');
+  }
+  
+  // Issues section
+  const issues = diagnostics.filter(d => 
+    d.severity === SEVERITY.CRITICAL || 
+    d.severity === SEVERITY.ERROR || 
+    d.severity === SEVERITY.WARNING
+  );
+  
+  if (issues.length > 0) {
+    lines.push('## Issues to Fix');
+    lines.push('');
+    
+    const critical = issues.filter(d => d.severity === SEVERITY.CRITICAL);
+    const errors = issues.filter(d => d.severity === SEVERITY.ERROR);
+    const warnings = issues.filter(d => d.severity === SEVERITY.WARNING);
+    
+    if (critical.length > 0) {
+      lines.push('### 🔴 Critical');
+      for (const d of critical) {
+        lines.push(`1. **${d.name}**: ${d.message}`);
+        if (d.fixes?.[0]?.command) {
+          lines.push(`   \`\`\`bash`);
+          lines.push(`   ${d.fixes[0].command}`);
+          lines.push(`   \`\`\``);
+        }
+      }
+      lines.push('');
+    }
+    
+    if (errors.length > 0) {
+      lines.push('### ✗ Errors');
+      for (const d of errors) {
+        lines.push(`1. **${d.name}**: ${d.message}`);
+        if (d.fixes?.[0]?.command) {
+          lines.push(`   \`\`\`bash`);
+          lines.push(`   ${d.fixes[0].command}`);
+          lines.push(`   \`\`\``);
+        }
+      }
+      lines.push('');
+    }
+    
+    if (warnings.length > 0) {
+      lines.push('### ⚠ Warnings');
+      for (const d of warnings) {
+        lines.push(`1. **${d.name}**: ${d.message}`);
+        if (d.fixes?.[0]?.command) {
+          lines.push(`   \`\`\`bash`);
+          lines.push(`   ${d.fixes[0].command}`);
+          lines.push(`   \`\`\``);
+        }
+      }
+      lines.push('');
+    }
+  }
+  
+  lines.push('---');
+  lines.push(`*Generated by vibecheck doctor v${REPORT_VERSION}*`);
+  
+  return lines.join('\n');
+}
+
+function saveReports(diagnostics, projectPath, durationMs, outputDir) {
+  const jsonReport = generateJsonReport(diagnostics, projectPath, durationMs);
+  const mdReport = generateMarkdownReport(diagnostics, projectPath, durationMs);
+  
+  // Ensure output directory exists
+  const doctorDir = path.join(outputDir, 'doctor');
+  fs.mkdirSync(doctorDir, { recursive: true });
+  
+  // Save timestamped reports
+  const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
+  const jsonPath = path.join(doctorDir, `doctor_${timestamp}.json`);
+  const mdPath = path.join(doctorDir, `doctor_${timestamp}.md`);
+  
+  fs.writeFileSync(jsonPath, JSON.stringify(jsonReport, null, 2));
+  fs.writeFileSync(mdPath, mdReport);
+  
+  // Save stable pointers
+  const lastJsonPath = path.join(doctorDir, 'last_doctor.json');
+  const lastMdPath = path.join(doctorDir, 'last_doctor.md');
+  
+  fs.writeFileSync(lastJsonPath, JSON.stringify(jsonReport, null, 2));
+  fs.writeFileSync(lastMdPath, mdReport);
+  
+  return {
+    json: jsonPath,
+    md: mdPath,
+    lastJson: lastJsonPath,
+    lastMd: lastMdPath,
+  };
+}
+
+module.exports = {
+  REPORT_VERSION,
+  calculateHealthScore,
+  getVerdict,
+  createSummary,
+  generateJsonReport,
+  generateMarkdownReport,
+  saveReports,
+};