0.5.1-pre.002

ks-logging/README.md

@@ -0,0 +1,38 @@
+<!-- file: ks-logging/README.md -->
+<!-- version: 5 -->
+
+# ks-logging
+
+`ks-logging` initialise le subscriber global `tracing` à partir d’une configuration de routes explicites vers la console ou des fichiers.
+
+## Responsabilités
+
+- sélectionner les routes activées ;
+- appliquer niveaux, targets exactes et préfixes wildcard ;
+- créer les writers non bloquants ;
+- gérer les formats human, compact, pretty et JSON ;
+- gérer les rotations de fichiers supportées ;
+- conserver les `WorkerGuard` pendant toute la durée du processus.
+
+## Hors périmètre
+
+La crate ne charge pas actuellement le fichier de configuration et ne définit pas les targets des autres crates. Le cadrage `0.5.0-pre.002` confirme qu’un document logging séparé sera introduit en `0.5.1`; la propriété exacte du DTO source sera fixée sans faire dépendre la configuration générale du runtime tracing.
+
+## API publique
+
+- `init_logging` initialise le subscriber global ;
+- `LoggingConfig`, `LogTargetConfig` et `LogTargetFilterConfig` décrivent les routes ;
+- `LoggingGuard` maintient les writers et expose les routes installées ;
+- `tracing_target` retourne le target canonique de la crate ;
+- `LogFileRoute` reste disponible pour les anciens appelants file-only.
+
+## Statut
+
+L’initialisation multi-routes est fonctionnelle. Elle échoue explicitement si aucune route n’est activée ou si le subscriber global a déjà été initialisé.
+
+## Documents
+
+- [Utilisation](USAGE.md)
+- [Travaux restants](TODO.md)
+- [Historique](CHANGELOG.md)
+- [Guide de configuration](../ks-config/USAGE.md)