docs: add coverage reference files and flag architectural drift

These files catalog test coverage for Rust modules across architecture, implementation, and theory sections. They track recent structural changes, flag areas prone to documentation drift, and mandate verification of key parameters and routing logic to maintain alignment with the active codebase.
This commit is contained in:
Eric Coissac
2026-05-23 13:19:31 +02:00
parent b2a52bfb37
commit b7db3a33ed
22 changed files with 335 additions and 0 deletions
+16
View File
@@ -0,0 +1,16 @@
<!-- coverage sidecar — ne pas ajouter au nav mkdocs -->
# Coverage: implementation/mphf.md
## Code couvert
- `obilayeredmap/src/mphf_layer.rs` — type Mphf (PtrHash + CubicEps + CachelineEfVec + Xx64), construction en 2 passes, `build()`, `build_exact_evidence()`, `build_approx_evidence()`, `build_evidence()`
- `obikpartitionner/src/index_layer.rs``build_index_layer()` avec passage de `block_bits`
## Notes
FORT RISQUE DE DÉRIVE. Changements récents :
- `build_exact_evidence(dir, block_bits)``block_bits` maintenant paramétrisé (défaut 0)
- `build_approx_evidence(dir, b, z)` — nouvelle fonction pour l'évidence fingerprint
- `build_evidence(dir, kind, block_bits)` — dispatch selon EvidenceKind
- Construction en 2 phases : pass 1 (Rayon parallèle) + pass 2 (callback `fill_slot`)
Vérifier que la doc décrit correctement les deux nouvelles routes d'évidence et le paramètre `block_bits`.