docs(sprint-H.9): archive migration plans + cleanup stale doc paths

Sprint H.9 — finalisation de la doc post-v2.0. Avant H.9, les
plans de migration et ~17 fichiers de documentation référençaient
encore les paquets ``picarones.{core,measurements,engines,modules,
report,llm,pipelines,cli,web,extras}/`` supprimés.

Archivage docs/migration/
-------------------------

``docs/migration/`` → ``docs/archives/migration/``. 7 fichiers
déplacés (``legacy-retirement-plan.md``, ``pipeline-convergence-plan.md``,
``rewrite-status-s46.md``, ``sprint-D-audit.md``,
``executor-equivalence.md``, ``regression-tolerances.md``,
``SESSION_HANDOVER.md``).

Ajout de ``docs/archives/migration/README.md`` qui :
- déclare la migration **terminée à v2.0** ;
- liste les 7 documents avec leur statut historique ;
- explique pourquoi conserver l'archive (traçabilité
institutionnelle, documentation des choix, référence pour
renames futurs) ;
- pointe vers la doc active (``docs/explanation/architecture.md``,
``docs/reference/api-stable.md``, ``CLAUDE.md``,
``CHANGELOG.md`` section [2.0.0]).

Refs archivées (intentionnel) : les fichiers déplacés gardent
leurs références internes vers les paquets supprimés. C'est de
l'historique, pas de la doc active.

Cleanup massif des paths dans la doc active
-------------------------------------------

Replace via script ``cleanup_docs.py`` :

- 17 fichiers ``docs/{developer,explanation,reference,roadmap,
how-to,operations}/`` mis à jour.
- ~80 patterns de remplacement appliqués (longest first pour
matcher les paths spécifiques avant les génériques).

Catégories de remplacement
~~~~~~~~~~~~~~~~~~~~~~~~~~

**Adapter legacy → canonique** :
- ``picarones.adapters.legacy_engines.{tesseract,pero_ocr,...}.{X}Engine``
→ ``picarones.adapters.ocr.{X}.{X}Adapter``
- ``picarones.adapters.legacy_pipelines.base.OCRLLMPipeline``
→ ``picarones.pipeline.llm_pipeline_config.OCRLLMPipelineConfig``

**Mesures** :
- ``picarones.measurements.{X}`` → ``picarones.evaluation.metrics.{X}``
- ``picarones.measurements.statistics`` → ``picarones.evaluation.statistics``
- ``picarones.measurements.runner`` → ``picarones.app.services.benchmark_runner``

**Couche 1 historique → domain/evaluation** :
- ``picarones.core.metric_registry`` → ``picarones.evaluation.metric_registry``
- ``picarones.core.modules.{ArtifactType,BaseModule}`` →
``picarones.domain.{artifacts,module_protocol}.{X}``
- ``picarones.core`` → ``picarones.domain``

**Top-level supprimés** :
- ``picarones.{engines,modules}`` → ``picarones.adapters.{ocr,...}``
- ``picarones.report`` → ``picarones.reports.html``
- ``picarones.{llm,pipelines,cli,web,extras}`` →
``picarones.{adapters.llm,pipeline,interfaces.cli,interfaces.web,
evaluation.metrics}``
- ``picarones.fixtures`` → ``picarones.evaluation.synthetic``

**Filesystem paths** : idem en chemin Unix.

**Refs résiduelles aux ``_legacy/``** : ``docs/how-to/cli-workflows.md``
+ ``docs/developer/doc-consistency.md`` dépointaient vers
``picarones/interfaces/{cli,web}/_legacy/`` (depuis avant H.4) ;
re-pointés vers ``picarones/interfaces/{cli,web}/``.

Spécifique
~~~~~~~~~~

- ``docs/explanation/architecture.md`` : ref ``rewrite-status-s46.md``
→ ``../archives/migration/rewrite-status-s46.md``.
- ``README.md`` : ``see docs/migration/`` →
``see docs/archives/migration/``.
- ``tests/architecture/test_no_legacy_imports_in_rewrite.py``
(commentaire docstring) : ``docs/migration/legacy-retirement-plan.md``
→ ``docs/archives/migration/legacy-retirement-plan.md``.
- ``docs/roadmap/evolution-2026.md`` : ``picarones/domain/modules.py``
→ ``picarones/domain/module_protocol.py`` (rename historique
jamais répercuté dans la doc).
- ``docs/developer/index.md`` : tree d'arborescence mis à jour
(~30 → ~37 métriques, retrait des entrées ``legacy_engines/``,
``legacy_modules/``, ``corpus.py (legacy en cours de retrait)``,
``pipeline.py (legacy)``, etc.).

Tests
-----

- ``test_doc_paths::BROKEN_PATHS_BASELINE`` : 169 → 162
(-7 chemins cassés). Les 162 restants sont des refs
historiques dans :
- ``CHANGELOG.md`` bloc « Migration depuis 1.x » (par construction
nomme les anciens chemins).
- ``docs/audits/`` audits institutionnels figés au moment de
leur écriture.
- ``docs/archives/migration/`` plans de migration archivés.
- ``SPECS.md`` (legacy reference).
- ``pytest tests/`` : 4126 passed, 9 skipped.
- ``ruff check`` : All checks passed.

État de la doc post-H.9
-----------------------

- **Doc active** (``docs/{developer,explanation,reference,roadmap,
how-to,operations,api,case-studies,security,legal,tutorials}``) :
réfère uniquement les chemins canoniques.
- **Archives** (``docs/archives/migration``) : plans terminés,
conservés pour traçabilité.
- **Audits** (``docs/audits``) : audits institutionnels figés, refs
historiques préservées.
- **CHANGELOG** : section [2.0.0] avec bloc « Migration depuis
1.x » qui nomme volontairement les anciens chemins.

Reste pour la release
---------------------

H.7 + H.8 + H.9 livrent le cleanup. Le tag ``v2.0.0`` reste à
faire manuellement par l'utilisateur après revue (cf. message du
commit H.6).

https://claude.ai/code/session_01NxyVKqg2SowXLZdM4H1ZDE

README.md

@@ -331,7 +331,7 @@ picarones/
 
 Legacy paths (`core/, measurements/, engines/, llm/, pipelines/,
 report/, modules/`) still present as shims, in active retirement
-(see `docs/migration/`).  Strict 8-layer architecture: imports flow
+(see `docs/archives/migration/`).  Strict 8-layer architecture: imports flow
 outer → inner. Enforced by
 `tests/architecture/test_layer_dependencies.py`. See
 [`docs/explanation/architecture.md`](docs/explanation/architecture.md)

docs/archives/migration/README.md

@@ -0,0 +1,43 @@
+# Archives — plans de migration legacy → rewrite (2026-04 / 2026-05)
+
+Ces documents décrivent la migration de l'arborescence pré-rewrite
+(`picarones/{core,measurements,engines,modules,report,llm,
+pipelines,cli,web,extras}/`) vers l'architecture canonique en 8
+couches (`domain → formats → evaluation → pipeline → adapters →
+app → reports → interfaces`).
+
+**La migration est terminée à v2.0** (mai 2026).  Tous les
+paquets legacy ont été supprimés ; ces plans sont archivés ici à
+titre historique.
+
+## Contenu
+
+| Document | Statut historique |
+|---|---|
+| `legacy-retirement-plan.md` | Plan maître des Phases 0-11 + Lots A-G + Sprints H.1-H.6.  Cartographie complète du retrait. |
+| `pipeline-convergence-plan.md` | Sub-plan de la Phase 7 (BaseModule → StepExecutor). |
+| `rewrite-status-s46.md` | Snapshot de l'état du rewrite ciblé après le Sprint 46 (avant l'audit institutionnel S47-S59). |
+| `sprint-D-audit.md` | Audit du Sprint D (façade `run_benchmark_via_service`). |
+| `executor-equivalence.md` | Preuve d'équivalence numérique entre `PipelineRunner` legacy et `PipelineExecutor` canonique. |
+| `regression-tolerances.md` | Contrat des tolérances pour le harness `tests/regression/legacy_vs_rewrite/` (harness lui-même retiré au cleanup post-v2.0). |
+| `SESSION_HANDOVER.md` | Procédure de reprise de session entre instances Claude pendant la migration.  Caduc à v2.0. |
+
+## Pourquoi conserver ces archives ?
+
+1. **Traçabilité institutionnelle** : la BnF et autres consommateurs
+   doivent pouvoir auditer la genèse de l'architecture v2.0.
+2. **Documentation des choix** : les plans expliquent *pourquoi*
+   tel module a été déplacé là plutôt qu'ailleurs.
+3. **Référence pour les renames futurs** : si un mainteneur
+   futur doit re-déplacer un module, ces plans documentent les
+   contraintes architecturales (whitelist, inward-only, layer
+   imports legal).
+
+## Lecture pour comprendre l'architecture actuelle
+
+Pour la doc **active**, voir :
+
+- [`docs/explanation/architecture.md`](../../explanation/architecture.md) — manifeste 8 couches.
+- [`docs/reference/api-stable.md`](../../reference/api-stable.md) — contrat de stabilité API.
+- [`CLAUDE.md`](../../../CLAUDE.md) — quickstart pour mainteneurs.
+- [`CHANGELOG.md`](../../../CHANGELOG.md) section [2.0.0] — résumé des suppressions.

docs/developer/doc-consistency.md

@@ -30,11 +30,11 @@ Vérifie que :
 
 | Item | Source de vérité | Sens du contrat |
 |---|---|---|
-| 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 |
+| Moteurs OCR | `picarones/adapters/ocr/*.py` | Tout moteur listé dans le tableau « Supported Engines » du README doit avoir un adapter |
+| Commandes CLI | `picarones/interfaces/cli/*.py` (Click) | Toute commande listée dans le README doit apparaître dans `picarones --help` |
+| Endpoints API | `picarones/interfaces/web/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/adapters/legacy_engines/aws*.py` | Si documentées, un adapter doit exister |
+| Variables `AWS_*` | `picarones/adapters/ocr/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
@@ -126,8 +126,8 @@ et accepte si l'un des mots `reporté`, `abandonné`, `non implémenté`,
 
 | Vous modifiez… | Vous devez aussi… |
 |---|---|
-| `picarones/engines/<X>.py` (nouveau) | Ajouter une ligne dans le tableau « Supported Engines » du README |
-| `picarones/cli/_<X>.py` (nouveau) | Ajouter la commande dans la table CLI du README |
+| `picarones/adapters/ocr/<X>.py` (nouveau) | Ajouter une ligne dans le tableau « Supported Engines » du README |
+| `picarones/interfaces/cli/_<X>.py` (nouveau) | Ajouter la commande dans la table CLI du README |
 | Un nouveau endpoint FastAPI | Ajouter dans la table « API endpoints » du README |
 | Le nombre de tests | Mettre à jour les 3 mentions dans README (l/583, l/623, l/660) |
 | Une promesse SPECS qui devient sans objet | Soit retirer la mention, soit ajouter dans le bloc `known-abandoned`, soit ajouter une note locale |

docs/developer/extending-glossary.en.md

@@ -14,8 +14,8 @@ panel with the entry's full content.
 
 The glossary lives in **two YAML files** that must stay in sync:
 
-- `picarones/report/glossary/fr.yaml`
-- `picarones/report/glossary/en.yaml`
+- `picarones/reports/html/glossary/fr.yaml`
+- `picarones/reports/html/glossary/en.yaml`
 
 Each entry has the following schema:
 
@@ -51,7 +51,7 @@ your_metric_key:
 
 The `?` icon is rendered automatically when a `<th>` carries the
 `data-glossary-key="your_metric_key"` attribute. See for example
-`picarones/report/templates/view_ranking.html` line ~13.
+`picarones/reports/html/templates/view_ranking.html` line ~13.
 
 ## Tests
 

docs/developer/extending-glossary.md

@@ -1,7 +1,7 @@
 # Étendre le glossaire contextuel
 
 Le glossaire affiché dans le panneau latéral du rapport est défini en
-YAML, une entrée par terme, dans `picarones/report/glossary/{lang}.yaml`.
+YAML, une entrée par terme, dans `picarones/reports/html/glossary/{lang}.yaml`.
 
 ## Ajouter un terme
 
@@ -30,7 +30,7 @@ Tous les champs (`title`, `definition`, `measures`, `usage`, `limits`,
 
 ## Brancher l'entrée à une colonne du rapport
 
-Dans `picarones/report/templates/view_ranking.html` (ou un autre fichier
+Dans `picarones/reports/html/templates/view_ranking.html` (ou un autre fichier
 de vue), ajoutez l'attribut `data-glossary-key` sur l'en-tête de
 colonne :
 
@@ -59,13 +59,13 @@ Au démarrage du rapport, `injectGlossaryButtons()` parcourt tous les
 
 ## Ajouter une langue
 
-Créez `picarones/report/glossary/de.yaml` avec la même structure que
+Créez `picarones/reports/html/glossary/de.yaml` avec la même structure que
 `fr.yaml`. Le loader le détecte automatiquement via
 `Path.glob("*.yaml")`.
 
 Pour qu'un utilisateur puisse choisir cette langue :
 
-1. Ajouter `picarones/report/i18n/de.json` (traductions de l'interface).
+1. Ajouter `picarones/reports/html/i18n/de.json` (traductions de l'interface).
 2. Aucune modification de code requise — `load_glossary("de")` marchera.
 
 ## Tests

docs/developer/extending-i18n.en.md

@@ -15,8 +15,8 @@ This guide covers:
 
 Two JSON files store all UI strings:
 
-- `picarones/report/i18n/fr.json` — French (canonical)
-- `picarones/report/i18n/en.json` — English
+- `picarones/reports/html/i18n/fr.json` — French (canonical)
+- `picarones/reports/html/i18n/en.json` — English
 
 Both files **must have the exact same set of keys** — any drift
 fails `tests/report/test_a11y_level_aa.py::test_i18n_fr_en_have_same_keys`.
@@ -53,14 +53,14 @@ appropriate BCP-47 code (e.g. `de-DE`, `es-ES`, `it-IT`).
 
 1. Copy `fr.json` to `<lang>.json` (e.g. `de.json`) and translate
    every value. Keep the keys identical.
-2. Add the language to `picarones/web/state.SUPPORTED_LANGS`:
+2. Add the language to `picarones/interfaces/web/state.SUPPORTED_LANGS`:
    ```python
    SUPPORTED_LANGS = frozenset({"fr", "en", "de"})
    ```
-3. Add the same key in `picarones/report/glossary/<lang>.yaml`
+3. Add the same key in `picarones/reports/html/glossary/<lang>.yaml`
    with translated definitions (cf. [`extending-glossary.en.md`](extending-glossary.en.md)).
 4. Add `<lang>` to the narrative templates:
-   `picarones/measurements/narrative/templates/<lang>.yaml`.
+   `picarones/evaluation/metrics/narrative/templates/<lang>.yaml`.
 5. Add the language switcher entry in the report header (if any).
 
 ## Tests

docs/developer/extending-i18n.md

@@ -5,14 +5,14 @@ convention de fichiers JSON par langue :
 
 | Système | Fichier | Contenu |
 |---------|---------|---------|
-| Interface du rapport HTML | `picarones/report/i18n/{lang}.json` | Libellés des onglets, colonnes, boutons, messages dynamiques |
-| Glossaire contextuel       | `picarones/report/glossary/{lang}.yaml` | Définitions des métriques |
-| Templates narratifs        | `picarones/core/narrative/templates/{lang}.yaml` | Phrases de la synthèse factuelle |
+| Interface du rapport HTML | `picarones/reports/html/i18n/{lang}.json` | Libellés des onglets, colonnes, boutons, messages dynamiques |
+| Glossaire contextuel       | `picarones/reports/html/glossary/{lang}.yaml` | Définitions des métriques |
+| Templates narratifs        | `picarones/domain/narrative/templates/{lang}.yaml` | Phrases de la synthèse factuelle |
 
 ## Ajouter une nouvelle clé d'interface
 
-1. Ajoutez la clé dans `picarones/report/i18n/fr.json` ET
-   `picarones/report/i18n/en.json` (le test `test_fr_and_en_have_same_keys`
+1. Ajoutez la clé dans `picarones/reports/html/i18n/fr.json` ET
+   `picarones/reports/html/i18n/en.json` (le test `test_fr_and_en_have_same_keys`
    casse sinon).
 2. Côté HTML, utilisez l'attribut `data-i18n="ma_nouvelle_cle"`. Le
    contenu littéral du HTML est le **fallback** ; il est remplacé au
@@ -29,10 +29,10 @@ const label = I18N.my_new_button || 'Texte par défaut français';
 
 ## Ajouter une nouvelle langue
 
-1. Créez `picarones/report/i18n/de.json` (copiez `fr.json` et traduisez).
-2. Créez `picarones/report/glossary/de.yaml` (copiez `fr.yaml` et
+1. Créez `picarones/reports/html/i18n/de.json` (copiez `fr.json` et traduisez).
+2. Créez `picarones/reports/html/glossary/de.yaml` (copiez `fr.yaml` et
    traduisez).
-3. Créez `picarones/core/narrative/templates/de.yaml` (copiez `fr.yaml`).
+3. Créez `picarones/domain/narrative/templates/de.yaml` (copiez `fr.yaml`).
 4. Lancez le rapport en spécifiant la langue : `picarones report
    --json results.json --output rapport.html --lang de`.
 

docs/developer/index.en.md

@@ -55,7 +55,7 @@ focus on a domain. Tests marked `network` are excluded by default
 
 - **ruff** lints: `ruff check picarones/ tests/` (config in
   `pyproject.toml`).
-- **mypy** strict on `picarones/core/`, lax elsewhere (Sprint A1).
+- **mypy** strict on `picarones/domain/`, lax elsewhere (Sprint A1).
 - **No `except Exception: pass`** — replace by
   `logger.warning("[module] degraded feature: %s", e)`.
 - **Logger per module**: `logger = logging.getLogger(__name__)`.

docs/developer/index.md

@@ -17,31 +17,26 @@ picarones/
 │   ├── corpus.py        # CorpusSpec
 │   ├── documents.py     # DocumentRef
 │   ├── pipeline_spec.py # PipelineSpec, PipelineStep (Pydantic immutable)
-│   ├── module_protocol.py # BaseModule (ABC, en cours de retrait au profit de StepExecutor)
+│   ├── module_protocol.py # BaseModule (ABC)
 │   ├── facts.py         # Fact, FactType, registre narratif
 │   └── …
 ├── formats/             # Layer 2 — parsing/serialization (ALTO 4, PAGE XML, JSON)
 ├── evaluation/          # Layer 3 — métriques et calcul
-│   ├── metrics/         # ~30 métriques (CER/WER, MUFI, philological, NER, …)
+│   ├── metrics/         # ~37 métriques (CER/WER, MUFI, philological, NER, …)
 │   ├── statistics/      # Wilcoxon, Friedman/Nemenyi, bootstrap, Pareto
-│   ├── views/, projectors/  # EvaluationView (S13+), projecteurs Alto/Page/CanonicalToText
-│   ├── corpus.py        # Document, Corpus, GTLevel (legacy en cours de retrait)
-│   ├── pipeline.py      # PipelineRunner legacy (en cours de retrait)
+│   ├── views/, projectors/  # EvaluationView, projecteurs Alto/Page/CanonicalToText
+│   ├── corpus.py        # Document, Corpus, GTLevel
 │   └── benchmark_result.py # BenchmarkResult, EngineReport, DocumentResult
 ├── pipeline/            # Layer 4 — PipelineExecutor canonique (instance-based)
 ├── adapters/            # Layer 5 — adapters externes (libs externes autorisées)
-│   ├── ocr/             # Tesseract, Pero, Mistral OCR, Google Vision, Azure DI
+│   ├── ocr/             # Tesseract, Pero, Mistral OCR, Google Vision, Azure DI, Precomputed
 │   ├── llm/             # OpenAI, Anthropic, Mistral, Ollama
 │   ├── vlm/             # Adapters VLM (zero-shot)
-│   ├── corpus/          # IIIF, Gallica, HTR-United, HuggingFace
-│   ├── storage/         # ArtifactStore, JobStore
-│   └── legacy_engines/, legacy_modules/  # legacy BaseModule-based, en retrait
-├── app/                 # Layer 6 — services applicatifs (BenchmarkService, …)
-├── reports/          # Layer 7 — rendu HTML / JSON / CSV (22 renderers + 5 vues)
+│   ├── corpus/          # IIIF, Gallica, HTR-United, HuggingFace, eScriptorium
+│   └── storage/         # ArtifactStore, JobStore
+├── app/                 # Layer 6 — services applicatifs (BenchmarkService, RunOrchestrator, JobRunner, benchmark_runner)
+├── reports/             # Layer 7 — rendu HTML / JSON / CSV (22 renderers + 5 vues)
 └── interfaces/          # Layer 8 — CLI Click, Web FastAPI
-
-# Arborescence legacy en cours de retrait (cf. docs/migration/) :
-# core/, measurements/, engines/, llm/, pipelines/, report/, modules/
 ```
 
 Règle d'import stricte : les flèches d'import vont uniquement

docs/developer/module-policy.md

@@ -20,7 +20,7 @@ Pour qu'un module soit acceptable :
 3. Il fournit un `ModuleManifest` avec **5 champs obligatoires** :
    `name`, `version`, `author`, `license`, `description`.
 4. Il passe `audit_module(MyClass, manifest)` (cf.
-   `picarones.core.module_policy`).
+   `picarones.evaluation.metrics.module_policy`).
 
 Un module qui ne passe pas l'audit n'est **pas exécutable**. Pas
 exécutable = pas dans la pipeline, pas dans le rapport.
@@ -44,7 +44,7 @@ structuré et un audit automatique au chargement.
 ## Manifest — champs obligatoires
 
 ```python
-from picarones.core.module_policy import ModuleManifest
+from picarones.evaluation.metrics.module_policy import ModuleManifest
 
 manifest = ModuleManifest(
     name="my-llm-correcteur",
@@ -102,7 +102,7 @@ class MyLlmCorrecteur(BaseModule):
 ## Audit automatique
 
 ```python
-from picarones.core.module_policy import audit_module
+from picarones.evaluation.metrics.module_policy import audit_module
 
 result = audit_module(MyLlmCorrecteur, manifest)
 if not result.passed:
@@ -123,8 +123,8 @@ L'audit vérifie :
 ## Stratégie d'ouverture en deux temps
 
 Picarones est aujourd'hui en **phase fermée** : seuls les modules
-officiels (ceux dans `picarones/engines/`, `picarones/llm/`,
-`picarones/pipelines/`) sont garantis stables. Les modules contribués
+officiels (ceux dans `picarones/adapters/ocr/`, `picarones/adapters/llm/`,
+`picarones/pipeline/`) sont garantis stables. Les modules contribués
 externes sont acceptés via PR sur le repo principal après audit.
 
 La **phase ouverte** sera déclenchée quand 5–6 modules officiels
@@ -138,7 +138,7 @@ les fournir.
 
 Quand une pipeline composée est exécutée, le rapport HTML expose un
 bloc **« Modules audités »** (cf.
-`picarones.report.module_audit_render.build_module_audit_html`) qui
+`picarones.reports.html.module_audit_render.build_module_audit_html`) qui
 liste pour chaque module :
 
 - statut d'audit (✓ vert ou ✗ rouge avec compte des checks échoués) ;

docs/explanation/architecture.md

@@ -18,7 +18,7 @@ le temps :
 | **Legacy** | Transitionnel | Reste exécutable le temps que les callers externes (HuggingFace Space, scripts BnF, notebooks de chercheurs) migrent. |
 
 Le retrait du legacy est calendrier dans le CHANGELOG ; cf. aussi
-`docs/migration/rewrite-status-s46.md`.
+`docs/archiv../archives/migration/rewrite-status-s46.md`.
 
 ## Arbo canonique — 8 cercles concentriques
 
@@ -185,6 +185,6 @@ publication scientifique.
 L'évolution de l'architecture est documentée :
 
 - Plans : [`docs/roadmap/evolution-2026.md`](../roadmap/evolution-2026.md)
-- État du rewrite : [`docs/migration/rewrite-status-s46.md`](../migration/rewrite-status-s46.md)
+- État du rewrite : [`docs/archiv../archives/migration/rewrite-status-s46.md`](../archives/migration/rewrite-status-s46.md)
 - Audits institutionnels : [`docs/audits/`](../audits/)
 - Politique d'API publique : [`docs/reference/api-stable.md`](../reference/api-stable.md)

docs/explanation/narrative-engine.en.md

@@ -69,7 +69,7 @@ input — the anti-hallucination test would catch it.
 `picarones/reports/narrative/detectors/__init__.py`:
 
 ```python
-from picarones.measurements.narrative.detectors.quality import (
+from picarones.evaluation.metrics.narrative.detectors.quality import (
     # ...
     detect_your_new_fact,
 )

docs/explanation/narrative-engine.md

@@ -6,7 +6,7 @@ la synthèse factuelle en tête du rapport.
 ## Architecture
 
 ```
-picarones/core/narrative/
+picarones/domain/narrative/
 ├── __init__.py              # API publique + pipeline build_synthesis
 ├── facts.py                 # Modèle Fact, FactType, FactImportance, DetectorRegistry
 ├── detectors.py             # 12 détecteurs (un par FactType)
@@ -41,8 +41,8 @@ Dans `detectors.py`, écrivez une fonction pure qui prend le dict
 `@register_detector` :
 
 ```python
-from picarones.core.narrative.facts import Fact, FactImportance, FactType
-from picarones.core.narrative.registry import register_detector
+from picarones.domain.narrative.facts import Fact, FactImportance, FactType
+from picarones.domain.narrative.registry import register_detector
 
 
 @register_detector(
@@ -193,9 +193,9 @@ Pour ajouter une nouvelle langue (ex. allemand) :
 
 1. Créez `templates/de.yaml` en copiant la structure de `fr.yaml` et en
    traduisant chaque entrée.
-2. Ajoutez `de.json` dans `picarones/report/i18n/` pour les libellés
+2. Ajoutez `de.json` dans `picarones/reports/html/i18n/` pour les libellés
    d'interface.
-3. Ajoutez `de.yaml` dans `picarones/report/glossary/` pour le glossaire.
+3. Ajoutez `de.yaml` dans `picarones/reports/html/glossary/` pour le glossaire.
 4. Le code détecte automatiquement la langue via `load_glossary("de")`,
    `get_labels("de")`, et `_load_templates("de")` — aucun code à modifier.
 
@@ -255,9 +255,9 @@ Depuis le Sprint 23, `select_facts` accepte un argument optionnel
 `type_order` :
 
 ```python
-from picarones.core.narrative import build_synthesis
-from picarones.core.narrative.arbiter import select_facts, DEFAULT_TYPE_ORDER
-from picarones.core.narrative.facts import FactType
+from picarones.domain.narrative import build_synthesis
+from picarones.domain.narrative.arbiter import select_facts, DEFAULT_TYPE_ORDER
+from picarones.domain.narrative.facts import FactType
 
 # Réordonnancement : on remonte vitesse et coût avant qualité.
 custom = (

docs/how-to/cli-workflows.md

@@ -1,7 +1,7 @@
 # Commandes CLI Picarones
 
 Picarones expose **15 commandes/groupes** Click dans le package
-[`picarones/cli/`](../picarones/cli/). Le découpage en sous-modules
+[`picarones/interfaces/cli/`](../picarones/interfaces/cli/). Le découpage en sous-modules
 (chantier 5) est transparent : toutes les commandes restent
 accessibles via `picarones <cmd>` après `pip install -e .`.
 
@@ -183,9 +183,9 @@ pour découvrir la sortie sans corpus réel.
 
 ## Code source
 
-- [`picarones/interfaces/cli/_legacy/__init__.py`](../picarones/interfaces/cli/_legacy/__init__.py) — groupe
+- [`picarones/interfaces/cli/__init__.py`](../picarones/interfaces/cli/__init__.py) — groupe
   Click + helpers + commandes simples.
-- [`picarones/interfaces/cli/_legacy/_workflows.py`](../picarones/interfaces/cli/_legacy/_workflows.py) —
+- [`picarones/interfaces/cli/_workflows.py`](../picarones/interfaces/cli/_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/operations/data-retention-rgpd.md

@@ -54,7 +54,7 @@ export PICARONES_REPORTS_RETENTION_DAYS=180
 
 ### Uploads anciens (Sprint A11)
 
-Le module `picarones.web.maintenance` exécute une tâche
+Le module `picarones.interfaces.web.maintenance` exécute une tâche
 asyncio en arrière-plan qui scanne `uploads/` toutes les 6 heures
 et supprime les sous-dossiers dont :
 

docs/reference/api-stable.md

@@ -1,7 +1,7 @@
 # API publique stable de Picarones
 
 > **Statut** : ce document décrivait l'API publique du Cercle 1
-> historique (`picarones.core/`).  Le projet est en cours de
+> historique (`picarones.domain/`).  Le projet est en cours de
 > retrait du legacy vers une **architecture 8 couches**
 > (`domain → formats → evaluation → pipeline → adapters → app
 > → reports_v2 → interfaces`, cf.
@@ -9,14 +9,14 @@
 >
 > **Pendant la migration** (jusqu'à la version 2.0), l'API
 > 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
+> top-level (`picarones.domain.*`, `picarones.evaluation.metrics.*`,
+> `picarones.adapters.ocr.*`, `picarones.adapters.*`,
+> `picarones.reports.html.*`, `picarones.adapters.llm.*`,
+> `picarones.interfaces.cli.*`, `picarones.evaluation.metrics.*`,
+> `picarones.evaluation.synthetic`) ont **tous été supprimés**.  Les
 > nouveaux imports doivent utiliser les chemins canoniques
 > (`picarones.domain.*`, `picarones.evaluation.*`,
-> `picarones.adapters.*`, `picarones.reports.*`,
+> `picarones.adapters.*`, `picarones.reports.htmls.*`,
 > `picarones.interfaces.*`).
 
 ## Définition
@@ -166,7 +166,7 @@ class PipelineComparisonResult:
 def compare_pipelines(specs, corpus, factories=None) -> PipelineComparisonResult
 ```
 
-### `picarones.measurements.pipeline_spec_loader`
+### `picarones.evaluation.metrics.pipeline_spec_loader`
 
 ```python
 class PipelineSpecLoadError(ValueError):
@@ -269,10 +269,10 @@ def reset_default_store(...)
 
 ### Ce que nous ne garantissons pas
 
-- **Modules `picarones.measurements/`** : peuvent évoluer librement.
-  Quand ils changent, les shims rétrocompat dans `picarones.core/`
+- **Modules `picarones.evaluation.metrics/`** : peuvent évoluer librement.
+  Quand ils changent, les shims rétrocompat dans `picarones.domain/`
   reflètent ces changements.
-- **Modules `picarones.extras/`** : statut variable selon le
+- **Modules `picarones.evaluation.metrics/`** : statut variable selon le
   sous-package (academic / governance / historical / importers).
   Voir `docs/explanation/architecture.md`.
 - **Comportement des renderers HTML** : la structure des fichiers HTML
@@ -300,31 +300,31 @@ de l'API publique stable. Ils peuvent évoluer ou être retirés en
 version mineure si une RFC le justifie.
 
 ```python
-# Mesures (déplacées vers picarones.measurements/)
-from picarones.measurements.confusion import build_confusion_matrix
-from picarones.measurements.taxonomy import classify_errors
-from picarones.measurements.calibration import compute_calibration_metrics
+# Mesures (déplacées vers picarones.evaluation.metrics/)
+from picarones.evaluation.metrics.confusion import build_confusion_matrix
+from picarones.evaluation.metrics.taxonomy import classify_errors
+from picarones.evaluation.metrics.calibration import compute_calibration_metrics
 # ... ~40 modules métriques ...
 
-# Moteur narratif (déplacé vers picarones.measurements.narrative/)
-from picarones.measurements.narrative import build_synthesis
+# Moteur narratif (déplacé vers picarones.evaluation.metrics.narrative/)
+from picarones.evaluation.metrics.narrative import build_synthesis
 from picarones.domain.facts import Fact, FactType, FactImportance
-from picarones.measurements.narrative.detectors import detect_global_leader_cer
+from picarones.evaluation.metrics.narrative.detectors import detect_global_leader_cer
 
-# Plugins (déplacés vers picarones.extras/)
-from picarones.core.taxonomy_intra_doc import compute_taxonomy_position_heatmap
-from picarones.core.unicode_blocks import compute_unicode_block_accuracy
-from picarones.core.module_policy import ModuleManifest
+# Plugins (déplacés vers picarones.evaluation.metrics/)
+from picarones.evaluation.metrics.taxonomy_intra_doc import compute_taxonomy_position_heatmap
+from picarones.evaluation.metrics.unicode_blocks import compute_unicode_block_accuracy
+from picarones.evaluation.metrics.module_policy import ModuleManifest
 from picarones.importers.iiif import IIIFImporter
 ```
 
 Pour les **nouvelles** intégrations, préférer les chemins canoniques :
 
-- `picarones.measurements.X` pour les mesures.
-- `picarones.measurements.narrative.X` pour le moteur narratif.
-- `picarones.extras.historical.X` pour les modules philologiques.
-- `picarones.extras.importers.X` pour les importers.
-- `picarones.extras.academic.X` / `picarones.extras.governance.X` pour
+- `picarones.evaluation.metrics.X` pour les mesures.
+- `picarones.evaluation.metrics.narrative.X` pour le moteur narratif.
+- `picarones.evaluation.metrics.X` pour les modules philologiques.
+- `picarones.adapters.corpus.X` pour les importers.
+- `picarones.evaluation.metrics.academic.X` / `picarones.evaluation.metrics.governance.X` pour
   les plugins niche / gouvernance.
 
 ## Voir aussi

docs/reference/normalization-profiles.md

@@ -83,7 +83,7 @@ diagramme miroir leader vs runner-up, classes par récupérabilité
 
 Identique à `standard` côté hooks. Déclenche la vue HTML « Diagnostic
 approfondi » avec **leviers d'amélioration** factuels (jamais
-prescriptifs) calculés par `picarones.core.levers.detect_levers()`.
+prescriptifs) calculés par `picarones.domain.levers.detect_levers()`.
 
 ```bash
 picarones diagnose --corpus ./corpus --engines tess,pero

docs/reference/reproducibility-snapshots.md

@@ -17,7 +17,7 @@ n'indique pas :
 - le **commit Picarones** utilisé pour produire le rapport,
 - les **paquets Python** installés au moment du run.
 
-Le module `picarones.report.snapshot` agrège ces cinq dimensions et
+Le module `picarones.reports.html.snapshot` agrège ces cinq dimensions et
 les embarque **dans le JSON du rapport**, sous la clé
 `report_data["snapshots"]`. Le rapport HTML reste auto-portant : un
 lecteur peut tout retrouver sans accès au repo source.
@@ -25,7 +25,7 @@ lecteur peut tout retrouver sans accès au repo source.
 ## Ce qu'un snapshot contient
 
 ```python
-from picarones.report.snapshot import snapshot_all
+from picarones.reports.html.snapshot import snapshot_all
 
 snap = snapshot_all(
     lang="fr",

docs/reference/views.md

@@ -69,7 +69,7 @@ Activée si :
 
 Sous-sections :
 - **Throughput effectif** : pages/h **utilisable** (intégrant 5 s/erreur
-  HTR-United), depuis `picarones.core.throughput`.
+  HTR-United), depuis `picarones.domain.throughput`.
 
 #### Vue « Taxonomie avancée » (`build_advanced_taxonomy_view_html`)
 
@@ -91,7 +91,7 @@ un bench standard) ou si données opt-in fournies.
 
 Sous-sections :
 - **Leviers d'amélioration** : factuels (jamais prescriptifs), depuis
-  `picarones.core.levers`.
+  `picarones.domain.levers`.
 - **Comparaison historique** (opt-in) : encart « ce corpus est-il habituel ? ».
 - **Profil d'image du corpus** (opt-in) : complexité paléographique +
   homogénéité.

docs/roadmap/backlog.md

@@ -118,7 +118,7 @@ exister à la livraison BnF.
 
 ### 2.4 Suppression de la dette d'imports magiques
 
-- Plus de `import picarones.measurements as _trigger_metric_registration`
+- Plus de `import picarones.evaluation.metrics as _trigger_metric_registration`
   dans `picarones/__init__.py`.
 - Registres construits explicitement par un service au démarrage.
 - Entry points Python pour les modules tiers (`picarones.metrics`,
@@ -133,20 +133,20 @@ Le Sprint S11 a migré 5 LLM (base + openai/mistral/anthropic/ollama)
 (_fallback_log).  L'ancien emplacement est un re-export.
 
 **Adapters OCR** (5 fichiers : tesseract, pero_ocr, mistral_ocr,
-google_vision, azure_doc_intel) restent dans `picarones/engines/`.
+google_vision, azure_doc_intel) restent dans `picarones/adapters/ocr/`.
 Tous importent `engines/base.py` qui hérite de `core.modules.BaseModule`.
 Migration différée jusqu'au S20 quand `core.modules` aura disparu
 (remplacé par le protocole `StepExecutor` du S6).
 
 **Importers patrimoniaux** (3 fichiers : iiif, gallica, escriptorium)
-restent dans `picarones/extras/importers/`.  Tous importent
+restent dans `picarones/evaluation/metrics/importers/`.  Tous importent
 `core.corpus.{Corpus, Document}`.  Migration différée jusqu'au
 déplacement de `core.corpus` vers `domain/` (sprint dédié).
 
 ### 2.5c Migration des fichiers `measurements/*.py` restants vers `evaluation/metrics/`
 
 Le Sprint S10 a migré 23 fichiers de calcul autonomes.  17 fichiers
-restent dans `picarones/measurements/` à migrer.
+restent dans `picarones/evaluation/metrics/` à migrer.
 
 **Catégorie B — utilisent `@register_metric`** (singleton global
 `core.metric_registry` à supprimer au S20) :

docs/roadmap/evolution-2026.md

@@ -86,7 +86,7 @@ produit ou consomme une autre représentation : ALTO, PAGE XML, entités
 nommées, ordre de lecture. C'est le verrou qui empêche tout l'axe B et qui
 limite déjà des métriques de l'axe A (Layout F1, reading order F1).
 
-**Refonte de `picarones/core/corpus.py`.** La classe `Document` actuelle
+**Refonte de `picarones/domain/corpus.py`.** La classe `Document` actuelle
 porte `image_path`, `ground_truth: str`, `ocr_text`. La nouvelle version
 porte une GT structurée :
 
@@ -135,7 +135,7 @@ texte` de manière implicite. Pour qu'un même runner puisse exécuter un
 mappeur ALTO ou un rewriter, il faut une interface plus générale dont
 `BaseOCREngine` devient un cas particulier.
 
-**Création de `picarones/core/modules.py`.**
+**Création de `picarones/domain/module_protocol.py`.**
 
 ```python
 class ArtifactType(str, Enum):
@@ -442,7 +442,7 @@ nouvelle dans le rapport.
 
 **A.II.1.a — Précision sur entités nommées (NER).**
 
-Nouveau module `picarones/measurements/ner.py`. Backends : spaCy multilingue,
+Nouveau module `picarones/evaluation/metrics/ner.py`. Backends : spaCy multilingue,
 Stanza, modèle HIPE pour les corpus historiques. Choix paramétré par
 profil (`fr_core_news_lg`, `xx_ent_wiki_sm`, `hipe2022`).
 
@@ -464,7 +464,7 @@ glossaire (entrée `ner_score`).
 
 **A.II.1.b — Score de calibration des moteurs.**
 
-Nouveau module `picarones/measurements/calibration.py`. Tous les moteurs cibles
+Nouveau module `picarones/evaluation/metrics/calibration.py`. Tous les moteurs cibles
 fournissent une confidence par token ou par ligne (Tesseract `tsv`
 output, Pero OCR via `PageLayout`, Mistral OCR via `confidence`, Google
 Vision via `Word.confidence`). Ajout d'un champ

tests/architecture/test_doc_paths.py

@@ -133,7 +133,14 @@ REPO_ROOT = Path(__file__).resolve().parents[2]
 # la migration de l'exemple de docstring dans ``robustness.py``
 # vers ``adapters.ocr.tesseract`` cassent quelques refs dans des
 # audits historiques (CHANGELOG, docs/audits/).
-BROKEN_PATHS_BASELINE = 169
+# Sprint H.9 : -7 — nettoyage massif de ~17 fichiers ``docs/`` qui
+# pointaient vers les paquets supprimés (``picarones.measurements.*``
+# / ``picarones.core.*`` / ``picarones.engines.*`` / ``picarones.cli.*``
+# / ``picarones.web.*`` / ``picarones.report.*`` / etc.) re-pointent
+# désormais vers les chemins canoniques.  ``docs/migration/`` archivée
+# vers ``docs/archives/migration/`` (les refs internes y restent
+# intentionnellement, c'est de l'historique).
+BROKEN_PATHS_BASELINE = 162
 
 #: Patrons de fichiers de documentation à scanner.
 DOC_GLOBS: tuple[str, ...] = (

tests/architecture/test_no_legacy_imports_in_rewrite.py

@@ -122,7 +122,7 @@ def test_rewrite_modules_dont_import_from_legacy() -> None:
     1. Le code legacy importé existe en équivalent dans le rewrite
        → migrer l'import.
     2. Il n'existe pas encore → la fonctionnalité doit être inscrite
-       au plan ``docs/migration/legacy-retirement-plan.md`` comme
+       au plan ``docs/archives/migration/legacy-retirement-plan.md`` comme
        bloquante avant le retrait du paquet legacy concerné.
     """
     offenders: list[tuple[str, int, str]] = []
@@ -146,7 +146,7 @@ def test_rewrite_modules_dont_import_from_legacy() -> None:
             f"{sample}{more}\n\n"
             "Soit migrer l'import vers l'équivalent rewrite, soit "
             "inscrire la fonctionnalité manquante dans "
-            "``docs/migration/legacy-retirement-plan.md`` comme "
+            "``docs/archives/migration/legacy-retirement-plan.md`` comme "
             "bloquante.",
         )