failproofai 0.0.6-beta.2 → 0.0.6-beta.4

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

@@ -1,574 +0,0 @@
----
-title: Politiche Integrate
-description: "Tutte le 30 politiche integrate che catturano le modalità di errore comuni degli agenti"
-icon: shield
----
-
-failproofai viene fornito con 30 politiche integrate che catturano 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 permettono di regolarne il comportamento senza scrivere codice. Quattro politiche di flusso di lavoro 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 (sanitizzatori)](#segreti-sanitizzatori) | 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 |
-| [Gestori di pacchetti](#gestori-di-pacchetti) | prefer-package-manager | PreToolUse |
-| [Flusso di lavoro](#flusso-di-lavoro) | require-commit-before-stop, require-push-before-stop, require-pr-before-stop, require-ci-green-before-stop | Stop |
-
-- **`block-`** — impedisce all'agente di procedere.
-- **`warn-`** — fornisce all'agente contesto aggiuntivo in modo che possa autocorreggersi.
-- **`sanitize-`** — ripulisce i dati sensibili dall'output dello strumento prima che l'agente li veda.
-- **`require-`** — blocca l'evento Stop fino al soddisfacimento delle condizioni.
-
----
-
-<Tip>
-Ogni politica supporta un campo `hint` facoltativo in `policyParams`. L'hint viene aggiunto al messaggio deny o instruct che Claude vede, fornendo indicazioni utili senza modificare il codice della politica. Funziona con politiche integrate, personalizzate e di convenzione. Consulta [Configuration → 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)  
-**Predefinito:** Nega qualsiasi comando `sudo`.
-
-Blocca gli invocamenti che includono la parola chiave `sudo`. La corrispondenza del pattern viene eseguita sui token del comando analizzati, non sulla stringa grezza, per prevenire l'aggiramento tramite iniezione di operatori shell.
-
-**Parametri:**
-
-| Parametro | Tipo | Predefinito | Descrizione |
-|-------|------|---------|-------------|
-| `allowPatterns` | `string[]` | `[]` | Prefissi di comando esatti 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` viene negato.
-
-<Note>
-I pattern vengono confrontati con i token analizzati, non con la stringa di comando grezza. Ciò impedisce l'aggiramento 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)  
-**Predefinito:** Nega `rm -rf`, `rm -fr` e forme simili di eliminazione ricorsiva.
-
-**Parametri:**
-
-| Parametro | Tipo | Predefinito | Descrizione |
-|-------|------|---------|-------------|
-| `allowPaths` | `string[]` | `[]` | Percorsi che è sicuro eliminare ricorsivamente (ad es. `/tmp`). |
-
-**Esempio:**
-
-```json
-{
-  "policyParams": {
-    "block-rm-rf": {
-      "allowPaths": ["/tmp", "/var/cache"]
-    }
-  }
-}
-```
-
----
-
-### `block-curl-pipe-sh`
-
-**Evento:** PreToolUse (Bash)  
-**Predefinito:** Nega `curl <url> | bash`, `curl <url> | sh`, `wget <url> | bash` e pattern simili.
-
-Nessun parametro.
-
----
-
-### `block-failproofai-commands`
-
-**Evento:** PreToolUse (Bash)  
-**Predefinito:** Nega i comandi che disinstallerebbero o disabiliterebbero failproofai stesso (ad es. `npm uninstall failproofai`, `failproofai policies --uninstall`).
-
-Nessun parametro.
-
----
-
-## Segreti (sanitizzatori)
-
-Impedisci agli agenti di filtrare le credenziali nel loro contesto o output. Le politiche dei sanitizzatori 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 deny che impedisce l'output di essere passato indietro.
-
-### `sanitize-jwt`
-
-**Evento:** PostToolUse (tutti gli strumenti)  
-**Predefinito:** Redige i token JWT (tre segmenti base64url separati da `.`).
-
-Nessun parametro.
-
----
-
-### `sanitize-api-keys`
-
-**Evento:** PostToolUse (tutti gli strumenti)  
-**Predefinito:** Redige i formati comuni delle chiavi API: Anthropic (`sk-ant-`), OpenAI (`sk-`), GitHub PATs (`ghp_`), chiavi di accesso AWS (`AKIA`), chiavi Stripe (`sk_live_`, `sk_test_`), e chiavi API Google (`AIza`).
-
-**Parametri:**
-
-| Parametro | Tipo | Predefinito | 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)  
-**Predefinito:** Redige le stringhe di connessione del database che contengono credenziali incorporate (ad es. `postgresql://user:password@host/db`).
-
-Nessun parametro.
-
----
-
-### `sanitize-private-key-content`
-
-**Evento:** PostToolUse (tutti gli strumenti)  
-**Predefinito:** Redige i blocchi PEM (`-----BEGIN PRIVATE KEY-----`, `-----BEGIN RSA PRIVATE KEY-----`, ecc.).
-
-Nessun parametro.
-
----
-
-### `sanitize-bearer-tokens`
-
-**Evento:** PostToolUse (tutti gli strumenti)  
-**Predefinito:** Redige le intestazioni `Authorization: Bearer <token>` dove il token è di 20 o più caratteri.
-
-Nessun parametro.
-
----
-
-## Ambiente
-
-Proteggi la configurazione dell'ambiente sensibile dalla lettura o dall'esposizione da parte degli agenti.
-
-### `block-env-files`
-
-**Evento:** PreToolUse (Bash, Read)  
-**Predefinito:** Nega la lettura dei file `.env` tramite `cat .env`, chiamate dello strumento Read con `.env` come percorso del file, ecc.
-
-Non blocca `.envrc` o altri file legati all'ambiente — solo i file denominati esattamente `.env`.
-
-Nessun parametro.
-
----
-
-### `protect-env-vars`
-
-**Evento:** PreToolUse (Bash)  
-**Predefinito:** Nega i comandi che stampano le variabili d'ambiente: `printenv`, `env`, `echo $VAR`.
-
-Nessun parametro.
-
----
-
-## Accesso ai file
-
-Mantieni gli agenti che lavorano all'interno dei confini del progetto e lontani dai file sensibili.
-
-### `block-read-outside-cwd`
-
-**Evento:** PreToolUse (Read, Bash)  
-**Predefinito:** Nega la lettura dei file al di fuori della directory di lavoro corrente (radice del progetto).
-
-**Parametri:**
-
-| Parametro | Tipo | Predefinito | Descrizione |
-|-------|------|---------|-------------|
-| `allowPaths` | `string[]` | `[]` | Prefissi di percorso assoluto consentiti anche se al di fuori di cwd. |
-
-**Esempio:**
-
-```json
-{
-  "policyParams": {
-    "block-read-outside-cwd": {
-      "allowPaths": ["/shared/data", "/opt/company/config"]
-    }
-  }
-}
-```
-
----
-
-### `block-secrets-write`
-
-**Evento:** PreToolUse (Write, Edit)  
-**Predefinito:** Nega le scritture nei file comunemente utilizzati per le chiavi private e i certificati: `id_rsa`, `id_ed25519`, `*.key`, `*.pem`, `*.p12`, `*.pfx`.
-
-**Parametri:**
-
-| Parametro | Tipo | Predefinito | 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)  
-**Predefinito:** Nega `git push origin main` e `git push origin master`.
-
-**Parametri:**
-
-| Parametro | Tipo | Predefinito | 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 in tutti i branch (disabilitando effettivamente questa politica senza rimuoverla da `enabledPolicies`), imposta `protectedBranches: []`.
-</Tip>
-
----
-
-### `block-work-on-main`
-
-**Evento:** PreToolUse (Bash)  
-**Predefinito:** Nega il checkout diretto dei branch `main` o `master`.
-
-**Parametri:**
-
-| Parametro | Tipo | Predefinito | Descrizione |
-|-------|------|---------|-------------|
-| `protectedBranches` | `string[]` | `["main", "master"]` | Nomi dei branch che non possono essere controllati direttamente. |
-
----
-
-### `block-force-push`
-
-**Evento:** PreToolUse (Bash)  
-**Predefinito:** Nega `git push --force` e `git push -f`.
-
-Nessun parametro specifico della politica. Usa il [`hint`](/it/configuration#hint-cross-cutting) cross-cutting per suggerire alternative:
-
-```json
-{
-  "policyParams": {
-    "block-force-push": {
-      "hint": "Crea un nuovo branch dal tuo HEAD attuale (ad es. `git checkout -b <new-branch>`) e esegui il push di questo."
-    }
-  }
-}
-```
-
----
-
-### `warn-git-amend`
-
-**Evento:** PreToolUse (Bash)  
-**Predefinito:** Istruisce Claude a procedere con cautela quando esegue `git commit --amend`. Non blocca il comando.
-
-Nessun parametro.
-
----
-
-### `warn-git-stash-drop`
-
-**Evento:** PreToolUse (Bash)  
-**Predefinito:** Istruisce Claude a confermare prima di eseguire `git stash drop`. Non blocca il comando.
-
-Nessun parametro.
-
----
-
-### `warn-all-files-staged`
-
-**Evento:** PreToolUse (Bash)  
-**Predefinito:** Istruisce Claude a rivedere ciò che sta preparando quando esegue `git add -A` o `git add .`. Non blocca il comando.
-
-Nessun parametro.
-
----
-
-## Database
-
-Cattura le operazioni SQL distruttive prima che vengano eseguite nel tuo database.
-
-### `warn-destructive-sql`
-
-**Evento:** PreToolUse (Bash)  
-**Predefinito:** 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)  
-**Predefinito:** Istruisce Claude a confermare prima di eseguire istruzioni `ALTER TABLE`.
-
-Nessun parametro.
-
----
-
-## Avvisi
-
-Fornisci agli agenti contesto aggiuntivo prima di operazioni potenzialmente rischiose ma non distruttive.
-
-### `warn-large-file-write`
-
-**Evento:** PreToolUse (Write)  
-**Predefinito:** Istruisce Claude a confermare prima di scrivere file più grandi di 1024 KB.
-
-**Parametri:**
-
-| Parametro | Tipo | Predefinito | 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 al di sotto di 1024.
-</Note>
-
----
-
-### `warn-package-publish`
-
-**Evento:** PreToolUse (Bash)  
-**Predefinito:** Istruisce Claude a confermare prima di eseguire `npm publish`.
-
-Nessun parametro.
-
----
-
-### `warn-background-process`
-
-**Evento:** PreToolUse (Bash)  
-**Predefinito:** Istruisce Claude di stare attento quando avvia processi in background tramite `nohup`, `&`, `disown`, o `screen`.
-
-Nessun parametro.
-
----
-
-### `warn-global-package-install`
-
-**Evento:** PreToolUse (Bash)  
-**Predefinito:** Istruisce Claude a confermare prima di eseguire `npm install -g`, `yarn global add`, o `pip install` senza un ambiente virtuale.
-
-Nessun parametro.
-
----
-
-## Gestori di pacchetti
-
-Applica quale gestore di pacchetti l'agente è autorizzato a utilizzare.
-
-### `prefer-package-manager`
-
-**Evento:** PreToolUse (Bash)  
-**Predefinito:** Disabilitato. Quando abilitato, blocca qualsiasi comando del gestore di pacchetti non nell'elenco `allowed` e dice a Claude di riscrivere il comando utilizzando un gestore consentito.
-
-Rileva: pip, pip3, python -m pip, npm, npx, yarn, pnpm, pnpx, bun, bunx, uv, poetry, pipenv, conda, cargo.
-
-| Parametro | Tipo | Predefinito | Descrizione |
-|-----------|------|---------|-------------|
-| `allowed` | string[] | `[]` | Nomi dei gestori di pacchetti consentiti. Qualsiasi gestore rilevato non in questo elenco viene bloccato. Quando vuoto, la politica è inoperante. |
-| `blocked` | string[] | `[]` | Nomi di gestori aggiuntivi da bloccare oltre all'elenco integrato (ad es. `['pdm', 'pipx']`). |
-
-L'elenco di blocchi integrato copre: pip, pip3, npm, npx, yarn, pnpm, pnpx, bun, bunx, uv, poetry, pipenv, conda, cargo. Usa `blocked` per aggiungere gestori non in questo elenco.
-
-**Configurazione di esempio:**
-
-```json
-{
-  "enabledPolicies": ["prefer-package-manager"],
-  "policyParams": {
-    "prefer-package-manager": {
-      "allowed": ["uv", "bun"],
-      "blocked": ["pdm", "pipx"]
-    }
-  }
-}
-```
-
-Con questa configurazione, `pip install flask` e `pdm install flask` sono entrambi negati con un messaggio che dice a Claude di utilizzare `uv` o `bun`. Comandi come `uv pip install flask` sono consentiti perché `uv` è nell'elenco consentito e viene verificato per primo.
-
----
-
-## Comportamento dell'IA
-
-Rileva quando gli agenti rimangono bloccati o si comportano inaspettatamente.
-
-### `warn-repeated-tool-calls`
-
-**Evento:** PreToolUse (tutti gli strumenti)  
-**Predefinito:** Istruisce Claude a riconsiderare quando lo stesso strumento viene chiamato 3 o più volte con parametri identici — un segno comune che l'agente è bloccato in un loop.
-
-Nessun parametro.
-
----
-
-## Flusso di lavoro
-
-Applica un flusso di lavoro di fine sessione disciplinato. Queste politiche si attivano sull'evento **Stop** e negano a Claude di fermarsi fino a quando ogni condizione non è soddisfatta. Seguono una catena di dipendenza naturale: commit → push → PR → CI. Se una politica nega, le politiche successive nella catena vengono saltate (deny short-circuits).
-
-Tutte le politiche di flusso di lavoro sono **fail-open**: se lo strumento richiesto non è disponibile (ad es. `gh` non installato, nessun remote git), la politica consente con un messaggio informativo che spiega perché il controllo è stato saltato.
-
-### `require-commit-before-stop`
-
-**Evento:** Stop  
-**Predefinito:** Nega l'arresto quando ci sono modifiche non commitatte (file modificati, preparati o non tracciati). Restituisce un messaggio informativo quando la directory di lavoro è pulita.
-
-Nessun parametro.
-
----
-
-### `require-push-before-stop`
-
-**Evento:** Stop  
-**Predefinito:** Nega l'arresto quando ci sono commit non pushati o quando il branch attuale non ha un remote branch di tracciamento. Suggerisce `git push -u` per creare un branch di tracciamento se necessario. Fallisce aperto se nessun remote è configurato.
-
-**Parametri:**
-
-| Parametro | Tipo | Predefinito | Descrizione |
-|-------|------|---------|-------------|
-| `remote` | `string` | `"origin"` | Nome del remote per eseguire il push. |
-
-**Esempio:**
-
-```json
-{
-  "policyParams": {
-    "require-push-before-stop": {
-      "remote": "upstream"
-    }
-  }
-}
-```
-
----
-
-### `require-pr-before-stop`
-
-**Evento:** Stop  
-**Predefinito:** Nega l'arresto quando nessuna pull request esiste per il branch attuale, o quando la PR esistente è chiusa/unita. Istruisce Claude a creare una PR con `gh pr create`.
-
-Nessun parametro.
-
-<Note>
-Questa politica richiede che [GitHub CLI](https://cli.github.com/) (`gh`) sia installato e autenticato.
-Esegui `gh auth login` con un personal access token che ha scope `repo` per l'accesso in lettura alle
-pull request. Se `gh` non è installato o non autenticato, la politica fallisce aperta e segnala il motivo a Claude.
-</Note>
-
----
-
-### `require-ci-green-before-stop`
-
-**Evento:** Stop  
-**Predefinito:** Nega l'arresto quando i controlli CI hanno esito negativo o sono ancora in esecuzione nel branch attuale. Verifica sia i GitHub Actions workflow run che i controlli di 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 che [GitHub CLI](https://cli.github.com/) (`gh`) sia installato e autenticato.
-Esegui `gh auth login` con un personal access token che ha scope `repo` per l'accesso in lettura ai
-GitHub Actions workflow run e all'API dei Checks. Se `gh` non è installato o non autenticato, la politica fallisce aperta e segnala il motivo a Claude.
-</Note>
-
----
-
----
-
-## Disabilitazione delle singole politiche
-
-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

@@ -1,28 +0,0 @@
----
-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

@@ -1,34 +0,0 @@
----
-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

@@ -1,30 +0,0 @@
----
-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` |