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

failproofai 0.0.6-beta.3 → 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 (509) hide show

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

@@ -1,574 +0,0 @@
----
-title: السياسات المدمجة
-description: "جميع 30 سياسة مدمجة تلتقط أنماط فشل الوكيل الشائعة"
-icon: shield
----
-يأتي failproofai مع 30 سياسة مدمجة تلتقط أنماط فشل الوكيل الشائعة. تعمل كل سياسة على حدث خطاف معين واسم أداة محدد. تقبل تسع سياسات معاملات تسمح لك بضبط سلوكها دون كتابة أي كود. تفرض أربع سياسات سير عمل خط أنابيب commit → push → PR → CI قبل أن يتوقف Claude.
----
-## نظرة عامة
-يتم تجميع السياسات في فئات:
-| الفئة | السياسات | نوع الخطاف |
-|-------|----------|-----------|
-| [الأوامر الخطرة](#الأوامر-الخطرة) | block-sudo, block-rm-rf, block-curl-pipe-sh, block-failproofai-commands | PreToolUse |
-| [الأسرار (مُنظفات)](#الأسرار-مُنظفات) | sanitize-jwt, sanitize-api-keys, sanitize-connection-strings, sanitize-private-key-content, sanitize-bearer-tokens | PostToolUse |
-| [البيئة](#البيئة) | block-env-files, protect-env-vars | PreToolUse |
-| [الوصول إلى الملفات](#الوصول-إلى-الملفات) | 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 |
-| [قاعدة البيانات](#قاعدة-البيانات) | warn-destructive-sql, warn-schema-alteration | PreToolUse |
-| [تحذيرات](#تحذيرات) | warn-large-file-write, warn-package-publish, warn-background-process, warn-global-package-install | PreToolUse |
-| [مديرو الحزم](#مديرو-الحزم) | prefer-package-manager | PreToolUse |
-| [سير العمل](#سير-العمل) | 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`. يتم إلحاق التلميح برسالة deny أو instruct التي يراها Claude، مما يوفر إرشادات قابلة للتنفيذ دون تعديل كود السياسة. يعمل مع السياسات المدمجة والمخصصة وسياسات الاتفاقية. انظر [التكوين → hint](/ar/configuration#hint-cross-cutting) للتفاصيل.
-</Tip>
----
-## الأوامر الخطرة
-منع الوكلاء من تشغيل العمليات التي يصعب التراجع عنها أو التي قد تضر بنظام الاستضافة.
-### `block-sudo`
-**الحدث:** PreToolUse (Bash)
-**الافتراضي:** ينكر أي أمر `sudo`.
-يحظر الاستدعاءات التي تتضمن كلمة `sudo`. يتم مطابقة النمط على رموز الأوامر التي تم تحليلها، وليس السلسلة الخام، لمنع الالتفاف عن طريق حقن عامل قشرة.
-**المعاملات:**
-| المعامل | النوع | الافتراضي | الوصف |
-|--------|-------|----------|-------|
-| `allowPatterns` | `string[]` | `[]` | بادئات الأوامر الدقيقة المسموح بها. يتم مطابقة كل إدخال مقابل رموز argv التي تم تحليلها. |
-**مثال:**
-```json
-{
-  "policyParams": {
-    "block-sudo": {
-      "allowPatterns": ["sudo systemctl status", "sudo journalctl"]
-    }
-  }
-}
-```
-مع هذا التكوين، يُسمح بـ `sudo systemctl status nginx`، لكن `sudo rm /etc/hosts` مرفوض.
-<Note>
-يتم مطابقة الأنماط مقابل الرموز التي تم تحليلها، وليس سلسلة الأوامر الخام. هذا يمنع الالتفاف عن طريق عوامل قشرة ملحقة (على سبيل المثال، `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 KB.
-**المعاملات:**
-| المعامل | النوع | الافتراضي | الوصف |
-|--------|-------|----------|-------|
-| `thresholdKb` | `number` | `1024` | عتبة حجم الملف بالكيلوبايت التي يتم إصدار تحذير فوقها. |
-**مثال:**
-```json
-{
-  "policyParams": {
-    "warn-large-file-write": {
-      "thresholdKb": 256
-    }
-  }
-}
-```
-<Note>
-يفرض معالج الخطاف حد stdin بحجم 1 ميجابايت على الحمولات. لاختبار هذه السياسة بمحتوى صغير، اضبط `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
-**الافتراضي:** ينكر التوقف عند وجود commits غير مدفوعة أو عند عدم وجود فرع تتبع remote للفرع الحالي. يقترح `git push -u` لإنشاء فرع تتبع إذا لزم الأمر. يفشل open إذا لم يتم تكوين أي remote.
-**المعاملات:**
-| المعامل | النوع | الافتراضي | الوصف |
-|--------|-------|----------|-------|
-| `remote` | `string` | `"origin"` | اسم remote للدفع إليه. |
-**مثال:**
-```json
-{
-  "policyParams": {
-    "require-push-before-stop": {
-      "remote": "upstream"
-    }
-  }
-}
-```
----
-### `require-pr-before-stop`
-**الحدث:** Stop
-**الافتراضي:** ينكر التوقف عند عدم وجود طلب سحب للفرع الحالي، أو عند إغلاق أو دمج طلب السحب الموجود. يرشد Claude لإنشاء PR باستخدام `gh pr create`.
-لا توجد معاملات.
-<Note>
-تتطلب هذه السياسة [GitHub CLI](https://cli.github.com/) (`gh`) أن تكون مثبتة ومصرح بها.
-قم بتشغيل `gh auth login` برمز وصول شخصي يتمتع بنطاق `repo` لقراءة طلبات السحب.
-إذا لم تكن `gh` مثبتة أو غير مصرح بها، تفشل السياسة open وتبلغ السبب إلى Claude.
-</Note>
----
-### `require-ci-green-before-stop`
-**الحدث:** Stop
-**الافتراضي:** ينكر التوقف عند فشل فحوصات CI أو استمرار تشغيلها على الفرع الحالي. يتحقق من كل من تشغيل مسار GitHub Actions والفحوصات من طرف ثالث (على سبيل المثال، CodeRabbit, SonarCloud, Codecov). يعامل `skipped` و `cancelled` على أنها نجاح. يرجع رسالة إعلامية عند نجاح جميع الفحوصات.
-لا توجد معاملات.
-<Note>
-تتطلب هذه السياسة [GitHub CLI](https://cli.github.com/) (`gh`) أن تكون مثبتة ومصرح بها.
-قم بتشغيل `gh auth login` برمز وصول شخصي يتمتع بنطاق `repo` لقراءة تشغيل مسارات Actions و Checks API.
-إذا لم تكن `gh` مثبتة أو غير مصرح بها، تفشل السياسة open وتبلغ السبب إلى 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` |