soulcraft/brainy
2
0
Fork 0
Code Issues 1 Pull requests Projects Releases 335 Packages Wiki Activity Actions

335 releases 524 tags

RSS feed
  • v3.16.0 7a0e385c35

    v3.16.0 - Complete VFS Fixes & Documentation Stable

    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

    • Directories → NounType.Collection (correctly used)
    • Files → Smart selection: NounType.Document, NounType.Media, or NounType.File
    • Relationships → VerbType.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