Gate și Centrul de guvernanță

Contractul de calitate spune ce cere echipa. Gate-ul îl impune. Este o singură comandă a motorului, folosită la fel de hook-urile Git, de CI, de comanda yuli-mcp gate și de hook-urile agenților. Rezultatul nu depinde de cine o invocă.

Comanda

agent-engine gate --project <raíz> --stage pre-commit|commit-msg|pre-push|ci \
  [--message-file <archivo>] [--base <revisión>] [--format text|json]

Dacă omiți --project, se folosește folderul curent. Un folder fără Git trece întotdeauna.

Ce verifică fiecare etapă

Controalele

Anti-trișare în teste

Un agent presat să termine poate „repara” un test în loc de cod. Yuli detectează asta.

În teste:

• Aserțiuni eliminate sau teste șterse.
• Teste sărite: @Disabled, @Ignore, .skip(, xit, #[ignore], skip-uri pytest sau unittest, t.Skip.
• Aserțiuni triviale, precum assertTrue(true) sau expect(true).toBe(true).
• Valori așteptate modificate ca testul să treacă.
• catch care prinde orice în interiorul unui test.

În build și CI:

• Acoperire minimă redusă.
• Teste sărite în build.
• Eșecuri ignorate, precum npm test || true.
• Script de testare înlocuit cu unul gol.
• Gate de calitate dezactivat sau sarcină de testare dezactivată.

Plasă de siguranță

Dacă se modifică fișiere de cod existente fără teste de caracterizare sau unitare, gate-ul avertizează: modificarea trebuie să păstreze comportamentul. Nu blochează niciodată commit-ul.

Instalarea hook-urilor Git

În Centrul de guvernanță, fila Porți, apasă Instalează hooks.

1. Yuli scrie .githooks/pre-commit, .githooks/commit-msg și .githooks/pre-push.
2. Configurează git config --local core.hooksPath .githooks.

Dezinstalează hooks elimină configurația și șterge doar scripturile Yuli.

În CI

Pipeline-urile generate de Creează CI includ pasul „Porțile contractului”, care rulează agent-engine gate --stage ci. Astfel, CI-ul aplică aceleași reguli ca echipa ta locală.

Centrul de guvernanță

Deschide-l din șina din dreapta (Mai multe unelte → Centrul de guvernanță) sau din paleta de comenzi: Deschide Centrul de guvernanță. Are 10 file.

Documente generate

DORA

Fila Livrare calculează cele patru metrici DORA: frecvența implementărilor, lead time, rata de eșec a modificărilor și MTTR, cu benzile Elită, Ridicată, Medie și Scăzută. Folosește implementările înregistrate sau CI-ul. Yuli nu vede un APM de producție.

Revizuire independentă

Un model din altă familie revizuiește modificarea. Nu folosește niciodată aceeași familie ca modelul care a scris-o. Dacă nu este configurat niciunul, o indică drept indisponibilă. Este obligatorie în profilurile Reglementată și Critică pentru siguranță.

Context pentru toți agenții

În Agenți → Context, secțiunea „Context pentru toți agenții” scrie aceleași reguli pentru fiecare unealtă:

Conținutul este plasat într-un bloc gestionat; ce scrii în afara lui este respectat. Implicit, fișierele rămân în afara Git; activează versionarea cu Versionează-le în Git. Fiecare destinație își afișează starea: La zi, Depășit, Nu există sau Editat manual.

Reguli învățate

Când aceeași constatare apare de 3 ori sau mai mult în cel puțin 2 sarcini în decurs de 30 de zile, devine o regulă în .ai/rules/learned.md. O poți respinge în Agenți → Învățare; este propusă din nou doar dacă dovezile pentru ea se dublează.

Limite oneste

• DAST (OWASP ZAP), scanarea containerelor (Trivy sau Grype) și semnarea (cosign) rulează doar dacă sunt instalate și întotdeauna cu confirmare. Dacă lipsesc, Yuli indică acest lucru și nu simulează rezultatul.
• Regulile preventive și cele de IaC sunt tipare aplicate pe text. Fiecare constatare vine cu fișierul și linia ei, ca o persoană să o confirme.