@decocms/parity 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -5,6 +5,36 @@ 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.3.0](https://github.com/decocms/parity/compare/v0.2.0...v0.3.0) (2026-05-26)
+
+
+### Added
+
+* **journey:** retry `go-checkout` via LLM recovery when the default selector clicks the wrong element and the URL never reaches `/checkout` ([5826d30](https://github.com/decocms/parity/commit/5826d309c6a910f8cf8017667cdcdcebd65f65d9))
+* **journey:** LLM recovery on `cep-pdp` + `cep-cart` when defaults miss the CEP input ([624b0f5](https://github.com/decocms/parity/commit/624b0f5acbe1c50fce2bea69faa6906e29d36e64))
+* **journey:** per-flow hard deadline so a single hung flow can't freeze the whole crawl ([e2d4a68](https://github.com/decocms/parity/commit/e2d4a681a5d4f0a9627251eceb1e733d12bdc68d))
+
+
+### Fixed
+
+* **journey:** abort in-flight Playwright ops when the deadline fires, instead of letting them mutate the next flow's shared BrowserContext ([a21aa78](https://github.com/decocms/parity/commit/a21aa78a4431e7a2cff9aac26ac34c4ca2fa768c))
+* **journey:** seal the timeout FlowCapture synchronously so Promise.race can't pick up the inner rejection caused by closing pages ([d2a0f1e](https://github.com/decocms/parity/commit/d2a0f1e7a08bf95a28a951bace322c5baf062bea))
+* **journey:** await timeout cleanup before runFlow returns so the next flow on the same context isn't racing in-flight close()s ([a2fd6c2](https://github.com/decocms/parity/commit/a2fd6c2e7e7a9eb493d2cb75d08f3d5cc7cc3f91))
+
+## [0.2.0](https://github.com/decocms/parity/compare/v0.1.1...v0.2.0) (2026-05-26)
+
+
+### Added
+
+* **css-trace:** inspect CSS rules affecting a DOM element ([1e323fa](https://github.com/decocms/parity/commit/1e323fa17564045d5f55bfbc5cbf2fcdb0112877))
+
+
+### Fixed
+
+* **capture:** hard outer deadline so capturePage cannot exceed budget+10s ([966b9a5](https://github.com/decocms/parity/commit/966b9a59851536262b88510da6175a215c90d0b2))
+* **capture:** hard outer deadline so capturePage cannot exceed budget+10s ([ea61116](https://github.com/decocms/parity/commit/ea61116c81fb1ec86e86ddb24216214380a81c81))
+* **lint:** replace 3 template literals without interpolation with strings ([c60f19c](https://github.com/decocms/parity/commit/c60f19c4a56c8441ead829fca0998ee36a671872))
+
 ## [Unreleased]
 
 ## [0.1.1] — 2026-05-22

package/dist/cli.js

@@ -5059,19 +5059,60 @@ var PURCHASE_JOURNEY_TOTAL_STEPS = 8;
 function selFor(ctx, key) {
   return selectorsFor(key, { rc: ctx.rc, learned: ctx.learned, platform: ctx.platform });
 }
+var FLOW_DEADLINE_MS = {
+  homepage: 90000,
+  plp: 180000,
+  pdp: 240000,
+  "purchase-journey": 360000
+};
 async function runFlow(flow, ctx) {
   const start = Date.now();
-  switch (flow) {
-    case "homepage":
-      return finalize(flow, ctx, await flowHomepage(ctx), [], start);
-    case "plp":
-      return finalize(flow, ctx, await flowPlp(ctx), [], start);
-    case "pdp":
-      return finalize(flow, ctx, await flowPdp(ctx), [], start);
-    case "purchase-journey": {
-      const { pages, steps } = await flowPurchaseJourney(ctx);
-      return finalize(flow, ctx, pages, steps, start);
+  const deadlineMs = FLOW_DEADLINE_MS[flow];
+  const inner = async () => {
+    switch (flow) {
+      case "homepage":
+        return finalize(flow, ctx, await flowHomepage(ctx), [], start);
+      case "plp":
+        return finalize(flow, ctx, await flowPlp(ctx), [], start);
+      case "pdp":
+        return finalize(flow, ctx, await flowPdp(ctx), [], start);
+      case "purchase-journey": {
+        const { pages, steps } = await flowPurchaseJourney(ctx);
+        return finalize(flow, ctx, pages, steps, start);
+      }
     }
+  };
+  const innerPromise = inner();
+  innerPromise.catch(() => {
+    return;
+  });
+  let timer;
+  let cleanup = Promise.resolve();
+  const timeoutPromise = new Promise((resolve) => {
+    timer = setTimeout(() => {
+      const pages = ctx.ctx.pages();
+      resolve(finalize(flow, ctx, [], [
+        {
+          step: 0,
+          name: "visit-home",
+          side: ctx.side,
+          viewport: ctx.viewport,
+          status: "failed",
+          durationMs: deadlineMs,
+          screenshotPath: "",
+          actionDescription: `[flow-timeout] flow "${flow}" excedeu ${deadlineMs}ms — captura abortada pela safety net externa, ${pages.length} page(s) fechada(s) para liberar o contexto. Step interno provavelmente travou em uma operação Playwright que não respeitou seu timeout declarado.`
+        }
+      ], start));
+      cleanup = Promise.allSettled(pages.map((p) => p.close()));
+    }, deadlineMs);
+  });
+  try {
+    const result = await Promise.race([innerPromise, timeoutPromise]);
+    await cleanup;
+    return result;
+  } finally {
+    if (timer !== undefined)
+      clearTimeout(timer);
   }
 }
 function finalize(flow, ctx, pages, steps, start) {
@@ -5264,7 +5305,16 @@ async function flowPurchaseJourney(ctx) {
     steps[steps.length - 1].actionDescription = `Abriu PDP \`${pdpHit.url}\` (via \`${pdpHit.selector}\`)`;
     steps[steps.length - 1].beforeUrl = plpHit.url;
     reportStart(4, "shipping-calc-pdp");
-    const cepInputPdp = await firstVisible(page, selFor(ctx, "cepInputPdp"));
+    let cepInputPdp = await firstVisible(page, selFor(ctx, "cepInputPdp"));
+    let cepPdpRecovered = false;
+    if (!cepInputPdp && recoveryBudget > 0) {
+      const recovery = await attemptRecovery(page, ctx, "shipping-calc-pdp", "Achar o input de CEP / código postal nesta PDP (deve ser um input visível com label/placeholder relacionado a frete, entrega ou CEP)", selFor(ctx, "cepInputPdp"));
+      if (recovery) {
+        cepInputPdp = recovery.selector;
+        cepPdpRecovered = true;
+        recoveryBudget--;
+      }
+    }
     if (cepInputPdp) {
       const t4 = Date.now();
       const beforeUrl4 = page.url();
@@ -5289,14 +5339,15 @@ async function flowPurchaseJourney(ctx) {
         screenshotPath: sp,
         screenshotBeforePath: spBefore4,
         beforeUrl: beforeUrl4,
-        actionDescription: `Preencheu CEP '${ctx.rc.cep}' no input \`${cepInputPdp}\` e disparou cálculo de frete`,
+        actionDescription: `Preencheu CEP '${ctx.rc.cep}' no input \`${cepInputPdp}\` e disparou cálculo de frete${cepPdpRecovered ? " (selector via LLM recovery)" : ""}`,
         detail: { cepUsed: ctx.rc.cep },
         selectorKey: "cepInputPdp",
-        usedSelector: cepInputPdp
+        usedSelector: cepInputPdp,
+        recoveredByLlm: cepPdpRecovered || undefined
       });
       reportEnd(4, "shipping-calc-pdp", step4Status, Date.now() - t4);
     } else {
-      steps.push(makeSkipStep(4, "shipping-calc-pdp", ctx, "no CEP input on PDP"));
+      steps.push(makeSkipStep(4, "shipping-calc-pdp", ctx, "no CEP input on PDP (recovery exhausted)"));
       reportEnd(4, "shipping-calc-pdp", "skipped", 0, "no CEP input on PDP");
     }
     reportStart(5, "add-to-cart");
@@ -5394,7 +5445,16 @@ async function flowPurchaseJourney(ctx) {
     });
     reportEnd(6, "open-minicart", "ok", Date.now() - t6);
     reportStart(7, "shipping-calc-cart");
-    const cepInputCart = await firstVisible(page, selFor(ctx, "cepInputCart"));
+    let cepInputCart = await firstVisible(page, selFor(ctx, "cepInputCart"));
+    let cepCartRecovered = false;
+    if (!cepInputCart && recoveryBudget > 0) {
+      const recovery = await attemptRecovery(page, ctx, "shipping-calc-cart", "Achar o input de CEP / código postal dentro do carrinho ou minicart aberto agora (input visível com label/placeholder de frete, entrega ou CEP)", selFor(ctx, "cepInputCart"));
+      if (recovery) {
+        cepInputCart = recovery.selector;
+        cepCartRecovered = true;
+        recoveryBudget--;
+      }
+    }
     if (cepInputCart) {
       const t7 = Date.now();
       const beforeUrl7 = page.url();
@@ -5419,14 +5479,15 @@ async function flowPurchaseJourney(ctx) {
         screenshotPath: sp7,
         screenshotBeforePath: spBefore7,
         beforeUrl: beforeUrl7,
-        actionDescription: `Preencheu CEP '${ctx.rc.cep}' no carrinho (\`${cepInputCart}\`)`,
+        actionDescription: `Preencheu CEP '${ctx.rc.cep}' no carrinho (\`${cepInputCart}\`)${cepCartRecovered ? " (selector via LLM recovery)" : ""}`,
         detail: { cepUsed: ctx.rc.cep },
         selectorKey: "cepInputCart",
-        usedSelector: cepInputCart
+        usedSelector: cepInputCart,
+        recoveredByLlm: cepCartRecovered || undefined
       });
       reportEnd(7, "shipping-calc-cart", step7Status, Date.now() - t7);
     } else {
-      steps.push(makeSkipStep(7, "shipping-calc-cart", ctx, "no CEP input in cart"));
+      steps.push(makeSkipStep(7, "shipping-calc-cart", ctx, "no CEP input in cart (recovery exhausted)"));
       reportEnd(7, "shipping-calc-cart", "skipped", 0, "no CEP input in cart");
     }
     reportStart(8, "go-checkout");
@@ -5445,28 +5506,47 @@ async function flowPurchaseJourney(ctx) {
       reportEnd(8, "go-checkout", "skipped", 0, "no checkout button found");
       return { pages, steps };
     }
-    const t8 = Date.now();
-    const beforeUrl8 = page.url();
-    const spBefore8 = screenshotPath(ctx, "pj-8-checkout-before");
-    await page.screenshot({ path: spBefore8, fullPage: false }).catch(() => {
-      return;
-    });
-    const checkoutText = await checkoutHit.locator.innerText().catch(() => "");
-    await Promise.all([
-      page.waitForURL(/checkout/i, { timeout: 1e4 }).catch(() => {
+    const tryCheckoutClick = async (hit, attempt2) => {
+      const spBefore = screenshotPath(ctx, `pj-8-checkout-before-${attempt2}`);
+      await page.screenshot({ path: spBefore, fullPage: false }).catch(() => {
         return;
-      }),
-      checkoutHit.locator.click({ timeout: 5000 }).catch(() => {
+      });
+      const clickedText2 = await hit.locator.innerText().catch(() => "");
+      await Promise.all([
+        page.waitForURL(/checkout/i, { timeout: 1e4 }).catch(() => {
+          return;
+        }),
+        hit.locator.click({ timeout: 5000 }).catch(() => {
+          return;
+        })
+      ]);
+      await page.waitForTimeout(1500);
+      const spAfter = screenshotPath(ctx, `pj-8-checkout-reached-${attempt2}`);
+      await page.screenshot({ path: spAfter, fullPage: false }).catch(() => {
         return;
-      })
-    ]);
-    await page.waitForTimeout(1500);
-    const sp8 = screenshotPath(ctx, "pj-8-checkout-reached");
-    await page.screenshot({ path: sp8, fullPage: false }).catch(() => {
-      return;
-    });
-    const checkoutUrl = page.url();
-    const reachedCheckout = /\/checkout/i.test(checkoutUrl);
+      });
+      return { url: page.url(), spBefore, spAfter, clickedText: clickedText2 };
+    };
+    const t8 = Date.now();
+    const beforeUrl8 = page.url();
+    let attempt = 1;
+    let result = await tryCheckoutClick(checkoutHit, attempt);
+    let reachedCheckout = /\/checkout/i.test(result.url);
+    let usedSelector = checkoutHit.selector;
+    let clickedText = result.clickedText;
+    if (!reachedCheckout && recoveryBudget > 0 && !/\/checkout/i.test(beforeUrl8)) {
+      const retrySuggestion = await attemptRecovery(page, ctx, "go-checkout-retry", `Cliquei em '${clickedText.slice(0, 40).trim()}' (selector \`${usedSelector}\`), mas a URL ficou em ${result.url} e não foi pra /checkout. Achar o botão que de fato navega pra /checkout neste cart/minicart aberto.`, [usedSelector, ...selFor(ctx, "checkoutButton")]);
+      if (retrySuggestion) {
+        recoveryBudget--;
+        checkoutRecovered = true;
+        attempt++;
+        const retryResult = await tryCheckoutClick(retrySuggestion, attempt);
+        result = retryResult;
+        usedSelector = retrySuggestion.selector;
+        clickedText = retryResult.clickedText;
+        reachedCheckout = /\/checkout/i.test(retryResult.url);
+      }
+    }
     const step8Status = reachedCheckout ? "ok" : "failed";
     steps.push({
       step: 8,
@@ -5475,13 +5555,13 @@ async function flowPurchaseJourney(ctx) {
       viewport: ctx.viewport,
       status: step8Status,
       durationMs: Date.now() - t8,
-      url: checkoutUrl,
-      screenshotPath: sp8,
-      screenshotBeforePath: spBefore8,
+      url: result.url,
+      screenshotPath: result.spAfter,
+      screenshotBeforePath: result.spBefore,
       beforeUrl: beforeUrl8,
-      actionDescription: `Clicou em${checkoutText ? ` '${checkoutText.slice(0, 30).trim()}'` : ""} (\`${checkoutHit.selector}\`); URL final: ${checkoutUrl}${reachedCheckout ? " ✓ atingiu /checkout" : " ✗ não foi pra checkout"}`,
+      actionDescription: `Clicou em${clickedText ? ` '${clickedText.slice(0, 30).trim()}'` : ""} (\`${usedSelector}\`); URL final: ${result.url}${reachedCheckout ? " ✓ atingiu /checkout" : " ✗ não foi pra checkout"}${attempt > 1 ? ` (após ${attempt} tentativas com recovery LLM)` : ""}`,
       selectorKey: "checkoutButton",
-      usedSelector: checkoutHit.selector,
+      usedSelector,
       recoveredByLlm: checkoutRecovered || undefined
     });
     reportEnd(8, "go-checkout", step8Status, Date.now() - t8);

package/package.json

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