@aiready/core 0.21.18 → 0.22.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.mts CHANGED
@@ -1,5 +1,5 @@
1
1
  import { ToolName, ScanOptions, SpokeOutput, ToolScoringOutput, AIReadyConfig, ModelContextTier, CostConfig, TokenBudget, ProductivityImpact, AcceptancePrediction, ComprehensionDifficulty, TechnicalValueChainSummary, TechnicalValueChain, LanguageParser, Language, ExportInfo, ParseResult, NamingConvention } from './client.mjs';
2
- export { AnalysisResult, AnalysisResultSchema, AnalysisStatus, AnalysisStatusSchema, BusinessReport, COMMON_FINE_TUNING_OPTIONS, CONTEXT_TIER_THRESHOLDS, CommonASTNode, DEFAULT_TOOL_WEIGHTS, FRIENDLY_TOOL_NAMES, GLOBAL_INFRA_OPTIONS, GLOBAL_SCAN_OPTIONS, GraphData, GraphEdge, GraphIssueSeverity, GraphMetadata, GraphNode, ImportInfo, Issue, IssueSchema, IssueType, IssueTypeSchema, LANGUAGE_EXTENSIONS, LanguageConfig, Location, LocationSchema, Metrics, MetricsSchema, ModelTier, ModelTierSchema, ParseError, ParseStatistics, Report, SIZE_ADJUSTED_THRESHOLDS, ScoringConfig, ScoringResult, Severity, SeveritySchema, SourceLocation, SourceRange, SpokeOutputSchema, SpokeSummary, SpokeSummarySchema, TOOL_NAME_MAP, ToolNameSchema, UnifiedReport, UnifiedReportSchema, calculateOverallScore, formatScore, formatToolScore, generateHTML, getProjectSizeTier, getRating, getRatingDisplay, getRatingWithContext, getRecommendedThreshold, getToolWeight, normalizeToolName, parseWeightString } from './client.mjs';
2
+ export { AiSignalClarityConfig, AnalysisResult, AnalysisResultSchema, AnalysisStatus, AnalysisStatusSchema, BaseToolConfig, BusinessReport, COMMON_FINE_TUNING_OPTIONS, CONTEXT_TIER_THRESHOLDS, CommonASTNode, ContextAnalyzerConfig, DEFAULT_TOOL_WEIGHTS, FRIENDLY_TOOL_NAMES, GLOBAL_INFRA_OPTIONS, GLOBAL_SCAN_OPTIONS, GraphData, GraphEdge, GraphIssueSeverity, GraphMetadata, GraphNode, ImportInfo, Issue, IssueSchema, IssueType, IssueTypeSchema, LANGUAGE_EXTENSIONS, LanguageConfig, Location, LocationSchema, Metrics, MetricsSchema, ModelTier, ModelTierSchema, NamingConsistencyConfig, ParseError, ParseStatistics, PatternDetectConfig, ReadinessRating, RecommendationPriority, Report, SIZE_ADJUSTED_THRESHOLDS, ScoringConfig, ScoringResult, Severity, SeveritySchema, SourceLocation, SourceRange, SpokeOutputSchema, SpokeSummary, SpokeSummarySchema, TOOL_NAME_MAP, ToolNameSchema, UnifiedReport, UnifiedReportSchema, calculateOverallScore, formatScore, formatToolScore, generateHTML, getProjectSizeTier, getRating, getRatingDisplay, getRatingWithContext, getRecommendedThreshold, getToolWeight, normalizeToolName, parseWeightString } from './client.mjs';
3
3
  import { z } from 'zod';
4
4
  import * as Parser from 'web-tree-sitter';
5
5
  import { TSESTree } from '@typescript-eslint/typescript-estree';
@@ -48,33 +48,78 @@ declare function validateWithSchema<T>(schema: z.ZodSchema<T>, data: any): {
48
48
  *
49
49
  * Central registry for all analysis tools. Decouples the CLI from
50
50
  * individual tool packages and allows for easier extension.
51
+ *
52
+ * Supports both singleton usage and multiple instances for test isolation.
51
53
  */
52
54
  declare class ToolRegistry {
53
- private static getProviders;
54
- static instanceId: number;
55
+ private providers;
56
+ readonly id: string;
57
+ /**
58
+ * Create a new ToolRegistry instance
59
+ *
60
+ * @param id Optional identifier for the registry (e.g. for debugging)
61
+ */
62
+ constructor(id?: string);
55
63
  /**
56
64
  * Register a new tool provider.
65
+ *
66
+ * @param provider The tool provider to register
57
67
  */
58
- static register(provider: ToolProvider): void;
68
+ register(provider: ToolProvider): void;
59
69
  /**
60
70
  * Get a provider by its canonical ID.
71
+ *
72
+ * @param id The tool ID
73
+ * @returns The provider if found
61
74
  */
62
- static get(id: ToolName): ToolProvider | undefined;
75
+ get(id: ToolName): ToolProvider | undefined;
63
76
  /**
64
77
  * Get a provider by name or alias.
78
+ *
79
+ * @param nameOrAlias The tool name or alias string
80
+ * @returns The provider if found
65
81
  */
66
- static find(nameOrAlias: string): ToolProvider | undefined;
82
+ find(nameOrAlias: string): ToolProvider | undefined;
67
83
  /**
68
84
  * Get all registered tool providers.
85
+ *
86
+ * @returns Array of all registered tool providers
69
87
  */
70
- static getAll(): ToolProvider[];
88
+ getAll(): ToolProvider[];
71
89
  /**
72
90
  * Get all available tool IDs from the ToolName enum.
91
+ *
92
+ * @returns Array of valid ToolName identifiers
73
93
  */
74
- static getAvailableIds(): ToolName[];
94
+ getAvailableIds(): ToolName[];
75
95
  /**
76
96
  * Clear the registry (primarily for testing).
77
97
  */
98
+ clear(): void;
99
+ private static getGlobalRegistry;
100
+ /**
101
+ * Static register (Singleton compatibility)
102
+ */
103
+ static register(provider: ToolProvider): void;
104
+ /**
105
+ * Static get (Singleton compatibility)
106
+ */
107
+ static get(id: ToolName): ToolProvider | undefined;
108
+ /**
109
+ * Static find (Singleton compatibility)
110
+ */
111
+ static find(nameOrAlias: string): ToolProvider | undefined;
112
+ /**
113
+ * Static getAll (Singleton compatibility)
114
+ */
115
+ static getAll(): ToolProvider[];
116
+ /**
117
+ * Static getAvailableIds (Singleton compatibility)
118
+ */
119
+ static getAvailableIds(): ToolName[];
120
+ /**
121
+ * Static clear (Singleton compatibility)
122
+ */
78
123
  static clear(): void;
79
124
  }
80
125
 
@@ -240,7 +285,6 @@ declare function getModelPreset(modelId: string): ModelPricingPreset;
240
285
  declare const DEFAULT_COST_CONFIG: CostConfig;
241
286
  /**
242
287
  * Calculate estimated monthly cost of AI context waste
243
- * @deprecated Since v0.13
244
288
  */
245
289
  declare function calculateMonthlyCost(tokenWaste: number, config?: Partial<CostConfig>): {
246
290
  total: number;
@@ -406,15 +450,22 @@ declare function generateValueChain(params: {
406
450
  */
407
451
 
408
452
  /**
409
- * Factory for creating and managing language parsers
453
+ * Factory for creating and managing language parsers.
454
+ *
455
+ * Supports both singleton usage and multiple instances for test isolation.
410
456
  */
411
457
  declare class ParserFactory {
412
458
  private static instance;
413
459
  private parsers;
414
460
  private extensionMap;
415
- private constructor();
416
461
  /**
417
- * Get singleton instance
462
+ * Create a new ParserFactory instance
463
+ */
464
+ constructor();
465
+ /**
466
+ * Get the global singleton instance
467
+ *
468
+ * @returns The singleton ParserFactory instance
418
469
  */
419
470
  static getInstance(): ParserFactory;
420
471
  /**
@@ -718,6 +769,7 @@ declare function calculateAiSignalClarity(params: {
718
769
  deepCallbacks: number;
719
770
  ambiguousNames: number;
720
771
  undocumentedExports: number;
772
+ largeFiles?: number;
721
773
  totalSymbols: number;
722
774
  totalExports: number;
723
775
  }): AiSignalClarity;
@@ -936,4 +988,28 @@ declare function getRepoMetadata(directory: string): {
936
988
  author?: string;
937
989
  };
938
990
 
939
- export { AIReadyConfig, type ASTNode, AcceptancePrediction, type AgentGroundingScore, type AiSignalClarity, type AiSignalClaritySignal, type CLIOptions, CSharpParser, type ChangeAmplificationScore, type CognitiveLoad, ComprehensionDifficulty, type ConceptCohesion, CostConfig, DEFAULT_COST_CONFIG, DEFAULT_EXCLUDE, type DependencyHealthScore, type DocDriftRisk, ExportInfo, type ExportWithImports, type FileImport, type FileWithDomain, GoParser, JavaParser, type KnowledgeConcentrationRisk, Language, LanguageParser, type LoadFactor, MODEL_PRICING_PRESETS, ModelContextTier, type ModelPricingPreset, NamingConvention, ParseResult, ParserFactory, type PatternEntropy, ProductivityImpact, PythonParser, SEVERITY_TIME_ESTIMATES, ScanOptions, type ScoreHistoryEntry, type ScoreTrend, type SemanticDistance, SpokeOutput, type TechnicalDebtInterest, TechnicalValueChain, TechnicalValueChainSummary, type TestabilityIndex, TokenBudget, ToolName, type ToolProvider, ToolRegistry, ToolScoringOutput, TypeScriptParser, VAGUE_FILE_NAMES, calculateAgentGrounding, calculateAiSignalClarity, calculateBusinessROI, calculateChangeAmplification, calculateCognitiveLoad, calculateComprehensionDifficulty, calculateConceptCohesion, calculateDebtInterest, calculateDependencyHealth, calculateDocDrift, calculateExtendedFutureProofScore, calculateFutureProofScore, calculateImportSimilarity, calculateKnowledgeConcentration, calculateMonthlyCost, calculatePatternEntropy, calculateProductivityImpact, calculateSemanticDistance, calculateTechnicalValueChain, calculateTestabilityIndex, calculateTokenBudget, clearHistory, emitProgress, estimateCostFromBudget, estimateTokens, exportHistory, extractFunctions, extractImports, formatAcceptanceRate, formatCost, formatHours, generateValueChain, getElapsedTime, getFileCommitTimestamps, getFileExtension, getHistorySummary, getLineRangeLastModifiedCached, getModelPreset, getParser, getRepoMetadata, getSafetyIcon, getScoreBar, getSeverityColor, getSupportedLanguages, getWasmPath, handleCLIError, handleJSONOutput, initTreeSitter, initializeParsers, isFileSupported, isSourceFile, loadConfig, loadMergedConfig, loadScoreHistory, mergeConfigWithDefaults, parseCode, parseFileExports, predictAcceptanceRate, readFileContent, resolveOutputPath, saveScoreEntry, scanEntries, scanFiles, setupParser, validateSpokeOutput, validateWithSchema };
991
+ /**
992
+ * Utilities for GitHub Actions integration
993
+ */
994
+ /**
995
+ * Emit a GitHub Action annotation
996
+ * Format: ::(error|warning|notice) file={file},line={line},col={col},title={title}::{message}
997
+ */
998
+ declare function emitAnnotation(params: {
999
+ level: 'error' | 'warning' | 'notice';
1000
+ file: string;
1001
+ line?: number;
1002
+ col?: number;
1003
+ title?: string;
1004
+ message: string;
1005
+ }): void;
1006
+ /**
1007
+ * Map AIReady severity to GitHub Action annotation level
1008
+ */
1009
+ declare function severityToAnnotationLevel(severity: string): 'error' | 'warning' | 'notice';
1010
+ /**
1011
+ * Emit multiple annotations from an array of issues
1012
+ */
1013
+ declare function emitIssuesAsAnnotations(issues: any[]): void;
1014
+
1015
+ export { AIReadyConfig, type ASTNode, AcceptancePrediction, type AgentGroundingScore, type AiSignalClarity, type AiSignalClaritySignal, type CLIOptions, CSharpParser, type ChangeAmplificationScore, type CognitiveLoad, ComprehensionDifficulty, type ConceptCohesion, CostConfig, DEFAULT_COST_CONFIG, DEFAULT_EXCLUDE, type DependencyHealthScore, type DocDriftRisk, ExportInfo, type ExportWithImports, type FileImport, type FileWithDomain, GoParser, JavaParser, type KnowledgeConcentrationRisk, Language, LanguageParser, type LoadFactor, MODEL_PRICING_PRESETS, ModelContextTier, type ModelPricingPreset, NamingConvention, ParseResult, ParserFactory, type PatternEntropy, ProductivityImpact, PythonParser, SEVERITY_TIME_ESTIMATES, ScanOptions, type ScoreHistoryEntry, type ScoreTrend, type SemanticDistance, SpokeOutput, type TechnicalDebtInterest, TechnicalValueChain, TechnicalValueChainSummary, type TestabilityIndex, TokenBudget, ToolName, type ToolProvider, ToolRegistry, ToolScoringOutput, TypeScriptParser, VAGUE_FILE_NAMES, calculateAgentGrounding, calculateAiSignalClarity, calculateBusinessROI, calculateChangeAmplification, calculateCognitiveLoad, calculateComprehensionDifficulty, calculateConceptCohesion, calculateDebtInterest, calculateDependencyHealth, calculateDocDrift, calculateExtendedFutureProofScore, calculateFutureProofScore, calculateImportSimilarity, calculateKnowledgeConcentration, calculateMonthlyCost, calculatePatternEntropy, calculateProductivityImpact, calculateSemanticDistance, calculateTechnicalValueChain, calculateTestabilityIndex, calculateTokenBudget, clearHistory, emitAnnotation, emitIssuesAsAnnotations, emitProgress, estimateCostFromBudget, estimateTokens, exportHistory, extractFunctions, extractImports, formatAcceptanceRate, formatCost, formatHours, generateValueChain, getElapsedTime, getFileCommitTimestamps, getFileExtension, getHistorySummary, getLineRangeLastModifiedCached, getModelPreset, getParser, getRepoMetadata, getSafetyIcon, getScoreBar, getSeverityColor, getSupportedLanguages, getWasmPath, handleCLIError, handleJSONOutput, initTreeSitter, initializeParsers, isFileSupported, isSourceFile, loadConfig, loadMergedConfig, loadScoreHistory, mergeConfigWithDefaults, parseCode, parseFileExports, predictAcceptanceRate, readFileContent, resolveOutputPath, saveScoreEntry, scanEntries, scanFiles, setupParser, severityToAnnotationLevel, validateSpokeOutput, validateWithSchema };
package/dist/index.d.ts CHANGED
@@ -1,5 +1,5 @@
1
1
  import { ToolName, ScanOptions, SpokeOutput, ToolScoringOutput, AIReadyConfig, ModelContextTier, CostConfig, TokenBudget, ProductivityImpact, AcceptancePrediction, ComprehensionDifficulty, TechnicalValueChainSummary, TechnicalValueChain, LanguageParser, Language, ExportInfo, ParseResult, NamingConvention } from './client.js';
2
- export { AnalysisResult, AnalysisResultSchema, AnalysisStatus, AnalysisStatusSchema, BusinessReport, COMMON_FINE_TUNING_OPTIONS, CONTEXT_TIER_THRESHOLDS, CommonASTNode, DEFAULT_TOOL_WEIGHTS, FRIENDLY_TOOL_NAMES, GLOBAL_INFRA_OPTIONS, GLOBAL_SCAN_OPTIONS, GraphData, GraphEdge, GraphIssueSeverity, GraphMetadata, GraphNode, ImportInfo, Issue, IssueSchema, IssueType, IssueTypeSchema, LANGUAGE_EXTENSIONS, LanguageConfig, Location, LocationSchema, Metrics, MetricsSchema, ModelTier, ModelTierSchema, ParseError, ParseStatistics, Report, SIZE_ADJUSTED_THRESHOLDS, ScoringConfig, ScoringResult, Severity, SeveritySchema, SourceLocation, SourceRange, SpokeOutputSchema, SpokeSummary, SpokeSummarySchema, TOOL_NAME_MAP, ToolNameSchema, UnifiedReport, UnifiedReportSchema, calculateOverallScore, formatScore, formatToolScore, generateHTML, getProjectSizeTier, getRating, getRatingDisplay, getRatingWithContext, getRecommendedThreshold, getToolWeight, normalizeToolName, parseWeightString } from './client.js';
2
+ export { AiSignalClarityConfig, AnalysisResult, AnalysisResultSchema, AnalysisStatus, AnalysisStatusSchema, BaseToolConfig, BusinessReport, COMMON_FINE_TUNING_OPTIONS, CONTEXT_TIER_THRESHOLDS, CommonASTNode, ContextAnalyzerConfig, DEFAULT_TOOL_WEIGHTS, FRIENDLY_TOOL_NAMES, GLOBAL_INFRA_OPTIONS, GLOBAL_SCAN_OPTIONS, GraphData, GraphEdge, GraphIssueSeverity, GraphMetadata, GraphNode, ImportInfo, Issue, IssueSchema, IssueType, IssueTypeSchema, LANGUAGE_EXTENSIONS, LanguageConfig, Location, LocationSchema, Metrics, MetricsSchema, ModelTier, ModelTierSchema, NamingConsistencyConfig, ParseError, ParseStatistics, PatternDetectConfig, ReadinessRating, RecommendationPriority, Report, SIZE_ADJUSTED_THRESHOLDS, ScoringConfig, ScoringResult, Severity, SeveritySchema, SourceLocation, SourceRange, SpokeOutputSchema, SpokeSummary, SpokeSummarySchema, TOOL_NAME_MAP, ToolNameSchema, UnifiedReport, UnifiedReportSchema, calculateOverallScore, formatScore, formatToolScore, generateHTML, getProjectSizeTier, getRating, getRatingDisplay, getRatingWithContext, getRecommendedThreshold, getToolWeight, normalizeToolName, parseWeightString } from './client.js';
3
3
  import { z } from 'zod';
4
4
  import * as Parser from 'web-tree-sitter';
5
5
  import { TSESTree } from '@typescript-eslint/typescript-estree';
@@ -48,33 +48,78 @@ declare function validateWithSchema<T>(schema: z.ZodSchema<T>, data: any): {
48
48
  *
49
49
  * Central registry for all analysis tools. Decouples the CLI from
50
50
  * individual tool packages and allows for easier extension.
51
+ *
52
+ * Supports both singleton usage and multiple instances for test isolation.
51
53
  */
52
54
  declare class ToolRegistry {
53
- private static getProviders;
54
- static instanceId: number;
55
+ private providers;
56
+ readonly id: string;
57
+ /**
58
+ * Create a new ToolRegistry instance
59
+ *
60
+ * @param id Optional identifier for the registry (e.g. for debugging)
61
+ */
62
+ constructor(id?: string);
55
63
  /**
56
64
  * Register a new tool provider.
65
+ *
66
+ * @param provider The tool provider to register
57
67
  */
58
- static register(provider: ToolProvider): void;
68
+ register(provider: ToolProvider): void;
59
69
  /**
60
70
  * Get a provider by its canonical ID.
71
+ *
72
+ * @param id The tool ID
73
+ * @returns The provider if found
61
74
  */
62
- static get(id: ToolName): ToolProvider | undefined;
75
+ get(id: ToolName): ToolProvider | undefined;
63
76
  /**
64
77
  * Get a provider by name or alias.
78
+ *
79
+ * @param nameOrAlias The tool name or alias string
80
+ * @returns The provider if found
65
81
  */
66
- static find(nameOrAlias: string): ToolProvider | undefined;
82
+ find(nameOrAlias: string): ToolProvider | undefined;
67
83
  /**
68
84
  * Get all registered tool providers.
85
+ *
86
+ * @returns Array of all registered tool providers
69
87
  */
70
- static getAll(): ToolProvider[];
88
+ getAll(): ToolProvider[];
71
89
  /**
72
90
  * Get all available tool IDs from the ToolName enum.
91
+ *
92
+ * @returns Array of valid ToolName identifiers
73
93
  */
74
- static getAvailableIds(): ToolName[];
94
+ getAvailableIds(): ToolName[];
75
95
  /**
76
96
  * Clear the registry (primarily for testing).
77
97
  */
98
+ clear(): void;
99
+ private static getGlobalRegistry;
100
+ /**
101
+ * Static register (Singleton compatibility)
102
+ */
103
+ static register(provider: ToolProvider): void;
104
+ /**
105
+ * Static get (Singleton compatibility)
106
+ */
107
+ static get(id: ToolName): ToolProvider | undefined;
108
+ /**
109
+ * Static find (Singleton compatibility)
110
+ */
111
+ static find(nameOrAlias: string): ToolProvider | undefined;
112
+ /**
113
+ * Static getAll (Singleton compatibility)
114
+ */
115
+ static getAll(): ToolProvider[];
116
+ /**
117
+ * Static getAvailableIds (Singleton compatibility)
118
+ */
119
+ static getAvailableIds(): ToolName[];
120
+ /**
121
+ * Static clear (Singleton compatibility)
122
+ */
78
123
  static clear(): void;
79
124
  }
80
125
 
@@ -240,7 +285,6 @@ declare function getModelPreset(modelId: string): ModelPricingPreset;
240
285
  declare const DEFAULT_COST_CONFIG: CostConfig;
241
286
  /**
242
287
  * Calculate estimated monthly cost of AI context waste
243
- * @deprecated Since v0.13
244
288
  */
245
289
  declare function calculateMonthlyCost(tokenWaste: number, config?: Partial<CostConfig>): {
246
290
  total: number;
@@ -406,15 +450,22 @@ declare function generateValueChain(params: {
406
450
  */
407
451
 
408
452
  /**
409
- * Factory for creating and managing language parsers
453
+ * Factory for creating and managing language parsers.
454
+ *
455
+ * Supports both singleton usage and multiple instances for test isolation.
410
456
  */
411
457
  declare class ParserFactory {
412
458
  private static instance;
413
459
  private parsers;
414
460
  private extensionMap;
415
- private constructor();
416
461
  /**
417
- * Get singleton instance
462
+ * Create a new ParserFactory instance
463
+ */
464
+ constructor();
465
+ /**
466
+ * Get the global singleton instance
467
+ *
468
+ * @returns The singleton ParserFactory instance
418
469
  */
419
470
  static getInstance(): ParserFactory;
420
471
  /**
@@ -718,6 +769,7 @@ declare function calculateAiSignalClarity(params: {
718
769
  deepCallbacks: number;
719
770
  ambiguousNames: number;
720
771
  undocumentedExports: number;
772
+ largeFiles?: number;
721
773
  totalSymbols: number;
722
774
  totalExports: number;
723
775
  }): AiSignalClarity;
@@ -936,4 +988,28 @@ declare function getRepoMetadata(directory: string): {
936
988
  author?: string;
937
989
  };
938
990
 
939
- export { AIReadyConfig, type ASTNode, AcceptancePrediction, type AgentGroundingScore, type AiSignalClarity, type AiSignalClaritySignal, type CLIOptions, CSharpParser, type ChangeAmplificationScore, type CognitiveLoad, ComprehensionDifficulty, type ConceptCohesion, CostConfig, DEFAULT_COST_CONFIG, DEFAULT_EXCLUDE, type DependencyHealthScore, type DocDriftRisk, ExportInfo, type ExportWithImports, type FileImport, type FileWithDomain, GoParser, JavaParser, type KnowledgeConcentrationRisk, Language, LanguageParser, type LoadFactor, MODEL_PRICING_PRESETS, ModelContextTier, type ModelPricingPreset, NamingConvention, ParseResult, ParserFactory, type PatternEntropy, ProductivityImpact, PythonParser, SEVERITY_TIME_ESTIMATES, ScanOptions, type ScoreHistoryEntry, type ScoreTrend, type SemanticDistance, SpokeOutput, type TechnicalDebtInterest, TechnicalValueChain, TechnicalValueChainSummary, type TestabilityIndex, TokenBudget, ToolName, type ToolProvider, ToolRegistry, ToolScoringOutput, TypeScriptParser, VAGUE_FILE_NAMES, calculateAgentGrounding, calculateAiSignalClarity, calculateBusinessROI, calculateChangeAmplification, calculateCognitiveLoad, calculateComprehensionDifficulty, calculateConceptCohesion, calculateDebtInterest, calculateDependencyHealth, calculateDocDrift, calculateExtendedFutureProofScore, calculateFutureProofScore, calculateImportSimilarity, calculateKnowledgeConcentration, calculateMonthlyCost, calculatePatternEntropy, calculateProductivityImpact, calculateSemanticDistance, calculateTechnicalValueChain, calculateTestabilityIndex, calculateTokenBudget, clearHistory, emitProgress, estimateCostFromBudget, estimateTokens, exportHistory, extractFunctions, extractImports, formatAcceptanceRate, formatCost, formatHours, generateValueChain, getElapsedTime, getFileCommitTimestamps, getFileExtension, getHistorySummary, getLineRangeLastModifiedCached, getModelPreset, getParser, getRepoMetadata, getSafetyIcon, getScoreBar, getSeverityColor, getSupportedLanguages, getWasmPath, handleCLIError, handleJSONOutput, initTreeSitter, initializeParsers, isFileSupported, isSourceFile, loadConfig, loadMergedConfig, loadScoreHistory, mergeConfigWithDefaults, parseCode, parseFileExports, predictAcceptanceRate, readFileContent, resolveOutputPath, saveScoreEntry, scanEntries, scanFiles, setupParser, validateSpokeOutput, validateWithSchema };
991
+ /**
992
+ * Utilities for GitHub Actions integration
993
+ */
994
+ /**
995
+ * Emit a GitHub Action annotation
996
+ * Format: ::(error|warning|notice) file={file},line={line},col={col},title={title}::{message}
997
+ */
998
+ declare function emitAnnotation(params: {
999
+ level: 'error' | 'warning' | 'notice';
1000
+ file: string;
1001
+ line?: number;
1002
+ col?: number;
1003
+ title?: string;
1004
+ message: string;
1005
+ }): void;
1006
+ /**
1007
+ * Map AIReady severity to GitHub Action annotation level
1008
+ */
1009
+ declare function severityToAnnotationLevel(severity: string): 'error' | 'warning' | 'notice';
1010
+ /**
1011
+ * Emit multiple annotations from an array of issues
1012
+ */
1013
+ declare function emitIssuesAsAnnotations(issues: any[]): void;
1014
+
1015
+ export { AIReadyConfig, type ASTNode, AcceptancePrediction, type AgentGroundingScore, type AiSignalClarity, type AiSignalClaritySignal, type CLIOptions, CSharpParser, type ChangeAmplificationScore, type CognitiveLoad, ComprehensionDifficulty, type ConceptCohesion, CostConfig, DEFAULT_COST_CONFIG, DEFAULT_EXCLUDE, type DependencyHealthScore, type DocDriftRisk, ExportInfo, type ExportWithImports, type FileImport, type FileWithDomain, GoParser, JavaParser, type KnowledgeConcentrationRisk, Language, LanguageParser, type LoadFactor, MODEL_PRICING_PRESETS, ModelContextTier, type ModelPricingPreset, NamingConvention, ParseResult, ParserFactory, type PatternEntropy, ProductivityImpact, PythonParser, SEVERITY_TIME_ESTIMATES, ScanOptions, type ScoreHistoryEntry, type ScoreTrend, type SemanticDistance, SpokeOutput, type TechnicalDebtInterest, TechnicalValueChain, TechnicalValueChainSummary, type TestabilityIndex, TokenBudget, ToolName, type ToolProvider, ToolRegistry, ToolScoringOutput, TypeScriptParser, VAGUE_FILE_NAMES, calculateAgentGrounding, calculateAiSignalClarity, calculateBusinessROI, calculateChangeAmplification, calculateCognitiveLoad, calculateComprehensionDifficulty, calculateConceptCohesion, calculateDebtInterest, calculateDependencyHealth, calculateDocDrift, calculateExtendedFutureProofScore, calculateFutureProofScore, calculateImportSimilarity, calculateKnowledgeConcentration, calculateMonthlyCost, calculatePatternEntropy, calculateProductivityImpact, calculateSemanticDistance, calculateTechnicalValueChain, calculateTestabilityIndex, calculateTokenBudget, clearHistory, emitAnnotation, emitIssuesAsAnnotations, emitProgress, estimateCostFromBudget, estimateTokens, exportHistory, extractFunctions, extractImports, formatAcceptanceRate, formatCost, formatHours, generateValueChain, getElapsedTime, getFileCommitTimestamps, getFileExtension, getHistorySummary, getLineRangeLastModifiedCached, getModelPreset, getParser, getRepoMetadata, getSafetyIcon, getScoreBar, getSeverityColor, getSupportedLanguages, getWasmPath, handleCLIError, handleJSONOutput, initTreeSitter, initializeParsers, isFileSupported, isSourceFile, loadConfig, loadMergedConfig, loadScoreHistory, mergeConfigWithDefaults, parseCode, parseFileExports, predictAcceptanceRate, readFileContent, resolveOutputPath, saveScoreEntry, scanEntries, scanFiles, setupParser, severityToAnnotationLevel, validateSpokeOutput, validateWithSchema };