agentsys 5.0.3 → 5.1.0

package/plugins/debate/lib/enhance/reporter.js

@@ -0,0 +1,1348 @@
+/**
+ * Plugin Analysis Reporter
+ * Generates markdown reports for plugin analysis results
+ */
+
+/**
+ * Generate a markdown report from analysis results
+ * @param {Object} results - Analysis results
+ * @param {string} results.pluginName - Name of analyzed plugin
+ * @param {Array} results.toolIssues - Tool definition issues
+ * @param {Array} results.structureIssues - Plugin structure issues
+ * @param {Array} results.securityIssues - Security issues
+ * @param {Object} options - Report options
+ * @param {boolean} options.verbose - Include LOW certainty issues
+ * @param {boolean} options.compact - Use compact format
+ * @returns {string} Markdown report
+ */
+function generateReport(results, options = {}) {
+  const { verbose = false, compact = false } = options;
+
+  // Filter issues by certainty
+  const filterIssues = (issues) => {
+    if (verbose) return issues;
+    return issues.filter(i => i.certainty !== 'LOW');
+  };
+
+  const toolIssues = filterIssues(results.toolIssues || []);
+  const structureIssues = filterIssues(results.structureIssues || []);
+  const securityIssues = filterIssues(results.securityIssues || []);
+
+  const totalIssues = toolIssues.length + structureIssues.length + securityIssues.length;
+
+  if (compact) {
+    return generateCompactReport(results.pluginName, toolIssues, structureIssues, securityIssues);
+  }
+
+  const lines = [];
+
+  // Header
+  lines.push(`## Plugin Analysis: ${results.pluginName}`);
+  lines.push('');
+  lines.push(`**Analyzed**: ${new Date().toISOString()}`);
+  lines.push(`**Files scanned**: ${results.filesScanned || 0}`);
+  lines.push('');
+
+  // Summary
+  lines.push('### Summary');
+  lines.push('');
+
+  const highCount = countByCertainty([...toolIssues, ...structureIssues, ...securityIssues], 'HIGH');
+  const mediumCount = countByCertainty([...toolIssues, ...structureIssues, ...securityIssues], 'MEDIUM');
+  const lowCount = verbose ? countByCertainty([...toolIssues, ...structureIssues, ...securityIssues], 'LOW') : 0;
+
+  lines.push(`| Certainty | Count |`);
+  lines.push(`|-----------|-------|`);
+  lines.push(`| HIGH | ${highCount} |`);
+  lines.push(`| MEDIUM | ${mediumCount} |`);
+  if (verbose) {
+    lines.push(`| LOW | ${lowCount} |`);
+  }
+  lines.push(`| **Total** | **${totalIssues}** |`);
+  lines.push('');
+
+  // Tool Issues
+  if (toolIssues.length > 0) {
+    lines.push(`### Tool Definitions (${toolIssues.length} issues)`);
+    lines.push('');
+    lines.push('| Tool | Issue | Fix | Certainty |');
+    lines.push('|------|-------|-----|-----------|');
+    for (const issue of toolIssues) {
+      lines.push(`| ${issue.tool || '-'} | ${issue.issue} | ${issue.fix || '-'} | ${issue.certainty} |`);
+    }
+    lines.push('');
+  }
+
+  // Structure Issues
+  if (structureIssues.length > 0) {
+    lines.push(`### Structure (${structureIssues.length} issues)`);
+    lines.push('');
+    lines.push('| File | Issue | Certainty |');
+    lines.push('|------|-------|-----------|');
+    for (const issue of structureIssues) {
+      lines.push(`| ${issue.file || '-'} | ${issue.issue} | ${issue.certainty} |`);
+    }
+    lines.push('');
+  }
+
+  // Security Issues
+  if (securityIssues.length > 0) {
+    lines.push(`### Security (${securityIssues.length} issues)`);
+    lines.push('');
+    lines.push('| File | Line | Issue | Certainty |');
+    lines.push('|------|------|-------|-----------|');
+    for (const issue of securityIssues) {
+      lines.push(`| ${issue.file || '-'} | ${issue.line || '-'} | ${issue.issue} | ${issue.certainty} |`);
+    }
+    lines.push('');
+  }
+
+  // No issues
+  if (totalIssues === 0) {
+    lines.push('No issues found.');
+    lines.push('');
+  }
+
+  return lines.join('\n');
+}
+
+function generateCompactReport(pluginName, toolIssues, structureIssues, securityIssues) {
+  const lines = [];
+
+  lines.push(`## ${pluginName}: ${toolIssues.length + structureIssues.length + securityIssues.length} issues`);
+  lines.push('');
+
+  const allIssues = [
+    ...toolIssues.map(i => ({ ...i, category: 'Tool' })),
+    ...structureIssues.map(i => ({ ...i, category: 'Structure' })),
+    ...securityIssues.map(i => ({ ...i, category: 'Security' }))
+  ];
+
+  // Sort by certainty (HIGH first)
+  const certOrder = { HIGH: 0, MEDIUM: 1, LOW: 2 };
+  allIssues.sort((a, b) => certOrder[a.certainty] - certOrder[b.certainty]);
+
+  if (allIssues.length > 0) {
+    lines.push('| Category | Issue | Certainty |');
+    lines.push('|----------|-------|-----------|');
+    for (const issue of allIssues) {
+      lines.push(`| ${issue.category} | ${issue.issue} | ${issue.certainty} |`);
+    }
+  } else {
+    lines.push('No issues found.');
+  }
+
+  return lines.join('\n');
+}
+
+function countByCertainty(issues, certainty) {
+  return issues.filter(i => i.certainty === certainty).length;
+}
+
+/**
+ * Generate a diff display for a fix
+ * @param {string} original - Original content
+ * @param {string} modified - Modified content
+ * @param {string} filePath - File path
+ * @returns {string} Diff display
+ */
+function generateDiff(original, modified, filePath) {
+  const lines = [];
+
+  lines.push(`\`\`\`diff`);
+  lines.push(`--- a/${filePath}`);
+  lines.push(`+++ b/${filePath}`);
+
+  const origLines = original.split('\n');
+  const modLines = modified.split('\n');
+  const maxLines = Math.max(origLines.length, modLines.length);
+  for (let i = 0; i < maxLines; i++) {
+    const origLine = origLines[i];
+    const modLine = modLines[i];
+
+    if (origLine === modLine) {
+      if (origLine !== undefined) {
+        lines.push(` ${origLine}`);
+      }
+    } else {
+      if (origLine !== undefined) {
+        lines.push(`-${origLine}`);
+      }
+      if (modLine !== undefined) {
+        lines.push(`+${modLine}`);
+      }
+    }
+  }
+
+  lines.push(`\`\`\``);
+
+  return lines.join('\n');
+}
+
+/**
+ * Generate a summary report for multiple plugins
+ * @param {Array} allResults - Array of plugin analysis results
+ * @param {Object} options - Report options
+ * @returns {string} Summary markdown report
+ */
+function generateSummaryReport(allResults, options = {}) {
+  const lines = [];
+
+  lines.push('# Plugin Analysis Summary');
+  lines.push('');
+  lines.push(`**Analyzed**: ${allResults.length} plugins`);
+  lines.push(`**Date**: ${new Date().toISOString()}`);
+  lines.push('');
+
+  // Overall stats
+  let totalHigh = 0;
+  let totalMedium = 0;
+  let totalLow = 0;
+
+  for (const result of allResults) {
+    const allIssues = [
+      ...(result.toolIssues || []),
+      ...(result.structureIssues || []),
+      ...(result.securityIssues || [])
+    ];
+    totalHigh += countByCertainty(allIssues, 'HIGH');
+    totalMedium += countByCertainty(allIssues, 'MEDIUM');
+    totalLow += countByCertainty(allIssues, 'LOW');
+  }
+
+  lines.push('## Overall');
+  lines.push('');
+  lines.push('| Certainty | Count |');
+  lines.push('|-----------|-------|');
+  lines.push(`| HIGH | ${totalHigh} |`);
+  lines.push(`| MEDIUM | ${totalMedium} |`);
+  if (options.verbose) {
+    lines.push(`| LOW | ${totalLow} |`);
+  }
+  lines.push('');
+
+  lines.push('## By Plugin');
+  lines.push('');
+  lines.push('| Plugin | HIGH | MEDIUM | LOW | Total |');
+  lines.push('|--------|------|--------|-----|-------|');
+
+  for (const result of allResults) {
+    const allIssues = [
+      ...(result.toolIssues || []),
+      ...(result.structureIssues || []),
+      ...(result.securityIssues || [])
+    ];
+    const h = countByCertainty(allIssues, 'HIGH');
+    const m = countByCertainty(allIssues, 'MEDIUM');
+    const l = countByCertainty(allIssues, 'LOW');
+    lines.push(`| ${result.pluginName} | ${h} | ${m} | ${l} | ${h + m + l} |`);
+  }
+
+  lines.push('');
+
+  return lines.join('\n');
+}
+
+/**
+ * Generate report for a single agent analysis
+ * @param {Object} results - Agent analysis results
+ * @param {Object} options - Report options
+ * @returns {string} Markdown report
+ */
+function generateAgentReport(results, options = {}) {
+  const lines = [];
+
+  lines.push(`# Agent Analysis: ${results.agentName}`);
+  lines.push('');
+  lines.push(`**File**: ${results.agentPath}`);
+  lines.push(`**Analyzed**: ${new Date().toISOString()}`);
+  lines.push('');
+
+  const allIssues = [
+    ...(results.structureIssues || []),
+    ...(results.toolIssues || []),
+    ...(results.xmlIssues || []),
+    ...(results.cotIssues || []),
+    ...(results.exampleIssues || []),
+    ...(results.antiPatternIssues || []),
+    ...(results.crossPlatformIssues || [])
+  ];
+
+  // Count by certainty
+  const highCount = countByCertainty(allIssues, 'HIGH');
+  const mediumCount = countByCertainty(allIssues, 'MEDIUM');
+  const lowCount = countByCertainty(allIssues, 'LOW');
+
+  lines.push('## Summary');
+  lines.push('');
+  lines.push('| Certainty | Count |');
+  lines.push('|-----------|-------|');
+  lines.push(`| HIGH | ${highCount} |`);
+  lines.push(`| MEDIUM | ${mediumCount} |`);
+  if (options.verbose) {
+    lines.push(`| LOW | ${lowCount} |`);
+  }
+  lines.push('');
+
+  if (results.structureIssues && results.structureIssues.length > 0) {
+    lines.push(`### Structure Issues (${results.structureIssues.length})`);
+    lines.push('');
+    lines.push('| Issue | Fix | Certainty |');
+    lines.push('|-------|-----|-----------|');
+    for (const issue of results.structureIssues) {
+      lines.push(`| ${issue.issue} | ${issue.fix || 'N/A'} | ${issue.certainty} |`);
+    }
+    lines.push('');
+  }
+
+  if (results.toolIssues && results.toolIssues.length > 0) {
+    lines.push(`### Tool Issues (${results.toolIssues.length})`);
+    lines.push('');
+    lines.push('| Issue | Fix | Certainty |');
+    lines.push('|-------|-----|-----------|');
+    for (const issue of results.toolIssues) {
+      lines.push(`| ${issue.issue} | ${issue.fix || 'N/A'} | ${issue.certainty} |`);
+    }
+    lines.push('');
+  }
+
+  if (results.xmlIssues && results.xmlIssues.length > 0) {
+    lines.push(`### XML Structure Issues (${results.xmlIssues.length})`);
+    lines.push('');
+    lines.push('| Issue | Fix | Certainty |');
+    lines.push('|-------|-----|-----------|');
+    for (const issue of results.xmlIssues) {
+      lines.push(`| ${issue.issue} | ${issue.fix || 'N/A'} | ${issue.certainty} |`);
+    }
+    lines.push('');
+  }
+
+  if (results.cotIssues && results.cotIssues.length > 0) {
+    lines.push(`### Chain-of-Thought Issues (${results.cotIssues.length})`);
+    lines.push('');
+    lines.push('| Issue | Fix | Certainty |');
+    lines.push('|-------|-----|-----------|');
+    for (const issue of results.cotIssues) {
+      lines.push(`| ${issue.issue} | ${issue.fix || 'N/A'} | ${issue.certainty} |`);
+    }
+    lines.push('');
+  }
+
+  if (results.exampleIssues && results.exampleIssues.length > 0) {
+    lines.push(`### Example Issues (${results.exampleIssues.length})`);
+    lines.push('');
+    lines.push('| Issue | Fix | Certainty |');
+    lines.push('|-------|-----|-----------|');
+    for (const issue of results.exampleIssues) {
+      lines.push(`| ${issue.issue} | ${issue.fix || 'N/A'} | ${issue.certainty} |`);
+    }
+    lines.push('');
+  }
+
+  if (results.antiPatternIssues && results.antiPatternIssues.length > 0) {
+    lines.push(`### Anti-Pattern Issues (${results.antiPatternIssues.length})`);
+    lines.push('');
+    lines.push('| Issue | Fix | Certainty |');
+    lines.push('|-------|-----|-----------|');
+    for (const issue of results.antiPatternIssues) {
+      lines.push(`| ${issue.issue} | ${issue.fix || 'N/A'} | ${issue.certainty} |`);
+    }
+    lines.push('');
+  }
+
+  // Cross-Platform Issues
+  if (results.crossPlatformIssues && results.crossPlatformIssues.length > 0) {
+    lines.push(`### Cross-Platform Issues (${results.crossPlatformIssues.length})`);
+    lines.push('');
+    lines.push('| Issue | Fix | Certainty |');
+    lines.push('|-------|-----|-----------|');
+    for (const issue of results.crossPlatformIssues) {
+      lines.push(`| ${issue.issue} | ${issue.fix || 'N/A'} | ${issue.certainty} |`);
+    }
+    lines.push('');
+  }
+
+  return lines.join('\n');
+}
+
+/**
+ * Generate summary report for multiple agent analyses
+ * @param {Array} allResults - Array of agent analysis results
+ * @param {Object} options - Report options
+ * @returns {string} Markdown report
+ */
+function generateAgentSummaryReport(allResults, options = {}) {
+  const lines = [];
+
+  lines.push('# Agent Analysis Summary');
+  lines.push('');
+  lines.push(`**Analyzed**: ${allResults.length} agents`);
+  lines.push(`**Date**: ${new Date().toISOString()}`);
+  lines.push('');
+
+  // Overall stats
+  let totalHigh = 0;
+  let totalMedium = 0;
+  let totalLow = 0;
+
+  for (const result of allResults) {
+    const allIssues = [
+      ...(result.structureIssues || []),
+      ...(result.toolIssues || []),
+      ...(result.xmlIssues || []),
+      ...(result.cotIssues || []),
+      ...(result.exampleIssues || []),
+      ...(result.antiPatternIssues || []),
+      ...(result.crossPlatformIssues || [])
+    ];
+    totalHigh += countByCertainty(allIssues, 'HIGH');
+    totalMedium += countByCertainty(allIssues, 'MEDIUM');
+    totalLow += countByCertainty(allIssues, 'LOW');
+  }
+
+  lines.push('## Overall');
+  lines.push('');
+  lines.push('| Certainty | Count |');
+  lines.push('|-----------|-------|');
+  lines.push(`| HIGH | ${totalHigh} |`);
+  lines.push(`| MEDIUM | ${totalMedium} |`);
+  if (options.verbose) {
+    lines.push(`| LOW | ${totalLow} |`);
+  }
+  lines.push('');
+
+  lines.push('## By Agent');
+  lines.push('');
+  lines.push('| Agent | HIGH | MEDIUM | LOW | Total |');
+  lines.push('|-------|------|--------|-----|-------|');
+
+  for (const result of allResults) {
+    const allIssues = [
+      ...(result.structureIssues || []),
+      ...(result.toolIssues || []),
+      ...(result.xmlIssues || []),
+      ...(result.cotIssues || []),
+      ...(result.exampleIssues || []),
+      ...(result.antiPatternIssues || []),
+      ...(result.crossPlatformIssues || [])
+    ];
+    const h = countByCertainty(allIssues, 'HIGH');
+    const m = countByCertainty(allIssues, 'MEDIUM');
+    const l = countByCertainty(allIssues, 'LOW');
+    lines.push(`| ${result.agentName} | ${h} | ${m} | ${l} | ${h + m + l} |`);
+  }
+
+  lines.push('');
+
+  return lines.join('\n');
+}
+
+/**
+ * Generate report for a single documentation analysis
+ * @param {Object} results - Docs analysis results
+ * @param {Object} options - Report options
+ * @returns {string} Markdown report
+ */
+function generateDocsReport(results, options = {}) {
+  const lines = [];
+
+  lines.push(`# Documentation Analysis: ${results.docName}`);
+  lines.push('');
+  lines.push(`**File**: ${results.docPath}`);
+  lines.push(`**Mode**: ${results.mode === 'ai' ? 'AI-only (RAG optimized)' : 'Both audiences'}`);
+  lines.push(`**Token Count**: ~${results.tokenCount}`);
+  lines.push(`**Analyzed**: ${new Date().toISOString()}`);
+  lines.push('');
+
+  // Collect all issues
+  const allIssues = [
+    ...(results.linkIssues || []),
+    ...(results.structureIssues || []),
+    ...(results.codeIssues || []),
+    ...(results.efficiencyIssues || []),
+    ...(results.ragIssues || []),
+    ...(results.balanceIssues || [])
+  ];
+
+  // Count by certainty
+  const highCount = countByCertainty(allIssues, 'HIGH');
+  const mediumCount = countByCertainty(allIssues, 'MEDIUM');
+  const lowCount = countByCertainty(allIssues, 'LOW');
+
+  lines.push('## Summary');
+  lines.push('');
+  lines.push('| Certainty | Count |');
+  lines.push('|-----------|-------|');
+  lines.push(`| HIGH | ${highCount} |`);
+  lines.push(`| MEDIUM | ${mediumCount} |`);
+  if (options.verbose) {
+    lines.push(`| LOW | ${lowCount} |`);
+  }
+  lines.push('');
+
+  // Link Issues
+  if (results.linkIssues && results.linkIssues.length > 0) {
+    lines.push(`### Link Issues (${results.linkIssues.length})`);
+    lines.push('');
+    lines.push('| Issue | Fix | Certainty |');
+    lines.push('|-------|-----|-----------|');
+    for (const issue of results.linkIssues) {
+      lines.push(`| ${issue.issue} | ${issue.fix || 'N/A'} | ${issue.certainty} |`);
+    }
+    lines.push('');
+  }
+
+  // Structure Issues
+  if (results.structureIssues && results.structureIssues.length > 0) {
+    lines.push(`### Structure Issues (${results.structureIssues.length})`);
+    lines.push('');
+    lines.push('| Issue | Fix | Certainty |');
+    lines.push('|-------|-----|-----------|');
+    for (const issue of results.structureIssues) {
+      lines.push(`| ${issue.issue} | ${issue.fix || 'N/A'} | ${issue.certainty} |`);
+    }
+    lines.push('');
+  }
+
+  // Code Issues
+  if (results.codeIssues && results.codeIssues.length > 0) {
+    lines.push(`### Code Block Issues (${results.codeIssues.length})`);
+    lines.push('');
+    lines.push('| Issue | Fix | Certainty |');
+    lines.push('|-------|-----|-----------|');
+    for (const issue of results.codeIssues) {
+      lines.push(`| ${issue.issue} | ${issue.fix || 'N/A'} | ${issue.certainty} |`);
+    }
+    lines.push('');
+  }
+
+  // Efficiency Issues (AI mode)
+  if (results.efficiencyIssues && results.efficiencyIssues.length > 0) {
+    lines.push(`### Efficiency Issues (${results.efficiencyIssues.length})`);
+    lines.push('');
+    lines.push('| Issue | Fix | Certainty |');
+    lines.push('|-------|-----|-----------|');
+    for (const issue of results.efficiencyIssues) {
+      lines.push(`| ${issue.issue} | ${issue.fix || 'N/A'} | ${issue.certainty} |`);
+    }
+    lines.push('');
+  }
+
+  // RAG Issues (AI mode)
+  if (results.ragIssues && results.ragIssues.length > 0) {
+    lines.push(`### RAG Optimization Issues (${results.ragIssues.length})`);
+    lines.push('');
+    lines.push('| Issue | Fix | Certainty |');
+    lines.push('|-------|-----|-----------|');
+    for (const issue of results.ragIssues) {
+      lines.push(`| ${issue.issue} | ${issue.fix || 'N/A'} | ${issue.certainty} |`);
+    }
+    lines.push('');
+  }
+
+  // Balance Issues (both mode)
+  if (results.balanceIssues && results.balanceIssues.length > 0) {
+    lines.push(`### Balance Suggestions (${results.balanceIssues.length})`);
+    lines.push('');
+    lines.push('| Issue | Fix | Certainty |');
+    lines.push('|-------|-----|-----------|');
+    for (const issue of results.balanceIssues) {
+      lines.push(`| ${issue.issue} | ${issue.fix || 'N/A'} | ${issue.certainty} |`);
+    }
+    lines.push('');
+  }
+
+  // No issues
+  if (allIssues.length === 0) {
+    lines.push('No issues found.');
+    lines.push('');
+  }
+
+  return lines.join('\n');
+}
+
+/**
+ * Generate summary report for multiple documentation analyses
+ * @param {Array} allResults - Array of docs analysis results
+ * @param {Object} options - Report options
+ * @returns {string} Markdown report
+ */
+function generateDocsSummaryReport(allResults, options = {}) {
+  const lines = [];
+
+  // Determine mode from first result
+  const mode = allResults[0]?.mode || 'both';
+
+  lines.push('# Documentation Analysis Summary');
+  lines.push('');
+  lines.push(`**Analyzed**: ${allResults.length} documents`);
+  lines.push(`**Mode**: ${mode === 'ai' ? 'AI-only (RAG optimized)' : 'Both audiences'}`);
+  lines.push(`**Date**: ${new Date().toISOString()}`);
+  lines.push('');
+
+  // Overall stats
+  let totalHigh = 0;
+  let totalMedium = 0;
+  let totalLow = 0;
+  let totalTokens = 0;
+
+  for (const result of allResults) {
+    const allIssues = [
+      ...(result.linkIssues || []),
+      ...(result.structureIssues || []),
+      ...(result.codeIssues || []),
+      ...(result.efficiencyIssues || []),
+      ...(result.ragIssues || []),
+      ...(result.balanceIssues || [])
+    ];
+    totalHigh += countByCertainty(allIssues, 'HIGH');
+    totalMedium += countByCertainty(allIssues, 'MEDIUM');
+    totalLow += countByCertainty(allIssues, 'LOW');
+    totalTokens += result.tokenCount || 0;
+  }
+
+  lines.push('## Overall');
+  lines.push('');
+  lines.push(`**Total Tokens**: ~${totalTokens}`);
+  lines.push('');
+  lines.push('| Certainty | Count |');
+  lines.push('|-----------|-------|');
+  lines.push(`| HIGH | ${totalHigh} |`);
+  lines.push(`| MEDIUM | ${totalMedium} |`);
+  if (options.verbose) {
+    lines.push(`| LOW | ${totalLow} |`);
+  }
+  lines.push('');
+
+  // Per-document summary
+  lines.push('## By Document');
+  lines.push('');
+  lines.push('| Document | Tokens | HIGH | MEDIUM | LOW | Total |');
+  lines.push('|----------|--------|------|--------|-----|-------|');
+
+  for (const result of allResults) {
+    const allIssues = [
+      ...(result.linkIssues || []),
+      ...(result.structureIssues || []),
+      ...(result.codeIssues || []),
+      ...(result.efficiencyIssues || []),
+      ...(result.ragIssues || []),
+      ...(result.balanceIssues || [])
+    ];
+    const h = countByCertainty(allIssues, 'HIGH');
+    const m = countByCertainty(allIssues, 'MEDIUM');
+    const l = countByCertainty(allIssues, 'LOW');
+    lines.push(`| ${result.docName} | ${result.tokenCount} | ${h} | ${m} | ${l} | ${h + m + l} |`);
+  }
+
+  lines.push('');
+
+  return lines.join('\n');
+}
+
+/**
+ * Generate report for project memory file analysis
+ * @param {Object} results - Project memory analysis results
+ * @param {Object} options - Report options
+ * @returns {string} Markdown report
+ */
+function generateProjectMemoryReport(results, options = {}) {
+  const lines = [];
+
+  if (results.error) {
+    lines.push(`# Project Memory Analysis: Error`);
+    lines.push('');
+    lines.push(`**Error**: ${results.error}`);
+    lines.push('');
+    if (results.searchedPaths) {
+      lines.push('Searched paths:');
+      for (const p of results.searchedPaths) {
+        lines.push(`- ${p}`);
+      }
+    }
+    return lines.join('\n');
+  }
+
+  lines.push(`# Project Memory Analysis: ${results.fileName}`);
+  lines.push('');
+  lines.push(`**File**: ${results.filePath}`);
+  lines.push(`**Type**: ${results.fileType === 'agents' ? 'AGENTS.md (cross-platform)' : 'CLAUDE.md'}`);
+  lines.push(`**Analyzed**: ${new Date().toISOString()}`);
+  lines.push('');
+
+  if (results.metrics) {
+    lines.push('## Metrics');
+    lines.push('');
+    lines.push('| Metric | Value |');
+    lines.push('|--------|-------|');
+    lines.push(`| Estimated Tokens | ${results.metrics.estimatedTokens} |`);
+    lines.push(`| Characters | ${results.metrics.characterCount} |`);
+    lines.push(`| Lines | ${results.metrics.lineCount} |`);
+    lines.push(`| Words | ${results.metrics.wordCount} |`);
+    if (results.metrics.readmeOverlap !== undefined) {
+      lines.push(`| README Overlap | ${Math.round(results.metrics.readmeOverlap * 100)}% |`);
+    }
+    lines.push('');
+  }
+
+  const allIssues = [
+    ...(results.structureIssues || []),
+    ...(results.referenceIssues || []),
+    ...(results.efficiencyIssues || []),
+    ...(results.qualityIssues || []),
+    ...(results.crossPlatformIssues || [])
+  ];
+
+  // Count by certainty
+  const highCount = countByCertainty(allIssues, 'HIGH');
+  const mediumCount = countByCertainty(allIssues, 'MEDIUM');
+  const lowCount = countByCertainty(allIssues, 'LOW');
+
+  lines.push('## Summary');
+  lines.push('');
+  lines.push('| Certainty | Count |');
+  lines.push('|-----------|-------|');
+  lines.push(`| HIGH | ${highCount} |`);
+  lines.push(`| MEDIUM | ${mediumCount} |`);
+  if (options.verbose) {
+    lines.push(`| LOW | ${lowCount} |`);
+  }
+  lines.push(`| **Total** | **${allIssues.length}** |`);
+  lines.push('');
+
+  if (results.structureIssues && results.structureIssues.length > 0) {
+    lines.push(`### Structure Issues (${results.structureIssues.length})`);
+    lines.push('');
+    lines.push('| Issue | Fix | Certainty |');
+    lines.push('|-------|-----|-----------|');
+    for (const issue of results.structureIssues) {
+      lines.push(`| ${issue.issue} | ${issue.fix || 'N/A'} | ${issue.certainty} |`);
+    }
+    lines.push('');
+  }
+
+  if (results.referenceIssues && results.referenceIssues.length > 0) {
+    lines.push(`### Reference Issues (${results.referenceIssues.length})`);
+    lines.push('');
+    lines.push('| Issue | Fix | Certainty |');
+    lines.push('|-------|-----|-----------|');
+    for (const issue of results.referenceIssues) {
+      lines.push(`| ${issue.issue} | ${issue.fix || 'N/A'} | ${issue.certainty} |`);
+    }
+    lines.push('');
+  }
+
+  if (results.efficiencyIssues && results.efficiencyIssues.length > 0) {
+    lines.push(`### Efficiency Issues (${results.efficiencyIssues.length})`);
+    lines.push('');
+    lines.push('| Issue | Fix | Certainty |');
+    lines.push('|-------|-----|-----------|');
+    for (const issue of results.efficiencyIssues) {
+      lines.push(`| ${issue.issue} | ${issue.fix || 'N/A'} | ${issue.certainty} |`);
+    }
+    lines.push('');
+  }
+
+  if (results.qualityIssues && results.qualityIssues.length > 0) {
+    lines.push(`### Quality Issues (${results.qualityIssues.length})`);
+    lines.push('');
+    lines.push('| Issue | Fix | Certainty |');
+    lines.push('|-------|-----|-----------|');
+    for (const issue of results.qualityIssues) {
+      lines.push(`| ${issue.issue} | ${issue.fix || 'N/A'} | ${issue.certainty} |`);
+    }
+    lines.push('');
+  }
+
+  // Cross-Platform Issues
+  if (results.crossPlatformIssues && results.crossPlatformIssues.length > 0) {
+    lines.push(`### Cross-Platform Issues (${results.crossPlatformIssues.length})`);
+    lines.push('');
+    lines.push('| Issue | Fix | Certainty |');
+    lines.push('|-------|-----|-----------|');
+    for (const issue of results.crossPlatformIssues) {
+      lines.push(`| ${issue.issue} | ${issue.fix || 'N/A'} | ${issue.certainty} |`);
+    }
+    lines.push('');
+  }
+
+  if (allIssues.length === 0) {
+    lines.push('No issues found.');
+    lines.push('');
+  }
+
+  return lines.join('\n');
+}
+
+/**
+ * Generate summary report for multiple project memory analyses
+ * @param {Array} allResults - Array of project memory analysis results
+ * @param {Object} options - Report options
+ * @returns {string} Markdown report
+ */
+function generateProjectMemorySummaryReport(allResults, options = {}) {
+  const lines = [];
+
+  lines.push('# Project Memory Analysis Summary');
+  lines.push('');
+  lines.push(`**Analyzed**: ${allResults.length} files`);
+  lines.push(`**Date**: ${new Date().toISOString()}`);
+  lines.push('');
+
+  // Overall stats
+  let totalHigh = 0;
+  let totalMedium = 0;
+  let totalLow = 0;
+  let totalTokens = 0;
+
+  for (const result of allResults) {
+    if (result.error) continue;
+
+    const allIssues = [
+      ...(result.structureIssues || []),
+      ...(result.referenceIssues || []),
+      ...(result.efficiencyIssues || []),
+      ...(result.qualityIssues || []),
+      ...(result.crossPlatformIssues || [])
+    ];
+    totalHigh += countByCertainty(allIssues, 'HIGH');
+    totalMedium += countByCertainty(allIssues, 'MEDIUM');
+    totalLow += countByCertainty(allIssues, 'LOW');
+
+    if (result.metrics) {
+      totalTokens += result.metrics.estimatedTokens || 0;
+    }
+  }
+
+  lines.push('## Overall');
+  lines.push('');
+  lines.push('| Metric | Value |');
+  lines.push('|--------|-------|');
+  lines.push(`| Total Tokens | ${totalTokens} |`);
+  lines.push(`| HIGH Issues | ${totalHigh} |`);
+  lines.push(`| MEDIUM Issues | ${totalMedium} |`);
+  if (options.verbose) {
+    lines.push(`| LOW Issues | ${totalLow} |`);
+  }
+  lines.push('');
+
+  lines.push('## By File');
+  lines.push('');
+  lines.push('| File | Tokens | HIGH | MEDIUM | LOW | Total |');
+  lines.push('|------|--------|------|--------|-----|-------|');
+
+  for (const result of allResults) {
+    if (result.error) {
+      lines.push(`| ${result.filePath || 'Unknown'} | - | Error | - | - | - |`);
+      continue;
+    }
+
+    const allIssues = [
+      ...(result.structureIssues || []),
+      ...(result.referenceIssues || []),
+      ...(result.efficiencyIssues || []),
+      ...(result.qualityIssues || []),
+      ...(result.crossPlatformIssues || [])
+    ];
+    const h = countByCertainty(allIssues, 'HIGH');
+    const m = countByCertainty(allIssues, 'MEDIUM');
+    const l = countByCertainty(allIssues, 'LOW');
+    const tokens = result.metrics?.estimatedTokens || '-';
+    lines.push(`| ${result.fileName} | ${tokens} | ${h} | ${m} | ${l} | ${h + m + l} |`);
+  }
+
+  lines.push('');
+
+  return lines.join('\n');
+}
+/**
+ * Generate report for a single prompt analysis
+ * @param {Object} results - Prompt analysis results
+ * @param {Object} options - Report options
+ * @returns {string} Markdown report
+ */
+function generatePromptReport(results, options = {}) {
+  const lines = [];
+
+  lines.push(`# Prompt Analysis: ${results.promptName}`);
+  lines.push('');
+  lines.push(`**File**: ${results.promptPath}`);
+  lines.push(`**Type**: ${results.promptType || 'unknown'}`);
+  lines.push(`**Token Count**: ~${results.tokenCount}`);
+  lines.push(`**Analyzed**: ${new Date().toISOString()}`);
+  lines.push('');
+
+  // Collect all issues
+  const allIssues = [
+    ...(results.clarityIssues || []),
+    ...(results.structureIssues || []),
+    ...(results.exampleIssues || []),
+    ...(results.contextIssues || []),
+    ...(results.outputIssues || []),
+    ...(results.antiPatternIssues || []),
+    ...(results.codeValidationIssues || [])
+  ];
+
+  // Count by certainty
+  const highCount = countByCertainty(allIssues, 'HIGH');
+  const mediumCount = countByCertainty(allIssues, 'MEDIUM');
+  const lowCount = countByCertainty(allIssues, 'LOW');
+
+  lines.push('## Summary');
+  lines.push('');
+  lines.push('| Certainty | Count |');
+  lines.push('|-----------|-------|');
+  lines.push(`| HIGH | ${highCount} |`);
+  lines.push(`| MEDIUM | ${mediumCount} |`);
+  if (options.verbose) {
+    lines.push(`| LOW | ${lowCount} |`);
+  }
+  lines.push('');
+
+  // Clarity Issues
+  if (results.clarityIssues && results.clarityIssues.length > 0) {
+    lines.push(`### Clarity Issues (${results.clarityIssues.length})`);
+    lines.push('');
+    lines.push('| Issue | Fix | Certainty |');
+    lines.push('|-------|-----|-----------|');
+    for (const issue of results.clarityIssues) {
+      lines.push(`| ${issue.issue} | ${issue.fix || 'N/A'} | ${issue.certainty} |`);
+    }
+    lines.push('');
+  }
+
+  // Structure Issues
+  if (results.structureIssues && results.structureIssues.length > 0) {
+    lines.push(`### Structure Issues (${results.structureIssues.length})`);
+    lines.push('');
+    lines.push('| Issue | Fix | Certainty |');
+    lines.push('|-------|-----|-----------|');
+    for (const issue of results.structureIssues) {
+      lines.push(`| ${issue.issue} | ${issue.fix || 'N/A'} | ${issue.certainty} |`);
+    }
+    lines.push('');
+  }
+
+  // Example Issues
+  if (results.exampleIssues && results.exampleIssues.length > 0) {
+    lines.push(`### Example Issues (${results.exampleIssues.length})`);
+    lines.push('');
+    lines.push('| Issue | Fix | Certainty |');
+    lines.push('|-------|-----|-----------|');
+    for (const issue of results.exampleIssues) {
+      lines.push(`| ${issue.issue} | ${issue.fix || 'N/A'} | ${issue.certainty} |`);
+    }
+    lines.push('');
+  }
+
+  // Context Issues
+  if (results.contextIssues && results.contextIssues.length > 0) {
+    lines.push(`### Context Issues (${results.contextIssues.length})`);
+    lines.push('');
+    lines.push('| Issue | Fix | Certainty |');
+    lines.push('|-------|-----|-----------|');
+    for (const issue of results.contextIssues) {
+      lines.push(`| ${issue.issue} | ${issue.fix || 'N/A'} | ${issue.certainty} |`);
+    }
+    lines.push('');
+  }
+
+  // Output Issues
+  if (results.outputIssues && results.outputIssues.length > 0) {
+    lines.push(`### Output Format Issues (${results.outputIssues.length})`);
+    lines.push('');
+    lines.push('| Issue | Fix | Certainty |');
+    lines.push('|-------|-----|-----------|');
+    for (const issue of results.outputIssues) {
+      lines.push(`| ${issue.issue} | ${issue.fix || 'N/A'} | ${issue.certainty} |`);
+    }
+    lines.push('');
+  }
+
+  // Anti-Pattern Issues
+  if (results.antiPatternIssues && results.antiPatternIssues.length > 0) {
+    lines.push(`### Anti-Pattern Issues (${results.antiPatternIssues.length})`);
+    lines.push('');
+    lines.push('| Issue | Fix | Certainty |');
+    lines.push('|-------|-----|-----------|');
+    for (const issue of results.antiPatternIssues) {
+      lines.push(`| ${issue.issue} | ${issue.fix || 'N/A'} | ${issue.certainty} |`);
+    }
+    lines.push('');
+  }
+
+  // Code Validation Issues
+  if (results.codeValidationIssues && results.codeValidationIssues.length > 0) {
+    lines.push(`### Code Validation Issues (${results.codeValidationIssues.length})`);
+    lines.push('');
+    lines.push('| Issue | Fix | Certainty |');
+    lines.push('|-------|-----|-----------|');
+    for (const issue of results.codeValidationIssues) {
+      lines.push(`| ${issue.issue} | ${issue.fix || 'N/A'} | ${issue.certainty} |`);
+    }
+    lines.push('');
+  }
+
+  // No issues
+  if (allIssues.length === 0) {
+    lines.push('No issues found.');
+    lines.push('');
+  }
+
+  return lines.join('\n');
+}
+
+/**
+ * Generate summary report for multiple prompt analyses
+ * @param {Array} allResults - Array of prompt analysis results
+ * @param {Object} options - Report options
+ * @returns {string} Markdown report
+ */
+function generatePromptSummaryReport(allResults, options = {}) {
+  const lines = [];
+
+  lines.push('# Prompt Analysis Summary');
+  lines.push('');
+  lines.push(`**Analyzed**: ${allResults.length} prompts`);
+  lines.push(`**Date**: ${new Date().toISOString()}`);
+  lines.push('');
+
+  // Overall stats
+  let totalHigh = 0;
+  let totalMedium = 0;
+  let totalLow = 0;
+  let totalTokens = 0;
+
+  for (const result of allResults) {
+    const allIssues = [
+      ...(result.clarityIssues || []),
+      ...(result.structureIssues || []),
+      ...(result.exampleIssues || []),
+      ...(result.contextIssues || []),
+      ...(result.outputIssues || []),
+      ...(result.antiPatternIssues || []),
+      ...(result.codeValidationIssues || [])
+    ];
+    totalHigh += countByCertainty(allIssues, 'HIGH');
+    totalMedium += countByCertainty(allIssues, 'MEDIUM');
+    totalLow += countByCertainty(allIssues, 'LOW');
+    totalTokens += result.tokenCount || 0;
+  }
+
+  lines.push('## Overall');
+  lines.push('');
+  lines.push(`**Total Tokens**: ~${totalTokens}`);
+  lines.push('');
+  lines.push('| Certainty | Count |');
+  lines.push('|-----------|-------|');
+  lines.push(`| HIGH | ${totalHigh} |`);
+  lines.push(`| MEDIUM | ${totalMedium} |`);
+  if (options.verbose) {
+    lines.push(`| LOW | ${totalLow} |`);
+  }
+  lines.push('');
+
+  // Per-prompt summary
+  lines.push('## By Prompt');
+  lines.push('');
+  lines.push('| Prompt | Type | Tokens | HIGH | MEDIUM | LOW | Total |');
+  lines.push('|--------|------|--------|------|--------|-----|-------|');
+
+  for (const result of allResults) {
+    const allIssues = [
+      ...(result.clarityIssues || []),
+      ...(result.structureIssues || []),
+      ...(result.exampleIssues || []),
+      ...(result.contextIssues || []),
+      ...(result.outputIssues || []),
+      ...(result.antiPatternIssues || []),
+      ...(result.codeValidationIssues || [])
+    ];
+    const h = countByCertainty(allIssues, 'HIGH');
+    const m = countByCertainty(allIssues, 'MEDIUM');
+    const l = countByCertainty(allIssues, 'LOW');
+    lines.push(`| ${result.promptName} | ${result.promptType || '-'} | ${result.tokenCount} | ${h} | ${m} | ${l} | ${h + m + l} |`);
+  }
+
+  lines.push('');
+
+  return lines.join('\n');
+}
+
+/**
+ * Generate unified report for orchestrator aggregated results
+ * @param {Object} aggregatedResults - Aggregated results from all enhancers
+ * @param {Array} aggregatedResults.findings - All findings from all enhancers
+ * @param {Object} aggregatedResults.byEnhancer - Summary counts per enhancer
+ * @param {Object} aggregatedResults.totals - Overall totals
+ * @param {Object} options - Report options
+ * @param {boolean} options.verbose - Include LOW certainty issues
+ * @param {boolean} options.showAutoFixable - Highlight auto-fixable issues
+ * @param {string} options.targetPath - Target path analyzed
+ * @returns {string} Unified markdown report
+ */
+function generateOrchestratorReport(aggregatedResults, options = {}) {
+  const { verbose = false, showAutoFixable = false, targetPath = '.' } = options;
+  const lines = [];
+
+  // Header
+  lines.push('# Enhancement Analysis Report');
+  lines.push('');
+  lines.push(`**Target**: ${targetPath}`);
+  lines.push(`**Analyzed**: ${new Date().toISOString()}`);
+  lines.push(`**Enhancers Run**: ${Object.keys(aggregatedResults?.byEnhancer || {}).join(', ') || 'none'}`);
+  lines.push('');
+
+  // Deduplicate findings - ensure array input
+  const rawFindings = Array.isArray(aggregatedResults?.findings) ? aggregatedResults.findings : [];
+  const dedupedFindings = deduplicateOrchestratorFindings(rawFindings);
+
+  // Count auto-fixable
+  const autoFixableCount = dedupedFindings.filter(f => f.certainty === 'HIGH' && f.autoFixable).length;
+
+  // Executive Summary Table
+  lines.push('## Executive Summary');
+  lines.push('');
+  lines.push('| Enhancer | HIGH | MEDIUM | LOW | Auto-Fixable |');
+  lines.push('|----------|------|--------|-----|--------------|');
+
+  const enhancerTypes = ['plugin', 'agent', 'claudemd', 'docs', 'prompt', 'hooks', 'skills'];
+  let totalHigh = 0, totalMedium = 0, totalLow = 0, totalAutoFix = 0;
+
+  for (const enhancer of enhancerTypes) {
+    const enhancerFindings = dedupedFindings.filter(f => f.source === enhancer);
+    const high = enhancerFindings.filter(f => f.certainty === 'HIGH').length;
+    const medium = enhancerFindings.filter(f => f.certainty === 'MEDIUM').length;
+    const low = enhancerFindings.filter(f => f.certainty === 'LOW').length;
+    const autoFix = enhancerFindings.filter(f => f.certainty === 'HIGH' && f.autoFixable).length;
+
+    if (high > 0 || medium > 0 || low > 0) {
+      lines.push(`| ${enhancer} | ${high} | ${medium} | ${low} | ${autoFix} |`);
+      totalHigh += high;
+      totalMedium += medium;
+      totalLow += low;
+      totalAutoFix += autoFix;
+    }
+  }
+
+  lines.push(`| **Total** | **${totalHigh}** | **${totalMedium}** | **${totalLow}** | **${totalAutoFix}** |`);
+  lines.push('');
+
+  // Auto-Learned Suppressions Section (before "Clean" status)
+  if (options.autoLearned && options.autoLearned.length > 0) {
+    lines.push('## Auto-Learned Suppressions');
+    lines.push('');
+    lines.push(`Learned ${options.autoLearned.length} new false positives:`);
+    lines.push('');
+
+    // Group by pattern
+    const byPattern = {};
+    options.autoLearned.forEach(s => {
+      if (!byPattern[s.patternId]) {
+        byPattern[s.patternId] = [];
+      }
+      byPattern[s.patternId].push(s);
+    });
+
+    for (const [patternId, items] of Object.entries(byPattern)) {
+      const maxConf = Math.max(...items.map(i => i.confidence || 0));
+      lines.push(`- **${patternId}**: ${items.length} file(s) (confidence: ${(maxConf * 100).toFixed(0)}%)`);
+    }
+    lines.push('');
+  }
+
+  // No issues case
+  if (dedupedFindings.length === 0) {
+    lines.push('## Status: Clean');
+    lines.push('');
+    lines.push('No issues found.');
+    lines.push('');
+    return lines.join('\n');
+  }
+
+  lines.push('---');
+  lines.push('');
+
+  // HIGH Certainty Issues
+  const highFindings = dedupedFindings.filter(f => f.certainty === 'HIGH');
+  if (highFindings.length > 0) {
+    lines.push(`## HIGH Certainty Issues (${highFindings.length})`);
+    lines.push('');
+    lines.push('Issues that should be fixed. Auto-fixable issues marked with [AF].');
+    lines.push('');
+
+    // Group by source
+    const bySource = groupBySource(highFindings);
+    for (const [source, findings] of Object.entries(bySource)) {
+      lines.push(`### ${capitalizeFirst(source)} Issues (${findings.length})`);
+      lines.push('');
+      lines.push('| File | Line | Issue | Fix | [AF] |');
+      lines.push('|------|------|-------|-----|------|');
+      for (const finding of findings) {
+        const af = finding.autoFixable ? 'Yes' : 'No';
+        const line = finding.line || '-';
+        lines.push(`| ${finding.file || '-'} | ${line} | ${finding.issue} | ${finding.fix || '-'} | ${af} |`);
+      }
+      lines.push('');
+    }
+
+    lines.push('---');
+    lines.push('');
+  }
+
+  // MEDIUM Certainty Issues
+  const mediumFindings = dedupedFindings.filter(f => f.certainty === 'MEDIUM');
+  if (mediumFindings.length > 0) {
+    lines.push(`## MEDIUM Certainty Issues (${mediumFindings.length})`);
+    lines.push('');
+    lines.push('Issues that likely need attention. Verify context before fixing.');
+    lines.push('');
+
+    const bySource = groupBySource(mediumFindings);
+    for (const [source, findings] of Object.entries(bySource)) {
+      lines.push(`### ${capitalizeFirst(source)} Issues (${findings.length})`);
+      lines.push('');
+      lines.push('| File | Line | Issue | Fix |');
+      lines.push('|------|------|-------|-----|');
+      for (const finding of findings) {
+        const line = finding.line || '-';
+        lines.push(`| ${finding.file || '-'} | ${line} | ${finding.issue} | ${finding.fix || '-'} |`);
+      }
+      lines.push('');
+    }
+
+    lines.push('---');
+    lines.push('');
+  }
+
+  // LOW Certainty Issues (verbose only)
+  const lowFindings = dedupedFindings.filter(f => f.certainty === 'LOW');
+  if (verbose && lowFindings.length > 0) {
+    lines.push(`## LOW Certainty Issues (${lowFindings.length})`);
+    lines.push('');
+    lines.push('Advisory suggestions. Consider based on project needs.');
+    lines.push('');
+
+    const bySource = groupBySource(lowFindings);
+    for (const [source, findings] of Object.entries(bySource)) {
+      lines.push(`### ${capitalizeFirst(source)} Issues (${findings.length})`);
+      lines.push('');
+      lines.push('| File | Line | Issue | Fix |');
+      lines.push('|------|------|-------|-----|');
+      for (const finding of findings) {
+        const line = finding.line || '-';
+        lines.push(`| ${finding.file || '-'} | ${line} | ${finding.issue} | ${finding.fix || '-'} |`);
+      }
+      lines.push('');
+    }
+
+    lines.push('---');
+    lines.push('');
+  }
+
+  // Auto-Fix Summary
+  if (showAutoFixable && autoFixableCount > 0) {
+    lines.push('## Auto-Fix Summary');
+    lines.push('');
+    lines.push(`**${autoFixableCount} issues can be automatically fixed** with \`--apply\` flag:`);
+    lines.push('');
+    lines.push('| Enhancer | Issue Type | Count |');
+    lines.push('|----------|------------|-------|');
+
+    // Group auto-fixable by enhancer and issue type
+    const autoFixable = dedupedFindings.filter(f => f.certainty === 'HIGH' && f.autoFixable);
+    const grouped = {};
+    for (const finding of autoFixable) {
+      const key = `${finding.source}|${finding.category || 'general'}`;
+      if (!grouped[key]) {
+        grouped[key] = { source: finding.source, category: finding.category || 'general', count: 0 };
+      }
+      grouped[key].count++;
+    }
+
+    for (const item of Object.values(grouped)) {
+      lines.push(`| ${item.source} | ${item.category} | ${item.count} |`);
+    }
+    lines.push(`| **Total** | | **${autoFixableCount}** |`);
+    lines.push('');
+    lines.push('Run `/enhance --apply` to fix these automatically.');
+    lines.push('');
+  }
+
+  return lines.join('\n');
+}
+
+/**
+ * Deduplicate findings from multiple enhancers
+ * @param {Array} findings - All findings
+ * @returns {Array} Deduplicated findings
+ */
+function deduplicateOrchestratorFindings(findings) {
+  const seen = new Map();
+
+  for (const finding of findings) {
+    // Create hash for deduplication
+    const hash = [
+      finding.file || '',
+      finding.line || 0,
+      (finding.issue || '').toLowerCase().trim()
+    ].join('|');
+
+    if (!seen.has(hash)) {
+      seen.set(hash, { ...finding, sources: [finding.source] });
+    } else {
+      // Merge sources if same issue found by multiple enhancers
+      const existing = seen.get(hash);
+      if (!existing.sources.includes(finding.source)) {
+        existing.sources.push(finding.source);
+      }
+      // Prefer auto-fixable version
+      if (finding.autoFixable && !existing.autoFixable) {
+        existing.autoFixable = true;
+      }
+    }
+  }
+
+  return Array.from(seen.values());
+}
+
+/**
+ * Group findings by source enhancer
+ * @param {Array} findings - Findings to group
+ * @returns {Object} Grouped findings
+ */
+function groupBySource(findings) {
+  const grouped = {};
+  for (const finding of findings) {
+    const source = finding.source || 'unknown';
+    if (!grouped[source]) grouped[source] = [];
+    grouped[source].push(finding);
+  }
+  return grouped;
+}
+
+/**
+ * Capitalize first letter
+ * @param {string} str - String to capitalize
+ * @returns {string} Capitalized string
+ */
+function capitalizeFirst(str) {
+  if (!str) return '';
+  return str.charAt(0).toUpperCase() + str.slice(1);
+}
+
+module.exports = {
+  generateReport,
+  generateDiff,
+  generateSummaryReport,
+  generateAgentReport,
+  generateAgentSummaryReport,
+  generateDocsReport,
+  generateDocsSummaryReport,
+  generateProjectMemoryReport,
+  generateProjectMemorySummaryReport,
+  generatePromptReport,
+  generatePromptSummaryReport,
+  generateOrchestratorReport,
+  deduplicateOrchestratorFindings
+};