failproofai 0.0.5 → 0.0.6-beta.0

package/.next/standalone/docs/i18n/README.ar.md

@@ -25,14 +25,14 @@
 
 **الترجمات**: [简体中文](docs/i18n/README.zh.md) | [日本語](docs/i18n/README.ja.md) | [한국어](docs/i18n/README.ko.md) | [Español](docs/i18n/README.es.md) | [Português](docs/i18n/README.pt-br.md) | [Deutsch](docs/i18n/README.de.md) | [Français](docs/i18n/README.fr.md) | [Русский](docs/i18n/README.ru.md) | [हिन्दी](docs/i18n/README.hi.md) | [Türkçe](docs/i18n/README.tr.md) | [Tiếng Việt](docs/i18n/README.vi.md) | [Italiano](docs/i18n/README.it.md) | [العربية](docs/i18n/README.ar.md) | [עברית](docs/i18n/README.he.md)
 
-أسهل طريقة لإدارة السياسات التي تجعل وكلاءك الذكيين موثوقين وملتزمين بالمهام ويعملون بشكل مستقل - لـ **Claude Code** و **Agents SDK**.
+أسهل طريقة لإدارة السياسات التي تحافظ على موثوقية وكلائك الذكية وتبقيها على المسار الصحيح وتعمل بشكل مستقل - لـ **Claude Code** و **Agents SDK**.
 
-- **30 سياسة مدمجة** - اكتشف أنماط فشل الوكيل الشائعة مباشرة من الصندوق. احجب الأوامر المدمرة، ومنع تسرب الأسرار، واحتفظ بالوكلاء داخل حدود المشروع، واكتشف الحلقات، والمزيد.
-- **سياسات مخصصة** - اكتب قواعد الموثوقية الخاصة بك في JavaScript. استخدم واجهات برمجية `allow`/`deny`/`instruct` لفرض الاتفاقيات، ومنع الانجراف، وتقييد العمليات، أو الدمج مع الأنظمة الخارجية.
-- **تكوين سهل** - اضبط أي سياسة بدون كتابة أكواد. حدد قوائم السماح والفروع المحمية والحدود الدنيا لكل مشروع أو عام. يتم دمج ثلاث نطاقات للتكوين تلقائياً.
-- **مراقب الوكيل** - اطلع على ما فعله وكلاؤك أثناء غيابك. تصفح الجلسات، وافحص كل استدعاء أداة، وراجع بالضبط حيث تم تفعيل السياسات.
+- **30 سياسة مدمجة** - اكتشف أنماط فشل الوكيل الشائعة مباشرة. احجب الأوامر المدمرة، ومنع تسرب الأسرار، واحبس الوكلاء داخل حدود المشروع، واكتشف الحلقات، والمزيد.
+- **سياسات مخصصة** - اكتب قواعد موثوقيتك الخاصة في JavaScript. استخدم واجهة برمجة التطبيقات `allow`/`deny`/`instruct` لفرض الاتفاقيات، ومنع الانجراف، وحماية العمليات، أو التكامل مع الأنظمة الخارجية.
+- **تكوين سهل** - اضبط أي سياسة بدون كتابة أكواد. عيّن قوائم السماح المحمية والفروع المحمية والحدود الفردية لكل مشروع أو عالمياً. يتم دمج ثلاث نطاقات تكوينية تلقائياً.
+- **مراقب الوكيل** - شاهد ما فعله وكلاؤك أثناء غيابك. استعرض الجلسات وتفقد كل استدعاء أداة وراجع بالضبط أين تم تطبيق السياسات.
 
-كل شيء يعمل محلياً - لا تترك البيانات جهازك.
+كل شيء يعمل محلياً - لا تترك أي بيانات جهازك.
 
 ---
 
@@ -61,17 +61,17 @@ bun add -g failproofai
 failproofai policies --install
 ```
 
-يكتب إدخالات الخطاف في `~/.claude/settings.json`. سيقوم Claude Code الآن باستدعاء failproofai قبل وبعد كل استدعاء أداة.
+يكتب إدخالات الخطاف في `~/.claude/settings.json`. سيستدعي Claude Code الآن failproofai قبل وبعد كل استدعاء أداة.
 
-### 2. تشغيل لوحة التحكم
+### 2. شغّل لوحة التحكم
 
 ```bash
 failproofai
 ```
 
-يفتح `http://localhost:8020` - تصفح الجلسات، وافحص السجلات، وأدر السياسات.
+يفتح `http://localhost:8020` - استعرض الجلسات وتفقد السجلات وأدر السياسات.
 
-### 3. تحقق مما هو نشط
+### 3. تحقق من ما هو نشط
 
 ```bash
 failproofai policies
@@ -79,17 +79,17 @@ failproofai policies
 
 ---
 
-## تثبيت السياسة
+## تثبيت السياسات
 
 ### النطاقات
 
-| النطاق | الأمر | المكان الذي تكتب فيه |
-|-------|---------|-----------------|
+| النطاق | الأمر | حيث يكتب |
+|--------|--------|-----------------|
 | عام (افتراضي) | `failproofai policies --install` | `~/.claude/settings.json` |
-| المشروع | `failproofai policies --install --scope project` | `.claude/settings.json` |
+| مشروع | `failproofai policies --install --scope project` | `.claude/settings.json` |
 | محلي | `failproofai policies --install --scope local` | `.claude/settings.local.json` |
 
-### تثبيت سياسات معينة
+### تثبيت سياسات محددة
 
 ```bash
 failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
@@ -99,7 +99,7 @@ failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
 
 ```bash
 failproofai policies --uninstall
-# أو لنطاق معين:
+# أو لنطاق محدد:
 failproofai policies --uninstall --scope project
 ```
 
@@ -122,15 +122,15 @@ failproofai policies --uninstall --scope project
   "policyParams": {
     "block-sudo": {
       "allowPatterns": ["sudo systemctl status", "sudo journalctl"],
-      "hint": "Use apt-get directly without sudo."
+      "hint": "استخدم apt-get مباشرة بدون sudo."
     },
     "block-push-master": {
       "protectedBranches": ["main", "release", "prod"],
-      "hint": "Try creating a fresh branch instead."
+      "hint": "حاول إنشاء فرع جديد بدلاً من ذلك."
     },
     "sanitize-api-keys": {
       "additionalPatterns": [
-        { "regex": "myco_[A-Za-z0-9]{32}", "label": "MyCo API key" }
+        { "regex": "myco_[A-Za-z0-9]{32}", "label": "مفتاح MyCo API" }
       ]
     },
     "warn-large-file-write": {
@@ -140,39 +140,39 @@ failproofai policies --uninstall --scope project
 }
 ```
 
-**يتم دمج ثلاث نطاقات للتكوين** تلقائياً (المشروع → المحلي → العام). انظر [docs/configuration.mdx](docs/configuration.mdx) للحصول على قواعد الدمج الكاملة.
+**يتم دمج ثلاث نطاقات تكوينية** تلقائياً (مشروع → محلي → عام). انظر [docs/configuration.mdx](docs/configuration.mdx) للحصول على قواعد الدمج الكاملة.
 
 ---
 
 ## السياسات المدمجة
 
-| السياسة | الوصف | قابل للتخصيص |
+| السياسة | الوصف | قابلة للتكوين |
 |--------|-------------|:---:|
 | `block-sudo` | منع الوكلاء من تشغيل أوامر النظام المميزة | `allowPatterns` |
-| `block-rm-rf` | منع حذف الملفات العودي العرضي | `allowPaths` |
-| `block-curl-pipe-sh` | منع الوكلاء من نقل البرامج النصية غير الموثوقة إلى shell | |
-| `block-failproofai-commands` | منع إلغاء التثبيت الذاتي | |
+| `block-rm-rf` | منع حذف الملفات العودي غير المقصود | `allowPaths` |
+| `block-curl-pipe-sh` | منع الوكلاء من توجيه النصوص غير الموثوقة إلى shell | |
+| `block-failproofai-commands` | منع الإلغاء الذاتي | |
 | `sanitize-jwt` | إيقاف تسرب رموز JWT إلى سياق الوكيل | |
 | `sanitize-api-keys` | إيقاف تسرب مفاتيح API إلى سياق الوكيل | `additionalPatterns` |
 | `sanitize-connection-strings` | إيقاف تسرب بيانات اعتماد قاعدة البيانات إلى سياق الوكيل | |
-| `sanitize-private-key-content` | إعادة تحرير كتل مفاتيح PEM الخاصة من الإخراج | |
-| `sanitize-bearer-tokens` | إعادة تحرير رموز Authorization Bearer من الإخراج | |
+| `sanitize-private-key-content` | تحرير كتل المفاتيح الخاصة PEM من الإخراج | |
+| `sanitize-bearer-tokens` | تحرير رموز Bearer للمصادقة من الإخراج | |
 | `block-env-files` | منع الوكلاء من قراءة ملفات .env | |
 | `protect-env-vars` | منع الوكلاء من طباعة متغيرات البيئة | |
-| `block-read-outside-cwd` | احتفظ بالوكلاء داخل حدود المشروع | `allowPaths` |
+| `block-read-outside-cwd` | احبس الوكلاء داخل حدود المشروع | `allowPaths` |
 | `block-secrets-write` | منع الكتابة إلى ملفات المفاتيح الخاصة والشهادات | `additionalPatterns` |
-| `block-push-master` | منع الدفع العرضي إلى main/master | `protectedBranches` |
-| `block-work-on-main` | ابعد الوكلاء عن الفروع المحمية | `protectedBranches` |
+| `block-push-master` | منع الدفع غير المقصود إلى main/master | `protectedBranches` |
+| `block-work-on-main` | إبقاء الوكلاء بعيداً عن الفروع المحمية | `protectedBranches` |
 | `block-force-push` | منع `git push --force` | |
-| `warn-git-amend` | ذكر الوكلاء قبل تعديل الالتزامات | |
-| `warn-git-stash-drop` | ذكر الوكلاء قبل إسقاط المخزن المؤقت | |
+| `warn-git-amend` | تذكير الوكلاء قبل تعديل الالتزامات | |
+| `warn-git-stash-drop` | تذكير الوكلاء قبل إسقاط التخزين المؤقت | |
 | `warn-all-files-staged` | اكتشف `git add -A` العرضي | |
-| `warn-destructive-sql` | اكتشف SQL DROP/DELETE قبل التنفيذ | |
+| `warn-destructive-sql` | اكتشف DROP/DELETE SQL قبل التنفيذ | |
 | `warn-schema-alteration` | اكتشف ALTER TABLE قبل التنفيذ | |
-| `warn-large-file-write` | اكتشف كتابات الملفات الكبيرة غير المتوقعة | `thresholdKb` |
+| `warn-large-file-write` | اكتشف عمليات كتابة الملفات الكبيرة غير المتوقعة | `thresholdKb` |
 | `warn-package-publish` | اكتشف `npm publish` العرضي | |
 | `warn-background-process` | اكتشف عمليات الخلفية غير المقصودة | |
-| `warn-global-package-install` | اكتشف عمليات التثبيت العام غير المقصودة | |
+| `warn-global-package-install` | اكتشف عمليات تثبيت الحزم العامة غير المقصودة | |
 | …والمزيد | | |
 
 تفاصيل السياسة الكاملة ومرجع المعاملات: [docs/built-in-policies.mdx](docs/built-in-policies.mdx)
@@ -181,25 +181,25 @@ failproofai policies --uninstall --scope project
 
 ## السياسات المخصصة
 
-اكتب سياساتك الخاصة لجعل وكلاءك موثوقين وملتزمين بالمهام:
+اكتب سياساتك الخاصة لإبقاء وكلائك موثوقين ومركزين على المهمة:
 
 ```js
 import { customPolicies, allow, deny, instruct } from "failproofai";
 
 customPolicies.add({
   name: "no-production-writes",
-  description: "Block writes to paths containing 'production'",
+  description: "احجب الكتابة إلى المسارات التي تحتوي على 'production'",
   match: { events: ["PreToolUse"] },
   fn: async (ctx) => {
     if (!["Write", "Edit"].includes(ctx.toolName ?? "")) return allow();
     const path = ctx.toolInput?.file_path ?? "";
-    if (path.includes("production")) return deny("Writes to production paths are blocked");
+    if (path.includes("production")) return deny("الكتابة إلى مسارات الإنتاج محظورة");
     return allow();
   },
 });
 ```
 
-ثبتها باستخدام:
+ثبّت باستخدام:
 
 ```bash
 failproofai policies --install --custom ./my-policies.js
@@ -210,46 +210,46 @@ failproofai policies --install --custom ./my-policies.js
 | الدالة | التأثير |
 |----------|--------|
 | `allow()` | السماح بالعملية |
-| `allow(message)` | السماح وإرسال السياق المعلوماتي إلى Claude |
-| `deny(message)` | حظر العملية؛ الرسالة معروضة ل Claude |
-| `instruct(message)` | إضافة سياق إلى موجه Claude؛ لا تحظر |
+| `allow(message)` | السماح بالعملية وإرسال السياق المعلوماتي إلى Claude |
+| `deny(message)` | حجب العملية؛ الرسالة معروضة على Claude |
+| `instruct(message)` | أضف السياق إلى موجه Claude؛ لا يحجب |
 
 ### كائن السياق (`ctx`)
 
 | الحقل | النوع | الوصف |
 |-------|------|-------------|
-| `eventType` | `string` | `"PreToolUse"` أو `"PostToolUse"` أو `"Notification"` أو `"Stop"` |
-| `toolName` | `string` | الأداة التي يتم استدعاؤها (`"Bash"` أو `"Write"` أو `"Read"` وغيرها) |
+| `eventType` | `string` | `"PreToolUse"`، `"PostToolUse"`، `"Notification"`، `"Stop"` |
+| `toolName` | `string` | الأداة التي يتم استدعاؤها (`"Bash"`، `"Write"`، `"Read"`، …) |
 | `toolInput` | `object` | معاملات إدخال الأداة |
 | `payload` | `object` | حمولة الحدث الخام الكاملة |
-| `session.cwd` | `string` | دليل العمل لجلسة Claude Code |
-| `session.sessionId` | `string` | معرف الجلسة |
-| `session.transcriptPath` | `string` | المسار إلى ملف نص جلسة العمل |
+| `session.cwd` | `string` | دليل عمل جلسة Claude Code |
+| `session.sessionId` | `string` | معرّف الجلسة |
+| `session.transcriptPath` | `string` | مسار ملف نسخ جلسة الجلسة |
 
-تدعم الخطافات المخصصة الاستيراد المحلي العابر، والانتظار غير المتزامن، والوصول إلى `process.env`. الأخطاء مفتوحة للفشل (تسجيل في `~/.failproofai/hook.log`، استمرار السياسات المدمجة). انظر [docs/custom-hooks.mdx](docs/custom-hooks.mdx) للحصول على الدليل الكامل.
+تدعم الخطافات المخصصة الواردات المحلية العابرة والانتظار غير المتزامن والوصول إلى `process.env`. الأخطاء آمنة (مسجلة في `~/.failproofai/hook.log`، استمرار السياسات المدمجة). انظر [docs/custom-hooks.mdx](docs/custom-hooks.mdx) للحصول على الدليل الكامل.
 
-### السياسات المستندة إلى الاتفاقية
+### سياسات قائمة على الاتفاقية
 
-ضع ملفات `*policies.{js,mjs,ts}` في `.failproofai/policies/` وسيتم تحميلها تلقائياً - لا حاجة لعلم `--custom` أو تغييرات التكوين. يعمل مثل git hooks: ضع الملف، وسيعمل.
+انقل ملفات `*policies.{js,mjs,ts}` إلى `.failproofai/policies/` وسيتم تحميلها تلقائياً - لا توجد حاجة لعلم `--custom` أو تغييرات التكوين. يعمل مثل git hooks: انقل ملف، فقط يعمل.
 
 ```text
-# مستوى المشروع — يتم الالتزام به في git، مشاركة مع الفريق
+# مستوى المشروع - التزام بـ git، مشاركة مع الفريق
 .failproofai/policies/security-policies.mjs
 .failproofai/policies/workflow-policies.mjs
 
-# مستوى المستخدم — شخصي، ينطبق على جميع المشاريع
+# المستوى الشخصي - شخصي، ينطبق على جميع المشاريع
 ~/.failproofai/policies/my-policies.mjs
 ```
 
-يتم تحميل كلا المستويين (الاتحاد). يتم تحميل الملفات بترتيب أبجدي ضمن كل دليل. أضف بادئة `01-` أو `02-` وما إلى ذلك للتحكم في الترتيب. انظر [examples/convention-policies/](examples/convention-policies/) للحصول على أمثلة جاهزة للاستخدام.
+يتم تحميل كلا المستويين (اتحاد). يتم تحميل الملفات أبجدياً داخل كل دليل. بادئة مع `01-`، `02-`، إلخ للتحكم في الترتيب. انظر [examples/convention-policies/](examples/convention-policies/) للحصول على أمثلة جاهزة للاستخدام.
 
 ---
 
 ## قياس الاستخدام
 
-يجمع Failproof AI بيانات قياس الاستخدام المجهول عبر PostHog لفهم استخدام الميزات. لا يتم أبداً إرسال محتوى الجلسة أو أسماء الملفات أو مدخلات الأدوات أو المعلومات الشخصية.
+يجمع Failproof AI قياس استخدام مجهول عبر PostHog لفهم استخدام الميزات. لا يتم إرسال محتوى الجلسة أو أسماء الملفات أو إدخالات الأدوات أو المعلومات الشخصية.
 
-عطله:
+عطّله:
 
 ```bash
 FAILPROOFAI_TELEMETRY_DISABLED=1 failproofai
@@ -261,22 +261,22 @@ FAILPROOFAI_TELEMETRY_DISABLED=1 failproofai
 
 | الدليل | الوصف |
 |-------|-------------|
-| [البدء](docs/getting-started.mdx) | التثبيت والخطوات الأولى |
-| [السياسات المدمجة](docs/built-in-policies.mdx) | جميع السياسات المدمجة الـ 30 مع المعاملات |
-| [السياسات المخصصة](docs/custom-policies.mdx) | اكتب سياساتك الخاصة |
-| [التكوين](docs/configuration.mdx) | تنسيق ملف التكوين ودمج النطاق |
-| [لوحة التحكم](docs/dashboard.mdx) | مراقبة الجلسات ومراجعة نشاط السياسة |
-| [الهندسة المعمارية](docs/architecture.mdx) | كيفية عمل نظام الخطاف |
-| [الاختبار](docs/testing.mdx) | تشغيل الاختبارات وكتابة اختبارات جديدة |
+| [Getting Started](docs/getting-started.mdx) | التثبيت والخطوات الأولى |
+| [Built-in Policies](docs/built-in-policies.mdx) | جميع السياسات المدمجة الثلاثين مع المعاملات |
+| [Custom Policies](docs/custom-policies.mdx) | اكتب سياساتك الخاصة |
+| [Configuration](docs/configuration.mdx) | صيغة ملف التكوين ودمج النطاق |
+| [Dashboard](docs/dashboard.mdx) | راقب الجلسات واستعرض نشاط السياسة |
+| [Architecture](docs/architecture.mdx) | كيفية عمل نظام الخطاف |
+| [Testing](docs/testing.mdx) | تشغيل الاختبارات وكتابة اختبارات جديدة |
 
-### تشغيل التوثيق محلياً
+### شغّل التوثيق محلياً
 
 ```bash
 docker build -f Dockerfile.docs -t failproofai-docs .
 docker run --rm -p 3000:3000 failproofai-docs
 ```
 
-يفتح موقع Mintlify docs في `http://localhost:3000`. الحاوية تراقب التغييرات إذا قمت بتركيب دليل التوثيق:
+يفتح موقع Mintlify في `http://localhost:3000`. ينظر الحاوية للتغييرات إذا قمت بتثبيت دليل التوثيق:
 
 ```bash
 docker run --rm -p 3000:3000 -v $(pwd)/docs:/app/docs failproofai-docs
@@ -286,9 +286,9 @@ docker run --rm -p 3000:3000 -v $(pwd)/docs:/app/docs failproofai-docs
 
 ## ملاحظة لمساهمي failproofai
 
-يستخدم `.claude/settings.json` الخاص بهذا المستودع `bun ./bin/failproofai.mjs --hook <EventType>` بدلاً من أمر `npx -y failproofai` القياسي. وذلك لأن تشغيل `npx -y failproofai` داخل مشروع failproofai نفسه يخلق تضاربة التعريف الذاتي.
+يستخدم `.claude/settings.json` في هذا المستودع `bun ./bin/failproofai.mjs --hook <EventType>` بدلاً من أمر `npx -y failproofai` القياسي. وذلك لأن تشغيل `npx -y failproofai` داخل مشروع failproofai نفسه يخلق تضاربًا يشير إلى نفسه.
 
-بالنسبة لجميع المستودعات الأخرى، يُنصح باستخدام `npx -y failproofai`، والذي تم تثبيته عبر:
+بالنسبة لجميع المستودعات الأخرى، الطريقة الموصى بها هي `npx -y failproofai`، المثبتة عبر:
 
 ```bash
 failproofai policies --install --scope project
@@ -306,7 +306,7 @@ failproofai policies --install --scope project
 
 ---
 
-تم البناء والصيانة من قبل **ExosphereHost: مختبر البحث عن الموثوقية لوكلائك**. نساعد المؤسسات والشركات الناشئة على تحسين موثوقية وكلائهم الذكيين من خلال وكلائنا وبرامجنا وخبرتنا. تعرف على المزيد في [exosphere.host](https://exosphere.host).
+تم البناء والحفاظ عليه بواسطة **ExosphereHost: Reliability Research Lab for Your Agents**. نساعد المؤسسات والشركات الناشئة على تحسين موثوقية وكلائهم الذكية من خلال وكلائنا وبرامجنا وخبرتنا. تعرّف على المزيد في [exosphere.host](https://exosphere.host).
 
 
 </div>

package/.next/standalone/docs/i18n/README.de.md

@@ -25,10 +25,10 @@
 
 Der einfachste Weg, Richtlinien zu verwalten, die Ihre KI-Agenten zuverlässig, fokussiert und autonom am Laufen halten – für **Claude Code** & das **Agents SDK**.
 
-- **30 integrierte Richtlinien** – Häufige Fehlerquellen von Agenten werden sofort abgefangen. Destruktive Befehle blockieren, Secret-Leaks verhindern, Agenten innerhalb von Projektgrenzen halten, Schleifen erkennen und vieles mehr.
-- **Benutzerdefinierte Richtlinien** – Schreiben Sie eigene Zuverlässigkeitsregeln in JavaScript. Nutzen Sie die `allow`/`deny`/`instruct`-API, um Konventionen durchzusetzen, Drift zu verhindern, Operationen zu steuern oder externe Systeme einzubinden.
-- **Einfache Konfiguration** – Jede Richtlinie lässt sich ohne Code anpassen. Allowlists, geschützte Branches und Schwellenwerte lassen sich pro Projekt oder global festlegen. Drei Konfigurationsebenen werden automatisch zusammengeführt.
-- **Agent Monitor** – Sehen Sie, was Ihre Agenten in Ihrer Abwesenheit getan haben. Sitzungen durchsuchen, jeden Tool-Aufruf inspizieren und genau nachvollziehen, wo Richtlinien ausgelöst wurden.
+- **30 integrierte Richtlinien** – Häufige Fehlerquellen bei Agenten werden sofort abgefangen. Blockiert destruktive Befehle, verhindert das Durchsickern von Geheimnissen, hält Agenten innerhalb der Projektgrenzen, erkennt Endlosschleifen und vieles mehr.
+- **Benutzerdefinierte Richtlinien** – Schreiben Sie eigene Zuverlässigkeitsregeln in JavaScript. Nutzen Sie die `allow`/`deny`/`instruct`-API, um Konventionen durchzusetzen, Abweichungen zu verhindern, Operationen abzusichern oder externe Systeme einzubinden.
+- **Einfache Konfiguration** – Jede Richtlinie lässt sich ohne Code anpassen. Allowlists, geschützte Branches und Schwellenwerte können pro Projekt oder global festgelegt werden. Drei Konfigurationsebenen werden automatisch zusammengeführt.
+- **Agent Monitor** – Sehen Sie, was Ihre Agenten gemacht haben, während Sie weg waren. Durchsuchen Sie Sitzungen, prüfen Sie jeden Tool-Aufruf und sehen Sie genau, wo Richtlinien ausgelöst wurden.
 
 Alles läuft lokal – keine Daten verlassen Ihren Rechner.
 
@@ -37,7 +37,7 @@ Alles läuft lokal – keine Daten verlassen Ihren Rechner.
 ## Voraussetzungen
 
 - Node.js >= 20.9.0
-- Bun >= 1.3.0 (optional – nur für Entwicklung / Erstellen aus dem Quellcode erforderlich)
+- Bun >= 1.3.0 (optional – nur für die Entwicklung / das Bauen aus dem Quellcode erforderlich)
 
 ---
 
@@ -67,7 +67,7 @@ Schreibt Hook-Einträge in `~/.claude/settings.json`. Claude Code ruft failproof
 failproofai
 ```
 
-Öffnet `http://localhost:8020` – Sitzungen durchsuchen, Logs inspizieren, Richtlinien verwalten.
+Öffnet `http://localhost:8020` – Sitzungen durchsuchen, Logs einsehen, Richtlinien verwalten.
 
 ### 3. Aktive Richtlinien prüfen
 
@@ -77,12 +77,12 @@ failproofai policies
 
 ---
 
-## Richtlinien-Installation
+## Richtlinieninstallation
 
 ### Geltungsbereiche
 
-| Bereich | Befehl | Schreibort |
-|---------|--------|------------|
+| Bereich | Befehl | Speicherort |
+|---------|--------|-------------|
 | Global (Standard) | `failproofai policies --install` | `~/.claude/settings.json` |
 | Projekt | `failproofai policies --install --scope project` | `.claude/settings.json` |
 | Lokal | `failproofai policies --install --scope local` | `.claude/settings.local.json` |
@@ -97,7 +97,7 @@ failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
 
 ```bash
 failproofai policies --uninstall
-# oder für einen bestimmten Bereich:
+# oder für einen bestimmten Geltungsbereich:
 failproofai policies --uninstall --scope project
 ```
 
@@ -105,7 +105,7 @@ failproofai policies --uninstall --scope project
 
 ## Konfiguration
 
-Die Richtlinienkonfiguration befindet sich in `~/.failproofai/policies-config.json` (global) oder `.failproofai/policies-config.json` in Ihrem Projekt (projektbezogen).
+Die Richtlinienkonfiguration befindet sich in `~/.failproofai/policies-config.json` (global) oder `.failproofai/policies-config.json` in Ihrem Projekt (projektspezifisch).
 
 ```json
 {
@@ -138,14 +138,14 @@ Die Richtlinienkonfiguration befindet sich in `~/.failproofai/policies-config.js
 }
 ```
 
-**Drei Konfigurationsebenen** werden automatisch zusammengeführt (Projekt → Lokal → Global). Vollständige Zusammenführungsregeln finden Sie in [docs/configuration.mdx](docs/configuration.mdx).
+**Drei Konfigurationsebenen** werden automatisch zusammengeführt (Projekt → Lokal → Global). Vollständige Zusammenführungsregeln finden Sie unter [docs/configuration.mdx](docs/configuration.mdx).
 
 ---
 
 ## Integrierte Richtlinien
 
 | Richtlinie | Beschreibung | Konfigurierbar |
-|------------|--------------|:--------------:|
+|------------|-------------|:--------------:|
 | `block-sudo` | Verhindert, dass Agenten privilegierte Systembefehle ausführen | `allowPatterns` |
 | `block-rm-rf` | Verhindert versehentliches rekursives Löschen von Dateien | `allowPaths` |
 | `block-curl-pipe-sh` | Verhindert, dass Agenten nicht vertrauenswürdige Skripte an die Shell weiterleiten | |
@@ -153,21 +153,21 @@ Die Richtlinienkonfiguration befindet sich in `~/.failproofai/policies-config.js
 | `sanitize-jwt` | Verhindert, dass JWT-Tokens in den Agentenkontext gelangen | |
 | `sanitize-api-keys` | Verhindert, dass API-Schlüssel in den Agentenkontext gelangen | `additionalPatterns` |
 | `sanitize-connection-strings` | Verhindert, dass Datenbank-Anmeldedaten in den Agentenkontext gelangen | |
-| `sanitize-private-key-content` | Schwärzt PEM-Private-Key-Blöcke aus der Ausgabe | |
-| `sanitize-bearer-tokens` | Schwärzt Authorization-Bearer-Tokens aus der Ausgabe | |
+| `sanitize-private-key-content` | Schwärzt PEM-Privatschlüsselblöcke in der Ausgabe | |
+| `sanitize-bearer-tokens` | Schwärzt Authorization-Bearer-Tokens in der Ausgabe | |
 | `block-env-files` | Verhindert, dass Agenten .env-Dateien lesen | |
 | `protect-env-vars` | Verhindert, dass Agenten Umgebungsvariablen ausgeben | |
 | `block-read-outside-cwd` | Hält Agenten innerhalb der Projektgrenzen | `allowPaths` |
-| `block-secrets-write` | Verhindert das Schreiben in Private-Key- und Zertifikatsdateien | `additionalPatterns` |
-| `block-push-master` | Verhindert versehentliche Pushes nach main/master | `protectedBranches` |
+| `block-secrets-write` | Verhindert Schreibzugriffe auf Privatschlüssel- und Zertifikatsdateien | `additionalPatterns` |
+| `block-push-master` | Verhindert versehentliche Pushes auf main/master | `protectedBranches` |
 | `block-work-on-main` | Hält Agenten von geschützten Branches fern | `protectedBranches` |
 | `block-force-push` | Verhindert `git push --force` | |
-| `warn-git-amend` | Erinnert Agenten vor dem Ändern von Commits | |
+| `warn-git-amend` | Erinnert Agenten vor dem Amenden von Commits | |
 | `warn-git-stash-drop` | Erinnert Agenten vor dem Verwerfen von Stashes | |
 | `warn-all-files-staged` | Erkennt versehentliches `git add -A` | |
 | `warn-destructive-sql` | Erkennt DROP/DELETE-SQL vor der Ausführung | |
 | `warn-schema-alteration` | Erkennt ALTER TABLE vor der Ausführung | |
-| `warn-large-file-write` | Erkennt unerwartet große Schreibvorgänge | `thresholdKb` |
+| `warn-large-file-write` | Erkennt unerwartet große Dateischreibvorgänge | `thresholdKb` |
 | `warn-package-publish` | Erkennt versehentliches `npm publish` | |
 | `warn-background-process` | Erkennt unbeabsichtigte Starts von Hintergrundprozessen | |
 | `warn-global-package-install` | Erkennt unbeabsichtigte globale Paketinstallationen | |
@@ -197,7 +197,7 @@ customPolicies.add({
 });
 ```
 
-Installieren mit:
+Installation mit:
 
 ```bash
 failproofai policies --install --custom ./my-policies.js
@@ -209,26 +209,26 @@ failproofai policies --install --custom ./my-policies.js
 |----------|---------|
 | `allow()` | Erlaubt die Operation |
 | `allow(message)` | Erlaubt und sendet informativen Kontext an Claude |
-| `deny(message)` | Blockiert die Operation; Nachricht wird Claude angezeigt |
-| `instruct(message)` | Fügt Claude's Prompt Kontext hinzu; blockiert nicht |
+| `deny(message)` | Blockiert die Operation; Meldung wird Claude angezeigt |
+| `instruct(message)` | Fügt Claudes Prompt Kontext hinzu; blockiert nicht |
 
 ### Kontextobjekt (`ctx`)
 
 | Feld | Typ | Beschreibung |
-|------|-----|--------------|
+|------|-----|-------------|
 | `eventType` | `string` | `"PreToolUse"`, `"PostToolUse"`, `"Notification"`, `"Stop"` |
 | `toolName` | `string` | Aufgerufenes Tool (`"Bash"`, `"Write"`, `"Read"`, …) |
 | `toolInput` | `object` | Eingabeparameter des Tools |
-| `payload` | `object` | Vollständige rohe Event-Nutzdaten |
+| `payload` | `object` | Vollständiger roher Event-Payload |
 | `session.cwd` | `string` | Arbeitsverzeichnis der Claude Code-Sitzung |
-| `session.sessionId` | `string` | Sitzungskennung |
-| `session.transcriptPath` | `string` | Pfad zur Sitzungs-Transkriptdatei |
+| `session.sessionId` | `string` | Sitzungsbezeichner |
+| `session.transcriptPath` | `string` | Pfad zur Sitzungstranskriptdatei |
 
-Benutzerdefinierte Hooks unterstützen transitive lokale Importe, async/await und Zugriff auf `process.env`. Fehler sind fail-open (werden in `~/.failproofai/hook.log` protokolliert, integrierte Richtlinien laufen weiter). Eine vollständige Anleitung finden Sie unter [docs/custom-hooks.mdx](docs/custom-hooks.mdx).
+Benutzerdefinierte Hooks unterstützen transitive lokale Imports, async/await und Zugriff auf `process.env`. Fehler sind fail-open (werden in `~/.failproofai/hook.log` protokolliert, integrierte Richtlinien laufen weiter). Vollständige Anleitung unter [docs/custom-hooks.mdx](docs/custom-hooks.mdx).
 
 ### Konventionsbasierte Richtlinien
 
-Legen Sie `*policies.{js,mjs,ts}`-Dateien in `.failproofai/policies/` ab – sie werden automatisch geladen, ohne `--custom`-Flag oder Konfigurationsänderungen. Funktioniert wie Git-Hooks: Datei ablegen, fertig.
+Legen Sie `*policies.{js,mjs,ts}`-Dateien in `.failproofai/policies/` ab, und sie werden automatisch geladen – kein `--custom`-Flag oder Konfigurationsänderungen erforderlich. Funktioniert wie Git-Hooks: Datei ablegen, fertig.
 
 ```text
 # Projektebene — in Git eingecheckt, mit dem Team geteilt
@@ -239,15 +239,15 @@ Legen Sie `*policies.{js,mjs,ts}`-Dateien in `.failproofai/policies/` ab – sie
 ~/.failproofai/policies/my-policies.mjs
 ```
 
-Beide Ebenen werden geladen (Vereinigung). Dateien werden innerhalb jedes Verzeichnisses alphabetisch geladen. Verwenden Sie Präfixe wie `01-`, `02-` usw., um die Reihenfolge zu steuern. Fertige Beispiele finden Sie unter [examples/convention-policies/](examples/convention-policies/).
+Beide Ebenen werden geladen (Vereinigung). Dateien werden alphabetisch innerhalb jedes Verzeichnisses geladen. Verwenden Sie Präfixe wie `01-`, `02-` usw., um die Reihenfolge zu steuern. Gebrauchsfertige Beispiele finden Sie unter [examples/convention-policies/](examples/convention-policies/).
 
 ---
 
 ## Telemetrie
 
-Failproof AI erfasst anonyme Nutzungstelemetrie über PostHog, um das Feature-Nutzungsverhalten zu verstehen. Es werden niemals Sitzungsinhalte, Dateinamen, Tool-Eingaben oder personenbezogene Daten übermittelt.
+Failproof AI erfasst anonyme Nutzungstelemetrie über PostHog, um die Feature-Nutzung zu verstehen. Es werden niemals Sitzungsinhalte, Dateinamen, Tool-Eingaben oder persönliche Informationen übermittelt.
 
-Deaktivieren:
+Deaktivierung:
 
 ```bash
 FAILPROOFAI_TELEMETRY_DISABLED=1 failproofai
@@ -258,12 +258,12 @@ FAILPROOFAI_TELEMETRY_DISABLED=1 failproofai
 ## Dokumentation
 
 | Leitfaden | Beschreibung |
-|-----------|--------------|
+|-----------|-------------|
 | [Erste Schritte](docs/getting-started.mdx) | Installation und erste Schritte |
 | [Integrierte Richtlinien](docs/built-in-policies.mdx) | Alle 30 integrierten Richtlinien mit Parametern |
 | [Benutzerdefinierte Richtlinien](docs/custom-policies.mdx) | Eigene Richtlinien schreiben |
-| [Konfiguration](docs/configuration.mdx) | Konfigurationsdateiformat und Bereichsmerge |
-| [Dashboard](docs/dashboard.mdx) | Sitzungen überwachen und Richtlinienaktivität prüfen |
+| [Konfiguration](docs/configuration.mdx) | Konfigurationsdateiformat und Geltungsbereichs-Zusammenführung |
+| [Dashboard](docs/dashboard.mdx) | Sitzungen überwachen und Richtlinienaktivität überprüfen |
 | [Architektur](docs/architecture.mdx) | Funktionsweise des Hook-Systems |
 | [Tests](docs/testing.mdx) | Tests ausführen und neue schreiben |
 
@@ -274,7 +274,7 @@ docker build -f Dockerfile.docs -t failproofai-docs .
 docker run --rm -p 3000:3000 failproofai-docs
 ```
 
-Öffnet die Mintlify-Dokumentationsseite unter `http://localhost:3000`. Der Container erkennt Änderungen, wenn Sie das Docs-Verzeichnis einbinden:
+Öffnet die Mintlify-Dokumentationsseite unter `http://localhost:3000`. Der Container erkennt Änderungen, wenn Sie das Dokumentationsverzeichnis einbinden:
 
 ```bash
 docker run --rm -p 3000:3000 -v $(pwd)/docs:/app/docs failproofai-docs
@@ -282,9 +282,9 @@ docker run --rm -p 3000:3000 -v $(pwd)/docs:/app/docs failproofai-docs
 
 ---
 
-## Hinweis für failproofai-Mitwirkende
+## Hinweis für failproofai-Beitragende
 
-Die `.claude/settings.json` dieses Repos verwendet `bun ./bin/failproofai.mjs --hook <EventType>` anstelle des Standardbefehls `npx -y failproofai`. Der Grund: Das Ausführen von `npx -y failproofai` innerhalb des failproofai-Projekts selbst erzeugt einen selbstreferenzierenden Konflikt.
+Die `.claude/settings.json` dieses Repos verwendet `bun ./bin/failproofai.mjs --hook <EventType>` statt des standardmäßigen `npx -y failproofai`-Befehls. Das liegt daran, dass die Ausführung von `npx -y failproofai` innerhalb des failproofai-Projekts selbst einen selbstreferenzierenden Konflikt erzeugt.
 
 Für alle anderen Repos ist der empfohlene Ansatz `npx -y failproofai`, installiert über:
 
@@ -304,4 +304,4 @@ Siehe [LICENSE](LICENSE).
 
 ---
 
-Entwickelt und gepflegt von **ExosphereHost: Reliability Research Lab for Your Agents**. Wir helfen Unternehmen und Startups dabei, die Zuverlässigkeit ihrer KI-Agenten durch eigene Agenten, Software und Expertise zu verbessern. Mehr erfahren unter [exosphere.host](https://exosphere.host).
+Entwickelt und gepflegt von **ExosphereHost: Reliability Research Lab for Your Agents**. Wir helfen Unternehmen und Startups, die Zuverlässigkeit ihrer KI-Agenten durch unsere eigenen Agenten, Software und Expertise zu verbessern. Mehr erfahren Sie unter [exosphere.host](https://exosphere.host).