Theme Check

Análise ampliada de qualidade do tema — diagnósticos estruturados, regras, configuração e CI.

corvex check complementa corvex validate com diagnósticos estruturados de qualidade e boas práticas.

Comando	Papel
corvex validate	Contrato obrigatório (manifest, schemas, templates, estrutura)
corvex check	Validate + SDK, JSX, acessibilidade estática, performance, schema experimental

Os dois usam os mesmos contratos públicos. Uma mesma infração produz o mesmo ruleId, severidade e mensagem na CLI e no MCP.

Uso

corvex check .
corvex check . --json
corvex check . --list
corvex check . --severity warning
corvex check . --fix --dry-run
corvex check . --config ./corvex.check.json

Não exige autenticação nem loja.

Flags

Flag	Efeito
--json	Só JSON no stdout (adequado a CI e agentes)
--fix	Autocorreções seguras (BOM/newline em JSON)
--dry-run	Com --fix, lista o que seria alterado
--list	Lista regras oficiais
--severity / --fail-on	error (default), warning ou info
--config	Caminho de corvex.check.json
--path / --theme	Raiz do tema
--watch	Reexecuta ao salvar
--verbose	Logs extras (em --json, vão para stderr)

Exit codes

• 0 — passou segundo failOn (default: sem error)
• 1 — falhou segundo failOn

Warnings sozinhos não falham o CI com o default.

Diagnóstico

Cada item inclui ruleId, severity, file, line/column quando disponíveis, message, suggestion, docsUrl, fixable e contractVersion.

{
  "ruleId": "CVX-SCHEMA-001",
  "severity": "error",
  "file": "sections/hero/schema.json",
  "message": "Tipo de configuração não suportado: \"warp\".",
  "suggestion": "Utilize um tipo previsto no contrato público.",
  "fixable": false
}

Taxonomia de regras

Prefixos oficiais:

Prefixo	Categoria
CVX-CONTRACT-*	Resultado do validador oficial
CVX-SCHEMA-*	Tipos de setting (desconhecido / experimental)
CVX-SDK-*	Imports do SDK / runtime
CVX-JSX-*	Sintaxe e export default de section/block
CVX-A11Y-*	Acessibilidade estática (parcial)
CVX-PERF-*	Heurísticas de performance
CVX-CONFIG-*	Configuração do próprio check

Rode corvex check --list para a lista completa.

Configuração

Arquivo opcional na raiz do tema: corvex.check.json.

{
  "version": 1,
  "failOn": "error",
  "ignore": [".corvex/**", "node_modules/**"],
  "categories": {
    "contract": true,
    "schema": true,
    "sdk": true,
    "jsx": true,
    "a11y": true,
    "performance": true
  },
  "rules": {
    "CVX-A11Y-001": "warning"
  },
  "performance": {
    "maxAssetBytes": 524288
  }
}

Desligar uma regra: "CVX-PERF-001": "off" ou false.

Autocorreção

--fix só aplica transformações determinísticas (hoje: remover BOM UTF-8 e garantir newline final em JSON de schema/config). Não altera carrinho, preço, checkout nem hooks com efeito colateral.

Acessibilidade e performance

As regras de a11y são estáticas e parciais — não são auditoria WCAG completa. Condições que dependem de renderização exigem análise dinâmica.

Performance usa limiares de tamanho de asset; classificadas como warning.

CI

corvex check . --json

Use --severity warning se quiser falhar também em avisos.