Integração com agentes

O Signals foi feito para ser lido pelos agentes de programação que alteram o seu código. Um agente vê um resumo curto antes de agir, pode ler os grupos sob o caminho em que está trabalhando e pode registrar uma correção. Ele não pode declarar a própria correção como verificada.

A linha de runtime

Quando há grupos ativos sob o caminho em que um agente está trabalhando, uma única linha chega ao contexto dele por meio dos hooks do Pathrule e do pathrule_get_context:

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

Ela traz apenas contagens. As mensagens reportadas nunca trafegam nessa linha.

Lendo os grupos

pathrule_runtime_events é somente leitura. Recebe o espaço de trabalho e, opcionalmente, um group_id, um path, um kind, um environment, um status, um estado de verification, um limit (de 1 a 100, 20 por padrão) e um cursor. Retorna os grupos com a revisão, o estado de verificação e qualquer correção registrada, um cursor para a próxima página e a cobertura.

Tudo o que ele retorna é marcado como observação não confiável. As mensagens de erro e os metadados vêm de uma aplicação em execução, então o agente os trata como dados a investigar, nunca como instruções.

Registrando uma correção

pathrule_runtime_events_resolve registra uma correção vinculada a um grupo. Recebe o group_id, o expected_revision que o agente leu, uma idempotency_key e, opcionalmente, um baseline_release, uma note de até 500 caracteres e até 20 referências de conhecimento. A resposta é recorded, replayed ou refused, com um próximo passo.

Registrar é uma alegação, não uma prova. O grupo continua onde está até que uma release mais nova traga a evidência descrita em verificação e ciclo de vida. O registro de uma correção funciona da mesma forma no Pathrule Local e no Pathrule Cloud.

No terminal

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

pathrule instrument events lista os grupos com os mesmos filtros: --path, --kind error|event, --environment, --status active|declared|resolved|archived, --verification unobserved|observing|quiet|verified|recurred, --group <id>, --limit e --cursor. Adicione --json para usar em scripts.

Configurando o Cloud por meio de um agente

No Pathrule Cloud, um agente pode configurar o Signals para você. pathrule_instrument mostra o status do Signals no espaço de trabalho e um guia de configuração. pathrule_instrument_activate registra o seu consentimento, cria uma chave de projeto e adiciona o SDK ao projeto como um arquivo de código-fonte, então nada é instalado a partir de um registro de pacotes.