ruvector 0.1.100 → 0.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ruvector",
-  "version": "0.1.100",
+  "version": "0.2.0",
   "description": "High-performance vector database for Node.js with automatic native/WASM fallback",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -10,7 +10,7 @@
   "scripts": {
     "build": "tsc && cp src/core/onnx/pkg/package.json dist/core/onnx/pkg/",
     "prepublishOnly": "npm run build",
-    "test": "node test/integration.js"
+    "test": "node test/integration.js && node test/cli-commands.js"
   },
   "keywords": [
     "vector",
@@ -41,7 +41,15 @@
     "continual-learning",
     "onnx",
     "semantic-embeddings",
-    "minilm"
+    "minilm",
+    "brain",
+    "shared-intelligence",
+    "mcp",
+    "edge-computing",
+    "pi-brain",
+    "identity",
+    "pi-key",
+    "distributed-compute"
   ],
   "author": "ruv.io Team <info@ruv.io> (https://ruv.io)",
   "homepage": "https://ruv.io",
@@ -71,7 +79,23 @@
     "@types/node": "^20.10.5",
     "typescript": "^5.3.3"
   },
+  "files": [
+    "bin/",
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "peerDependencies": {
+    "@ruvector/pi-brain": ">=0.1.0",
+    "@ruvector/ruvllm": ">=2.0.0",
+    "@ruvector/router": ">=0.1.0"
+  },
+  "peerDependenciesMeta": {
+    "@ruvector/pi-brain": { "optional": true },
+    "@ruvector/ruvllm": { "optional": true },
+    "@ruvector/router": { "optional": true }
+  },
   "engines": {
-    "node": ">=14.0.0"
+    "node": ">=18.0.0"
   }
 }

package/HOOKS.md

@@ -1,221 +0,0 @@
-# RuVector Hooks for Claude Code
-
-Self-learning intelligence hooks that enhance Claude Code with Q-learning, vector memory, and automatic agent routing.
-
-## Quick Start
-
-```bash
-# Full setup: hooks + pretrain + optimized agents
-npx ruvector hooks init --pretrain --build-agents quality
-
-# Or step by step:
-npx ruvector hooks init          # Setup hooks
-npx ruvector hooks pretrain      # Analyze repository
-npx ruvector hooks build-agents  # Generate agent configs
-```
-
-## What It Does
-
-RuVector hooks integrate with Claude Code to provide:
-
-| Feature | Description |
-|---------|-------------|
-| **Agent Routing** | Suggests the best agent for each file type based on learned patterns |
-| **Co-edit Patterns** | Predicts "likely next files" from git history |
-| **Vector Memory** | Semantic recall of project context |
-| **Command Analysis** | Risk assessment for bash commands |
-| **Self-Learning** | Q-learning improves suggestions over time |
-
-## Commands
-
-### Initialization
-
-```bash
-# Full configuration
-npx ruvector hooks init
-
-# With pretrain and agent building
-npx ruvector hooks init --pretrain --build-agents security
-
-# Minimal (basic hooks only)
-npx ruvector hooks init --minimal
-
-# Options
---force           # Overwrite existing settings
---minimal         # Basic hooks only
---pretrain        # Run pretrain after init
---build-agents    # Generate optimized agents (quality|speed|security|testing|fullstack)
---no-claude-md    # Skip CLAUDE.md creation
---no-permissions  # Skip permissions config
---no-env          # Skip environment variables
---no-gitignore    # Skip .gitignore update
---no-mcp          # Skip MCP server config
---no-statusline   # Skip status line config
-```
-
-### Pretrain
-
-Analyze your repository to bootstrap intelligence:
-
-```bash
-npx ruvector hooks pretrain
-
-# Options
---depth <n>     # Git history depth (default: 100)
---verbose       # Show detailed progress
---skip-git      # Skip git history analysis
---skip-files    # Skip file structure analysis
-```
-
-**What it learns:**
-- File type → Agent mapping (`.rs` → rust-developer)
-- Co-edit patterns from git history
-- Directory → Agent mapping
-- Project context memories
-
-### Build Agents
-
-Generate optimized `.claude/agents/` configurations:
-
-```bash
-npx ruvector hooks build-agents --focus quality
-
-# Focus modes
---focus quality   # Code quality, best practices (default)
---focus speed     # Rapid development, prototyping
---focus security  # OWASP, input validation, encryption
---focus testing   # TDD, comprehensive coverage
---focus fullstack # Balanced frontend/backend/database
-
-# Options
---output <dir>    # Output directory (default: .claude/agents)
---format <fmt>    # yaml, json, or md (default: yaml)
---include-prompts # Include system prompts in agent configs
-```
-
-### Verification & Diagnostics
-
-```bash
-# Check if hooks are working
-npx ruvector hooks verify
-
-# Diagnose and fix issues
-npx ruvector hooks doctor
-npx ruvector hooks doctor --fix
-```
-
-### Data Management
-
-```bash
-# View statistics
-npx ruvector hooks stats
-
-# Export intelligence data
-npx ruvector hooks export -o backup.json
-npx ruvector hooks export --include-all
-
-# Import intelligence data
-npx ruvector hooks import backup.json
-npx ruvector hooks import backup.json --merge
-```
-
-### Memory Operations
-
-```bash
-# Store context in vector memory
-npx ruvector hooks remember "API uses JWT auth" -t project
-
-# Semantic search memory
-npx ruvector hooks recall "authentication"
-
-# Route a task to best agent
-npx ruvector hooks route "implement user login"
-```
-
-## Hook Events
-
-| Event | Trigger | RuVector Action |
-|-------|---------|-----------------|
-| **PreToolUse** | Before Edit/Write/Bash | Agent routing, file analysis, command risk |
-| **PostToolUse** | After Edit/Write/Bash | Q-learning update, pattern recording |
-| **SessionStart** | Conversation begins | Load intelligence, display stats |
-| **Stop** | Conversation ends | Save learning data |
-| **UserPromptSubmit** | User sends message | Context suggestions |
-| **PreCompact** | Before context compaction | Preserve important context |
-| **Notification** | Any notification | Track events for learning |
-
-## Generated Files
-
-After running `hooks init`:
-
-```
-your-project/
-├── .claude/
-│   ├── settings.json      # Hooks configuration
-│   ├── statusline.sh      # Status bar script
-│   └── agents/            # Generated agents (with --build-agents)
-│       ├── rust-specialist.yaml
-│       ├── typescript-specialist.yaml
-│       ├── test-architect.yaml
-│       └── project-coordinator.yaml
-├── .ruvector/
-│   └── intelligence.json  # Learning data
-├── CLAUDE.md              # Project documentation
-└── .gitignore             # Updated with .ruvector/
-```
-
-## Environment Variables
-
-| Variable | Default | Description |
-|----------|---------|-------------|
-| `RUVECTOR_INTELLIGENCE_ENABLED` | `true` | Enable/disable intelligence |
-| `RUVECTOR_LEARNING_RATE` | `0.1` | Q-learning rate (0.0-1.0) |
-| `RUVECTOR_MEMORY_BACKEND` | `rvlite` | Memory storage backend |
-| `INTELLIGENCE_MODE` | `treatment` | A/B testing mode |
-
-## Example Output
-
-### Agent Routing
-```
-🧠 Intelligence Analysis:
-   📁 src/api/routes.ts
-   🤖 Recommended: typescript-developer (85% confidence)
-      → learned from 127 .ts files in repo
-   📎 Likely next files:
-      - src/api/handlers.ts (12 co-edits)
-      - src/types/api.ts (8 co-edits)
-```
-
-### Command Analysis
-```
-🧠 Command Analysis:
-   📦 Category: rust
-   🏷️  Type: test
-   ✅ Risk: LOW
-```
-
-## Best Practices
-
-1. **Run pretrain on existing repos** — Bootstrap intelligence before starting work
-2. **Use focus modes** — Match agent generation to your current task
-3. **Export before major changes** — Backup learning data
-4. **Let it learn** — Intelligence improves with each edit
-
-## Troubleshooting
-
-```bash
-# Check setup
-npx ruvector hooks verify
-
-# Fix common issues
-npx ruvector hooks doctor --fix
-
-# Reset and reinitialize
-npx ruvector hooks init --force --pretrain
-```
-
-## Links
-
-- [RuVector GitHub](https://github.com/ruvnet/ruvector)
-- [npm Package](https://www.npmjs.com/package/ruvector)
-- [Claude Code Documentation](https://docs.anthropic.com/claude-code)

package/PACKAGE_SUMMARY.md

@@ -1,409 +0,0 @@
-# ruvector Package Summary
-
-## Overview
-
-The main `ruvector` package provides a unified interface for high-performance vector database operations in Node.js, with automatic platform detection and smart fallback between native (Rust) and WASM implementations.
-
-## Package Structure
-
-```
-/workspaces/ruvector/npm/packages/ruvector/
-├── src/                    # TypeScript source
-│   ├── index.ts           # Smart loader with platform detection
-│   └── types.ts           # TypeScript type definitions
-├── dist/                   # Compiled JavaScript and types
-│   ├── index.js           # Main entry point
-│   ├── index.d.ts         # Type definitions
-│   ├── types.js           # Compiled types
-│   └── types.d.ts         # Type definitions
-├── bin/
-│   └── cli.js             # CLI tool
-├── test/
-│   ├── mock-implementation.js  # Mock VectorDB for testing
-│   ├── standalone-test.js      # Package structure tests
-│   └── integration.js          # Integration tests
-├── examples/
-│   ├── api-usage.js       # API usage examples
-│   └── cli-demo.sh        # CLI demonstration
-├── package.json           # NPM package configuration
-├── tsconfig.json          # TypeScript configuration
-└── README.md             # Package documentation
-```
-
-## Key Features
-
-### 1. Smart Platform Detection
-
-The package automatically detects and loads the best available implementation:
-
-```typescript
-// Tries to load in this order:
-// 1. @ruvector/core (native Rust, fastest)
-// 2. @ruvector/wasm (WebAssembly, universal fallback)
-
-import { VectorDB, getImplementationType, isNative, isWasm } from 'ruvector';
-
-console.log(getImplementationType()); // 'native' or 'wasm'
-console.log(isNative());              // true if using native
-console.log(isWasm());                // true if using WASM
-```
-
-### 2. Complete TypeScript Support
-
-Full type definitions for all APIs:
-
-```typescript
-interface VectorEntry {
-  id: string;
-  vector: number[];
-  metadata?: Record<string, any>;
-}
-
-interface SearchQuery {
-  vector: number[];
-  k?: number;
-  filter?: Record<string, any>;
-  threshold?: number;
-}
-
-interface SearchResult {
-  id: string;
-  score: number;
-  vector: number[];
-  metadata?: Record<string, any>;
-}
-
-interface DbOptions {
-  dimension: number;
-  metric?: 'cosine' | 'euclidean' | 'dot';
-  path?: string;
-  autoPersist?: boolean;
-  hnsw?: {
-    m?: number;
-    efConstruction?: number;
-    efSearch?: number;
-  };
-}
-```
-
-### 3. VectorDB API
-
-Comprehensive vector database operations:
-
-```typescript
-const db = new VectorDB({
-  dimension: 384,
-  metric: 'cosine'
-});
-
-// Insert operations
-db.insert({ id: 'doc1', vector: [...], metadata: {...} });
-db.insertBatch([...entries]);
-
-// Search operations
-const results = db.search({
-  vector: [...],
-  k: 10,
-  threshold: 0.7
-});
-
-// CRUD operations
-const entry = db.get('doc1');
-db.updateMetadata('doc1', { updated: true });
-db.delete('doc1');
-
-// Database management
-const stats = db.stats();
-db.save('./mydb.vec');
-db.load('./mydb.vec');
-db.buildIndex();
-db.optimize();
-```
-
-### 4. CLI Tools
-
-Command-line interface for database operations:
-
-```bash
-# Create database
-ruvector create mydb.vec --dimension 384 --metric cosine
-
-# Insert vectors
-ruvector insert mydb.vec vectors.json --batch-size 1000
-
-# Search
-ruvector search mydb.vec --vector "[0.1,0.2,...]" --top-k 10
-
-# Statistics
-ruvector stats mydb.vec
-
-# Benchmark
-ruvector benchmark --num-vectors 10000 --num-queries 1000
-
-# Info
-ruvector info
-```
-
-## API Reference
-
-### Constructor
-
-```typescript
-new VectorDB(options: DbOptions): VectorDB
-```
-
-### Methods
-
-- `insert(entry: VectorEntry): void` - Insert single vector
-- `insertBatch(entries: VectorEntry[]): void` - Batch insert
-- `search(query: SearchQuery): SearchResult[]` - Search similar vectors
-- `get(id: string): VectorEntry | null` - Get by ID
-- `delete(id: string): boolean` - Delete vector
-- `updateMetadata(id: string, metadata: Record<string, any>): void` - Update metadata
-- `stats(): DbStats` - Get database statistics
-- `save(path?: string): void` - Save to disk
-- `load(path: string): void` - Load from disk
-- `clear(): void` - Clear all vectors
-- `buildIndex(): void` - Build HNSW index
-- `optimize(): void` - Optimize database
-
-### Utility Functions
-
-- `getImplementationType(): 'native' | 'wasm'` - Get current implementation
-- `isNative(): boolean` - Check if using native
-- `isWasm(): boolean` - Check if using WASM
-- `getVersion(): { version: string, implementation: string }` - Get version info
-
-## Dependencies
-
-### Production Dependencies
-
-- `commander` (^11.1.0) - CLI framework
-- `chalk` (^4.1.2) - Terminal styling
-- `ora` (^5.4.1) - Spinners and progress
-
-### Optional Dependencies
-
-- `@ruvector/core` (^0.1.1) - Native Rust bindings (when available)
-- `@ruvector/wasm` (^0.1.1) - WebAssembly module (fallback)
-
-### Dev Dependencies
-
-- `typescript` (^5.3.3) - TypeScript compiler
-- `@types/node` (^20.10.5) - Node.js type definitions
-
-## Package.json Configuration
-
-```json
-{
-  "name": "ruvector",
-  "version": "0.1.1",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "bin": {
-    "ruvector": "./bin/cli.js"
-  },
-  "scripts": {
-    "build": "tsc",
-    "test": "node test/standalone-test.js"
-  }
-}
-```
-
-## Build Process
-
-```bash
-# Install dependencies
-npm install
-
-# Build TypeScript
-npm run build
-
-# Run tests
-npm test
-
-# Package for NPM
-npm pack
-```
-
-## Testing
-
-The package includes comprehensive tests:
-
-### 1. Standalone Test (`test/standalone-test.js`)
-
-Tests package structure and API using mock implementation:
-- Package structure validation
-- TypeScript type definitions
-- VectorDB API functionality
-- CLI structure
-- Smart loader logic
-
-### 2. Integration Test (`test/integration.js`)
-
-Tests integration with real implementations when available.
-
-### 3. Mock Implementation (`test/mock-implementation.js`)
-
-JavaScript-based VectorDB implementation for testing and demonstration purposes.
-
-## Examples
-
-### API Usage (`examples/api-usage.js`)
-
-Demonstrates:
-- Basic CRUD operations
-- Batch operations
-- Semantic search
-- Different distance metrics
-- Performance benchmarking
-- Persistence
-
-### CLI Demo (`examples/cli-demo.sh`)
-
-Bash script demonstrating CLI tools.
-
-## Usage Examples
-
-### Simple Vector Search
-
-```javascript
-const { VectorDB } = require('ruvector');
-
-const db = new VectorDB({ dimension: 3 });
-
-db.insertBatch([
-  { id: 'cat', vector: [0.9, 0.1, 0.1], metadata: { animal: 'cat' } },
-  { id: 'dog', vector: [0.1, 0.9, 0.1], metadata: { animal: 'dog' } },
-  { id: 'tiger', vector: [0.8, 0.2, 0.15], metadata: { animal: 'tiger' } }
-]);
-
-const results = db.search({
-  vector: [0.9, 0.1, 0.1],
-  k: 2
-});
-
-console.log(results);
-// [
-//   { id: 'cat', score: 1.0, ... },
-//   { id: 'tiger', score: 0.97, ... }
-// ]
-```
-
-### Semantic Document Search
-
-```javascript
-const db = new VectorDB({ dimension: 768, metric: 'cosine' });
-
-// Insert documents with embeddings (from your embedding model)
-db.insertBatch([
-  { id: 'doc1', vector: embedding1, metadata: { title: 'AI Guide' } },
-  { id: 'doc2', vector: embedding2, metadata: { title: 'Web Dev' } }
-]);
-
-// Search with query embedding
-const results = db.search({
-  vector: queryEmbedding,
-  k: 10,
-  threshold: 0.7
-});
-```
-
-### Persistence
-
-```javascript
-const db = new VectorDB({
-  dimension: 384,
-  path: './vectors.db',
-  autoPersist: true
-});
-
-// Changes automatically saved
-db.insert({ id: 'doc1', vector: [...] });
-
-// Or manual save
-db.save('./backup.db');
-
-// Load from disk
-db.load('./vectors.db');
-```
-
-## Performance Characteristics
-
-### Mock Implementation (JavaScript)
-- Insert: ~1M vectors/sec (batch)
-- Search: ~400 queries/sec (1000 vectors, k=10)
-
-### Native Implementation (Rust)
-- Insert: ~10M+ vectors/sec (batch)
-- Search: ~100K+ queries/sec with HNSW index
-- 150x faster than pgvector
-
-### WASM Implementation
-- Insert: ~1M+ vectors/sec (batch)
-- Search: ~10K+ queries/sec with HNSW index
-- ~10x faster than pure JavaScript
-
-## Integration with Other Packages
-
-This package serves as the main interface and coordinates between:
-
-1. **@ruvector/core** - Native Rust bindings (napi-rs)
-   - Platform-specific native modules
-   - Maximum performance
-   - Optional dependency
-
-2. **@ruvector/wasm** - WebAssembly module
-   - Universal compatibility
-   - Near-native performance
-   - Fallback implementation
-
-## Error Handling
-
-The package provides clear error messages when implementations are unavailable:
-
-```
-Failed to load ruvector: Neither native nor WASM implementation available.
-Native error: Cannot find module '@ruvector/core'
-WASM error: Cannot find module '@ruvector/wasm'
-```
-
-## Environment Variables
-
-- `RUVECTOR_DEBUG=1` - Enable debug logging for implementation loading
-
-## Next Steps
-
-To complete the package ecosystem:
-
-1. **Create @ruvector/core**
-   - napi-rs bindings to Rust code
-   - Platform-specific builds (Linux, macOS, Windows)
-   - Native module packaging
-
-2. **Create @ruvector/wasm**
-   - wasm-pack build from Rust code
-   - WebAssembly module
-   - Universal compatibility layer
-
-3. **Update Dependencies**
-   - Add @ruvector/core as optionalDependency
-   - Add @ruvector/wasm as dependency
-   - Configure proper fallback chain
-
-4. **Publishing**
-   - Publish all three packages to npm
-   - Set up CI/CD for builds
-   - Create platform-specific releases
-
-## Version
-
-Current version: **0.1.1**
-
-## License
-
-MIT
-
-## Repository
-
-https://github.com/ruvnet/ruvector