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

docs(userguide): update for v3.7 β€” substrate upgrades + agentdb delete tools

Reuven6c14c912e5c1
diff --git a/docs/USERGUIDE.md b/docs/USERGUIDE.md
index 6f088c7ebd..2e8db95945 100644
--- a/docs/USERGUIDE.md
+++ b/docs/USERGUIDE.md
@@ -1,6 +1,8 @@
# Ruflo User Guide
-> Complete reference documentation for Ruflo v3.5. For a quick overview, see the [README](../README.md).
+> Complete reference documentation for Ruflo v3.7. For a quick overview, see the [README](../README.md).
+>
+> **Latest:** `npx ruflo@latest --version` β†’ **3.7.0-alpha.8**. See [What's new in 3.7](#whats-new-in-37) below.
---
@@ -19,6 +21,61 @@
- [Architecture & Modules](#%EF%B8%8F-architecture--modules)
- [Configuration & Reference](#%EF%B8%8F-configuration--reference)
- [Help & Resources](#-help--resources)
+- [What's new in 3.7](#whats-new-in-37)
+
+---
+
+## What's new in 3.7
+
+Recent releases (3.7.0-alpha.1 through alpha.8) shipped four substantial pieces. End-user CLI surface is unchanged β€” these are substrate improvements that compound on every existing feature.
+
+### `@claude-flow/cli-core` (alpha.5+) β€” fast lite path for plugin scripts
+
+A new sibling package that handles **memory commands only** (no SQLite, no HNSW, no ONNX). Cold-cache `npx` wall-time drops from ~35s to ~1.5s β€” a measured **22.9Γ— speedup** for plugin authors.
+
+```bash
+# Plugin scripts can opt in via env flag:
+const cliPkg = process.env.CLI_CORE === '1'
+ ? '@claude-flow/cli-core@alpha' # ~1.5s cold-cache
+ : '@claude-flow/cli@latest'; # ~35s cold-cache (full features)
+```
+
+The full `@claude-flow/cli` is unchanged for end users. Reference: [`v3/@claude-flow/cli-core/MIGRATION.md`](../v3/@claude-flow/cli-core/MIGRATION.md). 8 plugin scripts in this repo are already CLI_CORE-aware.
+
+### Thompson sampling model router (alpha.5)
+
+The 3-tier model selector (Haiku / Sonnet / Opus) is now a **cost-adjusted multi-armed bandit** instead of static thresholds. `hooks_model-outcome` calls update Beta(Ξ±, Ξ²) priors per tier; `hooks_model-route` samples ΞΈ ~ Beta(Ξ±, Ξ²) and picks argmax. After ~50 outcomes the routing distribution self-corrects against tier overuse β€” no manual threshold tuning. Cost: 45 Β΅s per route call.
+
+### `@claude-flow/[email protected]` β€” substrate upgrades
+
+Six concrete additions to the neural package:
+
+1. **Persistence** β€” `serialize()` / `deserialize()` on `SONAManager`, `ReasoningBank`, `PatternLearner`. Process restarts no longer wipe state.
+2. **Seedable PRNG** β€” `Mulberry32` + `setGlobalRng` for reproducible training runs and deterministic tests.
+3. **Self-consistency orchestrator** β€” `selfConsistency(N, op, aggregator)` (Wang et al. 2022). 5–15pp accuracy on reasoning tasks at Nx compute.
+4. **Flash Attention + MoE routing** migrated from cli into the package (1,679 LOC moved). Single source of truth.
+5. **Retrieval-path observability** β€” `hnswRetrievalCount` vs `bruteForceRetrievalCount` in stats so you can tell which path your queries actually hit.
+6. **80+ npm SEO keywords** β€” package now discoverable for `ai-agents`, `multi-agent`, `RL`, `LoRA`, `EWC`, etc.
+
+### `agentdb_*-delete` MCP tools (alpha.8)
+
+Three new MCP tools wired through [email protected]'s native Cypher-routed delete API:
+
+- `agentdb_hierarchical-delete` β€” calls `ReflexionMemory.deleteEpisode` (graph + vector + SQL all-in-one)
+- `agentdb_causal-edge-delete` β€” calls `GraphDatabaseAdapter.deleteEdgesByEndpoints(from, to, relation?)` (Cypher-injection-safe)
+- `agentdb_causal-node-delete` β€” calls `GraphDatabaseAdapter.deleteNode(id, {cascade: true})` returns native `{deletedNode, deletedEdges}` audit
+
+All wrapped in MutationGuard (fail-closed) + AttestationLog (audit). Unblocks `/adr-index` re-index when ADR files are deleted from disk β€” stale nodes + dangling `supersedes` / `amends` / `related` / `depends-on` edges are now scrubbable. Closed [#1784](https://github.com/ruvnet/ruflo/issues/1784).
+
+### What didn't change
+
+- Public CLI surface (26 commands, 140+ subcommands)
+- Agent registry (60+ agent types)
+- Plugin marketplace
+- Hooks system (27 hooks + 12 background workers)
+- Configuration files (`claude-flow.config.json`, `.env`, etc.)
+
+If you're running `npx ruflo@latest`, everything you used in 3.6 still works. The above improvements compound underneath.
---
@@ -1040,7 +1097,7 @@ flowchart LR
<details>
<summary>🧠 <strong>AgentDB v3 Controllers</strong> β€” 20+ intelligent memory controllers</summary>
-Ruflo V3 integrates AgentDB v3 (3.0.0-alpha.10) providing 20+ memory controllers accessible via MCP tools and the CLI.
+Ruflo V3 integrates AgentDB v3 (3.0.0-alpha.13) providing 20+ memory controllers accessible via MCP tools and the CLI. As of `@claude-flow/[email protected]`, the integration includes the new Cypher-routed delete API (`deleteNode`, `deleteEdge`, `deleteEdgesByEndpoints`, `deleteHyperedge`, plus `ReflexionMemory.deleteEpisode`) for full re-index support.
**Core Memory:**