• v3.43.3 09c71c398f

    dpsifr released this 2025-10-14 22:36:55 +02:00 | 786 commits to main since this release

    🐛 Critical Fix: FileSystemStorage Persistence Restored

    The Problem (v3.43.2 Regression)

    v3.43.2 introduced a critical regression where FileSystemStorage ignored user-specified paths, resulting in:

    • Zero files written to disk
    • Complete data loss on restart
    • Affected ALL users (filesystem, GCS, S3 with custom paths)

    Root Cause

    API mismatch between BrainyConfig and StorageFactory:

    • Users passed: storage: { path: './data' }
    • Factory expected: { rootDirectory: './data' }
    • Result: User paths ignored, wrong fallback used

    The Fix

    • Added flexible path resolution supporting ALL API variants
    • Maintains zero-config philosophy with './brainy-data' fallback
    • Single source of truth (DRY): getFileSystemPath() helper
    • Backward compatible - no breaking changes

    Tested

    • Reproduction test confirms fix works
    • 20 unit tests pass without regressions
    • Files written to correct user-specified locations

    Upgrade Immediately

    This is a CRITICAL patch. If you're on v3.43.2, upgrade immediately to prevent data loss:

    ```bash
    npm install @soulcraft/brainy@latest
    ```

    What's Changed

    • fix: support flexible path API for FileSystemStorage by @dpsifr in 0673353
    • chore(release): 3.43.3

    Full Changelog: https://github.com/soulcraftlabs/brainy/compare/v3.43.2...v3.43.3

    Downloads