v0.3.6-pre.012

This commit is contained in:
2026-09-01 17:42:24 +02:00
parent 9506df9487
commit 42374115c7
18 changed files with 869 additions and 88 deletions

View File

@@ -1,5 +1,5 @@
<!-- file: docs/validation/023-V0_3_6_JOB_API_BACKFILL.md -->
<!-- version: 25 -->
<!-- version: 26 -->
# Validation v0.3.6 — Job API et premier backfill RAW
@@ -71,7 +71,8 @@ Aucune entrée absolue, traversée, avec séparateur inversé ou lien symbolique
- [X] Les documents d'architecture courants sont réconciliés sur `ksp-job-backfill-lib`; les anciens plans historiques restent historiques et ne sont pas réécrits.
- [X] `ksp-job-api` et `ksp-job-backfill-lib` sont obligatoires en parallèle dans la release finale.
- [X] Worker API, application et pipeline RAW partagé sont explicitement hors v0.3.6.
- [ ] Architecture, README, roadmap et contrats finaux réconciliés avant publication.
- [X] Architecture, README, index et contrats de crate durables réconciliés sur la surface finale prouvée.
- [ ] ROADMAP et CHANGELOG synchronisés uniquement dans la lane de publication `pre.013`.
## 5. Contrat `ksp-job-api`
@@ -261,20 +262,34 @@ Les arbres Cargo sont rejoués ici au titre de la clôture technique finale, mê
Le smoke PostgreSQL reste conditionnel à une URI dédiée explicitement disponible. En l'absence d'environnement live fourni, il reste non exécuté et non bloquant ; aucune réussite live n'est inventée.
**Statut : matérialisé ; gate opérateur final à exécuter.**
**Statut : alisé ; gate opérateur final intégralement vert.**
## 16. Preuves d'intégration et fermeture
Preuve opérateur : `cargo fmt --all -- --check`, audits Rust/Markdown, `cargo check --workspace`, Clippy workspace/all-targets/all-features avec `-D warnings`, puis `cargo test --workspace --all-targets --all-features` passent. Le run agrège `1_404` tests passés, `0` échec et `15` tests ignorés explicitement opt-in/operator-only. Les graphes normal/features de `ksp-job-api` et `ksp-job-backfill-lib` sont cohérents ; `cargo tree --duplicates` a été exécuté et revu. Aucun smoke PostgreSQL dédié n'est revendiqué sans URI explicitement fournie.
## 16. Réconciliation documentaire finale `pre.012`
- [X] README racine réconcilié sans historique de prerelease.
- [X] `ksp-job-api/README.md` et `USAGE.md` décrivent la façade runtime-neutral, le lifecycle, l'annulation et le contrat latest-value.
- [X] `ksp-job-backfill-lib/README.md` et `USAGE.md` décrivent scopes, request bounds, runtime, provenance, Store, checkpoint, annulation et reprise sans note de version.
- [X] Architectures Layers, Contracts, Inventory, Dependency Graph, Acquisition/Jobs et Apps/Control réconciliées sur le premier job concret.
- [X] Index `docs/`, plans et validations synchronisés jusqu'aux documents `027` / `023`.
- [X] Les documents durables distinguent checkpoint caller-owned et garantie de reprise crash-safe ; aucune persistence automatique du checkpoint n'est promise.
- [X] CHANGELOG, ROADMAP et prompt suivant restent hors de cette tranche.
**Statut : matérialisé ; gate documentaire à exécuter.**
## 17. Preuves d'intégration et fermeture
- [X] Fake Transport et fake Store déterministes sans backend direct exécutés avec succès au gate `pre.007`; fake processor concurrent `pre.008-fix.001` exécuté avec succès.
- [ ] Vertical découverte, hydratation, conversion, persistance et observation couvert.
- [ ] Smoke Devnet plus PostgreSQL configuré exécuté si l'environnement explicite est disponible.
- [ ] Aucun endpoint payant, credential ou donnée sensible requis par les tests normaux.
- [ ] Gates technique, documentaire et de publication séparés.
- [ ] CHANGELOG et ROADMAP alignés seulement après preuve technique.
- [ ] Archives de release minimales et vérifiées.
- [X] Vertical découverte, hydratation, conversion, persistance, observation, concurrence, checkpoint et runtime couvert par les gates déterministes.
- [ ] Smoke Devnet plus PostgreSQL configuré exécuté si l'environnement explicite est disponible ; non bloquant sans environnement fourni.
- [X] Aucun endpoint payant, credential ou donnée sensible requis par les tests normaux.
- [X] Gates technique, documentaire et de publication séparés.
- [ ] CHANGELOG et ROADMAP alignés seulement après preuve technique, dans `pre.013`.
- [X] Archives de prerelease minimales et vérifiées jusqu'au gate technique final.
- [ ] Version stable publiée uniquement après tous les critères obligatoires.
## 17. Règle de vérité
## 18. Règle de vérité
Une case n'est cochée que par une preuve effectivement exécutée ou un audit effectivement réalisé. L'absence de `cargo`, de PostgreSQL configuré ou d'accès live est rapportée comme non exécutée ; elle n'est jamais convertie en succès implicite.