README.ar.md

---

بيئات التشغيل المدعومة

اثنتا عشرة بيئة تشغيل في فئتين — عشر واجهات سطر أوامر لكتابة الأكواد، واثنتا بوابات دردشة ومساعدات (Hermes و OpenClaw). واجهة برمجية واحدة للسياسات وسجل جلسة واحد في جميع الأنحاء. ما يمكن لسياسة منعه يختلف حسب البيئة: إيقاف استدعاء أداة قبل تشغيله يتم التحقق منه في جميع الاثنتي عشرة، أبواب نهاية المحادثة في ثمانية. تُدرج مصفوفة البيئات الأحداث التي يحترمها كل منها.

الوكلاء الذين يعملون في لا أحد منها يبلغون من خلال Python SDK، والذي يعطيك التتبع والجلسات والتدقيق. يتطلب الفرض هناك خطاف في وقت التشغيل الخاص بك — تحدث معنا وسنقوم بتعيينه.

{/* جدول بـ 6 أعمدة بدلاً من مضمنة: أعمدة الجدول لا تعاد التفاف أبداً، لذا تبقى الشبكة 2×6 بأي عرض نافذة (التمرير على الشاشات الضيقة جداً بدلاً من الانهيار إلى صفوف يتيمة غير منتظمة). */}

التثبيت

npm install -g failproofai
failproofai config                             # قم بتوصيل وكلاؤك والقسم
failproofai policies add FailproofAI/policies  # اختر ما يجب فرضه
failproofai                                    # لوحة التحكم على localhost:8020

يقوم الإعداد بتوصيل الخطافات واختيار لا أحد من السياسات — هذا الأمر الثاني هو ما يضع حراسات على الجهاز، وأي مجموعة يتم كتابتها بنفس الطريقة (failproofai policies add <owner>/<repo>؛ policies show <owner>/<repo> يقرأ واحدة أولاً). قم بتشغيل failproofai config بدون محطة — CI، حاوية، وكيل يقودها — وتطبق بدلاً من السؤال. على جهاز لم يتم إعداده أبداً، أي أمر آخر يقوم بتشغيل نفس المعالج أولاً؛ عطّله باستخدام FAILPROOFAI_NO_FIRST_RUN=1.

حتى تصل مجموعة، الشيء الوحيد الذي يفرضه هو block-failproofai-commands، وهو يعمل دائماً ولا يمكن إيقافه أو إيقافه مؤقتاً: وكيل يمكنه إيقاف الفرض يمكنه إيقاف كل سياسة أخرى.

---

ما يتم إيقافه

السياسة	ما يتم منعه
block-env-files	قراءة ملفات .env والملفات السرية الأخرى
warn-repeated-tool-calls	الوكيل الذي ينقر على نفس الاستدعاء
block-sudo	تصعيد الامتيازات
warn-destructive-sql	DROP، TRUNCATE، DELETE غير محدود
block-terraform / block-kubectl	التغييرات غير المراجعة على البنية التحتية المباشرة
block-rm-rf	حذف ملفات متكرر
block-force-push / block-push-master	git push --force، دفع مباشر إلى main

كل واحد منها يوقف الاستدعاء قبل تشغيله، لذا فهو يعمل في جميع الاثنتي عشرة بيئات تشغيل. الأربعة الأولى تنطبق على أي وكيل يمكنه استدعاء أداة؛ الثلاثة الأخيرة هي المفضلة للمطورين — واجهات سطر أوامر الكتابة هي فئة البيئات التي نغطيها بعمق. أسرة sanitize-* منفصلة: فهي تعمل بعد عودة الأداة، لذا تبلغ عن سر في إخراج الأداة بدلاً من إبقاؤه بعيداً عن السياق.

→ جميع 39 سياسة مدمجة

---

سياساتك الخاصة

أسقط ملف في .failproofai/policies/ — يتم تحميله تلقائياً، بدون أعلام مطلوبة. تعهد بها والفريق بأكمله يحصل عليها في السحب التالي.

import { customPolicies, deny, allow } from "failproofai";

customPolicies.add({
  name: "no-production-writes",
  match: { events: ["PreToolUse"] },
  fn: async (ctx) => {
    if (ctx.toolInput?.file_path?.includes("production"))
      return deny("Writes to production paths are blocked.");
    return allow();
  },
});

ثلاثة قرارات متاحة لكل سياسة:

القرار	التأثير
allow()	السماح بالعملية
deny(message)	منعها — الرسالة تعود إلى الوكيل
instruct(message)	السماح بها، لكن أضف سياقاً إلى طلب الوكيل التالي

→ اكتب سياسة

---

المراقبة

الفرض هو نصف. النصف الآخر هو معرفة ما فعله الوكيل فعلاً.

قم بتشغيل failproofai بدون وسائط وسيخدم لوحة تحكم على localhost:8020 يقرأ سجل التشغيل الموجود بالفعل على جهازك — بدون حساب، بدون التسجيل، لا شيء يترك الصندوق. تحصل على قائمة الجلسات، وتسلسل استدعاءات النموذج، واستدعاءات الأدوات وقرارات الخطاف داخل كل تشغيل، ما تم منعه وما قالت السياسة للوكيل، وتدقيق غير متصل (failproofai audit) الذي يمسح السجل الخاص بك بحثاً عن أنماط محفوفة بالمخاطر ويقترح سياسات لإيقافها.

→ لوحة التحكم المحلية · قراءة تتبع · التدقيق المحلي

Failproof AI Observability هي الجانب المستضاف من نفس نموذج البيانات، للفرق التي تشغل وكلاء عبر أسطول: كل تشغيل من كل بيئة تشغيل في مكان واحد، رسم بياني للتنفيذ مع وكلاء فرعيين متوازيين على مسارات خاصة بهم، زمن انتظار p50/p95/p99 للنماذج والأدوات والخطافات، تكلفة لكل نموذج وتتبع نافذة السياق، تتبع الأخطاء، SQL على أثارك الخاصة مع لوحات تحكم قابلة للمشاركة، التقييمات المسجلة من قبل خدمتك الخاصة، التدقيق المجدول الذي يحول الإخفاقات المتكررة إلى نتائج مدعومة بالأدلة، والتنبيهات الموجهة إلى Slack أو البريد الإلكتروني أو webhook موقعة. الاستضافة الذاتية في مجموعتك الخاصة متاحة على خطة Enterprise.

→ الجلسات · التدقيق · احجز عرضاً توضيحياً

---

الوثائق

ابدأ
البداية السريعة	قم بالتثبيت، وقم بتوصيل بيئة تشغيل، وشاهد أول تشغيل
المفاهيم	كيفية عمل نظام الخطاف
بيئات التشغيل المدعومة	جميع 12، وما يمكن لكل واحدة أن تفرضه

لاحظ
الجلسات	اتبع التشغيل: النماذج والأدوات والأخطاء وزمن الانتظار
قراءة تتبع	ما يخبرك به رسم البياني التنفيذي
التدقيق	ابحث عن أنماط الفشل عبر جلسات عديدة
لوحة التحكم المحلية	localhost:8020، لا يتطلب حساباً

فرض
مجموعات السياسات	سياسات Failproof AI، والمجموعات من مركز السياسات
اكتب سياسة	من التدقيق، أو في الكود
الإعدادات	نطاقات التكوين وقواعد الدمج ومعاملات السياسة

أدخل وكيلك الخاص
Python SDK	الإبلاغ عن عمليات من وكيل بدون بيئة تشغيل
Policy SDK	مرجع allow / deny / instruct

---

الترخيص

MIT مع Commons Clause — مجاني للاستخدام الداخلي والشخصي؛ إعادة البيع التجاري لـ failproofai نفسه تتطلب اتفاقية منفصلة. انظر LICENSE للنص الكامل.

---

المساهمة

انظر CONTRIBUTING.md. السياسات الجديدة والحالات الحدودية والترجمات جميعها موضع ترحيب.

قم بالبناء قبل أن تبدأ. قم بتشغيل bun install && bun run build أولاً. يقوم هذا الريبو بتشغيل خطافات failproofai الخاصة به على نفسه، ويحل failproofai المستورد مقابل dist/ المترجم — بدون بناء ستصل إلى أخطاء خطاف Cannot find package 'failproofai'. أعد البناء بعد تغيير src/. انظر البناء قبل أن تعمل خطافات dev في الريبو.

---

تم البناء بـ ❤️ بواسطة befailproof.ai في SF و Bengaluru.