@documentation-robotics/cli 0.1.0 → 0.1.5

package/dist/export/audit-formatters.js

@@ -0,0 +1,479 @@
+import ansis from "ansis";
+import { escapeMarkdown } from "./markdown-utils.js";
+import { formatDate } from "../utils/date-utils.js";
+function formatAuditReport(report, options) {
+  switch (options.format) {
+    case "json":
+      return formatAuditJSON(report);
+    case "markdown":
+      return formatAuditMarkdown(report, options);
+    case "text":
+    default:
+      return formatAuditText(report, options);
+  }
+}
+function formatAuditJSON(report) {
+  return JSON.stringify(report, null, 2) + `
+`;
+}
+function formatAuditText(report, options) {
+  const lines = [];
+  return lines.push(""), lines.push(ansis.bold(`\u{1F50D} Relationship Audit Report: ${ansis.cyan(report.model.name)}`)), lines.push(ansis.dim("=".repeat(80))), lines.push(""), lines.push(`Generated: ${formatDate(report.timestamp)}`), lines.push(`Version: ${report.model.version}`), lines.push(""), formatExecutiveSummaryText(lines, report), lines.push(""), formatCoverageTextSummary(lines, report.coverage), lines.push(""), formatDuplicatesTextSummary(lines, report.duplicates), lines.push(""), formatGapsTextSummary(lines, report.gaps), lines.push(""), formatBalanceTextSummary(lines, report.balance), lines.push(""), formatConnectivityTextSummary(lines, report.connectivity), lines.push(""), options.verbose && (formatCoverageTextDetailed(lines, report.coverage), lines.push(""), formatDuplicatesTextDetailed(lines, report.duplicates), lines.push(""), formatGapsTextDetailed(lines, report.gaps), lines.push(""), formatBalanceTextDetailed(lines, report.balance), lines.push(""), formatConnectivityTextDetailed(lines, report.connectivity), lines.push("")), lines.join(`
+`);
+}
+function formatAuditMarkdown(report, _options) {
+  const lines = [];
+  return lines.push(`# Relationship Audit Report: ${escapeMarkdown(report.model.name)}`), lines.push(""), lines.push(`**Generated:** ${formatDate(report.timestamp)}`), lines.push(`**Version:** ${escapeMarkdown(report.model.version)}`), lines.push(""), lines.push("## Contents"), lines.push("- [Executive Summary](#executive-summary)"), lines.push("- [Coverage Analysis](#coverage-analysis)"), lines.push("- [Duplicate Detection](#duplicate-detection)"), lines.push("- [Gap Analysis](#gap-analysis)"), lines.push("- [Balance Assessment](#balance-assessment)"), lines.push("- [Connectivity Analysis](#connectivity-analysis)"), lines.push(""), formatExecutiveSummaryMarkdown(lines, report), lines.push(""), formatCoverageMarkdown(lines, report.coverage), lines.push(""), formatDuplicatesMarkdown(lines, report.duplicates), lines.push(""), formatGapsMarkdown(lines, report.gaps), lines.push(""), formatBalanceMarkdown(lines, report.balance), lines.push(""), formatConnectivityMarkdown(lines, report.connectivity), lines.push(""), lines.join(`
+`);
+}
+function formatExecutiveSummaryMarkdown(lines, report) {
+  lines.push("## Executive Summary"), lines.push("");
+  const totalNodeTypes = report.coverage.reduce((sum, c) => sum + c.nodeTypeCount, 0), totalIntra = report.coverage.reduce((sum, c) => sum + c.relationshipCount, 0), totalInter = report.coverage.reduce((sum, c) => sum + c.interLayerRelationshipCount, 0), totalRelationships = totalIntra + totalInter, totalIsolated = report.coverage.reduce((sum, c) => sum + c.isolatedNodeTypes.length, 0), avgUtilization = report.coverage.length > 0 ? report.coverage.reduce((sum, c) => sum + c.utilizationPercentage, 0) / report.coverage.length : 0;
+  lines.push("| Metric | Value |"), lines.push("|--------|-------|"), lines.push(`| Total Node Types | ${totalNodeTypes} |`), lines.push(`| Total Relationships | ${totalRelationships} (${totalIntra} intra-layer, ${totalInter} inter-layer) |`), lines.push(`| Isolated Node Types | ${totalIsolated} (${totalNodeTypes > 0 ? (totalIsolated / totalNodeTypes * 100).toFixed(1) : "0.0"}%) |`), lines.push(`| Average Predicate Utilization | ${avgUtilization.toFixed(1)}% |`), lines.push(`| Duplicate Candidates | ${report.duplicates.length} |`), lines.push(`| Gap Candidates | ${report.gaps.length} |`), lines.push(`| Balance Issues | ${report.balance.filter((b) => b.status !== "balanced").length} |`), lines.push(`| Connected Components | ${report.connectivity.stats.connectedComponents} |`), lines.push("");
+}
+function formatExecutiveSummaryText(lines, report) {
+  lines.push(ansis.bold.yellow("EXECUTIVE SUMMARY")), lines.push(ansis.dim("\u2500".repeat(60))), lines.push("");
+  const totalNodeTypes = report.coverage.reduce((sum, c) => sum + c.nodeTypeCount, 0), totalIntra = report.coverage.reduce((sum, c) => sum + c.relationshipCount, 0), totalInter = report.coverage.reduce((sum, c) => sum + c.interLayerRelationshipCount, 0), totalRelationships = totalIntra + totalInter, totalIsolated = report.coverage.reduce((sum, c) => sum + c.isolatedNodeTypes.length, 0), avgUtilization = report.coverage.length > 0 ? report.coverage.reduce((sum, c) => sum + c.utilizationPercentage, 0) / report.coverage.length : 0;
+  lines.push(ansis.bold("Key Metrics:")), lines.push(`  Total Node Types:          ${totalNodeTypes}`), lines.push(`  Total Relationships:       ${totalRelationships} (${totalIntra} intra-layer, ${totalInter} inter-layer)`), lines.push(`  Isolated Node Types:       ${totalIsolated} (${totalNodeTypes > 0 ? (totalIsolated / totalNodeTypes * 100).toFixed(1) : "0.0"}%)`), lines.push(`  Avg Predicate Utilization: ${avgUtilization.toFixed(1)}%`), lines.push(`  Duplicate Candidates:      ${report.duplicates.length}`), lines.push(`  Gap Candidates:            ${report.gaps.length}`), lines.push(`  Balance Issues:            ${report.balance.filter((b) => b.status !== "balanced").length}`), lines.push(`  Connected Components:      ${report.connectivity.stats.connectedComponents}`);
+}
+function formatCoverageTextSummary(lines, coverage) {
+  lines.push(ansis.bold("Coverage Analysis Summary:"));
+  const totalNodeTypes = coverage.reduce((sum, c) => sum + c.nodeTypeCount, 0), totalIntra = coverage.reduce((sum, c) => sum + c.relationshipCount, 0), totalInter = coverage.reduce((sum, c) => sum + c.interLayerRelationshipCount, 0), totalRelationships = totalIntra + totalInter, totalIsolated = coverage.reduce((sum, c) => sum + c.isolatedNodeTypes.length, 0), avgUtilization = coverage.length > 0 ? coverage.reduce((sum, c) => sum + c.utilizationPercentage, 0) / coverage.length : 0;
+  lines.push(`  Total Node Types:          ${totalNodeTypes}`), lines.push(`  Total Relationships:       ${totalRelationships} (${totalIntra} intra-layer, ${totalInter} inter-layer)`), lines.push(`  Isolated Node Types:       ${totalIsolated} (${totalNodeTypes > 0 ? (totalIsolated / totalNodeTypes * 100).toFixed(1) : "0.0"}%)`), lines.push(`  Avg Predicate Utilization: ${avgUtilization.toFixed(1)}%`);
+  const zeroLayers = coverage.filter((c) => c.relationshipCount === 0 && c.interLayerRelationshipCount === 0);
+  zeroLayers.length > 0 && (lines.push(""), lines.push(ansis.yellow(`  \u26A0\uFE0F  Layers with zero relationships: ${zeroLayers.map((l) => l.layer).join(", ")}`)));
+}
+function formatCoverageTextDetailed(lines, coverage) {
+  lines.push(ansis.bold("Coverage Analysis (Detailed):")), lines.push("");
+  for (const layer of coverage) {
+    const layerTotal = layer.relationshipCount + layer.interLayerRelationshipCount;
+    lines.push(ansis.bold(`  ${layer.layer}:`)), lines.push(`    Node Types:          ${layer.nodeTypeCount}`), lines.push(`    Relationships:       ${layerTotal} total (${layer.relationshipCount} intra-layer, ${layer.interLayerRelationshipCount} inter-layer)`), lines.push(`    Isolated Types:      ${layer.isolatedNodeTypes.length} (${layer.isolationPercentage.toFixed(1)}%)`), lines.push(`    Predicate Usage:     ${layer.usedPredicates.length}/${layer.availablePredicates.length} (${layer.utilizationPercentage.toFixed(1)}%)`), lines.push(`    Density:             ${layer.relationshipsPerNodeType.toFixed(2)} rel/type`), layer.standardAlignment && (lines.push(`    Standard Alignment:  ${layer.standardAlignment.standard}`), lines.push(`      Expected:          ${layer.standardAlignment.expectedRelationships}`), lines.push(`      Missing:           ${layer.standardAlignment.missingFromStandard.length}`)), layer.isolatedNodeTypes.length > 0 && layer.isolatedNodeTypes.length <= 10 && lines.push(`    Isolated:            ${layer.isolatedNodeTypes.join(", ")}`), lines.push("");
+  }
+}
+function formatCoverageMarkdown(lines, coverage) {
+  lines.push("## Coverage Analysis"), lines.push(""), lines.push("### By Layer"), lines.push(""), lines.push("| Layer | Node Types | Intra-Layer | Inter-Layer | Total | Isolated | Predicate Usage | Density |"), lines.push("|-------|------------|-------------|-------------|-------|----------|-----------------|---------|");
+  for (const layer of coverage) {
+    const layerTotal = layer.relationshipCount + layer.interLayerRelationshipCount, isolated = `${layer.isolatedNodeTypes.length} (${layer.isolationPercentage.toFixed(0)}%)`, predicates = `${layer.usedPredicates.length}/${layer.availablePredicates.length} (${layer.utilizationPercentage.toFixed(0)}%)`, density = layer.relationshipsPerNodeType.toFixed(2);
+    lines.push(`| ${escapeMarkdown(layer.layer)} | ${layer.nodeTypeCount} | ${layer.relationshipCount} | ${layer.interLayerRelationshipCount} | ${layerTotal} | ${isolated} | ${predicates} | ${density} |`);
+  }
+  lines.push("");
+  const alignedLayers = coverage.filter((c) => c.standardAlignment);
+  if (alignedLayers.length > 0) {
+    lines.push("### Standard Alignment"), lines.push(""), lines.push("| Layer | Standard | Expected | Missing |"), lines.push("|-------|----------|----------|---------|");
+    for (const layer of alignedLayers)
+      layer.standardAlignment && lines.push(`| ${escapeMarkdown(layer.layer)} | ${escapeMarkdown(layer.standardAlignment.standard)} | ${layer.standardAlignment.expectedRelationships} | ${layer.standardAlignment.missingFromStandard.length} |`);
+    lines.push("");
+  }
+}
+function formatDuplicatesTextSummary(lines, duplicates) {
+  lines.push(ansis.bold("Duplicate Detection Summary:"));
+  const byConfidence = {
+    high: duplicates.filter((d) => d.confidence === "high").length,
+    medium: duplicates.filter((d) => d.confidence === "medium").length,
+    low: duplicates.filter((d) => d.confidence === "low").length
+  };
+  lines.push(`  Total Candidates:    ${duplicates.length}`), lines.push(`  High Confidence:     ${byConfidence.high}`), lines.push(`  Medium Confidence:   ${byConfidence.medium}`), lines.push(`  Low Confidence:      ${byConfidence.low}`), byConfidence.high > 0 && (lines.push(""), lines.push(ansis.yellow(`  \u26A0\uFE0F  ${byConfidence.high} high-confidence duplicates require review`)));
+}
+function formatDuplicatesTextDetailed(lines, duplicates) {
+  if (lines.push(ansis.bold("Duplicate Detection (Detailed):")), lines.push(""), duplicates.length === 0) {
+    lines.push("  No duplicate candidates detected."), lines.push("");
+    return;
+  }
+  const sorted = [...duplicates].sort((a, b) => {
+    const order = { high: 0, medium: 1, low: 2 };
+    return order[a.confidence] - order[b.confidence];
+  });
+  for (const dup of sorted.slice(0, 20)) {
+    const confidenceColor = dup.confidence === "high" ? ansis.red : dup.confidence === "medium" ? ansis.yellow : ansis.gray;
+    lines.push(confidenceColor(`  [${dup.confidence.toUpperCase()}] ${dup.sourceNodeType} \u2192 ${dup.destinationNodeType}`)), lines.push(`    Predicates: ${dup.predicates[0]} / ${dup.predicates[1]}`), lines.push(`    Reason: ${dup.reason}`), lines.push("");
+  }
+  duplicates.length > 20 && (lines.push(ansis.dim(`  ... and ${duplicates.length - 20} more`)), lines.push(""));
+}
+function formatDuplicatesMarkdown(lines, duplicates) {
+  if (lines.push("## Duplicate Detection"), lines.push(""), duplicates.length === 0) {
+    lines.push("No duplicate candidates detected."), lines.push("");
+    return;
+  }
+  const byConfidence = {
+    high: duplicates.filter((d) => d.confidence === "high"),
+    medium: duplicates.filter((d) => d.confidence === "medium"),
+    low: duplicates.filter((d) => d.confidence === "low")
+  };
+  if (lines.push("### Summary"), lines.push(""), lines.push("| Confidence | Count |"), lines.push("|------------|-------|"), lines.push(`| High | ${byConfidence.high.length} |`), lines.push(`| Medium | ${byConfidence.medium.length} |`), lines.push(`| Low | ${byConfidence.low.length} |`), lines.push(""), byConfidence.high.length > 0) {
+    lines.push("### High Confidence Duplicates"), lines.push(""), lines.push("| Source \u2192 Destination | Predicates | Reason |"), lines.push("|----------------------|------------|--------|");
+    for (const dup of byConfidence.high) {
+      const route = `${escapeMarkdown(dup.sourceNodeType)} \u2192 ${escapeMarkdown(dup.destinationNodeType)}`, predicates = `${escapeMarkdown(dup.predicates[0])} / ${escapeMarkdown(dup.predicates[1])}`;
+      lines.push(`| ${route} | ${predicates} | ${escapeMarkdown(dup.reason)} |`);
+    }
+    lines.push("");
+  }
+  if (byConfidence.medium.length > 0) {
+    lines.push("### Medium Confidence Duplicates"), lines.push(""), lines.push("| Source \u2192 Destination | Predicates | Reason |"), lines.push("|----------------------|------------|--------|");
+    for (const dup of byConfidence.medium) {
+      const route = `${escapeMarkdown(dup.sourceNodeType)} \u2192 ${escapeMarkdown(dup.destinationNodeType)}`, predicates = `${escapeMarkdown(dup.predicates[0])} / ${escapeMarkdown(dup.predicates[1])}`;
+      lines.push(`| ${route} | ${predicates} | ${escapeMarkdown(dup.reason)} |`);
+    }
+    lines.push("");
+  }
+}
+function formatGapsTextSummary(lines, gaps) {
+  lines.push(ansis.bold("Gap Analysis Summary:"));
+  const byPriority = {
+    high: gaps.filter((g) => g.priority === "high").length,
+    medium: gaps.filter((g) => g.priority === "medium").length,
+    low: gaps.filter((g) => g.priority === "low").length
+  };
+  lines.push(`  Total Gaps:        ${gaps.length}`), lines.push(`  High Priority:     ${byPriority.high}`), lines.push(`  Medium Priority:   ${byPriority.medium}`), lines.push(`  Low Priority:      ${byPriority.low}`), byPriority.high > 0 && (lines.push(""), lines.push(ansis.red(`  \u{1F6A8} ${byPriority.high} high-priority gaps detected`))), byPriority.medium > 50 && (lines.push(""), lines.push(ansis.yellow(`  \u26A0 ${byPriority.medium} medium-priority gaps \u2014 model coverage is partially complete`)), lines.push(ansis.dim("    Run /dr-relate to wire up architectural connections")));
+}
+function formatGapsTextDetailed(lines, gaps) {
+  if (lines.push(ansis.bold("Gap Analysis (Detailed):")), lines.push(""), gaps.length === 0) {
+    lines.push("  No gaps detected."), lines.push("");
+    return;
+  }
+  const sorted = [...gaps].sort((a, b) => {
+    const order = { high: 0, medium: 1, low: 2 };
+    return order[a.priority] - order[b.priority];
+  });
+  for (const gap of sorted.slice(0, 20)) {
+    const priorityColor = gap.priority === "high" ? ansis.red : gap.priority === "medium" ? ansis.yellow : ansis.gray;
+    lines.push(priorityColor(`  [${gap.priority.toUpperCase()}] ${gap.sourceNodeType} \u2192 ${gap.destinationNodeType}`)), lines.push(`    Suggested: ${gap.suggestedPredicate}`), lines.push(`    Reason: ${gap.reason}`), gap.standardReference && lines.push(`    Reference: ${gap.standardReference}`), lines.push("");
+  }
+  gaps.length > 20 && (lines.push(ansis.dim(`  ... and ${gaps.length - 20} more`)), lines.push(""));
+}
+function formatGapsMarkdown(lines, gaps) {
+  if (lines.push("## Gap Analysis"), lines.push(""), gaps.length === 0) {
+    lines.push("No relationship gaps detected."), lines.push("");
+    return;
+  }
+  const byPriority = {
+    high: gaps.filter((g) => g.priority === "high"),
+    medium: gaps.filter((g) => g.priority === "medium"),
+    low: gaps.filter((g) => g.priority === "low")
+  };
+  if (lines.push("### Summary"), lines.push(""), lines.push("| Priority | Count |"), lines.push("|----------|-------|"), lines.push(`| High | ${byPriority.high.length} |`), lines.push(`| Medium | ${byPriority.medium.length} |`), lines.push(`| Low | ${byPriority.low.length} |`), lines.push(""), byPriority.high.length > 0) {
+    lines.push("### High Priority Gaps"), lines.push(""), lines.push("| Source \u2192 Destination | Suggested Predicate | Reason | Reference |"), lines.push("|----------------------|---------------------|--------|-----------|");
+    for (const gap of byPriority.high) {
+      const route = `${escapeMarkdown(gap.sourceNodeType)} \u2192 ${escapeMarkdown(gap.destinationNodeType)}`, predicate = escapeMarkdown(gap.suggestedPredicate), reason = escapeMarkdown(gap.reason), ref = gap.standardReference ? escapeMarkdown(gap.standardReference) : "-";
+      lines.push(`| ${route} | ${predicate} | ${reason} | ${ref} |`);
+    }
+    lines.push("");
+  }
+  if (byPriority.medium.length > 0) {
+    lines.push("### Medium Priority Gaps"), lines.push(""), lines.push("| Source \u2192 Destination | Suggested Predicate | Reason | Reference |"), lines.push("|----------------------|---------------------|--------|-----------|");
+    for (const gap of byPriority.medium) {
+      const route = `${escapeMarkdown(gap.sourceNodeType)} \u2192 ${escapeMarkdown(gap.destinationNodeType)}`, predicate = escapeMarkdown(gap.suggestedPredicate), reason = escapeMarkdown(gap.reason), ref = gap.standardReference ? escapeMarkdown(gap.standardReference) : "-";
+      lines.push(`| ${route} | ${predicate} | ${reason} | ${ref} |`);
+    }
+    lines.push(""), byPriority.medium.length > 50 && (lines.push(`> **Note:** ${byPriority.medium.length} medium-priority gaps \u2014 model coverage is partially complete. Run \`/dr-relate\` to wire architectural connections.`), lines.push(""));
+  }
+}
+function formatBalanceTextSummary(lines, balance) {
+  lines.push(ansis.bold("Balance Assessment Summary:"));
+  const byStatus = {
+    under: balance.filter((b) => b.status === "under").length,
+    balanced: balance.filter((b) => b.status === "balanced").length,
+    over: balance.filter((b) => b.status === "over").length
+  };
+  lines.push(`  Total Assessed:    ${balance.length}`), lines.push(`  Under-connected:   ${byStatus.under}`), lines.push(`  Balanced:          ${byStatus.balanced}`), lines.push(`  Over-connected:    ${byStatus.over}`);
+  const issueCount = byStatus.under + byStatus.over;
+  issueCount > 0 && (lines.push(""), lines.push(ansis.yellow(`  \u26A0\uFE0F  ${issueCount} node types have relationship density issues`)));
+}
+function formatBalanceTextDetailed(lines, balance) {
+  if (lines.push(ansis.bold("Balance Assessment (Detailed):")), lines.push(""), balance.length === 0) {
+    lines.push("  All assessed node types are balanced."), lines.push("");
+    return;
+  }
+  const issues = balance.filter((b) => b.status !== "balanced"), sorted = [...issues].sort((a, b) => a.status === "under" && b.status !== "under" ? -1 : a.status !== "under" && b.status === "under" ? 1 : 0);
+  for (const item of sorted.slice(0, 20)) {
+    const statusColor = item.status === "under" ? ansis.red : item.status === "over" ? ansis.yellow : ansis.green, statusLabel = item.status.toUpperCase();
+    lines.push(statusColor(`  [${statusLabel}] ${item.nodeType} (${item.layer})`)), lines.push(`    Category: ${item.category}`), lines.push(`    Current:  ${item.currentCount} relationships`), lines.push(`    Target:   ${item.targetRange[0]}-${item.targetRange[1]} relationships`), item.recommendation && lines.push(`    Advice:   ${item.recommendation}`), lines.push("");
+  }
+  issues.length > 20 && (lines.push(ansis.dim(`  ... and ${issues.length - 20} more`)), lines.push(""));
+}
+function formatBalanceMarkdown(lines, balance) {
+  if (lines.push("## Balance Assessment"), lines.push(""), balance.length === 0) {
+    lines.push("No balance assessments available."), lines.push("");
+    return;
+  }
+  const byStatus = {
+    under: balance.filter((b) => b.status === "under"),
+    balanced: balance.filter((b) => b.status === "balanced"),
+    over: balance.filter((b) => b.status === "over")
+  };
+  if (lines.push("### Summary"), lines.push(""), lines.push("| Status | Count |"), lines.push("|--------|-------|"), lines.push(`| Under-connected | ${byStatus.under.length} |`), lines.push(`| Balanced | ${byStatus.balanced.length} |`), lines.push(`| Over-connected | ${byStatus.over.length} |`), lines.push(""), byStatus.under.length > 0) {
+    lines.push("### Under-connected Node Types"), lines.push(""), lines.push("| Node Type | Layer | Category | Current | Target | Recommendation |"), lines.push("|-----------|-------|----------|---------|--------|----------------|");
+    for (const item of byStatus.under) {
+      const target = `${item.targetRange[0]}-${item.targetRange[1]}`, rec = item.recommendation ? escapeMarkdown(item.recommendation) : "-";
+      lines.push(`| ${escapeMarkdown(item.nodeType)} | ${escapeMarkdown(item.layer)} | ${item.category} | ${item.currentCount} | ${target} | ${rec} |`);
+    }
+    lines.push("");
+  }
+  if (byStatus.over.length > 0) {
+    lines.push("### Over-connected Node Types"), lines.push(""), lines.push("| Node Type | Layer | Category | Current | Target | Recommendation |"), lines.push("|-----------|-------|----------|---------|--------|----------------|");
+    for (const item of byStatus.over) {
+      const target = `${item.targetRange[0]}-${item.targetRange[1]}`, rec = item.recommendation ? escapeMarkdown(item.recommendation) : "-";
+      lines.push(`| ${escapeMarkdown(item.nodeType)} | ${escapeMarkdown(item.layer)} | ${item.category} | ${item.currentCount} | ${target} | ${rec} |`);
+    }
+    lines.push("");
+  }
+}
+function formatConnectivityTextSummary(lines, connectivity) {
+  lines.push(ansis.bold("Connectivity Analysis Summary:"));
+  const stats = connectivity.stats;
+  lines.push(`  Total Nodes:            ${stats.totalNodes}`), lines.push(`  Total Edges:            ${stats.totalEdges}`), lines.push(`  Connected Components:   ${stats.connectedComponents}`), lines.push(`  Largest Component:      ${stats.largestComponentSize} nodes`), lines.push(`  Isolated Nodes:         ${stats.isolatedNodes}`), lines.push(`  Average Degree:         ${stats.averageDegree.toFixed(2)}`), lines.push(`  Transitive Chains:      ${stats.transitiveChainCount}`), stats.connectedComponents > 1 && (lines.push(""), lines.push(ansis.yellow(`  \u26A0\uFE0F  Graph is fragmented into ${stats.connectedComponents} components`)));
+}
+function formatConnectivityTextDetailed(lines, connectivity) {
+  if (lines.push(ansis.bold("Connectivity Analysis (Detailed):")), lines.push(""), connectivity.components.length > 1) {
+    lines.push(ansis.bold("  Connected Components:"));
+    const sorted = [...connectivity.components].sort((a, b) => b.nodes.length - a.nodes.length);
+    for (let i = 0; i < Math.min(5, sorted.length); i++) {
+      const comp = sorted[i];
+      lines.push(`    Component ${i + 1}: ${comp.nodes.length} nodes`), comp.nodes.length <= 5 && lines.push(`      ${comp.nodes.join(", ")}`);
+    }
+    lines.push("");
+  }
+  if (connectivity.degrees.length > 0) {
+    lines.push(ansis.bold("  Top Connected Nodes:"));
+    const sorted = [...connectivity.degrees].sort((a, b) => b.totalDegree - a.totalDegree);
+    for (const node of sorted.slice(0, 10))
+      lines.push(`    ${node.nodeType.padEnd(40)} Total: ${String(node.totalDegree).padStart(3)} (In: ${node.inDegree}, Out: ${node.outDegree})`);
+    lines.push("");
+  }
+  if (connectivity.transitiveChains.length > 0) {
+    lines.push(ansis.bold("  Transitive Chains:"));
+    const sorted = [...connectivity.transitiveChains].sort((a, b) => b.chain.length - a.chain.length);
+    for (const chain of sorted.slice(0, 5))
+      lines.push(`    [${chain.predicate}] ${chain.chain.join(" \u2192 ")} (${chain.chain.length} hops)`);
+    lines.push("");
+  }
+}
+function formatConnectivityMarkdown(lines, connectivity) {
+  lines.push("## Connectivity Analysis"), lines.push("");
+  const stats = connectivity.stats;
+  if (lines.push("### Summary"), lines.push(""), lines.push("| Metric | Value |"), lines.push("|--------|-------|"), lines.push(`| Total Nodes | ${stats.totalNodes} |`), lines.push(`| Total Edges | ${stats.totalEdges} |`), lines.push(`| Connected Components | ${stats.connectedComponents} |`), lines.push(`| Largest Component | ${stats.largestComponentSize} nodes |`), lines.push(`| Isolated Nodes | ${stats.isolatedNodes} |`), lines.push(`| Average Degree | ${stats.averageDegree.toFixed(2)} |`), lines.push(`| Transitive Chains | ${stats.transitiveChainCount} |`), lines.push(""), connectivity.components.length > 1) {
+    lines.push("### Connected Components"), lines.push(""), lines.push("| Component | Size | Sample Nodes |"), lines.push("|-----------|------|--------------|");
+    const sorted = [...connectivity.components].sort((a, b) => b.nodes.length - a.nodes.length);
+    for (let i = 0; i < Math.min(10, sorted.length); i++) {
+      const comp = sorted[i], sample = comp.nodes.slice(0, 3).map(escapeMarkdown).join(", "), sampleText = comp.nodes.length > 3 ? `${sample}...` : sample;
+      lines.push(`| ${i + 1} | ${comp.nodes.length} | ${sampleText} |`);
+    }
+    lines.push("");
+  }
+  if (connectivity.degrees.length > 0) {
+    lines.push("### Top Connected Nodes"), lines.push(""), lines.push("| Node Type | In-Degree | Out-Degree | Total |"), lines.push("|-----------|-----------|------------|-------|");
+    const sorted = [...connectivity.degrees].sort((a, b) => b.totalDegree - a.totalDegree);
+    for (const node of sorted.slice(0, 20))
+      lines.push(`| ${escapeMarkdown(node.nodeType)} | ${node.inDegree} | ${node.outDegree} | ${node.totalDegree} |`);
+    lines.push("");
+  }
+  if (connectivity.transitiveChains.length > 0) {
+    lines.push("### Transitive Chains"), lines.push(""), lines.push("| Predicate | Chain | Length |"), lines.push("|-----------|-------|--------|");
+    const sorted = [...connectivity.transitiveChains].sort((a, b) => b.chain.length - a.chain.length);
+    for (const chain of sorted.slice(0, 20)) {
+      const chainStr = chain.chain.map(escapeMarkdown).join(" \u2192 ");
+      lines.push(`| ${escapeMarkdown(chain.predicate)} | ${chainStr} | ${chain.chain.length} |`);
+    }
+    lines.push("");
+  }
+}
+function formatNodeAuditReport(report, options) {
+  switch (options.format) {
+    case "json":
+      return JSON.stringify(report, null, 2) + `
+`;
+    case "markdown":
+      return formatNodeAuditMarkdown(report, options);
+    default:
+      return formatNodeAuditText(report, options);
+  }
+}
+function formatNodeAuditText(report, options) {
+  const lines = [];
+  return lines.push(""), lines.push(ansis.bold(`\u{1F50D} Node Audit Report \u2014 Spec v${ansis.cyan(report.spec.version)}`)), lines.push(ansis.dim("=".repeat(80))), lines.push(""), lines.push(`Generated: ${formatDate(report.timestamp)}`), lines.push(`Total Node Types: ${report.spec.totalNodeTypes}  |  Layers: ${report.spec.totalLayers}`), lines.push(""), formatNodeExecutiveSummaryText(lines, report), lines.push(""), formatNodeLayerSummaryText(lines, report.layerSummaries), lines.push(""), formatNodeDefinitionIssuesText(lines, report.definitionQuality, options.verbose ?? !1), lines.push(""), formatNodeOverlapsText(lines, report.overlaps), lines.push(""), formatNodeCompletenessText(lines, report.completenessIssues), lines.push(""), report.aiReviews && (formatNodeAIReviewsText(lines, report.aiReviews, options.verbose ?? !1), lines.push("")), options.verbose && (formatNodeDetailsVerboseText(lines, report.definitionQuality), lines.push("")), lines.join(`
+`);
+}
+function formatNodeExecutiveSummaryText(lines, report) {
+  lines.push(ansis.bold.yellow("EXECUTIVE SUMMARY")), lines.push(ansis.dim("\u2500".repeat(60))), lines.push("");
+  const totalErrors = report.layerSummaries.reduce((s, l) => s + l.errorCount, 0), totalWarnings = report.layerSummaries.reduce((s, l) => s + l.warningCount, 0), totalEmpty = report.layerSummaries.reduce((s, l) => s + l.emptyDescriptionCount, 0), totalGeneric = report.layerSummaries.reduce((s, l) => s + l.genericDescriptionCount, 0), totalGood = report.layerSummaries.reduce((s, l) => s + l.goodDescriptionCount, 0), highOverlaps = report.overlaps.filter((o) => o.confidence === "high").length, completenessErrors = report.completenessIssues.filter((i) => i.issueType === "missing_schema").length, avgScore = report.layerSummaries.length > 0 ? report.layerSummaries.reduce((s, l) => s + l.avgQualityScore, 0) / report.layerSummaries.length : 0;
+  lines.push(ansis.bold("Key Metrics:")), lines.push(`  Total Node Types:          ${report.spec.totalNodeTypes}`), lines.push(`  Avg Quality Score:         ${avgScore.toFixed(1)}/100`), lines.push(`  Empty Descriptions:        ${totalEmpty}`), lines.push(`  Generic Descriptions:      ${totalGeneric}`), lines.push(`  Good Descriptions:         ${totalGood}`), lines.push(`  Definition Errors:         ${totalErrors}`), lines.push(`  Definition Warnings:       ${totalWarnings}`), lines.push(`  Semantic Overlaps:         ${report.overlaps.length} (${highOverlaps} high-confidence)`), lines.push(`  Completeness Issues:       ${report.completenessIssues.length} (${completenessErrors} missing schemas)`);
+}
+function formatNodeLayerSummaryText(lines, summaries) {
+  lines.push(ansis.bold("Layer Summary:")), lines.push("");
+  const header = [
+    "Layer".padEnd(14),
+    "Types".padStart(6),
+    "Avg Score".padStart(10),
+    "Empty".padStart(6),
+    "Generic".padStart(8),
+    "Good".padStart(6),
+    "Errors".padStart(7),
+    "Warns".padStart(6)
+  ].join("  ");
+  lines.push("  " + ansis.dim(header)), lines.push("  " + ansis.dim("\u2500".repeat(header.length)));
+  for (const s of summaries) {
+    const scoreColor = s.avgQualityScore >= 80 ? ansis.green : s.avgQualityScore >= 60 ? ansis.yellow : ansis.red, scoreStr = s.avgQualityScore.toFixed(1).padStart(10), emptyStr = String(s.emptyDescriptionCount).padStart(6), errorStr = String(s.errorCount).padStart(7), warnStr = String(s.warningCount).padStart(6), row = [
+      s.layerId.padEnd(14),
+      String(s.totalNodeTypes).padStart(6),
+      scoreColor(scoreStr),
+      s.emptyDescriptionCount > 0 ? ansis.red(emptyStr) : emptyStr,
+      String(s.genericDescriptionCount).padStart(8),
+      String(s.goodDescriptionCount).padStart(6),
+      s.errorCount > 0 ? ansis.red(errorStr) : errorStr,
+      s.warningCount > 0 ? ansis.yellow(warnStr) : warnStr
+    ].join("  ");
+    lines.push("  " + row);
+  }
+}
+function formatNodeDefinitionIssuesText(lines, quality, verbose) {
+  const allIssues = quality.flatMap((q) => q.issues.map((issue) => ({ ...issue, specNodeId: q.specNodeId }))), errors = allIssues.filter((i) => i.severity === "error"), warnings = allIssues.filter((i) => i.severity === "warning"), infos = allIssues.filter((i) => i.severity === "info");
+  if (lines.push(ansis.bold("Definition Quality Issues:")), lines.push(`  Errors: ${errors.length}  Warnings: ${warnings.length}  Info: ${infos.length}`), errors.length > 0) {
+    lines.push(""), lines.push(ansis.red.bold("  Errors:"));
+    for (const issue of errors.slice(0, 20))
+      lines.push(ansis.red(`    [ERROR] ${issue.message}`));
+    errors.length > 20 && lines.push(ansis.dim(`    ... and ${errors.length - 20} more`));
+  }
+  if (warnings.length > 0) {
+    lines.push(""), lines.push(ansis.yellow.bold("  Warnings:"));
+    const shown = verbose ? warnings : warnings.slice(0, 10);
+    for (const issue of shown)
+      lines.push(ansis.yellow(`    [WARN]  ${issue.message}`));
+    !verbose && warnings.length > 10 && lines.push(ansis.dim(`    ... and ${warnings.length - 10} more (use --verbose to see all)`));
+  }
+  if (verbose && infos.length > 0) {
+    lines.push(""), lines.push(ansis.dim.bold("  Info:"));
+    for (const issue of infos)
+      lines.push(ansis.dim(`    [INFO]  ${issue.message}`));
+  }
+}
+function formatNodeOverlapsText(lines, overlaps) {
+  lines.push(ansis.bold("Semantic Overlap Detection:"));
+  const high = overlaps.filter((o) => o.confidence === "high"), medium = overlaps.filter((o) => o.confidence === "medium"), low = overlaps.filter((o) => o.confidence === "low");
+  if (lines.push(`  Total Candidates: ${overlaps.length}  (High: ${high.length}, Medium: ${medium.length}, Low: ${low.length})`), high.length > 0) {
+    lines.push(""), lines.push(ansis.yellow("  High-confidence overlaps:"));
+    for (const o of high.slice(0, 10))
+      lines.push(ansis.yellow(`    ${o.nodeTypeA} \u2194 ${o.nodeTypeB}`)), lines.push(ansis.dim(`      ${o.reason}`));
+    high.length > 10 && lines.push(ansis.dim(`    ... and ${high.length - 10} more`));
+  }
+}
+function formatNodeCompletenessText(lines, issues) {
+  if (lines.push(ansis.bold("Schema Completeness:")), issues.length === 0) {
+    lines.push(ansis.green("  \u2713 All schema files match layer.json declarations \u2014 no issues found."));
+    return;
+  }
+  const missing = issues.filter((i) => i.issueType === "missing_schema"), orphaned = issues.filter((i) => i.issueType === "orphaned_schema");
+  lines.push(`  Issues: ${issues.length}  (Missing: ${missing.length}, Orphaned: ${orphaned.length})`);
+  for (const issue of issues.slice(0, 20)) {
+    const label = issue.issueType === "missing_schema" ? ansis.red("[MISSING]") : ansis.yellow("[ORPHANED]");
+    lines.push(`  ${label} ${issue.detail}`);
+  }
+  issues.length > 20 && lines.push(ansis.dim(`  ... and ${issues.length - 20} more`));
+}
+function formatNodeDetailsVerboseText(lines, quality) {
+  lines.push(ansis.bold("Per-Node Details (verbose):")), lines.push("");
+  const byLayer = /* @__PURE__ */ new Map();
+  for (const q of quality) {
+    const group = byLayer.get(q.layerId) ?? [];
+    group.push(q), byLayer.set(q.layerId, group);
+  }
+  for (const [layerId, layerQuality] of byLayer) {
+    lines.push(ansis.bold(`  ${layerId}:`));
+    for (const q of layerQuality) {
+      const scoreColor = q.score >= 80 ? ansis.green : q.score >= 60 ? ansis.yellow : ansis.red;
+      lines.push(`    ${q.specNodeId.padEnd(45)} ${scoreColor(`${q.score}/100`)}`);
+    }
+    lines.push("");
+  }
+}
+function formatNodeAIReviewsText(lines, reviews, verbose) {
+  lines.push(ansis.bold("AI Evaluation:")), lines.push(ansis.dim("\u2500".repeat(60))), lines.push("");
+  const header = [
+    "Layer".padEnd(14),
+    "Alignment".padStart(10),
+    "Documentation".padStart(14),
+    "Nodes".padStart(6)
+  ].join("  ");
+  lines.push("  " + ansis.dim(header)), lines.push("  " + ansis.dim("\u2500".repeat(header.length)));
+  for (const review of reviews) {
+    const alignColor = review.avgAlignmentScore >= 70 ? ansis.green : review.avgAlignmentScore >= 50 ? ansis.yellow : ansis.red, docColor = review.avgDocumentationScore >= 65 ? ansis.green : review.avgDocumentationScore >= 45 ? ansis.yellow : ansis.red, row = [
+      review.layerId.padEnd(14),
+      alignColor(review.avgAlignmentScore.toFixed(1).padStart(10)),
+      docColor(review.avgDocumentationScore.toFixed(1).padStart(14)),
+      String(review.nodeEvaluations.length).padStart(6)
+    ].join("  ");
+    lines.push("  " + row);
+  }
+  if (verbose) {
+    lines.push(""), lines.push(ansis.bold("  Per-node AI details:"));
+    for (const review of reviews) {
+      lines.push(""), lines.push(ansis.bold(`  ${review.layerId} (${review.standard}):`));
+      for (const ev of review.nodeEvaluations) {
+        const alignColor = ev.alignmentScore >= 70 ? ansis.green : ev.alignmentScore >= 50 ? ansis.yellow : ansis.red, docColor = ev.documentationScore >= 65 ? ansis.green : ev.documentationScore >= 45 ? ansis.yellow : ansis.red;
+        if (lines.push(`    ${ev.specNodeId.padEnd(45)} align: ${alignColor(String(ev.alignmentScore).padStart(3))}  doc: ${docColor(String(ev.documentationScore).padStart(3))}`), ev.suggestions.length > 0)
+          for (const s of ev.suggestions)
+            lines.push(ansis.dim(`      \u2192 ${s}`));
+      }
+    }
+  }
+}
+function formatNodeAIReviewsMarkdown(lines, reviews) {
+  lines.push("## AI Evaluation"), lines.push(""), lines.push("### Summary by Layer"), lines.push(""), lines.push("| Layer | Standard | Alignment | Documentation | Nodes |"), lines.push("|-------|----------|-----------|---------------|-------|");
+  for (const review of reviews)
+    lines.push(`| ${escapeMarkdown(review.layerId)} | ${escapeMarkdown(review.standard)} | ${review.avgAlignmentScore.toFixed(1)} | ${review.avgDocumentationScore.toFixed(1)} | ${review.nodeEvaluations.length} |`);
+  lines.push("");
+  for (const review of reviews)
+    if (review.nodeEvaluations.length !== 0) {
+      lines.push(`### ${escapeMarkdown(review.layerId)} \u2014 ${escapeMarkdown(review.standard)}`), lines.push(""), lines.push("| Node Type | Alignment | Alignment Reasoning | Documentation | Doc Reasoning | Suggestions |"), lines.push("|-----------|-----------|---------------------|---------------|---------------|-------------|");
+      for (const ev of review.nodeEvaluations) {
+        const suggestions = ev.suggestions.length > 0 ? ev.suggestions.map(escapeMarkdown).join("; ") : "-";
+        lines.push(`| ${escapeMarkdown(ev.specNodeId)} | ${ev.alignmentScore} | ${escapeMarkdown(ev.alignmentReasoning)} | ${ev.documentationScore} | ${escapeMarkdown(ev.documentationReasoning)} | ${suggestions} |`);
+      }
+      lines.push("");
+    }
+}
+function formatNodeAuditMarkdown(report, _options) {
+  const lines = [];
+  lines.push(`# Node Audit Report \u2014 Spec v${escapeMarkdown(report.spec.version)}`), lines.push(""), lines.push(`**Generated:** ${formatDate(report.timestamp)}`), lines.push(`**Total Node Types:** ${report.spec.totalNodeTypes}  |  **Layers:** ${report.spec.totalLayers}`), lines.push(""), lines.push("## Contents"), lines.push("- [Executive Summary](#executive-summary)"), lines.push("- [Layer Summary](#layer-summary)"), lines.push("- [Definition Quality Issues](#definition-quality-issues)"), lines.push("- [Semantic Overlaps](#semantic-overlaps)"), lines.push("- [Schema Completeness](#schema-completeness)"), report.aiReviews && lines.push("- [AI Evaluation](#ai-evaluation)"), lines.push(""), lines.push("## Executive Summary"), lines.push("");
+  const totalErrors = report.layerSummaries.reduce((s, l) => s + l.errorCount, 0), totalWarnings = report.layerSummaries.reduce((s, l) => s + l.warningCount, 0), totalEmpty = report.layerSummaries.reduce((s, l) => s + l.emptyDescriptionCount, 0), totalGeneric = report.layerSummaries.reduce((s, l) => s + l.genericDescriptionCount, 0), avgScore = report.layerSummaries.length > 0 ? report.layerSummaries.reduce((s, l) => s + l.avgQualityScore, 0) / report.layerSummaries.length : 0, highOverlaps = report.overlaps.filter((o) => o.confidence === "high").length;
+  lines.push("| Metric | Value |"), lines.push("|--------|-------|"), lines.push(`| Total Node Types | ${report.spec.totalNodeTypes} |`), lines.push(`| Avg Quality Score | ${avgScore.toFixed(1)}/100 |`), lines.push(`| Empty Descriptions | ${totalEmpty} |`), lines.push(`| Generic Descriptions | ${totalGeneric} |`), lines.push(`| Definition Errors | ${totalErrors} |`), lines.push(`| Definition Warnings | ${totalWarnings} |`), lines.push(`| Semantic Overlaps | ${report.overlaps.length} (${highOverlaps} high) |`), lines.push(`| Completeness Issues | ${report.completenessIssues.length} |`), lines.push(""), lines.push("## Layer Summary"), lines.push(""), lines.push("| Layer | Types | Avg Score | Empty | Generic | Good | Errors | Warnings |"), lines.push("|-------|-------|-----------|-------|---------|------|--------|----------|");
+  for (const s of report.layerSummaries)
+    lines.push(`| ${escapeMarkdown(s.layerId)} | ${s.totalNodeTypes} | ${s.avgQualityScore.toFixed(1)} | ${s.emptyDescriptionCount} | ${s.genericDescriptionCount} | ${s.goodDescriptionCount} | ${s.errorCount} | ${s.warningCount} |`);
+  lines.push(""), lines.push("## Definition Quality Issues"), lines.push("");
+  const allIssues = report.definitionQuality.flatMap((q) => q.issues.map((issue) => ({ ...issue, specNodeId: q.specNodeId, layerId: q.layerId }))), errors = allIssues.filter((i) => i.severity === "error"), warnings = allIssues.filter((i) => i.severity === "warning");
+  if (errors.length === 0 && warnings.length === 0)
+    lines.push("No definition quality issues found.");
+  else {
+    if (errors.length > 0) {
+      lines.push("### Errors"), lines.push(""), lines.push("| Node Type | Issue |"), lines.push("|-----------|-------|");
+      for (const issue of errors)
+        lines.push(`| ${escapeMarkdown(issue.specNodeId)} | ${escapeMarkdown(issue.message)} |`);
+      lines.push("");
+    }
+    if (warnings.length > 0) {
+      lines.push("### Warnings"), lines.push(""), lines.push("| Node Type | Issue |"), lines.push("|-----------|-------|");
+      for (const issue of warnings.slice(0, 50))
+        lines.push(`| ${escapeMarkdown(issue.specNodeId)} | ${escapeMarkdown(issue.message)} |`);
+      warnings.length > 50 && (lines.push(""), lines.push(`*... and ${warnings.length - 50} more warnings*`)), lines.push("");
+    }
+  }
+  if (lines.push("## Semantic Overlaps"), lines.push(""), report.overlaps.length === 0)
+    lines.push("No semantic overlap candidates detected.");
+  else {
+    lines.push("| Node Type A | Node Type B | Layer | Confidence | Type | Reason |"), lines.push("|-------------|-------------|-------|------------|------|--------|");
+    for (const o of report.overlaps)
+      lines.push(`| ${escapeMarkdown(o.nodeTypeA)} | ${escapeMarkdown(o.nodeTypeB)} | ${escapeMarkdown(o.layerId)} | ${o.confidence} | ${o.overlapType} | ${escapeMarkdown(o.reason)} |`);
+  }
+  if (lines.push(""), lines.push("## Schema Completeness"), lines.push(""), report.completenessIssues.length === 0)
+    lines.push("\u2713 All schema files match layer.json declarations.");
+  else {
+    lines.push("| Layer | Node Type | Issue | Detail |"), lines.push("|-------|-----------|-------|--------|");
+    for (const issue of report.completenessIssues)
+      lines.push(`| ${escapeMarkdown(issue.layerId)} | ${escapeMarkdown(issue.specNodeId)} | ${issue.issueType} | ${escapeMarkdown(issue.detail)} |`);
+  }
+  return lines.push(""), report.aiReviews && formatNodeAIReviewsMarkdown(lines, report.aiReviews), lines.join(`
+`);
+}
+export {
+  formatAuditReport,
+  formatNodeAuditReport
+};
+//# sourceMappingURL=audit-formatters.js.map