@soulcraft/brainy 4.3.2 → 4.5.0

package/dist/vfs/VirtualFileSystem.js

@@ -89,15 +89,29 @@ export class VirtualFileSystem {
         }
     }
     async initializeRoot() {
-        // Check if root already exists - search using where clause
+        // FIXED (v4.3.3): Use correct field names in where clause
+        // Metadata index stores flat fields: path, vfsType, name
+        // NOT nested: 'metadata.path', 'metadata.vfsType'
         const existing = await this.brain.find({
+            type: NounType.Collection,
             where: {
-                'metadata.path': '/',
-                'metadata.vfsType': 'directory'
+                path: '/', // ✅ Correct field name
+                vfsType: 'directory' // ✅ Correct field name
             },
-            limit: 1
+            limit: 10,
+            includeVFS: true // v4.4.0: CRITICAL - Must find VFS root entity!
         });
         if (existing.length > 0) {
+            // Handle duplicate roots (Workshop team reported ~10 duplicates!)
+            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)
+                existing.sort((a, b) => {
+                    const aTime = a.metadata?.createdAt || a.metadata?.modified || 0;
+                    const bTime = b.metadata?.createdAt || b.metadata?.modified || 0;
+                    return aTime - bTime;
+                });
+            }
             const rootEntity = existing[0];
             // Ensure the root entity has proper metadata structure
             const entityMetadata = rootEntity.metadata || rootEntity;
@@ -109,6 +123,7 @@ export class VirtualFileSystem {
                         path: '/',
                         name: '',
                         vfsType: 'directory',
+                        isVFS: true, // v4.3.3: Mark as VFS entity
                         size: 0,
                         permissions: 0o755,
                         owner: 'root',
@@ -121,7 +136,7 @@ export class VirtualFileSystem {
             }
             return rootEntity.id;
         }
-        // Create root directory
+        // Create root directory (only if truly doesn't exist)
         const root = await this.brain.add({
             data: '/', // Root directory content as string
             type: NounType.Collection,
@@ -129,12 +144,14 @@ export class VirtualFileSystem {
                 path: '/',
                 name: '',
                 vfsType: 'directory',
+                isVFS: true, // v4.3.3: Mark as VFS entity
                 size: 0,
                 permissions: 0o755,
                 owner: 'root',
                 group: 'root',
                 accessed: Date.now(),
-                modified: Date.now()
+                modified: Date.now(),
+                createdAt: Date.now() // Track creation time for duplicate detection
             }
         });
         return root;
@@ -278,6 +295,7 @@ export class VirtualFileSystem {
             name,
             parent: parentId,
             vfsType: 'file',
+            isVFS: true, // v4.3.3: Mark as VFS entity
             size: buffer.length,
             mimeType,
             extension: this.getExtension(name),
@@ -575,6 +593,7 @@ export class VirtualFileSystem {
                 name,
                 parent: parentId,
                 vfsType: 'directory',
+                isVFS: true, // v4.3.3: Mark as VFS entity
                 size: 0,
                 permissions: options?.mode || this.config.permissions?.defaultDirectory || 0o755,
                 owner: 'user',
@@ -755,7 +774,11 @@ export class VirtualFileSystem {
             type: [NounType.File, NounType.Document, NounType.Media],
             limit: options?.limit || 10,
             offset: options?.offset,
-            explain: options?.explain
+            explain: options?.explain,
+            includeVFS: true, // v4.4.0: VFS search must include VFS entities!
+            where: {
+                vfsType: 'file' // v4.4.0: Only search VFS files, not knowledge documents
+            }
         };
         // Add path filter if specified
         if (options?.path) {
@@ -795,7 +818,11 @@ export class VirtualFileSystem {
             to: entityId,
             limit: options?.limit || 10,
             threshold: options?.threshold || 0.7,
-            type: [NounType.File, NounType.Document, NounType.Media]
+            type: [NounType.File, NounType.Document, NounType.Media],
+            includeVFS: true, // v4.4.0: VFS similarity search must include VFS entities!
+            where: {
+                vfsType: 'file' // v4.4.0: Only find similar VFS files, not knowledge documents
+            }
         });
         return results.map(r => {
             const entity = r.entity;
@@ -1925,7 +1952,8 @@ export class VirtualFileSystem {
                 ...query.where,
                 vfsType: 'entity'
             },
-            limit: query.limit || 100
+            limit: query.limit || 100,
+            includeVFS: true // v4.4.0: VFS entity search must include VFS entities!
         };
         if (query.type) {
             searchQuery.where.entityType = query.type;

package/dist/vfs/semantic/projections/AuthorProjection.js

@@ -27,7 +27,8 @@ export class AuthorProjection extends BaseProjectionStrategy {
                 vfsType: 'file',
                 owner: authorName
             },
-            limit: 1000
+            limit: 1000,
+            includeVFS: true // v4.4.0: Must include VFS entities!
         };
         // Filter by filename if subpath specified
         if (subpath) {
@@ -51,7 +52,8 @@ export class AuthorProjection extends BaseProjectionStrategy {
                 vfsType: 'file',
                 owner: authorName
             },
-            limit: 1000
+            limit: 1000,
+            includeVFS: true // v4.4.0: Must include VFS entities!
         });
         return this.extractIds(results);
     }
@@ -66,7 +68,8 @@ export class AuthorProjection extends BaseProjectionStrategy {
                 vfsType: 'file',
                 owner: { $exists: true }
             },
-            limit
+            limit,
+            includeVFS: true // v4.4.0: Must include VFS entities!
         });
         return results.map(r => r.entity);
     }

package/dist/vfs/semantic/projections/TagProjection.js

@@ -27,7 +27,8 @@ export class TagProjection extends BaseProjectionStrategy {
                 vfsType: 'file',
                 tags: { contains: tagName } // BFO operator for array contains
             },
-            limit: 1000
+            limit: 1000,
+            includeVFS: true // v4.4.0: Must include VFS entities!
         };
         // Filter by filename if subpath specified
         if (subpath) {
@@ -51,7 +52,8 @@ export class TagProjection extends BaseProjectionStrategy {
                 vfsType: 'file',
                 tags: { contains: tagName } // BFO operator
             },
-            limit: 1000
+            limit: 1000,
+            includeVFS: true // v4.4.0: Must include VFS entities!
         });
         return this.extractIds(results);
     }
@@ -65,7 +67,8 @@ export class TagProjection extends BaseProjectionStrategy {
                 vfsType: 'file',
                 tags: { exists: true } // BFO operator
             },
-            limit
+            limit,
+            includeVFS: true // v4.4.0: Must include VFS entities!
         });
         return results.map(r => r.entity);
     }

package/dist/vfs/semantic/projections/TemporalProjection.js

@@ -67,7 +67,8 @@ export class TemporalProjection extends BaseProjectionStrategy {
                     lessEqual: endOfDay.getTime() // BFO operator
                 }
             },
-            limit: 1000
+            limit: 1000,
+            includeVFS: true // v4.4.0: Must include VFS entities!
         });
         return this.extractIds(results);
     }
@@ -81,7 +82,8 @@ export class TemporalProjection extends BaseProjectionStrategy {
                 vfsType: 'file',
                 modified: { greaterEqual: oneDayAgo } // BFO operator
             },
-            limit
+            limit,
+            includeVFS: true // v4.4.0: Must include VFS entities!
         });
         return results.map(r => r.entity);
     }

package/dist/vfs/types.d.ts

@@ -27,6 +27,7 @@ export interface VFSMetadata {
     name: string;
     parent?: string;
     vfsType: 'file' | 'directory' | 'symlink';
+    isVFS?: boolean;
     size: number;
     mimeType?: string;
     extension?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soulcraft/brainy",
-  "version": "4.3.2",
+  "version": "4.5.0",
   "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",