sb-iam
1a592abb39
Reflects the current build: suppression disabled (Ramis), so the demo uses the 'Seen before.' escalate beat + learned_from edge, not the dead 'stays quiet' beat. Kept on the demo branch so main stays clean. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
57 lines
4.1 KiB
Markdown
57 lines
4.1 KiB
Markdown
# PodMan — Demo Runbook (final, read-off)
|
|
|
|
> One page. Reflects the **current live state** (`podman.live`) as of the final hour.
|
|
> Companion to `docs/demo.md` (full 4-min script) — this is the de-risked version.
|
|
|
|
## ⛔ Read first — last-hour changes that affect the demo
|
|
|
|
1. **Suppression is DISABLED for the demo** (`shouldIntervene` only filters `info`).
|
|
Every real collision now surfaces — good (no accidental silencing). **But the
|
|
`docs/demo.md` 2:10 beat "it learned to stay QUIET / no card fires" will NOT
|
|
work.** Do the **escalate** half only (below). Do not promise silence on stage.
|
|
2. **Do NOT redeploy prod.** The live build has demo code not on `main`
|
|
(`userPodContext`); redeploying `main` would remove it *and* surface stale
|
|
"SUPPRESSED" beats. If the auto-deploy timer is on, stop it before the run:
|
|
`systemctl stop podman-hermes-sync-deploy.timer`.
|
|
3. **Never debug on stage.** Narrate, fall back to the backup recording, keep moving.
|
|
|
|
## ✅ Pre-flight (do once, before you start)
|
|
|
|
- [ ] `curl https://podman.live/health` → `{"ok":true}`
|
|
- [ ] Deploy timer stopped (above); confirm exactly one agent: `systemctl status podman-platform-agent`
|
|
- [ ] Browser open on the pod; **click "Enable audio"** in-room (TTS needs it)
|
|
- [ ] Backup recording cued on a second device
|
|
- [ ] Two screen-shares live (the two "engineers")
|
|
|
|
## 🎬 The 3-minute path (the coherent, working story)
|
|
|
|
| Time | Do | Say (land the value) |
|
|
|---|---|---|
|
|
| **0:00** | Pod view, two live screen tiles | "Coordination is the bottleneck now, not coding. PodMan watches everyone's work live — no one has to ask 'what are you on?'" |
|
|
| **0:30** | Point at tiles; show activity stream filling | "Real screen-shares over **LiveKit**; each frame → **Gemini Vision** returns file/symbol/activity — a perception layer, not a chatbot." |
|
|
| **1:05** | Two engineers edit the **same file**, unpushed | "GitHub can't see this — nothing's pushed. We fuse live screen context with **local git truth**." → **collision card** appears. |
|
|
| **1:40** | **Accept** the card | Real **GitHub sync-PR** is created + outcome recorded. "One tap closes the loop." |
|
|
| **2:10** | **Trigger the same collision again** | Card now says **"Seen before."** and escalates straight to the **Gemini TTS voice** cue. "It recalled the prior event from **MongoDB Atlas vector search** and escalated — that's the learning." |
|
|
| **2:35** | Cut to **GraphView** | "This graph is materialized **live from MongoDB right now** — and here's the **`learned_from` edge**: PodMan learned who owns this file from the accepted outcome. Not a mock." |
|
|
| **3:00** | Stack + close | "All on **DigitalOcean**, systemd-supervised; ambient score is **Gemini Lyria**. Coordination awareness, collisions caught before they cost an afternoon, memory that sharpens each session." |
|
|
|
|
## 🗣️ Sponsor coverage (say each ≥ once)
|
|
- **Gemini** — Vision (0:30), TTS voice (2:10), Lyria (3:00) — add Live conversation if time allows
|
|
- **LiveKit** — "real screen-shares over LiveKit" (0:30), TTS over LiveKit (2:10)
|
|
- **MongoDB** — "Atlas vector-search recall" + "graph materialized live from MongoDB" (2:10, 2:35)
|
|
- **DigitalOcean** — "all on DigitalOcean, systemd-supervised" (3:00)
|
|
|
|
## 🚑 If it breaks
|
|
| Failure | Recovery |
|
|
|---|---|
|
|
| Voice doesn't fire | Cut to the card, say the line aloud — cards are the default path |
|
|
| Collision won't trigger | Use the backup recording for that beat; keep narrating |
|
|
| Graph looks empty/odd | Reload once; if still off, narrate from the recording |
|
|
| Agent silent | Suspect a duplicate `podman-hermes` process, not the UI — but **don't fix on stage** |
|
|
|
|
## Optional (only if ahead of time): the five-minute-meeting killer
|
|
Open the live voice conversation; ask *"PodMan, what is everyone working on, and where is the collision detector?"* → answers via real tool calls (**Gemini Live API**). Skip entirely if tight on time or if it drops.
|
|
|
|
---
|
|
**The spine:** live awareness → collision caught pre-push → accept → **"Seen before." + voice + `learned_from` edge**. That's the win. Suppression/"stays quiet" is intentionally out this run.
|