@aiready/context-analyzer 0.9.25 → 0.9.28

package/src/index.ts

@@ -12,6 +12,7 @@ import {
   calculatePathEntropy,
   calculateDirectoryDistance,
   classifyFile,
+  adjustCohesionForClassification,
   adjustFragmentationForClassification,
   getClassificationRecommendations,
 } from './analyzer';
@@ -252,7 +253,7 @@ export async function analyzeContext(
 
     const cohesionScore =
       focus === 'cohesion' || focus === 'all'
-        ? calculateCohesion(node.exports, file)
+        ? calculateCohesion(node.exports, file, { coUsageMatrix: graph.coUsageMatrix })
         : 1;
 
     const fragmentationScore = fragmentationMap.get(file) || 0;
@@ -289,6 +290,13 @@ export async function analyzeContext(
     // Classify the file to help distinguish real issues from false positives
     const fileClassification = classifyFile(node, cohesionScore, domains);
     
+    // Adjust cohesion based on classification (utility/service/handler files get boosted)
+    const adjustedCohesionScore = adjustCohesionForClassification(
+      cohesionScore,
+      fileClassification,
+      node
+    );
+    
     // Adjust fragmentation based on classification
     const adjustedFragmentationScore = adjustFragmentationForClassification(
       fragmentationScore,
@@ -302,7 +310,7 @@ export async function analyzeContext(
       issues
     );
 
-    // Re-analyze issues with adjusted fragmentation
+    // Re-analyze issues with adjusted cohesion and fragmentation
     const {
       severity: adjustedSeverity,
       issues: adjustedIssues,
@@ -312,7 +320,7 @@ export async function analyzeContext(
       file,
       importDepth,
       contextBudget,
-      cohesionScore,
+      cohesionScore: adjustedCohesionScore, // Use adjusted cohesion
       fragmentationScore: adjustedFragmentationScore,
       maxDepth,
       maxContextBudget,
@@ -329,7 +337,7 @@ export async function analyzeContext(
       dependencyCount: dependencyList.length,
       dependencyList,
       circularDeps: circularDeps.filter((cycle) => cycle.includes(file)),
-      cohesionScore,
+      cohesionScore: adjustedCohesionScore, // Report adjusted cohesion
       domains,
       exportCount: node.exports.length,
       contextBudget,

package/src/scoring.ts

@@ -1,3 +1,9 @@
+import { 
+  calculateMonthlyCost, 
+  calculateProductivityImpact,
+  DEFAULT_COST_CONFIG,
+  type CostConfig 
+} from '@aiready/core';
 import type { ToolScoringOutput } from '@aiready/core';
 import type { ContextSummary } from './types';
 
@@ -9,9 +15,14 @@ import type { ContextSummary } from './types';
  * - 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
  */
 export function calculateContextScore(
-  summary: ContextSummary
+  summary: ContextSummary,
+  costConfig?: Partial<CostConfig>
 ): ToolScoringOutput {
   const {
     avgContextBudget,
@@ -144,6 +155,19 @@ export function calculateContextScore(
     });
   }
   
+  // Calculate business value metrics
+  const cfg = { ...DEFAULT_COST_CONFIG, ...costConfig };
+  // Total context budget across all files
+  const totalContextBudget = avgContextBudget * summary.totalFiles;
+  const estimatedMonthlyCost = calculateMonthlyCost(totalContextBudget, cfg);
+  
+  // Convert issues to format for productivity calculation
+  const issues = [
+    ...Array(criticalIssues).fill({ severity: 'critical' as const }),
+    ...Array(majorIssues).fill({ severity: 'major' as const }),
+  ];
+  const productivityImpact = calculateProductivityImpact(issues);
+  
   return {
     toolName: 'context-analyzer',
     score,
@@ -155,6 +179,9 @@ export function calculateContextScore(
       avgFragmentation: Math.round(avgFragmentation * 100) / 100,
       criticalIssues,
       majorIssues,
+      // Business value metrics
+      estimatedMonthlyCost,
+      estimatedDeveloperHours: productivityImpact.totalHours,
     },
     factors,
     recommendations,

package/src/types.ts

@@ -50,6 +50,12 @@ export type FileClassification =
   | '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
+  | 'nextjs-page'      // Next.js App Router page with SEO/structured data exports
   | 'mixed-concerns'   // Multiple domains, potential refactoring candidate
   | 'unknown';         // Unable to classify