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.38.0 6778f48dfa

    v3.38.0 - Clean Production Logging Stable

    dpsifr released this 2025-10-13 18:24:07 +02:00 | 814 commits to main since this release

    🧹 Clean Production Logging

    This release cleans up verbose diagnostic logging added during the v3.37.x GCS persistence debugging journey, making production logs clean and actionable while maintaining all critical warnings and error detection.

    ✨ Changes

    Logging Cleanup:

    • Remove verbose cache check logging (structure details, field validation diagnostics)
    • Remove verbose GCS/S3 operation logs (download progress, parsing steps, success confirmations)
    • Remove verbose pagination diagnostic logs (per-shard details, per-file tracking)
    • Keep all critical warnings for invalid cache, null cache, and auto-recovery actions
    • Keep all error logs for actual failures
    • Move successful operation details to trace level for debugging when needed

    Stability:

    • v3.37.8 cache validation remains fully functional ✅
    • Invalid cache detection and auto-recovery still work perfectly ✅
    • All safety nets remain in place ✅

    📊 Impact

    Before (v3.37.8):

    [getNode] 🔍 Cache check for 567bf17c...: { hasCached: true, isNull: false, ... }
[getNode] Cached object structure: { hasId: true, hasVector: true, ... }
[getNode] ✅ Valid cached object - returning
[getNode] 🔍 Attempting to load: UUID: ..., Path: ..., Bucket: ...
[getNode] 📥 Downloading file...
[getNode] ✅ Download successful: 10073 bytes
[getNode] 🔧 Parsing JSON...
[getNode] ✅ JSON parsed successfully, id: ...
[Shard 56] Found 12 files in "entities/nouns/vectors/56/"
[Shard 56] Extracted 12 UUIDs: ...

    After (v3.38.0):

    (silent during normal operations)

# Only logs when issues occur:
[GCS] Invalid cached object for 567bf17c (empty vector) - removing from cache and reloading
[GCS] Cache contains null for 567bf17c - reloading from storage

    🚀 GCS Persistence Journey Complete

    This completes the GCS persistence journey from v3.35.0 → v3.38.0:

    • v3.35.0: HNSW persistence foundation
    • v3.37.0-v3.37.7: Fixed cache poisoning bugs
    • v3.37.8: Added cache validation and auto-recovery
    • v3.38.0: Cleaned up diagnostic logging ✨

    Production-ready cloud storage persistence with clean, actionable logs! 🎉

    📦 Installation

    npm install @soulcraft/brainy@3.38.0

    Full Changelog: https://github.com/soulcraftlabs/brainy/compare/v3.37.8...v3.38.0

    Downloads