fix(docs): resolve translation regressions from #486 docs sync

Fixes the failing `docs` CI job (MDX parse) and the Hermes review on #487:

- ja/built-in-policies.mdx: strip 11 hallucinated `{#id}` heading-ID
  suffixes that @mdx-js/mdx (the Mintlify deploy parser) rejects with
  "Could not parse expression with acorn". English + all 13 sibling
  languages use plain headings; this restores parity and fixes CI.
- tr/cli/hook.mdx: restore the YAML frontmatter (title + description)
  dropped in re-translation — every other language kept it.
- he/configuration.mdx: restore the dropped
  `--cli claude|codex|copilot|cursor|opencode|pi|gemini|hermes` inline
  code span (the #486 change should have extended the list, not removed it).
- de/cli/auth.mdx: un-translate the inline-code placeholder
  `<E-Mail> (<Benutzer-UUID>)` back to `<email> (<user uuid>)` per the
  never-translate-inline-code rule.

Verified: `bun run validate:mdx` now passes 300/300 pages.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013k21Co2w2vLyKPhevz8HtM

Author: NiveditJain

CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.0.13-beta.2 — 2026-07-11
+
+### Docs
+- Fix translation regressions from the #486 docs sync: strip hallucinated `{#…}` heading-ID syntax that broke MDX parsing (`ja/built-in-policies`), restore dropped YAML frontmatter (`tr/cli/hook`) and the `--cli …|hermes` inline code span (`he/configuration`), and un-translate an inline-code placeholder (`de/cli/auth`). (#487)
+
 ## 0.0.13-beta.1 — 2026-07-10
 
 ### Features

docs/de/cli/auth.mdx

@@ -37,7 +37,7 @@ Widerruft die aktuelle Sitzung auf dem Server und löscht `~/.failproofai/auth.j
 failproofai auth whoami
 ```
 
-Gibt `<E-Mail> (<Benutzer-UUID>)` aus und beendet sich mit Code 0, wenn eine gültige Sitzung vorhanden ist, oder gibt `not signed in` aus und beendet sich mit Code 1. Erneuert das Zugriffstoken im Hintergrund automatisch, wenn es weniger als eine Minute bis zum Ablauf hat.
+Gibt `<email> (<user uuid>)` aus und beendet sich mit Code 0, wenn eine gültige Sitzung vorhanden ist, oder gibt `not signed in` aus und beendet sich mit Code 1. Erneuert das Zugriffstoken im Hintergrund automatisch, wenn es weniger als eine Minute bis zum Ablauf hat.
 
 ## Wiederkehrende Audit-Erinnerung
 

docs/he/configuration.mdx

@@ -202,7 +202,7 @@ resolved: { allowPatterns: ["sudo systemctl status"] }  ← יורד לכלל ה
   - **Hermes (hermes-agent)**: `~/.hermes/config.yaml` (**היקף משתמש בלבד** — Hermes אין לו תצורת פרויקט/מקומית). Hermes הוא **שער** Slack/Telegram, כך שהתקנה אחת מיירטת קריאות כלים מכל פלטפורמה (Slack/Telegram/cli/cron) **וגם** תוך-אג'נטים. רשומות Hook הן זוג `{command, timeout}` (timeout בשניות) תחת מפת `hooks:` שבאופן events snake_case של Hermes (`pre_tool_call` / `post_tool_call` / `on_session_start` / `on_session_end` / `subagent_stop`); המטפל מנרמל אירועים דרך `HERMES_EVENT_MAP` וגם שמות כלים דרך `HERMES_TOOL_MAP` כך שמדיניות מובנות נשרפות ללא שינוי. התצורה נערכת דרך תעודת YAML דורכת-שומרת-הערות `Document` כך שהגדרות אחרות של המנהל שורדות, והתקנה מוגדרת `hooks_auto_accept: true` כך השער חסר-TTY מריץ את ה-hooks ללא בקשת הסכמה. המעריך משדרת חוזה `{"decision":"block","reason"}` stdout של Hermes (Hermes מתעלם מקודי יציאה). **מגבלות:** Hermes אין להשקע stop `Stop` של turn-end, כך שה`require-*-before-stop` מובנה לעולם לא נשרפים עבורו (בלא הגבלה, לא שבור); `instruct` מדרדר ל-allow-עם-logged-note (אין ערוץ הקשר נוסף); ו-redaction-secret של פלט (`sanitize-*`) לא יכול לשכתב פלט כלים דרך חוזה shell-hook. Hermes הוא **גם** מקור ביקורת **offline** — הדשבורד קורא ישיבות שער שלו ישירות מ`~/.hermes/state.db`.
 - **`policies-config.json`** — אומר ל-failproofai איזו מדיניות להעריך ועם אילו פרמטרים (משותף על פני כל ה-CLI של ה-agent)
 
-עבור מטרה לחלק agent מסוים העבור space-separated או חוזר על כל תת-קבוצה:
+עבור `--cli claude|codex|copilot|cursor|opencode|pi|gemini|hermes` למטרה סוכן ספציפי (space-separated או חוזר לכל תת-קבוצה):
 
 ```bash
 failproofai policies --install --cli codex --scope project

docs/ja/built-in-policies.mdx

@@ -55,7 +55,7 @@ failproofai には、エージェントの一般的な障害モードを検出
 
 ---
 
-## 危険なコマンド {#dangerous-commands}
+## 危険なコマンド
 
 取り消しが困難な操作や、ホストシステムに損害を与える可能性のある操作をエージェントが実行するのを防ぎます。
 
@@ -135,7 +135,7 @@ failproofai には、エージェントの一般的な障害モードを検出
 
 ---
 
-## インフラコマンド {#infra-commands}
+## インフラコマンド
 
 コーディングエージェントがインフラ CLI を実行したり、CI/CD パイプラインをトリガーしたりするのを停止します。このカテゴリのすべてのポリシーは**オプトイン**（`defaultEnabled: false`）です。正当に `kubectl` や `terraform` などを呼び出す必要があるエージェントは、ポリシーを有効にしない限り影響を受けません。有効にすると、コマンドが `allowPatterns` のエントリにマッチしない限り、マッチした CLI のすべての呼び出しが拒否されます。
 
@@ -327,7 +327,7 @@ failproofai には、エージェントの一般的な障害モードを検出
 
 ---
 
-## シークレット（サニタイザー） {#secrets-sanitizers}
+## シークレット（サニタイザー）
 
 エージェントが認証情報をコンテキストや出力に漏洩させるのを防ぎます。サニタイザーポリシーは **PostToolUse** イベントで発火します。Claude が Bash コマンドを実行したり、ファイルを読み込んだり、ツールを呼び出したりすると、これらのポリシーは出力が Claude に返される前に検査します。シークレットパターンが検出された場合、ポリシーは出力が返されるのを防ぐ deny 決定を返します。
 
@@ -395,7 +395,7 @@ failproofai には、エージェントの一般的な障害モードを検出
 
 ---
 
-## 環境 {#environment}
+## 環境
 
 エージェントによる機密環境設定の読み取りや露出を防ぎます。
 
@@ -419,7 +419,7 @@ failproofai には、エージェントの一般的な障害モードを検出
 
 ---
 
-## ファイルアクセス {#file-access}
+## ファイルアクセス
 
 エージェントをプロジェクトの境界内に留め、機密ファイルへのアクセスを防ぎます。
 
@@ -473,7 +473,7 @@ failproofai には、エージェントの一般的な障害モードを検出
 
 ---
 
-## Git {#git}
+## Git
 
 取り消しが困難な誤ったプッシュ、強制プッシュ、ブランチミスを防ぎます。
 
@@ -565,7 +565,7 @@ failproofai には、エージェントの一般的な障害モードを検出
 
 ---
 
-## データベース {#database}
+## データベース
 
 データベースに対して実行される前に破壊的な SQL 操作を検出します。
 
@@ -587,7 +587,7 @@ failproofai には、エージェントの一般的な障害モードを検出
 
 ---
 
-## 警告 {#warnings}
+## 警告
 
 潜在的にリスクはあるが破壊的ではない操作の前に、エージェントに追加のコンテキストを提供します。
 
@@ -647,7 +647,7 @@ failproofai には、エージェントの一般的な障害モードを検出
 
 ---
 
-## パッケージマネージャー {#package-managers}
+## パッケージマネージャー
 
 エージェントが使用できるパッケージマネージャーを強制します。
 
@@ -683,7 +683,7 @@ failproofai には、エージェントの一般的な障害モードを検出
 
 ---
 
-## AI の動作 {#ai-behavior}
+## AI の動作
 
 エージェントが行き詰まったり予期しない動作をしていないかを検出します。
 
@@ -696,7 +696,7 @@ failproofai には、エージェントの一般的な障害モードを検出
 
 ---
 
-## ワークフロー {#workflow}
+## ワークフロー
 
 セッション終了時に規律あるワークフローを強制します。これらのポリシーは **Stop** イベントで発火し、各条件が満たされるまでエージェントの停止を拒否します。コミット → プッシュ → PR → CI という自然な依存チェーンに従います。ポリシーが拒否した場合、チェーン内のそれ以降のポリシーはスキップされます（deny はショートサーキット）。
 

docs/tr/cli/hook.mdx

@@ -1,3 +1,8 @@
+---
+title: Hook işleyicisi (iç)
+description: "Claude Code'un her araç etkinliğinde çağırdığı alt işlem"
+---
+
 ```bash
 failproofai --hook <EventType>
 ```