failproofai 1.0.1-beta.0 → 1.0.1

package/.next/standalone/docs-old/es/cli/audit.mdx

@@ -0,0 +1,137 @@
+---
+title: Auditar sesiones pasadas (beta)
+description: "Cuenta con qué frecuencia el agente realizó acciones innecesarias o riesgosas en transcripciones pasadas"
+---
+
+<Note>
+  **Función beta.** La auditoría se lanza en beta mientras recopilamos
+  comentarios iniciales. El catálogo de detectores y el formato del informe
+  pueden cambiar antes de la próxima versión estable. Por favor, abre un issue
+  si algo parece incorrecto.
+</Note>
+
+La auditoría reproduce las transcripciones pasadas de tu agente de CLI a través
+del motor de políticas de failproofai y genera un informe visual y compartible
+en la **página del panel `/audit`** — el arquetipo de tu agente, una puntuación
+de 0 a 100, y exactamente qué políticas habrían detectado qué.
+
+## Ejecutar la auditoría
+
+Hay tres formas de iniciarla — todas llevan al mismo informe `/audit`.
+
+<CodeGroup>
+
+```bash npx (sin instalación)
+npx -y failproofai audit
+```
+
+```bash failproofai audit
+failproofai audit
+```
+
+```bash failproofai (panel)
+failproofai
+```
+
+</CodeGroup>
+
+<CardGroup cols={3}>
+  <Card title="Sin instalación" icon="bolt">
+    `npx -y failproofai audit` descarga failproofai, ejecuta el análisis y abre
+    el panel automáticamente — no necesitas instalar nada antes.
+  </Card>
+  <Card title="Desde la CLI" icon="terminal">
+    `failproofai audit` ejecuta el análisis en tu terminal y luego abre
+    `localhost:8020/audit` automáticamente al terminar.
+  </Card>
+  <Card title="Desde el panel" icon="gauge">
+    Ejecuta `failproofai` y haz clic en **Audit** en la barra de navegación
+    (entre Policies y Projects), o abre `/audit` directamente.
+  </Card>
+</CardGroup>
+
+<Tip>
+  Ejecuta `failproofai audit -h` (o `--help`) para ver el uso. La auditoría se
+  ejecuta **completamente sin conexión** — no requiere cuenta ni red — y el
+  panel sigue disponible hasta que lo detengas con `Ctrl+C`.
+</Tip>
+
+El panel analiza las transcripciones pasadas de la CLI del agente en esta máquina (Claude Code, Codex, Copilot, Cursor, OpenCode, Pi) e informa con qué frecuencia el agente realizó acciones que failproofai está diseñado para detener — verificaciones de variables de entorno, force pushes, prefijos redundantes `cd <cwd>`, bucles de polling con sleep, relectura de archivos recién editados, y más.
+
+Por cada transcripción, cada evento de uso de herramienta se reproduce a través de las 39 políticas integradas **y** a través de 8 detectores exclusivos de auditoría que capturan patrones que aún no están cubiertos por las políticas en tiempo real. Los conteos se agregan por política/detector en todas las sesiones.
+
+## Qué obtienes
+
+La página `/audit` es un **póster** de pantalla única y compartible, seguido de cuatro secciones debajo del pliegue:
+
+1. **Póster** — la identidad de tu agente de un vistazo: su **arquetipo** (uno de 8 — `optimist`, `cowboy`, `explorer`, `goldfish`, `paranoid architect`, `precision builder`, `hammer`, `ghost`), sus palabras clave de personalidad, qué tan raro es ese arquetipo, y una **puntuación de 0 a 100** con una banda de nivel (`S` hasta `bottom tier`). Diseñado para compartir — publícalo en X o LinkedIn, o descárgalo como PNG.
+2. **`// strengths`** — lo que tu agente ya hace bien, con números reales del análisis (p. ej., porcentaje de llamadas de herramienta limpias, `0` intentos de push-to-main), mostrado solo donde la política relevante tiene un historial limpio.
+3. **`// quirks`** — lo que se escapó: una tabla ordenada de comportamientos que failproofai habría detectado — *cuándo* ocurrió por última vez, *qué se escapó* (y la política integrada que lo habría bloqueado), su *severidad*, y con qué frecuencia se *detectó* (`new` / `recurring` / `N× seen`).
+4. **`// how to improve`** — la lista de correcciones recomendadas: una fila por política con un `failproofai policy add <slug>` listo para copiar y pegar, más un botón de **instalar todo** que habilita todas las recomendaciones a la vez y muestra tu **puntuación proyectada** si lo hicieras.
+5. **`// come back better`** — crea el hábito: configura un **recordatorio** de reauditoría por correo electrónico (`3d` / `7d` / `14d` / `30d`) o reaudita ahora, e **invita a un amigo** a ejecutar su propia auditoría (enviado desde failproof.ai, con copia a ti). Los recordatorios e invitaciones requieren iniciar sesión.
+
+## Auditorías programadas
+
+Si ejecutas el **daemon failproofaid** (ver [`failproofai config`](/es/cli/install-policies)),
+puede volver a ejecutar la auditoría según un programa y actualizar el informe
+`/audit` en segundo plano. Está **desactivado por defecto**, porque el análisis
+lee el *contenido* de cada transcripción de sesión del agente en esta máquina
+— nada se analiza con un temporizador hasta que lo solicites.
+
+Actívalo en `~/.failproofai/config.toml`:
+
+```toml
+[audit]
+auto = true
+interval_days = 7
+```
+
+| Clave | Significado |
+|---|---|
+| `auto` | `true` habilita el análisis programado. Cualquier otro valor — ausente, `false`, `"yes"` — está desactivado. |
+| `interval_days` | Días entre análisis. Limitado a 1–90; `0`, un valor negativo o no numérico vuelve a `7`. |
+
+- El programa es de **reloj de pared**, por lo que sobrevive a suspensiones y
+  reinicios: una laptop que estaba dormida más allá de su hora programada
+  ejecuta el análisis **una vez** al despertar, nunca un backlog acumulado.
+- Cada ejecución es un proceso separado de baja prioridad (`nice 19`) — nunca
+  en la ruta del hook del daemon, que permanece libre para responder llamadas
+  de herramientas.
+- Un análisis se omite si `failproofai audit` o la re-ejecución del panel ya
+  están en curso; se reintenta poco después en lugar de tratarse como un error.
+- El progreso se escribe en `~/.failproofai/state/audit-schedule.json` (última
+  ejecución, próxima fecha). El daemon gestiona ese archivo — cambia la
+  cadencia en `config.toml`.
+
+<Note>
+Si habilitaste esto en una máquina configurada con una versión anterior de
+failproofai, ejecuta `failproofai config` una vez. La definición del servicio
+del daemon necesita una entrada adicional antes de poder lanzar la CLI, y la
+actualización forma parte de ese comando.
+</Note>
+
+## Detectores exclusivos de auditoría
+
+Estos detectan patrones de "comportamiento ineficiente" que aún no se aplican en tiempo real. Solo se ejecutan durante la auditoría y nunca bloquean una llamada de herramienta en vivo.
+
+| Detector | Qué cuenta |
+|---|---|
+| `redundant-cd-cwd` | Comandos Bash que comienzan con `cd <cwd> && …` aunque los comandos ya se ejecutan en `cwd`. |
+| `prefer-edit-over-read-cat` | `cat`/`head`/`tail`/`less`/`more` en un único archivo fuente — usa la herramienta `Read`. |
+| `prefer-edit-over-sed-awk` | Ediciones en el lugar con `sed -i` / `awk … > file` — usa la herramienta `Edit`. |
+| `prefer-write-over-heredoc` | Escritura de archivos con heredoc / `echo > file` multilínea — usa la herramienta `Write`. |
+| `sleep-polling-loop` | `sleep N` largo (≥ 30s) o bucles de polling `while …; sleep …; done`. |
+| `find-from-root` | `find /`, `find /home`, `find /usr`, etc. — limita el alcance a `cwd`. |
+| `git-commit-no-verify` | `git commit … --no-verify` / `-n`, omitiendo los hooks. |
+| `reread-after-edit` | `Read` de un archivo que acaba de ser modificado con `Edit`/`Write` en la misma sesión. |
+
+## Cachés
+
+- **Caché por transcripción** en `~/.failproofai/cache/audit/<sha1>.json` con clave `(mtime, size, engineVersion, detectorVersion)` — se invalida automáticamente cuando cambia la transcripción o el código de política/detector. Cada entrada también almacena una marca de tiempo `cachedAt` como **metadatos de TTL** (no forman parte de la clave de caché); las entradas con más de **7 días** se rechazan al leer para que los resultados de larga duración no superen la intención cambiante de los detectores.
+- **Caché de resultado completo** en `~/.failproofai/audit-dashboard.json` (modo 0600). Permite que el panel se renderice al instante al navegar sin necesidad de volver a ejecutar el análisis. También se rechaza al leer pasado el **TTL de 7 días** — `/audit` entonces cae a su estado vacío y solicita una nueva ejecución. Haz clic en `[ re-audit now ]` cerca de la parte inferior del informe para actualizar — la reauditoría envía `noCache: true`, por lo que omite la caché por transcripción y vuelve a analizar cada transcripción en lugar de devolver el resultado en caché; la ejecución transmite el progreso mediante una banda fija en la parte superior y reemplaza el resultado en el lugar al completarse con éxito (sin recargar la página; una reauditoría fallida conserva el informe anterior).
+
+## Notas
+
+- **Sin mutaciones.** La auditoría se reproduce en modo de solo lectura. `warn-repeated-tool-calls` se omite porque su sidecar por sesión se modificaría de lo contrario.
+- **Políticas de flujo de trabajo omitidas.** Las políticas `require-*-before-stop` solo se activan en eventos `Stop` y ejecutan `execSync` contra el estado de git en vivo — no tienen una interpretación significativa de "qué habría pasado en 2025", por lo que no aparecen en los conteos de auditoría.
+- **Políticas personalizadas omitidas.** Los hooks personalizados suministrados por el usuario no se reproducen (pueden haber cambiado desde la sesión original).

package/.next/standalone/docs-old/es/cli/dashboard.mdx

@@ -0,0 +1,29 @@
+---
+title: Ver sesiones
+description: "Inicia el panel de control para explorar sesiones de agentes y gestionar políticas"
+---
+
+```bash
+failproofai
+```
+
+Inicia el panel de control web en `http://localhost:8020`.
+
+## Opciones
+
+| Indicador | Descripción |
+|-----------|-------------|
+| `--port <number>` | Puerto en el que escuchar (por defecto: `8020`) |
+| `--allowed-origins <origins>` | Hosts/IPs separados por comas con permiso para acceder a los recursos de desarrollo |
+
+Para apuntar el panel de control a una carpeta de proyecto de Claude distinta a la predeterminada, establece la variable de entorno `CLAUDE_PROJECTS_PATH` al iniciarlo.
+
+## Ejemplos
+
+```bash
+# Iniciar en un puerto diferente
+failproofai --port 9000
+
+# Usar una ruta de proyectos de Claude personalizada mediante variable de entorno
+CLAUDE_PROJECTS_PATH=~/my-claude-projects failproofai
+```

package/.next/standalone/docs-old/es/cli/environment-variables.mdx

@@ -0,0 +1,72 @@
+---
+title: Variables de entorno
+description: "Configura el comportamiento de failproofai con variables de entorno"
+---
+
+## Panel de control
+
+| Variable | Descripción |
+|----------|-------------|
+| `PORT` | Puerto del panel de control (por defecto: `8020`) |
+| `CLAUDE_PROJECTS_PATH` | Anula la ubicación donde se buscan las carpetas de proyectos de Claude Code |
+| `FAILPROOFAI_DISABLE_PAGES=policies,projects` | Páginas del panel separadas por comas que se ocultarán |
+| `FAILPROOFAI_ALLOWED_DEV_ORIGINS` | Hosts/IPs con acceso a recursos de desarrollo. Equivalente a `--allowed-origins`. |
+
+## Registro
+
+| Variable | Descripción |
+|----------|-------------|
+| `FAILPROOFAI_LOG_LEVEL=info\|warn\|error` | Nivel de registro del servidor (por defecto: `warn`) |
+| `FAILPROOFAI_HOOK_LOG_FILE` | Ruta personalizada del archivo de registro de hooks, o `true` para usar el predeterminado (`~/.failproofai/logs/hooks.log`) |
+
+## Telemetría
+
+failproofai reporta telemetría de uso anónima por defecto. Hay dos formas de
+desactivarla, y se aplica la más restrictiva de las dos — una variable de entorno
+nunca puede reactivar algo que el archivo de configuración haya desactivado.
+
+| Variable | Descripción |
+|----------|-------------|
+| `FAILPROOFAI_TELEMETRY_DISABLED=1` | Desactiva la telemetría de uso anónima para este proceso |
+
+Para desactivarla de forma permanente en la máquina, añade esto a `~/.failproofai/config.toml`:
+
+```toml
+[telemetry]
+enabled = false
+```
+
+<Note>
+El archivo de configuración es la opción recomendada si ejecutas el **daemon failproofaid**.
+El daemon es un servicio de ámbito del sistema y su entorno no incluye
+las variables exportadas desde tu shell — por lo tanto, `FAILPROOFAI_TELEMETRY_DISABLED` no
+puede alcanzarlo. `[telemetry] enabled = false` es leído tanto por la CLI como por el daemon.
+</Note>
+
+El daemon reporta únicamente su propio **ciclo de vida**: que se inició (y si la
+ejecución anterior finalizó correctamente), que se detuvo, cuándo se creó o reinició
+su worker de evaluación, cuándo falló una tarea del recolector y el resultado de una
+sincronización de políticas en la nube. Estos eventos contienen valores de baja
+cardinalidad y contadores — nunca una ruta de archivo, un comando, una política, un
+prompt ni nada leído de una transcripción. No existe ningún evento por llamada a herramienta.
+
+## Autenticación
+
+| Variable | Descripción |
+|----------|-------------|
+| `FAILPROOF_API_URL` | Anula la URL base del servidor de API utilizada por el diálogo de autenticación del panel. Por defecto es `https://api.befailproof.ai`; establécela en `http://localhost:8080` (o donde corresponda) al ejecutar un servidor de API local. |
+| `FAILPROOFAI_AUTH_DIR` | Anula la ubicación donde se almacena `auth.json` (por defecto: `~/.failproofai`). Principalmente útil para pruebas aisladas. |
+
+## Aviso de primer uso
+
+| Variable | Descripción |
+|----------|-------------|
+| `FAILPROOFAI_NO_FIRST_RUN=1` | Omite el aviso que ofrece instalar políticas en la primera invocación básica de `failproofai` |
+
+## LLM (para evaluación de políticas)
+
+| Variable | Descripción |
+|----------|-------------|
+| `FAILPROOFAI_LLM_BASE_URL` | Endpoint de la API del LLM (por defecto: `https://api.openai.com/v1`) |
+| `FAILPROOFAI_LLM_API_KEY` | Clave de API para políticas basadas en LLM |
+| `FAILPROOFAI_LLM_MODEL` | Nombre del modelo (por defecto: `gpt-4o-mini`) |

package/.next/standalone/docs-old/es/cli/hook.mdx

@@ -0,0 +1,30 @@
+---
+title: Manejador de hooks (interno)
+description: "El subproceso que Claude Code invoca en cada evento de herramienta"
+---
+
+```bash
+failproofai --hook <EventType>
+```
+
+Este es el comando registrado en el archivo `settings.json` de Claude Code por `failproofai policies --install`. Normalmente no se invoca directamente.
+
+Lee un payload JSON desde stdin, evalúa todas las políticas habilitadas y termina con un código que indica la decisión:
+
+| Código de salida | Decisión | Efecto |
+|------------------|----------|--------|
+| `0` | `allow` | Permite la acción |
+| `1` | `deny` | Bloquea la acción — Claude recibe el motivo del rechazo |
+| `2` | `instruct` | Inyecta orientación en el contexto de Claude |
+
+### Tipos de eventos soportados
+
+| Categoría | Eventos |
+|-----------|---------|
+| **Ejecución de herramientas** | `PreToolUse`, `PostToolUse`, `PostToolUseFailure`, `PermissionRequest`, `PermissionDenied` |
+| **Ciclo de vida de sesión** | `SessionStart`, `SessionEnd`, `Stop`, `StopFailure` |
+| **Interacción con el usuario** | `UserPromptSubmit`, `Notification`, `Elicitation`, `ElicitationResult` |
+| **Subagentes y tareas** | `SubagentStart`, `SubagentStop`, `TaskCreated`, `TaskCompleted`, `TeammateIdle` |
+| **Configuración** | `InstructionsLoaded`, `ConfigChange`, `CwdChanged` |
+| **Sistema de archivos** | `FileChanged`, `WorktreeCreate`, `WorktreeRemove` |
+| **Contexto** | `PreCompact`, `PostCompact` |

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

@@ -0,0 +1,57 @@
+---
+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 archivo de configuración del CLI del agente instalado (Claude Code, OpenAI Codex o GitHub Copilot CLI _(beta)_) para que failproofai intercepte las llamadas de herramientas.
+
+Alias: `failproofai p -i`
+
+## Opciones
+
+| Bandera | Descripción |
+|---------|-------------|
+| `--cli claude\|codex\|copilot` | CLI(s) del agente en los que instalar; separados por espacios (p. ej. `--cli claude codex copilot`) o repetidos. Omite este parámetro para detectar los CLIs instalados y mostrar un menú. |
+| `--scope user` | Instala en el archivo de configuración de ámbito de usuario (Claude: `~/.claude/settings.json`; Codex: `~/.codex/hooks.json`; Copilot: `~/.copilot/hooks/failproofai.json`). Valor predeterminado. |
+| `--scope project` | Instala en el archivo de configuración de ámbito de proyecto (Claude: `<cwd>/.claude/settings.json`; Codex: `<cwd>/.codex/hooks.json`; Copilot: `<cwd>/.github/hooks/failproofai.json`). |
+| `--scope local` | Solo Claude — instala en `<cwd>/.claude/settings.local.json`. Codex y Copilot no tienen un ámbito `local`. |
+| `--custom <path>` / `-c` | Ruta a un archivo JS que contiene políticas de hook personalizadas |
+
+## Comportamiento
+
+- **Sin nombres de política** — abre un menú interactivo para seleccionar políticas
+- **Nombres específicos** — habilita esas políticas (se añaden a las ya habilitadas)
+- **`all`** — habilita todas las políticas disponibles
+
+La instalación es aditiva: volver a ejecutar `--install` 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 de una vez
+failproofai policies --install all
+
+# Instalar con un archivo de políticas personalizado
+failproofai policies --install --custom ./my-policies.js
+
+# Instalar para OpenAI Codex (ámbito de proyecto)
+failproofai policies --install --cli codex --scope project
+
+# Instalar para GitHub Copilot CLI (beta) en el proyecto actual
+failproofai policies --install --cli copilot --scope project
+
+# Instalar para los tres CLIs a la vez
+failproofai policies --install --cli claude codex copilot
+```
+
+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-old/es/cli/list-policies.mdx

@@ -0,0 +1,31 @@
+---
+title: Listar políticas
+description: "Ver qué políticas están habilitadas, sus parámetros y las políticas personalizadas"
+---
+
+```bash
+failproofai policies
+```
+
+Muestra todas las políticas con su estado, parámetros configurados y políticas personalizadas.
+
+## Salida de ejemplo
+
+```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 antelación.

package/.next/standalone/docs-old/es/cli/migrate.mdx

@@ -0,0 +1,86 @@
+---
+title: Migrar el directorio home
+description: "Actualiza ~/.failproofai al esquema que esta versión utiliza, y previsualiza los cambios antes de ejecutarlos"
+---
+
+```bash
+failproofai migrate --dry-run   # muestra el plan sin realizar cambios
+failproofai migrate             # ejecuta la migración
+```
+
+La mayoría de las personas nunca necesitan escribir esto. Se ejecuta automáticamente con el primer comando tras una actualización, y [`failproofai update`](/es/cli/update) lo incluye. Úsalo directamente cuando quieras ver el plan antes de que ocurra, o para ejecutar la migración de forma independiente.
+
+## Basado en el esquema, no en la versión
+
+`~/.failproofai/VERSION` registra un número de **esquema** — la estructura del directorio, no la versión que lo creó. Las migraciones están asociadas a ese número, lo que hace que saltar muchas versiones sea económico:
+
+- Las versiones de npm cambian en cada lanzamiento, decenas de ellas entre dos esquemas.
+- Así, una máquina que salta treinta versiones **sin cambio de esquema** ejecuta **cero** migraciones, no treinta operaciones vacías.
+- Y una máquina que salta varios esquemas a la vez ejecuta cada paso en orden, donde cada paso solo conoce sus propios dos extremos.
+
+Esto importa porque npm no puede actualizar por sí solo un paquete instalado. Una máquina que permanece en una versión durante meses y luego salta varios esquemas es el caso habitual, no el excepcional.
+
+## El simulacro
+
+`--dry-run` muestra la cadena exacta y los archivos que se guardarían primero, sin realizar ningún cambio — ni migración, ni copia de seguridad, ni entrada en el registro:
+
+```
+Layout 2 on disk; this build speaks 3.
+1 step(s) would run:
+  2 → 3  layout 2 → 3: carry config.toml and credentials.toml into JSON, move
+         custom-policies/ back up into policies/, nest the policy config at the root
+
+These would be copied to ~/.failproofai/migrations/backup-layout2 first:
+  VERSION
+  config.toml
+  credentials.toml
+```
+
+## Qué se conserva y qué se reconstruye
+
+Cada ruta en el directorio home declara qué tipo de datos contiene, y eso determina si una migración puede descartarla. La regla: **lo derivado y recuperable puede eliminarse; cualquier cosa que hayas escrito, cualquier cosa aún no entregada, y cualquier cosa que identifique la máquina se conserva.**
+
+| Conservado | Reconstruido o recuperado |
+|---|---|
+| `config.json` — ajustes, `daemon.configured`, rutas de captura adicionales | La caché de auditoría |
+| `credentials.json` — tu registro en la nube | Despliegues gestionados en la nube (recuperados y verificados por hash en el siguiente sondeo) |
+| `policies-config.json` — tu selección de políticas y parámetros | Estado temporal del daemon |
+| `policies/` — tus propios archivos de políticas y los helpers que importan | |
+| `hook-activity/` — el registro de decisiones que lee el panel | |
+| Eventos no entregados aún en cola para subir | |
+| `cursors/` — marcas de agua del colector | |
+| El binario del daemon en `bin/` | |
+
+<Note>
+  Los eventos no entregados se conservan en lugar de descartarse porque la pérdida sería permanente, no simplemente lenta: la marca de agua del colector ya ha avanzado más allá de cualquier cosa en la cola, por lo que nada volvería a leer ese rango de una transcripción. La migración también le pide al daemon que entregue lo que hay en la cola en cuanto termina, así que el resultado habitual es que no queda nada por conservar.
+</Note>
+
+Las claves que una versión *más nueva* escribió en `config.json`, `credentials.json` o `policies-config.json` también se preservan, en lugar de ser descartadas por un lector más antiguo.
+
+## El registro que deja
+
+```
+~/.failproofai/migrations/
+  applied.json                 una entrada por paso: esquema, CLI, marca de tiempo, duración, resultado
+  backup-layout<n>/            copias de los archivos irremplazables, tomadas antes del primer paso
+```
+
+`applied.json` es lo que responde a la pregunta «¿qué ha pasado realmente en esta máquina?» — la primera pregunta que vale la pena hacer cuando algo parece incorrecto tras una actualización. Adjúntalo a un informe de error.
+
+La copia de seguridad es deliberadamente pequeña en lugar de ser una copia completa del directorio: la migración ya no elimina nada irremplazable por diseño, así que lo que merece asegurarse es un *defecto en un paso*, y estos pocos archivos son donde tal defecto podría causar daño.
+
+## Si un paso falla
+
+La cadena se detiene ahí. `VERSION` solo se actualiza cuando un paso se completa con éxito, por lo que el directorio home permanece marcado con su esquema antiguo y el siguiente comando lo reintenta — un directorio home nunca se marca como actualizado basándose en una migración parcial. El paso se registra en `applied.json` con `"ok": false`, y la copia de seguridad permanece donde se tomó.
+
+## Un directorio home más nuevo se rechaza, no se migra
+
+Si `~/.failproofai/` fue escrito por una versión de failproofai **más reciente** que la que estás ejecutando, el comando se detiene y te indica que actualices. Esos datos están bien y una CLI más nueva los lee sin problemas; migrar «hacia delante» desde ellos no es algo que exista, y restablecerlos destruiría algo recuperable.
+
+```
+This machine's failproofai directory was written by a newer version (layout 4;
+this build speaks 3). Upgrade rather than migrate:
+  npm install -g failproofai@latest
+```
+
+El daemon aplica la misma regla: `failproofaid` se niega a iniciarse con un esquema que no reconoce, en lugar de leer y escribir rutas que han cambiado.

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

@@ -0,0 +1,43 @@
+---
+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 `settings.json` de Claude Code.
+
+Alias: `failproofai p -u`
+
+## Opciones
+
+| Flag | 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 el `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-old/es/cli/update.mdx

@@ -0,0 +1,64 @@
+---
+title: Actualizar tras una actualización de versión
+description: "Completa la mitad de una actualización que npm no puede hacer: migra el directorio de inicio y sincroniza el daemon"
+---
+
+```bash
+npm install -g failproofai@latest && failproofai update
+```
+
+Eso es todo lo que necesitas para actualizar. `npm` reemplaza la CLI; `failproofai update` hace el resto.
+
+## Por qué existe un segundo comando
+
+`npm install -g` reemplaza una sola cosa: la CLI. Otras dos partes de una instalación de failproofai viven fuera del paquete de forma intencionada, y ninguna se mueve cuando npm se ejecuta:
+
+- **`~/.failproofai/`**, tu configuración, inscripción en la nube, selección de políticas e historial. Una nueva versión puede organizarlo de manera diferente, y esa reorganización debe realizarla código que conozca ambas estructuras.
+- **El binario del daemon `failproofaid`**, ubicado en `~/.failproofai/bin/failproofaid-<version>`. No está dentro de `node_modules` de forma deliberada: una actualización que reemplazara el archivo bajo un servicio en ejecución redirigiría un daemon activo hacia un binario compilado a partir de código fuente diferente, y eliminar el paquete lo borraría de debajo de un servicio que luego entraría en un bucle de fallos en cada arranque.
+
+Por tanto, tras ejecutar solo `npm install -g`, la CLI es nueva pero el daemon no lo es. `failproofaid` se niega a iniciarse con una estructura de directorio de inicio que no reconoce —la versión ruidosa de ese desajuste, en lugar de la silenciosa— así que ambas mitades deben sincronizarse. `failproofai update` es ese paso.
+
+## Qué hace
+
+<Steps>
+  <Step title="Ejecuta las migraciones de estructura pendientes">
+    Lee la estructura registrada en `~/.failproofai/VERSION` y ejecuta los pasos necesarios para llevarla a la que esta versión utiliza. Normalmente ninguno — consulta [`failproofai migrate`](/es/cli/migrate).
+  </Step>
+  <Step title="Coloca el binario del daemon correspondiente">
+    Desde el paquete de plataforma que npm ya descargó cuando es posible (sin red), o bien desde el recurso de lanzamiento para esta versión exacta, verificado con SHA-256 antes de usarlo.
+  </Step>
+  <Step title="Reinicia el servicio y confirma que arrancó correctamente">
+    Se verifica mediante sondeo, no por suposición — un gestor de servicios reporta un proceso activo en el momento en que hace fork, lo cual no es lo mismo que estar funcionando correctamente.
+  </Step>
+</Steps>
+
+## Opciones
+
+| Opción | Efecto |
+|--------|--------|
+| `--no-daemon` | Migra solo el directorio de inicio, dejando el daemon en su versión actual. |
+
+<Warning>
+  `--no-daemon` deja en su lugar un daemon con versión desincronizada. En una máquina configurada para requerir el daemon, cada evento de hook **falla en modo cerrado** si el daemon no puede responder — y un daemon que se niega a iniciarse con un directorio de inicio migrado no puede responder. Es preferible dejar que también se ejecute la mitad del daemon.
+</Warning>
+
+## Si algo sale mal
+
+El comando termina con código de salida distinto de cero e indica qué mitad falló. Dos casos que conviene conocer:
+
+- **Un paso de migración no terminó.** El directorio de inicio se deja marcado con su estructura *anterior*, de modo que el próximo comando la reintentará — ningún directorio de inicio se marca como actualizado basándose en una migración parcial. Se guardaron copias de tu configuración e inscripción antes de ejecutar nada, en `~/.failproofai/migrations/backup-layout<n>/`.
+- **El daemon no pudo reiniciarse sin contraseña.** Se usa `sudo -n` de forma deliberada, para que nada solicite credenciales desde debajo de una pantalla de progreso. El comando imprime la línea exacta que debes ejecutar tú mismo.
+
+<Note>
+  Nada de esto requiere el asistente de configuración interactivo. Tu configuración, inscripción en la nube y selección de políticas sobreviven a una actualización, por lo que una máquina migrada aplica exactamente las mismas reglas que antes — lo que importa sobre todo en las máquinas en las que no hay nadie delante: un runner de CI, una máquina de una flota, una pasarela sin interfaz gráfica.
+</Note>
+
+## Automatización
+
+`failproofai update` es no interactivo y es seguro ejecutarlo cuando no hay nada que hacer — reporta "no se necesitaba ninguna migración" y termina con código 0. Añadirlo después de cada actualización en un script de aprovisionamiento o en un Dockerfile es el uso previsto:
+
+```dockerfile
+RUN npm install -g failproofai@latest && failproofai update --no-daemon
+```
+
+(`--no-daemon` en una construcción de imagen, donde todavía no hay ningún servicio que reiniciar.)

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

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