@aiready/context-analyzer 0.1.0

package/dist/cli.mjs

@@ -0,0 +1,387 @@
+#!/usr/bin/env node
+import {
+  analyzeContext,
+  generateSummary
+} from "./chunk-T6ZCOPPI.mjs";
+
+// src/cli.ts
+import { Command } from "commander";
+import chalk from "chalk";
+import { writeFileSync } from "fs";
+import { join } from "path";
+var program = new 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(chalk.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) {
+        writeFileSync(
+          options.outputFile,
+          JSON.stringify(jsonOutput, null, 2)
+        );
+        console.log(
+          chalk.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 || join(process.cwd(), "context-report.html");
+      writeFileSync(outputPath, html);
+      console.log(chalk.green(`
+\u2713 HTML report saved to ${outputPath}`));
+      return;
+    }
+    displayConsoleReport(summary, results, elapsedTime);
+  } catch (error) {
+    console.error(chalk.red("\n\u274C Analysis failed:"));
+    console.error(chalk.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(chalk.cyan(divider));
+  console.log(chalk.bold.white("  CONTEXT ANALYSIS SUMMARY"));
+  console.log(chalk.cyan(divider) + "\n");
+  console.log(chalk.white(`\u{1F4C1} Files analyzed: ${chalk.bold(summary.totalFiles)}`));
+  console.log(
+    chalk.white(`\u{1F4CA} Total tokens: ${chalk.bold(summary.totalTokens.toLocaleString())}`)
+  );
+  console.log(
+    chalk.yellow(
+      `\u{1F4B0} Avg context budget: ${chalk.bold(summary.avgContextBudget.toFixed(0))} tokens/file`
+    )
+  );
+  console.log(
+    chalk.white(`\u23F1  Analysis time: ${chalk.bold(elapsedTime + "s")}
+`)
+  );
+  const totalIssues = summary.criticalIssues + summary.majorIssues + summary.minorIssues;
+  if (totalIssues > 0) {
+    console.log(chalk.bold("\u26A0\uFE0F  Issues Found:\n"));
+    if (summary.criticalIssues > 0) {
+      console.log(
+        chalk.red(`   \u{1F534} Critical: ${chalk.bold(summary.criticalIssues)}`)
+      );
+    }
+    if (summary.majorIssues > 0) {
+      console.log(
+        chalk.yellow(`   \u{1F7E1} Major: ${chalk.bold(summary.majorIssues)}`)
+      );
+    }
+    if (summary.minorIssues > 0) {
+      console.log(chalk.blue(`   \u{1F535} Minor: ${chalk.bold(summary.minorIssues)}`));
+    }
+    console.log(
+      chalk.green(
+        `
+   \u{1F4A1} Potential savings: ${chalk.bold(summary.totalPotentialSavings.toLocaleString())} tokens
+`
+      )
+    );
+  } else {
+    console.log(chalk.green("\u2705 No significant issues found!\n"));
+  }
+  if (summary.deepFiles.length > 0) {
+    console.log(chalk.bold("\u{1F4CF} Deep Import Chains:\n"));
+    console.log(
+      chalk.gray(`   Average depth: ${summary.avgImportDepth.toFixed(1)}`)
+    );
+    console.log(chalk.gray(`   Maximum depth: ${summary.maxImportDepth}
+`));
+    summary.deepFiles.slice(0, 5).forEach((item) => {
+      const fileName = item.file.split("/").slice(-2).join("/");
+      console.log(
+        `   ${chalk.cyan("\u2192")} ${chalk.white(fileName)} ${chalk.dim(`(depth: ${item.depth})`)}`
+      );
+    });
+    console.log();
+  }
+  if (summary.fragmentedModules.length > 0) {
+    console.log(chalk.bold("\u{1F9E9} Fragmented Modules:\n"));
+    console.log(
+      chalk.gray(
+        `   Average fragmentation: ${(summary.avgFragmentation * 100).toFixed(0)}%
+`
+      )
+    );
+    summary.fragmentedModules.slice(0, 5).forEach((module) => {
+      console.log(
+        `   ${chalk.yellow("\u25CF")} ${chalk.white(module.domain)} - ${chalk.dim(`${module.files.length} files, ${(module.fragmentationScore * 100).toFixed(0)}% scattered`)}`
+      );
+      console.log(
+        chalk.dim(
+          `     Token cost: ${module.totalTokens.toLocaleString()}, Cohesion: ${(module.avgCohesion * 100).toFixed(0)}%`
+        )
+      );
+    });
+    console.log();
+  }
+  if (summary.lowCohesionFiles.length > 0) {
+    console.log(chalk.bold("\u{1F500} Low Cohesion Files:\n"));
+    console.log(
+      chalk.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 ? chalk.red : chalk.yellow;
+      console.log(
+        `   ${color("\u25CB")} ${chalk.white(fileName)} ${chalk.dim(`(${scorePercent}% cohesion)`)}`
+      );
+    });
+    console.log();
+  }
+  if (summary.topExpensiveFiles.length > 0) {
+    console.log(chalk.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" ? 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\u{1F48E} Want historical trends and refactoring plans? \u2192 aiready.dev/pro"
+    )
+  );
+  console.log(
+    chalk.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>`;
+}

package/dist/index.d.mts

@@ -0,0 +1,79 @@
+import { ScanOptions } from '@aiready/core';
+
+interface ContextAnalyzerOptions extends ScanOptions {
+    maxDepth?: number;
+    maxContextBudget?: number;
+    minCohesion?: number;
+    maxFragmentation?: number;
+    focus?: 'fragmentation' | 'cohesion' | 'depth' | 'all';
+    includeNodeModules?: boolean;
+}
+interface ContextAnalysisResult {
+    file: string;
+    tokenCost: number;
+    linesOfCode: number;
+    importDepth: number;
+    dependencyCount: number;
+    dependencyList: string[];
+    circularDeps: string[][];
+    cohesionScore: number;
+    domains: string[];
+    exportCount: number;
+    contextBudget: number;
+    fragmentationScore: number;
+    relatedFiles: string[];
+    severity: 'critical' | 'major' | 'minor' | 'info';
+    issues: string[];
+    recommendations: string[];
+    potentialSavings: number;
+}
+interface ModuleCluster {
+    domain: string;
+    files: string[];
+    totalTokens: number;
+    fragmentationScore: number;
+    avgCohesion: number;
+    suggestedStructure: {
+        targetFiles: number;
+        consolidationPlan: string[];
+    };
+}
+interface ContextSummary {
+    totalFiles: number;
+    totalTokens: number;
+    avgContextBudget: number;
+    maxContextBudget: number;
+    avgImportDepth: number;
+    maxImportDepth: number;
+    deepFiles: Array<{
+        file: string;
+        depth: number;
+    }>;
+    avgFragmentation: number;
+    fragmentedModules: ModuleCluster[];
+    avgCohesion: number;
+    lowCohesionFiles: Array<{
+        file: string;
+        score: number;
+    }>;
+    criticalIssues: number;
+    majorIssues: number;
+    minorIssues: number;
+    totalPotentialSavings: number;
+    topExpensiveFiles: Array<{
+        file: string;
+        contextBudget: number;
+        severity: string;
+    }>;
+}
+
+/**
+ * Analyze AI context window cost for a codebase
+ */
+declare function analyzeContext(options: ContextAnalyzerOptions): Promise<ContextAnalysisResult[]>;
+/**
+ * Generate summary of context analysis results
+ */
+declare function generateSummary(results: ContextAnalysisResult[]): ContextSummary;
+
+export { type ContextAnalysisResult, type ContextAnalyzerOptions, type ContextSummary, type ModuleCluster, analyzeContext, generateSummary };

package/dist/index.d.ts

@@ -0,0 +1,79 @@
+import { ScanOptions } from '@aiready/core';
+
+interface ContextAnalyzerOptions extends ScanOptions {
+    maxDepth?: number;
+    maxContextBudget?: number;
+    minCohesion?: number;
+    maxFragmentation?: number;
+    focus?: 'fragmentation' | 'cohesion' | 'depth' | 'all';
+    includeNodeModules?: boolean;
+}
+interface ContextAnalysisResult {
+    file: string;
+    tokenCost: number;
+    linesOfCode: number;
+    importDepth: number;
+    dependencyCount: number;
+    dependencyList: string[];
+    circularDeps: string[][];
+    cohesionScore: number;
+    domains: string[];
+    exportCount: number;
+    contextBudget: number;
+    fragmentationScore: number;
+    relatedFiles: string[];
+    severity: 'critical' | 'major' | 'minor' | 'info';
+    issues: string[];
+    recommendations: string[];
+    potentialSavings: number;
+}
+interface ModuleCluster {
+    domain: string;
+    files: string[];
+    totalTokens: number;
+    fragmentationScore: number;
+    avgCohesion: number;
+    suggestedStructure: {
+        targetFiles: number;
+        consolidationPlan: string[];
+    };
+}
+interface ContextSummary {
+    totalFiles: number;
+    totalTokens: number;
+    avgContextBudget: number;
+    maxContextBudget: number;
+    avgImportDepth: number;
+    maxImportDepth: number;
+    deepFiles: Array<{
+        file: string;
+        depth: number;
+    }>;
+    avgFragmentation: number;
+    fragmentedModules: ModuleCluster[];
+    avgCohesion: number;
+    lowCohesionFiles: Array<{
+        file: string;
+        score: number;
+    }>;
+    criticalIssues: number;
+    majorIssues: number;
+    minorIssues: number;
+    totalPotentialSavings: number;
+    topExpensiveFiles: Array<{
+        file: string;
+        contextBudget: number;
+        severity: string;
+    }>;
+}
+
+/**
+ * Analyze AI context window cost for a codebase
+ */
+declare function analyzeContext(options: ContextAnalyzerOptions): Promise<ContextAnalysisResult[]>;
+/**
+ * Generate summary of context analysis results
+ */
+declare function generateSummary(results: ContextAnalysisResult[]): ContextSummary;
+
+export { type ContextAnalysisResult, type ContextAnalyzerOptions, type ContextSummary, type ModuleCluster, analyzeContext, generateSummary };