@aiready/context-analyzer 0.22.14 → 0.22.16

package/dist/cli-action-XDKINE2R.mjs

@@ -0,0 +1,95 @@
+import {
+  analyzeContext
+} from "./chunk-VYFHSGV6.mjs";
+import "./chunk-RQ5BQLT6.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: 10,
+      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-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,
@@ -1914,8 +1960,8 @@ function generateHTMLReport(summary, results) {
     {
       title: "Context Analysis Report",
       packageName: "context-analyzer",
-      packageUrl: "https://github.com/caopengau/aiready-context-analyzer",
-      bugUrl: "https://github.com/caopengau/aiready-context-analyzer/issues",
+      packageUrl: "https://github.com/getaiready/aiready-context-analyzer",
+      bugUrl: "https://github.com/getaiready/aiready-context-analyzer/issues",
       emoji: "\u{1F9E0}"
     },
     stats,
@@ -1995,12 +2041,12 @@ function displayConsoleReport(summary, results, maxResults = 10) {
   console.log(import_chalk2.default.cyan(divider));
   console.log(
     import_chalk2.default.dim(
-      "\n\u2B50 Like aiready? Star us on GitHub: https://github.com/caopengau/aiready-context-analyzer"
+      "\n\u2B50 Like aiready? Star us on GitHub: https://github.com/getaiready/aiready-context-analyzer"
     )
   );
   console.log(
     import_chalk2.default.dim(
-      "\u{1F41B} Found a bug? Report it: https://github.com/caopengau/aiready-context-analyzer/issues\n"
+      "\u{1F41B} Found a bug? Report it: https://github.com/getaiready/aiready-context-analyzer/issues\n"
     )
   );
 }
@@ -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-W7TESWAV.mjs");
+    const { contextActionHandler } = await import("./cli-action-7QXG7LHS.mjs");
     await contextActionHandler(directory, options);
   });
 }

package/dist/console-report-CVGRMWEU.mjs

@@ -0,0 +1,74 @@
+// src/report/console-report.ts
+import chalk from "chalk";
+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;
+  console.log(chalk.bold("\u{1F4CA} Context Analysis Summary:\n"));
+  console.log(`   \u2022 Total Files:      ${chalk.cyan(summary.totalFiles)}`);
+  console.log(
+    `   \u2022 Total Tokens:     ${chalk.cyan(summary.totalTokens.toLocaleString())}`
+  );
+  console.log(
+    `   \u2022 Avg Budget:       ${chalk.cyan(summary.avgContextBudget.toFixed(0))} tokens`
+  );
+  console.log(
+    `   \u2022 Potential Saving: ${chalk.green(summary.totalPotentialSavings.toLocaleString())} tokens`
+  );
+  console.log();
+  if (totalIssues > 0) {
+    console.log(chalk.bold("\u26A0\uFE0F Issues Detected:\n"));
+    console.log(`   \u2022 ${chalk.red("\u{1F534} Critical:")} ${summary.criticalIssues}`);
+    console.log(`   \u2022 ${chalk.yellow("\u{1F7E1} Major:")}    ${summary.majorIssues}`);
+    console.log(`   \u2022 ${chalk.blue("\u{1F535} Minor:")}    ${summary.minorIssues}`);
+    console.log();
+  } else {
+    console.log(chalk.green("\u2705 No significant context issues detected!\n"));
+  }
+  if (summary.fragmentedModules.length > 0) {
+    console.log(chalk.bold("\u{1F9E9} Top Fragmented Modules:\n"));
+    summary.fragmentedModules.slice(0, maxResults).forEach((mod) => {
+      const scoreColor = mod.fragmentationScore > 0.7 ? chalk.red : mod.fragmentationScore > 0.4 ? chalk.yellow : chalk.green;
+      console.log(
+        `   ${scoreColor("\u25A0")} ${chalk.white(mod.domain)} ${chalk.dim(`(${mod.files.length} files, ${(mod.fragmentationScore * 100).toFixed(0)}% frag)`)}`
+      );
+    });
+    console.log();
+  }
+  if (summary.topExpensiveFiles.length > 0) {
+    console.log(chalk.bold("\u{1F4B8} Most Expensive Files (Context Budget):\n"));
+    summary.topExpensiveFiles.slice(0, maxResults).forEach((item) => {
+      const fileName = item.file.split("/").slice(-2).join("/");
+      const severityColor = item.severity === "critical" ? chalk.red : item.severity === "major" ? chalk.yellow : chalk.blue;
+      console.log(
+        `   ${severityColor("\u25CF")} ${chalk.white(fileName)} ${chalk.dim(`- ${item.contextBudget.toLocaleString()} tokens`)}`
+      );
+    });
+    console.log();
+  }
+  if (totalIssues > 0) {
+    console.log(chalk.bold("\u{1F4A1} Top Recommendations:\n"));
+    const topFiles = results.filter((r) => r.severity === "critical" || r.severity === "major").slice(0, 3);
+    topFiles.forEach((result, index) => {
+      const fileName = result.file.split("/").slice(-2).join("/");
+      console.log(chalk.cyan(`   ${index + 1}. ${fileName}`));
+      result.recommendations.slice(0, 2).forEach((rec) => {
+        console.log(chalk.dim(`      \u2022 ${rec}`));
+      });
+    });
+    console.log();
+  }
+  console.log(chalk.cyan(divider));
+  console.log(
+    chalk.dim(
+      "\n\u2B50 Like aiready? Star us on GitHub: https://github.com/getaiready/aiready-context-analyzer"
+    )
+  );
+  console.log(
+    chalk.dim(
+      "\u{1F41B} Found a bug? Report it: https://github.com/getaiready/aiready-context-analyzer/issues\n"
+    )
+  );
+}
+export {
+  displayConsoleReport
+};

package/dist/html-report-BYGKWC3K.mjs

@@ -0,0 +1,73 @@
+// src/report/html-report.ts
+import {
+  generateIssueSummary,
+  generateTable,
+  generateStandardHtmlReport
+} from "@aiready/core";
+function generateHTMLReport(summary, results) {
+  const totalIssues = summary.criticalIssues + summary.majorIssues + summary.minorIssues;
+  void results;
+  const stats = [
+    { value: summary.totalFiles, label: "Files Analyzed" },
+    { value: summary.totalTokens.toLocaleString(), label: "Total Tokens" },
+    { value: summary.avgContextBudget.toFixed(0), label: "Avg Context Budget" },
+    {
+      value: totalIssues,
+      label: "Total Issues",
+      color: totalIssues > 0 ? "#f39c12" : void 0
+    }
+  ];
+  const sections = [];
+  if (totalIssues > 0) {
+    sections.push({
+      title: "\u26A0\uFE0F Issues Summary",
+      content: generateIssueSummary(
+        summary.criticalIssues,
+        summary.majorIssues,
+        summary.minorIssues,
+        summary.totalPotentialSavings
+      )
+    });
+  }
+  if (summary.fragmentedModules.length > 0) {
+    sections.push({
+      title: "\u{1F9E9} Fragmented Modules",
+      content: generateTable({
+        headers: ["Domain", "Files", "Fragmentation", "Token Cost"],
+        rows: summary.fragmentedModules.map((m) => [
+          m.domain,
+          String(m.files.length),
+          `${(m.fragmentationScore * 100).toFixed(0)}%`,
+          m.totalTokens.toLocaleString()
+        ])
+      })
+    });
+  }
+  if (summary.topExpensiveFiles.length > 0) {
+    sections.push({
+      title: "\u{1F4B8} Most Expensive Files",
+      content: generateTable({
+        headers: ["File", "Context Budget", "Severity"],
+        rows: summary.topExpensiveFiles.map((f) => [
+          f.file,
+          `${f.contextBudget.toLocaleString()} tokens`,
+          `<span class="issue-${f.severity}">${f.severity.toUpperCase()}</span>`
+        ])
+      })
+    });
+  }
+  return generateStandardHtmlReport(
+    {
+      title: "Context Analysis Report",
+      packageName: "context-analyzer",
+      packageUrl: "https://github.com/getaiready/aiready-context-analyzer",
+      bugUrl: "https://github.com/getaiready/aiready-context-analyzer/issues",
+      emoji: "\u{1F9E0}"
+    },
+    stats,
+    sections
+  );
+}
+export {
+  generateHTMLReport
+};

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;
 /**