repoScanner v0.3.0-beta.1 - Caching, Pure-Python Fallbacks & Native Wrapper Integration

This beta release introduces centralized libcvault native wrapper integration, transparent standard-library Python fallbacks, and root-path directory caching to eliminate redundant I/O scans.

What's New

• Centralized libcvault Native Wrapper: Encapsulated native C++ extension calls behind a single libcvault_wrapper.py layer with standard LIBCVAULT_AVAILABLE checks.
• Root Path Caching: Implemented state caching (_cached_root & _cached_files) in dirScanner.py to prevent repeated filesystem re-traversals during sequential CLI mode operations (sort, search, etc.).
• Transparent Python Fallbacks: Added pure-Python standard-library fallbacks (os.walk, os.path.getsize) in helpers.py so utility modes work seamlessly out-of-the-box, even without compiled C++ shared binaries.
• DX & Benchmark Alignment:
  • Refined CLI arguments and updated benchmark scripts to evaluate performance across native vs. fallback paths.
  • Included precision profiling samples using hyperfine.
• Expanded documentation (architecture.md, usage.md, testing.md).

---

Note

• Beta Status: This is a pre-release validation build prior to the stable v0.3.0 release.
• Environment Support: Python fallback is guaranteed on all platforms. Native C++ acceleration depends on compiled .so / dynamic library availability.

New Contributors

• @AzarAI-TOP made their first contribution in #26
• @BenjaminAyivoh1 made their first contribution in #37

---

Full Changelog: v0.2.0...v0.3.0-beta.1