v0.1.4-pre.011-fix.001

deltas/0.1.4/pre.011-fix.001.md

@@ -0,0 +1,57 @@
+<!-- file: deltas/0.1.4/pre.011-fix.001.md -->
+<!-- version: 1 -->
+
+# Delta `0.1.4-pre.011-fix.001` — audit `.env.example` et labels de namespace
+
+## Statut
+
+Correctif de `0.1.4-pre.011` après validation locale.
+
+## Défaut observé
+
+`cargo test -p ksp-config-lib` échouait dans l'audit d'ownership :
+
+```text
+.env.example is missing runtime variable KSPB_PUBLIC
+```
+
+`KSPB_PUBLIC` n'est pourtant pas une variable runtime concrète. C'est un label de famille utilisé par Config Desk pour classifier les noms `KSPB_PUBLIC_*` dans la vue Environnement.
+
+Le scanner de l'audit interprétait à tort les quatre labels suivants comme des variables concrètes :
+
+- `KSP_PUBLIC` ;
+- `KSP_SECRET` ;
+- `KSPB_PUBLIC` ;
+- `KSPB_SECRET`.
+
+Ajouter artificiellement ces labels à `.env.example` aurait dégradé son contrat en documentant de fausses variables.
+
+## Correction
+
+- le scanner `collect_environment_names()` ignore uniquement les quatre labels de namespace non concrets ;
+- les noms possédant un suffixe réel restent détectés, par exemple :
+  - `KSP_PUBLIC_RPC_URL` ;
+  - `KSP_SECRET_API_KEY` ;
+  - `KSPB_PUBLIC_ENDPOINT` ;
+  - `KSPB_SECRET_TOKEN` ;
+- ajout d'un test de non-régression qui vérifie simultanément l'exclusion des labels et la conservation des noms concrets ;
+- `.env.example` reste inchangé : aucune fausse variable n'est ajoutée.
+
+## Version technique
+
+```text
+workspace.package.version = "0.1.4-pre.11.fix.1"
+```
+
+## Validation locale demandée
+
+```bash
+cargo fmt --all
+cargo check --workspace
+cargo clippy --workspace --all-targets
+cargo test -p ksp-app-config-desk
+cargo test -p ksp-config-lib
+cargo tauri dev -c crates/ksp-app-config-desk/tauri.conf.json
+```
+
+Après correction, `tests/ownership.rs` doit contenir cinq tests et `dotenv_example_covers_runtime_environment_names_with_comments` doit repasser au vert.