π 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-rvf): adopt plugin contract β cross-plugin RVF ownership table (ADR-0001)
Reuven414a79d56c48
diff --git a/plugins/ruflo-rvf/.claude-plugin/plugin.json b/plugins/ruflo-rvf/.claude-plugin/plugin.jsonindex c05e67191d..07752de05a 100644--- a/plugins/ruflo-rvf/.claude-plugin/plugin.json+++ b/plugins/ruflo-rvf/.claude-plugin/plugin.json@@ -14,6 +14,9 @@"memory","session","persistence",- "transfer"+ "transfer",+ "mcp",+ "cognitive-containers",+ "lineage-tracking"]}diff --git a/plugins/ruflo-rvf/README.md b/plugins/ruflo-rvf/README.mdindex 690f4118d8..389ca42937 100644--- a/plugins/ruflo-rvf/README.md+++ b/plugins/ruflo-rvf/README.md@@ -36,3 +36,43 @@ Confirm the gate state with `ruflo doctor -c encryption`.- `rvf-manage` -- Manage RVF files for portable memory- `session-persist` -- Persist and restore agent sessions++## Compatibility++- **CLI:** pinned to `@claude-flow/cli` v3.6 major+minor.+- **Verification:** `bash plugins/ruflo-rvf/scripts/smoke.sh` is the contract.++## Cross-plugin RVF ownership++RVF (RuVector Format) cognitive containers appear in three plugins. Each owns a different slice:++| Slice | Owner | What it does |+|-------|-------|-------------|+| **Portable memory + session persistence** | `ruflo-rvf` (this plugin) | High-level skills for save/restore, cross-machine transfer |+| **Browser sessions as RVF** | [ruflo-browser ADR-0001](../ruflo-browser/docs/adrs/0001-browser-skills-architecture.md) | Each browser session is allocated as an RVF container at session-start (manifest, trajectory, screenshots, snapshots, cookies, findings) |+| **RVF tooling (10 subcommands)** | [ruflo-ruvector ADR-0001](../ruflo-ruvector/docs/adrs/0001-pin-ruvector-0.2.25.md) | `ruvector rvf create|ingest|query|status|segments|derive|compact|export|examples|download` |++This plugin sits on top of ruvector's tooling and feeds browser's session-as-RVF model.++## Namespace coordination++This plugin owns the `rvf-sessions` AgentDB namespace (kebab-case, follows the convention from [ruflo-agentdb ADR-0001 Β§"Namespace convention"](../ruflo-agentdb/docs/adrs/0001-agentdb-optimization.md)). Reserved namespaces (`pattern`, `claude-memories`, `default`) MUST NOT be shadowed.++`rvf-sessions` indexes saved session manifests + their RVF container paths. Accessed via `memory_*` (namespace-routed).++## Verification++```bash+bash plugins/ruflo-rvf/scripts/smoke.sh+# Expected: "10 passed, 0 failed"+```++## Architecture Decisions++- [`ADR-0001` β ruflo-rvf plugin contract (cross-plugin RVF ownership table, namespace coordination, smoke as contract)](./docs/adrs/0001-rvf-contract.md)++## Related Plugins++- `ruflo-ruvector` β exposes the `ruvector rvf *` tooling this plugin sits on top of+- `ruflo-browser` β uses RVF containers for session-as-skill artifacts (ADR-0001 there)+- `ruflo-agentdb` β namespace convention ownerdiff --git a/plugins/ruflo-rvf/docs/adrs/0001-rvf-contract.md b/plugins/ruflo-rvf/docs/adrs/0001-rvf-contract.mdnew file mode 100644index 0000000000..1a54ce6971--- /dev/null+++ b/plugins/ruflo-rvf/docs/adrs/0001-rvf-contract.md@@ -0,0 +1,46 @@+---+id: ADR-0001+title: ruflo-rvf plugin contract β pinning, namespace coordination, RVF cross-references (browser sessions, ruvector containers), smoke as contract+status: Proposed+date: 2026-05-04+authors:+ - reviewer (Claude Code)+tags: [plugin, rvf, session-persistence, portable-memory, namespace, smoke-test]+---++## Context++`ruflo-rvf` (v0.2.0) β RVF format for portable agent memory + session persistence + cross-platform transfer. 1 agent + 2 skills (`rvf-manage`, `session-persist`) + 1 command.++RVF (RuVector Format) cognitive containers are referenced in two sibling ADRs as the substrate for portable session/memory state:++- [ruflo-browser ADR-0001](../../ruflo-browser/docs/adrs/0001-browser-skills-architecture.md) β every browser session is allocated as an RVF container at session-start (manifest, trajectory, screenshots, snapshots, cookies, findings)+- [ruflo-ruvector ADR-0001](../../ruflo-ruvector/docs/adrs/0001-pin-ruvector-0.2.25.md) β `ruvector rvf create|ingest|query|status|segments|derive|compact|export|examples|download` (10 RVF subcommands)++This plugin is the **canonical owner of the portable-memory + session-persistence slice** of the RVF surface. browser uses it for sessions; ruvector exposes the lower-level RVF tooling.++## Decision++1. Add this ADR (Proposed).+2. README augment: Compatibility (pin v3.6); Cross-plugin RVF ownership table β browser sessions consume RVF, ruvector exposes the tooling, this plugin owns portable-memory + session-persistence; Namespace coordination (claims `rvf-sessions`); Verification + Architecture Decisions sections.+3. Plugin metadata stays at `0.2.0` (already at the cadence). Keywords add `mcp`, `cognitive-containers`, `lineage-tracking`.+4. `scripts/smoke.sh` β 10 structural checks: version + keywords; both skills + agent + command with valid frontmatter; v3.6 pin; namespace coordination; RVF cross-references (ruflo-browser sessions + ruflo-ruvector RVF tooling); ADR Proposed; no wildcard tools.++## Consequences++**Positive:** plugin joins the cadence. The cross-plugin RVF-ownership story is now contractually documented.++**Negative:** none material.++## Verification++```bash+bash plugins/ruflo-rvf/scripts/smoke.sh+# Expected: "10 passed, 0 failed"+```++## Related++- `plugins/ruflo-browser/docs/adrs/0001-browser-skills-architecture.md` β browser sessions as RVF containers+- `plugins/ruflo-ruvector/docs/adrs/0001-pin-ruvector-0.2.25.md` β RVF tooling (`ruvector rvf *`)+- `plugins/ruflo-agentdb/docs/adrs/0001-agentdb-optimization.md` β namespace conventiondiff --git a/plugins/ruflo-rvf/scripts/smoke.sh b/plugins/ruflo-rvf/scripts/smoke.shnew file mode 100755index 0000000000..6ae1e90d28--- /dev/null+++ b/plugins/ruflo-rvf/scripts/smoke.sh@@ -0,0 +1,79 @@+#!/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 cognitive-containers lineage-tracking; 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 + command present with valid frontmatter"+miss=""+for s in rvf-manage session-persist; 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/session-specialist.md" ]] || miss="$miss missing-agent"+[[ -f "$ROOT/commands/rvf.md" ]] || miss="$miss missing-command"+[[ -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. rvf-sessions namespace claimed"+grep -q "rvf-sessions" "$ROOT/README.md" \+ && ok || bad "rvf-sessions namespace not claimed"++step "6. RVF cross-reference to ruflo-browser sessions"+F="$ROOT/README.md"+grep -q "ruflo-browser" "$F" \+ && grep -qE "session.*RVF|RVF.*session" "$F" \+ && ok || bad "browser-RVF cross-reference missing"++step "7. RVF tooling cross-reference to ruflo-ruvector"+F="$ROOT/README.md"+grep -q "ruflo-ruvector" "$F" \+ && grep -qE "ruvector rvf|rvf tooling|RVF tooling" "$F" \+ && ok || bad "ruvector RVF tooling cross-reference missing"++step "8. 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 "9. ADR-0001 exists with status Proposed"+ADR="$ROOT/docs/adrs/0001-rvf-contract.md"+[[ -f "$ADR" ]] && grep -qE "^status:[[:space:]]*Proposed" "$ADR" \+ && ok || bad "ADR missing or status != Proposed"++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