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.3.2 3260a6ce6d

    v4.3.2 Stable

    dpsifr released this 2025-10-24 01:54:50 +02:00 | 723 commits to main since this release

    Critical Bug Fix: createEntities Default Behavior

    CRITICAL FIX for Workshop Team: The createEntities option now correctly defaults to true when not specified, fixing a bug that caused imports to skip graph entity creation entirely.

    The Bug

    In v4.3.0-v4.3.1, calling brain.import() without explicitly setting createEntities: true would only create VFS file wrappers (type: "document") and skip creating semantic graph entities (type: "person", "location", etc.). This broke type filtering functionality.

    Impact: Type filtering returned 0 results despite entities appearing in HNSW index.

    The Fix

    1. Explicit false check: createEntities now only skips entity creation when explicitly set to false, not when undefined
    2. Correct option spreading: Fixed option merging to preserve defaults properly
    3. AI features enabled: enableRelationshipInference and enableNeuralExtraction now default to true

    Workshop Team Resolution

    If you experienced type filtering issues in v4.3.0 or v4.3.1:

    1. Upgrade to v4.3.2: npm install @soulcraft/brainy@latest
    2. Clear your data directory: rm -rf ./brainy-data
    3. Re-import your data (no code changes needed!)
    4. Type filtering will now work correctly

    Additional Improvements

    • Smarter relationships: SmartRelationshipExtractor now enabled by default
    • Neural extraction: Entity and concept extraction enabled by default
    • Better defaults: Most import options now have intelligent defaults

    Test Coverage

    Added comprehensive test coverage to prevent regression:

    • 26 new test assertions across 4 test files
    • End-to-end VFS + graph entity verification
    • Type filtering regression tests
    • Relationship intelligence verification

    Breaking Changes

    None - this restores the intended default behavior.

    Files Changed

    • src/import/ImportCoordinator.ts - Fix createEntities default and option spreading
    • tests/unit/create-entities-default.test.ts - NEW
    • tests/integration/vfs-and-graph-entities.test.ts - NEW
    • tests/integration/relationship-intelligence.test.ts - NEW
    • tests/unit/type-filtering.unit.test.ts - NEW

    All tests passing ✅

    Downloads