π 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
fix(ruflo-agentdb,ruflo-sparc): make the smoke claims truthful; real --live checks in agentdb (#4133)
r1e63afc3d5aa
diff --git a/plugins/ruflo-agentdb/.claude-plugin/plugin.json b/plugins/ruflo-agentdb/.claude-plugin/plugin.jsonindex 3062da9143..c83b0eaab6 100644--- a/plugins/ruflo-agentdb/.claude-plugin/plugin.json+++ b/plugins/ruflo-agentdb/.claude-plugin/plugin.json@@ -1,7 +1,7 @@{"name": "ruflo-agentdb","description": "Substrate plugin for Ruflo memory: AgentDB controller bridge (15 agentdb_* MCP tools), RuVector ONNX embeddings (10 embeddings_* tools incl. RaBitQ 32x quantization), and WASM HNSW pattern router (3 ruvllm_hnsw_* tools). As a mod (ADR-445): opt-in safe recall into the prompt, a write guard that keeps secrets out of memory, /agentdb, and a status file the console shows",- "version": "0.4.9",+ "version": "0.4.10","author": {"name": "ruvnet","url": "https://github.com/ruvnet"diff --git a/plugins/ruflo-agentdb/CHANGELOG.md b/plugins/ruflo-agentdb/CHANGELOG.mdindex 1130bb3c21..7e3f599bbc 100644--- a/plugins/ruflo-agentdb/CHANGELOG.md+++ b/plugins/ruflo-agentdb/CHANGELOG.md@@ -2,6 +2,9 @@Newest first. One `## <version> β <date>` heading per version, then `feat:`, `fix:`, `breaking:` and `chore:` bullets (ADR-478). Built from git history; older versions: `git log -- plugins/ruflo-agentdb`.+## 0.4.10 β 2026-10-14+- fix: the README no longer says the smoke script "calls each documented MCP tool": the default run is an offline structure and documentation check, and `smoke.sh --live` now really exercises the CLI in a temp directory (`agentdb_health` must report available and durable; a `agentdb_hierarchical-store` then `agentdb_hierarchical-recall` round trip must return the entry; the old L1 called a `claude-flow mcp call` command that does not exist) (#4133, thanks @ronmikailov)+## 0.4.9 β 2026-10-12- fix: the shared text screen now catches `.env` and e-mailed credentials, no longer flags a model's token talk (`--max-tokens`, `/oauth/token`, "token usage"), and no longer flags values that only name where a secret lives (`./service-account.json`, `--set-secrets=NAME=NAME:latest`); every rule stays linear (#4094, thanks @proffesor-for-testing)diff --git a/plugins/ruflo-agentdb/README.md b/plugins/ruflo-agentdb/README.mdindex 7ca9f4382a..bc10e904fa 100644--- a/plugins/ruflo-agentdb/README.md+++ b/plugins/ruflo-agentdb/README.md@@ -15,7 +15,7 @@ The substrate plugin for Ruflo memory. Wraps three CLI MCP families β `agentdb- **CLI:** pinned to `@claude-flow/cli` v3.6 major+minor. Patch bumps within v3.6 are expected to be no-op.- **AgentDB:** the CLI bundles `agentdb@^3.0.0-alpha.11`. The plugin does **not** pin the npm package β internals (alpha.11 β alpha.12 etc.) are not the plugin's contract.-- **Verification:** the bundled smoke script is the source of truth (`bash plugins/ruflo-agentdb/scripts/smoke.sh`). If smoke passes against your CLI version, the plugin's contract holds.+- **Verification:** `bash plugins/ruflo-agentdb/scripts/smoke.sh` checks the plugin's structure and documented surface offline; `--live` also exercises the real AgentDB tools. Passing the offline run does not prove the substrate works.## Features@@ -200,10 +200,10 @@ Replacement table for bridge-unavailable mode:```bashbash plugins/ruflo-agentdb/scripts/smoke.sh-# Expected: "10 passed, 0 failed"+# Expected: "0 failed" (offline checks); add --live to exercise the real tools```-The smoke script is the contract. It calls each documented MCP tool, exercises the RaBitQ workflow, and source-inspects the fallback path (no env-var gate exists to force the fallback live).+The default smoke run is an offline structure and documentation check: it greps the plugin's docs, manifest, commands and the CLI tool source, and it does not call any MCP tool, so it passes even when the AgentDB substrate is broken. `bash plugins/ruflo-agentdb/scripts/smoke.sh --live` adds a live check in a throwaway directory: `agentdb_health` must report `available` and `durable`, and a `agentdb_hierarchical-store` then `agentdb_hierarchical-recall` round trip must return the stored entry. The RaBitQ workflow and the fallback path are only source-inspected (no env-var gate exists to force the fallback live).## As a mod (0.4.7, ADR-445)diff --git a/plugins/ruflo-agentdb/scripts/smoke.sh b/plugins/ruflo-agentdb/scripts/smoke.shindex 2ff846c7b7..4c6873c79c 100755--- a/plugins/ruflo-agentdb/scripts/smoke.sh+++ b/plugins/ruflo-agentdb/scripts/smoke.sh@@ -4,9 +4,9 @@# CLI MCP surface plus three documentation invariants.## This script verifies plugin structural soundness and source-level-# contracts. Live MCP-tool exercise (against a running daemon with the-# bridge wired) is layered on top via the optional --live flag, but the-# default invocation is offline-safe and CI-friendly.+# contracts. The default invocation is offline-safe and CI-friendly and does+# NOT call any MCP tool. Pass --live to exercise the real CLI tools+# (agentdb_health durable check and a store/recall round trip) in a temp dir.set -uROOT="$(cd "$(dirname "$0")/.." && pwd)"REPO_ROOT="$(cd "$ROOT/../.." && pwd)"@@ -48,10 +48,10 @@ grep -q "## Namespace convention" "$ROOT/README.md" \&& ok || bad "Namespace convention section missing"# 1. Plugin version + new keywords-step "1. plugin.json declares version 0.4.9 with rabitq + namespace-convention keywords"+step "1. plugin.json declares version 0.4.10 with rabitq + namespace-convention keywords"v=$(grep -E '"version"[[:space:]]*:' "$ROOT/.claude-plugin/plugin.json" | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1)-if [[ "$v" != "0.4.9" ]]; then- bad "expected 0.4.9, got '$v'"+if [[ "$v" != "0.4.10" ]]; then+ bad "expected 0.4.10, got '$v'"elsemiss=""for k in rabitq quantization namespace-convention controller-bridge; do@@ -186,17 +186,32 @@ elsebad "pluralization callout missing (must contrast pattern vs patterns)"fi-# Live mode (optional, requires daemon)+# Live mode (optional): exercises the real CLI MCP tools in a throwaway project dir.+# The default run above is offline and only checks plugin structure and source/doc+# invariants; it passes even when the AgentDB substrate is broken. --live is the+# check that proves the substrate works (#4133).if [[ "$LIVE" == "1" ]]; then- step "L1 (live): agentdb_health responds (requires running daemon)"- if command -v claude-flow >/dev/null 2>&1; then- if claude-flow mcp call agentdb_health 2>/dev/null | grep -q '"available"'; then- ok- else- bad "agentdb_health did not return an 'available' field"- fi+ if command -v ruflo >/dev/null 2>&1; then RUFLO=(ruflo)+ elif command -v npx >/dev/null 2>&1; then RUFLO=(npx -y @claude-flow/cli@latest)+ else RUFLO=(); fi+ mcp_exec() { (cd "$LIVE_DIR" && "${RUFLO[@]}" mcp exec -t "$1" ${2:+-p "$2"} 2>/dev/null); }+ if [[ ${#RUFLO[@]} -eq 0 ]]; then+ step "L0 (live): ruflo CLI available"; bad "neither ruflo nor npx on PATH"else- bad "claude-flow CLI not on PATH (skipping --live checks)"+ LIVE_DIR="$(mktemp -d)"+ mkdir -p "$LIVE_DIR/.swarm"+ trap 'rm -rf "$LIVE_DIR"' EXIT++ step "L1 (live): agentdb_health reports available and durable"+ health="$(mcp_exec agentdb_health)"+ if grep -q '"available": true' <<<"$health" && grep -q '"durable": true' <<<"$health"; then ok+ else bad "agentdb_health must report available:true and durable:true (volatile fallback?)"; fi++ step "L2 (live): hierarchical store then recall round trip"+ stored="$(mcp_exec agentdb_hierarchical-store '{"key":"smoke-probe","value":"zebrafish","tier":"semantic"}')"+ recalled="$(mcp_exec agentdb_hierarchical-recall '{"query":"zebrafish","topK":3}')"+ if grep -q '"key": "smoke-probe"' <<<"$stored" && grep -q '"value": "zebrafish"' <<<"$recalled"; then ok+ else bad "stored entry did not come back from agentdb_hierarchical-recall"; fififidiff --git a/plugins/ruflo-sparc/.claude-plugin/plugin.json b/plugins/ruflo-sparc/.claude-plugin/plugin.jsonindex d3e7ad3074..9a0dc8ca40 100644--- a/plugins/ruflo-sparc/.claude-plugin/plugin.json+++ b/plugins/ruflo-sparc/.claude-plugin/plugin.json@@ -1,7 +1,7 @@{"name": "ruflo-sparc","description": "SPARC methodology β Specification, Pseudocode, Architecture, Refinement, Completion phases with gate checks",- "version": "0.3.6",+ "version": "0.3.7","author": {"name": "ruvnet","url": "https://github.com/ruvnet"diff --git a/plugins/ruflo-sparc/.codex-plugin/plugin.json b/plugins/ruflo-sparc/.codex-plugin/plugin.jsonindex 371423674f..fc3b351300 100644--- a/plugins/ruflo-sparc/.codex-plugin/plugin.json+++ b/plugins/ruflo-sparc/.codex-plugin/plugin.json@@ -1,7 +1,7 @@{"name": "ruflo-sparc","description": "SPARC methodology \u2014 Specification, Pseudocode, Architecture, Refinement, Completion phases with gate checks",- "version": "0.3.6",+ "version": "0.3.7","author": {"name": "ruvnet","url": "https://github.com/ruvnet"diff --git a/plugins/ruflo-sparc/CHANGELOG.md b/plugins/ruflo-sparc/CHANGELOG.mdindex 9e8977a563..fcdf124cae 100644--- a/plugins/ruflo-sparc/CHANGELOG.md+++ b/plugins/ruflo-sparc/CHANGELOG.md@@ -2,6 +2,9 @@Newest first. One `## <version> β <date>` heading per version, then `feat:`, `fix:`, `breaking:` and `chore:` bullets (ADR-478). Built from git history; this is the whole history.+## 0.3.7 β 2026-10-14+- fix: the README says plainly that `smoke.sh` is an offline structure and documentation check that calls no MCP tool and runs no workflow, not a contract proving the workflow works (#4133, thanks @ronmikailov)+## 0.3.6 β 2026-10-12- fix: the shared text screen now catches `.env` and e-mailed credentials, no longer flags a model's token talk (`--max-tokens`, `/oauth/token`, "token usage"), and no longer flags values that only name where a secret lives (`./service-account.json`, `--set-secrets=NAME=NAME:latest`); every rule stays linear (#4094, thanks @proffesor-for-testing)diff --git a/plugins/ruflo-sparc/README.md b/plugins/ruflo-sparc/README.mdindex 23bf52f620..e374217872 100644--- a/plugins/ruflo-sparc/README.md+++ b/plugins/ruflo-sparc/README.md@@ -58,7 +58,7 @@ claude --plugin-dir plugins/ruflo-sparc## Compatibility- **CLI:** pinned to `@claude-flow/cli` v3.6 major+minor.-- **Verification:** `bash plugins/ruflo-sparc/scripts/smoke.sh` is the contract.+- **Verification:** `bash plugins/ruflo-sparc/scripts/smoke.sh` is an offline structure and documentation check (manifest, commands, skills, agent and command-name references). It does not call any MCP tool or run a SPARC workflow, so a pass does not prove the workflow state machine works.## Phase-to-plugin alignmentdiff --git a/plugins/ruflo-sparc/scripts/smoke.sh b/plugins/ruflo-sparc/scripts/smoke.shindex c5b0276d67..d3f4df4755 100755--- a/plugins/ruflo-sparc/scripts/smoke.sh+++ b/plugins/ruflo-sparc/scripts/smoke.sh@@ -7,9 +7,9 @@ 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.3.6 with new keywords"+step "1. plugin.json declares 0.3.7 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.3.6" ]]; then bad "expected 0.3.6, got '$v'"; else+if [[ "$v" != "0.3.7" ]]; then bad "expected 0.3.7, got '$v'"; elsemiss=""for k in mcp phase-gates quality-gates; dogrep -q "\"$k\"" "$ROOT/.claude-plugin/plugin.json" || miss="$miss $k"