feat: add opt-in symlink target tracking to ResilientFileSystemMonitor

Adds WithSymlinkTargetTracking() (default off) so the monitor detects when a watched symlink's resolved target swaps - enabling hot-reload of Kubernetes ConfigMap/Secret volume mounts, which update via an atomic ..data symlink swap rather than by rewriting the watched file.

Detection folds the canonicalized final target into the change fingerprint on both the audit and polling-fallback paths and surfaces a Changed event on the user-visible path. Resolves the target's parent directory in addition to the link chain so it works on Linux/containers (where File.ResolveLinkTarget does not canonicalize intermediate directory symlinks) as well as Windows. Verified on Windows and a real Linux container (143/0 on both).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

feat: add folder rename detection and harmonize FileSearcher API (#3)

* feat: add folder rename detection and harmonize FileSearcher API

- Folder rename detection now always enabled for ResilientFileSystemMonitor
  - Emits Renamed events when folders containing matching files are renamed
  - Uses high-performance FileSearcher for directory enumeration
  - Critical for correctness - prevents blind spots in file monitoring
  - Essential for certificate rotation scenarios (atomic folder swaps)

- FileSearcher API harmonization with ResilientFileSystemMonitor
  - Added .WithFilter(params string[]) for multiple patterns
  - Added .ClearFilters() to remove all patterns
  - Added .IncludeSubdirectories(int) for depth control
  - Added .IncludeSubdirectories(bool) for simple on/off
  - Fully backward compatible - all existing methods retained

- 139 tests passing, comprehensive coverage for both features

* ci: disable fail-fast in PR validation to see all platform test results

* fix: use HashSet in SubdirectoryDepthTests to handle macOS duplicate events

macOS FileSystemWatcher can fire duplicate events for the same file operation.
Using HashSet instead of List automatically deduplicates by filename, making
tests robust across all platforms while still verifying correct behavior.

add support for multiple file patterns in ResilientFileSystemMonitor (#2

)

* feat: add support for multiple file patterns in ResilientFileSystemMonitor

* feat: add max recursion depth control to ResilientFileSystemMonitor

Merge pull request #1 from cocoar-dev/feature/filewatcher-recursive

feat!: add subdirectory depth control with non-recursive default

Refactor CI workflows: Remove test execution steps from publish workf…

…lows

Update CHANGELOG for version 1.0.0 release with detailed features and enhancements

Enhance README with new features, usage examples, and documentation links

Add comprehensive documentation for FileReader, including secure reading patterns and best practices

Implement FileReader class for secure file reading with shared access and BOM handling

Add unit tests for FileReader to ensure functionality and edge case handling