v0.1.4-pre.002

crates/ksp-config-lib/USAGE.md

@@ -1,5 +1,5 @@
 <!-- file: crates/ksp-config-lib/USAGE.md -->
-<!-- version: 2 -->
+<!-- version: 3 -->
 
 # Utilisation de ksp-config-lib
 
@@ -33,6 +33,22 @@ Les arguments compris par Config sont :
 
 `cfgpath` et `schemapath` ne sont jamais lus depuis JSON, `.env` ou une variable KSP : cette règle évite un bootstrap récursif.
 
+### 1.1 Inventorier les fichiers enregistrés
+
+Le registre expose une vue read-only déterministe des descripteurs connus :
+
+```rust
+for descriptor in registry.descriptors() {
+    let file_id = descriptor.file_id().as_str();
+    let kind = descriptor.kind();
+    let filename = descriptor.filename();
+    let schema_file_id = descriptor.schema_file_id();
+    let _ = (file_id, kind, filename, schema_file_id);
+}
+```
+
+L'ordre est celui des `file_id`. La vue reflète les éventuels overrides `--filemap` déjà appliqués tout en conservant le kind et l'association de schema. Elle permet notamment à une application de management de construire sa liste de documents/schemas sans dupliquer le registre dans sa propre couche.
+
 ## 2. Charger et valider un document connu
 
 Les consumers utilisent un `file_id` logique :