תצורה מקומית

Failproof AI שומר על הפרדה בין מה שמאגר יכול לבצע commit — חיווט hook, פרמטרי מדיניות, מדיניויות מותאמות אישית — לבין מצב המכונה כגון אישורים, חבילות מותקנות, והדימון.

בחר טווח

טווח קובע היכן מחוברים ה-hook, ואיזה קובץ תצורה אתה כותב פרמטרים ונתיבי מדיניויות מותאמים אישית אליו:

User חל על כל הפרויקטים במכונה זו.
Project שייך למאגר וניתן לבצע עליו commit.
Local מחליף פרויקט אחד לרמת משתמש אחד ויש להישאיר אותו ב-gitignore.

failproofai policies --install --cli claude --scope project   # wire hooks for this repository
failproofai policies --install --cli claude --scope user      # or for every project on this machine
failproofai policies

לא כל harness תומך בטווח מקומי; ה-CLI דוחה טווח שה-harness הנבחר לא יכול לייצג. איזו מדיניויות חבילה מופעלות אינו בתחום הטווח. המתג מתועד עם החבילה המותקנת, לכן failproofai policies add <name> מפעיל מדיניות עבור כל המכונה, ללא קשר למה --scope אומר.

Scope	קובץ תצורת מדיניות
Project	`<project>/.failproofai/policies-config.json`
Local	`<project>/.failproofai/policies-config.local.json`
User	`~/.failproofai/policies-config.json`

פרמטרי מדיניות משתמשים בטווח הראשון המגדיר פרמטרים לאותה מדיניות, בסדר project → local → user. נתיבי מדיניות מותאמים אישית מפורשים משתמשים בטווח הראשון המגדיר אותם.

הגדר פרמטרי מדיניות

Dashboard
CLI

פתח את המדיניות בדוח הבקרה המקומי, ערוך את הפרמטרים הנתמכים שלה, ושמור בטווח שנבחר. הפעל פעולת agent תואמת ולא תואמת, ואז בדוק את ההחלטה ב-Observe → policy.

ערוך את ה-policies-config.json של הטווח שנבחר, ואז הרץ failproofai policies: הוא מזהיר לגבי ערך policyParams השם מדיניות שלא חבילה מותקנת נושאת. הוא לא בודק את המפתחות בתוך ערך, לכן בדוק את הכתיב שלהם מול הטבלה למטה.

{
  "policyParams": {
    "block-rm-rf": {
      "allowPaths": ["/tmp/build-output"]
    }
  }
}

failproofai policies

פרמטרים שמדיניויות Failproof AI מקבלות

כל מדיניות מאמתת את סוגי הפרמטרים שלה.

מדיניות	פרמטר	סוג וברירת מחדל
`sanitize-api-keys`	`additionalPatterns`	`pattern[]`, `[]`; ערכים מכילים `regex` ו-`label`
`block-read-outside-cwd`	`allowPaths`	`string[]`, `[]`
`block-sudo`	`allowPatterns`	`string[]`, `[]`
`block-rm-rf`	`allowPaths`	`string[]`, `[]`
Infrastructure blockers	`allowPatterns`	`string[]`, `[]`
`block-secrets-write`	`additionalPatterns`	`string[]`, `[]`
`block-push-master`	`protectedBranches`	`string[]`, `["main", "master"]`
`block-work-on-main`	`protectedBranches`	`string[]`, `["main", "master"]`
`prefer-package-manager`	`allowed`, `blocked`	`string[]`, `[]`
`warn-large-file-write`	`thresholdKb`	`number`, `1024`
`require-push-before-stop`	`remote`, `baseBranch`	`string`, `"origin"`; `string`, `"main"`
`require-pr-before-stop`	`baseBranch`	`string`, `"main"`
`require-no-conflicts-before-stop`	`baseBranch`	`string`, `"main"`

דפוס allow מרחיב את מה שה-agent יכול לעשות. בדוק את הטוקניזציה המדויקת וריאציות הפקודה ב-harness היעד לפני פריסה שלה על פני צי.

הבן את קבצי המכונה

~/.failproofai מכיל קבצים נפרדים עבור גבולות אמון נפרדים:

נתיב	מטרה
`config.json`	הגדרות daemon, ביקורת וטלמטריה שאינן סודיות
`credentials.json`	אישורי ענן; מאוחסנים עם הרשאות בבעלות בלבד
`policies-config.json`	פרמטרי טווח user ונתיבי מדיניויות מותאמות אישית מפורשות
`policies/`	מדיניויות מוסכמה של משתמש, חבילות מותקנות ומדיניויות שלהן מופעלות, וחפצי מדיניות המנוהלים בענן
`hook-activity/`	יומן החלטות מדיניות מקומי
`state/`	spool דימון, בריאות, השהייה, וזמן ריצה

השתמש ב-FAILPROOFAI_HOME לשינוי מיקום של הפריסה המלאה של המכונה עבור container או בדיקה מבודדת. אל תשנה מיקום של ספריות מצב בודדות בנפרד.

לעולם אל תבצע commit ל-credentials.json. בצע commit לתצורת מדיניות פרויקט ומדיניויות מוסכמה של פרויקט רק לאחר בדיקתן כקוד אכיפה.

Connect your agents

Reference

תצורה מקומית

בחר טווח

הגדר פרמטרי מדיניות

פרמטרים שמדיניויות Failproof AI מקבלות

הבן את קבצי המכונה

​בחר טווח

​הגדר פרמטרי מדיניות

​פרמטרים שמדיניויות Failproof AI מקבלות

​הבן את קבצי המכונה

בחר טווח

הגדר פרמטרי מדיניות

פרמטרים שמדיניויות Failproof AI מקבלות

הבן את קבצי המכונה