Skip to content

armgit / ruflo

Public Imported from GitHub
0

🌊 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

Checkpoint: File edits

rUv57cb599b29db
diff --git a/README.md b/README.md
index 038d67863e..7566ee4091 100644
--- a/README.md
+++ b/README.md
@@ -32,88 +32,91 @@ User β†’ Claude-Flow (CLI/MCP) β†’ Router β†’ Swarm β†’ Agents β†’ Memory β†’ LL
<details>
<summary>πŸ“ <strong>Expanded Architecture</strong> β€” Full system diagram with RuVector intelligence</summary>
-```
-β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
-β”‚ CLAUDE-FLOW V3 ARCHITECTURE β”‚
-β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
-β”‚ β”‚
-β”‚ β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚
-β”‚ β”‚ User │────▢│ CLI / MCP │────▢│ AIDefence β”‚ β”‚
-β”‚ β”‚ β”‚ β”‚ Server β”‚ β”‚ Security β”‚ β”‚
-β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β”‚
-β”‚ β”‚ β”‚
-β”‚ β–Ό β”‚
-β”‚ β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚
-β”‚ β”‚ ROUTING LAYER β”‚ β”‚
-β”‚ β”‚ β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚ β”‚
-β”‚ β”‚ β”‚ Q-Learning β”‚ β”‚ MoE β”‚ β”‚ Skills β”‚ β”‚ Hooks β”‚ β”‚ β”‚
-β”‚ β”‚ β”‚ Router β”‚ β”‚ 8 Experts β”‚ β”‚ (42+) β”‚ β”‚ (17) β”‚ β”‚ β”‚
-β”‚ β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β”‚ β”‚
-β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β”‚
-β”‚ β”‚ β”‚
-β”‚ β–Ό β”‚
-β”‚ β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚
-β”‚ β”‚ SWARM COORDINATION β”‚ β”‚
-β”‚ β”‚ β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚ β”‚
-β”‚ β”‚ β”‚ Topologies β”‚ β”‚ Consensus β”‚ β”‚ Claims β”‚ β”‚ β”‚
-β”‚ β”‚ β”‚ mesh/hier/ β”‚ β”‚ Raft/BFT/ β”‚ β”‚ Human-Agent β”‚ β”‚ β”‚
-β”‚ β”‚ β”‚ ring/star β”‚ β”‚ Gossip/CRDT β”‚ β”‚ Coordination β”‚ β”‚ β”‚
-β”‚ β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β”‚ β”‚
-β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β”‚
-β”‚ β”‚ β”‚
-β”‚ β–Ό β”‚
-β”‚ β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚
-β”‚ β”‚ 54+ AGENTS β”‚ β”‚
-β”‚ β”‚ coder β”‚ tester β”‚ reviewer β”‚ architect β”‚ security β”‚ devops β”‚ ml β”‚ ... β”‚ β”‚
-β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β”‚
-β”‚ β”‚ β”‚
-β”‚ β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚
-β”‚ β–Ό β–Ό β–Ό β”‚
-β”‚ β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚
-β”‚ β”‚ Memory β”‚ β”‚ Providers β”‚ β”‚ Background Workers β”‚ β”‚
-β”‚ β”‚ (AgentDB) β”‚ β”‚ Claude/GPT/ β”‚ β”‚ (12) β”‚ β”‚
-β”‚ β”‚ β”‚ β”‚ Gemini/ β”‚ β”‚ ultralearn/audit/ β”‚ β”‚
-β”‚ β”‚ β”‚ β”‚ Ollama β”‚ β”‚ optimize/map/... β”‚ β”‚
-β”‚ β””β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β”‚
-β”‚ β”‚ β”‚
-β”‚ β–Ό β”‚
-β”‚ β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚
-β”‚ β”‚ RUVECTOR INTELLIGENCE LAYER (npx ruvector) β”‚ β”‚
-β”‚ β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€ β”‚
-β”‚ β”‚ β”‚ β”‚
-β”‚ β”‚ β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚ β”‚
-β”‚ β”‚ β”‚ SONA β”‚ β”‚ EWC++ β”‚ β”‚ Flash Attn β”‚ β”‚ β”‚
-β”‚ β”‚ β”‚ Self-Optimize β”‚ β”‚ No Forgetting β”‚ β”‚ 2.49-7.47x β”‚ β”‚ β”‚
-β”‚ β”‚ β”‚ <0.05ms β”‚ β”‚ Consolidation β”‚ β”‚ Speedup β”‚ β”‚ β”‚
-β”‚ β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β”‚ β”‚
-β”‚ β”‚ β”‚ β”‚
-β”‚ β”‚ β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚ β”‚
-β”‚ β”‚ β”‚ HNSW β”‚ β”‚ ReasoningBank β”‚ β”‚ Hyperbolic β”‚ β”‚ β”‚
-β”‚ β”‚ β”‚ 150x-12,500x β”‚ β”‚ Pattern Store β”‚ β”‚ PoincarΓ© β”‚ β”‚ β”‚
-β”‚ β”‚ β”‚ Faster Search β”‚ β”‚ + Retrieval β”‚ β”‚ Embeddings β”‚ β”‚ β”‚
-β”‚ β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β”‚ β”‚
-β”‚ β”‚ β”‚ β”‚
-β”‚ β”‚ β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚ β”‚
-β”‚ β”‚ β”‚ LoRA/Micro β”‚ β”‚ Int8 Quant β”‚ β”‚ 9 RL Algos β”‚ β”‚ β”‚
-β”‚ β”‚ β”‚ 128x Compress β”‚ β”‚ 3.92x Memory β”‚ β”‚ Q/SARSA/A2C/ β”‚ β”‚ β”‚
-β”‚ β”‚ β”‚ <5MB Edge β”‚ β”‚ Reduction β”‚ β”‚ PPO/DQN/... β”‚ β”‚ β”‚
-β”‚ β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β”‚ β”‚
-β”‚ β”‚ β”‚ β”‚
-β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β”‚
-β”‚ β”‚ β”‚
-β”‚ β–Ό β”‚
-β”‚ β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚
-β”‚ β”‚ LEARNING LOOP β”‚ β”‚
-β”‚ β”‚ RETRIEVE ──▢ JUDGE ──▢ DISTILL ──▢ CONSOLIDATE ──▢ ROUTE β”‚ β”‚
-β”‚ β”‚ (HNSW) (Verdict) (LoRA) (EWC++) (Better) β”‚ β”‚
-β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β”‚
-β”‚ β”‚ β”‚
-β”‚ └──────────────── loops back to Router ──────────────│
-β”‚ β”‚
-β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
-```
-
-**RuVector Components:**
+```mermaid
+flowchart TB
+ subgraph USER["πŸ‘€ User Layer"]
+ U[User]
+ end
+
+ subgraph ENTRY["πŸšͺ Entry Layer"]
+ CLI[CLI / MCP Server]
+ AID[AIDefence Security]
+ end
+
+ subgraph ROUTING["🧭 Routing Layer"]
+ QL[Q-Learning Router]
+ MOE[MoE - 8 Experts]
+ SK[Skills - 42+]
+ HK[Hooks - 17]
+ end
+
+ subgraph SWARM["🐝 Swarm Coordination"]
+ TOPO[Topologies<br/>mesh/hier/ring/star]
+ CONS[Consensus<br/>Raft/BFT/Gossip/CRDT]
+ CLM[Claims<br/>Human-Agent Coord]
+ end
+
+ subgraph AGENTS["πŸ€– 54+ Agents"]
+ AG1[coder]
+ AG2[tester]
+ AG3[reviewer]
+ AG4[architect]
+ AG5[security]
+ AG6[...]
+ end
+
+ subgraph RESOURCES["πŸ“¦ Resources"]
+ MEM[(Memory<br/>AgentDB)]
+ PROV[Providers<br/>Claude/GPT/Gemini/Ollama]
+ WORK[Workers - 12<br/>ultralearn/audit/optimize]
+ end
+
+ subgraph RUVECTOR["🧠 RuVector Intelligence Layer"]
+ direction TB
+ subgraph ROW1[" "]
+ SONA[SONA<br/>Self-Optimize<br/>&lt;0.05ms]
+ EWC[EWC++<br/>No Forgetting]
+ FLASH[Flash Attention<br/>2.49-7.47x]
+ end
+ subgraph ROW2[" "]
+ HNSW[HNSW<br/>150x-12,500x faster]
+ RB[ReasoningBank<br/>Pattern Store]
+ HYP[Hyperbolic<br/>PoincarΓ©]
+ end
+ subgraph ROW3[" "]
+ LORA[LoRA/Micro<br/>128x compress]
+ QUANT[Int8 Quant<br/>3.92x memory]
+ RL[9 RL Algos<br/>Q/SARSA/PPO/DQN]
+ end
+ end
+
+ subgraph LEARNING["πŸ”„ Learning Loop"]
+ L1[RETRIEVE] --> L2[JUDGE] --> L3[DISTILL] --> L4[CONSOLIDATE] --> L5[ROUTE]
+ end
+
+ U --> CLI
+ CLI --> AID
+ AID --> QL & MOE & SK & HK
+ QL & MOE & SK & HK --> TOPO & CONS & CLM
+ TOPO & CONS & CLM --> AG1 & AG2 & AG3 & AG4 & AG5 & AG6
+ AG1 & AG2 & AG3 & AG4 & AG5 & AG6 --> MEM & PROV & WORK
+ MEM --> SONA & EWC & FLASH
+ SONA & EWC & FLASH --> HNSW & RB & HYP
+ HNSW & RB & HYP --> LORA & QUANT & RL
+ LORA & QUANT & RL --> L1
+ L5 -.->|loops back| QL
+
+ style RUVECTOR fill:#1a1a2e,stroke:#e94560,stroke-width:2px
+ style LEARNING fill:#0f3460,stroke:#e94560,stroke-width:2px
+ style USER fill:#16213e,stroke:#0f3460
+ style ENTRY fill:#1a1a2e,stroke:#0f3460
+ style ROUTING fill:#1a1a2e,stroke:#0f3460
+ style SWARM fill:#1a1a2e,stroke:#0f3460
+ style AGENTS fill:#1a1a2e,stroke:#0f3460
+ style RESOURCES fill:#1a1a2e,stroke:#0f3460
+```
+
+**RuVector Components** (`npx ruvector`):
| Component | Purpose | Performance |
|-----------|---------|-------------|