@aiready/core 0.23.7 → 0.23.8

package/dist/client.d.mts

@@ -1,2 +1,2 @@
-export { e as AIReadyConfig, g as AcceptancePrediction, A as AnalysisResult, p as AnalysisStatus, B as BusinessMetrics, r as COMMON_FINE_TUNING_OPTIONS, s as CONTEXT_TIER_THRESHOLDS, t as CommonASTNode, h as ComprehensionDifficulty, u as Config, C as CostConfig, D as DEFAULT_TOOL_WEIGHTS, l as ExportInfo, v as FRIENDLY_TOOL_NAMES, w as FileContent, G as GLOBAL_INFRA_OPTIONS, x as GLOBAL_SCAN_OPTIONS, y as GraphData, z as GraphEdge, H as GraphIssueSeverity, J as GraphMetadata, K as GraphNode, I as ImportInfo, O as Issue, R as IssueType, V as LANGUAGE_EXTENSIONS, k as Language, W as LanguageConfig, L as LanguageParser, X as Lead, Y as LeadSchema, Z as LeadSource, _ as LeadSourceSchema, $ as LeadSubmission, a0 as LeadSubmissionSchema, a1 as Location, a5 as Metrics, M as ModelContextTier, N as NamingConvention, a9 as ParseError, m as ParseResult, aa as ParseStatistics, P as ProductivityImpact, ab as ReadinessRating, ac as RecommendationPriority, ad as SCORING_PROFILES, ae as SIZE_ADJUSTED_THRESHOLDS, S as ScanOptions, af as ScanResult, ag as ScoringConfig, ah as ScoringProfile, ai as ScoringResult, d as Severity, d as SeverityType, ak as SourceLocation, al as SourceRange, a as SpokeOutput, ap as TOOL_NAME_MAP, j as TechnicalValueChain, i as TechnicalValueChainSummary, f as TokenBudget, T as ToolName, c as ToolOptions, ar as ToolOutput, b as ToolScoringOutput, as as UnifiedReport, at as UnifiedReportSchema, au as calculateOverallScore, av as formatScore, aw as formatToolScore, ax as generateHTML, ay as getProjectSizeTier, az as getRating, aA as getRatingDisplay, aB as getRatingSlug, aC as getRatingWithContext, aD as getRecommendedThreshold, aE as getToolWeight, aF as normalizeToolName, aG as parseWeightString } from './client-C5BuGX4F.mjs';
+export { e as AIReadyConfig, h as AcceptancePrediction, A as AnalysisResult, r as AnalysisStatus, B as BusinessMetrics, t as COMMON_FINE_TUNING_OPTIONS, u as CONTEXT_TIER_THRESHOLDS, v as CommonASTNode, i as ComprehensionDifficulty, w as Config, C as CostConfig, D as DEFAULT_TOOL_WEIGHTS, n as ExportInfo, x as FRIENDLY_TOOL_NAMES, y as FileContent, G as GLOBAL_INFRA_OPTIONS, z as GLOBAL_SCAN_OPTIONS, H as GraphData, J as GraphEdge, K as GraphIssueSeverity, O as GraphMetadata, Q as GraphNode, I as Issue, U as IssueType, W as LANGUAGE_EXTENSIONS, l as Language, X as LanguageConfig, L as LanguageParser, Y as Lead, Z as LeadSchema, _ as LeadSource, $ as LeadSourceSchema, a0 as LeadSubmission, a1 as LeadSubmissionSchema, a2 as Location, M as Metrics, f as ModelContextTier, N as NamingConvention, a9 as ParseError, m as ParseResult, aa as ParseStatistics, P as ProductivityImpact, ab as ReadinessRating, ac as RecommendationPriority, ad as SCORING_PROFILES, ae as SIZE_ADJUSTED_THRESHOLDS, S as ScanOptions, af as ScanResult, ag as ScoringConfig, ah as ScoringProfile, ai as ScoringResult, d as Severity, d as SeverityType, ak as SourceLocation, al as SourceRange, a as SpokeOutput, ap as TOOL_NAME_MAP, k as TechnicalValueChain, j as TechnicalValueChainSummary, g as TokenBudget, T as ToolName, c as ToolOptions, ar as ToolOutput, b as ToolScoringOutput, as as UnifiedReport, at as UnifiedReportSchema, au as calculateOverallScore, av as formatScore, aw as formatToolScore, ax as generateHTML, ay as getProjectSizeTier, az as getRating, aA as getRatingDisplay, aB as getRatingSlug, aC as getRatingWithContext, aD as getRecommendedThreshold, aE as getToolWeight, aF as normalizeToolName, aG as parseWeightString } from './client-wk2fgk1q.mjs';
 import 'zod';

package/dist/client.d.ts

@@ -1,2 +1,2 @@
-export { e as AIReadyConfig, g as AcceptancePrediction, A as AnalysisResult, p as AnalysisStatus, B as BusinessMetrics, r as COMMON_FINE_TUNING_OPTIONS, s as CONTEXT_TIER_THRESHOLDS, t as CommonASTNode, h as ComprehensionDifficulty, u as Config, C as CostConfig, D as DEFAULT_TOOL_WEIGHTS, l as ExportInfo, v as FRIENDLY_TOOL_NAMES, w as FileContent, G as GLOBAL_INFRA_OPTIONS, x as GLOBAL_SCAN_OPTIONS, y as GraphData, z as GraphEdge, H as GraphIssueSeverity, J as GraphMetadata, K as GraphNode, I as ImportInfo, O as Issue, R as IssueType, V as LANGUAGE_EXTENSIONS, k as Language, W as LanguageConfig, L as LanguageParser, X as Lead, Y as LeadSchema, Z as LeadSource, _ as LeadSourceSchema, $ as LeadSubmission, a0 as LeadSubmissionSchema, a1 as Location, a5 as Metrics, M as ModelContextTier, N as NamingConvention, a9 as ParseError, m as ParseResult, aa as ParseStatistics, P as ProductivityImpact, ab as ReadinessRating, ac as RecommendationPriority, ad as SCORING_PROFILES, ae as SIZE_ADJUSTED_THRESHOLDS, S as ScanOptions, af as ScanResult, ag as ScoringConfig, ah as ScoringProfile, ai as ScoringResult, d as Severity, d as SeverityType, ak as SourceLocation, al as SourceRange, a as SpokeOutput, ap as TOOL_NAME_MAP, j as TechnicalValueChain, i as TechnicalValueChainSummary, f as TokenBudget, T as ToolName, c as ToolOptions, ar as ToolOutput, b as ToolScoringOutput, as as UnifiedReport, at as UnifiedReportSchema, au as calculateOverallScore, av as formatScore, aw as formatToolScore, ax as generateHTML, ay as getProjectSizeTier, az as getRating, aA as getRatingDisplay, aB as getRatingSlug, aC as getRatingWithContext, aD as getRecommendedThreshold, aE as getToolWeight, aF as normalizeToolName, aG as parseWeightString } from './client-C5BuGX4F.js';
+export { e as AIReadyConfig, h as AcceptancePrediction, A as AnalysisResult, r as AnalysisStatus, B as BusinessMetrics, t as COMMON_FINE_TUNING_OPTIONS, u as CONTEXT_TIER_THRESHOLDS, v as CommonASTNode, i as ComprehensionDifficulty, w as Config, C as CostConfig, D as DEFAULT_TOOL_WEIGHTS, n as ExportInfo, x as FRIENDLY_TOOL_NAMES, y as FileContent, G as GLOBAL_INFRA_OPTIONS, z as GLOBAL_SCAN_OPTIONS, H as GraphData, J as GraphEdge, K as GraphIssueSeverity, O as GraphMetadata, Q as GraphNode, I as Issue, U as IssueType, W as LANGUAGE_EXTENSIONS, l as Language, X as LanguageConfig, L as LanguageParser, Y as Lead, Z as LeadSchema, _ as LeadSource, $ as LeadSourceSchema, a0 as LeadSubmission, a1 as LeadSubmissionSchema, a2 as Location, M as Metrics, f as ModelContextTier, N as NamingConvention, a9 as ParseError, m as ParseResult, aa as ParseStatistics, P as ProductivityImpact, ab as ReadinessRating, ac as RecommendationPriority, ad as SCORING_PROFILES, ae as SIZE_ADJUSTED_THRESHOLDS, S as ScanOptions, af as ScanResult, ag as ScoringConfig, ah as ScoringProfile, ai as ScoringResult, d as Severity, d as SeverityType, ak as SourceLocation, al as SourceRange, a as SpokeOutput, ap as TOOL_NAME_MAP, k as TechnicalValueChain, j as TechnicalValueChainSummary, g as TokenBudget, T as ToolName, c as ToolOptions, ar as ToolOutput, b as ToolScoringOutput, as as UnifiedReport, at as UnifiedReportSchema, au as calculateOverallScore, av as formatScore, aw as formatToolScore, ax as generateHTML, ay as getProjectSizeTier, az as getRating, aA as getRatingDisplay, aB as getRatingSlug, aC as getRatingWithContext, aD as getRecommendedThreshold, aE as getToolWeight, aF as normalizeToolName, aG as parseWeightString } from './client-wk2fgk1q.js';
 import 'zod';

package/dist/client.js

@@ -220,6 +220,44 @@ var UnifiedReportSchema = import_zod.z.object({
     )
   }).optional()
 }).catchall(import_zod.z.any());
+var AIReadyConfigSchema = import_zod.z.object({
+  /** Target score threshold (0-100) */
+  threshold: import_zod.z.number().optional(),
+  /** Files or directories to include in scan */
+  include: import_zod.z.array(import_zod.z.string()).optional(),
+  /** Files or directories to exclude from scan */
+  exclude: import_zod.z.array(import_zod.z.string()).optional(),
+  /** Scan-specific configuration */
+  scan: import_zod.z.object({
+    include: import_zod.z.array(import_zod.z.string()).optional(),
+    exclude: import_zod.z.array(import_zod.z.string()).optional(),
+    parallel: import_zod.z.boolean().optional(),
+    deep: import_zod.z.boolean().optional(),
+    tools: import_zod.z.array(import_zod.z.string()).optional()
+  }).optional(),
+  /** Output-specific configuration */
+  output: import_zod.z.object({
+    /** Output format (json, console, html) */
+    format: import_zod.z.enum(["json", "console", "html"]).optional(),
+    /** Output file path */
+    path: import_zod.z.string().optional(),
+    /** Output directory */
+    saveTo: import_zod.z.string().optional(),
+    /** Whether to show score breakdown in console */
+    showBreakdown: import_zod.z.boolean().optional(),
+    /** Baseline report to compare against */
+    compareBaseline: import_zod.z.string().optional()
+  }).optional(),
+  /** Tool-specific configuration overrides (Strictly ToolName -> Config) */
+  tools: import_zod.z.record(import_zod.z.string(), import_zod.z.any()).optional(),
+  /** Scoring profile and weights */
+  scoring: import_zod.z.object({
+    /** Name of the scoring profile (e.g. "strict", "balanced") */
+    profile: import_zod.z.string().optional(),
+    /** Custom weights for tools and metrics */
+    weights: import_zod.z.record(import_zod.z.string(), import_zod.z.number()).optional()
+  }).optional()
+});
 
 // src/types/business.ts
 var import_zod2 = require("zod");
@@ -458,12 +496,12 @@ function getRecommendedThreshold(fileCount, modelTier = "standard") {
   return base + modelBonus;
 }
 function normalizeToolName(shortName) {
-  return TOOL_NAME_MAP[shortName.toLowerCase()] || shortName;
+  return TOOL_NAME_MAP[shortName.toLowerCase()] ?? shortName;
 }
 function getToolWeight(toolName, toolConfig, cliOverride, profile = "default" /* Default */) {
   if (cliOverride !== void 0) return cliOverride;
   if (toolConfig?.scoreWeight !== void 0) return toolConfig.scoreWeight;
-  const profileWeights = SCORING_PROFILES[profile] || DEFAULT_TOOL_WEIGHTS;
+  const profileWeights = SCORING_PROFILES[profile] ?? DEFAULT_TOOL_WEIGHTS;
   return profileWeights[toolName] ?? DEFAULT_TOOL_WEIGHTS[toolName] ?? 5;
 }
 function parseWeightString(weightStr) {
@@ -500,7 +538,7 @@ function calculateOverallScore(toolOutputs, config, cliWeights) {
   const toolsUsed = [];
   const calculationWeights = {};
   for (const [toolName, output] of toolOutputs.entries()) {
-    const weight = weights.get(toolName) || 5;
+    const weight = weights.get(toolName) ?? 5;
     weightedSum += output.score * weight;
     totalWeight += weight;
     toolsUsed.push(toolName);
@@ -511,7 +549,7 @@ function calculateOverallScore(toolOutputs, config, cliWeights) {
   const rating = getRating(overall);
   const formulaParts = Array.from(toolOutputs.entries()).map(
     ([name, output]) => {
-      const w = weights.get(name) || 5;
+      const w = weights.get(name) ?? 5;
       return `(${output.score} \xD7 ${w})`;
     }
   );

package/dist/client.mjs

@@ -36,7 +36,7 @@ import {
   getToolWeight,
   normalizeToolName,
   parseWeightString
-} from "./chunk-Q55AMEFV.mjs";
+} from "./chunk-TJXR2CHZ.mjs";
 export {
   AnalysisStatus,
   COMMON_FINE_TUNING_OPTIONS,

package/dist/index.d.mts

@@ -1,8 +1,7 @@
-import { T as ToolName, S as ScanOptions, a as SpokeOutput, b as ToolScoringOutput, c as ToolOptions, d as Severity, A as AnalysisResult, E as ExportWithImports, F as FileImport, e as AIReadyConfig, M as ModelContextTier, C as CostConfig, f as TokenBudget, P as ProductivityImpact, g as AcceptancePrediction, h as ComprehensionDifficulty, i as TechnicalValueChainSummary, j as TechnicalValueChain, L as LanguageParser, k as Language, l as ExportInfo, m as ParseResult, N as NamingConvention, I as ImportInfo } from './client-C5BuGX4F.mjs';
-export { n as ASTNode, o as AnalysisResultSchema, p as AnalysisStatus, q as AnalysisStatusSchema, B as BusinessMetrics, r as COMMON_FINE_TUNING_OPTIONS, s as CONTEXT_TIER_THRESHOLDS, t as CommonASTNode, u as Config, D as DEFAULT_TOOL_WEIGHTS, v as FRIENDLY_TOOL_NAMES, w as FileContent, G as GLOBAL_INFRA_OPTIONS, x as GLOBAL_SCAN_OPTIONS, y as GraphData, z as GraphEdge, H as GraphIssueSeverity, J as GraphMetadata, K as GraphNode, O as Issue, Q as IssueSchema, R as IssueType, U as IssueTypeSchema, V as LANGUAGE_EXTENSIONS, W as LanguageConfig, X as Lead, Y as LeadSchema, Z as LeadSource, _ as LeadSourceSchema, $ as LeadSubmission, a0 as LeadSubmissionSchema, a1 as Location, a2 as LocationSchema, a3 as ManagedAccount, a4 as ManagedAccountSchema, a5 as Metrics, a6 as MetricsSchema, a7 as ModelTier, a8 as ModelTierSchema, a9 as ParseError, aa as ParseStatistics, ab as ReadinessRating, ac as RecommendationPriority, ad as SCORING_PROFILES, ae as SIZE_ADJUSTED_THRESHOLDS, af as ScanResult, ag as ScoringConfig, ah as ScoringProfile, ai as ScoringResult, aj as SeveritySchema, ak as SourceLocation, al as SourceRange, am as SpokeOutputSchema, an as SpokeSummary, ao as SpokeSummarySchema, ap as TOOL_NAME_MAP, aq as ToolNameSchema, ar as ToolOutput, as as UnifiedReport, at as UnifiedReportSchema, au as calculateOverallScore, av as formatScore, aw as formatToolScore, ax as generateHTML, ay as getProjectSizeTier, az as getRating, aA as getRatingDisplay, aB as getRatingSlug, aC as getRatingWithContext, aD as getRecommendedThreshold, aE as getToolWeight, aF as normalizeToolName, aG as parseWeightString } from './client-C5BuGX4F.mjs';
+import { T as ToolName, S as ScanOptions, a as SpokeOutput, b as ToolScoringOutput, c as ToolOptions, d as Severity, A as AnalysisResult, E as ExportWithImports, F as FileImport, e as AIReadyConfig, I as Issue, M as Metrics, f as ModelContextTier, C as CostConfig, g as TokenBudget, P as ProductivityImpact, h as AcceptancePrediction, i as ComprehensionDifficulty, j as TechnicalValueChainSummary, k as TechnicalValueChain, L as LanguageParser, l as Language, m as ParseResult, N as NamingConvention, n as ExportInfo } from './client-wk2fgk1q.mjs';
+export { o as AIReadyConfigSchema, p as ASTNode, q as AnalysisResultSchema, r as AnalysisStatus, s as AnalysisStatusSchema, B as BusinessMetrics, t as COMMON_FINE_TUNING_OPTIONS, u as CONTEXT_TIER_THRESHOLDS, v as CommonASTNode, w as Config, D as DEFAULT_TOOL_WEIGHTS, x as FRIENDLY_TOOL_NAMES, y as FileContent, G as GLOBAL_INFRA_OPTIONS, z as GLOBAL_SCAN_OPTIONS, H as GraphData, J as GraphEdge, K as GraphIssueSeverity, O as GraphMetadata, Q as GraphNode, R as IssueSchema, U as IssueType, V as IssueTypeSchema, W as LANGUAGE_EXTENSIONS, X as LanguageConfig, Y as Lead, Z as LeadSchema, _ as LeadSource, $ as LeadSourceSchema, a0 as LeadSubmission, a1 as LeadSubmissionSchema, a2 as Location, a3 as LocationSchema, a4 as ManagedAccount, a5 as ManagedAccountSchema, a6 as MetricsSchema, a7 as ModelTier, a8 as ModelTierSchema, a9 as ParseError, aa as ParseStatistics, ab as ReadinessRating, ac as RecommendationPriority, ad as SCORING_PROFILES, ae as SIZE_ADJUSTED_THRESHOLDS, af as ScanResult, ag as ScoringConfig, ah as ScoringProfile, ai as ScoringResult, aj as SeveritySchema, ak as SourceLocation, al as SourceRange, am as SpokeOutputSchema, an as SpokeSummary, ao as SpokeSummarySchema, ap as TOOL_NAME_MAP, aq as ToolNameSchema, ar as ToolOutput, as as UnifiedReport, at as UnifiedReportSchema, au as calculateOverallScore, av as formatScore, aw as formatToolScore, ax as generateHTML, ay as getProjectSizeTier, az as getRating, aA as getRatingDisplay, aB as getRatingSlug, aC as getRatingWithContext, aD as getRecommendedThreshold, aE as getToolWeight, aF as normalizeToolName, aG as parseWeightString } from './client-wk2fgk1q.mjs';
 import { z } from 'zod';
 import * as Parser from 'web-tree-sitter';
-import { TSESTree } from '@typescript-eslint/typescript-estree';
 
 /**
  * Spoke-to-Hub Contract Definitions
@@ -429,6 +428,23 @@ declare function loadConfig(rootDir: string): Promise<AIReadyConfig | null>;
  */
 declare function mergeConfigWithDefaults(userConfig: AIReadyConfig | null, defaults: any): any;
 
+/**
+ * Normalizes raw issue data into a strict Issue object.
+ */
+declare function normalizeIssue(raw: any): Issue;
+/**
+ * Normalizes raw metrics into a strict Metrics object.
+ */
+declare function normalizeMetrics(raw: any): Metrics;
+/**
+ * Normalizes raw analysis result from any spoke into a strict AnalysisResult object.
+ */
+declare function normalizeAnalysisResult(raw: any): AnalysisResult;
+/**
+ * Normalizes a full SpokeOutput.
+ */
+declare function normalizeSpokeOutput(raw: any, toolName: string): SpokeOutput;
+
 /**
  * AI model pricing presets for cost estimation.
  * Prices are input token costs per 1K tokens (USD), as of Q1 2026.
@@ -753,15 +769,21 @@ declare function isFileSupported(filePath: string): boolean;
 declare function getSupportedLanguages(): Language[];
 
 /**
- * Initialize tree-sitter once
+ * Initialize tree-sitter once.
+ *
+ * @lastUpdated 2026-03-18
  */
 declare function initTreeSitter(): Promise<void>;
 /**
- * Find a WASM file for a specific language
+ * Find a WASM file for a specific language.
+ *
+ * @lastUpdated 2026-03-18
  */
 declare function getWasmPath(language: string): string | null;
 /**
- * Load a language and return a configured parser
+ * Load a language and return a configured parser.
+ *
+ * @lastUpdated 2026-03-18
  */
 declare function setupParser(language: string): Promise<Parser.Parser | null>;
 
@@ -775,14 +797,16 @@ declare class TypeScriptParser implements LanguageParser {
     readonly language = Language.TypeScript;
     readonly extensions: string[];
     initialize(): Promise<void>;
-    getAST(code: string, filePath: string): Promise<TSESTree.Program>;
-    analyzeMetadata(node: TSESTree.Node, code: string): Partial<ExportInfo>;
+    canHandle(filePath: string): boolean;
+    getAST(code: string, filePath: string): Promise<any>;
     parse(code: string, filePath: string): ParseResult;
     getNamingConventions(): NamingConvention;
-    canHandle(filePath: string): boolean;
+    analyzeMetadata(node: any, code: string): Partial<ExportInfo>;
     private extractImports;
     private extractExports;
-    private extractFromDeclaration;
+    private createExport;
+    private extractDocumentation;
+    private isLikelyPure;
 }
 
 /**
@@ -804,7 +828,7 @@ declare abstract class BaseLanguageParser implements LanguageParser {
     getAST(code: string, _filePath?: string): Promise<Parser.Tree | null>;
     abstract analyzeMetadata(node: Parser.Node, code: string): Partial<ExportInfo>;
     parse(code: string, filePath: string): ParseResult;
-    protected abstract extractImportsAST(rootNode: Parser.Node): ImportInfo[];
+    protected abstract extractImportsAST(rootNode: Parser.Node): FileImport[];
     protected abstract extractExportsAST(rootNode: Parser.Node, code: string): ExportInfo[];
     protected abstract parseRegex(code: string, filePath: string): ParseResult;
     abstract getNamingConventions(): NamingConvention;
@@ -833,9 +857,9 @@ declare class PythonParser extends BaseLanguageParser {
      * Extract import information using AST walk.
      *
      * @param rootNode - Root node of the Python AST.
-     * @returns Array of discovered ImportInfo objects.
+     * @returns Array of discovered FileImport objects.
      */
-    protected extractImportsAST(rootNode: Parser.Node): ImportInfo[];
+    protected extractImportsAST(rootNode: Parser.Node): FileImport[];
     /**
      * Extract export information using AST walk.
      *
@@ -888,9 +912,9 @@ declare class JavaParser extends BaseLanguageParser {
      * Extract import information using AST walk.
      *
      * @param rootNode - Root node of the Java AST.
-     * @returns Array of discovered ImportInfo objects.
+     * @returns Array of discovered FileImport objects.
      */
-    protected extractImportsAST(rootNode: Parser.Node): ImportInfo[];
+    protected extractImportsAST(rootNode: Parser.Node): FileImport[];
     /**
      * Extract export information (classes, interfaces, methods) using AST walk.
      *
@@ -949,9 +973,9 @@ declare class CSharpParser extends BaseLanguageParser {
      * Extract import information (usings) using AST walk.
      *
      * @param rootNode - Root node of the C# AST.
-     * @returns Array of discovered ImportInfo objects.
+     * @returns Array of discovered FileImport objects.
      */
-    protected extractImportsAST(rootNode: Parser.Node): ImportInfo[];
+    protected extractImportsAST(rootNode: Parser.Node): FileImport[];
     /**
      * Extract export information (classes, methods, properties) using AST walk.
      * Handles nested namespaces and classes.
@@ -996,9 +1020,9 @@ declare class GoParser extends BaseLanguageParser {
      * Extract import information using AST walk.
      *
      * @param rootNode - Root node of the Go AST.
-     * @returns Array of discovered ImportInfo objects.
+     * @returns Array of discovered FileImport objects.
      */
-    protected extractImportsAST(rootNode: Parser.Node): ImportInfo[];
+    protected extractImportsAST(rootNode: Parser.Node): FileImport[];
     /**
      * Extract export information (functions, types, vars) using AST walk.
      *
@@ -1614,4 +1638,4 @@ declare function severityToAnnotationLevel(severity: string): 'error' | 'warning
  */
 declare function emitIssuesAsAnnotations(issues: any[]): void;
 
-export { AIReadyConfig, AcceptancePrediction, type AgentGroundingScore, type AiSignalClarity, type AiSignalClaritySignal, AnalysisResult, type CLIOptions, CSharpParser, type ChangeAmplificationScore, type CognitiveLoad, ComprehensionDifficulty, type ConceptCohesion, CostConfig, DEFAULT_COST_CONFIG, DEFAULT_EXCLUDE, type DependencyHealthScore, type DocDriftRisk, ExportInfo, ExportWithImports, FileImport, type FileWithDomain, GoParser, ImportInfo, JavaParser, type KnowledgeConcentrationRisk, Language, LanguageParser, type LoadFactor, MODEL_PRICING_PRESETS, ModelContextTier, type ModelPricingPreset, NamingConvention, ParseResult, ParserFactory, type PatternEntropy, ProductivityImpact, type ProviderFactoryConfig, PythonParser, SEVERITY_TIME_ESTIMATES, ScanOptions, type ScoreHistoryEntry, type ScoreTrend, type SemanticDistance, Severity, Severity as SeverityType, SpokeOutput, type TechnicalDebtInterest, TechnicalValueChain, TechnicalValueChainSummary, type TestabilityIndex, TokenBudget, ToolName, ToolOptions, type ToolProvider, ToolRegistry, ToolScoringOutput, TypeScriptParser, VAGUE_FILE_NAMES, buildSimpleProviderScore, buildSpokeOutput, calculateAgentGrounding, calculateAiSignalClarity, calculateBusinessROI, calculateChangeAmplification, calculateCognitiveLoad, calculateComprehensionDifficulty, calculateConceptCohesion, calculateDebtInterest, calculateDependencyHealth, calculateDocDrift, calculateExtendedFutureProofScore, calculateFutureProofScore, calculateImportSimilarity, calculateKnowledgeConcentration, calculateMonthlyCost, calculatePatternEntropy, calculateProductivityImpact, calculateSemanticDistance, calculateTechnicalValueChain, calculateTestabilityIndex, calculateTokenBudget, clearHistory, createProvider, emitAnnotation, emitIssuesAsAnnotations, emitProgress, estimateCostFromBudget, estimateTokens, exportHistory, findLatestReport, findLatestScanReport, formatAcceptanceRate, formatCost, formatHours, generateValueChain, getElapsedTime, getFileCommitTimestamps, getFileExtension, getHistorySummary, getLineRangeLastModifiedCached, getModelPreset, getParser, getRepoMetadata, getSafetyIcon, getScoreBar, getSeverityBadge, getSeverityColor, getSeverityEnum, getSeverityLevel, getSeverityValue, getSupportedLanguages, getWasmPath, groupIssuesByFile, handleCLIError, handleJSONOutput, initTreeSitter, initializeParsers, isFileSupported, isSourceFile, loadConfig, loadMergedConfig, loadScoreHistory, mergeConfigWithDefaults, parseFileExports, predictAcceptanceRate, readFileContent, resolveOutputPath, saveScoreEntry, scanEntries, scanFiles, setupParser, severityToAnnotationLevel, validateSpokeOutput, validateWithSchema };
+export { AIReadyConfig, AcceptancePrediction, type AgentGroundingScore, type AiSignalClarity, type AiSignalClaritySignal, AnalysisResult, type CLIOptions, CSharpParser, type ChangeAmplificationScore, type CognitiveLoad, ComprehensionDifficulty, type ConceptCohesion, CostConfig, DEFAULT_COST_CONFIG, DEFAULT_EXCLUDE, type DependencyHealthScore, type DocDriftRisk, ExportInfo, ExportWithImports, FileImport, type FileWithDomain, GoParser, Issue, JavaParser, type KnowledgeConcentrationRisk, Language, LanguageParser, type LoadFactor, MODEL_PRICING_PRESETS, Metrics, ModelContextTier, type ModelPricingPreset, NamingConvention, ParseResult, ParserFactory, type PatternEntropy, ProductivityImpact, type ProviderFactoryConfig, PythonParser, SEVERITY_TIME_ESTIMATES, ScanOptions, type ScoreHistoryEntry, type ScoreTrend, type SemanticDistance, Severity, Severity as SeverityType, SpokeOutput, type TechnicalDebtInterest, TechnicalValueChain, TechnicalValueChainSummary, type TestabilityIndex, TokenBudget, ToolName, ToolOptions, type ToolProvider, ToolRegistry, ToolScoringOutput, TypeScriptParser, VAGUE_FILE_NAMES, buildSimpleProviderScore, buildSpokeOutput, calculateAgentGrounding, calculateAiSignalClarity, calculateBusinessROI, calculateChangeAmplification, calculateCognitiveLoad, calculateComprehensionDifficulty, calculateConceptCohesion, calculateDebtInterest, calculateDependencyHealth, calculateDocDrift, calculateExtendedFutureProofScore, calculateFutureProofScore, calculateImportSimilarity, calculateKnowledgeConcentration, calculateMonthlyCost, calculatePatternEntropy, calculateProductivityImpact, calculateSemanticDistance, calculateTechnicalValueChain, calculateTestabilityIndex, calculateTokenBudget, clearHistory, createProvider, emitAnnotation, emitIssuesAsAnnotations, emitProgress, estimateCostFromBudget, estimateTokens, exportHistory, findLatestReport, findLatestScanReport, formatAcceptanceRate, formatCost, formatHours, generateValueChain, getElapsedTime, getFileCommitTimestamps, getFileExtension, getHistorySummary, getLineRangeLastModifiedCached, getModelPreset, getParser, getRepoMetadata, getSafetyIcon, getScoreBar, getSeverityBadge, getSeverityColor, getSeverityEnum, getSeverityLevel, getSeverityValue, getSupportedLanguages, getWasmPath, groupIssuesByFile, handleCLIError, handleJSONOutput, initTreeSitter, initializeParsers, isFileSupported, isSourceFile, loadConfig, loadMergedConfig, loadScoreHistory, mergeConfigWithDefaults, normalizeAnalysisResult, normalizeIssue, normalizeMetrics, normalizeSpokeOutput, parseFileExports, predictAcceptanceRate, readFileContent, resolveOutputPath, saveScoreEntry, scanEntries, scanFiles, setupParser, severityToAnnotationLevel, validateSpokeOutput, validateWithSchema };

package/dist/index.d.ts

@@ -1,8 +1,7 @@
-import { T as ToolName, S as ScanOptions, a as SpokeOutput, b as ToolScoringOutput, c as ToolOptions, d as Severity, A as AnalysisResult, E as ExportWithImports, F as FileImport, e as AIReadyConfig, M as ModelContextTier, C as CostConfig, f as TokenBudget, P as ProductivityImpact, g as AcceptancePrediction, h as ComprehensionDifficulty, i as TechnicalValueChainSummary, j as TechnicalValueChain, L as LanguageParser, k as Language, l as ExportInfo, m as ParseResult, N as NamingConvention, I as ImportInfo } from './client-C5BuGX4F.js';
-export { n as ASTNode, o as AnalysisResultSchema, p as AnalysisStatus, q as AnalysisStatusSchema, B as BusinessMetrics, r as COMMON_FINE_TUNING_OPTIONS, s as CONTEXT_TIER_THRESHOLDS, t as CommonASTNode, u as Config, D as DEFAULT_TOOL_WEIGHTS, v as FRIENDLY_TOOL_NAMES, w as FileContent, G as GLOBAL_INFRA_OPTIONS, x as GLOBAL_SCAN_OPTIONS, y as GraphData, z as GraphEdge, H as GraphIssueSeverity, J as GraphMetadata, K as GraphNode, O as Issue, Q as IssueSchema, R as IssueType, U as IssueTypeSchema, V as LANGUAGE_EXTENSIONS, W as LanguageConfig, X as Lead, Y as LeadSchema, Z as LeadSource, _ as LeadSourceSchema, $ as LeadSubmission, a0 as LeadSubmissionSchema, a1 as Location, a2 as LocationSchema, a3 as ManagedAccount, a4 as ManagedAccountSchema, a5 as Metrics, a6 as MetricsSchema, a7 as ModelTier, a8 as ModelTierSchema, a9 as ParseError, aa as ParseStatistics, ab as ReadinessRating, ac as RecommendationPriority, ad as SCORING_PROFILES, ae as SIZE_ADJUSTED_THRESHOLDS, af as ScanResult, ag as ScoringConfig, ah as ScoringProfile, ai as ScoringResult, aj as SeveritySchema, ak as SourceLocation, al as SourceRange, am as SpokeOutputSchema, an as SpokeSummary, ao as SpokeSummarySchema, ap as TOOL_NAME_MAP, aq as ToolNameSchema, ar as ToolOutput, as as UnifiedReport, at as UnifiedReportSchema, au as calculateOverallScore, av as formatScore, aw as formatToolScore, ax as generateHTML, ay as getProjectSizeTier, az as getRating, aA as getRatingDisplay, aB as getRatingSlug, aC as getRatingWithContext, aD as getRecommendedThreshold, aE as getToolWeight, aF as normalizeToolName, aG as parseWeightString } from './client-C5BuGX4F.js';
+import { T as ToolName, S as ScanOptions, a as SpokeOutput, b as ToolScoringOutput, c as ToolOptions, d as Severity, A as AnalysisResult, E as ExportWithImports, F as FileImport, e as AIReadyConfig, I as Issue, M as Metrics, f as ModelContextTier, C as CostConfig, g as TokenBudget, P as ProductivityImpact, h as AcceptancePrediction, i as ComprehensionDifficulty, j as TechnicalValueChainSummary, k as TechnicalValueChain, L as LanguageParser, l as Language, m as ParseResult, N as NamingConvention, n as ExportInfo } from './client-wk2fgk1q.js';
+export { o as AIReadyConfigSchema, p as ASTNode, q as AnalysisResultSchema, r as AnalysisStatus, s as AnalysisStatusSchema, B as BusinessMetrics, t as COMMON_FINE_TUNING_OPTIONS, u as CONTEXT_TIER_THRESHOLDS, v as CommonASTNode, w as Config, D as DEFAULT_TOOL_WEIGHTS, x as FRIENDLY_TOOL_NAMES, y as FileContent, G as GLOBAL_INFRA_OPTIONS, z as GLOBAL_SCAN_OPTIONS, H as GraphData, J as GraphEdge, K as GraphIssueSeverity, O as GraphMetadata, Q as GraphNode, R as IssueSchema, U as IssueType, V as IssueTypeSchema, W as LANGUAGE_EXTENSIONS, X as LanguageConfig, Y as Lead, Z as LeadSchema, _ as LeadSource, $ as LeadSourceSchema, a0 as LeadSubmission, a1 as LeadSubmissionSchema, a2 as Location, a3 as LocationSchema, a4 as ManagedAccount, a5 as ManagedAccountSchema, a6 as MetricsSchema, a7 as ModelTier, a8 as ModelTierSchema, a9 as ParseError, aa as ParseStatistics, ab as ReadinessRating, ac as RecommendationPriority, ad as SCORING_PROFILES, ae as SIZE_ADJUSTED_THRESHOLDS, af as ScanResult, ag as ScoringConfig, ah as ScoringProfile, ai as ScoringResult, aj as SeveritySchema, ak as SourceLocation, al as SourceRange, am as SpokeOutputSchema, an as SpokeSummary, ao as SpokeSummarySchema, ap as TOOL_NAME_MAP, aq as ToolNameSchema, ar as ToolOutput, as as UnifiedReport, at as UnifiedReportSchema, au as calculateOverallScore, av as formatScore, aw as formatToolScore, ax as generateHTML, ay as getProjectSizeTier, az as getRating, aA as getRatingDisplay, aB as getRatingSlug, aC as getRatingWithContext, aD as getRecommendedThreshold, aE as getToolWeight, aF as normalizeToolName, aG as parseWeightString } from './client-wk2fgk1q.js';
 import { z } from 'zod';
 import * as Parser from 'web-tree-sitter';
-import { TSESTree } from '@typescript-eslint/typescript-estree';
 
 /**
  * Spoke-to-Hub Contract Definitions
@@ -429,6 +428,23 @@ declare function loadConfig(rootDir: string): Promise<AIReadyConfig | null>;
  */
 declare function mergeConfigWithDefaults(userConfig: AIReadyConfig | null, defaults: any): any;
 
+/**
+ * Normalizes raw issue data into a strict Issue object.
+ */
+declare function normalizeIssue(raw: any): Issue;
+/**
+ * Normalizes raw metrics into a strict Metrics object.
+ */
+declare function normalizeMetrics(raw: any): Metrics;
+/**
+ * Normalizes raw analysis result from any spoke into a strict AnalysisResult object.
+ */
+declare function normalizeAnalysisResult(raw: any): AnalysisResult;
+/**
+ * Normalizes a full SpokeOutput.
+ */
+declare function normalizeSpokeOutput(raw: any, toolName: string): SpokeOutput;
+
 /**
  * AI model pricing presets for cost estimation.
  * Prices are input token costs per 1K tokens (USD), as of Q1 2026.
@@ -753,15 +769,21 @@ declare function isFileSupported(filePath: string): boolean;
 declare function getSupportedLanguages(): Language[];
 
 /**
- * Initialize tree-sitter once
+ * Initialize tree-sitter once.
+ *
+ * @lastUpdated 2026-03-18
  */
 declare function initTreeSitter(): Promise<void>;
 /**
- * Find a WASM file for a specific language
+ * Find a WASM file for a specific language.
+ *
+ * @lastUpdated 2026-03-18
  */
 declare function getWasmPath(language: string): string | null;
 /**
- * Load a language and return a configured parser
+ * Load a language and return a configured parser.
+ *
+ * @lastUpdated 2026-03-18
  */
 declare function setupParser(language: string): Promise<Parser.Parser | null>;
 
@@ -775,14 +797,16 @@ declare class TypeScriptParser implements LanguageParser {
     readonly language = Language.TypeScript;
     readonly extensions: string[];
     initialize(): Promise<void>;
-    getAST(code: string, filePath: string): Promise<TSESTree.Program>;
-    analyzeMetadata(node: TSESTree.Node, code: string): Partial<ExportInfo>;
+    canHandle(filePath: string): boolean;
+    getAST(code: string, filePath: string): Promise<any>;
     parse(code: string, filePath: string): ParseResult;
     getNamingConventions(): NamingConvention;
-    canHandle(filePath: string): boolean;
+    analyzeMetadata(node: any, code: string): Partial<ExportInfo>;
     private extractImports;
     private extractExports;
-    private extractFromDeclaration;
+    private createExport;
+    private extractDocumentation;
+    private isLikelyPure;
 }
 
 /**
@@ -804,7 +828,7 @@ declare abstract class BaseLanguageParser implements LanguageParser {
     getAST(code: string, _filePath?: string): Promise<Parser.Tree | null>;
     abstract analyzeMetadata(node: Parser.Node, code: string): Partial<ExportInfo>;
     parse(code: string, filePath: string): ParseResult;
-    protected abstract extractImportsAST(rootNode: Parser.Node): ImportInfo[];
+    protected abstract extractImportsAST(rootNode: Parser.Node): FileImport[];
     protected abstract extractExportsAST(rootNode: Parser.Node, code: string): ExportInfo[];
     protected abstract parseRegex(code: string, filePath: string): ParseResult;
     abstract getNamingConventions(): NamingConvention;
@@ -833,9 +857,9 @@ declare class PythonParser extends BaseLanguageParser {
      * Extract import information using AST walk.
      *
      * @param rootNode - Root node of the Python AST.
-     * @returns Array of discovered ImportInfo objects.
+     * @returns Array of discovered FileImport objects.
      */
-    protected extractImportsAST(rootNode: Parser.Node): ImportInfo[];
+    protected extractImportsAST(rootNode: Parser.Node): FileImport[];
     /**
      * Extract export information using AST walk.
      *
@@ -888,9 +912,9 @@ declare class JavaParser extends BaseLanguageParser {
      * Extract import information using AST walk.
      *
      * @param rootNode - Root node of the Java AST.
-     * @returns Array of discovered ImportInfo objects.
+     * @returns Array of discovered FileImport objects.
      */
-    protected extractImportsAST(rootNode: Parser.Node): ImportInfo[];
+    protected extractImportsAST(rootNode: Parser.Node): FileImport[];
     /**
      * Extract export information (classes, interfaces, methods) using AST walk.
      *
@@ -949,9 +973,9 @@ declare class CSharpParser extends BaseLanguageParser {
      * Extract import information (usings) using AST walk.
      *
      * @param rootNode - Root node of the C# AST.
-     * @returns Array of discovered ImportInfo objects.
+     * @returns Array of discovered FileImport objects.
      */
-    protected extractImportsAST(rootNode: Parser.Node): ImportInfo[];
+    protected extractImportsAST(rootNode: Parser.Node): FileImport[];
     /**
      * Extract export information (classes, methods, properties) using AST walk.
      * Handles nested namespaces and classes.
@@ -996,9 +1020,9 @@ declare class GoParser extends BaseLanguageParser {
      * Extract import information using AST walk.
      *
      * @param rootNode - Root node of the Go AST.
-     * @returns Array of discovered ImportInfo objects.
+     * @returns Array of discovered FileImport objects.
      */
-    protected extractImportsAST(rootNode: Parser.Node): ImportInfo[];
+    protected extractImportsAST(rootNode: Parser.Node): FileImport[];
     /**
      * Extract export information (functions, types, vars) using AST walk.
      *
@@ -1614,4 +1638,4 @@ declare function severityToAnnotationLevel(severity: string): 'error' | 'warning
  */
 declare function emitIssuesAsAnnotations(issues: any[]): void;
 
-export { AIReadyConfig, AcceptancePrediction, type AgentGroundingScore, type AiSignalClarity, type AiSignalClaritySignal, AnalysisResult, type CLIOptions, CSharpParser, type ChangeAmplificationScore, type CognitiveLoad, ComprehensionDifficulty, type ConceptCohesion, CostConfig, DEFAULT_COST_CONFIG, DEFAULT_EXCLUDE, type DependencyHealthScore, type DocDriftRisk, ExportInfo, ExportWithImports, FileImport, type FileWithDomain, GoParser, ImportInfo, JavaParser, type KnowledgeConcentrationRisk, Language, LanguageParser, type LoadFactor, MODEL_PRICING_PRESETS, ModelContextTier, type ModelPricingPreset, NamingConvention, ParseResult, ParserFactory, type PatternEntropy, ProductivityImpact, type ProviderFactoryConfig, PythonParser, SEVERITY_TIME_ESTIMATES, ScanOptions, type ScoreHistoryEntry, type ScoreTrend, type SemanticDistance, Severity, Severity as SeverityType, SpokeOutput, type TechnicalDebtInterest, TechnicalValueChain, TechnicalValueChainSummary, type TestabilityIndex, TokenBudget, ToolName, ToolOptions, type ToolProvider, ToolRegistry, ToolScoringOutput, TypeScriptParser, VAGUE_FILE_NAMES, buildSimpleProviderScore, buildSpokeOutput, calculateAgentGrounding, calculateAiSignalClarity, calculateBusinessROI, calculateChangeAmplification, calculateCognitiveLoad, calculateComprehensionDifficulty, calculateConceptCohesion, calculateDebtInterest, calculateDependencyHealth, calculateDocDrift, calculateExtendedFutureProofScore, calculateFutureProofScore, calculateImportSimilarity, calculateKnowledgeConcentration, calculateMonthlyCost, calculatePatternEntropy, calculateProductivityImpact, calculateSemanticDistance, calculateTechnicalValueChain, calculateTestabilityIndex, calculateTokenBudget, clearHistory, createProvider, emitAnnotation, emitIssuesAsAnnotations, emitProgress, estimateCostFromBudget, estimateTokens, exportHistory, findLatestReport, findLatestScanReport, formatAcceptanceRate, formatCost, formatHours, generateValueChain, getElapsedTime, getFileCommitTimestamps, getFileExtension, getHistorySummary, getLineRangeLastModifiedCached, getModelPreset, getParser, getRepoMetadata, getSafetyIcon, getScoreBar, getSeverityBadge, getSeverityColor, getSeverityEnum, getSeverityLevel, getSeverityValue, getSupportedLanguages, getWasmPath, groupIssuesByFile, handleCLIError, handleJSONOutput, initTreeSitter, initializeParsers, isFileSupported, isSourceFile, loadConfig, loadMergedConfig, loadScoreHistory, mergeConfigWithDefaults, parseFileExports, predictAcceptanceRate, readFileContent, resolveOutputPath, saveScoreEntry, scanEntries, scanFiles, setupParser, severityToAnnotationLevel, validateSpokeOutput, validateWithSchema };
+export { AIReadyConfig, AcceptancePrediction, type AgentGroundingScore, type AiSignalClarity, type AiSignalClaritySignal, AnalysisResult, type CLIOptions, CSharpParser, type ChangeAmplificationScore, type CognitiveLoad, ComprehensionDifficulty, type ConceptCohesion, CostConfig, DEFAULT_COST_CONFIG, DEFAULT_EXCLUDE, type DependencyHealthScore, type DocDriftRisk, ExportInfo, ExportWithImports, FileImport, type FileWithDomain, GoParser, Issue, JavaParser, type KnowledgeConcentrationRisk, Language, LanguageParser, type LoadFactor, MODEL_PRICING_PRESETS, Metrics, ModelContextTier, type ModelPricingPreset, NamingConvention, ParseResult, ParserFactory, type PatternEntropy, ProductivityImpact, type ProviderFactoryConfig, PythonParser, SEVERITY_TIME_ESTIMATES, ScanOptions, type ScoreHistoryEntry, type ScoreTrend, type SemanticDistance, Severity, Severity as SeverityType, SpokeOutput, type TechnicalDebtInterest, TechnicalValueChain, TechnicalValueChainSummary, type TestabilityIndex, TokenBudget, ToolName, ToolOptions, type ToolProvider, ToolRegistry, ToolScoringOutput, TypeScriptParser, VAGUE_FILE_NAMES, buildSimpleProviderScore, buildSpokeOutput, calculateAgentGrounding, calculateAiSignalClarity, calculateBusinessROI, calculateChangeAmplification, calculateCognitiveLoad, calculateComprehensionDifficulty, calculateConceptCohesion, calculateDebtInterest, calculateDependencyHealth, calculateDocDrift, calculateExtendedFutureProofScore, calculateFutureProofScore, calculateImportSimilarity, calculateKnowledgeConcentration, calculateMonthlyCost, calculatePatternEntropy, calculateProductivityImpact, calculateSemanticDistance, calculateTechnicalValueChain, calculateTestabilityIndex, calculateTokenBudget, clearHistory, createProvider, emitAnnotation, emitIssuesAsAnnotations, emitProgress, estimateCostFromBudget, estimateTokens, exportHistory, findLatestReport, findLatestScanReport, formatAcceptanceRate, formatCost, formatHours, generateValueChain, getElapsedTime, getFileCommitTimestamps, getFileExtension, getHistorySummary, getLineRangeLastModifiedCached, getModelPreset, getParser, getRepoMetadata, getSafetyIcon, getScoreBar, getSeverityBadge, getSeverityColor, getSeverityEnum, getSeverityLevel, getSeverityValue, getSupportedLanguages, getWasmPath, groupIssuesByFile, handleCLIError, handleJSONOutput, initTreeSitter, initializeParsers, isFileSupported, isSourceFile, loadConfig, loadMergedConfig, loadScoreHistory, mergeConfigWithDefaults, normalizeAnalysisResult, normalizeIssue, normalizeMetrics, normalizeSpokeOutput, parseFileExports, predictAcceptanceRate, readFileContent, resolveOutputPath, saveScoreEntry, scanEntries, scanFiles, setupParser, severityToAnnotationLevel, validateSpokeOutput, validateWithSchema };