npm - failproofai - Versions diffs - 0.0.6-beta.2 → 0.0.6-beta.4 - Mend

failproofai 0.0.6-beta.2 → 0.0.6-beta.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (511) hide show

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

@@ -1,574 +0,0 @@
----
-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 |
-| [مديرو الحزم](#package-managers) | prefer-package-manager | 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-`** — حظر حدث 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` بدون بيئة افتراضية.
-بدون معاملات.
----
-## مديرو الحزم
-فرض مديري الحزم المسموح بهم على الوكيل.
-### `prefer-package-manager`
-**الحدث:** PreToolUse (Bash)
-**الإعداد الافتراضي:** معطل. عند التفعيل، يحظر أي أمر مدير حزم غير موجود في قائمة `allowed` ويخبر Claude بإعادة كتابة الأمر باستخدام مدير مسموح به.
-يكتشف: pip, pip3, python -m pip, npm, npx, yarn, pnpm, pnpx, bun, bunx, uv, poetry, pipenv, conda, cargo.
-| المعامل | النوع | الافتراضي | الوصف |
-|--------|-------|---------|-------|
-| `allowed` | string[] | `[]` | أسماء مديري الحزم المسموح بها. يتم حظر أي مدير مكتشف غير موجود في هذه القائمة. عند كونها فارغة، السياسة غير فعالة. |
-| `blocked` | string[] | `[]` | أسماء مديري إضافية للحظر بما يتجاوز القائمة المدمجة (مثلاً `['pdm', 'pipx']`). |
-تغطي قائمة الحظر المدمجة: pip, pip3, npm, npx, yarn, pnpm, pnpx, bun, bunx, uv, poetry, pipenv, conda, cargo. استخدم `blocked` لإضافة مديري غير موجودين في هذه القائمة.
-**مثال التكوين:**
-```json
-{
-  "enabledPolicies": ["prefer-package-manager"],
-  "policyParams": {
-    "prefer-package-manager": {
-      "allowed": ["uv", "bun"],
-      "blocked": ["pdm", "pipx"]
-    }
-  }
-}
-```
-مع هذا الإعداد، `pip install flask` و `pdm install flask` كلاهما مرفوض برسالة تخبر Claude بالاستخدام `uv` أو `bun` بدلاً من ذلك. أوامر مثل `uv pip install flask` مسموح بها لأن `uv` موجود في قائمة المسموحين ويتم فحصه أولاً.
----
-## سلوك الذكاء الاصطناعي
-كشف عندما يعلق الوكلاء أو يتصرفون بشكل غير متوقع.
-### `warn-repeated-tool-calls`
-**الحدث:** PreToolUse (جميع الأدوات)
-**الإعداد الافتراضي:** تعليمات Claude لإعادة التفكير عند استدعاء نفس الأداة 3 مرات أو أكثر بنفس المعاملات - وهي علامة شائعة على أن الوكيل عالق في حلقة.
-بدون معاملات.
----
-## سير العمل
-فرض سير عمل منضبط لنهاية الجلسة. تطلق هذه السياسات على حدث **Stop** وترفض Claude من التوقف حتى يتم استيفاء كل شرط. تتبع سلسلة اعتماد طبيعية: commit → push → PR → CI. إذا رفضت سياسة، يتم تخطي السياسات اللاحقة في السلسلة (الرفض يختصر).
-جميع سياسات سير العمل **fail-open**: إذا لم تكن الأداة المطلوبة متاحة (مثلاً `gh` غير مثبتة، لا يوجد remote git)، تسمح السياسة برسالة إعلامية توضح سبب تخطي الفحص.
-### `require-commit-before-stop`
-**الحدث:** Stop
-**الإعداد الافتراضي:** رفض التوقف عندما توجد تغييرات غير مرتكبة (ملفات معدلة أو منصة أو غير متتبعة). إرجاع رسالة إعلامية عندما يكون دليل العمل نظيفاً.
-بدون معاملات.
----
-### `require-push-before-stop`
-**الحدث:** Stop
-**الإعداد الافتراضي:** رفض التوقف عندما توجد التزامات غير مدفوعة أو عندما لا يكون للفرع الحالي فرع تتبع بعيد. يقترح `git push -u` لإنشاء فرع تتبع إذا لزم الأمر. يفشل بشكل مفتوح إذا لم يتم تكوين remote.
-**المعاملات:**
-| المعامل | النوع | الافتراضي | الوصف |
-|--------|-------|---------|-------|
-| `remote` | `string` | `"origin"` | اسم remote للدفع إليه. |
-**مثال:**
-```json
-{
-  "policyParams": {
-    "require-push-before-stop": {
-      "remote": "upstream"
-    }
-  }
-}
-```
----
-### `require-pr-before-stop`
-**الحدث:** Stop
-**الإعداد الافتراضي:** رفض التوقف عندما لا يوجد طلب دمج للفرع الحالي، أو عندما يكون الطلب الموجود مغلقاً/مدمجاً. تعليمات Claude لإنشاء طلب دمج مع `gh pr create`.
-بدون معاملات.
-<Note>
-تتطلب هذه السياسة تثبيت [GitHub CLI](https://cli.github.com/) (`gh`) والتحقق منها.
-قم بتشغيل `gh auth login` بـ personal access token يملك نطاق `repo` للوصول للقراءة إلى
-طلبات الدمج. إذا لم يتم تثبيت `gh` أو لم يتم التحقق منها، تفشل السياسة بشكل مفتوح وتبلغ السبب إلى Claude.
-</Note>
----
-### `require-ci-green-before-stop`
-**الحدث:** Stop
-**الإعداد الافتراضي:** رفض التوقف عندما تكون فحوصات CI فاشلة أو لا تزال قيد التشغيل على الفرع الحالي. يفحص كل من مسارات عمل GitHub Actions والفحوصات من جهات خارجية (مثلاً CodeRabbit, SonarCloud, Codecov). يتعامل مع الاستنتاجات `skipped` كنجاح. إرجاع رسالة إعلامية عندما تمر جميع الفحوصات.
-بدون معاملات.
-<Note>
-تتطلب هذه السياسة تثبيت [GitHub CLI](https://cli.github.com/) (`gh`) والتحقق منها.
-قم بتشغيل `gh auth login` بـ personal access token يملك نطاق `repo` للوصول للقراءة إلى
-مسارات عمل Actions والـ 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 DELETED Viewed

@@ -1,28 +0,0 @@
----
-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 DELETED Viewed

@@ -1,34 +0,0 @@
----
-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 DELETED Viewed

@@ -1,31 +0,0 @@
----
----
-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` |