• v3.20.3 b77b73e10d

    v3.20.3 Stable

    dpsifr released this 2025-10-01 02:09:45 +02:00 | 903 commits to main since this release

    Downloads
  • v3.20.2 e78e88f8d5

    v3.20.2 Stable

    dpsifr released this 2025-09-30 21:55:50 +02:00 | 906 commits to main since this release

    Bug Fixes

    • vfs: resolve VFS race conditions and decompression errors (1a2661f)
      • Fixes duplicate directory nodes caused by concurrent writes
      • Fixes file read decompression errors caused by rawData compression state mismatch
      • Adds mutex-based concurrency control for mkdir operations
      • Adds explicit compression tracking for file reads

    Resolved Issues

    Fixes critical VFS bugs reported by Brain Studio team:

    • Issue #1: Duplicate directory nodes in getDirectChildren
    • Issue #2: Z_DATA_ERROR when reading file content

    Test Coverage

    Added comprehensive test suite with 10 tests covering:

    • Duplicate directory prevention
    • File read operations
    • Concurrent write scenarios
    • Integration tests

    All tests passing

    Downloads
  • v3.20.0 d5d00687d8

    dpsifr released this 2025-09-30 01:57:38 +02:00 | 910 commits to main since this release

    Downloads
  • v3.19.1 bc5aa37dd0

    v3.19.1 Stable

    dpsifr released this 2025-09-30 00:58:25 +02:00 | 915 commits to main since this release

    Downloads
  • v3.19.0 ced639cab1

    v3.19.0 Stable

    dpsifr released this 2025-09-30 00:37:11 +02:00 | 916 commits to main since this release

    Downloads
  • v3.18.0 e3a21c6075

    dpsifr released this 2025-09-29 22:52:22 +02:00 | 917 commits to main since this release

    Downloads
  • v3.17.0 cfd74adcb3

    v3.17.0 Stable

    dpsifr released this 2025-09-27 02:01:56 +02:00 | 922 commits to main since this release

    Downloads
  • v3.16.0 7a0e385c35

    dpsifr released this 2025-09-27 00:45:38 +02:00 | 923 commits to main since this release

    🎉 Release v3.16.0 - Production-Ready VFS

    🛠️ Complete VFS Bug Fixes

    This release delivers comprehensive fixes for all VFS issues reported by the brain-cloud team, making the Virtual File System production-ready and rock-solid.

    🐛 Critical Bugs Fixed

    Root Directory Recognition

    • Fixed "VFSError: Not a directory: /" error
    • Root directory now properly initialized with vfsType: 'directory' metadata
    • Added compatibility layer for entities with malformed metadata
    • Automatic metadata repair on entity retrieval

    Contains Relationships

    • Ensures Contains relationships are created for all file operations
    • Repairs missing relationships automatically
    • Prevents orphaned files in the graph

    🏗️ Architecture Improvements

    Standard Type System

    • DirectoriesNounType.Collection (correctly used)
    • Files → Smart selection: NounType.Document, NounType.Media, or NounType.File
    • RelationshipsVerbType.Contains for hierarchical structure
    • All entities use standard Brainy types, no string literals

    Metadata Handling

    • Robust metadata validation and repair
    • Backward compatibility with legacy structures
    • Special handling for root directory entity

    📚 New Documentation

    • VFS_GRAPH_TYPES.md - Complete guide to VFS type system usage
    • TROUBLESHOOTING.md - Common issues, solutions, and debugging tips
    • Updated CHANGELOG - Comprehensive release notes

    🔧 Technical Details

    The VFS now:

    • Properly identifies directories vs files using metadata
    • Maintains graph integrity with Contains relationships
    • Handles edge cases like root directory initialization
    • Provides clear error messages and recovery paths

    Testing

    All VFS operations tested and verified:

    • readdir('/') works correctly
    • Files appear in directory listings
    • Nested directories function properly
    • Graph relationships maintained accurately

    🚀 Migration

    No breaking changes! Simply update to v3.16.0:

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


    Full Changelog: https://github.com/soulcraftlabs/brainy/compare/v3.15.0...v3.16.0

    Downloads
  • v3.15.0 40715226fa

    v3.15.0 Stable

    dpsifr released this 2025-09-27 00:12:27 +02:00 | 925 commits to main since this release

    🚀 Release v3.15.0

    🐛 Critical VFS Bug Fix

    This release fixes a critical bug in the Virtual File System (VFS) that was reported by the brain-cloud team.

    Problem Fixed

    • vfs.readdir() was returning empty arrays even when files existed
    • Files were created successfully but weren't linked to their parent directories in the graph
    • The Contains verb relationship was missing when updating existing files

    Solution Implemented

    • Added Contains relationship verification when updating existing files
    • Create missing relationships to prevent orphaned files in the graph
    • Fixed resolvePath() to return entity IDs instead of path strings
    • Improved error handling in ensureDirectory() method
    • Added comprehensive tests for Contains relationship integrity

    Impact

    This fix resolves issues with:

    • File explorers showing empty directories
    • vfs.readdir() always returning empty arrays
    • vfs.importDirectory() importing files but not listing them
    • Recursive directory traversal failures

    Technical Details

    The VFS architecture using graph verbs is solid - this was a missing implementation detail in the writeFile() method that has now been resolved. The fix ensures data integrity and maintains proper parent-child relationships in the graph structure.


    Full Changelog: https://github.com/soulcraftlabs/brainy/compare/v3.14.2...v3.15.0

    Downloads
  • v3.14.2 493fc48603

    dpsifr released this 2025-09-26 23:28:00 +02:00 | 927 commits to main since this release

    Downloads