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

335 releases 524 tags

RSS feed
  • v5.3.0 6e2c93e03a

    v5.3.0 Stable

    dpsifr released this 2025-11-04 20:24:32 +01:00 | 624 commits to main since this release

    Full Changelog: https://github.com/soulcraftlabs/brainy/compare/v5.2.1...v5.3.0

    Downloads
  • v5.2.1 b31997b1ea

    v5.2.1 Stable

    dpsifr released this 2025-11-04 16:44:28 +01:00 | 626 commits to main since this release

    Full Changelog: https://github.com/soulcraftlabs/brainy/compare/v5.2.0...v5.2.1

    Downloads
  • v5.2.0 7a399085c3

    v5.2.0 - ImageHandler & Comprehensive MIME Detection Stable

    dpsifr released this 2025-11-03 23:10:27 +01:00 | 629 commits to main since this release

    Full Changelog: https://github.com/soulcraftlabs/brainy/compare/v5.1.2...v5.2.0

    Downloads
  • v5.1.2 6345f87eb2

    v5.1.2 Stable

    dpsifr released this 2025-11-03 20:00:48 +01:00 | 632 commits to main since this release

    Full Changelog: https://github.com/soulcraftlabs/brainy/compare/v5.1.1...v5.1.2

    Downloads
  • v5.1.1 6587b9e98c

    v5.1.1 - Critical Bug Fixes Stable

    dpsifr released this 2025-11-03 16:59:04 +01:00 | 636 commits to main since this release

    🐛 Critical Bug Fixes

    update() Method - Entities Disappeared on Type Change

    Fixed two critical bugs that caused entities to become unfindable after updating their type:

    Bug #1: Index Type Mismatch

    • Issue: When re-adding to TypeAwareHNSWIndex after type change, code used existing.type instead of newType
    • Impact: Entities were indexed under the wrong type, making them completely unfindable
    • Fix: Use newType when calling index.addItem() (src/brainy.ts:643)

    Bug #2: Metadata/Vector Save Order

    • Issue: saveNoun() was called before saveNounMetadata(), so the type cache wasn't updated
    • Impact: TypeAwareStorage saved entities to the wrong type shard (e.g., saved to thing/ but cache pointed to document/), causing complete data loss
    • Fix: Call saveNounMetadata() FIRST to update type cache before saving vector (src/brainy.ts:676-688)

    Severity: Both bugs caused complete data loss when changing entity types via update(). This is a critical fix for anyone using the update() method with type changes.

    ✅ Test Suite Improvements

    Achieved 100% test pass rate (1030/1030 tests passing):

    Fixed Test Issues:

    • 3 augmentation tests - Updated for v5.1.0 stricter UUID validation API
    • 3 add tests - Replaced invalid UUID test data with valid format
    • 1 batch operations test - Increased timeout from 5000ms to 6000ms
    • 3 neural tests - Added proper memory storage configuration

    Results:

    • Before: 1020/1051 passing (97.0%)
    • After: 1030/1030 passing (100%) ✅
    • All critical systems verified: VFS, COW, Core APIs, Batch Operations, Neural

    📦 Files Changed

    Source Code: 1 file

    • src/brainy.ts - Fixed 2 critical bugs in update() method

    Tests: 4 files

    • tests/unit/augmentations/augmentations-simplified.test.ts
    • tests/unit/brainy/add.test.ts
    • tests/unit/brainy/batch-operations.test.ts
    • tests/unit/neural/neural-simplified.test.ts

    🚀 Upgrade

    npm install @soulcraft/brainy@5.1.1

    Highly recommended for anyone using update() to change entity types.

    Downloads
  • v5.1.0 2c48bac523

    v5.1.0 - VFS Auto-Initialization + Critical Bug Fixes Stable

    dpsifr released this 2025-11-02 20:45:54 +01:00 | 638 commits to main since this release

    ✨ v5.1.0 - VFS Auto-Initialization + Critical Bug Fixes

    🚨 BREAKING CHANGES

    • VFS API Change: VFS is now a property (brain.vfs) not a method (brain.vfs())
    • VFS Auto-Init: VFS automatically initializes during brain.init() - no separate vfs.init() call needed
    • UUID Validation: Stricter UUID validation (32 hex chars required)

    🎯 Key Features

    • Zero-Setup VFS: VFS now auto-initializes - eliminating setup friction
    • Root Directory: Automatically created during brain.init()
    • Simpler API: Property access instead of method call

    🐛 Critical Bug Fixes

    • CRITICAL: Fixed CacheAugmentation race condition causing null pointer during async operations
    • SECURITY: Fixed BlobStorage integrity verification bug (was incorrectly tied to skipCache option)
    • COW: Added proper skipVerification option to BlobReadOptions

    ✅ Test Results

    • Before: 906/1051 passing (86%)
    • After: 1020/1051 passing (97%)
    • VFS: 100% passing ✓
    • COW/BlobStorage: 100% passing ✓
    • Batch Operations: 96% passing ✓

    📦 Files Changed

    • src/augmentations/cacheAugmentation.ts - Race condition fix
    • src/storage/cow/BlobStorage.ts - Security fix + skipVerification option
    • tests/**/*.test.ts - 19 test files updated for v5.1.0 API

    🔧 Migration Guide

    // OLD (v5.0.0)
const brain = new Brainy()
await brain.init()
const vfs = brain.vfs()  // Method call
await vfs.init()         // Separate init required

// NEW (v5.1.0)
const brain = new Brainy()
await brain.init()       // VFS auto-initializes here
const vfs = brain.vfs    // Property access
// VFS ready to use immediately!

    📚 Documentation

    Full Changelog: https://github.com/soulcraftlabs/brainy/compare/v5.0.0...v5.1.0

    Downloads
  • v5.0.0 f3e98a8bde

    v5.0.0 - Git for Databases Stable

    dpsifr released this 2025-11-01 19:57:31 +01:00 | 645 commits to main since this release

    🚀 Brainy v5.0.0 - Git for Databases

    TRUE Instant Fork - Snowflake-style Copy-on-Write for databases

    Highlights

    ✅ ONLY vector database with fork/merge workflow
    ✅ Clone entire database in <100ms (Snowflake-style COW)
    ✅ Full Git-style branching (fork, merge, commit, checkout)
    ✅ Works with ALL 8 storage adapters
    ✅ Zero premium feature contamination - clean open source

    New APIs

    • fork() - Instant clone in <100ms
    • merge() - Merge with conflict resolution (3 strategies)
    • commit() - Create state snapshots
    • getHistory() - View commit history
    • checkout() - Switch between branches
    • listBranches() - List all branches
    • deleteBranch() - Delete branches

    Use Cases

    • Safe migrations - Fork → Test → Merge
    • A/B testing - Multiple experiments in parallel
    • Feature branches - Development isolation
    • Zero risk - Original data untouched

    Documentation

    Installation

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

    What's New in v5.0.0

    See the full CHANGELOG for details.

    Zero breaking changes - v5.0.0 is fully backward compatible with v4.x.

    Full Changelog: https://github.com/soulcraftlabs/brainy/compare/v4.11.2...v5.0.0

    Downloads
  • v4.11.2 bfa637b208

    v4.11.2 Stable

    dpsifr released this 2025-10-30 23:46:50 +01:00 | 648 commits to main since this release

    Full Changelog: https://github.com/soulcraftlabs/brainy/compare/v4.11.1...v4.11.2

    Downloads
  • v4.11.1 e7b47b73df

    v4.11.1 Stable

    dpsifr released this 2025-10-30 21:49:29 +01:00 | 650 commits to main since this release

    Full Changelog: https://github.com/soulcraftlabs/brainy/compare/v4.11.0...v4.11.1

    Downloads
  • v4.11.0 8e806af465

    v4.11.0 Stable

    dpsifr released this 2025-10-30 17:08:19 +01:00 | 652 commits to main since this release

    Full Changelog: https://github.com/soulcraftlabs/brainy/compare/v4.10.4...v4.11.0

    Downloads