@vibecheckai/cli 3.1.2 → 3.1.4

package/bin/runners/lib/ship-output.js

@@ -0,0 +1,641 @@
+/**
+ * Ship Output - Premium Ship Command Display
+ * 
+ * Handles all ship-specific output formatting:
+ * - Verdict card (the hero moment)
+ * - Proof graph visualization
+ * - Findings breakdown by category
+ * - Fix mode display
+ * - Badge generation
+ */
+
+const path = require('path');
+const {
+  ansi,
+  colors,
+  box,
+  icons,
+  renderSection,
+  formatDuration,
+  truncate,
+} = require('./terminal-ui');
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// SHIP-SPECIFIC ICONS
+// ═══════════════════════════════════════════════════════════════════════════════
+
+const shipIcons = {
+  ship: '🚀',
+  sparkle: '✨',
+  fire: '🔥',
+  lock: '🔐',
+  key: '🔑',
+  link: '🔗',
+  graph: '📊',
+  map: '🗺️',
+  doc: '📄',
+  folder: '📁',
+  clock: '⏱',
+  target: '🎯',
+  shield: '🛡️',
+  bug: '🐛',
+  wrench: '🔧',
+  lightning: '⚡',
+  package: '📦',
+  route: '🛤️',
+  env: '🌍',
+  auth: '🔒',
+  money: '💰',
+  ghost: '👻',
+  dead: '💀',
+};
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// VERDICT CONFIGURATION
+// ═══════════════════════════════════════════════════════════════════════════════
+
+function getVerdictConfig(verdict, score, blockers = 0, warnings = 0) {
+  if (verdict === 'SHIP' || (score >= 90 && blockers === 0)) {
+    return {
+      verdict: 'SHIP',
+      icon: '🚀',
+      headline: 'CLEAR TO SHIP',
+      tagline: 'Your app is production ready!',
+      color: colors.success,
+      borderColor: ansi.rgb(0, 200, 120),
+      bgColor: ansi.bgRgb(0, 60, 40),
+    };
+  }
+  
+  if (verdict === 'WARN' || (score >= 50 && blockers <= 2)) {
+    return {
+      verdict: 'WARN',
+      icon: '⚠️',
+      headline: 'REVIEW BEFORE SHIP',
+      tagline: `${warnings} warning${warnings !== 1 ? 's' : ''} to address`,
+      color: colors.warning,
+      borderColor: ansi.rgb(200, 160, 0),
+      bgColor: ansi.bgRgb(60, 50, 0),
+    };
+  }
+  
+  return {
+    verdict: 'BLOCK',
+    icon: '🛑',
+    headline: 'NOT SHIP READY',
+    tagline: `${blockers} blocker${blockers !== 1 ? 's' : ''} must be fixed`,
+    color: colors.error,
+    borderColor: ansi.rgb(200, 60, 60),
+    bgColor: ansi.bgRgb(60, 20, 20),
+  };
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// VERDICT CARD - THE HERO MOMENT
+// ═══════════════════════════════════════════════════════════════════════════════
+
+function renderVerdictCard(options = {}) {
+  const {
+    verdict = 'WARN',
+    score = 0,
+    blockers = 0,
+    warnings = 0,
+    duration = 0,
+    cached = false,
+  } = options;
+  
+  const config = getVerdictConfig(verdict, score, blockers, warnings);
+  const w = 68; // Inner width
+  
+  const lines = [];
+  lines.push('');
+  lines.push('');
+  
+  // Top border
+  lines.push(`  ${config.borderColor}${box.doubleTopLeft}${box.doubleHorizontal.repeat(w)}${box.doubleTopRight}${ansi.reset}`);
+  
+  // Empty line
+  lines.push(`  ${config.borderColor}${box.doubleVertical}${ansi.reset}${' '.repeat(w)}${config.borderColor}${box.doubleVertical}${ansi.reset}`);
+  
+  // Verdict icon and headline
+  const headlineText = `${config.icon}  ${config.headline}`;
+  const headlinePadded = padCenter(headlineText, w);
+  lines.push(`  ${config.borderColor}${box.doubleVertical}${ansi.reset}${config.color}${ansi.bold}${headlinePadded}${ansi.reset}${config.borderColor}${box.doubleVertical}${ansi.reset}`);
+  
+  // Tagline
+  const taglinePadded = padCenter(config.tagline, w);
+  lines.push(`  ${config.borderColor}${box.doubleVertical}${ansi.reset}${ansi.dim}${taglinePadded}${ansi.reset}${config.borderColor}${box.doubleVertical}${ansi.reset}`);
+  
+  // Empty line
+  lines.push(`  ${config.borderColor}${box.doubleVertical}${ansi.reset}${' '.repeat(w)}${config.borderColor}${box.doubleVertical}${ansi.reset}`);
+  
+  // Score bar
+  const scoreBar = renderProgressBar(score, 35, config.color);
+  const scoreLabel = `VIBE SCORE`;
+  const scoreValue = `${score}/100`;
+  const scoreLine = `     ${scoreLabel}  ${scoreBar}  ${config.color}${ansi.bold}${scoreValue}${ansi.reset}`;
+  const scoreLinePadRight = ' '.repeat(Math.max(0, w - stripAnsi(scoreLine).length + 4));
+  lines.push(`  ${config.borderColor}${box.doubleVertical}${ansi.reset}${scoreLine}${scoreLinePadRight}${config.borderColor}${box.doubleVertical}${ansi.reset}`);
+  
+  // Empty line
+  lines.push(`  ${config.borderColor}${box.doubleVertical}${ansi.reset}${' '.repeat(w)}${config.borderColor}${box.doubleVertical}${ansi.reset}`);
+  
+  // Stats row
+  const blockerColor = blockers > 0 ? colors.error : colors.success;
+  const warningColor = warnings > 0 ? colors.warning : colors.success;
+  const statsLine = `     ${ansi.dim}Blockers:${ansi.reset} ${blockerColor}${ansi.bold}${blockers}${ansi.reset}    ${ansi.dim}Warnings:${ansi.reset} ${warningColor}${ansi.bold}${warnings}${ansi.reset}    ${ansi.dim}Duration:${ansi.reset} ${colors.accent}${ansi.bold}${formatDuration(duration)}${ansi.reset}${cached ? `  ${ansi.dim}(cached)${ansi.reset}` : ''}`;
+  const statsLinePadRight = ' '.repeat(Math.max(0, w - stripAnsi(statsLine).length + 4));
+  lines.push(`  ${config.borderColor}${box.doubleVertical}${ansi.reset}${statsLine}${statsLinePadRight}${config.borderColor}${box.doubleVertical}${ansi.reset}`);
+  
+  // Empty line
+  lines.push(`  ${config.borderColor}${box.doubleVertical}${ansi.reset}${' '.repeat(w)}${config.borderColor}${box.doubleVertical}${ansi.reset}`);
+  
+  // Bottom border
+  lines.push(`  ${config.borderColor}${box.doubleBottomLeft}${box.doubleHorizontal.repeat(w)}${box.doubleBottomRight}${ansi.reset}`);
+  
+  lines.push('');
+  return lines.join('\n');
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// PROOF GRAPH VISUALIZATION
+// ═══════════════════════════════════════════════════════════════════════════════
+
+function renderProofGraph(proofGraph) {
+  if (!proofGraph || !proofGraph.summary) return '';
+  
+  const lines = [];
+  lines.push(renderSection('PROOF GRAPH', shipIcons.graph));
+  lines.push('');
+  
+  const { summary } = proofGraph;
+  
+  // Confidence gauge
+  const confidence = Math.round((summary.confidence || 0) * 100);
+  const confColor = confidence >= 80 ? colors.success : confidence >= 50 ? colors.warning : colors.error;
+  
+  lines.push(`  ${ansi.bold}Analysis Confidence${ansi.reset}`);
+  lines.push(`  ${renderProgressBar(confidence, 40, confColor)} ${confColor}${ansi.bold}${confidence}%${ansi.reset}`);
+  lines.push('');
+  
+  // Claims summary
+  const verified = summary.verifiedClaims || 0;
+  const failed = summary.failedClaims || 0;
+  const total = summary.totalClaims || 0;
+  
+  lines.push(`  ${ansi.dim}Claims:${ansi.reset} ${colors.success}${verified}${ansi.reset} verified ${ansi.dim}/${ansi.reset} ${colors.error}${failed}${ansi.reset} failed ${ansi.dim}of${ansi.reset} ${total} total`);
+  lines.push(`  ${ansi.dim}Gaps:${ansi.reset} ${summary.gaps || 0} identified`);
+  lines.push(`  ${ansi.dim}Risk Score:${ansi.reset} ${summary.riskScore || 0}/100`);
+  
+  // Top blockers
+  if (proofGraph.topBlockers && proofGraph.topBlockers.length > 0) {
+    lines.push('');
+    lines.push(`  ${ansi.bold}Top Unverified Claims:${ansi.reset}`);
+    for (const blocker of proofGraph.topBlockers.slice(0, 3)) {
+      lines.push(`    ${colors.error}${icons.error}${ansi.reset} ${truncate(blocker.assertion, 50)}`);
+    }
+  }
+  
+  return lines.join('\n');
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// ROUTE TRUTH MAP
+// ═══════════════════════════════════════════════════════════════════════════════
+
+function renderRouteTruthMap(truthpack) {
+  if (!truthpack) return '';
+  
+  const lines = [];
+  lines.push(renderSection('ROUTE TRUTH MAP', shipIcons.map));
+  lines.push('');
+  
+  const serverRoutes = truthpack.routes?.server?.length || 0;
+  const clientRefs = truthpack.routes?.clientRefs?.length || 0;
+  const envVars = truthpack.env?.vars?.length || 0;
+  const envDeclared = truthpack.env?.declared?.length || 0;
+  
+  // Routes coverage
+  const routeCoverage = serverRoutes > 0 ? Math.round((clientRefs / serverRoutes) * 100) : 100;
+  const routeColor = routeCoverage >= 80 ? colors.success : routeCoverage >= 50 ? colors.warning : colors.error;
+  
+  lines.push(`  ${shipIcons.route} ${ansi.bold}Routes${ansi.reset}`);
+  lines.push(`     Server: ${colors.accent}${serverRoutes}${ansi.reset} defined`);
+  lines.push(`     Client: ${colors.accent}${clientRefs}${ansi.reset} references`);
+  lines.push(`     Coverage: ${renderProgressBar(routeCoverage, 20, routeColor)} ${routeColor}${routeCoverage}%${ansi.reset}`);
+  lines.push('');
+  
+  // Env coverage
+  const envCoverage = envVars > 0 ? Math.round((envDeclared / envVars) * 100) : 100;
+  const envColor = envCoverage >= 80 ? colors.success : envCoverage >= 50 ? colors.warning : colors.error;
+  
+  lines.push(`  ${shipIcons.env} ${ansi.bold}Environment${ansi.reset}`);
+  lines.push(`     Used: ${colors.accent}${envVars}${ansi.reset} variables`);
+  lines.push(`     Declared: ${colors.accent}${envDeclared}${ansi.reset} in .env`);
+  lines.push(`     Coverage: ${renderProgressBar(envCoverage, 20, envColor)} ${envColor}${envCoverage}%${ansi.reset}`);
+  
+  return lines.join('\n');
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// FINDINGS BREAKDOWN
+// ═══════════════════════════════════════════════════════════════════════════════
+
+function getCategoryIcon(category) {
+  const iconMap = {
+    'MissingRoute': shipIcons.route,
+    'EnvContract': shipIcons.env,
+    'EnvGap': shipIcons.env,
+    'FakeSuccess': shipIcons.ghost,
+    'GhostAuth': shipIcons.auth,
+    'StripeWebhook': shipIcons.money,
+    'PaidSurface': shipIcons.money,
+    'OwnerModeBypass': shipIcons.lock,
+    'DeadUI': shipIcons.dead,
+    'ContractDrift': icons.warning,
+    'Security': shipIcons.shield,
+    'Auth': shipIcons.lock,
+    'SECRET': shipIcons.key,
+    'ROUTE': shipIcons.route,
+    'BILLING': shipIcons.money,
+    'MOCK': shipIcons.ghost,
+  };
+  return iconMap[category] || shipIcons.bug;
+}
+
+function renderFindingsBreakdown(findings) {
+  if (!findings || findings.length === 0) {
+    const lines = [];
+    lines.push(renderSection('FINDINGS', icons.success));
+    lines.push('');
+    lines.push(`  ${colors.success}${ansi.bold}${shipIcons.sparkle} No issues found! Your code is clean.${ansi.reset}`);
+    return lines.join('\n');
+  }
+  
+  // Group by category
+  const byCategory = {};
+  for (const f of findings) {
+    const cat = f.category || 'Other';
+    if (!byCategory[cat]) byCategory[cat] = [];
+    byCategory[cat].push(f);
+  }
+  
+  const blockers = findings.filter(f => f.severity === 'BLOCK' || f.severity === 'critical');
+  const warnings = findings.filter(f => f.severity === 'WARN' || f.severity === 'warning');
+  
+  const lines = [];
+  lines.push(renderSection(`FINDINGS (${blockers.length} blockers, ${warnings.length} warnings)`, shipIcons.graph));
+  lines.push('');
+  
+  // Sort categories by severity
+  const categories = Object.entries(byCategory).sort((a, b) => {
+    const aBlockers = a[1].filter(f => f.severity === 'BLOCK' || f.severity === 'critical').length;
+    const bBlockers = b[1].filter(f => f.severity === 'BLOCK' || f.severity === 'critical').length;
+    return bBlockers - aBlockers;
+  });
+  
+  for (const [category, catFindings] of categories) {
+    const catBlockers = catFindings.filter(f => f.severity === 'BLOCK' || f.severity === 'critical').length;
+    const catWarnings = catFindings.filter(f => f.severity === 'WARN' || f.severity === 'warning').length;
+    const icon = getCategoryIcon(category);
+    
+    const statusColor = catBlockers > 0 ? colors.error : catWarnings > 0 ? colors.warning : colors.success;
+    const statusIcon = catBlockers > 0 ? icons.error : catWarnings > 0 ? icons.warning : icons.success;
+    
+    let stats = '';
+    if (catBlockers > 0) stats += `${colors.error}${catBlockers} blockers${ansi.reset}`;
+    if (catWarnings > 0) stats += `${stats ? ' ' : ''}${colors.warning}${catWarnings} warnings${ansi.reset}`;
+    
+    lines.push(`  ${statusColor}${statusIcon}${ansi.reset} ${icon} ${ansi.bold}${category.padEnd(20)}${ansi.reset} ${stats}`);
+  }
+  
+  return lines.join('\n');
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// BLOCKER DETAILS
+// ═══════════════════════════════════════════════════════════════════════════════
+
+function renderBlockerDetails(findings, maxShow = 8) {
+  const blockers = findings.filter(f => f.severity === 'BLOCK' || f.severity === 'critical');
+  
+  if (blockers.length === 0) return '';
+  
+  const lines = [];
+  lines.push(renderSection(`BLOCKERS (${blockers.length})`, '🚨'));
+  lines.push('');
+  
+  for (const blocker of blockers.slice(0, maxShow)) {
+    const icon = getCategoryIcon(blocker.category);
+    const severityBg = ansi.bgRgb(80, 20, 20);
+    
+    // Severity badge + title
+    lines.push(`  ${severityBg}${ansi.bold} BLOCKER ${ansi.reset} ${icon} ${ansi.bold}${truncate(blocker.title || blocker.message, 50)}${ansi.reset}`);
+    
+    // Why/description
+    if (blocker.why || blocker.description) {
+      lines.push(`             ${ansi.dim}${truncate(blocker.why || blocker.description, 55)}${ansi.reset}`);
+    }
+    
+    // File location
+    if (blocker.evidence && blocker.evidence.length > 0) {
+      const ev = blocker.evidence[0];
+      const file = ev.file || blocker.file;
+      if (file) {
+        const fileDisplay = `${path.basename(file)}${ev.lines ? `:${ev.lines}` : blocker.line ? `:${blocker.line}` : ''}`;
+        lines.push(`             ${colors.accent}${shipIcons.doc} ${fileDisplay}${ansi.reset}`);
+      }
+    } else if (blocker.file) {
+      const fileDisplay = `${path.basename(blocker.file)}${blocker.line ? `:${blocker.line}` : ''}`;
+      lines.push(`             ${colors.accent}${shipIcons.doc} ${fileDisplay}${ansi.reset}`);
+    }
+    
+    // Fix hint
+    if (blocker.fixHints && blocker.fixHints.length > 0) {
+      lines.push(`             ${colors.success}→ ${truncate(blocker.fixHints[0], 50)}${ansi.reset}`);
+    } else if (blocker.fix) {
+      lines.push(`             ${colors.success}→ ${truncate(blocker.fix, 50)}${ansi.reset}`);
+    }
+    
+    lines.push('');
+  }
+  
+  if (blockers.length > maxShow) {
+    lines.push(`  ${ansi.dim}... and ${blockers.length - maxShow} more blockers (see full report)${ansi.reset}`);
+    lines.push('');
+  }
+  
+  return lines.join('\n');
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// FIX MODE DISPLAY
+// ═══════════════════════════════════════════════════════════════════════════════
+
+function renderFixModeHeader() {
+  return `\n  ${ansi.bgRgb(40, 80, 120)}${ansi.bold}  ${shipIcons.wrench} AUTO-FIX MODE  ${ansi.reset}\n`;
+}
+
+function renderFixResults(fixResults) {
+  if (!fixResults) return '';
+  
+  const lines = [];
+  lines.push(renderSection('FIX RESULTS', shipIcons.wrench));
+  lines.push('');
+  
+  // Errors
+  if (fixResults.errors && fixResults.errors.length > 0) {
+    for (const err of fixResults.errors) {
+      lines.push(`  ${colors.error}${icons.error}${ansi.reset} ${err}`);
+    }
+    lines.push('');
+  }
+  
+  // Actions taken
+  const actions = [
+    { done: fixResults.envExampleCreated, label: 'Created .env.example', icon: shipIcons.env },
+    { done: fixResults.gitignoreUpdated, label: 'Updated .gitignore', icon: shipIcons.shield },
+    { done: fixResults.fixesMdCreated, label: 'Generated fixes.md', icon: shipIcons.doc },
+  ];
+  
+  for (const action of actions) {
+    const statusIcon = action.done ? `${colors.success}${icons.success}` : `${ansi.dim}•`;
+    const label = action.done ? `${ansi.reset}${action.label}` : `${ansi.dim}${action.label}${ansi.reset}`;
+    lines.push(`  ${statusIcon}${ansi.reset} ${action.icon} ${label}`);
+  }
+  
+  // Secrets found
+  if (fixResults.secretsFound && fixResults.secretsFound.length > 0) {
+    lines.push('');
+    lines.push(`  ${ansi.bold}Secrets to migrate:${ansi.reset}`);
+    for (const secret of fixResults.secretsFound.slice(0, 5)) {
+      lines.push(`    ${shipIcons.key} ${secret.varName} ${ansi.dim}(${secret.type})${ansi.reset}`);
+    }
+  }
+  
+  lines.push('');
+  lines.push(`  ${colors.success}${icons.success}${ansi.reset} ${ansi.bold}Safe fixes applied!${ansi.reset}`);
+  lines.push(`  ${ansi.dim}Review changes and follow instructions in ${colors.accent}.vibecheck/fixes.md${ansi.reset}`);
+  
+  return lines.join('\n');
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// BADGE OUTPUT
+// ═══════════════════════════════════════════════════════════════════════════════
+
+function renderBadgeOutput(projectPath, verdict, score) {
+  const projectName = path.basename(projectPath);
+  const projectId = projectName.toLowerCase().replace(/[^a-z0-9]/g, '-');
+  
+  const config = getVerdictConfig(verdict, score);
+  
+  const lines = [];
+  lines.push(renderSection('SHIP BADGE', '📛'));
+  lines.push('');
+  
+  // Badge preview
+  const badgeText = `vibecheck | ${verdict} | ${score}`;
+  lines.push(`  ${config.bgColor}${ansi.bold}  ${badgeText}  ${ansi.reset}`);
+  lines.push('');
+  
+  const badgeUrl = `https://vibecheck.dev/badge/${projectId}.svg`;
+  const reportUrl = `https://vibecheck.dev/report/${projectId}`;
+  const markdown = `[![Vibecheck](${badgeUrl})](${reportUrl})`;
+  
+  lines.push(`  ${ansi.dim}Badge URL:${ansi.reset}`);
+  lines.push(`  ${colors.accent}${badgeUrl}${ansi.reset}`);
+  lines.push('');
+  lines.push(`  ${ansi.dim}Report URL:${ansi.reset}`);
+  lines.push(`  ${colors.accent}${reportUrl}${ansi.reset}`);
+  lines.push('');
+  lines.push(`  ${ansi.dim}Add to README.md:${ansi.reset}`);
+  lines.push(`  ${colors.success}${markdown}${ansi.reset}`);
+  
+  return {
+    output: lines.join('\n'),
+    data: { projectId, badgeUrl, reportUrl, markdown },
+  };
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// NEXT STEPS
+// ═══════════════════════════════════════════════════════════════════════════════
+
+function renderNextSteps(canShip, hasFix = false) {
+  if (canShip) return '';
+  
+  const lines = [];
+  lines.push(renderSection('NEXT STEPS', shipIcons.lightning));
+  lines.push('');
+  
+  if (!hasFix) {
+    lines.push(`  ${colors.accent}vibecheck ship --fix${ansi.reset}     ${ansi.dim}Auto-fix what can be fixed${ansi.reset}`);
+  }
+  lines.push(`  ${colors.accent}vibecheck ship --assist${ansi.reset}  ${ansi.dim}Get AI help for complex issues${ansi.reset}`);
+  lines.push(`  ${colors.accent}vibecheck report${ansi.reset}         ${ansi.dim}Generate detailed HTML report${ansi.reset}`);
+  lines.push('');
+  
+  return lines.join('\n');
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// REPORT LINKS
+// ═══════════════════════════════════════════════════════════════════════════════
+
+function renderReportLinks(outputDir, hasFix = false) {
+  const lines = [];
+  lines.push(renderSection('REPORTS', shipIcons.doc));
+  lines.push('');
+  lines.push(`  ${colors.accent}vibecheck report${ansi.reset}              ${ansi.dim}Generate HTML report${ansi.reset}`);
+  lines.push(`  ${ansi.dim}${outputDir}/last_ship.json${ansi.reset}`);
+  if (hasFix) {
+    lines.push(`  ${colors.accent}${outputDir}/fixes.md${ansi.reset}`);
+  }
+  lines.push('');
+  return lines.join('\n');
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// FULL SHIP OUTPUT
+// ═══════════════════════════════════════════════════════════════════════════════
+
+function formatShipOutput(result, options = {}) {
+  const { verbose = false, showFix = false, showBadge = false, outputDir = '.vibecheck', projectPath = '.' } = options;
+  
+  const {
+    verdict,
+    score,
+    findings = [],
+    blockers = [],
+    warnings = [],
+    truthpack,
+    proofGraph,
+    fixResults,
+    duration = 0,
+    cached = false,
+  } = result;
+  
+  const lines = [];
+  
+  // Verdict card (hero moment)
+  lines.push(renderVerdictCard({
+    verdict,
+    score,
+    blockers: blockers.length || findings.filter(f => f.severity === 'BLOCK' || f.severity === 'critical').length,
+    warnings: warnings.length || findings.filter(f => f.severity === 'WARN' || f.severity === 'warning').length,
+    duration,
+    cached,
+  }));
+  
+  // Findings breakdown
+  lines.push(renderFindingsBreakdown(findings));
+  
+  // Blocker details
+  lines.push(renderBlockerDetails(findings));
+  
+  // Verbose: Route truth map
+  if (verbose && truthpack) {
+    lines.push('');
+    lines.push(renderRouteTruthMap(truthpack));
+  }
+  
+  // Verbose: Proof graph
+  if (verbose && proofGraph) {
+    lines.push('');
+    lines.push(renderProofGraph(proofGraph));
+  }
+  
+  // Fix results
+  if (showFix && fixResults) {
+    lines.push(renderFixResults(fixResults));
+  }
+  
+  // Badge (if requested)
+  if (showBadge) {
+    const badgeResult = renderBadgeOutput(projectPath, verdict, score);
+    lines.push(badgeResult.output);
+  }
+  
+  // Report links
+  lines.push(renderReportLinks(outputDir, showFix));
+  
+  // Next steps (if not shipping)
+  const canShip = verdict === 'SHIP';
+  lines.push(renderNextSteps(canShip, showFix));
+  
+  return lines.filter(Boolean).join('\n');
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// UTILITIES
+// ═══════════════════════════════════════════════════════════════════════════════
+
+function renderProgressBar(percent, width, color) {
+  const filled = Math.round((percent / 100) * width);
+  const empty = width - filled;
+  return `${color}${'█'.repeat(filled)}${ansi.dim}${'░'.repeat(empty)}${ansi.reset}`;
+}
+
+function padCenter(str, width) {
+  const visibleLen = stripAnsi(str).length;
+  const padding = Math.max(0, width - visibleLen);
+  const left = Math.floor(padding / 2);
+  const right = padding - left;
+  return ' '.repeat(left) + str + ' '.repeat(right);
+}
+
+function stripAnsi(str) {
+  return str.replace(/\x1b\[[0-9;]*m/g, '');
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// EXIT CODES
+// ═══════════════════════════════════════════════════════════════════════════════
+
+const EXIT_CODES = {
+  SHIP: 0,
+  WARN: 1,
+  BLOCK: 2,
+  ERROR: 3,
+};
+
+function getExitCode(verdict) {
+  return EXIT_CODES[verdict] || EXIT_CODES.ERROR;
+}
+
+function verdictFromExitCode(code) {
+  const map = { 0: 'SHIP', 1: 'WARN', 2: 'BLOCK', 3: 'ERROR' };
+  return map[code] || 'ERROR';
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// EXPORTS
+// ═══════════════════════════════════════════════════════════════════════════════
+
+module.exports = {
+  // Main formatters
+  formatShipOutput,
+  
+  // Component renderers
+  renderVerdictCard,
+  renderProofGraph,
+  renderRouteTruthMap,
+  renderFindingsBreakdown,
+  renderBlockerDetails,
+  renderFixModeHeader,
+  renderFixResults,
+  renderBadgeOutput,
+  renderNextSteps,
+  renderReportLinks,
+  
+  // Utilities
+  getVerdictConfig,
+  getCategoryIcon,
+  getExitCode,
+  verdictFromExitCode,
+  EXIT_CODES,
+  
+  // Icons
+  shipIcons,
+};