@soulcraft/brainy 3.31.0 → 3.32.0

package/dist/storage/adapters/gcsStorage.js

@@ -789,6 +789,7 @@ export class GcsStorage extends BaseStorage {
                             : undefined;
                     return {
                         nodes,
+                        totalCount: this.totalNounCount,
                         hasMore: !!nextCursor,
                         nextCursor
                     };
@@ -797,6 +798,7 @@ export class GcsStorage extends BaseStorage {
                 if (response?.nextPageToken) {
                     return {
                         nodes,
+                        totalCount: this.totalNounCount,
                         hasMore: true,
                         nextCursor: `${shardIndex}:${response.nextPageToken}`
                     };
@@ -806,6 +808,7 @@ export class GcsStorage extends BaseStorage {
             // No more shards or nodes
             return {
                 nodes,
+                totalCount: this.totalNounCount,
                 hasMore: false,
                 nextCursor: undefined
             };
@@ -943,6 +946,7 @@ export class GcsStorage extends BaseStorage {
             }
             return {
                 items: filteredVerbs,
+                totalCount: this.totalVerbCount,
                 hasMore: !!response?.nextPageToken,
                 nextCursor: response?.nextPageToken
             };

package/dist/storage/adapters/opfsStorage.js

@@ -81,6 +81,8 @@ export class OPFSStorage extends BaseStorage {
             this.indexDir = await this.rootDir.getDirectoryHandle(INDEX_DIR, {
                 create: true
             });
+            // Initialize counts from storage
+            await this.initializeCounts();
             this.isInitialized = true;
         }
         catch (error) {

package/dist/storage/adapters/s3CompatibleStorage.js

@@ -235,6 +235,8 @@ export class S3CompatibleStorage extends BaseStorage {
             this.initializeCoalescer();
             // Auto-cleanup legacy /index folder on initialization
             await this.cleanupLegacyIndexFolder();
+            // Initialize counts from storage
+            await this.initializeCounts();
             this.isInitialized = true;
             this.logger.info(`Initialized ${this.serviceType} storage with bucket ${this.bucketName}`);
         }
@@ -1425,6 +1427,7 @@ export class S3CompatibleStorage extends BaseStorage {
         }
         return {
             items: filteredGraphVerbs,
+            totalCount: this.totalVerbCount, // Use pre-calculated count from init()
             hasMore: result.hasMore,
             nextCursor: result.nextCursor
         };
@@ -2633,21 +2636,9 @@ export class S3CompatibleStorage extends BaseStorage {
                 filteredNodes = filteredByMetadata;
             }
         }
-        // Calculate total count efficiently
-        // For the first page (no cursor), we can estimate total count
-        let totalCount;
-        if (!cursor) {
-            try {
-                totalCount = await this.estimateTotalNounCount();
-            }
-            catch (error) {
-                this.logger.warn('Failed to estimate total noun count:', error);
-                // totalCount remains undefined
-            }
-        }
         return {
             items: filteredNodes,
-            totalCount,
+            totalCount: this.totalNounCount, // Use pre-calculated count from init()
             hasMore: result.hasMore,
             nextCursor: result.nextCursor
         };

package/dist/storage/baseStorage.js

@@ -422,9 +422,18 @@ export class BaseStorage extends BaseStorageAdapter {
                 // If we have no items but hasMore is true, force hasMore to false
                 // This prevents pagination bugs from causing infinite loops
                 const safeHasMore = items.length > 0 ? result.hasMore : false;
+                // VALIDATION: Ensure adapter returns totalCount (prevents restart bugs)
+                // If adapter forgets to return totalCount, log warning and use pre-calculated count
+                let finalTotalCount = result.totalCount || totalCount;
+                if (result.totalCount === undefined && this.totalNounCount > 0) {
+                    console.warn(`⚠️  Storage adapter missing totalCount in getNounsWithPagination result! ` +
+                        `Using pre-calculated count (${this.totalNounCount}) as fallback. ` +
+                        `Please ensure your storage adapter returns totalCount: this.totalNounCount`);
+                    finalTotalCount = this.totalNounCount;
+                }
                 return {
                     items,
-                    totalCount: result.totalCount || totalCount,
+                    totalCount: finalTotalCount,
                     hasMore: safeHasMore,
                     nextCursor: result.nextCursor
                 };
@@ -571,9 +580,18 @@ export class BaseStorage extends BaseStorageAdapter {
                 // If we have no items but hasMore is true, force hasMore to false
                 // This prevents pagination bugs from causing infinite loops
                 const safeHasMore = items.length > 0 ? result.hasMore : false;
+                // VALIDATION: Ensure adapter returns totalCount (prevents restart bugs)
+                // If adapter forgets to return totalCount, log warning and use pre-calculated count
+                let finalTotalCount = result.totalCount || totalCount;
+                if (result.totalCount === undefined && this.totalVerbCount > 0) {
+                    console.warn(`⚠️  Storage adapter missing totalCount in getVerbsWithPagination result! ` +
+                        `Using pre-calculated count (${this.totalVerbCount}) as fallback. ` +
+                        `Please ensure your storage adapter returns totalCount: this.totalVerbCount`);
+                    finalTotalCount = this.totalVerbCount;
+                }
                 return {
                     items,
-                    totalCount: result.totalCount || totalCount,
+                    totalCount: finalTotalCount,
                     hasMore: safeHasMore,
                     nextCursor: result.nextCursor
                 };

package/package.json

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