failproofai 0.0.6-beta.3 → 0.0.6-beta.4

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

@@ -1,307 +0,0 @@
-> **⚠️** 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 bei Agenten werden direkt ab Werk abgefangen. Destruktive Befehle blockieren, Secret-Leaks verhindern, Agenten innerhalb der Projektgrenzen halten, Endlosschleifen 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 abzusichern oder externe Systeme einzubinden.
-- **Einfache Konfiguration** – Jede Richtlinie lässt sich ohne Code anpassen. Erlaubnislisten, geschützte Branches und Schwellenwerte pro Projekt oder global festlegen. Drei Konfigurationsebenen werden automatisch zusammengeführt.
-- **Agent Monitor** – Sehen Sie, was Ihre Agenten gemacht haben, während Sie weg waren. 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 – wird nur für die Entwicklung / das Bauen aus dem Quellcode benötigt)
-
----
-
-## 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 liegt in `~/.failproofai/policies-config.json` (global) oder `.failproofai/policies-config.json` in Ihrem Projekt (projektspezifisch).
-
-```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 Konfigurationsbereiche** werden automatisch zusammengeführt (Projekt → Lokal → Global). Vollständige Zusammenführungsregeln: [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 Selbstdeinstallation | |
-| `sanitize-jwt` | Verhindert, dass JWT-Tokens in den Agenten-Kontext gelangen | |
-| `sanitize-api-keys` | Verhindert, dass API-Schlüssel in den Agenten-Kontext gelangen | `additionalPatterns` |
-| `sanitize-connection-strings` | Verhindert, dass Datenbank-Zugangsdaten in den Agenten-Kontext gelangen | |
-| `sanitize-private-key-content` | Entfernt PEM-Private-Key-Blöcke aus der Ausgabe | |
-| `sanitize-bearer-tokens` | Entfernt Authorization-Bearer-Tokens aus der Ausgabe | |
-| `block-env-files` | Hindert Agenten daran, .env-Dateien zu lesen | |
-| `protect-env-vars` | Verhindert, dass Agenten Umgebungsvariablen ausgeben | |
-| `block-read-outside-cwd` | Hält Agenten innerhalb der Projektgrenzen | `allowPaths` |
-| `block-secrets-write` | Verhindert Schreibzugriffe auf Private-Key- und Zertifikatsdateien | `additionalPatterns` |
-| `block-push-master` | Verhindert versehentliche Pushes auf 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 Datei-Schreibvorgänge | `thresholdKb` |
-| `warn-package-publish` | Erkennt versehentliches `npm publish` | |
-| `warn-background-process` | Erkennt unbeabsichtigte Hintergrundprozess-Starts | |
-| `warn-global-package-install` | Erkennt unbeabsichtigte globale Paket-Installationen | |
-| …und weitere | | |
-
-Vollständige Richtlinien-Details 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();
-  },
-});
-```
-
-Installation mit:
-
-```bash
-failproofai policies --install --custom ./my-policies.js
-```
-
-### Entscheidungs-Hilfsfunktionen
-
-| Funktion | Wirkung |
-|----------|---------|
-| `allow()` | Aktion erlauben |
-| `allow(message)` | Aktion erlauben und informativen Kontext an Claude senden |
-| `deny(message)` | Aktion blockieren; Nachricht wird Claude angezeigt |
-| `instruct(message)` | Kontext zum Prompt von Claude hinzufügen; blockiert nicht |
-
-### Kontext-Objekt (`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ändiger roher Event-Payload |
-| `session.cwd` | `string` | Arbeitsverzeichnis der Claude Code-Sitzung |
-| `session.sessionId` | `string` | Sitzungskennung |
-| `session.transcriptPath` | `string` | Pfad zur Sitzungsprotokoll-Datei |
-
-Benutzerdefinierte Hooks unterstützen transitive lokale Imports, async/await und Zugriff auf `process.env`. Fehler sind fail-open (werden in `~/.failproofai/hook.log` protokolliert, integrierte Richtlinien laufen weiter). Vollständige Anleitung: [docs/custom-hooks.mdx](docs/custom-hooks.mdx).
-
-### Konventionsbasierte Richtlinien
-
-Legen Sie `*policies.{js,mjs,ts}`-Dateien in `.failproofai/policies/` ab, und sie werden automatisch geladen – ohne Flags oder Konfigurationsänderungen. Committen Sie das Verzeichnis in Git, und jedes Teammitglied erhält dieselben Qualitätsstandards automatisch.
-
-```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. Präfixe wie `01-`, `02-` usw. steuern die Reihenfolge. Sobald Ihr Team neue Fehlerquellen entdeckt, fügen Sie eine Richtlinie hinzu und pushen – alle erhalten das Update beim nächsten Pull. Fertige Beispiele finden Sie unter [examples/convention-policies/](examples/convention-policies/).
-
----
-
-## Telemetrie
-
-Failproof AI erfasst anonyme Nutzungstelemetrie über PostHog, um die Funktionsnutzung zu verstehen. Es werden niemals Sitzungsinhalte, Dateinamen, Tool-Eingaben oder persönliche Informationen übermittelt.
-
-Deaktivierung:
-
-```bash
-FAILPROOFAI_TELEMETRY_DISABLED=1 failproofai
-```
-
----
-
-## Dokumentation
-
-| Leitfaden | Beschreibung |
-|-----------|--------------|
-| [Erste Schritte](docs/getting-started.mdx) | Installation und erster Einstieg |
-| [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 Bereichs-Zusammenführung |
-| [Dashboard](docs/dashboard.mdx) | Sitzungen überwachen und Richtlinienaktivität überprü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
-
-Das `.claude/settings.json` dieses Repos verwendet `bun ./bin/failproofai.mjs --hook <EventType>` anstelle des üblichen `npx -y failproofai`-Befehls. Der Grund: Das Ausführen von `npx -y failproofai` innerhalb des failproofai-Projekts selbst führt zu einem 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, 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

@@ -1,307 +0,0 @@
-> **⚠️** 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 confiables, enfocados y funcionando de manera autónoma - para **Claude Code** y el **Agents SDK**.
-
-- **30 Políticas integradas** - Detecta los fallos más comunes de los agentes desde el primer momento. Bloquea comandos destructivos, evita la fuga de secretos, mantiene a los agentes dentro de los límites del proyecto, detecta bucles y mucho 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 permisos, ramas protegidas y umbrales por proyecto o de forma global. La configuración en tres niveles se combina automáticamente.
-- **Monitor de agentes** - Descubre qué hicieron tus agentes mientras estabas ausente. 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 las entradas de hook 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 las sesiones, inspecciona los registros y gestiona las políticas.
-
-### 3. Verificar 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 almacena 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 combinan automáticamente (proyecto → local → global). Consulta [docs/configuration.mdx](docs/configuration.mdx) para conocer las reglas completas de combinación.
-
----
-
-## Políticas integradas
-
-| Política | Descripción | Configurable |
-|----------|-------------|:---:|
-| `block-sudo` | Impide que los agentes ejecuten comandos de sistema con privilegios | `allowPatterns` |
-| `block-rm-rf` | Previene la eliminación recursiva accidental de archivos | `allowPaths` |
-| `block-curl-pipe-sh` | Impide que los agentes canalicen scripts no confiables hacia la shell | |
-| `block-failproofai-commands` | Previene la autodesinstalación | |
-| `sanitize-jwt` | Evita que tokens JWT se filtren al contexto del agente | |
-| `sanitize-api-keys` | Evita que claves API se filtren al contexto del agente | `additionalPatterns` |
-| `sanitize-connection-strings` | Evita que 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 Authorization Bearer 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` | Avisa a los agentes antes de modificar commits | |
-| `warn-git-stash-drop` | Avisa a los agentes antes de eliminar stashes | |
-| `warn-all-files-staged` | Detecta `git add -A` accidentales | |
-| `warn-destructive-sql` | Detecta sentencias DROP/DELETE SQL antes de ejecutarlas | |
-| `warn-schema-alteration` | Detecta ALTER TABLE antes de ejecutarlos | |
-| `warn-large-file-write` | Detecta escrituras de archivos inesperadamente grandes | `thresholdKb` |
-| `warn-package-publish` | Detecta `npm publish` accidentales | |
-| `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 |
-| `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á invocando (`"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 (registrados 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
-
-Coloca archivos `*policies.{js,mjs,ts}` en `.failproofai/policies/` y se cargarán automáticamente — sin indicadores ni cambios de configuración adicionales. Confirma el directorio en git y todos los miembros del equipo obtendrán los mismos estándares de calidad de forma automática.
-
-```text
-# Nivel de proyecto — confirmado 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 conjuntamente. Los archivos se cargan en orden alfabético dentro de cada directorio. Usa los prefijos `01-`, `02-`, etc. para controlar el orden. A medida que tu equipo descubra nuevos modos de fallo, añade una política y envíala — todos recibirán la actualización en su próximo pull. Consulta [examples/convention-policies/](examples/convention-policies/) para ver ejemplos listos para usar.
-
----
-
-## Telemetría
-
-Failproof AI recopila telemetría de uso anónima a través de PostHog para entender el uso de las funciones. Nunca se envía el contenido de las 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 primeros pasos |
-| [Políticas integradas](docs/built-in-policies.mdx) | Las 30 políticas integradas con sus parámetros |
-| [Políticas personalizadas](docs/custom-policies.mdx) | Escribe tus propias políticas |
-| [Configuración](docs/configuration.mdx) | Formato del archivo de configuración y combinació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 autorreferencia.
-
-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).