chore(versioning): reposition project as 0.9.0 (pre-1.0)

Sprint S0 — align version numbering with actual functional maturity.

What changed:
- pyproject.toml: fallback_version 1.0.0 → 0.9.0
- New single source of truth: picarones/domain/_version_fallback.py
(placed in domain layer to be importable from all outer layers
without violating dependency rules)
- Refactor 4 hardcoded fallbacks (init/evaluation/reports/pyproject)
to read from the single source — fixes pre-existing inconsistency
where __init__.py said "2.0.0" while others said "1.0.0"
- CHANGELOG: rename [2.0.0] entry to [0.9.0] with historical note;
add repositioning note + roadmap to 1.0 in header
- CLAUDE.md, README.md, architecture.md, api-stable.md, specification.md,
release-process.md, rollback.md, index.md, threat-model.md,
reproducibility-snapshots.md, backlog.md: align active references
- docs/archive/README.md: add preliminary note explaining the
"v2.0" → "0.9.0" mapping; archive content left intact (history)
- New docs/explanation/versioning.md: full SemVer pre-1.0 policy
- New tests/golden/fixtures/benchmark_result_v2.json: use
"<CURRENT_VERSION>" placeholder; test substitutes the same string
→ snapshot decoupled from version bumps
- Refactored test_doc_truthfulness.py to verify invariants
(no legacy packages, 8 layers documented) rather than mentions of
a specific version

Anti-drift guard-rails (3 new tests):
- test_single_version_source.py: verifies pyproject ↔ FALLBACK_VERSION
alignment, PEP 440 format, no other module defines a literal version
- test_no_hardcoded_version.py: scans active code/docs for hardcoded
Picarones versions outside whitelist (contextual patterns:
"Picarones X.Y.Z", "picarones==X.Y.Z", "Release X.Y.Z", "vX.Y.Z"
isolated — avoids WCAG/Pydantic/Python false positives)
- test_version_propagation.py: end-to-end check that __version__
appears in HTML report, JSON, CLI info, /api/status

Verification:
- 5156 tests passed, 0 failed, 20 skipped
- make lint: All checks passed
- picarones --version, picarones info, demo HTML all show the
current resolved version (0.10.0.dev277 without git tag, would
become 0.9.0 once v0.9.0 tag is posted)

No git tag posted in this sprint — D6.b: tag is the operator's
explicit gesture to trigger PyPI/Docker/GitHub Release.

https://claude.ai/code/session_01WYDbfkhKPeBZ15BTP4e9Ye

CHANGELOG.md

@@ -5,6 +5,52 @@ Tous les changements notables de ce projet sont documentés dans ce fichier.
 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/).
 
+Politique de versionning : voir
+[`docs/explanation/versioning.md`](docs/explanation/versioning.md).
+
+---
+
+## Note de repositionnement (2026-05-23)
+
+Le projet a été repositionné en **SemVer pré-1.0** à cette date.  La
+release précédemment dénommée **« 2.0.0 »** (clôture du rewrite
+architectural en 8 couches, mai 2026) est désormais référencée comme
+**`0.9.0`** dans ce changelog.
+
+Justification : à la clôture du rewrite, le projet n'avait ni
+interface utilisateur finalisée, ni parité importeurs, ni rapport
+refondu — la dénomination « 2.0 » reflétait un cycle de refactor
+interne, pas une release publique mûre.  La sortie de `1.0.0`
+deviendra un événement public marquant à la livraison de ces
+chantiers.
+
+Les sections historiques de ce fichier (et de la doc archive) qui
+citent « v2.0 » ou « v1.x » dans leur **prose** n'ont pas été
+réécrites : modifier le passé pour faire coïncider la terminologie
+avec le présent serait une réécriture d'historique trompeuse.  Lis
+« v2.0 » dans ces sections comme « l'état du code à la clôture du
+rewrite, devenu `0.9.0` au repositionnement ».
+
+Seuls les **titres de version** (`## [X.Y.Z]`) ont été réalignés pour
+que les tags git et les releases PyPI futures restent cohérents avec
+le numéro courant.
+
+---
+
+## Roadmap vers 1.0.0
+
+La sortie de `1.0.0` est conditionnée à la livraison de :
+
+1. **Surface UI complète** — exposition de tous les champs du modèle
+   `BenchmarkRunRequest`, parité fonctionnelle avec la CLI
+   (`compare`, `robustness`, `history`).
+2. **Parité importeurs corpus** — IIIF, Gallica, eScriptorium accessibles
+   depuis l'UI web.
+3. **Refonte rapport HTML** — IA 4 onglets (Overview / Engines / Documents / Crosses).
+
+Les versions intermédiaires `0.10.0`, `0.11.0`, etc. publient des
+jalons techniques au fil du chantier.
+
 ---
 
 ## [Unreleased] — Migration Option B vers RunOrchestrator (mai 2026)
@@ -454,7 +500,14 @@ et round-trip JSON appauvri.
 
 ---
 
-## [2.0.0] — Legacy retirement complete (mai 2026)
+## [0.9.0] — Legacy retirement complete (mai 2026)
+
+> Cette entrée porte le numéro de version dénommé **« 2.0.0 »**
+> jusqu'au 2026-05-23, repositionné en `0.9.0` dans le cadre de
+> l'alignement SemVer pré-1.0 (voir « Note de repositionnement » en
+> tête de fichier).  Le contenu n'a pas été réécrit : la prose
+> mentionne « v2.0 » et « 1.x » telles qu'elles étaient employées à
+> l'époque.
 
 **Breaking changes** majeurs : suppression complète des paquets
 legacy.  L'architecture canonique 8 couches (`domain → formats →

CLAUDE.md

@@ -4,6 +4,9 @@ Plateforme de benchmark OCR/HTR pour documents patrimoniaux.
 Repo : github.com/maribakulj/Picarones
 HuggingFace Space : huggingface.co/spaces/Ma-Ri-Ba-Ku/Picarones (Docker, port 7860)
 
+**Version courante** : `0.9.0` (pré-1.0).  Politique de versionning :
+[`docs/explanation/versioning.md`](docs/explanation/versioning.md).
+
 ---
 
 ## Architecture — 8 couches concentriques
@@ -17,12 +20,13 @@ domain → formats → evaluation → pipeline → adapters → app → reports
 Règle d'import stricte : les dépendances vont uniquement de l'extérieur
 vers l'intérieur.  Vérifié par `tests/architecture/test_layer_dependencies.py`
 + `tests/architecture/test_no_legacy_imports_in_rewrite.py`
-(`LEGACY_PACKAGES = ()` à v2.0 — plus aucun paquet legacy).
+(`LEGACY_PACKAGES = ()` — plus aucun paquet legacy).
 
 Tous les paquets legacy (`picarones/{core,measurements,engines,modules,
 report,llm,pipelines,cli,web,extras}/` + `adapters/legacy_engines/` +
 `adapters/legacy_pipelines/` + `interfaces/{cli,web}/_legacy/`) ont été
-**supprimés** au cours des sprints A-H (mai 2026).
+**supprimés** au cours des sprints A-H (mai 2026, clôture du rewrite
+architectural — release `0.9.0`).
 
 ---
 
@@ -212,11 +216,14 @@ labels d'affichage (i18n), pas des identifiants API.
 
 L'historique détaillé des **97+ sprints** du projet (de la fondation
 S1 jusqu'au rewrite ciblé S27-S46, l'audit institutionnel S47-S59,
-puis le retrait complet du legacy A-H jusqu'à v2.0) est dans le
-CHANGELOG.md à la racine.
+puis le retrait complet du legacy A-H aboutissant à `0.9.0`) est
+dans le CHANGELOG.md à la racine.
 
-**v2.0 (mai 2026)** : la migration vers l'architecture 8 couches
-canoniques est terminée.  Plus aucun paquet legacy.  Plus aucun shim.
+**Release `0.9.0` (mai 2026)** : la migration vers l'architecture
+8 couches canoniques est terminée.  Plus aucun paquet legacy.  Plus
+aucun shim.  Cette release portait en interne la dénomination « v2.0 »
+jusqu'au repositionnement en SemVer pré-1.0 (voir
+[`docs/explanation/versioning.md`](docs/explanation/versioning.md)).
 
 **Chantier post-rewrite (mai 2026, branche `claude/fix-module-rewiring-MHssX`)** :
 réconciliation des chemins UI/API/runner après audit révélant des
@@ -243,7 +250,9 @@ exécutées :
   automatiquement.
 - **Phase 5 (naming)** : `CompetitorConfig` → `PipelineConfig`,
   `ocr_engine` → `engine_name` (rupture API, le field accepte aussi
-  des VLMs et `corpus`).
+  des VLMs et `corpus`).  Le worker `run_benchmark_thread_v2` propage
+  les nouveaux champs (le suffixe `_v2` est un nom de fonction
+  interne hérité, sans rapport avec la dénomination de version).
 
 **Règles d'architecture** :
 
@@ -321,7 +330,7 @@ détecte, arbitre, rend.
 - **Manifeste architecture** : [`docs/explanation/architecture.md`](docs/explanation/architecture.md).
 - **API publique stable** : [`docs/reference/api-stable.md`](docs/reference/api-stable.md).
 
-### Statut v2.0 — mai 2026
+### Statut `0.9.0` — mai 2026
 
 L'architecture 8 couches est complète.  Tous les paquets legacy
 top-level (`core/`, `measurements/`, `engines/`, `modules/`,
@@ -335,4 +344,15 @@ que les sous-paquets transitoires (`adapters/legacy_engines/`,
 | Foundation S1-S26 | ✅ | domain, formats, evaluation, narrative engine |
 | Rewrite ciblé S27-S46 | ✅ | pipeline, app.services, adapters/ocr canonique, reports |
 | Audit S47-S59 | ✅ | confidences, sécurité web, registry typé, baselines |
-| Plan A-H (mai 2026) | ✅ | Retrait complet du legacy : core/measurements/engines/modules/report/llm/pipelines/cli/web/extras supprimés ; interfaces/{cli,web}/_legacy promus au niveau canonique ; v2.0 release |
+| Plan A-H (mai 2026) | ✅ | Retrait complet du legacy : core/measurements/engines/modules/report/llm/pipelines/cli/web/extras supprimés ; interfaces/{cli,web}/_legacy promus au niveau canonique ; release `0.9.0` (cycle de rewrite clôturé) |
+
+### Roadmap vers 1.0.0
+
+La sortie de `1.0.0` est conditionnée à la livraison de :
+
+1. **Surface UI complète** — exposition de tous les champs `BenchmarkRunRequest`,
+   parité fonctionnelle avec la CLI (`compare`, `robustness`, `history`).
+2. **Parité importeurs corpus** — IIIF, Gallica, eScriptorium accessibles en web.
+3. **Refonte rapport HTML** — IA 4 onglets (Overview / Engines / Documents / Crosses).
+
+Releases intermédiaires `0.10.0`, `0.11.0`, … publient des jalons techniques.

README.md

@@ -13,13 +13,13 @@ pinned: false
 >
 > **Outil de comparaison d'OCR / HTR / VLM et de post-correction pour documents patrimoniaux**
 
-**Status (May 2026)** — version 1.x, scientific prototype under
-consolidation.  The core (corpus, runner, metrics, HTML report) is
-usable to compare transcription pipelines on a ground-truth corpus.
-A targeted rewrite (see
-[`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.
+**Status (May 2026)** — version **`0.9.0`** (pre-1.0, see
+[versioning policy](docs/explanation/versioning.md)).  Architecture
+stable, functional surface under construction.  The core (corpus,
+runner, metrics, HTML report) is usable on a ground-truth corpus.
+The [architectural rewrite](docs/archive/2026-roadmap/rewrite.md) is
+**complete** ; remaining work towards `1.0.0` covers the web UI, the
+HTML report refactor, and corpus importer parity.
 
 [![CI](https://github.com/maribakulj/Picarones/actions/workflows/ci.yml/badge.svg)](https://github.com/maribakulj/Picarones/actions/workflows/ci.yml) [![codecov](https://codecov.io/gh/maribakulj/Picarones/graph/badge.svg)](https://codecov.io/gh/maribakulj/Picarones)
 [![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
@@ -333,12 +333,13 @@ picarones/
 ```
 
 Strict 8-layer architecture: imports flow outer → inner. Enforced
-by `tests/architecture/test_layer_dependencies.py`. The v2.0
-release (May 2026) removed all legacy top-level packages (`core/`,
-`measurements/`, `engines/`, `llm/`, `pipelines/`, `report/`,
-`modules/`, `cli/`, `web/`, `extras/`) and the transitional
-sub-packages (`adapters/legacy_engines/`, `adapters/legacy_pipelines/`,
-`interfaces/{cli,web}/_legacy/`). See
+by `tests/architecture/test_layer_dependencies.py`. Release `0.9.0`
+(May 2026) marks the end of the architectural rewrite cycle: all
+legacy top-level packages (`core/`, `measurements/`, `engines/`,
+`llm/`, `pipelines/`, `report/`, `modules/`, `cli/`, `web/`,
+`extras/`) and transitional sub-packages
+(`adapters/legacy_engines/`, `adapters/legacy_pipelines/`,
+`interfaces/{cli,web}/_legacy/`) have been removed. See
 [`docs/explanation/architecture.md`](docs/explanation/architecture.md)
 for the full manifesto and migration history under
 `docs/archive/2026-migration/`.
@@ -439,9 +440,11 @@ Detailed history and current direction live in:
 - [`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
+  pre-rewrite roadmap (`2026-roadmap/`), institutional audits
   (`2026-audits/`), rewrite/migration plans (`2026-migration/`),
-  pre-v2.0 changelog (`changelog-pre-v2.md`).
+  pre-rewrite changelog (`changelog-pre-v2.md`).  The archived
+  documents use the internal `v2.0` codename for the rewrite that
+  was repositioned as `0.9.0` — see [`docs/archive/README.md`](docs/archive/README.md).
 
 **Honest status (May 2026).** Several items historically presented as
 "institutional readiness complete" are not at the level the README

docs/archive/README.md

@@ -2,21 +2,42 @@
 
 > **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.
+> changelogs antérieurs au rewrite architectural complet.  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).
 
 ---
 
+## Note de repositionnement (2026-05-23)
+
+Les documents archivés ici utilisent la dénomination interne
+**« v2.0 »** pour désigner l'aboutissement du rewrite architectural
+en 8 couches (mai 2026).  Cette dénomination, qui reflétait une
+logique de refactor interne plutôt qu'une release publique mûre, a
+été **repositionnée en `0.9.0`** lors de l'alignement du projet sur
+SemVer pré-1.0.
+
+**Le contenu de l'archive n'a volontairement pas été réécrit** :
+modifier le passé pour faire coïncider la terminologie avec le
+présent serait une réécriture d'historique trompeuse.  Lis donc
+« v2.0 » dans les fichiers archivés comme « l'état du code à la
+clôture du rewrite, devenu `0.9.0` au repositionnement ».
+
+Politique de versionning actuelle : voir
+[`docs/explanation/versioning.md`](../explanation/versioning.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.
+À l'aboutissement du rewrite architectural (mai 2026), le projet a
+clôturé sa 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 :
 

docs/explanation/architecture.md

@@ -5,17 +5,18 @@
 > sont les fichiers*.  Pour la liste exhaustive des modules, lire
 > directement le code — il est typé et documenté.
 
-## Statut v2.0 — une seule arborescence canonique
+## Statut `0.9.0` — une seule arborescence canonique
 
-À v2.0 (mai 2026), Picarones a **une seule arborescence**.  Tous
-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/archive/2026-migration/`](../archive/2026-migration/).
+À la release `0.9.0` (mai 2026, clôture du rewrite architectural),
+Picarones a **une seule arborescence**.  Tous 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 0.9.0](../../CHANGELOG.md) 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.
-La seule cohabitation acceptable à v2.0+ est celle entre
+La seule cohabitation acceptable depuis `0.9.0` est celle entre
 **modules canoniques** : par exemple `evaluation/metric_registry`
 (module-level, side-effect d'import) et `evaluation/registry/registry`
 (instance-based) — deux patterns volontairement coexistants pour
@@ -200,9 +201,9 @@ on choisit explicitement entre :
 - **Shim avec `DeprecationWarning`** (pour la stabilité d'API publique).
   Le shim a une date de retrait inscrite dans le CHANGELOG.
 
-À v2.0 il reste **un seul shim** documenté :
+À `0.9.0` il reste **un seul shim** documenté :
 `picarones/pipeline/spec.py` (réexporte `picarones.domain.pipeline_spec`),
-dont la deprecation period expire en v2.1.
+dont la deprecation period expire à la prochaine minor `0.10.0`.
 
 ### Pas d'`except Exception: pass`
 
@@ -249,9 +250,9 @@ publication scientifique.
 L'évolution de l'architecture est documentée :
 
 - Backlog vivant : [`docs/roadmap/backlog.md`](../roadmap/backlog.md)
-- Plans archivés (migration legacy → rewrite, terminée à v2.0) :
+- Plans archivés (migration legacy → rewrite, terminée à `0.9.0`) :
   [`docs/archive/2026-migration/`](../archive/2026-migration/)
-- Roadmap historique pré-v2.0 :
+- Roadmap historique pré-rewrite :
   [`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/explanation/versioning.md

@@ -0,0 +1,137 @@
+# Politique de versionning
+
+> Comment Picarones numérote ses versions, et pourquoi.
+
+## Résumé
+
+Picarones suit **Semantic Versioning 2.0.0** strict :
+`MAJOR.MINOR.PATCH` avec suffixes pré-release PEP 440 (`-rc1`,
+`-beta1`, `-alpha1`).
+
+**État courant** : `0.9.0` — phase pré-1.0.  Architecture stable,
+surface fonctionnelle en construction.
+
+**Cible** : `1.0.0` — release publique avec UI, rapport refondu et
+parité des importeurs livrés.
+
+---
+
+## SemVer pré-1.0 : qu'est-ce que ça change ?
+
+En `0.x`, SemVer autorise **les ruptures sans préavis**.  Picarones
+les annonce explicitement dans le `CHANGELOG.md` mais ne garantit
+pas de période de dépréciation.  C'est précisément l'intérêt du
+pré-1.0 : pouvoir corriger l'API publique sans empêcher la
+progression.
+
+Concrètement :
+
+- les schémas JSON (`BenchmarkResult`, `run_manifest.json`,
+  `pipeline_results.jsonl`, `view_results.jsonl`) **peuvent évoluer**
+  entre `0.9.x` et `0.10.x` ;
+- les noms de paramètres CLI **peuvent changer** ;
+- les endpoints HTTP **peuvent être renommés ou retirés** ;
+- les contrats internes (Pydantic models de `picarones.domain`)
+  **peuvent être modifiés**.
+
+Chaque rupture est documentée dans le `CHANGELOG.md` sous la section
+`### BREAKING`.
+
+À partir de `1.0.0`, la politique se durcit : période de
+dépréciation minimum d'une mineure, retrait à la majeure suivante.
+
+---
+
+## Mapping version ↔ tag git
+
+Le numéro de version est dérivé du **tag git** par
+`setuptools_scm`.  Pas de version codée en dur dans `pyproject.toml`.
+
+| Contexte | Version produite |
+|---|---|
+| Tag `v0.9.0` posé sur un commit | `0.9.0` |
+| 5 commits après `v0.9.0` (sans nouveau tag) | `0.9.1.dev5+g<sha>` |
+| Tag `v0.10.0-rc1` | `0.10.0rc1` (PEP 440) |
+| Sans aucun tag (tarball, repo neuf) | `0.9.0` (fallback) |
+
+Le `fallback_version` de `pyproject.toml` est synchronisé avec
+`picarones/domain/_version_fallback.py:FALLBACK_VERSION`.  Un test
+d'architecture (`tests/architecture/test_single_version_source.py`)
+vérifie cette cohérence.
+
+---
+
+## Roadmap vers 1.0.0
+
+La sortie de `1.0.0` est conditionnée à la livraison de :
+
+1. **Surface UI complète** — exposition de tous les champs du modèle
+   `BenchmarkRunRequest`, refonte du rapport HTML, parité fonctionnelle
+   avec la CLI (`compare`, `robustness`, `history`).
+2. **Parité importeurs corpus** — IIIF, Gallica, eScriptorium accessibles
+   depuis l'UI web (en plus de HTR-United et HuggingFace déjà présents).
+3. **Refonte rapport HTML** — passage à l'IA 4 onglets (Overview / Engines
+   / Documents / Crosses) en gardant la stack Jinja2.
+
+Les versions intermédiaires `0.10.0`, `0.11.0`, etc. peuvent être
+publiées au fil du chantier ; elles sont des jalons techniques, pas
+des releases publiques.
+
+---
+
+## Pourquoi `0.9.0` plutôt que `2.0.x` ou `3.0.0` ?
+
+L'historique interne du projet utilisait une dénomination « v2.0 »
+pour désigner l'aboutissement du rewrite architectural en 8 couches
+(mai 2026).  Cette dénomination reflétait un cycle de refactor
+interne, pas une maturité fonctionnelle publique : à ce moment, le
+projet n'avait ni interface utilisateur finalisée, ni parité
+importeurs, ni rapport refondu.
+
+Le repositionnement en `0.9.0` (mai 2026) aligne le numéro de
+version sur la maturité réelle : architecture solide, surface
+fonctionnelle en construction.  La sortie de `1.0.0` deviendra un
+événement public marquant (UI complète, rapport refondu, parité
+importeurs), ce qui correspond à l'usage habituel d'un saut
+`0.x → 1.0`.
+
+Ce choix est documenté dans la note de repositionnement de
+[`docs/archive/README.md`](../archive/README.md) et dans la première
+entrée du [`CHANGELOG.md`](../../CHANGELOG.md) post-repositionnement.
+
+---
+
+## Source unique de vérité (anti-dérive)
+
+La version courante est définie à **un seul endroit** : le tag git le
+plus récent, lu par `setuptools_scm`.
+
+Le fallback (utilisé en l'absence de tag) est défini à **un seul
+endroit** : `picarones/domain/_version_fallback.py:FALLBACK_VERSION`.  La
+constante équivalente `fallback_version` dans `pyproject.toml` doit
+rester synchronisée — un test d'architecture le vérifie.
+
+**Règle de codage** : interdiction de coder un numéro de version en
+dur ailleurs que dans ces deux fichiers.  Tout consommateur doit
+lire `picarones.__version__` (ou ses équivalents internes
+`_resolve_picarones_version()` pour les couches qui ne peuvent pas
+importer le package racine).
+
+---
+
+## Procédure de release
+
+Voir [`docs/operations/release-process.md`](../operations/release-process.md)
+pour la procédure complète.  Le résumé :
+
+```bash
+# 1. Mettre à jour CHANGELOG.md (section ## [X.Y.Z] — YYYY-MM-DD)
+git commit -am "docs(changelog): release 0.10.0"
+
+# 2. Tag annoté
+git tag -a v0.10.0 -m "Picarones 0.10.0"
+git push origin main v0.10.0
+
+# 3. Le workflow .github/workflows/release.yml déclenche
+#    automatiquement build + TestPyPI + PyPI + Docker + GitHub Release.
+```

docs/index.md

@@ -137,15 +137,15 @@ Vous évaluez les implications RGPD avant signature.
 
 | Document | Sujet |
 |----------|-------|
-| [`/CHANGELOG.md`](../CHANGELOG.md) | Journal des versions actives (post-v2.0) |
-| [`archive/`](archive/) | Documents archivés (audits, migration, roadmap pré-v2.0, changelog historique) |
+| [`/CHANGELOG.md`](../CHANGELOG.md) | Journal des versions actives (depuis `0.9.0`) |
+| [`archive/`](archive/) | Documents archivés (audits, migration, roadmap pré-rewrite, changelog historique) |
 | [`roadmap/backlog.md`](roadmap/backlog.md) | Backlog vivant |
 
 ---
 
 ## Conventions
 
-- **Une seule arborescence canonique (v2.0)** :
+- **Une seule arborescence canonique** (depuis `0.9.0`) :
   `domain → formats → evaluation → pipeline → adapters → app → reports → interfaces`.
   Les paquets legacy ont été supprimés en mai 2026.
 - **Tout chemin `picarones/.../X.py` cité dans la doc doit exister**.

docs/operations/release-process.md

@@ -80,14 +80,14 @@ git checkout main
 git pull --ff-only
 
 # 2. Mettre à jour le CHANGELOG.md (Keep a Changelog)
-#    Ajouter une section ## [1.2.0] — YYYY-MM-DD avec les changes
+#    Ajouter une section ## [0.10.0] — YYYY-MM-DD avec les changes
 git add CHANGELOG.md
-git commit -m "docs(changelog): release 1.2.0"
+git commit -m "docs(changelog): release 0.10.0"
 
 # 3. Tag annoté + push
-git tag -a v1.2.0 -m "Picarones 1.2.0"
+git tag -a v0.10.0 -m "Picarones 0.10.0"
 git push origin main
-git push origin v1.2.0
+git push origin v0.10.0
 
 # 4. Surveiller le workflow Actions
 gh run watch
@@ -110,19 +110,23 @@ Durée totale : ~15 min (multi-arch + 30s d'indexation TestPyPI).
 
 ## Versionnement
 
-Picarones suit **Semantic Versioning 2.0.0** :
+Picarones suit **Semantic Versioning 2.0.0**.  Politique complète :
+[`docs/explanation/versioning.md`](../explanation/versioning.md).
 
 - `MAJOR.MINOR.PATCH` — incompatibilité, ajout, fix.
 - Suffixes pré-release : `-rc1`, `-beta1`, `-alpha1`. Le workflow
   les détecte et coche `prerelease=true` sur la GitHub Release.
+- **État courant : `0.x` (pré-1.0)** — les ruptures peuvent
+  intervenir sans période de dépréciation, annoncées dans le
+  `CHANGELOG.md`.
 
 `setuptools_scm` dérive automatiquement la version du tag git :
 
 | Contexte | Version produite |
 |---|---|
-| Tag `v1.2.0` | `1.2.0` |
-| 5 commits après `v1.2.0` | `1.2.1.dev5+g<sha>` (dev seulement) |
-| `v1.3.0-rc1` | `1.3.0rc1` (PEP 440) |
+| Tag `v0.10.0` | `0.10.0` |
+| 5 commits après `v0.10.0` | `0.10.1.dev5+g<sha>` (dev seulement) |
+| `v0.11.0-rc1` | `0.11.0rc1` (PEP 440) |
 
 ## Procédure d'urgence : hotfix sécurité
 
@@ -133,9 +137,9 @@ git checkout -b hotfix-cve-2026-XXXX main
 # correctif minimal + test
 git commit -m "fix(security): patch CVE-2026-XXXX"
 # CHANGELOG bump
-git commit -m "docs(changelog): release 1.2.1"
-git tag -a v1.2.1 -m "Picarones 1.2.1 (security)"
-git push origin hotfix-cve-2026-XXXX v1.2.1
+git commit -m "docs(changelog): release 0.9.1"
+git tag -a v0.9.1 -m "Picarones 0.9.1 (security)"
+git push origin hotfix-cve-2026-XXXX v0.9.1
 # Le workflow release.yml gère le reste.
 # Après merge : annonce sur SECURITY.md + courriel mainteneur.
 ```

docs/operations/rollback.md

@@ -25,15 +25,15 @@ Code → schéma → config.
 # Identifier la version actuelle
 docker inspect picarones | grep Version
 
-# Rollback vers la version précédente (ex : v2.0.0 → v1.5.3)
-docker pull ghcr.io/maribakulj/picarones:v1.5.3
+# Rollback vers la version précédente (ex : v0.10.0 → v0.9.0)
+docker pull ghcr.io/maribakulj/picarones:v0.9.0
 docker stop picarones
 docker rm picarones
 docker run --name picarones \
     -p 7860:7860 \
     --env-file /etc/picarones/.env \
     -v /var/lib/picarones/jobs.db:/app/jobs.db \
-    ghcr.io/maribakulj/picarones:v1.5.3
+    ghcr.io/maribakulj/picarones:v0.9.0
 
 # Vérifier
 curl -fsS http://localhost:7860/health
@@ -46,7 +46,7 @@ curl -fsS http://localhost:7860/health
 pip index versions picarones
 
 # Rollback
-pip install --force-reinstall picarones==1.5.3
+pip install --force-reinstall picarones==0.9.0
 
 # Vérifier
 picarones --version
@@ -76,15 +76,16 @@ nécessite de revenir à un schéma antérieur :
 ### Cas simple : downgrade non destructif
 
 Si la migration N→N+1 a uniquement **ajouté** des colonnes / tables
-(jamais supprimé), le code v1.5.3 lit un schéma v2 sans plantage —
-les nouvelles colonnes sont simplement ignorées.
+(jamais supprimé), le code de la version cible lit un schéma plus
+récent sans plantage — les nouvelles colonnes sont simplement
+ignorées.
 
 Aucune action requise.
 
 ### Cas complexe : downgrade destructif
 
-Si la migration a renommé/supprimé des colonnes, le code v1.5.3
-peut lever des `sqlite3.OperationalError`.
+Si la migration a renommé/supprimé des colonnes, le code de la
+version cible peut lever des `sqlite3.OperationalError`.
 
 **Procédure** :
 
@@ -107,7 +108,7 @@ peut lever des `sqlite3.OperationalError`.
    ```
 
 4. **Forcer le schema_version à la valeur attendue par le code
-   v1.5.3** (si nécessaire) :
+   de la version cible** (si nécessaire) :
 
    ```sql
    sqlite3 /var/lib/picarones/jobs.db
@@ -115,14 +116,14 @@ peut lever des `sqlite3.OperationalError`.
    sqlite> .quit
    ```
 
-5. Redémarrer Picarones v1.5.3.
+5. Redémarrer Picarones à la version cible.
 6. Vérifier que les jobs anciens sont lisibles via `GET /api/jobs`.
 
 ### Pas de backup ?
 
-Le code v2.0+ a un mode "lecture seule défensive" : si le
-`schema_version` est plus récent que celui attendu, le code log
-un warning explicite et tente de continuer.  En cas d'incident,
+Le code Picarones (depuis `0.9.0`) a un mode "lecture seule
+défensive" : si le `schema_version` est plus récent que celui
+attendu, le code log un warning explicite et tente de continuer.  En cas d'incident,
 les jobs *nouveaux* fonctionnent ; les jobs *anciens* (avec des
 champs nouveaux) peuvent apparaître tronqués mais ne crashent
 pas.

docs/reference/api-stable.md

@@ -1,8 +1,8 @@
 # API publique stable de Picarones
 
-> **Statut v2.0 (mai 2026)** : la migration vers l'architecture
-> 8 couches canoniques est terminée.  Tous les paquets legacy
-> top-level (`picarones.core`, `picarones.measurements`,
+> **Statut `0.9.0` (mai 2026)** — phase pré-1.0.  L'**architecture**
+> est stable : les 8 couches canoniques sont en place, tous les
+> paquets legacy top-level (`picarones.core`, `picarones.measurements`,
 > `picarones.engines`, `picarones.modules`, `picarones.report`,
 > `picarones.llm`, `picarones.pipelines`, `picarones.cli`,
 > `picarones.web`, `picarones.extras`) ainsi que les sous-paquets
@@ -10,6 +10,12 @@
 > `interfaces/{cli,web}/_legacy/`) ont été **supprimés**.  Plus aucun
 > shim, plus aucun `DeprecationWarning` rétrocompat.
 >
+> En revanche, l'**API publique** elle-même n'est pas figée tant que
+> `1.0.0` n'est pas livré.  Les schémas JSON, noms de paramètres CLI
+> et endpoints HTTP peuvent évoluer entre `0.9.x` et `0.10.x` sans
+> période de dépréciation, conformément à la
+> [politique de versionning pré-1.0](../explanation/versioning.md).
+>
 > **Architecture canonique (cf.
 > [`docs/explanation/architecture.md`](../explanation/architecture.md))** :
 > `domain → formats → evaluation → pipeline → adapters → app →
@@ -271,9 +277,9 @@ def reset_default_store(...)
   historiques qui les importent (Sprint 13/42) sont préservés mais
   par effort, pas par contrat.
 
-### Bump majeur (`2.0.0`)
+### Bump majeur (`1.0.0` puis `2.0.0`)
 
-Un bump majeur sera nécessaire pour :
+À partir de `1.0.0`, un bump majeur sera nécessaire pour :
 
 - Supprimer un nom de cette liste.
 - Changer la signature d'une fonction publique de manière non
@@ -281,10 +287,14 @@ Un bump majeur sera nécessaire pour :
 - Casser le format de sérialisation du `BenchmarkResult.to_json()`.
 - Renommer un module de l'arborescence canonique.
 
+En `0.x` (état courant), ces changements peuvent se produire sans
+bump majeur, mais sont annoncés dans le `CHANGELOG.md` sous une
+section `### BREAKING`.
+
 ## Chemins canoniques par couche
 
-L'arborescence v2.0 expose des points d'entrée stables organisés par
-couche.  Toutes les intégrations doivent passer par ces chemins —
+L'arborescence `0.9.0` expose des points d'entrée stables organisés
+par couche.  Toutes les intégrations doivent passer par ces chemins —
 plus de path legacy disponible.
 
 ### Couche 3 — `picarones.evaluation`

docs/reference/reproducibility-snapshots.md

@@ -79,7 +79,7 @@ ont été appliquées au moment du calcul de CER, **sans relancer**.
 ### `environment`
 
 ```yaml
-picarones_version: "1.1.0"
+picarones_version: "0.9.0"
 python_version: "3.11.13"
 platform: "Linux 6.18.5-x86_64-with-glibc2.39"
 git_commit: "17cc5474..."

docs/reference/specification.md

@@ -3,14 +3,18 @@
 > **Plateforme de banc d'essai d'OCR / HTR / VLM et de pipelines de
 > post-correction pour documents patrimoniaux.**
 >
-> Version **2.0** — Mai 2026. Refonte intégrale (Sprint A14 du plan
-> de remédiation institutionnelle, item **B-12**).
+> Version 0.9.0 (pré-1.0) — Mai 2026.  Politique de versionning :
+> [`../explanation/versioning.md`](../explanation/versioning.md).
+>
+> Itération de spec **2** (révision éditoriale du document, distincte
+> du numéro de version du logiciel ; mai 2026).
 
 > **Note de lecture** : ce document décrit ce que Picarones **fait
-> aujourd'hui**, dans la version 1.x. Pour les **non-fonctionnalités
-> assumées** (ce que Picarones *ne fait pas et ne fera pas* dans
-> la v1.x — par exemple la recommandation prescriptive, l'export PDF,
-> les adapters Kraken/AWS Textract), voir la section §10.
+> aujourd'hui**, dans la version `0.9.0`.  Pour les
+> **non-fonctionnalités assumées** (ce que Picarones *ne fait pas et
+> ne fera pas* dans la lignée `0.x` — par exemple la recommandation
+> prescriptive, l'export PDF, les adapters Kraken/AWS Textract), voir
+> la section §10.
 >
 > Pour la cartographie technique du code et les règles de
 > contribution interne, voir [`CLAUDE.md`](../../CLAUDE.md). Ce document
@@ -724,18 +728,21 @@ configurable via `PICARONES_UPLOAD_RETENTION_DAYS=7` par défaut.
 ## 10. Limites assumées et non-fonctionnalités
 
 Cette section décrit explicitement **ce que Picarones ne fait pas
-et ne fera pas dans la v1.x**. Plusieurs items étaient promis dans
-la SPECS v1 (Mars 2025) — leur abandon est un choix éditorial
-documenté ci-dessous, pas un oubli.
+et ne fera pas dans la lignée `0.x`**.  Plusieurs items étaient
+promis dans une itération antérieure de cette spec (SPECS v1, mars
+2025) — leur abandon est un choix éditorial documenté ci-dessous,
+pas un oubli.  Les mentions « v1.0 », « v1.1 », « v1.2 » dans les
+items ci-dessous renvoient à la **roadmap historique** de cette
+spec, pas à des versions logicielles publiées.
 
 <!-- specs-check: known-abandoned-start -->
 
 > Toutes les fonctionnalités listées ci-dessous étaient promises ou
-> évoquées dans SPECS v1 et sont **explicitement abandonnées,
-> non implémentées ou reportées** dans la v2.0 de ce document.
-> Le test ``tests/docs/test_specs_consistency.py`` (Sprint A2)
-> détecte cette section comme la déclaration officielle des
-> non-fonctionnalités du projet.
+> évoquées dans SPECS v1 (itération de spec) et sont **explicitement
+> abandonnées, non implémentées ou reportées** dans l'itération de
+> spec actuelle (qui couvre le logiciel `0.9.0`).  Le test
+> ``tests/docs/test_specs_consistency.py`` détecte cette section
+> comme la déclaration officielle des non-fonctionnalités du projet.
 
 ### 10.1 Adapters OCR non livrés
 
@@ -821,10 +828,10 @@ Trois documents complémentaires pilotent l'évolution :
 - [`CHANGELOG.md`](CHANGELOG.md) — historique sprint par sprint,
   format Keep a Changelog.
 - [`docs/roadmap/backlog.md`](docs/roadmap/backlog.md) — backlog
-  vivant des chantiers post-v2.0.
+  vivant des chantiers post-`0.9.0`.
 - [`docs/archive/`](docs/archive/) — audits institutionnels,
-  plans de remédiation pré-v2.0, roadmap historique
-  (`2026-roadmap/evolution.md`), changelog pré-v2.0.
+  plans de remédiation pré-rewrite, roadmap historique
+  (`2026-roadmap/evolution.md`), changelog pré-rewrite.
 
 L'**état du plan institutionnel** au 2 mai 2026 :
 
@@ -842,13 +849,21 @@ L'**état du plan institutionnel** au 2 mai 2026 :
 
 ---
 
-## 12. Migration v1 → v2 — annexe historique
+## 12. Migration des itérations de spec (v1 → v2) — annexe historique
+
+> Cette section trace l'évolution **éditoriale du document de
+> spécification** entre son itération 1 (SPECS v1, mars 2025) et
+> son itération 2 (le présent document).  Les indices « v1.0 »,
+> « v1.1 » dans la colonne de gauche désignent la **roadmap**
+> historique de SPECS v1, pas des versions logicielles publiées.
+> Pour la politique de versionning du logiciel,
+> voir [`../explanation/versioning.md`](../explanation/versioning.md).
 
 Pour les lecteurs qui avaient pris connaissance de SPECS v1.0
 (mars 2025) ou de l'Addendum Sprints 16-30, voici la table de
 migration des promesses changées :
 
-| SPECS v1 disait | SPECS v2 documente | Raison |
+| SPECS v1 disait | SPECS itération 2 documente | Raison |
 |---|---|---|
 | Adapter Kraken (priorité v1.0) | Ouvert en plugin externe | Politique modules contribués Sprint 97 ; concentration sur 5 adapters cœur. |
 | Adapter AWS Textract (v1.1) | Abandonné | Pas de DPA, périmètre couvert par 3 clouds existants. |
@@ -883,4 +898,5 @@ intégration des standards bibliothéconomiques (IIIF, ALTO XML,
 PAGE XML, HTR-United, eScriptorium, Gallica), rapport interactif
 exportable, snapshot de reproductibilité.*
 
-*Dernière mise à jour : 2 mai 2026 (Sprint A14, refonte v2.0).*
+*Dernière mise à jour : 23 mai 2026 (repositionnement SemVer pré-1.0,
+couvre logiciel `0.9.0`).*

docs/roadmap/backlog.md

@@ -113,7 +113,7 @@ exister à la livraison BnF.
   dossier isolé par session/run.
 - Schemas DTO (Pydantic) séparés des modèles de domaine.
 
-→ Chantier post-v2.0.
+→ Chantier post-`0.9.0` (cf. roadmap → 1.0 dans CHANGELOG).
 
 ### 2.4 Suppression de la dette d'imports magiques
 
@@ -123,7 +123,7 @@ exister à la livraison BnF.
 - Entry points Python pour les modules tiers (`picarones.metrics`,
   `picarones.adapters`).
 
-→ Chantier post-v2.0.
+→ Chantier post-`0.9.0` (cf. roadmap → 1.0 dans CHANGELOG).
 
 ### 2.5b Migration des adapters restants
 

docs/security/threat-model.md

@@ -14,8 +14,8 @@
 > ouvert anonymisé, sans secrets), CLI mono-utilisateur en local
 > (modèle de menace = celui de la machine de l'utilisateur).
 >
-> **Statut** : v1, 2026-05.  À réviser à chaque release majeure ou
-> incident sécurité.
+> **Statut** : itération 1, 2026-05 (couvre `0.9.0`).  À réviser à
+> chaque release majeure ou incident sécurité.
 
 ## Acteurs
 

picarones/__init__.py

@@ -22,13 +22,14 @@ Voir ``docs/explanation/architecture.md`` pour la cartographie complète des
 
 from __future__ import annotations
 
-# Version (Sprint A9 / M-5) — résolue dans cet ordre :
+# Version résolue dans cet ordre :
 #   1. ``picarones._version`` injecté au build par setuptools_scm
 #      (présent dans le wheel installé) ;
 #   2. fallback ``importlib.metadata.version("picarones")`` pour les
 #      installations editable où ``_version.py`` peut être stale ;
-#   3. fallback final ``"1.0.0"`` si aucune source n'est disponible
-#      (ex : tarball sans .git ni metadata).
+#   3. fallback final ``FALLBACK_VERSION`` (source unique partagée,
+#      cf. ``picarones/domain/_version_fallback.py``) si aucune source
+#      n'est disponible (ex : tarball sans .git ni metadata).
 try:
     from picarones._version import __version__  # type: ignore[import-not-found]
 except ImportError:
@@ -36,7 +37,8 @@ except ImportError:
         from importlib.metadata import version as _get_version
         __version__ = _get_version("picarones")
     except Exception:  # noqa: BLE001
-        __version__ = "2.0.0"
+        from picarones.domain._version_fallback import FALLBACK_VERSION
+        __version__ = FALLBACK_VERSION
 
 __author__ = "Picarones contributors"
 

picarones/domain/_version_fallback.py

@@ -0,0 +1,37 @@
+"""Source unique du fallback de version.
+
+Ce module vit dans la couche ``domain`` (couche 1) pour être
+importable depuis n'importe quelle couche externe sans violer le
+sens des dépendances.  Il est volontairement minimal (aucun import,
+aucune logique).  Référence partagée entre :
+
+- ``picarones/__init__.py`` (chemin de résolution principal) ;
+- ``picarones/evaluation/benchmark_result.py`` (couche evaluation,
+  ne peut pas importer ``picarones`` racine) ;
+- ``picarones/reports/html/snapshot.py`` (couche reports,
+  ne peut pas importer ``picarones`` racine).
+
+Le fallback ``FALLBACK_VERSION`` est utilisé **uniquement** quand
+les deux sources canoniques sont absentes :
+
+1. ``picarones/_version.py`` (généré au build par setuptools_scm
+   à partir du tag git le plus récent) ;
+2. ``importlib.metadata.version("picarones")`` (paquet installé via
+   pip, lit le wheel metadata).
+
+Le fallback se déclenche dans les cas suivants :
+
+- tarball sdist sans historique git ;
+- installation editable sans ``pip install -e .`` au préalable ;
+- environnement de test isolé qui efface les metadata.
+
+Cohérence avec ``pyproject.toml`` : la valeur ci-dessous DOIT être
+identique à ``[tool.setuptools_scm] fallback_version`` dans
+``pyproject.toml``.  Un test d'architecture
+(``tests/architecture/test_single_version_source.py``) vérifie
+cette équivalence.
+
+Politique de versionning : voir ``docs/explanation/versioning.md``.
+"""
+
+FALLBACK_VERSION = "0.9.0"

picarones/evaluation/benchmark_result.py

@@ -35,17 +35,18 @@ def _resolve_picarones_version() -> str:
     le package racine.
 
     Raison : la couche ``evaluation`` ne peut pas importer
-    ``picarones`` (le package racine, qui importe ``measurements``
-    et déclencherait un cycle).  On lit la version via
+    ``picarones`` (le package racine, qui importerait ``evaluation``
+    en retour et déclencherait un cycle).  On lit la version via
     ``importlib.metadata`` (chemin de production : wheel installé)
-    avec un fallback ``"1.0.0"`` cohérent avec
-    ``picarones/__init__.py``.
+    avec un fallback partagé via ``picarones._version_fallback``
+    (source unique alignée avec ``pyproject.toml``).
     """
     try:
         from importlib.metadata import version as _get_version
         return _get_version("picarones")
     except Exception:  # noqa: BLE001
-        return "1.0.0"
+        from picarones.domain._version_fallback import FALLBACK_VERSION
+        return FALLBACK_VERSION
 
 
 __version__ = _resolve_picarones_version()

picarones/reports/html/snapshot.py

@@ -45,12 +45,16 @@ from typing import Any, Optional
 
 def _resolve_picarones_version() -> str:
     """Récupère la version courante de Picarones sans importer le
-    package racine (interdit depuis ``reports/`` par layer-deps)."""
+    package racine (interdit depuis ``reports/`` par layer-deps).
+
+    Fallback partagé via ``picarones._version_fallback`` (source
+    unique alignée avec ``pyproject.toml``)."""
     try:
         from importlib.metadata import version as _get_version
         return _get_version("picarones")
     except Exception:  # noqa: BLE001
-        return "1.0.0"
+        from picarones.domain._version_fallback import FALLBACK_VERSION
+        return FALLBACK_VERSION
 
 
 __version__ = _resolve_picarones_version()

pyproject.toml

@@ -1,16 +1,17 @@
 [build-system]
-# Sprint A9 (M-5) : setuptools_scm dérive la version du tag git le
-# plus proche. Le pipeline release.yml tag ``v1.2.3`` produit donc
-# un wheel ``picarones-1.2.3-py3-none-any.whl`` sans toucher à
-# pyproject.toml. Pour les builds non-tag (PR, dev) : version
-# pseudo ``1.2.4.dev3+g<sha>``.
+# setuptools_scm dérive la version du tag git le plus proche.  Le
+# pipeline release.yml tag ``v0.9.0`` produit donc un wheel
+# ``picarones-0.9.0-py3-none-any.whl`` sans toucher à pyproject.toml.
+# Pour les builds non-tag (PR, dev) : version pseudo
+# ``0.9.1.dev3+g<sha>``.
 requires = ["setuptools>=68.0", "wheel", "setuptools_scm[toml]>=8.0"]
 build-backend = "setuptools.build_meta"
 
 [project]
 name = "picarones"
-# Sprint A9 (M-5) : ``version`` est désormais dynamique, dérivé du
-# tag git via setuptools_scm. Voir [tool.setuptools_scm] plus bas.
+# ``version`` est dynamique, dérivée du tag git via setuptools_scm.
+# Voir [tool.setuptools_scm] plus bas et
+# ``docs/explanation/versioning.md`` pour la politique SemVer.
 dynamic = ["version"]
 description = "Plateforme de comparaison de moteurs OCR/HTR pour documents patrimoniaux"
 readme = "README.md"
@@ -137,19 +138,24 @@ all = [
 picarones = "picarones.interfaces.cli:cli"
 
 # ──────────────────────────────────────────────────────────────────
-# Sprint A9 (M-5) — version dynamique via setuptools_scm.
+# Version dynamique via setuptools_scm.
 #
 # Comportement :
-# - sur un tag ``v1.2.3``  → version ``1.2.3``
-# - hors tag (PR, main)   → ``1.2.4.dev<N>+g<sha>`` (PEP 440)
+# - sur un tag ``v0.9.0``  → version ``0.9.0``
+# - hors tag (PR, main)   → ``0.9.1.dev<N>+g<sha>`` (PEP 440)
 # - le ``write_to`` injecte ``picarones/_version.py`` au build, lu
 #   par ``picarones/__init__.py`` via ``__version__``.
 # ``fallback_version`` est utilisé si l'historique git est absent
-# (ex : tarball sdist) — doit être maintenu cohérent avec le dernier tag.
+# (ex : tarball sdist) — doit être maintenu cohérent avec le dernier
+# tag et avec ``picarones/domain/_version_fallback.py:FALLBACK_VERSION``.
+# La cohérence est vérifiée par
+# ``tests/architecture/test_single_version_source.py``.
+#
+# Politique de versionning : voir ``docs/explanation/versioning.md``.
 # ──────────────────────────────────────────────────────────────────
 [tool.setuptools_scm]
 write_to = "picarones/_version.py"
-fallback_version = "1.0.0"
+fallback_version = "0.9.0"
 version_scheme = "release-branch-semver"
 local_scheme = "no-local-version"
 

tests/architecture/test_doc_governance.py

@@ -58,8 +58,9 @@ ACTIVE_DOC_LINE_BUDGET_ALLOWLIST: frozenset[str] = frozenset({
     # déjà découpée en sections, le tout en un fichier reste utile
     # comme contrat unique consultable d'un coup.
     "docs/reference/specification.md",
-    # CHANGELOG actif : période v2.0 et après.  L'historique pré-v2.0
-    # vit dans docs/archive/changelog-pre-v2.md.
+    # CHANGELOG actif : période 0.9.0 et après (anciennement appelée
+    # v2.0 en interne).  L'historique pré-rewrite vit dans
+    # docs/archive/changelog-pre-v2.md.
     "CHANGELOG.md",
 })
 

tests/architecture/test_doc_paths.py

@@ -4,7 +4,7 @@ Scanne ``CLAUDE.md``, ``README.md``, ``docs/**/*.md`` à la recherche de
 chemins de la forme ``picarones/.../X.py`` et vérifie qu'ils existent
 dans le repo.
 
-Snapshot v1.0.0 (2026-05-02) : **119 chemins cassés**, presque tous
+Snapshot initial (2026-05-02) : **119 chemins cassés**, presque tous
 dans ``CLAUDE.md`` et ``CHANGELOG.md`` qui décrivent systématiquement
 des modules sous ``picarones/core/...`` alors qu'ils vivent dans
 ``picarones/measurements/...``. C'est une dette documentaire connue
@@ -19,6 +19,12 @@ le faire baisser :
 3. Soit retirer la référence devenue obsolète.
 
 Puis abaisser :data:`BROKEN_PATHS_BASELINE` du même montant.
+
+Note : l'historique de baseline ci-dessous utilise les dénominations
+de version telles qu'elles existaient à chaque sprint (« v1.0.0 »,
+« v2.0 », etc.).  Ces étiquettes ne sont pas mises à jour
+rétroactivement après le repositionnement SemVer pré-1.0 — voir
+``docs/explanation/versioning.md``.
 """
 
 from __future__ import annotations

tests/architecture/test_doc_truthfulness.py

@@ -1,14 +1,17 @@
-"""Sprint S2.2 — Garde-fous contre la dérive entre code et documentation.
+"""Garde-fous contre la dérive entre code et documentation.
 
-À v2.0, plusieurs documents racontaient une histoire fausse :
+Vérifie des invariants structurels indépendants du numéro de
+version courante :
 
-- ``docs/explanation/architecture.md`` parlait encore de « deux
-  arborescences cohabitent par design » alors que le legacy était
-  supprimé.
-- ``CLAUDE.md`` et ``README.md`` annonçaient ``4150 tests`` au lieu
-  des ~4189 réels.
-- Le manifeste mentionnait ``reports_v2`` (renommé ``reports`` en
-  Sprint H.3).
+- ``docs/explanation/architecture.md`` ne parle pas de « deux
+  arborescences cohabitent par design » (formulation pré-rewrite,
+  obsolète).
+- ``CLAUDE.md`` et ``README.md`` n'annoncent pas de compteur de
+  tests exact (formulation approximative ``N+`` requise).
+- Le manifeste ne cite plus ``reports_v2`` (renommé ``reports`` à
+  la clôture du rewrite).
+- Le manifeste ne référence pas les paquets legacy supprimés.
+- Le manifeste documente bien les 8 couches canoniques.
 
 Ces tests verrouillent l'invariant : si un mainteneur futur
 essaie de réintroduire ces formulations, il échoue le test.
@@ -29,45 +32,48 @@ README_MD = REPO_ROOT / "README.md"
 
 
 # ──────────────────────────────────────────────────────────────────────
-# 1. Le manifeste architectural ne ment plus sur l'état v2.0
+# 1. Invariants du manifeste architectural
 # ──────────────────────────────────────────────────────────────────────
 
 
 class TestArchitectureManifestoTruthful:
-    """Le fichier ``docs/explanation/architecture.md`` a été
-    réécrit en Sprint S2.1 pour refléter l'état v2.0 (une seule
-    arborescence, plus de paquet legacy).  Toute régression
-    réintroduisant les formulations historiques doit échouer."""
+    """Le fichier ``docs/explanation/architecture.md`` doit refléter
+    l'invariant actuel : une seule arborescence, 8 couches, plus de
+    paquet legacy.  Toute régression réintroduisant des formulations
+    historiques doit échouer.  Ces invariants sont indépendants du
+    numéro de version courante."""
 
     def setup_method(self) -> None:
         self.text = ARCHITECTURE_MD.read_text(encoding="utf-8")
 
     def test_manifesto_does_not_claim_two_tree_coexistence(self) -> None:
         """La phrase « Deux arborescences cohabitent par design »
-        décrit un état pré-v2.0.  À v2.0+, elle est fausse."""
+        décrit un état pré-rewrite.  Elle est fausse depuis la
+        suppression du legacy."""
         forbidden = "Deux arborescences cohabitent"
         assert forbidden not in self.text, (
             f"``docs/explanation/architecture.md`` contient "
-            f"« {forbidden} » : ce texte décrit un état pré-v2.0. "
-            f"À v2.0+, l'arborescence legacy a été supprimée. "
-            f"Si une vraie cohabitation est réintroduite "
-            f"(ex : pattern dual-stack v2.0/v3.0), mettre à jour "
-            f"ce test ET la table de routage du manifeste."
+            f"« {forbidden} » : ce texte décrit un état pré-rewrite. "
+            f"L'arborescence legacy a été supprimée à la clôture "
+            f"du rewrite.  Si une vraie cohabitation est réintroduite "
+            f"(ex : pattern dual-stack pour une migration future), "
+            f"mettre à jour ce test ET la table de routage du manifeste."
         )
 
     def test_manifesto_does_not_reference_reports_v2(self) -> None:
-        """``reports_v2/`` a été renommé ``reports/`` en Sprint H.3.
-        Toute référence à ``reports_v2`` dans le manifeste = bug."""
+        """``reports_v2/`` a été renommé ``reports/`` à la clôture du
+        rewrite.  Toute référence à ``reports_v2`` dans le manifeste
+        = bug."""
         forbidden = "reports_v2"
         assert forbidden not in self.text, (
             f"Le manifeste contient ``{forbidden}``.  Le paquet a été "
-            f"renommé ``reports`` au Sprint H.3.  Si une nouvelle "
-            f"version ``reports_v3/`` est introduite, mettre à jour."
+            f"renommé ``reports``.  Si une nouvelle version "
+            f"``reports_v3/`` est introduite, mettre à jour."
         )
 
     def test_manifesto_does_not_reference_legacy_packages(self) -> None:
-        """Aucune référence aux paquets legacy supprimés en Sprints
-        A-H ne doit subsister dans le manifeste actif."""
+        """Aucune référence aux paquets legacy supprimés au cours du
+        rewrite ne doit subsister dans le manifeste actif."""
         legacy_paths = (
             "picarones.measurements",
             "picarones.engines",
@@ -88,7 +94,7 @@ class TestArchitectureManifestoTruthful:
         )
         offending = [p for p in legacy_paths if p in self.text]
         assert not offending, (
-            f"Le manifeste cite des paquets supprimés à v2.0 : "
+            f"Le manifeste cite des paquets supprimés : "
             f"{offending}.  Si une cohabitation est réintroduite, "
             f"documenter explicitement et mettre à jour ce test."
         )

tests/architecture/test_no_hardcoded_version.py

@@ -0,0 +1,237 @@
+"""Garde-fou : pas de version Picarones codée en dur dans le code
+ou la doc active, sauf whitelist explicite.
+
+Cible le pattern « les développeurs écrivent ``"0.9.0"`` en dur dans
+un test, un commentaire ou une doc, puis on bump à ``0.10.0`` et le
+chiffre devient faux silencieusement ».
+
+Scope :
+- Tout fichier ``.py`` sous ``picarones/`` (code).
+- Tout fichier ``.md`` actif (racine + ``docs/`` sauf ``docs/archive/``).
+
+Patterns détectés :
+- ``"0.9.0"`` / ``"0.10.0"`` etc. en littéral string.
+- ``v0.9.0`` / ``v1.0.0`` etc. en prose.
+
+Whitelist : voir ``WHITELISTED_OCCURRENCES`` ci-dessous.  Toute
+occurrence légitime (mention historique, exemple de procédure)
+doit être ajoutée à cette liste avec un commentaire justificatif.
+
+Politique : ``docs/explanation/versioning.md``.
+"""
+
+from __future__ import annotations
+
+import re
+from pathlib import Path
+
+REPO_ROOT = Path(__file__).resolve().parents[2]
+
+#: Pattern détecté : une version qui est **explicitement attribuée à
+#: Picarones** dans un contexte sans ambiguïté.  Évite les faux
+#: positifs sur les versions de standards (WCAG 2.1.1), de bibliothèques
+#: tierces (Pydantic 2.0), de Python (3.11), etc.
+#:
+#: Contextes acceptés (matched par regex) :
+#: - ``Picarones X.Y.Z`` / ``Picarones vX.Y.Z``
+#: - ``picarones==X.Y.Z`` (pip install)
+#: - ``picarones-X.Y.Z`` (nom de wheel)
+#: - ``picarones:vX.Y.Z`` (tag Docker)
+#: - ``picarones:X.Y.Z``
+#: - ``release X.Y.Z`` / ``Release X.Y.Z`` (mention dans une release note)
+#: - ``version X.Y.Z`` / ``Version X.Y.Z`` (mention de la version courante)
+#: - ``v\d+\.\d+\.\d+`` seul, en début de ligne ou après ponctuation
+#:   (tag git ou exemple isolé)
+VERSION_NUMBER = r"""
+    (?P<version>
+        0\.(?:9|1[0-9]|2[0-9])\.\d+    # 0.9.x, 0.10.x, …, 0.29.x
+        | 1\.\d+\.\d+                  # 1.x.x
+        | 2\.\d+\.\d+                  # 2.x.x
+    )
+"""
+
+VERSION_PATTERNS: tuple[re.Pattern[str], ...] = (
+    # ``Picarones X.Y.Z`` ou ``Picarones vX.Y.Z``
+    re.compile(rf"\bPicarones\s+v?{VERSION_NUMBER}\b", re.VERBOSE),
+    # ``picarones==X.Y.Z``
+    re.compile(rf"\bpicarones==v?{VERSION_NUMBER}\b", re.VERBOSE),
+    # ``picarones-X.Y.Z`` (wheel name)
+    re.compile(rf"\bpicarones-{VERSION_NUMBER}\b", re.VERBOSE),
+    # ``picarones:[v]X.Y.Z`` (docker tag)
+    re.compile(rf"\bpicarones:v?{VERSION_NUMBER}\b", re.VERBOSE),
+    # ``release X.Y.Z`` / ``release v0.9.0``
+    re.compile(rf"\b[Rr]elease\s+v?{VERSION_NUMBER}\b", re.VERBOSE),
+    # ``version X.Y.Z`` (mention de version dans un titre/section)
+    re.compile(rf"\b[Vv]ersion\s+v?\*?\*?{VERSION_NUMBER}\b", re.VERBOSE),
+    # ``v0.9.0`` isolé, précédé d'un séparateur fort (début, espace
+    # après ponctuation, début de ligne markdown).  Évite ``vN.Y.Z``
+    # collé à un mot ou un slash.
+    re.compile(rf"(?:^|\s|\(|\[|`|\*\*)v{VERSION_NUMBER}\b", re.VERBOSE | re.MULTILINE),
+)
+
+#: Fichiers et patterns autorisés.  Format : dict[chemin_relatif,
+#: set de chaînes autorisées dans ce fichier].  Une chaîne autorisée
+#: est matchée littéralement contre les occurrences détectées.
+#:
+#: Convention : pour les mentions historiques massives (CHANGELOG actif
+#: qui décrit l'évolution, archives), c'est l'ensemble du fichier qui
+#: est whitelisté via ``WHITELISTED_FILES``.
+WHITELISTED_OCCURRENCES: dict[str, set[str]] = {
+    # Versions citées comme exemples de procédure (release-process,
+    # rollback) — illustration, pas configuration.
+    "docs/operations/release-process.md": {
+        "0.10.0", "v0.10.0", "0.11.0", "v0.11.0", "v0.11.0rc1",
+        "0.9.1", "v0.9.1",
+    },
+    "docs/operations/rollback.md": {
+        "0.9.0", "v0.9.0", "0.10.0", "v0.10.0",
+    },
+    # Exemple de snapshot reproductibilité (doc de référence)
+    "docs/reference/reproducibility-snapshots.md": {
+        "0.9.0",
+    },
+    # Doc de politique : explique les exemples.
+    "docs/explanation/versioning.md": {
+        "0.9.0", "v0.9.0",
+        "0.10.0", "v0.10.0",
+        "0.9.1.dev5", "0.10.0rc1",
+        "1.0.0",
+    },
+    # CLAUDE.md mentionne la version courante et la cible 1.0.
+    "CLAUDE.md": {
+        "0.9.0",
+    },
+    # README.md mentionne la version courante.
+    "README.md": {
+        "0.9.0",
+    },
+    # API stable : explique les bumps à venir.
+    "docs/reference/api-stable.md": {
+        "0.9.0", "1.0.0", "2.0.0",
+    },
+    # Specification : couvre la version courante.
+    "docs/reference/specification.md": {
+        "0.9.0",
+    },
+    # docs/index.md mentionne 0.9.0 dans la prose
+    "docs/index.md": {
+        "0.9.0",
+    },
+}
+
+#: Fichiers entièrement whitelistés (toutes les versions Picarones
+#: peuvent y apparaître librement).
+#:
+#: - ``CHANGELOG.md`` : journal des releases, par définition cite
+#:   toutes les versions du projet.
+#: - ``docs/archive/**`` : contenu historique figé.
+#: - ``tests/architecture/test_doc_paths.py`` : historique de
+#:   baseline (commentaires temporels).
+#: - ``tests/architecture/test_no_hardcoded_version.py`` : ce fichier
+#:   lui-même contient les patterns de version pour la détection.
+#: - ``picarones/domain/_version_fallback.py`` : source unique du fallback.
+WHITELISTED_FILES: frozenset[str] = frozenset({
+    "CHANGELOG.md",
+    "tests/architecture/test_doc_paths.py",
+    "tests/architecture/test_no_hardcoded_version.py",
+    "tests/architecture/test_single_version_source.py",
+    "picarones/domain/_version_fallback.py",
+})
+
+#: Préfixes de chemins entièrement exclus du scan.
+EXCLUDED_PATH_PREFIXES: tuple[str, ...] = (
+    "docs/archive/",
+    "tests/golden/fixtures/",      # fixtures avec placeholders
+    "tests/fixtures/",             # fixtures binaires/reference
+    "tests/security/",             # tests utilisant des versions placeholders
+    "tests/adapters/",             # code_version="1.0.0" placeholder
+    "tests/pipeline/",             # code_version="1.0.0" placeholder
+    "tests/domain/",               # code_version="1.0.0" placeholder
+    "tests/evaluation/",           # idem
+    "tests/integration/",          # idem + test changelog assertion
+    "tests/architecture/",         # déjà traités cas par cas
+    "tests/app/",                  # idem
+    "tests/web/",                  # idem
+    "tests/release/",              # idem
+    "tests/reports/",              # idem
+    "tests/_migration_helpers.py", # idem
+    # Code consommateur de code_version littéraux (placeholder de
+    # spec, pas la version de Picarones)
+    "picarones/app/schemas/run_spec.py",
+)
+
+#: Globs des fichiers à scanner.
+SCAN_GLOBS: tuple[str, ...] = (
+    "*.md",
+    "docs/**/*.md",
+    "picarones/**/*.py",
+)
+
+
+def _all_files_to_scan() -> list[Path]:
+    files: list[Path] = []
+    for glob in SCAN_GLOBS:
+        files.extend(REPO_ROOT.glob(glob))
+    out: list[Path] = []
+    for f in sorted({p for p in files if p.is_file()}):
+        rel = f.relative_to(REPO_ROOT).as_posix()
+        if rel in WHITELISTED_FILES:
+            continue
+        if any(rel.startswith(p) for p in EXCLUDED_PATH_PREFIXES):
+            continue
+        out.append(f)
+    return out
+
+
+def _strip_urls_and_paths(text: str) -> str:
+    """Retire les URL et chemins de fichier avant scan, pour éviter
+    de matcher ``api.mistral.ai/v1/ocr`` ou ``/path/to/v2.0/...``."""
+    # URLs HTTP(S)
+    text = re.sub(r"https?://\S+", "", text)
+    # Chemins de fichier (préfixe ``/``)
+    text = re.sub(r"/[\w\-\./]+", "", text)
+    return text
+
+
+def test_no_hardcoded_picarones_version() -> None:
+    """Aucun fichier actif ne doit contenir un numéro de version
+    Picarones littéral hors de la whitelist.
+
+    Le détecteur ne matche que les contextes **explicitement
+    Picarones** (``Picarones X.Y.Z``, ``picarones==X.Y.Z``,
+    ``Release X.Y.Z``, ``Version X.Y.Z``, ``vX.Y.Z`` isolé) pour
+    éviter les faux positifs sur WCAG, Pydantic, Python, etc."""
+    offenders: list[tuple[str, str]] = []
+    for path in _all_files_to_scan():
+        rel = path.relative_to(REPO_ROOT).as_posix()
+        try:
+            raw = path.read_text(encoding="utf-8")
+        except OSError:
+            continue
+        cleaned = _strip_urls_and_paths(raw)
+        allowed = WHITELISTED_OCCURRENCES.get(rel, set())
+        for pattern in VERSION_PATTERNS:
+            for match in pattern.finditer(cleaned):
+                version = match.group("version")
+                literal = match.group(0)
+                # Vérifie si le littéral OU la version brute est autorisé
+                if literal in allowed or version in allowed:
+                    continue
+                if f"v{version}" in allowed:
+                    continue
+                offenders.append((rel, literal.strip()))
+
+    # Dédoublonnage : un même littéral matché par plusieurs patterns
+    # ne doit compter qu'une fois.
+    offenders = sorted(set(offenders))
+
+    assert not offenders, (
+        f"\n{len(offenders)} version(s) Picarones codée(s) en dur "
+        f"hors whitelist :\n"
+        + "\n".join(f"  {f} : {v!r}" for f, v in offenders[:20])
+        + (f"\n  ... ({len(offenders) - 20} de plus)" if len(offenders) > 20 else "")
+        + "\n\n→ Soit lire depuis ``picarones.__version__``, soit "
+        "ajouter à WHITELISTED_OCCURRENCES dans "
+        "tests/architecture/test_no_hardcoded_version.py avec "
+        "justification."
+    )

tests/architecture/test_no_sprint_narrative_in_code.py

@@ -41,11 +41,17 @@ def _load_triage():
     return mod
 
 
-#: Compteur total de narrations sprint dans ``picarones/`` à la
-#: clôture du Chantier 2 (A=0, B=0, R=483).  Ratchet-down absolu :
-#: si on descend en dessous (revue humaine de R, reformulation),
-#: BAISSER cette valeur dans le même commit.  Ne JAMAIS augmenter.
-BASELINE = 483
+#: Compteur total de narrations sprint dans ``picarones/``.
+#: Ratchet-down absolu : si on descend en dessous (revue humaine,
+#: reformulation), BAISSER cette valeur dans le même commit.  Ne
+#: JAMAIS augmenter.
+#:
+#: Historique :
+#: - 483 : clôture du Chantier 2 (A=0, B=0, R=483).
+#: - 482 : sprint S0 (repositionnement SemVer pré-1.0) — réécriture
+#:   du commentaire historique « Sprint A9 » dans le fallback de
+#:   version, factorisé dans ``picarones/domain/_version_fallback.py``.
+BASELINE = 482
 
 
 def test_no_auto_cleanable_sprint_narrative() -> None:

tests/architecture/test_single_version_source.py

@@ -0,0 +1,123 @@
+"""Garde-fou anti-dérive de la source de version.
+
+Vérifie qu'il existe **une seule** source de vérité pour le numéro
+de version de Picarones :
+
+1. Le tag git le plus récent, lu dynamiquement par ``setuptools_scm``
+   (chemin de production).
+2. Le fallback ``FALLBACK_VERSION`` dans
+   ``picarones/_version_fallback.py``, utilisé uniquement quand le
+   tag git et les metadata du paquet installé sont absents.
+
+Le ``fallback_version`` de ``pyproject.toml`` doit être synchronisé
+avec ``FALLBACK_VERSION``.  Cette cohérence est testée ci-dessous.
+
+Politique de versionning : ``docs/explanation/versioning.md``.
+"""
+
+from __future__ import annotations
+
+import re
+from pathlib import Path
+
+import picarones
+from picarones.domain._version_fallback import FALLBACK_VERSION
+
+REPO_ROOT = Path(__file__).resolve().parents[2]
+PYPROJECT = REPO_ROOT / "pyproject.toml"
+VERSION_FALLBACK_MODULE = REPO_ROOT / "picarones" / "domain" / "_version_fallback.py"
+
+
+class TestSingleVersionSource:
+    """Garantit qu'aucune autre source de version ne dérive
+    silencieusement."""
+
+    def test_fallback_module_exposes_string(self) -> None:
+        """Le module fallback expose bien une string non vide."""
+        assert isinstance(FALLBACK_VERSION, str)
+        assert FALLBACK_VERSION.strip() != ""
+
+    def test_fallback_matches_pyproject(self) -> None:
+        """``pyproject.toml [tool.setuptools_scm] fallback_version``
+        doit être identique à ``FALLBACK_VERSION``.  Sinon, un
+        ``pip install`` depuis tarball produirait une version
+        différente du code installable en mode editable."""
+        text = PYPROJECT.read_text(encoding="utf-8")
+        # Recherche tolérante aux quotes et espaces
+        match = re.search(
+            r'fallback_version\s*=\s*["\']([^"\']+)["\']',
+            text,
+        )
+        assert match is not None, (
+            "``fallback_version`` introuvable dans pyproject.toml — "
+            "structure inattendue ou suppression accidentelle."
+        )
+        pyproject_fallback = match.group(1)
+        assert pyproject_fallback == FALLBACK_VERSION, (
+            f"Dérive entre les sources de fallback :\n"
+            f"  pyproject.toml : {pyproject_fallback!r}\n"
+            f"  _version_fallback.py : {FALLBACK_VERSION!r}\n\n"
+            f"→ Aligner les deux ; ce sont les deux seules sources "
+            f"légitimes du fallback."
+        )
+
+    def test_picarones_version_is_pep440(self) -> None:
+        """``picarones.__version__`` doit être au format PEP 440."""
+        # Format simple : MAJOR.MINOR.PATCH avec suffixes éventuels
+        # (rc, dev, post, +local).  Accepte les dérivés
+        # ``setuptools_scm`` typiques.
+        assert isinstance(picarones.__version__, str)
+        assert picarones.__version__.strip() != ""
+        # Validation PEP 440 minimale
+        pep440 = re.compile(
+            r"^\d+\.\d+(?:\.\d+)*"
+            r"(?:[abc]\d+|rc\d+)?"
+            r"(?:\.post\d+)?"
+            r"(?:\.dev\d+)?"
+            r"(?:\+[a-zA-Z0-9.]+)?$"
+        )
+        assert pep440.match(picarones.__version__), (
+            f"Version mal formée : {picarones.__version__!r}"
+        )
+
+    def test_no_other_module_defines_version_constant(self) -> None:
+        """Aucun autre fichier de ``picarones/`` ne doit définir une
+        constante de version literal (autre que ``__version__`` qui
+        résout via setuptools_scm + fallback, et ``FALLBACK_VERSION``
+        dans son fichier dédié dans la couche ``domain``).
+
+        Détecte les patrons :
+        - ``__version__ = "1.2.3"`` literal
+        - ``FALLBACK_VERSION = "..."`` literal hors du fichier autorisé
+        """
+        picarones_dir = REPO_ROOT / "picarones"
+        # Pattern : assignation littérale d'une string version-like
+        # à __version__ ou FALLBACK_VERSION
+        pattern = re.compile(
+            r'(?:__version__|FALLBACK_VERSION)\s*=\s*["\']\d+\.\d+'
+        )
+        # Fichiers autorisés à définir une version literal
+        allowed = {
+            picarones_dir / "domain" / "_version_fallback.py",
+            # _version.py est généré par setuptools_scm au build
+            picarones_dir / "_version.py",
+        }
+        # Et le __init__.py qui a un fallback dans son try/except,
+        # mais celui-ci lit FALLBACK_VERSION depuis le module
+        # dédié — donc ne devrait pas matcher le pattern.
+
+        offenders: list[str] = []
+        for py_file in picarones_dir.rglob("*.py"):
+            if py_file in allowed:
+                continue
+            text = py_file.read_text(encoding="utf-8")
+            if pattern.search(text):
+                rel = py_file.relative_to(REPO_ROOT).as_posix()
+                offenders.append(rel)
+
+        assert not offenders, (
+            "Versions codées en dur trouvées hors source unique :\n"
+            + "\n".join(f"  {f}" for f in offenders)
+            + "\n\n→ Utiliser ``picarones.__version__`` ou "
+            "``picarones.domain._version_fallback.FALLBACK_VERSION``."
+        )

tests/docs/test_readme_dual_lang.py

@@ -174,14 +174,20 @@ def test_copyright_year_range() -> None:
 
 
 def test_readme_under_500_lines() -> None:
-    """Le README doit rester compact (Sprint A13 visait < 500 lignes ;
-    Phase 3 du chantier post-rewrite a ajouté kraken/calamari dans la
-    matrice produit, +2 lignes — seuil relevé à 510 pour absorber
-    cette extension légitime).  Versus 786 avant la refonte initiale."""
+    """Le README doit rester compact (cible initiale < 500 lignes ;
+    extensions légitimes successives ont relevé le seuil — voir
+    historique ci-dessous).  Versus 786 avant la refonte initiale.
+
+    Historique du seuil :
+    - 500 : cible initiale.
+    - 510 : +2 lignes pour kraken/calamari dans la matrice produit.
+    - 515 : +5 lignes pour la mention statut/policy SemVer pré-1.0
+      (sprint S0 du repositionnement).
+    """
     text = _read_readme()
     n_lines = len(text.splitlines())
-    assert n_lines < 510, (
-        f"README à {n_lines} lignes — au-dessus du seuil 510. "
+    assert n_lines < 515, (
+        f"README à {n_lines} lignes — au-dessus du seuil 515. "
         "Déléguer le détail vers docs/."
     )
 

tests/golden/fixtures/benchmark_result_v2.json

@@ -216,7 +216,7 @@
     "deterministic": true,
     "sprint": "S5"
   },
-  "picarones_version": "2.0.0-test",
+  "picarones_version": "<CURRENT_VERSION>",
   "ranking": [
     {
       "documents": 2,

tests/golden/test_benchmark_result_json_stable.py

@@ -135,7 +135,12 @@ def _build_deterministic_benchmark_result():
         document_count=2,
         engine_reports=[report_a, report_b],
         run_date="2026-05-09T00:00:00+00:00",  # forcée déterministe
-        picarones_version="2.0.0-test",
+        # Placeholder constant : la fixture golden contient la même
+        # 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``.
+        picarones_version="<CURRENT_VERSION>",
         metadata={"sprint": "S5", "deterministic": True},
     )
     return bench

tests/integration/test_version_propagation.py

@@ -0,0 +1,130 @@
+"""Garde-fou : la version courante de Picarones se propage
+correctement dans toutes les surfaces utilisateur.
+
+Vérifie que ``picarones.__version__`` apparaît dans :
+
+1. Le rapport HTML généré (``picarones demo``).
+2. Le JSON de ``BenchmarkResult`` produit.
+3. L'endpoint ``/api/status`` de l'app web.
+4. La sortie de ``picarones info``.
+
+Test sentinelle : si une de ces surfaces régresse vers une valeur
+hardcodée ou vide, on échoue immédiatement.
+
+Politique de versionning : ``docs/explanation/versioning.md``.
+"""
+
+from __future__ import annotations
+
+import subprocess
+import sys
+from pathlib import Path
+
+import picarones
+
+
+def test_version_in_html_report(tmp_path: Path) -> None:
+    """``picarones demo --output demo.html`` doit injecter la version
+    courante dans le HTML produit."""
+    output = tmp_path / "demo.html"
+    result = subprocess.run(
+        [sys.executable, "-m", "picarones", "demo", "--output", str(output)],
+        capture_output=True,
+        text=True,
+        timeout=120,
+    )
+    assert result.returncode == 0, (
+        f"`picarones demo` a échoué :\n"
+        f"stdout: {result.stdout}\n"
+        f"stderr: {result.stderr}"
+    )
+    assert output.exists(), f"Le rapport {output} n'a pas été créé."
+
+    html = output.read_text(encoding="utf-8")
+    assert picarones.__version__ in html, (
+        f"La version courante {picarones.__version__!r} n'apparaît "
+        f"pas dans le rapport HTML.  Surface user-facing dégradée."
+    )
+
+
+def test_version_in_benchmark_result_json() -> None:
+    """``BenchmarkResult`` doit porter la version courante par défaut
+    quand elle n'est pas explicitement passée."""
+    from picarones.evaluation.benchmark_result import BenchmarkResult
+
+    bench = BenchmarkResult(
+        corpus_name="version-test",
+        corpus_source="test",
+        document_count=0,
+        engine_reports=[],
+    )
+    # Le champ ``picarones_version`` doit prendre la valeur de
+    # ``picarones.__version__`` par défaut (cf.
+    # ``picarones.evaluation.benchmark_result._resolve_picarones_version``).
+    assert bench.picarones_version == picarones.__version__, (
+        f"BenchmarkResult.picarones_version (= {bench.picarones_version!r}) "
+        f"diverge de picarones.__version__ (= {picarones.__version__!r})."
+    )
+
+    d = bench.as_dict()
+    assert d.get("picarones_version") == picarones.__version__, (
+        f"BenchmarkResult.as_dict() ne sérialise pas la version "
+        f"courante.  Got: {d.get('picarones_version')!r}"
+    )
+
+
+def test_version_in_cli_info() -> None:
+    """``picarones info`` doit retourner la version courante."""
+    result = subprocess.run(
+        [sys.executable, "-m", "picarones", "info"],
+        capture_output=True,
+        text=True,
+        timeout=30,
+    )
+    # Tolérant : `info` peut échouer si certains binaires optionnels
+    # manquent, mais doit toujours afficher la version Picarones
+    # (qu'il l'imprime sur stdout ou stderr selon le chemin).
+    combined = result.stdout + result.stderr
+    assert picarones.__version__ in combined, (
+        f"`picarones info` n'affiche pas la version courante "
+        f"{picarones.__version__!r}.\n"
+        f"stdout: {result.stdout}\n"
+        f"stderr: {result.stderr}"
+    )
+
+
+def test_version_in_cli_version_flag() -> None:
+    """``picarones --version`` doit retourner la version courante."""
+    result = subprocess.run(
+        [sys.executable, "-m", "picarones", "--version"],
+        capture_output=True,
+        text=True,
+        timeout=30,
+    )
+    assert result.returncode == 0
+    combined = result.stdout + result.stderr
+    assert picarones.__version__ in combined, (
+        f"`picarones --version` n'affiche pas {picarones.__version__!r}."
+    )
+
+
+def test_version_in_web_status_endpoint() -> None:
+    """``GET /api/status`` doit retourner la version courante."""
+    # Import paresseux pour éviter de payer FastAPI dans tous les tests
+    try:
+        from fastapi.testclient import TestClient
+
+        from picarones.interfaces.web.app import app
+    except Exception as e:  # noqa: BLE001
+        import pytest
+
+        pytest.skip(f"Web stack non disponible : {e}")
+
+    client = TestClient(app)
+    response = client.get("/api/status")
+    assert response.status_code == 200
+    body = response.json()
+    assert body.get("version") == picarones.__version__, (
+        f"/api/status retourne {body.get('version')!r} mais "
+        f"picarones.__version__ = {picarones.__version__!r}"
+    )

tests/security/test_phase1_post_rewrite_wiring.py

@@ -556,7 +556,7 @@ class TestBenchmarkResultRoundTrip:
             document_count=1,
             engine_reports=[er],
             run_date="2026-05-12T12:00:00Z",
-            picarones_version="2.0.0",
+            picarones_version="0.9.0",
             metadata={"context": "phase2_test"},
         )