Integración con agentes

Signals está pensado para que lo lean los agentes de programación que modifican tu código. Un agente ve un breve resumen antes de actuar, puede leer los grupos bajo la ruta en la que trabaja y puede registrar una corrección. Lo que no puede es declarar verificada su propia corrección.

La línea de ejecución

Cuando hay grupos activos bajo la ruta en la que trabaja un agente, una sola línea llega a su contexto a través de los hooks de Pathrule y de pathrule_get_context:

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

Solo incluye recuentos. Los mensajes reportados nunca viajan en esta línea.

Leer grupos

pathrule_runtime_events es de solo lectura. Recibe el espacio de trabajo y, de forma opcional, un group_id, una path, un kind, un environment, un status, un estado de verification, un limit (de 1 a 100, 20 por defecto) y un cursor. Devuelve los grupos con su revisión, su estado de verificación y cualquier corrección registrada, un cursor para la página siguiente y la cobertura.

Todo lo que devuelve se marca como observación no confiable. Los mensajes de error y los metadatos provienen de una aplicación en ejecución, así que el agente los trata como datos que debe investigar, nunca como instrucciones.

Registrar una corrección

pathrule_runtime_events_resolve registra una corrección contra un grupo. Recibe el group_id, la expected_revision que leyó el agente, una idempotency_key y, de forma opcional, un baseline_release, una note de hasta 500 caracteres y hasta 20 referencias de conocimiento. Responde recorded, replayed o refused, junto con un siguiente paso.

Registrar es una afirmación, no una prueba. El grupo se queda donde está hasta que una versión más reciente aporte la evidencia que se describe en verificación y ciclo de vida. Registrar una corrección funciona igual en Pathrule Local y en Pathrule Cloud.

En una terminal

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

pathrule instrument events lista los grupos con los mismos filtros: --path, --kind error|event, --environment, --status active|declared|resolved|archived, --verification unobserved|observing|quiet|verified|recurred, --group <id>, --limit y --cursor. Agrega --json para usarlo en scripts.

Configurar Cloud mediante un agente

En Pathrule Cloud, un agente puede configurar Signals por ti. pathrule_instrument muestra el estado de Signals del espacio de trabajo y una guía de configuración. pathrule_instrument_activate registra tu consentimiento, crea una clave de proyecto y agrega el SDK al proyecto como un archivo de código fuente, de modo que no se instala nada desde un registro de paquetes.