failproofai 1.0.1-beta.0 → 1.0.1

package/.next/standalone/docs-old/it/cli/audit.mdx

@@ -0,0 +1,126 @@
+---
+title: Audit delle sessioni passate (beta)
+description: "Conta quante volte l'agente ha fatto cose inutili o rischiose nei transcript passati"
+---
+
+<Note>
+  **Funzionalità beta.** L'audit viene distribuito in versione beta mentre raccogliamo i primi feedback.
+  Il catalogo dei rilevatori e il formato del report potrebbero cambiare prima della prossima release stabile.
+  Apri una segnalazione se qualcosa non ti sembra corretto.
+</Note>
+
+L'audit riproduce i tuoi transcript passati dell'agente-CLI attraverso il motore di policy di failproofai e genera un report visivo e condivisibile sulla **pagina dashboard `/audit`** — l'archetipo del tuo agente, un punteggio da 0–100, e esattamente quali policy avrebbero catturato cosa.
+
+## Eseguirlo
+
+Tre modi di accesso — tutti portano allo stesso report `/audit`.
+
+<CodeGroup>
+
+```bash npx (nessuna installazione)
+npx -y failproofai audit
+```
+
+```bash failproofai audit
+failproofai audit
+```
+
+```bash failproofai (dashboard)
+failproofai
+```
+
+</CodeGroup>
+
+<CardGroup cols={3}>
+  <Card title="Nessuna installazione" icon="bolt">
+    `npx -y failproofai audit` scarica failproofai, esegue la scansione e apre il
+    dashboard per te — niente da installare prima.
+  </Card>
+  <Card title="Dalla CLI" icon="terminal">
+    `failproofai audit` esegue la scansione nel tuo terminale, poi apre
+    `localhost:8020/audit` automaticamente al termine.
+  </Card>
+  <Card title="Dal dashboard" icon="gauge">
+    Esegui `failproofai` e fai clic su **Audit** nella barra di navigazione (tra Policies e
+    Projects), oppure apri `/audit` direttamente.
+  </Card>
+</CardGroup>
+
+<Tip>
+  Esegui `failproofai audit -h` (o `--help`) per vedere l'utilizzo. L'audit viene eseguito **completamente offline** — non è necessario alcun account o connessione di rete — e il dashboard continua a servire finché non lo arresti con `Ctrl+C`.
+</Tip>
+
+Il dashboard scansiona i transcript CLI dell'agente passati su questa macchina (Claude Code, Codex, Copilot, Cursor, OpenCode, Pi) e segnala con quale frequenza l'agente ha fatto cose che failproofai è costruito per fermare — controlli di variabili d'ambiente, push forzati, prefissi ridondanti `cd <cwd>`, loop di sleep-polling, ri-letture di file appena modificati, e altro ancora.
+
+Per ogni transcript, ogni evento di tool-use viene riprodotto attraverso le 39 policy builtin **e** attraverso 8 rilevatori audit-only che catturano pattern non ancora coperti dalle policy di runtime. I conteggi vengono aggregati per policy / rilevatore su tutte le sessioni.
+
+## Cosa ottieni
+
+La pagina `/audit` è un singolo **poster** su schermo seguito da quattro sezioni under-the-fold:
+
+1. **Poster** — l'identità del tuo agente a colpo d'occhio: il suo **archetipo** (uno di 8 — `optimist`, `cowboy`, `explorer`, `goldfish`, `paranoid architect`, `precision builder`, `hammer`, `ghost`), le sue keyword di persona, quanto raro è quell'archetipo, e un **punteggio da 0–100** con una banda di livello (`S` fino a `bottom tier`). Costruito per essere condiviso — pubblica su X o LinkedIn, oppure scaricalo come PNG.
+2. **`// strengths`** — quello che il tuo agente già fa bene, come numeri reali dalla scansione (es. clean-tool-call %, `0` tentativi di push-to-main), mostrato solo dove la policy rilevante ha un record pulito.
+3. **`// quirks`** — quello che è passato: una tabella classificata di comportamenti che failproofai avrebbe catturato — *quando* è accaduto l'ultima volta, *cosa è passato* (e il builtin che l'avrebbe bloccato), la sua *gravità*, e quanto spesso è stato *visto* (`new` / `recurring` / `N× seen`).
+4. **`// how to improve`** — l'elenco delle correzioni prescritte: una riga per policy con un comando `failproofai policy add <slug>` copia-incolla, più un pulsante **install all** che abilita ogni raccomandazione contemporaneamente e mostra il tuo **punteggio previsto** se lo facessi.
+5. **`// come back better`** — costruisci l'abitudine: imposta un **reminder** di re-audit via email (`3d` / `7d` / `14d` / `30d`) o esegui il re-audit ora, e **invita un amico** a eseguire il proprio audit (inviato da failproof.ai, in copia a te). I reminder e gli inviti richiedono l'accesso.
+
+## Audit programmati
+
+Se esegui il **daemon failproofaid** (vedi [`failproofai config`](/it/cli/install-policies)),
+può rieseguire l'audit per te secondo una pianificazione e aggiornare il report `/audit` in
+background. È **disattivato per impostazione predefinita**, perché la scansione legge il *contenuto*
+di ogni transcript di sessione dell'agente su questa macchina — nulla viene scansionato su un timer
+finché non lo richiedi.
+
+Attivalo in `~/.failproofai/config.toml`:
+
+```toml
+[audit]
+auto = true
+interval_days = 7
+```
+
+| Chiave | Significato |
+|---|---|
+| `auto` | `true` abilita la scansione programmata. Qualsiasi altra cosa — assente, `false`, `"yes"` — è disattivata. |
+| `interval_days` | Giorni tra le scansioni. Limitato a 1–90; `0`, un valore negativo o un non-numero ricadono su `7`. |
+
+- La pianificazione è **wall-clock**, quindi sopravvive alla sospensione e ai riavvii: un laptop
+  che era in sleep oltre il suo orario dovuto esegue **una volta** al risveglio, mai un backlog.
+- Ogni esecuzione è un processo separato e a bassa priorità (`nice 19`) — mai il percorso hook del daemon, che rimane libero per rispondere alle chiamate di tool.
+- Una scansione viene saltata se `failproofai audit` o il re-run del dashboard è già
+  in corso; viene riprovat poco dopo invece di essere trattata come un fallimento.
+- Il progresso viene scritto in `~/.failproofai/state/audit-schedule.json` (ultima esecuzione,
+  prossima scadenza). Il daemon possiede quel file — cambia la cadenza in `config.toml`.
+
+<Note>
+Se hai abilitato questa funzione su una macchina configurata da un failproofai più vecchio, esegui
+`failproofai config` una volta. La definizione del servizio del daemon ha bisogno di una voce
+aggiuntiva prima di poter lanciare la CLI, e l'aggiornamento fa parte di quel comando.
+</Note>
+
+## Rilevatori audit-only
+
+Questi rilevatori catturano pattern di "comportamento stupido" non (ancora) applicati in tempo reale. Vengono eseguiti solo durante l'audit e non bloccano mai una chiamata di tool dal vivo.
+
+| Rilevatore | Cosa conta |
+|---|---|
+| `redundant-cd-cwd` | Comandi Bash che iniziano con `cd <cwd> && …` anche se i comandi vengono già eseguiti in `cwd`. |
+| `prefer-edit-over-read-cat` | `cat`/`head`/`tail`/`less`/`more` su un singolo file sorgente — usa il tool `Read`. |
+| `prefer-edit-over-sed-awk` | Modifiche in-place `sed -i` / `awk … > file` — usa il tool `Edit`. |
+| `prefer-write-over-heredoc` | Scrittura di file tramite heredoc / multi-line `echo > file` — usa il tool `Write`. |
+| `sleep-polling-loop` | Long `sleep N` (≥ 30s) o loop di polling `while …; sleep …; done`. |
+| `find-from-root` | `find /`, `find /home`, `find /usr`, ecc. — limita a `cwd` invece. |
+| `git-commit-no-verify` | `git commit … --no-verify` / `-n`, saltando gli hook. |
+| `reread-after-edit` | `Read` di un file che è stato appena `Edit`/`Write` nella stessa sessione. |
+
+## Cache
+
+- **Cache per-transcript** in `~/.failproofai/cache/audit/<sha1>.json` indicizzata da `(mtime, size, engineVersion, detectorVersion)` — si invalida automaticamente quando il transcript o il codice di policy/rilevatore cambia. Ogni voce memorizza anche un timestamp `cachedAt` come **metadati TTL** (non parte della chiave di cache); le voci più vecchie di **7 giorni** vengono rifiutate in lettura in modo che i risultati di lunga durata non sopravvivono all'evoluzione dell'intento del rilevatore.
+- **Cache del risultato completo** in `~/.failproofai/audit-dashboard.json` (mode 0600). Permette al dashboard di eseguire il rendering istantaneamente durante la navigazione senza rieseguire. Anche rifiutato in lettura passati i **7 giorni TTL** — `/audit` ricade quindi nel suo stato vuoto e richiede una nuova esecuzione. Fai clic su `[ re-audit now ]` vicino al fondo del report per aggiornare — il re-audit invia `noCache: true`, quindi bypass la cache per-transcript e esegue nuovamente la scansione di ogni transcript invece di restituire il risultato memorizzato; l'esecuzione trasmette il progresso tramite una striscia sticky in alto e scambia il risultato al suo posto al completamento (nessun ricaricamento della pagina; un re-audit non riuscito mantiene il report precedente).
+
+## Note
+
+- **Nessuna mutazione.** L'audit viene riprodotto in modalità read-only. `warn-repeated-tool-calls` viene saltato perché il suo sidecar per-session verrebbe altrimenti modificato.
+- **Policy del workflow saltate.** Le policy `require-*-before-stop` si attivano solo su eventi `Stop` e `execSync` contro lo stato git dal vivo — non hanno un'interpretazione significativa di "cosa sarebbe successo nel 2025", quindi non compaiono nei conteggi dell'audit.
+- **Policy personalizzate saltate.** I hook personalizzati forniti dall'utente non vengono riprodotti (potrebbero essere cambiati dalla sessione originale).

package/.next/standalone/docs-old/it/cli/dashboard.mdx

@@ -0,0 +1,30 @@
+---
+---
+title: Visualizza sessioni
+description: "Avvia la dashboard per sfogliare le sessioni degli agent e gestire le policy"
+---
+
+```bash
+failproofai
+```
+
+Avvia la dashboard web su `http://localhost:8020`.
+
+## Opzioni
+
+| Flag | Descrizione |
+|------|-------------|
+| `--port <number>` | Porta su cui ascoltare (predefinito: `8020`) |
+| `--allowed-origins <origins>` | Host/IP separati da virgola autorizzati ad accedere alle risorse di sviluppo |
+
+Per indirizzare la dashboard verso una cartella di progetti Claude non predefinita, imposta la variabile di ambiente `CLAUDE_PROJECTS_PATH` all'avvio.
+
+## Esempi
+
+```bash
+# Avvia su una porta diversa
+failproofai --port 9000
+
+# Usa un percorso personalizzato per i progetti Claude tramite variabile di ambiente
+CLAUDE_PROJECTS_PATH=~/my-claude-projects failproofai
+```

package/.next/standalone/docs-old/it/cli/environment-variables.mdx

@@ -0,0 +1,65 @@
+---
+title: Variabili d'ambiente
+description: "Configura il comportamento di failproofai con variabili d'ambiente"
+---
+
+## Dashboard
+
+| Variabile | Descrizione |
+|----------|-------------|
+| `PORT` | Porta del dashboard (default: `8020`) |
+| `CLAUDE_PROJECTS_PATH` | Sovrascrive dove trovare le cartelle dei progetti Claude Code |
+| `FAILPROOFAI_DISABLE_PAGES=policies,projects` | Pagine del dashboard separate da virgole da nascondere |
+| `FAILPROOFAI_ALLOWED_DEV_ORIGINS` | Host/IP autorizzati ad accedere alle risorse di sviluppo. Equivalente a `--allowed-origins`. |
+
+## Logging
+
+| Variabile | Descrizione |
+|----------|-------------|
+| `FAILPROOFAI_LOG_LEVEL=info\|warn\|error` | Livello dei log del server (default: `warn`) |
+| `FAILPROOFAI_HOOK_LOG_FILE` | Percorso personalizzato del file di log degli hook, oppure `true` per il default (`~/.failproofai/logs/hooks.log`) |
+
+## Telemetria
+
+failproofai invia telemetria di utilizzo anonima per impostazione predefinita. Esistono due modi per disattivarla, e viene applicato il più restrittivo — una variabile d'ambiente non può mai riabilitare qualcosa che il file di configurazione ha disattivato.
+
+| Variabile | Descrizione |
+|----------|-------------|
+| `FAILPROOFAI_TELEMETRY_DISABLED=1` | Disabilita la telemetria di utilizzo anonima per questo processo |
+
+Per disattivarla permanentemente per la macchina, aggiungi questo a `~/.failproofai/config.toml`:
+
+```toml
+[telemetry]
+enabled = false
+```
+
+<Note>
+Il file di configurazione è l'opzione da usare se esegui il **daemon failproofaid**.
+Il daemon è un servizio a livello di sistema, e il suo ambiente non include
+variabili esportate dalla tua shell — quindi `FAILPROOFAI_TELEMETRY_DISABLED` non
+può raggiungerlo. `[telemetry] enabled = false` viene letto sia dalla CLI che dal daemon.
+</Note>
+
+Il daemon invia solo il proprio **ciclo di vita**: che sia stato avviato (e se l'esecuzione precedente è terminata correttamente), che sia stato interrotto, quando il suo worker di valutazione è stato generato o riavviato, quando un'attività di raccolta ha avuto esito negativo, e l'esito di un pull di policy cloud. Questi portano valori e conteggi a bassa cardinalità — mai un percorso di file, un comando, una policy, un prompt, o qualcosa letto da una trascrizione. Non esiste alcun evento per ogni tool call.
+
+## Autenticazione
+
+| Variabile | Descrizione |
+|----------|-------------|
+| `FAILPROOF_API_URL` | Sovrascrive l'URL base del server API utilizzato dalla finestra di dialogo di autenticazione del dashboard. Default: `https://api.befailproof.ai`; imposta a `http://localhost:8080` (o dove preferisci) quando esegui un api-server locale. |
+| `FAILPROOFAI_AUTH_DIR` | Sovrascrive dove `auth.json` è memorizzato (default: `~/.failproofai`). Principalmente utile per test isolati. |
+
+## Prompt al primo avvio
+
+| Variabile | Descrizione |
+|----------|-------------|
+| `FAILPROOFAI_NO_FIRST_RUN=1` | Salta il prompt che offre di installare le policy al primo avvio con il comando `failproofai` nudo |
+
+## LLM (per la valutazione delle policy)
+
+| Variabile | Descrizione |
+|----------|-------------|
+| `FAILPROOFAI_LLM_BASE_URL` | Endpoint dell'API LLM (default: `https://api.openai.com/v1`) |
+| `FAILPROOFAI_LLM_API_KEY` | Chiave API per le policy abilitate da LLM |
+| `FAILPROOFAI_LLM_MODEL` | Nome del modello (default: `gpt-4o-mini`) |

package/.next/standalone/docs-old/it/cli/hook.mdx

@@ -0,0 +1,30 @@
+---
+title: Hook handler (interno)
+description: "Il sottoprocesso che Claude Code chiama su ogni evento di tool"
+---
+
+```bash
+failproofai --hook <EventType>
+```
+
+Questo è il comando registrato in `settings.json` di Claude Code da `failproofai policies --install`. Normalmente non lo chiami direttamente.
+
+Legge un payload JSON da stdin, valuta tutte le policy abilitate e termina con un codice che indica la decisione:
+
+| Codice di uscita | Decisione | Effetto |
+|-----------|----------|--------|
+| `0` | `allow` | Consenti l'azione |
+| `1` | `deny` | Blocca l'azione - Claude vede il motivo del rifiuto |
+| `2` | `instruct` | Inietta una guida nel contesto di Claude |
+
+### Tipi di evento supportati
+
+| Categoria | Eventi |
+|----------|--------|
+| **Esecuzione tool** | `PreToolUse`, `PostToolUse`, `PostToolUseFailure`, `PermissionRequest`, `PermissionDenied` |
+| **Ciclo di vita della sessione** | `SessionStart`, `SessionEnd`, `Stop`, `StopFailure` |
+| **Interazione utente** | `UserPromptSubmit`, `Notification`, `Elicitation`, `ElicitationResult` |
+| **Subagenti e task** | `SubagentStart`, `SubagentStop`, `TaskCreated`, `TaskCompleted`, `TeammateIdle` |
+| **Configurazione** | `InstructionsLoaded`, `ConfigChange`, `CwdChanged` |
+| **File system** | `FileChanged`, `WorktreeCreate`, `WorktreeRemove` |
+| **Contesto** | `PreCompact`, `PostCompact` |

package/.next/standalone/docs-old/it/cli/install-policies.mdx

@@ -0,0 +1,57 @@
+---
+title: Installa le policy
+description: "Abilita le policy affinché vengano eseguite ad ogni chiamata di strumento dell'agent"
+---
+
+```bash
+failproofai policies --install [policy-names...] [options]
+```
+
+Scrive voci di hook nel file di impostazioni del CLI dell'agent installato (Claude Code, OpenAI Codex o GitHub Copilot CLI _(beta)_) affinché failproofai intercetti le chiamate di strumento.
+
+Alias: `failproofai p -i`
+
+## Opzioni
+
+| Flag | Descrizione |
+|------|-------------|
+| `--cli claude\|codex\|copilot` | CLI dell'agent per cui installare; separati da spazi (es. `--cli claude codex copilot`) o ripetuti. Ometti per rilevare i CLI installati e ricevere una richiesta. |
+| `--scope user` | Installa nel file di impostazioni dell'ambito utente (Claude: `~/.claude/settings.json`; Codex: `~/.codex/hooks.json`; Copilot: `~/.copilot/hooks/failproofai.json`). Predefinito. |
+| `--scope project` | Installa nel file di impostazioni dell'ambito progetto (Claude: `<cwd>/.claude/settings.json`; Codex: `<cwd>/.codex/hooks.json`; Copilot: `<cwd>/.github/hooks/failproofai.json`). |
+| `--scope local` | Solo Claude — installa in `<cwd>/.claude/settings.local.json`. Codex e Copilot non dispongono di un ambito `local`. |
+| `--custom <path>` / `-c` | Percorso di un file JS contenente policy di hook personalizzate |
+
+## Comportamento
+
+- **Nessun nome di policy** - apre una richiesta interattiva per selezionare le policy
+- **Nomi specifici** - abilita quelle policy (aggiunte a quelle già abilitate)
+- **`all`** - abilita ogni policy disponibile
+
+L'installazione è additiva: eseguire `--install` di nuovo aggiunge nuove policy senza rimuovere quelle esistenti.
+
+## Esempi
+
+```bash
+# Installa tutte le policy predefinite globalmente (interattivo)
+failproofai policies --install
+
+# Installa policy specifiche per il progetto corrente
+failproofai policies --install block-sudo sanitize-api-keys --scope project
+
+# Abilita tutte le policy contemporaneamente
+failproofai policies --install all
+
+# Installa con un file di policy personalizzate
+failproofai policies --install --custom ./my-policies.js
+
+# Installa per OpenAI Codex (ambito progetto)
+failproofai policies --install --cli codex --scope project
+
+# Installa per GitHub Copilot CLI (beta) per il progetto corrente
+failproofai policies --install --cli copilot --scope project
+
+# Installa per tutti e tre i CLI contemporaneamente
+failproofai policies --install --cli claude codex copilot
+```
+
+Quando viene fornito `--custom <path>`, il file viene convalidato immediatamente - deve chiamare `customPolicies.add()` almeno una volta. Il percorso risolto viene salvato in `policies-config.json` come `customPoliciesPath`.

package/.next/standalone/docs-old/it/cli/list-policies.mdx

@@ -0,0 +1,31 @@
+---
+title: Elencare le policy
+description: "Visualizza quali policy sono abilitate, i loro parametri e le policy personalizzate"
+---
+
+```bash
+failproofai policies
+```
+
+Mostra tutte le policy con il loro stato, i parametri configurati e le policy personalizzate.
+
+## Output di esempio
+
+```text
+Failproof AI Hook Policies (user)
+
+  Status  Name                          Description
+  ──────  ──────────────────────────────────────────────────────────────
+  ✓       block-sudo                    Block sudo commands
+            allowPatterns: ["sudo systemctl status"]
+  ✓       block-rm-rf                   Block recursive deletions
+  ✗       block-curl-pipe-sh            Block curl|bash patterns
+  ✓       sanitize-api-keys             Redact API keys from output
+            additionalPatterns: [{ regex: "MY_TOKEN_...", label: "..." }]
+
+  ── Custom Policies (/home/alice/myproject/my-policies.js) ──────────────
+  ✓       require-jira-ticket           Block commits without ticket
+  ✓       approval-gate                 Approval gate for destructive ops
+```
+
+Le chiavi sconosciute in `policyParams` vengono segnalate qui in modo che tu possa individuare gli errori di battitura in anticipo.

package/.next/standalone/docs-old/it/cli/migrate.mdx

@@ -0,0 +1,122 @@
+---
+---
+title: Migrare la home directory
+description: "Porta ~/.failproofai al layout di questa versione e vedi prima cosa accadrebbe"
+---
+
+```bash
+failproofai migrate --dry-run   # stampa il piano, non cambia nulla
+failproofai migrate             # eseguilo
+```
+
+La maggior parte delle persone non digita mai questo comando. Si esegue da solo
+al primo comando dopo un aggiornamento, e [`failproofai update`](/it/cli/update) lo
+include. Usalo direttamente quando vuoi vedere il piano prima che accada, oppure
+per eseguire la migrazione in autonomia.
+
+## Basato sul layout, non sulla versione
+
+`~/.failproofai/VERSION` registra un numero di **layout** — la struttura della
+directory, non il rilascio che l'ha scritta. Le migrazioni sono basate su quel
+numero, il che rende economico un gap lungo:
+
+- Le versioni npm cambiano ad ogni rilascio, decine tra due layout.
+- Quindi una macchina che salta trenta rilasci con **nessun cambio di layout**
+  esegue **zero** migrazioni, non trenta operazioni nulle.
+- E una macchina che salta più layout contemporaneamente esegue ogni step in
+  ordine, ogni step conoscendo solo i suoi due estremi.
+
+Questo è importante perché npm non può aggiornare autonomamente un pacchetto
+installato. Una macchina ferma su una versione per mesi e poi che salta più
+layout è il caso normale, non quello esotico.
+
+## L'esecuzione di prova
+
+`--dry-run` stampa la catena esatta e i file che verrebbero salvati per primi,
+e non cambia nulla — nessuna migrazione, nessun backup, nessuna voce del
+registro:
+
+```
+Layout 2 on disk; this build speaks 3.
+1 step(s) would run:
+  2 → 3  layout 2 → 3: carry config.toml and credentials.toml into JSON, move
+         custom-policies/ back up into policies/, nest the policy config at the root
+
+These would be copied to ~/.failproofai/migrations/backup-layout2 first:
+  VERSION
+  config.toml
+  credentials.toml
+```
+
+## Cosa viene trasportato e cosa viene ricostruito
+
+Ogni percorso nella home dichiara che tipo di dati contiene, e questo decide se
+una migrazione può eliminarli. La regola: **i dati derivati e ri-recuperabili
+possono essere scartati; qualsiasi cosa tu abbia digitato, qualsiasi cosa non
+ancora consegnata e qualsiasi cosa che identifichi la macchina viene trasportata.**
+
+| Trasportato | Ricostruito o ri-recuperato |
+|---|---|
+| `config.json` — impostazioni, `daemon.configured`, percorsi di acquisizione extra | La cache di audit |
+| `credentials.json` — la tua registrazione cloud | Distribuzioni gestite dal cloud (ri-recuperate e verificate per digest al prossimo sondaggio) |
+| `policies-config.json` — la tua selezione di criteri e parametri | Stato scratch del daemon |
+| `policies/` — i tuoi file di criteri e gli helper che importano | |
+| `hook-activity/` — il registro delle decisioni che il dashboard legge | |
+| Eventi non consegnati ancora in coda per l'upload | |
+| `cursors/` — watermark del collettore | |
+| Il binario daemon in `bin/` | |
+
+<Note>
+  Gli eventi non consegnati vengono trasportati piuttosto che scartati perché
+  la perdita sarebbe permanente, non lenta: il watermark del collettore ha già
+  avanzato oltre qualsiasi cosa che si trovi nella spool, quindi nulla leggerebbe
+  mai più quell'intervallo di trascrizione. La migrazione chiede anche al daemon
+  di consegnare ciò che è spoolato non appena finisce, quindi il risultato
+  usuale è che non c'è nulla di sinistra da trasportare.
+</Note>
+
+Le chiavi che una versione *più recente* ha scritto in `config.json`,
+`credentials.json` o `policies-config.json` vengono preservate anche, piuttosto
+che scartate da un lettore più vecchio.
+
+## Il record che lascia
+
+```
+~/.failproofai/migrations/
+  applied.json                 una voce per step: layout, CLI, timestamp, durata, risultato
+  backup-layout<n>/            copie dei file irreplicabili, prese prima del primo step
+```
+
+`applied.json` è ciò che risponde a "cosa ha effettivamente attraversato questa
+macchina" — la prima domanda da porsi quando qualcosa sembra sbagliato dopo un
+aggiornamento. Allegalo a una segnalazione di bug.
+
+Il backup è volutamente piccolo piuttosto che una copia dell'intera directory:
+la migrazione non elimina più nulla di irreplicabile per design, quindi ciò da
+assicurare è un *difetto in uno step*, e questi pochi file sono dove un tale
+difetto farebbe male.
+
+## Se uno step fallisce
+
+La catena si ferma lì. `VERSION` è marcato solo da uno step che ha completato,
+quindi la home rimane marcata con il suo layout vecchio e il comando successivo
+lo riprova — una home non viene mai marcata come corrente sulla base di una
+migrazione parziale. Lo step viene registrato in `applied.json` con
+`"ok": false`, e il backup è dove è stato preso.
+
+## Una home più recente viene rifiutata, non migrata
+
+Se `~/.failproofai/` è stato scritto da un **più recente** failproofai di quello
+che stai eseguendo, il comando si ferma e ti dice di aggiornare invece. Quei dati
+vanno bene e una CLI più recente li legge; migrare da essi in avanti non è
+qualcosa che esiste, e resettarli distruggerebbe qualcosa di recuperabile.
+
+```
+This machine's failproofai directory was written by a newer version (layout 4;
+this build speaks 3). Upgrade rather than migrate:
+  npm install -g failproofai@latest
+```
+
+Il daemon applica la stessa regola: `failproofaid` rifiuta di avviarsi su un
+layout che non parla, piuttosto che leggere e scrivere percorsi che si sono
+spostati.

package/.next/standalone/docs-old/it/cli/remove-policies.mdx

@@ -0,0 +1,43 @@
+---
+title: Disinstallare le policy
+description: "Rimuovere le voci di hook dalle impostazioni di Claude Code"
+---
+
+```bash
+failproofai policies --uninstall [policy-names...] [options]
+```
+
+Rimuove le voci di hook di failproofai dal file `settings.json` di Claude Code.
+
+Alias: `failproofai p -u`
+
+## Opzioni
+
+| Flag | Descrizione |
+|------|-------------|
+| `--scope user` | Rimuove dalle impostazioni globali (predefinito) |
+| `--scope project` | Rimuove dalle impostazioni del progetto |
+| `--scope local` | Rimuove dalle impostazioni locali |
+| `--scope all` | Rimuove da tutti gli ambiti contemporaneamente |
+| `--custom` / `-c` | Cancella il `customPoliciesPath` dalla configurazione |
+
+## Comportamento
+
+- **Nessun nome di policy** - rimuove tutte le voci di hook di failproofai dal file di impostazioni
+- **Nomi specifici** - disabilita quelle policy ma mantiene gli hook installati
+
+## Esempi
+
+```bash
+# Rimuove tutti gli hook globalmente
+failproofai policies --uninstall
+
+# Disabilita una policy specifica (mantiene gli hook installati)
+failproofai policies --uninstall block-sudo
+
+# Rimuove gli hook da ogni ambito
+failproofai policies --uninstall --scope all
+
+# Cancella il percorso delle policy personalizzate
+failproofai policies --uninstall --custom
+```

package/.next/standalone/docs-old/it/cli/update.mdx

@@ -0,0 +1,86 @@
+---
+title: Aggiornamento dopo un upgrade
+description: "Completa la seconda metà dell'upgrade che npm non può fare: migra la home e sincronizza il daemon"
+---
+
+```bash
+npm install -g failproofai@latest && failproofai update
+```
+
+Questo è l'intero upgrade. `npm` sostituisce la CLI; `failproofai update` fa il
+resto.
+
+## Perché esiste un secondo comando
+
+`npm install -g` sostituisce una cosa sola — la CLI. Due altri componenti di un'installazione di failproofai vivono al di fuori del package di proposito, e nessuno dei due si muove quando npm viene eseguito:
+
+- **`~/.failproofai/`**, le tue impostazioni, l'iscrizione al cloud, la selezione delle policy e la cronologia. Una nuova versione potrebbe organizzarla diversamente, e il riordinamento deve essere fatto da codice che conosce entrambe le strutture.
+- **Il binario del daemon `failproofaid`**, in
+  `~/.failproofai/bin/failproofaid-<version>`. È deliberatamente *non* dentro
+  `node_modules`: un upgrade che sostituisse il file mentre il servizio è in esecuzione porterebbe un daemon attivo verso un binario compilato da sorgenti diverse, e rimuovere il package lo cancellerebbe mentre il servizio poi crash-loops ad ogni avvio.
+
+Quindi dopo solo `npm install -g`, la CLI è nuova ma il daemon non lo è.
+`failproofaid` rifiuta di avviarsi contro una struttura di home che non capisce — la versione esplicita di quel conflitto, non quella silenziosa — quindi le due metà devono essere portate insieme. `failproofai update` è quel passaggio.
+
+## Cosa fa
+
+<Steps>
+  <Step title="Esegue le migrazioni di layout in sospeso">
+    Legge il layout registrato in `~/.failproofai/VERSION` ed esegue i passaggi che
+    lo portano a quello che questa versione capisce. Di solito nessuno — vedi
+    [`failproofai migrate`](/it/cli/migrate).
+  </Step>
+  <Step title="Mette in posizione il binario del daemon corrispondente">
+    Dal package della piattaforma che npm ha già scaricato quando possibile (senza rete),
+    altrimenti dall'asset di release per questa versione esatta, verificato con SHA-256
+    prima che sia utilizzato.
+  </Step>
+  <Step title="Riavvia il servizio e conferma che è tornato">
+    Verificato piuttosto che assunto — un gestore di servizi segnala un processo attivo
+    nel momento in cui si crea un fork, il che non è la stessa cosa che funzionare.
+  </Step>
+</Steps>
+
+## Opzioni
+
+| Flag | Effetto |
+|------|--------|
+| `--no-daemon` | Migra solo la home, lasciando il daemon alla sua versione attuale. |
+
+<Warning>
+  `--no-daemon` lascia in posizione un daemon con versione non sincronizzata. Su una macchina configurata
+  per richiedere il daemon, ogni evento hook **fallisce in modo sicuro** se il daemon non riesce
+  a rispondere — e un daemon che rifiuta di avviarsi contro una home migrata non può
+  rispondere. È preferibile lasciare che la metà del daemon sia eseguita.
+</Warning>
+
+## Se qualcosa non va
+
+Il comando esce con codice di errore e dice quale metà ha fallito. Due casi che vale la pena conoscere:
+
+- **Un passaggio di migrazione non è terminato.** La home viene lasciata contrassegnata con il suo layout
+  *vecchio*, quindi il comando successivo lo riprova — nessuna home viene mai contrassegnata come attuale
+  in base a una migrazione parziale. Copie delle tue impostazioni e dell'iscrizione sono state
+  salvate prima che tutto iniziasse, in `~/.failproofai/migrations/backup-layout<n>/`.
+- **Il daemon non poteva essere riavviato senza una password.** `sudo -n` è usato
+  di proposito, quindi nulla mai sollecita da sotto una visualizzazione di progresso. Il
+  comando stampa la riga esatta da eseguire autonomamente.
+
+<Note>
+  Niente qui ha bisogno della procedura di configurazione interattiva. Le tue impostazioni, l'iscrizione
+  al cloud e la selezione delle policy sopravvivono a un upgrade, quindi una macchina migrata
+  applica le stesse policy di prima — il che conta soprattutto sulle macchine con
+  nessuno seduto davanti: un runner CI, una macchina di fleet, un gateway headless.
+</Note>
+
+## Automatizzarlo
+
+`failproofai update` è non-interattivo e sicuro da eseguire quando non c'è niente da
+fare — segnala che non era necessaria alcuna migrazione ed esce con 0. Metterlo dopo ogni
+upgrade in uno script di provisioning o in un Dockerfile è l'uso previsto:
+
+```dockerfile
+RUN npm install -g failproofai@latest && failproofai update --no-daemon
+```
+
+(`--no-daemon` in un build di immagine, dove non c'è ancora alcun servizio da riavviare.)

package/.next/standalone/docs-old/it/cli/version.mdx

@@ -0,0 +1,12 @@
+---
+title: Controlla versione
+description: "Stampa la versione installata di failproofai"
+---
+
+```bash
+failproofai --version
+# or
+failproofai -v
+```
+
+Stampa il numero di versione installata.