failproofai 0.0.6-beta.3 → 0.0.6-beta.5

package/.next/standalone/docs/es/cli/install-policies.mdx

@@ -1,47 +0,0 @@
----
-title: Instalar políticas
-description: "Habilita políticas para que se ejecuten en cada llamada de herramienta del agente"
----
-
-```bash
-failproofai policies --install [policy-names...] [options]
-```
-
-Escribe entradas de hook en el `settings.json` de Claude Code para que failproofai intercepte las llamadas de herramienta.
-
-Alias: `failproofai p -i`
-
-## Opciones
-
-| Flag | Descripción |
-|------|-------------|
-| `--scope user` | Instala en `~/.claude/settings.json` (predeterminado - todas las sesiones) |
-| `--scope project` | Instala en `.claude/settings.json` en el directorio actual |
-| `--scope local` | Instala en `.claude/settings.local.json` en el directorio actual |
-| `--custom <path>` / `-c` | Ruta a un archivo JS que contiene políticas de hook personalizadas |
-
-## Comportamiento
-
-- **Sin nombres de política** - abre un prompt interactivo para seleccionar políticas
-- **Nombres específicos** - habilita esas políticas (se agregan a las que ya están habilitadas)
-- **`all`** - habilita todas las políticas disponibles
-
-La instalación es acumulativa: ejecutar `--install` nuevamente agrega nuevas políticas sin eliminar las existentes.
-
-## Ejemplos
-
-```bash
-# Instalar todas las políticas predeterminadas globalmente (interactivo)
-failproofai policies --install
-
-# Instalar políticas específicas para el proyecto actual
-failproofai policies --install block-sudo sanitize-api-keys --scope project
-
-# Habilitar todas las políticas a la vez
-failproofai policies --install all
-
-# Instalar con un archivo de políticas personalizado
-failproofai policies --install --custom ./my-policies.js
-```
-
-Cuando se proporciona `--custom <path>`, el archivo se valida de inmediato: debe llamar a `customPolicies.add()` al menos una vez. La ruta resuelta se guarda en `policies-config.json` como `customPoliciesPath`.

package/.next/standalone/docs/es/cli/list-policies.mdx

@@ -1,31 +0,0 @@
----
-title: Listar políticas
-description: "Ver qué políticas están habilitadas, sus parámetros y políticas personalizadas"
----
-
-```bash
-failproofai policies
-```
-
-Muestra todas las políticas con su estado, parámetros configurados y políticas personalizadas.
-
-## Ejemplo de salida
-
-```text
-Failproof AI Hook Policies (user)
-
-  Status  Name                          Description
-  ──────  ──────────────────────────────────────────────────────────────
-  ✓       block-sudo                    Block sudo commands
-            allowPatterns: ["sudo systemctl status"]
-  ✓       block-rm-rf                   Block recursive deletions
-  ✗       block-curl-pipe-sh            Block curl|bash patterns
-  ✓       sanitize-api-keys             Redact API keys from output
-            additionalPatterns: [{ regex: "MY_TOKEN_...", label: "..." }]
-
-  ── Custom Policies (/home/alice/myproject/my-policies.js) ──────────────
-  ✓       require-jira-ticket           Block commits without ticket
-  ✓       approval-gate                 Approval gate for destructive ops
-```
-
-Las claves desconocidas en `policyParams` se marcan aquí para que puedas detectar errores tipográficos con anticipación.

package/.next/standalone/docs/es/cli/remove-policies.mdx

@@ -1,43 +0,0 @@
----
-title: Desinstalar políticas
-description: "Eliminar entradas de hooks de la configuración de Claude Code"
----
-
-```bash
-failproofai policies --uninstall [policy-names...] [options]
-```
-
-Elimina las entradas de hooks de failproofai del archivo `settings.json` de Claude Code.
-
-Alias: `failproofai p -u`
-
-## Opciones
-
-| Indicador | Descripción |
-|-----------|-------------|
-| `--scope user` | Eliminar de la configuración global (predeterminado) |
-| `--scope project` | Eliminar de la configuración del proyecto |
-| `--scope local` | Eliminar de la configuración local |
-| `--scope all` | Eliminar de todos los ámbitos a la vez |
-| `--custom` / `-c` | Limpiar `customPoliciesPath` de la configuración |
-
-## Comportamiento
-
-- **Sin nombres de política** — elimina todas las entradas de hooks de failproofai del archivo de configuración
-- **Nombres específicos** — deshabilita esas políticas pero mantiene los hooks instalados
-
-## Ejemplos
-
-```bash
-# Eliminar todos los hooks globalmente
-failproofai policies --uninstall
-
-# Deshabilitar una política específica (mantiene los hooks instalados)
-failproofai policies --uninstall block-sudo
-
-# Eliminar hooks de todos los ámbitos
-failproofai policies --uninstall --scope all
-
-# Limpiar la ruta de políticas personalizadas
-failproofai policies --uninstall --custom
-```

package/.next/standalone/docs/es/cli/version.mdx

@@ -1,12 +0,0 @@
----
-title: Verificar versión
-description: "Mostrar la versión instalada de failproofai"
----
-
-```bash
-failproofai --version
-# or
-failproofai -v
-```
-
-Muestra el número de versión instalada.

package/.next/standalone/docs/es/configuration.mdx

@@ -1,222 +0,0 @@
----
-title: Configuración
-description: "Formato del archivo de configuración, sistema de tres ámbitos y reglas de fusión"
-icon: gear
----
-
-failproofai utiliza archivos de configuración JSON para controlar qué políticas están activas, cómo se comportan y desde dónde se cargan las políticas personalizadas. La configuración está diseñada para compartirse fácilmente con tu equipo: confírmala en tu repositorio y todos los desarrolladores obtendrán la misma red de seguridad para el agente.
-
----
-
-## Ámbitos de configuración
-
-Existen tres ámbitos de configuración, evaluados en orden de prioridad:
-
-| Ámbito | Ruta del archivo | Propósito |
-|--------|-----------------|-----------|
-| **project** | `.failproofai/policies-config.json` | Configuración por repositorio, confirmada en el control de versiones |
-| **local** | `.failproofai/policies-config.local.json` | Anulaciones personales por repositorio, ignoradas por git |
-| **global** | `~/.failproofai/policies-config.json` | Valores predeterminados a nivel de usuario para todos los proyectos |
-
-Cuando failproofai recibe un evento de hook, carga y fusiona los tres archivos que existen para el directorio de trabajo actual.
-
-### Reglas de fusión
-
-**`enabledPolicies`** - la unión de los tres ámbitos. Una política habilitada en cualquier nivel está activa.
-
-```text
-project:  ["block-sudo"]
-local:    ["block-rm-rf"]
-global:   ["block-sudo", "sanitize-api-keys"]
-
-resolved: ["block-sudo", "block-rm-rf", "sanitize-api-keys"]  ← unión sin duplicados
-```
-
-**`policyParams`** - el primer ámbito que define los parámetros para una política determinada gana completamente. No hay fusión profunda de valores dentro de los parámetros de una política.
-
-```text
-project:  block-sudo → { allowPatterns: ["sudo apt-get update"] }
-global:   block-sudo → { allowPatterns: ["sudo systemctl status"] }
-
-resolved: { allowPatterns: ["sudo apt-get update"] }   ← project gana, global ignorado
-```
-
-```text
-project:  (sin entrada block-sudo)
-local:    (sin entrada block-sudo)
-global:   block-sudo → { allowPatterns: ["sudo systemctl status"] }
-
-resolved: { allowPatterns: ["sudo systemctl status"] }  ← recae en global
-```
-
-**`customPoliciesPath`** - el primer ámbito que lo define gana.
-
-**`llm`** - el primer ámbito que lo define gana.
-
----
-
-## Formato del archivo de configuración
-
-```json
-{
-  "enabledPolicies": [
-    "block-sudo",
-    "block-rm-rf",
-    "block-push-master",
-    "sanitize-api-keys",
-    "sanitize-jwt",
-    "block-env-files",
-    "block-read-outside-cwd"
-  ],
-  "policyParams": {
-    "block-sudo": {
-      "allowPatterns": ["sudo systemctl status", "sudo journalctl"]
-    },
-    "block-push-master": {
-      "protectedBranches": ["main", "release", "prod"]
-    },
-    "block-rm-rf": {
-      "allowPaths": ["/tmp"]
-    },
-    "block-read-outside-cwd": {
-      "allowPaths": ["/shared/data", "/opt/company"]
-    },
-    "sanitize-api-keys": {
-      "additionalPatterns": [
-        { "regex": "myco_[A-Za-z0-9]{32}", "label": "MyCo API key" }
-      ]
-    },
-    "warn-large-file-write": {
-      "thresholdKb": 512
-    }
-  },
-  "customPoliciesPath": "/home/alice/myproject/my-policies.js"
-}
-```
-
----
-
-## Referencia de campos
-
-### `enabledPolicies`
-
-Tipo: `string[]`
-
-Lista de nombres de políticas a habilitar. Los nombres deben coincidir exactamente con los identificadores de política que muestra `failproofai policies`. Consulta [Políticas integradas](/es/built-in-policies) para ver la lista completa.
-
-Las políticas que no estén en `enabledPolicies` estarán inactivas, incluso si tienen entradas en `policyParams`.
-
-### `policyParams`
-
-Tipo: `Record<string, Record<string, unknown>>`
-
-Anulaciones de parámetros por política. La clave externa es el nombre de la política; las claves internas son específicas de cada política. Cada política documenta sus parámetros disponibles en [Políticas integradas](/es/built-in-policies).
-
-Si una política tiene parámetros pero no los especificas, se utilizan los valores predeterminados integrados de la política. Los usuarios que no configuren `policyParams` en absoluto obtendrán un comportamiento idéntico al de versiones anteriores.
-
-Las claves desconocidas dentro del bloque de parámetros de una política se ignoran silenciosamente al momento de ejecutar el hook, pero se marcan como advertencias cuando ejecutas `failproofai policies`.
-
-#### `hint` (transversal)
-
-Tipo: `string` (opcional)
-
-Un mensaje que se añade al motivo cuando una política devuelve `deny` o `instruct`. Úsalo para dar a Claude orientación práctica sin modificar la política en sí.
-
-Funciona con cualquier tipo de política: integradas, personalizadas (`custom/`), convenciones de proyecto (`.failproofai-project/`) o convenciones de usuario (`.failproofai-user/`).
-
-```json
-{
-  "policyParams": {
-    "block-force-push": {
-      "hint": "Try creating a fresh branch instead."
-    },
-    "block-sudo": {
-      "allowPatterns": ["sudo apt-get"],
-      "hint": "Use apt-get directly without sudo."
-    },
-    "custom/my-policy": {
-      "hint": "Ask the user for approval first."
-    }
-  }
-}
-```
-
-Cuando `block-force-push` deniega, Claude ve: *"Force-pushing is blocked. Try creating a fresh branch instead."*
-
-Los valores que no sean cadenas de texto y las cadenas vacías se ignoran silenciosamente. Si `hint` no está definido, el comportamiento no cambia (compatible con versiones anteriores).
-
-### `customPoliciesPath`
-
-Tipo: `string` (ruta absoluta)
-
-Ruta a un archivo JavaScript que contiene políticas de hook personalizadas. Se establece automáticamente mediante `failproofai policies --install --custom <path>` (la ruta se resuelve como absoluta antes de guardarse).
-
-El archivo se carga de nuevo en cada evento de hook, sin ningún tipo de caché. Consulta [Políticas personalizadas](/es/custom-policies) para más detalles sobre cómo crearlas.
-
-### Políticas basadas en convenciones
-
-Además del `customPoliciesPath` explícito, failproofai descubre y carga automáticamente archivos de políticas desde directorios `.failproofai/policies/`:
-
-| Nivel | Directorio | Ámbito |
-|-------|-----------|--------|
-| Proyecto | `.failproofai/policies/` | Compartido con el equipo mediante control de versiones |
-| Usuario | `~/.failproofai/policies/` | Personal, se aplica a todos los proyectos |
-
-**Coincidencia de archivos:** Solo se cargan los archivos que coincidan con `*policies.{js,mjs,ts}` (por ejemplo, `security-policies.mjs`, `workflow-policies.js`). Los demás archivos del directorio se ignoran.
-
-**Sin configuración necesaria:** Las políticas de convención no requieren entradas en `policies-config.json`. Simplemente coloca los archivos en el directorio y se detectarán en el próximo evento de hook.
-
-**Carga por unión:** Se analizan tanto los directorios de convención del proyecto como los del usuario. Se cargan todos los archivos coincidentes de ambos niveles (a diferencia de `customPoliciesPath`, que utiliza el primero que gana por ámbito).
-
-Consulta [Políticas personalizadas](/es/custom-policies) para más detalles y ejemplos.
-
-### `llm`
-
-Tipo: `object` (opcional)
-
-Configuración del cliente LLM para políticas que realizan llamadas a IA. No es necesaria para la mayoría de las configuraciones.
-
-```json
-{
-  "llm": {
-    "model": "claude-sonnet-4-6",
-    "apiKey": "sk-ant-..."
-  }
-}
-```
-
----
-
-## Gestión de la configuración desde la CLI
-
-Los comandos `policies --install` y `policies --uninstall` escriben en el `settings.json` de Claude Code (los puntos de entrada del hook), mientras que `policies-config.json` es el archivo que gestionas directamente. Ambos son independientes:
-
-- **`settings.json`** - indica a Claude Code que llame a `failproofai --hook <event>` en cada uso de herramienta
-- **`policies-config.json`** - indica a failproofai qué políticas evaluar y con qué parámetros
-
-Puedes editar `policies-config.json` directamente en cualquier momento; los cambios surten efecto de inmediato en el próximo evento de hook, sin necesidad de reiniciar.
-
----
-
-## Ejemplo: configuración a nivel de proyecto con valores predeterminados del equipo
-
-Confirma `.failproofai/policies-config.json` en tu repositorio:
-
-```json
-{
-  "enabledPolicies": [
-    "block-sudo",
-    "block-rm-rf",
-    "block-push-master",
-    "sanitize-api-keys",
-    "block-env-files"
-  ],
-  "policyParams": {
-    "block-push-master": {
-      "protectedBranches": ["main", "release", "hotfix"]
-    }
-  }
-}
-```
-
-Cada desarrollador puede entonces crear `.failproofai/policies-config.local.json` (ignorado por git) para sus anulaciones personales sin afectar a sus compañeros de equipo.