feat(sprint-H.5): cleanup baselines + tests obsolètes

Sprint H.5 du plan v2.0 — nettoyage post-migration des
artefacts qui ne servent plus à rien maintenant que les
paquets legacy top-level ont tous été supprimés (H.1) et
que ``adapters/legacy_modules/`` a disparu (H.2.a).

Suppressions
------------
- ``tests/architecture/test_legacy_canonical_parity.py`` : la
table ``LEGACY_PARITY`` était devenue vide au fil des Lots
A-G (chaque entrée retirée en même temps que son shim), et
``LEGACY_PACKAGES = ("llm",)`` pointait vers un dossier
inexistant depuis H.1. Le test passait trivialement (3
passed, 1 skipped) — pure dead code. Le seul invariant
qui reste à garder est l'absence d'import legacy depuis le
rewrite, déjà couvert par
``test_no_legacy_imports_in_rewrite.py`` (lui-même avec
``LEGACY_PACKAGES = ()``).

Documentation
-------------
- ``CLAUDE.md`` : retire la référence au test supprimé,
pointe vers ``test_no_legacy_imports_in_rewrite`` comme
garde-fou survivant.
- ``docs/reference/api-stable.md`` : warning bandeau mis à
jour — liste explicite des paquets legacy supprimés au
lieu de pointer vers la table de parité disparue.
- ``docs/migration/SESSION_HANDOVER.md`` :
- Section 0 (principe directeur) : pointe vers
``test_no_legacy_imports_in_rewrite`` ;
- Section 1 (sources de vérité) : remplace l'entrée
``test_legacy_canonical_parity`` par ce dernier test ;
- Section 3.F : note explicative sur la suppression du
test au sprint H.5 ;
- Section 4.C : table de parité « sans objet à v2.0 » ;
- Section 5 : remplace la sub-phase 7.B.2 obsolète par la
feuille de route restante (H.2.b-d, H.4, H.6).

Doc paths cleanup (-11 broken paths : 172 → 161)
-------------------------------------------------
Corrige les références cassées dans les docs encore actives :

- ``docs/how-to/cli-workflows.md`` (-3) : ``picarones/cli/*``
→ ``picarones/interfaces/cli/_legacy/*`` ;
``picarones/extras/importers/_http.py`` →
``picarones/adapters/corpus/_http.py``.
- ``docs/explanation/narrative-engine.en.md`` (-3) :
``picarones/measurements/narrative/`` →
``picarones/reports/narrative/`` (sed global, 4
occurrences).
- ``docs/explanation/narrative-engine.md`` (-1) :
``picarones/fixtures.py`` → ``picarones/evaluation/synthetic.py``.
- ``docs/reference/normalization-profiles.md`` (-1) :
``picarones/measurements/builtin_hooks.py`` →
``picarones/evaluation/metrics/builtin_hooks.py``.
- ``docs/developer/doc-consistency.md`` (-1) : moteurs OCR,
CLI, web → leurs nouveaux chemins post-rewrite.
- ``docs/migration/SESSION_HANDOVER.md`` (-2) : ré-écriture
de la section 5 (qui référençait
``picarones/evaluation/pipeline.py`` supprimé en D.6.b)
+ reformulation de la mention historique de
``picarones/measurements/__init__.py``.

``BROKEN_PATHS_BASELINE`` : 172 → 161.

Reste 161 broken paths, tous dans :
- ``CHANGELOG.md`` (114) : journal historique versionné,
intouchable.
- ``docs/audits/*.md`` (34) : audits historiques, intouchables.
- ``docs/migration/{pipeline-convergence-plan,
legacy-retirement-plan, executor-equivalence,
sprint-D-audit}.md`` (9) : plans/audits décrivant des
chemins legacy à des fins de comparaison historique.
- ``docs/roadmap/evolution-2026.md`` (4) : plan stratégique
historique décrivant la création initiale des modules.

Tests
-----
- ``pytest tests/`` : 4611 passed, 9 skipped, 24 deselected,
0 failed.
- ``ruff check picarones/ tests/`` : All checks passed.

Reste à faire pour atteindre v2.0
---------------------------------
- H.2.b-d : refonte ``BaseOCREngine.run()`` →
``BaseOCRAdapter.execute()`` + suppression
``adapters/legacy_engines/`` + ``adapters/legacy_pipelines/``
+ ``OCRLLMPipeline``.
- H.4 : refonte des routes/commandes dans
``interfaces/{cli,web}/_legacy/`` pour consommer le
rewrite pur.
- H.6 : bump version + tag v2.0.0 + section CHANGELOG.

https://claude.ai/code/session_01NxyVKqg2SowXLZdM4H1ZDE

CLAUDE.md

@@ -221,11 +221,10 @@ Pour le travail courant, ce qui compte :
   changes acceptés.
 - **Principe directeur** : suppression agressive.  Pas de shim
   qui survit à son usage.  Dès qu'un caller migre vers le
-  canonique, son shim est supprimé.  Tout symbole legacy public
-  doit être tracé dans
-  [`tests/architecture/test_legacy_canonical_parity.py`](tests/architecture/test_legacy_canonical_parity.py)
-  — c'est le journal de bord vivant qui garantit qu'aucune
-  fonctionnalité n'est silencieusement perdue.
+  canonique, son shim est supprimé.  Le test
+  [`tests/architecture/test_no_legacy_imports_in_rewrite.py`](tests/architecture/test_no_legacy_imports_in_rewrite.py)
+  garde l'invariant inverse : les paquets rewrite ne doivent
+  jamais réintroduire un import vers du legacy disparu.
 - **Plan maître** : [`docs/migration/legacy-retirement-plan.md`](docs/migration/legacy-retirement-plan.md)
   — cartographie complète des Phases 0-11 avec statut.
 - **Sub-plan convergence pipeline** : [`docs/migration/pipeline-convergence-plan.md`](docs/migration/pipeline-convergence-plan.md)

docs/developer/doc-consistency.md

@@ -30,11 +30,11 @@ Vérifie que :
 
 | Item | Source de vérité | Sens du contrat |
 |---|---|---|
-| Moteurs OCR | `picarones/engines/*.py` | Tout moteur listé dans le tableau « Supported Engines » du README doit avoir un adapter |
-| Commandes CLI | `picarones/cli/*.py` (Click) | Toute commande listée dans le README doit apparaître dans `picarones --help` |
-| Endpoints API | `picarones/web/app.py` (`app.openapi()`) | Tout endpoint listé doit exister dans la spec OpenAPI |
+| Moteurs OCR | `picarones/adapters/legacy_engines/*.py` | Tout moteur listé dans le tableau « Supported Engines » du README doit avoir un adapter |
+| Commandes CLI | `picarones/interfaces/cli/_legacy/*.py` (Click) | Toute commande listée dans le README doit apparaître dans `picarones --help` |
+| Endpoints API | `picarones/interfaces/web/_legacy/app.py` (`app.openapi()`) | Tout endpoint listé doit exister dans la spec OpenAPI |
 | Compteur de tests | `pytest --collect-only` | Toute mention « N tests » ou « N passed » doit être à 5 % près du baseline |
-| Variables `AWS_*` | `picarones/engines/aws*.py` | Si documentées, un adapter doit exister |
+| Variables `AWS_*` | `picarones/adapters/legacy_engines/aws*.py` | Si documentées, un adapter doit exister |
 
 **Direction unidirectionnelle** : on vérifie que ce qui est *annoncé*
 existe — pas que tout ce qui existe est annoncé. La direction réciproque

docs/explanation/narrative-engine.en.md

@@ -24,7 +24,7 @@ class FactType(str, Enum):
 
 ### 2. Add the FR + EN templates
 
-`picarones/measurements/narrative/templates/fr.yaml`:
+`picarones/reports/narrative/templates/fr.yaml`:
 
 ```yaml
 your_new_fact: >-
@@ -37,7 +37,7 @@ Same in `en.yaml` with the English version.
 ### 3. Implement the detector
 
 In an existing detector module (e.g.
-`picarones/measurements/narrative/detectors/quality.py` for
+`picarones/reports/narrative/detectors/quality.py` for
 quality-related facts) or a new one if a new family is justified:
 
 ```python
@@ -66,7 +66,7 @@ input — the anti-hallucination test would catch it.
 
 ### 4. Register the detector in the package `__init__`
 
-`picarones/measurements/narrative/detectors/__init__.py`:
+`picarones/reports/narrative/detectors/__init__.py`:
 
 ```python
 from picarones.measurements.narrative.detectors.quality import (
@@ -79,7 +79,7 @@ And add it to `__all__`.
 
 ### 5. Update the arbiter ordering
 
-`picarones/measurements/narrative/arbiter.py` — append your new
+`picarones/reports/narrative/arbiter.py` — append your new
 type to `_FALLBACK_TYPE_ORDER` at the right position.
 
 ### 6. Write tests

docs/explanation/narrative-engine.md

@@ -209,7 +209,7 @@ picarones demo --output /tmp/demo.html --docs 8
 
 Si la synthèse ne contient pas votre fait, vérifiez :
 1. Que votre détecteur retourne bien quelque chose sur les données de
-   démo (`grep -A 20 "def generate_sample_benchmark" picarones/fixtures.py`).
+   démo (`grep -A 20 "def generate_sample_benchmark" picarones/evaluation/synthetic.py`).
 2. Que l'importance est suffisante (> `MEDIUM`) pour passer le filtre
    par défaut de l'arbitre.
 3. Que votre type n'est pas en collision avec un autre déjà retenu pour

docs/how-to/cli-workflows.md

@@ -106,7 +106,7 @@ picarones import iiif \
 Télécharge un manifeste IIIF v2/v3 (BnF Gallica, Bodleian, Vatican…) et
 crée un corpus local avec `.gt.txt` extraits de l'OCR ALTO si présent.
 Depuis le chantier 4, IIIF et Gallica utilisent les mêmes helpers HTTP
-factorisés ([`picarones/extras/importers/_http.py`](../picarones/extras/importers/_http.py))
+factorisés ([`picarones/adapters/corpus/_http.py`](../picarones/adapters/corpus/_http.py))
 avec garde-fou `file://`/`ftp://`/`javascript://`.
 
 ## Outils utilitaires
@@ -183,9 +183,9 @@ pour découvrir la sortie sans corpus réel.
 
 ## Code source
 
-- [`picarones/cli/__init__.py`](../picarones/cli/__init__.py) — groupe
+- [`picarones/interfaces/cli/_legacy/__init__.py`](../picarones/interfaces/cli/_legacy/__init__.py) — groupe
   Click + helpers + commandes simples.
-- [`picarones/cli/_workflows.py`](../picarones/cli/_workflows.py) —
+- [`picarones/interfaces/cli/_legacy/_workflows.py`](../picarones/interfaces/cli/_legacy/_workflows.py) —
   run, diagnose, economics, edition, compare + helper `_run_workflow`.
 - Voir aussi [`docs/reference/normalization-profiles.md`](profiles.md) et
   [`docs/reference/views.md`](views.md).

docs/migration/SESSION_HANDOVER.md

@@ -18,15 +18,13 @@
   acceptés.
 - Dès qu'un caller migre vers le canonique, son shim est
   **supprimé** (pas conservé pour un usage hypothétique).
-- Tout symbole legacy public doit être tracé dans
-  ``tests/architecture/test_legacy_canonical_parity.py`` :
-  `canonical: ...` (équivalent canonique existe), `dropped: ...`
-  (volontairement abandonné, justifié), ou `unmigrated: ...`
-  (cible prévue, en cours).
-
-Le test ``test_legacy_canonical_parity`` garantit qu'**aucune
-fonctionnalité legacy n'est silencieusement perdue** au cours
-de la migration.  C'est le journal de bord vivant.
+- L'invariant inverse est gardé par
+  ``tests/architecture/test_no_legacy_imports_in_rewrite.py`` :
+  les paquets rewrite (`domain → formats → evaluation →
+  pipeline → adapters → app → reports → interfaces`) ne
+  doivent jamais importer depuis un paquet legacy.  Pour le
+  retrait final v2.0, ``LEGACY_PACKAGES = ()`` (vide) — tous
+  les paquets top-level legacy ont été supprimés.
 
 ---
 
@@ -40,10 +38,10 @@ de la migration.  C'est le journal de bord vivant.
    sous-plan détaillé de la convergence ``BaseModule`` /
    ``PipelineRunner`` → ``StepExecutor`` / ``PipelineExecutor``
    (Sub-phases 7.A-7.D).
-3. **[`../../tests/architecture/test_legacy_canonical_parity.py`](../../tests/architecture/test_legacy_canonical_parity.py)** —
-   journal vivant de la migration : table 3-états des symboles
-   legacy avec leur équivalent canonique.  À mettre à jour à
-   chaque migration.
+3. **[`../../tests/architecture/test_no_legacy_imports_in_rewrite.py`](../../tests/architecture/test_no_legacy_imports_in_rewrite.py)** —
+   garde-fou architectural : aucun module rewrite n'importe
+   depuis un paquet legacy (``LEGACY_PACKAGES`` désormais
+   vide à v2.0).
 4. **[`../../CLAUDE.md`](../../CLAUDE.md)** — règles d'architecture
    à respecter, statut de la migration, et liens vers le reste.
 5. **`git log --oneline -10`** — les 10 derniers commits
@@ -160,26 +158,18 @@ référence cassée.  Soit :
 Quand le fichier sera créé en réalité, abaisser
 ``BROKEN_PATHS_BASELINE``.
 
-### 3.F Test parité legacy ↔ canonique
-
-``tests/architecture/test_legacy_canonical_parity.py`` maintient
-une table 3-états (``LEGACY_PARITY``) :
-
-- ``canonical: <module.symbol>`` — équivalent canonique existe.
-  Le test vérifie présence + signatures compatibles.
-- ``dropped: <raison>`` — feature volontairement abandonnée
-  avec justification écrite.
-- ``unmigrated: <cible prévue>`` — migration prévue ; cible
-  peut ne pas encore exister.
-
-À chaque migration d'un symbole, **mettre à jour la table**.
-Les symboles non trackés sont comptés via
-``BOOTSTRAP_BASELINE`` (à diminuer à chaque session).
+### 3.F Test parité legacy ↔ canonique (retiré au sprint H.5)
 
-Limites du test : il ne vérifie que la **présence** et les
-**signatures**, pas le comportement réel.  Les différences
-sémantiques sont signalées via le champ ``behavior_diff``
-optionnel.
+``tests/architecture/test_legacy_canonical_parity.py`` a été
+supprimé au sprint H.5 (mai 2026) : la table 3-états était
+vidée au fil des Lots A-G (chaque entrée retirée en même temps
+que le shim concerné), et tous les paquets legacy top-level
+qu'elle scannait (``llm/``, ``measurements/``, ``engines/``,
+``modules/``, ``report/``, ``core/``, ``cli/``, ``web/``,
+``extras/``, ``pipelines/``) ont été supprimés ou relocalisés
+sous ``adapters/legacy_*`` et ``interfaces/*/_legacy/``.  Le
+seul invariant qui reste à garder est l'absence d'import legacy
+depuis le rewrite (``test_no_legacy_imports_in_rewrite``).
 
 ### 3.G README généré
 
@@ -243,17 +233,9 @@ sprint par sprint en migrant chaque caller.
 
 ### 4.C Symboles legacy non tracés dans la table de parité
 
-**110 symboles** publics dans les paquets legacy ne sont pas
-encore dans
-``tests/architecture/test_legacy_canonical_parity.py::LEGACY_PARITY``.
-Répartition :
-
-- ``measurements/`` : 104
-- ``pipelines/`` : 6
-
-Le test ``test_no_untracked_legacy_symbol_above_baseline``
-autorise temporairement 110 (``BOOTSTRAP_BASELINE = 110``).
-À diminuer à chaque session.
+**Sans objet à v2.0** : la table de parité a été retirée au
+sprint H.5, en même temps que la suppression des derniers
+paquets legacy top-level (cf. 3.F).
 
 ### 4.D Plan de bataille pour les imports tests
 
@@ -300,10 +282,11 @@ L'ordre recommandé, par lots de symboles cohérents :
      structure, taxonomy, taxonomy_comparison,
      taxonomy_cooccurrence, taxonomy_intra_doc, throughput,
      worst_lines}`` → ``evaluation.metrics.{...}``.
-   - ``picarones/measurements/__init__.py`` réécrit pour
+   - L'ancien ``measurements/__init__.py`` réécrit pour
      refléter la nouvelle composition (modules legacy
      restants + `import picarones.evaluation.metrics`
-     unique pour déclencher les décorateurs).
+     unique pour déclencher les décorateurs).  Tout le
+     sous-package a été supprimé au sprint E.6.
    - ``test_no_flat_files_in_measurements::WHITELIST_FLAT_FILES_S3``
      réduit de 60 → 25 entrées.
    - ``test_module_coverage::TEST_ONLY_BASELINE`` réduit
@@ -389,101 +372,38 @@ commit (principe « no shim survives its caller »).
 
 ---
 
-## 5. Prochaine sub-phase à exécuter
-
-**Sub-phase 7.B.2** — refactoriser le corps de
-``PipelineRunner.run`` dans
-``picarones/evaluation/pipeline.py`` (lignes 384-590) pour
-qu'il délègue au canonique ``PipelineExecutor`` via le
-wrapper ``_BaseModuleAdapter`` créé en 7.B.1.
-
-### Plan d'exécution
-
-1. **Lire** ``picarones/evaluation/pipeline.py:PipelineRunner.run``
-   en entier pour comprendre la logique actuelle (résolution
-   d'inputs versionnés, exécution chronométrée, capture
-   d'erreur, évaluation auto vs GT, conversion outputs).
-
-2. **(Phase 7.D — module supprimé)** : ``_BaseModuleAdapter`` et
-   ``_PayloadRegistry`` vivaient dans ``_legacy_module_adapter.py``,
-   retiré avec le runner en 7.D.
-
-3. **Écrire** un nouveau corps de ``PipelineRunner.run`` qui :
-   - Crée un ``_PayloadRegistry`` par appel.
-   - Wrappe les ``initial_inputs`` legacy via
-     ``wrap_initial_inputs(...)``.
-   - Convertit la ``PipelineSpec`` legacy en ``PipelineSpec``
-     canonique (``picarones.domain.pipeline_spec.PipelineSpec``).
-     Chaque ``PipelineStep.module: BaseModule`` devient un
-     ``adapter_name: str``, et l'adapter est
-     ``_BaseModuleAdapter(module, registry)``.
-   - Construit un ``adapter_resolver`` qui retourne le
-     wrapper de chaque module.
-   - Construit un ``RunContext``.
-   - Convertit le ``Document`` legacy en ``DocumentRef``.
-   - Invoque ``PipelineExecutor.run(canonical_spec,
-     document_ref, canonical_inputs, context)``.
-   - Reconvertit le ``PipelineResult`` canonique en
-     ``PipelineResult`` legacy.
-   - Calcule ``junction_metrics`` en post-étape (parcourt
-     les ``StepResult.produced_artifacts``, lit le payload
-     du registre, appelle ``compute_at_junction`` contre la
-     GT du document si ``GTLevel`` correspond).
-
-4. **Tester** : tous les tests existants doivent toujours
-   passer (les 7 fichiers axe B + ``test_sprint63_pipeline_runner``,
-   etc.).  C'est l'invariant de la sub-phase 7.B.2.
-
-5. **Lint** : ``ruff check picarones/ tests/``.
-
-6. **Commit + push** avec message décrivant ce qui a été
-   fait + pointer vers la sub-phase 7.B.3 comme prochaine
-   étape.
-
-### Alternative pragmatique
-
-Si le refactor 7.B.2 est trop gros pour une session,
-**commencer par le Lot A de la section 4.D** (migrer les ~30
-imports tests qui consomment ``core.modules`` et
-``core.facts`` vers leur canonique ``domain/``).  Cela vide
-une portion de la table de parité et permet de **supprimer les
-shims** ``core.modules.py`` et ``core.facts.py`` en bloc —
-résultat tangible et bien aligné avec le principe
-« suppression agressive ».
-
-Pareil pour Lots B-F : chaque lot est indépendant, fait
-progresser la migration, et démontre concrètement la
-suppression du legacy.
-
-### Pièges anticipés pour 7.B.2
-
-- **Sémantique différente des inputs entre legacy et canonique** :
-  le legacy passe ``Document.image_path`` comme un string
-  pur dans ``initial_inputs[ArtifactType.IMAGE]`` ; le canonique
-  attend un ``Artifact(uri=...)``.  ``wrap_initial_inputs``
-  fait la conversion mais il faut s'assurer que les modules
-  consomment bien le ``uri`` côté `_BaseModuleAdapter`.
-
-- **``junction_metrics`` calcul** : le legacy
-  ``PipelineRunner.run`` calcule ``junction_metrics`` à
-  chaque step (cf. ligne 519-540 actuellement).  Le canonique
-  ``PipelineExecutor`` ne le fait pas.  Il faut donc faire
-  ce calcul **après** l'exécution canonique, en parcourant
-  les artefacts produits et en lisant les payloads via le
-  registre.
-
-- **``output_types`` partial** : si un module produit un
-  output type non déclaré, le legacy le tolère (on remplit
-  ``StepResult.output_types`` avec ce qui est effectivement
-  produit, pas ce qui est déclaré).  Le canonique
-  ``PipelineExecutor`` rejette en ``error="missing_output: ..."``.
-  Vérifier la sémantique attendue par les tests.
-
-- **Spec conversion** : ``PipelineStep`` legacy a
-  ``inputs_from: dict[ArtifactType, str]`` (mapping
-  type→step_name).  ``PipelineStep`` canonique a
-  ``inputs_from: tuple[InputBinding, ...]``.  Conversion
-  attentive nécessaire.
+## 5. Prochaines sub-phases à exécuter (post H.5)
+
+Les sprints A-G + H.1-H.3 + H.5 ont été achevés.  Restent
+les chantiers suivants pour atteindre v2.0 :
+
+### H.2.b-d — refonte API ``BaseOCREngine`` → ``BaseOCRAdapter``
+
+- ``adapters/legacy_engines/`` (Tesseract, Pero, Mistral OCR,
+  Google Vision, Azure DI) doit être promu en
+  ``adapters/ocr/`` aux contrats ``StepExecutor``
+  (``execute(inputs, params, context)`` au lieu de
+  ``run(image_path)``).
+- Suppression de ``OCRLLMPipeline`` + ``adapters/legacy_pipelines/``
+  une fois les callers migrés vers la construction directe
+  d'une ``PipelineSpec`` via
+  ``picarones.pipeline.make_ocr_llm_pipeline_spec``.
+- Suppression de ``BaseOCREngine``, ``BaseModule``,
+  ``adapters/legacy_engines/``, ``adapters/legacy_pipelines/``.
+
+### H.4 — refonte interfaces
+
+- ``interfaces/cli/_legacy/`` : refondre les commandes Click
+  pour consommer directement ``BenchmarkService`` /
+  ``RunOrchestrator`` au lieu du runner legacy.
+- ``interfaces/web/_legacy/`` : refondre les routes FastAPI
+  pour consommer le rewrite pur (sans ``OCRLLMPipeline``).
+
+### H.6 — release v2.0
+
+- Bump version dans ``pyproject.toml`` + ``picarones/_version.py``.
+- Section CHANGELOG « 2.0.0 — Legacy retirement complete ».
+- Tag ``v2.0.0``.
 
 ---
 
@@ -500,7 +420,7 @@ section 2.
 Ou pour aller direct à l'action :
 
 ```
-Continue la sub-phase 7.B.2.
+Attaque H.2.b — refonte BaseOCREngine → BaseOCRAdapter.
 ```
 
 (Claude Code va automatiquement lire CLAUDE.md à l'init, qui

docs/reference/api-stable.md

@@ -8,14 +8,16 @@
 > [`docs/explanation/architecture.md`](../explanation/architecture.md)).
 >
 > **Pendant la migration** (jusqu'à la version 2.0), l'API
-> publique est en cours de refonte.  Tous les chemins legacy
-> (`picarones.core.X`, `picarones.measurements.X`, etc.) sont
-> des shims `DeprecationWarning` qui ré-exportent depuis le
-> canonique.  Les nouveaux imports doivent utiliser les chemins
-> canoniques (`picarones.domain.*`, `picarones.evaluation.*`).
->
-> Le tableau de parité legacy ↔ canonique vit dans
-> [`tests/architecture/test_legacy_canonical_parity.py`](../../tests/architecture/test_legacy_canonical_parity.py).
+> publique est en cours de refonte.  Les chemins legacy
+> top-level (`picarones.core.*`, `picarones.measurements.*`,
+> `picarones.engines.*`, `picarones.modules.*`,
+> `picarones.report.*`, `picarones.llm.*`,
+> `picarones.cli.*`, `picarones.extras.*`,
+> `picarones.fixtures`) ont **tous été supprimés**.  Les
+> nouveaux imports doivent utiliser les chemins canoniques
+> (`picarones.domain.*`, `picarones.evaluation.*`,
+> `picarones.adapters.*`, `picarones.reports.*`,
+> `picarones.interfaces.*`).
 
 ## Définition
 

docs/reference/normalization-profiles.md

@@ -150,7 +150,7 @@ def my_hook(*, ground_truth, hypothesis, image_path, corpus_lang, ocr_result):
 
 - [`picarones/evaluation/metric_hooks.py`](../picarones/evaluation/metric_hooks.py)
   — registre, profils, `run_document_hooks()`, `run_corpus_aggregators()`.
-- [`picarones/measurements/builtin_hooks.py`](../picarones/measurements/builtin_hooks.py)
+- [`picarones/evaluation/metrics/builtin_hooks.py`](../picarones/evaluation/metrics/builtin_hooks.py)
   — les 12 hooks doc + 12 agrégateurs natifs Picarones.
 - [`tests/test_metric_hooks.py`](../tests/test_metric_hooks.py)
   — tests unitaires + rétrocompat profil `standard`.

tests/architecture/test_doc_paths.py

@@ -116,7 +116,17 @@ REPO_ROOT = Path(__file__).resolve().parents[2]
 # ``picarones.pipeline.legacy_*``.  Les docs concernées
 # (CHANGELOG.md, audits, sub-plans) gardent volontairement les
 # anciens chemins pour la traçabilité historique.
-BROKEN_PATHS_BASELINE = 172
+# Sprint H.5 : -11 broken paths — fix des refs actives dans
+# docs/how-to/cli-workflows.md (cli/ → interfaces/cli/_legacy/,
+# extras/importers/_http.py → adapters/corpus/_http.py),
+# docs/explanation/narrative-engine{.,en}.md (measurements/narrative/
+# → reports/narrative/, fixtures.py → evaluation/synthetic.py),
+# docs/reference/normalization-profiles.md (measurements/builtin_hooks
+# → evaluation/metrics/builtin_hooks), docs/developer/doc-consistency.md
+# (engines/, cli/, web/ → leurs nouveaux chemins),
+# docs/migration/SESSION_HANDOVER.md (refonte section 5 pour pointer
+# vers H.2.b-d/H.4/H.6 au lieu de l'ex sub-phase 7.B.2 obsolète).
+BROKEN_PATHS_BASELINE = 161
 
 #: Patrons de fichiers de documentation à scanner.
 DOC_GLOBS: tuple[str, ...] = (

tests/architecture/test_legacy_canonical_parity.py

@@ -1,391 +0,0 @@
-"""Test architectural — parité legacy ↔ canonique.
-
-Pourquoi ce test
-----------------
-Le retrait du legacy se fait par phases (cf. :doc:`docs/migration/legacy-retirement-plan.md`).
-À chaque phase, des symboles publics legacy migrent vers leur
-équivalent canonique.  Sans garde-fou, deux risques :
-
-1. **Suppression silencieuse d'une feature** : un symbole legacy
-   disparaît sans équivalent canonique → la feature est perdue.
-2. **Drift de l'API** : un nouveau symbole legacy est ajouté
-   sans équivalent canonique → la dette de migration grossit.
-
-Ce test maintient un **journal de bord vivant** :
-:data:`LEGACY_PARITY` est une table 3-états qui pour chaque
-symbole legacy connu déclare :
-
-- ``canonical: <module.symbol>`` — symbole équivalent dans
-  l'arbre canonique.
-- ``dropped: <raison>`` — feature volontairement abandonnée.
-- ``unmigrated: <cible prévue>`` — migration prévue, à venir.
-
-Limites du test
----------------
-**Ce test ne vérifie que la présence de symbole, pas le
-comportement.**  Deux symboles peuvent porter le même nom et
-avoir des sémantiques différentes (cf. ``ArtifactType`` 6 vs 10
-valeurs).  Les différences comportementales sont signalées par
-le champ optionnel ``behavior_diff`` qui sert de mémoire à
-l'équipe.
-
-Pour la vérification comportementale réelle :
-
-- Les tests unitaires métier couvrent les usages individuels.
-- Le test d'intégration ``tests/integration/test_sprint_a14_s12_executor_equivalence.py``
-  compare des comportements bout-en-bout.
-- La régression bit-for-bit sur les rapports HTML (cible Phase
-  11 du retrait du legacy) couvrira la sortie utilisateur finale.
-
-Maintenance
------------
-- À chaque migration d'un symbole, ajouter ou mettre à jour son
-  entrée dans :data:`LEGACY_PARITY`.
-- Si un nouveau symbole legacy est introduit (rare mais possible
-  pour patcher un bug bloquant), l'inscrire avec
-  ``"unmigrated": "<cible>"``.
-- Si un symbole est supprimé du legacy, retirer son entrée.
-- ``BOOTSTRAP_BASELINE`` autorise temporairement N symboles non
-  trackés ; à diminuer à chaque session de migration.
-"""
-
-from __future__ import annotations
-
-import ast
-import importlib
-import inspect
-import warnings
-from pathlib import Path
-from typing import Any
-
-import pytest
-
-REPO_ROOT = Path(__file__).resolve().parents[2]
-
-#: Paquets legacy (cf. ``test_no_legacy_imports_in_rewrite``).
-LEGACY_PACKAGES: tuple[str, ...] = (
-    "llm",
-)
-
-#: Combien de symboles legacy peuvent être absents de
-#: :data:`LEGACY_PARITY` sans faire échouer le test.  À diminuer
-#: à chaque session de migration : on cible 0 quand le retrait
-#: est complet.
-BOOTSTRAP_BASELINE = 0
-
-
-# ──────────────────────────────────────────────────────────────────
-# Table de parité legacy ↔ canonique
-# ──────────────────────────────────────────────────────────────────
-
-#: Entrée de :data:`LEGACY_PARITY`.  Exactement une des trois
-#: clés (``canonical``, ``dropped``, ``unmigrated``) est
-#: renseignée par entrée.
-ParityEntry = dict[str, Any]
-
-
-#: Mapping ``"<legacy_module>.<symbol>" → entry``.  Les entrées
-#: sont ajoutées au fil des phases de migration ; la table est le
-#: journal de bord vivant du retrait du legacy.
-#:
-#: État initial : seed des migrations déjà effectuées (Phases
-#: 1, 4-bis, 4-ter, 4-quater, 7.A).  À étendre à chaque sprint.
-LEGACY_PARITY: dict[str, ParityEntry] = {
-    # ──────────────────────────────────────────────────────────
-    # Phase 1 — diff_utils, xml_utils, facts
-    # ──────────────────────────────────────────────────────────
-    # Lot G (mai 2026) : ``picarones.core`` entièrement supprimé.
-    # Les helpers ``compute_word_diff``, ``compute_char_diff``,
-    # ``diff_stats`` vivent désormais uniquement dans
-    # ``picarones.evaluation._diff_utils`` ; ``safe_parse_xml``
-    # uniquement dans ``picarones.formats._xml_utils``.
-    # ``core.facts`` et ``core.modules`` avaient déjà été
-    # supprimés en Lot A.  Les entrées correspondantes ont été
-    # retirées de cette table pour garder l'alignement avec
-    # l'arbre legacy réellement présent sur disque.
-    # ──────────────────────────────────────────────────────────
-    # Phase 4-ter — metric_registry, metric_hooks, metrics
-    # ─────────────────────────────────────────────���────────────
-    # ``core.metric_registry``, ``core.metric_hooks`` et
-    # ``core.metrics`` ont été supprimés (Lot B de la migration
-    # core → evaluation).  Les symboles publics
-    # (MetricSpec, register_metric, compute_at_junction, …,
-    # PROFILE_*, KNOWN_PROFILES, MetricsResult, aggregate_metrics)
-    # sont exposés depuis
-    # ``picarones.evaluation.{metric_registry, metric_hooks,
-    # metric_result}``.  Comme pour le Lot A, les entrées sont
-    # retirées en même temps que les shims pour garder la table
-    # alignée avec l'arbre legacy réellement présent sur disque.
-    # ──────────────────────────────────────────────────────────
-    # Phase 4-ter résiduel + 4-quater + 5.C.batch7 — results,
-    # corpus, pipeline (Lot C)
-    # ──────────────────────────────────────────────────────────
-    # ``core.results``, ``core.corpus`` et ``core.pipeline`` ont
-    # été supprimés (Lot C de la migration core → evaluation).
-    # Les symboles publics (BenchmarkResult, EngineReport,
-    # DocumentResult, Document, Corpus, GTLevel, TextGT, AltoGT,
-    # PageGT, EntitiesGT, ReadingOrderGT, load_corpus_from_directory,
-    # PipelineRunner, PipelineSpec, PipelineStep, PipelineResult,
-    # StepResult) sont exposés depuis
-    # ``picarones.evaluation.{benchmark_result, corpus, pipeline}``.
-    # Comme pour les Lots A et B, les entrées sont retirées en
-    # même temps que les shims pour garder la table alignée avec
-    # l'arbre legacy réellement présent sur disque.
-    # Note 7.B-7.D : le ``PipelineRunner`` canonique reste
-    # transitoire et délègue progressivement à
-    # ``PipelineExecutor`` (cf. pipeline-convergence-plan.md).
-    # ──────────────────────────────────────────────────────────
-    # Phase 7.A + Lot E — engines, modules
-    # ──────────────────────────────────────────────────────────
-    # ``picarones/engines/`` et ``picarones/modules/`` ont été
-    # supprimés (Lot E de la migration legacy → adapters/legacy_*).
-    # Les classes (BaseOCREngine, EngineResult, TesseractEngine,
-    # PeroOCREngine, MistralOCREngine, GoogleVisionEngine,
-    # AzureDocIntelEngine, engine_from_name, TextToAltoMonoRegion)
-    # sont exposées depuis
-    # ``picarones.adapters.legacy_engines.{...}`` et
-    # ``picarones.adapters.legacy_modules.alto_text_to_mono_region``.
-    # Comme pour les Lots précédents, les entrées ont été retirées
-    # pour garder la table alignée avec l'arbre legacy réellement
-    # présent sur disque.
-    # Note 7.D : ces adapters legacy seront eux-mêmes refondus en
-    # ``BaseOCRAdapter (StepExecutor)`` lors de la convergence
-    # pipeline (cf. pipeline-convergence-plan.md).
-}
-
-
-# ──────────────────────────────────────────────────────────────────
-# Helpers
-# ──────────────────────────────────────────────────────────────────
-
-
-def _resolve(dotted: str) -> Any | None:
-    """Résout ``"package.module.symbol"`` en l'objet effectif.
-
-    Retourne ``None`` si la résolution échoue (module introuvable
-    ou symbole absent).  Émet un warning silencieux : on
-    ignore les ``DeprecationWarning`` des shims.
-    """
-    parts = dotted.rsplit(".", 1)
-    if len(parts) != 2:
-        return None
-    module_path, symbol = parts
-    try:
-        with warnings.catch_warnings():
-            warnings.simplefilter("ignore", DeprecationWarning)
-            module = importlib.import_module(module_path)
-    except ImportError:
-        return None
-    return getattr(module, symbol, None)
-
-
-def _signatures_compatible(legacy_obj: Any, canonical_obj: Any) -> bool:
-    """Vérifie que deux callables ont des signatures compatibles.
-
-    Compatible = même nombre de paramètres positionnels.  Pour
-    les classes, on inspecte ``__init__``.  Si l'un des deux
-    n'est pas inspectable (e.g. C-builtin), on retourne ``True``
-    (on ne peut pas comparer).
-    """
-    try:
-        sig_legacy = inspect.signature(legacy_obj)
-        sig_canonical = inspect.signature(canonical_obj)
-    except (TypeError, ValueError):
-        # Pas un callable inspectable : on tolère
-        return True
-    pos_legacy = [
-        p for p in sig_legacy.parameters.values()
-        if p.kind in (
-            inspect.Parameter.POSITIONAL_ONLY,
-            inspect.Parameter.POSITIONAL_OR_KEYWORD,
-        )
-    ]
-    pos_canonical = [
-        p for p in sig_canonical.parameters.values()
-        if p.kind in (
-            inspect.Parameter.POSITIONAL_ONLY,
-            inspect.Parameter.POSITIONAL_OR_KEYWORD,
-        )
-    ]
-    return len(pos_legacy) == len(pos_canonical)
-
-
-def _scan_legacy_public_symbols() -> set[str]:
-    """Liste tous les symboles publics top-level dans les
-    paquets legacy.
-
-    Scanne via AST (statique, plus stable que ``import + dir``).
-    Retourne les ``"<full_module_path>.<symbol_name>"``.
-    """
-    out: set[str] = set()
-    for pkg in LEGACY_PACKAGES:
-        root = REPO_ROOT / "picarones" / pkg
-        if not root.is_dir():
-            continue
-        for path in root.rglob("*.py"):
-            if "__pycache__" in path.parts:
-                continue
-            if path.name == "__init__.py":
-                continue  # __init__ : on ne tracke que les modules nommés
-            try:
-                tree = ast.parse(path.read_text(encoding="utf-8"))
-            except (OSError, SyntaxError):
-                continue
-            module_name = ".".join(
-                ["picarones", *path.relative_to(REPO_ROOT / "picarones").with_suffix("").parts]
-            )
-            for node in tree.body:
-                names: list[str] = []
-                if isinstance(node, (ast.FunctionDef, ast.AsyncFunctionDef, ast.ClassDef)):
-                    names.append(node.name)
-                elif isinstance(node, ast.Assign):
-                    for target in node.targets:
-                        if isinstance(target, ast.Name):
-                            names.append(target.id)
-                for sym in names:
-                    if sym.startswith("_"):
-                        continue
-                    out.add(f"{module_name}.{sym}")
-    return out
-
-
-# ──────────────────────────────────────────────────────────────────
-# Tests
-# ──────────────────────────────────────────────────────────────────
-
-
-@pytest.mark.parametrize(
-    "legacy_path,entry",
-    sorted(LEGACY_PARITY.items()),
-    ids=lambda v: v if isinstance(v, str) else "",
-)
-def test_each_entry_is_resolvable(legacy_path: str, entry: ParityEntry) -> None:
-    """Chaque entrée doit avoir exactement un état renseigné.
-
-    Validation par entrée :
-
-    - ``canonical`` : les deux symboles existent + signatures
-      compatibles (warning si non).
-    - ``dropped``   : justification non vide.
-    - ``unmigrated``: cible non vide (le canonique peut ne pas
-      encore exister, c'est tout l'intérêt de cet état).
-    """
-    states = {"canonical", "dropped", "unmigrated"}
-    present = states & entry.keys()
-    assert len(present) == 1, (
-        f"{legacy_path} doit avoir exactement un de {states}, "
-        f"trouvé : {sorted(present)}"
-    )
-    state = next(iter(present))
-    if state == "canonical":
-        canonical_path = entry["canonical"]
-        legacy_obj = _resolve(legacy_path)
-        canonical_obj = _resolve(canonical_path)
-        assert legacy_obj is not None, (
-            f"Symbole legacy ``{legacy_path}`` introuvable.  "
-            "Si le symbole a été supprimé, retire son entrée de "
-            "LEGACY_PARITY."
-        )
-        assert canonical_obj is not None, (
-            f"Symbole canonique ``{canonical_path}`` introuvable.  "
-            "Vérifie le chemin canonique ou que le module existe."
-        )
-        assert _signatures_compatible(legacy_obj, canonical_obj), (
-            f"Signatures incompatibles entre ``{legacy_path}`` et "
-            f"``{canonical_path}``.  Mets à jour ``behavior_diff`` "
-            "pour documenter le changement, ou aligne les signatures."
-        )
-    elif state == "dropped":
-        reason = entry["dropped"]
-        assert isinstance(reason, str) and reason.strip(), (
-            f"{legacy_path} marqué dropped sans justification.  "
-            "Ajoute la raison du drop pour traçabilité."
-        )
-    elif state == "unmigrated":
-        target = entry["unmigrated"]
-        assert isinstance(target, str) and target.strip(), (
-            f"{legacy_path} marqué unmigrated sans cible.  "
-            "Ajoute le chemin canonique prévu."
-        )
-
-
-def test_no_untracked_legacy_symbol_above_baseline() -> None:
-    """Tout symbole public legacy doit être tracé dans :data:`LEGACY_PARITY`.
-
-    Mode bootstrap : :data:`BOOTSTRAP_BASELINE` autorise N
-    symboles non trackés.  À diminuer à chaque sprint de
-    migration ; cible 0 quand la migration est complète.
-    """
-    public_symbols = _scan_legacy_public_symbols()
-    untracked = public_symbols - LEGACY_PARITY.keys()
-    if len(untracked) > BOOTSTRAP_BASELINE:
-        sample = "\n".join(f"  {s}" for s in sorted(untracked)[:30])
-        more = (
-            f"\n  ... ({len(untracked) - 30} de plus)"
-            if len(untracked) > 30
-            else ""
-        )
-        raise AssertionError(
-            f"\n{len(untracked)} symbole(s) legacy non tracé(s) "
-            f"dans LEGACY_PARITY (baseline {BOOTSTRAP_BASELINE}).\n\n"
-            f"{sample}{more}\n\n"
-            "Ajoute chaque symbole à LEGACY_PARITY avec son état :\n"
-            "  - ``canonical: <module.symbol>`` si déjà migré\n"
-            "  - ``dropped: <raison>`` si abandonné\n"
-            "  - ``unmigrated: <cible prévue>`` si encore à venir\n\n"
-            "Ou abaisse BOOTSTRAP_BASELINE si on est sous le seuil "
-            "(faute de quoi le test ne progresse plus)."
-        )
-
-
-def test_baseline_should_tighten_when_progress() -> None:
-    """Si on est sous le baseline, abaisser BOOTSTRAP_BASELINE.
-
-    Ce test est l'inverse du précédent : il rappelle que le
-    baseline doit suivre la progression.  Pareil pattern que
-    ``test_doc_paths::test_baseline_must_be_tightened_when_progress_made``.
-    """
-    public_symbols = _scan_legacy_public_symbols()
-    untracked = public_symbols - LEGACY_PARITY.keys()
-    assert len(untracked) >= BOOTSTRAP_BASELINE, (
-        f"\nExcellent : {len(untracked)} symboles non tracés vs "
-        f"baseline {BOOTSTRAP_BASELINE}.\n"
-        "Mets à jour BOOTSTRAP_BASELINE dans "
-        "tests/architecture/test_legacy_canonical_parity.py."
-    )
-
-
-def test_canonical_paths_dont_themselves_use_legacy() -> None:
-    """Les cibles canoniques ne doivent pas pointer vers du legacy.
-
-    Cas pathologique : on déclare ``canonical:
-    picarones.evaluation.X`` mais ``picarones.evaluation.X``
-    importe en interne depuis ``picarones.core.Y``.  Ce serait un
-    bug d'aiguillage.
-
-    Ce test ne couvre pas le cas (couverture par
-    ``test_no_legacy_imports_in_rewrite``) ; ici on se contente
-    de vérifier que les cibles canoniques sont dans des paquets
-    rewrite reconnus.
-    """
-    REWRITE_PREFIXES = (
-        "picarones.domain.",
-        "picarones.formats.",
-        "picarones.evaluation.",
-        "picarones.pipeline.",
-        "picarones.adapters.",
-        "picarones.app.",
-        "picarones.reports.",
-        "picarones.interfaces.",
-    )
-    misrouted: list[tuple[str, str]] = []
-    for legacy, entry in LEGACY_PARITY.items():
-        canonical = entry.get("canonical")
-        if not canonical:
-            continue
-        if not canonical.startswith(REWRITE_PREFIXES):
-            misrouted.append((legacy, canonical))
-    assert not misrouted, (
-        "Cibles canoniques en dehors des paquets rewrite :\n"
-        + "\n".join(f"  {legacy} → {canonical}" for legacy, canonical in misrouted)
-    )