@aiready/core 0.24.6 → 0.24.8

package/dist/index.d.mts

@@ -1,10 +1,33 @@
-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-ChiWzeQs.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-ChiWzeQs.mjs';
+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 * as chalk from 'chalk';
 import * as Parser from 'web-tree-sitter';
 import { TSESTree } from '@typescript-eslint/typescript-estree';
 
+/**
+ * Represents a block of code extracted from a source file.
+ * Used for pattern detection and code analysis.
+ */
+interface CodeBlock {
+    /** Relative file path */
+    file: string;
+    /** Starting line number (1-based) */
+    startLine: number;
+    /** Ending line number (1-based) */
+    endLine: number;
+    /** The actual code content */
+    code: string;
+    /** Approximate token count */
+    tokens: number;
+    /** Type of pattern (e.g., 'function', 'class', 'block') */
+    patternType: string;
+    /** Optional function/method signature for matching */
+    signature?: string;
+    /** Optional hash for quick duplicate detection */
+    hash?: string;
+}
+
 /**
  * Spoke-to-Hub Contract Definitions
  * This file defines the expected JSON structure for tool outputs to ensure
@@ -35,7 +58,7 @@ interface ToolProvider {
  * @param output - The raw output data to check.
  * @returns Validation result with boolean flag and any errors found.
  */
-declare function validateSpokeOutput(toolName: string, output: any): {
+declare function validateSpokeOutput(toolName: string, output: unknown): {
     valid: boolean;
     errors: string[];
 };
@@ -47,7 +70,7 @@ declare function validateSpokeOutput(toolName: string, output: any): {
  * @returns Result object with valid flag and typed data or errors.
  * @lastUpdated 2026-03-18
  */
-declare function validateWithSchema<T>(schema: z.ZodSchema<T>, data: any): {
+declare function validateWithSchema<T>(schema: z.ZodSchema<T>, data: unknown): {
     valid: boolean;
     data?: T;
     errors?: string[];
@@ -505,7 +528,7 @@ declare function loadConfig(rootDir: string): Promise<AIReadyConfig | null>;
  * @param defaults The default configuration object
  * @returns Merged configuration with all defaults applied
  */
-declare function mergeConfigWithDefaults(userConfig: AIReadyConfig | null, defaults: any): any;
+declare function mergeConfigWithDefaults<T extends Record<string, any>>(userConfig: AIReadyConfig | null, defaults: T): T;
 
 interface StatCard {
     value: string | number;
@@ -690,29 +713,6 @@ declare function getScoreColor(score: number): chalk.ChalkInstance;
  */
 declare function displayStandardConsoleReport(data: StandardReportData): void;
 
-/**
- * Represents a block of code extracted from a source file.
- * Used for pattern detection and code analysis.
- */
-interface CodeBlock {
-    /** Relative file path */
-    file: string;
-    /** Starting line number (1-based) */
-    startLine: number;
-    /** Ending line number (1-based) */
-    endLine: number;
-    /** The actual code content */
-    code: string;
-    /** Approximate token count */
-    tokens: number;
-    /** Type of pattern (e.g., 'function', 'class', 'block') */
-    patternType: string;
-    /** Optional function/method signature for matching */
-    signature?: string;
-    /** Optional hash for quick duplicate detection */
-    hash?: string;
-}
-
 /**
  * Infer the type of code pattern based on keywords and naming conventions.
  */
@@ -1739,6 +1739,40 @@ declare function calculateDependencyHealth(params: {
     trainingCutoffSkew: number;
 }): DependencyHealthScore;
 
+/**
+ * Change Amplification Metrics.
+ * Measures how a change in one file ripples through the system via dependency fan-out.
+ *
+ * @lastUpdated 2026-03-18
+ */
+interface ChangeAmplificationScore {
+    score: number;
+    rating: 'isolated' | 'contained' | 'amplified' | 'explosive';
+    avgAmplification: number;
+    maxAmplification: number;
+    hotspots: Array<{
+        file: string;
+        fanOut: number;
+        fanIn: number;
+        amplificationFactor: number;
+    }>;
+    recommendations: string[];
+}
+/**
+ * Calculate Change Amplification metrics for a set of files in a dependency graph.
+ *
+ * @param params - Structural metrics gathered from link analysis.
+ * @param params.files - List of files with their fan-in/fan-out counts.
+ * @returns Comprehensive ChangeAmplificationScore.
+ */
+declare function calculateChangeAmplification(params: {
+    files: Array<{
+        file: string;
+        fanOut: number;
+        fanIn: number;
+    }>;
+}): ChangeAmplificationScore;
+
 /**
  * Parameters for generating comprehensive future-proof recommendations.
  *
@@ -1798,40 +1832,6 @@ declare function calculateExtendedFutureProofScore(params: FutureProofRecommenda
     semanticDistances?: SemanticDistance[];
 }): ToolScoringOutput;
 
-/**
- * Change Amplification Metrics.
- * Measures how a change in one file ripples through the system via dependency fan-out.
- *
- * @lastUpdated 2026-03-18
- */
-interface ChangeAmplificationScore {
-    score: number;
-    rating: 'isolated' | 'contained' | 'amplified' | 'explosive';
-    avgAmplification: number;
-    maxAmplification: number;
-    hotspots: Array<{
-        file: string;
-        fanOut: number;
-        fanIn: number;
-        amplificationFactor: number;
-    }>;
-    recommendations: string[];
-}
-/**
- * Calculate Change Amplification metrics for a set of files in a dependency graph.
- *
- * @param params - Structural metrics gathered from link analysis.
- * @param params.files - List of files with their fan-in/fan-out counts.
- * @returns Comprehensive ChangeAmplificationScore.
- */
-declare function calculateChangeAmplification(params: {
-    files: Array<{
-        file: string;
-        fanOut: number;
-        fanIn: number;
-    }>;
-}): ChangeAmplificationScore;
-
 /**
  * Temporal Tracking Utilities
  *
@@ -1955,7 +1955,7 @@ declare function runBatchAnalysis<T, R>(items: T[], label: string, toolId: strin
 /**
  * Shared logic for spoke-specific CLI entry points to reduce code duplication.
  */
-declare function executeSpokeCli(name: string, description: string, options: any, analyzeFn: (config: any) => Promise<any>): Promise<any>;
+declare function executeSpokeCli(name: string, description: string, options: Partial<ScanOptions> & Record<string, any>, analyzeFn: (config: ScanOptions) => Promise<unknown>): Promise<unknown>;
 
 /**
  * Common test file patterns for multiple languages.

package/dist/index.d.ts

@@ -1,10 +1,33 @@
-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-ChiWzeQs.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-ChiWzeQs.js';
+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 * as chalk from 'chalk';
 import * as Parser from 'web-tree-sitter';
 import { TSESTree } from '@typescript-eslint/typescript-estree';
 
+/**
+ * Represents a block of code extracted from a source file.
+ * Used for pattern detection and code analysis.
+ */
+interface CodeBlock {
+    /** Relative file path */
+    file: string;
+    /** Starting line number (1-based) */
+    startLine: number;
+    /** Ending line number (1-based) */
+    endLine: number;
+    /** The actual code content */
+    code: string;
+    /** Approximate token count */
+    tokens: number;
+    /** Type of pattern (e.g., 'function', 'class', 'block') */
+    patternType: string;
+    /** Optional function/method signature for matching */
+    signature?: string;
+    /** Optional hash for quick duplicate detection */
+    hash?: string;
+}
+
 /**
  * Spoke-to-Hub Contract Definitions
  * This file defines the expected JSON structure for tool outputs to ensure
@@ -35,7 +58,7 @@ interface ToolProvider {
  * @param output - The raw output data to check.
  * @returns Validation result with boolean flag and any errors found.
  */
-declare function validateSpokeOutput(toolName: string, output: any): {
+declare function validateSpokeOutput(toolName: string, output: unknown): {
     valid: boolean;
     errors: string[];
 };
@@ -47,7 +70,7 @@ declare function validateSpokeOutput(toolName: string, output: any): {
  * @returns Result object with valid flag and typed data or errors.
  * @lastUpdated 2026-03-18
  */
-declare function validateWithSchema<T>(schema: z.ZodSchema<T>, data: any): {
+declare function validateWithSchema<T>(schema: z.ZodSchema<T>, data: unknown): {
     valid: boolean;
     data?: T;
     errors?: string[];
@@ -505,7 +528,7 @@ declare function loadConfig(rootDir: string): Promise<AIReadyConfig | null>;
  * @param defaults The default configuration object
  * @returns Merged configuration with all defaults applied
  */
-declare function mergeConfigWithDefaults(userConfig: AIReadyConfig | null, defaults: any): any;
+declare function mergeConfigWithDefaults<T extends Record<string, any>>(userConfig: AIReadyConfig | null, defaults: T): T;
 
 interface StatCard {
     value: string | number;
@@ -690,29 +713,6 @@ declare function getScoreColor(score: number): chalk.ChalkInstance;
  */
 declare function displayStandardConsoleReport(data: StandardReportData): void;
 
-/**
- * Represents a block of code extracted from a source file.
- * Used for pattern detection and code analysis.
- */
-interface CodeBlock {
-    /** Relative file path */
-    file: string;
-    /** Starting line number (1-based) */
-    startLine: number;
-    /** Ending line number (1-based) */
-    endLine: number;
-    /** The actual code content */
-    code: string;
-    /** Approximate token count */
-    tokens: number;
-    /** Type of pattern (e.g., 'function', 'class', 'block') */
-    patternType: string;
-    /** Optional function/method signature for matching */
-    signature?: string;
-    /** Optional hash for quick duplicate detection */
-    hash?: string;
-}
-
 /**
  * Infer the type of code pattern based on keywords and naming conventions.
  */
@@ -1739,6 +1739,40 @@ declare function calculateDependencyHealth(params: {
     trainingCutoffSkew: number;
 }): DependencyHealthScore;
 
+/**
+ * Change Amplification Metrics.
+ * Measures how a change in one file ripples through the system via dependency fan-out.
+ *
+ * @lastUpdated 2026-03-18
+ */
+interface ChangeAmplificationScore {
+    score: number;
+    rating: 'isolated' | 'contained' | 'amplified' | 'explosive';
+    avgAmplification: number;
+    maxAmplification: number;
+    hotspots: Array<{
+        file: string;
+        fanOut: number;
+        fanIn: number;
+        amplificationFactor: number;
+    }>;
+    recommendations: string[];
+}
+/**
+ * Calculate Change Amplification metrics for a set of files in a dependency graph.
+ *
+ * @param params - Structural metrics gathered from link analysis.
+ * @param params.files - List of files with their fan-in/fan-out counts.
+ * @returns Comprehensive ChangeAmplificationScore.
+ */
+declare function calculateChangeAmplification(params: {
+    files: Array<{
+        file: string;
+        fanOut: number;
+        fanIn: number;
+    }>;
+}): ChangeAmplificationScore;
+
 /**
  * Parameters for generating comprehensive future-proof recommendations.
  *
@@ -1798,40 +1832,6 @@ declare function calculateExtendedFutureProofScore(params: FutureProofRecommenda
     semanticDistances?: SemanticDistance[];
 }): ToolScoringOutput;
 
-/**
- * Change Amplification Metrics.
- * Measures how a change in one file ripples through the system via dependency fan-out.
- *
- * @lastUpdated 2026-03-18
- */
-interface ChangeAmplificationScore {
-    score: number;
-    rating: 'isolated' | 'contained' | 'amplified' | 'explosive';
-    avgAmplification: number;
-    maxAmplification: number;
-    hotspots: Array<{
-        file: string;
-        fanOut: number;
-        fanIn: number;
-        amplificationFactor: number;
-    }>;
-    recommendations: string[];
-}
-/**
- * Calculate Change Amplification metrics for a set of files in a dependency graph.
- *
- * @param params - Structural metrics gathered from link analysis.
- * @param params.files - List of files with their fan-in/fan-out counts.
- * @returns Comprehensive ChangeAmplificationScore.
- */
-declare function calculateChangeAmplification(params: {
-    files: Array<{
-        file: string;
-        fanOut: number;
-        fanIn: number;
-    }>;
-}): ChangeAmplificationScore;
-
 /**
  * Temporal Tracking Utilities
  *
@@ -1955,7 +1955,7 @@ declare function runBatchAnalysis<T, R>(items: T[], label: string, toolId: strin
 /**
  * Shared logic for spoke-specific CLI entry points to reduce code duplication.
  */
-declare function executeSpokeCli(name: string, description: string, options: any, analyzeFn: (config: any) => Promise<any>): Promise<any>;
+declare function executeSpokeCli(name: string, description: string, options: Partial<ScanOptions> & Record<string, any>, analyzeFn: (config: ScanOptions) => Promise<unknown>): Promise<unknown>;
 
 /**
  * Common test file patterns for multiple languages.