@reportforge/playwright-pdf 0.10.3 → 0.11.1

package/README.md

@@ -197,7 +197,7 @@ All options are the second element of the reporter tuple.
 | `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. |
-| `live` | `object` | `{}` (off) | Opt-in live test-execution streaming. When `enabled`, the reporter prints an unguessable watch link to the CI logs at run start and streams per-test progress to the hosted dashboard while tests run — all shards of one CI run converge on a single live view. Fields: `enabled` (default `false`), `runId` (override the auto-derived run id), `serverUrl` (override the streaming server), `steps` (`none`\|`failed`\|`all`, default `failed`), `console` (stream stdout/stderr tails, default `false`), `flushMs` (batch debounce 500–10000, default `2000`). The PDF at the end of the run is unaffected. Requires an active subscription with the `live` entitlement. See the Live Runs docs. |
+| `live` | `object` | `{}` (off) | Opt-in live test-execution streaming. When `enabled`, the reporter prints an unguessable watch link to the CI logs at run start and streams per-test progress to the hosted dashboard while tests run — all shards of one CI run converge on a single live view. Fields: `enabled` (default `false`), `runId` (override the auto-derived run id), `serverUrl` (override the streaming server), `steps` (`none`\|`failed`\|`intent`\|`all`, default `failed`; `intent` shows only your `test.step` names plus any failing step), `console` (stream stdout/stderr tails, default `false`), `flushMs` (batch debounce 500–10000, default `2000`). The PDF at the end of the run is unaffected. Requires an active subscription with the `live` entitlement. See the Live Runs docs. |
 | `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. |
@@ -222,7 +222,7 @@ reporter: [
     outputFile: 'reports/{date}-report.pdf',
     live: {
       enabled: true,
-      steps: 'failed',   // 'none' | 'failed' | 'all'
+      steps: 'failed',   // 'none' | 'failed' | 'intent' | 'all'
       // console: false,  // stream stdout/stderr tails (off by default — see note)
       // flushMs: 2000,   // batch debounce (500–10000)
     },

package/dist/cli/index.js

@@ -11886,7 +11886,7 @@ var init_schema = __esm({
       serverUrl: external_exports.string().url().optional(),
       // Step verbosity: 'none' skips steps, 'failed' streams intent + assertions +
       // errored steps, 'all' streams every step.
-      steps: external_exports.enum(["none", "failed", "all"]).default("failed"),
+      steps: external_exports.enum(["none", "failed", "intent", "all"]).default("failed"),
       // Stream test stdout/stderr tails. Off by default — may leak secrets printed
       // by tests to a token-holder.
       console: external_exports.boolean().default(false),

package/dist/index.d.mts

@@ -258,9 +258,11 @@ interface ReporterOptions {
         serverUrl?: string;
         /**
          * Step verbosity: `'none'` skips steps, `'failed'` streams author intent +
-         * assertions + errored steps, `'all'` streams every step. Default: `'failed'`
+         * assertions + errored steps, `'intent'` streams only your `test.step` names
+         * (plus any failing step) for the cleanest human-readable trail, `'all'`
+         * streams every step and action. Default: `'failed'`
          */
-        steps?: 'none' | 'failed' | 'all';
+        steps?: 'none' | 'failed' | 'intent' | 'all';
         /**
          * Stream test stdout/stderr tails to the watch page. Off by default — may
          * leak secrets printed by tests to anyone holding the watch link. Default: false

package/dist/index.d.ts

@@ -258,9 +258,11 @@ interface ReporterOptions {
         serverUrl?: string;
         /**
          * Step verbosity: `'none'` skips steps, `'failed'` streams author intent +
-         * assertions + errored steps, `'all'` streams every step. Default: `'failed'`
+         * assertions + errored steps, `'intent'` streams only your `test.step` names
+         * (plus any failing step) for the cleanest human-readable trail, `'all'`
+         * streams every step and action. Default: `'failed'`
          */
-        steps?: 'none' | 'failed' | 'all';
+        steps?: 'none' | 'failed' | 'intent' | 'all';
         /**
          * Stream test stdout/stderr tails to the watch page. Off by default — may
          * leak secrets printed by tests to anyone holding the watch link. Default: false

package/dist/index.js

@@ -10492,7 +10492,7 @@ var liveConfigSchema = external_exports.object({
   serverUrl: external_exports.string().url().optional(),
   // Step verbosity: 'none' skips steps, 'failed' streams intent + assertions +
   // errored steps, 'all' streams every step.
-  steps: external_exports.enum(["none", "failed", "all"]).default("failed"),
+  steps: external_exports.enum(["none", "failed", "intent", "all"]).default("failed"),
   // Stream test stdout/stderr tails. Off by default — may leak secrets printed
   // by tests to a token-holder.
   console: external_exports.boolean().default(false),
@@ -13873,6 +13873,7 @@ function shouldEmitStep(step, mode) {
   if (step.error && step.category !== "hook" && step.category !== "fixture") return true;
   if (isLifecycleStep(step)) return false;
   if (mode === "all") return true;
+  if (mode === "intent") return step.category === "test.step";
   return step.category === "test.step" || step.category === "expect";
 }
 function isCurrentStep(step) {
@@ -13886,6 +13887,13 @@ function mapCurrentStep(testId, step, shardKey) {
     currentStep: clampWithEllipsis(step.title ?? "", MAX_STEP_TITLE_CHARS)
   };
 }
+function testStepDepth(step) {
+  let depth = 0;
+  for (let p = step.parent; p; p = p.parent) {
+    if (p.category === "test.step") depth++;
+  }
+  return depth;
+}
 function mapStep(testId, step, phase, shardKey) {
   return {
     kind: "step",
@@ -13893,7 +13901,13 @@ function mapStep(testId, step, phase, shardKey) {
     title: clampWithEllipsis(step.title ?? "", MAX_STEP_TITLE_CHARS),
     status: phase === "begin" ? "running" : step.error ? "failed" : "passed",
     shardKey,
-    at: Date.now()
+    at: Date.now(),
+    // The step's own start time (not receive time) so the watch page can order a
+    // parent `test.step` before the child actions nested inside it.
+    startedAt: step.startTime?.getTime(),
+    // Nesting depth (test.step ancestors) so the page indents children under their
+    // parent step. 0 → flat, so a test without test.steps renders as a flat trail.
+    depth: testStepDepth(step)
   };
 }
 function mapConsole(kind, chunk, testId, shardKey) {
@@ -13920,7 +13934,7 @@ var PdfReporter = class {
     this.liveConsole = false;
     this.options = parseOptions(rawOptions);
     this.dataCollector = new DataCollector(this.options.capture);
-    const version = true ? "0.10.3" : "0.x";
+    const version = true ? "0.11.1" : "0.x";
     logger.info(`@reportforge/playwright-pdf v${version} initialised`);
     this.licenseClient = new LicenseClient({
       licenseKey: this.options.licenseKey,

package/dist/index.mjs

@@ -10493,7 +10493,7 @@ var liveConfigSchema = external_exports.object({
   serverUrl: external_exports.string().url().optional(),
   // Step verbosity: 'none' skips steps, 'failed' streams intent + assertions +
   // errored steps, 'all' streams every step.
-  steps: external_exports.enum(["none", "failed", "all"]).default("failed"),
+  steps: external_exports.enum(["none", "failed", "intent", "all"]).default("failed"),
   // Stream test stdout/stderr tails. Off by default — may leak secrets printed
   // by tests to a token-holder.
   console: external_exports.boolean().default(false),
@@ -13874,6 +13874,7 @@ function shouldEmitStep(step, mode) {
   if (step.error && step.category !== "hook" && step.category !== "fixture") return true;
   if (isLifecycleStep(step)) return false;
   if (mode === "all") return true;
+  if (mode === "intent") return step.category === "test.step";
   return step.category === "test.step" || step.category === "expect";
 }
 function isCurrentStep(step) {
@@ -13887,6 +13888,13 @@ function mapCurrentStep(testId, step, shardKey) {
     currentStep: clampWithEllipsis(step.title ?? "", MAX_STEP_TITLE_CHARS)
   };
 }
+function testStepDepth(step) {
+  let depth = 0;
+  for (let p = step.parent; p; p = p.parent) {
+    if (p.category === "test.step") depth++;
+  }
+  return depth;
+}
 function mapStep(testId, step, phase, shardKey) {
   return {
     kind: "step",
@@ -13894,7 +13902,13 @@ function mapStep(testId, step, phase, shardKey) {
     title: clampWithEllipsis(step.title ?? "", MAX_STEP_TITLE_CHARS),
     status: phase === "begin" ? "running" : step.error ? "failed" : "passed",
     shardKey,
-    at: Date.now()
+    at: Date.now(),
+    // The step's own start time (not receive time) so the watch page can order a
+    // parent `test.step` before the child actions nested inside it.
+    startedAt: step.startTime?.getTime(),
+    // Nesting depth (test.step ancestors) so the page indents children under their
+    // parent step. 0 → flat, so a test without test.steps renders as a flat trail.
+    depth: testStepDepth(step)
   };
 }
 function mapConsole(kind, chunk, testId, shardKey) {
@@ -13921,7 +13935,7 @@ var PdfReporter = class {
     this.liveConsole = false;
     this.options = parseOptions(rawOptions);
     this.dataCollector = new DataCollector(this.options.capture);
-    const version = true ? "0.10.3" : "0.x";
+    const version = true ? "0.11.1" : "0.x";
     logger.info(`@reportforge/playwright-pdf v${version} initialised`);
     this.licenseClient = new LicenseClient({
       licenseKey: this.options.licenseKey,

package/package.json

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