Gate et Centre de gouvernance

Le contrat de qualité indique ce que l’équipe exige. Le gate le fait respecter. C’est une commande unique du moteur, utilisée de la même façon par les hooks Git, la CI, la commande yuli-mcp gate et les hooks des agents. Le résultat ne dépend pas de qui l’invoque.

La commande

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

Si vous omettez --project, le dossier courant est utilisé. Un dossier sans Git passe toujours.

Ce que vérifie chaque étape

Les contrôles

Anti-triche dans les tests

Un agent pressé d’en finir peut « corriger » un test au lieu du code. Yuli le détecte.

Dans les tests :

• Assertions supprimées ou tests effacés.
• Tests ignorés : @Disabled, @Ignore, .skip(, xit, #[ignore], skips de pytest ou unittest, t.Skip.
• Assertions triviales, comme assertTrue(true) ou expect(true).toBe(true).
• Valeurs attendues modifiées pour que le test passe.
• catch qui intercepte tout à l’intérieur d’un test.

Dans le build et la CI :

• Couverture minimale abaissée.
• Tests ignorés dans le build.
• Échecs ignorés, comme npm test || true.
• Script de tests remplacé par un script vide.
• Gate de qualité désactivé ou tâche de tests désactivée.

Filet de sécurité

Si des fichiers de code existants changent sans tests de caractérisation ou unitaires, le gate avertit : le changement doit préserver le comportement. Il ne bloque jamais le commit.

Installer les hooks Git

Dans le Centre de gouvernance, onglet Portes, cliquez sur Installer les hooks.

1. Yuli écrit .githooks/pre-commit, .githooks/commit-msg et .githooks/pre-push.
2. Il configure git config --local core.hooksPath .githooks.

Désinstaller les hooks retire la configuration et ne supprime que les scripts de Yuli.

Dans la CI

Les pipelines générés par Créer la CI incluent l’étape « Portes du contrat », qui exécute agent-engine gate --stage ci. La CI applique ainsi les mêmes règles que votre équipe en local.

Le Centre de gouvernance

Ouvrez-le depuis le rail de droite (Plus d'outils → Centre de gouvernance) ou avec la palette de commandes : Ouvrir le centre de gouvernance. Il comporte 10 onglets.

Documents générés

DORA

L’onglet Livraison calcule les quatre métriques DORA : fréquence de déploiement, lead time, taux d’échec des changements et MTTR, avec les niveaux Élite, Élevé, Moyen et Faible. Il s’appuie sur les déploiements enregistrés ou sur la CI. Yuli n’a pas accès à un APM de production.

Revue indépendante

Un modèle d’une autre famille relit le changement. Il n’utilise jamais la même famille que le modèle qui l’a écrit. Si aucun n’est configuré, il est signalé comme indisponible. Elle est obligatoire dans les profils Réglementée et Sécurité critique.

Contexte pour tous les agents

Dans Agents → Contexte, la section « Contexte pour tous les agents » écrit les mêmes règles pour chaque outil :

Le contenu est placé dans un bloc géré ; ce que vous écrivez en dehors est respecté. Par défaut, les fichiers restent hors de Git ; activez-le avec Les versionner dans Git. Chaque destination affiche son état : À jour, Obsolète, N’existe pas ou Modifié à la main.

Règles apprises

Lorsqu’un même constat apparaît 3 fois ou plus dans au moins 2 tâches en 30 jours, il devient une règle dans .ai/rules/learned.md. Vous pouvez la refuser dans Agents → Apprentissage ; elle n’est proposée à nouveau que si ses preuves doublent.

Limites, en toute transparence

• Le DAST (OWASP ZAP), l’analyse des conteneurs (Trivy ou Grype) et la signature (cosign) ne s’exécutent que s’ils sont installés, et toujours avec confirmation. S’ils manquent, Yuli l’indique et ne simule pas le résultat.
• Les règles préventives et celles d’IaC sont des motifs appliqués au texte. Chaque constat indique son fichier et sa ligne pour qu’une personne le confirme.