v3.55.0
ruvnet/ruflov3.55.0Oct 7, 2026by ruvnet
Upgrading?
AI Summary
Security release adding MCP HTTP auth gate, hive gating, and policy ledger anchor.
Key Highlights
- MCP HTTP auth gate (requires token for non-loopback hosts)
- Hive-mind gating (remote callers need credentials for specific actions)
- Policy ledger anchor (hash-chained log for verification)
- Fixes for Byzantine quorums and federation peer dispatch
Breaking Changes
- Off-loopback MCP HTTP binds require a token or opt-out
- hive-mind_init no longer returns hiveToken
New Features
- MCP HTTP authentication with Bearer token
- Hive-mind access control for remote callers
- Policy ledger verification anchor
- Shared resilience batch fixes
- CLI config cache isolation
Full Release Notes
## Ruflo 3.55.0 Minor release. It contains one security behaviour change that can break existing setups: **`ruflo mcp start -t http` on a non-loopback host now refuses to start without a token.** ### Security - **MCP HTTP transport (#3598, #3599).** Binding off loopback (`--host 0.0.0.0`, a LAN IP, `::`) now exits 1 unless `RUFLO_MCP_HTTP_TOKEN` / `--auth-token-file` / `--auth-token` is set, or you opt out with `RUFLO_MCP_ALLOW_UNAUTHENTICATED_HTTP=1`. With a token, `/rpc`, `/mcp` and `/info` require `Authorization: Bearer <token>` (constant-time compare); `/health` stays public and minimal. Also fixes a fail-open in `@claude-flow/mcp` 3.1.0 where auth enabled with an empty token list accepted any bearer value. **What is not fixed:** loopback with no token is still unauthenticated. Any local process can call every tool, and DNS rebinding is not blocked (no `Host` allow-list). Set a token whenever you use the HTTP transport. A valid token grants every tool; there is no per-tool authorization. - **Hive-mind gating (#3338, #3339, ADR-476).** Remote (HTTP/WebSocket) callers now need an operator credential for `spawn`, `consensus propose`, `broadcast`, `shutdown`, `memory set/delete` and `optimize-memory`. Local stdio/CLI users need nothing. `hive-mind_init` no longer returns `hiveToken`. For a local caller this is a speed bump, not a boundary: a prompt-injected agent that can read `.claude-flow/hive-mind/` can read the secret. - **Policy ledger anchor (#3602, #3886, ADR-475).** Deleting the anchor fields in `state.json` and truncating receipts no longer verifies as valid. A hash-chained anchor log plus a mirror under `~/.config/ruflo/policy-trust/` now detect it. `ruflo policy verify --establish-anchor` (interactive TTY only) is the logged repair path. **Limit:** an attacker who can rewrite both the project directory and `~/.config/ruflo` can still delete every anchor and receipt or forge a coherent log; stronger evidence needs an external witness. A pre-#3568 ledger with receipts and no anchor now fails policy transactions until you run `policy verify --establish-anchor`. ### Fixes - Shared resilience batch (#3885; #3676 #3674 #3668 #3670 #3682 #3672 #3593 #3592), `@claude-flow/shared` 3.0.2, thanks @rudycelekli. - Byzantine quorums intersect for every cluster size (#3560, #3587), federation sends use current peer trust (#3561, #3588), both @rudycelekli; `@claude-flow/swarm` 3.0.1 also fixes the `spawnAgent()` pool registration (#3539) and the event-driven `MessageBus` (#3563). - CLI: string options keep their declared value (#3594, #3601), config cache isolated per project (#3590, #3591), nested config defaults cloned (#3595, #3600), hive consensus errors surface (#3609, #3654), `daemon start --workers` honoured (#3547, #3875). - Plugins prefer the installed ruflo CLI (#3558, #3559, @HF-teamdev) and ruflo-adr edge keys are accepted by the memory validator (#3633, #3636, @drakeo338). - `@claude-flow/memory` 3.0.1: `mmrRerank()` caches cosine max-similarity (#3516, #3517). ### Breaking changes - Off-loopback MCP HTTP binds (for example Docker with `--host 0.0.0.0`) need a token or the explicit opt-out. - `hive-mind_init` no longer returns `hiveToken`. ### Packages `@claude-flow/cli`, `claude-flow`, `ruflo` 3.55.0. Leaves: `shared` 3.0.2, `memory` 3.0.1, `swarm` 3.0.1, `security` 3.0.2, `mcp` 3.1.0, `plugin-agent-federation` 1.0.1. Plugins: ruflo-adr 0.5.4, ruflo-goals 0.4.3, ruflo-cost-tracker 0.27.2, ruflo-metaharness 0.2.4, ruflo-console 0.36.1, ruflo-mods 0.3.15. Full changelog: CHANGELOG.md. Release PR: #3890. Gist: https://gist.github.com/ruvnet/172e077daf43f6efd6532cd8191862d5
Related Repositories
openclaw/openclaw★ 392,706
The AI that really does things. Any OS. Any Platform. The lobster way. 🦞
nilbuild/developer-roadmap★ 370,074
Interactive roadmaps, guides and other educational content to help developers grow in their careers.
morluto/rea★ 358,288
Reverse engineer anything with agents, from app behavior down to native binaries.
anomalyco/opencode★ 219,719
The open source coding agent.
n8n-io/n8n★ 208,261
Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.