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 /…
0 upvotes
Log in to upvote or save- Made by
- ruvnet
- Pinned commit
-
13af5f1208960c98832d6d9096a8d7ec45bcdc3e - 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
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
Paste this into your README. The badge says reviewed once the current version has been reviewed, and links readers to this page.
[](https://modsforclaude.com/mods/ruflo-bbs-federation/)