@vibecheckai/cli 3.7.0 → 3.8.0

package/bin/runners/lib/cleanup/output.js

@@ -0,0 +1,375 @@
+/**
+ * vibecheck polish --cleanup Output UX
+ * 
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * CLEANUP OUTPUT - Diff Summary & Risk Notes
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * 
+ * Beautiful, informative output for cleanup operations.
+ */
+
+"use strict";
+
+const path = require("path");
+const { CATEGORIES, RISK_LEVELS } = require("./rules");
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// TERMINAL STYLING
+// ═══════════════════════════════════════════════════════════════════════════════
+
+const SUPPORTS_COLOR = process.stdout.isTTY && !process.env.NO_COLOR;
+
+const c = SUPPORTS_COLOR ? {
+  reset: "\x1b[0m",
+  bold: "\x1b[1m",
+  dim: "\x1b[2m",
+  italic: "\x1b[3m",
+  underline: "\x1b[4m",
+  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",
+} : {
+  reset: "", bold: "", dim: "", italic: "", underline: "",
+  red: "", green: "", yellow: "", blue: "", magenta: "", cyan: "", white: "",
+  bgRed: "", bgGreen: "", bgYellow: "",
+};
+
+const icons = {
+  check: "✓",
+  cross: "✗",
+  warning: "⚠",
+  info: "ℹ",
+  arrow: "→",
+  bullet: "•",
+  sparkle: "✨",
+  broom: "🧹",
+  shield: "🛡️",
+  rocket: "🚀",
+  file: "📄",
+  folder: "📁",
+  trash: "🗑️",
+  clock: "⏱️",
+};
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// BANNER
+// ═══════════════════════════════════════════════════════════════════════════════
+
+function printBanner() {
+  console.log(`
+${c.bold}╔══════════════════════════════════════════════════════════════════════════════╗
+║                                                                              ║
+║   ${icons.broom} ${c.cyan}VIBECHECK POLISH - CLEANUP MODE${c.reset}${c.bold}                                      ║
+║   ${c.dim}Production-grade cleanup without chaos${c.reset}${c.bold}                                    ║
+║                                                                              ║
+╚══════════════════════════════════════════════════════════════════════════════╝${c.reset}
+`);
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// SUMMARY OUTPUT
+// ═══════════════════════════════════════════════════════════════════════════════
+
+function printAnalysisSummary(analysis, projectPath) {
+  console.log(`${c.bold}${icons.folder} PROJECT SCAN SUMMARY${c.reset}`);
+  console.log(`${"─".repeat(60)}`);
+  console.log(`   Path:          ${c.dim}${projectPath}${c.reset}`);
+  console.log(`   Files scanned: ${analysis.totalFiles}`);
+  console.log(`   Files with findings: ${analysis.filesWithFindings}`);
+  console.log(`   Total findings: ${c.bold}${analysis.totalFindings}${c.reset}`);
+  
+  if (analysis.truncated) {
+    console.log(`   ${c.yellow}${icons.warning} Scan limited to first 1000 files${c.reset}`);
+  }
+  console.log();
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// RISK ASSESSMENT OUTPUT
+// ═══════════════════════════════════════════════════════════════════════════════
+
+function printRiskAssessment(riskAssessment) {
+  console.log(`${c.bold}${icons.shield} RISK ASSESSMENT${c.reset}`);
+  console.log(`${"─".repeat(60)}`);
+  
+  // Risk score bar
+  const score = riskAssessment.score;
+  const barWidth = 30;
+  const filledWidth = Math.round((score / 100) * barWidth);
+  const emptyWidth = barWidth - filledWidth;
+  
+  let barColor = c.green;
+  if (score >= 50) barColor = c.red;
+  else if (score >= 25) barColor = c.yellow;
+  
+  const bar = barColor + "█".repeat(filledWidth) + c.dim + "░".repeat(emptyWidth) + c.reset;
+  
+  console.log(`   Risk Score: ${bar} ${c.bold}${score}/100${c.reset}`);
+  console.log(`   Risk Level: ${getRiskBadge(riskAssessment.level)}`);
+  console.log();
+  
+  // Breakdown
+  console.log(`   ${c.bold}Findings by Risk:${c.reset}`);
+  console.log(`     ${c.green}${icons.check} Safe:${c.reset}       ${riskAssessment.summary.safe} ${c.dim}(auto-fixable)${c.reset}`);
+  console.log(`     ${c.yellow}${icons.warning} Moderate:${c.reset}   ${riskAssessment.summary.moderate} ${c.dim}(review recommended)${c.reset}`);
+  console.log(`     ${c.red}${icons.cross} Aggressive:${c.reset} ${riskAssessment.summary.aggressive} ${c.dim}(requires --aggressive)${c.reset}`);
+  console.log();
+}
+
+function getRiskBadge(level) {
+  switch (level) {
+    case "low":
+      return `${c.bgGreen}${c.white} LOW ${c.reset}`;
+    case "moderate":
+      return `${c.bgYellow}${c.white} MODERATE ${c.reset}`;
+    case "high":
+      return `${c.bgRed}${c.white} HIGH ${c.reset}`;
+    default:
+      return level;
+  }
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// FINDINGS BY CATEGORY
+// ═══════════════════════════════════════════════════════════════════════════════
+
+function printFindingsByCategory(analysis, opts = {}) {
+  const { verbose = false, limit = 5 } = opts;
+  
+  console.log(`${c.bold}${icons.sparkle} FINDINGS BY CATEGORY${c.reset}`);
+  console.log(`${"─".repeat(60)}`);
+  
+  for (const [category, findings] of Object.entries(analysis.byCategory)) {
+    const catInfo = CATEGORIES[category] || { name: category, icon: "📌" };
+    
+    console.log(`\n   ${catInfo.icon} ${c.bold}${catInfo.name}${c.reset} ${c.dim}(${findings.length})${c.reset}`);
+    
+    const toShow = verbose ? findings : findings.slice(0, limit);
+    
+    for (const finding of toShow) {
+      const riskColor = finding.rule.riskLevel === "safe" ? c.green :
+                        finding.rule.riskLevel === "moderate" ? c.yellow : c.red;
+      
+      console.log(`     ${riskColor}${icons.bullet}${c.reset} ${finding.rule.name}`);
+      console.log(`       ${c.dim}${path.relative(process.cwd(), finding.file)}:${finding.line}${c.reset}`);
+      
+      if (verbose) {
+        console.log(`       ${c.dim}${finding.lineContent.substring(0, 60)}${finding.lineContent.length > 60 ? "..." : ""}${c.reset}`);
+      }
+    }
+    
+    if (!verbose && findings.length > limit) {
+      console.log(`     ${c.dim}... and ${findings.length - limit} more${c.reset}`);
+    }
+  }
+  console.log();
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// DIFF PREVIEW
+// ═══════════════════════════════════════════════════════════════════════════════
+
+function printDiffPreview(diffsResult, opts = {}) {
+  const { verbose = false, limit = 10 } = opts;
+  
+  if (diffsResult.filesChanged === 0) {
+    console.log(`${c.dim}No auto-fixable changes to apply.${c.reset}\n`);
+    return;
+  }
+  
+  console.log(`${c.bold}${icons.file} DIFF PREVIEW${c.reset}`);
+  console.log(`${"─".repeat(60)}`);
+  console.log(`   Files to modify: ${c.bold}${diffsResult.filesChanged}${c.reset}`);
+  console.log(`   Total changes:   ${c.bold}${diffsResult.totalChanges}${c.reset}`);
+  console.log();
+  
+  const toShow = verbose ? diffsResult.diffs : diffsResult.diffs.slice(0, limit);
+  
+  for (const diff of toShow) {
+    console.log(`   ${c.bold}${diff.relativePath}${c.reset} ${c.dim}(${diff.changes.length} changes)${c.reset}`);
+    
+    for (const change of diff.changes.slice(0, verbose ? 10 : 3)) {
+      console.log(`     Line ${change.line}:`);
+      console.log(`       ${c.red}- ${truncate(change.removed, 50)}${c.reset}`);
+      console.log(`       ${c.green}+ ${truncate(change.added || "(removed)", 50)}${c.reset}`);
+    }
+    
+    if (diff.changes.length > (verbose ? 10 : 3)) {
+      console.log(`     ${c.dim}... and ${diff.changes.length - (verbose ? 10 : 3)} more changes${c.reset}`);
+    }
+    console.log();
+  }
+  
+  if (!verbose && diffsResult.diffs.length > limit) {
+    console.log(`   ${c.dim}... and ${diffsResult.diffs.length - limit} more files${c.reset}\n`);
+  }
+}
+
+function truncate(str, maxLen) {
+  if (!str) return "";
+  const trimmed = str.trim().replace(/\s+/g, " ");
+  return trimmed.length > maxLen ? trimmed.substring(0, maxLen) + "..." : trimmed;
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// APPLY RESULTS
+// ═══════════════════════════════════════════════════════════════════════════════
+
+function printApplyResults(applyResult) {
+  console.log(`${c.bold}${icons.check} CHANGES APPLIED${c.reset}`);
+  console.log(`${"─".repeat(60)}`);
+  console.log(`   Files modified: ${c.green}${applyResult.applied.length}${c.reset}`);
+  
+  if (applyResult.failed.length > 0) {
+    console.log(`   Files failed:   ${c.red}${applyResult.failed.length}${c.reset}`);
+    for (const fail of applyResult.failed) {
+      console.log(`     ${c.red}${icons.cross}${c.reset} ${fail.file}: ${fail.error}`);
+    }
+  }
+  
+  console.log(`\n   ${c.bold}Backup saved to:${c.reset}`);
+  console.log(`   ${c.cyan}${applyResult.backupDir}${c.reset}`);
+  console.log();
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// ROLLBACK INFO
+// ═══════════════════════════════════════════════════════════════════════════════
+
+function printRollbackInfo(backupDir) {
+  console.log(`${c.bold}${icons.clock} ROLLBACK AVAILABLE${c.reset}`);
+  console.log(`${"─".repeat(60)}`);
+  console.log(`   To undo all changes, run:`);
+  console.log(`   ${c.cyan}vibecheck polish --rollback ${backupDir}${c.reset}`);
+  console.log();
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// AGGRESSIVE WARNING
+// ═══════════════════════════════════════════════════════════════════════════════
+
+function printAggressiveWarning(aggressiveFindings) {
+  if (aggressiveFindings.length === 0) return;
+  
+  console.log(`${c.yellow}${c.bold}${icons.warning} AGGRESSIVE TRANSFORMATIONS SKIPPED${c.reset}`);
+  console.log(`${"─".repeat(60)}`);
+  console.log(`   ${c.yellow}${aggressiveFindings.length} findings require --aggressive --yes-i-am-sure${c.reset}`);
+  console.log(`   ${c.dim}These could change program behavior and need manual review.${c.reset}`);
+  console.log();
+  
+  // Group by rule
+  const byRule = {};
+  for (const finding of aggressiveFindings) {
+    if (!byRule[finding.ruleId]) byRule[finding.ruleId] = [];
+    byRule[finding.ruleId].push(finding);
+  }
+  
+  for (const [ruleId, findings] of Object.entries(byRule)) {
+    const rule = findings[0].rule;
+    console.log(`   ${c.red}${icons.bullet}${c.reset} ${rule.name} (${findings.length})`);
+    console.log(`     ${c.dim}${rule.description}${c.reset}`);
+  }
+  console.log();
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// NEXT STEPS
+// ═══════════════════════════════════════════════════════════════════════════════
+
+function printNextSteps(analysis, diffsResult, opts = {}) {
+  const { applied = false, aggressive = false } = opts;
+  
+  console.log(`${c.bold}${icons.rocket} NEXT STEPS${c.reset}`);
+  console.log(`${"─".repeat(60)}`);
+  
+  if (!applied && diffsResult.filesChanged > 0) {
+    console.log(`   1. Review the diff preview above`);
+    console.log(`   2. Apply changes: ${c.cyan}vibecheck polish --cleanup --apply${c.reset}`);
+  } else if (applied) {
+    console.log(`   ${c.green}${icons.check}${c.reset} Changes applied successfully!`);
+    console.log(`   1. Run your tests: ${c.cyan}npm test${c.reset}`);
+    console.log(`   2. Review changes: ${c.cyan}git diff${c.reset}`);
+    console.log(`   3. If issues: ${c.cyan}vibecheck polish --rollback${c.reset}`);
+  }
+  
+  if (analysis.byRisk.aggressive.length > 0 && !aggressive) {
+    console.log(`\n   ${c.dim}For aggressive fixes (could change behavior):${c.reset}`);
+    console.log(`   ${c.cyan}vibecheck polish --cleanup --aggressive --yes-i-am-sure${c.reset}`);
+  }
+  
+  if (analysis.byRisk.moderate.length > 0) {
+    console.log(`\n   ${c.dim}Review moderate findings manually:${c.reset}`);
+    console.log(`   ${c.cyan}vibecheck polish --cleanup --verbose${c.reset}`);
+  }
+  
+  console.log();
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// JSON OUTPUT
+// ═══════════════════════════════════════════════════════════════════════════════
+
+function formatJsonOutput(analysis, diffsResult, riskAssessment, opts = {}) {
+  return {
+    summary: {
+      filesScanned: analysis.totalFiles,
+      filesWithFindings: analysis.filesWithFindings,
+      totalFindings: analysis.totalFindings,
+      truncated: analysis.truncated,
+    },
+    risk: riskAssessment,
+    findings: {
+      byRisk: {
+        safe: analysis.byRisk.safe.length,
+        moderate: analysis.byRisk.moderate.length,
+        aggressive: analysis.byRisk.aggressive.length,
+      },
+      byCategory: Object.fromEntries(
+        Object.entries(analysis.byCategory).map(([k, v]) => [k, v.length])
+      ),
+      details: analysis.findings.map(f => ({
+        ruleId: f.ruleId,
+        file: f.file,
+        line: f.line,
+        match: f.match,
+        riskLevel: f.rule.riskLevel,
+        category: f.rule.category,
+        autoFixable: f.rule.autoFixable,
+      })),
+    },
+    diffs: {
+      filesChanged: diffsResult.filesChanged,
+      totalChanges: diffsResult.totalChanges,
+      files: diffsResult.diffs.map(d => ({
+        file: d.relativePath,
+        changes: d.changes.length,
+      })),
+    },
+  };
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// EXPORTS
+// ═══════════════════════════════════════════════════════════════════════════════
+
+module.exports = {
+  printBanner,
+  printAnalysisSummary,
+  printRiskAssessment,
+  printFindingsByCategory,
+  printDiffPreview,
+  printApplyResults,
+  printRollbackInfo,
+  printAggressiveWarning,
+  printNextSteps,
+  formatJsonOutput,
+  c,
+  icons,
+};