failproofai 1.0.1-beta.0 → 1.0.1

package/.next/standalone/docs-old/ar/configuration.mdx

@@ -0,0 +1,268 @@
+---
+---
+title: الإعدادات
+description: "صيغة ملف التكوين، نظام النطاقات الثلاثة، وقواعد الدمج"
+icon: gear
+---
+
+يستخدم failproofai ملفات تكوين JSON للتحكم في السياسات النشطة وكيفية عملها ومن أين يتم تحميل السياسات المخصصة. تم تصميم الإعدادات لسهولة المشاركة مع فريقك - قم بالالتزام بها في مستودعك وسيحصل كل مطور على نفس شبكة الأمان للعامل.
+
+---
+
+## نطاقات الإعدادات
+
+هناك ثلاثة نطاقات للإعدادات، يتم تقييمها بترتيب الأولوية:
+
+| النطاق | مسار الملف | الغرض |
+|-------|-----------|---------|
+| **المشروع** | `.failproofai/policies-config.json` | إعدادات لكل مستودع، التزام في التحكم بالإصدارات |
+| **محلي** | `.failproofai/policies-config.local.json` | تجاوزات شخصية لكل مستودع، مُستثناة من git |
+| **عام** | `~/.failproofai/policies-config.json` | الإعدادات الافتراضية على مستوى المستخدم عبر جميع المشاريع |
+
+عندما يتلقى failproofai حدث خطاف، يقوم بتحميل ودمج جميع الملفات الثلاثة الموجودة للمجلد الحالي.
+
+### قواعد الدمج
+
+**`enabledPolicies`** - اتحاد جميع النطاقات الثلاثة. السياسة المفعلة في أي مستوى تكون نشطة.
+
+```text
+project:  ["block-sudo"]
+local:    ["block-rm-rf"]
+global:   ["block-sudo", "sanitize-api-keys"]
+
+resolved: ["block-sudo", "block-rm-rf", "sanitize-api-keys"]  ← اتحاد مُلغى التكرار
+```
+
+**`policyParams`** - أول نطاق يحدد المعاملات لسياسة معينة يفوز بالكامل. لا يوجد دمج عميق للقيم داخل معاملات السياسة.
+
+```text
+project:  block-sudo → { allowPatterns: ["sudo apt-get update"] }
+global:   block-sudo → { allowPatterns: ["sudo systemctl status"] }
+
+resolved: { allowPatterns: ["sudo apt-get update"] }   ← يفوز المشروع، يتم تجاهل النطاق العام
+```
+
+```text
+project:  (no block-sudo entry)
+local:    (no block-sudo entry)
+global:   block-sudo → { allowPatterns: ["sudo systemctl status"] }
+
+resolved: { allowPatterns: ["sudo systemctl status"] }  ← يتم الرجوع للنطاق العام
+```
+
+**`customPoliciesPaths` / `customPoliciesPath`** - أول نطاق يحدد أي شكل يفوز.
+
+**`disabledCustomPolicies`** - اتحاد عبر جميع النطاقات. لوحة المعلومات تكتب معرف مؤهل بالمصدر هنا عند إيقاف تشغيل سياسة فردية من ملف سياسة صريح أو حسب العرف. السياسات غير المدرجة تبقى مفعلة بشكل افتراضي؛ المعرفات تتضمن ملف المصدر بحيث يمكن التحكم في السياسات بنفس الاسم في ملفات متعددة بشكل مستقل.
+
+**`llm`** - أول نطاق يحددها يفوز.
+
+---
+
+## صيغة ملف الإعدادات
+
+```json
+{
+  "enabledPolicies": [
+    "block-sudo",
+    "block-rm-rf",
+    "block-push-master",
+    "sanitize-api-keys",
+    "sanitize-jwt",
+    "block-env-files",
+    "block-read-outside-cwd"
+  ],
+  "policyParams": {
+    "block-sudo": {
+      "allowPatterns": ["sudo systemctl status", "sudo journalctl"]
+    },
+    "block-push-master": {
+      "protectedBranches": ["main", "release", "prod"]
+    },
+    "block-rm-rf": {
+      "allowPaths": ["/tmp"]
+    },
+    "block-read-outside-cwd": {
+      "allowPaths": ["/shared/data", "/opt/company"]
+    },
+    "sanitize-api-keys": {
+      "additionalPatterns": [
+        { "regex": "myco_[A-Za-z0-9]{32}", "label": "MyCo API key" }
+      ]
+    },
+    "warn-large-file-write": {
+      "thresholdKb": 512
+    }
+  },
+  "customPoliciesPath": "/home/alice/myproject/my-policies.js"
+}
+```
+
+---
+
+## مرجع الحقول
+
+### `enabledPolicies`
+
+النوع: `string[]`
+
+قائمة أسماء السياسات المراد تفعيلها. يجب أن تطابق الأسماء تماماً معرفات السياسات التي تظهرها `failproofai policies`. راجع [السياسات المدمجة](/ar/built-in-policies) للحصول على القائمة الكاملة.
+
+السياسات غير المدرجة في `enabledPolicies` غير نشطة، حتى لو كانت لديها إدخالات في `policyParams`.
+
+### `policyParams`
+
+النوع: `Record<string, Record<string, unknown>>`
+
+تجاوزات المعاملات لكل سياسة. المفتاح الخارجي هو اسم السياسة؛ المفاتيح الداخلية خاصة بكل سياسة. توثق كل سياسة معاملاتها المتاحة في [السياسات المدمجة](/ar/built-in-policies).
+
+إذا كان للسياسة معاملات لكنك لم تحددها، يتم استخدام القيم الافتراضية المدمجة للسياسة. المستخدمون الذين لا يقومون بتكوين `policyParams` على الإطلاق يحصلون على سلوك متطابق للإصدارات السابقة.
+
+المفاتيح غير المعروفة داخل كتلة معاملات السياسة يتم تجاهلها بصمت في وقت إطلاق الخطاف ولكن يتم وضع علم عليها كتحذيرات عند تشغيل `failproofai policies`.
+
+#### `hint` (عبر الأنظمة)
+
+النوع: `string` (اختياري)
+
+رسالة مُلحقة بالسبب عندما تُرجع السياسة `deny` أو `instruct`. استخدمها لمنح Claude إرشادات قابلة للتنفيذ دون تعديل السياسة نفسها.
+
+يعمل مع أي نوع سياسة — مدمجة أو مخصصة (`custom/`) أو اتفاقية المشروع (`.failproofai-project/`) أو اتفاقية المستخدم (`.failproofai-user/`).
+
+```json
+{
+  "policyParams": {
+    "block-force-push": {
+      "hint": "جرب إنشاء فرع جديد بدلاً من ذلك."
+    },
+    "block-sudo": {
+      "allowPatterns": ["sudo apt-get"],
+      "hint": "استخدم apt-get مباشرة بدون sudo."
+    },
+    "custom/my-policy": {
+      "hint": "اطلب موافقة المستخدم أولاً."
+    }
+  }
+}
+```
+
+عند رفض `block-force-push`، يرى Claude: *"دفع القوة مُحظور. جرب إنشاء فرع جديد بدلاً من ذلك."*
+
+القيم غير النصية والنصوص الفارغة يتم تجاهلها بصمت. إذا لم يتم تعيين `hint`، يبقى السلوك دون تغيير (متوافق مع الإصدارات السابقة).
+
+### `customPoliciesPath`
+
+النوع: `string` (المسار المطلق)
+
+المسار إلى ملف JavaScript يحتوي على سياسات خطاف مخصصة. يتم تعيينها تلقائياً بواسطة `failproofai policies --install --custom <path>` (يتم حل المسار إلى مطلق قبل تخزينه).
+
+يتم تحميل الملف بشكل جديد في كل حدث خطاف - لا يوجد تخزين مؤقت. راجع [السياسات المخصصة](/ar/custom-policies) لتفاصيل الإنشاء.
+
+### سياسات قائمة على الاتفاقية
+
+بالإضافة إلى `customPoliciesPath` الصريح، يكتشف failproofai ويحمل ملفات السياسات تلقائياً من مجلدات `.failproofai/policies/`:
+
+| المستوى | المجلد | النطاق |
+|-------|-----------|-------|
+| المشروع | `.failproofai/policies/` | مشترك مع الفريق عبر التحكم بالإصدارات |
+| المستخدم | `~/.failproofai/policies/custom-policies/` | شخصي، ينطبق على جميع المشاريع |
+
+<Note>
+  تم نقل مجلد مستوى المستخدم إلى أسفل مستوى واحد في إعادة تنظيم دليل المنزل.
+  الملفات المتبقية في المجلد القديم `~/.failproofai/policies/` يتم نقلها إلى
+  `custom-policies/` تلقائياً في المرة الأولى التي تقوم فيها بتشغيل أي أمر failproofai
+  بعد الترقية، والأمر يخبرك بالملفات التي تم نقلها.
+</Note>
+
+**مطابقة الملفات:** يتم تحميل الملفات المطابقة فقط `*policies.{js,mjs,ts}` (مثل `security-policies.mjs`، `workflow-policies.js`). يتم تجاهل الملفات الأخرى في المجلد.
+
+**لا حاجة للتكوين:** سياسات الاتفاقية لا تتطلب إدخالات في `policies-config.json`. ما عليك سوى إسقاط الملفات في المجلد وسيتم التقاطها في حدث الخطاف التالي.
+
+**تحميل الاتحاد:** يتم مسح كلا من مجلدات اتفاقية المشروع والمستخدم. يتم تحميل جميع الملفات المطابقة من كلا المستويين (بخلاف `customPoliciesPath` الذي يستخدم first-scope-wins).
+
+راجع [السياسات المخصصة](/ar/custom-policies) لمزيد من التفاصيل والأمثلة.
+
+### `llm`
+
+النوع: `object` (اختياري)
+
+إعدادات عميل LLM للسياسات التي تقوم باستدعاءات AI. غير مطلوبة لمعظم الإعدادات.
+
+```json
+{
+  "llm": {
+    "model": "claude-sonnet-4-6",
+    "apiKey": "sk-ant-..."
+  }
+}
+```
+
+---
+
+## إدارة الإعدادات من CLI
+
+تقوم أوامر `policies --install` و `policies --uninstall` بالكتابة إلى ملف إعدادات الخطاف لـ CLI العامل الخاص بك (نقاط دخول الخطاف)، بينما `policies-config.json` هو الملف الذي تديره مباشرة. كلاهما منفصل:
+
+- **إعدادات Agent CLI** — تخبر العامل باستدعاء `failproofai --hook <event>` على كل استخدام أداة:
+  - **Claude Code**: `~/.claude/settings.json` (مستخدم)، `<cwd>/.claude/settings.json` (مشروع)، `<cwd>/.claude/settings.local.json` (محلي)
+  - **OpenAI Codex**: `~/.codex/hooks.json` (مستخدم)، `<cwd>/.codex/hooks.json` (مشروع) — Codex لا يوجد لديه نطاق محلي
+  - **GitHub Copilot CLI _(beta)_**: `~/.copilot/hooks/failproofai.json` (مستخدم)، `<cwd>/.github/hooks/failproofai.json` (مشروع) — Copilot لا يوجد لديه نطاق محلي. إدخالات الخطاف تستخدم حقول الأوامر الخاصة بـ Copilot المفتاحة بنظام التشغيل `bash`/`powershell` مع `timeoutSec`؛ الملف يحمل علامة `version: 1` على المستوى الأعلى. دعم Copilot CLI **بيتا** بينما نتحقق من مخطط سجل `events.jsonl` (التي لا توضحه المستندات العامة) مقابل المزيد من جلسات العالم الحقيقي. **وضع عامل VS Code Copilot Chat (معاينة)** يقرأ إعدادات الخطاف من `.github/hooks/*.json`، `~/.copilot/hooks/*.json`، و `~/.claude/settings.json` (يحكمها إعداد `chat.hookFilesLocations`) باستخدام نفس عقد Claude الشكلي `{hookSpecificOutput:{permissionDecision:"deny",…}}` — المسارات الدقيقة التي تكتبها تكامل `copilot` هذا وتكامل `claude` (`~/.claude/settings.json`) بالفعل، لذا فإن `failproofai policies --install --cli copilot` (أو `--cli claude`) **بالفعل يفرض في وضع VS Code agent** بدون الحاجة إلى تكامل منفصل `vscode` (مؤكد من سجلات اكتشاف VS Code).
+  - **Cursor Agent _(beta)_**: `~/.cursor/hooks.json` (مستخدم)، `<cwd>/.cursor/hooks.json` (مشروع) — Cursor لا يوجد لديه نطاق محلي. إدخالات الخطاف تستخدم شكل Claude الشكلي `{type, command, timeout}` (لا يوجد تقسيم `bash`/`powershell`)، لكن مخزنة تحت مفاتيح الأحداث camelCase (`preToolUse`، `beforeSubmitPrompt`، …) في مصفوفة مسطحة لكل [مخطط الخطافات](https://cursor.com/docs/hooks) الخاص بـ Cursor؛ الملف يحمل علامة `version: 1` على المستوى الأعلى. معالج يقوم بتحويل camelCase → PascalCase عبر `CURSOR_EVENT_MAP` لذا السياسات المدمجة الموجودة تطلق بدون تغيير. دعم Cursor Agent **بيتا** بينما نتحقق من نسخة Cursor على القرص (غير محددة في المستندات العامة) مقابل المزيد من الثبتات في العالم الحقيقي.
+  - **OpenCode _(beta)_**: `~/.config/opencode/opencode.json` + `~/.config/opencode/plugins/failproofai.mjs` (مستخدم)، `<cwd>/.opencode/opencode.json` + `<cwd>/.opencode/plugins/failproofai.mjs` (مشروع) — OpenCode لا يوجد لديه نطاق محلي. بخلاف الـ CLIs الخمسة الأخرى، OpenCode **لا يوجد لديه نظام خطاف أوامر خارجية**: يحمل في العملية JS/TS ملحقات مسجلة بشكل صريح عبر مصفوفة `plugin: []` في `opencode.json` (الاكتشاف التلقائي من `.opencode/plugins/` **ليس** كيفية تحميل الملحقات على opencode v1.14.33). التثبيت يضع shim ملحق صغير مولد يقوم باستدعاء ثنائي failproofai في عملية فرعية ويترجم استجابة JSON للثنائي مرة أخرى إلى دلالات الملحقات: `throw new Error()` لرفض حدث الأداة (يلغي استدعاء الأداة)، `client.session.prompt(...)` لـ `instruct` و `Stop` / `SubagentStop` رفع (يرسل سبب الرفض كرسالة المستخدم التالية — القناة الوحيدة لإعادة المحاولة القسرية منذ `session.idle` إخطار فقط وإرسال من خلالها لا تؤثر)، و no-op للسماح. shim يقوم بتحويل أسماء الأدوات (lowercase → PascalCase عبر `OPENCODE_TOOL_MAP`) وعناصر إدخال الأداة (camelCase → snake_case عبر `OPENCODE_TOOL_INPUT_MAP` لـ `Read` / `Write` / `Edit`، مثل `filePath` → `file_path`، `oldString` → `old_string`) قبل التوجيه إلى الثنائي، لذا فإن مدقق المسار المدمج مثل `block-read-outside-cwd`، `block-env-files`، و `block-secrets-write` طلقات تغيير على استدعاءات أداة OpenCode. الجلسات تعيش في قاعدة بيانات SQLite الخاصة بـ opencode في `~/.local/share/opencode/opencode.db`؛ عارض جلسات لوحة المعلومات يقرأها عبر `opencode db --format json` و `opencode export <id>`. دعم OpenCode **بيتا** بينما نتحقق من السلوك عبر الإصدارات والمزيد من جلسات العالم الحقيقي. راجع [مستندات ملحقات OpenCode](https://opencode.ai/docs/plugins/).
+  - **Pi _(beta)_**: `~/.pi/agent/settings.json` (مستخدم)، `<cwd>/.pi/settings.json` (مشروع) — Pi لا يوجد لديه نطاق محلي. Pi يحمل حزم امتدادات TypeScript عند بدء التشغيل؛ ملف الإعدادات هو مصفوفة نصوص مسطحة `{"packages": ["./relative/path", …]}`. failproofai يكتب إدخال مصفوفة packages واحد يشير إلى مجلد `pi-extension/` المجمع الخاص به. امتداد داخلي يشترك في أحداث Pi `tool_call` / `user_bash` / `input` / `session_start` ويشغل الأوامر إلى `failproofai --hook <Event> --cli pi`؛ معالج يقوم بتحويل underscore_lower_snake_case → PascalCase عبر `PI_EVENT_MAP` لذا السياسات المدمجة الموجودة تطلق بدون تغيير. وسيطات إدخال الأداة أيضاً مُعادة عبر `PI_TOOL_INPUT_MAP` (Pi's Read / Write / Edit توفر `path` بدلاً من `file_path`؛ تعيين المفتاح ذو المستوى الأعلى يترك `block-env-files` و `block-secrets-write` طلقات — `block-read-outside-cwd` كان بالفعل لديه fallback `path`). دعم Pi **بيتا** بينما امتدادات Pi API وتخطيط سجل الجلسة استقرار.
+  - **Hermes (hermes-agent)**: `~/.hermes/config.yaml` (**نطاق المستخدم فقط** — Hermes لا يوجد لديه تكوين مشروع/محلي). Hermes هو بوابة Slack/Telegram **، لذا يعترض تثبيت واحد استدعاءات الأداة من كل منصة (Slack/Telegram/cli/cron) **و** subagents داخلي. إدخالات الخطاف هي زوج `{command, timeout}` (timeout في **ثوان**) تحت خريطة `hooks:` مفتاحة بأحداث snake_case الخاصة بـ Hermes (`pre_tool_call` / `post_tool_call` / `on_session_start` / `on_session_end` / `subagent_stop`؛ معالج يقوم بتحويل الأحداث عبر `HERMES_EVENT_MAP` وأسماء الأدوات عبر `HERMES_TOOL_MAP` لذا السياسات المدمجة تطلق بدون تغيير. التكوين يتم تحريره من خلال جولة YAML `Document` حفاظ على التعليقات لذا إعدادات المشغل الأخرى تبقى، والتثبيت يعيين `hooks_auto_accept: true` لذا البوابة بدون رأس (بدون TTY) تشغيل الخطافات بدون موجه موافقة. evaluator ينبثق عقد `{"decision":"block","reason"}` stdout الخاص بـ Hermes (Hermes يتجاهل رموز الخروج). **القيود:** Hermes لا يوجد لديه حدث نهاية الدوران `Stop`، لذا المدمجات `require-*-before-stop` لا تطلق أبداً لها (غير قابلة للتطبيق، لا كسر)؛ `instruct` ينحط للسماح-مع-ملاحظة-مسجلة (لا قناة سياق إضافي)؛ وإخفاء الأسرار في الإخراج (`sanitize-*`) لا يمكنه كتابة إخراج الأداة فوق عقد الخطاف القذيفة. Hermes أيضاً مصدر تدقيق **غير محترق** — لوحة المعلومات تقرأ جلسات بوابة الخاص بها مباشرة من `~/.hermes/state.db`.
+  - **OpenClaw (openclaw gateway)**: `~/.openclaw/openclaw.json` (**نطاق المستخدم فقط** — OpenClaw لا يوجد لديه تكوين مشروع/محلي). مثل Hermes، OpenClaw هي بوابة multi-channel **ذاتية البناء، لذا يعترض تثبيت واحد استدعاءات الأداة من كل قناة وخوادم subagents داخليها. الإنفاذ يجري عبر **خطافات ملحقات في العملية** الخاصة بـ OpenClaw (خطافاتها المستندة إلى الملفات الداخلية هي ملاحظة فقط ولا يمكنها الحجب)، لذا — مثل OpenCode/Pi — failproofai تشحن حزمة `openclaw-plugin/` ثابتة تطلق بشكل غير متزامن الثنائي failproofai وتترجم الحكم. التثبيت يسجل مجلد الملحق المشحون في مصفوفة `plugins.load.paths[]` الخاصة بـ `openclaw.json` ويفعله تحت `plugins.entries.failproofai` (مع `hooks.allowConversationAccess: true`، مطلوب للخطافات الحوار الخام). evaluator ينبثق حكم مسطح `{permission, reason}` ويقوم shim بتعيينه إلى شكل إرجاع أصلي لكل خطاف: `before_tool_call → {block:true, blockReason}` (**PreToolUse**)، `before_agent_run → {outcome:"block", reason}` (**UserPromptSubmit**)، و `before_agent_finalize → {action:"revise", reason}` (**Stop** — بوابة turn-end حقيقية، لذا مدمجات `require-*-before-stop` **تفرض** على OpenClaw، بخلاف Hermes). الأحداث وأسماء الأدوات canonicalize ثنائي-جانب عبر `OPENCLAW_EVENT_MAP` / `OPENCLAW_TOOL_MAP` (`exec→Bash`، `read→Read`، …) لذا السياسات المدمجة تطلق بدون تغيير؛ shim يفشل مفتوح على أي spawn/parse/timeout خطأ. OpenClaw أيضاً مصدر تدقيق **غير محترق** — لوحة المعلومات تقرأ جلسات JSONL الخاصة بها في `~/.openclaw/agents/<agentId>/sessions/<uuid>.jsonl`.
+  - **Factory Droid (`droid`)**: `~/.factory/hooks.json` (مستخدم)، `<cwd>/.factory/hooks.json` (مشروع) — Factory لا يوجد لديه نطاق محلي. droid يشحن نظام خطاف أمر خارجي Claude-style، لكن مع نكتتين تحقق مباشر ضد droid v0.171.0: (1) أسماء الأحداث تعيش في **المستوى الأعلى** من `hooks.json` — لا يوجد **لا `"hooks"` غلاف** (droid يرفض واحد)؛ أحداث الأدوات (`PreToolUse`/`PostToolUse`) تحمل `"matcher": "*"`، الأحداث غير الأداة تحذفها. (2) يتم دفع الرفع برمز خروج الخطاف **2 + stderr**، وليس قرار JSON — فرع `factory` المُقيِّم يُرجع خروج 2 لأحداث أداة/موجه و `{decision:"block", reason}` فقط على حدث turn-end `Stop` (قناة إعادة القوة الوحيدة الخاصة بـ droid). الأحداث بالفعل PascalCase (لا خريطة أحداث) والحمولة هي snake_case Claude؛ فقط أسماء الأدوات مُعادة عبر `FACTORY_TOOL_MAP` (`Execute→Bash`، `Create→Write`، `FetchUrl→WebFetch`، …). Factory أيضاً مصدر تدقيق **غير محترق** — لوحة المعلومات تقرأ جلسات JSONL على القرص في `~/.factory/sessions/<encoded-cwd>/<sessionId>.jsonl`.
+  - **Devin CLI (`devin`, Cognition)**: `~/.config/devin/config.json` (مستخدم)، `<cwd>/.devin/config.json` (مشروع) — Devin لا يوجد لديه نطاق محلي. Devin هو **مستنسخ Claude نقي** تحقق مباشر ضد devin v3000.1.27: يستخدم مخطط Claude `"hooks"`-wrapper معياري (الكتابات محفوظة بحيث مفاتيح ملف الإعدادات الأخرى — `org_id`، `theme_mode`، … — تبقى)، أسماء أحداث بالفعل PascalCase (لا خريطة أحداث، لا فرع معالج)، و payload stdin Claude snake_case (لا تطبيع). فرع `devin` المُقيِّم يرفع مع JSON `{"decision":"block","reason"}` على stdout في خروج 0 لـ **كل** حدث (تحقق — أسقط الكتلة على `--permission-mode dangerous`)؛ على حدث turn-end `Stop` السبب يحمل وصياغة MANDATORY-ACTION إعادة القوة لذا مدمجات `require-*-before-stop` تفرض. فقط أسماء الأدوات مُعادة عبر `DEVIN_TOOL_MAP` (`exec→Bash`؛ `tool_input.command` بالفعل canonical). Devin أيضاً مصدر تدقيق **غير محترق** — لوحة المعلومات تقرأ جلسات SQLite في `~/.local/share/devin/cli/sessions.db` (كل صف `sessions` يحمل `working_directory` حقيقي، لذا جلسات المجموعة حسب مشروع cwd مثل Claude).
+  - **Antigravity CLI (`agy`)**: `~/.gemini/config/hooks.json` (مستخدم)، `<cwd>/.agents/hooks.json` (مشروع) — Antigravity لا يوجد لديه نطاق محلي. بخلاف Factory/Devin، Antigravity لديها عقدها **الخاص بها** (ليس مستنسخ Claude)، تحقق مباشر ضد agy v1.1.2. `hooks.json` يستخدم مخطط **named-hook**: المفتاح ذو المستوى الأعلى هو حمل *اسم* (`"failproofai"`) قيمته حدث→ خريطة معالجات — أحداث الأدوات (`PreToolUse`/`PostToolUse`) تلف معالجات في `{matcher:"*", hooks:[…]}`، بينما `PreInvocation`/`Stop` هي **مسطحة** مصفوفات معالج (الخطافات المسماة الأخرى محفوظة). payload stdin هو **camelCase protojson** (`toolCall:{name,args}`، `conversationId`، `workspacePaths`، `transcriptPath`) — failproofai يطبعه إلى snake_case قبل تشغيل السياسات، ويعيد أسماء PascalCase للأداة `run_command` (`CommandLine`/`Cwd`) عبر `ANTIGRAVITY_TOOL_INPUT_MAP`. فرع `antigravity` المُقيِّم يستخدم أشكال استجابة Antigravity **الخاصة بها**: `{decision:"deny", reason}` يحجب أداة/موجه (خروج 0)، `{decision:"continue", reason}` على turn-end `Stop` يعيد دخول الحلقة (لذا مدمجات `require-*-before-stop` تفرض)، و `{injectSteps:[{ephemeralMessage}]}` يحقن تعليمات على `PreInvocation` (→ `UserPromptSubmit`). أسماء الأدوات canonicalize عبر `ANTIGRAVITY_TOOL_MAP` (`run_command→Bash`، `view_file→Read`، …). Antigravity أيضاً مصدر تدقيق **غير محترق** — لوحة المعلومات تقرأ نصوص JSONL عادية في `~/.gemini/antigravity-cli/brain/<conversationId>/.system_generated/logs/transcript_full.jsonl` (مؤشر محادثة في `conversation_summaries.db`).
+  - **Goose (codename goose, Block)**: `~/.agents/plugins/failproofai/hooks/hooks.json` (مستخدم)، `<cwd>/.agents/plugins/failproofai/hooks/hooks.json` (مشروع) — Goose لا يوجد لديه نطاق محلي. الإنفاذ يستخدم نظام **خطافات** Goose، المواصفات **Open Plugins** عبر العامل: المثبِّت يترك فقط مجلد `failproofai` والمكتشفات Goose تلقائياً عند بدء التشغيل (تسجيل ذاتي في `~/.config/goose/config.yaml`). `hooks.json` يستخدم مخطط Open Plugins **مع** غلاف `"hooks"` ذو المستوى الأعلى، والمُطابق **يُحذف** على كل حدث — regex مسطح `"*"` غير صحيح يطابق لا شيء (تحقق مباشر ضد goose v1.43.0). أسماء الأحداث بالفعل PascalCase (لا خريطة أحداث)؛ payload stdin يستخدم `event`/`working_dir`، التي معالج يطبعها إلى `hook_event_name`/`cwd`. فرع `goose` المُقيِّم يرفع مع JSON `{"decision":"block","reason"}` على stdout في خروج 0، مشرف على حدث **`PreToolUse`** فقط (شحن في goose ≥ v1.37.0) — الذي يطلق للأداة shell **وداخل subagents مفوضة**، لذا يكون نقطة الرفع الوحيدة الكافية؛ أي خطأ خطاف آخر يفشل **مفتوح**. Goose لا يوجد لديه حدث **`Stop`**، لذا مدمجات `require-*-before-stop` لا تطبق (مثل Hermes). أسماء الأدوات canonicalize عبر `GOOSE_TOOL_MAP` (`shell→Bash`، `write→Write`، `todo__todo_write→TodoWrite`، …) ومفاتيح المسار عبر `GOOSE_TOOL_INPUT_MAP` (`path`/`source` → `file_path`). Goose أيضاً مصدر تدقيق **غير محترق** — لوحة المعلومات تقرأ جلسات SQLite في `~/.local/share/goose/sessions/sessions.db` (كل صف `sessions` يحمل `working_dir` حقيقي، لذا جلسات المجموعة حسب مشروع cwd مثل Devin؛ `--no-session` جلسات خدش يتم تصفيتها).
+- **`policies-config.json`** — تخبر failproofai بالسياسات المراد تقييمها وبأي معاملات (مشتركة عبر جميع agent CLIs)
+
+مرر `--cli claude|codex|copilot|cursor|opencode|pi|hermes|openclaw|factory|devin|antigravity|goose` لاستهداف عامل معين (مفصول بمسافة أو مكرر لأي مجموعة فرعية):
+
+```bash
+failproofai policies --install --cli codex --scope project
+failproofai policies --install --cli copilot --scope project
+failproofai policies --install --cli cursor --scope project
+failproofai policies --install --cli opencode --scope project
+failproofai policies --install --cli pi --scope project
+failproofai policies --install --cli hermes --scope user
+failproofai policies --install --cli openclaw --scope user
+failproofai policies --install --cli factory --scope project
+failproofai policies --install --cli devin --scope project
+failproofai policies --install --cli antigravity --scope project
+failproofai policies --install --cli goose --scope project
+failproofai policies --install --cli claude codex copilot cursor opencode pi hermes openclaw factory devin antigravity goose
+```
+
+عندما يتم حذف `--cli`، يكتشف failproofai أي agent CLIs مثبتة (`which claude` / `which codex` / `which copilot` / `which cursor-agent` / `which opencode` / `which pi` / `which hermes` / `which openclaw` / `which droid` / `which devin` / `which agy` / `which goose`):
+
+- **تم اكتشاف CLI واحد** — تحديد تلقائي لهذا CLI بدون موجه.
+- **تم اكتشاف عدة CLIs** في محطة طرفية تفاعلية — يظهر موجه تحديد مفرد واحد محسوب إلى قسم `Detected (N)` (مع صف إجمالي `Install for all N detected` + كل CLI مكتشف على حدة) وقسم `Not installed (M) · install hooks ahead of time` يسرد كل CLI مدعوم غير مكتشف كخيار تثبيت forward (↑↓ للتحرك، Enter للتحديد، ^C للخروج). تدفق الإزالة يظهر فقط قسم Detected.
+- **تم اكتشاف عدة CLIs** في تشغيل non-interactive (CI، بدون TTY) — تثبيت لجميع CLIs المكتشفة بدون موجه.
+- **لم يتم اكتشاف أي منها** — fallback إلى `claude`، مع تحذير بأنه لم يتم العثور على ثنائي عامل في PATH؛ أمر الخطاف لا يزال مكتوب لذا يتم تنشيطه بمجرد تثبيت واحد.
+
+يمكنك تحرير `policies-config.json` مباشرة في أي وقت؛ التغييرات تدخل حيز التنفيذ فوراً على حدث الخطاف التالي بدون الحاجة لإعادة تشغيل.
+
+---
+
+## مثال: إعدادات على مستوى المشروع مع إعدادات افتراضية الفريق
+
+التزم `.failproofai/policies-config.json` إلى مستودعك:
+
+```json
+{
+  "enabledPolicies": [
+    "block-sudo",
+    "block-rm-rf",
+    "block-push-master",
+    "sanitize-api-keys",
+    "block-env-files"
+  ],
+  "policyParams": {
+    "block-push-master": {
+      "protectedBranches": ["main", "release", "hotfix"]
+    }
+  }
+}
+```
+
+يمكن لكل مطور بعد ذلك إنشاء `.failproofai/policies-config.local.json` (مُستثناة من git) لتجاوزات شخصية بدون التأثير على زملائهم.

package/.next/standalone/docs-old/ar/custom-policies.mdx

@@ -0,0 +1,359 @@
+---
+---
+title: السياسات المخصصة
+description: "اكتب قواعدك الخاصة في JavaScript - فرض الاتفاقيات، منع الانحراف، الكشف عن الأخطاء، التكامل مع الأنظمة الخارجية"
+icon: code
+---
+
+تتيح لك السياسات المخصصة كتابة قواعد لأي سلوك وكيل: فرض اتفاقيات المشروع، منع الانحراف، حماية العمليات المدمرة، الكشف عن الوكلاء العالقة، أو التكامل مع Slack وسير العمل الموافقة والمزيد. تستخدم نفس نظام أحداث الخطاف وقرارات `allow` و `deny` و `instruct` كما هو الحال في السياسات المدمجة.
+
+---
+
+## مثال سريع
+
+```js
+// my-policies.js
+import { customPolicies, allow, deny, instruct } from "failproofai";
+
+customPolicies.add({
+  name: "no-production-writes",
+  description: "Block writes to paths containing 'production'",
+  match: { events: ["PreToolUse"] },
+  fn: async (ctx) => {
+    if (ctx.toolName !== "Write" && ctx.toolName !== "Edit") return allow();
+    const path = ctx.toolInput?.file_path ?? "";
+    if (path.includes("production")) {
+      return deny("Writes to production paths are blocked");
+    }
+    return allow();
+  },
+});
+```
+
+ثبتها:
+
+```bash
+failproofai policies --install --custom ./my-policies.js
+```
+
+---
+
+## طريقتان لتحميل السياسات المخصصة
+
+### الخيار 1: القائم على الاتفاقية (موصى به)
+
+انقل ملفات `*policies.{js,mjs,ts}` إلى `.failproofai/policies/` وسيتم تحميلها تلقائياً - لا توجد علامات أو تغييرات في الإعدادات مطلوبة. يعمل هذا مثل git hooks: انقل ملفاً، وسيعمل ببساطة.
+
+```
+# مستوى المشروع - مرتكز في git، مشترك مع الفريق
+.failproofai/policies/security-policies.mjs
+.failproofai/policies/workflow-policies.mjs
+
+# المستوى الشخصي - شخصي، ينطبق على جميع المشاريع
+~/.failproofai/policies/my-policies.mjs
+```
+
+**كيفية العمل:**
+- يتم البحث في كلا المجلدين (الاتحاد - وليس الأول يفوز)
+- يتم تحميل الملفات أبجدياً داخل كل دليل. بادئة بـ `01-` و `02-` للتحكم في الترتيب
+- يتم تحميل الملفات المطابقة فقط لـ `*policies.{js,mjs,ts}`؛ يتم تجاهل الملفات الأخرى
+- يتم تحميل كل ملف بشكل مستقل (فتح فاشل لكل ملف)
+- يعمل جنباً إلى جنب مع سياسات `--custom` الصريحة والمدمجة
+
+<Tip>
+سياسات الاتفاقية هي أسهل طريقة لبناء معيار الجودة لمنظمتك. احرص على `.failproofai/policies/` في git وكل عضو فريق سيحصل على نفس القواعد تلقائياً - لا توجد إعدادات منفصلة لكل مطور مطلوبة. عندما يكتشف فريقك أنماط فشل جديدة، أضف سياسة وادفع. بمرور الوقت، تصبح هذه معيار جودة حي يتحسن مع كل مساهمة.
+</Tip>
+
+### الخيار 2: مسار الملف الصريح
+
+```bash
+# التثبيت مع ملف سياسات مخصصة
+failproofai policies --install --custom ./my-policies.js
+
+# استبدال مسارات السياسات المخصصة
+failproofai policies --install --custom ./new-policies.js
+
+# تكوين ملفات متعددة صريحة (محملة بترتيب العلم)
+failproofai policies --install --custom ./security.js --custom ./workflow.js
+
+# إزالة جميع مسارات السياسات المخصصة الصريحة من الإعدادات
+failproofai policies --uninstall --custom
+```
+
+يتم تخزين المسارات المطلقة المحللة في `policies-config.json` كـ `customPoliciesPaths`. كرر `--custom` لتكوين ملفات متعددة. تستمر الإعدادات الموجودة في استخدام حقل `customPoliciesPath` القديم في العمل. يتم تحميل الملفات بشكل طازج في كل حدث خطاف - لا يوجد تخزين مؤقت بين الأحداث.
+
+تظهر كل سياسة مسجلة مع تبديلها الخاص في لوحة التحكم. التبديل للسياسة يسجل معرّفها المؤهل بالمصدر في `disabledCustomPolicies`؛ يستمر الملف وسياساته الأخرى في التحميل، بينما يتم استبعاد السياسة المعطلة قبل مطابقة الأحداث. للسياسات المكررة عبر الملفات تبديلات مستقلة.
+
+### استخدام الاثنين معاً
+
+يمكن أن توجد سياسات الاتفاقية وملفات `--custom` الصريحة معاً. ترتيب التحميل:
+
+1. ملفات `customPoliciesPaths` الصريحة (بالترتيب المكون)
+2. ملفات اتفاقية المشروع (`{cwd}/.failproofai/policies/`، أبجدياً)
+3. ملفات الاتفاقية للمستخدم (`~/.failproofai/policies/`، أبجدياً)
+
+---
+
+## واجهة برمجية التطبيقات
+
+### الاستيراد
+
+```js
+import { customPolicies, allow, deny, instruct } from "failproofai";
+```
+
+### `customPolicies.add(hook)`
+
+يسجل سياسة. استدعِها عدة مرات حسب الحاجة لعدة سياسات في نفس الملف.
+
+```ts
+customPolicies.add({
+  name: string;                         // مطلوب - معرّف فريد
+  description?: string;                 // معروض في مخرجات `failproofai policies`
+  match?: { events?: HookEventType[] }; // تصفية حسب نوع الحدث؛ حذف للمطابقة الجميع
+  fn: (ctx: PolicyContext) => PolicyResult | Promise<PolicyResult>;
+});
+```
+
+### مساعدات القرار
+
+| الدالة | التأثير | الاستخدام متى |
+|----------|--------|----------|
+| `allow()` | السماح بالعملية بصمت | الإجراء آمن، لا توجد رسالة مطلوبة |
+| `deny(message)` | منع العملية | الوكيل لا يجب أن يتخذ هذا الإجراء |
+| `instruct(message)` | إضافة سياق بدون حظر | إعطاء الوكيل سياق إضافي للبقاء على المسار |
+
+`deny(message)` - الرسالة تظهر لـ Claude بادئة بـ `"Blocked by failproofai:"`. عملية `deny` واحدة توقف جميع التقييمات الإضافية.
+
+`instruct(message)` - تُضاف الرسالة إلى سياق Claude للاستدعاء الحالي للأداة. يتم تجميع جميع رسائل `instruct` وتسليمها معاً.
+
+<Tip>
+يمكنك إضافة إرشادات إضافية إلى أي رسالة `deny` أو `instruct` بإضافة حقل `hint` في `policyParams` - لا حاجة لتغيير الكود. يعمل هذا مع السياسات المخصصة (`custom/`)، واتفاقية المشروع (`.failproofai-project/`)، واتفاقية المستخدم (`.failproofai-user/`) أيضاً. انظر [التكوين → hint](/ar/configuration#hint-cross-cutting) للتفاصيل.
+</Tip>
+
+### رسائل السماح المعلوماتية
+
+`allow(message)` يسمح بالعملية **و** يرسل رسالة إعلامية إلى Claude. يتم تسليم الرسالة كـ `additionalContext` في استجابة stdout لمعالج الخطاف - نفس الآلية المستخدمة بـ `instruct`، لكن من الناحية الدلالية مختلفة: إنه تحديث الحالة، وليس تحذير.
+
+| الدالة | التأثير | الاستخدام متى |
+|----------|--------|----------|
+| `allow(message)` | السماح وإرسال السياق إلى Claude | تأكيد نجاح الفحص، أو شرح سبب تخطي الفحص |
+
+حالات الاستخدام:
+- **تأكيدات الحالة:** `allow("All CI checks passed.")` - يخبر Claude أن كل شيء أخضر
+- **شروحات الفتح الفاشل:** `allow("GitHub CLI not installed, skipping CI check.")` - يخبر Claude لماذا تم تخطي الفحص حتى يكون لديه السياق الكامل
+- **تراكم الرسائل المتعددة:** إذا أرجعت عدة سياسات `allow(message)`، يتم ربط جميع الرسائل بفواصل أسطر وتسليمها معاً
+
+```js
+customPolicies.add({
+  name: "confirm-branch-status",
+  match: { events: ["Stop"] },
+  fn: async (ctx) => {
+    const cwd = ctx.session?.cwd;
+    if (!cwd) return allow("No working directory, skipping branch check.");
+
+    // ... check branch status ...
+    if (allPushed) {
+      return allow("Branch is up to date with remote.");
+    }
+    return deny("Unpushed changes detected.");
+  },
+});
+```
+
+### حقول `PolicyContext`
+
+| الحقل | النوع | الوصف |
+|-------|------|-------------|
+| `eventType` | `string` | `"PreToolUse"`, `"PostToolUse"`, `"Notification"`, `"Stop"` |
+| `toolName` | `string \| undefined` | الأداة التي يتم استدعاؤها (مثل `"Bash"`, `"Write"`, `"Read"`) |
+| `toolInput` | `Record<string, unknown> \| undefined` | معاملات إدخال الأداة |
+| `payload` | `Record<string, unknown>` | حمل الحدث الأولي الكامل من Claude Code |
+| `session` | `SessionMetadata \| undefined` | سياق الجلسة (انظر أدناه) |
+
+### حقول `SessionMetadata`
+
+| الحقل | النوع | الوصف |
+|-------|------|-------------|
+| `sessionId` | `string` | معرّف جلسة Claude Code |
+| `cwd` | `string` | دليل العمل لجلسة Claude Code |
+| `transcriptPath` | `string` | المسار إلى ملف نسخة JSONL للجلسة |
+
+### أنواع الأحداث
+
+| الحدث | متى يتم تشغيله | محتويات `toolInput` |
+|-------|--------------|----------------------|
+| `PreToolUse` | قبل أن يقوم Claude بتشغيل أداة | إدخال الأداة (مثل `{ command: "..." }` للـ Bash) |
+| `PostToolUse` | بعد انتهاء الأداة | إدخال الأداة + `tool_result` (الإخراج) |
+| `Notification` | عندما يرسل Claude إخطاراً | `{ message: "...", notification_type: "idle" \| "permission_prompt" \| ... }` - يجب أن ترجع الخطافات دائماً `allow()`، لا يمكنها حظر الإخطارات |
+| `Stop` | عند انتهاء جلسة Claude | فارغ |
+
+---
+
+## ترتيب التقييم
+
+يتم تقييم السياسات بهذا الترتيب:
+
+1. السياسات المدمجة (بترتيب التعريف)
+2. السياسات المخصصة الصريحة من `customPoliciesPath` (بترتيب `.add()`)
+3. سياسات الاتفاقية من المشروع `.failproofai/policies/` (ملفات أبجدياً، ترتيب `.add()` داخل)
+4. سياسات الاتفاقية من المستخدم `~/.failproofai/policies/` (ملفات أبجدياً، ترتيب `.add()` داخل)
+
+<Note>
+أول `deny` توقف جميع السياسات اللاحقة. يتم تجميع جميع رسائل `instruct` وتسليمها معاً.
+</Note>
+
+---
+
+## الاستيرادات المتعدية
+
+يمكن لملفات السياسات المخصصة استيراد الوحدات المحلية باستخدام المسارات النسبية:
+
+```js
+// my-policies.js
+import { isBlockedPath } from "./utils.js";
+import { checkApproval } from "./approval-client.js";
+
+customPolicies.add({
+  name: "approval-gate",
+  fn: async (ctx) => {
+    if (ctx.toolName !== "Bash") return allow();
+    const approved = await checkApproval(ctx.toolInput?.command, ctx.session?.sessionId);
+    return approved ? allow() : deny("Approval required for this command");
+  },
+});
+```
+
+يتم حل جميع الاستيرادات النسبية التي يمكن الوصول إليها من ملف الإدخال. يتم تنفيذ هذا عن طريق إعادة كتابة استيرادات `from "failproofai"` إلى مسار التوزيع الفعلي وإنشاء ملفات `.mjs` مؤقتة لضمان التوافق ESM.
+
+---
+
+## تصفية نوع الحدث
+
+استخدم `match.events` لتحديد وقت تشغيل السياسة:
+
+```js
+customPolicies.add({
+  name: "require-summary-on-stop",
+  match: { events: ["Stop"] },
+  fn: async (ctx) => {
+    // تشغيل فقط عند انتهاء الجلسة
+    // ctx.session.transcriptPath يحتوي على سجل الجلسة الكامل
+    return allow();
+  },
+});
+```
+
+حذف `match` بالكامل للتشغيل على كل نوع حدث.
+
+---
+
+## معالجة الأخطاء وأنماط الفشل
+
+السياسات المخصصة **فتح فاشل**: الأخطاء لا تحظر السياسات المدمجة ولا تتسبب في تحطم معالج الخطاف.
+
+| الفشل | السلوك |
+|---------|----------|
+| لم تعيّن `customPoliciesPath` | لا تعمل سياسات مخصصة صريحة؛ تستمر سياسات الاتفاقية والمدمجة بشكل طبيعي |
+| الملف غير موجود | يتم تسجيل تحذير في `~/.failproofai/hook.log`؛ تستمر المدمجات |
+| خطأ بناء جملة / استيراد (صريح) | يتم تسجيل الخطأ في `~/.failproofai/hook.log`؛ تم تخطي سياسات مخصصة صريحة |
+| خطأ بناء جملة / استيراد (اتفاقية) | يتم تسجيل الخطأ؛ تم تخطي هذا الملف، لا تزال ملفات الاتفاقية الأخرى تحمل |
+| `fn` يرمي في وقت التشغيل | يتم تسجيل الخطأ؛ يتم التعامل مع هذا الخطاف كـ `allow`؛ تستمر الخطافات الأخرى |
+| `fn` يأخذ أكثر من 10 ثوان | يتم تسجيل انتهاء المهلة الزمنية؛ يتم التعامل معه كـ `allow` |
+| دليل الاتفاقية مفقود | لا توجد سياسات اتفاقية؛ لا خطأ |
+
+<Tip>
+لتصحيح أخطاء السياسات المخصصة، راقب ملف السجل:
+
+```bash
+tail -f ~/.failproofai/hook.log
+```
+</Tip>
+
+---
+
+## مثال كامل: سياسات متعددة
+
+```js
+// my-policies.js
+import { customPolicies, allow, deny, instruct } from "failproofai";
+
+// منع الوكيل من الكتابة إلى دليل secrets/
+customPolicies.add({
+  name: "block-secrets-dir",
+  description: "Prevent agent from writing to secrets/ directory",
+  match: { events: ["PreToolUse"] },
+  fn: async (ctx) => {
+    if (!["Write", "Edit"].includes(ctx.toolName ?? "")) return allow();
+    const path = ctx.toolInput?.file_path ?? "";
+    if (path.includes("secrets/")) return deny("Writing to secrets/ is not permitted");
+    return allow();
+  },
+});
+
+// ابق الوكيل على المسار: تحقق من الاختبارات قبل الالتزام
+customPolicies.add({
+  name: "remind-test-before-commit",
+  description: "Keep the agent on track: verify tests pass before committing",
+  match: { events: ["PreToolUse"] },
+  fn: async (ctx) => {
+    if (ctx.toolName !== "Bash") return allow();
+    const cmd = ctx.toolInput?.command ?? "";
+    if (/git\s+commit/.test(cmd)) {
+      return instruct("Verify all tests pass before committing. Run `bun test` if you haven't already.");
+    }
+    return allow();
+  },
+});
+
+// منع التغييرات غير المخطط لها في المتطلبات أثناء التجميد
+customPolicies.add({
+  name: "dependency-freeze",
+  description: "Prevent unplanned dependency changes during freeze period",
+  match: { events: ["PreToolUse"] },
+  fn: async (ctx) => {
+    if (ctx.toolName !== "Bash") return allow();
+    const cmd = ctx.toolInput?.command ?? "";
+    const isInstall = /^(npm install|yarn add|bun add|pnpm add)\s+\S/.test(cmd);
+    if (isInstall && process.env.DEPENDENCY_FREEZE === "1") {
+      return deny("Package installs are frozen. Unset DEPENDENCY_FREEZE to allow.");
+    }
+    return allow();
+  },
+});
+
+export { customPolicies };
+```
+
+---
+
+## أمثلة
+
+يحتوي الدليل `examples/` على ملفات السياسات الجاهزة للتشغيل:
+
+| الملف | المحتوى |
+|------|----------|
+| `examples/policies-basic.js` | خمس سياسات بدء تغطي أنماط فشل الوكيل الشائعة |
+| `examples/policies-advanced/index.js` | أنماط متقدمة: استيرادات متعدية، استدعاءات غير متزامنة، كشط الإخراج، خطافات نهاية الجلسة |
+| `examples/convention-policies/security-policies.mjs` | سياسات الأمان القائمة على الاتفاقية (منع كتابة .env، منع إعادة كتابة سجل git) |
+| `examples/convention-policies/workflow-policies.mjs` | سياسات سير العمل القائمة على الاتفاقية (تذكيرات الاختبار، ملفات الكتابة الحسابية) |
+
+### استخدام أمثلة الملفات الصريحة
+
+```bash
+failproofai policies --install --custom ./examples/policies-basic.js
+```
+
+### استخدام أمثلة قائمة على الاتفاقية
+
+```bash
+# نسخ إلى مستوى المشروع
+mkdir -p .failproofai/policies
+cp examples/convention-policies/*.mjs .failproofai/policies/
+
+# أو نسخ إلى مستوى المستخدم
+mkdir -p ~/.failproofai/policies
+cp examples/convention-policies/*.mjs ~/.failproofai/policies/
+```
+
+لا توجد حاجة لأمر التثبيت - يتم التقاط الملفات تلقائياً عند حدث الخطاف التالي.