failproofai 0.0.6-beta.1 → 0.0.6-beta.2

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

@@ -23,21 +23,21 @@
 
 **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 tus agentes de IA fiables, centrados en su tarea y funcionando de forma autónoma - para **Claude Code** y el **Agents SDK**.
+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 modos de fallo más comunes de los agentes desde el primer momento. Bloquea comandos destructivos, previene la filtración 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 la deriva, 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 de tres ámbitos se fusiona automáticamente.
-- **Monitor de agentes** - Observa 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.
+- **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.
+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 / compilación desde el código fuente)
+- Bun >= 1.3.0 (opcional — solo necesario para desarrollo o compilación desde el código fuente)
 
 ---
 
@@ -59,15 +59,15 @@ bun add -g failproofai
 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.
+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. Lanzar el panel de control
+### 2. Iniciar el panel de control
 
 ```bash
 failproofai
 ```
 
-Abre `http://localhost:8020` - navega por sesiones, inspecciona registros y gestiona políticas.
+Abre `http://localhost:8020` — navega por las sesiones, inspecciona los registros y gestiona las políticas.
 
 ### 3. Verificar qué está activo
 
@@ -79,10 +79,10 @@ failproofai policies
 
 ## Instalación de políticas
 
-### Ámbitos
+### Niveles
 
-| Ámbito | Comando | Dónde escribe |
-|--------|---------|---------------|
+| 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` |
@@ -97,7 +97,7 @@ failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
 
 ```bash
 failproofai policies --uninstall
-# o para un ámbito específico:
+# o para un nivel específico:
 failproofai policies --uninstall --scope project
 ```
 
@@ -105,7 +105,7 @@ failproofai policies --uninstall --scope project
 
 ## Configuración
 
-La configuración de políticas reside en `~/.failproofai/policies-config.json` (global) o en `.failproofai/policies-config.json` dentro de tu proyecto (por proyecto).
+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
 {
@@ -138,7 +138,7 @@ La configuración de políticas reside en `~/.failproofai/policies-config.json`
 }
 ```
 
-**Los tres ámbitos de configuración** se fusionan automáticamente (proyecto → local → global). Consulta [docs/configuration.mdx](docs/configuration.mdx) para conocer las reglas de fusión completas.
+**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.
 
 ---
 
@@ -146,29 +146,29 @@ La configuración de políticas reside en `~/.failproofai/policies-config.json`
 
 | Política | Descripción | Configurable |
 |----------|-------------|:---:|
-| `block-sudo` | Evita que los agentes ejecuten comandos del sistema con privilegios elevados | `allowPatterns` |
+| `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` | Evita que los agentes pasen scripts no confiables a la shell mediante tuberías | |
+| `block-curl-pipe-sh` | Impide que los agentes canalicen scripts no confiables hacia la shell | |
 | `block-failproofai-commands` | Previene la autodesinstalación | |
-| `sanitize-jwt` | Impide que los tokens JWT se filtren al contexto del agente | |
-| `sanitize-api-keys` | Impide que las claves API se filtren al contexto del agente | `additionalPatterns` |
-| `sanitize-connection-strings` | Impide que las credenciales de base de datos se filtren al contexto del agente | |
+| `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 Bearer de Authorization de la salida | |
-| `block-env-files` | Evita que los agentes lean archivos .env | |
+| `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` | 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 DROP/DELETE en SQL antes de la ejecución | |
-| `warn-schema-alteration` | Detecta ALTER TABLE antes de la ejecución | |
+| `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 un `npm publish` accidental | |
+| `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 | | |
@@ -179,7 +179,7 @@ Detalles completos de políticas y referencia de parámetros: [docs/built-in-pol
 
 ## Políticas personalizadas
 
-Escribe tus propias políticas para mantener a los agentes fiables y centrados en su tarea:
+Escribe tus propias políticas para mantener a los agentes fiables y enfocados:
 
 ```js
 import { customPolicies, allow, deny, instruct } from "failproofai";
@@ -217,35 +217,35 @@ failproofai policies --install --custom ./my-policies.js
 | Campo | Tipo | Descripción |
 |-------|------|-------------|
 | `eventType` | `string` | `"PreToolUse"`, `"PostToolUse"`, `"Notification"`, `"Stop"` |
-| `toolName` | `string` | Herramienta siendo llamada (`"Bash"`, `"Write"`, `"Read"`, …) |
+| `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 (se registran en `~/.failproofai/hook.log` y las políticas integradas continúan). Consulta [docs/custom-hooks.mdx](docs/custom-hooks.mdx) para la guía completa.
+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 necesidad de la opción `--custom` ni cambios en la configuración. Funciona como los git hooks: coloca un archivo y listo.
+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
-# A nivel de proyecto — incluido en git, compartido con el equipo
+# Nivel de proyecto — confirmado en git, compartido con el equipo
 .failproofai/policies/security-policies.mjs
 .failproofai/policies/workflow-policies.mjs
 
-# A nivel de usuario — personal, se aplica a todos los proyectos
+# 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 alfabéticamente dentro de cada directorio. Usa prefijos como `01-`, `02-`, etc. para controlar el orden. Consulta [examples/convention-policies/](examples/convention-policies/) para ver ejemplos listos para usar.
+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 comprender el uso de las funciones. Nunca se envía el contenido de las sesiones, nombres de archivos, entradas de herramientas ni información personal.
+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:
 
@@ -261,9 +261,9 @@ FAILPROOFAI_TELEMETRY_DISABLED=1 failproofai
 |------|-------------|
 | [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) | Cómo escribir tus propias políticas |
-| [Configuración](docs/configuration.mdx) | Formato del archivo de configuración y fusión de ámbitos |
-| [Panel de control](docs/dashboard.mdx) | Monitorea sesiones y revisa la actividad de las políticas |
+| [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 |
 
@@ -282,9 +282,9 @@ docker run --rm -p 3000:3000 -v $(pwd)/docs:/app/docs failproofai-docs
 
 ---
 
-## Nota para los colaboradores de failproofai
+## Nota para colaboradores de failproofai
 
-El archivo `.claude/settings.json` de este repositorio usa `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 auto-referencia.
+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:
 

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

@@ -23,14 +23,14 @@
 
 **Traductions** : [简体中文](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 solution la plus simple pour gérer les politiques qui maintiennent vos agents IA fiables, concentrés sur leurs tâches et capables de fonctionner de manière autonome — pour **Claude Code** et l'**Agents SDK**.
+Le moyen le plus simple de gérer des politiques qui maintiennent vos agents IA fiables, concentrés sur leurs tâches et opérationnels en autonomie — pour **Claude Code** et le **Agents SDK**.
 
-- **30 politiques intégrées** — Détectez les modes de défaillance courants des agents dès l'installation. Bloquez les commandes destructrices, empêchez les fuites de secrets, maintenez les agents dans les limites du projet, détectez les boucles, et bien plus encore.
-- **Politiques personnalisées** — Écrivez vos propres règles de fiabilité en JavaScript. Utilisez l'API `allow`/`deny`/`instruct` pour imposer des conventions, prévenir la dérive, contrôler les opérations ou vous intégrer à des systèmes externes.
-- **Configuration simplifiée** — Ajustez n'importe quelle politique sans écrire de code. Définissez des listes d'autorisation, des branches protégées et des seuils par projet ou globalement. Les trois niveaux de configuration se fusionnent automatiquement.
-- **Moniteur d'agents** — Voyez ce que vos agents ont fait pendant votre absence. Parcourez les sessions, inspectez chaque appel d'outil et examinez précisément là où les politiques ont été déclenchées.
+- **30 politiques intégrées** — Détectez les modes de défaillance courants des agents dès l'installation. Bloquez les commandes destructrices, prévenez les fuites de secrets, maintenez les agents dans les limites du projet, détectez les boucles, et bien plus encore.
+- **Politiques personnalisées** — Rédigez vos propres règles de fiabilité en JavaScript. Utilisez l'API `allow`/`deny`/`instruct` pour appliquer des conventions, éviter la dérive, contrôler les opérations ou vous intégrer à des systèmes externes.
+- **Configuration simple** — Ajustez n'importe quelle politique sans écrire de code. Définissez des listes d'autorisation, des branches protégées et des seuils par projet ou globalement. La fusion de trois niveaux de configuration s'effectue automatiquement.
+- **Moniteur d'agents** — Visualisez ce que vos agents ont fait en votre absence. Parcourez les sessions, inspectez chaque appel d'outil et examinez précisément où les politiques ont été déclenchées.
 
-Tout s'exécute en local — aucune donnée ne quitte votre machine.
+Tout s'exécute localement — aucune donnée ne quitte votre machine.
 
 ---
 
@@ -59,7 +59,7 @@ bun add -g failproofai
 failproofai policies --install
 ```
 
-Inscrit les entrées de hook dans `~/.claude/settings.json`. Claude Code invoquera désormais failproofai avant et après chaque appel d'outil.
+Écrit les entrées de hook dans `~/.claude/settings.json`. Claude Code invoquera désormais failproofai avant et après chaque appel d'outil.
 
 ### 2. Lancer le tableau de bord
 
@@ -79,11 +79,11 @@ failproofai policies
 
 ## Installation des politiques
 
-### Niveaux de portée
+### Niveaux
 
-| Portée | Commande | Fichier cible |
+| Niveau | Commande | Fichier de destination |
 |--------|---------|-----------------|
-| Global (défaut) | `failproofai policies --install` | `~/.claude/settings.json` |
+| Global (par défaut) | `failproofai policies --install` | `~/.claude/settings.json` |
 | Projet | `failproofai policies --install --scope project` | `.claude/settings.json` |
 | Local | `failproofai policies --install --scope local` | `.claude/settings.local.json` |
 
@@ -97,7 +97,7 @@ failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
 
 ```bash
 failproofai policies --uninstall
-# ou pour une portée spécifique :
+# ou pour un niveau spécifique :
 failproofai policies --uninstall --scope project
 ```
 
@@ -148,30 +148,30 @@ La configuration des politiques se trouve dans `~/.failproofai/policies-config.j
 |--------|-------------|:---:|
 | `block-sudo` | Empêche les agents d'exécuter des commandes système privilégiées | `allowPatterns` |
 | `block-rm-rf` | Empêche la suppression récursive accidentelle de fichiers | `allowPaths` |
-| `block-curl-pipe-sh` | Empêche les agents de rediriger des scripts non fiables vers le shell | |
+| `block-curl-pipe-sh` | Empêche les agents de diriger des scripts non fiables vers le shell | |
 | `block-failproofai-commands` | Empêche la désinstallation automatique | |
 | `sanitize-jwt` | Empêche les jetons JWT de fuiter dans le contexte de l'agent | |
 | `sanitize-api-keys` | Empêche les clés API de fuiter dans le contexte de l'agent | `additionalPatterns` |
 | `sanitize-connection-strings` | Empêche les identifiants de base de données de fuiter dans le contexte de l'agent | |
-| `sanitize-private-key-content` | Expurge les blocs de clés privées PEM des sorties | |
-| `sanitize-bearer-tokens` | Expurge les jetons Authorization Bearer des sorties | |
+| `sanitize-private-key-content` | Masque les blocs de clés privées PEM dans la sortie | |
+| `sanitize-bearer-tokens` | Masque les jetons Authorization Bearer dans la sortie | |
 | `block-env-files` | Empêche les agents de lire les fichiers .env | |
 | `protect-env-vars` | Empêche les agents d'afficher les variables d'environnement | |
 | `block-read-outside-cwd` | Maintient les agents dans les limites du projet | `allowPaths` |
-| `block-secrets-write` | Empêche l'écriture dans les fichiers de clés privées et de certificats | `additionalPatterns` |
+| `block-secrets-write` | Empêche les écritures vers des fichiers de clés privées et de certificats | `additionalPatterns` |
 | `block-push-master` | Empêche les push accidentels vers main/master | `protectedBranches` |
 | `block-work-on-main` | Maintient les agents hors des branches protégées | `protectedBranches` |
 | `block-force-push` | Empêche `git push --force` | |
 | `warn-git-amend` | Avertit les agents avant de modifier des commits | |
 | `warn-git-stash-drop` | Avertit les agents avant de supprimer des stashes | |
 | `warn-all-files-staged` | Détecte les `git add -A` accidentels | |
-| `warn-destructive-sql` | Intercepte les instructions DROP/DELETE SQL avant exécution | |
-| `warn-schema-alteration` | Intercepte les ALTER TABLE avant exécution | |
-| `warn-large-file-write` | Détecte les écritures de fichiers anormalement volumineuses | `thresholdKb` |
+| `warn-destructive-sql` | Détecte les instructions SQL DROP/DELETE avant exécution | |
+| `warn-schema-alteration` | Détecte les ALTER TABLE avant exécution | |
+| `warn-large-file-write` | Détecte les écritures de fichiers inopinément volumineux | `thresholdKb` |
 | `warn-package-publish` | Détecte les `npm publish` accidentels | |
 | `warn-background-process` | Détecte les lancements involontaires de processus en arrière-plan | |
 | `warn-global-package-install` | Détecte les installations involontaires de paquets globaux | |
-| …et bien d'autres | | |
+| …et d'autres | | |
 
 Détails complets des politiques et référence des paramètres : [docs/built-in-policies.mdx](docs/built-in-policies.mdx)
 
@@ -179,7 +179,7 @@ Détails complets des politiques et référence des paramètres : [docs/built-in
 
 ## Politiques personnalisées
 
-Écrivez vos propres politiques pour maintenir les agents fiables et concentrés sur leurs tâches :
+Rédigez vos propres politiques pour maintenir les agents fiables et concentrés sur leurs tâches :
 
 ```js
 import { customPolicies, allow, deny, instruct } from "failproofai";
@@ -197,7 +197,7 @@ customPolicies.add({
 });
 ```
 
-Installation avec :
+À installer avec :
 
 ```bash
 failproofai policies --install --custom ./my-policies.js
@@ -209,10 +209,10 @@ failproofai policies --install --custom ./my-policies.js
 |----------|--------|
 | `allow()` | Autorise l'opération |
 | `allow(message)` | Autorise et envoie un contexte informatif à Claude |
-| `deny(message)` | Bloque l'opération ; le message est affiché à Claude |
-| `instruct(message)` | Ajoute du contexte au prompt de Claude ; ne bloque pas |
+| `deny(message)` | Bloque l'opération ; le message est transmis à Claude |
+| `instruct(message)` | Ajoute du contexte à l'invite de Claude ; ne bloque pas |
 
-### Objet contexte (`ctx`)
+### Objet de contexte (`ctx`)
 
 | Champ | Type | Description |
 |-------|------|-------------|
@@ -224,14 +224,14 @@ failproofai policies --install --custom ./my-policies.js
 | `session.sessionId` | `string` | Identifiant de session |
 | `session.transcriptPath` | `string` | Chemin vers le fichier de transcription de la session |
 
-Les hooks personnalisés prennent en charge les imports locaux transitifs, async/await et l'accès à `process.env`. Les erreurs sont traitées en mode fail-open (consignées dans `~/.failproofai/hook.log`, les politiques intégrées continuent de s'exécuter). Consultez [docs/custom-hooks.mdx](docs/custom-hooks.mdx) pour le guide complet.
+Les hooks personnalisés prennent en charge les imports locaux transitifs, async/await et l'accès à `process.env`. Les erreurs sont en mode fail-open (consignées dans `~/.failproofai/hook.log`, les politiques intégrées continuent de s'exécuter). Consultez [docs/custom-hooks.mdx](docs/custom-hooks.mdx) pour le guide complet.
 
 ### Politiques basées sur les conventions
 
-Déposez des fichiers `*policies.{js,mjs,ts}` dans `.failproofai/policies/` et ils seront chargés automatiquement — aucun indicateur `--custom` ni modification de configuration n'est nécessaire. Fonctionne comme les hooks git : déposez un fichier, il s'active tout seul.
+Déposez des fichiers `*policies.{js,mjs,ts}` dans `.failproofai/policies/` et ils seront chargés automatiquement — aucun indicateur ni modification de configuration n'est nécessaire. Commitez le répertoire dans git et chaque membre de l'équipe bénéficie automatiquement des mêmes standards de qualité.
 
 ```text
-# Niveau projet — versionné dans git, partagé avec l'équipe
+# Niveau projet — commité dans git, partagé avec l'équipe
 .failproofai/policies/security-policies.mjs
 .failproofai/policies/workflow-policies.mjs
 
@@ -239,13 +239,13 @@ Déposez des fichiers `*policies.{js,mjs,ts}` dans `.failproofai/policies/` et i
 ~/.failproofai/policies/my-policies.mjs
 ```
 
-Les deux niveaux sont chargés (union). Les fichiers sont chargés par ordre alphabétique au sein de chaque répertoire. Préfixez avec `01-`, `02-`, etc. pour contrôler l'ordre. Consultez [examples/convention-policies/](examples/convention-policies/) pour des exemples prêts à l'emploi.
+Les deux niveaux sont chargés (union). Les fichiers sont chargés par ordre alphabétique dans chaque répertoire. Préfixez avec `01-`, `02-`, etc. pour contrôler l'ordre. Au fur et à mesure que votre équipe découvre de nouveaux modes de défaillance, ajoutez une politique et poussez — tout le monde reçoit la mise à jour lors de leur prochain pull. Consultez [examples/convention-policies/](examples/convention-policies/) pour des exemples prêts à l'emploi.
 
 ---
 
 ## Télémétrie
 
-Failproof AI collecte une télémétrie d'utilisation anonyme via PostHog afin de comprendre l'utilisation des fonctionnalités. Aucun contenu de session, nom de fichier, paramètre d'entrée d'outil ni information personnelle n'est jamais transmis.
+Failproof AI collecte une télémétrie d'utilisation anonyme via PostHog afin de comprendre l'utilisation des fonctionnalités. Aucun contenu de session, nom de fichier, entrée d'outil ni information personnelle n'est jamais transmis.
 
 Pour la désactiver :
 
@@ -259,15 +259,15 @@ FAILPROOFAI_TELEMETRY_DISABLED=1 failproofai
 
 | Guide | Description |
 |-------|-------------|
-| [Getting Started](docs/getting-started.mdx) | Installation et premiers pas |
-| [Built-in Policies](docs/built-in-policies.mdx) | Les 30 politiques intégrées avec leurs paramètres |
-| [Custom Policies](docs/custom-policies.mdx) | Écrire vos propres politiques |
-| [Configuration](docs/configuration.mdx) | Format des fichiers de configuration et fusion des portées |
-| [Dashboard](docs/dashboard.mdx) | Surveiller les sessions et examiner l'activité des politiques |
+| [Démarrage](docs/getting-started.mdx) | Installation et premiers pas |
+| [Politiques intégrées](docs/built-in-policies.mdx) | Les 30 politiques intégrées avec leurs paramètres |
+| [Politiques personnalisées](docs/custom-policies.mdx) | Rédigez vos propres politiques |
+| [Configuration](docs/configuration.mdx) | Format du fichier de configuration et fusion des niveaux |
+| [Tableau de bord](docs/dashboard.mdx) | Surveillez les sessions et examinez l'activité des politiques |
 | [Architecture](docs/architecture.mdx) | Fonctionnement du système de hooks |
-| [Testing](docs/testing.mdx) | Exécuter les tests et en écrire de nouveaux |
+| [Tests](docs/testing.mdx) | Exécuter les tests et en écrire de nouveaux |
 
-### Lancer la documentation en local
+### Lancer la documentation localement
 
 ```bash
 docker build -f Dockerfile.docs -t failproofai-docs .
@@ -284,7 +284,7 @@ docker run --rm -p 3000:3000 -v $(pwd)/docs:/app/docs failproofai-docs
 
 ## Note à l'attention des contributeurs failproofai
 
-Le fichier `.claude/settings.json` de ce dépôt utilise `bun ./bin/failproofai.mjs --hook <EventType>` au lieu de la commande standard `npx -y failproofai`. En effet, l'exécution de `npx -y failproofai` à l'intérieur même du projet failproofai crée un conflit d'autoréférence.
+Le fichier `.claude/settings.json` de ce dépôt utilise `bun ./bin/failproofai.mjs --hook <EventType>` au lieu de la commande standard `npx -y failproofai`. En effet, exécuter `npx -y failproofai` à l'intérieur du projet failproofai lui-même crée un conflit d'auto-référencement.
 
 Pour tous les autres dépôts, l'approche recommandée est `npx -y failproofai`, installée via :
 
@@ -292,7 +292,7 @@ Pour tous les autres dépôts, l'approche recommandée est `npx -y failproofai`,
 failproofai policies --install --scope project
 ```
 
-## Contribuer
+## Contribution
 
 Consultez [CONTRIBUTING.md](CONTRIBUTING.md).
 
@@ -304,4 +304,4 @@ Consultez [LICENSE](LICENSE).
 
 ---
 
-Développé et maintenu par **ExosphereHost : Reliability Research Lab for Your Agents**. Nous aidons les entreprises et les startups à améliorer la fiabilité de leurs agents IA grâce à nos propres agents, logiciels et expertises. En savoir plus sur [exosphere.host](https://exosphere.host).
+Conçu et maintenu par **ExosphereHost : Reliability Research Lab for Your Agents**. Nous aidons les entreprises et les startups à améliorer la fiabilité de leurs agents IA grâce à nos propres agents, logiciels et expertises. En savoir plus sur [exosphere.host](https://exosphere.host).