chore(notebooks): normaliser les 633 cellules source en forme chaine sur 162 notebooks mixtes — outil existant, partition par famille

[myia-ai-01]

Le defaut

Une cellule dont le source est une chaine unique au lieu d'une liste de lignes rend chaque edition ulterieure illisible en diff : corriger un mot dans une cellule de 40 lignes produit une paire +/- de 40 lignes. nbformat accepte les deux formes ; Jupyter ecrit la forme liste. Le cout n'est donc pas la validite, c'est la relecture.

Il a un cout mesure : la lane myia-po-2025:Maintenance a passe trois commits (d821fbe8, 5a3810d8, plus une relance URGENT) sur #14046 a chasser ce qu'elle croyait etre une re-serialisation. Mesure faite : les 4 cellules concernees etaient neuves, ecrites en forme string des l'origine — il n'y avait aucune forme a restaurer. Le temps a ete depense sur une premisse fausse faute d'un cadrage repo-wide.

L'etendue — mesuree le 2026-09-02 sur main

1 224 notebooks sous MyIA.AI.Notebooks/ (hors .ipynb_checkpoints, hors *_output.ipynb) :

	notebooks	cellules
MIXTES — une minorite de cellules brise la convention que le reste du meme fichier suit	162	633
INTEGRALEMENT string — le notebook a ete ecrit ainsi de bout en bout	3	45
total portant >= 1 cellule string	165 (13,5 %)	678 (1,72 % des 39 344)

Seuls les 162 mixtes sont la cible. Convertir les 3 integralement-string produit un diff de fichier entier sans valeur pour un relecteur : les exclure explicitement.

Partition par famille (cellules string, notebooks mixtes seuls)

cellules	famille
156	QuantConnect
135	GenAI
116	SymbolicAI
82	ML
37	Search
28	Sudoku
21	RL
19	Probas
15	CaseStudies
13	GameTheory
11	IIT

Tetes de liste (string / total)

25/30  (83%)  GenAI/Video/01-Foundation/01-4-Video-Enhancement-ESRGAN.ipynb
16/41  (39%)  ML/ML.Net/ML-1-Introduction.ipynb
15/57  (26%)  QuantConnect/Python/QC-Py-03-Data-Management.ipynb
15/40  (38%)  ML/DataScienceWithAgents/Track2-GoogleADK/Day7-Production/Lab17-Final-Project.ipynb
13/26  (50%)  GenAI/CaseStudies/Barbie-Schreck/barbie-schreck.ipynb
12/27  (44%)  RL/rlpt_3_reward_hacking.ipynb
12/19  (63%)  SymbolicAI/Lean/Lean-12b-Lean-Sensitivity-Theorem.ipynb
11/51  (22%)  SymbolicAI/SemanticWeb/SW-3-CSharp-GraphOperations.ipynb

L'organe existe deja — ne pas en ecrire un autre

scripts/notebook_tools/fix_string_cells.py, 48 tests (livres par #700). Convention nbformat respectee (retour ligne sur toutes les lignes sauf la derniere), --dry-run disponible.

python scripts/notebook_tools/fix_string_cells.py <chemin> --dry-run

Garde obligatoire — la conversion ne doit RIEN changer d'autre

Une normalisation de serialisation touche la forme, jamais le contenu. Avant de committer, controle positif par notebook :

• le source rejoint de chaque cellule est byte-identique avant/apres ;
• outputs et execution_count sont inchanges sur toutes les cellules ;
• le nombre de cellules est inchange.

Si l'un des trois bouge, ce n'est plus une normalisation — c'est une edition de contenu, et elle releve de C.2 (re-execution) et non de ce grain.

Interdit explicite : ne pas en profiter pour toucher la prose, les sorties ou les accents. Un diff de ce grain ne doit contenir que des changements de forme source.

Tier et usage — a lire avant de le piocher

LIGHT. Le litmus de .claude/rules/variation-protocol.md est sans ambiguite : « pourrais-je en generer une douzaine en scannant l'instance suivante ? » — oui, onze fois, une par famille. Consequences :

• ce grain ne tient pas le plancher G-VAR-1 et consomme le budget G-VAR-2 ;
• il ne se prend pas deux fois de suite (G-VAR-3, genre LIGHT, ban absolu a 2) ;
• c'est un remplissage de fin de cycle, jamais un plat principal.

Il est mis en file parce qu'il est reel et mesure, pas parce qu'il est prioritaire.

Decoupage propose

Une PR par famille, dans l'ordre du tableau (les grosses d'abord, elles portent le plus de cout de relecture). Onze PRs au total, chacune citant :

• le compte avant/apres pour sa famille,
• la sortie du controle positif ci-dessus,
• l'exclusion nommee des 3 notebooks integralement-string s'ils tombent dans la famille.

Acceptance

• les 162 notebooks mixtes ne portent plus de cellule source en forme chaine
• les 3 notebooks integralement-string sont exclus et nommes (pas convertis)
• chaque PR cite son controle positif : source rejoint identique, outputs et execution_count inchanges
• aucun diff de ces PRs ne touche prose, sorties, ou accents
• la mesure finale est refaite avec le meme instrument et citee

Ce que ce grain ne fait PAS

Il n'ajoute pas de garde CI. Un gate qui rougirait sur toute cellule string bloquerait les outils d'enrichissement qui ecrivent en string (c'est leur sortie naturelle, cf. #14046). La question d'un garde se repose apres la normalisation, sur une base propre, et separement.

---

Mesure et cadrage : passe de coordination du 2026-09-02, a partir du cout reel constate sur #14046.

[jsboige]

Grain: LIGHT/tooling — lane myia-po-2027:CoursIA — prev: LIGHT/docs #14254

[CLAIMED] lane myia-po-2027:CoursIA -- paths: MyIA.AI.Notebooks/Sudoku/**
Tranche Sudoku de la partition par famille : 11 notebooks concernés (dry-run sur origin/main da1d250), forme seule string->liste, outil existant fix_string_cells.py, gardes per-cell digest (contenu rejoint byte-identique, outputs/execution_count/nb cellules inchangés, fixes type-(b) listes-sans-\n écartés — hors scope).

[jsboige]

[DELIVERED] Tranche Sudoku — lane myia-po-2027:CoursIA — PR #14266 : 9 notebooks / 26 cellules str->list, gardes digest (contenu rejoint byte-identique, forme seule), pas de re-exec (C.3). Exclusions : Sudoku-06-AIMA-CSP-Python (type-b only, hors scope), Sudoku-14-BDD-Csharp (hook fix-hr-separator y convertit 13 separateurs --- = contenu, grain separé ; ses 2 cellules string restent a convertir dans ce grain ou une reprise). Claim paths Sudoku/** reste tenu jusqu'au merge de #14266.

[jsboige]

Grain hr-separateurs (famille Sudoku), pris par la lane myia-po-2027:CoursIA (claim paths: Sudoku/** actif de #14266) — PR #14278 : conversion des 16 separateurs --- restants de la famille (12-Z3-Python x2, 13-SymbolicAutomata-Python x1, 14-BDD-Csharp x13) via fix_hr_separator.py (#11451). Markdown-only, pas de re-exec, attestations twin 3 paires dans la PR. Deblocage : apres merge de #14278, les 2 cellules string de 14-BDD-Csharp pourront etre normalisees sans conflit de hook (plus aucun --- dans le fichier) — residuel de tranche #14209.

[jsboige]

Normalisation incidentelle -- FT-01-Introduction-FineTuning.ipynb (GenAI/FineTuning) : la re-exec papermill de la PR #14200/#14290 (Stop & Repair chemin machine, po-2023) a converti les 6 cellules du notebook encore en forme chaine vers la forme liste (contenu byte-identique, verifie par jointure cellule par cellule). Le notebook ne devrait donc plus compter dans le residu de la famille FineTuning au prochain passage de mesure.

[jsboige]

[CLAIMED-AMEND] lane myia-po-2027:CoursIA -- paths: MyIA.AI.Notebooks/Sudoku/**

Correction administrative du marqueur [DELIVERED] lié à la PR #14266 : le body, le diff et le claim initial bornent tous cette livraison à Sudoku/**. La PR reste OPEN et ce verrou Sudoku reste actif ; seul l’élargissement epic-wide accidentel dû à l’absence de paths: est retiré.

[jsboige]

[CLAIMED] lane myia-po-2025:Microsoft VS Code -- paths: MyIA.AI.Notebooks/CaseStudies/Oncology-Planning/solution/Oncology-Planning.ipynb, MyIA.AI.Notebooks/CaseStudies/Oncology-Planning/student/Oncology-Planning.ipynb, MyIA.AI.Notebooks/CaseStudies/SmartGrid-Energy/solution/SmartGrid-Energy.ipynb

Grain: LIGHT/tooling — lane myia-po-2025:Microsoft VS Code — prev: MED/tooling #14114

Tranche CaseStudies CPU/local réservée au worker Vibe sur la base origin/main cd5905a : fix_string_cells.py --dry-run MyIA.AI.Notebooks/CaseStudies mesure 3/6 notebooks fixables. Acceptance #14209 : conversion forme source string→liste uniquement ; contenu joint byte-identique cellule par cellule ; outputs, execution_count, metadata et nombre de cellules inchangés ; aucune retouche de prose/accents ; pas de re-exécution si ces gardes passent ; relai humain avant push/PR selon #14114. Claim-check path-scoped CLEAR après correction du verrou Sudoku #14266 ; 0 PR ouverte intersectant CaseStudies/** au moment de la réservation.

[jsboige]

[RELEASED] lane myia-po-2025:Microsoft VS Code -- paths: MyIA.AI.Notebooks/CaseStudies/Oncology-Planning/solution/Oncology-Planning.ipynb, MyIA.AI.Notebooks/CaseStudies/Oncology-Planning/student/Oncology-Planning.ipynb, MyIA.AI.Notebooks/CaseStudies/SmartGrid-Energy/solution/SmartGrid-Energy.ipynb

Correction de scope : cette identité de workspace était malformée et correspond à ce slot myia-po-2025. Aucun commit ni aucune PR n'a été livré sur ces trois chemins ; le verrou est donc relâché sans transfert implicite. Toute reprise devra poser une nouvelle claim sous une lane canonique après contrôle du plateau.