Files
khadhroony-solana-project/deltas/0.3.5/pre.007.md
2026-08-31 13:07:56 +02:00

4.4 KiB

Delta 0.3.5-pre.007

Objet

Réconcilier la documentation durable avec la surface Interface réellement acquise après le gate technique final propre de pre.006, sans rouvrir le code ni les contrats publics.

Base

0.3.5-pre.006
workspace.package.version = 0.3.5-pre.6

La base opérateur inclut les corrections locales de numéros d'en-tête signalées après l'overlay pre.006 :

Cargo.toml                                           header 389
docs/validation/022-V0_3_5_INTERFACE_ACQUISITION_EVENTS.md header 8

Ces corrections d'en-tête ne changent pas le contenu fonctionnel du gate validé.

Gate d'entrée

Le gate pre.006 est intégralement propre :

General Rust rule audit: clean
Rust export completeness audit: 0 candidate(s)
KSP workspace Rust rule audit: clean
Markdown table audit: clean (240 table(s), 145 file(s))
cargo check --workspace: PASS
cargo clippy --workspace --all-targets: PASS
cargo test -p ksp-interface-lib: PASS
cargo test --workspace: PASS

Les graphes confirment :

ksp-interface-lib -> ksp-core-lib uniquement
aucune feature Interface
aucune dev/build dependency Interface
aucun duplicate dependency nouveau imputable à 0.3.5

Les tests live/réseau et probes diagnostiques restent ignored conformément à leur contrat.

Réconciliation

La documentation durable était encore partiellement figée sur la foundation Program-only :

README Interface -> rôle Program-only et affirmation « aucun événement runtime »
USAGE Interface  -> page explicitement matérialisée par 0.2.13
architecture     -> rôle Interface décrit surtout comme façade wire Program
TransactionLogEvent -> idée différée encore enfermée dans le plan/validation de release

pre.007 corrige ces incohérences sans transformer Interface en runtime :

Program wire contracts                  -> Interface
provider-neutral passive acquisition    -> Interface lorsque convergence exacte démontrée
rich HTTP/WS/gRPC/provider DTOs          -> Transport
persistent/replayable RAW               -> Store API
post-commit durable-data wake-up         -> Store API
converters Transport -> Interface        -> composition/consumer
backlog/recovery                         -> Store

La surface durable documentée contient exactement les deux familles acquisition acquises :

SlotLifecycleEvent
TransactionExecutionEvent

TransactionLogEvent est transféré dans docs/IDEAS.md et reste soumis à un futur gate consumer + bornes + convergence multi-source.

Version

workspace.package.version = 0.3.5-pre.7

Fichiers

Modifiés :

Cargo.toml
crates/ksp-interface-lib/README.md
crates/ksp-interface-lib/USAGE.md
docs/IDEAS.md
docs/architecture/002-LAYERS_AND_DEPENDENCIES.md
docs/architecture/003-COMPONENT_CONTRACTS.md
docs/architecture/004-COMPONENT_INVENTORY.md
docs/architecture/005-DEPENDENCY_GRAPH.md
docs/architecture/006-WIRE_AND_PROGRAM.md
docs/architecture/009-ACQUISITION_WORKERS_AND_JOBS.md
docs/plans/026-V0_3_5_INTERFACE_ACQUISITION_EVENTS_PLAN.md
docs/validation/022-V0_3_5_INTERFACE_ACQUISITION_EVENTS.md

Ajouté :

deltas/0.3.5/pre.007.md

Explicitement inchangés :

CHANGELOG.md
ROADMAP.md
prompts/**
crates/ksp-interface-lib/src/**
crates/ksp-interface-lib/tests/**
crates/ksp-interface-lib/unit_tests/**
crates/ksp-interface-lib/Cargo.toml
crates/ksp-onchain-transport-lib/**
crates/ksp-store-api/**
crates/ksp-store-lib/**
crates/ksp-store-postgres-lib/**
crates/ksp-program-api/**

Gate d'assemblage

Les contrôles statiques disponibles dans l'environnement d'assemblage sont propres :

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

Aucun code Rust n'est modifié par cette tranche. Les commandes Cargo restent à confirmer dans le repository opérateur après application de l'overlay.

Gate demandé

cargo fmt --all
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/0.3.5
cargo check --workspace
cargo clippy --workspace --all-targets
cargo test -p ksp-interface-lib
cargo test -p ksp-program-api

Aucun smoke réseau n'est requis. Après gate propre, la tranche suivante est la préparation de publication minimale 0.3.5-pre.008.