π The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
TypeScript agentic-aiagentic-frameworkagentic-workflowagentsai-agentsai-assistantai-skillsautonomous-agentsclaudecodexdsh-pluginharnessmcp-servermulti-agentmulti-agent-systemsnpmskillsswarmswarm-intelligencetypescript
Checkpoint: File edits
rUv8e0184a84339
diff --git a/agents/architect.yaml b/agents/architect.yamlindex 8015208de0..c6c8c8cb14 100644--- a/agents/architect.yaml+++ b/agents/architect.yaml@@ -8,4 +8,4 @@ capabilities:optimizations:- context-caching- memory-persistence-createdAt: "2026-01-07T04:31:43.920Z"+createdAt: "2026-01-07T05:11:07.545Z"diff --git a/agents/coder.yaml b/agents/coder.yamlindex 92b0840c83..5082c9fdb8 100644--- a/agents/coder.yaml+++ b/agents/coder.yaml@@ -8,4 +8,4 @@ capabilities:optimizations:- flash-attention- token-reduction-createdAt: "2026-01-07T04:31:43.920Z"+createdAt: "2026-01-07T05:11:07.544Z"diff --git a/agents/reviewer.yaml b/agents/reviewer.yamlindex f83bf424f9..d1d6615866 100644--- a/agents/reviewer.yaml+++ b/agents/reviewer.yaml@@ -7,4 +7,4 @@ capabilities:- best-practicesoptimizations:- incremental-analysis-createdAt: "2026-01-07T04:31:43.921Z"+createdAt: "2026-01-07T05:11:07.545Z"diff --git a/agents/security-architect.yaml b/agents/security-architect.yamlindex 6e26b26428..5ff811112d 100644--- a/agents/security-architect.yaml+++ b/agents/security-architect.yaml@@ -7,4 +7,4 @@ capabilities:- security-reviewoptimizations:- pattern-matching-createdAt: "2026-01-07T04:31:43.921Z"+createdAt: "2026-01-07T05:11:07.545Z"diff --git a/agents/tester.yaml b/agents/tester.yamlindex f82884eec4..87720f250c 100644--- a/agents/tester.yaml+++ b/agents/tester.yaml@@ -7,4 +7,4 @@ capabilities:- coverageoptimizations:- parallel-execution-createdAt: "2026-01-07T04:31:43.920Z"+createdAt: "2026-01-07T05:11:07.545Z"diff --git a/v3/implementation/adrs/README.md b/v3/implementation/adrs/README.mdindex 73a7fd1118..e89c515a79 100644--- a/v3/implementation/adrs/README.md+++ b/v3/implementation/adrs/README.md@@ -423,3 +423,130 @@ claude-flow agent spawn -t security-analyst # One of 66 types@claude-flow/agents # From agentic-flow's 66 agents@claude-flow/transport # QUIC + HTTP + WebSocket```++---++## ruvector Integration Analysis++### Package Overview++| Package | Version | Description |+|---------|---------|-------------|+| `ruvector` | 0.1.95 | Main CLI + unified interface |+| `@ruvector/core` | 0.1.30 | Rust-native vector DB (52K+ inserts/sec) |+| `@ruvector/attention` | 0.1.4 | Flash Attention mechanisms |+| `@ruvector/sona` | 0.1.5 | Self-Optimizing Neural Architecture (LoRA, EWC++) |+| `@ruvector/gnn` | 0.1.22 | Graph Neural Networks |++### Feature Overlap Analysis++**claude-flow ALREADY HAS** (via @claude-flow/embeddings):+| Feature | claude-flow | ruvector | Status |+|---------|-------------|----------|--------|+| ONNX Embeddings | β agentic-flow (~3ms) | β @ruvector/core | **Equivalent** |+| Local Embeddings | β all-MiniLM-L6-v2 | β all-MiniLM-L6-v2 | **Equivalent** |+| HNSW Indexing | β @claude-flow/memory | β @ruvector/core | **Equivalent** |+| Persistent Cache | β SQLite + LRU | β Memory cache | **Equivalent** |+| Hyperbolic Embeddings | β PoincarΓ© ball | β | **claude-flow ahead** |+| Document Chunking | β 4 strategies | β | **claude-flow ahead** |+| Normalization | β L2, L1, min-max, z-score | β | **claude-flow ahead** |+| Neural Substrate | β Drift, memory physics | β | **claude-flow ahead** |++### Unique ruvector Features (Integration Candidates)++#### π΄ Tier 1: High Value (claude-flow lacks these)++| Feature | ruvector Source | Integration Target | Value |+|---------|-----------------|-------------------|-------|+| Q-Learning Agent Router | `hooks_route` | `hooks route --task` | 80%+ accuracy, learns patterns |+| AST Analysis | `hooks_ast_analyze` | `analyze --ast` | Symbol extraction, complexity |+| Diff Classification | `hooks_diff_analyze` | `analyze --diff --risk` | Change risk scoring |+| Coverage Routing | `hooks_coverage_route` | `hooks route --coverage-aware` | Test-aware agent selection |++#### π‘ Tier 2: Medium Value++| Feature | ruvector Source | Integration Target |+|---------|-----------------|-------------------|+| Co-edit Prediction | Git history analysis | `predict --coedits` |+| Security Patterns | `hooks_security_scan` | `security scan --patterns` |++#### π’ Tier 3: Nice to Have++| Feature | ruvector Source | Use Case |+|---------|-----------------|----------|+| MinCut Boundaries | `hooks_graph_mincut` | Code organization |+| Louvain Communities | `hooks_graph_cluster` | Module detection |+| GNN Layers | `@ruvector/gnn` | Graph analysis |++*Note: Flash Attention, SONA Learning, HNSW, and ONNX embeddings are already in claude-flow via agentic-flow.*++### MCP Tools from ruvector (Unique Only)++```bash+# Add ruvector MCP server (for unique features)+claude mcp add ruvector-mcp -- npx ruvector mcp-server+```++**Unique Tools Worth Integrating:**+- `hooks_route`, `hooks_route_enhanced` β Q-Learning agent routing (80%+ accuracy) β+- `hooks_ast_analyze`, `hooks_ast_complexity` β Code structure analysis β+- `hooks_diff_analyze`, `hooks_diff_classify` β Change classification β+- `hooks_coverage_route`, `hooks_coverage_suggest` β Test-aware routing β+- `hooks_graph_mincut`, `hooks_graph_cluster` β Code boundaries β++**Already in claude-flow (skip):**+- `hooks_rag_context` β Use @claude-flow/memory instead+- `hooks_attention_info` β Use @claude-flow/neural instead+- Embeddings tools β Use @claude-flow/embeddings instead++### Integration Approach++**Recommended: Option A - Add as Optional Dependency (for unique features only)**+```json+// @claude-flow/cli/package.json+{+ "optionalDependencies": {+ "ruvector": "^0.1.95"+ }+}+```++**CLI Wrappers (unique ruvector features):**+```bash+# Q-Learning agent routing (unique to ruvector)+claude-flow route "task" --q-learning # Uses hooks_route++# AST analysis (unique to ruvector)+claude-flow analyze ast src/ # Uses hooks_ast_analyze++# Diff classification (unique to ruvector)+claude-flow analyze diff --risk # Uses hooks_diff_analyze++# Coverage-aware routing (unique to ruvector)+claude-flow route "task" --coverage-aware # Uses hooks_coverage_route+```++**Already in claude-flow (DO NOT import from ruvector):**+```bash+claude-flow embeddings generate --local # Uses @claude-flow/embeddings (ONNX)+claude-flow memory search --semantic "query" # Uses @claude-flow/memory (HNSW)+```++### ruvector Integration Roadmap++#### Phase 1: Q-Learning Router (1-2 days)+- [ ] Add ruvector as optional dependency+- [ ] Implement `hooks route --q-learning` wrapper+- [ ] Add `info --ruvector` command for capability detection++#### Phase 2: Code Intelligence (1 week)+- [ ] Integrate AST analysis commands (`analyze ast`)+- [ ] Implement diff classification (`analyze diff --risk`)+- [ ] Add coverage-aware routing (`route --coverage-aware`)++#### Phase 3: Graph Analysis (2 weeks)+- [ ] Implement MinCut boundaries (`analyze --boundaries`)+- [ ] Add Louvain community detection (`analyze --modules`)+- [ ] Integrate GNN layers for dependency graphs++*Note: SONA, Flash Attention, HNSW already in claude-flow - no need to import.*