v0.1.0-pre.064-065

docs/DOCUMENTATION_REFACTOR_AUDIT.md

@@ -1,5 +1,5 @@
 <!-- file: docs/DOCUMENTATION_REFACTOR_AUDIT.md -->
-<!-- version: 1 -->
+<!-- version: 3 -->
 
 # Audit de refonte documentaire
 
@@ -62,18 +62,32 @@ Ces documents sont une source historique et technique. Ils ne sont pas normatifs
 
 ## 3. État de `olddocs/`
 
-Le répertoire `olddocs/` n’existe pas dans l’archive bot3 fournie. Il n’y a donc aucun contenu bot3 à préserver sous ce chemin dans cette base précise.
+L’absence de `olddocs/` dans l’archive bot3 fournie est volontaire : conserver une copie partielle de bot2 dans chaque archive complète bot3 aurait dupliqué la source historique alors que l’archive complète bot2 est fournie au démarrage de la session documentaire. Ce point n’est donc pas un défaut de la base `pre.062`.
 
-La reconstruction devra créer deux archives séparées :
+La reconstruction crée deux archives séparées :
 
 ```text
 olddocs/archivekbot2/
 olddocs/archivekbot3/
 ```
 
-La totalité de `khadhroony-bot2/docs/` devra être copiée dans `olddocs/archivekbot2/` sans réécriture de fond. L’archive source fournie ne doit évidemment pas être modifiée. Les documents bot3 devenus temporaires ou remplacés seront déplacés ultérieurement vers `olddocs/archivekbot3/`, après correction de leurs références.
+`olddocs/archivekbot2/` doit reproduire l’arborescence documentaire utile de bot2, et pas uniquement son ancien répertoire `docs/`. La structure attendue comprend notamment :
 
-Le choix opérationnel retenu pour la suite doit être une copie depuis l’archive bot2, et non un déplacement destructif.
+```text
+olddocs/archivekbot2/README.md
+olddocs/archivekbot2/CHANGELOG.md
+olddocs/archivekbot2/ROADMAP.md
+olddocs/archivekbot2/RULES.md
+olddocs/archivekbot2/docs/...
+olddocs/archivekbot2/prompts/...
+olddocs/archivekbot2/<ancienne-crate>/README.md
+olddocs/archivekbot2/<ancienne-crate>/CHANGELOG.md
+olddocs/archivekbot2/<ancienne-crate>/<autres-documents>.md|json
+```
+
+Cette archive est reconstruite depuis l’archive complète bot2 fournie, en conservant les chemins relatifs et sans modifier les fichiers historiques. Les documents bot3 devenus temporaires ou remplacés seront déplacés ultérieurement vers `olddocs/archivekbot3/`, après correction de leurs références.
+
+Le choix opérationnel est une copie documentaire depuis l’archive bot2, et non un déplacement destructif ni une copie complète du code bot2.
 
 ## 4. Contrat documentaire des crates
 
@@ -109,7 +123,15 @@ Le workspace déclare 11 crates :
 
 Aucune crate ne satisfait donc le contrat complet `README.md`, `TODO.md`, `USAGE.md`, `CHANGELOG.md`.
 
-Une contradiction normative existe dans `RULES_GENERAL.md` : le fichier exige encore un `README.md` ou `001.README.md` et, à terme, un `USAGES.md`. Cette formulation doit être remplacée par le contrat acquis utilisant exactement `README.md`, `TODO.md`, `USAGE.md` et `CHANGELOG.md`.
+Une contradiction normative existe dans `RULES_GENERAL.md` : le fichier exige encore un `README.md` ou `001.README.md` et, à terme, un `USAGES.md`. La convention retenue est `USAGE.md`, nom singulier couramment utilisé pour un guide d’utilisation. La règle doit imposer exactement `README.md`, `TODO.md`, `USAGE.md` et `CHANGELOG.md`.
+
+### 4.4 Frontière de l’archive documentaire
+
+La première sélection fondée sur toutes les extensions Markdown et JSON était trop large. La sélection doit désormais reposer sur la fonction documentaire autonome du fichier.
+
+Sont notamment exclus les configurations de build et d’exécution Tauri/npm/TypeScript, les capabilities, les fixtures RPC et les fichiers internes sous `kb_store_core/src/` ou `kb_store_pg/src/`.
+
+Restent conservés les matrices documentaires, les IDL archivées, `config/example.config.json` et `config/schema.config.json`, conformément à [`decisions/DOCUMENT_ARCHIVE_SELECTION_POLICY.md`](decisions/DOCUMENT_ARCHIVE_SELECTION_POLICY.md).
 
 ## 5. Évaluation des documents racine
 
@@ -153,7 +175,7 @@ Avant déplacement, il faudra :
 3. adapter les chemins attendus par `scripts/audit_khadhroony_workspace_rules.py` ;
 4. vérifier le lanceur `scripts/audit_rust_workspace_rules.py` ;
 5. corriger README, prompts, documents d’onboarding et checklist de migration ;
-6. exécuter l’audit et `git diff --check` avant livraison.
+6. exécuter l’audit workspace et les validations adaptées aux fichiers modifiés avant livraison. Les commandes Git restent sous la responsabilité de l’opérateur et ne font pas partie des validations demandées à la session.
 
 ## 7. Analyse des prompts
 
@@ -222,10 +244,10 @@ Les déplacements ne doivent commencer qu’après création de `docs/README.md`
 
 Les écarts suivants sont établis sans nouvel audit fonctionnel des protocoles :
 
-1. absence de `olddocs/` dans la base bot3 fournie ;
+1. absence volontaire de `olddocs/` dans la base bot3 fournie, à reconstruire depuis l’archive complète bot2 ;
 2. absence de `docs/README.md` ;
 3. contrat documentaire incomplet pour les 11 crates ;
-4. contradiction `USAGES.md` contre `USAGE.md` ;
+4. contradiction `USAGES.md` contre `USAGE.md`, résolue en faveur de `USAGE.md` ;
 5. règles secondaires encore liées à la racine par le code d’audit et les prompts ;
 6. changelog bot3 ne reprenant pas encore l’historique bot2 ;
 7. roadmap général encore mélangé à la checklist de migration et aux prereleases ;
@@ -237,7 +259,7 @@ Les écarts suivants sont établis sans nouvel audit fonctionnel des protocoles
 
 Aucune ambiguïté ne bloque la première livraison d’audit.
 
-Les choix suivants doivent être validés avant les deltas de déplacement, mais peuvent être traités par propositions réversibles :
+Les choix suivants restent à trancher avant les deltas de déplacement, mais ne bloquent pas l’archivage documentaire ni la correction des règles :
 
 - emplacement final de `OPERATION_NAMING_CONVENTION.md` entre `architecture/` et `rules/` ;
 - maintien temporaire ou archivage immédiat de `IDEA_REMINDERS.md` après ventilation dans les TODO ;
@@ -249,3 +271,14 @@ Les choix suivants doivent être validés avant les deltas de déplacement, mais
 La base technique peut servir à la refonte documentaire, mais elle n’est pas encore démontrée comme officiellement alignée sur `0.4.6`.
 
 La prochaine étape contrôlée est l’application du plan décrit dans `docs/DOCUMENTATION_REFACTOR_PLAN.md`, par deltas séparés, avant la création de `docs/V0_4_6_ALIGNMENT_AUDIT.md` et avant toute modification des versions Cargo.
+
+## 12. Précisions acquises après le premier audit
+
+- L’absence initiale de `olddocs/` dans bot3 était volontaire ; l’archive bot2 fournie séparément évitait une duplication pendant la migration.
+- Les documents actifs ne seront jamais déplacés ni générés automatiquement depuis `olddocs/archivekbot2/`. Chaque document bot3 sera créé après lecture et adaptation des sources pertinentes.
+- Les matrices de contrats actives sont déjà centralisées sous `test-fixtures/contract-matrices/` et ne doivent pas être recopiées dans `docs/`.
+- Le registre ElGamal est implémenté dans `kb-lib`; son intégration pipeline reste à vérifier précisément, son panneau desktop n’est qu’une présentation et son déploiement Devnet/Mainnet ne doit pas être supposé.
+- La migration bot3 a commencé en cours de `0.4.7` après réalisation du décodeur Metaplex Token Metadata dans bot2 ; ce décodeur existe déjà dans bot3, tandis que le reste de la surface doit être évalué.
+- La classification des IDL est un besoin actif immédiat à cause du renommage massif déjà effectué. Elle n’est pas reportée à `0.6.x`; seules les infrastructures Anchor supplémentaires relèvent de cette série.
+- Chaque changelog de crate devra contenir au minimum une section `0.1.0` retraçant sa migration depuis bot2, sa consolidation dans bot3 et l’adoption des nouvelles normes Rust et Khadhroony.
+- Les TODO pourront intégrer des idées de `docs/IDEA_REMINDERS.md` uniquement après confirmation, attribution, vérification et réordonnancement.