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

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.json
index 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.md
index 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.md
index 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:
```bash
bash 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.sh
index 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 -u
ROOT="$(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'"
else
miss=""
for k in rabitq quantization namespace-convention controller-bridge; do
@@ -186,17 +186,32 @@ else
bad "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"; fi
fi
fi
diff --git a/plugins/ruflo-sparc/.claude-plugin/plugin.json b/plugins/ruflo-sparc/.claude-plugin/plugin.json
index 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.json
index 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.md
index 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.md
index 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 alignment
diff --git a/plugins/ruflo-sparc/scripts/smoke.sh b/plugins/ruflo-sparc/scripts/smoke.sh
index 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'"; else
miss=""
for k in mcp phase-gates quality-gates; do
grep -q "\"$k\"" "$ROOT/.claude-plugin/plugin.json" || miss="$miss $k"