accesslint-diff

Quando Usar

• Compare os achados de acessibilidade de uma página solicitada entre revisões base e candidatas verificadas.
• Relate achados introduzidos, corrigidos e ainda presentes sem alterar o código-fonte da aplicação.

1. Estabelecer Snapshots Isolados

Este pacote não inclui a CLI ou o navegador. Verifique primeiro o esquema da ferramenta instalada atualmente ou uma versão de pacote fixada revisada. Não avalie $ARGUMENTS ou texto de branch/URL como sintaxe de shell.

1. Resolva a base e o head solicitados para SHAs de commit completos; identifique se conteúdo staged, unstaged ou untracked pertence ao candidato.
2. Preserve o checkout do usuário. Prefira worktrees isolados ou snapshots recuperáveis para base e candidato; não altere o branch deles nem desfaça um stash não relacionado. Um modo de branch comparando apenas HEADs commitados deve divulgar alterações locais excluídas.
3. Use o lockfile revisado e o procedimento de build autorizado de cada revisão. Sirva base e candidato em portas locais separadas, espere por um seletor de pronto determinístico e verifique qual revisão cada página realmente serve. Um sleep fixo não é uma verificação de prontidão.
4. Audite URLs correspondentes, estado da conta, viewport, seletores, versão do engine e configuração de regras. Mantenha snapshots privados em um diretório novo apenas para o proprietário, não em um arquivo /tmp compartilhado e previsível. Capture a linha de base e o candidato usando as flags reais da CLI suportadas; não invente comandos quando a integração não estiver disponível.
5. Compare achados e inspecione o desvio de seletores ou conteúdo removido. Registre estados inacessíveis e verificações manuais WCAG separadamente. Nunca prometa restauração completa sem verificar o status e o conteúdo dos arquivos.

2. Relatar

Accessibility diff — http://localhost:3000/ vs main (94 rules, live DOM)
2 new · 1 fixed · 4 pre-existing hidden

New — Critical
- color-contrast — 2.1:1 (needs 4.5:1), #bbb on #fff
    where: main > p.subtitle   fix: darken to #767676
Fixed
- img-alt — <img src="old.jpg"> (no longer present)

Cada nova violação: onde (seletor exato + file:line (symbol) se source presente — nunca fabrique), evidência, correção (alteração mecânica ou NEEDS HUMAN).

Não edite. Para uma solicitação de correção explicitamente autorizada, use o procedimento accesslint-audit disponível e verifique com a mesma linha de base controlada. Esta habilidade apenas de relatar não autoriza uma transferência separada para outro agente.

3. Desmontar

Feche apenas processos de navegador, servidores e snapshots criados para esta execução. Preserve sessões pré-existentes e trabalho recuperável. Remova um worktree isolado apenas após a evidência necessária ter sido salva; nunca use um comando global de parada do navegador para limpeza.

Armadilhas

• A saída de diff é limitada a páginas/estados exercitados e às regras automatizadas selecionadas; não é uma certificação WCAG.
• Elementos removidos podem desaparecer de uma auditoria sem serem uma substituição acessível. Inspecione a jornada do usuário.
• Mudanças pesadas no DOM podem invalidar a correspondência de seletores; verifique elementos correspondentes ou execute auditorias completas de ambos os snapshots.
• Relate contagens de amostras ilustrativas como exemplos, não como medições.

Limitações

• Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.
• Não trate a saída como substituta para validação específica do ambiente, testes ou revisão de especialistas.
• Pare e peça esclarecimentos se os inputs, permissões, limites de segurança ou critérios de sucesso necessários estiverem ausentes.