Intégration avec les agents

Signals est conçu pour être lu par les agents de codage qui modifient votre code. Un agent voit un bref résumé avant d'agir, peut lire les groupes situés sous le chemin sur lequel il travaille et peut enregistrer un correctif. Il ne peut pas déclarer lui-même son correctif comme vérifié.

La ligne runtime

Lorsque des groupes actifs existent sous le chemin sur lequel travaille un agent, une seule ligne parvient dans son contexte via les hooks de Pathrule et pathrule_get_context :

Runtime: 2 active issues under apps/web/checkout (1 came back after a fix). Inspect with pathrule_runtime_events.

Elle ne contient que des décomptes. Les messages remontés ne transitent jamais par cette ligne.

Lire les groupes

pathrule_runtime_events est en lecture seule. Il prend en paramètre l'espace de travail et, de façon facultative, un group_id, un path, un kind, un environment, un status, un état verification, une limit (de 1 à 100, 20 par défaut) et un cursor. Il renvoie les groupes avec leur révision, leur état de vérification et toute correction enregistrée, un curseur pour la page suivante, ainsi que la couverture.

Tout ce qu'il renvoie est marqué comme observation non fiable. Les messages d'erreur et les métadonnées proviennent d'une application en cours d'exécution : un agent les traite donc comme des données à examiner, jamais comme des instructions.

Enregistrer un correctif

pathrule_runtime_events_resolve enregistre une correction sur un groupe. Il prend le group_id, la expected_revision lue par l'agent, une idempotency_key et, de façon facultative, une baseline_release, une note de 500 caractères au maximum et jusqu'à 20 références de connaissances. Il répond recorded, replayed ou refused, avec une étape suivante.

Enregistrer un correctif est une affirmation, pas une preuve. Le groupe reste dans son état jusqu'à ce qu'une version plus récente apporte les éléments décrits dans vérification et cycle de vie. L'enregistrement d'un correctif fonctionne de la même façon dans Pathrule Local et sur Pathrule Cloud.

Dans un terminal

pathrule instrument events --path apps/web/checkout --verification recurred

pathrule instrument events liste les groupes avec les mêmes filtres : --path, --kind error|event, --environment, --status active|declared|resolved|archived, --verification unobserved|observing|quiet|verified|recurred, --group <id>, --limit et --cursor. Ajoutez --json pour vos scripts.

Configurer Cloud via un agent

Sur Pathrule Cloud, un agent peut configurer Signals à votre place. pathrule_instrument affiche le statut Signals de l'espace de travail et un guide de configuration. pathrule_instrument_activate enregistre votre consentement, crée une clé de projet et ajoute le SDK au projet sous forme de fichier source : rien n'est installé depuis un registre de paquets.