Skip to main content
Funzione beta. L’audit è fornito in beta mentre raccogliamo i primi feedback. Il catalogo dei rilevatori e il formato del report potrebbero cambiare prima della prossima versione stabile. Apri un issue se qualcosa non ti sembra giusto.
L’audit riesegue i tuoi transcript passati da agent-CLI attraverso il motore di policy di failproofai e genera un report visivo e condivisibile sulla pagina dashboard /audit — l’archetipo dell’agente, un punteggio 0–100, e esattamente quali policy avrebbero catturato cosa.

​
Eseguirlo

Tre modi per iniziare — tutti portano allo stesso report /audit.

Nessuna installazione

npx -y failproofai audit scarica failproofai, esegue la scansione e apre il dashboard per te — niente da installare prima.

Dalla CLI

failproofai audit esegue la scansione nel tuo terminale, poi apre automaticamente localhost:8020/audit quando termina.

Dal dashboard

Esegui failproofai e clicca Audit nella navbar (tra Policies e Projects), oppure apri /audit direttamente.
Esegui failproofai audit -h (o --help) per vedere l’utilizzo. L’audit funziona completamente offline — nessun account o connessione di rete richiesti — e il dashboard continua a servire finché non lo arresti con Ctrl+C.
Il dashboard scansiona i transcript passati da agent CLI su questa macchina (Claude Code, Codex, Copilot, Cursor, OpenCode, Pi) e segnala con che frequenza l’agente ha fatto cose che failproofai è costruito per bloccare — controlli di variabili d’ambiente, push forzati, prefissi cd <cwd> ridondanti, loop di polling con sleep, ri-letture di file appena modificati, e altro. Per ogni transcript, ogni evento tool-use viene rieseguito attraverso le 39 policy integrate e attraverso 8 rilevatori solo audit che catturano pattern non ancora coperti da policy runtime. I conteggi vengono aggregati per policy / rilevatore in tutte le sessioni.

​
Cosa ottieni

La pagina /audit è un poster a schermo intero e condivisibile seguito da quattro sezioni sotto il fold:
  1. Poster — l’identità del tuo agente a colpo d’occhio: il suo archetipo (uno tra 8 — optimist, cowboy, explorer, goldfish, paranoid architect, precision builder, hammer, ghost), le sue parole chiave di persona, quanto raro è quell’archetipo, e un punteggio 0–100 con una fascia di livello (S fino a bottom tier). Costruito per condividere — pubblica su X o LinkedIn, o scaricalo come PNG.
  2. // strengths — cosa fa già bene il tuo agente, come numeri reali dalla scansione (es. clean-tool-call %, 0 tentativi push-to-main), mostrato solo dove la policy rilevante ha un record pulito.
  3. // quirks — cosa è sfuggito: una tabella ordinata di comportamenti che failproofai avrebbe catturato — quando è successo per ultimo, cosa è sfuggito (e il builtin che l’avrebbe bloccato), la sua severity, e quante volte è stato visto (new / recurring / N× seen).
  4. // how to improve — la lista di correzioni prescritte: una riga per policy con un failproofai policy add <slug> pronto da copiare-incollare, più un pulsante install all che abilita tutti i consigli contemporaneamente e mostra il tuo punteggio previsto se lo facessi.
  5. // come back better — costruisci l’abitudine: imposta un reminder email di re-audit (3d / 7d / 14d / 30d) o re-audit ora, e invita un amico a eseguire il loro audit (inviato da failproof.ai, Cc a te). I reminder e gli inviti richiedono login — vedi failproofai auth.

​
Rilevatori solo audit

Questi rilevano pattern di “comportamento stupido” non (ancora) forzati in tempo reale. Funzionano solo durante l’audit e non bloccano mai una chiamata tool in diretta.

​
Cache

  • Cache per-transcript in ~/.failproofai/cache/audit/<sha1>.json indicizzata da (mtime, size, engineVersion, detectorVersion) — invalida automaticamente quando il transcript o il codice della policy/rilevatore cambia. Ogni voce memorizza anche un timestamp cachedAt come metadati TTL (non parte della chiave cache); le voci più vecchie di 7 giorni vengono rifiutate alla lettura così i risultati di lunga durata non sopravvivono all’intento rilevatore in evoluzione.
  • Cache di risultato intero in ~/.failproofai/audit-dashboard.json (modalità 0600). Permette al dashboard di renderizzarsi istantaneamente sulla navigazione senza rieseguire. Anche rifiutato alla lettura passato il TTL di 7 giorni — /audit cade quindi nel suo stato vuoto e richiede un’esecuzione fresca. Clicca [ re-audit now ] vicino al fondo del report per aggiornare — re-audit invia noCache: true, quindi bypassa la cache per-transcript e riscansiona ogni transcript invece di restituire il risultato cache; l’esecuzione trasmette il progresso via una striscia appiccicosa in alto e scambia il risultato in posizione al successo (nessun reload della pagina; un re-audit fallito mantiene il report precedente).

​
Note

  • Nessuna mutazione. L’audit riesegue in modalità sola lettura. warn-repeated-tool-calls viene saltato perché il suo sidecar per-sessione verrebbe altrimenti modificato.
  • Policy di workflow saltate. Le policy require-*-before-stop si attivano solo su eventi Stop e execSync contro lo stato git in diretta — non hanno un’interpretazione significativa “cosa sarebbe successo nel 2025”, quindi non compaiono nei conteggi audit.
  • Policy personalizzate saltate. Gli hook personalizzati forniti dall’utente non vengono rieseguiti (potrebbero essere cambiati dalla sessione originale).