# 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 ``` `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.