@aiready/context-analyzer 0.9.26 → 0.9.28

package/dist/cli.js

@@ -37,7 +37,7 @@ __export(python_context_exports, {
 });
 async function analyzePythonContext(files, rootDir) {
   const results = [];
-  const parser = (0, import_core2.getParser)("dummy.py");
+  const parser = (0, import_core3.getParser)("dummy.py");
   if (!parser) {
     console.warn("Python parser not available");
     return results;
@@ -86,7 +86,7 @@ async function analyzePythonContext(files, rootDir) {
 }
 async function buildPythonDependencyGraph(files, rootDir) {
   const graph = /* @__PURE__ */ new Map();
-  const parser = (0, import_core2.getParser)("dummy.py");
+  const parser = (0, import_core3.getParser)("dummy.py");
   if (!parser) return graph;
   for (const file of files) {
     try {
@@ -167,7 +167,7 @@ async function calculatePythonImportDepth(file, dependencyGraph, visited, depth
   return maxDepth;
 }
 function estimateContextBudget(code, imports, dependencyGraph) {
-  let budget = (0, import_core2.estimateTokens)(code);
+  let budget = (0, import_core3.estimateTokens)(code);
   const avgTokensPerDep = 500;
   budget += imports.length * avgTokensPerDep;
   return budget;
@@ -217,11 +217,11 @@ function detectCircularDependencies2(file, dependencyGraph) {
   dfs(file, []);
   return [...new Set(circular)];
 }
-var import_core2, import_path;
+var import_core3, import_path;
 var init_python_context = __esm({
   "src/analyzers/python-context.ts"() {
     "use strict";
-    import_core2 = require("@aiready/core");
+    import_core3 = require("@aiready/core");
     import_path = require("path");
   }
 });
@@ -230,7 +230,7 @@ var init_python_context = __esm({
 var import_commander = require("commander");
 
 // src/index.ts
-var import_core3 = require("@aiready/core");
+var import_core4 = require("@aiready/core");
 
 // src/analyzer.ts
 var import_core = require("@aiready/core");
@@ -570,9 +570,9 @@ function calculatePathEntropy(files) {
   if (counts.length <= 1) return 0;
   const total = counts.reduce((s, v) => s + v, 0);
   let entropy = 0;
-  for (const c of counts) {
-    const p = c / total;
-    entropy -= p * Math.log2(p);
+  for (const count of counts) {
+    const prob = count / total;
+    entropy -= prob * Math.log2(prob);
   }
   const maxEntropy = Math.log2(counts.length);
   return maxEntropy > 0 ? entropy / maxEntropy : 0;
@@ -840,8 +840,8 @@ function calculateStructuralCohesionFromCoUsage(file, coUsageMatrix) {
   }
   if (probs.length <= 1) return 1;
   let entropy = 0;
-  for (const p of probs) {
-    entropy -= p * Math.log2(p);
+  for (const prob of probs) {
+    entropy -= prob * Math.log2(prob);
   }
   const maxEntropy = Math.log2(probs.length);
   return maxEntropy > 0 ? 1 - entropy / maxEntropy : 1;
@@ -881,10 +881,10 @@ function calculateDomainCohesion(exports2) {
   }
   const total = domains.length;
   let entropy = 0;
-  for (const count of domainCounts.values()) {
-    const p = count / total;
-    if (p > 0) {
-      entropy -= p * Math.log2(p);
+  for (const domainCount of domainCounts.values()) {
+    const prob = domainCount / total;
+    if (prob > 0) {
+      entropy -= prob * Math.log2(prob);
     }
   }
   const maxEntropy = Math.log2(total);
@@ -904,6 +904,9 @@ function classifyFile(node, cohesionScore, domains) {
   if (isLambdaHandler(node)) {
     return "lambda-handler";
   }
+  if (isDataAccessFile(node)) {
+    return "cohesive-module";
+  }
   if (isEmailTemplate(node)) {
     return "email-template";
   }
@@ -922,11 +925,17 @@ function classifyFile(node, cohesionScore, domains) {
   if (isUtilityFile(node)) {
     return "utility-module";
   }
+  if (file.toLowerCase().includes("/utils/") || file.toLowerCase().includes("/helpers/")) {
+    return "utility-module";
+  }
   const uniqueDomains = domains.filter((d) => d !== "unknown");
   const hasSingleDomain = uniqueDomains.length <= 1;
   if (hasSingleDomain) {
     return "cohesive-module";
   }
+  if (allExportsShareEntityNoun(exports2)) {
+    return "cohesive-module";
+  }
   const hasMultipleDomains = uniqueDomains.length > 1;
   const hasLowCohesion = cohesionScore < 0.4;
   if (hasMultipleDomains && hasLowCohesion) {
@@ -1018,6 +1027,107 @@ function isUtilityFile(node) {
   const hasManySmallExportsInUtilityContext = exports2.length >= 3 && exports2.every((e) => e.type === "function" || e.type === "const") && (isUtilityName || isUtilityPath);
   return isUtilityName || isUtilityPath || hasManySmallExportsInUtilityContext;
 }
+function splitCamelCase(name) {
+  return name.replace(/([A-Z])/g, " $1").trim().toLowerCase().split(/[\s_-]+/).filter(Boolean);
+}
+var SKIP_WORDS = /* @__PURE__ */ new Set([
+  "get",
+  "set",
+  "create",
+  "update",
+  "delete",
+  "fetch",
+  "save",
+  "load",
+  "parse",
+  "format",
+  "validate",
+  "convert",
+  "transform",
+  "build",
+  "generate",
+  "render",
+  "send",
+  "receive",
+  "find",
+  "list",
+  "add",
+  "remove",
+  "insert",
+  "upsert",
+  "put",
+  "read",
+  "write",
+  "check",
+  "handle",
+  "process",
+  "compute",
+  "calculate",
+  "init",
+  "reset",
+  "clear",
+  "pending",
+  "active",
+  "current",
+  "new",
+  "old",
+  "all",
+  "by",
+  "with",
+  "from",
+  "to",
+  "and",
+  "or",
+  "is",
+  "has",
+  "in",
+  "on",
+  "of",
+  "the"
+]);
+function simpleSingularize(word) {
+  if (word.endsWith("ies") && word.length > 3) return word.slice(0, -3) + "y";
+  if (word.endsWith("ses") && word.length > 4) return word.slice(0, -2);
+  if (word.endsWith("s") && word.length > 3) return word.slice(0, -1);
+  return word;
+}
+function extractEntityNouns(name) {
+  return splitCamelCase(name).filter((token) => !SKIP_WORDS.has(token) && token.length > 2).map(simpleSingularize);
+}
+function allExportsShareEntityNoun(exports2) {
+  if (exports2.length < 2 || exports2.length > 30) return false;
+  const nounSets = exports2.map((e) => new Set(extractEntityNouns(e.name)));
+  if (nounSets.some((s) => s.size === 0)) return false;
+  const [first, ...rest] = nounSets;
+  const commonNouns = Array.from(first).filter(
+    (noun) => rest.every((s) => s.has(noun))
+  );
+  return commonNouns.length > 0;
+}
+function isDataAccessFile(node) {
+  const { file, exports: exports2 } = node;
+  const fileName = file.split("/").pop()?.toLowerCase();
+  const dalPatterns = [
+    "dynamo",
+    "database",
+    "repository",
+    "repo",
+    "dao",
+    "firestore",
+    "postgres",
+    "mysql",
+    "mongo",
+    "redis",
+    "sqlite",
+    "supabase",
+    "prisma"
+  ];
+  const isDalName = dalPatterns.some((p) => fileName?.includes(p));
+  const isDalPath = file.toLowerCase().includes("/repositories/") || file.toLowerCase().includes("/dao/") || file.toLowerCase().includes("/data/");
+  const hasDalExportPattern = exports2.length >= 1 && exports2.length <= 10 && allExportsShareEntityNoun(exports2);
+  const isUtilityPathLocal = file.toLowerCase().includes("/utils/") || file.toLowerCase().includes("/helpers/");
+  return isDalPath || isDalName && hasDalExportPattern && !isUtilityPathLocal;
+}
 function isLambdaHandler(node) {
   const { file, exports: exports2 } = node;
   const fileName = file.split("/").pop()?.toLowerCase();
@@ -1032,7 +1142,7 @@ function isLambdaHandler(node) {
   const isHandlerName = handlerPatterns.some(
     (pattern) => fileName?.includes(pattern)
   );
-  const isHandlerPath = file.toLowerCase().includes("/handlers/") || file.toLowerCase().includes("/lambdas/") || file.toLowerCase().includes("/functions/");
+  const isHandlerPath = file.toLowerCase().includes("/handlers/") || file.toLowerCase().includes("/lambdas/") || file.toLowerCase().includes("/lambda/") || file.toLowerCase().includes("/functions/");
   const hasHandlerExport = exports2.some(
     (e) => e.name.toLowerCase() === "handler" || e.name.toLowerCase() === "main" || e.name.toLowerCase() === "lambdahandler" || e.name.toLowerCase().endsWith("handler")
   );
@@ -1172,25 +1282,25 @@ function adjustCohesionForClassification(baseCohesion, classification, node) {
         const exportNames = node.exports.map((e) => e.name.toLowerCase());
         const hasRelatedNames = hasRelatedExportNames(exportNames);
         if (hasRelatedNames) {
-          return Math.min(1, baseCohesion + 0.45);
+          return Math.max(0.8, Math.min(1, baseCohesion + 0.45));
         }
       }
-      return Math.min(1, baseCohesion + 0.35);
+      return Math.max(0.75, Math.min(1, baseCohesion + 0.35));
     }
     case "service-file": {
       if (node?.exports.some((e) => e.type === "class")) {
-        return Math.min(1, baseCohesion + 0.4);
+        return Math.max(0.78, Math.min(1, baseCohesion + 0.4));
       }
-      return Math.min(1, baseCohesion + 0.3);
+      return Math.max(0.72, Math.min(1, baseCohesion + 0.3));
     }
     case "lambda-handler": {
       if (node) {
         const hasSingleEntry = node.exports.length === 1 || node.exports.some((e) => e.name.toLowerCase() === "handler");
         if (hasSingleEntry) {
-          return Math.min(1, baseCohesion + 0.45);
+          return Math.max(0.8, Math.min(1, baseCohesion + 0.45));
         }
       }
-      return Math.min(1, baseCohesion + 0.35);
+      return Math.max(0.75, Math.min(1, baseCohesion + 0.35));
     }
     case "email-template": {
       if (node) {
@@ -1198,10 +1308,10 @@ function adjustCohesionForClassification(baseCohesion, classification, node) {
           (e) => e.name.toLowerCase().includes("render") || e.name.toLowerCase().includes("generate") || e.name.toLowerCase().includes("template")
         );
         if (hasTemplateFunc) {
-          return Math.min(1, baseCohesion + 0.4);
+          return Math.max(0.75, Math.min(1, baseCohesion + 0.4));
         }
       }
-      return Math.min(1, baseCohesion + 0.3);
+      return Math.max(0.72, Math.min(1, baseCohesion + 0.3));
     }
     case "parser-file": {
       if (node) {
@@ -1209,10 +1319,10 @@ function adjustCohesionForClassification(baseCohesion, classification, node) {
           (e) => e.name.toLowerCase().startsWith("parse") || e.name.toLowerCase().startsWith("transform") || e.name.toLowerCase().startsWith("convert")
         );
         if (hasParseFunc) {
-          return Math.min(1, baseCohesion + 0.4);
+          return Math.max(0.75, Math.min(1, baseCohesion + 0.4));
         }
       }
-      return Math.min(1, baseCohesion + 0.3);
+      return Math.max(0.7, Math.min(1, baseCohesion + 0.3));
     }
     case "nextjs-page":
       return 1;
@@ -1252,6 +1362,54 @@ function hasRelatedExportNames(exportNames) {
     const uniquePrefixes = new Set(prefixes);
     if (uniquePrefixes.size === 1) return true;
   }
+  const nounSets = exportNames.map((name) => {
+    const tokens = name.replace(/([A-Z])/g, " $1").trim().toLowerCase().split(/[\s_-]+/).filter(Boolean);
+    const skip = /* @__PURE__ */ new Set([
+      "get",
+      "set",
+      "create",
+      "update",
+      "delete",
+      "fetch",
+      "save",
+      "load",
+      "parse",
+      "format",
+      "validate",
+      "convert",
+      "transform",
+      "build",
+      "generate",
+      "render",
+      "send",
+      "receive",
+      "find",
+      "list",
+      "add",
+      "remove",
+      "insert",
+      "upsert",
+      "put",
+      "read",
+      "write",
+      "check",
+      "handle",
+      "process",
+      "pending",
+      "active",
+      "current",
+      "new",
+      "old",
+      "all"
+    ]);
+    const singularize2 = (w) => w.endsWith("s") && w.length > 3 ? w.slice(0, -1) : w;
+    return new Set(tokens.filter((t) => !skip.has(t) && t.length > 2).map(singularize2));
+  });
+  if (nounSets.length >= 2 && nounSets.every((s) => s.size > 0)) {
+    const [first, ...rest] = nounSets;
+    const commonNouns = Array.from(first).filter((n) => rest.every((s) => s.has(n)));
+    if (commonNouns.length > 0) return true;
+  }
   return false;
 }
 function adjustFragmentationForClassification(baseFragmentation, classification) {
@@ -1333,6 +1491,9 @@ function getClassificationRecommendations(classification, file, issues) {
   }
 }
 
+// src/scoring.ts
+var import_core2 = require("@aiready/core");
+
 // src/index.ts
 async function analyzeContext(options) {
   const {
@@ -1344,7 +1505,7 @@ async function analyzeContext(options) {
     includeNodeModules = false,
     ...scanOptions
   } = options;
-  const files = await (0, import_core3.scanFiles)({
+  const files = await (0, import_core4.scanFiles)({
     ...scanOptions,
     // Only add node_modules to exclude if includeNodeModules is false
     // The DEFAULT_EXCLUDE already includes node_modules, so this is only needed
@@ -1356,7 +1517,7 @@ async function analyzeContext(options) {
   const fileContents = await Promise.all(
     files.map(async (file) => ({
       file,
-      content: await (0, import_core3.readFileContent)(file)
+      content: await (0, import_core4.readFileContent)(file)
     }))
   );
   const graph = buildDependencyGraph(fileContents.filter((f) => !f.file.toLowerCase().endsWith(".py")));
@@ -1419,7 +1580,7 @@ async function analyzeContext(options) {
     const importDepth = focus === "depth" || focus === "all" ? calculateImportDepth(file, graph) : 0;
     const dependencyList = focus === "depth" || focus === "all" ? getTransitiveDependencies(file, graph) : [];
     const contextBudget = focus === "all" ? calculateContextBudget(file, graph) : node.tokenCost;
-    const cohesionScore = focus === "cohesion" || focus === "all" ? calculateCohesion(node.exports, file) : 1;
+    const cohesionScore = focus === "cohesion" || focus === "all" ? calculateCohesion(node.exports, file, { coUsageMatrix: graph.coUsageMatrix }) : 1;
     const fragmentationScore = fragmentationMap.get(file) || 0;
     const relatedFiles = [];
     for (const cluster of clusters) {
@@ -1728,7 +1889,7 @@ function downgradeSeverity(s) {
 var import_chalk = __toESM(require("chalk"));
 var import_fs = require("fs");
 var import_path2 = require("path");
-var import_core4 = require("@aiready/core");
+var import_core5 = require("@aiready/core");
 var import_prompts = __toESM(require("prompts"));
 var program = new import_commander.Command();
 program.name("aiready-context").description("Analyze AI context window cost and code structure").version("0.1.0").addHelpText("after", "\nCONFIGURATION:\n  Supports config files: aiready.json, aiready.config.json, .aiready.json, .aireadyrc.json, aiready.config.js, .aireadyrc.js\n  CLI options override config file settings").argument("<directory>", "Directory to analyze").option("--max-depth <number>", "Maximum acceptable import depth").option(
@@ -1759,7 +1920,7 @@ program.name("aiready-context").description("Analyze AI context window cost and
       exclude: void 0,
       maxResults: 10
     };
-    let finalOptions = await (0, import_core4.loadMergedConfig)(directory, defaults, {
+    let finalOptions = await (0, import_core5.loadMergedConfig)(directory, defaults, {
       maxDepth: options.maxDepth ? parseInt(options.maxDepth) : void 0,
       maxContextBudget: options.maxContext ? parseInt(options.maxContext) : void 0,
       minCohesion: options.minCohesion ? parseFloat(options.minCohesion) : void 0,
@@ -1774,7 +1935,7 @@ program.name("aiready-context").description("Analyze AI context window cost and
       finalOptions = await runInteractiveSetup(directory, finalOptions);
     }
     const results = await analyzeContext(finalOptions);
-    const elapsedTime = (0, import_core4.getElapsedTime)(startTime);
+    const elapsedTime = (0, import_core5.getElapsedTime)(startTime);
     const summary = generateSummary(results);
     if (options.output === "json") {
       const jsonOutput = {
@@ -1783,18 +1944,18 @@ program.name("aiready-context").description("Analyze AI context window cost and
         timestamp: (/* @__PURE__ */ new Date()).toISOString(),
         analysisTime: elapsedTime
       };
-      const outputPath = (0, import_core4.resolveOutputPath)(
+      const outputPath = (0, import_core5.resolveOutputPath)(
         options.outputFile,
         `context-report-${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}.json`,
         directory
       );
-      (0, import_core4.handleJSONOutput)(jsonOutput, outputPath, `
+      (0, import_core5.handleJSONOutput)(jsonOutput, outputPath, `
 \u2713 JSON report saved to ${outputPath}`);
       return;
     }
     if (options.output === "html") {
       const html = generateHTMLReport(summary, results);
-      const outputPath = (0, import_core4.resolveOutputPath)(
+      const outputPath = (0, import_core5.resolveOutputPath)(
         options.outputFile,
         `context-report-${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}.html`,
         directory
@@ -1811,7 +1972,7 @@ program.name("aiready-context").description("Analyze AI context window cost and
     displayConsoleReport(summary, results, elapsedTime, finalOptions.maxResults);
     displayTuningGuidance(results, finalOptions);
   } catch (error) {
-    (0, import_core4.handleCLIError)(error, "Analysis");
+    (0, import_core5.handleCLIError)(error, "Analysis");
   }
 });
 program.parse();

package/dist/cli.mjs

@@ -2,7 +2,7 @@
 import {
   analyzeContext,
   generateSummary
-} from "./chunk-PJD4VCIH.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;
@@ -158,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;
@@ -158,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