@intentius/behold 0.29.0 → 0.29.2

package/dist/cli.js

@@ -299,7 +299,7 @@ var K8sApiError, K8sTransportError, K8sClientUnavailableError, ExecCredentialNot
 var init_errors = __esm({
   "node_modules/@intentius/chant-k8s-client/src/errors.ts"() {
     K8sApiError = class _K8sApiError extends Error {
-      constructor(statusCode, reason, apiMessage, target, status) {
+      constructor(statusCode, reason, apiMessage, target, status2) {
         super(
           `${target ? `${target}: ` : ""}${apiMessage || "request failed"} (HTTP ${statusCode}${reason ? `, ${reason}` : ""})`
         );
@@ -307,7 +307,7 @@ var init_errors = __esm({
         this.reason = reason;
         this.apiMessage = apiMessage;
         this.target = target;
-        this.status = status;
+        this.status = status2;
         this.name = "K8sApiError";
       }
       statusCode;
@@ -348,16 +348,16 @@ var init_errors = __esm({
        * Kubernetes error and occasionally plain text from a proxy in front of one.
        */
       static fromResponse(statusCode, body, target) {
-        let status;
+        let status2;
         try {
           const parsed = JSON.parse(body);
           if (parsed && typeof parsed === "object" && parsed.kind === "Status") {
-            status = parsed;
+            status2 = parsed;
           }
         } catch {
         }
-        const message2 = status?.message ?? firstLine(body) ?? "";
-        return new _K8sApiError(statusCode, status?.reason, message2, target, status);
+        const message2 = status2?.message ?? firstLine(body) ?? "";
+        return new _K8sApiError(statusCode, status2?.reason, message2, target, status2);
       }
     };
     K8sTransportError = class extends Error {
@@ -496,13 +496,13 @@ function renderConflictReport(report) {
   );
   return lines2.join("\n");
 }
-function parseFieldConflicts(status, message2) {
-  const fromCauses = causesOf(status);
+function parseFieldConflicts(status2, message2) {
+  const fromCauses = causesOf(status2);
   if (fromCauses.length > 0) return fromCauses;
-  return parseConflictMessage(message2 ?? status?.message ?? "");
+  return parseConflictMessage(message2 ?? status2?.message ?? "");
 }
-function causesOf(status) {
-  const details = status?.details;
+function causesOf(status2) {
+  const details = status2?.details;
   if (!details || typeof details !== "object") return [];
   const causes = details.causes;
   if (!Array.isArray(causes)) return [];
@@ -570,8 +570,8 @@ var init_conflict = __esm({
       conflicts;
       /** The field manager chant applied as, and which was refused. */
       fieldManager;
-      constructor(statusCode, apiMessage, conflicts, fieldManager, target, status) {
-        super(statusCode, status?.reason ?? "Conflict", apiMessage, target, status);
+      constructor(statusCode, apiMessage, conflicts, fieldManager, target, status2) {
+        super(statusCode, status2?.reason ?? "Conflict", apiMessage, target, status2);
         this.name = "FieldManagerConflictError";
         this.conflicts = conflicts;
         this.fieldManager = fieldManager;
@@ -763,9 +763,9 @@ function parseWatchFrames(chunk, carry = "") {
 }
 function isExpiredFrame(frame) {
   if (frame.type !== "ERROR") return false;
-  const status = frame.object;
-  if (status.code === 410) return true;
-  return status.reason === "Expired" || status.reason === "Gone";
+  const status2 = frame.object;
+  if (status2.code === 410) return true;
+  return status2.reason === "Expired" || status2.reason === "Gone";
 }
 function resourceVersionOf(frame) {
   const rv = frame.object?.metadata?.resourceVersion;
@@ -943,16 +943,16 @@ async function createK8sClient(options2 = {}) {
     return { status: response.httpStatusCode, body: text };
   }
   async function sendJson(path, method, opts = {}) {
-    const { status, body } = await send(path, method, opts);
-    if (status < 200 || status > 299) {
-      throw noted(K8sApiError.fromResponse(status, body, opts.target));
+    const { status: status2, body } = await send(path, method, opts);
+    if (status2 < 200 || status2 > 299) {
+      throw noted(K8sApiError.fromResponse(status2, body, opts.target));
     }
     try {
       return JSON.parse(body);
     } catch (err) {
       throw noted(
         new K8sTransportError(
-          `the API server returned HTTP ${status} with a body that is not JSON`,
+          `the API server returned HTTP ${status2} with a body that is not JSON`,
           opts.target ?? `${method} ${path}`,
           { cause: err }
         )
@@ -1292,13 +1292,13 @@ async function createK8sClient(options2 = {}) {
     if (opts.sinceSeconds !== void 0) query.sinceSeconds = String(opts.sinceSeconds);
     if (opts.timestamps) query.timestamps = "true";
     const target = `${refText(ref2)} logs`;
-    const { status, body } = await send(`${objectPath(info, ref2.name, ref2.namespace)}/log`, "GET", {
+    const { status: status2, body } = await send(`${objectPath(info, ref2.name, ref2.namespace)}/log`, "GET", {
       query: Object.keys(query).length > 0 ? query : void 0,
       signal: opts.signal,
       target
     });
-    if (status < 200 || status > 299) {
-      throw noted(K8sApiError.fromResponse(status, body, target));
+    if (status2 < 200 || status2 > 299) {
+      throw noted(K8sApiError.fromResponse(status2, body, target));
     }
     return body;
   }
@@ -1887,8 +1887,8 @@ function statusForBand(band, score) {
       return score >= 80 ? "good" : score >= 50 ? "warn" : "neutral";
   }
 }
-function verdictForStatus(status) {
-  return status === "good" ? "carve now" : status === "warn" ? "boundary work" : "leave in Terraform";
+function verdictForStatus(status2) {
+  return status2 === "good" ? "carve now" : status2 === "warn" ? "boundary work" : "leave in Terraform";
 }
 function tfTypeOf(address, kind) {
   if (kind === "module" || address.startsWith("module.")) return "module";
@@ -1942,7 +1942,7 @@ function carveReportToIr(report) {
   const resources = report.resources ?? [];
   const known = new Set(resources.map((r) => r.address));
   const nodes = resources.map((r) => {
-    const status = statusForBand(r.band, r.score);
+    const status2 = statusForBand(r.band, r.score);
     const b = r.breakdown ?? {};
     const edges2 = boundaryEdgesOf(r);
     const patches = edges2.filter((e) => e.carved === r.address && directionOf(e) === "inbound").map((e) => e.survivor);
@@ -1954,9 +1954,9 @@ function carveReportToIr(report) {
       attrs: {
         // The drift palette's channel — `_`-prefixed, so it paints the card and
         // stays out of both the card's fields and the inspect pane's list.
-        _status: status,
+        _status: status2,
         score: r.score,
-        carve: verdictForStatus(status),
+        carve: verdictForStatus(status2),
         band: r.band,
         arithmetic: scoreArithmetic(r),
         boundaryWork: boundaryWorkOf(r),
@@ -4899,8 +4899,8 @@ function carveStatusArgs(from) {
 async function discoverCarveStates(dirs, read, io = nodeCarveIo, depth = MANIFEST_SCAN_DEPTH) {
   const byTarget = /* @__PURE__ */ new Map();
   for (const dir of dirs) {
-    const status = await read(dir).catch(() => void 0);
-    const paths = status?.carves ? status.carves.map((row) => resolve3(status.from ?? dir, row.path)) : listCarveManifests(dir, io, depth);
+    const status2 = await read(dir).catch(() => void 0);
+    const paths = status2?.carves ? status2.carves.map((row) => resolve3(status2.from ?? dir, row.path)) : listCarveManifests(dir, io, depth);
     mergeCarveStates(byTarget, paths, io);
   }
   return byTarget;
@@ -5828,10 +5828,10 @@ var require_utils = __commonJS({
       REGEX_SPECIAL_CHARS_GLOBAL
     } = require_constants();
     exports.isObject = (val) => val !== null && typeof val === "object" && !Array.isArray(val);
-    exports.hasRegexChars = (str16) => REGEX_SPECIAL_CHARS.test(str16);
-    exports.isRegexChar = (str16) => str16.length === 1 && exports.hasRegexChars(str16);
-    exports.escapeRegex = (str16) => str16.replace(REGEX_SPECIAL_CHARS_GLOBAL, "\\$1");
-    exports.toPosixSlashes = (str16) => str16.replace(REGEX_BACKSLASH, "/");
+    exports.hasRegexChars = (str17) => REGEX_SPECIAL_CHARS.test(str17);
+    exports.isRegexChar = (str17) => str17.length === 1 && exports.hasRegexChars(str17);
+    exports.escapeRegex = (str17) => str17.replace(REGEX_SPECIAL_CHARS_GLOBAL, "\\$1");
+    exports.toPosixSlashes = (str17) => str17.replace(REGEX_BACKSLASH, "/");
     exports.isWindows = () => {
       if (typeof navigator !== "undefined" && navigator.platform) {
         const platform2 = navigator.platform.toLowerCase();
@@ -5842,8 +5842,8 @@ var require_utils = __commonJS({
       }
       return false;
     };
-    exports.removeBackslashes = (str16) => {
-      return str16.replace(REGEX_REMOVE_BACKSLASH, (match) => {
+    exports.removeBackslashes = (str17) => {
+      return str17.replace(REGEX_REMOVE_BACKSLASH, (match) => {
         return match === "\\" ? "" : match;
       });
     };
@@ -5933,7 +5933,7 @@ var require_scan = __commonJS({
       const slashes = [];
       const tokens = [];
       const parts = [];
-      let str16 = input;
+      let str17 = input;
       let index = -1;
       let start = 0;
       let lastIndex = 0;
@@ -5952,10 +5952,10 @@ var require_scan = __commonJS({
       let code;
       let token = { value: "", depth: 0, isGlob: false };
       const eos = () => index >= length;
-      const peek = () => str16.charCodeAt(index + 1);
+      const peek = () => str17.charCodeAt(index + 1);
       const advance = () => {
         prev = code;
-        return str16.charCodeAt(++index);
+        return str17.charCodeAt(++index);
       };
       while (index < length) {
         code = advance();
@@ -6123,24 +6123,24 @@ var require_scan = __commonJS({
         isExtglob = false;
         isGlob = false;
       }
-      let base = str16;
+      let base = str17;
       let prefix = "";
       let glob = "";
       if (start > 0) {
-        prefix = str16.slice(0, start);
-        str16 = str16.slice(start);
+        prefix = str17.slice(0, start);
+        str17 = str17.slice(start);
         lastIndex -= start;
       }
       if (base && isGlob === true && lastIndex > 0) {
-        base = str16.slice(0, lastIndex);
-        glob = str16.slice(lastIndex);
+        base = str17.slice(0, lastIndex);
+        glob = str17.slice(lastIndex);
       } else if (isGlob === true) {
         base = "";
-        glob = str16;
+        glob = str17;
       } else {
-        base = str16;
+        base = str17;
       }
-      if (base && base !== "" && base !== "/" && base !== str16) {
+      if (base && base !== "" && base !== "/" && base !== str17) {
         if (isPathSeparator(base.charCodeAt(base.length - 1))) {
           base = base.slice(0, -1);
         }
@@ -7187,8 +7187,8 @@ var require_parse = __commonJS({
         if (opts2.noglobstar === true) return star;
         return `(${capture2}(?:(?!${START_ANCHOR}${opts2.dot ? DOTS_SLASH : DOT_LITERAL}).)*?)`;
       };
-      const create = (str16) => {
-        switch (str16) {
+      const create = (str17) => {
+        switch (str17) {
           case "*":
             return `${nodot}${ONE_CHAR}${star}`;
           case ".*":
@@ -7206,7 +7206,7 @@ var require_parse = __commonJS({
           case "**/.*":
             return `(?:${nodot}${globstar(opts)}${SLASH_LITERAL})?${DOT_LITERAL}${ONE_CHAR}${star}`;
           default: {
-            const match = /^(.*?)\.(\w+)$/.exec(str16);
+            const match = /^(.*?)\.(\w+)$/.exec(str17);
             if (!match) return;
             const source3 = create(match[1]);
             if (!source3) return;
@@ -7237,9 +7237,9 @@ var require_picomatch = __commonJS({
     var picomatch3 = (glob, options2, returnState = false) => {
       if (Array.isArray(glob)) {
         const fns = glob.map((input) => picomatch3(input, options2, returnState));
-        const arrayMatcher = (str16) => {
+        const arrayMatcher = (str17) => {
           for (const isMatch of fns) {
-            const state2 = isMatch(str16);
+            const state2 = isMatch(str17);
             if (state2) return state2;
           }
           return false;
@@ -7315,7 +7315,7 @@ var require_picomatch = __commonJS({
       const regex = glob instanceof RegExp ? glob : picomatch3.makeRe(glob, options2);
       return regex.test(utils.basename(input, { windows: posix5 }));
     };
-    picomatch3.isMatch = (str16, patterns, options2) => picomatch3(patterns, options2)(str16);
+    picomatch3.isMatch = (str17, patterns, options2) => picomatch3(patterns, options2)(str17);
     picomatch3.parse = (pattern, options2) => {
       if (Array.isArray(pattern)) return pattern.map((p) => picomatch3.parse(p, options2));
       return parse(pattern, { ...options2, fastpaths: false });
@@ -11077,16 +11077,16 @@ function pipelineProgress(pipeline) {
   }));
   return { kind: "pipeline", status: "running", waves, components };
 }
-function withJobStatus(state, job, status) {
+function withJobStatus(state, job, status2) {
   const components = state.components.map((c) => {
     if (c.component !== job) return c;
-    if ((c.status === "ok" || c.status === "failed") && status === "running") return c;
-    return { ...c, status };
+    if ((c.status === "ok" || c.status === "failed") && status2 === "running") return c;
+    return { ...c, status: status2 };
   });
   const waves = state.waves.map((w) => {
     const members = components.filter((c) => w.components.includes(c.component));
-    const status2 = members.some((c) => c.status === "failed") ? "failed" : members.every((c) => c.status === "ok") ? "ok" : members.some((c) => c.status !== "pending") ? "running" : "pending";
-    return { ...w, status: status2 };
+    const status3 = members.some((c) => c.status === "failed") ? "failed" : members.every((c) => c.status === "ok") ? "ok" : members.some((c) => c.status !== "pending") ? "running" : "pending";
+    return { ...w, status: status3 };
   });
   return { ...state, components, waves };
 }
@@ -11234,8 +11234,8 @@ function runViewToProgress(pipeline, view) {
     ...state,
     waves: state.waves.map((w) => {
       const members = state.components.filter((c) => w.components.includes(c.component));
-      const status = members.some((c) => c.status === "failed") ? "failed" : members.every((c) => c.status === "ok") ? "ok" : members.some((c) => c.status !== "pending") ? "running" : "pending";
-      return { ...w, status };
+      const status2 = members.some((c) => c.status === "failed") ? "failed" : members.every((c) => c.status === "ok") ? "ok" : members.some((c) => c.status !== "pending") ? "running" : "pending";
+      return { ...w, status: status2 };
     })
   };
   if (view.url) state = { ...state, url: view.url };
@@ -12010,8 +12010,8 @@ var FORGE_WORD = {
   local: "laptop",
   unknown: "?"
 };
-function releaseChip(status) {
-  return `${status.gitSha.slice(0, 7)} via ${FORGE_WORD[status.forge]}`;
+function releaseChip(status2) {
+  return `${status2.gitSha.slice(0, 7)} via ${FORGE_WORD[status2.forge]}`;
 }
 function releaseStatus(rec7) {
   if (!rec7) return void 0;
@@ -12060,7 +12060,7 @@ function joinTickVerdicts(ir, tick, now = Date.now()) {
     const v = byComponent.get(n.id);
     if (!v) return n;
     joined = true;
-    const status = {
+    const status2 = {
       reconciliation: v.reconciliation,
       detail: v.detail,
       ...v.live !== void 0 ? { live: v.live } : {},
@@ -12080,7 +12080,7 @@ function joinTickVerdicts(ir, tick, now = Date.now()) {
         // are deliberately not passed, so this can only ever reach
         // `componentStatusColor`'s last branch.
         ...paint ? { _status: componentStatusColor({ reconciliation: v.reconciliation, detail: v.detail }) } : {},
-        _tickStatus: status
+        _tickStatus: status2
       }
     };
   });
@@ -12756,11 +12756,11 @@ function tierMismatchNote(ir, tiers, currentTier) {
   if (values.length < 2) return void 0;
   const byLexicon = /* @__PURE__ */ new Map();
   for (const n of ir.nodes) {
-    const status = n.attrs?._status;
-    if (status !== "good" && status !== "accent") continue;
+    const status2 = n.attrs?._status;
+    if (status2 !== "good" && status2 !== "accent") continue;
     const lexicon = n.lexicon ?? "?";
     const c = byLexicon.get(lexicon) ?? { good: 0, accent: 0 };
-    c[status === "good" ? "good" : "accent"]++;
+    c[status2 === "good" ? "good" : "accent"]++;
     byLexicon.set(lexicon, c);
   }
   for (const [lexicon, { good, accent }] of [...byLexicon].sort()) {
@@ -15655,7 +15655,7 @@ function collapseBoxes(ir, opts = {}) {
     const nodes2 = ids.flatMap((id2) => byId.get(id2) ?? []);
     const id = `${SUMMARY_PREFIX}${key}`;
     for (const n of nodes2) standsFor.set(n.id, id);
-    const status = summaryStatus(nodes2);
+    const status2 = summaryStatus(nodes2);
     summaries.push({
       id,
       kind: "member",
@@ -15665,7 +15665,7 @@ function collapseBoxes(ir, opts = {}) {
         summary: boxBadgeText(nodes2),
         cards: nodes2.length,
         _collapsed: true,
-        ...status ? { _status: status } : {}
+        ...status2 ? { _status: status2 } : {}
       }
     });
     delete groups[key];
@@ -16023,8 +16023,8 @@ function bandedPlan(ir, bands) {
       });
     });
     const statuses = new Set(members.map((id) => statusOf.get(id)));
-    const status = statuses.size === 1 ? [...statuses][0] : void 0;
-    boxes.push({ title, x: panelW / 2, y: top + panelH / 2, w: panelW, h: panelH, ...status ? { status } : {} });
+    const status2 = statuses.size === 1 ? [...statuses][0] : void 0;
+    boxes.push({ title, x: panelW / 2, y: top + panelH / 2, w: panelW, h: panelH, ...status2 ? { status: status2 } : {} });
     top += panelH + BAND_GAP;
   }
   return { placed, boxes, width: panelW, height: Math.max(1, top - BAND_GAP) };
@@ -17635,9 +17635,9 @@ function neutralizeNegations(lower) {
   const text = lower.replace(/\bnot[_\-\s]?[a-z]+\b/g, mark).replace(/\b[a-z]+\s*[=:]\s*false\b/g, mark);
   return { text, negated };
 }
-function classifyHealth(status) {
-  if (!status) return "unknown";
-  const { text, negated } = neutralizeNegations(status.toLowerCase());
+function classifyHealth(status2) {
+  if (!status2) return "unknown";
+  const { text, negated } = neutralizeNegations(status2.toLowerCase());
   if (DEGRADED.test(text)) return "degraded";
   if (PROGRESSING.test(text)) return "progressing";
   if (negated) return "degraded";
@@ -17725,9 +17725,9 @@ function readyFromConditions(tree) {
   for (const c of conditions) {
     const cond = rec4(c);
     if (!cond || cond.type !== "Ready") continue;
-    const status = str5(cond.status);
-    if (status !== "True" && status !== "False" && status !== "Unknown") continue;
-    return { status, reason: str5(cond.reason) };
+    const status2 = str5(cond.status);
+    if (status2 !== "True" && status2 !== "False" && status2 !== "Unknown") continue;
+    return { status: status2, reason: str5(cond.reason) };
   }
   return void 0;
 }
@@ -17796,8 +17796,8 @@ function unhappyCondition(o, type) {
     for (const c of raw) {
       const cond = rec4(c);
       if (!cond || cond.type !== type) continue;
-      const status = str5(cond.status);
-      const unhappy = type === "ReplicaFailure" ? status === "True" : status === "False";
+      const status2 = str5(cond.status);
+      const unhappy = type === "ReplicaFailure" ? status2 === "True" : status2 === "False";
       if (!unhappy) continue;
       const reason = str5(cond.reason);
       const message2 = str5(cond.message);
@@ -23544,11 +23544,30 @@ var TerragucciProgress = class {
     p.catch(() => this.cached = void 0);
     return p;
   }
+  /**
+   * #569: one commit's run view, not the newest: the kiosk keeps the graph on
+   * the cycle its narration is about while the loop's next runs (the reset's
+   * push back to the base) already went. Cached like `answer`, per commit; the
+   * poll's watch stays on the newest.
+   */
+  answerFor(commit, fresh = false) {
+    const key = `${this.o.checkoutProject?.() ?? ""}\0${commit}`;
+    const at2 = Date.now();
+    const hit = this.pinned.get(key);
+    if (!fresh && hit && at2 - hit.at < PROGRESS_TTL_MS) return hit.answer;
+    for (const [k, v] of this.pinned) if (at2 - v.at >= PROGRESS_TTL_MS) this.pinned.delete(k);
+    const p = this.read(commit);
+    this.pinned.set(key, { at: at2, answer: p });
+    p.catch(() => this.pinned.delete(key));
+    return p;
+  }
+  pinned = /* @__PURE__ */ new Map();
   /** Drop the cached answer: the index changed, so the newest commit may have. */
   forget() {
     this.cached = void 0;
+    this.pinned.clear();
   }
-  async read() {
+  async read(commit) {
     const v = this.o.validators?.();
     const src = this.o.source;
     let text;
@@ -23569,13 +23588,13 @@ var TerragucciProgress = class {
     const rows = doc.reports;
     const checkout = this.o.checkoutProject?.();
     const project = pickProject(rows, { ...this.o.project ? { project: this.o.project } : {}, ...checkout ? { checkoutProject: checkout } : {} }, src);
-    const row = newestApply(rows, project);
+    const row = commit ? newestApply(rows.filter((r) => r.commit === commit || r.commit.startsWith(commit)), project) : newestApply(rows, project);
     if (!row) {
-      this.watch = void 0;
+      if (!commit) this.watch = void 0;
       return {
         ...this.base(project, v?.run.validation),
         run: null,
-        absent: `index.json lists no tf-apply run of ${project} yet, so there is no run view to read.`,
+        absent: commit ? `index.json lists no tf-apply run of ${project} on ${commit.slice(0, 12)} yet, so there is no run view of it to read.` : `index.json lists no tf-apply run of ${project} yet, so there is no run view to read.`,
         states: [],
         reads: [],
         waves: [],
@@ -23586,7 +23605,7 @@ var TerragucciProgress = class {
     }
     const key = runKey(row);
     const a = await this.readRun(project, row.commit, key, v?.run);
-    this.watch = { key, commit: row.commit, project, last: a };
+    if (!commit) this.watch = { key, commit: row.commit, project, last: a };
     return a;
   }
   base(project, validation) {
@@ -23677,7 +23696,14 @@ var TerragucciProgress = class {
 function terragucciProgressRoute(app, progress) {
   app.get("/api/terragucci/progress", async (c) => {
     try {
-      return c.json(await progress.answer(new URL(c.req.url).searchParams.get("fresh") === "1"));
+      const q = new URL(c.req.url).searchParams;
+      const fresh = q.get("fresh") === "1";
+      const commit = q.get("commit");
+      if (commit !== null) {
+        if (!/^[0-9a-f]{7,40}$/.test(commit)) return c.json({ error: "commit is a commit sha, 7 to 40 hex digits", code: "terragucci-progress" }, 400);
+        return c.json(await progress.answerFor(commit, fresh));
+      }
+      return c.json(await progress.answer(fresh));
     } catch (e) {
       if (e instanceof TerragucciReadError) return c.json(e.refusal, 422);
       if (e instanceof ProgressGraphError) return c.json({ error: e.message, code: "terragucci-graph", remedy: "`behold doctor` names what the Terraform read needs." }, 422);
@@ -23770,6 +23796,123 @@ function kioskRoute(app, webRoot2, enabled) {
   });
 }
 
+// src/terragucci-runs.ts
+var RUNS_INDEX_KEY = "runs/index.json";
+var runKey2 = (id) => `runs/${id}.json`;
+var RUNS_READ_TTL_MS = 2e3;
+var RUN_STATUSES = ["queued", "running", "waiting", "success", "failure", "cancelled", "skipped"];
+var isRecord18 = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+var str14 = (v) => typeof v === "string";
+var int2 = (v) => typeof v === "number" && Number.isInteger(v);
+var timeOrNull = (v) => v === null || v === void 0 || str14(v);
+var status = (v) => str14(v) && RUN_STATUSES.includes(v);
+function jobProblem(j, withSteps, at2) {
+  if (!isRecord18(j)) return `${at2} is not an object`;
+  if (!int2(j.id)) return `${at2}.id is not an integer`;
+  if (!str14(j.name)) return `${at2}.name is not a string`;
+  if (!Array.isArray(j.needs) || !j.needs.every(str14)) return `${at2}.needs is not a list of job names`;
+  if (!status(j.status)) return `${at2}.status is not one of ${RUN_STATUSES.join(", ")}`;
+  if (!timeOrNull(j.started_at) || !timeOrNull(j.ended_at)) return `${at2}'s times are neither times nor null`;
+  if (withSteps) {
+    if (!Array.isArray(j.steps)) return `${at2}.steps is not a list`;
+    for (const [i, s] of j.steps.entries()) {
+      const sat = `${at2}.steps[${i}]`;
+      if (!isRecord18(s)) return `${sat} is not an object`;
+      if (!str14(s.name)) return `${sat}.name is not a string`;
+      if (!str14(s.status)) return `${sat}.status is not a string`;
+      if (!Array.isArray(s.log) || !s.log.every(str14)) return `${sat}.log is not a list of lines`;
+      if (s.truncated !== void 0 && !int2(s.truncated)) return `${sat}.truncated is not an integer`;
+    }
+  }
+  return void 0;
+}
+function runProblem(r, withSteps, at2) {
+  if (!isRecord18(r)) return `${at2} is not an object`;
+  if (!int2(r.id)) return `${at2}.id is not an integer`;
+  if (!str14(r.title)) return `${at2}.title is not a string`;
+  if (!status(r.status)) return `${at2}.status is not one of ${RUN_STATUSES.join(", ")}`;
+  if (r.trigger !== null && r.trigger !== void 0 && !str14(r.trigger)) return `${at2}.trigger is not a string`;
+  if (!timeOrNull(r.created_at) || !timeOrNull(r.started_at) || !timeOrNull(r.ended_at)) return `${at2}'s times are neither times nor null`;
+  if (!Array.isArray(r.jobs)) return `${at2}.jobs is not a list`;
+  for (const [i, j] of r.jobs.entries()) {
+    const p = jobProblem(j, withSteps, `${at2}.jobs[${i}]`);
+    if (p) return p;
+  }
+  return void 0;
+}
+function runsIndexProblem(doc) {
+  if (!isRecord18(doc)) return "it is not an object";
+  if (doc.schema !== "demo.runs/v1") return `schema is ${JSON.stringify(doc.schema)}, not demo.runs/v1`;
+  if (!Array.isArray(doc.runs)) return "runs is not a list";
+  for (const [i, r] of doc.runs.entries()) {
+    const p = runProblem(r, false, `runs[${i}]`);
+    if (p) return p;
+  }
+  return void 0;
+}
+function runProblemOf(doc, id) {
+  if (!isRecord18(doc)) return "it is not an object";
+  if (doc.schema !== "demo.run/v1") return `schema is ${JSON.stringify(doc.schema)}, not demo.run/v1`;
+  if (doc.id !== id) return `its id is ${JSON.stringify(doc.id)}, not ${id}`;
+  return runProblem(doc, true, "the run");
+}
+async function readDoc2(source2, key, what, problem, now) {
+  const base = { source: source2.location, read: now.toISOString(), key };
+  let body;
+  try {
+    body = await source2.read(key);
+  } catch (e) {
+    if (e instanceof TerragucciDenied) return { ...base, doc: null, error: deniedWords(e, what), code: "terragucci-runs" };
+    return { ...base, doc: null, error: `behold could not read ${key} from ${source2.location}: ${e instanceof Error ? e.message : String(e)}`, code: "terragucci-runs" };
+  }
+  if (body === void 0) return { ...base, doc: null, absent: `${source2.location} has no ${key}: the demo's loop driver writes the pipeline runs there (terragucci's stack/demo.sh).` };
+  let doc;
+  try {
+    doc = JSON.parse(body);
+  } catch {
+    return { ...base, doc: null, error: `${key} in ${source2.location} is not JSON.`, code: "terragucci-runs" };
+  }
+  const p = problem(doc);
+  if (p) return { ...base, doc: null, error: `${key} in ${source2.location} is not the driver's format: ${p}.`, code: "terragucci-runs" };
+  return { ...base, doc };
+}
+function readRunsIndex(source2, now = /* @__PURE__ */ new Date()) {
+  return readDoc2(source2, RUNS_INDEX_KEY, "the demo's pipeline runs", runsIndexProblem, now);
+}
+function readRun(source2, id, now = /* @__PURE__ */ new Date()) {
+  return readDoc2(source2, runKey2(id), `pipeline run ${id}`, (d) => runProblemOf(d, id), now);
+}
+function runIdOf(raw) {
+  return /^[1-9][0-9]{0,15}$/.test(raw) ? Number(raw) : null;
+}
+function terragucciRunsRoutes(app, source2, opts = {}) {
+  const cache6 = /* @__PURE__ */ new Map();
+  const shared2 = (key, read) => {
+    const at2 = Date.now();
+    const hit = cache6.get(key);
+    if (hit && at2 - hit.at < RUNS_READ_TTL_MS) return hit.read;
+    for (const [k, v] of cache6) if (at2 - v.at >= RUNS_READ_TTL_MS) cache6.delete(k);
+    const p = read();
+    cache6.set(key, { at: at2, read: p });
+    return p;
+  };
+  const answer = (a) => {
+    const status2 = "error" in a ? 502 : "absent" in a ? 404 : 200;
+    return { body: a, status: status2 };
+  };
+  const now = () => opts.now ? opts.now() : /* @__PURE__ */ new Date();
+  app.get("/api/terragucci/runs", async (c) => {
+    const { body, status: status2 } = answer(await shared2(RUNS_INDEX_KEY, () => readRunsIndex(source2, now())));
+    return c.json(body, status2, { "cache-control": "no-store" });
+  });
+  app.get("/api/terragucci/runs/:id", async (c) => {
+    const id = runIdOf(c.req.param("id"));
+    if (id === null) return c.json({ error: "a run id is a positive integer", code: "terragucci-runs" }, 400);
+    const { body, status: status2 } = answer(await shared2(runKey2(id), () => readRun(source2, id, now())));
+    return c.json(body, status2, { "cache-control": "no-store" });
+  });
+}
+
 // src/terragucci-view.ts
 var TERRAGUCCI_READ_TTL_MS = 3e4;
 function repoBase(dirs) {
@@ -23890,6 +24033,8 @@ function terragucciRoutes(app, opts, dirs) {
     });
   });
   terragucciDemoRoute(app, source2, opts.now ? { now: opts.now } : {});
+  const runsSource = opts.runsSource ? terragucciSource(opts.runsSource, { ...opts.aws ? { aws: opts.aws } : {}, ...opts.fetch ? { fetch: opts.fetch } : {} }) : source2;
+  terragucciRunsRoutes(app, runsSource, opts.now ? { now: opts.now } : {});
   terragucciTimelineRoute(app, source2, {
     ...opts.project ? { project: opts.project } : {},
     checkoutProject: () => checkoutProject(repoBase(dirs())),
@@ -23954,7 +24099,7 @@ var heldByOf = (v) => {
   return h && typeof h === "object" && typeof h.hook === "string" && typeof h.moment === "string" ? { hook: h.hook, moment: h.moment, ...typeof h.target === "string" ? { target: h.target } : {} } : void 0;
 };
 var modeOf = (v) => v === "ledger" || v === "pr-review" || v === "sealed" ? v : void 0;
-var str14 = (v) => typeof v === "string" && v !== "" ? v : void 0;
+var str15 = (v) => typeof v === "string" && v !== "" ? v : void 0;
 var strings3 = (v) => Array.isArray(v) ? v.filter((x) => typeof x === "string") : void 0;
 var time3 = (iso) => Date.parse(iso) || 0;
 function rowOf(line) {
@@ -23970,14 +24115,14 @@ function rowOf(line) {
 }
 function sealOf(r) {
   const s = r.seal;
-  const signed = s && s.signature ? { sealed: true, ...str14(s.signer) ? { signer: str14(s.signer) } : {} } : void 0;
+  const signed = s && s.signature ? { sealed: true, ...str15(s.signer) ? { signer: str15(s.signer) } : {} } : void 0;
   if (r.review || r.via === "pr-review") return { seal: "review", ...signed };
   return signed ? { seal: "sealed", ...signed } : { seal: "unsigned" };
 }
 function reviewOf(r) {
   const rv = r.review ?? void 0;
   const pr = typeof rv?.pr === "number" ? rv.pr : typeof r.pr === "number" ? r.pr : void 0;
-  const head = str14(rv?.head) ?? str14(r.head);
+  const head = str15(rv?.head) ?? str15(r.head);
   const approvers = strings3(rv?.approvers) ?? strings3(r.reviewers);
   if (pr === void 0 && head === void 0 && approvers === void 0) return void 0;
   return { ...pr !== void 0 ? { pr } : {}, ...head ? { head } : {}, ...approvers ? { approvers } : {} };
@@ -24003,7 +24148,7 @@ function decisionOf(d) {
   const r = v;
   if (!r || typeof r !== "object" || typeof r.wave !== "number" || typeof r.name !== "string" || typeof r.op !== "string" || typeof r.gate !== "string") return void 0;
   const outcomes2 = Array.isArray(r.outcomes) ? r.outcomes.filter((o) => !!o && typeof o === "object" && typeof o.moment === "string" && typeof o.name === "string" && typeof o.exit === "number" && typeof o.outcome === "string") : void 0;
-  return { wave: r.wave, name: r.name, op: r.op, gate: r.gate, ...str14(r.digest) ? { digest: str14(r.digest) } : {}, ...strings3(r.heldBy) ? { heldBy: strings3(r.heldBy) } : {}, ...r.heldOn !== void 0 ? { heldOn: r.heldOn } : {}, ...outcomes2 ? { outcomes: outcomes2 } : {} };
+  return { wave: r.wave, name: r.name, op: r.op, gate: r.gate, ...str15(r.digest) ? { digest: str15(r.digest) } : {}, ...strings3(r.heldBy) ? { heldBy: strings3(r.heldBy) } : {}, ...r.heldOn !== void 0 ? { heldOn: r.heldOn } : {}, ...outcomes2 ? { outcomes: outcomes2 } : {} };
 }
 function deriveGateAudit(input) {
   const isOverride = input.isOverride ?? isOverrideGate2;
@@ -24028,17 +24173,17 @@ function deriveGateAudit(input) {
     const requests = [];
     for (const p of parsed) {
       if (!p.pending || p.line.removed) continue;
-      const digest = str14(p.r.planDigest);
+      const digest = str15(p.r.planDigest);
       denials.set(`${String(p.r.gate)}
 ${digest ?? ""}`, p.r);
-      requests.push({ op: ledger.op, gate: String(p.r.gate), at: time3(String(p.r.timestamp)), ...digest ? { digest } : {}, ...str14(p.r.environment) ? { environment: str14(p.r.environment) } : {} });
+      requests.push({ op: ledger.op, gate: String(p.r.gate), at: time3(String(p.r.timestamp)), ...digest ? { digest } : {}, ...str15(p.r.environment) ? { environment: str15(p.r.environment) } : {} });
     }
     for (const { line, n, r, pending } of parsed) {
       const gate = String(r.gate);
       const override = isOverride(ledger.op, gate);
       const removed = line.removed;
       if (pending && removed) continue;
-      const digest = str14(r.planDigest);
+      const digest = str15(r.planDigest);
       const author = removed ?? line.added;
       const source2 = {
         path,
@@ -24057,7 +24202,7 @@ ${digest ?? ""}`, p.r);
           ...base,
           kind: override ? "override-requested" : "approval-requested",
           at: String(r.timestamp),
-          ...drop({ runId: str14(r.runId), expiresAt: str14(r.expiresAt), description: str14(r.description), url: str14(r.url), rules: strings3(r.rules), wave: waveOf(r.wave), heldBy: heldByOf(r.heldBy), approvalMode: modeOf(r.approvalMode) }),
+          ...drop({ runId: str15(r.runId), expiresAt: str15(r.expiresAt), description: str15(r.description), url: str15(r.url), rules: strings3(r.rules), wave: waveOf(r.wave), heldBy: heldByOf(r.heldBy), approvalMode: modeOf(r.approvalMode) }),
           detail: extra2
         }));
         continue;
@@ -24085,13 +24230,13 @@ ${digest ?? ""}`) : void 0;
         at: String(r.timestamp),
         by: String(r.resolvedBy),
         seal,
-        ...drop({ sealed, signer, committedBy: line.added?.by, relayedBy: str14(r.relayedBy), approver: approverOf(r), note: str14(r.note), url: str14(r.url), review: reviewOf(r), rules }),
+        ...drop({ sealed, signer, committedBy: line.added?.by, relayedBy: str15(r.relayedBy), approver: approverOf(r), note: str15(r.note), url: str15(r.url), review: reviewOf(r), rules }),
         detail: extra2
       });
       entries.push(entry);
       if (!override) {
         const at2 = time3(entry.at);
-        const env = str14(r.environment);
+        const env = str15(r.environment);
         const asked = requests.some((q) => q.gate === gate && q.at <= at2 && compatible(q.digest, digest) && (q.environment === void 0 || env === void 0 || q.environment === env));
         if (!asked) {
           gaps.push({ kind: "approval-without-request", op: ledger.op, gate, ...digest ? { digest } : {}, detail: `${path} holds an approval of ${gate} by ${entry.by} at ${entry.at} with no pending fact of that gate${digest ? " and digest" : ""} before it` });
@@ -24838,21 +24983,21 @@ function controlRepo(dirs, roots = () => checkoutRoots(dirs).length) {
   }
   return n === 0 ? { config, projects } : void 0;
 }
-var isRecord18 = (v) => v !== null && typeof v === "object" && !Array.isArray(v);
-var str15 = (v) => typeof v === "string";
-var int2 = (v) => typeof v === "number" && Number.isInteger(v);
+var isRecord19 = (v) => v !== null && typeof v === "object" && !Array.isArray(v);
+var str16 = (v) => typeof v === "string";
+var int3 = (v) => typeof v === "number" && Number.isInteger(v);
 function structuralRun2(doc) {
-  if (!isRecord18(doc)) return "it is not a JSON object";
+  if (!isRecord19(doc)) return "it is not a JSON object";
   if (doc.schema !== RUN_SCHEMA2) return `its schema is ${JSON.stringify(doc.schema)}, not ${RUN_SCHEMA2}`;
-  if (!str15(doc.project) || !str15(doc.commit) || !str15(doc.updated)) return "it lacks project, commit or updated";
+  if (!str16(doc.project) || !str16(doc.commit) || !str16(doc.updated)) return "it lacks project, commit or updated";
   if (!Array.isArray(doc.roots) || !Array.isArray(doc.waves)) return "it has no roots or waves array";
   for (const [i, r] of doc.roots.entries()) {
-    if (!isRecord18(r) || !str15(r.root) || !int2(r.wave) || !Array.isArray(r.reads) || !r.reads.every(str15)) return `root ${i} lacks root, wave or reads`;
-    if (r.state !== void 0 && !(isRecord18(r.state) && str15(r.state.key))) return `root ${String(r.root)}'s state has no key`;
-    if (r.external !== void 0 && !(Array.isArray(r.external) && r.external.every((x) => isRecord18(x) && str15(x.data) && str15(x.key)))) return `root ${String(r.root)}'s external reads lack data or key`;
+    if (!isRecord19(r) || !str16(r.root) || !int3(r.wave) || !Array.isArray(r.reads) || !r.reads.every(str16)) return `root ${i} lacks root, wave or reads`;
+    if (r.state !== void 0 && !(isRecord19(r.state) && str16(r.state.key))) return `root ${String(r.root)}'s state has no key`;
+    if (r.external !== void 0 && !(Array.isArray(r.external) && r.external.every((x) => isRecord19(x) && str16(x.data) && str16(x.key)))) return `root ${String(r.root)}'s external reads lack data or key`;
   }
   for (const [i, w] of doc.waves.entries()) {
-    if (!isRecord18(w) || !int2(w.number) || !Array.isArray(w.roots) || !Array.isArray(w.reads) || !str15(w.state) || !str15(w.gate)) return `wave ${i} lacks number, roots, reads, state or gate`;
+    if (!isRecord19(w) || !int3(w.number) || !Array.isArray(w.roots) || !Array.isArray(w.reads) || !str16(w.state) || !str16(w.gate)) return `wave ${i} lacks number, roots, reads, state or gate`;
   }
   return void 0;
 }
@@ -24884,7 +25029,7 @@ function runViewValidator(dirs = []) {
       v = {
         validation: { by: "schema", terragucci: version },
         check(doc) {
-          const id = isRecord18(doc) ? doc.schema : void 0;
+          const id = isRecord19(doc) ? doc.schema : void 0;
           if (id !== RUN_SCHEMA2) return `its schema is ${JSON.stringify(id)}, not ${RUN_SCHEMA2}`;
           if (validate(doc)) return void 0;
           const e = validate.errors?.[0];
@@ -24905,7 +25050,7 @@ var refuse13 = (error, remedy) => {
   throw new TerragucciReadError(refusal(error, remedy));
 };
 var trimSlashes = (s) => s.replace(/^\/+|\/+$/g, "");
-function runKey2(p, commit) {
+function runKey3(p, commit) {
   const page = p.run_view?.commit === commit ? p.run_view.page : void 0;
   if (page && !/^[a-z]+:\/\//i.test(page) && !page.startsWith("/") && !page.split("/").includes("..") && page.endsWith("/run.html")) {
     return `${trimSlashes(page.slice(0, -"run.html".length))}/run.json`;
@@ -24986,7 +25131,7 @@ async function readControlEstate(source2, config, opts = {}) {
     if (!commit) {
       missing = p.status === "ok" ? "no apply has run, so there is no run view" : p.status === "no-index" ? "no runs in the bucket yet" : `its index could not be read${p.error ? `: ${p.error}` : ""}`;
     } else {
-      const key = runKey2(p, commit);
+      const key = runKey3(p, commit);
       let body;
       try {
         body = await get(key);
@@ -25607,9 +25752,9 @@ function yodelValidator(dirs = []) {
   pinned ??= compile({ common: common_schema_default, report: report_schema_default, drift: drift_schema_default }, { by: "schema", from: "pinned", commit: PINNED_COMMIT.slice(0, 7) });
   return pinned;
 }
-var isRecord19 = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
-var looksLikeReport = (d) => isRecord19(d) && "generatedAt" in d && "environments" in d;
-var looksLikeDrift = (d) => isRecord19(d) && "environment" in d && ("drifted" in d || "changed" in d);
+var isRecord20 = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+var looksLikeReport = (d) => isRecord20(d) && "generatedAt" in d && "environments" in d;
+var looksLikeDrift = (d) => isRecord20(d) && "environment" in d && ("drifted" in d || "changed" in d);
 function filesOf(source2) {
   let st;
   try {
@@ -25719,7 +25864,7 @@ function yodelReportRoute(app, source2, dirs) {
 init_terraform_member();
 import { existsSync as existsSync25, lstatSync as lstatSync2, mkdirSync as mkdirSync7, readFileSync as readFileSync32, readlinkSync as readlinkSync2, symlinkSync as symlinkSync2, writeFileSync as writeFileSync6 } from "node:fs";
 import { dirname as dirname16, join as join44, resolve as resolve28 } from "node:path";
-var isRecord20 = (v) => v !== null && typeof v === "object" && !Array.isArray(v);
+var isRecord21 = (v) => v !== null && typeof v === "object" && !Array.isArray(v);
 function linkDemoPins(work, probes = {}) {
   const file = join44(work, "chant.workspace.json");
   if (!existsSync25(file)) return { ok: true, linked: [] };
@@ -25729,12 +25874,12 @@ function linkDemoPins(work, probes = {}) {
   } catch {
     return { ok: true, linked: [] };
   }
-  if (!isRecord20(decl) || !Array.isArray(decl.pins)) return { ok: true, linked: [] };
+  if (!isRecord21(decl) || !Array.isArray(decl.pins)) return { ok: true, linked: [] };
   const find = probes.resolve ?? ((pkg) => resolvedPackage(pkg));
   const linked = [];
   let rewrite = false;
   for (const pin of decl.pins) {
-    if (!isRecord20(pin) || typeof pin.package !== "string") continue;
+    if (!isRecord21(pin) || typeof pin.package !== "string") continue;
     const pkg = pin.package;
     if (pkg === TERRAFORM_LEXICON_PKG) {
       const refusal2 = (probes.reader ?? terraformReaderState)().refusal;
@@ -28328,11 +28473,11 @@ async function runExport(cfg, outDir, opts = {}) {
 `
   );
 }
-var isRecord21 = (v) => v !== null && typeof v === "object" && !Array.isArray(v);
+var isRecord22 = (v) => v !== null && typeof v === "object" && !Array.isArray(v);
 function dropSource(v) {
   if (Array.isArray(v)) return v.forEach(dropSource);
-  if (!isRecord21(v)) return;
-  if (isRecord21(v.attrs)) delete v.attrs.source;
+  if (!isRecord22(v)) return;
+  if (isRecord22(v.attrs)) delete v.attrs.source;
   for (const x of Object.values(v)) dropSource(x);
 }
 function shapeSnapshot(key, body, opts = {}) {
@@ -28342,7 +28487,7 @@ function shapeSnapshot(key, body, opts = {}) {
   } catch {
     return body;
   }
-  if (!isRecord21(doc)) return body;
+  if (!isRecord22(doc)) return body;
   if (key === "/api/project") {
     delete doc.recents;
     delete doc.approver;
@@ -28412,7 +28557,7 @@ function manifestFiles(text) {
   } catch {
     return [];
   }
-  const map = isRecord21(doc) && isRecord21(doc.keyToFile) ? doc.keyToFile : {};
+  const map = isRecord22(doc) && isRecord22(doc.keyToFile) ? doc.keyToFile : {};
   return Object.values(map).filter((f) => typeof f === "string" && /^snapshots\/[A-Za-z0-9=_.-]+$/.test(f) && !f.includes(".."));
 }
 function bundleFiles(outDir) {
@@ -28510,12 +28655,12 @@ function resolveCommit2(dir, given) {
     return { sha };
   }
 }
-var isRecord22 = (v) => v !== null && typeof v === "object" && !Array.isArray(v);
+var isRecord23 = (v) => v !== null && typeof v === "object" && !Array.isArray(v);
 function parseHistory(text) {
   const doc = JSON.parse(text);
   if (!Array.isArray(doc)) throw new Error("history.json is not an array");
-  const str16 = (v) => typeof v === "string" ? v : "";
-  return doc.filter((e) => isRecord22(e) && typeof e.commit === "string" && COMMIT.test(e.commit)).map((e) => ({ commit: e.commit, at: str16(e.at), project: str16(e.project), generated: str16(e.generated) }));
+  const str17 = (v) => typeof v === "string" ? v : "";
+  return doc.filter((e) => isRecord23(e) && typeof e.commit === "string" && COMMIT.test(e.commit)).map((e) => ({ commit: e.commit, at: str17(e.at), project: str17(e.project), generated: str17(e.generated) }));
 }
 function nextHistory(old, entry, keep) {
   const all = [entry, ...old.filter((e) => e.commit !== entry.commit)];
@@ -28527,9 +28672,9 @@ var BUNDLE_PATH = /^[A-Za-z0-9=_.@+-]+(\/[A-Za-z0-9=_.@+-]+)*$/;
 var insideBundle = (f) => typeof f === "string" && BUNDLE_PATH.test(f) && !f.split("/").some((p) => p === "." || p === "..");
 function commitFiles(manifestText) {
   const doc = JSON.parse(manifestText);
-  if (!isRecord22(doc)) return ["manifest.json"];
+  if (!isRecord23(doc)) return ["manifest.json"];
   const listed = Array.isArray(doc.files) ? doc.files.filter(insideBundle) : [];
-  const snaps = isRecord22(doc.keyToFile) ? Object.values(doc.keyToFile).filter(insideBundle) : [];
+  const snaps = isRecord23(doc.keyToFile) ? Object.values(doc.keyToFile).filter(insideBundle) : [];
   const rest = [.../* @__PURE__ */ new Set([...listed, ...snaps])].filter((f) => f !== "index.html" && f !== "manifest.json").sort();
   return ["index.html", ...rest, "manifest.json"];
 }
@@ -28641,7 +28786,7 @@ Usage:
                 [--yodel-report <file|dir>]
                 [--publish s3://<bucket>/<prefix>/views/<name> [--commit <sha>] [--keep <n>]]
   behold serve <project-dir\u2026> [--port <n>] [--host <addr>] [--allow-host <name,\u2026>] [--hud <url>] [--env <name>] [--poll <secs>] [--local]
-                [--public] [--terragucci <src> [--terragucci-project <p>] [--terragucci-poll <secs>]]
+                [--public] [--terragucci <src> [--terragucci-project <p>] [--terragucci-poll <secs>] [--terragucci-runs <src>]]
                 [--yodel-report <file|dir>]
   behold carve <report.json> [--port <n>]
 
@@ -28742,6 +28887,11 @@ Options:
                       moved to the page.
                       0 turns it off. The fetch goes into behold's own cache
                       (<tmpdir>/behold-lifecycle-*), never into the checkout.
+  --terragucci-runs <src>
+                      serve with --terragucci only: where /kiosk reads the
+                      demo's pipeline runs (runs/index.json, runs/<id>.json),
+                      when not beside the reports: a directory, s3:// or
+                      http(s), as --terragucci takes.
   --yodel-report <file|dir>
                       serve/export: mark SQL Yodeler's \`yodel report --json\`
                       output and any \`yodel drift <env> --json\` beside it
@@ -28859,6 +29009,7 @@ ${USAGE}`);
   let terragucci;
   let terragucciProject;
   let terragucciPoll;
+  let terragucciRuns;
   let yodelReport;
   let isPublic = false;
   const allowHosts = [];
@@ -28871,6 +29022,7 @@ ${USAGE}`);
     else if (a === "--terragucci") terragucci = rest[++i];
     else if (a === "--terragucci-project") terragucciProject = rest[++i];
     else if (a === "--terragucci-poll") terragucciPoll = Number(rest[++i]);
+    else if (a === "--terragucci-runs") terragucciRuns = rest[++i];
     else if (a === "--yodel-report") yodelReport = rest[++i];
     else if (a === "--env") env = rest[++i];
     else if (a === "--poll") pollSecs = Number(rest[++i]);
@@ -28935,6 +29087,10 @@ ${USAGE}`);
     process.stderr.write("behold serve: --terragucci-poll needs --terragucci\n");
     process.exit(2);
   }
+  if (terragucciRuns !== void 0 && terragucci === void 0) {
+    process.stderr.write("behold serve: --terragucci-runs needs --terragucci\n");
+    process.exit(2);
+  }
   if (isPublic && projectDirs.length > 1) {
     process.stderr.write("behold serve: --public serves one project directory\n");
     process.exit(2);
@@ -28970,7 +29126,7 @@ ${USAGE}`);
     ...isPublic ? { public: true, layoutWrites: false } : {},
     ...target.workspace && hud ? { hud } : {},
     ...yodelReport ? { yodelReport: resolve33(yodelReport) } : {},
-    ...terragucci ? { terragucci: { source: terragucci, ...terragucciProject ? { project: terragucciProject } : {}, ...terragucciPoll !== void 0 ? { pollSecs: terragucciPoll } : {} } } : {}
+    ...terragucci ? { terragucci: { source: terragucci, ...terragucciProject ? { project: terragucciProject } : {}, ...terragucciPoll !== void 0 ? { pollSecs: terragucciPoll } : {}, ...terragucciRuns ? { runsSource: terragucciRuns } : {} } } : {}
   });
 }
 var PUBLIC_TERRAGUCCI_POLL_SECS = 10;