108 lines
4.3 KiB
Markdown
108 lines
4.3 KiB
Markdown
<!-- file: deltas/0.1.4/pre.014.md -->
|
|
<!-- version: 1 -->
|
|
|
|
# Delta `0.1.4-pre.014` — Logging editor, lecture/DTO
|
|
|
|
## Statut
|
|
|
|
Tranche livrée pour validation locale.
|
|
|
|
`0.1.4-pre.013` est considérée validée : `fmt`, `check`, `clippy`, les 38 tests Config Desk, les 87 tests Config, les cinq audits ownership et les 12 tests d'API publique passent. Les reveals privilégiés `effective` et `.env` ont été exercés avec confirmation explicite, affichage/masquage transitoire et nettoyage à la fermeture, sans valeur Secret visible dans les logs.
|
|
|
|
## Objectif
|
|
|
|
Ouvrir la surface Logging fonctionnelle en **lecture typée uniquement**, en utilisant le contrat public de `ksp-config-lib` comme unique autorité et sans commencer prématurément les mutations, la persistence ou le hot reload.
|
|
|
|
## Modifications
|
|
|
|
### Backend
|
|
|
|
- nouveau module `logging_editor.rs` ;
|
|
- chargement exclusif via `ConfigManagement::load_logging_document()` ;
|
|
- extension publique minimale de Config : `LoggingFileConfig::ansi()` permet de projeter le champ déjà possédé par le contrat typé sans sérialisation JSON de contournement ;
|
|
- résolution du path via le registre Config, sans chemin physique codé en dur ;
|
|
- mapping des types publics Config vers des DTO TS-RS dédiés :
|
|
- `LoggingDocumentDto` ;
|
|
- `LoggingProfileDto` ;
|
|
- `LoggingConsoleDto` ;
|
|
- `LoggingFileDto` ;
|
|
- `LoggingOutputFilterDto` ;
|
|
- `LoggingTargetFilterDto` ;
|
|
- nouvelle commande Tauri centralisée `get_logging_document` ;
|
|
- nouveau domaine technique `config.logging_editor` ;
|
|
- logs bornés aux compteurs/identifiants de structure, sans contenu sensible.
|
|
|
|
### Frontend
|
|
|
|
- la route **Logging** remplace son placeholder par une vue réelle ;
|
|
- nouveau module `frontend/ts/logging.ts` ;
|
|
- affichage read-only de :
|
|
- `file_id` ;
|
|
- path résolu ;
|
|
- `format_version` ;
|
|
- `logs_directory` ;
|
|
- `default_profile` ;
|
|
- sélection locale du profil inspecté ;
|
|
- affichage de `default_filter` et `span_events` ;
|
|
- projection de la console avec son filtre `level/targets/domains` ;
|
|
- projection de tous les fichiers et de leurs filtres ;
|
|
- projection des `target_filters` globaux ;
|
|
- bouton **Rafraîchir** pour relire le contrat typé ;
|
|
- aucune sauvegarde ni mutation dans cette tranche.
|
|
|
|
### Tests
|
|
|
|
- le document Logging commité doit mapper l'intégralité de la surface de lecture attendue ;
|
|
- le getter `LoggingFileConfig::ansi()` est verrouillé dans les tests unitaires et dans le test d'intégration de l'API publique ;
|
|
- les listes multiples `targets` et `domains` doivent être conservées sans perte ni réordonnancement ;
|
|
- les dérivations TS-RS ajoutent les tests d'export des six nouveaux DTO.
|
|
|
|
### Documentation
|
|
|
|
- `pre.013` marquée réalisée ;
|
|
- `pre.014` marquée en cours ;
|
|
- README/USAGE/TODO alignés sur la nouvelle surface Logging read-only.
|
|
|
|
## Hors scope maintenu
|
|
|
|
Cette tranche ne modifie pas :
|
|
|
|
- les profils Logging ;
|
|
- `default_profile` ;
|
|
- les sinks ;
|
|
- les filtres ;
|
|
- le runtime Logging actif ;
|
|
- `LoggingGuard` ;
|
|
- les fichiers de log persistés.
|
|
|
|
Les mutations/persistence appartiennent à `pre.015`; le runtime/hot reload et les fichiers uniques par lancement appartiennent à `pre.016`.
|
|
|
|
## Scénarios de validation
|
|
|
|
1. ouvrir **Logging** : `cfg.std.logging` et son path résolu doivent apparaître ;
|
|
2. vérifier `format_version=1`, `logs_directory=${KSP_LOGS_DIRECTORY:-logs}` et `default_profile=local_dev` ;
|
|
3. le sélecteur doit proposer `local_dev (default)` ;
|
|
4. le profil doit afficher `default_filter=warn` et `span_events=new_and_close` ;
|
|
5. la console doit afficher stderr / ANSI oui / compact / level debug / targets `*` / domains `*` ;
|
|
6. les deux fichiers `file.all.debug` et `file.config.error` doivent être présents avec leurs chemins, formats, rotations et filtres ;
|
|
7. les trois target filters `ksp-config-lib`, `ksp-logging-lib`, `ksp-app-config-desk` doivent apparaître ;
|
|
8. **Rafraîchir** doit relire le document sans modifier le runtime ni la génération Logging.
|
|
|
|
## Version technique
|
|
|
|
```text
|
|
workspace.package.version = "0.1.4-pre.14"
|
|
```
|
|
|
|
## 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 tree -p ksp-app-config-desk
|
|
cargo tauri dev -c crates/ksp-app-config-desk/tauri.conf.json
|
|
```
|