failproofai 1.0.1-beta.1 → 1.0.1

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

@@ -0,0 +1,151 @@
+---
+title: Dashboard
+description: "Monitorea sesiones de agentes, revisa llamadas a herramientas y gestiona políticas"
+icon: chart-line
+---
+
+El dashboard de failproofai es una aplicación web local para monitorear tus sesiones de agentes de IA y gestionar políticas. Descubre qué hicieron tus agentes mientras no estabas.
+
+---
+
+## Iniciar el dashboard
+
+```bash
+failproofai
+```
+
+Se abre en `http://localhost:8020`.
+
+El dashboard lee datos de configuración del proyecto local, sesiones y failproofai directamente desde el sistema de archivos. Las funciones autenticadas opcionales, como recordatorios de auditoría e invitaciones, envían la información necesaria para esas solicitudes (incluidas las direcciones de correo electrónico) a APIs remotas.
+
+---
+
+## Páginas
+
+### Proyectos
+
+Lista todos los proyectos de Claude Code, OpenAI Codex, GitHub Copilot CLI _(beta)_, Cursor Agent _(beta)_, OpenCode _(beta)_, Pi _(beta)_, Hermes, OpenClaw, Factory Droid, Devin, Antigravity y Goose encontrados en tu máquina. Los proyectos de Claude se descubren en `~/.claude/projects/` (o la ruta definida por `CLAUDE_PROJECTS_PATH`); los proyectos de Codex se descubren escaneando todas las transcripciones en `~/.codex/sessions/<YYYY>/<MM>/<DD>/*.jsonl` y agrupando por el `cwd` registrado en el primer registro de cada sesión; los proyectos de Copilot CLI se descubren escaneando cada `~/.copilot/session-state/<sessionId>/workspace.yaml` (configurable mediante `COPILOT_HOME`) y agrupando por su campo `cwd`; los proyectos de Cursor Agent se descubren escaneando los metadatos por sesión en `~/.cursor/agent-sessions/<sessionId>/` (configurable mediante `CURSOR_HOME`, con `conversations/` y `sessions/` como rutas alternativas) para un escalar `cwd` en `meta.json` / `session.json` / `workspace.yaml`; los proyectos de OpenCode se descubren consultando su base de datos SQLite en `~/.local/share/opencode/opencode.db` mediante `opencode db --format json` (leemos las tablas `session` y `project` y agrupamos por `project_id`); los proyectos de Pi se descubren escaneando transcripciones JSONL por sesión en `~/.pi/agent/sessions/<encoded-cwd>/<timestamp>_<uuid>.jsonl` (configurable mediante `PI_SESSIONS_DIR`) y extrayendo el `cwd` del primer registro de cada sesión; las sesiones del gateway de Hermes se leen directamente del almacén SQLite de cada perfil — `~/.hermes/state.db` más `~/.hermes/profiles/<name>/state.db` (reemplazable mediante `HERMES_HOME`, o `HERMES_DB_PATH` para una sola base de datos) — y se agrupan en proyectos `hermes-<profile>-<source>` por perfil y `source` (Slack/Telegram/cli/cron — las sesiones del gateway no tienen cwd); las sesiones del gateway de OpenClaw se leen desde `~/.openclaw/agents/<agentId>/sessions/*.jsonl` y se agrupan en proyectos `openclaw-<agentId>-<channel>` por agente y canal (también sin cwd); los proyectos de Factory Droid se descubren a partir de las transcripciones JSONL en `~/.factory/sessions/<encoded-cwd>/*.jsonl` y se agrupan por cwd; los proyectos de Devin desde su base de datos SQLite en `~/.local/share/devin/cli/sessions.db` (agrupados por el `working_directory` de cada sesión); los proyectos de Antigravity desde las transcripciones JSONL en `~/.gemini/antigravity-cli/brain/<conversationId>/…/transcript_full.jsonl` y agrupados por cwd; y los proyectos de Goose desde su base de datos SQLite en `~/.local/share/goose/sessions/sessions.db` (agrupados por el `working_dir` de cada sesión). Un proyecto que ha sido utilizado por múltiples CLIs se muestra como una sola fila con todas las insignias correspondientes. Usa el menú desplegable **CLI** sobre la tabla para filtrar por un agente CLI específico; la URL conserva tu selección como `?cli=claude|codex|copilot|cursor|opencode|pi|hermes|openclaw|factory|devin|antigravity|goose`.
+
+Hermes y OpenClaw son de ámbito de usuario y no tienen directorio de trabajo para agrupar, por lo que se muestran como un **árbol de carpetas plegable** — el perfil (o agente) en el nivel superior, sus canales debajo — mientras que todos los CLIs basados en cwd permanecen como filas planas. Las filas de carpetas acumulan el recuento de sesiones y la actividad más reciente de todo lo que contienen; las carpetas plegadas se recuerdan entre visitas, y una búsqueda por palabras clave expande lo que coincida.
+
+Cada proyecto muestra:
+- Nombre del proyecto (derivado de la ruta de la carpeta)
+- Una insignia de CLI — `Claude Code` (naranja), `OpenAI Codex` (morado), `GitHub Copilot` (azul), `Cursor Agent` (esmeralda), `OpenCode` (ámbar), `Pi` (rosa) y/o `Hermes` (índigo)
+- Fecha de la actividad de sesión más reciente
+
+Haz clic en un proyecto para ver sus sesiones.
+
+### Sesiones
+
+Lista todas las sesiones dentro de un proyecto. Cada sesión muestra:
+- ID de sesión
+- Marcas de tiempo de inicio y fin
+- Número de llamadas a herramientas
+- Recuento de actividad de hooks (políticas que se activaron)
+
+Usa el filtro de rango de fechas y la búsqueda por ID de sesión para acotar la lista. Las sesiones están paginadas.
+
+Haz clic en una sesión para abrir el visor de sesiones.
+
+### Visor de sesiones
+
+El visor de sesiones responde la pregunta clave para agentes autónomos: ¿qué hizo el agente y se mantuvo en el camino correcto? Una insignia de CLI junto al encabezado indica si la sesión es una transcripción de Claude Code, OpenAI Codex, GitHub Copilot CLI, Cursor Agent, OpenCode, Pi, Hermes, OpenClaw, Factory Droid, Devin, Antigravity o Goose. Muestra una línea de tiempo de todo lo que ocurrió en una sesión:
+
+- **Mensajes** - Las respuestas de texto de Claude y los prompts del usuario
+- **Llamadas a herramientas** - Cada herramienta que Claude invocó, con su entrada y salida
+- **Actividad de políticas** - Para cada llamada a herramienta, qué políticas se activaron y qué decisión devolvieron
+
+La barra de estadísticas en la parte superior muestra la duración de la sesión, el total de llamadas a herramientas y un resumen de las decisiones de los hooks (recuentos de allow / deny / instruct).
+
+Haz clic en el botón **Download Logs** para exportar la sesión. Para sesiones de Claude Code, Codex, Copilot, Cursor y Pi obtienes la transcripción JSONL original en disco byte a byte; para OpenCode (cuyas sesiones viven en SQLite, no en disco) obtienes un documento JSON que refleja las tablas subyacentes `session` / `messages` / `parts`.
+
+### Audit
+
+Un informe con personalidad sobre cómo se ha comportado realmente tu agente a lo largo de sesiones pasadas. Ejecuta el mismo escaneo que el CLI `failproofai audit` pero lo muestra como un póster compartible de pantalla completa + cuatro secciones adicionales:
+
+1. **Póster** — ocupa el primer viewport. Región de captura PNG autónoma con el logotipo de failproof_ai + etiqueta de auditoría · índice de arquetipo (`№ NN of 08`) + fecha de auditoría · puntuación numérica (0–100) + píldora de rango percentil (`top 15%`) · el nombre del arquetipo (uno de `the optimist`, `the cowboy`, `the explorer`, `the goldfish`, `the paranoid architect`, `the precision builder`, `the hammer`, `the ghost`) + tira de 3 palabras clave · línea de rareza `// only N% of agents are this archetype` · mosaico de símbolo de 8×8 píxeles · pie de página `audit yours → failproof.ai`. Tres botones de compartir están justo fuera del área de captura: `post your archetype` (X intent), `share on linkedin`, `download poster`. La captura se realiza mediante `html-to-image` para que el PNG coincida con el renderizado en pantalla píxel a píxel (bordes discontinuos, máscara de logo SVG, degradados, métricas de fuente — todo preservado).
+2. **Fortalezas** — lista de filas con ✓ de comportamientos que tu agente ya hace bien, derivados de los datos de auditoría en vivo (tasa de llamadas a herramientas limpia, sin envíos directos a main, cero filtraciones de credenciales, cero tormentas de reintentos) — cada una aparece solo cuando la política relevante tiene un historial limpio en la ventana de auditoría.
+3. **Peculiaridades** — tabla de lo que se escapó, ordenado por severidad: `when · what slipped + the policy that would've caught it · severity pill · seen`, donde la recurrencia muestra `new` (una vez), `N× seen` (2–9 veces) o `recurring` (10+).
+4. **Cómo mejorar** — lista de filas, una por política prescrita: nombre de la política en blanco, descripción de una línea, comando de instalación + botón de copiar a la derecha. El encabezado de la sección muestra `enable all N → projected <score> · <tier>` (la puntuación que alcanzarías con todas las correcciones aplicadas), y su botón `[install all]` copia el comando combinado `failproofai policy add a b c …` para cada política prescrita.
+5. **Vuelve mejor** — dos tarjetas lado a lado. Izquierda: establece un recordatorio (selector de cadencia `3d` / `7d` / `14d` / `30d`; persiste mediante `/api/auth/reminder` una vez autenticado). Derecha: desbloquea ventajas de failproof — `invite a friend` abre un modal que acepta una lista separada por comas/espacios/saltos de línea de correos electrónicos de amigos (máximo 10 por envío), los envía mediante POST a `/api/audit/invite`, que los reenvía al `POST /v0/invite` del api-server. El api-server envía un correo electrónico por destinatario desde `invite@failproof.ai` con el remitente en Cc y `Reply-To` configurado, para que el destinatario vea quién lo invitó y el remitente reciba una copia en su bandeja de entrada. Los usuarios anónimos son redirigidos primero a través del `AuthDialog` para que el correo del remitente sea conocido antes de que salgan las invitaciones. El cumplimiento de derechos/ventajas es un seguimiento pendiente.
+
+Impulsado por el runtime de `failproofai audit` — consulta [Audit CLI](/es/cli/audit) para el motor de escaneo subyacente, los flags compatibles y los invariantes de caché por transcripción. El dashboard almacena en caché el último resultado en `~/.failproofai/audit-dashboard.json` (modo `0600`, una sola ranura, las nuevas ejecuciones sobreescriben) para que las revisitas sean instantáneas; **tanto la caché por transcripción como la caché del resultado completo se rechazan al leerlas una vez que tienen más de 7 días**, por lo que el dashboard nunca sirve silenciosamente un resultado de una semana — pasado el TTL, `/audit` cae a su estado vacío y solicita una nueva ejecución. Al hacer clic en `[ re-audit now ]` cerca de la parte inferior del informe se envía un POST a `/api/audit/run` con `noCache: true` — la re-auditoría omite la caché por transcripción y vuelve a escanear cada transcripción desde cero en lugar de devolver silenciosamente el resultado en caché — y el dashboard consulta `/api/audit/status` a 1 Hz hasta que la ejecución finaliza; una barra de progreso rosa pegajosa se fija en la parte superior del viewport durante la ejecución con un temporizador transcurrido, y el nuevo resultado reemplaza al anterior en el lugar cuando tiene éxito (sin recarga de página completa; una re-auditoría fallida deja el informe anterior intacto). En caso de fallo, la barra se vuelve roja con texto basado en el `RerunError.kind` (`timeout` / `network` / `post_failed`). El estado vacío (sin caché o caducada) y el estado de cero sesiones (caché existe pero el escaneo no encontró transcripciones) se muestran por separado.
+
+### Políticas
+
+Una página con dos pestañas para gestionar políticas y revisar la actividad.
+
+<Tabs>
+  <Tab title="Pestaña de Políticas">
+  - Selección múltiple de qué CLIs de agentes protege failproofai desde un solo panel — Claude Code, OpenAI Codex, GitHub Copilot, Cursor Agent, OpenCode, Pi y Hermes tienen una fila con el estado de instalación (`Active` / `Detected` / `Inactive`), la ruta de configuración de ámbito de usuario y un acento de color de marca. Marca o desmarca los CLIs que deseas y haz clic en `Apply changes` para instalar/desinstalar la diferencia en un solo paso. Los CLIs cuyo binario se detecta en PATH se marcan previamente.
+  - Activa o desactiva políticas individuales con un solo clic (escribe en `~/.failproofai/policies-config.json` — compartido entre todos los CLIs instalados)
+  - Expande una política para configurar sus parámetros (para políticas que soportan `policyParams`)
+  - Establece una ruta personalizada para el archivo de políticas
+  </Tab>
+  <Tab title="Pestaña de Actividad">
+  - Historial paginado completo de cada evento de hook que se ha activado en todas las sesiones
+  - Filtra por decisión, tipo de evento, CLI (Claude Code / OpenAI Codex / GitHub Copilot _(beta)_ / Cursor Agent _(beta)_ / OpenCode _(beta)_ / Pi _(beta)_ / Hermes / OpenClaw / Factory Droid / Devin / Antigravity / Goose), nombre de política o ID de sesión
+  - Cada fila muestra: marca de tiempo, nombre de política, decisión, insignia de CLI (naranja = Claude Code, morado = OpenAI Codex, azul = GitHub Copilot, esmeralda = Cursor Agent, ámbar = OpenCode, rosa = Pi, índigo = Hermes, verde azulado = OpenClaw, rosa intenso = Factory Droid, violeta = Devin, cian = Antigravity, lima = Goose), nombre de herramienta, ID de sesión y el motivo de las decisiones deny/instruct
+  - Haz clic en un ID de sesión para abrir su transcripción — el visor detecta automáticamente qué CLI activó el hook (Claude `~/.claude/projects/…`, Codex `~/.codex/sessions/…`, Copilot CLI `~/.copilot/session-state/<id>/events.jsonl`, Cursor Agent `~/.cursor/agent-sessions/<id>/events.jsonl`, OpenCode `~/.local/share/opencode/opencode.db`, Pi `~/.pi/agent/sessions/<encoded-cwd>/<id>.jsonl`, Hermes `~/.hermes/state.db`, OpenClaw `~/.openclaw/agents/<id>/sessions/*.jsonl`, Factory Droid `~/.factory/sessions/<encoded-cwd>/<id>.jsonl`, Devin `~/.local/share/devin/cli/sessions.db`, Antigravity `~/.gemini/antigravity-cli/brain/<id>/…/transcript_full.jsonl`, Goose `~/.local/share/goose/sessions/sessions.db`) y muestra la insignia de CLI correspondiente en el encabezado
+  </Tab>
+</Tabs>
+
+---
+
+## Actualización automática
+
+El dashboard tiene un interruptor de actualización automática en la navegación superior. Cuando está habilitado, la página actual se actualiza periódicamente para mostrar nuevas sesiones y actividad de políticas a medida que aparecen. Es esencial para monitorear sesiones de agentes autónomos de larga duración.
+
+---
+
+## Deshabilitar páginas
+
+Si solo necesitas algunas partes del dashboard, establece `FAILPROOFAI_DISABLE_PAGES` con una lista separada por comas de nombres de páginas:
+
+```bash
+FAILPROOFAI_DISABLE_PAGES=policies failproofai
+```
+
+Valores válidos: `policies`, `projects`, `audit`.
+
+---
+
+## Configurar la ruta de proyectos
+
+De forma predeterminada, el dashboard lee desde el directorio estándar de proyectos de Claude Code. Reemplázalo para configuraciones personalizadas:
+
+```bash
+CLAUDE_PROJECTS_PATH=/custom/path/to/projects failproofai
+```
+
+---
+
+## Acceder desde un host que no sea localhost
+
+Al ejecutar el dashboard en **modo dev** (`npm run dev`) y acceder a él desde un hostname distinto de `localhost` — por ejemplo, un dominio personalizado, una IP remota o una URL tunelizada — es posible que veas una advertencia como:
+
+```text
+⚠ Blocked cross-origin request to Next.js dev resource /_next/webpack-hmr from "dashboard.example.com".
+```
+
+Esto es Next.js bloqueando el acceso cross-origin a su websocket HMR (hot module reload), que es una función exclusiva del modo dev. Para permitir tu host, usa el flag `--allowed-origins`:
+
+```bash
+npm run dev -- --allowed-origins dashboard.example.com
+```
+
+Para múltiples hosts o IPs, pasa una lista separada por comas:
+
+```bash
+npm run dev -- --allowed-origins dashboard.example.com,192.168.1.5
+```
+
+También puedes establecer la variable de entorno `FAILPROOFAI_ALLOWED_DEV_ORIGINS` en su lugar:
+
+```bash
+FAILPROOFAI_ALLOWED_DEV_ORIGINS=dashboard.example.com npm run dev
+```
+
+<Note>
+Esto solo aplica al modo dev. Al ejecutar `failproofai` (modo producción), no hay websocket HMR ni problema de recursos dev cross-origin.
+</Note>

package/.next/standalone/docs-old/es/examples.mdx

@@ -0,0 +1,307 @@
+---
+title: Ejemplos
+description: "Cómo configurar hooks para Claude Code y el Agents SDK"
+icon: book-open
+---
+
+Ejemplos listos para usar en escenarios comunes. Cada uno muestra cómo instalar y qué esperar.
+
+---
+
+## Configurar hooks para Claude Code
+
+Failproof AI se integra con Claude Code a través de su [sistema de hooks](https://docs.anthropic.com/en/docs/claude-code/hooks). Cuando ejecutas `failproofai policies --install`, registra comandos de hook en el `settings.json` de Claude Code que se activan en cada llamada a herramienta.
+
+<Steps>
+  <Step title="Instalar failproofai">
+    ```bash
+    npm install -g failproofai
+    ```
+  </Step>
+  <Step title="Habilitar todas las políticas integradas">
+    ```bash
+    failproofai policies --install
+    ```
+  </Step>
+  <Step title="Verificar que los hooks están registrados">
+    ```bash
+    cat ~/.claude/settings.json | grep failproofai
+    ```
+
+    Deberías ver entradas de hook para los eventos `PreToolUse`, `PostToolUse`, `Notification` y `Stop`.
+  </Step>
+  <Step title="Ejecutar Claude Code">
+    ```bash
+    claude
+    ```
+
+    Las políticas ahora se ejecutan automáticamente en cada llamada a herramienta. Intenta pedirle a Claude que ejecute `sudo rm -rf /` — será bloqueado.
+  </Step>
+</Steps>
+
+---
+
+## Configurar hooks para el Agents SDK
+
+Si estás desarrollando con el [Agents SDK](https://docs.anthropic.com/en/docs/agents-sdk), puedes usar el mismo sistema de hooks de forma programática.
+
+<Steps>
+  <Step title="Instalar failproofai en tu proyecto">
+    ```bash
+    npm install failproofai
+    ```
+  </Step>
+  <Step title="Configurar hooks en tu agente">
+    Pasa comandos de hook al crear el proceso de tu agente. Los hooks se activan de la misma manera que en Claude Code — mediante JSON por stdin/stdout:
+
+    ```bash
+    failproofai --hook PreToolUse   # se llama antes de cada herramienta
+    failproofai --hook PostToolUse  # se llama después de cada herramienta
+    ```
+  </Step>
+  <Step title="Escribir una política personalizada para tu agente">
+    ```javascript
+    import { customPolicies, allow, deny } from "failproofai";
+
+    customPolicies.add({
+      name: "limit-to-project-dir",
+      description: "Keep the agent inside the project directory",
+      match: { events: ["PreToolUse"] },
+      fn: async (ctx) => {
+        const path = String(ctx.toolInput?.file_path ?? "");
+        if (path.startsWith("/") && !path.startsWith(ctx.session?.cwd ?? "")) {
+          return deny("Agent is restricted to the project directory");
+        }
+        return allow();
+      },
+    });
+    ```
+  </Step>
+  <Step title="Instalar la política personalizada">
+    ```bash
+    failproofai policies --install --custom ./my-agent-policies.js
+    ```
+  </Step>
+</Steps>
+
+---
+
+## Bloquear comandos destructivos
+
+La configuración más habitual: evitar que los agentes causen daños irreversibles.
+
+```bash
+failproofai policies --install block-sudo block-rm-rf block-force-push block-curl-pipe-sh
+```
+
+Qué hace esto:
+- `block-sudo` — bloquea todos los comandos `sudo`
+- `block-rm-rf` — bloquea la eliminación recursiva de archivos
+- `block-force-push` — bloquea `git push --force`
+- `block-curl-pipe-sh` — bloquea la ejecución de scripts remotos canalizados al shell
+
+---
+
+## Prevenir la filtración de secretos
+
+Impide que los agentes vean o filtren credenciales en la salida de las herramientas.
+
+```bash
+failproofai policies --install sanitize-api-keys sanitize-jwt sanitize-connection-strings sanitize-bearer-tokens
+```
+
+Estos se activan en `PostToolUse` — después de que se ejecuta una herramienta, limpian la salida antes de que el agente la vea.
+
+---
+
+## Recibir alertas en Slack cuando los agentes necesitan atención
+
+Usa el hook de notificación para reenviar alertas de inactividad a Slack.
+
+```javascript
+import { customPolicies, allow, instruct } from "failproofai";
+
+customPolicies.add({
+  name: "slack-on-idle",
+  description: "Alert Slack when the agent is waiting for input",
+  match: { events: ["Notification"] },
+  fn: async (ctx) => {
+    const webhookUrl = process.env.SLACK_WEBHOOK_URL;
+    if (!webhookUrl) return allow();
+
+    const message = String(ctx.payload?.message ?? "Agent is waiting");
+    const project = ctx.session?.cwd ?? "unknown";
+
+    try {
+      await fetch(webhookUrl, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          text: `*${message}*\nProject: \`${project}\``,
+        }),
+        signal: AbortSignal.timeout(5000),
+      });
+    } catch {
+      // nunca bloquear al agente si Slack no está disponible
+    }
+
+    return allow();
+  },
+});
+```
+
+Instálalo:
+
+```bash
+SLACK_WEBHOOK_URL=https://hooks.slack.com/... failproofai policies --install --custom ./slack-alerts.js
+```
+
+---
+
+## Mantener a los agentes en una rama
+
+Evita que los agentes cambien de rama o hagan push a ramas protegidas.
+
+```javascript
+import { customPolicies, allow, deny } from "failproofai";
+
+customPolicies.add({
+  name: "stay-on-branch",
+  description: "Prevent the agent from checking out other branches",
+  match: { events: ["PreToolUse"] },
+  fn: async (ctx) => {
+    if (ctx.toolName !== "Bash") return allow();
+    const cmd = String(ctx.toolInput?.command ?? "");
+    if (/git\s+checkout\s+(?!-b)/.test(cmd)) {
+      return deny("Stay on the current branch. Create a new branch with -b if needed.");
+    }
+    return allow();
+  },
+});
+```
+
+---
+
+## Exigir pruebas antes de hacer commit
+
+Recuerda a los agentes que ejecuten las pruebas antes de hacer commit.
+
+```javascript
+import { customPolicies, allow, instruct } from "failproofai";
+
+customPolicies.add({
+  name: "test-before-commit",
+  description: "Remind the agent to run tests before committing",
+  match: { events: ["PreToolUse"] },
+  fn: async (ctx) => {
+    if (ctx.toolName !== "Bash") return allow();
+    const cmd = String(ctx.toolInput?.command ?? "");
+    if (/git\s+commit/.test(cmd)) {
+      return instruct("Run tests before committing. Use `npm test` or `bun test` first.");
+    }
+    return allow();
+  },
+});
+```
+
+---
+
+## Proteger un repositorio de producción
+
+Guarda una configuración a nivel de proyecto para que todos los desarrolladores de tu equipo apliquen las mismas políticas.
+
+Crea `.failproofai/policies-config.json` en tu repositorio:
+
+```json
+{
+  "enabledPolicies": [
+    "block-sudo",
+    "block-rm-rf",
+    "block-force-push",
+    "block-push-master",
+    "block-env-files",
+    "sanitize-api-keys",
+    "sanitize-jwt"
+  ],
+  "policyParams": {
+    "block-push-master": {
+      "protectedBranches": ["main", "release", "production"]
+    }
+  }
+}
+```
+
+Luego haz commit:
+
+```bash
+git add .failproofai/policies-config.json
+git commit -m "Add failproofai team policies"
+```
+
+Todos los miembros del equipo que tengan failproofai instalado aplicarán estas reglas automáticamente.
+
+---
+
+## Construir un estándar de calidad para toda la organización con políticas de convención
+
+La configuración más efectiva: guarda `.failproofai/policies/` en tu repositorio con políticas adaptadas a tu proyecto. Todos los miembros del equipo las obtienen automáticamente — sin comandos de instalación, sin cambios de configuración.
+
+<Steps>
+  <Step title="Crear el directorio y añadir políticas">
+    ```bash
+    mkdir -p .failproofai/policies
+    ```
+
+    ```js
+    // .failproofai/policies/team-policies.mjs
+    import { customPolicies, allow, deny, instruct } from "failproofai";
+
+    // Imponer el gestor de paquetes preferido del equipo
+    // (o habilitar la política integrada prefer-package-manager en su lugar)
+    customPolicies.add({
+      name: "enforce-bun",
+      match: { events: ["PreToolUse"] },
+      fn: async (ctx) => {
+        if (ctx.toolName !== "Bash") return allow();
+        const cmd = String(ctx.toolInput?.command ?? "");
+        if (/\bnpm\b/.test(cmd)) return deny("Use bun instead of npm.");
+        return allow();
+      },
+    });
+
+    // Recordar al agente que ejecute las pruebas antes de hacer commit
+    customPolicies.add({
+      name: "test-before-commit",
+      match: { events: ["PreToolUse"] },
+      fn: async (ctx) => {
+        if (ctx.toolName !== "Bash") return allow();
+        if (/git\s+commit/.test(ctx.toolInput?.command ?? "")) {
+          return instruct("Run tests before committing.");
+        }
+        return allow();
+      },
+    });
+    ```
+  </Step>
+  <Step title="Hacer commit a git">
+    ```bash
+    git add .failproofai/policies/
+    git commit -m "Add team quality policies"
+    ```
+  </Step>
+  <Step title="Seguir mejorando">
+    A medida que tu equipo encuentre nuevos tipos de fallos, añade políticas y publícalas. Todos reciben la actualización en su próximo `git pull`. Estas políticas se convierten en un estándar de calidad vivo que crece con tu equipo.
+  </Step>
+</Steps>
+
+---
+
+## Más ejemplos
+
+El directorio [`examples/`](https://github.com/failproofai/failproofai/tree/main/examples) del repositorio contiene:
+
+| Archivo | Qué muestra |
+|---------|-------------|
+| `policies-basic.js` | Políticas iniciales: bloquear escrituras en producción, force-push y scripts canalizados |
+| `policies-notification.js` | Alertas de Slack para notificaciones de inactividad y fin de sesión |
+| `policies-advanced/index.js` | Importaciones transitivas, hooks asíncronos, limpieza de salida en PostToolUse y manejo del evento Stop |

package/.next/standalone/docs-old/es/for-agents.mdx

@@ -0,0 +1,38 @@
+---
+title: "Para agentes"
+description: "Añade el conocimiento de Failproof AI a tu agente de programación con un solo comando. Compatible con Claude Code, Cursor, Windsurf y más."
+---
+
+Añade la referencia completa de Failproof AI a tu agente de programación con un solo comando. Compatible con Claude Code, Cursor, Windsurf y cualquier otro agente que soporte skills.
+
+```bash
+npx skills add https://docs.befailproof.ai
+```
+
+`npx skills` detecta qué agentes tienes instalados y añade el skill en el formato correcto para cada uno automáticamente.
+
+## Qué cubre el skill
+
+| Área | Qué incluye |
+|------|-------------|
+| Políticas | Nombres de políticas integradas, tipos de eventos, parámetros, habilitar/deshabilitar |
+| Políticas personalizadas | `customPolicies.add()`, filtros de coincidencia, API `allow`/`deny`/`instruct` |
+| Objeto de contexto | `ctx.eventType`, `ctx.toolName`, `ctx.toolInput`, `ctx.session` |
+| Configuración | Estructura de `policies-config.json`, fusión de ámbitos, `policyParams` |
+| CLI | `failproofai policies --install`, `--uninstall`, `--custom`, ámbitos |
+| Panel de control | Visor de sesiones, actividad de políticas, variables de entorno |
+| Arquitectura | Flujo del manejador de hooks, códigos de salida, contrato stdin/stdout |
+
+## ¿Está completo el skill?
+
+Mintlify genera `llms.txt` a partir de todas las páginas de la navegación. La documentación de Failproof AI cubre la API completa: cada política, opción y ejemplo está incluido. Si encuentras algo que falta, el origen está en `https://docs.befailproof.ai/llms-full.txt`.
+
+Para contexto específico, enlaza directamente a una página concreta:
+
+```bash
+# Solo la API de políticas personalizadas
+npx skills add https://docs.befailproof.ai/custom-policies
+
+# Solo las políticas integradas
+npx skills add https://docs.befailproof.ai/built-in-policies
+```