failproofai 0.0.2 → 0.0.4-beta.0

package/.next/standalone/docs/ar/built-in-policies.mdx

@@ -0,0 +1,537 @@
+---
+title: السياسات المدمجة
+description: "جميع 30 سياسة مدمجة تلتقط أنماط فشل الوكلاء الشائعة"
+icon: shield
+---
+
+يأتي failproofai مع 30 سياسة مدمجة تلتقط أنماط فشل الوكلاء الشائعة. تنشط كل سياسة على نوع حدث hook معين واسم أداة معين. تقبل تسع سياسات معاملات تتيح لك ضبط سلوكها دون كتابة أكواد. تطبق أربع سياسات سير عمل خط أنابيب commit → push → PR → CI قبل توقف Claude.
+
+---
+
+## نظرة عامة
+
+يتم تجميع السياسات في فئات:
+
+| الفئة | السياسات | نوع Hook |
+|----------|----------|-----------|
+| [الأوامر الخطرة](#dangerous-commands) | block-sudo, block-rm-rf, block-curl-pipe-sh, block-failproofai-commands | PreToolUse |
+| [الأسرار (معقمات)](#secrets-sanitizers) | sanitize-jwt, sanitize-api-keys, sanitize-connection-strings, sanitize-private-key-content, sanitize-bearer-tokens | PostToolUse |
+| [البيئة](#environment) | block-env-files, protect-env-vars | PreToolUse |
+| [الوصول إلى الملفات](#file-access) | block-read-outside-cwd, block-secrets-write | PreToolUse |
+| [Git](#git) | block-push-master, block-work-on-main, block-force-push, warn-git-amend, warn-git-stash-drop, warn-all-files-staged | PreToolUse |
+| [قاعدة البيانات](#database) | warn-destructive-sql, warn-schema-alteration | PreToolUse |
+| [التحذيرات](#warnings) | warn-large-file-write, warn-package-publish, warn-background-process, warn-global-package-install | PreToolUse |
+| [سير العمل](#workflow) | require-commit-before-stop, require-push-before-stop, require-pr-before-stop, require-ci-green-before-stop | Stop |
+
+- **`block-`** — إيقاف الوكيل من المتابعة.
+- **`warn-`** — إعطاء الوكيل سياق إضافي حتى يتمكن من التصحيح الذاتي.
+- **`sanitize-`** — مسح البيانات الحساسة من مخرجات الأداة قبل أن يراها الوكيل.
+- **`require-`** — حجب حدث Stop حتى تستوفى الشروط.
+
+---
+
+<Tip>
+كل سياسة تدعم حقل `hint` اختياري في `policyParams`. يتم إضافة التلميح إلى رسالة الرفض أو التعليمات التي يراها Claude، مما يوفر إرشادات قابلة للتنفيذ دون تعديل كود السياسة. يعمل مع السياسات المدمجة والمخصصة وسياسات الاتفاقية. راجع [التكوين → hint](/ar/configuration#hint-cross-cutting) للحصول على التفاصيل.
+</Tip>
+
+---
+
+## الأوامر الخطرة
+
+منع الوكلاء من تشغيل العمليات التي يصعب التراجع عنها أو التي قد تضر بنظام المضيف.
+
+### `block-sudo`
+
+**الحدث:** PreToolUse (Bash)  
+**الافتراضي:** يرفض أي أمر `sudo`.
+
+يحجب الاستدعاءات التي تتضمن كلمة المفتاح `sudo`. يتم تطابق النمط على رموز الأوامر المحللة، وليس السلسلة الخام، لمنع التجاوز عبر حقن عامل shell.
+
+**المعاملات:**
+
+| المعامل | النوع | الافتراضي | الوصف |
+|-------|------|---------|-------------|
+| `allowPatterns` | `string[]` | `[]` | بادئات الأوامر الدقيقة المسموحة. يتم مطابقة كل إدخال مقابل رموز argv المحللة. |
+
+**مثال:**
+
+```json
+{
+  "policyParams": {
+    "block-sudo": {
+      "allowPatterns": ["sudo systemctl status", "sudo journalctl"]
+    }
+  }
+}
+```
+
+مع هذا التكوين، يُسمح بـ `sudo systemctl status nginx`، لكن `sudo rm /etc/hosts` مرفوض.
+
+<Note>
+يتم مطابقة الأنماط مقابل الرموز المحللة، وليس سلسلة الأمر الخام. يمنع التجاوز عبر عوامل shell المدرجة (على سبيل المثال، `sudo systemctl status x; rm -rf /` لا يطابق `sudo systemctl status *`).
+</Note>
+
+---
+
+### `block-rm-rf`
+
+**الحدث:** PreToolUse (Bash)  
+**الافتراضي:** يرفض `rm -rf`, `rm -fr`، والأشكال الأخرى المشابهة لحذف العودة.
+
+**المعاملات:**
+
+| المعامل | النوع | الافتراضي | الوصف |
+|-------|------|---------|-------------|
+| `allowPaths` | `string[]` | `[]` | المسارات الآمنة للحذف العودي (على سبيل المثال `/tmp`). |
+
+**مثال:**
+
+```json
+{
+  "policyParams": {
+    "block-rm-rf": {
+      "allowPaths": ["/tmp", "/var/cache"]
+    }
+  }
+}
+```
+
+---
+
+### `block-curl-pipe-sh`
+
+**الحدث:** PreToolUse (Bash)  
+**الافتراضي:** يرفض `curl <url> | bash`، `curl <url> | sh`، `wget <url> | bash`، والأنماط المشابهة.
+
+بدون معاملات.
+
+---
+
+### `block-failproofai-commands`
+
+**الحدث:** PreToolUse (Bash)  
+**الافتراضي:** يرفض الأوامر التي ستقوم بإلغاء تثبيت أو تعطيل failproofai نفسه (على سبيل المثال `npm uninstall failproofai`، `failproofai policies --uninstall`).
+
+بدون معاملات.
+
+---
+
+## الأسرار (معقمات)
+
+منع الوكلاء من تسرب بيانات اعتماد إلى سياقهم أو مخرجاتهم. تنشط سياسات المعقم على أحداث **PostToolUse**. عندما يقوم Claude بتشغيل أمر Bash أو قراءة ملف أو استدعاء أي أداة، تفحص هذه السياسات المخرجات قبل إرجاعها إلى Claude. إذا تم الكشف عن نمط سري، تُرجع السياسة قرار رفض يمنع إرجاع المخرجات.
+
+### `sanitize-jwt`
+
+**الحدث:** PostToolUse (جميع الأدوات)  
+**الافتراضي:** يحذف رموز JWT (ثلاث مقاطع base64url مفصولة بـ `.`).
+
+بدون معاملات.
+
+---
+
+### `sanitize-api-keys`
+
+**الحدث:** PostToolUse (جميع الأدوات)  
+**الافتراضي:** يحذف تنسيقات مفاتيح API الشائعة: Anthropic (`sk-ant-`)، OpenAI (`sk-`)، GitHub PATs (`ghp_`)، مفاتيح الوصول AWS (`AKIA`)، مفاتيح Stripe (`sk_live_`, `sk_test_`)، ومفاتيح Google API (`AIza`).
+
+**المعاملات:**
+
+| المعامل | النوع | الافتراضي | الوصف |
+|-------|------|---------|-------------|
+| `additionalPatterns` | `{ regex: string; label: string }[]` | `[]` | أنماط regex إضافية يتم التعامل معها كأسرار. |
+
+**مثال:**
+
+```json
+{
+  "policyParams": {
+    "sanitize-api-keys": {
+      "additionalPatterns": [
+        { "regex": "myco_[A-Za-z0-9]{32}", "label": "MyCo internal API key" },
+        { "regex": "pat_[0-9a-f]{40}", "label": "Internal PAT" }
+      ]
+    }
+  }
+}
+```
+
+---
+
+### `sanitize-connection-strings`
+
+**الحدث:** PostToolUse (جميع الأدوات)  
+**الافتراضي:** يحذف سلاسل اتصال قاعدة البيانات التي تحتوي على بيانات اعتماد مضمنة (على سبيل المثال `postgresql://user:password@host/db`).
+
+بدون معاملات.
+
+---
+
+### `sanitize-private-key-content`
+
+**الحدث:** PostToolUse (جميع الأدوات)  
+**الافتراضي:** يحذف كتل PEM (`-----BEGIN PRIVATE KEY-----`، `-----BEGIN RSA PRIVATE KEY-----`، إلخ).
+
+بدون معاملات.
+
+---
+
+### `sanitize-bearer-tokens`
+
+**الحدث:** PostToolUse (جميع الأدوات)  
+**الافتراضي:** يحذف رؤوس `Authorization: Bearer <token>` حيث يكون الرمز 20 حرفًا أو أكثر.
+
+بدون معاملات.
+
+---
+
+## البيئة
+
+حماية تكوين البيئة الحساسة من قراءتها أو تعريضها من قبل الوكلاء.
+
+### `block-env-files`
+
+**الحدث:** PreToolUse (Bash, Read)  
+**الافتراضي:** يرفض قراءة ملفات `.env` عبر `cat .env`، استدعاءات أداة Read مع `.env` كمسار الملف، إلخ.
+
+لا يحجب `.envrc` أو ملفات أخرى مجاورة للبيئة - فقط الملفات المسماة بالضبط `.env`.
+
+بدون معاملات.
+
+---
+
+### `protect-env-vars`
+
+**الحدث:** PreToolUse (Bash)  
+**الافتراضي:** يرفض الأوامر التي تطبع متغيرات البيئة: `printenv`، `env`، `echo $VAR`.
+
+بدون معاملات.
+
+---
+
+## الوصول إلى الملفات
+
+إبقاء الوكلاء يعملون داخل حدود المشروع بعيدًا عن الملفات الحساسة.
+
+### `block-read-outside-cwd`
+
+**الحدث:** PreToolUse (Read, Bash)  
+**الافتراضي:** يرفض قراءة الملفات خارج دليل العمل الحالي (جذر المشروع).
+
+**المعاملات:**
+
+| المعامل | النوع | الافتراضي | الوصف |
+|-------|------|---------|-------------|
+| `allowPaths` | `string[]` | `[]` | بادئات المسار المطلق المسموحة حتى لو كانت خارج cwd. |
+
+**مثال:**
+
+```json
+{
+  "policyParams": {
+    "block-read-outside-cwd": {
+      "allowPaths": ["/shared/data", "/opt/company/config"]
+    }
+  }
+}
+```
+
+---
+
+### `block-secrets-write`
+
+**الحدث:** PreToolUse (Write, Edit)  
+**الافتراضي:** يرفض الكتابة إلى الملفات المستخدمة بشكل شائع للمفاتيح الخاصة والشهادات: `id_rsa`، `id_ed25519`، `*.key`، `*.pem`، `*.p12`، `*.pfx`.
+
+**المعاملات:**
+
+| المعامل | النوع | الافتراضي | الوصف |
+|-------|------|---------|-------------|
+| `additionalPatterns` | `string[]` | `[]` | أنماط اسم ملف إضافية (على نمط glob) للحجب. |
+
+**مثال:**
+
+```json
+{
+  "policyParams": {
+    "block-secrets-write": {
+      "additionalPatterns": [".token", ".secret"]
+    }
+  }
+}
+```
+
+---
+
+## Git
+
+منع الدفع العرضي والدفع القسري والأخطاء في الفروع التي يصعب التراجع عنها.
+
+### `block-push-master`
+
+**الحدث:** PreToolUse (Bash)  
+**الافتراضي:** يرفض `git push origin main` و `git push origin master`.
+
+**المعاملات:**
+
+| المعامل | النوع | الافتراضي | الوصف |
+|-------|------|---------|-------------|
+| `protectedBranches` | `string[]` | `["main", "master"]` | أسماء الفروع التي لا يمكن الدفع إليها مباشرة. |
+
+**مثال:**
+
+```json
+{
+  "policyParams": {
+    "block-push-master": {
+      "protectedBranches": ["main", "master", "release", "prod"]
+    }
+  }
+}
+```
+
+<Tip>
+للسماح بالدفع إلى جميع الفروع (تعطيل هذه السياسة بشكل فعال دون إزالتها من `enabledPolicies`)، اضبط `protectedBranches: []`.
+</Tip>
+
+---
+
+### `block-work-on-main`
+
+**الحدث:** PreToolUse (Bash)  
+**الافتراضي:** يرفض الانتقال إلى فروع `main` أو `master` مباشرة.
+
+**المعاملات:**
+
+| المعامل | النوع | الافتراضي | الوصف |
+|-------|------|---------|-------------|
+| `protectedBranches` | `string[]` | `["main", "master"]` | أسماء الفروع التي لا يمكن الانتقال إليها مباشرة. |
+
+---
+
+### `block-force-push`
+
+**الحدث:** PreToolUse (Bash)  
+**الافتراضي:** يرفض `git push --force` و `git push -f`.
+
+بدون معاملات خاصة بالسياسة. استخدم التقاطع [`hint`](/ar/configuration#hint-cross-cutting) لاقتراح بدائل:
+
+```json
+{
+  "policyParams": {
+    "block-force-push": {
+      "hint": "Create a new branch from your current HEAD (e.g. `git checkout -b <new-branch>`) and push that instead."
+    }
+  }
+}
+```
+
+---
+
+### `warn-git-amend`
+
+**الحدث:** PreToolUse (Bash)  
+**الافتراضي:** يرشد Claude للمتابعة بحذر عند تشغيل `git commit --amend`. لا يحجب الأمر.
+
+بدون معاملات.
+
+---
+
+### `warn-git-stash-drop`
+
+**الحدث:** PreToolUse (Bash)  
+**الافتراضي:** يرشد Claude لتأكيد قبل تشغيل `git stash drop`. لا يحجب الأمر.
+
+بدون معاملات.
+
+---
+
+### `warn-all-files-staged`
+
+**الحدث:** PreToolUse (Bash)  
+**الافتراضي:** يرشد Claude لمراجعة ما يختزنه عند تشغيل `git add -A` أو `git add .`. لا يحجب الأمر.
+
+بدون معاملات.
+
+---
+
+## قاعدة البيانات
+
+اكتش العمليات SQL المدمرة قبل تنفيذها ضد قاعدة البيانات الخاصة بك.
+
+### `warn-destructive-sql`
+
+**الحدث:** PreToolUse (Bash)  
+**الافتراضي:** يرشد Claude للتأكيد قبل تشغيل SQL التي تحتوي على `DROP TABLE`، `DROP DATABASE`، أو `DELETE` بدون بند `WHERE`.
+
+بدون معاملات.
+
+---
+
+### `warn-schema-alteration`
+
+**الحدث:** PreToolUse (Bash)  
+**الافتراضي:** يرشد Claude للتأكيد قبل تشغيل عبارات `ALTER TABLE`.
+
+بدون معاملات.
+
+---
+
+## التحذيرات
+
+إعطاء الوكلاء سياق إضافي قبل العمليات المحتملة الخطورة ولكن غير المدمرة.
+
+### `warn-large-file-write`
+
+**الحدث:** PreToolUse (Write)  
+**الافتراضي:** يرشد Claude للتأكيد قبل كتابة الملفات الأكبر من 1024 كيلوبايت.
+
+**المعاملات:**
+
+| المعامل | النوع | الافتراضي | الوصف |
+|-------|------|---------|-------------|
+| `thresholdKb` | `number` | `1024` | عتبة حجم الملف بالكيلوبايت التي يتم فوقها إصدار تحذير. |
+
+**مثال:**
+
+```json
+{
+  "policyParams": {
+    "warn-large-file-write": {
+      "thresholdKb": 256
+    }
+  }
+}
+```
+
+<Note>
+يفرض معالج hook حد أقصى 1 ميجابايت stdin على الحمولات. لاختبار هذه السياسة بمحتوى صغير، اضبط `thresholdKb` على قيمة أقل بكثير من 1024.
+</Note>
+
+---
+
+### `warn-package-publish`
+
+**الحدث:** PreToolUse (Bash)  
+**الافتراضي:** يرشد Claude للتأكيد قبل تشغيل `npm publish`.
+
+بدون معاملات.
+
+---
+
+### `warn-background-process`
+
+**الحدث:** PreToolUse (Bash)  
+**الافتراضي:** يرشد Claude ليكون حذرًا عند إطلاق العمليات في الخلفية عبر `nohup`، `&`، `disown`، أو `screen`.
+
+بدون معاملات.
+
+---
+
+### `warn-global-package-install`
+
+**الحدث:** PreToolUse (Bash)  
+**الافتراضي:** يرشد Claude للتأكيد قبل تشغيل `npm install -g`، `yarn global add`، أو `pip install` دون بيئة افتراضية.
+
+بدون معاملات.
+
+---
+
+## سلوك الذكاء الاصطناعي
+
+اكتشف عندما يعلق الوكلاء أو يتصرفون بشكل غير متوقع.
+
+### `warn-repeated-tool-calls`
+
+**الحدث:** PreToolUse (جميع الأدوات)  
+**الافتراضي:** يرشد Claude لإعادة النظر عند استدعاء نفس الأداة 3 مرات أو أكثر مع معاملات متطابقة - علامة شائعة على أن الوكيل عالق في حلقة.
+
+بدون معاملات.
+
+---
+
+## سير العمل
+
+فرض سير عمل منضبط لنهاية الجلسة. تنشط هذه السياسات على حدث **Stop** وترفض Claude من التوقف حتى تستوفى كل شرط. يتبعون سلسلة اعتماد طبيعية: commit → push → PR → CI. إذا رفضت سياسة، يتم تجاوز السياسات اللاحقة في السلسلة (الرفض يقصر الدارة).
+
+جميع سياسات سير العمل **fail-open**: إذا كانت الأداة المطلوبة غير متاحة (على سبيل المثال `gh` غير مثبت، لا يوجد git remote)، تسمح السياسة برسالة معلوماتية تشرح سبب تخطي الفحص.
+
+### `require-commit-before-stop`
+
+**الحدث:** Stop  
+**الافتراضي:** يرفض التوقف عند وجود تغييرات غير مطبقة (ملفات معدلة أو مرحلة أو غير متتبعة). يرجع رسالة معلوماتية عند نظافة دليل العمل.
+
+بدون معاملات.
+
+---
+
+### `require-push-before-stop`
+
+**الحدث:** Stop  
+**الافتراضي:** يرفض التوقف عند وجود commits غير مدفوعة أو عندما لا يكون للفرع الحالي فرع تتبع بعيد. يقترح `git push -u` لإنشاء فرع تتبع إذا لزم الأمر. يفشل مفتوح إذا لم يتم تكوين أي بعيد.
+
+**المعاملات:**
+
+| المعامل | النوع | الافتراضي | الوصف |
+|-------|------|---------|-------------|
+| `remote` | `string` | `"origin"` | اسم البعيد للدفع إليه. |
+
+**مثال:**
+
+```json
+{
+  "policyParams": {
+    "require-push-before-stop": {
+      "remote": "upstream"
+    }
+  }
+}
+```
+
+---
+
+### `require-pr-before-stop`
+
+**الحدث:** Stop  
+**الافتراضي:** يرفض التوقف عند عدم وجود pull request للفرع الحالي، أو عندما يكون PR الموجود مغلقًا/مدمجًا. يرشد Claude لإنشاء PR باستخدام `gh pr create`.
+
+بدون معاملات.
+
+<Note>
+تتطلب هذه السياسة تثبيت [GitHub CLI](https://cli.github.com/) (`gh`) والمصادقة عليه.
+قم بتشغيل `gh auth login` برمز وصول شخصي يتمتع بنطاق `repo` للقراءة
+pull requests. إذا لم يتم تثبيت `gh` أو لم يتم المصادقة عليه، تفشل السياسة مفتوحة وتبلغ السبب إلى Claude.
+</Note>
+
+---
+
+### `require-ci-green-before-stop`
+
+**الحدث:** Stop  
+**الافتراضي:** يرفض التوقف عند فشل فحوصات CI أو لا تزال تعمل على الفرع الحالي. يتحقق من سير عمل GitHub Actions وفحوصات bot جهات خارجية (على سبيل المثال CodeRabbit, SonarCloud, Codecov). يتعامل مع استنتاجات `skipped` كنجاح. يرجع رسالة معلوماتية عند نجاح جميع الفحوصات.
+
+بدون معاملات.
+
+<Note>
+تتطلب هذه السياسة تثبيت [GitHub CLI](https://cli.github.com/) (`gh`) والمصادقة عليه.
+قم بتشغيل `gh auth login` برمز وصول شخصي يتمتع بنطاق `repo` للقراءة
+Actions workflow runs و Checks API. إذا لم يتم تثبيت `gh` أو لم يتم المصادقة عليه، تفشل السياسة مفتوحة وتبلغ السبب إلى Claude.
+</Note>
+
+---
+
+---
+
+## تعطيل السياسات الفردية
+
+أزل سياسة معينة من `enabledPolicies` في تكوينك، أو أوقفها في علامة التبويب Policies في لوحة البيانات.
+
+```json
+{
+  "enabledPolicies": [
+    "block-rm-rf",
+    "sanitize-api-keys"
+  ]
+}
+```
+
+لا تعمل السياسات غير المدرجة في `enabledPolicies`، حتى لو كانت هناك إدخالات `policyParams` لها.

package/.next/standalone/docs/ar/cli/dashboard.mdx

@@ -0,0 +1,28 @@
+---
+title: عرض الجلسات
+description: "قم بتشغيل لوحة التحكم لتصفح جلسات الوكيل وإدارة السياسات"
+---
+
+```bash
+failproofai
+```
+
+يبدأ لوحة التحكم الويب على `http://localhost:8020`.
+
+## الخيارات
+
+| الراية | الوصف |
+|------|-------------|
+| `--port <number>` | المنفذ المراد الاستماع عليه (الافتراضي: `8020`) |
+| `--projects-path <path>` | تجاوز المسار الذي يتم البحث فيه عن مجلدات مشاريع Claude Code |
+| `--allowed-origins <origins>` | المضيفين/عناوين IP المفصولة بفواصل المسموح بها للوصول إلى موارد التطوير |
+
+## أمثلة
+
+```bash
+# قم بالتشغيل على منفذ مختلف
+failproofai --port 9000
+
+# استخدم مسار مشاريع مخصص
+failproofai --projects-path ~/my-claude-projects
+```

package/.next/standalone/docs/ar/cli/environment-variables.mdx

@@ -0,0 +1,34 @@
+---
+title: متغيرات البيئة
+description: "تكوين سلوك failproofai باستخدام متغيرات البيئة"
+---
+
+## لوحة التحكم
+
+| المتغير | الوصف |
+|----------|-------------|
+| `PORT` | منفذ لوحة التحكم (الافتراضي: `8020`) |
+| `CLAUDE_PROJECTS_PATH` | تجاوز موقع مجلدات مشاريع Claude Code |
+| `FAILPROOFAI_DISABLE_PAGES=policies,projects` | صفحات لوحة التحكم المراد إخفاؤها مفصولة بفواصل |
+| `FAILPROOFAI_ALLOWED_DEV_ORIGINS` | المضيفون/عناوين IP المسموح لهم بالوصول إلى موارد التطوير. نفس خيار `--allowed-origins`. |
+
+## تسجيل السجلات
+
+| المتغير | الوصف |
+|----------|-------------|
+| `FAILPROOFAI_LOG_LEVEL=info\|warn\|error` | مستوى سجل الخادم (الافتراضي: `warn`) |
+| `FAILPROOFAI_HOOK_LOG_FILE` | مسار ملف سجل hook مخصص، أو `true` للاستخدام الافتراضي (`~/.failproofai/logs/hooks.log`) |
+
+## قياس الاستخدام
+
+| المتغير | الوصف |
+|----------|-------------|
+| `FAILPROOFAI_TELEMETRY_DISABLED=1` | تعطيل قياس الاستخدام المجهول |
+
+## نموذج اللغة الكبير (لتقييم السياسات)
+
+| المتغير | الوصف |
+|----------|-------------|
+| `FAILPROOFAI_LLM_BASE_URL` | نقطة نهاية API لنموذج اللغة الكبير (الافتراضي: `https://api.openai.com/v1`) |
+| `FAILPROOFAI_LLM_API_KEY` | مفتاح API للسياسات المعتمدة على نموذج اللغة الكبير |
+| `FAILPROOFAI_LLM_MODEL` | اسم النموذج (الافتراضي: `gpt-4o-mini`) |

package/.next/standalone/docs/ar/cli/hook.mdx

@@ -0,0 +1,31 @@
+---
+---
+title: معالج Hook (داخلي)
+description: "العملية الفرعية التي يستدعيها Claude Code في كل حدث أداة"
+---
+
+```bash
+failproofai --hook <EventType>
+```
+
+هذا هو الأمر المسجل في `settings.json` الخاص بـ Claude Code بواسطة `failproofai policies --install`. عادة لا تستدعيه مباشرة.
+
+يقرأ حمولة JSON من stdin، ويقيّم جميع السياسات المفعّلة، ويخرج برمز يشير إلى القرار:
+
+| رمز الخروج | القرار | التأثير |
+|-----------|--------|--------|
+| `0` | `allow` | السماح بالإجراء |
+| `1` | `deny` | حظر الإجراء - يرى Claude سبب الحظر |
+| `2` | `instruct` | إدراج إرشادات في سياق Claude |
+
+### أنواع الأحداث المدعومة
+
+| الفئة | الأحداث |
+|-------|--------|
+| **تنفيذ الأداة** | `PreToolUse`, `PostToolUse`, `PostToolUseFailure`, `PermissionRequest`, `PermissionDenied` |
+| **دورة حياة الجلسة** | `SessionStart`, `SessionEnd`, `Stop`, `StopFailure` |
+| **التفاعل مع المستخدم** | `UserPromptSubmit`, `Notification`, `Elicitation`, `ElicitationResult` |
+| **الوكلاء الفرعيون والمهام** | `SubagentStart`, `SubagentStop`, `TaskCreated`, `TaskCompleted`, `TeammateIdle` |
+| **التكوين** | `InstructionsLoaded`, `ConfigChange`, `CwdChanged` |
+| **نظام الملفات** | `FileChanged`, `WorktreeCreate`, `WorktreeRemove` |
+| **السياق** | `PreCompact`, `PostCompact` |

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

@@ -0,0 +1,48 @@
+---
+---
+title: تثبيت السياسات
+description: "تفعيل السياسات لتعمل على كل استدعاء أداة للوكيل"
+---
+
+```bash
+failproofai policies --install [policy-names...] [options]
+```
+
+يكتب مدخلات الخطاف في `settings.json` الخاص بـ Claude Code بحيث يعترض failproofai استدعاءات الأدوات.
+
+الأسماء المختصرة: `failproofai p -i`
+
+## الخيارات
+
+| العلم | الوصف |
+|------|--------|
+| `--scope user` | التثبيت في `~/.claude/settings.json` (الافتراضي - جميع الجلسات) |
+| `--scope project` | التثبيت في `.claude/settings.json` في المجلد الحالي |
+| `--scope local` | التثبيت في `.claude/settings.local.json` في المجلد الحالي |
+| `--custom <path>` / `-c` | المسار إلى ملف JS يحتوي على سياسات الخطاف المخصصة |
+
+## السلوك
+
+- **بدون أسماء سياسات** - يفتح موجه تفاعلي لاختيار السياسات
+- **أسماء محددة** - يفعّل تلك السياسات (مضافة إلى أي سياسات مفعّلة بالفعل)
+- **`all`** - يفعّل كل السياسات المتاحة
+
+التثبيت إضافي: تشغيل `--install` مرة أخرى يضيف سياسات جديدة دون إزالة السياسات الموجودة.
+
+## أمثلة
+
+```bash
+# تثبيت جميع السياسات الافتراضية عالميًا (تفاعلي)
+failproofai policies --install
+
+# تثبيت سياسات محددة للمشروع الحالي
+failproofai policies --install block-sudo sanitize-api-keys --scope project
+
+# تفعيل جميع السياسات دفعة واحدة
+failproofai policies --install all
+
+# التثبيت مع ملف سياسات مخصص
+failproofai policies --install --custom ./my-policies.js
+```
+
+عند توفير `--custom <path>`، يتم التحقق من الملف فورًا - يجب أن يستدعي `customPolicies.add()` مرة واحدة على الأقل. يتم حفظ المسار المحلول في `policies-config.json` باسم `customPoliciesPath`.