@aiready/context-analyzer 0.21.23 → 0.21.24

package/dist/cli.js

@@ -130,7 +130,7 @@ __export(python_context_exports, {
 });
 async function analyzePythonContext(files, rootDir) {
   const results = [];
-  const parser = (0, import_core5.getParser)("dummy.py");
+  const parser = await (0, import_core5.getParser)("dummy.py");
   if (!parser) {
     console.warn("Python parser not available");
     return results;
@@ -194,7 +194,7 @@ async function analyzePythonContext(files, rootDir) {
 }
 async function buildPythonDependencyGraph(files, rootDir) {
   const graph = /* @__PURE__ */ new Map();
-  const parser = (0, import_core5.getParser)("dummy.py");
+  const parser = await (0, import_core5.getParser)("dummy.py");
   if (!parser) return graph;
   for (const file of files) {
     try {
@@ -490,9 +490,9 @@ function inferDomain(name, filePath, domainOptions, fileImports) {
 }
 
 // src/ast-utils.ts
-function extractExportsWithAST(content, filePath, domainOptions, fileImports) {
+async function extractExportsWithAST(content, filePath, domainOptions, fileImports) {
   try {
-    const { exports: astExports } = (0, import_core.parseFileExports)(content, filePath);
+    const { exports: astExports } = await (0, import_core.parseFileExports)(content, filePath);
     if (astExports.length === 0 && !isTestFile(filePath)) {
       return extractExports(content, filePath, domainOptions, fileImports);
     }
@@ -824,16 +824,16 @@ function extractDomainKeywordsFromPaths(files) {
   }
   return Array.from(folderNames);
 }
-function buildDependencyGraph(files, options) {
+async function buildDependencyGraph(files, options) {
   const nodes = /* @__PURE__ */ new Map();
   const edges = /* @__PURE__ */ new Map();
   const autoDetectedKeywords = options?.domainKeywords ?? extractDomainKeywordsFromPaths(files);
   const allFilePaths = new Set(files.map((f) => f.file));
   for (const { file, content } of files) {
-    const { imports: astImports } = (0, import_core4.parseFileExports)(content, file);
+    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 exports2 = extractExportsWithAST(
+    const exports2 = await extractExportsWithAST(
       content,
       file,
       { domainKeywords: autoDetectedKeywords },
@@ -1511,7 +1511,7 @@ async function analyzeContext(options) {
       content: await (0, import_core6.readFileContent)(file)
     }))
   );
-  const graph = buildDependencyGraph(
+  const graph = await buildDependencyGraph(
     fileContents.filter((f) => !f.file.toLowerCase().endsWith(".py"))
   );
   let pythonResults = [];
@@ -1741,21 +1741,19 @@ function generateHTMLReport(summary, results) {
       color: totalIssues > 0 ? "#f39c12" : void 0
     }
   ]);
-  let body = `<div style="background: linear-gradient(135deg, #667eea 0%, #764ba2 100%); color: white; padding: 30px; border-radius: 8px; margin-bottom: 30px;">
-    <h1 style="border: none; color: white; margin: 0;">\u{1F50D} AIReady Context Analysis Report</h1>
-    <p style="margin: 10px 0 0 0;">Generated on ${(/* @__PURE__ */ new Date()).toLocaleString()}</p>
-  </div>
+  const hero = (0, import_core8.generateReportHero)(
+    "\u{1F50D} AIReady Context Analysis Report",
+    `Generated on ${(/* @__PURE__ */ new Date()).toLocaleString()}`
+  );
+  let body = `${hero}
 ${stats}`;
   if (totalIssues > 0) {
-    body += `<div class="card" style="margin-bottom: 30px;">
-    <h2>\u26A0\uFE0F Issues Summary</h2>
-    <p>
-      <span class="critical">\u{1F534} Critical: ${summary.criticalIssues}</span> &nbsp;
-      <span class="major">\u{1F7E1} Major: ${summary.majorIssues}</span> &nbsp;
-      <span class="minor">\u{1F535} Minor: ${summary.minorIssues}</span>
-    </p>
-    <p><strong>Potential Savings:</strong> ${summary.totalPotentialSavings.toLocaleString()} tokens</p>
-  </div>`;
+    body += (0, import_core8.generateIssueSummary)(
+      summary.criticalIssues,
+      summary.majorIssues,
+      summary.minorIssues,
+      summary.totalPotentialSavings
+    );
   }
   if (summary.fragmentedModules.length > 0) {
     const fragmentedRows = summary.fragmentedModules.map((m) => [
@@ -1764,10 +1762,13 @@ ${stats}`;
       `${(m.fragmentationScore * 100).toFixed(0)}%`,
       m.totalTokens.toLocaleString()
     ]);
-    body += `<div class="card" style="margin-bottom: 30px;">
-    <h2>\u{1F9E9} Fragmented Modules</h2>
-    ${(0, import_core8.generateTable)({ headers: ["Domain", "Files", "Fragmentation", "Token Cost"], rows: fragmentedRows })}
-  </div>`;
+    body += (0, import_core8.wrapInCard)(
+      (0, import_core8.generateTable)({
+        headers: ["Domain", "Files", "Fragmentation", "Token Cost"],
+        rows: fragmentedRows
+      }),
+      "\u{1F9E9} Fragmented Modules"
+    );
   }
   if (summary.topExpensiveFiles.length > 0) {
     const expensiveRows = summary.topExpensiveFiles.map((f) => [
@@ -1775,10 +1776,13 @@ ${stats}`;
       `${f.contextBudget.toLocaleString()} tokens`,
       `<span class="issue-${f.severity}">${f.severity.toUpperCase()}</span>`
     ]);
-    body += `<div class="card" style="margin-bottom: 30px;">
-    <h2>\u{1F4B8} Most Expensive Files</h2>
-    ${(0, import_core8.generateTable)({ headers: ["File", "Context Budget", "Severity"], rows: expensiveRows })}
-  </div>`;
+    body += (0, import_core8.wrapInCard)(
+      (0, import_core8.generateTable)({
+        headers: ["File", "Context Budget", "Severity"],
+        rows: expensiveRows
+      }),
+      "\u{1F4B8} Most Expensive Files"
+    );
   }
   const footer = (0, import_core8.generateReportFooter)({
     title: "Context Analysis Report",

package/dist/cli.mjs

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

package/dist/index.d.mts

@@ -196,7 +196,7 @@ declare function extractDomainKeywordsFromPaths(files: FileContent[]): string[];
  */
 declare function buildDependencyGraph(files: FileContent[], options?: {
     domainKeywords?: string[];
-}): DependencyGraph;
+}): Promise<DependencyGraph>;
 /**
  * Calculate the maximum depth of the import tree for a specific file.
  *

package/dist/index.d.ts

@@ -196,7 +196,7 @@ declare function extractDomainKeywordsFromPaths(files: FileContent[]): string[];
  */
 declare function buildDependencyGraph(files: FileContent[], options?: {
     domainKeywords?: string[];
-}): DependencyGraph;
+}): Promise<DependencyGraph>;
 /**
  * Calculate the maximum depth of the import tree for a specific file.
  *

package/dist/index.js

@@ -130,7 +130,7 @@ __export(python_context_exports, {
 });
 async function analyzePythonContext(files, rootDir) {
   const results = [];
-  const parser = (0, import_core5.getParser)("dummy.py");
+  const parser = await (0, import_core5.getParser)("dummy.py");
   if (!parser) {
     console.warn("Python parser not available");
     return results;
@@ -194,7 +194,7 @@ async function analyzePythonContext(files, rootDir) {
 }
 async function buildPythonDependencyGraph(files, rootDir) {
   const graph = /* @__PURE__ */ new Map();
-  const parser = (0, import_core5.getParser)("dummy.py");
+  const parser = await (0, import_core5.getParser)("dummy.py");
   if (!parser) return graph;
   for (const file of files) {
     try {
@@ -552,9 +552,9 @@ function inferDomain(name, filePath, domainOptions, fileImports) {
 }
 
 // src/ast-utils.ts
-function extractExportsWithAST(content, filePath, domainOptions, fileImports) {
+async function extractExportsWithAST(content, filePath, domainOptions, fileImports) {
   try {
-    const { exports: astExports } = (0, import_core.parseFileExports)(content, filePath);
+    const { exports: astExports } = await (0, import_core.parseFileExports)(content, filePath);
     if (astExports.length === 0 && !isTestFile(filePath)) {
       return extractExports(content, filePath, domainOptions, fileImports);
     }
@@ -952,16 +952,16 @@ function extractDomainKeywordsFromPaths(files) {
   }
   return Array.from(folderNames);
 }
-function buildDependencyGraph(files, options) {
+async function buildDependencyGraph(files, options) {
   const nodes = /* @__PURE__ */ new Map();
   const edges = /* @__PURE__ */ new Map();
   const autoDetectedKeywords = options?.domainKeywords ?? extractDomainKeywordsFromPaths(files);
   const allFilePaths = new Set(files.map((f) => f.file));
   for (const { file, content } of files) {
-    const { imports: astImports } = (0, import_core4.parseFileExports)(content, file);
+    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 exports2 = extractExportsWithAST(
+    const exports2 = await extractExportsWithAST(
       content,
       file,
       { domainKeywords: autoDetectedKeywords },
@@ -1687,7 +1687,7 @@ async function analyzeContext(options) {
       content: await (0, import_core6.readFileContent)(file)
     }))
   );
-  const graph = buildDependencyGraph(
+  const graph = await buildDependencyGraph(
     fileContents.filter((f) => !f.file.toLowerCase().endsWith(".py"))
   );
   let pythonResults = [];
@@ -2219,21 +2219,19 @@ function generateHTMLReport(summary, results) {
       color: totalIssues > 0 ? "#f39c12" : void 0
     }
   ]);
-  let body = `<div style="background: linear-gradient(135deg, #667eea 0%, #764ba2 100%); color: white; padding: 30px; border-radius: 8px; margin-bottom: 30px;">
-    <h1 style="border: none; color: white; margin: 0;">\u{1F50D} AIReady Context Analysis Report</h1>
-    <p style="margin: 10px 0 0 0;">Generated on ${(/* @__PURE__ */ new Date()).toLocaleString()}</p>
-  </div>
+  const hero = (0, import_core11.generateReportHero)(
+    "\u{1F50D} AIReady Context Analysis Report",
+    `Generated on ${(/* @__PURE__ */ new Date()).toLocaleString()}`
+  );
+  let body = `${hero}
 ${stats}`;
   if (totalIssues > 0) {
-    body += `<div class="card" style="margin-bottom: 30px;">
-    <h2>\u26A0\uFE0F Issues Summary</h2>
-    <p>
-      <span class="critical">\u{1F534} Critical: ${summary.criticalIssues}</span> &nbsp;
-      <span class="major">\u{1F7E1} Major: ${summary.majorIssues}</span> &nbsp;
-      <span class="minor">\u{1F535} Minor: ${summary.minorIssues}</span>
-    </p>
-    <p><strong>Potential Savings:</strong> ${summary.totalPotentialSavings.toLocaleString()} tokens</p>
-  </div>`;
+    body += (0, import_core11.generateIssueSummary)(
+      summary.criticalIssues,
+      summary.majorIssues,
+      summary.minorIssues,
+      summary.totalPotentialSavings
+    );
   }
   if (summary.fragmentedModules.length > 0) {
     const fragmentedRows = summary.fragmentedModules.map((m) => [
@@ -2242,10 +2240,13 @@ ${stats}`;
       `${(m.fragmentationScore * 100).toFixed(0)}%`,
       m.totalTokens.toLocaleString()
     ]);
-    body += `<div class="card" style="margin-bottom: 30px;">
-    <h2>\u{1F9E9} Fragmented Modules</h2>
-    ${(0, import_core11.generateTable)({ headers: ["Domain", "Files", "Fragmentation", "Token Cost"], rows: fragmentedRows })}
-  </div>`;
+    body += (0, import_core11.wrapInCard)(
+      (0, import_core11.generateTable)({
+        headers: ["Domain", "Files", "Fragmentation", "Token Cost"],
+        rows: fragmentedRows
+      }),
+      "\u{1F9E9} Fragmented Modules"
+    );
   }
   if (summary.topExpensiveFiles.length > 0) {
     const expensiveRows = summary.topExpensiveFiles.map((f) => [
@@ -2253,10 +2254,13 @@ ${stats}`;
       `${f.contextBudget.toLocaleString()} tokens`,
       `<span class="issue-${f.severity}">${f.severity.toUpperCase()}</span>`
     ]);
-    body += `<div class="card" style="margin-bottom: 30px;">
-    <h2>\u{1F4B8} Most Expensive Files</h2>
-    ${(0, import_core11.generateTable)({ headers: ["File", "Context Budget", "Severity"], rows: expensiveRows })}
-  </div>`;
+    body += (0, import_core11.wrapInCard)(
+      (0, import_core11.generateTable)({
+        headers: ["File", "Context Budget", "Severity"],
+        rows: expensiveRows
+      }),
+      "\u{1F4B8} Most Expensive Files"
+    );
   }
   const footer = (0, import_core11.generateReportFooter)({
     title: "Context Analysis Report",

package/dist/index.mjs

@@ -52,7 +52,7 @@ import {
   isTypeDefinition,
   isUtilityModule,
   runInteractiveSetup
-} from "./chunk-J3MUOWHC.mjs";
+} from "./chunk-Z5WY6A4P.mjs";
 import "./chunk-64U3PNO3.mjs";
 
 // src/index.ts

package/dist/python-context-BWDC4E5Z.mjs

@@ -0,0 +1,162 @@
+import {
+  calculateImportDepthFromEdges,
+  detectGraphCyclesFromFile
+} from "./chunk-64U3PNO3.mjs";
+
+// src/analyzers/python-context.ts
+import { getParser, estimateTokens } from "@aiready/core";
+import { resolve, relative, dirname, join } from "path";
+import fs from "fs";
+async function analyzePythonContext(files, rootDir) {
+  const results = [];
+  const parser = await getParser("dummy.py");
+  if (!parser) {
+    console.warn("Python parser not available");
+    return results;
+  }
+  const pythonFiles = files.filter((f) => f.toLowerCase().endsWith(".py"));
+  void relative;
+  void join;
+  const dependencyGraph = await buildPythonDependencyGraph(
+    pythonFiles,
+    rootDir
+  );
+  for (const file of pythonFiles) {
+    try {
+      const code = await fs.promises.readFile(file, "utf-8");
+      const result = parser.parse(code, file);
+      const imports = result.imports.map((imp) => ({
+        source: imp.source,
+        specifiers: imp.specifiers,
+        isRelative: imp.source.startsWith("."),
+        resolvedPath: resolvePythonImport(file, imp.source, rootDir)
+      }));
+      const exports = result.exports.map((exp) => ({
+        name: exp.name,
+        type: exp.type
+      }));
+      const linesOfCode = code.split("\n").length;
+      const importDepth = calculateImportDepthFromEdges(
+        file,
+        dependencyGraph,
+        /* @__PURE__ */ new Set()
+      );
+      const contextBudget = estimateContextBudget(
+        code,
+        imports,
+        dependencyGraph
+      );
+      const cohesion = calculatePythonCohesion(exports, imports);
+      const circularDependencies = detectGraphCyclesFromFile(
+        file,
+        dependencyGraph
+      ).map((cycle) => cycle.join(" -> "));
+      results.push({
+        file,
+        importDepth,
+        contextBudget,
+        cohesion,
+        imports,
+        exports,
+        metrics: {
+          linesOfCode,
+          importCount: imports.length,
+          exportCount: exports.length,
+          circularDependencies
+        }
+      });
+    } catch (error) {
+      console.warn(`Failed to analyze ${file}:`, error);
+    }
+  }
+  return results;
+}
+async function buildPythonDependencyGraph(files, rootDir) {
+  const graph = /* @__PURE__ */ new Map();
+  const parser = await getParser("dummy.py");
+  if (!parser) return graph;
+  for (const file of files) {
+    try {
+      const code = await fs.promises.readFile(file, "utf-8");
+      const result = parser.parse(code, file);
+      const dependencies = /* @__PURE__ */ new Set();
+      for (const imp of result.imports) {
+        const resolved = resolvePythonImport(file, imp.source, rootDir);
+        if (resolved && files.includes(resolved)) {
+          dependencies.add(resolved);
+        }
+      }
+      graph.set(file, dependencies);
+    } catch (error) {
+      void error;
+    }
+  }
+  return graph;
+}
+function resolvePythonImport(fromFile, importPath, rootDir) {
+  const dir = dirname(fromFile);
+  if (importPath.startsWith(".")) {
+    const parts = importPath.split(".");
+    let upCount = 0;
+    while (parts[0] === "") {
+      upCount++;
+      parts.shift();
+    }
+    let targetDir = dir;
+    for (let i = 0; i < upCount - 1; i++) {
+      targetDir = dirname(targetDir);
+    }
+    const modulePath = parts.join("/");
+    const possiblePaths = [
+      resolve(targetDir, `${modulePath}.py`),
+      resolve(targetDir, modulePath, "__init__.py")
+    ];
+    for (const path of possiblePaths) {
+      if (fs.existsSync(path)) {
+        return path;
+      }
+    }
+  } else {
+    const modulePath = importPath.replace(/\./g, "/");
+    const possiblePaths = [
+      resolve(rootDir, `${modulePath}.py`),
+      resolve(rootDir, modulePath, "__init__.py")
+    ];
+    for (const path of possiblePaths) {
+      if (fs.existsSync(path)) {
+        return path;
+      }
+    }
+  }
+  return void 0;
+}
+function estimateContextBudget(code, imports, dependencyGraph) {
+  void dependencyGraph;
+  let budget = estimateTokens(code);
+  const avgTokensPerDep = 500;
+  budget += imports.length * avgTokensPerDep;
+  return budget;
+}
+function calculatePythonCohesion(exports, imports) {
+  if (exports.length === 0) return 1;
+  const exportCount = exports.length;
+  const importCount = imports.length;
+  let cohesion = 1;
+  if (exportCount > 10) {
+    cohesion *= 0.6;
+  } else if (exportCount > 5) {
+    cohesion *= 0.8;
+  }
+  if (exportCount > 0) {
+    const ratio = importCount / exportCount;
+    if (ratio > 2) {
+      cohesion *= 1.1;
+    } else if (ratio < 0.5) {
+      cohesion *= 0.9;
+    }
+  }
+  return Math.min(1, Math.max(0, cohesion));
+}
+export {
+  analyzePythonContext
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiready/context-analyzer",
-  "version": "0.21.23",
+  "version": "0.21.24",
   "description": "AI context window cost analysis - detect fragmented code, deep import chains, and expensive context budgets",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -49,7 +49,7 @@
     "commander": "^14.0.0",
     "chalk": "^5.3.0",
     "prompts": "^2.4.2",
-    "@aiready/core": "0.23.20"
+    "@aiready/core": "0.23.21"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",
@@ -65,7 +65,7 @@
   "scripts": {
     "build": "tsup src/index.ts src/cli.ts --format cjs,esm --dts",
     "dev": "tsup src/index.ts src/cli.ts --format cjs,esm --dts --watch",
-    "test": "vitest run",
+    "test": "vitest run --exclude \"**/dist/**\"",
     "lint": "eslint src",
     "clean": "rm -rf dist",
     "release": "pnpm build && pnpm publish --no-git-checks"

package/src/__tests__/analyzer.test.ts

@@ -10,7 +10,7 @@ import {
 } from '../index';
 
 describe('buildDependencyGraph', () => {
-  it('should build a basic dependency graph', () => {
+  it('should build a basic dependency graph', async () => {
     const files = [
       {
         file: 'a.ts',
@@ -27,7 +27,7 @@ export const b = a + 1;
       },
     ];
 
-    const graph = buildDependencyGraph(files);
+    const graph = await buildDependencyGraph(files);
 
     expect(graph.nodes.size).toBe(2);
     expect(graph.edges.get('b.ts')?.has('a.ts')).toBe(true);
@@ -35,7 +35,7 @@ export const b = a + 1;
 });
 
 describe('calculateImportDepth', () => {
-  it('should calculate import depth correctly', () => {
+  it('should calculate import depth correctly', async () => {
     const files = [
       { file: 'a.ts', content: 'export const a = 1;' },
       {
@@ -48,14 +48,14 @@ describe('calculateImportDepth', () => {
       },
     ];
 
-    const graph = buildDependencyGraph(files);
+    const graph = await buildDependencyGraph(files);
 
     expect(calculateImportDepth('a.ts', graph)).toBe(0);
     expect(calculateImportDepth('b.ts', graph)).toBe(1);
     expect(calculateImportDepth('c.ts', graph)).toBe(2);
   });
 
-  it('should handle circular dependencies gracefully', () => {
+  it('should handle circular dependencies gracefully', async () => {
     const files = [
       {
         file: 'a.ts',
@@ -67,7 +67,7 @@ describe('calculateImportDepth', () => {
       },
     ];
 
-    const graph = buildDependencyGraph(files);
+    const graph = await buildDependencyGraph(files);
 
     // Should not infinite loop
     const depth = calculateImportDepth('a.ts', graph);
@@ -77,7 +77,7 @@ describe('calculateImportDepth', () => {
 });
 
 describe('getTransitiveDependencies', () => {
-  it('should get all transitive dependencies', () => {
+  it('should get all transitive dependencies', async () => {
     const files = [
       { file: 'a.ts', content: 'export const a = 1;' },
       {
@@ -90,7 +90,7 @@ describe('getTransitiveDependencies', () => {
       },
     ];
 
-    const graph = buildDependencyGraph(files);
+    const graph = await buildDependencyGraph(files);
     const deps = getTransitiveDependencies('c.ts', graph);
 
     expect(deps).toContain('b.ts');
@@ -100,7 +100,7 @@ describe('getTransitiveDependencies', () => {
 });
 
 describe('calculateContextBudget', () => {
-  it('should calculate total token cost including dependencies', () => {
+  it('should calculate total token cost including dependencies', async () => {
     const files = [
       { file: 'a.ts', content: 'export const a = 1;'.repeat(10) }, // ~40 tokens
       {
@@ -109,7 +109,7 @@ describe('calculateContextBudget', () => {
       }, // ~60 tokens
     ];
 
-    const graph = buildDependencyGraph(files);
+    const graph = await buildDependencyGraph(files);
     const budget = calculateContextBudget('b.ts', graph);
 
     // Should include both files' tokens
@@ -118,7 +118,7 @@ describe('calculateContextBudget', () => {
 });
 
 describe('detectCircularDependencies', () => {
-  it('should detect circular dependencies', () => {
+  it('should detect circular dependencies', async () => {
     const files = [
       {
         file: 'a.ts',
@@ -130,13 +130,13 @@ describe('detectCircularDependencies', () => {
       },
     ];
 
-    const graph = buildDependencyGraph(files);
+    const graph = await buildDependencyGraph(files);
     const cycles = detectCircularDependencies(graph);
 
     expect(cycles.length).toBeGreaterThan(0);
   });
 
-  it('should return empty for no circular dependencies', () => {
+  it('should return empty for no circular dependencies', async () => {
     const files = [
       { file: 'a.ts', content: 'export const a = 1;' },
       {
@@ -145,7 +145,7 @@ describe('detectCircularDependencies', () => {
       },
     ];
 
-    const graph = buildDependencyGraph(files);
+    const graph = await buildDependencyGraph(files);
     const cycles = detectCircularDependencies(graph);
 
     expect(cycles.length).toBe(0);