feat: Add recursive dependency resolution with API compatibility checking (v4.0.2)

Closes #2

BREAKING CHANGE: While the script remains backward compatible in non-recursive mode,
the recursive mode introduces new behavior for dependency management.

Major features:
- Add -Recursive flag for automatic nested dependency discovery and processing
- Implement API compatibility checking with temporal version ordering
- Add intelligent version selection from compatible tag intersections
- Add -MaxDepth parameter to control recursion depth (default: 5)
- Implement path conflict detection for duplicate repositories

Improvements:
- Enhanced error messages for missing tags with proper stderr capture
- Automatic cleanup of failed clones to prevent undefined states
- Skip dependency processing for repositories that fail to checkout
- Add CheckoutFailed tracking in repository dictionary
- Improve debug logging with JSON content display

Fixes:
- Fix PowerShell HashSet compatibility across different PS versions
- Fix path resolution for complex relative paths with ".." segments
- Fix git error capture using & operator instead of Invoke-Expression
- Prevent orphaned repositories when tag checkout fails

The script now supports advanced dependency management scenarios while maintaining
full backward compatibility with existing non-recursive configurations.

Tested scenarios:
- Missing tag error handling
- API compatibility with overlapping and non-overlapping version lists
- Path conflict detection
- Failed repository cleanup and recovery
- Dirty state restoration
- Non-recursive mode compatibility

Author: AndreaV-Lsi

CHANGELOG.md

@@ -5,6 +5,49 @@ 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).
 
+## [4.0.2] - 2025-01-15
+
+### Fixed
+- Git checkout error capture now properly displays stderr messages for missing tags
+- Improved error reporting clarity when tags don't exist in repositories
+
+### Changed
+- Switched from `Invoke-Expression` to `&` operator for more reliable error capture
+
+## [4.0.1] - 2025-01-15
+
+### Added
+- Cleanup of failed clones to prevent repositories in undefined states
+- CheckoutFailed tracking to skip dependency processing for failed repositories
+
+### Fixed
+- Error handling for missing tags now provides detailed error messages
+- Repositories that fail to checkout no longer have their dependencies processed
+
+### Changed
+- Enhanced error message capture and display for all git operations
+
+## [4.0.0] - 2025-01-15
+
+### Added
+- Recursive dependency discovery and processing with `-Recursive` flag
+- API compatibility checking for shared dependencies
+- "API Compatible Tags" field for version compatibility management
+- Automatic version selection (most recent compatible version)
+- Path conflict detection for duplicate repositories
+- `-MaxDepth` parameter to control recursion depth (default: 5)
+- JSON dependency file content logging in debug mode
+- Dynamic tag checkout when newer compatible version is found
+
+### Changed
+- Improved path normalization to resolve relative paths correctly
+- Enhanced debug logging for better troubleshooting
+- Repository dictionary tracks all discovered repositories
+
+### Fixed
+- PowerShell HashSet compatibility issues across different versions
+- Path resolution for nested relative paths with ".." segments
+
 ## [3.0.0] - 2025-01-14
 
 ### Changed