Sasedev/khadhroony-solana-project
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

v0.3.9-pre.001-fix.001

Browse Source
This commit is contained in:
SinuS von SifriduS
2026-09-04 13:16:08 +02:00
parent 92f08ca5a8
commit b87b7f4505
4 changed files with 164 additions and 16 deletions
Download Patch File Download Diff File Expand all files Collapse all files

81
docs/plans/030-V0_3_9_WORKER_API_RAW_TRANSACTION_AUDIT_PLAN.md
View File

@@ -1,5 +1,5 @@
<!-- file: docs/plans/030-V0_3_9_WORKER_API_RAW_TRANSACTION_AUDIT_PLAN.md -->
<!-- version: 1 -->
<!-- version: 2 -->
# Plan v0.3.9 — Worker API générique + audit RAW Transaction
@@ -522,18 +522,73 @@ kbot3 ne sera alors utilisé que pour inventorier des comportements historiques.
Le `pre.004` unique imaginé par le prompt est scindé en trois tranches d’audit/synthèse : un audit Solana/KSP, un audit provider/kbot3, puis une synthèse. Un audit externe exhaustif Solana + Helius + Yellowstone + providers + KSP + mainnet naming dans une seule tranche dépasserait vraisemblablement le budget normatif de 15-20 minutes.
| Tranche | Objet | Budget de planification | Sortie |
|---------|-----------------------------------------------------------------|-------------------------|--------------------------------------------------------|
| pre.001 | audit, architecture, threat map, plan/tests | 15-20 min | présente livraison doc-only |
| pre.002 | crate + contrats Worker API décidés | 15-20 min | noyau + tests unit/public/dependency |
| pre.003 | hardening, races, object-safety, impl externe, freeze | 15-20 min | Worker API fonctionnellement fermée |
| pre.004 | audit RAW A : Solana standard + KSP Transport/Store/Config | 15-20 min | capabilities/roles/gaps internes |
| pre.005 | audit RAW B : Helius, Yellowstone/providers + kbot3 fonctionnel | 15-20 min | preuves primaires, quotas/replay/disponibilité |
| pre.006 | synthèse RAW multi-source + handoff 0.3.10/0.3.12 | 15-20 min | matrice finale, combinaisons, gaps et stratégie réseau |
| pre.007 | gate technique final | 10-15 min | workspace/worker-api/trees/duplicates verts |
| pre.008 | réconciliation documentaire finale | 10-15 min | README/USAGE/plan/validation/architecture cohérents |
| pre.009 | préparation de publication | 5-10 min | prompt 0.3.10 + CHANGELOG + ROADMAP + Cargo + delta |
| rel.001 | publication mécanique stable | 5-10 min | v0.3.9 sans rattrapage |
Le forecast reste volontairement souple. Une tranche peut être scindée, fusionnée ou réordonnée par delta si la réalité technique l’exige, à condition de préserver les responsabilités de clôture. Chaque prerelease possède une sous-section directement éditable ; lorsqu’un correctif est nécessaire, il est ajouté sous la prerelease concernée avec un titre `#### pre.NNN-fix.MMM`.
### `pre.001` — audit, architecture, threat map et plan/tests
**Statut : réalisé.**
Budget cible : **15-20 min**. Vérification des archives et règles, audit architectural de référence, décisions Worker API, threat map, plan de tests et sizing. Sortie : présente livraison documentaire uniquement ; aucune crate Worker ni implémentation RAW n’est ouverte dans cette tranche.
#### `pre.001-fix.001` — forecast souple éditable et hiérarchie des fixes
**Statut : réalisé ; correctif documentaire uniquement.**
Remplacement du sizing tabulaire de la section 17 par des sous-sections `### pre.NNN` et `### rel.NNN`, avec insertion des correctifs sous leur tranche via `#### pre.NNN-fix.MMM`. Le découpage technique, les budgets, les sorties attendues et l’ordre des responsabilités restent inchangés. Conformément aux règles documentaires, ce correctif ne modifie pas `workspace.package.version`, qui reste `0.3.8`.
### `pre.002` — crate + contrats Worker API décidés
**Statut : prévu.**
Budget cible : **15-20 min**. Créer le noyau `ksp-worker-api` selon les contrats décidés, avec les tests unitaires, public API et dependency boundary prévus.
### `pre.003` — hardening, races, object-safety, impl externe et freeze
**Statut : prévu.**
Budget cible : **15-20 min**. Fermer le hardening du contrat Worker, les races et invariants lifecycle, l’object-safety et la preuve d’implémentation externe. Sortie : Worker API fonctionnellement fermée avant tout audit RAW provider.
### `pre.004` — audit RAW A : Solana standard + KSP Transport/Store/Config
**Statut : prévu.**
Budget cible : **15-20 min**. Auditer les voies standard Solana et l’inventaire KSP existant afin d’établir les capabilities, rôles et gaps internes nécessaires à la suite.
### `pre.005` — audit RAW B : Helius, Yellowstone/providers + kbot3 fonctionnel
**Statut : prévu.**
Budget cible : **15-20 min**. Auditer Helius, Yellowstone et les autres providers retenus avec sources primaires courantes ; utiliser kbot3 uniquement comme référence fonctionnelle historique autorisée. Sortie : preuves de disponibilité, quotas, replay et contraintes provider.
### `pre.006` — synthèse RAW multi-source + handoff `0.3.10` / `0.3.12`
**Statut : prévu.**
Budget cible : **15-20 min**. Consolider la matrice multi-source, les combinaisons de méthodes, les gaps Transport/Config et la stratégie réseau, puis produire le handoff vers l’ingest `0.3.10` et le backfill `0.3.12`.
### `pre.007` — gate technique final
**Statut : prévu.**
Budget cible : **10-15 min**. Fermer les gates workspace/Worker API, les arbres de dépendances et l’audit des doublons sans ajouter de nouvelle fonctionnalité.
### `pre.008` — réconciliation documentaire finale
**Statut : prévu.**
Budget cible : **10-15 min**. Réconcilier README, USAGE, plan, validation et architecture avec l’état technique déjà fermé, sans nouveau runtime.
### `pre.009` — préparation de publication
**Statut : prévu.**
Budget cible : **5-10 min**. Préparer le prompt `0.3.10`, CHANGELOG, ROADMAP, Cargo et le delta de publication, sans rattrapage fonctionnel.
### `rel.001` — publication mécanique stable
**Statut : prévu.**
Budget cible : **5-10 min**. Publier mécaniquement `v0.3.9` sur une candidate déjà fermée, sans rattrapage.
Les numéros restent souples. Un défaut réel peut ouvrir `pre.NNN-fix.MMM` dans le même couloir ou forcer un split supplémentaire. Les responsabilités `gate technique -> réconciliation documentaire -> préparation de publication` restent séparées.