khadhroony-solana-project/deltas/0.0.3/pre.001-fix.002.md

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 :

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.