fix(coordination,Q67): merge_ready exige une approbation myia-ai-01 qui couvre le contenu de la tete

[jsboige]

Grain: MED/guard -- lane myia-ai-01:CoursIA -- prev: MED/docs #18245

Pourquoi

Depuis le 23/09, scripts/coordination/merge_ready.py mergeait toute PR hors harnais et hors DEEP dès qu'une lane qui ne la porte pas y posait un dossier [ADJOINT PREFLIGHT] READY. La disposition de review était relevée au journal, sans rien bloquer. Mesure du journal de l'organe au 28/09 :

• 211 merges ; 6 portaient une review APPROVED de myia-ai-01 ;
• 146 dossiers émis par l'adjoint (myia-po-2025:CoursIA-2) ou le secrétaire (myia-po-2026:CoursIA-3), 65 par d'autres lanes du cluster (ensemble QUALIFYING_LANES, ouvert par harness(gate,#16906,#16928): la prevalidation Phase 4 accepte une lane tierce, et un dossier suivi de sa prose #16907) ;
• aucun audit a posteriori n'a été fait, alors que CLAUDE.md §A l'annonçait.

Arbitrage user du 2026-09-28 (registre Q67, option a) : l'organe ne doit servir qu'à éviter qu'un dossier se périme entre la lecture du coordinateur et le merge. Il ne doit pas remplacer cette lecture. L'arbitrage vaut sign-off pour le durcissement de §A.

Ce qui change

scripts/coordination/merge_ready.py — nouvelle étape 2ter, placée avant le gate : une PR non lue ne paie pas le gate.

• La dernière voix de myia-ai-01 doit être un APPROVED réel. Latest-wins sur ses seules voix, lues comme le canon : un CHANGES_REQUESTED ou un VERDICT: CONCERNS postérieur retire l'approbation. Un COMMENTED sans verdict (une phrase de levée) ne la retire pas. DISMISSED ne compte jamais.
• L'approbation doit couvrir le contenu de la tête : posée sur la tête, ou sur une tête dont la tête courante ne diffère que par des rafraîchissements de base prouvés content-free. Un update-branch sans conflit ne périme donc pas la lecture ; un commit de contenu ou une résolution de conflit la périme.
• Motifs de skip : no-coordinator-approval, coordinator-approval-stale, coordinator-approval-unverifiable (fail-closed, dont :no-base).
• Après le gate, une tête évaluée différente de la tête lue est refusée (head-moved) : l'approbation a été jugée sur la tête de la vue.
• La disposition journalisée (champ review, toutes voix) reste informative, inchangée.

scripts/ci/merge_dwell.py : la remontée first-parent de #16149 est factorisée (_walk_authoritative) et exposée par last_authoritative_sha. last_authoritative_committed_at garde exactement son comportement. La question « l'approbation couvre-t-elle encore cette tête ? » et celle du plancher DWELL passent ainsi par la même remontée.

Harnais et docs :

• CLAUDE.md §A : l'exception outillée exige l'approbation du coordinateur, et la phrase « audite l'organe a posteriori » est retirée ;
• coordinate/SKILL.md Phase 4, nouveau point 7 : approuver ce qui est lu mais pas encore mergeable ;
• README de scripts/coordination/ ;
• docs/reference/agent-cloud-agnosticisme.md.

Hors de cette PR

• La tâche planifiée CoursIA\merge_ready est désactivée sur ai-01 depuis 2026-09-28 ~15:05Z, jusqu'au merge de cette PR. Elle se réactive après le merge : l'organe tourne depuis un worktree ramené sur origin/main à chaque tour.
• L'audit du passif (les 205 merges sans approbation) est un travail séparé, suivi par issue.
• docs(skills): secretaire -- attester en tiers a son initiative, merge_ready convertit chaque READY #18245 (skill du secrétaire) sera alignée sur ce contrat avant son merge.

Validation

• python -m pytest scripts/tests/test_merge_ready.py scripts/tests/test_merge_dwell.py scripts/tests/test_dwell_rule_matches_organ.py scripts/tests/test_install_merge_ready_task.py -q : 137 passed. 12 tests nouveaux pour l'étape 2ter, dont les contrôles négatifs suivants :

  • approbation d'un autre login ;
  • CHANGES_REQUESTED postérieur ;
  • CONCERNS en corps ;
  • DISMISSED ;
  • résolution de conflit ;
  • commit de contenu ;
  • preuve illisible ;
  • base absente ;
  • tête du gate différente.

  3 tests nouveaux pour last_authoritative_sha.

• Dry-run de l'organe modifié sur le pool vivant (106 PRs, journal isolé) : rc=0, 0 would-merge. 8 PRs à dossier sont écartées pour no-coordinator-approval ; elles attendaient jusqu'ici leur merge sans lecture.

• python scripts/check_docs_links.py --check --base origin/main --quiet : rc=0.

• python scripts/notebook_tools/check_harness_coauthor.py --repo-root . : rc=0.

• B (Lean), C (ML), D (notebooks), G (QC) : non applicables.

PR de harnais (CLAUDE.md, .claude/) : hors périmètre de merge_ready, mergée à la main par le coordinateur, sur dossier tiers.

🤖 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).

[github-actions]

G-VAR-2 light cap reached (advisory, non bloquant).
La lane myia-ai-01:CoursIA a deja consomme son budget LIGHT du jour (#18167 (merge a 2026-09-28T02:58:04Z)).
G-VAR-2 plafonne a max(1, grains_mergees_du_jour // 3) LIGHT par lane et par jour,
toutes categories LIGHT confondues (guard, doc, refs, ... partagent un seul budget) :
c'est un RATIO, pas un plafond plat. La decision de merge reste au coordinateur.

[github-actions]

G-VAR-2/3 GENRE signals (advisory, non bloquant, #10020).
La lane `myia-ai-01:CoursIA` voit ces signaux actifs sur les mergees du jour (UTC 2026-09-28) :

• GENRE-RUN : run consecutif d'un genre LIGHT (voir signals.runs dans le log du job)
• CAP-EXCEEDED-BY-GENRE : light_genre > cap partage G-VAR-2 (tally : declared=3 genre=4 cap=1)

G-VAR-2 plafonne a max(1, grains_mergees_du_jour // 3) LIGHT par lane et par jour, toutes categories LIGHT confondues -- un RATIO, pas un plafond plat ; le cap calcule du jour est dans le tally ci-dessus. G-VAR-3 interdit deux genres LIGHT consecutifs. Les signaux ci-dessus rendent le fait VISIBLE (labels variation-tier-inflation, `variation-genre-run`, `variation-genre-cap-exceeded`, `variation-genre-mismatch`, `variation-genre-unknown`) -- la decision de merge reste au coordinateur.

[jsboige]

[ADJOINT PREFLIGHT]
schema: 1
lane: myia-po-2026:CoursIA-3
pr: 18257
head: f1e60aa
complete: true
body: read
comments-reviewed: 3
reviews-reviewed: 0
threads-reviewed: 0
threads-unresolved: 0
surfaces-sha256: 53ef2c95196c53dc7b14969c64739c1224680856810233c88be1fe4b0335508d
diff-files: 8
diff-additions: 423
diff-deletions: 33
checks: latest-wins-green
b0: clear
scope: pass
domain: not-applicable
verdict: READY
[/ADJOINT PREFLIGHT]

[myia-ai-01]

Lecture ai-01 a la tete f1e60aa (contrat Q67) : body, commentaires, diff lus. Un seul commit, contenu conforme a l arbitrage user Q67 (a), qui vaut sign-off du resserrement de CLAUDE.md §A. Dossier tiers READY du secretariat (c.5875145966), B.0 rc=0, 30 jambes latest-wins vertes, CLEAN.