Integrazione con gli agenti

Signals è pensato per essere letto dagli agenti di programmazione che modificano il tuo codice. Prima di agire, un agente vede un breve riepilogo, può leggere i gruppi sotto il percorso su cui sta lavorando e può registrare una correzione. Non può però dichiarare verificata la propria correzione.

La riga runtime

Quando sotto il percorso su cui lavora un agente ci sono gruppi attivi, una singola riga arriva nel suo contesto tramite gli hook di Pathrule e pathrule_get_context:

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

Contiene solo conteggi. I messaggi segnalati non viaggiano mai in questa riga.

Leggere i gruppi

pathrule_runtime_events è di sola lettura. Accetta il workspace e, facoltativamente, un group_id, un path, un kind, un environment, uno status, uno stato di verification, un limit (da 1 a 100, 20 per impostazione predefinita) e un cursor. Restituisce i gruppi con la loro revisione, lo stato di verifica e l'eventuale correzione registrata, un cursore per la pagina successiva e la copertura.

Tutto ciò che restituisce è contrassegnato come osservazione non attendibile. I messaggi di errore e i metadati provengono da un'applicazione in esecuzione, quindi un agente li tratta come dati da analizzare, mai come istruzioni.

Registrare una correzione

pathrule_runtime_events_resolve registra una correzione per un gruppo. Accetta il group_id, la expected_revision letta dall'agente, una idempotency_key e, facoltativamente, una baseline_release, una note di massimo 500 caratteri e fino a 20 riferimenti alla conoscenza. Risponde recorded, replayed o refused, indicando il passo successivo.

La registrazione è una dichiarazione, non una prova. Il gruppo resta dov'è finché una release più recente non porta le evidenze descritte in verifica e ciclo di vita. La registrazione di una correzione funziona allo stesso modo in Pathrule Local e su Pathrule Cloud.

Nel terminale

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

pathrule instrument events elenca i gruppi con gli stessi filtri: --path, --kind error|event, --environment, --status active|declared|resolved|archived, --verification unobserved|observing|quiet|verified|recurred, --group <id>, --limit e --cursor. Aggiungi --json per gli script.

Configurare Cloud tramite un agente

Su Pathrule Cloud un agente può configurare Signals al posto tuo. pathrule_instrument mostra lo stato di Signals nel workspace e una guida alla configurazione. pathrule_instrument_activate registra il tuo consenso, crea una chiave di progetto e aggiunge l'SDK al progetto come file sorgente, quindi non viene installato nulla da un registro di pacchetti.