@aiready/context-analyzer 0.9.22 → 0.9.25

package/.turbo/turbo-build.log

@@ -1,6 +1,6 @@
 
 
-> @aiready/context-analyzer@0.9.22 build /Users/pengcao/projects/aiready/packages/context-analyzer
+> @aiready/context-analyzer@0.9.23 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
@@ -9,18 +9,18 @@
 CLI Target: es2020
 CJS Build start
 ESM Build start
-CJS dist/cli.js   62.68 KB
-CJS dist/index.js 50.93 KB
-CJS ⚡️ Build success in 36ms
+CJS dist/index.js 55.45 KB
+CJS dist/cli.js   67.03 KB
+CJS ⚡️ Build success in 162ms
+ESM dist/cli.mjs                     18.53 KB
+ESM dist/chunk-MBE4AQP5.mjs          47.02 KB
 ESM dist/python-context-UOPTQH44.mjs 5.64 KB
-ESM dist/chunk-VTALAPQZ.mjs          42.65 KB
-ESM dist/index.mjs                   585.00 B
 ESM dist/chunk-Y6FXYEAI.mjs          390.00 B
-ESM dist/cli.mjs                     18.53 KB
-ESM ⚡️ Build success in 37ms
+ESM dist/index.mjs                   697.00 B
+ESM ⚡️ Build success in 162ms
 DTS Build start
-DTS ⚡️ Build success in 1637ms
+DTS ⚡️ Build success in 7868ms
 DTS dist/cli.d.ts    20.00 B
-DTS dist/index.d.ts  6.03 KB
+DTS dist/index.d.ts  7.37 KB
 DTS dist/cli.d.mts   20.00 B
-DTS dist/index.d.mts 6.03 KB
+DTS dist/index.d.mts 7.37 KB

package/.turbo/turbo-test.log

@@ -1,31 +1,35 @@
 
 
-> @aiready/context-analyzer@0.9.22 test /Users/pengcao/projects/aiready/packages/context-analyzer
+> @aiready/context-analyzer@0.9.23 test /Users/pengcao/projects/aiready/packages/context-analyzer
 > vitest run
 
 [?25l
  RUN  v4.0.18 /Users/pengcao/projects/aiready/packages/context-analyzer
 
- ✓ src/__tests__/scoring.test.ts (7 tests) 4ms
- ✓ dist/__tests__/scoring.test.js (7 tests) 2ms
- ✓ src/__tests__/analyzer.test.ts (14 tests) 17ms
- ✓ dist/__tests__/enhanced-cohesion.test.js (6 tests) 2ms
- ✓ dist/__tests__/fragmentation-advanced.test.js (3 tests) 14ms
- ✓ dist/__tests__/fragmentation-coupling.test.js (2 tests) 130ms
- ✓ dist/__tests__/auto-detection.test.js (8 tests) 230ms
- ✓ src/__tests__/fragmentation-coupling.test.ts (2 tests) 69ms
- ✓ src/__tests__/fragmentation-advanced.test.ts (3 tests) 4ms
- ✓ dist/__tests__/analyzer.test.js (14 tests) 191ms
- ✓ src/__tests__/structural-cohesion.test.ts (4 tests) 2ms
- ✓ src/__tests__/auto-detection.test.ts (8 tests) 30ms
- ✓ src/__tests__/enhanced-cohesion.test.ts (6 tests) 4ms
- ✓ dist/__tests__/fragmentation-log.test.js (3 tests) 3ms
+ ✓ dist/__tests__/scoring.test.js (7 tests) 27ms
+ ✓ src/__tests__/scoring.test.ts (7 tests) 11ms
+ ✓ src/__tests__/auto-detection.test.ts (8 tests) 612ms
+     ✓ should auto-detect domain keywords from folder paths  315ms
+ ✓ src/__tests__/file-classification.test.ts (17 tests) 242ms
+ ✓ src/__tests__/analyzer.test.ts (14 tests) 491ms
+     ✓ should build a basic dependency graph  379ms
+ ✓ dist/__tests__/fragmentation-coupling.test.js (2 tests) 38ms
+ ✓ src/__tests__/fragmentation-coupling.test.ts (2 tests) 271ms
+ ✓ dist/__tests__/fragmentation-log.test.js (3 tests) 6ms
+ ✓ dist/__tests__/analyzer.test.js (14 tests) 542ms
+     ✓ should calculate import depth correctly  314ms
+ ✓ dist/__tests__/auto-detection.test.js (8 tests) 536ms
+ ✓ src/__tests__/fragmentation-advanced.test.ts (3 tests) 111ms
+ ✓ dist/__tests__/enhanced-cohesion.test.js (6 tests) 24ms
  ✓ dist/__tests__/structural-cohesion.test.js (4 tests) 1ms
- ✓ src/__tests__/fragmentation-log.test.ts (3 tests) 1ms
+ ✓ src/__tests__/enhanced-cohesion.test.ts (6 tests) 31ms
+ ✓ src/__tests__/fragmentation-log.test.ts (3 tests) 4ms
+ ✓ src/__tests__/structural-cohesion.test.ts (4 tests) 240ms
+ ✓ dist/__tests__/fragmentation-advanced.test.js (3 tests) 6ms
 
- Test Files  16 passed (16)
-      Tests  94 passed (94)
-   Start at  00:46:20
-   Duration  2.34s (transform 4.67s, setup 0ms, import 14.26s, tests 706ms, environment 2ms)
+ Test Files  17 passed (17)
+      Tests  111 passed (111)
+   Start at  11:30:31
+   Duration  10.28s (transform 3.68s, setup 0ms, import 60.43s, tests 3.19s, environment 12ms)
 
 [?25h

package/README.md

@@ -290,6 +290,57 @@ These signals are included in the JSON summary (`fragmentedModules` entries) so
 
 ---
 
+### 🏷️ File Classification (Reducing False Positives)
+
+**What it measures:** The tool now classifies files into categories to distinguish real issues from acceptable patterns:
+
+| Classification | Description | Fragmentation Treatment |
+|---------------|-------------|------------------------|
+| **barrel-export** | Re-exports from other modules (index.ts) | 0% (expected behavior) |
+| **type-definition** | Primarily type/interface definitions | 0% (centralized types are good) |
+| **cohesive-module** | Single domain, high cohesion (≥70%) | 30% of original (large but focused is OK) |
+| **mixed-concerns** | Multiple domains, low cohesion | 100% (real issue) |
+| **unknown** | Doesn't fit other categories | 70% of original (benefit of doubt) |
+
+**Why it matters:** Previous versions could flag files that were actually well-designed:
+
+```typescript
+// ❌ Old behavior: Flagged as "high fragmentation (99%)"
+// shared/src/index.ts - barrel export with 6 domains
+export * from './user';
+export * from './order';
+export * from './product';
+// ... more re-exports
+
+// ✅ New behavior: Classified as "barrel-export"
+// Fragmentation score: 0% (this is what barrel files DO)
+// Recommendation: "Barrel export file detected - multiple domains are expected here"
+```
+
+```typescript
+// ❌ Old behavior: Flagged as "high fragmentation (98%)"
+// gst-calculator/client.tsx - 346 lines, 7 dependencies, 1 domain
+
+// ✅ New behavior: Classified as "cohesive-module"
+// Fragmentation score: 29% (reduced from 98%)
+// Recommendation: "Module has good cohesion despite its size"
+```
+
+**🎯 Benefit:** Focus on real issues while accepting legitimate patterns.
+
+**JSON Output includes classification:**
+
+```json
+{
+  "file": "src/index.ts",
+  "fileClassification": "barrel-export",
+  "fragmentationScore": 0,
+  "severity": "info"
+}
+```
+
+---
+
 ### ⚖️ The Tradeoff: Splitting vs. Consolidating
 
 **Important:** These metrics can pull in opposite directions!