feat!: remove -DisableTagSorting parameter and always enable intelligent tag temporal sorting (#6)

BREAKING CHANGE: Remove -DisableTagSorting parameter and always enable intelligent tag temporal sorting

This major simplification removes 195+ lines of conditional logic (26% code reduction)
and ensures optimal behavior by default. API Compatible Tags can now be listed in any
order as the script always uses actual git tag dates for chronological sorting.

## Breaking Changes
- Remove -DisableTagSorting parameter completely
- Eliminate all legacy manual ordering code paths
- API Compatible Tags no longer require manual temporal ordering

## Code Simplifications
- Sort-TagsByDate: Always perform temporal sorting when tag dates available
- Get-TagUnion: Always use temporal sorting, remove complex fallback logic
- Update-RepositoryDictionary: Single code path for both Strict/Permissive modes
- Remove $script:EnableTagSorting variable and all conditional logic

## Functions Modified
- Sort-TagsByDate: Remove conditional EnableTagSorting checks (-8 lines)
- Get-TagUnion: Remove manual ordering fallback logic (-65 lines)
- Update-RepositoryDictionary: Simplify Strict mode sections (-45 lines)
- Update-RepositoryDictionary: Simplify Permissive mode sections (-35 lines)
- Show-Summary: Remove conditional tag sorting status display (-12 lines)
- Main execution: Simplify startup logging (-8 lines)
- Parameter definitions: Remove DisableTagSorting param (-4 lines)
- Documentation: Clean up help text and comments (-18 lines)

## Enhanced Logging
- Add consistent Info-level start/end messages for all dependency processing depths
- Add depth 0 start/end messages: "Starting/Completed depth 0 processing"
- Enhanced depth completion statistics showing repositories examined, dependency files found, and new repositories checked out
- Add final completion message: "Recursive processing complete - no more nested dependencies found"
- Improve depth transition messages: "Processing nested dependencies from X repositories (moving to depth Y)"
- Fix depth numbering bug: correctly progress from depth 0 → 1 → 2 → 3 instead of 0 → 2 → 3 → 4

## Benefits
- Always optimal behavior: No configuration needed for intelligent tag sorting
- Simplified maintenance: API Compatible Tags can be in any order
- Better performance: Optimized algorithms always used
- Cleaner codebase: Single execution path eliminates branching overhead
- Enhanced reliability: Eliminates possibility of manual ordering errors
- Improved user experience: Zero configuration required for best behavior
- Better visibility: Clear logging of recursive dependency processing flow with accurate depth tracking

## Migration
- JSON files: No changes required - existing configurations work unchanged
- Command line: Remove any -DisableTagSorting parameter usage
- Behavior: Automatic improvement - always uses chronological intelligence
- Logging: Enhanced depth tracking provides better visibility into recursive processing

## Compatibility
- All existing JSON configuration files work without modification
- API Compatible Tags can now be listed in any order
- Same core functionality with always-optimal behavior
- Performance equal or better than previous optimized path
- Improved logging provides better troubleshooting capabilities

Closes #6

Author: AndreaV-Lsi

CHANGELOG.md

@@ -5,6 +5,53 @@ All notable changes to LsiGitCheckout 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).
 
+## [6.0.0] - 2025-01-24
+
+### Breaking Changes
+- **BREAKING**: Removed `-DisableTagSorting` parameter - tag temporal sorting is now always enabled
+- **BREAKING**: Eliminated all legacy manual ordering code paths for API Compatible Tags
+- **BREAKING**: API Compatible Tags can now be listed in any order - automatic chronological sorting is always applied
+
+### Added
+- Always-on intelligent tag temporal sorting using actual git tag dates
+- Enhanced performance with optimized tag sorting algorithms that run only when needed
+- Simplified codebase with single, consistent code paths for tag handling
+- Improved user experience with no configuration required for optimal tag ordering
+
+### Changed
+- **Major Simplification**: Removed 195+ lines of conditional logic and legacy fallback code (26% reduction)
+- API compatibility resolution now always uses chronological tag intelligence
+- Tag selection algorithms simplified to single code paths for both Strict and Permissive modes
+- Documentation streamlined to reflect always-enabled temporal sorting
+- Startup logging simplified with clear indication that tag sorting is always active
+
+### Removed
+- `-DisableTagSorting` parameter and all associated functionality
+- `$script:EnableTagSorting` variable and conditional logic
+- Legacy manual ordering requirements and validation
+- Complex fallback algorithms for manual tag ordering compatibility
+- Conditional warnings for incompatible manually-ordered tag lists
+- All code branches that handled disabled tag sorting
+
+### Performance
+- **Optimized algorithms**: Tag date fetching only occurs when needed for conflict resolution
+- **Reduced complexity**: Single execution path eliminates branching overhead
+- **Cleaner memory usage**: Removed unused variables and conditional state tracking
+- **Faster conflict resolution**: Always uses optimal chronological intelligence
+
+### Migration Notes
+- **Zero configuration changes**: All existing JSON files work without modification
+- **Improved behavior**: Users automatically get optimal tag ordering without any parameter changes
+- **Enhanced reliability**: Eliminates the possibility of manual ordering errors
+- **Better developer experience**: API Compatible Tags can be listed in any order
+
+### Benefits
+- **Cleaner codebase**: 26% reduction in code complexity
+- **Better maintainability**: Single code path for all tag operations
+- **Enhanced user experience**: Always uses intelligent behavior by default
+- **Consistent performance**: Optimized algorithms used in all scenarios
+- **Simplified documentation**: Easier to understand and use
+
 ## [5.0.0] - 2025-01-17
 
 ### Breaking Changes