README.he.md

---

מנופים נתמכים

שנים עשר מנופים בשתי מחלקות — עשרה CLIs קוד, ושני שערי צ'אט ו-assistant (Hermes, OpenClaw). API מדיניות אחד והיסטוריית הפעלה אחת על כולם. מה שמדיניות יכולה לחסום הוא לפי מנוף: עצירת קריאת כלים לפני ביצוע מתוודאת בכל שנים עשר, שערי קצה הרצה בשמונה. המטריצה לפי מנוף רשמת את האירועים שכל אחד מהם מכבד.

Agents שפועלים בשום אחד מהם דיווח דרך ה-Python SDK, שנותן לך ניתוח, הפעלות וביקורות. אכיפה שם צריכה ווי בסביבת ההרצה שלך — דברו איתנו ואנחנו נמפה אותה.

{/* A 6-column table instead of inline runs: table columns never re-wrap, so the grid stays 2×6 at any window width (scrolling on very narrow screens instead of collapsing into ragged orphan rows). */}

התקנה

npm install -g failproofai
failproofai config                             # חוט את ה-agents שלך ו-daemon
failproofai policies add FailproofAI/policies  # בחר מה להטיל
failproofai                                    # לוח בקרה ב-localhost:8020

ההגדרה מתחברת את ההוקים ובוחרת אפס מדיניות — הפקודה השנייה הזו היא מה שמוציא מגבלות על המכונה, וכל חבילה מוקלדת באותו אופן (failproofai policies add <owner>/<repo>; policies show <owner>/<repo> קורא אחת ראשונה). הרץ failproofai config ללא טרמינל — CI, קונטיינר, agent שמנהל אותה — וזה מיישם במקום לשאול. על מכונה שלא הוגדרה מעולם, כל פקודה אחרת מריץ את אותה אשף קודם; השבת את זה עם FAILPROOFAI_NO_FIRST_RUN=1.

עד שחבילה תגיע, הדבר היחיד שמטיל אכיפה הוא block-failproofai-commands, שתמיד פועל ולא ניתן להשבתה או השהיה: agent שיכול להשהות אכיפה יכול להשבית כל מדיניות אחרת.

---

מה זה עוצר

מדיניות	מה זה חוסם
block-env-files	קריאות של קבצי .env וקבצי סוד אחרים
warn-repeated-tool-calls	ה-agent לולאה בקריאה זהה
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

כל אחת מהן משער את הקריאה לפני ביצוע, כך שהן מחזיקות בכל שנים עשר מנופים. ארבע הראשונות חלות על כל agent שיכול לקרוא לכלי; שלושת האחרונים הם המועדפים של המפתחים — CLIs קוד הם מחלקת המנוף שאנו מכסים בעומק. משפחת 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)	חסום אותה — ההודעה חוזרת ל-agent
instruct(message)	תן לזה לעבור, אבל הוסף הקשר להנחיה הבאה של ה-agent

→ כתוב מדיניות

---

ניטור

אכיפה היא חצי אחד. החצי השני הוא לראות מה ה-agent בעצם עשה.

הרץ failproofai ללא טיעונים וזה משרת לוח בקרה ב-localhost:8020 קורא את היסטוריית ההרצה כבר על המכונה שלך — אין חשבון, אין הרשמה, כלום עוזב את הקופסה. אתה מקבל רשימת הפעלות, סדר קריאות מודל, קריאות כלים והחלטות ווי בתוך כל הרצה, מה שנחסם ומה המדיניות אמרה ל-agent, וביקורת במצב לא מקוון (failproofai audit) שסורקת את ההיסטוריה שלך לדפוסים מסוכנים ומציעה מדיניויות לעצור אותם.

→ לוח בקרה מקומי · קרא עקבול · ביקורת מקומית

Failproof AI Observability היא הצד המארח של אותו מודל נתונים, לצוותים שמריצים agents על פני צי: כל הרצה מכל מנוף במקום אחד, גרף ביצוע עם תת-agents מקביל בנתיבים שלהם, p50/p95/p99 latency עבור מודלים, כלים וווי, עלות לכל מודל וניתוח חלון הקשר, ניתוח שגיאות, SQL על העקבול שלך עם לוחות משתפים, הערכות הניקוד על ידי השירות שלך, ביקורות מתוזמנות שהופכות כשלים חוזרים להוכחות מרוכזות, והתראות שנמשלחו ל-Slack, דוא״ל או webhook חתום. Self-hosting בקלסטר שלך זמין בתוכנית Enterprise.

→ הפעלות · ביקורות · הזמן הדגמה

---

תיעוד

התחל
Quickstart	התקן, חבר מנוף, ראה את ההרצה הראשונה
מושגים	איך מערכת הווי עובדת
מנופים נתמכים	כל 12, וכל אחד יכול להטיל

שקוף
הפעלות	עקוב אחרי הרצה: מודלים, כלים, שגיאות, latency
קרא עקבול	מה גרף הביצוע אומר לך
ביקורות	מצא דפוסי כשל על פני הפעלות רבות
לוח בקרה מקומי	localhost:8020, אין צורך בחשבון

הטל
חבילות מדיניות	מדיניויות Failproof AI, וחבילות מחוב המדיניות
כתוב מדיניות	מביקורת, או בקוד
הגדרה	היקפי הגדרה, כללי מיזוג ופרמטרים של מדיניות

כלי את ה-agent שלך
Python SDK	דווח על הרצות מ-agent ללא מנוף
Policy SDK	הפניית allow / deny / instruct

---

רישיון

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

---

תרומה

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

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

---

בנוי עם ❤️ על ידי befailproof.ai ב-SF ובנגלור.