@aiready/context-analyzer 0.9.25 → 0.9.28

package/dist/cli.mjs

@@ -2,7 +2,7 @@
 import {
   analyzeContext,
   generateSummary
-} from "./chunk-HOUDVRG2.mjs";
+} from "./chunk-M64RHH4D.mjs";
 import "./chunk-Y6FXYEAI.mjs";
 
 // src/cli.ts

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { ScanOptions, ToolScoringOutput } from '@aiready/core';
+import { ScanOptions, CostConfig, ToolScoringOutput } from '@aiready/core';
 
 interface ContextAnalyzerOptions extends ScanOptions {
     maxDepth?: number;
@@ -32,7 +32,7 @@ interface ContextAnalysisResult {
  * Classification of file type for analysis context
  * Helps distinguish real issues from false positives
  */
-type FileClassification = 'barrel-export' | 'type-definition' | 'cohesive-module' | 'mixed-concerns' | 'unknown';
+type FileClassification = 'barrel-export' | 'type-definition' | 'cohesive-module' | 'utility-module' | 'service-file' | 'lambda-handler' | 'email-template' | 'parser-file' | 'nextjs-page' | 'mixed-concerns' | 'unknown';
 interface ModuleCluster {
     domain: string;
     files: string[];
@@ -130,6 +130,11 @@ interface TypeDependency {
  * - 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
  */
@@ -141,6 +146,7 @@ declare function classifyFile(node: DependencyNode, cohesionScore: number, domai
  * - 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;
 
@@ -152,8 +158,12 @@ declare function adjustFragmentationForClassification(baseFragmentation: number,
  * - 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): ToolScoringOutput;
+declare function calculateContextScore(summary: ContextSummary, costConfig?: Partial<CostConfig>): ToolScoringOutput;
 
 /**
  * Build co-usage matrix: track which files are imported together

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { ScanOptions, ToolScoringOutput } from '@aiready/core';
+import { ScanOptions, CostConfig, ToolScoringOutput } from '@aiready/core';
 
 interface ContextAnalyzerOptions extends ScanOptions {
     maxDepth?: number;
@@ -32,7 +32,7 @@ interface ContextAnalysisResult {
  * Classification of file type for analysis context
  * Helps distinguish real issues from false positives
  */
-type FileClassification = 'barrel-export' | 'type-definition' | 'cohesive-module' | 'mixed-concerns' | 'unknown';
+type FileClassification = 'barrel-export' | 'type-definition' | 'cohesive-module' | 'utility-module' | 'service-file' | 'lambda-handler' | 'email-template' | 'parser-file' | 'nextjs-page' | 'mixed-concerns' | 'unknown';
 interface ModuleCluster {
     domain: string;
     files: string[];
@@ -130,6 +130,11 @@ interface TypeDependency {
  * - 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
  */
@@ -141,6 +146,7 @@ declare function classifyFile(node: DependencyNode, cohesionScore: number, domai
  * - 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;
 
@@ -152,8 +158,12 @@ declare function adjustFragmentationForClassification(baseFragmentation: number,
  * - 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): ToolScoringOutput;
+declare function calculateContextScore(summary: ContextSummary, costConfig?: Partial<CostConfig>): ToolScoringOutput;
 
 /**
  * Build co-usage matrix: track which files are imported together