@aiready/core 0.19.5 → 0.21.0

package/dist/chunk-YCA4FTEK.mjs

@@ -0,0 +1,582 @@
+// 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 FRIENDLY_TOOL_NAMES = {
+  ["pattern-detect" /* PatternDetect */]: "Semantic Duplicates",
+  ["context-analyzer" /* ContextAnalyzer */]: "Context Fragmentation",
+  ["naming-consistency" /* NamingConsistency */]: "Naming Consistency",
+  ["ai-signal-clarity" /* AiSignalClarity */]: "AI Signal Clarity",
+  ["agent-grounding" /* AgentGrounding */]: "Agent Grounding",
+  ["testability-index" /* TestabilityIndex */]: "Testability Index",
+  ["doc-drift" /* DocDrift */]: "Documentation Health",
+  ["dependency-health" /* DependencyHealth */]: "Dependency Health",
+  ["change-amplification" /* ChangeAmplification */]: "Change Amplification",
+  ["cognitive-load" /* CognitiveLoad */]: "Cognitive Load",
+  ["pattern-entropy" /* PatternEntropy */]: "Pattern Entropy",
+  ["concept-cohesion" /* ConceptCohesion */]: "Concept Cohesion",
+  ["semantic-distance" /* SemanticDistance */]: "Semantic Distance"
+};
+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()
+  }).catchall(z.any()).optional()
+});
+var UnifiedReportSchema = z.object({
+  summary: z.object({
+    totalFiles: z.number(),
+    totalIssues: z.number(),
+    criticalIssues: z.number(),
+    majorIssues: z.number()
+  }),
+  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/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 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 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) {
+  if (cliOverride !== void 0) return cliOverride;
+  if (toolConfig?.scoreWeight !== void 0) return toolConfig.scoreWeight;
+  return 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, weightStr2] = pair.split(":");
+    if (toolShortName && weightStr2) {
+      const toolName = normalizeToolName(toolShortName.trim());
+      const weight = parseInt(weightStr2.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 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 ?? DEFAULT_TOOL_WEIGHTS[toolName] ?? 5;
+    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";
+  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":
+      return { emoji: "\u2705", color: "green" };
+    case "Good":
+      return { emoji: "\u{1F44D}", color: "blue" };
+    case "Fair":
+      return { emoji: "\u26A0\uFE0F", color: "yellow" };
+    case "Needs Work":
+      return { emoji: "\u{1F528}", color: "orange" };
+    case "Critical":
+      return { emoji: "\u274C", color: "red" };
+  }
+}
+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) => {
+      const priorityIcon = rec.priority === "high" ? "\u{1F534}" : rec.priority === "medium" ? "\u{1F7E1}" : "\u{1F535}";
+      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,
+  SeveritySchema,
+  ToolName,
+  ToolNameSchema,
+  FRIENDLY_TOOL_NAMES,
+  IssueType,
+  IssueTypeSchema,
+  AnalysisStatus,
+  AnalysisStatusSchema,
+  ModelTier,
+  ModelTierSchema,
+  LocationSchema,
+  IssueSchema,
+  MetricsSchema,
+  AnalysisResultSchema,
+  SpokeSummarySchema,
+  SpokeOutputSchema,
+  UnifiedReportSchema,
+  Language,
+  LANGUAGE_EXTENSIONS,
+  ParseError,
+  DEFAULT_TOOL_WEIGHTS,
+  TOOL_NAME_MAP,
+  CONTEXT_TIER_THRESHOLDS,
+  SIZE_ADJUSTED_THRESHOLDS,
+  getProjectSizeTier,
+  getRecommendedThreshold,
+  normalizeToolName,
+  getToolWeight,
+  parseWeightString,
+  calculateOverallScore,
+  getRating,
+  getRatingWithContext,
+  getRatingDisplay,
+  formatScore,
+  formatToolScore,
+  generateHTML
+};

package/dist/client.d.mts

@@ -163,6 +163,17 @@ declare const AnalysisResultSchema: z.ZodObject<{
     }, z.core.$strip>;
 }, z.core.$strip>;
 type AnalysisResult = z.infer<typeof AnalysisResultSchema>;
+/**
+ * Standard spoke tool summary schema.
+ */
+declare const SpokeSummarySchema: z.ZodObject<{
+    totalFiles: z.ZodOptional<z.ZodNumber>;
+    totalIssues: z.ZodOptional<z.ZodNumber>;
+    criticalIssues: z.ZodOptional<z.ZodNumber>;
+    majorIssues: z.ZodOptional<z.ZodNumber>;
+    score: z.ZodOptional<z.ZodNumber>;
+}, z.core.$catchall<z.ZodAny>>;
+type SpokeSummary = z.infer<typeof SpokeSummarySchema>;
 /**
  * Standard spoke tool output contract.
  */
@@ -200,11 +211,17 @@ declare const SpokeOutputSchema: z.ZodObject<{
             totalExports: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>;
     }, z.core.$strip>>;
-    summary: z.ZodAny;
+    summary: z.ZodObject<{
+        totalFiles: z.ZodOptional<z.ZodNumber>;
+        totalIssues: z.ZodOptional<z.ZodNumber>;
+        criticalIssues: z.ZodOptional<z.ZodNumber>;
+        majorIssues: z.ZodOptional<z.ZodNumber>;
+        score: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$catchall<z.ZodAny>>;
     metadata: z.ZodOptional<z.ZodObject<{
         toolName: z.ZodString;
-        version: z.ZodString;
-        timestamp: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+        timestamp: z.ZodOptional<z.ZodString>;
     }, z.core.$catchall<z.ZodAny>>>;
 }, z.core.$strip>;
 type SpokeOutput = z.infer<typeof SpokeOutputSchema>;
@@ -862,4 +879,4 @@ declare function formatToolScore(output: ToolScoringOutput): string;
  */
 declare function generateHTML(graph: GraphData): string;
 
-export { type AIReadyConfig, type AcceptancePrediction, type AnalysisResult, AnalysisResultSchema, AnalysisStatus, AnalysisStatusSchema, type BusinessReport, CONTEXT_TIER_THRESHOLDS, type CommonASTNode, type ComprehensionDifficulty, type CostConfig, DEFAULT_TOOL_WEIGHTS, type ExportInfo, FRIENDLY_TOOL_NAMES, type GraphData, type GraphEdge, type GraphIssueSeverity, type GraphMetadata, type GraphNode, type ImportInfo, type Issue, IssueSchema, IssueType, IssueTypeSchema, LANGUAGE_EXTENSIONS, Language, type LanguageConfig, type LanguageParser, type Location, LocationSchema, type Metrics, MetricsSchema, type ModelContextTier, ModelTier, ModelTierSchema, type NamingConvention, ParseError, type ParseResult, type ParseStatistics, type ProductivityImpact, type Report, SIZE_ADJUSTED_THRESHOLDS, type ScanOptions, type ScoringConfig, type ScoringResult, Severity, SeveritySchema, type SourceLocation, type SourceRange, type SpokeOutput, SpokeOutputSchema, TOOL_NAME_MAP, type TechnicalValueChain, type TechnicalValueChainSummary, type TokenBudget, ToolName, ToolNameSchema, type ToolScoringOutput, type UnifiedReport, UnifiedReportSchema, calculateOverallScore, formatScore, formatToolScore, generateHTML, getProjectSizeTier, getRating, getRatingDisplay, getRatingWithContext, getRecommendedThreshold, getToolWeight, normalizeToolName, parseWeightString };
+export { type AIReadyConfig, type AcceptancePrediction, type AnalysisResult, AnalysisResultSchema, AnalysisStatus, AnalysisStatusSchema, type BusinessReport, CONTEXT_TIER_THRESHOLDS, type CommonASTNode, type ComprehensionDifficulty, type CostConfig, DEFAULT_TOOL_WEIGHTS, type ExportInfo, FRIENDLY_TOOL_NAMES, type GraphData, type GraphEdge, type GraphIssueSeverity, type GraphMetadata, type GraphNode, type ImportInfo, type Issue, IssueSchema, IssueType, IssueTypeSchema, LANGUAGE_EXTENSIONS, Language, type LanguageConfig, type LanguageParser, type Location, LocationSchema, type Metrics, MetricsSchema, type ModelContextTier, ModelTier, ModelTierSchema, type NamingConvention, ParseError, type ParseResult, type ParseStatistics, type ProductivityImpact, type Report, SIZE_ADJUSTED_THRESHOLDS, type ScanOptions, type ScoringConfig, type ScoringResult, Severity, SeveritySchema, type SourceLocation, type SourceRange, type SpokeOutput, SpokeOutputSchema, type SpokeSummary, SpokeSummarySchema, TOOL_NAME_MAP, type TechnicalValueChain, type TechnicalValueChainSummary, type TokenBudget, ToolName, ToolNameSchema, type ToolScoringOutput, type UnifiedReport, UnifiedReportSchema, calculateOverallScore, formatScore, formatToolScore, generateHTML, getProjectSizeTier, getRating, getRatingDisplay, getRatingWithContext, getRecommendedThreshold, getToolWeight, normalizeToolName, parseWeightString };

package/dist/client.d.ts

@@ -163,6 +163,17 @@ declare const AnalysisResultSchema: z.ZodObject<{
     }, z.core.$strip>;
 }, z.core.$strip>;
 type AnalysisResult = z.infer<typeof AnalysisResultSchema>;
+/**
+ * Standard spoke tool summary schema.
+ */
+declare const SpokeSummarySchema: z.ZodObject<{
+    totalFiles: z.ZodOptional<z.ZodNumber>;
+    totalIssues: z.ZodOptional<z.ZodNumber>;
+    criticalIssues: z.ZodOptional<z.ZodNumber>;
+    majorIssues: z.ZodOptional<z.ZodNumber>;
+    score: z.ZodOptional<z.ZodNumber>;
+}, z.core.$catchall<z.ZodAny>>;
+type SpokeSummary = z.infer<typeof SpokeSummarySchema>;
 /**
  * Standard spoke tool output contract.
  */
@@ -200,11 +211,17 @@ declare const SpokeOutputSchema: z.ZodObject<{
             totalExports: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>;
     }, z.core.$strip>>;
-    summary: z.ZodAny;
+    summary: z.ZodObject<{
+        totalFiles: z.ZodOptional<z.ZodNumber>;
+        totalIssues: z.ZodOptional<z.ZodNumber>;
+        criticalIssues: z.ZodOptional<z.ZodNumber>;
+        majorIssues: z.ZodOptional<z.ZodNumber>;
+        score: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$catchall<z.ZodAny>>;
     metadata: z.ZodOptional<z.ZodObject<{
         toolName: z.ZodString;
-        version: z.ZodString;
-        timestamp: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+        timestamp: z.ZodOptional<z.ZodString>;
     }, z.core.$catchall<z.ZodAny>>>;
 }, z.core.$strip>;
 type SpokeOutput = z.infer<typeof SpokeOutputSchema>;
@@ -862,4 +879,4 @@ declare function formatToolScore(output: ToolScoringOutput): string;
  */
 declare function generateHTML(graph: GraphData): string;
 
-export { type AIReadyConfig, type AcceptancePrediction, type AnalysisResult, AnalysisResultSchema, AnalysisStatus, AnalysisStatusSchema, type BusinessReport, CONTEXT_TIER_THRESHOLDS, type CommonASTNode, type ComprehensionDifficulty, type CostConfig, DEFAULT_TOOL_WEIGHTS, type ExportInfo, FRIENDLY_TOOL_NAMES, type GraphData, type GraphEdge, type GraphIssueSeverity, type GraphMetadata, type GraphNode, type ImportInfo, type Issue, IssueSchema, IssueType, IssueTypeSchema, LANGUAGE_EXTENSIONS, Language, type LanguageConfig, type LanguageParser, type Location, LocationSchema, type Metrics, MetricsSchema, type ModelContextTier, ModelTier, ModelTierSchema, type NamingConvention, ParseError, type ParseResult, type ParseStatistics, type ProductivityImpact, type Report, SIZE_ADJUSTED_THRESHOLDS, type ScanOptions, type ScoringConfig, type ScoringResult, Severity, SeveritySchema, type SourceLocation, type SourceRange, type SpokeOutput, SpokeOutputSchema, TOOL_NAME_MAP, type TechnicalValueChain, type TechnicalValueChainSummary, type TokenBudget, ToolName, ToolNameSchema, type ToolScoringOutput, type UnifiedReport, UnifiedReportSchema, calculateOverallScore, formatScore, formatToolScore, generateHTML, getProjectSizeTier, getRating, getRatingDisplay, getRatingWithContext, getRecommendedThreshold, getToolWeight, normalizeToolName, parseWeightString };
+export { type AIReadyConfig, type AcceptancePrediction, type AnalysisResult, AnalysisResultSchema, AnalysisStatus, AnalysisStatusSchema, type BusinessReport, CONTEXT_TIER_THRESHOLDS, type CommonASTNode, type ComprehensionDifficulty, type CostConfig, DEFAULT_TOOL_WEIGHTS, type ExportInfo, FRIENDLY_TOOL_NAMES, type GraphData, type GraphEdge, type GraphIssueSeverity, type GraphMetadata, type GraphNode, type ImportInfo, type Issue, IssueSchema, IssueType, IssueTypeSchema, LANGUAGE_EXTENSIONS, Language, type LanguageConfig, type LanguageParser, type Location, LocationSchema, type Metrics, MetricsSchema, type ModelContextTier, ModelTier, ModelTierSchema, type NamingConvention, ParseError, type ParseResult, type ParseStatistics, type ProductivityImpact, type Report, SIZE_ADJUSTED_THRESHOLDS, type ScanOptions, type ScoringConfig, type ScoringResult, Severity, SeveritySchema, type SourceLocation, type SourceRange, type SpokeOutput, SpokeOutputSchema, type SpokeSummary, SpokeSummarySchema, TOOL_NAME_MAP, type TechnicalValueChain, type TechnicalValueChainSummary, type TokenBudget, ToolName, ToolNameSchema, type ToolScoringOutput, type UnifiedReport, UnifiedReportSchema, calculateOverallScore, formatScore, formatToolScore, generateHTML, getProjectSizeTier, getRating, getRatingDisplay, getRatingWithContext, getRecommendedThreshold, getToolWeight, normalizeToolName, parseWeightString };

package/dist/client.js

@@ -40,6 +40,7 @@ __export(client_exports, {
   Severity: () => Severity,
   SeveritySchema: () => SeveritySchema,
   SpokeOutputSchema: () => SpokeOutputSchema,
+  SpokeSummarySchema: () => SpokeSummarySchema,
   TOOL_NAME_MAP: () => TOOL_NAME_MAP,
   ToolName: () => ToolName,
   ToolNameSchema: () => ToolNameSchema,
@@ -177,13 +178,20 @@ var AnalysisResultSchema = import_zod.z.object({
   issues: import_zod.z.array(IssueSchema),
   metrics: MetricsSchema
 });
+var SpokeSummarySchema = import_zod.z.object({
+  totalFiles: import_zod.z.number().optional(),
+  totalIssues: import_zod.z.number().optional(),
+  criticalIssues: import_zod.z.number().optional(),
+  majorIssues: import_zod.z.number().optional(),
+  score: import_zod.z.number().optional()
+}).catchall(import_zod.z.any());
 var SpokeOutputSchema = import_zod.z.object({
   results: import_zod.z.array(AnalysisResultSchema),
-  summary: import_zod.z.any(),
+  summary: SpokeSummarySchema,
   metadata: import_zod.z.object({
     toolName: import_zod.z.string(),
-    version: import_zod.z.string(),
-    timestamp: import_zod.z.string()
+    version: import_zod.z.string().optional(),
+    timestamp: import_zod.z.string().optional()
   }).catchall(import_zod.z.any()).optional()
 });
 var UnifiedReportSchema = import_zod.z.object({
@@ -616,6 +624,7 @@ function generateHTML(graph) {
   Severity,
   SeveritySchema,
   SpokeOutputSchema,
+  SpokeSummarySchema,
   TOOL_NAME_MAP,
   ToolName,
   ToolNameSchema,

package/dist/client.mjs

@@ -19,6 +19,7 @@ import {
   Severity,
   SeveritySchema,
   SpokeOutputSchema,
+  SpokeSummarySchema,
   TOOL_NAME_MAP,
   ToolName,
   ToolNameSchema,
@@ -35,7 +36,7 @@ import {
   getToolWeight,
   normalizeToolName,
   parseWeightString
-} from "./chunk-QAFB3HXQ.mjs";
+} from "./chunk-YCA4FTEK.mjs";
 export {
   AnalysisResultSchema,
   AnalysisStatus,
@@ -57,6 +58,7 @@ export {
   Severity,
   SeveritySchema,
   SpokeOutputSchema,
+  SpokeSummarySchema,
   TOOL_NAME_MAP,
   ToolName,
   ToolNameSchema,

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { ScanOptions, AIReadyConfig, ModelContextTier, CostConfig, TokenBudget, ProductivityImpact, ToolScoringOutput, AcceptancePrediction, ComprehensionDifficulty, TechnicalValueChainSummary, TechnicalValueChain, LanguageParser, Language, ParseResult, NamingConvention } from './client.mjs';
-export { AnalysisResult, AnalysisResultSchema, AnalysisStatus, AnalysisStatusSchema, BusinessReport, CONTEXT_TIER_THRESHOLDS, CommonASTNode, DEFAULT_TOOL_WEIGHTS, ExportInfo, FRIENDLY_TOOL_NAMES, GraphData, GraphEdge, GraphIssueSeverity, GraphMetadata, GraphNode, ImportInfo, Issue, IssueSchema, IssueType, IssueTypeSchema, LANGUAGE_EXTENSIONS, LanguageConfig, Location, LocationSchema, Metrics, MetricsSchema, ModelTier, ModelTierSchema, ParseError, ParseStatistics, Report, SIZE_ADJUSTED_THRESHOLDS, ScoringConfig, ScoringResult, Severity, SeveritySchema, SourceLocation, SourceRange, SpokeOutput, SpokeOutputSchema, TOOL_NAME_MAP, ToolName, ToolNameSchema, UnifiedReport, UnifiedReportSchema, calculateOverallScore, formatScore, formatToolScore, generateHTML, getProjectSizeTier, getRating, getRatingDisplay, getRatingWithContext, getRecommendedThreshold, getToolWeight, normalizeToolName, parseWeightString } from './client.mjs';
+import { ToolName, ScanOptions, SpokeOutput, ToolScoringOutput, AIReadyConfig, ModelContextTier, CostConfig, TokenBudget, ProductivityImpact, AcceptancePrediction, ComprehensionDifficulty, TechnicalValueChainSummary, TechnicalValueChain, LanguageParser, Language, ParseResult, NamingConvention } from './client.mjs';
+export { AnalysisResult, AnalysisResultSchema, AnalysisStatus, AnalysisStatusSchema, BusinessReport, CONTEXT_TIER_THRESHOLDS, CommonASTNode, DEFAULT_TOOL_WEIGHTS, ExportInfo, FRIENDLY_TOOL_NAMES, GraphData, GraphEdge, GraphIssueSeverity, GraphMetadata, GraphNode, ImportInfo, Issue, IssueSchema, IssueType, IssueTypeSchema, LANGUAGE_EXTENSIONS, LanguageConfig, Location, LocationSchema, Metrics, MetricsSchema, ModelTier, ModelTierSchema, ParseError, ParseStatistics, Report, SIZE_ADJUSTED_THRESHOLDS, ScoringConfig, ScoringResult, Severity, SeveritySchema, SourceLocation, SourceRange, SpokeOutputSchema, SpokeSummary, SpokeSummarySchema, TOOL_NAME_MAP, ToolNameSchema, UnifiedReport, UnifiedReportSchema, calculateOverallScore, formatScore, formatToolScore, generateHTML, getProjectSizeTier, getRating, getRatingDisplay, getRatingWithContext, getRecommendedThreshold, getToolWeight, normalizeToolName, parseWeightString } from './client.mjs';
 import { z } from 'zod';
 
 /**
@@ -8,6 +8,22 @@ import { z } from 'zod';
  * changes in spokes don't break the CLI, Platform, or Visualizer.
  */
 
+/**
+ * Tool Provider Interface
+ * Every AIReady spoke must implement this interface to be integrated into the CLI registry.
+ */
+interface ToolProvider {
+    /** Canonical tool ID */
+    id: ToolName;
+    /** CLI aliases/shorthand for this tool */
+    alias: string[];
+    /** Primary analysis logic */
+    analyze: (options: ScanOptions) => Promise<SpokeOutput>;
+    /** Scoring logic for this tool's output */
+    score: (output: SpokeOutput, options: ScanOptions) => ToolScoringOutput;
+    /** Optional weight override for this tool */
+    defaultWeight?: number;
+}
 /**
  * Validation utility to ensure a spoke's output matches the expected contract.
  * Used in spoke tests to catch breakages early.
@@ -25,6 +41,41 @@ declare function validateWithSchema<T>(schema: z.ZodSchema<T>, data: any): {
     errors?: string[];
 };
 
+/**
+ * AIReady Tool Registry
+ *
+ * Central registry for all analysis tools. Decouples the CLI from
+ * individual tool packages and allows for easier extension.
+ */
+declare class ToolRegistry {
+    private static getProviders;
+    static instanceId: number;
+    /**
+     * Register a new tool provider.
+     */
+    static register(provider: ToolProvider): void;
+    /**
+     * Get a provider by its canonical ID.
+     */
+    static get(id: ToolName): ToolProvider | undefined;
+    /**
+     * Get a provider by name or alias.
+     */
+    static find(nameOrAlias: string): ToolProvider | undefined;
+    /**
+     * Get all registered tool providers.
+     */
+    static getAll(): ToolProvider[];
+    /**
+     * Get all available tool IDs from the ToolName enum.
+     */
+    static getAvailableIds(): ToolName[];
+    /**
+     * Clear the registry (primarily for testing).
+     */
+    static clear(): void;
+}
+
 declare const DEFAULT_EXCLUDE: string[];
 declare const VAGUE_FILE_NAMES: Set<string>;
 /**
@@ -800,4 +851,4 @@ declare function getRepoMetadata(directory: string): {
     author?: string;
 };
 
-export { AIReadyConfig, type ASTNode, AcceptancePrediction, type AgentGroundingScore, type AiSignalClarity, type AiSignalClaritySignal, type CLIOptions, type ChangeAmplificationScore, type CognitiveLoad, ComprehensionDifficulty, type ConceptCohesion, CostConfig, DEFAULT_COST_CONFIG, DEFAULT_EXCLUDE, type DependencyHealthScore, type DocDriftRisk, type ExportWithImports, type FileImport, type FileWithDomain, type KnowledgeConcentrationRisk, Language, LanguageParser, type LoadFactor, MODEL_PRICING_PRESETS, ModelContextTier, type ModelPricingPreset, NamingConvention, ParseResult, ParserFactory, type PatternEntropy, ProductivityImpact, PythonParser, SEVERITY_TIME_ESTIMATES, ScanOptions, type ScoreHistoryEntry, type ScoreTrend, type SemanticDistance, type TechnicalDebtInterest, TechnicalValueChain, TechnicalValueChainSummary, type TestabilityIndex, TokenBudget, ToolScoringOutput, TypeScriptParser, VAGUE_FILE_NAMES, calculateAgentGrounding, calculateAiSignalClarity, calculateBusinessROI, calculateChangeAmplification, calculateCognitiveLoad, calculateComprehensionDifficulty, calculateConceptCohesion, calculateDebtInterest, calculateDependencyHealth, calculateDocDrift, calculateExtendedFutureProofScore, calculateFutureProofScore, calculateImportSimilarity, calculateKnowledgeConcentration, calculateMonthlyCost, calculatePatternEntropy, calculateProductivityImpact, calculateSemanticDistance, calculateTechnicalValueChain, calculateTestabilityIndex, calculateTokenBudget, clearHistory, estimateCostFromBudget, estimateTokens, exportHistory, extractFunctions, extractImports, formatAcceptanceRate, formatCost, formatHours, generateValueChain, getElapsedTime, getFileCommitTimestamps, getFileExtension, getHistorySummary, getLineRangeLastModifiedCached, getModelPreset, getParser, getRepoMetadata, getSafetyIcon, getScoreBar, getSeverityColor, getSupportedLanguages, handleCLIError, handleJSONOutput, isFileSupported, isSourceFile, loadConfig, loadMergedConfig, loadScoreHistory, mergeConfigWithDefaults, parseCode, parseFileExports, predictAcceptanceRate, readFileContent, resolveOutputPath, saveScoreEntry, scanEntries, scanFiles, validateSpokeOutput, validateWithSchema };
+export { AIReadyConfig, type ASTNode, AcceptancePrediction, type AgentGroundingScore, type AiSignalClarity, type AiSignalClaritySignal, type CLIOptions, type ChangeAmplificationScore, type CognitiveLoad, ComprehensionDifficulty, type ConceptCohesion, CostConfig, DEFAULT_COST_CONFIG, DEFAULT_EXCLUDE, type DependencyHealthScore, type DocDriftRisk, type ExportWithImports, type FileImport, type FileWithDomain, type KnowledgeConcentrationRisk, Language, LanguageParser, type LoadFactor, MODEL_PRICING_PRESETS, ModelContextTier, type ModelPricingPreset, NamingConvention, ParseResult, ParserFactory, type PatternEntropy, ProductivityImpact, PythonParser, SEVERITY_TIME_ESTIMATES, ScanOptions, type ScoreHistoryEntry, type ScoreTrend, type SemanticDistance, SpokeOutput, type TechnicalDebtInterest, TechnicalValueChain, TechnicalValueChainSummary, type TestabilityIndex, TokenBudget, ToolName, type ToolProvider, ToolRegistry, ToolScoringOutput, TypeScriptParser, VAGUE_FILE_NAMES, calculateAgentGrounding, calculateAiSignalClarity, calculateBusinessROI, calculateChangeAmplification, calculateCognitiveLoad, calculateComprehensionDifficulty, calculateConceptCohesion, calculateDebtInterest, calculateDependencyHealth, calculateDocDrift, calculateExtendedFutureProofScore, calculateFutureProofScore, calculateImportSimilarity, calculateKnowledgeConcentration, calculateMonthlyCost, calculatePatternEntropy, calculateProductivityImpact, calculateSemanticDistance, calculateTechnicalValueChain, calculateTestabilityIndex, calculateTokenBudget, clearHistory, estimateCostFromBudget, estimateTokens, exportHistory, extractFunctions, extractImports, formatAcceptanceRate, formatCost, formatHours, generateValueChain, getElapsedTime, getFileCommitTimestamps, getFileExtension, getHistorySummary, getLineRangeLastModifiedCached, getModelPreset, getParser, getRepoMetadata, getSafetyIcon, getScoreBar, getSeverityColor, getSupportedLanguages, handleCLIError, handleJSONOutput, isFileSupported, isSourceFile, loadConfig, loadMergedConfig, loadScoreHistory, mergeConfigWithDefaults, parseCode, parseFileExports, predictAcceptanceRate, readFileContent, resolveOutputPath, saveScoreEntry, scanEntries, scanFiles, validateSpokeOutput, validateWithSchema };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { ScanOptions, AIReadyConfig, ModelContextTier, CostConfig, TokenBudget, ProductivityImpact, ToolScoringOutput, AcceptancePrediction, ComprehensionDifficulty, TechnicalValueChainSummary, TechnicalValueChain, LanguageParser, Language, ParseResult, NamingConvention } from './client.js';
-export { AnalysisResult, AnalysisResultSchema, AnalysisStatus, AnalysisStatusSchema, BusinessReport, CONTEXT_TIER_THRESHOLDS, CommonASTNode, DEFAULT_TOOL_WEIGHTS, ExportInfo, FRIENDLY_TOOL_NAMES, GraphData, GraphEdge, GraphIssueSeverity, GraphMetadata, GraphNode, ImportInfo, Issue, IssueSchema, IssueType, IssueTypeSchema, LANGUAGE_EXTENSIONS, LanguageConfig, Location, LocationSchema, Metrics, MetricsSchema, ModelTier, ModelTierSchema, ParseError, ParseStatistics, Report, SIZE_ADJUSTED_THRESHOLDS, ScoringConfig, ScoringResult, Severity, SeveritySchema, SourceLocation, SourceRange, SpokeOutput, SpokeOutputSchema, TOOL_NAME_MAP, ToolName, ToolNameSchema, UnifiedReport, UnifiedReportSchema, calculateOverallScore, formatScore, formatToolScore, generateHTML, getProjectSizeTier, getRating, getRatingDisplay, getRatingWithContext, getRecommendedThreshold, getToolWeight, normalizeToolName, parseWeightString } from './client.js';
+import { ToolName, ScanOptions, SpokeOutput, ToolScoringOutput, AIReadyConfig, ModelContextTier, CostConfig, TokenBudget, ProductivityImpact, AcceptancePrediction, ComprehensionDifficulty, TechnicalValueChainSummary, TechnicalValueChain, LanguageParser, Language, ParseResult, NamingConvention } from './client.js';
+export { AnalysisResult, AnalysisResultSchema, AnalysisStatus, AnalysisStatusSchema, BusinessReport, CONTEXT_TIER_THRESHOLDS, CommonASTNode, DEFAULT_TOOL_WEIGHTS, ExportInfo, FRIENDLY_TOOL_NAMES, GraphData, GraphEdge, GraphIssueSeverity, GraphMetadata, GraphNode, ImportInfo, Issue, IssueSchema, IssueType, IssueTypeSchema, LANGUAGE_EXTENSIONS, LanguageConfig, Location, LocationSchema, Metrics, MetricsSchema, ModelTier, ModelTierSchema, ParseError, ParseStatistics, Report, SIZE_ADJUSTED_THRESHOLDS, ScoringConfig, ScoringResult, Severity, SeveritySchema, SourceLocation, SourceRange, SpokeOutputSchema, SpokeSummary, SpokeSummarySchema, TOOL_NAME_MAP, ToolNameSchema, UnifiedReport, UnifiedReportSchema, calculateOverallScore, formatScore, formatToolScore, generateHTML, getProjectSizeTier, getRating, getRatingDisplay, getRatingWithContext, getRecommendedThreshold, getToolWeight, normalizeToolName, parseWeightString } from './client.js';
 import { z } from 'zod';
 
 /**
@@ -8,6 +8,22 @@ import { z } from 'zod';
  * changes in spokes don't break the CLI, Platform, or Visualizer.
  */
 
+/**
+ * Tool Provider Interface
+ * Every AIReady spoke must implement this interface to be integrated into the CLI registry.
+ */
+interface ToolProvider {
+    /** Canonical tool ID */
+    id: ToolName;
+    /** CLI aliases/shorthand for this tool */
+    alias: string[];
+    /** Primary analysis logic */
+    analyze: (options: ScanOptions) => Promise<SpokeOutput>;
+    /** Scoring logic for this tool's output */
+    score: (output: SpokeOutput, options: ScanOptions) => ToolScoringOutput;
+    /** Optional weight override for this tool */
+    defaultWeight?: number;
+}
 /**
  * Validation utility to ensure a spoke's output matches the expected contract.
  * Used in spoke tests to catch breakages early.
@@ -25,6 +41,41 @@ declare function validateWithSchema<T>(schema: z.ZodSchema<T>, data: any): {
     errors?: string[];
 };
 
+/**
+ * AIReady Tool Registry
+ *
+ * Central registry for all analysis tools. Decouples the CLI from
+ * individual tool packages and allows for easier extension.
+ */
+declare class ToolRegistry {
+    private static getProviders;
+    static instanceId: number;
+    /**
+     * Register a new tool provider.
+     */
+    static register(provider: ToolProvider): void;
+    /**
+     * Get a provider by its canonical ID.
+     */
+    static get(id: ToolName): ToolProvider | undefined;
+    /**
+     * Get a provider by name or alias.
+     */
+    static find(nameOrAlias: string): ToolProvider | undefined;
+    /**
+     * Get all registered tool providers.
+     */
+    static getAll(): ToolProvider[];
+    /**
+     * Get all available tool IDs from the ToolName enum.
+     */
+    static getAvailableIds(): ToolName[];
+    /**
+     * Clear the registry (primarily for testing).
+     */
+    static clear(): void;
+}
+
 declare const DEFAULT_EXCLUDE: string[];
 declare const VAGUE_FILE_NAMES: Set<string>;
 /**
@@ -800,4 +851,4 @@ declare function getRepoMetadata(directory: string): {
     author?: string;
 };
 
-export { AIReadyConfig, type ASTNode, AcceptancePrediction, type AgentGroundingScore, type AiSignalClarity, type AiSignalClaritySignal, type CLIOptions, type ChangeAmplificationScore, type CognitiveLoad, ComprehensionDifficulty, type ConceptCohesion, CostConfig, DEFAULT_COST_CONFIG, DEFAULT_EXCLUDE, type DependencyHealthScore, type DocDriftRisk, type ExportWithImports, type FileImport, type FileWithDomain, type KnowledgeConcentrationRisk, Language, LanguageParser, type LoadFactor, MODEL_PRICING_PRESETS, ModelContextTier, type ModelPricingPreset, NamingConvention, ParseResult, ParserFactory, type PatternEntropy, ProductivityImpact, PythonParser, SEVERITY_TIME_ESTIMATES, ScanOptions, type ScoreHistoryEntry, type ScoreTrend, type SemanticDistance, type TechnicalDebtInterest, TechnicalValueChain, TechnicalValueChainSummary, type TestabilityIndex, TokenBudget, ToolScoringOutput, TypeScriptParser, VAGUE_FILE_NAMES, calculateAgentGrounding, calculateAiSignalClarity, calculateBusinessROI, calculateChangeAmplification, calculateCognitiveLoad, calculateComprehensionDifficulty, calculateConceptCohesion, calculateDebtInterest, calculateDependencyHealth, calculateDocDrift, calculateExtendedFutureProofScore, calculateFutureProofScore, calculateImportSimilarity, calculateKnowledgeConcentration, calculateMonthlyCost, calculatePatternEntropy, calculateProductivityImpact, calculateSemanticDistance, calculateTechnicalValueChain, calculateTestabilityIndex, calculateTokenBudget, clearHistory, estimateCostFromBudget, estimateTokens, exportHistory, extractFunctions, extractImports, formatAcceptanceRate, formatCost, formatHours, generateValueChain, getElapsedTime, getFileCommitTimestamps, getFileExtension, getHistorySummary, getLineRangeLastModifiedCached, getModelPreset, getParser, getRepoMetadata, getSafetyIcon, getScoreBar, getSeverityColor, getSupportedLanguages, handleCLIError, handleJSONOutput, isFileSupported, isSourceFile, loadConfig, loadMergedConfig, loadScoreHistory, mergeConfigWithDefaults, parseCode, parseFileExports, predictAcceptanceRate, readFileContent, resolveOutputPath, saveScoreEntry, scanEntries, scanFiles, validateSpokeOutput, validateWithSchema };
+export { AIReadyConfig, type ASTNode, AcceptancePrediction, type AgentGroundingScore, type AiSignalClarity, type AiSignalClaritySignal, type CLIOptions, type ChangeAmplificationScore, type CognitiveLoad, ComprehensionDifficulty, type ConceptCohesion, CostConfig, DEFAULT_COST_CONFIG, DEFAULT_EXCLUDE, type DependencyHealthScore, type DocDriftRisk, type ExportWithImports, type FileImport, type FileWithDomain, type KnowledgeConcentrationRisk, Language, LanguageParser, type LoadFactor, MODEL_PRICING_PRESETS, ModelContextTier, type ModelPricingPreset, NamingConvention, ParseResult, ParserFactory, type PatternEntropy, ProductivityImpact, PythonParser, SEVERITY_TIME_ESTIMATES, ScanOptions, type ScoreHistoryEntry, type ScoreTrend, type SemanticDistance, SpokeOutput, type TechnicalDebtInterest, TechnicalValueChain, TechnicalValueChainSummary, type TestabilityIndex, TokenBudget, ToolName, type ToolProvider, ToolRegistry, ToolScoringOutput, TypeScriptParser, VAGUE_FILE_NAMES, calculateAgentGrounding, calculateAiSignalClarity, calculateBusinessROI, calculateChangeAmplification, calculateCognitiveLoad, calculateComprehensionDifficulty, calculateConceptCohesion, calculateDebtInterest, calculateDependencyHealth, calculateDocDrift, calculateExtendedFutureProofScore, calculateFutureProofScore, calculateImportSimilarity, calculateKnowledgeConcentration, calculateMonthlyCost, calculatePatternEntropy, calculateProductivityImpact, calculateSemanticDistance, calculateTechnicalValueChain, calculateTestabilityIndex, calculateTokenBudget, clearHistory, estimateCostFromBudget, estimateTokens, exportHistory, extractFunctions, extractImports, formatAcceptanceRate, formatCost, formatHours, generateValueChain, getElapsedTime, getFileCommitTimestamps, getFileExtension, getHistorySummary, getLineRangeLastModifiedCached, getModelPreset, getParser, getRepoMetadata, getSafetyIcon, getScoreBar, getSeverityColor, getSupportedLanguages, handleCLIError, handleJSONOutput, isFileSupported, isSourceFile, loadConfig, loadMergedConfig, loadScoreHistory, mergeConfigWithDefaults, parseCode, parseFileExports, predictAcceptanceRate, readFileContent, resolveOutputPath, saveScoreEntry, scanEntries, scanFiles, validateSpokeOutput, validateWithSchema };

package/dist/index.js

@@ -56,9 +56,11 @@ __export(index_exports, {
   Severity: () => Severity,
   SeveritySchema: () => SeveritySchema,
   SpokeOutputSchema: () => SpokeOutputSchema,
+  SpokeSummarySchema: () => SpokeSummarySchema,
   TOOL_NAME_MAP: () => TOOL_NAME_MAP,
   ToolName: () => ToolName,
   ToolNameSchema: () => ToolNameSchema,
+  ToolRegistry: () => ToolRegistry,
   TypeScriptParser: () => TypeScriptParser,
   UnifiedReportSchema: () => UnifiedReportSchema,
   VAGUE_FILE_NAMES: () => VAGUE_FILE_NAMES,
@@ -256,13 +258,20 @@ var AnalysisResultSchema = import_zod.z.object({
   issues: import_zod.z.array(IssueSchema),
   metrics: MetricsSchema
 });
+var SpokeSummarySchema = import_zod.z.object({
+  totalFiles: import_zod.z.number().optional(),
+  totalIssues: import_zod.z.number().optional(),
+  criticalIssues: import_zod.z.number().optional(),
+  majorIssues: import_zod.z.number().optional(),
+  score: import_zod.z.number().optional()
+}).catchall(import_zod.z.any());
 var SpokeOutputSchema = import_zod.z.object({
   results: import_zod.z.array(AnalysisResultSchema),
-  summary: import_zod.z.any(),
+  summary: SpokeSummarySchema,
   metadata: import_zod.z.object({
     toolName: import_zod.z.string(),
-    version: import_zod.z.string(),
-    timestamp: import_zod.z.string()
+    version: import_zod.z.string().optional(),
+    timestamp: import_zod.z.string().optional()
   }).catchall(import_zod.z.any()).optional()
 });
 var UnifiedReportSchema = import_zod.z.object({
@@ -375,6 +384,65 @@ function validateWithSchema(schema, data) {
   };
 }
 
+// src/registry.ts
+var ToolRegistry = class {
+  static getProviders() {
+    const g = globalThis;
+    if (!g.__AIRE_TOOL_REGISTRY__) {
+      g.__AIRE_TOOL_REGISTRY__ = /* @__PURE__ */ new Map();
+    }
+    return g.__AIRE_TOOL_REGISTRY__;
+  }
+  /**
+   * Register a new tool provider.
+   */
+  static register(provider) {
+    console.log(
+      `[ToolRegistry#${this.instanceId}] Registering tool: ${provider.id} (${provider.alias.join(", ")})`
+    );
+    this.getProviders().set(provider.id, provider);
+  }
+  /**
+   * Get a provider by its canonical ID.
+   */
+  static get(id) {
+    return this.getProviders().get(id);
+  }
+  /**
+   * Get a provider by name or alias.
+   */
+  static find(nameOrAlias) {
+    const providers = this.getProviders();
+    const exact = providers.get(nameOrAlias);
+    if (exact) return exact;
+    for (const p of providers.values()) {
+      if (p.alias.includes(nameOrAlias)) return p;
+    }
+    return void 0;
+  }
+  /**
+   * Get all registered tool providers.
+   */
+  static getAll() {
+    return Array.from(this.getProviders().values());
+  }
+  /**
+   * Get all available tool IDs from the ToolName enum.
+   */
+  static getAvailableIds() {
+    return Object.values(ToolName).filter(
+      (v) => typeof v === "string"
+    );
+  }
+  /**
+   * Clear the registry (primarily for testing).
+   */
+  static clear() {
+    this.getProviders().clear();
+  }
+};
+ToolRegistry.instanceId = globalThis.Math.random();
+
 // src/utils/file-scanner.ts
 var import_glob = require("glob");
 var import_promises = require("fs/promises");
@@ -467,7 +535,13 @@ async function scanFiles(options) {
       ignoreFromFile = [];
     }
   }
-  const TEST_PATTERNS = ["**/*.test.*", "**/*.spec.*", "**/__tests__/**", "**/test/**", "**/tests/**"];
+  const TEST_PATTERNS = [
+    "**/*.test.*",
+    "**/*.spec.*",
+    "**/__tests__/**",
+    "**/test/**",
+    "**/tests/**"
+  ];
   const baseExclude = options.includeTests ? DEFAULT_EXCLUDE.filter((p) => !TEST_PATTERNS.includes(p)) : DEFAULT_EXCLUDE;
   const finalExclude = [
     .../* @__PURE__ */ new Set([...exclude || [], ...ignoreFromFile, ...baseExclude])
@@ -488,12 +562,19 @@ async function scanFiles(options) {
       for (const gitignorePath of gitignoreFiles) {
         const gitTxt = await (0, import_promises.readFile)(gitignorePath, "utf-8");
         const gitignoreDir = (0, import_path.dirname)(gitignorePath);
-        const relativePrefix = (0, import_path.relative)(rootDir || ".", gitignoreDir).replace(/\\/g, "/");
+        const relativePrefix = (0, import_path.relative)(rootDir || ".", gitignoreDir).replace(
+          /\\/g,
+          "/"
+        );
         const patterns = gitTxt.split(/\r?\n/).map((s) => s.trim()).filter(Boolean).filter((l) => !l.startsWith("#"));
         if (relativePrefix === "." || relativePrefix === "") {
           ig.add(patterns);
         } else {
-          ig.add(patterns.map((p) => p.startsWith("/") ? `${relativePrefix}${p}` : `${relativePrefix}/**/${p}`));
+          ig.add(
+            patterns.map(
+              (p) => p.startsWith("/") ? `${relativePrefix}${p}` : `${relativePrefix}/**/${p}`
+            )
+          );
         }
       }
       const filtered = files.filter((f) => {
@@ -521,9 +602,17 @@ async function scanEntries(options) {
       ignoreFromFile = [];
     }
   }
-  const TEST_PATTERNS = ["**/*.test.*", "**/*.spec.*", "**/__tests__/**", "**/test/**", "**/tests/**"];
+  const TEST_PATTERNS = [
+    "**/*.test.*",
+    "**/*.spec.*",
+    "**/__tests__/**",
+    "**/test/**",
+    "**/tests/**"
+  ];
   const baseExclude = includeTests ? DEFAULT_EXCLUDE.filter((p) => !TEST_PATTERNS.includes(p)) : DEFAULT_EXCLUDE;
-  const finalExclude = [.../* @__PURE__ */ new Set([...exclude || [], ...ignoreFromFile, ...baseExclude])];
+  const finalExclude = [
+    .../* @__PURE__ */ new Set([...exclude || [], ...ignoreFromFile, ...baseExclude])
+  ];
   const dirs = await (0, import_glob.glob)("**/", {
     cwd: rootDir,
     ignore: finalExclude,
@@ -539,16 +628,23 @@ async function scanEntries(options) {
     for (const gitignorePath of gitignoreFiles) {
       const gitTxt = await (0, import_promises.readFile)(gitignorePath, "utf-8");
       const gitignoreDir = (0, import_path.dirname)(gitignorePath);
-      const relativePrefix = (0, import_path.relative)(rootDir || ".", gitignoreDir).replace(/\\/g, "/");
+      const relativePrefix = (0, import_path.relative)(rootDir || ".", gitignoreDir).replace(
+        /\\/g,
+        "/"
+      );
       const patterns = gitTxt.split(/\r?\n/).map((s) => s.trim()).filter(Boolean).filter((l) => !l.startsWith("#"));
       if (relativePrefix === "." || relativePrefix === "") {
         ig.add(patterns);
       } else {
-        ig.add(patterns.map((p) => p.startsWith("/") ? `${relativePrefix}${p}` : `${relativePrefix}/**/${p}`));
+        ig.add(
+          patterns.map(
+            (p) => p.startsWith("/") ? `${relativePrefix}${p}` : `${relativePrefix}/**/${p}`
+          )
+        );
       }
     }
     const filteredDirs = dirs.filter((d) => {
-      let rel = (0, import_path.relative)(rootDir || ".", d).replace(/\\/g, "/").replace(/\/$/, "");
+      const rel = (0, import_path.relative)(rootDir || ".", d).replace(/\\/g, "/").replace(/\/$/, "");
       if (rel === "") return true;
       return !ig.ignores(rel);
     });
@@ -2844,7 +2940,7 @@ function calculateChangeAmplification(params) {
   const hotspots = files.map((f) => ({ ...f, amplificationFactor: f.fanOut + f.fanIn * 0.5 })).sort((a, b) => b.amplificationFactor - a.amplificationFactor);
   const maxAmplification = hotspots[0].amplificationFactor;
   const avgAmplification = hotspots.reduce((sum, h) => sum + h.amplificationFactor, 0) / hotspots.length;
-  let score = Math.max(
+  const score = Math.max(
     0,
     Math.min(
       100,
@@ -3190,9 +3286,11 @@ function getRepoMetadata(directory) {
   Severity,
   SeveritySchema,
   SpokeOutputSchema,
+  SpokeSummarySchema,
   TOOL_NAME_MAP,
   ToolName,
   ToolNameSchema,
+  ToolRegistry,
   TypeScriptParser,
   UnifiedReportSchema,
   VAGUE_FILE_NAMES,

package/dist/index.mjs

@@ -19,6 +19,7 @@ import {
   Severity,
   SeveritySchema,
   SpokeOutputSchema,
+  SpokeSummarySchema,
   TOOL_NAME_MAP,
   ToolName,
   ToolNameSchema,
@@ -35,7 +36,7 @@ import {
   getToolWeight,
   normalizeToolName,
   parseWeightString
-} from "./chunk-QAFB3HXQ.mjs";
+} from "./chunk-YCA4FTEK.mjs";
 
 // src/types/contract.ts
 function validateSpokeOutput(toolName, output) {
@@ -95,6 +96,65 @@ function validateWithSchema(schema, data) {
   };
 }
 
+// src/registry.ts
+var ToolRegistry = class {
+  static getProviders() {
+    const g = globalThis;
+    if (!g.__AIRE_TOOL_REGISTRY__) {
+      g.__AIRE_TOOL_REGISTRY__ = /* @__PURE__ */ new Map();
+    }
+    return g.__AIRE_TOOL_REGISTRY__;
+  }
+  /**
+   * Register a new tool provider.
+   */
+  static register(provider) {
+    console.log(
+      `[ToolRegistry#${this.instanceId}] Registering tool: ${provider.id} (${provider.alias.join(", ")})`
+    );
+    this.getProviders().set(provider.id, provider);
+  }
+  /**
+   * Get a provider by its canonical ID.
+   */
+  static get(id) {
+    return this.getProviders().get(id);
+  }
+  /**
+   * Get a provider by name or alias.
+   */
+  static find(nameOrAlias) {
+    const providers = this.getProviders();
+    const exact = providers.get(nameOrAlias);
+    if (exact) return exact;
+    for (const p of providers.values()) {
+      if (p.alias.includes(nameOrAlias)) return p;
+    }
+    return void 0;
+  }
+  /**
+   * Get all registered tool providers.
+   */
+  static getAll() {
+    return Array.from(this.getProviders().values());
+  }
+  /**
+   * Get all available tool IDs from the ToolName enum.
+   */
+  static getAvailableIds() {
+    return Object.values(ToolName).filter(
+      (v) => typeof v === "string"
+    );
+  }
+  /**
+   * Clear the registry (primarily for testing).
+   */
+  static clear() {
+    this.getProviders().clear();
+  }
+};
+ToolRegistry.instanceId = globalThis.Math.random();
+
 // src/utils/file-scanner.ts
 import { glob } from "glob";
 import { readFile } from "fs/promises";
@@ -187,7 +247,13 @@ async function scanFiles(options) {
       ignoreFromFile = [];
     }
   }
-  const TEST_PATTERNS = ["**/*.test.*", "**/*.spec.*", "**/__tests__/**", "**/test/**", "**/tests/**"];
+  const TEST_PATTERNS = [
+    "**/*.test.*",
+    "**/*.spec.*",
+    "**/__tests__/**",
+    "**/test/**",
+    "**/tests/**"
+  ];
   const baseExclude = options.includeTests ? DEFAULT_EXCLUDE.filter((p) => !TEST_PATTERNS.includes(p)) : DEFAULT_EXCLUDE;
   const finalExclude = [
     .../* @__PURE__ */ new Set([...exclude || [], ...ignoreFromFile, ...baseExclude])
@@ -208,12 +274,19 @@ async function scanFiles(options) {
       for (const gitignorePath of gitignoreFiles) {
         const gitTxt = await readFile(gitignorePath, "utf-8");
         const gitignoreDir = dirname(gitignorePath);
-        const relativePrefix = relative(rootDir || ".", gitignoreDir).replace(/\\/g, "/");
+        const relativePrefix = relative(rootDir || ".", gitignoreDir).replace(
+          /\\/g,
+          "/"
+        );
         const patterns = gitTxt.split(/\r?\n/).map((s) => s.trim()).filter(Boolean).filter((l) => !l.startsWith("#"));
         if (relativePrefix === "." || relativePrefix === "") {
           ig.add(patterns);
         } else {
-          ig.add(patterns.map((p) => p.startsWith("/") ? `${relativePrefix}${p}` : `${relativePrefix}/**/${p}`));
+          ig.add(
+            patterns.map(
+              (p) => p.startsWith("/") ? `${relativePrefix}${p}` : `${relativePrefix}/**/${p}`
+            )
+          );
         }
       }
       const filtered = files.filter((f) => {
@@ -241,9 +314,17 @@ async function scanEntries(options) {
       ignoreFromFile = [];
     }
   }
-  const TEST_PATTERNS = ["**/*.test.*", "**/*.spec.*", "**/__tests__/**", "**/test/**", "**/tests/**"];
+  const TEST_PATTERNS = [
+    "**/*.test.*",
+    "**/*.spec.*",
+    "**/__tests__/**",
+    "**/test/**",
+    "**/tests/**"
+  ];
   const baseExclude = includeTests ? DEFAULT_EXCLUDE.filter((p) => !TEST_PATTERNS.includes(p)) : DEFAULT_EXCLUDE;
-  const finalExclude = [.../* @__PURE__ */ new Set([...exclude || [], ...ignoreFromFile, ...baseExclude])];
+  const finalExclude = [
+    .../* @__PURE__ */ new Set([...exclude || [], ...ignoreFromFile, ...baseExclude])
+  ];
   const dirs = await glob("**/", {
     cwd: rootDir,
     ignore: finalExclude,
@@ -259,16 +340,23 @@ async function scanEntries(options) {
     for (const gitignorePath of gitignoreFiles) {
       const gitTxt = await readFile(gitignorePath, "utf-8");
       const gitignoreDir = dirname(gitignorePath);
-      const relativePrefix = relative(rootDir || ".", gitignoreDir).replace(/\\/g, "/");
+      const relativePrefix = relative(rootDir || ".", gitignoreDir).replace(
+        /\\/g,
+        "/"
+      );
       const patterns = gitTxt.split(/\r?\n/).map((s) => s.trim()).filter(Boolean).filter((l) => !l.startsWith("#"));
       if (relativePrefix === "." || relativePrefix === "") {
         ig.add(patterns);
       } else {
-        ig.add(patterns.map((p) => p.startsWith("/") ? `${relativePrefix}${p}` : `${relativePrefix}/**/${p}`));
+        ig.add(
+          patterns.map(
+            (p) => p.startsWith("/") ? `${relativePrefix}${p}` : `${relativePrefix}/**/${p}`
+          )
+        );
       }
     }
     const filteredDirs = dirs.filter((d) => {
-      let rel = relative(rootDir || ".", d).replace(/\\/g, "/").replace(/\/$/, "");
+      const rel = relative(rootDir || ".", d).replace(/\\/g, "/").replace(/\/$/, "");
       if (rel === "") return true;
       return !ig.ignores(rel);
     });
@@ -2207,7 +2295,7 @@ function calculateChangeAmplification(params) {
   const hotspots = files.map((f) => ({ ...f, amplificationFactor: f.fanOut + f.fanIn * 0.5 })).sort((a, b) => b.amplificationFactor - a.amplificationFactor);
   const maxAmplification = hotspots[0].amplificationFactor;
   const avgAmplification = hotspots.reduce((sum, h) => sum + h.amplificationFactor, 0) / hotspots.length;
-  let score = Math.max(
+  const score = Math.max(
     0,
     Math.min(
       100,
@@ -2552,9 +2640,11 @@ export {
   Severity,
   SeveritySchema,
   SpokeOutputSchema,
+  SpokeSummarySchema,
   TOOL_NAME_MAP,
   ToolName,
   ToolNameSchema,
+  ToolRegistry,
   TypeScriptParser,
   UnifiedReportSchema,
   VAGUE_FILE_NAMES,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiready/core",
-  "version": "0.19.5",
+  "version": "0.21.0",
   "description": "Shared utilities for AIReady analysis tools",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",