feat(dashboard): add forward "what's next" signal + fix upcoming floor

The daily-file bill queue is a backward snapshot, so "upcoming" could only
resurface the latest past day (the 08-31 snapshot read as today's queue) and
there was no "what is scheduled next." leginfo bill status/history are
backward-only, so the genuine future-dated signal is the chambers' "upcoming
events" calendars.

- api.py: floor the "upcoming" view at *today* (not the DB max date) when no
  as_of is pinned; surface next_legislative_day + scheduled_events (next 7
  days) on /bills. Add _today_iso / _next_legislative_day / _scheduled_events,
  all degrading to a recess marker / [] (never 5xx).
- relational.py: schema v2 adds the scheduled_events table +
  store_scheduled_events (idempotent per-day refresh), load_scheduled_events,
  next_legislative_day.
- parsers.py: parse_events_page + classify_event_kind for the chamber events
  calendar; skip empty-title rows (decompose the <time> before the fallback).
- ingest.py + cli.py: --store-events lane (cache-first, recess-safe) that
  parses the calendar HTML into scheduled_events.
- sources.py + config.yaml: register assembly_events / senate_events
  (kind: events, empty_is_ok: true).
- run_ingest.sh: run the events lane after the daily-file lane as non-fatal
  (skippable via CALI_SCRAPER_SKIP_EVENTS=1); daily-file exit still gates cron.
- frontend: "Next legislative day" line + "What's next · next 7 days" band
  with honest recess empty states.
- DASHBOARD.md: document the forward signal + known limitations (leginfo
  backward-only gap, recess empty state, 08-31 snapshot is analysis-only).
- tests: 5 new API tests + 18 parse-events tests; 170 pass, 92% coverage.

scraper/dashboard/static/app.js

@@ -175,16 +175,74 @@
         wireRows(container);
     }
 
-    function niceDate(iso) {
-        try {
-            var d = new Date(iso + "T00:00:00");
-            return d.toLocaleDateString(undefined, {
-                weekday: "short", month: "short", day: "numeric",
-                year: "numeric" });
-        } catch (e) { return iso; }
-    }
+     function niceDate(iso) {
+         try {
+             var d = new Date(iso + "T00:00:00");
+             return d.toLocaleDateString(undefined, {
+                 weekday: "short", month: "short", day: "numeric",
+                 year: "numeric" });
+          } catch (e) { return iso; }
+      }
 
-    /* ---------- empty states (DESIGN §6) ---------- */
+      /* ---------- forward "what's next" (scheduled_events, schema v2) -------
+         The daily-file queue is a backward snapshot; the chamber "upcoming
+         events" calendar is the only genuine future-dated signal. A recess
+         (recess: true / empty) is an honest empty state, not an error.        */
+     function eventRowHTML(ev) {
+         var url = ev.source_url || "";
+         var kindLabel = ev.kind && ev.kind !== "OTHER"
+              ? esc(ev.kind)
+              : (ev.chamber ? ev.chamber : "");
+         return '<div class="ev-row">'
+              + '<span class="ev-date">' + esc(niceDate(ev.date || ""))
+                   + "</span>"
+              + '<span class="ev-main">'
+                   + esc(ev.title || "(untitled)")
+                   + (url
+                        ? " <a href='" + esc(url) + "' target='_blank'"
+                            + " rel='noopener'>details →</a>"
+                        : "")
+              + "</span>"
+              + (kindLabel ? '<span class="chip ev-kind">'
+                   + kindLabel + "</span>" : "")
+              + "</div>";
+      }
+
+     function renderNextDay(nd) {
+         var e = el("freshness-next-day");
+         if (!e) return;
+         if (!nd || (nd.recess && !nd.date)) {
+             e.textContent = "Next legislative day: unknown (recess)";
+             e.style.color = "var(--warn)";
+             return;
+         }
+         e.textContent = "Next legislative day: "
+              + (nd.date ? niceDate(nd.date) : "unknown");
+         e.style.color = "var(--muted)";
+      }
+
+     function renderNextBand(events) {
+         var list = el("next-list");
+         var empty = el("next-empty");
+         var count = el("next-count");
+         if (!list || !empty || !count) return;
+         if (!events.length) {
+             list.innerHTML = "";
+             count.textContent = "";
+             empty.innerHTML =
+                  "<h3>Nothing scheduled in the next 7 days</h3>"
+                   + "<p>The chambers are in recess. This band fills in as the "
+                   + "next hearings are posted.</p>";
+             empty.hidden = false;
+             return;
+         }
+         empty.hidden = true;
+         count.textContent = events.length
+              + (events.length === 1 ? " event" : " events");
+         list.innerHTML = events.map(eventRowHTML).join("");
+      }
+
+      /* ---------- empty states (DESIGN §6) ---------- */
     function showEmpty(kind, container) {
         var el = el(container);
         var h = "";
@@ -250,6 +308,9 @@
         el("freshness-chamber").style.color =
              c.SENATE === "available" ? "var(--muted)" : "var(--warn)";
 
+         renderNextDay(env.next_legislative_day);
+         renderNextBand(env.scheduled_events || []);
+
         var items = env.items || [];
         state.allItems = items;
         var band = items.filter(function (i) {

scraper/dashboard/static/index.html

@@ -33,10 +33,11 @@
 <main id="app">
     <!-- §9 status / context band -->
     <section class="freshness" id="freshness" aria-live="polite">
-        <span id="freshness-updated">Loading…</span>
-        <span id="freshness-session" class="badge"></span>
-        <span id="freshness-chamber" class="note"></span>
-        <button type="button" id="btn-refresh" class="ghost">Refresh</button>
+          <span id="freshness-updated">Loading…</span>
+          <span id="freshness-session" class="badge"></span>
+          <span id="freshness-chamber" class="note"></span>
+          <span id="freshness-next-day" class="note"></span>
+          <button type="button" id="btn-refresh" class="ghost">Refresh</button>
     </section>
 
     <!-- Controls bar -->
@@ -64,9 +65,17 @@
             <input type="checkbox" id="f-reason" title="Show why each
                 floated bill is in your view">
         </label>
-    </section>
+      </section>
 
-    <!-- Logged-in personal controls (ZIP + watch/opt-in) -->
+      <!-- What's next: forward-looking chamber events calendar (scheduled_events) -->
+      <section class="band next-band" id="next-band" aria-label="Next 7 days">
+          <h2 class="band-title">What's next · next 7 days
+              <span id="next-count" class="count"></span></h2>
+          <div id="next-list" class="list next-list"></div>
+          <div id="next-empty" class="empty-state" hidden></div>
+      </section>
+
+      <!-- Logged-in personal controls (ZIP + watch/opt-in) -->
     <section class="personal-controls" id="personal-controls" hidden>
         <div class="zip-lookup">
             <label for="zip-input">Where do you live?</label>

scraper/dashboard/static/style.css

@@ -139,6 +139,19 @@ button.chip-toggle { min-width: 120px; }
 .band-title .count { color: var(--ink); font-weight: 700; }
 #personal-band .band-title { color: var(--accent); }
 
+/* ---- forward "what's next" band (scheduled_events) ---- */
+.next-band { background: #fbfcff; }
+.next-band .band-title { color: var(--accent); }
+.ev-row {
+    display: grid; grid-template-columns: 120px 1fr auto;
+    gap: 10px; align-items: baseline;
+    padding: 8px 8px 8px 0; border-bottom: 1px solid var(--border);
+}
+.ev-date { color: var(--muted); font-size: 13px; white-space: nowrap; }
+.ev-main { font-weight: 600; }
+.chip.ev-kind { background: #eef3fb; color: var(--asm); border-color: #cdd9ee; }
+#freshness-next-day { white-space: nowrap; }
+
 .day-heading {
    font-size: 13px; color: var(--muted); margin: 14px 0 6px;
    padding-bottom: 4px; border-bottom: 1px solid var(--border); }