@aiready/context-analyzer 0.22.6 → 0.22.8

package/.turbo/turbo-build.log

@@ -1,31 +1,32 @@
-
-> @aiready/context-analyzer@0.22.6 build /Users/pengcao/projects/aiready/packages/context-analyzer
-> tsup src/index.ts src/cli.ts --format cjs,esm --dts
-
-CLI Building entry: src/cli.ts, src/index.ts
-CLI Using tsconfig: tsconfig.json
-CLI tsup v8.5.1
-CLI Target: es2020
-CJS Build start
-ESM Build start
-CJS dist/index.js 83.32 KB
-CJS dist/cli.js   69.59 KB
-CJS ⚡️ Build success in 148ms
-ESM dist/cli-action-VCXBZGZP.mjs     2.86 KB
-ESM dist/cli.mjs                     1.81 KB
-ESM dist/python-context-BWDC4E5Z.mjs 4.48 KB
-ESM dist/chunk-M2EGQ36M.mjs          41.00 KB
-ESM dist/index.mjs                   12.64 KB
-ESM dist/chunk-J3SZQZNU.mjs          8.11 KB
-ESM dist/chunk-EMYD7NS6.mjs          4.91 KB
-ESM dist/chunk-64U3PNO3.mjs          2.65 KB
-ESM dist/summary-7PZVW72O.mjs        119.00 B
-ESM dist/orchestrator-KMAKMHTD.mjs   190.00 B
-ESM dist/chunk-BQCISA2F.mjs          3.35 KB
-ESM ⚡️ Build success in 151ms
-DTS Build start
-DTS ⚡️ Build success in 12467ms
-DTS dist/cli.d.ts    20.00 B
-DTS dist/index.d.ts  25.64 KB
-DTS dist/cli.d.mts   20.00 B
-DTS dist/index.d.mts 25.64 KB
+
+
+> @aiready/context-analyzer@0.22.8 build /Users/pengcao/projects/aiready/packages/context-analyzer
+> tsup src/index.ts src/cli.ts --format cjs,esm --dts
+
+CLI Building entry: src/cli.ts, src/index.ts
+CLI Using tsconfig: tsconfig.json
+CLI tsup v8.5.1
+CLI Target: es2020
+CJS Build start
+ESM Build start
+ESM dist/index.mjs                   12.69 KB
+ESM dist/cli.mjs                     1.81 KB
+ESM dist/python-context-BWDC4E5Z.mjs 4.48 KB
+ESM dist/orchestrator-62YVSQFV.mjs   190.00 B
+ESM dist/cli-action-HREY7TK5.mjs     2.86 KB
+ESM dist/chunk-BTDF2ZA4.mjs          3.35 KB
+ESM dist/chunk-J3SZQZNU.mjs          8.11 KB
+ESM dist/chunk-64U3PNO3.mjs          2.65 KB
+ESM dist/summary-RSPRRY6S.mjs        119.00 B
+ESM dist/chunk-JSM7Q5CY.mjs          4.98 KB
+ESM dist/chunk-ZA7HRDAH.mjs          41.00 KB
+ESM ⚡️ Build success in 180ms
+CJS dist/index.js 83.44 KB
+CJS dist/cli.js   69.65 KB
+CJS ⚡️ Build success in 180ms
+DTS Build start
+DTS ⚡️ Build success in 2332ms
+DTS dist/cli.d.ts    20.00 B
+DTS dist/index.d.ts  25.64 KB
+DTS dist/cli.d.mts   20.00 B
+DTS dist/index.d.mts 25.64 KB

package/.turbo/turbo-format-check.log

@@ -0,0 +1,7 @@
+
+
+> @aiready/context-analyzer@0.22.8 format-check /Users/pengcao/projects/aiready/packages/context-analyzer
+> prettier --check . --ignore-path ../../.prettierignore
+
+Checking formatting...
+.aireadyignoreCONTRIBUTING.mdLICENSEpackage.jsonREADME.mdsrc/__tests__/analyzer.test.tssrc/__tests__/auto-detection.test.tssrc/__tests__/boilerplate-barrel.test.tssrc/__tests__/cluster-detector.test.tssrc/__tests__/consolidation.test.tssrc/__tests__/contract.test.tssrc/__tests__/defaults.test.tssrc/__tests__/domain-inference.test.tssrc/__tests__/enhanced-cohesion.test.tssrc/__tests__/file-classification.test.tssrc/__tests__/fragmentation-advanced.test.tssrc/__tests__/fragmentation-coupling.test.tssrc/__tests__/fragmentation-log.test.tssrc/__tests__/issue-analyzer.test.tssrc/__tests__/orchestrator.test.tssrc/__tests__/provider.test.tssrc/__tests__/python-context.test.tssrc/__tests__/remediation.test.tssrc/__tests__/report/console-report.test.tssrc/__tests__/report/html-report.test.tssrc/__tests__/scoring.test.tssrc/__tests__/structural-cohesion.test.tssrc/analyzers/python-context.tssrc/ast-utils.tssrc/classifier.tssrc/classify/classification-patterns.tssrc/classify/file-classifiers.tssrc/cli-action.tssrc/cli-definition.tssrc/cli.tssrc/cluster-detector.tssrc/defaults.tssrc/graph-builder.tssrc/index.tssrc/issue-analyzer.tssrc/metrics.tssrc/orchestrator.tssrc/provider.tssrc/remediation.tssrc/report/console-report.tssrc/report/html-report.tssrc/report/interactive-setup.tssrc/scoring.tssrc/semantic/co-usage.tssrc/semantic/consolidation.tssrc/semantic/domain-inference.tssrc/semantic/type-graph.tssrc/summary.tssrc/types.tssrc/utils/dependency-graph-utils.tssrc/utils/string-utils.tstsconfig.jsontsconfig.tsbuildinfoAll matched files use Prettier code style!

package/.turbo/turbo-lint.log

@@ -1,4 +1,5 @@
-
-> @aiready/context-analyzer@0.21.24 lint /Users/pengcao/projects/aiready/packages/context-analyzer
-> eslint src
-
+
+
+> @aiready/context-analyzer@0.22.8 lint /Users/pengcao/projects/aiready/packages/context-analyzer
+> eslint src
+

package/.turbo/turbo-test.log

@@ -1,49 +1,51 @@
-
-> @aiready/context-analyzer@0.22.5 test /Users/pengcao/projects/aiready/packages/context-analyzer
-> vitest run --exclude "**/dist/**"
-
-
- RUN  v4.0.18 /Users/pengcao/projects/aiready/packages/context-analyzer
-
- ✓ src/__tests__/domain-inference.test.ts (26 tests) 29ms
- ✓ src/__tests__/report/console-report.test.ts (8 tests) 79ms
- ✓ src/__tests__/report/html-report.test.ts (11 tests) 71ms
- ✓ src/__tests__/remediation.test.ts (6 tests) 5ms
-stderr | src/__tests__/python-context.test.ts > python-context > analyzePythonContext > should filter for Python files only
-Failed to analyze src/file2.py: TypeError: Cannot read properties of undefined (reading 'split')
-    at Module.analyzePythonContext (/Users/pengcao/projects/aiready/packages/context-analyzer/src/analyzers/python-context.ts:91:32)
-    at processTicksAndRejections (node:internal/process/task_queues:104:5)
-    at /Users/pengcao/projects/aiready/packages/context-analyzer/src/__tests__/python-context.test.ts:63:23
-    at file:///Users/pengcao/projects/aiready/node_modules/.pnpm/@vitest+runner@4.0.18/node_modules/@vitest/runner/dist/index.js:915:20
-
-stderr | src/__tests__/python-context.test.ts > python-context > analyzePythonContext > should analyze Python files and return metrics
-Failed to analyze src/test.py: TypeError: Cannot read properties of undefined (reading 'split')
-    at Module.analyzePythonContext (/Users/pengcao/projects/aiready/packages/context-analyzer/src/analyzers/python-context.ts:91:32)
-    at processTicksAndRejections (node:internal/process/task_queues:104:5)
-    at /Users/pengcao/projects/aiready/packages/context-analyzer/src/__tests__/python-context.test.ts:84:23
-    at file:///Users/pengcao/projects/aiready/node_modules/.pnpm/@vitest+runner@4.0.18/node_modules/@vitest/runner/dist/index.js:915:20
-
- ✓ src/__tests__/python-context.test.ts (4 tests) 14ms
- ✓ src/__tests__/issue-analyzer.test.ts (17 tests) 104ms
- ✓ src/__tests__/provider.test.ts (2 tests) 4ms
- ✓ src/__tests__/orchestrator.test.ts (8 tests) 130ms
- ✓ src/__tests__/fragmentation-coupling.test.ts (2 tests) 14ms
- ✓ src/__tests__/analyzer.test.ts (14 tests) 30ms
- ✓ src/__tests__/file-classification.test.ts (63 tests) 58ms
- ✓ src/__tests__/auto-detection.test.ts (8 tests) 115ms
- ✓ src/__tests__/contract.test.ts (1 test) 120ms
- ✓ src/__tests__/scoring.test.ts (15 tests) 4ms
- ✓ src/__tests__/consolidation.test.ts (6 tests) 4ms
- ✓ src/__tests__/cluster-detector.test.ts (3 tests) 6ms
- ✓ src/__tests__/fragmentation-log.test.ts (3 tests) 1ms
- ✓ src/__tests__/fragmentation-advanced.test.ts (3 tests) 2ms
- ✓ src/__tests__/defaults.test.ts (7 tests) 8ms
- ✓ src/__tests__/enhanced-cohesion.test.ts (6 tests) 3ms
- ✓ src/__tests__/boilerplate-barrel.test.ts (7 tests) 4ms
- ✓ src/__tests__/structural-cohesion.test.ts (4 tests) 2ms
-
- Test Files  22 passed (22)
-      Tests  224 passed (224)
-   Start at  20:27:24
-   Duration  6.51s (transform 11.24s, setup 0ms, import 42.58s, tests 806ms, environment 30ms)
-
+
+
+> @aiready/context-analyzer@0.22.7 test /Users/pengcao/projects/aiready/packages/context-analyzer
+> vitest run --exclude "**/dist/**"
+
+[?25l
+ RUN  v4.0.18 /Users/pengcao/projects/aiready/packages/context-analyzer
+
+ ✓ src/__tests__/consolidation.test.ts (6 tests) 3ms
+ ✓ src/__tests__/report/html-report.test.ts (11 tests) 32ms
+ ✓ src/__tests__/report/console-report.test.ts (8 tests) 124ms
+ ✓ src/__tests__/domain-inference.test.ts (26 tests) 6ms
+stderr | src/__tests__/python-context.test.ts > python-context > analyzePythonContext > should filter for Python files only
+Failed to analyze src/file2.py: TypeError: Cannot read properties of undefined (reading 'split')
+    at Module.analyzePythonContext (/Users/pengcao/projects/aiready/packages/context-analyzer/src/analyzers/python-context.ts:91:32)
+    at processTicksAndRejections (node:internal/process/task_queues:104:5)
+    at /Users/pengcao/projects/aiready/packages/context-analyzer/src/__tests__/python-context.test.ts:63:23
+    at file:///Users/pengcao/projects/aiready/node_modules/.pnpm/@vitest+runner@4.0.18/node_modules/@vitest/runner/dist/index.js:915:20
+
+stderr | src/__tests__/python-context.test.ts > python-context > analyzePythonContext > should analyze Python files and return metrics
+Failed to analyze src/test.py: TypeError: Cannot read properties of undefined (reading 'split')
+    at Module.analyzePythonContext (/Users/pengcao/projects/aiready/packages/context-analyzer/src/analyzers/python-context.ts:91:32)
+    at processTicksAndRejections (node:internal/process/task_queues:104:5)
+    at /Users/pengcao/projects/aiready/packages/context-analyzer/src/__tests__/python-context.test.ts:84:23
+    at file:///Users/pengcao/projects/aiready/node_modules/.pnpm/@vitest+runner@4.0.18/node_modules/@vitest/runner/dist/index.js:915:20
+
+ ✓ src/__tests__/python-context.test.ts (4 tests) 14ms
+ ✓ src/__tests__/fragmentation-log.test.ts (3 tests) 1ms
+ ✓ src/__tests__/fragmentation-coupling.test.ts (2 tests) 42ms
+ ✓ src/__tests__/analyzer.test.ts (14 tests) 46ms
+ ✓ src/__tests__/issue-analyzer.test.ts (17 tests) 14ms
+ ✓ src/__tests__/auto-detection.test.ts (8 tests) 177ms
+ ✓ src/__tests__/orchestrator.test.ts (8 tests) 226ms
+ ✓ src/__tests__/provider.test.ts (2 tests) 10ms
+ ✓ src/__tests__/defaults.test.ts (7 tests) 3ms
+ ✓ src/__tests__/cluster-detector.test.ts (3 tests) 35ms
+ ✓ src/__tests__/file-classification.test.ts (63 tests) 12ms
+ ✓ src/__tests__/remediation.test.ts (6 tests) 2ms
+ ✓ src/__tests__/contract.test.ts (1 test) 19ms
+ ✓ src/__tests__/scoring.test.ts (15 tests) 3ms
+ ✓ src/__tests__/enhanced-cohesion.test.ts (6 tests) 2ms
+ ✓ src/__tests__/structural-cohesion.test.ts (4 tests) 39ms
+ ✓ src/__tests__/fragmentation-advanced.test.ts (3 tests) 1ms
+ ✓ src/__tests__/boilerplate-barrel.test.ts (7 tests) 3ms
+
+ Test Files  22 passed (22)
+      Tests  224 passed (224)
+   Start at  00:08:32
+   Duration  5.11s (transform 8.77s, setup 0ms, import 35.15s, tests 815ms, environment 9ms)
+
+[?25h

package/.turbo/turbo-type-check.log

@@ -0,0 +1,5 @@
+
+
+> @aiready/context-analyzer@0.22.8 type-check /Users/pengcao/projects/aiready/packages/context-analyzer
+> tsc --noEmit
+

package/CONTRIBUTING.md

@@ -13,7 +13,7 @@ The Context Analyzer measures and optimizes **context window usage** - how much
 
 ## 🐛 Reporting Issues
 
-Found a bug or have a feature request? [Open an issue](https://github.com/caopengau/aiready-context-analyzer/issues) with:
+Found a bug or have a feature request? [Open an issue](https://github.com/getaiready/aiready-context-analyzer/issues) with:
 
 - Clear description of the problem or feature
 - Sample code that demonstrates the issue

package/dist/chunk-BTDF2ZA4.mjs

@@ -0,0 +1,91 @@
+import {
+  calculatePathEntropy
+} from "./chunk-JSM7Q5CY.mjs";
+
+// src/summary.ts
+import { GLOBAL_SCAN_OPTIONS } from "@aiready/core";
+function generateSummary(results, options = {}) {
+  const config = options ? Object.fromEntries(
+    Object.entries(options).filter(
+      ([key]) => !GLOBAL_SCAN_OPTIONS.includes(key) || key === "rootDir"
+    )
+  ) : {};
+  const totalFiles = results.length;
+  const totalTokens = results.reduce((sum, r) => sum + r.tokenCost, 0);
+  const avgContextBudget = totalFiles > 0 ? results.reduce((sum, r) => sum + r.contextBudget, 0) / totalFiles : 0;
+  const deepFiles = results.filter((r) => r.importDepth > 5).map((r) => ({ file: r.file, depth: r.importDepth }));
+  const maxImportDepth = Math.max(0, ...results.map((r) => r.importDepth));
+  const moduleMap = /* @__PURE__ */ new Map();
+  results.forEach((r) => {
+    const parts = r.file.split("/");
+    let domain = "root";
+    if (parts.length > 2) {
+      domain = parts.slice(0, 2).join("/");
+    }
+    if (!moduleMap.has(domain)) moduleMap.set(domain, []);
+    moduleMap.get(domain).push(r);
+  });
+  const fragmentedModules = [];
+  moduleMap.forEach((files, domain) => {
+    const clusterTokens = files.reduce((sum, f) => sum + f.tokenCost, 0);
+    const filePaths = files.map((f) => f.file);
+    const avgEntropy = calculatePathEntropy(filePaths);
+    const fragmentationScore = Math.min(1, avgEntropy * (files.length / 10));
+    if (fragmentationScore > 0.4) {
+      fragmentedModules.push({
+        domain,
+        files: filePaths,
+        fragmentationScore,
+        totalTokens: clusterTokens,
+        avgCohesion: files.reduce((sum, f) => sum + f.cohesionScore, 0) / files.length,
+        suggestedStructure: {
+          targetFiles: Math.ceil(files.length / 2),
+          consolidationPlan: [
+            `Consolidate ${files.length} files in ${domain} into fewer modules`
+          ]
+        }
+      });
+    }
+  });
+  fragmentedModules.sort((a, b) => b.fragmentationScore - a.fragmentationScore);
+  const avgFragmentation = fragmentedModules.length > 0 ? fragmentedModules.reduce((sum, m) => sum + m.fragmentationScore, 0) / fragmentedModules.length : 0;
+  const avgCohesion = results.reduce((sum, r) => sum + r.cohesionScore, 0) / (totalFiles || 1);
+  const lowCohesionFiles = results.filter((r) => r.cohesionScore < 0.4).map((r) => ({ file: r.file, score: r.cohesionScore }));
+  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),
+    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: Math.max(0, ...results.map((r) => r.contextBudget)),
+    avgImportDepth: results.reduce((sum, r) => sum + r.importDepth, 0) / (totalFiles || 1),
+    maxImportDepth,
+    deepFiles,
+    avgFragmentation,
+    fragmentedModules,
+    avgCohesion,
+    lowCohesionFiles,
+    criticalIssues,
+    majorIssues,
+    minorIssues,
+    totalPotentialSavings,
+    topExpensiveFiles,
+    config
+  };
+}
+
+export {
+  generateSummary
+};

package/dist/chunk-JSM7Q5CY.mjs

@@ -0,0 +1,143 @@
+// src/metrics.ts
+import { calculateImportSimilarity, isTestFile } from "@aiready/core";
+function calculateEnhancedCohesion(exports, filePath, options) {
+  if (exports.length <= 1) return 1;
+  if (filePath && isTestFile(filePath)) return 1;
+  const domains = exports.map((e) => e.inferredDomain || "unknown");
+  const domainCounts = /* @__PURE__ */ new Map();
+  for (const domain of domains)
+    domainCounts.set(domain, (domainCounts.get(domain) || 0) + 1);
+  if (domainCounts.size === 1 && domains[0] !== "unknown") {
+    if (!options?.weights) return 1;
+  }
+  const probs = Array.from(domainCounts.values()).map(
+    (count) => count / exports.length
+  );
+  let domainEntropy = 0;
+  for (const prob of probs) {
+    if (prob > 0) domainEntropy -= prob * Math.log2(prob);
+  }
+  const maxEntropy = Math.log2(Math.max(2, domainCounts.size));
+  const domainScore = 1 - domainEntropy / maxEntropy;
+  let importScoreTotal = 0;
+  let pairsWithData = 0;
+  let anyImportData = false;
+  for (let i = 0; i < exports.length; i++) {
+    for (let j = i + 1; j < exports.length; j++) {
+      const exp1Imports = exports[i].imports;
+      const exp2Imports = exports[j].imports;
+      if (exp1Imports || exp2Imports) {
+        anyImportData = true;
+        const sim = calculateImportSimilarity(
+          {
+            ...exports[i],
+            imports: exp1Imports || []
+          },
+          {
+            ...exports[j],
+            imports: exp2Imports || []
+          }
+        );
+        importScoreTotal += sim;
+        pairsWithData++;
+      }
+    }
+  }
+  const avgImportScore = pairsWithData > 0 ? importScoreTotal / pairsWithData : 0;
+  let score = anyImportData ? domainScore * 0.4 + avgImportScore * 0.6 : domainScore;
+  if (anyImportData && score === 0 && domainScore === 0) {
+    score = 0.1;
+  }
+  let structuralScore = 0;
+  for (const exp of exports) {
+    if (exp.dependencies && exp.dependencies.length > 0) {
+      structuralScore += 1;
+    }
+  }
+  if (structuralScore > 0) {
+    score = Math.min(1, score + 0.1);
+  }
+  if (!options?.weights && !anyImportData && domainCounts.size === 1) return 1;
+  return score;
+}
+function calculateStructuralCohesionFromCoUsage(file, coUsageMatrix) {
+  if (!coUsageMatrix) return 1;
+  const coUsages = coUsageMatrix.get(file);
+  if (!coUsages || coUsages.size === 0) return 1;
+  let total = 0;
+  for (const count of coUsages.values()) total += count;
+  if (total === 0) return 1;
+  const probs = [];
+  for (const count of coUsages.values()) {
+    if (count > 0) probs.push(count / total);
+  }
+  if (probs.length <= 1) return 1;
+  let entropy = 0;
+  for (const prob of probs) {
+    entropy -= prob * Math.log2(prob);
+  }
+  const maxEntropy = Math.log2(probs.length);
+  return maxEntropy > 0 ? 1 - entropy / maxEntropy : 1;
+}
+function calculateFragmentation(files, domain, options) {
+  if (files.length <= 1) return 0;
+  const directories = new Set(
+    files.map((file) => file.split("/").slice(0, -1).join("/"))
+  );
+  const uniqueDirs = directories.size;
+  let score = options?.useLogScale ? uniqueDirs <= 1 ? 0 : Math.log(uniqueDirs) / Math.log(options.logBase || Math.E) / (Math.log(files.length) / Math.log(options.logBase || Math.E)) : (uniqueDirs - 1) / (files.length - 1);
+  if (options?.sharedImportRatio && options.sharedImportRatio > 0.5) {
+    const discount = (options.sharedImportRatio - 0.5) * 0.4;
+    score = score * (1 - discount);
+  }
+  return score;
+}
+function calculatePathEntropy(files) {
+  if (!files || files.length === 0) return 0;
+  const dirCounts = /* @__PURE__ */ new Map();
+  for (const file of files) {
+    const dir = file.split("/").slice(0, -1).join("/") || ".";
+    dirCounts.set(dir, (dirCounts.get(dir) || 0) + 1);
+  }
+  const counts = Array.from(dirCounts.values());
+  if (counts.length <= 1) return 0;
+  const total = counts.reduce((sum, value) => sum + value, 0);
+  let entropy = 0;
+  for (const count of counts) {
+    const prob = count / total;
+    entropy -= prob * Math.log2(prob);
+  }
+  const maxEntropy = Math.log2(counts.length);
+  return maxEntropy > 0 ? entropy / maxEntropy : 0;
+}
+function calculateDirectoryDistance(files) {
+  if (!files || files.length <= 1) return 0;
+  const pathSegments = (pathStr) => pathStr.split("/").filter(Boolean);
+  const commonAncestorDepth = (pathA, pathB) => {
+    const minLen = Math.min(pathA.length, pathB.length);
+    let i = 0;
+    while (i < minLen && pathA[i] === pathB[i]) i++;
+    return i;
+  };
+  let totalNormalized = 0;
+  let comparisons = 0;
+  for (let i = 0; i < files.length; i++) {
+    for (let j = i + 1; j < files.length; j++) {
+      const segA = pathSegments(files[i]);
+      const segB = pathSegments(files[j]);
+      const shared = commonAncestorDepth(segA, segB);
+      const maxDepth = Math.max(segA.length, segB.length);
+      totalNormalized += 1 - (maxDepth > 0 ? shared / maxDepth : 0);
+      comparisons++;
+    }
+  }
+  return comparisons > 0 ? totalNormalized / comparisons : 0;
+}
+
+export {
+  calculateEnhancedCohesion,
+  calculateStructuralCohesionFromCoUsage,
+  calculateFragmentation,
+  calculatePathEntropy,
+  calculateDirectoryDistance
+};