failproofai 0.0.2 → 0.0.4-beta.0

package/.next/standalone/docs/i18n/README.de.md

@@ -0,0 +1,307 @@
+> **⚠️** This is an auto-generated translation. For the latest version, see the [English README](../../README.md). Community corrections welcome!
+
+[🇺🇸 English](../../README.md) | [🇨🇳 简体中文](README.zh.md) | [🇯🇵 日本語](README.ja.md) | [🇰🇷 한국어](README.ko.md) | [🇪🇸 Español](README.es.md) | [🇧🇷 Português](README.pt-br.md) | **🇩🇪 Deutsch** | [🇫🇷 Français](README.fr.md) | [🇷🇺 Русский](README.ru.md) | [🇮🇳 हिन्दी](README.hi.md) | [🇹🇷 Türkçe](README.tr.md) | [🇻🇳 Tiếng Việt](README.vi.md) | [🇮🇹 Italiano](README.it.md) | [🇸🇦 العربية](README.ar.md) | [🇮🇱 עברית](README.he.md)
+
+---
+
+```
+    ______      _ __                       ____   ___    ____
+   / ____/___ _(_) /___  _________  ____  / __/  /   |  /  _/
+  / /_  / __ `/ / / __ \/ ___/ __ \/ __ \/ /_   / /| |  / /
+ / __/ / /_/ / / / /_/ / /  / /_/ / /_/ / __/  / ___ |_/ /
+/_/    \__,_/_/_/ .___/_/   \____/\____/_/    /_/  |_/___/
+               /_/
+```
+
+# Failproof AI
+
+[![Docs](https://img.shields.io/badge/docs-befailproof.ai-002CA7?style=flat-square)](https://befailproof.ai)
+[![npm](https://img.shields.io/npm/v/failproofai?style=flat-square&color=CB3837)](https://www.npmjs.com/package/failproofai)
+[![License](https://img.shields.io/badge/license-MIT%20%2B%20Commons%20Clause-blue?style=flat-square)](LICENSE)
+[![CI](https://img.shields.io/github/actions/workflow/status/exospherehost/failproofai/ci.yml?branch=main&style=flat-square&label=CI)](https://github.com/exospherehost/failproofai/actions)
+[![Slack](https://img.shields.io/badge/Slack-join%20us-4A154B?style=flat-square&logo=slack)](https://join.slack.com/t/failproofai/shared_invite/zt-3v63b7k5e-O3NBHmj8X6n9gZSGDx6ggQ)
+
+**Übersetzungen**: [简体中文](docs/i18n/README.zh.md) | [日本語](docs/i18n/README.ja.md) | [한국어](docs/i18n/README.ko.md) | [Español](docs/i18n/README.es.md) | [Português](docs/i18n/README.pt-br.md) | [Deutsch](docs/i18n/README.de.md) | [Français](docs/i18n/README.fr.md) | [Русский](docs/i18n/README.ru.md) | [हिन्दी](docs/i18n/README.hi.md) | [Türkçe](docs/i18n/README.tr.md) | [Tiếng Việt](docs/i18n/README.vi.md) | [Italiano](docs/i18n/README.it.md) | [العربية](docs/i18n/README.ar.md) | [עברית](docs/i18n/README.he.md)
+
+Der einfachste Weg, Richtlinien zu verwalten, die Ihre KI-Agenten zuverlässig, fokussiert und autonom am Laufen halten – für **Claude Code** & das **Agents SDK**.
+
+- **30 integrierte Richtlinien** – Häufige Fehlerquellen von Agenten werden sofort abgefangen. Destruktive Befehle blockieren, Secret-Leaks verhindern, Agenten innerhalb von Projektgrenzen halten, Schleifen erkennen und vieles mehr.
+- **Benutzerdefinierte Richtlinien** – Schreiben Sie eigene Zuverlässigkeitsregeln in JavaScript. Nutzen Sie die `allow`/`deny`/`instruct`-API, um Konventionen durchzusetzen, Drift zu verhindern, Operationen zu steuern oder externe Systeme einzubinden.
+- **Einfache Konfiguration** – Jede Richtlinie lässt sich ohne Code anpassen. Allowlists, geschützte Branches und Schwellenwerte lassen sich pro Projekt oder global festlegen. Drei Konfigurationsebenen werden automatisch zusammengeführt.
+- **Agent Monitor** – Sehen Sie, was Ihre Agenten in Ihrer Abwesenheit getan haben. Sitzungen durchsuchen, jeden Tool-Aufruf inspizieren und genau nachvollziehen, wo Richtlinien ausgelöst wurden.
+
+Alles läuft lokal – keine Daten verlassen Ihren Rechner.
+
+---
+
+## Voraussetzungen
+
+- Node.js >= 20.9.0
+- Bun >= 1.3.0 (optional – nur für Entwicklung / Erstellen aus dem Quellcode erforderlich)
+
+---
+
+## Installation
+
+```bash
+npm install -g failproofai
+# oder
+bun add -g failproofai
+```
+
+---
+
+## Schnellstart
+
+### 1. Richtlinien global aktivieren
+
+```bash
+failproofai policies --install
+```
+
+Schreibt Hook-Einträge in `~/.claude/settings.json`. Claude Code ruft failproofai nun vor und nach jedem Tool-Aufruf auf.
+
+### 2. Dashboard starten
+
+```bash
+failproofai
+```
+
+Öffnet `http://localhost:8020` – Sitzungen durchsuchen, Logs inspizieren, Richtlinien verwalten.
+
+### 3. Aktive Richtlinien prüfen
+
+```bash
+failproofai policies
+```
+
+---
+
+## Richtlinien-Installation
+
+### Geltungsbereiche
+
+| Bereich | Befehl | Schreibort |
+|---------|--------|------------|
+| Global (Standard) | `failproofai policies --install` | `~/.claude/settings.json` |
+| Projekt | `failproofai policies --install --scope project` | `.claude/settings.json` |
+| Lokal | `failproofai policies --install --scope local` | `.claude/settings.local.json` |
+
+### Bestimmte Richtlinien installieren
+
+```bash
+failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
+```
+
+### Richtlinien entfernen
+
+```bash
+failproofai policies --uninstall
+# oder für einen bestimmten Bereich:
+failproofai policies --uninstall --scope project
+```
+
+---
+
+## Konfiguration
+
+Die Richtlinienkonfiguration befindet sich in `~/.failproofai/policies-config.json` (global) oder `.failproofai/policies-config.json` in Ihrem Projekt (projektbezogen).
+
+```json
+{
+  "enabledPolicies": [
+    "block-sudo",
+    "block-rm-rf",
+    "sanitize-api-keys",
+    "block-push-master",
+    "block-env-files",
+    "block-read-outside-cwd"
+  ],
+  "policyParams": {
+    "block-sudo": {
+      "allowPatterns": ["sudo systemctl status", "sudo journalctl"],
+      "hint": "Use apt-get directly without sudo."
+    },
+    "block-push-master": {
+      "protectedBranches": ["main", "release", "prod"],
+      "hint": "Try creating a fresh branch instead."
+    },
+    "sanitize-api-keys": {
+      "additionalPatterns": [
+        { "regex": "myco_[A-Za-z0-9]{32}", "label": "MyCo API key" }
+      ]
+    },
+    "warn-large-file-write": {
+      "thresholdKb": 512
+    }
+  }
+}
+```
+
+**Drei Konfigurationsebenen** werden automatisch zusammengeführt (Projekt → Lokal → Global). Vollständige Zusammenführungsregeln finden Sie in [docs/configuration.mdx](docs/configuration.mdx).
+
+---
+
+## Integrierte Richtlinien
+
+| Richtlinie | Beschreibung | Konfigurierbar |
+|------------|--------------|:--------------:|
+| `block-sudo` | Verhindert, dass Agenten privilegierte Systembefehle ausführen | `allowPatterns` |
+| `block-rm-rf` | Verhindert versehentliches rekursives Löschen von Dateien | `allowPaths` |
+| `block-curl-pipe-sh` | Verhindert, dass Agenten nicht vertrauenswürdige Skripte an die Shell weiterleiten | |
+| `block-failproofai-commands` | Verhindert die Selbst-Deinstallation | |
+| `sanitize-jwt` | Verhindert, dass JWT-Tokens in den Agentenkontext gelangen | |
+| `sanitize-api-keys` | Verhindert, dass API-Schlüssel in den Agentenkontext gelangen | `additionalPatterns` |
+| `sanitize-connection-strings` | Verhindert, dass Datenbank-Anmeldedaten in den Agentenkontext gelangen | |
+| `sanitize-private-key-content` | Schwärzt PEM-Private-Key-Blöcke aus der Ausgabe | |
+| `sanitize-bearer-tokens` | Schwärzt Authorization-Bearer-Tokens aus der Ausgabe | |
+| `block-env-files` | Verhindert, dass Agenten .env-Dateien lesen | |
+| `protect-env-vars` | Verhindert, dass Agenten Umgebungsvariablen ausgeben | |
+| `block-read-outside-cwd` | Hält Agenten innerhalb der Projektgrenzen | `allowPaths` |
+| `block-secrets-write` | Verhindert das Schreiben in Private-Key- und Zertifikatsdateien | `additionalPatterns` |
+| `block-push-master` | Verhindert versehentliche Pushes nach main/master | `protectedBranches` |
+| `block-work-on-main` | Hält Agenten von geschützten Branches fern | `protectedBranches` |
+| `block-force-push` | Verhindert `git push --force` | |
+| `warn-git-amend` | Erinnert Agenten vor dem Ändern von Commits | |
+| `warn-git-stash-drop` | Erinnert Agenten vor dem Verwerfen von Stashes | |
+| `warn-all-files-staged` | Erkennt versehentliches `git add -A` | |
+| `warn-destructive-sql` | Erkennt DROP/DELETE-SQL vor der Ausführung | |
+| `warn-schema-alteration` | Erkennt ALTER TABLE vor der Ausführung | |
+| `warn-large-file-write` | Erkennt unerwartet große Schreibvorgänge | `thresholdKb` |
+| `warn-package-publish` | Erkennt versehentliches `npm publish` | |
+| `warn-background-process` | Erkennt unbeabsichtigte Starts von Hintergrundprozessen | |
+| `warn-global-package-install` | Erkennt unbeabsichtigte globale Paketinstallationen | |
+| …und mehr | | |
+
+Vollständige Richtliniendetails und Parameterreferenz: [docs/built-in-policies.mdx](docs/built-in-policies.mdx)
+
+---
+
+## Benutzerdefinierte Richtlinien
+
+Schreiben Sie eigene Richtlinien, um Agenten zuverlässig und fokussiert zu halten:
+
+```js
+import { customPolicies, allow, deny, instruct } from "failproofai";
+
+customPolicies.add({
+  name: "no-production-writes",
+  description: "Block writes to paths containing 'production'",
+  match: { events: ["PreToolUse"] },
+  fn: async (ctx) => {
+    if (!["Write", "Edit"].includes(ctx.toolName ?? "")) return allow();
+    const path = ctx.toolInput?.file_path ?? "";
+    if (path.includes("production")) return deny("Writes to production paths are blocked");
+    return allow();
+  },
+});
+```
+
+Installieren mit:
+
+```bash
+failproofai policies --install --custom ./my-policies.js
+```
+
+### Entscheidungs-Hilfsfunktionen
+
+| Funktion | Wirkung |
+|----------|---------|
+| `allow()` | Erlaubt die Operation |
+| `allow(message)` | Erlaubt und sendet informativen Kontext an Claude *(beta)* |
+| `deny(message)` | Blockiert die Operation; Nachricht wird Claude angezeigt |
+| `instruct(message)` | Fügt Claude's Prompt Kontext hinzu; blockiert nicht |
+
+### Kontextobjekt (`ctx`)
+
+| Feld | Typ | Beschreibung |
+|------|-----|--------------|
+| `eventType` | `string` | `"PreToolUse"`, `"PostToolUse"`, `"Notification"`, `"Stop"` |
+| `toolName` | `string` | Aufgerufenes Tool (`"Bash"`, `"Write"`, `"Read"`, …) |
+| `toolInput` | `object` | Eingabeparameter des Tools |
+| `payload` | `object` | Vollständige rohe Event-Nutzdaten |
+| `session.cwd` | `string` | Arbeitsverzeichnis der Claude Code-Sitzung |
+| `session.sessionId` | `string` | Sitzungskennung |
+| `session.transcriptPath` | `string` | Pfad zur Sitzungs-Transkriptdatei |
+
+Benutzerdefinierte Hooks unterstützen transitive lokale Importe, async/await und Zugriff auf `process.env`. Fehler sind fail-open (werden in `~/.failproofai/hook.log` protokolliert, integrierte Richtlinien laufen weiter). Eine vollständige Anleitung finden Sie unter [docs/custom-hooks.mdx](docs/custom-hooks.mdx).
+
+### Konventionsbasierte Richtlinien (v0.0.2-beta.7+)
+
+Legen Sie `*policies.{js,mjs,ts}`-Dateien in `.failproofai/policies/` ab – sie werden automatisch geladen, ohne `--custom`-Flag oder Konfigurationsänderungen. Funktioniert wie Git-Hooks: Datei ablegen, fertig.
+
+```text
+# Projektebene — in Git eingecheckt, mit dem Team geteilt
+.failproofai/policies/security-policies.mjs
+.failproofai/policies/workflow-policies.mjs
+
+# Benutzerebene — persönlich, gilt für alle Projekte
+~/.failproofai/policies/my-policies.mjs
+```
+
+Beide Ebenen werden geladen (Vereinigung). Dateien werden innerhalb jedes Verzeichnisses alphabetisch geladen. Verwenden Sie Präfixe wie `01-`, `02-` usw., um die Reihenfolge zu steuern. Fertige Beispiele finden Sie unter [examples/convention-policies/](examples/convention-policies/).
+
+---
+
+## Telemetrie
+
+Failproof AI erfasst anonyme Nutzungstelemetrie über PostHog, um das Feature-Nutzungsverhalten zu verstehen. Es werden niemals Sitzungsinhalte, Dateinamen, Tool-Eingaben oder personenbezogene Daten übermittelt.
+
+Deaktivieren:
+
+```bash
+FAILPROOFAI_TELEMETRY_DISABLED=1 failproofai
+```
+
+---
+
+## Dokumentation
+
+| Leitfaden | Beschreibung |
+|-----------|--------------|
+| [Erste Schritte](docs/getting-started.mdx) | Installation und erste Schritte |
+| [Integrierte Richtlinien](docs/built-in-policies.mdx) | Alle 30 integrierten Richtlinien mit Parametern |
+| [Benutzerdefinierte Richtlinien](docs/custom-policies.mdx) | Eigene Richtlinien schreiben |
+| [Konfiguration](docs/configuration.mdx) | Konfigurationsdateiformat und Bereichsmerge |
+| [Dashboard](docs/dashboard.mdx) | Sitzungen überwachen und Richtlinienaktivität prüfen |
+| [Architektur](docs/architecture.mdx) | Funktionsweise des Hook-Systems |
+| [Tests](docs/testing.mdx) | Tests ausführen und neue schreiben |
+
+### Dokumentation lokal ausführen
+
+```bash
+docker build -f Dockerfile.docs -t failproofai-docs .
+docker run --rm -p 3000:3000 failproofai-docs
+```
+
+Öffnet die Mintlify-Dokumentationsseite unter `http://localhost:3000`. Der Container erkennt Änderungen, wenn Sie das Docs-Verzeichnis einbinden:
+
+```bash
+docker run --rm -p 3000:3000 -v $(pwd)/docs:/app/docs failproofai-docs
+```
+
+---
+
+## Hinweis für failproofai-Mitwirkende
+
+Die `.claude/settings.json` dieses Repos verwendet `bun ./bin/failproofai.mjs --hook <EventType>` anstelle des Standardbefehls `npx -y failproofai`. Der Grund: Das Ausführen von `npx -y failproofai` innerhalb des failproofai-Projekts selbst erzeugt einen selbstreferenzierenden Konflikt.
+
+Für alle anderen Repos ist der empfohlene Ansatz `npx -y failproofai`, installiert über:
+
+```bash
+failproofai policies --install --scope project
+```
+
+## Mitwirken
+
+Siehe [CONTRIBUTING.md](CONTRIBUTING.md).
+
+---
+
+## Lizenz
+
+Siehe [LICENSE](LICENSE).
+
+---
+
+Entwickelt und gepflegt von **ExosphereHost: Reliability Research Lab for Your Agents**. Wir helfen Unternehmen und Startups dabei, die Zuverlässigkeit ihrer KI-Agenten durch eigene Agenten, Software und Expertise zu verbessern. Mehr erfahren unter [exosphere.host](https://exosphere.host).

package/.next/standalone/docs/i18n/README.es.md

@@ -0,0 +1,307 @@
+> **⚠️** This is an auto-generated translation. For the latest version, see the [English README](../../README.md). Community corrections welcome!
+
+[🇺🇸 English](../../README.md) | [🇨🇳 简体中文](README.zh.md) | [🇯🇵 日本語](README.ja.md) | [🇰🇷 한국어](README.ko.md) | **🇪🇸 Español** | [🇧🇷 Português](README.pt-br.md) | [🇩🇪 Deutsch](README.de.md) | [🇫🇷 Français](README.fr.md) | [🇷🇺 Русский](README.ru.md) | [🇮🇳 हिन्दी](README.hi.md) | [🇹🇷 Türkçe](README.tr.md) | [🇻🇳 Tiếng Việt](README.vi.md) | [🇮🇹 Italiano](README.it.md) | [🇸🇦 العربية](README.ar.md) | [🇮🇱 עברית](README.he.md)
+
+---
+
+```
+    ______      _ __                       ____   ___    ____
+   / ____/___ _(_) /___  _________  ____  / __/  /   |  /  _/
+  / /_  / __ `/ / / __ \/ ___/ __ \/ __ \/ /_   / /| |  / /
+ / __/ / /_/ / / / /_/ / /  / /_/ / /_/ / __/  / ___ |_/ /
+/_/    \__,_/_/_/ .___/_/   \____/\____/_/    /_/  |_/___/
+               /_/
+```
+
+# Failproof AI
+
+[![Docs](https://img.shields.io/badge/docs-befailproof.ai-002CA7?style=flat-square)](https://befailproof.ai)
+[![npm](https://img.shields.io/npm/v/failproofai?style=flat-square&color=CB3837)](https://www.npmjs.com/package/failproofai)
+[![License](https://img.shields.io/badge/license-MIT%20%2B%20Commons%20Clause-blue?style=flat-square)](LICENSE)
+[![CI](https://img.shields.io/github/actions/workflow/status/exospherehost/failproofai/ci.yml?branch=main&style=flat-square&label=CI)](https://github.com/exospherehost/failproofai/actions)
+[![Slack](https://img.shields.io/badge/Slack-join%20us-4A154B?style=flat-square&logo=slack)](https://join.slack.com/t/failproofai/shared_invite/zt-3v63b7k5e-O3NBHmj8X6n9gZSGDx6ggQ)
+
+**Traducciones**: [简体中文](docs/i18n/README.zh.md) | [日本語](docs/i18n/README.ja.md) | [한국어](docs/i18n/README.ko.md) | [Español](docs/i18n/README.es.md) | [Português](docs/i18n/README.pt-br.md) | [Deutsch](docs/i18n/README.de.md) | [Français](docs/i18n/README.fr.md) | [Русский](docs/i18n/README.ru.md) | [हिन्दी](docs/i18n/README.hi.md) | [Türkçe](docs/i18n/README.tr.md) | [Tiếng Việt](docs/i18n/README.vi.md) | [Italiano](docs/i18n/README.it.md) | [العربية](docs/i18n/README.ar.md) | [עברית](docs/i18n/README.he.md)
+
+La forma más sencilla de gestionar políticas que mantienen a tus agentes de IA fiables, enfocados y funcionando de forma autónoma — para **Claude Code** y el **Agents SDK**.
+
+- **30 políticas integradas** — Detecta los modos de fallo más comunes de los agentes desde el primer momento. Bloquea comandos destructivos, evita la filtración de secretos, mantiene a los agentes dentro de los límites del proyecto, detecta bucles y más.
+- **Políticas personalizadas** — Escribe tus propias reglas de fiabilidad en JavaScript. Usa la API `allow`/`deny`/`instruct` para aplicar convenciones, prevenir desvíos, controlar operaciones o integrarte con sistemas externos.
+- **Configuración sencilla** — Ajusta cualquier política sin escribir código. Define listas de permitidos, ramas protegidas y umbrales por proyecto o de forma global. La configuración de tres niveles se fusiona automáticamente.
+- **Monitor de agentes** — Consulta qué hicieron tus agentes mientras no estabas. Navega por las sesiones, inspecciona cada llamada a herramientas y revisa exactamente dónde se activaron las políticas.
+
+Todo se ejecuta localmente — ningún dato sale de tu máquina.
+
+---
+
+## Requisitos
+
+- Node.js >= 20.9.0
+- Bun >= 1.3.0 (opcional — solo necesario para desarrollo o compilación desde el código fuente)
+
+---
+
+## Instalación
+
+```bash
+npm install -g failproofai
+# o
+bun add -g failproofai
+```
+
+---
+
+## Inicio rápido
+
+### 1. Habilitar políticas globalmente
+
+```bash
+failproofai policies --install
+```
+
+Escribe entradas de hooks en `~/.claude/settings.json`. A partir de ahora, Claude Code invocará failproofai antes y después de cada llamada a herramientas.
+
+### 2. Iniciar el panel de control
+
+```bash
+failproofai
+```
+
+Abre `http://localhost:8020` — navega por sesiones, inspecciona registros y gestiona políticas.
+
+### 3. Comprobar qué está activo
+
+```bash
+failproofai policies
+```
+
+---
+
+## Instalación de políticas
+
+### Niveles
+
+| Nivel | Comando | Dónde escribe |
+|-------|---------|----------------|
+| Global (por defecto) | `failproofai policies --install` | `~/.claude/settings.json` |
+| Proyecto | `failproofai policies --install --scope project` | `.claude/settings.json` |
+| Local | `failproofai policies --install --scope local` | `.claude/settings.local.json` |
+
+### Instalar políticas específicas
+
+```bash
+failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
+```
+
+### Eliminar políticas
+
+```bash
+failproofai policies --uninstall
+# o para un nivel específico:
+failproofai policies --uninstall --scope project
+```
+
+---
+
+## Configuración
+
+La configuración de políticas se encuentra en `~/.failproofai/policies-config.json` (global) o en `.failproofai/policies-config.json` dentro de tu proyecto (por proyecto).
+
+```json
+{
+  "enabledPolicies": [
+    "block-sudo",
+    "block-rm-rf",
+    "sanitize-api-keys",
+    "block-push-master",
+    "block-env-files",
+    "block-read-outside-cwd"
+  ],
+  "policyParams": {
+    "block-sudo": {
+      "allowPatterns": ["sudo systemctl status", "sudo journalctl"],
+      "hint": "Use apt-get directly without sudo."
+    },
+    "block-push-master": {
+      "protectedBranches": ["main", "release", "prod"],
+      "hint": "Try creating a fresh branch instead."
+    },
+    "sanitize-api-keys": {
+      "additionalPatterns": [
+        { "regex": "myco_[A-Za-z0-9]{32}", "label": "MyCo API key" }
+      ]
+    },
+    "warn-large-file-write": {
+      "thresholdKb": 512
+    }
+  }
+}
+```
+
+**Los tres niveles de configuración** se fusionan automáticamente (proyecto → local → global). Consulta [docs/configuration.mdx](docs/configuration.mdx) para conocer las reglas completas de fusión.
+
+---
+
+## Políticas integradas
+
+| Política | Descripción | Configurable |
+|----------|-------------|:---:|
+| `block-sudo` | Evita que los agentes ejecuten comandos del sistema con privilegios | `allowPatterns` |
+| `block-rm-rf` | Previene la eliminación accidental recursiva de archivos | `allowPaths` |
+| `block-curl-pipe-sh` | Evita que los agentes envíen scripts no confiables al shell por tubería | |
+| `block-failproofai-commands` | Previene la autodesinstalación | |
+| `sanitize-jwt` | Evita que los tokens JWT se filtren al contexto del agente | |
+| `sanitize-api-keys` | Evita que las claves de API se filtren al contexto del agente | `additionalPatterns` |
+| `sanitize-connection-strings` | Evita que las credenciales de base de datos se filtren al contexto del agente | |
+| `sanitize-private-key-content` | Redacta bloques de clave privada PEM de la salida | |
+| `sanitize-bearer-tokens` | Redacta tokens Bearer de Authorization de la salida | |
+| `block-env-files` | Impide que los agentes lean archivos .env | |
+| `protect-env-vars` | Evita que los agentes impriman variables de entorno | |
+| `block-read-outside-cwd` | Mantiene a los agentes dentro de los límites del proyecto | `allowPaths` |
+| `block-secrets-write` | Previene escrituras en archivos de clave privada y certificados | `additionalPatterns` |
+| `block-push-master` | Previene envíos accidentales a main/master | `protectedBranches` |
+| `block-work-on-main` | Mantiene a los agentes fuera de las ramas protegidas | `protectedBranches` |
+| `block-force-push` | Previene `git push --force` | |
+| `warn-git-amend` | Recuerda a los agentes antes de modificar commits | |
+| `warn-git-stash-drop` | Recuerda a los agentes antes de eliminar stashes | |
+| `warn-all-files-staged` | Detecta un `git add -A` accidental | |
+| `warn-destructive-sql` | Detecta sentencias DROP/DELETE SQL antes de ejecutarlas | |
+| `warn-schema-alteration` | Detecta ALTER TABLE antes de ejecutarlo | |
+| `warn-large-file-write` | Detecta escrituras de archivos inesperadamente grandes | `thresholdKb` |
+| `warn-package-publish` | Detecta un `npm publish` accidental | |
+| `warn-background-process` | Detecta lanzamientos no intencionados de procesos en segundo plano | |
+| `warn-global-package-install` | Detecta instalaciones globales de paquetes no intencionadas | |
+| …y más | | |
+
+Detalles completos de políticas y referencia de parámetros: [docs/built-in-policies.mdx](docs/built-in-policies.mdx)
+
+---
+
+## Políticas personalizadas
+
+Escribe tus propias políticas para mantener a los agentes fiables y enfocados:
+
+```js
+import { customPolicies, allow, deny, instruct } from "failproofai";
+
+customPolicies.add({
+  name: "no-production-writes",
+  description: "Block writes to paths containing 'production'",
+  match: { events: ["PreToolUse"] },
+  fn: async (ctx) => {
+    if (!["Write", "Edit"].includes(ctx.toolName ?? "")) return allow();
+    const path = ctx.toolInput?.file_path ?? "";
+    if (path.includes("production")) return deny("Writes to production paths are blocked");
+    return allow();
+  },
+});
+```
+
+Instala con:
+
+```bash
+failproofai policies --install --custom ./my-policies.js
+```
+
+### Funciones de decisión
+
+| Función | Efecto |
+|---------|--------|
+| `allow()` | Permite la operación |
+| `allow(message)` | Permite y envía contexto informativo a Claude *(beta)* |
+| `deny(message)` | Bloquea la operación; el mensaje se muestra a Claude |
+| `instruct(message)` | Añade contexto al prompt de Claude; no bloquea |
+
+### Objeto de contexto (`ctx`)
+
+| Campo | Tipo | Descripción |
+|-------|------|-------------|
+| `eventType` | `string` | `"PreToolUse"`, `"PostToolUse"`, `"Notification"`, `"Stop"` |
+| `toolName` | `string` | Herramienta que se está llamando (`"Bash"`, `"Write"`, `"Read"`, …) |
+| `toolInput` | `object` | Parámetros de entrada de la herramienta |
+| `payload` | `object` | Payload completo del evento en bruto |
+| `session.cwd` | `string` | Directorio de trabajo de la sesión de Claude Code |
+| `session.sessionId` | `string` | Identificador de sesión |
+| `session.transcriptPath` | `string` | Ruta al archivo de transcripción de la sesión |
+
+Los hooks personalizados admiten importaciones locales transitivas, async/await y acceso a `process.env`. Los errores son fail-open (se registran en `~/.failproofai/hook.log`, las políticas integradas continúan). Consulta [docs/custom-hooks.mdx](docs/custom-hooks.mdx) para la guía completa.
+
+### Políticas basadas en convenciones (v0.0.2-beta.7+)
+
+Coloca archivos `*policies.{js,mjs,ts}` en `.failproofai/policies/` y se cargarán automáticamente — sin necesidad de usar la opción `--custom` ni modificar la configuración. Funciona como los git hooks: añade un archivo y listo.
+
+```text
+# Nivel de proyecto — guardado en git, compartido con el equipo
+.failproofai/policies/security-policies.mjs
+.failproofai/policies/workflow-policies.mjs
+
+# Nivel de usuario — personal, se aplica a todos los proyectos
+~/.failproofai/policies/my-policies.mjs
+```
+
+Ambos niveles se cargan (unión). Los archivos se cargan en orden alfabético dentro de cada directorio. Usa el prefijo `01-`, `02-`, etc. para controlar el orden. Consulta [examples/convention-policies/](examples/convention-policies/) para ver ejemplos listos para usar.
+
+---
+
+## Telemetría
+
+Failproof AI recopila telemetría de uso anónima mediante PostHog para entender cómo se usan las funcionalidades. Nunca se envía el contenido de sesiones, nombres de archivos, entradas de herramientas ni información personal.
+
+Para desactivarla:
+
+```bash
+FAILPROOFAI_TELEMETRY_DISABLED=1 failproofai
+```
+
+---
+
+## Documentación
+
+| Guía | Descripción |
+|------|-------------|
+| [Primeros pasos](docs/getting-started.mdx) | Instalación y pasos iniciales |
+| [Políticas integradas](docs/built-in-policies.mdx) | Las 30 políticas integradas con sus parámetros |
+| [Políticas personalizadas](docs/custom-policies.mdx) | Cómo escribir tus propias políticas |
+| [Configuración](docs/configuration.mdx) | Formato del archivo de configuración y fusión de niveles |
+| [Panel de control](docs/dashboard.mdx) | Monitoriza sesiones y revisa la actividad de las políticas |
+| [Arquitectura](docs/architecture.mdx) | Cómo funciona el sistema de hooks |
+| [Pruebas](docs/testing.mdx) | Ejecutar pruebas y escribir nuevas |
+
+### Ejecutar la documentación localmente
+
+```bash
+docker build -f Dockerfile.docs -t failproofai-docs .
+docker run --rm -p 3000:3000 failproofai-docs
+```
+
+Abre el sitio de documentación Mintlify en `http://localhost:3000`. El contenedor detecta cambios si montas el directorio de documentación:
+
+```bash
+docker run --rm -p 3000:3000 -v $(pwd)/docs:/app/docs failproofai-docs
+```
+
+---
+
+## Nota para colaboradores de failproofai
+
+El archivo `.claude/settings.json` de este repositorio utiliza `bun ./bin/failproofai.mjs --hook <EventType>` en lugar del comando estándar `npx -y failproofai`. Esto se debe a que ejecutar `npx -y failproofai` dentro del propio proyecto failproofai genera un conflicto de autoreferencia.
+
+Para todos los demás repositorios, el enfoque recomendado es `npx -y failproofai`, instalado mediante:
+
+```bash
+failproofai policies --install --scope project
+```
+
+## Contribuir
+
+Consulta [CONTRIBUTING.md](CONTRIBUTING.md).
+
+---
+
+## Licencia
+
+Consulta [LICENSE](LICENSE).
+
+---
+
+Desarrollado y mantenido por **ExosphereHost: Reliability Research Lab for Your Agents**. Ayudamos a empresas y startups a mejorar la fiabilidad de sus agentes de IA a través de nuestros propios agentes, software y experiencia. Más información en [exosphere.host](https://exosphere.host).