3.3 KiB
Politique de sélection des archives documentaires
1. Objet
Cette politique définit les fichiers historiques qui peuvent être copiés depuis l’archive complète de khadhroony-bot2 vers olddocs/archivekbot2/.
La sélection repose sur la fonction documentaire du fichier, et non sur son extension ni uniquement sur son emplacement.
2. Principe général
olddocs/archivekbot2/ est une archive documentaire historique et non une copie partielle du workspace exécutable.
L’archive complète de bot2 reste la référence pour le code source, les fixtures, les configurations d’exécution et les artefacts nécessaires à la compilation ou aux tests.
3. Fichiers à conserver
Les catégories suivantes peuvent être conservées lorsqu’elles présentent une valeur historique, normative, architecturale ou décisionnelle :
- documents Markdown racine, sous
docs/, sousprompts/et dans les anciennes crates ; - changelogs, roadmaps, règles, audits, plans, rapports, guides et décisions ;
- matrices JSON décrivant une couverture, un contrat, une validation ou un inventaire ;
- IDL archivées servant de références pour la conception manuelle des futurs décodeurs, exécuteurs, matérialisateurs, matrices et tests ;
- schémas publics décrivant formellement un contrat de configuration ;
- exemples de configuration destinés aux utilisateurs ou aux opérateurs ;
- autres fichiers non exécutables dont la valeur documentaire est explicitement démontrée.
4. Fichiers à exclure
Les catégories suivantes ne doivent pas être copiées dans l’archive documentaire :
- code source et fichiers internes placés sous
src/, même lorsqu’ils utilisent une extension documentaire, sauf décision explicite motivée ; - fixtures de tests, snapshots et réponses RPC enregistrées ;
- manifests et configurations nécessaires au build ou au lancement de l’ancienne application ;
- fichiers Tauri, npm, TypeScript et capabilities servant à l’exécution ;
- bases de données, clés, preuves, données privées et fichiers temporaires ;
- artefacts générés ou reconstructibles sans valeur documentaire autonome.
5. Cas explicitement conservés
Les fichiers suivants sont conservés car leur fonction est documentaire :
config/example.config.json
config/schema.config.json
docs/*_MATRIX.json
idls/*.json
example.config.json illustre la configuration utilisateur historique complète. schema.config.json formalise le contrat de cette configuration. Les matrices documentent les périmètres techniques et les validations. Les IDL sont des références archivées et ne sont pas chargées dynamiquement par le code de production.
6. Cas explicitement exclus
Les fichiers suivants sont exclus car ils relèvent de l’exécution ou des tests :
kb_app_demo/capabilities/default.json
kb_app_demo/package.json
kb_app_demo/tauri.conf.json
kb_app_demo/tsconfig.json
kb_rpc/tests/fixtures/*.json
kb_store_core/src/**
kb_store_pg/src/**
7. Évolution de l’archive
Tout ajout futur à olddocs/archivekbot2/ doit être évalué avec cette politique. En cas d’ambiguïté, le fichier n’est pas copié tant que sa valeur documentaire autonome n’est pas démontrée.