v0.2.1-pre.006-fix.001

This commit is contained in:
2026-08-17 21:16:26 +02:00
parent f5d98c4e69
commit 598474438b
6 changed files with 162 additions and 11 deletions

View File

@@ -1,5 +1,5 @@
<!-- file: docs/rules/RULES_DEPENDENCIES.md -->
<!-- version: 15 -->
<!-- version: 16 -->
# Règles des dépendances KSP
@@ -56,6 +56,7 @@ Elles complètent les règles Rust générales et le graphe de `docs/architectur
- **DEP-LOG-009** — Tout bridge `tracing` public mais caché de la documentation rendu techniquement nécessaire par lexpansion des macros de `ksp-logging-lib` est un détail dimplémentation réservé à ces macros ; une crate consommatrice ne lutilise jamais directement et reste limitée à la façade KSP documentée.
- **DEP-LOG-010** — Toute crate KSP comportementale qui émet des événements/spans via `ksp-logging-lib` possède un target principal explicite `pub(crate) const TRACING_TARGET: &str` dans `src/constants.rs`, égal au nom Cargo de la crate. Les appels utilisent ce symbole (ou un target spécialisé possédé par le même `constants.rs`) plutôt quun littéral dispersé.
- **DEP-LOG-011** — `env!("CARGO_PKG_NAME")` ne sert pas de target de tracing/logging KSP : le target appartient au contrat dobservabilité et doit rester explicite dans le code. Les metadata Cargo restent autorisées lorsquelles sont réellement la donnée recherchée, par exemple pour un User-Agent ou une information de build.
- **DEP-LOG-012** — Lorsquune seule crate/target KSP nécessite temporairement une verbosité `debug` ou `trace`, le profil Logging général nest pas relevé par défaut : un `target_filter` autorise cette verbosité uniquement pour le target concerné et un sink dédié la route avec son propre `OutputFilter`. Les sinks généraux peuvent ainsi rester à `info`/`warn`. Un relèvement global du profil nest retenu que lorsquun diagnostic transversal le justifie explicitement.
## Program / Execution