Finalize v0.5.0 CHANGELOG.md

Author: Wilson421

CHANGELOG.md

@@ -31,111 +31,87 @@ All notable changes to the "excel-power-query-editor" extension will be document
 
 ---
 
-## [0.5.0-rc.2] - 2025-07-14
 
-### 🚀 Major Performance & Feature Release
+## [0.5.0] - 2025-07-20
+
+### 🎯 Marketplace Release - Professional Logging, Auto-Watch Enhancements, Symbols, and Legacy Settings Migration
 
 #### Added
-- **NEW FEATURE: Excel Power Query Symbols System**
+- **Excel Power Query Symbols System**
   - Complete Excel-specific IntelliSense support (Excel.CurrentWorkbook, Excel.Workbook, etc.)
   - Auto-installation with Power Query Language Server integration
-  - Addresses gap in M Language extension (Power BI/Azure focused)
   - Configurable installation scope (workspace/folder/user/off)
-
-#### Fixed  
-- **CRITICAL: Auto-Save Performance Crisis**
-  - Resolved VS Code auto-save + file watcher causing keystroke-level sync with large files
-  - Intelligent debouncing based on Excel file size (not .m file size)
-  - Large file handling: 3000ms → 8000ms debounce for files >10MB
-- **Test Infrastructure Excellence**
-  - All 71 tests passing across platforms
-  - Eliminated test hangs from file dialogs and background processes
-  - Auto-compilation for VS Code Test Explorer
-  - Robust parameter validation and error handling
-
-#### Changed
-- **Configuration Best Practices**
-  - ⚠️ **WARNING**: DO NOT enable VS Code auto-save + Extension auto-watch simultaneously
-  - Recommended: `"files.autoSave": "off"` with extension file watching
-  - Documented optimal performance configuration patterns
-
-## [0.5.0] - 2025-07-15
-
-### 🎯 Marketplace Release - Professional Logging & Auto-Watch Enhancements
-
-#### Added
 - **Professional Logging System**
   - Emoji-enhanced logging with visual level indicators (🪲🔍ℹ️✅⚠️❌)
   - Six configurable log levels: none, error, warn, info, verbose, debug
   - Automatic emoji support detection for VS Code environments
   - Context-aware logging with function-specific prefixes
   - Environment detection and settings dump for debugging
-
 - **Intelligent Auto-Watch System**
-  - NEW: Configurable auto-watch file limits (`watchAlways.maxFiles`: 1-100, default 25)
+  - Configurable auto-watch file limits (`watchAlways.maxFiles`: 1-100, default 25)
   - Prevents performance issues in large workspaces with many .m files
   - Smart file discovery with Excel file matching validation
   - Detailed logging of skipped files and initialization progress
-
 - **Enhanced Excel Symbols Integration**
   - Three-step Power Query settings update for immediate effect
   - Delete/pause/reset sequence forces Language Server reload
   - Ensures new symbols take effect without VS Code restart
   - Cross-platform directory path handling
+- **Legacy Settings Migration**
+  - Automatic migration of deprecated settings (`debugMode`, `verboseMode`) to new `logLevel` with user notification
+- **New Commands**
+  - `Apply Recommended Defaults`: Sets optimal configuration for new users
+  - `Cleanup Old Backups`: Manual backup management
 
-#### Fixed
+#### Fixed & Improved
+- **Auto-Save Performance**
+  - Resolved VS Code auto-save + file watcher causing keystroke-level sync with large files
+  - Intelligent debouncing based on Excel file size (not .m file size)
+  - Large file handling: 3000ms → 8000ms debounce for files >10MB
+- **Test Infrastructure**
+  - 74 comprehensive tests with 100% pass rate, including legacy settings migration
+  - Eliminated test hangs from file dialogs and background processes
+  - Auto-compilation for VS Code Test Explorer
+  - Robust parameter validation and error handling
 - **Configuration System**
   - Fixed `watchAlwaysMaxFiles` setting validation (was incorrectly named `watchAlways.maxFiles`)
   - VS Code settings now properly accept numeric input for auto-watch file limits
   - Resolved "Value must be a number" error in extension settings
-
+  - v0.4.x settings (`debugMode`, `verboseMode`) are now automatically migrated to the new `logLevel` system
 - **Logging System Consistency**
   - Fixed context naming inconsistencies (ExtractFromExcel → extractFromExcel)
   - Replaced generic contexts with specific function names
   - Optimized log levels for better user experience
   - Eliminated double logging patterns
-
 - **Auto-Watch Performance**
   - Intelligent file limit enforcement prevents extension overwhelm
   - Better handling of workspaces with many test fixtures
   - Improved startup time with configurable limits
+- **Settings System**
+  - Centralized VS Code API mocking for reliable test environment
+  - All commands properly registered and available in test environment
+  - Improved debouncing prevents unnecessary sync operations
+  - Automatic v0.4.x settings migration to v0.5.0 structure
 
-#### Changed
+#### Changed & Technical
 - **VS Code Marketplace Ready**
   - Professional user experience with polished logging
   - Enhanced settings documentation
   - Optimal default configurations for production use
-
-## [0.5.0-rc.2] - 2025-07-14
-  - `sync.openExcelAfterWrite`: Auto-launch Excel after sync operations
-  - `sync.debounceMs`: Configurable sync delay (prevents duplicate syncs with CoPilot)
-  - `watch.checkExcelWriteable`: Validate Excel file access before sync
-  - `backup.maxFiles`: Replaces `maxBackups` with improved backup retention
-- **New Commands**:
-  - `Apply Recommended Defaults`: Sets optimal configuration for new users
-  - `Cleanup Old Backups`: Manual backup management
-- **Enhanced Error Handling**: Locked file detection with retry logic and clear user feedback
-- **CoPilot Integration**: Intelligent debouncing and file hash deduplication prevents triple-sync issues
-
-### Improved
-
-- **Test Coverage**: 63 comprehensive tests with 100% pass rate across platforms
-- **CI/CD Pipeline**: Cross-platform GitHub Actions with Ubuntu, Windows, macOS validation
-- **Development Environment**: Complete DevContainer setup with pre-configured dependencies
-- **Documentation**: Comprehensive USER_GUIDE.md, CONFIGURATION.md, and CONTRIBUTING.md
-
-### Fixed
-
-- **Settings System**: Centralized VS Code API mocking for reliable test environment
-- **Command Registration**: All commands properly registered and available in test environment
-- **Watch Mode**: Improved debouncing prevents unnecessary sync operations
-- **Configuration Migration**: Automatic v0.4.x settings migration to v0.5.0 structure
-
-### Technical
-
-- **Quality Gates**: ESLint, TypeScript, and test validation in CI/CD
-- **Cross-Platform**: Ubuntu 22.04, Windows Server 2022, macOS 14 compatibility verified
-- **Artifact Management**: VSIX packaging with 30-day retention
+- **Test Coverage**
+  - 74 comprehensive tests with 100% pass rate, including legacy settings migration
+- **CI/CD Pipeline**
+  - Cross-platform GitHub Actions with Ubuntu, Windows, macOS validation
+- **Development Environment**
+  - Complete DevContainer setup with pre-configured dependencies
+- **Documentation**
+  - Comprehensive USER_GUIDE.md, CONFIGURATION.md, and CONTRIBUTING.md
+- **Quality Gates**
+  - ESLint, TypeScript, and test validation in CI/CD
+- **Cross-Platform**
+  - Ubuntu 22.04, Windows Server 2022, macOS 14 compatibility verified
+- **Artifact Management**
+  - VSIX packaging with 30-day retention
 
 ---