@aiready/context-analyzer 0.9.41 → 0.16.0

package/dist/cli.mjs

@@ -2,7 +2,7 @@
 import {
   analyzeContext,
   generateSummary
-} from "./chunk-EBXG2Q5Y.mjs";
+} from "./chunk-GFADGYXZ.mjs";
 
 // src/cli.ts
 import { Command } from "commander";

package/dist/index.d.mts

@@ -122,104 +122,236 @@ interface TypeDependency {
     usedBy: string[];
 }
 
+interface FileContent {
+    file: string;
+    content: string;
+}
+/**
+ * Auto-detect domain keywords from workspace folder structure
+ */
+declare function extractDomainKeywordsFromPaths(files: FileContent[]): string[];
+/**
+ * Build a dependency graph from file contents
+ */
+declare function buildDependencyGraph(files: FileContent[], options?: {
+    domainKeywords?: string[];
+}): DependencyGraph;
+/**
+ * Extract imports from file content using regex
+ */
+declare function extractImportsFromContent(content: string): string[];
+/**
+ * Calculate the maximum depth of import tree for a file
+ */
+declare function calculateImportDepth(file: string, graph: DependencyGraph, visited?: Set<string>, depth?: number): number;
+/**
+ * Get all transitive dependencies for a file
+ */
+declare function getTransitiveDependencies(file: string, graph: DependencyGraph, visited?: Set<string>): string[];
+/**
+ * Calculate total context budget (tokens needed to understand this file)
+ */
+declare function calculateContextBudget(file: string, graph: DependencyGraph): number;
+/**
+ * Detect circular dependencies
+ */
+declare function detectCircularDependencies(graph: DependencyGraph): string[][];
+
+/**
+ * Calculate cohesion score (how related are exports in a file)
+ */
+declare function calculateEnhancedCohesion(exports: ExportInfo[], filePath?: string, options?: {
+    coUsageMatrix?: Map<string, Map<string, number>>;
+    weights?: {
+        importBased?: number;
+        structural?: number;
+        domainBased?: number;
+    };
+}): number;
+/**
+ * Calculate structural cohesion for a file based on co-usage patterns.
+ */
+declare function calculateStructuralCohesionFromCoUsage(file: string, coUsageMatrix?: Map<string, Map<string, number>>): number;
+/**
+ * Calculate fragmentation score (how scattered is a domain)
+ */
+declare function calculateFragmentation(files: string[], domain: string, options?: {
+    useLogScale?: boolean;
+    logBase?: number;
+    sharedImportRatio?: number;
+    dependencyCount?: number;
+}): number;
+/**
+ * Calculate path entropy for a set of files
+ */
+declare function calculatePathEntropy(files: string[]): number;
+/**
+ * Calculate directory-distance metric based on common ancestor depth
+ */
+declare function calculateDirectoryDistance(files: string[]): number;
+
+/**
+ * Classify a file into a specific type for better analysis context
+ */
+declare function classifyFile(node: DependencyNode, cohesionScore?: number, domains?: string[]): FileClassification;
+/**
+ * Detect if a file is a barrel export (index.ts)
+ */
+declare function isBarrelExport(node: DependencyNode): boolean;
+/**
+ * Detect if a file is primarily type definitions
+ */
+declare function isTypeDefinition(node: DependencyNode): boolean;
+/**
+ * Detect if a file is a utility module
+ */
+declare function isUtilityModule(node: DependencyNode): boolean;
+/**
+ * Detect if a file is a Lambda/API handler
+ */
+declare function isLambdaHandler(node: DependencyNode): boolean;
+/**
+ * Detect if a file is a service file
+ */
+declare function isServiceFile(node: DependencyNode): boolean;
 /**
- * Classify a file based on its characteristics to help distinguish
- * real issues from false positives.
- *
- * Classification types:
- * - barrel-export: Re-exports from other modules (index.ts files)
- * - type-definition: Primarily type/interface definitions
- * - cohesive-module: Single domain, high cohesion (acceptable large files)
- * - utility-module: Utility/helper files with cohesive purpose despite multi-domain
- * - service-file: Service files orchestrating multiple dependencies
- * - lambda-handler: Lambda/API handlers with single business purpose
- * - email-template: Email templates/layouts with structural cohesion
- * - parser-file: Parser/transformer files with single transformation purpose
- * - mixed-concerns: Multiple domains, potential refactoring candidate
- * - unknown: Unable to classify
- */
-declare function classifyFile(node: DependencyNode, cohesionScore: number, domains: string[]): FileClassification;
+ * Detect if a file is an email template/layout
+ */
+declare function isEmailTemplate(node: DependencyNode): boolean;
+/**
+ * Detect if a file is a parser/transformer
+ */
+declare function isParserFile(node: DependencyNode): boolean;
+/**
+ * Detect if a file is a session/state management file
+ */
+declare function isSessionFile(node: DependencyNode): boolean;
+/**
+ * Detect if a file is a configuration or schema file
+ */
+declare function isConfigFile(node: DependencyNode): boolean;
+/**
+ * Detect if a file is a Next.js App Router page
+ */
+declare function isNextJsPage(node: DependencyNode): boolean;
+/**
+ * Adjust cohesion score based on file classification
+ */
+declare function adjustCohesionForClassification(baseCohesion: number, classification: FileClassification, node?: DependencyNode): number;
 /**
  * Adjust fragmentation score based on file classification
- *
- * This reduces false positives by:
- * - Ignoring fragmentation for barrel exports (they're meant to aggregate)
- * - Ignoring fragmentation for type definitions (centralized types are good)
- * - Reducing fragmentation for cohesive modules (large but focused is OK)
- * - Reducing fragmentation for utility/service/handler/template files
  */
 declare function adjustFragmentationForClassification(baseFragmentation: number, classification: FileClassification): number;
 
+/**
+ * Group files by domain to detect module clusters
+ */
+declare function detectModuleClusters(graph: DependencyGraph, options?: {
+    useLogScale?: boolean;
+}): ModuleCluster[];
+
+/**
+ * Get classification-specific recommendations
+ */
+declare function getClassificationRecommendations(classification: FileClassification, file: string, issues: string[]): string[];
+/**
+ * Generate general context recommendations
+ */
+declare function getGeneralRecommendations(metrics: {
+    contextBudget: number;
+    importDepth: number;
+    circularDeps: string[][];
+    cohesionScore: number;
+    fragmentationScore: number;
+}, thresholds: {
+    maxContextBudget: number;
+    maxDepth: number;
+    minCohesion: number;
+    maxFragmentation: number;
+}): {
+    recommendations: string[];
+    issues: string[];
+    severity: any;
+};
+
+/**
+ * Calculate cohesion score (how related are exports in a file)
+ * Legacy wrapper for backward compatibility with exact test expectations
+ */
+declare function calculateCohesion(exports: ExportInfo[], filePath?: string, options?: any): number;
+/**
+ * Analyze issues for a single file
+ */
+declare function analyzeIssues(params: {
+    file: string;
+    importDepth: number;
+    contextBudget: number;
+    cohesionScore: number;
+    fragmentationScore: number;
+    maxDepth: number;
+    maxContextBudget: number;
+    minCohesion: number;
+    maxFragmentation: number;
+    circularDeps: string[][];
+}): {
+    severity: ContextAnalysisResult['severity'];
+    issues: string[];
+    recommendations: string[];
+    potentialSavings: number;
+};
+
 /**
  * Calculate AI Readiness Score for context efficiency (0-100)
- *
- * Based on:
- * - Average context budget (tokens needed to understand files)
- * - Import depth (dependency chain length)
- * - Fragmentation score (code organization)
- * - Critical/major issues
- *
- * Includes business value metrics:
- * - Estimated monthly cost of context waste
- * - Estimated developer hours to fix
  */
 declare function calculateContextScore(summary: ContextSummary, costConfig?: Partial<CostConfig>): ToolScoringOutput;
+declare function mapScoreToRating(score: number): string;
+
+/**
+ * Generate smart defaults for context analysis based on repository size
+ * Automatically tunes thresholds to target ~10 most serious issues
+ */
+declare function getSmartDefaults(directory: string, userOptions: Partial<ContextAnalyzerOptions>): Promise<ContextAnalyzerOptions>;
+
+/**
+ * Generate summary of context analysis results
+ */
+declare function generateSummary(results: ContextAnalysisResult[]): ContextSummary;
 
 /**
  * Build co-usage matrix: track which files are imported together
- *
- * Files frequently imported together likely belong to the same semantic domain
  */
 declare function buildCoUsageMatrix(graph: DependencyGraph): Map<string, Map<string, number>>;
 /**
  * Extract type dependencies from AST exports
- *
- * Files that share types are semantically related
  */
 declare function buildTypeGraph(graph: DependencyGraph): Map<string, Set<string>>;
 /**
  * Find semantic clusters using co-usage patterns
- *
- * Files with high co-usage counts belong in the same cluster
  */
 declare function findSemanticClusters(coUsageMatrix: Map<string, Map<string, number>>, minCoUsage?: number): Map<string, string[]>;
-/**
- * Calculate confidence score for domain assignment based on multiple signals
- */
-declare function calculateDomainConfidence(signals: DomainSignals): number;
 /**
  * Infer domain from semantic analysis (co-usage + types)
- *
- * This replaces the folder-based heuristic with actual code relationships
  */
 declare function inferDomainFromSemantics(file: string, exportName: string, graph: DependencyGraph, coUsageMatrix: Map<string, Map<string, number>>, typeGraph: Map<string, Set<string>>, exportTypeRefs?: string[]): DomainAssignment[];
+declare function calculateDomainConfidence(signals: DomainSignals): number;
 /**
- * Get co-usage data for a specific file
+ * Regex-based export extraction (legacy/fallback)
  */
-declare function getCoUsageData(file: string, coUsageMatrix: Map<string, Map<string, number>>): CoUsageData;
+declare function extractExports(content: string, filePath?: string, domainOptions?: {
+    domainKeywords?: string[];
+}, fileImports?: string[]): ExportInfo[];
 /**
- * Find files that should be consolidated based on semantic similarity
- *
- * High co-usage + shared types = strong consolidation candidate
+ * Infer domain from name, path, or imports
  */
-declare function findConsolidationCandidates(graph: DependencyGraph, coUsageMatrix: Map<string, Map<string, number>>, typeGraph: Map<string, Set<string>>, minCoUsage?: number, minSharedTypes?: number): Array<{
-    files: string[];
-    reason: string;
-    strength: number;
-}>;
+declare function inferDomain(name: string, filePath?: string, domainOptions?: {
+    domainKeywords?: string[];
+}, fileImports?: string[]): string;
+declare function getCoUsageData(file: string, coUsageMatrix: Map<string, Map<string, number>>): CoUsageData;
+declare function findConsolidationCandidates(graph: DependencyGraph, coUsageMatrix: Map<string, Map<string, number>>, typeGraph: Map<string, Set<string>>, minCoUsage?: number, minSharedTypes?: number): any[];
 
-/**
- * Generate smart defaults for context analysis based on repository size
- * Automatically tunes thresholds to target ~10 most serious issues
- */
-declare function getSmartDefaults(directory: string, userOptions: Partial<ContextAnalyzerOptions>): Promise<ContextAnalyzerOptions>;
 /**
  * Analyze AI context window cost for a codebase
  */
 declare function analyzeContext(options: ContextAnalyzerOptions): Promise<ContextAnalysisResult[]>;
-/**
- * Generate summary of context analysis results
- */
-declare function generateSummary(results: ContextAnalysisResult[]): ContextSummary;
 
-export { type CoUsageData, type ContextAnalysisResult, type ContextAnalyzerOptions, type ContextSummary, type DomainAssignment, type DomainSignals, type FileClassification, type ModuleCluster, type TypeDependency, adjustFragmentationForClassification, analyzeContext, buildCoUsageMatrix, buildTypeGraph, calculateContextScore, calculateDomainConfidence, classifyFile, findConsolidationCandidates, findSemanticClusters, generateSummary, getCoUsageData, getSmartDefaults, inferDomainFromSemantics };
+export { type CoUsageData, type ContextAnalysisResult, type ContextAnalyzerOptions, type ContextSummary, type DependencyGraph, type DependencyNode, type DomainAssignment, type DomainSignals, type ExportInfo, type FileClassification, type ModuleCluster, type TypeDependency, adjustCohesionForClassification, adjustFragmentationForClassification, analyzeContext, analyzeIssues, buildCoUsageMatrix, buildDependencyGraph, buildTypeGraph, calculateCohesion, calculateContextBudget, calculateContextScore, calculateDirectoryDistance, calculateDomainConfidence, calculateEnhancedCohesion, calculateFragmentation, calculateImportDepth, calculatePathEntropy, calculateStructuralCohesionFromCoUsage, classifyFile, detectCircularDependencies, detectModuleClusters, extractDomainKeywordsFromPaths, extractExports, extractImportsFromContent, findConsolidationCandidates, findSemanticClusters, generateSummary, getClassificationRecommendations, getCoUsageData, getGeneralRecommendations, getSmartDefaults, getTransitiveDependencies, inferDomain, inferDomainFromSemantics, isBarrelExport, isConfigFile, isEmailTemplate, isLambdaHandler, isNextJsPage, isParserFile, isServiceFile, isSessionFile, isTypeDefinition, isUtilityModule, mapScoreToRating };

package/dist/index.d.ts

@@ -122,104 +122,236 @@ interface TypeDependency {
     usedBy: string[];
 }
 
+interface FileContent {
+    file: string;
+    content: string;
+}
+/**
+ * Auto-detect domain keywords from workspace folder structure
+ */
+declare function extractDomainKeywordsFromPaths(files: FileContent[]): string[];
+/**
+ * Build a dependency graph from file contents
+ */
+declare function buildDependencyGraph(files: FileContent[], options?: {
+    domainKeywords?: string[];
+}): DependencyGraph;
+/**
+ * Extract imports from file content using regex
+ */
+declare function extractImportsFromContent(content: string): string[];
+/**
+ * Calculate the maximum depth of import tree for a file
+ */
+declare function calculateImportDepth(file: string, graph: DependencyGraph, visited?: Set<string>, depth?: number): number;
+/**
+ * Get all transitive dependencies for a file
+ */
+declare function getTransitiveDependencies(file: string, graph: DependencyGraph, visited?: Set<string>): string[];
+/**
+ * Calculate total context budget (tokens needed to understand this file)
+ */
+declare function calculateContextBudget(file: string, graph: DependencyGraph): number;
+/**
+ * Detect circular dependencies
+ */
+declare function detectCircularDependencies(graph: DependencyGraph): string[][];
+
+/**
+ * Calculate cohesion score (how related are exports in a file)
+ */
+declare function calculateEnhancedCohesion(exports: ExportInfo[], filePath?: string, options?: {
+    coUsageMatrix?: Map<string, Map<string, number>>;
+    weights?: {
+        importBased?: number;
+        structural?: number;
+        domainBased?: number;
+    };
+}): number;
+/**
+ * Calculate structural cohesion for a file based on co-usage patterns.
+ */
+declare function calculateStructuralCohesionFromCoUsage(file: string, coUsageMatrix?: Map<string, Map<string, number>>): number;
+/**
+ * Calculate fragmentation score (how scattered is a domain)
+ */
+declare function calculateFragmentation(files: string[], domain: string, options?: {
+    useLogScale?: boolean;
+    logBase?: number;
+    sharedImportRatio?: number;
+    dependencyCount?: number;
+}): number;
+/**
+ * Calculate path entropy for a set of files
+ */
+declare function calculatePathEntropy(files: string[]): number;
+/**
+ * Calculate directory-distance metric based on common ancestor depth
+ */
+declare function calculateDirectoryDistance(files: string[]): number;
+
+/**
+ * Classify a file into a specific type for better analysis context
+ */
+declare function classifyFile(node: DependencyNode, cohesionScore?: number, domains?: string[]): FileClassification;
+/**
+ * Detect if a file is a barrel export (index.ts)
+ */
+declare function isBarrelExport(node: DependencyNode): boolean;
+/**
+ * Detect if a file is primarily type definitions
+ */
+declare function isTypeDefinition(node: DependencyNode): boolean;
+/**
+ * Detect if a file is a utility module
+ */
+declare function isUtilityModule(node: DependencyNode): boolean;
+/**
+ * Detect if a file is a Lambda/API handler
+ */
+declare function isLambdaHandler(node: DependencyNode): boolean;
+/**
+ * Detect if a file is a service file
+ */
+declare function isServiceFile(node: DependencyNode): boolean;
 /**
- * Classify a file based on its characteristics to help distinguish
- * real issues from false positives.
- *
- * Classification types:
- * - barrel-export: Re-exports from other modules (index.ts files)
- * - type-definition: Primarily type/interface definitions
- * - cohesive-module: Single domain, high cohesion (acceptable large files)
- * - utility-module: Utility/helper files with cohesive purpose despite multi-domain
- * - service-file: Service files orchestrating multiple dependencies
- * - lambda-handler: Lambda/API handlers with single business purpose
- * - email-template: Email templates/layouts with structural cohesion
- * - parser-file: Parser/transformer files with single transformation purpose
- * - mixed-concerns: Multiple domains, potential refactoring candidate
- * - unknown: Unable to classify
- */
-declare function classifyFile(node: DependencyNode, cohesionScore: number, domains: string[]): FileClassification;
+ * Detect if a file is an email template/layout
+ */
+declare function isEmailTemplate(node: DependencyNode): boolean;
+/**
+ * Detect if a file is a parser/transformer
+ */
+declare function isParserFile(node: DependencyNode): boolean;
+/**
+ * Detect if a file is a session/state management file
+ */
+declare function isSessionFile(node: DependencyNode): boolean;
+/**
+ * Detect if a file is a configuration or schema file
+ */
+declare function isConfigFile(node: DependencyNode): boolean;
+/**
+ * Detect if a file is a Next.js App Router page
+ */
+declare function isNextJsPage(node: DependencyNode): boolean;
+/**
+ * Adjust cohesion score based on file classification
+ */
+declare function adjustCohesionForClassification(baseCohesion: number, classification: FileClassification, node?: DependencyNode): number;
 /**
  * Adjust fragmentation score based on file classification
- *
- * This reduces false positives by:
- * - Ignoring fragmentation for barrel exports (they're meant to aggregate)
- * - Ignoring fragmentation for type definitions (centralized types are good)
- * - Reducing fragmentation for cohesive modules (large but focused is OK)
- * - Reducing fragmentation for utility/service/handler/template files
  */
 declare function adjustFragmentationForClassification(baseFragmentation: number, classification: FileClassification): number;
 
+/**
+ * Group files by domain to detect module clusters
+ */
+declare function detectModuleClusters(graph: DependencyGraph, options?: {
+    useLogScale?: boolean;
+}): ModuleCluster[];
+
+/**
+ * Get classification-specific recommendations
+ */
+declare function getClassificationRecommendations(classification: FileClassification, file: string, issues: string[]): string[];
+/**
+ * Generate general context recommendations
+ */
+declare function getGeneralRecommendations(metrics: {
+    contextBudget: number;
+    importDepth: number;
+    circularDeps: string[][];
+    cohesionScore: number;
+    fragmentationScore: number;
+}, thresholds: {
+    maxContextBudget: number;
+    maxDepth: number;
+    minCohesion: number;
+    maxFragmentation: number;
+}): {
+    recommendations: string[];
+    issues: string[];
+    severity: any;
+};
+
+/**
+ * Calculate cohesion score (how related are exports in a file)
+ * Legacy wrapper for backward compatibility with exact test expectations
+ */
+declare function calculateCohesion(exports: ExportInfo[], filePath?: string, options?: any): number;
+/**
+ * Analyze issues for a single file
+ */
+declare function analyzeIssues(params: {
+    file: string;
+    importDepth: number;
+    contextBudget: number;
+    cohesionScore: number;
+    fragmentationScore: number;
+    maxDepth: number;
+    maxContextBudget: number;
+    minCohesion: number;
+    maxFragmentation: number;
+    circularDeps: string[][];
+}): {
+    severity: ContextAnalysisResult['severity'];
+    issues: string[];
+    recommendations: string[];
+    potentialSavings: number;
+};
+
 /**
  * Calculate AI Readiness Score for context efficiency (0-100)
- *
- * Based on:
- * - Average context budget (tokens needed to understand files)
- * - Import depth (dependency chain length)
- * - Fragmentation score (code organization)
- * - Critical/major issues
- *
- * Includes business value metrics:
- * - Estimated monthly cost of context waste
- * - Estimated developer hours to fix
  */
 declare function calculateContextScore(summary: ContextSummary, costConfig?: Partial<CostConfig>): ToolScoringOutput;
+declare function mapScoreToRating(score: number): string;
+
+/**
+ * Generate smart defaults for context analysis based on repository size
+ * Automatically tunes thresholds to target ~10 most serious issues
+ */
+declare function getSmartDefaults(directory: string, userOptions: Partial<ContextAnalyzerOptions>): Promise<ContextAnalyzerOptions>;
+
+/**
+ * Generate summary of context analysis results
+ */
+declare function generateSummary(results: ContextAnalysisResult[]): ContextSummary;
 
 /**
  * Build co-usage matrix: track which files are imported together
- *
- * Files frequently imported together likely belong to the same semantic domain
  */
 declare function buildCoUsageMatrix(graph: DependencyGraph): Map<string, Map<string, number>>;
 /**
  * Extract type dependencies from AST exports
- *
- * Files that share types are semantically related
  */
 declare function buildTypeGraph(graph: DependencyGraph): Map<string, Set<string>>;
 /**
  * Find semantic clusters using co-usage patterns
- *
- * Files with high co-usage counts belong in the same cluster
  */
 declare function findSemanticClusters(coUsageMatrix: Map<string, Map<string, number>>, minCoUsage?: number): Map<string, string[]>;
-/**
- * Calculate confidence score for domain assignment based on multiple signals
- */
-declare function calculateDomainConfidence(signals: DomainSignals): number;
 /**
  * Infer domain from semantic analysis (co-usage + types)
- *
- * This replaces the folder-based heuristic with actual code relationships
  */
 declare function inferDomainFromSemantics(file: string, exportName: string, graph: DependencyGraph, coUsageMatrix: Map<string, Map<string, number>>, typeGraph: Map<string, Set<string>>, exportTypeRefs?: string[]): DomainAssignment[];
+declare function calculateDomainConfidence(signals: DomainSignals): number;
 /**
- * Get co-usage data for a specific file
+ * Regex-based export extraction (legacy/fallback)
  */
-declare function getCoUsageData(file: string, coUsageMatrix: Map<string, Map<string, number>>): CoUsageData;
+declare function extractExports(content: string, filePath?: string, domainOptions?: {
+    domainKeywords?: string[];
+}, fileImports?: string[]): ExportInfo[];
 /**
- * Find files that should be consolidated based on semantic similarity
- *
- * High co-usage + shared types = strong consolidation candidate
+ * Infer domain from name, path, or imports
  */
-declare function findConsolidationCandidates(graph: DependencyGraph, coUsageMatrix: Map<string, Map<string, number>>, typeGraph: Map<string, Set<string>>, minCoUsage?: number, minSharedTypes?: number): Array<{
-    files: string[];
-    reason: string;
-    strength: number;
-}>;
+declare function inferDomain(name: string, filePath?: string, domainOptions?: {
+    domainKeywords?: string[];
+}, fileImports?: string[]): string;
+declare function getCoUsageData(file: string, coUsageMatrix: Map<string, Map<string, number>>): CoUsageData;
+declare function findConsolidationCandidates(graph: DependencyGraph, coUsageMatrix: Map<string, Map<string, number>>, typeGraph: Map<string, Set<string>>, minCoUsage?: number, minSharedTypes?: number): any[];
 
-/**
- * Generate smart defaults for context analysis based on repository size
- * Automatically tunes thresholds to target ~10 most serious issues
- */
-declare function getSmartDefaults(directory: string, userOptions: Partial<ContextAnalyzerOptions>): Promise<ContextAnalyzerOptions>;
 /**
  * Analyze AI context window cost for a codebase
  */
 declare function analyzeContext(options: ContextAnalyzerOptions): Promise<ContextAnalysisResult[]>;
-/**
- * Generate summary of context analysis results
- */
-declare function generateSummary(results: ContextAnalysisResult[]): ContextSummary;
 
-export { type CoUsageData, type ContextAnalysisResult, type ContextAnalyzerOptions, type ContextSummary, type DomainAssignment, type DomainSignals, type FileClassification, type ModuleCluster, type TypeDependency, adjustFragmentationForClassification, analyzeContext, buildCoUsageMatrix, buildTypeGraph, calculateContextScore, calculateDomainConfidence, classifyFile, findConsolidationCandidates, findSemanticClusters, generateSummary, getCoUsageData, getSmartDefaults, inferDomainFromSemantics };
+export { type CoUsageData, type ContextAnalysisResult, type ContextAnalyzerOptions, type ContextSummary, type DependencyGraph, type DependencyNode, type DomainAssignment, type DomainSignals, type ExportInfo, type FileClassification, type ModuleCluster, type TypeDependency, adjustCohesionForClassification, adjustFragmentationForClassification, analyzeContext, analyzeIssues, buildCoUsageMatrix, buildDependencyGraph, buildTypeGraph, calculateCohesion, calculateContextBudget, calculateContextScore, calculateDirectoryDistance, calculateDomainConfidence, calculateEnhancedCohesion, calculateFragmentation, calculateImportDepth, calculatePathEntropy, calculateStructuralCohesionFromCoUsage, classifyFile, detectCircularDependencies, detectModuleClusters, extractDomainKeywordsFromPaths, extractExports, extractImportsFromContent, findConsolidationCandidates, findSemanticClusters, generateSummary, getClassificationRecommendations, getCoUsageData, getGeneralRecommendations, getSmartDefaults, getTransitiveDependencies, inferDomain, inferDomainFromSemantics, isBarrelExport, isConfigFile, isEmailTemplate, isLambdaHandler, isNextJsPage, isParserFile, isServiceFile, isSessionFile, isTypeDefinition, isUtilityModule, mapScoreToRating };