@aiready/core 0.21.15 → 0.21.17

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/README.md CHANGED
@@ -28,7 +28,11 @@ Legend:
28
28
 
29
29
  ## Overview
30
30
 
31
- This package provides common utilities, type definitions, and helper functions used across all AIReady tools. It's designed as a foundational library for building code analysis tools focused on AI-readiness.
31
+ This package provides common utilities, type definitions, and the multi-language parser factory used across all AIReady tools. It's designed as a foundational library for building code analysis tools focused on AI-readiness.
32
+
33
+ ### Language Support
34
+
35
+ Supports **TypeScript, JavaScript, Python, Java, Go, and C#**.
32
36
 
33
37
  ## License
34
38
 
package/dist/client.d.mts CHANGED
@@ -685,8 +685,20 @@ interface ExportInfo {
685
685
  parentClass?: string;
686
686
  /** For functions/methods: parameters */
687
687
  parameters?: string[];
688
+ /** For classes/interfaces: number of methods and properties */
689
+ methodCount?: number;
690
+ propertyCount?: number;
688
691
  /** Visibility (public, private, protected) */
689
692
  visibility?: 'public' | 'private' | 'protected';
693
+ /** Behavioral metadata for advanced metrics */
694
+ isPure?: boolean;
695
+ hasSideEffects?: boolean;
696
+ /** Associated documentation */
697
+ documentation?: {
698
+ content: string;
699
+ type: 'jsdoc' | 'docstring' | 'comment' | 'xml-doc';
700
+ isStale?: boolean;
701
+ };
690
702
  }
691
703
  /**
692
704
  * Import information
@@ -771,6 +783,18 @@ interface LanguageParser {
771
783
  * @param filePath - File path to check
772
784
  */
773
785
  canHandle(filePath: string): boolean;
786
+ /**
787
+ * Get the raw AST for advanced querying
788
+ * @param code - Source code to parse
789
+ * @param filePath - Path to the file
790
+ */
791
+ getAST(code: string, filePath: string): Promise<any>;
792
+ /**
793
+ * Analyze structural metadata for a node (e.g. purity)
794
+ * @param node - The AST node to analyze (language specific)
795
+ * @param code - The original source code
796
+ */
797
+ analyzeMetadata(node: any, code: string): Partial<ExportInfo>;
774
798
  }
775
799
  /**
776
800
  * Parser error with location information
package/dist/client.d.ts CHANGED
@@ -685,8 +685,20 @@ interface ExportInfo {
685
685
  parentClass?: string;
686
686
  /** For functions/methods: parameters */
687
687
  parameters?: string[];
688
+ /** For classes/interfaces: number of methods and properties */
689
+ methodCount?: number;
690
+ propertyCount?: number;
688
691
  /** Visibility (public, private, protected) */
689
692
  visibility?: 'public' | 'private' | 'protected';
693
+ /** Behavioral metadata for advanced metrics */
694
+ isPure?: boolean;
695
+ hasSideEffects?: boolean;
696
+ /** Associated documentation */
697
+ documentation?: {
698
+ content: string;
699
+ type: 'jsdoc' | 'docstring' | 'comment' | 'xml-doc';
700
+ isStale?: boolean;
701
+ };
690
702
  }
691
703
  /**
692
704
  * Import information
@@ -771,6 +783,18 @@ interface LanguageParser {
771
783
  * @param filePath - File path to check
772
784
  */
773
785
  canHandle(filePath: string): boolean;
786
+ /**
787
+ * Get the raw AST for advanced querying
788
+ * @param code - Source code to parse
789
+ * @param filePath - Path to the file
790
+ */
791
+ getAST(code: string, filePath: string): Promise<any>;
792
+ /**
793
+ * Analyze structural metadata for a node (e.g. purity)
794
+ * @param node - The AST node to analyze (language specific)
795
+ * @param code - The original source code
796
+ */
797
+ analyzeMetadata(node: any, code: string): Partial<ExportInfo>;
774
798
  }
775
799
  /**
776
800
  * Parser error with location information
package/dist/index.d.mts CHANGED
@@ -1,6 +1,8 @@
1
- import { ToolName, ScanOptions, SpokeOutput, ToolScoringOutput, AIReadyConfig, ModelContextTier, CostConfig, TokenBudget, ProductivityImpact, AcceptancePrediction, ComprehensionDifficulty, TechnicalValueChainSummary, TechnicalValueChain, LanguageParser, Language, ParseResult, NamingConvention } from './client.mjs';
2
- export { AnalysisResult, AnalysisResultSchema, AnalysisStatus, AnalysisStatusSchema, BusinessReport, COMMON_FINE_TUNING_OPTIONS, CONTEXT_TIER_THRESHOLDS, CommonASTNode, DEFAULT_TOOL_WEIGHTS, ExportInfo, 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';
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';
3
3
  import { z } from 'zod';
4
+ import { TSESTree } from '@typescript-eslint/typescript-estree';
5
+ import * as Parser from 'web-tree-sitter';
4
6
 
5
7
  /**
6
8
  * Spoke-to-Hub Contract Definitions
@@ -483,6 +485,8 @@ declare class TypeScriptParser implements LanguageParser {
483
485
  readonly language = Language.TypeScript;
484
486
  readonly extensions: string[];
485
487
  initialize(): Promise<void>;
488
+ getAST(code: string, filePath: string): Promise<TSESTree.Program>;
489
+ analyzeMetadata(node: TSESTree.Node, code: string): Partial<ExportInfo>;
486
490
  parse(code: string, filePath: string): ParseResult;
487
491
  getNamingConventions(): NamingConvention;
488
492
  canHandle(filePath: string): boolean;
@@ -503,6 +507,8 @@ declare class PythonParser implements LanguageParser {
503
507
  * Initialize the tree-sitter parser
504
508
  */
505
509
  initialize(): Promise<void>;
510
+ getAST(code: string, filePath: string): Promise<Parser.Tree | null>;
511
+ analyzeMetadata(node: Parser.Node, code: string): Partial<ExportInfo>;
506
512
  parse(code: string, filePath: string): ParseResult;
507
513
  private extractImportsAST;
508
514
  private extractExportsAST;
@@ -514,6 +520,78 @@ declare class PythonParser implements LanguageParser {
514
520
  private extractExportsRegex;
515
521
  }
516
522
 
523
+ /**
524
+ * Java Parser implementation using tree-sitter
525
+ */
526
+ declare class JavaParser implements LanguageParser {
527
+ readonly language = Language.Java;
528
+ readonly extensions: string[];
529
+ private parser;
530
+ private initialized;
531
+ /**
532
+ * Initialize the tree-sitter parser
533
+ */
534
+ initialize(): Promise<void>;
535
+ getAST(code: string, filePath: string): Promise<Parser.Tree | null>;
536
+ analyzeMetadata(node: Parser.Node, code: string): Partial<ExportInfo>;
537
+ parse(code: string, filePath: string): ParseResult;
538
+ private parseRegex;
539
+ private extractImportsAST;
540
+ private extractExportsAST;
541
+ private getModifiers;
542
+ private extractSubExports;
543
+ private extractParameters;
544
+ getNamingConventions(): NamingConvention;
545
+ canHandle(filePath: string): boolean;
546
+ }
547
+
548
+ /**
549
+ * C# Parser implementation using tree-sitter
550
+ */
551
+ declare class CSharpParser implements LanguageParser {
552
+ readonly language = Language.CSharp;
553
+ readonly extensions: string[];
554
+ private parser;
555
+ private initialized;
556
+ /**
557
+ * Initialize the tree-sitter parser
558
+ */
559
+ initialize(): Promise<void>;
560
+ getAST(code: string, filePath: string): Promise<Parser.Tree | null>;
561
+ analyzeMetadata(node: Parser.Node, code: string): Partial<ExportInfo>;
562
+ parse(code: string, filePath: string): ParseResult;
563
+ private parseRegex;
564
+ private extractImportsAST;
565
+ private extractExportsAST;
566
+ private getModifiers;
567
+ private extractParameters;
568
+ getNamingConventions(): NamingConvention;
569
+ canHandle(filePath: string): boolean;
570
+ }
571
+
572
+ /**
573
+ * Go Parser implementation using tree-sitter
574
+ */
575
+ declare class GoParser implements LanguageParser {
576
+ readonly language = Language.Go;
577
+ readonly extensions: string[];
578
+ private parser;
579
+ private initialized;
580
+ /**
581
+ * Initialize the tree-sitter parser
582
+ */
583
+ initialize(): Promise<void>;
584
+ getAST(code: string, filePath: string): Promise<Parser.Tree | null>;
585
+ analyzeMetadata(node: Parser.Node, code: string): Partial<ExportInfo>;
586
+ parse(code: string, filePath: string): ParseResult;
587
+ private parseRegex;
588
+ private extractImportsAST;
589
+ private extractExportsAST;
590
+ private extractParameters;
591
+ getNamingConventions(): NamingConvention;
592
+ canHandle(filePath: string): boolean;
593
+ }
594
+
517
595
  /**
518
596
  * Cognitive Load Metrics
519
597
  * Measures how much mental effort is required for an AI to understand a file.
@@ -845,4 +923,4 @@ declare function getRepoMetadata(directory: string): {
845
923
  author?: string;
846
924
  };
847
925
 
848
- export { AIReadyConfig, type ASTNode, AcceptancePrediction, type AgentGroundingScore, type AiSignalClarity, type AiSignalClaritySignal, type CLIOptions, type ChangeAmplificationScore, type CognitiveLoad, ComprehensionDifficulty, type ConceptCohesion, CostConfig, DEFAULT_COST_CONFIG, DEFAULT_EXCLUDE, type DependencyHealthScore, type DocDriftRisk, type ExportWithImports, type FileImport, type FileWithDomain, 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, handleCLIError, handleJSONOutput, initializeParsers, isFileSupported, isSourceFile, loadConfig, loadMergedConfig, loadScoreHistory, mergeConfigWithDefaults, parseCode, parseFileExports, predictAcceptanceRate, readFileContent, resolveOutputPath, saveScoreEntry, scanEntries, scanFiles, validateSpokeOutput, validateWithSchema };
926
+ 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, handleCLIError, handleJSONOutput, initializeParsers, isFileSupported, isSourceFile, loadConfig, loadMergedConfig, loadScoreHistory, mergeConfigWithDefaults, parseCode, parseFileExports, predictAcceptanceRate, readFileContent, resolveOutputPath, saveScoreEntry, scanEntries, scanFiles, validateSpokeOutput, validateWithSchema };
package/dist/index.d.ts CHANGED
@@ -1,6 +1,8 @@
1
- import { ToolName, ScanOptions, SpokeOutput, ToolScoringOutput, AIReadyConfig, ModelContextTier, CostConfig, TokenBudget, ProductivityImpact, AcceptancePrediction, ComprehensionDifficulty, TechnicalValueChainSummary, TechnicalValueChain, LanguageParser, Language, ParseResult, NamingConvention } from './client.js';
2
- export { AnalysisResult, AnalysisResultSchema, AnalysisStatus, AnalysisStatusSchema, BusinessReport, COMMON_FINE_TUNING_OPTIONS, CONTEXT_TIER_THRESHOLDS, CommonASTNode, DEFAULT_TOOL_WEIGHTS, ExportInfo, 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';
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';
3
3
  import { z } from 'zod';
4
+ import { TSESTree } from '@typescript-eslint/typescript-estree';
5
+ import * as Parser from 'web-tree-sitter';
4
6
 
5
7
  /**
6
8
  * Spoke-to-Hub Contract Definitions
@@ -483,6 +485,8 @@ declare class TypeScriptParser implements LanguageParser {
483
485
  readonly language = Language.TypeScript;
484
486
  readonly extensions: string[];
485
487
  initialize(): Promise<void>;
488
+ getAST(code: string, filePath: string): Promise<TSESTree.Program>;
489
+ analyzeMetadata(node: TSESTree.Node, code: string): Partial<ExportInfo>;
486
490
  parse(code: string, filePath: string): ParseResult;
487
491
  getNamingConventions(): NamingConvention;
488
492
  canHandle(filePath: string): boolean;
@@ -503,6 +507,8 @@ declare class PythonParser implements LanguageParser {
503
507
  * Initialize the tree-sitter parser
504
508
  */
505
509
  initialize(): Promise<void>;
510
+ getAST(code: string, filePath: string): Promise<Parser.Tree | null>;
511
+ analyzeMetadata(node: Parser.Node, code: string): Partial<ExportInfo>;
506
512
  parse(code: string, filePath: string): ParseResult;
507
513
  private extractImportsAST;
508
514
  private extractExportsAST;
@@ -514,6 +520,78 @@ declare class PythonParser implements LanguageParser {
514
520
  private extractExportsRegex;
515
521
  }
516
522
 
523
+ /**
524
+ * Java Parser implementation using tree-sitter
525
+ */
526
+ declare class JavaParser implements LanguageParser {
527
+ readonly language = Language.Java;
528
+ readonly extensions: string[];
529
+ private parser;
530
+ private initialized;
531
+ /**
532
+ * Initialize the tree-sitter parser
533
+ */
534
+ initialize(): Promise<void>;
535
+ getAST(code: string, filePath: string): Promise<Parser.Tree | null>;
536
+ analyzeMetadata(node: Parser.Node, code: string): Partial<ExportInfo>;
537
+ parse(code: string, filePath: string): ParseResult;
538
+ private parseRegex;
539
+ private extractImportsAST;
540
+ private extractExportsAST;
541
+ private getModifiers;
542
+ private extractSubExports;
543
+ private extractParameters;
544
+ getNamingConventions(): NamingConvention;
545
+ canHandle(filePath: string): boolean;
546
+ }
547
+
548
+ /**
549
+ * C# Parser implementation using tree-sitter
550
+ */
551
+ declare class CSharpParser implements LanguageParser {
552
+ readonly language = Language.CSharp;
553
+ readonly extensions: string[];
554
+ private parser;
555
+ private initialized;
556
+ /**
557
+ * Initialize the tree-sitter parser
558
+ */
559
+ initialize(): Promise<void>;
560
+ getAST(code: string, filePath: string): Promise<Parser.Tree | null>;
561
+ analyzeMetadata(node: Parser.Node, code: string): Partial<ExportInfo>;
562
+ parse(code: string, filePath: string): ParseResult;
563
+ private parseRegex;
564
+ private extractImportsAST;
565
+ private extractExportsAST;
566
+ private getModifiers;
567
+ private extractParameters;
568
+ getNamingConventions(): NamingConvention;
569
+ canHandle(filePath: string): boolean;
570
+ }
571
+
572
+ /**
573
+ * Go Parser implementation using tree-sitter
574
+ */
575
+ declare class GoParser implements LanguageParser {
576
+ readonly language = Language.Go;
577
+ readonly extensions: string[];
578
+ private parser;
579
+ private initialized;
580
+ /**
581
+ * Initialize the tree-sitter parser
582
+ */
583
+ initialize(): Promise<void>;
584
+ getAST(code: string, filePath: string): Promise<Parser.Tree | null>;
585
+ analyzeMetadata(node: Parser.Node, code: string): Partial<ExportInfo>;
586
+ parse(code: string, filePath: string): ParseResult;
587
+ private parseRegex;
588
+ private extractImportsAST;
589
+ private extractExportsAST;
590
+ private extractParameters;
591
+ getNamingConventions(): NamingConvention;
592
+ canHandle(filePath: string): boolean;
593
+ }
594
+
517
595
  /**
518
596
  * Cognitive Load Metrics
519
597
  * Measures how much mental effort is required for an AI to understand a file.
@@ -845,4 +923,4 @@ declare function getRepoMetadata(directory: string): {
845
923
  author?: string;
846
924
  };
847
925
 
848
- export { AIReadyConfig, type ASTNode, AcceptancePrediction, type AgentGroundingScore, type AiSignalClarity, type AiSignalClaritySignal, type CLIOptions, type ChangeAmplificationScore, type CognitiveLoad, ComprehensionDifficulty, type ConceptCohesion, CostConfig, DEFAULT_COST_CONFIG, DEFAULT_EXCLUDE, type DependencyHealthScore, type DocDriftRisk, type ExportWithImports, type FileImport, type FileWithDomain, 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, handleCLIError, handleJSONOutput, initializeParsers, isFileSupported, isSourceFile, loadConfig, loadMergedConfig, loadScoreHistory, mergeConfigWithDefaults, parseCode, parseFileExports, predictAcceptanceRate, readFileContent, resolveOutputPath, saveScoreEntry, scanEntries, scanFiles, validateSpokeOutput, validateWithSchema };
926
+ 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, handleCLIError, handleJSONOutput, initializeParsers, isFileSupported, isSourceFile, loadConfig, loadMergedConfig, loadScoreHistory, mergeConfigWithDefaults, parseCode, parseFileExports, predictAcceptanceRate, readFileContent, resolveOutputPath, saveScoreEntry, scanEntries, scanFiles, validateSpokeOutput, validateWithSchema };