@bongos/core 1.19.534 → 1.19.535

package/docs/copy-registry.json

@@ -3,17 +3,17 @@
   "generator": "scripts/gds/copy-inventory.js",
   "goal": 1000074,
   "counts": {
-    "strings": 1652,
-    "unique_ids": 1433,
-    "certain": 1652,
+    "strings": 1654,
+    "unique_ids": 1434,
+    "certain": 1654,
     "heuristic": 0,
-    "duplicate_ids": 154
+    "duplicate_ids": 155
   },
   "surfaces": {
     "builders-hall": {
       "at": "modules/hall-ui/public",
-      "files": 73,
-      "strings": 1187
+      "files": 74,
+      "strings": 1189
     },
     "status-dashboard": {
       "at": "modules/status-ui/public",
@@ -146,7 +146,7 @@
         "modules/hall-ui/public/hall-render.js:605",
         "modules/hall-ui/public/idea.js:207",
         "modules/hall-ui/public/ideas.js:476",
-        "modules/hall-ui/public/watch.js:1021"
+        "modules/hall-ui/public/watch.js:1137"
       ]
     },
     {
@@ -218,7 +218,7 @@
         "modules/hall-ui/public/gate.js:219",
         "modules/hall-ui/public/government.js:1104",
         "modules/hall-ui/public/harbor.js:337",
-        "modules/hall-ui/public/watch.js:1050"
+        "modules/hall-ui/public/watch.js:1166"
       ]
     },
     {
@@ -1073,6 +1073,16 @@
         "modules/hall-ui/public/ranks.html:6"
       ]
     },
+    {
+      "id": "b03e17693dcd",
+      "surface": "builders-hall",
+      "text": "Read it as a table",
+      "occurrences": 2,
+      "at": [
+        "modules/hall-ui/public/drachmae.js:148",
+        "modules/hall-ui/public/watch.js:1027"
+      ]
+    },
     {
       "id": "664f5731ddc3",
       "surface": "landing",
@@ -1450,7 +1460,7 @@
       "occurrences": 2,
       "at": [
         "modules/hall-ui/public/roadmap.js:108",
-        "modules/hall-ui/public/roadmap.js:263"
+        "modules/hall-ui/public/roadmap.js:275"
       ]
     },
     {
@@ -1620,7 +1630,7 @@
       "occurrences": 2,
       "at": [
         "modules/hall-ui/public/roadmap.js:74",
-        "modules/hall-ui/public/roadmap.js:273"
+        "modules/hall-ui/public/roadmap.js:285"
       ]
     },
     {
@@ -2361,7 +2371,7 @@
       "surface": "builders-hall",
       "text": "Audit log",
       "file": "modules/hall-ui/public/watch.html",
-      "line": 144,
+      "line": 148,
       "origin": "html-text",
       "confidence": "certain"
     },
@@ -3540,7 +3550,7 @@
       "surface": "builders-hall",
       "text": "Could not load this page.",
       "file": "modules/hall-ui/public/watch.js",
-      "line": 1096,
+      "line": 1212,
       "origin": "js-notice",
       "confidence": "certain"
     },
@@ -3882,7 +3892,7 @@
       "surface": "builders-hall",
       "text": "Could not verify your access. Go back and try again.",
       "file": "modules/hall-ui/public/watch.js",
-      "line": 1095,
+      "line": 1211,
       "origin": "js-text-assign",
       "confidence": "certain"
     },
@@ -4008,7 +4018,7 @@
       "surface": "builders-hall",
       "text": "Dated exploit-detail engagement reports — kept out of the repo (threat-model §6.3) and served only to Archons. Upload via POST /api/bongos/security/docs.",
       "file": "modules/hall-ui/public/watch.html",
-      "line": 134,
+      "line": 138,
       "origin": "html-text",
       "confidence": "certain"
     },
@@ -4350,7 +4360,7 @@
       "surface": "builders-hall",
       "text": "Engagement reports",
       "file": "modules/hall-ui/public/watch.html",
-      "line": 133,
+      "line": 137,
       "origin": "html-text",
       "confidence": "certain"
     },
@@ -4368,7 +4378,7 @@
       "surface": "builders-hall",
       "text": "Estimation accuracy",
       "file": "modules/hall-ui/public/watch.html",
-      "line": 151,
+      "line": 155,
       "origin": "html-text",
       "confidence": "certain"
     },
@@ -5034,7 +5044,7 @@
       "surface": "builders-hall",
       "text": "How task estimates compare with the time work actually took.",
       "file": "modules/hall-ui/public/watch.html",
-      "line": 152,
+      "line": 156,
       "origin": "html-text",
       "confidence": "certain"
     },
@@ -5070,7 +5080,7 @@
       "surface": "builders-hall",
       "text": "How the whole build is doing — the program at a glance, then each version. Shipped work stays out of the way.",
       "file": "modules/hall-ui/public/roadmap.js",
-      "line": 400,
+      "line": 416,
       "origin": "js-text-assign",
       "confidence": "certain"
     },
@@ -6321,7 +6331,7 @@
       "surface": "builders-hall",
       "text": "No version is in flight right now.",
       "file": "modules/hall-ui/public/roadmap.js",
-      "line": 380,
+      "line": 392,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -6330,7 +6340,7 @@
       "surface": "builders-hall",
       "text": "No versions declared yet.",
       "file": "modules/hall-ui/public/roadmap.js",
-      "line": 394,
+      "line": 410,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -6784,6 +6794,15 @@
       "origin": "js-markup",
       "confidence": "certain"
     },
+    {
+      "id": "d89d1923ecf9",
+      "surface": "builders-hall",
+      "text": "Over the last {…} days",
+      "file": "modules/hall-ui/public/watch.js",
+      "line": 1054,
+      "origin": "js-markup",
+      "confidence": "certain"
+    },
     {
       "id": "695ffff13730",
       "surface": "builders-hall",
@@ -6798,7 +6817,7 @@
       "surface": "builders-hall",
       "text": "Override requests",
       "file": "modules/hall-ui/public/watch.html",
-      "line": 139,
+      "line": 143,
       "origin": "html-text",
       "confidence": "certain"
     },
@@ -7198,6 +7217,15 @@
       "origin": "js-markup",
       "confidence": "certain"
     },
+    {
+      "id": "b03e17693dcd",
+      "surface": "builders-hall",
+      "text": "Read it as a table",
+      "file": "modules/hall-ui/public/watch.js",
+      "line": 1027,
+      "origin": "js-markup",
+      "confidence": "certain"
+    },
     {
       "id": "b6fcfdd652a7",
       "surface": "builders-hall",
@@ -7653,7 +7681,7 @@
       "surface": "builders-hall",
       "text": "Restricted.",
       "file": "modules/hall-ui/public/watch.js",
-      "line": 1050,
+      "line": 1166,
       "origin": "js-text-assign",
       "confidence": "certain"
     },
@@ -8382,7 +8410,7 @@
       "surface": "builders-hall",
       "text": "System oversight: people, operations and security.",
       "file": "modules/hall-ui/public/watch.js",
-      "line": 1109,
+      "line": 1225,
       "origin": "js-text-assign",
       "confidence": "certain"
     },
@@ -8832,7 +8860,7 @@
       "surface": "builders-hall",
       "text": "The roadmap could not be loaded right now. Reload to try again.",
       "file": "modules/hall-ui/public/roadmap.js",
-      "line": 407,
+      "line": 423,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -8841,7 +8869,7 @@
       "surface": "builders-hall",
       "text": "The roadmap failed to load. Reload to try again.",
       "file": "modules/hall-ui/public/roadmap.js",
-      "line": 408,
+      "line": 424,
       "origin": "js-notice",
       "confidence": "certain"
     },
@@ -9408,7 +9436,7 @@
       "surface": "builders-hall",
       "text": "Vulnerability reports",
       "file": "modules/hall-ui/public/watch.html",
-      "line": 128,
+      "line": 132,
       "origin": "html-text",
       "confidence": "certain"
     },
@@ -9417,7 +9445,7 @@
       "surface": "builders-hall",
       "text": "Vulnerability reports, engagement reports, override requests, and the audit log.",
       "file": "modules/hall-ui/public/watch.html",
-      "line": 125,
+      "line": 129,
       "origin": "html-text",
       "confidence": "certain"
     },
@@ -10236,7 +10264,7 @@
       "surface": "builders-hall",
       "text": "achieved ·",
       "file": "modules/hall-ui/public/roadmap.js",
-      "line": 263,
+      "line": 275,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -10704,7 +10732,7 @@
       "surface": "builders-hall",
       "text": "in progress ·",
       "file": "modules/hall-ui/public/roadmap.js",
-      "line": 263,
+      "line": 275,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -10956,7 +10984,7 @@
       "surface": "builders-hall",
       "text": "not started",
       "file": "modules/hall-ui/public/roadmap.js",
-      "line": 263,
+      "line": 275,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -11001,7 +11029,7 @@
       "surface": "builders-hall",
       "text": "of all in-flight tasks shipped",
       "file": "modules/hall-ui/public/roadmap.js",
-      "line": 273,
+      "line": 285,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -11028,7 +11056,7 @@
       "surface": "builders-hall",
       "text": "of {…}",
       "file": "modules/hall-ui/public/roadmap.js",
-      "line": 263,
+      "line": 275,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -11208,7 +11236,7 @@
       "surface": "builders-hall",
       "text": "shipped (live)",
       "file": "modules/hall-ui/public/roadmap.js",
-      "line": 273,
+      "line": 285,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -11316,7 +11344,7 @@
       "surface": "builders-hall",
       "text": "task {…}",
       "file": "modules/hall-ui/public/watch.js",
-      "line": 1021,
+      "line": 1137,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -11325,7 +11353,7 @@
       "surface": "builders-hall",
       "text": "tasks remaining",
       "file": "modules/hall-ui/public/roadmap.js",
-      "line": 273,
+      "line": 285,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -11442,7 +11470,7 @@
       "surface": "builders-hall",
       "text": "versions in flight",
       "file": "modules/hall-ui/public/roadmap.js",
-      "line": 273,
+      "line": 285,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -11829,7 +11857,7 @@
       "surface": "builders-hall",
       "text": "{…} shipped, {…} confirmed, {…} completed, {…} remaining of {…}",
       "file": "modules/hall-ui/public/roadmap.js",
-      "line": 273,
+      "line": 285,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -11838,7 +11866,7 @@
       "surface": "builders-hall",
       "text": "{…} tasks · {…}",
       "file": "modules/hall-ui/public/roadmap.js",
-      "line": 390,
+      "line": 406,
       "origin": "js-markup",
       "confidence": "certain"
     },

package/docs/module-api-changelog.md

@@ -1517,5 +1517,7 @@ is load-bearing: the script throws rather than guess if it is missing, and
         joinabilityMode did at 1.19.374.
   1.19.534 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
         landed since 1.19.533 with no explicit bump. run 33885355024. (task 1002620)
+  1.19.535 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
+        landed since 1.19.534 with no explicit bump. run 33886686350. (task 1002620)
 ---------------------------------------------------------------------------
 ```

package/modules/hall-ui/public/hall-kit.js

@@ -737,13 +737,25 @@
       + '</svg>';
   }
 
-  // Horizontal labelled bars. rows: [{ label, value, valueLabel }].
+  // Horizontal labelled bars. rows: [{ label, value, start, valueLabel }].
   // opts: { max, tone: 'accent'|'neutral', labelWidth, valueWidth, barHeight,
   //         pill, ariaLabel, list }
   //
   // `max` is the caller's when several series must share one scale; otherwise
   // the largest value here. It floors at 1 so an all-zero set draws empty
   // tracks instead of dividing by zero.
+  //
+  // A row's optional `start` OFFSETS its bar instead of beginning it at the
+  // track's left edge, which turns the same primitive into a SPAN series — a
+  // timeline. It arrived with the roadmap's versions (task 1003447): each one
+  // holds a `started_at` and a `shipped_at`, and the series those two dates
+  // support is "when did each version run", every bar on one shared axis. That
+  // is a bar with a left offset and nothing else, so it is an OPTION here
+  // rather than a second class family — the same seam every other difference
+  // between call sites rides. `start` is in the SAME units as `value` and
+  // measured from the axis origin, so the kit still never learns what a date
+  // is: a caller passes `max` as the axis span and `start` as the offset into
+  // it, exactly as it already passes x0/x1/yMax to the plot.
   function barSeriesHtml(rows, opts = {}) {
     const list = (rows || []).filter((r) => r && r.label !== undefined && r.label !== null);
     if (!list.length) return '';
@@ -775,14 +787,34 @@
       + (opts.ariaLabel ? ` aria-label="${esc(opts.ariaLabel)}"` : '')
       + '>'
       + list.map((r, i) => {
-        const w = Math.round((vals[i] / max) * 100);
+        // A POSITIVE value always draws at least a sliver. Rounding alone sends
+        // anything under half a percent of the max to `width:0%`, which reads as
+        // "none" — the one thing it is not. Zero stays zero: an empty track is
+        // the honest picture of nothing, and the column series makes the
+        // opposite choice for the opposite reason (a zero bucket there is a week
+        // that happened). Load-bearing for a span: a version that started and
+        // shipped inside one day is a real span half a pixel wide.
+        const raw = Math.round((vals[i] / max) * 100);
+        const w = vals[i] > 0 ? Math.max(1, raw) : raw;
+        // The offset takes the SAME floor, and for the same reason: a span that
+        // begins just after the axis origin but rounds to 0% draws flush against
+        // the track edge, which is the picture of "started first" — and on a
+        // timeline that is a claim about ordering, not a rounding artefact.
+        const start = Number(r.start);
+        const rawOff = Number.isFinite(start) && start > 0 ? Math.round((start / max) * 100) : 0;
+        const off = Number.isFinite(start) && start > 0 ? Math.max(1, rawOff) : 0;
+        // Offset by MARGIN, not `left`: the fill is an ordinary block inside the
+        // track, so absolute positioning would need a positioned ancestor the
+        // track does not declare. Omitted entirely at zero, so every existing
+        // caller's markup is byte-identical to what it was.
+        const geom = off > 0 ? `margin-left:${off}%;width:${w}%` : `width:${w}%`;
         const val = r.valueLabel === undefined || r.valueLabel === null
           ? String(vals[i])
           : String(r.valueLabel);
         return `<div class="kit-bars__row"${rowRole}>`
           + `<span class="kit-bars__label">${esc(r.label)}</span>`
           + `<span class="kit-bars__track" aria-hidden="true">`
-          + `<span class="kit-bars__fill" style="width:${w}%"></span></span>`
+          + `<span class="kit-bars__fill" style="${geom}"></span></span>`
           + `<span class="kit-bars__val">${esc(val)}</span>`
           + '</div>';
       }).join('')
@@ -818,10 +850,60 @@
     return { width, height, pad, base: height - pad.b };
   }
 
+  // The VERTICAL window a series should be drawn in — the companion to
+  // timeStepGeometry's yMin/yMax, and geometry rather than date semantics, which
+  // is why it lives here rather than at the call site (task 1003447).
+  //
+  // `zeroBased` (the default) is right whenever zero is a state the series can
+  // actually reach: a count of dead exports sitting at zero for a week is the
+  // reading, and lifting the floor off it would invent a change. Pass false for
+  // a LEVEL — repo-health's total_loc — where zero is unreachable and a zero
+  // floor squashes a month of real movement into a flat band across the top.
+  // A fitted floor magnifies every wiggle, so a caller that passes false owes
+  // the reader the range in words somewhere on the page.
+  //
+  // `air` is the fraction of the range left as breathing room (12% by default)
+  // so the line neither rides the top edge nor welds itself to the axis. A FLAT
+  // series has no range to take a fraction of, so the air falls back to the
+  // value's own magnitude — and, for a series flat at zero, to 1, which leaves
+  // it drawn honestly along the axis.
+  //
+  // A MISSING entry is dropped, not read as zero: a null from a snapshot that
+  // predates a column would otherwise drag `lo` to zero and draw a cliff nothing
+  // recorded. Note this is the one place in the kit that must NOT go through
+  // `chartNums` — that maps a null to 0 on purpose, because a gap-filled DAILY
+  // feed really does mean "nothing happened that day". Here a null means "not
+  // measured", and the two are opposite readings of the same byte. `Number(null)`
+  // and `Number('')` are both a finite 0, so the emptiness has to be tested for
+  // before the coercion, never after it.
+  function plotWindow(values, opts = {}) {
+    const nums = (values || [])
+      .filter((v) => v !== null && v !== undefined && v !== '')
+      .map(Number)
+      .filter((n) => Number.isFinite(n));
+    if (!nums.length) return { lo: 0, hi: 0, yMin: 0, yMax: 1, n: 0 };
+    const lo = Math.min(...nums);
+    const hi = Math.max(...nums);
+    const frac = Number.isFinite(Number(opts.air)) ? Number(opts.air) : 0.12;
+    const air = ((hi - lo) || Math.abs(hi) || 1) * frac;
+    const zeroBased = opts.zeroBased !== false;
+    return { lo, hi, yMin: zeroBased ? 0 : lo - air, yMax: hi + air, n: nums.length };
+  }
+
   // A STEP line over a time axis: the value holds until the next recorded
   // point, then rises — which is what a cumulative "how much by now" series
   // means, and why this is not a straight polyline between samples.
   // points: [{ x, value }] in data space, sorted. Returns { d, area, xs }.
+  //
+  // `yMin` (default 0) is the value the AXIS sits at, and it exists because the
+  // second kind of series this plot draws is not cumulative. A cumulative line
+  // starts at nothing and every reading is "how much by now", so zero is the
+  // only honest floor. A LEVEL — repo-health's total_loc, task 1003447 — is a
+  // large number that moves a little: on a zero floor its whole month of change
+  // is a flat band across the top, and the chart says nothing the headline
+  // figure did not. A caller that fits the floor to the data MUST say so on the
+  // page (watch.js puts the range in the figure's foot), because a non-zero
+  // baseline silently multiplies how big every wiggle looks.
   function timeStepGeometry(points, opts = {}) {
     const { width, height, pad, base } = plotBox(opts);
     const list = points || [];
@@ -829,11 +911,14 @@
     const x0 = Number(opts.x0 ?? list[0].x);
     const x1 = Number(opts.x1 ?? list[list.length - 1].x);
     const last = list[list.length - 1];
-    // A span of 0 (one point, no window) would divide by zero; yMax 0 likewise.
+    // A span of 0 (one point, no window) would divide by zero; a flat series
+    // whose yMin and yMax are equal likewise.
     const spanX = (x1 - x0) || 1;
-    const yMax = Number(opts.yMax ?? last.value) || 1;
+    const yMin = Number.isFinite(Number(opts.yMin)) ? Number(opts.yMin) : 0;
+    const yMax = Number(opts.yMax ?? last.value);
+    const spanY = ((Number.isFinite(yMax) ? yMax : 0) - yMin) || 1;
     const px = (t) => pad.l + ((t - x0) / spanX) * (width - pad.l - pad.r);
-    const py = (v) => height - pad.b - (v / yMax) * (height - pad.t - pad.b);
+    const py = (v) => height - pad.b - ((v - yMin) / spanY) * (height - pad.t - pad.b);
     let d = `M${px(list[0].x).toFixed(1)},${py(list[0].value).toFixed(1)}`;
     list.forEach((p, i) => {
       if (i === 0) return;
@@ -961,7 +1046,8 @@
     plotSvgHtml, plotValueLabelHtml, timeStepSeriesHtml, timeStepGeometry, columnSeriesHtml,
     // plotBox is exported so a caller mapping pointer x back into viewBox
     // space reads the plot's width instead of re-declaring the number.
-    plotBox,
+    // plotWindow fits the vertical axis to a level series (task 1003447).
+    plotBox, plotWindow,
     // states
     emptyStateHtml, skeletonRows, collapsibleCard,
     // ship-time task visual (task 1003109)

package/modules/hall-ui/public/roadmap-timeline.js

@@ -0,0 +1,105 @@
+// roadmap-timeline.js — the program in time (task 1003447, criterion
+// `legibility-series-are-drawn`).
+//
+// /public/versions has always carried `started_at` and `shipped_at` per version,
+// and /roadmap drew NEITHER: both dates reached the browser and came out as
+// "Sep 2026" on a shipped pill. The series two dates support is a SPAN — when
+// each version ran — and every span on ONE shared axis is the reading the page
+// exists for: whether the build is speeding up, and how much of the in-flight
+// version's run is already behind it.
+//
+// Its own file rather than another sixty lines of roadmap.js, for the reason
+// profile-charts.js is its own file: the builders are PURE, so a test imports
+// this and runs the real arithmetic over the real fixture instead of agreeing
+// with a copy of it. Exposed as window.OTBRoadmapTimeline; node-require-safe
+// (the hall-kit.js / dom-utils.js pattern — assignment is the only eval-time
+// side effect, and only when a window exists).
+//
+// The DRAWING is the kit's: OTBKit.barSeriesHtml with a per-row `start`, the
+// span option added for exactly this. Date arithmetic stays here — the kit takes
+// `max` as the axis span and `start` as an offset into it, and never learns what
+// a month is. That is the same seam every other chart in the hall rides.
+(() => {
+  'use strict';
+
+  const MON = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'];
+
+  // "May ’26" — short enough that a whole span label fits the value column at
+  // phone width, which "May 2026 – September 2026" does not.
+  function ymShort(t) {
+    const d = new Date(t);
+    return Number.isNaN(d.getTime()) ? '' : `${MON[d.getMonth()]} ’${String(d.getFullYear()).slice(-2)}`;
+  }
+
+  // One row per version that actually started, oldest first.
+  //
+  // A version with no parsable `start` is NOT on the timeline, because it has
+  // not happened. Defaulting it to the axis origin would draw it as having begun
+  // at the start of the project, which is the opposite of true; the caller says
+  // how many were left out instead.
+  //
+  // `open` is a version still running (or parked mid-run): its span reaches
+  // today and its label says "now", rather than naming an end date nothing
+  // recorded. `to` is floored at `from` so a clock skew or a bad shipped_at
+  // cannot produce a negative span the kit would draw backwards.
+  function timelineRows(all, now) {
+    return (all || [])
+      .map((v) => {
+        const from = Date.parse(v && v.start);
+        if (!Number.isFinite(from)) return null;
+        const shipped = Date.parse(v.ship);
+        const open = !Number.isFinite(shipped);
+        return { v, from, to: Math.max(open ? now : shipped, from), open };
+      })
+      .filter(Boolean)
+      .sort((a, b) => a.from - b.from);
+  }
+
+  // The chart card: the spans, and the foot that says what the axis covers and
+  // what is missing from it. Returns { count, html }, or NULL when there is
+  // nothing worth drawing — so the caller renders no section at all rather than
+  // an empty panel. One return shape either way, never a string sometimes and an
+  // object other times.
+  //
+  // `kit` is a parameter (defaulting to window.OTBKit) so this module is pure
+  // enough to import in node and run against the real kit in a test.
+  function timelineCardHtml(all, now, kit) {
+    const k = kit || (typeof window !== 'undefined' ? window.OTBKit : null);
+    if (!k) return null;
+    const rows = timelineRows(all, now);
+    // One version is not a timeline: a single bar filling the whole axis says
+    // nothing that version's own card does not already say.
+    if (rows.length < 2) return null;
+
+    const t0 = rows[0].from;
+    const t1 = Math.max(now, ...rows.map((r) => r.to));
+    const span = (t1 - t0) || 1;
+    const bars = k.barSeriesHtml(
+      rows.map((r) => ({
+        label: r.v.id,
+        value: r.to - r.from,
+        start: r.from - t0,
+        valueLabel: `${ymShort(r.from)} → ${r.open ? 'now' : ymShort(r.to)}`,
+      })),
+      {
+        max: span,
+        list: true,
+        ariaLabel: 'When each version ran',
+        labelWidth: '92px',
+        valueWidth: '108px',
+        barHeight: '10px',
+        pill: true,
+      },
+    );
+    const missing = (all || []).length - rows.length;
+    const foot = `${ymShort(t0)} to today, one bar per version.`
+      + (missing > 0
+        ? ` ${missing} version${missing === 1 ? '' : 's'} with no start date ${missing === 1 ? 'is' : 'are'} not shown.`
+        : '');
+    return { count: rows.length, html: k.chartCardHtml('When each version ran', bars, foot) };
+  }
+
+  const api = { timelineRows, timelineCardHtml, ymShort };
+  if (typeof window !== 'undefined') window.OTBRoadmapTimeline = api;
+  if (typeof module !== 'undefined' && module.exports) module.exports = api;
+})();

package/modules/hall-ui/public/roadmap.html

@@ -45,6 +45,12 @@
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/dom-utils.js?v=2026-06-14-domutils"></script>
-<script src="/builders/roadmap.js?v=2026-07-24-deck1"></script>
+<!-- The chart kit and the timeline's series builders (task 1003447). Both MUST
+     precede roadmap.js: the page reads window.OTBKit / window.OTBRoadmapTimeline
+     at render time, so loading either after would be a blank section in
+     production and a green unit suite. tests/hall_kit_charts.mjs pins the order. -->
+<script src="/builders/hall-kit.js"></script>
+<script src="/builders/roadmap-timeline.js"></script>
+<script src="/builders/roadmap.js?v=2026-09-03-timeline"></script>
 </body>
 </html>

package/modules/hall-ui/public/roadmap.js

@@ -241,6 +241,18 @@
     </article>`;
   }
 
+  // The program in time (task 1003447). The SERIES is roadmap-timeline.js's —
+  // pure builders in their own file so a test runs the real arithmetic over the
+  // real fixture — and the SECTION chrome is this page's, which is the same seam
+  // the chart kit keeps everywhere: the module draws, the page frames. Missing
+  // module or fewer than two started versions renders nothing at all, so the
+  // deck reads exactly as it did before rather than growing an empty panel.
+  function timelineHtml(all, now) {
+    const mod = window.OTBRoadmapTimeline;
+    const card = mod ? mod.timelineCardHtml(all, now) : null;
+    return card ? sectionHtml('flight', 'In time', card.count, '', card.html) : '';
+  }
+
   function sectionHtml(dotCls, title, count, note, inner) {
     return `<section class="rm-sec">
       <div class="rm-sec__h"><span class="rm-sec__dot rm-sec__dot--${dotCls}"></span><span class="rm-sec__t">${title}</span><span class="rm-sec__n">${count}</span><span class="rm-sec__rule"></span></div>
@@ -380,6 +392,10 @@
       html += `<div class="rm-hero"><div class="rm-lab" style="max-width:none">No version is in flight right now.</div></div>`;
     }
 
+    // Directly under the hero: both are program-level readings, and this is the
+    // one that answers "how fast" rather than "how much".
+    html += timelineHtml(all, Date.now());
+
     if (staged.length) {
       html += sectionHtml('staged', 'Staged', staged.length, 'Seeded with goals, not yet started.', `<div class="rm-grid">${staged.map(stagedCard).join('')}</div>`);
     }