Catálogo de políticas builtin

O pacote instalado é a fonte de verdade para a disponibilidade de políticas. Execute failproofai policies após cada atualização, pois as entradas do catálogo e o comportamento podem mudar com a versão do pacote.

Linha de base recomendada

A seleção recomendada pela configuração guiada atualmente habilita sanitizadores de segredos, proteções de ambiente, autoproteção, proteções contra comandos catastróficos e segurança de branches protegidas:

sanitize-jwt                 sanitize-api-keys
sanitize-connection-strings sanitize-private-key-content
sanitize-bearer-tokens       protect-env-vars
block-env-files              block-secrets-write
block-failproofai-commands   block-sudo
block-curl-pipe-sh           block-rm-rf
block-push-master            block-force-push

block-failproofai-commands está sempre ativo. Ele é listado acima apenas para fins de completude, mas se registra em toda avaliação independentemente de aparecer ou não no seu conjunto habilitado — não pode ser desabilitado ou pausado. Uma proteção contra o agente desativar a aplicação de regras não seria uma proteção se o próprio agente pudesse desativá-la. O conjunto recomendado é deliberadamente mais restrito do que Tudo. Políticas de infraestrutura e de fluxo de trabalho podem interromper trabalhos válidos e devem ser habilitadas apenas para os repositórios e máquinas que delas necessitam.

Segredos e ambiente

Política	Gatilho	Resultado
`sanitize-jwt`	`PostToolUse`	Redaciona JWTs da saída da ferramenta antes que o modelo os veja.
`sanitize-api-keys`	`PostToolUse`	Redaciona chaves comuns de OpenAI, Anthropic, GitHub, AWS, Stripe e Google.
`sanitize-connection-strings`	`PostToolUse`	Redaciona strings de conexão de banco de dados que contenham credenciais.
`sanitize-private-key-content`	`PostToolUse`	Redaciona corpos de chaves privadas PEM.
`sanitize-bearer-tokens`	`PostToolUse`	Redaciona tokens bearer de autorização.
`protect-env-vars`	`PreToolUse` em ferramentas de shell	Bloqueia comandos que expõem variáveis de ambiente.
`block-env-files`	`PreToolUse`	Bloqueia leituras e escritas de arquivos `.env`.
`block-read-outside-cwd`	`PreToolUse` em ferramentas de leitura, glob, grep ou shell	Mantém leituras dentro do diretório de trabalho da sessão.
`block-secrets-write`	`PreToolUse` em ferramentas de escrita	Bloqueia escritas em nomes de arquivos comuns de chaves secretas e credenciais.

Comandos perigosos e infraestrutura

Política	Gatilho	Resultado
`block-sudo`	`PreToolUse`, `PermissionRequest`	Bloqueia `sudo` a menos que um padrão de permissão corresponda.
`block-curl-pipe-sh`	`PreToolUse`	Bloqueia scripts baixados e redirecionados diretamente para um shell.
`block-rm-rf`	`PreToolUse`	Bloqueia padrões catastróficos de exclusão recursiva.
`block-failproofai-commands`	`PreToolUse`, `PermissionRequest`	Sempre ativo, não pode ser desabilitado. Bloqueia toda invocação da CLI do Failproof AI, autopausas e desinstalações via gerenciador de pacotes.
`block-kubectl`	`PreToolUse`	Controla comandos Kubernetes.
`block-terraform`	`PreToolUse`	Controla comandos Terraform e OpenTofu.
`block-aws-cli`	`PreToolUse`	Controla comandos da AWS CLI.
`block-gcloud`	`PreToolUse`	Controla comandos da Google Cloud CLI.
`block-az-cli`	`PreToolUse`	Controla comandos da Azure CLI.
`block-helm`	`PreToolUse`	Controla comandos do Helm.
`block-gh-pipeline`	`PreToolUse`	Controla operações mutantes de workflow, run, merge, release, cache e secret da GitHub CLI.

Segurança de Git e banco de dados

Política	Gatilho	Resultado
`block-push-master`	`PreToolUse`	Bloqueia pushes diretos para branches protegidas configuradas.
`block-force-push`	`PreToolUse`	Bloqueia force-pushes; `--force-with-lease` permanece permitido pela implementação atual.
`block-work-on-main`	`PreToolUse`	Bloqueia commits e merges em branches protegidas.
`warn-git-amend`	`PreToolUse`	Avisa antes de reescrever um commit com `--amend`.
`warn-git-stash-drop`	`PreToolUse`	Avisa antes de descartar ou limpar stashes permanentemente.
`warn-all-files-staged`	`PreToolUse`	Avisa em uso amplo de `git add -A`, `git add .` ou `git add --all`.
`warn-destructive-sql`	`PreToolUse`	Avisa em `DROP`, `TRUNCATE` e `DELETE` sem `WHERE` por meio de clientes de banco de dados reconhecidos.
`warn-schema-alteration`	`PreToolUse`	Avisa em operações reconhecidas de `ALTER TABLE` com colunas e renomeações.

Pacotes, comportamento do sistema e loops de agente

Política	Gatilho	Resultado
`warn-package-publish`	`PreToolUse`	Avisa antes de publicar em registros de pacotes.
`warn-global-package-install`	`PreToolUse`	Avisa antes de instalar pacotes globalmente.
`prefer-package-manager`	`PreToolUse`	Instrui o agente a usar um gerenciador de pacotes permitido.
`warn-large-file-write`	`PreToolUse` em ferramentas de escrita	Avisa acima do limite de tamanho de arquivo configurado.
`warn-background-process`	`PreToolUse`	Avisa em padrões de processos em segundo plano desconectados ou de longa duração.
`warn-repeated-tool-calls`	`PreToolUse`	Avisa após três ou mais chamadas de ferramenta idênticas.

Fluxo de trabalho de fim de tarefa

Essas políticas requerem um harness que emita um evento Stop compatível.

Política	Resultado
`require-commit-before-stop`	Recusa a conclusão enquanto houver trabalho rastreado sem commit.
`require-push-before-stop`	Recusa a conclusão enquanto houver commits apenas locais.
`require-pr-before-stop`	Exige um pull request para o branch atual.
`require-no-conflicts-before-stop`	Exige um merge limpo com o branch base configurado.
`require-ci-green-before-stop`	Exige que as verificações de CI do HEAD atual sejam concluídas com sucesso.

Referência de parâmetros

Configure os parâmetros no objeto policyParams do escopo selecionado. Os tipos são validados por cada política.

Política	Parâmetro	Tipo e padrão
`sanitize-api-keys`	`additionalPatterns`	`pattern[]`, `[]`; as entradas contêm `regex` e `label`
`block-read-outside-cwd`	`allowPaths`	`string[]`, `[]`
`block-sudo`	`allowPatterns`	`string[]`, `[]`
`block-rm-rf`	`allowPaths`	`string[]`, `[]`
Bloqueadores de infraestrutura	`allowPatterns`	`string[]`, `[]`
`block-secrets-write`	`additionalPatterns`	`string[]`, `[]`
`block-push-master`	`protectedBranches`	`string[]`, `["main", "master"]`
`block-work-on-main`	`protectedBranches`	`string[]`, `["main", "master"]`
`prefer-package-manager`	`allowed`, `blocked`	`string[]`, `[]`
`warn-large-file-write`	`thresholdKb`	`number`, `1024`
`require-push-before-stop`	`remote`, `baseBranch`	`string`, `"origin"`; `string`, `"main"`
`require-pr-before-stop`	`baseBranch`	`string`, `"main"`
`require-no-conflicts-before-stop`	`baseBranch`	`string`, `"main"`

{
  "enabledPolicies": ["block-sudo", "block-push-master"],
  "policyParams": {
    "block-sudo": {
      "allowPatterns": ["sudo systemctl status"]
    },
    "block-push-master": {
      "protectedBranches": ["main", "release"]
    }
  }
}

Um padrão de permissão amplia o que um agente pode fazer. Teste a tokenização exata e as variantes de comando no harness de destino antes de implantá-lo em uma frota.

​Linha de base recomendada

​Segredos e ambiente

​Comandos perigosos e infraestrutura

​Segurança de Git e banco de dados

​Pacotes, comportamento do sistema e loops de agente

​Fluxo de trabalho de fim de tarefa

​Referência de parâmetros

Linha de base recomendada

Segredos e ambiente

Comandos perigosos e infraestrutura

Segurança de Git e banco de dados

Pacotes, comportamento do sistema e loops de agente

Fluxo de trabalho de fim de tarefa

Referência de parâmetros