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

335 releases 524 tags

RSS feed
  • v4.8.1 1d4d737c60

    v4.8.1 - Critical VFS Bug Fix Stable

    dpsifr released this 2025-10-28 17:12:48 +01:00 | 683 commits to main since this release

    Critical Bug Fix - VFS Relationships

    FIXES 11-VERSION BUG: getVerbsBySource() now returns verbs without metadata files

    Root Cause

    • FileSystemStorage was skipping verbs without metadata files
    • Workshop had 601 verb files with 0 metadata files
    • Result: getVerbsBySource() returned 0 verbs (breaking VFS)

    Fixed

    1. FileSystemStorage: Remove metadata requirement (2 locations)
    2. TypeAwareStorage: Delegate to underlying storage (10x-100x faster)

    Verified

    • Tested against Workshop's 601 verb dataset
    • Result: 0 verbs → 2 verbs ✓
    • All 25 augmentation tests passing

    Upgrade

    npm install @soulcraft/brainy@4.8.1

    Workshop team can now use VFS immediately.

    Downloads
  • v4.8.0 26204a7d67

    v4.8.0 Stable

    dpsifr released this 2025-10-28 01:04:50 +01:00 | 685 commits to main since this release

    Full Changelog: https://github.com/soulcraftlabs/brainy/compare/v4.7.4...v4.8.0

    Downloads
  • v4.7.4 e06edb7d52

    v4.7.4 - CRITICAL VFS Bug Fix Stable

    dpsifr released this 2025-10-27 22:23:46 +01:00 | 690 commits to main since this release

    🚨 CRITICAL SYSTEMIC VFS BUG FIX

    Workshop Team Unblocked!

    This hotfix resolves a systemic bug affecting ALL storage adapters that caused VFS queries to return empty results even when data existed.

    🐛 Critical Bug Fixes

    • storage: Fix systemic metadata skip bug across ALL 7 storage adapters

      • Impact: VFS queries returned empty arrays despite 577 "Contains" relationships existing
      • Root Cause: All storage adapters skipped entities if metadata file read returned null
      • Bug Pattern: if (!metadata) continue in getNouns()/getVerbs() methods
      • Fixed Locations: 12 bug sites across 7 adapters (TypeAware, Memory, FileSystem, GCS, S3, R2, OPFS, Azure)
      • Solution: Allow optional metadata with metadata: (metadata || {}) as NounMetadata
      • Result: Workshop team UNBLOCKED - VFS entities now queryable

    • neural: Fix SmartExtractor weighted score threshold bug (28 test failures → 4)

      • Root Cause: Single signal with 0.8 confidence × 0.2 weight = 0.16 < 0.60 threshold
      • Solution: Use original confidence when only one signal matches
      • Impact: Entity type extraction now works correctly

    • neural: Fix PatternSignal priority ordering

      • Specific patterns (organization "Inc", location "City, ST") now ranked higher than generic patterns
      • Prevents person full-name pattern from overriding organization/location indicators

    • api: Fix Brainy.relate() weight parameter not returned in getRelations()

      • Root Cause: Weight stored in metadata but read from wrong location
      • Solution: Extract weight from metadata: v.metadata?.weight ?? 1.0

    📊 Test Results

    • TypeAwareStorageAdapter: 17/17 tests passing (was 7 failures)
    • SmartExtractor: 42/46 tests passing (was 28 failures)
    • Neural domain clustering: 3/3 tests passing
    • Brainy.relate() weight: 1/1 test passing

    🏗️ Architecture Notes

    Two-Phase Fix:

    1. Storage Layer (NOW FIXED): Returns ALL entities, even with empty metadata
    2. VFS Layer (ALREADY SAFE): PathResolver uses optional chaining entity.metadata?.vfsType

    Result: Valid VFS entities pass through, invalid entities safely filtered out.

    📦 Installation

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

    🙏 Workshop Team

    Please test with your import data and verify VFS queries now return results!

    Downloads
  • v4.7.3 c75bbb9ba4

    v4.7.3 Stable

    dpsifr released this 2025-10-27 21:14:43 +01:00 | 691 commits to main since this release

    Full Changelog: https://github.com/soulcraftlabs/brainy/compare/v4.7.2...v4.7.3

    Downloads
  • v4.7.2 fc307bc215

    v4.7.2 - Clean Directory Architecture Stable

    dpsifr released this 2025-10-27 20:24:13 +01:00 | 693 commits to main since this release

    Critical VFS Bug Fix

    This release fixes the VFS bug where verb vector files were written to the wrong directory, causing to return empty even though entities existed.

    Breaking Changes for Workshop Team

    IMPORTANT: You must delete your folder and reimport with v4.7.2. The directory structure has changed:

    Old (broken):

    • Verb vectors: (root level)
    • Noun vectors:

    New (clean):

    • Verb vectors:
    • Noun vectors:

    Changes

    • FileSystemStorage now uses clean hardcoded directory paths
    • Removed dual read/write backward compatibility code
    • Removed legacy constants and helper functions
    • All storage adapters use consistent structure (v4.7.2+)

    Migration

    rm -rf brainy-data
npm install @soulcraft/brainy@4.7.2
# Re-run your import

    Full Changelog: https://github.com/soulcraftlabs/brainy/compare/v4.7.1...v4.7.2

    Downloads
  • v4.7.1 ff01782410

    v4.7.1: VFS Hotfix - Fix readdir() Empty Results Stable

    dpsifr released this 2025-10-27 19:26:02 +01:00 | 696 commits to main since this release

    Full Changelog: https://github.com/soulcraftlabs/brainy/compare/v4.7.0...v4.7.1

    Downloads
  • v4.7.0 38c41e012e

    v4.7.0: VFS Visibility Fix Stable

    dpsifr released this 2025-10-27 18:50:29 +01:00 | 698 commits to main since this release

    Full Changelog: https://github.com/soulcraftlabs/brainy/compare/v4.6.0...v4.7.0

    Downloads
  • v4.6.0 5c3d2e9b67

    v4.6.0 - Query Operators & Sorting Stable

    dpsifr released this 2025-10-27 17:31:01 +01:00 | 700 commits to main since this release

    Full Changelog: https://github.com/soulcraftlabs/brainy/compare/v4.5.3...v4.6.0

    Downloads
  • v4.5.3 a7948d2f11

    v4.5.3 - Fix VFS Root Selection Bug Stable

    dpsifr released this 2025-10-27 16:05:32 +01:00 | 703 commits to main since this release

    Full Changelog: https://github.com/soulcraftlabs/brainy/compare/v4.5.2...v4.5.3

    Downloads
  • v4.5.2 dc34c309ce

    v4.5.2 Stable

    dpsifr released this 2025-10-25 02:09:20 +02:00 | 705 commits to main since this release

    Full Changelog: https://github.com/soulcraftlabs/brainy/compare/v4.5.1...v4.5.2

    Downloads