Lokale Konfiguration

Failproof AI trennt, was ein Repository committen kann – Hook-Verdrahtung, Policy-Parameter, benutzerdefinierte Policies – von Maschinenzustand wie Anmeldedaten, installierten Packs und dem Daemon.

Scope auswählen

Ein Scope legt fest, wo die Hooks verdrahtet werden und in welche Konfigurationsdatei Sie Parameter und benutzerdefinierte Policy-Pfade schreiben:

User gilt projektübergreifend auf dieser Maschine.
Project gehört zum Repository und kann committet werden.
Local überschreibt ein Projekt für einen Benutzer und sollte gitignoriert bleiben.

failproofai policies --install --cli claude --scope project   # Hooks für dieses Repository verdrahten
failproofai policies --install --cli claude --scope user      # oder für jedes Projekt auf dieser Maschine
failproofai policies

Nicht jedes Harness unterstützt den Local-Scope; die CLI lehnt einen Scope ab, den das gewählte Harness nicht abbilden kann. Welche Pack-Policies aktiviert sind, ist nicht scoped. Die Einstellung wird beim installierten Pack gespeichert, sodass failproofai policies add <name> eine Policy für die gesamte Maschine aktiviert, unabhängig von --scope.

Scope	Policy-Konfigurationsdatei
Project	`<project>/.failproofai/policies-config.json`
Local	`<project>/.failproofai/policies-config.local.json`
User	`~/.failproofai/policies-config.json`

Policy-Parameter verwenden den ersten Scope, der Parameter für diese Policy definiert, in der Reihenfolge Project → Local → User. Explizite benutzerdefinierte Policy-Pfade verwenden den ersten Scope, der sie definiert.

Policy-Parameter konfigurieren

Dashboard
CLI

Öffnen Sie die Policy im lokalen Dashboard, bearbeiten Sie die unterstützten Parameter und speichern Sie im gewählten Scope. Führen Sie eine passende und eine nicht passende Agent-Aktion aus und prüfen Sie die Entscheidung unter Observe → policy.

Bearbeiten Sie die policies-config.json des gewählten Scopes und führen Sie anschließend failproofai policies aus: Es warnt vor einem policyParams-Eintrag, der eine Policy benennt, die kein installiertes Pack enthält. Die Schlüssel innerhalb eines Eintrags werden nicht geprüft – vergleichen Sie daher deren Schreibweise mit der nachfolgenden Tabelle.

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

failproofai policies

Parameter, die die Failproof AI-Policies akzeptieren

Jede Policy validiert ihre eigenen Parametertypen.

Policy	Parameter	Typ und Standard
`sanitize-api-keys`	`additionalPatterns`	`pattern[]`, `[]`; Einträge enthalten `regex` und `label`
`block-read-outside-cwd`	`allowPaths`	`string[]`, `[]`
`block-sudo`	`allowPatterns`	`string[]`, `[]`
`block-rm-rf`	`allowPaths`	`string[]`, `[]`
Infrastructure blockers	`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"`

Ein Allow-Pattern erweitert, was ein Agent tun darf. Testen Sie die genaue Tokenisierung und Befehlsvarianten auf dem Ziel-Harness, bevor Sie es flächendeckend einsetzen.

Die Maschinendateien verstehen

~/.failproofai enthält separate Dateien für separate Vertrauensgrenzen:

Pfad	Zweck
`config.json`	Nicht-geheime Daemon-, Audit- und Telemetrie-Einstellungen
`credentials.json`	Cloud-Anmeldedaten; gespeichert mit Nur-Eigentümer-Berechtigungen
`policies-config.json`	User-Scope-Parameter und explizite benutzerdefinierte Policy-Pfade
`policies/`	Benutzer-Konventions-Policies, installierte Packs und welche ihrer Policies aktiv sind, sowie Cloud-verwaltete Policy-Artefakte
`hook-activity/`	Lokales Policy-Entscheidungsprotokoll
`state/`	Daemon-Spool, Zustand, Pause und Laufzeitstatus

Verwenden Sie FAILPROOFAI_HOME, um das gesamte Maschinen-Layout für einen Container oder einen isolierten Test zu verlagern. Verlegen Sie keine einzelnen Statusverzeichnisse unabhängig voneinander.

Committen Sie niemals credentials.json. Committen Sie Projekt-Policy-Konfigurationen und Projekt-Konventions-Policies nur, nachdem Sie diese als Durchsetzungscode geprüft haben.

Connect your agents

Reference

Scope auswählen

Policy-Parameter konfigurieren

Parameter, die die Failproof AI-Policies akzeptieren

Die Maschinendateien verstehen

​Scope auswählen

​Policy-Parameter konfigurieren

​Parameter, die die Failproof AI-Policies akzeptieren

​Die Maschinendateien verstehen

Scope auswählen

Policy-Parameter konfigurieren

Parameter, die die Failproof AI-Policies akzeptieren

Die Maschinendateien verstehen