chore(versioning): S0-ter — fix broken narrative across changelog timeline

Audit narratif a identifié 6 cassures :

1. Trou narratif `1.2.x → 0.9.0` entre archive et CHANGELOG actif
→ docs/archive/changelog-pre-v2.md : ajout d'une « Note de
transition (2026-05-23) » en tête qui explique :
- Le saut apparent 1.2.x → 0.9.0 est un repositionnement
éditorial assumé, pas une régression du code.
- La cible 1.3.0 (release institutionnelle BnF) n'a jamais
été publiée — pivot vers le rewrite, repositionné en 0.9.0.
- Architecture plus mature au 0.9.0 qu'au 1.2.x ; c'est la
surface fonctionnelle utilisateur qui manque pour 1.0+.

2. Section ``[Unreleased] — towards 1.3.0`` ouverte dans l'archive
→ Renommée ``[Non-livré] — anciennement « [Unreleased] — towards
1.3.0 »`` + note explicite « Section figée par le
repositionnement (2026-05-23) ». Contenu conservé tel quel.

3. Trois sections ``[Unreleased]`` dans CHANGELOG actif précèdent
``[0.9.0]`` du même mois — logiquement absurde
→ Ajout d'une section « Lecture chronologique » qui clarifie :
les 3 [Unreleased] documentent des chantiers parallèles dans
la fenêtre du rewrite, dont l'aboutissement est consigné dans
[0.9.0]. À partir de 0.9.0, le CHANGELOG suit Keep-a-Changelog
strict : une seule section [Unreleased] à la fois.

4. ``tests/golden/fixtures/benchmark_result_v2.json``
→ Renommé en ``benchmark_result_canonical.json`` (le « v2 » du
nom était hérité du codename « v2.0 » du rewrite — ambigu).
Adaptations dans test_benchmark_result_json_stable.py et
test_no_hardcoded_version.py.

5. Convention ``code_version="1.0.0"`` dans ~50 tests non documentée
→ Section « Convention `code_version` dans les tests » ajoutée
en tête de tests/_migration_helpers.py + pointeur dans CLAUDE.md.
Explique que cette valeur est un placeholder de fixture (la
sémantique testée ne dépend pas de la valeur réelle), neutralisé
par PLACEHOLDER_PATTERNS dans le garde-fou.

6. Docstrings de tests d'archi qui parlaient encore de « v2.0 »
→ Reformulés en « clôture du rewrite » / « release 0.9.0 » :
- test_no_legacy_imports_in_rewrite.py (5 occurrences)
- test_file_budgets.py (1 commentaire)

Verification :
- 5161 tests passed, 0 failed, 20 skipped
- make lint : All checks passed
- Lecteur qui parcourt la timeline complète a maintenant un fil
narratif explicite : archive (avec note de transition) → archive
fin (« Non-livré 1.3.0 ») → CHANGELOG actif (note repositionnement
+ note lecture chronologique) → 0.9.0.

https://claude.ai/code/session_01WYDbfkhKPeBZ15BTP4e9Ye

CHANGELOG.md

@@ -53,6 +53,30 @@ jalons techniques au fil du chantier.
 
 ---
 
+## Lecture chronologique du fichier
+
+Les **trois sections `[Unreleased]`** ci-dessous (« Migration Option B »,
+« Audit code-quality », « Chantier post-rewrite ») documentent des
+chantiers parallèles réalisés **pendant la fenêtre du rewrite**
+(mai 2026), dont l'aboutissement est consigné dans la section
+``[0.9.0] — Legacy retirement complete`` plus bas.  Elles ont été
+préservées sous forme `[Unreleased]` pour refléter l'état où chaque
+branche a été rédigée — chaque branche était alors un chantier
+distinct avant que le rewrite ne les absorbe toutes.
+
+À partir de la release `0.9.0`, le CHANGELOG suit Keep-a-Changelog
+strict : **une seule section `[Unreleased]` à la fois** au-dessus de
+la version courante.
+
+Ordre de lecture chronologique :
+
+1. ``[0.9.0] — Legacy retirement complete (mai 2026)`` — aboutissement.
+2. ``[Unreleased] — Migration Option B`` — sous-chantier intégré.
+3. ``[Unreleased] — Audit code-quality`` — sous-chantier intégré.
+4. ``[Unreleased] — Chantier post-rewrite`` — sous-chantier intégré.
+
+---
+
 ## [Unreleased] — Migration Option B vers RunOrchestrator (mai 2026)
 
 Branche `claude/test-alto-pipelines-qyFsL` — chantier de migration

CLAUDE.md

@@ -132,6 +132,14 @@ NB : utiliser ``python -m pytest tests/`` plutôt que ``pytest tests/``
 directement — l'installation via ``uv tool install pytest`` masque
 les deps Picarones et produit ~160 collection errors trompeurs.
 
+**Convention `code_version` dans les tests** : la valeur ``"1.0.0"``
+utilisée dans ~50 fichiers de tests (``RunContext``,
+``ProvenanceRecord``, ``ArtifactKey``…) est un **placeholder de
+fixture**, pas la version réelle du projet.  Documentée dans
+[`tests/_migration_helpers.py`](tests/_migration_helpers.py) en tête
+de module.  Le garde-fou ``test_no_hardcoded_version`` la neutralise
+explicitement.
+
 ### Bugs documentés antérieurement — tous résolus
 
 | Bug | Statut | Sprint de résolution |

docs/archive/changelog-pre-v2.md

@@ -1,20 +1,56 @@
-# Changelog pre-v2.0 — Picarones (archive historique)
+# Changelog pré-rewrite — Picarones (archive historique)
 
 > **Archived document.** Historical reference only.
 > For current changelog see [`/CHANGELOG.md`](../../CHANGELOG.md).
 
-Ce fichier conserve l'historique des versions **antérieures à v2.0**
-(janvier 2025 → mai 2026, pré-rewrite et migration legacy).  Pour
-l'ère v2.0 et au-delà, voir [`/CHANGELOG.md`](../../CHANGELOG.md) à
-la racine.
+Ce fichier conserve l'historique des versions **antérieures au
+rewrite architectural** (janvier 2025 → mai 2026, pré-rewrite et
+migration legacy).  Pour la période suivante (depuis `0.9.0`), voir
+[`/CHANGELOG.md`](../../CHANGELOG.md) à la racine.
 
 Le format suit [Keep a Changelog](https://keepachangelog.com/fr/1.0.0/).
 La numérotation de version suit [Semantic Versioning](https://semver.org/lang/fr/).
 
 ---
 
+## Note de transition (2026-05-23) — pourquoi le saut `1.2.x → 0.9.0`
+
+La timeline de ce fichier culmine en **`1.2.x` (avril 2026)** et
+en une section ``[Unreleased] — towards 1.3.0`` qui décrit les
+chantiers de mai 2026 — chantiers qui devaient devenir la release
+institutionnelle BnF `1.3.0`.
+
+Cette release **n'est jamais sortie**.  À la place, Picarones a
+entrepris un rewrite architectural complet en 8 couches, désigné
+en interne sous le nom « v2.0 » (mai 2026).  À la clôture de ce
+rewrite, la maturité fonctionnelle réelle du projet (pas d'UI
+finalisée, parité importeurs incomplète, rapport HTML pas refondu)
+ne justifiait pas une release publique « 2.0 ».
+
+**Le projet a donc été repositionné en `0.9.0` (pré-1.0 honnête)**,
+événement consigné dans la « Note de repositionnement » en tête du
+[CHANGELOG actif](../../CHANGELOG.md).  Les chantiers de
+``[Unreleased] — towards 1.3.0`` ci-dessous ont été soit intégrés
+au rewrite, soit reportés dans la roadmap vers `1.0.0` (cf.
+[`docs/explanation/versioning.md`](../explanation/versioning.md)).
+
+Le saut apparent `1.2.x → 0.9.0` reflète donc un **repositionnement
+éditorial assumé**, pas une régression du code : l'architecture
+est plus mature au `0.9.0` qu'elle ne l'était au `1.2.x` ; c'est la
+surface fonctionnelle utilisateur qui n'a pas atteint le niveau
+qu'on attend d'une release stable `1.0+`.
 
-## [Unreleased] — towards 1.3.0 (release institutionnelle BnF) — 2026-05
+---
+
+## [Non-livré] — anciennement « `[Unreleased]` — towards 1.3.0 » — 2026-05
+
+> **Section figée par le repositionnement (2026-05-23).**  Les
+> chantiers listés ci-dessous étaient en cours en mai 2026 quand le
+> projet a pivoté vers le rewrite + repositionnement en `0.9.0`.
+> La cible `1.3.0` n'a jamais été publiée ; le contenu a été soit
+> intégré au rewrite (cf. [CHANGELOG actif](../../CHANGELOG.md)
+> entrée `[0.9.0]`), soit reporté dans la roadmap vers `1.0.0`.
+> Conservé ici tel quel pour la traçabilité.
 
 > Section unique conforme à Keep-a-Changelog.  Les chantiers actifs
 > sont regroupés ci-dessous par thème ; chaque thème reflète un audit

tests/_migration_helpers.py

@@ -17,6 +17,33 @@ Ce helper ``run_via_orchestrator`` est un **outil de test**
 constitue pas de la dette technique en production : il n'y a pas
 de shim équivalent dans ``picarones/`` (les call sites CLI/Web
 font le pattern 3 étapes explicitement).
+
+Convention « ``code_version`` dans les tests »
+==============================================
+
+De nombreux tests (~50+ fichiers) instancient des ``RunContext``,
+``ProvenanceRecord``, ``ArtifactKey``, ``RunSpec`` avec
+``code_version="1.0.0"`` en littéral.  **Cette valeur est un
+placeholder de fixture**, pas une assertion sur la version réelle
+de Picarones au moment du test.
+
+Picarones suit SemVer pré-1.0 et sa version courante est résolue
+dynamiquement via ``picarones.__version__`` (voir
+``docs/explanation/versioning.md``).  Les tests utilisent ``"1.0.0"``
+comme valeur arbitraire stable parce que :
+
+- la sémantique testée ne dépend pas de la valeur réelle (cache,
+  manifeste, provenance — ce qui compte est l'**égalité** ou la
+  **non-égalité** entre deux ``code_version``, pas la valeur) ;
+- une string ``"X.Y.Z"`` cohérente PEP 440 facilite les assertions
+  sur la structure ;
+- la stabilité historique évite de devoir réécrire 50+ tests à
+  chaque bump de version.
+
+Le garde-fou ``tests/architecture/test_no_hardcoded_version.py``
+neutralise spécifiquement les patterns ``code_version="X.Y.Z"`` via
+``PLACEHOLDER_PATTERNS`` pour ne pas les confondre avec de vraies
+mentions de version Picarones.
 """
 
 from __future__ import annotations

tests/architecture/test_file_budgets.py

@@ -43,7 +43,7 @@ FILE_BUDGETS: dict[str, int] = {
     # --- God-modules : budget actuel + 15 % de marge.
     # Le rétrécissement sera l'objet d'un sprint de refactor dédié.
     # Phase 4.6 audit code-quality (2026-05) — commentaires retirés :
-    # ils décrivaient des modules supprimés en v2.0 (``measurements/``,
+    # ils décrivaient des modules supprimés à la clôture du rewrite (``measurements/``,
     # ``core/``, ``report/``, ``pipelines/legacy_*``) qui ne sont plus
     # référencés ailleurs.  L'historique reste accessible via git log
     # + CHANGELOG.

tests/architecture/test_no_hardcoded_version.py

@@ -132,7 +132,7 @@ PLACEHOLDER_PATTERNS: tuple[re.Pattern[str], ...] = (
     re.compile(r"""["']version["']\s*:\s*["'][\w.\-+]+["']"""),
 )
 
-#: Placeholder utilisé dans les fixtures golden ``benchmark_result_v2.json``.
+#: Placeholder utilisé dans les fixtures golden ``benchmark_result_canonical.json``.
 #: Substitué au load-time du test ; doit être ignoré ici.
 GOLDEN_PLACEHOLDER = "<CURRENT_VERSION>"
 

tests/architecture/test_no_legacy_imports_in_rewrite.py

@@ -3,8 +3,9 @@
 
 L'arborescence canonique 8 couches (``domain → formats → evaluation
 → pipeline → adapters → app → reports → interfaces``) est autonome
-depuis la v2.0 (mai 2026).  Tous les paquets legacy historiquement
-listés ont été supprimés au cours des sprints A-H.
+depuis la clôture du rewrite (release `0.9.0`, mai 2026).  Tous les
+paquets legacy historiquement listés ont été supprimés au cours
+des sprints A-H.
 
 Phase 4.5 de l'audit code-quality (2026-05) : avant cette refonte,
 ``LEGACY_PACKAGES = ()`` rendait ``test_rewrite_modules_dont_import_from_legacy``
@@ -36,7 +37,7 @@ from pathlib import Path
 
 REPO_ROOT = Path(__file__).resolve().parents[2]
 
-#: Paquets de l'arborescence canonique v2.0.
+#: Paquets de l'arborescence canonique (post-rewrite, release 0.9.0+).
 REWRITE_PACKAGES: tuple[str, ...] = (
     "domain",
     "formats",
@@ -56,7 +57,7 @@ REWRITE_PACKAGES: tuple[str, ...] = (
 #:   cas, le retirer de cette liste avec un commentaire expliquant
 #:   pourquoi le sens a changé.
 #:
-#: Source : CHANGELOG v2.0 et ``docs/archives/migration/``.
+#: Source : CHANGELOG entrée 0.9.0 et ``docs/archive/2026-migration/``.
 RESURRECTED_LEGACY_NAMES: tuple[str, ...] = (
     "core",
     "measurements",
@@ -163,7 +164,7 @@ def test_no_resurrected_legacy_package_directory() -> None:
     assert not resurrected, (
         "Paquet(s) legacy ressuscité(s) :\n"
         + "\n".join(f"  - {p}" for p in resurrected)
-        + "\n\nLe retrait v2.0 (sprints A-H) avait acté la suppression "
+        + "\n\nLe retrait du legacy (sprints A-H, clôture du rewrite) avait acté la suppression "
         "définitive.  Si la réintroduction est intentionnelle, retirer "
         "le nom de ``RESURRECTED_LEGACY_NAMES`` / "
         "``RESURRECTED_LEGACY_SUBPACKAGES`` avec un commentaire dans "
@@ -203,7 +204,7 @@ def test_no_imports_of_resurrected_legacy_module() -> None:
             f"\n{len(offenders)} import(s) ciblant un nom legacy "
             f"ressuscité :\n\n{sample}{more}\n\n"
             "Le code source rewrite ne doit pas importer depuis les "
-            "paquets supprimés en v2.0.  Migrer l'import vers la "
+            "paquets supprimés à la clôture du rewrite.  Migrer l'import vers la "
             "couche canonique correspondante."
         )
 

tests/golden/test_benchmark_result_json_stable.py

@@ -6,7 +6,7 @@ Garantit que la sérialisation JSON de ``BenchmarkResult.as_dict``/
 - **Stable** : deux sérialisations successives produisent les mêmes
   bytes (modulo la clé ``run_date`` qui est forcée déterministe).
 - **Conforme au snapshot** : le JSON correspond à un golden file
-  versionné dans ``tests/golden/fixtures/benchmark_result_v2.json``.
+  versionné dans ``tests/golden/fixtures/benchmark_result_canonical.json``.
 
 Si le snapshot n'existe pas au premier run, il est créé et le test
 échoue avec un message demandant de commit le fichier.
@@ -21,7 +21,7 @@ import pytest
 
 
 GOLDEN_PATH = (
-    Path(__file__).parent / "fixtures" / "benchmark_result_v2.json"
+    Path(__file__).parent / "fixtures" / "benchmark_result_canonical.json"
 )
 
 
@@ -139,7 +139,7 @@ def _build_deterministic_benchmark_result():
         # chaîne littérale.  Découple le snapshot du bump de version
         # courante (un release `0.10.0` ne touche pas au fichier
         # golden).  Convention partagée avec
-        # ``tests/golden/fixtures/benchmark_result_v2.json``.
+        # ``tests/golden/fixtures/benchmark_result_canonical.json``.
         picarones_version="<CURRENT_VERSION>",
         metadata={"sprint": "S5", "deterministic": True},
     )