Observations (baseline) : Q-Ledger & Q-Metrics

Observations (baseline) : Q-Ledger & Q-Metrics

Cette page documente un baseline d’observation dérivé de Q-Ledger et de Q-Metrics, à partir de snapshots archivés. Elle sert de référence descriptive pour comprendre ce qui a été observé, dans quelles fenêtres, et avec quelles limites.

Portée : observation, pas attestation.
Cette page ne prouve ni identité, ni paternité, ni intention, ni conformité. Elle décrit des artefacts dérivés et leurs signaux, tels qu’archivés.

Entrypoints (machine-first)

Q-Ledger :
/.well-known/q-ledger.json · /.well-known/q-ledger.yml

Q-Metrics :
/.well-known/q-metrics.json · /.well-known/q-metrics.yml

Pages doctrinales associées :
Q-Ledger · Q-Metrics ·

Archive (audit surface)

Les snapshots sont archivés dans un dépôt distinct, afin de conserver une timeline immuable et de réduire les modifications silencieuses :

• Archive des snapshots : github.com/GautierDorval/q-ledger-archive
• Outils et format : github.com/GautierDorval/q-ledger

Index machine-first (manifest) :
Le dépôt d’archive expose un archive-manifest.json listant les snapshots, leurs dates, séquences et chemins canoniques.

Couverture du baseline

Fenêtre (UTC) : 2026-01-19 → 2026-02-06
Jours distincts : 17
Snapshots (séquences) : 22
Q-Metrics disponibles : 11

Note : ce baseline reflète un démarrage d’instrumentation. Les premières séquences publient Q-Ledger, puis la couche Q-Metrics apparaît une fois le pipeline stabilisé.

Timeline et séquences

Les snapshots sont organisés par date (UTC) et par ledger_sequence (seqNN). Cette séquence sert d’index ordonné des runs d’observation.

Plage observée : seq02 → seq25
Gaps observés (séquences manquantes) : seq11, seq13

Un gap signifie « snapshot non archivé » ou « run manquant ». Ce n’est pas, à lui seul, une preuve de falsification. Cependant, lorsqu’un champ de chaînage pointe vers une séquence absente, la continuité devient partiellement non vérifiable.

Régimes observés

Une partie des séquences contient des tags de régime (ex. validation, exploration, mixte). Ces tags aident à éviter une lecture naïve des signaux : un même indicateur n’a pas le même sens en validation qu’en exploration.

• validation_ingestion : 14 séquences (sessions agrégées : 590)
• exploration_navigation : 3 séquences (sessions agrégées : 518)
• mixed : 2 séquences (sessions agrégées : 70)

Lecture minimale :
En validation, on s’attend à des revisites d’entrypoints et à des patterns de “vérification”. En exploration, on s’attend à des chemins plus diversifiés et à davantage de sorties d’entrypoints.

Signaux de lecture (Q-Metrics)

Lorsque Q-Metrics est présent, trois familles structurent la lecture minimale :

1) Entrypoint compliance

Proportion d’entrypoints attendus observés comme consultés (ex. 200/304) dans une fenêtre définie. Signal de découvrabilité effective.

2) Escape rate

Proportion d’observations sortant des entrypoints attendus (navigation inattendue, erreurs, dérive). Peut indiquer exploration agentique, instabilité d’accès, ou dérive de publication/maillage.

3) Sequence fidelity

Cohérence de continuité entre snapshots : chaînage, absence de ruptures, progression attendue. Une baisse signale un gap, un reset, ou une dérive.

Avertissement : ces signaux sont descriptifs. Ils ne sont ni normatifs, ni prescriptifs, ni attestatifs.

Intégrité et chaînage

Q-Ledger est conçu pour rendre les changements silencieux plus détectables via un chaînage entre snapshots :

• ledger_hash_sha256 (ou équivalent) : empreinte du snapshot courant
• previous_ledger_hash_sha256 : lien vers le snapshot précédent

L’archive immuable ajoute une contrainte externe : un snapshot publié et archivé devient plus difficile à réécrire sans laisser de trace.

Limites et biais

• Les observations dépendent de la visibilité edge (cache, restrictions, filtrage, variations d’agents).
• Le silence n’implique pas l’absence : un endpoint peut exister sans être observé dans une fenêtre donnée.
• Une métrique est un signal, pas une preuve : interprétation conditionnelle au régime et à la fenêtre.

Ressources

• Q-Ledger (doctrine) : /doctrine/q-layer/q-ledger/
• Q-Metrics (doctrine) : /doctrine/q-layer/q-metrics/
• Repo tooling : github.com/GautierDorval/q-ledger
• Repo archive : github.com/GautierDorval/q-ledger-archive

Voir aussi

• Q-Ledger
• Q-Metrics
• Doctrine