Skip to content

renum(causal-bridges,#5081): numerotation d'ensemble CausalBridges-01..08 — formaliser l'arc du README (mandat user 2026-09-22) #17416

Description

@jsboige

Mandat

User, session directe du 2026-09-22 : « Les séries comme Causal Bridges qui n'ont pas une numérotation d'ensemble sont plus difficiles à lire, il faudrait faire avancer ça. »

Constat mesuré (2026-09-22)

MyIA.AI.Notebooks/Probas/DecisionTheory/Causal-Bridges/ porte 8 notebooks sous deux conventions :

  • 3 sans identifiant : Do-Calculus-Bridge.ipynb, Quasi-Experimental.ipynb, Causal-Fairness.ipynb
  • 5 sous une sous-série : DoWhy-1..5-*.ipynb

Or le README de la série présente déjà un arc unique ordonné (sa table « Contenu ») : fondation formelle → arc outil dowhy (identifiant → contrefactuel → structure → sensibilité → IV) → méthodes quasi-expérimentales → capstone équité. Une lecture dans l'ordre lexicographique des fichiers NE REPRODUIT PAS cet arc (les non-numérotés se rangent avant/après l'arc DoWhy selon l'alphabet, pas selon la progression). C'est le tell « faux prérequis séquentiel » du §3 de la règle notebook-accretion-numbering — la position alphabétique implique un ordre que la progression dement.

Aucune PR ouverte ne touche ces chemins (L898/L1356 vérifiés au 2026-09-22 — guard clear).

Mapping proposé (protocole §5.5 — table AVANT la PR)

# Actuel Cible Argument pédagogique (parent)
1 Do-Calculus-Bridge.ipynb CausalBridges-01-Do-Calculus.ipynb Entrée du pont : échelle de Pearl, trois règles, backdoor/front-door — prérequis de tout le reste
2 DoWhy-1-Estimand-et-Intervention.ipynb CausalBridges-02-Dowhy-Estimand-Intervention.ipynb Premier palier outil : exiger un estimand AVANT d'estimer
3 DoWhy-2-Contrefactuel-Individuel.ipynb CausalBridges-03-Dowhy-Contrefactuel-Individuel.ipynb 3ᵉ échelon de Pearl, présuppose l'estimand du 02
4 DoWhy-3-Decouverte-de-Structure.ipynb CausalBridges-04-Dowhy-Decouverte-Structure.ipynb Le graphe qu'on n'a pas — présuppose la lecture d'estimands du 02-03
5 DoWhy-4-Sensibilite-Confounder-Cache.ipynb CausalBridges-05-Dowhy-Sensibilite-Confounder.ipynb Sensibilité d'un estimand identifié — présuppose 02 et la découverte 04
6 DoWhy-5-Instrument-Faible.ipynb CausalBridges-06-Dowhy-Instrument-Faible.ipynb Dernier levier d'identification — clôt l'arc outil
7 Quasi-Experimental.ipynb CausalBridges-07-Quasi-Experimental.ipynb DiD/RDD/contrôle synthétique : présuppose la grammaire estimand du 01-06
8 Causal-Fairness.ipynb CausalBridges-08-Causal-Fairness.ipynb Capstone : décomposition structurelle — consomme tout l'arc

Zéro réordonnancement : le mapping formalise l'ordre exact de la table du README — l'argument pédagogique est pré-ratifié par la série elle-même. L'identité dowhy est préservée dans les titres (Dowhy-*). Préfixe CausalBridges- aligné sur les siblings de DecisionTheory/ (DecInfer-01..08, DecPyMC-1..12) ; padding 2 chiffres conforme au chantier canonique #16231.

Sweep — 24 fichiers référents mesurés (hors série)

Probas/README.md · Probas/DecisionTheory/README.md · Probas/DecisionTheory/PARITY-INVENTORY.md · ML/DataScienceWithAgents/02-ML-Cours/README.md (ref 2.14b) · MyIA.AI.Notebooks/README.md · README.md racine · _quarto.yml · docs/curriculum/{recherche,trading,_inventory}.md · scripts/notebook_tools/{md_hierarchy_baseline,pedagogy_density_baseline,zero_pad_series}.json · scripts/notebook_tools/tests/fixtures/paragraph_wall_md.md · translations/{tweety,iit,probas-pymc,probas-infer}/…csv · translations/probas-decinfer/README.md · ledgers et archives : NON touchés (convention _archive/ledgers) · COURSE_CATALOG.generated.* : byte-identiques à main (catalog-pr-hygiene — l'automatisation re-mesure après merge).

Organes de vérification post-sweep (§6) : check_notebook_navlinks.py · check_docs_links.py · detect_link_target_regression.py · check_notebook_link_render.py · check_link_label_agreement.py (le libellé doit dire la vérité sur la cible) · clés orphelines pedagogy_density_baseline.json (#13815) · liste de rendu Quarto (#13931).

Contraintes (HARD)

  • git mv seul — aucun changement de contenu dans la même PR (§5.6). Les organes .py (causal_organs.py, dowhy_*.py, fairness_organs.py) ne bougent pas (pas des notebooks).
  • Catalogue non régénéré à la main (§5.8).
  • Vérifier l'absence de nouvelle PR ouverte sur les chemins juste avant l'édition (gate de séquencement §5.4).

Acceptance

Voir #5081 (EPIC nommage canonique) · #12375 (doctrine d'application) · #16231 (padding canonique).

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    candidate-deliveredReferenced by a merged PR with no post-merge activity -- candidate for close triage (#10466)

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions