@soulcraft/brainy 4.5.0 → 4.5.2

package/dist/brainy.js

@@ -846,6 +846,13 @@ export class Brainy {
         if (params.service) {
             filter.service = params.service;
         }
+        // v4.5.1: Exclude VFS relationships by default (same pattern as brain.find())
+        // VFS relationships have metadata.isVFS = true
+        // Only include VFS relationships if explicitly requested
+        if (params.includeVFS !== true) {
+            filter.metadata = filter.metadata || {};
+            filter.metadata.isVFS = { notEquals: true };
+        }
         // Fetch from storage with pagination at storage layer (efficient!)
         const result = await this.storage.getVerbs({
             pagination: {

package/dist/types/brainy.types.d.ts

@@ -266,6 +266,16 @@ export interface GetRelationsParams {
      * Only return relationships belonging to this service.
      */
     service?: string;
+    /**
+     * Include VFS relationships (v4.5.1)
+     *
+     * By default, getRelations() excludes VFS relationships (since v4.4.0).
+     * Set this to true when you need to traverse VFS structure.
+     *
+     * @default false
+     * @since v4.5.1
+     */
+    includeVFS?: boolean;
 }
 /**
  * Batch add parameters

package/dist/vfs/PathResolver.js

@@ -135,7 +135,8 @@ export class PathResolver {
         // Get all relationships where parentId contains other entities
         const relations = await this.brain.getRelations({
             from: parentId,
-            type: VerbType.Contains
+            type: VerbType.Contains,
+            includeVFS: true // v4.5.1: Required to see VFS relationships
         });
         // Find the child with matching name
         for (const relation of relations) {
@@ -159,7 +160,8 @@ export class PathResolver {
         // Production-ready: Use graph relationships (VFS creates these in mkdir/writeFile)
         const relations = await this.brain.getRelations({
             from: dirId,
-            type: VerbType.Contains
+            type: VerbType.Contains,
+            includeVFS: true // v4.5.1: Required to see VFS relationships
         });
         const validChildren = [];
         const childNames = new Set();

package/dist/vfs/VirtualFileSystem.js

@@ -106,9 +106,10 @@ export class VirtualFileSystem {
             if (existing.length > 1) {
                 console.warn(`⚠️  Found ${existing.length} root entities! Using first one, consider cleanup.`);
                 // Sort by creation time - use oldest root (most likely to have children)
+                // v4.5.2: FIX - createdAt is at entity level, not metadata level!
                 existing.sort((a, b) => {
-                    const aTime = a.metadata?.createdAt || a.metadata?.modified || 0;
-                    const bTime = b.metadata?.createdAt || b.metadata?.modified || 0;
+                    const aTime = a.createdAt || a.metadata?.modified || 0;
+                    const bTime = b.createdAt || b.metadata?.modified || 0;
                     return aTime - bTime;
                 });
             }
@@ -330,7 +331,8 @@ export class VirtualFileSystem {
                 await this.brain.relate({
                     from: parentId,
                     to: existingId,
-                    type: VerbType.Contains
+                    type: VerbType.Contains,
+                    metadata: { isVFS: true } // v4.5.1: Mark as VFS relationship
                 });
             }
         }
@@ -347,7 +349,8 @@ export class VirtualFileSystem {
             await this.brain.relate({
                 from: parentId,
                 to: entity,
-                type: VerbType.Contains
+                type: VerbType.Contains,
+                metadata: { isVFS: true } // v4.5.1: Mark as VFS relationship
             });
             // Update path resolver cache
             await this.pathResolver.createPath(path, entity);
@@ -612,7 +615,8 @@ export class VirtualFileSystem {
                 await this.brain.relate({
                     from: parentId,
                     to: entity,
-                    type: VerbType.Contains
+                    type: VerbType.Contains,
+                    metadata: { isVFS: true } // v4.5.1: Mark as VFS relationship
                 });
             }
             // Update path resolver cache
@@ -1410,7 +1414,12 @@ export class VirtualFileSystem {
             // Add to new parent
             if (newParentPath && newParentPath !== '/') {
                 const newParentId = await this.pathResolver.resolve(newParentPath);
-                await this.brain.relate({ from: newParentId, to: entityId, type: VerbType.Contains });
+                await this.brain.relate({
+                    from: newParentId,
+                    to: entityId,
+                    type: VerbType.Contains,
+                    metadata: { isVFS: true } // v4.5.1: Mark as VFS relationship
+                });
             }
         }
         // Update the entity
@@ -1475,7 +1484,12 @@ export class VirtualFileSystem {
         const parentPath = this.getParentPath(destPath);
         if (parentPath && parentPath !== '/') {
             const parentId = await this.pathResolver.resolve(parentPath);
-            await this.brain.relate({ from: parentId, to: newEntity, type: VerbType.Contains });
+            await this.brain.relate({
+                from: parentId,
+                to: newEntity,
+                type: VerbType.Contains,
+                metadata: { isVFS: true } // v4.5.1: Mark as VFS relationship
+            });
         }
         // Update path cache
         await this.pathResolver.createPath(destPath, newEntity);
@@ -1562,7 +1576,8 @@ export class VirtualFileSystem {
         await this.brain.relate({
             from: parentId,
             to: entity,
-            type: VerbType.Contains
+            type: VerbType.Contains,
+            metadata: { isVFS: true } // v4.5.1: Mark as VFS relationship
         });
         // Update path resolver cache
         await this.pathResolver.createPath(path, entity);
@@ -1732,7 +1747,8 @@ export class VirtualFileSystem {
         await this.brain.relate({
             from: fromEntityId,
             to: toEntityId,
-            type: type // Convert string to VerbType
+            type: type, // Convert string to VerbType
+            metadata: { isVFS: true } // v4.5.1: Mark as VFS relationship
         });
         // Invalidate caches for both paths
         this.invalidateCaches(from);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soulcraft/brainy",
-  "version": "4.5.0",
+  "version": "4.5.2",
   "description": "Universal Knowledge Protocol™ - World's first Triple Intelligence database unifying vector, graph, and document search in one API. 31 nouns × 40 verbs for infinite expressiveness.",
   "main": "dist/index.js",
   "module": "dist/index.js",