• v4.8.5 14ffd3a477

    dpsifr released this 2025-10-28 22:00:09 +01:00 | 668 commits to main since this release

    ⚠️ DEBUG VERSION - DO NOT USE IN PRODUCTION

    This is a special debug version with comprehensive logging to diagnose the VFS undefined names bug reported by the Workshop team.

    Debug Logging Added:

    • VFS readdir(): Traces children and VFSDirent structure
    • PathResolver.getChildren(): Traces entity retrieval and filtering
    • convertNounToEntity(): Traces metadata extraction

    Performance Impact:

    ⚠️ This version has significant performance overhead due to console.log statements. Use only for debugging.

    Usage:

    npm install @soulcraft/brainy@4.8.5
    

    Then check your console output when calling vfs.readdir() to see:

    • How many children are found
    • What metadata keys exist on entities
    • Whether name/path/vfsType fields are present
    • Why entities are being filtered out
    • Bug Report: BRAINY_V4.8.4_VFS_UNDEFINED_NAMES_BUG.md
    • Investigating why entity.metadata.name returns undefined
    • Likely a data migration issue from v4.7.x → v4.8.0

    Next Steps:

    After gathering debug output, we'll release v4.8.6 with the fix and remove debug logging.

    Downloads