@aiready/context-analyzer 0.21.16 → 0.21.17

package/dist/cli.js

@@ -319,39 +319,22 @@ function singularize(word) {
   return word;
 }
 
-// src/semantic-analysis.ts
-function buildCoUsageMatrix(graph) {
-  const coUsageMatrix = /* @__PURE__ */ new Map();
-  for (const [, node] of graph.nodes) {
-    const imports = node.imports;
-    for (let i = 0; i < imports.length; i++) {
-      const fileA = imports[i];
-      if (!coUsageMatrix.has(fileA)) coUsageMatrix.set(fileA, /* @__PURE__ */ new Map());
-      for (let j = i + 1; j < imports.length; j++) {
-        const fileB = imports[j];
-        const fileAUsage = coUsageMatrix.get(fileA);
-        fileAUsage.set(fileB, (fileAUsage.get(fileB) || 0) + 1);
-        if (!coUsageMatrix.has(fileB)) coUsageMatrix.set(fileB, /* @__PURE__ */ new Map());
-        const fileBUsage = coUsageMatrix.get(fileB);
-        fileBUsage.set(fileA, (fileBUsage.get(fileA) || 0) + 1);
-      }
-    }
-  }
-  return coUsageMatrix;
-}
-function buildTypeGraph(graph) {
-  const typeGraph = /* @__PURE__ */ new Map();
-  for (const [file, node] of graph.nodes) {
-    for (const exp of node.exports) {
-      if (exp.typeReferences) {
-        for (const typeRef of exp.typeReferences) {
-          if (!typeGraph.has(typeRef)) typeGraph.set(typeRef, /* @__PURE__ */ new Set());
-          typeGraph.get(typeRef).add(file);
-        }
-      }
-    }
-  }
-  return typeGraph;
+// src/semantic/domain-inference.ts
+function calculateDomainConfidence(signals) {
+  const weights = {
+    coUsage: 0.35,
+    typeReference: 0.3,
+    exportName: 0.15,
+    importPath: 0.1,
+    folderStructure: 0.1
+  };
+  let confidence = 0;
+  if (signals.coUsage) confidence += weights.coUsage;
+  if (signals.typeReference) confidence += weights.typeReference;
+  if (signals.exportName) confidence += weights.exportName;
+  if (signals.importPath) confidence += weights.importPath;
+  if (signals.folderStructure) confidence += weights.folderStructure;
+  return confidence;
 }
 function inferDomainFromSemantics(file, exportName, graph, coUsageMatrix, typeGraph, exportTypeRefs) {
   const domainSignals = /* @__PURE__ */ new Map();
@@ -413,22 +396,6 @@ function inferDomainFromSemantics(file, exportName, graph, coUsageMatrix, typeGr
   assignments.sort((a, b) => b.confidence - a.confidence);
   return assignments;
 }
-function calculateDomainConfidence(signals) {
-  const weights = {
-    coUsage: 0.35,
-    typeReference: 0.3,
-    exportName: 0.15,
-    importPath: 0.1,
-    folderStructure: 0.1
-  };
-  let confidence = 0;
-  if (signals.coUsage) confidence += weights.coUsage;
-  if (signals.typeReference) confidence += weights.typeReference;
-  if (signals.exportName) confidence += weights.exportName;
-  if (signals.importPath) confidence += weights.importPath;
-  if (signals.folderStructure) confidence += weights.folderStructure;
-  return confidence;
-}
 function extractExports(content, filePath, domainOptions, fileImports) {
   const exports2 = [];
   const patterns = [
@@ -744,9 +711,69 @@ function isBuildArtifact(filePath) {
 // src/graph-builder.ts
 var import_core4 = require("@aiready/core");
 init_dependency_graph_utils();
+
+// src/semantic/co-usage.ts
+function buildCoUsageMatrix(graph) {
+  const coUsageMatrix = /* @__PURE__ */ new Map();
+  for (const [, node] of graph.nodes) {
+    const imports = node.imports;
+    for (let i = 0; i < imports.length; i++) {
+      const fileA = imports[i];
+      if (!coUsageMatrix.has(fileA)) coUsageMatrix.set(fileA, /* @__PURE__ */ new Map());
+      for (let j = i + 1; j < imports.length; j++) {
+        const fileB = imports[j];
+        const fileAUsage = coUsageMatrix.get(fileA);
+        fileAUsage.set(fileB, (fileAUsage.get(fileB) || 0) + 1);
+        if (!coUsageMatrix.has(fileB)) coUsageMatrix.set(fileB, /* @__PURE__ */ new Map());
+        const fileBUsage = coUsageMatrix.get(fileB);
+        fileBUsage.set(fileA, (fileBUsage.get(fileA) || 0) + 1);
+      }
+    }
+  }
+  return coUsageMatrix;
+}
+
+// src/semantic/type-graph.ts
+function buildTypeGraph(graph) {
+  const typeGraph = /* @__PURE__ */ new Map();
+  for (const [file, node] of graph.nodes) {
+    for (const exp of node.exports) {
+      if (exp.typeReferences) {
+        for (const typeRef of exp.typeReferences) {
+          if (!typeGraph.has(typeRef)) typeGraph.set(typeRef, /* @__PURE__ */ new Set());
+          typeGraph.get(typeRef).add(file);
+        }
+      }
+    }
+  }
+  return typeGraph;
+}
+
+// src/graph-builder.ts
 var import_path = require("path");
 function resolveImport(source, importingFile, allFiles) {
   if (!source.startsWith(".") && !source.startsWith("/")) {
+    if (source.startsWith("@aiready/")) {
+      const pkgName = source.split("/")[1];
+      const possiblePaths = [
+        // Standard src/index.ts entry point for our packages
+        (0, import_path.join)("packages", pkgName, "src", "index.ts"),
+        (0, import_path.join)("packages", pkgName, "src", "index.tsx"),
+        // Support for sub-exports if needed (e.g. @aiready/core/client)
+        (0, import_path.join)(
+          "packages",
+          pkgName,
+          "src",
+          `${source.split("/").slice(2).join("/") || "index"}.ts`
+        )
+      ];
+      for (const p of possiblePaths) {
+        const absolutePkgPath = Array.from(allFiles).find(
+          (f) => f.endsWith((0, import_path.normalize)(p))
+        );
+        if (absolutePkgPath) return absolutePkgPath;
+      }
+    }
     if (allFiles.has(source)) return source;
     return null;
   }
@@ -869,7 +896,7 @@ function detectCircularDependencies(graph) {
   return detectGraphCycles(graph.edges);
 }
 
-// src/heuristics.ts
+// src/classify/classification-patterns.ts
 var BARREL_EXPORT_MIN_EXPORTS = 5;
 var BARREL_EXPORT_TOKEN_LIMIT = 1e3;
 var HANDLER_NAME_PATTERNS = [
@@ -923,6 +950,8 @@ var CONFIG_NAME_PATTERNS = [
   "next.config",
   "sst.config"
 ];
+
+// src/classify/file-classifiers.ts
 function isBoilerplateBarrel(node) {
   const { exports: exports2, tokenCost } = node;
   if (!exports2 || exports2.length === 0) return false;
@@ -1624,11 +1653,8 @@ function generateSummary(results, options = {}) {
   };
 }
 
-// src/utils/output-formatter.ts
+// src/report/console-report.ts
 var import_chalk = __toESM(require("chalk"));
-var import_fs2 = require("fs");
-var import_path3 = require("path");
-var import_prompts = __toESM(require("prompts"));
 function displayConsoleReport(summary, results, maxResults = 10) {
   const divider = "\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500";
   const totalIssues = summary.criticalIssues + summary.majorIssues + summary.minorIssues;
@@ -1698,6 +1724,8 @@ function displayConsoleReport(summary, results, maxResults = 10) {
     )
   );
 }
+
+// src/report/html-report.ts
 function generateHTMLReport(summary, results) {
   const totalIssues = summary.criticalIssues + summary.majorIssues + summary.minorIssues;
   void results;
@@ -1877,8 +1905,14 @@ function generateHTMLReport(summary, results) {
 </body>
 </html>`;
 }
+
+// src/report/interactive-setup.ts
+var import_chalk2 = __toESM(require("chalk"));
+var import_fs2 = require("fs");
+var import_path3 = require("path");
+var import_prompts = __toESM(require("prompts"));
 async function runInteractiveSetup(directory, current) {
-  console.log(import_chalk.default.yellow("\u{1F9ED} Interactive mode: let\u2019s tailor the analysis."));
+  console.log(import_chalk2.default.yellow("\u{1F9ED} Interactive mode: let's tailor the analysis."));
   const pkgPath = (0, import_path3.join)(directory, "package.json");
   let deps = {};
   if ((0, import_fs2.existsSync)(pkgPath)) {
@@ -1941,15 +1975,15 @@ async function runInteractiveSetup(directory, current) {
       "**/*.{ts,js,py,java}"
     ];
   }
-  console.log(import_chalk.default.green("\u2713 Interactive configuration applied."));
+  console.log(import_chalk2.default.green("\u2713 Interactive configuration applied."));
   return nextOptions;
 }
 
 // src/cli-action.ts
-var import_chalk2 = __toESM(require("chalk"));
+var import_chalk3 = __toESM(require("chalk"));
 var import_fs3 = require("fs");
 async function contextActionHandler(directory, options) {
-  console.log(import_chalk2.default.blue("\u{1F50D} Analyzing context window costs...\n"));
+  console.log(import_chalk3.default.blue("\u{1F50D} Analyzing context window costs...\n"));
   const startTime = Date.now();
   try {
     const defaults = {
@@ -2004,11 +2038,11 @@ async function contextActionHandler(directory, options) {
         "context-report.html"
       );
       (0, import_fs3.writeFileSync)(outputPath, html, "utf-8");
-      console.log(import_chalk2.default.green(`
+      console.log(import_chalk3.default.green(`
 \u2705 HTML report saved to: ${outputPath}`));
     } else {
       displayConsoleReport(summary, results, finalOptions.maxResults);
-      console.log(import_chalk2.default.dim(`
+      console.log(import_chalk3.default.dim(`
 \u2728 Analysis completed in ${duration}ms
 `));
     }

package/dist/cli.mjs

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

package/dist/index.d.mts

@@ -421,6 +421,23 @@ declare function generateSummary(results: ContextAnalysisResult[], options?: any
  * @returns Map of file path to nested map of related files and their co-occurrence counts.
  */
 declare function buildCoUsageMatrix(graph: DependencyGraph): Map<string, Map<string, number>>;
+/**
+ * Find semantic clusters using frequently occurring co-usage patterns.
+ *
+ * @param coUsageMatrix - The co-usage matrix from buildCoUsageMatrix.
+ * @param minCoUsage - Minimum co-usage count to consider a strong relationship (default: 3).
+ * @returns Map of cluster representative files to their associated cluster members.
+ */
+declare function findSemanticClusters(coUsageMatrix: Map<string, Map<string, number>>, minCoUsage?: number): Map<string, string[]>;
+/**
+ * Retrieve co-usage data for a specific file.
+ *
+ * @param file - The file path to look up.
+ * @param coUsageMatrix - The global co-usage matrix.
+ * @returns Formatted co-usage data object.
+ */
+declare function getCoUsageData(file: string, coUsageMatrix: Map<string, Map<string, number>>): CoUsageData;
+
 /**
  * Extract type dependencies from AST exports to build a type-based relationship graph.
  *
@@ -428,14 +445,14 @@ declare function buildCoUsageMatrix(graph: DependencyGraph): Map<string, Map<str
  * @returns Map of type reference names to sets of files that consume or export them.
  */
 declare function buildTypeGraph(graph: DependencyGraph): Map<string, Set<string>>;
+
 /**
- * Find semantic clusters using frequently occurring co-usage patterns.
+ * Calculate confidence score for a domain assignment based on signals.
  *
- * @param coUsageMatrix - The co-usage matrix from buildCoUsageMatrix.
- * @param minCoUsage - Minimum co-usage count to consider a strong relationship (default: 3).
- * @returns Map of cluster representative files to their associated cluster members.
+ * @param signals - The set of semantic signals detected for a domain.
+ * @returns Numerical confidence score (0-1).
  */
-declare function findSemanticClusters(coUsageMatrix: Map<string, Map<string, number>>, minCoUsage?: number): Map<string, string[]>;
+declare function calculateDomainConfidence(signals: DomainSignals): number;
 /**
  * Infer domain from semantic analysis (co-usage + types) to identify logical modules.
  *
@@ -448,13 +465,6 @@ declare function findSemanticClusters(coUsageMatrix: Map<string, Map<string, num
  * @returns Array of potential domain assignments with confidence scores.
  */
 declare function inferDomainFromSemantics(file: string, exportName: string, graph: DependencyGraph, coUsageMatrix: Map<string, Map<string, number>>, typeGraph: Map<string, Set<string>>, exportTypeRefs?: string[]): DomainAssignment[];
-/**
- * Calculate confidence score for a domain assignment based on signals.
- *
- * @param signals - The set of semantic signals detected for a domain.
- * @returns Numerical confidence score (0-1).
- */
-declare function calculateDomainConfidence(signals: DomainSignals): number;
 /**
  * Regex-based export extraction (legacy/fallback)
  *
@@ -479,14 +489,7 @@ declare function extractExports(content: string, filePath?: string, domainOption
 declare function inferDomain(name: string, filePath?: string, domainOptions?: {
     domainKeywords?: string[];
 }, fileImports?: string[]): string;
-/**
- * Retrieve co-usage data for a specific file.
- *
- * @param file - The file path to look up.
- * @param coUsageMatrix - The global co-usage matrix.
- * @returns Formatted co-usage data object.
- */
-declare function getCoUsageData(file: string, coUsageMatrix: Map<string, Map<string, number>>): CoUsageData;
+
 /**
  * Identify candidates for module consolidation based on high co-usage or shared types.
  *
@@ -497,19 +500,146 @@ declare function getCoUsageData(file: string, coUsageMatrix: Map<string, Map<str
  * @param minSharedTypes - Minimum shared types threshold.
  * @returns Array of consolidation candidates sorted by strength.
  */
-declare function findConsolidationCandidates(graph: DependencyGraph, coUsageMatrix: Map<string, Map<string, number>>, typeGraph: Map<string, Set<string>>, minCoUsage?: number, minSharedTypes?: number): any[];
+declare function findConsolidationCandidates(graph: DependencyGraph, coUsageMatrix: Map<string, Map<string, number>>, typeGraph: Map<string, Set<string>>, minCoUsage?: number, minSharedTypes?: number): {
+    files: string[];
+    reason: string;
+    strength: number;
+}[];
+
+/**
+ * Classification pattern constants for file type detection.
+ */
+/** Minimum exports to consider a file as a barrel export */
+declare const BARREL_EXPORT_MIN_EXPORTS = 5;
+/** Token cost limit for barrel export detection */
+declare const BARREL_EXPORT_TOKEN_LIMIT = 1000;
+/** Patterns for Lambda/API handler detection */
+declare const HANDLER_NAME_PATTERNS: string[];
+/** Patterns for service file detection */
+declare const SERVICE_NAME_PATTERNS: string[];
+/** Patterns for email template detection */
+declare const EMAIL_NAME_PATTERNS: string[];
+/** Patterns for parser/transformer detection */
+declare const PARSER_NAME_PATTERNS: string[];
+/** Patterns for session/state management detection */
+declare const SESSION_NAME_PATTERNS: string[];
+/** Next.js metadata export names */
+declare const NEXTJS_METADATA_EXPORTS: string[];
+/** Patterns for configuration file detection */
+declare const CONFIG_NAME_PATTERNS: string[];
+
+/**
+ * Detect if a file is a boilerplate barrel (architectural theater).
+ * A boilerplate barrel re-exports from other sources without adding value.
+ *
+ * @param node - The dependency node to analyze.
+ * @returns True if the file matches boilerplate barrel patterns.
+ */
+declare function isBoilerplateBarrel(node: DependencyNode): boolean;
+/**
+ * Detect if a file is a barrel export (index.ts).
+ *
+ * @param node - The dependency node to analyze.
+ * @returns True if the file matches barrel export patterns.
+ * @lastUpdated 2026-03-20
+ */
+declare function isBarrelExport(node: DependencyNode): boolean;
+/**
+ * Detect if a file is primarily type definitions.
+ *
+ * @param node - The dependency node to analyze.
+ * @returns True if the file contains primarily types or matches type paths.
+ * @lastUpdated 2026-03-18
+ */
+declare function isTypeDefinition(node: DependencyNode): boolean;
+/**
+ * Detect if a file is a utility module.
+ *
+ * @param node - The dependency node to analyze.
+ * @returns True if the file path or name suggests a utility/helper role.
+ * @lastUpdated 2026-03-18
+ */
+declare function isUtilityModule(node: DependencyNode): boolean;
+/**
+ * Detect if a file is a Lambda/API handler.
+ *
+ * @param node - The dependency node to analyze.
+ * @returns True if the file serves as a coordination point for requests/lambdas.
+ * @lastUpdated 2026-03-18
+ */
+declare function isLambdaHandler(node: DependencyNode): boolean;
+/**
+ * Detect if a file is a service file.
+ *
+ * @param node - The dependency node to analyze.
+ * @returns True if the file orchestrates logic or matches service patterns.
+ * @lastUpdated 2026-03-18
+ */
+declare function isServiceFile(node: DependencyNode): boolean;
+/**
+ * Detect if a file is an email template/layout.
+ *
+ * @param node - The dependency node to analyze.
+ * @returns True if the file is used for rendering notifications or emails.
+ * @lastUpdated 2026-03-18
+ */
+declare function isEmailTemplate(node: DependencyNode): boolean;
+/**
+ * Detect if a file is a parser/transformer.
+ *
+ * @param node - The dependency node to analyze.
+ * @returns True if the file handles data conversion or serialization.
+ * @lastUpdated 2026-03-18
+ */
+declare function isParserFile(node: DependencyNode): boolean;
+/**
+ * Detect if a file is a session/state management file.
+ *
+ * @param node - The dependency node to analyze.
+ * @returns True if the file manages application state or sessions.
+ * @lastUpdated 2026-03-18
+ */
+declare function isSessionFile(node: DependencyNode): boolean;
+/**
+ * Detect if a file is a Next.js App Router page.
+ *
+ * @param node - The dependency node to analyze.
+ * @returns True if the file is a Next.js page or metadata entry.
+ * @lastUpdated 2026-03-18
+ */
+declare function isNextJsPage(node: DependencyNode): boolean;
+/**
+ * Detect if a file is a configuration or schema file.
+ *
+ * @param node - The dependency node to analyze.
+ * @returns True if the file matches configuration, setting, or schema patterns.
+ * @lastUpdated 2026-03-18
+ */
+declare function isConfigFile(node: DependencyNode): boolean;
+/**
+ * Detect if a file is part of a hub-and-spoke monorepo architecture.
+ *
+ * Many files spread across multiple packages (spokes) is intentional in
+ * AIReady and shouldn't be penalized as heavily for fragmentation.
+ *
+ * @param node - The dependency node to analyze.
+ * @returns True if the file path suggests it belongs to a spoke package.
+ */
+declare function isHubAndSpokeFile(node: DependencyNode): boolean;
 
 /**
  * Display analysis report in console
  */
 declare function displayConsoleReport(summary: ReturnType<typeof generateSummary>, results: Awaited<ReturnType<typeof analyzeContext>>, maxResults?: number): void;
+
 /**
  * Generate HTML report
  */
 declare function generateHTMLReport(summary: ReturnType<typeof generateSummary>, results: Awaited<ReturnType<typeof analyzeContext>>): string;
+
 /**
  * Interactive setup: detect common frameworks and suggest excludes & focus areas
  */
 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, mapScoreToRating, runInteractiveSetup };
+export { BARREL_EXPORT_MIN_EXPORTS, BARREL_EXPORT_TOKEN_LIMIT, CONFIG_NAME_PATTERNS, Classification, type CoUsageData, type ContextAnalysisResult, type ContextAnalyzerOptions, ContextAnalyzerProvider, type ContextSummary, type DependencyGraph, type DependencyNode, type DomainAssignment, type DomainSignals, EMAIL_NAME_PATTERNS, type ExportInfo, type FileClassification, HANDLER_NAME_PATTERNS, type ModuleCluster, NEXTJS_METADATA_EXPORTS, PARSER_NAME_PATTERNS, SERVICE_NAME_PATTERNS, SESSION_NAME_PATTERNS, 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, isBoilerplateBarrel, isConfigFile, isEmailTemplate, isHubAndSpokeFile, isLambdaHandler, isNextJsPage, isParserFile, isServiceFile, isSessionFile, isTypeDefinition, isUtilityModule, mapScoreToRating, runInteractiveSetup };