Add speculative badge to results + v2 ROADMAP

- Static "speculative / modeled, not predicted" badge on timeline and
world results (responsible-UX guardrail, no extra model calls)
- ROADMAP.md parks the routed schema-driven architecture as v2

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

ROADMAP.md

@@ -0,0 +1,62 @@
+# Reality Divergence — v2 Roadmap
+
+The hackathon build is intentionally lean: two explicit tabs, schema-driven
+generation, validation + fallbacks, and one atmospheric image per result. This
+document parks the larger **routed, schema-driven architecture** as the post-
+hackathon direction. Nothing here is required for the current submission.
+
+## Guiding idea
+
+Move from "two fixed tabs" to a **router → policy gate → prompt picker →
+structured generation → validation → renderer** pipeline. Routing is decided in
+*code*, never by the model picking its own route.
+
+## Where we already are (≈55% of the target)
+
+| Target capability | Status |
+|---|---|
+| Schema-driven structured generation | ✅ done (`prompts.py` + parsing in `app.py`) |
+| Per-intent output schemas | ✅ done (timeline ≈ reflection; world ≈ alt-history/fork) |
+| Validation + never-crash fallback | ✅ done (`safe_int/str/list`, curated fallbacks) |
+| Timeline / branch renderer | ✅ done (HTML spine, better/worse, winners/losers) |
+| Safety guardrail (personal tab) | ✅ done (risk gate + 988 notice) |
+| Uncertainty framing | 🟡 in prompts + a "speculative" badge; no per-claim tagging |
+| Prompt picker | 🟡 by tab, not by router (2 routes, not 9) |
+| Intent router + confidence + clarification | ❌ not built |
+| Tone/mode selectors, confidence indicator | ❌ not built |
+| Streaming staged output | ❌ not built |
+| Conversational follow-up (turn-taking) | 🟡 reflection question shown statically |
+
+## v2 backlog (priority order)
+
+1. **Intent router** — one lightweight model (or rules) call classifying input into
+   a taxonomy: `personal_regret`, `alternate_history`, `event_counterfactual`,
+   `global_shock`, `regional_disaster`, `civilizational_fork`, `comparison`,
+   `creative_weird`, `mixed`. Returns `primary_intent`, `secondary_intents`,
+   `confidence`, `needs_clarification`, `divergence_scale`, `tone`, `image_policy`.
+2. **Policy gate** — below a confidence threshold (~0.72) ask one clarifying
+   question instead of generating; decide allowed output type.
+3. **Per-claim epistemic tagging** — tag statements `certain | speculative |
+   assumption`; render badges; downgrade tone when the model is over-confident.
+4. **Image policy** — generate images only for `creative_weird` / explicit visual
+   requests, not for reflective/uncertain output. (Current build always shows one
+   decorative banner — revisit.)
+5. **Single prompt box + mode/tone selectors + confidence indicator** to replace
+   the two-tab split.
+6. **Streaming** the response in stages (intent → structure → text → timeline →
+   image) so it feels fast.
+7. **Retry-once on schema-validation failure** before falling back.
+8. **Strict validation** via Pydantic/JSON-schema instead of the current `safe_*`
+   coercion.
+
+## Known design tensions to decide in v2
+
+- **Images:** v2 spec says default-off, artifact-only. Current build shows one
+  text-free atmospheric banner per result (decorative, not informational).
+- **Visual style:** v2 spec favors restraint ("no chaotic gradients, reflective
+  instrument"). Current build uses an animated gradient hero for impact.
+
+## Reference
+
+Architecture spec drafted from the Build Small field guide constraints and a
+prompt-routing / structured-output design pass (June 2026).

app.py

@@ -285,6 +285,7 @@ def render_timeline_html(timeline: Dict, direction: str, image_uri: str = "") ->
 <div class="rd-stack">
   <div class="rd-card rd-fork">
     {img}
+    <div class="rd-spec">⚗ One possible path — modeled, not predicted</div>
     <div class="rd-badge">{arrow}</div>
     <div class="rd-eyebrow">{label}</div>
     <h2 class="rd-title">{html.escape(timeline.get('title', 'Alternate Timeline'))}</h2>
@@ -321,6 +322,7 @@ def render_world_html(world: Dict, image_uri: str = "") -> str:
 <div class="rd-stack">
   <div class="rd-card rd-fork">
     {img}
+    <div class="rd-spec">⚗ Speculative — causal chains are modeled, not known</div>
     <div class="rd-badge">🌍</div>
     <div class="rd-eyebrow">Year {html.escape(str(world.get('year_divergence', '')))} · Point of divergence</div>
     <h2 class="rd-title">{html.escape(world.get('title', 'Alternate World'))}</h2>
@@ -553,6 +555,18 @@ body, .gradio-container {
   box-shadow: 0 8px 30px rgba(5, 8, 22, 0.55);
 }
 
+.rd-spec {
+  display: inline-flex; align-items: center; gap: 0.4rem;
+  font-size: 0.72rem; font-weight: 700; letter-spacing: 0.04em;
+  text-transform: uppercase;
+  color: #FBBF24;
+  background: rgba(251, 191, 36, 0.12);
+  border: 1px solid rgba(251, 191, 36, 0.4);
+  border-radius: 999px;
+  padding: 4px 12px;
+  margin-bottom: 0.9rem;
+}
+
 .rd-badge {
   display: inline-flex; align-items: center; justify-content: center;
   width: 46px; height: 46px; border-radius: 50%;