failproofai 1.0.1-beta.0 → 1.0.1

package/.next/standalone/docs-old/ar/cli/audit.mdx

@@ -0,0 +1,120 @@
+---
+---
+title: تدقيق الجلسات السابقة (beta)
+description: "عد عدد المرات التي قام فيها الوكيل بعمليات غير ضرورية أو محفوفة بالمخاطر عبر النصوص السابقة"
+---
+
+<Note>
+  **ميزة تجريبية.** يتم شحن التدقيق كإصدار تجريبي بينما نجمع الملاحظات المبكرة.
+  قد تتغير كتالوج الكاشفات وتنسيق التقرير قبل الإصدار المستقر التالي. يرجى فتح مشكلة إذا بدا شيء غير صحيح.
+</Note>
+
+يعيد التدقيق تشغيل نصوص مكتب وكيل CLI الخاصة بك عبر محرك السياسة في failproofai ويعرض تقريراً مرئياً قابلاً للمشاركة على **صفحة لوحة التحكم `/audit`** — نمط الوكيل، درجة من 0-100، والسياسات التي كان يمكنها اكتشاف ما بالضبط.
+
+## تشغيله
+
+ثلاث طرق للدخول — جميعها تصل إلى نفس تقرير `/audit`.
+
+<CodeGroup>
+
+```bash npx (no install)
+npx -y failproofai audit
+```
+
+```bash failproofai audit
+failproofai audit
+```
+
+```bash failproofai (dashboard)
+failproofai
+```
+
+</CodeGroup>
+
+<CardGroup cols={3}>
+  <Card title="بدون تثبيت" icon="bolt">
+    `npx -y failproofai audit` يجلب failproofai ويشغل المسح ويفتح لوحة التحكم لك — لا حاجة لتثبيت أي شيء أولاً.
+  </Card>
+  <Card title="من سطر الأوامر" icon="terminal">
+    `failproofai audit` يشغل المسح في طرفيتك، ثم يفتح `localhost:8020/audit` تلقائياً عند انتهائه.
+  </Card>
+  <Card title="من لوحة التحكم" icon="gauge">
+    شغّل `failproofai` وانقر على **Audit** في شريط التنقل (بين Policies و Projects)، أو افتح `/audit` مباشرة.
+  </Card>
+</CardGroup>
+
+<Tip>
+  شغّل `failproofai audit -h` (أو `--help`) لرؤية الاستخدام. يعمل التدقيق **بالكامل بلا اتصال** — لا تحتاج إلى حساب أو شبكة — ولوحة التحكم تستمر في الخدمة حتى تيقفها باستخدام `Ctrl+C`.
+</Tip>
+
+تفحص لوحة التحكم نصوص agent CLI السابقة على هذا الجهاز (Claude Code, Codex, Copilot, Cursor, OpenCode, Pi) وتبلغ عن عدد المرات التي قام فيها الوكيل بأشياء مُعدّة failproofai للتوقف عنها — فحوصات متغيرات البيئة، push forces، بادئات `cd <cwd>` المكررة، حلقات sleep-polling، إعادة قراءة الملفات التي تم تعديلها للتو، والمزيد.
+
+لكل نص، يتم إعادة تشغيل كل حدث استخدام أداة عبر 39 سياسة مدمجة **و** عبر 8 كاشفات خاصة بالتدقيق التي تلتقط الأنماط غير المغطاة بعد بسياسات وقت التشغيل. يتم تجميع الأعداد لكل سياسة / كاشف عبر جميع الجلسات.
+
+## ما الذي تحصل عليه
+
+صفحة `/audit` هي **ملصق** على شاشة واحدة قابل للمشاركة يتبعه أربعة أقسام تحت التوسيط:
+
+1. **الملصق** — هوية الوكيل في لمحة: **النمط** (أحد 8 — `optimist`، `cowboy`، `explorer`، `goldfish`، `paranoid architect`، `precision builder`، `hammer`، `ghost`)، كلمات الشخصية الخاصة به، مدى ندرة هذا النمط، و**درجة من 0-100** مع فئة (`S` إلى `bottom tier`). مُصنع للمشاركة — انشره على X أو LinkedIn، أو حمّله كصورة PNG.
+2. **`// strengths`** — ما يقوم به الوكيل جيداً بالفعل، كأرقام حقيقية من المسح (مثل clean-tool-call %، `0` push-to-main attempts)، معروضة فقط حيث تحتوي السياسة ذات الصلة على سجل نظيف.
+3. **`// quirks`** — ما انزلق عبره: جدول مصنف من السلوكيات التي كان failproofai سيكتشفها — **متى** حدثت آخر مرة، **ما الذي انزلق** (والأداة المدمجة التي كانت ستحجبها)، **الخطورة**، وعدد مرات **مشاهدتها** (`new` / `recurring` / `N× seen`).
+4. **`// how to improve`** — قائمة الإصلاح الموصوفة: صف واحد لكل سياسة مع `failproofai policy add <slug>` قابل للنسخ واللصق، بالإضافة إلى زر **install all** يفعّل كل توصية في وقت واحد ويعرض **الدرجة المتوقعة** إذا قمت بذلك.
+5. **`// come back better`** — بناء العادة: اضبط **تذكير** إعادة تدقيق بالبريد الإلكتروني (`3d` / `7d` / `14d` / `30d`) أو أعد التدقيق الآن، و**ادعُ صديقاً** لتشغيل التدقيق الخاص به (مرسل من failproof.ai، مع نسخة لك). التذكيرات والدعوات تتطلب تسجيل الدخول.
+
+## التدقيقات المجدولة
+
+إذا شغّلت **daemon failproofaid** (انظر [`failproofai config`](/ar/cli/install-policies))،
+يمكنه إعادة تشغيل التدقيق لك على جدول زمني وتحديث تقرير `/audit` في
+الخلفية. يكون **معطلاً بشكل افتراضي**، لأن المسح يقرأ **المحتويات**
+من كل نص جلسة وكيل على هذا الجهاز — لا يفحص أي شيء على مؤقت
+حتى تطلب ذلك.
+
+شغّله في `~/.failproofai/config.toml`:
+
+```toml
+[audit]
+auto = true
+interval_days = 7
+```
+
+| المفتاح | المعنى |
+|---|---|
+| `auto` | `true` يفعّل المسح المجدول. أي شيء آخر — غائب، `false`، `"yes"` — معطل. |
+| `interval_days` | أيام بين المسح. محدود إلى 1-90؛ `0`، رقم سالب أو غير رقم يعود إلى `7`. |
+
+- الجدول الزمني هو **wall-clock**، لذا فهو ينجو من التعليق والتمهيد: جهاز محمول كان في وضع السكون بعد وقت استحقاقه ينفذ **مرة واحدة** عند الاستيقاظ، أبداً لا توجد قائمة انتظار.
+- كل تشغيل هو عملية منفصلة ذات أولوية منخفضة (`nice 19`) — أبداً لا طريق hook الخاص بـ daemon، الذي يبقى حراً للإجابة على استدعاءات الأدوات.
+- يتم تخطي المسح إذا كان `failproofai audit` أو إعادة تشغيل لوحة التحكم قيد الرحلة بالفعل؛ تتم إعادة محاولته قريباً بدلاً من اعتباره فشلاً.
+- يتم كتابة التقدم إلى `~/.failproofai/state/audit-schedule.json` (آخر تشغيل، التالي المستحق). يمتلك daemon هذا الملف — غيّر الإيقاع في `config.toml`.
+
+<Note>
+إذا فعّلت هذا على جهاز تم إعداده بواسطة failproofai أقدم، شغّل
+`failproofai config` مرة واحدة. تعريف خدمة daemon يحتاج إلى إدخال إضافي واحد
+قبل أن تتمكن من تشغيل CLI، والتحديث هو جزء من هذا الأمر.
+</Note>
+
+## كاشفات خاصة بالتدقيق فقط
+
+تكتشف هذه أنماط "سلوك غبي" لا يتم فرضها (حتى الآن) في الوقت الفعلي. تعمل فقط أثناء التدقيق ولا تحجب أبداً استدعاء أداة مباشرة.
+
+| الكاشف | ما يعده |
+|---|---|
+| `redundant-cd-cwd` | أوامر Bash تبدأ بـ `cd <cwd> && …` حتى وإن كانت الأوامر تعمل بالفعل في `cwd`. |
+| `prefer-edit-over-read-cat` | `cat`/`head`/`tail`/`less`/`more` على ملف مصدر واحد — استخدم أداة `Read`. |
+| `prefer-edit-over-sed-awk` | `sed -i` / `awk … > file` تحريرات في المكان — استخدم أداة `Edit`. |
+| `prefer-write-over-heredoc` | Heredoc / كتابة الملفات متعددة الأسطر `echo > file` — استخدم أداة `Write`. |
+| `sleep-polling-loop` | `sleep N` طويلة (≥ 30s) أو `while …; sleep …; done` حلقات polling. |
+| `find-from-root` | `find /`، `find /home`، `find /usr`، إلخ. — حدد النطاق إلى `cwd` بدلاً من ذلك. |
+| `git-commit-no-verify` | `git commit … --no-verify` / `-n`، تخطي الخطافات. |
+| `reread-after-edit` | `Read` لملف تم `Edit`/`Write` للتو في نفس الجلسة. |
+
+## التخزينات المؤقتة
+
+- **تخزين مؤقت لكل نص** في `~/.failproofai/cache/audit/<sha1>.json` مفهرسة بـ `(mtime, size, engineVersion, detectorVersion)` — تبطل تلقائياً عند تغيير النص أو كود السياسة/الكاشف. يخزن كل إدخال أيضاً طابع زمني `cachedAt` كـ **بيانات وصفية TTL** (ليست جزءاً من مفتاح التخزين المؤقت)؛ يتم رفض الإدخالات الأقدم من **7 أيام** عند القراءة بحيث لا تتجاوز النتائج طويلة العمر الهدف المتطور للكاشف.
+- **تخزين مؤقت للنتيجة الكاملة** في `~/.failproofai/audit-dashboard.json` (mode 0600). يسمح لوحة التحكم بالعرض الفوري عند التنقل بدون إعادة تشغيل. يتم رفضه أيضاً عند القراءة بعد **7 أيام TTL** — ثم ينخفض `/audit` إلى حالته الفارغة ويطالب بتشغيل جديد. انقر على `[ re-audit now ]` بالقرب من أسفل التقرير للتحديث — تُرسل إعادة التدقيق `noCache: true`، لذا فهو يتجاوز التخزين المؤقت لكل نص ويعيد فحص كل نص بدلاً من إرجاع النتيجة المخزنة مؤقتاً؛ يتدفق التشغيل التقدم عبر شريط ثابت في الأعلى ويستبدل النتيجة في المكان عند النجاح (بدون إعادة تحميل الصفحة؛ فشل إعادة التدقيق يحتفظ بالتقرير السابق).
+
+## ملاحظات
+
+- **بدون تعديل.** يعاد تشغيل التدقيق في وضع القراءة فقط. يتم تخطي `warn-repeated-tool-calls` لأن الملف الجانبي لكل جلسة قد يتم تعديله بخلاف ذلك.
+- **سياسات سير العمل معطلة.** سياسات `require-*-before-stop` تعمل فقط على أحداث `Stop` و `execSync` ضد حالة git الحية — ليس لديها تفسير "ماذا كان سيحدث في 2025" ذو معنى، لذا لا تظهر في عدد التدقيق.
+- **السياسات المخصصة معطلة.** السنانير المخصصة المُزودة من قبل المستخدم لا تتم إعادة تشغيلها (قد تكون قد تغيرت منذ الجلسة الأصلية).

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

@@ -0,0 +1,30 @@
+---
+---
+title: عرض الجلسات
+description: "قم بتشغيل لوحة التحكم لاستعراض جلسات الوكيل وإدارة السياسات"
+---
+
+```bash
+failproofai
+```
+
+يبدأ لوحة التحكم على الويب في `http://localhost:8020`.
+
+## الخيارات
+
+| العلم | الوصف |
+|------|-------------|
+| `--port <number>` | المنفذ المراد الاستماع عليه (الافتراضي: `8020`) |
+| `--allowed-origins <origins>` | المضيفون/عناوين IP المفصولة بفواصل المسموح لها بالوصول إلى موارد التطوير |
+
+لتوجيه لوحة التحكم إلى مجلد مشروع Claude غير الافتراضي، قم بتعيين متغير البيئة `CLAUDE_PROJECTS_PATH` عند التشغيل.
+
+## أمثلة
+
+```bash
+# قم بالتشغيل على منفذ مختلف
+failproofai --port 9000
+
+# استخدم مسار مشاريع Claude مخصص عبر متغير البيئة
+CLAUDE_PROJECTS_PATH=~/my-claude-projects failproofai
+```

package/.next/standalone/docs-old/ar/cli/environment-variables.mdx

@@ -0,0 +1,70 @@
+---
+---
+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` | مسار ملف السجل المخصص، أو `true` للافتراضي (`~/.failproofai/logs/hooks.log`) |
+
+## قياس الاستخدام
+
+يقدم failproofai تقارير قياس استخدام مجهولة الهوية افتراضياً. هناك طريقتان لإيقافها،
+وتطبق الأكثر تقييداً — لا يمكن لمتغير بيئة أبداً إعادة تفعيل شيء أوقفته ملف التكوين.
+
+| المتغير | الوصف |
+|----------|-------------|
+| `FAILPROOFAI_TELEMETRY_DISABLED=1` | تعطيل قياس الاستخدام المجهول الهوية لهذه العملية |
+
+لتعطيله بشكل دائم على الجهاز، أضف هذا إلى `~/.failproofai/config.toml`:
+
+```toml
+[telemetry]
+enabled = false
+```
+
+<Note>
+ملف التكوين هو الخيار المراد استخدامه إذا كنت تشغل **failproofaid daemon**.
+daemon هي خدمة على مستوى النظام، وبيئتها لا تتضمن
+المتغيرات المُصدَّرة من الـ shell الخاص بك — لذا لا يمكن لـ `FAILPROOFAI_TELEMETRY_DISABLED`
+الوصول إليها. `[telemetry] enabled = false` تقرأها كل من CLI و daemon.
+</Note>
+
+يقدم daemon **دورة الحياة** الخاصة به فقط: أنها بدأت (وما إذا كان الـ run السابق أُغلق بنظافة)،
+أنها توقفت، عند توليد عامل التقييم أو إعادة تشغيله، عند فشل مهمة جامع، ونتيجة
+سحب السياسة السحابية. هذه تحمل قيماً منخفضة الأساسية وعددات — أبداً مسار ملف،
+أو أمر، أو سياسة، أو موجه، أو أي شيء مقروء من النسخة. لا توجد حدث لكل استدعاء أداة.
+
+## المصادقة
+
+| المتغير | الوصف |
+|----------|-------------|
+| `FAILPROOF_API_URL` | تجاوز عنوان URL الأساسي لخادم api الذي تستخدمه نافذة مصادقة لوحة التحكم. الافتراضي هو `https://api.befailproof.ai`؛ عيّن إلى `http://localhost:8080` (أو في أي مكان آخر) عند تشغيل api-server محلي. |
+| `FAILPROOFAI_AUTH_DIR` | تجاوز مكان تخزين `auth.json` (الافتراضي: `~/.failproofai`). مفيد في الغالب للاختبارات المعزولة. |
+
+## موجه التشغيل الأول
+
+| المتغير | الوصف |
+|----------|-------------|
+| `FAILPROOFAI_NO_FIRST_RUN=1` | تخطي الموجه الذي يعرض تثبيت السياسات على استدعاء `failproofai` الأول المباشر |
+
+## LLM (لتقييم السياسة)
+
+| المتغير | الوصف |
+|----------|-------------|
+| `FAILPROOFAI_LLM_BASE_URL` | نقطة نهاية API للـ LLM (الافتراضي: `https://api.openai.com/v1`) |
+| `FAILPROOFAI_LLM_API_KEY` | مفتاح API للسياسات المدعومة بـ LLM |
+| `FAILPROOFAI_LLM_MODEL` | اسم النموذج (الافتراضي: `gpt-4o-mini`) |

package/.next/standalone/docs-old/ar/cli/hook.mdx

@@ -0,0 +1,31 @@
+---
+---
+title: معالج الخطاف (داخلي)
+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` |

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

@@ -0,0 +1,57 @@
+---
+title: تثبيت السياسات
+description: "تفعيل السياسات بحيث تعمل على كل استدعاء أداة للوكيل"
+---
+
+```bash
+failproofai policies --install [policy-names...] [options]
+```
+
+يكتب إدخالات الخطاف في ملف إعدادات واجهة سطر الأوامر للوكيل المثبتة لديك (Claude Code أو OpenAI Codex أو GitHub Copilot CLI _(beta)_) بحيث يعترض failproofai استدعاءات الأدوات.
+
+الأسماء المستعارة: `failproofai p -i`
+
+## الخيارات
+
+| العلم | الوصف |
+|------|-------------|
+| `--cli claude\|codex\|copilot` | واجهة سطر أوامر الوكيل للتثبيت عليها؛ مفصولة بمسافات (مثلاً `--cli claude codex copilot`) أو مكررة. اتركها فارغة للكشف التلقائي عن واجهات سطر الأوامر المثبتة والطلب منك الاختيار. |
+| `--scope user` | التثبيت في ملف الإعدادات بنطاق المستخدم (Claude: `~/.claude/settings.json`؛ Codex: `~/.codex/hooks.json`؛ Copilot: `~/.copilot/hooks/failproofai.json`). الافتراضي. |
+| `--scope project` | التثبيت في ملف إعدادات نطاق المشروع (Claude: `<cwd>/.claude/settings.json`؛ Codex: `<cwd>/.codex/hooks.json`؛ Copilot: `<cwd>/.github/hooks/failproofai.json`). |
+| `--scope local` | Claude فقط — يثبت في `<cwd>/.claude/settings.local.json`. لا يتوفر نطاق `local` في Codex و Copilot. |
+| `--custom <path>` / `-c` | المسار إلى ملف JavaScript يحتوي على سياسات خطاف مخصصة |
+
+## السلوك
+
+- **بدون أسماء سياسات** - يفتح موجه تفاعلي لتحديد السياسات
+- **أسماء محددة** - تفعيل تلك السياسات (تضاف إلى أي سياسات مفعلة بالفعل)
+- **`all`** - تفعيل كل السياسات المتاحة
+
+التثبيت تراكمي: تشغيل `--install` مرة أخرى يضيف سياسات جديدة دون إزالة السياسات الموجودة.
+
+## أمثلة
+
+```bash
+# Install all default policies globally (interactive)
+failproofai policies --install
+
+# Install specific policies for the current project
+failproofai policies --install block-sudo sanitize-api-keys --scope project
+
+# Enable all policies at once
+failproofai policies --install all
+
+# Install with a custom policies file
+failproofai policies --install --custom ./my-policies.js
+
+# Install for OpenAI Codex (project scope)
+failproofai policies --install --cli codex --scope project
+
+# Install for GitHub Copilot CLI (beta) for the current project
+failproofai policies --install --cli copilot --scope project
+
+# Install for all three CLIs at once
+failproofai policies --install --cli claude codex copilot
+```
+
+عند توفير `--custom <path>`، يتم التحقق من صحة الملف على الفور - يجب أن يستدعي `customPolicies.add()` مرة واحدة على الأقل. يتم حفظ المسار المحل في `policies-config.json` باسم `customPoliciesPath`.

package/.next/standalone/docs-old/ar/cli/list-policies.mdx

@@ -0,0 +1,32 @@
+---
+---
+title: قائمة السياسات
+description: "معرفة السياسات المفعّلة وموارديها والسياسات المخصصة"
+---
+
+```bash
+failproofai policies
+```
+
+يعرض جميع السياسات مع حالتها والمعاملات المكوّنة والسياسات المخصصة.
+
+## عينة من المخرجات
+
+```text
+Failproof AI Hook Policies (user)
+
+  Status  Name                          Description
+  ──────  ──────────────────────────────────────────────────────────────
+  ✓       block-sudo                    Block sudo commands
+            allowPatterns: ["sudo systemctl status"]
+  ✓       block-rm-rf                   Block recursive deletions
+  ✗       block-curl-pipe-sh            Block curl|bash patterns
+  ✓       sanitize-api-keys             Redact API keys from output
+            additionalPatterns: [{ regex: "MY_TOKEN_...", label: "..." }]
+
+  ── Custom Policies (/home/alice/myproject/my-policies.js) ──────────────
+  ✓       require-jira-ticket           Block commits without ticket
+  ✓       approval-gate                 Approval gate for destructive ops
+```
+
+يتم التعليم هنا على المفاتيح غير المعروفة في `policyParams` حتى تتمكن من اكتشاف الأخطاء الإملائية مبكراً.

package/.next/standalone/docs-old/ar/cli/migrate.mdx

@@ -0,0 +1,110 @@
+---
+title: ترحيل مجلد المنزل
+description: "أحضر ~/.failproofai إلى التخطيط الذي تتحدثه هذه النسخة، وانظر ما سيحدث أولاً"
+---
+
+```bash
+failproofai migrate --dry-run   # print the plan, change nothing
+failproofai migrate             # run it
+```
+
+معظم الناس لا يكتبون هذا أبداً. يعمل بنفسه عند أول أمر بعد ترقية، وتتضمنه
+[`failproofai update`](/ar/cli/update). استخدمه مباشرة عندما تريد رؤية الخطة قبل حدوثها،
+أو لتشغيل الترحيل بمفرده.
+
+## يتم تحديده بناءً على التخطيط، وليس النسخة
+
+`~/.failproofai/VERSION` يسجل رقم **التخطيط** — شكل المجلد، وليس الإصدار الذي كتبه.
+يتم تحديد الترحيلات بناءً على هذا الرقم، وهو ما يجعل الفجوة الطويلة رخيصة الثمن:
+
+- إصدارات npm تتغير عند كل إصدار، عشرات بينهما بين تخطيطين.
+- لذا فإن الجهاز الذي يتخطى ثلاثين إصدار بدون **تغيير تخطيط** ينفذ **صفر**
+  ترحيلات، وليس ثلاثين عملية لا.
+- وجهاز يتخطى عدة تخطيطات مرة واحدة ينفذ كل خطوة بالترتيب، كل خطوة
+  تعرف طرفيها الخاصين فقط.
+
+هذا مهم لأن npm لا يمكنه تحديث حزمة مثبتة بمفردها. جهاز يجلس على نسخة واحدة
+لعدة أشهر ثم يقفز عدة تخطيطات هو الحالة العادية، وليس الحالة الشاذة.
+
+## التشغيل الجاف
+
+`--dry-run` يطبع السلسلة الدقيقة والملفات التي ستُحفظ أولاً، ولا يغير شيئاً
+على الإطلاق — لا ترحيل، لا نسخ احتياطي، لا إدخال دفتر اليوميات:
+
+```
+Layout 2 on disk; this build speaks 3.
+1 step(s) would run:
+  2 → 3  layout 2 → 3: carry config.toml and credentials.toml into JSON, move
+         custom-policies/ back up into policies/, nest the policy config at the root
+
+These would be copied to ~/.failproofai/migrations/backup-layout2 first:
+  VERSION
+  config.toml
+  credentials.toml
+```
+
+## ما يتم نقله وما يتم إعادة بناؤه
+
+كل مسار في المنزل يعلن نوع البيانات التي يحتفظ بها، وهذا يحدد ما إذا كان
+الترحيل قد يتركه. القاعدة: **ما هو مشتق وقابل لإعادة الجلب قد يُحذف؛
+أي شيء كتبته، أي شيء لم يتم توصيله بعد، وأي شيء يحدد الجهاز يتم نقله.**
+
+| يتم نقله | يتم إعادة بناؤه أو إعادة جلبه |
+|---|---|
+| `config.json` — الإعدادات، `daemon.configured`، مسارات التقاط إضافية | ذاكرة تخزين المراجعة |
+| `credentials.json` — التسجيل السحابي الخاص بك | النشرات المدارة بالسحابة (يتم جلبها مجدداً والتحقق من الملخص في الاستطلاع التالي) |
+| `policies-config.json` — اختيار السياسة والمعاملات الخاصة بك | حالة الخدش الموجودة في الخادم |
+| `policies/` — ملفات السياسة الخاصة بك والمساعدات التي تستوردها | |
+| `hook-activity/` — سجل القرارات الذي تقرأه لوحة التحكم | |
+| الأحداث غير المُسلَّمة التي تنتظر التحميل | |
+| `cursors/` — علامات مائية منقب البيانات | |
+| الثنائي الموجود في `bin/` | |
+
+<Note>
+  يتم نقل الأحداث غير المُسلَّمة بدلاً من حذفها لأن الخسارة ستكون دائمة، وليست بطيئة:
+  علامة مائية منقب البيانات قد تقدمت بالفعل بعد أي شيء يجلس في الملف،
+  لذا لن يقرأ أحد هذا النطاق من النص مرة أخرى. يطلب الترحيل أيضاً من الخادم توصيل
+  ما هو في الملف بمجرد انتهائه، لذا النتيجة المعتادة أنه لا يوجد شيء يُنقل.
+</Note>
+
+المفاتيح التي كتبتها نسخة **أحدث** في `config.json` أو `credentials.json` أو
+`policies-config.json` يتم الحفاظ عليها أيضاً، بدلاً من حذفها بواسطة قارئ أقدم.
+
+## السجل الذي تتركه
+
+```
+~/.failproofai/migrations/
+  applied.json                 entry واحدة لكل خطوة: layout، CLI، timestamp، مدة، النتيجة
+  backup-layout<n>/            نسخ من الملفات التي لا يمكن استبدالها، مأخوذة قبل الخطوة الأولى
+```
+
+`applied.json` هو ما يجيب على سؤال "ماذا مرّ هذا الجهاز فعلاً" — السؤال
+الأول الذي يستحق طرحه عندما يبدو شيء ما خاطئاً بعد الترقية. أرفقها
+مع تقرير الخلل.
+
+النسخة الاحتياطية متعمدة أن تكون صغيرة بدلاً من نسخة من المجلد بأكمله:
+الترحيل لم يعد يحذف أي شيء لا يمكن استبداله بالتصميم، لذا ما يستحق التأمين
+ضده هو **عيب في خطوة**، وهذه الملفات القليلة هي حيث قد يؤذي هذا العيب.
+
+## إذا فشلت خطوة
+
+تتوقف السلسلة هناك. `VERSION` يُختم فقط بواسطة خطوة اكتملت، لذا المنزل
+يبقى مع تخطيطه القديم والأمر التالي يعيد محاولته — لا يتم وضع علامة على المنزل
+بالتخطيط الحالي بناءً على ترحيل جزئي. يتم تسجيل الخطوة في `applied.json`
+بـ `"ok": false`، والنسخة الاحتياطية حيث تم أخذها.
+
+## يتم رفض المنزل الأحدث، وليس ترحيله
+
+إذا كانت `~/.failproofai/` مكتوبة بواسطة failproofai **أحدث** من النسخة
+التي تشغلها، يتوقف الأمر ويخبرك بالترقية بدلاً من ذلك. هذه البيانات بخير
+وقارئ CLI أحدث يقرأها؛ الترحيل إلى الأمام منها ليس شيئاً موجوداً، وإعادة تعيينه
+ستحطم شيئاً قابلاً للاسترجاع.
+
+```
+This machine's failproofai directory was written by a newer version (layout 4;
+this build speaks 3). Upgrade rather than migrate:
+  npm install -g failproofai@latest
+```
+
+الخادم ينطبق عليه نفس القانون: `failproofaid` يرفض البدء ضد تخطيط
+لا يتحدثه، بدلاً من قراءة وكتابة المسارات التي تحركت.

package/.next/standalone/docs-old/ar/cli/remove-policies.mdx

@@ -0,0 +1,44 @@
+---
+---
+title: إلغاء تثبيت السياسات
+description: "إزالة إدخالات الخطافات من إعدادات Claude Code"
+---
+
+```bash
+failproofai policies --uninstall [policy-names...] [options]
+```
+
+يزيل إدخالات خطافات failproofai من `settings.json` الخاص بـ Claude Code.
+
+الاختصارات: `failproofai p -u`
+
+## الخيارات
+
+| العلم | الوصف |
+|------|-------------|
+| `--scope user` | الإزالة من الإعدادات العامة (الافتراضي) |
+| `--scope project` | الإزالة من إعدادات المشروع |
+| `--scope local` | الإزالة من الإعدادات المحلية |
+| `--scope all` | الإزالة من جميع النطاقات في وقت واحد |
+| `--custom` / `-c` | مسح `customPoliciesPath` من الإعدادات |
+
+## السلوك
+
+- **بدون أسماء سياسات** - يزيل جميع إدخالات خطافات failproofai من ملف الإعدادات
+- **أسماء محددة** - يعطل تلك السياسات لكن يبقي الخطافات مثبتة
+
+## أمثلة
+
+```bash
+# إزالة جميع الخطافات عالمياً
+failproofai policies --uninstall
+
+# تعطيل سياسة محددة (يبقي الخطافات مثبتة)
+failproofai policies --uninstall block-sudo
+
+# إزالة الخطافات من كل نطاق
+failproofai policies --uninstall --scope all
+
+# مسح مسار السياسات المخصصة
+failproofai policies --uninstall --custom
+```

package/.next/standalone/docs-old/ar/cli/update.mdx

@@ -0,0 +1,79 @@
+---
+title: التحديث بعد الترقية
+description: "أكمل النصف الآخر من الترقية الذي لا يستطيع npm القيام به: هاجر المجلد الأساسي وطابق الخادم"
+---
+
+```bash
+npm install -g failproofai@latest && failproofai update
+```
+
+هذا هو كل ما يتعلق بالترقية. `npm` يستبدل واجهة سطر الأوامر؛ `failproofai update` يقوم بالباقي.
+
+## لماذا يوجد أمر ثانٍ
+
+`npm install -g` يستبدل شيئًا واحدًا فقط — واجهة سطر الأوامر. هناك جزآن آخران من تثبيت failproofai يعيشان خارج الحزمة عن قصد، وكلاهما لا ينتقل عندما يعمل npm:
+
+- **`~/.failproofai/`**، إعداداتك والتسجيل السحابي واختيار السياسة والسجل. قد تنظمها نسخة جديدة بشكل مختلف، والإعادة التنظيم يجب أن تتم بواسطة رمز يعرف كلا الشكلين.
+- **ثنائي خادم `failproofaid`**، الموجود في
+  `~/.failproofai/bin/failproofaid-<version>`. وهو متعمد أنه *ليس* داخل
+  `node_modules`: ترقية تستبدل الملف تحت خدمة تعمل ستعيد توجيه خادم حي إلى ثنائي مبني من مصدر مختلف، وحذف الحزمة سيحذفه من تحت خدمة تتعطل بعد ذلك في كل بدء.
+
+لذا بعد `npm install -g` وحده، واجهة سطر الأوامر جديدة والخادم ليس كذلك.
+`failproofaid` يرفض البدء مقابل تخطيط مجلد لا يتحدثه — النسخة الصاخبة من عدم التطابق بدلاً من النسخة الصامتة — لذا يجب إحضار النصفين معًا. `failproofai update` هي تلك الخطوة.
+
+## ما الذي يفعله
+
+<Steps>
+  <Step title="تشغيل أي هجرات تخطيط معلقة">
+    يقرأ التخطيط المسجل في `~/.failproofai/VERSION` ويشغل الخطوات التي
+    تجلبه إلى الخطوط التي تتحدثها هذه النسخة. عادة لا توجد — انظر
+    [`failproofai migrate`](/ar/cli/migrate).
+  </Step>
+  <Step title="وضع ثنائي الخادم المطابق في مكانه">
+    من حزمة النظام الأساسي التي قام npm بتنزيلها بالفعل حيث أمكن (بدون شبكة)،
+    وإلا من أصل الإصدار لهذه النسخة الدقيقة، التحقق من SHA-256 
+    قبل استخدامه.
+  </Step>
+  <Step title="إعادة تشغيل الخدمة والتأكد من عودتها">
+    تم البحث عنها بدلاً من افتراضها — يقدم مدير الخدمة عملية نشطة في اللحظة التي ينقسم فيها،
+    وهذا ليس هو نفسه أنها تعمل.
+  </Step>
+</Steps>
+
+## الخيارات
+
+| العلم | التأثير |
+|------|--------|
+| `--no-daemon` | هاجر المجلد الأساسي فقط، وترك الخادم في نسخته الحالية. |
+
+<Warning>
+  `--no-daemon` يترك خادمًا منحرفًا في الإصدار في مكانه. على جهاز تم تكوينه
+  لمطالبة الخادم، كل حدث هوك **يفشل إغلاقًا** إذا لم يتمكن الخادم من
+  الإجابة — وخادم يرفض البدء مقابل مجلد مهاجر لا يمكنه الإجابة. تفضيل السماح بتشغيل الخادم.
+</Warning>
+
+## إذا حدث شيء خاطئ
+
+الأمر ينتهي بشكل غير صفري ويقول أي نصف فشل. حالتان جديرتان بالمعرفة:
+
+- **خطوة الهجرة لم تنته.** المجلد الأساسي يُترك مع وضع علامة على تخطيطه *القديم*،
+  لذا الأمر التالي يحاول مرة أخرى — لا يتم وضع علامة على المجلد الأساسي أبدًا على أساس الهجرة الجزئية.
+  تم حفظ نسخ من إعداداتك والتسجيل السحابي قبل تشغيل أي شيء، في `~/.failproofai/migrations/backup-layout<n>/`.
+- **لم يتمكن الخادم من إعادة التشغيل بدون كلمة مرور.** يتم استخدام `sudo -n`
+  عن قصد، لذا لا شيء يطالب أبدًا من تحت عرض التقدم. يطبع الأمر السطر الدقيق لتشغيله بنفسك.
+
+<Note>
+  لا شيء هنا يحتاج معالج الإعداد التفاعلي. إعداداتك والتسجيل السحابي
+  واختيار السياسة ينجون من الترقية، لذا جهاز مهاجر يفرض بالضبط كما كان من قبل — وهذا يهم أكثر على الأجهزة التي لا يجلس أحد عندها: عداء CI، صندوق الأسطول، بوابة بلا رأس.
+</Note>
+
+## أتمتة ذلك
+
+`failproofai update` غير تفاعلي وآمن للتشغيل عندما لا يكون هناك شيء للقيام به —
+يقدم تقارير بأن الهجرة لم تكن مطلوبة والخروج 0. وضعه بعد كل ترقية في سكريبت توفير أو Dockerfile هو الاستخدام المقصود:
+
+```dockerfile
+RUN npm install -g failproofai@latest && failproofai update --no-daemon
+```
+
+(`--no-daemon` في بناء الصورة، حيث لا توجد خدمة لإعادة تشغيلها حتى الآن.)

package/.next/standalone/docs-old/ar/cli/version.mdx

@@ -0,0 +1,13 @@
+---
+---
+title: التحقق من الإصدار
+description: "طباعة إصدار failproofai المثبت"
+---
+
+```bash
+failproofai --version
+# or
+failproofai -v
+```
+
+يطبع رقم الإصدار المثبت.