@reportforge/playwright-pdf 0.25.0 → 0.26.1

package/README.md

@@ -58,6 +58,7 @@ Three templates, one reporter. Every PDF is fully offline: fonts, charts, and sc
 - **Notifications**: post pass/fail summaries to Slack, Teams, Discord, or email after each run; configurable trigger (`always` / `failure` / `success`) per channel; email and Discord support optional PDF attachment via `attachPdf`
 - **Flakiness trend**: top-N flakiest tests table with per-test dot sparkline across stored history runs in the `detailed` template; `flakinessTopN` option (default 5, `0` disables)
 - **Pass-rate trend**: cross-run trend chart from stored history; opt-in `remoteHistory` keeps the trend alive on ephemeral CI runners by storing aggregate numbers only (pass rate, counts, duration, verdict; no test titles or error text, and the branch name never travels in plaintext), with no extra network calls
+- **Run-over-run diff**: every report shows what changed since the previous run on the same branch: new failures, fixed tests, and still-failing tests, and the same summary rides along in Slack, Teams, Discord, and email notifications
 - **Offline failure analysis**: sorts each failure into one of 7 root-cause buckets and renders a root-cause chip under each failed test in the `detailed` PDF (dominant-cause one-liner in `executive`). No network, no AI service: a small embedded classifier with automatic updates; pin it any time. Full details at [reportforge.org/docs/advanced/failure-analysis](https://reportforge.org/docs/advanced/failure-analysis).
 - **On-device training**: teach the classifier your team's failures without any data leaving your machine. Label locally-collected samples (`npx @reportforge/playwright-pdf label-feedback`), then `train-model` trains and cross-validates a personal layer on-device; it activates only when it measurably beats the base model on your own labeled set (`evaluate-model` shows the comparison any time). Commit the model file to your repo via `failureAnalysis.localModelPath` to share it with CI. Training data, the trained model, and evaluation are all local files; the analysis code cannot even name a network primitive (enforced by an automated source audit).
 - `npx @reportforge/playwright-pdf export-feedback`: merges your locally-collected feedback (tokenized + redacted) into one CSV for review or moving between machines. Local file only; there is no upload.
@@ -213,7 +214,7 @@ All options are the second element of the reporter tuple.
 | `slowTestThreshold` | `number` | `10` | Minimum timed-test count before `SLOW` badges appear in the suite breakdown: below this, every test is trivially the "slowest" so badges stay hidden. On larger runs only genuine outliers (at least 2× the median test duration) are badged, so the badge stays rare. Set to `0` to drop the run-size gate (outliers still required). |
 | `requirementTagPattern` | `string` | `'^@?[A-Z][A-Z0-9]*-\\d+$'` | Regex deciding which tags count as requirement IDs in the Requirements Traceability section (`detailed` template). Matching tags (ticket shapes like `@ODP-5328`, `REQ-001`) get the traceability matrix; everything else (`@regression`, `@sanity`) collapses into a compact tag summary instead of repeating identical rows. Set to `''` to disable the split and list every tag in the matrix. |
 | `templatePath` | `string \| string[]` | n/a | Path to a custom Handlebars (`.hbs`) template file. Takes precedence over `template`. Pass an array to generate one PDF per custom template. See the Custom Templates docs. |
-| `sections` | `object` | per-template | Override which report sections appear, on top of the chosen template's defaults. Flat keys are the baseline for every chosen template; per-template keys (`minimal`\|`detailed`\|`executive`) override per template. Block toggles: `coverPage`, `analysisOneliner`, `releaseGate`, `summary`, `charts`, `trend`, `requirementsMatrix`, `ciEnvironment`, `suiteBreakdown`, `failureDeepDive`, `failureAnalysis`, `slowTests`, `defectLog`, `briefBand`. Display modifiers: `passRate`, `fullEnvironment`, `retries`, `fullFailures`, `stackTraces`. See the Report Sections docs. |
+| `sections` | `object` | per-template | Override which report sections appear, on top of the chosen template's defaults. Flat keys are the baseline for every chosen template; per-template keys (`minimal`\|`detailed`\|`executive`) override per template. 20 keys total. Block toggles: `coverPage`, `analysisOneliner`, `releaseGate`, `summary`, `charts`, `trend`, `requirementsMatrix`, `ciEnvironment`, `suiteBreakdown`, `failureDeepDive`, `failureAnalysis`, `slowTests`, `defectLog`, `briefBand`, `runDiff`. Display modifiers: `passRate`, `fullEnvironment`, `retries`, `fullFailures`, `stackTraces`. `runDiff` (block toggle, on by default in all three templates) shows new failures, fixed tests, and still-failing tests compared with the previous run on the same branch. See the Report Sections docs. |
 <!-- AUTOGEN:options-table END -->
 
 Full reference: [reportforge.org/docs/configuration](https://reportforge.org/docs/configuration).
@@ -316,7 +317,7 @@ The `on` trigger controls when the message fires:
 
 **PDF attachment** (`attachPdf: true`) is available on `email` and `discord`: Slack and Teams webhooks cannot carry file uploads. On Discord the PDF is uploaded with the message; if the upload fails or the PDF exceeds Discord's file-size cap, the summary still posts without the attachment. With multiple templates, the first PDF is attached.
 
-The summary includes pass rate, test counts, duration, and the report filename. Notifications require a valid license and fire after PDF generation (or after a PDF failure; you still get the ping).
+The summary includes pass rate, test counts, duration, and the report filename. When a previous run on the same branch exists, the message also carries a run-over-run diff line: new failures, fixed tests, and tests still failing. Notifications require a valid license and fire after PDF generation (or after a PDF failure; you still get the ping).
 
 ### Data Protection
 
@@ -364,6 +365,8 @@ Full details at [reportforge.org/docs/advanced/security](https://reportforge.org
 
 After each run the reporter appends a summary entry to a local JSON file and renders a pass-rate sparkline + verdict row in the `detailed` template.
 
+**Since Last Run**: every report also gets a section (`runDiff`, on by default in all three templates) comparing the current run against the previous run on the same branch: new failures, fixed tests, and tests still failing, with the same summary line carried into Slack, Teams, Discord, and email notifications. The first run after upgrading has no comparable prior run to diff against, so the section starts appearing from the second run onward. It reads only the local history file, so test names never leave your machine; see the ephemeral-CI note below for keeping that file around between runs. Like the flakiness table, it rides history tracking (`showTrend`, on by default), and the notification line follows history availability rather than the `runDiff` section toggle.
+
 **Local dev (zero config)**: history is written automatically to `~/.reportforge/{projectKey}/history.json`. The sparkline appears once two or more runs have been recorded.
 
 **CI with ephemeral runners (recommended)**: enable the server-side trend store; the local file is wiped with the workspace, leaving the chart stuck at one data point:
@@ -375,7 +378,7 @@ reporter: [['@reportforge/playwright-pdf', {
 }]]
 ```
 
-One small authenticated request per run, carrying aggregate numbers only (pass rate, counts, duration, verdict; no test titles, no error text, and the branch name never travels in plaintext). The server keeps roughly the last 100 runs per project + branch, expiring after 180 days, and returns them for the chart; any failure falls back to the local file. The flakiness table stays local-only by design (it needs test titles, which never leave your machine). Bitbucket Pipelines users especially: Bitbucket caches are immutable once written, so `remoteHistory` is the practical path there.
+One small authenticated request per run, carrying aggregate numbers only (pass rate, counts, duration, verdict; no test titles, no error text, and the branch name never travels in plaintext). The server keeps roughly the last 100 runs per project + branch, expiring after 180 days, and returns them for the chart; any failure falls back to the local file. This feeds the trend chart only: the flakiness table and the Since Last Run diff both stay local-only by design (they need test titles, which never leave your machine); to keep either alive on ephemeral runners, use the CI caching alternative below to persist `historyFile` instead. Bitbucket Pipelines users especially: Bitbucket caches are immutable once written, so `remoteHistory` is the practical path for the trend chart there.
 
 **CI caching alternative** (keeps even aggregate numbers off the server): set `historyFile` to a project-relative path and cache it between runs:
 

package/dist/cli/index.js

@@ -311,6 +311,24 @@ function buildDemoCharts(passed, failed, skipped, flaky, total) {
     ]
   };
 }
+function buildDemoRunDiff() {
+  return {
+    newFailures: [
+      { id: "auth-5", title: "should block brute-force attempts after 5 tries" },
+      { id: "cat-7", title: "should lazy-load images on scroll" }
+    ],
+    stillFailing: [
+      { id: "co-3", title: "should reject expired promo code" }
+    ],
+    fixed: [
+      { id: "co-5", title: "should complete Stripe checkout" }
+    ],
+    noLongerRun: [],
+    baselineRunId: "demo-1d",
+    baselineTimestamp: DEMO_BASE_TS - 864e5,
+    baselineTruncated: false
+  };
+}
 function buildDemoReportData(template = "detailed") {
   const projects = [
     makeProject("chromium", [
@@ -362,7 +380,8 @@ function buildDemoReportData(template = "detailed") {
       projectCount: 2,
       workerCount: 4
     },
-    charts
+    charts,
+    runDiff: buildDemoRunDiff()
   };
 }
 var DEMO_BASE_TS, DEMO_LICENSE_INFO, DEMO_AUTH_TESTS, DEMO_CHECKOUT_TESTS, DEMO_CATALOG_TESTS;
@@ -6498,6 +6517,7 @@ var init_sections = __esm({
       "slowTests",
       "defectLog",
       "briefBand",
+      "runDiff",
       // display modifiers
       "passRate",
       "fullEnvironment",
@@ -6521,6 +6541,7 @@ var init_sections = __esm({
         slowTests: false,
         defectLog: false,
         briefBand: false,
+        runDiff: true,
         passRate: true,
         fullEnvironment: false,
         retries: true,
@@ -6542,6 +6563,7 @@ var init_sections = __esm({
         slowTests: true,
         defectLog: true,
         briefBand: false,
+        runDiff: true,
         passRate: true,
         fullEnvironment: true,
         retries: true,
@@ -6568,6 +6590,7 @@ var init_sections = __esm({
         slowTests: true,
         defectLog: false,
         briefBand: true,
+        runDiff: true,
         passRate: true,
         fullEnvironment: false,
         retries: false,

package/dist/index.d.mts

@@ -1,11 +1,11 @@
 import { Reporter, FullConfig, Suite, TestCase, TestResult, TestStep, FullResult } from '@playwright/test/reporter';
 
 /**
- * Canonical section catalog. 14 block toggles (section present/absent) followed
+ * Canonical section catalog. 15 block toggles (section present/absent) followed
  * by 5 display modifiers (tweak a section that is on). Single source of truth —
  * the Zod schema in src/config/schema.ts builds its flag shape from this array.
  */
-declare const SECTION_KEYS: readonly ["coverPage", "analysisOneliner", "releaseGate", "summary", "charts", "trend", "requirementsMatrix", "ciEnvironment", "suiteBreakdown", "failureDeepDive", "failureAnalysis", "slowTests", "defectLog", "briefBand", "passRate", "fullEnvironment", "retries", "fullFailures", "stackTraces"];
+declare const SECTION_KEYS: readonly ["coverPage", "analysisOneliner", "releaseGate", "summary", "charts", "trend", "requirementsMatrix", "ciEnvironment", "suiteBreakdown", "failureDeepDive", "failureAnalysis", "slowTests", "defectLog", "briefBand", "runDiff", "passRate", "fullEnvironment", "retries", "fullFailures", "stackTraces"];
 type SectionKey = (typeof SECTION_KEYS)[number];
 /** A partial map of section flags — used both as the flat baseline and per-template. */
 type SectionFlags = Partial<Record<SectionKey, boolean>>;
@@ -406,12 +406,18 @@ interface ReporterOptions {
      * every chosen template; per-template keys (`minimal` / `detailed` /
      * `executive`) override the baseline for that template only.
      *
+     * 20 keys total: 15 block toggles, 5 display modifiers.
+     *
      * Block toggles: `coverPage`, `analysisOneliner`, `releaseGate`, `summary`,
      * `charts`, `trend`, `requirementsMatrix`, `ciEnvironment`, `suiteBreakdown`,
-     * `failureDeepDive`, `failureAnalysis`, `slowTests`, `defectLog`, `briefBand`.
+     * `failureDeepDive`, `failureAnalysis`, `slowTests`, `defectLog`, `briefBand`,
+     * `runDiff`.
      * Display modifiers: `passRate`, `fullEnvironment`, `retries`, `fullFailures`,
      * `stackTraces`.
      *
+     * `runDiff` shows new failures, fixed tests, and still-failing tests against
+     * the previous run on the same branch; on by default in all three templates.
+     *
      * `trend` renders only when `charts` is also on and history data exists (`showTrend` enabled). Sections gated on data
      * (`failureAnalysis`, `requirementsMatrix`, `slowTests`, `defectLog`) appear
      * only when matching data exists — this option never changes data collection.

package/dist/index.d.ts

@@ -1,11 +1,11 @@
 import { Reporter, FullConfig, Suite, TestCase, TestResult, TestStep, FullResult } from '@playwright/test/reporter';
 
 /**
- * Canonical section catalog. 14 block toggles (section present/absent) followed
+ * Canonical section catalog. 15 block toggles (section present/absent) followed
  * by 5 display modifiers (tweak a section that is on). Single source of truth —
  * the Zod schema in src/config/schema.ts builds its flag shape from this array.
  */
-declare const SECTION_KEYS: readonly ["coverPage", "analysisOneliner", "releaseGate", "summary", "charts", "trend", "requirementsMatrix", "ciEnvironment", "suiteBreakdown", "failureDeepDive", "failureAnalysis", "slowTests", "defectLog", "briefBand", "passRate", "fullEnvironment", "retries", "fullFailures", "stackTraces"];
+declare const SECTION_KEYS: readonly ["coverPage", "analysisOneliner", "releaseGate", "summary", "charts", "trend", "requirementsMatrix", "ciEnvironment", "suiteBreakdown", "failureDeepDive", "failureAnalysis", "slowTests", "defectLog", "briefBand", "runDiff", "passRate", "fullEnvironment", "retries", "fullFailures", "stackTraces"];
 type SectionKey = (typeof SECTION_KEYS)[number];
 /** A partial map of section flags — used both as the flat baseline and per-template. */
 type SectionFlags = Partial<Record<SectionKey, boolean>>;
@@ -406,12 +406,18 @@ interface ReporterOptions {
      * every chosen template; per-template keys (`minimal` / `detailed` /
      * `executive`) override the baseline for that template only.
      *
+     * 20 keys total: 15 block toggles, 5 display modifiers.
+     *
      * Block toggles: `coverPage`, `analysisOneliner`, `releaseGate`, `summary`,
      * `charts`, `trend`, `requirementsMatrix`, `ciEnvironment`, `suiteBreakdown`,
-     * `failureDeepDive`, `failureAnalysis`, `slowTests`, `defectLog`, `briefBand`.
+     * `failureDeepDive`, `failureAnalysis`, `slowTests`, `defectLog`, `briefBand`,
+     * `runDiff`.
      * Display modifiers: `passRate`, `fullEnvironment`, `retries`, `fullFailures`,
      * `stackTraces`.
      *
+     * `runDiff` shows new failures, fixed tests, and still-failing tests against
+     * the previous run on the same branch; on by default in all three templates.
+     *
      * `trend` renders only when `charts` is also on and history data exists (`showTrend` enabled). Sections gated on data
      * (`failureAnalysis`, `requirementsMatrix`, `slowTests`, `defectLog`) appear
      * only when matching data exists — this option never changes data collection.

package/dist/index.js

@@ -10354,6 +10354,7 @@ var SECTION_KEYS = [
   "slowTests",
   "defectLog",
   "briefBand",
+  "runDiff",
   // display modifiers
   "passRate",
   "fullEnvironment",
@@ -10377,6 +10378,7 @@ var SECTION_DEFAULTS = {
     slowTests: false,
     defectLog: false,
     briefBand: false,
+    runDiff: true,
     passRate: true,
     fullEnvironment: false,
     retries: true,
@@ -10398,6 +10400,7 @@ var SECTION_DEFAULTS = {
     slowTests: true,
     defectLog: true,
     briefBand: false,
+    runDiff: true,
     passRate: true,
     fullEnvironment: true,
     retries: true,
@@ -10424,6 +10427,7 @@ var SECTION_DEFAULTS = {
     slowTests: true,
     defectLog: false,
     briefBand: true,
+    runDiff: true,
     passRate: true,
     fullEnvironment: false,
     retries: false,
@@ -13783,6 +13787,9 @@ function buildBranchHash(branch) {
 async function appendRemoteHistory(opts) {
   const numericEntry = { ...opts.entry };
   delete numericEntry.flakyTests;
+  delete numericEntry.failedTests;
+  delete numericEntry.failedTestsTruncated;
+  delete numericEntry.branch;
   const controller = new AbortController();
   const timeout = setTimeout(() => controller.abort(), NETWORK_TIMEOUT_MS2);
   try {
@@ -13812,6 +13819,58 @@ async function appendRemoteHistory(opts) {
   }
 }
 
+// src/history/types.ts
+init_cjs_shims();
+var FAILED_TESTS_CAP = 300;
+
+// src/history/RunDiff.ts
+init_cjs_shims();
+function splitCurrentFailing(currentFailing, baselineFailed) {
+  const currentFailedIds = /* @__PURE__ */ new Set();
+  const newFailures = [];
+  const stillFailing = [];
+  for (const item of currentFailing) {
+    if (currentFailedIds.has(item.id)) continue;
+    currentFailedIds.add(item.id);
+    (baselineFailed.has(item.id) ? stillFailing : newFailures).push(item);
+  }
+  return { newFailures, stillFailing, currentFailedIds };
+}
+function splitBaselineResolved(baselineFailed, currentFailedIds, currentStatuses) {
+  const fixed = [];
+  const noLongerRun = [];
+  for (const [id, title] of baselineFailed) {
+    if (currentFailedIds.has(id)) continue;
+    const status = currentStatuses.get(id);
+    const bucket = status === "passed" || status === "flaky" ? fixed : noLongerRun;
+    bucket.push({ id, title });
+  }
+  return { fixed, noLongerRun };
+}
+function computeRunDiff(args) {
+  const { currentFailing, currentStatuses, priorEntries, branch } = args;
+  const baseline = priorEntries.find((e) => e.branch === branch && Array.isArray(e.failedTests));
+  if (!baseline) return null;
+  const baselineFailed = /* @__PURE__ */ new Map();
+  for (const item of baseline.failedTests) {
+    if (!baselineFailed.has(item.id)) baselineFailed.set(item.id, item.title);
+  }
+  const { newFailures, stillFailing, currentFailedIds } = splitCurrentFailing(currentFailing, baselineFailed);
+  const { fixed, noLongerRun } = splitBaselineResolved(baselineFailed, currentFailedIds, currentStatuses);
+  for (const bucket of [newFailures, stillFailing, fixed, noLongerRun]) {
+    bucket.sort((a, b) => a.title.localeCompare(b.title));
+  }
+  return {
+    newFailures,
+    stillFailing,
+    fixed,
+    noLongerRun,
+    baselineRunId: baseline.runId,
+    baselineTimestamp: baseline.timestamp,
+    baselineTruncated: baseline.failedTestsTruncated === true
+  };
+}
+
 // src/history/FlakinessAnalyser.ts
 init_cjs_shims();
 function computeTopN(entries, topN) {
@@ -13888,11 +13947,32 @@ function reportName(pdfPaths, reportTitle) {
   if (pdfPaths.length > 0) return (0, import_path9.basename)(pdfPaths[0]);
   return reportTitle || "ReportForge";
 }
+function formatDiffLine(diff) {
+  if (!diff) return null;
+  const newFailures = diff.newFailures.length;
+  const fixed = diff.fixed.length;
+  const stillFailing = diff.stillFailing.length;
+  const noLongerRun = diff.noLongerRun.length;
+  const parts = [
+    `${newFailures} new ${newFailures === 1 ? "failure" : "failures"}`,
+    `${fixed} fixed`,
+    `${stillFailing} still failing`
+  ];
+  if (noLongerRun > 0) parts.push(`${noLongerRun} no longer run`);
+  return parts.join(" \xB7 ");
+}
 
 // src/notify/formatters/slack.ts
-function buildSlackPayload(stats, pdfPaths, reportTitle) {
+function buildSlackPayload(stats, pdfPaths, reportTitle, runDiff) {
   const label = statusLabel(stats.verdict);
   const name = reportName(pdfPaths, reportTitle);
+  const diffLine = formatDiffLine(runDiff);
+  const lines = [
+    `*${label}* \xB7 ${stats.passRate}% passed`,
+    countsLine(stats),
+    ...diffLine ? [diffLine] : [],
+    `_${name}_`
+  ];
   return {
     text: `${label} \xB7 ${stats.passRate}% passed`,
     blocks: [
@@ -13900,9 +13980,7 @@ function buildSlackPayload(stats, pdfPaths, reportTitle) {
         type: "section",
         text: {
           type: "mrkdwn",
-          text: `*${label}* \xB7 ${stats.passRate}% passed
-${countsLine(stats)}
-_${name}_`
+          text: lines.join("\n")
         }
       }
     ]
@@ -13927,9 +14005,37 @@ function buildTeamsSimpleMessage(text) {
     ]
   };
 }
-function buildTeamsPayload(stats, pdfPaths, reportTitle) {
+function buildTeamsPayload(stats, pdfPaths, reportTitle, runDiff) {
   const label = statusLabel(stats.verdict);
   const name = reportName(pdfPaths, reportTitle);
+  const diffLine = formatDiffLine(runDiff);
+  const body = [
+    {
+      type: "TextBlock",
+      text: `${label} \xB7 ${stats.passRate}% passed`,
+      weight: "bolder",
+      size: "medium"
+    },
+    {
+      type: "TextBlock",
+      text: countsLine(stats),
+      isSubtle: true
+    },
+    {
+      type: "TextBlock",
+      text: name,
+      isSubtle: true,
+      spacing: "none"
+    }
+  ];
+  if (diffLine) {
+    body.push({
+      type: "TextBlock",
+      text: diffLine,
+      isSubtle: true,
+      spacing: "none"
+    });
+  }
   return {
     type: "message",
     attachments: [
@@ -13939,25 +14045,7 @@ function buildTeamsPayload(stats, pdfPaths, reportTitle) {
           $schema: "http://adaptivecards.io/schemas/adaptive-card.json",
           type: "AdaptiveCard",
           version: "1.4",
-          body: [
-            {
-              type: "TextBlock",
-              text: `${label} \xB7 ${stats.passRate}% passed`,
-              weight: "bolder",
-              size: "medium"
-            },
-            {
-              type: "TextBlock",
-              text: countsLine(stats),
-              isSubtle: true
-            },
-            {
-              type: "TextBlock",
-              text: name,
-              isSubtle: true,
-              spacing: "none"
-            }
-          ]
+          body
         }
       }
     ]
@@ -13966,16 +14054,17 @@ function buildTeamsPayload(stats, pdfPaths, reportTitle) {
 
 // src/notify/formatters/discord.ts
 init_cjs_shims();
-function buildDiscordPayload(stats, pdfPaths, reportTitle) {
+function buildDiscordPayload(stats, pdfPaths, reportTitle, runDiff) {
   const label = statusLabel(stats.verdict);
   const name = reportName(pdfPaths, reportTitle);
   const color = stats.verdict === "passed" ? 3066993 : 15158332;
+  const diffLine = formatDiffLine(runDiff);
+  const descriptionLines = [countsLine(stats), ...diffLine ? [diffLine] : [], name];
   return {
     embeds: [
       {
         title: `${label} \xB7 ${stats.passRate}% passed`,
-        description: `${countsLine(stats)}
-${name}`,
+        description: descriptionLines.join("\n"),
         color
       }
     ]
@@ -13989,10 +14078,16 @@ var import_path10 = require("path");
 
 // src/notify/formatters/email.ts
 init_cjs_shims();
-function buildEmailContent(stats, pdfPaths, reportTitle) {
+function buildEmailContent(stats, pdfPaths, reportTitle, runDiff) {
   const label = statusLabel(stats.verdict);
-  const subject = `[ReportForge] ${label} \u2014 ${stats.passRate}% passed`;
+  const subject = `[ReportForge] ${label} \xB7 ${stats.passRate}% passed`;
   const name = reportName(pdfPaths, reportTitle);
+  const diffLine = formatDiffLine(runDiff);
+  const diffRow = diffLine ? `
+    <tr>
+      <td style="padding:8px 12px;border-top:1px solid #e5e5e5">Since last run</td>
+      <td style="padding:8px 12px;border-top:1px solid #e5e5e5;text-align:right">${escHtml(diffLine)}</td>
+    </tr>` : "";
   const html = `<!DOCTYPE html>
 <html lang="en">
 <head><meta charset="utf-8"><title>${escHtml(subject)}</title></head>
@@ -14027,7 +14122,7 @@ function buildEmailContent(stats, pdfPaths, reportTitle) {
     <tr style="background:#f9f9f9">
       <td style="padding:8px 12px;border-top:1px solid #e5e5e5">Duration</td>
       <td style="padding:8px 12px;border-top:1px solid #e5e5e5;text-align:right">${escHtml(countsLine(stats).split(" \xB7 ").pop() ?? "")}</td>
-    </tr>
+    </tr>${diffRow}
   </table>
   <p style="margin:24px 0 0;color:#888;font-size:12px">Sent by ReportForge \xB7 <a href="https://reportforge.org" style="color:#888">reportforge.org</a></p>
 </body>
@@ -14052,7 +14147,8 @@ var EmailSender = class {
     const { subject, html } = buildEmailContent(
       reportData.stats,
       pdfPaths,
-      reportData.meta.title ?? ""
+      reportData.meta.title ?? "",
+      reportData.runDiff
     );
     const body = { from, to: config.to, subject, html };
     if (config.attachPdf && pdfPaths.length > 0) {
@@ -14116,7 +14212,7 @@ var NotificationSender = class {
           result.skipped.push(name);
           return Promise.resolve();
         }
-        const payload = FORMATTERS[name](reportData.stats, pdfPaths, reportTitle);
+        const payload = FORMATTERS[name](reportData.stats, pdfPaths, reportTitle, reportData.runDiff);
         if (name === "discord" && notifyConfig.discord?.attachPdf && pdfPaths.length > 0) {
           return this.postDiscordWithPdf(channel.url, payload, pdfPaths[0], result);
         }
@@ -14859,7 +14955,7 @@ var PdfReporter = class {
     if (this.options.redact.enabled) {
       this.redactor = new Redactor(this.options.redact);
     }
-    this.version = true ? "0.25.0" : "0.x";
+    this.version = true ? "0.26.1" : "0.x";
     logger.info(`@reportforge/playwright-pdf v${this.version} initialised`);
     this.licenseClient = new LicenseClient({
       licenseKey: this.options.licenseKey,
@@ -14988,6 +15084,7 @@ var PdfReporter = class {
     const flakyTests = collectFlakyTests(collected.projects).map(
       (t) => redactor ? { ...t, title: redactor.redactText(t.title) } : t
     );
+    const { redactedFailing, ...failedTestsFields } = buildFailedTestsFields(collected.projects, redactor);
     const entry = {
       runId: `${(/* @__PURE__ */ new Date()).toISOString()}-${suffix}`,
       timestamp: Date.now(),
@@ -14998,9 +15095,12 @@ var PdfReporter = class {
       flaky: collected.stats.flaky,
       duration: collected.stats.duration,
       verdict: deriveVerdict(collected.stats),
-      flakyTests
+      flakyTests,
+      ...failedTestsFields,
+      branch: collected.environment.branch
     };
     const localEntries = hm.append(entry, this.options.historySize);
+    collected.runDiff = resolveRunDiff(collected.projects, redactedFailing, localEntries.slice(1), collected.environment.branch);
     let trendEntries = localEntries;
     if (this.options.remoteHistory && licenseInfo.jwt) {
       const serverUrl = this.options.serverUrl ?? process.env.REPORTFORGE_SERVER_URL ?? DEFAULT_SERVER_URL2;
@@ -15040,7 +15140,7 @@ var PdfReporter = class {
     }
   }
   _buildReportData(collected, licenseInfo) {
-    const { projects, stats, failures, environment, charts } = collected;
+    const { projects, stats, failures, environment, charts, runDiff } = collected;
     const projectName = this.options.projectName ?? this.resolveProjectName();
     const firstTemplate = this.options.templatePath?.length ? "detailed" : Array.isArray(this.options.template) ? this.options.template[0] : this.options.template;
     return {
@@ -15060,7 +15160,8 @@ var PdfReporter = class {
       projects,
       failures,
       environment,
-      charts
+      charts,
+      runDiff
     };
   }
   printsToStdio() {
@@ -15264,6 +15365,47 @@ function collectFlakyTests(projects) {
   }
   return result;
 }
+function collectFailedTests(projects) {
+  const seen = /* @__PURE__ */ new Set();
+  const result = [];
+  for (const project of projects) {
+    for (const suite of flattenSuiteNodes(project.suites)) {
+      for (const test of suite.tests) {
+        if ((test.status === "failed" || test.status === "timedOut") && !seen.has(test.id)) {
+          seen.add(test.id);
+          result.push({ id: test.id, title: test.fullTitle });
+        }
+      }
+    }
+  }
+  return result;
+}
+function collectCurrentStatuses(projects) {
+  const statuses = /* @__PURE__ */ new Map();
+  for (const project of projects) {
+    for (const suite of flattenSuiteNodes(project.suites)) {
+      for (const test of suite.tests) {
+        statuses.set(test.id, test.status);
+      }
+    }
+  }
+  return statuses;
+}
+function buildFailedTestsFields(projects, redactor) {
+  const redactedFailing = collectFailedTests(projects).map(
+    (t) => redactor ? { ...t, title: redactor.redactText(t.title) } : t
+  );
+  const failedTests = redactedFailing.slice(0, FAILED_TESTS_CAP);
+  return redactedFailing.length > FAILED_TESTS_CAP ? { redactedFailing, failedTests, failedTestsTruncated: true } : { redactedFailing, failedTests };
+}
+function resolveRunDiff(projects, currentFailing, priorEntries, branch) {
+  return computeRunDiff({
+    currentFailing,
+    currentStatuses: collectCurrentStatuses(projects),
+    priorEntries,
+    branch
+  }) ?? void 0;
+}
 
 // src/index.ts
 function defineReporterConfig(options) {

package/dist/index.mjs

@@ -10355,6 +10355,7 @@ var SECTION_KEYS = [
   "slowTests",
   "defectLog",
   "briefBand",
+  "runDiff",
   // display modifiers
   "passRate",
   "fullEnvironment",
@@ -10378,6 +10379,7 @@ var SECTION_DEFAULTS = {
     slowTests: false,
     defectLog: false,
     briefBand: false,
+    runDiff: true,
     passRate: true,
     fullEnvironment: false,
     retries: true,
@@ -10399,6 +10401,7 @@ var SECTION_DEFAULTS = {
     slowTests: true,
     defectLog: true,
     briefBand: false,
+    runDiff: true,
     passRate: true,
     fullEnvironment: true,
     retries: true,
@@ -10425,6 +10428,7 @@ var SECTION_DEFAULTS = {
     slowTests: true,
     defectLog: false,
     briefBand: true,
+    runDiff: true,
     passRate: true,
     fullEnvironment: false,
     retries: false,
@@ -13784,6 +13788,9 @@ function buildBranchHash(branch) {
 async function appendRemoteHistory(opts) {
   const numericEntry = { ...opts.entry };
   delete numericEntry.flakyTests;
+  delete numericEntry.failedTests;
+  delete numericEntry.failedTestsTruncated;
+  delete numericEntry.branch;
   const controller = new AbortController();
   const timeout = setTimeout(() => controller.abort(), NETWORK_TIMEOUT_MS2);
   try {
@@ -13813,6 +13820,58 @@ async function appendRemoteHistory(opts) {
   }
 }
 
+// src/history/types.ts
+init_esm_shims();
+var FAILED_TESTS_CAP = 300;
+
+// src/history/RunDiff.ts
+init_esm_shims();
+function splitCurrentFailing(currentFailing, baselineFailed) {
+  const currentFailedIds = /* @__PURE__ */ new Set();
+  const newFailures = [];
+  const stillFailing = [];
+  for (const item of currentFailing) {
+    if (currentFailedIds.has(item.id)) continue;
+    currentFailedIds.add(item.id);
+    (baselineFailed.has(item.id) ? stillFailing : newFailures).push(item);
+  }
+  return { newFailures, stillFailing, currentFailedIds };
+}
+function splitBaselineResolved(baselineFailed, currentFailedIds, currentStatuses) {
+  const fixed = [];
+  const noLongerRun = [];
+  for (const [id, title] of baselineFailed) {
+    if (currentFailedIds.has(id)) continue;
+    const status = currentStatuses.get(id);
+    const bucket = status === "passed" || status === "flaky" ? fixed : noLongerRun;
+    bucket.push({ id, title });
+  }
+  return { fixed, noLongerRun };
+}
+function computeRunDiff(args) {
+  const { currentFailing, currentStatuses, priorEntries, branch } = args;
+  const baseline = priorEntries.find((e) => e.branch === branch && Array.isArray(e.failedTests));
+  if (!baseline) return null;
+  const baselineFailed = /* @__PURE__ */ new Map();
+  for (const item of baseline.failedTests) {
+    if (!baselineFailed.has(item.id)) baselineFailed.set(item.id, item.title);
+  }
+  const { newFailures, stillFailing, currentFailedIds } = splitCurrentFailing(currentFailing, baselineFailed);
+  const { fixed, noLongerRun } = splitBaselineResolved(baselineFailed, currentFailedIds, currentStatuses);
+  for (const bucket of [newFailures, stillFailing, fixed, noLongerRun]) {
+    bucket.sort((a, b) => a.title.localeCompare(b.title));
+  }
+  return {
+    newFailures,
+    stillFailing,
+    fixed,
+    noLongerRun,
+    baselineRunId: baseline.runId,
+    baselineTimestamp: baseline.timestamp,
+    baselineTruncated: baseline.failedTestsTruncated === true
+  };
+}
+
 // src/history/FlakinessAnalyser.ts
 init_esm_shims();
 function computeTopN(entries, topN) {
@@ -13889,11 +13948,32 @@ function reportName(pdfPaths, reportTitle) {
   if (pdfPaths.length > 0) return basename(pdfPaths[0]);
   return reportTitle || "ReportForge";
 }
+function formatDiffLine(diff) {
+  if (!diff) return null;
+  const newFailures = diff.newFailures.length;
+  const fixed = diff.fixed.length;
+  const stillFailing = diff.stillFailing.length;
+  const noLongerRun = diff.noLongerRun.length;
+  const parts = [
+    `${newFailures} new ${newFailures === 1 ? "failure" : "failures"}`,
+    `${fixed} fixed`,
+    `${stillFailing} still failing`
+  ];
+  if (noLongerRun > 0) parts.push(`${noLongerRun} no longer run`);
+  return parts.join(" \xB7 ");
+}
 
 // src/notify/formatters/slack.ts
-function buildSlackPayload(stats, pdfPaths, reportTitle) {
+function buildSlackPayload(stats, pdfPaths, reportTitle, runDiff) {
   const label = statusLabel(stats.verdict);
   const name = reportName(pdfPaths, reportTitle);
+  const diffLine = formatDiffLine(runDiff);
+  const lines = [
+    `*${label}* \xB7 ${stats.passRate}% passed`,
+    countsLine(stats),
+    ...diffLine ? [diffLine] : [],
+    `_${name}_`
+  ];
   return {
     text: `${label} \xB7 ${stats.passRate}% passed`,
     blocks: [
@@ -13901,9 +13981,7 @@ function buildSlackPayload(stats, pdfPaths, reportTitle) {
         type: "section",
         text: {
           type: "mrkdwn",
-          text: `*${label}* \xB7 ${stats.passRate}% passed
-${countsLine(stats)}
-_${name}_`
+          text: lines.join("\n")
         }
       }
     ]
@@ -13928,9 +14006,37 @@ function buildTeamsSimpleMessage(text) {
     ]
   };
 }
-function buildTeamsPayload(stats, pdfPaths, reportTitle) {
+function buildTeamsPayload(stats, pdfPaths, reportTitle, runDiff) {
   const label = statusLabel(stats.verdict);
   const name = reportName(pdfPaths, reportTitle);
+  const diffLine = formatDiffLine(runDiff);
+  const body = [
+    {
+      type: "TextBlock",
+      text: `${label} \xB7 ${stats.passRate}% passed`,
+      weight: "bolder",
+      size: "medium"
+    },
+    {
+      type: "TextBlock",
+      text: countsLine(stats),
+      isSubtle: true
+    },
+    {
+      type: "TextBlock",
+      text: name,
+      isSubtle: true,
+      spacing: "none"
+    }
+  ];
+  if (diffLine) {
+    body.push({
+      type: "TextBlock",
+      text: diffLine,
+      isSubtle: true,
+      spacing: "none"
+    });
+  }
   return {
     type: "message",
     attachments: [
@@ -13940,25 +14046,7 @@ function buildTeamsPayload(stats, pdfPaths, reportTitle) {
           $schema: "http://adaptivecards.io/schemas/adaptive-card.json",
           type: "AdaptiveCard",
           version: "1.4",
-          body: [
-            {
-              type: "TextBlock",
-              text: `${label} \xB7 ${stats.passRate}% passed`,
-              weight: "bolder",
-              size: "medium"
-            },
-            {
-              type: "TextBlock",
-              text: countsLine(stats),
-              isSubtle: true
-            },
-            {
-              type: "TextBlock",
-              text: name,
-              isSubtle: true,
-              spacing: "none"
-            }
-          ]
+          body
         }
       }
     ]
@@ -13967,16 +14055,17 @@ function buildTeamsPayload(stats, pdfPaths, reportTitle) {
 
 // src/notify/formatters/discord.ts
 init_esm_shims();
-function buildDiscordPayload(stats, pdfPaths, reportTitle) {
+function buildDiscordPayload(stats, pdfPaths, reportTitle, runDiff) {
   const label = statusLabel(stats.verdict);
   const name = reportName(pdfPaths, reportTitle);
   const color = stats.verdict === "passed" ? 3066993 : 15158332;
+  const diffLine = formatDiffLine(runDiff);
+  const descriptionLines = [countsLine(stats), ...diffLine ? [diffLine] : [], name];
   return {
     embeds: [
       {
         title: `${label} \xB7 ${stats.passRate}% passed`,
-        description: `${countsLine(stats)}
-${name}`,
+        description: descriptionLines.join("\n"),
         color
       }
     ]
@@ -13990,10 +14079,16 @@ import { basename as basename2 } from "path";
 
 // src/notify/formatters/email.ts
 init_esm_shims();
-function buildEmailContent(stats, pdfPaths, reportTitle) {
+function buildEmailContent(stats, pdfPaths, reportTitle, runDiff) {
   const label = statusLabel(stats.verdict);
-  const subject = `[ReportForge] ${label} \u2014 ${stats.passRate}% passed`;
+  const subject = `[ReportForge] ${label} \xB7 ${stats.passRate}% passed`;
   const name = reportName(pdfPaths, reportTitle);
+  const diffLine = formatDiffLine(runDiff);
+  const diffRow = diffLine ? `
+    <tr>
+      <td style="padding:8px 12px;border-top:1px solid #e5e5e5">Since last run</td>
+      <td style="padding:8px 12px;border-top:1px solid #e5e5e5;text-align:right">${escHtml(diffLine)}</td>
+    </tr>` : "";
   const html = `<!DOCTYPE html>
 <html lang="en">
 <head><meta charset="utf-8"><title>${escHtml(subject)}</title></head>
@@ -14028,7 +14123,7 @@ function buildEmailContent(stats, pdfPaths, reportTitle) {
     <tr style="background:#f9f9f9">
       <td style="padding:8px 12px;border-top:1px solid #e5e5e5">Duration</td>
       <td style="padding:8px 12px;border-top:1px solid #e5e5e5;text-align:right">${escHtml(countsLine(stats).split(" \xB7 ").pop() ?? "")}</td>
-    </tr>
+    </tr>${diffRow}
   </table>
   <p style="margin:24px 0 0;color:#888;font-size:12px">Sent by ReportForge \xB7 <a href="https://reportforge.org" style="color:#888">reportforge.org</a></p>
 </body>
@@ -14053,7 +14148,8 @@ var EmailSender = class {
     const { subject, html } = buildEmailContent(
       reportData.stats,
       pdfPaths,
-      reportData.meta.title ?? ""
+      reportData.meta.title ?? "",
+      reportData.runDiff
     );
     const body = { from, to: config.to, subject, html };
     if (config.attachPdf && pdfPaths.length > 0) {
@@ -14117,7 +14213,7 @@ var NotificationSender = class {
           result.skipped.push(name);
           return Promise.resolve();
         }
-        const payload = FORMATTERS[name](reportData.stats, pdfPaths, reportTitle);
+        const payload = FORMATTERS[name](reportData.stats, pdfPaths, reportTitle, reportData.runDiff);
         if (name === "discord" && notifyConfig.discord?.attachPdf && pdfPaths.length > 0) {
           return this.postDiscordWithPdf(channel.url, payload, pdfPaths[0], result);
         }
@@ -14860,7 +14956,7 @@ var PdfReporter = class {
     if (this.options.redact.enabled) {
       this.redactor = new Redactor(this.options.redact);
     }
-    this.version = true ? "0.25.0" : "0.x";
+    this.version = true ? "0.26.1" : "0.x";
     logger.info(`@reportforge/playwright-pdf v${this.version} initialised`);
     this.licenseClient = new LicenseClient({
       licenseKey: this.options.licenseKey,
@@ -14989,6 +15085,7 @@ var PdfReporter = class {
     const flakyTests = collectFlakyTests(collected.projects).map(
       (t) => redactor ? { ...t, title: redactor.redactText(t.title) } : t
     );
+    const { redactedFailing, ...failedTestsFields } = buildFailedTestsFields(collected.projects, redactor);
     const entry = {
       runId: `${(/* @__PURE__ */ new Date()).toISOString()}-${suffix}`,
       timestamp: Date.now(),
@@ -14999,9 +15096,12 @@ var PdfReporter = class {
       flaky: collected.stats.flaky,
       duration: collected.stats.duration,
       verdict: deriveVerdict(collected.stats),
-      flakyTests
+      flakyTests,
+      ...failedTestsFields,
+      branch: collected.environment.branch
     };
     const localEntries = hm.append(entry, this.options.historySize);
+    collected.runDiff = resolveRunDiff(collected.projects, redactedFailing, localEntries.slice(1), collected.environment.branch);
     let trendEntries = localEntries;
     if (this.options.remoteHistory && licenseInfo.jwt) {
       const serverUrl = this.options.serverUrl ?? process.env.REPORTFORGE_SERVER_URL ?? DEFAULT_SERVER_URL2;
@@ -15041,7 +15141,7 @@ var PdfReporter = class {
     }
   }
   _buildReportData(collected, licenseInfo) {
-    const { projects, stats, failures, environment, charts } = collected;
+    const { projects, stats, failures, environment, charts, runDiff } = collected;
     const projectName = this.options.projectName ?? this.resolveProjectName();
     const firstTemplate = this.options.templatePath?.length ? "detailed" : Array.isArray(this.options.template) ? this.options.template[0] : this.options.template;
     return {
@@ -15061,7 +15161,8 @@ var PdfReporter = class {
       projects,
       failures,
       environment,
-      charts
+      charts,
+      runDiff
     };
   }
   printsToStdio() {
@@ -15265,6 +15366,47 @@ function collectFlakyTests(projects) {
   }
   return result;
 }
+function collectFailedTests(projects) {
+  const seen = /* @__PURE__ */ new Set();
+  const result = [];
+  for (const project of projects) {
+    for (const suite of flattenSuiteNodes(project.suites)) {
+      for (const test of suite.tests) {
+        if ((test.status === "failed" || test.status === "timedOut") && !seen.has(test.id)) {
+          seen.add(test.id);
+          result.push({ id: test.id, title: test.fullTitle });
+        }
+      }
+    }
+  }
+  return result;
+}
+function collectCurrentStatuses(projects) {
+  const statuses = /* @__PURE__ */ new Map();
+  for (const project of projects) {
+    for (const suite of flattenSuiteNodes(project.suites)) {
+      for (const test of suite.tests) {
+        statuses.set(test.id, test.status);
+      }
+    }
+  }
+  return statuses;
+}
+function buildFailedTestsFields(projects, redactor) {
+  const redactedFailing = collectFailedTests(projects).map(
+    (t) => redactor ? { ...t, title: redactor.redactText(t.title) } : t
+  );
+  const failedTests = redactedFailing.slice(0, FAILED_TESTS_CAP);
+  return redactedFailing.length > FAILED_TESTS_CAP ? { redactedFailing, failedTests, failedTestsTruncated: true } : { redactedFailing, failedTests };
+}
+function resolveRunDiff(projects, currentFailing, priorEntries, branch) {
+  return computeRunDiff({
+    currentFailing,
+    currentStatuses: collectCurrentStatuses(projects),
+    priorEntries,
+    branch
+  }) ?? void 0;
+}
 
 // src/index.ts
 function defineReporterConfig(options) {

package/dist/templates/layouts/detailed.hbs

@@ -24,6 +24,8 @@
 
 {{#if sections.charts}}{{> charts options=(obj showCharts=true showTrend=sections.trend) }}{{/if}}
 
+{{#if sections.runDiff}}{{> run-diff variant='full'}}{{/if}}
+
 {{#if sections.requirementsMatrix}}{{> requirements-matrix }}{{/if}}
 
 {{#if sections.ciEnvironment}}{{> ci-environment options=(obj showFullEnvironment=sections.fullEnvironment) }}{{/if}}

package/dist/templates/layouts/executive.hbs

@@ -20,6 +20,8 @@
 
 {{#if sections.briefBand}}{{> brief-band}}{{/if}}
 
+{{#if sections.runDiff}}{{> run-diff variant='compact'}}{{/if}}
+
 {{#if sections.summary}}{{> executive-hero-summary options=(obj showPassRate=sections.passRate releaseGateShown=sections.releaseGate) }}{{/if}}
 
 {{#if sections.charts}}{{> charts options=(obj showCharts=true showTrend=sections.trend heroTrend=true) }}{{/if}}

package/dist/templates/layouts/minimal.hbs

@@ -22,6 +22,8 @@
 
 {{#if sections.summary}}{{> executive-summary options=(obj showPassRate=sections.passRate releaseGateShown=sections.releaseGate) }}{{/if}}
 
+{{#if sections.runDiff}}{{> run-diff variant='strip'}}{{/if}}
+
 {{#if sections.charts}}{{> charts options=(obj showCharts=true showTrend=sections.trend) }}{{/if}}
 
 {{#if sections.requirementsMatrix}}{{> requirements-matrix }}{{/if}}

package/dist/templates/partials/run-diff.hbs

@@ -0,0 +1,41 @@
+{{#if runDiff}}
+<div class="section section--run-diff">
+  <h2>Since Last Run</h2>
+  <div class="run-diff__head">
+    <div class="run-diff__strip">
+      <span class="run-diff__count run-diff__count--new"><strong>{{runDiff.newFailures.length}}</strong> {{pluralise runDiff.newFailures.length "new failure" "new failures"}}</span>&nbsp;&middot;&nbsp;<span class="run-diff__count run-diff__count--fixed"><strong>{{runDiff.fixed.length}}</strong> fixed</span>&nbsp;&middot;&nbsp;<span class="run-diff__count run-diff__count--still"><strong>{{runDiff.stillFailing.length}}</strong> still failing</span>{{#if runDiff.noLongerRun.length}}&nbsp;&middot;&nbsp;<span class="run-diff__count run-diff__count--neutral"><strong>{{runDiff.noLongerRun.length}}</strong> no longer run</span>{{/if}}
+    </div>
+    <div class="run-diff__baseline">vs. previous run on {{formatDate runDiff.baselineTimestamp}}</div>
+    {{#if runDiff.baselineTruncated}}
+    <div class="overflow-banner run-diff__caveat">Baseline list was capped; fixed and no-longer-run may be incomplete.</div>
+    {{/if}}
+  </div>
+
+  {{#if (eq variant 'full')}}
+  {{> run-diff-list items=runDiff.newFailures label="New Failures" }}
+  {{> run-diff-list items=runDiff.fixed label="Fixed" }}
+  {{> run-diff-list items=runDiff.stillFailing label="Still Failing" }}
+  {{#if runDiff.noLongerRun.length}}
+  <div class="run-diff__footnote">No longer run: {{#each (take runDiff.noLongerRun 5)}}{{title}}{{#unless @last}} &middot; {{/unless}}{{/each}}{{#if (gt runDiff.noLongerRun.length 5)}} &middot; + {{subtract runDiff.noLongerRun.length 5}} more{{/if}}</div>
+  {{/if}}
+  {{/if}}
+
+  {{#if (eq variant 'compact')}}
+  {{> run-diff-list items=runDiff.newFailures label="New Failures" }}
+  {{/if}}
+</div>
+{{/if}}
+
+{{#*inline "run-diff-list"}}
+{{#if items.length}}
+<div class="run-diff__list">
+  <div class="run-diff__list-label">{{label}}</div>
+  {{#each (take items 20)}}
+  <div class="run-diff__list-item">- {{title}}</div>
+  {{/each}}
+  {{#if (gt items.length 20)}}
+  <div class="run-diff__list-more">+ {{subtract items.length 20}} more</div>
+  {{/if}}
+</div>
+{{/if}}
+{{/inline}}

package/dist/templates/styles/base.css

@@ -188,7 +188,7 @@ tr:last-child td { border-bottom: none; }
    blocks below stay glued together, and headings stick to the content beneath. */
 .section { margin-bottom: 24px; }
 .kpi-strip, .summary-row, .charts-grid, .release-gate, .flaky-callout,
-.trend-card, .flakiness-card, .env-grid {
+.trend-card, .flakiness-card, .env-grid, .run-diff__head {
   page-break-inside: avoid; break-inside: avoid;
 }
 h2, h3 { page-break-after: avoid; break-after: avoid; }
@@ -684,6 +684,24 @@ code {
   color: var(--text-1); line-height: 1.55;
 }
 
+/* ── Run diff — since-last-run counts + optional lists (sections.runDiff) ── */
+.run-diff__strip { font-size: 10.5px; }
+.run-diff__count strong { font-weight: 700; }
+.run-diff__count--new strong { color: var(--fail); }
+.run-diff__count--fixed strong { color: var(--pass); }
+.run-diff__count--still strong,
+.run-diff__count--neutral strong { color: var(--text-3); }
+.run-diff__baseline { font-size: 9.5px; color: var(--text-3); margin-top: 4px; }
+.run-diff__caveat { margin-top: 8px; }
+.run-diff__list { margin-top: 10px; }
+.run-diff__list-label {
+  font-size: 9px; font-weight: 600; letter-spacing: 0.6px; text-transform: uppercase;
+  color: var(--text-2); margin-bottom: 4px;
+}
+.run-diff__list-item { font-size: 10px; color: var(--text-1); padding: 1px 0; }
+.run-diff__list-more { font-size: 9.5px; color: var(--text-3); padding: 1px 0; }
+.run-diff__footnote { font-size: 9.5px; color: var(--text-3); margin-top: 8px; }
+
 /* Charts grid + cards (available to any template via sections.charts) */
 .charts-grid {
   display: grid; grid-template-columns: 210px 1fr;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reportforge/playwright-pdf",
-  "version": "0.25.0",
+  "version": "0.26.1",
   "description": "Playwright Test reporter that generates designed PDF reports: minimal, detailed, and executive templates with CI/CD integrations",
   "license": "Elastic-2.0",
   "author": "ReportForge",