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

Closes Part 1 of ADR-098. Documents the 5 AgentDB controllers
activated in 3.6.23+/3.6.24 (G7 from ADR-095) so end users of
ruflo-agentdb and ruflo-knowledge-graph know they're available.

ruflo-agentdb/README.md:
  New "G7 controllers (activated in ruflo 3.6.23+ / 3.6.24)" section
  with a 5-row table (controller / role / source). Each entry cites
  the dist file inside the agentdb npm package so users can verify
  the wiring locally:
    gnnService           — GNN embeddings + relational scoring
    rvfOptimizer         — quantize + dedupe vector blocks
    mutationGuard        — WASM proof generation for state mutations
    attestationLog       — hash-chained audit log (.swarm/attestation.db)
    GuardedVectorBackend — wraps vectorBackend with guard + log
  Notes graphAdapter still pending external graph-DB connection.
  Pointers to agentdb_controllers / agentdb_health for runtime
  inspection.

ruflo-knowledge-graph/README.md:
  Targeted G7 section explaining which controllers help this plugin
  specifically:
    gnnService            — augments pathfinder semantic_similarity
                             with structural relational scoring
    rvfOptimizer          — collapses near-duplicate entity vectors
                             (same class re-exported from multiple
                             modules)
    mutationGuard +
    attestationLog +
    GuardedVectorBackend  — proof-gated writes for federated knowledge
                             import; .swarm/attestation.db audit trail
  Notes graphAdapter as a future improvement that would replace the
  current flat-causal-edge view with a real graph-DB backend.

Plugin versions:
  ruflo-agentdb          0.1.0 → 0.2.0 (minor — capability sync)
  ruflo-knowledge-graph  0.1.0 → 0.2.0 (minor — capability sync)

ADR-098 Part 1 complete: 6 plugins now reference recent ADR
capabilities. Acceptance: each affected plugin has a paragraph or
bullet list referencing the relevant ADR — done for the 6 plugins
flagged in the Part 1 table.

Remaining ADR-098 work:
  - Part 2: token diet (4 fat agent prompts → ≤ 60 lines)
  - Part 5: worker dispatch (≥ 8 work-producing agents)

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"

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

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"

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