failproofai 0.0.6-beta.2 → 0.0.6-beta.4

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

@@ -1,48 +0,0 @@
----
----
-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 يحتوي على سياسات الخطاف المخصصة |
-
-## السلوك
-
-- **بدون أسماء سياسات** - يفتح موجه تفاعلي لاختيار السياسات
-- **أسماء محددة** - يفعّل تلك السياسات (مضافة إلى أي سياسات مفعّلة بالفعل)
-- **`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

@@ -1,31 +0,0 @@
----
-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

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

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

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

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

@@ -1,223 +0,0 @@
----
----
-title: التكوين
-description: "صيغة ملف التكوين ونظام النطاقات الثلاثة وقواعد الدمج"
-icon: gear
----
-
-يستخدم failproofai ملفات تكوين JSON للتحكم في السياسات النشطة وكيفية عملها وأين يتم تحميل السياسات المخصصة. تم تصميم التكوين ليكون سهل المشاركة مع فريقك - قم بالتعهد به في مستودعك وسيحصل كل مطور على نفس شبكة الأمان للوكيل.
-
----
-
-## نطاقات التكوين
-
-يوجد ثلاثة نطاقات تكوين، يتم تقييمها بترتيب الأولوية:
-
-| النطاق | مسار الملف | الغرض |
-|-------|-----------|--------|
-| **المشروع** | `.failproofai/policies-config.json` | إعدادات كل مستودع، مرتكبة في التحكم بالإصدار |
-| **محلي** | `.failproofai/policies-config.local.json` | تجاوزات شخصية لكل مستودع، مضافة إلى gitignore |
-| **عام** | `~/.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) للتفاصيل حول الكتابة.
-
-### سياسات قائمة على الاتفاقية
-
-بالإضافة إلى `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-..."
-  }
-}
-```
-
----
-
-## إدارة التكوين من واجهة سطر الأوامر
-
-تكتب أوامر `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` (مضافة إلى gitignore) للتجاوزات الشخصية دون التأثير على زملائهم.