executable-stories-react 0.2.1 → 0.4.0

package/dist/interactive.js

@@ -6,7 +6,7 @@ import {
   useDeferredValue,
   useMemo as useMemo3,
   useRef as useRef3,
-  useState as useState4
+  useState as useState5
 } from "react";
 
 // src/result.ts
@@ -58,11 +58,23 @@ function useReport() {
   return ctx.report;
 }
 
-// src/components/ReportScenario.tsx
-import { formatDuration as formatDuration3 } from "executable-stories-core/utils/duration";
-
-// src/components/ReportSteps.tsx
-import { formatDuration } from "executable-stories-core/utils/duration";
+// ../executable-stories-core/dist/utils/duration.js
+function formatDuration(ms) {
+  if (ms < 1e3) {
+    return `${Math.round(ms)} ms`;
+  }
+  if (ms < 6e4) {
+    return `${(ms / 1e3).toFixed(2)} s`;
+  }
+  const minutes = Math.floor(ms / 6e4);
+  const seconds = Math.floor(ms % 6e4 / 1e3);
+  if (minutes < 60) {
+    return seconds > 0 ? `${minutes}m ${seconds}s` : `${minutes}m`;
+  }
+  const hours = Math.floor(minutes / 60);
+  const remainingMinutes = minutes % 60;
+  return `${hours}h ${remainingMinutes}m`;
+}
 
 // src/components/doc/DocNote.tsx
 import { jsx as jsx2 } from "react/jsx-runtime";
@@ -246,7 +258,7 @@ function DocSection({ entry }) {
     /* @__PURE__ */ jsx8(
       "div",
       {
-        className: "es-doc-prose text-muted-foreground",
+        className: "es-doc-prose prose prose-sm max-w-none",
         dangerouslySetInnerHTML: { __html: html }
       }
     )
@@ -545,9 +557,6 @@ function ReportAttachments({ attachments }) {
   );
 }
 
-// src/components/ReportTrace.tsx
-import { formatDuration as formatDuration2 } from "executable-stories-core/utils/duration";
-
 // src/lib/trace.ts
 var VALID = /* @__PURE__ */ new Set(["ok", "error", "unset"]);
 var safeStatus = (s) => VALID.has(s) ? s : "unset";
@@ -642,7 +651,7 @@ function ReportTrace({ spans }) {
       " span",
       rows.length === 1 ? "" : "s",
       ", ",
-      formatDuration2(totalMs),
+      formatDuration(totalMs),
       ")"
     ] }),
     /* @__PURE__ */ jsx19("ul", { className: "flex flex-col gap-0.5 px-3 pb-3 font-mono text-[0.6875rem]", children: rows.map((row, i) => {
@@ -665,18 +674,131 @@ function ReportTrace({ spans }) {
             style: { left: `${leftPct}%`, width: `${widthPct}%` }
           }
         ) }),
-        /* @__PURE__ */ jsx19("span", { className: "w-16 shrink-0 text-right text-muted-foreground", children: formatDuration2(row.durationMs) })
+        /* @__PURE__ */ jsx19("span", { className: "w-16 shrink-0 text-right text-muted-foreground", children: formatDuration(row.durationMs) })
       ] }, `${row.spanId}-${i}`);
     }) })
   ] });
 }
 
+// src/interactive/scenario-history-context.ts
+import { createContext as createContext2, useContext as useContext3 } from "react";
+var ScenarioHistoryContext = createContext2(null);
+var ScenarioHistoryProvider = ScenarioHistoryContext.Provider;
+function useScenarioHistory() {
+  return useContext3(ScenarioHistoryContext);
+}
+
+// src/lib/run-history.ts
+function currentStreak(entries) {
+  const last = entries[entries.length - 1];
+  if (!last) return void 0;
+  let count = 0;
+  for (let i = entries.length - 1; i >= 0 && entries[i].status === last.status; i--) count++;
+  return { status: last.status, count };
+}
+var STREAK_VERB = {
+  passed: "Passing",
+  failed: "Failing",
+  skipped: "Skipped",
+  pending: "Pending"
+};
+function describeRunHistory(entries) {
+  const passed = entries.filter((e) => e.status === "passed").length;
+  const base = `${passed}/${entries.length} runs passed`;
+  const streak = currentStreak(entries);
+  if (!streak || entries.length < 2) return base;
+  return `${base} \xB7 ${STREAK_VERB[streak.status]} for the last ${streak.count === 1 ? "run" : `${streak.count} runs`}`;
+}
+var MIN_FLAKINESS_SAMPLES = 3;
+function flakinessOf(entries) {
+  const countable = entries.filter((e) => e.status === "passed" || e.status === "failed");
+  if (countable.length < MIN_FLAKINESS_SAMPLES) return "stable";
+  let transitions = 0;
+  for (let i = 1; i < countable.length; i++) {
+    if (countable[i].status !== countable[i - 1].status) transitions++;
+  }
+  const transitionScore = transitions / (countable.length - 1);
+  const failureRate = countable.filter((e) => e.status === "failed").length / countable.length;
+  if (transitionScore > 0.5 || transitionScore > 0.3 && failureRate > 0.2) return "flaky";
+  if (transitionScore > 0.2 || failureRate > 0.3) return "unstable";
+  return "stable";
+}
+function diffSinceLastRun(history2, scenarios) {
+  let hasPreviousRun = false;
+  const delta = { newlyFailing: [], newlyPassing: [], added: [] };
+  for (const scenario of scenarios) {
+    const entries = history2[scenario.id];
+    if (!entries || entries.length === 0) continue;
+    const last = entries[entries.length - 1];
+    const prev = entries[entries.length - 2];
+    if (!prev) {
+      delta.added.push(scenario);
+      continue;
+    }
+    hasPreviousRun = true;
+    if (last.status === "failed" && prev.status !== "failed") delta.newlyFailing.push(scenario);
+    else if (last.status === "passed" && prev.status === "failed") delta.newlyPassing.push(scenario);
+  }
+  return hasPreviousRun ? delta : void 0;
+}
+
+// src/components/ScenarioRunHistory.tsx
+import { Fragment as Fragment7, jsx as jsx20, jsxs as jsxs13 } from "react/jsx-runtime";
+var MAX_DOTS = 10;
+var DOT_COLOR = {
+  passed: "bg-pass",
+  failed: "bg-fail",
+  skipped: "bg-skip",
+  pending: "bg-pend"
+};
+function dotTitle(e) {
+  const parts = [new Date(e.timestamp).toLocaleString(), e.status];
+  if (e.commitSha) parts.push(e.commitSha.slice(0, 8));
+  return parts.join(" \xB7 ");
+}
+function ScenarioRunHistory({ scenarioId }) {
+  const history2 = useScenarioHistory();
+  const entries = history2?.[scenarioId];
+  if (!entries || entries.length < 2) return null;
+  const recent = entries.slice(-MAX_DOTS);
+  const flaky = flakinessOf(recent) === "flaky";
+  const summary = flaky ? `${describeRunHistory(recent)} \xB7 Flaky` : describeRunHistory(recent);
+  return /* @__PURE__ */ jsxs13(Fragment7, { children: [
+    flaky ? /* @__PURE__ */ jsx20(Badge, { variant: "pending", "aria-label": "Flaky: status flips between recent runs", title: summary, children: "Flaky" }) : null,
+    /* @__PURE__ */ jsx20(
+      "span",
+      {
+        role: "img",
+        "aria-label": `Run history: ${summary}`,
+        title: summary,
+        className: "flex shrink-0 items-center gap-[3px]",
+        children: recent.map((e, i) => /* @__PURE__ */ jsx20(
+          "span",
+          {
+            "aria-hidden": true,
+            title: dotTitle(e),
+            className: cn(
+              "inline-block size-1.5 rounded-full",
+              DOT_COLOR[e.status],
+              // The newest run (rightmost dot) is the one the card's status
+              // badge already describes; ring it so the timeline reads as
+              // "…leading up to now".
+              i === recent.length - 1 && "ring-1 ring-border ring-offset-1 ring-offset-card"
+            )
+          },
+          `${e.timestamp}-${i}`
+        ))
+      }
+    )
+  ] });
+}
+
 // src/interactive/collapse-context.ts
-import { createContext as createContext2, useCallback, useContext as useContext3, useState } from "react";
-var CollapseContext = createContext2(null);
+import { createContext as createContext3, useCallback, useContext as useContext4, useState } from "react";
+var CollapseContext = createContext3(null);
 var CollapseProvider = CollapseContext.Provider;
 function useCollapse() {
-  return useContext3(CollapseContext);
+  return useContext4(CollapseContext);
 }
 var STORAGE_KEY = "es-collapsed-ids";
 function readPersisted() {
@@ -725,11 +847,11 @@ function useCollapseState() {
 }
 
 // src/interactive/scenario-actions.tsx
-import { createContext as createContext3, useContext as useContext4 } from "react";
-var ScenarioActionsContext = createContext3(null);
+import { createContext as createContext4, useContext as useContext5 } from "react";
+var ScenarioActionsContext = createContext4(null);
 var ScenarioActionsProvider = ScenarioActionsContext.Provider;
 function useScenarioActions() {
-  return useContext4(ScenarioActionsContext);
+  return useContext5(ScenarioActionsContext);
 }
 function scenarioToMarkdown(scenario) {
   const lines = [`## ${scenario.title} _(${scenario.status})_`, ""];
@@ -767,9 +889,9 @@ function scenarioPermalink(scenario) {
 
 // src/components/ui/card.tsx
 import "react";
-import { jsx as jsx20 } from "react/jsx-runtime";
+import { jsx as jsx21 } from "react/jsx-runtime";
 function Card({ className, ...props }) {
-  return /* @__PURE__ */ jsx20(
+  return /* @__PURE__ */ jsx21(
     "div",
     {
       "data-slot": "card",
@@ -782,7 +904,7 @@ function Card({ className, ...props }) {
   );
 }
 function CardHeader({ className, ...props }) {
-  return /* @__PURE__ */ jsx20(
+  return /* @__PURE__ */ jsx21(
     "div",
     {
       "data-slot": "card-header",
@@ -795,7 +917,7 @@ function CardHeader({ className, ...props }) {
   );
 }
 function CardContent({ className, ...props }) {
-  return /* @__PURE__ */ jsx20(
+  return /* @__PURE__ */ jsx21(
     "div",
     {
       "data-slot": "card-content",
@@ -806,7 +928,7 @@ function CardContent({ className, ...props }) {
 }
 
 // src/components/ReportScenario.tsx
-import { jsx as jsx21, jsxs as jsxs13 } from "react/jsx-runtime";
+import { jsx as jsx22, jsxs as jsxs14 } from "react/jsx-runtime";
 var STATUS_LABEL = {
   passed: "Passed",
   failed: "Failed",
@@ -834,12 +956,12 @@ var STATUS_BADGE = {
 function ReportScenario({ scenario, hideTitle = false }) {
   const titleId = `${scenario.id}-title`;
   const bodyId = `${scenario.id}-body`;
-  const label = STATUS_LABEL[scenario.status];
+  const label = scenario.planned ? "Planned" : STATUS_LABEL[scenario.status];
   const collapse = useCollapse();
   const collapsible = collapse !== null && !hideTitle;
   const collapsed = collapsible ? collapse.isCollapsed(scenario.id) : false;
   const actions = useScenarioActions();
-  return /* @__PURE__ */ jsxs13(
+  return /* @__PURE__ */ jsxs14(
     Card,
     {
       id: scenario.id,
@@ -847,10 +969,10 @@ function ReportScenario({ scenario, hideTitle = false }) {
       ...hideTitle ? { "aria-label": `${scenario.title} \u2014 ${label}` } : { "aria-labelledby": titleId },
       className: "gap-0 py-0",
       children: [
-        /* @__PURE__ */ jsxs13(CardHeader, { className: "px-4 py-3", children: [
-          /* @__PURE__ */ jsxs13("div", { className: cn("flex items-start gap-4", hideTitle ? "justify-end" : "justify-between"), children: [
-            hideTitle ? null : /* @__PURE__ */ jsxs13("h3", { id: titleId, className: "flex items-center gap-2 text-sm font-medium text-foreground", children: [
-              collapsible ? /* @__PURE__ */ jsx21(
+        /* @__PURE__ */ jsxs14(CardHeader, { className: "px-4 py-3", children: [
+          /* @__PURE__ */ jsxs14("div", { className: cn("flex items-start gap-4", hideTitle ? "justify-end" : "justify-between"), children: [
+            hideTitle ? null : /* @__PURE__ */ jsxs14("h3", { id: titleId, className: "flex items-center gap-2 text-sm font-medium text-foreground", children: [
+              collapsible ? /* @__PURE__ */ jsx22(
                 "button",
                 {
                   type: "button",
@@ -859,17 +981,18 @@ function ReportScenario({ scenario, hideTitle = false }) {
                   "aria-controls": bodyId,
                   "aria-label": `Toggle ${scenario.title}`,
                   className: "shrink-0 cursor-pointer text-muted-foreground hover:text-foreground",
-                  children: /* @__PURE__ */ jsx21("span", { "aria-hidden": true, className: cn("inline-block text-xs transition-transform", !collapsed && "rotate-90"), children: "\u25B8" })
+                  children: /* @__PURE__ */ jsx22("span", { "aria-hidden": true, className: cn("inline-block text-xs transition-transform", !collapsed && "rotate-90"), children: "\u25B8" })
                 }
               ) : null,
-              /* @__PURE__ */ jsx21("span", { "aria-hidden": true, className: cn("text-sm leading-none", STATUS_GLYPH_COLOR[scenario.status]), children: STATUS_GLYPH[scenario.status] }),
-              /* @__PURE__ */ jsx21("span", { children: scenario.title })
+              /* @__PURE__ */ jsx22("span", { "aria-hidden": true, className: cn("text-sm leading-none", STATUS_GLYPH_COLOR[scenario.status]), children: STATUS_GLYPH[scenario.status] }),
+              /* @__PURE__ */ jsx22("span", { children: scenario.title })
             ] }),
-            /* @__PURE__ */ jsxs13("div", { className: "flex shrink-0 items-center gap-2", children: [
-              scenario.durationMs > 0 ? /* @__PURE__ */ jsx21("span", { className: "whitespace-nowrap font-mono text-[0.6875rem] text-muted-foreground", children: formatDuration3(scenario.durationMs) }) : null,
-              /* @__PURE__ */ jsx21(Badge, { variant: STATUS_BADGE[scenario.status], "aria-label": `Status: ${label}`, children: label }),
-              actions ? /* @__PURE__ */ jsxs13("div", { className: "flex items-center gap-0.5", children: [
-                /* @__PURE__ */ jsx21(
+            /* @__PURE__ */ jsxs14("div", { className: "flex shrink-0 items-center gap-2", children: [
+              /* @__PURE__ */ jsx22(ScenarioRunHistory, { scenarioId: scenario.id }),
+              scenario.durationMs > 0 ? /* @__PURE__ */ jsx22("span", { className: "whitespace-nowrap font-mono text-[0.6875rem] text-muted-foreground", children: formatDuration(scenario.durationMs) }) : null,
+              /* @__PURE__ */ jsx22(Badge, { variant: STATUS_BADGE[scenario.status], "aria-label": `Status: ${label}`, children: label }),
+              actions ? /* @__PURE__ */ jsxs14("div", { className: "flex items-center gap-0.5", children: [
+                /* @__PURE__ */ jsx22(
                   "button",
                   {
                     type: "button",
@@ -880,7 +1003,7 @@ function ReportScenario({ scenario, hideTitle = false }) {
                     children: "link"
                   }
                 ),
-                /* @__PURE__ */ jsx21(
+                /* @__PURE__ */ jsx22(
                   "button",
                   {
                     type: "button",
@@ -891,7 +1014,7 @@ function ReportScenario({ scenario, hideTitle = false }) {
                     children: "md"
                   }
                 ),
-                /* @__PURE__ */ jsx21(
+                /* @__PURE__ */ jsx22(
                   "button",
                   {
                     type: "button",
@@ -905,13 +1028,13 @@ function ReportScenario({ scenario, hideTitle = false }) {
               ] }) : null
             ] })
           ] }),
-          scenario.tags.length > 0 || (scenario.tickets?.length ?? 0) > 0 ? /* @__PURE__ */ jsxs13("ul", { "aria-label": "Tags and tickets", className: "flex flex-wrap gap-1.5", children: [
-            scenario.tags.map((t) => /* @__PURE__ */ jsx21("li", { children: /* @__PURE__ */ jsx21(Badge, { variant: "tag", children: t }) }, `tag-${t}`)),
-            (scenario.tickets ?? []).map((ticket) => /* @__PURE__ */ jsx21("li", { children: ticket.url ? /* @__PURE__ */ jsx21("a", { href: ticket.url, target: "_blank", rel: "noreferrer noopener", children: /* @__PURE__ */ jsx21(Badge, { variant: "outline", children: ticket.id }) }) : /* @__PURE__ */ jsx21(Badge, { variant: "outline", children: ticket.id }) }, `ticket-${ticket.id}`))
+          scenario.tags.length > 0 || (scenario.tickets?.length ?? 0) > 0 ? /* @__PURE__ */ jsxs14("ul", { "aria-label": "Tags and tickets", className: "flex flex-wrap gap-1.5", children: [
+            scenario.tags.map((t) => /* @__PURE__ */ jsx22("li", { children: /* @__PURE__ */ jsx22(Badge, { variant: "tag", children: t }) }, `tag-${t}`)),
+            (scenario.tickets ?? []).map((ticket) => /* @__PURE__ */ jsx22("li", { children: ticket.url ? /* @__PURE__ */ jsx22("a", { href: ticket.url, target: "_blank", rel: "noreferrer noopener", children: /* @__PURE__ */ jsx22(Badge, { variant: "outline", children: ticket.id }) }) : /* @__PURE__ */ jsx22(Badge, { variant: "outline", children: ticket.id }) }, `ticket-${ticket.id}`))
           ] }) : null
         ] }),
-        /* @__PURE__ */ jsxs13(CardContent, { id: bodyId, hidden: collapsed, className: "px-4 pt-0 pb-4", children: [
-          scenario.errorMessage ? /* @__PURE__ */ jsx21(
+        /* @__PURE__ */ jsxs14(CardContent, { id: bodyId, hidden: collapsed, className: "px-4 pt-0 pb-4", children: [
+          scenario.errorMessage ? /* @__PURE__ */ jsx22(
             "pre",
             {
               role: "alert",
@@ -919,10 +1042,10 @@ function ReportScenario({ scenario, hideTitle = false }) {
               children: scenario.errorMessage
             }
           ) : null,
-          /* @__PURE__ */ jsx21(ReportSteps, { scenario }),
-          scenario.docEntries.length > 0 ? /* @__PURE__ */ jsx21("div", { "data-es-docs": true, className: "mt-3", children: /* @__PURE__ */ jsx21(ReportDocEntries, { entries: scenario.docEntries }) }) : null,
-          /* @__PURE__ */ jsx21(ReportAttachments, { attachments: scenario.attachments }),
-          /* @__PURE__ */ jsx21(ReportTrace, { spans: scenario.otelSpans })
+          /* @__PURE__ */ jsx22(ReportSteps, { scenario }),
+          scenario.docEntries.length > 0 ? /* @__PURE__ */ jsx22("div", { "data-es-docs": true, className: "mt-3", children: /* @__PURE__ */ jsx22(ReportDocEntries, { entries: scenario.docEntries }) }) : null,
+          /* @__PURE__ */ jsx22(ReportAttachments, { attachments: scenario.attachments }),
+          /* @__PURE__ */ jsx22(ReportTrace, { spans: scenario.otelSpans })
         ] })
       ]
     }
@@ -930,13 +1053,13 @@ function ReportScenario({ scenario, hideTitle = false }) {
 }
 
 // src/components/ReportScenarioList.tsx
-import { Fragment as Fragment7, jsx as jsx22 } from "react/jsx-runtime";
+import { Fragment as Fragment8, jsx as jsx23 } from "react/jsx-runtime";
 function ReportScenarioList({ feature }) {
-  return /* @__PURE__ */ jsx22(Fragment7, { children: feature.scenarios.map((scenario) => /* @__PURE__ */ jsx22(ReportScenario, { scenario }, scenario.id)) });
+  return /* @__PURE__ */ jsx23(Fragment8, { children: feature.scenarios.map((scenario) => /* @__PURE__ */ jsx23(ReportScenario, { scenario }, scenario.id)) });
 }
 
 // src/components/ReportFeature.tsx
-import { jsx as jsx23, jsxs as jsxs14 } from "react/jsx-runtime";
+import { jsx as jsx24, jsxs as jsxs15 } from "react/jsx-runtime";
 function ReportFeature({ feature }) {
   const titleId = `${feature.id}-title`;
   const bodyId = `${feature.id}-body`;
@@ -944,7 +1067,7 @@ function ReportFeature({ feature }) {
   const skipped = s.skipped + s.pending;
   const collapse = useCollapse();
   const collapsed = collapse?.isCollapsed(feature.id) ?? false;
-  return /* @__PURE__ */ jsxs14(
+  return /* @__PURE__ */ jsxs15(
     "section",
     {
       id: feature.id,
@@ -952,9 +1075,9 @@ function ReportFeature({ feature }) {
       "aria-labelledby": titleId,
       className: "overflow-hidden rounded-xl border border-border bg-card shadow-sm",
       children: [
-        /* @__PURE__ */ jsxs14("div", { className: "flex items-center justify-between gap-4 border-b border-border bg-muted/40 px-4 py-3", children: [
-          /* @__PURE__ */ jsxs14("div", { className: "flex min-w-0 items-center gap-2", children: [
-            collapse ? /* @__PURE__ */ jsx23(
+        /* @__PURE__ */ jsxs15("div", { className: "flex items-center justify-between gap-4 border-b border-border bg-muted/40 px-4 py-3", children: [
+          /* @__PURE__ */ jsxs15("div", { className: "flex min-w-0 items-center gap-2", children: [
+            collapse ? /* @__PURE__ */ jsx24(
               "button",
               {
                 type: "button",
@@ -963,30 +1086,30 @@ function ReportFeature({ feature }) {
                 "aria-controls": bodyId,
                 "aria-label": `Toggle ${feature.title}`,
                 className: "shrink-0 cursor-pointer text-muted-foreground hover:text-foreground",
-                children: /* @__PURE__ */ jsx23("span", { "aria-hidden": true, className: cn("inline-block text-xs transition-transform", !collapsed && "rotate-90"), children: "\u25B8" })
+                children: /* @__PURE__ */ jsx24("span", { "aria-hidden": true, className: cn("inline-block text-xs transition-transform", !collapsed && "rotate-90"), children: "\u25B8" })
               }
             ) : null,
-            /* @__PURE__ */ jsxs14("div", { className: "min-w-0", children: [
-              /* @__PURE__ */ jsx23("h2", { id: titleId, className: "text-sm font-semibold tracking-tight text-foreground", children: feature.title }),
-              /* @__PURE__ */ jsx23("p", { className: "mt-0.5 truncate font-mono text-xs text-muted-foreground", children: feature.sourceFile })
+            /* @__PURE__ */ jsxs15("div", { className: "min-w-0", children: [
+              /* @__PURE__ */ jsx24("h2", { id: titleId, className: "text-sm font-semibold tracking-tight text-foreground", children: feature.title }),
+              /* @__PURE__ */ jsx24("p", { className: "mt-0.5 truncate font-mono text-xs text-muted-foreground", children: feature.sourceFile })
             ] })
           ] }),
-          /* @__PURE__ */ jsxs14(
+          /* @__PURE__ */ jsxs15(
             "div",
             {
               role: "img",
               className: "flex shrink-0 items-center gap-2.5 font-mono text-xs font-medium",
               "aria-label": `${s.passed} passed, ${s.failed} failed, ${skipped} skipped`,
               children: [
-                /* @__PURE__ */ jsxs14("span", { "aria-hidden": true, className: "text-pass", children: [
+                /* @__PURE__ */ jsxs15("span", { "aria-hidden": true, className: "text-pass", children: [
                   "\u2713",
                   s.passed
                 ] }),
-                /* @__PURE__ */ jsxs14("span", { "aria-hidden": true, className: "text-fail", children: [
+                /* @__PURE__ */ jsxs15("span", { "aria-hidden": true, className: "text-fail", children: [
                   "\u2717",
                   s.failed
                 ] }),
-                /* @__PURE__ */ jsxs14("span", { "aria-hidden": true, className: "text-skip", children: [
+                /* @__PURE__ */ jsxs15("span", { "aria-hidden": true, className: "text-skip", children: [
                   "\u25CB",
                   skipped
                 ] })
@@ -994,24 +1117,24 @@ function ReportFeature({ feature }) {
             }
           )
         ] }),
-        /* @__PURE__ */ jsx23("div", { id: bodyId, hidden: collapsed, className: "flex flex-col gap-2 p-3", children: /* @__PURE__ */ jsx23(ReportScenarioList, { feature }) })
+        /* @__PURE__ */ jsx24("div", { id: bodyId, hidden: collapsed, className: "flex flex-col gap-2 p-3", children: /* @__PURE__ */ jsx24(ReportScenarioList, { feature }) })
       ]
     }
   );
 }
 
 // src/components/ReportFeatureList.tsx
-import { Fragment as Fragment8, jsx as jsx24 } from "react/jsx-runtime";
+import { Fragment as Fragment9, jsx as jsx25 } from "react/jsx-runtime";
 function ReportFeatureList() {
   const report = useReport();
-  return /* @__PURE__ */ jsx24(Fragment8, { children: report.features.map((feature) => /* @__PURE__ */ jsx24(ReportFeature, { feature }, feature.id)) });
+  return /* @__PURE__ */ jsx25(Fragment9, { children: report.features.map((feature) => /* @__PURE__ */ jsx25(ReportFeature, { feature }, feature.id)) });
 }
 
 // src/components/ui/empty.tsx
 import { cva as cva2 } from "class-variance-authority";
-import { jsx as jsx25 } from "react/jsx-runtime";
+import { jsx as jsx26 } from "react/jsx-runtime";
 function Empty({ className, ...props }) {
-  return /* @__PURE__ */ jsx25(
+  return /* @__PURE__ */ jsx26(
     "div",
     {
       "data-slot": "empty",
@@ -1024,7 +1147,7 @@ function Empty({ className, ...props }) {
   );
 }
 function EmptyHeader({ className, ...props }) {
-  return /* @__PURE__ */ jsx25(
+  return /* @__PURE__ */ jsx26(
     "div",
     {
       "data-slot": "empty-header",
@@ -1051,7 +1174,7 @@ var emptyMediaVariants = cva2(
   }
 );
 function EmptyTitle({ className, ...props }) {
-  return /* @__PURE__ */ jsx25(
+  return /* @__PURE__ */ jsx26(
     "div",
     {
       "data-slot": "empty-title",
@@ -1062,16 +1185,16 @@ function EmptyTitle({ className, ...props }) {
 }
 
 // src/components/ReportEmpty.tsx
-import { jsx as jsx26 } from "react/jsx-runtime";
+import { jsx as jsx27 } from "react/jsx-runtime";
 function ReportEmpty({ message }) {
-  return /* @__PURE__ */ jsx26(Empty, { "aria-live": "polite", className: "border", children: /* @__PURE__ */ jsx26(EmptyHeader, { children: /* @__PURE__ */ jsx26(EmptyTitle, { children: message ?? "No scenarios in this report." }) }) });
+  return /* @__PURE__ */ jsx27(Empty, { "aria-live": "polite", className: "border", children: /* @__PURE__ */ jsx27(EmptyHeader, { children: /* @__PURE__ */ jsx27(EmptyTitle, { children: message ?? "No scenarios in this report." }) }) });
 }
 
 // src/components/ReportSummary.tsx
-import { Fragment as Fragment9, jsx as jsx27, jsxs as jsxs15 } from "react/jsx-runtime";
+import { Fragment as Fragment10, jsx as jsx28, jsxs as jsxs16 } from "react/jsx-runtime";
 function ReportSummary({ className }) {
   const report = useReport();
-  return /* @__PURE__ */ jsx27(
+  return /* @__PURE__ */ jsx28(
     ReportSummaryView,
     {
       summary: report.summary,
@@ -1081,32 +1204,32 @@ function ReportSummary({ className }) {
   );
 }
 function ReportSummaryView({ summary, className, ariaLabel }) {
-  return /* @__PURE__ */ jsxs15("p", { className: cn("text-sm text-muted-foreground", className), "aria-label": ariaLabel, children: [
-    /* @__PURE__ */ jsxs15("span", { children: [
-      /* @__PURE__ */ jsx27("strong", { className: "font-semibold text-foreground", children: summary.total }),
+  return /* @__PURE__ */ jsxs16("p", { className: cn("text-sm text-muted-foreground", className), "aria-label": ariaLabel, children: [
+    /* @__PURE__ */ jsxs16("span", { children: [
+      /* @__PURE__ */ jsx28("strong", { className: "font-semibold text-foreground", children: summary.total }),
       " scenario",
       summary.total === 1 ? "" : "s"
     ] }),
     " \xB7 ",
-    /* @__PURE__ */ jsxs15("span", { "data-status": "passed", className: "text-pass", children: [
+    /* @__PURE__ */ jsxs16("span", { "data-status": "passed", className: "text-pass", children: [
       summary.passed,
       " passed"
     ] }),
     " \xB7 ",
-    /* @__PURE__ */ jsxs15("span", { "data-status": "failed", className: "text-fail", children: [
+    /* @__PURE__ */ jsxs16("span", { "data-status": "failed", className: "text-fail", children: [
       summary.failed,
       " failed"
     ] }),
-    summary.skipped > 0 ? /* @__PURE__ */ jsxs15(Fragment9, { children: [
+    summary.skipped > 0 ? /* @__PURE__ */ jsxs16(Fragment10, { children: [
       " \xB7 ",
-      /* @__PURE__ */ jsxs15("span", { "data-status": "skipped", className: "text-skip", children: [
+      /* @__PURE__ */ jsxs16("span", { "data-status": "skipped", className: "text-skip", children: [
         summary.skipped,
         " skipped"
       ] })
     ] }) : null,
-    summary.pending > 0 ? /* @__PURE__ */ jsxs15(Fragment9, { children: [
+    summary.pending > 0 ? /* @__PURE__ */ jsxs16(Fragment10, { children: [
       " \xB7 ",
-      /* @__PURE__ */ jsxs15("span", { "data-status": "pending", className: "text-pend", children: [
+      /* @__PURE__ */ jsxs16("span", { "data-status": "pending", className: "text-pend", children: [
         summary.pending,
         " pending"
       ] })
@@ -1114,69 +1237,135 @@ function ReportSummaryView({ summary, className, ariaLabel }) {
   ] });
 }
 
+// src/lib/provenance.ts
+function reportLastRunMs(report) {
+  if (report.finishedAtMs && report.finishedAtMs > 0) return report.finishedAtMs;
+  if (report.startedAtMs && report.startedAtMs > 0) return report.startedAtMs;
+  return void 0;
+}
+function formatRelativeAge(thenMs, nowMs) {
+  const deltaMs = Math.max(0, nowMs - thenMs);
+  const minutes = Math.floor(deltaMs / 6e4);
+  if (minutes < 1) return "just now";
+  if (minutes < 60) return `${minutes} minute${minutes === 1 ? "" : "s"} ago`;
+  const hours = Math.floor(minutes / 60);
+  if (hours < 24) return `${hours} hour${hours === 1 ? "" : "s"} ago`;
+  const days = Math.floor(hours / 24);
+  return `${days} day${days === 1 ? "" : "s"} ago`;
+}
+function isReportStale(lastRunMs, staleAfterDays, nowMs) {
+  if (lastRunMs === void 0 || staleAfterDays <= 0) return false;
+  return nowMs - lastRunMs >= staleAfterDays * 864e5;
+}
+var CI_DISPLAY_NAMES = {
+  github: "GitHub Actions",
+  gitlab: "GitLab CI",
+  circleci: "CircleCI",
+  jenkins: "Jenkins",
+  azure: "Azure DevOps",
+  buildkite: "Buildkite",
+  travis: "Travis CI",
+  ci: "CI"
+};
+function ciDisplayName(name) {
+  return CI_DISPLAY_NAMES[name] ?? name;
+}
+function commitUrl(ci, sha) {
+  const commitSha = ci?.commitSha ?? sha;
+  if (!ci?.url || !commitSha) return void 0;
+  const github = ci.url.match(/^(https?:\/\/[^/]+\/[^/]+\/[^/]+)\/actions\/runs\//);
+  if (github) return `${github[1]}/commit/${commitSha}`;
+  const gitlab = ci.url.match(/^(https?:\/\/.+)\/-\/pipelines\//);
+  if (gitlab) return `${gitlab[1]}/-/commit/${commitSha}`;
+  return void 0;
+}
+function prUrl(ci) {
+  if (!ci?.url || !ci.prNumber) return void 0;
+  const github = ci.url.match(/^(https?:\/\/[^/]+\/[^/]+\/[^/]+)\/actions\/runs\//);
+  if (github) return `${github[1]}/pull/${ci.prNumber}`;
+  return void 0;
+}
+
 // src/components/ReportMeta.tsx
-import { formatDuration as formatDuration4 } from "executable-stories-core/utils/duration";
-import { jsx as jsx28, jsxs as jsxs16 } from "react/jsx-runtime";
+import { jsx as jsx29, jsxs as jsxs17 } from "react/jsx-runtime";
 function ReportMeta() {
   const report = useReport();
   const items = [];
+  const linkClass = "text-primary underline underline-offset-2";
   if (report.startedAtMs) {
     items.push({ label: "Started", value: new Date(report.startedAtMs).toLocaleString() });
   }
   if (report.durationMs) {
-    items.push({ label: "Duration", value: formatDuration4(report.durationMs) });
+    items.push({ label: "Duration", value: formatDuration(report.durationMs) });
   }
   if (report.packageVersion) {
     items.push({ label: "Version", value: report.packageVersion });
   }
-  if (report.gitSha) {
-    items.push({ label: "Commit", value: report.gitSha.slice(0, 8) });
+  if (report.ci?.branch) {
+    items.push({ label: "Branch", value: report.ci.branch });
+  }
+  const sha = report.ci?.commitSha ?? report.gitSha;
+  if (sha) {
+    const url = commitUrl(report.ci, report.gitSha);
+    const short = sha.slice(0, 8);
+    items.push({
+      label: "Commit",
+      value: url ? /* @__PURE__ */ jsx29("a", { href: url, target: "_blank", rel: "noreferrer noopener", className: linkClass, children: short }) : short
+    });
   }
   if (report.ci) {
     items.push({
       label: "CI",
-      value: report.ci.url ? /* @__PURE__ */ jsxs16("a", { href: report.ci.url, target: "_blank", rel: "noreferrer noopener", className: "text-primary underline underline-offset-2", children: [
-        report.ci.name,
+      value: report.ci.url ? /* @__PURE__ */ jsxs17("a", { href: report.ci.url, target: "_blank", rel: "noreferrer noopener", className: linkClass, children: [
+        ciDisplayName(report.ci.name),
         report.ci.buildNumber ? ` #${report.ci.buildNumber}` : ""
-      ] }) : `${report.ci.name}${report.ci.buildNumber ? ` #${report.ci.buildNumber}` : ""}`
+      ] }) : `${ciDisplayName(report.ci.name)}${report.ci.buildNumber ? ` #${report.ci.buildNumber}` : ""}`
+    });
+  }
+  if (report.ci?.prNumber) {
+    const url = prUrl(report.ci);
+    const label = `#${report.ci.prNumber}`;
+    items.push({
+      label: "PR",
+      value: url ? /* @__PURE__ */ jsx29("a", { href: url, target: "_blank", rel: "noreferrer noopener", className: linkClass, children: label }) : label
     });
   }
   if (items.length === 0) return null;
-  return /* @__PURE__ */ jsx28("dl", { "aria-label": "Run metadata", className: "flex flex-wrap gap-x-6 gap-y-1 text-xs text-muted-foreground", children: items.map((item) => /* @__PURE__ */ jsxs16("div", { className: "flex gap-1.5", children: [
-    /* @__PURE__ */ jsx28("dt", { className: "font-medium", children: item.label }),
-    /* @__PURE__ */ jsx28("dd", { className: "font-mono text-foreground", children: item.value })
+  return /* @__PURE__ */ jsx29("dl", { "aria-label": "Run metadata", className: "flex flex-wrap gap-x-6 gap-y-1 text-xs text-muted-foreground", children: items.map((item) => /* @__PURE__ */ jsxs17("div", { className: "flex gap-1.5", children: [
+    /* @__PURE__ */ jsx29("dt", { className: "font-medium", children: item.label }),
+    /* @__PURE__ */ jsx29("dd", { className: "font-mono text-foreground", children: item.value })
   ] }, item.label)) });
 }
 
 // src/components/ReportSchemaError.tsx
-import { jsx as jsx29, jsxs as jsxs17 } from "react/jsx-runtime";
+import { jsx as jsx30, jsxs as jsxs18 } from "react/jsx-runtime";
 function ReportSchemaError({ error }) {
-  return /* @__PURE__ */ jsxs17("section", { className: "es-schema-error", role: "alert", "aria-live": "assertive", children: [
-    /* @__PURE__ */ jsx29("p", { children: /* @__PURE__ */ jsx29("strong", { children: "Report could not be displayed." }) }),
-    /* @__PURE__ */ jsx29("p", { children: error.message }),
-    error.code === "SCHEMA_VERSION_MISMATCH" ? /* @__PURE__ */ jsxs17("p", { children: [
+  return /* @__PURE__ */ jsxs18("section", { className: "es-schema-error", role: "alert", "aria-live": "assertive", children: [
+    /* @__PURE__ */ jsx30("p", { children: /* @__PURE__ */ jsx30("strong", { children: "Report could not be displayed." }) }),
+    /* @__PURE__ */ jsx30("p", { children: error.message }),
+    error.code === "SCHEMA_VERSION_MISMATCH" ? /* @__PURE__ */ jsxs18("p", { children: [
       "The report bundle is newer than this version of ",
-      /* @__PURE__ */ jsx29("code", { children: "executable-stories-react" }),
+      /* @__PURE__ */ jsx30("code", { children: "executable-stories-react" }),
       ". Upgrade the package, or regenerate the report with an older formatters CLI."
     ] }) : null,
-    error.issues && error.issues.length > 0 ? /* @__PURE__ */ jsxs17("details", { children: [
-      /* @__PURE__ */ jsxs17("summary", { children: [
+    error.issues && error.issues.length > 0 ? /* @__PURE__ */ jsxs18("details", { children: [
+      /* @__PURE__ */ jsxs18("summary", { children: [
         error.issues.length,
         " validation issue",
         error.issues.length === 1 ? "" : "s"
       ] }),
-      /* @__PURE__ */ jsx29("pre", { children: error.issues.slice(0, 20).map((i) => `${i.path}: ${i.message}`).join("\n") })
+      /* @__PURE__ */ jsx30("pre", { children: error.issues.slice(0, 20).map((i) => `${i.path}: ${i.message}`).join("\n") })
     ] }) : null
   ] });
 }
 
 // src/components/ReportShell.tsx
-import { Fragment as Fragment10, jsx as jsx30, jsxs as jsxs18 } from "react/jsx-runtime";
+import { Fragment as Fragment11, jsx as jsx31, jsxs as jsxs19 } from "react/jsx-runtime";
 function ReportTitleBlock({ title }) {
-  return /* @__PURE__ */ jsxs18(Fragment10, { children: [
-    /* @__PURE__ */ jsx30("h1", { children: title ?? "Story Report" }),
-    /* @__PURE__ */ jsx30(ReportSummary, {}),
-    /* @__PURE__ */ jsx30(ReportMeta, {})
+  return /* @__PURE__ */ jsxs19(Fragment11, { children: [
+    /* @__PURE__ */ jsx31("h1", { children: title ?? "Story Report" }),
+    /* @__PURE__ */ jsx31(ReportSummary, {}),
+    /* @__PURE__ */ jsx31(ReportMeta, {})
   ] });
 }
 function ReportErrorShell({
@@ -1185,7 +1374,7 @@ function ReportErrorShell({
   title,
   dataTheme
 }) {
-  return /* @__PURE__ */ jsx30("main", { className: cn("es-report", className), "aria-label": title ?? "Test report", "data-theme": dataTheme, children: /* @__PURE__ */ jsx30(ReportSchemaError, { error }) });
+  return /* @__PURE__ */ jsx31("main", { className: cn("es-report", className), "aria-label": title ?? "Test report", "data-theme": dataTheme, children: /* @__PURE__ */ jsx31(ReportSchemaError, { error }) });
 }
 
 // src/interactive/ReportSearch.tsx
@@ -1193,7 +1382,7 @@ import {
   forwardRef,
   useId
 } from "react";
-import { jsx as jsx31, jsxs as jsxs19 } from "react/jsx-runtime";
+import { jsx as jsx32, jsxs as jsxs20 } from "react/jsx-runtime";
 var ReportSearch = forwardRef(
   function ReportSearch2(props, ref) {
     const {
@@ -1215,9 +1404,9 @@ var ReportSearch = forwardRef(
         e.preventDefault();
       }
     }
-    return /* @__PURE__ */ jsxs19("div", { className: ["es-search", className].filter(Boolean).join(" "), children: [
-      /* @__PURE__ */ jsx31("label", { htmlFor: inputId, className: "es-search-label", children: "Search" }),
-      /* @__PURE__ */ jsx31(
+    return /* @__PURE__ */ jsxs20("div", { className: ["es-search", className].filter(Boolean).join(" "), children: [
+      /* @__PURE__ */ jsx32("label", { htmlFor: inputId, className: "es-search-label", children: "Search" }),
+      /* @__PURE__ */ jsx32(
         "input",
         {
           ref,
@@ -1232,7 +1421,7 @@ var ReportSearch = forwardRef(
           "aria-keyshortcuts": "/"
         }
       ),
-      showCounts ? /* @__PURE__ */ jsx31("span", { className: "es-search-counts", "aria-live": "polite", children: value ? `${matchedCount} of ${totalCount}` : `${totalCount} total` }) : null
+      showCounts ? /* @__PURE__ */ jsx32("span", { className: "es-search-counts", "aria-live": "polite", children: value ? `${matchedCount} of ${totalCount}` : `${totalCount} total` }) : null
     ] });
   }
 );
@@ -1261,7 +1450,7 @@ function scrollToScenarioId(scenarioId, options = {}) {
 }
 
 // src/interactive/ReportFailureBanner.tsx
-import { jsx as jsx32, jsxs as jsxs20 } from "react/jsx-runtime";
+import { jsx as jsx33, jsxs as jsxs21 } from "react/jsx-runtime";
 function ReportFailureBanner({ failures }) {
   const first = failures[0];
   const jumpToFirst = useCallback2(() => {
@@ -1269,7 +1458,7 @@ function ReportFailureBanner({ failures }) {
     scrollToScenarioId(first.scenarioId);
   }, [first]);
   if (failures.length === 0) return null;
-  return /* @__PURE__ */ jsxs20(
+  return /* @__PURE__ */ jsxs21(
     "div",
     {
       className: "es-failure-banner",
@@ -1277,13 +1466,13 @@ function ReportFailureBanner({ failures }) {
       "aria-live": "polite",
       "aria-label": "Failure summary",
       children: [
-        /* @__PURE__ */ jsxs20("span", { className: "es-failure-banner-text", children: [
-          /* @__PURE__ */ jsx32("strong", { children: failures.length }),
+        /* @__PURE__ */ jsxs21("span", { className: "es-failure-banner-text", children: [
+          /* @__PURE__ */ jsx33("strong", { children: failures.length }),
           " ",
           "failure",
           failures.length === 1 ? "" : "s"
         ] }),
-        /* @__PURE__ */ jsx32(
+        /* @__PURE__ */ jsx33(
           "button",
           {
             type: "button",
@@ -1298,9 +1487,101 @@ function ReportFailureBanner({ failures }) {
   );
 }
 
+// src/interactive/ReportFreshness.tsx
+import { useEffect, useState as useState2 } from "react";
+import { Fragment as Fragment12, jsx as jsx34, jsxs as jsxs22 } from "react/jsx-runtime";
+function ReportFreshness({ lastRunMs, ciUrl, staleAfterDays, nowMs }) {
+  const [now, setNow] = useState2(nowMs);
+  useEffect(() => {
+    if (nowMs === void 0) setNow(Date.now());
+  }, [nowMs]);
+  if (lastRunMs === void 0 || now === void 0) return null;
+  const age = formatRelativeAge(lastRunMs, now);
+  const runLink = ciUrl ? /* @__PURE__ */ jsx34(
+    "a",
+    {
+      href: ciUrl,
+      target: "_blank",
+      rel: "noreferrer noopener",
+      className: "underline underline-offset-2",
+      children: "View CI run"
+    }
+  ) : null;
+  if (isReportStale(lastRunMs, staleAfterDays, now)) {
+    return /* @__PURE__ */ jsxs22("div", { className: "es-stale-banner", role: "status", "aria-label": "Report freshness", children: [
+      /* @__PURE__ */ jsxs22("span", { children: [
+        /* @__PURE__ */ jsxs22("strong", { children: [
+          "Last verified ",
+          age,
+          "."
+        ] }),
+        " This report may no longer match the current behavior \u2014 look for a newer run."
+      ] }),
+      runLink
+    ] });
+  }
+  return /* @__PURE__ */ jsxs22("p", { className: "es-freshness", "aria-label": "Report freshness", children: [
+    "Verified ",
+    age,
+    runLink ? /* @__PURE__ */ jsxs22(Fragment12, { children: [
+      " \xB7 ",
+      runLink
+    ] }) : null
+  ] });
+}
+
+// src/interactive/ReportLastRunDelta.tsx
+import { Fragment as Fragment13, jsx as jsx35, jsxs as jsxs23 } from "react/jsx-runtime";
+var MAX_LINKS = 5;
+function ScenarioLinks({ scenarios, tone }) {
+  return /* @__PURE__ */ jsxs23(Fragment13, { children: [
+    scenarios.slice(0, MAX_LINKS).map((s, i) => /* @__PURE__ */ jsxs23("span", { children: [
+      i > 0 ? ", " : "",
+      /* @__PURE__ */ jsx35("a", { href: `#${s.id}`, className: cn("underline underline-offset-2 hover:no-underline", tone), children: s.title })
+    ] }, s.id)),
+    scenarios.length > MAX_LINKS ? /* @__PURE__ */ jsxs23("span", { children: [
+      " and ",
+      scenarios.length - MAX_LINKS,
+      " more"
+    ] }) : null
+  ] });
+}
+function ReportLastRunDelta({
+  history: history2,
+  report
+}) {
+  if (!history2) return null;
+  const scenarios = report.features.flatMap((f) => f.scenarios.map((s) => ({ id: s.id, title: s.title })));
+  const delta = diffSinceLastRun(history2, scenarios);
+  if (!delta) return null;
+  const { newlyFailing, newlyPassing, added } = delta;
+  if (newlyFailing.length === 0 && newlyPassing.length === 0 && added.length === 0) {
+    return /* @__PURE__ */ jsx35("p", { className: "text-xs text-muted-foreground", "data-testid": "es-last-run-delta", children: "Since last run: no behavior changes." });
+  }
+  return /* @__PURE__ */ jsxs23("p", { className: "text-xs text-muted-foreground", "data-testid": "es-last-run-delta", children: [
+    /* @__PURE__ */ jsx35("span", { className: "font-medium text-foreground", children: "Since last run:" }),
+    newlyFailing.length > 0 ? /* @__PURE__ */ jsxs23("span", { className: "ml-2 text-fail", children: [
+      newlyFailing.length,
+      " newly failing (",
+      /* @__PURE__ */ jsx35(ScenarioLinks, { scenarios: newlyFailing, tone: "text-fail" }),
+      ")"
+    ] }) : null,
+    newlyPassing.length > 0 ? /* @__PURE__ */ jsxs23("span", { className: "ml-2 text-pass", children: [
+      newlyPassing.length,
+      " fixed (",
+      /* @__PURE__ */ jsx35(ScenarioLinks, { scenarios: newlyPassing, tone: "text-pass" }),
+      ")"
+    ] }) : null,
+    added.length > 0 ? /* @__PURE__ */ jsxs23("span", { className: "ml-2", children: [
+      added.length,
+      " new"
+    ] }) : null
+  ] });
+}
+
 // src/interactive/ReportShortcutsHelp.tsx
-import { useEffect, useRef } from "react";
-import { jsx as jsx33, jsxs as jsxs21 } from "react/jsx-runtime";
+import { useEffect as useEffect2, useRef } from "react";
+import { jsx as jsx36, jsxs as jsxs24 } from "react/jsx-runtime";
 var SHORTCUTS = [
   { keys: "/", description: "Focus search" },
   { keys: "f", description: "Jump to next failure" },
@@ -1310,13 +1591,13 @@ var SHORTCUTS = [
 ];
 function ReportShortcutsHelp({ open, onClose }) {
   const dialogRef = useRef(null);
-  useEffect(() => {
+  useEffect2(() => {
     const dialog = dialogRef.current;
     if (!dialog) return;
     if (open && !dialog.open) dialog.showModal();
     else if (!open && dialog.open) dialog.close();
   }, [open]);
-  return /* @__PURE__ */ jsxs21(
+  return /* @__PURE__ */ jsxs24(
     "dialog",
     {
       ref: dialogRef,
@@ -1324,19 +1605,19 @@ function ReportShortcutsHelp({ open, onClose }) {
       "aria-label": "Keyboard shortcuts",
       onClose,
       children: [
-        /* @__PURE__ */ jsx33("h2", { children: "Keyboard shortcuts" }),
-        /* @__PURE__ */ jsx33("dl", { children: SHORTCUTS.map((s) => /* @__PURE__ */ jsxs21("div", { children: [
-          /* @__PURE__ */ jsx33("dt", { children: /* @__PURE__ */ jsx33("kbd", { children: s.keys }) }),
-          /* @__PURE__ */ jsx33("dd", { children: s.description })
+        /* @__PURE__ */ jsx36("h2", { children: "Keyboard shortcuts" }),
+        /* @__PURE__ */ jsx36("dl", { children: SHORTCUTS.map((s) => /* @__PURE__ */ jsxs24("div", { children: [
+          /* @__PURE__ */ jsx36("dt", { children: /* @__PURE__ */ jsx36("kbd", { children: s.keys }) }),
+          /* @__PURE__ */ jsx36("dd", { children: s.description })
         ] }, s.keys)) }),
-        /* @__PURE__ */ jsx33("form", { method: "dialog", children: /* @__PURE__ */ jsx33("button", { type: "submit", className: "es-shortcuts-close", children: "Close" }) })
+        /* @__PURE__ */ jsx36("form", { method: "dialog", children: /* @__PURE__ */ jsx36("button", { type: "submit", className: "es-shortcuts-close", children: "Close" }) })
       ]
     }
   );
 }
 
 // src/interactive/use-keyboard-shortcuts.ts
-import { useEffect as useEffect2, useRef as useRef2 } from "react";
+import { useEffect as useEffect3, useRef as useRef2 } from "react";
 function isEditableTarget(target) {
   if (!(target instanceof HTMLElement)) return false;
   const tag = target.tagName;
@@ -1347,7 +1628,7 @@ function isEditableTarget(target) {
 function useKeyboardShortcuts(handlers) {
   const ref = useRef2(handlers);
   ref.current = handlers;
-  useEffect2(() => {
+  useEffect3(() => {
     function onKeyDown(e) {
       const h = ref.current;
       if (e.key === "Escape") {
@@ -1391,9 +1672,9 @@ function useKeyboardShortcuts(handlers) {
 }
 
 // src/interactive/use-deep-link-scroll.ts
-import { useEffect as useEffect3 } from "react";
+import { useEffect as useEffect4 } from "react";
 function useDeepLinkScroll() {
-  useEffect3(() => {
+  useEffect4(() => {
     function scrollToHash() {
       const hash = window.location.hash.replace(/^#/, "");
       if (!hash) return;
@@ -1502,7 +1783,7 @@ function listFailures(report) {
 }
 
 // src/interactive/ReportFilters.tsx
-import { jsx as jsx34, jsxs as jsxs22 } from "react/jsx-runtime";
+import { jsx as jsx37, jsxs as jsxs25 } from "react/jsx-runtime";
 function ReportFilters({
   statuses,
   status,
@@ -1512,10 +1793,10 @@ function ReportFilters({
   onToggleTag
 }) {
   if (statuses.length === 0 && tags.length === 0) return null;
-  return /* @__PURE__ */ jsxs22("div", { className: "flex flex-col gap-2", children: [
-    statuses.length > 0 ? /* @__PURE__ */ jsx34("div", { role: "group", "aria-label": "Filter by status", className: "flex flex-wrap gap-1", children: statuses.map((opt) => {
+  return /* @__PURE__ */ jsxs25("div", { className: "flex flex-col gap-2", children: [
+    statuses.length > 0 ? /* @__PURE__ */ jsx37("div", { role: "group", "aria-label": "Filter by status", className: "flex flex-wrap gap-1", children: statuses.map((opt) => {
       const active = status === opt.key;
-      return /* @__PURE__ */ jsxs22(
+      return /* @__PURE__ */ jsxs25(
         "button",
         {
           type: "button",
@@ -1527,22 +1808,22 @@ function ReportFilters({
           ),
           children: [
             opt.label,
-            /* @__PURE__ */ jsx34("span", { className: "ml-1 font-mono opacity-70", children: opt.count })
+            /* @__PURE__ */ jsx37("span", { className: "ml-1 font-mono opacity-70", children: opt.count })
           ]
         },
         opt.key
       );
     }) }) : null,
-    tags.length > 0 ? /* @__PURE__ */ jsx34("ul", { "aria-label": "Filter by tag", className: "flex flex-wrap gap-1.5", children: tags.map((tag) => {
+    tags.length > 0 ? /* @__PURE__ */ jsx37("ul", { "aria-label": "Filter by tag", className: "flex flex-wrap gap-1.5", children: tags.map((tag) => {
       const active = activeTags.includes(tag);
-      return /* @__PURE__ */ jsx34("li", { children: /* @__PURE__ */ jsx34(
+      return /* @__PURE__ */ jsx37("li", { children: /* @__PURE__ */ jsx37(
         "button",
         {
           type: "button",
           "aria-pressed": active,
           onClick: () => onToggleTag(tag),
           className: "cursor-pointer",
-          children: /* @__PURE__ */ jsx34(Badge, { variant: active ? "default" : "tag", children: tag })
+          children: /* @__PURE__ */ jsx37(Badge, { variant: active ? "default" : "tag", children: tag })
         }
       ) }, tag);
     }) }) : null
@@ -1550,8 +1831,8 @@ function ReportFilters({
 }
 
 // src/interactive/ReportToc.tsx
-import { useEffect as useEffect4, useMemo as useMemo2, useState as useState2 } from "react";
-import { jsx as jsx35, jsxs as jsxs23 } from "react/jsx-runtime";
+import { useEffect as useEffect5, useMemo as useMemo2, useState as useState3 } from "react";
+import { jsx as jsx38, jsxs as jsxs26 } from "react/jsx-runtime";
 var DOT = {
   passed: "text-pass",
   failed: "text-fail",
@@ -1560,12 +1841,12 @@ var DOT = {
 };
 function ReportToc() {
   const report = useReport();
-  const [activeId, setActiveId] = useState2(null);
+  const [activeId, setActiveId] = useState3(null);
   const scenarioIds = useMemo2(
     () => report.features.flatMap((f) => f.scenarios.map((s) => s.id)),
     [report]
   );
-  useEffect4(() => {
+  useEffect5(() => {
     if (typeof IntersectionObserver === "undefined") return;
     const els = scenarioIds.map((id) => document.getElementById(id)).filter((el) => el !== null);
     if (els.length === 0) return;
@@ -1580,16 +1861,16 @@ function ReportToc() {
     return () => observer.disconnect();
   }, [scenarioIds]);
   if (report.features.length === 0) return null;
-  return /* @__PURE__ */ jsx35(
+  return /* @__PURE__ */ jsx38(
     "nav",
     {
       "aria-label": "Table of contents",
       className: "sticky top-4 hidden h-fit w-56 shrink-0 self-start text-xs lg:block",
-      children: /* @__PURE__ */ jsx35("ul", { className: "flex flex-col gap-3", children: report.features.map((feature) => /* @__PURE__ */ jsxs23("li", { children: [
-        /* @__PURE__ */ jsx35("p", { className: "mb-1 truncate font-semibold text-foreground", children: feature.title }),
-        /* @__PURE__ */ jsx35("ul", { className: "flex flex-col", children: feature.scenarios.map((scenario) => {
+      children: /* @__PURE__ */ jsx38("ul", { className: "flex flex-col gap-3", children: report.features.map((feature) => /* @__PURE__ */ jsxs26("li", { children: [
+        /* @__PURE__ */ jsx38("p", { className: "mb-1 truncate font-semibold text-foreground", children: feature.title }),
+        /* @__PURE__ */ jsx38("ul", { className: "flex flex-col", children: feature.scenarios.map((scenario) => {
           const active = activeId === scenario.id;
-          return /* @__PURE__ */ jsx35("li", { children: /* @__PURE__ */ jsxs23(
+          return /* @__PURE__ */ jsx38("li", { children: /* @__PURE__ */ jsxs26(
             "a",
             {
               href: `#${scenario.id}`,
@@ -1603,8 +1884,8 @@ function ReportToc() {
                 active ? "border-primary font-medium text-foreground" : "border-border text-muted-foreground"
               ),
               children: [
-                /* @__PURE__ */ jsx35("span", { "aria-hidden": true, className: cn("shrink-0", DOT[scenario.status]), children: "\u2022" }),
-                /* @__PURE__ */ jsx35("span", { className: "truncate", children: scenario.title })
+                /* @__PURE__ */ jsx38("span", { "aria-hidden": true, className: cn("shrink-0", DOT[scenario.status]), children: "\u2022" }),
+                /* @__PURE__ */ jsx38("span", { className: "truncate", children: scenario.title })
               ]
             }
           ) }, scenario.id);
@@ -1615,7 +1896,7 @@ function ReportToc() {
 }
 
 // src/interactive/use-theme.ts
-import { useCallback as useCallback3, useEffect as useEffect5, useState as useState3 } from "react";
+import { useCallback as useCallback3, useEffect as useEffect6, useState as useState4 } from "react";
 var KEY = "es-theme";
 function applyTheme(theme) {
   if (typeof document !== "undefined") {
@@ -1636,8 +1917,8 @@ function initialTheme() {
   return "light";
 }
 function useTheme() {
-  const [theme, setTheme] = useState3("light");
-  useEffect5(() => {
+  const [theme, setTheme] = useState4("light");
+  useEffect6(() => {
     const t = initialTheme();
     setTheme(t);
     applyTheme(t);
@@ -1657,14 +1938,14 @@ function useTheme() {
 }
 
 // src/interactive/ReportInteractive.tsx
-import { jsx as jsx36, jsxs as jsxs24 } from "react/jsx-runtime";
+import { jsx as jsx39, jsxs as jsxs27 } from "react/jsx-runtime";
 function ReportInteractive(props) {
   const { report, className, title, dataTheme } = props;
   const result = unwrapReport(report);
   if (!result.ok) {
-    return /* @__PURE__ */ jsx36(ReportErrorShell, { error: result.error, className, title, dataTheme });
+    return /* @__PURE__ */ jsx39(ReportErrorShell, { error: result.error, className, title, dataTheme });
   }
-  return /* @__PURE__ */ jsx36(ReportInteractiveView, { ...props, report: result.data });
+  return /* @__PURE__ */ jsx39(ReportInteractiveView, { ...props, report: result.data });
 }
 function ReportInteractiveView({
   report,
@@ -1673,13 +1954,15 @@ function ReportInteractiveView({
   className,
   title,
   dataTheme,
-  hideHeader = false
+  hideHeader = false,
+  staleAfterDays = 7,
+  scenarioHistory
 }) {
-  const [query, setQuery] = useState4("");
-  const [statusFilter, setStatusFilter] = useState4("all");
-  const [activeTags, setActiveTags] = useState4([]);
-  const [detail, setDetail] = useState4("full");
-  const [helpOpen, setHelpOpen] = useState4(false);
+  const [query, setQuery] = useState5("");
+  const [statusFilter, setStatusFilter] = useState5("all");
+  const [activeTags, setActiveTags] = useState5([]);
+  const [detail, setDetail] = useState5("full");
+  const [helpOpen, setHelpOpen] = useState5(false);
   const { theme, toggle: toggleTheme } = useTheme();
   const searchRef = useRef3(null);
   const deferredQuery = useDeferredValue(query);
@@ -1705,7 +1988,7 @@ function ReportInteractiveView({
     (tag) => setActiveTags((prev) => prev.includes(tag) ? prev.filter((t) => t !== tag) : [...prev, tag]),
     []
   );
-  const [toast, setToast] = useState4(null);
+  const [toast, setToast] = useState5(null);
   const toastTimer = useRef3(null);
   const showToast = useCallback4((msg) => {
     setToast(msg);
@@ -1767,13 +2050,13 @@ function ReportInteractiveView({
   const hasContent = filtered.features.length > 0;
   const totalScenarios = report.summary.total;
   const matchedScenarios = filtered.summary.total;
-  return /* @__PURE__ */ jsx36(CollapseProvider, { value: collapse.api, children: /* @__PURE__ */ jsx36(ScenarioActionsProvider, { value: scenarioActions, children: /* @__PURE__ */ jsx36(
+  return /* @__PURE__ */ jsx39(CollapseProvider, { value: collapse.api, children: /* @__PURE__ */ jsx39(ScenarioActionsProvider, { value: scenarioActions, children: /* @__PURE__ */ jsx39(ScenarioHistoryProvider, { value: scenarioHistory ?? null, children: /* @__PURE__ */ jsx39(
     ReportRoot,
     {
       report: filtered,
       customRenderers,
       renderers,
-      children: /* @__PURE__ */ jsxs24(
+      children: /* @__PURE__ */ jsxs27(
         "main",
         {
           className: cn("es-report", "es-report-interactive", className),
@@ -1782,10 +2065,19 @@ function ReportInteractiveView({
           "data-theme": dataTheme,
           "data-detail-level": detail,
           children: [
-            /* @__PURE__ */ jsxs24("header", { className: "es-report-header", children: [
-              hideHeader ? null : /* @__PURE__ */ jsx36(ReportTitleBlock, { title }),
-              /* @__PURE__ */ jsxs24("div", { className: "flex flex-wrap items-center gap-2", children: [
-                /* @__PURE__ */ jsx36(
+            /* @__PURE__ */ jsxs27("header", { className: "es-report-header", children: [
+              hideHeader ? null : /* @__PURE__ */ jsx39(ReportTitleBlock, { title }),
+              /* @__PURE__ */ jsx39(
+                ReportFreshness,
+                {
+                  lastRunMs: reportLastRunMs(report),
+                  ciUrl: report.ci?.url,
+                  staleAfterDays
+                }
+              ),
+              /* @__PURE__ */ jsx39(ReportLastRunDelta, { history: scenarioHistory, report }),
+              /* @__PURE__ */ jsxs27("div", { className: "flex flex-wrap items-center gap-2", children: [
+                /* @__PURE__ */ jsx39(
                   ReportSearch,
                   {
                     ref: searchRef,
@@ -1795,8 +2087,8 @@ function ReportInteractiveView({
                     totalCount: totalScenarios
                   }
                 ),
-                /* @__PURE__ */ jsxs24("div", { className: "flex shrink-0 gap-1", children: [
-                  /* @__PURE__ */ jsx36(
+                /* @__PURE__ */ jsxs27("div", { className: "flex shrink-0 gap-1", children: [
+                  /* @__PURE__ */ jsx39(
                     "button",
                     {
                       type: "button",
@@ -1806,7 +2098,7 @@ function ReportInteractiveView({
                       children: "Expand all"
                     }
                   ),
-                  /* @__PURE__ */ jsx36(
+                  /* @__PURE__ */ jsx39(
                     "button",
                     {
                       type: "button",
@@ -1816,7 +2108,7 @@ function ReportInteractiveView({
                       children: "Collapse all"
                     }
                   ),
-                  /* @__PURE__ */ jsx36(
+                  /* @__PURE__ */ jsx39(
                     "button",
                     {
                       type: "button",
@@ -1826,7 +2118,7 @@ function ReportInteractiveView({
                       children: detail === "full" ? "Hide docs" : "Show docs"
                     }
                   ),
-                  /* @__PURE__ */ jsx36(
+                  /* @__PURE__ */ jsx39(
                     "button",
                     {
                       type: "button",
@@ -1838,7 +2130,7 @@ function ReportInteractiveView({
                   )
                 ] })
               ] }),
-              /* @__PURE__ */ jsx36(
+              /* @__PURE__ */ jsx39(
                 ReportFilters,
                 {
                   statuses: statusOptions,
@@ -1850,12 +2142,12 @@ function ReportInteractiveView({
                 }
               )
             ] }),
-            /* @__PURE__ */ jsx36(ReportFailureBanner, { failures }),
-            hasContent ? /* @__PURE__ */ jsxs24("div", { className: "flex gap-6", children: [
-              /* @__PURE__ */ jsx36(ReportToc, {}),
-              /* @__PURE__ */ jsx36("div", { className: "flex min-w-0 flex-1 flex-col gap-4", children: /* @__PURE__ */ jsx36(ReportFeatureList, {}) })
-            ] }) : /* @__PURE__ */ jsx36(ReportEmpty, { message: query ? "No scenarios match the search." : void 0 }),
-            /* @__PURE__ */ jsx36(
+            /* @__PURE__ */ jsx39(ReportFailureBanner, { failures }),
+            hasContent ? /* @__PURE__ */ jsxs27("div", { className: "flex gap-6", children: [
+              /* @__PURE__ */ jsx39(ReportToc, {}),
+              /* @__PURE__ */ jsx39("div", { className: "flex min-w-0 flex-1 flex-col gap-4", children: /* @__PURE__ */ jsx39(ReportFeatureList, {}) })
+            ] }) : /* @__PURE__ */ jsx39(ReportEmpty, { message: query ? "No scenarios match the search." : void 0 }),
+            /* @__PURE__ */ jsx39(
               "button",
               {
                 type: "button",
@@ -1866,8 +2158,8 @@ function ReportInteractiveView({
                 children: "?"
               }
             ),
-            /* @__PURE__ */ jsx36(ReportShortcutsHelp, { open: helpOpen, onClose: () => setHelpOpen(false) }),
-            toast ? /* @__PURE__ */ jsx36(
+            /* @__PURE__ */ jsx39(ReportShortcutsHelp, { open: helpOpen, onClose: () => setHelpOpen(false) }),
+            toast ? /* @__PURE__ */ jsx39(
               "div",
               {
                 role: "status",
@@ -1880,18 +2172,18 @@ function ReportInteractiveView({
         }
       )
     }
-  ) }) });
+  ) }) }) });
 }
 
 // src/interactive/ReportInteractiveIsland.tsx
 import { useMemo as useMemo4 } from "react";
 
 // src/interactive/island-renderers.tsx
-import { createElement, useEffect as useEffect7, useState as useState6 } from "react";
+import { createElement, useEffect as useEffect8, useState as useState7 } from "react";
 
 // src/components/doc/MermaidView.tsx
-import { useEffect as useEffect6, useRef as useRef4, useState as useState5 } from "react";
-import { jsx as jsx37, jsxs as jsxs25 } from "react/jsx-runtime";
+import { useEffect as useEffect7, useRef as useRef4, useState as useState6 } from "react";
+import { jsx as jsx40, jsxs as jsxs28 } from "react/jsx-runtime";
 function prefersDark(el) {
   const themed = el?.closest("[data-theme]");
   if (themed?.dataset.theme === "dark") return true;
@@ -1900,8 +2192,8 @@ function prefersDark(el) {
 }
 function MermaidView({ entry, load }) {
   const ref = useRef4(null);
-  const [svg, setSvg] = useState5(null);
-  useEffect6(() => {
+  const [svg, setSvg] = useState6(null);
+  useEffect7(() => {
     let cancelled = false;
     const draw = async () => {
       try {
@@ -1928,9 +2220,9 @@ function MermaidView({ entry, load }) {
     };
   }, [entry.code, load]);
   if (svg) {
-    return /* @__PURE__ */ jsxs25("figure", { ref, className: "my-3", children: [
-      entry.title ? /* @__PURE__ */ jsx37("figcaption", { className: "mb-1.5 text-xs font-medium text-muted-foreground", children: entry.title }) : null,
-      /* @__PURE__ */ jsx37(
+    return /* @__PURE__ */ jsxs28("figure", { ref, className: "my-3", children: [
+      entry.title ? /* @__PURE__ */ jsx40("figcaption", { className: "mb-1.5 text-xs font-medium text-muted-foreground", children: entry.title }) : null,
+      /* @__PURE__ */ jsx40(
         "div",
         {
           role: "img",
@@ -1941,11 +2233,11 @@ function MermaidView({ entry, load }) {
       )
     ] });
   }
-  return /* @__PURE__ */ jsx37(MermaidSource, { entry, ref });
+  return /* @__PURE__ */ jsx40(MermaidSource, { entry, ref });
 }
 
 // src/interactive/island-renderers.tsx
-import { jsx as jsx38 } from "react/jsx-runtime";
+import { jsx as jsx41 } from "react/jsx-runtime";
 var HLJS_ESM = "https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/es/highlight.min.js";
 var MERMAID_ESM = "https://cdn.jsdelivr.net/npm/mermaid@10/dist/mermaid.esm.min.mjs";
 function cachedCdnModule(url) {
@@ -1962,8 +2254,8 @@ function cachedCdnModule(url) {
 var loadMermaidFromCdn = cachedCdnModule(MERMAID_ESM);
 var loadHljs = cachedCdnModule(HLJS_ESM);
 function CdnHighlightedCode({ entry }) {
-  const [html, setHtml] = useState6(null);
-  useEffect7(() => {
+  const [html, setHtml] = useState7(null);
+  useEffect8(() => {
     let cancelled = false;
     void (async () => {
       try {
@@ -1979,13 +2271,13 @@ function CdnHighlightedCode({ entry }) {
       cancelled = true;
     };
   }, [entry.content, entry.lang]);
-  return /* @__PURE__ */ jsx38(CodeFigure, { label: entry.label, children: html !== null ? /* @__PURE__ */ jsx38(
+  return /* @__PURE__ */ jsx41(CodeFigure, { label: entry.label, children: html !== null ? /* @__PURE__ */ jsx41(
     "code",
     {
       className: cn("hljs font-mono text-xs", entry.lang && `language-${entry.lang}`),
       dangerouslySetInnerHTML: { __html: html }
     }
-  ) : /* @__PURE__ */ jsx38("code", { className: cn("font-mono text-xs", entry.lang && `language-${entry.lang}`), children: entry.content }) });
+  ) : /* @__PURE__ */ jsx41("code", { className: cn("font-mono text-xs", entry.lang && `language-${entry.lang}`), children: entry.content }) });
 }
 function buildIslandRenderers(opts) {
   const renderers = {};
@@ -1999,7 +2291,7 @@ function buildIslandRenderers(opts) {
 }
 
 // src/interactive/ReportInteractiveIsland.tsx
-import { jsx as jsx39 } from "react/jsx-runtime";
+import { jsx as jsx42 } from "react/jsx-runtime";
 function ReportInteractiveIsland({
   report,
   title,
@@ -2012,7 +2304,7 @@ function ReportInteractiveIsland({
     () => buildIslandRenderers({ syntaxHighlighting, mermaid }),
     [syntaxHighlighting, mermaid]
   );
-  return /* @__PURE__ */ jsx39(
+  return /* @__PURE__ */ jsx42(
     ReportInteractive,
     {
       report,
@@ -2025,6 +2317,7 @@ function ReportInteractiveIsland({
 }
 export {
   ReportFailureBanner,
+  ReportFreshness,
   ReportInteractive,
   ReportInteractiveIsland,
   ReportSearch,