failproofai 1.0.1-beta.0 → 1.0.1

package/.next/standalone/docs-old/he/built-in-policies.mdx

@@ -0,0 +1,857 @@
+---
+---
+title: המדיניות המובנות
+description: "כל 39 המדיניות המובנות שתופסות מצבי כשל נפוצים של סוכנים"
+icon: shield
+---
+
+failproofai מגיע עם 39 מדיניות מובנות שתופסות מצבי כשל נפוצים של סוכנים. כל מדיניות מופעלת על סוג אירוע hook ספציפי ושם כלי. תשע עשרה מדיניות מקבלות פרמטרים שמאפשרים לך לכוונן את התנהגותן ללא כתיבת קוד. חמש מדיניות של זרימת עבודה אוכפות צינור commit → push → PR → CI לפני שהסוכן מפסיק.
+
+---
+
+## סקירה כללית
+
+המדיניות מחולקות לקטגוריות:
+
+| קטגוריה | מדיניות | סוג Hook |
+|----------|---------|-----------|
+| [פקודות מסוכנות](#dangerous-commands) | block-sudo, block-rm-rf, block-curl-pipe-sh, block-failproofai-commands, block-self-pause | PreToolUse |
+| [פקודות Infrastructure](#infra-commands) | block-kubectl, block-terraform, block-aws-cli, block-gcloud, block-az-cli, block-helm, block-gh-pipeline | PreToolUse |
+| [סודות (sanitizers)](#secrets-sanitizers) | sanitize-jwt, sanitize-api-keys, sanitize-connection-strings, sanitize-private-key-content, sanitize-bearer-tokens | PostToolUse |
+| [סביבה](#environment) | block-env-files, protect-env-vars | PreToolUse |
+| [גישת קבצים](#file-access) | block-read-outside-cwd, block-secrets-write | PreToolUse |
+| [Git](#git) | block-push-master, block-work-on-main, block-force-push, warn-git-amend, warn-git-stash-drop, warn-all-files-staged | PreToolUse |
+| [מסד נתונים](#database) | warn-destructive-sql, warn-schema-alteration | PreToolUse |
+| [אזהרות](#warnings) | warn-large-file-write, warn-package-publish, warn-background-process, warn-global-package-install | PreToolUse |
+| [מנהלי חבילות](#package-managers) | prefer-package-manager | PreToolUse |
+| [זרימת עבודה](#workflow) | require-commit-before-stop, require-push-before-stop, require-pr-before-stop, require-no-conflicts-before-stop, require-ci-green-before-stop | Stop |
+
+- **`block-`** — עצור את הסוכן מההמשך.
+- **`warn-`** — תן לסוכן הקשר נוסף כדי שיוכל להתקן את עצמו.
+- **`sanitize-`** — הסר נתונים רגישים מפלט הכלי לפני שהסוכן רואה זאת.
+
+### Namespaces
+
+כל מדיניות נמצאת בחריץ `<namespace>/<name>`. המדיניות המובנות שייכות ל-
+namespace **`failproofai/`** — למשל, `failproofai/sanitize-jwt`. ה-namespace 
+מונע התנגשויות כאשר אתה טוען גם מדיניות מותאמות או של צד שלישי עם שמות קצרים דומים.
+
+בתצורה שלך אתה יכול להתייחס למדיניות מובנית בשם קצר או בשם מוקדם; שתי הצורות מתייחסות לאותה מדיניות:
+
+```json
+{
+  "enabledPolicies": [
+    "sanitize-jwt",
+    "failproofai/block-rm-rf"
+  ]
+}
+```
+
+אם לשם אין `/`, failproofai מתייחס אליו כשייך ל-namespace ברירת המחדל `failproofai`. שמות שכבר מכילים `/` (למשל `myorg/foo`,
+`custom/my-hook`) נשמרים כמו שהם.
+- **`require-`** — חסום את אירוע Stop עד שתנאים מתקיימים.
+
+---
+
+<Tip>
+כל מדיניות תומכת בשדה `hint` אופציונלי ב-`policyParams`. ה-hint מצורף להודעת ה-deny או ה-instruct שClaude רואה, מה שנותן הנחיות שימושיות ללא שינוי קוד מדיניות. עובד עם מדיניות מובנות, מותאמות, וקונווקציה. ראה [Configuration → hint](/he/configuration#hint-cross-cutting) לפרטים.
+</Tip>
+
+---
+
+## פקודות מסוכנות
+
+מנע מסוכנים הפעלת פעולות שקשה לבטל או שיכולות לפגוע במערכת המארח.
+
+### `block-sudo`
+
+**Event:** PreToolUse (Bash)  
+**Default:** מחסום כל פקודת `sudo` או `doas`.
+
+חוסם פקודה שמריצה בינארית הרמה **במצב הפקודה**. ההתאמה היא מבנית ולא טקסטואלית: הפקודה מחולקת לקטעים כמו שקליפה הייתה עושה זאת, הקצאות קידומת (`FOO=bar`), הפניות מחדש, ורייצים עם הדגלים שלהם (`env`, `nohup`, `timeout`, `xargs`, `sh -c`, …) מהולכים ברחוק, והבינארי המתקבל מושווה לפי **basename**. אז `/usr/bin/sudo`, `env sudo`, `timeout 5 sudo`, `"sudo"`, `\sudo` ו-`bash -c "sudo …"` כולם חסומים, ו-`doas` מתורגמן בתור אותו היכולת תחת שם שונה.
+
+כי זה מעוגן במצב פקודה ולא בהופעת המילה בכל מקום, זה **לא** מופעל על פקודות שרק מזכירות זאת — `grep -r sudo /etc`, `cat /etc/sudoers`, `git commit -m "fix sudo handling"`, או ההיתוך `grep` המכיל את המילה כלם רצים בדרך כלל.
+
+<Warning>
+זה עוצר את הניסיון הברור; זה לא סוגר את הסוג. סוכן שיכול להריץ shell שרירותי יכול עדיין להגיע להרמה בעקיפין — דרך משתנה (`S=sudo; $S …`), צינור מפוענח base64, או קובץ מעטפת על דיסק — כי לא ניתן לעקוב אחר אלה מבדיקה של string פקודה בודדה. תייחס לזה כמשוער כנגד טעויות וסקאלציה מזדמנת, לא כגבול ביטחון נגד סוכן מוחלט. גבול אמיתי חייב להיות אכוף מתחת לקליפה.
+</Warning>
+
+**Parameters:**
+
+| Param | Type | Default | Description |
+|-------|------|---------|-------------|
+| `allowPatterns` | `string[]` | `[]` | קידומות פקודה מדויקות המותרות. כל רשומה מתאימה לאסימוני argv מנתחים. |
+
+**Example:**
+
+```json
+{
+  "policyParams": {
+    "block-sudo": {
+      "allowPatterns": ["sudo systemctl status", "sudo journalctl"]
+    }
+  }
+}
+```
+
+עם תצורה זו, `sudo systemctl status nginx` מותרת, אך `sudo rm /etc/hosts` חסומה.
+
+<Note>
+דפוסים מתאימים לאסימוני מנתחים, לא ל-raw command string. זה מונע bypass דרך אופרטורים קליפה מצורפים (למשל `sudo systemctl status x; rm -rf /` לא תואמת `sudo systemctl status *`).
+</Note>
+
+---
+
+### `block-rm-rf`
+
+**Event:** PreToolUse (Bash)  
+**Default:** מחסום `rm -rf`, `rm -fr`, וצורות מחיקה רקורסיבית דומות.
+
+**Parameters:**
+
+| Param | Type | Default | Description |
+|-------|------|---------|-------------|
+| `allowPaths` | `string[]` | `[]` | נתיבים שבטוח למחוק בצורה רקורסיבית (למשל `/tmp`). |
+
+**Example:**
+
+```json
+{
+  "policyParams": {
+    "block-rm-rf": {
+      "allowPaths": ["/tmp", "/var/cache"]
+    }
+  }
+}
+```
+
+---
+
+### `block-curl-pipe-sh`
+
+**Event:** PreToolUse (Bash)  
+**Default:** מחסום `curl <url> | bash`, `curl <url> | sh`, `wget <url> | bash`, ודפוסים דומים.
+
+אין פרמטרים.
+
+---
+
+### `block-failproofai-commands`
+
+**Event:** PreToolUse (Bash)  
+**Default:** מחסום פקודות שהיו מסירות או מנטרלות את failproofai עצמו (למשל `npm uninstall failproofai`, `failproofai policies --uninstall`).
+
+אין פרמטרים.
+
+---
+
+### `block-self-pause`
+
+**Event:** PreToolUse (Bash)  
+**Default:** מחסום `failproofai config --pause`, שמושהה את האכיפה לסשן. השהיה היא החלטה אנושית — סוכן שיכול להריץ אותה יכול לכבות כל מדיניות אחרת עם פקודה אחת.
+
+צר יותר מ-[`block-failproofai-commands`](#block-failproofai-commands) בכוונה, ולא מכוסה על ידו: מדיניות זו מעוגנת בגבול פקודה, כך `npx -y failproofai config --pause` לא תואמת אותה, ובהיותה רחבה היא לעתים קרובות כבויה כדי שסוכנים יוכלו להריץ `failproofai audit`. `--resume` ו-`--status` מותרים — אף אחד מהם לא מסיר אכיפה.
+
+זה עוצר את הניסיון הישיר, לא את כל הסוג: סוכן יכול עדיין להגיע לאותו מצב דרך כינוי או קובץ מעטפת. סגירתו במלואו דורשת שההשהיה לא תהיה נגישה מקריאת כלי כלל.
+
+אין פרמטרים.
+
+---
+
+## פקודות Infrastructure
+
+עצור סוכני קידוד מהפעלת CLIs infrastructure או הפעלת צינורות CI/CD. כל מדיניות בקטגוריה זו היא **opt-in** (`defaultEnabled: false`) — סוכנים שצריכים בדרך כלל לקרוא `kubectl`, `terraform`, וכו' לא יופרעו אלא אם תפעיל את המדיניות. כאשר הוא מופעל, כל הקראת ה-CLI המתאימה חסומה אלא אם הפקודה תואמת רשומה ב-`allowPatterns`.
+
+דקדוק דפוס זהה ל-[`block-sudo`](#block-sudo): אסימונים מתאימים לאסימוני argv מנתחים, `*` הוא כרטיס בר-תוקף לאסימון אחד, וכל פקודה המכילה אופרטור קליפה עצמאי (`&&`, `||`, `|`, `;`) או אסימון עם תווי מטא-קליפה משובצים נדחת לפני התאמת allowlist להגנה מפני התעלמות הזרקה.
+
+### `block-kubectl`
+
+**Event:** PreToolUse (Bash)  
+**Default:** מחסום כל הקראת `kubectl`.
+
+**Parameters:**
+
+| Param | Type | Default | Description |
+|-------|------|---------|-------------|
+| `allowPatterns` | `string[]` | `[]` | קידומות פקודה kubectl המותרות. |
+
+**Example:**
+
+```json
+{
+  "policyParams": {
+    "block-kubectl": {
+      "allowPatterns": ["kubectl get *", "kubectl describe *", "kubectl logs *"]
+    }
+  }
+}
+```
+
+עם תצורה זו, `kubectl get pods` מותרת אך `kubectl apply -f deploy.yaml` חסומה.
+
+---
+
+### `block-terraform`
+
+**Event:** PreToolUse (Bash)  
+**Default:** מחסום כל הקראת `terraform` או `tofu` (OpenTofu).
+
+**Parameters:**
+
+| Param | Type | Default | Description |
+|-------|------|---------|-------------|
+| `allowPatterns` | `string[]` | `[]` | קידומות פקודה terraform/tofu המותרות. |
+
+**Example:**
+
+```json
+{
+  "policyParams": {
+    "block-terraform": {
+      "allowPatterns": ["terraform plan", "terraform validate", "terraform show *"]
+    }
+  }
+}
+```
+
+---
+
+### `block-aws-cli`
+
+**Event:** PreToolUse (Bash)  
+**Default:** מחסום כל הקראת `aws` CLI.
+
+**Parameters:**
+
+| Param | Type | Default | Description |
+|-------|------|---------|-------------|
+| `allowPatterns` | `string[]` | `[]` | קידומות פקודה aws CLI המותרות. |
+
+**Example:**
+
+```json
+{
+  "policyParams": {
+    "block-aws-cli": {
+      "allowPatterns": ["aws s3 ls *", "aws sts get-caller-identity"]
+    }
+  }
+}
+```
+
+---
+
+### `block-gcloud`
+
+**Event:** PreToolUse (Bash)  
+**Default:** מחסום כל הקראת `gcloud` (Google Cloud) CLI.
+
+**Parameters:**
+
+| Param | Type | Default | Description |
+|-------|------|---------|-------------|
+| `allowPatterns` | `string[]` | `[]` | קידומות פקודה gcloud המותרות. |
+
+**Example:**
+
+```json
+{
+  "policyParams": {
+    "block-gcloud": {
+      "allowPatterns": ["gcloud auth list", "gcloud config list"]
+    }
+  }
+}
+```
+
+---
+
+### `block-az-cli`
+
+**Event:** PreToolUse (Bash)  
+**Default:** מחסום כל הקראת `az` (Azure) CLI.
+
+**Parameters:**
+
+| Param | Type | Default | Description |
+|-------|------|---------|-------------|
+| `allowPatterns` | `string[]` | `[]` | קידומות פקודה az CLI המותרות. |
+
+**Example:**
+
+```json
+{
+  "policyParams": {
+    "block-az-cli": {
+      "allowPatterns": ["az account show", "az group list"]
+    }
+  }
+}
+```
+
+---
+
+### `block-helm`
+
+**Event:** PreToolUse (Bash)  
+**Default:** מחסום כל הקראת `helm`.
+
+**Parameters:**
+
+| Param | Type | Default | Description |
+|-------|------|---------|-------------|
+| `allowPatterns` | `string[]` | `[]` | קידומות פקודה helm המותרות. |
+
+**Example:**
+
+```json
+{
+  "policyParams": {
+    "block-helm": {
+      "allowPatterns": ["helm list", "helm status *"]
+    }
+  }
+}
+```
+
+---
+
+### `block-gh-pipeline`
+
+**Event:** PreToolUse (Bash)  
+**Default:** מחסום את תת-הפקודות `gh` CLI הבאות שמתחזקות מצב או מפעילות צינורות:
+
+- `gh workflow run`, `gh workflow enable`, `gh workflow disable`
+- `gh run rerun`, `gh run cancel`
+- `gh pr merge`
+- `gh release create`, `gh release delete`
+- `gh cache delete`
+- `gh secret set`, `gh secret delete`
+
+תת-פקודות `gh` של קריאה בלבד כגון `gh pr view`, `gh pr list`, `gh run list`, `gh release view`, ו-`gh api repos/.../...` הם **לא** תואמים על ידי מדיניות זו — הם נדרשים בדרך כלל לבדיקות זרימת עבודה (כולל `require-ci-green-before-stop` של failproofai עצמו).
+
+**Parameters:**
+
+| Param | Type | Default | Description |
+|-------|------|---------|-------------|
+| `allowPatterns` | `string[]` | `[]` | הקראות סקריפטיות ספציפיות להרשות גם כי אחרת הן היו חסומות. |
+
+**Example:**
+
+```json
+{
+  "policyParams": {
+    "block-gh-pipeline": {
+      "allowPatterns": ["gh run rerun *"]
+    }
+  }
+}
+```
+
+---
+
+## סודות (sanitizers)
+
+עצור סוכנים מדליפת אישורים להקשר או פלט שלהם. מדיניות sanitizer מופעלת על אירועי **PostToolUse**. כאשר Claude מריץ פקודת Bash, קורא קובץ, או קורא לכל כלי, מדיניות אלה בוחנות את הפלט לפני שהוא מוחזר ל-Claude. אם תבנית סוד מתגלתה, המדיניות מחזירה החלטת deny שמונעת להעביר את הפלט חזרה.
+
+### `sanitize-jwt`
+
+**Event:** PostToolUse (כל כלים)  
+**Default:** Redacts JWT tokens (שלוש קטעים base64url מופרדים ב-`.`).
+
+אין פרמטרים.
+
+---
+
+### `sanitize-api-keys`
+
+**Event:** PostToolUse (כל כלים)  
+**Default:** Redacts תבניות מפתח API נפוצות: Anthropic (`sk-ant-`), OpenAI (`sk-`), GitHub PATs (`ghp_`), AWS access keys (`AKIA`), Stripe keys (`sk_live_`, `sk_test_`), ומפתחות Google API (`AIza`).
+
+**Parameters:**
+
+| Param | Type | Default | Description |
+|-------|------|---------|-------------|
+| `additionalPatterns` | `{ regex: string; label: string }[]` | `[]` | דפוסי regex נוספים להתייחס כסודות. |
+
+**Example:**
+
+```json
+{
+  "policyParams": {
+    "sanitize-api-keys": {
+      "additionalPatterns": [
+        { "regex": "myco_[A-Za-z0-9]{32}", "label": "MyCo internal API key" },
+        { "regex": "pat_[0-9a-f]{40}", "label": "Internal PAT" }
+      ]
+    }
+  }
+}
+```
+
+---
+
+### `sanitize-connection-strings`
+
+**Event:** PostToolUse (כל כלים)  
+**Default:** Redacts connection strings של מסד נתונים המכילות אישורים משובצים (למשל `postgresql://user:password@host/db`).
+
+אין פרמטרים.
+
+---
+
+### `sanitize-private-key-content`
+
+**Event:** PostToolUse (כל כלים)  
+**Default:** Redacts PEM blocks (`-----BEGIN PRIVATE KEY-----`, `-----BEGIN RSA PRIVATE KEY-----`, וכו').
+
+אין פרמטרים.
+
+---
+
+### `sanitize-bearer-tokens`
+
+**Event:** PostToolUse (כל כלים)  
+**Default:** Redacts headers `Authorization: Bearer <token>` כאשר הטוקן הוא 20 תווים או יותר.
+
+אין פרמטרים.
+
+---
+
+## סביבה
+
+הגן על תצורת סביבה רגישה מלהיות קראה או חשופה על ידי סוכנים.
+
+### `block-env-files`
+
+**Event:** PreToolUse (Bash, Read)  
+**Default:** מחסום קריאה של קבצי `.env` דרך `cat .env`, קריאות כלי `Read` עם `.env` כנתיב קובץ, וכו'.
+
+לא חוסם `.envrc` או קבצים סמוכים לסביבה אחרים - רק קבצים בשם בדיוק `.env`.
+
+אין פרמטרים.
+
+---
+
+### `protect-env-vars`
+
+**Event:** PreToolUse (Bash)  
+**Default:** מחסום פקודות שמדפיסות משתני סביבה: `printenv`, `env`, `echo $VAR`.
+
+אין פרמטרים.
+
+---
+
+## גישת קבצים
+
+שמור סוכנים עובדים בתוך גבולות פרויקט ובמרחק מקבצים רגישים.
+
+### `block-read-outside-cwd`
+
+**Event:** PreToolUse (Read, Bash)  
+**Default:** מחסום קריאה של קבצים מחוץ לשורש הפרויקט. הגבול הוא `CLAUDE_PROJECT_DIR` (מוגדר פעם אחת לסשן על ידי Claude Code), עם fallback לספריית העבודה הנוכחית של הסשן כאשר משתנה זה לא מוגדר. שימוש בשורש הפרויקט בעדיפות על פני `cwd` החיוני פירושו שהגבול נשאר יציב גם לאחר ש-Claude מבחין ל-subdirectory.
+
+**Parameters:**
+
+| Param | Type | Default | Description |
+|-------|------|---------|-------------|
+| `allowPaths` | `string[]` | `[]` | קידומות נתיבים מוחלטים המותרות גם אם מחוץ לשורש הפרויקט. |
+
+**Example:**
+
+```json
+{
+  "policyParams": {
+    "block-read-outside-cwd": {
+      "allowPaths": ["/shared/data", "/opt/company/config"]
+    }
+  }
+}
+```
+
+---
+
+### `block-secrets-write`
+
+**Event:** PreToolUse (Write, Edit)  
+**Default:** מחסום כתיבה לקבצים בשימוש נפוץ למפתחות פרטיים ותעודות: `id_rsa`, `id_ed25519`, `*.key`, `*.pem`, `*.p12`, `*.pfx`.
+
+**Parameters:**
+
+| Param | Type | Default | Description |
+|-------|------|---------|-------------|
+| `additionalPatterns` | `string[]` | `[]` | דפוסי שם קובץ נוספים (סגנון glob) לחסום. |
+
+**Example:**
+
+```json
+{
+  "policyParams": {
+    "block-secrets-write": {
+      "additionalPatterns": [".token", ".secret"]
+    }
+  }
+}
+```
+
+---
+
+## Git
+
+מנע pushes אקראיות, force-pushes, וטעויות ענף שקשה לבטל.
+
+### `block-push-master`
+
+**Event:** PreToolUse (Bash)  
+**Default:** מחסום `git push origin main` ו-`git push origin master`.
+
+**Parameters:**
+
+| Param | Type | Default | Description |
+|-------|------|---------|-------------|
+| `protectedBranches` | `string[]` | `["main", "master"]` | שמות ענפים שלא ניתן לדחוף אליהם ישירות. |
+
+**Example:**
+
+```json
+{
+  "policyParams": {
+    "block-push-master": {
+      "protectedBranches": ["main", "master", "release", "prod"]
+    }
+  }
+}
+```
+
+<Tip>
+כדי לאפשר דחיפה לכל הענפים (למעשה הכבאה מדיניות זו ללא הסרתה מ-`enabledPolicies`), הגדר `protectedBranches: []`.
+</Tip>
+
+---
+
+### `block-work-on-main`
+
+**Event:** PreToolUse (Bash)  
+**Default:** מחסום `git commit`, `git merge`, `git rebase`, ו-`git cherry-pick` בזמן שעץ העבודה נמצא על `main` או `master`. יצירה וחלפה של ענפים (`git checkout`, `git checkout -b`, `git switch`, `git switch -c`) אינם מושפעים.
+
+**Parameters:**
+
+| Param | Type | Default | Description |
+|-------|------|---------|-------------|
+| `protectedBranches` | `string[]` | `["main", "master"]` | שמות ענפים שעליהם commit/merge/rebase/cherry-pick חסום. |
+
+---
+
+### `block-force-push`
+
+**Event:** PreToolUse (Bash)  
+**Default:** מחסום `git push --force` ו-`git push -f`.
+
+אין פרמטרים ספציפיים למדיניות. השתמש ב-[`hint`](/he/configuration#hint-cross-cutting) חוצה-גזירה להציע חלופות:
+
+```json
+{
+  "policyParams": {
+    "block-force-push": {
+      "hint": "Create a new branch from your current HEAD (e.g. `git checkout -b <new-branch>`) and push that instead."
+    }
+  }
+}
+```
+
+---
+
+### `warn-git-amend`
+
+**Event:** PreToolUse (Bash)  
+**Default:** משנה את Claude להמשיך בזהירות בעת הפעלת `git commit --amend`. לא חוסם את הפקודה.
+
+אין פרמטרים.
+
+---
+
+### `warn-git-stash-drop`
+
+**Event:** PreToolUse (Bash)  
+**Default:** משנה את Claude לאישור לפני הפעלת `git stash drop`. לא חוסם את הפקודה.
+
+אין פרמטרים.
+
+---
+
+### `warn-all-files-staged`
+
+**Event:** PreToolUse (Bash)  
+**Default:** משנה את Claude לבדיקת מה שהוא מבצע staging כאשר הוא מריץ `git add -A` או `git add .`. לא חוסם את הפקודה.
+
+אין פרמטרים.
+
+---
+
+## מסד נתונים
+
+תפוס פעולות SQL הרסניות לפני שהן מבוצעות כנגד מסד הנתונים שלך.
+
+### `warn-destructive-sql`
+
+**Event:** PreToolUse (Bash)  
+**Default:** משנה את Claude לאישור לפני הפעלת SQL המכילה `DROP TABLE`, `DROP DATABASE`, או `DELETE` ללא סעיף `WHERE`.
+
+אין פרמטרים.
+
+---
+
+### `warn-schema-alteration`
+
+**Event:** PreToolUse (Bash)  
+**Default:** משנה את Claude לאישור לפני הפעלת הצהרות `ALTER TABLE`.
+
+אין פרמטרים.
+
+---
+
+## אזהרות
+
+תן לסוכנים הקשר נוסף לפני פעולות פוטנציאליות מסוכנות אך לא הרסניות.
+
+### `warn-large-file-write`
+
+**Event:** PreToolUse (Write)  
+**Default:** משנה את Claude לאישור לפני כתיבת קבצים גדולים מ-1024 KB.
+
+**Parameters:**
+
+| Param | Type | Default | Description |
+|-------|------|---------|-------------|
+| `thresholdKb` | `number` | `1024` | סף גודל קובץ בקילובייטים שמעליו הוצגת אזהרה. |
+
+**Example:**
+
+```json
+{
+  "policyParams": {
+    "warn-large-file-write": {
+      "thresholdKb": 256
+    }
+  }
+}
+```
+
+<Note>
+עורך ה-hook אוכף מגבלת stdin של 1 MB על עומסים. כדי לבדוק מדיניות זו עם תוכן קטן, הגדר `thresholdKb` לערך הרבה מתחת ל-1024.
+</Note>
+
+---
+
+### `warn-package-publish`
+
+**Event:** PreToolUse (Bash)  
+**Default:** משנה את Claude לאישור לפני הפעלת `npm publish`.
+
+אין פרמטרים.
+
+---
+
+### `warn-background-process`
+
+**Event:** PreToolUse (Bash)  
+**Default:** משנה את Claude להיות זהיר בעת הפעלת תהליכים בתמונה דרך `nohup`, `&`, `disown`, או `screen`.
+
+אין פרמטרים.
+
+---
+
+### `warn-global-package-install`
+
+**Event:** PreToolUse (Bash)  
+**Default:** משנה את Claude לאישור לפני הפעלת `npm install -g`, `yarn global add`, או `pip install` ללא סביבה וירטואלית.
+
+אין פרמטרים.
+
+---
+
+## מנהלי חבילות
+
+אכוף אילו מנהלי חבילות הסוכן רשאי להשתמש.
+
+### `prefer-package-manager`
+
+**Event:** PreToolUse (Bash)  
+**Default:** מנוטרל. כאשר מופעל, חוסם כל פקודת מנהל חבילות שלא ברשימת ה-`allowed` ואומר ל-Claude לכתוב מחדש את הפקודה בעזרת מנהל מותר.
+
+גילויים: pip, pip3, python -m pip, npm, npx, yarn, pnpm, pnpx, bun, bunx, uv, poetry, pipenv, conda, cargo.
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `allowed` | string[] | `[]` | שמות מנהלי חבילות מותרים. כל מנהל שנגילה שאינו ברשימה זו חסום. כאשר ריק, המדיניות היא no-op. |
+| `blocked` | string[] | `[]` | שמות מנהלים נוספים לחסום מעבר לרשימה המובנית (למשל `['pdm', 'pipx']`). |
+
+רשימת החסימה המובנית מכסה: pip, pip3, npm, npx, yarn, pnpm, pnpx, bun, bunx, uv, poetry, pipenv, conda, cargo. השתמש ב-`blocked` כדי להוסיף מנהלים שלא ברשימה זו.
+
+**Example configuration:**
+
+```json
+{
+  "enabledPolicies": ["prefer-package-manager"],
+  "policyParams": {
+    "prefer-package-manager": {
+      "allowed": ["uv", "bun"],
+      "blocked": ["pdm", "pipx"]
+    }
+  }
+}
+```
+
+עם תצורה זו, `pip install flask` ו-`pdm install flask` שניהם חסומים עם הודעה שאומרת ל-Claude להשתמש ב-`uv` או `bun` במקום זאת. פקודות כמו `uv pip install flask` מותרות כי `uv` ברשימת ה-allowlist ובדיקות תחילה.
+
+---
+
+## התנהגות AI
+
+גלה כאשר סוכנים תקועים או מתנהגים בצורה בלתי צפויה.
+
+### `warn-repeated-tool-calls`
+
+**Event:** PreToolUse (כל כלים)  
+**Default:** משנה את Claude להיעדר זימה כאשר אותו כלי נקרא 3 + פעמים עם פרמטרים זהים - סימן נפוץ שהסוכן תקוע בלופ.
+
+אין פרמטרים.
+
+---
+
+## זרימת עבודה
+
+אכוף זרימת עבודה משומרת של סיום סשן. מדיניות אלה מופעלות על אירוע **Stop** וחוסמות את הסוכן מהפסקה עד שכל תנאי מתקיימים. הם עוקבים אחר שרשרת תלות טבעית: commit → push → PR → CI. אם מדיניות חוסמת, מדיניות מאוחרות יותר בשרשרת דלוקות (deny short-circuits).
+
+כל מדיניות זרימת עבודה היא **fail-open**: אם הכלי הנדרש לא זמין (למשל `gh` לא מותקן, אין git remote), המדיניות מאפשרת עם הודעה מידע המסבירה מדוע הבדיקה דלוקה.
+
+### Stop semantics לכל CLI
+
+אכיפת Stop נראית מעט שונה בין שישת CLIs הנתמכים כי לכל אחד יש חוזה hook שונה של סיום סוכן. התוצאה (**outcome**) זהה — הסוכן לא יוצא מהפסקה בזמן שדלת זרימת עבודה נכשלת — אך **המכניקה** שונה. הטבלה להלן מסכמת; רק Pi יש quirk נראה למשתמש ראוי להבנה לפני שתפעיל מדיניות `require-*-before-stop`.
+
+| CLI | מתי השער מופעל | מה אתה רואה |
+|---|---|---|
+| Claude Code | אותה לולאת סוכן, מיד | Claude ממשיך לעבוד — תיקונים הבעיה, ואז מנסה לסיים שוב. אין הפסקה גלויה לך. |
+| Codex | אותה לולאת סוכן, מיד | זהה Claude. |
+| GitHub Copilot CLI | אותה לולאת סוכן, מיד | זהה Claude (משתמש בערוץ ניסיון של Copilot `{decision:"block", reason}` — אומת אמפיראית נגד Copilot CLI 1.0.41). |
+| Cursor Agent | אותה לולאת סוכן, מיד | זהה Claude (משתמש בערוץ `{followup_message}` של Cursor — מוגבל ל-`loop_limit`, ברירת מחדל 5 ניסיונות). |
+| OpenCode | אותה לולאת סוכן, מיד | זהה Claude (משתמש בקריאה SDK של OpenCode `client.session.prompt(...)` מנותבת דרך `hookSpecificOutput.additionalContext`). |
+| **Pi (pi-coding-agent)** | **תור משתמש הבא** | **Pi חסום גלוי** כאשר השער מופעל — לולאת הסוכן שלו יוצאת והוחזרו ללאים. השער ואז מופעל את הפעם הבאה בה תגיש בקשה: failproofai הקדים directive `MANDATORY ACTION REQUIRED` למערכת prompt של התור ההוא, משנה את ה-LLM להשלים את שלב זרימת העבודה (commit, push, וכו') לפני לעשות מה שבקשת. |
+
+<Note>
+**מגבלת Pi.** `AgentEndEvent` של Pi (המקבילה של ה-upstream של Claude's `Stop` hook) אין סוג Result — בזמן שזה מופעל, לולאת הסוכן של Pi כבר יצאה. Pi לא יכול להיאכף להקראות אותה לולאה כמו Claude / Copilot / Cursor / OpenCode יכול. failproofai משנה את השער לאירוע `before_agent_start` של Pi (שמופעל לאחר בקשת משתמש הבאה) כך בדיקת הזרימה עדיין אוכפת, רק בתור הבא במקום הנוכחי.
+
+**מה זה אומר בפועל:**
+
+- לאחר Pi מפסיק, סיבת ה-deny נתפסת בזיכרון מונחה על ידי Pi session id. הבקשה הבאה בדיוק בה אתה מגיש בתור אותו Pi processes סוביה: ה-LLM רואה את directive `MANDATORY ACTION REQUIRED` בחלק העליון של system prompt שלו, commits (או pushes / פותח את PR / מחכה עבור CI), ורק אחר כך ממשיך עם הבקשה שלך. סיבת ה-deny שנתפסה היא one-shot — פעם סוביה, השער ברור.
+- השער מוגבל על ידי lifetime התהליך של Pi. אם אתה `Ctrl+C` Pi או יוצא בין תורות, הרשומה בזיכרון מוטלת יחד עם התהליך והשער הוא miss. Claude, Copilot, Cursor, ו-OpenCode יש את אותו bound (להרוג את הסוכן והשער הוא miss) — Pi פשוט עושה את זה גלוי יותר כי הסוכן עוזב גלוי לפני השער.
+- ה-deny תלוי גם מתוך ברור על `session_shutdown` בשום סיבה (`new` / `resume` / `fork` / `quit`), כך gate stale מתור קוד לא יכול דלוף לתור פרייש התחיל בתהליך אותו Pi.
+
+אם אתה צריך Claude-סגנון אותו-לולאה ניסיון, הפעל את `Stop` מדיניות שלך תחת כל אחד מחמש CLIs נתמך. אנחנו עוקבים Pi upstream עבור עתידי Result סוג על `AgentEndEvent` שהיה לתן לנו לסגור את הפער זה.
+</Note>
+
+### `require-commit-before-stop`
+
+**Event:** Stop  
+**Default:** חוסם עצירה כאשר יש שינויים uncommitted (שונה, staged, או קבצים untracked). מחזיר הודעת מידע כאשר ספריית העבודה ברורה.
+
+אין פרמטרים.
+
+---
+
+### `require-push-before-stop`
+
+**Event:** Stop  
+**Default:** חוסם עצירה כאשר יש commits unpushed או כאשר הענף הנוכחי אין remote tracking branch. מציע `git push -u` ליצור tracking branch אם נדרש. נכשל פתוח אם אין remote מוגדר.
+
+**Parameters:**
+
+| Param | Type | Default | Description |
+|-------|------|---------|-------------|
+| `remote` | `string` | `"origin"` | שם remote לדחוף אליו. |
+
+**Example:**
+
+```json
+{
+  "policyParams": {
+    "require-push-before-stop": {
+      "remote": "upstream"
+    }
+  }
+}
+```
+
+---
+
+### `require-pr-before-stop`
+
+**Event:** Stop  
+**Default:** חוסם עצירה כאשר אין pull request קיים לענף הנוכחי, או כאשר ה-PR הקיים סגור ללא merge. משנה את Claude ליצור PR עם `gh pr create`. כאשר ה-PR הוא **merged**, המדיניות מאפשרת (העבודה חיברה) והודעה רמזת להחליף ענף (`git checkout main && git pull`).
+
+אין פרמטרים.
+
+<Note>
+מדיניות זו דורשת [GitHub CLI](https://cli.github.com/) (`gh`) להיות מותקן ומאומת.
+הפעל `gh auth login` עם personal access token שיש לו `repo` scope לקריאה גישה ל-
+pull requests. אם `gh` לא מותקן או לא מאומת, המדיניות נכשל פתוח ודיווח הסיבה ל-Claude.
+</Note>
+
+---
+
+### `require-no-conflicts-before-stop`
+
+**Event:** Stop  
+**Default:** חוסם עצירה כאשר הענף הנוכחי לא יכול לערבב בניקיון לענף הבסיס. המדיניות תחילה מאשרת יש `OPEN` PR ב-GitHub לענף — ללא אחד, אין merge target לאכיפה, כל המדיניות short-circuits לאפשר. פעם `OPEN` PR אושרה, שניים probes עצמאיים:
+
+1. **Local** — `git merge-tree --write-tree --name-only origin/<baseBranch> HEAD`. בסכסוך, ה-deny הודעה שמות הקבצים conflicted כך Claude יודע בדיוק מה לפתור.
+2. **GitHub** — reuses את `gh pr view --json mergeable,state` תוצאה כבר fetched בה-precheck. תופסת סכסוכים stale המקומי `origin/<baseBranch>` היה miss (למשל מישהו נחת conflicting PR ב-`main` מאז ה-last fetch). תוצאת `CONFLICTING` חוסמת. תוצאת `UNKNOWN` גם חוסמת משנה את Claude להמתין ~10 שניות ו-re-check לפני לנסות עצירה שוב — זה מונע false negatives בזמן GitHub recomputes.
+
+דלוקות כלל בעת: `gh` לא מותקן, PR לא קיים לענף, ה-PR state לא `OPEN` (למשל `MERGED`, `CLOSED`), או `gh pr view` מחזיר unparseable פלט. גם נכשל פתוח כאשר `origin/<baseBranch>` חסר locally או כאשר commits אין קדמה של בסיס — אלה Slayer 1 fall-throughs עדיין להתייעץ את ה-cached PR mergeability לפני יום.
+
+**Parameters:**
+
+| Param | Type | Default | Description |
+|-------|------|---------|-------------|
+| `baseBranch` | `string` | `"main"` | בסיס ענף לבדיקה סכסוכים נגד. |
+
+<Note>
+GitHub CLI (`gh`) נדרש למדיניות זו. המדיניות משתמשת `gh pr view` לאשר
+`OPEN` PR קיים לפני הפעלת כל probe סכסוך — ללא `gh`, המדיניות
+short-circuits לאפשר. הפעל `gh auth login` עם personal access token שיש לו
+`repo` scope לקריאה גישה ל-pull requests.
+</Note>
+
+---
+
+### `require-ci-green-before-stop`
+
+**Event:** Stop  
+**Default:** חוסם עצירה כאשר בדיקות CI נוכשלות או עדיין רצות על הענף הנוכחי. בדוקות GitHub Actions זרימות עבודה וב-third-party bot בדיקות (למשל CodeRabbit, SonarCloud, Codecov). מתרגמות `skipped`, `cancelled`, ו-`neutral` מסקנות כ-non-failing (האחרונות מכסות למשל Socket Security alerts על ציבור חיצוני PRs, כאשר ה-app intentionally דיווחים neutral רמת success/failure). מחזירה הודעת מידע כאשר כל בדיקות לעבור.
+
+אין פרמטרים.
+
+<Note>
+מדיניות זו דורשת [GitHub CLI](https://cli.github.com/) (`gh`) להיות מותקן ומאומת.
+הפעל `gh auth login` עם personal access token שיש לו `repo` scope לקריאה גישה ל-
+Actions זרימות עבודה רצות ו-Checks API. אם `gh` לא מותקן או לא מאומת, המדיניות נכשל פתוח ודיווח הסיבה ל-Claude.
+</Note>
+
+---
+
+---
+
+## השבתת מדיניות בודדות
+
+הסר מדיניות ספציפית מ-`enabledPolicies` בתצורה שלך, או כבה אותה בכרטיסיית Policies של ה-dashboard.
+
+```json
+{
+  "enabledPolicies": [
+    "block-rm-rf",
+    "sanitize-api-keys"
+  ]
+}
+```
+
+מדיניות שלא רשומה ב-`enabledPolicies` לא רצות, גם אם ערכי `policyParams` קיימים עבורם.