failproofai 0.0.6-beta.2 → 0.0.6-beta.4

package/.next/standalone/docs/fr/cli/install-policies.mdx

@@ -1,47 +0,0 @@
----
-title: Installer des politiques
-description: "Activer les politiques afin qu'elles s'exécutent à chaque appel d'outil de l'agent"
----
-
-```bash
-failproofai policies --install [policy-names...] [options]
-```
-
-Écrit des entrées de hook dans le fichier `settings.json` de Claude Code afin que failproofai intercepte les appels d'outils.
-
-Alias : `failproofai p -i`
-
-## Options
-
-| Indicateur | Description |
-|------|-------------|
-| `--scope user` | Installe dans `~/.claude/settings.json` (par défaut — toutes les sessions) |
-| `--scope project` | Installe dans `.claude/settings.json` du répertoire courant |
-| `--scope local` | Installe dans `.claude/settings.local.json` du répertoire courant |
-| `--custom <path>` / `-c` | Chemin vers un fichier JS contenant des politiques de hook personnalisées |
-
-## Comportement
-
-- **Aucun nom de politique** — ouvre une invite interactive pour sélectionner les politiques
-- **Noms spécifiques** — active ces politiques (s'ajoutent à celles déjà activées)
-- **`all`** — active toutes les politiques disponibles
-
-L'installation est additive : relancer `--install` ajoute de nouvelles politiques sans supprimer les existantes.
-
-## Exemples
-
-```bash
-# Installer toutes les politiques par défaut globalement (interactif)
-failproofai policies --install
-
-# Installer des politiques spécifiques pour le projet courant
-failproofai policies --install block-sudo sanitize-api-keys --scope project
-
-# Activer toutes les politiques en une seule fois
-failproofai policies --install all
-
-# Installer avec un fichier de politiques personnalisé
-failproofai policies --install --custom ./my-policies.js
-```
-
-Lorsque `--custom <path>` est fourni, le fichier est validé immédiatement — il doit appeler `customPolicies.add()` au moins une fois. Le chemin résolu est enregistré dans `policies-config.json` sous la clé `customPoliciesPath`.

package/.next/standalone/docs/fr/cli/list-policies.mdx

@@ -1,31 +0,0 @@
----
-title: Lister les politiques
-description: "Voir quelles politiques sont activées, leurs paramètres, et les politiques personnalisées"
----
-
-```bash
-failproofai policies
-```
-
-Affiche toutes les politiques avec leur statut, leurs paramètres configurés, et les politiques personnalisées.
-
-## Exemple de sortie
-
-```text
-Failproof AI Hook Policies (user)
-
-  Status  Name                          Description
-  ──────  ──────────────────────────────────────────────────────────────
-  ✓       block-sudo                    Block sudo commands
-            allowPatterns: ["sudo systemctl status"]
-  ✓       block-rm-rf                   Block recursive deletions
-  ✗       block-curl-pipe-sh            Block curl|bash patterns
-  ✓       sanitize-api-keys             Redact API keys from output
-            additionalPatterns: [{ regex: "MY_TOKEN_...", label: "..." }]
-
-  ── Custom Policies (/home/alice/myproject/my-policies.js) ──────────────
-  ✓       require-jira-ticket           Block commits without ticket
-  ✓       approval-gate                 Approval gate for destructive ops
-```
-
-Les clés inconnues dans `policyParams` sont signalées ici afin que vous puissiez détecter les fautes de frappe rapidement.

package/.next/standalone/docs/fr/cli/remove-policies.mdx

@@ -1,43 +0,0 @@
----
-title: Désinstaller les politiques
-description: "Supprimer les entrées de hook des paramètres de Claude Code"
----
-
-```bash
-failproofai policies --uninstall [policy-names...] [options]
-```
-
-Supprime les entrées de hook failproofai du fichier `settings.json` de Claude Code.
-
-Alias : `failproofai p -u`
-
-## Options
-
-| Indicateur | Description |
-|------------|-------------|
-| `--scope user` | Supprimer des paramètres globaux (par défaut) |
-| `--scope project` | Supprimer des paramètres du projet |
-| `--scope local` | Supprimer des paramètres locaux |
-| `--scope all` | Supprimer de tous les scopes à la fois |
-| `--custom` / `-c` | Effacer le `customPoliciesPath` de la configuration |
-
-## Comportement
-
-- **Aucun nom de politique** — supprime toutes les entrées de hook failproofai du fichier de paramètres
-- **Noms spécifiques** — désactive ces politiques mais conserve les hooks installés
-
-## Exemples
-
-```bash
-# Supprimer tous les hooks globalement
-failproofai policies --uninstall
-
-# Désactiver une politique spécifique (conserve les hooks installés)
-failproofai policies --uninstall block-sudo
-
-# Supprimer les hooks de tous les scopes
-failproofai policies --uninstall --scope all
-
-# Effacer le chemin des politiques personnalisées
-failproofai policies --uninstall --custom
-```

package/.next/standalone/docs/fr/cli/version.mdx

@@ -1,12 +0,0 @@
----
-title: Vérifier la version
-description: "Afficher la version installée de failproofai"
----
-
-```bash
-failproofai --version
-# or
-failproofai -v
-```
-
-Affiche le numéro de version installé.

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

@@ -1,222 +0,0 @@
----
-title: Configuration
-description: "Format des fichiers de configuration, système à trois portées et règles de fusion"
-icon: gear
----
-
-failproofai utilise des fichiers de configuration JSON pour contrôler quelles politiques sont actives, leur comportement, et les chemins de chargement des politiques personnalisées. La configuration est conçue pour être facilement partagée avec votre équipe — commitez-la dans votre dépôt et chaque développeur bénéficie du même filet de sécurité pour les agents.
-
----
-
-## Portées de configuration
-
-Il existe trois portées de configuration, évaluées par ordre de priorité :
-
-| Portée | Chemin du fichier | Objectif |
-|--------|-------------------|---------|
-| **project** | `.failproofai/policies-config.json` | Paramètres par dépôt, commités dans le contrôle de version |
-| **local** | `.failproofai/policies-config.local.json` | Surcharges personnelles par dépôt, ignorées par git |
-| **global** | `~/.failproofai/policies-config.json` | Valeurs par défaut au niveau utilisateur pour tous les projets |
-
-Lorsque failproofai reçoit un événement de hook, il charge et fusionne les trois fichiers qui existent pour le répertoire de travail courant.
-
-### Règles de fusion
-
-**`enabledPolicies`** — l'union des trois portées. Une politique activée à n'importe quel niveau est active.
-
-```text
-project:  ["block-sudo"]
-local:    ["block-rm-rf"]
-global:   ["block-sudo", "sanitize-api-keys"]
-
-resolved: ["block-sudo", "block-rm-rf", "sanitize-api-keys"]  ← union dédupliquée
-```
-
-**`policyParams`** — la première portée qui définit des paramètres pour une politique donnée l'emporte entièrement. Il n'y a pas de fusion profonde des valeurs au sein des paramètres d'une politique.
-
-```text
-project:  block-sudo → { allowPatterns: ["sudo apt-get update"] }
-global:   block-sudo → { allowPatterns: ["sudo systemctl status"] }
-
-resolved: { allowPatterns: ["sudo apt-get update"] }   ← project l'emporte, global ignoré
-```
-
-```text
-project:  (aucune entrée block-sudo)
-local:    (aucune entrée block-sudo)
-global:   block-sudo → { allowPatterns: ["sudo systemctl status"] }
-
-resolved: { allowPatterns: ["sudo systemctl status"] }  ← repli sur global
-```
-
-**`customPoliciesPath`** — la première portée qui le définit l'emporte.
-
-**`llm`** — la première portée qui le définit l'emporte.
-
----
-
-## Format du fichier de configuration
-
-```json
-{
-  "enabledPolicies": [
-    "block-sudo",
-    "block-rm-rf",
-    "block-push-master",
-    "sanitize-api-keys",
-    "sanitize-jwt",
-    "block-env-files",
-    "block-read-outside-cwd"
-  ],
-  "policyParams": {
-    "block-sudo": {
-      "allowPatterns": ["sudo systemctl status", "sudo journalctl"]
-    },
-    "block-push-master": {
-      "protectedBranches": ["main", "release", "prod"]
-    },
-    "block-rm-rf": {
-      "allowPaths": ["/tmp"]
-    },
-    "block-read-outside-cwd": {
-      "allowPaths": ["/shared/data", "/opt/company"]
-    },
-    "sanitize-api-keys": {
-      "additionalPatterns": [
-        { "regex": "myco_[A-Za-z0-9]{32}", "label": "MyCo API key" }
-      ]
-    },
-    "warn-large-file-write": {
-      "thresholdKb": 512
-    }
-  },
-  "customPoliciesPath": "/home/alice/myproject/my-policies.js"
-}
-```
-
----
-
-## Référence des champs
-
-### `enabledPolicies`
-
-Type : `string[]`
-
-Liste des noms de politiques à activer. Les noms doivent correspondre exactement aux identifiants de politique affichés par `failproofai policies`. Consultez [Politiques intégrées](/fr/built-in-policies) pour la liste complète.
-
-Les politiques absentes de `enabledPolicies` sont inactives, même si elles ont des entrées dans `policyParams`.
-
-### `policyParams`
-
-Type : `Record<string, Record<string, unknown>>`
-
-Surcharges de paramètres par politique. La clé externe est le nom de la politique ; les clés internes sont spécifiques à chaque politique. Chaque politique documente ses paramètres disponibles dans [Politiques intégrées](/fr/built-in-policies).
-
-Si une politique possède des paramètres que vous ne spécifiez pas, les valeurs par défaut intégrées de la politique sont utilisées. Les utilisateurs qui ne configurent pas `policyParams` du tout obtiennent un comportement identique aux versions précédentes.
-
-Les clés inconnues dans le bloc de paramètres d'une politique sont silencieusement ignorées au moment du déclenchement du hook, mais signalées comme avertissements lors de l'exécution de `failproofai policies`.
-
-#### `hint` (transversal)
-
-Type : `string` (optionnel)
-
-Un message ajouté à la raison lorsqu'une politique retourne `deny` ou `instruct`. Utilisez-le pour donner à Claude des indications exploitables sans modifier la politique elle-même.
-
-Fonctionne avec tout type de politique — intégrée, personnalisée (`custom/`), convention de projet (`.failproofai-project/`) ou convention utilisateur (`.failproofai-user/`).
-
-```json
-{
-  "policyParams": {
-    "block-force-push": {
-      "hint": "Try creating a fresh branch instead."
-    },
-    "block-sudo": {
-      "allowPatterns": ["sudo apt-get"],
-      "hint": "Use apt-get directly without sudo."
-    },
-    "custom/my-policy": {
-      "hint": "Ask the user for approval first."
-    }
-  }
-}
-```
-
-Lorsque `block-force-push` bloque, Claude voit : *« Le push forcé est bloqué. Try creating a fresh branch instead. »*
-
-Les valeurs non-chaînes et les chaînes vides sont silencieusement ignorées. Si `hint` n'est pas défini, le comportement reste inchangé (rétrocompatible).
-
-### `customPoliciesPath`
-
-Type : `string` (chemin absolu)
-
-Chemin vers un fichier JavaScript contenant des politiques de hook personnalisées. Ce champ est défini automatiquement par `failproofai policies --install --custom <path>` (le chemin est résolu en chemin absolu avant d'être stocké).
-
-Le fichier est rechargé à chaque événement de hook — il n'y a pas de mise en cache. Consultez [Politiques personnalisées](/fr/custom-policies) pour les détails de création.
-
-### Politiques basées sur les conventions
-
-En plus du `customPoliciesPath` explicite, failproofai découvre et charge automatiquement les fichiers de politiques depuis les répertoires `.failproofai/policies/` :
-
-| Niveau | Répertoire | Portée |
-|--------|------------|--------|
-| Projet | `.failproofai/policies/` | Partagé avec l'équipe via le contrôle de version |
-| Utilisateur | `~/.failproofai/policies/` | Personnel, s'applique à tous les projets |
-
-**Correspondance de fichiers :** Seuls les fichiers correspondant à `*policies.{js,mjs,ts}` sont chargés (par exemple `security-policies.mjs`, `workflow-policies.js`). Les autres fichiers du répertoire sont ignorés.
-
-**Aucune configuration requise :** Les politiques de convention ne nécessitent aucune entrée dans `policies-config.json`. Il suffit de déposer des fichiers dans le répertoire et ils seront pris en compte au prochain événement de hook.
-
-**Chargement par union :** Les répertoires de convention du projet et de l'utilisateur sont tous deux analysés. Tous les fichiers correspondants des deux niveaux sont chargés (contrairement à `customPoliciesPath` qui utilise la règle « première portée gagnante »).
-
-Consultez [Politiques personnalisées](/fr/custom-policies) pour plus de détails et d'exemples.
-
-### `llm`
-
-Type : `object` (optionnel)
-
-Configuration du client LLM pour les politiques effectuant des appels à l'IA. Non requis dans la plupart des configurations.
-
-```json
-{
-  "llm": {
-    "model": "claude-sonnet-4-6",
-    "apiKey": "sk-ant-..."
-  }
-}
-```
-
----
-
-## Gestion de la configuration depuis la CLI
-
-Les commandes `policies --install` et `policies --uninstall` écrivent dans le fichier `settings.json` de Claude Code (les points d'entrée des hooks), tandis que `policies-config.json` est le fichier que vous gérez directement. Les deux sont distincts :
-
-- **`settings.json`** — indique à Claude Code d'appeler `failproofai --hook <event>` à chaque utilisation d'outil
-- **`policies-config.json`** — indique à failproofai quelles politiques évaluer et avec quels paramètres
-
-Vous pouvez modifier `policies-config.json` directement à tout moment ; les changements prennent effet immédiatement au prochain événement de hook, sans redémarrage nécessaire.
-
----
-
-## Exemple : configuration au niveau projet avec des valeurs par défaut d'équipe
-
-Commitez `.failproofai/policies-config.json` dans votre dépôt :
-
-```json
-{
-  "enabledPolicies": [
-    "block-sudo",
-    "block-rm-rf",
-    "block-push-master",
-    "sanitize-api-keys",
-    "block-env-files"
-  ],
-  "policyParams": {
-    "block-push-master": {
-      "protectedBranches": ["main", "release", "hotfix"]
-    }
-  }
-}
-```
-
-Chaque développeur peut ensuite créer `.failproofai/policies-config.local.json` (ignoré par git) pour des surcharges personnelles sans affecter ses coéquipiers.