Q-Metrics
Q-Metrics est une couche de métriques dérivées de Q-Ledger, conçue pour rendre mesurables des signaux de découvrabilité, de stabilité et de continuité autour des entrypoints de gouvernance.
Avertissement : non-normatif, descriptif.
Ces métriques décrivent un état observé. Elles ne constituent ni une preuve de conformité, ni une attestation, ni une certification.
Pourquoi
Publier des fichiers de gouvernance ne suffit pas. L’enjeu opérationnel est de savoir si ces artefacts sont effectivement découverts, consultés et maintenus de façon stable dans le temps. Q-Metrics vise à condenser ces signaux sous forme d’indicateurs comparables d’un snapshot à l’autre.
Entrypoints (machine-first)
JSON : /.well-known/q-metrics.json
YAML : /.well-known/q-metrics.yml
Résumé 7 jours (fenêtre glissante)
Q-Metrics peut exposer un résumé sur 7 jours (ou toute fenêtre définie), afin de suivre l’évolution des signaux dans le temps. Les trois familles d’indicateurs ci-dessous constituent le noyau d’interprétation minimal.
1) Entrypoint compliance
Mesure la proportion d’entrypoints attendus qui ont été observés comme consultés (ex. statuts 200/304) dans la fenêtre considérée.
2) Escape rate
Mesure la proportion d’observations qui « sortent » des entrypoints attendus (navigation inattendue, chemins non prévus, erreurs ou dérive). Un taux élevé peut indiquer une exploration agentique, un problème de maillage, ou une instabilité d’accès.
3) Sequence fidelity
Mesure la cohérence de la continuité entre snapshots (chaînage, absence de ruptures, progression attendue). Une baisse peut signaler un gap d’archive, un reset, ou une dérive de publication.
Comment lire ces métriques
- Une hausse de la compliance est un signal de découvrabilité et d’accès effectif aux entrypoints.
- Une hausse de l’escape rate peut indiquer une exploration au-delà des entrypoints, une redirection involontaire, un effet cache, ou une instabilité d’indexation.
- Une baisse de la sequence fidelity est un signal de rupture de continuité (ou d’archive manquante), à investiguer avant toute interprétation.
Limites
- Q-Metrics hérite des biais de Q-Ledger (visibilité edge, cache, restrictions, échantillonnage).
- Les métriques ne remplacent pas une attestation cryptographique.
- Un signal n’est pas une preuve : il doit être interprété dans son régime (validation, exploration, mixte) et dans sa fenêtre temporelle.
Liens
- Q-Ledger (format et observation) : /doctrine/q-layer/q-ledger/
- Code et format : github.com/GautierDorval/q-ledger
- Archive des snapshots : github.com/GautierDorval/q-ledger-archive