[EPIC] Nettoyage & rangement du dépôt — résidus, consolidation, bases saines pour balisage + localisation #9535

État au 2026-09-02 — l'arbre a maigri de 1 008 entrées, deux items restent, et un item se lisait comme une régression alors que le défaut a été divisé par cinq

Passe de curation (défaut #13906). La mesure du 30/08 en pied de corps était juste et le reste ; celle-ci la prolonge sur les dix items, pas sept, et corrige une lecture que le seul décompte de fichiers rend fausse.

41 PRs mergées portent 9535 au titre, zéro ouverte. Arbre main : 9 884 → 8 876 entrées (−1 008).

Les dix items — état mesuré sur main le 2026-09-02

1. L'item 4 se lit comme une régression et n'en est pas — 43 → 60 fichiers, 17 → 3 orphelins

L'inventaire annonçait « 43 fichiers directs dont 17 one-shot ». Le compte brut est monté à 60. Pris seul, ce chiffre dit l'inverse de la vérité : la composition a changé, pas seulement la taille. Sur les 60, 54 sont référencés par un workflow, un autre script, une doc ou un hook, et 3 seulement sont de vrais orphelins :

Ce qui a grossi, ce sont les organes : la majorité des nouveaux fichiers sont des check_*.py appelés par la CI. scripts/ racine est devenu la maison des gardes, ce que l'acceptance (« ≤ scripts vivants et référencés ») autorise explicitement.

Le piège de mesure, à ne pas refaire. Un git grep du nom de fichier restreint à .github/ scripts/ docs/ .claude/ CLAUDE.md en accuse 6 — dont deux organes bien vivants :

• check_subprocess_encoding.py est un hook .pre-commit-config.yaml, fichier racine hors des chemins fouillés ;
• gh_payload_cache.py n'est jamais nommé comme fichier : il est importé comme module par pick_idle_grain.py, series_saturation.py et leurs tests.

Un instrument de référence se valide par ses faux positifs ici comme par ses faux négatifs ailleurs : chercher le nom de fichier sur tout le dépôt et chercher la forme import <module>, sinon on propose la suppression de l'organe qu'on utilise pour mesurer.

2. Trois résidus de la même classe, apparus depuis l'inventaire

L'item 4 du corps le prévoyait (« l'inventaire est un seed, pas une clôture »). Les voici, mesurés :

• run_build_v7.sh à la racine — même classe exacte que l'item 3, ré-instanciée. Script one-shot de build Lean avec deux chemins absolus par-machine en dur (/home/jesse/.elan/bin, /mnt/c/dev/CoursIA-c6724-c31-p4nw/…/conway_lean), sortie vers /tmp, référencé nulle part. Le worktree qu'il cible est un worktree de session, qui n'existe plus.
• .claude/agent-memory/qc-strategy-improver/allweather-lessons.md — item 7 régressé. Le gate invoqué à l'époque (fix(qc,#6891): [RESCOPE] 7 quantbooks en honnetete interimaire — vraie re-exec via kernel QC (RECOVERABLE-USER-HAND, creds absents) #6891) est fermé, mais le fichier n'est pas orphelin : docs/qc/qc-strategy-improver-memory.md:239 porte ## AllWeather Lessons -> voir allweather-lessons.md. Le supprimer casserait un renvoi de doc tracké. (Correctif du 2026-09-02 : la première rédaction de ce bandeau le donnait pour un retrait débloqué — c'est le piège de mesure décrit en §1, appliqué à mon propre candidat. Mesuré par git grep du nom sur tout le dépôt, ce que la §1 prescrit et que je n'avais pas fait ici.)
• 11 fichiers *_REPORT / *_STATUS / *_AUDIT.md trackés hors docs/, dont 8 sous slides/**/analysis/ (IMAGE_VALIDATION_REPORT.md, slidev_comparison_report.md, visual_quality_report.md, …), plus QuantConnect/projects/_docs/QUANTCONNECT_PROJECTS_AUDIT.md, scripts/quantconnect/quantbooks_execution_status.md et Search/discrepancy_lean/FORMAL_STATUS.md. L'acceptance dit « zéro non-pédagogique tracké hors docs/ » ; il faut trancher lesquels sont des artefacts pédagogiques assumés (les analyses de slides peuvent l'être) et purger le reste.

3. Acceptance — trois lignes sur six sont tenues

Ce qui reste — l'ordre dans lequel une lane devrait le prendre

1. Le lot racine + orphelins — un grain LIGHT de quatre suppressions, run_build_v7.sh plus les trois scripts one-shot de la §1, chacune avec sa preuve de non-référencement (vérifiée le 2026-09-02 : 0 hit nom-de-fichier sur tout le dépôt, 0 hit en forme d'import). Le fichier d'agent-memory sort de ce lot : il est référencé (item 7). Deux issues portent déjà cette veine — [consolidation] Nettoyage racine + gitignore residuels (V1 sans risque) #13738 (racine, volet V1) et [consolidation] scripts/ racine : restructuration, 22 orphelins, fusions 6->4 dirs (V3) #13744 (orphelins de scripts/) : y contribuer plutôt qu'ouvrir une fille de plus ; les mesures de ce bandeau y sont postées en commentaire.
2. Le tri des 11 rapports trackés : décision par fichier (pédagogique assumé → garder ; débris de session → purger). Les 8 slides/**/analysis/ se tranchent en bloc, les trois autres au cas.
3. L'absorption de social_choice_lean (item 6, seconde moitié) — 11 entrées, ouvert depuis [Lean][infra] Regrouper les lakes cohesifs post-convergence (GameTheory 6->2, modele multi-module) #4365. Le seul item qui demande du jugement de contenu, donc le seul MED du lot.
4. translations/ (item 9) reste une décision user, pas un grain de lane : la fermeture de T3 moteur de traduction — fork Argumentum translate_game_rules.py + arrêt des resync CSV dans le vide #6949 a explicitement déféré le GO. À re-poser au user, pas à trancher seul.

Corps d'origine conservé intégralement ci-dessous (2026-08-05), y compris son état mesuré du 30/08 et le piège de SHA de submodule qu'il documente — celui-ci reste exact et vaut d'être relu avant toute mesure sur un submodule.

Mandat user 2026-08-06 : « garder le dépôt propre, et notamment dans un état où on pourra s'attaquer à son balisage et sa localisation sur des bases saines ». Successeur des nettoyages ponctuels #910 / #67 / #83 / #570 / #2671 (tous fermés) — cette fois en Epic pérenne : le rangement est un flux, pas une passe.

Pourquoi maintenant

Deux chantiers structurants sont en aval et supposent un arbre sain :

• Balisage : catalogue automatisé (chore(catalog): catalogue hors-branche cron-only — stopper le silent-revert au merge (decision user 07/06) #2632, cron + drift), hiérarchie README ([EPIC] README ascendant — resynchroniser la hiérarchie (feuilles -> principal) depuis l'évolution du dépôt #3973 / [#3973] READMEs intermédiaires & centraux — première passe sans attendre feuilles 100% (P0 : hub notebooks + SymbolicAI) #4959). Baliser des résidus, c'est graver du bruit dans le catalogue.
• Localisation : Epic [EPIC] Traduction multilingue du depot via datasetupdater Argumentum (low priority) #1650 (français d'abord, .en.md préservés). Traduire des fichiers qui devraient être supprimés ou déplacés est du travail perdu.

Inventaire groundé (2026-08-06, firsthand git ls-files / git log)

Chaque item = 1 grain = 1 PR (jamais une vague). Discipline « Consolider ≠ Archiver » : analyser → fusionner avec preuve (numéros de ligne / cible citée) → archiver/supprimer seulement après. Les dispositions ci-dessous sont des propositions à confirmer par le grain (G.9 : vérifier avant d'agir — certains « résidus » peuvent être du contenu pédagogique intentionnel).

Hors scope repo (ne pas mélanger) : les débris untracked locaux (_logs/, bg_logs/, outputs/, reports/, calib/, tmp/, __pycache__/, .tmp_prover_*.log) relèvent de l'hygiène disque par machine → #8924. Un grain .gitignore-audit peut en revanche vérifier que ces patterns restent bien couverts.

Méthode (HARD)

1. 1 item = 1 grain = 1 PR atomique (catalog-pr-hygiene R3) ; [CLAIMED] avant pickup ; catalogue byte-identique à main sur chaque branche.
2. Préservation avant réduction : aucune suppression sans preuve écrite dans le commit (call-sites greppés = 0, ou contenu fusionné avec cible citée). Anti-régression : une cellule/preuve/solution ne se strip jamais au passage.
3. Grains LIGHT pour la plupart (budget G-VAR-2 s'applique — c'est l'à-côté plafonné, jamais le plat principal d'un cycle) ; les items 1, 5 et 9 sont MED (instruction + décision + exécution).
4. L'inventaire ci-dessus est un seed, pas une clôture : tout agent qui découvre un résidu du même genre l'ajoute en commentaire ici (jamais un rapport committé) et peut le traiter dans la foulée si son budget le permet.

Acceptance (état-cible)

• tools/semantic-fleet-radix a une maison définitive documentée (submodule ou série), tools/ vidé ou justifié.
• Racine du dépôt : plus aucun fichier de travail tracké (PR_BODY.md, compile_ne_arm.sh traités) ; .gitignore couvre les patterns de débris récurrents.
• scripts/ racine ≤ scripts vivants et référencés ; one-shots consolidés-archivés avec preuve.
• Zéro *_REPORT/_STATUS/_AUDIT.md non-pédagogique tracké hors docs/.
• Convention d'archives unique appliquée.
• Chaque item du tableau porte un statut final en commentaire : FAIT (PR #N) / GARDÉ (justification) / TRANSFÉRÉ (issue #N).

Voir aussi

#1210 (semantic-fleet, Axe 4 = origine de l'item 1) · #6405 (branche stable submodule) · #6949 (T3 translations) · #1650 (localisation) · #2632 / #3973 / #4959 (balisage) · #8924 (hygiène disque machines) · #7423 (revue harnais — le pendant « règles » de ce pendant « arbre »)

Etat mesure du 2026-08-30 (ai-01, tri des refutations Vibe)

Mesure sur l'arbre complet de main (9 884 entrees, truncated: false) :

6 items sur 7 sont executes. Seul l'item 6 reste ouvert, et sur sa seconde moitie uniquement :
l'absorption de social_choice_lean, pas les fichiers de statut.

Commandes reproductibles :

gh api 'repos/jsboige/CoursIA/git/trees/HEAD?recursive=1' --jq '.tree[].path' > tree.txt
grep -ci _legacy tree.txt              # 0
grep -c social_choice_lean tree.txt    # 13

Piege rencontre en mesurant : interroger trees/HEAD du depot submodule repond sur un autre
objet que la SHA epinglee par le parent. radix y est absent, ce qui fabrique une fausse alerte
« suppression sans preservation ». Interroger la SHA epinglee, jamais HEAD.