ai-unit-test-generator 1.4.5 → 2.0.1

package/CHANGELOG.md

@@ -5,6 +5,144 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.0.0] - 2025-01-11
+
+### 🎉 Major Release: AI-Enhanced Configuration
+
+This is a **major refactor** with breaking changes. The package has been completely restructured to support AI-powered codebase analysis and intelligent scoring configuration.
+
+### 🔥 Hotfix (same day)
+- **Fixed**: AI enhancement logic now correctly applied in `scorer.mjs` scoring loop
+- **Optimized**: File-level import caching in `scanner.mjs` (30-40% performance improvement)
+- **Configurable**: Business entity keywords moved to `aiEnhancement.entityKeywords`
+- **Updated**: README reflects v2.0 architecture
+- **Added**: `matchPattern` helper function for glob pattern matching in AI suggestions
+
+### Added
+
+#### New Commands
+- **`ai-test init`**: Initialize configuration file (was implicit in `scan`)
+- **`ai-test analyze`**: AI-powered codebase analysis
+  - Automatically samples representative code from your codebase
+  - Calls Cursor Agent to analyze business logic and risk patterns
+  - Interactive review UI with category-by-category approval
+  - Generates project-specific scoring suggestions
+  - Supports score adjustment for individual suggestions
+
+#### New Modules
+- **`lib/utils/config-manager.mjs`**: Configuration file management
+- **`lib/utils/scan-manager.mjs`**: Scan result management and staleness detection
+- **`lib/ai/sampler.mjs`**: Intelligent code sampling for AI analysis
+- **`lib/ai/context-builder.mjs`**: Project context extraction (framework, deps)
+- **`lib/ai/analyzer-prompt.mjs`**: Constrained AI analysis prompt builder
+- **`lib/ai/validator.mjs`**: Strict JSON schema validation for AI responses
+- **`lib/ai/reviewer.mjs`**: Interactive suggestion review UI
+- **`lib/ai/config-writer.mjs`**: Safe configuration updates (locked paths protection)
+- **`lib/workflows/init.mjs`**: Init workflow
+- **`lib/workflows/analyze.mjs`**: AI analysis workflow
+- **`lib/workflows/scan.mjs`**: Scan workflow (extracted from CLI)
+- **`lib/workflows/generate.mjs`**: Generate workflow (extracted from CLI)
+
+#### AI Enhancement Configuration
+- Added `aiEnhancement` section to config schema
+  - `businessCriticalPaths`: AI-identified critical business logic paths
+  - `highRiskModules`: AI-identified high-risk modules  
+  - `testabilityAdjustments`: AI-suggested testability modifiers
+- Locked/writable path protection mechanism
+- AI can only write to `aiEnhancement.suggestions`
+- Core scoring rules remain immutable
+
+#### Enhanced Metadata Extraction
+- `lib/core/scanner.mjs` now extracts rich metadata:
+  - Critical imports (payment, auth, API libraries)
+  - Business entity types (Payment, Order, Booking, etc.)
+  - JSDoc documentation
+  - Error handling patterns (try-catch count)
+  - External API calls (fetch, axios)
+  - Return types and parameter types
+
+### Changed
+
+#### Breaking Changes
+- **CLI Structure**: Removed implicit config creation from `scan`, added explicit `init` command
+- **Command Workflow**: Now requires `ai-test init` before other commands
+- **Module Structure**: Reorganized `lib/` directory with clear separation:
+  - `core/`: AST, Git, Scoring
+  - `ai/`: Analysis & Test Generation
+  - `workflows/`: High-level orchestration
+  - `utils/`: Shared utilities
+  - `testing/`: Test running & analysis
+- **Config Schema**: Added `aiEnhancement` section (backward compatible)
+
+#### Improvements
+- **CLI Simplification**: `bin/cli.js` now purely delegates to workflow modules
+- **Better Error Messages**: More helpful hints when config is missing
+- **Modular Design**: Each workflow is independently importable
+- **Type Safety**: All modules use ESM with proper exports
+
+### Architecture
+
+```
+User Workflow:
+  1. ai-test init      → Create config
+  2. ai-test analyze   → AI analysis (optional)
+  3. ai-test scan      → Scan & score
+  4. ai-test generate  → Generate tests
+
+Module Hierarchy:
+  bin/cli.js
+    ↓
+  lib/workflows/     (init, analyze, scan, generate)
+    ↓
+  lib/core/         (scanner, scorer, git-analyzer)
+  lib/ai/           (sampler, validator, reviewer, etc.)
+  lib/utils/        (config-manager, scan-manager)
+```
+
+### Migration Guide
+
+For users upgrading from v1.x:
+
+1. **Config file**: Your existing `ai-test.config.jsonc` will continue to work
+2. **New workflow**:
+   ```bash
+   # Old (v1.x)
+   ai-test scan          # Would create config if missing
+   
+   # New (v2.0)
+   ai-test init          # Explicit init step
+   ai-test analyze       # Optional: Let AI optimize config
+   ai-test scan          # Scan with AI enhancements
+   ```
+3. **AI features are optional**: If you don't run `analyze`, scoring works exactly as before
+4. **Programmatic API**: Can now import workflows directly:
+   ```js
+   import { init, analyze, scan, generate } from 'ai-unit-test-generator/workflows'
+   ```
+
+### Technical Details
+
+- **AI Prompt Engineering**: Highly constrained prompts with strict JSON schema
+- **Validation**: Multi-layer validation (schema, confidence thresholds, evidence requirements)
+- **Safety**: Locked configuration paths prevent AI from modifying core scoring logic
+- **Interactive UX**: Category-by-category review with score adjustment support
+- **Token Optimization**: Intelligent code sampling (max 25 files, 1500 chars each)
+
+### Credits
+
+- Inspired by Meta's TestGen-LLM for assurance filters
+- Scoring methodology based on software testing research
+- Built on top of `ts-morph` for robust AST analysis
+
+---
+
+## [1.4.6] - 2025-01-11
+
+### Fixed
+- Fixed JSONC parsing in CLI for coverage config
+- Fixed coverage command to continue even if tests fail (partial coverage data still useful)
+- Fixed tsconfig.json to include `node_modules/@types` for Jest types
+
 ## [1.4.5] - 2025-01-11
 
 ### Fixed