Frontend overhaul: Lit kickoff → Svelte 5 custom elements → SvelteKit design-system

Telescoped from ~25 spine commits into the three UI generations:

Lit (kept on disk for reference, not loaded):
web/static/components/{briefing,trace,signals,sources-footer}.js
Component-per-tag custom elements with reactive props.

Svelte 5 custom-element bundle (legacy primary, served at /legacy):
web/svelte/src/lib/{Briefing,Trace,SourcesFooter}.svelte + main.js
Shared store for cross-component highlight (citeIndex,
highlightedDocId). Built artifact ships at web/static/dist/riprap.js.

SvelteKit design-system v0.4.2 (the new primary):
web/sveltekit/src/* — adapter-static build, IBM Plex, four-tier
glyphs, MapLibre map with custom basemap, server-side render of
/q/sample + /q/<query>. Built artifact ships at web/sveltekit/build/.

web/main.py wired up the new endpoint surface:
/, /q/sample, /q/<query> → SvelteKit build
/legacy, /single, /compare → Svelte custom-element bundle
/api/agent/stream → SSE pipeline (plan/step/token/mellea_attempt
/final/error/done events)
/api/backend → live LLM-backend descriptor for the pill
/api/layers/* → MapLibre tile/polygon endpoints
/api/floodnet_near, /api/register/{class}, /print/{query_id}, etc.

HF Spaces ships pre-built artefacts (no Node at deploy time); rebuild
locally with cd web/sveltekit && npm run build, or cd web/svelte &&
npm run build for the legacy bundle.

web/main.py

@@ -1,10 +1,11 @@
-"""HeliOS-NYC web UI — FastAPI + SSE streaming of the Burr FSM trace.
+"""Riprap web UI — FastAPI + SSE streaming of the Burr FSM trace.
 
 Run: uvicorn web.main:app --reload --port 8000
 """
 from __future__ import annotations
 
 import json
+import os
 import warnings
 from pathlib import Path
 
@@ -20,14 +21,21 @@ from app.fsm import iter_steps  # noqa: E402
 
 ROOT = Path(__file__).resolve().parent
 STATIC = ROOT / "static"
+SVELTEKIT_BUILD = ROOT / "sveltekit" / "build"
 
 app = FastAPI(title="Riprap")
 app.mount("/static", StaticFiles(directory=STATIC), name="static")
 
+# SvelteKit static build (adapter-static). Serves the new design-system UI
+# from /, /q/sample, /q/<query>. The legacy custom-element pages remain at
+# /legacy, /single, /compare, /register/* for as long as they're useful.
+if SVELTEKIT_BUILD.exists():
+    app.mount("/_app", StaticFiles(directory=SVELTEKIT_BUILD / "_app"), name="sveltekit_assets")
+
 import json as _json  # noqa: E402
 
 import geopandas as _gpd  # noqa: E402
-from fastapi.responses import JSONResponse, Response  # noqa: E402
+from fastapi.responses import JSONResponse  # noqa: E402
 
 _LAYER_CACHE: dict = {}
 
@@ -74,13 +82,221 @@ def _warm_caches():
         dep_stormwater.load(scen)
     print("[startup] flood layers ready", flush=True)
     print("[startup] warming RAG (Granite Embedding 278M + 5 PDFs)...", flush=True)
-    from app import rag
-    rag.warm()
-    print("[startup] RAG ready", flush=True)
+    # RAG warm loads sentence-transformers, which on some HF Space rebuilds
+    # has hit transformers-lazy-import edge cases (CodeCarbonCallback). The
+    # Space *must* start even if RAG fails — the FSM still works without
+    # RAG citations (specialists deliver their own grounded data, and the
+    # rag step in fsm.py already handles `rag=[]` gracefully). Surface the
+    # failure loudly in logs but don't kill the app.
+    try:
+        from app import rag
+        rag.warm()
+        print("[startup] RAG ready", flush=True)
+    except Exception as e:  # noqa: BLE001
+        print(f"[startup] RAG warm FAILED — continuing without RAG: "
+              f"{type(e).__name__}: {e}", flush=True)
+        import traceback
+        traceback.print_exc()
+    # Pre-import the heavy EO/ML stacks on the main thread so the
+    # parallel-fanout workers don't race each other on first
+    # import (sklearn's "partially initialized module" surfaces as a
+    # spurious ImportError when terratorch / tsfm_public both pull
+    # sklearn concurrently from worker threads).
+    # Warm the Ollama LLM models so the first user query doesn't pay a
+    # cold-load penalty (~70 s for the 3B planner, ~12 s for the 8B
+    # reconciler at Q4_K_M). Sets keep_alive to 24 h so they stay
+    # resident across queries. Both calls use num_ctx that matches the
+    # production call sites (Mellea's 4096), so Ollama's KV cache is
+    # pre-allocated at the right size and the first reconcile doesn't
+    # pay an extra grow-and-reinit cost.
+    if os.environ.get("RIPRAP_SKIP_LLM_WARM", "").lower() not in ("1", "true", "yes"):
+        print("[startup] warming Ollama models (granite4.1:3b + 8b)...",
+              flush=True)
+        try:
+            import httpx as _httpx
+            base = os.environ.get(
+                "OLLAMA_BASE_URL",
+                os.environ.get("OLLAMA_HOST", "http://localhost:11434"),
+            )
+            if not base.startswith("http"):
+                base = "http://" + base
+            keep_alive = os.environ.get("OLLAMA_KEEP_ALIVE", "24h")
+            num_ctx = int(os.environ.get("RIPRAP_MELLEA_NUM_CTX", "4096"))
+            for tag in (os.environ.get("RIPRAP_OLLAMA_3B_TAG", "granite4.1:3b"),
+                        os.environ.get("RIPRAP_OLLAMA_8B_TAG", "granite4.1:8b")):
+                try:
+                    r = _httpx.post(
+                        base.rstrip("/") + "/api/generate",
+                        json={
+                            "model": tag,
+                            "prompt": "hi",
+                            "stream": False,
+                            "keep_alive": keep_alive,
+                            "options": {"num_ctx": num_ctx, "num_predict": 1},
+                        },
+                        timeout=180,
+                    )
+                    if r.status_code == 200:
+                        load_s = r.json().get("load_duration", 0) / 1e9
+                        print(f"[startup]   {tag} loaded "
+                              f"(load_duration={load_s:.1f}s, "
+                              f"keep_alive={keep_alive}, num_ctx={num_ctx})",
+                              flush=True)
+                    else:
+                        print(f"[startup]   {tag} warm failed "
+                              f"({r.status_code})", flush=True)
+                except Exception as warm_err:
+                    print(f"[startup]   {tag} warm failed: {warm_err}",
+                          flush=True)
+        except Exception as e:
+            print(f"[startup] LLM warm skipped: {e}", flush=True)
+    print("[startup] pre-importing terratorch + tsfm_public...", flush=True)
+    try:
+        import sklearn  # noqa: F401  prime sklearn first
+        import terratorch  # noqa: F401
+        import tsfm_public  # noqa: F401
+    except Exception as e:
+        print(f"[startup] heavy-EO pre-import skipped: {e}", flush=True)
+    # Warm the TerraMind specialist so first per-query call is just
+    # the diffusion (~3 s), not model load (~30 s). No-ops if deps
+    # are missing on this deployment.
+    try:
+        from app.context import terramind_synthesis
+        terramind_synthesis.warm()
+        print("[startup] TerraMind ready", flush=True)
+    except Exception as e:
+        print(f"[startup] TerraMind warm skipped: {e}", flush=True)
+
+
+@app.get("/api/debug/eo")
+def api_debug_eo():
+    """Diagnostic for the EO toolchain (Phase 1 + Phase 4) on HF Spaces.
+
+    Surfaces sys.path, PYTHONPATH, and per-module import status so we
+    can tell whether terratorch is actually findable from inside the
+    uvicorn process. Used to debug why the runtime --target install
+    appears to succeed in the entrypoint but isn't visible to the
+    FSM specialists at request time.
+    """
+    import os
+    import sys
+    import traceback
+    from pathlib import Path
+
+    out = {
+        "python_executable": sys.executable,
+        "python_version": sys.version,
+        "PYTHONPATH": os.environ.get("PYTHONPATH"),
+        "PYTHONNOUSERSITE": os.environ.get("PYTHONNOUSERSITE"),
+        "HOME": os.environ.get("HOME"),
+        "sys.path": sys.path,
+    }
+    eo_dir = Path(os.environ.get("HOME", "/home/user")) / ".eo-pkgs"
+    out["eo_dir"] = str(eo_dir)
+    out["eo_dir_exists"] = eo_dir.exists()
+    if eo_dir.exists():
+        out["eo_dir_contents"] = sorted(p.name for p in eo_dir.iterdir())[:50]
+    out["modules"] = {}
+    for name in ("terratorch", "einops", "diffusers", "timm",
+                 "rasterio", "planetary_computer", "pystac_client"):
+        try:
+            mod = __import__(name)
+            out["modules"][name] = {"ok": True,
+                                     "file": getattr(mod, "__file__", "?")}
+        except Exception as e:
+            out["modules"][name] = {"ok": False,
+                                     "err": f"{type(e).__name__}: {e}",
+                                     "tb": traceback.format_exc().splitlines()[-3:]}
+    return JSONResponse(out)
+
+
+@app.get("/api/backend")
+async def api_backend():
+    """Live LLM-backend descriptor for the UI's hardware badge.
+
+    Returns the configured primary (vLLM/AMD or Ollama/local), plus a
+    quick reachability ping so the badge can show whether the primary is
+    actually answering or whether the Router is on the fallback path.
+    """
+    import httpx
+
+    from app import llm
+    info = llm.backend_info()
+    reachable = None
+    try:
+        if info["primary"] in ("vllm", "mlx") and info["vllm_base_url"]:
+            url = info["vllm_base_url"].rstrip("/") + "/models"
+            async with httpx.AsyncClient(timeout=2.5) as client:
+                r = await client.get(url, headers={"Authorization": "Bearer ping"})
+            # vLLM and mlx_lm.server both return 200 on /v1/models when
+            # reachable; vLLM may return 401 with --api-key set. Either
+            # proves the server is up. Anything else = unreachable.
+            reachable = r.status_code in (200, 401)
+        else:
+            url = info["ollama_base_url"].rstrip("/") + "/api/tags"
+            async with httpx.AsyncClient(timeout=2.5) as client:
+                r = await client.get(url)
+            reachable = r.status_code == 200
+    except Exception:
+        reachable = False
+    info["reachable"] = reachable
+    info["effective_engine"] = (
+        info["engine"] if reachable
+        else (info.get("fallback_engine") or "offline")
+    )
+    return JSONResponse(info)
 
 
 @app.get("/")
 def index():
+    """SvelteKit cold-start page (the new design-system UI). Falls back to
+    the legacy custom-element agent.html if the SvelteKit build hasn't been
+    compiled yet — that lets `uvicorn` boot in a fresh checkout without a
+    Node toolchain present."""
+    sk = SVELTEKIT_BUILD / "index.html"
+    if sk.exists():
+        return FileResponse(sk)
+    return FileResponse(STATIC / "agent.html")
+
+
+@app.get("/q/sample")
+def q_sample_page():
+    """The prerendered Red Hook demo briefing (no SSE)."""
+    sk = SVELTEKIT_BUILD / "q" / "sample.html"
+    if sk.exists():
+        return FileResponse(sk)
+    return JSONResponse({"error": "sveltekit build not present"}, status_code=503)
+
+
+@app.get("/q/{query_id}")
+def q_query_page(query_id: str):  # noqa: ARG001 — captured for the SPA router
+    """Live briefing route. Served by the SvelteKit SPA fallback (200.html);
+    the client opens an EventSource to /api/agent/stream."""
+    sk = SVELTEKIT_BUILD / "200.html"
+    if sk.exists():
+        return FileResponse(sk)
+    return JSONResponse({"error": "sveltekit build not present"}, status_code=503)
+
+
+@app.get("/print/{query_id}")
+def print_page(query_id: str):  # noqa: ARG001 — captured by the SPA router
+    """Curated print artifact for a completed briefing. The client
+    hydrates from localStorage (key riprap:print:<query_id>) and
+    auto-fires window.print() — no backend round-trip."""
+    sk = SVELTEKIT_BUILD / "200.html"
+    if sk.exists():
+        return FileResponse(sk)
+    return JSONResponse({"error": "sveltekit build not present"}, status_code=503)
+
+
+@app.get("/legacy")
+def legacy_index():
+    """Original custom-element agent page, preserved for fallback / debugging."""
+    return FileResponse(STATIC / "agent.html")
+
+
+@app.get("/single")
+def single_address_page():
     return FileResponse(STATIC / "index.html")
 
 
@@ -89,6 +305,18 @@ def compare_page():
     return FileResponse(STATIC / "compare.html")
 
 
+@app.get("/agent")
+def agent_page():
+    return FileResponse(STATIC / "agent.html")
+
+
+@app.get("/report")
+def report_page():
+    """Print-ready auditable report. Reads the prior agent run from
+    the browser's sessionStorage; fully client-side render."""
+    return FileResponse(STATIC / "report.html")
+
+
 @app.get("/register/{asset_class}")
 def register_page(asset_class: str):
     if asset_class not in ("schools", "nycha", "mta_entrances"):
@@ -121,6 +349,7 @@ async def compare_stream(a: str, b: str, request: Request):
     route updates to the correct panel."""
     import asyncio
     import queue
+
     from app.fsm import iter_steps
 
     def gen_for_side(side: str, q_text: str, out_q):
@@ -132,7 +361,7 @@ async def compare_stream(a: str, b: str, request: Request):
             out_q.put({"side": side, "kind": "error", "err": str(e)})
         out_q.put({"side": side, "kind": "_done"})
 
-    out_q: "queue.Queue[dict]" = queue.Queue()
+    out_q: queue.Queue[dict] = queue.Queue()
 
     def kick():
         # run both sides in parallel threads — each Burr Application owns
@@ -187,6 +416,153 @@ async def stream(q: str, request: Request):
                                       "X-Accel-Buffering": "no"})
 
 
+@app.get("/api/agent")
+def api_agent(q: str):
+    """Agentic endpoint: take a natural-language query, plan it via
+    Granite 4.1, dispatch to the appropriate intent module, return the
+    full result as JSON. The Plan is included so callers can see the
+    agent's routing decision.
+
+    All non-trivial reconciliation (single_address / neighborhood /
+    development_check) routes through Mellea-validated rejection
+    sampling against four grounding requirements. live_now stays on
+    streaming reconcile because outputs are short and the live signals
+    have low hallucination surface."""
+    from app.intents import development_check as i_dev
+    from app.intents import live_now as i_live
+    from app.intents import neighborhood as i_nbhd
+    from app.intents import single_address as i_addr
+    from app.planner import plan as run_planner
+    p = run_planner(q)
+    if p.intent == "development_check":
+        out = i_dev.run(p, q, strict=True)
+    elif p.intent == "neighborhood":
+        out = i_nbhd.run(p, q, strict=True)
+    elif p.intent == "live_now":
+        out = i_live.run(p, q)
+    else:
+        out = i_addr.run(p, q, strict=True)
+    return JSONResponse(out)
+
+
+@app.get("/api/agent/stream")
+async def api_agent_stream(q: str):
+    """SSE: emit `plan` once the planner finishes, then a `step` event per
+    finalized specialist, then `final` with the full result. The intent
+    runs in a thread; we marshal events through a queue."""
+    import asyncio
+    import queue
+    out_q: queue.Queue[dict] = queue.Queue()
+
+    def runner():
+        try:
+            from app.intents import development_check as i_dev
+            from app.intents import live_now as i_live
+            from app.intents import neighborhood as i_nbhd
+            from app.intents import single_address as i_addr
+            from app.planner import plan as run_planner
+
+            def _on_plan_token(delta: str):
+                out_q.put({"kind": "plan_token", "delta": delta})
+            p = run_planner(q, on_token=_on_plan_token)
+            out_q.put({"kind": "plan",
+                       "intent": p.intent,
+                       "targets": p.targets,
+                       "specialists": p.specialists,
+                       "rationale": p.rationale})
+            if p.intent == "development_check":
+                final = i_dev.run(p, q, progress_q=out_q, strict=True)
+            elif p.intent == "neighborhood":
+                final = i_nbhd.run(p, q, progress_q=out_q, strict=True)
+            elif p.intent == "live_now":
+                final = i_live.run(p, q, progress_q=out_q)
+            else:
+                final = i_addr.run(p, q, progress_q=out_q, strict=True)
+            out_q.put({"kind": "final", **final})
+        except Exception as e:
+            out_q.put({"kind": "error", "err": str(e)})
+        finally:
+            out_q.put({"kind": "_done"})
+
+    async def event_stream():
+        loop = asyncio.get_event_loop()
+        loop.run_in_executor(None, runner)
+        yield f"event: hello\ndata: {json.dumps({'query': q})}\n\n"
+        while True:
+            try:
+                ev = await asyncio.to_thread(out_q.get, True, 1.0)
+            except Exception:
+                continue
+            kind = ev.get("kind")
+            if kind == "_done":
+                break
+            yield f"event: {kind}\ndata: {json.dumps(ev, default=str)}\n\n"
+        yield "event: done\ndata: {}\n\n"
+
+    return StreamingResponse(event_stream(), media_type="text/event-stream",
+                             headers={"Cache-Control": "no-cache",
+                                      "X-Accel-Buffering": "no"})
+
+
+@app.get("/api/agent/plan")
+def api_agent_plan(q: str):
+    """Just the plan, no execution. Useful for showing the agent's routing
+    decision before running specialists."""
+    from app.planner import plan as run_planner
+    p = run_planner(q)
+    return JSONResponse({
+        "intent":      p.intent,
+        "targets":     p.targets,
+        "specialists": p.specialists,
+        "rationale":   p.rationale,
+    })
+
+
+@app.get("/api/layers/nta")
+def layer_nta(code: str):
+    """Return the NTA polygon for a given NTA code as GeoJSON (EPSG:4326)."""
+    from app.areas import nta as nta_mod
+    g = nta_mod.load()
+    sub = g[g["nta2020"] == code][["nta2020", "ntaname", "boroname", "geometry"]]
+    if sub.empty:
+        return JSONResponse({"type": "FeatureCollection", "features": []}, status_code=404)
+    return JSONResponse(_json.loads(sub.to_json()),
+                        headers={"Cache-Control": "public, max-age=3600"})
+
+
+@app.get("/api/layers/sandy_clipped")
+def layer_sandy_clipped(code: str):
+    """Sandy inundation polygons clipped to an NTA bbox + simplified.
+    Used by the agent map for neighborhood / development_check intents."""
+    from app.areas import nta as nta_mod
+    from app.flood_layers import sandy_inundation
+    poly = nta_mod.polygon_for(code)
+    if poly is None:
+        return JSONResponse({"type": "FeatureCollection", "features": []})
+    bounds = poly.bounds
+    cx, cy = (bounds[0] + bounds[2]) / 2, (bounds[1] + bounds[3]) / 2
+    # bbox half-extent in metres ~ half the polygon span × 111 km/deg
+    half_m = max((bounds[2] - bounds[0]), (bounds[3] - bounds[1])) / 2 * 111_000
+    return JSONResponse(_clip_simplify(sandy_inundation.load(), cy, cx, half_m * 1.2),
+                        headers={"Cache-Control": "public, max-age=600"})
+
+
+@app.get("/api/layers/dep_clipped")
+def layer_dep_clipped(code: str, scenario: str = "dep_extreme_2080"):
+    """DEP scenario polygons clipped to an NTA bbox + simplified."""
+    from app.areas import nta as nta_mod
+    from app.flood_layers import dep_stormwater
+    poly = nta_mod.polygon_for(code)
+    if poly is None:
+        return JSONResponse({"type": "FeatureCollection", "features": []})
+    bounds = poly.bounds
+    cx, cy = (bounds[0] + bounds[2]) / 2, (bounds[1] + bounds[3]) / 2
+    half_m = max((bounds[2] - bounds[0]), (bounds[3] - bounds[1])) / 2 * 111_000
+    return JSONResponse(_clip_simplify(dep_stormwater.load(scenario), cy, cx, half_m * 1.2,
+                                        props_keep={"Flooding_Category"}),
+                        headers={"Cache-Control": "public, max-age=600"})
+
+
 @app.get("/api/layers/sandy")
 def layer_sandy(lat: float, lon: float, r: float = 1500):
     key = ("sandy", round(lat, 4), round(lon, 4), int(r))

web/static/agent.html

@@ -0,0 +1,523 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Riprap — agent</title>
+<link rel="stylesheet" href="https://unpkg.com/maplibre-gl@4.7.1/dist/maplibre-gl.css">
+<link rel="stylesheet" href="/static/style.css">
+<style>
+.agent-topbar-bar {
+  max-width: 1640px; margin: 14px auto 8px; padding: 0 20px;
+  display: flex; gap: 8px; align-items: center;
+}
+.agent-input-form {
+  flex: 1; display: flex; gap: 8px;
+  border: 1px solid var(--line); border-radius: 4px;
+  background: var(--panel); padding: 6px;
+}
+.agent-input-form input {
+  flex: 1; border: 0; outline: 0; padding: 10px 12px;
+  font-size: 14.5px; background: transparent; color: var(--text);
+  font-family: inherit;
+}
+.agent-input-form button {
+  padding: 8px 18px; border: 0; border-radius: 3px;
+  background: var(--nyc-blue); color: #fff; font-weight: 600;
+  cursor: pointer; font-size: 13px; font-family: inherit;
+}
+.agent-input-form button:disabled { opacity: 0.6; cursor: wait; }
+
+/* Mellea compliance badge in the briefing header */
+.mellea-badge {
+  display: inline-block; margin-left: 8px;
+  padding: 2px 9px; border-radius: 999px;
+  font-size: 10.5px; font-weight: 700;
+  font-family: var(--mono); letter-spacing: 0.03em;
+  vertical-align: middle;
+  color: white;
+  /* Bloom in once when the badge is rendered. transform-origin keeps the
+     scale anchored at the left edge so it doesn't push neighbors. */
+  animation: mellea-bloom 380ms cubic-bezier(.2,.7,.3,1.4);
+  transform-origin: left center;
+}
+@keyframes mellea-bloom {
+  0%   { transform: scale(0.5); opacity: 0; }
+  60%  { transform: scale(1.08); opacity: 1; }
+  100% { transform: scale(1); opacity: 1; }
+}
+/* Inline banner that appears between the briefing header and the prose
+   when Mellea is about to reroll (or when it confirms first-try pass). */
+.mellea-banner {
+  margin: 0 16px 8px; padding: 8px 12px;
+  border-radius: 4px; font-size: 11.5px;
+  font-family: var(--mono);
+  border: 1px solid transparent;
+  animation: mellea-bloom 280ms cubic-bezier(.2,.7,.3,1.1);
+  transform-origin: left center;
+}
+.mellea-banner.reroll {
+  background: rgba(217, 119, 6, 0.10);
+  border-color: rgba(217, 119, 6, 0.35);
+  color: #92400e;
+}
+.mellea-banner.pass {
+  background: rgba(26, 135, 84, 0.10);
+  border-color: rgba(26, 135, 84, 0.35);
+  color: #1a5e3a;
+}
+.mellea-banner code {
+  background: rgba(0,0,0,0.06); padding: 1px 5px; border-radius: 3px;
+  font-size: 10.5px;
+}
+.mellea-badge.full { background: #1a8754; }    /* 4/4 */
+.mellea-badge.partial { background: #d97706; } /* 1-3/4 */
+.mellea-badge.none { background: var(--nyc-scarlet); } /* 0/4 */
+.mellea-badge .ico { font-size: 9px; margin-right: 3px; }
+.agent-samples {
+  max-width: 1640px; margin: 4px auto 12px; padding: 0 20px;
+  display: flex; flex-wrap: wrap; gap: 8px;
+}
+.agent-samples .label {
+  font-size: 11px; color: var(--text-muted);
+  letter-spacing: 0.05em; text-transform: uppercase;
+  align-self: center; margin-right: 4px;
+}
+.sample-btn {
+  display: inline-flex; align-items: center; gap: 6px;
+  padding: 6px 11px; border: 1px solid var(--line);
+  background: var(--panel); border-radius: 999px;
+  font-size: 12px; color: var(--text); cursor: pointer;
+  font-family: inherit;
+  transition: background 0.12s, border-color 0.12s;
+}
+.sample-btn:hover { background: var(--bg-soft); border-color: var(--nyc-blue); }
+.sample-btn .pill {
+  padding: 1px 7px; border-radius: 999px;
+  font-size: 9.5px; font-weight: 700;
+  letter-spacing: 0.05em; text-transform: uppercase;
+}
+.sample-btn .pill.live { background: #1a8754;     color: white; }
+.sample-btn .pill.addr { background: #6b7280;     color: white; }
+.sample-btn .pill.nbhd { background: #1642DF;     color: white; }
+.sample-btn .pill.dev  { background: #af3a03;     color: white; }
+.sample-btn .qtxt {
+  white-space: nowrap; overflow: hidden;
+  text-overflow: ellipsis; max-width: 280px;
+}
+
+/* ---- planner box (full-width above the 3 panels) ---- */
+.planner-row {
+  max-width: 1640px; margin: 0 auto 12px; padding: 0 20px;
+}
+.planner-box {
+  background: var(--bg-soft); border: 1px solid var(--line);
+  border-radius: 4px; padding: 10px 14px;
+  display: grid; grid-template-columns: max-content 1fr; gap: 4px 12px;
+  font-size: 12px;
+}
+.planner-key {
+  color: var(--text-muted); font-weight: 700;
+  text-transform: uppercase; font-size: 10px; letter-spacing: 0.06em;
+}
+.planner-val { font-family: var(--mono); font-size: 11.5px; }
+.planner-rationale {
+  grid-column: 1 / -1;
+  color: var(--text-muted); font-style: italic; margin-top: 4px; font-size: 11.5px;
+}
+.intent-pill {
+  display: inline-block; padding: 1px 9px; border-radius: 999px;
+  background: var(--nyc-blue); color: white; font-size: 10px; font-weight: 700;
+  text-transform: uppercase; letter-spacing: 0.05em;
+}
+.intent-pill.dev   { background: #af3a03; }
+.intent-pill.live  { background: #1a8754; }
+.intent-pill.nbhd  { background: #1642DF; }
+.intent-pill.addr  { background: #6b7280; }
+
+/* ---- loading skeletons ---- */
+@keyframes pulse {
+  0%, 100% { background-color: var(--bg-soft); }
+  50%      { background-color: rgba(22, 66, 223, 0.08); }
+}
+.skel {
+  background: var(--bg-soft); border-radius: 3px;
+  animation: pulse 1.6s ease-in-out infinite;
+}
+.skel-line { height: 12px; margin: 6px 0; }
+.skel-line.w-100 { width: 100%; }
+.skel-line.w-80  { width: 80%; }
+.skel-line.w-60  { width: 60%; }
+.skel-line.w-40  { width: 40%; }
+.skel-pad { padding: 14px 16px; }
+
+.loading-overlay {
+  position: relative;
+  pointer-events: none;
+}
+.loading-overlay::after {
+  content: ""; position: absolute; inset: 0;
+  background: rgba(255,255,255,0.55);
+  backdrop-filter: blur(0.5px);
+}
+
+.map-loading {
+  position: absolute; left: 50%; top: 50%;
+  transform: translate(-50%, -50%);
+  background: var(--panel); border: 1px solid var(--line);
+  border-radius: 4px; padding: 8px 14px;
+  font-size: 11.5px; color: var(--text-muted);
+  z-index: 10; pointer-events: none;
+  display: flex; align-items: center; gap: 8px;
+}
+.map-loading .dot {
+  width: 6px; height: 6px; border-radius: 50%;
+  background: var(--nyc-blue);
+  animation: dotpulse 1.2s ease-in-out infinite;
+}
+@keyframes dotpulse {
+  0%, 100% { opacity: 0.3; transform: scale(0.85); }
+  50%      { opacity: 1;   transform: scale(1.1); }
+}
+
+/* ---- map legend (intent-aware) ---- */
+.map-legend {
+  position: absolute; left: 10px; bottom: 10px;
+  background: rgba(255,255,255,0.95);
+  border: 1px solid var(--line); border-radius: 4px;
+  padding: 8px 12px; font-size: 11px; color: var(--text);
+  box-shadow: 0 2px 6px rgba(0,0,0,0.06);
+  pointer-events: none;
+  z-index: 5;
+}
+.map-legend .legend-row { display: flex; align-items: center; gap: 6px; margin: 2px 0; }
+.legend-swatch {
+  width: 12px; height: 12px; border-radius: 50%;
+  border: 1.5px solid #fff; box-shadow: 0 0 0 1px rgba(0,0,0,0.08);
+}
+.legend-swatch.fill {
+  width: 14px; height: 10px; border-radius: 2px; box-shadow: none; border: 0;
+}
+
+/* ---- briefing header (matches the report-head idiom from /) ---- */
+.brief-head {
+  padding: 14px 16px;
+  border-bottom: 1px solid var(--line);
+  background: linear-gradient(180deg, var(--bg-soft) 0%, #fff 100%);
+}
+.brief-eyebrow {
+  font-size: 10px; font-weight: 700;
+  letter-spacing: 0.10em; text-transform: uppercase;
+  color: var(--nyc-blue);
+}
+.brief-title {
+  margin-top: 4px;
+  font-size: 16px; font-weight: 600;
+  line-height: 1.25; color: var(--text);
+}
+.brief-meta {
+  margin-top: 6px;
+  font-family: var(--mono); font-size: 11px;
+  color: var(--text-muted);
+  display: flex; flex-wrap: wrap; gap: 4px 10px;
+}
+.brief-meta-k {
+  text-transform: uppercase; font-size: 9.5px;
+  letter-spacing: 0.05em; color: var(--text-faint);
+}
+.brief-meta-v { color: var(--text); }
+
+.report-btn {
+  display: none;  /* shown by JS once a query completes */
+  margin-top: 10px; padding: 6px 12px;
+  border: 1px solid var(--nyc-blue);
+  background: var(--panel); color: var(--nyc-blue);
+  border-radius: 3px; cursor: pointer; font-size: 12px;
+  font-weight: 600; font-family: inherit;
+  transition: background 0.12s, color 0.12s;
+}
+.report-btn:hover { background: var(--nyc-blue); color: white; }
+.report-btn.ready { display: inline-block; }
+
+/* tier badge inline with the title — single_address intent only.
+   Mirrors the colour idiom from the legacy /single page tier-badge. */
+.tier-chip {
+  display: inline-block;
+  margin-left: 8px;
+  padding: 2px 10px;
+  border-radius: 999px;
+  font-size: 11px; font-weight: 700;
+  font-family: var(--mono); letter-spacing: 0.04em;
+  vertical-align: middle;
+  color: white;
+}
+.tier-chip.t-0 { background: var(--good); }
+.tier-chip.t-1 { background: var(--nyc-scarlet); }
+.tier-chip.t-2 { background: #d97706; }
+.tier-chip.t-3 { background: #ca8a04; }
+.tier-chip.t-4 { background: var(--nyc-blue); }
+.tier-floor {
+  font-size: 9.5px; font-weight: 600;
+  background: rgba(255,255,255,0.22);
+  padding: 1px 5px; border-radius: 6px; margin-left: 4px;
+}
+
+/* ---- streaming caret on the briefing while tokens flow ---- */
+.streaming::after {
+  content: "▋";
+  display: inline-block; color: var(--nyc-blue);
+  margin-left: 2px;
+  animation: caret 0.9s steps(1) infinite;
+}
+
+/* ---- citation chips + Sources footer ---- */
+.report-pane #paragraph .cite {
+  cursor: pointer;
+  transition: background 0.15s, color 0.15s;
+}
+.report-pane #paragraph .cite:hover,
+.report-pane #paragraph .cite.hl {
+  background: var(--nyc-blue) !important;
+  color: white !important;
+}
+#sourcesSection {
+  border-top: 1px solid var(--line);
+  background: var(--bg-soft);
+  padding: 12px 16px 14px;
+}
+#sourcesSection .src-h {
+  font-size: 10px; font-weight: 700;
+  text-transform: uppercase; letter-spacing: 0.10em;
+  color: var(--text-muted);
+  margin: 0 0 8px;
+}
+#sourcesSection ol {
+  margin: 0; padding: 0; list-style: none;
+  display: grid; gap: 6px;
+  font-size: 11.5px; line-height: 1.45;
+}
+#sourcesSection ol li {
+  display: grid; grid-template-columns: 22px 1fr;
+  gap: 8px; align-items: baseline;
+  padding: 4px 6px; border-radius: 3px;
+  transition: background 0.15s;
+}
+#sourcesSection ol li.hl { background: rgba(22, 66, 223, 0.10); }
+#sourcesSection .src-num {
+  font-family: var(--mono); font-size: 10.5px;
+  font-weight: 700; color: var(--nyc-blue);
+  text-align: right;
+}
+#sourcesSection .src-label { color: var(--text); }
+#sourcesSection .src-link {
+  color: var(--text); text-decoration: none;
+  border-bottom: 1px dotted var(--text-muted);
+  transition: color 0.12s, border-color 0.12s;
+}
+#sourcesSection .src-link:hover {
+  color: var(--nyc-blue);
+  border-bottom-color: var(--nyc-blue);
+}
+#sourcesSection .src-ext {
+  font-size: 9.5px; color: var(--text-faint);
+  margin-left: 2px; vertical-align: super;
+}
+#sourcesSection .src-id {
+  font-family: var(--mono); font-size: 10px;
+  color: var(--text-faint); margin-left: 6px;
+}
+
+/* live-streaming planner output (raw JSON forming character-by-character) */
+.planner-streaming {
+  background: var(--bg-soft); border: 1px solid var(--line);
+  border-radius: 4px; padding: 10px 14px;
+  font-family: var(--mono); font-size: 11px; color: var(--text-muted);
+  line-height: 1.5; white-space: pre-wrap; word-break: break-word;
+  max-height: 160px; overflow: auto;
+  position: relative;
+}
+.planner-streaming::before {
+  content: "Planner thinking…";
+  position: absolute; top: 6px; right: 10px;
+  font-family: inherit; font-size: 9.5px;
+  color: var(--text-faint); letter-spacing: 0.06em;
+  text-transform: uppercase;
+}
+.planner-streaming::after {
+  content: "▋";
+  display: inline-block; color: var(--nyc-blue);
+  animation: caret 0.9s steps(1) infinite;
+}
+@keyframes caret { 50% { opacity: 0; } }
+
+#map { width: 100%; height: 600px; border: 1px solid var(--line); border-radius: 4px; }
+
+/* ---- structured report ---- */
+.report-pane #paragraph .rsum-h {
+  margin: 12px 0 6px; font-size: 10.5px; font-weight: 700;
+  text-transform: uppercase; letter-spacing: 0.08em; color: var(--text-muted);
+}
+.report-pane #paragraph .rsum-h:first-child { margin-top: 0; }
+.report-pane #paragraph .rsum-p { margin: 0 0 6px; line-height: 1.55; font-size: 13px; }
+.report-pane #paragraph .rsum-list { margin: 4px 0 8px 0; padding: 0; list-style: none; }
+.report-pane #paragraph .rsum-list li {
+  display: block; padding: 8px 10px; margin: 4px 0;
+  background: var(--bg-soft); border-left: 3px solid var(--nyc-blue);
+  border-radius: 0 3px 3px 0; font-size: 12.5px; line-height: 1.5;
+}
+.report-pane #paragraph strong {
+  font-weight: 600;
+  background: linear-gradient(transparent 60%, var(--nyc-blue-soft) 60%);
+  padding: 0 2px;
+}
+.report-pane #paragraph .cite {
+  display: inline-block; vertical-align: super; font-size: 9.5px;
+  font-family: var(--mono); padding: 0 5px; margin-left: 2px;
+  background: var(--bg-soft); border-radius: 8px;
+  color: var(--text-muted);
+}
+
+/* ---- intent-specific facts panel ---- */
+.facts-grid {
+  display: grid; grid-template-columns: 1fr 1fr; gap: 6px 14px;
+  margin: 8px 0; font-size: 12px;
+}
+.facts-grid dt {
+  color: var(--text-muted); font-size: 10.5px;
+  text-transform: uppercase; letter-spacing: 0.05em; font-weight: 700;
+}
+.facts-grid dd { margin: 0; font-family: var(--mono); }
+.headline-stat {
+  font-size: 26px; font-weight: 700; color: var(--text);
+  margin: 6px 0 2px; line-height: 1.1;
+}
+.headline-sub {
+  color: var(--text-muted); font-size: 12px; margin-bottom: 8px;
+}
+</style>
+</head>
+<body>
+<header class="topbar">
+  <div class="topbar-inner">
+    <div class="brand">
+      <span class="brand-name">Riprap</span>
+      <span class="brand-sep">·</span>
+      <span class="brand-tag">citation-grounded flood-exposure briefings for NYC</span>
+    </div>
+    <div class="topbar-right">
+      <span id="backendPill" class="local-pill" data-state="loading"
+            title="Granite 4.1 inference. No vendor LLM is contacted.">
+        <span class="dot"></span><span id="backendPillText">checking…</span>
+      </span>
+    </div>
+  </div>
+</header>
+
+<div class="agent-topbar-bar">
+  <form id="agentForm" class="agent-input-form" autocomplete="off">
+    <input id="q" type="text" placeholder="Ask anything: an address, a neighborhood, 'what are they building in Gowanus', 'is there flooding right now'…" autofocus />
+    <button type="submit" id="goBtn">Ask</button>
+  </form>
+</div>
+
+<div class="agent-samples">
+  <span class="label">Try:</span>
+  <!-- Defaults chosen by a 16-query sweep across NYC; ranked by
+       (map-layers populated, unique-citations, latency).
+       See /tmp/sweep-out.log for the full ranking. -->
+  <button class="sample-btn" data-q="2940 Brighton 3rd St, Brooklyn"
+          title="single_address — 5 map layers + 8 cites; coastal Sandy + DEP + 311 + FloodNet + Ida HWMs + NOAA gauge + TerraMind LULC">
+    <span class="pill addr">address</span><span class="qtxt">2940 Brighton 3rd St (coastal)</span>
+  </button>
+  <button class="sample-btn" data-q="180-08 Hillside Ave, Jamaica, NY"
+          title="single_address — 5 layers + 7 cites; Jamaica/Hollis pluvial-inland pattern">
+    <span class="pill addr">address</span><span class="qtxt">Hillside Ave, Jamaica (pluvial)</span>
+  </button>
+  <button class="sample-btn" data-q="100 Gold St Manhattan"
+          title="single_address — 4 layers + 7 cites; Lower Manhattan dense urban">
+    <span class="pill addr">address</span><span class="qtxt">100 Gold St (Manhattan)</span>
+  </button>
+  <button class="sample-btn" data-q="Far Rockaway"
+          title="neighborhood — 7 unique cites; coastal Queens NTA polygon scope">
+    <span class="pill nbhd">neighborhood</span><span class="qtxt">Far Rockaway</span>
+  </button>
+  <button class="sample-btn" data-q="Gowanus"
+          title="neighborhood — 6 cites; combined-sewer / pluvial Brooklyn">
+    <span class="pill nbhd">neighborhood</span><span class="qtxt">Gowanus</span>
+  </button>
+  <button class="sample-btn" data-q="is there flooding right now in NYC"
+          title="live_now — fast (~13 s); NWS alerts + NOAA tides + TTM surge nowcast">
+    <span class="pill live">live</span><span class="qtxt">flooding right now in NYC</span>
+  </button>
+</div>
+
+<div class="planner-row" id="plannerRow"></div>
+
+<div class="workbench">
+  <aside class="col-left">
+    <section class="panel">
+      <h2>Specialist trace <span class="hint" id="traceMeta"></span></h2>
+      <r-trace id="steps"></r-trace>
+      <div id="traceSkel" class="skel-pad" style="display:none">
+        <div class="skel skel-line w-80"></div>
+        <div class="skel skel-line w-60"></div>
+        <div class="skel skel-line w-100"></div>
+        <div class="skel skel-line w-40"></div>
+      </div>
+    </section>
+  </aside>
+
+  <main class="col-mid">
+    <div id="map-card" class="panel panel-map" style="position:relative">
+      <div id="map"></div>
+      <div id="mapLoading" class="map-loading" style="display:none">
+        <span class="dot"></span><span id="mapLoadingText">Resolving location…</span>
+      </div>
+      <div id="mapLegend" class="map-legend" style="display:none"></div>
+    </div>
+    <section class="panel" id="factsPanel" style="display:none">
+      <h2 id="factsTitle">Findings</h2>
+      <div id="factsBody" style="padding: 12px 16px;"></div>
+    </section>
+  </main>
+
+  <aside class="col-right">
+    <section class="panel report-pane" id="reportPanel" style="display:none">
+      <header class="brief-head" id="briefHead">
+        <div class="brief-eyebrow" id="briefEyebrow">Briefing</div>
+        <div class="brief-title" id="briefTitle">—</div>
+        <div class="brief-meta" id="briefMeta"></div>
+        <button id="reportBtn" class="report-btn" title="Open a print-ready PDF-formatted report of this query in a new tab">
+          ↗ Generate auditable report
+        </button>
+      </header>
+      <div id="melleaBanner" class="mellea-banner" style="display:none"></div>
+      <r-briefing id="paragraph" style="display:block; padding: 14px 16px 18px;"></r-briefing>
+      <r-sources-footer id="sourcesFooter" hidden></r-sources-footer>
+    </section>
+    <section class="panel" id="reportSkel" style="display:none">
+      <header class="brief-head">
+        <div class="brief-eyebrow">Mellea is validating the briefing</div>
+        <div class="brief-title" style="color:var(--text-muted)">Granite drafts → 4 grounding requirements → reroll if any fail…</div>
+      </header>
+      <div class="skel-pad">
+        <div class="skel skel-line w-40" style="height:10px"></div>
+        <div class="skel skel-line w-100"></div>
+        <div class="skel skel-line w-100"></div>
+        <div class="skel skel-line w-80"></div>
+        <div class="skel skel-line w-40" style="height:10px; margin-top:14px"></div>
+        <div class="skel skel-line w-100"></div>
+        <div class="skel skel-line w-60"></div>
+      </div>
+    </section>
+  </aside>
+</div>
+
+<script src="https://unpkg.com/maplibre-gl@4.7.1/dist/maplibre-gl.js"></script>
+<!-- Svelte custom-element bundle — registers <r-briefing>, <r-trace>,
+     <r-sources-footer>. agent.js sets properties on these tags exactly
+     as before; Svelte just owns the implementation now. -->
+<script type="module" src="/static/dist/riprap.js"></script>
+<script src="/static/agent.js"></script>
+</body>
+</html>

web/static/agent.js

@@ -0,0 +1,1391 @@
+// Riprap agent client — three-panel UI with live SSE streaming, intent-
+// dispatched map, and structured report rendering.
+
+const $ = (s) => document.querySelector(s);
+
+const STEP_LABELS = {
+  // single_address chain (linear FSM)
+  geocode:                ["Geocode (DCP Geosearch)",          "address → lat/lon, BBL"],
+  sandy_inundation:       ["Sandy Inundation (NYC OD)",        "empirical 2012 extent"],
+  dep_stormwater:         ["DEP Stormwater Maps",              "pluvial scenarios + 2080 SLR"],
+  floodnet:               ["FloodNet sensor network",          "live ultrasonic depth sensors"],
+  nyc311:                 ["NYC 311 archive",                  "flood complaints in 200m"],
+  noaa_tides:             ["NOAA Tides & Currents (live)",     "Battery / Kings Pt / Sandy Hook"],
+  nws_alerts:             ["NWS Public Alerts (live)",         "active flood-relevant alerts"],
+  nws_obs:                ["NWS METAR observation (live)",     "nearest ASOS recent precipitation"],
+  ttm_forecast:           ["Granite TTM r2 — surge nowcast",   "9.6h forecast at the closest of Battery / Kings Pt / Sandy Hook"],
+  ttm_311_forecast:       ["Granite TTM r2 — 311 forecast",    "4-week per-address flood-complaint forecast (52w history)"],
+  floodnet_forecast:      ["Granite TTM r2 — FloodNet forecast", "flood-event recurrence forecast at nearest FloodNet sensor"],
+  mta_entrance_exposure:  ["MTA subway entrances",              "subway-entrance exposure (point-in-polygon Sandy + DEP)"],
+  nycha_development_exposure: ["NYCHA developments",            "NYCHA campus footprint × Sandy + DEP overlap %"],
+  doe_school_exposure:    ["NYC DOE schools",                   "school-point exposure (Sandy + DEP)"],
+  doh_hospital_exposure:  ["NYS DOH hospitals",                 "Article-28 hospital exposure (Sandy + DEP)"],
+  microtopo_lidar:        ["LiDAR terrain (DEM + TWI + HAND)", "USGS 3DEP DEM + whitebox-workflows"],
+  ida_hwm_2021:           ["Ida 2021 high-water marks",        "USGS empirical post-event extent"],
+  prithvi_eo_v2:          ["Prithvi-EO 2.0 (NASA/IBM)",        "Sen1Floods11 satellite segmentation"],
+  prithvi_eo_live:        ["Prithvi-EO 2.0 — live segmentation","fresh Sentinel-2 water mask at this address"],
+  terramind_synthesis:    ["TerraMind 1.0 base — synthetic LULC",   "DEM → ESRI Land Cover, any-to-any generative synthesis (IBM/ESA)"],
+  rag_granite_embedding:  ["Granite Embedding 278M (RAG)",     "policy corpus retrieval (+ Granite Reranker R2 if enabled)"],
+  gliner_extract:         ["GLiNER typed extraction",          "agencies, dollar amounts, projects, locations"],
+  reconcile_granite41:    ["Granite 4.1 reconcile (local)",    "document-grounded synthesis"],
+  // neighborhood + dev_check
+  nta_resolve:            ["NTA polygon resolve",              "name → NYC NTA 2020 polygon"],
+  sandy_nta:              ["Sandy 2012, polygon-aggregated",   "% of NTA inside 2012 inundation"],
+  dep_extreme_2080_nta:   ["DEP Extreme-2080, polygon",        "% of NTA in modeled flooding"],
+  dep_moderate_2050_nta:  ["DEP Moderate-2050, polygon",       "% of NTA in modeled flooding"],
+  dep_moderate_current_nta:["DEP Moderate-current, polygon",   "% of NTA in modeled flooding"],
+  nyc311_nta:             ["NYC 311, polygon-aggregated",      "complaints inside polygon"],
+  microtopo_nta:          ["LiDAR terrain, polygon",           "median HAND/TWI + flood bands"],
+  rag_nta:                ["Granite Embedding RAG (NTA)",      "policy retrieval for the place"],
+  reconcile_neighborhood: ["Granite 4.1 reconcile (NTA)",      "polygon-flavored briefing"],
+  // dev_check
+  dob_permits_nta:        ["NYC DOB permits in polygon",       "active NB / A1 / DM jobs ↔ flood layers"],
+  rag_dev:                ["Granite Embedding RAG (dev)",      "policy on new construction in flood zones"],
+  reconcile_development:  ["Granite 4.1 reconcile (dev)",      "flagged-projects briefing"],
+  // live_now
+  reconcile_live_now:     ["Granite 4.1 reconcile (live)",     "current-conditions briefing"],
+};
+
+const SOURCE_LABELS = {
+  geocode: "NYC DCP Geosearch",
+  nta_resolve: "NYC DCP Neighborhood Tabulation Areas 2020",
+  sandy: "NYC OD 5xsi-dfpx — Sandy 2012 inundation",
+  sandy_nta: "Sandy 2012 inundation, polygon-aggregated",
+  dep_extreme_2080: "NYC DEP Stormwater — Extreme-2080",
+  dep_moderate_2050: "NYC DEP Stormwater — Moderate-2050",
+  dep_moderate_current: "NYC DEP Stormwater — Moderate-current",
+  dep_extreme_2080_nta: "NYC DEP Extreme-2080, polygon-aggregated",
+  dep_moderate_2050_nta: "NYC DEP Moderate-2050, polygon-aggregated",
+  dep_moderate_current_nta: "NYC DEP Moderate-current, polygon-aggregated",
+  floodnet: "FloodNet NYC",
+  nyc311: "NYC 311 (erm2-nwe9)",
+  nyc311_nta: "NYC 311, polygon-aggregated",
+  microtopo: "USGS 3DEP DEM",
+  microtopo_nta: "USGS 3DEP DEM, polygon-aggregated",
+  ida_hwm: "USGS Hurricane Ida 2021 HWMs",
+  prithvi_water: "Prithvi-EO 2.0 — Hurricane Ida 2021 polygons",
+  prithvi_live:  "Prithvi-EO 2.0 ��� live Sentinel-2 water segmentation",
+  terramind_synthetic: "TerraMind 1.0 base — synthetic LULC (DEM→ESRI Land Cover)",
+  gliner_comptroller: "GLiNER over Comptroller report",
+  gliner_dep_2013:    "GLiNER over DEP wastewater plan",
+  gliner_nycha:       "GLiNER over NYCHA Lessons Learned",
+  gliner_mta:         "GLiNER over MTA Climate Resilience Roadmap",
+  gliner_coned:       "GLiNER over Con Edison Climate Resilience",
+  noaa_tides: "NOAA CO-OPS Tides & Currents",
+  nws_alerts: "NWS Public Alerts",
+  nws_obs: "NWS Station Observations",
+  ttm_forecast: "Granite TimeSeries TTM r2 — surge residual nowcast",
+  ttm_311_forecast: "Granite TimeSeries TTM r2 — per-address 311 weekly forecast",
+  floodnet_forecast: "Granite TimeSeries TTM r2 — FloodNet sensor recurrence forecast",
+  dob_permits: "NYC DOB Permit Issuance (Socrata ipu4-2q9a)",
+  live_target: "Riprap planner — live target",
+  rag_comptroller: 'NYC Comptroller — "Is NYC Ready for Rain?" (2024)',
+  rag_npcc4: "NPCC4 (2024)",
+  rag_mta: "MTA Climate Resilience Roadmap",
+  rag_nycha: "NYCHA Flood Resilience: Lessons Learned",
+  rag_coned: "Con Edison Climate Resilience Plan",
+  // Register-specialist family labels — chip lookups for dynamic
+  // doc_ids (mta_entrance_<id>, nycha_dev_<tds>, doe_school_<loc>,
+  // nyc_hospital_<fac>) fall through to these via family-prefix match.
+  mta_entrance: "MTA subway-entrance exposure (Open Data)",
+  nycha_dev:    "NYCHA development exposure (NYC OD phvi-damg)",
+  doe_school:   "NYC DOE school exposure",
+  nyc_hospital: "NYS DOH hospital exposure (vn5v-hh5r)",
+};
+
+// Canonical URL per doc_id — clicking a source row opens the underlying
+// dataset / API / report in a new tab so users can verify provenance.
+const SOURCE_URLS = {
+  geocode:                "https://geosearch.planninglabs.nyc/",
+  nta_resolve:            "https://www.nyc.gov/site/planning/data-maps/open-data/dwn-nynta.page",
+  sandy:                  "https://data.cityofnewyork.us/Environment/Sandy-Inundation-Zone/uyj8-7rv5",
+  sandy_nta:              "https://data.cityofnewyork.us/Environment/Sandy-Inundation-Zone/uyj8-7rv5",
+  dep_extreme_2080:       "https://data.cityofnewyork.us/Environment/NYC-Stormwater-Flood-Map-Extreme-Flood-with-Curren/w8eg-8ha6",
+  dep_moderate_2050:      "https://data.cityofnewyork.us/Environment/NYC-Stormwater-Flood-Map-Moderate-Flood-with-Curre/9i7c-xyvv",
+  dep_moderate_current:   "https://data.cityofnewyork.us/Environment/NYC-Stormwater-Flood-Map-Moderate-Flood/5rzh-cyqd",
+  dep_extreme_2080_nta:   "https://data.cityofnewyork.us/Environment/NYC-Stormwater-Flood-Map-Extreme-Flood-with-Curren/w8eg-8ha6",
+  dep_moderate_2050_nta:  "https://data.cityofnewyork.us/Environment/NYC-Stormwater-Flood-Map-Moderate-Flood-with-Curre/9i7c-xyvv",
+  dep_moderate_current_nta: "https://data.cityofnewyork.us/Environment/NYC-Stormwater-Flood-Map-Moderate-Flood/5rzh-cyqd",
+  floodnet:               "https://www.floodnet.nyc/",
+  nyc311:                 "https://data.cityofnewyork.us/Social-Services/311-Service-Requests-from-2010-to-Present/erm2-nwe9",
+  nyc311_nta:             "https://data.cityofnewyork.us/Social-Services/311-Service-Requests-from-2010-to-Present/erm2-nwe9",
+  microtopo:              "https://www.usgs.gov/3d-elevation-program",
+  microtopo_nta:          "https://www.usgs.gov/3d-elevation-program",
+  ida_hwm:                "https://stn.wim.usgs.gov/STNDataPortal/",
+  prithvi_water:          "https://huggingface.co/ibm-nasa-geospatial/Prithvi-EO-2.0-300M-TL-Sen1Floods11",
+  prithvi_live:           "https://huggingface.co/ibm-nasa-geospatial/Prithvi-EO-2.0-300M-TL-Sen1Floods11",
+  terramind_synthetic:    "https://huggingface.co/ibm-esa-geospatial/TerraMind-1.0-base",
+  gliner_comptroller:     "https://huggingface.co/urchade/gliner_medium-v2.1",
+  gliner_dep_2013:        "https://huggingface.co/urchade/gliner_medium-v2.1",
+  gliner_nycha:           "https://huggingface.co/urchade/gliner_medium-v2.1",
+  gliner_mta:             "https://huggingface.co/urchade/gliner_medium-v2.1",
+  gliner_coned:           "https://huggingface.co/urchade/gliner_medium-v2.1",
+  noaa_tides:             "https://tidesandcurrents.noaa.gov/",
+  nws_alerts:             "https://www.weather.gov/documentation/services-web-api",
+  nws_obs:                "https://www.weather.gov/documentation/services-web-api",
+  ttm_forecast:           "https://huggingface.co/ibm-granite/granite-timeseries-ttm-r2",
+  ttm_311_forecast:       "https://huggingface.co/ibm-granite/granite-timeseries-ttm-r2",
+  floodnet_forecast:      "https://huggingface.co/ibm-granite/granite-timeseries-ttm-r2",
+  dob_permits:            "https://data.cityofnewyork.us/Housing-Development/DOB-Permit-Issuance/ipu4-2q9a",
+  rag_comptroller:        "https://comptroller.nyc.gov/reports/is-new-york-city-ready-for-rain/",
+  rag_npcc4:              "https://nyaspubs.onlinelibrary.wiley.com/toc/17496632/2024/1539/1",
+  rag_mta:                "https://new.mta.info/sustainability/climate-resilience",
+  rag_nycha:              "https://www.nyc.gov/site/nycha/about/sustainability.page",
+  rag_coned:              "https://www.coned.com/en/our-energy-future/climate-change-resilience",
+  mta_entrance:           "https://data.ny.gov/Transportation/MTA-Subway-Entrances-and-Exits-2024/i9wp-a4ja",
+  nycha_dev:              "https://data.cityofnewyork.us/Housing-Development/Map-of-NYCHA-Developments/i9rv-hdr5",
+  doe_school:             "https://data.cityofnewyork.us/Education/School-Locations/jfju-ynrr",
+  nyc_hospital:           "https://health.data.ny.gov/Health/Health-Facility-Certification-Information/2g9y-7kqm",
+};
+
+// Per-source vintage / "as of" — what date the underlying data represents.
+// For live sources, the answer is "live; observation timestamps in payload".
+// For archival sources, this is the dataset publication or extent date.
+const SOURCE_VINTAGES = {
+  geocode:                "live (NYC DCP Geosearch v2)",
+  nta_resolve:            "NYC NTA 2020 boundaries (DCP, Sept 2022 release)",
+  sandy:                  "Sandy 2012 inundation extent (NYC OEM survey, dataset published 2013)",
+  sandy_nta:              "Sandy 2012 inundation extent (polygon-aggregated)",
+  dep_extreme_2080:       "NYC DEP Stormwater Flood Map — Extreme + 2080 SLR (2021 release)",
+  dep_moderate_2050:      "NYC DEP Stormwater Flood Map — Moderate + 2050 SLR (2021 release)",
+  dep_moderate_current:   "NYC DEP Stormwater Flood Map — Moderate, current SLR (2021 release)",
+  dep_extreme_2080_nta:   "NYC DEP Extreme-2080 (2021 release; polygon-aggregated)",
+  dep_moderate_2050_nta:  "NYC DEP Moderate-2050 (2021 release; polygon-aggregated)",
+  dep_moderate_current_nta: "NYC DEP Moderate-current (2021 release; polygon-aggregated)",
+  floodnet:               "live FloodNet sensor stream (per-event timestamps in payload)",
+  nyc311:                 "live NYC 311 archive, trailing 5-year window (latest record in payload)",
+  nyc311_nta:             "live NYC 311 archive, trailing 3-year window (polygon-aggregated)",
+  microtopo:              "USGS 3DEP DEM (NYC LiDAR collect, ~2018) + derived HAND/TWI",
+  microtopo_nta:          "USGS 3DEP DEM (NYC ~2018) — polygon-aggregated stats",
+  ida_hwm:                "USGS Short-Term Network Event 312 — Hurricane Ida 2021 high-water marks (Sept 1-2 2021 survey)",
+  prithvi_water:          "Prithvi-EO 2.0 satellite segmentation, scenes 2021-08-25 (pre) & 2021-09-02 (post Ida)",
+  prithvi_live:           "live Sentinel-2 L2A scene from Microsoft Planetary Computer (acquisition timestamp in payload)",
+  terramind_synthetic:    "synthetic prior — TerraMind 1.0 base generated a plausible categorical land-cover map from the LiDAR terrain at this point (deterministic seed, 10 diffusion steps; class fractions cite-able; not a measurement)",
+  gliner_comptroller:     "GLiNER typed extraction over the Comptroller PDF (per-paragraph)",
+  gliner_dep_2013:        "GLiNER typed extraction over the DEP wastewater plan",
+  gliner_nycha:           "GLiNER typed extraction over the NYCHA Lessons Learned PDF",
+  gliner_mta:             "GLiNER typed extraction over the MTA Resilience Roadmap",
+  gliner_coned:           "GLiNER typed extraction over the Con Edison Climate Resilience plan",
+  noaa_tides:             "live NOAA CO-OPS, 6-min cadence (observation time in payload)",
+  nws_alerts:             "live NWS Public Alerts API (effective/expires in payload)",
+  nws_obs:                "live NWS hourly METAR observation (observation time in payload)",
+  ttm_forecast:           "live TTM forecast based on trailing 51 h at the closest NOAA gauge to this address (Battery / Kings Pt / Sandy Hook)",
+  ttm_311_forecast:       "live TTM forecast based on trailing 52 weeks of NYC 311 flood complaints within 200 m of this address",
+  floodnet_forecast:      "live TTM forecast based on the 512-day daily flood-event series at the nearest FloodNet sensor",
+  dob_permits:            "live NYC DOB Permit Issuance, trailing 18-month window (per-permit issuance dates in payload)",
+  rag_comptroller:        "NYC Comptroller report 'Is NYC Ready for Rain?' (2024)",
+  rag_npcc4:              "NPCC4 — NYC Climate Assessment 4th edition, Annals NYAS vol. 1539 (2024)",
+  rag_mta:                "MTA Climate Resilience Roadmap, October 2025 update",
+  rag_nycha:              "NYCHA Flood Resilience: Lessons Learned (post-Sandy)",
+  rag_coned:              "Con Edison Climate Change Resilience Plan, NY PSC Case 22-E-0222 (2023)",
+  scope_note:             "Riprap planner — geographic scope guard (this query)",
+  live_target:            "Riprap planner — live target (this query)",
+  mta_entrance:           "MTA Open Data subway-entrance geometry (refreshed monthly) joined to Sandy 2012 + DEP scenarios + USGS 3DEP DEM",
+  nycha_dev:              "NYC Open Data NYCHA Developments (phvi-damg) joined to Sandy 2012 + DEP scenarios + USGS 3DEP DEM",
+  doe_school:             "NYC DOE Locations Points (1992 schools) joined to Sandy 2012 + DEP scenarios + USGS 3DEP DEM",
+  nyc_hospital:           "NYS DOH Health Facility Certification (vn5v-hh5r, NYC counties + fac_desc_short=HOSP) joined to Sandy 2012 + DEP scenarios + USGS 3DEP DEM",
+};
+
+const INTENT_PILL_CLASS = {
+  development_check: "dev",
+  live_now: "live",
+  neighborhood: "nbhd",
+  single_address: "addr",
+};
+
+// ---------------------------------------------------------------------------
+// MAP
+// ---------------------------------------------------------------------------
+
+let map = null;
+let mapInit = false;
+
+function ensureMap() {
+  if (mapInit) return;
+  mapInit = true;
+  map = new maplibregl.Map({
+    container: "map",
+    style: {
+      version: 8,
+      // CARTO Voyager — more editorial typography + softer palette than
+      // Positron, no API key required. Retina (@2x) tiles for crisp type.
+      sources: {
+        basemap: {
+          type: "raster",
+          tiles: [
+            "https://a.basemaps.cartocdn.com/rastertiles/voyager/{z}/{x}/{y}@2x.png",
+            "https://b.basemaps.cartocdn.com/rastertiles/voyager/{z}/{x}/{y}@2x.png",
+            "https://c.basemaps.cartocdn.com/rastertiles/voyager/{z}/{x}/{y}@2x.png",
+            "https://d.basemaps.cartocdn.com/rastertiles/voyager/{z}/{x}/{y}@2x.png",
+          ],
+          tileSize: 256,
+          attribution: "© OpenStreetMap contributors © CARTO",
+        },
+      },
+      layers: [
+        { id: "bg",      type: "background", paint: { "background-color": "#f3f5f8" } },
+        { id: "basemap", type: "raster",     source: "basemap" },
+      ],
+    },
+    center: [-74.0, 40.72],
+    zoom: 10,
+    attributionControl: { compact: true },
+    // Required for map.getCanvas().toDataURL() to work on the report-export
+    // path. Otherwise the WebGL drawing buffer is cleared after each frame
+    // and snapshots come back blank.
+    preserveDrawingBuffer: true,
+  });
+  map.addControl(new maplibregl.NavigationControl({ visualizePitch: false }), "top-right");
+  map.on("load", initMapSources);
+}
+
+function initMapSources() {
+  // Sandy + DEP overlays (used for nbhd / dev_check)
+  map.addSource("sandy",   { type: "geojson", data: empty() });
+  map.addLayer({ id: "sandy-fill", type: "fill", source: "sandy",
+    paint: { "fill-color": "#fc5d52", "fill-opacity": 0.25 } });
+  map.addLayer({ id: "sandy-line", type: "line", source: "sandy",
+    paint: { "line-color": "#fc5d52", "line-width": 0.5, "line-opacity": 0.7 } });
+
+  map.addSource("dep",     { type: "geojson", data: empty() });
+  map.addLayer({ id: "dep-fill", type: "fill", source: "dep",
+    paint: {
+      "fill-color": ["match", ["get", "Flooding_Category"],
+        1, "#568adf", 2, "#1642DF", 3, "#031553", "#568adf"],
+      "fill-opacity": 0.32 } });
+
+  // Prithvi-EO 2.0 live water-segmentation polygons. Cyan to differ
+  // visually from Sandy (red) and DEP (blue) — this is *observed today*
+  // water from the latest cloud-free Sentinel-2 scene, not a modeled
+  // scenario. We outline + fill so even sliver geometries (river edges,
+  // canal banks) show up at street zoom.
+  map.addSource("prithvi_live", { type: "geojson", data: empty() });
+  map.addLayer({ id: "prithvi-live-fill", type: "fill", source: "prithvi_live",
+    paint: { "fill-color": "#48c6eb", "fill-opacity": 0.45 } });
+  map.addLayer({ id: "prithvi-live-line", type: "line", source: "prithvi_live",
+    paint: { "line-color": "#1aa3c8", "line-width": 1.2, "line-opacity": 0.85 } });
+
+  // TerraMind synthesised LULC polygons — *synthetic-prior* tier
+  // (4th epistemic class). Per-feature fill_color carried from the
+  // server side so the legend stays in one place. Dashed outline so
+  // it visually reads as "synthesized, not observed".
+  map.addSource("terramind_lulc", { type: "geojson", data: empty() });
+  map.addLayer({ id: "terramind-lulc-fill", type: "fill",
+    source: "terramind_lulc",
+    paint: {
+      "fill-color": ["coalesce", ["get", "fill_color"], "#9ca3af"],
+      "fill-opacity": 0.30,
+    },
+  });
+  map.addLayer({ id: "terramind-lulc-line", type: "line",
+    source: "terramind_lulc",
+    paint: {
+      "line-color": ["coalesce", ["get", "fill_color"], "#9ca3af"],
+      "line-width": 1.0,
+      "line-dasharray": [2, 2],
+      "line-opacity": 0.65,
+    },
+  });
+  map.on("click", "terramind-lulc-fill", (e) => {
+    const f = e.features[0]; const p = f.properties;
+    new maplibregl.Popup().setLngLat(e.lngLat)
+      .setHTML(`<b>TerraMind synthetic land-cover</b><br>` +
+               `Class: ${escapeHtml(p.label || "")} (tentative)<br>` +
+               `<i>Synthesised from LiDAR DEM, not observed.</i>`)
+      .addTo(map);
+  });
+
+  // NTA polygon outline
+  map.addSource("nta", { type: "geojson", data: empty() });
+  map.addLayer({ id: "nta-line", type: "line", source: "nta",
+    paint: { "line-color": "#0b3b6b", "line-width": 2.4, "line-opacity": 0.9 } });
+  map.addLayer({ id: "nta-fill", type: "fill", source: "nta",
+    paint: { "fill-color": "#0b3b6b", "fill-opacity": 0.04 } });
+
+  // DOB permit pins
+  map.addSource("permits", { type: "geojson", data: empty() });
+  map.addLayer({ id: "permits-circles", type: "circle", source: "permits",
+    paint: {
+      "circle-radius": ["case", ["get", "any_flood"], 6, 4],
+      "circle-color": [
+        "case",
+        ["get", "in_sandy"], "#fc5d52",
+        [">=", ["get", "dep_max_class"], 2], "#1642DF",
+        [">", ["get", "dep_max_class"], 0], "#568adf",
+        "#1a8754",
+      ],
+      "circle-stroke-color": "#ffffff",
+      "circle-stroke-width": 1.4,
+      "circle-opacity": 0.95,
+    } });
+  map.on("click", "permits-circles", (e) => {
+    const f = e.features[0]; const p = f.properties;
+    new maplibregl.Popup()
+      .setLngLat(f.geometry.coordinates)
+      .setHTML(
+        `<b>${escapeHtml(p.address || "(unknown)")}</b><br>` +
+        `${p.job_type} · ${p.in_sandy === 'true' ? 'Sandy zone' : 'outside Sandy'}<br>` +
+        `DEP class: ${p.dep_max_class}`)
+      .addTo(map);
+  });
+
+  // Address pin (single_address intent)
+  map.addSource("addr", { type: "geojson", data: empty() });
+  map.addLayer({ id: "addr-pin", type: "circle", source: "addr",
+    paint: { "circle-radius": 10, "circle-color": "#0b3b6b",
+      "circle-stroke-color": "#fff", "circle-stroke-width": 3 } });
+
+  // Search-radius circles (200 m / 600 m / 800 m). Visualizes the
+  // spatial scope each specialist is reading from. Drawn as a thin
+  // line so the underlying point data is readable through them.
+  map.addSource("scope", { type: "geojson", data: empty() });
+  map.addLayer({ id: "scope-line", type: "line", source: "scope",
+    paint: { "line-color": "#0b3b6b", "line-width": 1.0,
+             "line-opacity": 0.55, "line-dasharray": [3, 3] } });
+
+  // NYC 311 flood complaint pins — coloured by descriptor.
+  map.addSource("nyc311_pts", { type: "geojson", data: empty() });
+  map.addLayer({ id: "nyc311-circles", type: "circle", source: "nyc311_pts",
+    paint: {
+      "circle-radius": 4.5,
+      "circle-color": ["match", ["get", "descriptor"],
+        "Sewer Backup (Use Comments) (SA)",          "#fc5d52",
+        "Catch Basin Clogged/Flooding (Use Comments) (SC)", "#f59e0b",
+        "Street Flooding (SJ)",                       "#1642DF",
+        "Manhole Overflow (Use Comments) (SA1)",     "#8b5cf6",
+        "#6b7280",
+      ],
+      "circle-stroke-color": "#ffffff",
+      "circle-stroke-width": 1.0,
+      "circle-opacity": 0.85,
+    },
+  });
+  map.on("click", "nyc311-circles", (e) => {
+    const f = e.features[0]; const p = f.properties;
+    new maplibregl.Popup().setLngLat(f.geometry.coordinates)
+      .setHTML(`<b>311 complaint</b><br>${escapeHtml(p.descriptor || "")}<br>` +
+               `${escapeHtml(p.date || "")}<br>${escapeHtml(p.address || "")}`)
+      .addTo(map);
+  });
+
+  // FloodNet sensors — triangles via SDF circle stand-in (cyan,
+  // larger if the sensor has triggered events).
+  map.addSource("floodnet_pts", { type: "geojson", data: empty() });
+  map.addLayer({ id: "floodnet-circles", type: "circle", source: "floodnet_pts",
+    paint: {
+      "circle-radius": 7,
+      "circle-color": "#48c6eb",
+      "circle-stroke-color": "#1aa3c8",
+      "circle-stroke-width": 2.0,
+      "circle-opacity": 0.95,
+    },
+  });
+  map.on("click", "floodnet-circles", (e) => {
+    const f = e.features[0]; const p = f.properties;
+    new maplibregl.Popup().setLngLat(f.geometry.coordinates)
+      .setHTML(`<b>FloodNet sensor</b><br>${escapeHtml(p.name || p.deployment_id || "")}`)
+      .addTo(map);
+  });
+
+  // USGS Hurricane Ida 2021 high-water marks — hot orange, sized by height.
+  map.addSource("ida_hwm_pts", { type: "geojson", data: empty() });
+  map.addLayer({ id: "ida-hwm-circles", type: "circle", source: "ida_hwm_pts",
+    paint: {
+      "circle-radius": ["interpolate", ["linear"],
+        ["coalesce", ["get", "height_above_gnd_ft"], 0],
+        0, 4, 3, 7, 6, 11],
+      "circle-color": "#ea580c",
+      "circle-stroke-color": "#7c2d12",
+      "circle-stroke-width": 1.4,
+      "circle-opacity": 0.92,
+    },
+  });
+  map.on("click", "ida-hwm-circles", (e) => {
+    const f = e.features[0]; const p = f.properties;
+    new maplibregl.Popup().setLngLat(f.geometry.coordinates)
+      .setHTML(`<b>USGS Ida 2021 high-water mark</b><br>` +
+               `${escapeHtml(p.site || "(unnamed)")}<br>` +
+               `Elevation: ${p.elev_ft ?? "?"} ft<br>` +
+               `Height above ground: ${p.height_above_gnd_ft ?? "?"} ft`)
+      .addTo(map);
+  });
+
+  // NOAA tide gauge marker — shows which of the 3 gauges is active.
+  map.addSource("noaa_gauge", { type: "geojson", data: empty() });
+  map.addLayer({ id: "noaa-gauge-marker", type: "circle", source: "noaa_gauge",
+    paint: {
+      "circle-radius": 9,
+      "circle-color": "#0ea5e9",
+      "circle-stroke-color": "#fff",
+      "circle-stroke-width": 2.5,
+    },
+  });
+  map.on("click", "noaa-gauge-marker", (e) => {
+    const f = e.features[0]; const p = f.properties;
+    new maplibregl.Popup().setLngLat(f.geometry.coordinates)
+      .setHTML(`<b>NOAA tide gauge</b><br>${escapeHtml(p.name || "")}<br>` +
+               `Observed water level: ${p.observed_ft ?? "?"} ft MLLW<br>` +
+               `Residual (≈ surge): ${p.residual_ft ?? "?"} ft`)
+      .addTo(map);
+  });
+}
+
+// ~3 m/° latitude × cos(lat) for longitude. Build a circle polygon
+// approximating a fixed-radius (meters) buffer around (lat, lon).
+function metersBuffer(lat, lon, meters, steps = 64) {
+  const dLat = meters / 111_000.0;
+  const dLon = meters / (111_000.0 * Math.cos(lat * Math.PI / 180));
+  const ring = [];
+  for (let i = 0; i <= steps; i++) {
+    const a = (i / steps) * 2 * Math.PI;
+    ring.push([lon + dLon * Math.cos(a), lat + dLat * Math.sin(a)]);
+  }
+  return { type: "Polygon", coordinates: [ring] };
+}
+
+function empty() { return { type: "FeatureCollection", features: [] }; }
+
+function clearMap() {
+  if (!map || !map.getSource) return;
+  for (const id of ["sandy", "dep", "nta", "permits", "addr", "prithvi_live",
+                    "terramind_lulc",
+                    "scope", "nyc311_pts", "floodnet_pts", "ida_hwm_pts",
+                    "noaa_gauge"]) {
+    const s = map.getSource(id);
+    if (s) s.setData(empty());
+  }
+}
+
+async function fillMapForFinal(d) {
+  if (!map || !map.loaded()) {
+    map.once("load", () => fillMapForFinal(d));
+    return;
+  }
+  clearMap();
+  const intent = d.intent;
+  if (intent === "single_address") return fillMapAddress(d);
+  if (intent === "neighborhood")   return fillMapNeighborhood(d);
+  if (intent === "development_check") return fillMapDevelopment(d);
+  if (intent === "live_now")       return fillMapLive(d);
+}
+
+async function fillMapAddress(d) {
+  const geo = d.geocode;
+  if (!geo || !geo.lat) return;
+  map.flyTo({ center: [geo.lon, geo.lat], zoom: 15.5, duration: 700 });
+  map.getSource("addr").setData({ type: "FeatureCollection",
+    features: [{ type: "Feature",
+      geometry: { type: "Point", coordinates: [geo.lon, geo.lat] }, properties: {} }] });
+  // Fetch Sandy + DEP layers clipped to address
+  try {
+    const r = await fetch(`/api/layers/sandy?lat=${geo.lat}&lon=${geo.lon}&r=1500`);
+    map.getSource("sandy").setData(await r.json());
+  } catch {}
+  try {
+    const r = await fetch(`/api/layers/dep_extreme_2080?lat=${geo.lat}&lon=${geo.lon}&r=1500`);
+    map.getSource("dep").setData(await r.json());
+  } catch {}
+  // Prithvi-EO live water mask comes inlined in the SSE final event,
+  // not via a separate /api/layers fetch — it's per-query, not corpus.
+  const live = d.prithvi_live;
+  if (live && live.ok && live.polygons_geojson && map.getSource("prithvi_live")) {
+    map.getSource("prithvi_live").setData(live.polygons_geojson);
+  }
+
+  // TerraMind synthesised LULC polygons — same per-query pattern.
+  const tm = d.terramind;
+  if (tm && tm.ok && tm.polygons_geojson && map.getSource("terramind_lulc")) {
+    map.getSource("terramind_lulc").setData(tm.polygons_geojson);
+  }
+
+  // ---- search-radius scope rings (200 m / 600 m / 800 m) ----
+  // Three rings matching the buffers each specialist actually reads:
+  // 200 m for 311, 600 m for FloodNet sensors, 800 m for Ida HWMs.
+  if (map.getSource("scope")) {
+    map.getSource("scope").setData({
+      type: "FeatureCollection",
+      features: [200, 600, 800].map(r => ({
+        type: "Feature",
+        geometry: metersBuffer(geo.lat, geo.lon, r),
+        properties: { radius_m: r },
+      })),
+    });
+  }
+
+  // ---- NYC 311 flood complaint pins ----
+  const c311 = d.nyc311 || {};
+  const c311Pts = c311.points || [];
+  if (map.getSource("nyc311_pts")) {
+    map.getSource("nyc311_pts").setData({
+      type: "FeatureCollection",
+      features: c311Pts.filter(p => p.lat && p.lon).map(p => ({
+        type: "Feature",
+        geometry: { type: "Point", coordinates: [p.lon, p.lat] },
+        properties: {
+          descriptor: p.descriptor || "",
+          date: p.date || "",
+          address: p.address || "",
+        },
+      })),
+    });
+  }
+
+  // ---- FloodNet sensors ----
+  const fn = d.floodnet || {};
+  const fnSensors = fn.sensors || [];
+  if (map.getSource("floodnet_pts")) {
+    map.getSource("floodnet_pts").setData({
+      type: "FeatureCollection",
+      features: fnSensors.filter(s => s.lat && s.lon).map(s => ({
+        type: "Feature",
+        geometry: { type: "Point", coordinates: [s.lon, s.lat] },
+        properties: {
+          name: s.name || s.deployment_id || "",
+          deployment_id: s.deployment_id || "",
+        },
+      })),
+    });
+  }
+
+  // ---- USGS Ida 2021 HWMs ----
+  const hwm = d.ida_hwm || {};
+  const hwmPts = hwm.points || [];
+  if (map.getSource("ida_hwm_pts")) {
+    map.getSource("ida_hwm_pts").setData({
+      type: "FeatureCollection",
+      features: hwmPts.filter(p => p.lat && p.lon).map(p => ({
+        type: "Feature",
+        geometry: { type: "Point", coordinates: [p.lon, p.lat] },
+        properties: {
+          site: p.site || "",
+          elev_ft: p.elev_ft,
+          height_above_gnd_ft: p.height_above_gnd_ft,
+        },
+      })),
+    });
+  }
+
+  // ---- NOAA tide gauge marker ----
+  const tides = d.noaa_tides || {};
+  if (tides.station_id && tides.station_lat && tides.station_lon &&
+      map.getSource("noaa_gauge")) {
+    map.getSource("noaa_gauge").setData({
+      type: "FeatureCollection",
+      features: [{
+        type: "Feature",
+        geometry: { type: "Point",
+                    coordinates: [tides.station_lon, tides.station_lat] },
+        properties: {
+          name: tides.station_name || tides.station_id,
+          observed_ft: tides.observed_ft_mllw,
+          residual_ft: tides.residual_ft,
+        },
+      }],
+    });
+  }
+}
+
+async function fillMapNeighborhood(d) {
+  const t = d.target;
+  if (!t || !t.bbox || !t.nta_code) return;
+  const [minx, miny, maxx, maxy] = t.bbox;
+  map.fitBounds([[minx, miny], [maxx, maxy]], { padding: 32, duration: 700 });
+  const [r1, r2, r3] = await Promise.all([
+    fetch(`/api/layers/nta?code=${t.nta_code}`).then(r => r.json()),
+    fetch(`/api/layers/sandy_clipped?code=${t.nta_code}`).then(r => r.json()).catch(() => empty()),
+    fetch(`/api/layers/dep_clipped?code=${t.nta_code}&scenario=dep_extreme_2080`).then(r => r.json()).catch(() => empty()),
+  ]);
+  map.getSource("nta").setData(r1);
+  map.getSource("sandy").setData(r2);
+  map.getSource("dep").setData(r3);
+  // Prithvi-EO live water mask (NTA centroid) — same per-query GeoJSON
+  // as the single_address path; clipped visually to the NTA polygon by
+  // the basemap zoom.
+  const live = d.prithvi_live;
+  if (live && live.ok && live.polygons_geojson && map.getSource("prithvi_live")) {
+    map.getSource("prithvi_live").setData(live.polygons_geojson);
+  }
+  // TerraMind synthesised LULC at NTA centroid.
+  const tm = d.terramind;
+  if (tm && tm.ok && tm.polygons_geojson && map.getSource("terramind_lulc")) {
+    map.getSource("terramind_lulc").setData(tm.polygons_geojson);
+  }
+}
+
+async function fillMapDevelopment(d) {
+  await fillMapNeighborhood(d);  // same NTA + Sandy + DEP overlays
+  const pins = ((d.dob_summary || {}).all_pins) || [];
+  const fc = {
+    type: "FeatureCollection",
+    features: pins.filter(p => p.lat && p.lon).map(p => ({
+      type: "Feature",
+      geometry: { type: "Point", coordinates: [p.lon, p.lat] },
+      properties: {
+        address: p.address, job_type: p.job_type,
+        in_sandy: !!p.in_sandy, any_flood: !!p.any_flood,
+        dep_max_class: p.dep_max_class || 0,
+      },
+    })),
+  };
+  map.getSource("permits").setData(fc);
+}
+
+function fillMapLive(d) {
+  // NYC overview with the 3 NOAA gauges
+  map.flyTo({ center: [-74.0, 40.7], zoom: 10, duration: 700 });
+}
+
+// Fire as each FSM step completes, so the map updates progressively
+// instead of waiting for the `final` event. Each branch is idempotent —
+// it's safe if `final` later overwrites with the same data.
+async function incrementallyFillMap(step) {
+  if (!map || !map.loaded()) {
+    map.once("load", () => incrementallyFillMap(step));
+    return;
+  }
+  const r = step.result || {};
+  // Address mode — geocode just resolved
+  if (step.step === "geocode" && r.lat != null && r.lon != null) {
+    map.flyTo({ center: [r.lon, r.lat], zoom: 15.5, duration: 700 });
+    map.getSource("addr").setData({ type: "FeatureCollection",
+      features: [{ type: "Feature",
+        geometry: { type: "Point", coordinates: [r.lon, r.lat] }, properties: {} }] });
+    Promise.all([
+      fetch(`/api/layers/sandy?lat=${r.lat}&lon=${r.lon}&r=1500`).then(x => x.json()).catch(() => empty()),
+      fetch(`/api/layers/dep_extreme_2080?lat=${r.lat}&lon=${r.lon}&r=1500`).then(x => x.json()).catch(() => empty()),
+    ]).then(([s, d]) => {
+      map.getSource("sandy").setData(s);
+      map.getSource("dep").setData(d);
+    });
+    return;
+  }
+  // Neighborhood / dev_check — NTA polygon resolved
+  if (step.step === "nta_resolve" && r.nta_code && r.bbox) {
+    const [minx, miny, maxx, maxy] = r.bbox;
+    map.fitBounds([[minx, miny], [maxx, maxy]], { padding: 32, duration: 700 });
+    Promise.all([
+      fetch(`/api/layers/nta?code=${r.nta_code}`).then(x => x.json()).catch(() => empty()),
+      fetch(`/api/layers/sandy_clipped?code=${r.nta_code}`).then(x => x.json()).catch(() => empty()),
+      fetch(`/api/layers/dep_clipped?code=${r.nta_code}&scenario=dep_extreme_2080`).then(x => x.json()).catch(() => empty()),
+    ]).then(([n, s, d]) => {
+      map.getSource("nta").setData(n);
+      map.getSource("sandy").setData(s);
+      map.getSource("dep").setData(d);
+    });
+    return;
+  }
+  // Dev_check — DOB permits arrived; pin them now
+  if (step.step === "dob_permits_nta" && Array.isArray(r.all_pins)) {
+    const fc = { type: "FeatureCollection",
+      features: r.all_pins.filter(p => p.lat && p.lon).map(p => ({
+        type: "Feature",
+        geometry: { type: "Point", coordinates: [p.lon, p.lat] },
+        properties: {
+          address: p.address, job_type: p.job_type,
+          in_sandy: !!p.in_sandy, any_flood: !!p.any_flood,
+          dep_max_class: p.dep_max_class || 0,
+        },
+      })) };
+    map.getSource("permits").setData(fc);
+    return;
+  }
+}
+
+// ---------------------------------------------------------------------------
+// REPORT (paragraph) RENDERING
+// ---------------------------------------------------------------------------
+
+function escapeHtml(s) {
+  return String(s ?? "").replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+
+let CITE_INDEX = {};
+// Resolve a doc_id to its source-label family. Register specialists emit
+// per-asset doc_ids like `mta_entrance_54` / `nycha_dev_004` — for those
+// we strip the trailing `_<id>` and look up the family key.
+const _FAMILY_PREFIXES = ["mta_entrance", "nycha_dev", "doe_school", "nyc_hospital"];
+function _docIdFamily(norm) {
+  for (const fam of _FAMILY_PREFIXES) {
+    if (norm.startsWith(fam + "_")) return fam;
+  }
+  return null;
+}
+function _resolveSourceLabel(norm) {
+  if (SOURCE_LABELS[norm]) return SOURCE_LABELS[norm];
+  const fam = _docIdFamily(norm);
+  return fam ? SOURCE_LABELS[fam] : norm;
+}
+function rewriteCitations(html) {
+  return html.replace(/\[([a-z0-9_]+)\]/gi, (_, id) => {
+    const norm = id.toLowerCase();
+    if (CITE_INDEX[norm] == null) CITE_INDEX[norm] = Object.keys(CITE_INDEX).length + 1;
+    const n = CITE_INDEX[norm];
+    return `<span class="cite" data-src-id="${norm}" data-src-n="${n}" title="${_resolveSourceLabel(norm)} — click to highlight in Sources">${n}</span>`;
+  });
+}
+
+// Sources footer is a Lit web component (<r-sources-footer>) — driven
+// by the citeIndex signal in /static/components/signals.js. We feed
+// it the labels/urls/vintages once at boot and update the signal as
+// the briefing markdown is rendered.
+async function renderSources() {
+  const el = document.getElementById("sourcesFooter");
+  if (!el) return;
+  // Module is loaded async; wait for define() then push fresh data.
+  await customElements.whenDefined("r-sources-footer");
+  el.labels = SOURCE_LABELS;
+  el.urls = SOURCE_URLS;
+  el.vintages = SOURCE_VINTAGES;
+  // Push the citation index into the shared signal — the component
+  // re-renders reactively.
+  const { citeIndex } = await import("/static/components/signals.js");
+  citeIndex.set({ ...CITE_INDEX });
+}
+
+function renderMarkdown(text) {
+  // Block recognizer:
+  //   `**Header.**`     (own line)  →  <h4>
+  //   lines starting `- ` or `* `   →  bullet items collected into <ul>
+  //   anything else                 →  <p>
+  // Inline `**foo**` → <strong>
+  const lines = text.split("\n");
+  const out = [];
+  let para = []; let bullets = [];
+  const flushPara = () => {
+    if (!para.length) return;
+    const safe = escapeHtml(para.join(" ").trim()).replace(/\*\*([^*]+)\*\*/g, "<strong>$1</strong>");
+    if (safe) out.push(`<p class="rsum-p">${safe}</p>`);
+    para = [];
+  };
+  const flushBullets = () => {
+    if (!bullets.length) return;
+    const items = bullets.map(b => {
+      const safe = escapeHtml(b.trim()).replace(/\*\*([^*]+)\*\*/g, "<strong>$1</strong>");
+      return `<li>${safe}</li>`;
+    }).join("");
+    out.push(`<ul class="rsum-list">${items}</ul>`);
+    bullets = [];
+  };
+  // Granite sometimes runs all bullets onto one line separated by " - ";
+  // pre-split those so each becomes its own bullet.
+  const expanded = [];
+  for (const line of lines) {
+    if (line.trim().startsWith("- ") && line.includes(" - ", 2)) {
+      // split into bullets
+      const parts = line.split(/(?:^|(?<=\.\s))\s*-\s+/g).filter(p => p.trim());
+      for (const p of parts) expanded.push("- " + p.trim());
+    } else {
+      expanded.push(line);
+    }
+  }
+  for (const line of expanded) {
+    const m = line.match(/^\s*\*\*([A-Z][A-Za-z\s/]+)\.\*\*\s*$/);
+    if (m) {
+      flushPara(); flushBullets();
+      out.push(`<h4 class="rsum-h">${escapeHtml(m[1])}</h4>`);
+      continue;
+    }
+    if (/^\s*[-*]\s+/.test(line)) {
+      flushPara();
+      bullets.push(line.replace(/^\s*[-*]\s+/, ""));
+    } else {
+      flushBullets();
+      para.push(line);
+    }
+  }
+  flushPara(); flushBullets();
+  return out.join("");
+}
+
+// Briefing is now the Lit <r-briefing> web component. It owns markdown
+// rendering, citation chip binding, and pushing CITE_INDEX into the
+// shared signal — agent.js just feeds it `.text` + `.sourceLabels`.
+async function setBriefingText(text) {
+  const el = document.getElementById("paragraph");
+  if (!el) return;
+  await customElements.whenDefined("r-briefing");
+  el.sourceLabels = SOURCE_LABELS;
+  el.text = text || "";
+}
+function renderParagraph(text) { setBriefingText(text); }
+
+// ---------------------------------------------------------------------------
+// FACTS PANEL — intent-specific quick-look stats below the map
+// ---------------------------------------------------------------------------
+
+function renderFacts(d) {
+  const intent = d.intent;
+  const panel = $("#factsPanel");
+  const body = $("#factsBody");
+  panel.style.display = "";
+  if (intent === "neighborhood")        renderNbhdFacts(d, body);
+  else if (intent === "development_check") renderDevFacts(d, body);
+  else if (intent === "live_now")       renderLiveFacts(d, body);
+  else if (intent === "single_address") renderAddressFacts(d, body);
+}
+
+function renderNbhdFacts(d, body) {
+  $("#factsTitle").textContent = `Findings — ${d.target?.nta_name || ""}`;
+  const s = d.sandy_nta || {}; const dep = d.dep_nta || {};
+  const m = d.microtopo_nta || {}; const c = d.nyc311_nta || {};
+  const sandyPct = s.fraction != null ? (s.fraction * 100).toFixed(1) + "%" : "—";
+  const dep80 = (dep.dep_extreme_2080 || {}).fraction_any;
+  const dep50 = (dep.dep_moderate_2050 || {}).fraction_any;
+  body.innerHTML = `
+    <div class="headline-stat">${sandyPct}</div>
+    <div class="headline-sub">of the neighborhood is inside the 2012 Sandy Inundation Zone</div>
+    <dl class="facts-grid">
+      <dt>DEP Extreme 2080</dt><dd>${dep80!=null ? (dep80*100).toFixed(1)+"%" : "—"}</dd>
+      <dt>DEP Moderate 2050</dt><dd>${dep50!=null ? (dep50*100).toFixed(1)+"%" : "—"}</dd>
+      <dt>311 (3 yr)</dt><dd>${c.n ?? "—"} flood complaints</dd>
+      <dt>HAND median</dt><dd>${m.hand_median_m != null ? m.hand_median_m+" m" : "—"}</dd>
+      <dt>HAND &lt; 1 m fraction</dt><dd>${m.frac_hand_lt1 != null ? (m.frac_hand_lt1*100).toFixed(0)+"%" : "—"}</dd>
+      <dt>TWI median</dt><dd>${m.twi_median ?? "—"}</dd>
+    </dl>`;
+}
+
+function renderDevFacts(d, body) {
+  $("#factsTitle").textContent = `Active construction — ${d.target?.nta_name || ""}`;
+  const ds = d.dob_summary || {};
+  body.innerHTML = `
+    <div class="headline-stat">${ds.n_in_sandy ?? 0} <span style="color:var(--text-muted); font-size:18px; font-weight:400;">/ ${ds.n_total ?? 0}</span></div>
+    <div class="headline-sub">active projects inside the Sandy zone</div>
+    <dl class="facts-grid">
+      <dt>Total active</dt><dd>${ds.n_total ?? 0}</dd>
+      <dt>In any DEP scenario</dt><dd>${ds.n_in_dep_any ?? 0}</dd>
+      <dt>In severe DEP (≥1 ft)</dt><dd>${ds.n_in_dep_severe ?? 0}</dd>
+      <dt>By job type</dt><dd>${Object.entries(ds.by_job_type || {}).map(([k,v]) => `${v} ${k}`).join(", ")}</dd>
+    </dl>`;
+}
+
+function renderLiveFacts(d, body) {
+  $("#factsTitle").textContent = `Live conditions — ${d.place || "NYC"}`;
+  const t = d.noaa_tides || {}; const a = d.nws_alerts || {}; const o = d.nws_obs || {};
+  const ttm = d.ttm_forecast || {};
+  const r = t.residual_ft;
+  body.innerHTML = `
+    <div class="headline-stat">${a.n_active ?? 0} alerts</div>
+    <div class="headline-sub">active flood-relevant NWS alerts at this point</div>
+    <dl class="facts-grid">
+      <dt>Tide gauge</dt><dd>${t.station_name || "—"}</dd>
+      <dt>Observed</dt><dd>${t.observed_ft_mllw != null ? t.observed_ft_mllw+" ft MLLW" : "—"}</dd>
+      <dt>Residual</dt><dd>${r != null ? (r >= 0 ? "+" : "")+r+" ft" : "—"}</dd>
+      <dt>Nearest ASOS</dt><dd>${o.station_id || "—"}</dd>
+      <dt>Precip 1h</dt><dd>${o.precip_last_hour_mm != null ? o.precip_last_hour_mm+" mm" : "—"}</dd>
+      <dt>TTM peak (next 9.6h)</dt><dd>${ttm.forecast_peak_ft != null ? ttm.forecast_peak_ft+" ft" : "—"}</dd>
+    </dl>`;
+}
+
+function renderAddressFacts(d, body) {
+  $("#factsTitle").textContent = "Findings";
+  const geo = d.geocode || {};
+  const dep = d.dep || {}; const e80 = (dep.dep_extreme_2080 || {});
+  const m = d.microtopo || {};
+  body.innerHTML = `
+    <div class="headline-sub">${geo.address || "—"}</div>
+    <dl class="facts-grid">
+      <dt>Sandy zone</dt><dd>${d.sandy ? "INSIDE" : "outside"}</dd>
+      <dt>DEP Extreme 2080</dt><dd>${e80.depth_label || "—"}</dd>
+      <dt>HAND</dt><dd>${m.hand_m != null ? m.hand_m+" m" : "—"}</dd>
+      <dt>TWI</dt><dd>${m.twi ?? "—"}</dd>
+      <dt>Elev pct (200m)</dt><dd>${m.rel_elev_pct_200m ?? "—"}</dd>
+      <dt>311 (5y, 200m)</dt><dd>${(d.nyc311 || {}).n ?? "—"}</dd>
+    </dl>`;
+}
+
+// ---------------------------------------------------------------------------
+// TRACE PANEL
+// ---------------------------------------------------------------------------
+
+// Trace list is a Lit web component (<r-trace>); pushTraceStep delegates
+// once the component is registered. STEP_LABELS is set on the element
+// at boot.
+async function pushTraceStep(step) {
+  const el = document.getElementById("steps");
+  if (!el) return;
+  await customElements.whenDefined("r-trace");
+  if (!el.stepLabels || !Object.keys(el.stepLabels).length) {
+    el.stepLabels = STEP_LABELS;
+  }
+  el.pushStep(step);
+}
+
+async function clearTrace() {
+  const el = document.getElementById("steps");
+  if (el) {
+    await customElements.whenDefined("r-trace");
+    el.clear();
+  }
+  $("#traceMeta").textContent = "";
+}
+
+// --------------------------------------------------------------------------
+// Loading-state and chrome helpers
+// --------------------------------------------------------------------------
+
+function setMapLoading(text) {
+  const el = $("#mapLoading");
+  if (!el) return;
+  if (text) {
+    el.style.display = "";
+    $("#mapLoadingText").textContent = text;
+  } else {
+    el.style.display = "none";
+  }
+}
+
+function setLegend(intent) {
+  const el = $("#mapLegend");
+  if (!el) return;
+  // Reusable legend rows shared across intents.
+  const empirical = `
+      <div class="legend-row"><span class="legend-swatch fill" style="background:#fc5d52; opacity:0.4"></span>Sandy 2012 extent</div>
+      <div class="legend-row"><span class="legend-swatch fill" style="background:#1642DF; opacity:0.4"></span>DEP Extreme-2080</div>`;
+  const points = `
+      <div class="legend-row"><span class="legend-swatch" style="background:#fc5d52; border-radius:50%"></span>311 — sewer backup</div>
+      <div class="legend-row"><span class="legend-swatch" style="background:#f59e0b; border-radius:50%"></span>311 — catch basin</div>
+      <div class="legend-row"><span class="legend-swatch" style="background:#1642DF; border-radius:50%"></span>311 — street flooding</div>
+      <div class="legend-row"><span class="legend-swatch" style="background:#48c6eb; border:2px solid #1aa3c8; border-radius:50%"></span>FloodNet sensor</div>
+      <div class="legend-row"><span class="legend-swatch" style="background:#ea580c; border:1px solid #7c2d12; border-radius:50%"></span>Ida 2021 high-water mark</div>
+      <div class="legend-row"><span class="legend-swatch" style="background:#0ea5e9; border:2px solid #fff; border-radius:50%; outline:1px solid #ccc"></span>NOAA tide gauge</div>`;
+  // Synthetic-prior tier — distinct visual idiom (dashed) so users
+  // immediately read it as "generated, not observed".
+  const synthetic = `
+      <div style="font-weight:700; font-size:9.5px; text-transform:uppercase; letter-spacing:0.06em; color:var(--text-muted); margin-top:6px; margin-bottom:2px">Synthetic priors (not observed)</div>
+      <div class="legend-row"><span class="legend-swatch fill" style="background:#48c6eb; opacity:0.45"></span>Prithvi-EO 2.0 — live water mask</div>
+      <div class="legend-row"><span class="legend-swatch fill" style="background:#16a34a; opacity:0.30; border:1px dashed #16a34a"></span>TerraMind — synthetic LULC (DEM→ESRI Land Cover, dashed = generated)</div>`;
+
+  if (intent === "development_check") {
+    el.innerHTML = `
+      <div style="font-weight:700; font-size:9.5px; text-transform:uppercase; letter-spacing:0.06em; color:var(--text-muted); margin-bottom:4px">Active permits</div>
+      <div class="legend-row"><span class="legend-swatch" style="background:#fc5d52"></span>Inside Sandy zone</div>
+      <div class="legend-row"><span class="legend-swatch" style="background:#1642DF"></span>DEP deep band (≥1 ft)</div>
+      <div class="legend-row"><span class="legend-swatch" style="background:#568adf"></span>DEP nuisance band</div>
+      <div class="legend-row"><span class="legend-swatch" style="background:#1a8754"></span>No flood layer</div>
+      <div class="legend-row" style="margin-top:6px">${empirical}</div>${synthetic}`;
+    el.style.display = "";
+  } else if (intent === "neighborhood") {
+    el.innerHTML = `${empirical}
+      <div class="legend-row"><span class="legend-swatch fill" style="background:transparent; border:2px solid #0b3b6b"></span>NTA boundary</div>${synthetic}`;
+    el.style.display = "";
+  } else if (intent === "single_address") {
+    el.innerHTML = `
+      <div class="legend-row"><span class="legend-swatch" style="background:#0b3b6b"></span>Address</div>${empirical}${points}${synthetic}`;
+    el.style.display = "";
+  } else {
+    el.style.display = "none";
+  }
+}
+
+// Mirrors app/score.py.composite() — see ARCHITECTURE.md / METHODOLOGY.md.
+// Used only for the single_address intent badge; neighborhood and
+// development_check have their own headline stats in the facts panel.
+const REG_W = { fema_1pct: 1.0, fema_02pct: 0.5,
+  dep_moderate_2050: 0.75, dep_extreme_2080: 0.50, dep_tidal_2050: 0.75 };
+const HYD_W = { hand_band: 1.0, twi_quartile: 0.5,
+  elev_pct_200m_inv: 0.5, elev_pct_750m_inv: 0.5, basin_relief_band: 0.25 };
+const EMP_W = { sandy: 1.0, ida_hwm_within_100m: 1.0, ida_hwm_within_800m: 0.5,
+  prithvi_polygon: 0.75, complaints_band: 0.75, floodnet_trigger: 0.75 };
+const handBand   = h => h == null ? 0 : (h < 1 ? 1 : h < 3 ? 0.66 : h < 10 ? 0.33 : 0);
+const pctInvBand = p => p == null ? 0 : (p < 10 ? 1 : p < 25 ? 0.66 : p < 50 ? 0.33 : 0);
+const twiBand    = t => t == null ? 0 : (t >= 12 ? 1 : t >= 10 ? 0.66 : t >= 8 ? 0.33 : 0);
+const reliefBand = r => r == null ? 0 : (r >= 8 ? 1 : r >= 4 ? 0.66 : r >= 2 ? 0.33 : 0);
+const complBand  = n => !n ? 0 : (n >= 10 ? 1 : n >= 3 ? 0.66 : 0.33);
+const sumW = w => Object.values(w).reduce((a, b) => a + b, 0);
+
+function computeComposite(ev) {
+  const dep = ev.dep || {}, mt = ev.microtopo || {}, ida = ev.ida_hwm || {}, pw = ev.prithvi_water || {};
+  const s = {
+    fema_1pct: false, fema_02pct: false,
+    dep_moderate_2050: (dep.dep_moderate_2050?.depth_class || 0) > 0,
+    dep_extreme_2080:  (dep.dep_extreme_2080?.depth_class || 0) > 0,
+    dep_tidal_2050:    false,
+    hand_m: mt.hand_m, twi: mt.twi,
+    rel_elev_pct_200m: mt.rel_elev_pct_200m,
+    rel_elev_pct_750m: mt.rel_elev_pct_750m,
+    basin_relief_m: mt.basin_relief_m,
+    sandy: !!ev.sandy,
+    ida_hwm_within_100m: (ida.nearest_dist_m != null && ida.nearest_dist_m < 100),
+    ida_hwm_within_800m: (ida.n_within_radius || 0) > 0,
+    prithvi_polygon: !!pw.inside_water_polygon,
+    complaints_count: ev.nyc311?.n || 0,
+    floodnet_trigger: (ev.floodnet?.n_flood_events_3y || 0) > 0,
+  };
+  let regRaw = 0; for (const [k, w] of Object.entries(REG_W)) regRaw += s[k] ? w : 0;
+  const reg = regRaw / sumW(REG_W);
+  const hb = { hand_band: handBand(s.hand_m), twi_quartile: twiBand(s.twi),
+    elev_pct_200m_inv: pctInvBand(s.rel_elev_pct_200m),
+    elev_pct_750m_inv: pctInvBand(s.rel_elev_pct_750m),
+    basin_relief_band: reliefBand(s.basin_relief_m) };
+  let hydRaw = 0; for (const [k, w] of Object.entries(HYD_W)) hydRaw += w * hb[k];
+  const hyd = hydRaw / sumW(HYD_W);
+  const ev2 = { sandy: s.sandy ? 1 : 0,
+    ida_hwm_within_100m: s.ida_hwm_within_100m ? 1 : 0,
+    ida_hwm_within_800m: s.ida_hwm_within_800m ? 1 : 0,
+    prithvi_polygon: s.prithvi_polygon ? 1 : 0,
+    complaints_band: complBand(s.complaints_count),
+    floodnet_trigger: s.floodnet_trigger ? 1 : 0 };
+  let empRaw = 0; for (const [k, w] of Object.entries(EMP_W)) empRaw += w * ev2[k];
+  const emp = empRaw / sumW(EMP_W);
+  const composite = reg + hyd + emp;
+  let tier = 0;
+  if (composite >= 1.50) tier = 1;
+  else if (composite >= 1.00) tier = 2;
+  else if (composite >= 0.50) tier = 3;
+  else if (composite >= 0.01) tier = 4;
+  const floorApplied = !!(s.sandy || s.ida_hwm_within_100m);
+  if (floorApplied && (tier === 0 || tier > 2)) tier = 2;
+  return { tier, composite, floorApplied,
+           sub: { regulatory: reg, hydrological: hyd, empirical: emp } };
+}
+
+function tierMeta(tier) {
+  if (tier === 1) return { tier, label: "High exposure",
+    help: "Multiple sub-indices saturated. Not a damage probability." };
+  if (tier === 2) return { tier, label: "Elevated exposure",
+    help: "At least one sub-index near saturation. Not a damage probability." };
+  if (tier === 3) return { tier, label: "Moderate exposure",
+    help: "Partial signals across categories. Not a damage probability." };
+  if (tier === 4) return { tier, label: "Limited exposure",
+    help: "A single contextual signal." };
+  return { tier: 0, label: "No flagged exposure",
+    help: "No positive flood signal across the assessed sources." };
+}
+
+function renderBriefHead(d) {
+  const intent = d.intent;
+  const place = (d.target && d.target.nta_name)
+    || (d.geocode && d.geocode.address)
+    || d.place || "—";
+  const meta = [];
+  const eyebrowMap = {
+    single_address:    "Flood-exposure briefing — address",
+    neighborhood:      "Flood-exposure briefing — neighborhood",
+    development_check: "Active development × flood exposure",
+    live_now:          "Current conditions — NYC",
+  };
+  $("#briefEyebrow").textContent = eyebrowMap[intent] || "Briefing";
+  $("#briefTitle").innerHTML = escapeHtml(place);
+
+  // For single_address intent, append the tier badge inline with the title
+  // — same idiom as the legacy /single page.
+  if (intent === "single_address") {
+    const c = computeComposite(d);
+    const m = tierMeta(c.tier);
+    const titleEl = $("#briefTitle");
+    const floor = c.floorApplied ? ' <span class="tier-floor">empirical floor</span>' : "";
+    titleEl.innerHTML += ` <span class="tier-chip t-${m.tier}" title="${escapeHtml(m.help)}">
+        Tier ${m.tier} · ${escapeHtml(m.label)}${floor}
+      </span>`;
+  }
+
+  // Mellea compliance badge — present iff strict mode ran and produced
+  // metadata. Color reflects pass ratio: green for full, amber partial,
+  // red none.
+  if (d.mellea) {
+    const m = d.mellea;
+    const passed = (m.requirements_passed || []).length;
+    const total = m.requirements_total || 0;
+    const cls = passed === total ? "full"
+              : passed > 0       ? "partial"
+              :                    "none";
+    const tip = `Mellea (IBM Research) ran ${m.n_attempts} attempt${m.n_attempts === 1 ? "" : "s"}` +
+                ` (${m.rerolls} reroll${m.rerolls === 1 ? "" : "s"}). ` +
+                `Requirements passed: ${(m.requirements_passed || []).join(", ") || "none"}. ` +
+                (m.requirements_failed?.length
+                  ? `Failed: ${m.requirements_failed.join(", ")}.` : "");
+    $("#briefTitle").innerHTML +=
+      ` <span class="mellea-badge ${cls}" title="${escapeHtml(tip)}">` +
+      `<span class="ico">✓</span>Mellea ${passed}/${total}` +
+      (m.rerolls > 0 ? ` · ${m.rerolls} reroll${m.rerolls === 1 ? "" : "s"}` : "") +
+      `</span>`;
+  }
+  if (intent === "single_address" && d.geocode) {
+    if (d.geocode.borough) meta.push(`<span class="brief-meta-k">borough</span> <span class="brief-meta-v">${escapeHtml(d.geocode.borough)}</span>`);
+    if (d.geocode.bbl)     meta.push(`<span class="brief-meta-k">bbl</span> <span class="brief-meta-v">${escapeHtml(d.geocode.bbl)}</span>`);
+  } else if (d.target && d.target.borough) {
+    meta.push(`<span class="brief-meta-k">borough</span> <span class="brief-meta-v">${escapeHtml(d.target.borough)}</span>`);
+    if (d.target.nta_code) meta.push(`<span class="brief-meta-k">nta</span> <span class="brief-meta-v">${escapeHtml(d.target.nta_code)}</span>`);
+  }
+  if (d.total_s != null) meta.push(`<span class="brief-meta-k">runtime</span> <span class="brief-meta-v">${d.total_s}s</span>`);
+  meta.push(`<span class="brief-meta-k">assessed</span> <span class="brief-meta-v">${new Date().toISOString().slice(0,16).replace("T"," ")}</span>`);
+  $("#briefMeta").innerHTML = meta.join('<span style="color:var(--text-faint)">·</span>');
+}
+
+// ---------------------------------------------------------------------------
+// PLANNER ROW
+// ---------------------------------------------------------------------------
+
+function renderPlan(p) {
+  const pillCls = INTENT_PILL_CLASS[p.intent] || "";
+  $("#plannerRow").innerHTML = `
+    <div class="planner-box">
+      <div class="planner-key">Planner</div>
+      <div><span class="intent-pill ${pillCls}">${escapeHtml(p.intent)}</span></div>
+      <div class="planner-key">Targets</div>
+      <div class="planner-val">${(p.targets || []).map(t => escapeHtml(t.type) + ":" + escapeHtml(t.text)).join(", ") || "(none)"}</div>
+      <div class="planner-key">Specialists</div>
+      <div class="planner-val">${(p.specialists || []).join(", ")}</div>
+      <div class="planner-rationale">"${escapeHtml(p.rationale || "")}"</div>
+    </div>`;
+}
+
+// ---------------------------------------------------------------------------
+// SSE driver
+// ---------------------------------------------------------------------------
+
+let currentEs = null;
+// Buffers for the report-export feature — capture the full plan, trace,
+// and final result during streaming so the report page can render the
+// complete evidence package without re-running the agent.
+let LAST_RESULT = null;
+let LAST_TRACE = [];
+let LAST_PLAN = null;
+let LAST_PLAN_OBJ = null;
+let TRACE_BUF = [];
+
+function ask(q) {
+  ensureMap();
+  clearTrace(); clearMap();
+  $("#plannerRow").innerHTML = "";
+  setBriefingText("");
+  $("#paragraph").classList.remove("streaming");
+  const banner = $("#melleaBanner");
+  if (banner) { banner.style.display = "none"; banner.innerHTML = ""; }
+  $("#reportPanel").style.display = "none";
+  $("#factsPanel").style.display = "none";
+  $("#reportSkel").style.display = "";
+  $("#traceSkel").style.display = "";
+  $("#mapLegend").style.display = "none";
+  setMapLoading("Granite is planning the query…");
+  $("#goBtn").disabled = true;
+  $("#traceMeta").textContent = "…";
+
+  if (currentEs) currentEs.close();
+  const es = new EventSource("/api/agent/stream?q=" + encodeURIComponent(q));
+  currentEs = es;
+  const t0 = Date.now();
+  let streamBuf = "";
+  let streamTimer = null;
+  let planStreamBuf = "";
+  let planStreamTimer = null;
+  const ensurePlannerStream = () => {
+    let el = $("#plannerRow .planner-streaming");
+    if (!el) {
+      $("#plannerRow").innerHTML = `<div class="planner-streaming"></div>`;
+      el = $("#plannerRow .planner-streaming");
+    }
+    return el;
+  };
+  const repaintPlanner = () => {
+    const el = $("#plannerRow .planner-streaming");
+    if (el) el.textContent = planStreamBuf;
+  };
+  const schedulePlannerRepaint = () => {
+    if (planStreamTimer) return;
+    planStreamTimer = setTimeout(() => { planStreamTimer = null; repaintPlanner(); }, 60);
+  };
+  // Re-render the partial markdown on every token, but at most every 80 ms
+  // so the browser isn't murdered by a token-stream that arrives in bursts.
+  // Build the Sources footer alongside so it grows as new doc_ids appear.
+  // Briefing component owns citation indexing + chip binding via shared
+  // signals; we just feed it the latest text. Sources footer reacts to
+  // the citeIndex signal that <r-briefing> updates each render.
+  const repaint = () => {
+    setBriefingText(streamBuf);
+    renderSources();
+  };
+  const scheduleRepaint = () => {
+    if (streamTimer) return;
+    streamTimer = setTimeout(() => { streamTimer = null; repaint(); }, 80);
+  };
+
+  es.addEventListener("plan_token", (e) => {
+    ensurePlannerStream();
+    const d = JSON.parse(e.data);
+    planStreamBuf += d.delta || "";
+    schedulePlannerRepaint();
+  });
+  es.addEventListener("plan",  (e) => {
+    if (planStreamTimer) { clearTimeout(planStreamTimer); planStreamTimer = null; }
+    const planObj = JSON.parse(e.data);
+    LAST_PLAN_OBJ = planObj;
+    renderPlan(planObj);
+    setLegend(planObj.intent);
+    setMapLoading(planObj.intent === "live_now" ? null : "Resolving location…");
+    $("#traceSkel").style.display = "none";
+    TRACE_BUF = [];
+    $("#reportBtn").classList.remove("ready");
+  });
+  es.addEventListener("step", (e) => {
+    const step = JSON.parse(e.data);
+    TRACE_BUF.push(step);
+    incrementallyFillMap(step);
+    if (step.step === "geocode" || step.step === "nta_resolve") setMapLoading(null);
+  });
+  es.addEventListener("step",  (e) => { pushTraceStep(JSON.parse(e.data)); });
+  let currentAttempt = 0;
+  es.addEventListener("token", (e) => {
+    const d = JSON.parse(e.data);
+    if (!streamBuf || (d.attempt != null && d.attempt !== currentAttempt)) {
+      // First token of a (possibly new) attempt → reveal panel, reset
+      // buffer if Mellea moved to a reroll.
+      if (d.attempt != null && d.attempt !== currentAttempt) {
+        currentAttempt = d.attempt;
+        streamBuf = "";
+      }
+      $("#reportSkel").style.display = "none";
+      $("#reportPanel").style.display = "";
+      $("#paragraph").classList.add("streaming");
+    }
+    streamBuf += d.delta || "";
+    scheduleRepaint();
+  });
+  // Mellea per-attempt outcome — render a small banner above the briefing
+  // when a reroll is about to start so the user knows the model is
+  // self-correcting (and what failed).
+  es.addEventListener("mellea_attempt", (e) => {
+    const d = JSON.parse(e.data);
+    const banner = $("#melleaBanner");
+    if (!banner) return;
+    if (d.failed && d.failed.length) {
+      banner.className = "mellea-banner reroll";
+      banner.innerHTML = `<strong>↻ Mellea reroll</strong> — attempt ${(d.attempt|0)+1} failed: <code>${d.failed.join(", ")}</code>. Re-drafting…`;
+      banner.style.display = "";
+    } else {
+      banner.className = "mellea-banner pass";
+      banner.innerHTML = `<strong>✓ Mellea</strong> — all 4 grounding requirements satisfied`;
+      banner.style.display = "";
+    }
+  });
+  es.addEventListener("final", (e) => {
+    const d = JSON.parse(e.data);
+    const dt = ((Date.now() - t0) / 1000).toFixed(1);
+    $("#traceMeta").textContent = `${dt}s`;
+    setMapLoading(null);
+    $("#reportSkel").style.display = "none";
+    $("#paragraph").classList.remove("streaming");
+    if (d.paragraph) {
+      $("#reportPanel").style.display = "";
+      streamBuf = d.paragraph;
+      if (streamTimer) { clearTimeout(streamTimer); streamTimer = null; }
+      repaint();
+      renderBriefHead(d);
+    }
+    renderFacts(d);
+    fillMapForFinal(d);
+    // Stash everything needed for the auditable-report page.
+    LAST_RESULT = { query: q, finishedAt: new Date().toISOString(),
+                    wallSeconds: Number(dt), result: d };
+    LAST_TRACE = TRACE_BUF.slice();
+    LAST_PLAN = LAST_PLAN_OBJ;
+    $("#reportBtn").classList.add("ready");
+  });
+  es.addEventListener("error", () => {});
+  es.addEventListener("done", () => { es.close(); $("#goBtn").disabled = false; });
+}
+
+// ---------------------------------------------------------------------------
+// wire
+// ---------------------------------------------------------------------------
+
+// Bind form/sample handlers FIRST so a throw in ensureMap() (e.g. a
+// WebGL init failure) can't strand the user with a dead "Ask" button.
+$("#agentForm").addEventListener("submit", (e) => {
+  e.preventDefault();
+  const q = $("#q").value.trim();
+  if (q) ask(q);
+});
+document.querySelectorAll(".sample-btn").forEach(b => {
+  b.addEventListener("click", () => { $("#q").value = b.dataset.q; ask(b.dataset.q); });
+});
+try { ensureMap(); } catch (e) { console.error("ensureMap failed:", e); }
+
+// Backend hardware pill: fetches /api/backend, renders "<HW> · <ENGINE>"
+// and a state color (green=primary up, amber=fallback active, red=down).
+// Refreshes every 60s so a flipped droplet shows up without a page reload.
+async function refreshBackendPill() {
+  const pill = document.getElementById("backendPill");
+  const text = document.getElementById("backendPillText");
+  if (!pill || !text) return;
+  try {
+    const r = await fetch("/api/backend", { cache: "no-store" });
+    if (!r.ok) throw new Error("status " + r.status);
+    const info = await r.json();
+    const onFallback = info.reachable === false && !!info.fallback_engine;
+    const engine = onFallback ? info.fallback_engine : info.engine;
+    const hw = onFallback ? "fallback" : info.hardware;
+    text.textContent = `${hw} · Granite 4.1 / ${engine}`;
+    pill.dataset.state =
+      info.reachable ? "ok" :
+      onFallback ? "fallback" : "down";
+    const detail = info.vllm_base_url
+      ? `Primary: ${info.engine} @ ${info.vllm_base_url}`
+      : `Engine: ${info.engine}`;
+    pill.title = info.reachable
+      ? `${detail} — reachable. No vendor LLM is contacted.`
+      : onFallback
+      ? `${detail} unreachable; running on ${info.fallback_engine} fallback.`
+      : `${detail} — UNREACHABLE.`;
+  } catch (e) {
+    text.textContent = "backend unknown";
+    pill.dataset.state = "down";
+    pill.title = "Could not query /api/backend: " + e.message;
+  }
+}
+refreshBackendPill();
+setInterval(refreshBackendPill, 60000);
+
+// Subscribe to the shared highlight signal so vanilla-rendered citation
+// chips in the briefing prose mirror the highlight state driven by the
+// Lit <r-sources-footer> (and vice versa).
+(async () => {
+  const { highlightedDocId } = await import("/static/components/signals.js");
+  const apply = () => {
+    const id = highlightedDocId.get();
+    document.querySelectorAll("#paragraph .cite").forEach(c => {
+      c.classList.toggle("hl", c.dataset.srcId === id);
+    });
+  };
+  // Lit-labs/signals exposes a subscribe / effect — try both shapes.
+  if (typeof highlightedDocId.subscribe === "function") {
+    highlightedDocId.subscribe(apply);
+  } else {
+    // Polyfill: poll on mutation. Cheap; signal updates are rare.
+    const orig = highlightedDocId.set.bind(highlightedDocId);
+    highlightedDocId.set = (v) => { orig(v); apply(); };
+  }
+})();
+
+// "Generate auditable report" — snapshots the live map, packs the full
+// evidence (query / plan / per-specialist trace / final result / per-source
+// vintages / labels / urls), parks it in sessionStorage, opens /report.
+$("#reportBtn").addEventListener("click", () => {
+  if (!LAST_RESULT) return;
+  let mapPng = null;
+  try {
+    if (map && map.loaded()) {
+      // preserveDrawingBuffer:false would force a one-frame render here
+      map.triggerRepaint();
+      mapPng = map.getCanvas().toDataURL("image/png");
+    }
+  } catch (e) {
+    console.warn("map snapshot failed", e);
+  }
+  const pkg = {
+    ...LAST_RESULT,
+    plan: LAST_PLAN,
+    trace: LAST_TRACE,
+    mapPng,
+    sourceLabels: SOURCE_LABELS,
+    sourceUrls: SOURCE_URLS,
+    sourceVintages: SOURCE_VINTAGES,
+    stepLabels: STEP_LABELS,
+  };
+  try {
+    sessionStorage.setItem("riprap_report", JSON.stringify(pkg));
+    window.open("/report", "_blank");
+  } catch (e) {
+    alert("Could not stash report payload (storage may be full): " + e.message);
+  }
+});

web/static/app.js

@@ -1,4 +1,4 @@
-// HeliOS-NYC web client. Subscribes to SSE, lights up FSM steps.
+// Riprap web client — subscribes to SSE, lights up FSM steps, renders the report.
 
 const STEP_LABELS = {
   geocode:                ["Geocode (DCP Geosearch)",          "address → lat/lon, BBL"],
@@ -6,6 +6,10 @@ const STEP_LABELS = {
   dep_stormwater:         ["DEP Stormwater Maps",              "pluvial scenarios + 2080 SLR"],
   floodnet:               ["FloodNet sensor network",          "live ultrasonic depth sensors"],
   nyc311:                 ["NYC 311 archive",                  "flood complaints in buffer"],
+  noaa_tides:             ["NOAA Tides & Currents (live)",     "Battery / Kings Pt / Sandy Hook water level"],
+  nws_alerts:             ["NWS Public Alerts (live)",         "active flood-relevant alerts at point"],
+  nws_obs:                ["NWS METAR observation (live)",     "nearest ASOS recent precipitation"],
+  ttm_forecast:           ["Granite TTM r2 (TimeSeries)",      "9.6h surge-residual nowcast at the Battery"],
   microtopo_lidar:        ["LiDAR terrain (DEM + TWI + HAND)", "USGS 3DEP DEM + whitebox-workflows hydrology"],
   ida_hwm_2021:           ["Ida 2021 high-water marks",        "USGS empirical post-event extent"],
   prithvi_eo_v2:          ["Prithvi-EO 2.0 (300M, NASA/IBM)",  "Sen1Floods11 satellite water segmentation"],
@@ -15,6 +19,7 @@ const STEP_LABELS = {
 
 const STEPS_ORDER = [
   "geocode", "sandy_inundation", "dep_stormwater", "floodnet", "nyc311",
+  "noaa_tides", "nws_alerts", "nws_obs", "ttm_forecast",
   "microtopo_lidar", "ida_hwm_2021", "prithvi_eo_v2",
   "rag_granite_embedding", "reconcile_granite41",
 ];
@@ -255,8 +260,45 @@ function rewriteCitations(text) {
   });
 }
 
+function escapeHtml(s) {
+  return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+
+function renderMarkdown(text) {
+  // Tiny safe markdown subset:
+  //   **Header.**          (on its own line) -> <h4 class="rsum-h">Header</h4>
+  //   **inline bold**       (mid-sentence)  -> <strong>...</strong>
+  // We escape HTML first to defang any injection in model output.
+  const lines = text.split("\n");
+  const out = [];
+  let bodyBuf = [];
+  const flushBody = () => {
+    if (!bodyBuf.length) return;
+    const body = bodyBuf.join(" ").trim();
+    bodyBuf = [];
+    if (!body) return;
+    const safe = escapeHtml(body)
+      .replace(/\*\*([^*]+)\*\*/g, "<strong>$1</strong>");
+    out.push(`<p class="rsum-p">${safe}</p>`);
+  };
+  const headerRe = /^\s*\*\*([A-Z][A-Za-z\s/]+)\.\*\*\s*$/;
+  for (const line of lines) {
+    const m = line.match(headerRe);
+    if (m) {
+      flushBody();
+      out.push(`<h4 class="rsum-h">${escapeHtml(m[1])}</h4>`);
+    } else {
+      bodyBuf.push(line);
+    }
+  }
+  flushBody();
+  return out.join("");
+}
+
 function renderParagraph(text) {
-  $("#paragraph").innerHTML = rewriteCitations(text);
+  // Build markdown structure FIRST, then rewrite citations inside. Citations
+  // are bracketed tokens like [sandy] which don't conflict with our markdown.
+  $("#paragraph").innerHTML = rewriteCitations(renderMarkdown(text));
 }
 
 const SOURCE_LABELS = {
@@ -275,6 +317,10 @@ const SOURCE_LABELS = {
   rag_coned:              "Con Edison Climate Change Resilience Plan (Case 22-E-0222)",
   rag_mta:                "MTA Climate Resilience Roadmap (Oct 2025)",
   rag_comptroller:        "NYC Comptroller — \"Is NYC Ready for Rain?\" (2024)",
+  noaa_tides:             "NOAA CO-OPS Tides & Currents — live water level (6-min)",
+  nws_alerts:             "NWS Public Alerts API — active flood-relevant alerts",
+  nws_obs:                "NWS Station Observations — nearest ASOS hourly METAR",
+  ttm_forecast:           "Granite TimeSeries TTM r2 — surge-residual nowcast (Ekambaram et al. 2024, NeurIPS)",
 };
 
 // ----------------------------------------------------------------------
@@ -282,29 +328,129 @@ const SOURCE_LABELS = {
 // evidence cards, policy quotes, methodology footer.
 // ----------------------------------------------------------------------
 
-function tierMeta(score) {
-  // Mirror app/score.py rubric: ≥6 = T1, 4-5 = T2, 2-3 = T3, 1 = T4, 0 = T0.
-  if (score >= 6)  return {tier: 1, label: "High exposure",       help: "Multiple positive flood signals — historical inundation and modeled scenarios both indicate substantial risk."};
-  if (score >= 4)  return {tier: 2, label: "Elevated exposure",   help: "Significant overlap with at least one empirical or modeled scenario."};
-  if (score >= 2)  return {tier: 3, label: "Moderate exposure",   help: "One or two positive signals; localised or scenario-specific risk."};
-  if (score >= 1)  return {tier: 4, label: "Limited exposure",    help: "A single contextual signal; no positive scenario hits."};
-  return            {tier: 0, label: "No flagged exposure",        help: "No positive flood signal across the assessed sources."};
+// Tier meta — uses the new composite breakpoints, mirrors app/score.py.
+// Tooltip copy explicitly states scope: exposure, not damage probability.
+function tierMeta(tier) {
+  if (tier === 1) return {tier: 1, label: "High exposure",
+    help: "Multiple sub-indices saturated; empirical and/or modeled scenarios both indicate substantial exposure. Not a damage probability."};
+  if (tier === 2) return {tier: 2, label: "Elevated exposure",
+    help: "At least one sub-index near saturation; significant overlap with empirical or modeled scenarios. Not a damage probability."};
+  if (tier === 3) return {tier: 3, label: "Moderate exposure",
+    help: "Partial signals across categories; scenario- or neighborhood-specific exposure. Not a damage probability."};
+  if (tier === 4) return {tier: 4, label: "Limited exposure",
+    help: "A single contextual signal; no positive scenario hits."};
+  return {tier: 0, label: "No flagged exposure",
+    help: "No positive flood signal across the assessed sources."};
 }
 
-function computeScore(ev) {
-  // Mirror server-side rubric so we render consistently.
-  let s = 0;
-  if (ev.sandy) s += 3;
+// ---- Score computation: mirrors app/score.py.composite() exactly ---------
+// Three thematic sub-indices, equal weights within each, max-empirical
+// floor. Live signals (NWS alerts, surge, precip) are NOT in this score
+// per IPCC AR6 WG II's distinction between exposure (static) and event
+// occurrence (live).
+const REG_W = {
+  fema_1pct: 1.0, fema_02pct: 0.5,
+  dep_moderate_2050: 0.75, dep_extreme_2080: 0.50, dep_tidal_2050: 0.75,
+};
+const HYD_W = {
+  hand_band: 1.0, twi_quartile: 0.5,
+  elev_pct_200m_inv: 0.5, elev_pct_750m_inv: 0.5, basin_relief_band: 0.25,
+};
+const EMP_W = {
+  sandy: 1.0,
+  ida_hwm_within_100m: 1.0, ida_hwm_within_800m: 0.5,
+  prithvi_polygon: 0.75, complaints_band: 0.75, floodnet_trigger: 0.75,
+};
+
+const handBand   = (h)   => h == null ? 0 : (h < 1 ? 1 : h < 3 ? 0.66 : h < 10 ? 0.33 : 0);
+const pctInvBand = (p)   => p == null ? 0 : (p < 10 ? 1 : p < 25 ? 0.66 : p < 50 ? 0.33 : 0);
+const twiBand    = (t)   => t == null ? 0 : (t >= 12 ? 1 : t >= 10 ? 0.66 : t >= 8 ? 0.33 : 0);
+const reliefBand = (r)   => r == null ? 0 : (r >= 8 ? 1 : r >= 4 ? 0.66 : r >= 2 ? 0.33 : 0);
+const complBand  = (n)   => !n ? 0 : (n >= 10 ? 1 : n >= 3 ? 0.66 : 0.33);
+const sumW = (w) => Object.values(w).reduce((a, b) => a + b, 0);
+
+function computeComposite(ev) {
   const dep = ev.dep || {};
-  if ((dep.dep_extreme_2080?.depth_class || 0) > 0) s += 2;
-  if ((dep.dep_moderate_2050?.depth_class || 0) > 0) s += 2;
-  if ((dep.dep_moderate_current?.depth_class || 0) > 0) s += 1;
-  if ((ev.nyc311?.n || 0) >= 3) s += 1;
-  if ((ev.floodnet?.n_flood_events_3y || 0) > 0) s += 1;
-  if ((ev.rag || []).length) s += 1;
-  return s;
+  const mt  = ev.microtopo || {};
+  const ida = ev.ida_hwm || {};
+  const pw  = ev.prithvi_water || {};
+
+  // Build the signal dict in the shape app/score.py expects.
+  const s = {
+    // Regulatory
+    fema_1pct:           false,            // not yet wired in this build
+    fema_02pct:          false,
+    dep_moderate_2050:   (dep.dep_moderate_2050?.depth_class || 0) > 0,
+    dep_extreme_2080:    (dep.dep_extreme_2080?.depth_class || 0) > 0,
+    dep_tidal_2050:      false,            // tidal scenario not in current FSM
+    // Hydrological
+    hand_m:              mt.hand_m,
+    twi:                 mt.twi,
+    rel_elev_pct_200m:   mt.rel_elev_pct_200m,
+    rel_elev_pct_750m:   mt.rel_elev_pct_750m,
+    basin_relief_m:      mt.basin_relief_m,
+    // Empirical
+    sandy:               !!ev.sandy,
+    ida_hwm_within_100m: (ida.nearest_dist_m != null && ida.nearest_dist_m < 100) ||
+                         (ida.n_within_radius || 0) > 0 && (ida.nearest_dist_m || 9999) < 100,
+    ida_hwm_within_800m: (ida.n_within_radius || 0) > 0,
+    prithvi_polygon:     !!pw.inside_water_polygon,
+    complaints_count:    ev.nyc311?.n || 0,
+    floodnet_trigger:    (ev.floodnet?.n_flood_events_3y || 0) > 0,
+  };
+
+  // Regulatory sub-index (binary signals)
+  let regRaw = 0;
+  for (const [k, w] of Object.entries(REG_W)) regRaw += s[k] ? w : 0;
+  const reg = regRaw / sumW(REG_W);
+
+  // Hydrological sub-index (banded continuous)
+  const hydBands = {
+    hand_band:         handBand(s.hand_m),
+    twi_quartile:      twiBand(s.twi),
+    elev_pct_200m_inv: pctInvBand(s.rel_elev_pct_200m),
+    elev_pct_750m_inv: pctInvBand(s.rel_elev_pct_750m),
+    basin_relief_band: reliefBand(s.basin_relief_m),
+  };
+  let hydRaw = 0;
+  for (const [k, w] of Object.entries(HYD_W)) hydRaw += w * hydBands[k];
+  const hyd = hydRaw / sumW(HYD_W);
+
+  // Empirical sub-index
+  const empVals = {
+    sandy:               s.sandy ? 1 : 0,
+    ida_hwm_within_100m: s.ida_hwm_within_100m ? 1 : 0,
+    ida_hwm_within_800m: s.ida_hwm_within_800m ? 1 : 0,
+    prithvi_polygon:     s.prithvi_polygon ? 1 : 0,
+    complaints_band:     complBand(s.complaints_count),
+    floodnet_trigger:    s.floodnet_trigger ? 1 : 0,
+  };
+  let empRaw = 0;
+  for (const [k, w] of Object.entries(EMP_W)) empRaw += w * empVals[k];
+  const emp = empRaw / sumW(EMP_W);
+
+  const composite = reg + hyd + emp;
+
+  // Tier breakpoints (mirror score.py)
+  let tier = 0;
+  if      (composite >= 1.50) tier = 1;
+  else if (composite >= 1.00) tier = 2;
+  else if (composite >= 0.50) tier = 3;
+  else if (composite >= 0.01) tier = 4;
+
+  // Max-empirical floor: Sandy or HWM-within-100m → tier ≤ 2
+  const floorApplied = !!(s.sandy || s.ida_hwm_within_100m);
+  if (floorApplied && (tier === 0 || tier > 2)) tier = 2;
+
+  return {
+    subindices: {regulatory: reg, hydrological: hyd, empirical: emp},
+    composite, tier, floorApplied,
+  };
 }
 
+// Backward-compat shim: places that called computeScore() now read .tier.
+function computeScore(ev) { return computeComposite(ev).tier; }
+
 function renderHeader(ev) {
   const geo = ev.geocode || {};
   $("#reportAddr").textContent = geo.address || "(unresolved)";
@@ -314,12 +460,13 @@ function renderHeader(ev) {
 }
 
 function renderTier(ev) {
-  const score = computeScore(ev);
-  const m = tierMeta(score);
+  const c = computeComposite(ev);
+  const m = tierMeta(c.tier);
   const badge = $("#tierBadge");
   badge.className = "tier-badge t-" + m.tier;
   $("#tierNum").textContent = m.tier;
-  $("#tierLabel").textContent = `Tier ${m.tier} — ${m.label}`;
+  const floor = c.floorApplied ? " · empirical floor" : "";
+  $("#tierLabel").textContent = `Tier ${m.tier} — ${m.label}${floor}`;
   $("#tierHelp").textContent  = m.help;
 }
 
@@ -557,6 +704,106 @@ function renderEvidence(ev) {
     }));
   }
 
+  // Live signals — refresh every query, may produce nothing on a calm day.
+  const tides = ev.noaa_tides;
+  if (tides && tides.observed_ft_mllw != null) {
+    const rows = [
+      ["Gauge", `${tides.station_name} (${tides.station_id})`],
+      ["Distance to gauge", `${tides.distance_km} km`],
+      ["Observed", `${tides.observed_ft_mllw} ft above MLLW`],
+    ];
+    if (tides.predicted_ft_mllw != null)
+      rows.push(["Predicted (astro tide)", `${tides.predicted_ft_mllw} ft`]);
+    if (tides.residual_ft != null)
+      rows.push(["Residual (obs − pred)", `${tides.residual_ft >= 0 ? "+" : ""}${tides.residual_ft} ft`]);
+    if (tides.obs_time)
+      rows.push(["Observation time", tides.obs_time]);
+    const flag = (tides.residual_ft != null && tides.residual_ft >= 1.0) ? "hit" : "note";
+    cards.push(evCard({
+      key: "noaa_tides",
+      title: "NOAA Tides & Currents — live coastal water level",
+      flag, rows,
+      sourceText: "NOAA CO-OPS API (api.tidesandcurrents.noaa.gov)",
+      sourceUrl: `https://tidesandcurrents.noaa.gov/stationhome.html?id=${tides.station_id}`,
+      vintage: "live, 6-min cadence; residual ≈ surge",
+      collapsed: false,
+    }));
+  }
+
+  const al = ev.nws_alerts;
+  if (al && al.n_active > 0) {
+    const rows = [["Active flood-relevant alerts", String(al.n_active)]];
+    (al.alerts || []).slice(0, 3).forEach((a, i) => {
+      rows.push([
+        `Alert ${i + 1}`,
+        `${a.event} (${a.severity || "?"} / ${a.urgency || "?"}) — expires ${
+          (a.expires || "").slice(0, 16)
+        }`,
+      ]);
+    });
+    cards.push(evCard({
+      key: "nws_alerts",
+      title: "NWS — active flood alerts at this point",
+      flag: "hit", rows,
+      sourceText: "NWS Public Alerts API (api.weather.gov)",
+      sourceUrl: "https://www.weather.gov/documentation/services-web-api",
+      vintage: "live, push-cadence (refresh on event)",
+      collapsed: false,
+    }));
+  }
+
+  const obs = ev.nws_obs;
+  if (obs && obs.station_id && !obs.error && (
+        obs.precip_last_hour_mm != null ||
+        obs.precip_last_6h_mm != null)) {
+    const rows = [
+      ["Nearest ASOS station", `${obs.station_name} (${obs.station_id})`],
+      ["Distance", `${obs.distance_km} km`],
+    ];
+    if (obs.precip_last_hour_mm != null)
+      rows.push(["Precip last 1 h", `${obs.precip_last_hour_mm} mm`]);
+    if (obs.precip_last_3h_mm != null)
+      rows.push(["Precip last 3 h", `${obs.precip_last_3h_mm} mm`]);
+    if (obs.precip_last_6h_mm != null)
+      rows.push(["Precip last 6 h", `${obs.precip_last_6h_mm} mm`]);
+    if (obs.obs_time)
+      rows.push(["Observation time", obs.obs_time]);
+    const heavy = (obs.precip_last_hour_mm || 0) >= 10 ||
+                  (obs.precip_last_6h_mm || 0) >= 25;
+    cards.push(evCard({
+      key: "nws_obs",
+      title: "NWS hourly METAR — recent precipitation",
+      flag: heavy ? "hit" : "note", rows,
+      sourceText: "NWS station observations API",
+      sourceUrl: `https://www.weather.gov/wrh/timeseries?site=${obs.station_id}`,
+      vintage: "live, ~hourly",
+      collapsed: false,
+    }));
+  }
+
+  const ttm = ev.ttm_forecast;
+  if (ttm && ttm.available) {
+    const peak = ttm.forecast_peak_ft;
+    const rows = [
+      ["Gauge", `${ttm.station_name} (NOAA ${ttm.station_id})`],
+      ["Recent residual", `${ttm.history_recent_ft} ft`],
+      ["Recent peak |residual|", `${ttm.history_peak_abs_ft} ft (last ~51 h)`],
+      ["Forecast peak residual", `${peak >= 0 ? "+" : ""}${peak} ft`],
+      ["Forecast peak time", `~${ttm.forecast_peak_minutes_ahead} min ahead (${(ttm.forecast_peak_time_utc || "").slice(11, 16)} UTC)`],
+      ["Threshold", `±${ttm.threshold_ft} ft (gate for emission)`],
+    ];
+    const flag = ttm.interesting ? (Math.abs(peak) >= 0.5 ? "hit" : "note") : "miss";
+    cards.push(evCard({
+      key: "ttm_forecast",
+      title: "Granite TimeSeries TTM r2 — surge nowcast",
+      flag, rows,
+      sourceText: "IBM Granite TimeSeries TTM r2 (Ekambaram et al. 2024, NeurIPS)",
+      sourceUrl: "https://huggingface.co/ibm-granite/granite-timeseries-ttm-r2",
+      vintage: "zero-shot multivariate forecaster, ~1.5M params; runs on CPU",
+      collapsed: !ttm.interesting,
+    }));
+  }
+
   $("#evidenceCards").innerHTML = cards.join("");
 }
 

web/static/components/briefing.js

@@ -0,0 +1,133 @@
+// <r-briefing> — the streaming-token, citation-chipped briefing panel.
+//
+// Replaces the agent.js renderMarkdown + rewriteCitations + paint
+// scheduler. Token streaming becomes "append to a signal, re-render."
+//
+// Properties:
+//   text       — full markdown text (set by parent on token / final events)
+//   streaming  — bool; shows the blinking caret
+//   citeIndex  — { doc_id: number } shared with <r-sources-footer>
+//   sourceLabels — passed through for chip tooltips
+//
+// Signals consumed:
+//   highlightedDocId — toggles `.hl` on chips reactively (set by
+//                      <r-sources-footer> on hover)
+// Signals updated:
+//   citeIndex        — populated as citations are encountered in the text
+//   highlightedDocId — set on chip hover/click
+
+import { html, LitElement } from "https://esm.sh/lit@3";
+import { unsafeHTML } from "https://esm.sh/lit@3/directives/unsafe-html.js";
+import { SignalWatcher } from "https://esm.sh/@lit-labs/signals@0.1.x";
+import { citeIndex, highlightedDocId } from "./signals.js";
+
+// Same minimal markdown subset as agent.js renderMarkdown — kept
+// duplicated for now; will collapse when agent.js stops calling
+// renderMarkdown. After full port this is the only impl.
+function renderMarkdownPure(text) {
+  const lines = text.split("\n");
+  const out = [];
+  let para = []; let bullets = [];
+  const escapeHtml = (s) =>
+    String(s ?? "").replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+  const flushPara = () => {
+    if (!para.length) return;
+    const safe = escapeHtml(para.join(" ").trim())
+      .replace(/\*\*([^*]+)\*\*/g, "<strong>$1</strong>");
+    if (safe) out.push(`<p class="rsum-p">${safe}</p>`);
+    para = [];
+  };
+  const flushBullets = () => {
+    if (!bullets.length) return;
+    const items = bullets.map(b => {
+      const safe = escapeHtml(b.trim()).replace(/\*\*([^*]+)\*\*/g, "<strong>$1</strong>");
+      return `<li>${safe}</li>`;
+    }).join("");
+    out.push(`<ul class="rsum-list">${items}</ul>`);
+    bullets = [];
+  };
+  // Granite sometimes runs all bullets onto one line.
+  const expanded = [];
+  for (const line of lines) {
+    if (line.trim().startsWith("- ") && line.includes(" - ", 2)) {
+      const parts = line.split(/(?:^|(?<=\.\s))\s*-\s+/g).filter(p => p.trim());
+      for (const p of parts) expanded.push("- " + p.trim());
+    } else { expanded.push(line); }
+  }
+  for (const line of expanded) {
+    const m = line.match(/^\s*\*\*([A-Z][A-Za-z\s/]+)\.\*\*\s*$/);
+    if (m) { flushPara(); flushBullets(); out.push(`<h4 class="rsum-h">${escapeHtml(m[1])}</h4>`); }
+    else if (/^\s*[-*]\s+/.test(line)) { flushPara(); bullets.push(line.replace(/^\s*[-*]\s+/, "")); }
+    else { flushBullets(); para.push(line); }
+  }
+  flushPara(); flushBullets();
+  return out.join("");
+}
+
+function rewriteCitations(html, sourceLabels, indexMap) {
+  return html.replace(/\[([a-z0-9_]+)\]/gi, (_, id) => {
+    const norm = id.toLowerCase();
+    if (indexMap[norm] == null) indexMap[norm] = Object.keys(indexMap).length + 1;
+    const n = indexMap[norm];
+    const lab = sourceLabels[norm] || norm;
+    return `<span class="cite" data-src-id="${norm}" data-src-n="${n}" title="${lab.replace(/"/g, "&quot;")} — click to highlight in Sources">${n}</span>`;
+  });
+}
+
+export class Briefing extends SignalWatcher(LitElement) {
+  static properties = {
+    text:         { type: String },
+    streaming:    { type: Boolean, reflect: true },
+    sourceLabels: { type: Object },
+  };
+
+  // No shadow DOM — we use the parent's `.report-pane #paragraph` styles
+  // directly so the markdown renders match the legacy/print idiom.
+  createRenderRoot() { return this; }
+
+  constructor() {
+    super();
+    this.text = "";
+    this.streaming = false;
+    this.sourceLabels = {};
+  }
+
+  updated(changed) {
+    if (changed.has("text") && this.text) {
+      // Bind chip hover/click to the highlight signal post-render.
+      this._bindChips();
+    }
+  }
+
+  _bindChips() {
+    this.querySelectorAll(".cite").forEach(c => {
+      const id = c.dataset.srcId;
+      if (!id || c.dataset.signalBound) return;
+      c.dataset.signalBound = "1";
+      c.addEventListener("mouseenter", () => highlightedDocId.set(id));
+      c.addEventListener("click", (e) => {
+        e.stopPropagation();
+        const cur = highlightedDocId.get();
+        highlightedDocId.set(cur === id ? null : id);
+      });
+    });
+    // Apply highlight class reactively from current signal value.
+    const hl = highlightedDocId.get();
+    this.querySelectorAll(".cite").forEach(c => {
+      c.classList.toggle("hl", c.dataset.srcId === hl);
+    });
+  }
+
+  render() {
+    if (!this.text) return html`<div class="rsum-p" style="color:var(--text-muted)">Waiting for content…</div>`;
+    const indexMap = {};
+    const md = renderMarkdownPure(this.text);
+    const withCites = rewriteCitations(md, this.sourceLabels, indexMap);
+    // Push the citation index up to the shared signal so SourcesFooter
+    // re-renders. Done in render() because indexMap is computed here.
+    queueMicrotask(() => citeIndex.set({ ...indexMap }));
+    return html`${unsafeHTML(withCites)}`;
+  }
+}
+
+customElements.define("r-briefing", Briefing);

web/static/components/signals.js

@@ -0,0 +1,21 @@
+// Shared reactive state for Riprap web components.
+//
+// Lit components import these signals; updating one signal re-renders
+// every subscribed component. Replaces the hand-wired DOM-querying
+// cross-linking we used to do in vanilla JS.
+
+import { signal } from "https://esm.sh/@lit-labs/signals@0.1.x";
+
+// Currently-highlighted citation doc_id. When a Briefing chip is hovered
+// or clicked, this gets set; SourcesFooter observes it and highlights
+// the matching row, and vice versa.
+export const highlightedDocId = signal(null);
+
+// The full agent run output (from /api/agent/stream `final` event).
+// Components that need the result post-render read from this.
+export const lastResult = signal(null);
+
+// The cite-index map { doc_id: number } populated by Briefing as it
+// renders the streamed markdown. SourcesFooter reads it to know which
+// numbered rows to render.
+export const citeIndex = signal({});

web/static/components/sources-footer.js

@@ -0,0 +1,144 @@
+// <r-sources-footer> — numbered, hyperlinked, vintage-aware Sources
+// section that appears below the Briefing in the agent UI and inside
+// the printable /report.
+//
+// Shared signals power the cross-linking with <r-briefing>: hovering
+// a [N] chip in the prose highlights the matching <li> here, and
+// clicking either side persists the highlight + scrolls into view.
+//
+// Mounts via <r-sources-footer></r-sources-footer>. Reads:
+//   - citeIndex     — { doc_id: number } from Briefing
+//   - highlightedDocId — current highlight target (in/out)
+// Plus three label/url/vintage maps passed in as properties.
+
+import { html, css, LitElement } from "https://esm.sh/lit@3";
+import { SignalWatcher } from "https://esm.sh/@lit-labs/signals@0.1.x";
+import { citeIndex, highlightedDocId } from "./signals.js";
+
+export class SourcesFooter extends SignalWatcher(LitElement) {
+  static properties = {
+    labels:   { type: Object },
+    urls:     { type: Object },
+    vintages: { type: Object },
+  };
+
+  static styles = css`
+    :host {
+      display: block;
+      border-top: 1px solid var(--line, #e5e7eb);
+      background: var(--bg-soft, #f5f7fb);
+      padding: 12px 16px 14px;
+    }
+    :host([hidden]) { display: none; }
+    .src-h {
+      font-size: 10px; font-weight: 700;
+      text-transform: uppercase; letter-spacing: 0.10em;
+      color: var(--text-muted, #6b7280);
+      margin: 0 0 8px;
+    }
+    ol {
+      margin: 0; padding: 0; list-style: none;
+      display: grid; gap: 6px;
+      font-size: 11.5px; line-height: 1.45;
+    }
+    li {
+      display: grid; grid-template-columns: 22px 1fr;
+      gap: 8px; align-items: baseline;
+      padding: 4px 6px; border-radius: 3px;
+      cursor: pointer;
+      transition: background 0.15s;
+    }
+    li:hover, li.hl {
+      background: rgba(22, 66, 223, 0.10);
+    }
+    .src-num {
+      font-family: var(--mono, monospace); font-size: 10.5px;
+      font-weight: 700; color: var(--nyc-blue, #1642DF);
+      text-align: right;
+    }
+    .src-link {
+      color: var(--text, #111); text-decoration: none;
+      border-bottom: 1px dotted var(--text-muted, #6b7280);
+      transition: color 0.12s, border-color 0.12s;
+    }
+    .src-link:hover {
+      color: var(--nyc-blue, #1642DF);
+      border-bottom-color: var(--nyc-blue, #1642DF);
+    }
+    .src-ext {
+      font-size: 9.5px; color: var(--text-faint, #9ca3af);
+      margin-left: 2px; vertical-align: super;
+    }
+    .src-vintage {
+      display: block; color: var(--text-muted, #6b7280);
+      font-size: 9.5px; margin-top: 2px;
+    }
+    .src-id {
+      display: inline-block;
+      font-family: var(--mono, monospace); font-size: 9.5px;
+      color: var(--text-faint, #9ca3af); margin-left: 6px;
+    }
+  `;
+
+  constructor() {
+    super();
+    this.labels = {};
+    this.urls = {};
+    this.vintages = {};
+  }
+
+  _entries() {
+    return Object.entries(citeIndex.get() || {}).sort((a, b) => a[1] - b[1]);
+  }
+
+  _onHover(id) {
+    highlightedDocId.set(id);
+  }
+
+  _onLeave() {
+    // Only clear if not pinned by click — keep highlight on click.
+    // For now, hover-only highlight clears on leave.
+  }
+
+  _onClick(id) {
+    const cur = highlightedDocId.get();
+    highlightedDocId.set(cur === id ? null : id);
+  }
+
+  render() {
+    const entries = this._entries();
+    if (!entries.length) {
+      this.setAttribute("hidden", "");
+      return html``;
+    }
+    this.removeAttribute("hidden");
+    const hl = highlightedDocId.get();
+    return html`
+      <div class="src-h">Sources</div>
+      <ol>
+        ${entries.map(([id, n]) => {
+          const url = this.urls[id];
+          const label = this.labels[id] || id;
+          const vintage = this.vintages[id];
+          const cls = id === hl ? "hl" : "";
+          return html`
+            <li class="${cls}"
+                @mouseenter=${() => this._onHover(id)}
+                @click=${() => this._onClick(id)}>
+              <span class="src-num">[${n}]</span>
+              <div>
+                ${url
+                  ? html`<a class="src-link" href="${url}" target="_blank" rel="noopener noreferrer" @click=${(e) => e.stopPropagation()}>${label} <span class="src-ext">↗</span></a>`
+                  : html`<span>${label}</span>`}
+                <span class="src-id">${id}</span>
+                ${vintage ? html`<span class="src-vintage">${vintage}</span>` : ""}
+              </div>
+            </li>
+          `;
+        })}
+      </ol>
+    `;
+  }
+}
+
+customElements.define("r-sources-footer", SourcesFooter);

web/static/components/trace.js

@@ -0,0 +1,87 @@
+// <r-trace> — specialist trail. Reactive list of pipeline steps.
+//
+// API:
+//   .pushStep(step)    — append a {step, ok, elapsed_s, result, err} record
+//   .clear()           — reset
+//   .meta = "1.4s"     — text shown in the header
+//   .stepLabels = {...} — { stepName: [label, hint] } map (set once at boot)
+//
+// Light DOM (no shadow) so the existing `#steps li.ok / .err / .running`
+// CSS in agent.html keeps applying without rewrites.
+
+import { html, css, LitElement } from "https://esm.sh/lit@3";
+
+const escapeHtml = (s) =>
+  String(s ?? "").replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+
+export class Trace extends LitElement {
+  static properties = {
+    steps:      { type: Array, state: true },
+    meta:       { type: String, reflect: true },
+    stepLabels: { type: Object },
+  };
+
+  createRenderRoot() { return this; }
+
+  constructor() {
+    super();
+    this.steps = [];
+    this.meta = "";
+    this.stepLabels = {};
+  }
+
+  pushStep(step) {
+    this.steps = [...this.steps, step];
+  }
+
+  clear() {
+    this.steps = [];
+    this.meta = "";
+  }
+
+  _renderStep(step) {
+    const [label, hint] = this.stepLabels[step.step] || [step.step, ""];
+    const ok = step.ok === true;
+    const fail = step.ok === false;
+    const cls = ok ? "ok" : fail ? "err" : "running";
+    const mark = ok ? "✓" : fail ? "✗" : "○";
+    const time = step.elapsed_s != null
+      ? `<span class="time">${step.elapsed_s}s</span>` : "";
+    const result = step.result
+      ? `<div class="result">${escapeHtml(JSON.stringify(step.result))}</div>` : "";
+    const err = step.err
+      ? `<div class="result" style="color:var(--nyc-scarlet)">${escapeHtml(step.err)}</div>` : "";
+    // Inner HTML is hand-built so the existing list CSS targets the same
+    // structure as the legacy renderer; we keep .innerHTML rather than
+    // Lit's html`` for byte-for-byte parity here.
+    const li = document.createElement("li");
+    li.className = cls;
+    li.innerHTML = `
+      <span class="icon">${mark}</span>
+      <div>
+        <div class="label">${escapeHtml(label)}</div>
+        <div class="meta">${escapeHtml(hint)}</div>
+      </div>
+      ${time}
+      ${result}
+      ${err}
+    `;
+    return li;
+  }
+
+  render() {
+    // Render the <ol> as innerHTML on update so we don't fight Lit's
+    // template diffing for raw HTML lists.
+    queueMicrotask(() => {
+      const ol = this.querySelector("ol#steps-list");
+      if (!ol) return;
+      ol.innerHTML = "";
+      for (const s of this.steps) ol.appendChild(this._renderStep(s));
+    });
+    // Inline reset so the legacy `#steps { list-style: none; ... }` rules
+    // (which now target the host element, not the <ol>) keep applying.
+    return html`<ol id="steps-list" style="list-style:none; margin:0; padding:4px 0; font-size:12.5px;"></ol>`;
+  }
+}
+
+customElements.define("r-trace", Trace);

web/static/index.html

@@ -14,7 +14,7 @@
       <div class="brand">
         <span class="brand-name">Riprap</span>
         <span class="brand-sep">·</span>
-        <span class="brand-tag">citation-grounded civic AI for NYC flood risk</span>
+        <span class="brand-tag">citation-grounded flood-exposure briefings for NYC — not a risk score</span>
       </div>
       <div class="topbar-right">
         <a href="/compare" class="modelink">compare</a>

web/static/report.html

@@ -0,0 +1,244 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<title>Riprap — auditable flood-exposure report</title>
+<link rel="stylesheet" href="/static/style.css">
+<style>
+:root {
+  --paper-w: 8.5in;
+  --paper-pad: 0.55in;
+}
+* { box-sizing: border-box; }
+body {
+  background: #e9eef5; margin: 0; padding: 24px 0;
+  font-family: var(--font-sans), system-ui, sans-serif;
+  color: var(--text);
+}
+.report-controls {
+  max-width: var(--paper-w); margin: 0 auto 16px; padding: 0 12px;
+  display: flex; gap: 12px; align-items: center;
+}
+.report-controls .lhs {
+  font-size: 12px; color: var(--text-muted);
+}
+.report-controls .actions {
+  margin-left: auto; display: flex; gap: 8px;
+}
+.btn-primary {
+  padding: 8px 16px; border: 0; border-radius: 4px;
+  background: var(--nyc-blue); color: white;
+  font-weight: 600; font-size: 13px; cursor: pointer;
+  font-family: inherit;
+}
+.btn-secondary {
+  padding: 8px 16px; border: 1px solid var(--line);
+  background: var(--panel); color: var(--text);
+  border-radius: 4px; font-size: 13px; cursor: pointer;
+  font-family: inherit; font-weight: 500;
+}
+.btn-primary:hover { background: #0f329d; }
+.btn-secondary:hover { background: var(--bg-soft); }
+
+.paper {
+  background: white;
+  width: var(--paper-w);
+  margin: 0 auto;
+  padding: var(--paper-pad);
+  box-shadow: 0 4px 24px rgba(0,0,0,0.08);
+  font-size: 11pt;
+  line-height: 1.45;
+  color: #111;
+}
+
+/* report-specific typography */
+.r-head {
+  border-bottom: 2px solid #111;
+  padding-bottom: 12px; margin-bottom: 18px;
+}
+.r-brand {
+  font-weight: 700; font-size: 18pt; color: var(--nyc-blue);
+  letter-spacing: -0.01em;
+}
+.r-tagline {
+  font-size: 9pt; color: #555; margin-top: 2px;
+  text-transform: uppercase; letter-spacing: 0.06em;
+}
+.r-meta-grid {
+  display: grid; grid-template-columns: max-content 1fr;
+  gap: 4px 12px; font-size: 9.5pt; margin-top: 12px;
+}
+.r-meta-grid dt {
+  color: #666; font-weight: 600;
+  text-transform: uppercase; letter-spacing: 0.05em;
+  font-size: 8.5pt;
+}
+.r-meta-grid dd { margin: 0; color: #111; }
+.r-meta-grid dd.mono { font-family: var(--mono); font-size: 9pt; }
+
+.r-section {
+  margin-top: 22px;
+  page-break-inside: avoid;
+}
+.r-section h2 {
+  font-size: 9pt; font-weight: 700;
+  text-transform: uppercase; letter-spacing: 0.10em;
+  color: #444; margin: 0 0 8px;
+  border-bottom: 1px solid #ccc; padding-bottom: 4px;
+}
+.r-section .lead { font-size: 10pt; color: #333; margin-bottom: 8px; }
+
+.r-query {
+  background: #f5f7fb; padding: 10px 14px;
+  border-left: 3px solid var(--nyc-blue);
+  font-style: italic; font-size: 11pt; color: #222;
+}
+
+.r-plan {
+  display: grid; grid-template-columns: max-content 1fr;
+  gap: 4px 12px; font-size: 9.5pt;
+}
+.r-plan dt {
+  color: #666; font-weight: 600;
+  text-transform: uppercase; letter-spacing: 0.05em; font-size: 8pt;
+}
+.r-plan dd { margin: 0; }
+.r-plan dd.mono { font-family: var(--mono); font-size: 9pt; }
+.r-plan-rationale {
+  grid-column: 1 / -1;
+  margin-top: 6px; padding-top: 6px;
+  border-top: 1px dotted #ccc;
+  color: #444; font-style: italic; font-size: 9.5pt;
+}
+
+.r-trace {
+  width: 100%; border-collapse: collapse; font-size: 8.5pt;
+}
+.r-trace th, .r-trace td {
+  text-align: left; padding: 5px 8px;
+  border-bottom: 1px solid #eee;
+  vertical-align: top;
+}
+.r-trace th {
+  background: #f5f7fb; color: #444;
+  font-weight: 700; text-transform: uppercase;
+  letter-spacing: 0.05em; font-size: 7.5pt;
+}
+.r-trace tr.ok    .mark { color: #1a8754; }
+.r-trace tr.err   .mark { color: #c0392b; }
+.r-trace .mono { font-family: var(--mono); }
+.r-trace .mark { font-weight: 700; }
+.r-trace .result {
+  font-family: var(--mono); font-size: 7.5pt;
+  color: #555; word-break: break-word;
+  max-width: 280px;
+}
+.r-trace .err-msg {
+  color: #c0392b; font-style: italic; font-size: 8pt;
+}
+
+.r-map { margin-top: 6px; }
+.r-map img {
+  width: 100%; height: auto; display: block;
+  border: 1px solid #ddd; border-radius: 2px;
+}
+.r-map .legend-cap {
+  font-size: 8pt; color: #666; margin-top: 4px;
+  text-align: center; font-style: italic;
+}
+.r-map.no-map {
+  padding: 24px; background: #f5f7fb; border: 1px dashed #ccc;
+  color: #888; text-align: center; font-size: 9pt;
+}
+
+.r-briefing { font-size: 10pt; }
+.r-briefing h4 {
+  font-size: 9pt; font-weight: 700;
+  text-transform: uppercase; letter-spacing: 0.06em;
+  color: #555; margin: 14px 0 4px;
+}
+.r-briefing h4:first-child { margin-top: 0; }
+.r-briefing p { margin: 0 0 6px; line-height: 1.55; }
+.r-briefing ul { margin: 4px 0 8px 0; padding-left: 20px; }
+.r-briefing ul li { margin: 3px 0; line-height: 1.5; }
+.r-briefing strong { font-weight: 700; background: #fff7d6; padding: 0 1px; }
+.r-briefing .cite {
+  display: inline-block; vertical-align: super;
+  font-size: 7pt; font-family: var(--mono);
+  padding: 0 4px; margin-left: 1px;
+  background: #f5f7fb; color: var(--nyc-blue);
+  border-radius: 6px; font-weight: 700;
+}
+
+.r-sources {
+  font-size: 9pt;
+}
+.r-sources ol {
+  list-style: none; padding: 0; margin: 0;
+}
+.r-sources li {
+  display: grid; grid-template-columns: 26px 1fr;
+  gap: 8px; padding: 6px 0;
+  border-bottom: 1px dotted #ddd;
+  page-break-inside: avoid;
+}
+.r-sources li:last-child { border-bottom: 0; }
+.r-sources .num {
+  font-family: var(--mono); font-weight: 700;
+  color: var(--nyc-blue); font-size: 9pt; text-align: right;
+}
+.r-sources .label { font-weight: 600; color: #111; }
+.r-sources .vintage {
+  display: block; color: #666; font-size: 8.5pt; margin-top: 2px;
+}
+.r-sources .url {
+  display: block; font-family: var(--mono);
+  font-size: 8pt; color: #444; margin-top: 2px;
+  word-break: break-all;
+}
+.r-sources .url a { color: var(--nyc-blue); text-decoration: none; }
+
+.r-method {
+  font-size: 8.5pt; color: #555; line-height: 1.5;
+}
+.r-method p { margin: 0 0 6px; }
+
+.r-foot {
+  margin-top: 22px; padding-top: 10px;
+  border-top: 1px solid #ccc;
+  font-size: 7.5pt; color: #888;
+  display: flex; justify-content: space-between;
+}
+
+/* PRINT — strip chrome, force letter, page-break-aware */
+@media print {
+  body { background: white; padding: 0; }
+  .report-controls { display: none; }
+  .paper {
+    box-shadow: none; margin: 0;
+    width: auto; padding: 0.5in;
+  }
+  @page { size: letter; margin: 0; }
+}
+</style>
+</head>
+<body>
+<div class="report-controls">
+  <div class="lhs"><strong>Auditable report</strong> · ready to print or save as PDF</div>
+  <div class="actions">
+    <button class="btn-secondary" onclick="window.close()">Close</button>
+    <button class="btn-primary" onclick="window.print()">Print / Save PDF</button>
+  </div>
+</div>
+
+<article class="paper" id="paper">
+  <div style="padding: 60px 0; text-align: center; color: #888;">
+    Loading report from agent session…
+    <br><br>
+    <small>If this hangs, the report payload wasn't found in sessionStorage. Re-run the query and click <em>Generate auditable report</em> from there.</small>
+  </div>
+</article>
+
+<script src="/static/report.js"></script>
+</body>
+</html>

web/static/report.js

@@ -0,0 +1,218 @@
+// Renders the print-ready auditable report from the agent's last result,
+// passed via sessionStorage. Includes original query, planner decision,
+// full specialist trail, map snapshot, briefing prose with citations,
+// and a Sources section listing every doc_id with its vintage + URL.
+
+(function () {
+  const raw = sessionStorage.getItem("riprap_report");
+  if (!raw) return;
+  let pkg;
+  try { pkg = JSON.parse(raw); } catch (e) {
+    document.getElementById("paper").innerHTML =
+      `<p style="color:#c00">Could not parse stored report payload: ${e.message}</p>`;
+    return;
+  }
+  render(pkg);
+})();
+
+function escapeHtml(s) {
+  return String(s ?? "").replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+
+function render(pkg) {
+  const r = pkg.result || {};
+  const plan = pkg.plan || r.plan || {};
+  const trace = pkg.trace || [];
+  const labels = pkg.sourceLabels || {};
+  const urls = pkg.sourceUrls || {};
+  const vintages = pkg.sourceVintages || {};
+  const stepLabels = pkg.stepLabels || {};
+
+  const intent = r.intent || plan.intent || "—";
+  const intentTitleMap = {
+    single_address:    "Flood-exposure briefing — address",
+    neighborhood:      "Flood-exposure briefing — neighborhood",
+    development_check: "Active development × flood exposure",
+    live_now:          "Current conditions — NYC",
+  };
+  const place = (r.target && r.target.nta_name)
+              || (r.geocode && r.geocode.address)
+              || r.place || "—";
+
+  // Build the citation index from the briefing prose so we render a
+  // numbered Sources section in the SAME order the chips appear in the
+  // text — same idiom as the agent UI.
+  const citeIndex = {};
+  const para = r.paragraph || "";
+  const para2 = para.replace(/\[([a-z0-9_]+)\]/gi, (_, id) => {
+    const norm = id.toLowerCase();
+    if (citeIndex[norm] == null) citeIndex[norm] = Object.keys(citeIndex).length + 1;
+    return `<span class="cite">${citeIndex[norm]}</span>`;
+  });
+
+  const html = `
+    <header class="r-head">
+      <div class="r-brand">Riprap</div>
+      <div class="r-tagline">Citation-grounded flood-exposure briefing</div>
+      <dl class="r-meta-grid">
+        <dt>Subject</dt><dd>${escapeHtml(intentTitleMap[intent] || "Briefing")} · <strong>${escapeHtml(place)}</strong></dd>
+        ${r.geocode && r.geocode.borough ? `<dt>Borough</dt><dd>${escapeHtml(r.geocode.borough)}</dd>` : ""}
+        ${r.target && r.target.borough ? `<dt>Borough</dt><dd>${escapeHtml(r.target.borough)}</dd>` : ""}
+        ${r.geocode && r.geocode.bbl ? `<dt>BBL</dt><dd class="mono">${escapeHtml(r.geocode.bbl)}</dd>` : ""}
+        ${r.target && r.target.nta_code ? `<dt>NTA</dt><dd class="mono">${escapeHtml(r.target.nta_code)}</dd>` : ""}
+        <dt>Generated</dt><dd>${escapeHtml(pkg.finishedAt || new Date().toISOString())}</dd>
+        <dt>Total runtime</dt><dd>${pkg.wallSeconds ?? r.total_s ?? "—"} s</dd>
+      </dl>
+    </header>
+
+    <section class="r-section">
+      <h2>1 · Original query</h2>
+      <div class="r-query">"${escapeHtml(pkg.query)}"</div>
+    </section>
+
+    <section class="r-section">
+      <h2>2 · Agent routing decision</h2>
+      <dl class="r-plan">
+        <dt>Intent</dt><dd class="mono">${escapeHtml(plan.intent || intent)}</dd>
+        <dt>Targets</dt><dd class="mono">${escapeHtml((plan.targets || []).map(t => `${t.type}:${t.text}`).join(", ") || "—")}</dd>
+        <dt>Specialists requested</dt><dd class="mono">${escapeHtml((plan.specialists || []).join(", ") || "—")}</dd>
+        ${plan.rationale ? `<dd class="r-plan-rationale">"${escapeHtml(plan.rationale)}"</dd>` : ""}
+      </dl>
+    </section>
+
+    <section class="r-section">
+      <h2>3 · Specialist trail</h2>
+      <div class="lead">${trace.length} specialists invoked. Each row shows the
+        step name, status, elapsed time, and the structured result the step
+        produced. Sources of any data referenced in the briefing appear in
+        Section 6.</div>
+      <table class="r-trace">
+        <thead>
+          <tr><th>#</th><th>Step</th><th>Status</th><th>Elapsed</th><th>Result / error</th></tr>
+        </thead>
+        <tbody>
+          ${trace.map((s, i) => {
+            const ok = s.ok === true;
+            const fail = s.ok === false;
+            const cls = ok ? "ok" : fail ? "err" : "";
+            const mark = ok ? "✓" : fail ? "✗" : "○";
+            const [label] = stepLabels[s.step] || [s.step, ""];
+            const detail = s.err
+              ? `<span class="err-msg">${escapeHtml(s.err)}</span>`
+              : `<span class="result">${escapeHtml(JSON.stringify(s.result ?? {}))}</span>`;
+            return `<tr class="${cls}">
+              <td class="mono">${i + 1}</td>
+              <td><strong>${escapeHtml(label)}</strong><br>
+                  <span class="mono" style="color:#888;font-size:7.5pt">${escapeHtml(s.step)}</span></td>
+              <td><span class="mark">${mark}</span></td>
+              <td class="mono">${s.elapsed_s != null ? s.elapsed_s + "s" : "—"}</td>
+              <td>${detail}</td>
+            </tr>`;
+          }).join("")}
+        </tbody>
+      </table>
+    </section>
+
+    ${pkg.mapPng ? `
+    <section class="r-section">
+      <h2>4 · Map (snapshot)</h2>
+      <div class="r-map">
+        <img src="${pkg.mapPng}" alt="Map snapshot at report-generation time">
+        <div class="legend-cap">Snapshot of the live MapLibre map captured at report-generation time. Layers: per-intent (Sandy 2012 / DEP scenarios / NTA boundary / DOB permit pins / address pin).</div>
+      </div>
+    </section>
+    ` : `
+    <section class="r-section">
+      <h2>4 · Map</h2>
+      <div class="r-map no-map">No map snapshot was captured (the map may have been hidden or empty for this query type).</div>
+    </section>
+    `}
+
+    <section class="r-section">
+      <h2>5 · Cited briefing</h2>
+      <div class="r-briefing">${renderBriefingMarkdown(para2)}</div>
+    </section>
+
+    <section class="r-section">
+      <h2>6 · Sources</h2>
+      <ol class="r-sources">
+        ${Object.entries(citeIndex).sort((a, b) => a[1] - b[1]).map(([id, n]) => {
+          const url = urls[id];
+          return `<li>
+            <span class="num">[${n}]</span>
+            <div>
+              <span class="label">${escapeHtml(labels[id] || id)}</span>
+              ${vintages[id] ? `<span class="vintage">Vintage: ${escapeHtml(vintages[id])}</span>` : ""}
+              ${url ? `<span class="url"><a href="${escapeHtml(url)}">${escapeHtml(url)}</a></span>` : ""}
+              <span class="vintage" style="font-family:var(--mono);font-size:8pt;color:#888">doc_id: ${escapeHtml(id)}</span>
+            </div>
+          </li>`;
+        }).join("")}
+      </ol>
+    </section>
+
+    <section class="r-section">
+      <h2>7 · Methodology &amp; honest scope</h2>
+      <div class="r-method">
+        <p><strong>This is an exposure briefing, not a damage probability or insurance rating.</strong> Tier and headline statistics are computed from a deterministic, peer-reviewed-grounded rubric (see <em>METHODOLOGY.md</em> in the source repository). The synthesis prose is generated by IBM Granite 4.1 in document-grounded mode; every numeric claim is verified to appear verbatim in a source document before render, and unsupported sentences are dropped.</p>
+        <p><strong>Stack:</strong> Granite 4.1 (3b planner / 8b reconciler) via Ollama, Granite Embedding 278M for RAG over agency reports, Granite TimeSeries TTM r2 for live surge nowcast, Prithvi-EO 2.0 for satellite-derived flood polygons (offline pre-computed). Apache-2.0 across the stack. Inference runs locally on the deploying machine; no vendor LLM is contacted at runtime.</p>
+        <p><strong>Out of scope:</strong> engineering vulnerability (foundation/structural fragility), social capacity, financial absorption, sub-surface flooding (basement apartments, subway entrances). Datasets are vintage-bounded as noted per source above.</p>
+      </div>
+    </section>
+
+    <footer class="r-foot">
+      <span>Generated by Riprap · https://huggingface.co/spaces/msradam/riprap-nyc</span>
+      <span>${escapeHtml(pkg.finishedAt || "")}</span>
+    </footer>
+  `;
+  document.getElementById("paper").innerHTML = html;
+  // Update tab title to reflect the subject
+  document.title = `Riprap — ${place}`;
+}
+
+// Subset markdown for the briefing: `**Header.**` lines → <h4>; `- ` lines
+// → <ul><li>; inline `**foo**` → <strong>; rest → <p>. Keep parity with
+// agent.js's renderMarkdown so reports look like the live UI.
+function renderBriefingMarkdown(text) {
+  const lines = text.split("\n");
+  const out = [];
+  let para = []; let bullets = [];
+  const flushPara = () => {
+    if (!para.length) return;
+    const safe = para.join(" ").trim().replace(/\*\*([^*]+)\*\*/g, "<strong>$1</strong>");
+    if (safe) out.push(`<p>${safe}</p>`);
+    para = [];
+  };
+  const flushBullets = () => {
+    if (!bullets.length) return;
+    const items = bullets.map(b => {
+      const safe = b.trim().replace(/\*\*([^*]+)\*\*/g, "<strong>$1</strong>");
+      return `<li>${safe}</li>`;
+    }).join("");
+    out.push(`<ul>${items}</ul>`);
+    bullets = [];
+  };
+  // Pre-split inline-bullet runs that Granite occasionally emits as one line
+  const expanded = [];
+  for (const line of lines) {
+    if (line.trim().startsWith("- ") && line.includes(" - ", 2)) {
+      const parts = line.split(/(?:^|(?<=\.\s))\s*-\s+/g).filter(p => p.trim());
+      for (const p of parts) expanded.push("- " + p.trim());
+    } else { expanded.push(line); }
+  }
+  for (const line of expanded) {
+    const m = line.match(/^\s*\*\*([A-Z][A-Za-z\s/]+)\.\*\*\s*$/);
+    if (m) {
+      flushPara(); flushBullets();
+      out.push(`<h4>${m[1]}</h4>`);
+    } else if (/^\s*[-*]\s+/.test(line)) {
+      flushPara();
+      bullets.push(line.replace(/^\s*[-*]\s+/, ""));
+    } else {
+      flushBullets();
+      para.push(line);
+    }
+  }
+  flushPara(); flushBullets();
+  return out.join("");
+}

web/static/style.css

@@ -116,6 +116,32 @@ a:hover { text-decoration: underline; }
 
 @keyframes pulse { 0%,100%{opacity:1} 50%{opacity:.45} }
 
+/* Backend pill state colors. Green = primary reachable; amber =
+   running on the configured fallback; gray = checking; red = nothing
+   reachable. */
+.local-pill[data-state="loading"] {
+  color: #6c757d;
+  background: rgba(108, 117, 125, 0.08);
+  border-color: rgba(108, 117, 125, 0.30);
+}
+.local-pill[data-state="loading"] .dot { background: #6c757d; box-shadow: none; }
+.local-pill[data-state="fallback"] {
+  color: #b06b00;
+  background: rgba(176, 107, 0, 0.10);
+  border-color: rgba(176, 107, 0, 0.35);
+}
+.local-pill[data-state="fallback"] .dot {
+  background: #b06b00; box-shadow: 0 0 6px rgba(176, 107, 0, 0.7);
+}
+.local-pill[data-state="down"] {
+  color: #b00020;
+  background: rgba(176, 0, 32, 0.08);
+  border-color: rgba(176, 0, 32, 0.35);
+}
+.local-pill[data-state="down"] .dot {
+  background: #b00020; box-shadow: 0 0 6px rgba(176, 0, 32, 0.7);
+}
+
 /* ----- Form bar ----- */
 
 .form-bar {
@@ -218,9 +244,10 @@ button.chip:hover {
 }
 .col-right {
   display: flex; flex-direction: column; gap: 12px;
-  position: sticky; top: calc(var(--topbar-h) + 14px);
-  max-height: calc(100vh - var(--topbar-h) - 28px);
-  overflow: auto;
+  /* No viewport clamp: report flows to its natural height. The page
+     scrolls vertically when content exceeds viewport — with an internal
+     scrollbar (the previous behavior) the bottom citations were
+     unreachable for users who didn't notice the thin inner scrollbar. */
 }
 
 /* ----- Panels ----- */
@@ -501,6 +528,26 @@ button.chip:hover {
   line-height: 1.55;
   color: var(--text);
 }
+/* Section structure inside the summary (Status / Empirical / Modeled / Policy).
+   The reconciler emits markdown headers like `**Status.**` on their own line;
+   renderMarkdown() converts them to <h4 class="rsum-h">. */
+.summary-box #paragraph .rsum-h {
+  margin: 12px 0 4px;
+  font-size: 10.5px;
+  font-weight: 700;
+  text-transform: uppercase;
+  letter-spacing: 0.08em;
+  color: var(--text-muted);
+}
+.summary-box #paragraph .rsum-h:first-child { margin-top: 0; }
+.summary-box #paragraph .rsum-p {
+  margin: 0 0 4px;
+}
+.summary-box #paragraph .rsum-p strong {
+  font-weight: 600;
+  background: linear-gradient(transparent 60%, var(--nyc-blue-soft) 60%);
+  padding: 0 2px;
+}
 .summary-box #paragraph .cite {
   display: inline-block;
   vertical-align: super;

web/svelte/package-lock.json

@@ -0,0 +1,1337 @@
+{
+  "name": "riprap-svelte",
+  "version": "0.1.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "riprap-svelte",
+      "version": "0.1.0",
+      "devDependencies": {
+        "@sveltejs/vite-plugin-svelte": "^4.0.0",
+        "svelte": "^5.0.0",
+        "vite": "^5.4.0"
+      }
+    },
+    "node_modules/@esbuild/aix-ppc64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.21.5.tgz",
+      "integrity": "sha512-1SDgH6ZSPTlggy1yI6+Dbkiz8xzpHJEVAlF/AM1tHPLsf5STom9rwtjE4hKAF20FfXXNTFqEYXyJNWh1GiZedQ==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "aix"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/android-arm": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.21.5.tgz",
+      "integrity": "sha512-vCPvzSjpPHEi1siZdlvAlsPxXl7WbOVUBBAowWug4rJHb68Ox8KualB+1ocNvT5fjv6wpkX6o/iEpbDrf68zcg==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/android-arm64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.21.5.tgz",
+      "integrity": "sha512-c0uX9VAUBQ7dTDCjq+wdyGLowMdtR/GoC2U5IYk/7D1H1JYC0qseD7+11iMP2mRLN9RcCMRcjC4YMclCzGwS/A==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/android-x64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.21.5.tgz",
+      "integrity": "sha512-D7aPRUUNHRBwHxzxRvp856rjUHRFW1SdQATKXH2hqA0kAZb1hKmi02OpYRacl0TxIGz/ZmXWlbZgjwWYaCakTA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/darwin-arm64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.21.5.tgz",
+      "integrity": "sha512-DwqXqZyuk5AiWWf3UfLiRDJ5EDd49zg6O9wclZ7kUMv2WRFr4HKjXp/5t8JZ11QbQfUS6/cRCKGwYhtNAY88kQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/darwin-x64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.21.5.tgz",
+      "integrity": "sha512-se/JjF8NlmKVG4kNIuyWMV/22ZaerB+qaSi5MdrXtd6R08kvs2qCN4C09miupktDitvh8jRFflwGFBQcxZRjbw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/freebsd-arm64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.21.5.tgz",
+      "integrity": "sha512-5JcRxxRDUJLX8JXp/wcBCy3pENnCgBR9bN6JsY4OmhfUtIHe3ZW0mawA7+RDAcMLrMIZaf03NlQiX9DGyB8h4g==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/freebsd-x64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.21.5.tgz",
+      "integrity": "sha512-J95kNBj1zkbMXtHVH29bBriQygMXqoVQOQYA+ISs0/2l3T9/kj42ow2mpqerRBxDJnmkUDCaQT/dfNXWX/ZZCQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/linux-arm": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.21.5.tgz",
+      "integrity": "sha512-bPb5AHZtbeNGjCKVZ9UGqGwo8EUu4cLq68E95A53KlxAPRmUyYv2D6F0uUI65XisGOL1hBP5mTronbgo+0bFcA==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/linux-arm64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.21.5.tgz",
+      "integrity": "sha512-ibKvmyYzKsBeX8d8I7MH/TMfWDXBF3db4qM6sy+7re0YXya+K1cem3on9XgdT2EQGMu4hQyZhan7TeQ8XkGp4Q==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/linux-ia32": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.21.5.tgz",
+      "integrity": "sha512-YvjXDqLRqPDl2dvRODYmmhz4rPeVKYvppfGYKSNGdyZkA01046pLWyRKKI3ax8fbJoK5QbxblURkwK/MWY18Tg==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/linux-loong64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.21.5.tgz",
+      "integrity": "sha512-uHf1BmMG8qEvzdrzAqg2SIG/02+4/DHB6a9Kbya0XDvwDEKCoC8ZRWI5JJvNdUjtciBGFQ5PuBlpEOXQj+JQSg==",
+      "cpu": [
+        "loong64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/linux-mips64el": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.21.5.tgz",
+      "integrity": "sha512-IajOmO+KJK23bj52dFSNCMsz1QP1DqM6cwLUv3W1QwyxkyIWecfafnI555fvSGqEKwjMXVLokcV5ygHW5b3Jbg==",
+      "cpu": [
+        "mips64el"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/linux-ppc64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.21.5.tgz",
+      "integrity": "sha512-1hHV/Z4OEfMwpLO8rp7CvlhBDnjsC3CttJXIhBi+5Aj5r+MBvy4egg7wCbe//hSsT+RvDAG7s81tAvpL2XAE4w==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/linux-riscv64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.21.5.tgz",
+      "integrity": "sha512-2HdXDMd9GMgTGrPWnJzP2ALSokE/0O5HhTUvWIbD3YdjME8JwvSCnNGBnTThKGEB91OZhzrJ4qIIxk/SBmyDDA==",
+      "cpu": [
+        "riscv64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/linux-s390x": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.21.5.tgz",
+      "integrity": "sha512-zus5sxzqBJD3eXxwvjN1yQkRepANgxE9lgOW2qLnmr8ikMTphkjgXu1HR01K4FJg8h1kEEDAqDcZQtbrRnB41A==",
+      "cpu": [
+        "s390x"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/linux-x64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.21.5.tgz",
+      "integrity": "sha512-1rYdTpyv03iycF1+BhzrzQJCdOuAOtaqHTWJZCWvijKD2N5Xu0TtVC8/+1faWqcP9iBCWOmjmhoH94dH82BxPQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/netbsd-x64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.21.5.tgz",
+      "integrity": "sha512-Woi2MXzXjMULccIwMnLciyZH4nCIMpWQAs049KEeMvOcNADVxo0UBIQPfSmxB3CWKedngg7sWZdLvLczpe0tLg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "netbsd"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/openbsd-x64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.21.5.tgz",
+      "integrity": "sha512-HLNNw99xsvx12lFBUwoT8EVCsSvRNDVxNpjZ7bPn947b8gJPzeHWyNVhFsaerc0n3TsbOINvRP2byTZ5LKezow==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/sunos-x64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.21.5.tgz",
+      "integrity": "sha512-6+gjmFpfy0BHU5Tpptkuh8+uw3mnrvgs+dSPQXQOv3ekbordwnzTVEb4qnIvQcYXq6gzkyTnoZ9dZG+D4garKg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "sunos"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/win32-arm64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.21.5.tgz",
+      "integrity": "sha512-Z0gOTd75VvXqyq7nsl93zwahcTROgqvuAcYDUr+vOv8uHhNSKROyU961kgtCD1e95IqPKSQKH7tBTslnS3tA8A==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/win32-ia32": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.21.5.tgz",
+      "integrity": "sha512-SWXFF1CL2RVNMaVs+BBClwtfZSvDgtL//G/smwAc5oVK/UPu2Gu9tIaRgFmYFFKrmg3SyAjSrElf0TiJ1v8fYA==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/win32-x64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.21.5.tgz",
+      "integrity": "sha512-tQd/1efJuzPC6rCFwEvLtci/xNFcTZknmXs98FYDfGE4wP9ClFV98nyKrzJKVPMhdDnjzLhdUyMX4PsQAPjwIw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@jridgewell/gen-mapping": {
+      "version": "0.3.13",
+      "resolved": "https://registry.npmjs.org/@jridgewell/gen-mapping/-/gen-mapping-0.3.13.tgz",
+      "integrity": "sha512-2kkt/7niJ6MgEPxF0bYdQ6etZaA+fQvDcLKckhy1yIQOzaoKjBBjSj63/aLVjYE3qhRt5dvM+uUyfCg6UKCBbA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@jridgewell/sourcemap-codec": "^1.5.0",
+        "@jridgewell/trace-mapping": "^0.3.24"
+      }
+    },
+    "node_modules/@jridgewell/remapping": {
+      "version": "2.3.5",
+      "resolved": "https://registry.npmjs.org/@jridgewell/remapping/-/remapping-2.3.5.tgz",
+      "integrity": "sha512-LI9u/+laYG4Ds1TDKSJW2YPrIlcVYOwi2fUC6xB43lueCjgxV4lffOCZCtYFiH6TNOX+tQKXx97T4IKHbhyHEQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@jridgewell/gen-mapping": "^0.3.5",
+        "@jridgewell/trace-mapping": "^0.3.24"
+      }
+    },
+    "node_modules/@jridgewell/resolve-uri": {
+      "version": "3.1.2",
+      "resolved": "https://registry.npmjs.org/@jridgewell/resolve-uri/-/resolve-uri-3.1.2.tgz",
+      "integrity": "sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.0.0"
+      }
+    },
+    "node_modules/@jridgewell/sourcemap-codec": {
+      "version": "1.5.5",
+      "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.5.tgz",
+      "integrity": "sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@jridgewell/trace-mapping": {
+      "version": "0.3.31",
+      "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.31.tgz",
+      "integrity": "sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@jridgewell/resolve-uri": "^3.1.0",
+        "@jridgewell/sourcemap-codec": "^1.4.14"
+      }
+    },
+    "node_modules/@rollup/rollup-android-arm-eabi": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.60.2.tgz",
+      "integrity": "sha512-dnlp69efPPg6Uaw2dVqzWRfAWRnYVb1XJ8CyyhIbZeaq4CA5/mLeZ1IEt9QqQxmbdvagjLIm2ZL8BxXv5lH4Yw==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ]
+    },
+    "node_modules/@rollup/rollup-android-arm64": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.60.2.tgz",
+      "integrity": "sha512-OqZTwDRDchGRHHm/hwLOL7uVPB9aUvI0am/eQuWMNyFHf5PSEQmyEeYYheA0EPPKUO/l0uigCp+iaTjoLjVoHg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ]
+    },
+    "node_modules/@rollup/rollup-darwin-arm64": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.60.2.tgz",
+      "integrity": "sha512-UwRE7CGpvSVEQS8gUMBe1uADWjNnVgP3Iusyda1nSRwNDCsRjnGc7w6El6WLQsXmZTbLZx9cecegumcitNfpmA==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ]
+    },
+    "node_modules/@rollup/rollup-darwin-x64": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.60.2.tgz",
+      "integrity": "sha512-gjEtURKLCC5VXm1I+2i1u9OhxFsKAQJKTVB8WvDAHF+oZlq0GTVFOlTlO1q3AlCTE/DF32c16ESvfgqR7343/g==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ]
+    },
+    "node_modules/@rollup/rollup-freebsd-arm64": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.60.2.tgz",
+      "integrity": "sha512-Bcl6CYDeAgE70cqZaMojOi/eK63h5Me97ZqAQoh77VPjMysA/4ORQBRGo3rRy45x4MzVlU9uZxs8Uwy7ZaKnBw==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ]
+    },
+    "node_modules/@rollup/rollup-freebsd-x64": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.60.2.tgz",
+      "integrity": "sha512-LU+TPda3mAE2QB0/Hp5VyeKJivpC6+tlOXd1VMoXV/YFMvk/MNk5iXeBfB4MQGRWyOYVJ01625vjkr0Az98OJQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-arm-gnueabihf": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.60.2.tgz",
+      "integrity": "sha512-2QxQrM+KQ7DAW4o22j+XZ6RKdxjLD7BOWTP0Bv0tmjdyhXSsr2Ul1oJDQqh9Zf5qOwTuTc7Ek83mOFaKnodPjg==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "libc": [
+        "glibc"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-arm-musleabihf": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.60.2.tgz",
+      "integrity": "sha512-TbziEu2DVsTEOPif2mKWkMeDMLoYjx95oESa9fkQQK7r/Orta0gnkcDpzwufEcAO2BLBsD7mZkXGFqEdMRRwfw==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "libc": [
+        "musl"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-arm64-gnu": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.60.2.tgz",
+      "integrity": "sha512-bO/rVDiDUuM2YfuCUwZ1t1cP+/yqjqz+Xf2VtkdppefuOFS2OSeAfgafaHNkFn0t02hEyXngZkxtGqXcXwO8Rg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "libc": [
+        "glibc"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-arm64-musl": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.60.2.tgz",
+      "integrity": "sha512-hr26p7e93Rl0Za+JwW7EAnwAvKkehh12BU1Llm9Ykiibg4uIr2rbpxG9WCf56GuvidlTG9KiiQT/TXT1yAWxTA==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "libc": [
+        "musl"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-loong64-gnu": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-gnu/-/rollup-linux-loong64-gnu-4.60.2.tgz",
+      "integrity": "sha512-pOjB/uSIyDt+ow3k/RcLvUAOGpysT2phDn7TTUB3n75SlIgZzM6NKAqlErPhoFU+npgY3/n+2HYIQVbF70P9/A==",
+      "cpu": [
+        "loong64"
+      ],
+      "dev": true,
+      "libc": [
+        "glibc"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-loong64-musl": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-musl/-/rollup-linux-loong64-musl-4.60.2.tgz",
+      "integrity": "sha512-2/w+q8jszv9Ww1c+6uJT3OwqhdmGP2/4T17cu8WuwyUuuaCDDJ2ojdyYwZzCxx0GcsZBhzi3HmH+J5pZNXnd+Q==",
+      "cpu": [
+        "loong64"
+      ],
+      "dev": true,
+      "libc": [
+        "musl"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-ppc64-gnu": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-gnu/-/rollup-linux-ppc64-gnu-4.60.2.tgz",
+      "integrity": "sha512-11+aL5vKheYgczxtPVVRhdptAM2H7fcDR5Gw4/bTcteuZBlH4oP9f5s9zYO9aGZvoGeBpqXI/9TZZihZ609wKw==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "libc": [
+        "glibc"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-ppc64-musl": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-musl/-/rollup-linux-ppc64-musl-4.60.2.tgz",
+      "integrity": "sha512-i16fokAGK46IVZuV8LIIwMdtqhin9hfYkCh8pf8iC3QU3LpwL+1FSFGej+O7l3E/AoknL6Dclh2oTdnRMpTzFQ==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "libc": [
+        "musl"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-riscv64-gnu": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.60.2.tgz",
+      "integrity": "sha512-49FkKS6RGQoriDSK/6E2GkAsAuU5kETFCh7pG4yD/ylj9rKhTmO3elsnmBvRD4PgJPds5W2PkhC82aVwmUcJ7A==",
+      "cpu": [
+        "riscv64"
+      ],
+      "dev": true,
+      "libc": [
+        "glibc"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-riscv64-musl": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-musl/-/rollup-linux-riscv64-musl-4.60.2.tgz",
+      "integrity": "sha512-mjYNkHPfGpUR00DuM1ZZIgs64Hpf4bWcz9Z41+4Q+pgDx73UwWdAYyf6EG/lRFldmdHHzgrYyge5akFUW0D3mQ==",
+      "cpu": [
+        "riscv64"
+      ],
+      "dev": true,
+      "libc": [
+        "musl"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-s390x-gnu": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.60.2.tgz",
+      "integrity": "sha512-ALyvJz965BQk8E9Al/JDKKDLH2kfKFLTGMlgkAbbYtZuJt9LU8DW3ZoDMCtQpXAltZxwBHevXz5u+gf0yA0YoA==",
+      "cpu": [
+        "s390x"
+      ],
+      "dev": true,
+      "libc": [
+        "glibc"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-x64-gnu": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.60.2.tgz",
+      "integrity": "sha512-UQjrkIdWrKI626Du8lCQ6MJp/6V1LAo2bOK9OTu4mSn8GGXIkPXk/Vsp4bLHCd9Z9Iz2OTEaokUE90VweJgIYQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "libc": [
+        "glibc"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-x64-musl": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.60.2.tgz",
+      "integrity": "sha512-bTsRGj6VlSdn/XD4CGyzMnzaBs9bsRxy79eTqTCBsA8TMIEky7qg48aPkvJvFe1HyzQ5oMZdg7AnVlWQSKLTnw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "libc": [
+        "musl"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-openbsd-x64": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-openbsd-x64/-/rollup-openbsd-x64-4.60.2.tgz",
+      "integrity": "sha512-6d4Z3534xitaA1FcMWP7mQPq5zGwBmGbhphh2DwaA1aNIXUu3KTOfwrWpbwI4/Gr0uANo7NTtaykFyO2hPuFLg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ]
+    },
+    "node_modules/@rollup/rollup-openharmony-arm64": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-openharmony-arm64/-/rollup-openharmony-arm64-4.60.2.tgz",
+      "integrity": "sha512-NetAg5iO2uN7eB8zE5qrZ3CSil+7IJt4WDFLcC75Ymywq1VZVD6qJ6EvNLjZ3rEm6gB7XW5JdT60c6MN35Z85Q==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openharmony"
+      ]
+    },
+    "node_modules/@rollup/rollup-win32-arm64-msvc": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.60.2.tgz",
+      "integrity": "sha512-NCYhOotpgWZ5kdxCZsv6Iudx0wX8980Q/oW4pNFNihpBKsDbEA1zpkfxJGC0yugsUuyDZ7gL37dbzwhR0VI7pQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ]
+    },
+    "node_modules/@rollup/rollup-win32-ia32-msvc": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.60.2.tgz",
+      "integrity": "sha512-RXsaOqXxfoUBQoOgvmmijVxJnW2IGB0eoMO7F8FAjaj0UTywUO/luSqimWBJn04WNgUkeNhh7fs7pESXajWmkg==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ]
+    },
+    "node_modules/@rollup/rollup-win32-x64-gnu": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-gnu/-/rollup-win32-x64-gnu-4.60.2.tgz",
+      "integrity": "sha512-qdAzEULD+/hzObedtmV6iBpdL5TIbKVztGiK7O3/KYSf+HIzU257+MX1EXJcyIiDbMAqmbwaufcYPvyRryeZtA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ]
+    },
+    "node_modules/@rollup/rollup-win32-x64-msvc": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.60.2.tgz",
+      "integrity": "sha512-Nd/SgG27WoA9e+/TdK74KnHz852TLa94ovOYySo/yMPuTmpckK/jIF2jSwS3g7ELSKXK13/cVdmg1Z/DaCWKxA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ]
+    },
+    "node_modules/@sveltejs/acorn-typescript": {
+      "version": "1.0.9",
+      "resolved": "https://registry.npmjs.org/@sveltejs/acorn-typescript/-/acorn-typescript-1.0.9.tgz",
+      "integrity": "sha512-lVJX6qEgs/4DOcRTpo56tmKzVPtoWAaVbL4hfO7t7NVwl9AAXzQR6cihesW1BmNMPl+bK6dreu2sOKBP2Q9CIA==",
+      "dev": true,
+      "license": "MIT",
+      "peerDependencies": {
+        "acorn": "^8.9.0"
+      }
+    },
+    "node_modules/@sveltejs/vite-plugin-svelte": {
+      "version": "4.0.4",
+      "resolved": "https://registry.npmjs.org/@sveltejs/vite-plugin-svelte/-/vite-plugin-svelte-4.0.4.tgz",
+      "integrity": "sha512-0ba1RQ/PHen5FGpdSrW7Y3fAMQjrXantECALeOiOdBdzR5+5vPP6HVZRLmZaQL+W8m++o+haIAKq5qT+MiZ7VA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@sveltejs/vite-plugin-svelte-inspector": "^3.0.0-next.0||^3.0.0",
+        "debug": "^4.3.7",
+        "deepmerge": "^4.3.1",
+        "kleur": "^4.1.5",
+        "magic-string": "^0.30.12",
+        "vitefu": "^1.0.3"
+      },
+      "engines": {
+        "node": "^18.0.0 || ^20.0.0 || >=22"
+      },
+      "peerDependencies": {
+        "svelte": "^5.0.0-next.96 || ^5.0.0",
+        "vite": "^5.0.0"
+      }
+    },
+    "node_modules/@sveltejs/vite-plugin-svelte-inspector": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/@sveltejs/vite-plugin-svelte-inspector/-/vite-plugin-svelte-inspector-3.0.1.tgz",
+      "integrity": "sha512-2CKypmj1sM4GE7HjllT7UKmo4Q6L5xFRd7VMGEWhYnZ+wc6AUVU01IBd7yUi6WnFndEwWoMNOd6e8UjoN0nbvQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "debug": "^4.3.7"
+      },
+      "engines": {
+        "node": "^18.0.0 || ^20.0.0 || >=22"
+      },
+      "peerDependencies": {
+        "@sveltejs/vite-plugin-svelte": "^4.0.0-next.0||^4.0.0",
+        "svelte": "^5.0.0-next.96 || ^5.0.0",
+        "vite": "^5.0.0"
+      }
+    },
+    "node_modules/@types/estree": {
+      "version": "1.0.8",
+      "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.8.tgz",
+      "integrity": "sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@types/trusted-types": {
+      "version": "2.0.7",
+      "resolved": "https://registry.npmjs.org/@types/trusted-types/-/trusted-types-2.0.7.tgz",
+      "integrity": "sha512-ScaPdn1dQczgbl0QFTeTOmVHFULt394XJgOQNoyVhZ6r2vLnMLJfBPd53SB52T/3G36VI1/g2MZaX0cwDuXsfw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/acorn": {
+      "version": "8.16.0",
+      "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.16.0.tgz",
+      "integrity": "sha512-UVJyE9MttOsBQIDKw1skb9nAwQuR5wuGD3+82K6JgJlm/Y+KI92oNsMNGZCYdDsVtRHSak0pcV5Dno5+4jh9sw==",
+      "dev": true,
+      "license": "MIT",
+      "bin": {
+        "acorn": "bin/acorn"
+      },
+      "engines": {
+        "node": ">=0.4.0"
+      }
+    },
+    "node_modules/aria-query": {
+      "version": "5.3.1",
+      "resolved": "https://registry.npmjs.org/aria-query/-/aria-query-5.3.1.tgz",
+      "integrity": "sha512-Z/ZeOgVl7bcSYZ/u/rh0fOpvEpq//LZmdbkXyc7syVzjPAhfOa9ebsdTSjEBDU4vs5nC98Kfduj1uFo0qyET3g==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/axobject-query": {
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/axobject-query/-/axobject-query-4.1.0.tgz",
+      "integrity": "sha512-qIj0G9wZbMGNLjLmg1PT6v2mE9AH2zlnADJD/2tC6E00hgmhUOfEB6greHPAfLRSufHqROIUTkw6E+M3lH0PTQ==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/clsx": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/clsx/-/clsx-2.1.1.tgz",
+      "integrity": "sha512-eYm0QWBtUrBWZWG0d386OGAw16Z995PiOVo2B7bjWSbHedGl5e0ZWaq65kOGgUSNesEIDkB9ISbTg/JK9dhCZA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/debug": {
+      "version": "4.4.3",
+      "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz",
+      "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ms": "^2.1.3"
+      },
+      "engines": {
+        "node": ">=6.0"
+      },
+      "peerDependenciesMeta": {
+        "supports-color": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/deepmerge": {
+      "version": "4.3.1",
+      "resolved": "https://registry.npmjs.org/deepmerge/-/deepmerge-4.3.1.tgz",
+      "integrity": "sha512-3sUqbMEc77XqpdNO7FRyRog+eW3ph+GYCbj+rK+uYyRMuwsVy0rMiVtPn+QJlKFvWP/1PYpapqYn0Me2knFn+A==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/devalue": {
+      "version": "5.8.0",
+      "resolved": "https://registry.npmjs.org/devalue/-/devalue-5.8.0.tgz",
+      "integrity": "sha512-2zA9pFEsnp7vWBZbXF5JAgAq0fsUIt/1XPbRiAmRV3lp/2C3upzH+sADiyy66aFCihoLEsrQHxNM5w1gIDfsBg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/esbuild": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.21.5.tgz",
+      "integrity": "sha512-mg3OPMV4hXywwpoDxu3Qda5xCKQi+vCTZq8S9J/EpkhB2HzKXq4SNFZE3+NK93JYxc8VMSep+lOUSC/RVKaBqw==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "bin": {
+        "esbuild": "bin/esbuild"
+      },
+      "engines": {
+        "node": ">=12"
+      },
+      "optionalDependencies": {
+        "@esbuild/aix-ppc64": "0.21.5",
+        "@esbuild/android-arm": "0.21.5",
+        "@esbuild/android-arm64": "0.21.5",
+        "@esbuild/android-x64": "0.21.5",
+        "@esbuild/darwin-arm64": "0.21.5",
+        "@esbuild/darwin-x64": "0.21.5",
+        "@esbuild/freebsd-arm64": "0.21.5",
+        "@esbuild/freebsd-x64": "0.21.5",
+        "@esbuild/linux-arm": "0.21.5",
+        "@esbuild/linux-arm64": "0.21.5",
+        "@esbuild/linux-ia32": "0.21.5",
+        "@esbuild/linux-loong64": "0.21.5",
+        "@esbuild/linux-mips64el": "0.21.5",
+        "@esbuild/linux-ppc64": "0.21.5",
+        "@esbuild/linux-riscv64": "0.21.5",
+        "@esbuild/linux-s390x": "0.21.5",
+        "@esbuild/linux-x64": "0.21.5",
+        "@esbuild/netbsd-x64": "0.21.5",
+        "@esbuild/openbsd-x64": "0.21.5",
+        "@esbuild/sunos-x64": "0.21.5",
+        "@esbuild/win32-arm64": "0.21.5",
+        "@esbuild/win32-ia32": "0.21.5",
+        "@esbuild/win32-x64": "0.21.5"
+      }
+    },
+    "node_modules/esm-env": {
+      "version": "1.2.2",
+      "resolved": "https://registry.npmjs.org/esm-env/-/esm-env-1.2.2.tgz",
+      "integrity": "sha512-Epxrv+Nr/CaL4ZcFGPJIYLWFom+YeV1DqMLHJoEd9SYRxNbaFruBwfEX/kkHUJf55j2+TUbmDcmuilbP1TmXHA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/esrap": {
+      "version": "2.2.5",
+      "resolved": "https://registry.npmjs.org/esrap/-/esrap-2.2.5.tgz",
+      "integrity": "sha512-/yLB1538mag+dn0wsePTe8C0rDIjUOaJpMs2McodSzmM2msWcZsBSdRtg6HOBt0A/r82BN+Md3pgwSc/uWt2Ig==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@jridgewell/sourcemap-codec": "^1.4.15"
+      },
+      "peerDependencies": {
+        "@typescript-eslint/types": "^8.2.0"
+      },
+      "peerDependenciesMeta": {
+        "@typescript-eslint/types": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/fsevents": {
+      "version": "2.3.3",
+      "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz",
+      "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": "^8.16.0 || ^10.6.0 || >=11.0.0"
+      }
+    },
+    "node_modules/is-reference": {
+      "version": "3.0.3",
+      "resolved": "https://registry.npmjs.org/is-reference/-/is-reference-3.0.3.tgz",
+      "integrity": "sha512-ixkJoqQvAP88E6wLydLGGqCJsrFUnqoH6HnaczB8XmDH1oaWU+xxdptvikTgaEhtZ53Ky6YXiBuUI2WXLMCwjw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/estree": "^1.0.6"
+      }
+    },
+    "node_modules/kleur": {
+      "version": "4.1.5",
+      "resolved": "https://registry.npmjs.org/kleur/-/kleur-4.1.5.tgz",
+      "integrity": "sha512-o+NO+8WrRiQEE4/7nwRJhN1HWpVmJm511pBHUxPLtp0BUISzlBplORYSmTclCnJvQq2tKu/sgl3xVpkc7ZWuQQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/locate-character": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/locate-character/-/locate-character-3.0.0.tgz",
+      "integrity": "sha512-SW13ws7BjaeJ6p7Q6CO2nchbYEc3X3J6WrmTTDto7yMPqVSZTUyY5Tjbid+Ab8gLnATtygYtiDIJGQRRn2ZOiA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/magic-string": {
+      "version": "0.30.21",
+      "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-0.30.21.tgz",
+      "integrity": "sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@jridgewell/sourcemap-codec": "^1.5.5"
+      }
+    },
+    "node_modules/ms": {
+      "version": "2.1.3",
+      "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
+      "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/nanoid": {
+      "version": "3.3.12",
+      "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.12.tgz",
+      "integrity": "sha512-ZB9RH/39qpq5Vu6Y+NmUaFhQR6pp+M2Xt76XBnEwDaGcVAqhlvxrl3B2bKS5D3NH3QR76v3aSrKaF/Kiy7lEtQ==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "license": "MIT",
+      "bin": {
+        "nanoid": "bin/nanoid.cjs"
+      },
+      "engines": {
+        "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1"
+      }
+    },
+    "node_modules/picocolors": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz",
+      "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/postcss": {
+      "version": "8.5.13",
+      "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.13.tgz",
+      "integrity": "sha512-qif0+jGGZoLWdHey3UFHHWP0H7Gbmsk8T5VEqyYFbWqPr1XqvLGBbk/sl8V5exGmcYJklJOhOQq1pV9IcsiFag==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/postcss/"
+        },
+        {
+          "type": "tidelift",
+          "url": "https://tidelift.com/funding/github/npm/postcss"
+        },
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "nanoid": "^3.3.11",
+        "picocolors": "^1.1.1",
+        "source-map-js": "^1.2.1"
+      },
+      "engines": {
+        "node": "^10 || ^12 || >=14"
+      }
+    },
+    "node_modules/rollup": {
+      "version": "4.60.2",
+      "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.60.2.tgz",
+      "integrity": "sha512-J9qZyW++QK/09NyN/zeO0dG/1GdGfyp9lV8ajHnRVLfo/uFsbji5mHnDgn/qYdUHyCkM2N+8VyspgZclfAh0eQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/estree": "1.0.8"
+      },
+      "bin": {
+        "rollup": "dist/bin/rollup"
+      },
+      "engines": {
+        "node": ">=18.0.0",
+        "npm": ">=8.0.0"
+      },
+      "optionalDependencies": {
+        "@rollup/rollup-android-arm-eabi": "4.60.2",
+        "@rollup/rollup-android-arm64": "4.60.2",
+        "@rollup/rollup-darwin-arm64": "4.60.2",
+        "@rollup/rollup-darwin-x64": "4.60.2",
+        "@rollup/rollup-freebsd-arm64": "4.60.2",
+        "@rollup/rollup-freebsd-x64": "4.60.2",
+        "@rollup/rollup-linux-arm-gnueabihf": "4.60.2",
+        "@rollup/rollup-linux-arm-musleabihf": "4.60.2",
+        "@rollup/rollup-linux-arm64-gnu": "4.60.2",
+        "@rollup/rollup-linux-arm64-musl": "4.60.2",
+        "@rollup/rollup-linux-loong64-gnu": "4.60.2",
+        "@rollup/rollup-linux-loong64-musl": "4.60.2",
+        "@rollup/rollup-linux-ppc64-gnu": "4.60.2",
+        "@rollup/rollup-linux-ppc64-musl": "4.60.2",
+        "@rollup/rollup-linux-riscv64-gnu": "4.60.2",
+        "@rollup/rollup-linux-riscv64-musl": "4.60.2",
+        "@rollup/rollup-linux-s390x-gnu": "4.60.2",
+        "@rollup/rollup-linux-x64-gnu": "4.60.2",
+        "@rollup/rollup-linux-x64-musl": "4.60.2",
+        "@rollup/rollup-openbsd-x64": "4.60.2",
+        "@rollup/rollup-openharmony-arm64": "4.60.2",
+        "@rollup/rollup-win32-arm64-msvc": "4.60.2",
+        "@rollup/rollup-win32-ia32-msvc": "4.60.2",
+        "@rollup/rollup-win32-x64-gnu": "4.60.2",
+        "@rollup/rollup-win32-x64-msvc": "4.60.2",
+        "fsevents": "~2.3.2"
+      }
+    },
+    "node_modules/source-map-js": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz",
+      "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/svelte": {
+      "version": "5.55.5",
+      "resolved": "https://registry.npmjs.org/svelte/-/svelte-5.55.5.tgz",
+      "integrity": "sha512-2uCs/LZ9us+AktdzYJM8OcxQ8qnPS1kpaO7syGT/MgO+6Qr1Ybl+TqPq+97u7PHqmmMlye5ZkoyXONy5mjjAbw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@jridgewell/remapping": "^2.3.4",
+        "@jridgewell/sourcemap-codec": "^1.5.0",
+        "@sveltejs/acorn-typescript": "^1.0.5",
+        "@types/estree": "^1.0.5",
+        "@types/trusted-types": "^2.0.7",
+        "acorn": "^8.12.1",
+        "aria-query": "5.3.1",
+        "axobject-query": "^4.1.0",
+        "clsx": "^2.1.1",
+        "devalue": "^5.6.4",
+        "esm-env": "^1.2.1",
+        "esrap": "^2.2.4",
+        "is-reference": "^3.0.3",
+        "locate-character": "^3.0.0",
+        "magic-string": "^0.30.11",
+        "zimmerframe": "^1.1.2"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/vite": {
+      "version": "5.4.21",
+      "resolved": "https://registry.npmjs.org/vite/-/vite-5.4.21.tgz",
+      "integrity": "sha512-o5a9xKjbtuhY6Bi5S3+HvbRERmouabWbyUcpXXUA1u+GNUKoROi9byOJ8M0nHbHYHkYICiMlqxkg1KkYmm25Sw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "esbuild": "^0.21.3",
+        "postcss": "^8.4.43",
+        "rollup": "^4.20.0"
+      },
+      "bin": {
+        "vite": "bin/vite.js"
+      },
+      "engines": {
+        "node": "^18.0.0 || >=20.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/vitejs/vite?sponsor=1"
+      },
+      "optionalDependencies": {
+        "fsevents": "~2.3.3"
+      },
+      "peerDependencies": {
+        "@types/node": "^18.0.0 || >=20.0.0",
+        "less": "*",
+        "lightningcss": "^1.21.0",
+        "sass": "*",
+        "sass-embedded": "*",
+        "stylus": "*",
+        "sugarss": "*",
+        "terser": "^5.4.0"
+      },
+      "peerDependenciesMeta": {
+        "@types/node": {
+          "optional": true
+        },
+        "less": {
+          "optional": true
+        },
+        "lightningcss": {
+          "optional": true
+        },
+        "sass": {
+          "optional": true
+        },
+        "sass-embedded": {
+          "optional": true
+        },
+        "stylus": {
+          "optional": true
+        },
+        "sugarss": {
+          "optional": true
+        },
+        "terser": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/vitefu": {
+      "version": "1.1.3",
+      "resolved": "https://registry.npmjs.org/vitefu/-/vitefu-1.1.3.tgz",
+      "integrity": "sha512-ub4okH7Z5KLjb6hDyjqrGXqWtWvoYdU3IGm/NorpgHncKoLTCfRIbvlhBm7r0YstIaQRYlp4yEbFqDcKSzXSSg==",
+      "dev": true,
+      "license": "MIT",
+      "workspaces": [
+        "tests/deps/*",
+        "tests/projects/*",
+        "tests/projects/workspace/packages/*"
+      ],
+      "peerDependencies": {
+        "vite": "^3.0.0 || ^4.0.0 || ^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0"
+      },
+      "peerDependenciesMeta": {
+        "vite": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/zimmerframe": {
+      "version": "1.1.4",
+      "resolved": "https://registry.npmjs.org/zimmerframe/-/zimmerframe-1.1.4.tgz",
+      "integrity": "sha512-B58NGBEoc8Y9MWWCQGl/gq9xBCe4IiKM0a2x7GZdQKOW5Exr8S1W24J6OgM1njK8xCRGvAJIL/MxXHf6SkmQKQ==",
+      "dev": true,
+      "license": "MIT"
+    }
+  }
+}

web/svelte/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "riprap-svelte",
+  "private": true,
+  "version": "0.1.0",
+  "type": "module",
+  "scripts": {
+    "build": "vite build",
+    "dev": "vite build --watch"
+  },
+  "devDependencies": {
+    "svelte": "^5.0.0",
+    "vite": "^5.4.0",
+    "@sveltejs/vite-plugin-svelte": "^4.0.0"
+  }
+}

web/svelte/src/lib/Briefing.svelte

@@ -0,0 +1,124 @@
+<svelte:options
+  customElement={{
+    tag: "r-briefing",
+    props: {
+      text:         { type: "String" },
+      streaming:    { type: "Boolean", reflect: true },
+      sourceLabels: { type: "Object" },
+    },
+  }} />
+
+<script>
+  import { onMount, tick } from "svelte";
+  import { citeIndex, highlightedDocId } from "./stores.js";
+
+  let { text = "", streaming = false, sourceLabels = {} } = $props();
+
+  const escapeHtml = (s) =>
+    String(s ?? "").replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+
+  function renderMarkdown(input) {
+    const lines = input.split("\n");
+    const out = [];
+    let para = []; let bullets = [];
+    const flushPara = () => {
+      if (!para.length) return;
+      const safe = escapeHtml(para.join(" ").trim())
+        .replace(/\*\*([^*]+)\*\*/g, "<strong>$1</strong>");
+      if (safe) out.push(`<p class="rsum-p">${safe}</p>`);
+      para = [];
+    };
+    const flushBullets = () => {
+      if (!bullets.length) return;
+      const items = bullets.map(b => {
+        const safe = escapeHtml(b.trim()).replace(/\*\*([^*]+)\*\*/g, "<strong>$1</strong>");
+        return `<li>${safe}</li>`;
+      }).join("");
+      out.push(`<ul class="rsum-list">${items}</ul>`);
+      bullets = [];
+    };
+    // Granite sometimes runs all bullets onto one line.
+    const expanded = [];
+    for (const line of lines) {
+      if (line.trim().startsWith("- ") && line.includes(" - ", 2)) {
+        const parts = line.split(/(?:^|(?<=\.\s))\s*-\s+/g).filter(p => p.trim());
+        for (const p of parts) expanded.push("- " + p.trim());
+      } else { expanded.push(line); }
+    }
+    for (const line of expanded) {
+      const m = line.match(/^\s*\*\*([A-Z][A-Za-z\s/]+)\.\*\*\s*$/);
+      if (m) { flushPara(); flushBullets(); out.push(`<h4 class="rsum-h">${escapeHtml(m[1])}</h4>`); }
+      else if (/^\s*[-*]\s+/.test(line)) { flushPara(); bullets.push(line.replace(/^\s*[-*]\s+/, "")); }
+      else { flushBullets(); para.push(line); }
+    }
+    flushPara(); flushBullets();
+    return out.join("");
+  }
+
+  function rewriteCitations(html, indexMap) {
+    return html.replace(/\[([a-z0-9_]+)\]/gi, (_, id) => {
+      const norm = id.toLowerCase();
+      if (indexMap[norm] == null) indexMap[norm] = Object.keys(indexMap).length + 1;
+      const n = indexMap[norm];
+      const lab = sourceLabels[norm] || norm;
+      return `<span class="cite" data-src-id="${norm}" data-src-n="${n}" title="${lab.replace(/"/g, "&quot;")} — click to highlight">${n}</span>`;
+    });
+  }
+
+  let bodyHtml = $derived.by(() => {
+    if (!text) return "";
+    const indexMap = {};
+    const md = renderMarkdown(text);
+    const html = rewriteCitations(md, indexMap);
+    queueMicrotask(() => citeIndex.set({ ...indexMap }));
+    return html;
+  });
+
+  let container;
+  let hl = $derived($highlightedDocId);
+
+  // Re-bind chip listeners + hl class whenever the body or hl changes.
+  $effect(() => {
+    void bodyHtml; void hl;
+    if (!container) return;
+    tick().then(() => {
+      const chips = container.querySelectorAll(".cite");
+      chips.forEach(c => {
+        const id = c.dataset.srcId;
+        if (!id) return;
+        c.classList.toggle("hl", id === hl);
+        if (c.dataset.bound) return;
+        c.dataset.bound = "1";
+        c.addEventListener("mouseenter", () => highlightedDocId.set(id));
+        c.addEventListener("click", (e) => {
+          e.stopPropagation();
+          highlightedDocId.update(cur => cur === id ? null : id);
+        });
+      });
+    });
+  });
+</script>
+
+{#if !text}
+  <div class="rsum-p" style="color:var(--text-muted, #6b7280)">Waiting for content…</div>
+{:else}
+  <div bind:this={container}>
+    {@html bodyHtml}
+  </div>
+{/if}
+
+<style>
+  :host { display: block; }
+  /* The host-level styles for typography, .cite, etc. live in the parent
+     stylesheet and target #paragraph descendants — they pierce shadow DOM
+     for inline-styled markup we don't ship here. The .rsum-* classes are
+     wired in the global stylesheet. We intentionally don't restate them. */
+  :host(.streaming)::after,
+  :host([streaming])::after {
+    content: "▋";
+    display: inline-block; color: var(--nyc-blue, #1642DF);
+    margin-left: 2px;
+    animation: caret 0.9s steps(1) infinite;
+  }
+  @keyframes caret { 50% { opacity: 0; } }
+</style>

web/svelte/src/lib/SourcesFooter.svelte

@@ -0,0 +1,105 @@
+<svelte:options
+  customElement={{
+    tag: "r-sources-footer",
+    props: {
+      labels:   { type: "Object" },
+      urls:     { type: "Object" },
+      vintages: { type: "Object" },
+    },
+  }} />
+
+<script>
+  import { citeIndex, highlightedDocId } from "./stores.js";
+  import { fade, scale } from "svelte/transition";
+  import { cubicOut } from "svelte/easing";
+
+  let { labels = {}, urls = {}, vintages = {} } = $props();
+
+  let entries = $derived(
+    Object.entries($citeIndex || {}).sort((a, b) => a[1] - b[1])
+  );
+  let hl = $derived($highlightedDocId);
+</script>
+
+{#if entries.length}
+  <div class="src-h" in:fade={{ duration: 200 }}>Sources</div>
+  <ol>
+    {#each entries as [id, n] (id)}
+      {@const url = urls[id]}
+      {@const label = labels[id] || id}
+      {@const vintage = vintages[id]}
+      <li class:hl={id === hl}
+          in:scale={{ start: 0.96, duration: 220, easing: cubicOut }}
+          onmouseenter={() => highlightedDocId.set(id)}
+          onclick={() => highlightedDocId.set(hl === id ? null : id)}>
+        <span class="src-num">[{n}]</span>
+        <div>
+          {#if url}
+            <a class="src-link" href={url} target="_blank" rel="noopener noreferrer"
+               onclick={(e) => e.stopPropagation()}>
+              {label} <span class="src-ext">↗</span>
+            </a>
+          {:else}
+            <span>{label}</span>
+          {/if}
+          <span class="src-id">{id}</span>
+          {#if vintage}<span class="src-vintage">{vintage}</span>{/if}
+        </div>
+      </li>
+    {/each}
+  </ol>
+{/if}
+
+<style>
+  :host {
+    display: block;
+    border-top: 1px solid var(--line, #e5e7eb);
+    background: var(--bg-soft, #f5f7fb);
+    padding: 12px 16px 14px;
+  }
+  :host(:not(:has(ol))) { display: none; }
+  .src-h {
+    font-size: 10px; font-weight: 700;
+    text-transform: uppercase; letter-spacing: 0.10em;
+    color: var(--text-muted, #6b7280);
+    margin: 0 0 8px;
+  }
+  ol {
+    margin: 0; padding: 0; list-style: none;
+    display: grid; gap: 6px;
+    font-size: 11.5px; line-height: 1.45;
+  }
+  li {
+    display: grid; grid-template-columns: 22px 1fr;
+    gap: 8px; align-items: baseline;
+    padding: 4px 6px; border-radius: 3px;
+    cursor: pointer;
+    transition: background 0.15s;
+  }
+  li:hover, li.hl { background: rgba(22, 66, 223, 0.10); }
+  li.hl {
+    /* Brief pulse each time a chip selects this row. */
+    animation: pulse 360ms cubic-bezier(.2,.7,.3,1);
+  }
+  @keyframes pulse {
+    0%   { box-shadow: 0 0 0 0   rgba(22, 66, 223, 0.35); }
+    60%  { box-shadow: 0 0 0 6px rgba(22, 66, 223, 0.00); }
+    100% { box-shadow: 0 0 0 0   rgba(22, 66, 223, 0.00); }
+  }
+  .src-num {
+    font-family: var(--mono, monospace); font-size: 10.5px;
+    font-weight: 700; color: var(--nyc-blue, #1642DF);
+    text-align: right;
+  }
+  .src-link {
+    color: var(--text, #111); text-decoration: none;
+    border-bottom: 1px dotted var(--text-muted, #6b7280);
+  }
+  .src-link:hover {
+    color: var(--nyc-blue, #1642DF);
+    border-bottom-color: var(--nyc-blue, #1642DF);
+  }
+  .src-ext { font-size: 9.5px; color: var(--text-faint, #9ca3af); margin-left: 2px; vertical-align: super; }
+  .src-vintage { display: block; color: var(--text-muted, #6b7280); font-size: 9.5px; margin-top: 2px; }
+  .src-id { display: inline-block; font-family: var(--mono, monospace); font-size: 9.5px; color: var(--text-faint, #9ca3af); margin-left: 6px; }
+</style>

web/svelte/src/lib/Trace.svelte

@@ -0,0 +1,109 @@
+<svelte:options
+  customElement={{
+    tag: "r-trace",
+    props: {
+      stepLabels: { type: "Object" },
+    },
+  }} />
+
+<script>
+  import { onMount } from "svelte";
+  import { fly, fade } from "svelte/transition";
+  import { cubicOut } from "svelte/easing";
+
+  let { stepLabels = {} } = $props();
+  let steps = $state([]);
+
+  // Imperative API consumed by legacy agent.js. Exposed via the host
+  // element through onMount once the custom element is upgraded.
+  onMount(() => {
+    // `this` would be the wrapper context; rely on the component's
+    // host element discovery via document.currentScript trickery is
+    // brittle — Svelte exposes the host via the element instance.
+    // We expose pushStep / clear via a custom event-driven API:
+    //   el.dispatchEvent(new CustomEvent('riprap-trace-push', { detail: step }))
+    //   el.dispatchEvent(new CustomEvent('riprap-trace-clear'))
+    // But agent.js currently calls el.pushStep() / el.clear(); to keep
+    // that ergonomic we attach methods to the host in onMount.
+    // The host is the parent of the shadow root.
+    const host = container?.getRootNode()?.host;
+    if (host) {
+      host.pushStep = (step) => { steps = [...steps, step]; };
+      host.clear = () => { steps = []; };
+    }
+  });
+
+  let container;
+
+  const escapeHtml = (s) =>
+    String(s ?? "").replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+
+  function classFor(step) {
+    return step.ok === true ? "ok" : step.ok === false ? "err" : "running";
+  }
+  function markFor(step) {
+    return step.ok === true ? "✓" : step.ok === false ? "✗" : "○";
+  }
+  function labelFor(step) {
+    return (stepLabels[step.step] && stepLabels[step.step][0]) || step.step;
+  }
+  function hintFor(step) {
+    return (stepLabels[step.step] && stepLabels[step.step][1]) || "";
+  }
+</script>
+
+<ol bind:this={container} id="steps-list">
+  {#each steps as step, i (i)}
+    <li class={classFor(step)}
+        in:fly={{ y: -8, duration: 220, easing: cubicOut }}>
+      <span class="icon">{markFor(step)}</span>
+      <div>
+        <div class="label">{labelFor(step)}</div>
+        <div class="meta">{hintFor(step)}</div>
+      </div>
+      {#if step.elapsed_s != null}
+        <span class="time">{step.elapsed_s}s</span>
+      {/if}
+      {#if step.result}
+        <div class="result">{JSON.stringify(step.result)}</div>
+      {/if}
+      {#if step.err}
+        <div class="result" style="color:var(--nyc-scarlet, #b80000)">{step.err}</div>
+      {/if}
+    </li>
+  {/each}
+</ol>
+
+<style>
+  :host { display: block; }
+  ol {
+    list-style: none; margin: 0; padding: 4px 0;
+    font-size: 12.5px;
+  }
+  li {
+    display: grid;
+    grid-template-columns: 18px 1fr auto;
+    gap: 10px;
+    padding: 7px 14px;
+    border-bottom: 1px solid var(--line, #e5e7eb);
+    align-items: baseline;
+  }
+  li:last-child { border-bottom: 0; }
+  .icon { font-weight: 700; font-size: 14px; line-height: 1; }
+  .running .icon { color: var(--nyc-blue, #1642DF); }
+  .ok      .icon { color: var(--good, #1a8754); }
+  .err     .icon { color: var(--nyc-scarlet, #b80000); }
+  .label  { color: var(--text, #111); font-weight: 500; }
+  .meta   { color: var(--text-muted, #6b7280); font-size: 11px; }
+  .time   { font-family: var(--mono, monospace); color: var(--text-faint, #9ca3af); font-size: 11.5px; }
+  .running { background: rgba(22, 66, 223, 0.04); }
+  .result {
+    grid-column: 2 / -1;
+    color: var(--text-muted, #6b7280);
+    font-size: 11px;
+    font-family: var(--mono, monospace);
+    margin-top: 3px;
+    word-break: break-word;
+    line-height: 1.4;
+  }
+</style>

web/svelte/src/lib/stores.js

@@ -0,0 +1,10 @@
+// Shared state across all three custom elements. Svelte stores have
+// .subscribe (Svelte runtime uses it) AND a manual subscribe is exposed
+// here so legacy agent.js can wire vanilla DOM to the same signal that
+// Svelte components react to.
+import { writable } from "svelte/store";
+
+export const highlightedDocId = writable(null);
+// { doc_id: number } — Briefing populates as it encounters citations,
+// SourcesFooter renders the numbered list from this.
+export const citeIndex = writable({});

web/svelte/src/main.js

@@ -0,0 +1,11 @@
+// Side-effect imports register the custom elements; agent.html mounts
+// the same <r-briefing>, <r-trace>, <r-sources-footer> tags it always
+// did — only the implementation changed.
+import "./lib/SourcesFooter.svelte";
+import "./lib/Briefing.svelte";
+import "./lib/Trace.svelte";
+
+// Re-export shared stores so non-Svelte code (legacy agent.js, the
+// briefing chip-binding subscriber) can reach them. agent.js does:
+//   import("/static/dist/riprap.js").then(m => m.highlightedDocId.set(id))
+export { highlightedDocId, citeIndex } from "./lib/stores.js";

web/svelte/vite.config.js

@@ -0,0 +1,33 @@
+import { defineConfig } from "vite";
+import { svelte } from "@sveltejs/vite-plugin-svelte";
+import { resolve } from "path";
+
+// Svelte 5 custom-element build → drop-in replacement for the Lit
+// components in /web/static/components. agent.html keeps using
+// <r-briefing>, <r-trace>, <r-sources-footer>; this bundle just
+// supplies their implementation.
+export default defineConfig({
+  plugins: [
+    svelte({
+      compilerOptions: {
+        // Globally compile every .svelte file as a custom element so we
+        // get one bundle per page, no per-file flag needed.
+        customElement: true,
+      },
+    }),
+  ],
+  build: {
+    outDir: resolve(__dirname, "../static/dist"),
+    emptyOutDir: true,
+    lib: {
+      entry: resolve(__dirname, "src/main.js"),
+      formats: ["es"],
+      fileName: () => "riprap.js",
+    },
+    rollupOptions: {
+      output: { inlineDynamicImports: true },
+    },
+    target: "es2022",
+    sourcemap: true,
+  },
+});

web/sveltekit/.gitignore

@@ -0,0 +1,11 @@
+node_modules
+.svelte-kit
+# build/ is committed — HF Spaces does not run Node, so we ship the
+# adapter-static output the same way web/static/dist/riprap.js is committed
+# for the legacy custom-element bundle.
+.DS_Store
+.env*
+!.env.example
+vite.config.ts.timestamp-*
+test-results/
+playwright-report/

web/sveltekit/.npmrc

@@ -0,0 +1 @@
+engine-strict=true

web/sveltekit/build/200.html

@@ -0,0 +1,43 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <link rel="icon" href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3E%3Crect width='16' height='16' fill='%23FAFAF7'/%3E%3Crect x='2' y='2' width='5' height='12' fill='%23D17C00'/%3E%3C/svg%3E" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <meta name="description" content="Riprap — citation-grounded NYC flood-exposure briefings." />
+    <title>Riprap — flood-exposure briefing</title>
+    <link href="/_app/immutable/entry/start.CmPnsLDb.js" rel="modulepreload">
+		<link href="/_app/immutable/chunks/DOnKrFbX.js" rel="modulepreload">
+		<link href="/_app/immutable/chunks/CYuHyzh3.js" rel="modulepreload">
+		<link href="/_app/immutable/entry/app.NAzo06Kr.js" rel="modulepreload">
+		<link href="/_app/immutable/chunks/DwPgZwgo.js" rel="modulepreload">
+		<link href="/_app/immutable/chunks/BLULdth_.js" rel="modulepreload">
+		<link href="/_app/immutable/chunks/vWNuMvXT.js" rel="modulepreload">
+		<link href="/_app/immutable/nodes/0.B4c3XvjB.js" rel="modulepreload">
+		<link href="/_app/immutable/chunks/CdmpEGnB.js" rel="modulepreload">
+		<link href="/_app/immutable/chunks/DO0D806X.js" rel="modulepreload">
+		<link href="/_app/immutable/chunks/CpEmpa3I.js" rel="modulepreload">
+		
+		<link href="/_app/immutable/assets/0.KpTzaSsX.css" rel="stylesheet">
+  </head>
+  <body data-sveltekit-preload-data="hover">
+    <div style="display: contents">
+			<script>
+				{
+					__sveltekit_yhur1t = {
+						base: ""
+					};
+
+					const element = document.currentScript.parentElement;
+
+					Promise.all([
+						import("/_app/immutable/entry/start.CmPnsLDb.js"),
+						import("/_app/immutable/entry/app.NAzo06Kr.js")
+					]).then(([kit, app]) => {
+						kit.start(app, element);
+					});
+				}
+			</script>
+		</div>
+  </body>
+</html>

web/sveltekit/build/_app/env.js

@@ -0,0 +1 @@
+export const env={}

web/sveltekit/build/_app/immutable/assets/3.BZfqQRM0.css

@@ -0,0 +1 @@
+.print-doc.svelte-uialbm{max-width:7.5in;margin:.5in auto;padding:0 .5in;font-family:var(--font-serif),Georgia,serif;color:#111;background:#fff}.print-head.svelte-uialbm{border-bottom:1pt solid #111;padding-bottom:8pt;margin-bottom:14pt}.print-head-top.svelte-uialbm{display:flex;justify-content:space-between;align-items:baseline;font:9pt var(--font-mono, "IBM Plex Mono");color:#4a4a4a;text-transform:uppercase;letter-spacing:.04em}.wordmark.svelte-uialbm{font-weight:600;color:#111}.print-title.svelte-uialbm{font:600 22pt var(--font-sans, "IBM Plex Sans");margin:8pt 0 4pt;line-height:1.15}.print-sub.svelte-uialbm{font:10pt var(--font-mono, "IBM Plex Mono");color:#4a4a4a}.print-controls.svelte-uialbm{display:flex;gap:12px;align-items:center;margin:12pt 0;padding:8pt 10pt;background:#f5f5f3;border:1px solid #d8d6d2;border-radius:4px;font:10pt var(--font-sans, "IBM Plex Sans")}.print-controls.svelte-uialbm button:where(.svelte-uialbm){font:10pt var(--font-sans, "IBM Plex Sans");padding:4pt 10pt;background:#111;color:#fff;border:0;border-radius:3px;cursor:pointer}.hint.svelte-uialbm{color:#4a4a4a;font-size:9pt}.print-citations.svelte-uialbm{margin-top:18pt;padding-top:8pt;border-top:1pt solid #111;page-break-before:always}.print-citations.svelte-uialbm h2:where(.svelte-uialbm){font:600 13pt var(--font-sans, "IBM Plex Sans");margin:0 0 8pt}.print-citations.svelte-uialbm ol:where(.svelte-uialbm){list-style:none;padding:0;margin:0}.print-citations.svelte-uialbm li:where(.svelte-uialbm){margin-bottom:8pt;padding-left:28pt;position:relative;font-size:10pt;line-height:1.4;break-inside:avoid}.cn.svelte-uialbm{position:absolute;left:0;top:0;font:600 10pt var(--font-mono, "IBM Plex Mono");color:#0b5394}.cglyph.svelte-uialbm{display:inline-block;vertical-align:middle;margin-right:4pt}.csrc.svelte-uialbm{font-weight:600}.cvint.svelte-uialbm{color:#4a4a4a;margin-left:6pt;font-size:9pt}.ctitle.svelte-uialbm{color:#1a1a1a}.curl.svelte-uialbm{font:8.5pt var(--font-mono, "IBM Plex Mono");color:#0b5394;word-break:break-all}.cdocid.svelte-uialbm{font:8.5pt var(--font-mono, "IBM Plex Mono");color:#6b6b6b}.print-foot.svelte-uialbm{margin-top:18pt;padding-top:6pt;border-top:1pt solid #c8c6c2;font:8.5pt var(--font-mono, "IBM Plex Mono");color:#6b6b6b;line-height:1.5}.empty.svelte-uialbm{max-width:600px;margin:100px auto;padding:24px;font-family:var(--font-sans, "IBM Plex Sans");color:#1a1a1a}.empty.svelte-uialbm h1:where(.svelte-uialbm){font-size:20pt;margin-bottom:8pt}.empty.svelte-uialbm a:where(.svelte-uialbm){color:#0b5394}@media print{.no-print.svelte-uialbm{display:none!important}.print-doc.svelte-uialbm{margin:0;padding:0;max-width:none}@page{size:letter;margin:.85in .85in .85in 1in;@bottom-right{content:"page " counter(page) " of " counter(pages);font:9pt IBM Plex Mono;color:#4a4a4a}@bottom-left{content:"riprap.nyc";font:9pt IBM Plex Mono;color:#4a4a4a}}.print-citations.svelte-uialbm{page-break-before:always}}

web/sveltekit/build/_app/immutable/assets/4.CPUwsEjs.css

@@ -0,0 +1 @@
+.register-grid.svelte-1q8jizq{display:grid;gap:16px;grid-template-columns:1fr}@media(min-width:1100px){.register-grid.svelte-1q8jizq{grid-template-columns:1fr 1fr}}.plan-details.svelte-1q8jizq{border:1px solid var(--rule-soft);background:var(--paper-deep);margin-bottom:16px}.plan-details.svelte-1q8jizq summary:where(.svelte-1q8jizq){padding:10px 14px;cursor:pointer;font-family:var(--font-mono);font-size:12px;color:var(--ink-secondary)}.plan-stream.svelte-1q8jizq{font-family:var(--font-mono);font-size:11px;color:var(--ink-tertiary);white-space:pre-wrap;padding:0 14px 12px;margin:0;max-height:240px;overflow:auto}.generating-status.svelte-1q8jizq{display:flex;align-items:center;gap:12px;padding:12px 0;font-family:var(--font-mono);font-size:13px;color:var(--ink-secondary);flex-wrap:wrap}.pulse.svelte-1q8jizq{width:8px;height:8px;border-radius:50%;background:var(--accent-graphical);animation:svelte-1q8jizq-pulse 1.4s ease-in-out infinite}@keyframes svelte-1q8jizq-pulse{0%,to{opacity:.3;transform:scale(.85)}50%{opacity:1;transform:scale(1.1)}}@media(prefers-reduced-motion:reduce){.pulse.svelte-1q8jizq{animation:none;opacity:.7}}

web/sveltekit/build/_app/immutable/assets/Briefing.Cg0TTl7h.css

@@ -0,0 +1 @@
+.tier-badge.svelte-1acpjpp{display:inline-flex;align-items:center;gap:6px;font-family:var(--font-mono);font-size:11px;letter-spacing:.08em;text-transform:uppercase;font-weight:500}

web/sveltekit/build/_app/immutable/assets/MapLegend.DvDgr167.css

@@ -0,0 +1 @@
+.citation-drawer.svelte-1p339fd a{color:inherit;border-bottom:1px solid var(--rule-soft);text-decoration:none}.citation-drawer.svelte-1p339fd a:hover{border-bottom-color:var(--accent);color:var(--accent)}.rip-map-container.svelte-wk2bu4{position:absolute;top:0;right:0;bottom:0;left:0;width:100%;height:100%}.map-frame.svelte-wk2bu4{aspect-ratio:8 / 5.6;position:relative}