@soulcraft/brainy 3.20.0 → 3.20.2

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+### [3.20.2](https://github.com/soulcraftlabs/brainy/compare/v3.20.1...v3.20.2) (2025-09-30)
+
+### Bug Fixes
+
+* **vfs**: resolve VFS race conditions and decompression errors ([1a2661f](https://github.com/soulcraftlabs/brainy/commit/1a2661f))
+  - Fixes duplicate directory nodes caused by concurrent writes
+  - Fixes file read decompression errors caused by rawData compression state mismatch
+  - Adds mutex-based concurrency control for mkdir operations
+  - Adds explicit compression tracking for file reads
+
 ### [3.19.1](https://github.com/soulcraftlabs/brainy/compare/v3.19.0...v3.19.1) (2025-09-29)
 
 ## [3.19.0](https://github.com/soulcraftlabs/brainy/compare/v3.18.0...v3.19.0) (2025-09-29)

package/dist/cli/commands/conversation.js

@@ -250,6 +250,8 @@ main()
         });
         await brain.init();
         spinner.succeed('Initialized Brainy database');
+        // Shutdown Brainy to release resources
+        await brain.close();
         // Success!
         console.log(chalk.bold.green('\n✅ Setup complete!\n'));
         console.log(chalk.cyan('📁 Memory storage:'), brainyDir);
@@ -367,6 +369,7 @@ async function handleSearch(argv) {
     spinner.succeed(`Found ${results.length} messages`);
     if (results.length === 0) {
         console.log(chalk.yellow('No messages found'));
+        await brain.close();
         return;
     }
     // Display results
@@ -376,6 +379,7 @@ async function handleSearch(argv) {
         console.log(chalk.dim(`  Score: ${result.score.toFixed(3)} | Conv: ${result.conversationId}`));
         console.log();
     }
+    await brain.close();
 }
 /**
  * Handle context command - Get relevant context
@@ -398,6 +402,7 @@ async function handleContext(argv) {
     spinner.succeed(`Retrieved ${context.messages.length} relevant messages`);
     if (context.messages.length === 0) {
         console.log(chalk.yellow('No relevant context found'));
+        await brain.close();
         return;
     }
     // Display context
@@ -420,6 +425,7 @@ async function handleContext(argv) {
             console.log(chalk.dim(`  - ${conv.title || conv.id} (${conv.relevance.toFixed(2)})`));
         }
     }
+    await brain.close();
 }
 /**
  * Handle thread command - Get conversation thread
@@ -452,6 +458,7 @@ async function handleThread(argv) {
         console.log(chalk.cyan(`${msg.role}:`), msg.content);
         console.log(chalk.dim(`  ${new Date(msg.createdAt).toLocaleString()}`));
     }
+    await brain.close();
 }
 /**
  * Handle stats command - Show statistics
@@ -487,6 +494,7 @@ async function handleStats(argv) {
             console.log(chalk.dim(`  ${phase}: ${count}`));
         }
     }
+    await brain.close();
 }
 /**
  * Handle export command - Export conversation
@@ -505,6 +513,7 @@ async function handleExport(argv) {
     const output = argv.output || `conversation_${argv.conversationId}.json`;
     await fs.writeFile(output, JSON.stringify(exported, null, 2), 'utf8');
     spinner.succeed(`Exported to ${output}`);
+    await brain.close();
 }
 /**
  * Handle import command - Import conversation
@@ -523,6 +532,7 @@ async function handleImport(argv) {
     const data = JSON.parse(await fs.readFile(inputFile, 'utf8'));
     const conversationId = await conv.importConversation(data);
     spinner.succeed(`Imported as conversation ${conversationId}`);
+    await brain.close();
 }
 export default conversationCommand;
 //# sourceMappingURL=conversation.js.map

package/dist/vfs/VirtualFileSystem.d.ts

@@ -28,6 +28,7 @@ export declare class VirtualFileSystem implements IVirtualFileSystem {
     private statCache;
     private watchers;
     private backgroundTimer;
+    private mkdirLocks;
     constructor(brain?: Brainy);
     /**
      * Initialize the VFS

package/dist/vfs/VirtualFileSystem.js

@@ -25,6 +25,8 @@ export class VirtualFileSystem {
         this.currentUser = 'system'; // Track current user for collaboration
         // Background task timer
         this.backgroundTimer = null;
+        // Mutex for preventing race conditions in directory creation
+        this.mkdirLocks = new Map();
         this.brain = brain || new Brainy();
         this.contentCache = new Map();
         this.statCache = new Map();
@@ -159,16 +161,20 @@ export class VirtualFileSystem {
         }
         // Get content based on storage type
         let content;
+        let isCompressed = false;
         if (!entity.metadata.storage || entity.metadata.storage.type === 'inline') {
             // Content stored in metadata for new files, or try entity data for compatibility
             if (entity.metadata.rawData) {
+                // rawData is ALWAYS stored uncompressed as base64
                 content = Buffer.from(entity.metadata.rawData, 'base64');
+                isCompressed = false; // rawData is never compressed
             }
             else if (!entity.data) {
                 content = Buffer.alloc(0);
             }
             else if (Buffer.isBuffer(entity.data)) {
                 content = entity.data;
+                isCompressed = entity.metadata.storage?.compressed || false;
             }
             else if (typeof entity.data === 'string') {
                 content = Buffer.from(entity.data);
@@ -180,16 +186,18 @@ export class VirtualFileSystem {
         else if (entity.metadata.storage.type === 'reference') {
             // Content stored in external storage
             content = await this.readExternalContent(entity.metadata.storage.key);
+            isCompressed = entity.metadata.storage.compressed || false;
         }
         else if (entity.metadata.storage.type === 'chunked') {
             // Content stored in chunks
             content = await this.readChunkedContent(entity.metadata.storage.chunks);
+            isCompressed = entity.metadata.storage.compressed || false;
         }
         else {
             throw new VFSError(VFSErrorCode.EIO, `Unknown storage type: ${entity.metadata.storage.type}`, path, 'readFile');
         }
-        // Decompress if needed
-        if (entity.metadata.storage?.compressed && options?.decompress !== false) {
+        // Decompress if needed (but NOT for rawData which is never compressed)
+        if (isCompressed && options?.decompress !== false) {
             content = await this.decompress(content);
         }
         // Update access time
@@ -317,7 +325,7 @@ export class VirtualFileSystem {
                 type: this.getFileNounType(mimeType),
                 metadata
             });
-            // Create parent-child relationship
+            // Create parent-child relationship (no need to check for duplicates on new entities)
             await this.brain.relate({
                 from: parentId,
                 to: entity,
@@ -498,78 +506,106 @@ export class VirtualFileSystem {
      */
     async mkdir(path, options) {
         await this.ensureInitialized();
-        // Check if already exists
-        try {
-            const existing = await this.pathResolver.resolve(path);
-            const entity = await this.getEntityById(existing);
-            if (entity.metadata.vfsType === 'directory') {
-                if (!options?.recursive) {
-                    throw new VFSError(VFSErrorCode.EEXIST, `Directory exists: ${path}`, path, 'mkdir');
+        // Use mutex to prevent race conditions when creating the same directory concurrently
+        // If another call is already creating this directory, wait for it to complete
+        const existingLock = this.mkdirLocks.get(path);
+        if (existingLock) {
+            await existingLock;
+            // After waiting, check if directory now exists
+            try {
+                const existing = await this.pathResolver.resolve(path);
+                const entity = await this.getEntityById(existing);
+                if (entity.metadata.vfsType === 'directory') {
+                    return; // Directory was created by the other call
                 }
-                return; // Already exists and recursive is true
             }
-            else {
-                // Path exists but it's not a directory
-                throw new VFSError(VFSErrorCode.EEXIST, `File exists: ${path}`, path, 'mkdir');
-            }
-        }
-        catch (err) {
-            // Only proceed if it's a ENOENT error (path doesn't exist)
-            if (err instanceof VFSError && err.code !== VFSErrorCode.ENOENT) {
-                throw err; // Re-throw non-ENOENT errors
+            catch (err) {
+                // Still doesn't exist, proceed to create
             }
-            // Doesn't exist, proceed to create
         }
-        // Parse path
-        const parentPath = this.getParentPath(path);
-        const name = this.getBasename(path);
-        // Ensure parent exists (recursive mkdir if needed)
-        let parentId;
-        if (parentPath === '/' || parentPath === null) {
-            parentId = this.rootEntityId;
-        }
-        else if (options?.recursive) {
-            parentId = await this.ensureDirectory(parentPath);
-        }
-        else {
+        // Create a lock promise for this path
+        let resolveLock;
+        const lockPromise = new Promise(resolve => { resolveLock = resolve; });
+        this.mkdirLocks.set(path, lockPromise);
+        try {
+            // Check if already exists
             try {
-                parentId = await this.pathResolver.resolve(parentPath);
+                const existing = await this.pathResolver.resolve(path);
+                const entity = await this.getEntityById(existing);
+                if (entity.metadata.vfsType === 'directory') {
+                    if (!options?.recursive) {
+                        throw new VFSError(VFSErrorCode.EEXIST, `Directory exists: ${path}`, path, 'mkdir');
+                    }
+                    return; // Already exists and recursive is true
+                }
+                else {
+                    // Path exists but it's not a directory
+                    throw new VFSError(VFSErrorCode.EEXIST, `File exists: ${path}`, path, 'mkdir');
+                }
             }
             catch (err) {
-                throw new VFSError(VFSErrorCode.ENOENT, `Parent directory not found: ${parentPath}`, path, 'mkdir');
+                // Only proceed if it's a ENOENT error (path doesn't exist)
+                if (err instanceof VFSError && err.code !== VFSErrorCode.ENOENT) {
+                    throw err; // Re-throw non-ENOENT errors
+                }
+                // Doesn't exist, proceed to create
             }
-        }
-        // Create directory entity
-        const metadata = {
-            path,
-            name,
-            parent: parentId,
-            vfsType: 'directory',
-            size: 0,
-            permissions: options?.mode || this.config.permissions?.defaultDirectory || 0o755,
-            owner: 'user',
-            group: 'users',
-            accessed: Date.now(),
-            modified: Date.now(),
-            ...options?.metadata
-        };
-        const entity = await this.brain.add({
-            data: path, // Directory path as string content
-            type: NounType.Collection,
-            metadata
-        });
-        // Create parent-child relationship
-        if (parentId !== entity) { // Don't relate to self (root)
-            await this.brain.relate({
-                from: parentId,
-                to: entity,
-                type: VerbType.Contains
+            // Parse path
+            const parentPath = this.getParentPath(path);
+            const name = this.getBasename(path);
+            // Ensure parent exists (recursive mkdir if needed)
+            let parentId;
+            if (parentPath === '/' || parentPath === null) {
+                parentId = this.rootEntityId;
+            }
+            else if (options?.recursive) {
+                parentId = await this.ensureDirectory(parentPath);
+            }
+            else {
+                try {
+                    parentId = await this.pathResolver.resolve(parentPath);
+                }
+                catch (err) {
+                    throw new VFSError(VFSErrorCode.ENOENT, `Parent directory not found: ${parentPath}`, path, 'mkdir');
+                }
+            }
+            // Create directory entity
+            const metadata = {
+                path,
+                name,
+                parent: parentId,
+                vfsType: 'directory',
+                size: 0,
+                permissions: options?.mode || this.config.permissions?.defaultDirectory || 0o755,
+                owner: 'user',
+                group: 'users',
+                accessed: Date.now(),
+                modified: Date.now(),
+                ...options?.metadata
+            };
+            const entity = await this.brain.add({
+                data: path, // Directory path as string content
+                type: NounType.Collection,
+                metadata
             });
+            // Create parent-child relationship (no need to check for duplicates on new entities)
+            if (parentId !== entity) { // Don't relate to self (root)
+                await this.brain.relate({
+                    from: parentId,
+                    to: entity,
+                    type: VerbType.Contains
+                });
+            }
+            // Update path resolver cache
+            await this.pathResolver.createPath(path, entity);
+            // Trigger watchers
+            this.triggerWatchers(path, 'rename');
+        }
+        finally {
+            // Release the lock
+            resolveLock();
+            this.mkdirLocks.delete(path);
         }
-        // Update path resolver cache
-        await this.pathResolver.createPath(path, entity);
-        // Trigger watchers
-        this.triggerWatchers(path, 'rename');
     }
     /**
      * Remove a directory
@@ -1964,17 +2000,20 @@ export class VirtualFileSystem {
         };
         let earliestModified = null;
         let latestModified = null;
-        const traverse = async (currentPath) => {
+        const traverse = async (currentPath, isRoot = false) => {
             try {
                 const entityId = await this.pathResolver.resolve(currentPath);
                 const entity = await this.getEntityById(entityId);
                 if (entity.metadata.vfsType === 'directory') {
-                    stats.directoryCount++;
+                    // Don't count the root/starting directory itself
+                    if (!isRoot) {
+                        stats.directoryCount++;
+                    }
                     // Traverse children
                     const children = await this.readdir(currentPath);
                     for (const child of children) {
                         const childPath = currentPath === '/' ? `/${child}` : `${currentPath}/${child}`;
-                        await traverse(childPath);
+                        await traverse(childPath, false);
                     }
                 }
                 else if (entity.metadata.vfsType === 'file') {
@@ -2005,7 +2044,7 @@ export class VirtualFileSystem {
                 // Skip if path doesn't exist
             }
         };
-        await traverse(path);
+        await traverse(path, true);
         // Calculate averages
         if (stats.fileCount > 0) {
             stats.averageFileSize = Math.round(stats.totalSize / stats.fileCount);

package/package.json

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