@aiready/context-analyzer 0.22.15 → 0.22.17

package/dist/cli-action-Y6VATXMV.mjs

@@ -0,0 +1,95 @@
+import {
+  analyzeContext
+} from "./chunk-XDYPMFCH.mjs";
+import "./chunk-64U3PNO3.mjs";
+import {
+  generateSummary
+} from "./chunk-HD4Y3GYL.mjs";
+import "./chunk-JSM7Q5CY.mjs";
+
+// src/cli-action.ts
+import {
+  loadMergedConfig,
+  handleJSONOutput,
+  handleCLIError,
+  getElapsedTime,
+  resolveOutputPath
+} from "@aiready/core";
+import chalk from "chalk";
+import { writeFileSync } from "fs";
+async function contextActionHandler(directory, options) {
+  console.log(chalk.blue("\u{1F50D} Analyzing context window costs...\n"));
+  const startTime = Date.now();
+  try {
+    const defaults = {
+      maxDepth: 5,
+      maxContextBudget: 1e4,
+      minCohesion: 0.6,
+      maxFragmentation: 0.5,
+      focus: "all",
+      includeNodeModules: false,
+      include: void 0,
+      exclude: void 0,
+      maxResults: 10
+    };
+    let finalOptions = await 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,
+      maxFragmentation: options.maxFragmentation ? parseFloat(options.maxFragmentation) : void 0,
+      focus: options.focus || void 0,
+      includeNodeModules: options.includeNodeModules,
+      include: options.include?.split(","),
+      exclude: options.exclude?.split(","),
+      maxResults: options.maxResults ? parseInt(options.maxResults) : void 0
+    });
+    if (options.interactive) {
+      const { runInteractiveSetup } = await import("./interactive-setup-JGFBFI3M.mjs");
+      finalOptions = await runInteractiveSetup(directory, finalOptions);
+    }
+    const results = await analyzeContext(
+      finalOptions
+    );
+    const summary = generateSummary(results, finalOptions);
+    const duration = getElapsedTime(startTime);
+    if (options.output === "json") {
+      handleJSONOutput(
+        {
+          summary: {
+            ...summary,
+            executionTime: duration,
+            config: {
+              scan: { tools: ["context"] },
+              tools: { context: finalOptions }
+            },
+            toolConfigs: { context: finalOptions }
+          },
+          context: { results }
+        },
+        options.outputFile
+      );
+    } else if (options.output === "html") {
+      const { generateHTMLReport } = await import("./html-report-BYGKWC3K.mjs");
+      const html = generateHTMLReport(summary, results);
+      const outputPath = resolveOutputPath(
+        directory,
+        options.outputFile,
+        "context-report.html"
+      );
+      writeFileSync(outputPath, html, "utf-8");
+      console.log(chalk.green(`
+\u2705 HTML report saved to: ${outputPath}`));
+    } else {
+      const { displayConsoleReport } = await import("./console-report-CVGRMWEU.mjs");
+      displayConsoleReport(summary, results, finalOptions.maxResults);
+      console.log(chalk.dim(`
+\u2728 Analysis completed in ${duration}ms
+`));
+    }
+  } catch (error) {
+    handleCLIError(error, "context-analyzer");
+  }
+}
+export {
+  contextActionHandler
+};

package/dist/cli.js

@@ -135,6 +135,7 @@ function analyzeIssues(params) {
   const {
     file,
     importDepth,
+    tokenCost,
     contextBudget,
     cohesionScore,
     fragmentationScore,
@@ -169,21 +170,29 @@ function analyzeIssues(params) {
     recommendations.push("Consider reducing dependency depth");
     potentialSavings += contextBudget * 0.15;
   }
-  if (contextBudget > maxContextBudget * 1.5) {
-    severity = import_core2.Severity.Critical;
+  const MAX_FILE_TOKENS = 1e4;
+  if (tokenCost > MAX_FILE_TOKENS) {
+    if (severity !== import_core2.Severity.Critical) severity = import_core2.Severity.Major;
     issues.push(
-      `Context budget ${contextBudget.toLocaleString()} tokens is 50% over limit`
+      `File is excessively large (${tokenCost.toLocaleString()} tokens)`
     );
     recommendations.push(
-      "Split into smaller modules or reduce dependency tree"
+      "Split file into smaller, single-responsibility modules"
     );
+  }
+  if (contextBudget > maxContextBudget * 1.5) {
+    severity = import_core2.Severity.Critical;
+    issues.push(
+      `Total context budget ${contextBudget.toLocaleString()} tokens is 50% over limit`
+    );
+    recommendations.push("Reduce dependency tree width or reduce deep imports");
     potentialSavings += contextBudget * 0.4;
   } else if (contextBudget > maxContextBudget) {
     if (severity !== import_core2.Severity.Critical) severity = import_core2.Severity.Major;
     issues.push(
-      `Context budget ${contextBudget.toLocaleString()} exceeds ${maxContextBudget.toLocaleString()}`
+      `Total context budget ${contextBudget.toLocaleString()} exceeds ${maxContextBudget.toLocaleString()}`
     );
-    recommendations.push("Reduce file size or dependencies");
+    recommendations.push("Optimize dependency graph and reduce deep imports");
     potentialSavings += contextBudget * 0.2;
   }
   if (cohesionScore < minCohesion * 0.5) {
@@ -268,19 +277,27 @@ function calculateImportDepthFromEdges(file, edges, visited = /* @__PURE__ */ ne
   return maxDepth;
 }
 function getTransitiveDependenciesFromEdges(file, edges, visited = /* @__PURE__ */ new Set()) {
-  if (visited.has(file)) return [];
-  const nextVisited = new Set(visited);
-  nextVisited.add(file);
-  const dependencies = edges.get(file);
-  if (!dependencies || dependencies.size === 0) return [];
-  const allDeps = [];
-  for (const dep of dependencies) {
-    allDeps.push(dep);
-    allDeps.push(
-      ...getTransitiveDependenciesFromEdges(dep, edges, nextVisited)
-    );
+  const result = /* @__PURE__ */ new Map();
+  function dfs(current, depth) {
+    if (visited.has(current)) {
+      const existingDepth = result.get(current);
+      if (existingDepth !== void 0 && depth < existingDepth) {
+        result.set(current, depth);
+      }
+      return;
+    }
+    visited.add(current);
+    if (current !== file) {
+      result.set(current, depth);
+    }
+    const dependencies = edges.get(current);
+    if (!dependencies) return;
+    for (const dep of dependencies) {
+      dfs(dep, depth + 1);
+    }
   }
-  return [...new Set(allDeps)];
+  dfs(file, 0);
+  return result;
 }
 function detectGraphCycles(edges) {
   const cycles = [];
@@ -605,6 +622,30 @@ var init_ast_utils = __esm({
 // src/graph-builder.ts
 function resolveImport(source, importingFile, allFiles) {
   if (!source.startsWith(".") && !source.startsWith("/")) {
+    const externalIgnores = [
+      "react",
+      "next",
+      "lucide-react",
+      "framer-motion",
+      "@aws-sdk",
+      "stripe",
+      "clsx",
+      "tailwind-merge",
+      "zod",
+      "commander",
+      "chalk",
+      "fs",
+      "path",
+      "util",
+      "child_process",
+      "os",
+      "crypto"
+    ];
+    if (externalIgnores.some(
+      (pkg) => source === pkg || source.startsWith(`${pkg}/`)
+    )) {
+      return null;
+    }
     if (source.startsWith("@aiready/")) {
       const pkgName = source.split("/")[1];
       const possiblePaths = [
@@ -683,8 +724,9 @@ async function buildDependencyGraph(files, options) {
   const allFilePaths = new Set(files.map((f) => f.file));
   for (const { file, content } of files) {
     const { imports: astImports } = await (0, import_core4.parseFileExports)(content, file);
-    const resolvedImports = astImports.map((i) => resolveImport(i.source, file, allFilePaths)).filter((path) => path !== null);
-    const importSources = astImports.map((i) => i.source);
+    const runtimeImports = astImports.filter((i) => !i.isTypeOnly);
+    const resolvedImports = runtimeImports.map((i) => resolveImport(i.source, file, allFilePaths)).filter((path) => path !== null);
+    const importSources = runtimeImports.map((i) => i.source);
     const exports2 = await extractExportsWithAST(
       content,
       file,
@@ -737,13 +779,14 @@ function calculateContextBudget(file, graph) {
   if (!node) return 0;
   let totalTokens = node.tokenCost;
   const deps = getTransitiveDependencies(file, graph);
-  for (const dep of deps) {
+  for (const [dep, depth] of deps.entries()) {
     const depNode = graph.nodes.get(dep);
     if (depNode) {
-      totalTokens += depNode.tokenCost;
+      const discountFactor = Math.pow(0.8, depth - 1);
+      totalTokens += depNode.tokenCost * discountFactor;
     }
   }
-  return totalTokens;
+  return Math.round(totalTokens);
 }
 function detectCircularDependencies(graph) {
   return detectGraphCycles(graph.edges);
@@ -1508,6 +1551,7 @@ function mapNodeToResult(node, graph, clusters, allCircularDeps, options) {
     {
       file,
       importDepth,
+      tokenCost,
       contextBudget,
       cohesionScore,
       fragmentationScore,
@@ -1531,8 +1575,8 @@ function mapNodeToResult(node, graph, clusters, allCircularDeps, options) {
     tokenCost,
     linesOfCode: node.linesOfCode,
     importDepth,
-    dependencyCount: transitiveDeps.length,
-    dependencyList: transitiveDeps,
+    dependencyCount: transitiveDeps.size,
+    dependencyList: Array.from(transitiveDeps.keys()),
     circularDeps,
     cohesionScore,
     domains: Array.from(
@@ -1589,6 +1633,8 @@ async function analyzeContext(options) {
       const { severity, issues, recommendations, potentialSavings } = analyzeIssues({
         file: metric.file,
         importDepth: metric.importDepth,
+        tokenCost: metric.contextBudget,
+        // For Python, we use the reported budget as self-cost for now
         contextBudget: metric.contextBudget,
         cohesionScore: metric.cohesion,
         fragmentationScore: 0,
@@ -2022,7 +2068,7 @@ async function contextActionHandler(directory, options) {
   const startTime = Date.now();
   try {
     const defaults = {
-      maxDepth: 5,
+      maxDepth: 10,
       maxContextBudget: 1e4,
       minCohesion: 0.6,
       maxFragmentation: 0.5,
@@ -2047,7 +2093,9 @@ async function contextActionHandler(directory, options) {
       const { runInteractiveSetup: runInteractiveSetup2 } = await Promise.resolve().then(() => (init_interactive_setup(), interactive_setup_exports));
       finalOptions = await runInteractiveSetup2(directory, finalOptions);
     }
-    const results = await analyzeContext(finalOptions);
+    const results = await analyzeContext(
+      finalOptions
+    );
     const summary = generateSummary(results, finalOptions);
     const duration = (0, import_core9.getElapsedTime)(startTime);
     if (options.output === "json") {

package/dist/cli.mjs

@@ -37,7 +37,7 @@ function defineContextCommand(program2) {
     "--interactive",
     "Run interactive setup to suggest excludes and focus areas"
   ).action(async (directory, options) => {
-    const { contextActionHandler } = await import("./cli-action-JKG3R6RV.mjs");
+    const { contextActionHandler } = await import("./cli-action-7QXG7LHS.mjs");
     await contextActionHandler(directory, options);
   });
 }

package/dist/index.d.mts

@@ -23,6 +23,8 @@ interface ContextAnalyzerOptions extends ScanOptions {
     focus?: 'fragmentation' | 'cohesion' | 'depth' | 'all';
     /** Whether to include node_modules in the analysis (default: false) */
     includeNodeModules?: boolean;
+    /** Maximum number of results to display in console output (default: 10) */
+    maxResults?: number;
 }
 /**
  * The result of a context analysis for a single file or module.
@@ -286,13 +288,13 @@ declare function calculateImportDepth(file: string, graph: DependencyGraph, visi
  * @param visited - Optional set to track visited nodes.
  * @returns Array of all reachable file paths.
  */
-declare function getTransitiveDependencies(file: string, graph: DependencyGraph, visited?: Set<string>): string[];
+declare function getTransitiveDependencies(file: string, graph: DependencyGraph, visited?: Set<string>): Map<string, number>;
 /**
  * Calculate total context budget (tokens needed to understand this file and its dependencies).
  *
  * @param file - File path to calculate budget for.
  * @param graph - The dependency graph.
- * @returns Total token count including recursive dependencies.
+ * @returns Total token count including recursive dependencies (discounted by depth).
  */
 declare function calculateContextBudget(file: string, graph: DependencyGraph): number;
 /**

package/dist/index.d.ts

@@ -23,6 +23,8 @@ interface ContextAnalyzerOptions extends ScanOptions {
     focus?: 'fragmentation' | 'cohesion' | 'depth' | 'all';
     /** Whether to include node_modules in the analysis (default: false) */
     includeNodeModules?: boolean;
+    /** Maximum number of results to display in console output (default: 10) */
+    maxResults?: number;
 }
 /**
  * The result of a context analysis for a single file or module.
@@ -286,13 +288,13 @@ declare function calculateImportDepth(file: string, graph: DependencyGraph, visi
  * @param visited - Optional set to track visited nodes.
  * @returns Array of all reachable file paths.
  */
-declare function getTransitiveDependencies(file: string, graph: DependencyGraph, visited?: Set<string>): string[];
+declare function getTransitiveDependencies(file: string, graph: DependencyGraph, visited?: Set<string>): Map<string, number>;
 /**
  * Calculate total context budget (tokens needed to understand this file and its dependencies).
  *
  * @param file - File path to calculate budget for.
  * @param graph - The dependency graph.
- * @returns Total token count including recursive dependencies.
+ * @returns Total token count including recursive dependencies (discounted by depth).
  */
 declare function calculateContextBudget(file: string, graph: DependencyGraph): number;
 /**

package/dist/index.js

@@ -177,6 +177,7 @@ function analyzeIssues(params) {
   const {
     file,
     importDepth,
+    tokenCost,
     contextBudget,
     cohesionScore,
     fragmentationScore,
@@ -211,21 +212,29 @@ function analyzeIssues(params) {
     recommendations.push("Consider reducing dependency depth");
     potentialSavings += contextBudget * 0.15;
   }
-  if (contextBudget > maxContextBudget * 1.5) {
-    severity = import_core3.Severity.Critical;
+  const MAX_FILE_TOKENS = 1e4;
+  if (tokenCost > MAX_FILE_TOKENS) {
+    if (severity !== import_core3.Severity.Critical) severity = import_core3.Severity.Major;
     issues.push(
-      `Context budget ${contextBudget.toLocaleString()} tokens is 50% over limit`
+      `File is excessively large (${tokenCost.toLocaleString()} tokens)`
     );
     recommendations.push(
-      "Split into smaller modules or reduce dependency tree"
+      "Split file into smaller, single-responsibility modules"
     );
+  }
+  if (contextBudget > maxContextBudget * 1.5) {
+    severity = import_core3.Severity.Critical;
+    issues.push(
+      `Total context budget ${contextBudget.toLocaleString()} tokens is 50% over limit`
+    );
+    recommendations.push("Reduce dependency tree width or reduce deep imports");
     potentialSavings += contextBudget * 0.4;
   } else if (contextBudget > maxContextBudget) {
     if (severity !== import_core3.Severity.Critical) severity = import_core3.Severity.Major;
     issues.push(
-      `Context budget ${contextBudget.toLocaleString()} exceeds ${maxContextBudget.toLocaleString()}`
+      `Total context budget ${contextBudget.toLocaleString()} exceeds ${maxContextBudget.toLocaleString()}`
     );
-    recommendations.push("Reduce file size or dependencies");
+    recommendations.push("Optimize dependency graph and reduce deep imports");
     potentialSavings += contextBudget * 0.2;
   }
   if (cohesionScore < minCohesion * 0.5) {
@@ -310,19 +319,27 @@ function calculateImportDepthFromEdges(file, edges, visited = /* @__PURE__ */ ne
   return maxDepth;
 }
 function getTransitiveDependenciesFromEdges(file, edges, visited = /* @__PURE__ */ new Set()) {
-  if (visited.has(file)) return [];
-  const nextVisited = new Set(visited);
-  nextVisited.add(file);
-  const dependencies = edges.get(file);
-  if (!dependencies || dependencies.size === 0) return [];
-  const allDeps = [];
-  for (const dep of dependencies) {
-    allDeps.push(dep);
-    allDeps.push(
-      ...getTransitiveDependenciesFromEdges(dep, edges, nextVisited)
-    );
+  const result = /* @__PURE__ */ new Map();
+  function dfs(current, depth) {
+    if (visited.has(current)) {
+      const existingDepth = result.get(current);
+      if (existingDepth !== void 0 && depth < existingDepth) {
+        result.set(current, depth);
+      }
+      return;
+    }
+    visited.add(current);
+    if (current !== file) {
+      result.set(current, depth);
+    }
+    const dependencies = edges.get(current);
+    if (!dependencies) return;
+    for (const dep of dependencies) {
+      dfs(dep, depth + 1);
+    }
   }
-  return [...new Set(allDeps)];
+  dfs(file, 0);
+  return result;
 }
 function detectGraphCycles(edges) {
   const cycles = [];
@@ -647,6 +664,30 @@ var init_ast_utils = __esm({
 // src/graph-builder.ts
 function resolveImport(source, importingFile, allFiles) {
   if (!source.startsWith(".") && !source.startsWith("/")) {
+    const externalIgnores = [
+      "react",
+      "next",
+      "lucide-react",
+      "framer-motion",
+      "@aws-sdk",
+      "stripe",
+      "clsx",
+      "tailwind-merge",
+      "zod",
+      "commander",
+      "chalk",
+      "fs",
+      "path",
+      "util",
+      "child_process",
+      "os",
+      "crypto"
+    ];
+    if (externalIgnores.some(
+      (pkg) => source === pkg || source.startsWith(`${pkg}/`)
+    )) {
+      return null;
+    }
     if (source.startsWith("@aiready/")) {
       const pkgName = source.split("/")[1];
       const possiblePaths = [
@@ -725,8 +766,9 @@ async function buildDependencyGraph(files, options) {
   const allFilePaths = new Set(files.map((f) => f.file));
   for (const { file, content } of files) {
     const { imports: astImports } = await (0, import_core5.parseFileExports)(content, file);
-    const resolvedImports = astImports.map((i) => resolveImport(i.source, file, allFilePaths)).filter((path) => path !== null);
-    const importSources = astImports.map((i) => i.source);
+    const runtimeImports = astImports.filter((i) => !i.isTypeOnly);
+    const resolvedImports = runtimeImports.map((i) => resolveImport(i.source, file, allFilePaths)).filter((path) => path !== null);
+    const importSources = runtimeImports.map((i) => i.source);
     const exports2 = await extractExportsWithAST(
       content,
       file,
@@ -779,13 +821,14 @@ function calculateContextBudget(file, graph) {
   if (!node) return 0;
   let totalTokens = node.tokenCost;
   const deps = getTransitiveDependencies(file, graph);
-  for (const dep of deps) {
+  for (const [dep, depth] of deps.entries()) {
     const depNode = graph.nodes.get(dep);
     if (depNode) {
-      totalTokens += depNode.tokenCost;
+      const discountFactor = Math.pow(0.8, depth - 1);
+      totalTokens += depNode.tokenCost * discountFactor;
     }
   }
-  return totalTokens;
+  return Math.round(totalTokens);
 }
 function detectCircularDependencies(graph) {
   return detectGraphCycles(graph.edges);
@@ -1604,6 +1647,7 @@ function mapNodeToResult(node, graph, clusters, allCircularDeps, options) {
     {
       file,
       importDepth,
+      tokenCost,
       contextBudget,
       cohesionScore,
       fragmentationScore,
@@ -1627,8 +1671,8 @@ function mapNodeToResult(node, graph, clusters, allCircularDeps, options) {
     tokenCost,
     linesOfCode: node.linesOfCode,
     importDepth,
-    dependencyCount: transitiveDeps.length,
-    dependencyList: transitiveDeps,
+    dependencyCount: transitiveDeps.size,
+    dependencyList: Array.from(transitiveDeps.keys()),
     circularDeps,
     cohesionScore,
     domains: Array.from(
@@ -1688,6 +1732,8 @@ async function analyzeContext(options) {
       const { severity, issues, recommendations, potentialSavings } = analyzeIssues({
         file: metric.file,
         importDepth: metric.importDepth,
+        tokenCost: metric.contextBudget,
+        // For Python, we use the reported budget as self-cost for now
         contextBudget: metric.contextBudget,
         cohesionScore: metric.cohesion,
         fragmentationScore: 0,

package/dist/index.mjs

@@ -12,8 +12,8 @@ import {
   getClassificationRecommendations,
   getGeneralRecommendations,
   getTransitiveDependencies
-} from "./chunk-ISWPFG2C.mjs";
-import "./chunk-64U3PNO3.mjs";
+} from "./chunk-2LEHY2GV.mjs";
+import "./chunk-RQ5BQLT6.mjs";
 import {
   generateSummary
 } from "./chunk-HD4Y3GYL.mjs";
@@ -230,7 +230,7 @@ var CONTEXT_ANALYZER_PROVIDER = {
   id: ToolName2.ContextAnalyzer,
   alias: ["context", "fragmentation", "budget"],
   async analyze(options) {
-    const { analyzeContext: analyzeContext2 } = await import("./orchestrator-QNE2E4TE.mjs");
+    const { analyzeContext: analyzeContext2 } = await import("./orchestrator-66ZVNOLR.mjs");
     const { generateSummary: generateSummary2 } = await import("./summary-TZFB6ZFM.mjs");
     const results = await analyzeContext2(options);
     const summary = generateSummary2(results, options);

package/dist/orchestrator-2KQNMO2L.mjs

@@ -0,0 +1,10 @@
+import {
+  analyzeContext,
+  calculateCohesion
+} from "./chunk-QTB4KYCX.mjs";
+import "./chunk-64U3PNO3.mjs";
+import "./chunk-JSM7Q5CY.mjs";
+export {
+  analyzeContext,
+  calculateCohesion
+};

package/dist/orchestrator-66ZVNOLR.mjs

@@ -0,0 +1,10 @@
+import {
+  analyzeContext,
+  calculateCohesion
+} from "./chunk-2LEHY2GV.mjs";
+import "./chunk-RQ5BQLT6.mjs";
+import "./chunk-JSM7Q5CY.mjs";
+export {
+  analyzeContext,
+  calculateCohesion
+};

package/dist/orchestrator-KM2OJPZD.mjs

@@ -0,0 +1,10 @@
+import {
+  analyzeContext,
+  calculateCohesion
+} from "./chunk-P2ZQGQAO.mjs";
+import "./chunk-64U3PNO3.mjs";
+import "./chunk-JSM7Q5CY.mjs";
+export {
+  analyzeContext,
+  calculateCohesion
+};

package/dist/orchestrator-MKDZPRBA.mjs

@@ -0,0 +1,10 @@
+import {
+  analyzeContext,
+  calculateCohesion
+} from "./chunk-QGI23DBA.mjs";
+import "./chunk-WLXLBWDU.mjs";
+import "./chunk-JSM7Q5CY.mjs";
+export {
+  analyzeContext,
+  calculateCohesion
+};

package/dist/orchestrator-QSHWWBWS.mjs

@@ -0,0 +1,10 @@
+import {
+  analyzeContext,
+  calculateCohesion
+} from "./chunk-VYFHSGV6.mjs";
+import "./chunk-RQ5BQLT6.mjs";
+import "./chunk-JSM7Q5CY.mjs";
+export {
+  analyzeContext,
+  calculateCohesion
+};

package/dist/orchestrator-WFQPMNSD.mjs

@@ -0,0 +1,10 @@
+import {
+  analyzeContext,
+  calculateCohesion
+} from "./chunk-XDYPMFCH.mjs";
+import "./chunk-64U3PNO3.mjs";
+import "./chunk-JSM7Q5CY.mjs";
+export {
+  analyzeContext,
+  calculateCohesion
+};