Files
khadhroony-solana-project/deltas/0.0.3/pre.001-fix.002.md
2026-08-14 00:03:57 +02:00

104 lines
3.2 KiB
Markdown

<!-- file: deltas/0.0.3/pre.001-fix.002.md -->
<!-- version: 1 -->
# Delta 0.0.3-pre.001-fix.002
## Base requise
`0.0.3-pre.001-fix.001`.
## Objectif
Compléter le premier plan `0.0.3` avec :
- la règle d'extensibilité publique des contrats communs ;
- la séparation stricte entre W1 live/quasi-live et le backfill historique ;
- la mise à jour du roadmap fonctionnel `0.1.x+` ;
- l'introduction d'une structure durable de prompts ;
- le démarrage du brouillon vivant du prompt `0.1.x`.
## Version Cargo
Aucune modification de `Cargo.toml`.
Ce correctif est exclusivement documentaire. `workspace.package.version` reste :
```text
0.0.3-pre.1
```
## Fichiers ajoutés
- `prompts/000-README.md`
- `prompts/001-PROMPT_STRUCTURE.md`
- `prompts/002-V0_1_X_START_PROMPT.md`
- `deltas/0.0.3/pre.001-fix.002.md`
## Fichiers modifiés
- `README.md`
- `ROADMAP.md`
- `docs/architecture/003-COMPONENT_CONTRACTS.md`
- `docs/rules/RULES_KSP.md`
- `docs/rules/FILE_CONTRACTS.md`
- `docs/IDEAS.md`
- `docs/plans/001-V0_0_3_PLAN.md`
## Fichiers supprimés
Aucun.
## Décisions ajoutées
### Contrats publics extensibles
Les traits/APIs communs tels que `decoder_api`, `executor_api` et `materializer_api` doivent être exposés publiquement et conçus pour pouvoir être implémentés dans des crates séparées.
Cette extensibilité doit permettre de développer/tester des Program IDs ou matérialisations externes avant décision d'intégration dans les crates officielles KSP.
### Backfill historique
Le backfill historique est séparé de W1.
W1 reste exclusivement live/quasi-live.
Le backfill possède sa propre pagination, progression, checkpoint/reprise et gouvernance. Son nom/formalisme exact sera décidé pendant l'inventaire des domaines/crates.
### Roadmap
Le `ROADMAP.md` décrit désormais la trajectoire actuelle :
- `0.1.x` — fondations ;
- `0.2.x` — accès Solana et fondation programmes ;
- `0.3.x` — données, stockage, W1 et backfill ;
- `0.4.x` — baseline Solana/SPL/metadata ;
- `0.5.x` — Anchor et protocoles trading ;
- `0.6.x` — processing autonome/orchestration ;
- `0.7.x` — Trading Intelligence ;
- `0.8.x+` — extension continue.
Le plan détaillé reste volontairement souple et peut faire évoluer le contenu exact des releases sans changer la ligne directrice du court terme.
### Prompts
Un répertoire racine `prompts/` est introduit.
Le prompt `0.1.x` commence maintenant sous forme de brouillon vivant. Il sera mis à jour au fil des prereleases `0.0.3` et finalisé pendant la phase documentaire de clôture avant ouverture du développement fonctionnel.
## Questions restant ouvertes
- nom et forme exacte du composant de backfill historique ;
- nomenclature détaillée des futures APIs publiques ;
- règles d'arborescence/réexports à définir avec les premières APIs réelles ;
- représentation interne du type `ksp_core_lib::Error` ;
- liste complète des crates candidates et graphe de dépendances ;
- contenu exact du plan `0.1.x`.
## Validations
Correctif documentaire uniquement :
- structure et présence des fichiers vérifiées lors de la génération ;
- aucune commande Cargo requise par le contenu de ce fix ;
- aucune modification fonctionnelle ou runtime.