@aiready/core 0.23.2 → 0.23.4

package/dist/chunk-LTMHFNFK.mjs

@@ -0,0 +1,690 @@
+// src/types/schema.ts
+import { z } from 'zod';
+var Severity = /* @__PURE__ */ ((Severity2) => {
+  Severity2['Critical'] = 'critical';
+  Severity2['Major'] = 'major';
+  Severity2['Minor'] = 'minor';
+  Severity2['Info'] = 'info';
+  return Severity2;
+})(Severity || {});
+var SeveritySchema = z.nativeEnum(Severity);
+var ToolName = /* @__PURE__ */ ((ToolName2) => {
+  ToolName2['PatternDetect'] = 'pattern-detect';
+  ToolName2['ContextAnalyzer'] = 'context-analyzer';
+  ToolName2['NamingConsistency'] = 'naming-consistency';
+  ToolName2['AiSignalClarity'] = 'ai-signal-clarity';
+  ToolName2['AgentGrounding'] = 'agent-grounding';
+  ToolName2['TestabilityIndex'] = 'testability-index';
+  ToolName2['DocDrift'] = 'doc-drift';
+  ToolName2['DependencyHealth'] = 'dependency-health';
+  ToolName2['ChangeAmplification'] = 'change-amplification';
+  ToolName2['CognitiveLoad'] = 'cognitive-load';
+  ToolName2['PatternEntropy'] = 'pattern-entropy';
+  ToolName2['ConceptCohesion'] = 'concept-cohesion';
+  ToolName2['SemanticDistance'] = 'semantic-distance';
+  return ToolName2;
+})(ToolName || {});
+var ToolNameSchema = z.nativeEnum(ToolName);
+var IssueType = /* @__PURE__ */ ((IssueType2) => {
+  IssueType2['DuplicatePattern'] = 'duplicate-pattern';
+  IssueType2['PatternInconsistency'] = 'pattern-inconsistency';
+  IssueType2['ContextFragmentation'] = 'context-fragmentation';
+  IssueType2['DependencyHealth'] = 'dependency-health';
+  IssueType2['CircularDependency'] = 'circular-dependency';
+  IssueType2['DocDrift'] = 'doc-drift';
+  IssueType2['NamingInconsistency'] = 'naming-inconsistency';
+  IssueType2['NamingQuality'] = 'naming-quality';
+  IssueType2['ArchitectureInconsistency'] = 'architecture-inconsistency';
+  IssueType2['DeadCode'] = 'dead-code';
+  IssueType2['MissingTypes'] = 'missing-types';
+  IssueType2['MagicLiteral'] = 'magic-literal';
+  IssueType2['BooleanTrap'] = 'boolean-trap';
+  IssueType2['AiSignalClarity'] = 'ai-signal-clarity';
+  IssueType2['LowTestability'] = 'low-testability';
+  IssueType2['AgentNavigationFailure'] = 'agent-navigation-failure';
+  IssueType2['AmbiguousApi'] = 'ambiguous-api';
+  IssueType2['ChangeAmplification'] = 'change-amplification';
+  return IssueType2;
+})(IssueType || {});
+var IssueTypeSchema = z.nativeEnum(IssueType);
+var AnalysisStatus = /* @__PURE__ */ ((AnalysisStatus2) => {
+  AnalysisStatus2['Processing'] = 'processing';
+  AnalysisStatus2['Completed'] = 'completed';
+  AnalysisStatus2['Failed'] = 'failed';
+  return AnalysisStatus2;
+})(AnalysisStatus || {});
+var AnalysisStatusSchema = z.nativeEnum(AnalysisStatus);
+var ModelTier = /* @__PURE__ */ ((ModelTier2) => {
+  ModelTier2['Compact'] = 'compact';
+  ModelTier2['Standard'] = 'standard';
+  ModelTier2['Extended'] = 'extended';
+  ModelTier2['Frontier'] = 'frontier';
+  return ModelTier2;
+})(ModelTier || {});
+var ModelTierSchema = z.nativeEnum(ModelTier);
+var LocationSchema = z.object({
+  file: z.string(),
+  line: z.number(),
+  column: z.number().optional(),
+  endLine: z.number().optional(),
+  endColumn: z.number().optional(),
+});
+var IssueSchema = z.object({
+  type: IssueTypeSchema,
+  severity: SeveritySchema,
+  message: z.string(),
+  location: LocationSchema,
+  suggestion: z.string().optional(),
+});
+var MetricsSchema = z.object({
+  tokenCost: z.number().optional(),
+  complexityScore: z.number().optional(),
+  consistencyScore: z.number().optional(),
+  docFreshnessScore: z.number().optional(),
+  // AI agent readiness metrics (v0.12+)
+  aiSignalClarityScore: z.number().optional(),
+  agentGroundingScore: z.number().optional(),
+  testabilityScore: z.number().optional(),
+  docDriftScore: z.number().optional(),
+  dependencyHealthScore: z.number().optional(),
+  modelContextTier: ModelTierSchema.optional(),
+  // Business value metrics
+  estimatedMonthlyCost: z.number().optional(),
+  estimatedDeveloperHours: z.number().optional(),
+  comprehensionDifficultyIndex: z.number().optional(),
+  // Extended metrics for specific spokes
+  totalSymbols: z.number().optional(),
+  totalExports: z.number().optional(),
+});
+var AnalysisResultSchema = z.object({
+  fileName: z.string(),
+  issues: z.array(IssueSchema),
+  metrics: MetricsSchema,
+});
+var SpokeSummarySchema = z
+  .object({
+    totalFiles: z.number().optional(),
+    totalIssues: z.number().optional(),
+    criticalIssues: z.number().optional(),
+    majorIssues: z.number().optional(),
+    score: z.number().optional(),
+  })
+  .catchall(z.any());
+var SpokeOutputSchema = z.object({
+  results: z.array(AnalysisResultSchema),
+  summary: SpokeSummarySchema,
+  metadata: z
+    .object({
+      toolName: z.string(),
+      version: z.string().optional(),
+      timestamp: z.string().optional(),
+      config: z.any().optional(),
+    })
+    .catchall(z.any())
+    .optional(),
+});
+var UnifiedReportSchema = z
+  .object({
+    summary: z.object({
+      totalFiles: z.number(),
+      totalIssues: z.number(),
+      criticalIssues: z.number(),
+      majorIssues: z.number(),
+      businessImpact: z
+        .object({
+          estimatedMonthlyWaste: z.number().optional(),
+          potentialSavings: z.number().optional(),
+          productivityHours: z.number().optional(),
+        })
+        .optional(),
+    }),
+    results: z.array(AnalysisResultSchema),
+    scoring: z
+      .object({
+        overall: z.number(),
+        rating: z.string(),
+        timestamp: z.string(),
+        breakdown: z.array(
+          z
+            .object({
+              toolName: z.union([ToolNameSchema, z.string()]),
+              score: z.number(),
+            })
+            .catchall(z.any())
+        ),
+      })
+      .optional(),
+  })
+  .catchall(z.any());
+
+// src/types.ts
+var GLOBAL_INFRA_OPTIONS = [
+  'rootDir',
+  'include',
+  'exclude',
+  'tools',
+  'scoring',
+];
+var GLOBAL_SCAN_OPTIONS = [
+  'rootDir',
+  'include',
+  'exclude',
+  'config',
+  'threshold',
+  'output',
+  'format',
+  'parallel',
+  'showBreakdown',
+];
+var COMMON_FINE_TUNING_OPTIONS = [
+  'maxDepth',
+  'minSimilarity',
+  'threshold',
+  'showBreakdown',
+];
+
+// src/types/language.ts
+var Language = /* @__PURE__ */ ((Language2) => {
+  Language2['TypeScript'] = 'typescript';
+  Language2['JavaScript'] = 'javascript';
+  Language2['Python'] = 'python';
+  Language2['Java'] = 'java';
+  Language2['Go'] = 'go';
+  Language2['Rust'] = 'rust';
+  Language2['CSharp'] = 'csharp';
+  return Language2;
+})(Language || {});
+var LANGUAGE_EXTENSIONS = {
+  '.ts': 'typescript' /* TypeScript */,
+  '.tsx': 'typescript' /* TypeScript */,
+  '.js': 'javascript' /* JavaScript */,
+  '.jsx': 'javascript' /* JavaScript */,
+  '.py': 'python' /* Python */,
+  '.java': 'java' /* Java */,
+  '.go': 'go' /* Go */,
+  '.rs': 'rust' /* Rust */,
+  '.cs': 'csharp' /* CSharp */,
+};
+var ParseError = class extends Error {
+  constructor(message, filePath, loc) {
+    super(message);
+    this.filePath = filePath;
+    this.loc = loc;
+    this.name = 'ParseError';
+  }
+};
+
+// src/scoring.ts
+var RecommendationPriority = /* @__PURE__ */ ((RecommendationPriority2) => {
+  RecommendationPriority2['High'] = 'high';
+  RecommendationPriority2['Medium'] = 'medium';
+  RecommendationPriority2['Low'] = 'low';
+  return RecommendationPriority2;
+})(RecommendationPriority || {});
+var ReadinessRating = /* @__PURE__ */ ((ReadinessRating2) => {
+  ReadinessRating2['Excellent'] = 'Excellent';
+  ReadinessRating2['Good'] = 'Good';
+  ReadinessRating2['Fair'] = 'Fair';
+  ReadinessRating2['NeedsWork'] = 'Needs Work';
+  ReadinessRating2['Critical'] = 'Critical';
+  return ReadinessRating2;
+})(ReadinessRating || {});
+var DEFAULT_TOOL_WEIGHTS = {
+  ['pattern-detect' /* PatternDetect */]: 22,
+  ['context-analyzer' /* ContextAnalyzer */]: 19,
+  ['naming-consistency' /* NamingConsistency */]: 14,
+  ['ai-signal-clarity' /* AiSignalClarity */]: 11,
+  ['agent-grounding' /* AgentGrounding */]: 10,
+  ['testability-index' /* TestabilityIndex */]: 10,
+  ['doc-drift' /* DocDrift */]: 8,
+  ['dependency-health' /* DependencyHealth */]: 6,
+  ['change-amplification' /* ChangeAmplification */]: 8,
+};
+var TOOL_NAME_MAP = {
+  patterns: 'pattern-detect' /* PatternDetect */,
+  'pattern-detect': 'pattern-detect' /* PatternDetect */,
+  context: 'context-analyzer' /* ContextAnalyzer */,
+  'context-analyzer': 'context-analyzer' /* ContextAnalyzer */,
+  consistency: 'naming-consistency' /* NamingConsistency */,
+  'naming-consistency': 'naming-consistency' /* NamingConsistency */,
+  'ai-signal': 'ai-signal-clarity' /* AiSignalClarity */,
+  'ai-signal-clarity': 'ai-signal-clarity' /* AiSignalClarity */,
+  grounding: 'agent-grounding' /* AgentGrounding */,
+  'agent-grounding': 'agent-grounding' /* AgentGrounding */,
+  testability: 'testability-index' /* TestabilityIndex */,
+  'testability-index': 'testability-index' /* TestabilityIndex */,
+  'doc-drift': 'doc-drift' /* DocDrift */,
+  'deps-health': 'dependency-health' /* DependencyHealth */,
+  'dependency-health': 'dependency-health' /* DependencyHealth */,
+  'change-amp': 'change-amplification' /* ChangeAmplification */,
+  'change-amplification': 'change-amplification' /* ChangeAmplification */,
+};
+var ScoringProfile = /* @__PURE__ */ ((ScoringProfile2) => {
+  ScoringProfile2['Default'] = 'default';
+  ScoringProfile2['Agentic'] = 'agentic';
+  ScoringProfile2['Logic'] = 'logic';
+  ScoringProfile2['UI'] = 'ui';
+  ScoringProfile2['Cost'] = 'cost';
+  ScoringProfile2['Security'] = 'security';
+  return ScoringProfile2;
+})(ScoringProfile || {});
+var SCORING_PROFILES = {
+  ['default' /* Default */]: DEFAULT_TOOL_WEIGHTS,
+  ['agentic' /* Agentic */]: {
+    ['ai-signal-clarity' /* AiSignalClarity */]: 30,
+    ['agent-grounding' /* AgentGrounding */]: 30,
+    ['testability-index' /* TestabilityIndex */]: 20,
+    ['context-analyzer' /* ContextAnalyzer */]: 10,
+    ['naming-consistency' /* NamingConsistency */]: 10,
+  },
+  ['logic' /* Logic */]: {
+    ['testability-index' /* TestabilityIndex */]: 40,
+    ['naming-consistency' /* NamingConsistency */]: 20,
+    ['context-analyzer' /* ContextAnalyzer */]: 20,
+    ['pattern-detect' /* PatternDetect */]: 10,
+    ['change-amplification' /* ChangeAmplification */]: 10,
+  },
+  ['ui' /* UI */]: {
+    ['naming-consistency' /* NamingConsistency */]: 30,
+    ['context-analyzer' /* ContextAnalyzer */]: 30,
+    ['pattern-detect' /* PatternDetect */]: 20,
+    ['doc-drift' /* DocDrift */]: 10,
+    ['ai-signal-clarity' /* AiSignalClarity */]: 10,
+  },
+  ['cost' /* Cost */]: {
+    ['pattern-detect' /* PatternDetect */]: 50,
+    ['context-analyzer' /* ContextAnalyzer */]: 30,
+    ['change-amplification' /* ChangeAmplification */]: 10,
+    ['dependency-health' /* DependencyHealth */]: 10,
+  },
+  ['security' /* Security */]: {
+    ['naming-consistency' /* NamingConsistency */]: 40,
+    ['testability-index' /* TestabilityIndex */]: 30,
+    ['dependency-health' /* DependencyHealth */]: 20,
+    ['context-analyzer' /* ContextAnalyzer */]: 10,
+  },
+};
+var CONTEXT_TIER_THRESHOLDS = {
+  compact: { idealTokens: 3e3, criticalTokens: 1e4, idealDepth: 4 },
+  standard: { idealTokens: 5e3, criticalTokens: 15e3, idealDepth: 5 },
+  extended: { idealTokens: 15e3, criticalTokens: 5e4, idealDepth: 7 },
+  frontier: { idealTokens: 5e4, criticalTokens: 15e4, idealDepth: 10 },
+};
+var SIZE_ADJUSTED_THRESHOLDS = {
+  xs: 80,
+  // < 50 files
+  small: 75,
+  // 50-200 files
+  medium: 70,
+  // 200-500 files
+  large: 65,
+  // 500-2000 files
+  enterprise: 58,
+  // 2000+ files
+};
+function getProjectSizeTier(fileCount) {
+  if (fileCount < 50) return 'xs';
+  if (fileCount < 200) return 'small';
+  if (fileCount < 500) return 'medium';
+  if (fileCount < 2e3) return 'large';
+  return 'enterprise';
+}
+function getRecommendedThreshold(fileCount, modelTier = 'standard') {
+  const sizeTier = getProjectSizeTier(fileCount);
+  const base = SIZE_ADJUSTED_THRESHOLDS[sizeTier];
+  const modelBonus =
+    modelTier === 'frontier' ? -3 : modelTier === 'extended' ? -2 : 0;
+  return base + modelBonus;
+}
+function normalizeToolName(shortName) {
+  return TOOL_NAME_MAP[shortName.toLowerCase()] || shortName;
+}
+function getToolWeight(
+  toolName,
+  toolConfig,
+  cliOverride,
+  profile = 'default' /* Default */
+) {
+  if (cliOverride !== void 0) return cliOverride;
+  if (toolConfig?.scoreWeight !== void 0) return toolConfig.scoreWeight;
+  const profileWeights = SCORING_PROFILES[profile] || DEFAULT_TOOL_WEIGHTS;
+  return profileWeights[toolName] ?? DEFAULT_TOOL_WEIGHTS[toolName] ?? 5;
+}
+function parseWeightString(weightStr) {
+  const weights = /* @__PURE__ */ new Map();
+  if (!weightStr) return weights;
+  const pairs = weightStr.split(',');
+  for (const pair of pairs) {
+    const [toolShortName, weightValueStr] = pair.split(':');
+    if (toolShortName && weightValueStr) {
+      const toolName = normalizeToolName(toolShortName.trim());
+      const weight = parseInt(weightValueStr.trim(), 10);
+      if (!isNaN(weight) && weight > 0) {
+        weights.set(toolName, weight);
+      }
+    }
+  }
+  return weights;
+}
+function calculateOverallScore(toolOutputs, config, cliWeights) {
+  if (toolOutputs.size === 0) {
+    throw new Error('No tool outputs provided for scoring');
+  }
+  const profile = config?.scoring?.profile || 'default'; /* Default */
+  const weights = /* @__PURE__ */ new Map();
+  for (const [toolName] of toolOutputs.entries()) {
+    const cliWeight = cliWeights?.get(toolName);
+    const configWeight = config?.tools?.[toolName]?.scoreWeight;
+    const weight =
+      cliWeight ??
+      configWeight ??
+      getToolWeight(toolName, void 0, void 0, profile);
+    weights.set(toolName, weight);
+  }
+  let weightedSum = 0;
+  let totalWeight = 0;
+  const breakdown = [];
+  const toolsUsed = [];
+  const calculationWeights = {};
+  for (const [toolName, output] of toolOutputs.entries()) {
+    const weight = weights.get(toolName) || 5;
+    weightedSum += output.score * weight;
+    totalWeight += weight;
+    toolsUsed.push(toolName);
+    calculationWeights[toolName] = weight;
+    breakdown.push(output);
+  }
+  const overall = Math.round(weightedSum / totalWeight);
+  const rating = getRating(overall);
+  const formulaParts = Array.from(toolOutputs.entries()).map(
+    ([name, output]) => {
+      const w = weights.get(name) || 5;
+      return `(${output.score} \xD7 ${w})`;
+    }
+  );
+  const formulaStr = `[${formulaParts.join(' + ')}] / ${totalWeight} = ${overall}`;
+  return {
+    overall,
+    rating,
+    timestamp: /* @__PURE__ */ new Date().toISOString(),
+    toolsUsed,
+    breakdown,
+    calculation: {
+      formula: formulaStr,
+      weights: calculationWeights,
+      normalized: formulaStr,
+    },
+  };
+}
+function getRating(score) {
+  if (score >= 90) return 'Excellent' /* Excellent */;
+  if (score >= 75) return 'Good' /* Good */;
+  if (score >= 60) return 'Fair' /* Fair */;
+  if (score >= 40) return 'Needs Work' /* NeedsWork */;
+  return 'Critical' /* Critical */;
+}
+function getRatingSlug(score) {
+  if (score >= 90) return 'excellent';
+  if (score >= 75) return 'good';
+  if (score >= 60) return 'fair';
+  if (score >= 40) return 'needs-work';
+  return 'critical';
+}
+function getRatingWithContext(score, fileCount, modelTier = 'standard') {
+  const threshold = getRecommendedThreshold(fileCount, modelTier);
+  const normalized = score - threshold + 70;
+  return getRating(normalized);
+}
+function getRatingDisplay(rating) {
+  switch (rating) {
+    case 'Excellent' /* Excellent */:
+      return { emoji: '\u2705', color: 'green' };
+    case 'Good' /* Good */:
+      return { emoji: '\u{1F44D}', color: 'blue' };
+    case 'Fair' /* Fair */:
+      return { emoji: '\u26A0\uFE0F', color: 'yellow' };
+    case 'Needs Work' /* NeedsWork */:
+      return { emoji: '\u{1F528}', color: 'orange' };
+    case 'Critical' /* Critical */:
+      return { emoji: '\u274C', color: 'red' };
+    default:
+      return { emoji: '\u2753', color: 'gray' };
+  }
+}
+function formatScore(result) {
+  const { emoji } = getRatingDisplay(result.rating);
+  return `${result.overall}/100 (${result.rating}) ${emoji}`;
+}
+function formatToolScore(output) {
+  let result = `  Score: ${output.score}/100
+
+`;
+  if (output.factors && output.factors.length > 0) {
+    result += `  Factors:
+`;
+    output.factors.forEach((factor) => {
+      const impactSign = factor.impact > 0 ? '+' : '';
+      result += `    \u2022 ${factor.name}: ${impactSign}${factor.impact} - ${factor.description}
+`;
+    });
+    result += '\n';
+  }
+  if (output.recommendations && output.recommendations.length > 0) {
+    result += `  Recommendations:
+`;
+    output.recommendations.forEach((rec, i) => {
+      let priorityIcon = '\u{1F535}';
+      const prio = rec.priority;
+      if (prio === 'high' /* High */ || prio === 'high')
+        priorityIcon = '\u{1F534}';
+      else if (prio === 'medium' /* Medium */ || prio === 'medium')
+        priorityIcon = '\u{1F7E1}';
+      result += `    ${i + 1}. ${priorityIcon} ${rec.action}
+`;
+      result += `       Impact: +${rec.estimatedImpact} points
+
+`;
+    });
+  }
+  return result;
+}
+
+// src/utils/visualization.ts
+function generateHTML(graph) {
+  const payload = JSON.stringify(graph, null, 2);
+  return `<!doctype html>
+<html>
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>AIReady Visualization</title>
+    <style>
+      html,body { height: 100%; margin: 0; padding: 0; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; background: #0f172a; color: #e2e8f0 }
+      #container { display:flex; height:100vh }
+      #panel { width: 320px; padding: 16px; background: #071130; box-shadow: -2px 0 8px rgba(0,0,0,0.3); overflow:auto }
+      #canvasWrap { flex:1; display:flex; align-items:center; justify-content:center }
+      canvas { background: #0b1220; border-radius:8px }
+      .stat { margin-bottom:12px }
+    </style>
+  </head>
+  <body>
+    <div id="container">
+      <div id="canvasWrap"><canvas id="canvas" width="1200" height="800"></canvas></div>
+      <div id="panel">
+        <h2>AIReady Visualization</h2>
+        <div class="stat"><strong>Files:</strong> <span id="stat-files"></span></div>
+        <div class="stat"><strong>Dependencies:</strong> <span id="stat-deps"></span></div>
+        <div class="stat"><strong>Legend</strong></div>
+        <div style="font-size:13px;line-height:1.3;color:#cbd5e1;margin-top:8px">
+          <div style="margin-bottom:8px"><span style="display:inline-block;width:12px;height:12px;background:#ff4d4f;margin-right:8px;border:1px solid rgba(255,255,255,0.06)"></span><strong>Critical</strong>: highest severity issues.</div>
+          <div style="margin-bottom:8px"><span style="display:inline-block;width:12px;height:12px;background:#ff9900;margin-right:8px;border:1px solid rgba(255,255,255,0.06)"></span><strong>Major</strong>: important issues.</div>
+          <div style="margin-bottom:8px"><span style="display:inline-block;width:12px;height:12px;background:#ffd666;margin-right:8px;border:1px solid rgba(255,255,255,0.06)"></span><strong>Minor</strong>: low priority issues.</div>
+          <div style="margin-bottom:8px"><span style="display:inline-block;width:12px;height:12px;background:#91d5ff;margin-right:8px;border:1px solid rgba(255,255,255,0.06)"></span><strong>Info</strong>: informational notes.</div>
+          <div style="margin-top:10px;color:#94a3b8"><strong>Node size</strong>: larger = higher token cost, more issues or dependency weight.</div>
+          <div style="margin-top:6px;color:#94a3b8"><strong>Proximity</strong>: nodes that are spatially close are more contextually related; relatedness is represented by distance and size rather than explicit edges.</div>
+          <div style="margin-top:6px;color:#94a3b8"><strong>Edge colors</strong>: <span style="color:#fb7e81">Similarity</span>, <span style="color:#84c1ff">Dependency</span>, <span style="color:#ffa500">Reference</span>, default <span style="color:#334155">Other</span>.</div>
+        </div>
+      </div>
+    </div>
+
+    <script>
+      const graphData = ${payload};
+      document.getElementById('stat-files').textContent = graphData.metadata.totalFiles;
+      document.getElementById('stat-deps').textContent = graphData.metadata.totalDependencies;
+
+      const canvas = document.getElementById('canvas');
+      const ctx = canvas.getContext('2d');
+
+      const nodes = graphData.nodes.map((n, i) => ({
+        ...n,
+        x: canvas.width / 2 + Math.cos(i / graphData.nodes.length * Math.PI * 2) * (Math.min(canvas.width, canvas.height) / 3),
+        y: canvas.height / 2 + Math.sin(i / graphData.nodes.length * Math.PI * 2) * (Math.min(canvas.width, canvas.height) / 3),
+      }));
+
+      function draw() {
+        ctx.clearRect(0, 0, canvas.width, canvas.height);
+
+        graphData.edges.forEach(edge => {
+          const s = nodes.find(n => n.id === edge.source);
+          const t = nodes.find(n => n.id === edge.target);
+          if (!s || !t) return;
+          if (edge.type === 'related') return;
+          if (edge.type === 'similarity') {
+            ctx.strokeStyle = '#fb7e81';
+            ctx.lineWidth = 1.2;
+          } else if (edge.type === 'dependency') {
+            ctx.strokeStyle = '#84c1ff';
+            ctx.lineWidth = 1.0;
+          } else if (edge.type === 'reference') {
+            ctx.strokeStyle = '#ffa500';
+            ctx.lineWidth = 0.9;
+          } else {
+            ctx.strokeStyle = '#334155';
+            ctx.lineWidth = 0.8;
+          }
+          ctx.beginPath();
+          ctx.moveTo(s.x, s.y);
+          ctx.lineTo(t.x, t.y);
+          ctx.stroke();
+        });
+
+        const groups = {};
+        nodes.forEach(n => {
+          const g = n.group || '__default';
+          if (!groups[g]) groups[g] = { minX: n.x, minY: n.y, maxX: n.x, maxY: n.y };
+          groups[g].minX = Math.min(groups[g].minX, n.x);
+          groups[g].minY = Math.min(groups[g].minY, n.y);
+          groups[g].maxX = Math.max(groups[g].maxX, n.x);
+          groups[g].maxY = Math.max(groups[g].maxY, n.y);
+        });
+
+        const groupRelations = {};
+        graphData.edges.forEach(edge => {
+          const sNode = nodes.find(n => n.id === edge.source);
+          const tNode = nodes.find(n => n.id === edge.target);
+          if (!sNode || !tNode) return;
+          const g1 = sNode.group || '__default';
+          const g2 = tNode.group || '__default';
+          if (g1 === g2) return;
+          const key = g1 < g2 ? g1 + '::' + g2 : g2 + '::' + g1;
+          groupRelations[key] = (groupRelations[key] || 0) + 1;
+        });
+
+        Object.keys(groupRelations).forEach(k => {
+          const count = groupRelations[k];
+          const [ga, gb] = k.split('::');
+          if (!groups[ga] || !groups[gb]) return;
+          const ax = (groups[ga].minX + groups[ga].maxX) / 2;
+          const ay = (groups[ga].minY + groups[ga].maxY) / 2;
+          const bx = (groups[gb].minX + groups[gb].maxX) / 2;
+          const by = (groups[gb].minY + groups[gb].maxY) / 2;
+          ctx.beginPath();
+          ctx.strokeStyle = 'rgba(148,163,184,0.25)';
+          ctx.lineWidth = Math.min(6, 0.6 + Math.sqrt(count));
+          ctx.moveTo(ax, ay);
+          ctx.lineTo(bx, by);
+          ctx.stroke();
+        });
+
+        Object.keys(groups).forEach(g => {
+          if (g === '__default') return;
+          const box = groups[g];
+          const pad = 16;
+          const x = box.minX - pad;
+          const y = box.minY - pad;
+          const w = (box.maxX - box.minX) + pad * 2;
+          const h = (box.maxY - box.minY) + pad * 2;
+          ctx.save();
+          ctx.fillStyle = 'rgba(30,64,175,0.04)';
+          ctx.strokeStyle = 'rgba(30,64,175,0.12)';
+          ctx.lineWidth = 1.2;
+          const r = 8;
+          ctx.beginPath();
+          ctx.moveTo(x + r, y);
+          ctx.arcTo(x + w, y, x + w, y + h, r);
+          ctx.arcTo(x + w, y + h, x, y + h, r);
+          ctx.arcTo(x, y + h, x, y, r);
+          ctx.arcTo(x, y, x + w, y, r);
+          ctx.closePath();
+          ctx.fill();
+          ctx.stroke();
+          ctx.restore();
+          ctx.fillStyle = '#94a3b8';
+          ctx.font = '11px sans-serif';
+          ctx.fillText(g, x + 8, y + 14);
+        });
+
+        nodes.forEach(n => {
+          const sizeVal = (n.size || n.value || 1);
+          const r = 6 + (sizeVal / 2);
+          ctx.beginPath();
+          ctx.fillStyle = n.color || '#60a5fa';
+          ctx.arc(n.x, n.y, r, 0, Math.PI * 2);
+          ctx.fill();
+
+          ctx.fillStyle = '#e2e8f0';
+          ctx.font = '11px sans-serif';
+          ctx.textAlign = 'center';
+          ctx.fillText(n.label || n.id.split('/').slice(-1)[0], n.x, n.y + r + 12);
+        });
+      }
+
+      draw();
+    </script>
+  </body>
+</html>`;
+}
+
+export {
+  Severity,
+  ToolName,
+  IssueType,
+  SpokeOutputSchema,
+  GLOBAL_INFRA_OPTIONS,
+  GLOBAL_SCAN_OPTIONS,
+  COMMON_FINE_TUNING_OPTIONS,
+  Language,
+  LANGUAGE_EXTENSIONS,
+  ParseError,
+  RecommendationPriority,
+  ReadinessRating,
+  DEFAULT_TOOL_WEIGHTS,
+  TOOL_NAME_MAP,
+  ScoringProfile,
+  SCORING_PROFILES,
+  CONTEXT_TIER_THRESHOLDS,
+  SIZE_ADJUSTED_THRESHOLDS,
+  getProjectSizeTier,
+  getRecommendedThreshold,
+  normalizeToolName,
+  getToolWeight,
+  parseWeightString,
+  calculateOverallScore,
+  getRating,
+  getRatingSlug,
+  getRatingWithContext,
+  getRatingDisplay,
+  formatScore,
+  formatToolScore,
+  generateHTML,
+};