@aiready/core 0.19.2 → 0.19.5

package/dist/client.js

@@ -20,13 +20,30 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/client.ts
 var client_exports = {};
 __export(client_exports, {
+  AnalysisResultSchema: () => AnalysisResultSchema,
+  AnalysisStatus: () => AnalysisStatus,
+  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,
   LANGUAGE_EXTENSIONS: () => LANGUAGE_EXTENSIONS,
   Language: () => Language,
+  LocationSchema: () => LocationSchema,
+  MetricsSchema: () => MetricsSchema,
+  ModelTier: () => ModelTier,
+  ModelTierSchema: () => ModelTierSchema,
   ParseError: () => ParseError,
   SIZE_ADJUSTED_THRESHOLDS: () => SIZE_ADJUSTED_THRESHOLDS,
+  Severity: () => Severity,
+  SeveritySchema: () => SeveritySchema,
+  SpokeOutputSchema: () => SpokeOutputSchema,
   TOOL_NAME_MAP: () => TOOL_NAME_MAP,
+  ToolName: () => ToolName,
+  ToolNameSchema: () => ToolNameSchema,
+  UnifiedReportSchema: () => UnifiedReportSchema,
   calculateOverallScore: () => calculateOverallScore,
   formatScore: () => formatScore,
   formatToolScore: () => formatToolScore,
@@ -42,6 +59,154 @@ __export(client_exports, {
 });
 module.exports = __toCommonJS(client_exports);
 
+// src/types/schema.ts
+var import_zod = require("zod");
+var Severity = /* @__PURE__ */ ((Severity2) => {
+  Severity2["Critical"] = "critical";
+  Severity2["Major"] = "major";
+  Severity2["Minor"] = "minor";
+  Severity2["Info"] = "info";
+  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";
+  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 = import_zod.z.nativeEnum(IssueType);
+var AnalysisStatus = /* @__PURE__ */ ((AnalysisStatus2) => {
+  AnalysisStatus2["Processing"] = "processing";
+  AnalysisStatus2["Completed"] = "completed";
+  AnalysisStatus2["Failed"] = "failed";
+  return AnalysisStatus2;
+})(AnalysisStatus || {});
+var AnalysisStatusSchema = import_zod.z.nativeEnum(AnalysisStatus);
+var ModelTier = /* @__PURE__ */ ((ModelTier2) => {
+  ModelTier2["Compact"] = "compact";
+  ModelTier2["Standard"] = "standard";
+  ModelTier2["Extended"] = "extended";
+  ModelTier2["Frontier"] = "frontier";
+  return ModelTier2;
+})(ModelTier || {});
+var ModelTierSchema = import_zod.z.nativeEnum(ModelTier);
+var LocationSchema = import_zod.z.object({
+  file: import_zod.z.string(),
+  line: import_zod.z.number(),
+  column: import_zod.z.number().optional(),
+  endLine: import_zod.z.number().optional(),
+  endColumn: import_zod.z.number().optional()
+});
+var IssueSchema = import_zod.z.object({
+  type: IssueTypeSchema,
+  severity: SeveritySchema,
+  message: import_zod.z.string(),
+  location: LocationSchema,
+  suggestion: import_zod.z.string().optional()
+});
+var MetricsSchema = import_zod.z.object({
+  tokenCost: import_zod.z.number().optional(),
+  complexityScore: import_zod.z.number().optional(),
+  consistencyScore: import_zod.z.number().optional(),
+  docFreshnessScore: import_zod.z.number().optional(),
+  // AI agent readiness metrics (v0.12+)
+  aiSignalClarityScore: import_zod.z.number().optional(),
+  agentGroundingScore: import_zod.z.number().optional(),
+  testabilityScore: import_zod.z.number().optional(),
+  docDriftScore: import_zod.z.number().optional(),
+  dependencyHealthScore: import_zod.z.number().optional(),
+  modelContextTier: ModelTierSchema.optional(),
+  // Business value metrics
+  estimatedMonthlyCost: import_zod.z.number().optional(),
+  estimatedDeveloperHours: import_zod.z.number().optional(),
+  comprehensionDifficultyIndex: import_zod.z.number().optional(),
+  // Extended metrics for specific spokes
+  totalSymbols: import_zod.z.number().optional(),
+  totalExports: import_zod.z.number().optional()
+});
+var AnalysisResultSchema = import_zod.z.object({
+  fileName: import_zod.z.string(),
+  issues: import_zod.z.array(IssueSchema),
+  metrics: MetricsSchema
+});
+var SpokeOutputSchema = import_zod.z.object({
+  results: import_zod.z.array(AnalysisResultSchema),
+  summary: import_zod.z.any(),
+  metadata: import_zod.z.object({
+    toolName: import_zod.z.string(),
+    version: import_zod.z.string(),
+    timestamp: import_zod.z.string()
+  }).catchall(import_zod.z.any()).optional()
+});
+var UnifiedReportSchema = import_zod.z.object({
+  summary: import_zod.z.object({
+    totalFiles: import_zod.z.number(),
+    totalIssues: import_zod.z.number(),
+    criticalIssues: import_zod.z.number(),
+    majorIssues: import_zod.z.number()
+  }),
+  results: import_zod.z.array(AnalysisResultSchema),
+  scoring: 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.union([ToolNameSchema, import_zod.z.string()]),
+        score: import_zod.z.number()
+      }).catchall(import_zod.z.any())
+    )
+  }).optional()
+}).catchall(import_zod.z.any());
+
 // src/types/language.ts
 var Language = /* @__PURE__ */ ((Language2) => {
   Language2["TypeScript"] = "typescript";
@@ -75,28 +240,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 },
@@ -130,22 +301,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(":");
@@ -177,8 +342,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;
@@ -432,13 +596,30 @@ function generateHTML(graph) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  AnalysisResultSchema,
+  AnalysisStatus,
+  AnalysisStatusSchema,
   CONTEXT_TIER_THRESHOLDS,
   DEFAULT_TOOL_WEIGHTS,
+  FRIENDLY_TOOL_NAMES,
+  IssueSchema,
+  IssueType,
+  IssueTypeSchema,
   LANGUAGE_EXTENSIONS,
   Language,
+  LocationSchema,
+  MetricsSchema,
+  ModelTier,
+  ModelTierSchema,
   ParseError,
   SIZE_ADJUSTED_THRESHOLDS,
+  Severity,
+  SeveritySchema,
+  SpokeOutputSchema,
   TOOL_NAME_MAP,
+  ToolName,
+  ToolNameSchema,
+  UnifiedReportSchema,
   calculateOverallScore,
   formatScore,
   formatToolScore,

package/dist/client.mjs

@@ -1,11 +1,28 @@
 import {
+  AnalysisResultSchema,
+  AnalysisStatus,
+  AnalysisStatusSchema,
   CONTEXT_TIER_THRESHOLDS,
   DEFAULT_TOOL_WEIGHTS,
+  FRIENDLY_TOOL_NAMES,
+  IssueSchema,
+  IssueType,
+  IssueTypeSchema,
   LANGUAGE_EXTENSIONS,
   Language,
+  LocationSchema,
+  MetricsSchema,
+  ModelTier,
+  ModelTierSchema,
   ParseError,
   SIZE_ADJUSTED_THRESHOLDS,
+  Severity,
+  SeveritySchema,
+  SpokeOutputSchema,
   TOOL_NAME_MAP,
+  ToolName,
+  ToolNameSchema,
+  UnifiedReportSchema,
   calculateOverallScore,
   formatScore,
   formatToolScore,
@@ -18,15 +35,32 @@ import {
   getToolWeight,
   normalizeToolName,
   parseWeightString
-} from "./chunk-UQGI67WR.mjs";
+} from "./chunk-QAFB3HXQ.mjs";
 export {
+  AnalysisResultSchema,
+  AnalysisStatus,
+  AnalysisStatusSchema,
   CONTEXT_TIER_THRESHOLDS,
   DEFAULT_TOOL_WEIGHTS,
+  FRIENDLY_TOOL_NAMES,
+  IssueSchema,
+  IssueType,
+  IssueTypeSchema,
   LANGUAGE_EXTENSIONS,
   Language,
+  LocationSchema,
+  MetricsSchema,
+  ModelTier,
+  ModelTierSchema,
   ParseError,
   SIZE_ADJUSTED_THRESHOLDS,
+  Severity,
+  SeveritySchema,
+  SpokeOutputSchema,
   TOOL_NAME_MAP,
+  ToolName,
+  ToolNameSchema,
+  UnifiedReportSchema,
   calculateOverallScore,
   formatScore,
   formatToolScore,

package/dist/index.d.mts

@@ -1,5 +1,6 @@
-import { AnalysisResult, ScanOptions, AIReadyConfig, ModelContextTier, CostConfig, TokenBudget, ProductivityImpact, ToolScoringOutput, AcceptancePrediction, ComprehensionDifficulty, TechnicalValueChainSummary, TechnicalValueChain, LanguageParser, Language, ParseResult, NamingConvention } from './client.mjs';
-export { BusinessReport, CONTEXT_TIER_THRESHOLDS, CommonASTNode, DEFAULT_TOOL_WEIGHTS, ExportInfo, GraphData, GraphEdge, GraphIssueSeverity, GraphMetadata, GraphNode, ImportInfo, Issue, IssueType, LANGUAGE_EXTENSIONS, LanguageConfig, Location, Metrics, ParseError, ParseStatistics, Report, SIZE_ADJUSTED_THRESHOLDS, ScoringConfig, ScoringResult, SourceLocation, SourceRange, TOOL_NAME_MAP, calculateOverallScore, formatScore, formatToolScore, generateHTML, getProjectSizeTier, getRating, getRatingDisplay, getRatingWithContext, getRecommendedThreshold, getToolWeight, normalizeToolName, parseWeightString } from './client.mjs';
+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 { z } from 'zod';
 
 /**
  * Spoke-to-Hub Contract Definitions
@@ -7,20 +8,6 @@ export { BusinessReport, CONTEXT_TIER_THRESHOLDS, CommonASTNode, DEFAULT_TOOL_WE
  * changes in spokes don't break the CLI, Platform, or Visualizer.
  */
 
-/**
- * The standard output every spoke MUST provide when analyzed.
- * Some fields are optional depending on the tool's focus.
- */
-interface SpokeOutput {
-    results: AnalysisResult[];
-    summary: any;
-    metadata?: {
-        toolName: string;
-        version: string;
-        timestamp: string;
-        [key: string]: any;
-    };
-}
 /**
  * Validation utility to ensure a spoke's output matches the expected contract.
  * Used in spoke tests to catch breakages early.
@@ -30,29 +17,13 @@ declare function validateSpokeOutput(toolName: string, output: any): {
     errors: string[];
 };
 /**
- * The unified report format produced by the CLI and consumed by the Platform.
- * This is the master contract for the entire system.
+ * Zod-based validation (Round 1 improvement)
  */
-interface UnifiedReport {
-    summary: {
-        totalFiles: number;
-        totalIssues: number;
-        criticalIssues: number;
-        majorIssues: number;
-    };
-    results: AnalysisResult[];
-    scoring?: {
-        overall: number;
-        rating: string;
-        timestamp: string;
-        breakdown: Array<{
-            toolName: string;
-            score: number;
-            [key: string]: any;
-        }>;
-    };
-    [toolKey: string]: any;
-}
+declare function validateWithSchema<T>(schema: z.ZodSchema<T>, data: any): {
+    valid: boolean;
+    data?: T;
+    errors?: string[];
+};
 
 declare const DEFAULT_EXCLUDE: string[];
 declare const VAGUE_FILE_NAMES: Set<string>;
@@ -829,4 +800,4 @@ declare function getRepoMetadata(directory: string): {
     author?: string;
 };
 
-export { AIReadyConfig, type ASTNode, AcceptancePrediction, type AgentGroundingScore, type AiSignalClarity, type AiSignalClaritySignal, AnalysisResult, 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 SpokeOutput, type TechnicalDebtInterest, TechnicalValueChain, TechnicalValueChainSummary, type TestabilityIndex, TokenBudget, ToolScoringOutput, TypeScriptParser, type UnifiedReport, 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 };
+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 };

package/dist/index.d.ts

@@ -1,5 +1,6 @@
-import { AnalysisResult, ScanOptions, AIReadyConfig, ModelContextTier, CostConfig, TokenBudget, ProductivityImpact, ToolScoringOutput, AcceptancePrediction, ComprehensionDifficulty, TechnicalValueChainSummary, TechnicalValueChain, LanguageParser, Language, ParseResult, NamingConvention } from './client.js';
-export { BusinessReport, CONTEXT_TIER_THRESHOLDS, CommonASTNode, DEFAULT_TOOL_WEIGHTS, ExportInfo, GraphData, GraphEdge, GraphIssueSeverity, GraphMetadata, GraphNode, ImportInfo, Issue, IssueType, LANGUAGE_EXTENSIONS, LanguageConfig, Location, Metrics, ParseError, ParseStatistics, Report, SIZE_ADJUSTED_THRESHOLDS, ScoringConfig, ScoringResult, SourceLocation, SourceRange, TOOL_NAME_MAP, calculateOverallScore, formatScore, formatToolScore, generateHTML, getProjectSizeTier, getRating, getRatingDisplay, getRatingWithContext, getRecommendedThreshold, getToolWeight, normalizeToolName, parseWeightString } from './client.js';
+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 { z } from 'zod';
 
 /**
  * Spoke-to-Hub Contract Definitions
@@ -7,20 +8,6 @@ export { BusinessReport, CONTEXT_TIER_THRESHOLDS, CommonASTNode, DEFAULT_TOOL_WE
  * changes in spokes don't break the CLI, Platform, or Visualizer.
  */
 
-/**
- * The standard output every spoke MUST provide when analyzed.
- * Some fields are optional depending on the tool's focus.
- */
-interface SpokeOutput {
-    results: AnalysisResult[];
-    summary: any;
-    metadata?: {
-        toolName: string;
-        version: string;
-        timestamp: string;
-        [key: string]: any;
-    };
-}
 /**
  * Validation utility to ensure a spoke's output matches the expected contract.
  * Used in spoke tests to catch breakages early.
@@ -30,29 +17,13 @@ declare function validateSpokeOutput(toolName: string, output: any): {
     errors: string[];
 };
 /**
- * The unified report format produced by the CLI and consumed by the Platform.
- * This is the master contract for the entire system.
+ * Zod-based validation (Round 1 improvement)
  */
-interface UnifiedReport {
-    summary: {
-        totalFiles: number;
-        totalIssues: number;
-        criticalIssues: number;
-        majorIssues: number;
-    };
-    results: AnalysisResult[];
-    scoring?: {
-        overall: number;
-        rating: string;
-        timestamp: string;
-        breakdown: Array<{
-            toolName: string;
-            score: number;
-            [key: string]: any;
-        }>;
-    };
-    [toolKey: string]: any;
-}
+declare function validateWithSchema<T>(schema: z.ZodSchema<T>, data: any): {
+    valid: boolean;
+    data?: T;
+    errors?: string[];
+};
 
 declare const DEFAULT_EXCLUDE: string[];
 declare const VAGUE_FILE_NAMES: Set<string>;
@@ -829,4 +800,4 @@ declare function getRepoMetadata(directory: string): {
     author?: string;
 };
 
-export { AIReadyConfig, type ASTNode, AcceptancePrediction, type AgentGroundingScore, type AiSignalClarity, type AiSignalClaritySignal, AnalysisResult, 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 SpokeOutput, type TechnicalDebtInterest, TechnicalValueChain, TechnicalValueChainSummary, type TestabilityIndex, TokenBudget, ToolScoringOutput, TypeScriptParser, type UnifiedReport, 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 };
+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 };