Files
khadhroony-solana-project/deltas/0.3.15/pre.001.md
2026-09-13 00:27:37 +02:00

179 lines
5.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!-- file: deltas/0.3.15/pre.001.md -->
<!-- version: 2 -->
# Delta `0.3.15-pre.001` — audit / route model / sizing Raw Transaction Ingest Desk
## Base requise
```text
v0.3.14
workspace.package.version = 0.3.14
deltas/0.3.14/rel.001.md présent
```
Archive opérateur auditée :
```text
khadhroony-solana-project-v0.3.14.zip
SHA-256 897bd30b0d06c00abc120a7459250b78c11629e84825ac29adbe151d60a668ed
```
L'archive ne contient pas `.git`; l'identité interne stable est contrôlée mais l'objet du tag Git ne peut pas être comparé localement.
## Objet
Exécuter le gate `pre.001` imposé par `prompts/034-V0_3_15_START_PROMPT.md` avant tout scaffold lourd :
```text
lecture complète des règles et du handoff 0.3.14
audit archive/base stable
audit Config/Transport/Store/Worker
audit des cinq familles Worker et de leurs constructeurs
audit des Desk KSP actuelles
external re-audit Solana/Yellowstone/Helius/PublicNode/OrbitFlare pertinent
matrice route/capability/config/resource
classification des gaps
screen map / states / Start-Stop / snapshots
matrice IPC et tracing
sizing et forecast recalibré
plan 036 + validation 032
```
Aucune crate Desk, commande Tauri Start/Stop, extension Transport/Config/Worker ou logique d'acquisition n'est implémentée dans cette tranche.
## Décisions
```text
cinq routes V1 retenues : Yellowstone hydrated, Standard Logs hydrated, Standard Block direct, Helius transaction hydrated, HTTP Block Polling
route != source != endpoint
provider name != capability
catalogue route V1 app-owned
réseau dérivé d'un composite/profil app cohérent Transport+Store
1 route = 1 Worker indépendant
plusieurs Workers peuvent partager le même Arc<Store> si réseau identique
aucun partage de gaps/TargetCoverage entre Workers
composabilité calculée sans I/O réseau ; opérabilité validée au Start
Transport conserve le choix physique endpoint selon rôles/priorités
HTTP request_kinds existants suffisent à prouver les requirements HTTP
WS protocol kind seul ne suffit pas à prouver une subscription exacte
capability WS typed explicite nécessaire dans Transport puis Config
Worker devra enforce la capability WS requise avant I/O
Helius standard WS != Helius transactionSubscribe
Helius ne gagne jamais blockSubscribe par son provider name
Store et lifecycle/snapshots Worker ne nécessitent pas de nouveau contrat essentiel
aucune nouvelle crate intermédiaire
aucun bump de dépendance
release 0.3.15 maintenue ; forecast étendu jusqu'à pre.016
```
## Fichiers ajoutés
```text
docs/plans/036-V0_3_15_RAW_TRANSACTION_INGEST_DESK_PLAN.md
docs/validation/032-V0_3_15_RAW_TRANSACTION_INGEST_DESK.md
deltas/0.3.15/pre.001.md
```
## Fichiers modifiés
```text
Cargo.toml
```
## Fichiers supprimés
```text
aucun
```
## Version Cargo
```text
header : 593 -> 594
workspace.package.version : 0.3.14 -> 0.3.15-pre.1
```
Aucune dépendance, feature ou autre ligne fonctionnelle du manifest racine n'est modifiée.
## Surfaces explicitement inchangées
```text
crates/**
config/**
README.md
RULES.md
ROADMAP.md
CHANGELOG.md
prompts/**
deltas/0.3.14/**
```
## Validations base exécutées
```text
unzip -t : PASS
archive safety : PASS
workspace/crate inventory : 21/21
General Rust rule audit : clean
Rust export completeness audit : 0 candidate(s)
KSP workspace Rust rule audit : clean
Markdown table audit : clean (340 tables / 886 files)
rule definitions : 489 / 489 uniques / 0 doublon
```
Le journal opérateur fourni qualifie séparément la stable `0.3.14` avec fmt/check/clippy/tests/tree. Cette preuve n'est pas revendiquée comme gate post-bump.
## Validations post-modification
Exécuté localement :
```text
General Rust rule audit : clean
Rust export completeness audit : 0 candidate(s)
KSP workspace Rust rule audit : clean
Markdown table audit : clean (354 tables / 889 files)
rule definitions : 489 / 489 uniques / 0 doublon
stable -> worktree : 3 ajouts / 1 modification / 0 suppression
```
Non exécuté localement :
```text
cargo fmt/check : NON EXÉCUTÉ — cargo absent du sandbox
cargo check --workspace : NON EXÉCUTÉ — cargo absent du sandbox
cargo clippy : NON EXÉCUTÉ — cargo absent du sandbox
cargo test : NON EXÉCUTÉ — cargo absent du sandbox
```
Ces commandes restent à exécuter par lopérateur après application du delta ; aucun faux PASS Cargo nest revendiqué.
## Archive d'échange
Livraison attendue selon `VER-ARCHIVE-004` :
```text
ksp-general-0.3.15-pre.001.zip
```
Contenu exact attendu :
```text
Cargo.toml
docs/plans/036-V0_3_15_RAW_TRANSACTION_INGEST_DESK_PLAN.md
docs/validation/032-V0_3_15_RAW_TRANSACTION_INGEST_DESK.md
deltas/0.3.15/pre.001.md
```
Aucun fichier stable inchangé, secret, cache, lockfile, sortie de build ou artefact d'audit n'est inclus.
## Gate opérateur après application
```bash
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/0.3.15
cargo check --workspace
```
Après gate propre, `pre.002` commence par la capability WS typed Transport prévue par le plan `036`, et non par le scaffold UI.