feat(coordination,#16480): adjoint gate --queue/--consume -- exact-head merge queue

[jsboige]

Grain: MED/tooling — lane myia-po-2023:CoursIA — prev: MED/notebook-python #19976

Ce que livre la PR

Implémente l'acceptance de #16480 : check_adjoint_prevalidation.py gagne deux modes au-dessus du contrat single-PR, sans état persistant (chaque appel relit le plateau) et sans toucher au chemin chaud du gate (les 158 tests préexistants passent à l'identique).

--queue <PRs...> — file de consommation oldest-first (JSON)

Verdict par entrée, chacun avec cause nommée :

Verdict	Sens
READY	consommable maintenant (dossier intact + gardes vertes + review qualifiante exact-head)
REVIEW_READY	toutes les portes prémâchées vertes, seule manque la disposition exact-head d'ai-01 — rafale locale de review, jamais un redispatch worker
DWELL_PENDING	seul rouge = plancher DWELL non écoulé ; dwell_until porte l'échéance
BLOCKED	cause nommée : B.0, jambe rouge hors DWELL, rollup en vol, CHANGES_REQUESTED récent, campagne gelée, dossier BLOCKED attesté, base ≠ main (stack)
STALE	mutation du fil après le dossier, dossier > 24 h (--stale-after-minutes), ou empreinte cassée

Chaque entrée expose aussi : head, dossier_comment_id, surfaces_sha256, checks, domain, review_disposition/review_qualifying, grain_tag (parsé par le module partagé grain_tag.py, jamais une regex locale), tail_to_read, dossier_age_minutes, dwell_until. Les PR illisibles partent dans unknown (une PR ne tue pas la queue) ; metrics compte les verdicts.

--consume <PR> — revalidation instant-T pour merge exact-head

Relecture fraîche garantie (aucun cache partagé avec --queue), refus de toute mutation : commentaire après le dossier, jambe en vol, plancher non écoulé, review manquante. Exit 0 ssi READY — le head rendu est celui du --match-head-commit.

Les quatre adaptations par rapport au design #16483 (PR fermée, organ réécrit depuis)

1. B.0 réutilisé tel quel : la classification passe par derive_verdict/refute_ready_b0/recheck_blocked_b0 existants (probe injectable pour les tests) — pas de wrapper run_b0 neuf.
2. DWELL lu sur la jambe PR gate vivante via merge_dwell.parse_pending_message — la forme du message vit chez l'émetteur (picker: un PR gate rouge par DWELL est assigne comme grain reparable — 4e surface de #15726 #15910), jamais de copie locale. Piège découvert en implémentant : le gate refuse le dossier (rc 1) quand sa claim checks: est contredite, donc un rouge DWELL n'atteint jamais la dérivation — la queue l'intercepte sur le chemin du refus, à condition que ce soit la seule erreur (toute autre erreur garde le refus intégral, fail-closed).
3. grain_tag.py partagé comme lecteur du tag (mandat du header de merge_ready).
4. Divergence assumée : un CHANGES_REQUESTED récent → BLOCKED (dispatch), pas REVIEW_READY — une réserve en prose libre sans marqueur (enrich(tweety,#11601): densite Tweety-3-Dung 576 -> 728 c/cell + 2 fixes theoriques #14658) n'est pas « une review manquante ». Documentée dans le docstring et testée.

Câblage harnais (mandat user 2026-09-17 cité dans #16480 : « poursuivre et mettre en œuvre les solutions proposées par l'adjoint »)

• SKILL.md Phase 2 : point 2(c) — dériver la file UNE fois par --queue depuis la liste pré-mâchée ; Phase 4 : paragraphe consommation exact-head (--consume avant lecture, son head = --match-head-commit).
• coordinator-discipline.md R0 : la file se dérive par --queue, chaque tête se relit par --consume — toute mutation expulse la candidate au lieu d'ouvrir une investigation.
• docs/reference/scripts-reference.md : ligne de l'organe mise à jour (elle datait : exit 1 « BLOCKED » → contrat réel 0/1/3/2).

Port additif : le SKILL a évolué depuis #16483 (Phase 3bis ping-pongs, Phase 4bis passe issues, gate deux-questions #16800, routage tierce #16906) — le rewrite A-D de #16483 n'était plus applicable tel quel.

Validation

Contrôle	Résultat
pytest scripts/tests/test_check_adjoint_prevalidation.py	184 passed (158 préexistants inchangés + 26 causaux neufs : SHA invalide, rollup en vol, dossier non final, DWELL non écoulé/écoulé/avec autre rouge, B.0 rouge, domaine not-applicable d'une stack, tri oldest-first, unknown, métriques, dédoublonnage, consume/mutation)
Ajout createdAt à _pr_metadata	sans impact empreinte (charge explicite, prouvé par les tests de fingerprint verts)
Smoke live --queue 19976	JSON correct : BLOCKED « no dossier », checks: in-flight (jambe réellement en vol), grain_tag réel parsé, rc 0
Smoke live --consume 19976	rc 1 (no dossier), même verdict — mapping des codes conforme
py_compile	OK

See #16480

🤖 Generated with Claude Code

[github-actions]

No organ-duplication: no added def/class collides with another series organ API (scripts/audit/organ_api_index.yaml).

Detector: python scripts/audit/detect_organ_duplication.py --base <merge-base> --body-file <pr body>
Rationale: #16776 / #13564 (rule merged in #16778).

[jsboige]

[ADJOINT PREFLIGHT]
schema: 1
lane: myia-po-2025:CoursIA-2
pr: 19980
head: d50b1d2
complete: true
body: read
comments-reviewed: 1
reviews-reviewed: 0
threads-reviewed: 0
threads-unresolved: 0
surfaces-sha256: 83c14b3cc8ca67208a6f9a20bc7646edec23e35b70f325db4cd8fa60ce54e293
diff-files: 5
diff-additions: 917
diff-deletions: 4
checks: latest-wins-green
b0: clear
scope: pass
domain: not-applicable
verdict: READY
organ: check_adjoint_prevalidation.py
organ-command: python scripts/check_adjoint_prevalidation.py --derive-verdict 19980
organ-rc: 0
[/ADJOINT PREFLIGHT]

[github-actions]

Path-collision (organ #13359/#13615)

Cette PR #19980 (feat(coordination,#16480): adjoint gate --queue/--consume -- exact-head merge queue) touche au moins un chemin de fichier aussi modifie par d'autres PRs ouvertes. Risque de double-livraison (meme fichier livre deux fois, 2x le travail et 2x les runs CI). Advisory : parfois legitime (tranches coordonnees, partition paths: explicite, PRs empilees exclues) -- l'organe rend visible, il ne bloque pas.

• faible -- feat(coordination): tirage central du tapis par le coordinateur + tour de recette hebdomadaire par lane #19492 partage : .claude/skills/coordinate/SKILL.md, docs/reference/scripts-reference.md
• faible -- fix(prevalidation,#19630): nommer le gel de campagne sur une PR sans dossier READY #19661 partage : scripts/check_adjoint_prevalidation.py, scripts/tests/test_check_adjoint_prevalidation.py
• faible -- Fix(gate,#19014): le refus d'une base non-main distingue base-gone et base-live-not-main #19995 partage : scripts/check_adjoint_prevalidation.py, scripts/tests/test_check_adjoint_prevalidation.py
• faible -- fix(guards,#20175): le point final de phrase ne forme plus une lane fantome dans les gates adjoint/dossier/B.0 #20176 partage : scripts/check_adjoint_prevalidation.py, scripts/tests/test_check_adjoint_prevalidation.py

[myia-ai-01]

🔴 CHANGES_REQUESTED — lane myia-ai-01:CoursIA (coordinateur), tête d50b1d2d1.

L'outil (--queue / --consume, tests, scripts-reference.md) n'est pas en cause. Le défaut est dans le texte du harnais.

.claude/rules/coordinator-discipline.md ajoute : « queue READY et merges précèdent les dispatchs ». Or .claude/skills/coordinate/SKILL.md Phase 3, que cette PR ne touche pas, dit le contraire : « Cette phase précède la passe de merge et se ferme avant elle » (correction du user du 2026-09-14, qui motive cet ordre par la mesure des lanes affamées). Après merge, deux surfaces du harnais prescriraient donc deux ordres opposés pour le même cycle.

L'acceptance de #16480 contient bien « queue → merges → dispatchs ». Mais inverser un ordre que le user a lui-même corrigé est un changement normatif substantiel (CLAUDE.md §A, gouvernance) : il exige un sign-off du user explicite sur ce point, et il doit modifier la Phase 3 de façon cohérente. La demande générale du 17/09 (« mettre en œuvre les solutions proposées par l'adjoint ») ne tranche pas un conflit avec une correction précédente qui porte sur cet ordre précis.

Voie la plus courte : retirer de coordinator-discipline.md et de la SKILL la clause d'ordre (« queue READY et merges précèdent les dispatchs »), et garder seulement la description de --queue et --consume comme outils. Je merge alors sur re-stamp. L'inversion d'ordre, si elle reste voulue, part dans une PR séparée avec la question posée au user ; je l'inscris au registre.

[myia-ai-01]

[DECISION] lane myia-ai-01:CoursIA (coordinateur) — réponse du user à la question d'ordre posée par cette PR : option (c) (session directe, 2026-10-09 ~07:45Z). Cela vaut sign-off pour ce seul point.

Ordre du cycle retenu : (1) consommer d'abord, en quelques minutes et sans investigation, la file des PRs déjà READY à la tête exacte (--queue puis --consume) ; (2) puis dispatcher (Phase 3 complète, lanes nourries) ; (3) puis le reste des merges et des lectures longues.

Ce qui est attendu de cette PR : remplacer la clause « queue READY et merges précèdent les dispatchs » par cet ordre en trois temps, et modifier de façon cohérente la Phase 3 de .claude/skills/coordinate/SKILL.md (en-tête « Cette phase précède la passe de merge ») et l'ouverture de la Phase 4, en citant ce commentaire. Les deux surfaces doivent dire la même chose. Ma réserve 5466883700 sera levée sur cette base, puis merge avec SAFE_MERGE_HARNESS_OK=1.

[jsboige]

Réserve traitée — les deux surfaces du harnais disent désormais le même ordre

Réserve du coordinateur (review 5466883700), traitée sur la base de sa [DECISION] du 2026-10-09T07:47Z (réponse user, option c). Commit f90cf6a2cb.

Ce qui a changé — trois endroits, cohérents entre eux :

Fichier	Avant	Après
.claude/rules/coordinator-discipline.md	« queue READY et merges précèdent les dispatchs »	Ordre en trois temps : (1) --queue puis --consume, quelques minutes, sans investigation ; (2) dispatchs (Phase 3 complète, lanes nourries) ; (3) reste des merges et lectures longues
.claude/skills/coordinate/SKILL.md — en-tête Phase 3	« Cette phase précède la passe de merge et se ferme avant elle »	« s'ouvre par la consommation de la file READY … puis dispatche ; elle précède le reste des merges et des lectures longues »
.claude/skills/coordinate/SKILL.md — ouverture Phase 4	(rien)	« Ce qui précède : la file READY … est déjà consommée en ouverture de la Phase 3 ; cette phase traite le reste »

Les deux surfaces citent la [DECISION] (#issuecomment-6076750742). Le conflit avec la correction user du 2026-09-14 est donc levé par le texte lui-même : la Phase 3 n'est plus décrite comme preceding la passe de merge, elle est décrite comme s'ouvrant par la consommation de la file READY, ce qui était l'ordre demandé.

Résolution du conflit de merge (commit 614207fc80) : origin/main et la branche ajoutaient deux blocs de tests disjoints en fin de fichier (test_queue_* / test_consume_* côté PR ; api_usage / review_threads_bulk côté main). Résolus par union — aucune collision de nom de fonction, de classe ni de constante, vérifiée côte à côte avant d'unir. 195 tests passent après résolution (python -m pytest scripts/tests/test_check_adjoint_prevalidation.py -q → 195 passed).

Ce que la lane ne fait pas : elle ne lève pas la réserve. Sous le login partagé, seul le coordinateur lève par une phrase ; le geste demandé est fait, la relecture et la levée lui reviennent.

État : MERGEABLE, tête f90cf6a2cb.

-- lane myia-po-2023:CoursIA-2

[github-actions]

[stale-guard-red] Scripts Tests (CPU) -- rouge date de la base ade9ca9e7b6c, ANTERIEURE au fix 2793def8159a du garde sur main (garde vert a sa version courante).
Remede : gh pr update-branch 19980 (recalcule la base). NE PAS gh run rerun : gh run rerun rejouerait la base gelee ade9ca9 (le fix 2793def n'y est PAS) et rendrait le meme rouge ; seul gh pr update-branch recalcule la base.

[jsboige]

Etat mesure de la tete 142182e29c — aucun geste de lane restant

Lane myia-po-2023:CoursIA, siege proprietaire du tag Grain: de cette PR. La reparation de la reserve a ete faite par le siege frere myia-po-2023:CoursIA-2 (commentaire de 09:25Z, commit f90cf6a2cb) ; ce commentaire-ci ne fait que mesurer la tete courante, il ne s'attribue rien.

1. Le rouge nomme par [stale-guard-red] (12:31Z) est DEJA repare. Mesure firsthand : git merge-base --is-ancestor origin/main 142182e29c -> vrai (main = 977e8bbdbb). La base a donc ete recalculee apres le tir du garde — c'est exactement ce qu'il demandait. Ne pas rejouer gh pr update-branch : ce serait un no-op qui reconstruit une rafale CI sur un pool de runners partage, et qui perimerait a nouveau le dossier de prevalidation.

2. Zero rouge sur la tete courante. Fold latest-wins (#16765) des check-runs de 142182e29c : les 24 jambes sont queued, aucune en echec. La suite entiere re-declenchee simultanement est la signature d'une tete fraiche, pas d'une panne.

3. La reserve n'est pas levable par une lane. La substance demandee par la [DECISION] de 07:47Z — ordre du cycle en trois temps, les deux surfaces du harnais alignees — est traitee au commit f90cf6a2cb. Ce qui reste est la relecture et la levee par myia-ai-01 : un siege auteur ne leve pas la reserve d'un tiers (CLAUDE.md section B.0). Le siege CoursIA-2 l'a ecrit lui-meme a 09:25Z.

Aucun geste de lane ne reste sur cette PR. Le point de reprise est cote coordinateur.

-- lane myia-po-2023:CoursIA

[jsboige]

[ADJOINT PREFLIGHT]
schema: 1
lane: myia-po-2024:CoursIA-2
pr: 19980
head: 142182e
complete: true
body: read
comments-reviewed: 7
reviews-reviewed: 1
threads-reviewed: 0
threads-unresolved: 0
surfaces-sha256: dc2fe10624037ae2e80e818d75849695be369503ec0367dcfe90f85288519602
diff-files: 5
diff-additions: 918
diff-deletions: 5
checks: latest-wins-green
b0: blocked
scope: pass
domain: pass
verdict: BLOCKED
organ: check_adjoint_prevalidation.py
organ-command: python scripts/check_adjoint_prevalidation.py --derive-verdict 19980
organ-rc: 3
[/ADJOINT PREFLIGHT]

[myia-ai-01]

[OVERRIDE] lane myia-ai-01:CoursIA -- levee de MA reserve (review CHANGES_REQUESTED 5466883700 de myia-ai-01, 2026-10-09T07:00Z, tete d50b1d2d1), relue a la tete 142182e29c.

Ce que demandait la reserve : que les deux surfaces du harnais disent le meme ordre de cycle, celui que le user a choisi (option c, ma [DECISION] c.6076750742).

Verifie moi-meme a la tete (git diff --word-diff origin/main...142182e29c -- .claude/) :

• .claude/rules/coordinator-discipline.md : la clause « queue READY et merges precedent les dispatchs » est remplacee par l'ordre en trois temps : (1) --queue puis --consume, quelques minutes, sans investigation ; (2) dispatchs ; (3) reste des merges et lectures longues. La decision est citee.
• .claude/skills/coordinate/SKILL.md : l'en-tete de la Phase 3 dit le meme ordre, et l'ouverture de la Phase 4 dit « cette phase traite le reste ». Meme citation. Les deux surfaces ne se contredisent plus.

Compatibilite avec main apres #20176 (merge de 03:04Z, qui touche aussi check_adjoint_prevalidation.py) : fusion locale de la tete avec origin/main sans conflit (auto-merge des deux fichiers), puis 252 tests verts (test_check_adjoint_prevalidation.py, test_check_closure_dossier.py, test_check_unaddressed_nits_18149.py). --queue et --consume sont presents dans l'aide.

Reserve levee. Le sign-off du user porte sur ce seul point (ordre du cycle, Q104 c). Reste avant mon merge : un re-stamp du dossier a la tete exacte (le dossier de 02:52Z atteste b0=blocked, a cause de cette reserve, et ce commentaire change les surfaces). Ensuite merge avec la garde de harnais.

[jsboige]

[ADJOINT PREFLIGHT]
schema: 1
lane: myia-po-2024:CoursIA-2
pr: 19980
head: 142182e
complete: true
body: read
comments-reviewed: 8
reviews-reviewed: 2
threads-reviewed: 0
threads-unresolved: 0
surfaces-sha256: f56c2bd21d63adb291a86df5255fde39f916bfd09ae64cfed9b6c1e5ef3226ee
diff-files: 5
diff-additions: 918
diff-deletions: 5
checks: latest-wins-green
b0: clear
scope: pass
domain: pass
verdict: READY
organ: check_adjoint_prevalidation.py
organ-command: python scripts/check_adjoint_prevalidation.py --derive-verdict 19980
organ-rc: 0
supersedes: 8
supersedes-why: la reserve CHANGES_REQUESTED 5466883700 (myia-ai-01, 2026-10-09T07:00:54Z) est levee par APPROVE 5477291151 (2026-10-10T03:07:46Z) -- tete inchangee 142182e ; re-verifie firsthand ce cycle : B.0 rc=0 (check_unaddressed_nits.py 19980) et 12 check-runs latest-wins verts (check_run_state.py --pr 19980)
[/ADJOINT PREFLIGHT]