v1.0.0 - Initial Stable Release

🎉 First Stable Release

Production-ready file system utilities for .NET with automatic error recovery and multi-platform support.

✨ Features

ResilientFileSystemMonitor

• Auto-Recovery: Handles directory disappearing/reappearing, permission errors, watcher crashes
• Smart Fallback: Automatic switching between FileSystemWatcher and polling
• Debouncing: Built-in support to reduce noise from rapid file changes
• Health Checks: Periodic monitoring to detect silent watcher failures (especially on macOS)
• Reactive Streams: Unified event stream via ChannelReader<FileSystemEvent>
• Fluent API: Clean, discoverable configuration

FileSearcher

• Fast, lazy-evaluated directory traversal
• Depth limits and exclusion patterns
• LINQ support for flexible querying
• Efficient handling of large directory trees

FileReader

• Shared read/write access (works when files are open by other processes)
• Optional UTF-8 BOM stripping
• Try-pattern for graceful handling of missing files
• Byte array zeroing for sensitive content

🌍 Platform Support

• ✅ Windows
• ✅ Linux
• ✅ macOS

📦 Installation

dotnet add package Cocoar.FileSystem

📚 Documentation

• ResilientFileSystemMonitor Guide
• FileReader Guide
• Examples
• Reactive Examples
• Full Changelog

🧪 Testing

98 tests across all major platforms with comprehensive coverage.

---

Full Changelog: https://github.com/cocoar-dev/Cocoar.FileSystem/blob/main/CHANGELOG.md