@aiready/context-analyzer 0.19.17 → 0.19.21

package/dist/cli.mjs

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

package/dist/index.d.mts

@@ -192,56 +192,116 @@ declare function calculatePathEntropy(files: string[]): number;
  */
 declare function calculateDirectoryDistance(files: string[]): number;
 
+/**
+ * Constants for file classifications to avoid magic strings
+ */
+declare const Classification: {
+    BARREL: "barrel-export";
+    TYPE_DEFINITION: "type-definition";
+    NEXTJS_PAGE: "nextjs-page";
+    LAMBDA_HANDLER: "lambda-handler";
+    SERVICE: "service-file";
+    EMAIL_TEMPLATE: "email-template";
+    PARSER: "parser-file";
+    COHESIVE_MODULE: "cohesive-module";
+    UTILITY_MODULE: "utility-module";
+    MIXED_CONCERNS: "mixed-concerns";
+    UNKNOWN: "unknown";
+};
 /**
  * Classify a file into a specific type for better analysis context
+ *
+ * @param node The dependency node representing the file
+ * @param cohesionScore The calculated cohesion score for the file
+ * @param domains The detected domains/concerns for the file
+ * @returns The determined file classification
  */
 declare function classifyFile(node: DependencyNode, cohesionScore?: number, domains?: string[]): FileClassification;
 /**
  * Detect if a file is a barrel export (index.ts)
+ *
+ * @param node The dependency node to check
+ * @returns True if the file appears to be a barrel export
  */
 declare function isBarrelExport(node: DependencyNode): boolean;
 /**
  * Detect if a file is primarily type definitions
+ *
+ * @param node The dependency node to check
+ * @returns True if the file appears to be primarily types
  */
 declare function isTypeDefinition(node: DependencyNode): boolean;
 /**
  * Detect if a file is a utility module
+ *
+ * @param node The dependency node to check
+ * @returns True if the file appears to be a utility module
  */
 declare function isUtilityModule(node: DependencyNode): boolean;
 /**
  * Detect if a file is a Lambda/API handler
+ *
+ * @param node The dependency node to check
+ * @returns True if the file appears to be a Lambda handler
  */
 declare function isLambdaHandler(node: DependencyNode): boolean;
 /**
  * Detect if a file is a service file
+ *
+ * @param node The dependency node to check
+ * @returns True if the file appears to be a service file
  */
 declare function isServiceFile(node: DependencyNode): boolean;
 /**
  * Detect if a file is an email template/layout
+ *
+ * @param node The dependency node to check
+ * @returns True if the file appears to be an email template
  */
 declare function isEmailTemplate(node: DependencyNode): boolean;
 /**
  * Detect if a file is a parser/transformer
+ *
+ * @param node The dependency node to check
+ * @returns True if the file appears to be a parser
  */
 declare function isParserFile(node: DependencyNode): boolean;
 /**
  * Detect if a file is a session/state management file
+ *
+ * @param node The dependency node to check
+ * @returns True if the file appears to be a session/state file
  */
 declare function isSessionFile(node: DependencyNode): boolean;
 /**
  * Detect if a file is a configuration or schema file
+ *
+ * @param node The dependency node to check
+ * @returns True if the file appears to be a config file
  */
 declare function isConfigFile(node: DependencyNode): boolean;
 /**
  * Detect if a file is a Next.js App Router page
+ *
+ * @param node The dependency node to check
+ * @returns True if the file appears to be a Next.js page
  */
 declare function isNextJsPage(node: DependencyNode): boolean;
 /**
  * Adjust cohesion score based on file classification
+ *
+ * @param baseCohesion The initial cohesion score
+ * @param classification The file classification
+ * @param node Optional dependency node for further context
+ * @returns The adjusted cohesion score
  */
 declare function adjustCohesionForClassification(baseCohesion: number, classification: FileClassification, node?: DependencyNode): number;
 /**
  * Adjust fragmentation score based on file classification
+ *
+ * @param baseFragmentation The initial fragmentation score
+ * @param classification The file classification
+ * @returns The adjusted fragmentation score
  */
 declare function adjustFragmentationForClassification(baseFragmentation: number, classification: FileClassification): number;
 
@@ -301,6 +361,10 @@ declare function analyzeIssues(params: {
     recommendations: string[];
     potentialSavings: number;
 };
+/**
+ * Analyze AI context window cost for a codebase
+ */
+declare function analyzeContext(options: ContextAnalyzerOptions): Promise<ContextAnalysisResult[]>;
 
 /**
  * Calculate AI Readiness Score for context efficiency (0-100)
@@ -351,9 +415,4 @@ declare function inferDomain(name: string, filePath?: string, domainOptions?: {
 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[];
 
-/**
- * Analyze AI context window cost for a codebase
- */
-declare function analyzeContext(options: ContextAnalyzerOptions): Promise<ContextAnalysisResult[]>;
-
-export { type CoUsageData, type ContextAnalysisResult, type ContextAnalyzerOptions, ContextAnalyzerProvider, 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, findConsolidationCandidates, findSemanticClusters, generateSummary, getClassificationRecommendations, getCoUsageData, getGeneralRecommendations, getSmartDefaults, getTransitiveDependencies, inferDomain, inferDomainFromSemantics, isBarrelExport, isConfigFile, isEmailTemplate, isLambdaHandler, isNextJsPage, isParserFile, isServiceFile, isSessionFile, isTypeDefinition, isUtilityModule, mapScoreToRating };
+export { Classification, type CoUsageData, type ContextAnalysisResult, type ContextAnalyzerOptions, ContextAnalyzerProvider, 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, 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

@@ -192,56 +192,116 @@ declare function calculatePathEntropy(files: string[]): number;
  */
 declare function calculateDirectoryDistance(files: string[]): number;
 
+/**
+ * Constants for file classifications to avoid magic strings
+ */
+declare const Classification: {
+    BARREL: "barrel-export";
+    TYPE_DEFINITION: "type-definition";
+    NEXTJS_PAGE: "nextjs-page";
+    LAMBDA_HANDLER: "lambda-handler";
+    SERVICE: "service-file";
+    EMAIL_TEMPLATE: "email-template";
+    PARSER: "parser-file";
+    COHESIVE_MODULE: "cohesive-module";
+    UTILITY_MODULE: "utility-module";
+    MIXED_CONCERNS: "mixed-concerns";
+    UNKNOWN: "unknown";
+};
 /**
  * Classify a file into a specific type for better analysis context
+ *
+ * @param node The dependency node representing the file
+ * @param cohesionScore The calculated cohesion score for the file
+ * @param domains The detected domains/concerns for the file
+ * @returns The determined file classification
  */
 declare function classifyFile(node: DependencyNode, cohesionScore?: number, domains?: string[]): FileClassification;
 /**
  * Detect if a file is a barrel export (index.ts)
+ *
+ * @param node The dependency node to check
+ * @returns True if the file appears to be a barrel export
  */
 declare function isBarrelExport(node: DependencyNode): boolean;
 /**
  * Detect if a file is primarily type definitions
+ *
+ * @param node The dependency node to check
+ * @returns True if the file appears to be primarily types
  */
 declare function isTypeDefinition(node: DependencyNode): boolean;
 /**
  * Detect if a file is a utility module
+ *
+ * @param node The dependency node to check
+ * @returns True if the file appears to be a utility module
  */
 declare function isUtilityModule(node: DependencyNode): boolean;
 /**
  * Detect if a file is a Lambda/API handler
+ *
+ * @param node The dependency node to check
+ * @returns True if the file appears to be a Lambda handler
  */
 declare function isLambdaHandler(node: DependencyNode): boolean;
 /**
  * Detect if a file is a service file
+ *
+ * @param node The dependency node to check
+ * @returns True if the file appears to be a service file
  */
 declare function isServiceFile(node: DependencyNode): boolean;
 /**
  * Detect if a file is an email template/layout
+ *
+ * @param node The dependency node to check
+ * @returns True if the file appears to be an email template
  */
 declare function isEmailTemplate(node: DependencyNode): boolean;
 /**
  * Detect if a file is a parser/transformer
+ *
+ * @param node The dependency node to check
+ * @returns True if the file appears to be a parser
  */
 declare function isParserFile(node: DependencyNode): boolean;
 /**
  * Detect if a file is a session/state management file
+ *
+ * @param node The dependency node to check
+ * @returns True if the file appears to be a session/state file
  */
 declare function isSessionFile(node: DependencyNode): boolean;
 /**
  * Detect if a file is a configuration or schema file
+ *
+ * @param node The dependency node to check
+ * @returns True if the file appears to be a config file
  */
 declare function isConfigFile(node: DependencyNode): boolean;
 /**
  * Detect if a file is a Next.js App Router page
+ *
+ * @param node The dependency node to check
+ * @returns True if the file appears to be a Next.js page
  */
 declare function isNextJsPage(node: DependencyNode): boolean;
 /**
  * Adjust cohesion score based on file classification
+ *
+ * @param baseCohesion The initial cohesion score
+ * @param classification The file classification
+ * @param node Optional dependency node for further context
+ * @returns The adjusted cohesion score
  */
 declare function adjustCohesionForClassification(baseCohesion: number, classification: FileClassification, node?: DependencyNode): number;
 /**
  * Adjust fragmentation score based on file classification
+ *
+ * @param baseFragmentation The initial fragmentation score
+ * @param classification The file classification
+ * @returns The adjusted fragmentation score
  */
 declare function adjustFragmentationForClassification(baseFragmentation: number, classification: FileClassification): number;
 
@@ -301,6 +361,10 @@ declare function analyzeIssues(params: {
     recommendations: string[];
     potentialSavings: number;
 };
+/**
+ * Analyze AI context window cost for a codebase
+ */
+declare function analyzeContext(options: ContextAnalyzerOptions): Promise<ContextAnalysisResult[]>;
 
 /**
  * Calculate AI Readiness Score for context efficiency (0-100)
@@ -351,9 +415,4 @@ declare function inferDomain(name: string, filePath?: string, domainOptions?: {
 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[];
 
-/**
- * Analyze AI context window cost for a codebase
- */
-declare function analyzeContext(options: ContextAnalyzerOptions): Promise<ContextAnalysisResult[]>;
-
-export { type CoUsageData, type ContextAnalysisResult, type ContextAnalyzerOptions, ContextAnalyzerProvider, 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, findConsolidationCandidates, findSemanticClusters, generateSummary, getClassificationRecommendations, getCoUsageData, getGeneralRecommendations, getSmartDefaults, getTransitiveDependencies, inferDomain, inferDomainFromSemantics, isBarrelExport, isConfigFile, isEmailTemplate, isLambdaHandler, isNextJsPage, isParserFile, isServiceFile, isSessionFile, isTypeDefinition, isUtilityModule, mapScoreToRating };
+export { Classification, type CoUsageData, type ContextAnalysisResult, type ContextAnalyzerOptions, ContextAnalyzerProvider, 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, findConsolidationCandidates, findSemanticClusters, generateSummary, getClassificationRecommendations, getCoUsageData, getGeneralRecommendations, getSmartDefaults, getTransitiveDependencies, inferDomain, inferDomainFromSemantics, isBarrelExport, isConfigFile, isEmailTemplate, isLambdaHandler, isNextJsPage, isParserFile, isServiceFile, isSessionFile, isTypeDefinition, isUtilityModule, mapScoreToRating };