@aiready/core 0.23.20 → 0.23.22

package/dist/index.d.ts

@@ -1,6 +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, 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-jGuH6TAG.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 getPriorityIcon, az as getProjectSizeTier, aA as getRating, aB as getRatingDisplay, aC as getRatingEmoji, aD as getRatingLabel, aE as getRatingSlug, aF as getRatingWithContext, aG as getRecommendedThreshold, aH as getToolEmoji, aI as getToolWeight, aJ as normalizeToolName, aK as parseWeightString } from './client-jGuH6TAG.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 TechnicalValueChain, g as ModelContextTier, C as CostConfig, h as TokenBudget, P as ProductivityImpact, i as AcceptancePrediction, j as ComprehensionDifficulty, k as TechnicalValueChainSummary, L as Language, l as LanguageParser, m as ParseResult, N as NamingConvention, n as ExportInfo } from './index-Ctl_0z6F.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 IssueOverlay, U as IssueSchema, V as IssueType, W as IssueTypeSchema, X as LANGUAGE_EXTENSIONS, Y as LanguageConfig, Z as Lead, _ as LeadSchema, $ as LeadSource, a0 as LeadSourceSchema, a1 as LeadSubmission, a2 as LeadSubmissionSchema, a3 as Location, a4 as LocationSchema, a5 as ManagedAccount, a6 as ManagedAccountSchema, a7 as MetricsSchema, a8 as ModelTier, a9 as ModelTierSchema, aa as ParseError, ab as ParseStatistics, ac as ReadinessRating, ad as RecommendationPriority, ae as SCORING_PROFILES, af as SIZE_ADJUSTED_THRESHOLDS, ag as ScanResult, ah as ScoringConfig, ai as ScoringProfile, aj as ScoringResult, ak as SeveritySchema, al as SourceLocation, am as SourceRange, an as SpokeOutputSchema, ao as SpokeSummary, ap as SpokeSummarySchema, aq as TOOL_NAME_MAP, ar as ToolNameSchema, as as ToolOutput, at as UnifiedReport, au as UnifiedReportSchema, av as calculateOverallScore, aw as formatScore, ax as formatToolScore, ay as generateHTML, az as getPriorityIcon, aA as getProjectSizeTier, aB as getRating, aC as getRatingDisplay, aD as getRatingEmoji, aE as getRatingLabel, aF as getRatingMetadata, aG as getRatingSlug, aH as getRatingWithContext, aI as getRecommendedThreshold, aJ as getToolEmoji, aK as getToolWeight, aL as normalizeToolName, aM as parseWeightString } from './index-Ctl_0z6F.js';
 import { z } from 'zod';
+import * as chalk from 'chalk';
 import * as Parser from 'web-tree-sitter';
 
 /**
@@ -237,7 +238,22 @@ declare function loadMergedConfig<T extends Record<string, any>>(directory: stri
  */
 declare function handleJSONOutput(data: any, outputFile?: string, successMessage?: string): void;
 /**
- * Common error handler for CLI commands.
+ * Get a formatted terminal divider string based on current terminal width.
+ *
+ * @param color - Chalk color function to use for the divider.
+ * @param maxWidth - Maximum width for the divider (default: 60).
+ * @returns String representation of the divider.
+ */
+declare function getTerminalDivider(color?: any, maxWidth?: number): string;
+/**
+ * Print a standard terminal header with dividers.
+ *
+ * @param title - Header title text.
+ * @param color - Chalk color function for the dividers.
+ */
+declare function printTerminalHeader(title: string, color?: any): void;
+/**
+ * Common CLI error handler for CLI commands.
  * Logs error and exits process with code 1.
  *
  * @param error - Error object or message.
@@ -333,6 +349,61 @@ declare function findLatestReport(dirPath: string): string | null;
  */
 declare function findLatestScanReport(scanReportsDir: string, reportFilePrefix: string): string | null;
 
+/**
+ * Generate timestamp for report filenames (YYYYMMDD-HHMMSS)
+ * Provides better granularity than date-only filenames
+ */
+declare function getReportTimestamp(): string;
+/**
+ * Interface for CLI action output parameters
+ */
+interface JSONOutputParams {
+    outputData: any;
+    outputFile?: string;
+    resolvedDir: string;
+    prefix?: string;
+}
+/**
+ * Standard JSON output handler for CLI actions.
+ * Consolidates path resolution and output handling.
+ */
+declare function handleStandardJSONOutput({ outputData, outputFile, resolvedDir, prefix, }: JSONOutputParams): void;
+/**
+ * Resolves the output format and file path from CLI options and merged config.
+ */
+declare function resolveOutputFormat(options: {
+    output?: string;
+    outputFile?: string;
+}, config: {
+    output?: {
+        format?: string;
+        file?: string;
+    };
+}): {
+    format: string;
+    file: string | undefined;
+};
+/**
+ * Common configuration preparation for CLI actions.
+ * Resolves directory and merges configuration.
+ */
+declare function prepareActionConfig<T extends Record<string, any>>(directory: string, defaults: T, cliOptions: Partial<T>): Promise<{
+    resolvedDir: string;
+    finalOptions: T & {
+        rootDir: string;
+    };
+}>;
+/**
+ * Formats report data for standard JSON output including timing and scoring.
+ */
+declare function formatStandardReport(params: {
+    results?: any;
+    report?: any;
+    summary: any;
+    elapsedTime: string;
+    score?: ToolScoringOutput;
+}): any;
+
 /**
  * Groups a flat array of issues by their `location.file` path into the
  * `AnalysisResult[]` shape expected by `SpokeOutputSchema`.
@@ -403,10 +474,10 @@ declare function calculateImportSimilarity(export1: ExportWithImports, export2:
  * @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): {
+declare function parseFileExports(code: string, filePath: string): Promise<{
     exports: ExportWithImports[];
     imports: FileImport[];
-};
+}>;
 
 /**
  * Estimate token count for text (rough approximation)
@@ -429,8 +500,10 @@ declare function loadConfig(rootDir: string): Promise<AIReadyConfig | null>;
 declare function mergeConfigWithDefaults(userConfig: AIReadyConfig | null, defaults: any): any;
 
 /**
- * Shared HTML report builder utility
+ * Shared HTML report formatting utilities.
  * Provides common template parts for generating self-contained HTML reports.
+ *
+ * @lastUpdated 2026-03-24
  */
 interface ReportOptions {
     title: string;
@@ -450,27 +523,39 @@ interface TableConfig {
     rows: string[][];
 }
 /**
- * Generate the HTML document head with common styles
+ * Generate the HTML document head with common styles.
  */
 declare function generateReportHead(title: string): string;
 /**
- * Generate stat cards section
+ * Generate a hero section for the report.
+ */
+declare function generateReportHero(title: string, subtitle?: string): string;
+/**
+ * Generate stat cards section.
  */
 declare function generateStatCards(cards: StatCard[]): string;
 /**
- * Generate an HTML table from config
+ * Generate a score card with a single large value.
+ */
+declare function generateScoreCard(value: string | number, label: string): string;
+/**
+ * Generate an HTML table from configuration.
  */
 declare function generateTable(config: TableConfig): string;
 /**
- * Generate the report footer
+ * Generate an issue summary card.
+ */
+declare function generateIssueSummary(critical: number, major: number, minor: number, potentialSavings?: number): string;
+/**
+ * Generate the report footer.
  */
 declare function generateReportFooter(options: ReportOptions): string;
 /**
- * Wrap content in a card div
+ * Wrap content in a card div.
  */
 declare function wrapInCard(content: string, title?: string): string;
 /**
- * Generate a complete report by combining all parts
+ * Generate a complete report by combining all parts.
  */
 declare function generateCompleteReport(options: ReportOptions, bodyContent: string): string;
 
@@ -492,144 +577,130 @@ declare function normalizeAnalysisResult(raw: any): AnalysisResult;
 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.
+ * Standard parameters for building a ToolScoringOutput.
  */
-interface ModelPricingPreset {
-    name: string;
-    pricePer1KInputTokens: number;
-    pricePer1KOutputTokens: number;
-    contextTier: ModelContextTier;
-    /** Approximate daily queries per active dev for this model class */
-    typicalQueriesPerDevPerDay: number;
+interface StandardScoringParams {
+    toolName: ToolName | string;
+    score: number;
+    rawData: Record<string, any>;
+    dimensions: Record<string, number>;
+    dimensionNames: Record<string, string>;
+    recommendations: string[];
+    recommendationImpact?: number;
+    rating?: string;
 }
-declare const MODEL_PRICING_PRESETS: Record<string, ModelPricingPreset>;
 /**
- * Get a model pricing preset by ID, with fallback to claude-4.6 (2026 default)
+ * Common factor builder logic.
+ * Map dimension scores to standard factor objects with -50 impact baseline.
  */
-declare function getModelPreset(modelId: string): ModelPricingPreset;
+declare function buildFactorsFromDimensions(dimensions: Record<string, number>, dimensionNames: Record<string, string>, rawData: Record<string, any>): ToolScoringOutput['factors'];
+/**
+ * Unified tool scoring output builder.
+ */
+declare function buildStandardToolScore(params: StandardScoringParams): ToolScoringOutput;
 
 /**
- * Default cost configuration
+ * Calculate Jaccard similarity between two strings.
+ * Splitting by non-alphanumeric to be robust across different programming languages and formats.
+ *
+ * @param a - First string for comparison.
+ * @param b - Second string for comparison.
+ * @returns Similarity score between 0 and 1.
  */
-declare const DEFAULT_COST_CONFIG: CostConfig;
+declare function calculateStringSimilarity(a: string, b: string): number;
 /**
- * Calculate estimated monthly cost of AI context waste
+ * Calculate heuristic confidence score for a duplicate or pattern detection.
+ * Considers similarity, block size, and structural match.
+ *
+ * @param similarity - Similarity score (0-1).
+ * @param tokens - Token count of the code block.
+ * @param lines - Line count of the code block.
+ * @returns Confidence score between 0 and 1.
  */
-declare function calculateMonthlyCost(tokenWaste: number, config?: Partial<CostConfig>, options?: {
-    avgContextBudget?: number;
-    fragmentationScore?: number;
-    potentialSavings?: number;
-}): {
-    total: number;
-    range: [number, number];
-    confidence: number;
-};
+declare function calculateHeuristicConfidence(similarity: number, tokens: number, lines: number): number;
+
 /**
- * Calculate precise Token ROI from analyzer metrics.
+ * Standard progress callback for AIReady spoke tools.
+ * Unified to remove structural duplication across spokes.
  *
- * This is the "Value-Led" monetization engine that quantifies the
- * "Context Tax" savings for a team.
+ * @param toolName - The name of the tool reporting progress.
  */
-declare function calculateDetailedTokenROI(params: {
-    totalTokens: number;
-    avgContextBudget: number;
-    potentialSavings: number;
-    fragmentationScore: number;
-    developerCount: number;
-    queriesPerDevPerDay?: number;
-}): {
-    monthlySavings: number;
-    contextTaxPerDev: number;
-    efficiencyGain: number;
-};
+declare function createStandardProgressCallback(toolName: string): (processed: number, total: number, message: string) => void;
 /**
- * Calculate token budget and unit economics
+ * Standard result formatter for CLI output.
+ *
+ * @param toolName - Canonical ToolName.
+ * @param score - Calculated readiness score (0-100).
+ * @param issuesCount - Number of identified issues.
  */
-declare function calculateTokenBudget(params: {
-    totalContextTokens: number;
-    estimatedResponseTokens?: number;
-    wastedTokens: {
-        duplication: number;
-        fragmentation: number;
-        chattiness: number;
-    };
-}): TokenBudget;
+declare function formatStandardCliResult(toolName: string, score: number, issuesCount: number): void;
 /**
- * Estimate dollar cost from a token budget
+ * Common CLI action helper to unify try-catch and output handling.
  */
-declare function estimateCostFromBudget(budget: TokenBudget, model: ModelPricingPreset, config?: Partial<CostConfig>): {
-    total: number;
-    range: [number, number];
-    confidence: number;
-};
+declare function runStandardCliAction(toolName: string, action: () => Promise<{
+    score: number;
+    issuesCount: number;
+}>): Promise<void>;
 
 /**
- * Severity time estimates (hours to fix)
+ * Interface for standard CLI report data
  */
-declare const SEVERITY_TIME_ESTIMATES: {
-    critical: number;
-    major: number;
-    minor: number;
-    info: number;
-};
+interface StandardReportData {
+    title: string;
+    subtitle?: string;
+    score: number;
+    rating: string;
+    dimensions: Array<{
+        name: string;
+        value: number;
+        label?: string;
+    }>;
+    stats?: Array<{
+        label: string;
+        value: string | number;
+    }>;
+    issues: Array<{
+        severity: Severity | string;
+        message: string;
+        suggestion?: string;
+    }>;
+    recommendations?: string[];
+    elapsedTime: string;
+    noIssuesMessage?: string;
+    safetyRating?: string;
+}
 /**
- * Calculate productivity impact from issues
+ * Get color for score values
  */
-declare function calculateProductivityImpact(issues: {
-    severity: string;
-}[], hourlyRate?: number): ProductivityImpact;
+declare function getScoreColor(score: number): chalk.ChalkInstance;
 /**
- * Predict AI suggestion acceptance rate
+ * Display a standardized console report for any AIReady spoke CLI
+ *
+ * @param data - The report data to display
+ * @lastUpdated 2026-03-22
  */
-declare function predictAcceptanceRate(toolOutputs: Map<string, ToolScoringOutput>): AcceptancePrediction;
+declare function displayStandardConsoleReport(data: StandardReportData): void;
 
 /**
- * Knowledge and Technical Debt Risk Metrics
+ * Logical code block extracted from source
  */
-interface KnowledgeConcentrationRisk {
-    score: number;
-    rating: 'low' | 'moderate' | 'high' | 'critical';
-    analysis: {
-        uniqueConceptFiles: number;
-        totalFiles: number;
-        concentrationRatio: number;
-        singleAuthorFiles: number;
-        orphanFiles: number;
-    };
-    recommendations: string[];
-}
-declare function calculateKnowledgeConcentration(params: {
-    uniqueConceptFiles: number;
-    totalFiles: number;
-    singleAuthorFiles: number;
-    orphanFiles: number;
-}): KnowledgeConcentrationRisk;
-interface TechnicalDebtInterest {
-    monthlyRate: number;
-    annualRate: number;
-    principal: number;
-    projections: {
-        months6: number;
-        months12: number;
-        months24: number;
-    };
-    monthlyCost: number;
+interface CodeBlock {
+    file: string;
+    startLine: number;
+    endLine: number;
+    code: string;
+    tokens: number;
+    patternType: string;
 }
-declare function calculateDebtInterest(principal: number, monthlyGrowthRate: number): TechnicalDebtInterest;
-
 /**
- * Calculate Technical Value Chain
+ * Infer the type of code pattern based on keywords and naming conventions.
  */
-declare function calculateTechnicalValueChain(params: {
-    businessLogicDensity: number;
-    dataAccessComplexity: number;
-    apiSurfaceArea: number;
-}): TechnicalValueChainSummary;
+declare function inferPatternType(keyword: string, name: string): string;
 /**
- * Calculate Comprehension Difficulty Index (CDI)
+ * Split file content into logical blocks (functions, classes, methods)
+ * Handles TS/JS, Java, C#, Go, and Python (via indentation)
  */
-declare function calculateComprehensionDifficulty(contextBudget: number, importDepth: number, fragmentation: number, modelTier?: ModelContextTier | string): ComprehensionDifficulty;
+declare function extractCodeBlocks(file: string, content: string): CodeBlock[];
 
 /**
  * Business Value Metrics Module.
@@ -638,7 +709,6 @@ declare function calculateComprehensionDifficulty(contextBudget: number, importD
  *
  * @lastUpdated 2026-03-18
  */
-
 /**
  * Historical score entry for trend tracking.
  * Used to store and compare results across different points in time.
@@ -699,7 +769,6 @@ declare function calculateBusinessROI(params: {
     /** Projected total annual business value gained */
     annualValue: number;
 };
-
 /**
  * Format currency value for display in console or reports.
  *
@@ -745,26 +814,164 @@ declare function generateValueChain(params: {
 }): TechnicalValueChain;
 
 /**
- * Parser Factory - Manages language-specific parsers
+ * AI model pricing presets for cost estimation.
+ * Prices are input token costs per 1K tokens (USD), as of Q1 2026.
+ */
+interface ModelPricingPreset {
+    name: string;
+    pricePer1KInputTokens: number;
+    pricePer1KOutputTokens: number;
+    contextTier: ModelContextTier;
+    /** Approximate daily queries per active dev for this model class */
+    typicalQueriesPerDevPerDay: number;
+}
+declare const MODEL_PRICING_PRESETS: Record<string, ModelPricingPreset>;
+/**
+ * Get a model pricing preset by ID, with fallback to claude-4.6 (2026 default)
+ */
+declare function getModelPreset(modelId: string): ModelPricingPreset;
+
+/**
+ * Default cost configuration
+ */
+declare const DEFAULT_COST_CONFIG: CostConfig;
+/**
+ * Calculate estimated monthly cost of AI context waste
+ */
+declare function calculateMonthlyCost(tokenWaste: number, config?: Partial<CostConfig>, options?: {
+    avgContextBudget?: number;
+    fragmentationScore?: number;
+    potentialSavings?: number;
+}): {
+    total: number;
+    range: [number, number];
+    confidence: number;
+};
+/**
+ * Calculate precise Token ROI from analyzer metrics.
  *
- * This factory provides a centralized way to access the appropriate parser
- * for a given file based on its extension.
+ * This is the "Value-Led" monetization engine that quantifies the
+ * "Context Tax" savings for a team.
  */
+declare function calculateDetailedTokenROI(params: {
+    totalTokens: number;
+    avgContextBudget: number;
+    potentialSavings: number;
+    fragmentationScore: number;
+    developerCount: number;
+    queriesPerDevPerDay?: number;
+}): {
+    monthlySavings: number;
+    contextTaxPerDev: number;
+    efficiencyGain: number;
+};
+/**
+ * Calculate token budget and unit economics
+ */
+declare function calculateTokenBudget(params: {
+    totalContextTokens: number;
+    estimatedResponseTokens?: number;
+    wastedTokens: {
+        duplication: number;
+        fragmentation: number;
+        chattiness: number;
+    };
+}): TokenBudget;
+/**
+ * Estimate dollar cost from a token budget
+ */
+declare function estimateCostFromBudget(budget: TokenBudget, model: ModelPricingPreset, config?: Partial<CostConfig>): {
+    total: number;
+    range: [number, number];
+    confidence: number;
+};
+
+/**
+ * Severity time estimates (hours to fix)
+ */
+declare const SEVERITY_TIME_ESTIMATES: {
+    critical: number;
+    major: number;
+    minor: number;
+    info: number;
+};
+/**
+ * Calculate productivity impact from issues
+ */
+declare function calculateProductivityImpact(issues: {
+    severity: string;
+}[], hourlyRate?: number): ProductivityImpact;
+/**
+ * Predict AI suggestion acceptance rate
+ */
+declare function predictAcceptanceRate(toolOutputs: Map<string, ToolScoringOutput>): AcceptancePrediction;
+
+/**
+ * Knowledge and Technical Debt Risk Metrics
+ */
+interface KnowledgeConcentrationRisk {
+    score: number;
+    rating: 'low' | 'moderate' | 'high' | 'critical';
+    analysis: {
+        uniqueConceptFiles: number;
+        totalFiles: number;
+        concentrationRatio: number;
+        singleAuthorFiles: number;
+        orphanFiles: number;
+    };
+    recommendations: string[];
+}
+declare function calculateKnowledgeConcentration(params: {
+    uniqueConceptFiles: number;
+    totalFiles: number;
+    singleAuthorFiles: number;
+    orphanFiles: number;
+}): KnowledgeConcentrationRisk;
+interface TechnicalDebtInterest {
+    monthlyRate: number;
+    annualRate: number;
+    principal: number;
+    projections: {
+        months6: number;
+        months12: number;
+        months24: number;
+    };
+    monthlyCost: number;
+}
+declare function calculateDebtInterest(principal: number, monthlyGrowthRate: number): TechnicalDebtInterest;
+
+/**
+ * Calculate Technical Value Chain
+ */
+declare function calculateTechnicalValueChain(params: {
+    businessLogicDensity: number;
+    dataAccessComplexity: number;
+    apiSurfaceArea: number;
+}): TechnicalValueChainSummary;
+/**
+ * Calculate Comprehension Difficulty Index (CDI)
+ */
+declare function calculateComprehensionDifficulty(contextBudget: number, importDepth: number, fragmentation: number, modelTier?: ModelContextTier | string): ComprehensionDifficulty;
 
 /**
  * Factory for creating and managing language parsers.
  * Supports both singleton usage and multiple instances for test isolation.
  *
- * @lastUpdated 2026-03-18
+ * @lastUpdated 2026-03-22
  */
 declare class ParserFactory {
     private static instance;
     private parsers;
     private extensionMap;
+    private registeredParsers;
     /**
      * Create a new ParserFactory instance
      */
     constructor();
+    /**
+     * Register a lazy-loaded parser
+     */
+    registerLazyParser(language: Language, loader: () => Promise<LanguageParser>): void;
     /**
      * Get the global singleton instance
      *
@@ -778,13 +985,13 @@ declare class ParserFactory {
     /**
      * Get parser for a specific language
      */
-    getParserForLanguage(language: Language): LanguageParser | null;
+    getParserForLanguage(language: Language): Promise<LanguageParser | null>;
     /**
      * Get parser for a file based on its extension
      */
-    getParserForFile(filePath: string): LanguageParser | null;
+    getParserForFile(filePath: string): Promise<LanguageParser | null>;
     /**
-     * Check if a file is supported
+     * Check if a file is supported (synchronous check based on extension)
      */
     isSupported(filePath: string): boolean;
     /**
@@ -817,9 +1024,9 @@ declare class ParserFactory {
  *
  * @param filePath - Path to the file to get a parser for.
  * @returns LanguageParser instance or null if unsupported.
- * @lastUpdated 2026-03-18
+ * @lastUpdated 2026-03-22
  */
-declare function getParser(filePath: string): LanguageParser | null;
+declare function getParser(filePath: string): Promise<LanguageParser | null>;
 /**
  * Initialize all parsers
  */
@@ -1531,40 +1738,6 @@ interface FutureProofRecommendationParams {
     dependencyHealth?: DependencyHealthScore;
 }
 
-/**
- * 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;
-    rating: 'isolated' | 'contained' | 'amplified' | 'explosive';
-    avgAmplification: number;
-    maxAmplification: number;
-    hotspots: Array<{
-        file: string;
-        fanOut: number;
-        fanIn: number;
-        amplificationFactor: number;
-    }>;
-    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;
-        fanOut: number;
-        fanIn: number;
-    }>;
-}): ChangeAmplificationScore;
-
 /**
  * Future-Proof AI Metrics Abstraction Layer.
  *
@@ -1608,6 +1781,40 @@ declare function calculateExtendedFutureProofScore(params: FutureProofRecommenda
     semanticDistances?: SemanticDistance[];
 }): ToolScoringOutput;
 
+/**
+ * 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;
+    rating: 'isolated' | 'contained' | 'amplified' | 'explosive';
+    avgAmplification: number;
+    maxAmplification: number;
+    hotspots: Array<{
+        file: string;
+        fanOut: number;
+        fanIn: number;
+        amplificationFactor: number;
+    }>;
+    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;
+        fanOut: number;
+        fanIn: number;
+    }>;
+}): ChangeAmplificationScore;
+
 /**
  * Temporal Tracking Utilities
  *
@@ -1723,4 +1930,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 FileTestability, 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, type ReportOptions, SEVERITY_TIME_ESTIMATES, ScanOptions, type ScoreHistoryEntry, type ScoreTrend, type SemanticDistance, Severity, Severity as SeverityType, SpokeOutput, type StatCard, type TableConfig, 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, calculateDetailedTokenROI, 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, generateCompleteReport, generateReportFooter, generateReportHead, generateStatCards, generateTable, 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, wrapInCard };
+export { AIReadyConfig, AcceptancePrediction, type AgentGroundingScore, type AiSignalClarity, type AiSignalClaritySignal, AnalysisResult, type CLIOptions, CSharpParser, type ChangeAmplificationScore, type CodeBlock, type CognitiveLoad, ComprehensionDifficulty, type ConceptCohesion, CostConfig, DEFAULT_COST_CONFIG, DEFAULT_EXCLUDE, type DependencyHealthScore, type DocDriftRisk, ExportInfo, ExportWithImports, FileImport, type FileTestability, type FileWithDomain, GoParser, Issue, type JSONOutputParams, JavaParser, type KnowledgeConcentrationRisk, Language, LanguageParser, type LoadFactor, MODEL_PRICING_PRESETS, Metrics, ModelContextTier, type ModelPricingPreset, NamingConvention, ParseResult, ParserFactory, type PatternEntropy, ProductivityImpact, type ProviderFactoryConfig, PythonParser, type ReportOptions, SEVERITY_TIME_ESTIMATES, ScanOptions, type ScoreHistoryEntry, type ScoreTrend, type SemanticDistance, Severity, Severity as SeverityType, SpokeOutput, type StandardReportData, type StandardScoringParams, type StatCard, type TableConfig, type TechnicalDebtInterest, TechnicalValueChain, TechnicalValueChainSummary, type TestabilityIndex, TokenBudget, ToolName, ToolOptions, type ToolProvider, ToolRegistry, ToolScoringOutput, TypeScriptParser, VAGUE_FILE_NAMES, buildFactorsFromDimensions, buildSimpleProviderScore, buildSpokeOutput, buildStandardToolScore, calculateAgentGrounding, calculateAiSignalClarity, calculateBusinessROI, calculateChangeAmplification, calculateCognitiveLoad, calculateComprehensionDifficulty, calculateConceptCohesion, calculateDebtInterest, calculateDependencyHealth, calculateDetailedTokenROI, calculateDocDrift, calculateExtendedFutureProofScore, calculateFutureProofScore, calculateHeuristicConfidence, calculateImportSimilarity, calculateKnowledgeConcentration, calculateMonthlyCost, calculatePatternEntropy, calculateProductivityImpact, calculateSemanticDistance, calculateStringSimilarity, calculateTechnicalValueChain, calculateTestabilityIndex, calculateTokenBudget, clearHistory, createProvider, createStandardProgressCallback, displayStandardConsoleReport, emitAnnotation, emitIssuesAsAnnotations, emitProgress, estimateCostFromBudget, estimateTokens, exportHistory, extractCodeBlocks, findLatestReport, findLatestScanReport, formatAcceptanceRate, formatCost, formatHours, formatStandardCliResult, formatStandardReport, generateCompleteReport, generateIssueSummary, generateReportFooter, generateReportHead, generateReportHero, generateScoreCard, generateStatCards, generateTable, generateValueChain, getElapsedTime, getFileCommitTimestamps, getFileExtension, getHistorySummary, getLineRangeLastModifiedCached, getModelPreset, getParser, getRepoMetadata, getReportTimestamp, getSafetyIcon, getScoreBar, getScoreColor, getSeverityBadge, getSeverityColor, getSeverityEnum, getSeverityLevel, getSeverityValue, getSupportedLanguages, getTerminalDivider, getWasmPath, groupIssuesByFile, handleCLIError, handleJSONOutput, handleStandardJSONOutput, inferPatternType, initTreeSitter, initializeParsers, isFileSupported, isSourceFile, loadConfig, loadMergedConfig, loadScoreHistory, mergeConfigWithDefaults, normalizeAnalysisResult, normalizeIssue, normalizeMetrics, normalizeSpokeOutput, parseFileExports, predictAcceptanceRate, prepareActionConfig, printTerminalHeader, readFileContent, resolveOutputFormat, resolveOutputPath, runStandardCliAction, saveScoreEntry, scanEntries, scanFiles, setupParser, severityToAnnotationLevel, validateSpokeOutput, validateWithSchema, wrapInCard };