failproofai 1.0.1-beta.0 → 1.0.1

package/.next/standalone/docs-old/de/cli/audit.mdx

@@ -0,0 +1,131 @@
+---
+title: Vergangene Sitzungen prüfen (Beta)
+description: "Zählt, wie oft der Agent in vergangenen Transkripten verschwenderische oder riskante Aktionen durchgeführt hat"
+---
+
+<Note>
+  **Beta-Funktion.** Die Audit-Funktion wird als Beta veröffentlicht, während wir erstes Feedback sammeln.
+  Der Detektor-Katalog und das Berichtsformat können sich vor dem nächsten stabilen
+  Release ändern. Bitte eröffne ein Issue, falls etwas nicht stimmt.
+</Note>
+
+Das Audit spielt vergangene Agent-CLI-Transkripte durch failproofais Policy-Engine
+und zeigt einen teilbaren, visuellen Bericht auf der **`/audit`-Dashboard-Seite** an —
+den Archetypen deines Agenten, einen Score von 0–100 und genau welche Policies
+was erkannt hätten.
+
+## Ausführen
+
+Drei Einstiegsmöglichkeiten — alle führen zum selben `/audit`-Bericht.
+
+<CodeGroup>
+
+```bash npx (no install)
+npx -y failproofai audit
+```
+
+```bash failproofai audit
+failproofai audit
+```
+
+```bash failproofai (dashboard)
+failproofai
+```
+
+</CodeGroup>
+
+<CardGroup cols={3}>
+  <Card title="Ohne Installation" icon="bolt">
+    `npx -y failproofai audit` lädt failproofai herunter, führt den Scan durch und öffnet das
+    Dashboard für dich — ohne vorherige Installation.
+  </Card>
+  <Card title="Über die CLI" icon="terminal">
+    `failproofai audit` führt den Scan im Terminal aus und öffnet
+    `localhost:8020/audit` automatisch nach Abschluss.
+  </Card>
+  <Card title="Über das Dashboard" icon="gauge">
+    Starte `failproofai` und klicke in der Navigationsleiste auf **Audit** (zwischen Policies und
+    Projects), oder öffne `/audit` direkt.
+  </Card>
+</CardGroup>
+
+<Tip>
+  Führe `failproofai audit -h` (oder `--help`) aus, um die Nutzungshinweise anzuzeigen. Das Audit läuft **vollständig
+  offline** — kein Konto oder Netzwerk erforderlich — und das Dashboard bleibt aktiv,
+  bis du es mit `Ctrl+C` beendest.
+</Tip>
+
+Das Dashboard scannt vergangene Agent-CLI-Transkripte auf diesem Rechner (Claude Code, Codex, Copilot, Cursor, OpenCode, Pi) und zeigt an, wie oft der Agent Dinge getan hat, die failproofai verhindern soll — Umgebungsvariablen-Prüfungen, Force-Pushes, redundante `cd <cwd>`-Präfixe, Sleep-Polling-Schleifen, erneutes Lesen gerade bearbeiteter Dateien und mehr.
+
+Für jedes Transkript wird jedes Tool-Use-Ereignis durch die 39 integrierten Policies **und** durch 8 audit-exklusive Detektoren wiedergegeben, die Muster erkennen, die noch nicht durch Laufzeit-Policies abgedeckt sind. Die Zählungen werden pro Policy/Detektor über alle Sitzungen hinweg aggregiert.
+
+## Was du erhältst
+
+Die `/audit`-Seite ist ein einseitiges, teilbares **Poster** gefolgt von vier weiteren Abschnitten unterhalb des sichtbaren Bereichs:
+
+1. **Poster** — die Identität deines Agenten auf einen Blick: sein **Archetyp** (einer von 8 — `optimist`, `cowboy`, `explorer`, `goldfish`, `paranoid architect`, `precision builder`, `hammer`, `ghost`), seine Persona-Schlagwörter, wie selten dieser Archetyp ist, und ein **Score von 0–100** mit einer Tier-Einstufung (`S` bis `bottom tier`). Zum Teilen gedacht — poste es auf X oder LinkedIn, oder lade es als PNG herunter.
+2. **`// strengths`** — was dein Agent bereits gut macht, als echte Zahlen aus dem Scan (z. B. Clean-Tool-Call-%, `0` Push-to-Main-Versuche), nur angezeigt, wo die betreffende Policy eine saubere Bilanz hat.
+3. **`// quirks`** — was durchgerutscht ist: eine priorisierte Tabelle mit Verhaltensweisen, die failproofai abgefangen hätte — *wann* es zuletzt passiert ist, *was durchgerutscht ist* (und das integrierte Policy, das es blockiert hätte), der *Schweregrad* und wie oft es *aufgetreten* ist (`new` / `recurring` / `N× seen`).
+4. **`// how to improve`** — die empfohlene Behebungsliste: eine Zeile pro Policy mit einem kopierbaren `failproofai policy add <slug>`, plus einem **Install all**-Button, der alle Empfehlungen auf einmal aktiviert und deinen **voraussichtlichen Score** anzeigt.
+5. **`// come back better`** — baue eine Gewohnheit auf: setze eine E-Mail-**Erinnerung** für das nächste Audit (`3d` / `7d` / `14d` / `30d`) oder starte jetzt ein erneutes Audit, und **lade einen Freund** ein, sein eigenes Audit durchzuführen (gesendet von failproof.ai, Cc an dich). Erinnerungen und Einladungen erfordern eine Anmeldung.
+
+## Geplante Audits
+
+Wenn du den **failproofaid-Daemon** ausführst (siehe [`failproofai config`](/de/cli/install-policies)),
+kann er das Audit nach einem Zeitplan für dich wiederholen und den `/audit`-Bericht im
+Hintergrund aktualisieren. Er ist **standardmäßig deaktiviert**, da der Scan den *Inhalt*
+jedes Agent-Sitzungstranskripts auf diesem Rechner liest — nichts scannt nach einem Timer,
+bis du es anforderst.
+
+Aktiviere es in `~/.failproofai/config.toml`:
+
+```toml
+[audit]
+auto = true
+interval_days = 7
+```
+
+| Schlüssel | Bedeutung |
+|---|---|
+| `auto` | `true` aktiviert den geplanten Scan. Alles andere — nicht vorhanden, `false`, `"yes"` — ist deaktiviert. |
+| `interval_days` | Tage zwischen Scans. Begrenzt auf 1–90; `0`, ein negativer Wert oder ein Nicht-Zahl-Wert fällt auf `7` zurück. |
+
+- Der Zeitplan basiert auf der **Echtzeit**, übersteht also Suspend und Neustarts: Ein Laptop,
+  der seinen fälligen Zeitpunkt im Schlafmodus verpasst hat, läuft **einmal** beim Aufwachen — ohne Rückstand.
+- Jeder Durchlauf ist ein separater Prozess mit niedriger Priorität (`nice 19`) — nie der Hook-Pfad des Daemons,
+  der frei bleibt, um Tool-Aufrufe zu beantworten.
+- Ein Scan wird übersprungen, wenn `failproofai audit` oder der erneute Durchlauf des Dashboards bereits läuft; er wird kurz danach wiederholt, anstatt als Fehler behandelt zu werden.
+- Der Fortschritt wird in `~/.failproofai/state/audit-schedule.json` gespeichert (letzter Durchlauf,
+  nächste Fälligkeit). Der Daemon besitzt diese Datei — ändere den Rhythmus in `config.toml`.
+
+<Note>
+Wenn du dies auf einem Rechner aktiviert hast, der mit einer älteren Version von failproofai eingerichtet wurde, führe
+einmalig `failproofai config` aus. Die Service-Definition des Daemons benötigt einen zusätzlichen
+Eintrag, bevor die CLI gestartet werden kann, und die Aktualisierung ist Teil dieses Befehls.
+</Note>
+
+## Audit-exklusive Detektoren
+
+Diese erkennen Muster für „dummes Verhalten", die (noch) nicht in Echtzeit erzwungen werden. Sie laufen nur während des Audits und blockieren niemals einen Live-Tool-Aufruf.
+
+| Detektor | Was gezählt wird |
+|---|---|
+| `redundant-cd-cwd` | Bash-Befehle, die mit `cd <cwd> && …` beginnen, obwohl Befehle bereits im `cwd` ausgeführt werden. |
+| `prefer-edit-over-read-cat` | `cat`/`head`/`tail`/`less`/`more` auf einer einzelnen Quelldatei — nutze stattdessen das `Read`-Tool. |
+| `prefer-edit-over-sed-awk` | In-Place-Bearbeitungen mit `sed -i` / `awk … > file` — nutze stattdessen das `Edit`-Tool. |
+| `prefer-write-over-heredoc` | Heredoc / mehrzeiliges `echo > file` zum Schreiben von Dateien — nutze stattdessen das `Write`-Tool. |
+| `sleep-polling-loop` | Langes `sleep N` (≥ 30s) oder `while …; sleep …; done`-Polling-Schleifen. |
+| `find-from-root` | `find /`, `find /home`, `find /usr` usw. — schränke auf `cwd` ein. |
+| `git-commit-no-verify` | `git commit … --no-verify` / `-n`, überspringt Hooks. |
+| `reread-after-edit` | `Read` einer Datei, die gerade in derselben Sitzung mit `Edit`/`Write` bearbeitet wurde. |
+
+## Caches
+
+- **Transkript-spezifischer Cache** unter `~/.failproofai/cache/audit/<sha1>.json`, nach `(mtime, size, engineVersion, detectorVersion)` geordnet — wird automatisch ungültig, wenn das Transkript oder der Policy-/Detektor-Code sich ändert. Jeder Eintrag enthält auch einen `cachedAt`-Zeitstempel als **TTL-Metadaten** (nicht Teil des Cache-Schlüssels); Einträge, die älter als **7 Tage** sind, werden beim Lesen abgelehnt, damit langlebige Ergebnisse nicht eine sich weiterentwickelnde Detektor-Absicht überleben.
+- **Gesamtergebnis-Cache** unter `~/.failproofai/audit-dashboard.json` (Modus 0600). Ermöglicht dem Dashboard eine sofortige Darstellung beim Navigieren ohne erneuten Scan. Wird beim Lesen nach der **7-Tage-TTL** ebenfalls abgelehnt — `/audit` fällt dann in seinen leeren Zustand zurück und fordert einen neuen Durchlauf an. Klicke unten im Bericht auf `[ re-audit now ]`, um zu aktualisieren — ein erneutes Audit sendet `noCache: true`, umgeht damit den transkript-spezifischen Cache und scannt alle Transkripte neu, anstatt das gecachte Ergebnis zurückzugeben; der Durchlauf streamt den Fortschritt über einen fixierten Top-Streifen und tauscht das Ergebnis bei Erfolg direkt aus (kein Seitenneuladn; ein fehlgeschlagenes erneutes Audit behält den vorherigen Bericht).
+
+## Hinweise
+
+- **Keine Änderungen.** Das Audit läuft im Nur-Lesen-Modus. `warn-repeated-tool-calls` wird übersprungen, da sonst der sitzungsspezifische Begleiter geändert würde.
+- **Workflow-Policies übersprungen.** `require-*-before-stop`-Policies werden nur bei `Stop`-Ereignissen ausgelöst und führen `execSync` gegen den Live-Git-Zustand aus — sie haben keine sinnvolle „Was wäre 2025 passiert"-Interpretation und erscheinen daher nicht in den Audit-Zählungen.
+- **Benutzerdefinierte Policies übersprungen.** Vom Benutzer bereitgestellte benutzerdefinierte Hooks werden nicht wiedergegeben (sie können sich seit der ursprünglichen Sitzung geändert haben).

package/.next/standalone/docs-old/de/cli/dashboard.mdx

@@ -0,0 +1,29 @@
+---
+title: Sitzungen anzeigen
+description: "Dashboard starten, um Agent-Sitzungen zu durchsuchen und Richtlinien zu verwalten"
+---
+
+```bash
+failproofai
+```
+
+Startet das Web-Dashboard unter `http://localhost:8020`.
+
+## Optionen
+
+| Flag | Beschreibung |
+|------|--------------|
+| `--port <number>` | Port, auf dem gehört wird (Standard: `8020`) |
+| `--allowed-origins <origins>` | Kommagetrennte Hosts/IPs, die auf Entwicklungsressourcen zugreifen dürfen |
+
+Um das Dashboard auf einen nicht standardmäßigen Claude-Projektordner zu verweisen, setzen Sie beim Starten die Umgebungsvariable `CLAUDE_PROJECTS_PATH`.
+
+## Beispiele
+
+```bash
+# Auf einem anderen Port starten
+failproofai --port 9000
+
+# Einen benutzerdefinierten Claude-Projektpfad über eine Umgebungsvariable verwenden
+CLAUDE_PROJECTS_PATH=~/my-claude-projects failproofai
+```

package/.next/standalone/docs-old/de/cli/environment-variables.mdx

@@ -0,0 +1,72 @@
+---
+title: Umgebungsvariablen
+description: "Verhalten von failproofai mit Umgebungsvariablen konfigurieren"
+---
+
+## Dashboard
+
+| Variable | Beschreibung |
+|----------|-------------|
+| `PORT` | Dashboard-Port (Standard: `8020`) |
+| `CLAUDE_PROJECTS_PATH` | Überschreibt den Speicherort der Claude Code-Projektordner |
+| `FAILPROOFAI_DISABLE_PAGES=policies,projects` | Kommagetrennte Liste von Dashboard-Seiten, die ausgeblendet werden sollen |
+| `FAILPROOFAI_ALLOWED_DEV_ORIGINS` | Hosts/IPs, die auf Entwicklungsressourcen zugreifen dürfen. Entspricht `--allowed-origins`. |
+
+## Protokollierung
+
+| Variable | Beschreibung |
+|----------|-------------|
+| `FAILPROOFAI_LOG_LEVEL=info\|warn\|error` | Server-Protokollierungsstufe (Standard: `warn`) |
+| `FAILPROOFAI_HOOK_LOG_FILE` | Benutzerdefinierter Pfad zur Hook-Protokolldatei oder `true` für den Standardpfad (`~/.failproofai/logs/hooks.log`) |
+
+## Telemetrie
+
+failproofai übermittelt standardmäßig anonyme Nutzungstelemetrie. Es gibt zwei Möglichkeiten,
+diese zu deaktivieren. Es gilt immer die restriktivere Einstellung – eine Umgebungsvariable
+kann niemals etwas wieder aktivieren, das in der Konfigurationsdatei deaktiviert wurde.
+
+| Variable | Beschreibung |
+|----------|-------------|
+| `FAILPROOFAI_TELEMETRY_DISABLED=1` | Anonyme Nutzungstelemetrie für diesen Prozess deaktivieren |
+
+Um die Telemetrie dauerhaft für das gesamte System zu deaktivieren, fügen Sie Folgendes zu `~/.failproofai/config.toml` hinzu:
+
+```toml
+[telemetry]
+enabled = false
+```
+
+<Note>
+Die Konfigurationsdatei ist die richtige Option, wenn Sie den **failproofaid-Daemon** betreiben.
+Der Daemon ist ein systemweiter Dienst, dessen Umgebung keine aus Ihrer Shell exportierten
+Variablen enthält – `FAILPROOFAI_TELEMETRY_DISABLED` kann ihn daher nicht erreichen.
+`[telemetry] enabled = false` wird sowohl von der CLI als auch vom Daemon gelesen.
+</Note>
+
+Der Daemon meldet ausschließlich seinen eigenen **Lebenszyklus**: ob er gestartet wurde (und ob der
+vorherige Lauf sauber beendet wurde), ob er gestoppt wurde, wann sein Auswertungs-Worker gestartet
+oder neu gestartet wurde, wann eine Collector-Aufgabe fehlgeschlagen ist sowie das Ergebnis eines
+Cloud-Policy-Abrufs. Diese Ereignisse enthalten nur wenige kategorische Werte und Zählerstände –
+niemals einen Dateipfad, einen Befehl, eine Richtlinie, einen Prompt oder andere Inhalte aus einem
+Transkript. Es gibt kein Ereignis pro Tool-Aufruf.
+
+## Authentifizierung
+
+| Variable | Beschreibung |
+|----------|-------------|
+| `FAILPROOF_API_URL` | Überschreibt die vom Dashboard-Authentifizierungsdialog verwendete API-Server-Basis-URL. Standardmäßig `https://api.befailproof.ai`; auf `http://localhost:8080` (oder einen anderen Wert) setzen, wenn ein lokaler API-Server verwendet wird. |
+| `FAILPROOFAI_AUTH_DIR` | Überschreibt den Speicherort von `auth.json` (Standard: `~/.failproofai`). Hauptsächlich für isolierte Tests nützlich. |
+
+## Erster-Start-Hinweis
+
+| Variable | Beschreibung |
+|----------|-------------|
+| `FAILPROOFAI_NO_FIRST_RUN=1` | Überspringt die Aufforderung zur Installation von Richtlinien beim ersten einfachen Aufruf von `failproofai` |
+
+## LLM (für die Richtlinienauswertung)
+
+| Variable | Beschreibung |
+|----------|-------------|
+| `FAILPROOFAI_LLM_BASE_URL` | LLM-API-Endpunkt (Standard: `https://api.openai.com/v1`) |
+| `FAILPROOFAI_LLM_API_KEY` | API-Schlüssel für LLM-gestützte Richtlinien |
+| `FAILPROOFAI_LLM_MODEL` | Modellname (Standard: `gpt-4o-mini`) |

package/.next/standalone/docs-old/de/cli/hook.mdx

@@ -0,0 +1,30 @@
+---
+title: Hook-Handler (intern)
+description: "Der Subprozess, den Claude Code bei jedem Tool-Ereignis aufruft"
+---
+
+```bash
+failproofai --hook <EventType>
+```
+
+Dies ist der Befehl, der in Claude Codes `settings.json` durch `failproofai policies --install` registriert wird. Normalerweise wird er nicht direkt aufgerufen.
+
+Liest eine JSON-Nutzlast von stdin, wertet alle aktivierten Richtlinien aus und beendet sich mit einem Code, der die Entscheidung angibt:
+
+| Exit-Code | Entscheidung | Auswirkung |
+|-----------|--------------|------------|
+| `0` | `allow` | Aktion erlauben |
+| `1` | `deny` | Aktion blockieren – Claude sieht den Ablehnungsgrund |
+| `2` | `instruct` | Anleitung in Claudes Kontext einschleusen |
+
+### Unterstützte Ereignistypen
+
+| Kategorie | Ereignisse |
+|-----------|------------|
+| **Tool-Ausführung** | `PreToolUse`, `PostToolUse`, `PostToolUseFailure`, `PermissionRequest`, `PermissionDenied` |
+| **Sitzungslebenszyklus** | `SessionStart`, `SessionEnd`, `Stop`, `StopFailure` |
+| **Benutzerinteraktion** | `UserPromptSubmit`, `Notification`, `Elicitation`, `ElicitationResult` |
+| **Subagenten & Aufgaben** | `SubagentStart`, `SubagentStop`, `TaskCreated`, `TaskCompleted`, `TeammateIdle` |
+| **Konfiguration** | `InstructionsLoaded`, `ConfigChange`, `CwdChanged` |
+| **Dateisystem** | `FileChanged`, `WorktreeCreate`, `WorktreeRemove` |
+| **Kontext** | `PreCompact`, `PostCompact` |

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

@@ -0,0 +1,57 @@
+---
+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 die Einstellungsdatei der installierten Agenten-CLI (Claude Code, OpenAI Codex oder GitHub Copilot CLI _(Beta)_), damit failproofai Tool-Aufrufe abfängt.
+
+Aliase: `failproofai p -i`
+
+## Optionen
+
+| Flag | Beschreibung |
+|------|--------------|
+| `--cli claude\|codex\|copilot` | Agenten-CLI(s), für die installiert werden soll; durch Leerzeichen getrennt (z. B. `--cli claude codex copilot`) oder wiederholt angegeben. Weglassen, um installierte CLIs zu erkennen und eine Auswahl anzuzeigen. |
+| `--scope user` | Installiert in die benutzerweite Einstellungsdatei (Claude: `~/.claude/settings.json`; Codex: `~/.codex/hooks.json`; Copilot: `~/.copilot/hooks/failproofai.json`). Standard. |
+| `--scope project` | Installiert in die projektweite Einstellungsdatei (Claude: `<cwd>/.claude/settings.json`; Codex: `<cwd>/.codex/hooks.json`; Copilot: `<cwd>/.github/hooks/failproofai.json`). |
+| `--scope local` | Nur Claude — installiert in `<cwd>/.claude/settings.local.json`. Codex und Copilot verfügen nicht über einen `local`-Bereich. |
+| `--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
+
+# Für OpenAI Codex installieren (Projektbereich)
+failproofai policies --install --cli codex --scope project
+
+# Für GitHub Copilot CLI (Beta) für das aktuelle Projekt installieren
+failproofai policies --install --cli copilot --scope project
+
+# Für alle drei CLIs gleichzeitig installieren
+failproofai policies --install --cli claude codex copilot
+```
+
+Wenn `--custom <path>` angegeben wird, wird die Datei sofort validiert – sie muss `customPolicies.add()` mindestens einmal aufrufen. Der aufgelöste Pfad wird als `customPoliciesPath` in `policies-config.json` gespeichert.

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

@@ -0,0 +1,31 @@
+---
+title: Richtlinien auflisten
+description: "Zeigt, 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-old/de/cli/migrate.mdx

@@ -0,0 +1,122 @@
+---
+title: Home-Verzeichnis migrieren
+description: "~/.failproofai auf das Layout dieser Version bringen und zunächst prüfen, was passieren würde"
+---
+
+```bash
+failproofai migrate --dry-run   # Plan ausgeben, nichts ändern
+failproofai migrate             # ausführen
+```
+
+Die meisten Personen tippen diesen Befehl nie. Er läuft automatisch beim ersten
+Befehl nach einem Upgrade, und [`failproofai update`](/de/cli/update) schließt ihn
+ein. Greifen Sie direkt darauf zurück, wenn Sie den Plan vor der Ausführung sehen
+möchten oder die Migration eigenständig durchführen wollen.
+
+## Am Layout orientiert, nicht an der Version
+
+`~/.failproofai/VERSION` speichert eine **Layout**-Nummer — die Struktur des
+Verzeichnisses, nicht das Release, das sie geschrieben hat. Migrationen werden
+anhand dieser Nummer verwaltet, was große Sprünge günstig macht:
+
+- npm-Versionen ändern sich bei jedem Release, Dutzende davon zwischen zwei Layouts.
+- Eine Maschine, die dreißig Releases mit **keiner Layout-Änderung** überspringt,
+  führt **null** Migrationen aus, nicht dreißig Leerdurchläufe.
+- Eine Maschine, die mehrere Layouts auf einmal überspringt, führt jeden Schritt
+  der Reihe nach aus, wobei jeder Schritt nur seine eigenen zwei Endpunkte kennt.
+
+Das ist wichtig, weil npm ein installiertes Paket nicht von selbst aktualisieren
+kann. Eine Maschine, die monatelang auf einer Version verharrt und dann mehrere
+Layouts auf einmal überspringt, ist der Normalfall — nicht die Ausnahme.
+
+## Der Trockenlauf
+
+`--dry-run` gibt die genaue Kette und die Dateien aus, die zuerst gesichert würden,
+und ändert überhaupt nichts — keine Migration, kein Backup, kein Ledger-Eintrag:
+
+```
+Layout 2 on disk; this build speaks 3.
+1 step(s) would run:
+  2 → 3  layout 2 → 3: carry config.toml and credentials.toml into JSON, move
+         custom-policies/ back up into policies/, nest the policy config at the root
+
+These would be copied to ~/.failproofai/migrations/backup-layout2 first:
+  VERSION
+  config.toml
+  credentials.toml
+```
+
+## Was übertragen und was neu aufgebaut wird
+
+Jeder Pfad im Home-Verzeichnis gibt an, welche Art von Daten er enthält, und das
+entscheidet, ob eine Migration ihn verwerfen darf. Die Regel: **Abgeleitete und
+neu abrufbare Daten dürfen verworfen werden; alles, was Sie getippt haben, alles
+noch nicht Zugestellte und alles, was die Maschine identifiziert, wird übertragen.**
+
+| Übertragen | Neu aufgebaut oder neu abgerufen |
+|---|---|
+| `config.json` — Einstellungen, `daemon.configured`, zusätzliche Capture-Pfade | Der Audit-Cache |
+| `credentials.json` — Ihre Cloud-Registrierung | Cloud-verwaltete Deployments (beim nächsten Poll neu abgerufen und digest-verifiziert) |
+| `policies-config.json` — Ihre Policy-Auswahl und Parameter | Daemon-Scratch-Status |
+| `policies/` — Ihre eigenen Policy-Dateien und die von ihnen importierten Hilfsdateien | |
+| `hook-activity/` — das Entscheidungsprotokoll, das das Dashboard liest | |
+| Noch nicht zugestellte Events in der Upload-Warteschlange | |
+| `cursors/` — Collector-Wasserzeichen | |
+| Das Daemon-Binary in `bin/` | |
+
+<Note>
+  Nicht zugestellte Events werden übertragen statt verworfen, weil der Verlust
+  dauerhaft wäre und nicht nur eine Verzögerung: Das Wasserzeichen des Collectors
+  ist bereits über alles hinausgegangen, was im Spool liegt, sodass dieser
+  Bereich eines Transkripts nie wieder gelesen werden würde. Die Migration fordert
+  den Daemon auch auf, das Gespoolte sofort nach Abschluss zuzustellen, sodass
+  im Normalfall nichts zu übertragen übrig bleibt.
+</Note>
+
+Schlüssel, die eine *neuere* Version in `config.json`, `credentials.json` oder
+`policies-config.json` geschrieben hat, werden ebenfalls beibehalten und nicht
+von einem älteren Leser verworfen.
+
+## Das hinterlassene Protokoll
+
+```
+~/.failproofai/migrations/
+  applied.json                 ein Eintrag pro Schritt: Layout, CLI, Zeitstempel, Dauer, Ergebnis
+  backup-layout<n>/            Kopien der unersetzlichen Dateien, vor dem ersten Schritt erstellt
+```
+
+`applied.json` beantwortet die Frage „Was hat diese Maschine tatsächlich
+durchgemacht" — die erste Frage, die sich stellt, wenn nach einem Upgrade etwas
+nicht stimmt. Fügen Sie sie einem Bug-Report bei.
+
+Das Backup ist bewusst klein gehalten statt eine Kopie des gesamten Verzeichnisses
+zu sein: Die Migration löscht per Design nichts Unersetzliches mehr, sodass das
+Absichernswerte ein *Defekt in einem Schritt* ist — und diese wenigen Dateien sind
+es, wo ein solcher Defekt schaden würde.
+
+## Wenn ein Schritt fehlschlägt
+
+Die Kette stoppt an dieser Stelle. `VERSION` wird nur von einem erfolgreich
+abgeschlossenen Schritt aktualisiert, sodass das Home mit seinem alten Layout
+markiert bleibt und der nächste Befehl es erneut versucht — ein Home wird nie
+auf Basis einer unvollständigen Migration als aktuell markiert. Der Schritt wird
+in `applied.json` mit `"ok": false` eingetragen, und das Backup befindet sich
+dort, wo es erstellt wurde.
+
+## Ein neueres Home wird abgelehnt, nicht migriert
+
+Wenn `~/.failproofai/` von einer **neueren** failproofai-Version geschrieben wurde
+als der aktuell verwendeten, stoppt der Befehl und fordert Sie auf, stattdessen
+ein Upgrade durchzuführen. Diese Daten sind in Ordnung und eine neuere CLI liest
+sie; eine Migration „vorwärts" davon existiert nicht, und ein Reset würde etwas
+Wiederherstellbares zerstören.
+
+```
+This machine's failproofai directory was written by a newer version (layout 4;
+this build speaks 3). Upgrade rather than migrate:
+  npm install -g failproofai@latest
+```
+
+Der Daemon wendet dieselbe Regel an: `failproofaid` verweigert den Start mit einem
+Layout, das er nicht kennt, anstatt Pfade zu lesen und zu schreiben, die
+verschoben wurden.

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

@@ -0,0 +1,43 @@
+---
+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.
+
+Aliasse: `failproofai p -u`
+
+## Optionen
+
+| Flag | Beschreibung |
+|------|-------------|
+| `--scope user` | Aus globalen Einstellungen entfernen (Standard) |
+| `--scope project` | Aus Projekteinstellungen entfernen |
+| `--scope local` | Aus lokalen Einstellungen entfernen |
+| `--scope all` | Aus allen Geltungsbereichen 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 Geltungsbereichen entfernen
+failproofai policies --uninstall --scope all
+
+# Pfad für benutzerdefinierte Richtlinien löschen
+failproofai policies --uninstall --custom
+```

package/.next/standalone/docs-old/de/cli/update.mdx

@@ -0,0 +1,75 @@
+---
+title: Aktualisierung nach einem Upgrade
+description: "Die andere Hälfte eines Upgrades abschließen, die npm nicht erledigen kann: Home migrieren und Daemon angleichen"
+---
+
+```bash
+npm install -g failproofai@latest && failproofai update
+```
+
+Das ist das vollständige Upgrade. `npm` ersetzt die CLI; `failproofai update` erledigt den Rest.
+
+## Warum ein zweiter Befehl nötig ist
+
+`npm install -g` ersetzt genau eine Sache — die CLI. Zwei weitere Bestandteile einer failproofai-Installation befinden sich bewusst außerhalb des Pakets und werden beim Ausführen von npm nicht aktualisiert:
+
+- **`~/.failproofai/`**, Ihre Einstellungen, Cloud-Registrierung, Richtlinienauswahl und -verlauf. Eine neue Version kann diese Daten anders organisieren, und die Reorganisation muss durch Code erfolgen, der beide Strukturen kennt.
+- **Das `failproofaid`-Daemon-Binary**, unter `~/.failproofai/bin/failproofaid-<version>`. Es befindet sich absichtlich *nicht* in `node_modules`: Ein Upgrade, das die Datei unter einem laufenden Dienst austauscht, würde einen aktiven Daemon auf ein Binary umleiten, das aus anderem Quellcode erstellt wurde. Würde das Paket entfernt, würde das Binary unter dem Dienst weggezogen, der dann bei jedem Start abstürzt.
+
+Nach einem alleinigen `npm install -g` ist also die CLI neu, der Daemon jedoch nicht. `failproofaid` verweigert den Start bei einem Home-Layout, das er nicht versteht — die laute Variante dieses Missverhältnisses, nicht die stille — daher müssen beide Hälften zusammengeführt werden. `failproofai update` ist dieser Schritt.
+
+## Was der Befehl tut
+
+<Steps>
+  <Step title="Ausstehende Layout-Migrationen ausführen">
+    Liest das in `~/.failproofai/VERSION` gespeicherte Layout und führt die Schritte aus, die
+    es auf das Layout der aktuellen Version bringen. Meistens ist das nicht nötig — siehe
+    [`failproofai migrate`](/de/cli/migrate).
+  </Step>
+  <Step title="Passendes Daemon-Binary einspielen">
+    Wenn möglich aus dem Plattformpaket, das npm bereits heruntergeladen hat (kein Netzwerk
+    erforderlich), andernfalls aus dem Release-Asset für genau diese Version — SHA-256-verifiziert,
+    bevor es verwendet wird.
+  </Step>
+  <Step title="Dienst neu starten und Verfügbarkeit bestätigen">
+    Durch aktive Prüfung, nicht durch Annahme — ein Dienst-Manager meldet einen Prozess als aktiv,
+    sobald er geforkt wird, was nicht dasselbe ist wie ein funktionierender Prozess.
+  </Step>
+</Steps>
+
+## Optionen
+
+| Flag | Wirkung |
+|------|---------|
+| `--no-daemon` | Nur das Home migrieren, den Daemon bei seiner aktuellen Version belassen. |
+
+<Warning>
+  `--no-daemon` belässt einen versionsinkonsistenten Daemon. Auf einem Rechner, der für den
+  Daemon-Betrieb konfiguriert ist, **schlägt jedes Hook-Ereignis fehlgesichert fehl**, wenn der
+  Daemon nicht antwortet — und ein Daemon, der den Start gegen ein migriertes Home verweigert,
+  kann nicht antworten. Es empfiehlt sich, auch den Daemon-Teil laufen zu lassen.
+</Warning>
+
+## Bei Problemen
+
+Der Befehl beendet sich mit einem Fehlercode und gibt an, welche Hälfte fehlgeschlagen ist. Zwei wichtige Fälle:
+
+- **Ein Migrationsschritt wurde nicht abgeschlossen.** Das Home bleibt mit dem *alten* Layout markiert, sodass der nächste Befehl es erneut versucht — ein Home wird nie als aktuell markiert, wenn die Migration nur teilweise abgeschlossen wurde. Kopien Ihrer Einstellungen und Registrierung wurden vor dem Start gespeichert, unter `~/.failproofai/migrations/backup-layout<n>/`.
+- **Der Daemon konnte ohne Passwort nicht neu gestartet werden.** `sudo -n` wird bewusst verwendet, damit kein Passwortprompt während einer Fortschrittsanzeige erscheint. Der Befehl gibt die genaue Zeile aus, die Sie selbst ausführen müssen.
+
+<Note>
+  Für nichts davon wird der interaktive Einrichtungsassistent benötigt. Ihre Einstellungen,
+  Cloud-Registrierung und Richtlinienauswahl überstehen ein Upgrade, sodass ein migrierter
+  Rechner genau so durchsetzt wie zuvor — was besonders auf Rechnern wichtig ist, an denen
+  niemand sitzt: ein CI-Runner, ein Fleet-Rechner, ein headless Gateway.
+</Note>
+
+## Automatisierung
+
+`failproofai update` ist nicht-interaktiv und sicher auszuführen, wenn nichts zu tun ist — es gibt „no migration was needed" aus und beendet sich mit 0. Der empfohlene Einsatz ist, den Befehl nach jedem Upgrade in einem Provisionierungs-Skript oder Dockerfile hinzuzufügen:
+
+```dockerfile
+RUN npm install -g failproofai@latest && failproofai update --no-daemon
+```
+
+(`--no-daemon` beim Image-Build, wo noch kein Dienst zum Neustarten vorhanden ist.)

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

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