@soulcraft/brainy 6.3.1 → 6.3.2

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.
 
+### [6.3.2](https://github.com/soulcraftlabs/brainy/compare/v6.3.1...v6.3.2) (2025-12-09)
+
+
+### 🐛 Bug Fixes
+
+* **versioning:** VFS file versions now capture actual blob content ([3e0f235](https://github.com/soulcraftlabs/brainy/commit/3e0f235f8b2cfcc6f0792a457879a02e4b93897a))
+
 ### [6.3.1](https://github.com/soulcraftlabs/brainy/compare/v6.3.0...v6.3.1) (2025-12-09)
 
 - fix(versioning): clean architecture with index pollution prevention (f145fa1)

package/dist/versioning/VersionManager.d.ts

@@ -99,6 +99,20 @@ export declare class VersionManager {
     private versionIndex;
     private initialized;
     constructor(brain: any);
+    /**
+     * Check if an entity is a VFS file
+     * VFS files store content in BlobStorage, not in entity.data
+     *
+     * @param entity Entity metadata object
+     * @returns True if entity is a VFS file
+     */
+    private isVFSFile;
+    /**
+     * Check if content is text-based for encoding decisions
+     * @param mimeType MIME type of the content
+     * @returns True if content should be stored as UTF-8 string
+     */
+    private isTextContent;
     /**
      * Initialize versioning system (lazy)
      */

package/dist/versioning/VersionManager.js

@@ -35,6 +35,34 @@ export class VersionManager {
         this.versionStorage = new VersionStorage(brain);
         this.versionIndex = new VersionIndex(brain);
     }
+    /**
+     * Check if an entity is a VFS file
+     * VFS files store content in BlobStorage, not in entity.data
+     *
+     * @param entity Entity metadata object
+     * @returns True if entity is a VFS file
+     */
+    isVFSFile(entity) {
+        return (entity?.isVFS === true &&
+            entity?.vfsType === 'file' &&
+            typeof entity?.path === 'string');
+    }
+    /**
+     * Check if content is text-based for encoding decisions
+     * @param mimeType MIME type of the content
+     * @returns True if content should be stored as UTF-8 string
+     */
+    isTextContent(mimeType) {
+        if (!mimeType)
+            return false;
+        return (mimeType.startsWith('text/') ||
+            mimeType === 'application/json' ||
+            mimeType === 'application/javascript' ||
+            mimeType === 'application/typescript' ||
+            mimeType === 'application/xml' ||
+            mimeType.includes('+xml') ||
+            mimeType.includes('+json'));
+    }
     /**
      * Initialize versioning system (lazy)
      */
@@ -62,6 +90,27 @@ export class VersionManager {
         if (!entity) {
             throw new Error(`Entity ${entityId} not found`);
         }
+        // v6.3.2 FIX: For VFS file entities, fetch current content from blob storage
+        // The entity.data field contains stale embedding text, not actual file content
+        // VFS files store their real content in BlobStorage (content-addressable)
+        if (this.isVFSFile(entity)) {
+            if (!this.brain.vfs) {
+                throw new Error(`Cannot version VFS file ${entityId}: VFS not initialized. ` +
+                    `Ensure brain.vfs is available before versioning VFS files.`);
+            }
+            // Read fresh content from blob storage via VFS
+            const freshContent = await this.brain.vfs.readFile(entity.path);
+            // Store content with appropriate encoding
+            // Text files as UTF-8 string (readable, smaller)
+            // Binary files as base64 (safe for JSON serialization)
+            if (this.isTextContent(entity.mimeType)) {
+                entity.data = freshContent.toString('utf-8');
+            }
+            else {
+                entity.data = freshContent.toString('base64');
+                entity._vfsEncoding = 'base64'; // Flag for restore to decode
+            }
+        }
         // Get current branch
         const currentBranch = this.brain.currentBranch;
         // Get next version number
@@ -207,6 +256,32 @@ export class VersionManager {
         if (!versionedEntity) {
             throw new Error(`Version data not found for entity ${entityId} version ${version}`);
         }
+        // v6.3.2 FIX: For VFS file entities, write content back to blob storage
+        // The versioned data contains the actual file content (not stale embedding text)
+        // Using vfs.writeFile() ensures proper blob creation and metadata update
+        if (this.isVFSFile(versionedEntity)) {
+            if (!this.brain.vfs) {
+                throw new Error(`Cannot restore VFS file ${entityId}: VFS not initialized. ` +
+                    `Ensure brain.vfs is available before restoring VFS files.`);
+            }
+            // Decode content based on how it was stored
+            let content;
+            if (versionedEntity._vfsEncoding === 'base64') {
+                // Binary file stored as base64
+                content = Buffer.from(versionedEntity.data, 'base64');
+            }
+            else {
+                // Text file stored as UTF-8 string
+                content = Buffer.from(versionedEntity.data, 'utf-8');
+            }
+            // Write content back to VFS - this handles:
+            // - BlobStorage write (new hash)
+            // - Entity metadata update
+            // - Path resolver cache update
+            await this.brain.vfs.writeFile(versionedEntity.path, content);
+            return targetVersion;
+        }
+        // For non-VFS entities, use existing brain.update() logic
         // Extract standard fields vs custom metadata
         // NounMetadata has: noun, data, createdAt, updatedAt, createdBy, service, confidence, weight
         const { noun, data, createdAt, updatedAt, createdBy, service, confidence, weight, ...customMetadata } = versionedEntity;

package/package.json

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