335 releases 523 tags

RSS feed

• v5.12.0 9730ca41e5

  Compare

  v5.12.0: Storage-Level Batch Operations (90%+ Performance Improvement) Stable

  dpsifr released this 2025-11-19 18:01:42 +01:00 | 528 commits to main since this release

  🚀 Major Performance Improvement

  This release introduces comprehensive storage-level batch operations that eliminate N+1 query patterns and dramatically improve VFS performance on cloud storage.

  🎯 Key Improvements

  • 90%+ faster VFS operations on cloud storage (12.7s → <1s for 12 files)
  • 10-20x throughput improvement for entity retrieval
  • Zero N+1 query patterns through intelligent batching

  ✨ New APIs

  • brain.batchGet(ids, options?) - High-level batch entity retrieval
  • storage.getNounMetadataBatch(ids) - Storage-level metadata batching
  • storage.getVerbsBySourceBatch(sourceIds, verbType?) - Batch relationship queries
  • Native batch APIs for GCS, S3, R2, and Azure adapters

  📊 Performance Benchmarks

  Storage	Before	After	Improvement
  GCS	12.7s	<1s	92% faster
  S3	13.2s	<1s	92% faster
  R2	11.8s	0.8s	93% faster
  Azure	14.5s	<1s	93% faster

  🔧 Full Compatibility

  • ✅ Type-aware storage
  • ✅ Sharding (256 shards)
  • ✅ COW (branch isolation, inheritance)
  • ✅ fork() and checkout()
  • ✅ asOf() time-travel
  • ✅ All 56+ indexes

  📚 Documentation

  See docs/BATCHING.md for complete API documentation and migration guide.

  🧪 Testing

  23 comprehensive tests covering all batch operations, COW integration, and advanced features.

  ---

  Zero breaking changes - Fully backward compatible!

  Full Changelog: https://github.com/soulcraftlabs/brainy/compare/v5.11.1...v5.12.0

  Downloads

  • Source code (ZIP)
    0 downloads
  • Source code (TAR.GZ)
    0 downloads