ruvector 0.1.75 → 0.1.76

package/bin/cli.js

@@ -2999,14 +2999,58 @@ exec node "$RUVECTOR_CLI" "$@"
 
   // Advanced hooks (unless --minimal)
   if (!opts.minimal) {
-    // UserPromptSubmit - context suggestions on each prompt
+    // Create agentic-flow fast wrapper for background workers
+    let workersCmd = 'npx agentic-flow@alpha';
+    if (opts.fast && !isWindows) {
+      const agenticFastPath = path.join(settingsDir, 'agentic-flow-fast.sh');
+      const agenticFastContent = `#!/bin/bash
+# Fast agentic-flow wrapper - avoids npx overhead
+# Usage: .claude/agentic-flow-fast.sh workers <command> [args...]
+
+# Find agentic-flow CLI
+if [ -f "$PWD/node_modules/agentic-flow/bin/cli.js" ]; then
+  exec node "$PWD/node_modules/agentic-flow/bin/cli.js" "$@"
+elif [ -f "$PWD/node_modules/.bin/agentic-flow" ]; then
+  exec "$PWD/node_modules/.bin/agentic-flow" "$@"
+elif command -v agentic-flow &> /dev/null; then
+  exec agentic-flow "$@"
+else
+  exec npx agentic-flow@alpha "$@"
+fi
+`;
+      fs.writeFileSync(agenticFastPath, agenticFastContent);
+      fs.chmodSync(agenticFastPath, '755');
+      workersCmd = '.claude/agentic-flow-fast.sh';
+      // Add permission for agentic-flow fast wrapper
+      if (settings.permissions && settings.permissions.allow) {
+        if (!settings.permissions.allow.includes('Bash(.claude/agentic-flow-fast.sh:*)')) {
+          settings.permissions.allow.push('Bash(.claude/agentic-flow-fast.sh:*)');
+        }
+      }
+      console.log(chalk.blue('  ✓ Background workers wrapper created (.claude/agentic-flow-fast.sh)'));
+    }
+
+    // UserPromptSubmit - context suggestions + background workers dispatch
     settings.hooks.UserPromptSubmit = [{
-      hooks: [{
-        type: 'command',
-        timeout: fastTimeouts.complex,
-        command: `${hookCmd} hooks suggest-context 2>/dev/null || true`
-      }]
+      hooks: [
+        {
+          type: 'command',
+          timeout: fastTimeouts.complex,
+          command: `${hookCmd} hooks suggest-context 2>/dev/null || true`
+        },
+        {
+          type: 'command',
+          timeout: 2000,
+          command: `${workersCmd} workers dispatch-prompt "$CLAUDE_USER_PROMPT" 2>/dev/null || true`
+        },
+        {
+          type: 'command',
+          timeout: 1000,
+          command: `${workersCmd} workers inject-context "$CLAUDE_USER_PROMPT" 2>/dev/null || true`
+        }
+      ]
     }];
+    console.log(chalk.blue('  ✓ Background workers integration (ultralearn, optimize, audit, map, etc.)'));
 
     // PreCompact - preserve important context before compaction
     settings.hooks.PreCompact = [
@@ -5984,6 +6028,103 @@ ${focus.description}` : null
     console.log(chalk.dim(`\nFocus mode "${opts.focus}": ${focus.description}`));
   });
 
+// Workers command group - Background analysis via agentic-flow
+const workersCmd = program.command('workers').description('Background analysis workers (via agentic-flow)');
+
+// Helper to run agentic-flow workers command
+async function runAgenticFlow(args) {
+  const { spawn } = require('child_process');
+  return new Promise((resolve, reject) => {
+    const proc = spawn('npx', ['agentic-flow@alpha', ...args], {
+      stdio: 'inherit',
+      shell: true
+    });
+    proc.on('close', code => code === 0 ? resolve() : reject(new Error(`Exit code ${code}`)));
+    proc.on('error', reject);
+  });
+}
+
+workersCmd.command('dispatch')
+  .description('Dispatch background worker for analysis')
+  .argument('<prompt...>', 'Prompt with trigger keyword (ultralearn, optimize, audit, map, etc.)')
+  .action(async (prompt) => {
+    try {
+      await runAgenticFlow(['workers', 'dispatch', prompt.join(' ')]);
+    } catch (e) {
+      console.error(chalk.red('Worker dispatch failed:'), e.message);
+    }
+  });
+
+workersCmd.command('status')
+  .description('Show worker status dashboard')
+  .argument('[workerId]', 'Specific worker ID')
+  .action(async (workerId) => {
+    try {
+      const args = ['workers', 'status'];
+      if (workerId) args.push(workerId);
+      await runAgenticFlow(args);
+    } catch (e) {
+      console.error(chalk.red('Status check failed:'), e.message);
+    }
+  });
+
+workersCmd.command('results')
+  .description('Show worker analysis results')
+  .option('--json', 'Output as JSON')
+  .action(async (opts) => {
+    try {
+      const args = ['workers', 'results'];
+      if (opts.json) args.push('--json');
+      await runAgenticFlow(args);
+    } catch (e) {
+      console.error(chalk.red('Results fetch failed:'), e.message);
+    }
+  });
+
+workersCmd.command('triggers')
+  .description('List available trigger keywords')
+  .action(async () => {
+    try {
+      await runAgenticFlow(['workers', 'triggers']);
+    } catch (e) {
+      console.error(chalk.red('Triggers list failed:'), e.message);
+    }
+  });
+
+workersCmd.command('stats')
+  .description('Show worker statistics (24h)')
+  .action(async () => {
+    try {
+      await runAgenticFlow(['workers', 'stats']);
+    } catch (e) {
+      console.error(chalk.red('Stats failed:'), e.message);
+    }
+  });
+
+workersCmd.command('cleanup')
+  .description('Cleanup old worker records')
+  .option('--keep <days>', 'Keep records for N days', '7')
+  .action(async (opts) => {
+    try {
+      await runAgenticFlow(['workers', 'cleanup', '--keep', opts.keep]);
+    } catch (e) {
+      console.error(chalk.red('Cleanup failed:'), e.message);
+    }
+  });
+
+workersCmd.command('cancel')
+  .description('Cancel a running worker')
+  .argument('<workerId>', 'Worker ID to cancel')
+  .action(async (workerId) => {
+    try {
+      await runAgenticFlow(['workers', 'cancel', workerId]);
+    } catch (e) {
+      console.error(chalk.red('Cancel failed:'), e.message);
+    }
+  });
+
+console.log && false; // Force registration
+
 // MCP Server command
 const mcpCmd = program.command('mcp').description('MCP (Model Context Protocol) server for Claude Code integration');
 

package/bin/mcp-server.js

@@ -916,6 +916,60 @@ const TOOLS = [
       properties: {},
       required: []
     }
+  },
+  // ============================================
+  // BACKGROUND WORKERS TOOLS (via agentic-flow)
+  // ============================================
+  {
+    name: 'workers_dispatch',
+    description: 'Dispatch a background worker for analysis (ultralearn, optimize, audit, map, etc.)',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        prompt: { type: 'string', description: 'Prompt with trigger keyword (e.g., "ultralearn authentication")' }
+      },
+      required: ['prompt']
+    }
+  },
+  {
+    name: 'workers_status',
+    description: 'Get background worker status dashboard',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        workerId: { type: 'string', description: 'Specific worker ID (optional)' }
+      },
+      required: []
+    }
+  },
+  {
+    name: 'workers_results',
+    description: 'Get analysis results from completed workers',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        json: { type: 'boolean', description: 'Return as JSON', default: false }
+      },
+      required: []
+    }
+  },
+  {
+    name: 'workers_triggers',
+    description: 'List available trigger keywords for workers',
+    inputSchema: {
+      type: 'object',
+      properties: {},
+      required: []
+    }
+  },
+  {
+    name: 'workers_stats',
+    description: 'Get worker statistics (24h)',
+    inputSchema: {
+      type: 'object',
+      properties: {},
+      required: []
+    }
   }
 ];
 
@@ -2066,6 +2120,123 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         }, null, 2) }] };
       }
 
+      // ============================================
+      // BACKGROUND WORKERS HANDLERS (via agentic-flow)
+      // ============================================
+      case 'workers_dispatch': {
+        const prompt = args.prompt;
+        try {
+          const result = execSync(`npx agentic-flow@alpha workers dispatch "${prompt.replace(/"/g, '\\"')}"`, {
+            encoding: 'utf-8',
+            timeout: 30000,
+            stdio: ['pipe', 'pipe', 'pipe']
+          });
+          return { content: [{ type: 'text', text: JSON.stringify({
+            success: true,
+            message: 'Worker dispatched',
+            output: result.trim()
+          }, null, 2) }] };
+        } catch (e) {
+          return { content: [{ type: 'text', text: JSON.stringify({
+            success: true,
+            message: 'Worker dispatch attempted',
+            note: 'Check workers status for progress'
+          }, null, 2) }] };
+        }
+      }
+
+      case 'workers_status': {
+        try {
+          const cmdArgs = args.workerId ? `workers status ${args.workerId}` : 'workers status';
+          const result = execSync(`npx agentic-flow@alpha ${cmdArgs}`, {
+            encoding: 'utf-8',
+            timeout: 15000,
+            stdio: ['pipe', 'pipe', 'pipe']
+          });
+          return { content: [{ type: 'text', text: JSON.stringify({
+            success: true,
+            status: result.trim()
+          }, null, 2) }] };
+        } catch (e) {
+          return { content: [{ type: 'text', text: JSON.stringify({
+            success: false,
+            error: 'Could not get worker status',
+            message: e.message
+          }, null, 2) }] };
+        }
+      }
+
+      case 'workers_results': {
+        try {
+          const cmdArgs = args.json ? 'workers results --json' : 'workers results';
+          const result = execSync(`npx agentic-flow@alpha ${cmdArgs}`, {
+            encoding: 'utf-8',
+            timeout: 15000,
+            stdio: ['pipe', 'pipe', 'pipe']
+          });
+          if (args.json) {
+            try {
+              return { content: [{ type: 'text', text: JSON.stringify({
+                success: true,
+                results: JSON.parse(result.trim())
+              }, null, 2) }] };
+            } catch {
+              return { content: [{ type: 'text', text: result.trim() }] };
+            }
+          }
+          return { content: [{ type: 'text', text: JSON.stringify({
+            success: true,
+            results: result.trim()
+          }, null, 2) }] };
+        } catch (e) {
+          return { content: [{ type: 'text', text: JSON.stringify({
+            success: false,
+            error: 'Could not get worker results',
+            message: e.message
+          }, null, 2) }] };
+        }
+      }
+
+      case 'workers_triggers': {
+        try {
+          const result = execSync('npx agentic-flow@alpha workers triggers', {
+            encoding: 'utf-8',
+            timeout: 15000,
+            stdio: ['pipe', 'pipe', 'pipe']
+          });
+          return { content: [{ type: 'text', text: JSON.stringify({
+            success: true,
+            triggers: result.trim()
+          }, null, 2) }] };
+        } catch (e) {
+          // Return hardcoded list as fallback
+          return { content: [{ type: 'text', text: JSON.stringify({
+            success: true,
+            triggers: ['ultralearn', 'optimize', 'consolidate', 'predict', 'audit', 'map', 'preload', 'deepdive', 'document', 'refactor', 'benchmark', 'testgaps']
+          }, null, 2) }] };
+        }
+      }
+
+      case 'workers_stats': {
+        try {
+          const result = execSync('npx agentic-flow@alpha workers stats', {
+            encoding: 'utf-8',
+            timeout: 15000,
+            stdio: ['pipe', 'pipe', 'pipe']
+          });
+          return { content: [{ type: 'text', text: JSON.stringify({
+            success: true,
+            stats: result.trim()
+          }, null, 2) }] };
+        } catch (e) {
+          return { content: [{ type: 'text', text: JSON.stringify({
+            success: false,
+            error: 'Could not get worker stats',
+            message: e.message
+          }, null, 2) }] };
+        }
+      }
+
       default:
         return {
           content: [{

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ruvector",
-  "version": "0.1.75",
+  "version": "0.1.76",
   "description": "High-performance vector database for Node.js with automatic native/WASM fallback",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",