@aiready/context-analyzer 0.19.9 → 0.19.11

package/dist/index.js

@@ -37,7 +37,7 @@ __export(python_context_exports, {
 });
 async function analyzePythonContext(files, rootDir) {
   const results = [];
-  const parser = (0, import_core8.getParser)("dummy.py");
+  const parser = (0, import_core9.getParser)("dummy.py");
   if (!parser) {
     console.warn("Python parser not available");
     return results;
@@ -101,7 +101,7 @@ async function analyzePythonContext(files, rootDir) {
 }
 async function buildPythonDependencyGraph(files, rootDir) {
   const graph = /* @__PURE__ */ new Map();
-  const parser = (0, import_core8.getParser)("dummy.py");
+  const parser = (0, import_core9.getParser)("dummy.py");
   if (!parser) return graph;
   for (const file of files) {
     try {
@@ -181,7 +181,7 @@ async function calculatePythonImportDepth(file, dependencyGraph, visited, depth
 }
 function estimateContextBudget(code, imports, dependencyGraph) {
   void dependencyGraph;
-  let budget = (0, import_core8.estimateTokens)(code);
+  let budget = (0, import_core9.estimateTokens)(code);
   const avgTokensPerDep = 500;
   budget += imports.length * avgTokensPerDep;
   return budget;
@@ -231,11 +231,11 @@ function detectCircularDependencies2(file, dependencyGraph) {
   dfs(file, []);
   return [...new Set(circular)];
 }
-var import_core8, import_path, import_fs;
+var import_core9, import_path, import_fs;
 var init_python_context = __esm({
   "src/analyzers/python-context.ts"() {
     "use strict";
-    import_core8 = require("@aiready/core");
+    import_core9 = require("@aiready/core");
     import_path = require("path");
     import_fs = __toESM(require("fs"));
   }
@@ -291,7 +291,7 @@ __export(index_exports, {
   mapScoreToRating: () => mapScoreToRating
 });
 module.exports = __toCommonJS(index_exports);
-var import_core9 = require("@aiready/core");
+var import_core10 = require("@aiready/core");
 
 // src/analyzer.ts
 var import_core4 = require("@aiready/core");
@@ -1490,11 +1490,146 @@ function isBuildArtifact(filePath) {
   return lower.includes("/node_modules/") || lower.includes("/dist/") || lower.includes("/build/") || lower.includes("/out/") || lower.includes("/.next/");
 }
 
+// src/summary.ts
+var import_core5 = require("@aiready/core");
+function generateSummary(results, options) {
+  const config = options ? Object.fromEntries(
+    Object.entries(options).filter(
+      ([key]) => !import_core5.GLOBAL_SCAN_OPTIONS.includes(key) || key === "rootDir"
+    )
+  ) : void 0;
+  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: [],
+      config
+    };
+  }
+  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()) {
+    let jaccard2 = function(a, b) {
+      const s1 = new Set(a || []);
+      const s2 = new Set(b || []);
+      if (s1.size === 0 && s2.size === 0) return 0;
+      const inter = new Set([...s1].filter((x) => s2.has(x)));
+      const uni = /* @__PURE__ */ new Set([...s1, ...s2]);
+      return uni.size === 0 ? 0 : inter.size / uni.size;
+    };
+    var jaccard = jaccard2;
+    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));
+    const filePaths = files.map((f) => f.file);
+    const pathEntropy = calculatePathEntropy(filePaths);
+    const directoryDistance = calculateDirectoryDistance(filePaths);
+    let importSimTotal = 0;
+    let importPairs = 0;
+    for (let i = 0; i < files.length; i++) {
+      for (let j = i + 1; j < files.length; j++) {
+        importSimTotal += jaccard2(
+          files[i].dependencyList || [],
+          files[j].dependencyList || []
+        );
+        importPairs++;
+      }
+    }
+    const importCohesion = importPairs > 0 ? importSimTotal / importPairs : 0;
+    fragmentedModules.push({
+      domain,
+      files: files.map((f) => f.file),
+      totalTokens: totalTokens2,
+      fragmentationScore,
+      avgCohesion: avgCohesion2,
+      importCohesion,
+      pathEntropy,
+      directoryDistance,
+      suggestedStructure: {
+        targetFiles,
+        consolidationPlan: [
+          `Consolidate ${files.length} files across ${new Set(files.map((f) => f.file.split("/").slice(0, -1).join("/"))).size} directories`,
+          `Target ~${targetFiles} core modules to reduce context switching`
+        ]
+      }
+    });
+  }
+  const avgCohesion = results.reduce((sum, r) => sum + r.cohesionScore, 0) / totalFiles;
+  const lowCohesionFiles = results.filter((r) => r.cohesionScore < 0.4).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,
+    avgCohesion,
+    lowCohesionFiles,
+    criticalIssues,
+    majorIssues,
+    minorIssues,
+    totalPotentialSavings,
+    topExpensiveFiles,
+    config
+  };
+}
+
 // src/provider.ts
-var import_core6 = require("@aiready/core");
+var import_core7 = require("@aiready/core");
 
 // src/scoring.ts
-var import_core5 = require("@aiready/core");
+var import_core6 = require("@aiready/core");
 function calculateContextScore(summary, costConfig) {
   const {
     avgContextBudget,
@@ -1590,8 +1725,8 @@ function calculateContextScore(summary, costConfig) {
       priority: "high"
     });
   }
-  const cfg = { ...import_core5.DEFAULT_COST_CONFIG, ...costConfig };
-  const estimatedMonthlyCost = (0, import_core5.calculateMonthlyCost)(
+  const cfg = { ...import_core6.DEFAULT_COST_CONFIG, ...costConfig };
+  const estimatedMonthlyCost = (0, import_core6.calculateMonthlyCost)(
     avgContextBudget * (summary.totalFiles || 1),
     cfg
   );
@@ -1599,9 +1734,9 @@ function calculateContextScore(summary, costConfig) {
     ...Array(criticalIssues).fill({ severity: "critical" }),
     ...Array(majorIssues).fill({ severity: "major" })
   ];
-  const productivityImpact = (0, import_core5.calculateProductivityImpact)(issues);
+  const productivityImpact = (0, import_core6.calculateProductivityImpact)(issues);
   return {
-    toolName: import_core5.ToolName.ContextAnalyzer,
+    toolName: import_core6.ToolName.ContextAnalyzer,
     score,
     rawMetrics: {
       avgContextBudget: Math.round(avgContextBudget),
@@ -1628,16 +1763,16 @@ function mapScoreToRating(score) {
 
 // src/provider.ts
 var ContextAnalyzerProvider = {
-  id: import_core6.ToolName.ContextAnalyzer,
+  id: import_core7.ToolName.ContextAnalyzer,
   alias: ["context", "fragmentation", "budget"],
   async analyze(options) {
     const results = await analyzeContext(options);
-    const summary = generateSummary(results);
+    const summary = generateSummary(results, options);
     const normalizedResults = results.map(
       (r) => ({
         fileName: r.file,
         issues: r.issues.map((msg) => ({
-          type: import_core6.IssueType.ContextFragmentation,
+          type: import_core7.IssueType.ContextFragmentation,
           severity: r.severity,
           message: msg,
           location: { file: r.file, line: 1 },
@@ -1650,13 +1785,13 @@ var ContextAnalyzerProvider = {
         }
       })
     );
-    return import_core6.SpokeOutputSchema.parse({
+    return import_core7.SpokeOutputSchema.parse({
       results: normalizedResults,
       summary: {
         ...summary
       },
       metadata: {
-        toolName: import_core6.ToolName.ContextAnalyzer,
+        toolName: import_core7.ToolName.ContextAnalyzer,
         version: "0.17.5",
         timestamp: (/* @__PURE__ */ new Date()).toISOString()
       }
@@ -1670,9 +1805,9 @@ var ContextAnalyzerProvider = {
 };
 
 // src/defaults.ts
-var import_core7 = require("@aiready/core");
+var import_core8 = require("@aiready/core");
 async function getSmartDefaults(directory, userOptions) {
-  const files = await (0, import_core7.scanFiles)({
+  const files = await (0, import_core8.scanFiles)({
     rootDir: directory,
     include: userOptions.include,
     exclude: userOptions.exclude
@@ -1716,135 +1851,8 @@ async function getSmartDefaults(directory, userOptions) {
   };
 }
 
-// src/summary.ts
-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()) {
-    let jaccard2 = function(a, b) {
-      const s1 = new Set(a || []);
-      const s2 = new Set(b || []);
-      if (s1.size === 0 && s2.size === 0) return 0;
-      const inter = new Set([...s1].filter((x) => s2.has(x)));
-      const uni = /* @__PURE__ */ new Set([...s1, ...s2]);
-      return uni.size === 0 ? 0 : inter.size / uni.size;
-    };
-    var jaccard = jaccard2;
-    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));
-    const filePaths = files.map((f) => f.file);
-    const pathEntropy = calculatePathEntropy(filePaths);
-    const directoryDistance = calculateDirectoryDistance(filePaths);
-    let importSimTotal = 0;
-    let importPairs = 0;
-    for (let i = 0; i < files.length; i++) {
-      for (let j = i + 1; j < files.length; j++) {
-        importSimTotal += jaccard2(
-          files[i].dependencyList || [],
-          files[j].dependencyList || []
-        );
-        importPairs++;
-      }
-    }
-    const importCohesion = importPairs > 0 ? importSimTotal / importPairs : 0;
-    fragmentedModules.push({
-      domain,
-      files: files.map((f) => f.file),
-      totalTokens: totalTokens2,
-      fragmentationScore,
-      avgCohesion: avgCohesion2,
-      importCohesion,
-      pathEntropy,
-      directoryDistance,
-      suggestedStructure: {
-        targetFiles,
-        consolidationPlan: [
-          `Consolidate ${files.length} files across ${new Set(files.map((f) => f.file.split("/").slice(0, -1).join("/"))).size} directories`,
-          `Target ~${targetFiles} core modules to reduce context switching`
-        ]
-      }
-    });
-  }
-  const avgCohesion = results.reduce((sum, r) => sum + r.cohesionScore, 0) / totalFiles;
-  const lowCohesionFiles = results.filter((r) => r.cohesionScore < 0.4).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,
-    avgCohesion,
-    lowCohesionFiles,
-    criticalIssues,
-    majorIssues,
-    minorIssues,
-    totalPotentialSavings,
-    topExpensiveFiles
-  };
-}
-
 // src/index.ts
-import_core9.ToolRegistry.register(ContextAnalyzerProvider);
+import_core10.ToolRegistry.register(ContextAnalyzerProvider);
 async function analyzeContext(options) {
   const {
     maxDepth = 5,
@@ -1855,7 +1863,7 @@ async function analyzeContext(options) {
     includeNodeModules = false,
     ...scanOptions
   } = options;
-  const files = await (0, import_core9.scanFiles)({
+  const files = await (0, import_core10.scanFiles)({
     ...scanOptions,
     exclude: includeNodeModules && scanOptions.exclude ? scanOptions.exclude.filter(
       (pattern) => pattern !== "**/node_modules/**"
@@ -1865,7 +1873,7 @@ async function analyzeContext(options) {
   const fileContents = await Promise.all(
     files.map(async (file) => ({
       file,
-      content: await (0, import_core9.readFileContent)(file)
+      content: await (0, import_core10.readFileContent)(file)
     }))
   );
   const graph = buildDependencyGraph(
@@ -2020,6 +2028,7 @@ async function analyzeContext(options) {
     });
   }
   const allResults = [...results, ...pythonResults];
+  const finalSummary = generateSummary(allResults, options);
   return allResults.sort((a, b) => {
     const severityOrder = { critical: 0, major: 1, minor: 2, info: 3 };
     const severityDiff = severityOrder[a.severity] - severityOrder[b.severity];

package/dist/index.mjs

@@ -44,7 +44,7 @@ import {
   isTypeDefinition,
   isUtilityModule,
   mapScoreToRating
-} from "./chunk-Q2GDZ2FZ.mjs";
+} from "./chunk-P5YV5WIX.mjs";
 export {
   ContextAnalyzerProvider,
   adjustCohesionForClassification,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiready/context-analyzer",
-  "version": "0.19.9",
+  "version": "0.19.11",
   "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.21.9"
+    "@aiready/core": "0.21.11"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",

package/src/index.ts

@@ -244,6 +244,7 @@ export async function analyzeContext(
   }
 
   const allResults = [...results, ...pythonResults];
+  const finalSummary = generateSummary(allResults, options);
   return allResults.sort((a, b) => {
     const severityOrder = { critical: 0, major: 1, minor: 2, info: 3 };
     const severityDiff = severityOrder[a.severity] - severityOrder[b.severity];

package/src/provider.ts

@@ -22,7 +22,7 @@ export const ContextAnalyzerProvider: ToolProvider = {
 
   async analyze(options: ScanOptions): Promise<SpokeOutput> {
     const results = await analyzeContext(options as ContextAnalyzerOptions);
-    const summary = generateSummary(results);
+    const summary = generateSummary(results, options);
 
     // Normalize to SpokeOutput format
     const normalizedResults: AnalysisResult[] = results.map(

package/src/summary.ts

@@ -4,13 +4,23 @@ import type {
   ModuleCluster,
 } from './types';
 import { calculatePathEntropy, calculateDirectoryDistance } from './analyzer';
+import { GLOBAL_SCAN_OPTIONS } from '@aiready/core';
 
 /**
  * Generate summary of context analysis results
  */
 export function generateSummary(
-  results: ContextAnalysisResult[]
+  results: ContextAnalysisResult[],
+  options?: any
 ): ContextSummary {
+  const config = options
+    ? Object.fromEntries(
+        Object.entries(options).filter(
+          ([key]) => !GLOBAL_SCAN_OPTIONS.includes(key) || key === 'rootDir'
+        )
+      )
+    : undefined;
+
   if (results.length === 0) {
     return {
       totalFiles: 0,
@@ -29,6 +39,7 @@ export function generateSummary(
       minorIssues: 0,
       totalPotentialSavings: 0,
       topExpensiveFiles: [],
+      config,
     };
   }
 
@@ -164,5 +175,6 @@ export function generateSummary(
     minorIssues,
     totalPotentialSavings,
     topExpensiveFiles,
+    config,
   };
 }

package/src/types.ts

@@ -105,6 +105,7 @@ export interface ContextSummary {
     contextBudget: number;
     severity: string;
   }>;
+  config?: any;
 }
 
 export interface DependencyGraph {