@soulcraft/brainy 3.19.1 → 3.20.1

package/bin/brainy-minimal.js

@@ -0,0 +1,82 @@
+#!/usr/bin/env node
+
+/**
+ * Brainy CLI - Minimal Version (Conversation Commands Only)
+ *
+ * This is a temporary minimal CLI that only includes working conversation commands
+ * Full CLI will be restored in version 3.20.0
+ */
+
+import { Command } from 'commander'
+import { readFileSync } from 'fs'
+import { dirname, join } from 'path'
+import { fileURLToPath } from 'url'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const packageJson = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf8'))
+
+const program = new Command()
+
+program
+  .name('brainy')
+  .description('🧠 Brainy - Infinite Agent Memory')
+  .version(packageJson.version)
+
+// Dynamically load conversation command
+const conversationCommand = await import('../dist/cli/commands/conversation.js').then(m => m.default)
+
+program
+  .command('conversation')
+  .alias('conv')
+  .description('💬 Infinite agent memory and context management')
+  .addCommand(
+    new Command('setup')
+      .description('Set up MCP server for Claude Code integration')
+      .action(async () => {
+        await conversationCommand.handler({ action: 'setup', _: [] })
+      })
+  )
+  .addCommand(
+    new Command('remove')
+      .description('Remove MCP server and clean up')
+      .action(async () => {
+        await conversationCommand.handler({ action: 'remove', _: [] })
+      })
+  )
+  .addCommand(
+    new Command('search')
+      .description('Search messages across conversations')
+      .requiredOption('-q, --query <query>', 'Search query')
+      .option('-c, --conversation-id <id>', 'Filter by conversation')
+      .option('-r, --role <role>', 'Filter by role')
+      .option('-l, --limit <number>', 'Maximum results', '10')
+      .action(async (options) => {
+        await conversationCommand.handler({ action: 'search', ...options, _: [] })
+      })
+  )
+  .addCommand(
+    new Command('context')
+      .description('Get relevant context for a query')
+      .requiredOption('-q, --query <query>', 'Context query')
+      .option('-l, --limit <number>', 'Maximum messages', '10')
+      .action(async (options) => {
+        await conversationCommand.handler({ action: 'context', ...options, _: [] })
+      })
+  )
+  .addCommand(
+    new Command('thread')
+      .description('Get full conversation thread')
+      .requiredOption('-c, --conversation-id <id>', 'Conversation ID')
+      .action(async (options) => {
+        await conversationCommand.handler({ action: 'thread', ...options, _: [] })
+      })
+  )
+  .addCommand(
+    new Command('stats')
+      .description('Show conversation statistics')
+      .action(async () => {
+        await conversationCommand.handler({ action: 'stats', _: [] })
+      })
+  )
+
+program.parse(process.argv)

package/dist/cli/commands/conversation.js

@@ -250,6 +250,8 @@ main()
         });
         await brain.init();
         spinner.succeed('Initialized Brainy database');
+        // Shutdown Brainy to release resources
+        await brain.close();
         // Success!
         console.log(chalk.bold.green('\n✅ Setup complete!\n'));
         console.log(chalk.cyan('📁 Memory storage:'), brainyDir);
@@ -367,6 +369,7 @@ async function handleSearch(argv) {
     spinner.succeed(`Found ${results.length} messages`);
     if (results.length === 0) {
         console.log(chalk.yellow('No messages found'));
+        await brain.close();
         return;
     }
     // Display results
@@ -376,6 +379,7 @@ async function handleSearch(argv) {
         console.log(chalk.dim(`  Score: ${result.score.toFixed(3)} | Conv: ${result.conversationId}`));
         console.log();
     }
+    await brain.close();
 }
 /**
  * Handle context command - Get relevant context
@@ -398,6 +402,7 @@ async function handleContext(argv) {
     spinner.succeed(`Retrieved ${context.messages.length} relevant messages`);
     if (context.messages.length === 0) {
         console.log(chalk.yellow('No relevant context found'));
+        await brain.close();
         return;
     }
     // Display context
@@ -420,6 +425,7 @@ async function handleContext(argv) {
             console.log(chalk.dim(`  - ${conv.title || conv.id} (${conv.relevance.toFixed(2)})`));
         }
     }
+    await brain.close();
 }
 /**
  * Handle thread command - Get conversation thread
@@ -452,6 +458,7 @@ async function handleThread(argv) {
         console.log(chalk.cyan(`${msg.role}:`), msg.content);
         console.log(chalk.dim(`  ${new Date(msg.createdAt).toLocaleString()}`));
     }
+    await brain.close();
 }
 /**
  * Handle stats command - Show statistics
@@ -487,6 +494,7 @@ async function handleStats(argv) {
             console.log(chalk.dim(`  ${phase}: ${count}`));
         }
     }
+    await brain.close();
 }
 /**
  * Handle export command - Export conversation
@@ -505,6 +513,7 @@ async function handleExport(argv) {
     const output = argv.output || `conversation_${argv.conversationId}.json`;
     await fs.writeFile(output, JSON.stringify(exported, null, 2), 'utf8');
     spinner.succeed(`Exported to ${output}`);
+    await brain.close();
 }
 /**
  * Handle import command - Import conversation
@@ -523,6 +532,7 @@ async function handleImport(argv) {
     const data = JSON.parse(await fs.readFile(inputFile, 'utf8'));
     const conversationId = await conv.importConversation(data);
     spinner.succeed(`Imported as conversation ${conversationId}`);
+    await brain.close();
 }
 export default conversationCommand;
 //# sourceMappingURL=conversation.js.map

package/dist/cli/commands/core.d.ts

@@ -15,8 +15,20 @@ interface AddOptions extends CoreOptions {
 }
 interface SearchOptions extends CoreOptions {
     limit?: string;
+    offset?: string;
     threshold?: string;
-    metadata?: string;
+    type?: string;
+    where?: string;
+    near?: string;
+    connectedTo?: string;
+    connectedFrom?: string;
+    via?: string;
+    explain?: boolean;
+    includeRelations?: boolean;
+    fusion?: string;
+    vectorWeight?: string;
+    graphWeight?: string;
+    fieldWeight?: string;
 }
 interface GetOptions extends CoreOptions {
     withConnections?: boolean;
@@ -38,7 +50,7 @@ export declare const coreCommands: {
      */
     add(text: string, options: AddOptions): Promise<void>;
     /**
-     * Search the neural database
+     * Search the neural database with Triple Intelligence™
      */
     search(query: string, options: SearchOptions): Promise<void>;
     /**

package/dist/cli/commands/core.js

@@ -9,10 +9,9 @@ import { readFileSync, writeFileSync } from 'node:fs';
 import { Brainy } from '../../brainy.js';
 import { BrainyTypes, NounType } from '../../index.js';
 let brainyInstance = null;
-const getBrainy = async () => {
+const getBrainy = () => {
     if (!brainyInstance) {
         brainyInstance = new Brainy();
-        await brainyInstance.init();
     }
     return brainyInstance;
 };
@@ -28,7 +27,7 @@ export const coreCommands = {
     async add(text, options) {
         const spinner = ora('Adding to neural database...').start();
         try {
-            const brain = await getBrainy();
+            const brain = getBrainy();
             let metadata = {};
             if (options.metadata) {
                 try {
@@ -93,43 +92,157 @@ export const coreCommands = {
         }
     },
     /**
-     * Search the neural database
+     * Search the neural database with Triple Intelligence™
      */
     async search(query, options) {
-        const spinner = ora('Searching neural database...').start();
+        const spinner = ora('Searching with Triple Intelligence™...').start();
         try {
-            const brain = await getBrainy();
-            const searchOptions = {
+            const brain = getBrainy();
+            // Build comprehensive search params
+            const searchParams = {
+                query,
                 limit: options.limit ? parseInt(options.limit) : 10
             };
+            // Pagination
+            if (options.offset) {
+                searchParams.offset = parseInt(options.offset);
+            }
+            // Vector Intelligence - similarity threshold
             if (options.threshold) {
-                searchOptions.threshold = parseFloat(options.threshold);
+                searchParams.near = { threshold: parseFloat(options.threshold) };
             }
-            if (options.metadata) {
+            // Metadata Intelligence - type filtering
+            if (options.type) {
+                const types = options.type.split(',').map(t => t.trim());
+                searchParams.type = types.length === 1 ? types[0] : types;
+            }
+            // Metadata Intelligence - field filtering
+            if (options.where) {
                 try {
-                    searchOptions.filter = JSON.parse(options.metadata);
+                    searchParams.where = JSON.parse(options.where);
                 }
                 catch {
-                    spinner.fail('Invalid metadata filter JSON');
+                    spinner.fail('Invalid --where JSON');
+                    console.log(chalk.dim('Example: --where \'{"status":"active","priority":{"$gte":5}}\''));
                     process.exit(1);
                 }
             }
-            const results = await brain.search(query, searchOptions.limit);
+            // Vector Intelligence - proximity search
+            if (options.near) {
+                searchParams.near = {
+                    id: options.near,
+                    threshold: options.threshold ? parseFloat(options.threshold) : 0.7
+                };
+            }
+            // Graph Intelligence - connection constraints
+            if (options.connectedTo || options.connectedFrom || options.via) {
+                searchParams.connected = {};
+                if (options.connectedTo) {
+                    searchParams.connected.to = options.connectedTo;
+                }
+                if (options.connectedFrom) {
+                    searchParams.connected.from = options.connectedFrom;
+                }
+                if (options.via) {
+                    const vias = options.via.split(',').map(v => v.trim());
+                    searchParams.connected.via = vias.length === 1 ? vias[0] : vias;
+                }
+            }
+            // Explanation
+            if (options.explain) {
+                searchParams.explain = true;
+            }
+            // Include relationships
+            if (options.includeRelations) {
+                searchParams.includeRelations = true;
+            }
+            // Triple Intelligence Fusion - custom weighting
+            if (options.fusion || options.vectorWeight || options.graphWeight || options.fieldWeight) {
+                searchParams.fusion = {
+                    strategy: options.fusion || 'adaptive',
+                    weights: {}
+                };
+                if (options.vectorWeight) {
+                    searchParams.fusion.weights.vector = parseFloat(options.vectorWeight);
+                }
+                if (options.graphWeight) {
+                    searchParams.fusion.weights.graph = parseFloat(options.graphWeight);
+                }
+                if (options.fieldWeight) {
+                    searchParams.fusion.weights.field = parseFloat(options.fieldWeight);
+                }
+            }
+            const results = await brain.find(searchParams);
             spinner.succeed(`Found ${results.length} results`);
             if (!options.json) {
                 if (results.length === 0) {
-                    console.log(chalk.yellow('No results found'));
+                    console.log(chalk.yellow('\nNo results found'));
+                    // Show helpful hints
+                    console.log(chalk.dim('\nTips:'));
+                    console.log(chalk.dim('  • Try different search terms'));
+                    console.log(chalk.dim('  • Remove filters (--type, --where, --connected-to)'));
+                    console.log(chalk.dim('  • Lower the --threshold value'));
                 }
                 else {
+                    console.log(chalk.cyan(`\n📊 Triple Intelligence Results:\n`));
                     results.forEach((result, i) => {
-                        console.log(chalk.cyan(`\n${i + 1}. ${result.content || result.id}`));
+                        const entity = result.entity || result;
+                        console.log(chalk.bold(`${i + 1}. ${entity.id}`));
+                        // Show score with breakdown
                         if (result.score !== undefined) {
-                            console.log(chalk.dim(`   Similarity: ${(result.score * 100).toFixed(1)}%`));
+                            console.log(chalk.green(`   Score: ${(result.score * 100).toFixed(1)}%`));
+                            if (options.explain && result.scores) {
+                                const scores = result.scores;
+                                if (scores.vector !== undefined) {
+                                    console.log(chalk.dim(`     Vector: ${(scores.vector * 100).toFixed(1)}%`));
+                                }
+                                if (scores.graph !== undefined) {
+                                    console.log(chalk.dim(`     Graph: ${(scores.graph * 100).toFixed(1)}%`));
+                                }
+                                if (scores.field !== undefined) {
+                                    console.log(chalk.dim(`     Field: ${(scores.field * 100).toFixed(1)}%`));
+                                }
+                            }
+                        }
+                        // Show type
+                        if (entity.type) {
+                            console.log(chalk.dim(`   Type: ${entity.type}`));
+                        }
+                        // Show content preview
+                        if (entity.content) {
+                            const preview = entity.content.substring(0, 80);
+                            console.log(chalk.dim(`   Content: ${preview}${entity.content.length > 80 ? '...' : ''}`));
+                        }
+                        // Show metadata
+                        if (entity.metadata && Object.keys(entity.metadata).length > 0) {
+                            console.log(chalk.dim(`   Metadata: ${JSON.stringify(entity.metadata)}`));
                         }
-                        if (result.entity && result.entity.metadata) {
-                            console.log(chalk.dim(`   Metadata: ${JSON.stringify(result.entity.metadata)}`));
+                        // Show relationships
+                        if (options.includeRelations && result.relations) {
+                            const relations = result.relations;
+                            if (relations.length > 0) {
+                                console.log(chalk.dim(`   Relations: ${relations.length} connections`));
+                            }
                         }
+                        console.log();
                     });
+                    // Show search summary
+                    console.log(chalk.cyan('Search Configuration:'));
+                    if (searchParams.type) {
+                        console.log(chalk.dim(`  Type filter: ${Array.isArray(searchParams.type) ? searchParams.type.join(', ') : searchParams.type}`));
+                    }
+                    if (searchParams.where) {
+                        console.log(chalk.dim(`  Field filter: ${JSON.stringify(searchParams.where)}`));
+                    }
+                    if (searchParams.connected) {
+                        console.log(chalk.dim(`  Graph filter: ${JSON.stringify(searchParams.connected)}`));
+                    }
+                    if (searchParams.fusion) {
+                        console.log(chalk.dim(`  Fusion: ${searchParams.fusion.strategy}`));
+                        if (searchParams.fusion.weights && Object.keys(searchParams.fusion.weights).length > 0) {
+                            console.log(chalk.dim(`  Weights: ${JSON.stringify(searchParams.fusion.weights)}`));
+                        }
+                    }
                 }
             }
             else {
@@ -139,6 +252,9 @@ export const coreCommands = {
         catch (error) {
             spinner.fail('Search failed');
             console.error(chalk.red(error.message));
+            if (options.verbose) {
+                console.error(chalk.dim(error.stack));
+            }
             process.exit(1);
         }
     },
@@ -148,22 +264,21 @@ export const coreCommands = {
     async get(id, options) {
         const spinner = ora('Fetching item...').start();
         try {
-            const brain = await getBrainy();
+            const brain = getBrainy();
             // Try to get the item
-            const results = await brain.search(id, 1);
-            if (results.length === 0) {
+            const item = await brain.get(id);
+            if (!item) {
                 spinner.fail('Item not found');
                 console.log(chalk.yellow(`No item found with ID: ${id}`));
                 process.exit(1);
             }
-            const item = results[0];
             spinner.succeed('Item found');
             if (!options.json) {
                 console.log(chalk.cyan('\nItem Details:'));
                 console.log(`  ID: ${item.id}`);
                 console.log(`  Content: ${item.content || 'N/A'}`);
-                if (item.entity && item.entity.metadata) {
-                    console.log(`  Metadata: ${JSON.stringify(item.entity.metadata, null, 2)}`);
+                if (item.metadata) {
+                    console.log(`  Metadata: ${JSON.stringify(item.metadata, null, 2)}`);
                 }
                 if (options.withConnections) {
                     // Get verbs/relationships
@@ -193,7 +308,7 @@ export const coreCommands = {
     async relate(source, verb, target, options) {
         const spinner = ora('Creating relationship...').start();
         try {
-            const brain = await getBrainy();
+            const brain = getBrainy();
             let metadata = {};
             if (options.metadata) {
                 try {
@@ -238,7 +353,7 @@ export const coreCommands = {
     async import(file, options) {
         const spinner = ora('Importing data...').start();
         try {
-            const brain = await getBrainy();
+            const brain = getBrainy();
             const format = options.format || 'json';
             const batchSize = options.batchSize ? parseInt(options.batchSize) : 100;
             // Read file content
@@ -324,7 +439,7 @@ export const coreCommands = {
     async export(file, options) {
         const spinner = ora('Exporting database...').start();
         try {
-            const brain = await getBrainy();
+            const brain = getBrainy();
             const format = options.format || 'json';
             // Export all data
             const dataApi = await brain.data();
@@ -390,3 +505,4 @@ export const coreCommands = {
         }
     }
 };
+//# sourceMappingURL=core.js.map

package/dist/cli/commands/data.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Data Management Commands
+ *
+ * Backup, restore, import, export operations
+ */
+interface DataOptions {
+    verbose?: boolean;
+    json?: boolean;
+    pretty?: boolean;
+}
+export declare const dataCommands: {
+    /**
+     * Backup database
+     */
+    backup(file: string, options: DataOptions & {
+        compress?: boolean;
+    }): Promise<void>;
+    /**
+     * Restore from backup
+     */
+    restore(file: string, options: DataOptions & {
+        merge?: boolean;
+    }): Promise<void>;
+    /**
+     * Get database statistics
+     */
+    stats(options: DataOptions): Promise<void>;
+};
+export {};

package/dist/cli/commands/data.js

@@ -0,0 +1,139 @@
+/**
+ * Data Management Commands
+ *
+ * Backup, restore, import, export operations
+ */
+import chalk from 'chalk';
+import ora from 'ora';
+import { readFileSync, writeFileSync } from 'node:fs';
+import { Brainy } from '../../brainy.js';
+let brainyInstance = null;
+const getBrainy = () => {
+    if (!brainyInstance) {
+        brainyInstance = new Brainy();
+    }
+    return brainyInstance;
+};
+const formatOutput = (data, options) => {
+    if (options.json) {
+        console.log(options.pretty ? JSON.stringify(data, null, 2) : JSON.stringify(data));
+    }
+};
+export const dataCommands = {
+    /**
+     * Backup database
+     */
+    async backup(file, options) {
+        const spinner = ora('Creating backup...').start();
+        try {
+            const brain = getBrainy();
+            const dataApi = await brain.data();
+            const backup = await dataApi.backup({
+                compress: options.compress
+            });
+            spinner.text = 'Writing backup file...';
+            // Write backup to file
+            const content = typeof backup === 'string'
+                ? backup
+                : JSON.stringify(backup, null, options.pretty ? 2 : 0);
+            writeFileSync(file, content);
+            spinner.succeed('Backup created');
+            if (!options.json) {
+                console.log(chalk.green(`✓ Backup saved to: ${file}`));
+                if (backup.compressed) {
+                    console.log(chalk.dim(`  Original size: ${formatBytes(backup.originalSize)}`));
+                    console.log(chalk.dim(`  Compressed size: ${formatBytes(backup.compressedSize)}`));
+                    console.log(chalk.dim(`  Compression ratio: ${((backup.compressedSize / backup.originalSize) * 100).toFixed(1)}%`));
+                }
+            }
+            else {
+                formatOutput({ file, backup: true }, options);
+            }
+        }
+        catch (error) {
+            spinner.fail('Backup failed');
+            console.error(chalk.red(error.message));
+            process.exit(1);
+        }
+    },
+    /**
+     * Restore from backup
+     */
+    async restore(file, options) {
+        const spinner = ora('Restoring from backup...').start();
+        try {
+            const brain = getBrainy();
+            const dataApi = await brain.data();
+            // Read backup file
+            const content = readFileSync(file, 'utf-8');
+            const backup = JSON.parse(content);
+            // Restore
+            await dataApi.restore({
+                backup,
+                merge: options.merge || false
+            });
+            spinner.succeed('Restore complete');
+            if (!options.json) {
+                console.log(chalk.green(`✓ Restored from: ${file}`));
+                if (options.merge) {
+                    console.log(chalk.dim('  Mode: Merged with existing data'));
+                }
+                else {
+                    console.log(chalk.dim('  Mode: Replaced all data'));
+                }
+            }
+            else {
+                formatOutput({ file, restored: true }, options);
+            }
+        }
+        catch (error) {
+            spinner.fail('Restore failed');
+            console.error(chalk.red(error.message));
+            process.exit(1);
+        }
+    },
+    /**
+     * Get database statistics
+     */
+    async stats(options) {
+        const spinner = ora('Gathering statistics...').start();
+        try {
+            const brain = getBrainy();
+            const dataApi = await brain.data();
+            const stats = await dataApi.getStats();
+            spinner.succeed('Statistics gathered');
+            if (!options.json) {
+                console.log(chalk.cyan('\n📊 Database Statistics:\n'));
+                console.log(chalk.bold('Entities:'));
+                console.log(`  Total: ${chalk.green(stats.entities)}`);
+                console.log(chalk.bold('\nRelationships:'));
+                console.log(`  Total: ${chalk.green(stats.relations)}`);
+                if (stats.storageSize) {
+                    console.log(chalk.bold('\nStorage:'));
+                    console.log(`  Size: ${chalk.green(formatBytes(stats.storageSize))}`);
+                }
+                if (stats.vectorDimensions) {
+                    console.log(chalk.bold('\nVector Index:'));
+                    console.log(`  Dimensions: ${stats.vectorDimensions}`);
+                }
+            }
+            else {
+                formatOutput(stats, options);
+            }
+        }
+        catch (error) {
+            spinner.fail('Failed to get statistics');
+            console.error(chalk.red(error.message));
+            process.exit(1);
+        }
+    }
+};
+function formatBytes(bytes) {
+    if (bytes === 0)
+        return '0 B';
+    const k = 1024;
+    const sizes = ['B', 'KB', 'MB', 'GB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return parseFloat((bytes / Math.pow(k, i)).toFixed(2)) + ' ' + sizes[i];
+}
+//# sourceMappingURL=data.js.map

package/dist/cli/commands/neural.d.ts

@@ -22,4 +22,18 @@ export declare const neuralCommand: {
     builder: (yargs: any) => any;
     handler: (argv: CommandArguments) => Promise<void>;
 };
+declare function handleSimilarCommand(neural: any, argv: CommandArguments): Promise<void>;
+declare function handleClustersCommand(neural: any, argv: CommandArguments): Promise<void>;
+declare function handleHierarchyCommand(neural: any, argv: CommandArguments): Promise<void>;
+declare function handleNeighborsCommand(neural: any, argv: CommandArguments): Promise<void>;
+declare function handleOutliersCommand(neural: any, argv: CommandArguments): Promise<void>;
+declare function handleVisualizeCommand(neural: any, argv: CommandArguments): Promise<void>;
+export declare const neuralCommands: {
+    similar: typeof handleSimilarCommand;
+    cluster: typeof handleClustersCommand;
+    hierarchy: typeof handleHierarchyCommand;
+    related: typeof handleNeighborsCommand;
+    outliers: typeof handleOutliersCommand;
+    visualize: typeof handleVisualizeCommand;
+};
 export default neuralCommand;