fix(tooling,#15512): detect_paragraph_length mesure chaque item de liste seul (94 fichiers de-signales, 0 vrai positif perdu)

[jsboige]

Grain: DEEP/tooling — lane myia-po-2026:CoursIA — prev: DEEP/genai-content #16282

Ce que cette PR corrige

La tranche « Probas (5 fichiers) », que #15512 recommande de traiter en premier, n'a rien à corriger : ses 9 findings sont des faux positifs, et la cause est dans l'organe, pas dans les fichiers.

iter_paragraphs() définissait un paragraphe comme « une suite de lignes contiguës non-vides ». Dans un assets/readme/MANIFEST.md, six champs - **Source** : … / - **Poids** : … se suivent sans ligne vide : ils étaient donc additionnés. Mesure :

MANIFEST Probas	Volume du plus long item	Longueur du « paragraphe » annoncé
DecisionTheory/PyMC/…	1594 c	3457 / 3255 / 3117 / 3004 / 2894 / 2073 c
PyMC/…	1242 c	2588 / 2143 c
Probas/…	807 c	4220 c

Zéro item ne dépasse 2000 c — seul leur somme le fait. C'est en contradiction avec l'intention écrite du module (« un item de liste de 10k caracteres est un mur aussi » — un item) et avec le rendu : markdown produit six <li> distincts, qu'aucun lecteur ne parcourt d'un trait.

Conséquence évitée : « corriger » cette tranche aurait consisté à scinder des champs de provenance structurés et curés (Source / Poids / Verdict) — du churn sur des données auditées, sans gain de lisibilité. Aucune PR de sweep n'est donc produite sur ces fichiers (protocole de réévaluation d'audit #499 : pas de PR sur un finding faux).

Le correctif

Un item de liste ouvre désormais son propre bloc, y compris quand il suit une phrase d'introduction (la phrase ferme le bloc précédent). Le seuil 2000 est inchangé ; c'est la segmentation qui change, pas la barre.

Mesure corpus-entier (avant / après)

Sur le corpus suivi (git ls-files '*.md'), les deux versions du module chargées côte à côte puis comparées :

	blocs	fichiers
avant	375	124
après	157	30

• Vrais murs de prose : ensemble de fichiers identique — 12 fichiers avant, 12 après, set == vérifié en chargeant la version origin/main du module. 0 vrai positif perdu, 0 fichier nouvellement signalé ;
• 94 fichiers de-signalés, dont la totalité des assets/readme/MANIFEST.md de la flotte.

Le résidu restant est du signal réel, pas des faux positifs :

• 12 transcripts bruts GenAI/Vibe-Coding/Roo-Code/**/roo_task_*.md — murs structurellement légitimes, déjà déclarés hors scope par docs: sweep de résorption des 112 fichiers markdown portant un paragraphe > 2000 c (paragraph-length advisory #15507) #15512 elle-même ;
• 9 paragraphes de prose réellement longs, multi-lignes (18 et 26 lignes physiques continues vérifiées) — ils restent de vrais positifs et relèvent du sweep.

Contrôles (le point sensible : ne pas éteindre le détecteur)

Le risque d'un tel correctif est de rendre l'organe muet. Trois contrôles l'encadrent :

1. Témoin fondateur (le paragraphe Probas de 3336 c sur une ligne physique, PR docs(probas,#14871): navigation Percolation + audit fichier-entier du README série (réconciliation prose/disque, pont causal développé) #15405) : tire toujours, 3251 c ;
2. Contrôle de faux positif avec preuve d'appartenance : le run de test doit dépasser le seuil en somme et chaque item rester dessous — sinon le test serait vacuement vert (il passerait aussi sur un texte anodin). Les deux assertions sont dans le test ;
3. Témoin positif de la segmentation : un item de liste unique de 2400 c tire toujours — borne le fix précédent.

--self-test embarque (6) et (7) ; la suite pytest passe de 12 à 16 tests.

Grounding

Les deux documents qui décrivent le signal portent la même précision, avec la re-mesure datée : scripts/notebook_tools/README.md et l'en-tête de .github/workflows/paragraph-length-advisory.yml (dont le texte citait déjà le signal « single run of non-empty lines »). Le workflow est advisory et inchangé fonctionnellement — seul son commentaire de calibration est réaligné, pour ne pas laisser une mesure périmée décrire la nouvelle sémantique.

Périmètre

4 fichiers, 1 sujet (la sémantique de segmentation de l'organe), 0 notebook, 0 catalogue.

See #15512 — la PR ne clôt pas l'issue : le sweep garde les 9 paragraphes de prose réels, et le comptage de l'issue (112 fichiers) demande à être re-scopé sur la mesure ci-dessus.

🤖 Generated with Claude Code

[github-actions]

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

• TIER-INFLATION : declared LIGHT << effective LIGHT-genre (tally : declared=0 genre=2 cap=2)
• NOTE ([variation] Le label est lane-agregat mais PR-attache : le merge-gate peut HOLD le grain de CONTENU qui remedie au motif #10341) : la PR courante est de classe CONTENU (non LIGHT-genre) et ne contribue pas au motif ci-dessus -- les labels agregees ne sont PAS poses sur cette PR (le merge-gate ne doit pas la HOLD pour ce motif ; le coupable est parmi les grains META de la lane).

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.

[github-actions]

Path-collision (organ #13359/#13615)

Cette PR #16283 (fix(tooling,#15512): detect_paragraph_length mesure chaque item de liste seul (94 fichiers de-signales, 0 vrai positif perdu)) 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 -- fix(ci,#16211): un-mute gh label create + cap descriptions <= 100 (6 dead labels revived) #16266 partage : .github/workflows/paragraph-length-advisory.yml