failproofai 0.0.5 → 0.0.6-beta.1

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 a tus agentes de IA fiables, enfocados y funcionando de forma autónoma — para **Claude Code** y el **Agents SDK**.
+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**.
 
-- **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.
+- **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.
 
-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 o compilación desde el código fuente)
+- Bun >= 1.3.0 (opcional - solo necesario para desarrollo / compilación desde el código fuente)
 
 ---
 
@@ -61,15 +61,15 @@ 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
+### 2. Lanzar 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 sesiones, inspecciona registros y gestiona políticas.
 
-### 3. Comprobar qué está activo
+### 3. Verificar qué está activo
 
 ```bash
 failproofai policies
@@ -79,10 +79,10 @@ failproofai policies
 
 ## Instalación de políticas
 
-### Niveles
+### Ámbitos
 
-| Nivel | Comando | Dónde escribe |
-|-------|---------|----------------|
+| Ámbito | 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 nivel específico:
+# o para un ámbito específico:
 failproofai policies --uninstall --scope project
 ```
 
@@ -105,7 +105,7 @@ 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).
+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).
 
 ```json
 {
@@ -138,7 +138,7 @@ La configuración de políticas se encuentra en `~/.failproofai/policies-config.
 }
 ```
 
-**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.
+**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.
 
 ---
 
@@ -146,16 +146,16 @@ La configuración de políticas se encuentra en `~/.failproofai/policies-config.
 
 | 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-sudo` | Evita que los agentes ejecuten comandos del sistema con privilegios elevados | `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-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-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-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 | |
+| `block-env-files` | Evita 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` |
@@ -165,8 +165,8 @@ La configuración de políticas se encuentra en `~/.failproofai/policies-config.
 | `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-destructive-sql` | Detecta DROP/DELETE en SQL antes de la ejecución | |
+| `warn-schema-alteration` | Detecta ALTER TABLE antes de la ejecución | |
 | `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 | |
@@ -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 enfocados:
+Escribe tus propias políticas para mantener a los agentes fiables y centrados en su tarea:
 
 ```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 que se está llamando (`"Bash"`, `"Write"`, `"Read"`, …) |
+| `toolName` | `string` | Herramienta siendo llamada (`"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.
+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.
 
 ### Políticas basadas en convenciones
 
-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.
+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.
 
 ```text
-# Nivel de proyecto — guardado en git, compartido con el equipo
+# A nivel de proyecto — incluido 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
+# A 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.
+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.
 
 ---
 
 ## 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.
+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.
 
 Para desactivarla:
 
@@ -259,11 +259,11 @@ FAILPROOFAI_TELEMETRY_DISABLED=1 failproofai
 
 | Guía | Descripción |
 |------|-------------|
-| [Primeros pasos](docs/getting-started.mdx) | Instalación y pasos iniciales |
+| [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 niveles |
-| [Panel de control](docs/dashboard.mdx) | Monitoriza sesiones y revisa la actividad de las 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 |
 | [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 colaboradores de failproofai
+## Nota para los 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.
+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.
 
 Para todos los demás repositorios, el enfoque recomendado es `npx -y failproofai`, instalado mediante:
 

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

@@ -23,21 +23,21 @@
 
 **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 façon la plus simple de gérer des politiques qui maintiennent vos agents IA fiables, concentrés sur leur tâche et autonomes — pour **Claude Code** et le **Agents SDK**.
+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**.
 
-- **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.
-- **Politiques personnalisées** - Écrivez vos propres règles de fiabilité en JavaScript. Utilisez l'API `allow`/`deny`/`instruct` pour appliquer 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. La configuration à trois niveaux est fusionnée 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 où les politiques se sont 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, 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.
 
-Tout s'exécute localement — aucune donnée ne quitte votre machine.
+Tout s'exécute en local — aucune donnée ne quitte votre machine.
 
 ---
 
 ## Prérequis
 
 - Node.js >= 20.9.0
-- Bun >= 1.3.0 (optionnel — nécessaire uniquement pour le développement / la compilation depuis les sources)
+- Bun >= 1.3.0 (optionnel — uniquement nécessaire pour le développement ou la compilation depuis les sources)
 
 ---
 
@@ -45,7 +45,7 @@ Tout s'exécute localement — aucune donnée ne quitte votre machine.
 
 ```bash
 npm install -g failproofai
-# or
+# ou
 bun add -g failproofai
 ```
 
@@ -59,7 +59,7 @@ bun add -g failproofai
 failproofai policies --install
 ```
 
-Écrit les entrées de hook dans `~/.claude/settings.json`. Claude Code invoquera désormais failproofai avant et après chaque appel d'outil.
+Inscrit 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
 
@@ -81,11 +81,11 @@ failproofai policies
 
 ### Niveaux de portée
 
-| Portée | Commande | Fichier modifié |
+| Portée | Commande | Fichier cible |
 |--------|---------|-----------------|
-| Globale (par défaut) | `failproofai policies --install` | `~/.claude/settings.json` |
+| Global (défaut) | `failproofai policies --install` | `~/.claude/settings.json` |
 | Projet | `failproofai policies --install --scope project` | `.claude/settings.json` |
-| Locale | `failproofai policies --install --scope local` | `.claude/settings.local.json` |
+| Local | `failproofai policies --install --scope local` | `.claude/settings.local.json` |
 
 ### Installer des politiques spécifiques
 
@@ -105,7 +105,7 @@ failproofai policies --uninstall --scope project
 
 ## Configuration
 
-La configuration des politiques se trouve dans `~/.failproofai/policies-config.json` (globale) ou `.failproofai/policies-config.json` dans votre projet (par projet).
+La configuration des politiques se trouve dans `~/.failproofai/policies-config.json` (global) ou `.failproofai/policies-config.json` dans votre projet (par projet).
 
 ```json
 {
@@ -150,11 +150,11 @@ La configuration des politiques se trouve dans `~/.failproofai/policies-config.j
 | `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-failproofai-commands` | Empêche la désinstallation automatique | |
-| `sanitize-jwt` | Stoppe la fuite des tokens JWT dans le contexte de l'agent | |
-| `sanitize-api-keys` | Stoppe la fuite des clés API dans le contexte de l'agent | `additionalPatterns` |
-| `sanitize-connection-strings` | Stoppe la fuite des identifiants de base de données dans le contexte de l'agent | |
-| `sanitize-private-key-content` | Masque les blocs de clés privées PEM dans la sortie | |
-| `sanitize-bearer-tokens` | Masque les tokens Authorization Bearer dans la sortie | |
+| `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 | |
 | `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` |
@@ -162,16 +162,16 @@ La configuration des politiques se trouve dans `~/.failproofai/policies-config.j
 | `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` | Rappelle aux agents avant d'amender des commits | |
-| `warn-git-stash-drop` | Rappelle aux agents avant de supprimer des stashes | |
+| `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` | 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 anormalement volumineux | `thresholdKb` |
+| `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-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 plus encore | | |
+| …et bien 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 leur tâche :
+Écrivez 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({
 });
 ```
 
-Installez avec :
+Installation avec :
 
 ```bash
 failproofai policies --install --custom ./my-policies.js
@@ -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 en mode fail-open (journalisées dans `~/.failproofai/hook.log`, les politiques intégrées continuent). 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 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.
 
 ### Politiques basées sur les conventions
 
-Déposez des fichiers `*policies.{js,mjs,ts}` dans `.failproofai/policies/` et ils sont chargés automatiquement — aucun indicateur `--custom` ni modification de configuration n'est nécessaire. Fonctionne comme les hooks git : déposez un fichier, ça marche tout simplement.
+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.
 
 ```text
-# Niveau projet — validé dans git, partagé avec l'équipe
+# Niveau projet — versionné 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 dans 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 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.
 
 ---
 
 ## 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, 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, paramètre d'entrée d'outil ni information personnelle n'est jamais transmis.
 
 Pour la désactiver :
 
@@ -259,22 +259,22 @@ FAILPROOFAI_TELEMETRY_DISABLED=1 failproofai
 
 | Guide | Description |
 |-------|-------------|
-| [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) | Écrire vos propres politiques |
-| [Configuration](docs/configuration.mdx) | Format du fichier de configuration et fusion des portées |
-| [Tableau de bord](docs/dashboard.mdx) | Surveiller les sessions et examiner l'activité des politiques |
+| [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 |
 | [Architecture](docs/architecture.mdx) | Fonctionnement du système de hooks |
-| [Tests](docs/testing.mdx) | Exécuter les tests et en écrire de nouveaux |
+| [Testing](docs/testing.mdx) | Exécuter les tests et en écrire de nouveaux |
 
-### Lancer la documentation localement
+### Lancer la documentation en local
 
 ```bash
 docker build -f Dockerfile.docs -t failproofai-docs .
 docker run --rm -p 3000:3000 failproofai-docs
 ```
 
-Ouvre le site de documentation Mintlify sur `http://localhost:3000`. Le conteneur surveille les modifications si vous montez le répertoire docs :
+Ouvre le site de documentation Mintlify à l'adresse `http://localhost:3000`. Le conteneur surveille les modifications si vous montez le répertoire docs :
 
 ```bash
 docker run --rm -p 3000:3000 -v $(pwd)/docs:/app/docs failproofai-docs
@@ -282,9 +282,9 @@ docker run --rm -p 3000:3000 -v $(pwd)/docs:/app/docs failproofai-docs
 
 ---
 
-## Note pour les contributeurs de failproofai
+## Note à l'attention des contributeurs failproofai
 
-Le fichier `.claude/settings.json` de ce dépôt utilise `bun ./bin/failproofai.mjs --hook <EventType>` à la place de la commande standard `npx -y failproofai`. En effet, exécuter `npx -y failproofai` à l'intérieur même du projet failproofai crée un conflit d'auto-référencement.
+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.
 
 Pour tous les autres dépôts, l'approche recommandée est `npx -y failproofai`, installée via :
 
@@ -304,4 +304,4 @@ Consultez [LICENSE](LICENSE).
 
 ---
 
-Créé 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).
+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).