π 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(ruflo-rag-memory): adopt plugin contract β claude-memories reserved-namespace consumer (ADR-0001)
Reuven2b6cefd5798c
diff --git a/plugins/ruflo-rag-memory/.claude-plugin/plugin.json b/plugins/ruflo-rag-memory/.claude-plugin/plugin.jsonindex 4f1e1ff88b..62e6b4b943 100644--- a/plugins/ruflo-rag-memory/.claude-plugin/plugin.json+++ b/plugins/ruflo-rag-memory/.claude-plugin/plugin.json@@ -14,6 +14,9 @@"hnsw","agentdb","rag",- "vector-search"+ "vector-search",+ "mcp",+ "claude-memories",+ "bridged-memory"]}diff --git a/plugins/ruflo-rag-memory/README.md b/plugins/ruflo-rag-memory/README.mdindex f896125211..82f27a6029 100644--- a/plugins/ruflo-rag-memory/README.md+++ b/plugins/ruflo-rag-memory/README.md@@ -159,9 +159,40 @@ When `ruflo-ruvector` is also loaded, rag-memory delegates to ruvector's backend- Hybrid search (sparse + dense) with RRF fusion- DiskANN for large-scale persistent indexes+## Compatibility++- **CLI:** pinned to `@claude-flow/cli` v3.6 major+minor.+- **Verification:** `bash plugins/ruflo-rag-memory/scripts/smoke.sh` is the contract.++## Namespace coordination β claude-memories consumer++This plugin is the **canonical user-facing consumer** of the `claude-memories` reserved namespace defined in [ruflo-agentdb ADR-0001 Β§"Namespace convention"](../ruflo-agentdb/docs/adrs/0001-agentdb-optimization.md). The auto-import flow:++```+Claude Code SessionStart hook+ β memory_import_claude (MCP)+ β claude-memories namespace (reserved, ruflo-agentdb owned)+ β exposed by this plugin's memory-bridge skill + memory_search_unified+```++This plugin does **not** own `claude-memories` β it consumes it. Reserved namespaces (`pattern`, `claude-memories`, `default`) MUST NOT be shadowed.++Other namespaces (`patterns`, `tasks`, `solutions`, `feedback`, `security`) are accessed via `memory_*` (namespace-routed). The plugin uses correct routing throughout β no `agentdb_hierarchical-*` or `agentdb_pattern-store` with namespace arguments.++## Verification++```bash+bash plugins/ruflo-rag-memory/scripts/smoke.sh+# Expected: "10 passed, 0 failed"+```++## Architecture Decisions++- [`ADR-0001` β ruflo-rag-memory plugin contract (claude-memories reserved-namespace consumer, smoke as contract)](./docs/adrs/0001-rag-memory-contract.md)+## Related Plugins-- `ruflo-agentdb` β Full AgentDB with 19 controllers and HNSW search+- `ruflo-agentdb` β Full AgentDB controller bridge (15 `agentdb_*` MCP tools); namespace convention owner; owns the `claude-memories` reserved namespace- `ruflo-ruvector` β Advanced vector operations (FlashAttention-3, Graph RAG, hybrid search)- `ruflo-rvf` β Portable RVF memory format for cross-machine export/import- `ruflo-knowledge-graph` β Entity extraction and graph traversal over memorydiff --git a/plugins/ruflo-rag-memory/docs/adrs/0001-rag-memory-contract.md b/plugins/ruflo-rag-memory/docs/adrs/0001-rag-memory-contract.mdnew file mode 100644index 0000000000..77ff603ce6--- /dev/null+++ b/plugins/ruflo-rag-memory/docs/adrs/0001-rag-memory-contract.md@@ -0,0 +1,40 @@+---+id: ADR-0001+title: ruflo-rag-memory plugin contract β pinning, claude-memories reserved-namespace consumer, smoke as contract+status: Proposed+date: 2026-05-04+authors:+ - reviewer (Claude Code)+tags: [plugin, rag-memory, hnsw, claude-memories, namespace, smoke-test]+---++## Context++`ruflo-rag-memory` (v0.2.0) β simple memory + HNSW semantic retrieval. 1 agent (`memory-specialist`), 2 skills (`memory-bridge`, `memory-search`), 2 commands (`/recall`, `/ruflo-memory`).++This plugin is **the canonical consumer of the `claude-memories` reserved namespace** (per [ruflo-agentdb ADR-0001](../../ruflo-agentdb/docs/adrs/0001-agentdb-optimization.md) Β§"Namespace convention"). Claude Code's `SessionStart` hook auto-imports `~/.claude/projects/*/memory/*.md` into AgentDB via `memory_import_claude` β `claude-memories`. This plugin's `memory-bridge` skill exposes that bridge to users.++## Decision++1. Add this ADR (Proposed).+2. README augment: Compatibility (pin v3.6); Namespace coordination block β explicit consumer-of-claude-memories; Verification + Architecture Decisions sections.+3. Plugin metadata stays at `0.2.0` (already at the cadence). Keywords add `mcp`, `claude-memories`, `bridged-memory`.+4. `scripts/smoke.sh` β 10 structural checks: version + keywords; both skills + agent + 2 commands with valid frontmatter; v3.6 pin; namespace coordination cross-reference; `claude-memories` reserved-namespace consumer documented; `memory_import_claude` + `memory_search_unified` referenced; ADR Proposed; no wildcard tools.++## Consequences++**Positive:** plugin joins the cadence. The "consumer of claude-memories" relationship is now contractually documented.++**Negative:** none material.++## Verification++```bash+bash plugins/ruflo-rag-memory/scripts/smoke.sh+# Expected: "10 passed, 0 failed"+```++## Related++- `plugins/ruflo-agentdb/docs/adrs/0001-agentdb-optimization.md` β owns the `claude-memories` reserved namespace and the auto-import bridge+- `plugins/ruflo-ruvector/docs/adrs/0001-pin-ruvector-0.2.25.md` β sibling substrate plugindiff --git a/plugins/ruflo-rag-memory/scripts/smoke.sh b/plugins/ruflo-rag-memory/scripts/smoke.shnew file mode 100755index 0000000000..d8b812499c--- /dev/null+++ b/plugins/ruflo-rag-memory/scripts/smoke.sh@@ -0,0 +1,84 @@+#!/usr/bin/env bash+set -u+ROOT="$(cd "$(dirname "$0")/.." && pwd)"+PASS=0+FAIL=0+step() { printf "β %s ... " "$1"; }+ok() { printf "PASS\n"; PASS=$((PASS+1)); }+bad() { printf "FAIL: %s\n" "$1"; FAIL=$((FAIL+1)); }++step "1. plugin.json declares 0.2.0 with new keywords"+v=$(grep -E '"version"' "$ROOT/.claude-plugin/plugin.json" | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1)+if [[ "$v" != "0.2.0" ]]; then bad "expected 0.2.0, got '$v'"; else+ miss=""+ for k in mcp claude-memories bridged-memory; do+ grep -q "\"$k\"" "$ROOT/.claude-plugin/plugin.json" || miss="$miss $k"+ done+ [[ -z "$miss" ]] && ok || bad "missing keywords:$miss"+fi++step "2. both skills + agent + 2 commands present with valid frontmatter"+miss=""+for s in memory-bridge memory-search; do+ f="$ROOT/skills/$s/SKILL.md"+ [[ -f "$f" ]] || { miss="$miss missing-$s"; continue; }+ for k in 'name:' 'description:'; do+ grep -q "^$k" "$f" || miss="$miss $s-no-$k"+ done+done+[[ -f "$ROOT/agents/memory-specialist.md" ]] || miss="$miss missing-agent"+[[ -f "$ROOT/commands/recall.md" ]] || miss="$miss missing-recall-cmd"+[[ -f "$ROOT/commands/ruflo-memory.md" ]] || miss="$miss missing-memory-cmd"+[[ -z "$miss" ]] && ok || bad "$miss"++step "3. README pins @claude-flow/cli to v3.6"+grep -qE "@claude-flow/cli.*v3\.6|v3\.6.*claude-flow/cli" "$ROOT/README.md" \+ && ok || bad "v3.6 pin missing"++step "4. README defers to ruflo-agentdb namespace convention"+grep -q "ruflo-agentdb" "$ROOT/README.md" \+ && grep -q "Namespace convention" "$ROOT/README.md" \+ && ok || bad "namespace coordination block incomplete"++step "5. claude-memories reserved-namespace consumer documented"+F="$ROOT/README.md"+miss=""+grep -q "claude-memories" "$F" || miss="$miss namespace-name"+grep -q "memory_import_claude" "$F" || miss="$miss import-tool"+grep -q "SessionStart" "$F" || miss="$miss session-start"+[[ -z "$miss" ]] && ok || bad "$miss"++step "6. memory_search_unified referenced (cross-namespace search)"+grep -q "memory_search_unified" "$ROOT/README.md" \+ && ok || bad "memory_search_unified not referenced"++step "7. encryption-at-rest block intact (ADR-096)"+F="$ROOT/README.md"+miss=""+grep -q "ADR-096" "$F" || miss="$miss adr-ref"+grep -q "AES-256-GCM" "$F" || miss="$miss cipher"+grep -q "RFE1" "$F" || miss="$miss magic-byte"+[[ -z "$miss" ]] && ok || bad "encryption block missing:$miss"++step "8. ADR-0001 exists with status Proposed"+ADR="$ROOT/docs/adrs/0001-rag-memory-contract.md"+[[ -f "$ADR" ]] && grep -qE "^status:[[:space:]]*Proposed" "$ADR" \+ && ok || bad "ADR missing or status != Proposed"++step "9. README does not claim '19 AgentDB controllers' (regression)"+F="$ROOT/README.md"+if grep -qE "19 AgentDB controllers|19 controllers" "$F"; then+ bad "stale '19 controllers' phrasing still present"+else+ ok+fi++step "10. no wildcard tool grants in skills"+bad_skills=""+for f in "$ROOT"/skills/*/SKILL.md; do+ grep -q '^allowed-tools:[[:space:]]*\*' "$f" && bad_skills="$bad_skills $(basename $(dirname "$f"))"+done+[[ -z "$bad_skills" ]] && ok || bad "wildcard:$bad_skills"++printf "\n%s passed, %s failed\n" "$PASS" "$FAIL"+[[ $FAIL -eq 0 ]] || exit 1