Sobre o projeto

regress-guard é um plugin de governança de codificação por IA voltado para o ZCode, cuja premissa central é 'não confiar na declaração de conclusão do agente'. Ele reexecuta a própria suíte de testes do projeto no momento do commit, transformando 'concluído' em uma declaração verificável por máquina. As principais capacidades incluem: 1. Revisão de conclusão: o hook PreToolUse intercepta comandos de commit e executa os testes do projeto de forma autônoma (detecção automática de pytest/jest/maven/gradle/go). Linhas de aceitação no estilo EARS só podem ser marcadas como concluídas mediante evidência. Retries na mesma árvore utilizam cache por chave de conteúdo, permitindo liberação em 0 segundos. 2. Guarda de limites: intercepta previamente operações de edição/escrita em arquivos não declarados na lista de mudanças atual; a lista de arquivos do plano serve como o limite. 3. Registro de premissas: quando a realidade refuta uma premissa do plano, é exigido o registro obrigatório da cadeia was→reality→evidence. 4. Superfície de confiança em seis camadas: canais de notificação no nível do projeto exigem tabela de confiança autorizada manualmente + fixação de conteúdo; injeções via HOME/env são neutralizadas na lista de permissões do inicializador; a superfície de injeção por repositório clonado está fechada. 5. Telemetria de calibração de FP: cada interceptação é julgada posteriormente por um humano (útil/falso positivo/ignorado); o agente não tem direito de voto sobre sua própria precisão. O benchmark público contém 82 casos de teste / 13 famílias. 6. Autocura: na inicialização da sessão, compara a cópia instalada com o repositório de origem; desvios de versão são anunciados em vez de silenciosamente tolerados. A instalação pode ser feita via marketplace de plugins do ZCode, repositório pessoal (github:1339190177/regress-guard) ou via de desenvolvimento (clone seguido de bash install.sh). Em tempo de execução, não há dependências de Python de terceiros, exigindo apenas Python 3.10+. Oferece 16 comandos (/regress:init, /regress:plan, /regress:verify, /regress:bypass, etc.), cobrindo cenários como inicialização, geração de planos, verificação de testes, geração de testes de características, retomada de pontos de interrupção e relatórios de saúde. O status do projeto e os dados arqueológicos são armazenados no diretório .regress/. Por padrão, não há tráfego de saída de rede; notificações opcionais via aplicativo autogerenciado do WeChat corporativo (exigindo autorização manual e fixação da URL base da API no domínio oficial). Licença MIT.