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

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

@@ -1,47 +0,0 @@
----
-title: התקנת מדיניויות
-description: "הפעל מדיניויות כך שתפעלנה בכל קריאת כלי של סוכן"
----
-
-```bash
-failproofai policies --install [policy-names...] [options]
-```
-
-כותב ערכי hook ל-`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 המכיל מדיניויות hook מותאמות |
-
-## התנהגות
-
-- **ללא שמות מדיניויות** - פותח הנמקה אינטראקטיבית לבחירת מדיניויות
-- **שמות ספציפיים** - מפעיל את המדיניויות הללו (מתווספים לכל מדיניות שכבר מופעלות)
-- **`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/he/cli/list-policies.mdx

@@ -1,32 +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/he/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/he/cli/version.mdx

@@ -1,12 +0,0 @@
----
-title: בדיקת גרסה
-description: "הדפסת גרסת failproofai המותקנת"
----
-
-```bash
-failproofai --version
-# or
-failproofai -v
-```
-
-הדפס את מספר הגרסה המותקנת.

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

@@ -1,223 +0,0 @@
----
----
-title: הגדרות
-description: "פורמט קובץ הגדרות, מערכת שלוש-רמות, וכללי מיזוג"
-icon: gear
----
-
-failproofai משתמש בקובצי הגדרות JSON כדי לשלוט איזו מדיניויות פעילות, כיצד הן מתנהגות, ומאיפה מדיניויות מותאמות אישית נטענות. ההגדרות עוצבו כדי להיות קלות לשיתוף עם הצוות שלך - בצע commit לריפו שלך וכל מפתח יקבל את אותה רשת בטיחות לסוכנים.
-
----
-
-## יקפי הגדרות
-
-יש שלוש רמות הגדרות, המוערכות לפי סדר עדיפויות:
-
-| רמה | נתיב קובץ | מטרה |
-|-------|-----------|---------|
-| **פרויקט** | `.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"]  ← deduplicated union
-```
-
-**`policyParams`** - הרמה הראשונה המגדירה params עבור מדיניות מסוימת זוכה לחלוטין. אין מיזוג עמוק של ערכים בתוך ה-params של מדיניות.
-
-```text
-project:  block-sudo → { allowPatterns: ["sudo apt-get update"] }
-global:   block-sudo → { allowPatterns: ["sudo systemctl status"] }
-
-resolved: { allowPatterns: ["sudo apt-get update"] }   ← project wins, global ignored
-```
-
-```text
-project:  (no block-sudo entry)
-local:    (no block-sudo entry)
-global:   block-sudo → { allowPatterns: ["sudo systemctl status"] }
-
-resolved: { allowPatterns: ["sudo systemctl status"] }  ← falls through to global
-```
-
-**`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`
-
-Type: `string[]`
-
-רשימת שמות מדיניויות להפעלה. השמות חייבים להתאים בדיוק למזהי המדיניות המוצגים על ידי `failproofai policies`. ראה [Built-in Policies](/he/built-in-policies) לרשימה המלאה.
-
-מדיניויות שאינן ב-`enabledPolicies` אינן פעילות, גם אם יש להן ערכים ב-`policyParams`.
-
-### `policyParams`
-
-Type: `Record<string, Record<string, unknown>>`
-
-עדכונים בפרמטרים לפי-מדיניות. המפתח החיצוני הוא שם המדיניות; המפתחות הפנימיים הם ספציפיים למדיניות. כל מדיניות מתעדת את הפרמטרים הזמינים שלה ב-[Built-in Policies](/he/built-in-policies).
-
-אם למדיניות יש פרמטרים אך אתה לא מציין אותם, משתמשים בברירות המחדל המובנות של המדיניות. משתמשים שלא מגדירים `policyParams` בכלל מקבלים התנהגות זהה לגרסאות קודמות.
-
-מפתחות לא ידועים בתוך בלוק params של מדיניות מתעלמים בשתיקה בזמן הפעלת hook אך מסומנים כאזהרות כאשר אתה מריץ `failproofai policies`.
-
-#### `hint` (cross-cutting)
-
-Type: `string` (optional)
-
-הודעה המוצמדת לסיבה כאשר מדיניות מחזירה `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`
-
-Type: `string` (absolute path)
-
-נתיב לקובץ JavaScript המכיל מדיניויות hook מותאמות אישית. זה מוגדר באופן אוטומטי על ידי `failproofai policies --install --custom <path>` (הנתיב מופך לנתיב מוחלט לפני שהוא מאוחסן).
-
-הקובץ נטען מחדש בכל אירוע hook - אין קישור לזיכרון מטמון. ראה [Custom Policies](/he/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` אשר משתמש ב-first-scope-wins).
-
-ראה [Custom Policies](/he/custom-policies) לפרטים ודוגמאות נוספות.
-
-### `llm`
-
-Type: `object` (optional)
-
-הגדרות לקוח LLM עבור מדיניויות המבצעות קריאות AI. לא נדרש עבור רוב ההתקנות.
-
-```json
-{
-  "llm": {
-    "model": "claude-sonnet-4-6",
-    "apiKey": "sk-ant-..."
-  }
-}
-```
-
----
-
-## ניהול הגדרות מה-CLI
-
-הפקודות `policies --install` ו-`policies --uninstall` כותבות ל-`settings.json` של Claude Code (נקודות הכניסה של ה-hook), בעוד `policies-config.json` הוא הקובץ שאתה מנהל ישירות. השניים נפרדים:
-
-- **`settings.json`** - אומר ל-Claude Code לקרוא ל-`failproofai --hook <event>` בכל שימוש בכלי
-- **`policies-config.json`** - אומר ל-failproofai איזו מדיניויות להעריך ועם אילו params
-
-אתה יכול לערוך `policies-config.json` ישירות בכל זמן; שינויים נכנסים לתוקף מיידית באירוע hook הבא ללא צורך בהפעלה מחדש.
-
----
-
-## דוגמה: הגדרה ברמת פרויקט עם ברירות מחדל לצוות
-
-בצע commit `.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) לעדכונים אישיים ללא השפעה על חברי הצוות.