jerry/buzz

mirror of https://github.com/block/buzz.git synced 2026-11-06 17:31:19 +00:00

Files

Brad Seiler 8a113ed99e fix(desktop): show upgrade guidance (BUZZ-517) (#9033 )

## Summary

Old Buzz desktop clients now check a community’s public requirement
before each connection. An explicit `requires_nip_fi: true` shows an
upgrade screen with a fixed https://buzz.xyz download action and manual
fallback. Missing or false requirements, and failed discovery, preserve
normal connection behavior.

Retry, community navigation and address editing preserve keys and saved
communities. Changing an address cancels the old onboarding transaction
and fences pending profile checks. Native discovery sends no
credentials, follows no redirects, and limits requests to five seconds
and 256 KiB. Wire fixtures are exported from main `6b8a72e835` with
reproducible provenance.

### Related issue


[BUZZ-517](https://linear.app/squareup/issue/BUZZ-517/v0-clients-show-an-upgrade-screen-for-communities-requiring-nip-fi).
Related: [#8984](https://github.com/block/buzz/pull/8984) contains
mobile parser preparation;
[#8920](https://github.com/block/buzz/pull/8920) repairs relay rejection
messages.

### Rollout

There is no client flag. The upgrade screen appears only when the relay
advertises `requires_nip_fi: true`. Public auto-update delivery requires
a desktop release containing this change and promotion to the [OSS
auto-update
feed](aa749a862e/RELEASING.md (promote-an-oss-desktop-release-to-auto-update)).

In Shadow mode, requiring a community activates the screen; making it
optional restores normal connections. Global Enforce requires every
community regardless of that setting. Rollback must restore an effective
non-required policy. The optional and required outcomes are demonstrated
by Brad’s two manual cases below.

### Testing

At `71689b4708`, Honor’s isolated browser journeys passed 3/3 with zero
retries and verified served assets, including the fixed
`https://buzz.xyz` opener and manual fallback. McKeon independently
built and passed the same three journeys at the previous head
`8caa25260b` with the repository command: `CI=1 pnpm --dir desktop
build:e2e`, then `CI=1 pnpm --dir desktop exec playwright test
relay-entry-guidance.spec.ts --project=smoke`. Native IPC was mocked.

Brad [tested the running pre-rebase app
locally](https://github.com/block/buzz/pull/9033#issuecomment-6662960875):
an optional bb-public community in Shadow connected without a message;
required bb-block staging showed the upgrade message. These results
apply to that running app, not the rebased head.

Before:

![Earlier upgrade card with synthetic community
data](https://github.com/user-attachments/assets/63fbaa66-d551-4c20-ab04-c7fd966638e0)

After:

![Public upgrade card with Download latest Buzz action at
buzz.xyz](https://github.com/user-attachments/assets/f26a5d2a-47b4-4510-a86f-667d6f7c6d3d)

Generated with Codex

---------

Signed-off-by: Brad Seiler <seiler@squareup.com>
Co-authored-by: Honor <e0bf479eeebe47dde1e35705212a4df70616a7bc834d907ddfb18cf0405f8b1b@seiler-test.communities.public.builderlabstaging.xyz>

2026-11-05 19:22:01 +00:00

public

feat(desktop): add Pi agent preset (#7208 )

2026-09-01 17:41:09 -04:00

scripts

feat(desktop): relay admin console for the /api/admin/v1 operator surface (#4768 )

2026-09-24 17:34:25 -04:00

src

fix(desktop): show upgrade guidance (BUZZ-517) (#9033 )

2026-11-05 19:22:01 +00:00

src-tauri

fix(desktop): show upgrade guidance (BUZZ-517) (#9033 )

2026-11-05 19:22:01 +00:00

tests

fix(desktop): show upgrade guidance (BUZZ-517) (#9033 )

2026-11-05 19:22:01 +00:00

.env.e2e

feat(desktop): add persistent Bestie experience (#7223 )

2026-09-02 17:56:17 -04:00

.gitignore

test: add deterministic desktop release smoke (#5699 )

2026-08-13 14:49:40 -07:00

biome.json

fix(desktop): show upgrade guidance (BUZZ-517) (#9033 )

2026-11-05 19:22:01 +00:00

components.json

feat: add desktop app (#3 )

2026-03-09 13:02:11 -07:00

index.html

fix(desktop): externalize boot <style> to prevent Tauri CSP nonce override (#5242 )

2026-08-07 15:05:38 -07:00

package.json

chore(release): release Buzz Desktop version 0.5.28 (#8222 )

2026-10-09 16:18:58 -04:00

playwright.config.ts

fix(desktop): show upgrade guidance (BUZZ-517) (#9033 )

2026-11-05 19:22:01 +00:00

playwright.live.config.ts

feat(desktop+acp): spawn a harness per (agent, community) pair at GUI startup — warm sockets, lazy LLM pool (#2122 )

2026-07-22 13:24:46 -07:00

playwright.perf.config.ts

fix(desktop): single-owner anchored scroll for dynamic loading (#1115 )

2026-06-18 20:40:05 -04:00

playwright.release-smoke.config.ts

test: add deterministic desktop release smoke (#5699 )

2026-08-13 14:49:40 -07:00

postcss.config.js

fix(deps): migrate Tailwind CSS from v3 to v4 (#711 )

2026-05-22 20:45:47 -04:00

README.md

fix(desktop): show upgrade guidance (BUZZ-517) (#9033 )

2026-11-05 19:22:01 +00:00

tailwind.config.js

Refresh desktop onboarding flow (#7528 )

2026-09-15 05:58:16 -04:00

test-jsdom-setup.mjs

feat(desktop): relay admin console for the /api/admin/v1 operator surface (#4768 )

2026-09-24 17:34:25 -04:00

test-loader-hooks.mjs

feat(desktop): add persistent Bestie experience (#7223 )

2026-09-02 17:56:17 -04:00

test-loader.mjs

feat(desktop): thread-aware notifications with mutable follow/mute controls (#761 )

2026-05-28 18:43:41 -04:00

tsconfig.json

feat(desktop): add persistent Bestie experience (#7223 )

2026-09-02 17:56:17 -04:00

tsconfig.node.json

feat: add desktop app (#3 )

2026-03-09 13:02:11 -07:00

vite.config.ts

feat(desktop): add persistent Bestie experience (#7223 )

2026-09-02 17:56:17 -04:00

README.md

Buzz

Important

This is the deprecated Buzz 0.X desktop app. Buzz 1.0 lives in block/buzz-app. Build new desktop features there. Change this directory only to fix a 0.X bug, or to keep it compiling after a shared crate change.

Desktop chat shell with:

Tauri + React + TypeScript + Vite
Tailwind CSS
shadcn/ui-ready shared components
Biome (lint/format/check)
Feature-driven frontend structure

Scripts

pnpm dev - run the web frontend
pnpm tauri dev - run the desktop app
pnpm build - typecheck and build frontend
pnpm typecheck - TypeScript checks
pnpm lint - Biome lint
pnpm format - Biome format (write)
pnpm check - Biome check

Structure

src/shared - reusable app-wide code (ui, lib, styles)
src/features - feature modules (vertical slices)
src/app - top-level app composition

Required-community guidance in the legacy app

The legacy desktop reads public NIP-11 metadata before each WebSocket connection. Only requires_nip_fi: true shows the upgrade card. Missing/false requirements keep the existing connection flow. Discovery failures retain an unknown-policy state and continue the existing socket/authentication path; the relay enforces admission. Query/fragment URLs keep their existing socket behavior; the native discovery reader rejects them before making an HTTP request. Credentials never reach a fallback dial. Only explicit required policy opens the upgrade modal. Switching communities invalidates pending checks. The card does not reset keys or remove saved communities.

The upgrade card directs public users to the fixed https://buzz.xyz URL to download an up-to-date Buzz client on every supported desktop platform and for every required community. If the browser cannot open, the card shows the public URL for manual navigation. Discovery never supplies a trusted download or sign-in origin.