failproofai 0.0.2 → 0.0.3

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

@@ -0,0 +1,253 @@
+---
+title: Exemples
+description: "Comment configurer des hooks pour Claude Code et le Agents SDK"
+icon: book-open
+---
+
+Des exemples prêts à l'emploi pour les scénarios courants. Chacun montre comment installer et ce que vous pouvez attendre.
+
+---
+
+## Configurer des hooks pour Claude Code
+
+Failproof AI s'intègre à Claude Code via son [système de hooks](https://docs.anthropic.com/en/docs/claude-code/hooks). Lorsque vous exécutez `failproofai policies --install`, il enregistre des commandes de hooks dans le fichier `settings.json` de Claude Code, qui se déclenchent à chaque appel d'outil.
+
+<Steps>
+  <Step title="Installer failproofai">
+    ```bash
+    npm install -g failproofai
+    ```
+  </Step>
+  <Step title="Activer toutes les politiques intégrées">
+    ```bash
+    failproofai policies --install
+    ```
+  </Step>
+  <Step title="Vérifier que les hooks sont enregistrés">
+    ```bash
+    cat ~/.claude/settings.json | grep failproofai
+    ```
+
+    Vous devriez voir des entrées de hooks pour les événements `PreToolUse`, `PostToolUse`, `Notification` et `Stop`.
+  </Step>
+  <Step title="Lancer Claude Code">
+    ```bash
+    claude
+    ```
+
+    Les politiques s'exécutent désormais automatiquement à chaque appel d'outil. Essayez de demander à Claude d'exécuter `sudo rm -rf /` — cela sera bloqué.
+  </Step>
+</Steps>
+
+---
+
+## Configurer des hooks pour le Agents SDK
+
+Si vous développez avec le [Agents SDK](https://docs.anthropic.com/en/docs/agents-sdk), vous pouvez utiliser le même système de hooks par programmation.
+
+<Steps>
+  <Step title="Installer failproofai dans votre projet">
+    ```bash
+    npm install failproofai
+    ```
+  </Step>
+  <Step title="Configurer les hooks dans votre agent">
+    Passez des commandes de hooks lors de la création de votre processus agent. Les hooks se déclenchent de la même manière que dans Claude Code — via stdin/stdout JSON :
+
+    ```bash
+    failproofai --hook PreToolUse   # appelé avant chaque outil
+    failproofai --hook PostToolUse  # appelé après chaque outil
+    ```
+  </Step>
+  <Step title="Écrire une politique personnalisée pour votre agent">
+    ```javascript
+    import { customPolicies, allow, deny } from "failproofai";
+
+    customPolicies.add({
+      name: "limit-to-project-dir",
+      description: "Keep the agent inside the project directory",
+      match: { events: ["PreToolUse"] },
+      fn: async (ctx) => {
+        const path = String(ctx.toolInput?.file_path ?? "");
+        if (path.startsWith("/") && !path.startsWith(ctx.session?.cwd ?? "")) {
+          return deny("Agent is restricted to the project directory");
+        }
+        return allow();
+      },
+    });
+    ```
+  </Step>
+  <Step title="Installer la politique personnalisée">
+    ```bash
+    failproofai policies --install --custom ./my-agent-policies.js
+    ```
+  </Step>
+</Steps>
+
+---
+
+## Bloquer les commandes destructives
+
+La configuration la plus courante — empêcher les agents de causer des dommages irréversibles.
+
+```bash
+failproofai policies --install block-sudo block-rm-rf block-force-push block-curl-pipe-sh
+```
+
+Ce que ça fait :
+- `block-sudo` — bloque toutes les commandes `sudo`
+- `block-rm-rf` — bloque la suppression récursive de fichiers
+- `block-force-push` — bloque les `git push --force`
+- `block-curl-pipe-sh` — bloque le piping de scripts distants vers le shell
+
+---
+
+## Prévenir les fuites de secrets
+
+Empêchez les agents de voir ou de divulguer des identifiants dans la sortie des outils.
+
+```bash
+failproofai policies --install sanitize-api-keys sanitize-jwt sanitize-connection-strings sanitize-bearer-tokens
+```
+
+Ces politiques se déclenchent sur `PostToolUse` — après l'exécution d'un outil, elles nettoient la sortie avant que l'agent ne la voie.
+
+---
+
+## Recevoir des alertes Slack quand les agents ont besoin d'attention
+
+Utilisez le hook de notification pour transmettre les alertes d'inactivité vers Slack.
+
+```javascript
+import { customPolicies, allow, instruct } from "failproofai";
+
+customPolicies.add({
+  name: "slack-on-idle",
+  description: "Alert Slack when the agent is waiting for input",
+  match: { events: ["Notification"] },
+  fn: async (ctx) => {
+    const webhookUrl = process.env.SLACK_WEBHOOK_URL;
+    if (!webhookUrl) return allow();
+
+    const message = String(ctx.payload?.message ?? "Agent is waiting");
+    const project = ctx.session?.cwd ?? "unknown";
+
+    try {
+      await fetch(webhookUrl, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          text: `*${message}*\nProject: \`${project}\``,
+        }),
+        signal: AbortSignal.timeout(5000),
+      });
+    } catch {
+      // ne jamais bloquer l'agent si Slack est inaccessible
+    }
+
+    return allow();
+  },
+});
+```
+
+Installez-le :
+
+```bash
+SLACK_WEBHOOK_URL=https://hooks.slack.com/... failproofai policies --install --custom ./slack-alerts.js
+```
+
+---
+
+## Maintenir les agents sur une branche
+
+Empêchez les agents de changer de branche ou de pousser vers des branches protégées.
+
+```javascript
+import { customPolicies, allow, deny } from "failproofai";
+
+customPolicies.add({
+  name: "stay-on-branch",
+  description: "Prevent the agent from checking out other branches",
+  match: { events: ["PreToolUse"] },
+  fn: async (ctx) => {
+    if (ctx.toolName !== "Bash") return allow();
+    const cmd = String(ctx.toolInput?.command ?? "");
+    if (/git\s+checkout\s+(?!-b)/.test(cmd)) {
+      return deny("Stay on the current branch. Create a new branch with -b if needed.");
+    }
+    return allow();
+  },
+});
+```
+
+---
+
+## Exiger des tests avant les commits
+
+Rappelez aux agents d'exécuter les tests avant de committer.
+
+```javascript
+import { customPolicies, allow, instruct } from "failproofai";
+
+customPolicies.add({
+  name: "test-before-commit",
+  description: "Remind the agent to run tests before committing",
+  match: { events: ["PreToolUse"] },
+  fn: async (ctx) => {
+    if (ctx.toolName !== "Bash") return allow();
+    const cmd = String(ctx.toolInput?.command ?? "");
+    if (/git\s+commit/.test(cmd)) {
+      return instruct("Run tests before committing. Use `npm test` or `bun test` first.");
+    }
+    return allow();
+  },
+});
+```
+
+---
+
+## Verrouiller un dépôt de production
+
+Commitez une configuration au niveau du projet pour que tous les développeurs de votre équipe bénéficient des mêmes politiques.
+
+Créez `.failproofai/policies-config.json` dans votre dépôt :
+
+```json
+{
+  "enabledPolicies": [
+    "block-sudo",
+    "block-rm-rf",
+    "block-force-push",
+    "block-push-master",
+    "block-env-files",
+    "sanitize-api-keys",
+    "sanitize-jwt"
+  ],
+  "policyParams": {
+    "block-push-master": {
+      "protectedBranches": ["main", "release", "production"]
+    }
+  }
+}
+```
+
+Puis commitez-le :
+
+```bash
+git add .failproofai/policies-config.json
+git commit -m "Add failproofai team policies"
+```
+
+Chaque membre de l'équipe ayant failproofai installé récupérera automatiquement ces règles.
+
+---
+
+## Plus d'exemples
+
+Le répertoire [`examples/`](https://github.com/exospherehost/failproofai/tree/main/examples) du dépôt contient :
+
+| Fichier | Ce qu'il illustre |
+|---------|-------------------|
+| `policies-basic.js` | Politiques de démarrage — bloquer les écritures en production, les force-push et les scripts pipés |
+| `policies-notification.js` | Alertes Slack pour les notifications d'inactivité et la fin de session |
+| `policies-advanced/index.js` | Imports transitifs, hooks asynchrones, nettoyage de la sortie `PostToolUse`, gestion de l'événement `Stop` |

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

@@ -0,0 +1,38 @@
+---
+title: "Pour les agents"
+description: "Ajoutez les connaissances Failproof AI à votre agent de codage en une seule commande. Compatible avec Claude Code, Cursor, Windsurf, et bien plus."
+---
+
+Ajoutez l'intégralité de la référence Failproof AI à votre agent de codage en une seule commande. Compatible avec Claude Code, Cursor, Windsurf, et tout autre agent prenant en charge les skills.
+
+```bash
+npx skills add https://docs.befailproof.ai
+```
+
+`npx skills` détecte les agents installés sur votre machine et ajoute le skill dans le format approprié pour chacun d'eux automatiquement.
+
+## Ce que couvre le skill
+
+| Domaine | Contenu |
+|---------|---------|
+| Politiques | Noms des politiques intégrées, types d'événements, paramètres, activation/désactivation |
+| Politiques personnalisées | `customPolicies.add()`, filtres de correspondance, API `allow`/`deny`/`instruct` |
+| Objet de contexte | `ctx.eventType`, `ctx.toolName`, `ctx.toolInput`, `ctx.session` |
+| Configuration | Structure de `policies-config.json`, fusion des portées, `policyParams` |
+| CLI | `failproofai policies --install`, `--uninstall`, `--custom`, portées |
+| Tableau de bord | Visualiseur de sessions, activité des politiques, variables d'environnement |
+| Architecture | Flux du gestionnaire de hooks, codes de sortie, contrat stdin/stdout |
+
+## Le skill est-il complet ?
+
+Mintlify génère `llms.txt` à partir de toutes les pages de la navigation. La documentation Failproof AI couvre l'intégralité de l'API — chaque politique, option et exemple est inclus. Si vous constatez qu'il manque quelque chose, la source est disponible à l'adresse `https://docs.befailproof.ai/llms-full.txt`.
+
+Pour un contexte ciblé, créez un lien directement vers une page spécifique :
+
+```bash
+# Uniquement l'API des politiques personnalisées
+npx skills add https://docs.befailproof.ai/custom-policies
+
+# Uniquement les politiques intégrées
+npx skills add https://docs.befailproof.ai/built-in-policies
+```

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

@@ -0,0 +1,134 @@
+---
+title: Démarrage rapide
+description: "Installez failproofai, activez les politiques et laissez vos agents s'exécuter de manière fiable"
+icon: rocket
+---
+
+## Prérequis
+
+- **Node.js** >= 20.9.0
+- **Bun** >= 1.3.0 (optionnel - uniquement nécessaire pour compiler depuis les sources)
+
+---
+
+## Installation
+
+<CodeGroup>
+
+```bash npm
+npm install -g failproofai
+```
+
+```bash bun
+bun add -g failproofai
+```
+
+</CodeGroup>
+
+---
+
+## Démarrage rapide
+
+<Steps>
+  <Step title="Activer les politiques">
+    Les politiques sont des règles qui s'exécutent avant et après chaque appel d'outil de l'agent. Elles interceptent les commandes destructrices, les fuites de secrets et autres modes de défaillance avant qu'ils ne causent des dommages.
+
+    ```bash
+    failproofai policies --install
+    ```
+
+    Cela écrit des entrées de hook dans le fichier `settings.json` de Claude Code. Vous pouvez également installer pour un seul projet ou choisir des politiques spécifiques :
+
+    ```bash
+    failproofai policies --install --scope project
+    failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
+    ```
+  </Step>
+  <Step title="Vérifier">
+    ```bash
+    failproofai policies
+    ```
+
+    Affiche toutes les politiques, leur état d'activation et les paramètres configurés.
+  </Step>
+  <Step title="Lancer le tableau de bord">
+    ```bash
+    failproofai
+    ```
+
+    Ouvre un tableau de bord local à l'adresse `http://localhost:8020` où vous pouvez parcourir les sessions, inspecter les appels d'outils et gérer les politiques.
+  </Step>
+  <Step title="Exécuter votre agent">
+    Démarrez Claude Code comme d'habitude. Si l'agent tente quelque chose de risqué, failproofai l'intercepte automatiquement. Laissez-le tourner sans surveillance et consultez ce qui s'est passé dans le tableau de bord.
+  </Step>
+</Steps>
+
+---
+
+## Comment fonctionnent les politiques
+
+Chaque fois qu'un agent exécute un outil, Claude Code appelle failproofai en tant que sous-processus :
+
+```text
+Claude Code  →  failproofai --hook PreToolUse  →  reads stdin JSON
+                                                 evaluates policies
+                                                 writes decision to stdout
+```
+
+Chaque politique retourne l'une des trois décisions suivantes :
+
+- **allow** - l'agent continue normalement
+- **deny** - l'action est bloquée, l'agent est informé de la raison
+- **instruct** - du contexte supplémentaire est ajouté au prompt de l'agent
+
+<Note>
+Les politiques s'exécutent dans votre processus local. Aucune donnée n'est envoyée à un service distant.
+</Note>
+
+---
+
+## Stockage des données
+
+Toute la configuration et les journaux restent sur votre machine :
+
+| Chemin | Contenu |
+|--------|---------|
+| `~/.failproofai/policies-config.json` | Configuration globale des politiques |
+| `~/.failproofai/hook-activity.jsonl` | Historique d'exécution des hooks |
+| `~/.failproofai/hook.log` | Journal de débogage pour les erreurs de hooks personnalisés |
+| `.failproofai/policies-config.json` | Configuration par projet (validée dans le dépôt) |
+| `.failproofai/policies-config.local.json` | Remplacements personnels (ignorés par git) |
+
+---
+
+## Désinstallation
+
+```bash
+failproofai policies --uninstall
+```
+
+Supprime les entrées de hook du fichier `~/.claude/settings.json`. Les fichiers de configuration dans `~/.failproofai/` sont conservés.
+
+---
+
+## Étapes suivantes
+
+<CardGroup cols={2}>
+
+<Card title="Configuration" icon="gear" href="/fr/configuration">
+  Périmètres et format des fichiers de configuration
+</Card>
+
+<Card title="Politiques intégrées" icon="shield" href="/fr/built-in-policies">
+  Les 26 politiques avec leurs paramètres
+</Card>
+
+<Card title="Politiques personnalisées" icon="code" href="/fr/custom-policies">
+  Écrivez vos propres politiques en JavaScript
+</Card>
+
+<Card title="Moniteur d'agents" icon="chart-line" href="/fr/dashboard">
+  Surveillez les sessions et consultez l'activité des politiques
+</Card>
+
+</CardGroup>

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

@@ -0,0 +1,57 @@
+---
+title: Failproof AI
+description: "Gérez les hooks et les politiques qui maintiennent vos agents IA fiables et autonomes"
+---
+
+[![npm weekly downloads](https://img.shields.io/npm/dw/failproofai?style=flat-square&color=2ea44f)](https://www.npmjs.com/package/failproofai)
+
+Des hooks et des politiques qui maintiennent vos agents IA fiables et autonomes - pour **Claude Code** et le **Agents SDK**.
+
+Les agents IA échouent de manière prévisible. Ils exécutent des commandes destructrices, exposent des secrets, dérivent hors sujet, se retrouvent bloqués dans des boucles ou poussent directement vers la branche principale. Sans surveillance, les petites défaillances s'enchaînent.
+
+Failproof AI résout ce problème grâce aux **politiques** - des règles qui s'intègrent à chaque appel d'outil de l'agent et peuvent **détecter les défaillances**, **les atténuer** (bloquer, instruire, assainir) et **vous alerter** lorsqu'une intervention est nécessaire. Un tableau de bord local vous permet de tout passer en revue par la suite.
+
+Tout s'exécute localement. Aucune donnée ne quitte votre machine.
+
+## Démarrer
+
+<CardGroup cols={2}>
+
+<Card title="26 politiques intégrées" icon="shield" href="/fr/built-in-policies">
+  Bloquez les commandes destructrices, empêchez les fuites de secrets, maintenez les agents dans les limites du projet, et bien plus encore - directement intégré.
+</Card>
+
+<Card title="Politiques personnalisées" icon="code" href="/fr/custom-policies">
+  Écrivez vos propres règles en JavaScript avec une API simple allow / deny / instruct.
+</Card>
+
+<Card title="Moniteur d'agents" icon="chart-line" href="/fr/dashboard">
+  Voyez ce que vos agents ont fait pendant votre absence. Parcourez les sessions, inspectez les appels d'outils, examinez où les politiques se sont déclenchées.
+</Card>
+
+<Card title="Configuration simplifiée" icon="gear" href="/fr/configuration">
+  Ajustez n'importe quelle politique sans code. Définissez des listes d'autorisation, des branches protégées ou des seuils par projet ou globalement.
+</Card>
+
+</CardGroup>
+
+## Démarrage rapide
+
+<CodeGroup>
+
+```bash npm
+npm install -g failproofai
+```
+
+```bash bun
+bun add -g failproofai
+```
+
+</CodeGroup>
+
+```bash
+failproofai policies --install   # activer les politiques
+failproofai                      # lancer le tableau de bord
+```
+
+Consultez le guide [Premiers pas](/fr/getting-started) pour une présentation complète.

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

@@ -0,0 +1,82 @@
+---
+title: Alias de Packages
+description: "Alias enregistrés pour la prévention du typosquatting et leur fonctionnement"
+icon: copy
+---
+
+## Package officiel
+
+Le package npm canonique est **`failproofai`** :
+
+```bash
+npm install -g failproofai
+# or
+bun add -g failproofai
+```
+
+---
+
+## Pourquoi nous détenons les noms d'alias
+
+Le typosquatting est une attaque courante contre la chaîne d'approvisionnement logicielle, où un acteur malveillant enregistre un nom de package à une seule frappe de clavier d'un package populaire. Les utilisateurs qui font une faute de frappe lors de la commande d'installation finissent par exécuter du code contrôlé par l'attaquant avec un accès complet au système — exactement le type de menace que Failproof AI est conçu pour contrer.
+
+Pour éliminer cette surface d'attaque, **nous détenons de manière préventive toutes les fautes d'orthographe courantes et variantes de formatage** de `failproofai` sur npm. Aucun de ces noms ne peut être enregistré par un tiers. Chacun est un proxy minimal qui installe le vrai package `failproofai` et lui délègue les appels.
+
+---
+
+## Alias enregistrés
+
+**Variantes de formatage** - différentes façons d'écrire « failproof ai » :
+
+| Package | Statut |
+|---------|--------|
+| `failproof` | ✅ Publié |
+| `failproof-ai` | ⏳ En attente de validation npm |
+| `fail-proof-ai` | ⏳ En attente de validation npm |
+| `failproof_ai` | ⏳ En attente de validation npm |
+| `fail_proof_ai` | ⏳ En attente de validation npm |
+| `fail-proofai` | ⏳ En attente de validation npm |
+
+**Fautes de frappe `failprof*`** - un `o` manquant dans « proof » :
+
+| Package | Statut |
+|---------|--------|
+| `failprof` | ✅ Publié |
+| `failprof-ai` | ✅ Publié |
+| `failprofai` | ⏳ En attente de validation npm |
+| `fail-prof-ai` | ⏳ En attente de validation npm |
+| `failprof_ai` | ⏳ En attente de validation npm |
+
+**Fautes de frappe `faliproof*`** - inversion des lettres `a` et `i` :
+
+| Package | Statut |
+|---------|--------|
+| `faliproof` | ✅ Publié |
+| `faliproof-ai` | ✅ Publié |
+| `faliproofai` | ⏳ En attente de validation npm |
+
+> **Pourquoi « en attente » ?** La politique anti-spam de npm bloque les noms qui, après suppression de la ponctuation et application de vérifications de similarité, se normalisent vers la même chaîne qu'un package existant. Nous avons contacté le support npm pour réserver ces noms à des fins de protection contre le squatting. Ils seront activés une fois approuvés.
+
+Vous pouvez vérifier que tout alias publié nous appartient :
+
+```bash
+npm info failproof
+# Look for: "ExosphereHost Inc." in the maintainers field
+```
+
+---
+
+## Fonctionnement des alias
+
+Chaque package alias :
+
+1. Liste `failproofai` comme dépendance — ainsi, le vrai package (y compris la configuration de son hook `postinstall`) s'exécute lors de l'installation
+2. Expose un binaire portant son propre nom (par exemple `failprof-ai`) qui transmet tous les arguments au binaire `failproofai`
+
+Le proxy est un script Node de deux lignes ; il ne contient aucune logique, n'effectue aucun appel réseau et ne collecte aucune donnée au-delà de ce que fait `failproofai` lui-même.
+
+---
+
+## Si vous trouvez un nom que nous avons manqué
+
+Ouvrez une issue sur [exospherehost/failproofai](https://github.com/exospherehost/failproofai/issues) et nous l'enregistrerons.