v0.1.0-pre.068

CHANGELOG.md

@@ -1,146 +1,206 @@
 <!-- file: CHANGELOG.md -->
-<!-- version: 7 -->
+<!-- version: 10 -->
 
-# CHANGELOG
+# CHANGELOG — khadhroony-bot3
 
-## 0.1.0-pre.062
+Ce changelog décrit les évolutions fonctionnelles globales du projet. Il ne recense pas les prereleases, les correctifs `fix` ni le détail de chaque delta. Ces informations appartiennent aux changelogs des crates concernées.
 
-- clôture la première campagne Devnet complète du desktop après migration Bot3 ;
-- valide Solana Core System Transfer, SPL Memo v4, ATA classique, ATA Token-2022 et SPL Token classique ;
-- valide les huit scénarios publics Token-2022 : `MintToChecked`, `TransferChecked`, `ApproveChecked`, `Revoke`, `BurnChecked`, `FreezeAccount`, `ThawAccount` et `CloseAccount` ;
-- confirme pour chaque scénario applicatif l’insertion canonique, l’extraction Core, le replay de décodage, la matérialisation et l’idempotence ;
-- ajoute le générateur idempotent `prepare-token-2022-fixture` dans le binaire distinct `kb-pipeline-demo-scenarios-cli` ;
-- corrige le chargement des quatre montants bruts Token-2022 depuis `fixture.env` ;
-- conserve le registre ElGamal comme implémenté mais non validé sur Devnet, faute de fixture de contexte de preuve et de raccordement fonctionnel du panneau desktop ;
-- ajoute `docs/PRE_062_DEVNET_VALIDATION_REPORT.md` comme preuve de clôture bornée avant la refonte documentaire générale.
+## 0.1.0-mig-from-kbot2 — transition architecturale vers khadhroony-bot3
 
-## 0.1.0-pre.054
+Cette entrée de transition regroupe la migration structurelle et fonctionnelle commencée depuis `khadhroony-bot2`. Elle identifie la campagne `0.1.0-pre.*` de bot3 sans constituer une version fonctionnelle équivalente à bot2 `0.1.0` ni un alignement officiel sur `0.4.6`.
 
-- stabilise le desktop après le portage complet des fenêtres Bot2 ;
-- charge `.env` avant la configuration et fournit `.env.example` pour Helius ;
-- corrige l'inventaire Metaplex Token Metadata ;
-- normalise les exports TS-RS Token-2022 sous `kb_lib` ;
-- retire les routes de logs héritées de crates supprimées ;
-- restaure les tables SQL pleine largeur et les afficheurs JSON/logs bornés ;
-- initialise le schéma PostgreSQL dans le splash et ferme la session WS à la fermeture globale.
-## 0.1.0-pre.031
+### Architecture
 
-## 0.1.0-pre.037
+- consolidation de plus de 250 crates historiques en 11 crates de workspace ;
+- regroupement des modèles, décodeurs, exécuteurs et matérialisateurs dans `kb-lib` ;
+- consolidation du stockage dans `kb-store` ;
+- renommage de `kb-rpc` en `kb-onchain-transport` ;
+- migration du pipeline dans `kb-pipeline` ;
+- extraction des scénarios de démonstration dans `kb-pipeline-demo-scenarios` ;
+- maintien de `kb-app-demo-desktop` comme crate mixte bibliothèque et binaire ;
+- migration et renommage du portefeuille en `kb-wallet`.
 
-- Migration de la préparation stateful des opérations Solana natives dans `kb-pipeline`.
+### Normes
 
-- Migration complète de l’orchestration HTTP `backfill` dans `kb-pipeline`.
-- Conservation des sources explicites et historiques par adresse, des directions `before`/`after`, de la pagination bornée, des retries et de la reprise déterministe.
-- Adaptation aux façades `kb-onchain-transport`, `kb-store` et `kb-lib`.
-- Conservation des 14 tests bot2, dont les deux tests async d’annulation coopérative.
+- adoption de Rust 2024 et des règles strictes du workspace bot3 ;
+- interdiction des paniques implicites et des erreurs opaques dans le code de production ;
+- normalisation des exports publics, des en-têtes de fichiers, du tracing et des conventions de modules ;
+- ajout d’audits automatiques des règles Rust, des exports et des contraintes Khadhroony ;
+- adoption d’un contrat documentaire par crate fondé sur `README.md`, `TODO.md`, `USAGE.md` et `CHANGELOG.md`.
 
+### Migration fonctionnelle
 
-## 0.1.0-pre.030
+- migration du stockage canonique, des observations, de l’extraction Core et du replay ;
+- migration des transports HTTP, WebSocket, acquisition canonique, soumission et confirmation ;
+- migration des décodeurs, matérialisateurs et exécuteurs Solana Core et SPL jusqu’à un périmètre proche de bot2 `0.4.6` ;
+- migration du décodeur Metaplex Token Metadata commencé pendant bot2 `0.4.7` ;
+- migration des préflights et orchestrations stateful Token-2022 ;
+- conservation de Memo v1 et v3 en décodage uniquement et de Memo v4 comme génération exécutable.
 
-- Migration du replay contextuel de décodage dans `kb-pipeline`.
-- Conservation de la sélection bornée, du dispatch déterministe, du ledger, du force replay et de la matérialisation optionnelle.
-- Adaptation aux façades consolidées `kb-lib` et `kb-store`.
-- Conservation des 19 tests de l’ancienne implémentation bot2.
+### Validation
 
+- validation du workspace, des audits et des tests ciblés pendant les prereleases `0.1.0-pre.*` ;
+- validation Devnet de Solana Core System Transfer, Memo v4, ATA classique, ATA Token-2022, SPL Token classique et huit opérations Token-2022 ;
+- validation des parcours de simulation, confirmation opérateur, envoi, insertion canonique, extraction Core, replay, matérialisation et idempotence pour les scénarios couverts ;
+- registre ElGamal non déclaré validé, faute de fixture de preuve, de raccordement desktop fonctionnel et de confirmation de déploiement réseau.
 
-## 0.1.0-pre.029
+# Historique fonctionnel de khadhroony-bot2
 
-- Migration initiale de `kb-pipeline` : primitives de planification et extraction canonique Solana vers les tables core.
-- Adaptation aux façades `kb-lib`, `kb-store` et `kb-onchain-transport`.
-- Normalisation du target de tracing `kb-pipeline` et ajout d’un test de configuration.
+Les sections dont le numéro porte le suffixe `-kbot2` décrivent exclusivement les versions et travaux réalisés dans `khadhroony-bot2`. Elles constituent l’historique fonctionnel du projet d’origine et ne représentent pas des versions publiées de `khadhroony-bot3`.
 
+`khadhroony-bot3` résulte de la migration et de la consolidation de cette base historique dans une nouvelle architecture. Son futur alignement de version sera décidé après la clôture de l’audit `0.4.6`.
 
-## 0.1.0-pre.024
+La future version fonctionnelle `0.4.7` de `khadhroony-bot3` devra réunir :
 
-- Première tranche fonctionnelle de `kb-onchain-transport`.
-- Migration des contrats JSON-RPC, des rôles d’endpoints, des clients et pools HTTP, des validateurs et des méthodes HTTP Solana standard.
-- Migration des adaptateurs RPC d’exécution communs vers les types consolidés de `kb-lib`.
-- WebSocket, acquisition canonique de transactions et soumission/confirmation réseau restent planifiés pour les tranches suivantes.
+- la clôture des écarts résiduels de migration ;
+- les capacités historiques de bot2 nécessaires à l’alignement ;
+- les travaux Metaplex Token Metadata déjà réalisés puis migrés ;
+- l’achèvement des éléments de l’objectif `0.4.7-kbot2` restés incomplets, notamment l’exécuteur, l’intégration au pipeline, les démonstrations et les validations finales.
 
-## 0.1.0-pre.023
+Les entrées `0.0.1-kbot2` à `0.4.6-kbot2` décrivent des versions fonctionnelles clôturées de bot2. L’entrée `0.4.7-kbot2` décrit une version interrompue en cours de développement par la migration vers bot3.
 
-- Renommage structurel de `kb-rpc` en `kb-onchain-transport`.
-- Renommage de l’identifiant Rust en `kb_onchain_transport`.
-- Mise à jour du workspace, des dépendances de `kb-pipeline` et `kb-app-demo`, du lockfile, des routes de logs et des documents actifs.
-- Réservation de `kb-offchain-transport` pour une éventuelle future acquisition HTTP/IPFS/Arweave hors chaîne.
-- Aucun portage fonctionnel RPC dans cette tranche.
+## 0.4.7-kbot2 — Metaplex Token Metadata interrompu par la migration bot3
 
-## 0.1.0-pre.022
+Cette section décrit l’objectif `0.4.7` commencé dans `khadhroony-bot2` après la clôture de `0.4.6-kbot2`. Cet objectif a été interrompu avant sa finalisation afin de réaliser la migration architecturale vers `khadhroony-bot3`.
 
-- Migration de `kb_execution_solana` dans `kb-lib::executor::solana::transaction`.
-- Conservation de l’assemblage legacy et durable nonce, de la preuve de simulation et de la signature contrôlée.
-- Validation utilisateur de 625 tests `kb-lib`, Clippy et du workspace.
+- implémentation du décodeur Metaplex Token Metadata dans bot2 ;
+- implémentation de la matérialisation associée dans bot2 ;
+- interruption volontaire du développement de cette surface afin de réaliser la migration architecturale vers `khadhroony-bot3` ;
+- reprise du décodeur pendant la migration vers bot3 ;
+- exécuteur, intégration complète au pipeline, scénarios de démonstration et validations finales reportés vers l’objectif fonctionnel `0.4.7` de `khadhroony-bot3`.
 
-## 0.1.0-pre.021
+## 0.4.6-kbot2 — Token-2022, extensions et registre ElGamal
 
-- Migration complète de l’exécuteur SPL Token classique.
-- Adaptation aux modèles et à la safety consolidés de `kb-lib`.
-- Validation utilisateur de 613 tests `kb-lib`, 41 tests `kb-config`, 17 tests `kb-logging`, Clippy et du workspace.
+- couverture bornée de Token-2022, de ses extensions et des interfaces externes associées ;
+- préflight, orchestration de preuves, corrélation stateful, validation et matérialisation ;
+- intégration du registre ElGamal avec validation synthétique et garde-fous fail-closed ;
+- absence de validation réelle du registre ElGamal sur Devnet ou Mainnet.
 
-## 0.1.0-pre.016
+## 0.4.5-kbot2 — SPL Associated Token Account
 
-- Portage fonctionnel complet de `kb_execution_safety` dans `kb-lib`.
-- Exposition des décisions, violations, évaluations et du checker sous les noms `ExSafety*`.
-- Portage fonctionnel de l’exécuteur SPL Memo et de ses contrats `ExSplMemo*`.
-- Conservation des générations v1/v3 en decode-only et de l’exécution v4 par le builder officiel.
-- Conservation des limites de payload, de signers, des politiques de simulation et des validations post-exécution.
-- Réduction de l’inventaire réservé de 103 à 102 exécuteurs.
+- décodage et exécution des créations ATA classiques et Token-2022 ;
+- vérification des PDA, de l’ordre des seeds et des contrats officiels ;
+- intégration aux matérialisateurs et au pipeline de validation.
 
-## 0.1.0-pre.015
+## 0.4.4-kbot2 — SPL Token classique
 
-- Portage fonctionnel complet de l’exécuteur Solana Core dans `kb-lib`.
-- Conservation des 109 opérations validées dans bot2 sur 18 surfaces natives.
-- Préfixage bot3 des contrats publics avec `ExSolanaCore*` et `EX_SOLANA_CORE_*`.
-- Conservation des deux contrats `ExApiTypedInstructionExecutor` et `ExApiInstructionExecutor`.
-- Regroupement canonique des réexports : bloc `pub use`, puis bloc `pub(crate) use`.
-- Réduction de l’inventaire réservé de 104 à 103 exécuteurs.
+- couverture des instructions SPL Token classiques, y compris opérations checked, multisig, native token et batch borné ;
+- matérialisation des comptes, autorités, délégations, risques et changements administratifs ;
+- exécution typée, préflight, simulation-first et validation des signers.
 
-## 0.1.0-pre.014
+## 0.4.3-kbot2 — SPL Memo v1, v3 et v4
 
-- Vérification de la parité exacte des contrats publics `ExApi*` avec `kb_execution_api` de bot2.
-- Extension du test aval au contrat d’exécution typé et au plan préparé.
-- Remplacement des 104 marqueurs temporaires par des squelettes `Ex*Executor`.
-- Rattachement des squelettes à leurs Program IDs enregistrés, sans dépendance vers les décodeurs.
-- Garantie d’inactivité par support `Maybe` et plans réservés à zéro instruction.
-- Extension de l’audit et ajout d’un test central sur les 104 frontières.
+- décodage borné des trois générations ;
+- matérialisation des annotations transactionnelles ;
+- exécution limitée à Memo v4 ;
+- validation Devnet de Memo v4.
 
-## 0.1.0-pre.013
+## 0.4.2-kbot2 — exécution native et RPC Solana standard
 
-- Remplacement des 14 marqueurs temporaires de matérialisation par des squelettes `Mt*Materializer`.
-- Conservation du contrat historique `MtMaterializer` et ajout du contrat bot3 `MtApiEventMaterializer`.
-- Réexports publics exclusivement depuis la façade `kb_lib`.
-- Alignement de l’audit des réexports sur l’ordre naturel produit par `rustfmt`.
+- infrastructure d’exécution Solana Core ;
+- couverture des programmes natifs, loaders, précompiles et opérations supportées ;
+- simulation, soumission, confirmation et politiques de sécurité ;
+- matrice d’exécution native et contrats de transaction legacy ou durable nonce.
 
-## 0.1.0-pre.001
+## 0.4.1-kbot2 — programmes Solana natifs
 
-- Renommage de `kb_wallet` en `kb-wallet`.
-- Restauration de `kb-core/src/error.rs` et `kb-core/src/module.rs`.
-- Réduction de `kb-core/src/lib.rs` à la déclaration des modules et aux réexports documentés.
+- décodage des programmes natifs, loaders, Compute Budget, Address Lookup Table, Stake, Vote et précompiles ;
+- matérialisations lifecycle, administration, compliance et staking ;
+- extraction et replay contextualisés.
 
-## 0.1.0-pre.000
+## 0.4.0-kbot2 — infrastructure de décodage et matérialisation
 
-- Création du workspace consolidé `khadhroony-bot3`.
-- Ajout de `kb-lib` pour les décodeurs, exécuteurs et matérialisateurs.
-- Fusion architecturale prévue des stores dans `kb-store`.
-- Conservation du workspace précédent comme référence de migration non compilée.
+- contrats communs de décodeurs, support, compatibilité et replay ;
+- ledger de traitement et matérialisation optionnelle ;
+- matrices contractuelles exécutables et tests de couverture.
 
-## 0.1.0-pre.002
+## 0.3.4-kbot2 — extraction Core et clôture de la fondation transactionnelle
 
-- Portage des modèles partagés de `kb_model` dans `kb-lib::model`.
-- Portage des contrats complets de `kb_decoder_api` dans `kb-lib::decoder::api`.
-- Portage des contrats complets de `kb_materializer_api` dans `kb-lib::materializer::api`.
-- Portage des contrats complets de `kb_execution_api` dans `kb-lib::executor::api`.
-- Ajout du contrat neutre `MdCoreInstructionReplayInput` dans `kb-lib` pour éviter une dépendance cyclique avec `kb-store`.
-- `kb-lib/src/lib.rs` reste une façade de modules et de réexports.
+- extraction des transactions canoniques vers les tables Core ;
+- replay déterministe et traitement idempotent ;
+- ledger de progression et reprise bornée.
 
-## 0.1.0-pre.010
+## 0.3.3-kbot2 — backfill HTTP
 
-- Portage des matérialisateurs natifs lifecycle, administration, compliance et staking.
-- Conservation de leurs 50 tests historiques et ajout du premier test aval de matérialisation.
+- acquisition historique gratuite par adresse et signatures ;
+- pagination, retries, annulation coopérative et reprise déterministe ;
+- démonstration applicative du backfill.
 
-## 0.1.0-pre.033
+## 0.3.2-kbot2 — contrat canonique et adaptateur HTTP
 
-- Migre les lectures stateful Token-2022 et ElGamal Registry dans `kb-pipeline`.
-- Migre le préflight Token-2022 borné et ses validations croisées.
-- Conserve les 16 tests bot2 associés sans réduction fonctionnelle.
-- Normalise les noms de fichiers, modules et symboles internes sur `token2022`.
+- définition d’une transaction Solana canonique indépendante du fournisseur ;
+- conversions explicites depuis les réponses RPC ;
+- conservation sans perte des données nécessaires au replay.
+
+## 0.3.1-kbot2 — transaction canonique et observations
+
+- séparation entre payload canonique et observations d’acquisition ;
+- migration du schéma PostgreSQL vers les tables raw, observations et Core actives ;
+- suppression de la duplication durable des payloads complets.
+
+## 0.3.0-kbot2 — cadrage des sources temps réel
+
+- étude d’un nœud Agave local ;
+- abandon temporaire comme source légère en raison du coût matériel ;
+- réorientation vers des transports interchangeables.
+
+## 0.2.5-kbot2 — diagnostics PostgreSQL
+
+- fenêtres de diagnostic du backend, du schéma et des tables raw/Core ;
+- initialisation contrôlée du schéma au démarrage ;
+- diagnostics strictement read-only.
+
+## 0.2.4-kbot2 — stockage Core Solana
+
+- tables Core normalisées ;
+- construction des entrées de replay instruction-level ;
+- migrations et initialisation idempotentes.
+
+## 0.2.3-kbot2 — stockage brut Solana
+
+- stockage idempotent des transactions et notifications brutes ;
+- index minimaux et cycle de vie initial des données.
+
+## 0.2.2-kbot2 — infrastructure PostgreSQL
+
+- connexion, migrations, healthcheck et conventions de schéma ;
+- tests PostgreSQL réels optionnels.
+
+## 0.2.1-kbot2 — contrats de stockage
+
+- DTO, entités et repositories du stockage ;
+- contrats de replay instruction-level.
+
+## 0.2.0-kbot2 — conventions SQL et base de données
+
+- séparation des contrats de stockage et de l’implémentation PostgreSQL ;
+- règles de nommage, migrations et erreurs structurées.
+
+## 0.1.3-kbot2 — transports Solana initiaux
+
+- clients HTTP et WebSocket Solana standard ;
+- rôles d’endpoints, pools et configuration des sources.
+
+## 0.1.2-kbot2 — intégration configuration, logging et desktop
+
+- liaison de la configuration typée et du logging à l’application Tauri ;
+- première démonstration intégrée.
+
+## 0.1.1-kbot2 — configuration typée
+
+- profils validés, schéma JSON et chargement structuré ;
+- gestion explicite des erreurs de configuration.
+
+## 0.1.0-kbot2 — logging structuré
+
+- infrastructure de logging et tracing ;
+- configuration des targets et sorties.
+
+## 0.0.2-kbot2 — squelette stabilisé
+
+- conventions initiales du workspace et premières crates ;
+- validation du build de base.
+
+## 0.0.1-kbot2 — création du projet
+
+- création du workspace initial khadhroony-bot2.