# pi-loop

Extensão global do Pi para supervisão contínua, limitada e persistida na sessão.

```text
/loop start --every 10m --for 4h --max-iterations 20 Verifique se o CI terminou
/loop start --every auto --min-delay 1m --max-delay 1h Acompanhe a publicação
/loop status
/loop pause
/loop resume
/loop update --for 8h --max-iterations 40
/loop stop
```

Cada iteração deve terminar com `loop_control`. O prazo é de calendário e continua correndo durante pausas e com a sessão fechada. O loop não substitui a observação nativa de processos em background iniciados pelo próprio agente.

Eventos que requerem atenção podem executar um arquivo configurado em `~/.pi/agent/loop.json`:

```json
{ "onAttention": "/caminho/absoluto/para/script" }
```

O arquivo recebe JSON no stdin, é executado diretamente (sem shell) e não interfere no estado caso falhe.