@aiready/core 0.24.9 → 0.24.12

package/dist/index.d.mts

@@ -1,6 +1,7 @@
 import { T as ToolName, S as ScanOptions, a as SpokeOutput, b as ToolScoringOutput, c as Severity, d as ToolOptions, 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-DGbarGnr.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-DGbarGnr.mjs';
 import { z } from 'zod';
+import { Command } from 'commander';
 import * as chalk from 'chalk';
 import * as Parser from 'web-tree-sitter';
 import { TSESTree } from '@typescript-eslint/typescript-estree';
@@ -487,6 +488,25 @@ interface ProviderFactoryConfig<TReport> {
  */
 declare function createProvider<TReport>(config: ProviderFactoryConfig<TReport>): ToolProvider;
 
+/**
+ * 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 function calculateStringSimilarity(a: string, b: string): number;
+/**
+ * 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 calculateHeuristicConfidence(similarity: number, tokens: number, lines: number): number;
 /**
  * Calculate import-based similarity between two exports using Jaccard index.
  * Returns a score between 0 and 1 representing the overlap in imported symbols.
@@ -631,26 +651,12 @@ declare function buildFactorsFromDimensions(dimensions: Record<string, number>,
  */
 declare function buildStandardToolScore(params: StandardScoringParams): ToolScoringOutput;
 
-/**
- * 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 function calculateStringSimilarity(a: string, b: string): number;
-/**
- * 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 calculateHeuristicConfidence(similarity: number, tokens: number, lines: number): number;
-
+interface CommandOptions {
+    output?: string;
+    include?: string[];
+    exclude?: string[];
+    json?: boolean;
+}
 /**
  * Standard progress callback for AIReady spoke tools.
  * Unified to remove structural duplication across spokes.
@@ -673,6 +679,17 @@ declare function runStandardCliAction(toolName: string, action: () => Promise<{
     score: number;
     issuesCount: number;
 }>): Promise<void>;
+/**
+ * Factory to create standardized Commander commands for AIReady spokes.
+ * This avoids duplicating the same boilerplate (setup, options, error handling)
+ * across 10+ different analysis tools, addressing context fragmentation and duplication.
+ *
+ * @param name - The name of the command (e.g., 'scan', 'context')
+ * @param description - Command description for help text
+ * @param runAction - The actual analysis logic to execute
+ * @returns A configured Commander Command object
+ */
+declare function createStandardCommand(name: string, description: string, runAction: (options: CommandOptions) => Promise<any>): Command;
 
 /**
  * Interface for standard CLI report data
@@ -1993,4 +2010,4 @@ declare function isIgnorableSourceFile(filePath: string): boolean;
  */
 declare function isBuildArtifact(filePath: string): boolean;
 
-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, type HtmlReportSection, 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, TEST_PATTERNS, 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, detectTestFramework, displayStandardConsoleReport, emitAnnotation, emitIssuesAsAnnotations, emitProgress, ensureDir, estimateCostFromBudget, estimateTokens, executeSpokeCli, exportHistory, extractCodeBlocks, filterBySeverity, findLatestReport, findLatestScanReport, formatAcceptanceRate, formatCost, formatHours, formatStandardCliResult, formatStandardReport, generateCompleteReport, generateIssueSummary, generateReportFooter, generateReportHead, generateReportHero, generateStandardHtmlReport, generateStatCards, generateTable, generateValueChain, getElapsedTime, getFileCommitTimestamps, getFileExtension, getFilesByPattern, getHistorySummary, getLineRangeLastModifiedCached, getModelPreset, getParser, getRepoMetadata, getReportTimestamp, getSafetyIcon, getScoreBar, getScoreColor, getSeverityBadge, getSeverityColor, getSeverityEnum, getSeverityLabel, getSeverityLevel, getSeverityValue, getSupportedLanguages, getTerminalDivider, getWasmPath, groupIssuesByFile, handleCLIError, handleJSONOutput, handleStandardJSONOutput, inferPatternType, initTreeSitter, initializeParsers, isBuildArtifact, isFileSupported, isIgnorableSourceFile, isSourceFile, isTestFile, loadConfig, loadMergedConfig, loadScoreHistory, mergeConfigWithDefaults, normalizeAnalysisResult, normalizeIssue, normalizeMetrics, normalizeSeverity, normalizeSpokeOutput, parseFileExports, predictAcceptanceRate, prepareActionConfig, printTerminalHeader, readFileContent, resolveOutputFormat, resolveOutputPath, runBatchAnalysis, runStandardCliAction, 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, type HtmlReportSection, 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, TEST_PATTERNS, 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, createStandardCommand, createStandardProgressCallback, detectTestFramework, displayStandardConsoleReport, emitAnnotation, emitIssuesAsAnnotations, emitProgress, ensureDir, estimateCostFromBudget, estimateTokens, executeSpokeCli, exportHistory, extractCodeBlocks, filterBySeverity, findLatestReport, findLatestScanReport, formatAcceptanceRate, formatCost, formatHours, formatStandardCliResult, formatStandardReport, generateCompleteReport, generateIssueSummary, generateReportFooter, generateReportHead, generateReportHero, generateStandardHtmlReport, generateStatCards, generateTable, generateValueChain, getElapsedTime, getFileCommitTimestamps, getFileExtension, getFilesByPattern, getHistorySummary, getLineRangeLastModifiedCached, getModelPreset, getParser, getRepoMetadata, getReportTimestamp, getSafetyIcon, getScoreBar, getScoreColor, getSeverityBadge, getSeverityColor, getSeverityEnum, getSeverityLabel, getSeverityLevel, getSeverityValue, getSupportedLanguages, getTerminalDivider, getWasmPath, groupIssuesByFile, handleCLIError, handleJSONOutput, handleStandardJSONOutput, inferPatternType, initTreeSitter, initializeParsers, isBuildArtifact, isFileSupported, isIgnorableSourceFile, isSourceFile, isTestFile, loadConfig, loadMergedConfig, loadScoreHistory, mergeConfigWithDefaults, normalizeAnalysisResult, normalizeIssue, normalizeMetrics, normalizeSeverity, normalizeSpokeOutput, parseFileExports, predictAcceptanceRate, prepareActionConfig, printTerminalHeader, readFileContent, resolveOutputFormat, resolveOutputPath, runBatchAnalysis, runStandardCliAction, saveScoreEntry, scanEntries, scanFiles, setupParser, severityToAnnotationLevel, validateSpokeOutput, validateWithSchema, wrapInCard };

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 import { T as ToolName, S as ScanOptions, a as SpokeOutput, b as ToolScoringOutput, c as Severity, d as ToolOptions, 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-DGbarGnr.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-DGbarGnr.js';
 import { z } from 'zod';
+import { Command } from 'commander';
 import * as chalk from 'chalk';
 import * as Parser from 'web-tree-sitter';
 import { TSESTree } from '@typescript-eslint/typescript-estree';
@@ -487,6 +488,25 @@ interface ProviderFactoryConfig<TReport> {
  */
 declare function createProvider<TReport>(config: ProviderFactoryConfig<TReport>): ToolProvider;
 
+/**
+ * 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 function calculateStringSimilarity(a: string, b: string): number;
+/**
+ * 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 calculateHeuristicConfidence(similarity: number, tokens: number, lines: number): number;
 /**
  * Calculate import-based similarity between two exports using Jaccard index.
  * Returns a score between 0 and 1 representing the overlap in imported symbols.
@@ -631,26 +651,12 @@ declare function buildFactorsFromDimensions(dimensions: Record<string, number>,
  */
 declare function buildStandardToolScore(params: StandardScoringParams): ToolScoringOutput;
 
-/**
- * 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 function calculateStringSimilarity(a: string, b: string): number;
-/**
- * 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 calculateHeuristicConfidence(similarity: number, tokens: number, lines: number): number;
-
+interface CommandOptions {
+    output?: string;
+    include?: string[];
+    exclude?: string[];
+    json?: boolean;
+}
 /**
  * Standard progress callback for AIReady spoke tools.
  * Unified to remove structural duplication across spokes.
@@ -673,6 +679,17 @@ declare function runStandardCliAction(toolName: string, action: () => Promise<{
     score: number;
     issuesCount: number;
 }>): Promise<void>;
+/**
+ * Factory to create standardized Commander commands for AIReady spokes.
+ * This avoids duplicating the same boilerplate (setup, options, error handling)
+ * across 10+ different analysis tools, addressing context fragmentation and duplication.
+ *
+ * @param name - The name of the command (e.g., 'scan', 'context')
+ * @param description - Command description for help text
+ * @param runAction - The actual analysis logic to execute
+ * @returns A configured Commander Command object
+ */
+declare function createStandardCommand(name: string, description: string, runAction: (options: CommandOptions) => Promise<any>): Command;
 
 /**
  * Interface for standard CLI report data
@@ -1993,4 +2010,4 @@ declare function isIgnorableSourceFile(filePath: string): boolean;
  */
 declare function isBuildArtifact(filePath: string): boolean;
 
-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, type HtmlReportSection, 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, TEST_PATTERNS, 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, detectTestFramework, displayStandardConsoleReport, emitAnnotation, emitIssuesAsAnnotations, emitProgress, ensureDir, estimateCostFromBudget, estimateTokens, executeSpokeCli, exportHistory, extractCodeBlocks, filterBySeverity, findLatestReport, findLatestScanReport, formatAcceptanceRate, formatCost, formatHours, formatStandardCliResult, formatStandardReport, generateCompleteReport, generateIssueSummary, generateReportFooter, generateReportHead, generateReportHero, generateStandardHtmlReport, generateStatCards, generateTable, generateValueChain, getElapsedTime, getFileCommitTimestamps, getFileExtension, getFilesByPattern, getHistorySummary, getLineRangeLastModifiedCached, getModelPreset, getParser, getRepoMetadata, getReportTimestamp, getSafetyIcon, getScoreBar, getScoreColor, getSeverityBadge, getSeverityColor, getSeverityEnum, getSeverityLabel, getSeverityLevel, getSeverityValue, getSupportedLanguages, getTerminalDivider, getWasmPath, groupIssuesByFile, handleCLIError, handleJSONOutput, handleStandardJSONOutput, inferPatternType, initTreeSitter, initializeParsers, isBuildArtifact, isFileSupported, isIgnorableSourceFile, isSourceFile, isTestFile, loadConfig, loadMergedConfig, loadScoreHistory, mergeConfigWithDefaults, normalizeAnalysisResult, normalizeIssue, normalizeMetrics, normalizeSeverity, normalizeSpokeOutput, parseFileExports, predictAcceptanceRate, prepareActionConfig, printTerminalHeader, readFileContent, resolveOutputFormat, resolveOutputPath, runBatchAnalysis, runStandardCliAction, 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, type HtmlReportSection, 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, TEST_PATTERNS, 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, createStandardCommand, createStandardProgressCallback, detectTestFramework, displayStandardConsoleReport, emitAnnotation, emitIssuesAsAnnotations, emitProgress, ensureDir, estimateCostFromBudget, estimateTokens, executeSpokeCli, exportHistory, extractCodeBlocks, filterBySeverity, findLatestReport, findLatestScanReport, formatAcceptanceRate, formatCost, formatHours, formatStandardCliResult, formatStandardReport, generateCompleteReport, generateIssueSummary, generateReportFooter, generateReportHead, generateReportHero, generateStandardHtmlReport, generateStatCards, generateTable, generateValueChain, getElapsedTime, getFileCommitTimestamps, getFileExtension, getFilesByPattern, getHistorySummary, getLineRangeLastModifiedCached, getModelPreset, getParser, getRepoMetadata, getReportTimestamp, getSafetyIcon, getScoreBar, getScoreColor, getSeverityBadge, getSeverityColor, getSeverityEnum, getSeverityLabel, getSeverityLevel, getSeverityValue, getSupportedLanguages, getTerminalDivider, getWasmPath, groupIssuesByFile, handleCLIError, handleJSONOutput, handleStandardJSONOutput, inferPatternType, initTreeSitter, initializeParsers, isBuildArtifact, isFileSupported, isIgnorableSourceFile, isSourceFile, isTestFile, loadConfig, loadMergedConfig, loadScoreHistory, mergeConfigWithDefaults, normalizeAnalysisResult, normalizeIssue, normalizeMetrics, normalizeSeverity, normalizeSpokeOutput, parseFileExports, predictAcceptanceRate, prepareActionConfig, printTerminalHeader, readFileContent, resolveOutputFormat, resolveOutputPath, runBatchAnalysis, runStandardCliAction, saveScoreEntry, scanEntries, scanFiles, setupParser, severityToAnnotationLevel, validateSpokeOutput, validateWithSchema, wrapInCard };

package/dist/index.js

@@ -2105,6 +2105,7 @@ __export(index_exports, {
   calculateTokenBudget: () => calculateTokenBudget,
   clearHistory: () => clearHistory,
   createProvider: () => createProvider,
+  createStandardCommand: () => createStandardCommand,
   createStandardProgressCallback: () => createStandardProgressCallback,
   detectTestFramework: () => detectTestFramework,
   displayStandardConsoleReport: () => displayStandardConsoleReport,
@@ -3317,7 +3318,25 @@ function createProvider(config) {
   };
 }
 
-// src/utils/similarity-utils.ts
+// src/utils/similarity.ts
+function calculateStringSimilarity(a, b) {
+  if (a === b) return 1;
+  const tokensA = a.split(/[^a-zA-Z0-9]+/).filter((t) => t.length > 0);
+  const tokensB = b.split(/[^a-zA-Z0-9]+/).filter((t) => t.length > 0);
+  if (tokensA.length === 0 || tokensB.length === 0) return 0;
+  const setA = new Set(tokensA);
+  const setB = new Set(tokensB);
+  const intersection = new Set([...setA].filter((x) => setB.has(x)));
+  const union = /* @__PURE__ */ new Set([...setA, ...setB]);
+  return intersection.size / union.size;
+}
+function calculateHeuristicConfidence(similarity, tokens, lines) {
+  let confidence = similarity;
+  if (lines > 20) confidence += 0.05;
+  if (tokens > 200) confidence += 0.05;
+  if (lines < 5) confidence -= 0.1;
+  return Math.max(0, Math.min(1, confidence));
+}
 function calculateImportSimilarity(export1, export2) {
   if (export1.imports.length === 0 && export2.imports.length === 0) {
     return 1;
@@ -4661,28 +4680,9 @@ function buildStandardToolScore(params) {
   };
 }
 
-// src/utils/similarity.ts
-function calculateStringSimilarity(a, b) {
-  if (a === b) return 1;
-  const tokensA = a.split(/[^a-zA-Z0-9]+/).filter((t) => t.length > 0);
-  const tokensB = b.split(/[^a-zA-Z0-9]+/).filter((t) => t.length > 0);
-  if (tokensA.length === 0 || tokensB.length === 0) return 0;
-  const setA = new Set(tokensA);
-  const setB = new Set(tokensB);
-  const intersection = new Set([...setA].filter((x) => setB.has(x)));
-  const union = /* @__PURE__ */ new Set([...setA, ...setB]);
-  return intersection.size / union.size;
-}
-function calculateHeuristicConfidence(similarity, tokens, lines) {
-  let confidence = similarity;
-  if (lines > 20) confidence += 0.05;
-  if (tokens > 200) confidence += 0.05;
-  if (lines < 5) confidence -= 0.1;
-  return Math.max(0, Math.min(1, confidence));
-}
-
 // src/utils/cli-factory.ts
 var import_chalk4 = __toESM(require("chalk"));
+var import_commander = require("commander");
 function createStandardProgressCallback(toolName) {
   return (processed, total, message) => {
     const percent = Math.round(processed / Math.max(1, total) * 100);
@@ -4715,6 +4715,25 @@ async function runStandardCliAction(toolName, action) {
     process.exit(1);
   }
 }
+function createStandardCommand(name, description, runAction) {
+  const command = new import_commander.Command(name);
+  command.description(description).option("-o, --output <path>", "Output file path").option("-i, --include <patterns...>", "Include specific file patterns").option("-e, --exclude <patterns...>", "Exclude specific file patterns").option("--json", "Output strictly as JSON").action(async (options) => {
+    try {
+      const result = await runAction(options);
+      if (options.json) {
+        console.log(JSON.stringify(result, null, 2));
+      } else {
+      }
+    } catch (error) {
+      console.error(
+        import_chalk4.default.red(`
+\u274C [${name}] critical error: ${error.message}`)
+      );
+      process.exit(1);
+    }
+  });
+  return command;
+}
 
 // src/utils/reporting.ts
 var import_chalk5 = __toESM(require("chalk"));
@@ -6078,7 +6097,7 @@ function calculateTestabilityIndex(params) {
   const dependencyInjectionScore = Math.round(
     Math.min(
       100,
-      (totalClasses > 0 ? injectionPatterns / totalClasses : 0.8) * 100
+      (totalClasses > 0 ? injectionPatterns / totalClasses : 1) * 100
     )
   );
   const interfaceFocusScore = Math.max(
@@ -6748,6 +6767,7 @@ function isBuildArtifact(filePath) {
   calculateTokenBudget,
   clearHistory,
   createProvider,
+  createStandardCommand,
   createStandardProgressCallback,
   detectTestFramework,
   displayStandardConsoleReport,

package/dist/index.mjs

@@ -877,7 +877,25 @@ function createProvider(config) {
   };
 }
 
-// src/utils/similarity-utils.ts
+// src/utils/similarity.ts
+function calculateStringSimilarity(a, b) {
+  if (a === b) return 1;
+  const tokensA = a.split(/[^a-zA-Z0-9]+/).filter((t) => t.length > 0);
+  const tokensB = b.split(/[^a-zA-Z0-9]+/).filter((t) => t.length > 0);
+  if (tokensA.length === 0 || tokensB.length === 0) return 0;
+  const setA = new Set(tokensA);
+  const setB = new Set(tokensB);
+  const intersection = new Set([...setA].filter((x) => setB.has(x)));
+  const union = /* @__PURE__ */ new Set([...setA, ...setB]);
+  return intersection.size / union.size;
+}
+function calculateHeuristicConfidence(similarity, tokens, lines) {
+  let confidence = similarity;
+  if (lines > 20) confidence += 0.05;
+  if (tokens > 200) confidence += 0.05;
+  if (lines < 5) confidence -= 0.1;
+  return Math.max(0, Math.min(1, confidence));
+}
 function calculateImportSimilarity(export1, export2) {
   if (export1.imports.length === 0 && export2.imports.length === 0) {
     return 1;
@@ -1693,28 +1711,9 @@ function buildStandardToolScore(params) {
   };
 }
 
-// src/utils/similarity.ts
-function calculateStringSimilarity(a, b) {
-  if (a === b) return 1;
-  const tokensA = a.split(/[^a-zA-Z0-9]+/).filter((t) => t.length > 0);
-  const tokensB = b.split(/[^a-zA-Z0-9]+/).filter((t) => t.length > 0);
-  if (tokensA.length === 0 || tokensB.length === 0) return 0;
-  const setA = new Set(tokensA);
-  const setB = new Set(tokensB);
-  const intersection = new Set([...setA].filter((x) => setB.has(x)));
-  const union = /* @__PURE__ */ new Set([...setA, ...setB]);
-  return intersection.size / union.size;
-}
-function calculateHeuristicConfidence(similarity, tokens, lines) {
-  let confidence = similarity;
-  if (lines > 20) confidence += 0.05;
-  if (tokens > 200) confidence += 0.05;
-  if (lines < 5) confidence -= 0.1;
-  return Math.max(0, Math.min(1, confidence));
-}
-
 // src/utils/cli-factory.ts
 import chalk4 from "chalk";
+import { Command } from "commander";
 function createStandardProgressCallback(toolName) {
   return (processed, total, message) => {
     const percent = Math.round(processed / Math.max(1, total) * 100);
@@ -1747,6 +1746,25 @@ async function runStandardCliAction(toolName, action) {
     process.exit(1);
   }
 }
+function createStandardCommand(name, description, runAction) {
+  const command = new Command(name);
+  command.description(description).option("-o, --output <path>", "Output file path").option("-i, --include <patterns...>", "Include specific file patterns").option("-e, --exclude <patterns...>", "Exclude specific file patterns").option("--json", "Output strictly as JSON").action(async (options) => {
+    try {
+      const result = await runAction(options);
+      if (options.json) {
+        console.log(JSON.stringify(result, null, 2));
+      } else {
+      }
+    } catch (error) {
+      console.error(
+        chalk4.red(`
+\u274C [${name}] critical error: ${error.message}`)
+      );
+      process.exit(1);
+    }
+  });
+  return command;
+}
 
 // src/utils/reporting.ts
 import chalk5 from "chalk";
@@ -3102,7 +3120,7 @@ function calculateTestabilityIndex(params) {
   const dependencyInjectionScore = Math.round(
     Math.min(
       100,
-      (totalClasses > 0 ? injectionPatterns / totalClasses : 0.8) * 100
+      (totalClasses > 0 ? injectionPatterns / totalClasses : 1) * 100
     )
   );
   const interfaceFocusScore = Math.max(
@@ -3771,6 +3789,7 @@ export {
   calculateTokenBudget,
   clearHistory,
   createProvider,
+  createStandardCommand,
   createStandardProgressCallback,
   detectTestFramework,
   displayStandardConsoleReport,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiready/core",
-  "version": "0.24.9",
+  "version": "0.24.12",
   "description": "Shared utilities for AIReady analysis tools",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -47,6 +47,7 @@
     "@typescript-eslint/typescript-estree": "^8.53.0",
     "@unit-mesh/treesitter-artifacts": "^1.7.7",
     "chalk": "^5.4.1",
+    "commander": "^14.0.3",
     "glob": "^13.0.0",
     "ignore": "^7.0.0",
     "tree-sitter-java": "^0.23.5",