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

feat(plugins): ADR-098 Part 1 (slice 4/4) β€” G7 controllers in agentdb + knowledge-graph

Reuvencf96a562c105
diff --git a/plugins/ruflo-agentdb/.claude-plugin/plugin.json b/plugins/ruflo-agentdb/.claude-plugin/plugin.json
index eb3d86c44b..bb2edaa5c2 100644
--- a/plugins/ruflo-agentdb/.claude-plugin/plugin.json
+++ b/plugins/ruflo-agentdb/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
{
"name": "ruflo-agentdb",
"description": "AgentDB memory controllers with HNSW vector search, RuVector embeddings, and causal knowledge graphs",
- "version": "0.1.0",
+ "version": "0.2.0",
"author": {
"name": "ruvnet",
"url": "https://github.com/ruvnet"
diff --git a/plugins/ruflo-agentdb/README.md b/plugins/ruflo-agentdb/README.md
index 7e24f9a289..d4d6388be3 100644
--- a/plugins/ruflo-agentdb/README.md
+++ b/plugins/ruflo-agentdb/README.md
@@ -19,6 +19,22 @@ Wraps Ruflo's AgentDB MCP tools (agentdb_*, embeddings_*, ruvllm_hnsw_*) into sk
- **Causal knowledge graphs**: Link related knowledge with causal edges
- **Hyperbolic embeddings**: Poincare ball model for hierarchical data
+## G7 controllers (activated in ruflo 3.6.23+ / 3.6.24)
+
+[ADR-095](../../v3/docs/adr/ADR-095-architectural-gaps-from-april-audit.md) closed five previously-disabled AgentDB controllers. They're now wired by default in the ControllerRegistry and reachable via `agentdb_*` MCP tools or the `/agentdb` slash command:
+
+| Controller | Role | Source |
+|---|---|---|
+| `gnnService` | Graph Neural Network embeddings + relational scoring over the AgentDB causal graph. No-arg construction, safe-default activation. | `agentdb/dist/src/services/GNNService.js` |
+| `rvfOptimizer` | RuVector format compaction β€” quantizes + dedupes vector blocks before persistence. No-arg construction. | `agentdb/dist/src/optimizations/RVFOptimizer.js` |
+| `mutationGuard` | WASM-backed proof generation for state mutations (ADR-060). Gates writes through proof verification. | `agentdb/dist/src/security/MutationGuard.js` |
+| `attestationLog` | Hash-chained audit log of mutations. Backed by a dedicated `.swarm/attestation.db` (separate from main memory.db so the audit trail is isolated). Requires `better-sqlite3`. | `agentdb/dist/src/security/AttestationLog.js` |
+| `GuardedVectorBackend` | Wraps the existing vectorBackend with `mutationGuard` + `attestationLog` for proof-gated writes. Activates only when both prerequisites resolve. | `agentdb/dist/src/backends/ruvector/GuardedVectorBackend.js` |
+
+The remaining G7 controller β€” `graphAdapter` β€” is still pending an external graph-DB connection. Tracked in ADR-095.
+
+Inspect runtime status: `agentdb_controllers` MCP tool or `agentdb_health` β€” both report initialization status per controller.
+
## Commands
- `/agentdb` -- AgentDB health, controller status, session management
diff --git a/plugins/ruflo-knowledge-graph/.claude-plugin/plugin.json b/plugins/ruflo-knowledge-graph/.claude-plugin/plugin.json
index cca703b4a6..a66bd44acf 100644
--- a/plugins/ruflo-knowledge-graph/.claude-plugin/plugin.json
+++ b/plugins/ruflo-knowledge-graph/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
{
"name": "ruflo-knowledge-graph",
- "description": "Knowledge graph construction β€” entity extraction, relation mapping, and pathfinder graph traversal",
- "version": "0.1.0",
+ "description": "Knowledge graph construction \u2014 entity extraction, relation mapping, and pathfinder graph traversal",
+ "version": "0.2.0",
"author": {
"name": "ruvnet",
"url": "https://github.com/ruvnet"
diff --git a/plugins/ruflo-knowledge-graph/README.md b/plugins/ruflo-knowledge-graph/README.md
index 7504633a19..46bb5267cd 100644
--- a/plugins/ruflo-knowledge-graph/README.md
+++ b/plugins/ruflo-knowledge-graph/README.md
@@ -54,8 +54,21 @@ kg search <query> # Semantic search across the graph
4. **Prune** -- remove paths below threshold (default 0.3)
5. **Rank** -- return top-K paths by cumulative relevance
+## G7 controllers (activated in ruflo 3.6.23+ / 3.6.24)
+
+[ADR-095](../../v3/docs/adr/ADR-095-architectural-gaps-from-april-audit.md) closed five AgentDB controllers that this plugin's graph traversal can leverage:
+
+- **`gnnService`** β€” GNN embeddings + relational scoring over the AgentDB causal graph. Augments the pathfinder's `semantic_similarity(query, node)` term with structurally-aware scoring; nodes that are graph-neighbors of confirmed-relevant nodes get a boost.
+- **`rvfOptimizer`** β€” Quantizes + dedupes vector blocks before persistence. Knowledge-graph indexes commonly have many near-duplicate entity vectors (same class re-exported from multiple modules); rvfOptimizer collapses them transparently.
+- **`mutationGuard`** + **`attestationLog`** + **`GuardedVectorBackend`** β€” Proof-gated writes to the underlying vector store. Relevant when the graph spans trust boundaries (federated knowledge import) β€” the attestation chain at `.swarm/attestation.db` records every mutation for after-the-fact audit.
+
+The yet-pending **`graphAdapter`** controller will give this plugin a first-class graph-DB backend (instead of building the graph view on top of AgentDB's flat causal-edge table). Tracked in ADR-095.
+
+Inspect runtime status via the `agentdb_controllers` or `agentdb_health` MCP tools.
+
## Related Plugins
+- `ruflo-agentdb` -- The G7 controllers above ship via this plugin's runtime; install both for full graph + traversal coverage
- `ruflo-ruvector` -- HNSW indexing for fast semantic search across graph nodes
- `ruflo-adr` -- ADR dependency graphs share the same causal edge model