Visão geral do parity

@decocms/parity é uma CLI baseada em Playwright com dois trabalhos numa migração:

Capturar — aponte para a URL de uma loja no ar e ela extrai tema, fontes, logo/ícones, o HTML de cada componente (+ Tailwind sugerido + seletores de e2e) e, no caso do VTEX IO, a árvore de blocos real e o conteúdo do CMS, num bundle enxuto em tokens e pronto para agente.
Validar — dê duas URLs (prod = fonte da verdade, cand = o site migrado) e ela reporta regressões de UI, funcionais, de SEO, performance, console, rede e cache, num relatório priorizado por LLM.

A captura funciona com ou sem o código-fonte — ela lê a página renderizada. É o jeito mais rápido de começar uma migração de uma loja da qual você só tem a URL.

Instalação

# Global (instala o Chromium do Playwright na primeira execução)
npm i -g @decocms/parity
 
# Ou rode sem instalar
npx @decocms/parity run --prod https://old.com --cand https://new.dev --preset smoke --open

Defina ANTHROPIC_API_KEY (ou OPENROUTER_API_KEY) para habilitar as passagens com LLM (priorização de issues, diff semântico visual, descoberta de seletores). Tudo degrada graciosamente sem chave — veja Configuração.

As famílias de comando

Família	Comandos	Use para…
Validar (prod × cand)	`run`, `journey`, `pr`, `compare`	Comparar um site migrado com o original e barrar um PR.
Pixel-perfect	`fix`, `section`	Diferenciar uma seção (screenshots + heatmap + estilos computados) num bundle pronto para LLM.
Performance	`vitals`, `cache`	Comparar Web Vitals / cobertura de cache em muitas páginas.
Site único	`e2e`, `audit`	Validar UM site de ponta a ponta (sem baseline).
Captura	`migrate`, `extract`	Extrair uma loja num bundle de migração/agente.
Inspecionar	`css-trace`, `console`, `html`, `check`	Sondagens pontuais em menos de 10s.
Gerenciar	`serve`, `report`, `baseline`, `list`, `prompt`, `explain`, `learned`	Trabalhar com execuções salvas + artefatos.

Qual comando?

Duas URLs, "regrediu alguma coisa?" → parity run (--preset smoke primeiro, depois --preset full).
Uma seção está estranha → parity fix (diff de pixel + heatmap + prompt).
Só interessa SEO / vitals / cache / DOM → parity run --only seo (ou vitals/cache/html) — veja Execuções focadas.
Uma URL no ar, "funciona?" → parity e2e.
Reconstruir uma loja a partir de uma URL → parity migrate.
Em CI → parity pr / parity journey.

Instalação

As famílias de comando

Qual comando?

Veja também