AGNOS est un contrat JSONL d’observabilité pour des agents hétérogènes et un lecteur de référence autonome.
Un producteur conforme, sans dépendance envers le lecteur, peut publier des événements que celui-ci valide et affiche sans connaître son domaine ni son framework. Cette propriété est couverte par une démonstration reproductible et par les tests; ses limites sont consignées dans docs/proof-of-agnosticism.md.
Le lecteur accepte le contrat historique v1 à cinq champs et le contrat v2 à huit champs. V2 conserve les champs v1 et sépare le cycle de vie, la santé technique et le résultat métier. La spécification normative est CONTRACT.md.
AGNOS définit un format d’événements et fournit un lecteur de référence. Il ne suppose aucun framework côté producteur et ne pilote pas les agents observés.
Son périmètre est volontairement étroit : recevoir des événements conformes, les valider, présenter l’état récent des agents et conserver un journal filtrable.
AGNOS n’utilise que la bibliothèque standard Python :
python3 src/agnos_dashboard.py --events-file examples/events_sample.jsonlLe lecteur écoute par défaut sur 127.0.0.1:8767. Le journal demeure exhaustif. Les cartes montrent les agents récents ou explicitement actifs selon la règle de fraîcheur.
Un producteur minimal peut écrire un événement conforme :
python3 examples/reference_producer.py --output-file /tmp/agnos-events.jsonlpython3 -m unittest discover -s tests -vLa gouvernance de preuve du dépôt est décrite dans MANIFEST.md. AGNOS est distribué sous licence MIT.