Políticas personalizadas

Crea un archivo con extensión policies.js, policies.mjs o policies.ts dentro de .failproofai/policies/. Los archivos de convención se cargan automáticamente en el ámbito de proyecto y de usuario.

Prueba la política antes de publicarla en Cloud

Panel de control
CLI

Instala la política personalizada en una máquina de prueba y ejecuta tanto una acción que coincida como una que no deba coincidir.
Ve a Observar → política y compara las dos decisiones.
Abre cada sesión vinculada y verifica que el payload del evento contiene suficiente evidencia para la regla.
Cuando el comportamiento sea correcto, mueve el código revisado a Admin → editor de políticas y publica una versión.

failproofai policies --install --custom ./security.policies.ts \
  --cli claude --scope project
failproofai policies

Los archivos de convención bajo .failproofai/policies/ se cargan sin necesidad de --custom. Mantén un comando de instalación explícito en CI cuando la validación deba fallar ante un módulo roto.

import { customPolicies, allow, deny } from "failproofai";

customPolicies.add({
  name: "protect-production-paths",
  description: "Block writes to production configuration",
  match: { events: ["PreToolUse"] },
  fn: async (ctx) => {
    if (ctx.toolName !== "Write" && ctx.toolName !== "Edit") return allow();
    const path = String(ctx.toolInput?.file_path ?? "").replaceAll("\\", "/");
    if (path.split("/").includes("production")) {
      return deny("Writes to production configuration require approval.");
    }
    return allow();
  },
});

Esto coincide con production/config.yml, /srv/production/config.yml, /srv/production y C:\\production\\config.yml tanto para Write como para Edit. No coincide con nombres como production-backup, ya que production debe ser un segmento completo de la ruta. Valida e instala un archivo explícito:

failproofai policies --install --custom ./security.policies.ts

El contexto de la política incluye el tipo de evento, el payload normalizado, el nombre e input de la herramienta, los metadatos de la sesión, los parámetros y el CLI de origen cuando esté disponible.

Prueba los caminos de fallo

Ejecuta la validación después de modificar el archivo de entrada o cualquier módulo local que importe:

failproofai policies --install --custom ./security.policies.ts --scope project

La ruta CLI con —strict falla ante archivos inexistentes, errores de sintaxis, importaciones no resueltas, excepciones a nivel superior y tiempos de espera en la carga de módulos. En el momento de la aplicación, un archivo personalizado con errores se registra y se omite para que las políticas integradas puedan continuar. Trata cualquier advertencia de carga como una pérdida de la aplicación esperada y genera una alerta en los registros de producción. Usa nombres globalmente únicos entre políticas explícitas, de convención y gestionadas desde Cloud. Mantén las funciones de política deterministas, limita las llamadas externas con tiempos de espera cortos y devuelve un allow, instruct o deny intencionado en cada camino de ejecución.

Una política personalizada es código de aplicación. Prueba campos faltantes, nombres de herramienta alternativos y entradas malformadas, no solo la coincidencia esperada.

​Prueba la política antes de publicarla en Cloud

​Prueba los caminos de fallo

Prueba la política antes de publicarla en Cloud

Prueba los caminos de fallo