docs(archive): consolidate audits, migration, pre-v2 roadmap under docs/archive/

Trois zones d'archive coexistaient (``docs/archives/migration/``,
``docs/migration/``, ``docs/audits/``) + deux fichiers roadmap
pré-v2.0 (``evolution-2026.md``, ``rewrite-2026.md``) dans la nav
active. Aucun bandeau d'archive, aucune exclusion CI, et le ratchet
``test_doc_paths`` comptait les chemins legacy qu'ils citaient
comme dette active — empêchant mécaniquement la décroissance.

Consolidation sous une seule arborescence ``docs/archive/`` :

docs/archive/
├── README.md (index + politique)
├── changelog-pre-v2.md (déjà déplacé en D3)
├── 2026-audits/ (← docs/audits/)
│ ├── institutional-readiness.md
│ └── remediation-plan.md
├── 2026-migration/ (fusion 3 sources)
│ ├── README.md (← docs/archives/migration/)
│ ├── executor-equivalence.md
│ ├── legacy-retirement-plan.md
│ ├── option-b-test-inventory.md (← docs/migration/)
│ ├── option-b-user-guide.md
│ ├── pipeline-convergence-plan.md
│ ├── regression-tolerances.md
│ ├── rewrite-status-s46.md
│ ├── session-handover.md (SESSION_HANDOVER.md)
│ └── sprint-D-audit.md
└── 2026-roadmap/ (← docs/roadmap/{evolution,rewrite}-2026.md)
├── evolution.md
└── rewrite.md

``docs/roadmap/`` conserve uniquement ``backlog.md`` (vivant).

Le nouveau ``docs/archive/README.md`` documente la politique :
fichiers figés, modifications minimales tolérées, exclusion explicite
du ratchet (le test ``test_doc_paths.py`` ignore désormais
``docs/archive/`` et ``docs/archives/`` via EXCLUDED_PATH_PREFIXES).

Références mises à jour dans les fichiers actifs :
- mkdocs.yml : nav ne contient plus Audits/Migration top-level ;
seule entrée archive = lien vers ``docs/archive/README.md``.
- docs/index.md : section "Archives et historique" pointe vers
archive/ unique ; lien rewrite-status-s46 corrigé.
- README.md (4 refs), SPECS.md (3 refs), GOVERNANCE.md,
ACCESSIBILITY.md, CHANGELOG.md (actif), CONTRIBUTING.en.md,
docs/{developer,explanation,operations,reference,roadmap}/ : tous
les liens repointés vers docs/archive/2026-*.
- tests/docs/test_readme_dual_lang.py : test_readme_links_to_audits
renommé test_readme_links_to_archive et adapté.

Effet sur le ratchet : 41 → 6 chemins cassés (-35). Les 6 restants
sont dans la doc active (CHANGELOG section migration 2.0, SPECS,
architecture.md) et ne peuvent être corrigés sans réécrire
l'historique v2.0 — à traiter en Phase 2 ou v2.1.

ACCESSIBILITY.md

@@ -1,7 +1,7 @@
 # Déclaration d'accessibilité — Picarones
 
 > Sprint A7 du plan de remédiation institutionnelle
-> ([`docs/audits/remediation-plan-2026-05.md`](docs/audits/remediation-plan-2026-05.md)).
+> ([`docs/archive/2026-audits/remediation-plan.md`](docs/archive/2026-audits/remediation-plan.md)).
 >
 > **Statut au 2 mai 2026** : audit interne Sprints A6 + A7 validé,
 > audit externe RGAA / WCAG **en cours** (planifié au Sprint A15).

CHANGELOG.md

@@ -140,7 +140,7 @@ est enfin accessible aux utilisateurs.
 
 ### Migration utilisateur
 
-Cf. `docs/migration/option_b_user_guide.md` pour le mapping complet
+Cf. `docs/archive/2026-migration/option-b-user-guide.md` pour le mapping complet
 des paramètres legacy → `RunSpec`, 4 cas concrets (corpus mémoire,
 partial_dir resume, NER attach, cancellation), et calendrier de
 retrait phasé.

GOVERNANCE.md

@@ -1,7 +1,7 @@
 # Gouvernance — Picarones
 
 > Sprint A10 du plan de remédiation institutionnelle
-> ([`docs/audits/remediation-plan-2026-05.md`](docs/audits/remediation-plan-2026-05.md)).
+> ([`docs/archive/2026-audits/remediation-plan.md`](docs/archive/2026-audits/remediation-plan.md)).
 >
 > Ce document explicite **comment Picarones est maintenu et fait
 > évoluer** : qui décide, à quelle cadence, avec quels engagements de

README.md

@@ -17,7 +17,7 @@ pinned: false
 consolidation.  The core (corpus, runner, metrics, HTML report) is
 usable to compare transcription pipelines on a ground-truth corpus.
 A targeted rewrite (see
-[`docs/roadmap/rewrite-2026.md`](docs/roadmap/rewrite-2026.md))
+[`docs/archive/2026-roadmap/rewrite.md`](docs/archive/2026-roadmap/rewrite.md))
 rebuilds the orchestration layer and evaluation views for a stable
 2.0 release by the end of 2026.
 
@@ -341,7 +341,7 @@ sub-packages (`adapters/legacy_engines/`, `adapters/legacy_pipelines/`,
 `interfaces/{cli,web}/_legacy/`). See
 [`docs/explanation/architecture.md`](docs/explanation/architecture.md)
 for the full manifesto and migration history under
-`docs/archives/migration/`.
+`docs/archive/2026-migration/`.
 
 ---
 
@@ -436,12 +436,12 @@ Detailed history and current direction live in:
 
 - [`CHANGELOG.md`](CHANGELOG.md) — Keep a Changelog format,
   one entry per sprint up to the latest release.
-- [`docs/roadmap/evolution-2026.md`](docs/roadmap/evolution-2026.md) —
-  technical evolution roadmap (axes A and B for 2026+).
-- [`docs/roadmap/rewrite-2026.md`](docs/roadmap/rewrite-2026.md) —
-  targeted rewrite plan (S1–S26) restructuring orchestration around
-  `Pipeline → Artifacts → Projection → EvaluationView`. Target: end of 2026.
-- [`docs/audits/`](docs/audits/) — internal audit notes ; [`BACKLOG_POST_LIVRAISON.md`](BACKLOG_POST_LIVRAISON.md) — promises **not** in scope.
+- [`docs/roadmap/backlog.md`](docs/roadmap/backlog.md) — live backlog
+  for current work.
+- [`docs/archive/`](docs/archive/) — historical artefacts:
+  pre-v2.0 roadmap (`2026-roadmap/`), institutional audits
+  (`2026-audits/`), rewrite/migration plans (`2026-migration/`),
+  pre-v2.0 changelog (`changelog-pre-v2.md`).
 
 **Honest status (May 2026).** Several items historically presented as
 "institutional readiness complete" are not at the level the README

SPECS.md

@@ -142,7 +142,7 @@ l'AST de chaque fichier et bloque toute violation au merge.
 > (``picarones/{core,measurements,engines,llm,pipelines,
 > report,modules}``) cohabite encore et est en train de
 > disparaître phase par phase.  Cf.
-> [`docs/migration/legacy-retirement-plan.md`](docs/migration/legacy-retirement-plan.md)
+> [`docs/archive/2026-migration/legacy-retirement-plan.md`](docs/archive/2026-migration/legacy-retirement-plan.md)
 > pour le statut et le calendrier.  Tout nouveau code va
 > dans l'arborescence canonique ; les chemins legacy
 > existants sont des shims minimaux destinés à être
@@ -820,11 +820,11 @@ Trois documents complémentaires pilotent l'évolution :
 
 - [`CHANGELOG.md`](CHANGELOG.md) — historique sprint par sprint,
   format Keep a Changelog.
-- [`docs/roadmap/evolution-2026.md`](docs/roadmap/evolution-2026.md) —
-  roadmap technique 2026+ (axes A et B : nouvelles métriques et
-  pipelines composables).
-- [`docs/audits/`](docs/audits/) — audits institutionnels et
-  plans de remédiation (sprints A1 à A15 du plan en cours).
+- [`docs/roadmap/backlog.md`](docs/roadmap/backlog.md) — backlog
+  vivant des chantiers post-v2.0.
+- [`docs/archive/`](docs/archive/) — audits institutionnels,
+  plans de remédiation pré-v2.0, roadmap historique
+  (`2026-roadmap/evolution.md`), changelog pré-v2.0.
 
 L'**état du plan institutionnel** au 2 mai 2026 :
 

docs/archive/README.md

@@ -0,0 +1,91 @@
+# Archive documentaire — Picarones
+
+> **Archived document.** Cette zone contient des documents
+> **historiques** : audits, plans de migration, roadmaps obsolètes,
+> changelogs antérieurs à v2.0.  Ils sont conservés pour la
+> traçabilité et la mémoire institutionnelle du projet, mais ne font
+> **pas** partie de la documentation active.
+>
+> Pour la documentation à jour, voir [`docs/index.md`](../index.md).
+
+---
+
+## Pourquoi cette séparation
+
+À v2.0 (mai 2026), le projet a clôturé son rewrite et la migration
+legacy.  Les artefacts qui décrivaient ces chantiers (handovers de
+session, plans de retrait, audits institutionnels, status reports)
+restent utiles pour comprendre **comment** le code a évolué, mais
+ils ne décrivent pas l'état actuel.
+
+Les laisser dans la documentation active créait deux confusions :
+
+1. **Pour les nouveaux contributeurs** : impression que le projet
+   était encore en chantier, alors que la posture v2.0 est
+   « release ».
+2. **Pour les outils CI** (ratchet `test_doc_paths`, validation
+   `mkdocs strict`) : ces fichiers contiennent des références à du
+   code supprimé qui empêchaient mécaniquement le compteur de dette
+   de décroître.
+
+L'archive résout les deux : zone explicite, exclue de la nav active
+et du ratchet, bannière en tête de chaque sous-dossier.
+
+---
+
+## Contenu
+
+### [`2026-audits/`](2026-audits/)
+
+Audits institutionnels et plans de remédiation produits en mai 2026,
+préalables au tag v2.0.
+
+- `institutional-readiness-2026-05.md` — audit BnF / LoC / BL
+- `remediation-plan-2026-05.md` — plan d'action issu de l'audit
+
+### [`2026-migration/`](2026-migration/)
+
+Plans, handovers et inventaires liés au rewrite et à la suppression
+du legacy (lots A-H, mai 2026).
+
+- `legacy-retirement-plan.md` — plan de retrait des paquets legacy
+- `pipeline-convergence-plan.md` — convergence des deux pipelines
+- `rewrite-status-s46.md` — état d'avancement Sprint 46
+- `executor-equivalence.md` — preuve d'équivalence des exécutants
+- `option-b-user-guide.md` — guide de migration vers Option B
+- `option-b-test-inventory.md` — inventaire des tests touchés
+- `session-handover.md` — handover entre sessions de travail
+- `sprint-D-audit.md` — audit du sprint D
+- `regression-tolerances.md` — tolérances de régression mesurées
+
+### [`2026-roadmap/`](2026-roadmap/)
+
+Plans stratégiques pré-v2.0 (le backlog vivant est dans
+[`/docs/roadmap/backlog.md`](../roadmap/backlog.md)).
+
+- `evolution.md` — plan d'évolution 2026 (axes A et B)
+- `rewrite.md` — plan du rewrite 2026 (S1–S26)
+
+### [`changelog-pre-v2.md`](changelog-pre-v2.md)
+
+Historique de versions 0.1.0 → 1.x + chantiers pré-v2.0.  Le
+CHANGELOG actif (post-v2.0) vit à la racine du repo dans
+[`/CHANGELOG.md`](../../CHANGELOG.md).
+
+---
+
+## Politique de modification
+
+Les fichiers archivés sont **figés**.  Toute correction substantielle
+doit aller dans la documentation active, pas dans l'archive.  Les
+seules modifications acceptables ici sont :
+
+- ajouter le bandeau « Archived document » s'il manque ;
+- corriger des typos évidentes ;
+- ajouter des notes en tête pour préciser le contexte historique.
+
+Les chemins Python obsolètes (`picarones.measurements`, `picarones.core`,
+etc.) restent **volontairement** dans les fichiers archivés —
+c'est précisément pour cela qu'ils sont archivés.  Le test
+`tests/architecture/test_doc_paths.py` exclut `docs/archive/**` de
+son périmètre.

docs/developer/doc-consistency.md

@@ -1,7 +1,7 @@
 # Cohérence documentation — contrat d'écriture
 
 > Sprint A2 du plan de remédiation institutionnelle
-> ([`docs/audits/remediation-plan-2026-05.md`](../audits/remediation-plan-2026-05.md)).
+> ([`docs/archive/2026-audits/remediation-plan.md`](../archive/2026-audits/remediation-plan.md)).
 
 Picarones expose plusieurs documents de premier contact (README.md,
 SPECS.md, CHANGELOG.md, CITATION.cff, …). Pour qu'un primo-lecteur

docs/explanation/architecture.md

@@ -11,7 +11,7 @@
 les paquets pré-rewrite ainsi que leurs sous-paquets transitoires
 ont été supprimés au cours des sprints A-H.  Pour le détail
 historique, voir le [CHANGELOG section 2.0.0](../../CHANGELOG.md)
-et [`docs/archives/migration/`](../archives/migration/).
+et [`docs/archive/2026-migration/`](../archive/2026-migration/).
 
 Toute documentation, tout commentaire qui mentionne « deux
 arborescences » ou « legacy en cours de retrait » est obsolète.
@@ -248,8 +248,10 @@ publication scientifique.
 
 L'évolution de l'architecture est documentée :
 
-- Plans : [`docs/roadmap/evolution-2026.md`](../roadmap/evolution-2026.md)
+- Backlog vivant : [`docs/roadmap/backlog.md`](../roadmap/backlog.md)
 - Plans archivés (migration legacy → rewrite, terminée à v2.0) :
-  [`docs/archives/migration/`](../archives/migration/)
-- Audits institutionnels : [`docs/audits/`](../audits/)
+  [`docs/archive/2026-migration/`](../archive/2026-migration/)
+- Roadmap historique pré-v2.0 :
+  [`docs/archive/2026-roadmap/`](../archive/2026-roadmap/)
+- Audits institutionnels : [`docs/archive/2026-audits/`](../archive/2026-audits/)
 - Politique d'API publique : [`docs/reference/api-stable.md`](../reference/api-stable.md)

docs/index.md

@@ -62,8 +62,8 @@ Vous évaluez Picarones avant un déploiement, un audit, une revue.
    ([EN](../SECURITY.en.md))
 3. Threat model STRIDE : [`security/threat-model.md`](security/threat-model.md)
 4. API publique stable et politique de versioning : [`reference/api-stable.md`](reference/api-stable.md)
-5. Audits historiques : [`audits/`](audits/)
-6. État du rewrite et migration : [`archives/migration/rewrite-status-s46.md`](archives/migration/rewrite-status-s46.md)
+5. Audits historiques : [`archive/2026-audits/`](archive/2026-audits/)
+6. État du rewrite et migration : [`archive/2026-migration/rewrite-status-s46.md`](archive/2026-migration/rewrite-status-s46.md)
 7. Reproductibilité bit-for-bit : [`reference/reproducibility-snapshots.md`](reference/reproducibility-snapshots.md)
 
 ### …un Délégué à la Protection des Données (DPO)
@@ -137,10 +137,9 @@ Vous évaluez les implications RGPD avant signature.
 
 | Document | Sujet |
 |----------|-------|
-| [`/CHANGELOG.md`](../CHANGELOG.md) | Journal des versions (Keep-a-Changelog) |
-| [`audits/`](audits/) | Audits historiques figés |
-| [`migration/`](migration/) | Notes de migration entre versions majeures |
-| [`roadmap/`](roadmap/) | Plans stratégiques |
+| [`/CHANGELOG.md`](../CHANGELOG.md) | Journal des versions actives (post-v2.0) |
+| [`archive/`](archive/) | Documents archivés (audits, migration, roadmap pré-v2.0, changelog historique) |
+| [`roadmap/backlog.md`](roadmap/backlog.md) | Backlog vivant |
 
 ---
 

docs/operations/release-process.md

@@ -1,7 +1,7 @@
 # Procédure de release
 
 > Sprint A9 du plan de remédiation institutionnelle
-> ([`docs/audits/remediation-plan-2026-05.md`](../audits/remediation-plan-2026-05.md)).
+> ([`docs/archive/2026-audits/remediation-plan.md`](../archive/2026-audits/remediation-plan.md)).
 > Étendu au Sprint S6 (déploiement institutionnel BnF).
 
 ## Pré-requis avant tout tag (Sprint S6)

docs/reference/api-stable.md

@@ -163,7 +163,7 @@ canonique pour lancer un benchmark.  Deux modes :
 
 Le module legacy ``benchmark_runner.py`` (entry point
 ``run_benchmark_via_service``) a été supprimé.  Voir
-``docs/migration/option_b_user_guide.md`` pour le mapping.
+``docs/archive/2026-migration/option-b-user-guide.md`` pour le mapping.
 
 ### `picarones.evaluation.metric_registry`
 

docs/roadmap/backlog.md

@@ -1,6 +1,6 @@
 # Backlog post-livraison
 
-> **Garde-fou de discipline du rewrite ciblé** (cf. `docs/roadmap/rewrite-2026.md`).
+> **Garde-fou de discipline du rewrite ciblé** (cf. `docs/archive/2026-roadmap/rewrite.md`).
 >
 > Tout ce qui apparaît ici est **explicitement hors scope** des sprints
 > S1–S26. Ces items pourront revenir dans le scope après la livraison à
@@ -221,7 +221,7 @@ courante). Pas un sprint dédié.
   doit attendre.
 - **Ne pas retirer** un item juste parce qu'on a envie de le faire ;
   attendre que le rewrite l'absorbe officiellement (auquel cas il
-  apparaîtra dans `docs/roadmap/rewrite-2026.md`).
+  apparaîtra dans `docs/archive/2026-roadmap/rewrite.md`).
 - **Référencer** ce fichier dans les PRs qui retirent du scope du
   README ou de la documentation utilisateur.
 

mkdocs.yml

@@ -96,15 +96,9 @@ nav:
       - developer/extending-i18n.md
       - developer/doc-consistency.md
   - Roadmap:
-      - roadmap/evolution-2026.md
-      - roadmap/rewrite-2026.md
       - roadmap/backlog.md
-  - Audits:
-      - audits/institutional-readiness-2026-05.md
-      - audits/remediation-plan-2026-05.md
-  - Migration:
-      - migration/rewrite-status-s46.md
-      - migration/executor-equivalence.md
+  - Archive:
+      - archive/README.md
   - Case studies:
       - case-studies/README.md
       - case-studies/01-registres-paroissiaux.md

tests/architecture/test_doc_paths.py

@@ -150,11 +150,20 @@ REPO_ROOT = Path(__file__).resolve().parents[2]
 # l'historique du module et n'est pas corrigée volontairement.
 #: Phase 1 D3 (juin 2026) : 164 → 41.  L'archivage du CHANGELOG
 #: pré-v2.0 vers ``docs/archive/changelog-pre-v2.md`` retire 123
-#: chemins cassés historiques du périmètre actif.  Les 41 restants
-#: sont presque tous dans ``docs/audits/*.md`` (à archiver en D4) et
-#: ``CHANGELOG.md`` actif (refs Sprint H.4/H.6, intouchables sans
-#: réécrire l'historique 2.0).
-BROKEN_PATHS_BASELINE = 41
+#: chemins cassés historiques du périmètre actif.
+#: Phase 1 D4 (juin 2026) : 41 → 6.  Les dossiers ``docs/audits/``,
+#: ``docs/migration/``, ``docs/archives/migration/``, et la roadmap
+#: pré-v2.0 ont été consolidés sous ``docs/archive/``.  Les 35
+#: chemins cassés qu'ils portaient sortent du périmètre actif (cf.
+#: ``EXCLUDED_PATH_PREFIXES`` ci-dessous).
+#:
+#: Les 6 chemins restants sont dans la doc active :
+#: - CHANGELOG.md (4) : refs Sprint H.4/H.6 dans la section
+#:   migration v2.0 (intouchables sans réécrire l'historique 2.0) ;
+#: - SPECS.md (1) : exemple YAML legacy à corriger en Phase 2 ou v2.1 ;
+#: - docs/explanation/architecture.md (1) : ref historique au shim
+#:   ``picarones/pipeline/spec.py`` supprimé en Sprint S7.
+BROKEN_PATHS_BASELINE = 6
 
 #: Patrons de fichiers de documentation à scanner.
 DOC_GLOBS: tuple[str, ...] = (

tests/docs/test_readme_dual_lang.py

@@ -186,14 +186,18 @@ def test_readme_under_500_lines() -> None:
     )
 
 
-def test_readme_links_to_audits() -> None:
-    """Le README doit pointer vers ``docs/audits/`` pour la traçabilité
-    des plans de remédiation (M-21 : suppression de Known Issues
-    obsolète + redirection vers audits)."""
+def test_readme_links_to_archive() -> None:
+    """Le README doit pointer vers ``docs/archive/`` pour la
+    traçabilité des plans de remédiation et des audits historiques.
+
+    Depuis Phase 1 D4, l'ancien chemin ``docs/audits/`` a été
+    consolidé vers ``docs/archive/2026-audits/``.  La règle de
+    traçabilité subsiste : le README doit toujours pointer vers les
+    artefacts archivés."""
     text = _read_readme()
-    assert "docs/audits" in text, (
-        "README doit linker vers docs/audits/ pour les rapports "
-        "d'audit institutionnels."
+    assert "docs/archive" in text, (
+        "README doit linker vers docs/archive/ pour les rapports "
+        "d'audit historiques et les plans de migration."
     )