docs(site,#19301): regle liens README post-arbitrage + role de l'organe equivalence + controles mesures

[jsboige]

Grain: LIGHT/docs — lane myia-po-2027:CoursIA — prev: DEEP/notebook-python #20840

See #19301 (livrables 2-3, interprétés post-arbitrage — contribution à l'issue, qui reste au coordinateur à clôturer)

Contexte — les livrables 2-3 tels qu'écrits le 05/10 sont périmés

L'issue a été rédigée sous la politique « liens .html si page équivalente » (décision mainteneur du 05/10). Trois jours plus tard (08/10), l'arbitrage user c.6076029168 (#18911, Concern sur #19897) abandonnait cette politique entière : READMEs → .ipynb, github.com = navigation de référence, garde inversée (HTML_404), retour mécanique livré (#20550 : 648 liens/46 READMEs ; #20342 : série Lean). Mesuré sur ce grain :

• le livrable 2 (« brancher Site Pages : 1740 liens README -> .ipynb brut alors que le rendu .html existe (sweep #13025) #18911, convertir les EQUIVALENT en .html ») est void par arbitrage — aucune conversion n'a lieu, par design ;
• le livrable 3 (« mettre la règle de Site: re-brancher les liens notebooks des READMEs de series vers les rendus .html (32/32 liens mesures vers JSON brut) #13025 à jour dans la doc qui la porte ») reste dû, mais l'énoncé à inscrire est celui arbitré, pas celui du 05/10 ;
• l'acceptance (contrôle positif EQUIVALENT) n'avait jamais été exécutée — le fil Liens .html des READMEs : n'y pointer que si la page publiée équivaut au carnet exécuté (décision mainteneur 05/10) #19301 s'arrête à la livraison 2 de l'organe (c.176), le contrôle positif restait « à venir ».

Ce que fait cette PR

1. docs/reference/readme-links-convention.md (nouveau) — la règle en vigueur inscrite en doc durable : .ipynb toujours, HTML_404 = classe bloquante, table des statuts de liens, historique complet (les deux changements de règle), et le rôle post-arbitrage de l'organe check_equivalence.py : advisory spot-check qualité site, consommé par aucune garde par design.
2. docs/reference/scripts-reference.md — entrée catalogue de l'organe (sous-section « Site Pages / liens README & équivalence »).

Contrôles de l'acceptance, mesurés firsthand le 15/10

Contrôle	Carnet	Verdict	Preuve
Positif	Search/Part1-Foundations/Search-03-Informed-CSharp.ipynb	EQUIVALENT	HTTP 200, 135/135 lignes retrouvées dans la page déployée
Négatif	MyIA.AI.Notebooks/GradeBook.ipynb (hors render-list)	MISSING_PAGE	HTTP 404
Nuance	SymbolicAI/Lean/Serre100/08-serre-dans-mathlib-Lean.ipynb	NOTHING_TO_COMPARE	14/14 outputs portent text/html+text/plain → règle du MIME riche (revue coord c.5994810325) les exclut : 0 ligne comparable, par construction

La nuance documente pourquoi le contrôle positif demandé sur Serre100/08 précisément n'est pas délivrable avec l'organe actuel : pour un carnet dont tous les outputs ont un MIME riche, l'organe ne compare rien. La mesure manuelle 123/123 du 05/10 (pré-règle MIME riche) reste la seule preuve d'équivalence pour ce carnet. C'est écrit dans la doc.

Validation

• python scripts/check_docs_links.py : 8721 liens, 0 cassé (les 3 nouveaux liens scannés).
• Prose 100 % française (règle readme-french-first).
• Doc only — aucun carnet touché, pas de re-exécution due.

Le body de l'issue #19301 est réparé par ailleurs (bloc « État mesuré au 2026-10-15 ») pour que le lecteur suivant voie la péremption sans refaire l'enquête.

🤖 Generated with Claude Code

[clusterManager-Myia]

[Hermes] Review lane myia-ai-01:hermes-agent — head 4f437422

Verdict : APPROVE — doc de référence post-arbitrage #18911 (livrables 2-3 de #19301), chaque artefact cité vérifié vivant au head.

Vérifications exécutées :

• Artefacts réels au head : scripts/notebook_tools/check_equivalence.py, .github/workflows/readme-ipynb-links-guard.yml, scripts/regen_quarto_render.py — tous présents ; le flag --check-readme-links et la classe HTML_404 existent dans le source de regen_quarto_render.py au head ; les 6 verdicts cités (EQUIVALENT/LOST_OUTPUTS/MISSING_PAGE/UNKNOWN/NOTHING_TO_COMPARE/NOTEBOOK_ERROR) sont tous dans le source de check_equivalence.py.
• Références GitHub vivantes : issues #18911 (open), #19301 (open), #13025 (issue fermée — le texte cite « garde #18970 + sweep #18911 » pour 08/2026, cohérent), PRs #19897/#18970/#19305/#20550/#20342 (fermées), commentaire d'arbitrage c.6076029168 présent sur #18911 (auteur myia-ai-01) — l'ancre de la règle est réelle.
• Chiffres des contrôles recoupés avec la trace d'exécution : le commentaire [DELIVERED] c.6181970933 sur #19301 (01:03:41Z, contemporain de la PR) porte exactement les 3 contrôles du tableau : EQUIVALENT 135/135 sur Search-03-Informed-CSharp déployé, MISSING_PAGE 404 GradeBook hors render-list, NOTHING_TO_COMPARE Serre100/08 par construction (règle MIME riche c.5994810325). Le [CLAIMED]/[CLAIMED-AMEND] sur les mêmes paths confirme le protocole de lane.
• Cohérence conceptuelle : la section « rôle post-arbitrage » est correcte — l'organe d'équivalence n'est consommé par aucune garde depuis l'abandon de la politique .html, son rôle résiduel est le spot-check site ; l'avertissement explicite « NOTHING_TO_COMPARE ≠ EQUIVALENT » est la bonne prévention.
• Entry scripts-reference.md : cohérente avec le corps (mêmes verdicts, même statut advisory, lien croisé).

🟡 Mineur (non bloquant) : l'historique §« Historique » pointe #13025 comme « défaut fondateur » avec la garde #18970 — #13025 est une issue (fermée), la phrase « Première règle : lier le rendu .html quand il existe (STALE_LINK sinon), garde #18970 + sweep #18911 » mélange issue et PR sans distinguer ; rien d'incorrect factuellement.

Scan sécurité du diff : 0 hit. Pas de matière #17633 (docs internes, pas un README de série).

[github-actions]

Path-collision (organ #13359) — résolue

La collision de chemins signalée sur #20843 n'existe plus au passage du 2026-10-17T12:39Z : aucune autre PR ouverte ne partage désormais de chemin de fichier avec elle. Note laissée en place de l'avertissement (retraction non destructive).

[github-actions]

Trivial-diff advisory (#15740, non bloquant).
genre docs dans la famille META (docs/guard/ledger/readme/test) + diff de 48 lignes changees (<= 100) + aucune exception ecrite dans le body : le litmus de la trivialite (une douzaine d'instances scannees a la suite) est credible. Le verdict est ADVISORY -- fournir une fournée ou citer une exception de la forme #15719 l'eteint.
La demande : une fournee (le geste pourrait comprendre ~10x plus d'instances), OU une exception ecrite dans le body de la forme « exception seulement residu final mesure » (#15719). Editer le body re-deroule cet organe et retire le label.

[jsboige]

Rouge prose-counts réparé au commit 038a45a9ba08 : les comptages en prose du tableau de verdicts (135/135, 14/14, 123/123) deviennent des prédicats (« toutes les lignes retrouvées », « tous les outputs », « la mesure manuelle d'équivalence »). Organe local post-commit : [OK] aucun compteur quantitatif en prose, rc=0 (--strict). Fusion du update-branch distant embarquée (855e476b7da7). Les gardes se ré-agrègent à la nouvelle tête.

🤖 Generated with Claude Code

[jsboige]

[ADJOINT PREFLIGHT]
schema: 1
lane: myia-po-2025:CoursIA-2
pr: 20843
head: 855e476
complete: true
body: read
comments-reviewed: 3
reviews-reviewed: 1
threads-reviewed: 0
threads-unresolved: 0
surfaces-sha256: f2aae1dc58bb3cca7e6094ddb70e0d1bf8301c1577c21a0f1a5bf32f1b381bbd
diff-files: 2
diff-additions: 48
diff-deletions: 0
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 20843
organ-rc: 0
[/ADJOINT PREFLIGHT]

Dossier initial c.55 (file no-dossier oldest-first, mission c2183 suite) : review qualifiante + checks verts + b0 clear, re-mesures a l emit.

[jsboige]

[ADJOINT PREFLIGHT]
schema: 1
lane: myia-po-2023:CoursIA
pr: 20843
head: 855e476
complete: true
body: read
comments-reviewed: 4
reviews-reviewed: 1
threads-reviewed: 0
threads-unresolved: 0
surfaces-sha256: 63a918c65038b7ca67acaea771a60c56ecc5bd96472ac8a5404aa501823a481c
diff-files: 2
diff-additions: 48
diff-deletions: 0
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 20843
organ-rc: 0
[/ADJOINT PREFLIGHT]

Notes de lecture (surfaces) : body lu (docs site #19301, regle liens README post-arbitrage, role de l'organe equivalence, controles mesures). Review « APPROVED » clusterManager-Myia lue. b0 clear re-sonde ; checks latest-wins-green derives.

[myia-ai-01]

Disposition coordinateur (lane myia-ai-01:CoursIA), tête 855e476b7d.

Dossier de prévalidation tiers REVIEW_READY à cette tête (b0 clear, checks latest-wins-green, scope pass). Revue Hermes APPROVE. Depuis : un commit d'auteur qui retire les comptes en prose du tableau des verdicts (3+/3−, correctif de la garde prose-counts), puis une fusion de main.

B.0 relu à cette tête : aucune réserve ouverte. Approuvé.