Skip to content

Releases

v0.1.2

Choose a tag to compare

@avalonreset avalonreset released this 21 Nov 21:51

Evergreen README redesign with seven outlined Legends Font r1 SVG cards, collapsible reference drawers, and packaged SVG mirror completeness.

legends-buzz v0.1.1

Choose a tag to compare

@avalonreset avalonreset released this 11 Nov 03:17

legends-buzz v0.1.1

  • XML Entity/DTD Refusal, Bounded ZIP Decompression & Fail-Closed Gate 3 (legends_buzz/api.py): Hardened _safe_parse_xml_bytes with full-buffer UTF-8/UTF-16 <!DOCTYPE/<!ENTITY scanning plus Expat EntityDeclHandler, StartDoctypeDeclHandler, and ExternalEntityRefHandler hooks; replaced zf.read() with chunked _read_bounded_zip_member (10 MB per member, 60 MB cumulative stream ceiling); and made inspect_media_attachment Gate 3 fail-closed when --messages-file is omitted or the event is absent, supporting both list and {"messages": [...]} JSON envelopes.
  • Relay Probe SSRF & DNS-Rebinding Pinning (legends_buzz/api.py): Added urllib.request.ProxyHandler({}) and IP-pinned _PinnedHTTPHandler / _PinnedHTTPSHandler in _http_get and probe_relay, and updated _probe_pairing_websocket to honor use_tls (ws:// vs wss://) and pair_path.
  • BIP-173 Bech32 Checksum & Resource Identifier Validation (legends_buzz/api.py): Implemented full BIP-173 Bech32 length (63 chars), mixed-case refusal, polymod checksum verification, non-zero 5-to-8 bit padding refusal, and HEX64_RE validation in classify_key and normalize_pubkey, plus validate_channel_uuid and validate_event_hex64 across all channel, thread, canary, and media endpoints.
  • Symlink Safety & 100% Documentation Parity (legends_buzz/api.py, legends_buzz/desktop.py, README.md, AGENTS.md, docs/AGENT-RECIPE.md, scripts/check_release.py): Enforced _check_no_symlink_chain on un-resolved paths with Darwin-only /var, /tmp, /etc exemptions, expanded scripts/check_release.py forbidden patterns, and documented all 11 CLI subcommands and all 23 exported Python symbols.

legends-buzz v0.1.0

Choose a tag to compare

@avalonreset avalonreset released this 10 Nov 19:34

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 --live readiness diagnostics across Python runtime, local knowledge pack hashes, Windows PE subsystem safety, Nostr key classification (nsec1... vs 64-char hex), and relay connectivity.
    • resources: Machine-readable paths for the attachable legends-empire knowledge 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.X and 1.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 installed buzz CLI binary, computes its SHA-256 digest, detects 0.5.x vs 1.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 Header Subsystem values (IMAGE_SUBSYSTEM_WINDOWS_CUI = 3 vs GUI = 2) to prevent the Windows NTFS Buzz.exe vs buzz.exe case-collision overwrite, and scans embedded Tauri WebView assets (index.html and hashed assets/ bundles) to catch the 0.5.22 empty-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 /pair RFC 6455 TLS WebSocket 101 Switching Protocols (buzz-pair-relay).
    • membership-check: Verifies authenticated relay access (NIP-OA / NIP-42) and distinguishes active member status (with 1.0.0 unread counts) from residual_403 (relay_membership_required needing /invite/<token>) and nip_fi_required.
    • owner-access-audit: Audits visible shared channels on a relay to verify owner/admin governance coverage (with pure-stdlib BIP-173 Bech32 npub1... 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 Nostr kind:9 connected-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, event imeta tag 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 .xlsx extraction.
    • message-canary: Preview-first, SHA-256 plan_sha256-gated disposable message canary (messages send -> messages get -> reactions add -> reactions remove -> messages delete) with guaranteed finally: cleanup.
    • relay-upgrade-plan: Generates an 8-gate zero-downtime self-hosted Buzz relay upgrade and isolated --internal Docker 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-empire Knowledge Pack:
    • Ships knowledge/buzz/pack.json (legends.knowledge-pack/v1, suggested home wiki/library/legends-buzz/buzz) with 9 source-cited runbooks and 3 operational receipt templates.

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