Configuración local - Failproof AI

Failproof AI separa la selección de políticas de los ajustes de máquina y del daemon. Esto permite que las decisiones de políticas del repositorio sean revisables, mientras que las credenciales y el estado del daemon permanecen fuera del repositorio.

Elige un alcance de política

Panel de control
CLI

Ejecuta failproofai sin argumentos para abrir el panel de políticas local. Selecciona el alcance de usuario, proyecto o local antes de habilitar una política, para que el cambio se escriba en el archivo de configuración correspondiente.

Usuario aplica en todos los proyectos de esta máquina.
Proyecto pertenece al repositorio y puede confirmarse (commit).
Local sobrescribe un proyecto para un usuario específico y debe mantenerse en el 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

No todos los entornos de ejecución admiten el alcance local. El CLI rechaza un alcance que el entorno seleccionado no pueda representar.

Alcance	Archivo de configuración de políticas
Proyecto	`<project>/.failproofai/policies-config.json`
Local	`<project>/.failproofai/policies-config.local.json`
Usuario	`~/.failproofai/policies-config.json`

Las políticas habilitadas se combinan como una unión. Los parámetros de las políticas utilizan el primer alcance que define parámetros para esa política, en el orden proyecto → local → usuario. Las rutas de políticas personalizadas explícitas utilizan el primer alcance que las define.

Configura los parámetros de las políticas

Panel de control
CLI

Abre la política en el panel local, edita sus parámetros compatibles y guarda en el alcance seleccionado. Ejecuta una acción de agente que coincida y otra que no coincida, luego inspecciona la decisión en Observar → política.

Edita el archivo policies-config.json del alcance seleccionado y luego ejecuta failproofai policies para detectar nombres de políticas o claves de parámetros desconocidos.

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

failproofai policies

Comprende los archivos de máquina

~/.failproofai contiene archivos separados para distintos límites de confianza:

Ruta	Propósito
`config.json`	Ajustes del daemon, auditoría y telemetría (sin secretos)
`credentials.json`	Credenciales en la nube; almacenadas con permisos solo para el propietario
`policies-config.json`	Selección de políticas integradas, parámetros y rutas personalizadas explícitas del alcance de usuario
`policies/`	Políticas de convención de usuario y artefactos de políticas gestionadas en la nube
`hook-activity/`	Registro local de decisiones de políticas
`state/`	Cola del daemon, estado de salud, pausa y estado en tiempo de ejecución

Usa FAILPROOFAI_HOME para reubicar el diseño completo de la máquina en un contenedor o prueba aislada. No reubicar directorios de estado individuales de forma independiente.

Nunca confirmes (commit) credentials.json. Confirma la configuración de políticas del proyecto y las políticas de convención del proyecto solo después de revisarlas como código de cumplimiento.

​Elige un alcance de política

​Configura los parámetros de las políticas

​Comprende los archivos de máquina

Elige un alcance de política

Configura los parámetros de las políticas

Comprende los archivos de máquina