# Riprap demo script

Generated via `npm run test:demo`. Each query lands a full-page screenshot
in `test-results/demo-screenshots/<name>.png`. Use the curatorial top-5
ordering for the 5-min pitch slot.

## Curatorial top-5 (5-min pitch)

| Order | Screenshot | What lands | Audience |
|-------|------------|------------|----------|
| 1 | `red-hook.png` | Visual language: claim glyphs in the gutter, 4 sections, citations 1-4 in the drawer, MapLibre with Sandy + DEP layers, trace UI ticking through 9 specialists. The "this is what Riprap *is*" frame. | Everyone |
| 2 | `red-hook-houses-nycha.png` | Specific damning number: ~85% of the 2,878-unit Red Hook Houses footprint inside the 2012 Sandy Inundation Zone. NYCHA register card with per-row provenance grid. | Journalists, agency analysts |
| 3 | `hollis.png` | The Mellea reroll demo — Riprap catches itself getting an order of magnitude wrong (0.19% → 19%) and corrects in front of the audience. The system showing its work. | Researchers, methodology audience |
| 4 | `battery-live-now.png` | Shifts gears from archival to real-time: NOAA Battery gauge + NWS active alerts + TTM r2 surge nowcast. Streams in seconds, not minutes. | Agency analysts (OEM), planners |
| 5 | `downing-street-london.png` | Silence-over-confabulation. The briefing politely refuses to invent NYC content for an out-of-scope address. Closes the philosophical loop. | Researchers, anyone evaluating epistemic discipline |

## Full screenshot index

### Pre-vetted (passing on local Ollama with `RIPRAP_HEAVY_SPECIALISTS=0`)

| Screenshot | Query | Intent | Stakeholder fit |
|------------|-------|--------|-----------------|
| `red-hook.png` | 80 Pioneer Street, Red Hook, Brooklyn | single_address | Everyone — canonical opening |
| `far-rockaway.png` | Far Rockaway flood exposure briefing | neighborhood | CB-14, Queens-borough planners, journalists |
| `coney-island.png` | Coney Island Brooklyn | neighborhood | CB-13 |
| `hollis.png` | Hollis | neighborhood | Researchers — Mellea reroll path |

### Added (need `RIPRAP_HEAVY_SPECIALISTS=1` for register-card cells)

| Screenshot | Query | Intent | Stakeholder fit |
|------------|-------|--------|-----------------|
| `red-hook-houses-nycha.png` | Red Hook Houses NYCHA | single_address | Equity / housing journalists, NYCHA-policy watchers |
| `nyu-langone.png` | NYU Langone Hospital, Manhattan | single_address | Healthcare-resilience analysts; Sandy memory |
| `battery-live-now.png` | current conditions at the Battery, Manhattan | live_now | NYC OEM, NWS forecasters, anyone in surge mode |
| `gowanus-superfund.png` | Gowanus Canal Superfund flood exposure briefing | neighborhood | EPA Region 2 + DEC + DEP; methodology |
| `sheepshead-bay.png` | Sheepshead Bay flood exposure briefing | neighborhood | CB-15; canonical register-card showcase per spec §15 |

### Honest scope

| Screenshot | Query | Outcome | Stakeholder fit |
|------------|-------|---------|-----------------|
| `downing-street-london.png` | 10 Downing Street, London | Geocodes; every NYC specialist falls silent; ErrorCard `all-silent` OR honest "no grounded data" briefing | Researchers, evaluators of epistemic discipline |

## Reading a screenshot

Each image captures the full page after the SSE `done` event. Look for:

1. **Header**: wordmark, query echo, `live` status pill
2. **Briefing prose** (left column): four sections numbered 01–04, claim
   glyphs in the gutter (filled square = empirical, open square = modeled,
   filled circle = proxy, striped square = synthetic prior), citations
   numbered `[1]`–`[N]`
3. **Map** (right column, sticky): four tier-coloured polygon/dot layers.
   Layers with zero features are **omitted** from the legend (silence
   over confabulation, applied to the map)
4. **Citation drawer** (right column, below map): every cite line shows
   tier glyph + source + vintage + doc_id
5. **Register cards** (when present): per-row asset table for subway /
   NYCHA / schools / hospitals
6. **Trace UI** (bottom): one row per FSM step with `fired · silent ·
   errors` summary; tier badge per row when applicable

## Re-running the deck

```bash
# Local Ollama (granite4.1:8b on Mac, ~3 min/query average)
cd web/sveltekit
RIPRAP_HEAVY_SPECIALISTS=1 npm run test:demo

# AMD MI300X (vLLM, ~15 s/query)
RIPRAP_LLM_PRIMARY=vllm RIPRAP_LLM_BASE_URL=http://129.212.182.52:8000/v1 \
RIPRAP_LLM_API_KEY=<vllm-token> .venv/bin/uvicorn web.main:app --port 7860 &
cd web/sveltekit && npm run test:demo
```

The screenshots overwrite on each run; back them up under
`pitch/screenshots/<date>/` before iterating on the briefing prose.