failproofai 1.0.1-beta.1 → 1.0.1

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

@@ -0,0 +1,152 @@
+---
+---
+title: لوحة التحكم
+description: "مراقبة جلسات الوكيل، ومراجعة استدعاءات الأدوات، وإدارة السياسات"
+icon: chart-line
+---
+
+لوحة تحكم failproofai هي تطبيق ويب محلي لمراقبة جلسات وكيل الذكاء الاصطناعي لديك وإدارة السياسات. اطّلع على ما فعله وكلاؤك أثناء غيابك.
+
+---
+
+## بدء لوحة التحكم
+
+```bash
+failproofai
+```
+
+يفتح على `http://localhost:8020`.
+
+تقرأ لوحة التحكم بيانات المشروع المحلية والجلسة وتكوين failproofai مباشرة من نظام الملفات. تُرسل الميزات المصرح بها الاختيارية، مثل تذكيرات التدقيق والدعوات، المعلومات المطلوبة لتلك الطلبات (بما في ذلك عناوين البريد الإلكتروني) إلى واجهات برمجية بعيدة.
+
+---
+
+## الصفحات
+
+### المشاريع
+
+يسرد جميع مشاريع Claude Code و OpenAI Codex و GitHub Copilot CLI _(beta)_ و Cursor Agent _(beta)_ و OpenCode _(beta)_ و Pi _(beta)_ و Hermes و OpenClaw و Factory Droid و Devin و Antigravity و Goose الموجودة على جهازك. يتم اكتشاف مشاريع Claude من `~/.claude/projects/` (أو المسار المحدد بواسطة `CLAUDE_PROJECTS_PATH`); يتم اكتشاف مشاريع Codex من خلال مسح كل نسخة من النصوص تحت `~/.codex/sessions/<YYYY>/<MM>/<DD>/*.jsonl` وتجميعها حسب `cwd` المسجلة في السجل الأول لكل جلسة; يتم اكتشاف مشاريع Copilot CLI من خلال مسح كل `~/.copilot/session-state/<sessionId>/workspace.yaml` (قابل للتكوين عبر `COPILOT_HOME`) وتجميعها حسب حقل `cwd`; يتم اكتشاف مشاريع Cursor Agent من خلال مسح البيانات الوصفية لكل جلسة تحت `~/.cursor/agent-sessions/<sessionId>/` (قابل للتكوين عبر `CURSOR_HOME`، مع اختبار `conversations/` و `sessions/` كبدائل) للبحث عن `cwd` scalar في `meta.json` / `session.json` / `workspace.yaml`; يتم اكتشاف مشاريع OpenCode بالاستعلام عن قاعدة بيانات SQLite الخاصة بها في `~/.local/share/opencode/opencode.db` عبر `opencode db --format json` (نقرأ جداول `session` و `project` ونجمعها حسب `project_id`); يتم اكتشاف مشاريع Pi من خلال مسح نصوص JSONL لكل جلسة تحت `~/.pi/agent/sessions/<encoded-cwd>/<timestamp>_<uuid>.jsonl` (قابل للتكوين عبر `PI_SESSIONS_DIR`) والحصول على `cwd` من السجل الأول لكل جلسة; يتم قراءة جلسات بوابة Hermes مباشرة من متجر SQLite لكل ملف تعريف — `~/.hermes/state.db` بالإضافة إلى `~/.hermes/profiles/<name>/state.db` (قابل للتجاوز عبر `HERMES_HOME`، أو `HERMES_DB_PATH` لقاعدة بيانات واحدة) — وتجميعها في مشاريع `hermes-<profile>-<source>` حسب الملف الشخصي و `source` (Slack/Telegram/cli/cron — جلسات البوابة لا تحتوي على cwd); يتم قراءة جلسات بوابة OpenClaw من `~/.openclaw/agents/<agentId>/sessions/*.jsonl` وتجميعها في مشاريع `openclaw-<agentId>-<channel>` حسب الوكيل والقناة (أيضًا بدون cwd); يتم اكتشاف مشاريع Factory Droid من نصوص JSONL في `~/.factory/sessions/<encoded-cwd>/*.jsonl` وتجميعها حسب cwd; مشاريع Devin من قاعدة بيانات SQLite الخاصة بها في `~/.local/share/devin/cli/sessions.db` (مجمعة حسب `working_directory` لكل جلسة); مشاريع Antigravity من نصوص JSONL في `~/.gemini/antigravity-cli/brain/<conversationId>/…/transcript_full.jsonl` وتجميعها حسب cwd; ومشاريع Goose من قاعدة بيانات SQLite الخاصة بها في `~/.local/share/goose/sessions/sessions.db` (مجمعة حسب `working_dir` لكل جلسة). يتم عرض المشروع الذي تم استخدامه بواسطة عدة CLIs كصف واحد بجميع الشارات المطابقة. استخدم القائمة المنسدلة **CLI** أعلى الجدول للتصفية حسب CLI وكيل محدد; يحفظ URL اختيارك كـ `?cli=claude|codex|copilot|cursor|opencode|pi|hermes|openclaw|factory|devin|antigravity|goose`.
+
+يكون Hermes و OpenClaw مقيدين بنطاق المستخدم ولا يوجد دليل عمل للتجميع حسبها، لذا يتم عرضهما كـ **شجرة مجلدات قابلة للطي** — الملف الشخصي (أو الوكيل) على المستوى الأعلى، وقنواته تحته — بينما يبقى كل CLI مستند إلى cwd صفًا مسطحًا. تتجمع صفوف المجلد عدد الجلسات والنشاط الأخير لكل شيء تحتها، يتم تذكر المجلدات المطويّة بين الزيارات، وتوسع البحث الكلمات الأساسية ما تطابقه.
+
+يعرض كل مشروع:
+- اسم المشروع (مشتق من مسار المجلد)
+- شارة CLI — `Claude Code` (برتقالي)، `OpenAI Codex` (بنفسجي)، `GitHub Copilot` (أزرق)، `Cursor Agent` (أخضر زمردي)، `OpenCode` (كهرماني)، `Pi` (وردي)، و/أو `Hermes` (نيلي)
+- تاريخ نشاط الجلسة الأخيرة
+
+انقر على مشروع لمعاينة جلساته.
+
+### الجلسات
+
+يسرد جميع الجلسات ضمن مشروع. تعرض كل جلسة:
+- معرّف الجلسة
+- طوابع زمنية البداية والنهاية
+- عدد استدعاءات الأدوات
+- عدد أنشطة الخطاف (السياسات التي تم تفعيلها)
+
+استخدم مرشح نطاق التاريخ والبحث عن معرّف الجلسة لتضييق القائمة. يتم تقسيم الجلسات إلى صفحات.
+
+انقر على جلسة لفتح عارض الجلسة.
+
+### عارض الجلسة
+
+يجيب عارض الجلسة على السؤال الرئيسي للوكلاء المستقلين: ماذا فعل الوكيل، وهل بقي على المسار الصحيح؟ تشير شارة CLI بجوار الرأس إلى ما إذا كانت الجلسة عبارة عن نسخة Claude Code أو OpenAI Codex أو GitHub Copilot CLI أو Cursor Agent أو OpenCode أو Pi أو Hermes أو OpenClaw أو Factory Droid أو Devin أو Antigravity أو Goose. يعرض جدول زمني لكل شيء حدث في جلسة:
+
+- **الرسائل** - ردود Claude النصية والطلبات من المستخدم
+- **استدعاءات الأدوات** - كل أداة استدعاها Claude، مع مدخلاتها ومخرجاتها
+- **نشاط السياسة** - لكل استدعاء أداة، السياسات التي تم تفعيلها والقرار الذي أعادته
+
+يعرض شريط الإحصائيات في الأعلى مدة الجلسة والعدد الإجمالي لاستدعاءات الأدوات وملخص قرارات الخطاف (عدد allow / deny / instruct).
+
+انقر على زر **تنزيل السجلات** لتصدير الجلسة. بالنسبة لجلسات Claude Code و Codex و Copilot و Cursor و Pi، تحصل على نسخة JSONL الأصلية على القرص بالضبط؛ بالنسبة لـ OpenCode (التي تعيش جلساتها في SQLite وليس على القرص)، تحصل على مستند JSON يعكس جداول `session` / `messages` / `parts` الأساسية.
+
+### التدقيق
+
+تقرير يحركه الشخصية حول كيفية سلوك وكيلك بالفعل عبر الجلسات الماضية. يشغّل نفس المسح الذي يقوم به CLI لـ `failproofai audit` لكن يعرضه كملصق شاشة واحد قابل للمشاركة + أربعة أقسام تحت الطي:
+
+1. **الملصق** — يملأ منفذ العرض الأول. منطقة PNG ذاتية التضمن مع علامة failproof_ai + تسمية التدقيق · فهرس النمط الأصلي (`№ NN of 08`) + تاريخ التدقيق · درجة رقمية (0–100) + حبة تصنيف النسبة المئوية (`top 15%`) · اسم النمط الأصلي (واحد من `the optimist`، `the cowboy`، `the explorer`، `the goldfish`، `the paranoid architect`، `the precision builder`، `the hammer`، `the ghost`) + شريط 3 كلمات · `// only N% of agents are this archetype` سطر الندرة · بلاطة sigil 8×8 بكسل · `audit yours → failproof.ai` التذييل. تجلس ثلاثة أزرار مشاركة خارج صندوق الالتقاط: `post your archetype` (نية X)، `share on linkedin`، `download poster`. يتم تشغيل الالتقاط عبر `html-to-image` بحيث يطابق PNG عرض الشاشة بكسل لكل بكسل (الحدود المتقطعة، قناع شعار SVG، التدرجات، مقاييس الخطوط — الكل محفوظ).
+2. **نقاط القوة** — قائمة صفوف هادئة لسلوكيات وكيلك الذي يفعلها بالفعل بشكل صحيح، مشتقة من بيانات التدقيق المباشرة (معدل استدعاء الأداة النظيف، بدون دفع مباشر إلى main، صفر تسرب بيانات اعتماد، صفر عواصف إعادة محاولة) — يتم سطح كل منها فقط عندما يكون لدى السياسة ذات الصلة سجل نظيف عبر نافذة التدقيق.
+3. **الغرائب** — جدول ما تسرب، مرتب حسب الشدة: `when · what slipped + the policy that would've caught it · severity pill · seen`، حيث تقرأ التكرار `new` (مرة واحدة)، `N× seen` (2–9 مرات)، أو `recurring` (10+).
+4. **كيفية التحسن** — قائمة صفوف هادئة، واحدة لكل سياسة موصى بها: اسم السياسة بالأبيض، وصف سطر واحد، أمر التثبيت + زر نسخ على الجانب الأيمن. يقرأ رأس القسم `enable all N → projected <score> · <tier>` (الدرجة التي ستصل إليها مع تطبيق كل إصلاح)، وزر `[install all]` الخاص به ينسخ الأمر المدمج `failproofai policy add a b c …` لكل سياسة موصى بها.
+5. **العودة أفضل** — بطاقتان جنبًا إلى جنب. اليسار: ضع تذكيرًا (منتقي الإيقاع `3d` / `7d` / `14d` / `30d`; يستمر عبر `/api/auth/reminder` بمجرد المصادقة). اليمين: فتح امتيازات failproof — `invite a friend` يفتح نافذة تأخذ قائمة بريد إلكتروني للأصدقاء مفصولة بفواصل/مسافات/سطور جديدة (10 كحد أقصى لكل إرسال)، POST لهم إلى `/api/audit/invite`، الذي يحول إلى `POST /v0/invite` لخادم api. يرسل خادم api بريد إلكترونيًا واحدًا لكل مستقبل من `invite@failproof.ai` مع نسخة المرسل وتعيين `Reply-To`، بحيث يرى المستقبل من دعاهم والمرسل يحصل على نسخة في علبة الوارد الخاصة به. يتم توجيه المستخدمين المجهولين عبر `AuthDialog` أولاً بحيث يتم معرفة بريد المرسل قبل الدعوات. يعتبر الاستحقاق / تحقيق الامتيازات متابعة.
+
+مدفوع بوقت تشغيل `failproofai audit` — انظر [Audit CLI](/ar/cli/audit) لمحرك المسح الأساسي والأعلام المدعومة وثوابت التخزين المؤقت لكل نسخة. تخزن لوحة التحكم النتيجة الأخيرة في `~/.failproofai/audit-dashboard.json` (الوضع `0600`، فتحة واحدة، تخزين جديد يكتب فوق) بحيث تكون الزيارات الثانية فورية؛ **يتم رفض كل من التخزين المؤقت لكل نسخة ونتيجة كاملة عند القراءة بمجرد أن تصبح أقدم من 7 أيام** بحيث لا تخدم لوحة التحكم بصمت نتيجة بعمر أسبوع — بعد انتهاء الصلاحية `/audit` يسقط إلى حالته الفارغة ويطالب بتشغيل جديد. انقر على `[ re-audit now ]` بالقرب من أسفل التقرير POST `/api/audit/run` مع `noCache: true` — إعادة التدقيق تتجاوز التخزين المؤقت لكل نسخة وتعيد مسح كل نسخة من الصفر بدلاً من صامتة إرجاع النتيجة المخزنة مؤقتًا — وتستطلع لوحة التحكم `/api/audit/status` بـ 1Hz حتى ينتهي التشغيل؛ ينقر شريط تقدم وردي لاصق إلى أعلى منفذ العرض أثناء التشغيل مع موقت انقضاء، والنتيجة الطازجة تدخل في مكانها عند النجاح (لا إعادة تحميل كامل الصفحة؛ تترك إعادة التدقيق الفاشلة التقرير السابق سليمًا). عند الفشل يتحول الشريط إلى الأحمر مع نسخ مفتاح قبالة `RerunError.kind` (`timeout` / `network` / `post_failed`). يتم سطح الحالة الفارغة (لا يوجد تخزين مؤقت أو منتهي الصلاحية) وحالة الصفر جلسات (يوجد التخزين المؤقت لكن المسح لم يجد نسخ) بشكل منفصل.
+
+### السياسات
+
+صفحة بتبويبين لإدارة السياسات ومراجعة النشاط.
+
+<Tabs>
+  <Tab title="تبويب السياسات">
+  - تحديد متعدد لـ CLIs الوكيل التي يحميها failproofai من لوحة واحدة — Claude Code و OpenAI Codex و GitHub Copilot و Cursor Agent و OpenCode و Pi و Hermes جميعها لها صف مع حالة التثبيت (`Active` / `Detected` / `Inactive`)، ومسار إعدادات نطاق المستخدم، وتأكيد ملون العلامة التجارية. تحقق أو قم بإلغاء تحديد CLIs التي تريدها وانقر على `Apply changes` لتثبيت/إلغاء تثبيت الفرق في خطوة واحدة. يتم فحص CLIs الذي تم الكشف عن ملفه الثنائي على PATH مسبقًا.
+  - تبديل السياسات الفردية على أو إيقاف تشغيلها بنقرة واحدة (يكتب إلى `~/.failproofai/policies-config.json` — مشترك بين كل CLI مثبت)
+  - قم بتوسيع السياسة لتكوين معاملات (للسياسات التي تدعم `policyParams`)
+  - تعيين مسار ملف سياسات مخصص
+  </Tab>
+  <Tab title="تبويب النشاط">
+  - سجل مكتمل مرقم لكل حدث خطاف تم تفعيله عبر جميع الجلسات
+  - التصفية حسب القرار أو نوع الحدث أو CLI (Claude Code / OpenAI Codex / GitHub Copilot _(beta)_ / Cursor Agent _(beta)_ / OpenCode _(beta)_ / Pi _(beta)_ / Hermes / OpenClaw / Factory Droid / Devin / Antigravity / Goose) أو اسم السياسة أو معرّف الجلسة
+  - يعرض كل صف: الطابع الزمني، اسم السياسة، القرار، شارة CLI (برتقالي = Claude Code، بنفسجي = OpenAI Codex، أزرق = GitHub Copilot، أخضر زمردي = Cursor Agent، كهرماني = OpenCode، وردي = Pi، نيلي = Hermes، فيروزي = OpenClaw، وردي فاقع = Factory Droid، بنفسجي = Devin، سماوي = Antigravity، أخضر فاتح = Goose)، اسم الأداة، معرّف الجلسة، والسبب لقرارات deny/instruct
+  - انقر على معرّف الجلسة لفتح نسخته — يكتشف عارض الوكيل تلقائيًا أي CLI أطلق الخطاف (Claude `~/.claude/projects/…`، Codex `~/.codex/sessions/…`، Copilot CLI `~/.copilot/session-state/<id>/events.jsonl`، Cursor Agent `~/.cursor/agent-sessions/<id>/events.jsonl`، OpenCode `~/.local/share/opencode/opencode.db`، Pi `~/.pi/agent/sessions/<encoded-cwd>/<id>.jsonl`، Hermes `~/.hermes/state.db`، OpenClaw `~/.openclaw/agents/<id>/sessions/*.jsonl`، Factory Droid `~/.factory/sessions/<encoded-cwd>/<id>.jsonl`، Devin `~/.local/share/devin/cli/sessions.db`، Antigravity `~/.gemini/antigravity-cli/brain/<id>/…/transcript_full.jsonl`، Goose `~/.local/share/goose/sessions/sessions.db`) ويعرض شارة CLI المطابقة في الرأس
+  </Tab>
+</Tabs>
+
+---
+
+## الانتعاش التلقائي
+
+تحتوي لوحة التحكم على مبديل الانتعاش التلقائي في الملاح العلوي. عند التفعيل، تنعش الصفحة الحالية بشكل دوري لعرض الجلسات الجديدة ونشاط السياسة أثناء ظهورها. ضروري لمراقبة جلسات الوكيل المستقلة ذات المدة الطويلة.
+
+---
+
+## تعطيل الصفحات
+
+إذا كنت تحتاج فقط إلى بعض أجزاء لوحة التحكم، عيّن `FAILPROOFAI_DISABLE_PAGES` إلى قائمة مفصولة بفواصل لأسماء الصفحات:
+
+```bash
+FAILPROOFAI_DISABLE_PAGES=policies failproofai
+```
+
+القيم الصحيحة: `policies`، `projects`، `audit`.
+
+---
+
+## تكوين مسار المشاريع
+
+بشكل افتراضي، تقرأ لوحة التحكم من دليل مشاريع Claude Code القياسي. تجاوز ذلك للإعدادات المخصصة:
+
+```bash
+CLAUDE_PROJECTS_PATH=/custom/path/to/projects failproofai
+```
+
+---
+
+## الوصول من مضيف غير localhost
+
+عند تشغيل لوحة التحكم في **وضع التطوير** (`npm run dev`) والوصول إليها من اسم مضيف بخلاف `localhost` - على سبيل المثال، مجال مخصص أو IP بعيد أو URL محفور — قد تظهر تحذير مثل:
+
+```text
+⚠ Blocked cross-origin request to Next.js dev resource /_next/webpack-hmr from "dashboard.example.com".
+```
+
+هذا هو Next.js يحظر الوصول عبر الأصل إلى مورد HMR (إعادة تحميل الوحدة الساخنة) للخادم، وهي ميزة خاصة بـ dev فقط. للسماح لمضيفك، استخدم العلم `--allowed-origins`:
+
+```bash
+npm run dev -- --allowed-origins dashboard.example.com
+```
+
+بالنسبة لعدة مضيفين أو IPs، مرر قائمة مفصولة بفواصل:
+
+```bash
+npm run dev -- --allowed-origins dashboard.example.com,192.168.1.5
+```
+
+يمكنك أيضًا تعيين متغير البيئة `FAILPROOFAI_ALLOWED_DEV_ORIGINS` بدلاً من ذلك:
+
+```bash
+FAILPROOFAI_ALLOWED_DEV_ORIGINS=dashboard.example.com npm run dev
+```
+
+<Note>
+هذا ينطبق فقط على وضع dev. عند تشغيل `failproofai` (وضع الإنتاج)، لا يوجد websocket HMR ولا مشكلة مورد dev عبر الأصل.
+</Note>

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

@@ -0,0 +1,307 @@
+---
+title: أمثلة
+description: "كيفية إعداد hooks لـ Claude Code و Agents SDK"
+icon: book-open
+---
+
+أمثلة جاهزة للاستخدام لسيناريوهات شائعة. كل واحد يوضح كيفية التثبيت وما يمكن توقعه.
+
+---
+
+## إعداد hooks لـ Claude Code
+
+يتكامل Failproof AI مع Claude Code عبر [نظام hooks الخاص به](https://docs.anthropic.com/en/docs/claude-code/hooks). عند تشغيل `failproofai policies --install`، يسجل أوامر hook في ملف `settings.json` الخاص بـ Claude Code التي تعمل عند كل استدعاء أداة.
+
+<Steps>
+  <Step title="تثبيت failproofai">
+    ```bash
+    npm install -g failproofai
+    ```
+  </Step>
+  <Step title="تفعيل جميع السياسات المدمجة">
+    ```bash
+    failproofai policies --install
+    ```
+  </Step>
+  <Step title="التحقق من تسجيل hooks">
+    ```bash
+    cat ~/.claude/settings.json | grep failproofai
+    ```
+
+    يجب أن ترى إدخالات hook لأحداث `PreToolUse` و `PostToolUse` و `Notification` و `Stop`.
+  </Step>
+  <Step title="تشغيل Claude Code">
+    ```bash
+    claude
+    ```
+
+    تعمل السياسات تلقائياً عند كل استدعاء أداة. حاول طلب من Claude تشغيل `sudo rm -rf /` - سيتم حظره.
+  </Step>
+</Steps>
+
+---
+
+## إعداد hooks لـ Agents SDK
+
+إذا كنت تبني باستخدام [Agents SDK](https://docs.anthropic.com/en/docs/agents-sdk)، يمكنك استخدام نفس نظام hooks برمجياً.
+
+<Steps>
+  <Step title="تثبيت failproofai في مشروعك">
+    ```bash
+    npm install failproofai
+    ```
+  </Step>
+  <Step title="تكوين hooks في وكيلك">
+    مرر أوامر hook عند إنشاء عملية الوكيل الخاص بك. تعمل hooks بنفس الطريقة كما في Claude Code - عبر JSON في stdin/stdout:
+
+    ```bash
+    failproofai --hook PreToolUse   # يُستدعى قبل كل أداة
+    failproofai --hook PostToolUse  # يُستدعى بعد كل أداة
+    ```
+  </Step>
+  <Step title="اكتب سياسة مخصصة لوكيلك">
+    ```javascript
+    import { customPolicies, allow, deny } from "failproofai";
+
+    customPolicies.add({
+      name: "limit-to-project-dir",
+      description: "Keep the agent inside the project directory",
+      match: { events: ["PreToolUse"] },
+      fn: async (ctx) => {
+        const path = String(ctx.toolInput?.file_path ?? "");
+        if (path.startsWith("/") && !path.startsWith(ctx.session?.cwd ?? "")) {
+          return deny("Agent is restricted to the project directory");
+        }
+        return allow();
+      },
+    });
+    ```
+  </Step>
+  <Step title="تثبيت السياسة المخصصة">
+    ```bash
+    failproofai policies --install --custom ./my-agent-policies.js
+    ```
+  </Step>
+</Steps>
+
+---
+
+## حظر الأوامر المدمرة
+
+الإعداد الأكثر شيوعاً - منع الوكلاء من إلحاق الضرر الذي لا يمكن التراجع عنه.
+
+```bash
+failproofai policies --install block-sudo block-rm-rf block-force-push block-curl-pipe-sh
+```
+
+ما تفعله:
+- `block-sudo` - يحظر جميع أوامر `sudo`
+- `block-rm-rf` - يحظر حذف الملفات العودية
+- `block-force-push` - يحظر `git push --force`
+- `block-curl-pipe-sh` - يحظر نقل البرامج النصية البعيدة إلى shell
+
+---
+
+## منع تسريب الأسرار
+
+منع الوكلاء من رؤية أو تسريب بيانات الاعتماد في مخرجات الأداة.
+
+```bash
+failproofai policies --install sanitize-api-keys sanitize-jwt sanitize-connection-strings sanitize-bearer-tokens
+```
+
+تعمل هذه على `PostToolUse` - بعد تشغيل أداة، تنظف المخرجات قبل أن يراها الوكيل.
+
+---
+
+## احصل على تنبيهات Slack عندما يحتاج الوكلاء إلى الانتباه
+
+استخدم notification hook لإعادة توجيه تنبيهات الخمول إلى Slack.
+
+```javascript
+import { customPolicies, allow, instruct } from "failproofai";
+
+customPolicies.add({
+  name: "slack-on-idle",
+  description: "Alert Slack when the agent is waiting for input",
+  match: { events: ["Notification"] },
+  fn: async (ctx) => {
+    const webhookUrl = process.env.SLACK_WEBHOOK_URL;
+    if (!webhookUrl) return allow();
+
+    const message = String(ctx.payload?.message ?? "Agent is waiting");
+    const project = ctx.session?.cwd ?? "unknown";
+
+    try {
+      await fetch(webhookUrl, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          text: `*${message}*\nProject: \`${project}\``,
+        }),
+        signal: AbortSignal.timeout(5000),
+      });
+    } catch {
+      // never block the agent if Slack is unreachable
+    }
+
+    return allow();
+  },
+});
+```
+
+ثبتها:
+
+```bash
+SLACK_WEBHOOK_URL=https://hooks.slack.com/... failproofai policies --install --custom ./slack-alerts.js
+```
+
+---
+
+## اجعل الوكلاء على فرع واحد
+
+منع الوكلاء من تبديل الفروع أو الدفع إلى الفروع المحمية.
+
+```javascript
+import { customPolicies, allow, deny } from "failproofai";
+
+customPolicies.add({
+  name: "stay-on-branch",
+  description: "Prevent the agent from checking out other branches",
+  match: { events: ["PreToolUse"] },
+  fn: async (ctx) => {
+    if (ctx.toolName !== "Bash") return allow();
+    const cmd = String(ctx.toolInput?.command ?? "");
+    if (/git\s+checkout\s+(?!-b)/.test(cmd)) {
+      return deny("Stay on the current branch. Create a new branch with -b if needed.");
+    }
+    return allow();
+  },
+});
+```
+
+---
+
+## طلب الاختبارات قبل الالتزام
+
+ذكّر الوكلاء بتشغيل الاختبارات قبل الالتزام.
+
+```javascript
+import { customPolicies, allow, instruct } from "failproofai";
+
+customPolicies.add({
+  name: "test-before-commit",
+  description: "Remind the agent to run tests before committing",
+  match: { events: ["PreToolUse"] },
+  fn: async (ctx) => {
+    if (ctx.toolName !== "Bash") return allow();
+    const cmd = String(ctx.toolInput?.command ?? "");
+    if (/git\s+commit/.test(cmd)) {
+      return instruct("Run tests before committing. Use `npm test` or `bun test` first.");
+    }
+    return allow();
+  },
+});
+```
+
+---
+
+## قفل مستودع الإنتاج
+
+التزم بتكوين على مستوى المشروع بحيث يحصل كل مطور في فريقك على نفس السياسات.
+
+أنشئ `.failproofai/policies-config.json` في مستودعك:
+
+```json
+{
+  "enabledPolicies": [
+    "block-sudo",
+    "block-rm-rf",
+    "block-force-push",
+    "block-push-master",
+    "block-env-files",
+    "sanitize-api-keys",
+    "sanitize-jwt"
+  ],
+  "policyParams": {
+    "block-push-master": {
+      "protectedBranches": ["main", "release", "production"]
+    }
+  }
+}
+```
+
+ثم التزم بها:
+
+```bash
+git add .failproofai/policies-config.json
+git commit -m "Add failproofai team policies"
+```
+
+كل عضو في الفريق لديه failproofai مثبت سيختار هذه القواعد تلقائياً.
+
+---
+
+## بناء معيار جودة على مستوى المنظمة باستخدام سياسات الاتفاقية
+
+الإعداد الأكثر تأثيراً: التزم بـ `.failproofai/policies/` في مستودعك مع سياسات مصممة لمشروعك. يحصل كل عضو في الفريق عليها تلقائياً — بدون أوامر تثبيت، بدون تغييرات في الإعدادات.
+
+<Steps>
+  <Step title="أنشئ الدليل وأضف السياسات">
+    ```bash
+    mkdir -p .failproofai/policies
+    ```
+
+    ```js
+    // .failproofai/policies/team-policies.mjs
+    import { customPolicies, allow, deny, instruct } from "failproofai";
+
+    // Enforce your team's preferred package manager
+    // (or enable the built-in prefer-package-manager policy instead)
+    customPolicies.add({
+      name: "enforce-bun",
+      match: { events: ["PreToolUse"] },
+      fn: async (ctx) => {
+        if (ctx.toolName !== "Bash") return allow();
+        const cmd = String(ctx.toolInput?.command ?? "");
+        if (/\bnpm\b/.test(cmd)) return deny("Use bun instead of npm.");
+        return allow();
+      },
+    });
+
+    // Remind the agent to run tests before committing
+    customPolicies.add({
+      name: "test-before-commit",
+      match: { events: ["PreToolUse"] },
+      fn: async (ctx) => {
+        if (ctx.toolName !== "Bash") return allow();
+        if (/git\s+commit/.test(ctx.toolInput?.command ?? "")) {
+          return instruct("Run tests before committing.");
+        }
+        return allow();
+      },
+    });
+    ```
+  </Step>
+  <Step title="التزم بـ git">
+    ```bash
+    git add .failproofai/policies/
+    git commit -m "Add team quality policies"
+    ```
+  </Step>
+  <Step title="استمر في التحسن">
+    عندما يواجه فريقك أنماط فشل جديدة، أضف سياسات وادفع. يحصل الجميع على التحديث في `git pull` التالي. تصبح هذه السياسات معيار جودة حي ينمو مع فريقك.
+  </Step>
+</Steps>
+
+---
+
+## أمثلة أخرى
+
+يحتوي دليل [`examples/`](https://github.com/failproofai/failproofai/tree/main/examples) في المستودع على:
+
+| الملف | ما يظهره |
+|------|----------|
+| `policies-basic.js` | سياسات البدء - حظر كتابات الإنتاج والدفع القسري والبرامج النصية الموجهة |
+| `policies-notification.js` | تنبيهات Slack لإخطارات الخمول ونهاية الجلسة |
+| `policies-advanced/index.js` | الاستيرادات الانتقالية والخطافات غير المتزامنة وتنظيف مخرجات PostToolUse ومعالجة حدث Stop |

package/.next/standalone/docs-old/ar/for-agents.mdx

@@ -0,0 +1,38 @@
+---
+title: "للوكلاء"
+description: "أضف معرفة Failproof AI إلى وكيل الترميز الخاص بك بأمر واحد. يعمل مع Claude Code و Cursor و Windsurf والمزيد."
+---
+
+أضف مرجع Failproof AI الكامل إلى وكيل الترميز الخاص بك بأمر واحد. يعمل مع Claude Code و Cursor و Windsurf وأي وكيل آخر يدعم المهارات.
+
+```bash
+npx skills add https://docs.befailproof.ai
+```
+
+يكتشف `npx skills` الوكلاء المثبتين لديك ويضيف المهارة بالصيغة الصحيحة لكل منها تلقائياً.
+
+## ما الذي تغطيه المهارة
+
+| المجال | ما يُتضمن |
+|------|----------------|
+| السياسات | أسماء السياسات المدمجة وأنواع الأحداث والمعاملات والتفعيل/التعطيل |
+| السياسات المخصصة | `customPolicies.add()`ومرشحات المطابقة و API `allow`/`deny`/`instruct` |
+| كائن السياق | `ctx.eventType` و `ctx.toolName` و `ctx.toolInput` و `ctx.session` |
+| الإعدادات | بنية `policies-config.json` ودمج النطاقات و `policyParams` |
+| سطر الأوامر | `failproofai policies --install` و `--uninstall` و `--custom` والنطاقات |
+| لوحة التحكم | عارض الجلسات وأنشطة السياسة والمتغيرات البيئية |
+| البنية المعمارية | تدفق معالج الخطاف وأكواد الخروج واتفاقية stdin/stdout |
+
+## هل المهارة كاملة؟
+
+يقوم Mintlify بإنشاء `llms.txt` من جميع الصفحات في التنقل. تغطي مستندات Failproof AI واجهة برمجية التطبيقات الكاملة - كل سياسة وخيار ومثال مُدرج. إذا وجدت شيئاً مفقوداً، فإن المصدر موجود في `https://docs.befailproof.ai/llms-full.txt`.
+
+للحصول على سياق موجه، قم بالربط مباشرة إلى صفحة معينة:
+
+```bash
+# API السياسات المخصصة فقط
+npx skills add https://docs.befailproof.ai/custom-policies
+
+# السياسات المدمجة فقط
+npx skills add https://docs.befailproof.ai/built-in-policies
+```