@aiready/core 0.23.21 → 0.23.23

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-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 Language, l as LanguageParser, m as ParseResult, N as NamingConvention, n as ExportInfo } from './client-Bdi4ty0v.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 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 './client-Bdi4ty0v.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 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.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 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.mjs';
 import { z } from 'zod';
 import * as chalk from 'chalk';
 import * as Parser from 'web-tree-sitter';
@@ -702,6 +702,117 @@ declare function inferPatternType(keyword: string, name: string): string;
  */
 declare function extractCodeBlocks(file: string, content: string): CodeBlock[];
 
+/**
+ * Business Value Metrics Module.
+ *
+ * Provides business-aligned metrics that quantify ROI and survive technology changes.
+ *
+ * @lastUpdated 2026-03-18
+ */
+/**
+ * Historical score entry for trend tracking.
+ * Used to store and compare results across different points in time.
+ */
+interface ScoreHistoryEntry {
+    /** ISO timestamp of the scan */
+    timestamp: string;
+    /** Overall score (0-100) */
+    overallScore: number;
+    /** Breakdown of scores by tool */
+    breakdown: Record<string, number>;
+    /** Total number of issues detected */
+    totalIssues: number;
+    /** Total tokens analyzed */
+    totalTokens: number;
+}
+/**
+ * Trend analysis comparing current vs historical scores.
+ * Helps teams understand if their AI-readiness is improving or degrading.
+ */
+interface ScoreTrend {
+    /** Overall trend direction */
+    direction: 'improving' | 'stable' | 'degrading';
+    /** Percentage change in score over last 30 days */
+    change30Days: number;
+    /** Percentage change in score over last 90 days */
+    change90Days: number;
+    /** Rate of change (points per week) */
+    velocity: number;
+    /** Projected score in 30 days based on current velocity */
+    projectedScore: number;
+}
+/**
+ * Calculate Aggregate Business ROI from code analysis results.
+ *
+ * This high-level function combines token waste and productivity impact
+ * to produce a monthly and annual dollar value of the issues found.
+ *
+ * @param params - Parameters for ROI calculation
+ * @param params.tokenWaste - Estimated total tokens wasted on context inefficiencies
+ * @param params.issues - Array of issues with severity levels for productivity impact
+ * @param params.developerCount - Number of developers in the team (default: 5)
+ * @param params.modelId - AI model ID for pricing model selection (default: 'claude-4.6')
+ * @returns Business ROI metrics including savings and recommendations
+ */
+declare function calculateBusinessROI(params: {
+    tokenWaste: number;
+    issues: {
+        severity: string;
+    }[];
+    developerCount?: number;
+    modelId?: string;
+}): {
+    /** Estimated monthly savings if issues are resolved */
+    monthlySavings: number;
+    /** Total developer hours gained per month */
+    productivityGainHours: number;
+    /** Projected total annual business value gained */
+    annualValue: number;
+};
+/**
+ * Format currency value for display in console or reports.
+ *
+ * Handles small values with decimals and large values with 'k' suffix.
+ *
+ * @param cost Cost in USD
+ * @returns Formatted currency string (e.g. "$0.50", "$500", "$1.2k")
+ */
+declare function formatCost(cost: number): string;
+/**
+ * Format time duration in hours for display in console or reports.
+ *
+ * Automatically switches between minutes, hours, and weeks based on magnitude.
+ *
+ * @param hours Number of hours
+ * @returns Formatted duration string (e.g. "30min", "4.5h", "2.1 weeks")
+ */
+declare function formatHours(hours: number): string;
+
+/**
+ * Format AI acceptance rate as a human-readable percentage string.
+ *
+ * @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;
+/**
+ * Generate a technical value chain map for a specific issue category.
+ *
+ * maps technical metrics (like duplication count) to business outcomes
+ * by explaining the impact on AI models and developer workflow.
+ *
+ * @param params Issue information
+ * @param params.issueType Unique identifier for the issue type
+ * @param params.count Total occurrences of this issue
+ * @param params.severity Severity level of the issues
+ * @returns A structured technical value chain object
+ */
+declare function generateValueChain(params: {
+    issueType: string;
+    count: number;
+    severity: 'critical' | 'major' | 'minor';
+}): TechnicalValueChain;
+
 /**
  * AI model pricing presets for cost estimation.
  * Prices are input token costs per 1K tokens (USD), as of Q1 2026.
@@ -842,119 +953,6 @@ declare function calculateTechnicalValueChain(params: {
  */
 declare function calculateComprehensionDifficulty(contextBudget: number, importDepth: number, fragmentation: number, modelTier?: ModelContextTier | string): ComprehensionDifficulty;
 
-/**
- * Business Value Metrics Module.
- *
- * Provides business-aligned metrics that quantify ROI and survive technology changes.
- *
- * @lastUpdated 2026-03-18
- */
-
-/**
- * Historical score entry for trend tracking.
- * Used to store and compare results across different points in time.
- */
-interface ScoreHistoryEntry {
-    /** ISO timestamp of the scan */
-    timestamp: string;
-    /** Overall score (0-100) */
-    overallScore: number;
-    /** Breakdown of scores by tool */
-    breakdown: Record<string, number>;
-    /** Total number of issues detected */
-    totalIssues: number;
-    /** Total tokens analyzed */
-    totalTokens: number;
-}
-/**
- * Trend analysis comparing current vs historical scores.
- * Helps teams understand if their AI-readiness is improving or degrading.
- */
-interface ScoreTrend {
-    /** Overall trend direction */
-    direction: 'improving' | 'stable' | 'degrading';
-    /** Percentage change in score over last 30 days */
-    change30Days: number;
-    /** Percentage change in score over last 90 days */
-    change90Days: number;
-    /** Rate of change (points per week) */
-    velocity: number;
-    /** Projected score in 30 days based on current velocity */
-    projectedScore: number;
-}
-/**
- * Calculate Aggregate Business ROI from code analysis results.
- *
- * This high-level function combines token waste and productivity impact
- * to produce a monthly and annual dollar value of the issues found.
- *
- * @param params - Parameters for ROI calculation
- * @param params.tokenWaste - Estimated total tokens wasted on context inefficiencies
- * @param params.issues - Array of issues with severity levels for productivity impact
- * @param params.developerCount - Number of developers in the team (default: 5)
- * @param params.modelId - AI model ID for pricing model selection (default: 'claude-4.6')
- * @returns Business ROI metrics including savings and recommendations
- */
-declare function calculateBusinessROI(params: {
-    tokenWaste: number;
-    issues: {
-        severity: string;
-    }[];
-    developerCount?: number;
-    modelId?: string;
-}): {
-    /** Estimated monthly savings if issues are resolved */
-    monthlySavings: number;
-    /** Total developer hours gained per month */
-    productivityGainHours: number;
-    /** Projected total annual business value gained */
-    annualValue: number;
-};
-
-/**
- * Format currency value for display in console or reports.
- *
- * Handles small values with decimals and large values with 'k' suffix.
- *
- * @param cost Cost in USD
- * @returns Formatted currency string (e.g. "$0.50", "$500", "$1.2k")
- */
-declare function formatCost(cost: number): string;
-/**
- * Format time duration in hours for display in console or reports.
- *
- * Automatically switches between minutes, hours, and weeks based on magnitude.
- *
- * @param hours Number of hours
- * @returns Formatted duration string (e.g. "30min", "4.5h", "2.1 weeks")
- */
-declare function formatHours(hours: number): string;
-
-/**
- * Format AI acceptance rate as a human-readable percentage string.
- *
- * @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;
-/**
- * Generate a technical value chain map for a specific issue category.
- *
- * maps technical metrics (like duplication count) to business outcomes
- * by explaining the impact on AI models and developer workflow.
- *
- * @param params Issue information
- * @param params.issueType Unique identifier for the issue type
- * @param params.count Total occurrences of this issue
- * @param params.severity Severity level of the issues
- * @returns A structured technical value chain object
- */
-declare function generateValueChain(params: {
-    issueType: string;
-    count: number;
-    severity: 'critical' | 'major' | 'minor';
-}): TechnicalValueChain;
-
 /**
  * Factory for creating and managing language parsers.
  * Supports both singleton usage and multiple instances for test isolation.

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-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 Language, l as LanguageParser, m as ParseResult, N as NamingConvention, n as ExportInfo } from './client-Bdi4ty0v.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 './client-Bdi4ty0v.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';
@@ -702,6 +702,117 @@ declare function inferPatternType(keyword: string, name: string): string;
  */
 declare function extractCodeBlocks(file: string, content: string): CodeBlock[];
 
+/**
+ * Business Value Metrics Module.
+ *
+ * Provides business-aligned metrics that quantify ROI and survive technology changes.
+ *
+ * @lastUpdated 2026-03-18
+ */
+/**
+ * Historical score entry for trend tracking.
+ * Used to store and compare results across different points in time.
+ */
+interface ScoreHistoryEntry {
+    /** ISO timestamp of the scan */
+    timestamp: string;
+    /** Overall score (0-100) */
+    overallScore: number;
+    /** Breakdown of scores by tool */
+    breakdown: Record<string, number>;
+    /** Total number of issues detected */
+    totalIssues: number;
+    /** Total tokens analyzed */
+    totalTokens: number;
+}
+/**
+ * Trend analysis comparing current vs historical scores.
+ * Helps teams understand if their AI-readiness is improving or degrading.
+ */
+interface ScoreTrend {
+    /** Overall trend direction */
+    direction: 'improving' | 'stable' | 'degrading';
+    /** Percentage change in score over last 30 days */
+    change30Days: number;
+    /** Percentage change in score over last 90 days */
+    change90Days: number;
+    /** Rate of change (points per week) */
+    velocity: number;
+    /** Projected score in 30 days based on current velocity */
+    projectedScore: number;
+}
+/**
+ * Calculate Aggregate Business ROI from code analysis results.
+ *
+ * This high-level function combines token waste and productivity impact
+ * to produce a monthly and annual dollar value of the issues found.
+ *
+ * @param params - Parameters for ROI calculation
+ * @param params.tokenWaste - Estimated total tokens wasted on context inefficiencies
+ * @param params.issues - Array of issues with severity levels for productivity impact
+ * @param params.developerCount - Number of developers in the team (default: 5)
+ * @param params.modelId - AI model ID for pricing model selection (default: 'claude-4.6')
+ * @returns Business ROI metrics including savings and recommendations
+ */
+declare function calculateBusinessROI(params: {
+    tokenWaste: number;
+    issues: {
+        severity: string;
+    }[];
+    developerCount?: number;
+    modelId?: string;
+}): {
+    /** Estimated monthly savings if issues are resolved */
+    monthlySavings: number;
+    /** Total developer hours gained per month */
+    productivityGainHours: number;
+    /** Projected total annual business value gained */
+    annualValue: number;
+};
+/**
+ * Format currency value for display in console or reports.
+ *
+ * Handles small values with decimals and large values with 'k' suffix.
+ *
+ * @param cost Cost in USD
+ * @returns Formatted currency string (e.g. "$0.50", "$500", "$1.2k")
+ */
+declare function formatCost(cost: number): string;
+/**
+ * Format time duration in hours for display in console or reports.
+ *
+ * Automatically switches between minutes, hours, and weeks based on magnitude.
+ *
+ * @param hours Number of hours
+ * @returns Formatted duration string (e.g. "30min", "4.5h", "2.1 weeks")
+ */
+declare function formatHours(hours: number): string;
+
+/**
+ * Format AI acceptance rate as a human-readable percentage string.
+ *
+ * @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;
+/**
+ * Generate a technical value chain map for a specific issue category.
+ *
+ * maps technical metrics (like duplication count) to business outcomes
+ * by explaining the impact on AI models and developer workflow.
+ *
+ * @param params Issue information
+ * @param params.issueType Unique identifier for the issue type
+ * @param params.count Total occurrences of this issue
+ * @param params.severity Severity level of the issues
+ * @returns A structured technical value chain object
+ */
+declare function generateValueChain(params: {
+    issueType: string;
+    count: number;
+    severity: 'critical' | 'major' | 'minor';
+}): TechnicalValueChain;
+
 /**
  * AI model pricing presets for cost estimation.
  * Prices are input token costs per 1K tokens (USD), as of Q1 2026.
@@ -842,119 +953,6 @@ declare function calculateTechnicalValueChain(params: {
  */
 declare function calculateComprehensionDifficulty(contextBudget: number, importDepth: number, fragmentation: number, modelTier?: ModelContextTier | string): ComprehensionDifficulty;
 
-/**
- * Business Value Metrics Module.
- *
- * Provides business-aligned metrics that quantify ROI and survive technology changes.
- *
- * @lastUpdated 2026-03-18
- */
-
-/**
- * Historical score entry for trend tracking.
- * Used to store and compare results across different points in time.
- */
-interface ScoreHistoryEntry {
-    /** ISO timestamp of the scan */
-    timestamp: string;
-    /** Overall score (0-100) */
-    overallScore: number;
-    /** Breakdown of scores by tool */
-    breakdown: Record<string, number>;
-    /** Total number of issues detected */
-    totalIssues: number;
-    /** Total tokens analyzed */
-    totalTokens: number;
-}
-/**
- * Trend analysis comparing current vs historical scores.
- * Helps teams understand if their AI-readiness is improving or degrading.
- */
-interface ScoreTrend {
-    /** Overall trend direction */
-    direction: 'improving' | 'stable' | 'degrading';
-    /** Percentage change in score over last 30 days */
-    change30Days: number;
-    /** Percentage change in score over last 90 days */
-    change90Days: number;
-    /** Rate of change (points per week) */
-    velocity: number;
-    /** Projected score in 30 days based on current velocity */
-    projectedScore: number;
-}
-/**
- * Calculate Aggregate Business ROI from code analysis results.
- *
- * This high-level function combines token waste and productivity impact
- * to produce a monthly and annual dollar value of the issues found.
- *
- * @param params - Parameters for ROI calculation
- * @param params.tokenWaste - Estimated total tokens wasted on context inefficiencies
- * @param params.issues - Array of issues with severity levels for productivity impact
- * @param params.developerCount - Number of developers in the team (default: 5)
- * @param params.modelId - AI model ID for pricing model selection (default: 'claude-4.6')
- * @returns Business ROI metrics including savings and recommendations
- */
-declare function calculateBusinessROI(params: {
-    tokenWaste: number;
-    issues: {
-        severity: string;
-    }[];
-    developerCount?: number;
-    modelId?: string;
-}): {
-    /** Estimated monthly savings if issues are resolved */
-    monthlySavings: number;
-    /** Total developer hours gained per month */
-    productivityGainHours: number;
-    /** Projected total annual business value gained */
-    annualValue: number;
-};
-
-/**
- * Format currency value for display in console or reports.
- *
- * Handles small values with decimals and large values with 'k' suffix.
- *
- * @param cost Cost in USD
- * @returns Formatted currency string (e.g. "$0.50", "$500", "$1.2k")
- */
-declare function formatCost(cost: number): string;
-/**
- * Format time duration in hours for display in console or reports.
- *
- * Automatically switches between minutes, hours, and weeks based on magnitude.
- *
- * @param hours Number of hours
- * @returns Formatted duration string (e.g. "30min", "4.5h", "2.1 weeks")
- */
-declare function formatHours(hours: number): string;
-
-/**
- * Format AI acceptance rate as a human-readable percentage string.
- *
- * @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;
-/**
- * Generate a technical value chain map for a specific issue category.
- *
- * maps technical metrics (like duplication count) to business outcomes
- * by explaining the impact on AI models and developer workflow.
- *
- * @param params Issue information
- * @param params.issueType Unique identifier for the issue type
- * @param params.count Total occurrences of this issue
- * @param params.severity Severity level of the issues
- * @returns A structured technical value chain object
- */
-declare function generateValueChain(params: {
-    issueType: string;
-    count: number;
-    severity: 'critical' | 'major' | 'minor';
-}): TechnicalValueChain;
-
 /**
  * Factory for creating and managing language parsers.
  * Supports both singleton usage and multiple instances for test isolation.