breadcrumb-the-shire/.agents/skills/core-guardrails/references/quality-gates.md

# Quality Gates

## Pflicht-Gates

1. `docker compose exec php vendor/bin/phpunit`
2. `docker compose exec php vendor/bin/phpstan analyse -c phpstan.neon --no-progress`
3. `docker compose exec php vendor/bin/phpunit tests/Architecture/CoreStarterkitContractTest.php`
4. `docker compose exec php vendor/bin/php-cs-fixer fix --config=tools/php-cs-fixer/.php-cs-fixer.dist.php --dry-run --diff --verbose`
5. `bin/docs-link-check.sh`
6. `bin/codex-skills-sync.sh --check`

Policy-Hinweis:
- Verbindliche Enforcement-Einteilung (`required`, `manual_non_blocking`, `periodic_non_blocking`) wird zentral in `/.agents/checks/enforcement-policy.json` gepflegt.

## Struktur-Gates (schnell)

```bash
(rg 'new\s+[^\s(]+Factory\(' lib/Service || true) | wc -l
(rg --glob '!**/*Factory.php' 'new\s+[^\s(]+(Service|Gateway|Repository)\(' lib/Service || true) | wc -l
(rg "\b(accessServicesFactory|directoryServicesFactory|userServicesFactory|authServicesFactory|tenantServicesFactory|settingServicesFactory|userRepositoryFactory|authRepositoryFactory|authGatewayFactory)\(" pages lib templates web || true) | wc -l
(rg -n 'new\s+[^\s(]+(Service|Gateway|Repository)\(' pages -g '*.php' || true) | wc -l
(rg -n '\bDB::' pages -g '*.php' || true) | wc -l
(rg -n 'app\([^\n]*Factory::class\)->create' pages/admin -g '*.php' || true) | wc -l
(rg -n 'Factory::class' pages/admin -g '*.php' || true) | wc -l
(rg -n 'ApiResponse::readJsonBody\(' pages/api/v1 -g '*.php' || true) | wc -l
```

Erwartung: jeweils `0`.

## JS-Scope

- Bei JS-Aenderungen Browser-Smoke mit DevTools-Console durchfuehren.
- Erwartung: keine neuen JS-Errors.

## Docs-/Skills-Gates (schnell)

1. `bin/docs-link-check.sh`
   - prueft Doku-Links in `README.md`, `docs/**`, `.agents/skills/**` und `.agents/**`
   - `.agents/runs/**` ist standardmaessig ausgeschlossen (historische Artefakte)
2. `bin/docs-drift-check.sh`
   - prueft bekannte Legacy-Drifts (entfernte Config-Pfade/Constants, obsolete Search-Marker)
   - prueft Setup-Vertrag fuer `config/config.php.example` in den Kern-Onboarding-Dokus
3. `bin/codex-skills-sync.sh --check`
   - prueft Drift zwischen Repo-Skills und `~/.codex/skills`

## Berichtspflicht

- Bei jedem Gate klar angeben: `passed` / `failed` / `not run`.
- Bei `failed` den blocker explizit benennen.