Configuration locale

Failproof AI sépare ce qu’un dépôt peut committer — câblage des hooks, paramètres des politiques, politiques personnalisées — de l’état machine tel que les identifiants, les packs installés et le daemon.

Choisir une portée

La portée détermine l’endroit où les hooks sont câblés, ainsi que le fichier de configuration dans lequel vous saisissez les paramètres et les chemins de politiques personnalisées :

User s’applique à tous les projets sur cette machine.
Project appartient au dépôt et peut être committé.
Local remplace un projet pour un utilisateur donné et doit rester dans le gitignore.

failproofai policies --install --cli claude --scope project   # wire hooks for this repository
failproofai policies --install --cli claude --scope user      # or for every project on this machine
failproofai policies

Tous les harnais ne prennent pas en charge la portée locale ; la CLI rejette une portée que le harnais sélectionné ne peut pas représenter. L’activation ou la désactivation des politiques d’un pack n’est pas délimitée par une portée. Ce réglage est enregistré avec le pack installé, de sorte que failproofai policies add <name> active une politique pour toute la machine, quelle que soit la valeur de --scope.

Portée	Fichier de configuration des politiques
Project	`<project>/.failproofai/policies-config.json`
Local	`<project>/.failproofai/policies-config.local.json`
User	`~/.failproofai/policies-config.json`

Les paramètres des politiques utilisent la première portée qui définit des paramètres pour cette politique, dans l’ordre project → local → user. Les chemins de politiques personnalisées explicites utilisent la première portée qui les définit.

Configurer les paramètres des politiques

Tableau de bord
CLI

Ouvrez la politique dans le tableau de bord local, modifiez ses paramètres pris en charge et enregistrez dans la portée sélectionnée. Exécutez une action d’agent correspondante et non correspondante, puis inspectez la décision dans Observer → politique.

Modifiez le fichier policies-config.json de la portée sélectionnée, puis exécutez failproofai policies : cette commande avertit si une entrée policyParams désigne une politique qu’aucun pack installé ne contient. Elle ne vérifie pas les clés à l’intérieur d’une entrée, vérifiez donc leur orthographe par rapport au tableau ci-dessous.

{
  "policyParams": {
    "block-rm-rf": {
      "allowPaths": ["/tmp/build-output"]
    }
  }
}

failproofai policies

Paramètres acceptés par les politiques Failproof AI

Chaque politique valide ses propres types de paramètres.

Politique	Paramètre	Type et valeur par défaut
`sanitize-api-keys`	`additionalPatterns`	`pattern[]`, `[]` ; les entrées contiennent `regex` et `label`
`block-read-outside-cwd`	`allowPaths`	`string[]`, `[]`
`block-sudo`	`allowPatterns`	`string[]`, `[]`
`block-rm-rf`	`allowPaths`	`string[]`, `[]`
Bloqueurs d’infrastructure	`allowPatterns`	`string[]`, `[]`
`block-secrets-write`	`additionalPatterns`	`string[]`, `[]`
`block-push-master`	`protectedBranches`	`string[]`, `["main", "master"]`
`block-work-on-main`	`protectedBranches`	`string[]`, `["main", "master"]`
`prefer-package-manager`	`allowed`, `blocked`	`string[]`, `[]`
`warn-large-file-write`	`thresholdKb`	`number`, `1024`
`require-push-before-stop`	`remote`, `baseBranch`	`string`, `"origin"` ; `string`, `"main"`
`require-pr-before-stop`	`baseBranch`	`string`, `"main"`
`require-no-conflicts-before-stop`	`baseBranch`	`string`, `"main"`

Un motif d’autorisation élargit ce qu’un agent peut faire. Testez la tokenisation exacte et les variantes de commandes sur le harnais cible avant de le déployer sur un parc de machines.

Comprendre les fichiers machine

~/.failproofai contient des fichiers distincts pour des périmètres de confiance séparés :

Chemin	Rôle
`config.json`	Paramètres du daemon, de l’audit et de la télémétrie (sans secrets)
`credentials.json`	Identifiants cloud ; stockés avec des permissions réservées au propriétaire
`policies-config.json`	Paramètres de portée utilisateur et chemins de politiques personnalisées explicites
`policies/`	Politiques de convention utilisateur, packs installés avec indication des politiques activées, et artefacts de politiques gérés par le cloud
`hook-activity/`	Journal local des décisions de politique
`state/`	File d’attente du daemon, état de santé, pause et état d’exécution

Utilisez FAILPROOFAI_HOME pour déplacer l’intégralité de l’organisation machine vers un conteneur ou un environnement de test isolé. Ne déplacez pas des répertoires d’état individuels de manière indépendante.

Ne committez jamais credentials.json. Ne committez la configuration des politiques du projet et les politiques de convention du projet qu’après les avoir examinées en tant que code d’application.

Connect your agents

Reference

Choisir une portée

Configurer les paramètres des politiques

Paramètres acceptés par les politiques Failproof AI

Comprendre les fichiers machine

​Choisir une portée

​Configurer les paramètres des politiques

​Paramètres acceptés par les politiques Failproof AI

​Comprendre les fichiers machine

Choisir une portée

Configurer les paramètres des politiques

Paramètres acceptés par les politiques Failproof AI

Comprendre les fichiers machine