@decocms/parity 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -7,6 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.1.1] — 2026-05-22
+
+### Fixed
+
+- `cache-coverage`: classify `decoims.com` (deco image proxy) and `assets.decocache.com` (deco edge cache) as first-party so they remain eligible for cache-opportunity reporting instead of being silently skipped as third-party. ([#5](https://github.com/decocms/parity/pull/5))
+- `purchase-journey-flow`: never silently return `pass` when zero comparable steps were evaluated. The check now returns `skipped` when the flow wasn't requested, and `fail` (critical) when the flow was requested but neither side produced a capture or when capture arrays came back empty. Previously a fully broken cand home would still get a green verdict on the purchase-journey check. ([#6](https://github.com/decocms/parity/pull/6))
+
 ## [0.1.0] — 2026-05-12
 
 First public release.

package/dist/cli.js

@@ -540,7 +540,7 @@ function isThirdParty(url, baseHost) {
       return false;
     if (u.hostname.endsWith(`.${cleanedBase}`))
       return false;
-    if (u.hostname.includes("vtexassets") || u.hostname.includes("decoassets") || u.hostname.includes("vteximg"))
+    if (u.hostname.includes("vtexassets") || u.hostname.includes("decoassets") || u.hostname.includes("vteximg") || u.hostname.includes("decocache") || u.hostname.includes("decoims"))
       return false;
     return true;
   } catch {
@@ -1118,63 +1118,7 @@ async function capturePage(page, opts) {
   const overallBudgetMs = opts.fast ? 25000 : 60000;
   const deadline = start + overallBudgetMs;
   const remaining = () => Math.max(500, deadline - Date.now());
-  let response = null;
-  let finalUrl = opts.url;
-  let xRobotsTag = null;
-  try {
-    response = await page.goto(opts.url, {
-      waitUntil: "domcontentloaded",
-      timeout: Math.min(opts.timeoutMs ?? 30000, remaining())
-    });
-    finalUrl = page.url();
-    if (response) {
-      const headers = response.headers();
-      xRobotsTag = headers["x-robots-tag"] ?? null;
-    }
-    if (opts.fast) {
-      await page.waitForLoadState("networkidle", { timeout: Math.min(4000, remaining()) }).catch(() => {
-        return;
-      });
-      await page.waitForTimeout(Math.min(opts.settleMs ?? 1200, remaining()));
-    } else {
-      await page.waitForLoadState("load", { timeout: Math.min(12000, remaining()) }).catch(() => {
-        return;
-      });
-      await page.waitForLoadState("networkidle", { timeout: Math.min(6000, remaining()) }).catch(() => {
-        return;
-      });
-      await page.waitForTimeout(Math.min(opts.settleMs ?? 2000, remaining()));
-      if (opts.scrollToLoad !== false && remaining() > 3000) {
-        await Promise.race([
-          scrollFullPage(page).catch(() => {
-            return;
-          }),
-          new Promise((resolve) => setTimeout(resolve, Math.min(1e4, remaining())))
-        ]);
-        await page.waitForTimeout(Math.min(600, remaining()));
-      }
-    }
-  } catch (err) {
-    state.console.push({
-      type: "error",
-      text: `[navigation-error] ${err.message}`
-    });
-  }
-  const vitals = await page.evaluate(() => window.__parity_vitals).catch(() => null);
-  if (!opts.skipScreenshot) {
-    await Promise.race([
-      page.screenshot({ path: opts.screenshotPath, fullPage: true, animations: "disabled" }).catch(() => {
-        return;
-      }),
-      new Promise((resolve) => setTimeout(resolve, Math.min(15000, remaining())))
-    ]);
-  }
-  const html = await Promise.race([
-    page.content().catch(() => ""),
-    new Promise((resolve) => setTimeout(() => resolve(""), Math.min(5000, remaining())))
-  ]);
-  await flushCollectors(state, Math.min(3000, remaining()));
-  return {
+  const buildPartial = () => ({
     url: opts.url,
     finalUrl,
     status: response?.status() ?? 0,
@@ -1189,7 +1133,83 @@ async function capturePage(page, opts) {
     harPath: opts.harPath,
     tracePath: opts.tracePath,
     xRobotsTag
+  });
+  let response = null;
+  let finalUrl = opts.url;
+  let xRobotsTag = null;
+  let vitals = null;
+  let html = "";
+  const inner = async () => {
+    try {
+      response = await page.goto(opts.url, {
+        waitUntil: "domcontentloaded",
+        timeout: Math.min(opts.timeoutMs ?? 30000, remaining())
+      });
+      finalUrl = page.url();
+      if (response) {
+        const headers = response.headers();
+        xRobotsTag = headers["x-robots-tag"] ?? null;
+      }
+      if (opts.fast) {
+        await page.waitForLoadState("networkidle", { timeout: Math.min(4000, remaining()) }).catch(() => {
+          return;
+        });
+        await page.waitForTimeout(Math.min(opts.settleMs ?? 1200, remaining()));
+      } else {
+        await page.waitForLoadState("load", { timeout: Math.min(12000, remaining()) }).catch(() => {
+          return;
+        });
+        await page.waitForLoadState("networkidle", { timeout: Math.min(6000, remaining()) }).catch(() => {
+          return;
+        });
+        await page.waitForTimeout(Math.min(opts.settleMs ?? 2000, remaining()));
+        if (opts.scrollToLoad !== false && remaining() > 3000) {
+          await Promise.race([
+            scrollFullPage(page).catch(() => {
+              return;
+            }),
+            new Promise((resolve) => setTimeout(resolve, Math.min(1e4, remaining())))
+          ]);
+          await page.waitForTimeout(Math.min(600, remaining()));
+        }
+      }
+    } catch (err) {
+      state.console.push({
+        type: "error",
+        text: `[navigation-error] ${err.message}`
+      });
+    }
+    vitals = await Promise.race([
+      page.evaluate(() => window.__parity_vitals).catch(() => null),
+      new Promise((resolve) => setTimeout(() => resolve(null), Math.min(5000, remaining())))
+    ]) ?? null;
+    if (!opts.skipScreenshot) {
+      await Promise.race([
+        page.screenshot({ path: opts.screenshotPath, fullPage: true, animations: "disabled" }).catch(() => {
+          return;
+        }),
+        new Promise((resolve) => setTimeout(resolve, Math.min(15000, remaining())))
+      ]);
+    }
+    html = await Promise.race([
+      page.content().catch(() => ""),
+      new Promise((resolve) => setTimeout(() => resolve(""), Math.min(5000, remaining())))
+    ]);
+    await flushCollectors(state, Math.min(3000, remaining()));
+    return buildPartial();
   };
+  const SAFETY_MARGIN_MS = 1e4;
+  const outerDeadlineMs = overallBudgetMs + SAFETY_MARGIN_MS;
+  return Promise.race([
+    inner(),
+    new Promise((resolve) => setTimeout(() => {
+      state.console.push({
+        type: "error",
+        text: `[capture-timeout] capturePage exceeded ${outerDeadlineMs}ms outer deadline — returning partial capture`
+      });
+      resolve(buildPartial());
+    }, outerDeadlineMs))
+  ]);
 }
 
 // src/report/render.ts
@@ -4084,8 +4104,257 @@ Regressões (severity piorou):`));
   }
 }
 
-// src/commands/explain.ts
+// src/commands/css-trace.ts
 import chalk4 from "chalk";
+async function tracePage(page, url, selector, settleMs) {
+  await page.goto(url, { waitUntil: "domcontentloaded", timeout: 30000 });
+  await page.waitForLoadState("load", { timeout: 12000 }).catch(() => {
+    return;
+  });
+  await page.waitForLoadState("networkidle", { timeout: 6000 }).catch(() => {
+    return;
+  });
+  await page.waitForTimeout(settleMs);
+  const cdp = await page.context().newCDPSession(page);
+  await cdp.send("DOM.enable");
+  await cdp.send("CSS.enable");
+  const { root } = await cdp.send("DOM.getDocument", { depth: -1 });
+  const found = await cdp.send("DOM.querySelector", {
+    nodeId: root.nodeId,
+    selector
+  });
+  if (!found.nodeId) {
+    await cdp.detach();
+    return { url, selector, found: false, computed: {}, rules: [] };
+  }
+  const computedResult = await cdp.send("CSS.getComputedStyleForNode", {
+    nodeId: found.nodeId
+  });
+  const computed = {};
+  for (const e of computedResult.computedStyle)
+    computed[e.name] = e.value;
+  const matched = await cdp.send("CSS.getMatchedStylesForNode", {
+    nodeId: found.nodeId
+  });
+  const sheetUrlCache = new Map;
+  async function sheetSource(styleSheetId, origin) {
+    if (!styleSheetId) {
+      if (origin === "user-agent")
+        return "user-agent";
+      return "inline";
+    }
+    if (sheetUrlCache.has(styleSheetId))
+      return sheetUrlCache.get(styleSheetId);
+    try {
+      const header = await cdp.send("CSS.getStyleSheetText", {
+        styleSheetId
+      });
+      const preview = header.text.replace(/\s+/g, " ").trim().slice(0, 100);
+      const label = `stylesheet#${styleSheetId} (${preview})`;
+      sheetUrlCache.set(styleSheetId, label);
+      return label;
+    } catch {
+      const label = `stylesheet#${styleSheetId}`;
+      sheetUrlCache.set(styleSheetId, label);
+      return label;
+    }
+  }
+  const buildRule = async (m, inheritedFromDistance) => {
+    const r = m.rule;
+    const selectors = r.selectorList.selectors.map((s) => s.text);
+    const matchedSelectors = m.matchingSelectors.map((i) => selectors[i]).filter(Boolean);
+    const sel = matchedSelectors.join(", ") || selectors.join(", ") || "(no selector text)";
+    const source = await sheetSource(r.styleSheetId, r.origin);
+    return {
+      source,
+      selector: sel,
+      properties: (r.style.cssProperties ?? []).filter((p) => p.name && p.value && !p.disabled).map((p) => {
+        const trimmed = p.value.replace(/\s*!important\s*$/i, "").trim();
+        return {
+          name: p.name,
+          value: trimmed || p.value,
+          important: p.important === true || /\s*!important\s*$/i.test(p.value),
+          disabled: p.disabled
+        };
+      }),
+      ...inheritedFromDistance !== undefined ? { inheritedFromDistance } : {}
+    };
+  };
+  const rules = [];
+  for (const m of matched.matchedCSSRules ?? []) {
+    rules.push(await buildRule(m));
+  }
+  const inheritedGroups = matched.inherited ?? [];
+  for (let i = 0;i < inheritedGroups.length; i++) {
+    const group = inheritedGroups[i];
+    if (!group?.matchedCSSRules?.length)
+      continue;
+    const distance = i + 1;
+    for (const m of group.matchedCSSRules) {
+      rules.push(await buildRule(m, distance));
+    }
+  }
+  await cdp.detach();
+  return { url, selector, found: true, computed, rules };
+}
+function applyFilter(result, filter) {
+  if (!filter)
+    return result;
+  const wanted = new Set(filter.split(",").map((s) => s.trim().toLowerCase()).filter(Boolean));
+  const computed = {};
+  for (const [k, v] of Object.entries(result.computed)) {
+    if (wanted.has(k.toLowerCase()))
+      computed[k] = v;
+  }
+  const rules = result.rules.map((r) => ({
+    ...r,
+    properties: r.properties.filter((p) => wanted.has(p.name.toLowerCase()))
+  })).filter((r) => r.properties.length > 0);
+  return { ...result, computed, rules };
+}
+function printResult(result, header) {
+  console.log(chalk4.bold(`
+${header}`));
+  console.log(chalk4.dim(`URL: ${result.url}`));
+  console.log(chalk4.dim(`Selector: ${result.selector}`));
+  if (!result.found) {
+    console.log(chalk4.red("✖ Element not found"));
+    return;
+  }
+  const computedKeys = Object.keys(result.computed);
+  if (computedKeys.length > 0) {
+    console.log(chalk4.bold(`
+  Computed:`));
+    for (const k of computedKeys) {
+      console.log(`    ${chalk4.cyan(k)}: ${result.computed[k]}`);
+    }
+  }
+  if (result.rules.length === 0) {
+    console.log(chalk4.yellow(`
+  No matching rules after filter.`));
+    return;
+  }
+  console.log(chalk4.bold(`
+  Rules (ordered by CDP — most specific last):`));
+  for (const r of result.rules) {
+    const inheritLabel = r.inheritedFromDistance !== undefined ? chalk4.yellow(` ↑ inherited from ancestor (${r.inheritedFromDistance})`) : "";
+    console.log(`    ${chalk4.magenta(r.source)}${inheritLabel}`);
+    console.log(`      ${chalk4.green(r.selector)} {`);
+    for (const p of r.properties) {
+      const bang = p.important ? chalk4.red(" !important") : "";
+      console.log(`        ${p.name}: ${p.value}${bang};`);
+    }
+    console.log("      }");
+  }
+}
+function diffComputed(prod, cand) {
+  const keys = new Set([...Object.keys(prod.computed), ...Object.keys(cand.computed)]);
+  const out = [];
+  for (const k of keys) {
+    const p = prod.computed[k];
+    const c = cand.computed[k];
+    if (p !== c)
+      out.push({ property: k, prod: p, cand: c });
+  }
+  return out.sort((a, b) => a.property.localeCompare(b.property));
+}
+function printComparison(prod, cand) {
+  printResult(prod, "── PROD ──────────────────────────────────────────────");
+  printResult(cand, "── CAND ──────────────────────────────────────────────");
+  const diffs = diffComputed(prod, cand);
+  console.log(chalk4.bold(`
+── DIFF (computed) ───────────────────────────────────`));
+  if (diffs.length === 0) {
+    console.log(chalk4.green("  No computed-style differences in the filtered set."));
+    return;
+  }
+  for (const d of diffs) {
+    console.log(`  ${chalk4.cyan(d.property)}`);
+    console.log(`    prod: ${chalk4.green(d.prod ?? "(unset)")}`);
+    console.log(`    cand: ${chalk4.red(d.cand ?? "(unset)")}`);
+  }
+}
+async function cssTraceCommand(opts) {
+  const viewport = opts.viewport ?? "desktop";
+  const settleMs = opts.settleMs ?? 1500;
+  if (!opts.selector) {
+    console.error(chalk4.red("--selector is required"));
+    return 1;
+  }
+  const hasUrl = !!opts.url;
+  const hasProd = !!opts.prod;
+  const hasCand = !!opts.cand;
+  if (hasUrl && (hasProd || hasCand)) {
+    console.error(chalk4.red("--url is mutually exclusive with --prod / --cand. Pass one mode only."));
+    return 1;
+  }
+  if (hasProd && !hasCand || !hasProd && hasCand) {
+    console.error(chalk4.red("Comparison mode needs both --prod and --cand (got only one)."));
+    return 1;
+  }
+  if (!hasUrl && !hasProd && !hasCand) {
+    console.error(chalk4.red("Provide either --url or both --prod and --cand."));
+    return 1;
+  }
+  const isCompare = hasProd && hasCand;
+  let browser = null;
+  try {
+    browser = await launchBrowser({ headless: true });
+    if (isCompare) {
+      const prodCtx = await newContext(browser, { viewport });
+      const candCtx = await newContext(browser, { viewport });
+      const prodPage = await prodCtx.newPage();
+      const candPage = await candCtx.newPage();
+      try {
+        const [prodRes, candRes] = await Promise.all([
+          tracePage(prodPage, opts.prod, opts.selector, settleMs),
+          tracePage(candPage, opts.cand, opts.selector, settleMs)
+        ]);
+        const prodF = applyFilter(prodRes, opts.filter);
+        const candF = applyFilter(candRes, opts.filter);
+        if (opts.json) {
+          console.log(JSON.stringify({ prod: prodF, cand: candF, diff: diffComputed(prodF, candF) }, null, 2));
+        } else {
+          printComparison(prodF, candF);
+        }
+      } finally {
+        await prodCtx.close().catch(() => {
+          return;
+        });
+        await candCtx.close().catch(() => {
+          return;
+        });
+      }
+    } else {
+      const ctx = await newContext(browser, { viewport });
+      const page = await ctx.newPage();
+      try {
+        const res = await tracePage(page, opts.url, opts.selector, settleMs);
+        const filtered = applyFilter(res, opts.filter);
+        if (opts.json) {
+          console.log(JSON.stringify(filtered, null, 2));
+        } else {
+          printResult(filtered, "── RESULT ────────────────────────────────────────────");
+        }
+      } finally {
+        await ctx.close().catch(() => {
+          return;
+        });
+      }
+    }
+    return 0;
+  } catch (err) {
+    console.error(chalk4.red(`Error: ${err.message}`));
+    return 1;
+  } finally {
+    await browser?.close().catch(() => {
+      return;
+    });
+  }
+}
+
+// src/commands/explain.ts
+import chalk5 from "chalk";
 
 // src/llm/client.ts
 import Anthropic from "@anthropic-ai/sdk";
@@ -4394,17 +4663,17 @@ Cada issue tem:
 // src/commands/explain.ts
 async function explainCommand(runId, issueId, output) {
   if (!isLlmAvailable()) {
-    console.error(chalk4.red("Nenhuma API key de LLM encontrada — set ANTHROPIC_API_KEY ou OPENROUTER_API_KEY."));
+    console.error(chalk5.red("Nenhuma API key de LLM encontrada — set ANTHROPIC_API_KEY ou OPENROUTER_API_KEY."));
     return 1;
   }
   const run = loadRun(output, runId);
   const issue = run.issues.find((i) => i.id === issueId) || run.topIssues.find((i) => i.id === issueId);
   if (!issue) {
-    console.error(chalk4.red(`Issue não encontrada: ${issueId}`));
+    console.error(chalk5.red(`Issue não encontrada: ${issueId}`));
     return 1;
   }
   const checks = run.checks.filter((c) => c.issues.some((i) => i.id === issueId || i.check === issue.check));
-  console.log(chalk4.dim(`Consultando LLM…
+  console.log(chalk5.dim(`Consultando LLM…
 `));
   const text = await callMessage({
     systemPrompt: ISSUE_AGGREGATOR_SYSTEM_PROMPT,
@@ -4425,7 +4694,7 @@ ${JSON.stringify(checks.map((c) => ({ name: c.name, status: c.status, summary: c
 // src/commands/journey.ts
 import { writeFileSync as writeFileSync6 } from "node:fs";
 import { join as join7 } from "node:path";
-import chalk5 from "chalk";
+import chalk6 from "chalk";
 import ora2 from "ora";
 
 // src/llm/pick-plp.ts
@@ -5655,7 +5924,7 @@ var CRITICAL_STEPS = new Set([
 async function journeyCommand(opts) {
   const viewports = opts.viewports.split(",").map((s) => s.trim()).filter((s) => s === "mobile" || s === "desktop");
   if (viewports.length === 0) {
-    console.error(chalk5.red("Nenhum viewport válido (use mobile,desktop)"));
+    console.error(chalk6.red("Nenhum viewport válido (use mobile,desktop)"));
     return 2;
   }
   const rc = loadParityRc();
@@ -5665,13 +5934,13 @@ async function journeyCommand(opts) {
   const runId = newRunId();
   const paths = createRunDir(opts.output, runId);
   if (!opts.json) {
-    console.log(chalk5.bold(`
+    console.log(chalk6.bold(`
   parity journey ${runId}`));
-    console.log(chalk5.dim(`  prod: ${opts.prod}`));
-    console.log(chalk5.dim(`  cand: ${opts.cand}`));
-    console.log(chalk5.dim(`  viewports: ${viewports.join(", ")} · CEP: ${rc.cep}`));
+    console.log(chalk6.dim(`  prod: ${opts.prod}`));
+    console.log(chalk6.dim(`  cand: ${opts.cand}`));
+    console.log(chalk6.dim(`  viewports: ${viewports.join(", ")} · CEP: ${rc.cep}`));
     if (isLlmAvailable())
-      console.log(chalk5.dim(`  llm: ${providerLabel()}`));
+      console.log(chalk6.dim(`  llm: ${providerLabel()}`));
     console.log("");
   }
   let platform = "custom";
@@ -5715,15 +5984,15 @@ async function journeyCommand(opts) {
   const onStepFor = (viewport, side) => (event) => {
     if (opts.json)
       return;
-    const sideTag = side === "prod" ? chalk5.cyan("prod") : chalk5.magenta("cand");
-    const prefix = `  ${chalk5.dim(`[${viewport}/`)}${sideTag}${chalk5.dim("]")}`;
+    const sideTag = side === "prod" ? chalk6.cyan("prod") : chalk6.magenta("cand");
+    const prefix = `  ${chalk6.dim(`[${viewport}/`)}${sideTag}${chalk6.dim("]")}`;
     if (event.phase === "start") {
-      console.log(`${prefix} ${chalk5.dim(`${event.index}/${event.total}`)} ▶ ${chalk5.bold(stepLabel(event.name))}`);
+      console.log(`${prefix} ${chalk6.dim(`${event.index}/${event.total}`)} ▶ ${chalk6.bold(stepLabel(event.name))}`);
     } else {
-      const glyph = event.status === "ok" ? chalk5.green("✓") : event.status === "skipped" ? chalk5.yellow("○") : chalk5.red("✗");
-      const noteText = event.note ? chalk5.dim(` (${event.note})`) : "";
-      const time = chalk5.dim(`${(event.durationMs / 1000).toFixed(1)}s`);
-      console.log(`${prefix} ${chalk5.dim(`${event.index}/${event.total}`)} ${glyph} ${stepLabel(event.name)} ${time}${noteText}`);
+      const glyph = event.status === "ok" ? chalk6.green("✓") : event.status === "skipped" ? chalk6.yellow("○") : chalk6.red("✗");
+      const noteText = event.note ? chalk6.dim(` (${event.note})`) : "";
+      const time = chalk6.dim(`${(event.durationMs / 1000).toFixed(1)}s`);
+      console.log(`${prefix} ${chalk6.dim(`${event.index}/${event.total}`)} ${glyph} ${stepLabel(event.name)} ${time}${noteText}`);
     }
   };
   async function runOneSide(browserInstance, viewport, side) {
@@ -5761,7 +6030,7 @@ async function journeyCommand(opts) {
     spinner?.succeed("Browser pronto");
     for (const viewport of viewports) {
       if (!opts.json)
-        console.log(chalk5.bold(`
+        console.log(chalk6.bold(`
   ── ${viewport} ─────────────────────────────────────────────`));
       const [prodCap, candCap] = await Promise.all([
         runOneSide(browser, viewport, "prod"),
@@ -5788,7 +6057,7 @@ async function journeyCommand(opts) {
     if (opts.junit) {
       writeFileSync6(opts.junit, buildJUnit(rows, failures), "utf8");
       if (!opts.json)
-        console.log(chalk5.dim(`  → JUnit XML: ${opts.junit}`));
+        console.log(chalk6.dim(`  → JUnit XML: ${opts.junit}`));
     }
     return failures.some((f) => f.critical) ? 1 : 0;
   } catch (err) {
@@ -5853,14 +6122,14 @@ function collectFailures(rows) {
 function printTable(viewports, rows) {
   console.log("");
   for (const viewport of viewports) {
-    console.log(chalk5.bold(`  [${viewport}]`));
+    console.log(chalk6.bold(`  [${viewport}]`));
     const vrows = rows.filter((r) => r.viewport === viewport);
     for (const r of vrows) {
       const label = STEP_LABELS[r.name] ?? r.name;
       const p = statusGlyph(r.prod?.status);
       const c = statusGlyph(r.cand?.status);
-      const status = r.prod?.status === "ok" && r.cand?.status !== "ok" ? chalk5.red("FAILED") : "";
-      const note = r.cand?.status === "failed" || r.cand?.status === "skipped" ? chalk5.dim(`(${r.cand?.note ?? r.cand?.status})`) : "";
+      const status = r.prod?.status === "ok" && r.cand?.status !== "ok" ? chalk6.red("FAILED") : "";
+      const note = r.cand?.status === "failed" || r.cand?.status === "skipped" ? chalk6.dim(`(${r.cand?.note ?? r.cand?.status})`) : "";
       console.log(`    ${label.padEnd(24)}  prod ${p}   cand ${c}   ${status} ${note}`);
     }
     console.log("");
@@ -5868,12 +6137,12 @@ function printTable(viewports, rows) {
 }
 function statusGlyph(status) {
   if (!status)
-    return chalk5.dim("—");
+    return chalk6.dim("—");
   if (status === "ok")
-    return chalk5.green("✓");
+    return chalk6.green("✓");
   if (status === "skipped")
-    return chalk5.yellow("○");
-  return chalk5.red("✗");
+    return chalk6.yellow("○");
+  return chalk6.red("✗");
 }
 function printSummary2(rows, failures, htmlPath) {
   const byViewport = new Map;
@@ -5884,25 +6153,25 @@ function printSummary2(rows, failures, htmlPath) {
       v.passed++;
     byViewport.set(r.viewport, v);
   }
-  console.log(chalk5.bold("  Summary:"));
+  console.log(chalk6.bold("  Summary:"));
   for (const [vp, { passed, total }] of byViewport) {
-    const stat = passed === total ? chalk5.green("✓") : chalk5.yellow(`${passed}/${total}`);
+    const stat = passed === total ? chalk6.green("✓") : chalk6.yellow(`${passed}/${total}`);
     console.log(`    ${vp.padEnd(8)} ${stat} steps em cand`);
   }
   if (failures.length > 0) {
     const crit = failures.filter((f) => f.critical).length;
     console.log("");
-    console.log(chalk5.red(`  ✗ ${failures.length} step(s) divergent(es) (${crit} crítico)`));
+    console.log(chalk6.red(`  ✗ ${failures.length} step(s) divergent(es) (${crit} crítico)`));
     for (const f of failures) {
-      const tag = f.critical ? chalk5.red("[critical]") : chalk5.yellow("[warn]");
+      const tag = f.critical ? chalk6.red("[critical]") : chalk6.yellow("[warn]");
       console.log(`    ${tag} [${f.viewport}] ${f.step}: ${f.reason}`);
     }
   } else {
     console.log("");
-    console.log(chalk5.green("  ✓ jornada completa em cand"));
+    console.log(chalk6.green("  ✓ jornada completa em cand"));
   }
   console.log("");
-  console.log(chalk5.dim(`  → ${htmlPath}`));
+  console.log(chalk6.dim(`  → ${htmlPath}`));
   console.log("");
 }
 function emitGithubAnnotations(failures) {
@@ -6130,23 +6399,23 @@ function escapeHtml(s) {
 }
 
 // src/commands/learned.ts
-import chalk6 from "chalk";
+import chalk7 from "chalk";
 function learnedStats() {
   const lib = loadLearned();
   const stats = statsFromLib(lib);
   if (stats.platforms.length === 0) {
-    console.log(chalk6.dim(`Biblioteca vazia: ${LEARNED_PATH}`));
-    console.log(chalk6.dim("Rode `parity run ...` em algum site para começar a popular."));
+    console.log(chalk7.dim(`Biblioteca vazia: ${LEARNED_PATH}`));
+    console.log(chalk7.dim("Rode `parity run ...` em algum site para começar a popular."));
     return 0;
   }
-  console.log(chalk6.bold(`
+  console.log(chalk7.bold(`
 learned-selectors stats (${LEARNED_PATH})
 `));
   for (const p of stats.platforms) {
-    console.log(`${chalk6.cyan(p.platform)}: ${p.activeSelectors} active · ${chalk6.dim(`${p.deprecatedSelectors} deprecated`)}`);
+    console.log(`${chalk7.cyan(p.platform)}: ${p.activeSelectors} active · ${chalk7.dim(`${p.deprecatedSelectors} deprecated`)}`);
     for (const top of p.topByKey) {
       const sr = `${(top.successRate * 100).toFixed(0)}%`;
-      console.log(`   ${chalk6.dim(top.key.padEnd(18))} ${chalk6.green(sr.padStart(4))}  ${chalk6.dim(`(${top.hosts} hosts)`)}  ${top.selector}`);
+      console.log(`   ${chalk7.dim(top.key.padEnd(18))} ${chalk7.green(sr.padStart(4))}  ${chalk7.dim(`(${top.hosts} hosts)`)}  ${top.selector}`);
     }
     console.log("");
   }
@@ -6156,7 +6425,7 @@ learned-selectors stats (${LEARNED_PATH})
 // src/commands/vitals.ts
 import { existsSync as existsSync7, readFileSync as readFileSync7, writeFileSync as writeFileSync7 } from "node:fs";
 import { join as join8 } from "node:path";
-import chalk7 from "chalk";
+import chalk8 from "chalk";
 import ora3 from "ora";
 
 // src/diff/vitals.ts
@@ -6306,10 +6575,10 @@ async function vitalsCommand(opts) {
   const runId = newRunId();
   const paths = createRunDir(opts.output, runId);
   const t0 = Date.now();
-  console.log(chalk7.bold(`
+  console.log(chalk8.bold(`
   parity vitals ${runId}`));
-  console.log(chalk7.dim(`  prod: ${opts.prod}`));
-  console.log(chalk7.dim(`  cand: ${opts.cand}`));
+  console.log(chalk8.dim(`  prod: ${opts.prod}`));
+  console.log(chalk8.dim(`  cand: ${opts.cand}`));
   const discoverSpinner = ora3("Descobrindo páginas…").start();
   const pagePaths = await discoverPagePaths2(opts.prod, opts);
   if (pagePaths.length === 0) {
@@ -6341,7 +6610,7 @@ async function vitalsCommand(opts) {
         completed++;
         const elapsed = ((Date.now() - t0) / 1000).toFixed(0);
         const etaSec = completed > 0 ? Math.round((Date.now() - t0) / completed * (total - completed) / 1000) : 0;
-        progress.text = `${completed}/${total} · ${elapsed}s · ETA ${etaSec}s · ${task.side === "prod" ? chalk7.cyan("prod") : chalk7.magenta("cand")} ${task.path} (${task.viewport})`;
+        progress.text = `${completed}/${total} · ${elapsed}s · ETA ${etaSec}s · ${task.side === "prod" ? chalk8.cyan("prod") : chalk8.magenta("cand")} ${task.path} (${task.viewport})`;
       }
     });
     progress.succeed(`${total} capture(s) em ${((Date.now() - t0) / 1000).toFixed(1)}s`);
@@ -6414,8 +6683,8 @@ async function vitalsCommand(opts) {
 `, "utf8");
     printSummary3(vitalsResult, cacheResult);
     console.log("");
-    console.log(chalk7.dim(`  → ${paths.reportHtml}`));
-    console.log(chalk7.dim(`  \uD83D\uDCA1 use 'parity serve ${runId}' pra preview iframe`));
+    console.log(chalk8.dim(`  → ${paths.reportHtml}`));
+    console.log(chalk8.dim(`  \uD83D\uDCA1 use 'parity serve ${runId}' pra preview iframe`));
     console.log("");
     if (opts.open) {
       const { default: open } = await import("open");
@@ -6543,27 +6812,27 @@ function computeVerdict2(checks, issues) {
 }
 function printSummary3(vitals, cache) {
   console.log("");
-  console.log(chalk7.bold("  Summary:"));
+  console.log(chalk8.bold("  Summary:"));
   console.log(`    ${vitals.summary}`);
   console.log(`    ${cache.summary}`);
 }
 
 // src/commands/list.ts
-import chalk8 from "chalk";
+import chalk9 from "chalk";
 function listCommand(output) {
   const runs = listRuns(output);
   if (runs.length === 0) {
-    console.log(chalk8.dim(`Nenhum run salvo em ${output}`));
+    console.log(chalk9.dim(`Nenhum run salvo em ${output}`));
     return 0;
   }
   for (const r of runs) {
     try {
       const run = loadRun(output, r.id);
       const v = run.verdict;
-      const status = v.status === "pass" ? chalk8.green(v.status) : v.status === "warn" ? chalk8.yellow(v.status) : chalk8.red(v.status);
-      console.log(`  ${chalk8.bold(r.id)}  ${status}  score=${v.score}  critical=${v.critical} high=${v.high}  ${chalk8.dim(r.timestamp)}`);
+      const status = v.status === "pass" ? chalk9.green(v.status) : v.status === "warn" ? chalk9.yellow(v.status) : chalk9.red(v.status);
+      console.log(`  ${chalk9.bold(r.id)}  ${status}  score=${v.score}  critical=${v.critical} high=${v.high}  ${chalk9.dim(r.timestamp)}`);
     } catch {
-      console.log(`  ${chalk8.bold(r.id)}  ${chalk8.dim("(report.json ausente)")}`);
+      console.log(`  ${chalk9.bold(r.id)}  ${chalk9.dim("(report.json ausente)")}`);
     }
   }
   return 0;
@@ -6571,13 +6840,13 @@ function listCommand(output) {
 
 // src/commands/prompt.ts
 import { existsSync as existsSync8, writeFileSync as writeFileSync8 } from "node:fs";
-import chalk9 from "chalk";
+import chalk10 from "chalk";
 function promptCommand(runId, opts) {
   let run;
   try {
     run = loadRun(opts.output, runId);
   } catch (err) {
-    console.error(chalk9.red(`✖ ${err.message}`));
+    console.error(chalk10.red(`✖ ${err.message}`));
     return 1;
   }
   const md = buildLlmPrompt(run, {
@@ -6586,10 +6855,10 @@ function promptCommand(runId, opts) {
   });
   if (opts.out) {
     writeFileSync8(opts.out, md, "utf8");
-    console.log(chalk9.green(`✔ prompt salvo em ${opts.out}`));
+    console.log(chalk10.green(`✔ prompt salvo em ${opts.out}`));
     if (existsSync8(opts.out)) {
       const sizeKb = (md.length / 1024).toFixed(1);
-      console.log(chalk9.dim(`  ${md.length} chars (${sizeKb} KB)`));
+      console.log(chalk10.dim(`  ${md.length} chars (${sizeKb} KB)`));
     }
   } else {
     process.stdout.write(md);
@@ -6598,20 +6867,20 @@ function promptCommand(runId, opts) {
 }
 
 // src/commands/report.ts
-import chalk10 from "chalk";
+import chalk11 from "chalk";
 import open from "open";
 async function reportCommand(runId, output) {
   const paths = getRunPaths(output, runId);
-  console.log(chalk10.dim(`opening ${paths.reportHtml}`));
+  console.log(chalk11.dim(`opening ${paths.reportHtml}`));
   await open(paths.reportHtml).catch((err) => {
-    console.error(chalk10.red(`failed to open: ${err.message}`));
+    console.error(chalk11.red(`failed to open: ${err.message}`));
   });
   return 0;
 }
 
 // src/commands/run.ts
 import { join as join11 } from "node:path";
-import chalk12 from "chalk";
+import chalk13 from "chalk";
 import ora4 from "ora";
 
 // src/checks/http-status.ts
@@ -7466,11 +7735,49 @@ function purchaseJourneyFlow(ctx) {
   let totalSteps = 0;
   let failedSteps = 0;
   let asymmetricSkips = 0;
+  const hasAnyPurchaseFlow = ctx.prodFlows.some((f) => f.flow === "purchase-journey") || ctx.candFlows.some((f) => f.flow === "purchase-journey");
+  if (!hasAnyPurchaseFlow) {
+    return {
+      name: "purchase-journey-flow",
+      status: "skipped",
+      severity: "critical",
+      durationMs: Date.now() - start,
+      summary: "purchase-journey não estava no escopo do run (sem captura de flow)",
+      issues: [],
+      data: { totalSteps: 0, failedSteps: 0, asymmetricSkips: 0 }
+    };
+  }
   for (const viewport of ctx.viewports) {
     const prodFlow = findFlow(ctx.prodFlows, viewport);
     const candFlow = findFlow(ctx.candFlows, viewport);
-    if (!prodFlow || !candFlow)
+    if (!prodFlow || !candFlow) {
+      if (prodFlow && !candFlow) {
+        issues.push({
+          id: `pj:${viewport}:missing-cand-flow`,
+          severity: "critical",
+          category: "functional",
+          check: "purchase-journey-flow",
+          summary: `[${viewport}] cand não produziu captura da purchase-journey (prod produziu) — checkout indisponível ou cliente nunca hidratou`
+        });
+      } else if (!prodFlow && candFlow) {
+        issues.push({
+          id: `pj:${viewport}:missing-prod-flow`,
+          severity: "high",
+          category: "functional",
+          check: "purchase-journey-flow",
+          summary: `[${viewport}] prod não produziu captura da purchase-journey — selectors podem estar desalinhados com a source-of-truth`
+        });
+      } else {
+        issues.push({
+          id: `pj:${viewport}:no-flow-either-side`,
+          severity: "critical",
+          category: "functional",
+          check: "purchase-journey-flow",
+          summary: `[${viewport}] purchase-journey foi requisitada mas não há captura em prod nem cand — flow falhou completamente`
+        });
+      }
       continue;
+    }
     const prodSteps = indexBy(prodFlow.steps ?? [], (s) => s.name);
     const candSteps = indexBy(candFlow.steps ?? [], (s) => s.name);
     const allNames = new Set([...prodSteps.keys(), ...candSteps.keys()]);
@@ -7518,6 +7825,15 @@ function purchaseJourneyFlow(ctx) {
       } else if (p.status === "skipped" && c.status === "ok") {}
     }
   }
+  if (totalSteps === 0 && issues.length === 0) {
+    issues.push({
+      id: "pj:zero-steps-evaluated",
+      severity: "critical",
+      category: "functional",
+      check: "purchase-journey-flow",
+      summary: "purchase-journey rodou mas avaliou 0 step(s) — capturas existem mas estão vazias dos dois lados (selectors quebrados ou home não hidratou)"
+    });
+  }
   const status = issues.some((i) => i.severity === "critical") ? "fail" : issues.length > 0 ? "warn" : "pass";
   return {
     name: "purchase-journey-flow",
@@ -8858,7 +9174,7 @@ cand: ${JSON.stringify(cand)}`,
 
 // src/commands/serve.ts
 import { existsSync as existsSync11 } from "node:fs";
-import chalk11 from "chalk";
+import chalk12 from "chalk";
 
 // src/server/proxy-server.ts
 import { existsSync as existsSync10, readFileSync as readFileSync10, statSync } from "node:fs";
@@ -9078,16 +9394,16 @@ async function serveRunAndBlock(runDir, opts = {}) {
   try {
     handle = await startProxyServer(runDir, { port: opts.port });
   } catch (err) {
-    console.error(chalk11.red(`  ✖ Falha ao iniciar servidor: ${err.message}`));
+    console.error(chalk12.red(`  ✖ Falha ao iniciar servidor: ${err.message}`));
     return 2;
   }
   const label = opts.label ?? "parity serve";
   console.log("");
-  console.log(chalk11.bold(`  ${label}`));
-  console.log(`  ${chalk11.green("●")} ${handle.url}`);
-  console.log(chalk11.dim(`  Servindo: ${runDir}`));
-  console.log(chalk11.dim(`  Proxy de iframes: ${handle.url}proxy?url=<encoded>`));
-  console.log(chalk11.dim(`  Ctrl+C pra parar (2x pra forçar saída).
+  console.log(chalk12.bold(`  ${label}`));
+  console.log(`  ${chalk12.green("●")} ${handle.url}`);
+  console.log(chalk12.dim(`  Servindo: ${runDir}`));
+  console.log(chalk12.dim(`  Proxy de iframes: ${handle.url}proxy?url=<encoded>`));
+  console.log(chalk12.dim(`  Ctrl+C pra parar (2x pra forçar saída).
 `));
   if (opts.open !== false) {
     const { default: open2 } = await import("open");
@@ -9120,11 +9436,11 @@ async function serveRunAndBlock(runDir, opts = {}) {
 async function serveCommand(runId, opts) {
   const paths = getRunPaths(opts.output, runId);
   if (!existsSync11(paths.runDir)) {
-    console.error(chalk11.red(`✖ Run não encontrado: ${runId} (em ${opts.output})`));
+    console.error(chalk12.red(`✖ Run não encontrado: ${runId} (em ${opts.output})`));
     return 1;
   }
   if (!existsSync11(paths.reportHtml)) {
-    console.error(chalk11.red(`✖ report.html não existe em ${paths.runDir}`));
+    console.error(chalk12.red(`✖ report.html não existe em ${paths.runDir}`));
     return 1;
   }
   return serveRunAndBlock(paths.runDir, {
@@ -9184,7 +9500,7 @@ function applyPreset(opts) {
 async function runCommand(rawOpts) {
   const opts = applyPreset(rawOpts);
   if (rawOpts.preset) {
-    console.log(chalk12.dim(`  preset: ${rawOpts.preset}`));
+    console.log(chalk13.dim(`  preset: ${rawOpts.preset}`));
   }
   const flows = opts.flows.split(",").map((s) => s.trim());
   const viewports = opts.viewports.split(",").map((s) => s.trim());
@@ -9194,11 +9510,11 @@ async function runCommand(rawOpts) {
   const ignore = loadParityIgnore();
   const preflight = await preflightCheck(opts.prod, opts.cand);
   if (!preflight.ok) {
-    console.error(chalk12.red(`
+    console.error(chalk13.red(`
   ✖ pre-flight falhou:`));
     for (const err of preflight.errors)
-      console.error(chalk12.red(`    - ${err}`));
-    console.error(chalk12.dim(`
+      console.error(chalk13.red(`    - ${err}`));
+    console.error(chalk13.dim(`
   dica: verifique se as URLs estão corretas e acessíveis`));
     return 2;
   }
@@ -9209,7 +9525,7 @@ async function runCommand(rawOpts) {
   if (prodHomeHtml) {
     platform = detectPlatform({ url: opts.prod, html: prodHomeHtml });
     if (platform !== "custom") {
-      console.log(chalk12.dim(`  Detected platform: ${platform}`));
+      console.log(chalk13.dim(`  Detected platform: ${platform}`));
     }
   }
   const prodHost = hostOf(opts.prod);
@@ -9251,11 +9567,11 @@ async function runCommand(rawOpts) {
   const paths = createRunDir(opts.output, runId);
   const startedAt = Date.now();
   const timestamp = new Date().toISOString();
-  console.log(chalk12.bold(`
+  console.log(chalk13.bold(`
   parity run ${runId}`));
-  console.log(chalk12.dim(`  prod: ${opts.prod}`));
-  console.log(chalk12.dim(`  cand: ${opts.cand}`));
-  console.log(chalk12.dim(`  flows: ${flows.join(", ")} · viewports: ${viewports.join(", ")} · CEP: ${rc.cep}
+  console.log(chalk13.dim(`  prod: ${opts.prod}`));
+  console.log(chalk13.dim(`  cand: ${opts.cand}`));
+  console.log(chalk13.dim(`  flows: ${flows.join(", ")} · viewports: ${viewports.join(", ")} · CEP: ${rc.cep}
 `));
   const spinner = ora4("Launching browser…").start();
   let browser = null;
@@ -9569,7 +9885,7 @@ async function runCommand(rawOpts) {
     if (opts.ci) {
       const blocking = allIssues.filter((i) => failOn.includes(i.severity));
       if (blocking.length > 0) {
-        console.log(chalk12.red(`
+        console.log(chalk13.red(`
   ✖ ${blocking.length} issue(s) bloqueante(s) [${failOn.join(", ")}] — exit 1`));
         return 1;
       }
@@ -9708,26 +10024,26 @@ function hostOf(url) {
 }
 function printSummary4(run, htmlPath, meta) {
   const { verdict } = run;
-  const emoji = verdict.status === "pass" ? chalk12.green("✔") : verdict.status === "warn" ? chalk12.yellow("⚠") : chalk12.red("✖");
-  const score = verdict.status === "pass" ? chalk12.green(verdict.score) : verdict.status === "warn" ? chalk12.yellow(verdict.score) : chalk12.red(verdict.score);
+  const emoji = verdict.status === "pass" ? chalk13.green("✔") : verdict.status === "warn" ? chalk13.yellow("⚠") : chalk13.red("✖");
+  const score = verdict.status === "pass" ? chalk13.green(verdict.score) : verdict.status === "warn" ? chalk13.yellow(verdict.score) : chalk13.red(verdict.score);
   console.log("");
   console.log(`  ${emoji}  parity ${verdict.status.toUpperCase()} · score ${score}/100`);
-  console.log(`     checks: ${chalk12.green(verdict.checksPassed)} pass · ${chalk12.red(verdict.checksFailed)} fail · ${chalk12.dim(`${verdict.checksSkipped} skipped`)}`);
-  console.log(`     issues: ${chalk12.red(verdict.critical)} critical · ${chalk12.yellow(verdict.high)} high · ${verdict.medium} medium · ${chalk12.dim(`${verdict.low} low`)}`);
+  console.log(`     checks: ${chalk13.green(verdict.checksPassed)} pass · ${chalk13.red(verdict.checksFailed)} fail · ${chalk13.dim(`${verdict.checksSkipped} skipped`)}`);
+  console.log(`     issues: ${chalk13.red(verdict.critical)} critical · ${chalk13.yellow(verdict.high)} high · ${verdict.medium} medium · ${chalk13.dim(`${verdict.low} low`)}`);
   if (run.topIssues.length > 0) {
     console.log("");
-    console.log(chalk12.bold("  Top issues:"));
+    console.log(chalk13.bold("  Top issues:"));
     for (const i of run.topIssues.slice(0, 5)) {
-      const sev = i.severity === "critical" ? chalk12.red(`[${i.severity}]`) : i.severity === "high" ? chalk12.yellow(`[${i.severity}]`) : chalk12.dim(`[${i.severity}]`);
+      const sev = i.severity === "critical" ? chalk13.red(`[${i.severity}]`) : i.severity === "high" ? chalk13.yellow(`[${i.severity}]`) : chalk13.dim(`[${i.severity}]`);
       console.log(`     ${sev} ${i.summary}`);
     }
   }
   if (meta.promotedCount > 0 || meta.deprecatedCount > 0) {
     console.log("");
-    console.log(chalk12.dim(`  \uD83D\uDCDA learned-selectors [${meta.platform}]: ${chalk12.green(`+${meta.promotedCount}`)} promoted · ${chalk12.yellow(meta.deprecatedCount)} deprecated`));
+    console.log(chalk13.dim(`  \uD83D\uDCDA learned-selectors [${meta.platform}]: ${chalk13.green(`+${meta.promotedCount}`)} promoted · ${chalk13.yellow(meta.deprecatedCount)} deprecated`));
   }
   console.log("");
-  console.log(chalk12.dim(`  → ${htmlPath}`));
+  console.log(chalk13.dim(`  → ${htmlPath}`));
   console.log("");
 }
 
@@ -9777,6 +10093,18 @@ program.command("prompt").argument("<runId>", "Run ID").description("Generate a
 program.command("explain").argument("<runId>", "Run ID").argument("<issueId>", "Issue ID").option("--output <dir>", "Output directory", "./parity-output").description("LLM deep-dive on a specific issue (requires ANTHROPIC_API_KEY)").action(async (runId, issueId, opts) => {
   process.exit(await explainCommand(runId, issueId, opts.output));
 });
+program.command("css-trace").description("Inspect which CSS rules (from which stylesheets) are affecting a DOM element. Single URL mode lists every matched rule; --prod + --cand mode diffs computed styles between Fresh and TanStack sides.").option("--url <url>", "Single URL to inspect (mutually exclusive with --prod/--cand)").option("--prod <url>", "Production URL (for comparison mode)").option("--cand <url>", "Candidate URL (for comparison mode)").requiredOption("--selector <sel>", "CSS selector for the target element (e.g. 'html', '[data-aside]', '.drawer-side')").option("--filter <props>", "Comma-separated property names to focus on (e.g. 'scrollbar-gutter,position,width')").option("--viewport <viewport>", "mobile, tablet, or desktop", "desktop").option("--settle <ms>", "Wait this many ms after `load` for hydration", (v) => Number(v), 1500).option("--json", "Output JSON instead of pretty text", false).action(async (opts) => {
+  process.exit(await cssTraceCommand({
+    url: opts.url,
+    prod: opts.prod,
+    cand: opts.cand,
+    selector: opts.selector,
+    filter: opts.filter,
+    viewport: opts.viewport,
+    settleMs: opts.settle,
+    json: opts.json
+  }));
+});
 program.command("learned").description("Inspect the learned-selectors library").addCommand(new Command("stats").description("Print learned-selectors stats per platform").action(() => {
   process.exit(learnedStats());
 }));

package/package.json

@@ -1,87 +1,87 @@
 {
-  "name": "@decocms/parity",
-  "version": "0.1.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",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/decocms/parity.git"
-  },
-  "homepage": "https://github.com/decocms/parity#readme",
-  "bugs": {
-    "url": "https://github.com/decocms/parity/issues"
-  },
-  "keywords": [
-    "deco",
-    "tanstack",
-    "fresh",
-    "migration",
-    "e2e",
-    "playwright",
-    "web-vitals",
-    "visual-regression",
-    "visual-diff",
-    "llm",
-    "claude",
-    "anthropic",
-    "cli",
-    "parity",
-    "regression-testing"
-  ],
-  "bin": {
-    "parity": "./dist/cli.js"
-  },
-  "files": [
-    "dist",
-    "README.md",
-    "AGENTS.md",
-    "CHANGELOG.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "dev": "bun run --hot src/cli.ts",
-    "build": "bun build src/cli.ts --target=node --outfile=dist/cli.js --packages=external && bun run scripts/postbuild.ts",
-    "check": "tsc --noEmit",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "test:e2e": "vitest run tests/e2e",
-    "deadcode": "knip",
-    "lint": "biome lint .",
-    "fmt": "biome format --write .",
-    "prepublishOnly": "bun run check && bun run build"
-  },
-  "engines": {
-    "node": ">=20",
-    "bun": ">=1.1"
-  },
-  "dependencies": {
-    "@anthropic-ai/sdk": "^0.40.0",
-    "chalk": "^5.3.0",
-    "cheerio": "^1.0.0",
-    "commander": "^12.1.0",
-    "open": "^10.1.0",
-    "ora": "^8.1.1",
-    "pixelmatch": "^6.0.0",
-    "playwright": "^1.49.0",
-    "pngjs": "^7.0.0",
-    "zod": "^3.24.1"
-  },
-  "devDependencies": {
-    "@biomejs/biome": "^1.9.4",
-    "@types/node": "^22.10.0",
-    "@types/pixelmatch": "^5.2.6",
-    "@types/pngjs": "^6.0.5",
-    "@vitest/coverage-v8": "^2.1.8",
-    "knip": "^6.13.1",
-    "typescript": "^5.7.2",
-    "vitest": "^2.1.8"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "trustedDependencies": [
-    "@biomejs/biome"
-  ]
+	"name": "@decocms/parity",
+	"version": "0.2.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",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/decocms/parity.git"
+	},
+	"homepage": "https://github.com/decocms/parity#readme",
+	"bugs": {
+		"url": "https://github.com/decocms/parity/issues"
+	},
+	"keywords": [
+		"deco",
+		"tanstack",
+		"fresh",
+		"migration",
+		"e2e",
+		"playwright",
+		"web-vitals",
+		"visual-regression",
+		"visual-diff",
+		"llm",
+		"claude",
+		"anthropic",
+		"cli",
+		"parity",
+		"regression-testing"
+	],
+	"bin": {
+		"parity": "dist/cli.js"
+	},
+	"files": [
+		"dist",
+		"README.md",
+		"AGENTS.md",
+		"CHANGELOG.md",
+		"LICENSE"
+	],
+	"scripts": {
+		"dev": "bun run --hot src/cli.ts",
+		"build": "bun build src/cli.ts --target=node --outfile=dist/cli.js --packages=external && bun run scripts/postbuild.ts",
+		"check": "tsc --noEmit",
+		"test": "vitest run",
+		"test:watch": "vitest",
+		"test:coverage": "vitest run --coverage",
+		"test:e2e": "vitest run tests/e2e",
+		"deadcode": "knip",
+		"lint": "biome lint .",
+		"fmt": "biome format --write .",
+		"prepublishOnly": "bun run check && bun run build"
+	},
+	"engines": {
+		"node": ">=20",
+		"bun": ">=1.1"
+	},
+	"dependencies": {
+		"@anthropic-ai/sdk": "^0.40.0",
+		"chalk": "^5.3.0",
+		"cheerio": "^1.0.0",
+		"commander": "^12.1.0",
+		"open": "^10.1.0",
+		"ora": "^8.1.1",
+		"pixelmatch": "^6.0.0",
+		"playwright": "^1.49.0",
+		"pngjs": "^7.0.0",
+		"zod": "^3.24.1"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "^1.9.4",
+		"@types/node": "^22.10.0",
+		"@types/pixelmatch": "^5.2.6",
+		"@types/pngjs": "^6.0.5",
+		"@vitest/coverage-v8": "^2.1.8",
+		"knip": "^6.13.1",
+		"typescript": "^5.7.2",
+		"vitest": "^2.1.8"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"trustedDependencies": [
+		"@biomejs/biome"
+	]
 }