v0.4.7-pre.017 (final)

.cargo/config.toml

@@ -1,3 +1,6 @@
+# file: .cargo/config.toml
+# version: 1
+
 [build]
 target-dir = "../target"         # path of where to place generated artifacts
 build-dir = "../target"          # path of where to place intermediate build artifacts

Cargo.toml

@@ -18,7 +18,7 @@ members = [
 ]
 
 [workspace.package]
-version = "0.4.7-pre.16"
+version = "0.4.7"
 edition = "2024"
 license = "MIT"
 repository = "https://git.sasedev.com/Sasedev/khadhroony-bot3"

ROADMAP.md

@@ -1,5 +1,5 @@
 <!-- file: ROADMAP.md -->
-<!-- version: 27 -->
+<!-- version: 28 -->
 
 # ROADMAP — khadhroony-bot3
 
@@ -28,7 +28,7 @@ Version en clôture documentaire.
 
 - les opérations structurantes et les parcours représentatifs sont validés réellement sur Devnet ;
 - les autres opérations exposées restent couvertes par leurs builders, matrices et tests synthétiques ;
-- les campagnes Devnet spécialisées `Print`, `Burn`, collections avancées, délégations/lock pNFT, rule sets et maintenance sont une dette de validation complémentaire, non un blocant de clôture ;
+- les campagnes Devnet spécialisées `Print`, `Burn`, collections avancées, délégations/lock pNFT, rule sets et maintenance sont une dette de validation complémentaire, non un bloquant de clôture ;
 - aucune preuve synthétique ne doit être présentée comme preuve RPC.
 
 ### Hors périmètre

docs/IDEA_REMINDERS.md

@@ -1,5 +1,5 @@
 <!-- file: docs/IDEA_REMINDERS.md -->
-<!-- version: 5 -->
+<!-- version: 6 -->
 
 # Rappels d’idées
 
@@ -11,8 +11,6 @@ Ce document conserve les idées utiles qui ne constituent pas encore des engagem
 - pagination SQL/IPC côté serveur avant l’exploitation de volumes massifs ;
 - résolution configurable du chemin de base de `kb-store` ;
 - sélection indépendante du profil de logging ;
-- protection systématique contre les doubles déclenchements des actions réseau ;
-- affichage explicite des preuves de matérialisation après confirmation.
 
 ## Pipeline et PostgreSQL
 
@@ -21,13 +19,6 @@ Ce document conserve les idées utiles qui ne constituent pas encore des engagem
 - compteurs séparés pour erreurs fonctionnelles, traitement, stockage, reprises et échecs finaux ;
 - persistance éventuelle des erreurs survenant avant l’écriture du ledger.
 
-## Metadata et validation réseau
-
-- compléter ultérieurement les validations Devnet spécialisées Metaplex Token Metadata : Print, Burn, collections avancées, pNFT delegate/lock/unlock/revoke/transfer et rule sets ;
-- maintenir une distinction stricte entre validation synthétique, simulation RPC et soumission confirmée ;
-- prévoir les scénarios Devnet desktop dès la planification de chaque nouvelle surface, pas après l’implémentation ;
-- étudier `kb-offchain-transport` sans coupler le fetch distant au replay canonique.
-
 ## Documentation et outils
 
 - refaire les scripts Python d’audit après stabilisation définitive de la nomenclature ;

docs/README.md

@@ -1,5 +1,5 @@
 <!-- file: docs/README.md -->
-<!-- version: 12 -->
+<!-- version: 13 -->
 
 # Documentation active de Khadhroony Bot3
 
@@ -38,6 +38,7 @@ Modèles documentaires non génératifs :
 
 ## 4. Audits et décisions actifs
 
+- [`audits/V0_4_7_PRE_016_DOCUMENTATION_AND_HEADERS_AUDIT.md`](audits/V0_4_7_PRE_016_DOCUMENTATION_AND_HEADERS_AUDIT.md) ;
 - [`decisions/DOCUMENT_ARCHIVE_SELECTION_POLICY.md`](decisions/DOCUMENT_ARCHIVE_SELECTION_POLICY.md) ;
 - [`decisions/WINCODE_COMPATIBILITY_POLICY.md`](decisions/WINCODE_COMPATIBILITY_POLICY.md).
 

docs/rules/RULES_RUST.md

@@ -1,5 +1,5 @@
 <!-- file: docs/rules/RULES_RUST.md -->
-<!-- version: 7 -->
+<!-- version: 8 -->
 
 # Règles Rust générales
 
@@ -8,6 +8,7 @@ Ce fichier contient les règles normatives applicables à tous les projets Rust.
 ## En-têtes et versions de fichiers
 
 - Tout fichier texte qui supporte des commentaires commence par une ligne indiquant son chemin relatif dans le projet, puis une ligne `version` entière.
+- Un script exécutable nécessitant un shebang conserve celui-ci en première ligne ; les lignes `file:` et `version:` suivent immédiatement le shebang.
 - La version d'un fichier est incrémentée à chaque modification après validation de sa version précédente.
 - Les fichiers Rust utilisent `// file: ...` et `// version: N`.
 - Les fichiers Markdown utilisent `<!-- file: ... -->` et `<!-- version: N -->`.

docs/templates/CRATE_README_TEMPLATE.md

@@ -1,5 +1,5 @@
 <!-- file: docs/templates/CRATE_README_TEMPLATE.md -->
-<!-- version: 1 -->
+<!-- version: 2 -->
 
 # Modèle de README de crate
 
@@ -31,6 +31,8 @@ Supprimer cette section si la crate ne fournit aucun binaire.
 
 ## Documentation
 
-- [Guide d’utilisation](USAGE.md)
+- Guide d’utilisation : `USAGE.md`
-- [Travaux restant à réaliser](TODO.md)
+- Travaux restant à réaliser : `TODO.md`
-- [Historique des changements](CHANGELOG.md)
+- Historique des changements : `CHANGELOG.md`
+
+Après copie du modèle à la racine d’une crate, transformer ces références en liens relatifs vers les fichiers locaux.

kb-app-demo-desktop/TODO.md

@@ -1,12 +1,10 @@
 <!-- file: kb-app-demo-desktop/TODO.md -->
-<!-- version: 8 -->
+<!-- version: 9 -->
 
 # TODO — kb-app-demo-desktop
 
 ## Évolutions générales
 
-- [ ] Documentation — maintenir un guide opérateur complet des fenêtres et effets réseau.
-- [ ] Sécurité — réévaluer les capabilities lors de chaque nouvelle fenêtre ou commande sensible.
 - [ ] UX — empêcher les doubles déclenchements pendant une préparation, simulation ou soumission active.
 - [ ] Observabilité — afficher explicitement les comptes relus et les projections matérialisées.
 

kb-core/TODO.md

@@ -1,5 +1,5 @@
 <!-- file: kb-core/TODO.md -->
-<!-- version: 2 -->
+<!-- version: 3 -->
 
 # TODO — kb-core
 
@@ -7,5 +7,3 @@
 
 - [ ] Dette technique - réévaluer les variantes génériques de `Error` lorsque les frontières de domaine seront stabilisées.
 - [ ] Dette technique - remplacer les usages de `Error::Custom` qui méritent une famille publique dédiée.
-- [ ] Documentation - compléter la correspondance entre familles d’erreur et crates consommatrices lorsqu’une nouvelle famille est ajoutée.
-- [ ] Tests - ajouter un test ciblé lors de l’introduction d’une nouvelle variante publique d’erreur ou de module.

kb-lib/TODO.md

@@ -1,5 +1,5 @@
 <!-- file: kb-lib/TODO.md -->
-<!-- version: 12 -->
+<!-- version: 13 -->
 
 # TODO — kb-lib
 
@@ -20,7 +20,6 @@
 ## Versions ultérieures
 
 - [ ] Surfaces - remplacer les décodeurs et exécuteurs réservés selon le ROADMAP.
-- [ ] Documentation - documenter chaque nouvelle famille publique lors de son activation.
 - [ ] Anchor - implémenter l’infrastructure générique des conventions Anchor dans la série `0.6.x`.
 
 ## Validation réseau complémentaire Metaplex Token Metadata

kb-pipeline-demo-scenarios/TODO.md

@@ -1,5 +1,5 @@
 <!-- file: kb-pipeline-demo-scenarios/TODO.md -->
-<!-- version: 9 -->
+<!-- version: 10 -->
 
 # TODO — kb-pipeline-demo-scenarios
 
@@ -14,7 +14,6 @@
 
 - [ ] Ajouter au CLI uniquement les préparations de fixtures explicitement justifiées.
 - [ ] Améliorer la réutilisation, le nettoyage et la validation des fixtures publiques.
-- [ ] Maintenir un guide opérateur des campagnes et de leurs effets réseau.
 
 ## Report conditionnel — registre ElGamal
 

scripts/fetch_metaplex_token_metadata_idl.sh

@@ -1,4 +1,7 @@
 #!/usr/bin/env bash
+# file: scripts/fetch_metaplex_token_metadata_idl.sh
+# version: 1
+
 set -euo pipefail
 readonly URL="https://raw.githubusercontent.com/metaplex-foundation/mpl-token-metadata/main/idls/token_metadata.json"
 readonly OUTPUT="idls/metadata.metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s.metaplex_token_metadata.V1_14_0.from_github_mpl-token-metadata.json"