khadhroony-solana-project/deltas/0.3.16/pre.009.md

Delta 0.3.16-pre.009 — réconciliation documentaire finale

Base requise

0.3.16-pre.008-fix.001 appliqué
workspace.package.version = 0.3.16-pre.8.fix.1

Le gate opérateur de pre.008-fix.001 est entièrement propre : format, audits Rust/Markdown, cargo check --workspace, Clippy workspace/all-targets/all-features avec -D warnings, Store API, Store façade, PostgreSQL, Job Backfill et Worker passent. Le live proof postgres_raw_transaction_live a également été exécuté séparément avec succès sur PostgreSQL 17.

Objectif

pre.009 est exclusivement la lane de réconciliation documentaire finale de 0.3.16.

Elle aligne les références durables sur l'état réellement implémenté et validé :

V003 multi-variantes
selector canonique + promotion atomique
comparateur partagé fail-closed
conflict case minimal durable
QuarantinedConflict non terminal côté Worker
projection Conflict côté Backfill
hardening concurrence / rollback / PostgreSQL live

Aucun code runtime, test fonctionnel, migration, configuration, CHANGELOG.md, ROADMAP.md ou prompt de démarrage suivant n'est modifié.

Version

workspace.package.version = 0.3.16-pre.9

Plan et validation

Le plan 038 est réconcilié avec les gates réellement observés :

• pre.005 à pre.008-fix.001 sont décrits avec leur état livré/validé ;
• pre.008 enregistre le live PostgreSQL 17 comme PASS ;
• 0.3.16 ne revendique ni résolution complète, ni retry Store, ni reconnect configurable, ni Store Desk ;
• les lanes de fermeture 0.3.17 et 0.3.18 sont séparées conformément aux règles actuelles entre gate technique, réconciliation documentaire et préparation de publication.

La validation 033 ajoute la matrice finale 0.3.16, le gate opérateur complet de pre.008-fix.001, la preuve PostgreSQL réelle, les scopes explicitement reportés et l'état de fermeture avant pre.010.

Références d'architecture

Les références durables sont réalignées sur le découpage courant :

0.3.16  fondations RAW multi-variantes + conflit durable minimal + Worker non terminal
0.3.17  lifecycle/résolution/rétention variantes + résilience Store/Transport
0.3.18  Store Desk variantes/conflits/résolutions
0.3.19  cible Backfill multi-route/multi-stratégie
0.3.20  cible Backfill Desk multi-route

Le handoff historique 037 reste inchangé ; il est explicitement présenté comme historique et supersédé pour le sizing par le plan 038.

Documentation Store

ksp-store-lib et ksp-store-postgres-lib documentent désormais :

• les 14 capabilities RAW réellement implémentées, dont les quatre inspections ;
• V003 et ses quatre tables ;
• les outcomes de variantes ;
• QuarantinedConflict comme succès durable ;
• la promotion atomique CompatibleMoreComplete ;
• le mapping observation -> variante réellement reçue ;
• la conservation du canonique sur conflit/incomparable ;
• la portée volontairement minimale du conflict case 0.3.16.

Documentation Worker / Backfill

Le Worker documente comme contrat stable 0.3.16 que la sérialisation run-local ne décide plus du contenu et que toute acquisition atteint le Store ; QuarantinedConflict laisse le Worker Running/Degraded et n'empêche pas l'identité suivante.

Le Job Backfill documente la projection QuarantinedConflict -> Conflict tout en conservant l'outcome réel de l'observation. Les deux références Backfill utilisent désormais la terminologie STRUCTURAL au lieu de l'ancien nom de couche CORE.

Fichiers modifiés

Cargo.toml
docs/000-README.md
docs/architecture/004-COMPONENT_INVENTORY.md
docs/architecture/009-ACQUISITION_WORKERS_AND_JOBS.md
docs/architecture/011-RAW_TRANSACTION_ACQUISITION.md
docs/plans/038-V0_3_16_RAW_RESILIENCE_CONFLICT_PLAN.md
docs/validation/033-V0_3_16_RAW_RESILIENCE_CONFLICT.md
crates/ksp-store-lib/README.md
crates/ksp-store-lib/USAGE.md
crates/ksp-store-postgres-lib/README.md
crates/ksp-store-postgres-lib/USAGE.md
crates/ksp-worker-raw-transaction-ingest-lib/README.md
crates/ksp-worker-raw-transaction-ingest-lib/USAGE.md
crates/ksp-job-backfill-lib/README.md
crates/ksp-job-backfill-lib/USAGE.md

Fichier ajouté

deltas/0.3.16/pre.009.md

Fichiers supprimés

aucun

Validation opérateur de la base

Le gate pre.008-fix.001 fourni par l'opérateur est entièrement vert. Les résultats détaillés sont désormais consignés dans docs/validation/033-V0_3_16_RAW_RESILIENCE_CONFLICT.md.

Le live PostgreSQL séparé a produit :

server major 17
1 passed; 0 failed

Validations de génération

Exécutées dans l'environnement de génération :

python3 scripts/audit_rust_workspace_rules.py
python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas

Résultats :

General Rust rule audit: clean
Rust export completeness audit: 0 candidate(s)
KSP workspace Rust rule audit: clean
Markdown table audit: clean (352 table(s), 959 file(s))

Le toolchain Rust n'est pas installé dans l'environnement de génération. Le changement de version Cargo impose donc au gate opérateur de rejouer format/check/Clippy/tests, même si cette tranche ne modifie aucun source Rust.

Gate opérateur demandé

cargo fmt --all
cargo fmt --all -- --check

python3 scripts/audit_rust_workspace_rules.py
python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas

cargo check --workspace
cargo clippy --workspace --all-targets --all-features -- -D warnings

cargo test -p ksp-store-api --all-targets --all-features
cargo test -p ksp-store-lib --all-targets --all-features
cargo test -p ksp-store-postgres-lib --all-targets --all-features
cargo test -p ksp-job-backfill-lib --all-targets --all-features
cargo test -p ksp-worker-raw-transaction-ingest-lib --all-targets --all-features

Aucun live PostgreSQL supplémentaire n'est requis par pre.009, car cette tranche ne modifie aucun test/runtime et le live pre.008 a déjà été exécuté avec succès.

Décisions prises

• la documentation finale de 0.3.16 décrit uniquement les capacités effectivement livrées ;
• 0.3.17 et 0.3.18 conservent explicitement les responsabilités non implémentées ;
• les extensions Backfill restent reportées par défaut à 0.3.19/0.3.20 ;
• le handoff historique n'est pas réécrit ;
• CHANGELOG.md, ROADMAP.md et le prompt 0.3.17 restent réservés à pre.010.

Questions ouvertes

Aucune question documentaire bloquante pour 0.3.16.

Suite

Après gate propre : 0.3.16-pre.010, préparation de publication minimale uniquement (CHANGELOG.md, ROADMAP.md, prompt de démarrage 0.3.17, version et delta).