Directorio: .githooks/

Los 2 git hooks del template. Se activan automáticamente en operaciones git para prevenir errores antes de que lleguen al repositorio.

Se instalan con git config core.hooksPath .githooks (normalmente incluido en el onboarding de cada stack).

---

pre-commit

Se dispara: En cada git commit, antes de que el commit se cree.
Bloquea el commit si: Encuentra errores de linting o credenciales hardcodeadas.

Flujo

git commit
    ↓
¿package.json? → Ejecutar Biome (linter/formatter Node.js)
¿pyproject.toml / requirements.txt? → Ejecutar Ruff (linter Python)
    ↓
Secrets scan: buscar patrones de credenciales en archivos staged
    ↓
¿Algún check falló? → Bloquear commit con mensaje de error

Linters que ejecuta

Condición	Linter	Comando
package.json existe	Biome	npx biome check --apply .
pyproject.toml o requirements.txt existe	Ruff	ruff check . && ruff format .

Patrones de secretos buscados

El hook escanea los archivos staged buscando:

Patrón	Detecta
ghp_[a-zA-Z0-9]{20,}	GitHub Personal Access Token
sk-[a-zA-Z0-9]{30,}	API key de OpenAI u otros
AKIA[A-Z0-9]{16}	AWS Access Key ID
api_key\s*=\s*['"]{20,}	API keys genéricas en código

Si encuentra algún patrón:

1. Bloquea el commit
2. Muestra el archivo y línea donde se encontró
3. Sugiere usar variables de entorno

Ejemplo de salida bloqueada

❌ Posible credencial encontrada en src/config.ts:
   sk-proj-abc123xyz...

   Usa variables de entorno en su lugar.
   Si es un falso positivo, usa: git commit --no-verify

---

pre-push

Se dispara: En cada git push, antes de enviar cambios al remoto.
Bloquea el push si: Los tests fallan.

Flujo

git push
    ↓
¿package.json con "test" script? → npm test
¿composer.json? → php artisan test --no-interaction
¿go.mod? → go test ./...
¿pyproject.toml / requirements.txt? → python -m pytest
    ↓
¿Tests fallaron? → Bloquear push

Frameworks detectados

Condición	Comando de test
package.json con script "test"	npm test
composer.json (Laravel)	php artisan test --no-interaction
go.mod	go test ./...
pyproject.toml o requirements.txt	python -m pytest

Si no se detecta ningún runner, el hook deja pasar el push.

Ejemplo de salida bloqueada

❌ Los tests fallaron. Push bloqueado.

   Corrige los tests antes de hacer push.
   Si necesitas forzar, usa: git push --no-verify

---

Instalación

git config core.hooksPath .githooks

Esto le dice a git que use .githooks/ en lugar del directorio estándar .git/hooks/. No se copian archivos — git los lee directamente desde el directorio del proyecto.

Bypass (casos de emergencia)

git commit --no-verify   # Salta pre-commit
git push --no-verify     # Salta pre-push

Solo usar en emergencias documentadas. Los hooks existen para proteger el repositorio.