failproofai 0.0.2 → 0.0.3

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

@@ -0,0 +1,564 @@
+---
+title: Políticas Integradas
+description: "Todas as 30 políticas integradas que capturam modos comuns de falha de agentes"
+icon: shield
+---
+
+failproofai vem com 30 políticas integradas que capturam modos comuns de falha 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 em beta 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 (beta)](#workflow-beta) | 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. Veja [Configuração → hint](/pt-br/configuration#hint-cross-cutting) para mais detalhes.
+</Tip>
+
+---
+
+## Comandos perigosos
+
+Impede agentes de executar 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 incluem a palavra-chave `sudo`. A correspondência de padrões é feita em tokens de comando analisados, não na string bruta, para evitar bypass via injeção de operadores 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 tokens analisados, não com a string de comando bruta. Isso impede bypass via operadores shell concatenados (ex.: `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 podem ser excluídos recursivamente com segurança (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 desinstalariam ou desativariam o próprio failproofai (ex.: `npm uninstall failproofai`, `failproofai policies --uninstall`).
+
+Sem parâmetros.
+
+---
+
+## Segredos (sanitizadores)
+
+Impede agentes de vazar credenciais para 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 de ela ser retornada ao Claude. Se um padrão de segredo for detectado, a política retorna uma decisão de negação que impede a saída de ser repassada.
+
+### `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 a serem tratados 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 embutidas (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 com o nome exato `.env`.
+
+Sem parâmetros.
+
+---
+
+### `protect-env-vars`
+
+**Evento:** PreToolUse (Bash)  
+**Padrão:** Nega comandos que imprimem variáveis de ambiente: `printenv`, `env`, `echo $VAR`.
+
+Sem parâmetros.
+
+---
+
+## Acesso a arquivos
+
+Mantém os 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 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) a serem bloqueados. |
+
+**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 em todos os branches (desativando 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 verificados diretamente. |
+
+---
+
+### `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 staged ao executar `git add -A` ou `git add .`. Não bloqueia o comando.
+
+Sem parâmetros.
+
+---
+
+## Banco de dados
+
+Identifica 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 adicional 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 do hook impõe um limite de 1 MB de stdin em 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 presos 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 (beta)
+
+Impõe um fluxo de trabalho disciplinado ao final da sessão. Essas políticas são acionadas no evento **Stop** e negam que Claude pare até que cada condição seja atendida. Elas seguem uma cadeia de dependência natural: commit → push → PR → CI. Se uma política negar, as políticas posteriores na cadeia são ignoradas (negação em curto-circuito).
+
+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 confirmadas (arquivos modificados, staged 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 ou quando o branch atual não possui branch de rastreamento remoto. Sugere `git push -u` para criar um branch de rastreamento, se necessário. Falha aberto 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/merged. 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 aberto e informa 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 fluxo de trabalho 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 fluxo de trabalho do Actions e à API de Verificações. Se `gh` não estiver instalado ou autenticado, a política falha aberto e informa o motivo ao Claude.
+</Note>
+
+---
+
+## Políticas beta
+
+Algumas políticas são marcadas como `beta` e não são instaladas por padrão. Políticas beta podem ter imperfeições ou gerar falsos positivos. Elas são promovidas para estáveis em versões futuras.
+
+**Políticas beta atuais:**
+
+- `require-commit-before-stop` — confirmar todas as alterações antes de parar
+- `require-push-before-stop` — enviar todos os commits para o remote
+- `require-pr-before-stop` — garantir que existe um PR para o branch
+- `require-ci-green-before-stop` — todas as verificações de CI devem passar
+
+Juntas, essas políticas impõem um fluxo de trabalho **commit → push → PR → CI**.
+
+Para instalar todas as políticas beta:
+
+```bash
+failproofai policies --install --beta
+```
+
+Ou instale políticas de fluxo de trabalho específicas:
+
+```bash
+failproofai policies --install require-commit-before-stop require-push-before-stop require-pr-before-stop require-ci-green-before-stop
+```
+
+Execute `failproofai policies` para ver quais políticas carregam a flag beta.
+
+---
+
+## Desativando políticas individuais
+
+Remova uma política específica de `enabledPolicies` em 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,48 @@
+---
+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]
+```
+
+Grava 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 |
+| `--beta` | Inclui políticas beta |
+
+## 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 habilitadas)
+- **`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`.