Publier des fichiers de gouvernance est nécessaire, mais insuffisant. L’enjeu opérationnel est simple : ces artefacts sont-ils réellement découverts, consultés et maintenus de façon stable dans le temps ?
Q-Metrics est une couche de métriques dérivées de Q-Ledger. Elle vise à rendre lisibles des signaux de découvrabilité, de dérive et de continuité, sous une forme comparable d’un snapshot à l’autre.
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.
Du fichier statique au signal observable
Un fichier publié peut exister sans être consulté. Un endpoint peut être présent sans être découvert. Une gouvernance peut être déclarée sans être “lue” dans la pratique. Q-Metrics sert à mesurer ce décalage, en s’appuyant sur un journal d’observation (Q-Ledger).
Trois familles d’indicateurs (noyau minimal)
1) Entrypoint compliance
Mesure la proportion d’entrypoints attendus observés comme consultés (ex. statuts 200/304) dans une fenêtre donnée. C’est un signal de découvrabilité effective.
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, une instabilité d’accès, ou un maillage/redirects problématiques.
3) Sequence fidelity
Mesure la cohérence de 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 sans surinterpréter
- Compliance en hausse : signal de découvrabilité et d’accès effectif aux entrypoints.
- Escape en hausse : signal d’exploration, d’instabilité ou de dérive (à qualifier avant conclusion).
- Fidelity en baisse : signal de rupture de continuité (ou d’archive manquante) à investiguer.
Un signal n’est pas une preuve. La lecture doit tenir compte du régime d’observation (validation, exploration, mixte) et de la fenêtre temporelle.
Ce que Q-Metrics ne remplace pas
- Une attestation cryptographique.
- Une preuve de conformité ou de responsabilité.
- Une garantie d’exhaustivité (hérite des biais de collecte).
Ressources
- Q-Metrics : /doctrine/q-layer/q-metrics/
- Q-Ledger : /doctrine/q-layer/q-ledger/
- Archive des snapshots : github.com/GautierDorval/q-ledger-archive
- Outils et format : github.com/GautierDorval/q-ledger