GLOSSAIRE — Variables & métriques canoniques (v1.0, PS 5.1)

But
- Standardiser noms, ordre, formats et sémantique des sorties (acceptance/selftest).
- Éviter tout écart de libellé entre outils (comparabilité stricte).

Ligne standard (ordre OBLIGATOIRE)
entries={int}|blocking={int}|ptr_exists={True|False}|ptr_sha_match={True|False}|ptr_entries_note={int}|json_entries={int}

Définitions (sens & source de vérité)
entries (int)            : Nombre d’entrées lues pour le contexte courant.
                           acceptance → snapshot embarqué ([BUG_KB_JSON])
                           selftest   → KB externe (fichier pointé)
blocking (int)           : Nombre d’entrées où "blocking": true (même source que entries).
ptr_exists (bool)        : True si Path du pointeur existe (Test-Path raw OU dequoted OU \?\UNC).
ptr_sha_match (bool)     : True si SHA256(Path) == SHA256 déclaré dans [BUG_KB_JSON_POINTER].
ptr_entries_note (int)   : Valeur "Entries=" déclarée dans [BUG_KB_JSON_POINTER].
json_entries (int)       : Nombre d’entrées calculé à partir du JSON effectivement lu
                           (snapshot pour acceptance, fichier externe pour selftest).
                           Sert de garde-fou de cohérence vs "entries".

Diagnostics selftest (clés additionnelles, affichées sous forme de lignes “diag:”)
diag: First3=..          : Trois premiers octets du BootPack (ex: 5B-42-55 pour “[BU”). Aide BOM/UTF-8.
diag: BootPackPathLength : Longueur du chemin du BootPack (entier).
diag: PtrPathRaw="..."   : Chemin brut issu du pointeur (sans normalisation).
diag: TestPathRaw=bool   : Test-Path du chemin brut.
diag: TestPathDequoted=bool : Test-Path après déquote éventuelle.
diag: TestPathLong=bool  : Test-Path du fallback \?\UNC\…
diag: OpenReadOK=bool    : Lecture stream du chemin pointé possible.
diag: KbSha=HEX64        : SHA256 calculée du fichier KB pointé.
diag: PtrSha=HEX64       : SHA256 attendue (déclarée) dans le pointeur.
diag: PtrEntriesNote=int : Rappel de la valeur Entries du pointeur.

Formats & encodage
- Booléens : True / False (majuscules).
- SHA256   : 64 hex MAJUSCULES (comparaison case-insensitive).
- Fichiers BootPack : UTF-8 sans BOM ; JSON embarqué multi-ligne entre fences ``` ; pas de BOM interne.
- Scripts .ps1      : UTF-8 AVEC BOM ; ASCII-safe ; PS 5.1 strict.

Règles de cohérence (résumées)
- BootPack à jour        : entries=json_entries=E ; ptr_sha_match=True ; ptr_entries_note=E.
- Après ingest non rebuild : acceptance.entries=E0 ; selftest.entries=E1 ; ptr_sha_match=False ; ptr_entries_note=E0.
- Un seul [BUG_KB_JSON] et un seul [BUG_KB_JSON_POINTER] par BootPack.

Exemple (acceptance sur système à jour)
entries=48|blocking=22|ptr_exists=True|ptr_sha_match=True|ptr_entries_note=48|json_entries=48

Version: 1.0 — 2025-11-02