failproofai 0.0.3 → 0.0.4

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

@@ -1,12 +1,10 @@
----
-
 ---
 title: السياسات المدمجة
-description: "جميع السياسات 30 المدمجة التي تلتقط أنماط فشل الوكيل الشائعة"
+description: "جميع 30 سياسة مدمجة تلتقط أنماط فشل الوكلاء الشائعة"
 icon: shield
 ---
 
-يأتي failproofai مع 30 سياسة مدمجة تلتقط أنماط فشل الوكيل الشائعة. تُطلق كل سياسة على حدث ربط معين واسم أداة محدد. تقبل تسع سياسات معاملات تتيح لك ضبط سلوكها دون كتابة أي كود. أربع سياسات سير عمل بيتا تفرض خط أنابيب commit → push → PR → CI قبل توقف Claude.
+يأتي failproofai مع 30 سياسة مدمجة تلتقط أنماط فشل الوكلاء الشائعة. تنشط كل سياسة على نوع حدث hook معين واسم أداة معين. تقبل تسع سياسات معاملات تتيح لك ضبط سلوكها دون كتابة أكواد. تطبق أربع سياسات سير عمل خط أنابيب commit → push → PR → CI قبل توقف Claude.
 
 ---
 
@@ -14,26 +12,26 @@ icon: shield
 
 يتم تجميع السياسات في فئات:
 
-| الفئة | السياسات | نوع الربط |
-|-------|---------|---------|
+| الفئة | السياسات | نوع 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 |
+| [الأسرار (معقمات)](#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-beta) | require-commit-before-stop, require-push-before-stop, require-pr-before-stop, require-ci-green-before-stop | Stop |
+| [التحذيرات](#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-`** — مسح البيانات الحساسة من مخرجات الأداة قبل رؤية Claude.
-- **`require-`** — منع حدث التوقف حتى تتحقق الشروط.
+- **`block-`** — إيقاف الوكيل من المتابعة.
+- **`warn-`** — إعطاء الوكيل سياق إضافي حتى يتمكن من التصحيح الذاتي.
+- **`sanitize-`** — مسح البيانات الحساسة من مخرجات الأداة قبل أن يراها الوكيل.
+- **`require-`** — حجب حدث Stop حتى تستوفى الشروط.
 
 ---
 
 <Tip>
-تدعم كل سياسة حقل اختياري `hint` في `policyParams`. يتم إلحاق التلميح برسالة الرفض أو التعليمات التي يراها Claude، مما يوفر إرشادات قابلة للتنفيذ دون تعديل كود السياسة. يعمل مع السياسات المدمجة والمخصصة وسياسات الاتفاقية. راجع [الإعدادات → hint](/ar/configuration#hint-cross-cutting) للحصول على التفاصيل.
+كل سياسة تدعم حقل `hint` اختياري في `policyParams`. يتم إضافة التلميح إلى رسالة الرفض أو التعليمات التي يراها Claude، مما يوفر إرشادات قابلة للتنفيذ دون تعديل كود السياسة. يعمل مع السياسات المدمجة والمخصصة وسياسات الاتفاقية. راجع [التكوين → hint](/ar/configuration#hint-cross-cutting) للحصول على التفاصيل.
 </Tip>
 
 ---
@@ -47,13 +45,13 @@ icon: shield
 **الحدث:** PreToolUse (Bash)  
 **الافتراضي:** يرفض أي أمر `sudo`.
 
-يحظر الاستدعاءات التي تتضمن كلمة مفتاح `sudo`. يتم القيام بمطابقة النمط على رموز الأوامر المحللة، وليس السلسلة الخام، لمنع الالتفاف عبر حقن عامل shell.
+يحجب الاستدعاءات التي تتضمن كلمة المفتاح `sudo`. يتم تطابق النمط على رموز الأوامر المحللة، وليس السلسلة الخام، لمنع التجاوز عبر حقن عامل shell.
 
 **المعاملات:**
 
 | المعامل | النوع | الافتراضي | الوصف |
-|--------|-------|---------|-------|
-| `allowPatterns` | `string[]` | `[]` | بادئات الأوامر الدقيقة المسموح بها. يتم مطابقة كل إدخال مقابل رموز argv المحللة. |
+|-------|------|---------|-------------|
+| `allowPatterns` | `string[]` | `[]` | بادئات الأوامر الدقيقة المسموحة. يتم مطابقة كل إدخال مقابل رموز argv المحللة. |
 
 **مثال:**
 
@@ -67,10 +65,10 @@ icon: shield
 }
 ```
 
-مع هذا الإعداد، يُسمح بـ `sudo systemctl status nginx`، لكن يتم رفض `sudo rm /etc/hosts`.
+مع هذا التكوين، يُسمح بـ `sudo systemctl status nginx`، لكن `sudo rm /etc/hosts` مرفوض.
 
 <Note>
-يتم مطابقة الأنماط مقابل الرموز المحللة، وليس سلسلة الأمر الخام. هذا يمنع الالتفاف عبر عوامل shell الملحقة (على سبيل المثال `sudo systemctl status x; rm -rf /` لا تتطابق مع `sudo systemctl status *`).
+يتم مطابقة الأنماط مقابل الرموز المحللة، وليس سلسلة الأمر الخام. يمنع التجاوز عبر عوامل shell المدرجة (على سبيل المثال، `sudo systemctl status x; rm -rf /` لا يطابق `sudo systemctl status *`).
 </Note>
 
 ---
@@ -78,13 +76,13 @@ icon: shield
 ### `block-rm-rf`
 
 **الحدث:** PreToolUse (Bash)  
-**الافتراضي:** يرفض `rm -rf`، `rm -fr` وأشكال الحذف التكراري المماثلة.
+**الافتراضي:** يرفض `rm -rf`, `rm -fr`، والأشكال الأخرى المشابهة لحذف العودة.
 
 **المعاملات:**
 
 | المعامل | النوع | الافتراضي | الوصف |
-|--------|-------|---------|-------|
-| `allowPaths` | `string[]` | `[]` | المسارات التي يمكن حذفها بشكل آمن بشكل متكرر (على سبيل المثال `/tmp`). |
+|-------|------|---------|-------------|
+| `allowPaths` | `string[]` | `[]` | المسارات الآمنة للحذف العودي (على سبيل المثال `/tmp`). |
 
 **مثال:**
 
@@ -103,43 +101,43 @@ icon: shield
 ### `block-curl-pipe-sh`
 
 **الحدث:** PreToolUse (Bash)  
-**الافتراضي:** يرفض `curl <url> | bash`، `curl <url> | sh`، `wget <url> | bash` وأنماط مماثلة.
+**الافتراضي:** يرفض `curl <url> | bash`، `curl <url> | sh`، `wget <url> | bash`، والأنماط المشابهة.
 
-لا توجد معاملات.
+بدون معاملات.
 
 ---
 
 ### `block-failproofai-commands`
 
 **الحدث:** PreToolUse (Bash)  
-**الافتراضي:** يرفض الأوامر التي قد تلغي التثبيت أو تعطل failproofai نفسه (على سبيل المثال `npm uninstall failproofai`، `failproofai policies --uninstall`).
+**الافتراضي:** يرفض الأوامر التي ستقوم بإلغاء تثبيت أو تعطيل failproofai نفسه (على سبيل المثال `npm uninstall failproofai`، `failproofai policies --uninstall`).
 
-لا توجد معاملات.
+بدون معاملات.
 
 ---
 
-## الأسرار (مُنظّفات)
+## الأسرار (معقمات)
 
-منع الوكلاء من تسريب بيانات الاعتماد إلى السياق أو المخرجات. تُطلق سياسات المُنظّفات على أحداث **PostToolUse**. عندما يقوم Claude بتشغيل أمر Bash، أو قراءة ملف، أو استدعاء أي أداة، تفحص هذه السياسات المخرجات قبل إرجاعها إلى Claude. إذا تم اكتشاف نمط سري، تُرجع السياسة قرار رفض يمنع من مرور المخرجات.
+منع الوكلاء من تسرب بيانات اعتماد إلى سياقهم أو مخرجاتهم. تنشط سياسات المعقم على أحداث **PostToolUse**. عندما يقوم Claude بتشغيل أمر Bash أو قراءة ملف أو استدعاء أي أداة، تفحص هذه السياسات المخرجات قبل إرجاعها إلى Claude. إذا تم الكشف عن نمط سري، تُرجع السياسة قرار رفض يمنع إرجاع المخرجات.
 
 ### `sanitize-jwt`
 
 **الحدث:** PostToolUse (جميع الأدوات)  
-**الافتراضي:** يحذف رموز JWT (ثلاث أجزاء base64url مفصولة بـ `.`).
+**الافتراضي:** يحذف رموز 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`).
+**الافتراضي:** يحذف تنسيقات مفاتيح 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 إضافية يتم التعامل معها كأسرار. |
 
 **مثال:**
@@ -164,7 +162,7 @@ icon: shield
 **الحدث:** PostToolUse (جميع الأدوات)  
 **الافتراضي:** يحذف سلاسل اتصال قاعدة البيانات التي تحتوي على بيانات اعتماد مضمنة (على سبيل المثال `postgresql://user:password@host/db`).
 
-لا توجد معاملات.
+بدون معاملات.
 
 ---
 
@@ -173,31 +171,31 @@ icon: shield
 **الحدث:** PostToolUse (جميع الأدوات)  
 **الافتراضي:** يحذف كتل PEM (`-----BEGIN PRIVATE KEY-----`، `-----BEGIN RSA PRIVATE KEY-----`، إلخ).
 
-لا توجد معاملات.
+بدون معاملات.
 
 ---
 
 ### `sanitize-bearer-tokens`
 
 **الحدث:** PostToolUse (جميع الأدوات)  
-**الافتراضي:** يحذف رؤوس `Authorization: Bearer <token>` حيث يكون الرمز 20 أو أكثر من الأحرف.
+**الافتراضي:** يحذف رؤوس `Authorization: Bearer <token>` حيث يكون الرمز 20 حرفًا أو أكثر.
 
-لا توجد معاملات.
+بدون معاملات.
 
 ---
 
 ## البيئة
 
-حماية إعدادات البيئة الحساسة من القراءة أو الكشف من قبل الوكلاء.
+حماية تكوين البيئة الحساسة من قراءتها أو تعريضها من قبل الوكلاء.
 
 ### `block-env-files`
 
-**الحدث:** PreToolUse (Bash، Read)  
-**الافتراضي:** يرفض قراءة ملفات `.env` عبر `cat .env`، استدعاءات أداة `Read` مع `.env` كمسار الملف، إلخ.
+**الحدث:** PreToolUse (Bash, Read)  
+**الافتراضي:** يرفض قراءة ملفات `.env` عبر `cat .env`، استدعاءات أداة Read مع `.env` كمسار الملف، إلخ.
 
-لا يحجب `.envrc` أو ملفات أخرى مجاورة للبيئة - فقط الملفات المسماة بدقة `.env`.
+لا يحجب `.envrc` أو ملفات أخرى مجاورة للبيئة - فقط الملفات المسماة بالضبط `.env`.
 
-لا توجد معاملات.
+بدون معاملات.
 
 ---
 
@@ -206,24 +204,24 @@ icon: shield
 **الحدث:** PreToolUse (Bash)  
 **الافتراضي:** يرفض الأوامر التي تطبع متغيرات البيئة: `printenv`، `env`، `echo $VAR`.
 
-لا توجد معاملات.
+بدون معاملات.
 
 ---
 
 ## الوصول إلى الملفات
 
-حفاظ على الوكلاء يعملون داخل حدود المشروع بعيداً عن الملفات الحساسة.
+إبقاء الوكلاء يعملون داخل حدود المشروع بعيدًا عن الملفات الحساسة.
 
 ### `block-read-outside-cwd`
 
-**الحدث:** PreToolUse (Read، Bash)  
+**الحدث:** PreToolUse (Read, Bash)  
 **الافتراضي:** يرفض قراءة الملفات خارج دليل العمل الحالي (جذر المشروع).
 
 **المعاملات:**
 
 | المعامل | النوع | الافتراضي | الوصف |
-|--------|-------|---------|-------|
-| `allowPaths` | `string[]` | `[]` | بادئات المسار المطلق المسموح بها حتى لو كانت خارج cwd. |
+|-------|------|---------|-------------|
+| `allowPaths` | `string[]` | `[]` | بادئات المسار المطلق المسموحة حتى لو كانت خارج cwd. |
 
 **مثال:**
 
@@ -241,14 +239,14 @@ icon: shield
 
 ### `block-secrets-write`
 
-**الحدث:** PreToolUse (Write، Edit)  
+**الحدث:** PreToolUse (Write, Edit)  
 **الافتراضي:** يرفض الكتابة إلى الملفات المستخدمة بشكل شائع للمفاتيح الخاصة والشهادات: `id_rsa`، `id_ed25519`، `*.key`، `*.pem`، `*.p12`، `*.pfx`.
 
 **المعاملات:**
 
 | المعامل | النوع | الافتراضي | الوصف |
-|--------|-------|---------|-------|
-| `additionalPatterns` | `string[]` | `[]` | أنماط اسم ملف إضافية على نمط glob يتم حجبها. |
+|-------|------|---------|-------------|
+| `additionalPatterns` | `string[]` | `[]` | أنماط اسم ملف إضافية (على نمط glob) للحجب. |
 
 **مثال:**
 
@@ -276,7 +274,7 @@ icon: shield
 **المعاملات:**
 
 | المعامل | النوع | الافتراضي | الوصف |
-|--------|-------|---------|-------|
+|-------|------|---------|-------------|
 | `protectedBranches` | `string[]` | `["main", "master"]` | أسماء الفروع التي لا يمكن الدفع إليها مباشرة. |
 
 **مثال:**
@@ -292,7 +290,7 @@ icon: shield
 ```
 
 <Tip>
-للسماح بالدفع إلى جميع الفروع (تعطيل هذه السياسة بشكل فعلي دون إزالتها من `enabledPolicies`)، اضبط `protectedBranches: []`.
+للسماح بالدفع إلى جميع الفروع (تعطيل هذه السياسة بشكل فعال دون إزالتها من `enabledPolicies`)، اضبط `protectedBranches: []`.
 </Tip>
 
 ---
@@ -300,13 +298,13 @@ icon: shield
 ### `block-work-on-main`
 
 **الحدث:** PreToolUse (Bash)  
-**الافتراضي:** يرفض الخروج إلى فروع `main` أو `master` مباشرة.
+**الافتراضي:** يرفض الانتقال إلى فروع `main` أو `master` مباشرة.
 
 **المعاملات:**
 
 | المعامل | النوع | الافتراضي | الوصف |
-|--------|-------|---------|-------|
-| `protectedBranches` | `string[]` | `["main", "master"]` | أسماء الفروع التي لا يمكن الخروج إليها مباشرة. |
+|-------|------|---------|-------------|
+| `protectedBranches` | `string[]` | `["main", "master"]` | أسماء الفروع التي لا يمكن الانتقال إليها مباشرة. |
 
 ---
 
@@ -315,7 +313,7 @@ icon: shield
 **الحدث:** PreToolUse (Bash)  
 **الافتراضي:** يرفض `git push --force` و `git push -f`.
 
-لا توجد معاملات محددة للسياسة. استخدم [`hint`](/ar/configuration#hint-cross-cutting) الشامل للاقتراح بدائل:
+بدون معاملات خاصة بالسياسة. استخدم التقاطع [`hint`](/ar/configuration#hint-cross-cutting) لاقتراح بدائل:
 
 ```json
 {
@@ -332,66 +330,66 @@ icon: shield
 ### `warn-git-amend`
 
 **الحدث:** PreToolUse (Bash)  
-**الافتراضي:** يوجه Claude للمتابعة بحذر عند تشغيل `git commit --amend`. لا يحجب الأمر.
+**الافتراضي:** يرشد Claude للمتابعة بحذر عند تشغيل `git commit --amend`. لا يحجب الأمر.
 
-لا توجد معاملات.
+بدون معاملات.
 
 ---
 
 ### `warn-git-stash-drop`
 
 **الحدث:** PreToolUse (Bash)  
-**الافتراضي:** يوجه Claude للتأكيد قبل تشغيل `git stash drop`. لا يحجب الأمر.
+**الافتراضي:** يرشد Claude لتأكيد قبل تشغيل `git stash drop`. لا يحجب الأمر.
 
-لا توجد معاملات.
+بدون معاملات.
 
 ---
 
 ### `warn-all-files-staged`
 
 **الحدث:** PreToolUse (Bash)  
-**الافتراضي:** يوجه Claude لمراجعة ما يقوم بتحضيره عند تشغيل `git add -A` أو `git add .`. لا يحجب الأمر.
+**الافتراضي:** يرشد Claude لمراجعة ما يختزنه عند تشغيل `git add -A` أو `git add .`. لا يحجب الأمر.
 
-لا توجد معاملات.
+بدون معاملات.
 
 ---
 
 ## قاعدة البيانات
 
-التقط العمليات SQL المدمرة قبل تنفيذها ضد قاعدة البيانات الخاصة بك.
+اكتش العمليات SQL المدمرة قبل تنفيذها ضد قاعدة البيانات الخاصة بك.
 
 ### `warn-destructive-sql`
 
 **الحدث:** PreToolUse (Bash)  
-**الافتراضي:** يوجه Claude للتأكيد قبل تشغيل SQL يحتوي على `DROP TABLE`، `DROP DATABASE`، أو `DELETE` بدون شرط `WHERE`.
+**الافتراضي:** يرشد Claude للتأكيد قبل تشغيل SQL التي تحتوي على `DROP TABLE`، `DROP DATABASE`، أو `DELETE` بدون بند `WHERE`.
 
-لا توجد معاملات.
+بدون معاملات.
 
 ---
 
 ### `warn-schema-alteration`
 
 **الحدث:** PreToolUse (Bash)  
-**الافتراضي:** يوجه Claude للتأكيد قبل تشغيل عبارات `ALTER TABLE`.
+**الافتراضي:** يرشد Claude للتأكيد قبل تشغيل عبارات `ALTER TABLE`.
 
-لا توجد معاملات.
+بدون معاملات.
 
 ---
 
-## التنبيهات
+## التحذيرات
 
-إعطاء الوكلاء سياق إضافي قبل العمليات المحتملة المخاطرة لكن غير المدمرة.
+إعطاء الوكلاء سياق إضافي قبل العمليات المحتملة الخطورة ولكن غير المدمرة.
 
 ### `warn-large-file-write`
 
 **الحدث:** PreToolUse (Write)  
-**الافتراضي:** يوجه Claude للتأكيد قبل كتابة الملفات الأكبر من 1024 كيلوبايت.
+**الافتراضي:** يرشد Claude للتأكيد قبل كتابة الملفات الأكبر من 1024 كيلوبايت.
 
 **المعاملات:**
 
 | المعامل | النوع | الافتراضي | الوصف |
-|--------|-------|---------|-------|
-| `thresholdKb` | `number` | `1024` | عتبة حجم الملف بالكيلوبايت التي يتم إصدار تحذير فوقها. |
+|-------|------|---------|-------------|
+| `thresholdKb` | `number` | `1024` | عتبة حجم الملف بالكيلوبايت التي يتم فوقها إصدار تحذير. |
 
 **مثال:**
 
@@ -406,7 +404,7 @@ icon: shield
 ```
 
 <Note>
-يفرض معالج الربط حد stdin بحجم 1 ميجابايت للحمولات. للاختبار باستخدام محتوى صغير، اضبط `thresholdKb` على قيمة أقل بكثير من 1024.
+يفرض معالج hook حد أقصى 1 ميجابايت stdin على الحمولات. لاختبار هذه السياسة بمحتوى صغير، اضبط `thresholdKb` على قيمة أقل بكثير من 1024.
 </Note>
 
 ---
@@ -414,68 +412,68 @@ icon: shield
 ### `warn-package-publish`
 
 **الحدث:** PreToolUse (Bash)  
-**الافتراضي:** يوجه Claude للتأكيد قبل تشغيل `npm publish`.
+**الافتراضي:** يرشد Claude للتأكيد قبل تشغيل `npm publish`.
 
-لا توجد معاملات.
+بدون معاملات.
 
 ---
 
 ### `warn-background-process`
 
 **الحدث:** PreToolUse (Bash)  
-**الافتراضي:** يوجه Claude ليكون حذراً عند تشغيل العمليات الخلفية عبر `nohup`، `&`، `disown`، أو `screen`.
+**الافتراضي:** يرشد Claude ليكون حذرًا عند إطلاق العمليات في الخلفية عبر `nohup`، `&`، `disown`، أو `screen`.
 
-لا توجد معاملات.
+بدون معاملات.
 
 ---
 
 ### `warn-global-package-install`
 
 **الحدث:** PreToolUse (Bash)  
-**الافتراضي:** يوجه Claude للتأكيد قبل تشغيل `npm install -g`، `yarn global add`، أو `pip install` بدون بيئة افتراضية.
+**الافتراضي:** يرشد Claude للتأكيد قبل تشغيل `npm install -g`، `yarn global add`، أو `pip install` دون بيئة افتراضية.
 
-لا توجد معاملات.
+بدون معاملات.
 
 ---
 
 ## سلوك الذكاء الاصطناعي
 
-اكتشف عندما يتعثر الوكلاء أو يتصرفون بشكل غير متوقع.
+اكتشف عندما يعلق الوكلاء أو يتصرفون بشكل غير متوقع.
 
 ### `warn-repeated-tool-calls`
 
 **الحدث:** PreToolUse (جميع الأدوات)  
-**الافتراضي:** يوجه Claude لإعادة النظر عندما يتم استدعاء نفس الأداة 3 مرات أو أكثر بمعاملات متطابقة - علامة شائعة على أن الوكيل عالق في حلقة.
+**الافتراضي:** يرشد Claude لإعادة النظر عند استدعاء نفس الأداة 3 مرات أو أكثر مع معاملات متطابقة - علامة شائعة على أن الوكيل عالق في حلقة.
 
-لا توجد معاملات.
+بدون معاملات.
 
 ---
 
-## سير العمل (بيتا)
+## سير العمل
 
-فرض سير عمل منضبط في نهاية الجلسة. تُطلق هذه السياسات على حدث **Stop** وترفض Claude من التوقف حتى تتحقق كل حالة. تتبع سلسلة اعتماد طبيعية: commit → push → PR → CI. إذا رفضت سياسة، يتم تخطي السياسات اللاحقة في السلسلة (الرفض قصير الدائرة).
+فرض سير عمل منضبط لنهاية الجلسة. تنشط هذه السياسات على حدث **Stop** وترفض Claude من التوقف حتى تستوفى كل شرط. يتبعون سلسلة اعتماد طبيعية: commit → push → PR → CI. إذا رفضت سياسة، يتم تجاوز السياسات اللاحقة في السلسلة (الرفض يقصر الدارة).
 
-جميع سياسات سير العمل **fail-open**: إذا لم تكن الأداة المطلوبة متاحة (على سبيل المثال `gh` غير مثبتة، بدون git remote)، تسمح السياسة برسالة معلوماتية توضح سبب تخطي الفحص.
+جميع سياسات سير العمل **fail-open**: إذا كانت الأداة المطلوبة غير متاحة (على سبيل المثال `gh` غير مثبت، لا يوجد git remote)، تسمح السياسة برسالة معلوماتية تشرح سبب تخطي الفحص.
 
 ### `require-commit-before-stop`
 
 **الحدث:** Stop  
-**الافتراضي:** يرفض التوقف عند وجود تغييرات غير مرتكبة (ملفات معدلة أو مرحلية أو غير متتبعة). إرجاع رسالة معلوماتية عندما يكون دليل العمل نظيفاً.
+**الافتراضي:** يرفض التوقف عند وجود تغييرات غير مطبقة (ملفات معدلة أو مرحلة أو غير متتبعة). يرجع رسالة معلوماتية عند نظافة دليل العمل.
 
-لا توجد معاملات.
+بدون معاملات.
 
 ---
 
 ### `require-push-before-stop`
 
 **الحدث:** Stop  
-**الافتراضي:** يرفض التوقف عند وجود commits غير مدفوعة أو عندما لا يكون للفرع الحالي فرع تتبع بعيد. يقترح `git push -u` لإنشاء فرع تتبع إذا لزم الأمر. يفشل بشكل مفتوح إذا لم يتم تكوين جهاز تحكم بعيد.
+**الافتراضي:** يرفض التوقف عند وجود commits غير مدفوعة أو عندما لا يكون للفرع الحالي فرع تتبع بعيد. يقترح `git push -u` لإنشاء فرع تتبع إذا لزم الأمر. يفشل مفتوح إذا لم يتم تكوين أي بعيد.
 
 **المعاملات:**
 
 | المعامل | النوع | الافتراضي | الوصف |
-|--------|-------|---------|-------|
-| `remote` | `string` | `"origin"` | اسم الجهاز التحكم البعيد للدفع إليه. |
+|-------|------|---------|-------------|
+| `remote` | `string` | `"origin"` | اسم البعيد للدفع إليه. |
 
 **مثال:**
 
@@ -494,14 +492,14 @@ icon: shield
 ### `require-pr-before-stop`
 
 **الحدث:** Stop  
-**الافتراضي:** يرفض التوقف عندما لا توجد طلب سحب للفرع الحالي، أو عندما يكون طلب السحب الموجود مغلقاً أو مدمجاً. يوجه Claude لإنشاء PR باستخدام `gh pr create`.
+**الافتراضي:** يرفض التوقف عند عدم وجود pull request للفرع الحالي، أو عندما يكون PR الموجود مغلقًا/مدمجًا. يرشد Claude لإنشاء PR باستخدام `gh pr create`.
 
-لا توجد معاملات.
+بدون معاملات.
 
 <Note>
-تتطلب هذه السياسة تثبيت [GitHub CLI](https://cli.github.com/) (`gh`) والمصادقة عليها.
-شغّل `gh auth login` باستخدام رمز وصول شخصي بـ scope `repo` لقراءة الوصول إلى
-طلبات السحب. إذا لم تكن `gh` مثبتة أو لم تتم المصادقة عليها، تفشل السياسة بشكل مفتوح وتُبلغ السبب إلى Claude.
+تتطلب هذه السياسة تثبيت [GitHub CLI](https://cli.github.com/) (`gh`) والمصادقة عليه.
+قم بتشغيل `gh auth login` برمز وصول شخصي يتمتع بنطاق `repo` للقراءة
+pull requests. إذا لم يتم تثبيت `gh` أو لم يتم المصادقة عليه، تفشل السياسة مفتوحة وتبلغ السبب إلى Claude.
 </Note>
 
 ---
@@ -509,50 +507,23 @@ icon: shield
 ### `require-ci-green-before-stop`
 
 **الحدث:** Stop  
-**الافتراضي:** يرفض التوقف عندما تكون فحوصات CI فاشلة أو لا تزال قيد التشغيل على الفرع الحالي. يفحص كل من أعمال GitHub Actions workflow وفحوصات بوت من طرف ثالث (على سبيل المثال CodeRabbit، SonarCloud، Codecov). يتعامل مع استنتاجات `skipped` كنجاح. إرجاع رسالة معلوماتية عندما تمر جميع الفحوصات.
+**الافتراضي:** يرفض التوقف عند فشل فحوصات CI أو لا تزال تعمل على الفرع الحالي. يتحقق من سير عمل GitHub Actions وفحوصات bot جهات خارجية (على سبيل المثال CodeRabbit, SonarCloud, Codecov). يتعامل مع استنتاجات `skipped` كنجاح. يرجع رسالة معلوماتية عند نجاح جميع الفحوصات.
 
-لا توجد معاملات.
+بدون معاملات.
 
 <Note>
-تتطلب هذه السياسة تثبيت [GitHub CLI](https://cli.github.com/) (`gh`) والمصادقة عليها.
-شغّل `gh auth login` باستخدام رمز وصول شخصي بـ scope `repo` لقراءة الوصول إلى
-أعمال workflow الإجراءات و Checks API. إذا لم تكن `gh` مثبتة أو لم تتم المصادقة عليها، تفشل السياسة بشكل مفتوح وتُبلغ السبب إلى Claude.
+تتطلب هذه السياسة تثبيت [GitHub CLI](https://cli.github.com/) (`gh`) والمصادقة عليه.
+قم بتشغيل `gh auth login` برمز وصول شخصي يتمتع بنطاق `repo` للقراءة
+Actions workflow runs و Checks API. إذا لم يتم تثبيت `gh` أو لم يتم المصادقة عليه، تفشل السياسة مفتوحة وتبلغ السبب إلى Claude.
 </Note>
 
 ---
 
-## سياسات بيتا
-
-تم وضع علامة على بعض السياسات `beta` وليست مثبتة بشكل افتراضي. قد تحتوي سياسات Beta على حواف خشنة أو تولد إيجابيات خاطئة. يتخرجون إلى مستقرة في الإصدارات المستقبلية.
-
-**سياسات بيتا الحالية:**
-
-- `require-commit-before-stop` — التزم بجميع التغييرات قبل التوقف
-- `require-push-before-stop` — ادفع جميع commits إلى البعيد
-- `require-pr-before-stop` — تأكد من وجود PR للفرع
-- `require-ci-green-before-stop` — يجب أن تمر جميع فحوصات CI
-
-معاً، فهذه تفرض سير عمل **commit → push → PR → CI**.
-
-لتثبيت جميع سياسات بيتا:
-
-```bash
-failproofai policies --install --beta
-```
-
-أو ثبّت سياسات سير عمل محددة:
-
-```bash
-failproofai policies --install require-commit-before-stop require-push-before-stop require-pr-before-stop require-ci-green-before-stop
-```
-
-شغّل `failproofai policies` لمعرفة السياسات التي تحمل علامة بيتا.
-
 ---
 
-## تعطيل سياسات فردية
+## تعطيل السياسات الفردية
 
-أزل سياسة محددة من `enabledPolicies` في إعداداتك، أو قم بإيقافها في علامة التبويب السياسات في لوحة التحكم.
+أزل سياسة معينة من `enabledPolicies` في تكوينك، أو أوقفها في علامة التبويب Policies في لوحة البيانات.
 
 ```json
 {
@@ -563,4 +534,4 @@ failproofai policies --install require-commit-before-stop require-push-before-st
 }
 ```
 
-السياسات غير المدرجة في `enabledPolicies` لا تعمل، حتى لو وجدت إدخالات `policyParams` لها.
+لا تعمل السياسات غير المدرجة في `enabledPolicies`، حتى لو كانت هناك إدخالات `policyParams` لها.

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

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