failproofai 0.0.2-beta.8 → 0.0.2-beta.9

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

@@ -0,0 +1,49 @@
+---
+---
+title: تثبيت السياسات
+description: "تفعيل السياسات بحيث تعمل على كل استدعاء أداة للوكيل"
+---
+
+```bash
+failproofai policies --install [policy-names...] [options]
+```
+
+يكتب إدخالات الخطاف إلى `settings.json` في Claude Code بحيث يعترض failproofai استدعاءات الأدوات.
+
+الاختصارات: `failproofai p -i`
+
+## الخيارات
+
+| العلم | الوصف |
+|------|-------------|
+| `--scope user` | التثبيت في `~/.claude/settings.json` (الافتراضي - جميع الجلسات) |
+| `--scope project` | التثبيت في `.claude/settings.json` في المجلد الحالي |
+| `--scope local` | التثبيت في `.claude/settings.local.json` في المجلد الحالي |
+| `--custom <path>` / `-c` | المسار إلى ملف JS يحتوي على سياسات الخطاف المخصصة |
+| `--beta` | تضمين السياسات التجريبية |
+
+## السلوك
+
+- **بدون أسماء سياسات** - يفتح موجه تفاعلي لتحديد السياسات
+- **أسماء محددة** - يفعّل تلك السياسات (تُضاف إلى أي سياسات مفعّلة بالفعل)
+- **`all`** - يفعّل كل سياسة متاحة
+
+التثبيت إضافي: تشغيل `--install` مجددًا يضيف سياسات جديدة دون إزالة السياسات الموجودة.
+
+## أمثلة
+
+```bash
+# تثبيت جميع السياسات الافتراضية عالميًا (تفاعلي)
+failproofai policies --install
+
+# تثبيت سياسات محددة للمشروع الحالي
+failproofai policies --install block-sudo sanitize-api-keys --scope project
+
+# تفعيل جميع السياسات في المرة الواحدة
+failproofai policies --install all
+
+# التثبيت مع ملف سياسات مخصص
+failproofai policies --install --custom ./my-policies.js
+```
+
+عند توفير `--custom <path>`، يتم التحقق من الملف فورًا - يجب أن يستدعي `customPolicies.add()` مرة واحدة على الأقل. يتم حفظ المسار المحل إلى `policies-config.json` باسم `customPoliciesPath`.

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

@@ -0,0 +1,31 @@
+---
+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/ar/cli/remove-policies.mdx

@@ -0,0 +1,45 @@
+---
+---
+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` من الإعدادات |
+| `--beta` | إزالة سياسات بيتا فقط من الإعدادات |
+
+## السلوك
+
+- **بدون أسماء سياسات** - يزيل جميع إدخالات خطافات failproofai من ملف الإعدادات
+- **أسماء محددة** - تعطيل تلك السياسات مع الحفاظ على تثبيت الخطافات
+
+## أمثلة
+
+```bash
+# إزالة جميع الخطافات عالميًا
+failproofai policies --uninstall
+
+# تعطيل سياسة محددة (مع الحفاظ على تثبيت الخطافات)
+failproofai policies --uninstall block-sudo
+
+# إزالة الخطافات من كل نطاق
+failproofai policies --uninstall --scope all
+
+# مسح مسار السياسات المخصصة
+failproofai policies --uninstall --custom
+```

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

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

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

@@ -0,0 +1,223 @@
+---
+---
+title: التكوين
+description: "صيغة ملف التكوين، نظام النطاقات الثلاثة، وقواعد الدمج"
+icon: gear
+---
+
+يستخدم failproofai ملفات تكوين JSON للتحكم في السياسات النشطة، وكيفية تصرفها، وأين يتم تحميل السياسات المخصصة. تم تصميم التكوين ليكون سهل المشاركة مع فريقك - قم بالتزام به في المستودع الخاص بك وسيحصل كل مطور على نفس شبكة الأمان للوكيل.
+
+---
+
+## نطاقات التكوين
+
+هناك ثلاثة نطاقات تكوين، يتم تقييمها بترتيب الأولوية:
+
+| النطاق | مسار الملف | الغرض |
+|-------|-----------|---------|
+| **مشروع** | `.failproofai/policies-config.json` | إعدادات لكل مستودع، مرتبطة بالتحكم في الإصدار |
+| **محلي** | `.failproofai/policies-config.local.json` | تجاوزات شخصية لكل مستودع، في gitignored |
+| **عام** | `~/.failproofai/policies-config.json` | الإعدادات الافتراضية على مستوى المستخدم عبر جميع المشاريع |
+
+عندما يتلقى failproofai حدث hook، فإنه يقوم بتحميل ودمج جميع الملفات الثلاثة الموجودة للمجلد الحالي.
+
+### قواعد الدمج
+
+**`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"] }  ← ينتقل إلى العام
+```
+
+**`customPoliciesPath`** - النطاق الأول الذي يحدده يفوز.
+
+**`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` على الإطلاق يحصلون على سلوك مطابق للإصدارات السابقة.
+
+المفاتيح غير المعروفة داخل كتلة معاملات السياسة يتم تجاهلها بصمت في وقت إطلاق hook ولكن يتم وضع علامة عليها كتحذيرات عند تشغيل `failproofai policies`.
+
+#### `hint` (عام)
+
+النوع: `string` (اختياري)
+
+رسالة تُضاف إلى السبب عندما تُرجع سياسة `deny` أو `instruct`. استخدمها لإعطاء Claude توجيهات قابلة للتنفيذ دون تعديل السياسة نفسها.
+
+يعمل مع أي نوع سياسة — مدمج، مخصص (`custom/`)، اتفاقية مشروع (`.failproofai-project/`)، أو اتفاقية مستخدم (`.failproofai-user/`).
+
+```json
+{
+  "policyParams": {
+    "block-force-push": {
+      "hint": "Try creating a fresh branch instead."
+    },
+    "block-sudo": {
+      "allowPatterns": ["sudo apt-get"],
+      "hint": "Use apt-get directly without sudo."
+    },
+    "custom/my-policy": {
+      "hint": "Ask the user for approval first."
+    }
+  }
+}
+```
+
+عندما يرفض `block-force-push`، يرى Claude: *"Force-pushing is blocked. Try creating a fresh branch instead."*
+
+القيم غير الحرفية والسلاسل الفارغة يتم تجاهلها بصمت. إذا لم يتم تعيين `hint`، فإن السلوك لم يتغير (متوافق للخلف).
+
+### `customPoliciesPath`
+
+النوع: `string` (مسار مطلق)
+
+المسار إلى ملف JavaScript يحتوي على سياسات hook مخصصة. يتم تعيينه تلقائيًا بواسطة `failproofai policies --install --custom <path>` (يتم حل المسار إلى مسار مطلق قبل تخزينه).
+
+يتم تحميل الملف جديدًا في كل حدث hook - لا يوجد تخزين مؤقت. انظر [السياسات المخصصة](/ar/custom-policies) لتفاصيل الإنشاء.
+
+### السياسات القائمة على الاتفاقية (v0.0.2-beta.7+)
+
+بالإضافة إلى `customPoliciesPath` الصريح، يقوم failproofai تلقائيًا باكتشاف وتحميل ملفات السياسة من المجلدات `.failproofai/policies/`:
+
+| المستوى | المجلد | النطاق |
+|-------|--------|---------|
+| مشروع | `.failproofai/policies/` | مشاركة مع الفريق عبر التحكم في الإصدار |
+| مستخدم | `~/.failproofai/policies/` | شخصي، ينطبق على جميع المشاريع |
+
+**مطابقة الملفات:** يتم تحميل الملفات المطابقة فقط لـ `*policies.{js,mjs,ts}` (مثل `security-policies.mjs`, `workflow-policies.js`). الملفات الأخرى في المجلد يتم تجاهلها.
+
+**لا يلزم التكوين:** لا تتطلب سياسات الاتفاقية إدخالات في `policies-config.json`. فقط أسقط الملفات في المجلد وسيتم التقاطها في حدث hook التالي.
+
+**التحميل المتحد:** يتم مسح كلا مجلدي الاتفاقية للمشروع والمستخدم. جميع الملفات المطابقة من كلا المستويين يتم تحميلها (بخلاف `customPoliciesPath` الذي يستخدم نطاق-أول-يفوز).
+
+انظر [السياسات المخصصة](/ar/custom-policies) لمزيد من التفاصيل والأمثلة.
+
+### `llm`
+
+النوع: `object` (اختياري)
+
+تكوين عميل LLM للسياسات التي تقوم باستدعاءات AI. غير مطلوب لمعظم الإعدادات.
+
+```json
+{
+  "llm": {
+    "model": "claude-sonnet-4-6",
+    "apiKey": "sk-ant-..."
+  }
+}
+```
+
+---
+
+## إدارة التكوين من CLI
+
+تقوم أوامر `policies --install` و `policies --uninstall` بالكتابة إلى `settings.json` لـ Claude Code (نقاط دخول hook)، بينما `policies-config.json` هو الملف الذي تديره مباشرة. الاثنان منفصلان:
+
+- **`settings.json`** - يخبر Claude Code باستدعاء `failproofai --hook <event>` في كل استخدام أداة
+- **`policies-config.json`** - يخبر failproofai بالسياسات التي يجب تقييمها وبأي معاملات
+
+يمكنك تحرير `policies-config.json` مباشرة في أي وقت؛ التغييرات تصبح نافذة المفعول فورًا في حدث hook التالي بدون الحاجة لإعادة التشغيل.
+
+---
+
+## مثال: تكوين على مستوى المشروع مع إعدادات الفريق الافتراضية
+
+التزم `.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` (في gitignored) للتجاوزات الشخصية دون التأثير على زملائه.