README.he.md

⚠️ هذه ترجمة آلية. للاطلاع على أحدث إصدار، راجع English README.

🇺🇸 English | 🇨🇳 简体中文 | 🇯🇵 日本語 | 🇰🇷 한국어 | 🇪🇸 Español | 🇧🇷 Português | 🇩🇪 Deutsch | 🇫🇷 Français | 🇷🇺 Русский | 🇮🇳 हिन्दी | 🇹🇷 Türkçe | 🇻🇳 Tiếng Việt | 🇮🇹 Italiano | 🇸🇦 العربية | 🇮🇱 עברית

---

תרגומים: 简体中文 · 日本語 · 한국어 · Español · Português · Deutsch · Français · Русский · हिन्दी · Türkçe · Tiếng Việt · Italiano · العربية · עברית

פתרון כשלים בזמן ריצה עבור סוכני קוד. משתלב עם Claude Code ו-Codex. תופס לולאות, פעולות מסוכנות וציפיות סוד לפני שהם הופכים לתקריות. אפס זמן השהיית. רץ באופן מקומי.

---

CLI של סוכנים נתמכים

                    

             

התקן hooks לאחד או לכל שילוב: failproofai policies --install --cli opencode pi gemini (או --cli claude codex copilot cursor opencode pi gemini). השמט את --cli כדי לגלות CLI מותקנים באופן אוטומטי ולהיבקש.

---

התקנה

npm install -g failproofai
failproofai policies --install   # או פשוט הרץ את `failproofai` והסכים לבקשה בהפעלה הראשונה
failproofai

30 מדיניויות מובנות מופעלות מיד. לוח בקרה ב-localhost:8020. השבת בקשת הפעלה ראשונה עם FAILPROOFAI_NO_FIRST_RUN=1.

---

מה זה עוצר

מדיניות	מה זה חוסם
block-push-master	דחיפה ישירה ל-main / master
block-force-push	git push --force
block-work-on-main	commits, merges, rebases על main / master
block-rm-rf	מחיקת קבצים רקורסיבית
sanitize-api-keys	מפתחות API שדולפים להקשר הסוכן

→ כל 30 המדיניויות המובנות

---

המדיניויות שלך

שחרר קובץ אל .failproofai/policies/ — הוא נטען באופן אוטומטי, ללא דגלים נדרשים. שנה אותו וכל הצוות שלך מקבל אותו בעת ה-pull הבא.

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)	תן לזה לעבור, אך הוסף הקשר להנחיה הבאה של הסוכן

→ מדריך מדיניויות מותאמות

---

נראות הפגישה

כל קריאת כלי שהסוכן שלך מבצע מנויה באופן מקומי. לוח הבקרה מציג מה רץ, מה היה חסום ומה אמרה המדיניות לסוכן — כך שאתה לא בניחוש כשמשהו משתבש. → מדריך לוח בקרה

---

תיעוד

התחלת עבודה	התקנה והצעדים הראשונים
מדיניויות מובנות	כל 30 המדיניויות עם פרמטרים
מדיניויות מותאמות	כתוב שלך
הגדרה	היקפי הגדרה וכללי מיזוג
לוח בקרה	מנטור הפגישה ופעילות מדיניות
ארכיטקטורה	איך מערכת ה-hook עובדת

---

רישיון

MIT עם Commons Clause — חופשי לשימוש פנימי ואישי; מכירה מסחרית של failproofai עצמו דורשת הסכם נפרד. ראה LICENSE לטקסט המלא.

---

תרומה

ראה CONTRIBUTING.md. מדיניויות חדשות, מקרים קצה ותרגומים כולם מוזמנים.

בנה לפני שתתחיל. הרץ bun install && bun run build תחילה. מאגר זה מריץ את ה-hooks שלו על עצמו, והם פותרים את ייבוא ה-failproofai כנגד ה-bundle המהודר dist/ — ללא בנייה תקבל Cannot find package 'failproofai' שגיאות hook. בנה מחדש לאחר שינוי src/. ראה בנה לפני שה-dev hooks בתוך המאגר יעבדו.

---

בנוי על ידי Nivedit Jain ו-Nikita Agarwal. befailproof.ai