Repository navigation
legends-buzz v0.1.0
legends-buzz v0.1.0
Self-hosted Block Buzz Nostr relay operations, 26-domain MCP-to-CLI AI agent chat routing, NIP-29/NIP-OA/NIP-FI membership diagnostics, and desktop PE/asset verification for AI coding agents.
Highlights
- 14 Zero-Dependency CLI Subcommands (
Python 3.11+Standard Library):doctor: Offline and--livereadiness diagnostics across Python runtime, local knowledge pack hashes, Windows PE subsystem safety, Nostr key classification (nsec1...vs64-char hex), and relay connectivity.resources: Machine-readable paths for the attachablelegends-empireknowledge pack (knowledge/buzz/pack.json), operating recipe (docs/AGENT-RECIPE.md), and server/agent blueprints.mcp-map: Complete 26-domain / 108-subcommand Block Buzz (0.Xand1.0.0+) MCP-to-CLI reference router (--format agent) and exit-code taxonomy (0..5) without running an ambient MCP daemon.cli-inventory: Inspects the installedbuzzCLI binary, computes its SHA-256 digest, detects0.5.xvs1.0.0+generation capabilities (--format agent,NIP-FI), and lists rejected Windows GUI collisions.desktop-audit: Audits Windows and macOS Buzz Desktop installations, inspects Portable Executable (PE) Optional HeaderSubsystemvalues (IMAGE_SUBSYSTEM_WINDOWS_CUI = 3vsGUI = 2) to prevent the Windows NTFSBuzz.exevsbuzz.execase-collision overwrite, and scans embedded Tauri WebView assets (index.htmland hashedassets/bundles) to catch the0.5.22empty-asset build trap.relay-probe: SSRF-guarded (_NoRedirectHandler, DNS public-IP resolution check) 6-surface probe of/_readiness,/health, NIP-11 relay metadata (Accept: application/nostr+json), Tauri WebView CORS (Origin: tauri://localhost),/invite/*CSP onboarding edge (Cache-Control: no-store), and/pairRFC 6455 TLS WebSocket101 Switching Protocols(buzz-pair-relay).membership-check: Verifies authenticated relay access (NIP-OA/NIP-42) and distinguishes activememberstatus (with1.0.0unread counts) fromresidual_403(relay_membership_requiredneeding/invite/<token>) andnip_fi_required.owner-access-audit: Audits visible shared channels on a relay to verifyowner/admingovernance coverage (with pure-stdlib BIP-173 Bech32npub1...to 64-character hex normalization) and flag duplicate shared channel names.channel-snapshot: Captures channel metadata, member roster, collaborative Markdown canvas, and structured JSON messages in a single bounded payload.thread-context: Reconstructs isolated Nostrkind:9connected-component reply threads by walking["e", "<parent_id>"]tags in both parent and child directions without leaking unrelated shared-channel chatter (with conservative 1:1 DM fallback).media-inspect: Enforces 5 zero-trust attachment security gates (same-relay HTTPS origin,/media/<64hex>path binding, eventimetatag binding, SHA-256 digest & 30 MB size check, and magic-byte + XXE + 5,000-entry/60 MB zip-bomb guard) before bounded.txt,.md,.csv,.json,.xml,.docx, and.xlsxextraction.message-canary: Preview-first, SHA-256plan_sha256-gated disposable message canary (messages send -> messages get -> reactions add -> reactions remove -> messages delete) with guaranteedfinally:cleanup.relay-upgrade-plan: Generates an 8-gate zero-downtime self-hosted Buzz relay upgrade and isolated--internalDocker network PostgreSQL 17 clone migration rehearsal checklist.blueprint: Renders 9 production server, migration, ACP agent, and bridge blueprints (docker-compose-traefik,docker-compose-caddy,mobile-invite-edge,postgres-migration-49-60-preflight,stage-upgrade-verify,acp-subscription-agent,isolated-subscription-acp-launcher,durable-bridge-guard,systemd-alert-timer).
- Attachable
legends-empireKnowledge Pack:- Ships
knowledge/buzz/pack.json(legends.knowledge-pack/v1, suggested homewiki/library/legends-buzz/buzz) with 9 source-cited runbooks and 3 operational receipt templates.
- Ships
Install
python -m pip install "https://github.com/avalonreset/legends-buzz/releases/download/v0.1.0/legends_buzz-0.1.0-py3-none-any.whl"
legends-buzz --version
legends-buzz doctor --json