@reportforge/playwright-pdf 0.13.1 → 0.14.0

package/dist/index.mjs

@@ -10351,6 +10351,7 @@ var SECTION_KEYS = [
   "failureAnalysis",
   "slowTests",
   "defectLog",
+  "briefBand",
   // display modifiers
   "passRate",
   "fullEnvironment",
@@ -10373,6 +10374,7 @@ var SECTION_DEFAULTS = {
     failureAnalysis: false,
     slowTests: false,
     defectLog: false,
+    briefBand: false,
     passRate: true,
     fullEnvironment: false,
     retries: true,
@@ -10393,6 +10395,7 @@ var SECTION_DEFAULTS = {
     failureAnalysis: true,
     slowTests: true,
     defectLog: true,
+    briefBand: false,
     passRate: true,
     fullEnvironment: true,
     retries: true,
@@ -10401,7 +10404,9 @@ var SECTION_DEFAULTS = {
   },
   executive: {
     coverPage: true,
-    analysisOneliner: true,
+    // Now off: its content (root-cause tally) is subsumed by briefBand below,
+    // which also adds the trend delta. Showing both would say it twice.
+    analysisOneliner: false,
     releaseGate: true,
     summary: true,
     charts: true,
@@ -10416,6 +10421,7 @@ var SECTION_DEFAULTS = {
     failureAnalysis: false,
     slowTests: true,
     defectLog: false,
+    briefBand: true,
     passRate: true,
     fullEnvironment: false,
     retries: false,
@@ -11062,6 +11068,11 @@ var LicenseClient = class {
         body: JSON.stringify(body),
         signal: controller.signal
       });
+      if (res.status === 429 || res.status === 408) {
+        await res.body?.cancel().catch(() => {
+        });
+        throw new Error(`HTTP ${res.status}`);
+      }
       if (res.status >= 400 && res.status < 500) {
         const text = await res.text().catch(() => "");
         throw new Error(`license-denied: ${text || `HTTP ${res.status}`}`);
@@ -11294,6 +11305,25 @@ function buildOneLiner(clusters) {
 function dominantCategory(clusters) {
   return clusters[0]?.category ?? "unknown";
 }
+function trendClause(passRate, delta) {
+  if (delta === 0) return `Pass rate held steady at ${passRate}%.`;
+  const verb = delta > 0 ? "climbed" : "dropped";
+  const abs = Math.abs(delta);
+  const points = abs === 1 ? "point" : "points";
+  return `Pass rate ${verb} ${abs} ${points} to ${passRate}% since the last run.`;
+}
+function causesClause(analysis) {
+  const [head, ...tallyParts] = buildOneLiner(analysis.clusters).split(" \xB7 ");
+  const verb = analysis.clusters.length === 1 ? "remains" : "remain";
+  return `${head} ${verb}: ${tallyParts.join(", ")}.`;
+}
+function buildBriefSentence(stats, analysis, trend) {
+  if (trend && trend.delta !== null) {
+    const trendSentence = trendClause(stats.passRate, trend.delta);
+    return analysis && analysis.clusters.length > 0 ? `${trendSentence} ${causesClause(analysis)}` : trendSentence;
+  }
+  return analysis && analysis.clusters.length > 0 ? causesClause(analysis) : void 0;
+}
 
 // src/analysis/UnclassifiedCollector.ts
 init_esm_shims();
@@ -11620,6 +11650,17 @@ init_esm_shims();
 // src/collector/stats-utils.ts
 init_esm_shims();
 var TOP_SUITES_FOR_CHART = 10;
+function resolveTestStatus(test, result) {
+  if (!result) return "skipped";
+  const expected = test.expectedStatus ?? "passed";
+  const actual = result.status;
+  if (actual === "skipped") return "skipped";
+  if (actual === "timedOut") return "timedOut";
+  if (actual === "passed" && result.retry > 0) return "flaky";
+  if (actual === "passed" && expected === "passed") return "passed";
+  if (actual === "failed" && expected === "failed") return "passed";
+  return "failed";
+}
 function statsFromTests(tests) {
   return {
     total: tests.length,
@@ -11695,7 +11736,7 @@ var SuiteWalker = class {
   }
   buildTest(test, resultMap) {
     const result = resultMap.get(test.id);
-    const status = this.resolveStatus(test, result);
+    const status = resolveTestStatus(test, result);
     return {
       id: test.id,
       title: test.title,
@@ -11708,17 +11749,6 @@ var SuiteWalker = class {
       location: test.location ? `${test.location.file}:${test.location.line}` : void 0
     };
   }
-  resolveStatus(test, result) {
-    if (!result) return "skipped";
-    const expected = test.expectedStatus ?? "passed";
-    const actual = result.status;
-    if (actual === "skipped") return "skipped";
-    if (actual === "timedOut") return "timedOut";
-    if (actual === "passed" && result.retry > 0) return "flaky";
-    if (actual === "passed" && expected === "passed") return "passed";
-    if (actual === "failed" && expected === "failed") return "passed";
-    return "failed";
-  }
 };
 
 // src/collector/severity.ts
@@ -11732,6 +11762,16 @@ var SEVERITY_RANK = {
 function sortBySeverity(failures) {
   return [...failures].sort((a, b) => SEVERITY_RANK[a.severity] - SEVERITY_RANK[b.severity]);
 }
+function inferSeverity(annotations, tags) {
+  const allLabels = [
+    ...annotations.map((a) => a.type.toLowerCase()),
+    ...tags.map((t) => t.toLowerCase())
+  ];
+  if (allLabels.some((l) => l.includes("critical") || l.includes("blocker"))) return "critical";
+  if (allLabels.some((l) => l.includes("high") || l.includes("major"))) return "high";
+  if (allLabels.some((l) => l.includes("low") || l.includes("minor"))) return "low";
+  return "medium";
+}
 
 // src/utils/env.ts
 init_esm_shims();
@@ -11856,6 +11896,10 @@ var DataCollector = class {
   constructor(captureOpts = {}) {
     this.captureOpts = captureOpts;
     this.resultMap = /* @__PURE__ */ new Map();
+    // Parallel to resultMap — needed so computeStats() (which only sees
+    // TestResult, not TestCase) can reconcile against expectedStatus the same
+    // way resolveTestStatus does for the suite tree and the failure list.
+    this.expectedStatusMap = /* @__PURE__ */ new Map();
     this.failureRecords = [];
     this.startTime = Date.now();
   }
@@ -11866,7 +11910,10 @@ var DataCollector = class {
   }
   onTestEnd(test, result) {
     this.resultMap.set(test.id, result);
-    if (result.status === "failed" || result.status === "timedOut") {
+    this.expectedStatusMap.set(test.id, test.expectedStatus);
+    const resolved = resolveTestStatus(test, result);
+    const isRealFailure = resolved === "failed" || resolved === "timedOut";
+    if (isRealFailure) {
       const existing = this.failureRecords.findIndex((f) => f.testId === test.id);
       const record = this.buildFailureRecord(test, result);
       if (existing >= 0) {
@@ -11906,7 +11953,7 @@ var DataCollector = class {
       (a) => a.name.toLowerCase().includes("screenshot") && a.contentType.startsWith("image/")
     );
     const suitePath = test.titlePath().slice(0, -1);
-    const severity = this.inferSeverity(test);
+    const severity = inferSeverity(test.annotations ?? [], test.tags ?? []);
     return {
       testId: test.id,
       testTitle: test.title,
@@ -11929,28 +11976,18 @@ var DataCollector = class {
       execution: executionFromResult(result, this.captureOpts)
     };
   }
-  inferSeverity(test) {
-    const annotations = test.annotations ?? [];
-    const tags = test.tags ?? [];
-    const allLabels = [
-      ...annotations.map((a) => a.type.toLowerCase()),
-      ...tags.map((t) => t.toLowerCase())
-    ];
-    if (allLabels.some((l) => l.includes("critical") || l.includes("blocker"))) return "critical";
-    if (allLabels.some((l) => l.includes("high") || l.includes("major"))) return "high";
-    if (allLabels.some((l) => l.includes("low") || l.includes("minor"))) return "low";
-    return "medium";
-  }
   computeStats(fullResult) {
     let total = 0, passed = 0, failed = 0, skipped = 0, flaky = 0, timedOut = 0;
-    for (const [, result] of this.resultMap) {
+    for (const [testId, result] of this.resultMap) {
       total++;
-      switch (result.status) {
-        // A test that passes on a retry (retry > 0) is flaky, NOT a clean pass.
-        // Counting it in `passed` too would double-count it against `flaky` and
-        // push passRate over 100%.
+      const expectedStatus = this.expectedStatusMap.get(testId);
+      const resolved = resolveTestStatus({ expectedStatus }, result);
+      switch (resolved) {
         case "passed":
-          result.retry > 0 ? flaky++ : passed++;
+          passed++;
+          break;
+        case "flaky":
+          flaky++;
           break;
         case "failed":
           failed++;
@@ -11962,9 +11999,6 @@ var DataCollector = class {
         case "skipped":
           skipped++;
           break;
-        case "interrupted":
-          failed++;
-          break;
       }
     }
     const duration = fullResult.duration ?? Date.now() - this.startTime;
@@ -12124,18 +12158,26 @@ var ShardMerger = class {
     });
   }
   buildDescribeSuites(jsonSuites, projectName, parentPath) {
-    return jsonSuites.map((suite) => {
-      const suitePath = [...parentPath, suite.title];
-      const tests = suite.specs.map((spec) => this.specToTestNode(spec, projectName, suitePath));
-      const childSuites = this.buildDescribeSuites(suite.suites ?? [], projectName, suitePath);
+    const groups = /* @__PURE__ */ new Map();
+    for (const suite of jsonSuites) {
+      if (!groups.has(suite.title)) groups.set(suite.title, []);
+      groups.get(suite.title).push(suite);
+    }
+    return Array.from(groups.values()).map((group) => {
+      const ref = group[0];
+      const suitePath = [...parentPath, ref.title];
+      const allSpecs = group.flatMap((s) => s.specs);
+      const allChildSuites = group.flatMap((s) => s.suites ?? []);
+      const tests = allSpecs.map((spec) => this.specToTestNode(spec, projectName, suitePath));
+      const childSuites = this.buildDescribeSuites(allChildSuites, projectName, suitePath);
       const stats = aggregateStats([
         ...childSuites.map((s) => s.stats),
         statsFromTests(tests)
       ]);
       return {
-        title: suite.title,
+        title: ref.title,
         type: "describe",
-        location: suite.file ? `${suite.file}:${suite.line ?? 0}` : void 0,
+        location: ref.file ? `${ref.file}:${ref.line ?? 0}` : void 0,
         suites: childSuites,
         tests,
         stats
@@ -12241,7 +12283,7 @@ var ShardMerger = class {
         duration: r.duration
       })),
       durationMs: lastResult?.duration ?? 0,
-      severity: "medium",
+      severity: inferSeverity(test.annotations ?? [], spec.tags ?? []),
       execution: lastResult ? buildExecution(
         {
           // Guard each field — a partial / non-conformant / older shard JSON can
@@ -12817,25 +12859,18 @@ var PdfEncryptor = class {
       return;
     }
     const tmpPath = path9.join(os8.tmpdir(), `rf-encrypted-${Date.now()}.pdf`);
-    const pwFile = path9.join(os8.tmpdir(), `rf-pw-${crypto3.randomBytes(8).toString("hex")}`);
+    const argFile = path9.join(os8.tmpdir(), `rf-qpdf-args-${crypto3.randomBytes(8).toString("hex")}`);
     try {
-      fs9.writeFileSync(pwFile, `${password}
-${password}`, { mode: 384 });
-      execFileSync("qpdf", [
-        `--password-file=${pwFile}`,
-        "--encrypt",
-        "256",
-        "--",
-        pdfPath,
-        tmpPath
-      ], { stdio: "pipe" });
+      const args = ["--encrypt", password, password, "256", "--", pdfPath, tmpPath];
+      fs9.writeFileSync(argFile, args.join("\n"), { mode: 384 });
+      execFileSync("qpdf", [`@${argFile}`], { stdio: "pipe" });
       fs9.renameSync(tmpPath, pdfPath);
       logger.info(`PDF encrypted with password.`);
     } catch (e) {
-      logger.warn(`qpdf encryption failed: ${e.message}`);
+      throw new Error(`qpdf encryption failed: ${e.message}`);
     } finally {
       if (fs9.existsSync(tmpPath)) fs9.unlinkSync(tmpPath);
-      fs9.rmSync(pwFile, { force: true });
+      fs9.rmSync(argFile, { force: true });
     }
   }
   isQpdfAvailable() {
@@ -13084,7 +13119,8 @@ var PdfGenerator = class {
         if (capBytes > 0) {
           const sizeBytes = (await fs12.promises.stat(outputPath)).size;
           if (sizeBytes > capBytes) {
-            const tighter = this.tightenForCap(compression, sizeBytes, capBytes);
+            const inlinedCount = Math.min(templateData.failures.length, compression.maxInlineFailures);
+            const tighter = this.tightenForCap(compression, sizeBytes, capBytes, inlinedCount);
             logger.warn(
               `PDF size ${fmtMb(sizeBytes)} exceeds cap ${fmtMb(capBytes)} \u2014 re-rendering (jpeg-q=${tighter.quality}, max-w=${tighter.maxWidth}px, inline-failures\u2264${tighter.maxInlineFailures}).`
             );
@@ -13113,11 +13149,30 @@ var PdfGenerator = class {
   }
   resolveTemplateSources(options) {
     if (options.templatePath && options.templatePath.length > 0) {
-      return [...new Set(options.templatePath)].map((p) => ({
-        kind: "custom",
-        absolutePath: path12.isAbsolute(p) ? p : path12.resolve(process.cwd(), p),
-        label: path12.basename(p, ".hbs")
-      }));
+      const byAbsolutePath = /* @__PURE__ */ new Map();
+      for (const p of options.templatePath) {
+        const absolutePath = path12.isAbsolute(p) ? p : path12.resolve(process.cwd(), p);
+        if (!byAbsolutePath.has(absolutePath)) byAbsolutePath.set(absolutePath, p);
+      }
+      const labelCounts = /* @__PURE__ */ new Map();
+      for (const rawPath of byAbsolutePath.values()) {
+        const label = path12.basename(rawPath, ".hbs");
+        labelCounts.set(label, (labelCounts.get(label) ?? 0) + 1);
+      }
+      const seenPerLabel = /* @__PURE__ */ new Map();
+      return Array.from(byAbsolutePath.entries()).map(([absolutePath, rawPath]) => {
+        const baseLabel = path12.basename(rawPath, ".hbs");
+        let label = baseLabel;
+        if ((labelCounts.get(baseLabel) ?? 0) > 1) {
+          const n = (seenPerLabel.get(baseLabel) ?? 0) + 1;
+          seenPerLabel.set(baseLabel, n);
+          label = `${baseLabel}-${n}`;
+          logger.warn(
+            `Multiple templatePath entries resolve to the basename "${baseLabel}" \u2014 disambiguating output filenames with a numeric suffix ("${label}").`
+          );
+        }
+        return { kind: "custom", absolutePath, label };
+      });
     }
     const rawIds = Array.isArray(options.template) ? options.template : [options.template];
     return [...new Set(rawIds)].map((id) => ({ kind: "builtin", id }));
@@ -13139,8 +13194,8 @@ var PdfGenerator = class {
    * Also tightens JPEG quality and width to claw back bytes from each
    * remaining image.
    */
-  tightenForCap(prev, actualBytes, capBytes) {
-    const observedPerFailure = actualBytes / Math.max(1, prev.maxInlineFailures);
+  tightenForCap(prev, actualBytes, capBytes, actualInlinedCount) {
+    const observedPerFailure = actualBytes / Math.max(1, actualInlinedCount);
     const targetInline = Math.max(20, Math.floor(capBytes * 0.85 / observedPerFailure));
     return {
       effective: "max",
@@ -14002,7 +14057,7 @@ var PdfReporter = class {
     this.liveConsole = false;
     this.options = parseOptions(rawOptions);
     this.dataCollector = new DataCollector(this.options.capture);
-    const version = true ? "0.13.1" : "0.x";
+    const version = true ? "0.14.0" : "0.x";
     logger.info(`@reportforge/playwright-pdf v${version} initialised`);
     this.licenseClient = new LicenseClient({
       licenseKey: this.options.licenseKey,
@@ -14086,6 +14141,7 @@ var PdfReporter = class {
     }
     const reportData = this._buildReportData(collected, licenseInfo);
     runFailureAnalysis(reportData, this.options, this.cwd);
+    reportData.briefSentence = buildBriefSentence(reportData.stats, reportData.analysis, reportData.charts.trend);
     let pdfPaths = [];
     try {
       pdfPaths = await this.pdfGenerator.generateAll(reportData, this.options, licenseInfo);

package/dist/templates/layouts/detailed.hbs

@@ -18,6 +18,8 @@
 
 {{#if sections.releaseGate}}{{> release-gate}}{{/if}}
 
+{{#if sections.briefBand}}{{> brief-band}}{{/if}}
+
 {{#if sections.summary}}{{> executive-summary options=(obj showPassRate=sections.passRate releaseGateShown=sections.releaseGate) }}{{/if}}
 
 {{#if sections.charts}}{{> charts options=(obj showCharts=true showTrend=sections.trend) }}{{/if}}

package/dist/templates/layouts/executive.hbs

@@ -18,9 +18,11 @@
 
 {{#if sections.releaseGate}}{{> release-gate}}{{/if}}
 
-{{#if sections.summary}}{{> executive-summary options=(obj showPassRate=sections.passRate releaseGateShown=sections.releaseGate) }}{{/if}}
+{{#if sections.briefBand}}{{> brief-band}}{{/if}}
 
-{{#if sections.charts}}{{> charts options=(obj showCharts=true showTrend=sections.trend) }}{{/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}}
 
 {{#if sections.requirementsMatrix}}{{> requirements-matrix }}{{/if}}
 

package/dist/templates/layouts/minimal.hbs

@@ -18,6 +18,8 @@
 
 {{#if sections.releaseGate}}{{> release-gate}}{{/if}}
 
+{{#if sections.briefBand}}{{> brief-band}}{{/if}}
+
 {{#if sections.summary}}{{> executive-summary options=(obj showPassRate=sections.passRate releaseGateShown=sections.releaseGate) }}{{/if}}
 
 {{#if sections.charts}}{{> charts options=(obj showCharts=true showTrend=sections.trend) }}{{/if}}

package/dist/templates/partials/brief-band.hbs

@@ -0,0 +1,6 @@
+{{#if briefSentence}}
+<div class="brief-band">
+  <span class="brief-band__quote">&#8220;</span>
+  <p class="brief-band__text">{{briefSentence}}</p>
+</div>
+{{/if}}

package/dist/templates/partials/chart-summary-grid.hbs

@@ -0,0 +1,18 @@
+<div class="section charts-grid{{#if options.heroTrend}} charts-grid--secondary{{/if}}">
+  <div class="chart-card">
+    <h3>Pass Rate</h3>
+    {{#if options.heroTrend}}
+    <canvas id="passRateChart" width="150" height="150"></canvas>
+    {{else}}
+    <canvas id="passRateChart" width="186" height="186"></canvas>
+    {{/if}}
+  </div>
+  <div class="chart-card">
+    <h3>Suite Results</h3>
+    {{#if options.heroTrend}}
+    <canvas id="suitesBarChart" width="300" height="150"></canvas>
+    {{else}}
+    <canvas id="suitesBarChart" width="390" height="186"></canvas>
+    {{/if}}
+  </div>
+</div>

package/dist/templates/partials/chart-trend-card.hbs

@@ -0,0 +1,16 @@
+{{#if options.showTrend}}
+{{#if charts.trend}}
+<div class="trend-card">
+  <div class="trend-card__header">
+    <span class="trend-card__title">Pass rate trend &mdash; last {{charts.trend.entries.length}} runs</span>
+    {{#if charts.trend.delta}}
+    <span class="delta {{#if (gt charts.trend.delta 0)}}delta-up{{else}}delta-down{{/if}}">
+      {{#if (gt charts.trend.delta 0)}}&#8593;{{else}}&#8595;{{/if}} {{absFixed charts.trend.delta}}% vs previous run
+    </span>
+    {{/if}}
+  </div>
+  <canvas id="trendChart" width="680" height="160"></canvas>
+  <div class="trend-run-history" id="run-history-table"></div>
+</div>
+{{/if}}
+{{/if}}

package/dist/templates/partials/charts.hbs

@@ -1,33 +1,10 @@
 {{#if options.showCharts}}
-<div class="section charts-grid">
-  <div class="chart-card">
-    <h3>Pass Rate</h3>
-    <canvas id="passRateChart" width="186" height="186"></canvas>
-  </div>
-  <div class="chart-card">
-    <h3>Suite Results</h3>
-    <canvas id="suitesBarChart" width="390" height="186"></canvas>
-  </div>
-</div>
-
-{{!-- Trend card: detailed + executive + custom templates. Minimal has showTrend=false. --}}
-{{#if options.showTrend}}
-{{#if charts.trend}}
-<div class="trend-card">
-  <div class="trend-card__header">
-    <span class="trend-card__title">Pass rate trend &mdash; last {{charts.trend.entries.length}} runs</span>
-    {{!-- Delta badge: falsy guard handles null (< 2 entries) and 0 (identical runs). --}}
-    {{#if charts.trend.delta}}
-    <span class="delta {{#if (gt charts.trend.delta 0)}}delta-up{{else}}delta-down{{/if}}">
-      {{#if (gt charts.trend.delta 0)}}&#8593;{{else}}&#8595;{{/if}} {{absFixed charts.trend.delta}}% vs previous run
-    </span>
-    {{/if}}
-  </div>
-  <canvas id="trendChart" width="680" height="160"></canvas>
-  {{!-- Run history table is populated by JS below; placeholder must exist before script runs. --}}
-  <div class="trend-run-history" id="run-history-table"></div>
-</div>
-{{/if}}
+{{#if options.heroTrend}}
+{{> chart-trend-card options=options}}
+{{> chart-summary-grid options=options}}
+{{else}}
+{{> chart-summary-grid options=options}}
+{{> chart-trend-card options=options}}
 {{/if}}
 
 {{#if options.showTrend}}
@@ -112,7 +89,7 @@
       labels: ['Passed', 'Failed', 'Timed Out', 'Skipped', 'Flaky'],
       datasets: [{
         data: [passed, failed, timedOut, skipped, flaky],
-        backgroundColor: ['#3F7D58', '#C3553C', '#B5803A', '#7A786E', '#D49452'],
+        backgroundColor: ['#3F7D58', '#C3553C', '#B5803A', '#7A786E', '#CA8A04'],
         borderColor:     ['#FAF9F5', '#FAF9F5', '#FAF9F5', '#FAF9F5', '#FAF9F5'],
         borderWidth: 2,
         hoverOffset: 4

package/dist/templates/partials/executive-hero-summary.hbs

@@ -0,0 +1,66 @@
+<div class="section">
+  {{#unless options.releaseGateShown}}
+  <span class="verdict verdict--{{stats.verdict}}">
+    {{verdictLabel stats.verdict}}
+  </span>
+  {{/unless}}
+
+  <div class="hero-summary">
+    <div class="hero-summary__value">{{stats.passRate}}<span class="hero-summary__pct">%</span></div>
+    <div class="hero-summary__label">Pass Rate</div>
+  </div>
+
+  <div class="hero-stat-row">
+    <div class="hero-stat">
+      <span class="hero-stat__value">{{stats.total}}</span>
+      <span class="hero-stat__label">Total</span>
+    </div>
+    <div class="hero-stat{{#unless stats.failed}} hero-stat--zero{{/unless}}">
+      <span class="hero-stat__value" style="color:var(--fail);">{{stats.failed}}</span>
+      <span class="hero-stat__label">Failed</span>
+    </div>
+    <div class="hero-stat{{#unless stats.timedOut}} hero-stat--zero{{/unless}}">
+      <span class="hero-stat__value" style="color:var(--timeout);">{{stats.timedOut}}</span>
+      <span class="hero-stat__label">Timed Out</span>
+    </div>
+    <div class="hero-stat{{#unless stats.skipped}} hero-stat--zero{{/unless}}">
+      <span class="hero-stat__value" style="color:var(--skip);">{{stats.skipped}}</span>
+      <span class="hero-stat__label">Skipped</span>
+    </div>
+    <div class="hero-stat{{#unless stats.flaky}} hero-stat--zero{{/unless}}">
+      <span class="hero-stat__value" style="color:var(--flaky);">{{stats.flaky}}</span>
+      <span class="hero-stat__label">Flaky</span>
+    </div>
+  </div>
+
+  <div class="summary-row">
+    <div class="summary-row__item">
+      <span class="summary-row__label">Duration</span>
+      <span class="summary-row__value">{{formatDuration stats.duration}}</span>
+    </div>
+    {{#unless (or options.showPassRate @root.sections.charts)}}
+    <div class="summary-row__item">
+      <span class="summary-row__label">Pass Rate</span>
+      <span class="summary-row__value" style="color:var(--pass);">{{stats.passRate}}%</span>
+    </div>
+    {{/unless}}
+    <div class="summary-row__item">
+      <span class="summary-row__label">Generated</span>
+      <span class="summary-row__value">{{formatDate meta.generatedAt}}</span>
+    </div>
+    <div class="summary-row__item">
+      <span class="summary-row__label">Project</span>
+      <span class="summary-row__value">{{meta.projectName}}</span>
+    </div>
+  </div>
+
+  {{#if stats.flaky}}
+  <div class="flaky-callout">
+    <span class="flaky-callout__icon">&#9888;</span>
+    <div class="flaky-callout__body">
+      <span class="flaky-callout__title">{{stats.flaky}} Flaky Test{{#if (gt stats.flaky 1)}}s{{/if}} Detected</span>
+      <span class="flaky-callout__text">These tests passed on retry. Results may vary across re-runs. Investigate before shipping to production.</span>
+    </div>
+  </div>
+  {{/if}}
+</div>

package/dist/templates/styles/base.css

@@ -635,6 +635,28 @@ code {
 
 /* These section styles ship to every template so any section can be toggled in styled; ~a few KB of unused CSS in templates where the section is off is an accepted cost. */
 
+/* ── Brief band — the executive lede sentence, shared so any template can
+   toggle briefBand on. No border/side-stripe (deliberately distinct from the
+   card recipe used everywhere else); a tinted surface instead. ── */
+.brief-band {
+  display: flex; align-items: flex-start; gap: 14px;
+  background: var(--surface-2);
+  padding: 18px 22px 20px;
+  border-radius: 6px;
+  margin-bottom: 22px;
+}
+.brief-band__quote {
+  font-family: 'Source Serif Pro', Georgia, serif;
+  font-size: 40px; font-weight: 700;
+  color: var(--accent); opacity: .5; line-height: .6;
+  flex-shrink: 0; margin-top: 8px;
+}
+.brief-band__text {
+  font-family: 'Source Serif Pro', Georgia, serif;
+  font-style: italic; font-size: 15px;
+  color: var(--text-1); line-height: 1.55;
+}
+
 /* Charts grid + cards (available to any template via sections.charts) */
 .charts-grid {
   display: grid; grid-template-columns: 210px 1fr;

package/dist/templates/styles/executive.css

@@ -131,6 +131,37 @@
 .chart-card h3 {
   letter-spacing: 1.3px;
 }
+.charts-grid--secondary {
+  grid-template-columns: 1fr 1fr;
+  margin-top: 4px;
+}
 
 /* Executive failures now render inline in the suite breakdown (compact, no
    screenshots) — card styles live in base.css. */
+
+/* ── Hero summary — executive-exclusive replacement for the 6-card KPI strip ── */
+.hero-summary { text-align: center; padding: 18px 0 2px; }
+.hero-summary__value {
+  font-family: 'Source Serif Pro', Georgia, serif;
+  font-size: 68px; font-weight: 700; color: var(--pass);
+  letter-spacing: -1.5px; line-height: 1;
+}
+.hero-summary__pct { font-size: 32px; }
+.hero-summary__label {
+  font-family: 'Inter', system-ui, sans-serif; font-size: 10px; font-weight: 600;
+  letter-spacing: 1.4px; text-transform: uppercase; color: var(--text-3); margin-top: 6px;
+}
+.hero-stat-row { display: flex; justify-content: center; gap: 0; margin: 18px 0 24px; }
+.hero-stat {
+  display: flex; flex-direction: column; align-items: center;
+  padding: 0 22px; border-right: 1px solid var(--border);
+}
+.hero-stat:last-child { border-right: none; }
+.hero-stat--zero { opacity: .45; }
+.hero-stat__value {
+  font-family: 'Source Serif Pro', Georgia, serif; font-size: 20px; font-weight: 700; color: var(--text-1);
+}
+.hero-stat__label {
+  display: block; font-family: 'Inter', system-ui, sans-serif; font-size: 8px; font-weight: 600;
+  letter-spacing: 1px; text-transform: uppercase; color: var(--text-3); margin-top: 4px;
+}

package/dist/templates/styles/minimal.css

@@ -6,9 +6,17 @@
   padding: 20px 22px;
   background: var(--surface);
   border: 1px solid var(--border-2);
-  border-left: 3px solid var(--primary, #CC785C);
   border-radius: 6px;
   margin-bottom: 22px;
+  position: relative;
+  overflow: hidden;
+}
+.report-header::before {
+  content: '';
+  position: absolute; top: 0; left: 0; right: 0; height: 3px;
+  background: var(--accent);
+  -webkit-print-color-adjust: exact;
+  print-color-adjust: exact;
 }
 .report-header__logo { height: 36px; width: auto; }
 .report-header__title {

package/package.json

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