@decocms/parity 0.11.13 → 0.11.14

package/CHANGELOG.md

@@ -5,6 +5,23 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/).
 
+## [0.11.14](https://github.com/decocms/parity/compare/v0.11.13...v0.11.14) (2026-06-17)
+
+### Added
+
+* **Always-visible elapsed counter.** A 1-second ticker rewrites the spinner with `⏱ 04:32 · <current label>` from the moment "Launching browser…" appears until the report writes. No more "is it stuck?" minutes of silence — the user knows exactly how long the run has been going at any moment. Cleared in `finally` so it can't survive past `runCommand`.
+* **Per-flow timing in the bottom summary.** New `flows breakdown` block lists each flow's `max` time (the parallel-wall-clock contribution) plus per-side detail:
+  ```
+  flows breakdown (sides run in parallel within viewport)
+    purchase-journey  max 1m32s · mobile/prod 52s · mobile/cand 58s · desk/prod 89s · desk/cand 90s
+    search            max 1m48s · …
+  ```
+  Driven by the existing `FlowCapture.totalDurationMs` (already populated by `finalize` — just wasn't surfaced).
+
+### Changed
+
+* **Prod + cand now run in parallel within each viewport.** `parity run`'s collect loop was 100% sequential: `for viewport { for side { for flow {…} } }`. The two sides for a given viewport are already independent (separate BrowserContexts, separate HAR/trace paths), so the same `Promise.all([prod, cand])` pattern that `parity journey` has used for months now applies to `parity run` too. Extracted a `runOneSide(viewport, side)` helper, replaced the inner side loop with `Promise.all`, and deferred `promoteStepsFromFlow` (which mutates the shared `learned` object) until after `Promise.all` resolves so there's no race on selector promotion. **Expected speedup: ~50% on collect phase** (25m → ~17m total on bagaggio). Viewports still serialize for now — PR #2 will parallelize those too.
+
 ## [0.11.13](https://github.com/decocms/parity/compare/v0.11.12...v0.11.13) (2026-06-17)
 
 ### Fixed

package/dist/cli.js

@@ -54522,7 +54522,7 @@ class TimingRegistry {
     };
   }
 }
-function formatTimingsSummary(timings) {
+function formatTimingsSummary(timings, flowBreakdown) {
   if (timings.phases.length === 0) {
     return `⏱  Run completed in ${formatMs(timings.totalMs)}`;
   }
@@ -54535,9 +54535,41 @@ function formatTimingsSummary(timings) {
     const pctOfTotal = timings.totalMs > 0 ? Math.round(p.durationMs / timings.totalMs * 100) : 0;
     lines.push(`    ${p.phase.padEnd(maxLabel)}  ${formatMs(p.durationMs).padStart(7)}  ${bar} ${pctOfTotal}%`);
   }
+  if (flowBreakdown && flowBreakdown.length > 0) {
+    const maxFlowLabel = Math.max(...flowBreakdown.map((f) => f.flow.length));
+    lines.push("");
+    lines.push("    flows breakdown (sides run in parallel within viewport)");
+    for (const f of flowBreakdown) {
+      const sideDetail = f.sides.map((s) => `${s.viewport}/${s.side} ${formatMs(s.durationMs)}`).join(" · ");
+      lines.push(`    ${f.flow.padEnd(maxFlowLabel)}  max ${formatMs(f.maxMs).padStart(6)} · ${sideDetail}`);
+    }
+  }
   return lines.join(`
 `);
 }
+function buildFlowBreakdown(captures) {
+  const byFlow = new Map;
+  for (const c of captures) {
+    const existing = byFlow.get(c.flow);
+    const entry = {
+      viewport: c.viewport,
+      side: c.side,
+      durationMs: c.totalDurationMs
+    };
+    if (!existing) {
+      byFlow.set(c.flow, {
+        flow: c.flow,
+        maxMs: c.totalDurationMs,
+        sides: [entry]
+      });
+    } else {
+      existing.sides.push(entry);
+      if (c.totalDurationMs > existing.maxMs)
+        existing.maxMs = c.totalDurationMs;
+    }
+  }
+  return Array.from(byFlow.values());
+}
 function formatMs(ms) {
   const totalSec = Math.floor(ms / 1000);
   if (totalSec < 60)
@@ -55069,6 +55101,21 @@ async function runCommand(rawOpts) {
   let browser = null;
   const allFlowCaptures = [];
   const allPageCaptures = [];
+  let currentSpinnerLabel = "Launching browser…";
+  const renderSpinner = () => {
+    const elapsedSec = Math.floor((Date.now() - startedAt) / 1000);
+    const min = Math.floor(elapsedSec / 60);
+    const sec = elapsedSec % 60;
+    const mmss = `${min.toString().padStart(2, "0")}:${sec.toString().padStart(2, "0")}`;
+    spinner.text = `${chalk16.dim(`⏱ ${mmss} ·`)} ${currentSpinnerLabel}`;
+  };
+  const setSpinnerLabel = (label) => {
+    currentSpinnerLabel = label;
+    renderSpinner();
+  };
+  setSpinnerLabel("Launching browser…");
+  const elapsedTicker = setInterval(renderSpinner, 1000);
+  elapsedTicker.unref?.();
   const timings = new TimingRegistry;
   let phaseStart = performance.now();
   const stampPhase = (label) => {
@@ -55113,7 +55160,7 @@ async function runCommand(rawOpts) {
       process.stderr.write(`  report parcial em ${paths.reportHtml}
 `);
       process.stderr.write(`
-${formatTimingsSummary(partialTimings)}
+${formatTimingsSummary(partialTimings, buildFlowBreakdown(allFlowCaptures))}
 `);
     } catch (err) {
       process.stderr.write(`  falha escrevendo report parcial: ${err.message}
@@ -55155,26 +55202,27 @@ ${formatTimingsSummary(partialTimings)}
         warmupSpinner.fail(`Warmup falhou — 0/${result.attempted} requests ok. Cache pode estar stale. Primeira falha: ${firstReason}`);
       }
     }
-    for (const viewport of viewports) {
-      for (const side of ["prod", "cand"]) {
-        const baseUrl = side === "prod" ? opts.prod : opts.cand;
-        spinner.text = `[${viewport}/${side}] preparing context…`;
-        const harPath = join16(paths.harDir, `${viewport}-${side}.har`);
-        const tracePath = join16(paths.tracesDir, `${viewport}-${side}.zip`);
-        const ctx = await newContext(browser, {
-          viewport,
-          harPath,
-          tracesDir: paths.tracesDir,
-          cohortCookieValue: "control",
-          noCache: opts.bypassCache
-        });
-        await installVitalsCollector(ctx);
+    const runOneSide = async (viewport, side) => {
+      const baseUrl = side === "prod" ? opts.prod : opts.cand;
+      const harPath = join16(paths.harDir, `${viewport}-${side}.har`);
+      const tracePath = join16(paths.tracesDir, `${viewport}-${side}.zip`);
+      const ctx = await newContext(browser, {
+        viewport,
+        harPath,
+        tracesDir: paths.tracesDir,
+        cohortCookieValue: "control",
+        noCache: opts.bypassCache
+      });
+      await installVitalsCollector(ctx);
+      const captures = [];
+      const pages = [];
+      try {
         for (const flow of flows) {
           const flowStart = Date.now();
           let lastStepTotal = 0;
           const sideTag = side === "prod" ? chalk16.cyan("prod") : chalk16.magenta("cand");
           const prefix = `${chalk16.dim(`[${viewport}/`)}${sideTag}${chalk16.dim("]")}`;
-          spinner.text = `${prefix} ${flow}: starting…`;
+          setSpinnerLabel(`${prefix} ${flow}: starting…`);
           const cap = await runFlow(flow, {
             baseUrl,
             side,
@@ -55190,7 +55238,7 @@ ${formatTimingsSummary(partialTimings)}
             onStep: (event) => {
               if (event.phase === "start") {
                 lastStepTotal = event.total;
-                spinner.text = `${prefix} ${flow} ${chalk16.dim(`${event.index}/${event.total}`)} ${event.name}…`;
+                setSpinnerLabel(`${prefix} ${flow} ${chalk16.dim(`${event.index}/${event.total}`)} ${event.name}…`);
               }
             }
           });
@@ -55199,7 +55247,7 @@ ${formatTimingsSummary(partialTimings)}
           const target = lastStepTotal || recorded;
           const failed = cap.steps?.find((s) => s.status === "failed");
           const lastStep = cap.steps?.[cap.steps.length - 1];
-          const elapsed = chalk16.dim(`${((Date.now() - flowStart) / 1000).toFixed(1)}s`);
+          const elapsedDim = chalk16.dim(`${((Date.now() - flowStart) / 1000).toFixed(1)}s`);
           const counts = target > 0 ? chalk16.dim(`${okSteps}/${target}`) : "";
           let glyph;
           let detail;
@@ -55213,22 +55261,38 @@ ${formatTimingsSummary(partialTimings)}
             glyph = chalk16.green("✓");
             detail = "";
           }
-          const summary = `${glyph} ${prefix} ${flow} ${counts} ${detail} ${elapsed}`.replace(/\s+/g, " ").trim();
+          const summary = `${glyph} ${prefix} ${flow} ${counts} ${detail} ${elapsedDim}`.replace(/\s+/g, " ").trim();
           spinner.stopAndPersist({ symbol: "", text: summary });
-          spinner.start(`${prefix} ${flow} done — next…`);
-          allFlowCaptures.push(cap);
+          setSpinnerLabel(`${prefix} ${flow} done — next…`);
+          spinner.start();
+          captures.push(cap);
           for (const p of cap.pages)
-            allPageCaptures.push(p);
+            pages.push(p);
+        }
+      } finally {
+        await stopTracing(ctx, tracePath).catch(() => {
+          return;
+        });
+        await ctx.close();
+      }
+      return { captures, pages };
+    };
+    for (const viewport of viewports) {
+      const [prodResult, candResult] = await Promise.all([
+        runOneSide(viewport, "prod"),
+        runOneSide(viewport, "cand")
+      ]);
+      for (const r of [prodResult, candResult]) {
+        for (const cap of r.captures) {
+          allFlowCaptures.push(cap);
           if (opts.learn !== false) {
             const result = promoteStepsFromFlow(learned, platform, prodHost, cap);
             promotedCount += result.promoted;
             deprecatedCount += result.deprecated;
           }
         }
-        await stopTracing(ctx, tracePath).catch(() => {
-          return;
-        });
-        await ctx.close();
+        for (const p of r.pages)
+          allPageCaptures.push(p);
       }
     }
     stampPhase("collect");
@@ -55449,7 +55513,8 @@ ${formatTimingsSummary(partialTimings)}
       }
     }
     currentPhase = "checks";
-    spinner.start("Rodando checks…");
+    setSpinnerLabel("Rodando checks…");
+    spinner.start();
     const checksHb = attachSpinnerHeartbeat(spinner, { baseText: "Rodando checks…" });
     const cacheDir = join16(opts.output, "cache");
     const checkCtx = {
@@ -55474,7 +55539,8 @@ ${formatTimingsSummary(partialTimings)}
     }
     const allIssues = checks.flatMap((c) => c.issues);
     currentPhase = "llm-aggregate";
-    spinner.start(isLlmAvailable() ? `Agregando issues via LLM (${providerLabel()}, timeout=${llmTimeoutSec}s)…` : "Agregando issues (modo offline — sem LLM keys)…");
+    setSpinnerLabel(isLlmAvailable() ? `Agregando issues via LLM (${providerLabel()}, timeout=${llmTimeoutSec}s)…` : "Agregando issues (modo offline — sem LLM keys)…");
+    spinner.start();
     const llmHb = attachSpinnerHeartbeat(spinner, {
       baseText: isLlmAvailable() ? "Agregando issues via LLM (Sonnet 4.6)…" : "Agregando issues (modo offline)…"
     });
@@ -55556,7 +55622,7 @@ ${formatTimingsSummary(partialTimings)}
     });
     printSummary5(run, paths.reportHtml, { promotedCount, deprecatedCount, platform });
     console.log(`
-${formatTimingsSummary(runTimings)}`);
+${formatTimingsSummary(runTimings, buildFlowBreakdown(allFlowCaptures))}`);
     if (opts.ci) {
       const blocking = allIssues.filter((i) => failOn.includes(i.severity));
       if (blocking.length > 0) {
@@ -55586,6 +55652,7 @@ ${formatTimingsSummary(runTimings)}`);
     });
     return 2;
   } finally {
+    clearInterval(elapsedTicker);
     clearTimeout(globalTimeoutTimer);
     process.removeListener("SIGINT", onSignal);
     process.removeListener("SIGTERM", onSignal);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decocms/parity",
-  "version": "0.11.13",
+  "version": "0.11.14",
   "description": "E2E parity validator for site migrations. Compares prod vs cand and reports UI, functional, SEO, visual, and Web Vitals deltas with an LLM-ranked HTML report.",
   "type": "module",
   "license": "MIT",