@aiready/context-analyzer 0.4.6 → 0.5.0

package/.turbo/turbo-build.log

@@ -1,6 +1,6 @@
 
 
-> @aiready/context-analyzer@0.4.6 build /Users/pengcao/projects/aiready/packages/context-analyzer
+> @aiready/context-analyzer@0.5.0 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
@@ -11,13 +11,13 @@
 ESM Build start
 CJS dist/cli.js   39.27 KB
 CJS dist/index.js 20.62 KB
-CJS ⚡️ Build success in 55ms
+CJS ⚡️ Build success in 42ms
+ESM dist/cli.mjs            18.45 KB
 ESM dist/index.mjs          164.00 B
 ESM dist/chunk-NJUW6VED.mjs 19.48 KB
-ESM dist/cli.mjs            18.45 KB
-ESM ⚡️ Build success in 55ms
+ESM ⚡️ Build success in 42ms
 DTS Build start
-DTS ⚡️ Build success in 703ms
+DTS ⚡️ Build success in 551ms
 DTS dist/cli.d.ts    20.00 B
 DTS dist/index.d.ts  2.44 KB
 DTS dist/cli.d.mts   20.00 B

package/.turbo/turbo-test.log

@@ -1,12 +1,33 @@
 
 
-> @aiready/context-analyzer@0.4.6 test /Users/pengcao/projects/aiready/packages/context-analyzer
+> @aiready/context-analyzer@0.5.0 test /Users/pengcao/projects/aiready/packages/context-analyzer
 > vitest run
 
 
  RUN  v2.1.9 /Users/pengcao/projects/aiready/packages/context-analyzer
 
- ✓ src/__tests__/analyzer.test.ts (13)
+[?25l · src/__tests__/analyzer.test.ts (13)
+   · buildDependencyGraph (1)
+     · should build a basic dependency graph
+   · calculateImportDepth (2)
+     · should calculate import depth correctly
+     · should handle circular dependencies gracefully
+   · getTransitiveDependencies (1)
+     · should get all transitive dependencies
+   · calculateContextBudget (1)
+     · should calculate total token cost including dependencies
+   · detectCircularDependencies (2)
+     · should detect circular dependencies
+     · should return empty for no circular dependencies
+   · calculateCohesion (3)
+     · should return 1 for single export
+     · should return high cohesion for related exports
+     · should return low cohesion for mixed exports
+   · calculateFragmentation (3)
+     · should return 0 for single file
+     · should return 0 for files in same directory
+     · should return high fragmentation for scattered files
+[?25l ✓ src/__tests__/analyzer.test.ts (13)
    ✓ buildDependencyGraph (1)
      ✓ should build a basic dependency graph
    ✓ calculateImportDepth (2)
@@ -30,7 +51,7 @@
 
  Test Files  1 passed (1)
       Tests  13 passed (13)
-   Start at  07:25:31
-   Duration  318ms (transform 56ms, setup 0ms, collect 64ms, tests 3ms, environment 0ms, prepare 40ms)
+   Start at  07:46:59
+   Duration  394ms (transform 66ms, setup 0ms, collect 75ms, tests 41ms, environment 0ms, prepare 42ms)
 
-[?25h
+[?25h[?25h

package/README.md

@@ -67,6 +67,9 @@ npx @aiready/context-analyzer ./src
 # Basic usage
 aiready-context ./src
 
+# Show more results in console (default: 10)
+aiready-context ./src --max-results 25
+
 # Focus on specific concerns
 aiready-context ./src --focus fragmentation
 aiready-context ./src --focus cohesion  
@@ -75,7 +78,7 @@ aiready-context ./src --focus depth
 # Set thresholds
 aiready-context ./src --max-depth 5 --max-context 10000 --min-cohesion 0.6
 
-# Export to JSON (saved to .aiready/ by default)
+# Export to JSON for full details (saved to .aiready/ by default)
 aiready-context ./src --output json
 
 # Or specify custom path
@@ -88,6 +91,8 @@ aiready-context ./src --output json --output-file custom-report.json
 
 **Smart defaults automatically adjust based on your repository size** to show ~10 most serious issues.
 
+> **💡 Tip:** By default, console output shows the top 10 results per category. Use `--max-results <number>` to see more, or use `--output json` to get complete details of all issues.
+
 ### Getting More/Fewer Results
 
 **Want to catch MORE potential issues?** (More sensitive, shows smaller problems)
@@ -132,9 +137,47 @@ aiready-context ./src --max-depth 5 --max-context 15000
 aiready-context ./src --max-depth 8 --max-context 25000 --min-cohesion 0.3
 ```
 
+## 📤 Output Options
+
+### Console Output (Default)
+
+Shows a summary with top 10 results per category:
+
+```bash
+# Default - shows top 10 items
+aiready-context ./src
+
+# Show more items (e.g., top 25)
+aiready-context ./src --max-results 25
+
+# Show all items (use a large number)
+aiready-context ./src --max-results 999
+```
+
+### JSON Output
+
+Get complete details of **all** issues (not limited to 10):
+
+```bash
+# Generate JSON with all issues
+aiready-context ./src --output json
+
+# Custom output path
+aiready-context ./src --output json --output-file reports/analysis.json
+```
+
+### HTML Report
+
+Visual report with charts and detailed breakdown:
+
+```bash
 # Generate HTML report
 aiready-context ./src --output html --output-file report.html
+```
+
+### Include/Exclude Patterns
 
+```bash
 # Include/exclude patterns
 aiready-context ./src --exclude "**/test/**,**/*.test.ts"
 ```
@@ -154,12 +197,29 @@ Create an `aiready.json` or `aiready.config.json` file in your project root:
       "maxDepth": 4,
       "maxContextBudget": 8000,
       "minCohesion": 0.7,
-      "includeNodeModules": false
+      "maxFragmentation": 0.6,
+      "focus": "all",
+      "maxResults": 10
     }
+  },
+  "output": {
+    "format": "console"
   }
 }
 ```
 
+**Configuration Options:**
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `maxDepth` | number | `5` | Max acceptable import depth |
+| `maxContextBudget` | number | `10000` | Max acceptable token budget |
+| `minCohesion` | number | `0.6` | Min acceptable cohesion score (0-1) |
+| `maxFragmentation` | number | `0.5` | Max acceptable fragmentation (0-1) |
+| `focus` | string | `'all'` | Focus: `'fragmentation'`, `'cohesion'`, `'depth'`, `'all'` |
+| `maxResults` | number | `10` | Max results per category in console |
+| `includeNodeModules` | boolean | `false` | Include node_modules in analysis |
+
 ### Sample Output
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiready/context-analyzer",
-  "version": "0.4.6",
+  "version": "0.5.0",
   "description": "AI context window cost analysis - detect fragmented code, deep import chains, and expensive context budgets",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",