@aiready/core 0.23.6 → 0.23.8

package/dist/index.d.mts

@@ -1,8 +1,7 @@
-import { T as ToolName, S as ScanOptions, a as SpokeOutput, b as ToolScoringOutput, c as Severity, A as AnalysisResult, E as ExportWithImports, d as ASTNode, 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-CKcjnPXt.mjs';
-export { n as AnalysisResultSchema, o as AnalysisStatus, p as AnalysisStatusSchema, B as BusinessMetrics, q as COMMON_FINE_TUNING_OPTIONS, r as CONTEXT_TIER_THRESHOLDS, s as CommonASTNode, t as Config, D as DEFAULT_TOOL_WEIGHTS, u as FRIENDLY_TOOL_NAMES, v as FileContent, G as GLOBAL_INFRA_OPTIONS, w as GLOBAL_SCAN_OPTIONS, x as GraphData, y as GraphEdge, z as GraphIssueSeverity, H as GraphMetadata, J as GraphNode, K as Issue, O as IssueSchema, Q as IssueType, R as IssueTypeSchema, U as LANGUAGE_EXTENSIONS, V as LanguageConfig, W as Lead, X as LeadSchema, Y as LeadSource, Z as LeadSourceSchema, _ as LeadSubmission, $ as LeadSubmissionSchema, a0 as Location, a1 as LocationSchema, a2 as ManagedAccount, a3 as ManagedAccountSchema, a4 as Metrics, a5 as MetricsSchema, a6 as ModelTier, a7 as ModelTierSchema, a8 as ParseError, a9 as ParseStatistics, aa as ReadinessRating, ab as RecommendationPriority, ac as SCORING_PROFILES, ad as SIZE_ADJUSTED_THRESHOLDS, ae as ScanResult, af as ScoringConfig, ag as ScoringProfile, ah as ScoringResult, ai as SeveritySchema, aj as SourceLocation, ak as SourceRange, al as SpokeOutputSchema, am as SpokeSummary, an as SpokeSummarySchema, ao as TOOL_NAME_MAP, ap as ToolNameSchema, aq as ToolOptions, 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-CKcjnPXt.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
@@ -29,13 +28,22 @@ interface ToolProvider {
 /**
  * Validation utility to ensure a spoke's output matches the expected contract.
  * Used in spoke tests to catch breakages early.
+ *
+ * @param toolName - Name of the tool being validated.
+ * @param output - The raw output data to check.
+ * @returns Validation result with boolean flag and any errors found.
  */
 declare function validateSpokeOutput(toolName: string, output: any): {
     valid: boolean;
     errors: string[];
 };
 /**
- * Zod-based validation (Round 1 improvement)
+ * Zod-based validation (Round 1 improvement).
+ *
+ * @param schema - Zod schema to validate against.
+ * @param data - Raw data to parse.
+ * @returns Result object with valid flag and typed data or errors.
+ * @lastUpdated 2026-03-18
  */
 declare function validateWithSchema<T>(schema: z.ZodSchema<T>, data: any): {
     valid: boolean;
@@ -136,18 +144,19 @@ declare const DEFAULT_EXCLUDE: string[];
  */
 declare const VAGUE_FILE_NAMES: Set<string>;
 /**
- * Scan files in a directory using glob patterns
- *
- * Note: This scanner supports multiple languages (.ts, .tsx, .js, .jsx, .py, .java, etc.)
- * Individual tools can filter to their supported languages if needed.
+ * Scan files in a directory using glob patterns, respecting .aireadyignore and defaults.
  *
- * @param options - Scan configuration
- * @returns Array of absolute file paths matching the patterns
+ * @param options - Scan configuration including rootDir, include/exclude, and includeTests.
+ * @returns Array of absolute file paths matching the patterns.
  */
 declare function scanFiles(options: ScanOptions): Promise<string[]>;
 /**
- * Scan for both files and directories, respecting ignore rules.
+ * Scan for both files and directories, respecting ignore rules and .gitignore.
  * Useful for tools that need to analyze directory structure.
+ *
+ * @param options - Scan configuration.
+ * @returns Object containing arrays of files and directories.
+ * @lastUpdated 2026-03-18
  */
 declare function scanEntries(options: ScanOptions): Promise<{
     files: string[];
@@ -191,32 +200,28 @@ declare function isSourceFile(filePath: string): boolean;
 
 /**
  * Common CLI configuration interface
+ * @deprecated Use ToolOptions from @aiready/core instead
  */
-interface CLIOptions {
-    /** Root directory for analysis */
-    rootDir: string;
-    /** Glob patterns to include */
-    include?: string[];
-    /** Glob patterns to exclude */
-    exclude?: string[];
-    /** Any other tool-specific options */
-    [key: string]: any;
-}
+type CLIOptions = ToolOptions;
 /**
- * Resolve output file path, defaulting to .aiready directory
+ * Resolve output file path, defaulting to .aiready directory.
  * Creates parent directories if they don't exist.
- * @param userPath - User-provided output path (optional)
- * @param defaultFilename - Default filename to use
- * @param workingDir - Working directory (default: process.cwd())
- * @returns Resolved absolute path
+ *
+ * @param userPath - User-provided output path (optional).
+ * @param defaultFilename - Default filename to use.
+ * @param workingDir - Working directory (default: process.cwd()).
+ * @returns Resolved absolute path.
+ * @lastUpdated 2026-03-18
  */
 declare function resolveOutputPath(userPath: string | undefined, defaultFilename: string, workingDir?: string): string;
 /**
- * Load and merge configuration with CLI options
- * @param directory Root directory to load config from
- * @param defaults Default configuration values
- * @param cliOptions Configuration overrides from CLI arguments
- * @returns Merged configuration object
+ * Load and merge configuration with CLI options.
+ *
+ * @param directory - Root directory to load config from.
+ * @param defaults - Default configuration values.
+ * @param cliOptions - Configuration overrides from CLI arguments.
+ * @returns Merged configuration object.
+ * @lastUpdated 2026-03-18
  */
 declare function loadMergedConfig<T extends Record<string, any>>(directory: string, defaults: T, cliOptions: Partial<T>): Promise<T & {
     rootDir: string;
@@ -224,34 +229,45 @@ declare function loadMergedConfig<T extends Record<string, any>>(directory: stri
 /**
  * Handle JSON output for CLI commands.
  * Writes to file if outputFile is provided, otherwise logs to console.
- * @param data Data to output
- * @param outputFile Optional path to save JSON file
- * @param successMessage Optional message to show on success
+ *
+ * @param data - Data to output.
+ * @param outputFile - Optional path to save JSON file.
+ * @param successMessage - Optional message to show on success.
+ * @lastUpdated 2026-03-18
  */
 declare function handleJSONOutput(data: any, outputFile?: string, successMessage?: string): void;
 /**
  * Common error handler for CLI commands.
  * Logs error and exits process with code 1.
- * @param error Error object or message
- * @param commandName Name of the command that failed
+ *
+ * @param error - Error object or message.
+ * @param commandName - Name of the command that failed.
+ * @returns Never returns as it exits the process.
+ * @lastUpdated 2026-03-18
  */
 declare function handleCLIError(error: unknown, commandName: string): never;
 /**
  * Calculate elapsed time and format for display
- * @param startTime timestamp in milliseconds
- * @returns Formatted seconds (e.g. "1.23")
+ *
+ * @param startTime - Start timestamp in milliseconds.
+ * @returns Formatted duration string in seconds.
+ * @lastUpdated 2026-03-18
  */
 declare function getElapsedTime(startTime: number): string;
 /**
  * Generate a visual score bar for console output
- * @param val Score value (0-100)
- * @returns String representation of the bar (e.g. "█████░░░░░")
+ *
+ * @param val - Score value between 0 and 100.
+ * @returns String representation of the bar (e.g., "█████░░░░░").
+ * @lastUpdated 2026-03-18
  */
 declare function getScoreBar(val: number): string;
 /**
  * Get status icon for safety ratings
- * @param rating Safety rating slug
- * @returns Emoji icon representating the rating
+ *
+ * @param rating - The safety rating slug.
+ * @returns Emoji icon representing the rating.
+ * @lastUpdated 2026-03-18
  */
 declare function getSafetyIcon(rating: string): string;
 /**
@@ -266,9 +282,11 @@ declare function getSafetyIcon(rating: string): string;
 declare function emitProgress(processed: number, total: number, toolId: string, message: string, onProgress?: (processed: number, total: number, message: string) => void, throttleCount?: number): void;
 /**
  * Get chalk color function for a given severity
- * @param severity Severity level string
- * @param chalkInstance Chalk instance to use
- * @returns Chalk color function
+ *
+ * @param severity - Severity level string.
+ * @param chalkInstance - Optional chalk instance to use.
+ * @returns Chalk color function.
+ * @lastUpdated 2026-03-18
  */
 declare function getSeverityColor(severity: string, chalkInstance?: any): any;
 /**
@@ -299,15 +317,19 @@ declare function getSeverityEnum(s: string | undefined): any;
 /**
  * Find the latest aiready report in a directory by modification time.
  * Searches for both new format (aiready-report-*) and legacy format (aiready-scan-*).
- * @param dirPath - The directory path to search for .aiready directory
- * @returns The path to the latest report or null if not found
+ *
+ * @param dirPath - The directory path to search for .aiready directory.
+ * @returns The path to the latest report or null if not found.
+ * @lastUpdated 2026-03-18
  */
 declare function findLatestReport(dirPath: string): string | null;
 /**
  * Find the latest scan report file with a specific prefix.
- * @param scanReportsDir Directory containing reports
- * @param reportFilePrefix Filename prefix to match (e.g. "report-")
- * @returns Path to the latest matching report or null
+ *
+ * @param scanReportsDir - Directory containing reports.
+ * @param reportFilePrefix - Filename prefix to match (e.g. "report-").
+ * @returns Path to the latest matching report or null.
+ * @lastUpdated 2026-03-18
  */
 declare function findLatestScanReport(scanReportsDir: string, reportFilePrefix: string): string | null;
 
@@ -320,14 +342,26 @@ declare function findLatestScanReport(scanReportsDir: string, reportFilePrefix:
  */
 declare function groupIssuesByFile(issues: any[]): AnalysisResult[];
 /**
- * Builds a simple `ToolScoringOutput` from a spoke summary object.
+ * Builds a simple ToolScoringOutput from a spoke summary object.
  * Shared across providers whose scoring logic is purely pass-through
  * (score and recommendations are already computed in the analyzer).
+ *
+ * @param toolName - Identifier for the tool.
+ * @param summary - The tool's summary object containing score and recs.
+ * @param rawData - Additional raw metrics to include.
+ * @returns Standardized scoring output.
  */
 declare function buildSimpleProviderScore(toolName: string, summary: any, rawData?: any): ToolScoringOutput;
 /**
- * Builds and validates a `SpokeOutput` with common provider metadata.
+ * Builds and validates a SpokeOutput with common provider metadata.
  * This removes repeated schema/metadata boilerplate from spoke providers.
+ *
+ * @param toolName - Identifier for the tool.
+ * @param version - Current version of the spoke.
+ * @param summary - Consolidated summary metrics.
+ * @param results - Array of file-level analysis results.
+ * @param metadata - Optional additional metadata.
+ * @returns Validated spoke output object.
  */
 declare function buildSpokeOutput(toolName: string, version: string, summary: any, results: AnalysisResult[], metadata?: Record<string, unknown>): SpokeOutput;
 interface ProviderFactoryConfig<TReport> {
@@ -344,21 +378,13 @@ interface ProviderFactoryConfig<TReport> {
 /**
  * Creates a tool provider from shared analyze/score plumbing.
  * Spokes only provide report adapters and scoring behavior.
+ *
+ * @param config - Provider factory configuration with analyze/score logic.
+ * @returns A complete ToolProvider implementation.
+ * @lastUpdated 2026-03-18
  */
 declare function createProvider<TReport>(config: ProviderFactoryConfig<TReport>): ToolProvider;
 
-/**
- * Parse TypeScript/JavaScript file and extract exports with their import dependencies.
- * Automatically handles different languages via the parser factory.
- *
- * @param code - The source code to parse
- * @param filePath - Path to the file (used for language detection and AST metadata)
- * @returns Object containing all identified exports and imports
- */
-declare function parseFileExports(code: string, filePath: string): {
-    exports: ExportWithImports[];
-    imports: FileImport[];
-};
 /**
  * Calculate import-based similarity between two exports using Jaccard index.
  * Returns a score between 0 and 1 representing the overlap in imported symbols.
@@ -368,31 +394,19 @@ declare function parseFileExports(code: string, filePath: string): {
  * @returns Similarity score (0 = no overlap, 1 = identical imports)
  */
 declare function calculateImportSimilarity(export1: ExportWithImports, export2: ExportWithImports): number;
+
 /**
- * Parse code into an AST node.
- * @deprecated Use parseFileExports instead for full dependency analysis.
- *
- * @param code - Source code to parse
- * @param language - Target language
- * @returns Generic AST node or null if unsupported
- */
-declare function parseCode(_code: string, _language: string): ASTNode | null;
-/**
- * Extract functions from an AST.
- * @deprecated Use parseFileExports instead for complete export metadata.
- *
- * @param ast - The AST to scan
- * @returns Array of function nodes
- */
-declare function extractFunctions(_ast: ASTNode): ASTNode[];
-/**
- * Extract imports from an AST.
- * @deprecated Use parseFileExports instead for structured import info.
+ * Parse TypeScript/JavaScript file and extract exports with their import dependencies.
+ * Automatically handles different languages via the parser factory.
  *
- * @param ast - The AST to scan
- * @returns Array of imported module names
+ * @param code - The source code to parse
+ * @param filePath - Path to the file (used for language detection and AST metadata)
+ * @returns Object containing all identified exports and imports
  */
-declare function extractImports(_ast: ASTNode): string[];
+declare function parseFileExports(code: string, filePath: string): {
+    exports: ExportWithImports[];
+    imports: FileImport[];
+};
 
 /**
  * Estimate token count for text (rough approximation)
@@ -414,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.
@@ -533,9 +564,11 @@ declare function calculateTechnicalValueChain(params: {
 declare function calculateComprehensionDifficulty(contextBudget: number, importDepth: number, fragmentation: number, modelTier?: ModelContextTier | string): ComprehensionDifficulty;
 
 /**
- * Business Value Metrics Module
+ * Business Value Metrics Module.
  *
  * Provides business-aligned metrics that quantify ROI and survive technology changes.
+ *
+ * @lastUpdated 2026-03-18
  */
 
 /**
@@ -619,8 +652,9 @@ declare function formatHours(hours: number): string;
 
 /**
  * Format AI acceptance rate as a human-readable percentage string.
- * @param rate Rate value between 0 and 1
- * @returns Formatted percentage (e.g. "85%")
+ *
+ * @param rate - Rate value between 0 and 1 (e.g. 0.85).
+ * @returns Formatted percentage string (e.g. "85%").
  */
 declare function formatAcceptanceRate(rate: number): string;
 /**
@@ -650,8 +684,9 @@ declare function generateValueChain(params: {
 
 /**
  * Factory for creating and managing language parsers.
- *
  * Supports both singleton usage and multiple instances for test isolation.
+ *
+ * @lastUpdated 2026-03-18
  */
 declare class ParserFactory {
     private static instance;
@@ -709,7 +744,11 @@ declare class ParserFactory {
     initializeAll(): Promise<void>;
 }
 /**
- * Convenience function to get parser for a file
+ * Convenience function to get parser for a file.
+ *
+ * @param filePath - Path to the file to get a parser for.
+ * @returns LanguageParser instance or null if unsupported.
+ * @lastUpdated 2026-03-18
  */
 declare function getParser(filePath: string): LanguageParser | null;
 /**
@@ -717,7 +756,11 @@ declare function getParser(filePath: string): LanguageParser | null;
  */
 declare function initializeParsers(): Promise<void>;
 /**
- * Convenience function to check if file is supported
+ * Convenience function to check if file is supported.
+ *
+ * @param filePath - Path to the file to check.
+ * @returns True if the file extension is supported.
+ * @lastUpdated 2026-03-18
  */
 declare function isFileSupported(filePath: string): boolean;
 /**
@@ -726,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>;
 
@@ -748,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;
 }
 
 /**
@@ -777,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;
@@ -785,16 +836,52 @@ declare abstract class BaseLanguageParser implements LanguageParser {
 }
 
 /**
- * Python Parser implementation using tree-sitter
+ * Python Parser implementation using tree-sitter.
+ * Handles AST-based and Regex-based extraction of imports and exports.
+ *
+ * @lastUpdated 2026-03-18
  */
 declare class PythonParser extends BaseLanguageParser {
     readonly language = Language.Python;
     readonly extensions: string[];
     protected getParserName(): string;
+    /**
+     * Analyze metadata for a Python node (purity, side effects).
+     *
+     * @param node - Tree-sitter node to analyze.
+     * @param code - Source code for context.
+     * @returns Partial ExportInfo containing discovered metadata.
+     */
     analyzeMetadata(node: Parser.Node, code: string): Partial<ExportInfo>;
-    protected extractImportsAST(rootNode: Parser.Node): ImportInfo[];
+    /**
+     * Extract import information using AST walk.
+     *
+     * @param rootNode - Root node of the Python AST.
+     * @returns Array of discovered FileImport objects.
+     */
+    protected extractImportsAST(rootNode: Parser.Node): FileImport[];
+    /**
+     * Extract export information using AST walk.
+     *
+     * @param rootNode - Root node of the Python AST.
+     * @param code - Source code for documentation extraction.
+     * @returns Array of discovered ExportInfo objects.
+     */
     protected extractExportsAST(rootNode: Parser.Node, code: string): ExportInfo[];
+    /**
+     * Extract parameter names from a function definition node.
+     *
+     * @param node - Function definition node.
+     * @returns Array of parameter name strings.
+     */
     private extractParameters;
+    /**
+     * Fallback regex-based parsing when tree-sitter is unavailable.
+     *
+     * @param code - Source code content.
+     * @param filePath - Path to the file being parsed.
+     * @returns Consolidated ParseResult.
+     */
     protected parseRegex(code: string, filePath: string): ParseResult;
     getNamingConventions(): NamingConvention;
     canHandle(filePath: string): boolean;
@@ -803,17 +890,54 @@ declare class PythonParser extends BaseLanguageParser {
 }
 
 /**
- * Java Parser implementation using tree-sitter
+ * Java Parser implementation using tree-sitter.
+ * Supports AST-based and Regex-based extraction of class and method metadata.
+ *
+ * @lastUpdated 2026-03-18
  */
 declare class JavaParser extends BaseLanguageParser {
     readonly language = Language.Java;
     readonly extensions: string[];
     protected getParserName(): string;
+    /**
+     * Analyze metadata for a Java node (purity, side effects).
+     *
+     * @param node - Tree-sitter node to analyze.
+     * @param code - Source code for context.
+     * @returns Partial ExportInfo containing discovered metadata.
+     */
     analyzeMetadata(node: Parser.Node, code: string): Partial<ExportInfo>;
     protected parseRegex(code: string): ParseResult;
-    protected extractImportsAST(rootNode: Parser.Node): ImportInfo[];
+    /**
+     * Extract import information using AST walk.
+     *
+     * @param rootNode - Root node of the Java AST.
+     * @returns Array of discovered FileImport objects.
+     */
+    protected extractImportsAST(rootNode: Parser.Node): FileImport[];
+    /**
+     * Extract export information (classes, interfaces, methods) using AST walk.
+     *
+     * @param rootNode - Root node of the Java AST.
+     * @param code - Source code for documentation extraction.
+     * @returns Array of discovered ExportInfo objects.
+     */
     protected extractExportsAST(rootNode: Parser.Node, code: string): ExportInfo[];
+    /**
+     * Extract modifiers (visibility, static, etc.) from a node.
+     *
+     * @param node - AST node to extract modifiers from.
+     * @returns Array of modifier strings.
+     */
     private getModifiers;
+    /**
+     * Extract methods and nested exports from a class or interface body.
+     *
+     * @param parentNode - Class or interface declaration node.
+     * @param parentName - Name of the parent class/interface.
+     * @param exports - Array to collect discovered exports into.
+     * @param code - Source code for context.
+     */
     private extractSubExports;
     private extractParameters;
     getNamingConventions(): NamingConvention;
@@ -821,15 +945,45 @@ declare class JavaParser extends BaseLanguageParser {
 }
 
 /**
- * C# Parser implementation using tree-sitter
+ * C# Parser implementation using tree-sitter.
+ * Supports AST-based and Regex-based extraction of namespace-scoped classes and methods.
+ *
+ * @lastUpdated 2026-03-18
  */
 declare class CSharpParser extends BaseLanguageParser {
     readonly language = Language.CSharp;
     readonly extensions: string[];
     protected getParserName(): string;
+    /**
+     * Analyze metadata for a C# node (purity, side effects).
+     *
+     * @param node - Tree-sitter node to analyze.
+     * @param code - Source code for context.
+     * @returns Partial ExportInfo containing discovered metadata.
+     */
     analyzeMetadata(node: Parser.Node, code: string): Partial<ExportInfo>;
+    /**
+     * Fallback regex-based parsing when tree-sitter is unavailable.
+     *
+     * @param code - Source code content.
+     * @returns Consolidated ParseResult.
+     */
     protected parseRegex(code: string): ParseResult;
-    protected extractImportsAST(rootNode: Parser.Node): ImportInfo[];
+    /**
+     * Extract import information (usings) using AST walk.
+     *
+     * @param rootNode - Root node of the C# AST.
+     * @returns Array of discovered FileImport objects.
+     */
+    protected extractImportsAST(rootNode: Parser.Node): FileImport[];
+    /**
+     * Extract export information (classes, methods, properties) using AST walk.
+     * Handles nested namespaces and classes.
+     *
+     * @param rootNode - Root node of the C# AST.
+     * @param code - Source code for documentation extraction.
+     * @returns Array of discovered ExportInfo objects.
+     */
     protected extractExportsAST(rootNode: Parser.Node, code: string): ExportInfo[];
     private getModifiers;
     private extractParameters;
@@ -838,15 +992,44 @@ declare class CSharpParser extends BaseLanguageParser {
 }
 
 /**
- * Go Parser implementation using tree-sitter
+ * Go Parser implementation using tree-sitter.
+ * Handles AST-based and Regex-based extraction of functions and types.
+ *
+ * @lastUpdated 2026-03-18
  */
 declare class GoParser extends BaseLanguageParser {
     readonly language = Language.Go;
     readonly extensions: string[];
     protected getParserName(): string;
+    /**
+     * Analyze metadata for a Go node (purity, side effects).
+     *
+     * @param node - Tree-sitter node to analyze.
+     * @param code - Source code for context.
+     * @returns Partial ExportInfo containing discovered metadata.
+     */
     analyzeMetadata(node: Parser.Node, code: string): Partial<ExportInfo>;
+    /**
+     * Fallback regex-based parsing when tree-sitter is unavailable.
+     *
+     * @param code - Source code content.
+     * @returns Consolidated ParseResult.
+     */
     protected parseRegex(code: string): ParseResult;
-    protected extractImportsAST(rootNode: Parser.Node): ImportInfo[];
+    /**
+     * Extract import information using AST walk.
+     *
+     * @param rootNode - Root node of the Go AST.
+     * @returns Array of discovered FileImport objects.
+     */
+    protected extractImportsAST(rootNode: Parser.Node): FileImport[];
+    /**
+     * Extract export information (functions, types, vars) using AST walk.
+     *
+     * @param rootNode - Root node of the Go AST.
+     * @param code - Source code for documentation extraction.
+     * @returns Array of discovered ExportInfo objects.
+     */
     protected extractExportsAST(rootNode: Parser.Node, code: string): ExportInfo[];
     private extractParameters;
     getNamingConventions(): NamingConvention;
@@ -854,8 +1037,13 @@ declare class GoParser extends BaseLanguageParser {
 }
 
 /**
- * Cognitive Load Metrics
+ * Cognitive Load Metrics.
  * Measures how much mental effort is required for an AI to understand a file.
+ *
+ * @lastUpdated 2026-03-18
+ */
+/**
+ * Individual factor contributing to total cognitive load.
  */
 interface LoadFactor {
     name: string;
@@ -863,6 +1051,9 @@ interface LoadFactor {
     weight: number;
     description: string;
 }
+/**
+ * Consolidated Cognitive Load measurement for a source file.
+ */
 interface CognitiveLoad {
     score: number;
     rating: 'trivial' | 'easy' | 'moderate' | 'difficult' | 'expert';
@@ -874,6 +1065,17 @@ interface CognitiveLoad {
         conceptCount: number;
     };
 }
+/**
+ * Calculate the Cognitive Load for a file based on its structural properties.
+ *
+ * @param params - Metrics gathered from parsing the file.
+ * @param params.linesOfCode - Number of lines of code.
+ * @param params.exportCount - Number of public exports.
+ * @param params.importCount - Number of external dependencies.
+ * @param params.uniqueConcepts - Number of unique semantic concepts.
+ * @param params.cyclomaticComplexity - Optional complexity score.
+ * @returns Comprehensive CognitiveLoad analysis.
+ */
 declare function calculateCognitiveLoad(params: {
     linesOfCode: number;
     exportCount: number;
@@ -883,8 +1085,10 @@ declare function calculateCognitiveLoad(params: {
 }): CognitiveLoad;
 
 /**
- * Semantic Distance Metrics
- * Measures the conceptual distance between files or domains.
+ * Semantic Distance Metrics.
+ * Measures the conceptual distance between files or domains using import overlap.
+ *
+ * @lastUpdated 2026-03-18
  */
 interface SemanticDistance {
     between: [string, string];
@@ -893,6 +1097,19 @@ interface SemanticDistance {
     path: string[];
     reason: string;
 }
+/**
+ * Calculate the semantic distance between two files based on domain and dependency overlap.
+ *
+ * @param params - Comparison parameters.
+ * @param params.file1 - Path to the first file.
+ * @param params.file2 - Path to the second file.
+ * @param params.file1Domain - Logical domain of the first file.
+ * @param params.file2Domain - Logical domain of the second file.
+ * @param params.file1Imports - Set of imports in the first file.
+ * @param params.file2Imports - Set of imports in the second file.
+ * @param params.sharedDependencies - Intersection of imports between both files.
+ * @returns Calculated semantic distance and relationship assessment.
+ */
 declare function calculateSemanticDistance(params: {
     file1: string;
     file2: string;
@@ -904,8 +1121,10 @@ declare function calculateSemanticDistance(params: {
 }): SemanticDistance;
 
 /**
- * Structural Metrics
+ * Structural Metrics.
  * Measures pattern entropy and concept cohesion.
+ *
+ * @lastUpdated 2026-03-18
  */
 /**
  * Represents the entropy of patterns in a domain
@@ -932,8 +1151,13 @@ interface PatternEntropy {
 /**
  * A file path with its inferred domain
  */
+/**
+ * Represents a file path associated with its inferred domain.
+ */
 interface FileWithDomain {
+    /** Relative or absolute path to the file. */
     path: string;
+    /** Logical domain the file belongs to (e.g., "auth", "api"). */
     domain: string;
 }
 /**
@@ -943,20 +1167,21 @@ interface FileWithDomain {
  */
 declare function calculatePatternEntropy(files: FileWithDomain[]): PatternEntropy;
 /**
- * Measures how focused a set of concepts is within a domain
+ * Measures how focused a set of concepts is within a domain.
+ * Higher cohesion indicates better semantic alignment.
  */
 interface ConceptCohesion {
-    /** Normalized score (0-1) where 1 is perfect cohesion */
+    /** Normalized score (0-1) where 1 is perfect cohesion. */
     score: number;
-    /** Human-readable rating */
+    /** Human-readable rating. */
     rating: 'excellent' | 'good' | 'moderate' | 'poor';
-    /** Detailed cohesion metrics */
+    /** Detailed cohesion metrics. */
     analysis: {
-        /** Number of distinct domains involved */
+        /** Number of distinct domains involved. */
         uniqueDomains: number;
-        /** Percentage of exports belonging to the dominant domain */
+        /** Percentage of exports belonging to the dominant domain. */
         domainConcentration: number;
-        /** Ratio of unique domains to total exports */
+        /** Ratio of unique domains to total exports. */
         exportPurposeClarity: number;
     };
 }
@@ -974,8 +1199,10 @@ declare function calculateConceptCohesion(params: {
 }): ConceptCohesion;
 
 /**
- * AI Signal Clarity Metrics
+ * AI Signal Clarity Metrics.
  * Measures code patterns that increase the likelihood of AI generating incorrect code.
+ *
+ * @lastUpdated 2026-03-18
  */
 /**
  * Represents a single risk signal affecting AI clarity
@@ -1008,9 +1235,20 @@ interface AiSignalClarity {
     recommendations: string[];
 }
 /**
- * Calculate AI Signal Clarity metrics based on various code patterns
- * @param params Object containing counts of various problematic patterns
- * @returns Clarity analysis result
+ * Calculate AI Signal Clarity metrics based on various documented and undocumented code patterns.
+ *
+ * @param params - Counts of various problematic or beneficial patterns detected during scanning.
+ * @param params.overloadedSymbols - Count of symbols with identical names in different scopes.
+ * @param params.magicLiterals - Count of unnamed constant values.
+ * @param params.booleanTraps - Count of functions with multiple boolean parameters.
+ * @param params.implicitSideEffects - Count of functions with undocumented side effects.
+ * @param params.deepCallbacks - Count of nested callback structures.
+ * @param params.ambiguousNames - Count of non-descriptive identifiers (e.g., 'data', 'info').
+ * @param params.undocumentedExports - Count of public exports missing JSDoc/docstrings.
+ * @param params.largeFiles - Optional count of files exceeding size limits.
+ * @param params.totalSymbols - Total number of symbols analyzed.
+ * @param params.totalExports - Total number of public exports analyzed.
+ * @returns Comprehensive AiSignalClarity analysis.
  */
 declare function calculateAiSignalClarity(params: {
     overloadedSymbols: number;
@@ -1026,8 +1264,10 @@ declare function calculateAiSignalClarity(params: {
 }): AiSignalClarity;
 
 /**
- * Agent Grounding Metrics
- * Measures how well an AI agent can navigate a codebase independently.
+ * Agent Grounding Metrics.
+ * Measures how well an AI agent can navigate and understand a codebase independently.
+ *
+ * @lastUpdated 2026-03-18
  */
 interface AgentGroundingScore {
     score: number;
@@ -1041,6 +1281,23 @@ interface AgentGroundingScore {
     };
     recommendations: string[];
 }
+/**
+ * Calculate Agent Grounding metrics based on repository structure and documentation quality.
+ *
+ * @param params - Structural and documentation metrics gathered during scanning.
+ * @param params.deepDirectories - Count of directories nested deeper than recommended.
+ * @param params.totalDirectories - Total number of directories analyzed.
+ * @param params.vagueFileNames - Count of files with non-descriptive names.
+ * @param params.totalFiles - Total number of files analyzed.
+ * @param params.hasRootReadme - Whether a README exists in the repository root.
+ * @param params.readmeIsFresh - Whether the root README has been updated recently.
+ * @param params.barrelExports - Count of 'index' files providing consolidated exports.
+ * @param params.untypedExports - Count of exports missing explicit type annotations.
+ * @param params.totalExports - Total number of public exports analyzed.
+ * @param params.inconsistentDomainTerms - Count of terms that conflict with the domain vocabulary.
+ * @param params.domainVocabularySize - Total number of unique domain terms identified.
+ * @returns Comprehensive AgentGroundingScore.
+ */
 declare function calculateAgentGrounding(params: {
     deepDirectories: number;
     totalDirectories: number;
@@ -1056,8 +1313,10 @@ declare function calculateAgentGrounding(params: {
 }): AgentGroundingScore;
 
 /**
- * Testability Index Metrics
- * Measures how verifiable AI-generated changes are.
+ * Testability Index Metrics.
+ * Measures how verifiable AI-generated changes are based on local testing infrastructure.
+ *
+ * @lastUpdated 2026-03-18
  */
 interface TestabilityIndex {
     score: number;
@@ -1072,6 +1331,22 @@ interface TestabilityIndex {
     aiChangeSafetyRating: 'safe' | 'moderate-risk' | 'high-risk' | 'blind-risk';
     recommendations: string[];
 }
+/**
+ * Calculate the Testability Index for a project.
+ *
+ * @param params - Metrics including coverage, purity, and dependency patterns.
+ * @param params.testFiles - Count of identifiable test files.
+ * @param params.sourceFiles - Total number of source files.
+ * @param params.pureFunctions - Count of functions without side effects.
+ * @param params.totalFunctions - Total number of functions analyzed.
+ * @param params.injectionPatterns - Count of classes using dependency injection.
+ * @param params.totalClasses - Total number of classes analyzed.
+ * @param params.bloatedInterfaces - Count of interfaces with too many methods.
+ * @param params.totalInterfaces - Total number of interfaces analyzed.
+ * @param params.externalStateMutations - Count of nodes that mutate external state.
+ * @param params.hasTestFramework - Whether a testing framework (e.g., Vitest) is detected.
+ * @returns Comprehensive TestabilityIndex analysis.
+ */
 declare function calculateTestabilityIndex(params: {
     testFiles: number;
     sourceFiles: number;
@@ -1086,8 +1361,10 @@ declare function calculateTestabilityIndex(params: {
 }): TestabilityIndex;
 
 /**
- * Documentation Drift Metrics
+ * Documentation Drift Metrics.
  * Measures the risk of documentation becoming out of sync with code.
+ *
+ * @lastUpdated 2026-03-18
  */
 interface DocDriftRisk {
     score: number;
@@ -1103,8 +1380,13 @@ interface DocDriftRisk {
 /**
  * Calculate the documentation drift risk score based on various metrics.
  *
- * @param params - The raw metrics for doc-drift analysis
- * @returns The calculated risk score and recommendations
+ * @param params - The raw metrics for doc-drift analysis gathered during scanning.
+ * @param params.uncommentedExports - Number of public exports missing documentation.
+ * @param params.totalExports - Total number of public exports analyzed.
+ * @param params.outdatedComments - Count of comments that conflict with recent code changes.
+ * @param params.undocumentedComplexity - Count of complex nodes without explanatory comments.
+ * @param params.actualDrift - Raw drift metric calculated from temporal analysis.
+ * @returns The calculated risk score and prioritized recommendations.
  */
 declare function calculateDocDrift(params: {
     uncommentedExports: number;
@@ -1115,8 +1397,10 @@ declare function calculateDocDrift(params: {
 }): DocDriftRisk;
 
 /**
- * Dependency Health Metrics
- * Measures the health and recency of project dependencies.
+ * Dependency Health Metrics.
+ * Measures the health, recency, and security of project dependencies.
+ *
+ * @lastUpdated 2026-03-18
  */
 interface DependencyHealthScore {
     score: number;
@@ -1129,6 +1413,16 @@ interface DependencyHealthScore {
     aiKnowledgeConfidence: 'high' | 'moderate' | 'low' | 'blind';
     recommendations: string[];
 }
+/**
+ * Calculate Dependency Health metrics based on version freshness and package metadata.
+ *
+ * @param params - Metrics gathered from package.json and registry lookups.
+ * @param params.totalPackages - Total number of dependencies analyzed.
+ * @param params.outdatedPackages - Count of packages with newer versions available.
+ * @param params.deprecatedPackages - Count of packages marked as deprecated by maintainers.
+ * @param params.trainingCutoffSkew - Normalized skew between dependency release dates and AI training cutoffs.
+ * @returns Comprehensive DependencyHealthScore.
+ */
 declare function calculateDependencyHealth(params: {
     totalPackages: number;
     outdatedPackages: number;
@@ -1136,6 +1430,11 @@ declare function calculateDependencyHealth(params: {
     trainingCutoffSkew: number;
 }): DependencyHealthScore;
 
+/**
+ * Parameters for generating comprehensive future-proof recommendations.
+ *
+ * @lastUpdated 2026-03-18
+ */
 interface FutureProofRecommendationParams {
     cognitiveLoad: CognitiveLoad;
     patternEntropy: PatternEntropy;
@@ -1148,8 +1447,10 @@ interface FutureProofRecommendationParams {
 }
 
 /**
- * Change Amplification Metrics
- * Measures how a change in one file ripples through the system.
+ * Change Amplification Metrics.
+ * Measures how a change in one file ripples through the system via dependency fan-out.
+ *
+ * @lastUpdated 2026-03-18
  */
 interface ChangeAmplificationScore {
     score: number;
@@ -1164,6 +1465,13 @@ interface ChangeAmplificationScore {
     }>;
     recommendations: string[];
 }
+/**
+ * Calculate Change Amplification metrics for a set of files in a dependency graph.
+ *
+ * @param params - Structural metrics gathered from link analysis.
+ * @param params.files - List of files with their fan-in/fan-out counts.
+ * @returns Comprehensive ChangeAmplificationScore.
+ */
 declare function calculateChangeAmplification(params: {
     files: Array<{
         file: string;
@@ -1173,12 +1481,14 @@ declare function calculateChangeAmplification(params: {
 }): ChangeAmplificationScore;
 
 /**
- * Future-Proof AI Metrics Abstraction Layer
+ * Future-Proof AI Metrics Abstraction Layer.
  *
  * This module provides technology-agnostic metric primitives that will
  * remain valid across changes in AI models, tokenization, and paradigms.
  *
  * It focuses on cognitive load, semantic cohesion, and structural entropy.
+ *
+ * @lastUpdated 2026-03-18
  */
 
 /**
@@ -1206,8 +1516,8 @@ declare function calculateFutureProofScore(params: {
  * Incorporates secondary signals like documentation drift, dependency health,
  * and testability index to provide a holistic view of the repository's AI readiness.
  *
- * @param params - Comprehensive set of metric outputs
- * @returns ToolScoringOutput with extended analysis results
+ * @param params - Comprehensive set of metric outputs including grounding and testability.
+ * @returns ToolScoringOutput with extended analysis results and prioritized fixes.
  */
 declare function calculateExtendedFutureProofScore(params: FutureProofRecommendationParams & {
     semanticDistances?: SemanticDistance[];
@@ -1220,11 +1530,18 @@ declare function calculateExtendedFutureProofScore(params: FutureProofRecommenda
  * Stores data in .aiready/history/ directory.
  */
 /**
- * Load score history from disk
+ * Load score history from disk.
+ *
+ * @param rootDir - The project root directory.
+ * @returns Array of history entries.
  */
 declare function loadScoreHistory(rootDir: string): any[];
 /**
- * Save score entry to history
+ * Save a new score entry to history.
+ *
+ * @param rootDir - The project root directory.
+ * @param entry - The score data to persist.
+ * @lastUpdated 2026-03-18
  */
 declare function saveScoreEntry(rootDir: string, entry: {
     overallScore: number;
@@ -1233,7 +1550,10 @@ declare function saveScoreEntry(rootDir: string, entry: {
     totalTokens: number;
 }): void;
 /**
- * Get summary of recent history
+ * Get a summary of recent history metrics.
+ *
+ * @param rootDir - The project root directory.
+ * @returns Summary object with totals and averages.
  */
 declare function getHistorySummary(rootDir: string): {
     totalScans: number;
@@ -1242,24 +1562,42 @@ declare function getHistorySummary(rootDir: string): {
     avgScore: number;
 };
 /**
- * Export history for external analysis
+ * Export history for external analysis.
+ *
+ * @param rootDir - The project root directory.
+ * @param format - Export format ('json' or 'csv').
+ * @returns Formatted history string.
  */
 declare function exportHistory(rootDir: string, format?: 'json' | 'csv'): string;
 /**
- * Clear history (for testing or reset)
+ * Clear history (for testing or reset).
+ *
+ * @param rootDir - The project root directory.
  */
 declare function clearHistory(rootDir: string): void;
 
 /**
- * Get git commit timestamps for each line in a file
+ * Get git commit timestamps for each line in a file using git blame.
+ *
+ * @param file - Absolute path to the file to blame.
+ * @returns Map of line numbers to unix timestamps.
  */
 declare function getFileCommitTimestamps(file: string): Record<number, number>;
 /**
- * Get the latest commit timestamp for a line range
+ * Get the latest commit timestamp for a specific line range.
+ *
+ * @param lineStamps - Pre-computed map of line timestamps.
+ * @param startLine - Start of the range (1-indexed).
+ * @param endLine - End of the range (inclusive).
+ * @returns The most recent unix timestamp in the range.
  */
 declare function getLineRangeLastModifiedCached(lineStamps: Record<number, number>, startLine: number, endLine: number): number;
 /**
- * Get repository metadata (URL, branch, commit, author)
+ * Get repository metadata including URL, branch, commit, and last author.
+ *
+ * @param directory - The repository root directory.
+ * @returns Metadata object with git details.
+ * @lastUpdated 2026-03-18
  */
 declare function getRepoMetadata(directory: string): {
     url?: string;
@@ -1272,8 +1610,10 @@ declare function getRepoMetadata(directory: string): {
  * Utilities for GitHub Actions integration
  */
 /**
- * Emit a GitHub Action annotation
+ * Emit a GitHub Action annotation.
  * Format: ::(error|warning|notice) file={file},line={line},col={col},title={title}::{message}
+ *
+ * @param params - Annotation parameters including level, file, and message.
  */
 declare function emitAnnotation(params: {
     level: 'error' | 'warning' | 'notice';
@@ -1284,12 +1624,18 @@ declare function emitAnnotation(params: {
     message: string;
 }): void;
 /**
- * Map AIReady severity to GitHub Action annotation level
+ * Map AIReady severity to GitHub Action annotation level.
+ *
+ * @param severity - AIReady severity string (e.g., 'critical', 'major').
+ * @returns GitHub Action annotation level ('error', 'warning', or 'notice').
  */
 declare function severityToAnnotationLevel(severity: string): 'error' | 'warning' | 'notice';
 /**
- * Emit multiple annotations from an array of issues
+ * Emit multiple annotations from an array of issues.
+ *
+ * @param issues - Array of issue objects to annotate.
+ * @lastUpdated 2026-03-18
  */
 declare function emitIssuesAsAnnotations(issues: any[]): void;
 
-export { AIReadyConfig, ASTNode, 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, 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, extractFunctions, extractImports, 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, parseCode, 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 };