@reportforge/playwright-pdf 0.29.0 → 0.31.0

package/dist/index.mjs

@@ -1229,13 +1229,13 @@ var require_ast = __commonJS({
         helperExpression: function helperExpression(node) {
           return node.type === "SubExpression" || (node.type === "MustacheStatement" || node.type === "BlockStatement") && !!(node.params && node.params.length || node.hash);
         },
-        scopedId: function scopedId(path16) {
-          return /^\.|this\b/.test(path16.original);
+        scopedId: function scopedId(path17) {
+          return /^\.|this\b/.test(path17.original);
         },
         // an ID is simple if it only has one part, and that part is not
         // `..` or `this`.
-        simpleId: function simpleId(path16) {
-          return path16.parts.length === 1 && !AST.helpers.scopedId(path16) && !path16.depth;
+        simpleId: function simpleId(path17) {
+          return path17.parts.length === 1 && !AST.helpers.scopedId(path17) && !path17.depth;
         }
       }
     };
@@ -2309,12 +2309,12 @@ var require_helpers2 = __commonJS({
         loc
       };
     }
-    function prepareMustache(path16, params, hash, open, strip, locInfo) {
+    function prepareMustache(path17, params, hash, open, strip, locInfo) {
       var escapeFlag = open.charAt(3) || open.charAt(2), escaped = escapeFlag !== "{" && escapeFlag !== "&";
       var decorator = /\*/.test(open);
       return {
         type: decorator ? "Decorator" : "MustacheStatement",
-        path: path16,
+        path: path17,
         params,
         hash,
         escaped,
@@ -2634,9 +2634,9 @@ var require_compiler = __commonJS({
       },
       DecoratorBlock: function DecoratorBlock(decorator) {
         var program = decorator.program && this.compileProgram(decorator.program);
-        var params = this.setupFullMustacheParams(decorator, program, void 0), path16 = decorator.path;
+        var params = this.setupFullMustacheParams(decorator, program, void 0), path17 = decorator.path;
         this.useDecorators = true;
-        this.opcode("registerDecorator", params.length, path16.original);
+        this.opcode("registerDecorator", params.length, path17.original);
       },
       PartialStatement: function PartialStatement(partial) {
         this.usePartial = true;
@@ -2700,46 +2700,46 @@ var require_compiler = __commonJS({
         }
       },
       ambiguousSexpr: function ambiguousSexpr(sexpr, program, inverse) {
-        var path16 = sexpr.path, name = path16.parts[0], isBlock = program != null || inverse != null;
-        this.opcode("getContext", path16.depth);
+        var path17 = sexpr.path, name = path17.parts[0], isBlock = program != null || inverse != null;
+        this.opcode("getContext", path17.depth);
         this.opcode("pushProgram", program);
         this.opcode("pushProgram", inverse);
-        path16.strict = true;
-        this.accept(path16);
+        path17.strict = true;
+        this.accept(path17);
         this.opcode("invokeAmbiguous", name, isBlock);
       },
       simpleSexpr: function simpleSexpr(sexpr) {
-        var path16 = sexpr.path;
-        path16.strict = true;
-        this.accept(path16);
+        var path17 = sexpr.path;
+        path17.strict = true;
+        this.accept(path17);
         this.opcode("resolvePossibleLambda");
       },
       helperSexpr: function helperSexpr(sexpr, program, inverse) {
-        var params = this.setupFullMustacheParams(sexpr, program, inverse), path16 = sexpr.path, name = path16.parts[0];
+        var params = this.setupFullMustacheParams(sexpr, program, inverse), path17 = sexpr.path, name = path17.parts[0];
         if (this.options.knownHelpers[name]) {
           this.opcode("invokeKnownHelper", params.length, name);
         } else if (this.options.knownHelpersOnly) {
           throw new _exception2["default"]("You specified knownHelpersOnly, but used the unknown helper " + name, sexpr);
         } else {
-          path16.strict = true;
-          path16.falsy = true;
-          this.accept(path16);
-          this.opcode("invokeHelper", params.length, path16.original, _ast2["default"].helpers.simpleId(path16));
+          path17.strict = true;
+          path17.falsy = true;
+          this.accept(path17);
+          this.opcode("invokeHelper", params.length, path17.original, _ast2["default"].helpers.simpleId(path17));
         }
       },
-      PathExpression: function PathExpression(path16) {
-        this.addDepth(path16.depth);
-        this.opcode("getContext", path16.depth);
-        var name = path16.parts[0], scoped = _ast2["default"].helpers.scopedId(path16), blockParamId = !path16.depth && !scoped && this.blockParamIndex(name);
+      PathExpression: function PathExpression(path17) {
+        this.addDepth(path17.depth);
+        this.opcode("getContext", path17.depth);
+        var name = path17.parts[0], scoped = _ast2["default"].helpers.scopedId(path17), blockParamId = !path17.depth && !scoped && this.blockParamIndex(name);
         if (blockParamId) {
-          this.opcode("lookupBlockParam", blockParamId, path16.parts);
+          this.opcode("lookupBlockParam", blockParamId, path17.parts);
         } else if (!name) {
           this.opcode("pushContext");
-        } else if (path16.data) {
+        } else if (path17.data) {
           this.options.data = true;
-          this.opcode("lookupData", path16.depth, path16.parts, path16.strict);
+          this.opcode("lookupData", path17.depth, path17.parts, path17.strict);
         } else {
-          this.opcode("lookupOnContext", path16.parts, path16.falsy, path16.strict, scoped);
+          this.opcode("lookupOnContext", path17.parts, path17.falsy, path17.strict, scoped);
         }
       },
       StringLiteral: function StringLiteral(string) {
@@ -3095,16 +3095,16 @@ var require_util = __commonJS({
     }
     exports.urlGenerate = urlGenerate;
     function normalize(aPath) {
-      var path16 = aPath;
+      var path17 = aPath;
       var url = urlParse(aPath);
       if (url) {
         if (!url.path) {
           return aPath;
         }
-        path16 = url.path;
+        path17 = url.path;
       }
-      var isAbsolute = exports.isAbsolute(path16);
-      var parts = path16.split(/\/+/);
+      var isAbsolute = exports.isAbsolute(path17);
+      var parts = path17.split(/\/+/);
       for (var part, up = 0, i = parts.length - 1; i >= 0; i--) {
         part = parts[i];
         if (part === ".") {
@@ -3121,15 +3121,15 @@ var require_util = __commonJS({
           }
         }
       }
-      path16 = parts.join("/");
-      if (path16 === "") {
-        path16 = isAbsolute ? "/" : ".";
+      path17 = parts.join("/");
+      if (path17 === "") {
+        path17 = isAbsolute ? "/" : ".";
       }
       if (url) {
-        url.path = path16;
+        url.path = path17;
         return urlGenerate(url);
       }
-      return path16;
+      return path17;
     }
     exports.normalize = normalize;
     function join(aRoot, aPath) {
@@ -5932,8 +5932,8 @@ var require_printer = __commonJS({
       return this.accept(sexpr.path) + " " + params + hash;
     };
     PrintVisitor.prototype.PathExpression = function(id) {
-      var path16 = id.parts.join("/");
-      return (id.data ? "@" : "") + "PATH:" + path16;
+      var path17 = id.parts.join("/");
+      return (id.data ? "@" : "") + "PATH:" + path17;
     };
     PrintVisitor.prototype.StringLiteral = function(string) {
       return '"' + string.value + '"';
@@ -6053,7 +6053,7 @@ var require_win32 = __commonJS({
   "node_modules/chrome-finder/lib/win32.js"(exports, module) {
     "use strict";
     init_esm_shims();
-    var path16 = __require("path");
+    var path17 = __require("path");
     var { canAccess } = require_util2();
     function win32() {
       const installations = [];
@@ -6067,7 +6067,7 @@ var require_win32 = __commonJS({
       const prefixes = [process.env.LOCALAPPDATA, process.env.PROGRAMFILES, process.env["PROGRAMFILES(X86)"]];
       prefixes.forEach((prefix) => suffixes.forEach((suffix) => {
         if (prefix) {
-          const chromePath = path16.join(prefix, suffix);
+          const chromePath = path17.join(prefix, suffix);
           if (canAccess(chromePath)) {
             installations.push(chromePath);
           }
@@ -6085,7 +6085,7 @@ var require_darwin = __commonJS({
     "use strict";
     init_esm_shims();
     var { execSync: execSync3 } = __require("child_process");
-    var path16 = __require("path");
+    var path17 = __require("path");
     var { canAccess, newLineRegex, sort } = require_util2();
     function darwin() {
       const suffixes = ["/Contents/MacOS/Google Chrome Canary", "/Contents/MacOS/Google Chrome", "/Contents/MacOS/Chromium"];
@@ -6095,7 +6095,7 @@ var require_darwin = __commonJS({
     ${LSREGISTER} -dump | grep -E -i -o '/.+(google chrome( canary)?|chromium)\\.app(\\s|$)' | grep -E -v 'Caches|TimeMachine|Temporary|/Volumes|\\.Trash'
   `).toString().split(newLineRegex).forEach((inst) => {
         suffixes.forEach((suffix) => {
-          const execPath = path16.join(inst.trim(), suffix);
+          const execPath = path17.join(inst.trim(), suffix);
           if (canAccess(execPath)) {
             installations.push(execPath);
           }
@@ -6124,7 +6124,7 @@ var require_linux = __commonJS({
     "use strict";
     init_esm_shims();
     var { execSync: execSync3, execFileSync } = __require("child_process");
-    var path16 = __require("path");
+    var path17 = __require("path");
     var fs16 = __require("fs");
     var { canAccess, sort, isExecutable, newLineRegex } = require_util2();
     function findChromeExecutablesForLinuxDesktop(folder) {
@@ -6142,7 +6142,7 @@ var require_linux = __commonJS({
     function linux() {
       let installations = [];
       const desktopInstallationFolders = [
-        path16.join(__require("os").homedir(), ".local/share/applications/"),
+        path17.join(__require("os").homedir(), ".local/share/applications/"),
         "/usr/share/applications/"
       ];
       desktopInstallationFolders.forEach((folder) => {
@@ -6750,8 +6750,8 @@ function getErrorMap() {
 // node_modules/zod/v3/helpers/parseUtil.js
 init_esm_shims();
 var makeIssue = (params) => {
-  const { data, path: path16, errorMaps, issueData } = params;
-  const fullPath = [...path16, ...issueData.path || []];
+  const { data, path: path17, errorMaps, issueData } = params;
+  const fullPath = [...path17, ...issueData.path || []];
   const fullIssue = {
     ...issueData,
     path: fullPath
@@ -6871,11 +6871,11 @@ var errorUtil;
 
 // node_modules/zod/v3/types.js
 var ParseInputLazyPath = class {
-  constructor(parent, value, path16, key) {
+  constructor(parent, value, path17, key) {
     this._cachedPath = [];
     this.parent = parent;
     this.data = value;
-    this._path = path16;
+    this._path = path17;
     this._key = key;
   }
   get path() {
@@ -10331,6 +10331,7 @@ var DEFAULT_OPTIONS = {
   historySize: 10,
   showTrend: true,
   flakinessTopN: 5,
+  quarantineThreshold: 40,
   slowTestThreshold: 10,
   // Ticket-ID shape: @ODP-5328, REQ-001, JIRA-123. Tags matching this land in
   // the Requirements Traceability matrix; the rest fall to the tag summary.
@@ -10585,6 +10586,10 @@ var ReporterOptionsSchema = external_exports.object({
   // local history file is wiped every run. Aggregate numbers only.
   remoteHistory: external_exports.boolean().default(false),
   flakinessTopN: external_exports.number().int().min(0, "flakinessTopN must be 0 or greater").optional().default(DEFAULT_OPTIONS.flakinessTopN),
+  quarantineThreshold: external_exports.number().int().min(0, "quarantineThreshold must be between 0 and 100").max(100, "quarantineThreshold must be between 0 and 100").optional().default(DEFAULT_OPTIONS.quarantineThreshold),
+  evidenceUrlTemplate: external_exports.string().refine((s) => s.includes("{path}"), {
+    message: "evidenceUrlTemplate must contain the {path} token"
+  }).optional(),
   slowTestThreshold: external_exports.number().int().min(0, "slowTestThreshold must be 0 or greater").optional().default(DEFAULT_OPTIONS.slowTestThreshold),
   requirementTagPattern: external_exports.string().refine((v) => {
     try {
@@ -13374,7 +13379,7 @@ var Redactor = class {
 
 // src/pipeline/orchestrator.ts
 init_esm_shims();
-import path15 from "path";
+import path16 from "path";
 
 // src/license/update-notice.ts
 init_esm_shims();
@@ -13791,8 +13796,8 @@ function buildBrowserMatrix(projects, cap = DEFAULT_ROW_CAP) {
   let projectNames = projects.map((p, i) => p.name || `project ${i + 1}`);
   const byTest = /* @__PURE__ */ new Map();
   projects.forEach((project, column) => {
-    walk(project.suites, [], (path16, test) => {
-      const key = [...path16, test.title].join(" > ");
+    walk(project.suites, [], (path17, test) => {
+      const key = [...path17, test.title].join(" > ");
       let statuses = byTest.get(key);
       if (!statuses) {
         statuses = projectNames.map(() => null);
@@ -13835,14 +13840,66 @@ function buildBrowserMatrix(projects, cap = DEFAULT_ROW_CAP) {
 function severityRank(row) {
   return row.statuses.some((s) => s === "failed" || s === "timedOut") ? 1 : 0;
 }
-function walk(suites, path16, visit) {
+function walk(suites, path17, visit) {
   for (const suite of suites) {
-    const next = [...path16, suite.title];
+    const next = [...path17, suite.title];
     for (const test of suite.tests) visit(next, test);
     walk(suite.suites, next, visit);
   }
 }
 
+// src/utils/evidence-links.ts
+init_esm_shims();
+import path14 from "path";
+import qrcodeFactory from "qrcode-generator";
+function applyEvidenceUrls(data, template, cwd) {
+  let warned = false;
+  const warnOnce = (err) => {
+    if (warned) return;
+    warned = true;
+    const message = err instanceof Error ? err.message : String(err);
+    logger.warn(`evidenceUrlTemplate: link generation failed for at least one artifact \u2014 ${message}`);
+  };
+  for (const failure of data.failures) {
+    const evidence = failure.execution?.evidence;
+    if (!evidence) continue;
+    if (evidence.tracePath) {
+      try {
+        evidence.traceUrl = expandTemplate(template, relativizeArtifact(evidence.tracePath, cwd));
+        evidence.traceQr = qrDataUri(evidence.traceUrl);
+      } catch (err) {
+        warnOnce(err);
+      }
+    }
+    if (evidence.videoPath) {
+      try {
+        evidence.videoUrl = expandTemplate(template, relativizeArtifact(evidence.videoPath, cwd));
+        evidence.videoQr = qrDataUri(evidence.videoUrl);
+      } catch (err) {
+        warnOnce(err);
+      }
+    }
+  }
+}
+function relativizeArtifact(artifactPath, cwd) {
+  if (!path14.isAbsolute(artifactPath)) return artifactPath;
+  const rel = path14.relative(cwd, artifactPath);
+  if (rel === ".." || rel.startsWith(`..${path14.sep}`) || path14.isAbsolute(rel)) return artifactPath;
+  return rel;
+}
+function expandTemplate(template, artifactPath) {
+  const normalized = artifactPath.replace(/\\/g, "/");
+  const encoded = normalized.split("/").map((seg) => encodeURIComponent(seg)).join("/");
+  return template.split("{path}").join(encoded);
+}
+function qrDataUri(url) {
+  const qr = qrcodeFactory(0, "M");
+  qr.addData(url);
+  qr.make();
+  const svg = qr.createSvgTag({ cellSize: 2, margin: 2, scalable: true });
+  return `data:image/svg+xml;base64,${Buffer.from(svg, "utf8").toString("base64")}`;
+}
+
 // src/redact/redact-report.ts
 init_esm_shims();
 function redactReportData(data, r) {
@@ -13899,7 +13956,7 @@ function redactSuite(s, r) {
 // src/history/HistoryManager.ts
 init_esm_shims();
 import fs15 from "fs";
-import path14 from "path";
+import path15 from "path";
 var HistoryManager = class {
   constructor(filePath) {
     this.filePath = filePath;
@@ -13920,7 +13977,7 @@ var HistoryManager = class {
   }
   append(entry, maxSize) {
     try {
-      fs15.mkdirSync(path14.dirname(this.filePath), { recursive: true });
+      fs15.mkdirSync(path15.dirname(this.filePath), { recursive: true });
       const next = {
         version: 1,
         entries: [entry, ...this.read()].slice(0, maxSize)
@@ -14008,7 +14065,7 @@ function splitBaselineResolved(baselineFailed, currentFailedIds, currentStatuses
   return { fixed, noLongerRun };
 }
 function computeRunDiff(args) {
-  const { currentFailing, currentStatuses, priorEntries, branch } = args;
+  const { currentFailing, currentFlaky = [], 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();
@@ -14017,7 +14074,15 @@ function computeRunDiff(args) {
   }
   const { newFailures, stillFailing, currentFailedIds } = splitCurrentFailing(currentFailing, baselineFailed);
   const { fixed, noLongerRun } = splitBaselineResolved(baselineFailed, currentFailedIds, currentStatuses);
-  for (const bucket of [newFailures, stillFailing, fixed, noLongerRun]) {
+  const baselineFlakyIds = new Set((baseline.flakyTests ?? []).map((t) => t.id));
+  const newlyFlaky = [];
+  const seenFlaky = /* @__PURE__ */ new Set();
+  for (const item of currentFlaky) {
+    if (seenFlaky.has(item.id) || baselineFlakyIds.has(item.id)) continue;
+    seenFlaky.add(item.id);
+    newlyFlaky.push(item);
+  }
+  for (const bucket of [newFailures, stillFailing, fixed, noLongerRun, newlyFlaky]) {
     bucket.sort((a, b) => a.title.localeCompare(b.title));
   }
   return {
@@ -14025,6 +14090,7 @@ function computeRunDiff(args) {
     stillFailing,
     fixed,
     noLongerRun,
+    newlyFlaky,
     baselineRunId: baseline.runId,
     baselineTimestamp: baseline.timestamp,
     baselineTruncated: baseline.failedTestsTruncated === true
@@ -14033,10 +14099,11 @@ function computeRunDiff(args) {
 
 // src/history/FlakinessAnalyser.ts
 init_esm_shims();
-function computeTopN(entries, topN) {
-  if (topN === 0) return [];
+var QUARANTINE_MIN_RUNS = 3;
+function computeTopN(entries, topN, quarantineThreshold = 0) {
+  if (topN === 0) return { rows: [], quarantineTotal: 0 };
   const qualifying = entries.filter((e) => Array.isArray(e.flakyTests));
-  if (qualifying.length === 0) return [];
+  if (qualifying.length === 0) return { rows: [], quarantineTotal: 0 };
   const map = /* @__PURE__ */ new Map();
   qualifying.forEach((entry, idx) => {
     const seen = /* @__PURE__ */ new Set();
@@ -14054,17 +14121,26 @@ function computeTopN(entries, topN) {
       const originalIdx = qualifying.length - 1 - reversedIdx;
       return hits.has(originalIdx);
     });
+    let streak = 0;
+    while (streak < totalRuns && hits.has(streak)) streak++;
+    const flakeRate = Math.round(flakeCount / totalRuns * 100);
     return {
       title,
-      flakeRate: Math.round(flakeCount / totalRuns * 100),
+      flakeRate,
       flakeCount,
       totalRuns,
-      sparkline
+      sparkline,
+      streak,
+      quarantine: quarantineThreshold > 0 && totalRuns >= QUARANTINE_MIN_RUNS && flakeRate >= quarantineThreshold
     };
   });
-  return rows.sort(
-    (a, b) => b.flakeRate - a.flakeRate || b.flakeCount - a.flakeCount || a.title.localeCompare(b.title)
-  ).slice(0, topN);
+  const quarantineTotal = rows.filter((r) => r.quarantine).length;
+  return {
+    rows: rows.sort(
+      (a, b) => b.flakeRate - a.flakeRate || b.flakeCount - a.flakeCount || a.title.localeCompare(b.title)
+    ).slice(0, topN),
+    quarantineTotal
+  };
 }
 
 // src/notify/index.ts
@@ -14507,6 +14583,9 @@ async function runReportPipeline(hooks) {
     }
   }
   const reportData = buildReportData(collected, licenseInfo, hooks);
+  if (options.evidenceUrlTemplate) {
+    applyEvidenceUrls(reportData, options.evidenceUrlTemplate, hooks.cwd);
+  }
   runFailureAnalysis(reportData, options, hooks.cwd);
   reportData.briefSentence = buildBriefSentence(reportData.stats, reportData.analysis, reportData.charts.trend);
   if (hooks.redactor) {
@@ -14555,7 +14634,7 @@ async function appendTrend(collected, licenseInfo, hooks) {
     branch: collected.environment.branch
   };
   const localEntries = hm.append(entry, options.historySize);
-  collected.runDiff = resolveRunDiff(collected.projects, redactedFailing, localEntries.slice(1), collected.environment.branch);
+  collected.runDiff = resolveRunDiff(collected.projects, redactedFailing, localEntries.slice(1), collected.environment.branch, flakyTests);
   let trendEntries = localEntries;
   if (options.remoteHistory && licenseInfo.jwt) {
     const serverUrl = options.serverUrl ?? process.env.REPORTFORGE_SERVER_URL ?? DEFAULT_SERVER_URL;
@@ -14588,9 +14667,17 @@ function populateHistoryCharts(trendEntries, localEntries, collected, options) {
     };
   }
   if (options.flakinessTopN > 0) {
-    const table = computeTopN(localEntries, options.flakinessTopN);
-    if (table.length > 0) {
-      collected.charts.flakinessTable = table;
+    const { rows, quarantineTotal } = computeTopN(
+      localEntries,
+      options.flakinessTopN,
+      options.quarantineThreshold
+    );
+    if (rows.length > 0) {
+      collected.charts.flakinessTable = rows;
+      if (quarantineTotal > 0) {
+        collected.charts.flakinessQuarantineTotal = quarantineTotal;
+        collected.charts.flakinessQuarantineThreshold = options.quarantineThreshold;
+      }
     }
   }
 }
@@ -14623,7 +14710,7 @@ function buildReportData(collected, licenseInfo, hooks) {
 }
 function resolveProjectNameFromPkg(cwd) {
   try {
-    const pkgPath = path15.resolve(cwd, "package.json");
+    const pkgPath = path16.resolve(cwd, "package.json");
     const pkg = __require(pkgPath);
     return pkg.name ?? "Playwright Tests";
   } catch {
@@ -14672,9 +14759,9 @@ function deriveVerdict(stats) {
 }
 function resolveHistoryPath(options, cwd) {
   if (options.historyFile) {
-    return path15.isAbsolute(options.historyFile) ? options.historyFile : path15.resolve(cwd, options.historyFile);
+    return path16.isAbsolute(options.historyFile) ? options.historyFile : path16.resolve(cwd, options.historyFile);
   }
-  return path15.join(resolveProjectDir(options, cwd), "history.json");
+  return path16.join(resolveProjectDir(options, cwd), "history.json");
 }
 function flattenSuiteNodes(suites) {
   return suites.flatMap((s) => [s, ...flattenSuiteNodes(s.suites)]);
@@ -14727,9 +14814,10 @@ function buildFailedTestsFields(projects, redactor) {
   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) {
+function resolveRunDiff(projects, currentFailing, priorEntries, branch, currentFlaky) {
   return computeRunDiff({
     currentFailing,
+    currentFlaky,
     currentStatuses: collectCurrentStatuses(projects),
     priorEntries,
     branch
@@ -15249,9 +15337,9 @@ var MAX_FILE_CHARS = 300;
 var MAX_PROJECT_CHARS = 100;
 var MAX_SUITE_SEGMENTS = 10;
 function suiteIdentity(test) {
-  const path16 = typeof test.titlePath === "function" ? test.titlePath() : [];
-  if (!Array.isArray(path16) || path16.length < 4) return {};
-  const [, project, file, ...rest] = path16;
+  const path17 = typeof test.titlePath === "function" ? test.titlePath() : [];
+  if (!Array.isArray(path17) || path17.length < 4) return {};
+  const [, project, file, ...rest] = path17;
   const describes = rest.slice(0, -1);
   const out = {};
   if (typeof file === "string" && file) {
@@ -15370,7 +15458,7 @@ var PdfReporter = class {
     if (this.options.redact.enabled) {
       this.redactor = new Redactor(this.options.redact);
     }
-    this.version = true ? "0.29.0" : "0.x";
+    this.version = true ? "0.31.0" : "0.x";
     logger.info(`@reportforge/playwright-pdf v${this.version} initialised`);
     this.licenseClient = new LicenseClient({
       licenseKey: this.options.licenseKey,

package/dist/templates/partials/charts.hbs

@@ -13,21 +13,29 @@
   <div class="flakiness-card__header">
     <span class="flakiness-card__title">Top flaky tests &mdash; last {{charts.flakinessTable.[0].totalRuns}} runs</span>
   </div>
+  {{#if charts.flakinessQuarantineTotal}}
+  <div class="flakiness-quarantine-callout">
+    <strong>{{charts.flakinessQuarantineTotal}} {{pluralise charts.flakinessQuarantineTotal "test exceeds" "tests exceed"}} the {{#if charts.flakinessQuarantineThreshold}}{{charts.flakinessQuarantineThreshold}}% {{/if}}quarantine threshold.</strong>
+    Quarantine or stabilize {{pluralise charts.flakinessQuarantineTotal "it before it masks" "them before they mask"}} real regressions.
+  </div>
+  {{/if}}
   <table class="flakiness-table">
     <thead>
       <tr>
         <th class="flakiness-table__test">Test</th>
         <th class="flakiness-table__rate">Flake rate</th>
         <th class="flakiness-table__count">Runs flaky</th>
+        <th class="flakiness-table__streak">Streak</th>
         <th class="flakiness-table__spark">History</th>
       </tr>
     </thead>
     <tbody>
       {{#each charts.flakinessTable}}
       <tr>
-        <td class="flakiness-table__test" title="{{this.title}}">{{this.title}}</td>
+        <td class="flakiness-table__test" title="{{this.title}}"><span class="flakiness-table__test-inner"><span class="flakiness-table__test-title">{{this.title}}</span>{{#if this.quarantine}}<span class="quarantine-chip">QUARANTINE</span>{{/if}}</span></td>
         <td class="flakiness-table__rate">{{this.flakeRate}}%</td>
         <td class="flakiness-table__count">{{this.flakeCount}} / {{this.totalRuns}}</td>
+        <td class="flakiness-table__streak">{{#if this.streak}}{{this.streak}}&times;{{else}}&ndash;{{/if}}</td>
         <td class="flakiness-table__spark">
           <span class="flaky-spark">
             {{#each this.sparkline}}

package/dist/templates/partials/defect-log.hbs

@@ -64,8 +64,8 @@
 
             {{#if execution.evidence}}
             <div class="evidence-links">
-              {{#if execution.evidence.tracePath}}<span class="evidence-link"><span class="evidence-link__tag">Trace</span><span class="evidence-link__path">{{execution.evidence.tracePath}}</span></span>{{/if}}
-              {{#if execution.evidence.videoPath}}<span class="evidence-link"><span class="evidence-link__tag">Video</span><span class="evidence-link__path">{{execution.evidence.videoPath}}</span></span>{{/if}}
+              {{#if execution.evidence.tracePath}}<span class="evidence-link"><span class="evidence-link__tag">Trace</span>{{#if execution.evidence.traceUrl}}<a class="evidence-link__path evidence-link__path--url" href="{{execution.evidence.traceUrl}}">{{execution.evidence.traceUrl}}</a>{{#if execution.evidence.traceQr}}<img class="evidence-link__qr" src="{{execution.evidence.traceQr}}" alt="Trace QR" />{{/if}}{{else}}<span class="evidence-link__path">{{execution.evidence.tracePath}}</span>{{/if}}</span>{{/if}}
+              {{#if execution.evidence.videoPath}}<span class="evidence-link"><span class="evidence-link__tag">Video</span>{{#if execution.evidence.videoUrl}}<a class="evidence-link__path evidence-link__path--url" href="{{execution.evidence.videoUrl}}">{{execution.evidence.videoUrl}}</a>{{#if execution.evidence.videoQr}}<img class="evidence-link__qr" src="{{execution.evidence.videoQr}}" alt="Video QR" />{{/if}}{{else}}<span class="evidence-link__path">{{execution.evidence.videoPath}}</span>{{/if}}</span>{{/if}}
             </div>
             {{/if}}
           </div>

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

@@ -3,7 +3,7 @@
   <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}}
+      <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.newlyFlaky.length}}&nbsp;&middot;&nbsp;<span class="run-diff__count run-diff__count--flaky"><strong>{{runDiff.newlyFlaky.length}}</strong> newly flaky</span>{{/if}}{{#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}}
@@ -13,6 +13,7 @@
 
   {{#if (eq variant 'full')}}
   {{> run-diff-list items=runDiff.newFailures label="New Failures" }}
+  {{> run-diff-list items=runDiff.newlyFlaky label="Newly Flaky" }}
   {{> run-diff-list items=runDiff.fixed label="Fixed" }}
   {{> run-diff-list items=runDiff.stillFailing label="Still Failing" }}
   {{#if runDiff.noLongerRun.length}}

package/dist/templates/styles/base.css

@@ -978,3 +978,34 @@ code {
 .browser-matrix__note {
   font-size: 9px; color: var(--text-3); margin-top: 6px;
 }
+
+/* ── Flaky intelligence (quarantine + streak) ───────────────────────────── */
+/* The title cell ellipsizes; the chip must never be the part that clips, so
+   the cell content is a flex row: shrinking title span + fixed chip. */
+.flakiness-table__test-inner { display: flex; align-items: center; gap: 5px; min-width: 0; }
+.flakiness-table__test-title { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; min-width: 0; }
+.flakiness-quarantine-callout {
+  font-size: 9.5px; color: var(--text-2);
+  background: var(--flaky-dim);
+  border: 1px solid var(--flaky);
+  border-radius: 6px; padding: 7px 10px; margin-bottom: 10px;
+}
+.quarantine-chip {
+  flex: none;
+  font-family: 'Inter', system-ui, sans-serif; font-weight: 700;
+  font-size: 6.5px; letter-spacing: 0.7px;
+  color: var(--flaky); border: 1px solid var(--flaky);
+  border-radius: 3px; padding: 1px 4px;
+}
+.flakiness-table__streak { text-align: center; width: 52px; }
+.run-diff__count--flaky strong { color: var(--flaky); }
+
+/* ── Evidence deep links + QR (evidenceUrlTemplate) ─────────────────────── */
+.evidence-link__path--url {
+  color: var(--accent); text-decoration: none;
+  word-break: break-all;
+}
+.evidence-link__qr {
+  width: 44px; height: 44px; margin-left: 8px; vertical-align: middle;
+  border: 1px solid var(--border); border-radius: 3px; background: #fff;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reportforge/playwright-pdf",
-  "version": "0.29.0",
+  "version": "0.31.0",
   "description": "Playwright Test reporter that generates designed PDF reports: minimal, detailed, and executive templates with CI/CD integrations",
   "license": "Elastic-2.0",
   "author": "ReportForge",
@@ -91,6 +91,7 @@
     "chrome-finder": "^1.0.7",
     "glob": "^13.0.6",
     "handlebars": "^4.7.8",
+    "qrcode-generator": "^2.0.4",
     "sharp": "^0.35.3",
     "zod": "^3.23.8"
   },