failproofai 0.0.6-beta.2 → 0.0.6-beta.4

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

@@ -1,307 +0,0 @@
----
-title: Ejemplos
-description: "Cómo configurar hooks para Claude Code y el Agents SDK"
-icon: book-open
----
-
-Ejemplos listos para usar en situaciones comunes. Cada uno muestra cómo instalarlo 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). Al ejecutar `failproofai policies --install`, registra comandos de hook en el archivo `settings.json` de Claude Code que se disparan 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. Prueba 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 los comandos de hook al crear el proceso de tu agente. Los hooks se disparan de la misma forma 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 cada uno:
-- `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 el envío por tubería de scripts remotos a la 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
-```
-
-Estas políticas se disparan en `PostToolUse` — después de que una herramienta se ejecuta, 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 commits
-
-Recuerda a los agentes que ejecuten las pruebas antes de hacer un 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();
-  },
-});
-```
-
----
-
-## Blindar un repositorio de producción
-
-Confirma 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 confírmalo:
-
-```bash
-git add .failproofai/policies-config.json
-git commit -m "Add failproofai team policies"
-```
-
-Cada miembro del equipo que tenga failproofai instalado aplicará 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 impactante: confirma `.failproofai/policies/` en tu repositorio con políticas adaptadas a tu proyecto. Todos los miembros del equipo las reciben automáticamente — sin comandos de instalación ni 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";
-
-    // Aplica el gestor de paquetes preferido de tu equipo
-    // (o activa 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();
-      },
-    });
-
-    // Recuerda al agente que ejecute las pruebas antes de hacer un 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="Confirmar en 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 fallos, añade políticas y envíalas. Todos recibirán 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/exospherehost/failproofai/tree/main/examples) del repositorio contiene:
-
-| Archivo | Qué muestra |
-|---------|-------------|
-| `policies-basic.js` | Políticas básicas: bloquear escrituras en producción, force-push y scripts por tubería |
-| `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 con PostToolUse y manejo del evento Stop |

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

@@ -1,38 +0,0 @@
----
-title: "Para agentes"
-description: "Añade el conocimiento de Failproof AI a tu agente de codificació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 codificació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 la skill en el formato correcto para cada uno de forma automática.
-
-## Qué cubre la skill
-
-| Área | Qué incluye |
-|------|-------------|
-| Políticas | Nombres de políticas integradas, tipos de eventos, parámetros, activar/desactivar |
-| 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 scopes, `policyParams` |
-| CLI | `failproofai policies --install`, `--uninstall`, `--custom`, scopes |
-| Dashboard | Visor de sesiones, actividad de políticas, variables de entorno |
-| Arquitectura | Flujo del hook handler, códigos de salida, contrato stdin/stdout |
-
-## ¿La skill está completa?
-
-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 más 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
-```

package/.next/standalone/docs/es/getting-started.mdx

@@ -1,186 +0,0 @@
----
-title: Primeros pasos
-description: "Instala failproofai, activa las políticas y deja que tus agentes funcionen de forma confiable"
-icon: rocket
----
-
-## Requisitos
-
-- **Node.js** >= 20.9.0
-- **Bun** >= 1.3.0 (opcional - solo necesario para compilar desde el código fuente)
-
----
-
-## Instalación
-
-<CodeGroup>
-
-```bash npm
-npm install -g failproofai
-```
-
-```bash bun
-bun add -g failproofai
-```
-
-</CodeGroup>
-
----
-
-## Inicio rápido
-
-<Steps>
-  <Step title="Activar las políticas">
-    Las políticas son reglas que se ejecutan antes y después de cada llamada a herramientas del agente. Detectan comandos destructivos, filtraciones de secretos y otros modos de fallo antes de que causen daños.
-
-    ```bash
-    failproofai policies --install
-    ```
-
-    Esto escribe entradas de hook en el archivo `settings.json` de Claude Code. También puedes instalar para un solo proyecto o elegir políticas específicas:
-
-    ```bash
-    failproofai policies --install --scope project
-    failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
-    ```
-  </Step>
-  <Step title="Verificar">
-    ```bash
-    failproofai policies
-    ```
-
-    Muestra todas las políticas, si están habilitadas y los parámetros configurados.
-  </Step>
-  <Step title="Abrir el panel de control">
-    ```bash
-    failproofai
-    ```
-
-    Abre un panel de control local en `http://localhost:8020` donde puedes explorar sesiones, inspeccionar llamadas a herramientas y gestionar políticas.
-  </Step>
-  <Step title="Ejecutar tu agente">
-    Inicia Claude Code como de costumbre. Si el agente intenta algo arriesgado, failproofai lo intercepta automáticamente. Déjalo correr sin supervisión y revisa lo que ocurrió en el panel de control.
-  </Step>
-</Steps>
-
----
-
-## Cómo funcionan las políticas
-
-Cada vez que un agente ejecuta una herramienta, Claude Code invoca failproofai como subproceso:
-
-```text
-Claude Code  →  failproofai --hook PreToolUse  →  reads stdin JSON
-                                                 evaluates policies
-                                                 writes decision to stdout
-```
-
-Cada política devuelve una de tres decisiones:
-
-- **allow** - el agente continúa con normalidad
-- **deny** - la acción es bloqueada y se le informa al agente el motivo
-- **instruct** - se añade contexto adicional al prompt del agente
-
-<Note>
-Las políticas se ejecutan en tu proceso local. No se envía nada a un servicio remoto.
-</Note>
-
----
-
-## Configurar políticas de equipo con políticas basadas en convenciones
-
-La forma más rápida de establecer estándares de calidad en tu equipo es la convención `.failproofai/policies/`. Coloca archivos de políticas en este directorio y se cargan automáticamente — sin flags, sin cambios de configuración, sin comandos de instalación.
-
-<Steps>
-  <Step title="Crear el directorio de políticas">
-    ```bash
-    mkdir -p .failproofai/policies
-    ```
-  </Step>
-  <Step title="Añadir archivos de políticas">
-    Copia los ejemplos de inicio o escribe los tuyos propios:
-
-    ```bash
-    cp node_modules/failproofai/examples/convention-policies/*.mjs .failproofai/policies/
-    ```
-
-    O crea uno nuevo:
-
-    ```js
-    // .failproofai/policies/team-policies.mjs
-    import { customPolicies, allow, deny, instruct } from "failproofai";
-
-    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 en git">
-    ```bash
-    git add .failproofai/policies/
-    git commit -m "Add team quality policies"
-    ```
-
-    Todos los miembros del equipo que tengan failproofai instalado adoptarán estas políticas automáticamente. No se necesita configuración por desarrollador.
-  </Step>
-</Steps>
-
-<Tip>
-Haz commit de `.failproofai/policies/` en tu repositorio para que todo el equipo comparta los mismos estándares. A medida que el equipo descubra nuevos modos de fallo, añade políticas y haz push — todos recibirán la actualización en su próximo `git pull`. Con el tiempo, estas políticas se convierten en un estándar de calidad vivo que sigue mejorando.
-</Tip>
-
----
-
-## Almacenamiento de datos
-
-Toda la configuración y los registros se mantienen en tu máquina:
-
-| Ruta | Qué almacena |
-|------|--------------|
-| `~/.failproofai/policies-config.json` | Configuración global de políticas |
-| `~/.failproofai/hook-activity.jsonl` | Historial de ejecución de hooks |
-| `~/.failproofai/hook.log` | Registro de depuración para errores de hooks personalizados |
-| `.failproofai/policies-config.json` | Configuración por proyecto (en el repositorio) |
-| `.failproofai/policies-config.local.json` | Ajustes personales (en gitignore) |
-
----
-
-## Desinstalar
-
-```bash
-failproofai policies --uninstall
-```
-
-Elimina las entradas de hook del archivo `~/.claude/settings.json`. Los archivos de configuración en `~/.failproofai/` se conservan.
-
----
-
-## Próximos pasos
-
-<CardGroup cols={2}>
-
-<Card title="Configuración" icon="gear" href="/es/configuration">
-  Ámbitos y formato de los archivos de configuración
-</Card>
-
-<Card title="Políticas integradas" icon="shield" href="/es/built-in-policies">
-  Las 26 políticas con sus parámetros
-</Card>
-
-<Card title="Políticas personalizadas" icon="code" href="/es/custom-policies">
-  Escribe tus propias políticas en JavaScript
-</Card>
-
-<Card title="Monitor de agentes" icon="chart-line" href="/es/dashboard">
-  Monitorea sesiones y revisa la actividad de las políticas
-</Card>
-
-</CardGroup>

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

@@ -1,57 +0,0 @@
----
-title: Failproof AI
-description: "Gestiona hooks y políticas que mantienen tus agentes de IA confiables y funcionando de forma autónoma"
----
-
-[![npm weekly downloads](https://img.shields.io/npm/dw/failproofai?style=flat-square&color=2ea44f)](https://www.npmjs.com/package/failproofai)
-
-Hooks y políticas que mantienen tus agentes de IA confiables y funcionando de forma autónoma — para **Claude Code** y el **Agents SDK**.
-
-Los agentes de IA fallan de maneras predecibles. Ejecutan comandos destructivos, filtran secretos, se desvían de su tarea, se quedan atascados en bucles o hacen push directamente a main. Sin supervisión, los pequeños fallos se acumulan y escalan.
-
-Failproof AI resuelve esto con **políticas** — reglas que se enganchan en cada llamada de herramienta del agente y pueden **detectar fallos**, **mitigarlos** (bloquear, instruir, sanitizar) y **alertarte** cuando algo requiere atención. Un panel de control local te permite revisar todo posteriormente.
-
-Todo se ejecuta localmente. Ningún dato sale de tu máquina.
-
-## Comenzar
-
-<CardGroup cols={2}>
-
-<Card title="26 políticas integradas" icon="shield" href="/es/built-in-policies">
-  Bloquea comandos destructivos, evita la filtración de secretos, mantén a los agentes dentro de los límites del proyecto y más — desde el primer momento.
-</Card>
-
-<Card title="Políticas personalizadas" icon="code" href="/es/custom-policies">
-  Escribe tus propias reglas en JavaScript con una API sencilla de allow / deny / instruct.
-</Card>
-
-<Card title="Monitor de agentes" icon="chart-line" href="/es/dashboard">
-  Ve lo que hicieron tus agentes mientras no estabas. Explora sesiones, inspecciona llamadas a herramientas y revisa dónde se activaron las políticas.
-</Card>
-
-<Card title="Configuración sencilla" icon="gear" href="/es/configuration">
-  Ajusta cualquier política sin código. Define listas de permisos, ramas protegidas o umbrales por proyecto o de forma global.
-</Card>
-
-</CardGroup>
-
-## Inicio rápido
-
-<CodeGroup>
-
-```bash npm
-npm install -g failproofai
-```
-
-```bash bun
-bun add -g failproofai
-```
-
-</CodeGroup>
-
-```bash
-failproofai policies --install   # habilitar políticas
-failproofai                      # abrir el panel de control
-```
-
-Consulta la guía de [Primeros pasos](/es/getting-started) para el recorrido completo.

package/.next/standalone/docs/es/package-aliases.mdx

@@ -1,82 +0,0 @@
----
-title: Alias de Paquetes
-description: "Alias registrados para prevención de typosquatting y cómo funcionan"
-icon: copy
----
-
-## Paquete oficial
-
-El paquete npm canónico es **`failproofai`**:
-
-```bash
-npm install -g failproofai
-# or
-bun add -g failproofai
-```
-
----
-
-## Por qué tenemos los alias registrados
-
-El typosquatting es un ataque común a la cadena de suministro en el que un actor malicioso registra un nombre de paquete que difiere por una sola tecla del paquete popular. Los usuarios que escriben mal el comando de instalación terminan ejecutando código controlado por el atacante con acceso completo al sistema — exactamente el tipo de amenaza que Failproof AI está diseñado para defender.
-
-Para eliminar esta superficie de ataque, **registramos de forma preventiva todas las variantes ortográficas y de formato más comunes** de `failproofai` en npm. Ninguno de estos nombres puede ser registrado por terceros. Cada uno es un proxy ligero que instala y delega al paquete real `failproofai`.
-
----
-
-## Alias registrados
-
-**Variantes de formato** - diferentes formas de escribir "failproof ai":
-
-| Paquete | Estado |
-|---------|--------|
-| `failproof` | ✅ Publicado |
-| `failproof-ai` | ⏳ Pendiente de aprobación de npm |
-| `fail-proof-ai` | ⏳ Pendiente de aprobación de npm |
-| `failproof_ai` | ⏳ Pendiente de aprobación de npm |
-| `fail_proof_ai` | ⏳ Pendiente de aprobación de npm |
-| `fail-proofai` | ⏳ Pendiente de aprobación de npm |
-
-**Errores tipográficos `failprof*`** - falta una `o` en "proof":
-
-| Paquete | Estado |
-|---------|--------|
-| `failprof` | ✅ Publicado |
-| `failprof-ai` | ✅ Publicado |
-| `failprofai` | ⏳ Pendiente de aprobación de npm |
-| `fail-prof-ai` | ⏳ Pendiente de aprobación de npm |
-| `failprof_ai` | ⏳ Pendiente de aprobación de npm |
-
-**Errores tipográficos `faliproof*`** - `a` e `i` transpuestas:
-
-| Paquete | Estado |
-|---------|--------|
-| `faliproof` | ✅ Publicado |
-| `faliproof-ai` | ✅ Publicado |
-| `faliproofai` | ⏳ Pendiente de aprobación de npm |
-
-> **¿Por qué están pendientes?** La política de prevención de spam de npm bloquea nombres que, tras eliminar la puntuación y aplicar comprobaciones de similitud, se normalizan a la misma cadena que un paquete existente. Hemos contactado con el soporte de npm para reservar estos nombres con fines de protección contra squatting. Se activarán una vez aprobados.
-
-Puedes verificar que cualquier alias publicado nos pertenece:
-
-```bash
-npm info failproof
-# Look for: "ExosphereHost Inc." in the maintainers field
-```
-
----
-
-## Cómo funcionan los alias
-
-Cada paquete alias:
-
-1. Incluye `failproofai` como dependencia, por lo que el paquete real (incluida la configuración de su hook `postinstall`) se ejecuta durante la instalación
-2. Expone un binario con su propio nombre (p. ej. `failprof-ai`) que redirige todos los argumentos al binario `failproofai`
-
-El proxy es un script de Node de dos líneas; no contiene ninguna lógica adicional, no realiza llamadas de red ni recopila datos más allá de lo que hace el propio `failproofai`.
-
----
-
-## Si encuentras un nombre que nos hemos perdido
-
-Abre un issue en [exospherehost/failproofai](https://github.com/exospherehost/failproofai/issues) y lo registraremos.