@soulcraft/brainy 5.10.4 → 5.11.1

package/dist/storage/adapters/azureBlobStorage.js

@@ -859,18 +859,11 @@ export class AzureBlobStorage extends BaseStorage {
                     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
+            // v5.11.0: Reset COW managers (but don't disable COW - it's always enabled)
+            // COW will re-initialize automatically on next use
             this.refManager = undefined;
             this.blobStorage = undefined;
             this.commitLog = undefined;
-            this.cowEnabled = false;
-            // v5.10.4: Create persistent marker blob (CRITICAL FIX)
-            // Bug: cowEnabled = false only affects current instance, not future instances
-            // Fix: Create marker blob that persists across instance restarts
-            // When new instance calls initializeCOW(), it checks for this marker
-            await this.createClearMarker();
             // Clear caches
             this.nounCacheManager.clear();
             this.verbCacheManager.clear();
@@ -919,39 +912,10 @@ export class AzureBlobStorage extends BaseStorage {
      * @returns true if marker blob exists, false otherwise
      * @protected
      */
-    async checkClearMarker() {
-        await this.ensureInitialized();
-        try {
-            const markerPath = `${this.systemPrefix}cow-disabled`;
-            const blockBlobClient = this.containerClient.getBlockBlobClient(markerPath);
-            const exists = await blockBlobClient.exists();
-            return exists;
-        }
-        catch (error) {
-            this.logger.warn('AzureBlobStorage.checkClearMarker: Error checking marker', error);
-            return false;
-        }
-    }
     /**
-     * Create marker indicating COW has been explicitly disabled
-     * v5.10.4: Called by clear() to prevent COW reinitialization on new instances
-     * @protected
+     * v5.11.0: Removed checkClearMarker() and createClearMarker() methods
+     * COW is now always enabled - marker files are no longer used
      */
-    async createClearMarker() {
-        await this.ensureInitialized();
-        try {
-            const markerPath = `${this.systemPrefix}cow-disabled`;
-            const blockBlobClient = this.containerClient.getBlockBlobClient(markerPath);
-            // Create empty marker blob
-            await blockBlobClient.upload(Buffer.from(''), 0, {
-                blobHTTPHeaders: { blobContentType: 'text/plain' }
-            });
-        }
-        catch (error) {
-            this.logger.error('AzureBlobStorage.createClearMarker: Failed to create marker blob', error);
-            // Don't throw - marker creation failure shouldn't break clear()
-        }
-    }
     /**
      * Save statistics data to storage
      */

package/dist/storage/adapters/fileSystemStorage.d.ts

@@ -177,13 +177,10 @@ export declare class FileSystemStorage extends BaseStorage {
      * @returns true if marker file exists, false otherwise
      * @protected
      */
-    protected checkClearMarker(): Promise<boolean>;
     /**
-     * Create marker indicating COW has been explicitly disabled
-     * v5.10.4: Called by clear() to prevent COW reinitialization on new instances
-     * @protected
+     * v5.11.0: Removed checkClearMarker() and createClearMarker() methods
+     * COW is now always enabled - marker files are no longer used
      */
-    protected createClearMarker(): Promise<void>;
     /**
      * Get information about storage usage and capacity
      */

package/dist/storage/adapters/fileSystemStorage.js

@@ -878,18 +878,11 @@ export class FileSystemStorage extends BaseStorage {
         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
+            // v5.11.0: Reset COW managers (but don't disable COW - it's always enabled)
+            // COW will re-initialize automatically on next use
             this.refManager = undefined;
             this.blobStorage = undefined;
             this.commitLog = undefined;
-            this.cowEnabled = false;
-            // v5.10.4: Create persistent marker file (CRITICAL FIX)
-            // Bug: cowEnabled = false only affects current instance, not future instances
-            // Fix: Create marker file that persists across instance restarts
-            // When new instance calls initializeCOW(), it checks for this marker
-            await this.createClearMarker();
         }
         // Clear the statistics cache
         this.statisticsCache = null;
@@ -923,41 +916,10 @@ export class FileSystemStorage extends BaseStorage {
      * @returns true if marker file exists, false otherwise
      * @protected
      */
-    async checkClearMarker() {
-        // Check if fs module is available
-        if (!fs || !fs.promises) {
-            return false;
-        }
-        try {
-            const markerPath = path.join(this.systemDir, 'cow-disabled');
-            await fs.promises.access(markerPath, fs.constants.F_OK);
-            return true; // Marker exists
-        }
-        catch (error) {
-            return false; // Marker doesn't exist (ENOENT) or can't be accessed
-        }
-    }
     /**
-     * Create marker indicating COW has been explicitly disabled
-     * v5.10.4: Called by clear() to prevent COW reinitialization on new instances
-     * @protected
+     * v5.11.0: Removed checkClearMarker() and createClearMarker() methods
+     * COW is now always enabled - marker files are no longer used
      */
-    async createClearMarker() {
-        // Check if fs module is available
-        if (!fs || !fs.promises) {
-            console.warn('FileSystemStorage.createClearMarker: fs module not available, skipping marker creation');
-            return;
-        }
-        try {
-            const markerPath = path.join(this.systemDir, 'cow-disabled');
-            // Create empty marker file
-            await fs.promises.writeFile(markerPath, '', 'utf8');
-        }
-        catch (error) {
-            console.error('FileSystemStorage.createClearMarker: Failed to create marker file', error);
-            // Don't throw - marker creation failure shouldn't break clear()
-        }
-    }
     /**
      * Get information about storage usage and capacity
      */

package/dist/storage/adapters/gcsStorage.d.ts

@@ -234,13 +234,10 @@ export declare class GcsStorage extends BaseStorage {
      * @returns true if marker object exists, false otherwise
      * @protected
      */
-    protected checkClearMarker(): Promise<boolean>;
     /**
-     * Create marker indicating COW has been explicitly disabled
-     * v5.10.4: Called by clear() to prevent COW reinitialization on new instances
-     * @protected
+     * v5.11.0: Removed checkClearMarker() and createClearMarker() methods
+     * COW is now always enabled - marker files are no longer used
      */
-    protected createClearMarker(): Promise<void>;
     /**
      * Save statistics data to storage
      */

package/dist/storage/adapters/gcsStorage.js

@@ -772,28 +772,18 @@ export class GcsStorage extends BaseStorage {
                     await file.delete();
                 }
             };
-            // Clear all data directories
-            await deleteObjectsWithPrefix(this.nounPrefix);
-            await deleteObjectsWithPrefix(this.verbPrefix);
-            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
+            // v5.11.0: Clear ALL data using correct paths
+            // Delete entire branches/ directory (includes ALL entities, ALL types, ALL VFS data, ALL forks)
+            await deleteObjectsWithPrefix('branches/');
+            // Delete COW version control data
             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
+            // Delete system metadata
+            await deleteObjectsWithPrefix('_system/');
+            // v5.11.0: Reset COW managers (but don't disable COW - it's always enabled)
+            // COW will re-initialize automatically on next use
             this.refManager = undefined;
             this.blobStorage = undefined;
             this.commitLog = undefined;
-            this.cowEnabled = false;
-            // v5.10.4: Create persistent marker object (CRITICAL FIX)
-            // Bug: cowEnabled = false only affects current instance, not future instances
-            // Fix: Create marker object that persists across instance restarts
-            // When new instance calls initializeCOW(), it checks for this marker
-            await this.createClearMarker();
             // Clear caches
             this.nounCacheManager.clear();
             this.verbCacheManager.clear();
@@ -845,37 +835,10 @@ export class GcsStorage extends BaseStorage {
      * @returns true if marker object exists, false otherwise
      * @protected
      */
-    async checkClearMarker() {
-        await this.ensureInitialized();
-        try {
-            const markerPath = `${this.systemPrefix}cow-disabled`;
-            const file = this.bucket.file(markerPath);
-            const [exists] = await file.exists();
-            return exists;
-        }
-        catch (error) {
-            this.logger.warn('GCSStorage.checkClearMarker: Error checking marker', error);
-            return false;
-        }
-    }
     /**
-     * Create marker indicating COW has been explicitly disabled
-     * v5.10.4: Called by clear() to prevent COW reinitialization on new instances
-     * @protected
+     * v5.11.0: Removed checkClearMarker() and createClearMarker() methods
+     * COW is now always enabled - marker files are no longer used
      */
-    async createClearMarker() {
-        await this.ensureInitialized();
-        try {
-            const markerPath = `${this.systemPrefix}cow-disabled`;
-            const file = this.bucket.file(markerPath);
-            // Create empty marker object
-            await file.save('', { contentType: 'text/plain' });
-        }
-        catch (error) {
-            this.logger.error('GCSStorage.createClearMarker: Failed to create marker object', error);
-            // Don't throw - marker creation failure shouldn't break clear()
-        }
-    }
     /**
      * Save statistics data to storage
      */

package/dist/storage/adapters/historicalStorageAdapter.d.ts

@@ -107,13 +107,10 @@ export declare class HistoricalStorageAdapter extends BaseStorage {
      * @returns Always false (read-only adapter doesn't manage COW state)
      * @protected
      */
-    protected checkClearMarker(): Promise<boolean>;
     /**
-     * Create marker indicating COW has been explicitly disabled
-     * v5.10.4: No-op for HistoricalStorageAdapter (read-only)
-     * @protected
+     * v5.11.0: Removed checkClearMarker() and createClearMarker() methods
+     * COW is now always enabled - marker files are no longer used
      */
-    protected createClearMarker(): Promise<void>;
     /**
      * WRITE BLOCKED: Historical storage is read-only
      */

package/dist/storage/adapters/historicalStorageAdapter.js

@@ -232,17 +232,10 @@ export class HistoricalStorageAdapter extends BaseStorage {
      * @returns Always false (read-only adapter doesn't manage COW state)
      * @protected
      */
-    async checkClearMarker() {
-        return false; // Read-only adapter - COW state managed by underlying storage
-    }
     /**
-     * Create marker indicating COW has been explicitly disabled
-     * v5.10.4: No-op for HistoricalStorageAdapter (read-only)
-     * @protected
+     * v5.11.0: Removed checkClearMarker() and createClearMarker() methods
+     * COW is now always enabled - marker files are no longer used
      */
-    async createClearMarker() {
-        // No-op: HistoricalStorageAdapter is read-only, doesn't create markers
-    }
     // ============= Override Write Methods (Read-Only) =============
     /**
      * WRITE BLOCKED: Historical storage is read-only

package/dist/storage/adapters/memoryStorage.d.ts

@@ -85,13 +85,10 @@ export declare class MemoryStorage extends BaseStorage {
      * @returns Always false (marker doesn't persist in memory)
      * @protected
      */
-    protected checkClearMarker(): Promise<boolean>;
     /**
-     * Create marker indicating COW has been explicitly disabled
-     * v5.10.4: No-op for MemoryStorage (doesn't persist)
-     * @protected
+     * v5.11.0: Removed checkClearMarker() and createClearMarker() methods
+     * COW is now always enabled - marker files are no longer used
      */
-    protected createClearMarker(): Promise<void>;
     /**
      * Save statistics data to storage
      * @param statistics The statistics data to save

package/dist/storage/adapters/memoryStorage.js

@@ -164,18 +164,10 @@ export class MemoryStorage extends BaseStorage {
      * @returns Always false (marker doesn't persist in memory)
      * @protected
      */
-    async checkClearMarker() {
-        return false; // MemoryStorage doesn't persist - marker doesn't survive restart
-    }
     /**
-     * Create marker indicating COW has been explicitly disabled
-     * v5.10.4: No-op for MemoryStorage (doesn't persist)
-     * @protected
+     * v5.11.0: Removed checkClearMarker() and createClearMarker() methods
+     * COW is now always enabled - marker files are no longer used
      */
-    async createClearMarker() {
-        // No-op: MemoryStorage doesn't persist, so marker is not needed
-        // clear() in memory already resets all state, no marker survives restart
-    }
     /**
      * Save statistics data to storage
      * @param statistics The statistics data to save

package/dist/storage/adapters/opfsStorage.d.ts

@@ -100,13 +100,10 @@ export declare class OPFSStorage extends BaseStorage {
      * @returns true if marker file exists, false otherwise
      * @protected
      */
-    protected checkClearMarker(): Promise<boolean>;
     /**
-     * Create marker indicating COW has been explicitly disabled
-     * v5.10.4: Called by clear() to prevent COW reinitialization on new instances
-     * @protected
+     * v5.11.0: Removed checkClearMarker() and createClearMarker() methods
+     * COW is now always enabled - marker files are no longer used
      */
-    protected createClearMarker(): Promise<void>;
     private quotaWarningThreshold;
     private quotaCriticalThreshold;
     private lastQuotaCheck;

package/dist/storage/adapters/opfsStorage.js

@@ -42,6 +42,16 @@ export class OPFSStorage extends BaseStorage {
         this.statistics = null;
         this.activeLocks = new Set();
         this.lockPrefix = 'opfs-lock-';
+        /**
+         * Check if COW has been explicitly disabled via clear()
+         * v5.10.4: Fixes bug where clear() doesn't persist across instance restarts
+         * @returns true if marker file exists, false otherwise
+         * @protected
+         */
+        /**
+         * v5.11.0: Removed checkClearMarker() and createClearMarker() methods
+         * COW is now always enabled - marker files are no longer used
+         */
         // Quota monitoring configuration (v4.0.0)
         this.quotaWarningThreshold = 0.8; // Warn at 80% usage
         this.quotaCriticalThreshold = 0.95; // Critical at 95% usage
@@ -393,18 +403,11 @@ export class OPFSStorage extends BaseStorage {
             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
+                // v5.11.0: Reset COW managers (but don't disable COW - it's always enabled)
+                // COW will re-initialize automatically on next use
                 this.refManager = undefined;
                 this.blobStorage = undefined;
                 this.commitLog = undefined;
-                this.cowEnabled = false;
-                // v5.10.4: Create persistent marker file (CRITICAL FIX)
-                // Bug: cowEnabled = false only affects current instance, not future instances
-                // Fix: Create marker file that persists across instance restarts
-                // When new instance calls initializeCOW(), it checks for this marker
-                await this.createClearMarker();
             }
             catch (error) {
                 // Ignore if _cow directory doesn't exist (not all instances use COW)
@@ -423,51 +426,6 @@ export class OPFSStorage extends BaseStorage {
             throw error;
         }
     }
-    /**
-     * Check if COW has been explicitly disabled via clear()
-     * v5.10.4: Fixes bug where clear() doesn't persist across instance restarts
-     * @returns true if marker file exists, false otherwise
-     * @protected
-     */
-    async checkClearMarker() {
-        await this.ensureInitialized();
-        try {
-            // Get system directory (may not exist yet)
-            const systemDir = await this.rootDir.getDirectoryHandle('system', { create: false });
-            // Try to get the marker file
-            await systemDir.getFileHandle('cow-disabled', { create: false });
-            return true; // Marker exists
-        }
-        catch (error) {
-            if (error.name === 'NotFoundError') {
-                return false; // Marker doesn't exist (or system dir doesn't exist)
-            }
-            // Other errors (permissions, etc.) - treat as marker not existing
-            console.warn('OPFSStorage.checkClearMarker: Error checking marker', error);
-            return false;
-        }
-    }
-    /**
-     * Create marker indicating COW has been explicitly disabled
-     * v5.10.4: Called by clear() to prevent COW reinitialization on new instances
-     * @protected
-     */
-    async createClearMarker() {
-        await this.ensureInitialized();
-        try {
-            // Get or create system directory
-            const systemDir = await this.rootDir.getDirectoryHandle('system', { create: true });
-            // Create empty marker file
-            const fileHandle = await systemDir.getFileHandle('cow-disabled', { create: true });
-            const writable = await fileHandle.createWritable();
-            await writable.write(new Uint8Array(0)); // Empty file
-            await writable.close();
-        }
-        catch (error) {
-            console.error('OPFSStorage.createClearMarker: Failed to create marker file', error);
-            // Don't throw - marker creation failure shouldn't break clear()
-        }
-    }
     /**
      * Get information about storage usage and capacity
      */

package/dist/storage/adapters/r2Storage.d.ts

@@ -200,18 +200,5 @@ export declare class R2Storage extends BaseStorage {
         quota: number | null;
         details?: Record<string, any>;
     }>;
-    /**
-     * Check if COW has been explicitly disabled via clear()
-     * v5.10.4: Fixes bug where clear() doesn't persist across instance restarts
-     * @returns true if marker object exists, false otherwise
-     * @protected
-     */
-    protected checkClearMarker(): Promise<boolean>;
-    /**
-     * Create marker indicating COW has been explicitly disabled
-     * v5.10.4: Called by clear() to prevent COW reinitialization on new instances
-     * @protected
-     */
-    protected createClearMarker(): Promise<void>;
 }
 export {};

package/dist/storage/adapters/r2Storage.js

@@ -771,27 +771,27 @@ export class R2Storage extends BaseStorage {
     async clear() {
         await this.ensureInitialized();
         prodLog.info('🧹 R2: Clearing all data from bucket...');
-        // 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
+        // v5.11.0: Clear ALL data using correct paths
+        // Delete entire branches/ directory (includes ALL entities, ALL types, ALL VFS data, ALL forks)
+        const branchObjects = await this.listObjectsUnderPath('branches/');
+        for (const key of branchObjects) {
+            await this.deleteObjectFromPath(key);
+        }
+        // Delete COW version control data
+        const cowObjects = await this.listObjectsUnderPath('_cow/');
+        for (const key of cowObjects) {
+            await this.deleteObjectFromPath(key);
+        }
+        // Delete system metadata
+        const systemObjects = await this.listObjectsUnderPath('_system/');
+        for (const key of systemObjects) {
+            await this.deleteObjectFromPath(key);
+        }
+        // v5.11.0: Reset COW managers (but don't disable COW - it's always enabled)
+        // COW will re-initialize automatically on next use
         this.refManager = undefined;
         this.blobStorage = undefined;
         this.commitLog = undefined;
-        this.cowEnabled = false;
-        // v5.10.4: Create persistent marker object (CRITICAL FIX)
-        // Bug: cowEnabled = false only affects current instance, not future instances
-        // Fix: Create marker object that persists across instance restarts
-        // When new instance calls initializeCOW(), it checks for this marker
-        await this.createClearMarker();
         this.nounCacheManager.clear();
         this.verbCacheManager.clear();
         this.totalNounCount = 0;
@@ -818,40 +818,5 @@ export class R2Storage extends BaseStorage {
             }
         };
     }
-    /**
-     * Check if COW has been explicitly disabled via clear()
-     * v5.10.4: Fixes bug where clear() doesn't persist across instance restarts
-     * @returns true if marker object exists, false otherwise
-     * @protected
-     */
-    async checkClearMarker() {
-        await this.ensureInitialized();
-        try {
-            const markerPath = `${this.systemPrefix}cow-disabled`;
-            const data = await this.readObjectFromPath(markerPath);
-            return data !== null; // Marker exists if we got any data
-        }
-        catch (error) {
-            prodLog.warn('R2Storage.checkClearMarker: Error checking marker', error);
-            return false;
-        }
-    }
-    /**
-     * Create marker indicating COW has been explicitly disabled
-     * v5.10.4: Called by clear() to prevent COW reinitialization on new instances
-     * @protected
-     */
-    async createClearMarker() {
-        await this.ensureInitialized();
-        try {
-            const markerPath = `${this.systemPrefix}cow-disabled`;
-            // Create empty marker object
-            await this.writeObjectToPath(markerPath, '');
-        }
-        catch (error) {
-            prodLog.error('R2Storage.createClearMarker: Failed to create marker object', error);
-            // Don't throw - marker creation failure shouldn't break clear()
-        }
-    }
 }
 //# sourceMappingURL=r2Storage.js.map

package/dist/storage/adapters/s3CompatibleStorage.d.ts

@@ -379,13 +379,10 @@ export declare class S3CompatibleStorage extends BaseStorage {
      * @returns true if marker object exists, false otherwise
      * @protected
      */
-    protected checkClearMarker(): Promise<boolean>;
     /**
-     * Create marker indicating COW has been explicitly disabled
-     * v5.10.4: Called by clear() to prevent COW reinitialization on new instances
-     * @protected
+     * v5.11.0: Removed checkClearMarker() and createClearMarker() methods
+     * COW is now always enabled - marker files are no longer used
      */
-    protected createClearMarker(): Promise<void>;
     protected statisticsBatchUpdateTimerId: NodeJS.Timeout | null;
     protected statisticsModified: boolean;
     protected lastStatisticsFlushTime: number;