π 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 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.jsonindex 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.mdindex 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.jsonindex 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.mdindex 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