failproofai 0.0.2 → 0.0.4-beta.0

package/.next/standalone/docs/it/built-in-policies.mdx

@@ -0,0 +1,537 @@
+---
+title: Politiche integrate
+description: "Tutte le 30 politiche integrate che rilevano le modalità di errore comuni degli agenti"
+icon: shield
+---
+
+failproofai è dotato di 30 politiche integrate che rilevano le modalità di errore comuni degli agenti. Ogni politica si attiva su un tipo di evento hook e un nome di strumento specifici. Nove politiche accettano parametri che ti consentono di regolarne il comportamento senza scrivere codice. Quattro politiche di workflow applicano una pipeline commit → push → PR → CI prima che Claude si fermi.
+
+---
+
+## Panoramica
+
+Le politiche sono raggruppate in categorie:
+
+| Categoria | Politiche | Tipo di hook |
+|----------|----------|-----------|
+| [Comandi pericolosi](#comandi-pericolosi) | block-sudo, block-rm-rf, block-curl-pipe-sh, block-failproofai-commands | PreToolUse |
+| [Segreti (sanitizer)](#segreti-sanitizer) | sanitize-jwt, sanitize-api-keys, sanitize-connection-strings, sanitize-private-key-content, sanitize-bearer-tokens | PostToolUse |
+| [Ambiente](#ambiente) | block-env-files, protect-env-vars | PreToolUse |
+| [Accesso ai file](#accesso-ai-file) | block-read-outside-cwd, block-secrets-write | PreToolUse |
+| [Git](#git) | block-push-master, block-work-on-main, block-force-push, warn-git-amend, warn-git-stash-drop, warn-all-files-staged | PreToolUse |
+| [Database](#database) | warn-destructive-sql, warn-schema-alteration | PreToolUse |
+| [Avvisi](#avvisi) | warn-large-file-write, warn-package-publish, warn-background-process, warn-global-package-install | PreToolUse |
+| [Workflow](#workflow) | require-commit-before-stop, require-push-before-stop, require-pr-before-stop, require-ci-green-before-stop | Stop |
+
+- **`block-`** — ferma l'agente dal procedere.
+- **`warn-`** — fornisce all'agente contesto aggiuntivo per autocorreggersi.
+- **`sanitize-`** — rimuove i dati sensibili dall'output dello strumento prima che l'agente li veda.
+- **`require-`** — blocca l'evento Stop fino a quando le condizioni non sono soddisfatte.
+
+---
+
+<Tip>
+Ogni politica supporta un campo `hint` opzionale in `policyParams`. L'hint viene aggiunto al messaggio di negazione o istruzione che Claude vede, fornendo indicazioni attuabili senza modificare il codice della politica. Funziona con le politiche integrate, personalizzate e di convenzione. Vedi [Configurazione → hint](/it/configuration#hint-cross-cutting) per i dettagli.
+</Tip>
+
+---
+
+## Comandi pericolosi
+
+Impedisci agli agenti di eseguire operazioni difficili da annullare o che potrebbero danneggiare il sistema host.
+
+### `block-sudo`
+
+**Evento:** PreToolUse (Bash)  
+**Default:** Nega qualsiasi comando `sudo`.
+
+Blocca le invocazioni che includono la parola chiave `sudo`. L'abbinamento del pattern viene eseguito su token di comando analizzati, non sulla stringa grezza, per prevenire il bypass tramite iniezione di operatori shell.
+
+**Parametri:**
+
+| Param | Tipo | Default | Descrizione |
+|-------|------|---------|-------------|
+| `allowPatterns` | `string[]` | `[]` | Prefissi di comando esatti che sono consentiti. Ogni voce viene confrontata con i token argv analizzati. |
+
+**Esempio:**
+
+```json
+{
+  "policyParams": {
+    "block-sudo": {
+      "allowPatterns": ["sudo systemctl status", "sudo journalctl"]
+    }
+  }
+}
+```
+
+Con questa configurazione, `sudo systemctl status nginx` è consentito, ma `sudo rm /etc/hosts` è negato.
+
+<Note>
+I pattern vengono abbinati ai token analizzati, non alla stringa di comando grezza. Questo previene il bypass tramite operatori shell aggiunti (ad es. `sudo systemctl status x; rm -rf /` non corrisponde a `sudo systemctl status *`).
+</Note>
+
+---
+
+### `block-rm-rf`
+
+**Evento:** PreToolUse (Bash)  
+**Default:** Nega `rm -rf`, `rm -fr` e forme simili di eliminazione ricorsiva.
+
+**Parametri:**
+
+| Param | Tipo | Default | Descrizione |
+|-------|------|---------|-------------|
+| `allowPaths` | `string[]` | `[]` | Percorsi che sono sicuri da eliminare ricorsivamente (ad es. `/tmp`). |
+
+**Esempio:**
+
+```json
+{
+  "policyParams": {
+    "block-rm-rf": {
+      "allowPaths": ["/tmp", "/var/cache"]
+    }
+  }
+}
+```
+
+---
+
+### `block-curl-pipe-sh`
+
+**Evento:** PreToolUse (Bash)  
+**Default:** Nega `curl <url> | bash`, `curl <url> | sh`, `wget <url> | bash` e pattern simili.
+
+Nessun parametro.
+
+---
+
+### `block-failproofai-commands`
+
+**Evento:** PreToolUse (Bash)  
+**Default:** Nega comandi che disinstallerebbero o disabiliterebbero failproofai stesso (ad es. `npm uninstall failproofai`, `failproofai policies --uninstall`).
+
+Nessun parametro.
+
+---
+
+## Segreti (sanitizer)
+
+Impedisci agli agenti di divulgare credenziali nel loro contesto o output. Le politiche sanitizer si attivano su eventi **PostToolUse**. Quando Claude esegue un comando Bash, legge un file o chiama qualsiasi strumento, queste politiche ispezionano l'output prima che venga restituito a Claude. Se viene rilevato un pattern di segreto, la politica restituisce una decisione di negazione che impedisce all'output di essere ripassato.
+
+### `sanitize-jwt`
+
+**Evento:** PostToolUse (tutti gli strumenti)  
+**Default:** Redige i token JWT (tre segmenti base64url separati da `.`).
+
+Nessun parametro.
+
+---
+
+### `sanitize-api-keys`
+
+**Evento:** PostToolUse (tutti gli strumenti)  
+**Default:** Redige i formati comuni di chiavi API: Anthropic (`sk-ant-`), OpenAI (`sk-`), GitHub PAT (`ghp_`), chiavi di accesso AWS (`AKIA`), chiavi Stripe (`sk_live_`, `sk_test_`), e chiavi API Google (`AIza`).
+
+**Parametri:**
+
+| Param | Tipo | Default | Descrizione |
+|-------|------|---------|-------------|
+| `additionalPatterns` | `{ regex: string; label: string }[]` | `[]` | Pattern regex aggiuntivi da trattare come segreti. |
+
+**Esempio:**
+
+```json
+{
+  "policyParams": {
+    "sanitize-api-keys": {
+      "additionalPatterns": [
+        { "regex": "myco_[A-Za-z0-9]{32}", "label": "MyCo internal API key" },
+        { "regex": "pat_[0-9a-f]{40}", "label": "Internal PAT" }
+      ]
+    }
+  }
+}
+```
+
+---
+
+### `sanitize-connection-strings`
+
+**Evento:** PostToolUse (tutti gli strumenti)  
+**Default:** Redige le stringhe di connessione al database che contengono credenziali incorporate (ad es. `postgresql://user:password@host/db`).
+
+Nessun parametro.
+
+---
+
+### `sanitize-private-key-content`
+
+**Evento:** PostToolUse (tutti gli strumenti)  
+**Default:** Redige i blocchi PEM (`-----BEGIN PRIVATE KEY-----`, `-----BEGIN RSA PRIVATE KEY-----`, ecc.).
+
+Nessun parametro.
+
+---
+
+### `sanitize-bearer-tokens`
+
+**Evento:** PostToolUse (tutti gli strumenti)  
+**Default:** Redige le intestazioni `Authorization: Bearer <token>` dove il token ha 20 o più caratteri.
+
+Nessun parametro.
+
+---
+
+## Ambiente
+
+Proteggi la configurazione sensibile dell'ambiente dalla lettura o dall'esposizione da parte degli agenti.
+
+### `block-env-files`
+
+**Evento:** PreToolUse (Bash, Read)  
+**Default:** Nega la lettura di file `.env` tramite `cat .env`, chiamate dello strumento `Read` con `.env` come percorso del file, ecc.
+
+Non blocca `.envrc` o altri file correlati all'ambiente - solo file denominati esattamente `.env`.
+
+Nessun parametro.
+
+---
+
+### `protect-env-vars`
+
+**Evento:** PreToolUse (Bash)  
+**Default:** Nega comandi che stampano variabili di ambiente: `printenv`, `env`, `echo $VAR`.
+
+Nessun parametro.
+
+---
+
+## Accesso ai file
+
+Mantieni gli agenti al lavoro entro i confini del progetto e lontani dai file sensibili.
+
+### `block-read-outside-cwd`
+
+**Evento:** PreToolUse (Read, Bash)  
+**Default:** Nega la lettura di file al di fuori della directory di lavoro corrente (root del progetto).
+
+**Parametri:**
+
+| Param | Tipo | Default | Descrizione |
+|-------|------|---------|-------------|
+| `allowPaths` | `string[]` | `[]` | Prefissi di percorso assoluto consentiti anche se esterni a cwd. |
+
+**Esempio:**
+
+```json
+{
+  "policyParams": {
+    "block-read-outside-cwd": {
+      "allowPaths": ["/shared/data", "/opt/company/config"]
+    }
+  }
+}
+```
+
+---
+
+### `block-secrets-write`
+
+**Evento:** PreToolUse (Write, Edit)  
+**Default:** Nega le scritture su file comunemente utilizzati per chiavi private e certificati: `id_rsa`, `id_ed25519`, `*.key`, `*.pem`, `*.p12`, `*.pfx`.
+
+**Parametri:**
+
+| Param | Tipo | Default | Descrizione |
+|-------|------|---------|-------------|
+| `additionalPatterns` | `string[]` | `[]` | Pattern di nome file aggiuntivi (stile glob) da bloccare. |
+
+**Esempio:**
+
+```json
+{
+  "policyParams": {
+    "block-secrets-write": {
+      "additionalPatterns": [".token", ".secret"]
+    }
+  }
+}
+```
+
+---
+
+## Git
+
+Previeni push accidentali, force-push e errori di branch difficili da annullare.
+
+### `block-push-master`
+
+**Evento:** PreToolUse (Bash)  
+**Default:** Nega `git push origin main` e `git push origin master`.
+
+**Parametri:**
+
+| Param | Tipo | Default | Descrizione |
+|-------|------|---------|-------------|
+| `protectedBranches` | `string[]` | `["main", "master"]` | Nomi dei branch che non possono essere pushati direttamente. |
+
+**Esempio:**
+
+```json
+{
+  "policyParams": {
+    "block-push-master": {
+      "protectedBranches": ["main", "master", "release", "prod"]
+    }
+  }
+}
+```
+
+<Tip>
+Per consentire il push su tutti i branch (disabilitando effettivamente questa politica senza rimuoverla da `enabledPolicies`), imposta `protectedBranches: []`.
+</Tip>
+
+---
+
+### `block-work-on-main`
+
+**Evento:** PreToolUse (Bash)  
+**Default:** Nega il checkout diretto dei branch `main` o `master`.
+
+**Parametri:**
+
+| Param | Tipo | Default | Descrizione |
+|-------|------|---------|-------------|
+| `protectedBranches` | `string[]` | `["main", "master"]` | Nomi dei branch che non possono essere sottoposti a checkout direttamente. |
+
+---
+
+### `block-force-push`
+
+**Evento:** PreToolUse (Bash)  
+**Default:** Nega `git push --force` e `git push -f`.
+
+Nessun parametro specifico della politica. Usa l'hint cross-cutting [`hint`](/it/configuration#hint-cross-cutting) per suggerire alternative:
+
+```json
+{
+  "policyParams": {
+    "block-force-push": {
+      "hint": "Create a new branch from your current HEAD (e.g. `git checkout -b <new-branch>`) and push that instead."
+    }
+  }
+}
+```
+
+---
+
+### `warn-git-amend`
+
+**Evento:** PreToolUse (Bash)  
+**Default:** Istruisce Claude a procedere con cautela quando esegue `git commit --amend`. Non blocca il comando.
+
+Nessun parametro.
+
+---
+
+### `warn-git-stash-drop`
+
+**Evento:** PreToolUse (Bash)  
+**Default:** Istruisce Claude a confermare prima di eseguire `git stash drop`. Non blocca il comando.
+
+Nessun parametro.
+
+---
+
+### `warn-all-files-staged`
+
+**Evento:** PreToolUse (Bash)  
+**Default:** Istruisce Claude a esaminare ciò che sta preparando quando esegue `git add -A` o `git add .`. Non blocca il comando.
+
+Nessun parametro.
+
+---
+
+## Database
+
+Rileva le operazioni SQL distruttive prima che vengono eseguite nel tuo database.
+
+### `warn-destructive-sql`
+
+**Evento:** PreToolUse (Bash)  
+**Default:** Istruisce Claude a confermare prima di eseguire SQL contenente `DROP TABLE`, `DROP DATABASE` o `DELETE` senza una clausola `WHERE`.
+
+Nessun parametro.
+
+---
+
+### `warn-schema-alteration`
+
+**Evento:** PreToolUse (Bash)  
+**Default:** Istruisce Claude a confermare prima di eseguire istruzioni `ALTER TABLE`.
+
+Nessun parametro.
+
+---
+
+## Avvisi
+
+Fornisci agli agenti contesto extra prima di operazioni potenzialmente rischiose ma non distruttive.
+
+### `warn-large-file-write`
+
+**Evento:** PreToolUse (Write)  
+**Default:** Istruisce Claude a confermare prima di scrivere file più grandi di 1024 KB.
+
+**Parametri:**
+
+| Param | Tipo | Default | Descrizione |
+|-------|------|---------|-------------|
+| `thresholdKb` | `number` | `1024` | Soglia di dimensione del file in kilobyte al di sopra della quale viene emesso un avviso. |
+
+**Esempio:**
+
+```json
+{
+  "policyParams": {
+    "warn-large-file-write": {
+      "thresholdKb": 256
+    }
+  }
+}
+```
+
+<Note>
+Il gestore dell'hook applica un limite stdin di 1 MB sui payload. Per testare questa politica con contenuto piccolo, imposta `thresholdKb` su un valore ben inferiore a 1024.
+</Note>
+
+---
+
+### `warn-package-publish`
+
+**Evento:** PreToolUse (Bash)  
+**Default:** Istruisce Claude a confermare prima di eseguire `npm publish`.
+
+Nessun parametro.
+
+---
+
+### `warn-background-process`
+
+**Evento:** PreToolUse (Bash)  
+**Default:** Istruisce Claude a prestare attenzione quando avvia processi in background tramite `nohup`, `&`, `disown` o `screen`.
+
+Nessun parametro.
+
+---
+
+### `warn-global-package-install`
+
+**Evento:** PreToolUse (Bash)  
+**Default:** Istruisce Claude a confermare prima di eseguire `npm install -g`, `yarn global add` o `pip install` senza un ambiente virtuale.
+
+Nessun parametro.
+
+---
+
+## Comportamento AI
+
+Rileva quando gli agenti si bloccano o si comportano in modo inaspettato.
+
+### `warn-repeated-tool-calls`
+
+**Evento:** PreToolUse (tutti gli strumenti)  
+**Default:** Istruisce Claude a riconsiderare quando lo stesso strumento viene chiamato 3+ volte con parametri identici - un segno comune che l'agente è bloccato in un loop.
+
+Nessun parametro.
+
+---
+
+## Workflow
+
+Applica un disciplinato workflow di fine sessione. Queste politiche si attivano sull'evento **Stop** e negano a Claude di fermarsi fino a quando ogni condizione non è soddisfatta. Seguono una naturale catena di dipendenza: commit → push → PR → CI. Se una politica nega, le politiche successive nella catena vengono saltate (la negazione cortocircuita).
+
+Tutte le politiche di workflow sono **fail-open**: se lo strumento richiesto non è disponibile (ad es. `gh` non installato, nessun git remote), la politica consente con un messaggio informativo che spiega perché il controllo è stato saltato.
+
+### `require-commit-before-stop`
+
+**Evento:** Stop  
+**Default:** Nega l'arresto quando ci sono modifiche non salvate (file modificati, preparati o non tracciati). Restituisce un messaggio informativo quando la directory di lavoro è pulita.
+
+Nessun parametro.
+
+---
+
+### `require-push-before-stop`
+
+**Evento:** Stop  
+**Default:** Nega l'arresto quando ci sono commit non pushati o quando il branch corrente non ha alcun branch di tracciamento remoto. Suggerisce `git push -u` per creare un branch di tracciamento se necessario. Fallisce aperto se nessun remote è configurato.
+
+**Parametri:**
+
+| Param | Tipo | Default | Descrizione |
+|-------|------|---------|-------------|
+| `remote` | `string` | `"origin"` | Nome del remote su cui eseguire il push. |
+
+**Esempio:**
+
+```json
+{
+  "policyParams": {
+    "require-push-before-stop": {
+      "remote": "upstream"
+    }
+  }
+}
+```
+
+---
+
+### `require-pr-before-stop`
+
+**Evento:** Stop  
+**Default:** Nega l'arresto quando non esiste alcuna pull request per il branch corrente, o quando la PR esistente è chiusa/merged. Istruisce Claude a creare una PR con `gh pr create`.
+
+Nessun parametro.
+
+<Note>
+Questa politica richiede l'installazione di [GitHub CLI](https://cli.github.com/) (`gh`) e l'autenticazione.
+Esegui `gh auth login` con un personal access token che ha ambito `repo` per l'accesso in lettura alle
+pull request. Se `gh` non è installato o non è autenticato, la politica fallisce aperta e comunica il motivo a Claude.
+</Note>
+
+---
+
+### `require-ci-green-before-stop`
+
+**Evento:** Stop  
+**Default:** Nega l'arresto quando i controlli CI stanno fallendo o sono ancora in esecuzione sul branch corrente. Controlla sia i workflow run GitHub Actions che i controlli bot di terze parti (ad es. CodeRabbit, SonarCloud, Codecov). Tratta le conclusioni `skipped` come successo. Restituisce un messaggio informativo quando tutti i controlli passano.
+
+Nessun parametro.
+
+<Note>
+Questa politica richiede l'installazione di [GitHub CLI](https://cli.github.com/) (`gh`) e l'autenticazione.
+Esegui `gh auth login` con un personal access token che ha ambito `repo` per l'accesso in lettura ai
+workflow run di Actions e all'API Checks. Se `gh` non è installato o non è autenticato, la politica fallisce aperta e comunica il motivo a Claude.
+</Note>
+
+---
+
+---
+
+## Disabilitazione di politiche individuali
+
+Rimuovi una politica specifica da `enabledPolicies` nella tua configurazione, o disattivala nella scheda Politiche del dashboard.
+
+```json
+{
+  "enabledPolicies": [
+    "block-rm-rf",
+    "sanitize-api-keys"
+  ]
+}
+```
+
+Le politiche non elencate in `enabledPolicies` non vengono eseguite, anche se esistono voci `policyParams` per esse.

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

@@ -0,0 +1,28 @@
+---
+title: Visualizza sessioni
+description: "Avvia il dashboard per sfogliare le sessioni dell'agente e gestire le policy"
+---
+
+```bash
+failproofai
+```
+
+Avvia il dashboard web su `http://localhost:8020`.
+
+## Opzioni
+
+| Flag | Descrizione |
+|------|-------------|
+| `--port <number>` | Porta su cui ascoltare (predefinita: `8020`) |
+| `--projects-path <path>` | Sovrascrive il percorso dove si trovano le cartelle dei progetti Claude Code |
+| `--allowed-origins <origins>` | Host/IP separati da virgola autorizzati ad accedere alle risorse di sviluppo |
+
+## Esempi
+
+```bash
+# Avvia su una porta diversa
+failproofai --port 9000
+
+# Usa un percorso di progetti personalizzato
+failproofai --projects-path ~/my-claude-projects
+```

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

@@ -0,0 +1,34 @@
+---
+title: Variabili d'ambiente
+description: "Configura il comportamento di failproofai con variabili d'ambiente"
+---
+
+## Dashboard
+
+| Variabile | Descrizione |
+|----------|-------------|
+| `PORT` | Porta del dashboard (predefinito: `8020`) |
+| `CLAUDE_PROJECTS_PATH` | Sovrascrivere la posizione dove si trovano le cartelle dei progetti di 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. Stesso di `--allowed-origins`. |
+
+## Logging
+
+| Variabile | Descrizione |
+|----------|-------------|
+| `FAILPROOFAI_LOG_LEVEL=info\|warn\|error` | Livello di log del server (predefinito: `warn`) |
+| `FAILPROOFAI_HOOK_LOG_FILE` | Percorso file di log personalizzato, o `true` per il predefinito (`~/.failproofai/logs/hooks.log`) |
+
+## Telemetria
+
+| Variabile | Descrizione |
+|----------|-------------|
+| `FAILPROOFAI_TELEMETRY_DISABLED=1` | Disabilita la telemetria anonima di utilizzo |
+
+## LLM (per la valutazione delle policy)
+
+| Variabile | Descrizione |
+|----------|-------------|
+| `FAILPROOFAI_LLM_BASE_URL` | Endpoint API LLM (predefinito: `https://api.openai.com/v1`) |
+| `FAILPROOFAI_LLM_API_KEY` | Chiave API per le policy basate su LLM |
+| `FAILPROOFAI_LLM_MODEL` | Nome del modello (predefinito: `gpt-4o-mini`) |

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

@@ -0,0 +1,30 @@
+---
+title: Hook handler (interno)
+description: "Il subprocess che Claude Code chiama a ogni evento di tool"
+---
+
+```bash
+failproofai --hook <EventType>
+```
+
+Questo è il comando registrato nel `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 esce 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` | Inserisci istruzioni 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` |
+| **Subagent e task** | `SubagentStart`, `SubagentStop`, `TaskCreated`, `TaskCompleted`, `TeammateIdle` |
+| **Configurazione** | `InstructionsLoaded`, `ConfigChange`, `CwdChanged` |
+| **File system** | `FileChanged`, `WorktreeCreate`, `WorktreeRemove` |
+| **Contesto** | `PreCompact`, `PostCompact` |

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

@@ -0,0 +1,47 @@
+---
+title: Installa policies
+description: "Abilita le policies in modo che vengano eseguite ad ogni chiamata di tool dell'agent"
+---
+
+```bash
+failproofai policies --install [policy-names...] [options]
+```
+
+Scrive voci di hook nel file `settings.json` di Claude Code in modo che failproofai intercetti le chiamate ai tool.
+
+Alias: `failproofai p -i`
+
+## Opzioni
+
+| Flag | Descrizione |
+|------|-------------|
+| `--scope user` | Installa in `~/.claude/settings.json` (predefinito - tutte le sessioni) |
+| `--scope project` | Installa in `.claude/settings.json` nella directory corrente |
+| `--scope local` | Installa in `.claude/settings.local.json` nella directory corrente |
+| `--custom <path>` / `-c` | Percorso di un file JS contenente custom hook policies |
+
+## Comportamento
+
+- **Nessun nome di policy** - apre un prompt interattivo per selezionare le policies
+- **Nomi specifici** - abilita quelle policies (aggiunte a quelle già abilitate)
+- **`all`** - abilita tutte le policies disponibili
+
+L'installazione è additiva: eseguire `--install` di nuovo aggiunge nuove policies senza rimuovere quelle esistenti.
+
+## Esempi
+
+```bash
+# Installa tutte le policies predefinite globalmente (interattivo)
+failproofai policies --install
+
+# Installa policies specifiche per il progetto corrente
+failproofai policies --install block-sudo sanitize-api-keys --scope project
+
+# Abilita tutte le policies contemporaneamente
+failproofai policies --install all
+
+# Installa con un file di custom policies
+failproofai policies --install --custom ./my-policies.js
+```
+
+Quando `--custom <path>` viene fornito, il file viene convalidato immediatamente - deve chiamare `customPolicies.add()` almeno una volta. Il percorso risolto viene salvato in `policies-config.json` come `customPoliciesPath`.