π 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
chore(release): 3.55.0 versions, leaf pins, lockfiles, plugin bumps, changelog
ruvb02e2247dcac
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 389e649c82..717c76de3f 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -7,9 +7,37 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0## [Unreleased]+## [3.55.0] - 2026-10-07++Minor release. Contains a security behaviour change: `ruflo mcp start -t http` on a non-loopback host now refuses to start without a token (see Security and Breaking changes).+### Security-- **Hive-mind gating that keeps local users working (ADR-476, #3338)** β `hive-mind_init` no longer returns `hiveToken`, and `spawn`, `consensus` `propose`, `broadcast`, `shutdown`, `memory` `set`/`delete` and `optimize-memory` (plus the existing `join`/`leave`/`vote`) now require an operator credential from **remote** callers (HTTP/WebSocket MCP). Local stdio MCP, `ruflo mcp exec`, the `hive-mind` CLI and in-process callers need no credential and no extra step. Remote clients set `RUFLO_HIVE_BOOTSTRAP_SECRET` (or read `.claude-flow/hive-mind/bootstrap.secret`, created 0600 by the first local `hive-mind init`) and send it as `bootstrapSecret`; `RUFLO_HIVE_REQUIRE_AUTH=1` applies the same rule to stdio on bridged servers. `state.json` is now written 0600 atomically and the hive directory 0700. Migration: clients that read `hiveToken` from the `init` response must drop that (it is `undefined`); over stdio they omit it everywhere. This is a speed bump, not a boundary, against a local prompt-injected agent that can read the files.+- **MCP HTTP transport: refuse unauthenticated non-loopback binds, optional bearer-token auth (#3598, #3599)** β `ruflo mcp start -t http --host 0.0.0.0` (or any non-loopback host) now exits 1 unless a token is set (`RUFLO_MCP_HTTP_TOKEN`, `--auth-token-file`, `--auth-token`) or the operator opts out with `RUFLO_MCP_ALLOW_UNAUTHENTICATED_HTTP=1`. With a token, `/rpc`, `/mcp` and `/info` need `Authorization: Bearer <token>` (constant-time compare); `/health` stays public and minimal. Also fixes a fail-open in `@claude-flow/mcp` where auth enabled with an empty token list accepted any bearer value. **Not closed:** loopback with no token is still unauthenticated (any local process can call every tool, and DNS rebinding is not blocked because there is no `Host` allow-list); set a token whenever the HTTP transport is used. A valid token grants every tool (no per-tool authorization).+- **Hive-mind gating that keeps local users working (ADR-476, #3338, #3339)** β `hive-mind_init` no longer returns `hiveToken`, and `spawn`, `consensus` `propose`, `broadcast`, `shutdown`, `memory` `set`/`delete` and `optimize-memory` (plus the existing `join`/`leave`/`vote`) now require an operator credential from **remote** callers (HTTP/WebSocket MCP). Local stdio MCP, `ruflo mcp exec`, the `hive-mind` CLI and in-process callers need no credential and no extra step. Remote clients set `RUFLO_HIVE_BOOTSTRAP_SECRET` (or read `.claude-flow/hive-mind/bootstrap.secret`, created 0600 by the first local `hive-mind init`) and send it as `bootstrapSecret`; `RUFLO_HIVE_REQUIRE_AUTH=1` applies the same rule to stdio on bridged servers. `state.json` is now written 0600 atomically and the hive directory 0700. Migration: clients that read `hiveToken` from the `init` response must drop that (it is `undefined`); over stdio they omit it everywhere. This is a speed bump, not a boundary, against a local prompt-injected agent that can read the files.+- **Policy ledger anchor can no longer be deleted and silently re-established (#3602, #3886, ADR-475)** β `policy verify` no longer trusts an anchor stored only in `state.json`. A second, hash-chained anchor log plus a mirror under `~/.config/ruflo/policy-trust/` now detect truncation, and `policy verify --establish-anchor` (interactive TTY only) is the logged repair path. Limit: this does not defend against an attacker who can rewrite both the project directory and `~/.config/ruflo`; stronger evidence needs an external witness. A pre-#3568 ledger with receipts and no anchor now fails policy transactions with `policy-ledger-anchor-missing` until repaired. Ships in `@claude-flow/security` 3.0.2.++### Fixed++- **Resilience batch (#3885; fixes #3676 #3674 #3668 #3670 #3682 #3672 #3593 #3592; thanks @rudycelekli)** β `@claude-flow/shared` 3.0.2: event-store pagination, bulkhead sync-throw handling, retry timeout cleanup, connection-pool reservation (also in `@claude-flow/mcp`); cli: production retry on non-Error rejections, worker-queue terminal outcomes and cancelled head, bounded worker pool with an already-aborted input.+- **`@claude-flow/memory` 3.0.1 β `mmrRerank()` caches embedding-cosine max-similarity across rounds (#3516, #3517)**.+- **`@claude-flow/swarm` 3.0.1** β Byzantine quorums now intersect for every cluster size (#3560, #3587, @rudycelekli); `spawnAgent()` auto-domain branch registers the agent in its pool (#3538, #3539); `MessageBus` is event-driven instead of a 10 ms unconditional poll (#3563).+- **`@claude-flow/plugin-agent-federation` 1.0.1** β outbound sends are authorized with the peer's current trust, not a stale snapshot (#3561, #3588, @rudycelekli).+- **CLI string options keep their declared value (#3594, #3601)**, **config cache is isolated per project directory (#3590, #3591)**, **nested config defaults are cloned (#3595, #3600)** β all @rudycelekli.+- **Hive consensus commands fail when the hive rejects the operation (#3609, #3654, @rudycelekli)**.+- **`daemon start --workers` selection reaches the WorkerDaemon (#3547, #3875)**.+- **Plugins run the installed ruflo CLI before `npx @claude-flow/cli@latest` (#3558, #3559, @HF-teamdev)** β ruflo-cost-tracker 0.27.2, ruflo-adr 0.5.4, ruflo-metaharness 0.2.4, ruflo-goals 0.4.3.+- **ruflo-adr edge keys use a separator the memory validator accepts (#3633, #3636, @drakeo338)**.+- ruflo-console 0.36.1: Settings lists Claude control and spending first (#3887).++### Breaking changes++- Binding the MCP HTTP transport off loopback (for example Docker with `--host 0.0.0.0`) now requires `RUFLO_MCP_HTTP_TOKEN` (and clients must send the header) or `RUFLO_MCP_ALLOW_UNAUTHENTICATED_HTTP=1`; otherwise `mcp start` exits with an error. Loopback users are unaffected.+- `hive-mind_init` no longer returns `hiveToken` (ADR-476).++### Leaf packages published with this release++`@claude-flow/shared` 3.0.2, `@claude-flow/memory` 3.0.1, `@claude-flow/swarm` 3.0.1, `@claude-flow/security` 3.0.2, `@claude-flow/mcp` 3.1.0, `@claude-flow/plugin-agent-federation` 1.0.1.## [3.34.0] - 2026-07-31diff --git a/package-lock.json b/package-lock.jsonindex 29ccf40490..fab53289fc 100644--- a/package-lock.json+++ b/package-lock.json@@ -1,12 +1,12 @@{"name": "claude-flow",- "version": "3.54.1",+ "version": "3.55.0","lockfileVersion": 3,"requires": true,"packages": {"": {"name": "claude-flow",- "version": "3.54.1",+ "version": "3.55.0","bundleDependencies": ["@claude-flow/codex","@claude-flow/mcp",@@ -23,11 +23,11 @@"dependencies": {"@claude-flow/cli-core": "3.7.0","@claude-flow/codex": "3.0.3",- "@claude-flow/mcp": "3.0.0",+ "@claude-flow/mcp": "3.1.0","@claude-flow/neural": "3.0.0",- "@claude-flow/plugin-agent-federation": "1.0.0",- "@claude-flow/security": "3.0.1",- "@claude-flow/shared": "3.0.1",+ "@claude-flow/plugin-agent-federation": "1.0.1",+ "@claude-flow/security": "3.0.2",+ "@claude-flow/shared": "3.0.2","@iarna/toml": "^2.2.5","@noble/ed25519": "2.3.0","@ruvector/rabitq-wasm": "0.1.0",@@ -229,9 +229,9 @@"link": true},"node_modules/@claude-flow/shared": {- "version": "3.0.1",- "resolved": "https://registry.npmjs.org/@claude-flow/shared/-/shared-3.0.1.tgz",- "integrity": "sha512-hu+SmX62jOYX8tTBUIRpIuQUMqhb6dE/ucVjAehyVwDguZOlgS2drDnmiazjmxXaLvv2bhP8oqzDgbKhpVlepQ==",+ "version": "3.0.2",+ "resolved": "https://registry.npmjs.org/@claude-flow/shared/-/shared-3.0.2.tgz",+ "integrity": "sha512-hgCCl94IE5Y9TL67P2NE+yliKmYlfIgYRGiPtHutGqFbksiieLKshmYLyXn260FWNODQjgo1XDV5aVASyBd2Qw==","dependencies": {"sql.js": "^1.10.3"}diff --git a/package.json b/package.jsonindex 7ef390df98..29abb1a73c 100644--- a/package.json+++ b/package.json@@ -1,6 +1,6 @@{"name": "claude-flow",- "version": "3.54.1",+ "version": "3.55.0","workspaces": ["v3/@claude-flow/codex","v3/@claude-flow/mcp",@@ -68,11 +68,11 @@"dependencies": {"@claude-flow/cli-core": "3.7.0","@claude-flow/codex": "3.0.3",- "@claude-flow/mcp": "3.0.0",+ "@claude-flow/mcp": "3.1.0","@claude-flow/neural": "3.0.0",- "@claude-flow/plugin-agent-federation": "1.0.0",- "@claude-flow/security": "3.0.1",- "@claude-flow/shared": "3.0.1",+ "@claude-flow/plugin-agent-federation": "1.0.1",+ "@claude-flow/security": "3.0.2",+ "@claude-flow/shared": "3.0.2","@iarna/toml": "^2.2.5","@noble/ed25519": "2.3.0","@ruvector/rabitq-wasm": "0.1.0",diff --git a/plugins/ruflo-adr/.claude-plugin/plugin.json b/plugins/ruflo-adr/.claude-plugin/plugin.jsonindex 3dee43f089..4697044c33 100644--- a/plugins/ruflo-adr/.claude-plugin/plugin.json+++ b/plugins/ruflo-adr/.claude-plugin/plugin.json@@ -1,7 +1,7 @@{"name": "ruflo-adr","description": "ADR lifecycle management β create, index, reconcile, supersede, check compliance, and link Architecture Decision Records to code via AgentDB hierarchical store + causal edges (supersedes/amends/depends-on/related)",- "version": "0.5.3",+ "version": "0.5.4","author": {"name": "ruvnet","url": "https://github.com/ruvnet"diff --git a/plugins/ruflo-adr/scripts/smoke.sh b/plugins/ruflo-adr/scripts/smoke.shindex 234807471c..bbab8f917a 100755--- a/plugins/ruflo-adr/scripts/smoke.sh+++ b/plugins/ruflo-adr/scripts/smoke.sh@@ -1,5 +1,5 @@#!/usr/bin/env bash-# Structural smoke test for ruflo-adr v0.5.3 (ADR-0001, ADR-0002).+# Structural smoke test for ruflo-adr v0.5.4 (ADR-0001, ADR-0002).set -uROOT="$(cd "$(dirname "$0")/.." && pwd)"PASS=0@@ -9,10 +9,10 @@ ok() { printf "PASS\n"; PASS=$((PASS+1)); }bad() { printf "FAIL: %s\n" "$1"; FAIL=$((FAIL+1)); }# 1. plugin.json bump + new keywords-step "1. plugin.json declares 0.5.3 with new keywords"+step "1. plugin.json declares 0.5.4 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.5.3" ]]; then- bad "expected 0.5.3, got '$v'"+if [[ "$v" != "0.5.4" ]]; then+ bad "expected 0.5.4, got '$v'"elsemiss=""for k in lifecycle compliance causal-graph mcp; dodiff --git a/plugins/ruflo-cost-tracker/.claude-plugin/plugin.json b/plugins/ruflo-cost-tracker/.claude-plugin/plugin.jsonindex a70d367c25..6b48dadba1 100644--- a/plugins/ruflo-cost-tracker/.claude-plugin/plugin.json+++ b/plugins/ruflo-cost-tracker/.claude-plugin/plugin.json@@ -1,7 +1,7 @@{"name": "ruflo-cost-tracker","description": "Token usage tracking, model cost attribution per agent, budget alerts, and optimization recommendations β uses memory_* (namespace-routed) for cost-tracking and cost-patterns; pairs with federation budget circuit breaker (ADR-097)",- "version": "0.27.1",+ "version": "0.27.2","author": {"name": "ruvnet","url": "https://github.com/ruvnet"diff --git a/plugins/ruflo-cost-tracker/scripts/smoke.sh b/plugins/ruflo-cost-tracker/scripts/smoke.shindex e801060ba8..8e8fdfe30e 100755--- a/plugins/ruflo-cost-tracker/scripts/smoke.sh+++ b/plugins/ruflo-cost-tracker/scripts/smoke.sh@@ -1,5 +1,5 @@#!/usr/bin/env bash-# Structural smoke test for ruflo-cost-tracker v0.27.1.+# Structural smoke test for ruflo-cost-tracker v0.27.2.set -uROOT="$(cd "$(dirname "$0")/.." && pwd)"PASS=0@@ -8,10 +8,10 @@ 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.27.1 with new keywords"+step "1. plugin.json declares 0.27.2 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.27.1" ]]; then- bad "expected 0.27.1, got '$v'"+if [[ "$v" != "0.27.2" ]]; then+ bad "expected 0.27.2, got '$v'"elsemiss=""for k in namespace-routing mcp agentic-flow agent-booster tier1-routing model-routing benchmarking verified telemetry budget projection forecast counterfactual drift-detection trend-alert anomaly-detection outlier-detection health-check composite-gate auto-track stop-hook snapshot-diff pr-regression git-context traceability drill-down per-message; dodiff --git a/plugins/ruflo-goals/.claude-plugin/plugin.json b/plugins/ruflo-goals/.claude-plugin/plugin.jsonindex 7ca614d15c..7208fd5e2e 100644--- a/plugins/ruflo-goals/.claude-plugin/plugin.json+++ b/plugins/ruflo-goals/.claude-plugin/plugin.json@@ -1,7 +1,7 @@{"name": "ruflo-goals","description": "Long-horizon goal planning, deep research orchestration, and adaptive replanning using GOAP algorithms",- "version": "0.4.2",+ "version": "0.4.3","author": {"name": "ruvnet","url": "https://github.com/ruvnet"diff --git a/plugins/ruflo-goals/README.md b/plugins/ruflo-goals/README.mdindex 3feac87b92..ca769b7663 100644--- a/plugins/ruflo-goals/README.md+++ b/plugins/ruflo-goals/README.md@@ -96,7 +96,7 @@ bash plugins/ruflo-goals/scripts/smoke.sh# Expected: "12 passed, 0 failed"```-## As a mod (0.4.2)+## As a mod (0.4.3)A function-hook mod ships beside the skills (ADR-445 pattern). Needs a Claude Code with mods (2.1.287+); older builds ignore it. No network, no process spawning: it only tightens calls to this plugin's own tools and reads through tools already connected.diff --git a/plugins/ruflo-goals/scripts/smoke.sh b/plugins/ruflo-goals/scripts/smoke.shindex f777fddc84..fcf923779f 100755--- a/plugins/ruflo-goals/scripts/smoke.sh+++ b/plugins/ruflo-goals/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.4.2 with new keywords"+step "1. plugin.json declares 0.4.3 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.4.2" ]]; then bad "expected 0.4.2, got '$v'"; else+if [[ "$v" != "0.4.3" ]]; then bad "expected 0.4.3, got '$v'"; elsemiss=""for k in mcp evidence-grading legacy-namespaces; dogrep -q "\"$k\"" "$ROOT/.claude-plugin/plugin.json" || miss="$miss $k"diff --git a/plugins/ruflo-metaharness/.claude-plugin/plugin.json b/plugins/ruflo-metaharness/.claude-plugin/plugin.jsonindex 047131bbe2..51fdc7fa4b 100644--- a/plugins/ruflo-metaharness/.claude-plugin/plugin.json+++ b/plugins/ruflo-metaharness/.claude-plugin/plugin.json@@ -1,7 +1,7 @@{"name": "ruflo-metaharness","description": "MetaHarness integration for ruflo β surfaces score/genome/mint/mcp-scan/threat-model via skills; pairs with @metaharness/router (ADR-148/149) for cost-optimal model routing; honors ADR-150's architectural constraint that MetaHarness remains an optional augmentation, never a required runtime dependency. As a mod (ADR-445): confirms flywheel promotion, keeps secrets out of inputs, /metaharness-mod, and a status file the console shows",- "version": "0.2.3",+ "version": "0.2.4","author": {"name": "ruvnet","url": "https://github.com/ruvnet"diff --git a/plugins/ruflo-metaharness/scripts/smoke.sh b/plugins/ruflo-metaharness/scripts/smoke.shindex 7bbdc9227b..64eda20087 100755--- a/plugins/ruflo-metaharness/scripts/smoke.sh+++ b/plugins/ruflo-metaharness/scripts/smoke.sh@@ -1,5 +1,5 @@#!/usr/bin/env bash-# Structural smoke test for ruflo-metaharness v0.2.3 (ADR-150 Phase 1).+# Structural smoke test for ruflo-metaharness v0.2.4 (ADR-150 Phase 1).set -uROOT="$(cd "$(dirname "$0")/.." && pwd)"PASS=0@@ -32,10 +32,10 @@ elsebad "extraction-regex-rot: EXPECTED_TOOLS=$EXPECTED_TOOLS EXPECTED_SUBS=$EXPECTED_SUBS"fi-step "1. plugin.json declares 0.2.3 with adr-150 keywords"+step "1. plugin.json declares 0.2.4 with adr-150 keywords"v=$(grep -E '"version"' "$ROOT/.claude-plugin/plugin.json" | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1)-if [[ "$v" != "0.2.3" ]]; then- bad "expected 0.2.3, got '$v'"+if [[ "$v" != "0.2.4" ]]; then+ bad "expected 0.2.4, got '$v'"elsemiss=""for k in ruflo metaharness harness scorecard genome mcp-scan threat-model router adr-150 adr-148 adr-149 optional-dependency graceful-degradation subprocess phase-1-mvp; dodiff --git a/ruflo/package.json b/ruflo/package.jsonindex bd5d00fc64..cb35040eb8 100644--- a/ruflo/package.json+++ b/ruflo/package.json@@ -1,6 +1,6 @@{"name": "ruflo",- "version": "3.54.1",+ "version": "3.55.0","description": "Ruflo - Enterprise AI agent orchestration platform. Deploy 60+ specialized agents in coordinated swarms with self-learning, fault-tolerant consensus, vector memory, and MCP integration","main": "bin/ruflo.js","type": "module",@@ -40,7 +40,7 @@"package:rvf": "bash src/scripts/package-rvf.sh"},"dependencies": {- "@claude-flow/cli": "^3.54.1"+ "@claude-flow/cli": "^3.55.0"},"optionalDependencies": {},"overrides": {diff --git a/v3/@claude-flow/cli/package.json b/v3/@claude-flow/cli/package.jsonindex 5d9ddbdec8..c75120fe0b 100644--- a/v3/@claude-flow/cli/package.json+++ b/v3/@claude-flow/cli/package.json@@ -1,6 +1,6 @@{"name": "@claude-flow/cli",- "version": "3.54.1",+ "version": "3.55.0","type": "module","description": "Ruflo CLI - Enterprise AI agent orchestration with 60+ specialized agents, swarm coordination, MCP server, self-learning hooks, and vector memory for Claude Code","main": "dist/src/index.js",@@ -100,11 +100,11 @@"dependencies": {"@claude-flow/cli-core": "3.7.0","@claude-flow/codex": "3.0.3",- "@claude-flow/mcp": "3.0.0",+ "@claude-flow/mcp": "3.1.0","@claude-flow/neural": "3.0.0",- "@claude-flow/plugin-agent-federation": "1.0.0",- "@claude-flow/security": "3.0.1",- "@claude-flow/shared": "3.0.1",+ "@claude-flow/plugin-agent-federation": "1.0.1",+ "@claude-flow/security": "3.0.2",+ "@claude-flow/shared": "3.0.2","@iarna/toml": "^2.2.5","@noble/ed25519": "2.3.0","@ruvector/rabitq-wasm": "0.1.0",@@ -125,11 +125,11 @@"ws": "^8.21.0","yaml": "^2.8.0","zod": "^3.22.0",- "@claude-flow/memory": "3.0.0"+ "@claude-flow/memory": "3.0.1"},"optionalDependencies": {"@agntcy/slim-bindings": "2.0.0-alpha.5",- "@claude-flow/memory": "3.0.0",+ "@claude-flow/memory": "3.0.1","@metaharness/darwin": "~0.10.2","@metaharness/flywheel": "~0.1.10","@metaharness/radio": "~0.1.0",diff --git a/v3/pnpm-lock.yaml b/v3/pnpm-lock.yamlindex d55955564e..b4401e1af1 100644--- a/v3/pnpm-lock.yaml+++ b/v3/pnpm-lock.yaml@@ -121,19 +121,19 @@ importers:specifier: 3.0.3version: link:../codex'@claude-flow/mcp':- specifier: 3.0.0+ specifier: 3.1.0version: link:../mcp'@claude-flow/neural':specifier: 3.0.0version: link:../neural'@claude-flow/plugin-agent-federation':- specifier: 1.0.0+ specifier: 1.0.1version: link:../plugin-agent-federation'@claude-flow/security':- specifier: 3.0.1+ specifier: 3.0.2version: link:../security'@claude-flow/shared':- specifier: 3.0.1+ specifier: 3.0.2version: link:../shared'@iarna/toml':specifier: ^2.2.5@@ -209,7 +209,7 @@ importers:specifier: 2.0.0-alpha.5version: 2.0.0-alpha.5'@claude-flow/memory':- specifier: 3.0.0+ specifier: 3.0.1version: link:../memory'@metaharness/darwin':specifier: ~0.10.2