failproofai 0.0.6-beta.3 → 0.0.6-beta.4

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

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

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

@@ -1,31 +0,0 @@
----
-title: Elenca policies
-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 rilevare gli errori di battitura in anticipo.

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

@@ -1,43 +0,0 @@
----
-title: Disinstallare le policy
-description: "Rimuovere le voci hook dalle impostazioni di Claude Code"
----
-
-```bash
-failproofai policies --uninstall [policy-names...] [options]
-```
-
-Rimuove le voci hook di failproofai da `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 hook di failproofai dal file di impostazioni
-- **Nomi specifici** - disabilita quelle policy ma mantiene gli hook installati
-
-## Esempi
-
-```bash
-# Rimuovi tutti gli hook globalmente
-failproofai policies --uninstall
-
-# Disabilita una policy specifica (mantiene gli hook installati)
-failproofai policies --uninstall block-sudo
-
-# Rimuovi gli hook da ogni ambito
-failproofai policies --uninstall --scope all
-
-# Cancella il percorso delle policy personalizzate
-failproofai policies --uninstall --custom
-```

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

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

package/.next/standalone/docs/it/configuration.mdx

@@ -1,222 +0,0 @@
----
-title: Configurazione
-description: "Formato del file di configurazione, sistema a tre livelli e regole di merge"
-icon: gear
----
-
-failproofai utilizza file di configurazione JSON per controllare quali policy sono attive, come si comportano e da dove vengono caricate le policy personalizzate. La configurazione è progettata per essere facile da condividere con il tuo team - commitla nel tuo repository e ogni sviluppatore otterrà la stessa rete di sicurezza per l'agent.
-
----
-
-## Ambiti di configurazione
-
-Esistono tre ambiti di configurazione, valutati in ordine di priorità:
-
-| Ambito | Percorso file | Scopo |
-|--------|---------------|-------|
-| **project** | `.failproofai/policies-config.json` | Impostazioni per-repo, committate nel controllo versione |
-| **local** | `.failproofai/policies-config.local.json` | Override personali per-repo, gitignored |
-| **global** | `~/.failproofai/policies-config.json` | Impostazioni predefinite a livello utente su tutti i progetti |
-
-Quando failproofai riceve un evento hook, carica e unisce tutti e tre i file che esistono per la directory di lavoro corrente.
-
-### Regole di merge
-
-**`enabledPolicies`** - l'unione di tutti e tre gli ambiti. Una policy abilitata a qualsiasi livello è attiva.
-
-```text
-project:  ["block-sudo"]
-local:    ["block-rm-rf"]
-global:   ["block-sudo", "sanitize-api-keys"]
-
-resolved: ["block-sudo", "block-rm-rf", "sanitize-api-keys"]  ← unione deduplicated
-```
-
-**`policyParams`** - il primo ambito che definisce i parametri per una determinata policy vince completamente. Non esiste un merge profondo dei valori all'interno dei parametri di una policy.
-
-```text
-project:  block-sudo → { allowPatterns: ["sudo apt-get update"] }
-global:   block-sudo → { allowPatterns: ["sudo systemctl status"] }
-
-resolved: { allowPatterns: ["sudo apt-get update"] }   ← project vince, global ignorato
-```
-
-```text
-project:  (nessuna voce block-sudo)
-local:    (nessuna voce block-sudo)
-global:   block-sudo → { allowPatterns: ["sudo systemctl status"] }
-
-resolved: { allowPatterns: ["sudo systemctl status"] }  ← ricade nel global
-```
-
-**`customPoliciesPath`** - il primo ambito che lo definisce vince.
-
-**`llm`** - il primo ambito che lo definisce vince.
-
----
-
-## Formato del file di configurazione
-
-```json
-{
-  "enabledPolicies": [
-    "block-sudo",
-    "block-rm-rf",
-    "block-push-master",
-    "sanitize-api-keys",
-    "sanitize-jwt",
-    "block-env-files",
-    "block-read-outside-cwd"
-  ],
-  "policyParams": {
-    "block-sudo": {
-      "allowPatterns": ["sudo systemctl status", "sudo journalctl"]
-    },
-    "block-push-master": {
-      "protectedBranches": ["main", "release", "prod"]
-    },
-    "block-rm-rf": {
-      "allowPaths": ["/tmp"]
-    },
-    "block-read-outside-cwd": {
-      "allowPaths": ["/shared/data", "/opt/company"]
-    },
-    "sanitize-api-keys": {
-      "additionalPatterns": [
-        { "regex": "myco_[A-Za-z0-9]{32}", "label": "MyCo API key" }
-      ]
-    },
-    "warn-large-file-write": {
-      "thresholdKb": 512
-    }
-  },
-  "customPoliciesPath": "/home/alice/myproject/my-policies.js"
-}
-```
-
----
-
-## Riferimento dei campi
-
-### `enabledPolicies`
-
-Tipo: `string[]`
-
-Elenco dei nomi delle policy da abilitare. I nomi devono corrispondere esattamente agli identificatori delle policy mostrati da `failproofai policies`. Consulta [Built-in Policies](/it/built-in-policies) per l'elenco completo.
-
-Le policy non in `enabledPolicies` sono inattive, anche se hanno voci in `policyParams`.
-
-### `policyParams`
-
-Tipo: `Record<string, Record<string, unknown>>`
-
-Override dei parametri per-policy. La chiave esterna è il nome della policy; le chiavi interne sono specifiche della policy. Ogni policy documenta i suoi parametri disponibili in [Built-in Policies](/it/built-in-policies).
-
-Se una policy ha parametri ma non li specifichi, vengono utilizzati i valori predefiniti integrati della policy. Gli utenti che non configurano affatto `policyParams` ottengono un comportamento identico alle versioni precedenti.
-
-Le chiavi sconosciute all'interno del blocco dei parametri di una policy vengono silenziosamente ignorate al momento dell'esecuzione dell'hook ma contrassegnate come avvisi quando esegui `failproofai policies`.
-
-#### `hint` (cross-cutting)
-
-Tipo: `string` (opzionale)
-
-Un messaggio aggiunto al motivo quando una policy restituisce `deny` o `instruct`. Usalo per dare a Claude una guida pratica senza modificare la policy stessa.
-
-Funziona con qualsiasi tipo di policy — built-in, personalizzata (`custom/`), convenzione progetto (`.failproofai-project/`), o convenzione utente (`.failproofai-user/`).
-
-```json
-{
-  "policyParams": {
-    "block-force-push": {
-      "hint": "Prova a creare un nuovo branch."
-    },
-    "block-sudo": {
-      "allowPatterns": ["sudo apt-get"],
-      "hint": "Usa apt-get direttamente senza sudo."
-    },
-    "custom/my-policy": {
-      "hint": "Chiedi prima l'approvazione all'utente."
-    }
-  }
-}
-```
-
-Quando `block-force-push` nega, Claude vede: *"Il force-push è bloccato. Prova a creare un nuovo branch."*
-
-I valori non-string e le stringhe vuote vengono silenziosamente ignorate. Se `hint` non è impostato, il comportamento è invariato (backward-compatible).
-
-### `customPoliciesPath`
-
-Tipo: `string` (percorso assoluto)
-
-Percorso di un file JavaScript contenente policy hook personalizzate. Viene impostato automaticamente da `failproofai policies --install --custom <path>` (il percorso viene risolto in assoluto prima di essere archiviato).
-
-Il file viene caricato da zero su ogni evento hook - non esiste alcun caching. Consulta [Custom Policies](/it/custom-policies) per i dettagli sulla creazione.
-
-### Policy basate su convenzione
-
-Oltre al `customPoliciesPath` esplicito, failproofai scopre e carica automaticamente i file di policy dalle directory `.failproofai/policies/`:
-
-| Livello | Directory | Ambito |
-|---------|-----------|--------|
-| Progetto | `.failproofai/policies/` | Condiviso con il team tramite controllo versione |
-| Utente | `~/.failproofai/policies/` | Personale, si applica a tutti i progetti |
-
-**Corrispondenza file:** Solo i file che corrispondono a `*policies.{js,mjs,ts}` vengono caricati (ad es. `security-policies.mjs`, `workflow-policies.js`). Gli altri file nella directory vengono ignorati.
-
-**Nessuna configurazione necessaria:** Le policy di convenzione non richiedono voci in `policies-config.json`. Basta depositare file nella directory e verranno caricati al prossimo evento hook.
-
-**Caricamento union:** Entrambe le directory di convenzione progetto e utente vengono scansionate. Tutti i file corrispondenti da entrambi i livelli vengono caricati (a differenza di `customPoliciesPath` che utilizza il primo ambito che vince).
-
-Consulta [Custom Policies](/it/custom-policies) per ulteriori dettagli ed esempi.
-
-### `llm`
-
-Tipo: `object` (opzionale)
-
-Configurazione del client LLM per le policy che effettuano chiamate AI. Non richiesto per la maggior parte delle configurazioni.
-
-```json
-{
-  "llm": {
-    "model": "claude-sonnet-4-6",
-    "apiKey": "sk-ant-..."
-  }
-}
-```
-
----
-
-## Gestione della configurazione dalla CLI
-
-I comandi `policies --install` e `policies --uninstall` scrivono nel `settings.json` di Claude Code (i punti di ingresso dell'hook), mentre `policies-config.json` è il file che gestisci direttamente. I due sono separati:
-
-- **`settings.json`** - dice a Claude Code di chiamare `failproofai --hook <event>` su ogni tool use
-- **`policies-config.json`** - dice a failproofai quali policy valutare e con quali parametri
-
-Puoi modificare `policies-config.json` direttamente in qualsiasi momento; le modifiche hanno effetto immediatamente al prossimo evento hook senza necessità di riavvio.
-
----
-
-## Esempio: configurazione a livello di progetto con impostazioni predefinite del team
-
-Committa `.failproofai/policies-config.json` nel tuo repository:
-
-```json
-{
-  "enabledPolicies": [
-    "block-sudo",
-    "block-rm-rf",
-    "block-push-master",
-    "sanitize-api-keys",
-    "block-env-files"
-  ],
-  "policyParams": {
-    "block-push-master": {
-      "protectedBranches": ["main", "release", "hotfix"]
-    }
-  }
-}
-```
-
-Ogni sviluppatore può quindi creare `.failproofai/policies-config.local.json` (gitignored) per gli override personali senza influenzare i compagni di squadra.