@reportforge/playwright-pdf 0.18.0 → 0.19.1

package/CHANGELOG.md

@@ -3,6 +3,29 @@
 All notable changes to this project will be documented in this file.
 Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## [0.19.1] - 2026-07-11
+
+### Fixed
+
+- **A blank browser window no longer flashes during report generation on Windows.** Chrome's new headless mode (the only mode left in Chrome 132+) briefly uncloaks a window on some Windows/GPU combinations; the PDF renderer now parks that window far off-screen. No effect on PDF output or other platforms.
+
+---
+
+## [0.19.0] - 2026-07-11
+
+### Added
+
+- **New `logLevel` option** (`'silent' | 'error' | 'warn' | 'info' | 'debug'`, default `'info'`) controls how chatty the reporter's `[reportforge]` console lines are. `'debug'` prints the same diagnostics as `RF_DEBUG=1` (useful in CI where env vars are awkward to set); `'silent'` suppresses everything, including error lines. `RF_DEBUG=1` always forces debug output, overriding the option, so "set `RF_DEBUG=1` and send the log" keeps working regardless of config.
+- **`RF_DEBUG=1` now explains previously silent failure paths**: license cache reads/writes, cached-token rejection (including exactly why the reporter re-activated instead of serving from cache), device-id persistence, Chrome discovery, and the qpdf availability probe.
+
+### Changed
+
+- A failed write of `~/.reportforge/device.json` now logs a warning, because it means this machine may register a new license seat on every run.
+- The live watch URL is printed once instead of twice; the banner link line now carries the `[reportforge]` prefix so it stays greppable in CI logs.
+- CLI output prefixes are consistent: the `demo` and `export-feedback` commands use the same `[reportforge]` prefix as the reporter.
+
+---
+
 ## [0.18.0] - 2026-07-11
 
 ### Changed

package/README.md

@@ -189,6 +189,7 @@ All options are the second element of the reporter tuple.
 | `reportTitle` | `string` | `'Playwright Test Report'` | Custom title for the report cover page and running header. |
 | `projectName` | `string` | from `package.json` | Project or application name. Inferred from the `package.json` `name` field if absent. |
 | `open` | `boolean` | `false` | Open the generated PDF automatically after generation. For local use only; ignored in CI. |
+| `logLevel` | `'silent' \| 'error' \| 'warn' \| 'info' \| 'debug'` | `'info'` | Console verbosity for `[reportforge]` log lines. `'silent'` suppresses everything including errors; `'debug'` adds diagnostics. The `RF_DEBUG=1` env var always forces debug, overriding this option. |
 | `puppeteerExecutablePath` | `string` | auto-detect | Full path to a Chrome or Chromium binary. Falls back to `PUPPETEER_EXECUTABLE_PATH` env, then system Chrome discovery. |
 | `serverUrl` | `string` | `'https://reportforge.org'` | Base URL for the ReportForge licensing server. Override only for self-hosting or local development. |
 | `compressionLevel` | `'auto' \| 'none' \| 'balanced' \| 'max'` | `'auto'` | Screenshot JPEG quality preset. `'auto'` picks based on failure volume; `'none'` keeps original PNGs; `'balanced'` uses JPEG q85; `'max'` uses JPEG q70. |
@@ -644,6 +645,18 @@ Set `RF_DEBUG=1` to log the full activation flow and error stack traces:
 RF_DEBUG=1 npx playwright test 2>&1 | grep '\[reportforge\]'
 ```
 
+### Controlling log output
+
+The `logLevel` option sets how chatty the reporter's `[reportforge]` console lines are:
+
+```ts
+['@reportforge/playwright-pdf', { logLevel: 'warn' }]  // warnings and errors only
+```
+
+- `'debug'` prints the same diagnostics as `RF_DEBUG=1` — useful in CI where env vars are awkward to set.
+- `'silent'` suppresses everything, **including error lines**: a failed PDF then surfaces only as a missing file, because the reporter never fails your test run.
+- `RF_DEBUG=1` always forces debug output, overriding `logLevel` — it is the support escape hatch, so "set `RF_DEBUG=1` and send the log" works no matter what the config says.
+
 Common issues:
 
 - **`Chrome/Chromium not found`** → install Google Chrome Stable; don't use the Ubuntu `chromium-browser` snap.

package/dist/cli/index.js

@@ -42,24 +42,32 @@ var init_cjs_shims = __esm({
 });
 
 // src/utils/logger.ts
-var PREFIX, logger;
+function isLevelEnabled(level) {
+  return LEVELS[level] >= (process.env.RF_DEBUG ? LEVELS.debug : threshold);
+}
+var PREFIX, LEVELS, threshold, logger;
 var init_logger = __esm({
   "src/utils/logger.ts"() {
     "use strict";
     init_cjs_shims();
     PREFIX = "[reportforge]";
+    LEVELS = { debug: 10, info: 20, warn: 30, error: 40, silent: 99 };
+    threshold = LEVELS.info;
     logger = {
       info(msg) {
+        if (!isLevelEnabled("info")) return;
         console.log(`${PREFIX} ${msg}`);
       },
       warn(msg) {
+        if (!isLevelEnabled("warn")) return;
         console.warn(`${PREFIX} WARN: ${msg}`);
       },
       error(msg) {
+        if (!isLevelEnabled("error")) return;
         console.error(`${PREFIX} ERROR: ${msg}`);
       },
       debug(msg, data) {
-        if (!process.env.RF_DEBUG) return;
+        if (!isLevelEnabled("debug")) return;
         const suffix = data !== void 0 ? `
 ${JSON.stringify(data, null, 2)}` : "";
         console.log(`${PREFIX} DEBUG: ${msg}${suffix}`);
@@ -7228,7 +7236,7 @@ var require_lib2 = __commonJS({
 });
 
 // src/pdf/BrowserManager.ts
-var import_child_process, import_fs3, BrowserManager;
+var import_child_process, import_fs3, LAUNCH_ARGS, BrowserManager;
 var init_BrowserManager = __esm({
   "src/pdf/BrowserManager.ts"() {
     "use strict";
@@ -7236,29 +7244,33 @@ var init_BrowserManager = __esm({
     import_child_process = require("child_process");
     import_fs3 = __toESM(require("fs"));
     init_logger();
+    LAUNCH_ARGS = [
+      "--no-sandbox",
+      "--disable-setuid-sandbox",
+      "--disable-dev-shm-usage",
+      "--disable-gpu",
+      // Chrome's new headless mode (--headless=new, the only mode left in
+      // Chrome 132+) briefly uncloaks a blank window on some Windows/GPU
+      // combinations. Parking the window far off-screen makes that transient
+      // invisible; harmless everywhere else and does not affect PDF output.
+      "--window-position=-32000,-32000"
+    ];
     BrowserManager = class {
       async launch(executablePath) {
         const puppeteer = require("puppeteer-core");
         const chromePath = this.resolveChromePath(executablePath, puppeteer);
         logger.info(`Launching browser: ${chromePath ?? "puppeteer default"}`);
-        const launchArgs = [
-          "--no-sandbox",
-          "--disable-setuid-sandbox",
-          "--disable-dev-shm-usage",
-          "--disable-gpu"
-        ];
         this.browser = await puppeteer.launch({
           executablePath: chromePath,
           headless: true,
-          args: launchArgs
+          args: LAUNCH_ARGS
         });
         const page = await this.browser.newPage();
         return { browser: this.browser, page };
       }
       async close() {
         if (this.browser) {
-          await this.browser.close().catch(() => {
-          });
+          await this.browser.close().catch((err) => logger.debug("browser close failed (ignored)", { error: err.message }));
           this.browser = void 0;
         }
       }
@@ -7270,7 +7282,8 @@ var init_BrowserManager = __esm({
           const chromeFinder = require_lib2();
           const found = chromeFinder();
           if (found && import_fs3.default.existsSync(found)) return found;
-        } catch {
+        } catch (err) {
+          logger.debug("chrome discovery: chrome-finder failed", { error: err.message });
         }
         const linuxPaths = [
           "/usr/bin/google-chrome",
@@ -7288,12 +7301,14 @@ var init_BrowserManager = __esm({
           }).toString().trim().split("\n")[0];
           if (found && import_fs3.default.existsSync(found)) return found;
         } catch {
+          logger.debug("chrome discovery: which lookup found nothing");
         }
         if (puppeteer.executablePath) {
           try {
             const bundled = puppeteer.executablePath();
             if (bundled && import_fs3.default.existsSync(bundled)) return bundled;
-          } catch {
+          } catch (err) {
+            logger.debug("chrome discovery: no puppeteer bundled executable", { error: err.message });
           }
         }
         logger.warn(
@@ -7315,6 +7330,7 @@ var init_HtmlWriter = __esm({
     import_os = __toESM(require("os"));
     import_path2 = __toESM(require("path"));
     import_crypto = __toESM(require("crypto"));
+    init_logger();
     HtmlWriter = class {
       async write(html) {
         const tmpDir = import_os.default.tmpdir();
@@ -7325,8 +7341,10 @@ var init_HtmlWriter = __esm({
       }
       async cleanup() {
         if (this.tempPath) {
-          await import_fs4.default.promises.unlink(this.tempPath).catch(() => {
-          });
+          const tempPath = this.tempPath;
+          await import_fs4.default.promises.unlink(tempPath).catch(
+            (err) => logger.debug("temp HTML cleanup failed (ignored)", { path: tempPath, error: err.message })
+          );
           this.tempPath = void 0;
         }
       }
@@ -7405,7 +7423,8 @@ var init_PdfEncryptor = __esm({
         try {
           (0, import_child_process2.execFileSync)("qpdf", ["--version"], { stdio: "pipe" });
           return true;
-        } catch {
+        } catch (err) {
+          logger.debug("qpdf probe failed \u2014 treating as not installed", { error: err.message });
           return false;
         }
       }
@@ -7638,7 +7657,8 @@ var init_PdfGenerator = __esm({
           if (CHARTJS_BUNDLE2) {
             this.templateEngine.setChartjsBundle(CHARTJS_BUNDLE2);
           }
-        } catch {
+        } catch (err) {
+          logger.debug("chartjs bundle not available \u2014 charts disabled", { error: err.message });
         }
       }
       /**
@@ -12085,6 +12105,7 @@ var init_schema = __esm({
       reportTitle: external_exports.string().optional().default(DEFAULT_OPTIONS.reportTitle),
       projectName: external_exports.string().optional(),
       open: external_exports.boolean().optional().default(DEFAULT_OPTIONS.open),
+      logLevel: external_exports.enum(["silent", "error", "warn", "info", "debug"]).optional().default("info"),
       puppeteerExecutablePath: external_exports.string().optional(),
       serverUrl: external_exports.string().url().optional(),
       compressionLevel: external_exports.enum(["auto", "none", "balanced", "max"]).optional().default(DEFAULT_OPTIONS.compressionLevel),
@@ -12549,7 +12570,7 @@ function parseArgs() {
   const rawTemplate = templateArg?.slice("--template=".length);
   const rawOutput = outputArg?.slice("--output=".length);
   if (rawTemplate && !VALID_TEMPLATES.has(rawTemplate)) {
-    console.warn(`[ReportForge] Unknown template '${rawTemplate}', using 'detailed'. Valid: ${TEMPLATE_IDS.join(", ")}`);
+    console.warn(`[reportforge] Unknown template '${rawTemplate}', using 'detailed'. Valid: ${TEMPLATE_IDS.join(", ")}`);
   }
   const template = rawTemplate && VALID_TEMPLATES.has(rawTemplate) ? rawTemplate : "detailed";
   const outputFile = rawOutput ?? import_path7.default.join("playwright-report", "demo-report.pdf");
@@ -12557,7 +12578,7 @@ function parseArgs() {
 }
 async function run() {
   const { template, outputFile } = parseArgs();
-  console.log("[ReportForge] Generating demo report...");
+  console.log("[reportforge] Generating demo report...");
   console.log(`  Template : ${template}`);
   console.log(`  Output   : ${outputFile}`);
   const reportData = buildDemoReportData(template);
@@ -12568,10 +12589,10 @@ async function run() {
   const paths = await generator.generateAll(reportData, options, DEMO_LICENSE_INFO2);
   if (paths.length > 0) {
     console.log(`
-[ReportForge] Demo report written: ${paths[0]}`);
+[reportforge] Demo report written: ${paths[0]}`);
     console.log("  Open the PDF to preview exactly what ReportForge generates for your Playwright runs.");
   } else {
-    console.warn("\n[ReportForge] Warning: no PDF was written \u2014 check that Chrome is available.");
+    console.warn("\n[reportforge] Warning: no PDF was written \u2014 check that Chrome is available.");
     process.exit(1);
   }
 }
@@ -12581,14 +12602,14 @@ async function runDemo() {
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
     if (/chrome|chromium|executable|browser|launcher/i.test(msg)) {
-      console.error("\n[ReportForge] Chrome not found.\n");
+      console.error("\n[reportforge] Chrome not found.\n");
       console.error("  Fix: set PUPPETEER_EXECUTABLE_PATH, e.g.:");
       console.error("    PUPPETEER_EXECUTABLE_PATH=/usr/bin/google-chrome-stable \\");
       console.error("    npx @reportforge/playwright-pdf demo\n");
       console.error(`  Original error: ${msg}`);
     } else {
       console.error(`
-[ReportForge] Demo generation failed: ${msg}`);
+[reportforge] Demo generation failed: ${msg}`);
       if (process.env.RF_DEBUG) console.error(err);
     }
     process.exit(1);
@@ -12648,10 +12669,10 @@ ${rows.join("\n")}
 function exportFeedbackCli() {
   const res = exportFeedback();
   if (res.rowCount === 0) {
-    process.stdout.write("No locally collected failures found (~/.reportforge/*/unclassified.csv).\n");
+    process.stdout.write("[reportforge] No locally collected failures found (~/.reportforge/*/unclassified.csv).\n");
   } else {
     process.stdout.write(
-      `Saved ${res.rowCount} row(s) to ${res.outFile} - tokenized + redacted, LOCAL only.
+      `[reportforge] Saved ${res.rowCount} row(s) to ${res.outFile} - tokenized + redacted, LOCAL only.
 Review it before sharing; there is no upload.
 `
     );

package/dist/index.d.mts

@@ -91,6 +91,16 @@ interface ReporterOptions {
      * @default false
      */
     open?: boolean;
+    /**
+     * Console verbosity for reporter log lines (the `[reportforge]` prefix).
+     * `'silent'` suppresses everything, including error lines — a PDF failure
+     * then surfaces only as a missing file (the reporter never fails the test
+     * run). `'debug'` adds diagnostic detail. The `RF_DEBUG=1` environment
+     * variable always forces `'debug'`, overriding this option (support
+     * escape hatch).
+     * @default 'info'
+     */
+    logLevel?: 'silent' | 'error' | 'warn' | 'info' | 'debug';
     /**
      * Full path to a Chrome/Chromium executable.
      * Falls back to PUPPETEER_EXECUTABLE_PATH env, then system Chrome discovery.

package/dist/index.d.ts

@@ -91,6 +91,16 @@ interface ReporterOptions {
      * @default false
      */
     open?: boolean;
+    /**
+     * Console verbosity for reporter log lines (the `[reportforge]` prefix).
+     * `'silent'` suppresses everything, including error lines — a PDF failure
+     * then surfaces only as a missing file (the reporter never fails the test
+     * run). `'debug'` adds diagnostic detail. The `RF_DEBUG=1` environment
+     * variable always forces `'debug'`, overriding this option (support
+     * escape hatch).
+     * @default 'info'
+     */
+    logLevel?: 'silent' | 'error' | 'warn' | 'info' | 'debug';
     /**
      * Full path to a Chrome/Chromium executable.
      * Falls back to PUPPETEER_EXECUTABLE_PATH env, then system Chrome discovery.

package/dist/index.js

@@ -10532,6 +10532,7 @@ var ReporterOptionsSchema = external_exports.object({
   reportTitle: external_exports.string().optional().default(DEFAULT_OPTIONS.reportTitle),
   projectName: external_exports.string().optional(),
   open: external_exports.boolean().optional().default(DEFAULT_OPTIONS.open),
+  logLevel: external_exports.enum(["silent", "error", "warn", "info", "debug"]).optional().default("info"),
   puppeteerExecutablePath: external_exports.string().optional(),
   serverUrl: external_exports.string().url().optional(),
   compressionLevel: external_exports.enum(["auto", "none", "balanced", "max"]).optional().default(DEFAULT_OPTIONS.compressionLevel),
@@ -10668,13 +10669,48 @@ var import_fs = __toESM(require("fs"));
 var import_path = __toESM(require("path"));
 var import_os = __toESM(require("os"));
 var import_crypto3 = require("crypto");
+
+// src/utils/logger.ts
+init_cjs_shims();
+var PREFIX = "[reportforge]";
+var LEVELS = { debug: 10, info: 20, warn: 30, error: 40, silent: 99 };
+var threshold = LEVELS.info;
+function setLogLevel(level) {
+  threshold = LEVELS[level];
+}
+function isLevelEnabled(level) {
+  return LEVELS[level] >= (process.env.RF_DEBUG ? LEVELS.debug : threshold);
+}
+var logger = {
+  info(msg) {
+    if (!isLevelEnabled("info")) return;
+    console.log(`${PREFIX} ${msg}`);
+  },
+  warn(msg) {
+    if (!isLevelEnabled("warn")) return;
+    console.warn(`${PREFIX} WARN: ${msg}`);
+  },
+  error(msg) {
+    if (!isLevelEnabled("error")) return;
+    console.error(`${PREFIX} ERROR: ${msg}`);
+  },
+  debug(msg, data) {
+    if (!isLevelEnabled("debug")) return;
+    const suffix = data !== void 0 ? `
+${JSON.stringify(data, null, 2)}` : "";
+    console.log(`${PREFIX} DEBUG: ${msg}${suffix}`);
+  }
+};
+
+// src/license/DeviceId.ts
 var DEVICE_FILE = import_path.default.join(import_os.default.homedir(), ".reportforge", "device.json");
 function getStableDeviceId() {
   try {
     const raw = import_fs.default.readFileSync(DEVICE_FILE, "utf8");
     const parsed = JSON.parse(raw);
     if (parsed.id && /^[0-9a-f-]{36}$/i.test(parsed.id)) return parsed.id;
-  } catch {
+  } catch (err) {
+    logger.debug("device id: no readable device.json \u2014 creating new id", { error: err.message });
   }
   const id = (0, import_crypto3.randomUUID)();
   try {
@@ -10682,7 +10718,10 @@ function getStableDeviceId() {
     import_fs.default.writeFileSync(DEVICE_FILE, JSON.stringify({ id, createdAt: Date.now() }), {
       mode: 384
     });
-  } catch {
+  } catch (err) {
+    logger.warn(
+      `Could not persist device id (~/.reportforge/device.json) \u2014 this machine may register a new seat on every run: ${err.message}`
+    );
   }
   return id;
 }
@@ -10709,10 +10748,13 @@ function getMachineFingerprint() {
       label: `${ci.provider}/${ci.repo} (CI)`
     };
   }
-  const hostname = safe(() => import_os2.default.hostname()) ?? "unknown-host";
+  const hostname = safe(() => import_os2.default.hostname());
+  if (hostname === void 0) {
+    logger.debug("fingerprint: os.hostname() failed \u2014 label falls back to unknown-host");
+  }
   return {
     hash: sha256Hex(`dev:${getStableDeviceId()}`),
-    label: `${hostname} (dev)`
+    label: `${hostname ?? "unknown-host"} (dev)`
   };
 }
 function detectCiRepo() {
@@ -10754,19 +10796,25 @@ function readCache() {
       if (f.endsWith(".tmp")) {
         try {
           import_fs2.default.unlinkSync(import_path2.default.join(CACHE_DIR, f));
-        } catch {
+        } catch (err) {
+          logger.debug("license cache: stale tmp cleanup failed", { file: f, error: err.message });
         }
       }
     }
-  } catch {
+  } catch (err) {
+    logger.debug("license cache: cache dir not readable (first run?)", { error: err.message });
   }
   try {
     if (!import_fs2.default.existsSync(CACHE_FILE)) return null;
     const raw = import_fs2.default.readFileSync(CACHE_FILE, "utf8");
     const parsed = JSON.parse(raw);
-    if (typeof parsed.jwt !== "string" || typeof parsed.expiresAt !== "number") return null;
+    if (typeof parsed.jwt !== "string" || typeof parsed.expiresAt !== "number") {
+      logger.debug("license cache: malformed entry \u2014 ignoring");
+      return null;
+    }
     return parsed;
-  } catch {
+  } catch (err) {
+    logger.debug("license cache: read failed \u2014 treating as no cache", { error: err.message });
     return null;
   }
 }
@@ -10776,13 +10824,15 @@ function writeCache(entry) {
     const tmp = `${CACHE_FILE}.${process.pid}.tmp`;
     import_fs2.default.writeFileSync(tmp, JSON.stringify(entry, null, 2), { mode: 384 });
     import_fs2.default.renameSync(tmp, CACHE_FILE);
-  } catch {
+  } catch (err) {
+    logger.debug("license cache: write failed \u2014 will re-activate next run", { error: err.message });
   }
 }
 function clearCache() {
   try {
     import_fs2.default.unlinkSync(CACHE_FILE);
-  } catch {
+  } catch (err) {
+    logger.debug("license cache: clear failed", { error: err.message });
   }
 }
 
@@ -10801,27 +10851,6 @@ var import_node_crypto = require("crypto");
 init_cjs_shims();
 var MODEL = { "alpha": 1, "labels": ["assertion", "env-config", "flaky-by-retry", "locator-not-found", "navigation", "network", "timeout"], "logLikelihoods": { "assertion": { "NUM": -4.574710978503383, "assertionerror": -4.980176086611547, "be": -4.980176086611547, "cart": -4.980176086611547, "checkout": -4.980176086611547, "com": -4.980176086611547, "dashboard": -4.980176086611547, "deep": -4.980176086611547, "equal": -4.980176086611547, "equality": -4.980176086611547, "error": -4.980176086611547, "expect": -3.5938817254916566, "expected": -3.1083739097099556, "failed": -4.980176086611547, "false": -4.980176086611547, "got": -4.980176086611547, "id": -4.574710978503383, "john": -4.980176086611547, "locator": -4.574710978503383, "login": -4.980176086611547, "must": -4.980176086611547, "page": -4.980176086611547, "pattern": -4.980176086611547, "received": -3.275427994373122, "string": -4.980176086611547, "to": -4.980176086611547, "tobe": -4.980176086611547, "tobetruthy": -4.980176086611547, "toequal": -4.980176086611547, "tohavecount": -4.980176086611547, "tohavetext": -4.980176086611547, "tohavetitle": -4.980176086611547, "tohavevalue": -4.980176086611547, "truthy": -4.980176086611547, "value": -4.980176086611547 }, "env-config": { "NUM": -4.997212273764115, "api": -4.997212273764115, "at": -4.997212273764115, "back": -4.997212273764115, "base": -4.997212273764115, "baseurl": -4.997212273764115, "browsers": -4.997212273764115, "cannot": -4.997212273764115, "ci": -4.997212273764115, "config": -4.304065093204169, "directory": -4.591747165655951, "dotenv": -4.997212273764115, "enoent": -4.997212273764115, "env": -4.591747165655951, "environment": -4.591747165655951, "error": -4.08092154188996, "existent": -4.997212273764115, "failed": -4.997212273764115, "falling": -4.997212273764115, "file": -4.997212273764115, "find": -4.997212273764115, "from": -4.997212273764115, "in": -4.591747165655951, "invalid": -4.997212273764115, "is": -4.997212273764115, "json": -4.591747165655951, "key": -4.997212273764115, "load": -4.997212273764115, "missing": -4.997212273764115, "module": -4.997212273764115, "no": -4.997212273764115, "non": -4.997212273764115, "not": -4.997212273764115, "open": -4.997212273764115, "or": -4.997212273764115, "path": -4.997212273764115, "playwright": -4.591747165655951, "points": -4.997212273764115, "position": -4.997212273764115, "required": -4.997212273764115, "set": -4.997212273764115, "spec": -4.997212273764115, "such": -4.997212273764115, "syntaxerror": -4.997212273764115, "test": -4.997212273764115, "to": -4.304065093204169, "token": -4.997212273764115, "ts": -4.997212273764115, "tsconfig": -4.997212273764115, "undefined": -4.591747165655951, "unexpected": -4.997212273764115, "url": -4.997212273764115, "values": -4.997212273764115, "variable": -4.591747165655951 }, "flaky-by-retry": { "after": -4.58836306767171, "and": -4.993828175779875, "animation": -4.993828175779875, "attempt": -4.07753744390572, "between": -4.993828175779875, "blip": -4.993828175779875, "cause": -4.993828175779875, "change": -4.993828175779875, "click": -4.993828175779875, "code": -4.993828175779875, "commit": -4.993828175779875, "condition": -4.993828175779875, "dependency": -4.993828175779875, "detached": -4.993828175779875, "deterministic": -4.993828175779875, "element": -4.993828175779875, "failed": -4.300680995219929, "fails": -4.993828175779875, "flaky": -4.07753744390572, "green": -4.993828175779875, "in": -4.993828175779875, "intermittent": -4.993828175779875, "locator": -4.993828175779875, "marked": -4.993828175779875, "network": -4.993828175779875, "no": -4.993828175779875, "non": -4.993828175779875, "on": -3.895215887111765, "order": -4.993828175779875, "passed": -3.895215887111765, "quarantined": -4.993828175779875, "race": -4.993828175779875, "reproducible": -4.993828175779875, "rerun": -4.993828175779875, "retry": -4.07753744390572, "runs": -4.993828175779875, "same": -4.993828175779875, "second": -4.993828175779875, "stale": -4.993828175779875, "succeeded": -4.993828175779875, "test": -4.58836306767171, "the": -4.993828175779875, "then": -4.993828175779875, "timeout": -4.993828175779875, "unstable": -4.993828175779875, "with": -4.993828175779875, "without": -4.993828175779875 }, "locator-not-found": { "an": -4.993828175779875, "attached": -4.993828175779875, "btn": -4.993828175779875, "button": -4.58836306767171, "cart": -4.993828175779875, "checkout": -4.993828175779875, "click": -4.993828175779875, "data": -4.993828175779875, "div": -4.993828175779875, "dom": -4.993828175779875, "element": -4.07753744390572, "elements": -4.300680995219929, "error": -4.58836306767171, "find": -4.993828175779875, "for": -4.58836306767171, "found": -4.58836306767171, "getbyrole": -4.993828175779875, "getbytext": -4.993828175779875, "icon": -4.993828175779875, "id": -4.993828175779875, "is": -4.993828175779875, "locator": -4.07753744390572, "matched": -4.993828175779875, "matches": -4.993828175779875, "missing": -4.993828175779875, "mode": -4.58836306767171, "name": -4.993828175779875, "no": -4.58836306767171, "node": -4.993828175779875, "not": -4.58836306767171, "resolved": -4.58836306767171, "save": -4.993828175779875, "selector": -4.58836306767171, "strict": -4.58836306767171, "submit": -4.993828175779875, "testid": -4.993828175779875, "textcontent": -4.993828175779875, "the": -4.58836306767171, "to": -4.07753744390572, "total": -4.993828175779875, "unable": -4.993828175779875, "violation": -4.58836306767171, "waiting": -4.993828175779875, "with": -4.993828175779875, "xpath": -4.993828175779875 }, "navigation": { "NUM": -4.983606621708336, "aborted": -4.983606621708336, "another": -4.983606621708336, "back": -4.983606621708336, "because": -4.578141513600172, "by": -4.578141513600172, "checkout": -4.983606621708336, "context": -4.983606621708336, "crashed": -4.983606621708336, "dashboard": -4.983606621708336, "destroyed": -4.983606621708336, "detached": -4.983606621708336, "entry": -4.983606621708336, "err": -4.578141513600172, "exceeded": -4.983606621708336, "execution": -4.983606621708336, "failed": -4.983606621708336, "frame": -4.578141513600172, "goback": -4.983606621708336, "goto": -4.290459441148391, "history": -4.983606621708336, "home": -4.983606621708336, "interrupted": -4.578141513600172, "is": -4.983606621708336, "likely": -4.983606621708336, "login": -4.983606621708336, "many": -4.983606621708336, "maybe": -4.983606621708336, "most": -4.983606621708336, "navigate": -4.983606621708336, "navigating": -4.983606621708336, "navigation": -3.7308436532129683, "net": -4.578141513600172, "no": -4.983606621708336, "of": -4.983606621708336, "page": -3.884994333040227, "redirects": -4.983606621708336, "timeout": -4.983606621708336, "to": -3.7308436532129683, "too": -4.983606621708336, "waitforurl": -4.983606621708336, "was": -4.578141513600172 }, "network": { "NUM": -4.57126863431241, "URL": -4.283586561860629, "again": -4.976733742420574, "api": -4.976733742420574, "apirequestcontext": -4.976733742420574, "at": -4.976733742420574, "body": -4.976733742420574, "connect": -4.976733742420574, "connection": -4.57126863431241, "disconnected": -4.976733742420574, "eai": -4.976733742420574, "econnrefused": -4.976733742420574, "err": -3.8781214537524646, "error": -4.976733742420574, "failed": -4.283586561860629, "fetch": -4.976733742420574, "fetching": -4.976733742420574, "from": -4.976733742420574, "get": -4.976733742420574, "getaddrinfo": -4.976733742420574, "goto": -4.976733742420574, "hang": -4.976733742420574, "internet": -4.976733742420574, "loading": -4.976733742420574, "name": -4.976733742420574, "net": -3.8781214537524646, "not": -4.976733742420574, "on": -4.976733742420574, "out": -4.976733742420574, "page": -4.57126863431241, "products": -4.976733742420574, "protocol": -4.976733742420574, "reading": -4.976733742420574, "reason": -4.976733742420574, "refused": -4.976733742420574, "request": -4.57126863431241, "resolved": -4.976733742420574, "resource": -4.976733742420574, "response": -4.976733742420574, "route": -4.976733742420574, "socket": -4.976733742420574, "ssl": -4.976733742420574, "timed": -4.976733742420574, "to": -4.976733742420574, "up": -4.976733742420574, "upstream": -4.976733742420574, "while": -4.976733742420574 }, "timeout": { "NUM": -3.4965075614664802, "after": -5.000584958242754, "be": -4.59511985013459, "cart": -5.000584958242754, "click": -5.000584958242754, "element": -5.000584958242754, "event": -5.000584958242754, "exceeded": -3.6142905971228636, "expect": -5.000584958242754, "fill": -5.000584958242754, "for": -3.7478219897473863, "function": -5.000584958242754, "load": -5.000584958242754, "locator": -4.084294226368599, "navigation": -5.000584958242754, "of": -5.000584958242754, "out": -5.000584958242754, "page": -4.59511985013459, "running": -5.000584958242754, "selector": -5.000584958242754, "submit": -5.000584958242754, "test": -4.59511985013459, "timed": -5.000584958242754, "timeout": -3.6142905971228636, "timeouterror": -4.59511985013459, "to": -4.59511985013459, "tobevisible": -5.000584958242754, "visible": -4.59511985013459, "waitforloadstate": -5.000584958242754, "waitforselector": -5.000584958242754, "waiting": -3.7478219897473863, "while": -5.000584958242754 } }, "playwrightVersion": "1.59.1", "priors": { "assertion": -1.9636097261547143, "env-config": -1.9636097261547143, "flaky-by-retry": -1.9636097261547143, "locator-not-found": -1.9636097261547143, "navigation": -1.9636097261547143, "network": -1.9636097261547143, "timeout": -1.845826690498331 }, "totals": { "assertion": 64, "env-config": 69, "flaky-by-retry": 68, "locator-not-found": 68, "navigation": 65, "network": 63, "timeout": 70 }, "version": 1, "vocabSize": 227 };
 
-// src/utils/logger.ts
-init_cjs_shims();
-var PREFIX = "[reportforge]";
-var logger = {
-  info(msg) {
-    console.log(`${PREFIX} ${msg}`);
-  },
-  warn(msg) {
-    console.warn(`${PREFIX} WARN: ${msg}`);
-  },
-  error(msg) {
-    console.error(`${PREFIX} ERROR: ${msg}`);
-  },
-  debug(msg, data) {
-    if (!process.env.RF_DEBUG) return;
-    const suffix = data !== void 0 ? `
-${JSON.stringify(data, null, 2)}` : "";
-    console.log(`${PREFIX} DEBUG: ${msg}${suffix}`);
-  }
-};
-
 // src/analysis/ModelStore.ts
 var MODEL_SIG_DOMAIN = "reportforge-model-sig:v1\n";
 var testDeps = null;
@@ -11092,9 +11121,16 @@ var LicenseClient = class {
 function verifyCache(verifier, cached, expectedFp) {
   try {
     const payload = verifier.verify(cached.jwt);
-    if (payload.fp !== expectedFp) return null;
+    if (payload.fp !== expectedFp) {
+      logger.debug("license cache rejected: fingerprint mismatch", {
+        cachedFp: payload.fp.slice(0, 12),
+        expectedFp: expectedFp.slice(0, 12)
+      });
+      return null;
+    }
     return payload;
-  } catch {
+  } catch (err) {
+    logger.debug("license cache rejected: JWT verify failed", { error: err.message });
     return null;
   }
 }
@@ -11150,7 +11186,8 @@ function maybePrintUpdateNotice(licenseInfo, currentVersion) {
     logger.info(
       `Update available: ${currentVersion} -> ${shown}. Run: npm i -D @reportforge/playwright-pdf@latest`
     );
-  } catch {
+  } catch (err) {
+    logger.debug("update notice failed (ignored)", { error: err.message });
   }
 }
 
@@ -12826,29 +12863,33 @@ var ScreenshotEmbedder = class {
 init_cjs_shims();
 var import_child_process2 = require("child_process");
 var import_fs6 = __toESM(require("fs"));
+var LAUNCH_ARGS = [
+  "--no-sandbox",
+  "--disable-setuid-sandbox",
+  "--disable-dev-shm-usage",
+  "--disable-gpu",
+  // Chrome's new headless mode (--headless=new, the only mode left in
+  // Chrome 132+) briefly uncloaks a blank window on some Windows/GPU
+  // combinations. Parking the window far off-screen makes that transient
+  // invisible; harmless everywhere else and does not affect PDF output.
+  "--window-position=-32000,-32000"
+];
 var BrowserManager = class {
   async launch(executablePath) {
     const puppeteer = require("puppeteer-core");
     const chromePath = this.resolveChromePath(executablePath, puppeteer);
     logger.info(`Launching browser: ${chromePath ?? "puppeteer default"}`);
-    const launchArgs = [
-      "--no-sandbox",
-      "--disable-setuid-sandbox",
-      "--disable-dev-shm-usage",
-      "--disable-gpu"
-    ];
     this.browser = await puppeteer.launch({
       executablePath: chromePath,
       headless: true,
-      args: launchArgs
+      args: LAUNCH_ARGS
     });
     const page = await this.browser.newPage();
     return { browser: this.browser, page };
   }
   async close() {
     if (this.browser) {
-      await this.browser.close().catch(() => {
-      });
+      await this.browser.close().catch((err) => logger.debug("browser close failed (ignored)", { error: err.message }));
       this.browser = void 0;
     }
   }
@@ -12860,7 +12901,8 @@ var BrowserManager = class {
       const chromeFinder = require_lib2();
       const found = chromeFinder();
       if (found && import_fs6.default.existsSync(found)) return found;
-    } catch {
+    } catch (err) {
+      logger.debug("chrome discovery: chrome-finder failed", { error: err.message });
     }
     const linuxPaths = [
       "/usr/bin/google-chrome",
@@ -12878,12 +12920,14 @@ var BrowserManager = class {
       }).toString().trim().split("\n")[0];
       if (found && import_fs6.default.existsSync(found)) return found;
     } catch {
+      logger.debug("chrome discovery: which lookup found nothing");
     }
     if (puppeteer.executablePath) {
       try {
         const bundled = puppeteer.executablePath();
         if (bundled && import_fs6.default.existsSync(bundled)) return bundled;
-      } catch {
+      } catch (err) {
+        logger.debug("chrome discovery: no puppeteer bundled executable", { error: err.message });
       }
     }
     logger.warn(
@@ -12909,8 +12953,10 @@ var HtmlWriter = class {
   }
   async cleanup() {
     if (this.tempPath) {
-      await import_fs7.default.promises.unlink(this.tempPath).catch(() => {
-      });
+      const tempPath = this.tempPath;
+      await import_fs7.default.promises.unlink(tempPath).catch(
+        (err) => logger.debug("temp HTML cleanup failed (ignored)", { path: tempPath, error: err.message })
+      );
       this.tempPath = void 0;
     }
   }
@@ -12975,7 +13021,8 @@ var PdfEncryptor = class {
     try {
       (0, import_child_process3.execFileSync)("qpdf", ["--version"], { stdio: "pipe" });
       return true;
-    } catch {
+    } catch (err) {
+      logger.debug("qpdf probe failed \u2014 treating as not installed", { error: err.message });
       return false;
     }
   }
@@ -13132,7 +13179,8 @@ var PdfGenerator = class {
       if (CHARTJS_BUNDLE2) {
         this.templateEngine.setChartjsBundle(CHARTJS_BUNDLE2);
       }
-    } catch {
+    } catch (err) {
+      logger.debug("chartjs bundle not available \u2014 charts disabled", { error: err.message });
     }
   }
   /**
@@ -14048,7 +14096,7 @@ function buildWatchUrl(serverUrl, runId, token) {
 }
 function formatLiveBanner(url) {
   const label = "Live Tracker";
-  const link = `Watch live: ${url}`;
+  const link = `[reportforge] Watch live: ${url}`;
   const width = Math.max(label.length, link.length);
   const rule = "\u2500".repeat(width + 2);
   return [rule, ` ${label.padEnd(width)} `, ` ${link.padEnd(width)} `, rule].join("\n");
@@ -14154,8 +14202,9 @@ var PdfReporter = class {
     this.liveSteps = "failed";
     this.liveConsole = false;
     this.options = parseOptions(rawOptions);
+    setLogLevel(this.options.logLevel);
     this.dataCollector = new DataCollector(this.options.capture);
-    this.version = true ? "0.18.0" : "0.x";
+    this.version = true ? "0.19.1" : "0.x";
     logger.info(`@reportforge/playwright-pdf v${this.version} initialised`);
     this.licenseClient = new LicenseClient({
       licenseKey: this.options.licenseKey,
@@ -14418,8 +14467,9 @@ var PdfReporter = class {
       );
       return;
     }
-    logger.info(`Live Tracker: ${watchUrl}`);
-    console.log(formatLiveBanner(watchUrl));
+    if (isLevelEnabled("info")) {
+      console.log(formatLiveBanner(watchUrl));
+    }
     const isPrimaryShard = !shard || shard.current === 1;
     const notify = this.options.notify;
     if (isPrimaryShard && notify) {

package/dist/index.mjs

@@ -10533,6 +10533,7 @@ var ReporterOptionsSchema = external_exports.object({
   reportTitle: external_exports.string().optional().default(DEFAULT_OPTIONS.reportTitle),
   projectName: external_exports.string().optional(),
   open: external_exports.boolean().optional().default(DEFAULT_OPTIONS.open),
+  logLevel: external_exports.enum(["silent", "error", "warn", "info", "debug"]).optional().default("info"),
   puppeteerExecutablePath: external_exports.string().optional(),
   serverUrl: external_exports.string().url().optional(),
   compressionLevel: external_exports.enum(["auto", "none", "balanced", "max"]).optional().default(DEFAULT_OPTIONS.compressionLevel),
@@ -10669,13 +10670,48 @@ import fs from "fs";
 import path2 from "path";
 import os from "os";
 import { randomUUID } from "crypto";
+
+// src/utils/logger.ts
+init_esm_shims();
+var PREFIX = "[reportforge]";
+var LEVELS = { debug: 10, info: 20, warn: 30, error: 40, silent: 99 };
+var threshold = LEVELS.info;
+function setLogLevel(level) {
+  threshold = LEVELS[level];
+}
+function isLevelEnabled(level) {
+  return LEVELS[level] >= (process.env.RF_DEBUG ? LEVELS.debug : threshold);
+}
+var logger = {
+  info(msg) {
+    if (!isLevelEnabled("info")) return;
+    console.log(`${PREFIX} ${msg}`);
+  },
+  warn(msg) {
+    if (!isLevelEnabled("warn")) return;
+    console.warn(`${PREFIX} WARN: ${msg}`);
+  },
+  error(msg) {
+    if (!isLevelEnabled("error")) return;
+    console.error(`${PREFIX} ERROR: ${msg}`);
+  },
+  debug(msg, data) {
+    if (!isLevelEnabled("debug")) return;
+    const suffix = data !== void 0 ? `
+${JSON.stringify(data, null, 2)}` : "";
+    console.log(`${PREFIX} DEBUG: ${msg}${suffix}`);
+  }
+};
+
+// src/license/DeviceId.ts
 var DEVICE_FILE = path2.join(os.homedir(), ".reportforge", "device.json");
 function getStableDeviceId() {
   try {
     const raw = fs.readFileSync(DEVICE_FILE, "utf8");
     const parsed = JSON.parse(raw);
     if (parsed.id && /^[0-9a-f-]{36}$/i.test(parsed.id)) return parsed.id;
-  } catch {
+  } catch (err) {
+    logger.debug("device id: no readable device.json \u2014 creating new id", { error: err.message });
   }
   const id = randomUUID();
   try {
@@ -10683,7 +10719,10 @@ function getStableDeviceId() {
     fs.writeFileSync(DEVICE_FILE, JSON.stringify({ id, createdAt: Date.now() }), {
       mode: 384
     });
-  } catch {
+  } catch (err) {
+    logger.warn(
+      `Could not persist device id (~/.reportforge/device.json) \u2014 this machine may register a new seat on every run: ${err.message}`
+    );
   }
   return id;
 }
@@ -10710,10 +10749,13 @@ function getMachineFingerprint() {
       label: `${ci.provider}/${ci.repo} (CI)`
     };
   }
-  const hostname = safe(() => os2.hostname()) ?? "unknown-host";
+  const hostname = safe(() => os2.hostname());
+  if (hostname === void 0) {
+    logger.debug("fingerprint: os.hostname() failed \u2014 label falls back to unknown-host");
+  }
   return {
     hash: sha256Hex(`dev:${getStableDeviceId()}`),
-    label: `${hostname} (dev)`
+    label: `${hostname ?? "unknown-host"} (dev)`
   };
 }
 function detectCiRepo() {
@@ -10755,19 +10797,25 @@ function readCache() {
       if (f.endsWith(".tmp")) {
         try {
           fs2.unlinkSync(path3.join(CACHE_DIR, f));
-        } catch {
+        } catch (err) {
+          logger.debug("license cache: stale tmp cleanup failed", { file: f, error: err.message });
         }
       }
     }
-  } catch {
+  } catch (err) {
+    logger.debug("license cache: cache dir not readable (first run?)", { error: err.message });
   }
   try {
     if (!fs2.existsSync(CACHE_FILE)) return null;
     const raw = fs2.readFileSync(CACHE_FILE, "utf8");
     const parsed = JSON.parse(raw);
-    if (typeof parsed.jwt !== "string" || typeof parsed.expiresAt !== "number") return null;
+    if (typeof parsed.jwt !== "string" || typeof parsed.expiresAt !== "number") {
+      logger.debug("license cache: malformed entry \u2014 ignoring");
+      return null;
+    }
     return parsed;
-  } catch {
+  } catch (err) {
+    logger.debug("license cache: read failed \u2014 treating as no cache", { error: err.message });
     return null;
   }
 }
@@ -10777,13 +10825,15 @@ function writeCache(entry) {
     const tmp = `${CACHE_FILE}.${process.pid}.tmp`;
     fs2.writeFileSync(tmp, JSON.stringify(entry, null, 2), { mode: 384 });
     fs2.renameSync(tmp, CACHE_FILE);
-  } catch {
+  } catch (err) {
+    logger.debug("license cache: write failed \u2014 will re-activate next run", { error: err.message });
   }
 }
 function clearCache() {
   try {
     fs2.unlinkSync(CACHE_FILE);
-  } catch {
+  } catch (err) {
+    logger.debug("license cache: clear failed", { error: err.message });
   }
 }
 
@@ -10802,27 +10852,6 @@ import { createPublicKey as createPublicKey2, verify as verify2 } from "crypto";
 init_esm_shims();
 var MODEL = { "alpha": 1, "labels": ["assertion", "env-config", "flaky-by-retry", "locator-not-found", "navigation", "network", "timeout"], "logLikelihoods": { "assertion": { "NUM": -4.574710978503383, "assertionerror": -4.980176086611547, "be": -4.980176086611547, "cart": -4.980176086611547, "checkout": -4.980176086611547, "com": -4.980176086611547, "dashboard": -4.980176086611547, "deep": -4.980176086611547, "equal": -4.980176086611547, "equality": -4.980176086611547, "error": -4.980176086611547, "expect": -3.5938817254916566, "expected": -3.1083739097099556, "failed": -4.980176086611547, "false": -4.980176086611547, "got": -4.980176086611547, "id": -4.574710978503383, "john": -4.980176086611547, "locator": -4.574710978503383, "login": -4.980176086611547, "must": -4.980176086611547, "page": -4.980176086611547, "pattern": -4.980176086611547, "received": -3.275427994373122, "string": -4.980176086611547, "to": -4.980176086611547, "tobe": -4.980176086611547, "tobetruthy": -4.980176086611547, "toequal": -4.980176086611547, "tohavecount": -4.980176086611547, "tohavetext": -4.980176086611547, "tohavetitle": -4.980176086611547, "tohavevalue": -4.980176086611547, "truthy": -4.980176086611547, "value": -4.980176086611547 }, "env-config": { "NUM": -4.997212273764115, "api": -4.997212273764115, "at": -4.997212273764115, "back": -4.997212273764115, "base": -4.997212273764115, "baseurl": -4.997212273764115, "browsers": -4.997212273764115, "cannot": -4.997212273764115, "ci": -4.997212273764115, "config": -4.304065093204169, "directory": -4.591747165655951, "dotenv": -4.997212273764115, "enoent": -4.997212273764115, "env": -4.591747165655951, "environment": -4.591747165655951, "error": -4.08092154188996, "existent": -4.997212273764115, "failed": -4.997212273764115, "falling": -4.997212273764115, "file": -4.997212273764115, "find": -4.997212273764115, "from": -4.997212273764115, "in": -4.591747165655951, "invalid": -4.997212273764115, "is": -4.997212273764115, "json": -4.591747165655951, "key": -4.997212273764115, "load": -4.997212273764115, "missing": -4.997212273764115, "module": -4.997212273764115, "no": -4.997212273764115, "non": -4.997212273764115, "not": -4.997212273764115, "open": -4.997212273764115, "or": -4.997212273764115, "path": -4.997212273764115, "playwright": -4.591747165655951, "points": -4.997212273764115, "position": -4.997212273764115, "required": -4.997212273764115, "set": -4.997212273764115, "spec": -4.997212273764115, "such": -4.997212273764115, "syntaxerror": -4.997212273764115, "test": -4.997212273764115, "to": -4.304065093204169, "token": -4.997212273764115, "ts": -4.997212273764115, "tsconfig": -4.997212273764115, "undefined": -4.591747165655951, "unexpected": -4.997212273764115, "url": -4.997212273764115, "values": -4.997212273764115, "variable": -4.591747165655951 }, "flaky-by-retry": { "after": -4.58836306767171, "and": -4.993828175779875, "animation": -4.993828175779875, "attempt": -4.07753744390572, "between": -4.993828175779875, "blip": -4.993828175779875, "cause": -4.993828175779875, "change": -4.993828175779875, "click": -4.993828175779875, "code": -4.993828175779875, "commit": -4.993828175779875, "condition": -4.993828175779875, "dependency": -4.993828175779875, "detached": -4.993828175779875, "deterministic": -4.993828175779875, "element": -4.993828175779875, "failed": -4.300680995219929, "fails": -4.993828175779875, "flaky": -4.07753744390572, "green": -4.993828175779875, "in": -4.993828175779875, "intermittent": -4.993828175779875, "locator": -4.993828175779875, "marked": -4.993828175779875, "network": -4.993828175779875, "no": -4.993828175779875, "non": -4.993828175779875, "on": -3.895215887111765, "order": -4.993828175779875, "passed": -3.895215887111765, "quarantined": -4.993828175779875, "race": -4.993828175779875, "reproducible": -4.993828175779875, "rerun": -4.993828175779875, "retry": -4.07753744390572, "runs": -4.993828175779875, "same": -4.993828175779875, "second": -4.993828175779875, "stale": -4.993828175779875, "succeeded": -4.993828175779875, "test": -4.58836306767171, "the": -4.993828175779875, "then": -4.993828175779875, "timeout": -4.993828175779875, "unstable": -4.993828175779875, "with": -4.993828175779875, "without": -4.993828175779875 }, "locator-not-found": { "an": -4.993828175779875, "attached": -4.993828175779875, "btn": -4.993828175779875, "button": -4.58836306767171, "cart": -4.993828175779875, "checkout": -4.993828175779875, "click": -4.993828175779875, "data": -4.993828175779875, "div": -4.993828175779875, "dom": -4.993828175779875, "element": -4.07753744390572, "elements": -4.300680995219929, "error": -4.58836306767171, "find": -4.993828175779875, "for": -4.58836306767171, "found": -4.58836306767171, "getbyrole": -4.993828175779875, "getbytext": -4.993828175779875, "icon": -4.993828175779875, "id": -4.993828175779875, "is": -4.993828175779875, "locator": -4.07753744390572, "matched": -4.993828175779875, "matches": -4.993828175779875, "missing": -4.993828175779875, "mode": -4.58836306767171, "name": -4.993828175779875, "no": -4.58836306767171, "node": -4.993828175779875, "not": -4.58836306767171, "resolved": -4.58836306767171, "save": -4.993828175779875, "selector": -4.58836306767171, "strict": -4.58836306767171, "submit": -4.993828175779875, "testid": -4.993828175779875, "textcontent": -4.993828175779875, "the": -4.58836306767171, "to": -4.07753744390572, "total": -4.993828175779875, "unable": -4.993828175779875, "violation": -4.58836306767171, "waiting": -4.993828175779875, "with": -4.993828175779875, "xpath": -4.993828175779875 }, "navigation": { "NUM": -4.983606621708336, "aborted": -4.983606621708336, "another": -4.983606621708336, "back": -4.983606621708336, "because": -4.578141513600172, "by": -4.578141513600172, "checkout": -4.983606621708336, "context": -4.983606621708336, "crashed": -4.983606621708336, "dashboard": -4.983606621708336, "destroyed": -4.983606621708336, "detached": -4.983606621708336, "entry": -4.983606621708336, "err": -4.578141513600172, "exceeded": -4.983606621708336, "execution": -4.983606621708336, "failed": -4.983606621708336, "frame": -4.578141513600172, "goback": -4.983606621708336, "goto": -4.290459441148391, "history": -4.983606621708336, "home": -4.983606621708336, "interrupted": -4.578141513600172, "is": -4.983606621708336, "likely": -4.983606621708336, "login": -4.983606621708336, "many": -4.983606621708336, "maybe": -4.983606621708336, "most": -4.983606621708336, "navigate": -4.983606621708336, "navigating": -4.983606621708336, "navigation": -3.7308436532129683, "net": -4.578141513600172, "no": -4.983606621708336, "of": -4.983606621708336, "page": -3.884994333040227, "redirects": -4.983606621708336, "timeout": -4.983606621708336, "to": -3.7308436532129683, "too": -4.983606621708336, "waitforurl": -4.983606621708336, "was": -4.578141513600172 }, "network": { "NUM": -4.57126863431241, "URL": -4.283586561860629, "again": -4.976733742420574, "api": -4.976733742420574, "apirequestcontext": -4.976733742420574, "at": -4.976733742420574, "body": -4.976733742420574, "connect": -4.976733742420574, "connection": -4.57126863431241, "disconnected": -4.976733742420574, "eai": -4.976733742420574, "econnrefused": -4.976733742420574, "err": -3.8781214537524646, "error": -4.976733742420574, "failed": -4.283586561860629, "fetch": -4.976733742420574, "fetching": -4.976733742420574, "from": -4.976733742420574, "get": -4.976733742420574, "getaddrinfo": -4.976733742420574, "goto": -4.976733742420574, "hang": -4.976733742420574, "internet": -4.976733742420574, "loading": -4.976733742420574, "name": -4.976733742420574, "net": -3.8781214537524646, "not": -4.976733742420574, "on": -4.976733742420574, "out": -4.976733742420574, "page": -4.57126863431241, "products": -4.976733742420574, "protocol": -4.976733742420574, "reading": -4.976733742420574, "reason": -4.976733742420574, "refused": -4.976733742420574, "request": -4.57126863431241, "resolved": -4.976733742420574, "resource": -4.976733742420574, "response": -4.976733742420574, "route": -4.976733742420574, "socket": -4.976733742420574, "ssl": -4.976733742420574, "timed": -4.976733742420574, "to": -4.976733742420574, "up": -4.976733742420574, "upstream": -4.976733742420574, "while": -4.976733742420574 }, "timeout": { "NUM": -3.4965075614664802, "after": -5.000584958242754, "be": -4.59511985013459, "cart": -5.000584958242754, "click": -5.000584958242754, "element": -5.000584958242754, "event": -5.000584958242754, "exceeded": -3.6142905971228636, "expect": -5.000584958242754, "fill": -5.000584958242754, "for": -3.7478219897473863, "function": -5.000584958242754, "load": -5.000584958242754, "locator": -4.084294226368599, "navigation": -5.000584958242754, "of": -5.000584958242754, "out": -5.000584958242754, "page": -4.59511985013459, "running": -5.000584958242754, "selector": -5.000584958242754, "submit": -5.000584958242754, "test": -4.59511985013459, "timed": -5.000584958242754, "timeout": -3.6142905971228636, "timeouterror": -4.59511985013459, "to": -4.59511985013459, "tobevisible": -5.000584958242754, "visible": -4.59511985013459, "waitforloadstate": -5.000584958242754, "waitforselector": -5.000584958242754, "waiting": -3.7478219897473863, "while": -5.000584958242754 } }, "playwrightVersion": "1.59.1", "priors": { "assertion": -1.9636097261547143, "env-config": -1.9636097261547143, "flaky-by-retry": -1.9636097261547143, "locator-not-found": -1.9636097261547143, "navigation": -1.9636097261547143, "network": -1.9636097261547143, "timeout": -1.845826690498331 }, "totals": { "assertion": 64, "env-config": 69, "flaky-by-retry": 68, "locator-not-found": 68, "navigation": 65, "network": 63, "timeout": 70 }, "version": 1, "vocabSize": 227 };
 
-// src/utils/logger.ts
-init_esm_shims();
-var PREFIX = "[reportforge]";
-var logger = {
-  info(msg) {
-    console.log(`${PREFIX} ${msg}`);
-  },
-  warn(msg) {
-    console.warn(`${PREFIX} WARN: ${msg}`);
-  },
-  error(msg) {
-    console.error(`${PREFIX} ERROR: ${msg}`);
-  },
-  debug(msg, data) {
-    if (!process.env.RF_DEBUG) return;
-    const suffix = data !== void 0 ? `
-${JSON.stringify(data, null, 2)}` : "";
-    console.log(`${PREFIX} DEBUG: ${msg}${suffix}`);
-  }
-};
-
 // src/analysis/ModelStore.ts
 var MODEL_SIG_DOMAIN = "reportforge-model-sig:v1\n";
 var testDeps = null;
@@ -11093,9 +11122,16 @@ var LicenseClient = class {
 function verifyCache(verifier, cached, expectedFp) {
   try {
     const payload = verifier.verify(cached.jwt);
-    if (payload.fp !== expectedFp) return null;
+    if (payload.fp !== expectedFp) {
+      logger.debug("license cache rejected: fingerprint mismatch", {
+        cachedFp: payload.fp.slice(0, 12),
+        expectedFp: expectedFp.slice(0, 12)
+      });
+      return null;
+    }
     return payload;
-  } catch {
+  } catch (err) {
+    logger.debug("license cache rejected: JWT verify failed", { error: err.message });
     return null;
   }
 }
@@ -11151,7 +11187,8 @@ function maybePrintUpdateNotice(licenseInfo, currentVersion) {
     logger.info(
       `Update available: ${currentVersion} -> ${shown}. Run: npm i -D @reportforge/playwright-pdf@latest`
     );
-  } catch {
+  } catch (err) {
+    logger.debug("update notice failed (ignored)", { error: err.message });
   }
 }
 
@@ -12827,29 +12864,33 @@ var ScreenshotEmbedder = class {
 init_esm_shims();
 import { execSync as execSync2 } from "child_process";
 import fs7 from "fs";
+var LAUNCH_ARGS = [
+  "--no-sandbox",
+  "--disable-setuid-sandbox",
+  "--disable-dev-shm-usage",
+  "--disable-gpu",
+  // Chrome's new headless mode (--headless=new, the only mode left in
+  // Chrome 132+) briefly uncloaks a blank window on some Windows/GPU
+  // combinations. Parking the window far off-screen makes that transient
+  // invisible; harmless everywhere else and does not affect PDF output.
+  "--window-position=-32000,-32000"
+];
 var BrowserManager = class {
   async launch(executablePath) {
     const puppeteer = __require("puppeteer-core");
     const chromePath = this.resolveChromePath(executablePath, puppeteer);
     logger.info(`Launching browser: ${chromePath ?? "puppeteer default"}`);
-    const launchArgs = [
-      "--no-sandbox",
-      "--disable-setuid-sandbox",
-      "--disable-dev-shm-usage",
-      "--disable-gpu"
-    ];
     this.browser = await puppeteer.launch({
       executablePath: chromePath,
       headless: true,
-      args: launchArgs
+      args: LAUNCH_ARGS
     });
     const page = await this.browser.newPage();
     return { browser: this.browser, page };
   }
   async close() {
     if (this.browser) {
-      await this.browser.close().catch(() => {
-      });
+      await this.browser.close().catch((err) => logger.debug("browser close failed (ignored)", { error: err.message }));
       this.browser = void 0;
     }
   }
@@ -12861,7 +12902,8 @@ var BrowserManager = class {
       const chromeFinder = require_lib2();
       const found = chromeFinder();
       if (found && fs7.existsSync(found)) return found;
-    } catch {
+    } catch (err) {
+      logger.debug("chrome discovery: chrome-finder failed", { error: err.message });
     }
     const linuxPaths = [
       "/usr/bin/google-chrome",
@@ -12879,12 +12921,14 @@ var BrowserManager = class {
       }).toString().trim().split("\n")[0];
       if (found && fs7.existsSync(found)) return found;
     } catch {
+      logger.debug("chrome discovery: which lookup found nothing");
     }
     if (puppeteer.executablePath) {
       try {
         const bundled = puppeteer.executablePath();
         if (bundled && fs7.existsSync(bundled)) return bundled;
-      } catch {
+      } catch (err) {
+        logger.debug("chrome discovery: no puppeteer bundled executable", { error: err.message });
       }
     }
     logger.warn(
@@ -12910,8 +12954,10 @@ var HtmlWriter = class {
   }
   async cleanup() {
     if (this.tempPath) {
-      await fs8.promises.unlink(this.tempPath).catch(() => {
-      });
+      const tempPath = this.tempPath;
+      await fs8.promises.unlink(tempPath).catch(
+        (err) => logger.debug("temp HTML cleanup failed (ignored)", { path: tempPath, error: err.message })
+      );
       this.tempPath = void 0;
     }
   }
@@ -12976,7 +13022,8 @@ var PdfEncryptor = class {
     try {
       execFileSync("qpdf", ["--version"], { stdio: "pipe" });
       return true;
-    } catch {
+    } catch (err) {
+      logger.debug("qpdf probe failed \u2014 treating as not installed", { error: err.message });
       return false;
     }
   }
@@ -13133,7 +13180,8 @@ var PdfGenerator = class {
       if (CHARTJS_BUNDLE2) {
         this.templateEngine.setChartjsBundle(CHARTJS_BUNDLE2);
       }
-    } catch {
+    } catch (err) {
+      logger.debug("chartjs bundle not available \u2014 charts disabled", { error: err.message });
     }
   }
   /**
@@ -14049,7 +14097,7 @@ function buildWatchUrl(serverUrl, runId, token) {
 }
 function formatLiveBanner(url) {
   const label = "Live Tracker";
-  const link = `Watch live: ${url}`;
+  const link = `[reportforge] Watch live: ${url}`;
   const width = Math.max(label.length, link.length);
   const rule = "\u2500".repeat(width + 2);
   return [rule, ` ${label.padEnd(width)} `, ` ${link.padEnd(width)} `, rule].join("\n");
@@ -14155,8 +14203,9 @@ var PdfReporter = class {
     this.liveSteps = "failed";
     this.liveConsole = false;
     this.options = parseOptions(rawOptions);
+    setLogLevel(this.options.logLevel);
     this.dataCollector = new DataCollector(this.options.capture);
-    this.version = true ? "0.18.0" : "0.x";
+    this.version = true ? "0.19.1" : "0.x";
     logger.info(`@reportforge/playwright-pdf v${this.version} initialised`);
     this.licenseClient = new LicenseClient({
       licenseKey: this.options.licenseKey,
@@ -14419,8 +14468,9 @@ var PdfReporter = class {
       );
       return;
     }
-    logger.info(`Live Tracker: ${watchUrl}`);
-    console.log(formatLiveBanner(watchUrl));
+    if (isLevelEnabled("info")) {
+      console.log(formatLiveBanner(watchUrl));
+    }
     const isPrimaryShard = !shard || shard.current === 1;
     const notify = this.options.notify;
     if (isPrimaryShard && notify) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reportforge/playwright-pdf",
-  "version": "0.18.0",
+  "version": "0.19.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",