leopardo-hr: Instructions file for Codex

AGENTS.md - Guide de travail Leopardo

Derniere mise a jour : 2026-11-07 (#9164 — un outil de nettoyage CI peut annuler sa propre file : fail-closed obligatoire)

Lecon 2026-11-07 (#9116) : un echec de build macOS peut etre une resolution de dependances, pas notre code — et un pubspec.lock committe peut etre le coupable fusible. Les 6 jobs macos-latest de Desktop CI etaient rouges sur Build (verify) depuis le 2026-11-02 avec un seul message : firebase_messaging 17.0.1 -> firebase-ios-sdk 13.1.1 -> gtm-session-fetcher 4.0.0..<6.0.0, contre google_sign_in_ios 6.3.3 -> GoogleSignIn 9.x -> gtm-session-fetcher 3.3.0..<4.0.0. Trois pieges de diagnostic : (1) flutter analyze et les jobs Windows passaient (Windows ne passe jamais par Swift Package Manager, exclusif a apple) : un vert partiel sur la meme matrice ne dit rien de la cause, il faut lire le job rouge; (2) le conflit est resolu par xcodebuild avant compilation, donc aucune erreur de notre code et aucun fichier .swift en cause; (3) le pubspec.lock committe fige google_sign_in_ios 6.3.3 alors que le constraint ^6.2.0 autorisait deja mieux: bump de lock, pas de pubspec.yaml. 6.4.0 elargit la dependance a GoogleSignIn 9.0..<11.0 (donc 10.x, gtm 4.x), et exige Flutter 3.47/Dart 3.13 — a verifier car un lock qui depasse le SDK local casse flutter pub get chez les devs en Flutter ancien. Ne pas « reparer » en desactivant SPM (flutter config --no-enable-swift-package-manager) : la CI passerait au vert en changeant de resolveur sans prouver que les builds CocoaPods tiennent, et Flutter annonce l'option comme non supportee a terme.

Leçon 2026-11-07 (#9164) : un outil de nettoyage CI peut annuler son propre run — et, bien pire, toute la file. Deux pièges dans cancel-orphan-runs.sh, tous deux silencieux. (1) L'auto-annulation : cleanup-orphan-runs.yml se déclenche sur pull_request: [closed], donc son propre run porte la branche qui vient d'être mergée puis supprimée ; sans exclure sa propre identité (GITHUB_RUN_ID), le script se classe « orphelin » et s'annule lui-même — le check reste cancelled, que gh pr checks affiche comme rouge (leçon #8396), sur chaque PR mergée, alors que le nettoyage a bien agi. (2) La liste vide qui n'échoue pas : mapfile -t X < <(gh api …) sous set -e ne propage JAMAIS l'échec de la commande de la substitution ; une réponse vide (rate limit, token sans contents: read) donne un tableau vide, donc « toutes les branches sont mortes » et le script annule les runs de main et de toutes les PR ouvertes. Règles : toute liste lue par substitution de processus est confrontée à une garde fail-closed (0 élément = exit 1, aucune action) ; tout outil qui annule ou édite exclut sa propre identité ; et une garde de test n'existe que si on l'a vue ROUGE sans le correctif (faux gh local, zéro réseau) — dev-hub/tools/tests/cancel-orphan-runs.test.sh, branchée dans le workflow, est la référence.

Lecon 2026-11-01 (#8396 -> #9098) : une campagne se ferme par une DECLARATION et un TICKET SUCCESSEUR, jamais par un close nu ni par un statu quo indefini. #8396 etait CLOSED (2026-10-29) alors que son propre dernier commentaire concluait « l'issue reste ouverte comme suivi de campagne » : deux etats contradictoires, donc personne ne savait si les 166 echecs restants etaient suivis. Trois options existaient et deux sont mauvaises : rouvrir l'issue (une campagne de 5 tranches deja livrees n'a plus de lot a porter : elle n'a pas de proprietaire par module, et une issue ouverte ne cree pas ce proprietaire) ; laisser l'ecart en place (la dette devient invisible -> motif exact du « ghost close » #4816). Regle : la cloture se prouve par un commentaire qui dit (1) ce qui est livre et mesure, (2) ce qui ne l'est PAS et pourquoi la campagne n'est plus le bon vehicule, (3) le numero du ticket successeur qui porte le reste. Le successeur recoit la mesure de reference datee (run + commit), le tableau par module, l'ordre de traitement impose par le volume et le critere de sortie mesurable (0 echec sur 3 runs consecutifs) — sans quoi le successeur redevient une campagne. Corollaire : une mesure datee qui vieillit doit le dire elle-meme (« anterieure aux merges #9088..#9090 ») ; l'instrument (#9074) la rafraichit a chaque run, ce qui autorise la cloture sans re-mesurer a la main.