ruvector 0.1.36 → 0.1.38

package/README.md

@@ -277,6 +277,86 @@ npx ruvector export my-index backup.bin
 npx ruvector import backup.bin restored-index
 ```
 
+## Self-Learning Hooks (Claude Code Integration)
+
+RuVector includes a self-learning intelligence layer that improves AI agent decisions over time. These hooks integrate with Claude Code and other AI development tools.
+
+### Setup
+
+```bash
+# Initialize hooks in your project
+npx ruvector hooks init
+```
+
+### Hook Commands
+
+```bash
+# Session Management
+ruvector hooks session-start          # Start session tracking
+ruvector hooks session-end            # End session with export
+
+# Pre/Post Edit Hooks
+ruvector hooks pre-edit <file>        # Get agent suggestions before editing
+ruvector hooks post-edit <file> --success  # Record edit outcomes
+
+# Pre/Post Command Hooks
+ruvector hooks pre-command "cargo test"    # Analyze command before running
+ruvector hooks post-command "cargo test" --success  # Record command outcomes
+
+# Intelligence
+ruvector hooks stats                  # Show learning statistics
+ruvector hooks route <task>           # Get agent routing suggestion
+ruvector hooks suggest-context        # Get context suggestions
+
+# Memory
+ruvector hooks remember <content> -t <type>  # Store in vector memory
+ruvector hooks recall <query>                # Semantic search memory
+```
+
+### How It Works
+
+The intelligence system uses:
+- **Q-Learning**: Learns optimal agent routing from past successes/failures
+- **Vector Memory**: Semantic storage with cosine similarity search
+- **File Sequences**: Predicts related files based on edit patterns
+- **Error Patterns**: Remembers fixes for common errors
+
+### Example Output
+
+```
+🧠 Intelligence Analysis:
+   📁 ruvector-core/lib.rs
+   🤖 Recommended: rust-developer (80% confidence)
+      → learned from past success
+   📚 Similar: 3 past edits
+   📎 Related: mod.rs, tests.rs
+   💬 ⚡ Core lib: run cargo test --lib after changes
+```
+
+### Claude Code Integration
+
+Add to your `.claude/settings.json`:
+
+```json
+{
+  "hooks": {
+    "PreToolUse": [{ "command": "ruvector hooks pre-edit $file" }],
+    "PostToolUse": [{ "command": "ruvector hooks post-edit $file --success" }],
+    "SessionStart": [{ "command": "ruvector hooks session-start" }],
+    "Stop": [{ "command": "ruvector hooks session-end" }]
+  }
+}
+```
+
+### Learning Data
+
+| Storage | Contents |
+|---------|----------|
+| `.ruvector/intelligence.json` | Q-table, memories, trajectories |
+| Patterns | State-action values for agent routing |
+| Memories | Vector embeddings for semantic recall |
+| Trajectories | Learning history for continuous improvement |
+
 ## Integrations
 
 ### LangChain

package/bin/ruvector.js

@@ -820,8 +820,9 @@ class Intelligence {
 
   load() {
     try {
-      if (fs.existsSync(INTEL_PATH)) {
-        return JSON.parse(require('fs').readFileSync(INTEL_PATH, 'utf-8'));
+      const fss = require('fs');
+      if (fss.existsSync(INTEL_PATH)) {
+        return JSON.parse(fss.readFileSync(INTEL_PATH, 'utf-8'));
       }
     } catch {}
     return {
@@ -837,9 +838,10 @@ class Intelligence {
   }
 
   save() {
+    const fss = require('fs');
     const dir = path.dirname(INTEL_PATH);
-    if (!fs.existsSync(dir)) require('fs').mkdirSync(dir, { recursive: true });
-    require('fs').writeFileSync(INTEL_PATH, JSON.stringify(this.data, null, 2));
+    if (!fss.existsSync(dir)) fss.mkdirSync(dir, { recursive: true });
+    fss.writeFileSync(INTEL_PATH, JSON.stringify(this.data, null, 2));
   }
 
   now() { return Math.floor(Date.now() / 1000); }
@@ -996,17 +998,18 @@ class Intelligence {
 const hooksCmd = program.command('hooks').description('Self-learning intelligence hooks for Claude Code');
 
 hooksCmd.command('init').description('Initialize hooks in current project').option('--force', 'Force overwrite').action((opts) => {
+  const fss = require('fs');
   const settingsPath = path.join(process.cwd(), '.claude', 'settings.json');
   const settingsDir = path.dirname(settingsPath);
-  if (!fs.existsSync(settingsDir)) require('fs').mkdirSync(settingsDir, { recursive: true });
+  if (!fss.existsSync(settingsDir)) fss.mkdirSync(settingsDir, { recursive: true });
   let settings = {};
-  if (fs.existsSync(settingsPath)) try { settings = JSON.parse(require('fs').readFileSync(settingsPath, 'utf-8')); } catch {}
+  if (fss.existsSync(settingsPath)) try { settings = JSON.parse(fss.readFileSync(settingsPath, 'utf-8')); } catch {}
   settings.hooks = settings.hooks || {};
   settings.hooks.PreToolUse = [{ matcher: 'Edit|Write|MultiEdit', hooks: ['ruvector hooks pre-edit "$TOOL_INPUT_file_path"'] }, { matcher: 'Bash', hooks: ['ruvector hooks pre-command "$TOOL_INPUT_command"'] }];
   settings.hooks.PostToolUse = [{ matcher: 'Edit|Write|MultiEdit', hooks: ['ruvector hooks post-edit "$TOOL_INPUT_file_path"'] }, { matcher: 'Bash', hooks: ['ruvector hooks post-command "$TOOL_INPUT_command"'] }];
   settings.hooks.SessionStart = ['ruvector hooks session-start'];
   settings.hooks.Stop = ['ruvector hooks session-end'];
-  require('fs').writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
+  fss.writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
   console.log(chalk.green('✅ Hooks initialized in .claude/settings.json'));
 });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ruvector",
-  "version": "0.1.36",
+  "version": "0.1.38",
   "description": "High-performance vector database with Graph Neural Networks, Cypher queries, and AI agent routing. Build RAG apps, semantic search, recommendations, and agentic AI systems. Pinecone + Neo4j + PyTorch alternative.",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",