@aiready/context-analyzer 0.1.0

package/dist/cli.js

@@ -0,0 +1,942 @@
+#!/usr/bin/env node
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// src/cli.ts
+var import_commander = require("commander");
+
+// src/index.ts
+var import_core2 = require("@aiready/core");
+
+// src/analyzer.ts
+var import_core = require("@aiready/core");
+function buildDependencyGraph(files) {
+  const nodes = /* @__PURE__ */ new Map();
+  const edges = /* @__PURE__ */ new Map();
+  for (const { file, content } of files) {
+    const imports = extractImportsFromContent(content);
+    const exports2 = extractExports(content);
+    const tokenCost = (0, import_core.estimateTokens)(content);
+    const linesOfCode = content.split("\n").length;
+    nodes.set(file, {
+      file,
+      imports,
+      exports: exports2,
+      tokenCost,
+      linesOfCode
+    });
+    edges.set(file, new Set(imports));
+  }
+  return { nodes, edges };
+}
+function extractImportsFromContent(content) {
+  const imports = [];
+  const patterns = [
+    /import\s+.*?\s+from\s+['"](.+?)['"]/g,
+    // import ... from '...'
+    /import\s+['"](.+?)['"]/g,
+    // import '...'
+    /require\(['"](.+?)['"]\)/g
+    // require('...')
+  ];
+  for (const pattern of patterns) {
+    let match;
+    while ((match = pattern.exec(content)) !== null) {
+      const importPath = match[1];
+      if (importPath && !importPath.startsWith("@") && !importPath.startsWith("node:")) {
+        imports.push(importPath);
+      }
+    }
+  }
+  return [...new Set(imports)];
+}
+function calculateImportDepth(file, graph, visited = /* @__PURE__ */ new Set(), depth = 0) {
+  if (visited.has(file)) {
+    return depth;
+  }
+  const dependencies = graph.edges.get(file);
+  if (!dependencies || dependencies.size === 0) {
+    return depth;
+  }
+  visited.add(file);
+  let maxDepth = depth;
+  for (const dep of dependencies) {
+    const depDepth = calculateImportDepth(dep, graph, visited, depth + 1);
+    maxDepth = Math.max(maxDepth, depDepth);
+  }
+  visited.delete(file);
+  return maxDepth;
+}
+function getTransitiveDependencies(file, graph, visited = /* @__PURE__ */ new Set()) {
+  if (visited.has(file)) {
+    return [];
+  }
+  visited.add(file);
+  const dependencies = graph.edges.get(file);
+  if (!dependencies || dependencies.size === 0) {
+    return [];
+  }
+  const allDeps = [];
+  for (const dep of dependencies) {
+    allDeps.push(dep);
+    allDeps.push(...getTransitiveDependencies(dep, graph, visited));
+  }
+  return [...new Set(allDeps)];
+}
+function calculateContextBudget(file, graph) {
+  const node = graph.nodes.get(file);
+  if (!node) return 0;
+  let totalTokens = node.tokenCost;
+  const deps = getTransitiveDependencies(file, graph);
+  for (const dep of deps) {
+    const depNode = graph.nodes.get(dep);
+    if (depNode) {
+      totalTokens += depNode.tokenCost;
+    }
+  }
+  return totalTokens;
+}
+function detectCircularDependencies(graph) {
+  const cycles = [];
+  const visited = /* @__PURE__ */ new Set();
+  const recursionStack = /* @__PURE__ */ new Set();
+  function dfs(file, path) {
+    if (recursionStack.has(file)) {
+      const cycleStart = path.indexOf(file);
+      if (cycleStart !== -1) {
+        cycles.push([...path.slice(cycleStart), file]);
+      }
+      return;
+    }
+    if (visited.has(file)) {
+      return;
+    }
+    visited.add(file);
+    recursionStack.add(file);
+    path.push(file);
+    const dependencies = graph.edges.get(file);
+    if (dependencies) {
+      for (const dep of dependencies) {
+        dfs(dep, [...path]);
+      }
+    }
+    recursionStack.delete(file);
+  }
+  for (const file of graph.nodes.keys()) {
+    if (!visited.has(file)) {
+      dfs(file, []);
+    }
+  }
+  return cycles;
+}
+function calculateCohesion(exports2) {
+  if (exports2.length === 0) return 1;
+  if (exports2.length === 1) return 1;
+  const domains = exports2.map((e) => e.inferredDomain || "unknown");
+  const domainCounts = /* @__PURE__ */ new Map();
+  for (const domain of domains) {
+    domainCounts.set(domain, (domainCounts.get(domain) || 0) + 1);
+  }
+  const total = domains.length;
+  let entropy = 0;
+  for (const count of domainCounts.values()) {
+    const p = count / total;
+    if (p > 0) {
+      entropy -= p * Math.log2(p);
+    }
+  }
+  const maxEntropy = Math.log2(total);
+  return maxEntropy > 0 ? 1 - entropy / maxEntropy : 1;
+}
+function calculateFragmentation(files, domain) {
+  if (files.length <= 1) return 0;
+  const directories = new Set(files.map((f) => f.split("/").slice(0, -1).join("/")));
+  return (directories.size - 1) / (files.length - 1);
+}
+function detectModuleClusters(graph) {
+  const domainMap = /* @__PURE__ */ new Map();
+  for (const [file, node] of graph.nodes.entries()) {
+    const domains = node.exports.map((e) => e.inferredDomain || "unknown");
+    const primaryDomain = domains[0] || "unknown";
+    if (!domainMap.has(primaryDomain)) {
+      domainMap.set(primaryDomain, []);
+    }
+    domainMap.get(primaryDomain).push(file);
+  }
+  const clusters = [];
+  for (const [domain, files] of domainMap.entries()) {
+    if (files.length < 2) continue;
+    const totalTokens = files.reduce((sum, file) => {
+      const node = graph.nodes.get(file);
+      return sum + (node?.tokenCost || 0);
+    }, 0);
+    const fragmentationScore = calculateFragmentation(files, domain);
+    const avgCohesion = files.reduce((sum, file) => {
+      const node = graph.nodes.get(file);
+      return sum + (node ? calculateCohesion(node.exports) : 0);
+    }, 0) / files.length;
+    const targetFiles = Math.max(1, Math.ceil(files.length / 3));
+    const consolidationPlan = generateConsolidationPlan(
+      domain,
+      files,
+      targetFiles
+    );
+    clusters.push({
+      domain,
+      files,
+      totalTokens,
+      fragmentationScore,
+      avgCohesion,
+      suggestedStructure: {
+        targetFiles,
+        consolidationPlan
+      }
+    });
+  }
+  return clusters.sort((a, b) => b.fragmentationScore - a.fragmentationScore);
+}
+function extractExports(content) {
+  const exports2 = [];
+  const patterns = [
+    /export\s+function\s+(\w+)/g,
+    /export\s+class\s+(\w+)/g,
+    /export\s+const\s+(\w+)/g,
+    /export\s+type\s+(\w+)/g,
+    /export\s+interface\s+(\w+)/g,
+    /export\s+default/g
+  ];
+  const types = [
+    "function",
+    "class",
+    "const",
+    "type",
+    "interface",
+    "default"
+  ];
+  patterns.forEach((pattern, index) => {
+    let match;
+    while ((match = pattern.exec(content)) !== null) {
+      const name = match[1] || "default";
+      const type = types[index];
+      const inferredDomain = inferDomain(name);
+      exports2.push({ name, type, inferredDomain });
+    }
+  });
+  return exports2;
+}
+function inferDomain(name) {
+  const lower = name.toLowerCase();
+  const domainKeywords = [
+    "user",
+    "auth",
+    "order",
+    "product",
+    "payment",
+    "cart",
+    "invoice",
+    "customer",
+    "admin",
+    "api",
+    "util",
+    "helper",
+    "config",
+    "service",
+    "repository",
+    "controller",
+    "model",
+    "view"
+  ];
+  for (const keyword of domainKeywords) {
+    if (lower.includes(keyword)) {
+      return keyword;
+    }
+  }
+  return "unknown";
+}
+function generateConsolidationPlan(domain, files, targetFiles) {
+  const plan = [];
+  if (files.length <= targetFiles) {
+    return [`No consolidation needed for ${domain}`];
+  }
+  plan.push(
+    `Consolidate ${files.length} ${domain} files into ${targetFiles} cohesive file(s):`
+  );
+  const dirGroups = /* @__PURE__ */ new Map();
+  for (const file of files) {
+    const dir = file.split("/").slice(0, -1).join("/");
+    if (!dirGroups.has(dir)) {
+      dirGroups.set(dir, []);
+    }
+    dirGroups.get(dir).push(file);
+  }
+  plan.push(`1. Create unified ${domain} module file`);
+  plan.push(
+    `2. Move related functionality from ${files.length} scattered files`
+  );
+  plan.push(`3. Update imports in dependent files`);
+  plan.push(
+    `4. Remove old files after consolidation (verify with tests first)`
+  );
+  return plan;
+}
+
+// src/index.ts
+async function analyzeContext(options) {
+  const {
+    maxDepth = 5,
+    maxContextBudget = 1e4,
+    minCohesion = 0.6,
+    maxFragmentation = 0.5,
+    focus = "all",
+    includeNodeModules = false,
+    ...scanOptions
+  } = options;
+  const files = await (0, import_core2.scanFiles)({
+    ...scanOptions,
+    exclude: includeNodeModules ? scanOptions.exclude : [...scanOptions.exclude || [], "**/node_modules/**"]
+  });
+  const fileContents = await Promise.all(
+    files.map(async (file) => ({
+      file,
+      content: await (0, import_core2.readFileContent)(file)
+    }))
+  );
+  const graph = buildDependencyGraph(fileContents);
+  const circularDeps = detectCircularDependencies(graph);
+  const clusters = detectModuleClusters(graph);
+  const fragmentationMap = /* @__PURE__ */ new Map();
+  for (const cluster of clusters) {
+    for (const file of cluster.files) {
+      fragmentationMap.set(file, cluster.fragmentationScore);
+    }
+  }
+  const results = [];
+  for (const { file } of fileContents) {
+    const node = graph.nodes.get(file);
+    if (!node) continue;
+    const importDepth = focus === "depth" || focus === "all" ? calculateImportDepth(file, graph) : 0;
+    const dependencyList = focus === "depth" || focus === "all" ? getTransitiveDependencies(file, graph) : [];
+    const contextBudget = focus === "all" ? calculateContextBudget(file, graph) : node.tokenCost;
+    const cohesionScore = focus === "cohesion" || focus === "all" ? calculateCohesion(node.exports) : 1;
+    const fragmentationScore = fragmentationMap.get(file) || 0;
+    const relatedFiles = [];
+    for (const cluster of clusters) {
+      if (cluster.files.includes(file)) {
+        relatedFiles.push(...cluster.files.filter((f) => f !== file));
+        break;
+      }
+    }
+    const { severity, issues, recommendations, potentialSavings } = analyzeIssues({
+      file,
+      importDepth,
+      contextBudget,
+      cohesionScore,
+      fragmentationScore,
+      maxDepth,
+      maxContextBudget,
+      minCohesion,
+      maxFragmentation,
+      circularDeps
+    });
+    const domains = [
+      ...new Set(node.exports.map((e) => e.inferredDomain || "unknown"))
+    ];
+    results.push({
+      file,
+      tokenCost: node.tokenCost,
+      linesOfCode: node.linesOfCode,
+      importDepth,
+      dependencyCount: dependencyList.length,
+      dependencyList,
+      circularDeps: circularDeps.filter((cycle) => cycle.includes(file)),
+      cohesionScore,
+      domains,
+      exportCount: node.exports.length,
+      contextBudget,
+      fragmentationScore,
+      relatedFiles,
+      severity,
+      issues,
+      recommendations,
+      potentialSavings
+    });
+  }
+  return results.sort((a, b) => {
+    const severityOrder = { critical: 0, major: 1, minor: 2, info: 3 };
+    const severityDiff = severityOrder[a.severity] - severityOrder[b.severity];
+    if (severityDiff !== 0) return severityDiff;
+    return b.contextBudget - a.contextBudget;
+  });
+}
+function generateSummary(results) {
+  if (results.length === 0) {
+    return {
+      totalFiles: 0,
+      totalTokens: 0,
+      avgContextBudget: 0,
+      maxContextBudget: 0,
+      avgImportDepth: 0,
+      maxImportDepth: 0,
+      deepFiles: [],
+      avgFragmentation: 0,
+      fragmentedModules: [],
+      avgCohesion: 0,
+      lowCohesionFiles: [],
+      criticalIssues: 0,
+      majorIssues: 0,
+      minorIssues: 0,
+      totalPotentialSavings: 0,
+      topExpensiveFiles: []
+    };
+  }
+  const totalFiles = results.length;
+  const totalTokens = results.reduce((sum, r) => sum + r.tokenCost, 0);
+  const totalContextBudget = results.reduce(
+    (sum, r) => sum + r.contextBudget,
+    0
+  );
+  const avgContextBudget = totalContextBudget / totalFiles;
+  const maxContextBudget = Math.max(...results.map((r) => r.contextBudget));
+  const avgImportDepth = results.reduce((sum, r) => sum + r.importDepth, 0) / totalFiles;
+  const maxImportDepth = Math.max(...results.map((r) => r.importDepth));
+  const deepFiles = results.filter((r) => r.importDepth >= 5).map((r) => ({ file: r.file, depth: r.importDepth })).sort((a, b) => b.depth - a.depth).slice(0, 10);
+  const avgFragmentation = results.reduce((sum, r) => sum + r.fragmentationScore, 0) / totalFiles;
+  const moduleMap = /* @__PURE__ */ new Map();
+  for (const result of results) {
+    for (const domain of result.domains) {
+      if (!moduleMap.has(domain)) {
+        moduleMap.set(domain, []);
+      }
+      moduleMap.get(domain).push(result);
+    }
+  }
+  const fragmentedModules = [];
+  for (const [domain, files] of moduleMap.entries()) {
+    if (files.length < 2) continue;
+    const fragmentationScore = files.reduce((sum, f) => sum + f.fragmentationScore, 0) / files.length;
+    if (fragmentationScore < 0.3) continue;
+    const totalTokens2 = files.reduce((sum, f) => sum + f.tokenCost, 0);
+    const avgCohesion2 = files.reduce((sum, f) => sum + f.cohesionScore, 0) / files.length;
+    const targetFiles = Math.max(1, Math.ceil(files.length / 3));
+    fragmentedModules.push({
+      domain,
+      files: files.map((f) => f.file),
+      totalTokens: totalTokens2,
+      fragmentationScore,
+      avgCohesion: avgCohesion2,
+      suggestedStructure: {
+        targetFiles,
+        consolidationPlan: [
+          `Consolidate ${files.length} ${domain} files into ${targetFiles} cohesive file(s)`,
+          `Current token cost: ${totalTokens2.toLocaleString()}`,
+          `Estimated savings: ${Math.floor(totalTokens2 * 0.3).toLocaleString()} tokens (30%)`
+        ]
+      }
+    });
+  }
+  fragmentedModules.sort((a, b) => b.fragmentationScore - a.fragmentationScore);
+  const avgCohesion = results.reduce((sum, r) => sum + r.cohesionScore, 0) / totalFiles;
+  const lowCohesionFiles = results.filter((r) => r.cohesionScore < 0.6).map((r) => ({ file: r.file, score: r.cohesionScore })).sort((a, b) => a.score - b.score).slice(0, 10);
+  const criticalIssues = results.filter((r) => r.severity === "critical").length;
+  const majorIssues = results.filter((r) => r.severity === "major").length;
+  const minorIssues = results.filter((r) => r.severity === "minor").length;
+  const totalPotentialSavings = results.reduce(
+    (sum, r) => sum + r.potentialSavings,
+    0
+  );
+  const topExpensiveFiles = results.sort((a, b) => b.contextBudget - a.contextBudget).slice(0, 10).map((r) => ({
+    file: r.file,
+    contextBudget: r.contextBudget,
+    severity: r.severity
+  }));
+  return {
+    totalFiles,
+    totalTokens,
+    avgContextBudget,
+    maxContextBudget,
+    avgImportDepth,
+    maxImportDepth,
+    deepFiles,
+    avgFragmentation,
+    fragmentedModules: fragmentedModules.slice(0, 10),
+    avgCohesion,
+    lowCohesionFiles,
+    criticalIssues,
+    majorIssues,
+    minorIssues,
+    totalPotentialSavings,
+    topExpensiveFiles
+  };
+}
+function analyzeIssues(params) {
+  const {
+    file,
+    importDepth,
+    contextBudget,
+    cohesionScore,
+    fragmentationScore,
+    maxDepth,
+    maxContextBudget,
+    minCohesion,
+    maxFragmentation,
+    circularDeps
+  } = params;
+  const issues = [];
+  const recommendations = [];
+  let severity = "info";
+  let potentialSavings = 0;
+  if (circularDeps.length > 0) {
+    severity = "critical";
+    issues.push(
+      `Part of ${circularDeps.length} circular dependency chain(s)`
+    );
+    recommendations.push("Break circular dependencies by extracting interfaces or using dependency injection");
+    potentialSavings += contextBudget * 0.2;
+  }
+  if (importDepth > maxDepth * 1.5) {
+    severity = severity === "critical" ? "critical" : "critical";
+    issues.push(`Import depth ${importDepth} exceeds limit by 50%`);
+    recommendations.push("Flatten dependency tree or use facade pattern");
+    potentialSavings += contextBudget * 0.3;
+  } else if (importDepth > maxDepth) {
+    severity = severity === "critical" ? "critical" : "major";
+    issues.push(`Import depth ${importDepth} exceeds recommended maximum ${maxDepth}`);
+    recommendations.push("Consider reducing dependency depth");
+    potentialSavings += contextBudget * 0.15;
+  }
+  if (contextBudget > maxContextBudget * 1.5) {
+    severity = severity === "critical" ? "critical" : "critical";
+    issues.push(`Context budget ${contextBudget.toLocaleString()} tokens is 50% over limit`);
+    recommendations.push("Split into smaller modules or reduce dependency tree");
+    potentialSavings += contextBudget * 0.4;
+  } else if (contextBudget > maxContextBudget) {
+    severity = severity === "critical" || severity === "major" ? severity : "major";
+    issues.push(`Context budget ${contextBudget.toLocaleString()} exceeds ${maxContextBudget.toLocaleString()}`);
+    recommendations.push("Reduce file size or dependencies");
+    potentialSavings += contextBudget * 0.2;
+  }
+  if (cohesionScore < minCohesion * 0.5) {
+    severity = severity === "critical" ? "critical" : "major";
+    issues.push(`Very low cohesion (${(cohesionScore * 100).toFixed(0)}%) - mixed concerns`);
+    recommendations.push("Split file by domain - separate unrelated functionality");
+    potentialSavings += contextBudget * 0.25;
+  } else if (cohesionScore < minCohesion) {
+    severity = severity === "critical" || severity === "major" ? severity : "minor";
+    issues.push(`Low cohesion (${(cohesionScore * 100).toFixed(0)}%)`);
+    recommendations.push("Consider grouping related exports together");
+    potentialSavings += contextBudget * 0.1;
+  }
+  if (fragmentationScore > maxFragmentation) {
+    severity = severity === "critical" || severity === "major" ? severity : "minor";
+    issues.push(`High fragmentation (${(fragmentationScore * 100).toFixed(0)}%) - scattered implementation`);
+    recommendations.push("Consolidate with related files in same domain");
+    potentialSavings += contextBudget * 0.3;
+  }
+  if (issues.length === 0) {
+    issues.push("No significant issues detected");
+    recommendations.push("File is well-structured for AI context usage");
+  }
+  return { severity, issues, recommendations, potentialSavings: Math.floor(potentialSavings) };
+}
+
+// src/cli.ts
+var import_chalk = __toESM(require("chalk"));
+var import_fs = require("fs");
+var import_path = require("path");
+var program = new import_commander.Command();
+program.name("aiready-context").description("Analyze AI context window cost and code structure").version("0.1.0").argument("<directory>", "Directory to analyze").option("--max-depth <number>", "Maximum acceptable import depth", "5").option(
+  "--max-context <number>",
+  "Maximum acceptable context budget (tokens)",
+  "10000"
+).option("--min-cohesion <number>", "Minimum acceptable cohesion score (0-1)", "0.6").option(
+  "--max-fragmentation <number>",
+  "Maximum acceptable fragmentation (0-1)",
+  "0.5"
+).option(
+  "--focus <type>",
+  "Analysis focus: fragmentation, cohesion, depth, all",
+  "all"
+).option("--include-node-modules", "Include node_modules in analysis", false).option("--include <patterns>", "File patterns to include (comma-separated)").option("--exclude <patterns>", "File patterns to exclude (comma-separated)").option(
+  "-o, --output <format>",
+  "Output format: console, json, html",
+  "console"
+).option("--output-file <path>", "Output file path (for json/html)").action(async (directory, options) => {
+  console.log(import_chalk.default.blue("\u{1F50D} Analyzing context window costs...\n"));
+  const startTime = Date.now();
+  try {
+    const results = await analyzeContext({
+      rootDir: directory,
+      maxDepth: parseInt(options.maxDepth),
+      maxContextBudget: parseInt(options.maxContext),
+      minCohesion: parseFloat(options.minCohesion),
+      maxFragmentation: parseFloat(options.maxFragmentation),
+      focus: options.focus,
+      includeNodeModules: options.includeNodeModules,
+      include: options.include?.split(","),
+      exclude: options.exclude?.split(",")
+    });
+    const elapsedTime = ((Date.now() - startTime) / 1e3).toFixed(2);
+    const summary = generateSummary(results);
+    if (options.output === "json") {
+      const jsonOutput = {
+        summary,
+        results,
+        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+        analysisTime: elapsedTime
+      };
+      if (options.outputFile) {
+        (0, import_fs.writeFileSync)(
+          options.outputFile,
+          JSON.stringify(jsonOutput, null, 2)
+        );
+        console.log(
+          import_chalk.default.green(`
+\u2713 JSON report saved to ${options.outputFile}`)
+        );
+      } else {
+        console.log(JSON.stringify(jsonOutput, null, 2));
+      }
+      return;
+    }
+    if (options.output === "html") {
+      const html = generateHTMLReport(summary, results);
+      const outputPath = options.outputFile || (0, import_path.join)(process.cwd(), "context-report.html");
+      (0, import_fs.writeFileSync)(outputPath, html);
+      console.log(import_chalk.default.green(`
+\u2713 HTML report saved to ${outputPath}`));
+      return;
+    }
+    displayConsoleReport(summary, results, elapsedTime);
+  } catch (error) {
+    console.error(import_chalk.default.red("\n\u274C Analysis failed:"));
+    console.error(import_chalk.default.red(error instanceof Error ? error.message : String(error)));
+    process.exit(1);
+  }
+});
+program.parse();
+function displayConsoleReport(summary, results, elapsedTime) {
+  const terminalWidth = process.stdout.columns || 80;
+  const dividerWidth = Math.min(60, terminalWidth - 2);
+  const divider = "\u2501".repeat(dividerWidth);
+  console.log(import_chalk.default.cyan(divider));
+  console.log(import_chalk.default.bold.white("  CONTEXT ANALYSIS SUMMARY"));
+  console.log(import_chalk.default.cyan(divider) + "\n");
+  console.log(import_chalk.default.white(`\u{1F4C1} Files analyzed: ${import_chalk.default.bold(summary.totalFiles)}`));
+  console.log(
+    import_chalk.default.white(`\u{1F4CA} Total tokens: ${import_chalk.default.bold(summary.totalTokens.toLocaleString())}`)
+  );
+  console.log(
+    import_chalk.default.yellow(
+      `\u{1F4B0} Avg context budget: ${import_chalk.default.bold(summary.avgContextBudget.toFixed(0))} tokens/file`
+    )
+  );
+  console.log(
+    import_chalk.default.white(`\u23F1  Analysis time: ${import_chalk.default.bold(elapsedTime + "s")}
+`)
+  );
+  const totalIssues = summary.criticalIssues + summary.majorIssues + summary.minorIssues;
+  if (totalIssues > 0) {
+    console.log(import_chalk.default.bold("\u26A0\uFE0F  Issues Found:\n"));
+    if (summary.criticalIssues > 0) {
+      console.log(
+        import_chalk.default.red(`   \u{1F534} Critical: ${import_chalk.default.bold(summary.criticalIssues)}`)
+      );
+    }
+    if (summary.majorIssues > 0) {
+      console.log(
+        import_chalk.default.yellow(`   \u{1F7E1} Major: ${import_chalk.default.bold(summary.majorIssues)}`)
+      );
+    }
+    if (summary.minorIssues > 0) {
+      console.log(import_chalk.default.blue(`   \u{1F535} Minor: ${import_chalk.default.bold(summary.minorIssues)}`));
+    }
+    console.log(
+      import_chalk.default.green(
+        `
+   \u{1F4A1} Potential savings: ${import_chalk.default.bold(summary.totalPotentialSavings.toLocaleString())} tokens
+`
+      )
+    );
+  } else {
+    console.log(import_chalk.default.green("\u2705 No significant issues found!\n"));
+  }
+  if (summary.deepFiles.length > 0) {
+    console.log(import_chalk.default.bold("\u{1F4CF} Deep Import Chains:\n"));
+    console.log(
+      import_chalk.default.gray(`   Average depth: ${summary.avgImportDepth.toFixed(1)}`)
+    );
+    console.log(import_chalk.default.gray(`   Maximum depth: ${summary.maxImportDepth}
+`));
+    summary.deepFiles.slice(0, 5).forEach((item) => {
+      const fileName = item.file.split("/").slice(-2).join("/");
+      console.log(
+        `   ${import_chalk.default.cyan("\u2192")} ${import_chalk.default.white(fileName)} ${import_chalk.default.dim(`(depth: ${item.depth})`)}`
+      );
+    });
+    console.log();
+  }
+  if (summary.fragmentedModules.length > 0) {
+    console.log(import_chalk.default.bold("\u{1F9E9} Fragmented Modules:\n"));
+    console.log(
+      import_chalk.default.gray(
+        `   Average fragmentation: ${(summary.avgFragmentation * 100).toFixed(0)}%
+`
+      )
+    );
+    summary.fragmentedModules.slice(0, 5).forEach((module2) => {
+      console.log(
+        `   ${import_chalk.default.yellow("\u25CF")} ${import_chalk.default.white(module2.domain)} - ${import_chalk.default.dim(`${module2.files.length} files, ${(module2.fragmentationScore * 100).toFixed(0)}% scattered`)}`
+      );
+      console.log(
+        import_chalk.default.dim(
+          `     Token cost: ${module2.totalTokens.toLocaleString()}, Cohesion: ${(module2.avgCohesion * 100).toFixed(0)}%`
+        )
+      );
+    });
+    console.log();
+  }
+  if (summary.lowCohesionFiles.length > 0) {
+    console.log(import_chalk.default.bold("\u{1F500} Low Cohesion Files:\n"));
+    console.log(
+      import_chalk.default.gray(
+        `   Average cohesion: ${(summary.avgCohesion * 100).toFixed(0)}%
+`
+      )
+    );
+    summary.lowCohesionFiles.slice(0, 5).forEach((item) => {
+      const fileName = item.file.split("/").slice(-2).join("/");
+      const scorePercent = (item.score * 100).toFixed(0);
+      const color = item.score < 0.4 ? import_chalk.default.red : import_chalk.default.yellow;
+      console.log(
+        `   ${color("\u25CB")} ${import_chalk.default.white(fileName)} ${import_chalk.default.dim(`(${scorePercent}% cohesion)`)}`
+      );
+    });
+    console.log();
+  }
+  if (summary.topExpensiveFiles.length > 0) {
+    console.log(import_chalk.default.bold("\u{1F4B8} Most Expensive Files (Context Budget):\n"));
+    summary.topExpensiveFiles.slice(0, 5).forEach((item) => {
+      const fileName = item.file.split("/").slice(-2).join("/");
+      const severityColor = item.severity === "critical" ? import_chalk.default.red : item.severity === "major" ? import_chalk.default.yellow : import_chalk.default.blue;
+      console.log(
+        `   ${severityColor("\u25CF")} ${import_chalk.default.white(fileName)} ${import_chalk.default.dim(`- ${item.contextBudget.toLocaleString()} tokens`)}`
+      );
+    });
+    console.log();
+  }
+  if (totalIssues > 0) {
+    console.log(import_chalk.default.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(import_chalk.default.cyan(`   ${index + 1}. ${fileName}`));
+      result.recommendations.slice(0, 2).forEach((rec) => {
+        console.log(import_chalk.default.dim(`      \u2022 ${rec}`));
+      });
+    });
+    console.log();
+  }
+  console.log(import_chalk.default.cyan(divider));
+  console.log(
+    import_chalk.default.dim(
+      "\n\u{1F48E} Want historical trends and refactoring plans? \u2192 aiready.dev/pro"
+    )
+  );
+  console.log(
+    import_chalk.default.dim("\u{1F4BC} Enterprise: CI/CD integration \u2192 aiready.dev/demo\n")
+  );
+}
+function generateHTMLReport(summary, results) {
+  const totalIssues = summary.criticalIssues + summary.majorIssues + summary.minorIssues;
+  return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>AIReady Context Analysis Report</title>
+  <style>
+    body {
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
+      line-height: 1.6;
+      color: #333;
+      max-width: 1200px;
+      margin: 0 auto;
+      padding: 20px;
+      background-color: #f5f5f5;
+    }
+    h1, h2, h3 { color: #2c3e50; }
+    .header {
+      background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+      color: white;
+      padding: 30px;
+      border-radius: 8px;
+      margin-bottom: 30px;
+    }
+    .summary {
+      display: grid;
+      grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
+      gap: 20px;
+      margin-bottom: 30px;
+    }
+    .card {
+      background: white;
+      padding: 20px;
+      border-radius: 8px;
+      box-shadow: 0 2px 4px rgba(0,0,0,0.1);
+    }
+    .metric {
+      font-size: 2em;
+      font-weight: bold;
+      color: #667eea;
+    }
+    .label {
+      color: #666;
+      font-size: 0.9em;
+      margin-top: 5px;
+    }
+    .issue-critical { color: #e74c3c; }
+    .issue-major { color: #f39c12; }
+    .issue-minor { color: #3498db; }
+    table {
+      width: 100%;
+      border-collapse: collapse;
+      background: white;
+      border-radius: 8px;
+      overflow: hidden;
+      box-shadow: 0 2px 4px rgba(0,0,0,0.1);
+    }
+    th, td {
+      padding: 12px;
+      text-align: left;
+      border-bottom: 1px solid #eee;
+    }
+    th {
+      background-color: #667eea;
+      color: white;
+      font-weight: 600;
+    }
+    tr:hover { background-color: #f8f9fa; }
+    .footer {
+      text-align: center;
+      margin-top: 40px;
+      padding: 20px;
+      color: #666;
+      font-size: 0.9em;
+    }
+  </style>
+</head>
+<body>
+  <div class="header">
+    <h1>\u{1F50D} AIReady Context Analysis Report</h1>
+    <p>Generated on ${(/* @__PURE__ */ new Date()).toLocaleString()}</p>
+  </div>
+
+  <div class="summary">
+    <div class="card">
+      <div class="metric">${summary.totalFiles}</div>
+      <div class="label">Files Analyzed</div>
+    </div>
+    <div class="card">
+      <div class="metric">${summary.totalTokens.toLocaleString()}</div>
+      <div class="label">Total Tokens</div>
+    </div>
+    <div class="card">
+      <div class="metric">${summary.avgContextBudget.toFixed(0)}</div>
+      <div class="label">Avg Context Budget</div>
+    </div>
+    <div class="card">
+      <div class="metric ${totalIssues > 0 ? "issue-major" : ""}">${totalIssues}</div>
+      <div class="label">Total Issues</div>
+    </div>
+  </div>
+
+  ${totalIssues > 0 ? `
+  <div class="card" style="margin-bottom: 30px;">
+    <h2>\u26A0\uFE0F Issues Summary</h2>
+    <p>
+      <span class="issue-critical">\u{1F534} Critical: ${summary.criticalIssues}</span> &nbsp;
+      <span class="issue-major">\u{1F7E1} Major: ${summary.majorIssues}</span> &nbsp;
+      <span class="issue-minor">\u{1F535} Minor: ${summary.minorIssues}</span>
+    </p>
+    <p><strong>Potential Savings:</strong> ${summary.totalPotentialSavings.toLocaleString()} tokens</p>
+  </div>
+  ` : ""}
+
+  ${summary.fragmentedModules.length > 0 ? `
+  <div class="card" style="margin-bottom: 30px;">
+    <h2>\u{1F9E9} Fragmented Modules</h2>
+    <table>
+      <thead>
+        <tr>
+          <th>Domain</th>
+          <th>Files</th>
+          <th>Fragmentation</th>
+          <th>Token Cost</th>
+        </tr>
+      </thead>
+      <tbody>
+        ${summary.fragmentedModules.map((m) => `
+          <tr>
+            <td>${m.domain}</td>
+            <td>${m.files.length}</td>
+            <td>${(m.fragmentationScore * 100).toFixed(0)}%</td>
+            <td>${m.totalTokens.toLocaleString()}</td>
+          </tr>
+        `).join("")}
+      </tbody>
+    </table>
+  </div>
+  ` : ""}
+
+  ${summary.topExpensiveFiles.length > 0 ? `
+  <div class="card" style="margin-bottom: 30px;">
+    <h2>\u{1F4B8} Most Expensive Files</h2>
+    <table>
+      <thead>
+        <tr>
+          <th>File</th>
+          <th>Context Budget</th>
+          <th>Severity</th>
+        </tr>
+      </thead>
+      <tbody>
+        ${summary.topExpensiveFiles.map((f) => `
+          <tr>
+            <td>${f.file}</td>
+            <td>${f.contextBudget.toLocaleString()} tokens</td>
+            <td class="issue-${f.severity}">${f.severity.toUpperCase()}</td>
+          </tr>
+        `).join("")}
+      </tbody>
+    </table>
+  </div>
+  ` : ""}
+
+  <div class="footer">
+    <p>Generated by <strong>@aiready/context-analyzer</strong></p>
+    <p>Want historical trends? Visit <a href="https://aiready.dev">aiready.dev</a></p>
+  </div>
+</body>
+</html>`;
+}