@aiready/context-analyzer 0.9.26 → 0.9.28

package/dist/index.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");
   }
 });
@@ -244,7 +244,7 @@ __export(index_exports, {
   inferDomainFromSemantics: () => inferDomainFromSemantics
 });
 module.exports = __toCommonJS(index_exports);
-var import_core3 = require("@aiready/core");
+var import_core4 = require("@aiready/core");
 
 // src/analyzer.ts
 var import_core = require("@aiready/core");
@@ -645,9 +645,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;
@@ -915,8 +915,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;
@@ -956,10 +956,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);
@@ -979,6 +979,9 @@ function classifyFile(node, cohesionScore, domains) {
   if (isLambdaHandler(node)) {
     return "lambda-handler";
   }
+  if (isDataAccessFile(node)) {
+    return "cohesive-module";
+  }
   if (isEmailTemplate(node)) {
     return "email-template";
   }
@@ -997,11 +1000,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) {
@@ -1093,6 +1102,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();
@@ -1107,7 +1217,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")
   );
@@ -1247,25 +1357,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) {
@@ -1273,10 +1383,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) {
@@ -1284,10 +1394,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;
@@ -1327,6 +1437,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) {
@@ -1409,7 +1567,8 @@ function getClassificationRecommendations(classification, file, issues) {
 }
 
 // src/scoring.ts
-function calculateContextScore(summary) {
+var import_core2 = require("@aiready/core");
+function calculateContextScore(summary, costConfig) {
   const {
     avgContextBudget,
     maxContextBudget,
@@ -1498,6 +1657,14 @@ function calculateContextScore(summary) {
       priority: "high"
     });
   }
+  const cfg = { ...import_core2.DEFAULT_COST_CONFIG, ...costConfig };
+  const totalContextBudget = avgContextBudget * summary.totalFiles;
+  const estimatedMonthlyCost = (0, import_core2.calculateMonthlyCost)(totalContextBudget, cfg);
+  const issues = [
+    ...Array(criticalIssues).fill({ severity: "critical" }),
+    ...Array(majorIssues).fill({ severity: "major" })
+  ];
+  const productivityImpact = (0, import_core2.calculateProductivityImpact)(issues);
   return {
     toolName: "context-analyzer",
     score,
@@ -1508,7 +1675,10 @@ function calculateContextScore(summary) {
       maxImportDepth,
       avgFragmentation: Math.round(avgFragmentation * 100) / 100,
       criticalIssues,
-      majorIssues
+      majorIssues,
+      // Business value metrics
+      estimatedMonthlyCost,
+      estimatedDeveloperHours: productivityImpact.totalHours
     },
     factors,
     recommendations
@@ -1517,7 +1687,7 @@ function calculateContextScore(summary) {
 
 // src/index.ts
 async function getSmartDefaults(directory, userOptions) {
-  const files = await (0, import_core3.scanFiles)({
+  const files = await (0, import_core4.scanFiles)({
     rootDir: directory,
     include: userOptions.include,
     exclude: userOptions.exclude
@@ -1570,7 +1740,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
@@ -1582,7 +1752,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")));
@@ -1645,7 +1815,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) {

package/dist/index.mjs

@@ -12,7 +12,7 @@ import {
   getCoUsageData,
   getSmartDefaults,
   inferDomainFromSemantics
-} from "./chunk-PJD4VCIH.mjs";
+} from "./chunk-M64RHH4D.mjs";
 import "./chunk-Y6FXYEAI.mjs";
 export {
   adjustFragmentationForClassification,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiready/context-analyzer",
-  "version": "0.9.26",
+  "version": "0.9.28",
   "description": "AI context window cost analysis - detect fragmented code, deep import chains, and expensive context budgets",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -49,7 +49,7 @@
     "commander": "^14.0.0",
     "chalk": "^5.3.0",
     "prompts": "^2.4.2",
-    "@aiready/core": "0.9.22"
+    "@aiready/core": "0.9.25"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",