195 lines
7.0 KiB
Markdown
195 lines
7.0 KiB
Markdown
<!-- file: deltas/0.3.14/pre.015.md -->
|
|
<!-- version: 1 -->
|
|
|
|
# Delta `0.3.14-pre.015` — réconciliation documentaire
|
|
|
|
## 1. Base requise
|
|
|
|
```text
|
|
0.3.14-pre.014
|
|
workspace.package.version = 0.3.14-pre.14
|
|
```
|
|
|
|
Le gate opérateur communiqué le **12 septembre 2026** sur `pre.014` est vert pour toutes les commandes déterministes exécutées. Le workspace complet totalise `1931` tests passés, `0` échec et `15` ignored ; les deux smokes keyless HTTP/WebSocket Devnet passent chacun `1/1` lorsqu'ils sont exécutés explicitement avec `--ignored`.
|
|
|
|
## 2. Objectif
|
|
|
|
`pre.015` réconcilie la documentation durable avec l'état réellement livré par `0.3.14`.
|
|
|
|
Cette tranche ne change aucun comportement runtime. Elle corrige notamment les descriptions héritées de `0.3.13` qui affirmaient encore qu'une perte de source ou un gap de rétention provoquait systématiquement un fault immédiat, alors que `0.3.14` autorise désormais une continuation uniquement sous preuves de réconciliation passée et de `TargetCoverage` futur.
|
|
|
|
Conformément au forecast, `CHANGELOG.md`, `ROADMAP.md` et le prompt de la version suivante restent hors de cette tranche et sont réservés à `pre.016`.
|
|
|
|
## 3. Version workspace
|
|
|
|
Cette prerelease non-fix synchronise Cargo conformément à `VER-ID-009` :
|
|
|
|
```text
|
|
0.3.14-pre.14
|
|
->
|
|
0.3.14-pre.15
|
|
```
|
|
|
|
Le header racine de `Cargo.toml` passe de `590` à `591`.
|
|
|
|
## 4. Documentation Worker réconciliée
|
|
|
|
`crates/ksp-worker-raw-transaction-ingest-lib/README.md` et `USAGE.md` documentent désormais l'état `0.3.14` :
|
|
|
|
```text
|
|
processing frontier != continuity frontier
|
|
gaps run-local inclusifs et bornés
|
|
TargetCoverage conservative
|
|
replay Transport != coverage d'intervalle
|
|
coverage redondante uniquement par preuve structurale
|
|
scan HTTP / block fetch / transaction hydration bornés
|
|
source-loss continuation uniquement après réconciliation complète
|
|
health gap-aware et future-coverage-aware
|
|
fairness nominal/repair sur les mêmes ressources
|
|
snapshots publics gap/repair source-neutral
|
|
aucun Worker -> Job Backfill
|
|
aucun checkpoint ou historique caller-paramétrable
|
|
```
|
|
|
|
Les bornes documentées restent :
|
|
|
|
```text
|
|
open gaps <= 64
|
|
range <= 4096 slots
|
|
discovery HTTP <= 512 slots par fenêtre
|
|
getBlock logiques concurrents <= 4
|
|
repair actif simultané <= 1
|
|
```
|
|
|
|
## 5. Architectures réconciliées
|
|
|
|
Les documents réellement affectés sont alignés :
|
|
|
|
```text
|
|
docs/architecture/004-COMPONENT_INVENTORY.md
|
|
Worker RAW étendu jusqu'à 0.3.14
|
|
|
|
docs/architecture/005-DEPENDENCY_GRAPH.md
|
|
dépendances inchangées ; continuité/coverage/repair final documenté
|
|
|
|
docs/architecture/009-ACQUISITION_WORKERS_AND_JOBS.md
|
|
cinq familles live + séparation Worker/Backfill conservée
|
|
source-loss non terminale uniquement sous preuves explicites
|
|
|
|
docs/architecture/011-RAW_TRANSACTION_ACQUISITION.md
|
|
état Worker après 0.3.14
|
|
réconciliation run-local et reports actualisés
|
|
```
|
|
|
|
Aucune nouvelle dépendance d'architecture n'est introduite.
|
|
|
|
## 6. Plans et validation réconciliés
|
|
|
|
`docs/plans/002-FUNCTIONAL_RELEASE_SEQUENCE.md` remplace le placeholder `0.3.14` par son rôle réellement livré : gap repair / continuité run-local multi-source + observabilité/hardening.
|
|
|
|
`docs/plans/035-V0_3_14_MULTI_SOURCE_GAP_REPAIR_HARDENING_PLAN.md` enregistre le forecast effectivement exécuté de `pre.001` à `pre.015`, les bornes finales et l'absence d'expansion EARLY/provider/historique.
|
|
|
|
`docs/validation/031-V0_3_14_MULTI_SOURCE_GAP_REPAIR_HARDENING.md` enregistre le gate final `pre.014` et les smokes keyless réellement exécutés.
|
|
|
|
## 7. Gate opérateur `pre.014` enregistré
|
|
|
|
```text
|
|
cargo fmt --all : PASS
|
|
cargo fmt --all -- --check : PASS
|
|
General Rust rule audit : clean
|
|
Rust export completeness audit : 0 candidate(s)
|
|
KSP workspace Rust rule audit : clean
|
|
Markdown table audit : clean (340 tables / 882 files)
|
|
cargo check --workspace : PASS
|
|
cargo clippy --workspace --all-targets --all-features -- -D warnings : PASS
|
|
cargo test --workspace --all-targets --all-features : PASS
|
|
workspace tests : 1931 passed / 0 failed / 15 ignored
|
|
cargo tree -p ksp-worker-raw-transaction-ingest-lib --edges normal : exécuté
|
|
cargo tree -p ksp-worker-raw-transaction-ingest-lib -e features : exécuté
|
|
cargo tree --duplicates : exécuté
|
|
HTTP Devnet smoke explicite : 1 passed / 0 failed
|
|
WebSocket Devnet smoke explicite : 1 passed / 0 failed
|
|
```
|
|
|
|
Les smokes OrbitFlare/PublicNode Yellowstone, Helius transactionSubscribe, PostgreSQL live et Worker repair -> Store live restent explicitement `NON EXÉCUTÉ` sans environnement/credential provisionné.
|
|
|
|
## 8. Fichiers ajoutés
|
|
|
|
```text
|
|
deltas/0.3.14/pre.015.md
|
|
```
|
|
|
|
## 9. Fichiers modifiés
|
|
|
|
```text
|
|
Cargo.toml
|
|
crates/ksp-worker-raw-transaction-ingest-lib/README.md
|
|
crates/ksp-worker-raw-transaction-ingest-lib/USAGE.md
|
|
docs/architecture/004-COMPONENT_INVENTORY.md
|
|
docs/architecture/005-DEPENDENCY_GRAPH.md
|
|
docs/architecture/009-ACQUISITION_WORKERS_AND_JOBS.md
|
|
docs/architecture/011-RAW_TRANSACTION_ACQUISITION.md
|
|
docs/plans/002-FUNCTIONAL_RELEASE_SEQUENCE.md
|
|
docs/plans/035-V0_3_14_MULTI_SOURCE_GAP_REPAIR_HARDENING_PLAN.md
|
|
docs/validation/031-V0_3_14_MULTI_SOURCE_GAP_REPAIR_HARDENING.md
|
|
```
|
|
|
|
## 10. Fichiers supprimés
|
|
|
|
```text
|
|
aucun
|
|
```
|
|
|
|
## 11. Surfaces explicitement inchangées
|
|
|
|
```text
|
|
CHANGELOG.md
|
|
ROADMAP.md
|
|
README.md racine
|
|
RULES.md
|
|
prompts/**
|
|
config/**
|
|
crates/**/src/**
|
|
crates/**/tests/**
|
|
crates/**/unit_tests/**
|
|
Cargo.toml de crates
|
|
features/dépendances
|
|
schemas/migrations
|
|
```
|
|
|
|
Aucun delta publié antérieur n'est modifié.
|
|
|
|
## 12. Validations exécutées localement
|
|
|
|
Sur l'état exact `pre.015` avant packaging :
|
|
|
|
```text
|
|
General Rust rule audit : clean
|
|
Rust export completeness audit : 0 candidate(s)
|
|
KSP workspace Rust rule audit : clean
|
|
Markdown table audit : clean (340 tables / 883 files)
|
|
diff pre.014 -> pre.015 : 1 ajout / 10 modifications / 0 suppression
|
|
Cargo.toml : hors header, seule workspace.package.version change
|
|
CHANGELOG.md : byte-identique à pre.014
|
|
ROADMAP.md : byte-identique à pre.014
|
|
prompts/** : byte-identiques à pre.014
|
|
aucun fichier Rust/test/config/schema/migration/manifest de crate modifié
|
|
```
|
|
|
|
Le toolchain Cargo/Rustfmt n'est pas disponible dans l'environnement d'assemblage ; aucun nouveau PASS Cargo post-bump n'est revendiqué localement.
|
|
|
|
Le gate opérateur `pre.014` reste la preuve technique précédente ; un gate minimal `pre.015` est demandé après application pour confirmer le bump/documentation exacts.
|
|
|
|
## 13. Décisions prises
|
|
|
|
- `0.3.14` est techniquement fermé par le gate `pre.014` et documentairement réconcilié par `pre.015` ;
|
|
- les cinq familles live restent inchangées ; `0.3.14` durcit leur continuité dans le run actif ;
|
|
- reconnect, replay natif et retries réseau restent Transport-owned ;
|
|
- le Worker ne lance jamais de Job Backfill et ne reçoit aucune campagne historique caller-paramétrable ;
|
|
- une source perdue ne peut rester absente que sous réconciliation passée complète et coverage future prouvée ;
|
|
- les détails de `0.3.15`, le prochain prompt, CHANGELOG et ROADMAP sont différés à `pre.016`.
|
|
|
|
## 14. Questions ouvertes
|
|
|
|
Aucune question ouverte bloquante pour `pre.015`.
|