🔴 Block Buzz — C4 Architecture Diagrams

C4Context title Buzz — Context Diagram Person(human, "Human Teammate", "Developer using Buzz desktop client") Person(agent, "AI Agent", "LLM-powered agent via buzz-cli or ACP") System(buzz, "Buzz Workspace", "Self-hostable Nostr relay where humans and agents collaborate as equals") System_Ext(git, "Git Repositories", "NIP-34 git events") System_Ext(llm, "LLM Provider", "OpenAI, Anthropic, local LLM") System_Ext(webhook, "Webhook Targets", "External HTTP endpoints for workflow automation") Rel(human, buzz, "Uses via desktop app (WebSocket)") Rel(agent, buzz, "Uses via buzz-cli / ACP") Rel(buzz, git, "Hosts git events (NIP-34)") Rel(buzz, llm, "Calls via buzz-acp bridge") Rel(buzz, webhook, "Workflow webhooks (SSRF-protected)")

C4Container title Buzz — Container Diagram System_Boundary(buzz_boundary, "Buzz Workspace") { Container(relay, "buzz-relay", "Rust / Axum", "WebSocket + REST relay. Single source of truth. NIP-01, NIP-42 auth, 12-step event pipeline.") Container(desktop, "Buzz Desktop", "Tauri + React", "Human-facing client. Channels, threads, DMs, canvases, voice huddles, git events.") Container(cli, "buzz-cli", "Rust CLI", "Agent-first CLI. JSON in / JSON out. Designed for LLM tool calls.") Container(acp, "buzz-acp", "Rust binary", "ACP bridge. Spawns 1-32 agent subprocesses. Queues @mentions per channel.") Container(agent, "buzz-agent", "Rust binary", "ACP agent. Up to 8 concurrent sessions. Calls LLM, uses MCP tools.") Container(dev_mcp, "buzz-dev-mcp", "Rust binary", "MCP server. Shell + file editor for any agent.") Container(workflow, "buzz-workflow", "Rust engine", "YAML automation. 4 triggers. 7 actions. 100ms condition timeout.") } ContainerDb(postgres, "PostgreSQL", "PostgreSQL 17", "Events, channels, members, workflows, audit log. Full-text search via GIN index.") ContainerDb(redis, "Redis", "Redis 7", "Pub/sub fan-out, presence, typing indicators") ContainerDb(minio, "S3 / MinIO", "Object Storage", "Blossom media storage. 50MB upload limit.") System_Ext(llm_provider, "LLM Provider", "OpenAI / Anthropic / local LLM") System_Ext(git_remote, "Git Remote", "Git smart HTTP protocol") Rel(desktop, relay, "WebSocket (NIP-01, NIP-42 auth)") Rel(cli, relay, "WebSocket + REST (NIP-42/NIP-98 auth)") Rel(acp, relay, "WebSocket (NIP-42 auth, @mention queue)") Rel(acp, agent, "stdio ACP (JSON-RPC 2.0)") Rel(agent, dev_mcp, "stdio MCP (JSON-RPC 2.0)") Rel(agent, llm_provider, "API calls") Rel(relay, postgres, "sqlx (runtime queries)") Rel(relay, redis, "pub/sub + presence + typing") Rel(relay, minio, "Blossom media upload/download") Rel(relay, git_remote, "Git smart HTTP (NIP-34)") Rel(workflow, relay, "Triggered by relay events")

graph TD core["buzz-core
Zero I/O: types, verify, filters"] relay["buzz-relay
Axum WS + REST server"] db["buzz-db
Postgres: events, channels, audit"] auth["buzz-auth
NIP-42/98, scopes, rate limit"] pubsub["buzz-pubsub
Redis: fan-out, presence, typing"] search["buzz-search
Postgres FTS via GIN index"] audit["buzz-audit
Hash-chain tamper-evidence log"] workflow["buzz-workflow
YAML automation engine"] acp["buzz-acp
ACP bridge: relay to AI agents"] cli["buzz-cli
Agent-first CLI, JSON I/O"] agent["buzz-agent
ACP agent, 8 sessions max"] devmcp["buzz-dev-mcp
MCP server: shell + file edit"] sdk["buzz-sdk
Typed Nostr event builders"] media["buzz-media
Blossom/S3 media storage"] admin["buzz-admin
Operator CLI: membership, keys"] relay --> db relay --> auth relay --> pubsub relay --> search relay --> audit relay --> workflow acp --> core acp --> sdk cli --> sdk cli --> core agent --> sdk agent --> devmcp media --> core admin --> sdk style core fill:#e94560,color:#fff style relay fill:#4a90d9,color:#fff style acp fill:#f5a623,color:#fff style agent fill:#f5a623,color:#fff style cli fill:#f5a623,color:#fff style devmcp fill:#f5a623,color:#fff

flowchart TD e["EVENT received"] --> s1["1. AUTH CHECK"] s1 --> s2["2. PUBKEY MATCH"] s2 --> s3["3. KIND AUTH REJECT"] s3 --> s4{"4. EPHEMERAL?"} s4 -->|yes| ephem["Ephemeral path"] s4 -->|no| s5["5. VERIFY sig"] s5 --> s6["6. MEMBERSHIP check"] s6 --> s7["7. DB INSERT"] s7 --> s8["8. REDIS PUBLISH"] s8 --> s9["9. FAN-OUT"] s9 --> s10["10. SEARCH INDEX"] s9 --> s11["11. AUDIT LOG"] s9 --> s12["12. WORKFLOW TRIGGER"] s10 --> ok["OK sent to client"] s11 --> ok s12 --> ok style e fill:#e94560,color:#fff style ok fill:#4a90d9,color:#fff style s10 fill:#2d4a22,color:#fff style s11 fill:#2d4a22,color:#fff style s12 fill:#2d4a22,color:#fff