failproofai 0.0.6-beta.3 → 0.0.6-beta.5

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

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

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

@@ -1,31 +0,0 @@
----
-title: Listar políticas
-description: "Veja quais políticas estão habilitadas, seus parâmetros e políticas personalizadas"
----
-
-```bash
-failproofai policies
-```
-
-Exibe todas as políticas com seu status, parâmetros configurados e políticas personalizadas.
-
-## Exemplo de saída
-
-```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
-```
-
-Chaves desconhecidas em `policyParams` são sinalizadas aqui para que você possa identificar erros de digitação com antecedência.

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

@@ -1,43 +0,0 @@
----
-title: Desinstalar políticas
-description: "Remove entradas de hook das configurações do Claude Code"
----
-
-```bash
-failproofai policies --uninstall [policy-names...] [options]
-```
-
-Remove entradas de hook do failproofai do `settings.json` do Claude Code.
-
-Aliases: `failproofai p -u`
-
-## Opções
-
-| Flag | Descrição |
-|------|-----------|
-| `--scope user` | Remove das configurações globais (padrão) |
-| `--scope project` | Remove das configurações do projeto |
-| `--scope local` | Remove das configurações locais |
-| `--scope all` | Remove de todos os escopos de uma vez |
-| `--custom` / `-c` | Limpa o `customPoliciesPath` da configuração |
-
-## Comportamento
-
-- **Sem nomes de políticas** — remove todas as entradas de hook do failproofai do arquivo de configurações
-- **Nomes específicos** — desativa essas políticas, mas mantém os hooks instalados
-
-## Exemplos
-
-```bash
-# Remove todos os hooks globalmente
-failproofai policies --uninstall
-
-# Desativa uma política específica (mantém os hooks instalados)
-failproofai policies --uninstall block-sudo
-
-# Remove hooks de todos os escopos
-failproofai policies --uninstall --scope all
-
-# Limpa o caminho de políticas customizadas
-failproofai policies --uninstall --custom
-```

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

@@ -1,12 +0,0 @@
----
-title: Verificar versão
-description: "Exibe a versão instalada do failproofai"
----
-
-```bash
-failproofai --version
-# ou
-failproofai -v
-```
-
-Exibe o número da versão instalada.

package/.next/standalone/docs/pt-br/configuration.mdx

@@ -1,222 +0,0 @@
----
-title: Configuração
-description: "Formato do arquivo de configuração, sistema de três escopos e regras de mesclagem"
-icon: gear
----
-
-failproofai utiliza arquivos de configuração JSON para controlar quais políticas estão ativas, como elas se comportam e de onde políticas customizadas são carregadas. A configuração foi projetada para ser fácil de compartilhar com o time — faça o commit no repositório e todos os desenvolvedores terão a mesma rede de segurança para o agente.
-
----
-
-## Escopos de configuração
-
-Existem três escopos de configuração, avaliados em ordem de prioridade:
-
-| Escopo | Caminho do arquivo | Finalidade |
-|--------|--------------------|------------|
-| **project** | `.failproofai/policies-config.json` | Configurações por repositório, commitadas no controle de versão |
-| **local** | `.failproofai/policies-config.local.json` | Substituições pessoais por repositório, ignoradas pelo git |
-| **global** | `~/.failproofai/policies-config.json` | Padrões do usuário aplicados a todos os projetos |
-
-Quando failproofai recebe um evento de hook, ele carrega e mescla todos os três arquivos existentes para o diretório de trabalho atual.
-
-### Regras de mesclagem
-
-**`enabledPolicies`** — a união dos três escopos. Uma política habilitada em qualquer nível fica ativa.
-
-```text
-project:  ["block-sudo"]
-local:    ["block-rm-rf"]
-global:   ["block-sudo", "sanitize-api-keys"]
-
-resolved: ["block-sudo", "block-rm-rf", "sanitize-api-keys"]  ← união sem duplicatas
-```
-
-**`policyParams`** — o primeiro escopo que define parâmetros para uma determinada política prevalece completamente. Não há mesclagem profunda de valores dentro dos parâmetros de uma política.
-
-```text
-project:  block-sudo → { allowPatterns: ["sudo apt-get update"] }
-global:   block-sudo → { allowPatterns: ["sudo systemctl status"] }
-
-resolved: { allowPatterns: ["sudo apt-get update"] }   ← project prevalece, global ignorado
-```
-
-```text
-project:  (sem entrada para block-sudo)
-local:    (sem entrada para block-sudo)
-global:   block-sudo → { allowPatterns: ["sudo systemctl status"] }
-
-resolved: { allowPatterns: ["sudo systemctl status"] }  ← cai para o global
-```
-
-**`customPoliciesPath`** — o primeiro escopo que o definir prevalece.
-
-**`llm`** — o primeiro escopo que o definir prevalece.
-
----
-
-## Formato do arquivo de configuração
-
-```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"
-}
-```
-
----
-
-## Referência de campos
-
-### `enabledPolicies`
-
-Tipo: `string[]`
-
-Lista de nomes de políticas a habilitar. Os nomes devem corresponder exatamente aos identificadores de política exibidos por `failproofai policies`. Consulte [Políticas Integradas](/pt-br/built-in-policies) para a lista completa.
-
-Políticas que não estão em `enabledPolicies` ficam inativas, mesmo que possuam entradas em `policyParams`.
-
-### `policyParams`
-
-Tipo: `Record<string, Record<string, unknown>>`
-
-Substituições de parâmetros por política. A chave externa é o nome da política; as chaves internas são específicas de cada política. Cada política documenta seus parâmetros disponíveis em [Políticas Integradas](/pt-br/built-in-policies).
-
-Se uma política possui parâmetros, mas você não os especifica, os padrões integrados da política são utilizados. Usuários que não configuram `policyParams` obtêm comportamento idêntico ao das versões anteriores.
-
-Chaves desconhecidas dentro do bloco de parâmetros de uma política são silenciosamente ignoradas no momento do disparo do hook, mas sinalizadas como avisos quando você executa `failproofai policies`.
-
-#### `hint` (transversal)
-
-Tipo: `string` (opcional)
-
-Uma mensagem anexada ao motivo quando uma política retorna `deny` ou `instruct`. Use para fornecer orientações acionáveis ao Claude sem modificar a política em si.
-
-Funciona com qualquer tipo de política — integrada, customizada (`custom/`), convenção de projeto (`.failproofai-project/`) ou convenção do usuário (`.failproofai-user/`).
-
-```json
-{
-  "policyParams": {
-    "block-force-push": {
-      "hint": "Try creating a fresh branch instead."
-    },
-    "block-sudo": {
-      "allowPatterns": ["sudo apt-get"],
-      "hint": "Use apt-get directly without sudo."
-    },
-    "custom/my-policy": {
-      "hint": "Ask the user for approval first."
-    }
-  }
-}
-```
-
-Quando `block-force-push` nega, Claude vê: *"Force-pushing is blocked. Try creating a fresh branch instead."*
-
-Valores não textuais e strings vazias são silenciosamente ignorados. Se `hint` não estiver definido, o comportamento permanece inalterado (compatível com versões anteriores).
-
-### `customPoliciesPath`
-
-Tipo: `string` (caminho absoluto)
-
-Caminho para um arquivo JavaScript contendo políticas de hook customizadas. Este valor é definido automaticamente por `failproofai policies --install --custom <path>` (o caminho é resolvido para absoluto antes de ser armazenado).
-
-O arquivo é carregado novamente a cada evento de hook — não há cache. Consulte [Políticas Customizadas](/pt-br/custom-policies) para detalhes sobre como criá-las.
-
-### Políticas baseadas em convenção
-
-Além do `customPoliciesPath` explícito, failproofai descobre e carrega automaticamente arquivos de política dos diretórios `.failproofai/policies/`:
-
-| Nível | Diretório | Escopo |
-|-------|-----------|--------|
-| Projeto | `.failproofai/policies/` | Compartilhado com o time via controle de versão |
-| Usuário | `~/.failproofai/policies/` | Pessoal, aplicado a todos os projetos |
-
-**Correspondência de arquivos:** Somente arquivos que correspondam a `*policies.{js,mjs,ts}` são carregados (ex.: `security-policies.mjs`, `workflow-policies.js`). Outros arquivos no diretório são ignorados.
-
-**Sem necessidade de configuração:** Políticas de convenção não requerem entradas em `policies-config.json`. Basta colocar os arquivos no diretório e eles serão detectados no próximo evento de hook.
-
-**Carregamento por união:** Tanto o diretório de convenção do projeto quanto o do usuário são verificados. Todos os arquivos correspondentes de ambos os níveis são carregados (ao contrário de `customPoliciesPath`, que utiliza o primeiro escopo que prevalece).
-
-Consulte [Políticas Customizadas](/pt-br/custom-policies) para mais detalhes e exemplos.
-
-### `llm`
-
-Tipo: `object` (opcional)
-
-Configuração do cliente LLM para políticas que realizam chamadas de IA. Não é necessário para a maioria das configurações.
-
-```json
-{
-  "llm": {
-    "model": "claude-sonnet-4-6",
-    "apiKey": "sk-ant-..."
-  }
-}
-```
-
----
-
-## Gerenciando a configuração pela CLI
-
-Os comandos `policies --install` e `policies --uninstall` escrevem no `settings.json` do Claude Code (os pontos de entrada do hook), enquanto `policies-config.json` é o arquivo que você gerencia diretamente. Os dois são separados:
-
-- **`settings.json`** — instrui o Claude Code a chamar `failproofai --hook <event>` a cada uso de ferramenta
-- **`policies-config.json`** — instrui failproofai sobre quais políticas avaliar e com quais parâmetros
-
-Você pode editar `policies-config.json` diretamente a qualquer momento; as alterações entram em vigor imediatamente no próximo evento de hook, sem necessidade de reinicialização.
-
----
-
-## Exemplo: configuração no nível do projeto com padrões da equipe
-
-Faça o commit de `.failproofai/policies-config.json` no seu repositório:
-
-```json
-{
-  "enabledPolicies": [
-    "block-sudo",
-    "block-rm-rf",
-    "block-push-master",
-    "sanitize-api-keys",
-    "block-env-files"
-  ],
-  "policyParams": {
-    "block-push-master": {
-      "protectedBranches": ["main", "release", "hotfix"]
-    }
-  }
-}
-```
-
-Cada desenvolvedor pode então criar `.failproofai/policies-config.local.json` (ignorado pelo git) para substituições pessoais sem afetar os colegas de equipe.