Agent-Integration

Signals ist dafür gebaut, von den Coding-Agents gelesen zu werden, die deinen Code verändern. Ein Agent sieht eine kurze Zusammenfassung, bevor er handelt, kann die Gruppen unter dem Pfad lesen, an dem er gerade arbeitet, und kann einen Fix erfassen. Seinen eigenen Fix für verifiziert erklären kann er nicht.

Die Runtime-Zeile

Gibt es unter dem Pfad, an dem ein Agent arbeitet, aktive Gruppen, gelangt über Pathrules Hooks und pathrule_get_context eine einzelne Zeile in seinen Kontext:

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

Sie enthält nur Anzahlen. Die gemeldeten Nachrichten selbst landen nie in dieser Zeile.

Gruppen lesen

pathrule_runtime_events ist rein lesend. Es erwartet den Workspace und optional eine group_id, einen path, eine kind, ein environment, einen status, einen verification-Status, ein limit (1 bis 100, standardmäßig 20) und einen cursor. Zurück kommen die Gruppen mit ihrer Revision, ihrem Verifizierungsstatus und einer eventuell erfassten Korrektur, ein Cursor für die nächste Seite sowie die Abdeckung.

Alles, was das Tool zurückgibt, ist als nicht vertrauenswürdige Beobachtung gekennzeichnet. Fehlermeldungen und Metadaten stammen aus einer laufenden App, deshalb behandelt ein Agent sie als Daten, die es zu untersuchen gilt, niemals als Anweisungen.

Einen Fix erfassen

pathrule_runtime_events_resolve erfasst eine Korrektur gegen eine Gruppe. Es erwartet die group_id, die expected_revision, die der Agent gelesen hat, einen idempotency_key und optional ein baseline_release, eine note mit bis zu 500 Zeichen sowie bis zu 20 Wissensverweise. Die Antwort lautet recorded, replayed oder refused, jeweils mit einem nächsten Schritt.

Das Erfassen ist eine Behauptung, kein Beweis. Die Gruppe bleibt, wo sie ist, bis ein neueres Release die Belege liefert, die unter Verifizierung und Lebenszyklus beschrieben sind. Das Erfassen eines Fixes funktioniert in Pathrule Local und auf Pathrule Cloud gleich.

Im Terminal

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

pathrule instrument events listet Gruppen mit denselben Filtern auf: --path, --kind error|event, --environment, --status active|declared|resolved|archived, --verification unobserved|observing|quiet|verified|recurred, --group <id>, --limit und --cursor. Für Skripte hängst du --json an.

Cloud über einen Agent einrichten

Auf Pathrule Cloud kann ein Agent Signals für dich einrichten. pathrule_instrument zeigt den Signals-Status des Workspaces und eine Einrichtungsanleitung. pathrule_instrument_activate erfasst deine Einwilligung, erstellt einen Projektschlüssel und fügt das SDK als Quelldatei zum Projekt hinzu, sodass nichts aus einer Paket-Registry installiert wird.