Git Hooks - Segurança de Commits

Versão: 3.2.0 | Última atualização: 2026-03-25

Os hooks do git garantem que nenhum pacote quebrado seja publicado no npm.

🔐 O que é verificado

Pre-commit Hook (.husky/pre-commit)

Antes de cada commit, o hook verifica:

1. ✅ Integridade do pacote npm

   • Testa se npm pack --dry-run funciona
   • Verifica se há arquivos no pacote

2. ✅ Arquivos essenciais

   • install.js (CLI principal)
   • lib/core.cjs e outros módulos
   • package.json (válido)

3. ✅ Diretórios obrigatórios

   • agentes/ (12 agent definitions)
   • comandos/ (32 command definitions)

🚀 Instalação

Os hooks são instalados automaticamente ao instalar dependências:

npm install
npm run prepare

🧪 Testar os hooks

Para verificar manualmente se tudo está correto:

cd bin
npm pack --dry-run

# Ou use o script:
npm run verificar

⚠️ Contornar hooks (não recomendado)

Se você realmente precisa ignorar um hook:

git commit --no-verify

⚠️ Use apenas em emergências! Commits sem verificação podem quebrar a publicação.

📚 Referência

• Husky - Git Hooks Simplificado
• Git Hooks Nativos

🆘 Troubleshooting

Hook não está rodando

# Reinstalar hooks
npx husky install

Permissão negada ao executar

# Garantir que o hook é executável
chmod +x .husky/pre-commit

Hook falha mas quero commitar mesmo

Consulte ⚠️ acima, mas first:

1. Abra uma issue descrevendo o problema
2. Execute npm pack --dry-run para ver o erro real