Configuração local - Failproof AI

O Failproof AI separa a seleção de políticas das configurações de máquina e do daemon. Isso mantém as escolhas de políticas do repositório revisáveis, enquanto as credenciais e o estado do daemon permanecem fora do repositório.

Escolha um escopo de política

Dashboard
CLI

Execute failproofai sem argumentos para abrir o dashboard de políticas local. Escolha o escopo de usuário, projeto ou local antes de ativar uma política, para que a alteração seja gravada no arquivo de configuração correto.

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

failproofai policy add block-rm-rf --scope user
failproofai policy add block-force-push --scope project
failproofai policy add warn-large-file-write --scope local
failproofai policies

Nem todo harness suporta o escopo local. A CLI rejeita um escopo que o harness selecionado não consegue representar.

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

As políticas ativadas são mescladas como uma união. Os parâmetros de política utilizam o primeiro escopo que define parâmetros para aquela política, na ordem projeto → local → usuário. Caminhos personalizados explícitos utilizam o primeiro escopo que os define.

Configure os parâmetros de política

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, depois inspecione a decisão em Observe → policy.

Edite o policies-config.json do escopo selecionado e execute failproofai policies para identificar nomes de políticas ou chaves de parâmetros desconhecidos.

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

failproofai policies

Entenda os arquivos da máquina

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

Caminho	Finalidade
`config.json`	Configurações de daemon, auditoria e telemetria não secretas
`credentials.json`	Credenciais de nuvem; armazenadas com permissões exclusivas do proprietário
`policies-config.json`	Seleção de builtins, parâmetros e caminhos personalizados explícitos no escopo do usuário
`policies/`	Políticas de convenção do usuário e artefatos de política gerenciados pela nuvem
`hook-activity/`	Log de decisões de políticas local
`state/`	Spool do daemon, saúde, pausa e estado de execução

Use FAILPROOFAI_HOME para realocar o layout completo da máquina para um container ou teste isolado. Não realoque 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.

​Escolha um escopo de política

​Configure os parâmetros de política

​Entenda os arquivos da máquina

Escolha um escopo de política

Configure os parâmetros de política

Entenda os arquivos da máquina