@aiready/core 0.19.3 → 0.21.0

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, 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, 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, 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, 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

@@ -37,6 +37,7 @@ __export(index_exports, {
   DEFAULT_COST_CONFIG: () => DEFAULT_COST_CONFIG,
   DEFAULT_EXCLUDE: () => DEFAULT_EXCLUDE,
   DEFAULT_TOOL_WEIGHTS: () => DEFAULT_TOOL_WEIGHTS,
+  FRIENDLY_TOOL_NAMES: () => FRIENDLY_TOOL_NAMES,
   IssueSchema: () => IssueSchema,
   IssueType: () => IssueType,
   IssueTypeSchema: () => IssueTypeSchema,
@@ -55,7 +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,
@@ -145,6 +150,38 @@ var Severity = /* @__PURE__ */ ((Severity2) => {
   return Severity2;
 })(Severity || {});
 var SeveritySchema = import_zod.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 = import_zod.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";
@@ -221,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({
@@ -242,10 +286,12 @@ var UnifiedReportSchema = import_zod.z.object({
     overall: import_zod.z.number(),
     rating: import_zod.z.string(),
     timestamp: import_zod.z.string(),
-    breakdown: import_zod.z.array(import_zod.z.object({
-      toolName: import_zod.z.string(),
-      score: import_zod.z.number()
-    }).catchall(import_zod.z.any()))
+    breakdown: import_zod.z.array(
+      import_zod.z.object({
+        toolName: import_zod.z.union([ToolNameSchema, import_zod.z.string()]),
+        score: import_zod.z.number()
+      }).catchall(import_zod.z.any())
+    )
   }).optional()
 }).catchall(import_zod.z.any());
 
@@ -338,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");
@@ -430,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])
@@ -451,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) => {
@@ -484,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,
@@ -502,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);
     });
@@ -1035,28 +1168,34 @@ function generateHTML(graph) {
 
 // src/scoring.ts
 var DEFAULT_TOOL_WEIGHTS = {
-  "pattern-detect": 22,
-  "context-analyzer": 19,
-  consistency: 14,
-  "ai-signal-clarity": 11,
-  "agent-grounding": 10,
-  testability: 10,
-  "doc-drift": 8,
-  deps: 6
+  ["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",
-  context: "context-analyzer",
-  consistency: "consistency",
-  "AI signal clarity": "ai-signal-clarity",
-  "ai-signal-clarity": "ai-signal-clarity",
-  grounding: "agent-grounding",
-  "agent-grounding": "agent-grounding",
-  testability: "testability",
-  tests: "testability",
-  "doc-drift": "doc-drift",
-  docs: "doc-drift",
-  deps: "deps"
+  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 },
@@ -1090,22 +1229,16 @@ function getRecommendedThreshold(fileCount, modelTier = "standard") {
   return base + modelBonus;
 }
 function normalizeToolName(shortName) {
-  return TOOL_NAME_MAP[shortName] || 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;
-  }
+  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;
-  }
+  if (!weightStr) return weights;
   const pairs = weightStr.split(",");
   for (const pair of pairs) {
     const [toolShortName, weightStr2] = pair.split(":");
@@ -1137,8 +1270,7 @@ function calculateOverallScore(toolOutputs, config, cliWeights) {
   const calculationWeights = {};
   for (const [toolName, output] of toolOutputs.entries()) {
     const weight = weights.get(toolName) || 5;
-    const weightedScore = output.score * weight;
-    weightedSum += weightedScore;
+    weightedSum += output.score * weight;
     totalWeight += weight;
     toolsUsed.push(toolName);
     calculationWeights[toolName] = weight;
@@ -2808,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,
@@ -3135,6 +3267,7 @@ function getRepoMetadata(directory) {
   DEFAULT_COST_CONFIG,
   DEFAULT_EXCLUDE,
   DEFAULT_TOOL_WEIGHTS,
+  FRIENDLY_TOOL_NAMES,
   IssueSchema,
   IssueType,
   IssueTypeSchema,
@@ -3153,7 +3286,11 @@ function getRepoMetadata(directory) {
   Severity,
   SeveritySchema,
   SpokeOutputSchema,
+  SpokeSummarySchema,
   TOOL_NAME_MAP,
+  ToolName,
+  ToolNameSchema,
+  ToolRegistry,
   TypeScriptParser,
   UnifiedReportSchema,
   VAGUE_FILE_NAMES,