@soulcraft/brainy 5.3.5 → 5.3.6

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 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)
 
 

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: {

package/dist/storage/baseStorage.js

@@ -274,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.5",
+  "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",