@soulcraft/brainy 5.3.4 → 5.3.6

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 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.
 
+### [5.3.6](https://github.com/soulcraftlabs/brainy/compare/v5.3.5...v5.3.6) (2025-11-05)
+
+
+### 🐛 Bug Fixes
+
+* resolve fork() silent failure on cloud storage adapters ([7977132](https://github.com/soulcraftlabs/brainy/commit/7977132e9f7160af1cb1b9dd1f16f623aa1010f0))
+
+### [5.3.5](https://github.com/soulcraftlabs/brainy/compare/v5.3.4...v5.3.5) (2025-11-05)
+
+
+### 🐛 Bug Fixes
+
+* resolve fork + checkout workflow with COW file listing and branch persistence ([189b1b0](https://github.com/soulcraftlabs/brainy/commit/189b1b05dec4daad28a9ce7e0840ffaaf675ecfa))
+
 ### [5.3.0](https://github.com/soulcraftlabs/brainy/compare/v5.2.1...v5.3.0) (2025-11-04)
 
 - feat: add entity versioning system with critical bug fixes (v5.3.0) (c488fa8)

package/dist/brainy.js

@@ -1884,7 +1884,15 @@ export class Brainy {
             }
             // Step 2: Copy storage ref (COW layer - instant!)
             await refManager.copyRef(currentBranch, branchName);
-            // Step 2: Create new Brainy instance pointing to fork branch
+            // CRITICAL FIX (v5.3.6): Verify branch was actually created to prevent silent failures
+            // Without this check, fork() could complete successfully but branch wouldn't exist,
+            // causing subsequent checkout() calls to fail (see Workshop bug report).
+            const verifyBranch = await refManager.getRef(branchName);
+            if (!verifyBranch) {
+                throw new Error(`Fork failed: Branch '${branchName}' was not created. ` +
+                    `This indicates a storage adapter configuration issue. Please report this bug.`);
+            }
+            // Step 3: Create new Brainy instance pointing to fork branch
             const forkConfig = {
                 ...this.config,
                 storage: {
@@ -1993,14 +2001,19 @@ export class Brainy {
             }
             // Update storage currentBranch
             this.storage.currentBranch = branch;
-            // Reload from new branch
-            // Clear indexes and reload
+            // v5.3.5 fix: Reload indexes from new branch WITHOUT recreating storage
+            // Previous implementation called init() which recreated storage, losing currentBranch
             this.index = this.setupIndex();
             this.metadataIndex = new MetadataIndexManager(this.storage);
+            await this.metadataIndex.init();
             this.graphIndex = new GraphAdjacencyIndex(this.storage);
-            // Re-initialize
-            this.initialized = false;
-            await this.init();
+            // Rebuild indexes from new branch data
+            await this.rebuildIndexesIfNeeded();
+            // Re-initialize VFS for new branch
+            if (this._vfs) {
+                this._vfs = new VirtualFileSystem(this);
+                await this._vfs.init();
+            }
         });
     }
     /**

package/dist/storage/adapters/fileSystemStorage.js

@@ -736,7 +736,10 @@ export class FileSystemStorage extends BaseStorage {
             const entries = await fs.promises.readdir(fullPath, { withFileTypes: true });
             for (const entry of entries) {
                 if (entry.isFile()) {
-                    // Handle both .json and .json.gz files
+                    // v5.3.5: Handle multiple compression formats for broad compatibility
+                    // - .json.gz: Standard entity/metadata files (JSON compressed)
+                    // - .gz: COW files (refs, blobs, commits - raw compressed)
+                    // - .json: Uncompressed JSON files
                     if (entry.name.endsWith('.json.gz')) {
                         // Strip .gz extension and add the .json path
                         const normalizedName = entry.name.slice(0, -3); // Remove .gz
@@ -746,6 +749,16 @@ export class FileSystemStorage extends BaseStorage {
                             seen.add(normalizedPath);
                         }
                     }
+                    else if (entry.name.endsWith('.gz')) {
+                        // v5.3.5 fix: COW files stored as .gz (not .json.gz)
+                        // Strip .gz extension and return path
+                        const normalizedName = entry.name.slice(0, -3); // Remove .gz
+                        const normalizedPath = path.join(prefix, normalizedName);
+                        if (!seen.has(normalizedPath)) {
+                            paths.push(normalizedPath);
+                            seen.add(normalizedPath);
+                        }
+                    }
                     else if (entry.name.endsWith('.json')) {
                         const filePath = path.join(prefix, entry.name);
                         if (!seen.has(filePath)) {
@@ -755,7 +768,8 @@ export class FileSystemStorage extends BaseStorage {
                     }
                 }
                 else if (entry.isDirectory()) {
-                    const subdirPaths = await this.listObjectsUnderPath(path.join(prefix, entry.name));
+                    const subpath = path.join(prefix, entry.name);
+                    const subdirPaths = await this.listObjectsUnderPath(subpath);
                     paths.push(...subdirPaths);
                 }
             }

package/dist/storage/baseStorage.js

@@ -201,11 +201,21 @@ export class BaseStorage extends BaseStorageAdapter {
             },
             list: async (prefix) => {
                 try {
-                    const paths = await this.listObjectsUnderPath(`_cow/${prefix}`);
+                    // v5.3.5 fix: Handle file prefixes, not just directory paths
+                    // Refs are stored as files like: _cow/ref:refs/heads/main
+                    // So list('ref:') should find all files starting with '_cow/ref:'
+                    // List the _cow directory and filter by prefix
+                    const allPaths = await this.listObjectsUnderPath('_cow/');
+                    const filteredPaths = allPaths.filter(p => {
+                        // Remove _cow/ prefix to get the key
+                        const key = p.replace(/^_cow\//, '');
+                        return key.startsWith(prefix);
+                    });
                     // Remove _cow/ prefix and return relative keys
-                    return paths.map(p => p.replace(/^_cow\//, ''));
+                    return filteredPaths.map(p => p.replace(/^_cow\//, ''));
                 }
                 catch (error) {
+                    // If _cow directory doesn't exist yet, return empty array
                     return [];
                 }
             }
@@ -264,6 +274,13 @@ export class BaseStorage extends BaseStorageAdapter {
      * @protected - Available to subclasses for COW implementation
      */
     resolveBranchPath(basePath, branch) {
+        // CRITICAL FIX (v5.3.6): COW metadata (_cow/*) must NEVER be branch-scoped
+        // Refs, commits, and blobs are global metadata with their own internal branching.
+        // Branch-scoping COW paths causes fork() to write refs to wrong locations,
+        // leading to "Branch does not exist" errors on checkout (see Workshop bug report).
+        if (basePath.startsWith('_cow/')) {
+            return basePath; // COW metadata is global across all branches
+        }
         if (!this.cowEnabled) {
             return basePath; // COW disabled, use direct path
         }

package/package.json

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