@aiready/context-analyzer 0.21.6 → 0.21.8

package/dist/cli.js

@@ -542,7 +542,7 @@ function extractExportsWithAST(content, filePath, domainOptions, fileImports) {
       dependencies: exp.dependencies,
       typeReferences: exp.typeReferences
     }));
-  } catch (error) {
+  } catch {
     return extractExports(content, filePath, domainOptions, fileImports);
   }
 }
@@ -879,6 +879,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) => {
@@ -924,87 +939,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;
 }
@@ -1014,20 +957,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.",
@@ -1036,33 +978,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_",
@@ -1072,78 +1010,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")
-  );
-  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")
+    (e) => ["session", "state", "store"].some((p) => e.name.toLowerCase().includes(p))
   );
-  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",
@@ -1152,10 +1063,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) {
@@ -1315,7 +1307,7 @@ function getClassificationRecommendations(classification, file, issues) {
 async function analyzeContext(options) {
   const {
     maxDepth = 5,
-    maxContextBudget = 1e4,
+    maxContextBudget = 25e3,
     minCohesion = 0.6,
     maxFragmentation = 0.5,
     includeNodeModules = false,

package/dist/cli.mjs

@@ -5,7 +5,7 @@ import {
   generateHTMLReport,
   generateSummary,
   runInteractiveSetup
-} from "./chunk-XIXAWCMS.mjs";
+} from "./chunk-D25B5LZR.mjs";
 import "./chunk-64U3PNO3.mjs";
 
 // src/cli.ts

package/dist/index.d.mts

@@ -1,36 +1,68 @@
-import { ToolProvider, Severity, ScanOptions, CostConfig, ToolScoringOutput } from '@aiready/core';
+import { ToolProvider, Severity, ScanOptions, FileContent, CostConfig, ToolScoringOutput } from '@aiready/core';
 
 /**
  * Context Analyzer Tool Provider
  */
 declare const ContextAnalyzerProvider: ToolProvider;
 
+/**
+ * Options for the Context Analyzer tool.
+ * Controls thresholds for import depth, context budget, and cohesion.
+ */
 interface ContextAnalyzerOptions extends ScanOptions {
+    /** Maximum acceptable import depth (default: 5) */
     maxDepth?: number;
+    /** Maximum acceptable token budget for a single context (default: 25000) */
     maxContextBudget?: number;
+    /** Minimum acceptable cohesion score between 0 and 1 (default: 0.6) */
     minCohesion?: number;
+    /** Maximum acceptable fragmentation score between 0 and 1 (default: 0.5) */
     maxFragmentation?: number;
+    /** Analysis focus area: fragmentation, cohesion, depth, or all (default: 'all') */
     focus?: 'fragmentation' | 'cohesion' | 'depth' | 'all';
+    /** Whether to include node_modules in the analysis (default: false) */
     includeNodeModules?: boolean;
 }
+/**
+ * The result of a context analysis for a single file or module.
+ * Includes metrics for tokens, dependencies, cohesion, and AI impact.
+ */
 interface ContextAnalysisResult {
+    /** The file path being analyzed */
     file: string;
+    /** Total number of tokens in this file */
     tokenCost: number;
+    /** Total lines of code in the file */
     linesOfCode: number;
+    /** Maximum depth of the import tree for this file */
     importDepth: number;
+    /** Total number of transitive dependencies */
     dependencyCount: number;
+    /** List of all files in the dependency tree */
     dependencyList: string[];
+    /** Detected circular dependency chains */
     circularDeps: string[][];
+    /** Cohesion score from 0 to 1 (1 is perfect cohesion) */
     cohesionScore: number;
+    /** Detected domain categories for the module */
     domains: string[];
+    /** Number of exported symbols */
     exportCount: number;
+    /** Total tokens required to understand this file and all its dependencies */
     contextBudget: number;
+    /** Fragmentation score from 0 to 1 (0 is well-grouped) */
     fragmentationScore: number;
+    /** List of files that should be loaded together for full context */
     relatedFiles: string[];
+    /** The semantic classification of the file (e.g. 'barrel-export', 'service-file') */
     fileClassification: FileClassification;
+    /** Overall severity of identified issues */
     severity: Severity | 'critical' | 'major' | 'minor' | 'info';
+    /** List of specific structural problems found */
     issues: string[];
+    /** Actionable suggestions for improving context readiness */
     recommendations: string[];
+    /** Estimated tokens that could be saved by following recommendations */
     potentialSavings: number;
 }
 /**
@@ -129,19 +161,28 @@ interface TypeDependency {
 }
 
 /**
- * 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
  */
 declare function calculateCohesion(exports: ExportInfo[], filePath?: string, options?: any): number;
 /**
  * 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
+ */
 declare function analyzeContext(options: ContextAnalyzerOptions): Promise<ContextAnalysisResult[]>;
 
-interface FileContent {
-    file: string;
-    content: string;
-}
 /**
  * Auto-detect domain keywords from workspace folder structure
  */
@@ -172,6 +213,15 @@ declare function detectCircularDependencies(graph: DependencyGraph): string[][];
 /**
  * Calculate cohesion score (how related are exports in a file)
  */
+/**
+ * Calculates a cohesion score (0-1) for a module based on its exports,
+ * shared imports, and internal structure. High cohesion indicates
+ * a well-focused module that is easy for AI models to reason about.
+ *
+ * @param exports - Exported symbols and their metadata
+ * @param imports - Imported symbols and their sources
+ * @returns Cohesion score between 0 and 1
+ */
 declare function calculateEnhancedCohesion(exports: ExportInfo[], filePath?: string, options?: {
     coUsageMatrix?: Map<string, Map<string, number>>;
     weights?: {
@@ -227,76 +277,6 @@ declare const Classification: {
  * @returns The determined file classification
  */
 declare function classifyFile(node: DependencyNode, cohesionScore?: number, domains?: string[]): FileClassification;
-/**
- * Detect if a file is a barrel export (index.ts)
- *
- * @param node The dependency node to check
- * @returns True if the file appears to be a barrel export
- */
-declare function isBarrelExport(node: DependencyNode): boolean;
-/**
- * Detect if a file is primarily type definitions
- *
- * @param node The dependency node to check
- * @returns True if the file appears to be primarily types
- */
-declare function isTypeDefinition(node: DependencyNode): boolean;
-/**
- * Detect if a file is a utility module
- *
- * @param node The dependency node to check
- * @returns True if the file appears to be a utility module
- */
-declare function isUtilityModule(node: DependencyNode): boolean;
-/**
- * Detect if a file is a Lambda/API handler
- *
- * @param node The dependency node to check
- * @returns True if the file appears to be a Lambda handler
- */
-declare function isLambdaHandler(node: DependencyNode): boolean;
-/**
- * Detect if a file is a service file
- *
- * @param node The dependency node to check
- * @returns True if the file appears to be a service file
- */
-declare function isServiceFile(node: DependencyNode): boolean;
-/**
- * Detect if a file is an email template/layout
- *
- * @param node The dependency node to check
- * @returns True if the file appears to be an email template
- */
-declare function isEmailTemplate(node: DependencyNode): boolean;
-/**
- * Detect if a file is a parser/transformer
- *
- * @param node The dependency node to check
- * @returns True if the file appears to be a parser
- */
-declare function isParserFile(node: DependencyNode): boolean;
-/**
- * Detect if a file is a session/state management file
- *
- * @param node The dependency node to check
- * @returns True if the file appears to be a session/state file
- */
-declare function isSessionFile(node: DependencyNode): boolean;
-/**
- * Detect if a file is a configuration or schema file
- *
- * @param node The dependency node to check
- * @returns True if the file appears to be a config file
- */
-declare function isConfigFile(node: DependencyNode): boolean;
-/**
- * Detect if a file is a Next.js App Router page
- *
- * @param node The dependency node to check
- * @returns True if the file appears to be a Next.js page
- */
-declare function isNextJsPage(node: DependencyNode): boolean;
 /**
  * Adjust cohesion score based on file classification
  *
@@ -317,6 +297,10 @@ declare function adjustFragmentationForClassification(baseFragmentation: number,
 
 /**
  * Group files by domain to detect module clusters
+ * @param graph - The dependency graph to analyze
+ * @param options - Optional configuration options
+ * @param options.useLogScale - Whether to use logarithmic scaling for calculations
+ * @returns Array of module clusters
  */
 declare function detectModuleClusters(graph: DependencyGraph, options?: {
     useLogScale?: boolean;
@@ -355,6 +339,9 @@ declare function mapScoreToRating(score: number): string;
 /**
  * Generate smart defaults for context analysis based on repository size
  * Automatically tunes thresholds to target ~10 most serious issues
+ * @param directory - The root directory to analyze
+ * @param userOptions - Partial user-provided options to merge with defaults
+ * @returns Complete ContextAnalyzerOptions with smart defaults
  */
 declare function getSmartDefaults(directory: string, userOptions: Partial<ContextAnalyzerOptions>): Promise<ContextAnalyzerOptions>;
 
@@ -365,14 +352,21 @@ declare function generateSummary(results: ContextAnalysisResult[], options?: any
 
 /**
  * Build co-usage matrix: track which files are imported together
+ * @param graph - The dependency graph to analyze
+ * @returns Map of file to co-usage counts
  */
 declare function buildCoUsageMatrix(graph: DependencyGraph): Map<string, Map<string, number>>;
 /**
  * Extract type dependencies from AST exports
+ * @param graph - The dependency graph to analyze
+ * @returns Map of type references to files that use them
  */
 declare function buildTypeGraph(graph: DependencyGraph): Map<string, Set<string>>;
 /**
  * Find semantic clusters using co-usage patterns
+ * @param coUsageMatrix - The co-usage matrix from buildCoUsageMatrix
+ * @param minCoUsage - Minimum co-usage count to consider (default: 3)
+ * @returns Map of cluster representative files to their cluster members
  */
 declare function findSemanticClusters(coUsageMatrix: Map<string, Map<string, number>>, minCoUsage?: number): Map<string, string[]>;
 /**
@@ -408,4 +402,4 @@ declare function generateHTMLReport(summary: ReturnType<typeof generateSummary>,
  */
 declare function runInteractiveSetup(directory: string, current: any): Promise<any>;
 
-export { Classification, type CoUsageData, type ContextAnalysisResult, type ContextAnalyzerOptions, ContextAnalyzerProvider, type ContextSummary, type DependencyGraph, type DependencyNode, type DomainAssignment, type DomainSignals, type ExportInfo, type FileClassification, type ModuleCluster, type TypeDependency, adjustCohesionForClassification, adjustFragmentationForClassification, analyzeContext, buildCoUsageMatrix, buildDependencyGraph, buildTypeGraph, calculateCohesion, calculateContextBudget, calculateContextScore, calculateDirectoryDistance, calculateDomainConfidence, calculateEnhancedCohesion, calculateFragmentation, calculateImportDepth, calculatePathEntropy, calculateStructuralCohesionFromCoUsage, classifyFile, detectCircularDependencies, detectModuleClusters, displayConsoleReport, extractDomainKeywordsFromPaths, extractExports, findConsolidationCandidates, findSemanticClusters, generateHTMLReport, generateSummary, getClassificationRecommendations, getCoUsageData, getGeneralRecommendations, getSmartDefaults, getTransitiveDependencies, inferDomain, inferDomainFromSemantics, isBarrelExport, isConfigFile, isEmailTemplate, isLambdaHandler, isNextJsPage, isParserFile, isServiceFile, isSessionFile, isTypeDefinition, isUtilityModule, mapScoreToRating, runInteractiveSetup };
+export { Classification, type CoUsageData, type ContextAnalysisResult, type ContextAnalyzerOptions, ContextAnalyzerProvider, type ContextSummary, type DependencyGraph, type DependencyNode, type DomainAssignment, type DomainSignals, type ExportInfo, type FileClassification, type ModuleCluster, type TypeDependency, adjustCohesionForClassification, adjustFragmentationForClassification, analyzeContext, buildCoUsageMatrix, buildDependencyGraph, buildTypeGraph, calculateCohesion, calculateContextBudget, calculateContextScore, calculateDirectoryDistance, calculateDomainConfidence, calculateEnhancedCohesion, calculateFragmentation, calculateImportDepth, calculatePathEntropy, calculateStructuralCohesionFromCoUsage, classifyFile, detectCircularDependencies, detectModuleClusters, displayConsoleReport, extractDomainKeywordsFromPaths, extractExports, findConsolidationCandidates, findSemanticClusters, generateHTMLReport, generateSummary, getClassificationRecommendations, getCoUsageData, getGeneralRecommendations, getSmartDefaults, getTransitiveDependencies, inferDomain, inferDomainFromSemantics, mapScoreToRating, runInteractiveSetup };