Delta 0.1.3-pre.015-fix.001 — règles de validation, documentation et gabarit Tauri

Base requise

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 :

cargo fmt --all
cargo check --workspace
cargo clippy --workspace --all-targets

Pendant le développement courant, les tests privilégient la crate concernée :

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

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é

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

Version Cargo

Aucune modification :

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.

4.1 KiB Raw Blame History