@entro314labs/ai-changelog-generator 3.0.5 → 3.2.0

package/CHANGELOG.md

@@ -5,796 +5,394 @@ 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).
 
-## [3.0.3]
-
-### 🔧 **Maintenance & Bug Fixes**
-
-**Key Changes:**
-- Fixed intermittent "No working directory changes detected" issue caused by similar function mixups
-- Enhanced CLI output formatting with professional visual styling
-- Resolved Azure OpenAI provider token counting issues
-- Improved error handling and fallback logic throughout the system
-- Added comprehensive JSDoc documentation for better code maintainability
-
-**Technical Improvements:**
-- ✅ Fixed working directory change detection reliability
-- ✅ Enhanced token usage tracking for Azure provider
-- ✅ Improved CLI visual formatting with boxed metrics and color-coded outputs
-- ✅ Standardized error messaging and provider warnings
-- ✅ Added robust fallback handling for AI analysis failures
-- ✅ Cleaned up debug output and improved user experience
-
-**Breaking Changes:** None - this is a maintenance release
-
-**Commits:**
-- (refactor) Enhanced WorkspaceChangelogService with diff analysis and comprehensive cleanup
-- (fix) Resolved Azure provider token counting and working directory detection issues
-- (docs) Added JSDoc comments and improved code documentation
-- (chore) Updated organization references and package metadata
-
----
-
-## [Unreleased]
-
-### 📋 Release Summary
-Release latest includes 2 commits (1 docs, 1 feature). Complexity: high. Affected areas: configuration, documentation, other, source, build.
-
-**Business Impact**: minor
-**Complexity**: high
-
-### Added
-- Complete codebase and project structure for VibeKit VDK CLI
-- 189 new files totaling 40,860 lines including CLI source code (cli.js)
-- Installation and release scripts (install.sh, release.sh)
-- Comprehensive documentation (README.md, GUIDE.md, ROADMAP.md, VDK_OVERVIEW.md, CONTRIBUTING.md)
-- GitHub workflow and templates
-- JavaScript CLI entry point with dotenv, commander support
-- Package.json with bin entry for 'vdk' command
-
-### Changed
-- Updated repository references from 'idominikosgr' to 'entro314-labs' across 154 files
-- Added new documentation files: VDK_AI_ASSISTANT_COMPATIBILITY_REPORT.md, VDK_DOCUMENTATION.md
-- Updated installation instructions, badges, and URLs to new organization
-- Minor dependency version bump for 'dotenv' in pnpm-lock.yaml
-- Updated code comments and API URLs in JavaScript source files
-
-### Removed
-- Large 'GUIDE.md' file (net reduction of over 20,000 lines)
-
----
-
-## [Unreleased]
-
-### 📋 Release Summary
-Release includes 4 new features, 1 bug fix, extensive refactoring
-
-**Business Impact**: major
-**Complexity**: high
-**Deployment Requirements**: Database migration required
-
-### 🚀 Features
-
-#### CLI Reliability Improvements
-- Fixed infinite loop issues in CLI interactions
-- Removed conflicting readline interface
-- Added detection for non-interactive environments
-- Enhanced error handling for automated/scripted use cases
-
-#### Template and Setup Standardization
-- Refactored handlebar templates for consistency
-- Updated references from 'VibeCodingRules' to 'Vibe-Coding-Rules'
-- Introduced interactive setup wizard (setup-wizard.js)
-- Improved project configuration experience
-
-#### Project Planning and Documentation
-- Added detailed ROADMAP.md outlining future development goals
-- Updated README to reference roadmap
-- Enhanced core agent documentation rules for clarity
-
-#### Project Rebranding
-- Renamed project from DevRulesPlus to CodePilotRules
-- Updated all documentation, scripts, and setup files
-- Maintained consistency across codebase
-
-### 🐛 Bug Fixes
-- Fixed execution order in installation script
-- Ensured dependencies install before CLI execution
-- Improved script reliability and error prevention
-
-### ♻️ Code Refactoring
-
-#### Documentation and Repository Cleanup
-- Updated .gitignore to exclude additional documentation files
-- Streamlined documentation with obsolete scripts removed
-- Improved user guides for clarity and accuracy
-- Standardized repository references across project files
-
-#### Major Architectural Changes
-- **BREAKING CHANGE**: Comprehensive refactor affecting 208 files
-- Reduced codebase size and complexity (+2820/-12538 lines)
-- Database schema and configuration updates
-- Introduced new roadmap and publishing workflow
-
-#### Branding Evolution
-- Complete rebranding from 'Vibe Coding Rules' to 'VibeKit VDK CLI'
-- Updated environment variables, configuration, and project metadata
-- Added new documentation (CLI Reference, Getting Started)
-
-#### Rule System Enhancements
-- Extensive reorganization of configuration and rule files
-- Added installation and sync system documentation
-- Updated setup wizard and package scripts
-- Comprehensive 'Vibe Coding Rules' for AI assistant standardization
-
-#### Initial Foundation
-- **BREAKING CHANGE**: Initial project setup with 109 files, 19,000 lines
-- Core agent instructions and project context templates
-- Language-specific best practices (TypeScript, Python, Swift, Kotlin, C++)
-- AI assistant integrations (Cursor, Copilot, Windsurf)
-- Model Context Protocol (MCP) servers configuration
-
-### ⚠️ Migration Requirements
-- Review database schema changes before deployment
-- Update environment variables to new naming conventions
-- Follow new INSTALLATION.md and SYNC-SYSTEM.md guides
-- Update CI/CD pipelines referencing old project names
-- Full regression testing recommended due to scope of changes
-
-### 🎯 Affected Areas
-- Database, configuration, documentation, source code, assets, scripts
-
----
-
-## [3.0.0]
-
-### 🚀 **Major Release: Universal AI Provider Ecosystem**
-
-This major release transforms the tool into a universal AI changelog generator supporting 10+ AI providers with the latest 2025 models, enhanced architecture, and production-ready reliability.
-
-#### ✨ **New AI Provider Support**
-
-**Complete Provider Ecosystem (10+ providers)**
-- ✨ **NEW**: Anthropic Claude integration with Sonnet 4 and Opus 4 (2025 latest models)
-- ✨ **NEW**: Google AI (Gemini) with 2.5 Pro/Flash and thinking mode support
-- ✨ **NEW**: Google Vertex AI with enterprise features and custom endpoints
-- ✨ **NEW**: Hugging Face multi-provider routing (Replicate, Together, SambaNova, Fal)
-- ✨ **NEW**: Ollama local model support (Llama, Mistral, CodeLlama, custom models)
-- ✨ **NEW**: LM Studio local deployment with OpenAI-compatible API
-- ✨ **ENHANCED**: OpenAI with GPT-4.1 series and o1 reasoning models
-- ✨ **ENHANCED**: Azure OpenAI with exclusive o3/o4 models and v1 API support
-
-**Latest 2025 Model Support**
-- **OpenAI**: GPT-4.1 (nano, mini, standard), o1 reasoning models
-- **Azure**: GPT-4.1 series + exclusive o3/o4 reasoning models
-- **Anthropic**: Claude Sonnet 4, Claude Opus 4 (latest 2025 releases)
-- **Google**: Gemini 2.5 Pro/Flash with multimodal and thinking capabilities
-- **Hugging Face**: Qwen 2.5, Llama 3.3, Mixtral, 200k+ models via routing
-- **Local**: Any Ollama or LM Studio compatible model
-
-#### 🏗️ **Architecture Transformation**
-
-**Plugin-Based Provider System**
-- ✨ **NEW**: Universal base provider interface with consistent capabilities
-- ✨ **NEW**: Automatic provider detection and smart selection
-- ✨ **NEW**: Graceful fallback chain with priority ordering
-- ✨ **NEW**: Provider-specific model recommendations and optimization
-- ✨ **NEW**: Unified error handling and recovery across all providers
-
-**Enhanced Configuration System**
-- ✨ **NEW**: Zero-configuration auto-detection of available providers
-- ✨ **NEW**: Flexible provider priority ordering
-- ✨ **NEW**: Environment-based configuration for all providers
-- ✨ **NEW**: Comprehensive validation and testing tools
-
-#### 🔧 **Production Enhancements**
-
-**Reliability & Error Handling**
-- ✨ **IMPROVED**: Robust error handling with provider-specific recovery
-- ✨ **IMPROVED**: Connection testing and validation for all providers
-- ✨ **IMPROVED**: Model availability checking with alternatives
-- ✨ **NEW**: Comprehensive diagnostic and troubleshooting tools
-
-**Performance Optimization**
-- ✨ **NEW**: Local model support eliminates API costs and latency
-- ✨ **NEW**: Smart model selection optimizes cost and performance
-- ✨ **NEW**: Multi-provider routing for best price/performance ratio
-- ✨ **NEW**: Automatic fallback to rule-based analysis when needed
-
-#### 🔄 **Enhanced MCP Integration**
-
-**Extended MCP Tools**
-- ✨ **NEW**: `switch_provider` tool for dynamic provider switching
-- ✨ **NEW**: `list_providers` tool for provider status and capabilities
-- ✨ **NEW**: Enhanced `configure_ai_provider` with multi-provider support
-- ✨ **NEW**: `validate_models` tool with comprehensive capability checking
-- ✨ **ENHANCED**: All existing tools now support provider selection
-
-**Provider Management**
-- ✨ **NEW**: Real-time provider switching in MCP sessions
-- ✨ **NEW**: Provider capability reporting and model validation
-- ✨ **NEW**: Comprehensive provider status and health monitoring
-- ✨ **NEW**: Dynamic model selection based on commit complexity
-
-#### 🛠️ **Developer Experience**
-
-**Enhanced CLI Interface**
-- ✨ **NEW**: Provider validation and status commands
-- ✨ **NEW**: Model override with capability validation
-- ✨ **NEW**: Comprehensive provider testing and diagnostics
-- ✨ **IMPROVED**: Better error messages with actionable suggestions
-
-**Advanced Features**
-- ✨ **NEW**: Provider-aware model recommendations
-- ✨ **NEW**: Cost optimization through provider selection
-- ✨ **NEW**: Privacy-first local model options
-- ✨ **NEW**: Enterprise-ready multi-provider deployments
-
-#### 📦 **Updated Dependencies**
-
-- **Added**: `@anthropic-ai/sdk@0.56.0` (Claude Sonnet 4 support)
-- **Added**: `@google/genai@1.10.0` (Gemini 2.5 series)
-- **Added**: `@huggingface/inference@4.5.3` (Multi-provider routing)
-- **Added**: `ollama@0.5.16` (Local model support)
-- **Added**: `@lmstudio/sdk@1.3.0` (LM Studio integration)
-- **Updated**: `@modelcontextprotocol/sdk@1.16.0` (Latest MCP features)
-- **Updated**: `openai@5.10.1` (GPT-4.1 and o1 support)
-- **Updated**: Node.js requirement to 22+ for latest features
-
-#### 🔄 **Migration Guide**
-
-**From v2.x to v3.0.0**
-- **Configuration**: Existing OpenAI/Azure configs continue to work unchanged
-- **New Providers**: Add API keys for new providers you want to use
-- **MCP Integration**: New tools available, existing tools enhanced
-- **CLI Interface**: All existing commands work identically
-
-**Recommended Migration Steps**
-1. Update to Node.js 22+ if needed
-2. Install v3.0.0: `npm install -g ai-changelog-generator@3.0.0`
-3. Test existing configuration: `ai-changelog --validate`
-4. Optionally add new provider API keys for expanded capabilities
-5. Explore new providers: `ai-changelog configure`
-
-#### 📊 **Impact**
-
-- **10x Provider Support**: From 2 to 10+ AI providers
-- **Latest Models**: Support for all 2025 flagship models
-- **Zero Config**: Works out of the box with any available provider
-- **Cost Optimization**: Local models and smart selection reduce costs
-- **Enterprise Ready**: Multi-provider support for diverse requirements
-
-#### 🎯 **Breaking Changes**
-
-- **Node.js Requirement**: Now requires Node.js 22+ (was 18+)
-- **Provider Interface**: Internal provider API changed (affects custom providers only)
-- **No User Impact**: All CLI commands and MCP tools work identically
-
----
-
-## [2.5.1]
-
-### 🚀 **Point Release: Enhanced User Experience & Error Handling**
-
-This point release significantly improves the tool's reliability and user experience with cleaner output, better error handling, and enhanced repository insights.
-
-#### 🛠️ **Improvements**
-
-**Enhanced Error Handling & User Experience**
-- 🐛 **IMPROVED**: Git error messages now display clean, user-friendly warnings instead of raw technical output
-- 🐛 **IMPROVED**: Suppressed stderr output from git commands to eliminate noise
-- 🐛 **IMPROVED**: Model availability errors show simplified messages with session-based deduplication
-- ✨ **NEW**: Added `execGitShow()` method for safer git operations with missing files
-- ✨ **NEW**: Graceful handling of deleted/renamed files with contextual messaging
-
-**Repository Health Enhancements**
-- ✨ **NEW**: Added `--health` CLI flag for comprehensive repository health assessment
-- ✨ **NEW**: Added `assess_repository_health` MCP tool for AI assistants
-- ✨ **NEW**: 8-point commit message quality scoring system with real-time feedback
-- ✨ **NEW**: Repository hygiene recommendations and actionable insights
-- ✨ **NEW**: Health scoring (0-100) with categorization: Poor/Fair/Good/Excellent
-
-**Developer Experience**
-- ✨ **IMPROVED**: Cleaner console output with reduced error spam
-- ✨ **IMPROVED**: Better fallback messaging for model selection
-- ✨ **IMPROVED**: More informative warnings with actionable suggestions
-- ✨ **IMPROVED**: Enhanced rule-based analysis reliability without AI providers
-
-#### 🔧 **Technical Enhancements**
-
-- **Error Recovery**: Robust handling of git edge cases and command failures
-- **Output Sanitization**: Clean error messages without technical implementation details
-- **Session Management**: Deduplicated warnings to prevent console spam
-- **Graceful Degradation**: Better fallback behavior when operations fail
-
-#### 📊 **Impact**
-
-- **No Breaking Changes**: Full backward compatibility maintained
-- **Improved Reliability**: Prevents crashes from git edge cases
-- **Better UX**: Professional, clean output suitable for all skill levels
-- **Enhanced Insights**: Repository health provides actionable development guidance
-
-#### 🆙 **Migration Notes**
-
-- No migration required - all improvements are additive
-- New `--health` flag available for CLI users
-- MCP users gain access to `assess_repository_health` tool
-- All existing functionality works identically
-
----
-
-## [2.5.0]
-
-### 🆕 Major Improvements
-
-**Repository Health Assessment & Commit Quality Analysis**
-- ✨ **NEW**: Added comprehensive repository health assessment with `--health` CLI flag and `assess_repository_health` MCP tool
-- ✨ **NEW**: Real-time commit message quality detection and scoring (8-point scale)
-- ✨ **NEW**: Automatic warnings for poor commit messages with actionable suggestions
-- ✨ **NEW**: Repository hygiene metrics including working directory status, commit frequency, and code diversity
-
-**Enhanced Error Handling & Resilience**
-- 🐛 **FIXED**: Graceful handling of missing files in git history (no more crashes on deleted/moved files)
-- 🐛 **FIXED**: Improved error recovery for git command failures
-- 🐛 **FIXED**: Better fallback analysis when git operations fail
-- ✨ **NEW**: Comprehensive warnings and recovery suggestions
-
-**Rule-Based Analysis Improvements**
-- ✨ **NEW**: Enhanced rule-based analysis that works without AI providers
-- ✨ **NEW**: Commit message quality warnings integrated into changelog output
-- ✨ **NEW**: Repository health recommendations in generated output
-- ✨ **NEW**: Better fallback behavior when AI analysis fails
-
-**MCP Server Enhancements**
-- ✨ **NEW**: Added `assess_repository_health` MCP tool for comprehensive health analysis
-- ✨ **NEW**: Repository health metrics accessible via MCP for AI assistants
-- ✨ **NEW**: Standardized JSON output format for health assessments
-- ✨ **NEW**: Configurable analysis depth and recommendations
-
-**Developer Experience**
-- ✨ **NEW**: Clearer CLI help text with health assessment options
-- ✨ **NEW**: Color-coded health scores and recommendations
-- ✨ **NEW**: Proactive suggestions for repository hygiene improvements
-- ✨ **NEW**: Better user guidance for poor commit message patterns
-
-### 🔧 Technical Enhancements
-
-- **Commit Message Analysis**: 8-point scoring system evaluating length, descriptiveness, conventional format compliance, and informational value
-- **Repository Health Metrics**: Comprehensive scoring including commit quality, working directory status, activity patterns, and code diversity
-- **Error Recovery**: Robust handling of git edge cases, deleted files, and command failures
-- **Fallback Analysis**: Improved rule-based analysis that provides value even without AI providers
-- **Attribution Updates**: Corrected repository references to match current GitHub location
-
-### 📊 Impact
-
-This release significantly improves the tool's reliability and usefulness by:
-- **Preventing crashes** from git edge cases and missing files
-- **Providing actionable insights** about repository health and commit quality
-- **Working reliably** even without AI provider configuration
-- **Offering proactive guidance** for better development practices
-
-### 🆙 Migration Notes
-
-- No breaking changes in this release
-- New `--health` flag available for CLI users
-- MCP users gain access to new `assess_repository_health` tool
-- All existing functionality remains unchanged
-
----
-
-## [2.4.0]
-
-### Added
-- **Complete MCP Server Feature Parity**: Achieved 100% feature parity between CLI and MCP server
-  - New `generate_changelog_from_changes` MCP tool for working directory changelog generation
-  - Equivalent to CLI's `--analyze` functionality with full AI-powered changelog creation
-  - Supports all analysis modes (standard, detailed, enterprise) and model overrides
-- **File Writing Behavior**: MCP tools now write `AI_CHANGELOG.md` files to project root
-  - Both `generate_changelog` and `generate_changelog_from_changes` create persistent files
-  - Ensures consistent behavior and proper attribution preservation
-  - Prevents chat AI from modifying or stripping attribution from official output
-- **Enhanced Attribution Support**: Fixed missing `includeAttribution` parameter in MCP tools
-  - Added `includeAttribution` parameter to `analyze_current_changes` MCP tool schema
-  - All MCP tools now support attribution control with proper defaults
-  - Maintains promotional attribution while providing opt-out option
-
-### Changed
-- **MCP Tool Documentation**: Updated README with comprehensive MCP tool reference
-  - Clarified distinction between analysis tools and changelog generation tools
-  - Added file writing behavior documentation and feature parity notes
-  - Updated examples to demonstrate working directory changelog generation
-- **Tool Schema Enhancement**: Extended MCP tool schemas with missing parameters
-  - More consistent parameter handling across all MCP tools
-  - Better validation and documentation for tool parameters
-
-### Fixed
-- **Attribution Consistency**: Resolved discrepancy between CLI and MCP attribution behavior
-  - MCP tools now include attribution footer by default, matching CLI behavior
-  - Fixed missing attribution in working directory analysis workflows
-- **Feature Gap**: Eliminated functionality differences between CLI and MCP interfaces
-  - MCP server can now generate changelogs from working directory changes
-  - No more reliance on chat AI interpretation of analysis data
-
-### Technical Implementation
-- **New MCP Methods**: Added `generateChangelogFromChanges()` and supporting helper methods
-  - `generateWorkingDirChangelog()`: AI-powered changelog generation from file changes
-  - `generateBasicChangelogFromChanges()`: Rule-based fallback for working directory changes
-  - `getChangeDescription()`: Utility for describing file change types
-- **File I/O Integration**: Added changelog file writing to MCP tool workflows
-  - Consistent `AI_CHANGELOG.md` output across CLI and MCP interfaces
-  - Proper error handling for file writing operations
-  - Enhanced metadata with file path information
-
----
-
-## [2.3.1]
-
-### Added
-- **Attribution Footer**: Added optional attribution footer to generated changelogs
-  - Displays link to the project: "Generated using [ai-changelog-generator](https://github.com/entro314-labs/AI-changelog-generator)"
-  - Enabled by default for promotional purposes while respecting user preferences
-  - CLI flag `--no-attribution` to disable attribution footer
-  - MCP parameter `includeAttribution: false` to disable attribution in MCP server
-  - Promotes the tool while providing opt-out option for users who prefer clean output
-
----
-
-## [2.3.0]
-
-### Added
-- **Model Override System**: CLI flag `--model` and MCP parameter for forcing specific AI models
-  - Bypasses intelligent model selection logic when explicit model specified
-  - Validates model capabilities and displays feature support (reasoning, context, caching)
-  - Graceful fallback with capability warnings when model unavailable
-- **Comprehensive Repository Analysis**: New `--comprehensive` CLI command and `analyze_comprehensive` MCP tool
-  - Repository statistics: commit count, contributor analysis, age calculation
-  - Branch analysis: local/remote branch enumeration, current branch detection
-  - Working directory status: staged/unstaged/untracked file counts
-  - AI-powered health assessment with actionable recommendations
-- **Branch Analysis Tools**: New `--branches` CLI command and `analyze_branches` MCP tool
-  - Enumerates all local and remote branches
-  - Identifies unmerged commits across branches
-  - Detects dangling commits unreachable from branch heads
-  - Provides cleanup recommendations for repository maintenance
-- **Untracked File Analysis**: New `--untracked` CLI command
-  - Categorizes untracked files by type (source, config, docs, build artifacts, temp)
-  - Risk assessment for each file category
-  - Automatic .gitignore recommendations
-  - AI-powered analysis when available
-- **Enhanced Interactive Mode**: Repository status display in interactive interface
-  - Shows current branch, staged/unstaged counts before menu presentation
-  - Improved UX with contextual information for better decision making
-
-### Fixed
-- **Git Commit Parsing**: Fixed multiline commit message handling in `parseCommitOutput()`
-  - Changed from `%b` to `%B` format specifier for proper body extraction
-  - Added null byte separator support for complex commit messages
-  - Resolves issue where commits with multiline descriptions were truncated
-- **CLI Argument Processing**: Fixed `getCommitsSince()` format parameter
-  - Changed from 'simple' to 'full' format to ensure hash field availability
-  - Resolves "No commits found" error when commits existed in repository
-- **Missing Method Implementation**: Added `analyzeRepositoryWithAI()` method
-  - Implements AI-powered repository health analysis
-  - Uses `generateCompletion()` API with proper message formatting
-  - Provides structured health assessment with scoring and recommendations
-- **AI Provider Method Calls**: Corrected `generateText()` to `generateCompletion()`
-  - Updated untracked file analysis to use proper AI provider API
-  - Fixed repository analysis to use correct message format structure
-
-### Changed
-- **Model Selection Logic**: Enhanced `selectOptimalModel()` to respect model override
-  - Priority: manual override > intelligent selection > fallback
-  - Added model capability validation and user feedback
-  - Improved error handling for unavailable models
-- **CLI Help Documentation**: Updated help text to include new commands
-  - Added `--model` flag documentation with examples
-  - Included `--branches`, `--comprehensive`, `--untracked` command descriptions
-  - Updated examples section with model override usage patterns
-- **MCP Server Schema**: Extended tool definitions for new functionality
-  - Added `model` parameter to `generate_changelog` tool
-  - Added `analyze_branches` and `analyze_comprehensive` tool definitions
-  - Enhanced parameter validation and documentation
-
-### Technical Implementation
-- **Git Manager Extensions**: Added methods for comprehensive repository analysis
-  - `getAllBranches()`: Returns local/remote branch enumeration
-  - `getDanglingCommits()`: Identifies unreachable commits
-  - `getRepositoryStats()`: Calculates repository metrics
-- **AI Provider Integration**: Enhanced model override support
-  - Model capability detection and validation
-  - Intelligent fallback selection when override unavailable
-  - Performance optimization with model-specific settings
-- **Error Handling**: Improved robustness across git operations
-  - Graceful degradation when git commands fail
-  - Better error messages for troubleshooting
-  - Consistent fallback behavior for offline scenarios
-
----
-
-## [2.2.0]
-
-### Added
-- **MCP Server Implementation**: Complete Model Context Protocol server with 8 tools
-  - `generate_changelog`: AI-powered changelog generation from git history
-  - `analyze_commits`: Commit pattern analysis with configurable limits
-  - `analyze_current_changes`: Staged/unstaged file analysis
-  - `get_git_info`: Repository metadata and statistics
-  - `configure_ai_provider`: AI provider testing and validation
-  - `validate_models`: Model availability and capability checking
-- **Dual CLI/MCP Architecture**:
-  - `bin/ai-changelog.js`: Traditional CLI interface
-  - `bin/ai-changelog-mcp.js`: MCP server executable
-  - Shared core libraries for consistent functionality
-- **Intelligent Model Selection**: Complexity-based model assignment
-  - File count and line change analysis for model selection
-  - Breaking change detection for advanced reasoning models
-  - Cost optimization through efficient model usage
-- **Model Support Matrix**:
-  - `gpt-4.1-nano`: <3 files, <50 lines
-  - `gpt-4.1-mini`: 3-10 files, <200 lines
-  - `gpt-4.1`: 10-20 files, <1000 lines
-  - `o4-mini`: 20+ files, architectural changes
-- **TypeScript Definitions**: Complete type definitions in `types/index.d.ts`
-- **Configuration System**: Environment variable and .env.local support
-
-### Changed
-- **Package Architecture**: Migrated from flat to modular structure
-  - Core modules: `ai-provider.js`, `git-manager.js`, `templates.js`, `config.js`
-  - Separated concerns: CLI, MCP server, shared libraries
-  - Improved maintainability and testability
-- **Azure OpenAI Integration**: Updated to v1 API with 2025-04-01-preview version
-  - GPT-4.1 series support with 1M token context
-  - Prompt caching for 75% cost reduction
-  - Enhanced error handling and fallback mechanisms
-- **Package Namespace**: Scoped to `@entro314-labs/ai-changelog-generator`
-- **Import Resolution**: Relative paths for improved portability
-
-### Fixed
-- **Path Dependencies**: Eliminated absolute path requirements
-- **Error Boundaries**: Improved error handling for network failures
-- **Test Compatibility**: Updated test imports for new structure
-
-### Technical Details
-- **Dependencies**: Added `@modelcontextprotocol/sdk@1.12.1`
-- **API Compatibility**: Supports both OpenAI and Azure OpenAI endpoints
-- **Context Window**: 1M token support for large repository analysis
-- **Caching Strategy**: Prompt caching implementation for cost optimization
-
----
-
-## [2.1.0]
-
-### Added
-- **Interactive Mode**: Full interactive CLI with commit selection
-  - Checkbox interface for commit cherry-picking
-  - Staged/unstaged change analysis
-  - AI-powered commit message validation
-  - Commit suggestion generation
-- **Analysis Modes**: Configurable analysis depth
-  - `--detailed`: Comprehensive business and technical analysis
-  - `--enterprise`: Stakeholder-ready documentation
-  - `--analyze`: Current working directory analysis
-- **Enhanced Git Integration**: Extended git operation support
-  - Diff analysis with before/after context
-  - File categorization by type (source, docs, tests, config)
-  - Conventional commit parsing and validation
-- **AI Provider Fallback**: Rule-based analysis when AI unavailable
-  - Pattern recognition for commit classification
-  - Basic impact assessment
-  - Maintains functionality in offline scenarios
-
-### Changed
-- **Command Interface**: Expanded CLI options
-  - Version-specific changelog generation
-  - Date range filtering
-  - Output format selection
-- **AI Model Support**: Extended model compatibility
-  - GPT-4 series support
-  - Azure OpenAI integration
-  - Model-specific optimizations
-
-### Fixed
-- **Commit Parsing**: Improved conventional commit detection
-- **File Processing**: Better handling of binary files
-- **Error Recovery**: Enhanced resilience to git command failures
-
----
-
-## [2.0.0]
-
-### Added
-- **Core AI Integration**: OpenAI and Azure OpenAI API support
-- **Git Analysis Engine**: Automated commit analysis and categorization
-- **Template System**: Configurable changelog output formats
-- **Configuration Management**: Environment variable and config file support
-
-### Changed
-- **Breaking**: Migrated from manual to automated changelog generation
-- **API**: Redesigned for programmatic usage
-
-### Technical Implementation
-- **Git Operations**: Direct git command integration
-- **AI Processing**: Asynchronous batch processing
-- **Output Generation**: Template-based markdown generation
-- **Error Handling**: Comprehensive error recovery mechanisms
-
----
-
-## [1.0.0]
-
-### Added
-- **Initial Implementation**: Basic changelog generation
-- **Git Integration**: Commit history parsing
-- **CLI Interface**: Command-line argument processing
-- **File Output**: Markdown changelog generation
-
-### Technical Foundation
-- **Node.js Runtime**: Core JavaScript implementation
-- **Git Commands**: Shell command execution
-- **File System**: Changelog file management
-- **Process Management**: CLI argument handling
+## [Unreleased] - 2025-08-06
+
+### feat
+- add YAML-based configuration support with ai-changelog.config.yaml
+- add debug scripts for working directory analysis and functionality testing
+- add maxTokens initialization in AI analysis service
+
+### fix
+- add publishConfig for public npm access
+- remove references to missing test scripts to prevent publishing errors
+- update .gitignore to track AI_CHANGELOG.md in git
+
+### docs
+- update provider setup guides and environment variable documentation
+- update troubleshooting guides and contributing guidelines
+- create comprehensive README.md with usage and configuration details
+
+### chore
+- update dependencies including version increments from 3.0.3 to 3.1.1
+- downgrade @types/node from 24.2.0 to 22.17.1 for compatibility
+- remove demo media files (GIFs, MP4s) and test scripts
+- clean up unused variables in utils.js
+
+## [3.1.2] - 2025-08-06
+
+### build
+- update package.json configuration
+
+### ci
+- improve deployment configuration
+
+## [3.1.1] - 2025-08-06
+
+### fix
+- fix release workflow version handling
+- update package configuration for proper publishing
+- add publishConfig for public npm access
+- remove references to non-existent test scripts
+
+### refactor
+- update utility imports from 'consolidated-utils.js' to 'utils.js'
+- restructure MCP server entry point
+- remove sample DXT extension files
+
+### docs
+- add comprehensive AI Provider Setup Guide
+- consolidate provider configuration instructions
+
+### chore
+- add demo GIF files and video content
+- expand color constants with Dracula theme variants
+
+## [3.1.0] - 2025-08-01
+
+### feat
+- add interactive commit workflow with AI-powered commit message generation
+- add commit staging and unstaging functionality
+- add branch intelligence analysis for commit type suggestions
+- add interactive file selection for staging
+- add conventional commit format validation
+- add advanced git repository analysis and health checks
+- add `ai-changelog commit` command with interactive staging
+- add dry-run mode and custom message support
+- add provider-specific commit message optimization
+- add real-time branch analysis and suggestions
+
+### refactor
+- improve orchestrator for commit workflow support
+- extend application service with commit workflow methods
+- add branch intelligence and staging utilities to utils
+- add comprehensive commit command support to CLI controller
+
+### perf
+- optimize git operations with better error handling
+
+### feat
+- add interactive staging service for git operations
+- add commit message validation service
+
+## [3.0.3] - 2025-08-06
+
+### fix
+- fix intermittent "No working directory changes detected" issue
+- resolve Azure OpenAI provider token counting issues
+- improve error handling and fallback logic throughout system
+- improve CLI output formatting with professional visual styling
+
+### docs
+- add comprehensive JSDoc documentation
+
+### perf
+- add robust handling of git edge cases and command failures
+- clean error messages without technical implementation details
+- add session management with deduplicated warnings
+- improve fallback behavior when operations fail
+
+## [3.0.0] - 2025-07-31
+
+### feat
+- add support for 10+ AI providers (OpenAI, Anthropic Claude, Google, Azure OpenAI, Amazon Bedrock, Vertex AI, Ollama, LM Studio, Hugging Face)
+- add advanced code diff analysis and semantic understanding
+- add intelligent commit categorization and breaking change detection
+- add professional changelog formatting with multiple output formats
+- add Model Context Protocol (MCP) server for Claude integration
+- add real-time changelog generation through MCP tools
+- add secure API key management and provider switching
+- add interactive and non-interactive CLI modes
+- add multiple analysis modes (standard, detailed, enterprise)
+- add flexible output formats (Markdown, JSON, plain text)
+- add advanced git integration with branch analysis
+- add automatic model selection based on commit complexity
+- add provider failover and load balancing
+- add support for both cloud and local AI models
+- add configurable model parameters and optimization
+
+### refactor
+- implement domain-driven design with clear separation of concerns
+- add provider abstraction with base provider interface
+- add model recommendation engine
+- add advanced git integration with repository health assessment
+
+### docs
+- add extensive documentation and provider setup guides
+- add troubleshooting documentation and environment variable reference
+- add contributing guidelines with architecture overview
+
+### build
+- add shell wrapper scripts for cross-platform compatibility
+- add automatic dependency detection
+
+### feat
+- add YAML-based configuration system (ai-changelog.config.yaml)
+- add environment variable support with .env.local
+- add customizable output templates and formatting
+
+## [2.5.1] - 2025-08-01
+
+### fix
+- clean git error messages to display user-friendly warnings
+- suppress stderr output from git commands
+- simplify model availability error messages with session-based deduplication
+- add `execGitShow()` method for safer operations with missing files
+- add graceful handling of deleted/renamed files
+
+### feat
+- add `--health` CLI flag for repository health assessment
+- add `assess_repository_health` MCP tool for AI assistants
+- add 8-point commit message quality scoring system
+- add repository hygiene recommendations and actionable insights
+- add health scoring (0-100) with categorization
+
+### perf
+- clean console output with reduced error spam
+- improve fallback messaging for model selection
+- add informative warnings with actionable suggestions
+- improve rule-based analysis reliability without AI providers
+
+## [2.5.0] - 2025-08-01
+
+### feat
+- add repository health assessment with `--health` CLI flag and `assess_repository_health` MCP tool
+- add real-time commit message quality detection and scoring (8-point scale)
+- add automatic warnings for poor commit messages with actionable suggestions
+- add repository hygiene metrics
+
+### fix
+- add graceful handling of missing files in git history
+- improve error recovery for git command failures
+- improve fallback analysis when git operations fail
+
+### feat
+- improve rule-based analysis to work without AI providers
+- add commit message quality warnings to changelog output
+- add `assess_repository_health` tool with JSON output format
+- add color-coded health scores and proactive suggestions
+
+## [2.4.0] - 2025-08-01
+
+### feat
+- add `generate_changelog_from_changes` MCP tool for working directory changelog generation
+- add support for all analysis modes and model overrides in MCP tools
+- add file writing behavior - MCP tools now write `AI_CHANGELOG.md` files to project root
+- add `includeAttribution` parameter to `analyze_current_changes` MCP tool schema
+
+### fix
+- add attribution footer by default in MCP tools, matching CLI behavior
+- eliminate functionality differences between CLI and MCP interfaces
+
+### feat
+- add `generateChangelogFromChanges()` and supporting helper methods
+- add `generateWorkingDirChangelog()` for AI-powered changelog generation
+- add `generateBasicChangelogFromChanges()` for rule-based fallback
+- add changelog file writing to MCP tool workflows
+
+## [2.3.1] - 2025-08-01
+
+### feat
+- add optional attribution footer to generated changelogs
+- add `--no-attribution` CLI flag to disable attribution footer
+- add `includeAttribution: false` MCP parameter to disable attribution
+
+## [2.3.0] - 2025-08-01
+
+### feat
+- add `--model` CLI flag and MCP parameter for forcing specific AI models
+- add model capability validation and feature support display
+- add graceful fallback with capability warnings
+- add `--comprehensive` CLI command and `analyze_comprehensive` MCP tool
+- add repository statistics: commit count, contributor analysis, age calculation
+- add branch analysis: local/remote branch enumeration, current branch detection
+- add working directory status: staged/unstaged/untracked file counts
+- add AI-powered health assessment with actionable recommendations
+- add `--branches` CLI command and `analyze_branches` MCP tool
+- add branch enumeration and unmerged commit identification
+- add dangling commit detection and cleanup recommendations
+- add `--untracked` CLI command with file categorization
+- add risk assessment and automatic .gitignore recommendations
+
+### fix
+- fix multiline commit message handling in `parseCommitOutput()`
+- fix commit retrieval format parameter in CLI argument processing
+- add `analyzeRepositoryWithAI()` method implementation
+- correct `generateText()` to `generateCompletion()` API calls
+
+### refactor
+- improve `selectOptimalModel()` to respect model override
+- update CLI help documentation with new commands
+- extend MCP server schema for new functionality
+
+## [2.2.0] - 2025-08-01
+
+### feat
+- add Model Context Protocol server with 8 tools
+- add `generate_changelog` for AI-powered changelog generation
+- add `analyze_commits` for commit pattern analysis
+- add `analyze_current_changes` for staged/unstaged file analysis
+- add `get_git_info` for repository metadata and statistics
+- add `configure_ai_provider` for AI provider testing and validation
+- add `validate_models` for model availability and capability checking
+- add dual CLI/MCP architecture with shared core libraries
+- add intelligent model selection based on complexity with cost optimization
+- add TypeScript definitions in `types/index.d.ts`
+
+### refactor
+- migrate from flat to modular package structure
+- update Azure OpenAI integration to v1 API with 2025-04-01-preview version
+- scope package to `@entro314-labs/ai-changelog-generator`
+
+### build
+- add `@modelcontextprotocol/sdk@1.12.1` dependency
+
+## [2.1.0] - 2025-08-01
+
+### feat
+- add interactive CLI with commit selection
+- add checkbox interface for commit cherry-picking
+- add staged/unstaged change analysis
+- add AI-powered commit message validation
+- add configurable analysis depth modes
+- add `--detailed` for comprehensive business and technical analysis
+- add `--enterprise` for stakeholder-ready documentation
+- add `--analyze` for current working directory analysis
+- add extended git operation support
+- add diff analysis with before/after context
+- add file categorization by type
+- add conventional commit parsing and validation
+- add rule-based analysis fallback when AI unavailable
+
+### refactor
+- expand CLI options with version-specific changelog generation
+- add date range filtering and output format selection
+- extend AI model support with GPT-4 series and Azure OpenAI integration
+
+### fix
+- improve conventional commit detection
+- improve handling of binary files
+- improve resilience to git command failures
+
+## [2.0.0] - 2025-08-01
+
+### feat
+- add OpenAI and Azure OpenAI API support
+- add automated commit analysis and categorization
+- add configurable changelog output formats
+- add environment variable and config file support
+
+### refactor
+- migrate from manual to automated changelog generation
+- redesign API for programmatic usage
+
+### feat
+- add direct git command integration
+- add asynchronous batch processing
+- add template-based markdown generation
+- add comprehensive error recovery mechanisms
+
+## [1.0.0] - 2025-07-31
+
+### feat
+- add basic changelog generation with git integration
+- add command-line argument processing
+- add markdown changelog generation
+- add npm publishing setup with public access
+
+### fix
+- add publishConfig for npm publishing
+- remove missing script references in package.json
+- correct build and deployment processes
+
+### feat
+- add git commit history parsing
+- add changelog file management
+- add CLI argument handling
 
 ---
 
 ## VDK CLI Component
 
-## [2.0.0]
-
-### Major Improvements ✨
-- **Enhanced Technology Detection**: Accurately detects 20+ technology-specific rules including Tailwind CSS, shadcn/ui, Supabase, TypeScript configurations
-- **Intelligent Package Manager Detection**: Automatically detects pnpm, yarn, npm, bun based on lock files
-- **Advanced Build Tool Recognition**: Detects Turbopack, Vite, Next.js with version-specific features
-- **Smart IDE Detection**: Enhanced IDE detection without configuration folders, supports VS Code, Cursor, Windsurf, JetBrains, Zed
-
-### New Features 🚀
-- **Library-Specific Guidelines**: Dedicated processing for UI libraries like shadcn/ui and Radix UI
-- **Comprehensive Rule Coverage**: Increased rule limit from 10 to 20 for better technology coverage
-- **Real Script Extraction**: Reads actual npm/pnpm scripts from package.json instead of defaults
-- **AI Assistant Integration**: Added AI Assistant field to generated configurations
-
-### Bug Fixes 🐛
-- **GitHub Copilot Adapter**: Resolved "Cannot read properties of undefined" errors with optional chaining
-- **Rule Matching**: Improved framework and library matching with better aliases and normalization
-- **Content Extraction**: shadcn/ui and other library guidelines now properly appear in CLAUDE.md files
-- **Error Handling**: Graceful degradation for edge cases and invalid paths
-
-### Technical Improvements 🔧
-- **Rule Scoring**: Enhanced relevance scoring algorithm with platform-specific filtering
-- **Content Processing**: Mobile patterns properly excluded from web projects
-- **Template Processing**: Better extraction of actionable guidelines from remote rules
-- **Error Recovery**: Continues operation with missing dependencies or invalid configurations
-
-### Added
-- Comprehensive MDX documentation system
-- Blueprint specifications for all rule formats
-- IDE configuration reference guides
-- GitHub repository documentation templates
-
-### Changed
-- Improved project documentation structure
-- Enhanced integration guides with practical examples
-
----
-
-## [1.0.0]
-
-### Added
-- Initial release of VDK CLI
-- Project analysis and pattern detection engine
-- Multi-format rule generation (Markdown, MDC, XML, JSON)
-- AI assistant integrations:
-  - Claude Code with memory management
-  - Cursor with MDC format support
-  - Windsurf with XML-enhanced rules
-  - GitHub Copilot with JSON configuration
-  - Generic Markdown format for any AI assistant
-- VDK Hub for team collaboration and rule sharing
-- Watch mode for continuous project monitoring
-- Comprehensive CLI with 20+ commands
-- Project templates for popular frameworks
-- Rule validation and error checking
-- Integration auto-detection and setup
-- Configuration management system
-
-### Core Features
-- **Project Scanner**: Intelligent analysis of codebase structure, patterns, conventions
-- **Rule Generator**: Context-aware rule creation based on project analysis
-- **Integration Manager**: Seamless setup and management of AI assistant integrations
-- **Hub Client**: Team collaboration through rule sharing and synchronization
-- **Watch System**: Real-time monitoring and automatic rule updates
-- **Validation Engine**: Comprehensive rule and configuration validation
-
-### Supported Frameworks
-- **Frontend**: React, Vue, Angular, Svelte, Next.js, Nuxt.js, SvelteKit
-- **Backend**: Node.js, Express, FastAPI, Django, Rails
-- **Languages**: TypeScript, JavaScript, Python, Go, Rust
-- **Tools**: Tailwind CSS, Prisma, tRPC, GraphQL, Docker
-
-### CLI Commands
-- `vdk init` - Initialize VDK in project with intelligent detection
-- `vdk scan` - Analyze project and generate rules
-- `vdk deploy` - Deploy rules to VDK Hub
-- `vdk update` - Update rules from hub
-- `vdk status` - Check project and integration status
-- `vdk integrations` - Manage AI assistant integrations
-- `vdk claude-code` - Claude Code specific management
-- `vdk cursor` - Cursor IDE integration management
-- `vdk windsurf` - Windsurf IDE integration management
-- `vdk config` - Configuration management
-- `vdk validate` - Validate rules and setup
-- `vdk hub` - Hub collaboration commands
-- `vdk watch` - Enable watch mode
-- `vdk doctor` - Diagnose and troubleshoot issues
-- `vdk clean` - Clean up generated files and caches
-
-### Integration Features
-- **Claude Code**: Memory file management, custom commands, watch mode
-- **Cursor**: MDC format with directives, auto-completion, rule validation
-- **Windsurf**: XML-enhanced rules, multi-agent support, persona routing
-- **GitHub Copilot**: JSON configuration, VS Code integration, pattern learning
-- **Auto-detection**: Automatic IDE detection and setup suggestions
-- **Multi-integration**: Support for multiple AI assistants simultaneously
-
-### Hub Features
-- Team creation and management
-- Rule sharing and discovery
-- Version control and rollback
-- Public and private deployments
-- Search and filtering
-- Analytics and usage insights
-- Collaborative rule development
-
----
-
-## [0.9.0]
-
-### Added
-- Beta release for early adopters
-- Core project analysis engine
-- Basic rule generation
-- Initial Claude Code integration
-- Simple CLI interface
-
-### Changed
-- Refactored scanner architecture
-- Improved pattern detection algorithms
-
-### Fixed
-- Memory leaks in large project scanning
-- Rule generation edge cases
-
----
-
-## [0.8.0]
-
-### Added
-- Alpha release for testing
-- Proof of concept implementation
-- Basic framework detection
-- Simple rule templates
-
----
-
-## Known Issues
-
-- Large TypeScript projects (>10k files) may experience slower scanning
-- Windows path handling edge cases in monorepo scenarios
-- Hub sync conflicts in high-concurrency team environments
-
-### 🔧 Working Directory Changes
-
-- (docs) Added and updated project documentation - Created a new comprehensive README.md with usage, configuration, and contribution guidelines. Added Untitled-1.md with project purpose and notes. Deleted outdated AI_CHANGELOG.md.backup. (85%)
-
-- (feature) Introduced YAML-based configuration support - Added ai-changelog.config.yaml with customizable commit conventions and link generation options. Updated configuration.manager.js to load and parse YAML config, merging it with existing settings. Extended CLI and changelog orchestrator logic to utilize new configuration structure. (85%)
-
-- (feature) Improved changelog generation with diff analysis and provider enhancements - Updated changelog.orchestrator.js and workspace-changelog.service.js to support enhanced diff processing and integration with AI providers. Refined changelog.service.js to better handle change data and formatting. (85%)
-
-- (feature) Expanded provider support and CLI options - Enhanced provider-manager.service.js and ollama.js to support additional AI providers and improved error handling. Updated cli.controller.js to expose new configuration and provider selection options. (85%)
-
-- (fix) Resolved utility and workflow issues - Fixed bugs in utils.js related to object merging and string formatting. Improved interactive-workflow.service.js for more robust user prompts and error handling. (85%)
-
-- (chore) Updated dependencies and project metadata - Modified package.json to add new dependencies (js-yaml, yaml), update scripts, and adjust project metadata for configuration and documentation improvements. (85%)
-
-- (other) Added placeholder and example files - Created empty files for future examples and project notes: examples/, "Let me validate and expand on those scen.md", and "we recentrly refactored this project, th.md". (85%)
+### [2.0.0]
+
+### feat
+- add detection for 20+ technology-specific rules including Tailwind CSS, shadcn/ui, Supabase, TypeScript
+- add automatic package manager detection (pnpm, yarn, npm, bun) based on lock files
+- add build tool recognition (Turbopack, Vite, Next.js) with version-specific features
+- add IDE detection for VS Code, Cursor, Windsurf, JetBrains, Zed
+- add library-specific guidelines for UI libraries like shadcn/ui and Radix UI
+- increase rule limit from 10 to 20 for better technology coverage
+- add real script extraction from package.json
+- add AI Assistant field to generated configurations
+
+### fix
+- resolve GitHub Copilot adapter undefined property errors with optional chaining
+- improve framework and library matching with better aliases
+- fix library guidelines appearing in CLAUDE.md files
+- add graceful degradation for edge cases and invalid paths
+
+### perf
+- improve relevance scoring algorithm with platform-specific filtering
+- improve content processing with mobile pattern exclusion
+- improve template processing for actionable guideline extraction
+- add error recovery for missing dependencies
+
+### docs
+- add comprehensive MDX documentation system
+- add blueprint specifications for all rule formats
+- add IDE configuration reference guides
+- add GitHub repository documentation templates
+
+### refactor
+- improve project documentation structure
+- add integration guides with practical examples
+
+### [1.0.0]
+
+### feat
+- add project analysis and pattern detection engine
+- add multi-format rule generation (Markdown, MDC, XML, JSON)
+- add AI assistant integrations (Claude Code, Cursor, Windsurf, GitHub Copilot)
+- add VDK Hub for team collaboration and rule sharing
+- add watch mode for continuous project monitoring
+- add comprehensive CLI with 20+ commands
+- add project templates for popular frameworks
+- add rule validation and error checking
+- add integration auto-detection and setup
+- add configuration management system
+
+### feat
+- add project scanner with intelligent codebase analysis
+- add rule generator with context-aware rule creation
+- add integration manager for AI assistant setup and management
+- add hub client for team collaboration through rule sharing
+- add watch system for real-time monitoring and automatic updates
+- add validation engine for rule and configuration validation
+
+### feat
+- add support for frontend frameworks (React, Vue, Angular, Svelte, Next.js, Nuxt.js, SvelteKit)
+- add support for backend frameworks (Node.js, Express, FastAPI, Django, Rails)
+- add support for languages (TypeScript, JavaScript, Python, Go, Rust)
+- add support for tools (Tailwind CSS, Prisma, tRPC, GraphQL, Docker)
+
+### feat
+- add team creation and management
+- add rule sharing and discovery
+- add version control and rollback
+- add public and private deployments
+- add search and filtering
+- add analytics and usage insights
+- add collaborative rule development
 
 ---