failproofai 0.0.2 → 0.0.3

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

@@ -0,0 +1,564 @@
+---
+title: מדיניויות מובנות
+description: "כל 30 מדיניויות מובנות התופסות מצבי כישלון נפוצים של סוכנים"
+icon: shield
+---
+
+failproofai מגיע עם 30 מדיניויות מובנות התופסות מצבי כישלון נפוצים של סוכנים. כל מדיניות מופעלת על סוג אירוע hook ספציפי וושם כלי. תשע מדיניויות מקבלות פרמטרים שמאפשרים לך לכוונן את התנהגותן ללא כתיבת קוד. ארבע מדיניויות workflow בטא אוכפות צינור commit → push → PR → CI לפני שClaude עוצר.
+
+---
+
+## סקירה כללית
+
+מדיניויות מקובצות לקטגוריות:
+
+| קטגוריה | מדיניויות | סוג Hook |
+|----------|----------|-----------|
+| [פקודות מסוכנות](#dangerous-commands) | block-sudo, block-rm-rf, block-curl-pipe-sh, block-failproofai-commands | PreToolUse |
+| [סודות (מסנני)](#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 |
+| [Workflow (בטא)](#workflow-beta) | require-commit-before-stop, require-push-before-stop, require-pr-before-stop, require-ci-green-before-stop | Stop |
+
+- **`block-`** — עצור את הסוכן מהמשך.
+- **`warn-`** — תן לסוכן הקשר נוסף כך שיוכל להתאושש בעצמו.
+- **`sanitize-`** — סלק נתונים רגישים מפלט הכלי לפני שהסוכן רואה זאת.
+- **`require-`** — חסום את אירוע ה-Stop עד שתנאים מתקיימים.
+
+---
+
+<Tip>
+כל מדיניות תומכת בשדה `hint` אופציונלי ב-`policyParams`. ה-hint מצורף להודעת deny או instruct שClaude רואה, תוך מתן הנחיה מעשית ללא שינוי קוד מדיניות. עובד עם מדיניויות מובנות, מותאמות וקונווציה. ראה [תצורה → hint](/he/configuration#hint-cross-cutting) לפרטים.
+</Tip>
+
+---
+
+## פקודות מסוכנות
+
+מנע סוכנים מהרצת פעולות שקשה להוציא מהן או שעלולות להזיק למערכת המארח.
+
+### `block-sudo`
+
+**אירוע:** PreToolUse (Bash)  
+**ברירת מחדל:** דוחה כל פקודת `sudo`.
+
+חוסם הזעקות המכילות את המילה `sudo`. התאמת דפוס נעשית על סימנים מפוענחים של פקודה, לא על המחרוזת הגולמית, כדי למנוע עקיפה דרך הזרקת אופרטור shell.
+
+**פרמטרים:**
+
+| Param | סוג | ברירת מחדל | תיאור |
+|-------|------|---------|-------------|
+| `allowPatterns` | `string[]` | `[]` | קידומות פקודה בדיוק המותרות. כל רשומה מתאימה לסימנים של argv המפוענחים. |
+
+**דוגמה:**
+
+```json
+{
+  "policyParams": {
+    "block-sudo": {
+      "allowPatterns": ["sudo systemctl status", "sudo journalctl"]
+    }
+  }
+}
+```
+
+עם תצורה זו, `sudo systemctl status nginx` מותר, אבל `sudo rm /etc/hosts` דחוי.
+
+<Note>
+דפוסים מתאימים לסימנים מפוענחים, לא למחרוזת הפקודה הגולמית. זה מונע עקיפה דרך אופרטורים shell מצורפים (למשל `sudo systemctl status x; rm -rf /` לא מתאים ל-`sudo systemctl status *`).
+</Note>
+
+---
+
+### `block-rm-rf`
+
+**אירוע:** PreToolUse (Bash)  
+**ברירת מחדל:** דוחה `rm -rf`, `rm -fr` וצורות מחיקה רקורסיביות דומות.
+
+**פרמטרים:**
+
+| Param | סוג | ברירת מחדל | תיאור |
+|-------|------|---------|-------------|
+| `allowPaths` | `string[]` | `[]` | נתיבים בטוחים למחיקה רקורסיבית (למשל `/tmp`). |
+
+**דוגמה:**
+
+```json
+{
+  "policyParams": {
+    "block-rm-rf": {
+      "allowPaths": ["/tmp", "/var/cache"]
+    }
+  }
+}
+```
+
+---
+
+### `block-curl-pipe-sh`
+
+**אירוע:** PreToolUse (Bash)  
+**ברירת מחדל:** דוחה `curl <url> | bash`, `curl <url> | sh`, `wget <url> | bash` ודפוסים דומים.
+
+ללא פרמטרים.
+
+---
+
+### `block-failproofai-commands`
+
+**אירוע:** PreToolUse (Bash)  
+**ברירת מחדל:** דוחה פקודות שיבטלו או בטלו את failproofai עצמו (למשל `npm uninstall failproofai`, `failproofai policies --uninstall`).
+
+ללא פרמטרים.
+
+---
+
+## סודות (מסנני)
+
+עצור סוכנים מדליפת עתודות לקשרם או לפלט שלהם. מדיניויות מסנן מופעלות על אירועי **PostToolUse**. כאשר Claude מריץ פקודת Bash, קורא קובץ, או קורא לכל כלי, מדיניויות אלה בוחנות את הפלט לפני שהוא מוחזר ל-Claude. אם דפוס סוד מזוהה, המדיניות מחזירה החלטת deny המונעת את העברת הפלט חזרה.
+
+### `sanitize-jwt`
+
+**אירוע:** PostToolUse (כל הכלים)  
+**ברירת מחדל:** מחפה JWT tokens (שלוש קטעי base64url מופרדים ב-`.`).
+
+ללא פרמטרים.
+
+---
+
+### `sanitize-api-keys`
+
+**אירוע:** PostToolUse (כל הכלים)  
+**ברירת מחדל:** מחפה פורמטי API key נפוצים: Anthropic (`sk-ant-`), OpenAI (`sk-`), GitHub PATs (`ghp_`), AWS access keys (`AKIA`), Stripe keys (`sk_live_`, `sk_test_`) וגוגל API keys (`AIza`).
+
+**פרמטרים:**
+
+| Param | סוג | ברירת מחדל | תיאור |
+|-------|------|---------|-------------|
+| `additionalPatterns` | `{ regex: string; label: string }[]` | `[]` | דפוסי regex נוספים להתיחס אליהם כסודות. |
+
+**דוגמה:**
+
+```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`
+
+**אירוע:** PostToolUse (כל הכלים)  
+**ברירת מחדל:** מחפה מחרוזות חיבור במסד נתונים המכילות עתודות משובצות (למשל `postgresql://user:password@host/db`).
+
+ללא פרמטרים.
+
+---
+
+### `sanitize-private-key-content`
+
+**אירוע:** PostToolUse (כל הכלים)  
+**ברירת מחדל:** מחפה בלוקים PEM (`-----BEGIN PRIVATE KEY-----`, `-----BEGIN RSA PRIVATE KEY-----`, וכו').
+
+ללא פרמטרים.
+
+---
+
+### `sanitize-bearer-tokens`
+
+**אירוע:** PostToolUse (כל הכלים)  
+**ברירת מחדל:** מחפה headers `Authorization: Bearer <token>` כאשר האסימון הוא 20 תווים או יותר.
+
+ללא פרמטרים.
+
+---
+
+## סביבה
+
+הגן על תצורת סביבה רגישה מלהיקרא או להיחשף על ידי סוכנים.
+
+### `block-env-files`
+
+**אירוע:** PreToolUse (Bash, Read)  
+**ברירת מחדל:** דוחה קריאת קבצי `.env` דרך `cat .env`, קריאות כלי Read עם `.env` כנתיב קובץ וכו'.
+
+לא חוסם `.envrc` או קבצים סמוכים לסביבה אחרים - רק קבצים בשם בדיוק `.env`.
+
+ללא פרמטרים.
+
+---
+
+### `protect-env-vars`
+
+**אירוע:** PreToolUse (Bash)  
+**ברירת מחדל:** דוחה פקודות המדפיסות משתני סביבה: `printenv`, `env`, `echo $VAR`.
+
+ללא פרמטרים.
+
+---
+
+## גישת קבצים
+
+שמור סוכנים לעבודה בתוך גבולות הפרויקט וחוק מקבצים רגישים.
+
+### `block-read-outside-cwd`
+
+**אירוע:** PreToolUse (Read, Bash)  
+**ברירת מחדל:** דוחה קריאת קבצים מחוץ לספריה העובדת הנוכחית (שורש הפרויקט).
+
+**פרמטרים:**
+
+| Param | סוג | ברירת מחדל | תיאור |
+|-------|------|---------|-------------|
+| `allowPaths` | `string[]` | `[]` | קידומות נתיב אבסולוטי המותרות גם אם מחוץ ל-cwd. |
+
+**דוגמה:**
+
+```json
+{
+  "policyParams": {
+    "block-read-outside-cwd": {
+      "allowPaths": ["/shared/data", "/opt/company/config"]
+    }
+  }
+}
+```
+
+---
+
+### `block-secrets-write`
+
+**אירוע:** PreToolUse (Write, Edit)  
+**ברירת מחדל:** דוחה כתיבות לקבצים בשימוש נפוץ למפתחות פרטיים ותעודות: `id_rsa`, `id_ed25519`, `*.key`, `*.pem`, `*.p12`, `*.pfx`.
+
+**פרמטרים:**
+
+| Param | סוג | ברירת מחדל | תיאור |
+|-------|------|---------|-------------|
+| `additionalPatterns` | `string[]` | `[]` | דפוסי שם קובץ נוספים (בסגנון glob) לחסימה. |
+
+**דוגמה:**
+
+```json
+{
+  "policyParams": {
+    "block-secrets-write": {
+      "additionalPatterns": [".token", ".secret"]
+    }
+  }
+}
+```
+
+---
+
+## Git
+
+מנע דחיפות מקריות, כפוי דחיפה וטעויות ענף שקשה להוציא מהן.
+
+### `block-push-master`
+
+**אירוע:** PreToolUse (Bash)  
+**ברירת מחדל:** דוחה `git push origin main` ו-`git push origin master`.
+
+**פרמטרים:**
+
+| Param | סוג | ברירת מחדל | תיאור |
+|-------|------|---------|-------------|
+| `protectedBranches` | `string[]` | `["main", "master"]` | שמות ענפים שלא ניתן לדחוף אליהם ישירות. |
+
+**דוגמה:**
+
+```json
+{
+  "policyParams": {
+    "block-push-master": {
+      "protectedBranches": ["main", "master", "release", "prod"]
+    }
+  }
+}
+```
+
+<Tip>
+כדי לאפשר דחיפה לכל הענפים (למעשה השבתת מדיניות זו ללא הסרתה מ-`enabledPolicies`), הגדר `protectedBranches: []`.
+</Tip>
+
+---
+
+### `block-work-on-main`
+
+**אירוע:** PreToolUse (Bash)  
+**ברירת מחדל:** דוחה checkout של ענפי `main` או `master` ישירות.
+
+**פרמטרים:**
+
+| Param | סוג | ברירת מחדל | תיאור |
+|-------|------|---------|-------------|
+| `protectedBranches` | `string[]` | `["main", "master"]` | שמות ענפים שלא ניתן לעשות להם checkout ישירות. |
+
+---
+
+### `block-force-push`
+
+**אירוע:** PreToolUse (Bash)  
+**ברירת מחדל:** דוחה `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`
+
+**אירוע:** PreToolUse (Bash)  
+**ברירת מחדל:** מורה ל-Claude להמשיך בזהירות בעת הרצת `git commit --amend`. לא חוסם את הפקודה.
+
+ללא פרמטרים.
+
+---
+
+### `warn-git-stash-drop`
+
+**אירוע:** PreToolUse (Bash)  
+**ברירת מחדל:** מורה ל-Claude לאשר לפני הרצת `git stash drop`. לא חוסם את הפקודה.
+
+ללא פרמטרים.
+
+---
+
+### `warn-all-files-staged`
+
+**אירוע:** PreToolUse (Bash)  
+**ברירת מחדל:** מורה ל-Claude לבדוק מה הוא בתהליך staging כשהוא מריץ `git add -A` או `git add .`. לא חוסם את הפקודה.
+
+ללא פרמטרים.
+
+---
+
+## מסד נתונים
+
+תפוס פעולות SQL הרסניות לפני שהן מתבצעות כנגד מסד הנתונים שלך.
+
+### `warn-destructive-sql`
+
+**אירוע:** PreToolUse (Bash)  
+**ברירת מחדל:** מורה ל-Claude לאשר לפני הרצת SQL המכיל `DROP TABLE`, `DROP DATABASE` או `DELETE` ללא סעיף `WHERE`.
+
+ללא פרמטרים.
+
+---
+
+### `warn-schema-alteration`
+
+**אירוע:** PreToolUse (Bash)  
+**ברירת מחדל:** מורה ל-Claude לאשר לפני הרצת הצהרות `ALTER TABLE`.
+
+ללא פרמטרים.
+
+---
+
+## אזהרות
+
+תן סוכנים הקשר נוסף לפני פעולות פוטנציאליות מסוכנות אך לא הרסניות.
+
+### `warn-large-file-write`
+
+**אירוע:** PreToolUse (Write)  
+**ברירת מחדל:** מורה ל-Claude לאשר לפני כתיבת קבצים גדולים מ-1024 KB.
+
+**פרמטרים:**
+
+| Param | סוג | ברירת מחדל | תיאור |
+|-------|------|---------|-------------|
+| `thresholdKb` | `number` | `1024` | סף גודל קובץ בקילובייטים שמעליו מוצאת אזהרה. |
+
+**דוגמה:**
+
+```json
+{
+  "policyParams": {
+    "warn-large-file-write": {
+      "thresholdKb": 256
+    }
+  }
+}
+```
+
+<Note>
+ה-hook handler אוכף הגבלת stdin של 1 MB על payload. כדי לבדוק מדיניות זו עם תוכן קטן, הגדר `thresholdKb` לערך הרבה מתחת ל-1024.
+</Note>
+
+---
+
+### `warn-package-publish`
+
+**אירוע:** PreToolUse (Bash)  
+**ברירת מחדל:** מורה ל-Claude לאשר לפני הרצת `npm publish`.
+
+ללא פרמטרים.
+
+---
+
+### `warn-background-process`
+
+**אירוע:** PreToolUse (Bash)  
+**ברירת מחדל:** מורה ל-Claude להיות זהיר בעת הפעלת תהליכים ברקע דרך `nohup`, `&`, `disown` או `screen`.
+
+ללא פרמטרים.
+
+---
+
+### `warn-global-package-install`
+
+**אירוע:** PreToolUse (Bash)  
+**ברירת מחדל:** מורה ל-Claude לאשר לפני הרצת `npm install -g`, `yarn global add` או `pip install` ללא סביבה וירטואלית.
+
+ללא פרמטרים.
+
+---
+
+## התנהגות AI
+
+גלה כאשר סוכנים נתקעים או מתנהגים בצורה בלתי צפויה.
+
+### `warn-repeated-tool-calls`
+
+**אירוע:** PreToolUse (כל הכלים)  
+**ברירת מחדל:** מורה ל-Claude לשקול מחדש כשאותו כלי נקרא 3+ פעמים עם פרמטרים זהים - סימן נפוץ לכך שהסוכן תקוע בלולאה.
+
+ללא פרמטרים.
+
+---
+
+## Workflow (בטא)
+
+אוכף workflow מסודר בקצה ההפעלה. מדיניויות אלה מופעלות על אירוע **Stop** ודוחות את Claude מהעצירה עד שכל תנאי מתקיים. הם עוקבים אחר שרשרת תלות טבעית: commit → push → PR → CI. אם מדיניות דוחה, מדיניויות מאוחרות יותר בשרשרת דולנות (deny קוטעות).
+
+כל מדיניויות workflow הן **fail-open**: אם הכלי הנדרש אינו זמין (למשל `gh` לא מותקן, אין git remote), המדיניות מתירה עם הודעה אינפורמטיבית המסבירה מדוע הבדיקה דולנה.
+
+### `require-commit-before-stop`
+
+**אירוע:** Stop  
+**ברירת מחדל:** דוחה עצירה כשיש שינויים לא commited (קבצים משונים, staged או untracked). מחזיר הודעה אינפורמטיבית כשספריית העבודה נקייה.
+
+ללא פרמטרים.
+
+---
+
+### `require-push-before-stop`
+
+**אירוע:** Stop  
+**ברירת מחדל:** דוחה עצירה כשיש commits לא pushed או כשהענף הנוכחי אין לו ענף remote tracking. מציע `git push -u` ליצירת ענף tracking אם נחוץ. נכשל open אם לא מוגדר remote.
+
+**פרמטרים:**
+
+| Param | סוג | ברירת מחדל | תיאור |
+|-------|------|---------|-------------|
+| `remote` | `string` | `"origin"` | שם remote ללדחוף אליו. |
+
+**דוגמה:**
+
+```json
+{
+  "policyParams": {
+    "require-push-before-stop": {
+      "remote": "upstream"
+    }
+  }
+}
+```
+
+---
+
+### `require-pr-before-stop`
+
+**אירוע:** Stop  
+**ברירת מחדל:** דוחה עצירה כשלא קיים pull request לענף הנוכחי או כשה-PR הקיים סגור/merged. מורה ל-Claude ליצור PR עם `gh pr create`.
+
+ללא פרמטרים.
+
+<Note>
+מדיניות זו דורשת [GitHub CLI](https://cli.github.com/) (`gh`) להיות מותקן ומאומת.
+הרץ `gh auth login` עם personal access token שיש לו scope `repo` לגישה קריאה ל-
+pull requests. אם `gh` אינו מותקן או לא מאומת, המדיניות נכשלת open ומדווחת את הסיבה ל-Claude.
+</Note>
+
+---
+
+### `require-ci-green-before-stop`
+
+**אירוע:** Stop  
+**ברירת מחדל:** דוחה עצירה כשבדיקות CI כושלות או עדיין רצות בענף הנוכחי. בודק גם GitHub Actions workflow runs וגם third-party bot checks (למשל CodeRabbit, SonarCloud, Codecov). מתייחס ל-`skipped` conclusions כהצלחה. מחזיר הודעה אינפורמטיבית כשכל הבדיקות עוברות.
+
+ללא פרמטרים.
+
+<Note>
+מדיניות זו דורשת [GitHub CLI](https://cli.github.com/) (`gh`) להיות מותקן ומאומת.
+הרץ `gh auth login` עם personal access token שיש לו scope `repo` לגישה קריאה ל-
+Actions workflow runs וה-Checks API. אם `gh` אינו מותקן או לא מאומת, המדיניות נכשלת open ומדווחת את הסיבה ל-Claude.
+</Note>
+
+---
+
+## מדיניויות בטא
+
+כמה מדיניויות מסומנות `beta` ואינן מותקנות כברירת מחדל. מדיניויות בטא עשויות להיות בעלות קצוות גסים או ליצור false positives. הן בוגרות ליציב בהוצאות עתידיות.
+
+**מדיניויות בטא נוכחיות:**
+
+- `require-commit-before-stop` — commit כל השינויים לפני עצירה
+- `require-push-before-stop` — push את כל ה-commits ל-remote
+- `require-pr-before-stop` — וודא שקיים PR לענף
+- `require-ci-green-before-stop` — כל בדיקות CI חייבות להצליח
+
+ביחד, אלה אוכפות workflow של **commit → push → PR → CI**.
+
+כדי להתקין את כל מדיניויות הבטא:
+
+```bash
+failproofai policies --install --beta
+```
+
+או התקן מדיניויות workflow ספציפיות:
+
+```bash
+failproofai policies --install require-commit-before-stop require-push-before-stop require-pr-before-stop require-ci-green-before-stop
+```
+
+הרץ `failproofai policies` כדי לראות אילו מדיניויות נושאות את דגל הבטא.
+
+---
+
+## השבתת מדיניויות בודדות
+
+הסר מדיניות ספציפית מ-`enabledPolicies` בתצורה שלך, או הגדר אותה off בטאב Policies של ה-dashboard.
+
+```json
+{
+  "enabledPolicies": [
+    "block-rm-rf",
+    "sanitize-api-keys"
+  ]
+}
+```
+
+מדיניויות שלא רשומות ב-`enabledPolicies` אינן רצות, גם אם רשומות `policyParams` קיימות בשבילן.

package/.next/standalone/docs/he/cli/dashboard.mdx

@@ -0,0 +1,28 @@
+---
+title: צפייה בהפעלות
+description: "הפעל את לוח הבקרה לעיון בהפעלות הסוכן וניהול מדיניויות"
+---
+
+```bash
+failproofai
+```
+
+מפעיל את לוח הבקרה באינטרנט בכתובת `http://localhost:8020`.
+
+## אפשרויות
+
+| דגל | תיאור |
+|------|-------------|
+| `--port <number>` | יציאה להאזנה (ברירת מחדל: `8020`) |
+| `--projects-path <path>` | החלף היכן נמצאים תיקיות פרויקט Claude Code |
+| `--allowed-origins <origins>` | מארחים/כתובות IP מופרדות בפסיקים שמורשות לגשת למשאבי פיתוח |
+
+## דוגמאות
+
+```bash
+# הפעל ביציאה שונה
+failproofai --port 9000
+
+# השתמש בנתיב פרויקטים מותאם אישית
+failproofai --projects-path ~/my-claude-projects
+```

package/.next/standalone/docs/he/cli/environment-variables.mdx

@@ -0,0 +1,34 @@
+---
+title: משתנים סביבתיים
+description: "קביעת התנהגות failproofai באמצעות משתנים סביבתיים"
+---
+
+## Dashboard
+
+| משתנה | תיאור |
+|----------|-------------|
+| `PORT` | פורט ה-Dashboard (ברירת מחדל: `8020`) |
+| `CLAUDE_PROJECTS_PATH` | הגדרת מיקום חלופי לתיקיות פרויקטי Claude Code |
+| `FAILPROOFAI_DISABLE_PAGES=policies,projects` | עמודי Dashboard להסתרה, מופרדים בפסיקים |
+| `FAILPROOFAI_ALLOWED_DEV_ORIGINS` | מערכות קצה/כתובות IP המורשות לגשת למשאבי פיתוח. זהה ל-`--allowed-origins`. |
+
+## Logging
+
+| משתנה | תיאור |
+|----------|-------------|
+| `FAILPROOFAI_LOG_LEVEL=info\|warn\|error` | רמת ה-log של השרת (ברירת מחדל: `warn`) |
+| `FAILPROOFAI_HOOK_LOG_FILE` | נתיב קובץ log מותאם אישית, או `true` לברירת המחדל (`~/.failproofai/logs/hooks.log`) |
+
+## Telemetry
+
+| משתנה | תיאור |
+|----------|-------------|
+| `FAILPROOFAI_TELEMETRY_DISABLED=1` | השבתת ה-telemetry על שימוש אנונימי |
+
+## LLM (להערכת מדיניות)
+
+| משתנה | תיאור |
+|----------|-------------|
+| `FAILPROOFAI_LLM_BASE_URL` | נקודת קצה של API ל-LLM (ברירת מחדל: `https://api.openai.com/v1`) |
+| `FAILPROOFAI_LLM_API_KEY` | מפתח API למדיניות המופעלת על ידי LLM |
+| `FAILPROOFAI_LLM_MODEL` | שם המודל (ברירת מחדל: `gpt-4o-mini`) |

package/.next/standalone/docs/he/cli/hook.mdx

@@ -0,0 +1,30 @@
+---
+title: Handler ווו (פנימי)
+description: "תהליך משנה שClaude Code מפעיל בכל אירוע כלי"
+---
+
+```bash
+failproofai --hook <EventType>
+```
+
+זה הפקודה שנרשמת ב־`settings.json` של Claude Code על ידי `failproofai policies --install`. בדרך כלל אתה לא קורא לזה ישירות.
+
+קורא payload JSON מ־stdin, מעריך את כל המדיניויות המופעלות, ויוצא עם קוד המציין את ההחלטה:
+
+| קוד יציאה | החלטה | השפעה |
+|-----------|--------|--------|
+| `0` | `allow` | אפשר את הפעולה |
+| `1` | `deny` | חסום את הפעולה - Claude רואה את סיבת הדחייה |
+| `2` | `instruct` | הוסף הדרכה להקשר של Claude |
+
+### סוגי אירועים נתמכים
+
+| קטגוריה | אירועים |
+|----------|--------|
+| **ביצוע כלי** | `PreToolUse`, `PostToolUse`, `PostToolUseFailure`, `PermissionRequest`, `PermissionDenied` |
+| **מחזור חיים של הסשן** | `SessionStart`, `SessionEnd`, `Stop`, `StopFailure` |
+| **אינטראקציה של המשתמש** | `UserPromptSubmit`, `Notification`, `Elicitation`, `ElicitationResult` |
+| **תת־אגנטים ומשימות** | `SubagentStart`, `SubagentStop`, `TaskCreated`, `TaskCompleted`, `TeammateIdle` |
+| **תצורה** | `InstructionsLoaded`, `ConfigChange`, `CwdChanged` |
+| **מערכת קבצים** | `FileChanged`, `WorktreeCreate`, `WorktreeRemove` |
+| **הקשר** | `PreCompact`, `PostCompact` |