Configuração local

O Failproof AI mantém separado o que um repositório pode commitar — conexão de hooks, parâmetros de políticas, políticas personalizadas — do estado da máquina, como credenciais, packs instalados e o daemon.

Escolha um escopo

O escopo define onde os hooks são conectados e em qual arquivo de configuração você escreve parâmetros e caminhos de políticas personalizadas:

User aplica-se a todos os projetos nesta máquina.
Project pertence ao repositório e pode ser commitado.
Local substitui um projeto para um único usuário e deve permanecer no gitignore.

failproofai policies --install --cli claude --scope project   # wire hooks for this repository
failproofai policies --install --cli claude --scope user      # or for every project on this machine
failproofai policies

Nem todos os harnesses suportam escopo local; o CLI rejeita um escopo que o harness selecionado não consegue representar. Quais políticas de um pack estão ativas não tem escopo definido. A configuração é registrada junto com o pack instalado, portanto failproofai policies add <name> ativa uma política para toda a máquina, independentemente do que o --scope especifica.

Escopo	Arquivo de configuração de políticas
Project	`<project>/.failproofai/policies-config.json`
Local	`<project>/.failproofai/policies-config.local.json`
User	`~/.failproofai/policies-config.json`

Os parâmetros de políticas utilizam o primeiro escopo que define parâmetros para aquela política, na ordem project → local → user. Caminhos de políticas personalizadas explícitos utilizam o primeiro escopo que os define.

Configure parâmetros de políticas

Dashboard
CLI

Abra a política no dashboard local, edite os parâmetros suportados e salve no escopo selecionado. Execute uma ação do agente que corresponda e outra que não corresponda à política, depois inspecione a decisão em Observe → policy.

Edite o policies-config.json do escopo selecionado e execute failproofai policies: ele alertará sobre uma entrada policyParams que nomeia uma política que nenhum pack instalado possui. Ele não verifica as chaves dentro de uma entrada, portanto confira a ortografia delas na tabela abaixo.

{
  "policyParams": {
    "block-rm-rf": {
      "allowPaths": ["/tmp/build-output"]
    }
  }
}

failproofai policies

Parâmetros aceitos pelas políticas do Failproof AI

Cada política valida seus próprios tipos de parâmetro.

Política	Parâmetro	Tipo e padrão
`sanitize-api-keys`	`additionalPatterns`	`pattern[]`, `[]`; 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"`

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 todo um conjunto de máquinas.

Entenda os arquivos da máquina

~/.failproofai contém arquivos separados para diferentes limites de confiança:

Caminho	Finalidade
`config.json`	Configurações de daemon, auditoria e telemetria (sem segredos)
`credentials.json`	Credenciais de nuvem; armazenadas com permissões somente para o proprietário
`policies-config.json`	Parâmetros de escopo de usuário e caminhos explícitos de políticas personalizadas
`policies/`	Políticas de convenção do usuário, packs instalados e quais de suas políticas estão ativas, além de artefatos de políticas gerenciadas pela nuvem
`hook-activity/`	Log local de decisões de políticas
`state/`	Spool do daemon, saúde, pausa e estado de execução

Use FAILPROOFAI_HOME para relocar todo o layout da máquina para um container ou teste isolado. Não reloce diretórios de estado individuais de forma independente.

Nunca faça commit de credentials.json. Faça commit da configuração de políticas do projeto e das políticas de convenção do projeto somente após revisá-las como código de enforcement.

Connect your agents

Reference

Escolha um escopo

Configure parâmetros de políticas

Parâmetros aceitos pelas políticas do Failproof AI

Entenda os arquivos da máquina

​Escolha um escopo

​Configure parâmetros de políticas

​Parâmetros aceitos pelas políticas do Failproof AI

​Entenda os arquivos da máquina

Escolha um escopo

Configure parâmetros de políticas

Parâmetros aceitos pelas políticas do Failproof AI

Entenda os arquivos da máquina