@vibecheckai/cli 3.2.2 → 3.2.4

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

@@ -1,187 +1,187 @@
-/**
- * Report Output - Report Generation Display
- * 
- * Handles all report command output formatting:
- * - Report generation progress
- * - Format selection display
- * - Output file information
- * - Report type descriptions
- */
-
-const path = require('path');
-const {
-  ansi,
-  colors,
-  icons,
-  Spinner,
-  renderSection,
-  formatDuration,
-} = require('./terminal-ui');
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// REPORT-SPECIFIC ICONS
-// ═══════════════════════════════════════════════════════════════════════════════
-
-const reportIcons = {
-  report: '📄',
-  html: '🌐',
-  markdown: '📝',
-  json: '📊',
-  sarif: '🔒',
-  csv: '📈',
-  executive: '👔',
-  technical: '🔧',
-  compliance: '🛡️',
-  trend: '📈',
-  success: '✓',
-  error: '✗',
-};
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// BANNER
-// ═══════════════════════════════════════════════════════════════════════════════
-
-const BANNER = `
-${ansi.rgb(0, 200, 255)}  ██╗   ██╗██╗██████╗ ███████╗ ██████╗██╗  ██╗███████╗ ██████╗██╗  ██╗${ansi.reset}
-${ansi.rgb(30, 180, 255)}  ██║   ██║██║██╔══██╗██╔════╝██╔════╝██║  ██║██╔════╝██╔════╝██║ ██╔╝${ansi.reset}
-${ansi.rgb(60, 160, 255)}  ██║   ██║██║██████╔╝█████╗  ██║     ███████║█████╗  ██║     █████╔╝ ${ansi.reset}
-${ansi.rgb(90, 140, 255)}  ╚██╗ ██╔╝██║██╔══██╗██╔══╝  ██║     ██╔══██║██╔══╝  ██║     ██╔═██╗ ${ansi.reset}
-${ansi.rgb(120, 120, 255)}   ╚████╔╝ ██║██████╔╝███████╗╚██████╗██║  ██║███████╗╚██████╗██║  ██╗${ansi.reset}
-${ansi.rgb(150, 100, 255)}    ╚═══╝  ╚═╝╚═════╝ ╚══════╝ ╚═════╝╚═╝  ╚═╝╚══════╝ ╚═════╝╚═╝  ╚═╝${ansi.reset}
-
-${ansi.dim}  ┌─────────────────────────────────────────────────────────────────────┐${ansi.reset}
-${ansi.dim}  │${ansi.reset}  ${ansi.rgb(255, 255, 255)}${ansi.bold}Report Generator${ansi.reset} ${ansi.dim}•${ansi.reset} ${ansi.rgb(200, 200, 200)}Professional Reports${ansi.reset} ${ansi.dim}•${ansi.reset} ${ansi.rgb(150, 150, 150)}Multiple Formats${ansi.reset}  ${ansi.dim}│${ansi.reset}
-${ansi.dim}  └─────────────────────────────────────────────────────────────────────┘${ansi.reset}
-`;
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// REPORT TYPE DESCRIPTIONS
-// ═══════════════════════════════════════════════════════════════════════════════
-
-function getReportTypeDescription(type) {
-  const descriptions = {
-    executive: 'One-page overview for stakeholders',
-    technical: 'Detailed findings for developers/CTOs',
-    compliance: 'SOC2/HIPAA-ready language for regulated industries',
-    trend: 'Historical score analysis over time',
-  };
-  return descriptions[type] || 'Standard report';
-}
-
-function getFormatIcon(format) {
-  const iconMap = {
-    html: reportIcons.html,
-    md: reportIcons.markdown,
-    markdown: reportIcons.markdown,
-    json: reportIcons.json,
-    sarif: reportIcons.sarif,
-    csv: reportIcons.csv,
-  };
-  return iconMap[format] || reportIcons.report;
-}
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// REPORT GENERATION DISPLAY
-// ═══════════════════════════════════════════════════════════════════════════════
-
-function renderReportInfo(type, format, outputPath) {
-  const lines = [];
-  lines.push(renderSection('REPORT INFO', reportIcons.report));
-  lines.push('');
-  lines.push(`  Type:       ${colors.accent}${type}${ansi.reset} ${ansi.dim}(${getReportTypeDescription(type)})${ansi.reset}`);
-  lines.push(`  Format:     ${getFormatIcon(format)} ${colors.accent}${format.toUpperCase()}${ansi.reset}`);
-  if (outputPath) {
-    lines.push(`  Output:     ${colors.accent}${outputPath}${ansi.reset}`);
-  }
-  return lines.join('\n');
-}
-
-function renderSuccess(outputPath, format) {
-  const lines = [];
-  lines.push('');
-  lines.push(`  ${colors.success}${icons.success}${ansi.reset} ${ansi.bold}Report generated successfully!${ansi.reset}`);
-  lines.push('');
-  lines.push(`  ${ansi.dim}File:${ansi.reset} ${colors.accent}${outputPath}${ansi.reset}`);
-  if (format === 'html') {
-    lines.push(`  ${ansi.dim}Open:${ansi.reset} ${colors.accent}file://${path.resolve(outputPath)}${ansi.reset}`);
-  }
-  return lines.join('\n');
-}
-
-function renderError(error) {
-  const lines = [];
-  lines.push('');
-  lines.push(`  ${colors.error}${icons.error}${ansi.reset} ${ansi.bold}Report generation failed${ansi.reset}`);
-  lines.push(`  ${ansi.dim}${error.message}${ansi.reset}`);
-  return lines.join('\n');
-}
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// HELP TEXT
-// ═══════════════════════════════════════════════════════════════════════════════
-
-function formatHelp() {
-  return `
-  ${ansi.bold}Usage:${ansi.reset} vibecheck report [options]
-
-  ${ansi.bold}Description${ansi.reset}
-    Generate beautiful, professional reports for stakeholders.
-
-  ${ansi.bold}Report Types${ansi.reset}
-    ${colors.accent}technical${ansi.reset}    Detailed findings for developers/CTOs (default)
-    ${colors.accent}executive${ansi.reset}    One-page overview for stakeholders
-    ${colors.accent}compliance${ansi.reset}   SOC2/HIPAA-ready language for regulated industries
-    ${colors.accent}trend${ansi.reset}        Historical score analysis over time
-
-  ${ansi.bold}Output Formats${ansi.reset}
-    ${colors.success}html${ansi.reset}         Beautiful interactive report (default)
-    ${colors.success}md${ansi.reset}           Markdown for documentation/GitHub
-    ${colors.success}json${ansi.reset}         Machine-readable JSON
-    ${colors.success}sarif${ansi.reset}        SARIF for security tool integration
-    ${colors.success}csv${ansi.reset}         CSV for spreadsheet analysis
-
-  ${ansi.bold}Options${ansi.reset}
-    ${colors.accent}--type, -t <type>${ansi.reset}       Report type: executive, technical, compliance, trend
-    ${colors.accent}--format, -f <format>${ansi.reset}   Output format: html, md, json, sarif, csv
-    ${colors.accent}--output, -o <path>${ansi.reset}     Output file path
-    ${colors.accent}--theme <dark|light>${ansi.reset}    HTML theme (default: dark)
-    ${colors.accent}--company <name>${ansi.reset}        Company name for branding
-    ${colors.accent}--logo <path>${ansi.reset}           Custom logo path/URL
-    ${colors.accent}--include-trends${ansi.reset}        Include historical trend data
-    ${colors.accent}--redact-paths${ansi.reset}          Hide file paths for client reports
-    ${colors.accent}--max-findings <n>${ansi.reset}      Max findings to show (default: 50)
-    ${colors.accent}--path, -p <dir>${ansi.reset}        Project path (default: current directory)
-    ${colors.accent}--help, -h${ansi.reset}              Show this help
-
-  ${ansi.bold}Examples${ansi.reset}
-    ${ansi.dim}# Interactive HTML${ansi.reset}
-    vibecheck report
-
-    ${ansi.dim}# Markdown file${ansi.reset}
-    vibecheck report --format=md --output=REPORT.md
-
-    ${ansi.dim}# Compliance report${ansi.reset}
-    vibecheck report --type=compliance --company=Acme
-
-    ${ansi.dim}# Security tooling${ansi.reset}
-    vibecheck report --format=sarif -o report.sarif
-
-    ${ansi.dim}# Client-safe HTML${ansi.reset}
-    vibecheck report --theme=light --redact
-`;
-}
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// EXPORTS
-// ═══════════════════════════════════════════════════════════════════════════════
-
-module.exports = {
-  BANNER,
-  formatHelp,
-  renderReportInfo,
-  renderSuccess,
-  renderError,
-  getReportTypeDescription,
-  getFormatIcon,
-  reportIcons,
-};
+/**
+ * Report Output - Report Generation Display
+ * 
+ * Handles all report command output formatting:
+ * - Report generation progress
+ * - Format selection display
+ * - Output file information
+ * - Report type descriptions
+ */
+
+const path = require('path');
+const {
+  ansi,
+  colors,
+  icons,
+  Spinner,
+  renderSection,
+  formatDuration,
+} = require('./terminal-ui');
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// REPORT-SPECIFIC ICONS
+// ═══════════════════════════════════════════════════════════════════════════════
+
+const reportIcons = {
+  report: '📄',
+  html: '🌐',
+  markdown: '📝',
+  json: '📊',
+  sarif: '🔒',
+  csv: '📈',
+  executive: '👔',
+  technical: '🔧',
+  compliance: '🛡️',
+  trend: '📈',
+  success: '✓',
+  error: '✗',
+};
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// BANNER
+// ═══════════════════════════════════════════════════════════════════════════════
+
+const BANNER = `
+${ansi.rgb(0, 200, 255)}  ██╗   ██╗██╗██████╗ ███████╗ ██████╗██╗  ██╗███████╗ ██████╗██╗  ██╗${ansi.reset}
+${ansi.rgb(30, 180, 255)}  ██║   ██║██║██╔══██╗██╔════╝██╔════╝██║  ██║██╔════╝██╔════╝██║ ██╔╝${ansi.reset}
+${ansi.rgb(60, 160, 255)}  ██║   ██║██║██████╔╝█████╗  ██║     ███████║█████╗  ██║     █████╔╝ ${ansi.reset}
+${ansi.rgb(90, 140, 255)}  ╚██╗ ██╔╝██║██╔══██╗██╔══╝  ██║     ██╔══██║██╔══╝  ██║     ██╔═██╗ ${ansi.reset}
+${ansi.rgb(120, 120, 255)}   ╚████╔╝ ██║██████╔╝███████╗╚██████╗██║  ██║███████╗╚██████╗██║  ██╗${ansi.reset}
+${ansi.rgb(150, 100, 255)}    ╚═══╝  ╚═╝╚═════╝ ╚══════╝ ╚═════╝╚═╝  ╚═╝╚══════╝ ╚═════╝╚═╝  ╚═╝${ansi.reset}
+
+${ansi.dim}  ┌─────────────────────────────────────────────────────────────────────┐${ansi.reset}
+${ansi.dim}  │${ansi.reset}  ${ansi.rgb(255, 255, 255)}${ansi.bold}Report Generator${ansi.reset} ${ansi.dim}•${ansi.reset} ${ansi.rgb(200, 200, 200)}Professional Reports${ansi.reset} ${ansi.dim}•${ansi.reset} ${ansi.rgb(150, 150, 150)}Multiple Formats${ansi.reset}  ${ansi.dim}│${ansi.reset}
+${ansi.dim}  └─────────────────────────────────────────────────────────────────────┘${ansi.reset}
+`;
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// REPORT TYPE DESCRIPTIONS
+// ═══════════════════════════════════════════════════════════════════════════════
+
+function getReportTypeDescription(type) {
+  const descriptions = {
+    executive: 'One-page overview for stakeholders',
+    technical: 'Detailed findings for developers/CTOs',
+    compliance: 'SOC2/HIPAA-ready language for regulated industries',
+    trend: 'Historical score analysis over time',
+  };
+  return descriptions[type] || 'Standard report';
+}
+
+function getFormatIcon(format) {
+  const iconMap = {
+    html: reportIcons.html,
+    md: reportIcons.markdown,
+    markdown: reportIcons.markdown,
+    json: reportIcons.json,
+    sarif: reportIcons.sarif,
+    csv: reportIcons.csv,
+  };
+  return iconMap[format] || reportIcons.report;
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// REPORT GENERATION DISPLAY
+// ═══════════════════════════════════════════════════════════════════════════════
+
+function renderReportInfo(type, format, outputPath) {
+  const lines = [];
+  lines.push(renderSection('REPORT INFO', reportIcons.report));
+  lines.push('');
+  lines.push(`  Type:       ${colors.accent}${type}${ansi.reset} ${ansi.dim}(${getReportTypeDescription(type)})${ansi.reset}`);
+  lines.push(`  Format:     ${getFormatIcon(format)} ${colors.accent}${format.toUpperCase()}${ansi.reset}`);
+  if (outputPath) {
+    lines.push(`  Output:     ${colors.accent}${outputPath}${ansi.reset}`);
+  }
+  return lines.join('\n');
+}
+
+function renderSuccess(outputPath, format) {
+  const lines = [];
+  lines.push('');
+  lines.push(`  ${colors.success}${icons.success}${ansi.reset} ${ansi.bold}Report generated successfully!${ansi.reset}`);
+  lines.push('');
+  lines.push(`  ${ansi.dim}File:${ansi.reset} ${colors.accent}${outputPath}${ansi.reset}`);
+  if (format === 'html') {
+    lines.push(`  ${ansi.dim}Open:${ansi.reset} ${colors.accent}file://${path.resolve(outputPath)}${ansi.reset}`);
+  }
+  return lines.join('\n');
+}
+
+function renderError(error) {
+  const lines = [];
+  lines.push('');
+  lines.push(`  ${colors.error}${icons.error}${ansi.reset} ${ansi.bold}Report generation failed${ansi.reset}`);
+  lines.push(`  ${ansi.dim}${error.message}${ansi.reset}`);
+  return lines.join('\n');
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// HELP TEXT
+// ═══════════════════════════════════════════════════════════════════════════════
+
+function formatHelp() {
+  return `
+  ${ansi.bold}Usage:${ansi.reset} vibecheck report [options]
+
+  ${ansi.bold}Description${ansi.reset}
+    Generate beautiful, professional reports for stakeholders.
+
+  ${ansi.bold}Report Types${ansi.reset}
+    ${colors.accent}technical${ansi.reset}    Detailed findings for developers/CTOs (default)
+    ${colors.accent}executive${ansi.reset}    One-page overview for stakeholders
+    ${colors.accent}compliance${ansi.reset}   SOC2/HIPAA-ready language for regulated industries
+    ${colors.accent}trend${ansi.reset}        Historical score analysis over time
+
+  ${ansi.bold}Output Formats${ansi.reset}
+    ${colors.success}html${ansi.reset}         Beautiful interactive report (default)
+    ${colors.success}md${ansi.reset}           Markdown for documentation/GitHub
+    ${colors.success}json${ansi.reset}         Machine-readable JSON
+    ${colors.success}sarif${ansi.reset}        SARIF for security tool integration
+    ${colors.success}csv${ansi.reset}         CSV for spreadsheet analysis
+
+  ${ansi.bold}Options${ansi.reset}
+    ${colors.accent}--type, -t <type>${ansi.reset}       Report type: executive, technical, compliance, trend
+    ${colors.accent}--format, -f <format>${ansi.reset}   Output format: html, md, json, sarif, csv
+    ${colors.accent}--output, -o <path>${ansi.reset}     Output file path
+    ${colors.accent}--theme <dark|light>${ansi.reset}    HTML theme (default: dark)
+    ${colors.accent}--company <name>${ansi.reset}        Company name for branding
+    ${colors.accent}--logo <path>${ansi.reset}           Custom logo path/URL
+    ${colors.accent}--include-trends${ansi.reset}        Include historical trend data
+    ${colors.accent}--redact-paths${ansi.reset}          Hide file paths for client reports
+    ${colors.accent}--max-findings <n>${ansi.reset}      Max findings to show (default: 50)
+    ${colors.accent}--path, -p <dir>${ansi.reset}        Project path (default: current directory)
+    ${colors.accent}--help, -h${ansi.reset}              Show this help
+
+  ${ansi.bold}Examples${ansi.reset}
+    ${ansi.dim}# Interactive HTML${ansi.reset}
+    vibecheck report
+
+    ${ansi.dim}# Markdown file${ansi.reset}
+    vibecheck report --format=md --output=REPORT.md
+
+    ${ansi.dim}# Compliance report${ansi.reset}
+    vibecheck report --type=compliance --company=Acme
+
+    ${ansi.dim}# Security tooling${ansi.reset}
+    vibecheck report --format=sarif -o report.sarif
+
+    ${ansi.dim}# Client-safe HTML${ansi.reset}
+    vibecheck report --theme=light --redact
+`;
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// EXPORTS
+// ═══════════════════════════════════════════════════════════════════════════════
+
+module.exports = {
+  BANNER,
+  formatHelp,
+  renderReportInfo,
+  renderSuccess,
+  renderError,
+  getReportTypeDescription,
+  getFormatIcon,
+  reportIcons,
+};

package/bin/runners/lib/report.js

@@ -1,135 +1,135 @@
-/**
- * Unified Report Module
- * 
- * This is the SINGLE entry point for all report generation.
- * Internal modules:
- * - report-engine.js  → data assembly + export formats
- * - html-report.js    → HTML generation (primary)
- * - report-html.js    → Alternative HTML styles (deprecated)
- * - report-templates.js → Template components (internal)
- */
-
-const path = require("path");
-const fs = require("fs");
-
-// Primary modules
-const { generateHTMLReport, writeHTMLReport } = require("./html-report");
-const { buildReportData, exportToSARIF, exportToCSV, exportToMarkdown, exportToJSON } = require("./report-engine");
-
-/**
- * Generate a report from ship results
- * @param {Object} options
- * @param {string} options.repoRoot - Repository root path
- * @param {Object} options.shipReport - Ship report data (optional, loads from disk if not provided)
- * @param {string} options.format - Output format: html (default), json, sarif, csv, markdown
- * @param {string} options.outputPath - Custom output path (optional)
- * @returns {Object} { path, format, data }
- */
-async function generateReport(options = {}) {
-  const {
-    repoRoot = process.cwd(),
-    shipReport = null,
-    format = "html",
-    outputPath = null,
-  } = options;
-
-  // Load ship report if not provided
-  let report = shipReport;
-  if (!report) {
-    const shipPath = path.join(repoRoot, ".vibecheck", "ship", "last_ship.json");
-    if (fs.existsSync(shipPath)) {
-      report = JSON.parse(fs.readFileSync(shipPath, "utf-8"));
-    } else {
-      throw new Error("No ship report found. Run 'vibecheck ship' first.");
-    }
-  }
-
-  // Build report data
-  const reportData = buildReportData(report);
-
-  // Generate output based on format
-  let outputFile;
-  let outputData;
-
-  switch (format.toLowerCase()) {
-    case "html":
-      outputData = generateHTMLReport(reportData);
-      outputFile = outputPath || path.join(repoRoot, ".vibecheck", "reports", "report.html");
-      break;
-    case "json":
-      outputData = exportToJSON(reportData);
-      outputFile = outputPath || path.join(repoRoot, ".vibecheck", "reports", "report.json");
-      break;
-    case "sarif":
-      outputData = exportToSARIF(reportData);
-      outputFile = outputPath || path.join(repoRoot, ".vibecheck", "reports", "report.sarif");
-      break;
-    case "csv":
-      outputData = exportToCSV(reportData);
-      outputFile = outputPath || path.join(repoRoot, ".vibecheck", "reports", "report.csv");
-      break;
-    case "markdown":
-    case "md":
-      outputData = exportToMarkdown(reportData);
-      outputFile = outputPath || path.join(repoRoot, ".vibecheck", "reports", "report.md");
-      break;
-    default:
-      throw new Error(`Unknown format: ${format}. Use: html, json, sarif, csv, markdown`);
-  }
-
-  // Ensure output directory exists
-  const outputDir = path.dirname(outputFile);
-  if (!fs.existsSync(outputDir)) {
-    fs.mkdirSync(outputDir, { recursive: true });
-  }
-
-  // Write output
-  fs.writeFileSync(outputFile, outputData, "utf-8");
-
-  return {
-    path: outputFile,
-    format,
-    data: reportData,
-  };
-}
-
-/**
- * Open the latest report in browser
- */
-async function openReport(repoRoot = process.cwd()) {
-  const reportPath = path.join(repoRoot, ".vibecheck", "ship", "last_ship.html");
-  const altPath = path.join(repoRoot, ".vibecheck", "reports", "report.html");
-  
-  const filePath = fs.existsSync(reportPath) ? reportPath : 
-                   fs.existsSync(altPath) ? altPath : null;
-
-  if (!filePath) {
-    throw new Error("No report found. Run 'vibecheck ship' or 'vibecheck report' first.");
-  }
-
-  // Cross-platform open
-  const { exec } = require("child_process");
-  const cmd = process.platform === "win32" ? `start "" "${filePath}"` :
-              process.platform === "darwin" ? `open "${filePath}"` :
-              `xdg-open "${filePath}"`;
-
-  return new Promise((resolve, reject) => {
-    exec(cmd, (err) => {
-      if (err) reject(err);
-      else resolve(filePath);
-    });
-  });
-}
-
-module.exports = {
-  generateReport,
-  openReport,
-  // Re-export for backward compatibility
-  generateHTMLReport,
-  writeHTMLReport,
-  buildReportData,
-  exportToSARIF,
-  exportToCSV,
-  exportToMarkdown,
-  exportToJSON,
-};
+/**
+ * Unified Report Module
+ * 
+ * This is the SINGLE entry point for all report generation.
+ * Internal modules:
+ * - report-engine.js  → data assembly + export formats
+ * - html-report.js    → HTML generation (primary)
+ * - report-html.js    → Alternative HTML styles (deprecated)
+ * - report-templates.js → Template components (internal)
+ */
+
+const path = require("path");
+const fs = require("fs");
+
+// Primary modules
+const { generateHTMLReport, writeHTMLReport } = require("./html-report");
+const { buildReportData, exportToSARIF, exportToCSV, exportToMarkdown, exportToJSON } = require("./report-engine");
+
+/**
+ * Generate a report from ship results
+ * @param {Object} options
+ * @param {string} options.repoRoot - Repository root path
+ * @param {Object} options.shipReport - Ship report data (optional, loads from disk if not provided)
+ * @param {string} options.format - Output format: html (default), json, sarif, csv, markdown
+ * @param {string} options.outputPath - Custom output path (optional)
+ * @returns {Object} { path, format, data }
+ */
+async function generateReport(options = {}) {
+  const {
+    repoRoot = process.cwd(),
+    shipReport = null,
+    format = "html",
+    outputPath = null,
+  } = options;
+
+  // Load ship report if not provided
+  let report = shipReport;
+  if (!report) {
+    const shipPath = path.join(repoRoot, ".vibecheck", "ship", "last_ship.json");
+    if (fs.existsSync(shipPath)) {
+      report = JSON.parse(fs.readFileSync(shipPath, "utf-8"));
+    } else {
+      throw new Error("No ship report found. Run 'vibecheck ship' first.");
+    }
+  }
+
+  // Build report data
+  const reportData = buildReportData(report);
+
+  // Generate output based on format
+  let outputFile;
+  let outputData;
+
+  switch (format.toLowerCase()) {
+    case "html":
+      outputData = generateHTMLReport(reportData);
+      outputFile = outputPath || path.join(repoRoot, ".vibecheck", "reports", "report.html");
+      break;
+    case "json":
+      outputData = exportToJSON(reportData);
+      outputFile = outputPath || path.join(repoRoot, ".vibecheck", "reports", "report.json");
+      break;
+    case "sarif":
+      outputData = exportToSARIF(reportData);
+      outputFile = outputPath || path.join(repoRoot, ".vibecheck", "reports", "report.sarif");
+      break;
+    case "csv":
+      outputData = exportToCSV(reportData);
+      outputFile = outputPath || path.join(repoRoot, ".vibecheck", "reports", "report.csv");
+      break;
+    case "markdown":
+    case "md":
+      outputData = exportToMarkdown(reportData);
+      outputFile = outputPath || path.join(repoRoot, ".vibecheck", "reports", "report.md");
+      break;
+    default:
+      throw new Error(`Unknown format: ${format}. Use: html, json, sarif, csv, markdown`);
+  }
+
+  // Ensure output directory exists
+  const outputDir = path.dirname(outputFile);
+  if (!fs.existsSync(outputDir)) {
+    fs.mkdirSync(outputDir, { recursive: true });
+  }
+
+  // Write output
+  fs.writeFileSync(outputFile, outputData, "utf-8");
+
+  return {
+    path: outputFile,
+    format,
+    data: reportData,
+  };
+}
+
+/**
+ * Open the latest report in browser
+ */
+async function openReport(repoRoot = process.cwd()) {
+  const reportPath = path.join(repoRoot, ".vibecheck", "ship", "last_ship.html");
+  const altPath = path.join(repoRoot, ".vibecheck", "reports", "report.html");
+  
+  const filePath = fs.existsSync(reportPath) ? reportPath : 
+                   fs.existsSync(altPath) ? altPath : null;
+
+  if (!filePath) {
+    throw new Error("No report found. Run 'vibecheck ship' or 'vibecheck report' first.");
+  }
+
+  // Cross-platform open
+  const { exec } = require("child_process");
+  const cmd = process.platform === "win32" ? `start "" "${filePath}"` :
+              process.platform === "darwin" ? `open "${filePath}"` :
+              `xdg-open "${filePath}"`;
+
+  return new Promise((resolve, reject) => {
+    exec(cmd, (err) => {
+      if (err) reject(err);
+      else resolve(filePath);
+    });
+  });
+}
+
+module.exports = {
+  generateReport,
+  openReport,
+  // Re-export for backward compatibility
+  generateHTMLReport,
+  writeHTMLReport,
+  buildReportData,
+  exportToSARIF,
+  exportToCSV,
+  exportToMarkdown,
+  exportToJSON,
+};