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 2/4) β€” encryption-at-rest notes for memory plugins

Reuven6130f4061cd0
diff --git a/plugins/ruflo-rag-memory/.claude-plugin/plugin.json b/plugins/ruflo-rag-memory/.claude-plugin/plugin.json
index d9c09d9f6f..4f1e1ff88b 100644
--- a/plugins/ruflo-rag-memory/.claude-plugin/plugin.json
+++ b/plugins/ruflo-rag-memory/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
{
"name": "ruflo-rag-memory",
"description": "RuVector memory with HNSW search, AgentDB, and semantic retrieval",
- "version": "0.1.0",
+ "version": "0.2.0",
"author": {
"name": "ruvnet",
"url": "https://github.com/ruvnet"
diff --git a/plugins/ruflo-rag-memory/README.md b/plugins/ruflo-rag-memory/README.md
index b69e3328ea..f896125211 100644
--- a/plugins/ruflo-rag-memory/README.md
+++ b/plugins/ruflo-rag-memory/README.md
@@ -73,6 +73,17 @@ Claude Code Auto-Memory (~/.claude/projects/*/memory/*.md)
Semantic Search (150x-12,500x faster)
```
+## Encryption at rest (ruflo 3.6.25+)
+
+The AgentDB SQLite blob written by this plugin (`.swarm/memory.db`) supports opt-in AES-256-GCM encryption at rest per [ADR-096](../../v3/docs/adr/ADR-096-encryption-at-rest.md). When `CLAUDE_FLOW_ENCRYPT_AT_REST=1` and `CLAUDE_FLOW_ENCRYPTION_KEY` is set:
+
+- Each write of `.swarm/memory.db` is encrypted with a fresh 12-byte IV (`writeFileRestricted({encrypt:true})`).
+- Reads use `readFileMaybeEncrypted(path, null)` β€” magic-byte sniff (`RFE1`) so legacy plaintext memory.db files keep working unchanged during the migration window.
+- Embeddings are encrypted along with the rest of the SQLite blob β€” no separate column-level encryption needed for Phase 1.
+- A flipped byte fails GCM auth and produces a decrypt error rather than silent corruption.
+
+Verify gate state with `ruflo doctor -c encryption`. Off by default; flipping it on doesn't require a migration step (legacy plaintext bytes are sniffed on read; first write after enable rewrites the DB encrypted).
+
## Memory Namespaces
| Namespace | Purpose | Example Key |
diff --git a/plugins/ruflo-rvf/.claude-plugin/plugin.json b/plugins/ruflo-rvf/.claude-plugin/plugin.json
index 907afdf4e8..c05e67191d 100644
--- a/plugins/ruflo-rvf/.claude-plugin/plugin.json
+++ b/plugins/ruflo-rvf/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
{
"name": "ruflo-rvf",
"description": "RVF format for portable agent memory, session persistence, and cross-platform transfer",
- "version": "0.1.0",
+ "version": "0.2.0",
"author": {
"name": "ruvnet",
"url": "https://github.com/ruvnet"
diff --git a/plugins/ruflo-rvf/README.md b/plugins/ruflo-rvf/README.md
index 2a060b0116..690f4118d8 100644
--- a/plugins/ruflo-rvf/README.md
+++ b/plugins/ruflo-rvf/README.md
@@ -17,6 +17,17 @@ RVF format for portable agent memory, session persistence, and cross-platform tr
- **Claude memory bridge**: Import Claude Code auto-memories into AgentDB
- **Format migration**: Upgrade RVF files across versions
+## Encryption at rest (ruflo 3.6.25+)
+
+Sessions persisted by this plugin land at `.claude-flow/sessions/*.json`, which are written through `fs-secure.writeFileRestricted({encrypt:true})` per [ADR-096](../../v3/docs/adr/ADR-096-encryption-at-rest.md). Behavior under the gate:
+
+- **Off by default** (`CLAUDE_FLOW_ENCRYPT_AT_REST` unset / falsy) β€” sessions are plaintext JSON at mode 0600, same as ruflo 3.6.24 and earlier.
+- **On** (`CLAUDE_FLOW_ENCRYPT_AT_REST=1` + `CLAUDE_FLOW_ENCRYPTION_KEY` set to 64-char hex or 44-char base64) β€” each session save is AES-256-GCM with `RFE1` magic-byte prefix. Session restore transparently decrypts via the magic sniff; legacy plaintext sessions still load unchanged during migration.
+
+When **exporting RVF files for cross-machine transfer**, the encryption gate does NOT apply to the exported bytes β€” the encryption is at-rest on the *originating* host. If the RVF is itself sensitive, transport security (sealed boxes / signed blobs) is the next phase per the ADR roadmap.
+
+Confirm the gate state with `ruflo doctor -c encryption`.
+
## Commands
- `/rvf` -- Memory stats, saved sessions, storage metrics