@soulcraft/brainy 5.6.0 → 5.6.1

package/CHANGELOG.md

@@ -2,6 +2,38 @@
 
 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.6.1](https://github.com/soulcraftlabs/brainy/compare/v5.6.0...v5.6.1) (2025-11-11)
+
+### 🐛 Bug Fixes
+
+* **storage**: Fix `clear()` not deleting COW version control data ([#workshop-bug-report](https://github.com/soulcraftlabs/brainy/issues))
+  - Fixed all storage adapters to properly delete `_cow/` directory on clear()
+  - Fixed in-memory entity counters not being reset after clear()
+  - Prevents COW reinitialization after clear() by setting `cowEnabled = false`
+  - **Impact**: Resolves storage persistence bug (103MB → 0 bytes after clear)
+  - **Affected adapters**: FileSystemStorage, OPFSStorage, S3CompatibleStorage (GCSStorage, R2Storage, AzureBlobStorage already correct)
+
+### 📝 Technical Details
+
+* **Root causes identified**:
+  1. `_cow/` directory contents deleted but directory not removed
+  2. In-memory counters (`totalNounCount`, `totalVerbCount`) not reset
+  3. COW could auto-reinitialize on next operation
+* **Fixes applied**:
+  - FileSystemStorage: Use `fs.rm()` to delete entire `_cow/` directory
+  - OPFSStorage: Use `removeEntry('_cow', {recursive: true})`
+  - Cloud adapters: Already use `deleteObjectsWithPrefix('_cow/')`
+  - All adapters: Reset `totalNounCount = 0` and `totalVerbCount = 0`
+  - BaseStorage: Added guard in `initializeCOW()` to prevent reinitialization when `cowEnabled === false`
+
+## [5.6.0](https://github.com/soulcraftlabs/brainy/compare/v5.5.0...v5.6.0) (2025-11-11)
+
+### 🐛 Bug Fixes
+
+* **relations**: Fix `getRelations()` returning empty array for fresh instances
+  - Resolved initialization race condition in relationship loading
+  - Fresh Brain instances now correctly load persisted relationships
+
 ## [5.5.0](https://github.com/soulcraftlabs/brainy/compare/v5.4.0...v5.5.0) (2025-11-06)
 
 ### 🎯 Stage 3 CANONICAL Taxonomy - Complete Coverage

package/dist/storage/adapters/azureBlobStorage.js

@@ -851,12 +851,21 @@ export class AzureBlobStorage extends BaseStorage {
         try {
             this.logger.info('🧹 Clearing all data from Azure container...');
             // Delete all blobs in container
+            // v5.6.1: listBlobsFlat() returns ALL blobs including _cow/ prefix
+            // This correctly deletes COW version control data (commits, trees, blobs, refs)
             for await (const blob of this.containerClient.listBlobsFlat()) {
                 if (blob.name) {
                     const blockBlobClient = this.containerClient.getBlockBlobClient(blob.name);
                     await blockBlobClient.delete();
                 }
             }
+            // CRITICAL: Reset COW state to prevent automatic reinitialization
+            // When COW data is cleared, we must also clear the COW managers
+            // Otherwise initializeCOW() will auto-recreate initial commit on next operation
+            this.refManager = undefined;
+            this.blobStorage = undefined;
+            this.commitLog = undefined;
+            this.cowEnabled = false;
             // Clear caches
             this.nounCacheManager.clear();
             this.verbCacheManager.clear();

package/dist/storage/adapters/fileSystemStorage.js

@@ -874,9 +874,26 @@ export class FileSystemStorage extends BaseStorage {
         if (await this.directoryExists(this.indexDir)) {
             await removeDirectoryContents(this.indexDir);
         }
+        // v5.6.1: Remove COW (copy-on-write) version control data
+        // This directory stores all git-like versioning data (commits, trees, blobs, refs)
+        // Must be deleted to fully clear all data including version history
+        const cowDir = path.join(this.rootDir, '_cow');
+        if (await this.directoryExists(cowDir)) {
+            // Delete the entire _cow/ directory (not just contents)
+            await fs.promises.rm(cowDir, { recursive: true, force: true });
+            // CRITICAL: Reset COW state to prevent automatic reinitialization
+            // When COW data is cleared, we must also clear the COW managers
+            // Otherwise initializeCOW() will auto-recreate initial commit on next operation
+            this.refManager = undefined;
+            this.blobStorage = undefined;
+            this.commitLog = undefined;
+            this.cowEnabled = false;
+        }
         // Clear the statistics cache
         this.statisticsCache = null;
         this.statisticsModified = false;
+        this.totalNounCount = 0;
+        this.totalVerbCount = 0;
     }
     /**
      * Enhanced clear operation with safety mechanisms and performance optimizations

package/dist/storage/adapters/gcsStorage.js

@@ -778,6 +778,17 @@ export class GcsStorage extends BaseStorage {
             await deleteObjectsWithPrefix(this.metadataPrefix);
             await deleteObjectsWithPrefix(this.verbMetadataPrefix);
             await deleteObjectsWithPrefix(this.systemPrefix);
+            // v5.6.1: Clear COW (copy-on-write) version control data
+            // This includes all git-like versioning data (commits, trees, blobs, refs)
+            // Must be deleted to fully clear all data including version history
+            await deleteObjectsWithPrefix('_cow/');
+            // CRITICAL: Reset COW state to prevent automatic reinitialization
+            // When COW data is cleared, we must also clear the COW managers
+            // Otherwise initializeCOW() will auto-recreate initial commit on next operation
+            this.refManager = undefined;
+            this.blobStorage = undefined;
+            this.commitLog = undefined;
+            this.cowEnabled = false;
             // Clear caches
             this.nounCacheManager.clear();
             this.verbCacheManager.clear();

package/dist/storage/adapters/opfsStorage.js

@@ -387,9 +387,31 @@ export class OPFSStorage extends BaseStorage {
             await removeDirectoryContents(this.verbMetadataDir);
             // Remove all files in the index directory
             await removeDirectoryContents(this.indexDir);
+            // v5.6.1: Remove COW (copy-on-write) version control data
+            // This directory stores all git-like versioning data (commits, trees, blobs, refs)
+            // Must be deleted to fully clear all data including version history
+            try {
+                // Delete the entire _cow/ directory (not just contents)
+                await this.rootDir.removeEntry('_cow', { recursive: true });
+                // CRITICAL: Reset COW state to prevent automatic reinitialization
+                // When COW data is cleared, we must also clear the COW managers
+                // Otherwise initializeCOW() will auto-recreate initial commit on next operation
+                this.refManager = undefined;
+                this.blobStorage = undefined;
+                this.commitLog = undefined;
+                this.cowEnabled = false;
+            }
+            catch (error) {
+                // Ignore if _cow directory doesn't exist (not all instances use COW)
+                if (error.name !== 'NotFoundError') {
+                    throw error;
+                }
+            }
             // Clear the statistics cache
             this.statisticsCache = null;
             this.statisticsModified = false;
+            this.totalNounCount = 0;
+            this.totalVerbCount = 0;
         }
         catch (error) {
             console.error('Error clearing storage:', error);

package/dist/storage/adapters/r2Storage.js

@@ -771,13 +771,22 @@ export class R2Storage extends BaseStorage {
     async clear() {
         await this.ensureInitialized();
         prodLog.info('🧹 R2: Clearing all data from bucket...');
-        // Clear all prefixes
-        for (const prefix of [this.nounPrefix, this.verbPrefix, this.metadataPrefix, this.verbMetadataPrefix, this.systemPrefix]) {
+        // Clear all prefixes (v5.6.1: includes _cow/ for version control data)
+        // _cow/ stores all git-like versioning data (commits, trees, blobs, refs)
+        // Must be deleted to fully clear all data including version history
+        for (const prefix of [this.nounPrefix, this.verbPrefix, this.metadataPrefix, this.verbMetadataPrefix, this.systemPrefix, '_cow/']) {
             const objects = await this.listObjectsUnderPath(prefix);
             for (const key of objects) {
                 await this.deleteObjectFromPath(key);
             }
         }
+        // CRITICAL: Reset COW state to prevent automatic reinitialization
+        // When COW data is cleared, we must also clear the COW managers
+        // Otherwise initializeCOW() will auto-recreate initial commit on next operation
+        this.refManager = undefined;
+        this.blobStorage = undefined;
+        this.commitLog = undefined;
+        this.cowEnabled = false;
         this.nounCacheManager.clear();
         this.verbCacheManager.clear();
         this.totalNounCount = 0;

package/dist/storage/adapters/s3CompatibleStorage.js

@@ -1621,9 +1621,22 @@ export class S3CompatibleStorage extends BaseStorage {
             await deleteObjectsWithPrefix(this.verbMetadataPrefix);
             // Delete all objects in the index directory
             await deleteObjectsWithPrefix(this.indexPrefix);
+            // v5.6.1: Delete COW (copy-on-write) version control data
+            // This includes all git-like versioning data (commits, trees, blobs, refs)
+            // Must be deleted to fully clear all data including version history
+            await deleteObjectsWithPrefix('_cow/');
+            // CRITICAL: Reset COW state to prevent automatic reinitialization
+            // When COW data is cleared, we must also clear the COW managers
+            // Otherwise initializeCOW() will auto-recreate initial commit on next operation
+            this.refManager = undefined;
+            this.blobStorage = undefined;
+            this.commitLog = undefined;
+            this.cowEnabled = false;
             // Clear the statistics cache
             this.statisticsCache = null;
             this.statisticsModified = false;
+            this.totalNounCount = 0;
+            this.totalVerbCount = 0;
         }
         catch (error) {
             prodLog.error('Failed to clear storage:', error);

package/dist/storage/baseStorage.js

@@ -203,6 +203,11 @@ export class BaseStorage extends BaseStorageAdapter {
      * @returns Promise that resolves when COW is initialized
      */
     async initializeCOW(options) {
+        // v5.6.1: If COW was explicitly disabled (e.g., via clear()), don't reinitialize
+        // This prevents automatic recreation of COW data after clear() operations
+        if (this.cowEnabled === false) {
+            return;
+        }
         // Check if RefManager already initialized (full COW setup complete)
         if (this.refManager) {
             return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soulcraft/brainy",
-  "version": "5.6.0",
+  "version": "5.6.1",
   "description": "Universal Knowledge Protocol™ - World's first Triple Intelligence database unifying vector, graph, and document search in one API. Stage 3 CANONICAL: 42 nouns × 127 verbs covering 96-97% of all human knowledge.",
   "main": "dist/index.js",
   "module": "dist/index.js",