@decocms/parity 0.5.4 → 0.6.0

package/dist/cli.js

@@ -91,7 +91,15 @@ var StepCapture = z.object({
     observedTitles: z.array(z.string()).optional(),
     reason: z.string().optional()
   }).optional(),
-  cartOpenMethod: z.enum(["click", "click-navigate", "hover", "already-open", "failed"]).optional()
+  cartOpenMethod: z.enum(["click", "click-navigate", "hover", "already-open", "failed"]).optional(),
+  cartRevealMode: z.enum([
+    "hover-drawer",
+    "click-drawer",
+    "click-navigate-checkout",
+    "click-navigate-cart",
+    "inline-notification",
+    "unknown"
+  ]).optional()
 });
 var FlowCapture = z.object({
   flow: FlowName,
@@ -864,6 +872,138 @@ function diffSitemap(prodUrls, candUrls) {
 
 // src/engine/browser.ts
 import { chromium, devices } from "playwright";
+
+// src/engine/carousel-stabilizer.ts
+var CAROUSEL_STABILIZER_INIT_SCRIPT = `
+(function () {
+  if (window.__parityCarouselInstalled) return;
+  window.__parityCarouselInstalled = true;
+  window.__parityCarouselStop = false;
+
+  /**
+   * Walks the page for known carousel libraries and pins them to slide 0.
+   * Idempotent — safe to call multiple times. Returns a counters object
+   * so the harness can log how many were stabilized.
+   */
+  window.__parityStabilizeCarousels = function () {
+    var counts = { swiper: 0, splide: 0, slick: 0, keenSlider: 0, generic: 0 };
+
+    // 1. Swiper — most common in Deco sites. Two ways to find instances:
+    //    - element.swiper (newer versions)
+    //    - window.Swiper.instances (older)
+    try {
+      var swiperEls = document.querySelectorAll('.swiper, .swiper-container');
+      swiperEls.forEach(function (el) {
+        var inst = el.swiper;
+        if (inst && typeof inst.slideTo === 'function') {
+          try { inst.autoplay && inst.autoplay.stop && inst.autoplay.stop(); } catch (_) {}
+          try { inst.slideTo(0, 0, false); counts.swiper++; } catch (_) {}
+        }
+      });
+    } catch (_) {}
+
+    // 2. Splide
+    try {
+      var splideEls = document.querySelectorAll('.splide');
+      splideEls.forEach(function (el) {
+        var inst = el.splide || (el.__splide);
+        if (inst && typeof inst.go === 'function') {
+          try { inst.go(0); counts.splide++; } catch (_) {}
+        }
+      });
+    } catch (_) {}
+
+    // 3. Slick
+    try {
+      if (window.jQuery) {
+        var $slick = window.jQuery('.slick-slider, .slick-initialized');
+        if ($slick.length) {
+          try { $slick.slick('slickGoTo', 0, true); counts.slick += $slick.length; } catch (_) {}
+        }
+      }
+    } catch (_) {}
+
+    // 4. KeenSlider
+    try {
+      var keenEls = document.querySelectorAll('.keen-slider');
+      keenEls.forEach(function (el) {
+        var inst = el.__keenSlider || el.keenSlider;
+        if (inst && typeof inst.moveToIdx === 'function') {
+          try { inst.moveToIdx(0, true, { duration: 0 }); counts.keenSlider++; } catch (_) {}
+        }
+      });
+    } catch (_) {}
+
+    // 5. Generic fallback — any element inside a [data-section] matching
+    //    carousel|slider|banner|hero, reset scrollLeft to 0 on any
+    //    scrolled descendant. Catches CSS-only scroll-snap carousels
+    //    and custom Deco implementations.
+    //
+    //    Cubic flagged that the previous version did
+    //    querySelectorAll('*') + getComputedStyle per node — O(N) layout
+    //    flushes on every screenshot. Now we only touch elements with
+    //    non-zero scrollLeft (a DOM-level read, no layout flush) which
+    //    are the only ones we'd mutate anyway. Skips the entire
+    //    getComputedStyle scan.
+    try {
+      var BANNER_RE = /(carousel|slider|banner|hero)/i;
+      var sections = document.querySelectorAll('[data-section]');
+      for (var s = 0; s < sections.length; s++) {
+        var sec = sections[s];
+        var name = sec.getAttribute('data-section') || '';
+        if (!BANNER_RE.test(name)) continue;
+        try { if (sec.scrollLeft > 0) { sec.scrollLeft = 0; counts.generic++; } } catch (_) {}
+        var scrollers = sec.querySelectorAll('*');
+        for (var i = 0; i < scrollers.length; i++) {
+          var el = scrollers[i];
+          if (el && el.scrollLeft > 0) {
+            try { el.scrollLeft = 0; counts.generic++; } catch (_) {}
+          }
+        }
+      }
+    } catch (_) {}
+
+    // 6. Set the freeze flag so future auto-advance ticks bail out (libs
+    //    that check this flag before mutating slide index).
+    window.__parityCarouselStop = true;
+    return counts;
+  };
+})();
+`.trim();
+async function stabilizeCarousels(page) {
+  const empty = {
+    swiper: 0,
+    splide: 0,
+    slick: 0,
+    keenSlider: 0,
+    generic: 0,
+    total: 0
+  };
+  try {
+    const counts = await page.evaluate(() => {
+      const fn = window.__parityStabilizeCarousels;
+      return fn ? fn() : null;
+    });
+    if (!counts)
+      return empty;
+    const total = (counts.swiper ?? 0) + (counts.splide ?? 0) + (counts.slick ?? 0) + (counts.keenSlider ?? 0) + (counts.generic ?? 0);
+    if (total > 0) {
+      await page.waitForTimeout(150);
+    }
+    return {
+      swiper: counts.swiper ?? 0,
+      splide: counts.splide ?? 0,
+      slick: counts.slick ?? 0,
+      keenSlider: counts.keenSlider ?? 0,
+      generic: counts.generic ?? 0,
+      total
+    };
+  } catch {
+    return empty;
+  }
+}
+
+// src/engine/browser.ts
 var DISABLE_ANIMATIONS_CSS = `
   *, *::before, *::after {
     animation-duration: 0s !important;
@@ -873,17 +1013,33 @@ var DISABLE_ANIMATIONS_CSS = `
     scroll-behavior: auto !important;
   }
 `;
+var USER_AGENT_BY_VIEWPORT = {
+  mobile: "Mozilla/5.0 (Linux; Android 14; Pixel 7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/130.0.0.0 Mobile Safari/537.36",
+  tablet: "Mozilla/5.0 (iPad; CPU OS 16_6 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6 Mobile/15E148 Safari/604.1",
+  desktop: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/130.0.0.0 Safari/537.36"
+};
+function userAgentFor(viewport) {
+  return USER_AGENT_BY_VIEWPORT[viewport];
+}
 var VIEWPORT_PRESETS = {
   mobile: {
-    ...devices["Pixel 7"]
+    ...devices["Pixel 7"],
+    userAgent: USER_AGENT_BY_VIEWPORT.mobile,
+    isMobile: true,
+    hasTouch: true
   },
   tablet: {
-    ...devices["iPad Mini"]
+    ...devices["iPad Mini"],
+    userAgent: USER_AGENT_BY_VIEWPORT.tablet,
+    isMobile: true,
+    hasTouch: true
   },
   desktop: {
     viewport: { width: 1440, height: 900 },
     deviceScaleFactor: 1,
-    userAgent: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/130.0.0.0 Safari/537.36"
+    userAgent: USER_AGENT_BY_VIEWPORT.desktop,
+    isMobile: false,
+    hasTouch: false
   }
 };
 async function launchBrowser(opts = {}) {
@@ -899,7 +1055,8 @@ async function newContext(browser, opts) {
     ...baseContext,
     recordHar: opts.harPath ? { path: opts.harPath, mode: "minimal" } : undefined,
     bypassCSP: true,
-    ignoreHTTPSErrors: true
+    ignoreHTTPSErrors: true,
+    extraHTTPHeaders: opts.noCache ? { "Cache-Control": "no-cache", Pragma: "no-cache" } : undefined
   });
   await ctx.addInitScript({
     content: `
@@ -910,6 +1067,7 @@ async function newContext(browser, opts) {
       } catch (e) {}
     `
   });
+  await ctx.addInitScript({ content: CAROUSEL_STABILIZER_INIT_SCRIPT });
   if (opts.cohortCookieValue) {
     await ctx.addCookies([
       {
@@ -1199,6 +1357,12 @@ async function capturePage(page, opts) {
       new Promise((resolve) => setTimeout(() => resolve(null), Math.min(5000, remaining())))
     ]) ?? null;
     if (!opts.skipScreenshot) {
+      await Promise.race([
+        stabilizeCarousels(page).catch(() => {
+          return;
+        }),
+        new Promise((resolve) => setTimeout(resolve, Math.min(3000, remaining())))
+      ]);
       dlog(opts.side, opts.viewport, `    capturePage: screenshot start (cap=${Math.min(15000, remaining())}ms)`);
       await Promise.race([
         page.screenshot({ path: opts.screenshotPath, fullPage: true, animations: "disabled" }).catch(() => {
@@ -5277,6 +5441,17 @@ function isResolutionContext(v) {
 }
 
 // src/engine/flows.ts
+async function screenshotStable(page, opts) {
+  await Promise.race([
+    stabilizeCarousels(page).catch(() => {
+      return;
+    }),
+    new Promise((resolve) => setTimeout(resolve, 3000))
+  ]);
+  await page.screenshot({ path: opts.path, fullPage: opts.fullPage ?? false }).catch(() => {
+    return;
+  });
+}
 var PURCHASE_JOURNEY_TOTAL_STEPS = 9;
 var DEBUG_PARITY2 = process.env.DEBUG_PARITY === "1" || process.env.DEBUG_PARITY === "true";
 var DEBUG_START2 = Date.now();
@@ -5616,9 +5791,7 @@ async function flowPurchaseJourney(ctx) {
     const t4 = Date.now();
     const beforeUrl4 = page.url();
     const spBefore4 = screenshotPath(ctx, "pj-4-select-variant-before");
-    await page.screenshot({ path: spBefore4, fullPage: false }).catch(() => {
-      return;
-    });
+    await screenshotStable(page, { path: spBefore4, fullPage: false });
     const variantResult = await selectVariant(page, ctx);
     let variantLlmAction = null;
     if (variantResult.actions.length === 0 && variantResult.variantRequired && budget.remaining > 0) {
@@ -5633,9 +5806,7 @@ async function flowPurchaseJourney(ctx) {
       });
     }
     const sp4 = screenshotPath(ctx, "pj-4-select-variant");
-    await page.screenshot({ path: sp4, fullPage: false }).catch(() => {
-      return;
-    });
+    await screenshotStable(page, { path: sp4, fullPage: false });
     if (variantResult.actions.length > 0 || variantLlmAction?.performed) {
       const llmDesc = variantLlmAction?.performed ? `Recovery LLM: ${variantLlmAction.action} em \`${variantLlmAction.selector}\`` : null;
       const desc = variantResult.actions.length > 0 ? variantResult.actions.join("; ") : llmDesc ?? "(variante selecionada)";
@@ -5688,14 +5859,10 @@ async function flowPurchaseJourney(ctx) {
       const t5 = Date.now();
       const beforeUrl5 = page.url();
       const spBefore5 = screenshotPath(ctx, "pj-5-shipping-pdp-before");
-      await page.screenshot({ path: spBefore5, fullPage: false }).catch(() => {
-        return;
-      });
+      await screenshotStable(page, { path: spBefore5, fullPage: false });
       const ok = await fillCep(page, cepInputPdp, ctx.rc.cep);
       const sp = screenshotPath(ctx, "pj-5-shipping-pdp");
-      await page.screenshot({ path: sp, fullPage: false }).catch(() => {
-        return;
-      });
+      await screenshotStable(page, { path: sp, fullPage: false });
       const step5Status = ok ? "ok" : "failed";
       steps.push({
         step: 5,
@@ -5738,9 +5905,7 @@ async function flowPurchaseJourney(ctx) {
     const t6 = Date.now();
     const beforeUrl6 = page.url();
     const spBefore6 = screenshotPath(ctx, "pj-6-add-cart-before");
-    await page.screenshot({ path: spBefore6, fullPage: false }).catch(() => {
-      return;
-    });
+    await screenshotStable(page, { path: spBefore6, fullPage: false });
     const cartCountBefore = await readCartCount(page, ctx);
     const buyText = await buyHit.locator.innerText().catch(() => "");
     await buyHit.locator.click({ timeout: 5000 }).catch(() => {
@@ -5775,9 +5940,7 @@ async function flowPurchaseJourney(ctx) {
       }
     }
     const sp6 = screenshotPath(ctx, "pj-6-add-cart");
-    await page.screenshot({ path: sp6, fullPage: false }).catch(() => {
-      return;
-    });
+    await screenshotStable(page, { path: sp6, fullPage: false });
     const buyActionDesc = `Clicou no botão${buyText ? ` '${buyText.slice(0, 40).trim()}'` : ""} (\`${buyHit.selector}\`)${buyRecovered ? " — selector veio de recovery LLM" : ""}`;
     const fullActionDesc = variantRetryNote ? `${buyActionDesc} — ${variantRetryNote} — ${validation.note}` : `${buyActionDesc} — ${validation.note}`;
     steps.push({
@@ -5806,9 +5969,7 @@ async function flowPurchaseJourney(ctx) {
     const t7 = Date.now();
     const beforeUrl7 = page.url();
     const spBefore7 = screenshotPath(ctx, "pj-7-minicart-before");
-    await page.screenshot({ path: spBefore7, fullPage: false }).catch(() => {
-      return;
-    });
+    await screenshotStable(page, { path: spBefore7, fullPage: false });
     let miniHit = await firstVisibleLocator(page, selFor(ctx, "minicartTrigger"));
     let miniRecovered = false;
     if (!miniHit && budget.remaining > 0) {
@@ -5821,15 +5982,19 @@ async function flowPurchaseJourney(ctx) {
     }
     let cartOpenMethod = "failed";
     let miniText = "";
+    let cartRevealMode = "unknown";
+    const drawerAlreadyOpen = await isCartRevealed(page, expectedProductTitle) !== null;
     if (miniHit) {
       miniText = await miniHit.locator.innerText().catch(() => "");
+      cartRevealMode = await detectCartRevealMode(page, miniHit.locator, drawerAlreadyOpen, ctx.viewport).catch(() => "unknown");
+      dlog2(ctx, `step 7 open-minicart: cartRevealMode=${cartRevealMode}`);
       const openResult = await openMinicart(page, miniHit, ctx, expectedProductTitle);
       cartOpenMethod = openResult.method;
     } else {
-      const alreadyOpen = await isCartRevealed(page, expectedProductTitle);
-      if (alreadyOpen) {
+      if (drawerAlreadyOpen) {
         cartOpenMethod = "already-open";
-        dlog2(ctx, `step 7 open-minicart: no trigger, drawer already visible (${alreadyOpen})`);
+        cartRevealMode = "inline-notification";
+        dlog2(ctx, "step 7 open-minicart: no trigger, drawer already visible");
       }
     }
     let step7Validation;
@@ -5854,10 +6019,11 @@ async function flowPurchaseJourney(ctx) {
       dlog2(ctx, `step 7 open-minicart: validation → found=${v.found} (${v.method})${reasonText ? ` — ${reasonText.slice(0, 80)}` : ""}`);
     }
     const sp7 = screenshotPath(ctx, "pj-7-minicart");
-    await page.screenshot({ path: sp7, fullPage: false }).catch(() => {
-      return;
-    });
-    const step7Status = cartOpenMethod === "failed" ? "failed" : step7Validation && !step7Validation.found ? "failed" : "ok";
+    await screenshotStable(page, { path: sp7, fullPage: false });
+    const cartEmptyReason = step7Validation?.reason ?? "";
+    const isProdCartEmptyQuirk = ctx.acceptProdQuirks === true && ctx.side === "prod" && step7Validation !== undefined && !step7Validation.found && cartEmptyReason.startsWith("cart genuinely empty");
+    const step7Status = isProdCartEmptyQuirk ? "skipped" : cartOpenMethod === "failed" ? "failed" : step7Validation && !step7Validation.found ? "failed" : "ok";
+    const step7QuirkNote = isProdCartEmptyQuirk ? "cart-empty-prod-quirk: aceito via --accept-prod-quirks (cartRevealMode validated by separate check)" : undefined;
     steps.push({
       step: 7,
       name: "open-minicart",
@@ -5870,13 +6036,25 @@ async function flowPurchaseJourney(ctx) {
       screenshotBeforePath: spBefore7,
       beforeUrl: beforeUrl7,
       cartOpenMethod,
+      cartRevealMode,
       cartValidation: step7Validation,
+      note: step7QuirkNote,
       actionDescription: miniHit ? `Abriu minicart via ${cartOpenMethod}${miniText ? ` em '${miniText.slice(0, 30).trim()}'` : ""} (\`${miniHit.selector}\`)${miniRecovered ? " — selector via recovery LLM" : ""}${step7Validation ? step7Validation.found ? " ✓ produto encontrado no cart" : ` ✗ produto ESPERADO não encontrado (${step7Validation.observedTitles?.length ?? 0} itens observados)` : ""}` : cartOpenMethod === "already-open" ? "Minicart já estava aberto após add-to-cart" : "Minicart não pôde ser aberto",
       selectorKey: miniHit ? "minicartTrigger" : undefined,
       usedSelector: miniHit?.selector,
       recoveredByLlm: miniRecovered || undefined
     });
-    reportEnd(7, "open-minicart", step7Status, Date.now() - t7);
+    reportEnd(7, "open-minicart", step7Status, Date.now() - t7, step7QuirkNote);
+    if (isProdCartEmptyQuirk) {
+      const quirkNote = "cart-empty-prod-quirk: skipped (depende do cart que prod não persistiu)";
+      reportStart(8, "shipping-calc-cart");
+      steps.push(makeSkipStep(8, "shipping-calc-cart", ctx, quirkNote));
+      reportEnd(8, "shipping-calc-cart", "skipped", 0, quirkNote);
+      reportStart(9, "go-checkout");
+      steps.push(makeSkipStep(9, "go-checkout", ctx, quirkNote));
+      reportEnd(9, "go-checkout", "skipped", 0, quirkNote);
+      return { pages, steps };
+    }
     reportStart(8, "shipping-calc-cart");
     let cepInputCart = await firstVisible(page, selFor(ctx, "cepInputCart"));
     let cepCartRecoveredByLlm = false;
@@ -5903,14 +6081,10 @@ async function flowPurchaseJourney(ctx) {
       const t8 = Date.now();
       const beforeUrl8 = page.url();
       const spBefore8 = screenshotPath(ctx, "pj-8-shipping-cart-before");
-      await page.screenshot({ path: spBefore8, fullPage: false }).catch(() => {
-        return;
-      });
+      await screenshotStable(page, { path: spBefore8, fullPage: false });
       const ok = await fillCep(page, cepInputCart, ctx.rc.cep);
       const sp8 = screenshotPath(ctx, "pj-8-shipping-cart");
-      await page.screenshot({ path: sp8, fullPage: false }).catch(() => {
-        return;
-      });
+      await screenshotStable(page, { path: sp8, fullPage: false });
       const step8Status = ok ? "ok" : "failed";
       steps.push({
         step: 8,
@@ -5951,9 +6125,7 @@ async function flowPurchaseJourney(ctx) {
         };
       }
       const sp9early = screenshotPath(ctx, "pj-9-checkout-reached");
-      await page.screenshot({ path: sp9early, fullPage: false }).catch(() => {
-        return;
-      });
+      await screenshotStable(page, { path: sp9early, fullPage: false });
       const earlyStatus = step9EarlyValidation && !step9EarlyValidation.found ? "failed" : "ok";
       steps.push({
         step: 9,
@@ -5987,9 +6159,7 @@ async function flowPurchaseJourney(ctx) {
       return { pages, steps };
     }
     const spBefore9 = screenshotPath(ctx, "pj-9-checkout-before");
-    await page.screenshot({ path: spBefore9, fullPage: false }).catch(() => {
-      return;
-    });
+    await screenshotStable(page, { path: spBefore9, fullPage: false });
     let usedSelector = checkoutHit.selector;
     let clickedText = await checkoutHit.locator.innerText().catch(() => "");
     let reachedCheckout = false;
@@ -6036,9 +6206,7 @@ async function flowPurchaseJourney(ctx) {
       };
     }
     const sp9 = screenshotPath(ctx, "pj-9-checkout-reached");
-    await page.screenshot({ path: sp9, fullPage: false }).catch(() => {
-      return;
-    });
+    await screenshotStable(page, { path: sp9, fullPage: false });
     const step9Status = !reachedCheckout ? "failed" : step9Validation && !step9Validation.found ? "failed" : "ok";
     steps.push({
       step: 9,
@@ -6610,6 +6778,80 @@ async function isCartUiVisible(page) {
     "[class*='drawer-cart']:visible"
   ]);
 }
+async function detectCartRevealMode(page, trigger, drawerAlreadyOpen, viewport) {
+  if (drawerAlreadyOpen)
+    return "inline-notification";
+  try {
+    const href = await trigger.getAttribute("href").catch(() => null) ?? "";
+    const lower = href.toLowerCase();
+    if (/\/checkout(\b|\/|\?|#)/i.test(lower))
+      return "click-navigate-checkout";
+    if (/\/cart(\b|\/|\?|#)/i.test(lower) || /\/carrinho(\b|\/|\?|#)/i.test(lower)) {
+      return "click-navigate-cart";
+    }
+  } catch {}
+  let hasClickAttr = false;
+  try {
+    const onclick = await trigger.getAttribute("onclick").catch(() => null);
+    if (onclick && onclick.trim().length > 0)
+      hasClickAttr = true;
+  } catch {}
+  if (viewport === "desktop") {
+    try {
+      const observedHoverDrawer = await page.evaluate(async () => {
+        return await new Promise((resolve) => {
+          const selectorMatch = (el) => {
+            if (!(el instanceof HTMLElement))
+              return false;
+            if (el.getAttribute("role") === "dialog")
+              return true;
+            const cls = `${el.className || ""}`;
+            return /minicart|drawer|cart-popup|cart-modal/i.test(cls);
+          };
+          const observer = new MutationObserver((muts) => {
+            for (const m of muts) {
+              for (const n of Array.from(m.addedNodes)) {
+                if (n instanceof Element && selectorMatch(n)) {
+                  observer.disconnect();
+                  resolve(true);
+                  return;
+                }
+              }
+              if (m.type === "attributes" && m.target instanceof Element && selectorMatch(m.target)) {
+                observer.disconnect();
+                resolve(true);
+                return;
+              }
+            }
+          });
+          observer.observe(document.body, {
+            childList: true,
+            subtree: true,
+            attributes: true,
+            attributeFilter: ["class", "style", "aria-expanded", "open"]
+          });
+          setTimeout(() => {
+            observer.disconnect();
+            resolve(false);
+          }, 600);
+        });
+      });
+      const hoverPromise = trigger.hover({ timeout: 1500 }).catch(() => {
+        return;
+      });
+      await hoverPromise;
+      const result = await observedHoverDrawer;
+      await page.mouse.move(0, 0).catch(() => {
+        return;
+      });
+      if (result)
+        return "hover-drawer";
+    } catch {}
+  }
+  if (hasClickAttr)
+    return "click-drawer";
+  return "unknown";
+}
 async function isCartRevealed(page, expectedProductTitle) {
   if (expectedProductTitle) {
     const v = await validateCartContainsTitleQuick(page, expectedProductTitle);
@@ -7303,7 +7545,7 @@ async function journeyCommand(opts) {
   let platform = "custom";
   try {
     const homeRes = await fetch(opts.prod, {
-      headers: { "User-Agent": "Mozilla/5.0 parity-cli" }
+      headers: { "User-Agent": userAgentFor(viewports[0] ?? "mobile") }
     });
     if (homeRes.ok) {
       const html = await homeRes.text();
@@ -7372,7 +7614,8 @@ async function journeyCommand(opts) {
         learned,
         platform,
         recoveryBudget: 3,
-        onStep: onStepFor(viewport, side)
+        onStep: onStepFor(viewport, side),
+        acceptProdQuirks: opts.acceptProdQuirks
       });
       return cap;
     } finally {
@@ -8523,6 +8766,17 @@ function normalizeUrl(rawUrl) {
 }
 
 // src/diff/dom.ts
+var BANNER_WIDTH_THRESHOLD = 600;
+var BANNER_SECTION_RE = /(carousel|slider|banner|hero)/i;
+function parseDim(raw) {
+  if (!raw)
+    return null;
+  const trimmed = raw.replace(/px$/i, "").trim();
+  if (!trimmed)
+    return null;
+  const n = Number(trimmed);
+  return Number.isFinite(n) && n > 0 ? n : null;
+}
 function snapshotDom(html) {
   const $ = cheerio5.load(html);
   const counts = {
@@ -8570,12 +8824,29 @@ function snapshotDom(html) {
     jsonLdTypes: jsonLdTypes.sort()
   };
   const imgs = $("img");
+  const banners = [];
+  imgs.each((_, el) => {
+    const $el = $(el);
+    const widthAttr = parseDim($el.attr("width"));
+    const heightAttr = parseDim($el.attr("height"));
+    const sectionAncestor = $el.parents("[data-section]").filter((_2, p) => BANNER_SECTION_RE.test($(p).attr("data-section") ?? "")).first();
+    const sectionName = sectionAncestor.length > 0 ? sectionAncestor.attr("data-section") ?? null : null;
+    const looksLikeBanner = sectionName !== null || widthAttr !== null && widthAttr >= BANNER_WIDTH_THRESHOLD;
+    if (!looksLikeBanner)
+      return;
+    const src = $el.attr("src") ?? "";
+    if (!src)
+      return;
+    const aspectRatio = widthAttr && heightAttr && heightAttr > 0 ? widthAttr / heightAttr : null;
+    banners.push({ src, width: widthAttr, height: heightAttr, aspectRatio, sectionName });
+  });
   const imageStats = {
     total: imgs.length,
     withSrcset: imgs.filter((_, el) => Boolean($(el).attr("srcset"))).length,
     withAlt: imgs.filter((_, el) => Boolean($(el).attr("alt"))).length,
     withoutAlt: imgs.filter((_, el) => !$(el).attr("alt")).length,
-    src: imgs.map((_, el) => $(el).attr("src") ?? "").get().filter(Boolean)
+    src: imgs.map((_, el) => $(el).attr("src") ?? "").get().filter(Boolean),
+    banners
   };
   const decoSectionsRendered = [];
   $("[data-section]").each((_, el) => {
@@ -8894,6 +9165,9 @@ function buildContextBlock(input) {
   if (input.sectionsOnlyInProd && input.sectionsOnlyInProd.length > 0) {
     lines.push("", "**Sections detectadas no DOM de prod mas AUSENTES em cand** (provavelmente faltando migrar):", ...input.sectionsOnlyInProd.map((s) => `- ${s}`), "", "Verifique visualmente se essas sections aparecem na 2ª imagem. Se ausentes, reporte como missing-component com severity high ou critical.");
   }
+  if (input.bothHaveCarousel) {
+    lines.push("", "**Ambos os lados expõem um carousel/slider no DOM.** Diferenças no conteúdo do hero (banner diferente, texto diferente, imagem diferente) provavelmente são apenas slides diferentes do mesmo carousel capturados em momentos distintos. NÃO reporte essas diferenças como critical/high. Se o carousel inteiro sumir, ou o layout do hero quebrar, isso sim reporte normalmente.");
+  }
   if (input.prodSections && input.prodSections.length > 0) {
     lines.push("", `Total sections em prod: ${input.prodSections.length}; em cand: ${input.candSections?.length ?? 0}.`);
   }
@@ -8952,6 +9226,32 @@ function pathFromKey(key) {
 function severityForDiff(d) {
   return d.severity;
 }
+var CAROUSEL_SECTION_RE = /(carousel|slider)/i;
+function hasCarouselSection(sections) {
+  return sections.some((s) => CAROUSEL_SECTION_RE.test(s));
+}
+function downgradeCarouselFramingDiffs(diffs, bothHaveCarousel) {
+  if (!bothHaveCarousel)
+    return diffs;
+  const CAROUSEL_FRAME_TYPES = new Set([
+    "different-component",
+    "image-diff",
+    "text-changed"
+  ]);
+  return diffs.map((d) => {
+    if (d.region !== "hero")
+      return d;
+    if (!CAROUSEL_FRAME_TYPES.has(d.type))
+      return d;
+    if (d.severity === "low")
+      return d;
+    return {
+      ...d,
+      severity: "low",
+      description: `${d.description} [downgraded: ambos os lados expõem um carousel/slider — provável diferença só de slide ativo no momento da captura]`
+    };
+  });
+}
 async function visualRegressionKeyframes(ctx) {
   const start = Date.now();
   const { pairs } = pairCaptures(ctx.prodPages, ctx.candPages);
@@ -8995,6 +9295,7 @@ async function visualRegressionKeyframes(ctx) {
     const prodSet = new Set(prodSections);
     const sectionsOnlyInProd = prodSections.filter((s) => !candSet.has(s));
     const sectionsOnlyInCand = candSections.filter((s) => !prodSet.has(s));
+    const bothHaveCarousel = hasCarouselSection(prodSections) && hasCarouselSection(candSections);
     const trivial = pctDiff < PASS_PCT_THRESHOLD && sectionsOnlyInProd.length === 0;
     let differences = [];
     let llmCalled = false;
@@ -9010,13 +9311,17 @@ async function visualRegressionKeyframes(ctx) {
           viewport: pair.viewport,
           prodSections,
           candSections,
-          sectionsOnlyInProd
+          sectionsOnlyInProd,
+          bothHaveCarousel
         });
         differences = diffs ?? [];
       } catch (err) {
         llmError = err.message;
       }
     }
+    if (differences.length > 0) {
+      differences = downgradeCarouselFramingDiffs(differences, bothHaveCarousel);
+    }
     let verdict;
     const hasCritical = differences.some((d) => d.severity === "critical" || d.severity === "high");
     const hasAnyDiff = differences.length > 0 || sectionsOnlyInProd.length > 0;
@@ -9441,6 +9746,179 @@ function countFailedImageRequests(entries) {
   return entries.filter((e) => e.resourceType === "image" && (e.status === 0 || e.status >= 400)).length;
 }
 
+// src/checks/banner-aspect-ratio.ts
+var ASPECT_RATIO_TOLERANCE = 0.15;
+function bannerAspectRatio(ctx) {
+  const start = Date.now();
+  const { pairs } = pairCaptures(ctx.prodPages, ctx.candPages);
+  const issues = [];
+  let pagesChecked = 0;
+  let pagesWithIssues = 0;
+  for (const pair of pairs) {
+    if (!pair.prod.html || !pair.cand.html)
+      continue;
+    pagesChecked++;
+    const prodBanners = snapshotDom(pair.prod.html).imageStats.banners;
+    const candBanners = snapshotDom(pair.cand.html).imageStats.banners;
+    if (prodBanners.length === 0 && candBanners.length === 0)
+      continue;
+    const pageIssuesBefore = issues.length;
+    const len = Math.min(prodBanners.length, candBanners.length);
+    const comparisons = [];
+    for (let i = 0;i < len; i++) {
+      const prod = prodBanners[i];
+      const cand = candBanners[i];
+      if (prod && cand)
+        comparisons.push({ index: i, prod, cand });
+    }
+    for (const cmp of comparisons) {
+      issues.push(...issuesForPair(pair.key, cmp));
+    }
+    if (prodBanners.length !== candBanners.length) {
+      issues.push({
+        id: `banner-aspect:count:${pair.key}`,
+        severity: "medium",
+        category: "visual",
+        page: pair.key,
+        check: "banner-aspect-ratio",
+        summary: `Banner count divergente em ${pair.key}: prod=${prodBanners.length}, cand=${candBanners.length}`
+      });
+    }
+    if (issues.length > pageIssuesBefore)
+      pagesWithIssues++;
+  }
+  const status = issues.some((i) => i.severity === "high" || i.severity === "critical") ? "fail" : issues.length > 0 ? "warn" : "pass";
+  return {
+    name: "banner-aspect-ratio",
+    status,
+    severity: "medium",
+    durationMs: Date.now() - start,
+    summary: `${pagesChecked} página(s) analisada(s), ${pagesWithIssues} com diferença de aspect ratio em banner`,
+    issues,
+    data: { pagesChecked, pagesWithIssues }
+  };
+}
+function issuesForPair(pageKey, cmp) {
+  const { prod, cand, index } = cmp;
+  const out = [];
+  const label = describeBanner(prod) || describeBanner(cand) || `banner #${index + 1}`;
+  const prodHasDims = prod.width !== null && prod.height !== null;
+  const candHasDims = cand.width !== null && cand.height !== null;
+  if (prodHasDims && !candHasDims) {
+    out.push({
+      id: `banner-aspect:missing-dims:${pageKey}:${index}`,
+      severity: "medium",
+      category: "performance",
+      page: pageKey,
+      check: "banner-aspect-ratio",
+      summary: `Atributos width/height ausentes em cand para ${label} (prod=${prod.width}×${prod.height}). Aumenta CLS porque o navegador não consegue reservar o slot antes da imagem decodificar.`
+    });
+  }
+  if (prod.aspectRatio !== null && cand.aspectRatio !== null) {
+    const ratioDelta = Math.abs(prod.aspectRatio - cand.aspectRatio) / prod.aspectRatio;
+    if (ratioDelta >= ASPECT_RATIO_TOLERANCE) {
+      const shape = (r) => r > 1.5 ? "wide" : r < 0.8 ? "tall" : "near-square";
+      const prodShape = shape(prod.aspectRatio);
+      const candShape = shape(cand.aspectRatio);
+      const orientationFlipped = prodShape === "wide" && candShape === "tall" || prodShape === "tall" && candShape === "wide";
+      out.push({
+        id: `banner-aspect:ratio:${pageKey}:${index}`,
+        severity: orientationFlipped ? "high" : "medium",
+        category: "visual",
+        page: pageKey,
+        check: "banner-aspect-ratio",
+        summary: `Aspect ratio divergente em ${label}: prod=${prod.width}×${prod.height} (${prod.aspectRatio.toFixed(2)}) vs cand=${cand.width}×${cand.height} (${cand.aspectRatio.toFixed(2)}) — Δ${(ratioDelta * 100).toFixed(0)}%${orientationFlipped ? ` (${prodShape} ↔ ${candShape}, provável variante mobile/desktop trocada)` : ""}`
+      });
+    }
+  }
+  return out;
+}
+function describeBanner(b) {
+  if (b.sectionName)
+    return `${b.sectionName} banner`;
+  const fname = b.src.split("?")[0]?.split("/").pop();
+  return fname ? `banner '${fname.slice(0, 40)}'` : null;
+}
+
+// src/checks/cart-reveal-mode.ts
+function cartRevealModeDivergence(ctx) {
+  const start = Date.now();
+  const issues = [];
+  let viewportsChecked = 0;
+  let viewportsDivergent = 0;
+  for (const viewport of ctx.viewports) {
+    const prodMode = readMode(ctx.prodFlows, viewport);
+    const candMode = readMode(ctx.candFlows, viewport);
+    if (prodMode === null && candMode === null)
+      continue;
+    viewportsChecked++;
+    if (prodMode === null || candMode === null) {
+      continue;
+    }
+    if (prodMode === candMode)
+      continue;
+    viewportsDivergent++;
+    issues.push({
+      id: `cart-reveal-mode:${viewport}:divergent`,
+      severity: "critical",
+      category: "functional",
+      check: "cart-reveal-mode-divergence",
+      summary: `[${viewport}] minicart trigger divergente: prod=${prodMode}, cand=${candMode}${explainDivergence(prodMode, candMode)}`,
+      details: detailFor(prodMode, candMode, viewport)
+    });
+  }
+  const status = viewportsDivergent > 0 ? "fail" : viewportsChecked > 0 ? "pass" : "skipped";
+  return {
+    name: "cart-reveal-mode-divergence",
+    status,
+    severity: "critical",
+    durationMs: Date.now() - start,
+    summary: viewportsChecked === 0 ? "purchase-journey não rodou ou step 7 não classificou cart reveal mode" : `${viewportsChecked} viewport(s) checados, ${viewportsDivergent} com markup divergente`,
+    issues,
+    data: { viewportsChecked, viewportsDivergent }
+  };
+}
+function readMode(flows, viewport) {
+  const flow = flows.find((f) => f.flow === "purchase-journey" && f.viewport === viewport);
+  if (!flow)
+    return null;
+  const step7 = flow.steps?.find((s) => s.name === "open-minicart");
+  return step7?.cartRevealMode ?? null;
+}
+function explainDivergence(prod, cand) {
+  const candIsNav = cand === "click-navigate-checkout" || cand === "click-navigate-cart";
+  const prodIsDrawer = prod === "hover-drawer" || prod === "click-drawer" || prod === "inline-notification";
+  if (candIsNav && prodIsDrawer) {
+    return " — usuário em cand é levado direto pra navegação em vez de inspecionar cart inline";
+  }
+  const prodIsNav = prod === "click-navigate-checkout" || prod === "click-navigate-cart";
+  const candIsDrawer = cand === "hover-drawer" || cand === "click-drawer" || cand === "inline-notification";
+  if (prodIsNav && candIsDrawer) {
+    return " — cand expõe um drawer onde prod fazia hard navigation (ganho de UX, mas mudança de fluxo)";
+  }
+  return "";
+}
+function detailFor(prod, cand, viewport) {
+  return [
+    `Viewport: ${viewport}`,
+    `Prod cart reveal mode: ${prod}`,
+    `Cand cart reveal mode: ${cand}`,
+    "",
+    "Os dois lados foram exercitados pelo step 7 (open-minicart). O markup",
+    "do trigger do minicart, porém, indica intenções diferentes:",
+    "  - hover-drawer:          trigger reveala drawer inline ao hover",
+    "  - click-drawer:          trigger tem handler de click que abre drawer inline",
+    "  - click-navigate-*:      trigger é link que NAVEGA pro checkout/cart",
+    "  - inline-notification:   drawer já foi aberto pelo add-to-cart",
+    "",
+    "Causas comuns de divergência em migração Deco Fresh→TanStack:",
+    "  1. Migração trocou o elemento <a href=...> por <button> (ou vice-versa)",
+    "  2. Migração removeu o data-toggle / aria-haspopup que ativava o drawer",
+    "  3. Migração desmontou o handler hover-only mas manteve o link de fallback"
+  ].join(`
+`);
+}
+
 // src/checks/lazy-sections.ts
 var LAZY_URL_PATTERN = /\/(deco\/render|_loader)\b/;
 function lazySectionPresence(ctx) {
@@ -10256,6 +10734,8 @@ var ALL_CHECKS = [
   networkSummaryDelta,
   webVitalsMobile,
   imageLoadingHealth,
+  bannerAspectRatio,
+  cartRevealModeDivergence,
   lazySectionPresence,
   seoDeepAudit,
   cacheCoverage
@@ -10906,7 +11386,8 @@ async function runCommand(rawOpts) {
   const rc = loadParityRc();
   rc.cep = opts.cep || rc.cep;
   const ignore = loadParityIgnore();
-  const preflight = await preflightCheck(opts.prod, opts.cand);
+  const primaryViewport = viewports[0] ?? "mobile";
+  const preflight = await preflightCheck(opts.prod, opts.cand, primaryViewport);
   if (!preflight.ok) {
     console.error(chalk13.red(`
   ✖ pre-flight falhou:`));
@@ -10919,7 +11400,7 @@ async function runCommand(rawOpts) {
   const learned = loadLearned();
   const learnedBefore = JSON.stringify(learned);
   let platform = "custom";
-  const prodHomeHtml = await fetchHomeHtml(opts.prod);
+  const prodHomeHtml = await fetchHomeHtml(opts.prod, primaryViewport);
   if (prodHomeHtml) {
     platform = detectPlatform({ url: opts.prod, html: prodHomeHtml });
     if (platform !== "custom") {
@@ -10933,7 +11414,7 @@ async function runCommand(rawOpts) {
   if (wantsAutoSelectors) {
     const discoverSpinner = ora4("Descobrindo seletores via LLM (analisando home prod)…").start();
     try {
-      const html = prodHomeHtml ?? await fetchHomeHtml(opts.prod);
+      const html = prodHomeHtml ?? await fetchHomeHtml(opts.prod, primaryViewport);
       if (html) {
         const discovered = await discoverSelectorsFromUrl(opts.prod, html, {
           noCache: opts.refreshSelectors === true
@@ -10977,6 +11458,23 @@ async function runCommand(rawOpts) {
   const allPageCaptures = [];
   try {
     browser = await launchBrowser({ headless: true });
+    if (opts.warmup) {
+      const warmupSpinner = ora4("Warmup: bustando cache em prod + cand…").start();
+      const result = await warmupTargets({
+        urls: [opts.prod, opts.cand],
+        viewports,
+        bypassCache: opts.bypassCache !== false
+      });
+      if (result.failed.length === 0) {
+        warmupSpinner.succeed(`Warmup ok — ${result.succeeded}/${result.attempted} workers serviram resposta fresca`);
+      } else if (result.succeeded > 0) {
+        const failureSummary = result.failed.slice(0, 3).map((f) => `${f.viewport}/${hostOf(f.url)} (${f.reason})`).join("; ");
+        warmupSpinner.warn(`Warmup parcial — ${result.succeeded}/${result.attempted} ok; ${result.failed.length} falha(s): ${failureSummary}`);
+      } else {
+        const firstReason = result.failed[0]?.reason ?? "unknown";
+        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;
@@ -10987,7 +11485,8 @@ async function runCommand(rawOpts) {
           viewport,
           harPath,
           tracesDir: paths.tracesDir,
-          cohortCookieValue: "control"
+          cohortCookieValue: "control",
+          noCache: opts.bypassCache
         });
         await installVitalsCollector(ctx);
         for (const flow of flows) {
@@ -11001,7 +11500,8 @@ async function runCommand(rawOpts) {
             outDir: paths.screenshotsDir,
             learned,
             platform,
-            recoveryBudget: 3
+            recoveryBudget: 3,
+            acceptProdQuirks: opts.acceptProdQuirks
           });
           allFlowCaptures.push(cap);
           for (const p of cap.pages)
@@ -11086,7 +11586,7 @@ async function runCommand(rawOpts) {
             const baseUrl = task.side === "prod" ? opts.prod : opts.cand;
             const fullUrl = new URL(task.path, baseUrl).toString();
             try {
-              const ctx = await newContext(browser, { viewport: task.viewport, cohortCookieValue: "control" });
+              const ctx = await newContext(browser, { viewport: task.viewport, cohortCookieValue: "control", noCache: opts.bypassCache });
               await installVitalsCollector(ctx);
               const page = await ctx.newPage();
               try {
@@ -11163,7 +11663,7 @@ async function runCommand(rawOpts) {
             const safePath = task.path.replace(/[/?&=]+/g, "_") || "_root";
             const screenshotPath2 = `${paths.screenshotsDir}/visual-${safePath}-${task.viewport}-${task.side}.png`;
             try {
-              const ctx = await newContext(browser, { viewport: task.viewport, cohortCookieValue: "control" });
+              const ctx = await newContext(browser, { viewport: task.viewport, cohortCookieValue: "control", noCache: opts.bypassCache });
               await installVitalsCollector(ctx);
               const page = await ctx.newPage();
               try {
@@ -11331,9 +11831,10 @@ async function runWithConcurrency3(items, workers, fn) {
     }
   }));
 }
-async function preflightCheck(prodUrl, candUrl) {
+async function preflightCheck(prodUrl, candUrl, viewport) {
   const spinner = ora4("Pre-flight: verificando URLs…").start();
   const errors = [];
+  const ua = userAgentFor(viewport);
   async function probe(label, url) {
     try {
       new URL(url);
@@ -11349,7 +11850,7 @@ async function preflightCheck(prodUrl, candUrl) {
         redirect: "follow",
         signal: controller.signal,
         headers: {
-          "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/130.0.0.0 Safari/537.36"
+          "User-Agent": ua
         }
       });
       if (res.status >= 500)
@@ -11372,11 +11873,44 @@ async function preflightCheck(prodUrl, candUrl) {
   spinner.succeed("Pre-flight OK");
   return { ok: true, errors: [] };
 }
-async function fetchHomeHtml(url) {
+function addCacheBuster(url) {
+  try {
+    const u = new URL(url);
+    u.searchParams.set("_pcb", String(Date.now()));
+    return u.toString();
+  } catch {
+    return url;
+  }
+}
+async function warmupTargets(opts) {
+  const headers = opts.bypassCache ? { "Cache-Control": "no-cache", Pragma: "no-cache" } : {};
+  const jobs = [];
+  for (const url of opts.urls) {
+    for (const viewport of opts.viewports) {
+      const ua = userAgentFor(viewport);
+      const target = addCacheBuster(url);
+      jobs.push(fetch(target, {
+        method: "GET",
+        redirect: "follow",
+        headers: { ...headers, "User-Agent": ua }
+      }).then((res) => res.ok || res.status >= 200 && res.status < 400 ? { ok: true } : { ok: false, url, viewport, reason: `HTTP ${res.status} ${res.statusText}` }).catch((err) => ({
+        ok: false,
+        url,
+        viewport,
+        reason: err.message ?? "fetch failed"
+      })));
+    }
+  }
+  const results = await Promise.all(jobs);
+  const succeeded = results.filter((r) => r.ok).length;
+  const failed = results.filter((r) => !r.ok).map(({ url, viewport, reason }) => ({ url, viewport, reason }));
+  return { attempted: results.length, succeeded, failed };
+}
+async function fetchHomeHtml(url, viewport = "desktop") {
   try {
     const res = await fetch(url, {
       headers: {
-        "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/130.0.0.0 Safari/537.36",
+        "User-Agent": userAgentFor(viewport),
         Accept: "text/html,application/xhtml+xml",
         "Accept-Language": "pt-BR,pt;q=0.9,en;q=0.8"
       },
@@ -11436,7 +11970,7 @@ function printSummary4(run, htmlPath, meta) {
 // src/cli.ts
 var program = new Command;
 program.name("parity").description("E2E parity validator for Fresh -> TanStack site migrations").version("0.0.0");
-program.command("run").description("Compare two URLs and produce a parity report").requiredOption("--prod <url>", "Production URL (source of truth, e.g. Fresh site)").requiredOption("--cand <url>", "Candidate URL (migrated site, e.g. TanStack)").option("--preset <name>", "Bundle of defaults: smoke (fast, ~30s, no LLM) | full (deep audit) | ci (CI-tuned)").option("--flows <list>", "Comma-separated flows: homepage,plp,pdp,purchase-journey", "purchase-journey").option("--viewports <list>", "Comma-separated viewports: mobile,desktop", "mobile,desktop").option("--cep <cep>", "CEP for shipping calculation", "01310-100").option("--runs <n>", "Repeat each measurement N times (median)", "1").option("--baseline <name>", "Compare against a saved baseline").option("--output <dir>", "Output directory", "./parity-output").option("--ci", "CI mode: stricter exit codes", false).option("--fail-on <severities>", "Comma-separated severities that cause exit 1", "critical").option("--open", "Open the HTML report after the run completes", false).option("--no-auto-selectors", "Disable LLM-based selector discovery (uses defaults instead)").option("--refresh-selectors", "Bypass selector cache and re-run discovery", false).option("--no-learn", "Don't write to learned-selectors.json (read-only mode)").option("--vitals-pages <n>", "Extra pages from sitemap to crawl for Vitals coverage (default 10)", (v) => Number(v), 10).option("--visual-pages <n>", "Pages to compare visually via LLM (home + sampled PLPs/PDPs from sitemap, default 5)", (v) => Number(v), 5).option("--no-visual-diff", "Skip the visual diff capture pass entirely").action(async (opts) => {
+program.command("run").description("Compare two URLs and produce a parity report").requiredOption("--prod <url>", "Production URL (source of truth, e.g. Fresh site)").requiredOption("--cand <url>", "Candidate URL (migrated site, e.g. TanStack)").option("--preset <name>", "Bundle of defaults: smoke (fast, ~30s, no LLM) | full (deep audit) | ci (CI-tuned)").option("--flows <list>", "Comma-separated flows: homepage,plp,pdp,purchase-journey", "purchase-journey").option("--viewports <list>", "Comma-separated viewports: mobile,desktop", "mobile,desktop").option("--cep <cep>", "CEP for shipping calculation", "01310-100").option("--runs <n>", "Repeat each measurement N times (median)", "1").option("--baseline <name>", "Compare against a saved baseline").option("--output <dir>", "Output directory", "./parity-output").option("--ci", "CI mode: stricter exit codes", false).option("--fail-on <severities>", "Comma-separated severities that cause exit 1", "critical").option("--open", "Open the HTML report after the run completes", false).option("--no-auto-selectors", "Disable LLM-based selector discovery (uses defaults instead)").option("--refresh-selectors", "Bypass selector cache and re-run discovery", false).option("--no-learn", "Don't write to learned-selectors.json (read-only mode)").option("--vitals-pages <n>", "Extra pages from sitemap to crawl for Vitals coverage (default 10)", (v) => Number(v), 10).option("--visual-pages <n>", "Pages to compare visually via LLM (home + sampled PLPs/PDPs from sitemap, default 5)", (v) => Number(v), 5).option("--no-visual-diff", "Skip the visual diff capture pass entirely").option("--bypass-cache", "Bypass CDN/edge caches: append a cache-busting query param and send Cache-Control: no-cache on every request. Use right after a deploy to avoid false failures from stale CF edge content.", false).option("--warmup", "Before measurement, hit each target URL once (per viewport) with a cache-buster so the Worker serves a fresh response. Recommended after deploys.", false).option("--accept-prod-quirks", "Demote prod-side cart-empty journey failures (VTEX session quirk) from failed to skipped. The cart-reveal-mode-divergence check still emits critical if prod/cand markup intents differ, so this flag never masks a real regression. See issue #12.", false).action(async (opts) => {
   const code = await runCommand(opts);
   process.exit(code);
 });
@@ -11465,7 +11999,7 @@ program.command("cache").description("Análise de cache focada em cand. Crawla N
 program.command("vitals").description("Crawleia múltiplas páginas (via sitemap.xml ou --urls) e compara Web Vitals prod vs cand em cada uma. Output HTML com top piores/melhores expandidos.").requiredOption("--prod <url>", "Production URL (base)").requiredOption("--cand <url>", "Candidate URL (base)").option("--urls <list-or-file>", "Comma-separated paths or .txt file (1/line). Overrides sitemap discovery.").option("--limit <n>", "Max pages discovered from sitemap.xml", (v) => Number(v), 20).option("--viewports <list>", "mobile,desktop", "mobile").option("--concurrency <n>", "Parallel workers (1-8)", (v) => Number(v), 4).option("--output <dir>", "Output directory", "./parity-output").option("--open", "Open the HTML report when done", false).action(async (opts) => {
   process.exit(await vitalsCommand(opts));
 });
-program.command("journey").description("CI-friendly: roda só o purchase-journey (home → PLP → PDP → frete → carrinho → frete carrinho → checkout) e compara prod vs cand step-by-step").requiredOption("--prod <url>", "Production URL").requiredOption("--cand <url>", "Candidate URL").option("--viewports <list>", "mobile,desktop", "mobile").option("--cep <cep>", "CEP for shipping calc", "01310-100").option("--output <dir>", "Output directory for runs/<id>/", "./parity-output").option("--junit <file>", "Write JUnit XML to this path").option("--github", "Emit GitHub Actions annotations (::error, ::warning) for failures").option("--json", "Emit a one-line JSON status object to stdout (machine-readable)").option("--no-report", "Skip writing report.html / report.json").option("--no-auto-selectors", "Skip LLM-based selector discovery").action(async (opts) => {
+program.command("journey").description("CI-friendly: roda só o purchase-journey (home → PLP → PDP → frete → carrinho → frete carrinho → checkout) e compara prod vs cand step-by-step").requiredOption("--prod <url>", "Production URL").requiredOption("--cand <url>", "Candidate URL").option("--viewports <list>", "mobile,desktop", "mobile").option("--cep <cep>", "CEP for shipping calc", "01310-100").option("--output <dir>", "Output directory for runs/<id>/", "./parity-output").option("--junit <file>", "Write JUnit XML to this path").option("--github", "Emit GitHub Actions annotations (::error, ::warning) for failures").option("--json", "Emit a one-line JSON status object to stdout (machine-readable)").option("--no-report", "Skip writing report.html / report.json").option("--no-auto-selectors", "Skip LLM-based selector discovery").option("--accept-prod-quirks", "Demote prod-side cart-empty journey failures (VTEX session quirk) from failed to skipped. The cart-reveal-mode-divergence check still emits critical if prod/cand markup intents differ, so this flag never masks a real regression. See issue #12.", false).action(async (opts) => {
   process.exit(await journeyCommand(opts));
 });
 program.command("prompt").argument("<runId>", "Run ID").description("Generate a Markdown prompt of ranked issues ready to paste into any LLM").option("--output <dir>", "Output directory where runs live", "./parity-output").option("--out <file>", "Write to file instead of stdout").option("--min-severity <sev>", "Only include issues at or above this severity (critical|high|medium|low)", "low").option("--limit <n>", "Cap the number of issues included", (v) => Number(v), 20).action((runId, opts) => {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@decocms/parity",
-	"version": "0.5.4",
+	"version": "0.6.0",
 	"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",