-
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
Full Changelog: https://github.com/soulcraftlabs/brainy/compare/v3.43.2...v3.43.3
Downloads
-
Source code (ZIP)
1 download
-
Source code (TAR.GZ)
1 download