@aiready/core 0.19.3 → 0.21.0

package/dist/client.d.mts

@@ -10,6 +10,30 @@ declare enum Severity {
     Info = "info"
 }
 declare const SeveritySchema: z.ZodEnum<typeof Severity>;
+/**
+ * Canonical Tool Names (IDs)
+ * Used everywhere as the single source of truth for tool identification.
+ */
+declare enum ToolName {
+    PatternDetect = "pattern-detect",
+    ContextAnalyzer = "context-analyzer",
+    NamingConsistency = "naming-consistency",
+    AiSignalClarity = "ai-signal-clarity",
+    AgentGrounding = "agent-grounding",
+    TestabilityIndex = "testability-index",
+    DocDrift = "doc-drift",
+    DependencyHealth = "dependency-health",
+    ChangeAmplification = "change-amplification",
+    CognitiveLoad = "cognitive-load",
+    PatternEntropy = "pattern-entropy",
+    ConceptCohesion = "concept-cohesion",
+    SemanticDistance = "semantic-distance"
+}
+declare const ToolNameSchema: z.ZodEnum<typeof ToolName>;
+/**
+ * Friendly labels for UI display
+ */
+declare const FRIENDLY_TOOL_NAMES: Record<ToolName, string>;
 /**
  * Standardized issue types across all AIReady tools.
  */
@@ -139,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.
  */
@@ -176,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>;
@@ -232,7 +273,7 @@ declare const UnifiedReportSchema: z.ZodObject<{
         rating: z.ZodString;
         timestamp: z.ZodString;
         breakdown: z.ZodArray<z.ZodObject<{
-            toolName: z.ZodString;
+            toolName: z.ZodUnion<readonly [z.ZodEnum<typeof ToolName>, z.ZodString]>;
             score: z.ZodNumber;
         }, z.core.$catchall<z.ZodAny>>>;
     }, z.core.$strip>>;
@@ -753,53 +794,26 @@ interface ScoringConfig {
  * Default weights for known tools. Weights sum to 100 and read directly as
  * percentage contribution to the overall score.
  * New tools get weight of 5 if not specified.
- *
- * Weight philosophy:
- * - pattern-detect (22%): Semantic duplication directly wastes token budget and
- *   confuses AI with contradictory in-context examples.
- * - context-analyzer (19%): Context limits are the primary hard constraint on
- *   AI effectiveness regardless of model size.
- * - consistency (14%): Naming/pattern inconsistency degrades AI intent understanding
- *   proportionally to codebase size.
- * - ai-signal-clarity (11%): Code patterns empirically causing AI to generate
- *   confidently wrong outputs — critical for agentic use cases.
- * - agent-grounding (10%): How well an autonomous agent can navigate unaided —
- *   increasingly important as agentic workflows grow.
- * - testability (10%): AI changes without verifiability create hidden risk.
- * - doc-drift (8%): Stale docs actively mislead AI; planned spoke.
- * - deps (6%): Dependency health affects AI suggestion accuracy; planned spoke.
  */
 declare const DEFAULT_TOOL_WEIGHTS: Record<string, number>;
 /**
- * Tool name normalization map (shorthand -> full name)
+ * Tool name normalization map (shorthand -> canonical name)
  */
 declare const TOOL_NAME_MAP: Record<string, string>;
 /**
  * Model context tiers for context-aware threshold calibration.
- *
- * As AI models evolve from 32k → 128k → 1M+ context windows, absolute token
- * thresholds become meaningless. Use these tiers to adjust context-analyzer
- * thresholds relative to the model your team uses.
  */
 type ModelContextTier = 'compact' | 'standard' | 'extended' | 'frontier';
 /**
  * Context budget thresholds per tier.
- * Scores are interpolated between these boundaries.
  */
 declare const CONTEXT_TIER_THRESHOLDS: Record<ModelContextTier, {
-    /** Below this → full score for context budget */
     idealTokens: number;
-    /** Above this → critical penalty for context budget */
     criticalTokens: number;
-    /** Suggested max import depth before penalty */
     idealDepth: number;
 }>;
 /**
  * Project-size-adjusted minimum thresholds.
- *
- * Large codebases structurally accrue more issues. A score of 65 in an
- * enterprise codebase is roughly equivalent to 75 in a small project.
- * These are recommended minimum passing thresholds by project size.
  */
 declare const SIZE_ADJUSTED_THRESHOLDS: Record<string, number>;
 /**
@@ -811,30 +825,21 @@ declare function getProjectSizeTier(fileCount: number): keyof typeof SIZE_ADJUST
  */
 declare function getRecommendedThreshold(fileCount: number, modelTier?: ModelContextTier): number;
 /**
- * Normalize tool name from shorthand to full name
+ * Normalize tool name from shorthand to canonical name
  */
 declare function normalizeToolName(shortName: string): string;
 /**
- * Get tool weight with fallback priority:
- * 1. CLI override
- * 2. Tool config scoreWeight
- * 3. Default weight
- * 4. 10 (for unknown tools)
+ * Get tool weight
  */
 declare function getToolWeight(toolName: string, toolConfig?: {
     scoreWeight?: number;
 }, cliOverride?: number): number;
 /**
- * Parse weight string from CLI (e.g., "patterns:50,context:30")
+ * Parse weight string from CLI
  */
 declare function parseWeightString(weightStr?: string): Map<string, number>;
 /**
- * Calculate overall AI Readiness Score from multiple tool scores.
- *
- * Formula: Σ(tool_score × tool_weight) / Σ(active_tool_weights)
- *
- * This allows dynamic composition - score adjusts automatically
- * based on which tools actually ran.
+ * Calculate overall AI Readiness Score
  */
 declare function calculateOverallScore(toolOutputs: Map<string, ToolScoringOutput>, config?: any, cliWeights?: Map<string, number>): ScoringResult;
 /**
@@ -843,18 +848,17 @@ declare function calculateOverallScore(toolOutputs: Map<string, ToolScoringOutpu
 declare function getRating(score: number): ScoringResult['rating'];
 /**
  * Convert score to rating with project-size awareness.
- * Use this for display to give fairer assessment to large codebases.
  */
 declare function getRatingWithContext(score: number, fileCount: number, modelTier?: ModelContextTier): ScoringResult['rating'];
 /**
- * Get rating emoji and color for display
+ * Get rating display properties
  */
 declare function getRatingDisplay(rating: ScoringResult['rating']): {
     emoji: string;
     color: string;
 };
 /**
- * Format score for display with rating
+ * Format score for display
  */
 declare function formatScore(result: ScoringResult): string;
 /**
@@ -875,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, 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, 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

@@ -10,6 +10,30 @@ declare enum Severity {
     Info = "info"
 }
 declare const SeveritySchema: z.ZodEnum<typeof Severity>;
+/**
+ * Canonical Tool Names (IDs)
+ * Used everywhere as the single source of truth for tool identification.
+ */
+declare enum ToolName {
+    PatternDetect = "pattern-detect",
+    ContextAnalyzer = "context-analyzer",
+    NamingConsistency = "naming-consistency",
+    AiSignalClarity = "ai-signal-clarity",
+    AgentGrounding = "agent-grounding",
+    TestabilityIndex = "testability-index",
+    DocDrift = "doc-drift",
+    DependencyHealth = "dependency-health",
+    ChangeAmplification = "change-amplification",
+    CognitiveLoad = "cognitive-load",
+    PatternEntropy = "pattern-entropy",
+    ConceptCohesion = "concept-cohesion",
+    SemanticDistance = "semantic-distance"
+}
+declare const ToolNameSchema: z.ZodEnum<typeof ToolName>;
+/**
+ * Friendly labels for UI display
+ */
+declare const FRIENDLY_TOOL_NAMES: Record<ToolName, string>;
 /**
  * Standardized issue types across all AIReady tools.
  */
@@ -139,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.
  */
@@ -176,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>;
@@ -232,7 +273,7 @@ declare const UnifiedReportSchema: z.ZodObject<{
         rating: z.ZodString;
         timestamp: z.ZodString;
         breakdown: z.ZodArray<z.ZodObject<{
-            toolName: z.ZodString;
+            toolName: z.ZodUnion<readonly [z.ZodEnum<typeof ToolName>, z.ZodString]>;
             score: z.ZodNumber;
         }, z.core.$catchall<z.ZodAny>>>;
     }, z.core.$strip>>;
@@ -753,53 +794,26 @@ interface ScoringConfig {
  * Default weights for known tools. Weights sum to 100 and read directly as
  * percentage contribution to the overall score.
  * New tools get weight of 5 if not specified.
- *
- * Weight philosophy:
- * - pattern-detect (22%): Semantic duplication directly wastes token budget and
- *   confuses AI with contradictory in-context examples.
- * - context-analyzer (19%): Context limits are the primary hard constraint on
- *   AI effectiveness regardless of model size.
- * - consistency (14%): Naming/pattern inconsistency degrades AI intent understanding
- *   proportionally to codebase size.
- * - ai-signal-clarity (11%): Code patterns empirically causing AI to generate
- *   confidently wrong outputs — critical for agentic use cases.
- * - agent-grounding (10%): How well an autonomous agent can navigate unaided —
- *   increasingly important as agentic workflows grow.
- * - testability (10%): AI changes without verifiability create hidden risk.
- * - doc-drift (8%): Stale docs actively mislead AI; planned spoke.
- * - deps (6%): Dependency health affects AI suggestion accuracy; planned spoke.
  */
 declare const DEFAULT_TOOL_WEIGHTS: Record<string, number>;
 /**
- * Tool name normalization map (shorthand -> full name)
+ * Tool name normalization map (shorthand -> canonical name)
  */
 declare const TOOL_NAME_MAP: Record<string, string>;
 /**
  * Model context tiers for context-aware threshold calibration.
- *
- * As AI models evolve from 32k → 128k → 1M+ context windows, absolute token
- * thresholds become meaningless. Use these tiers to adjust context-analyzer
- * thresholds relative to the model your team uses.
  */
 type ModelContextTier = 'compact' | 'standard' | 'extended' | 'frontier';
 /**
  * Context budget thresholds per tier.
- * Scores are interpolated between these boundaries.
  */
 declare const CONTEXT_TIER_THRESHOLDS: Record<ModelContextTier, {
-    /** Below this → full score for context budget */
     idealTokens: number;
-    /** Above this → critical penalty for context budget */
     criticalTokens: number;
-    /** Suggested max import depth before penalty */
     idealDepth: number;
 }>;
 /**
  * Project-size-adjusted minimum thresholds.
- *
- * Large codebases structurally accrue more issues. A score of 65 in an
- * enterprise codebase is roughly equivalent to 75 in a small project.
- * These are recommended minimum passing thresholds by project size.
  */
 declare const SIZE_ADJUSTED_THRESHOLDS: Record<string, number>;
 /**
@@ -811,30 +825,21 @@ declare function getProjectSizeTier(fileCount: number): keyof typeof SIZE_ADJUST
  */
 declare function getRecommendedThreshold(fileCount: number, modelTier?: ModelContextTier): number;
 /**
- * Normalize tool name from shorthand to full name
+ * Normalize tool name from shorthand to canonical name
  */
 declare function normalizeToolName(shortName: string): string;
 /**
- * Get tool weight with fallback priority:
- * 1. CLI override
- * 2. Tool config scoreWeight
- * 3. Default weight
- * 4. 10 (for unknown tools)
+ * Get tool weight
  */
 declare function getToolWeight(toolName: string, toolConfig?: {
     scoreWeight?: number;
 }, cliOverride?: number): number;
 /**
- * Parse weight string from CLI (e.g., "patterns:50,context:30")
+ * Parse weight string from CLI
  */
 declare function parseWeightString(weightStr?: string): Map<string, number>;
 /**
- * Calculate overall AI Readiness Score from multiple tool scores.
- *
- * Formula: Σ(tool_score × tool_weight) / Σ(active_tool_weights)
- *
- * This allows dynamic composition - score adjusts automatically
- * based on which tools actually ran.
+ * Calculate overall AI Readiness Score
  */
 declare function calculateOverallScore(toolOutputs: Map<string, ToolScoringOutput>, config?: any, cliWeights?: Map<string, number>): ScoringResult;
 /**
@@ -843,18 +848,17 @@ declare function calculateOverallScore(toolOutputs: Map<string, ToolScoringOutpu
 declare function getRating(score: number): ScoringResult['rating'];
 /**
  * Convert score to rating with project-size awareness.
- * Use this for display to give fairer assessment to large codebases.
  */
 declare function getRatingWithContext(score: number, fileCount: number, modelTier?: ModelContextTier): ScoringResult['rating'];
 /**
- * Get rating emoji and color for display
+ * Get rating display properties
  */
 declare function getRatingDisplay(rating: ScoringResult['rating']): {
     emoji: string;
     color: string;
 };
 /**
- * Format score for display with rating
+ * Format score for display
  */
 declare function formatScore(result: ScoringResult): string;
 /**
@@ -875,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, 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, 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

@@ -25,6 +25,7 @@ __export(client_exports, {
   AnalysisStatusSchema: () => AnalysisStatusSchema,
   CONTEXT_TIER_THRESHOLDS: () => CONTEXT_TIER_THRESHOLDS,
   DEFAULT_TOOL_WEIGHTS: () => DEFAULT_TOOL_WEIGHTS,
+  FRIENDLY_TOOL_NAMES: () => FRIENDLY_TOOL_NAMES,
   IssueSchema: () => IssueSchema,
   IssueType: () => IssueType,
   IssueTypeSchema: () => IssueTypeSchema,
@@ -39,7 +40,10 @@ __export(client_exports, {
   Severity: () => Severity,
   SeveritySchema: () => SeveritySchema,
   SpokeOutputSchema: () => SpokeOutputSchema,
+  SpokeSummarySchema: () => SpokeSummarySchema,
   TOOL_NAME_MAP: () => TOOL_NAME_MAP,
+  ToolName: () => ToolName,
+  ToolNameSchema: () => ToolNameSchema,
   UnifiedReportSchema: () => UnifiedReportSchema,
   calculateOverallScore: () => calculateOverallScore,
   formatScore: () => formatScore,
@@ -66,6 +70,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";
@@ -142,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({
@@ -163,10 +206,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());
 
@@ -203,28 +248,34 @@ var ParseError = class extends Error {
 
 // 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 },
@@ -258,22 +309,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(":");
@@ -305,8 +350,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;
@@ -565,6 +609,7 @@ function generateHTML(graph) {
   AnalysisStatusSchema,
   CONTEXT_TIER_THRESHOLDS,
   DEFAULT_TOOL_WEIGHTS,
+  FRIENDLY_TOOL_NAMES,
   IssueSchema,
   IssueType,
   IssueTypeSchema,
@@ -579,7 +624,10 @@ function generateHTML(graph) {
   Severity,
   SeveritySchema,
   SpokeOutputSchema,
+  SpokeSummarySchema,
   TOOL_NAME_MAP,
+  ToolName,
+  ToolNameSchema,
   UnifiedReportSchema,
   calculateOverallScore,
   formatScore,

package/dist/client.mjs

@@ -4,6 +4,7 @@ import {
   AnalysisStatusSchema,
   CONTEXT_TIER_THRESHOLDS,
   DEFAULT_TOOL_WEIGHTS,
+  FRIENDLY_TOOL_NAMES,
   IssueSchema,
   IssueType,
   IssueTypeSchema,
@@ -18,7 +19,10 @@ import {
   Severity,
   SeveritySchema,
   SpokeOutputSchema,
+  SpokeSummarySchema,
   TOOL_NAME_MAP,
+  ToolName,
+  ToolNameSchema,
   UnifiedReportSchema,
   calculateOverallScore,
   formatScore,
@@ -32,13 +36,14 @@ import {
   getToolWeight,
   normalizeToolName,
   parseWeightString
-} from "./chunk-D3D3NCRR.mjs";
+} from "./chunk-YCA4FTEK.mjs";
 export {
   AnalysisResultSchema,
   AnalysisStatus,
   AnalysisStatusSchema,
   CONTEXT_TIER_THRESHOLDS,
   DEFAULT_TOOL_WEIGHTS,
+  FRIENDLY_TOOL_NAMES,
   IssueSchema,
   IssueType,
   IssueTypeSchema,
@@ -53,7 +58,10 @@ export {
   Severity,
   SeveritySchema,
   SpokeOutputSchema,
+  SpokeSummarySchema,
   TOOL_NAME_MAP,
+  ToolName,
+  ToolNameSchema,
   UnifiedReportSchema,
   calculateOverallScore,
   formatScore,