@aiready/context-analyzer 0.9.11 → 0.9.12

package/.turbo/turbo-build.log

@@ -1,6 +1,6 @@
 
 
-> @aiready/context-analyzer@0.9.11 build /Users/pengcao/projects/aiready/packages/context-analyzer
+> @aiready/context-analyzer@0.9.12 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,15 +11,15 @@
 ESM Build start
 ESM dist/cli.mjs                     18.53 KB
 ESM dist/index.mjs                   585.00 B
-ESM dist/chunk-BD4NWUVG.mjs          42.75 KB
 ESM dist/chunk-Y6FXYEAI.mjs          390.00 B
+ESM dist/chunk-BD4NWUVG.mjs          42.75 KB
 ESM dist/python-context-UOPTQH44.mjs 5.64 KB
-ESM ⚡️ Build success in 84ms
-CJS dist/cli.js   62.78 KB
+ESM ⚡️ Build success in 195ms
 CJS dist/index.js 51.03 KB
-CJS ⚡️ Build success in 85ms
+CJS dist/cli.js   62.78 KB
+CJS ⚡️ Build success in 226ms
 DTS Build start
-DTS ⚡️ Build success in 4202ms
+DTS ⚡️ Build success in 4457ms
 DTS dist/cli.d.ts    20.00 B
 DTS dist/index.d.ts  6.03 KB
 DTS dist/cli.d.mts   20.00 B

package/.turbo/turbo-test.log

@@ -1,31 +1,32 @@
 
 
-> @aiready/context-analyzer@0.9.11 test /Users/pengcao/projects/aiready/packages/context-analyzer
+> @aiready/context-analyzer@0.9.12 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) 3ms
- ✓ dist/__tests__/scoring.test.js (7 tests) 5ms
- ✓ dist/__tests__/auto-detection.test.js (8 tests) 117ms
- ✓ src/__tests__/fragmentation-advanced.test.ts (3 tests) 3ms
- ✓ src/__tests__/fragmentation-log.test.ts (3 tests) 18ms
- ✓ src/__tests__/fragmentation-coupling.test.ts (2 tests) 52ms
- ✓ dist/__tests__/fragmentation-advanced.test.js (3 tests) 3ms
- ✓ dist/__tests__/analyzer.test.js (14 tests) 128ms
- ✓ dist/__tests__/fragmentation-coupling.test.js (2 tests) 113ms
- ✓ src/__tests__/auto-detection.test.ts (8 tests) 220ms
- ✓ src/__tests__/analyzer.test.ts (14 tests) 252ms
+ ✓ dist/__tests__/scoring.test.js (7 tests) 4ms
+ ✓ dist/__tests__/structural-cohesion.test.js (4 tests) 9ms
+ ✓ src/__tests__/auto-detection.test.ts (8 tests) 419ms
+     ✓ should auto-detect domain keywords from folder paths  329ms
+ ✓ src/__tests__/structural-cohesion.test.ts (4 tests) 3ms
+ ✓ src/__tests__/fragmentation-coupling.test.ts (2 tests) 28ms
+ ✓ dist/__tests__/fragmentation-coupling.test.js (2 tests) 19ms
+ ✓ dist/__tests__/fragmentation-advanced.test.js (3 tests) 7ms
+ ✓ dist/__tests__/analyzer.test.js (14 tests) 315ms
+ ✓ src/__tests__/fragmentation-log.test.ts (3 tests) 8ms
+ ✓ dist/__tests__/auto-detection.test.js (8 tests) 334ms
+ ✓ src/__tests__/analyzer.test.ts (14 tests) 299ms
+ ✓ src/__tests__/scoring.test.ts (7 tests) 9ms
+ ✓ dist/__tests__/enhanced-cohesion.test.js (6 tests) 2ms
+ ✓ dist/__tests__/fragmentation-log.test.js (3 tests) 4ms
+ ✓ src/__tests__/fragmentation-advanced.test.ts (3 tests) 2ms
  ✓ src/__tests__/enhanced-cohesion.test.ts (6 tests) 2ms
- ✓ dist/__tests__/fragmentation-log.test.js (3 tests) 3ms
- ✓ dist/__tests__/structural-cohesion.test.js (4 tests) 34ms
- ✓ src/__tests__/structural-cohesion.test.ts (4 tests) 6ms
- ✓ dist/__tests__/enhanced-cohesion.test.js (6 tests) 3ms
 
  Test Files  16 passed (16)
       Tests  94 passed (94)
-   Start at  19:26:06
-   Duration  6.62s (transform 12.96s, setup 0ms, import 38.59s, tests 962ms, environment 34ms)
+   Start at  22:06:57
+   Duration  6.34s (transform 5.67s, setup 0ms, import 32.10s, tests 1.46s, environment 22ms)
 
 [?25h

package/CONTRIBUTING.md

@@ -1,10 +1,19 @@
-# Contributing to @aiready/pattern-detect
+# Contributing to @aiready/context-analyzer
 
-Thank you for your interest in contributing to AIReady Pattern Detection! We welcome bug reports, feature requests, and code contributions.
+Thank you for your interest in contributing to AIReady Context Analyzer! We welcome bug reports, feature requests, and code contributions.
+
+## 🎯 What is Context Analyzer?
+
+The Context Analyzer measures and optimizes **context window usage** - how much of your codebase an AI model must understand to work with any given file. It helps identify:
+
+- **High context cost files**: Files that require loading many dependencies
+- **Deep import chains**: Complex dependency graphs that waste tokens
+- **Low cohesion modules**: Files that import too many unrelated concerns
+- **Context fragmentation**: Places where important code is scattered
 
 ## 🐛 Reporting Issues
 
-Found a bug or have a feature request? [Open an issue](https://github.com/caopengau/aiready-pattern-detect/issues) with:
+Found a bug or have a feature request? [Open an issue](https://github.com/caopengau/aiready-context-analyzer/issues) with:
 - Clear description of the problem or feature
 - Sample code that demonstrates the issue
 - Expected vs actual behavior
@@ -14,8 +23,8 @@ Found a bug or have a feature request? [Open an issue](https://github.com/caopen
 
 ```bash
 # Clone your fork
-git clone https://github.com/YOUR_USERNAME/aiready-pattern-detect
-cd aiready-pattern-detect
+git clone https://github.com/YOUR_USERNAME/aiready-context-analyzer
+cd aiready-context-analyzer
 
 # Install dependencies
 pnpm install
@@ -34,16 +43,16 @@ pnpm test
 
 1. **Fork the repository** and create a new branch:
    ```bash
-   git checkout -b fix/similarity-calculation
+   git checkout -b fix/import-depth-calculation
    # or
-   git checkout -b feat/new-pattern-type
+   git checkout -b feat/new-metric
    ```
 
 2. **Make your changes** following our code style:
    - Use TypeScript strict mode
-   - Add tests for new pattern types
+   - Add tests for new metrics
    - Update README with new features
-   - Keep detection logic modular
+   - Keep analysis logic modular and focused
 
 3. **Test your changes**:
    ```bash
@@ -56,21 +65,21 @@ pnpm test
 
 4. **Commit using conventional commits**:
    ```bash
-   git commit -m "fix: improve similarity threshold accuracy"
-   git commit -m "feat: add React component pattern detection"
+   git commit -m "fix: accurate import depth calculation"
+   git commit -m "feat: add cohesion metric"
    ```
 
 5. **Push and open a PR**:
    ```bash
-   git push origin feat/new-pattern-type
+   git push origin feat/new-metric
    ```
 
 ## 📋 Commit Convention
 
 We use [Conventional Commits](https://www.conventionalcommits.org/):
 
-- `feat:` - New feature (new pattern type, output format)
-- `fix:` - Bug fix (detection accuracy, false positives)
+- `feat:` - New feature (new metric, output format)
+- `fix:` - Bug fix (calculation accuracy, false positives)
 - `docs:` - Documentation updates
 - `perf:` - Performance improvements
 - `refactor:` - Code restructuring
@@ -78,28 +87,67 @@ We use [Conventional Commits](https://www.conventionalcommits.org/):
 
 ## 🧪 Testing Guidelines
 
-- Add test cases in `src/__tests__/detector.test.ts`
-- Include real-world pattern examples
-- Test edge cases (empty files, single-line functions)
-- Verify output formats (console, JSON, HTML)
+- Add test cases in `src/__tests__/`
+- Include real-world code examples
+- Test edge cases (empty files, circular imports)
+- Verify output formats (console, JSON)
 
 Example test:
 ```typescript
-test('detects API handler patterns', () => {
-  const results = detectDuplicatePatterns([...]);
-  expect(results).toHaveLength(2);
-  expect(results[0].patternType).toBe('api-handler');
+test('calculates import depth correctly', () => {
+  const result = analyzeFile('src/utils/helper.ts', [...files]);
+  expect(result.contextCost).toBe(1500);
+  expect(result.importDepth).toBe(3);
 });
 ```
 
+## 🏗️ Architecture
+
+### Directory Structure
+
+```
+src/
+├── analyzer.ts           # Main orchestrator
+├── metrics/
+│   ├── contextCost.ts   # Token cost estimation
+│   ├── importDepth.ts   # Dependency depth analysis
+│   ├── cohesion.ts      # Module cohesion scoring
+│   └── fragmentation.ts # Context fragmentation detection
+├── types.ts             # Type definitions
+├── cli.ts               # CLI interface
+└── index.ts             # Public API exports
+```
+
+### Adding a New Metric
+
+1. Create `src/metrics/your-metric.ts`:
+   ```typescript
+   import type { FileAnalysis } from '../types';
+   
+   export function calculateYourMetric(file: FileAnalysis): number {
+     // Your calculation logic
+     return metricValue;
+   }
+   ```
+
+2. Update `src/types.ts` with new result types
+
+3. Integrate in `src/analyzer.ts`
+
+4. Add CLI options in `src/cli.ts`
+
+5. Export from `src/index.ts`
+
+6. Add tests in `src/__tests__/`
+
 ## 🎯 Areas for Contribution
 
 Great places to start:
-- **New pattern types**: Add detection for new code patterns
-- **Better categorization**: Improve pattern type classification
-- **Detection accuracy**: Reduce false positives/negatives
+- **New metrics**: Add new context quality measurements
+- **Better calculations**: Improve token estimation accuracy
+- **Language support**: Add analysis for more file types
 - **Performance**: Optimize for large codebases
-- **Output formats**: Add new export options
+- **Visualization**: Add output formats or reports
 - **Documentation**: Usage examples, best practices
 
 ## 🔍 Code Review
@@ -112,18 +160,18 @@ Great places to start:
 ## 📚 Documentation
 
 - Update README.md for new features
-- Add examples for new pattern types
+- Add examples for new metrics
 - Document CLI options
 - Include real-world use cases
 
 ## 💡 Feature Ideas
 
 Looking for inspiration? Consider:
-- Language-specific pattern types (Go, Rust, etc.)
-- Integration with popular linters
-- VS Code extension
-- CI/CD report generation
-- Pattern suggestion improvements
+- Language-specific context costs (TypeScript vs Python)
+- Framework-aware analysis (React hooks, Vue composables)
+- Bundle size estimation
+- Hot path analysis
+- IDE integration
 
 ## ❓ Questions?
 
@@ -131,4 +179,4 @@ Open an issue or reach out to the maintainers. We're here to help!
 
 ---
 
-**Thank you for helping make AI-generated code better!** 💙
+**Thank you for helping optimize AI context usage!** 💙

package/package.json

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