@soulcraft/brainy 3.14.1 → 3.15.0

package/dist/vfs/VirtualFileSystem.js

@@ -247,6 +247,20 @@ export class VirtualFileSystem {
                 data: entityData,
                 metadata
             });
+            // Ensure Contains relationship exists (fix for missing relationships)
+            const existingRelations = await this.brain.getRelations({
+                from: parentId,
+                to: existingId,
+                type: VerbType.Contains
+            });
+            // Create relationship if it doesn't exist
+            if (existingRelations.length === 0) {
+                await this.brain.relate({
+                    from: parentId,
+                    to: existingId,
+                    type: VerbType.Contains
+                });
+            }
         }
         else {
             // Create new file entity
@@ -716,7 +730,11 @@ export class VirtualFileSystem {
     // ============= Helper Methods =============
     async ensureInitialized() {
         if (!this.initialized) {
-            throw new Error('VFS not initialized. Call init() first.');
+            throw new Error('VFS not initialized. You must call await vfs.init() after getting the VFS instance.\n' +
+                'Example:\n' +
+                '  const vfs = brain.vfs()  // Note: vfs() is a method, not a property\n' +
+                '  await vfs.init()         // This creates the root directory\n' +
+                'See docs: https://github.com/Brainy-Technologies/brainy/blob/main/docs/vfs/QUICK_START.md');
         }
     }
     async ensureDirectory(path) {
@@ -732,9 +750,13 @@ export class VirtualFileSystem {
             return entityId;
         }
         catch (err) {
-            // Directory doesn't exist, create it recursively
-            await this.mkdir(path, { recursive: true });
-            return await this.pathResolver.resolve(path);
+            // Only create directory if it doesn't exist (ENOENT error)
+            if (err instanceof VFSError && err.code === VFSErrorCode.ENOENT) {
+                await this.mkdir(path, { recursive: true });
+                return await this.pathResolver.resolve(path);
+            }
+            // Re-throw other errors (like ENOTDIR)
+            throw err;
         }
     }
     async getEntityById(id) {
@@ -2012,7 +2034,13 @@ export class VirtualFileSystem {
             path = `${from}/${path}`;
         }
         // Normalize path
-        return path.replace(/\/+/g, '/').replace(/\/$/, '') || '/';
+        const normalizedPath = path.replace(/\/+/g, '/').replace(/\/$/, '') || '/';
+        // Special case for root
+        if (normalizedPath === '/') {
+            return this.rootEntityId;
+        }
+        // Resolve the path to an entity ID
+        return await this.pathResolver.resolve(normalizedPath);
     }
 }
 //# sourceMappingURL=VirtualFileSystem.js.map

package/package.json

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