Histórico e gravação

Para que serve

Depois de um dia com vários agentes, você vai querer saber o que pediu para o Codex, a que horas a análise terminou ou o que foi gravado no CLAUDE.md. O PrumoGrid guarda essas respostas em lugares diferentes, cada um para uma pergunta:

Quando usar e quando não usar

Use o histórico para reconstruir o que aconteceu: retomar no dia seguinte, entender por que uma etapa não avançou, mostrar a outra pessoa o que foi pedido e o que foi observado.

Não use o histórico, nem a rolagem dos terminais, como cópia de segurança. Ele guarda fatos e recibos dentro de limites; os arquivos do projeto ficam no Git e no disco. Para compartilhar evidência, prefira Copiar resultado numa etapa, o registro em texto ou uma captura revisada.

Passo a passo

O exemplo usa a loja-api depois do conserto do cupom PRIMEIRA, com três etapas: análise, correção e revisão.

Achar uma instrução enviada

1. Na aba Etapas, veja Instruções enviadas · N e clique em Ver todas. O mesmo diálogo abre por Ferramentas → Instruções enviadas…, pela paleta ou com Ctrl+Shift+I.
2. Filtre por Projeto e por Terminal, por exemplo o terminal do Codex.
3. Em Buscar no texto enviado, digite ANALISE.md. Aparece a instrução da etapa de correção. Como a etapa tinha papel, o texto começa com "Seu papel nesta etapa é: implementador…", que é o que o PrumoGrid acrescenta antes do seu pedido.
4. Clique em Ir ao ponto para ver a instrução no terminal, no lugar em que ela foi entregue, ou em Copiar para levar o texto.
5. Se a lista for longa, Carregar mais traz as anteriores.

Só entram aqui as instruções que o PrumoGrid entregou, como as de etapas. Comandos que você digita à mão no PowerShell ou no CMD não contam. Se o terminal foi encerrado, o texto continua na lista; o diálogo avisa quando a posição dele não está mais disponível na conversa.

Ler o que aconteceu

1. Com o projeto selecionado, abra a aba Etapas e expanda REGISTRO: o que aconteceu. O título mostra quantos registros há.
2. No topo, um resumo conta as etapas no plano, quantas têm critério, quantas foram aprovadas por comando e quantas ficaram prontas pelo aviso do agente.
3. Abaixo, leia as linhas com horário, em ordem. Por exemplo: Codex CLI terminou o turno: etapa "Leia ANALISE.md…" sinalizada, seguida de verificação "conclusão da etapa": aprovado(exit 0). Também aparecem esperas, como uma entrega que aguarda você responder uma pergunta na tela do agente.
4. Copiar registro copia a lista em texto, para anexar a um relato.
5. Numa etapa, use Ver conclusão para ver o que foi digitado no terminal, quando, e a evidência de conclusão observada.
6. No Fluxo, o acompanhamento da etapa mostra o mesmo histórico do ponto de vista dela.

Leia o registro antes de concluir o que houve. "O agente avisou que terminou" e "a verificação aprovou" são linhas diferentes, e só a segunda passou por um comando.

Ver o que foi gravado nos arquivos dos agentes

No registro, linhas como regras gravadas em 1 arquivo trazem o botão Ver gravação. Ele abre o recibo do que foi escrito no arquivo de regras de cada agente: os caminhos, os arquivos, as cópias e as falhas. Não é um vídeo do terminal. Também é diferente de Gravação nos projetos, que é a permissão, pasta por pasta, para o PrumoGrid gravar o bloco de orientações no CLAUDE.md ou no AGENTS.md (veja Regras).

Limpar registros anteriores

Com o tempo a lista cresce. Para começar o dia com ela curta:

1. Selecione um projeto. Em Todos os projetos, o controle pede para escolher um projeto antes.
2. Clique em Limpar registros anteriores. A explicação diz que a limpeza vale para os registros anteriores daquele projeto, em Fluxo e Etapas, e que etapas e pendências são preservadas.
3. Aguarde o aviso Registros anteriores ocultados neste projeto. Se a gravação falhar, o aviso diz que a lista foi preservada, e ela não aparece como limpa.

Limpar oculta. Não exclui etapas, não apaga as evidências usadas para decidir conclusões, não encerra sessões e não remove os arquivos originais do histórico. O corte continua valendo ao reabrir o aplicativo, e eventos novos voltam a aparecer. Nesta versão não há um botão para reexibir o que foi ocultado.

Etapas de sessões encerradas

Quando um terminal é encerrado, as etapas dele saem da lista padrão e do Fluxo ativo. Para lê-las, use Ver etapas de sessões encerradas (N) e, na aba Etapas, o filtro Resultados. Ocultar etapas de sessões encerradas volta à lista normal. Uma desconexão temporária do serviço de terminais não conta como encerramento.

O que aparece na tela

Ampliar captura ↗

Quanto fica guardado

A rolagem do terminal serve para você subir e ler o que passou. Ela não é backup, e o que sai do limite de linhas não volta.

O log do serviço

O serviço de terminais grava um log em %TEMP%\terminal-grid-daemon.log. Cada arquivo tem teto de 50 MB, e são guardados no máximo três: terminal-grid-daemon.log, terminal-grid-daemon.log.1 e terminal-grid-daemon.log.2. Ao passar do teto, o mais antigo é descartado. Para abrir a pasta no PowerShell:

explorer $env:TEMP

Como relatar um problema

Junte o que permite reproduzir:

• A ação que você fez e o que esperava.
• O nome do projeto, o shell e o agente, e se era Windows ou WSL.
• A mensagem exata, copiada da tela, e o horário.
• Se envolve uma etapa, Copiar resultado na etapa e Copiar registro no REGISTRO: o que aconteceu, com as linhas daquele horário.
• Se envolve o serviço de terminais, o trecho do terminal-grid-daemon.log perto do horário.

Revise capturas, trechos de terminal e o log antes de mandar. Eles podem ter caminhos, nomes de clientes ou chaves que não devem sair da sua máquina. Para outros sintomas, veja Solução de problemas.

Dicas

• Antes de repetir uma etapa que parece não ter começado, procure a instrução em Instruções enviadas. Se ela foi entregue, retome a existente em vez de criar outra.
• Limpe os registros no começo de uma tarefa nova no projeto. Fica mais fácil ler só o que aconteceu dali em diante.
• Se você precisa guardar uma saída longa de terminal, salve num arquivo (npm test > saida.txt) em vez de contar com a rolagem.

Limites conhecidos

• O registro guarda até 2.000 eventos; as instruções enviadas, até 10.000.
• Limpar registros anteriores é por projeto e não tem reexibição nesta versão.
• Ver gravação é um recibo de arquivos, não uma gravação de tela.
• Histórico e rolagem não substituem cópia de segurança dos arquivos do projeto.