failproofai 0.0.6-beta.3 → 0.0.6-beta.5

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

@@ -1,47 +0,0 @@
----
-title: Richtlinien installieren
-description: "Richtlinien aktivieren, damit sie bei jedem Agenten-Tool-Aufruf ausgeführt werden"
----
-
-```bash
-failproofai policies --install [policy-names...] [options]
-```
-
-Schreibt Hook-Einträge in Claude Codes `settings.json`, damit failproofai Tool-Aufrufe abfängt.
-
-Aliase: `failproofai p -i`
-
-## Optionen
-
-| Flag | Beschreibung |
-|------|-------------|
-| `--scope user` | In `~/.claude/settings.json` installieren (Standard – alle Sitzungen) |
-| `--scope project` | In `.claude/settings.json` im aktuellen Verzeichnis installieren |
-| `--scope local` | In `.claude/settings.local.json` im aktuellen Verzeichnis installieren |
-| `--custom <path>` / `-c` | Pfad zu einer JS-Datei mit benutzerdefinierten Hook-Richtlinien |
-
-## Verhalten
-
-- **Keine Richtliniennamen** – öffnet eine interaktive Eingabeaufforderung zur Auswahl von Richtlinien
-- **Bestimmte Namen** – aktiviert diese Richtlinien (werden zu bereits aktivierten hinzugefügt)
-- **`all`** – aktiviert alle verfügbaren Richtlinien
-
-Die Installation ist additiv: Ein erneutes Ausführen von `--install` fügt neue Richtlinien hinzu, ohne bestehende zu entfernen.
-
-## Beispiele
-
-```bash
-# Alle Standard-Richtlinien global installieren (interaktiv)
-failproofai policies --install
-
-# Bestimmte Richtlinien für das aktuelle Projekt installieren
-failproofai policies --install block-sudo sanitize-api-keys --scope project
-
-# Alle Richtlinien auf einmal aktivieren
-failproofai policies --install all
-
-# Mit einer benutzerdefinierten Richtliniendatei installieren
-failproofai policies --install --custom ./my-policies.js
-```
-
-Wenn `--custom <path>` angegeben wird, wird die Datei sofort validiert – sie muss mindestens einmal `customPolicies.add()` aufrufen. Der aufgelöste Pfad wird als `customPoliciesPath` in `policies-config.json` gespeichert.

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

@@ -1,31 +0,0 @@
----
-title: Richtlinien auflisten
-description: "Anzeigen welche Richtlinien aktiviert sind, ihre Parameter und benutzerdefinierte Richtlinien"
----
-
-```bash
-failproofai policies
-```
-
-Zeigt alle Richtlinien mit ihrem Status, konfigurierten Parametern und benutzerdefinierten Richtlinien an.
-
-## Beispielausgabe
-
-```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
-```
-
-Unbekannte Schlüssel in `policyParams` werden hier markiert, damit Sie Tippfehler frühzeitig erkennen können.

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

@@ -1,43 +0,0 @@
----
-title: Richtlinien deinstallieren
-description: "Hook-Einträge aus den Einstellungen von Claude Code entfernen"
----
-
-```bash
-failproofai policies --uninstall [policy-names...] [options]
-```
-
-Entfernt failproofai-Hook-Einträge aus der `settings.json` von Claude Code.
-
-Aliase: `failproofai p -u`
-
-## Optionen
-
-| Flag | Beschreibung |
-|------|-------------|
-| `--scope user` | Aus den globalen Einstellungen entfernen (Standard) |
-| `--scope project` | Aus den Projekteinstellungen entfernen |
-| `--scope local` | Aus den lokalen Einstellungen entfernen |
-| `--scope all` | Aus allen Bereichen gleichzeitig entfernen |
-| `--custom` / `-c` | Den `customPoliciesPath` aus der Konfiguration löschen |
-
-## Verhalten
-
-- **Keine Richtliniennamen** – entfernt alle failproofai-Hook-Einträge aus der Einstellungsdatei
-- **Bestimmte Namen** – deaktiviert diese Richtlinien, behält aber die installierten Hooks bei
-
-## Beispiele
-
-```bash
-# Alle Hooks global entfernen
-failproofai policies --uninstall
-
-# Eine bestimmte Richtlinie deaktivieren (Hooks bleiben installiert)
-failproofai policies --uninstall block-sudo
-
-# Hooks aus allen Bereichen entfernen
-failproofai policies --uninstall --scope all
-
-# Pfad für benutzerdefinierte Richtlinien löschen
-failproofai policies --uninstall --custom
-```

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

@@ -1,12 +0,0 @@
----
-title: Version prüfen
-description: "Die installierte failproofai-Version ausgeben"
----
-
-```bash
-failproofai --version
-# or
-failproofai -v
-```
-
-Gibt die installierte Versionsnummer aus.

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

@@ -1,222 +0,0 @@
----
-title: Konfiguration
-description: "Konfigurationsdateiformat, Drei-Ebenen-System und Zusammenführungsregeln"
-icon: gear
----
-
-failproofai verwendet JSON-Konfigurationsdateien, um festzulegen, welche Richtlinien aktiv sind, wie sie sich verhalten und woher benutzerdefinierte Richtlinien geladen werden. Die Konfiguration ist darauf ausgelegt, einfach mit dem Team geteilt zu werden – checke sie in dein Repository ein, und jeder Entwickler profitiert vom gleichen Sicherheitsnetz für den Agenten.
-
----
-
-## Konfigurationsebenen
-
-Es gibt drei Konfigurationsebenen, die in Prioritätsreihenfolge ausgewertet werden:
-
-| Ebene | Dateipfad | Zweck |
-|-------|-----------|-------|
-| **project** | `.failproofai/policies-config.json` | Repo-spezifische Einstellungen, in die Versionskontrolle eingecheckt |
-| **local** | `.failproofai/policies-config.local.json` | Persönliche Repo-spezifische Überschreibungen, via gitignore ausgeschlossen |
-| **global** | `~/.failproofai/policies-config.json` | Benutzerweite Standardeinstellungen für alle Projekte |
-
-Wenn failproofai ein Hook-Ereignis empfängt, lädt und fügt es alle drei Dateien zusammen, die für das aktuelle Arbeitsverzeichnis vorhanden sind.
-
-### Zusammenführungsregeln
-
-**`enabledPolicies`** – die Vereinigung aller drei Ebenen. Eine Richtlinie, die auf einer beliebigen Ebene aktiviert ist, ist aktiv.
-
-```text
-project:  ["block-sudo"]
-local:    ["block-rm-rf"]
-global:   ["block-sudo", "sanitize-api-keys"]
-
-resolved: ["block-sudo", "block-rm-rf", "sanitize-api-keys"]  ← deduplizierte Vereinigung
-```
-
-**`policyParams`** – die erste Ebene, die Parameter für eine bestimmte Richtlinie definiert, gewinnt vollständig. Es findet kein tiefes Zusammenführen von Werten innerhalb der Parameter einer Richtlinie statt.
-
-```text
-project:  block-sudo → { allowPatterns: ["sudo apt-get update"] }
-global:   block-sudo → { allowPatterns: ["sudo systemctl status"] }
-
-resolved: { allowPatterns: ["sudo apt-get update"] }   ← project gewinnt, global wird ignoriert
-```
-
-```text
-project:  (kein block-sudo-Eintrag)
-local:    (kein block-sudo-Eintrag)
-global:   block-sudo → { allowPatterns: ["sudo systemctl status"] }
-
-resolved: { allowPatterns: ["sudo systemctl status"] }  ← fällt auf global zurück
-```
-
-**`customPoliciesPath`** – die erste Ebene, die diesen Wert definiert, gewinnt.
-
-**`llm`** – die erste Ebene, die diesen Wert definiert, gewinnt.
-
----
-
-## Konfigurationsdateiformat
-
-```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"
-}
-```
-
----
-
-## Feldreferenz
-
-### `enabledPolicies`
-
-Typ: `string[]`
-
-Liste der zu aktivierenden Richtliniennamen. Die Namen müssen exakt mit den Richtlinienbezeichnern übereinstimmen, die von `failproofai policies` angezeigt werden. Eine vollständige Liste findest du unter [Integrierte Richtlinien](/de/built-in-policies).
-
-Richtlinien, die nicht in `enabledPolicies` aufgeführt sind, sind inaktiv – auch wenn sie Einträge in `policyParams` haben.
-
-### `policyParams`
-
-Typ: `Record<string, Record<string, unknown>>`
-
-Richtlinienspezifische Parameterüberschreibungen. Der äußere Schlüssel ist der Richtlinienname, die inneren Schlüssel sind richtlinienspezifisch. Jede Richtlinie dokumentiert ihre verfügbaren Parameter unter [Integrierte Richtlinien](/de/built-in-policies).
-
-Wenn eine Richtlinie Parameter hat, du diese aber nicht angibst, werden die integrierten Standardwerte der Richtlinie verwendet. Benutzer, die `policyParams` gar nicht konfigurieren, erhalten identisches Verhalten wie in früheren Versionen.
-
-Unbekannte Schlüssel innerhalb des Parameterblocks einer Richtlinie werden zum Zeitpunkt der Hook-Ausführung still ignoriert, aber als Warnungen ausgegeben, wenn du `failproofai policies` ausführst.
-
-#### `hint` (übergreifend)
-
-Typ: `string` (optional)
-
-Eine Nachricht, die dem Grund hinzugefügt wird, wenn eine Richtlinie `deny` oder `instruct` zurückgibt. Verwende sie, um Claude handlungsorientierte Hinweise zu geben, ohne die Richtlinie selbst zu ändern.
-
-Funktioniert mit jedem Richtlinientyp – integriert, benutzerdefiniert (`custom/`), Projektkonvention (`.failproofai-project/`) oder Benutzerkonvention (`.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."
-    }
-  }
-}
-```
-
-Wenn `block-force-push` ablehnt, sieht Claude: *„Force-Pushing ist blockiert. Try creating a fresh branch instead."*
-
-Nicht-String-Werte und leere Zeichenfolgen werden still ignoriert. Wenn `hint` nicht gesetzt ist, bleibt das Verhalten unverändert (abwärtskompatibel).
-
-### `customPoliciesPath`
-
-Typ: `string` (absoluter Pfad)
-
-Pfad zu einer JavaScript-Datei mit benutzerdefinierten Hook-Richtlinien. Dieser Wert wird automatisch durch `failproofai policies --install --custom <path>` gesetzt (der Pfad wird vor der Speicherung in einen absoluten Pfad aufgelöst).
-
-Die Datei wird bei jedem Hook-Ereignis neu geladen – es gibt kein Caching. Einzelheiten zur Erstellung findest du unter [Benutzerdefinierte Richtlinien](/de/custom-policies).
-
-### Konventionsbasierte Richtlinien
-
-Zusätzlich zum expliziten `customPoliciesPath` erkennt und lädt failproofai automatisch Richtliniendateien aus `.failproofai/policies/`-Verzeichnissen:
-
-| Ebene | Verzeichnis | Geltungsbereich |
-|-------|-------------|-----------------|
-| Projekt | `.failproofai/policies/` | Gemeinsam mit dem Team über die Versionskontrolle |
-| Benutzer | `~/.failproofai/policies/` | Persönlich, gilt für alle Projekte |
-
-**Dateiabgleich:** Es werden nur Dateien geladen, die dem Muster `*policies.{js,mjs,ts}` entsprechen (z. B. `security-policies.mjs`, `workflow-policies.js`). Andere Dateien im Verzeichnis werden ignoriert.
-
-**Keine Konfiguration nötig:** Konventionsrichtlinien benötigen keine Einträge in `policies-config.json`. Lege die Dateien einfach im Verzeichnis ab, und sie werden beim nächsten Hook-Ereignis aufgegriffen.
-
-**Vereinigtes Laden:** Sowohl das Projekt- als auch das Benutzerkonventionsverzeichnis werden durchsucht. Alle übereinstimmenden Dateien aus beiden Ebenen werden geladen (im Gegensatz zu `customPoliciesPath`, das nach dem Prinzip „erste Ebene gewinnt" vorgeht).
-
-Weitere Details und Beispiele findest du unter [Benutzerdefinierte Richtlinien](/de/custom-policies).
-
-### `llm`
-
-Typ: `object` (optional)
-
-LLM-Client-Konfiguration für Richtlinien, die KI-Aufrufe durchführen. Für die meisten Setups nicht erforderlich.
-
-```json
-{
-  "llm": {
-    "model": "claude-sonnet-4-6",
-    "apiKey": "sk-ant-..."
-  }
-}
-```
-
----
-
-## Konfiguration über die CLI verwalten
-
-Die Befehle `policies --install` und `policies --uninstall` schreiben in Claude Codes `settings.json` (die Hook-Einstiegspunkte), während `policies-config.json` die Datei ist, die du direkt verwaltest. Beide sind voneinander getrennt:
-
-- **`settings.json`** – weist Claude Code an, bei jeder Tool-Nutzung `failproofai --hook <event>` aufzurufen
-- **`policies-config.json`** – weist failproofai an, welche Richtlinien mit welchen Parametern ausgewertet werden sollen
-
-Du kannst `policies-config.json` jederzeit direkt bearbeiten; Änderungen treten beim nächsten Hook-Ereignis sofort in Kraft – kein Neustart erforderlich.
-
----
-
-## Beispiel: Konfiguration auf Projektebene mit Team-Standardwerten
-
-Checke `.failproofai/policies-config.json` in dein Repository ein:
-
-```json
-{
-  "enabledPolicies": [
-    "block-sudo",
-    "block-rm-rf",
-    "block-push-master",
-    "sanitize-api-keys",
-    "block-env-files"
-  ],
-  "policyParams": {
-    "block-push-master": {
-      "protectedBranches": ["main", "release", "hotfix"]
-    }
-  }
-}
-```
-
-Jeder Entwickler kann dann `.failproofai/policies-config.local.json` (via gitignore ausgeschlossen) für persönliche Überschreibungen erstellen, ohne die Teammitglieder zu beeinflussen.