@soulcraft/brainy 3.19.1 → 3.20.0

package/dist/cli/index.js

@@ -9,6 +9,8 @@ import chalk from 'chalk';
 import { neuralCommands } from './commands/neural.js';
 import { coreCommands } from './commands/core.js';
 import { utilityCommands } from './commands/utility.js';
+import { vfsCommands } from './commands/vfs.js';
+import { dataCommands } from './commands/data.js';
 import conversationCommand from './commands/conversation.js';
 import { readFileSync } from 'fs';
 import { fileURLToPath } from 'url';
@@ -34,12 +36,29 @@ program
     .option('-m, --metadata <json>', 'Add metadata')
     .option('-t, --type <type>', 'Specify noun type')
     .action(coreCommands.add);
+program
+    .command('find <query>')
+    .description('Simple NLP search (just like code: brain.find("query"))')
+    .option('-k, --limit <number>', 'Number of results', '10')
+    .action(coreCommands.search);
 program
     .command('search <query>')
-    .description('Search the neural database')
+    .description('Advanced search with Triple Intelligence™ (vector + graph + field)')
     .option('-k, --limit <number>', 'Number of results', '10')
-    .option('-t, --threshold <number>', 'Similarity threshold')
-    .option('--metadata <json>', 'Filter by metadata')
+    .option('--offset <number>', 'Skip N results (pagination)')
+    .option('-t, --threshold <number>', 'Similarity threshold (0-1)', '0.7')
+    .option('--type <types>', 'Filter by type(s) - comma separated')
+    .option('--where <json>', 'Metadata filters (JSON)')
+    .option('--near <id>', 'Find items near this ID')
+    .option('--connected-to <id>', 'Connected to this entity')
+    .option('--connected-from <id>', 'Connected from this entity')
+    .option('--via <verbs>', 'Via these relationships - comma separated')
+    .option('--explain', 'Show scoring breakdown')
+    .option('--include-relations', 'Include entity relationships')
+    .option('--fusion <strategy>', 'Fusion strategy (adaptive|weighted|progressive)')
+    .option('--vector-weight <n>', 'Vector search weight (0-1)')
+    .option('--graph-weight <n>', 'Graph search weight (0-1)')
+    .option('--field-weight <n>', 'Field search weight (0-1)')
     .action(coreCommands.search);
 program
     .command('get <id>')
@@ -101,10 +120,14 @@ program
     .action(neuralCommands.hierarchy);
 program
     .command('path <from> <to>')
-    .description('Find semantic path between items')
+    .description('Find semantic path between items (v3.21.0)')
     .option('--steps', 'Show step-by-step path')
     .option('--max-hops <number>', 'Maximum path length', '5')
-    .action(neuralCommands.path);
+    .action(() => {
+    console.log(chalk.yellow('\n⚠️  Semantic path finding coming in v3.21.0'));
+    console.log(chalk.dim('This feature requires implementing graph traversal algorithms'));
+    console.log(chalk.dim('Use "brainy neighbors" and "brainy hierarchy" to explore connections'));
+});
 program
     .command('outliers')
     .alias('anomalies')
@@ -158,11 +181,182 @@ program
     .action(async () => {
     await conversationCommand.handler({ action: 'stats', _: [] });
 }));
+// ===== VFS Commands (Subcommand Group) =====
+program
+    .command('vfs')
+    .description('📁 Virtual File System operations')
+    .addCommand(new Command('read')
+    .argument('<path>', 'File path')
+    .description('Read file from VFS')
+    .option('-o, --output <file>', 'Save to local file')
+    .option('--encoding <encoding>', 'File encoding', 'utf-8')
+    .action((path, options) => {
+    vfsCommands.read(path, options);
+}))
+    .addCommand(new Command('write')
+    .argument('<path>', 'File path')
+    .description('Write file to VFS')
+    .option('-c, --content <content>', 'File content')
+    .option('-f, --file <file>', 'Read from local file')
+    .option('--encoding <encoding>', 'File encoding', 'utf-8')
+    .action((path, options) => {
+    vfsCommands.write(path, options);
+}))
+    .addCommand(new Command('ls')
+    .alias('list')
+    .argument('<path>', 'Directory path')
+    .description('List directory contents')
+    .option('-l, --long', 'Long format with details')
+    .option('-a, --all', 'Show hidden files')
+    .action((path, options) => {
+    vfsCommands.ls(path, options);
+}))
+    .addCommand(new Command('stat')
+    .argument('<path>', 'File/directory path')
+    .description('Get file/directory statistics')
+    .action((path, options) => {
+    vfsCommands.stat(path, options);
+}))
+    .addCommand(new Command('mkdir')
+    .argument('<path>', 'Directory path')
+    .description('Create directory')
+    .option('-p, --parents', 'Create parent directories')
+    .action((path, options) => {
+    vfsCommands.mkdir(path, options);
+}))
+    .addCommand(new Command('rm')
+    .argument('<path>', 'File/directory path')
+    .description('Remove file or directory')
+    .option('-r, --recursive', 'Remove recursively')
+    .option('-f, --force', 'Force removal')
+    .action((path, options) => {
+    vfsCommands.rm(path, options);
+}))
+    .addCommand(new Command('search')
+    .argument('<query>', 'Search query')
+    .description('Search files by content')
+    .option('--path <path>', 'Search within path')
+    .option('-l, --limit <number>', 'Max results', '10')
+    .option('--type <type>', 'File type filter')
+    .action((query, options) => {
+    vfsCommands.search(query, options);
+}))
+    .addCommand(new Command('similar')
+    .argument('<path>', 'File path')
+    .description('Find similar files')
+    .option('-l, --limit <number>', 'Max results', '10')
+    .option('-t, --threshold <number>', 'Similarity threshold', '0.7')
+    .action((path, options) => {
+    vfsCommands.similar(path, options);
+}))
+    .addCommand(new Command('tree')
+    .argument('<path>', 'Directory path')
+    .description('Show directory tree')
+    .option('-d, --depth <number>', 'Max depth', '3')
+    .action((path, options) => {
+    vfsCommands.tree(path, options);
+}));
+// ===== VFS Commands (Backward Compatibility - Deprecated) =====
+program
+    .command('vfs-read <path>')
+    .description('[DEPRECATED] Use: brainy vfs read <path>')
+    .option('-o, --output <file>', 'Save to local file')
+    .option('--encoding <encoding>', 'File encoding', 'utf-8')
+    .action((path, options) => {
+    console.log(chalk.yellow('⚠️  Command "vfs-read" is deprecated. Use: brainy vfs read'));
+    vfsCommands.read(path, options);
+});
+program
+    .command('vfs-write <path>')
+    .description('[DEPRECATED] Use: brainy vfs write <path>')
+    .option('-c, --content <content>', 'File content')
+    .option('-f, --file <file>', 'Read from local file')
+    .option('--encoding <encoding>', 'File encoding', 'utf-8')
+    .action((path, options) => {
+    console.log(chalk.yellow('⚠️  Command "vfs-write" is deprecated. Use: brainy vfs write'));
+    vfsCommands.write(path, options);
+});
+program
+    .command('vfs-ls <path>')
+    .alias('vfs-list')
+    .description('[DEPRECATED] Use: brainy vfs ls <path>')
+    .option('-l, --long', 'Long format with details')
+    .option('-a, --all', 'Show hidden files')
+    .action((path, options) => {
+    console.log(chalk.yellow('⚠️  Command "vfs-ls" is deprecated. Use: brainy vfs ls'));
+    vfsCommands.ls(path, options);
+});
+program
+    .command('vfs-stat <path>')
+    .description('[DEPRECATED] Use: brainy vfs stat <path>')
+    .action((path, options) => {
+    console.log(chalk.yellow('⚠️  Command "vfs-stat" is deprecated. Use: brainy vfs stat'));
+    vfsCommands.stat(path, options);
+});
+program
+    .command('vfs-mkdir <path>')
+    .description('[DEPRECATED] Use: brainy vfs mkdir <path>')
+    .option('-p, --parents', 'Create parent directories')
+    .action((path, options) => {
+    console.log(chalk.yellow('⚠️  Command "vfs-mkdir" is deprecated. Use: brainy vfs mkdir'));
+    vfsCommands.mkdir(path, options);
+});
+program
+    .command('vfs-rm <path>')
+    .description('[DEPRECATED] Use: brainy vfs rm <path>')
+    .option('-r, --recursive', 'Remove recursively')
+    .option('-f, --force', 'Force removal')
+    .action((path, options) => {
+    console.log(chalk.yellow('⚠️  Command "vfs-rm" is deprecated. Use: brainy vfs rm'));
+    vfsCommands.rm(path, options);
+});
+program
+    .command('vfs-search <query>')
+    .description('[DEPRECATED] Use: brainy vfs search <query>')
+    .option('--path <path>', 'Search within path')
+    .option('-l, --limit <number>', 'Max results', '10')
+    .option('--type <type>', 'File type filter')
+    .action((query, options) => {
+    console.log(chalk.yellow('⚠️  Command "vfs-search" is deprecated. Use: brainy vfs search'));
+    vfsCommands.search(query, options);
+});
+program
+    .command('vfs-similar <path>')
+    .description('[DEPRECATED] Use: brainy vfs similar <path>')
+    .option('-l, --limit <number>', 'Max results', '10')
+    .option('-t, --threshold <number>', 'Similarity threshold', '0.7')
+    .action((path, options) => {
+    console.log(chalk.yellow('⚠️  Command "vfs-similar" is deprecated. Use: brainy vfs similar'));
+    vfsCommands.similar(path, options);
+});
+program
+    .command('vfs-tree <path>')
+    .description('[DEPRECATED] Use: brainy vfs tree <path>')
+    .option('-d, --depth <number>', 'Max depth', '3')
+    .action((path, options) => {
+    console.log(chalk.yellow('⚠️  Command "vfs-tree" is deprecated. Use: brainy vfs tree'));
+    vfsCommands.tree(path, options);
+});
+// ===== Data Management Commands =====
+program
+    .command('backup <file>')
+    .description('Create database backup')
+    .option('--compress', 'Compress backup')
+    .action(dataCommands.backup);
+program
+    .command('restore <file>')
+    .description('Restore from backup')
+    .option('--merge', 'Merge with existing data (default: replace)')
+    .action(dataCommands.restore);
+program
+    .command('data-stats')
+    .description('Show detailed database statistics')
+    .action(dataCommands.stats);
 // ===== Utility Commands =====
 program
     .command('stats')
     .alias('statistics')
-    .description('Show database statistics')
+    .description('Show quick database statistics')
     .option('--by-service', 'Group by service')
     .option('--detailed', 'Show detailed stats')
     .action(utilityCommands.stats);
@@ -207,3 +401,4 @@ catch (error) {
 if (!process.argv.slice(2).length) {
     program.outputHelp();
 }
+//# sourceMappingURL=index.js.map

package/dist/cli/interactive.d.ts

@@ -108,6 +108,10 @@ export declare function showWelcome(): void;
  * Interactive command selector for beginners
  */
 export declare function promptCommand(): Promise<string>;
+/**
+ * Start interactive REPL mode
+ */
+export declare function startInteractiveMode(): Promise<void>;
 /**
  * Export all interactive components
  */
@@ -160,5 +164,6 @@ declare const _default: {
     ProgressTracker: typeof ProgressTracker;
     showWelcome: typeof showWelcome;
     promptCommand: typeof promptCommand;
+    startInteractiveMode: typeof startInteractiveMode;
 };
 export default _default;

package/dist/cli/interactive.js

@@ -6,7 +6,7 @@
  */
 import chalk from 'chalk';
 import inquirer from 'inquirer';
-import fuzzy from 'fuzzy';
+// import fuzzy from 'fuzzy'  // TODO: Install fuzzy package or remove dependency
 import ora from 'ora';
 import { getBrainyVersion } from '../utils/version.js';
 // Professional color scheme
@@ -108,12 +108,12 @@ export async function promptItemId(action, brain, allowMultiple = false) {
     let choices = [];
     if (brain) {
         try {
-            const recent = await brain.search('*', { limit: 10,
-                sortBy: 'timestamp',
-                descending: true
+            const recent = await brain.find({
+                query: '*',
+                limit: 10
             });
             choices = recent.map(item => ({
-                name: `${item.id} - ${item.content?.substring(0, 50)}...`,
+                name: `${item.id} - ${item.content?.substring(0, 50) || 'No content'}...`,
                 value: item.id,
                 short: item.id
             }));
@@ -420,8 +420,21 @@ export async function promptRelationship(brain) {
  * Smart command suggestions when user types wrong command
  */
 export function suggestCommand(input, availableCommands) {
-    const results = fuzzy.filter(input, availableCommands);
-    return results.slice(0, 3).map(r => r.string);
+    // Simple fuzzy matching without external dependency
+    // Filter commands that start with or contain the input
+    const matches = availableCommands
+        .filter(cmd => cmd.toLowerCase().includes(input.toLowerCase()))
+        .sort((a, b) => {
+        // Prefer commands that start with the input
+        const aStarts = a.toLowerCase().startsWith(input.toLowerCase());
+        const bStarts = b.toLowerCase().startsWith(input.toLowerCase());
+        if (aStarts && !bStarts)
+            return -1;
+        if (!aStarts && bStarts)
+            return 1;
+        return 0;
+    });
+    return matches.slice(0, 3);
 }
 /**
  * Beautiful error display with helpful context
@@ -519,6 +532,15 @@ export async function promptCommand() {
     });
     return command;
 }
+/**
+ * Start interactive REPL mode
+ */
+export async function startInteractiveMode() {
+    console.log(chalk.cyan('\n🧠 Brainy Interactive Mode\n'));
+    console.log(chalk.yellow('Interactive REPL mode coming in v3.20.0\n'));
+    console.log(chalk.dim('Use specific commands for now: brainy add, brainy search, etc.'));
+    process.exit(0);
+}
 /**
  * Export all interactive components
  */
@@ -538,5 +560,7 @@ export default {
     showError,
     ProgressTracker,
     showWelcome,
-    promptCommand
+    promptCommand,
+    startInteractiveMode
 };
+//# sourceMappingURL=interactive.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soulcraft/brainy",
-  "version": "3.19.1",
+  "version": "3.20.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",
@@ -128,6 +128,9 @@
     "README.md",
     "CHANGELOG.md"
   ],
+  "overrides": {
+    "boolean": "3.2.0"
+  },
   "devDependencies": {
     "@rollup/plugin-commonjs": "^28.0.6",
     "@rollup/plugin-node-resolve": "^16.0.1",