failproofai 1.0.1-beta.1 → 1.0.1

package/.next/standalone/docs-old/pt-br/cli/audit.mdx

@@ -0,0 +1,132 @@
+---
+title: Auditar sessões passadas (beta)
+description: "Conte com que frequência o agente fez coisas desnecessárias ou arriscadas em transcrições anteriores"
+---
+
+<Note>
+  **Recurso em beta.** O recurso de auditoria é lançado em beta enquanto coletamos feedback inicial.
+  O catálogo de detectores e o formato do relatório podem mudar antes da próxima versão estável.
+  Abra uma issue se algo parecer errado.
+</Note>
+
+A auditoria reproduz suas transcrições passadas da CLI do agente pelo mecanismo de políticas do failproofai
+e gera um relatório visual e compartilhável na **página do dashboard `/audit`**
+— o arquétipo do seu agente, uma pontuação de 0–100 e exatamente quais políticas
+teriam identificado o quê.
+
+## Como executar
+
+Três formas de acessar — todas levam ao mesmo relatório `/audit`.
+
+<CodeGroup>
+
+```bash npx (sem instalação)
+npx -y failproofai audit
+```
+
+```bash failproofai audit
+failproofai audit
+```
+
+```bash failproofai (dashboard)
+failproofai
+```
+
+</CodeGroup>
+
+<CardGroup cols={3}>
+  <Card title="Sem instalação" icon="bolt">
+    `npx -y failproofai audit` baixa o failproofai, executa a varredura e abre o
+    dashboard para você — nada precisa ser instalado antes.
+  </Card>
+  <Card title="Pelo CLI" icon="terminal">
+    `failproofai audit` executa a varredura no seu terminal e abre
+    `localhost:8020/audit` automaticamente ao finalizar.
+  </Card>
+  <Card title="Pelo dashboard" icon="gauge">
+    Execute `failproofai` e clique em **Audit** na barra de navegação (entre Policies e
+    Projects), ou abra `/audit` diretamente.
+  </Card>
+</CardGroup>
+
+<Tip>
+  Execute `failproofai audit -h` (ou `--help`) para ver o uso. A auditoria roda **completamente
+  offline** — sem conta ou rede necessária — e o dashboard continua disponível
+  até você encerrá-lo com `Ctrl+C`.
+</Tip>
+
+O dashboard varre transcrições passadas da CLI do agente nesta máquina (Claude Code, Codex, Copilot, Cursor, OpenCode, Pi) e relata com que frequência o agente fez coisas que o failproofai foi criado para prevenir — verificações de variáveis de ambiente, force pushes, prefixos redundantes `cd <cwd>`, loops de polling com sleep, releitura de arquivos recém-editados, e mais.
+
+Para cada transcrição, cada evento de uso de ferramenta é reproduzido pelas 39 políticas embutidas **e** pelos 8 detectores exclusivos de auditoria que identificam padrões ainda não cobertos por políticas em tempo real. As contagens são agregadas por política/detector em todas as sessões.
+
+## O que você recebe
+
+A página `/audit` é um **pôster** de tela única e compartilhável seguido por quatro seções abaixo da dobra:
+
+1. **Pôster** — a identidade do seu agente em um relance: seu **arquétipo** (um de 8 — `optimist`, `cowboy`, `explorer`, `goldfish`, `paranoid architect`, `precision builder`, `hammer`, `ghost`), as palavras-chave da persona, o quão raro esse arquétipo é e uma **pontuação de 0–100** com uma faixa de nível (`S` até `bottom tier`). Feito para compartilhar — poste no X ou LinkedIn, ou baixe como PNG.
+2. **`// strengths`** — o que seu agente já faz bem, como números reais da varredura (ex.: % de chamadas de ferramenta limpas, `0` tentativas de push para main), exibido apenas onde a política relevante tem um histórico limpo.
+3. **`// quirks`** — o que passou despercebido: uma tabela classificada de comportamentos que o failproofai teria capturado — *quando* aconteceu pela última vez, *o que passou* (e o detector embutido que teria bloqueado), sua *gravidade* e com que frequência foi *visto* (`new` / `recurring` / `N× seen`).
+4. **`// how to improve`** — a lista de correções prescritas: uma linha por política com um `failproofai policy add <slug>` para copiar e colar, além de um botão **install all** que habilita todas as recomendações de uma vez e mostra sua **pontuação projetada** caso você o faça.
+5. **`// come back better`** — crie o hábito: defina um **lembrete** de re-auditoria por e-mail (`3d` / `7d` / `14d` / `30d`) ou re-audite agora, e **convide um amigo** para fazer sua própria auditoria (enviado pelo failproof.ai, com cópia para você). Lembretes e convites requerem login.
+
+## Auditorias agendadas
+
+Se você executa o **daemon failproofaid** (veja [`failproofai config`](/pt-br/cli/install-policies)),
+ele pode re-executar a auditoria para você em um agendamento e atualizar o relatório `/audit`
+em segundo plano. Está **desativado por padrão**, pois a varredura lê o *conteúdo*
+de cada transcrição de sessão do agente nesta máquina — nada é varrido por um timer
+até que você solicite.
+
+Ative em `~/.failproofai/config.toml`:
+
+```toml
+[audit]
+auto = true
+interval_days = 7
+```
+
+| Chave | Significado |
+|---|---|
+| `auto` | `true` habilita a varredura agendada. Qualquer outra coisa — ausente, `false`, `"yes"` — está desativado. |
+| `interval_days` | Dias entre varreduras. Limitado a 1–90; `0`, um número negativo ou não numérico cai de volta para `7`. |
+
+- O agendamento é **baseado no relógio de parede**, então sobrevive a suspensões e reinicializações: um laptop
+  que estava dormindo além do horário previsto executa **uma vez** ao acordar, nunca um acúmulo.
+- Cada execução é um processo separado de baixa prioridade (`nice 19`) — nunca o caminho de hook do daemon,
+  que permanece livre para responder a chamadas de ferramentas.
+- Uma varredura é ignorada se `failproofai audit` ou o re-run do dashboard já estiver em andamento; ela é
+  repetida logo depois em vez de ser tratada como falha.
+- O progresso é gravado em `~/.failproofai/state/audit-schedule.json` (última execução,
+  próximo prazo). O daemon é o responsável por esse arquivo — altere a cadência em `config.toml`.
+
+<Note>
+Se você habilitou isso em uma máquina configurada com uma versão mais antiga do failproofai, execute
+`failproofai config` uma vez. A definição de serviço do daemon precisa de uma entrada extra
+antes de poder iniciar o CLI, e a atualização faz parte desse comando.
+</Note>
+
+## Detectores exclusivos de auditoria
+
+Esses detectores identificam padrões de "comportamento ineficiente" que não são (ainda) aplicados em tempo real. Eles são executados apenas durante a auditoria e nunca bloqueiam uma chamada de ferramenta ao vivo.
+
+| Detector | O que conta |
+|---|---|
+| `redundant-cd-cwd` | Comandos Bash começando com `cd <cwd> && …` mesmo que os comandos já sejam executados em `cwd`. |
+| `prefer-edit-over-read-cat` | `cat`/`head`/`tail`/`less`/`more` em um único arquivo fonte — use a ferramenta `Read`. |
+| `prefer-edit-over-sed-awk` | Edições in-place com `sed -i` / `awk … > file` — use a ferramenta `Edit`. |
+| `prefer-write-over-heredoc` | Escrita de arquivos com Heredoc / `echo > file` multilinha — use a ferramenta `Write`. |
+| `sleep-polling-loop` | `sleep N` longo (≥ 30s) ou loops de polling `while …; sleep …; done`. |
+| `find-from-root` | `find /`, `find /home`, `find /usr`, etc. — limite ao `cwd` em vez disso. |
+| `git-commit-no-verify` | `git commit … --no-verify` / `-n`, ignorando hooks. |
+| `reread-after-edit` | `Read` de um arquivo que acabou de ser editado com `Edit`/`Write` na mesma sessão. |
+
+## Caches
+
+- **Cache por transcrição** em `~/.failproofai/cache/audit/<sha1>.json` com chave por `(mtime, size, engineVersion, detectorVersion)` — invalidado automaticamente quando a transcrição ou o código de política/detector muda. Cada entrada também armazena um timestamp `cachedAt` como **metadado de TTL** (não faz parte da chave de cache); entradas com mais de **7 dias** são rejeitadas na leitura para que resultados de longa duração não sobrevivam à evolução da intenção dos detectores.
+- **Cache do resultado completo** em `~/.failproofai/audit-dashboard.json` (modo 0600). Permite que o dashboard seja renderizado instantaneamente na navegação sem re-executar. Também rejeitado na leitura após o **TTL de 7 dias** — `/audit` então cai em seu estado vazio e solicita uma nova execução. Clique em `[ re-audit now ]` próximo ao final do relatório para atualizar — o re-audit envia `noCache: true`, contornando o cache por transcrição e revarrendo todas as transcrições em vez de retornar o resultado em cache; a execução transmite o progresso via uma faixa fixa no topo e substitui o resultado no lugar ao concluir com sucesso (sem recarregamento de página; um re-audit com falha mantém o relatório anterior).
+
+## Notas
+
+- **Sem mutação.** A auditoria é reproduzida em modo somente leitura. `warn-repeated-tool-calls` é ignorado porque seu sidecar por sessão seria modificado de outra forma.
+- **Políticas de fluxo de trabalho ignoradas.** Políticas `require-*-before-stop` são acionadas apenas em eventos `Stop` e `execSync` contra o estado git ao vivo — elas não têm uma interpretação significativa de "o que teria acontecido em 2025", portanto não aparecem nas contagens de auditoria.
+- **Políticas personalizadas ignoradas.** Hooks personalizados fornecidos pelo usuário não são reproduzidos (eles podem ter mudado desde a sessão original).

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

@@ -0,0 +1,29 @@
+---
+title: Visualizar sessões
+description: "Inicie o painel para navegar pelas sessões do agente e gerenciar políticas"
+---
+
+```bash
+failproofai
+```
+
+Inicia o painel web em `http://localhost:8020`.
+
+## Opções
+
+| Flag | Descrição |
+|------|-----------|
+| `--port <number>` | Porta para escutar (padrão: `8020`) |
+| `--allowed-origins <origins>` | Hosts/IPs separados por vírgula com permissão para acessar recursos de desenvolvimento |
+
+Para apontar o painel para uma pasta de projeto Claude diferente da padrão, defina a variável de ambiente `CLAUDE_PROJECTS_PATH` ao iniciar.
+
+## Exemplos
+
+```bash
+# Iniciar em uma porta diferente
+failproofai --port 9000
+
+# Usar um caminho de projetos Claude personalizado via variável de ambiente
+CLAUDE_PROJECTS_PATH=~/my-claude-projects failproofai
+```

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

@@ -0,0 +1,72 @@
+---
+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`. |
+
+## Logs
+
+| 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
+
+O failproofai envia telemetria de uso anônima por padrão. Há duas formas de
+desativá-la, e prevalece sempre a mais restritiva — uma variável de ambiente
+nunca pode reativar algo que o arquivo de configuração desligou.
+
+| Variável | Descrição |
+|----------|-----------|
+| `FAILPROOFAI_TELEMETRY_DISABLED=1` | Desativa a telemetria de uso anônima para este processo |
+
+Para desativar permanentemente na máquina, adicione o seguinte ao `~/.failproofai/config.toml`:
+
+```toml
+[telemetry]
+enabled = false
+```
+
+<Note>
+O arquivo de configuração é a opção recomendada se você executa o **daemon failproofaid**.
+O daemon é um serviço de escopo do sistema, e seu ambiente não inclui
+variáveis exportadas pelo seu shell — portanto, `FAILPROOFAI_TELEMETRY_DISABLED` não
+chega até ele. `[telemetry] enabled = false` é lido tanto pela CLI quanto pelo daemon.
+</Note>
+
+O daemon reporta apenas seu próprio **ciclo de vida**: quando iniciou (e se a
+execução anterior encerrou corretamente), quando parou, quando seu worker de avaliação
+foi iniciado ou reiniciado, quando uma tarefa de coleta falhou e o resultado de uma
+sincronização de políticas da nuvem. Esses eventos carregam valores de baixa cardinalidade
+e contagens — nunca um caminho de arquivo, um comando, uma política, um prompt ou
+qualquer conteúdo lido de uma transcrição. Não há evento por chamada de ferramenta.
+
+## Autenticação
+
+| Variável | Descrição |
+|----------|-----------|
+| `FAILPROOF_API_URL` | Substitui a URL base do servidor de API usada pelo diálogo de autenticação do dashboard. O padrão é `https://api.befailproof.ai`; defina como `http://localhost:8080` (ou outro endereço) ao executar um servidor de API local. |
+| `FAILPROOFAI_AUTH_DIR` | Substitui o local onde `auth.json` é armazenado (padrão: `~/.failproofai`). Útil principalmente para testes isolados. |
+
+## Prompt de primeira execução
+
+| Variável | Descrição |
+|----------|-----------|
+| `FAILPROOFAI_NO_FIRST_RUN=1` | Ignora o prompt que oferece a instalação de políticas na primeira invocação simples do `failproofai` |
+
+## 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-old/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-old/pt-br/cli/install-policies.mdx

@@ -0,0 +1,57 @@
+---
+title: Instalar políticas
+description: "Habilite 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 arquivo de configurações do CLI do agente instalado (Claude Code, OpenAI Codex ou GitHub Copilot CLI _(beta)_) para que o failproofai intercepte as chamadas de ferramentas.
+
+Aliases: `failproofai p -i`
+
+## Opções
+
+| Flag | Descrição |
+|------|-----------|
+| `--cli claude\|codex\|copilot` | CLI(s) do agente para instalação; separados por espaço (ex.: `--cli claude codex copilot`) ou repetidos. Omita para detectar os CLIs instalados e exibir um prompt. |
+| `--scope user` | Instala no arquivo de configurações com escopo de usuário (Claude: `~/.claude/settings.json`; Codex: `~/.codex/hooks.json`; Copilot: `~/.copilot/hooks/failproofai.json`). Padrão. |
+| `--scope project` | Instala no arquivo de configurações com escopo de projeto (Claude: `<cwd>/.claude/settings.json`; Codex: `<cwd>/.codex/hooks.json`; Copilot: `<cwd>/.github/hooks/failproofai.json`). |
+| `--scope local` | Apenas Claude — instala em `<cwd>/.claude/settings.local.json`. Codex e Copilot não possuem escopo `local`. |
+| `--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** — habilita essas políticas (adicionadas às que já estiverem habilitadas)
+- **`all`** — habilita 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
+
+# Habilitar 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
+
+# Instalar para OpenAI Codex (escopo de projeto)
+failproofai policies --install --cli codex --scope project
+
+# Instalar para GitHub Copilot CLI (beta) no projeto atual
+failproofai policies --install --cli copilot --scope project
+
+# Instalar para os três CLIs de uma vez
+failproofai policies --install --cli claude codex copilot
+```
+
+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-old/pt-br/cli/list-policies.mdx

@@ -0,0 +1,31 @@
+---
+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 rapidamente.

package/.next/standalone/docs-old/pt-br/cli/migrate.mdx

@@ -0,0 +1,86 @@
+---
+title: Migrar o diretório home
+description: "Atualiza o ~/.failproofai para o layout desta versão e permite visualizar o que aconteceria antes de executar"
+---
+
+```bash
+failproofai migrate --dry-run   # exibe o plano, sem alterar nada
+failproofai migrate             # executa a migração
+```
+
+A maioria das pessoas nunca precisa digitar isso. O comando roda automaticamente no primeiro uso após uma atualização, e o [`failproofai update`](/pt-br/cli/update) já o inclui. Use-o diretamente quando quiser ver o plano antes de executá-lo, ou para rodar a migração de forma isolada.
+
+## Baseado no layout, não na versão
+
+`~/.failproofai/VERSION` registra um número de **layout** — a estrutura do diretório, não a versão que o criou. As migrações são vinculadas a esse número, o que torna saltos longos baratos:
+
+- As versões do npm mudam a cada release, podendo haver dezenas delas entre dois layouts.
+- Assim, uma máquina que pula trinta releases **sem mudança de layout** executa **zero** migrações, e não trinta operações sem efeito.
+- E uma máquina que pula vários layouts de uma vez executa cada etapa em ordem, sendo que cada etapa conhece apenas suas próprias duas extremidades.
+
+Isso importa porque o npm não consegue atualizar um pacote instalado sozinho. Uma máquina que fica em uma versão por meses e depois avança vários layouts é o caso normal, não o excepcional.
+
+## O dry run
+
+`--dry-run` exibe a cadeia exata e os arquivos que seriam salvos antes, sem alterar absolutamente nada — sem migração, sem backup, sem registro no ledger:
+
+```
+Layout 2 on disk; this build speaks 3.
+1 step(s) would run:
+  2 → 3  layout 2 → 3: carry config.toml and credentials.toml into JSON, move
+         custom-policies/ back up into policies/, nest the policy config at the root
+
+These would be copied to ~/.failproofai/migrations/backup-layout2 first:
+  VERSION
+  config.toml
+  credentials.toml
+```
+
+## O que é preservado e o que é reconstruído
+
+Cada caminho no diretório home declara que tipo de dado contém, e isso determina se uma migração pode descartá-lo. A regra: **dados derivados e que podem ser obtidos novamente podem ser descartados; qualquer coisa que você digitou, qualquer coisa ainda não entregue e qualquer coisa que identifica a máquina é preservada.**
+
+| Preservado | Reconstruído ou obtido novamente |
+|---|---|
+| `config.json` — configurações, `daemon.configured`, caminhos de captura extras | O cache de auditoria |
+| `credentials.json` — seu registro na nuvem | Deployments gerenciados na nuvem (obtidos novamente e verificados por digest na próxima consulta) |
+| `policies-config.json` — sua seleção de políticas e parâmetros | Estado temporário do daemon |
+| `policies/` — seus próprios arquivos de política e os helpers que eles importam | |
+| `hook-activity/` — o log de decisões que o dashboard lê | |
+| Eventos não entregues ainda na fila para upload | |
+| `cursors/` — marcadores d'água do coletor | |
+| O binário do daemon em `bin/` | |
+
+<Note>
+  Os eventos não entregues são preservados em vez de descartados porque a perda seria permanente, não apenas lenta: o marcador d'água do coletor já avançou além de qualquer coisa no spool, então nada jamais leria aquele intervalo de uma transcrição novamente. A migração também solicita ao daemon que entregue o que está no spool assim que terminar, então o resultado habitual é que não há nada a preservar.
+</Note>
+
+Chaves que uma versão *mais recente* gravou em `config.json`, `credentials.json` ou `policies-config.json` também são preservadas, em vez de serem descartadas por um leitor mais antigo.
+
+## O registro que fica
+
+```
+~/.failproofai/migrations/
+  applied.json                 uma entrada por etapa: layout, CLI, timestamp, duração, resultado
+  backup-layout<n>/            cópias dos arquivos insubstituíveis, tiradas antes da primeira etapa
+```
+
+`applied.json` é o que responde à pergunta "o que esta máquina realmente passou" — a primeira coisa a verificar quando algo parece errado após uma atualização. Anexe-o a um relatório de bug.
+
+O backup é deliberadamente pequeno em vez de uma cópia do diretório inteiro: a migração não exclui mais nada insubstituível por design, então o que vale proteger é um *defeito em uma etapa*, e esses poucos arquivos são onde tal defeito causaria dano.
+
+## Se uma etapa falhar
+
+A cadeia para ali. `VERSION` é atualizado apenas por uma etapa concluída com sucesso, então o diretório home permanece marcado com seu layout antigo e o próximo comando tenta novamente — um diretório home nunca é marcado como atual com base em uma migração parcial. A etapa é registrada em `applied.json` com `"ok": false`, e o backup permanece onde foi criado.
+
+## Um diretório home mais novo é recusado, não migrado
+
+Se `~/.failproofai/` foi escrito por um failproofai **mais novo** do que o que você está executando, o comando para e pede para você fazer upgrade. Esses dados estão íntegros e uma CLI mais nova os lê; migrar "para frente" a partir deles não é algo que existe, e reiniciá-los destruiria algo recuperável.
+
+```
+This machine's failproofai directory was written by a newer version (layout 4;
+this build speaks 3). Upgrade rather than migrate:
+  npm install -g failproofai@latest
+```
+
+O daemon aplica a mesma regra: `failproofaid` se recusa a iniciar com um layout que não conhece, em vez de ler e escrever em caminhos que foram movidos.

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

@@ -0,0 +1,43 @@
+---
+title: Desinstalar políticas
+description: "Remover 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` | Remover das configurações globais (padrão) |
+| `--scope project` | Remover das configurações do projeto |
+| `--scope local` | Remover das configurações locais |
+| `--scope all` | Remover de todos os escopos de uma vez |
+| `--custom` / `-c` | Limpar o `customPoliciesPath` da configuração |
+
+## Comportamento
+
+- **Sem nomes de política** - 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
+# Remover todos os hooks globalmente
+failproofai policies --uninstall
+
+# Desativar uma política específica (mantém os hooks instalados)
+failproofai policies --uninstall block-sudo
+
+# Remover hooks de todos os escopos
+failproofai policies --uninstall --scope all
+
+# Limpar o caminho de políticas customizadas
+failproofai policies --uninstall --custom
+```

package/.next/standalone/docs-old/pt-br/cli/update.mdx

@@ -0,0 +1,64 @@
+---
+title: Atualizar após um upgrade
+description: "Conclua a metade de um upgrade que o npm não consegue fazer: migrar o diretório home e sincronizar o daemon"
+---
+
+```bash
+npm install -g failproofai@latest && failproofai update
+```
+
+Esse é o upgrade completo. O `npm` substitui o CLI; o `failproofai update` cuida do restante.
+
+## Por que existe um segundo comando
+
+O `npm install -g` substitui apenas uma coisa — o CLI. Outras duas partes de uma instalação do failproofai ficam fora do pacote propositalmente, e nenhuma delas é movida quando o npm é executado:
+
+- **`~/.failproofai/`**, suas configurações, registro na nuvem, seleção de políticas e histórico. Uma nova versão pode organizá-los de forma diferente, e essa reorganização precisa ser feita por código que conhece ambos os formatos.
+- **O binário do daemon `failproofaid`**, em `~/.failproofai/bin/failproofaid-<version>`. Ele deliberadamente *não* fica dentro de `node_modules`: um upgrade que substituísse o arquivo enquanto o serviço está em execução apontaria um daemon ativo para um binário compilado a partir de um código-fonte diferente, e remover o pacote o excluiria de baixo de um serviço que passaria a entrar em loop de falha a cada inicialização.
+
+Portanto, após apenas o `npm install -g`, o CLI está atualizado, mas o daemon não está. O `failproofaid` se recusa a iniciar com um layout de diretório home que não reconhece — a versão ruidosa dessa incompatibilidade, e não a silenciosa — então as duas metades precisam ser sincronizadas. O `failproofai update` é essa etapa.
+
+## O que ele faz
+
+<Steps>
+  <Step title="Executa quaisquer migrações de layout pendentes">
+    Lê o layout registrado em `~/.failproofai/VERSION` e executa as etapas necessárias para atualizá-lo para o que esta versão utiliza. Normalmente nenhuma — consulte [`failproofai migrate`](/pt-br/cli/migrate).
+  </Step>
+  <Step title="Instala o binário do daemon correspondente">
+    A partir do pacote de plataforma que o npm já baixou, quando possível (sem necessidade de rede), ou do asset de release desta versão exata, verificado via SHA-256 antes do uso.
+  </Step>
+  <Step title="Reinicia o serviço e confirma que ele voltou a funcionar">
+    Verificado ativamente, não assumido — um gerenciador de serviços reporta um processo como ativo no momento em que ele é criado, o que não é o mesmo que estar funcionando corretamente.
+  </Step>
+</Steps>
+
+## Opções
+
+| Flag | Efeito |
+|------|--------|
+| `--no-daemon` | Migra apenas o diretório home, deixando o daemon na sua versão atual. |
+
+<Warning>
+  O `--no-daemon` deixa um daemon com versão desatualizada em execução. Em uma máquina configurada para exigir o daemon, cada evento de hook **falha de forma fechada** se o daemon não conseguir responder — e um daemon que se recusa a iniciar com um diretório home migrado não conseguirá responder. Prefira deixar a metade do daemon ser executada.
+</Warning>
+
+## Se algo der errado
+
+O comando termina com código diferente de zero e informa qual metade falhou. Dois casos que vale conhecer:
+
+- **Uma etapa de migração não foi concluída.** O diretório home é mantido marcado com seu layout *antigo*, para que o próximo comando tente novamente — nenhum diretório home é marcado como atual com base em uma migração parcial. Cópias das suas configurações e registro foram salvas antes de qualquer execução, em `~/.failproofai/migrations/backup-layout<n>/`.
+- **O daemon não pôde ser reiniciado sem uma senha.** O `sudo -n` é usado deliberadamente, para que nada solicite uma senha a partir de uma tela de progresso. O comando imprime a linha exata para você executar manualmente.
+
+<Note>
+  Nada aqui requer o assistente de configuração interativo. Suas configurações, registro na nuvem e seleção de políticas sobrevivem a um upgrade, portanto uma máquina migrada aplica exatamente as mesmas regras de antes — o que é mais importante nas máquinas sem ninguém à frente delas: um runner de CI, uma máquina em uma frota, um gateway headless.
+</Note>
+
+## Automatizando
+
+O `failproofai update` é não interativo e seguro para executar quando não há nada a fazer — ele reporta "nenhuma migração foi necessária" e termina com código 0. Adicioná-lo após cada upgrade em um script de provisionamento ou Dockerfile é o uso pretendido:
+
+```dockerfile
+RUN npm install -g failproofai@latest && failproofai update --no-daemon
+```
+
+(`--no-daemon` em uma build de imagem, onde ainda não há serviço para reiniciar.)

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

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