v0.1.3-pre.015-fix.001

deltas/0.1.3/pre.015-fix.001.md

@@ -0,0 +1,93 @@
+<!-- file: deltas/0.1.3/pre.015-fix.001.md -->
+<!-- version: 1 -->
+
+# Delta 0.1.3-pre.015-fix.001 — règles de validation, documentation et gabarit Tauri
+
+## Base requise
+
+```text
+0.1.3-pre.015
+workspace.package.version = "0.1.3-pre.15"
+```
+
+Ce correctif est exclusivement documentaire. Il ne modifie aucun fichier Rust, manifest Cargo, fichier Config runtime, schema ou variable d'environnement. Conformément à la règle de version technique, `workspace.package.version` reste `0.1.3-pre.15`.
+
+## Objet
+
+Le correctif fige les conventions demandées avant `rel.001` et avant l'ouverture de `0.1.4 — ksp-app-config-desk`.
+
+### Validation Cargo
+
+Après toute modification d'un fichier Rust, une tranche doit exécuter :
+
+```bash
+cargo fmt --all
+cargo check --workspace
+cargo clippy --workspace --all-targets
+```
+
+Pendant le développement courant, les tests privilégient la crate concernée :
+
+```bash
+cargo test -p <crate>
+```
+
+`cargo test --workspace` est conservé pour les ouvertures/fermetures de session ou de version et les contrôles globaux justifiés. Les audits `cargo tree` pertinents restent exécutés pour les crates travaillées/complétées.
+
+### Documentation de fin de crate/application
+
+Une crate/composant complété possède un `README.md`. Une bibliothèque complétée possède un `USAGE.md` durable, sans notes de version, centré sur sa surface publique et fournissant des exemples d'utilisation des APIs publiques directement consommables. Une application Tauri complétée possède un `USAGE.md` décrivant ses fenêtres et leur utilisation.
+
+`crates/ksp-config-lib/USAGE.md` est renforcé immédiatement pour servir de premier exemple de cette convention.
+
+### Gabarit Tauri de référence
+
+`ksp-app-config-desk` doit servir de modèle aux futures applications Tauri KSP et réutiliser/refondre les acquis utiles de khadhroony-bot3 : SASS/SCSS, packages frontend, gabarit et icône, Vite/TypeScript, package Rust `lib` + `bin` aux noms distincts, launcher `main.rs` minimal, `lib.rs` déclaratif, `tauri.rs` propriétaire de `run` et des wrappers `#[tauri::command]`, modules de fenêtres `tw_*`, helpers communs, single-instance et splashscreen factorisé.
+
+La temporisation du splashscreen est pilotée par Config/.env. Le nom de la variable sera choisi quand l'implémentation en aura réellement besoin puis ajouté dans le même delta à `.env.example` avec commentaire.
+
+Le prompt corrige aussi le layout applicatif : la crate est `crates/ksp-app-config-desk`, pas `apps/ksp-app-config-desk`.
+
+### `PRESENTATION.md`
+
+Le `README.md` d'une application Tauri n'est jamais utilisé comme contenu de présentation embarqué. Si une application possède une vue de présentation Markdown, elle utilise `PRESENTATION.md`; `markdown-it` reste le renderer de référence hérité de bot3 lorsque ce besoin existe et sa version doit être vérifiée avant ajout.
+
+`PRESENTATION.md` ne contient aucun lien navigable Markdown/HTML susceptible de casser la navigation ou le lifecycle des fenêtres Tauri. Une application monofenêtre sans présentation ne crée pas ce fichier et n'ajoute pas `markdown-it` uniquement par symétrie.
+
+## Fichiers modifiés
+
+```text
+docs/rules/RULES_KSP.md
+docs/rules/FILE_CONTRACTS.md
+prompts/004-V0_1_4_START_PROMPT.md
+crates/ksp-config-lib/USAGE.md
+```
+
+## Fichier ajouté
+
+```text
+deltas/0.1.3/pre.015-fix.001.md
+```
+
+## Version Cargo
+
+Aucune modification :
+
+```text
+workspace.package.version = "0.1.3-pre.15"
+```
+
+Le fix ne touche aucun artefact participant au code/build/runtime/config/migrations.
+
+## Validation du correctif
+
+Le correctif documentaire est contrôlé par :
+
+- headers `file:` / `version:` ;
+- cohérence des références `crates/ksp-app-config-desk` ;
+- absence de modification Rust/Cargo/config ;
+- absence de nouvelle variable runtime ou modification `.env.example` ;
+- équilibre des fences Markdown ;
+- archive limitée aux cinq fichiers ci-dessus.
+
+Aucune commande Cargo n'est requise spécifiquement pour ce fix documentaire. La validation globale de fermeture de `pre.015` reste cependant celle prévue avant `rel.001`, incluant `cargo test --workspace` parce que la version est en clôture.