π 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
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.jsonindex 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.mdindex 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 managementdiff --git a/plugins/ruflo-knowledge-graph/.claude-plugin/plugin.json b/plugins/ruflo-knowledge-graph/.claude-plugin/plugin.jsonindex 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.mdindex 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 graph4. **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