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.10.4 4862948bb1

    v4.10.4 Stable

    dpsifr released this 2025-10-30 16:54:54 +01:00 | 654 commits to main since this release

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

    Downloads
  • v4.10.3 3c5f622d64

    v4.10.3 Stable

    dpsifr released this 2025-10-30 03:31:09 +01:00 | 656 commits to main since this release

    Full Changelog: https://github.com/soulcraftlabs/brainy/compare/v4.10.2...v4.10.3

    Downloads
  • v4.10.2 348b146754

    v4.10.2 Stable

    dpsifr released this 2025-10-30 03:15:42 +01:00 | 658 commits to main since this release

    Full Changelog: https://github.com/soulcraftlabs/brainy/compare/v4.10.1...v4.10.2

    Downloads
  • v4.10.1 edf46155ef

    v4.10.1 Stable

    dpsifr released this 2025-10-30 00:48:41 +01:00 | 660 commits to main since this release

    Full Changelog: https://github.com/soulcraftlabs/brainy/compare/v4.10.0...v4.10.1

    Downloads
  • v4.10.0 c05e1699d4

    v4.10.0 Stable

    dpsifr released this 2025-10-30 00:11:21 +01:00 | 662 commits to main since this release

    Full Changelog: https://github.com/soulcraftlabs/brainy/compare/v4.9.2...v4.10.0

    Downloads
  • v4.9.2 f29416e4a7

    v4.9.2 Stable

    dpsifr released this 2025-10-29 23:37:38 +01:00 | 664 commits to main since this release

    Full Changelog: https://github.com/soulcraftlabs/brainy/compare/v4.9.1...v4.9.2

    Downloads
  • v4.9.1 bcf4a97042

    v4.9.1 Stable

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

    Documentation Fixes

    This patch release addresses NO FAKE CODE policy violations in VFS documentation.

    Changes

    • vfs: Fix NO FAKE CODE policy violations in VFS documentation
      • Removed 9 undocumented feature sections (~242 lines) from VFS docs
      • Added status labels (✅ Production, ⚠️ Beta, 🧪 Experimental) to all VFS features
      • Updated performance claims with MEASURED vs PROJECTED labels
      • Created docs/vfs/ROADMAP.md for planned features
      • Fixed storage adapter list to show only 8 built-in adapters

    Impact

    VFS documentation now 100% compliant with NO FAKE CODE policy. All features accurately reflect implementation status and tested performance.

    Full Changelog: https://github.com/soulcraftlabs/brainy/compare/v4.9.0...v4.9.1

    Downloads
  • v4.9.0 db23836b32

    v4.9.0 - Universal Relationship Extraction Stable

    dpsifr released this 2025-10-29 00:28:18 +01:00 | 669 commits to main since this release

    🎯 Summary

    This release implements Universal Relationship Extraction with full provenance tracking, transforming Brainy imports from simple entity extractors into true knowledge graph builders.

    Key Problem Solved

    Before v4.9.0:

    • Imports created entities but minimal semantic relationships
    • No document entity representing the source file
    • No way to trace entities back to their source
    • Generic "related_to" relationships with no semantic diversity
    • VFS structural relationships mixed with knowledge graph relationships

    After v4.9.0:

    • ✅ Document entity created for every import
    • ✅ Full provenance tracking (document → entity relationships)
    • ✅ Enhanced column detection (7 relationship types vs 1)
    • ✅ Type-based relationship inference (smarter relationship types)
    • ✅ Clear separation of VFS/semantic/provenance relationships

    📋 Changes Implemented

    1. Document Entity Creation (HIGH IMPACT)

    Creates a `NounType.Document` entity for every imported file with metadata tracking total entities, breakdown by type, and import timestamp.

    2. Provenance Relationships (HIGH IMPACT)

    Creates `document → entity` relationship for EVERY imported entity, enabling:

    • "Show source" functionality
    • Full data lineage tracking
    • Bidirectional navigation (entity ↔ document)

    3. Relationship Type Metadata (CRITICAL)

    All relationships now marked with `relationshipType`:

    • `'provenance'` - Document → entity relationships
    • `'semantic'` - Knowledge graph relationships
    • `'vfs'` - Virtual file system structure

    4. Enhanced Column Detection (MEDIUM IMPACT)

    Expanded from 1 to 7 relationship column patterns:

    • Location, Home, Lives In → `located_at`
    • Owner, Owned By, Wielder → `part_of`
    • Created By, Made By, Author → `created_by`
    • Uses, Utilizes, Weapon → `uses`
    • Member Of, Part Of, Group → `part_of`
    • Knows, Friend, Ally → `friend_of`
    • Connection, Link, See Also → `related_to`

    5. Type-Based Inference (MEDIUM IMPACT)

    Automatically infers better relationship types based on:

    • Context analysis (keywords in relationship descriptions)
    • Entity type patterns (Person + Location → `located_at`, etc.)
    • 10+ type-based inference rules

    📊 Expected Impact

    For a typical 1,149-row import:

    Before v4.9.0:

    • Entities: 1,149
    • Relationships: 581 (ALL "contains" - VFS only)
    • Document Entity: ❌ None
    • Provenance: ❌ None

    After v4.9.0:

    • Entities: 1,150 (1,149 + 1 document)
    • Relationships: ~3,900 total
      • 1,149 provenance (document → entity)
      • ~1,500 semantic (entity ↔ entity, diverse types)
      • 581 VFS (directory structure, marked separately)

    🚀 Upgrade Instructions

    1. Upgrade Brainy:
      ```bash
      npm install @soulcraft/brainy@4.9.0
      ```

    2. Re-import your files:
      ```bash
      brainy import "your-file.xlsx"
      ```

    3. Query your knowledge graph:
      ```javascript
      // Get all semantic relationships (filter out VFS)
      const semanticRels = await brain.getRelations({
      metadata: { relationshipType: 'semantic' }
      })

      // Get provenance (source documents)
      const documents = await brain.find({ type: 'document' })
      ```

    🔧 Technical Details

    Files Modified:

    • src/import/ImportCoordinator.ts (+175 lines)
    • src/importers/SmartExcelImporter.ts (+65 lines)
    • src/vfs/VirtualFileSystem.ts (+2 lines)

    Backward Compatibility:

    ✅ 100% backward compatible - all new features work automatically

    Universal Support:

    ✅ Works for ALL 7 import formats: Excel, PDF, CSV, JSON, Markdown, YAML, DOCX

    Release Date: 2025-10-28
    Type: Minor Version (New Features)
    Breaking Changes: No
    Migration Required: No

    Downloads
  • v4.8.6 a24b31ddb4

    v4.8.6 Stable

    dpsifr released this 2025-10-28 22:37:28 +01:00 | 672 commits to main since this release

    Full Changelog: https://github.com/soulcraftlabs/brainy/compare/v4.8.5...v4.8.6

    Downloads
  • v4.8.5 14ffd3a477

    v4.8.5 DEBUG - VFS Undefined Names Diagnosis Stable

    dpsifr released this 2025-10-28 22:00:09 +01:00 | 674 commits to main since this release

    ⚠️ DEBUG VERSION - DO NOT USE IN PRODUCTION

    This is a special debug version with comprehensive logging to diagnose the VFS undefined names bug reported by the Workshop team.

    Debug Logging Added:

    • VFS readdir(): Traces children and VFSDirent structure
    • PathResolver.getChildren(): Traces entity retrieval and filtering
    • convertNounToEntity(): Traces metadata extraction

    Performance Impact:

    ⚠️ This version has significant performance overhead due to console.log statements. Use only for debugging.

    Usage:

    npm install @soulcraft/brainy@4.8.5

    Then check your console output when calling vfs.readdir() to see:

    • How many children are found
    • What metadata keys exist on entities
    • Whether name/path/vfsType fields are present
    • Why entities are being filtered out

    Related Issue:

    • Bug Report: BRAINY_V4.8.4_VFS_UNDEFINED_NAMES_BUG.md
    • Investigating why entity.metadata.name returns undefined
    • Likely a data migration issue from v4.7.x → v4.8.0

    Next Steps:

    After gathering debug output, we'll release v4.8.6 with the fix and remove debug logging.

    Downloads