mirror of
https://github.com/ruvnet/ruflo.git
synced 2026-09-14 14:01:28 +08:00
ruv
ce1b33d2de
Coordination follow-up: when EVERY worker fails on an auth/credit error (looksLikeAuthError), the overview degrades honestly — next steps state no usable model auth was detected and point at the defer path (claude -p / hive-mind spawn --claude / --no-execute plan-only), per ADR-385 consequences. Detection runs AFTER execution, not as a pre-flight gate: ambient `claude -p` auth has no single env signal, so gating on an env var would wrongly fall back even where auth works (as the e2e proved). Where auth is present, execution is unchanged. +2 unit tests (fallback fires on all-auth-fail; does not fire when any worker succeeds). State writes keep the existing `swarmId` key — the status/stop id reconciliation (#3253) is untouched. Co-Authored-By: RuFlo <ruv@ruv.net>
Claude Flow V3 - Architecture Decision Records
All ADRs are located in /v3/implementation/adrs/.
Quick Links
| ADR | Title | Status |
|---|---|---|
| ADR-001 | Adopt agentic-flow as Core Foundation | Complete |
| ADR-002 | Domain-Driven Design Structure | Complete |
| ADR-003 | Single Coordination Engine | Complete |
| ADR-004 | Plugin Architecture | Complete |
| ADR-005 | MCP-First API Design | Complete |
| ADR-006 | Unified Memory Service | Complete |
| ADR-007 | Event Sourcing | Complete |
| ADR-008 | Vitest Testing | Complete |
| ADR-009 | Hybrid Memory Backend | Complete |
| ADR-010 | Node.js Only | Complete |
| ADR-011 | LLM Provider System | Complete |
| ADR-012 | MCP Security Features | Complete |
| ADR-013 | Core Security Module | Complete |
| ADR-014 | Workers System | Complete |
| ADR-015 | Unified Plugin System | Complete |
| ADR-016 | Collaborative Issue Claims | Complete |
| ADR-017 | RuVector Integration | Complete |
| ADR-018 | Claude Code Integration | Complete |
| ADR-019 | Headless Runtime Package | Complete |
| ADR-020 | Headless Worker Integration | Complete |
| ADR-046 | Dual Umbrella: claude-flow + ruflo | Accepted |
| ADR-047 | Fast Mode Integration | Proposed |
| ADR-178 | Verifiable Memory Governance and RepE IPI Detection | Proposed |
| ADR-301 | Promotional Status Surface for CLI Runtime | Proposed |
| ADR-302 | Post-Initialization Capability Enrollment | Proposed |
| ADR-303 | Intelligent Credit Exhaustion Experience | Proposed |
| ADR-304 | Local Meta LLM Proxy Product | Proposed |
| ADR-305 | Customer Lifecycle Funnel (RuFlo → Cognitum) | Proposed |
| ADR-306 | Cognitum Authentication and Account Linking | Proposed |
| ADR-307 | Proxy Runtime, Packaging, and Service Lifecycle | Proposed |
| ADR-308 | Cognitum Public API and Server Contract | Proposed |
| ADR-309 | Funnel Governance, Privacy, and Ecosystem Policy | Proposed |
| ADR-310 | Funnel Rollout, Measurement, and Emergency Controls | Proposed |
| ADR-320 | MCP Tool Composition Inspector + Inter-Agent Channel Guardrails | Accepted |
| ADR-323 | Typed Memory Provenance in AgentDB (MemIR-style claim typing, corrects #2804's dream-cycle proposal) | Accepted |
| ADR-324 | Agentic Policy Engine and Policy-Governed Codex Swarms | Accepted |
| ADR-325 | Claim Federation as a Zero-Trust Capability and Work-Ownership Plane | Proposed |
| ADR-326 | Cognitum Product-Plane Claim Federation Profile | Proposed |
| ADR-327 | Federated Concurrent Development Harness | Proposed |
| ADR-328 | Cognitum-Assisted Agent Learning Capability Plane | Proposed |
| ADR-329 | Ruflo Capability Brain for MCP Guidance | Accepted |
| ADR-330 | Adaptive Pheromone Swarm Consensus | Accepted |
| ADR-331 | Project-Local Flywheel Evaluation Anchors | Accepted |
| ADR-332 | Hermetic Release Verification and Supported Runtime Baseline | Accepted |
| ADR-333 | Efficiency-First Orchestration — Pre-hoc Failure Inference and Adaptive Agent Count Routing | Proposed |
| ADR-334 | Hierarchical Consensus Topology for Large-Scale Swarm Coordination | Proposed |
| ADR-335 | Upgrade to Multi-Vector HNSW (MV-HNSW) for Agent Memory Retrieval | Proposed |
| ADR-336 | Agent Authorization Propagation and MCP Authentication Enforcement | Proposed |
| ADR-337 | Plugin Supply Chain Integrity and Memory Namespace Governance | Proposed |
| ADR-338 | SONA Behavioral Trajectory Auditing via Embedding-Space Trait Vectors | Proposed |
| ADR-339 | Memory Write Integrity Validation & MCP Tool Verification | Proposed |
| ADR-340 | Retrospective Harness Optimization (RHO) for SONA Intelligence Loop | Proposed |
| ADR-341 | Multi-Signal Memory Retrieval | Proposed |
| ADR-342 | RuVector Production-Scale Backend Adoption | Proposed |
| ADR-343 | Shared-Context Parallel Dispatch for Multi-Agent Performance | Proposed |
| ADR-344 | Knowledge Graph Index for ReasoningBank | Proposed |
| ADR-345 | Swarm Credit Routing via Shapley-Value Attribution | Proposed |
| ADR-346 | Multi-Layer Agent Security Stack | Proposed |
| ADR-347 | Trajectory-Quality JUDGE Scoring for ReasoningBank | Proposed |
| ADR-348 | Task-Adaptive Swarm Topology Selector | Proposed |
| ADR-349 | FLARE-Style Lookahead Planning Buffer for SONA Intelligence Layer | Proposed |
| ADR-350 | Trust-Weighted Consensus for Swarm Coordination | Proposed |
| ADR-351 | Stateful Execution Loop with KV-Cache Discipline and Agent Execution Graphs | Proposed |
| ADR-352 | MCP Tool Permission Attestation (Min-Privilege Contract) | Proposed |
| ADR-353 | Trace-to-Skill Distillation for Intelligence Pipeline | Proposed |
| ADR-354 | AgentDB Memory Write Verification and Temporal Supersession Layer | Proposed |
| ADR-355 | Reinforcement-Learned Stopping Policy for Ruflo Swarm Orchestration | Proposed |
| ADR-356 | Cross-Agent KV-Cache Sharing for Swarm Performance | Proposed |
| ADR-357 | Dimension-Aware Intelligence Routing for Heterogeneous Agent Pools | Proposed |
| ADR-358 | AutoMem-Style RL Training Loop for AgentDB Memory Operations | Proposed |
| ADR-359 | Swarm Dissent Mechanism: Inverse-Wisdom Law Compliance | Proposed |
| ADR-360 | Cross-Agent Shared KV Pool (PolyKV Architecture) | Proposed |
| ADR-361 | Skill Evolution Worker (SEW) — Runtime RL-Based Skill Acquisition for SONA | Proposed |
| ADR-362 | HNSW-as-Communication-Fabric (HCF) for RuVector Swarm Knowledge Gossip | Proposed |
| ADR-363 | Workflow-Atomic Inference Scheduling (WAIS) for Multi-Agent Execution | Proposed |
| ADR-364 | Plugin Supply-Chain Scanner and Behavioral Manifest | Proposed |
| ADR-365 | Recurrence-Gated Memory Consolidation for AgentDB | Proposed |
| ADR-366 | Self-Evolving Swarm Skill Distillation via Trajectory Feedback | Proposed |
| ADR-367 | Epistemic Working Memory in the Intelligence Pipeline | Proposed |
| ADR-368 | Selective Persistent Memory Categories for AgentDB | Proposed |
| ADR-369 | Information-Bottleneck Vector-Quantized Inter-Agent Messaging | Proposed |
| ADR-370 | World-Model Agent Planning for Cost-Aware Task Pre-Simulation | Proposed |
| ADR-371 | Neural Cryptographic Authorization Gate for Agentic Action Execution | Proposed |
| ADR-372 | Cognitive Mode Router for Agent Memory Query Dispatch | Proposed |
| ADR-373 | Budget-Dependent Memory Operator Selection (OAS) | Proposed |
| ADR-374 | SubagentPermissionDelegate: Workspace-Scoped Privilege Delegation for Swarm Agents | Proposed |
| ADR-375 | Agentic Inference Benchmarking Standard + Mixture-of-Agents Test-Time Scaling | Proposed |
| ADR-376 | Heterogeneous Agent Ensemble Composition API | Proposed |
| ADR-377 | AgentDB Retrieval Security Layer | Proposed |
| ADR-378 | npm Trusted Publishing for CI/CD Release Automation | Proposed |
| ADR-379 | Optional Context/Session/Week Usage Segments and Extra Statusline Lines | Proposed |
| ADR-380 | AGNTCY/Outshift Runtime Integration: SLIM Transport, CASA Enforcement, IOC Coordination Events | Proposed |
Summary Documents
- ADR Status Summary - Implementation status overview
- V3 ADRs Master - Complete ADR document
- Full README - Detailed index with roadmap
Performance Targets
| Metric | Target | Status |
|---|---|---|
| HNSW Search | 150x-12,500x faster | ✅ Achieved |
| Flash Attention | 2.49x-7.47x speedup | ✅ Achieved (alpha.102) |
| Memory Reduction | 50-75% | ✅ Achieved |
| MCP Response | <100ms | ✅ Achieved |
| CLI Startup | <500ms | ✅ Achieved |
Neural Features (alpha.102+)
| Component | Status | Lines | Notes |
|---|---|---|---|
| SONA Optimizer | ✅ Real | 841 | Pattern learning from trajectories |
| EWC++ Consolidation | ✅ Real | ~600 | Fisher matrix, prevents forgetting |
| MoE Router | ✅ Real | ~500 | 8 experts with gating network |
| Flash Attention | ✅ Real | ~500 | O(N) block attention |
| LoRA Adapter | ✅ Real | ~400 | 128x compression (rank=8) |
| Hyperbolic Embeddings | ✅ Real | - | Poincaré ball model |
| Int8 Quantization | ✅ Real | - | 3.92x memory savings |
Security Status
| CVE | Severity | Status |
|---|---|---|
| CVE-2 | Critical | ✅ Fixed |
| CVE-3 | Critical | ✅ Fixed |
| HIGH-1 | High | ✅ Fixed |
| HIGH-2 | High | ✅ Fixed |
Security Score: 10/10
Last Updated: 2026-01-14 CLI Version: @claude-flow/cli@3.0.0-alpha.104