ruvector 0.1.74 → 0.1.76

package/bin/cli.js

@@ -2752,6 +2752,7 @@ hooksCmd.command('init')
   .description('Initialize hooks in current project')
   .option('--force', 'Force overwrite existing settings')
   .option('--minimal', 'Only basic hooks (no env, permissions, or advanced hooks)')
+  .option('--fast', 'Use fast local wrapper (20x faster, bypasses npx overhead)')
   .option('--no-claude-md', 'Skip CLAUDE.md creation')
   .option('--no-permissions', 'Skip permissions configuration')
   .option('--no-env', 'Skip environment variables')
@@ -2763,6 +2764,7 @@ hooksCmd.command('init')
   .action(async (opts) => {
   const settingsPath = path.join(process.cwd(), '.claude', 'settings.json');
   const settingsDir = path.dirname(settingsPath);
+  const isWindows = process.platform === 'win32';
   if (!fs.existsSync(settingsDir)) fs.mkdirSync(settingsDir, { recursive: true });
   let settings = {};
   if (fs.existsSync(settingsPath) && !opts.force) {
@@ -2836,8 +2838,6 @@ hooksCmd.command('init')
   // StatusLine configuration (unless --minimal or --no-statusline)
   if (!opts.minimal && opts.statusline !== false) {
     if (!settings.statusLine) {
-      const isWindows = process.platform === 'win32';
-
       if (isWindows) {
         // Windows: PowerShell statusline
         const statuslineScript = path.join(settingsDir, 'statusline-command.ps1');
@@ -2920,47 +2920,153 @@ fi
     }
   }
 
-  // Core hooks (always included)
+  // Fast wrapper creation (--fast option) - 20x faster than npx
+  let hookCmd = 'npx ruvector@latest';
+  let fastTimeouts = { simple: 2000, complex: 2000, session: 5000 };
+  if (opts.fast && !isWindows) {
+    const fastWrapperPath = path.join(settingsDir, 'ruvector-fast.sh');
+    const fastWrapperContent = `#!/bin/bash
+# Fast RuVector hooks wrapper - avoids npx overhead (20x faster)
+# Usage: .claude/ruvector-fast.sh hooks <command> [args...]
+
+# Find ruvector CLI - check local first, then global
+RUVECTOR_CLI=""
+
+# Check local npm package (for development)
+if [ -f "$PWD/npm/packages/ruvector/bin/cli.js" ]; then
+  RUVECTOR_CLI="$PWD/npm/packages/ruvector/bin/cli.js"
+# Check node_modules
+elif [ -f "$PWD/node_modules/ruvector/bin/cli.js" ]; then
+  RUVECTOR_CLI="$PWD/node_modules/ruvector/bin/cli.js"
+# Check global npm installation
+elif [ -f "$PWD/node_modules/.bin/ruvector" ]; then
+  exec "$PWD/node_modules/.bin/ruvector" "$@"
+elif command -v ruvector &> /dev/null; then
+  exec ruvector "$@"
+# Fallback to npx (slow but works)
+else
+  exec npx ruvector@latest "$@"
+fi
+
+# Execute with node directly (fast path)
+exec node "$RUVECTOR_CLI" "$@"
+`;
+    fs.writeFileSync(fastWrapperPath, fastWrapperContent);
+    fs.chmodSync(fastWrapperPath, '755');
+    hookCmd = '.claude/ruvector-fast.sh';
+    fastTimeouts = { simple: 300, complex: 500, session: 1000 };
+    // Add permission for fast wrapper
+    if (settings.permissions && settings.permissions.allow) {
+      if (!settings.permissions.allow.includes('Bash(.claude/ruvector-fast.sh:*)')) {
+        settings.permissions.allow.push('Bash(.claude/ruvector-fast.sh:*)');
+      }
+    }
+    console.log(chalk.blue('  ✓ Fast wrapper created (.claude/ruvector-fast.sh) - 20x faster hooks'));
+  }
+
+  // Core hooks (always included) - with timeouts and error suppression
   settings.hooks = settings.hooks || {};
   settings.hooks.PreToolUse = [
-    { matcher: 'Edit|Write|MultiEdit', hooks: [{ type: 'command', command: 'npx ruvector hooks pre-edit "$TOOL_INPUT_file_path"' }] },
-    { matcher: 'Bash', hooks: [{ type: 'command', command: 'npx ruvector hooks pre-command "$TOOL_INPUT_command"' }] }
+    {
+      matcher: 'Edit|Write|MultiEdit',
+      hooks: [
+        { type: 'command', timeout: fastTimeouts.complex, command: `${hookCmd} hooks pre-edit "$TOOL_INPUT_file_path" 2>/dev/null || true` },
+        { type: 'command', timeout: fastTimeouts.complex, command: `${hookCmd} hooks coedit-suggest --file "$TOOL_INPUT_file_path" 2>/dev/null || true` }
+      ]
+    },
+    { matcher: 'Bash', hooks: [{ type: 'command', timeout: fastTimeouts.complex, command: `${hookCmd} hooks pre-command "$TOOL_INPUT_command" 2>/dev/null || true` }] },
+    { matcher: 'Read', hooks: [{ type: 'command', timeout: fastTimeouts.simple, command: `${hookCmd} hooks remember "Reading: $TOOL_INPUT_file_path" -t file_access 2>/dev/null || true` }] },
+    { matcher: 'Glob|Grep', hooks: [{ type: 'command', timeout: fastTimeouts.simple, command: `${hookCmd} hooks remember "Search: $TOOL_INPUT_pattern" -t search_pattern 2>/dev/null || true` }] },
+    { matcher: 'Task', hooks: [{ type: 'command', timeout: fastTimeouts.simple, command: `${hookCmd} hooks remember "Agent: $TOOL_INPUT_subagent_type" -t agent_spawn 2>/dev/null || true` }] }
   ];
   settings.hooks.PostToolUse = [
-    { matcher: 'Edit|Write|MultiEdit', hooks: [{ type: 'command', command: 'npx ruvector hooks post-edit "$TOOL_INPUT_file_path"' }] },
-    { matcher: 'Bash', hooks: [{ type: 'command', command: 'npx ruvector hooks post-command "$TOOL_INPUT_command"' }] }
+    { matcher: 'Edit|Write|MultiEdit', hooks: [{ type: 'command', timeout: fastTimeouts.complex, command: `${hookCmd} hooks post-edit "$TOOL_INPUT_file_path" 2>/dev/null || true` }] },
+    { matcher: 'Bash', hooks: [{ type: 'command', timeout: fastTimeouts.complex, command: `${hookCmd} hooks post-command "$TOOL_INPUT_command" 2>/dev/null || true` }] }
   ];
-  settings.hooks.SessionStart = [{ hooks: [{ type: 'command', command: 'npx ruvector hooks session-start' }] }];
-  settings.hooks.Stop = [{ hooks: [{ type: 'command', command: 'npx ruvector hooks session-end' }] }];
-  console.log(chalk.blue('  ✓ Core hooks (PreToolUse, PostToolUse, SessionStart, Stop)'));
+  settings.hooks.SessionStart = [{
+    hooks: [
+      { type: 'command', timeout: fastTimeouts.session, command: `${hookCmd} hooks session-start 2>/dev/null || true` },
+      { type: 'command', timeout: fastTimeouts.complex, command: `${hookCmd} hooks trajectory-begin -c "claude-session" -a "claude" 2>/dev/null || true` }
+    ]
+  }];
+  settings.hooks.Stop = [{
+    hooks: [
+      { type: 'command', timeout: fastTimeouts.complex, command: `${hookCmd} hooks trajectory-end --success --quality 0.8 2>/dev/null || true` },
+      { type: 'command', timeout: fastTimeouts.complex, command: `${hookCmd} hooks session-end 2>/dev/null || true` }
+    ]
+  }];
+  console.log(chalk.blue(`  ✓ Core hooks (PreToolUse, PostToolUse, SessionStart, Stop) ${opts.fast ? 'with fast wrapper' : 'with error handling'}`));
 
   // 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: 2000,
-        command: 'npx ruvector hooks suggest-context'
-      }]
+      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 = [
       {
         matcher: 'auto',
-        hooks: [{
-          type: 'command',
-          timeout: 3000,
-          command: 'npx ruvector hooks pre-compact --auto'
-        }]
+        hooks: [
+          { type: 'command', timeout: fastTimeouts.session, command: `${hookCmd} hooks pre-compact --auto 2>/dev/null || true` },
+          { type: 'command', timeout: fastTimeouts.session, command: `${hookCmd} hooks compress 2>/dev/null || true` }
+        ]
       },
       {
         matcher: 'manual',
         hooks: [{
           type: 'command',
-          timeout: 3000,
-          command: 'npx ruvector hooks pre-compact'
+          timeout: fastTimeouts.session,
+          command: `${hookCmd} hooks pre-compact 2>/dev/null || true`
         }]
       }
     ];
@@ -2970,11 +3076,11 @@ fi
       matcher: '.*',
       hooks: [{
         type: 'command',
-        timeout: 1000,
-        command: 'npx ruvector hooks track-notification'
+        timeout: fastTimeouts.simple,
+        command: `${hookCmd} hooks track-notification 2>/dev/null || true`
       }]
     }];
-    console.log(chalk.blue('  ✓ Advanced hooks (UserPromptSubmit, PreCompact, Notification)'));
+    console.log(chalk.blue(`  ✓ Advanced hooks (UserPromptSubmit, PreCompact, Notification, Compress)${opts.fast ? ' - fast mode' : ''}`));
 
     // Extended environment variables for new capabilities
     settings.env.RUVECTOR_AST_ENABLED = settings.env.RUVECTOR_AST_ENABLED || 'true';
@@ -3176,6 +3282,7 @@ Stored in \`.ruvector/intelligence.json\`:
 \`\`\`bash
 npx ruvector hooks init              # Full configuration with all capabilities
 npx ruvector hooks init --minimal    # Basic hooks only
+npx ruvector hooks init --fast       # Use fast local wrapper (20x faster)
 npx ruvector hooks init --pretrain   # Initialize + pretrain from git history
 npx ruvector hooks init --build-agents quality  # Generate optimized agents
 npx ruvector hooks init --force      # Overwrite existing configuration
@@ -5921,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/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,SAAS,CAAC;AAGxB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAE3B,QAAA,IAAI,cAAc,EAAE,GAAG,CAAC;AA0BxB;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,QAAQ,GAAG,MAAM,CAEzD;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,OAAO,CAElC;AAED;;GAEG;AACH,wBAAgB,MAAM,IAAI,OAAO,CAEhC;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAMxE;AAED;;GAEG;AACH,cAAM,eAAe;IACnB,OAAO,CAAC,EAAE,CAAM;gBAEJ,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,GAAG,CAAA;KAAE;IAI5G;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IActH;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAUtI;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,YAAY,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE,CAAC,CAAC;IAuB1N;;OAEG;IACG,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;IAW5G;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI1C;;OAEG;IACG,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;IAI5B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;CAGlC;AAGD,eAAO,MAAM,QAAQ,wBAAkB,CAAC;AACxC,eAAO,MAAM,QAAQ,wBAAkB,CAAC;AAGxC,eAAO,MAAM,cAAc,KAA0B,CAAC;AAGtD,eAAe,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,SAAS,CAAC;AAGxB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAE3B,QAAA,IAAI,cAAc,EAAE,GAAG,CAAC;AAmCxB;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,QAAQ,GAAG,MAAM,CAEzD;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,OAAO,CAElC;AAED;;GAEG;AACH,wBAAgB,MAAM,IAAI,OAAO,CAEhC;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAMxE;AAED;;GAEG;AACH,cAAM,eAAe;IACnB,OAAO,CAAC,EAAE,CAAM;gBAEJ,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,GAAG,CAAA;KAAE;IAI5G;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IActH;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAUtI;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,YAAY,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE,CAAC,CAAC;IAuB1N;;OAEG;IACG,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;IAW5G;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI1C;;OAEG;IACG,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;IAI5B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;CAGlC;AAGD,eAAO,MAAM,QAAQ,wBAAkB,CAAC;AACxC,eAAO,MAAM,QAAQ,wBAAkB,CAAC;AAGxC,eAAO,MAAM,cAAc,KAA0B,CAAC;AAGtD,eAAe,cAAc,CAAC"}

package/dist/index.js

@@ -39,21 +39,31 @@ try {
     // Try to load native module first
     implementation = require('@ruvector/core');
     implementationType = 'native';
-    // Verify it's actually working
-    if (typeof implementation.VectorDB !== 'function') {
-        throw new Error('Native module loaded but VectorDB not found');
+    // Verify it's actually working (native module exports VectorDb, not VectorDB)
+    if (typeof implementation.VectorDb !== 'function') {
+        throw new Error('Native module loaded but VectorDb class not found');
     }
 }
 catch (e) {
-    // No WASM fallback available yet
-    throw new Error(`Failed to load ruvector native module.\n` +
-        `Error: ${e.message}\n` +
-        `\nSupported platforms:\n` +
-        `- Linux x64/ARM64\n` +
-        `- macOS Intel/Apple Silicon\n` +
-        `- Windows x64\n` +
-        `\nIf you're on a supported platform, try:\n` +
-        `  npm install --force @ruvector/core`);
+    // Graceful fallback - don't crash, just warn
+    console.warn('[RuVector] Native module not available:', e.message);
+    console.warn('[RuVector] Vector operations will be limited. Install @ruvector/core for full functionality.');
+    // Create a stub implementation that provides basic functionality
+    implementation = {
+        VectorDb: class StubVectorDb {
+            constructor() {
+                console.warn('[RuVector] Using stub VectorDb - install @ruvector/core for native performance');
+            }
+            async insert() { return 'stub-id-' + Date.now(); }
+            async insertBatch(entries) { return entries.map(() => 'stub-id-' + Date.now()); }
+            async search() { return []; }
+            async delete() { return true; }
+            async get() { return null; }
+            async len() { return 0; }
+            async isEmpty() { return true; }
+        }
+    };
+    implementationType = 'wasm'; // Mark as fallback mode
 }
 /**
  * Get the current implementation type

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ruvector",
-  "version": "0.1.74",
+  "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",