Skip to content

Commit 1bb8b8d

Browse files
wesbillmanPinky
andauthored
docs: clean up remaining Buzz references (#977)
Signed-off-by: Wes <[email protected]> Co-authored-by: Pinky <44b8e82baa6e0e254e0208d68f335c283c94e7b78dd1fa10d5a49d3f13dd0435@sprout-oss.stage.blox.sqprod.co>
1 parent 9242b91 commit 1bb8b8d

17 files changed

Lines changed: 81 additions & 81 deletions

File tree

‎.gitignore‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -41,9 +41,9 @@ node_modules/
4141
.sqlx/
4242

4343
# SQLite database (created by relay in CWD)
44-
sprout.db
45-
sprout.db-wal
46-
sprout.db-shm
44+
buzz.db
45+
buzz.db-wal
46+
buzz.db-shm
4747

4848
# Docker volumes (if mounted locally)
4949
mysql-data/

‎ARCHITECTURE.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -561,7 +561,7 @@ Kind 5 (deletion) is intentionally blocked inbound — the relay's deletion hand
561561
| KIND_REACTION | 7 | Reaction |
562562
| KIND_DELETION | 5 | Standard NIP-09 deletion |
563563

564-
`to_sprout(to_standard(k))` is NOT lossless for secondary mappings (e.g., kind:1 → KIND_STREAM_MESSAGE → kind:42). Translation invalidates Schnorr signatures (event ID includes kind) — proxy re-signs events with shadow keys.
564+
`to_buzz(to_standard(k))` is NOT lossless for secondary mappings (e.g., kind:1 → KIND_STREAM_MESSAGE → kind:42). Translation invalidates Schnorr signatures (event ID includes kind) — proxy re-signs events with shadow keys.
565565

566566
**Dual auth:** Pubkey-based guest registration (persistent, primary) + invite tokens (ad-hoc, time-limited, secondary). Both use NIP-42 for the authentication handshake. The `proxy:submit` scope on the proxy's API token bypasses the relay's pubkey enforcement for shadow-signed events.
567567

‎CODE_OF_CONDUCT.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -60,7 +60,7 @@ representative at an online or offline event.
6060

6161
Instances of abusive, harassing, or otherwise unacceptable behavior may be
6262
reported to the community leaders responsible for enforcement at
63-
**conduct@sprout-relay.org**.
63+
**conduct@buzz-relay.org**.
6464

6565
All complaints will be reviewed and investigated promptly and fairly.
6666

‎CONTRIBUTING.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -445,4 +445,4 @@ their sign-off. When in doubt, check with your legal team.
445445
---
446446

447447
*Thank you for contributing to Buzz. Every bug report, documentation fix,
448-
and code contribution makes the project better for everyone. 🌱*
448+
and code contribution makes the project better for everyone. 🐝*

‎RELEASING.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -84,7 +84,7 @@ Each release produces two GitHub releases:
8484
1. **`v<version>`** — the user-facing release with the `.dmg` installer
8585
(macOS).
8686

87-
2. **`sprout-desktop-latest`** — a rolling pre-release for the Tauri
87+
2. **`buzz-desktop-latest`** — a rolling pre-release for the Tauri
8888
auto-updater containing `latest.json`, the signed `.tar.gz` archive,
8989
and its `.sig` signature.
9090

@@ -108,7 +108,7 @@ the same `v<version>` release. Intel users download the `_x64.dmg`.
108108

109109
| Secret | Purpose |
110110
|--------|---------|
111-
| `SPROUT_UPDATER_PUBLIC_KEY` | Tauri updater public key (minisign) |
111+
| `BUZZ_UPDATER_PUBLIC_KEY` | Tauri updater public key (minisign) |
112112
| `TAURI_SIGNING_PRIVATE_KEY` | Tauri updater private key |
113113
| `TAURI_SIGNING_PRIVATE_KEY_PASSWORD` | Password for the private key |
114114

@@ -129,7 +129,7 @@ Re-run `just release` from an up-to-date `main`. It resets the branch to current
129129
The version string must be valid semver: `MAJOR.MINOR.PATCH` with an optional pre-release suffix. Do not include a `v` prefix.
130130

131131
### Auto-updater reports "no update available"
132-
Verify that the `sprout-desktop-latest` release exists and contains a
132+
Verify that the `buzz-desktop-latest` release exists and contains a
133133
valid `latest.json`. The auto-updater manifest currently lists
134134
`darwin-aarch64` only, so Intel and Linux users do not yet receive
135135
auto-updates — they download new versions manually from the release

‎SECURITY.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
**Please do not report security vulnerabilities through public GitHub issues.**
66

77
If you discover a security vulnerability in Buzz, please report it by emailing
8-
**security@sprout-relay.org**. Include as much detail as possible:
8+
**security@buzz-relay.org**. Include as much detail as possible:
99

1010
- A description of the vulnerability and its potential impact
1111
- Steps to reproduce or a proof-of-concept (if available)

‎TESTING.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -264,7 +264,7 @@ out of the box with `just setup` or `just relay`. Common overrides:
264264
| `BUZZ_BIND_ADDR` | `0.0.0.0:3000` | Main app port |
265265
| `BUZZ_HEALTH_PORT` | `8080` | `/_liveness`, `/_readiness` |
266266
| `BUZZ_METRICS_PORT` | `9102` | Prometheus `/metrics` |
267-
| `RELAY_URL` | `ws://localhost:3000` | Advertised in NIP-11 / NIP-42 challenges. **Note: no `SPROUT_` prefix.** |
267+
| `RELAY_URL` | `ws://localhost:3000` | Advertised in NIP-11 / NIP-42 challenges. **Note: no `BUZZ_` prefix.** |
268268
| `DATABASE_URL` | `postgres://buzz:buzz_dev@localhost:5432/buzz` | |
269269
| `REDIS_URL` | `redis://localhost:6379` | |
270270
| `TYPESENSE_URL` | `http://localhost:8108` | |

‎VISION.md‎

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
1-
# 🌱 Sprout — The relay is the workspace
1+
# 🐝 Buzz — The relay is the workspace
22

33
> An engineer is debugging a production incident at 2am. They type in the incident channel: "What happened last time we saw this error?"
44
>
55
> An agent watching the channel searches six months of incident history and posts the threads, root causes, and fixes — then offers to page the engineer who deployed the last one.
66
7-
The platform made it possible. The agent made it happen. Sprout is the pipe — event store, search index, subscriptions, delivery — not the brain. Humans and agents bring the intelligence. Sprout gives them a shared space to use it.
7+
The platform made it possible. The agent made it happen. Buzz is the pipe — event store, search index, subscriptions, delivery — not the brain. Humans and agents bring the intelligence. Buzz gives them a shared space to use it.
88

9-
One relay is your entire workspace. Work, conversation, agents, automation, artifacts, docs — one domain, one identity system, one search index. `myproject.com` in a browser shows your repos. `git clone repoa.myproject.com` works. Open the Sprout app and you're in the channels where the work happens. No GitHub. No Discord. No stitching five services together. The project lives in one place, and that place is yours. See [VISION_SOVEREIGN.md](VISION_SOVEREIGN.md) for the full picture.
9+
One relay is your entire workspace. Work, conversation, agents, automation, artifacts, docs — one domain, one identity system, one search index. `myproject.com` in a browser shows your repos. `git clone repoa.myproject.com` works. Open the Buzz app and you're in the channels where the work happens. No GitHub. No Discord. No stitching five services together. The project lives in one place, and that place is yours. See [VISION_SOVEREIGN.md](VISION_SOVEREIGN.md) for the full picture.
1010

1111
---
1212

@@ -43,7 +43,7 @@ The relay enforces all access control. Channel membership is the only gate.
4343
| **DMs** | Participants only | N/A (up to 9) | Any member |
4444
| **Guests** | Scoped to specific channels | Invited | N/A |
4545

46-
Guests (investors, reporters, partners) get a scoped token with membership in specific channels. Same access model as everyone else. Guests can connect with their own Nostr client (Coracle, nak, Amethyst) through [`sprout-proxy`](NOSTR.md), which translates standard NIP-28 events to Sprout's internal protocol. Two auth paths: pubkey-based guest registration (persistent) or invite tokens (ad-hoc, time-limited).
46+
Guests (investors, reporters, partners) get a scoped token with membership in specific channels. Same access model as everyone else. Guests can connect with their own Nostr client (Coracle, nak, Amethyst) through [`buzz-proxy`](NOSTR.md), which translates standard NIP-28 events to Buzz's internal protocol. Two auth paths: pubkey-based guest registration (persistent) or invite tokens (ad-hoc, time-limited).
4747

4848
---
4949

@@ -60,7 +60,7 @@ content JSON payload
6060
sig Schnorr signature
6161
```
6262

63-
Sprout extends the standard Nostr event format with custom kind numbers for enterprise features.
63+
Buzz extends the standard Nostr event format with custom kind numbers for enterprise features.
6464

6565
New message type? New kind integer. Zero breaking changes.
6666

@@ -93,7 +93,7 @@ One model. TLS in transit. At-rest encryption delegated to the storage layer (e.
9393

9494
## Huddles
9595

96-
Real-time voice runs over a WebSocket Opus relay built into `sprout-relay`. Sprout authenticates participants (NIP-42), admits them to a room, and forwards Opus frames between peers — no external SFU.
96+
Real-time voice runs over a WebSocket Opus relay built into `buzz-relay`. Buzz authenticates participants (NIP-42), admits them to a room, and forwards Opus frames between peers — no external SFU.
9797

9898
- Agents join the same audio relay as humans — they bring their own STT/TTS
9999
- Huddle lifecycle flows as Nostr events: started, joined, left, ended
@@ -102,7 +102,7 @@ Voice, room lifecycle, and lifecycle events are wired. Recording and per-track p
102102

103103
---
104104

105-
## Sprout Mesh
105+
## Buzz Mesh
106106

107107
Relay communities can pool opted-in member hardware into shared AI compute. Existing agents see it as a local OpenAI-compatible provider; the relay gates discovery and trust with the same membership model it already uses for messages, code, and workflows. Models too large for any single machine split across several. See [VISION_MESH.md](VISION_MESH.md) for the full compute-commons vision.
108108

@@ -139,15 +139,15 @@ Beyond chat: channels are workspaces.
139139

140140
The relay hosts git repos. Smart HTTP — standard `git clone`, `git push`, nothing special. Your npub signs pushes. Same domain, same auth, same identity as everything else on the relay.
141141

142-
Branches are channels. Create a feature branch, Sprout creates a channel — CI results, review comments, and the merge decision all live there. When the branch merges, the channel archives into a permanent record of why that code exists.
142+
Branches are channels. Create a feature branch, Buzz creates a channel — CI results, review comments, and the merge decision all live there. When the branch merges, the channel archives into a permanent record of why that code exists.
143143

144144
See [VISION_PROJECTS.md](VISION_PROJECTS.md) for the full forge vision: the project model, the merge flow, branch protections, and how agents participate as contributors.
145145

146146
---
147147

148148
## Agent CLI
149149

150-
`sprout-cli` is an agent-first CLI that mirrors and extends the MCP surface — same primitives, plus repo, upload, and canvas operations where the CLI is the canonical interface. JSON-only stdout, structured errors on stderr, two-tier auth (NIP-98 keypair → dev pubkey). Agents can script the entire platform without a GUI.
150+
`buzz-cli` is an agent-first CLI that mirrors and extends the MCP surface — same primitives, plus repo, upload, and canvas operations where the CLI is the canonical interface. JSON-only stdout, structured errors on stderr, two-tier auth (NIP-98 keypair → dev pubkey). Agents can script the entire platform without a GUI.
151151

152152
---
153153

@@ -190,7 +190,7 @@ Not afterthoughts — ship blockers:
190190

191191
## Build Model
192192

193-
Greenfield. Agent swarms build in parallel, integrating at the event store boundary. Sprout is being built with AI-assisted development — agents write code, crossfire reviews across multiple models catch blind spots before merge. A complete platform, not a collection of independent microservices.
193+
Greenfield. Agent swarms build in parallel, integrating at the event store boundary. Buzz is being built with AI-assisted development — agents write code, crossfire reviews across multiple models catch blind spots before merge. A complete platform, not a collection of independent microservices.
194194

195195
---
196196

@@ -205,12 +205,12 @@ Greenfield. Agent swarms build in parallel, integrating at the event store bound
205205
| ✅ | Channel features — messaging, threads, reactions, canvases, media uploads, editing, deletion, typing indicators, NIP-29, soft-delete |
206206
| ✅ | Workflow engine — YAML-as-code, execution traces, message/reaction/schedule/webhook triggers |
207207
| ✅ | Identity — NIP-05, public profiles, NIP-98 auth, agent protection |
208-
| ✅ | NIP-28 proxy — third-party Nostr clients (Coracle, nak, Amethyst) via `sprout-proxy` |
209-
| ✅ | Agent CLI — `sprout-cli`, mirrors and extends the MCP surface |
208+
| ✅ | NIP-28 proxy — third-party Nostr clients (Coracle, nak, Amethyst) via `buzz-proxy` |
209+
| ✅ | Agent CLI — `buzz-cli`, mirrors and extends the MCP surface |
210210
| ✅ | Agent personas and teams — desktop-managed, built-in defaults, operator-defined |
211211
| 🚧 | Workflow approval gates — infrastructure exists (DB, API, UI); executor doesn't persist/resume (WF-08) |
212212
| ✅ | Huddles — WebSocket Opus voice relay + lifecycle events (recording/tracks planned) |
213-
| ✅ | Sprout Mesh — relay-gated shared AI compute (mesh-llm over iroh); members pool GPUs, agents consume via a local OpenAI-compatible endpoint |
213+
| ✅ | Buzz Mesh — relay-gated shared AI compute (mesh-llm over iroh); members pool GPUs, agents consume via a local OpenAI-compatible endpoint |
214214
| 🚧 | Mobile client — Flutter app (channels, forum, search, profile, pairing); in active development |
215215
| 📋 | Developer portal, push notifications, culture features |
216216

@@ -222,4 +222,4 @@ See [README.md](README.md) for setup and [AGENTS.md](AGENTS.md) for connecting A
222222

223223
---
224224

225-
*Sprout 🌱 — where humans and agents are just colleagues.*
225+
*Buzz 🐝 — where humans and agents are just colleagues.*

‎VISION_AGENT.md‎

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Vision: sprout-agent + sprout-dev-mcp
1+
# Vision: buzz-agent + buzz-dev-mcp
22

33
## The Problem
44

@@ -10,9 +10,9 @@ We wanted something we could read in an afternoon and audit with confidence.
1010

1111
Two binaries, two protocols, no coupling between them.
1212

13-
**sprout-agent** is an ACP agent. It speaks the Agent Client Protocol over stdio, calls an LLM, and uses MCP tools. Multiple concurrent sessions, each with its own MCP servers, history, and context. When context fills up, a session summarizes its own history and continues. It works with Zed, JetBrains, sprout-acp, or anything else that speaks ACP.
13+
**buzz-agent** is an ACP agent. It speaks the Agent Client Protocol over stdio, calls an LLM, and uses MCP tools. Multiple concurrent sessions, each with its own MCP servers, history, and context. When context fills up, a session summarizes its own history and continues. It works with Zed, JetBrains, buzz-acp, or anything else that speaks ACP.
1414

15-
**sprout-dev-mcp** is an MCP server. It gives any agent a shell and a file editor. Ephemeral processes with process-group kill on every exit path. Bounded output. File edits resolve against the working directory. It works with any agent or client that speaks MCP.
15+
**buzz-dev-mcp** is an MCP server. It gives any agent a shell and a file editor. Ephemeral processes with process-group kill on every exit path. Bounded output. File edits resolve against the working directory. It works with any agent or client that speaks MCP.
1616

1717
Together: two crates of Rust purpose-built for headless autonomous coding work.
1818

@@ -22,20 +22,20 @@ Together: two crates of Rust purpose-built for headless autonomous coding work.
2222

2323
**Correctness at the boundary.** ACP compliance is not a checkbox. We report a concrete protocol version. We emit every required notification. We handle cancellation on every path. We kill process trees on timeout. Key safety properties have regression tests that lock them down.
2424

25-
**Composability through standards.** The agent does not know what MCP server it talks to. The MCP server does not know what agent is calling it. They compose through protocols, not imports. Run ten agents behind sprout with different MCP configurations. Swap the LLM provider with one environment variable. Point Zed at sprout-agent and you get the same tool-calling behavior in your editor.
25+
**Composability through standards.** The agent does not know what MCP server it talks to. The MCP server does not know what agent is calling it. They compose through protocols, not imports. Run ten agents behind Buzz with different MCP configurations. Swap the LLM provider with one environment variable. Point Zed at buzz-agent and you get the same tool-calling behavior in your editor.
2626

2727
## The Architecture
2828

2929
```
30-
Any ACP client (Zed, JetBrains, sprout-acp, custom)
30+
Any ACP client (Zed, JetBrains, buzz-acp, custom)
3131
|
3232
| stdio ACP (JSON-RPC 2.0)
3333
v
34-
sprout-agent (up to 8 concurrent sessions)
34+
buzz-agent (up to 8 concurrent sessions)
3535
|
3636
| stdio MCP (JSON-RPC 2.0) — one per session
3737
v
38-
sprout-dev-mcp (or any MCP server)
38+
buzz-dev-mcp (or any MCP server)
3939
|
4040
v
4141
shell, str_replace, todo; rg + tree on PATH
@@ -56,7 +56,7 @@ Two pipes. Two protocols. Each session gets its own MCP server instances — ful
5656
## What This Enables
5757

5858
- Multiple concurrent sessions in one process — each with independent MCP servers, history, and context (configurable cap, default 8)
59-
- Ten agents in parallel behind sprout, each with their own MCP configuration
59+
- Ten agents in parallel behind Buzz, each with their own MCP configuration
6060
- Any ACP client gets a coding agent without a custom adapter
6161
- Any MCP server gets a capable caller without a custom adapter
6262
- A codebase small enough to fork, modify, and understand in a day — two crates, no coupling between them

0 commit comments

Comments
 (0)