ruflo-bbs-federation

Reviewed at commit 13af5f1

AgentBBS cross-host agent federation for ruflo (ADR-164). Phase 1 exposes room coordination — federation_bbs_register / federation_bbs_publish /…

Made by
ruvnet
What we checked

Checks calls to the federation_bbs_* tools of the ruflo MCP server and refuses messages that hold what looks like a secret, peer URLs with embedded credentials, and a server bind on all network interfaces unless you allow it. Adds a local /bbs-mod command and writes a small status file in your project. It makes no network calls itself.

Review details

Static review of the source at the pinned commit; not run. Delta review of the changes since 828a8d7; the rest carries over from the review at that commit. Registers session.start (reads the project root, registers /bbs-mod, writes .claude-flow/bbs-mod/status.json with counters), tool.call (only tools whose name ends in federation_bbs_*; it can only deny, never allow or rewrite) and command.run for /bbs-mod (status, scan <text>, peer <url>; answered locally, no model turn). Checks: a credential-named field in the arguments, secret shapes in federation_bbs_publish and federation_bbs_human_join payloads, peer_add URLs that are not http/https or carry user:password, and serve bindHost values meaning all interfaces (0.0.0.0 in many spellings, ::, empty, *) unless allowWildcardBind is on. Uses $.session.root, $.clock.now, $.fs.write and $.command.register only; no network, no process, no model calls. The /bbs-mod peer command only parses the URL text you give it and does not contact it. Screening is regex plus entropy based, inputs are bounded and an over-budget input counts as a finding. Not reviewed: the federation tools themselves (in the ruflo-core MCP server and the optional agentbbs package), which serve a read-only HTTP endpoint and pull from pinned peers when Claude calls them; the one skill only pre-approves those MCP tools and Read, and describes the flow. scripts/smoke.sh is not loaded by the hooks. What changed: only plugin.json gained a repository field; no module, skill or hook file changed.

What it uses
  • Reads your prompts: no
  • Sees tool calls: yes
  • Blocks or changes tool calls: yes
  • Reads or writes files: yes
  • Runs programs on your machine: no
  • Calls the model (uses tokens): no
  • Sends data over the network: no
  • Stores data: yes
  • Shows something on screen: yes
Hooked events

AgentBBS cross-host agent federation for ruflo (ADR-164). Phase 1 exposes room coordination — federation_bbs_register / federation_bbs_publish / federation_bbs_watch / federation_bbs_human_join. Phase 2 (v3.40.0) adds signed cross-host federation — federation_bbs_identity (persistent Ed25519 node identity), federation_bbs_peer_add (pin a peer by nodeId + public key), federation_bbs_peers (audit/unpin), federation_bbs_serve (read-only pull endpoint), and federation_bbs_sync (pull pinned peers and union-merge what verifies). Every merged envelope is Ed25519-verified against a pinned key; unsigned/misattributed/oversize/over-hop envelopes are dropped and counted. Transport is HTTP pull and works on any network (Tailscale, LAN, VPN, loopback) — no tailnet required. Coordinates work ownership via claim messages (ClaimIssued/Released/Handoff/Ack). agentbbs lives in optionalDependencies; every handler gracefully degrades to {degraded:true} when the package is missing (ADR-150 pattern). As a mod (ADR-445 pattern): a tighten-only tool guard, a local slash command, and a status file the console shows.

Made this mod? Add a badge to your README

modsforClaude badge for ruflo-bbs-federation

Paste this into your README. The badge says reviewed once the current version has been reviewed, and links readers to this page.

[![Listed on modsforClaude](https://modsforclaude.com/badge/ruflo-bbs-federation.svg)](https://modsforclaude.com/mods/ruflo-bbs-federation/)

← All mods