@aiready/context-analyzer 0.21.6 → 0.21.8

package/dist/index.js

@@ -327,16 +327,6 @@ __export(index_exports, {
   getTransitiveDependencies: () => getTransitiveDependencies,
   inferDomain: () => inferDomain,
   inferDomainFromSemantics: () => inferDomainFromSemantics,
-  isBarrelExport: () => isBarrelExport,
-  isConfigFile: () => isConfigFile,
-  isEmailTemplate: () => isEmailTemplate,
-  isLambdaHandler: () => isLambdaHandler,
-  isNextJsPage: () => isNextJsPage,
-  isParserFile: () => isParserFile,
-  isServiceFile: () => isServiceFile,
-  isSessionFile: () => isSessionFile,
-  isTypeDefinition: () => isTypeDefinition,
-  isUtilityModule: () => isUtilityModule,
   mapScoreToRating: () => mapScoreToRating,
   runInteractiveSetup: () => runInteractiveSetup
 });
@@ -644,7 +634,7 @@ function extractExportsWithAST(content, filePath, domainOptions, fileImports) {
       dependencies: exp.dependencies,
       typeReferences: exp.typeReferences
     }));
-  } catch (error) {
+  } catch {
     return extractExports(content, filePath, domainOptions, fileImports);
   }
 }
@@ -1023,6 +1013,21 @@ function detectModuleClusters(graph, options) {
     domainMap.get(primaryDomain).push(file);
   }
   const clusters = [];
+  const generateSuggestedStructure = (files, tokens, fragmentation) => {
+    const targetFiles = Math.max(1, Math.ceil(tokens / 1e4));
+    const plan = [];
+    if (fragmentation > 0.5) {
+      plan.push(
+        `Consolidate ${files.length} files scattered across multiple directories into ${targetFiles} core module(s)`
+      );
+    }
+    if (tokens > 2e4) {
+      plan.push(
+        `Domain logic is very large (${Math.round(tokens / 1e3)}k tokens). Ensure clear sub-domain boundaries.`
+      );
+    }
+    return { targetFiles, consolidationPlan: plan };
+  };
   for (const [domain, files] of domainMap.entries()) {
     if (files.length < 2 || domain === "unknown") continue;
     const totalTokens = files.reduce((sum, file) => {
@@ -1068,87 +1073,15 @@ function detectModuleClusters(graph, options) {
   }
   return clusters;
 }
-function generateSuggestedStructure(files, tokens, fragmentation) {
-  const targetFiles = Math.max(1, Math.ceil(tokens / 1e4));
-  const plan = [];
-  if (fragmentation > 0.5) {
-    plan.push(
-      `Consolidate ${files.length} files scattered across multiple directories into ${targetFiles} core module(s)`
-    );
-  }
-  if (tokens > 2e4) {
-    plan.push(
-      `Domain logic is very large (${Math.round(tokens / 1e3)}k tokens). Ensure clear sub-domain boundaries.`
-    );
-  }
-  return { targetFiles, consolidationPlan: plan };
-}
 
-// src/classifier.ts
-var 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"
-};
-function classifyFile(node, cohesionScore = 1, domains = []) {
-  if (isBarrelExport(node)) {
-    return Classification.BARREL;
-  }
-  if (isTypeDefinition(node)) {
-    return Classification.TYPE_DEFINITION;
-  }
-  if (isNextJsPage(node)) {
-    return Classification.NEXTJS_PAGE;
-  }
-  if (isLambdaHandler(node)) {
-    return Classification.LAMBDA_HANDLER;
-  }
-  if (isServiceFile(node)) {
-    return Classification.SERVICE;
-  }
-  if (isEmailTemplate(node)) {
-    return Classification.EMAIL_TEMPLATE;
-  }
-  if (isParserFile(node)) {
-    return Classification.PARSER;
-  }
-  if (isSessionFile(node)) {
-    if (cohesionScore >= 0.25 && domains.length <= 1)
-      return Classification.COHESIVE_MODULE;
-    return Classification.UTILITY_MODULE;
-  }
-  if (isUtilityModule(node)) {
-    return Classification.UTILITY_MODULE;
-  }
-  if (isConfigFile(node)) {
-    return Classification.COHESIVE_MODULE;
-  }
-  if (domains.length <= 1 && domains[0] !== "unknown") {
-    return Classification.COHESIVE_MODULE;
-  }
-  if (domains.length > 1 && cohesionScore < 0.4) {
-    return Classification.MIXED_CONCERNS;
-  }
-  if (cohesionScore >= 0.7) {
-    return Classification.COHESIVE_MODULE;
-  }
-  return Classification.UNKNOWN;
-}
+// src/heuristics.ts
 function isBarrelExport(node) {
   const { file, exports: exports2 } = node;
   const fileName = file.split("/").pop()?.toLowerCase();
   const isIndexFile = fileName === "index.ts" || fileName === "index.js";
   const isSmallAndManyExports = node.tokenCost < 1e3 && (exports2 || []).length > 5;
   const isReexportPattern = (exports2 || []).length >= 5 && (exports2 || []).every(
-    (e) => e.type === "const" || e.type === "function" || e.type === "type" || e.type === "interface"
+    (e) => ["const", "function", "type", "interface"].includes(e.type)
   );
   return !!isIndexFile || !!isSmallAndManyExports || !!isReexportPattern;
 }
@@ -1158,20 +1091,19 @@ function isTypeDefinition(node) {
   const nodeExports = node.exports || [];
   const hasExports = nodeExports.length > 0;
   const areAllTypes = hasExports && nodeExports.every((e) => e.type === "type" || e.type === "interface");
-  const allTypes = !!areAllTypes;
-  const isTypePath = file.toLowerCase().includes("/types/") || file.toLowerCase().includes("/interfaces/") || file.toLowerCase().includes("/models/");
-  return allTypes || isTypePath && hasExports;
+  const isTypePath = /\/(types|interfaces|models)\//i.test(file);
+  return !!areAllTypes || isTypePath && hasExports;
 }
 function isUtilityModule(node) {
   const { file } = node;
-  const isUtilPath = file.toLowerCase().includes("/utils/") || file.toLowerCase().includes("/helpers/") || file.toLowerCase().includes("/util/") || file.toLowerCase().includes("/helper/");
-  const fileName = file.split("/").pop()?.toLowerCase();
-  const isUtilName = fileName?.includes("utils.") || fileName?.includes("helpers.") || fileName?.includes("util.") || fileName?.includes("helper.");
-  return !!isUtilPath || !!isUtilName;
+  const isUtilPath = /\/(utils|helpers|util|helper)\//i.test(file);
+  const fileName = file.split("/").pop()?.toLowerCase() || "";
+  const isUtilName = /(utils\.|helpers\.|util\.|helper\.)/i.test(fileName);
+  return isUtilPath || isUtilName;
 }
 function isLambdaHandler(node) {
   const { file, exports: exports2 } = node;
-  const fileName = file.split("/").pop()?.toLowerCase();
+  const fileName = file.split("/").pop()?.toLowerCase() || "";
   const handlerPatterns = [
     "handler",
     ".handler.",
@@ -1180,33 +1112,29 @@ function isLambdaHandler(node) {
     ".lambda.",
     "-lambda."
   ];
-  const isHandlerName = handlerPatterns.some(
-    (pattern) => fileName?.includes(pattern)
-  );
-  const isHandlerPath = file.toLowerCase().includes("/handlers/") || file.toLowerCase().includes("/lambdas/") || file.toLowerCase().includes("/lambda/") || file.toLowerCase().includes("/functions/");
+  const isHandlerName = handlerPatterns.some((p) => fileName.includes(p));
+  const isHandlerPath = /\/(handlers|lambdas|lambda|functions)\//i.test(file);
   const hasHandlerExport = (exports2 || []).some(
-    (e) => e.name.toLowerCase() === "handler" || e.name.toLowerCase() === "main" || e.name.toLowerCase() === "lambdahandler" || e.name.toLowerCase().endsWith("handler")
+    (e) => ["handler", "main", "lambdahandler"].includes(e.name.toLowerCase()) || e.name.toLowerCase().endsWith("handler")
   );
-  return !!isHandlerName || !!isHandlerPath || !!hasHandlerExport;
+  return isHandlerName || isHandlerPath || hasHandlerExport;
 }
 function isServiceFile(node) {
   const { file, exports: exports2 } = node;
-  const fileName = file.split("/").pop()?.toLowerCase();
+  const fileName = file.split("/").pop()?.toLowerCase() || "";
   const servicePatterns = ["service", ".service.", "-service.", "_service."];
-  const isServiceName = servicePatterns.some(
-    (pattern) => fileName?.includes(pattern)
-  );
+  const isServiceName = servicePatterns.some((p) => fileName.includes(p));
   const isServicePath = file.toLowerCase().includes("/services/");
   const hasServiceNamedExport = (exports2 || []).some(
-    (e) => e.name.toLowerCase().includes("service") || e.name.toLowerCase().endsWith("service")
+    (e) => e.name.toLowerCase().includes("service")
   );
   const hasClassExport = (exports2 || []).some((e) => e.type === "class");
-  return !!isServiceName || !!isServicePath || !!hasServiceNamedExport && !!hasClassExport;
+  return isServiceName || isServicePath || hasServiceNamedExport && hasClassExport;
 }
 function isEmailTemplate(node) {
   const { file, exports: exports2 } = node;
-  const fileName = file.split("/").pop()?.toLowerCase();
-  const emailTemplatePatterns = [
+  const fileName = file.split("/").pop()?.toLowerCase() || "";
+  const emailPatterns = [
     "-email-",
     ".email.",
     "_email_",
@@ -1216,78 +1144,51 @@ function isEmailTemplate(node) {
     "-mail.",
     ".mail."
   ];
-  const isEmailTemplateName = emailTemplatePatterns.some(
-    (pattern) => fileName?.includes(pattern)
-  );
-  const isEmailPath = file.toLowerCase().includes("/emails/") || file.toLowerCase().includes("/mail/") || file.toLowerCase().includes("/notifications/");
+  const isEmailName = emailPatterns.some((p) => fileName.includes(p));
+  const isEmailPath = /\/(emails|mail|notifications)\//i.test(file);
   const hasTemplateFunction = (exports2 || []).some(
-    (e) => e.type === "function" && (e.name.toLowerCase().startsWith("render") || e.name.toLowerCase().startsWith("generate") || e.name.toLowerCase().includes("template") && e.name.toLowerCase().includes("email"))
+    (e) => e.type === "function" && (e.name.toLowerCase().startsWith("render") || e.name.toLowerCase().startsWith("generate"))
   );
-  return !!isEmailPath || !!isEmailTemplateName || !!hasTemplateFunction;
+  return isEmailPath || isEmailName || hasTemplateFunction;
 }
 function isParserFile(node) {
   const { file, exports: exports2 } = node;
-  const fileName = file.split("/").pop()?.toLowerCase();
+  const fileName = file.split("/").pop()?.toLowerCase() || "";
   const parserPatterns = [
     "parser",
     ".parser.",
     "-parser.",
     "_parser.",
     "transform",
-    ".transform.",
     "converter",
     "mapper",
     "serializer"
   ];
-  const isParserName = parserPatterns.some(
-    (pattern) => fileName?.includes(pattern)
-  );
-  const isParserPath = file.toLowerCase().includes("/parsers/") || file.toLowerCase().includes("/transformers/");
+  const isParserName = parserPatterns.some((p) => fileName.includes(p));
+  const isParserPath = /\/(parsers|transformers)\//i.test(file);
   const hasParseFunction = (exports2 || []).some(
-    (e) => e.type === "function" && (e.name.toLowerCase().startsWith("parse") || e.name.toLowerCase().startsWith("transform") || e.name.toLowerCase().startsWith("extract"))
+    (e) => e.type === "function" && (e.name.toLowerCase().startsWith("parse") || e.name.toLowerCase().startsWith("transform"))
   );
-  return !!isParserName || !!isParserPath || !!hasParseFunction;
+  return isParserName || isParserPath || hasParseFunction;
 }
 function isSessionFile(node) {
   const { file, exports: exports2 } = node;
-  const fileName = file.split("/").pop()?.toLowerCase();
+  const fileName = file.split("/").pop()?.toLowerCase() || "";
   const sessionPatterns = ["session", "state", "context", "store"];
-  const isSessionName = sessionPatterns.some(
-    (pattern) => fileName?.includes(pattern)
-  );
-  const isSessionPath = file.toLowerCase().includes("/sessions/") || file.toLowerCase().includes("/state/");
+  const isSessionName = sessionPatterns.some((p) => fileName.includes(p));
+  const isSessionPath = /\/(sessions|state)\//i.test(file);
   const hasSessionExport = (exports2 || []).some(
-    (e) => e.name.toLowerCase().includes("session") || e.name.toLowerCase().includes("state") || e.name.toLowerCase().includes("store")
+    (e) => ["session", "state", "store"].some((p) => e.name.toLowerCase().includes(p))
   );
-  return !!isSessionName || !!isSessionPath || !!hasSessionExport;
-}
-function isConfigFile(node) {
-  const { file, exports: exports2 } = node;
-  const lowerPath = file.toLowerCase();
-  const fileName = file.split("/").pop()?.toLowerCase();
-  const configPatterns = [
-    ".config.",
-    "tsconfig",
-    "jest.config",
-    "package.json",
-    "aiready.json",
-    "next.config",
-    "sst.config"
-  ];
-  const isConfigName = configPatterns.some((p) => fileName?.includes(p));
-  const isConfigPath = lowerPath.includes("/config/") || lowerPath.includes("/settings/") || lowerPath.includes("/schemas/");
-  const hasSchemaExports = (exports2 || []).some(
-    (e) => e.name.toLowerCase().includes("schema") || e.name.toLowerCase().includes("config") || e.name.toLowerCase().includes("setting")
-  );
-  return !!isConfigName || !!isConfigPath || !!hasSchemaExports;
+  return isSessionName || isSessionPath || hasSessionExport;
 }
 function isNextJsPage(node) {
   const { file, exports: exports2 } = node;
   const lowerPath = file.toLowerCase();
-  const fileName = file.split("/").pop()?.toLowerCase();
+  const fileName = file.split("/").pop()?.toLowerCase() || "";
   const isInAppDir = lowerPath.includes("/app/") || lowerPath.startsWith("app/");
-  const isPageFile = fileName === "page.tsx" || fileName === "page.ts";
-  if (!isInAppDir || !isPageFile) return false;
+  if (!isInAppDir || fileName !== "page.tsx" && fileName !== "page.ts")
+    return false;
   const hasDefaultExport = (exports2 || []).some((e) => e.type === "default");
   const nextJsExports = [
     "metadata",
@@ -1296,10 +1197,91 @@ function isNextJsPage(node) {
     "jsonld",
     "icon"
   ];
-  const hasNextJsExports = (exports2 || []).some(
+  const hasNextJsExport = (exports2 || []).some(
     (e) => nextJsExports.includes(e.name.toLowerCase())
   );
-  return !!hasDefaultExport || !!hasNextJsExports;
+  return hasDefaultExport || hasNextJsExport;
+}
+function isConfigFile(node) {
+  const { file, exports: exports2 } = node;
+  const lowerPath = file.toLowerCase();
+  const fileName = file.split("/").pop()?.toLowerCase() || "";
+  const configPatterns = [
+    ".config.",
+    "tsconfig",
+    "jest.config",
+    "package.json",
+    "aiready.json",
+    "next.config",
+    "sst.config"
+  ];
+  const isConfigName = configPatterns.some((p) => fileName.includes(p));
+  const isConfigPath = /\/(config|settings|schemas)\//i.test(lowerPath);
+  const hasSchemaExport = (exports2 || []).some(
+    (e) => ["schema", "config", "setting"].some(
+      (p) => e.name.toLowerCase().includes(p)
+    )
+  );
+  return isConfigName || isConfigPath || hasSchemaExport;
+}
+
+// src/classifier.ts
+var 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"
+};
+function classifyFile(node, cohesionScore = 1, domains = []) {
+  if (isBarrelExport(node)) {
+    return Classification.BARREL;
+  }
+  if (isTypeDefinition(node)) {
+    return Classification.TYPE_DEFINITION;
+  }
+  if (isNextJsPage(node)) {
+    return Classification.NEXTJS_PAGE;
+  }
+  if (isLambdaHandler(node)) {
+    return Classification.LAMBDA_HANDLER;
+  }
+  if (isServiceFile(node)) {
+    return Classification.SERVICE;
+  }
+  if (isEmailTemplate(node)) {
+    return Classification.EMAIL_TEMPLATE;
+  }
+  if (isParserFile(node)) {
+    return Classification.PARSER;
+  }
+  if (isSessionFile(node)) {
+    if (cohesionScore >= 0.25 && domains.length <= 1)
+      return Classification.COHESIVE_MODULE;
+    return Classification.UTILITY_MODULE;
+  }
+  if (isUtilityModule(node)) {
+    return Classification.UTILITY_MODULE;
+  }
+  if (isConfigFile(node)) {
+    return Classification.COHESIVE_MODULE;
+  }
+  if (domains.length <= 1 && domains[0] !== "unknown") {
+    return Classification.COHESIVE_MODULE;
+  }
+  if (domains.length > 1 && cohesionScore < 0.4) {
+    return Classification.MIXED_CONCERNS;
+  }
+  if (cohesionScore >= 0.7) {
+    return Classification.COHESIVE_MODULE;
+  }
+  return Classification.UNKNOWN;
 }
 function adjustCohesionForClassification(baseCohesion, classification, node) {
   switch (classification) {
@@ -1507,7 +1489,7 @@ function calculateCohesion(exports2, filePath, options) {
 async function analyzeContext(options) {
   const {
     maxDepth = 5,
-    maxContextBudget = 1e4,
+    maxContextBudget = 25e3,
     minCohesion = 0.6,
     maxFragmentation = 0.5,
     includeNodeModules = false,
@@ -1875,11 +1857,7 @@ function calculateContextScore(summary, costConfig) {
   };
 }
 function mapScoreToRating(score) {
-  if (score >= 90) return "excellent";
-  if (score >= 75) return "good";
-  if (score >= 60) return "fair";
-  if (score >= 40) return "needs work";
-  return "critical";
+  return (0, import_core8.getRatingSlug)(score).replace("-", " ");
 }
 
 // src/provider.ts
@@ -2332,16 +2310,6 @@ import_core11.ToolRegistry.register(ContextAnalyzerProvider);
   getTransitiveDependencies,
   inferDomain,
   inferDomainFromSemantics,
-  isBarrelExport,
-  isConfigFile,
-  isEmailTemplate,
-  isLambdaHandler,
-  isNextJsPage,
-  isParserFile,
-  isServiceFile,
-  isSessionFile,
-  isTypeDefinition,
-  isUtilityModule,
   mapScoreToRating,
   runInteractiveSetup
 });

package/dist/index.mjs

@@ -31,18 +31,8 @@ import {
   getTransitiveDependencies,
   inferDomain,
   inferDomainFromSemantics,
-  isBarrelExport,
-  isConfigFile,
-  isEmailTemplate,
-  isLambdaHandler,
-  isNextJsPage,
-  isParserFile,
-  isServiceFile,
-  isSessionFile,
-  isTypeDefinition,
-  isUtilityModule,
   runInteractiveSetup
-} from "./chunk-XIXAWCMS.mjs";
+} from "./chunk-D25B5LZR.mjs";
 import "./chunk-64U3PNO3.mjs";
 
 // src/index.ts
@@ -60,7 +50,8 @@ import {
   calculateMonthlyCost,
   calculateProductivityImpact,
   DEFAULT_COST_CONFIG,
-  ToolName
+  ToolName,
+  getRatingSlug
 } from "@aiready/core";
 function calculateContextScore(summary, costConfig) {
   const {
@@ -201,11 +192,7 @@ function calculateContextScore(summary, costConfig) {
   };
 }
 function mapScoreToRating(score) {
-  if (score >= 90) return "excellent";
-  if (score >= 75) return "good";
-  if (score >= 60) return "fair";
-  if (score >= 40) return "needs work";
-  return "critical";
+  return getRatingSlug(score).replace("-", " ");
 }
 
 // src/provider.ts
@@ -336,16 +323,6 @@ export {
   getTransitiveDependencies,
   inferDomain,
   inferDomainFromSemantics,
-  isBarrelExport,
-  isConfigFile,
-  isEmailTemplate,
-  isLambdaHandler,
-  isNextJsPage,
-  isParserFile,
-  isServiceFile,
-  isSessionFile,
-  isTypeDefinition,
-  isUtilityModule,
   mapScoreToRating,
   runInteractiveSetup
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiready/context-analyzer",
-  "version": "0.21.6",
+  "version": "0.21.8",
   "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.23.2"
+    "@aiready/core": "0.23.4"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",

package/src/analyzer.ts

@@ -1,9 +1,4 @@
-import {
-  estimateTokens,
-  Severity,
-  scanFiles,
-  readFileContent,
-} from '@aiready/core';
+import { scanFiles, readFileContent } from '@aiready/core';
 import type {
   ExportInfo,
   ContextAnalysisResult,
@@ -29,8 +24,13 @@ import {
 import { getClassificationRecommendations } from './remediation';
 
 /**
- * Calculate cohesion score (how related are exports in a file)
- * Legacy wrapper for backward compatibility with exact test expectations
+ * Calculate cohesion score (how related are exports in a file).
+ * Legacy wrapper for backward compatibility with exact test expectations.
+ *
+ * @param exports - List of exported symbols
+ * @param filePath - Path to the file being analyzed
+ * @param options - Additional options for cohesion calculation
+ * @returns Cohesion score between 0 and 1
  */
 export function calculateCohesion(
   exports: ExportInfo[],
@@ -43,12 +43,20 @@ export function calculateCohesion(
 /**
  * Analyze AI context window cost for a codebase
  */
+/**
+ * Performs deep context analysis of a project.
+ * Scans files, builds a dependency graph, calculates context budgets,
+ * and identifies structural issues like high fragmentation or depth.
+ *
+ * @param options - Analysis parameters including root directory and focus areas
+ * @returns Comprehensive analysis results with metrics and identified issues
+ */
 export async function analyzeContext(
   options: ContextAnalyzerOptions
 ): Promise<ContextAnalysisResult[]> {
   const {
     maxDepth = 5,
-    maxContextBudget = 10000,
+    maxContextBudget = 25000,
     minCohesion = 0.6,
     maxFragmentation = 0.5,
     includeNodeModules = false,

package/src/ast-utils.ts

@@ -1,5 +1,5 @@
 import { parseFileExports } from '@aiready/core';
-import type { ExportInfo, DependencyNode, FileClassification } from './types';
+import type { ExportInfo } from './types';
 import { inferDomain, extractExports } from './semantic-analysis';
 
 /**
@@ -33,7 +33,7 @@ export function extractExportsWithAST(
       dependencies: exp.dependencies,
       typeReferences: (exp as any).typeReferences,
     }));
-  } catch (error) {
+  } catch {
     // Ultimate fallback
     return extractExports(content, filePath, domainOptions, fileImports);
   }