failproofai 0.0.6-beta.2 → 0.0.6-beta.4

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

@@ -1,307 +0,0 @@
----
-title: Exemplos
-description: "Como configurar hooks para Claude Code e o Agents SDK"
-icon: book-open
----
-
-Exemplos prontos para uso em cenários comuns. Cada um mostra como instalar e o que esperar.
-
----
-
-## Configurando hooks para Claude Code
-
-O Failproof AI se integra ao Claude Code por meio do seu [sistema de hooks](https://docs.anthropic.com/en/docs/claude-code/hooks). Quando você executa `failproofai policies --install`, ele registra comandos de hook no `settings.json` do Claude Code, que são acionados a cada chamada de ferramenta.
-
-<Steps>
-  <Step title="Instalar o failproofai">
-    ```bash
-    npm install -g failproofai
-    ```
-  </Step>
-  <Step title="Habilitar todas as políticas integradas">
-    ```bash
-    failproofai policies --install
-    ```
-  </Step>
-  <Step title="Verificar se os hooks foram registrados">
-    ```bash
-    cat ~/.claude/settings.json | grep failproofai
-    ```
-
-    Você deve ver entradas de hook para os eventos `PreToolUse`, `PostToolUse`, `Notification` e `Stop`.
-  </Step>
-  <Step title="Executar o Claude Code">
-    ```bash
-    claude
-    ```
-
-    As políticas agora são executadas automaticamente a cada chamada de ferramenta. Tente pedir ao Claude para executar `sudo rm -rf /` — o comando será bloqueado.
-  </Step>
-</Steps>
-
----
-
-## Configurando hooks para o Agents SDK
-
-Se você está desenvolvendo com o [Agents SDK](https://docs.anthropic.com/en/docs/agents-sdk), pode usar o mesmo sistema de hooks de forma programática.
-
-<Steps>
-  <Step title="Instalar o failproofai no seu projeto">
-    ```bash
-    npm install failproofai
-    ```
-  </Step>
-  <Step title="Configurar hooks no seu agente">
-    Passe comandos de hook ao criar o processo do seu agente. Os hooks são acionados da mesma forma que no Claude Code — via stdin/stdout JSON:
-
-    ```bash
-    failproofai --hook PreToolUse   # chamado antes de cada ferramenta
-    failproofai --hook PostToolUse  # chamado após cada ferramenta
-    ```
-  </Step>
-  <Step title="Escrever uma política personalizada para seu agente">
-    ```javascript
-    import { customPolicies, allow, deny } from "failproofai";
-
-    customPolicies.add({
-      name: "limit-to-project-dir",
-      description: "Mantém o agente dentro do diretório do projeto",
-      match: { events: ["PreToolUse"] },
-      fn: async (ctx) => {
-        const path = String(ctx.toolInput?.file_path ?? "");
-        if (path.startsWith("/") && !path.startsWith(ctx.session?.cwd ?? "")) {
-          return deny("Agent is restricted to the project directory");
-        }
-        return allow();
-      },
-    });
-    ```
-  </Step>
-  <Step title="Instalar a política personalizada">
-    ```bash
-    failproofai policies --install --custom ./my-agent-policies.js
-    ```
-  </Step>
-</Steps>
-
----
-
-## Bloquear comandos destrutivos
-
-A configuração mais comum — impede que agentes causem danos irreversíveis.
-
-```bash
-failproofai policies --install block-sudo block-rm-rf block-force-push block-curl-pipe-sh
-```
-
-O que isso faz:
-- `block-sudo` — bloqueia todos os comandos `sudo`
-- `block-rm-rf` — bloqueia a exclusão recursiva de arquivos
-- `block-force-push` — bloqueia `git push --force`
-- `block-curl-pipe-sh` — bloqueia o redirecionamento de scripts remotos para o shell
-
----
-
-## Prevenir vazamento de segredos
-
-Impede que agentes visualizem ou vazem credenciais na saída de ferramentas.
-
-```bash
-failproofai policies --install sanitize-api-keys sanitize-jwt sanitize-connection-strings sanitize-bearer-tokens
-```
-
-Essas políticas são acionadas no `PostToolUse` — após a execução de uma ferramenta, elas limpam a saída antes que o agente a veja.
-
----
-
-## Receber alertas no Slack quando agentes precisam de atenção
-
-Use o hook de notificação para encaminhar alertas de inatividade ao Slack.
-
-```javascript
-import { customPolicies, allow, instruct } from "failproofai";
-
-customPolicies.add({
-  name: "slack-on-idle",
-  description: "Alerta o Slack quando o agente está aguardando entrada",
-  match: { events: ["Notification"] },
-  fn: async (ctx) => {
-    const webhookUrl = process.env.SLACK_WEBHOOK_URL;
-    if (!webhookUrl) return allow();
-
-    const message = String(ctx.payload?.message ?? "Agent is waiting");
-    const project = ctx.session?.cwd ?? "unknown";
-
-    try {
-      await fetch(webhookUrl, {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({
-          text: `*${message}*\nProject: \`${project}\``,
-        }),
-        signal: AbortSignal.timeout(5000),
-      });
-    } catch {
-      // nunca bloqueie o agente se o Slack estiver inacessível
-    }
-
-    return allow();
-  },
-});
-```
-
-Instale:
-
-```bash
-SLACK_WEBHOOK_URL=https://hooks.slack.com/... failproofai policies --install --custom ./slack-alerts.js
-```
-
----
-
-## Manter agentes em uma branch
-
-Impede que agentes troquem de branch ou façam push em branches protegidas.
-
-```javascript
-import { customPolicies, allow, deny } from "failproofai";
-
-customPolicies.add({
-  name: "stay-on-branch",
-  description: "Impede o agente de fazer checkout em outras branches",
-  match: { events: ["PreToolUse"] },
-  fn: async (ctx) => {
-    if (ctx.toolName !== "Bash") return allow();
-    const cmd = String(ctx.toolInput?.command ?? "");
-    if (/git\s+checkout\s+(?!-b)/.test(cmd)) {
-      return deny("Stay on the current branch. Create a new branch with -b if needed.");
-    }
-    return allow();
-  },
-});
-```
-
----
-
-## Exigir testes antes de commits
-
-Lembra os agentes de executar testes antes de fazer commit.
-
-```javascript
-import { customPolicies, allow, instruct } from "failproofai";
-
-customPolicies.add({
-  name: "test-before-commit",
-  description: "Lembra o agente de executar testes antes de fazer commit",
-  match: { events: ["PreToolUse"] },
-  fn: async (ctx) => {
-    if (ctx.toolName !== "Bash") return allow();
-    const cmd = String(ctx.toolInput?.command ?? "");
-    if (/git\s+commit/.test(cmd)) {
-      return instruct("Run tests before committing. Use `npm test` or `bun test` first.");
-    }
-    return allow();
-  },
-});
-```
-
----
-
-## Bloquear um repositório de produção
-
-Faça commit de uma configuração no nível do projeto para que todos os desenvolvedores da sua equipe utilizem as mesmas políticas.
-
-Crie `.failproofai/policies-config.json` no seu repositório:
-
-```json
-{
-  "enabledPolicies": [
-    "block-sudo",
-    "block-rm-rf",
-    "block-force-push",
-    "block-push-master",
-    "block-env-files",
-    "sanitize-api-keys",
-    "sanitize-jwt"
-  ],
-  "policyParams": {
-    "block-push-master": {
-      "protectedBranches": ["main", "release", "production"]
-    }
-  }
-}
-```
-
-Em seguida, faça o commit:
-
-```bash
-git add .failproofai/policies-config.json
-git commit -m "Add failproofai team policies"
-```
-
-Todo membro da equipe que tiver o failproofai instalado receberá essas regras automaticamente.
-
----
-
-## Construir um padrão de qualidade organizacional com políticas de convenção
-
-A configuração de maior impacto: faça commit de `.failproofai/policies/` no seu repositório com políticas adaptadas ao seu projeto. Todos os membros da equipe as recebem automaticamente — sem comandos de instalação, sem alterações de configuração.
-
-<Steps>
-  <Step title="Criar o diretório e adicionar políticas">
-    ```bash
-    mkdir -p .failproofai/policies
-    ```
-
-    ```js
-    // .failproofai/policies/team-policies.mjs
-    import { customPolicies, allow, deny, instruct } from "failproofai";
-
-    // Enforce your team's preferred package manager
-    // (or enable the built-in prefer-package-manager policy instead)
-    customPolicies.add({
-      name: "enforce-bun",
-      match: { events: ["PreToolUse"] },
-      fn: async (ctx) => {
-        if (ctx.toolName !== "Bash") return allow();
-        const cmd = String(ctx.toolInput?.command ?? "");
-        if (/\bnpm\b/.test(cmd)) return deny("Use bun instead of npm.");
-        return allow();
-      },
-    });
-
-    // Remind the agent to run tests before committing
-    customPolicies.add({
-      name: "test-before-commit",
-      match: { events: ["PreToolUse"] },
-      fn: async (ctx) => {
-        if (ctx.toolName !== "Bash") return allow();
-        if (/git\s+commit/.test(ctx.toolInput?.command ?? "")) {
-          return instruct("Run tests before committing.");
-        }
-        return allow();
-      },
-    });
-    ```
-  </Step>
-  <Step title="Fazer commit no git">
-    ```bash
-    git add .failproofai/policies/
-    git commit -m "Add team quality policies"
-    ```
-  </Step>
-  <Step title="Continue melhorando">
-    À medida que sua equipe encontra novos problemas, adicione políticas e faça push. Todos recebem a atualização no próximo `git pull`. Essas políticas se tornam um padrão de qualidade vivo que cresce junto com a sua equipe.
-  </Step>
-</Steps>
-
----
-
-## Mais exemplos
-
-O diretório [`examples/`](https://github.com/exospherehost/failproofai/tree/main/examples) no repositório contém:
-
-| Arquivo | O que demonstra |
-|---------|-----------------|
-| `policies-basic.js` | Políticas iniciais — bloquear escrita em produção, force-push e scripts redirecionados |
-| `policies-notification.js` | Alertas no Slack para notificações de inatividade e encerramento de sessão |
-| `policies-advanced/index.js` | Importações transitivas, hooks assíncronos, limpeza de saída no PostToolUse e tratamento do evento Stop |

package/.next/standalone/docs/pt-br/for-agents.mdx

@@ -1,38 +0,0 @@
----
-title: "Para agentes"
-description: "Adicione o conhecimento do Failproof AI ao seu agente de codificação com um único comando. Funciona com Claude Code, Cursor, Windsurf e mais."
----
-
-Adicione a referência completa do Failproof AI ao seu agente de codificação com um único comando. Funciona com Claude Code, Cursor, Windsurf e qualquer outro agente que suporte skills.
-
-```bash
-npx skills add https://docs.befailproof.ai
-```
-
-O `npx skills` detecta quais agentes você tem instalados e adiciona a skill no formato correto para cada um automaticamente.
-
-## O que a skill cobre
-
-| Área | O que está incluído |
-|------|----------------|
-| Policies | Nomes de policies integradas, tipos de eventos, parâmetros, ativar/desativar |
-| Custom policies | `customPolicies.add()`, filtros de correspondência, API `allow`/`deny`/`instruct` |
-| Objeto de contexto | `ctx.eventType`, `ctx.toolName`, `ctx.toolInput`, `ctx.session` |
-| Configuração | Estrutura do `policies-config.json`, mesclagem de escopos, `policyParams` |
-| CLI | `failproofai policies --install`, `--uninstall`, `--custom`, escopos |
-| Dashboard | Visualizador de sessões, atividade de policies, variáveis de ambiente |
-| Arquitetura | Fluxo do hook handler, códigos de saída, contrato stdin/stdout |
-
-## A skill é completa?
-
-O Mintlify gera o `llms.txt` a partir de todas as páginas da navegação. A documentação do Failproof AI cobre a API completa — cada policy, opção e exemplo está incluído. Se você encontrar algo faltando, a fonte está em `https://docs.befailproof.ai/llms-full.txt`.
-
-Para contexto direcionado, vincule diretamente a uma página específica:
-
-```bash
-# Apenas a API de custom policies
-npx skills add https://docs.befailproof.ai/custom-policies
-
-# Apenas as policies integradas
-npx skills add https://docs.befailproof.ai/built-in-policies
-```

package/.next/standalone/docs/pt-br/getting-started.mdx

@@ -1,186 +0,0 @@
----
-title: Primeiros passos
-description: "Instale o failproofai, ative as políticas e deixe seus agentes rodarem de forma confiável"
-icon: rocket
----
-
-## Requisitos
-
-- **Node.js** >= 20.9.0
-- **Bun** >= 1.3.0 (opcional - necessário apenas para compilar a partir do código-fonte)
-
----
-
-## Instalação
-
-<CodeGroup>
-
-```bash npm
-npm install -g failproofai
-```
-
-```bash bun
-bun add -g failproofai
-```
-
-</CodeGroup>
-
----
-
-## Início rápido
-
-<Steps>
-  <Step title="Ativar políticas">
-    Políticas são regras que executam antes e depois de cada chamada de ferramenta do agente. Elas interceptam comandos destrutivos, vazamento de segredos e outros modos de falha antes que causem danos.
-
-    ```bash
-    failproofai policies --install
-    ```
-
-    Isso insere entradas de hook no `settings.json` do Claude Code. Você também pode instalar para um único projeto ou escolher políticas específicas:
-
-    ```bash
-    failproofai policies --install --scope project
-    failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
-    ```
-  </Step>
-  <Step title="Verificar">
-    ```bash
-    failproofai policies
-    ```
-
-    Exibe todas as políticas, se estão ativas e quaisquer parâmetros configurados.
-  </Step>
-  <Step title="Abrir o painel">
-    ```bash
-    failproofai
-    ```
-
-    Abre um painel local em `http://localhost:8020` onde você pode navegar por sessões, inspecionar chamadas de ferramentas e gerenciar políticas.
-  </Step>
-  <Step title="Executar seu agente">
-    Inicie o Claude Code normalmente. Se o agente tentar algo arriscado, o failproofai intercepta automaticamente. Deixe-o rodando sem supervisão e revise o que aconteceu no painel.
-  </Step>
-</Steps>
-
----
-
-## Como as políticas funcionam
-
-Toda vez que um agente executa uma ferramenta, o Claude Code chama o failproofai como um subprocesso:
-
-```text
-Claude Code  →  failproofai --hook PreToolUse  →  reads stdin JSON
-                                                 evaluates policies
-                                                 writes decision to stdout
-```
-
-Cada política retorna uma de três decisões:
-
-- **allow** - o agente prossegue normalmente
-- **deny** - a ação é bloqueada e o agente é informado do motivo
-- **instruct** - contexto adicional é inserido no prompt do agente
-
-<Note>
-As políticas são executadas no seu processo local. Nada é enviado a um serviço remoto.
-</Note>
-
----
-
-## Configure políticas de equipe com políticas baseadas em convenção
-
-A forma mais rápida de estabelecer padrões de qualidade em toda a sua equipe é a convenção `.failproofai/policies/`. Basta colocar arquivos de política nesse diretório e eles são carregados automaticamente — sem flags, sem alterações de configuração, sem comandos de instalação.
-
-<Steps>
-  <Step title="Criar o diretório de políticas">
-    ```bash
-    mkdir -p .failproofai/policies
-    ```
-  </Step>
-  <Step title="Adicionar arquivos de política">
-    Copie os exemplos iniciais ou escreva os seus próprios:
-
-    ```bash
-    cp node_modules/failproofai/examples/convention-policies/*.mjs .failproofai/policies/
-    ```
-
-    Ou crie um novo:
-
-    ```js
-    // .failproofai/policies/team-policies.mjs
-    import { customPolicies, allow, deny, instruct } from "failproofai";
-
-    customPolicies.add({
-      name: "test-before-commit",
-      match: { events: ["PreToolUse"] },
-      fn: async (ctx) => {
-        if (ctx.toolName !== "Bash") return allow();
-        if (/git\s+commit/.test(ctx.toolInput?.command ?? "")) {
-          return instruct("Run tests before committing.");
-        }
-        return allow();
-      },
-    });
-    ```
-  </Step>
-  <Step title="Enviar para o git">
-    ```bash
-    git add .failproofai/policies/
-    git commit -m "Add team quality policies"
-    ```
-
-    Todo membro da equipe que tiver o failproofai instalado receberá essas políticas automaticamente. Sem necessidade de configuração individual por desenvolvedor.
-  </Step>
-</Steps>
-
-<Tip>
-Faça commit de `.failproofai/policies/` no seu repositório para que toda a equipe compartilhe os mesmos padrões. À medida que sua equipe descobre novos modos de falha, adicione políticas e faça push — todos recebem a atualização no próximo `git pull`. Com o tempo, essas políticas se tornam um padrão de qualidade vivo que continua melhorando.
-</Tip>
-
----
-
-## Armazenamento de dados
-
-Todas as configurações e logs permanecem na sua máquina:
-
-| Caminho | O que armazena |
-|---------|----------------|
-| `~/.failproofai/policies-config.json` | Configuração global de políticas |
-| `~/.failproofai/hook-activity.jsonl` | Histórico de execução de hooks |
-| `~/.failproofai/hook.log` | Log de depuração para erros de hooks personalizados |
-| `.failproofai/policies-config.json` | Configuração por projeto (versionada) |
-| `.failproofai/policies-config.local.json` | Substituições pessoais (ignoradas pelo git) |
-
----
-
-## Desinstalação
-
-```bash
-failproofai policies --uninstall
-```
-
-Remove as entradas de hook do `~/.claude/settings.json`. Os arquivos de configuração em `~/.failproofai/` são mantidos.
-
----
-
-## Próximos passos
-
-<CardGroup cols={2}>
-
-<Card title="Configuração" icon="gear" href="/pt-br/configuration">
-  Escopos e formato dos arquivos de configuração
-</Card>
-
-<Card title="Políticas integradas" icon="shield" href="/pt-br/built-in-policies">
-  Todas as 26 políticas com seus parâmetros
-</Card>
-
-<Card title="Políticas personalizadas" icon="code" href="/pt-br/custom-policies">
-  Escreva suas próprias políticas em JavaScript
-</Card>
-
-<Card title="Monitor de agentes" icon="chart-line" href="/pt-br/dashboard">
-  Monitore sessões e revise a atividade das políticas
-</Card>
-
-</CardGroup>

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

@@ -1,57 +0,0 @@
----
-title: Failproof AI
-description: "Gerencie hooks e políticas que mantêm seus agentes de IA confiáveis e funcionando de forma autônoma"
----
-
-[![npm weekly downloads](https://img.shields.io/npm/dw/failproofai?style=flat-square&color=2ea44f)](https://www.npmjs.com/package/failproofai)
-
-Hooks e políticas que mantêm seus agentes de IA confiáveis e funcionando de forma autônoma - para o **Claude Code** e o **Agents SDK**.
-
-Agentes de IA falham de maneiras previsíveis. Eles executam comandos destrutivos, vazam segredos, desviam do objetivo, ficam presos em loops ou fazem push direto para a main. Sem supervisão, falhas pequenas se tornam grandes problemas.
-
-Failproof AI resolve isso com **políticas** — regras que se integram a cada chamada de ferramenta do agente e podem **detectar falhas**, **mitigá-las** (bloquear, instruir, sanitizar) e **alertar você** quando algo precisa de atenção. Um painel local permite revisar tudo posteriormente.
-
-Tudo roda localmente. Nenhum dado sai da sua máquina.
-
-## Primeiros passos
-
-<CardGroup cols={2}>
-
-<Card title="26 políticas integradas" icon="shield" href="/pt-br/built-in-policies">
-  Bloqueie comandos destrutivos, evite vazamento de segredos, mantenha os agentes dentro dos limites do projeto e muito mais — pronto para uso.
-</Card>
-
-<Card title="Políticas personalizadas" icon="code" href="/pt-br/custom-policies">
-  Escreva suas próprias regras em JavaScript com uma API simples de allow / deny / instruct.
-</Card>
-
-<Card title="Monitor de agentes" icon="chart-line" href="/pt-br/dashboard">
-  Veja o que seus agentes fizeram enquanto você estava ausente. Navegue pelas sessões, inspecione chamadas de ferramentas e revise onde as políticas foram acionadas.
-</Card>
-
-<Card title="Configuração fácil" icon="gear" href="/pt-br/configuration">
-  Ajuste qualquer política sem escrever código. Defina listas de permissão, branches protegidas ou limites por projeto ou globalmente.
-</Card>
-
-</CardGroup>
-
-## Início rápido
-
-<CodeGroup>
-
-```bash npm
-npm install -g failproofai
-```
-
-```bash bun
-bun add -g failproofai
-```
-
-</CodeGroup>
-
-```bash
-failproofai policies --install   # ativar políticas
-failproofai                      # iniciar o painel
-```
-
-Consulte o guia de [Primeiros passos](/pt-br/getting-started) para o passo a passo completo.

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

@@ -1,82 +0,0 @@
----
-title: Aliases de Pacotes
-description: "Aliases registrados para prevenção de typosquatting e como funcionam"
-icon: copy
----
-
-## Pacote oficial
-
-O pacote npm canônico é **`failproofai`**:
-
-```bash
-npm install -g failproofai
-# ou
-bun add -g failproofai
-```
-
----
-
-## Por que somos donos dos nomes de alias
-
-Typosquatting é um ataque comum à cadeia de suprimentos de software, no qual um agente malicioso registra um nome de pacote que difere por apenas um caractere de um pacote popular. Usuários desatentos que digitam errado o comando de instalação acabam executando código controlado pelo atacante com acesso total ao sistema — exatamente o tipo de ameaça que o Failproof AI foi criado para combater.
-
-Para eliminar essa superfície de ataque, **registramos preventivamente todos os erros ortográficos comuns e variantes de formatação** de `failproofai` no npm. Nenhum desses nomes pode ser registrado por terceiros. Cada um deles é um proxy simples que instala e delega ao pacote real `failproofai`.
-
----
-
-## Aliases registrados
-
-**Variantes de formatação** — diferentes formas de escrever "failproof ai":
-
-| Pacote | Status |
-|--------|--------|
-| `failproof` | ✅ Publicado |
-| `failproof-ai` | ⏳ Aguardando suporte do npm |
-| `fail-proof-ai` | ⏳ Aguardando suporte do npm |
-| `failproof_ai` | ⏳ Aguardando suporte do npm |
-| `fail_proof_ai` | ⏳ Aguardando suporte do npm |
-| `fail-proofai` | ⏳ Aguardando suporte do npm |
-
-**Erros de digitação `failprof*`** — falta um `o` em "proof":
-
-| Pacote | Status |
-|--------|--------|
-| `failprof` | ✅ Publicado |
-| `failprof-ai` | ✅ Publicado |
-| `failprofai` | ⏳ Aguardando suporte do npm |
-| `fail-prof-ai` | ⏳ Aguardando suporte do npm |
-| `failprof_ai` | ⏳ Aguardando suporte do npm |
-
-**Erros de digitação `faliproof*`** — `a` e `i` invertidos:
-
-| Pacote | Status |
-|--------|--------|
-| `faliproof` | ✅ Publicado |
-| `faliproof-ai` | ✅ Publicado |
-| `faliproofai` | ⏳ Aguardando suporte do npm |
-
-> **Por que "aguardando"?** A política de prevenção de spam do npm bloqueia nomes que, após remoção de pontuação e verificações de similaridade, resultam na mesma string de um pacote já existente. Entramos em contato com o suporte do npm para reservar esses nomes com fins anti-typosquatting. Eles serão ativados após aprovação.
-
-Você pode verificar que qualquer alias publicado pertence a nós:
-
-```bash
-npm info failproof
-# Procure por: "ExosphereHost Inc." no campo maintainers
-```
-
----
-
-## Como os aliases funcionam
-
-Cada pacote alias:
-
-1. Lista `failproofai` como dependência — assim, o pacote real (incluindo a configuração do hook `postinstall`) é executado durante a instalação
-2. Expõe um binário com seu próprio nome (por exemplo, `failprof-ai`) que repassa todos os argumentos para o binário `failproofai`
-
-O proxy é um script Node de duas linhas; não há lógica adicional, chamadas de rede nem coleta de dados além do que o próprio `failproofai` realiza.
-
----
-
-## Se você encontrar um nome que esquecemos
-
-Abra uma issue em [exospherehost/failproofai](https://github.com/exospherehost/failproofai/issues) e nós o registraremos.