@reportforge/playwright-pdf 0.7.2 → 0.8.1

package/README.md

@@ -58,6 +58,7 @@ Three templates, one reporter. Every PDF is fully offline — fonts, charts, and
 - **Flakiness trend** — top-N flakiest tests table with per-test dot sparkline across stored history runs in the `detailed` template; `flakinessTopN` option (default 5, `0` disables)
 - **Offline failure analysis** — sorts each failure into one of 7 root-cause buckets and renders a per-test root-cause chip inline under the failed test in the `detailed` PDF (dominant-cause one-liner in `executive`). No network, no AI service — a small embedded classifier that updates itself safely over your existing license refresh; pin it any time. Full details at [reportforge.org/docs/advanced/failure-analysis](https://reportforge.org/docs/advanced/failure-analysis).
 - `npx @reportforge/playwright-pdf export-feedback` — exports locally-collected unrecognized failures (tokenized, local-only) for optional manual sharing.
+- **Rich execution capture** — opt-in repro steps, Node console tail, and trace/video links under each failed test in the defect log, read straight from the Playwright step tree — no fixtures, no test-code changes. Enable via `capture` (`steps` / `console` / `evidence`); off by default.
 - **Configurable sections** — add or remove any report section per template via `sections`.
 - **Hybrid licensing** — one short key unlocks it; reports keep rendering offline via a cached JWT between refreshes
 
@@ -194,6 +195,7 @@ All options are the second element of the reporter tuple.
 | `shardResults` | `string \| string[]` | — | Glob or path array of Playwright JSON shard report files to merge into one PDF. See the Shard Merging docs. |
 | `notify` | `object` | — | Notification channels: `slack`, `teams`, `discord` (each `{ url, enabled, on }`), `email` (`{ to, enabled, on, attachPdf }`). See the Notifications docs. |
 | `failureAnalysis` | `object` | `{ enabled: true }` | Offline failure root-cause analysis (embedded Naive Bayes; no runtime network). Fields: `enabled` (default `true`), `maxClusters` (default `10`), `minStrength` (`weak`\|`moderate`\|`strong`, default `weak`), `maxFailuresToAnalyse` (default `500`), `collectUnclassified` (default `true`), `autoUpdateModel` (default `true`). See the Failure Analysis docs. |
+| `capture` | `object` | `{}` (off) | Opt-in rich execution capture for the defect log (reporter-side; no fixtures, no test-code changes). Fields: `steps` (compacted repro-steps trail from the Playwright step tree, default `false`), `apiSteps` (include granular `pw:api` click/fill/goto actions in the trail; off by default the trail shows only `test.step` intent + `expect` assertions + the failing action, default `false`), `console` (Node stdout/stderr tail, default `false`), `evidence` (trace/video file links, default `false`), `maxSteps` (default `50`), `maxConsoleLines` (default `50`). Renders in the Defect Log section of the `detailed` template. |
 | `historyFile` | `string` | `~/.reportforge/{key}/history.json` | Path to the history JSON file. Relative paths resolve from `cwd`. Enables pass-rate trending charts in the `detailed` template. |
 | `historySize` | `number` | `10` | Maximum number of test runs to keep in the history file (integer ≥ 2). Older runs are pruned on append. |
 | `showTrend` | `boolean` | `true` | Show the pass-rate sparkline and delta badge in the `detailed` template. Set to `false` to disable history tracking entirely. |
@@ -396,7 +398,7 @@ reporter: [['@reportforge/playwright-pdf', {
 | `failureDeepDive` | Inline failure detail under each failed test in the breakdown: error message, stack trace, screenshot, retry history |
 | `failureAnalysis` | Inline per-test root-cause chip under each failed test (category + representative error + match strength, from the offline classifier) |
 | `slowTests` | `SLOW` badge on the duration-ranked slowest tests, shown inline in the breakdown |
-| `defectLog` | `DEF-####` numbered failure table (severity, retries) |
+| `defectLog` | `DEF-####` numbered failure table (severity, duration) + opt-in repro detail (`capture`) |
 
 #### Display modifiers — tune a section that's on
 

package/dist/cli/index.js

@@ -138,6 +138,7 @@ function buildDemoFailures() {
         { attempt: 1, status: "failed", duration: 4900 },
         { attempt: 2, status: "failed", duration: 4900 }
       ],
+      durationMs: 4900,
       severity: "critical"
     },
     {
@@ -153,6 +154,7 @@ function buildDemoFailures() {
         { attempt: 1, status: "failed", duration: 5e3 },
         { attempt: 2, status: "failed", duration: 4900 }
       ],
+      durationMs: 4900,
       severity: "high"
     },
     {
@@ -168,6 +170,7 @@ function buildDemoFailures() {
         { attempt: 1, status: "failed", duration: 4e3 },
         { attempt: 2, status: "failed", duration: 3900 }
       ],
+      durationMs: 3900,
       severity: "medium"
     }
   ];
@@ -11828,7 +11831,7 @@ ${issues}`);
   }
   return result.data;
 }
-var hexColor, channelConfigSchema, emailChannelConfigSchema, notifyConfigSchema, failureAnalysisConfigSchema, sectionFlagsShape, sectionFlagsSchema, sectionsSchema, ReporterOptionsSchema;
+var hexColor, channelConfigSchema, emailChannelConfigSchema, notifyConfigSchema, failureAnalysisConfigSchema, captureConfigSchema, sectionFlagsShape, sectionFlagsSchema, sectionsSchema, ReporterOptionsSchema;
 var init_schema = __esm({
   "src/config/schema.ts"() {
     "use strict";
@@ -11867,6 +11870,14 @@ var init_schema = __esm({
       collectUnclassified: external_exports.boolean().default(true),
       autoUpdateModel: external_exports.boolean().default(true)
     }).default({});
+    captureConfigSchema = external_exports.object({
+      steps: external_exports.boolean().default(false),
+      apiSteps: external_exports.boolean().default(false),
+      console: external_exports.boolean().default(false),
+      evidence: external_exports.boolean().default(false),
+      maxSteps: external_exports.number().int().min(1).max(500).default(50),
+      maxConsoleLines: external_exports.number().int().min(1).max(1e3).default(50)
+    }).default({});
     sectionFlagsShape = Object.fromEntries(
       SECTION_KEYS.map((k) => [k, external_exports.boolean().optional()])
     );
@@ -11907,6 +11918,7 @@ var init_schema = __esm({
       flakinessTopN: external_exports.number().int().min(0, "flakinessTopN must be 0 or greater").optional().default(DEFAULT_OPTIONS.flakinessTopN),
       slowTestThreshold: external_exports.number().int().min(0, "slowTestThreshold must be 0 or greater").optional().default(DEFAULT_OPTIONS.slowTestThreshold),
       failureAnalysis: failureAnalysisConfigSchema,
+      capture: captureConfigSchema,
       templatePath: external_exports.union([
         external_exports.string().regex(/\.hbs$/, "templatePath must end with .hbs").refine((v) => v.slice(0, -4).trim().length > 0, "templatePath basename must not be empty"),
         external_exports.array(
@@ -12072,6 +12084,17 @@ var init_constants = __esm({
   }
 });
 
+// src/utils/truncate.ts
+function clampWithEllipsis(text, max) {
+  return text.length > max ? `${text.slice(0, max)}\u2026` : text;
+}
+var init_truncate = __esm({
+  "src/utils/truncate.ts"() {
+    "use strict";
+    init_cjs_shims();
+  }
+});
+
 // src/analysis/FailureClusterer.ts
 function errorHeader(message) {
   const beforeCallLog = message.split(/\n\s*Call log:/i)[0];
@@ -12107,8 +12130,7 @@ function topFrame(stack) {
   return void 0;
 }
 function representativeMessage(message) {
-  const firstLine = message.split("\n")[0];
-  return firstLine.length > MAX_MESSAGE_CHARS ? `${firstLine.slice(0, MAX_MESSAGE_CHARS)}\u2026` : firstLine;
+  return clampWithEllipsis(message.split("\n")[0], MAX_MESSAGE_CHARS);
 }
 function classifyOne(f, model) {
   const frame = topFrame(f.error.stack);
@@ -12163,6 +12185,7 @@ var init_FailureClusterer = __esm({
     init_cjs_shims();
     init_NaiveBayesClassifier();
     init_constants();
+    init_truncate();
     MAX_TESTS_PER_CLUSTER = 20;
     MAX_MESSAGE_CHARS = 200;
     MESSAGE_RULES = [

package/dist/index.d.mts

@@ -209,6 +209,34 @@ interface ReporterOptions {
          */
         autoUpdateModel?: boolean;
     };
+    /**
+     * Opt-in rich execution capture for the defect log. Reporter-side only — reads
+     * what Playwright already records on each test result (steps, console, trace/
+     * video attachments); no fixtures and no test-code changes. Off by default, so
+     * reports are unchanged until you enable it. Captured detail renders in the
+     * Defect Log section of the `detailed` template.
+     *
+     * @example
+     * capture: { steps: true, console: true, evidence: true }
+     */
+    capture?: {
+        /** Capture a compacted repro-steps trail from the Playwright step tree. Default: false */
+        steps?: boolean;
+        /**
+         * Include granular `pw:api` actions (click/fill/goto) in the repro trail. Off by
+         * default — the trail shows only `test.step` intent + `expect` assertions + the
+         * failing action. Default: false
+         */
+        apiSteps?: boolean;
+        /** Capture the tail of the test's Node stdout/stderr. Default: false */
+        console?: boolean;
+        /** Capture file links to the Playwright trace.zip and video. Default: false */
+        evidence?: boolean;
+        /** Max repro steps retained per failure. Default: 50 */
+        maxSteps?: number;
+        /** Max console lines retained per stream. Default: 50 */
+        maxConsoleLines?: number;
+    };
     /**
      * Path to the history JSON file. Defaults to
      * `~/.reportforge/{projectKey}/history.json` where `projectKey` is derived

package/dist/index.d.ts

@@ -209,6 +209,34 @@ interface ReporterOptions {
          */
         autoUpdateModel?: boolean;
     };
+    /**
+     * Opt-in rich execution capture for the defect log. Reporter-side only — reads
+     * what Playwright already records on each test result (steps, console, trace/
+     * video attachments); no fixtures and no test-code changes. Off by default, so
+     * reports are unchanged until you enable it. Captured detail renders in the
+     * Defect Log section of the `detailed` template.
+     *
+     * @example
+     * capture: { steps: true, console: true, evidence: true }
+     */
+    capture?: {
+        /** Capture a compacted repro-steps trail from the Playwright step tree. Default: false */
+        steps?: boolean;
+        /**
+         * Include granular `pw:api` actions (click/fill/goto) in the repro trail. Off by
+         * default — the trail shows only `test.step` intent + `expect` assertions + the
+         * failing action. Default: false
+         */
+        apiSteps?: boolean;
+        /** Capture the tail of the test's Node stdout/stderr. Default: false */
+        console?: boolean;
+        /** Capture file links to the Playwright trace.zip and video. Default: false */
+        evidence?: boolean;
+        /** Max repro steps retained per failure. Default: 50 */
+        maxSteps?: number;
+        /** Max console lines retained per stream. Default: 50 */
+        maxConsoleLines?: number;
+    };
     /**
      * Path to the history JSON file. Defaults to
      * `~/.reportforge/{projectKey}/history.json` where `projectKey` is derived

package/dist/index.js

@@ -10476,6 +10476,14 @@ var failureAnalysisConfigSchema = external_exports.object({
   collectUnclassified: external_exports.boolean().default(true),
   autoUpdateModel: external_exports.boolean().default(true)
 }).default({});
+var captureConfigSchema = external_exports.object({
+  steps: external_exports.boolean().default(false),
+  apiSteps: external_exports.boolean().default(false),
+  console: external_exports.boolean().default(false),
+  evidence: external_exports.boolean().default(false),
+  maxSteps: external_exports.number().int().min(1).max(500).default(50),
+  maxConsoleLines: external_exports.number().int().min(1).max(1e3).default(50)
+}).default({});
 var sectionFlagsShape = Object.fromEntries(
   SECTION_KEYS.map((k) => [k, external_exports.boolean().optional()])
 );
@@ -10516,6 +10524,7 @@ var ReporterOptionsSchema = external_exports.object({
   flakinessTopN: external_exports.number().int().min(0, "flakinessTopN must be 0 or greater").optional().default(DEFAULT_OPTIONS.flakinessTopN),
   slowTestThreshold: external_exports.number().int().min(0, "slowTestThreshold must be 0 or greater").optional().default(DEFAULT_OPTIONS.slowTestThreshold),
   failureAnalysis: failureAnalysisConfigSchema,
+  capture: captureConfigSchema,
   templatePath: external_exports.union([
     external_exports.string().regex(/\.hbs$/, "templatePath must end with .hbs").refine((v) => v.slice(0, -4).trim().length > 0, "templatePath basename must not be empty"),
     external_exports.array(
@@ -11118,6 +11127,12 @@ var STRENGTH = {
 var STRENGTH_LEVELS = ["weak", "moderate", "strong"];
 var OVERRIDE_MARGIN = 999;
 
+// src/utils/truncate.ts
+init_cjs_shims();
+function clampWithEllipsis(text, max) {
+  return text.length > max ? `${text.slice(0, max)}\u2026` : text;
+}
+
 // src/analysis/FailureClusterer.ts
 var MAX_TESTS_PER_CLUSTER = 20;
 var MAX_MESSAGE_CHARS = 200;
@@ -11161,8 +11176,7 @@ function topFrame(stack) {
   return void 0;
 }
 function representativeMessage(message) {
-  const firstLine = message.split("\n")[0];
-  return firstLine.length > MAX_MESSAGE_CHARS ? `${firstLine.slice(0, MAX_MESSAGE_CHARS)}\u2026` : firstLine;
+  return clampWithEllipsis(message.split("\n")[0], MAX_MESSAGE_CHARS);
 }
 function classifyOne(f, model) {
   const frame = topFrame(f.error.stack);
@@ -11386,6 +11400,170 @@ function stripAnsi(input) {
   return input.replace(ANSI_PATTERN, "");
 }
 
+// src/collector/execution-capture.ts
+init_cjs_shims();
+var MAX_TITLE_CHARS = 200;
+var DEFAULT_MAX_STEPS = 50;
+var DEFAULT_MAX_CONSOLE_LINES = 50;
+var PW_API_WINDOW = 10;
+var isTeardown = (category) => category === "hook" || category === "fixture";
+var inHookSubtree = (flat, f) => isTeardown(f.category) || f.ancestors.some((a) => isTeardown(flat[a].category));
+function flatten(steps) {
+  const out = [];
+  const walk = (nodes, depth, ancestors) => {
+    for (const s of nodes ?? []) {
+      const index = out.length;
+      out.push({
+        raw: s,
+        category: s.category ?? "",
+        depth,
+        hasError: s.error != null,
+        ancestors
+      });
+      if (s.steps?.length) walk(s.steps, depth + 1, [...ancestors, index]);
+    }
+  };
+  walk(steps ?? [], 0, []);
+  return out;
+}
+function materialize(n, isFailing) {
+  const loc = n.raw.location;
+  return {
+    title: clampWithEllipsis(n.raw.title ?? "", MAX_TITLE_CHARS),
+    category: n.category,
+    durationMs: Math.max(0, Math.round(n.raw.duration ?? 0)),
+    depth: n.depth,
+    failed: n.hasError,
+    errorMessage: isFailing && n.raw.error?.message ? clampWithEllipsis(stripAnsi(n.raw.error.message).split("\n")[0], MAX_TITLE_CHARS) : void 0,
+    location: loc?.file != null ? `${loc.file}:${loc.line ?? 0}` : void 0
+  };
+}
+function pickFailingIdx(flat) {
+  const pick = (allowTeardown) => {
+    let idx = -1;
+    for (let i = 0; i < flat.length; i++) {
+      const f = flat[i];
+      if (!f.hasError || !allowTeardown && inHookSubtree(flat, f)) continue;
+      if (idx === -1 || f.depth >= flat[idx].depth) idx = i;
+    }
+    return idx;
+  };
+  const body = pick(false);
+  return body >= 0 ? body : pick(true);
+}
+function compactSteps(rawSteps, opts = {}) {
+  const flat = flatten(rawSteps);
+  if (flat.length === 0) return { steps: [] };
+  const maxSteps = opts.maxSteps ?? DEFAULT_MAX_STEPS;
+  const failingIdx = pickFailingIdx(flat);
+  const keep = /* @__PURE__ */ new Set();
+  flat.forEach((f, i) => {
+    if (f.category === "test.step" || f.category === "expect") keep.add(i);
+  });
+  if (failingIdx >= 0) {
+    keep.add(failingIdx);
+    for (const a of flat[failingIdx].ancestors) keep.add(a);
+    if (opts.apiSteps) {
+      const pwApiBefore = [];
+      for (let i = 0; i < failingIdx; i++) {
+        if (flat[i].category === "pw:api" && !inHookSubtree(flat, flat[i])) pwApiBefore.push(i);
+      }
+      for (const i of pwApiBefore.slice(-PW_API_WINDOW)) keep.add(i);
+    }
+  }
+  let keepArr = [...keep].sort((a, b) => a - b);
+  if (keepArr.length > maxSteps) {
+    keepArr = keepArr.slice(-maxSteps);
+    if (failingIdx >= 0 && !keepArr.includes(failingIdx)) {
+      keepArr = [failingIdx, ...keepArr.slice(1)];
+    }
+  }
+  const cache = /* @__PURE__ */ new Map();
+  const mat = (i) => {
+    let es = cache.get(i);
+    if (!es) {
+      es = materialize(flat[i], i === failingIdx);
+      cache.set(i, es);
+    }
+    return es;
+  };
+  return {
+    steps: keepArr.map(mat),
+    failingStep: failingIdx >= 0 ? mat(failingIdx) : void 0
+  };
+}
+function tailConsole(stdout, stderr, maxLines = DEFAULT_MAX_CONSOLE_LINES) {
+  const tail = (chunks) => {
+    if (chunks.length === 0) return { lines: [], truncated: false };
+    const all = chunks.join("").split(/\r?\n/);
+    if (all.length > 0 && all[all.length - 1] === "") all.pop();
+    const lines = all.slice(-maxLines).map(stripAnsi);
+    return { lines, truncated: all.length > lines.length };
+  };
+  const o = tail(stdout);
+  const e = tail(stderr);
+  if (o.lines.length === 0 && e.lines.length === 0) return void 0;
+  return {
+    stdout: o.lines,
+    stderr: e.lines,
+    truncated: o.truncated || e.truncated,
+    stdoutTruncated: o.truncated,
+    stderrTruncated: e.truncated
+  };
+}
+function extractEvidence(attachments) {
+  let tracePath;
+  let videoPath;
+  for (const a of attachments) {
+    if (!a.path) continue;
+    const looksLikeTrace = a.name === "trace" || a.contentType === "application/zip" && (a.name ?? "").includes("trace");
+    if (!tracePath && looksLikeTrace) tracePath = a.path;
+    if (!videoPath && a.contentType?.startsWith("video/")) videoPath = a.path;
+  }
+  if (!tracePath && !videoPath) return void 0;
+  return { tracePath, videoPath };
+}
+function buildExecution(input, opts, source) {
+  const capture = {};
+  if (opts.steps) {
+    const { steps, failingStep } = compactSteps(input.steps, {
+      maxSteps: opts.maxSteps,
+      apiSteps: opts.apiSteps
+    });
+    if (steps.length > 0) capture.steps = steps;
+    if (failingStep) capture.failingStep = failingStep;
+  }
+  if (opts.console) {
+    const console2 = tailConsole(input.stdout, input.stderr, opts.maxConsoleLines);
+    if (console2) capture.console = console2;
+  }
+  if (opts.evidence) {
+    const evidence = extractEvidence(input.attachments);
+    if (evidence) capture.evidence = evidence;
+  }
+  if (Object.keys(capture).length === 0) return void 0;
+  capture.source = source;
+  return capture;
+}
+function chunkToString(chunk) {
+  return typeof chunk === "string" ? chunk : chunk.toString("utf8");
+}
+function decodeShardChunk(c) {
+  return c.text ?? (c.buffer ? Buffer.from(c.buffer, "base64").toString("utf8") : "");
+}
+function executionFromResult(result, opts) {
+  return buildExecution(
+    {
+      steps: result.steps,
+      stdout: result.stdout.map(chunkToString),
+      stderr: result.stderr.map(chunkToString),
+      attachments: result.attachments
+    },
+    opts,
+    "reporter"
+  );
+}
+
 // src/collector/SuiteWalker.ts
 init_cjs_shims();
 
@@ -11595,7 +11773,9 @@ function gitCommit() {
 
 // src/collector/DataCollector.ts
 var DataCollector = class {
-  constructor() {
+  /** @param captureOpts Per-run rich-capture knobs (steps/console/evidence); all off by default. */
+  constructor(captureOpts = {}) {
+    this.captureOpts = captureOpts;
     this.resultMap = /* @__PURE__ */ new Map();
     this.failureRecords = [];
     this.startTime = Date.now();
@@ -11665,7 +11845,9 @@ var DataCollector = class {
           duration: result.duration
         }
       ],
-      severity
+      durationMs: result.duration,
+      severity,
+      execution: executionFromResult(result, this.captureOpts)
     };
   }
   inferSeverity(test) {
@@ -11771,6 +11953,10 @@ var import_fs3 = require("fs");
 var import_glob = require("glob");
 var import_node_module = require("module");
 var ShardMerger = class {
+  /** @param captureOpts Per-run rich-capture knobs; all off by default (parity with DataCollector). */
+  constructor(captureOpts = {}) {
+    this.captureOpts = captureOpts;
+  }
   merge(filePaths) {
     if (filePaths.length === 0) throw new Error("shardResults: no valid JSON shard files found");
     const resolved = this.resolveShardPaths(filePaths);
@@ -11975,7 +12161,21 @@ var ShardMerger = class {
         status: r.status,
         duration: r.duration
       })),
-      severity: "medium"
+      durationMs: lastResult?.duration ?? 0,
+      severity: "medium",
+      execution: lastResult ? buildExecution(
+        {
+          // Guard each field — a partial / non-conformant / older shard JSON can
+          // omit steps or the stdout/stderr arrays; an unguarded .map/iterate would
+          // throw and (via the merge catch) silently skip the entire PDF.
+          steps: lastResult.steps ?? [],
+          stdout: (lastResult.stdout ?? []).map(decodeShardChunk),
+          stderr: (lastResult.stderr ?? []).map(decodeShardChunk),
+          attachments: lastResult.attachments ?? []
+        },
+        this.captureOpts,
+        "shard"
+      ) : void 0
     };
   }
   buildEnvironment(report) {
@@ -13292,10 +13492,10 @@ var NotificationSender = class {
 var PdfReporter = class {
   constructor(rawOptions = {}) {
     this.cwd = process.cwd();
-    this.dataCollector = new DataCollector();
     this.pdfGenerator = new PdfGenerator();
     this.options = parseOptions(rawOptions);
-    const version = true ? "0.7.2" : "0.x";
+    this.dataCollector = new DataCollector(this.options.capture);
+    const version = true ? "0.8.1" : "0.x";
     logger.info(`@reportforge/playwright-pdf v${version} initialised`);
     this.licenseClient = new LicenseClient({
       licenseKey: this.options.licenseKey,
@@ -13342,7 +13542,7 @@ var PdfReporter = class {
   _collectData(result) {
     if (this.options.shardResults && this.options.shardResults.length > 0) {
       try {
-        return new ShardMerger().merge(this.options.shardResults);
+        return new ShardMerger(this.options.capture).merge(this.options.shardResults);
       } catch (err) {
         logger.warn(`shardResults merge failed: ${err.message}. PDF generation skipped.`);
         return null;

package/dist/index.mjs

@@ -10477,6 +10477,14 @@ var failureAnalysisConfigSchema = external_exports.object({
   collectUnclassified: external_exports.boolean().default(true),
   autoUpdateModel: external_exports.boolean().default(true)
 }).default({});
+var captureConfigSchema = external_exports.object({
+  steps: external_exports.boolean().default(false),
+  apiSteps: external_exports.boolean().default(false),
+  console: external_exports.boolean().default(false),
+  evidence: external_exports.boolean().default(false),
+  maxSteps: external_exports.number().int().min(1).max(500).default(50),
+  maxConsoleLines: external_exports.number().int().min(1).max(1e3).default(50)
+}).default({});
 var sectionFlagsShape = Object.fromEntries(
   SECTION_KEYS.map((k) => [k, external_exports.boolean().optional()])
 );
@@ -10517,6 +10525,7 @@ var ReporterOptionsSchema = external_exports.object({
   flakinessTopN: external_exports.number().int().min(0, "flakinessTopN must be 0 or greater").optional().default(DEFAULT_OPTIONS.flakinessTopN),
   slowTestThreshold: external_exports.number().int().min(0, "slowTestThreshold must be 0 or greater").optional().default(DEFAULT_OPTIONS.slowTestThreshold),
   failureAnalysis: failureAnalysisConfigSchema,
+  capture: captureConfigSchema,
   templatePath: external_exports.union([
     external_exports.string().regex(/\.hbs$/, "templatePath must end with .hbs").refine((v) => v.slice(0, -4).trim().length > 0, "templatePath basename must not be empty"),
     external_exports.array(
@@ -11119,6 +11128,12 @@ var STRENGTH = {
 var STRENGTH_LEVELS = ["weak", "moderate", "strong"];
 var OVERRIDE_MARGIN = 999;
 
+// src/utils/truncate.ts
+init_esm_shims();
+function clampWithEllipsis(text, max) {
+  return text.length > max ? `${text.slice(0, max)}\u2026` : text;
+}
+
 // src/analysis/FailureClusterer.ts
 var MAX_TESTS_PER_CLUSTER = 20;
 var MAX_MESSAGE_CHARS = 200;
@@ -11162,8 +11177,7 @@ function topFrame(stack) {
   return void 0;
 }
 function representativeMessage(message) {
-  const firstLine = message.split("\n")[0];
-  return firstLine.length > MAX_MESSAGE_CHARS ? `${firstLine.slice(0, MAX_MESSAGE_CHARS)}\u2026` : firstLine;
+  return clampWithEllipsis(message.split("\n")[0], MAX_MESSAGE_CHARS);
 }
 function classifyOne(f, model) {
   const frame = topFrame(f.error.stack);
@@ -11387,6 +11401,170 @@ function stripAnsi(input) {
   return input.replace(ANSI_PATTERN, "");
 }
 
+// src/collector/execution-capture.ts
+init_esm_shims();
+var MAX_TITLE_CHARS = 200;
+var DEFAULT_MAX_STEPS = 50;
+var DEFAULT_MAX_CONSOLE_LINES = 50;
+var PW_API_WINDOW = 10;
+var isTeardown = (category) => category === "hook" || category === "fixture";
+var inHookSubtree = (flat, f) => isTeardown(f.category) || f.ancestors.some((a) => isTeardown(flat[a].category));
+function flatten(steps) {
+  const out = [];
+  const walk = (nodes, depth, ancestors) => {
+    for (const s of nodes ?? []) {
+      const index = out.length;
+      out.push({
+        raw: s,
+        category: s.category ?? "",
+        depth,
+        hasError: s.error != null,
+        ancestors
+      });
+      if (s.steps?.length) walk(s.steps, depth + 1, [...ancestors, index]);
+    }
+  };
+  walk(steps ?? [], 0, []);
+  return out;
+}
+function materialize(n, isFailing) {
+  const loc = n.raw.location;
+  return {
+    title: clampWithEllipsis(n.raw.title ?? "", MAX_TITLE_CHARS),
+    category: n.category,
+    durationMs: Math.max(0, Math.round(n.raw.duration ?? 0)),
+    depth: n.depth,
+    failed: n.hasError,
+    errorMessage: isFailing && n.raw.error?.message ? clampWithEllipsis(stripAnsi(n.raw.error.message).split("\n")[0], MAX_TITLE_CHARS) : void 0,
+    location: loc?.file != null ? `${loc.file}:${loc.line ?? 0}` : void 0
+  };
+}
+function pickFailingIdx(flat) {
+  const pick = (allowTeardown) => {
+    let idx = -1;
+    for (let i = 0; i < flat.length; i++) {
+      const f = flat[i];
+      if (!f.hasError || !allowTeardown && inHookSubtree(flat, f)) continue;
+      if (idx === -1 || f.depth >= flat[idx].depth) idx = i;
+    }
+    return idx;
+  };
+  const body = pick(false);
+  return body >= 0 ? body : pick(true);
+}
+function compactSteps(rawSteps, opts = {}) {
+  const flat = flatten(rawSteps);
+  if (flat.length === 0) return { steps: [] };
+  const maxSteps = opts.maxSteps ?? DEFAULT_MAX_STEPS;
+  const failingIdx = pickFailingIdx(flat);
+  const keep = /* @__PURE__ */ new Set();
+  flat.forEach((f, i) => {
+    if (f.category === "test.step" || f.category === "expect") keep.add(i);
+  });
+  if (failingIdx >= 0) {
+    keep.add(failingIdx);
+    for (const a of flat[failingIdx].ancestors) keep.add(a);
+    if (opts.apiSteps) {
+      const pwApiBefore = [];
+      for (let i = 0; i < failingIdx; i++) {
+        if (flat[i].category === "pw:api" && !inHookSubtree(flat, flat[i])) pwApiBefore.push(i);
+      }
+      for (const i of pwApiBefore.slice(-PW_API_WINDOW)) keep.add(i);
+    }
+  }
+  let keepArr = [...keep].sort((a, b) => a - b);
+  if (keepArr.length > maxSteps) {
+    keepArr = keepArr.slice(-maxSteps);
+    if (failingIdx >= 0 && !keepArr.includes(failingIdx)) {
+      keepArr = [failingIdx, ...keepArr.slice(1)];
+    }
+  }
+  const cache = /* @__PURE__ */ new Map();
+  const mat = (i) => {
+    let es = cache.get(i);
+    if (!es) {
+      es = materialize(flat[i], i === failingIdx);
+      cache.set(i, es);
+    }
+    return es;
+  };
+  return {
+    steps: keepArr.map(mat),
+    failingStep: failingIdx >= 0 ? mat(failingIdx) : void 0
+  };
+}
+function tailConsole(stdout, stderr, maxLines = DEFAULT_MAX_CONSOLE_LINES) {
+  const tail = (chunks) => {
+    if (chunks.length === 0) return { lines: [], truncated: false };
+    const all = chunks.join("").split(/\r?\n/);
+    if (all.length > 0 && all[all.length - 1] === "") all.pop();
+    const lines = all.slice(-maxLines).map(stripAnsi);
+    return { lines, truncated: all.length > lines.length };
+  };
+  const o = tail(stdout);
+  const e = tail(stderr);
+  if (o.lines.length === 0 && e.lines.length === 0) return void 0;
+  return {
+    stdout: o.lines,
+    stderr: e.lines,
+    truncated: o.truncated || e.truncated,
+    stdoutTruncated: o.truncated,
+    stderrTruncated: e.truncated
+  };
+}
+function extractEvidence(attachments) {
+  let tracePath;
+  let videoPath;
+  for (const a of attachments) {
+    if (!a.path) continue;
+    const looksLikeTrace = a.name === "trace" || a.contentType === "application/zip" && (a.name ?? "").includes("trace");
+    if (!tracePath && looksLikeTrace) tracePath = a.path;
+    if (!videoPath && a.contentType?.startsWith("video/")) videoPath = a.path;
+  }
+  if (!tracePath && !videoPath) return void 0;
+  return { tracePath, videoPath };
+}
+function buildExecution(input, opts, source) {
+  const capture = {};
+  if (opts.steps) {
+    const { steps, failingStep } = compactSteps(input.steps, {
+      maxSteps: opts.maxSteps,
+      apiSteps: opts.apiSteps
+    });
+    if (steps.length > 0) capture.steps = steps;
+    if (failingStep) capture.failingStep = failingStep;
+  }
+  if (opts.console) {
+    const console2 = tailConsole(input.stdout, input.stderr, opts.maxConsoleLines);
+    if (console2) capture.console = console2;
+  }
+  if (opts.evidence) {
+    const evidence = extractEvidence(input.attachments);
+    if (evidence) capture.evidence = evidence;
+  }
+  if (Object.keys(capture).length === 0) return void 0;
+  capture.source = source;
+  return capture;
+}
+function chunkToString(chunk) {
+  return typeof chunk === "string" ? chunk : chunk.toString("utf8");
+}
+function decodeShardChunk(c) {
+  return c.text ?? (c.buffer ? Buffer.from(c.buffer, "base64").toString("utf8") : "");
+}
+function executionFromResult(result, opts) {
+  return buildExecution(
+    {
+      steps: result.steps,
+      stdout: result.stdout.map(chunkToString),
+      stderr: result.stderr.map(chunkToString),
+      attachments: result.attachments
+    },
+    opts,
+    "reporter"
+  );
+}
+
 // src/collector/SuiteWalker.ts
 init_esm_shims();
 
@@ -11596,7 +11774,9 @@ function gitCommit() {
 
 // src/collector/DataCollector.ts
 var DataCollector = class {
-  constructor() {
+  /** @param captureOpts Per-run rich-capture knobs (steps/console/evidence); all off by default. */
+  constructor(captureOpts = {}) {
+    this.captureOpts = captureOpts;
     this.resultMap = /* @__PURE__ */ new Map();
     this.failureRecords = [];
     this.startTime = Date.now();
@@ -11666,7 +11846,9 @@ var DataCollector = class {
           duration: result.duration
         }
       ],
-      severity
+      durationMs: result.duration,
+      severity,
+      execution: executionFromResult(result, this.captureOpts)
     };
   }
   inferSeverity(test) {
@@ -11772,6 +11954,10 @@ import { readFileSync } from "fs";
 import { globSync } from "glob";
 import { createRequire } from "module";
 var ShardMerger = class {
+  /** @param captureOpts Per-run rich-capture knobs; all off by default (parity with DataCollector). */
+  constructor(captureOpts = {}) {
+    this.captureOpts = captureOpts;
+  }
   merge(filePaths) {
     if (filePaths.length === 0) throw new Error("shardResults: no valid JSON shard files found");
     const resolved = this.resolveShardPaths(filePaths);
@@ -11976,7 +12162,21 @@ var ShardMerger = class {
         status: r.status,
         duration: r.duration
       })),
-      severity: "medium"
+      durationMs: lastResult?.duration ?? 0,
+      severity: "medium",
+      execution: lastResult ? buildExecution(
+        {
+          // Guard each field — a partial / non-conformant / older shard JSON can
+          // omit steps or the stdout/stderr arrays; an unguarded .map/iterate would
+          // throw and (via the merge catch) silently skip the entire PDF.
+          steps: lastResult.steps ?? [],
+          stdout: (lastResult.stdout ?? []).map(decodeShardChunk),
+          stderr: (lastResult.stderr ?? []).map(decodeShardChunk),
+          attachments: lastResult.attachments ?? []
+        },
+        this.captureOpts,
+        "shard"
+      ) : void 0
     };
   }
   buildEnvironment(report) {
@@ -13293,10 +13493,10 @@ var NotificationSender = class {
 var PdfReporter = class {
   constructor(rawOptions = {}) {
     this.cwd = process.cwd();
-    this.dataCollector = new DataCollector();
     this.pdfGenerator = new PdfGenerator();
     this.options = parseOptions(rawOptions);
-    const version = true ? "0.7.2" : "0.x";
+    this.dataCollector = new DataCollector(this.options.capture);
+    const version = true ? "0.8.1" : "0.x";
     logger.info(`@reportforge/playwright-pdf v${version} initialised`);
     this.licenseClient = new LicenseClient({
       licenseKey: this.options.licenseKey,
@@ -13343,7 +13543,7 @@ var PdfReporter = class {
   _collectData(result) {
     if (this.options.shardResults && this.options.shardResults.length > 0) {
       try {
-        return new ShardMerger().merge(this.options.shardResults);
+        return new ShardMerger(this.options.capture).merge(this.options.shardResults);
       } catch (err) {
         logger.warn(`shardResults merge failed: ${err.message}. PDF generation skipped.`);
         return null;

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

@@ -8,20 +8,70 @@
         <th>Title</th>
         <th style="width:100px;">Suite</th>
         <th style="width:80px;">Severity</th>
-        <th style="width:55px;text-align:center;">Retries</th>
+        <th style="width:72px;text-align:right;">Duration</th>
       </tr>
     </thead>
-    <tbody>
       {{#each failures}}
+      <tbody class="defect-row-group">
       <tr class="no-break">
         <td class="defect-id">DEF-{{addOne @index}}</td>
         <td style="font-weight:500;">{{testTitle}}</td>
         <td style="font-size:9px;color:var(--text-3);font-family:'JetBrains Mono',monospace;">{{lastItem suitePath}}</td>
         <td><span class="severity--{{severity}}">{{upperCase severity}}</span></td>
-        <td style="text-align:center;color:var(--text-3);">{{retryCount}}</td>
+        <td style="text-align:right;color:var(--text-3);font-family:'JetBrains Mono',monospace;">{{formatDuration durationMs}}</td>
       </tr>
+      {{#if execution}}
+      <tr class="defect-detail-row">
+        <td colspan="5">
+          <div class="defect-detail">
+            {{! Error sits at the failing step inside the trail. Only when there is no
+                identified failing step (capture.steps off, or no errored step) is it
+                shown here under the title as a fallback. }}
+            {{#unless execution.failingStep}}
+            {{#if error.message}}
+            <div class="defect-detail__error">{{error.message}}</div>
+            {{/if}}
+            {{/unless}}
+
+            {{#if execution.steps.length}}
+            <div class="repro">
+              <div class="repro__tag">Steps to Reproduce</div>
+              <ol class="repro-steps">
+                {{#each execution.steps}}
+                <li class="repro-step{{#if failed}} repro-step--failed{{/if}}" style="--d:{{depth}};">
+                  <span class="repro-step__cat">{{category}}</span>
+                  <span class="repro-step__title">{{title}}</span>
+                  {{#if failed}}{{#if location}}<span class="repro-step__loc">{{location}}</span>{{/if}}{{/if}}
+                  <span class="repro-step__dur">{{formatDuration durationMs}}</span>
+                  {{#if errorMessage}}<div class="repro-step__error">{{../error.message}}</div>{{/if}}
+                </li>
+                {{/each}}
+              </ol>
+            </div>
+            {{/if}}
+
+            {{#if execution.console}}
+            <div class="console-tail">
+              <div class="console-tail__tag">Console</div>
+              {{#if execution.console.stdoutTruncated}}<div class="console-tail__more">… earlier stdout truncated</div>{{/if}}
+              {{#each execution.console.stdout}}<div class="console-tail__line"><span class="console-tail__stream">out</span>{{this}}</div>{{/each}}
+              {{#if execution.console.stderrTruncated}}<div class="console-tail__more">… earlier stderr truncated</div>{{/if}}
+              {{#each execution.console.stderr}}<div class="console-tail__line console-tail__line--err"><span class="console-tail__stream">err</span>{{this}}</div>{{/each}}
+            </div>
+            {{/if}}
+
+            {{#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}}
+            </div>
+            {{/if}}
+          </div>
+        </td>
+      </tr>
+      {{/if}}
+      </tbody>
       {{/each}}
-    </tbody>
   </table>
 </div>
 {{/if}}

package/dist/templates/partials/failure-card.hbs

@@ -11,6 +11,14 @@
   <div class="failure-item__message">{{failure.error.message}}</div>
 {{/if}}
 
+{{#if (and showFull failure.execution.failingStep)}}
+<div class="failing-step">
+  <span class="failing-step__tag">Failed at</span>
+  <span class="failing-step__title">{{failure.execution.failingStep.title}}</span>
+  {{#if failure.execution.failingStep.location}}<span class="failing-step__loc">{{failure.execution.failingStep.location}}</span>{{/if}}
+</div>
+{{/if}}
+
 {{#if (and showFull failure.screenshotBase64)}}
   <img class="screenshot" src="{{failure.screenshotBase64}}" alt="Screenshot at failure">
 {{/if}}

package/dist/templates/styles/base.css

@@ -404,6 +404,89 @@ code {
 .root-cause-chip--env-config .root-cause-chip__label        { color: oklch(48% 0.14 145); }
 .root-cause-chip--unknown .root-cause-chip__label           { color: var(--text-2); }
 
+/* ── Repro detail for the defect-log section (opt-in `capture`) ──────────────
+   Rendered only when the capture option is enabled and data is present. Quiet,
+   design-system-consistent: a light bordered card (NO side rail, per the
+   side-stripe ban in DESIGN.md), with hairline dividers between sub-blocks —
+   mirroring the reworked .failure-detail and .retry-history patterns. */
+/* Each failure is its own <tbody> so its summary row and detail card stay together
+   across a page break — the detail no longer strands under a repeated header. */
+.defect-row-group { break-inside: avoid; page-break-inside: avoid; }
+.defect-detail-row td { padding: 0; border-top: none; }
+.defect-detail {
+  border: 1px solid var(--border-2);
+  border-radius: 6px;
+  margin: 2px 0 12px;
+  padding: 10px 12px 11px;
+}
+.defect-detail__error {
+  font-family: 'JetBrains Mono', monospace;
+  font-size: 9.5px; color: #8A2E1E; line-height: 1.6; word-break: break-word;
+}
+.failing-step {
+  margin-top: 9px; font-size: 9.5px;
+  font-family: 'Inter', system-ui, sans-serif;
+}
+.failing-step__tag, .repro__tag, .console-tail__tag, .evidence-link__tag {
+  font-size: 8px; font-weight: 700; letter-spacing: 0.8px; text-transform: uppercase;
+  color: var(--text-3);
+}
+.failing-step__title { font-weight: 700; color: var(--text-1); margin-left: 6px; }
+.failing-step__loc {
+  font-family: 'JetBrains Mono', monospace; font-size: 8.5px; color: var(--text-3); margin-left: 6px;
+}
+.repro { margin-top: 11px; padding-top: 10px; border-top: 1px solid var(--border); }
+.repro-steps { list-style: none; margin: 6px 0 0; padding: 0; }
+.repro-step {
+  display: flex; align-items: baseline; flex-wrap: wrap; gap: 8px;
+  /* indent by tree depth (capped) — the value comes from `--d` on the element */
+  padding: 2px 0 2px min(60px, calc(var(--d, 0) * 12px));
+  font-size: 9px; line-height: 1.5;
+  page-break-inside: avoid; break-inside: avoid;
+}
+/* The error sits at the failing step — full width below its row, indented past the
+   category column so it reads as belonging to that step. */
+.repro-step__error {
+  flex-basis: 100%; margin: 3px 0 2px; padding-left: 60px;
+  font-family: 'JetBrains Mono', monospace; font-size: 9px; line-height: 1.55;
+  color: #8A2E1E; white-space: pre-wrap; word-break: break-word;
+}
+.repro-step__cat {
+  flex: none; min-width: 52px;
+  font-family: 'JetBrains Mono', monospace; font-size: 8px; color: var(--text-3);
+}
+.repro-step__title { flex: 1; color: var(--text-2); word-break: break-word; }
+.repro-step__loc {
+  flex: none; font-family: 'JetBrains Mono', monospace; font-size: 8px; color: var(--text-3);
+}
+.repro-step__dur { flex: none; color: var(--text-3); font-size: 8.5px; }
+.repro-step--failed .repro-step__title { color: #8A2E1E; font-weight: 700; }
+.repro-step--failed .repro-step__cat { color: var(--fail); }
+.console-tail { margin-top: 11px; padding-top: 10px; border-top: 1px solid var(--border); }
+.console-tail__line {
+  font-family: 'JetBrains Mono', monospace; font-size: 8.5px; line-height: 1.55;
+  color: var(--text-2); word-break: break-word; white-space: pre-wrap;
+}
+/* Non-colour stream cue (out/err) so the two streams read without relying on colour. */
+.console-tail__stream {
+  display: inline-block; width: 22px; margin-right: 8px; flex: none;
+  font-size: 7.5px; font-weight: 700; letter-spacing: 0.5px; text-transform: uppercase;
+  color: var(--text-3); vertical-align: baseline;
+}
+.console-tail__line--err { color: #8A2E1E; }
+.console-tail__line--err .console-tail__stream { color: var(--fail); }
+/* Truncation note now leads the tail (earlier lines were dropped — they precede what's shown). */
+.console-tail__more { font-size: 8px; color: var(--text-3); margin: 0 0 4px; font-style: italic; }
+.evidence-links {
+  margin-top: 11px; padding-top: 10px; border-top: 1px solid var(--border);
+  display: flex; flex-wrap: wrap; gap: 14px;
+}
+.evidence-link { font-size: 9px; }
+.evidence-link__path {
+  font-family: 'JetBrains Mono', monospace; font-size: 8.5px; color: var(--text-2);
+  margin-left: 5px; word-break: break-all;
+}
+
 /* ── History trend card — shared by detailed + executive (charts.hbs) ─────── */
 .trend-card {
   background: var(--surface);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reportforge/playwright-pdf",
-  "version": "0.7.2",
+  "version": "0.8.1",
   "description": "Enterprise-ready PDF reports for Playwright Test — minimal, detailed, and executive templates with CI/CD integrations",
   "license": "MIT",
   "author": "ReportForge",