failproofai 0.0.2 → 0.0.4-beta.0

package/.next/standalone/docs/pt-br/built-in-policies.mdx

@@ -0,0 +1,537 @@
+---
+title: Políticas Integradas
+description: "Todas as 30 políticas integradas que detectam falhas comuns de agentes"
+icon: shield
+---
+
+failproofai vem com 30 políticas integradas que detectam falhas comuns de agentes. Cada política é acionada em um tipo específico de evento de hook e nome de ferramenta. Nove políticas aceitam parâmetros que permitem ajustar seu comportamento sem escrever código. Quatro políticas de fluxo de trabalho impõem um pipeline de commit → push → PR → CI antes que Claude pare.
+
+---
+
+## Visão geral
+
+As políticas são agrupadas em categorias:
+
+| Categoria | Políticas | Tipo de hook |
+|-----------|-----------|--------------|
+| [Comandos perigosos](#dangerous-commands) | block-sudo, block-rm-rf, block-curl-pipe-sh, block-failproofai-commands | PreToolUse |
+| [Segredos (sanitizadores)](#secrets-sanitizers) | sanitize-jwt, sanitize-api-keys, sanitize-connection-strings, sanitize-private-key-content, sanitize-bearer-tokens | PostToolUse |
+| [Ambiente](#environment) | block-env-files, protect-env-vars | PreToolUse |
+| [Acesso a arquivos](#file-access) | 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 |
+| [Banco de dados](#database) | warn-destructive-sql, warn-schema-alteration | PreToolUse |
+| [Avisos](#warnings) | warn-large-file-write, warn-package-publish, warn-background-process, warn-global-package-install | PreToolUse |
+| [Fluxo de trabalho](#workflow) | require-commit-before-stop, require-push-before-stop, require-pr-before-stop, require-ci-green-before-stop | Stop |
+
+- **`block-`** — impede o agente de prosseguir.
+- **`warn-`** — fornece contexto adicional ao agente para que ele possa se autocorrigir.
+- **`sanitize-`** — remove dados sensíveis da saída da ferramenta antes que o agente os veja.
+- **`require-`** — bloqueia o evento Stop até que as condições sejam atendidas.
+
+---
+
+<Tip>
+Toda política suporta um campo opcional `hint` em `policyParams`. O hint é anexado à mensagem de deny ou instruct que Claude vê, fornecendo orientações práticas sem modificar o código da política. Funciona com políticas integradas, personalizadas e de convenção. Consulte [Configuração → hint](/pt-br/configuration#hint-cross-cutting) para mais detalhes.
+</Tip>
+
+---
+
+## Comandos perigosos
+
+Impede que agentes executem operações difíceis de desfazer ou que possam danificar o sistema host.
+
+### `block-sudo`
+
+**Evento:** PreToolUse (Bash)  
+**Padrão:** Nega qualquer comando `sudo`.
+
+Bloqueia invocações que incluam a palavra-chave `sudo`. A correspondência de padrões é feita nos tokens de comando analisados, não na string bruta, para evitar bypass via injeção de operadores de shell.
+
+**Parâmetros:**
+
+| Parâmetro | Tipo | Padrão | Descrição |
+|-----------|------|--------|-----------|
+| `allowPatterns` | `string[]` | `[]` | Prefixos de comando exatos que são permitidos. Cada entrada é comparada com os tokens argv analisados. |
+
+**Exemplo:**
+
+```json
+{
+  "policyParams": {
+    "block-sudo": {
+      "allowPatterns": ["sudo systemctl status", "sudo journalctl"]
+    }
+  }
+}
+```
+
+Com essa configuração, `sudo systemctl status nginx` é permitido, mas `sudo rm /etc/hosts` é negado.
+
+<Note>
+Os padrões são comparados com os tokens analisados, não com a string de comando bruta. Isso evita bypass via operadores de shell anexados (por exemplo, `sudo systemctl status x; rm -rf /` não corresponde a `sudo systemctl status *`).
+</Note>
+
+---
+
+### `block-rm-rf`
+
+**Evento:** PreToolUse (Bash)  
+**Padrão:** Nega `rm -rf`, `rm -fr` e formas similares de exclusão recursiva.
+
+**Parâmetros:**
+
+| Parâmetro | Tipo | Padrão | Descrição |
+|-----------|------|--------|-----------|
+| `allowPaths` | `string[]` | `[]` | Caminhos que são seguros para excluir recursivamente (ex: `/tmp`). |
+
+**Exemplo:**
+
+```json
+{
+  "policyParams": {
+    "block-rm-rf": {
+      "allowPaths": ["/tmp", "/var/cache"]
+    }
+  }
+}
+```
+
+---
+
+### `block-curl-pipe-sh`
+
+**Evento:** PreToolUse (Bash)  
+**Padrão:** Nega `curl <url> | bash`, `curl <url> | sh`, `wget <url> | bash` e padrões similares.
+
+Sem parâmetros.
+
+---
+
+### `block-failproofai-commands`
+
+**Evento:** PreToolUse (Bash)  
+**Padrão:** Nega comandos que desinstalem ou desabilitem o próprio failproofai (ex: `npm uninstall failproofai`, `failproofai policies --uninstall`).
+
+Sem parâmetros.
+
+---
+
+## Segredos (sanitizadores)
+
+Impede que agentes vazem credenciais em seu contexto ou saída. As políticas de sanitização são acionadas em eventos **PostToolUse**. Quando Claude executa um comando Bash, lê um arquivo ou chama qualquer ferramenta, essas políticas inspecionam a saída antes que ela seja retornada ao Claude. Se um padrão de segredo for detectado, a política retorna uma decisão de deny que impede a saída de ser passada de volta.
+
+### `sanitize-jwt`
+
+**Evento:** PostToolUse (todas as ferramentas)  
+**Padrão:** Redige tokens JWT (três segmentos base64url separados por `.`).
+
+Sem parâmetros.
+
+---
+
+### `sanitize-api-keys`
+
+**Evento:** PostToolUse (todas as ferramentas)  
+**Padrão:** Redige formatos comuns de chaves de API: Anthropic (`sk-ant-`), OpenAI (`sk-`), GitHub PATs (`ghp_`), chaves de acesso AWS (`AKIA`), chaves Stripe (`sk_live_`, `sk_test_`) e chaves Google API (`AIza`).
+
+**Parâmetros:**
+
+| Parâmetro | Tipo | Padrão | Descrição |
+|-----------|------|--------|-----------|
+| `additionalPatterns` | `{ regex: string; label: string }[]` | `[]` | Padrões regex adicionais para tratar como segredos. |
+
+**Exemplo:**
+
+```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 (todas as ferramentas)  
+**Padrão:** Redige strings de conexão de banco de dados que contêm credenciais incorporadas (ex: `postgresql://user:password@host/db`).
+
+Sem parâmetros.
+
+---
+
+### `sanitize-private-key-content`
+
+**Evento:** PostToolUse (todas as ferramentas)  
+**Padrão:** Redige blocos PEM (`-----BEGIN PRIVATE KEY-----`, `-----BEGIN RSA PRIVATE KEY-----`, etc.).
+
+Sem parâmetros.
+
+---
+
+### `sanitize-bearer-tokens`
+
+**Evento:** PostToolUse (todas as ferramentas)  
+**Padrão:** Redige cabeçalhos `Authorization: Bearer <token>` onde o token tem 20 ou mais caracteres.
+
+Sem parâmetros.
+
+---
+
+## Ambiente
+
+Protege a configuração de ambiente sensível de ser lida ou exposta por agentes.
+
+### `block-env-files`
+
+**Evento:** PreToolUse (Bash, Read)  
+**Padrão:** Nega a leitura de arquivos `.env` via `cat .env`, chamadas da ferramenta `Read` com `.env` como caminho do arquivo, etc.
+
+Não bloqueia `.envrc` ou outros arquivos relacionados ao ambiente — apenas arquivos nomeados exatamente `.env`.
+
+Sem parâmetros.
+
+---
+
+### `protect-env-vars`
+
+**Evento:** PreToolUse (Bash)  
+**Padrão:** Nega comandos que imprimam variáveis de ambiente: `printenv`, `env`, `echo $VAR`.
+
+Sem parâmetros.
+
+---
+
+## Acesso a arquivos
+
+Mantém agentes trabalhando dentro dos limites do projeto e longe de arquivos sensíveis.
+
+### `block-read-outside-cwd`
+
+**Evento:** PreToolUse (Read, Bash)  
+**Padrão:** Nega a leitura de arquivos fora do diretório de trabalho atual (a raiz do projeto).
+
+**Parâmetros:**
+
+| Parâmetro | Tipo | Padrão | Descrição |
+|-----------|------|--------|-----------|
+| `allowPaths` | `string[]` | `[]` | Prefixos de caminho absoluto que são permitidos mesmo se estiverem fora do cwd. |
+
+**Exemplo:**
+
+```json
+{
+  "policyParams": {
+    "block-read-outside-cwd": {
+      "allowPaths": ["/shared/data", "/opt/company/config"]
+    }
+  }
+}
+```
+
+---
+
+### `block-secrets-write`
+
+**Evento:** PreToolUse (Write, Edit)  
+**Padrão:** Nega escritas em arquivos comumente usados para chaves privadas e certificados: `id_rsa`, `id_ed25519`, `*.key`, `*.pem`, `*.p12`, `*.pfx`.
+
+**Parâmetros:**
+
+| Parâmetro | Tipo | Padrão | Descrição |
+|-----------|------|--------|-----------|
+| `additionalPatterns` | `string[]` | `[]` | Padrões de nome de arquivo adicionais (estilo glob) para bloquear. |
+
+**Exemplo:**
+
+```json
+{
+  "policyParams": {
+    "block-secrets-write": {
+      "additionalPatterns": [".token", ".secret"]
+    }
+  }
+}
+```
+
+---
+
+## Git
+
+Previne pushes acidentais, force-pushes e erros de branch que são difíceis de desfazer.
+
+### `block-push-master`
+
+**Evento:** PreToolUse (Bash)  
+**Padrão:** Nega `git push origin main` e `git push origin master`.
+
+**Parâmetros:**
+
+| Parâmetro | Tipo | Padrão | Descrição |
+|-----------|------|--------|-----------|
+| `protectedBranches` | `string[]` | `["main", "master"]` | Nomes de branches que não podem receber push diretamente. |
+
+**Exemplo:**
+
+```json
+{
+  "policyParams": {
+    "block-push-master": {
+      "protectedBranches": ["main", "master", "release", "prod"]
+    }
+  }
+}
+```
+
+<Tip>
+Para permitir push para todos os branches (desabilitando efetivamente esta política sem removê-la de `enabledPolicies`), defina `protectedBranches: []`.
+</Tip>
+
+---
+
+### `block-work-on-main`
+
+**Evento:** PreToolUse (Bash)  
+**Padrão:** Nega o checkout direto dos branches `main` ou `master`.
+
+**Parâmetros:**
+
+| Parâmetro | Tipo | Padrão | Descrição |
+|-----------|------|--------|-----------|
+| `protectedBranches` | `string[]` | `["main", "master"]` | Nomes de branches que não podem ser obtidos diretamente via checkout. |
+
+---
+
+### `block-force-push`
+
+**Evento:** PreToolUse (Bash)  
+**Padrão:** Nega `git push --force` e `git push -f`.
+
+Sem parâmetros específicos da política. Use o [`hint`](/pt-br/configuration#hint-cross-cutting) transversal para sugerir alternativas:
+
+```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)  
+**Padrão:** Instrui Claude a prosseguir com cuidado ao executar `git commit --amend`. Não bloqueia o comando.
+
+Sem parâmetros.
+
+---
+
+### `warn-git-stash-drop`
+
+**Evento:** PreToolUse (Bash)  
+**Padrão:** Instrui Claude a confirmar antes de executar `git stash drop`. Não bloqueia o comando.
+
+Sem parâmetros.
+
+---
+
+### `warn-all-files-staged`
+
+**Evento:** PreToolUse (Bash)  
+**Padrão:** Instrui Claude a revisar o que está sendo adicionado ao stage ao executar `git add -A` ou `git add .`. Não bloqueia o comando.
+
+Sem parâmetros.
+
+---
+
+## Banco de dados
+
+Detecta operações SQL destrutivas antes que sejam executadas no banco de dados.
+
+### `warn-destructive-sql`
+
+**Evento:** PreToolUse (Bash)  
+**Padrão:** Instrui Claude a confirmar antes de executar SQL contendo `DROP TABLE`, `DROP DATABASE` ou `DELETE` sem uma cláusula `WHERE`.
+
+Sem parâmetros.
+
+---
+
+### `warn-schema-alteration`
+
+**Evento:** PreToolUse (Bash)  
+**Padrão:** Instrui Claude a confirmar antes de executar instruções `ALTER TABLE`.
+
+Sem parâmetros.
+
+---
+
+## Avisos
+
+Fornece contexto extra aos agentes antes de operações potencialmente arriscadas, mas não destrutivas.
+
+### `warn-large-file-write`
+
+**Evento:** PreToolUse (Write)  
+**Padrão:** Instrui Claude a confirmar antes de escrever arquivos maiores que 1024 KB.
+
+**Parâmetros:**
+
+| Parâmetro | Tipo | Padrão | Descrição |
+|-----------|------|--------|-----------|
+| `thresholdKb` | `number` | `1024` | Limite de tamanho de arquivo em kilobytes acima do qual um aviso é emitido. |
+
+**Exemplo:**
+
+```json
+{
+  "policyParams": {
+    "warn-large-file-write": {
+      "thresholdKb": 256
+    }
+  }
+}
+```
+
+<Note>
+O handler de hook impõe um limite de 1 MB de stdin nos payloads. Para testar esta política com conteúdo pequeno, defina `thresholdKb` para um valor bem abaixo de 1024.
+</Note>
+
+---
+
+### `warn-package-publish`
+
+**Evento:** PreToolUse (Bash)  
+**Padrão:** Instrui Claude a confirmar antes de executar `npm publish`.
+
+Sem parâmetros.
+
+---
+
+### `warn-background-process`
+
+**Evento:** PreToolUse (Bash)  
+**Padrão:** Instrui Claude a ter cuidado ao iniciar processos em segundo plano via `nohup`, `&`, `disown` ou `screen`.
+
+Sem parâmetros.
+
+---
+
+### `warn-global-package-install`
+
+**Evento:** PreToolUse (Bash)  
+**Padrão:** Instrui Claude a confirmar antes de executar `npm install -g`, `yarn global add` ou `pip install` sem um ambiente virtual.
+
+Sem parâmetros.
+
+---
+
+## Comportamento de IA
+
+Detecta quando agentes ficam travados ou se comportam de forma inesperada.
+
+### `warn-repeated-tool-calls`
+
+**Evento:** PreToolUse (todas as ferramentas)  
+**Padrão:** Instrui Claude a reconsiderar quando a mesma ferramenta é chamada 3 ou mais vezes com parâmetros idênticos — um sinal comum de que o agente está preso em um loop.
+
+Sem parâmetros.
+
+---
+
+## Fluxo de trabalho
+
+Impõe um fluxo de trabalho disciplinado ao final da sessão. Essas políticas são acionadas no evento **Stop** e impedem Claude de parar até que cada condição seja atendida. Elas seguem uma cadeia de dependência natural: commit → push → PR → CI. Se uma política nega, as políticas seguintes na cadeia são ignoradas (deny interrompe o fluxo).
+
+Todas as políticas de fluxo de trabalho são **fail-open**: se a ferramenta necessária não estiver disponível (ex: `gh` não instalado, sem remote git), a política permite com uma mensagem informativa explicando por que a verificação foi ignorada.
+
+### `require-commit-before-stop`
+
+**Evento:** Stop  
+**Padrão:** Nega a parada quando há alterações não commitadas (arquivos modificados, em stage ou não rastreados). Retorna uma mensagem informativa quando o diretório de trabalho está limpo.
+
+Sem parâmetros.
+
+---
+
+### `require-push-before-stop`
+
+**Evento:** Stop  
+**Padrão:** Nega a parada quando há commits não enviados por push ou quando o branch atual não tem um branch de rastreamento remoto. Sugere `git push -u` para criar um branch de rastreamento se necessário. Falha de forma aberta se nenhum remote estiver configurado.
+
+**Parâmetros:**
+
+| Parâmetro | Tipo | Padrão | Descrição |
+|-----------|------|--------|-----------|
+| `remote` | `string` | `"origin"` | Nome do remote para o qual fazer push. |
+
+**Exemplo:**
+
+```json
+{
+  "policyParams": {
+    "require-push-before-stop": {
+      "remote": "upstream"
+    }
+  }
+}
+```
+
+---
+
+### `require-pr-before-stop`
+
+**Evento:** Stop  
+**Padrão:** Nega a parada quando não existe pull request para o branch atual, ou quando o PR existente está fechado/mesclado. Instrui Claude a criar um PR com `gh pr create`.
+
+Sem parâmetros.
+
+<Note>
+Esta política requer que o [GitHub CLI](https://cli.github.com/) (`gh`) esteja instalado e autenticado.
+Execute `gh auth login` com um token de acesso pessoal que tenha escopo `repo` para acesso de leitura a
+pull requests. Se `gh` não estiver instalado ou autenticado, a política falha de forma aberta e reporta o motivo ao Claude.
+</Note>
+
+---
+
+### `require-ci-green-before-stop`
+
+**Evento:** Stop  
+**Padrão:** Nega a parada quando as verificações de CI estão falhando ou ainda em execução no branch atual. Verifica tanto as execuções de workflow do GitHub Actions quanto as verificações de bots de terceiros (ex: CodeRabbit, SonarCloud, Codecov). Trata conclusões `skipped` como sucesso. Retorna uma mensagem informativa quando todas as verificações passam.
+
+Sem parâmetros.
+
+<Note>
+Esta política requer que o [GitHub CLI](https://cli.github.com/) (`gh`) esteja instalado e autenticado.
+Execute `gh auth login` com um token de acesso pessoal que tenha escopo `repo` para acesso de leitura às
+execuções de workflow do Actions e à API de Verificações. Se `gh` não estiver instalado ou autenticado, a política falha de forma aberta e reporta o motivo ao Claude.
+</Note>
+
+---
+
+---
+
+## Desabilitando políticas individuais
+
+Remova uma política específica de `enabledPolicies` na sua configuração, ou desative-a na aba Políticas do dashboard.
+
+```json
+{
+  "enabledPolicies": [
+    "block-rm-rf",
+    "sanitize-api-keys"
+  ]
+}
+```
+
+Políticas não listadas em `enabledPolicies` não são executadas, mesmo que existam entradas de `policyParams` para elas.

package/.next/standalone/docs/pt-br/cli/dashboard.mdx

@@ -0,0 +1,28 @@
+---
+title: Ver sessões
+description: "Inicie o dashboard para visualizar sessões de agentes e gerenciar políticas"
+---
+
+```bash
+failproofai
+```
+
+Inicia o dashboard web em `http://localhost:8020`.
+
+## Opções
+
+| Flag | Descrição |
+|------|-----------|
+| `--port <number>` | Porta para escutar (padrão: `8020`) |
+| `--projects-path <path>` | Substitui o local onde as pastas de projetos do Claude Code são encontradas |
+| `--allowed-origins <origins>` | Hosts/IPs separados por vírgula com permissão de acesso aos recursos de desenvolvimento |
+
+## Exemplos
+
+```bash
+# Iniciar em uma porta diferente
+failproofai --port 9000
+
+# Usar um caminho de projetos personalizado
+failproofai --projects-path ~/my-claude-projects
+```

package/.next/standalone/docs/pt-br/cli/environment-variables.mdx

@@ -0,0 +1,34 @@
+---
+title: Variáveis de ambiente
+description: "Configure o comportamento do failproofai com variáveis de ambiente"
+---
+
+## Dashboard
+
+| Variável | Descrição |
+|----------|-----------|
+| `PORT` | Porta do dashboard (padrão: `8020`) |
+| `CLAUDE_PROJECTS_PATH` | Substitui o local onde as pastas de projetos do Claude Code são encontradas |
+| `FAILPROOFAI_DISABLE_PAGES=policies,projects` | Páginas do dashboard a ocultar, separadas por vírgula |
+| `FAILPROOFAI_ALLOWED_DEV_ORIGINS` | Hosts/IPs com permissão para acessar recursos de desenvolvimento. Equivalente a `--allowed-origins`. |
+
+## Logging
+
+| Variável | Descrição |
+|----------|-----------|
+| `FAILPROOFAI_LOG_LEVEL=info\|warn\|error` | Nível de log do servidor (padrão: `warn`) |
+| `FAILPROOFAI_HOOK_LOG_FILE` | Caminho personalizado para o arquivo de log de hooks, ou `true` para o padrão (`~/.failproofai/logs/hooks.log`) |
+
+## Telemetria
+
+| Variável | Descrição |
+|----------|-----------|
+| `FAILPROOFAI_TELEMETRY_DISABLED=1` | Desativa a telemetria anônima de uso |
+
+## LLM (para avaliação de políticas)
+
+| Variável | Descrição |
+|----------|-----------|
+| `FAILPROOFAI_LLM_BASE_URL` | Endpoint da API do LLM (padrão: `https://api.openai.com/v1`) |
+| `FAILPROOFAI_LLM_API_KEY` | Chave de API para políticas baseadas em LLM |
+| `FAILPROOFAI_LLM_MODEL` | Nome do modelo (padrão: `gpt-4o-mini`) |

package/.next/standalone/docs/pt-br/cli/hook.mdx

@@ -0,0 +1,30 @@
+---
+title: Hook handler (interno)
+description: "O subprocesso que o Claude Code chama em cada evento de ferramenta"
+---
+
+```bash
+failproofai --hook <EventType>
+```
+
+Este é o comando registrado no `settings.json` do Claude Code pelo `failproofai policies --install`. Normalmente você não o chama diretamente.
+
+Lê um payload JSON do stdin, avalia todas as políticas habilitadas e encerra com um código indicando a decisão:
+
+| Código de saída | Decisão | Efeito |
+|-----------------|---------|--------|
+| `0` | `allow` | Permite a ação |
+| `1` | `deny` | Bloqueia a ação - Claude recebe o motivo da negação |
+| `2` | `instruct` | Injeta orientações no contexto do Claude |
+
+### Tipos de eventos suportados
+
+| Categoria | Eventos |
+|-----------|---------|
+| **Execução de ferramentas** | `PreToolUse`, `PostToolUse`, `PostToolUseFailure`, `PermissionRequest`, `PermissionDenied` |
+| **Ciclo de vida da sessão** | `SessionStart`, `SessionEnd`, `Stop`, `StopFailure` |
+| **Interação com o usuário** | `UserPromptSubmit`, `Notification`, `Elicitation`, `ElicitationResult` |
+| **Subagentes e tarefas** | `SubagentStart`, `SubagentStop`, `TaskCreated`, `TaskCompleted`, `TeammateIdle` |
+| **Configuração** | `InstructionsLoaded`, `ConfigChange`, `CwdChanged` |
+| **Sistema de arquivos** | `FileChanged`, `WorktreeCreate`, `WorktreeRemove` |
+| **Contexto** | `PreCompact`, `PostCompact` |

package/.next/standalone/docs/pt-br/cli/install-policies.mdx

@@ -0,0 +1,47 @@
+---
+title: Instalar políticas
+description: "Ative políticas para que sejam executadas em cada chamada de ferramenta do agente"
+---
+
+```bash
+failproofai policies --install [policy-names...] [options]
+```
+
+Escreve entradas de hook no `settings.json` do Claude Code para que o failproofai intercepte chamadas de ferramentas.
+
+Aliases: `failproofai p -i`
+
+## Opções
+
+| Flag | Descrição |
+|------|-----------|
+| `--scope user` | Instala em `~/.claude/settings.json` (padrão - todas as sessões) |
+| `--scope project` | Instala em `.claude/settings.json` no diretório atual |
+| `--scope local` | Instala em `.claude/settings.local.json` no diretório atual |
+| `--custom <path>` / `-c` | Caminho para um arquivo JS contendo políticas de hook personalizadas |
+
+## Comportamento
+
+- **Sem nomes de política** - abre um prompt interativo para selecionar políticas
+- **Nomes específicos** - ativa essas políticas (adicionadas às que já estão ativas)
+- **`all`** - ativa todas as políticas disponíveis
+
+A instalação é aditiva: executar `--install` novamente adiciona novas políticas sem remover as existentes.
+
+## Exemplos
+
+```bash
+# Instalar todas as políticas padrão globalmente (interativo)
+failproofai policies --install
+
+# Instalar políticas específicas para o projeto atual
+failproofai policies --install block-sudo sanitize-api-keys --scope project
+
+# Ativar todas as políticas de uma vez
+failproofai policies --install all
+
+# Instalar com um arquivo de políticas personalizado
+failproofai policies --install --custom ./my-policies.js
+```
+
+Quando `--custom <path>` é fornecido, o arquivo é validado imediatamente — ele deve chamar `customPolicies.add()` pelo menos uma vez. O caminho resolvido é salvo em `policies-config.json` como `customPoliciesPath`.