Add deterministic announcement demo workspace

ANNOUNCEMENT_DEMO.md

@@ -0,0 +1,44 @@
+# Buzz announcement demo
+
+This branch includes a deterministic, relay-free workspace for recording the
+Buzz announcement film.
+
+## Launch
+
+From this worktree, run:
+
+```bash
+just announcement-staging
+```
+
+The command launches the native Tauri staging app on this worktree's isolated
+port with announcement mode enabled. The app uses the deterministic mock
+workspace rather than reading or writing real staging-relay data. Reloading the
+app restores the same clean demo workspace.
+
+The local demo relay also includes a running agent named **Scout**. Configure
+OpenAI or Anthropic in the Agents screen, then `@mention` Scout in
+`#flight-path`, `#design`, `#marketing`, or
+`#queen-bee-launch`. Scout shows a typing indicator and replies using the
+selected provider with the recent conversation as context. Direct messages to
+Scout work too. Agent settings are retained for reloads during the current app
+session; provider keys are never written into the repository or logged by the
+local provider bridge.
+
+For a browser-only preview, use `just announcement-demo`.
+
+## Demo workspace
+
+- Workspace: **Honeycomb Studios**
+- People: Alex Rivera (Product Lead) and nine fictional teammates across
+  engineering, design, marketing, research, QA, data, support, video, and
+  community
+- Sections: **The Hive**, **Product**, and **Launch Swarm**
+- Channels include `#announcements`, `#general`, `#flight-path`, `#design`,
+  `#mobile`, `#product-ideas`, `#marketing`, and
+  `#queen-bee-launch`
+- Projects: `flight-path`, `nectar`, `comb-kit`, and `swarm-launch`
+- Direct messages: Maya Chen, Jordan Brooks, and Priya Shah
+
+All portraits are generated fictional people. Scout uses the default generated
+identity until the announcement's final agent avatar is ready.

Justfile

@@ -488,6 +488,31 @@ desktop-dev:
     echo "Starting frontend dev server on Vite port ${BUZZ_VITE_PORT}, relay ${BUZZ_RELAY_URL}"
     pnpm exec vite --port "${BUZZ_VITE_PORT}" --strictPort
 
+# Open the deterministic, relay-free announcement workspace in a browser
+announcement-demo:
+    #!/usr/bin/env bash
+    set -euo pipefail
+    cd {{desktop_dir}}
+    [[ -d node_modules ]] || pnpm install
+    source ../scripts/instance-env.sh
+    demo_url="http://127.0.0.1:${BUZZ_VITE_PORT}/?demo=announcement"
+    pnpm exec vite --host 127.0.0.1 --port "${BUZZ_VITE_PORT}" --strictPort &
+    vite_pid=$!
+    trap 'kill "$vite_pid" 2>/dev/null || true' EXIT
+    for _ in $(seq 1 40); do
+        if curl -sf "http://127.0.0.1:${BUZZ_VITE_PORT}/" >/dev/null; then
+            break
+        fi
+        sleep 0.25
+    done
+    echo "Opening the Buzz announcement demo at ${demo_url}"
+    open "${demo_url}"
+    wait "$vite_pid"
+
+# Open the deterministic announcement workspace in the native staging shell
+announcement-staging *ARGS:
+    VITE_ANNOUNCEMENT_DEMO=1 just staging {{ARGS}}
+
 # ─── Web ─────────────────────────────────────────────────────────────────────
 
 # Run the web frontend dev server (port derived from worktree to avoid collisions)