@soulcraft/brainy 6.2.4 → 6.2.6

package/dist/graph/graphAdjacencyIndex.js

@@ -433,6 +433,8 @@ export class GraphAdjacencyIndex {
             // Clear current index
             this.verbIdSet.clear();
             this.totalRelationshipsIndexed = 0;
+            // v6.2.4: CRITICAL FIX - Clear relationship counts to prevent accumulation
+            this.relationshipCountsByType.clear();
             // Note: LSM-trees will be recreated from storage via their own initialization
             // Verb data will be loaded on-demand via UnifiedCache
             // Adaptive loading strategy based on storage type (v4.2.4)

package/dist/storage/adapters/azureBlobStorage.js

@@ -388,6 +388,11 @@ export class AzureBlobStorage extends BaseStorage {
         // Use write buffer in high-volume mode
         if (this.highVolumeMode && this.nounWriteBuffer) {
             this.logger.trace(`📝 BUFFERING: Adding noun ${node.id} to write buffer (high-volume mode active)`);
+            // v6.2.6: CRITICAL FIX - Populate cache BEFORE buffering for read-after-write consistency
+            // Without this, add() returns but relate() can't find the entity (cloud storage production bug)
+            if (node.vector && Array.isArray(node.vector) && node.vector.length > 0) {
+                this.nounCacheManager.set(node.id, node);
+            }
             await this.nounWriteBuffer.add(node.id, node);
             return;
         }
@@ -779,6 +784,8 @@ export class AzureBlobStorage extends BaseStorage {
         // Use write buffer in high-volume mode
         if (this.highVolumeMode && this.verbWriteBuffer) {
             this.logger.trace(`📝 BUFFERING: Adding verb ${edge.id} to write buffer`);
+            // v6.2.6: CRITICAL FIX - Populate cache BEFORE buffering for read-after-write consistency
+            this.verbCacheManager.set(edge.id, edge);
             await this.verbWriteBuffer.add(edge.id, edge);
             return;
         }

package/dist/storage/adapters/gcsStorage.js

@@ -313,6 +313,12 @@ export class GcsStorage extends BaseStorage {
         // Use write buffer in high-volume mode
         if (this.highVolumeMode && this.nounWriteBuffer) {
             this.logger.trace(`📝 BUFFERING: Adding noun ${node.id} to write buffer (high-volume mode active)`);
+            // v6.2.6: CRITICAL FIX - Populate cache BEFORE buffering for read-after-write consistency
+            // Without this, add() returns but relate() can't find the entity (GCS production bug)
+            // The buffer flushes asynchronously, but cache ensures immediate reads succeed
+            if (node.vector && Array.isArray(node.vector) && node.vector.length > 0) {
+                this.nounCacheManager.set(node.id, node);
+            }
             await this.nounWriteBuffer.add(node.id, node);
             return;
         }
@@ -648,6 +654,9 @@ export class GcsStorage extends BaseStorage {
         // Use write buffer in high-volume mode
         if (this.highVolumeMode && this.verbWriteBuffer) {
             this.logger.trace(`📝 BUFFERING: Adding verb ${edge.id} to write buffer`);
+            // v6.2.6: CRITICAL FIX - Populate cache BEFORE buffering for read-after-write consistency
+            // Without this, relate() might not find the verb immediately after creation
+            this.verbCacheManager.set(edge.id, edge);
             await this.verbWriteBuffer.add(edge.id, edge);
             return;
         }

package/dist/storage/adapters/r2Storage.js

@@ -355,6 +355,11 @@ export class R2Storage extends BaseStorage {
         // Use write buffer in high-volume mode
         if (this.highVolumeMode && this.nounWriteBuffer) {
             this.logger.trace(`📝 BUFFERING: Adding noun ${node.id} to write buffer`);
+            // v6.2.6: CRITICAL FIX - Populate cache BEFORE buffering for read-after-write consistency
+            // Without this, add() returns but relate() can't find the entity (cloud storage production bug)
+            if (node.vector && Array.isArray(node.vector) && node.vector.length > 0) {
+                this.nounCacheManager.set(node.id, node);
+            }
             await this.nounWriteBuffer.add(node.id, node);
             return;
         }
@@ -571,6 +576,8 @@ export class R2Storage extends BaseStorage {
         await this.ensureInitialized();
         this.checkVolumeMode();
         if (this.highVolumeMode && this.verbWriteBuffer) {
+            // v6.2.6: CRITICAL FIX - Populate cache BEFORE buffering for read-after-write consistency
+            this.verbCacheManager.set(edge.id, edge);
             await this.verbWriteBuffer.add(edge.id, edge);
             return;
         }

package/dist/storage/adapters/s3CompatibleStorage.js

@@ -810,6 +810,12 @@ export class S3CompatibleStorage extends BaseStorage {
         // Use write buffer in high-volume mode
         if (this.highVolumeMode && this.nounWriteBuffer) {
             this.logger.trace(`📝 BUFFERING: Adding noun ${node.id} to write buffer (high-volume mode active)`);
+            // v6.2.6: CRITICAL FIX - Populate cache BEFORE buffering for read-after-write consistency
+            // Without this, add() returns but relate() can't find the entity (cloud storage production bug)
+            // The buffer flushes asynchronously, but cache ensures immediate reads succeed
+            if (node.vector && Array.isArray(node.vector) && node.vector.length > 0) {
+                this.nounCacheManager.set(node.id, node);
+            }
             await this.nounWriteBuffer.add(node.id, node);
             return;
         }

package/dist/utils/metadataIndex.js

@@ -237,6 +237,11 @@ export class MetadataIndexManager {
      */
     async lazyLoadCounts() {
         try {
+            // v6.2.4: CRITICAL FIX - Clear counts before loading to prevent accumulation
+            // Previously, counts accumulated across restarts causing 100x inflation
+            this.totalEntitiesByType.clear();
+            this.entityCountsByTypeFixed.fill(0);
+            this.verbCountsByTypeFixed.fill(0);
             // v6.2.2: Load counts from sparse index (correct source)
             const nounSparseIndex = await this.loadSparseIndex('noun');
             if (!nounSparseIndex) {
@@ -2100,6 +2105,12 @@ export class MetadataIndexManager {
             // v3.44.1: No sparseIndices Map to clear - UnifiedCache handles eviction
             this.fieldIndexes.clear();
             this.dirtyFields.clear();
+            // v6.2.4: CRITICAL FIX - Clear type counts to prevent accumulation
+            // Previously, counts accumulated across rebuilds causing incorrect values
+            this.totalEntitiesByType.clear();
+            this.entityCountsByTypeFixed.fill(0);
+            this.verbCountsByTypeFixed.fill(0);
+            this.typeFieldAffinity.clear();
             // Clear all cached sparse indices in UnifiedCache
             // This ensures rebuild starts fresh (v3.44.1)
             this.unifiedCache.clear('metadata');

package/package.json

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