@soulcraft/brainy 0.60.0 → 0.61.0

package/README.md

@@ -7,9 +7,10 @@
 [![Node.js](https://img.shields.io/badge/node-%3E%3D24.4.1-brightgreen.svg)](https://nodejs.org/)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.4.5-blue.svg)](https://www.typescriptlang.org/)
 
-# BRAINY: The Brain in a Jar Database™
+# BRAINY: Multi-Dimensional AI Database™
 
-**The world's only Vector + Graph + AI database and realtime data platform**
+**The world's first Multi-Dimensional AI Database**  
+*Vector similarity • Graph relationships • Metadata facets • AI context*
 
 *Zero-to-Smart™ technology that thinks so you don't have to*
 
@@ -48,13 +49,13 @@ const results = await brainy.search("AI language models", 5, {
 Pinecone ($$$) + Neo4j ($$$) + Elasticsearch ($$$) + Sync Hell = 😱
 ```
 
-### ✅ The Brainy Way: One Smart Brain
+### ✅ The Brainy Way: One Multi-Dimensional Brain
 
 ```
-Vector Search + Graph Relations + Metadata Filtering + AI Intelligence = 🧠✨
+Multi-Dimensional AI Database = Vector + Graph + Facets + AI = 🧠✨
 ```
 
-**Your data gets a brain upgrade. No assembly required.**
+**Your data gets a multi-dimensional brain upgrade. No assembly required.**
 
 ## ⚡ QUICK & EASY: From Zero to Smart in 60 Seconds
 
@@ -458,6 +459,7 @@ brainy augment trial notion  # Start 14-day free trial
 
 ### Advanced Topics
 
+- [**🏗️ Storage & Retrieval Architecture**](docs/technical/STORAGE_AND_RETRIEVAL_ARCHITECTURE.md) - Multi-dimensional database internals
 - [**Brainy CLI**](docs/brainy-cli.md) - Command-line superpowers
 - [**Brainy Chat**](BRAINY-CHAT.md) - Conversational AI interface
 - [**Cortex AI**](CORTEX.md) - Intelligence augmentation

package/bin/brainy.js

@@ -13,6 +13,7 @@ import chalk from 'chalk'
 import { readFileSync } from 'fs'
 import { dirname, join } from 'path'
 import { fileURLToPath } from 'url'
+import { createInterface } from 'readline'
 
 // Use native fetch (available in Node.js 18+)
 
@@ -57,7 +58,7 @@ const wrapInteractive = (fn) => {
 
 program
   .name('brainy')
-  .description('🧠 Brainy - Vector + Graph Database with AI Coordination')
+  .description('🧠 Brainy - Multi-Dimensional AI Database')
   .version(packageJson.version)
 
 // ========================================
@@ -66,7 +67,7 @@ program
 
 program
   .command('init')
-  .description('🚀 Initialize Brainy in your project')
+  .description('Initialize Brainy in your project')
   .option('-s, --storage <type>', 'Storage type (filesystem, s3, r2, gcs, memory)')
   .option('-e, --encryption', 'Enable encryption for secrets')
   .action(wrapAction(async (options) => {
@@ -75,8 +76,8 @@ program
 
 program
   .command('add [data]')
-  .description('📊 Add data to Brainy')
-  .option('-m, --metadata <json>', 'Metadata as JSON')
+  .description('Add data across multiple dimensions (vector, graph, facets)')
+  .option('-m, --metadata <json>', 'Metadata facets as JSON')
   .option('-i, --id <id>', 'Custom ID')
   .action(wrapAction(async (data, options) => {
     let metadata = {}
@@ -96,11 +97,11 @@ program
 
 program
   .command('search <query>')
-  .description('🔍 Search your database')
+  .description('Multi-dimensional search across vector, graph, and facets')
   .option('-l, --limit <number>', 'Number of results', '10')
-  .option('-f, --filter <json>', 'MongoDB-style metadata filters')
-  .option('-v, --verbs <types>', 'Graph verb types to traverse (comma-separated)')
-  .option('-d, --depth <number>', 'Graph traversal depth', '1')
+  .option('-f, --filter <json>', 'Filter by metadata facets')
+  .option('-v, --verbs <types>', 'Include related data (comma-separated)')
+  .option('-d, --depth <number>', 'Relationship depth', '1')
   .action(wrapAction(async (query, options) => {
     const searchOptions = { limit: parseInt(options.limit) }
     
@@ -123,7 +124,7 @@ program
 
 program
   .command('chat [question]')
-  .description('💬 Chat with your data (interactive mode if no question)')
+  .description('AI-powered chat with multi-dimensional context')
   .option('-l, --llm <model>', 'LLM model to use')
   .action(wrapInteractive(async (question, options) => {
     await cortex.chat(question)
@@ -131,7 +132,7 @@ program
 
 program
   .command('stats')
-  .description('📊 Show database statistics')
+  .description('Show database statistics and insights')
   .option('-d, --detailed', 'Show detailed statistics')
   .action(wrapAction(async (options) => {
     await cortex.stats(options.detailed)
@@ -139,7 +140,7 @@ program
 
 program
   .command('health')
-  .description('🔋 Check system health')
+  .description('Check system health')
   .option('--auto-fix', 'Automatically apply safe repairs')
   .action(wrapAction(async (options) => {
     await cortex.health(options)
@@ -147,21 +148,21 @@ program
 
 program
   .command('find')
-  .description('🔍 Interactive advanced search')
+  .description('Advanced intelligent search (interactive)')
   .action(wrapInteractive(async () => {
     await cortex.advancedSearch()
   }))
 
 program
   .command('explore [nodeId]')
-  .description('🗺️ Interactively explore graph connections')
+  .description('Explore data relationships interactively')
   .action(wrapInteractive(async (nodeId) => {
     await cortex.explore(nodeId)
   }))
 
 program
   .command('backup')
-  .description('💾 Create database backup')
+  .description('Create database backup')
   .option('-c, --compress', 'Compress backup')
   .option('-o, --output <file>', 'Output file')
   .action(wrapAction(async (options) => {
@@ -170,7 +171,7 @@ program
 
 program
   .command('restore <file>')
-  .description('♻️ Restore from backup')
+  .description('Restore from backup')
   .action(wrapInteractive(async (file) => {
     await cortex.restore(file)
   }))
@@ -181,35 +182,30 @@ program
 
 program
   .command('connect')
-  .description('🔗 Connect me to your Brain Cloud so I remember everything')
+  .description('Connect to Brain Cloud for AI memory')
   .action(wrapInteractive(async () => {
-    console.log(chalk.cyan('\n🧠 Setting Up AI Memory...'))
-    console.log(chalk.gray('━'.repeat(50)))
+    console.log(chalk.cyan('\n🧠 Brain Cloud Setup'))
+    console.log(chalk.gray('━'.repeat(40)))
     
     try {
       // Detect customer ID
       const customerId = await detectCustomerId()
       
       if (customerId) {
-        console.log(chalk.green(`✅ Found your Brain Cloud: ${customerId}`))
-        console.log('\n🔧 I can set up AI memory so I remember our conversations:')
-        console.log(chalk.yellow('  • Update Claude configuration'))
+        console.log(chalk.green(`✅ Found Brain Cloud: ${customerId}`))
+        console.log('\n🔧 Setting up AI memory:')
+        console.log(chalk.yellow('  • Update configuration'))
         console.log(chalk.yellow('  • Add memory instructions'))
         console.log(chalk.yellow('  • Enable cross-session memory'))
         
-        // For now, auto-proceed (in a real CLI environment, user could be prompted)
-        console.log(chalk.cyan('\n🚀 Setting up AI memory...'))
-        const proceed = true
-        
-        if (proceed) {
-          await setupBrainCloudMemory(customerId)
-          console.log(chalk.green('\n🎉 AI Memory Connected!'))
-          console.log(chalk.cyan('Restart Claude Code and I\'ll remember everything!'))
-        }
+        console.log(chalk.cyan('\n🚀 Configuring...'))
+        await setupBrainCloudMemory(customerId)
+        console.log(chalk.green('\n✅ AI memory connected!'))
+        console.log(chalk.cyan('Restart Claude Code to activate memory.'))
       } else {
-        console.log(chalk.yellow('🤔 No Brain Cloud found. Let me help you set one up:'))
-        console.log('\n1. Visit: ' + chalk.cyan('https://app.soulcraftlabs.com'))
-        console.log('2. Sign up for Brain Cloud ($19/month)')
+        console.log(chalk.yellow('No Brain Cloud found. Setting up:'))
+        console.log('\n1. Visit: ' + chalk.cyan('https://soulcraft.com'))
+        console.log('2. Sign up for Brain Cloud')
         console.log('3. Run ' + chalk.green('brainy connect') + ' again')
       }
     } catch (error) {
@@ -219,7 +215,7 @@ program
 
 program
   .command('cloud [action]')
-  .description('☁️ Connect to Brain Cloud - AI memory that never forgets')
+  .description('Manage Brain Cloud connection')
   .option('--connect <id>', 'Connect to existing Brain Cloud instance')
   .option('--export <id>', 'Export all data from Brain Cloud instance')
   .option('--status <id>', 'Check status of Brain Cloud instance')
@@ -363,7 +359,7 @@ program
 
 program
   .command('install <augmentation>')
-  .description('📦 Install augmentation')
+  .description('Install augmentation')
   .option('-m, --mode <type>', 'Installation mode (free|premium)', 'free')
   .option('-c, --config <json>', 'Configuration as JSON')
   .action(wrapAction(async (augmentation, options) => {
@@ -386,7 +382,7 @@ program
 
 program
   .command('run <augmentation>')
-  .description('⚡ Run augmentation')
+  .description('Run augmentation')
   .option('-c, --config <json>', 'Runtime configuration as JSON')
   .action(wrapAction(async (augmentation, options) => {
     if (augmentation === 'brain-jar') {
@@ -400,7 +396,7 @@ program
 
 program
   .command('status [augmentation]')
-  .description('📊 Show augmentation status')
+  .description('Show augmentation status')
   .action(wrapAction(async (augmentation) => {
     if (augmentation === 'brain-jar') {
       await cortex.brainJarStatus()
@@ -415,7 +411,7 @@ program
 
 program
   .command('stop [augmentation]')
-  .description('⏹️ Stop augmentation')
+  .description('Stop augmentation')
   .action(wrapAction(async (augmentation) => {
     if (augmentation === 'brain-jar') {
       await cortex.brainJarStop()
@@ -426,11 +422,11 @@ program
 
 program
   .command('list')
-  .description('📋 List installed augmentations')
+  .description('List installed augmentations')
   .option('-a, --available', 'Show available augmentations')
   .action(wrapAction(async (options) => {
     if (options.available) {
-      console.log(chalk.cyan('🧩 Available Augmentations:'))
+      console.log(chalk.cyan('Available Augmentations:'))
       console.log('  • brain-jar - AI coordination and collaboration')
       console.log('  • encryption - Data encryption and security')
       console.log('  • neural-import - AI-powered data analysis')
@@ -442,30 +438,17 @@ program
     }
   }))
 
-// ========================================
-// BRAIN CLOUD SUPER COMMAND (New!)
-// ========================================
-
-program
-  .command('cloud')
-  .description('☁️ Setup Brain Cloud - AI coordination across all devices')
-  .option('-m, --mode <type>', 'Setup mode (free|premium)', 'interactive')
-  .option('-k, --key <key>', 'License key for premium features')
-  .option('-s, --skip-install', 'Skip Brain Jar installation')
-  .action(wrapInteractive(async (options) => {
-    await cortex.setupBrainCloud(options)
-  }))
 
 // ========================================
 // BRAIN JAR SPECIFIC COMMANDS (Rich UX)
 // ========================================
 
 const brainJar = program.command('brain-jar')
-  .description('🧠🫙 AI coordination and collaboration')
+  .description('AI coordination and collaboration')
 
 brainJar
   .command('install')
-  .description('📦 Install Brain Jar coordination')
+  .description('Install Brain Jar coordination')
   .option('-m, --mode <type>', 'Installation mode (free|premium)', 'free')
   .action(wrapAction(async (options) => {
     await cortex.brainJarInstall(options.mode)
@@ -473,7 +456,7 @@ brainJar
 
 brainJar
   .command('start')
-  .description('🚀 Start Brain Jar coordination')
+  .description('Start Brain Jar coordination')
   .option('-s, --server <url>', 'Custom server URL')
   .option('-n, --name <name>', 'Agent name')
   .option('-r, --role <role>', 'Agent role')
@@ -483,7 +466,7 @@ brainJar
 
 brainJar
   .command('dashboard')
-  .description('📊 Open Brain Jar dashboard')
+  .description('Open Brain Jar dashboard')
   .option('-o, --open', 'Auto-open in browser', true)
   .action(wrapAction(async (options) => {
     await cortex.brainJarDashboard(options.open)
@@ -491,28 +474,28 @@ brainJar
 
 brainJar
   .command('status')
-  .description('🔍 Show Brain Jar status')
+  .description('Show Brain Jar status')
   .action(wrapAction(async () => {
     await cortex.brainJarStatus()
   }))
 
 brainJar
   .command('agents')
-  .description('👥 List connected agents')
+  .description('List connected agents')
   .action(wrapAction(async () => {
     await cortex.brainJarAgents()
   }))
 
 brainJar
   .command('message <text>')
-  .description('📨 Send message to coordination channel')
+  .description('Send message to coordination channel')
   .action(wrapAction(async (text) => {
     await cortex.brainJarMessage(text)
   }))
 
 brainJar
   .command('search <query>')
-  .description('🔍 Search coordination history')
+  .description('Search coordination history')
   .option('-l, --limit <number>', 'Number of results', '10')
   .action(wrapAction(async (query, options) => {
     await cortex.brainJarSearch(query, parseInt(options.limit))
@@ -523,7 +506,7 @@ brainJar
 // ========================================
 
 const config = program.command('config')
-  .description('⚙️ Manage configuration')
+  .description('Manage configuration')
 
 config
   .command('set <key> <value>')
@@ -557,11 +540,11 @@ config
 // ========================================
 
 const cortexCmd = program.command('cortex')
-  .description('🔧 Legacy Cortex commands (deprecated - use direct commands)')
+  .description('Legacy Cortex commands (deprecated - use direct commands)')
 
 cortexCmd
   .command('chat [question]')
-  .description('💬 Chat with your data')
+  .description('Chat with your data')
   .action(wrapInteractive(async (question) => {
     console.log(chalk.yellow('⚠️  Deprecated: Use "brainy chat" instead'))
     await cortex.chat(question)
@@ -569,7 +552,7 @@ cortexCmd
 
 cortexCmd
   .command('add [data]')
-  .description('📊 Add data')
+  .description('Add data')
   .action(wrapAction(async (data) => {
     console.log(chalk.yellow('⚠️  Deprecated: Use "brainy add" instead'))
     await cortex.add(data, {})
@@ -581,7 +564,7 @@ cortexCmd
 
 program
   .command('shell')
-  .description('🐚 Interactive Brainy shell')
+  .description('Interactive Brainy shell')
   .action(wrapInteractive(async () => {
     console.log(chalk.cyan('🧠 Brainy Interactive Shell'))
     console.log(chalk.dim('Type "help" for commands, "exit" to quit\n'))
@@ -596,21 +579,24 @@ program.parse(process.argv)
 
 // Show help if no command
 if (!process.argv.slice(2).length) {
-  console.log(chalk.cyan('🧠☁️ Brainy - AI Coordination Service'))
-  console.log('')
-  console.log(chalk.bold('One-Command Setup:'))
-  console.log(chalk.green('  brainy cloud                   # Setup Brain Cloud (recommended!)'))
-  console.log('')
+  console.log(chalk.cyan('🧠 Brainy - Multi-Dimensional AI Database'))
+  console.log(chalk.gray('Vector similarity, graph relationships, metadata facets, and AI context.\n'))
+  
   console.log(chalk.bold('Quick Start:'))
   console.log('  brainy init                    # Initialize project')
-  console.log('  brainy add "some data"         # Add data')
-  console.log('  brainy search "query"          # Search data')
-  console.log('  brainy chat                    # Chat with data')
+  console.log('  brainy add "some data"         # Add multi-dimensional data')
+  console.log('  brainy search "query"          # Search across all dimensions')
+  console.log('  brainy chat                    # AI chat with full context')
+  console.log('')
+  console.log(chalk.bold('AI Memory:'))
+  console.log(chalk.green('  brainy connect                 # Connect to Brain Cloud'))
+  console.log('  brainy cloud --status <id>     # Check cloud status')
   console.log('')
   console.log(chalk.bold('AI Coordination:'))
-  console.log('  brainy install brain-jar       # Install AI coordination')
+  console.log('  brainy install brain-jar       # Install coordination')
   console.log('  brainy brain-jar start         # Start coordination')
-  console.log('  brainy brain-jar dashboard     # View dashboard')
+  console.log('')
+  console.log(chalk.dim('Learn more: https://soulcraft.com'))
   console.log('')
   program.outputHelp()
 }

package/dist/augmentations/memoryAugmentations.js

@@ -129,31 +129,41 @@ class BaseMemoryAugmentation {
                     error: 'Query must be a vector (array of numbers) for vector search'
                 };
             }
-            // Get all nodes from storage
-            const nodes = await this.storage.getAllNouns();
-            // Calculate distances and prepare results
-            const results = [];
-            for (const node of nodes) {
-                // Skip nodes that don't have a vector
-                if (!node.vector || !Array.isArray(node.vector)) {
-                    continue;
-                }
-                // Get metadata for the node
-                const metadata = await this.storage.getMetadata(node.id);
-                // Calculate distance between query vector and node vector
-                const distance = cosineDistance(queryVector, node.vector);
-                // Convert distance to similarity score (1 - distance for cosine)
-                // This way higher scores are better (more similar)
-                const score = 1 - distance;
-                results.push({
-                    id: node.id,
-                    score,
-                    data: metadata
+            // Process nodes in batches to avoid loading everything into memory
+            const allResults = [];
+            let hasMore = true;
+            let cursor;
+            while (hasMore) {
+                // Get a batch of nodes
+                const batchResult = await this.storage.getNouns({
+                    pagination: { limit: 100, cursor }
                 });
+                // Process this batch
+                for (const noun of batchResult.items) {
+                    // Skip nodes that don't have a vector
+                    if (!noun.vector || !Array.isArray(noun.vector)) {
+                        continue;
+                    }
+                    // Get metadata for the node
+                    const metadata = await this.storage.getMetadata(noun.id);
+                    // Calculate distance between query vector and node vector
+                    const distance = cosineDistance(queryVector, noun.vector);
+                    // Convert distance to similarity score (1 - distance for cosine)
+                    // This way higher scores are better (more similar)
+                    const score = 1 - distance;
+                    allResults.push({
+                        id: noun.id,
+                        score,
+                        data: metadata
+                    });
+                }
+                // Update pagination state
+                hasMore = batchResult.hasMore;
+                cursor = batchResult.nextCursor;
             }
             // Sort results by score (descending) and take top k
-            results.sort((a, b) => b.score - a.score);
-            const topResults = results.slice(0, k);
+            allResults.sort((a, b) => b.score - a.score);
+            const topResults = allResults.slice(0, k);
             return {
                 success: true,
                 data: topResults

package/dist/brainyData.d.ts

@@ -736,11 +736,6 @@ export declare class BrainyData<T = any> implements BrainyDataInterface<T> {
      * @returns Promise<Array<VectorDocument<T> | null>> Array of documents (null for missing IDs)
      */
     getBatch(ids: string[]): Promise<Array<VectorDocument<T> | null>>;
-    /**
-     * Get all nouns in the database
-     * @returns Array of vector documents
-     */
-    getAllNouns(): Promise<VectorDocument<T>[]>;
     /**
      * Get nouns with pagination and filtering
      * @param options Pagination and filtering options
@@ -830,10 +825,25 @@ export declare class BrainyData<T = any> implements BrainyDataInterface<T> {
      */
     getVerb(id: string): Promise<GraphVerb | null>;
     /**
-     * Get all verbs
-     * @returns Array of all verbs
+     * Internal performance optimization: intelligently load verbs when beneficial
+     * @internal - Used by search, indexing, and caching optimizations
+     */
+    private _optimizedLoadAllVerbs;
+    /**
+     * Internal performance optimization: intelligently load nouns when beneficial
+     * @internal - Used by search, indexing, and caching optimizations
+     */
+    private _optimizedLoadAllNouns;
+    /**
+     * Intelligent decision making for when to preload all data
+     * @internal
+     */
+    private _shouldPreloadAllData;
+    /**
+     * Estimate if dataset size is reasonable for in-memory loading
+     * @internal
      */
-    getAllVerbs(): Promise<GraphVerb[]>;
+    private _isDatasetSizeReasonable;
     /**
      * Get verbs with pagination and filtering
      * @param options Pagination and filtering options

package/dist/brainyData.js

@@ -2146,26 +2146,8 @@ export class BrainyData {
         }
         return results;
     }
-    /**
-     * Get all nouns in the database
-     * @returns Array of vector documents
-     */
-    async getAllNouns() {
-        await this.ensureInitialized();
-        try {
-            // Use getNouns with no pagination to get all nouns
-            const result = await this.getNouns({
-                pagination: {
-                    limit: Number.MAX_SAFE_INTEGER // Request all nouns
-                }
-            });
-            return result.items;
-        }
-        catch (error) {
-            console.error('Failed to get all nouns:', error);
-            throw new Error(`Failed to get all nouns: ${error}`);
-        }
-    }
+    // getAllNouns() method removed - use getNouns() with pagination instead
+    // This method was dangerous and could cause expensive scans and memory issues
     /**
      * Get nouns with pagination and filtering
      * @param options Pagination and filtering options
@@ -2725,7 +2707,7 @@ export class BrainyData {
                     const scores = await this.intelligentVerbScoring.computeVerbScores(sourceId, targetId, verbType, options.weight, options.metadata);
                     finalWeight = scores.weight;
                     finalConfidence = scores.confidence;
-                    scoringReasoning = scores.reasoning;
+                    scoringReasoning = scores.reasoning || [];
                     if (this.loggingConfig?.verbose && scoringReasoning.length > 0) {
                         console.log(`Intelligent verb scoring for ${sourceId}-${verbType}-${targetId}:`, scoringReasoning);
                     }
@@ -2748,8 +2730,8 @@ export class BrainyData {
                 type: verbType, // Set the type property to match the verb type
                 weight: finalWeight,
                 confidence: finalConfidence, // Add confidence to metadata
-                intelligentScoring: scoringReasoning.length > 0 ? {
-                    reasoning: scoringReasoning,
+                intelligentScoring: this.intelligentVerbScoring?.enabled ? {
+                    reasoning: scoringReasoning.length > 0 ? scoringReasoning : [`Final weight ${finalWeight}`, `Base confidence ${finalConfidence || 0.5}`],
                     computedAt: new Date().toISOString()
                 } : undefined,
                 createdAt: timestamp,
@@ -2851,7 +2833,12 @@ export class BrainyData {
                 updatedAt: metadata.updatedAt,
                 createdBy: metadata.createdBy,
                 data: metadata.data,
-                metadata: metadata.data // Alias for backward compatibility
+                metadata: {
+                    ...metadata.data,
+                    weight: metadata.weight,
+                    confidence: metadata.confidence,
+                    ...(metadata.intelligentScoring && { intelligentScoring: metadata.intelligentScoring })
+                } // Complete metadata including intelligent scoring when available
             };
             return graphVerb;
         }
@@ -2861,47 +2848,94 @@ export class BrainyData {
         }
     }
     /**
-     * Get all verbs
-     * @returns Array of all verbs
+     * Internal performance optimization: intelligently load verbs when beneficial
+     * @internal - Used by search, indexing, and caching optimizations
      */
-    async getAllVerbs() {
-        await this.ensureInitialized();
-        try {
-            // Get all lightweight verbs from storage
-            const hnswVerbs = await this.storage.getAllVerbs();
-            // Convert each HNSWVerb to GraphVerb by loading metadata
-            const graphVerbs = [];
-            for (const hnswVerb of hnswVerbs) {
-                const metadata = await this.storage.getVerbMetadata(hnswVerb.id);
-                if (metadata) {
-                    const graphVerb = {
-                        id: hnswVerb.id,
-                        vector: hnswVerb.vector,
-                        sourceId: metadata.sourceId,
-                        targetId: metadata.targetId,
-                        source: metadata.source,
-                        target: metadata.target,
-                        verb: metadata.verb,
-                        type: metadata.type,
-                        weight: metadata.weight,
-                        createdAt: metadata.createdAt,
-                        updatedAt: metadata.updatedAt,
-                        createdBy: metadata.createdBy,
-                        data: metadata.data,
-                        metadata: metadata.data // Alias for backward compatibility
-                    };
-                    graphVerbs.push(graphVerb);
-                }
-                else {
-                    console.warn(`Verb ${hnswVerb.id} found but no metadata - skipping`);
-                }
+    async _optimizedLoadAllVerbs() {
+        // Only load all if it's safe and beneficial
+        if (await this._shouldPreloadAllData()) {
+            const result = await this.getVerbs({
+                pagination: { limit: Number.MAX_SAFE_INTEGER }
+            });
+            return result.items;
+        }
+        // Fall back to on-demand loading
+        return [];
+    }
+    /**
+     * Internal performance optimization: intelligently load nouns when beneficial
+     * @internal - Used by search, indexing, and caching optimizations
+     */
+    async _optimizedLoadAllNouns() {
+        // Only load all if it's safe and beneficial
+        if (await this._shouldPreloadAllData()) {
+            const result = await this.getNouns({
+                pagination: { limit: Number.MAX_SAFE_INTEGER }
+            });
+            return result.items;
+        }
+        // Fall back to on-demand loading
+        return [];
+    }
+    /**
+     * Intelligent decision making for when to preload all data
+     * @internal
+     */
+    async _shouldPreloadAllData() {
+        // Smart heuristics for performance optimization
+        // 1. Read-only mode is ideal for preloading
+        if (this.readOnly) {
+            return await this._isDatasetSizeReasonable();
+        }
+        // 2. Check available memory (Node.js)
+        if (typeof process !== 'undefined' && process.memoryUsage) {
+            const memUsage = process.memoryUsage();
+            const availableMemory = memUsage.heapTotal - memUsage.heapUsed;
+            const memoryMB = availableMemory / (1024 * 1024);
+            // Only preload if we have substantial free memory (>500MB)
+            if (memoryMB < 500) {
+                console.debug('Performance optimization: Skipping preload due to low memory');
+                return false;
             }
-            return graphVerbs;
         }
-        catch (error) {
-            console.error('Failed to get all verbs:', error);
-            throw new Error(`Failed to get all verbs: ${error}`);
+        // 3. Consider frozen/immutable mode  
+        if (this.frozen) {
+            return await this._isDatasetSizeReasonable();
         }
+        // 4. For frequent search operations, preloading can be beneficial
+        // TODO: Track search frequency and decide based on access patterns
+        return false; // Conservative default for write-heavy workloads
+    }
+    /**
+     * Estimate if dataset size is reasonable for in-memory loading
+     * @internal
+     */
+    async _isDatasetSizeReasonable() {
+        // Implement basic size estimation
+        // Check if we have recent statistics
+        const stats = await this.getStatistics();
+        if (stats) {
+            const totalEntities = Object.values(stats.nounCount || {}).reduce((a, b) => a + b, 0) +
+                Object.values(stats.verbCount || {}).reduce((a, b) => a + b, 0);
+            // Conservative thresholds
+            if (totalEntities > 100000) {
+                console.debug('Performance optimization: Dataset too large for preloading');
+                return false;
+            }
+            if (totalEntities < 10000) {
+                console.debug('Performance optimization: Small dataset - safe to preload');
+                return true;
+            }
+        }
+        // Medium datasets - check memory pressure
+        if (typeof process !== 'undefined' && process.memoryUsage) {
+            const memUsage = process.memoryUsage();
+            const heapUsedPercent = (memUsage.heapUsed / memUsage.heapTotal) * 100;
+            // Only preload if heap usage is low
+            return heapUsedPercent < 50;
+        }
+        // Default: conservative approach
+        return false;
     }
     /**
      * Get verbs with pagination and filtering
@@ -3679,19 +3713,40 @@ export class BrainyData {
             }
             // First use the HNSW index to find similar vectors efficiently
             const searchResults = await this.index.search(queryVector, k * 2);
-            // Get all verbs for filtering
-            const allVerbs = await this.getAllVerbs();
-            // Create a map of verb IDs for faster lookup
-            const verbMap = new Map();
-            for (const verb of allVerbs) {
-                verbMap.set(verb.id, verb);
+            // Intelligent verb loading: preload all if beneficial, otherwise on-demand
+            let verbMap = null;
+            let usePreloadedVerbs = false;
+            // Try to intelligently preload verbs for performance
+            const preloadedVerbs = await this._optimizedLoadAllVerbs();
+            if (preloadedVerbs.length > 0) {
+                verbMap = new Map();
+                for (const verb of preloadedVerbs) {
+                    verbMap.set(verb.id, verb);
+                }
+                usePreloadedVerbs = true;
+                console.debug(`Performance optimization: Preloaded ${preloadedVerbs.length} verbs for fast lookup`);
             }
+            // Fallback: on-demand verb loading function
+            const getVerbById = async (verbId) => {
+                if (usePreloadedVerbs && verbMap) {
+                    return verbMap.get(verbId) || null;
+                }
+                try {
+                    const verb = await this.getVerb(verbId);
+                    return verb;
+                }
+                catch (error) {
+                    console.warn(`Failed to load verb ${verbId}:`, error);
+                    return null;
+                }
+            };
             // Filter search results to only include verbs
             const verbResults = [];
+            // Process search results and load verbs on-demand
             for (const result of searchResults) {
                 // Search results are [id, distance] tuples
                 const [id, distance] = result;
-                const verb = verbMap.get(id);
+                const verb = await getVerbById(id);
                 if (verb) {
                     // If verb types are specified, check if this verb matches
                     if (options.verbTypes && options.verbTypes.length > 0) {
@@ -3721,8 +3776,11 @@ export class BrainyData {
                     }
                 }
                 else {
-                    // Use all verbs
-                    verbs = allVerbs;
+                    // Get all verbs with pagination
+                    const allVerbsResult = await this.getVerbs({
+                        pagination: { limit: 10000 }
+                    });
+                    verbs = allVerbsResult.items;
                 }
                 // Calculate similarity for each verb not already in results
                 const existingIds = new Set(verbResults.map((v) => v.id));
@@ -4248,10 +4306,18 @@ export class BrainyData {
     async backup() {
         await this.ensureInitialized();
         try {
-            // Get all nouns
-            const nouns = await this.getAllNouns();
-            // Get all verbs
-            const verbs = await this.getAllVerbs();
+            // Use intelligent loading for backup - this is a legitimate use case for full export
+            console.log('Creating backup - loading all data...');
+            // For backup, we legitimately need all data, so use large pagination
+            const nounsResult = await this.getNouns({
+                pagination: { limit: Number.MAX_SAFE_INTEGER }
+            });
+            const nouns = nounsResult.items;
+            const verbsResult = await this.getVerbs({
+                pagination: { limit: Number.MAX_SAFE_INTEGER }
+            });
+            const verbs = verbsResult.items;
+            console.log(`Backup: Loaded ${nouns.length} nouns and ${verbs.length} verbs`);
             // Get all noun types
             const nounTypes = Object.values(NounType);
             // Get all verb types

package/dist/coreTypes.d.ts

@@ -512,16 +512,4 @@ export interface StorageAdapter {
      * @returns Promise that resolves to an array of changes
      */
     getChangesSince?(timestamp: number, limit?: number): Promise<any[]>;
-    /**
-     * Get all nouns from storage
-     * @returns Promise that resolves to an array of all nouns
-     * @deprecated This method loads all data into memory and may cause performance issues. Use getNouns() with pagination instead.
-     */
-    getAllNouns(): Promise<HNSWNoun[]>;
-    /**
-     * Get all verbs from storage
-     * @returns Promise that resolves to an array of all HNSWVerbs
-     * @deprecated This method loads all data into memory and may cause performance issues. Use getVerbs() with pagination instead.
-     */
-    getAllVerbs(): Promise<HNSWVerb[]>;
 }

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

@@ -29,18 +29,6 @@ export declare abstract class BaseStorageAdapter implements StorageAdapter {
         quota: number | null;
         details?: Record<string, any>;
     }>;
-    /**
-     * Get all nouns from storage
-     * @returns Promise that resolves to an array of all nouns
-     * @deprecated This method loads all data into memory and may cause performance issues. Use getNouns() with pagination instead.
-     */
-    abstract getAllNouns(): Promise<any[]>;
-    /**
-     * Get all verbs from storage
-     * @returns Promise that resolves to an array of all HNSWVerbs
-     * @deprecated This method loads all data into memory and may cause performance issues. Use getVerbs() with pagination instead.
-     */
-    abstract getAllVerbs(): Promise<any[]>;
     /**
      * Get nouns with pagination and filtering
      * @param options Pagination and filtering options

package/dist/storage/adapters/opfsStorage.js

@@ -146,7 +146,7 @@ export class OPFSStorage extends BaseStorage {
                 connections: this.mapToObject(noun.connections, (set) => Array.from(set))
             };
             // Create or get the file for this noun
-            const fileHandle = await this.nounsDir.getFileHandle(noun.id, {
+            const fileHandle = await this.nounsDir.getFileHandle(`${noun.id}.json`, {
                 create: true
             });
             // Write the noun data to the file
@@ -166,7 +166,7 @@ export class OPFSStorage extends BaseStorage {
         await this.ensureInitialized();
         try {
             // Get the file handle for this noun
-            const fileHandle = await this.nounsDir.getFileHandle(id);
+            const fileHandle = await this.nounsDir.getFileHandle(`${id}.json`);
             // Read the noun data from the file
             const file = await fileHandle.getFile();
             const text = await file.text();
@@ -253,7 +253,7 @@ export class OPFSStorage extends BaseStorage {
     async deleteNode(id) {
         await this.ensureInitialized();
         try {
-            await this.nounsDir.removeEntry(id);
+            await this.nounsDir.removeEntry(`${id}.json`);
         }
         catch (error) {
             // Ignore NotFoundError, which means the file doesn't exist
@@ -281,7 +281,7 @@ export class OPFSStorage extends BaseStorage {
                 connections: this.mapToObject(edge.connections, (set) => Array.from(set))
             };
             // Create or get the file for this verb
-            const fileHandle = await this.verbsDir.getFileHandle(edge.id, {
+            const fileHandle = await this.verbsDir.getFileHandle(`${edge.id}.json`, {
                 create: true
             });
             // Write the verb data to the file
@@ -307,7 +307,7 @@ export class OPFSStorage extends BaseStorage {
         await this.ensureInitialized();
         try {
             // Get the file handle for this edge
-            const fileHandle = await this.verbsDir.getFileHandle(id);
+            const fileHandle = await this.verbsDir.getFileHandle(`${id}.json`);
             // Read the edge data from the file
             const file = await fileHandle.getFile();
             const text = await file.text();
@@ -389,10 +389,12 @@ export class OPFSStorage extends BaseStorage {
      * Get verbs by source (internal implementation)
      */
     async getVerbsBySource_internal(sourceId) {
-        // This method is deprecated and would require loading metadata for each edge
-        // For now, return empty array since this is not efficiently implementable with new storage pattern
-        console.warn('getVerbsBySource_internal is deprecated and not efficiently supported in new storage pattern');
-        return [];
+        // Use the paginated approach to properly handle HNSWVerb to GraphVerb conversion
+        const result = await this.getVerbsWithPagination({
+            filter: { sourceId: [sourceId] },
+            limit: Number.MAX_SAFE_INTEGER // Get all matching results
+        });
+        return result.items;
     }
     /**
      * Get edges by source
@@ -407,10 +409,12 @@ export class OPFSStorage extends BaseStorage {
      * Get verbs by target (internal implementation)
      */
     async getVerbsByTarget_internal(targetId) {
-        // This method is deprecated and would require loading metadata for each edge
-        // For now, return empty array since this is not efficiently implementable with new storage pattern
-        console.warn('getVerbsByTarget_internal is deprecated and not efficiently supported in new storage pattern');
-        return [];
+        // Use the paginated approach to properly handle HNSWVerb to GraphVerb conversion
+        const result = await this.getVerbsWithPagination({
+            filter: { targetId: [targetId] },
+            limit: Number.MAX_SAFE_INTEGER // Get all matching results
+        });
+        return result.items;
     }
     /**
      * Get edges by target
@@ -425,10 +429,12 @@ export class OPFSStorage extends BaseStorage {
      * Get verbs by type (internal implementation)
      */
     async getVerbsByType_internal(type) {
-        // This method is deprecated and would require loading metadata for each edge
-        // For now, return empty array since this is not efficiently implementable with new storage pattern
-        console.warn('getVerbsByType_internal is deprecated and not efficiently supported in new storage pattern');
-        return [];
+        // Use the paginated approach to properly handle HNSWVerb to GraphVerb conversion
+        const result = await this.getVerbsWithPagination({
+            filter: { verbType: [type] },
+            limit: Number.MAX_SAFE_INTEGER // Get all matching results
+        });
+        return result.items;
     }
     /**
      * Get edges by type
@@ -451,7 +457,7 @@ export class OPFSStorage extends BaseStorage {
     async deleteEdge(id) {
         await this.ensureInitialized();
         try {
-            await this.verbsDir.removeEntry(id);
+            await this.verbsDir.removeEntry(`${id}.json`);
         }
         catch (error) {
             // Ignore NotFoundError, which means the file doesn't exist
@@ -468,7 +474,7 @@ export class OPFSStorage extends BaseStorage {
         await this.ensureInitialized();
         try {
             // Create or get the file for this metadata
-            const fileHandle = await this.metadataDir.getFileHandle(id, {
+            const fileHandle = await this.metadataDir.getFileHandle(`${id}.json`, {
                 create: true
             });
             // Write the metadata to the file
@@ -488,7 +494,7 @@ export class OPFSStorage extends BaseStorage {
         await this.ensureInitialized();
         try {
             // Get the file handle for this metadata
-            const fileHandle = await this.metadataDir.getFileHandle(id);
+            const fileHandle = await this.metadataDir.getFileHandle(`${id}.json`);
             // Read the metadata from the file
             const file = await fileHandle.getFile();
             const text = await file.text();

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

@@ -305,26 +305,14 @@ export declare class S3CompatibleStorage extends BaseStorage {
      * Get verbs by source (internal implementation)
      */
     protected getVerbsBySource_internal(sourceId: string): Promise<GraphVerb[]>;
-    /**
-     * Get edges by source
-     */
-    protected getEdgesBySource(sourceId: string): Promise<GraphVerb[]>;
     /**
      * Get verbs by target (internal implementation)
      */
     protected getVerbsByTarget_internal(targetId: string): Promise<GraphVerb[]>;
-    /**
-     * Get edges by target
-     */
-    protected getEdgesByTarget(targetId: string): Promise<GraphVerb[]>;
     /**
      * Get verbs by type (internal implementation)
      */
     protected getVerbsByType_internal(type: string): Promise<GraphVerb[]>;
-    /**
-     * Get edges by type
-     */
-    protected getEdgesByType(type: string): Promise<GraphVerb[]>;
     /**
      * Delete a verb from storage (internal implementation)
      */

package/dist/storage/adapters/s3CompatibleStorage.js

@@ -381,15 +381,23 @@ export class S3CompatibleStorage extends BaseStorage {
         // Get metrics
         const backpressureStatus = this.backpressure.getStatus();
         const socketMetrics = this.socketManager.getMetrics();
-        // EXTREMELY aggressive detection - activate on ANY load
-        const shouldEnableHighVolume = this.forceHighVolumeMode || // Environment override
-            backpressureStatus.queueLength >= threshold || // Configurable threshold (>= 0 by default!)
-            socketMetrics.pendingRequests >= threshold || // Socket pressure
-            this.pendingOperations >= threshold || // Any pending ops
-            socketMetrics.socketUtilization >= 0.01 || // Even 1% socket usage
-            (socketMetrics.requestsPerSecond >= 1) || // Any request rate
-            (this.consecutiveErrors >= 0) || // Always true - any system activity
-            true; // FORCE ENABLE for emergency debugging
+        // Reasonable high-volume detection - only activate under real load
+        const isTestEnvironment = process.env.NODE_ENV === 'test';
+        const explicitlyDisabled = process.env.BRAINY_FORCE_BUFFERING === 'false';
+        // Use reasonable thresholds instead of emergency aggressive ones
+        const reasonableThreshold = Math.max(threshold, 10); // At least 10 pending operations
+        const highSocketUtilization = 0.8; // 80% socket utilization 
+        const highRequestRate = 50; // 50 requests per second
+        const significantErrors = 5; // 5 consecutive errors
+        const shouldEnableHighVolume = !isTestEnvironment && // Disable in test environment
+            !explicitlyDisabled && // Allow explicit disabling
+            (this.forceHighVolumeMode || // Environment override
+                backpressureStatus.queueLength >= reasonableThreshold || // High queue backlog
+                socketMetrics.pendingRequests >= reasonableThreshold || // Many pending requests
+                this.pendingOperations >= reasonableThreshold || // Many pending ops
+                socketMetrics.socketUtilization >= highSocketUtilization || // High socket pressure
+                (socketMetrics.requestsPerSecond >= highRequestRate) || // High request rate
+                (this.consecutiveErrors >= significantErrors)); // Significant error pattern
         if (shouldEnableHighVolume && !this.highVolumeMode) {
             this.highVolumeMode = true;
             this.logger.warn(`🚨 HIGH-VOLUME MODE ACTIVATED 🚨`);
@@ -1278,8 +1286,42 @@ export class S3CompatibleStorage extends BaseStorage {
                 graphVerbs.push(graphVerb);
             }
         }
+        // Apply filtering at GraphVerb level since HNSWVerb filtering is not supported
+        let filteredGraphVerbs = graphVerbs;
+        if (options.filter) {
+            filteredGraphVerbs = graphVerbs.filter((graphVerb) => {
+                // Filter by sourceId
+                if (options.filter.sourceId) {
+                    const sourceIds = Array.isArray(options.filter.sourceId)
+                        ? options.filter.sourceId
+                        : [options.filter.sourceId];
+                    if (!sourceIds.includes(graphVerb.sourceId)) {
+                        return false;
+                    }
+                }
+                // Filter by targetId
+                if (options.filter.targetId) {
+                    const targetIds = Array.isArray(options.filter.targetId)
+                        ? options.filter.targetId
+                        : [options.filter.targetId];
+                    if (!targetIds.includes(graphVerb.targetId)) {
+                        return false;
+                    }
+                }
+                // Filter by verbType (maps to type field)
+                if (options.filter.verbType) {
+                    const verbTypes = Array.isArray(options.filter.verbType)
+                        ? options.filter.verbType
+                        : [options.filter.verbType];
+                    if (graphVerb.type && !verbTypes.includes(graphVerb.type)) {
+                        return false;
+                    }
+                }
+                return true;
+            });
+        }
         return {
-            items: graphVerbs,
+            items: filteredGraphVerbs,
             hasMore: result.hasMore,
             nextCursor: result.nextCursor
         };
@@ -1288,46 +1330,34 @@ export class S3CompatibleStorage extends BaseStorage {
      * Get verbs by source (internal implementation)
      */
     async getVerbsBySource_internal(sourceId) {
-        return this.getEdgesBySource(sourceId);
-    }
-    /**
-     * Get edges by source
-     */
-    async getEdgesBySource(sourceId) {
-        // This method is deprecated and would require loading metadata for each edge
-        // For now, return empty array since this is not efficiently implementable with new storage pattern
-        this.logger.trace('getEdgesBySource is deprecated and not efficiently supported in new storage pattern');
-        return [];
+        // Use the paginated approach to properly handle HNSWVerb to GraphVerb conversion
+        const result = await this.getVerbsWithPagination({
+            filter: { sourceId: [sourceId] },
+            limit: Number.MAX_SAFE_INTEGER // Get all matching results
+        });
+        return result.items;
     }
     /**
      * Get verbs by target (internal implementation)
      */
     async getVerbsByTarget_internal(targetId) {
-        return this.getEdgesByTarget(targetId);
-    }
-    /**
-     * Get edges by target
-     */
-    async getEdgesByTarget(targetId) {
-        // This method is deprecated and would require loading metadata for each edge
-        // For now, return empty array since this is not efficiently implementable with new storage pattern
-        this.logger.trace('getEdgesByTarget is deprecated and not efficiently supported in new storage pattern');
-        return [];
+        // Use the paginated approach to properly handle HNSWVerb to GraphVerb conversion
+        const result = await this.getVerbsWithPagination({
+            filter: { targetId: [targetId] },
+            limit: Number.MAX_SAFE_INTEGER // Get all matching results
+        });
+        return result.items;
     }
     /**
      * Get verbs by type (internal implementation)
      */
     async getVerbsByType_internal(type) {
-        return this.getEdgesByType(type);
-    }
-    /**
-     * Get edges by type
-     */
-    async getEdgesByType(type) {
-        // This method is deprecated and would require loading metadata for each edge
-        // For now, return empty array since this is not efficiently implementable with new storage pattern
-        this.logger.trace('getEdgesByType is deprecated and not efficiently supported in new storage pattern');
-        return [];
+        // Use the paginated approach to properly handle HNSWVerb to GraphVerb conversion
+        const result = await this.getVerbsWithPagination({
+            filter: { verbType: [type] },
+            limit: Number.MAX_SAFE_INTEGER // Get all matching results
+        });
+        return result.items;
     }
     /**
      * Delete a verb from storage (internal implementation)

package/dist/storage/baseStorage.d.ts

@@ -72,11 +72,10 @@ export declare abstract class BaseStorage extends BaseStorageAdapter {
      */
     protected convertHNSWVerbToGraphVerb(hnswVerb: HNSWVerb): Promise<GraphVerb | null>;
     /**
-     * Get all verbs from storage
-     * @returns Promise that resolves to an array of all HNSWVerbs
-     * @deprecated This method loads all data into memory and may cause performance issues. Use getVerbs() with pagination instead.
+     * Internal method for loading all verbs - used by performance optimizations
+     * @internal - Do not use directly, use getVerbs() with pagination instead
      */
-    getAllVerbs(): Promise<HNSWVerb[]>;
+    protected _loadAllVerbsForOptimization(): Promise<HNSWVerb[]>;
     /**
      * Get verbs by source
      */
@@ -90,11 +89,10 @@ export declare abstract class BaseStorage extends BaseStorageAdapter {
      */
     getVerbsByType(type: string): Promise<GraphVerb[]>;
     /**
-     * Get all nouns from storage
-     * @returns Promise that resolves to an array of all nouns
-     * @deprecated This method loads all data into memory and may cause performance issues. Use getNouns() with pagination instead.
+     * Internal method for loading all nouns - used by performance optimizations
+     * @internal - Do not use directly, use getNouns() with pagination instead
      */
-    getAllNouns(): Promise<HNSWNoun[]>;
+    protected _loadAllNounsForOptimization(): Promise<HNSWNoun[]>;
     /**
      * Get nouns with pagination and filtering
      * @param options Pagination and filtering options

package/dist/storage/baseStorage.js

@@ -181,27 +181,22 @@ export class BaseStorage extends BaseStorageAdapter {
         }
     }
     /**
-     * Get all verbs from storage
-     * @returns Promise that resolves to an array of all HNSWVerbs
-     * @deprecated This method loads all data into memory and may cause performance issues. Use getVerbs() with pagination instead.
+     * Internal method for loading all verbs - used by performance optimizations
+     * @internal - Do not use directly, use getVerbs() with pagination instead
      */
-    async getAllVerbs() {
+    async _loadAllVerbsForOptimization() {
         await this.ensureInitialized();
-        console.warn('getAllVerbs() is deprecated and may cause memory issues with large datasets. Consider using getVerbs() with pagination instead.');
-        // Get all verbs using the paginated method with a very large limit
+        // Only use this for internal optimizations when safe
         const result = await this.getVerbs({
-            pagination: {
-                limit: Number.MAX_SAFE_INTEGER
-            }
+            pagination: { limit: Number.MAX_SAFE_INTEGER }
         });
-        // Convert GraphVerbs back to HNSWVerbs since that's what this method should return
+        // Convert GraphVerbs back to HNSWVerbs for internal use
         const hnswVerbs = [];
         for (const graphVerb of result.items) {
-            // Create an HNSWVerb from the GraphVerb (reverse conversion)
             const hnswVerb = {
                 id: graphVerb.id,
                 vector: graphVerb.vector,
-                connections: new Map() // HNSWVerbs need connections, but GraphVerbs don't have them
+                connections: new Map()
             };
             hnswVerbs.push(hnswVerb);
         }
@@ -241,17 +236,14 @@ export class BaseStorage extends BaseStorageAdapter {
         return result.items;
     }
     /**
-     * Get all nouns from storage
-     * @returns Promise that resolves to an array of all nouns
-     * @deprecated This method loads all data into memory and may cause performance issues. Use getNouns() with pagination instead.
+     * Internal method for loading all nouns - used by performance optimizations
+     * @internal - Do not use directly, use getNouns() with pagination instead
      */
-    async getAllNouns() {
+    async _loadAllNounsForOptimization() {
         await this.ensureInitialized();
-        console.warn('getAllNouns() is deprecated and may cause memory issues with large datasets. Consider using getNouns() with pagination instead.');
+        // Only use this for internal optimizations when safe
         const result = await this.getNouns({
-            pagination: {
-                limit: Number.MAX_SAFE_INTEGER
-            }
+            pagination: { limit: Number.MAX_SAFE_INTEGER }
         });
         return result.items;
     }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@soulcraft/brainy",
-  "version": "0.60.0",
-  "description": "A vector graph database using HNSW indexing with Origin Private File System storage",
+  "version": "0.61.0",
+  "description": "Multi-Dimensional AI Database - Vector similarity, graph relationships, metadata facets with HNSW indexing and OPFS storage",
   "main": "dist/index.js",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",