Auditar sessões anteriores (beta)

Conte quantas vezes o agente fez coisas desnecessárias ou arriscadas em transcrições passadas

Recurso beta. A auditoria é lançada como beta enquanto coletamos feedback inicial. O catálogo de detectores e o formato do relatório podem mudar antes do próximo corte estável. Abra uma issue se algo parecer errado.

A auditoria reproduz suas transcrições passadas do agente-CLI pelo motor de políticas do failproofai e gera um relatório visual e compartilhável na página do dashboard /audit — o arquétipo do seu agente, uma pontuação de 0 a 100 e exatamente quais políticas teriam detectado o quê.

Execute

Três formas de entrar — todas levam ao mesmo relatório /audit.

npx (sem instalação)

npx -y failproofai audit

failproofai audit

failproofai

Sem instalação

npx -y failproofai audit baixa o failproofai, executa a varredura e abre o dashboard para você — sem nada para instalar antes.

Pelo CLI

failproofai audit executa a varredura no seu terminal e abre localhost:8020/audit automaticamente ao terminar.

Pelo dashboard

Execute failproofai e clique em Audit na barra de navegação (entre Policies e Projects), ou abra /audit diretamente.

Execute failproofai audit -h (ou --help) para ver o uso. A auditoria roda totalmente offline — sem necessidade de conta ou rede — e o dashboard continua servindo até você encerrá-lo com Ctrl+C.

O dashboard varre transcrições passadas do agente CLI nesta máquina (Claude Code, Codex, Copilot, Cursor, OpenCode, Pi, Gemini) e reporta com que frequência o agente fez coisas que o failproofai foi criado para impedir — verificações de variáveis de ambiente, force pushes, prefixos redundantes cd <cwd>, loops de sleep-polling, releitura de arquivos recém-editados e mais.

Para cada transcrição, cada evento de uso de ferramenta é reproduzido pelas 39 políticas embutidas e por 8 detectores exclusivos de auditoria que capturam padrões ainda não cobertos pelas políticas em tempo de execução. As contagens são agregadas por política/detector em todas as sessões.

O que você obtém

A página /audit é um pôster de tela única e compartilhável seguido de quatro seções abaixo da dobra:

1. Pôster — a identidade do seu agente de relance: seu arquétipo (um de 8 — optimist, cowboy, explorer, goldfish, paranoid architect, precision builder, hammer, ghost), suas palavras-chave de persona, quão raro é esse arquétipo e uma pontuação de 0 a 100 com uma faixa de nível (de S até bottom tier). Feito para compartilhar — poste no X ou LinkedIn, ou baixe como PNG.
2. // strengths — o que seu agente já faz bem, com números reais da varredura (ex.: % de chamadas de ferramentas limpas, 0 tentativas de push-to-main), exibido apenas onde a política relevante tem um histórico limpo.
3. // quirks — o que escapou: uma tabela classificada de comportamentos que o failproofai teria detectado — quando ocorreu pela última vez, o que escapou (e o embutido que teria bloqueado), sua gravidade e com que frequência foi visto (new / recurring / N× seen).
4. // how to improve — a lista de correções prescritas: uma linha por política com um failproofai policy add <slug> para copiar e colar, além de um botão install all que ativa todas as recomendações de uma vez e mostra sua pontuação projetada caso você o faça.
5. // come back better — crie o hábito: configure um lembrete de reauditoria por e-mail (3d / 7d / 14d / 30d) ou faça uma reauditoria agora, e convide um amigo para executar sua própria auditoria (enviado pelo failproof.ai, com cópia para você). Lembretes e convites exigem login — veja failproofai auth.

Detectores exclusivos de auditoria

Estes detectam padrões de “comportamento ineficiente” que ainda não são aplicados em tempo real. Eles rodam apenas durante a auditoria e nunca bloqueiam uma chamada de ferramenta ao vivo.

Detector	O que conta
redundant-cd-cwd	Comandos Bash começando com cd <cwd> && … mesmo que os comandos já rodem em cwd.
prefer-edit-over-read-cat	cat/head/tail/less/more em um único arquivo-fonte — use a ferramenta Read.
prefer-edit-over-sed-awk	Edições no lugar com sed -i / awk … > file — use a ferramenta Edit.
prefer-write-over-heredoc	Heredoc / echo > file multilinha para escrever arquivos — use a ferramenta Write.
sleep-polling-loop	sleep N longo (≥ 30s) ou loops de polling while …; sleep …; done.
find-from-root	find /, find /home, find /usr, etc. — limite ao cwd.
git-commit-no-verify	git commit … --no-verify / -n, ignorando hooks.
reread-after-edit	Read de um arquivo que acabou de ser Edit/Write na mesma sessão.

Caches

• Cache por transcrição em ~/.failproofai/cache/audit/<sha1>.json com chave por (mtime, size, engineVersion, detectorVersion) — invalida automaticamente quando a transcrição ou o código de política/detector muda. Cada entrada também armazena um timestamp cachedAt como metadado TTL (não faz parte da chave de cache); entradas mais antigas que 7 dias são rejeitadas na leitura para que resultados de longa data não sobrevivam à evolução da intenção dos detectores.
• Cache de resultado completo em ~/.failproofai/audit-dashboard.json (modo 0600). Permite que o dashboard renderize instantaneamente na navegação sem re-executar. Também rejeitado na leitura após o TTL de 7 dias — /audit então cai em seu estado vazio e solicita uma nova execução. Clique em [ re-audit now ] perto do final do relatório para atualizar — a reauditoria envia noCache: true, ignorando o cache por transcrição e revarrendo todas as transcrições em vez de retornar o resultado em cache; a execução transmite o progresso via uma faixa fixa no topo e substitui o resultado no lugar ao terminar com sucesso (sem recarregamento de página; uma reauditoria com falha mantém o relatório anterior).

Observações

• Sem mutação. A auditoria é reproduzida em modo somente leitura. warn-repeated-tool-calls é ignorado porque seu sidecar por sessão seria modificado de outra forma.
• Políticas de fluxo de trabalho ignoradas. As políticas require-*-before-stop disparam apenas em eventos Stop e execSync contra o estado git ao vivo — elas não têm uma interpretação significativa de “o que teria acontecido em 2025”, portanto não aparecem nas contagens de auditoria.
• Políticas personalizadas ignoradas. Hooks personalizados fornecidos pelo usuário não são reproduzidos (eles podem ter mudado desde a sessão original).