failproofai 1.0.1-beta.0 → 1.0.1

package/.next/standalone/docs-old/he/getting-started.mdx

@@ -0,0 +1,200 @@
+---
+---
+title: תחילת העבודה
+description: "התקן את failproofai, הפעל מדיניויות, והנח לאגנטים שלך לפעול בנאמנות"
+icon: rocket
+---
+
+## דרישות
+
+- **Node.js** >= 20.9.0
+- **Bun** >= 1.3.0 (אופציונלי - נדרש רק לבנייה מקוד מקור)
+
+---
+
+## התקנה
+
+<CodeGroup>
+
+```bash npm
+npm install -g failproofai
+```
+
+```bash bun
+bun add -g failproofai
+```
+
+</CodeGroup>
+
+---
+
+## התחלה מהירה
+
+<Steps>
+  <Step title="הפעל מדיניויות">
+    מדיניויות הן כללים שרצים לפני ואחרי כל קריאת כלי אגנט. הן תופסות פקודות הרסניות, דליפות סודות והיבטי כשל אחרים לפני שהם גורמים נזק.
+
+    ```bash
+    failproofai policies --install
+    ```
+
+    פעולה זו כותבת ערכי hook לתוך הקלים שהותקנו של האגנט (Claude Code של `~/.claude/settings.json`, OpenAI Codex של `~/.codex/hooks.json`, GitHub Copilot CLI של `~/.copilot/hooks/failproofai.json`, Cursor Agent של `~/.cursor/hooks.json`, shim של תוסף שנוצר ב-OpenCode ב-`~/.config/opencode/plugins/failproofai.mjs` בתוספת ערך הרשמה במערך `plugin` של `~/.config/opencode/opencode.json`, Pi של `~/.pi/agent/settings.json`, Hermes של `~/.hermes/config.yaml`, OpenClaw של `~/.openclaw/openclaw.json`, Factory Droid של `~/.factory/hooks.json`, Devin CLI של `~/.config/devin/config.json`, Antigravity CLI של `~/.gemini/config/hooks.json`, או ספריית התוסף שנגילתה אוטומטית של Goose ב-`~/.agents/plugins/failproofai/hooks/hooks.json`). כשיש יותר מאחד, תוצע לך בחירה; העבור `--cli claude codex copilot cursor opencode pi hermes openclaw factory devin antigravity goose` (כל תת-קבוצה) כדי לדלג על ההנמקה.
+
+    GitHub Copilot CLI, Cursor Agent, OpenCode ו-Pi הם בשלב **beta** — התקן עם `--cli copilot`, `--cli cursor`, `--cli opencode`, או `--cli pi`. Hermes (hermes-agent, שער Slack/Telegram) מותקן בהיקף משתמש עם `--cli hermes` והוא **גם** מקור ביקורת לא מקוון. OpenClaw (שער openclaw, עוזר רב-ערוץ עצמי-מתארח) מותקן בהיקף משתמש עם `--cli openclaw` — אכיפה פועלת דרך hook-ים של תוסף בתוך התהליך (`before_agent_finalize` הוא שער קצה סיבוב אמיתי, ולכן הקטגוריות המובנות של `require-*-before-stop` אכופות) — והוא **גם** מקור ביקורת לא מקוון. Factory Droid (`droid`) מותקן עם `--cli factory` (היקף משתמש + פרויקט) והוא **גם** מקור ביקורת לא מקוון. Devin CLI (`devin`, Cognition) מותקן עם `--cli devin` (היקף משתמש + פרויקט) והוא **גם** מקור ביקורת לא מקוון. Antigravity CLI (`agy`) מותקן עם `--cli antigravity` (היקף משתמש + פרויקט) והוא **גם** מקור ביקורת לא מקוון. Goose (שם קוד goose, Block) מותקן עם `--cli goose` (היקף משתמש + פרויקט) — המתקין פשוט מכניס ספריית תוסף ב-`~/.agents/plugins/failproofai/` שGoose גילה אוטומטית, והוא **גם** מקור ביקורת לא מקוון.
+
+    ```bash
+    failproofai policies --install --scope project
+    failproofai policies --install --cli codex --scope project
+    failproofai policies --install --cli copilot --scope project
+    failproofai policies --install --cli cursor --scope project
+    failproofai policies --install --cli opencode --scope project
+    failproofai policies --install --cli pi --scope project
+    failproofai policies --install --cli hermes --scope user
+    failproofai policies --install --cli openclaw --scope user
+    failproofai policies --install --cli factory --scope project
+    failproofai policies --install --cli devin --scope project
+    failproofai policies --install --cli antigravity --scope project
+    failproofai policies --install --cli goose --scope project
+    failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
+    ```
+  </Step>
+  <Step title="אימות">
+    ```bash
+    failproofai policies
+    ```
+
+    מציג כל מדיניות, האם היא מופעלת, וכל פרמטרים שהוגדרו.
+  </Step>
+  <Step title="הפעל את לוח הבקרה">
+    ```bash
+    failproofai
+    ```
+
+    פותח לוח בקרה מקומי ב-`http://localhost:8020` שבו תוכל לדפדף בהפעלות, בדוק קריאות כלים ונהל מדיניויות.
+  </Step>
+  <Step title="הפעל את האגנט שלך">
+    התחל את Claude Code כרגיל. אם האגנט מנסה משהו מסוכן, failproofai יתקיף אותו באופן אוטומטי. השאר אותו פועל ללא השגחה ובדוק מה קרה בלוח הבקרה.
+  </Step>
+</Steps>
+
+---
+
+## איך מדיניויות פועלות
+
+בכל פעם שאגנט מפעיל כלי, Claude Code קורא ל-failproofai כתהליך משנה:
+
+```text
+Claude Code  →  failproofai --hook PreToolUse  →  קורא JSON מ-stdin
+                                                 מעריך מדיניויות
+                                                 כותב החלטה ל-stdout
+```
+
+כל מדיניות מחזירה אחת משלוש החלטות:
+
+- **allow** - האגנט ממשיך כרגיל
+- **deny** - הפעולה חסומה, האגנט מודיע למה
+- **instruct** - הוספת הקשר נוסף להנמקה של האגנט
+
+<Note>
+מדיניויות רצות בתהליך המקומי שלך. שום דבר לא נשלח לשירות מרוחק.
+</Note>
+
+---
+
+## הגדר מדיניויות צוות עם מדיניויות מבוססות קונבנציה
+
+הדרך המהירה ביותר להקמת תקנים איכות בכל הצוות שלך היא הקונבנציה `.failproofai/policies/`. הטל קבצי מדיניות לספרייה זו והם יטענו באופן אוטומטי — ללא דגלים, ללא שינויי תצורה, ללא פקודות התקנה.
+
+<Steps>
+  <Step title="צור את ספריית המדיניויות">
+    ```bash
+    mkdir -p .failproofai/policies
+    ```
+  </Step>
+  <Step title="הוסף קבצי מדיניויות">
+    העתק את דוגמאות ההתחלה או כתוב שלך:
+
+    ```bash
+    cp node_modules/failproofai/examples/convention-policies/*.mjs .failproofai/policies/
+    ```
+
+    או צור אחת חדשה:
+
+    ```js
+    // .failproofai/policies/team-policies.mjs
+    import { customPolicies, allow, deny, instruct } from "failproofai";
+
+    customPolicies.add({
+      name: "test-before-commit",
+      match: { events: ["PreToolUse"] },
+      fn: async (ctx) => {
+        if (ctx.toolName !== "Bash") return allow();
+        if (/git\s+commit/.test(ctx.toolInput?.command ?? "")) {
+          return instruct("הפעל בדיקות לפני ביצוע commit.");
+        }
+        return allow();
+      },
+    });
+    ```
+  </Step>
+  <Step title="העלה ל-git">
+    ```bash
+    git add .failproofai/policies/
+    git commit -m "הוסף מדיניויות איכות צוות"
+    ```
+
+    כל חברי צוות שיש להם failproofai מותקן לוקחים את המדיניויות הללו באופן אוטומטי. אין צורך בהגדרה נפרדת לכל מפתח.
+  </Step>
+</Steps>
+
+<Tip>
+העלה את `.failproofai/policies/` ל-repo שלך כדי שכל הצוות ישתוף את אותם תקנים. כאשר הצוות שלך גילה היבטי כשל חדשים, הוסף מדיניויות ודחוף — כולם מקבלים את העדכון בשלהם `git pull` הבא. לאורך זמן המדיניויות הללו הופכות לתקן איכות חי שממשיך להשתפר.
+</Tip>
+
+---
+
+## אחסון נתונים
+
+כל התצורה והיומנים נשארים במכונה שלך:
+
+| נתיב | מה הוא שומר |
+|------|----------------|
+| `~/.failproofai/policies/local-policies/policies-config.json` | תצורת מדיניות גלובלית |
+| `~/.failproofai/hook-activity/` | היסטוריה של ביצוע hook (JSONL מחולק) |
+| `~/.failproofai/logs/` | יומנים ניפוי באגים לשגיאות hook מותאמות |
+| `.failproofai/policies-config.json` | תצורה לכל פרויקט (committed) |
+| `.failproofai/policies-config.local.json` | חידושים אישיים (gitignored) |
+
+---
+
+## הסרה
+
+```bash
+failproofai policies --uninstall
+```
+
+מסיר ערכי hook מ-`~/.claude/settings.json`. קבצי תצורה ב-`~/.failproofai/` משמרים.
+
+---
+
+## שלבים הבאים
+
+<CardGroup cols={2}>
+
+<Card title="תצורה" icon="gear" href="/he/configuration">
+  היקפים וקבוצת תצורה
+</Card>
+
+<Card title="מדיניויות מובנות" icon="shield" href="/he/built-in-policies">
+  כל 26 המדיניויות עם פרמטרים
+</Card>
+
+<Card title="מדיניויות מותאמות" icon="code" href="/he/custom-policies">
+  כתוב את המדיניויות שלך ב-JavaScript
+</Card>
+
+<Card title="צג אגנט" icon="chart-line" href="/he/dashboard">
+  עקוב אחר הפעלות וביקורת פעילות מדיניויות
+</Card>
+
+</CardGroup>

package/.next/standalone/docs-old/he/introduction.mdx

@@ -0,0 +1,58 @@
+---
+---
+title: "Failproof AI"
+description: "FailproofAI מספקת לסוכני AI 39 מדיניויות כישל מובנות שתופסות לולאות, דליפות סודות, קריאות כלי הרסניות ועוד בהתקנה אחת."
+---
+
+[![npm weekly downloads](https://img.shields.io/npm/dw/failproofai?style=flat-square&color=2ea44f)](https://www.npmjs.com/package/failproofai)
+
+ווקים ומדיניויות ל**טיפול בכישלונות AI**, **התאוששות מ-שגיאות**, ו**אמינות LLM**. שמור על סוכני AI שלך אמינים וריצה אוטונומית ב**Claude Code**, **OpenAI Codex**, **GitHub Copilot**, **Cursor Agent**, **OpenCode**, **Pi**, **Hermes**, **OpenClaw**, **Factory Droid**, **Devin CLI**, **Antigravity CLI**, ו**Agents SDK**.
+
+סוכני AI כושלים בדרכים צפויות. הם מריצים פקודות הרסניות, מדליפים סודות, סוטים מהמשימה, נתקעים בלולאות, או דוחפים ישירות ל-main. אם משאירים זאת ללא פיקוח, כישלונות קטנים עלולים להיות לתאונות קטסטרופליות, דליפות אישורים עבודה, ואובדן עבודה.
+
+FailproofAI פותרת זאת באמצעות **מדיניויות**. כללים אלו משתלבים בכל קריאת כלי סוכן כדי **לגלות כישלונות**, **להפחית אותם** (לחסום, להנחות, לנקות), ו**להתריע עליך** כאשר משהו זקוק לתשומת לב. לוח מחוונים מקומי מאפשר לך לעיין בכל קריאת כלי, כישלון סוכן ופעולת התאוששות לאחר מכן.
+
+תמליל וה-evaluation של מדיניות נשארים במחשב שלך. נתונים נשלחים רק כאשר אתה משתמש באופן מפורש בתכונה מקוונת, כגון תזכורות ביקורת מאומתות או הזמנות.
+
+## התחלה מהירה
+
+<CardGroup cols={2}>
+
+<Card title="39 מדיניויות מובנות" icon="shield" href="/he/built-in-policies">
+  חסום פקודות הרסניות, מנע דליפות סודות, שמור על סוכנים בתוך גבולות הפרויקט, ועוד. הכל מתוך הקופסה.
+</Card>
+
+<Card title="מדיניויות מותאמות אישית" icon="code" href="/he/custom-policies">
+  כתוב כללים משלך ב-JavaScript באמצעות API פשוט של allow / deny / instruct.
+</Card>
+
+<Card title="Agent monitor" icon="chart-line" href="/he/dashboard">
+  ראה מה סוכניך עשו כשלא היית שם. עיין בסשנים, בדוק קריאות כלים, סקור היכן מדיניויות הופעלו.
+</Card>
+
+<Card title="קונפיגורציה קלה" icon="gear" href="/he/configuration">
+  כייל כל מדיניות ללא קוד. הגדר allowlists, ענפים מוגנים, או ערכי סף לכל-פרויקט או בעולם.
+</Card>
+
+</CardGroup>
+
+## התחלה מהירה
+
+<CodeGroup>
+
+```bash npm
+npm install -g failproofai
+```
+
+```bash bun
+bun add -g failproofai
+```
+
+</CodeGroup>
+
+```bash
+failproofai policies --install   # enable policies (or skip — `failproofai` will offer to set them up on first run)
+failproofai                      # launch the dashboard
+```
+
+ראה את [Starting](/he/getting-started) guide להסבר המלא.

package/.next/standalone/docs-old/he/package-aliases.mdx

@@ -0,0 +1,82 @@
+---
+title: כנויים של חבילה
+description: "כנויים למניעת טעויות הקלדה רשומים וכיצד הם פועלים"
+icon: copy
+---
+
+## החבילה הרשמית
+
+החבילה npm קנונית היא **`failproofai`**:
+
+```bash
+npm install -g failproofai
+# or
+bun add -g failproofai
+```
+
+---
+
+## למה אנחנו בעלים של שמות הכנויים
+
+Typosquatting היא התקפת שרשרת אספקה נפוצה שבה שחקן זדוני רושם שם חבילה שנמצא במרחק הקשה אחת מחבילה פופולרית. משתמשים שלא מודעים שטעו בהקלדת פקודת ההתקנה בסופו של דבר מריצים קוד הנשלט על ידי התוקף עם גישה מלאה למערכת - בדיוק סוג האיום שFailproof AI תוכנן להגן עליו.
+
+כדי לבטל את פני השטח הזה, **אנחנו בעלים לפעוט של כל האיות השגויים והגרסאות העיצוביות הנפוצות** של `failproofai` ב-npm. שום אחד מהשמות הללו לא יכול להיות רשום על ידי צד שלישי. כל אחד מהם הוא פרוקסי דק המתקין ומוקד את החבילה האמיתית `failproofai`.
+
+---
+
+## כנויים רשומים
+
+**גרסאות עיצוביות** - דרכים שונות לכתוב "failproof ai":
+
+| חבילה | סטטוס |
+|---------|--------|
+| `failproof` | ✅ פורסם |
+| `failproof-ai` | ⏳ ממתין לתמיכת npm |
+| `fail-proof-ai` | ⏳ ממתין לתמיכת npm |
+| `failproof_ai` | ⏳ ממתין לתמיכת npm |
+| `fail_proof_ai` | ⏳ ממתין לתמיכת npm |
+| `fail-proofai` | ⏳ ממתין לתמיכת npm |
+
+**טעויות `failprof*`** - חסר o אחד מ-"proof":
+
+| חבילה | סטטוס |
+|---------|--------|
+| `failprof` | ✅ פורסם |
+| `failprof-ai` | ✅ פורסם |
+| `failprofai` | ⏳ ממתין לתמיכת npm |
+| `fail-prof-ai` | ⏳ ממתין לתמיכת npm |
+| `failprof_ai` | ⏳ ממתין לתמיכת npm |
+
+**טעויות `faliproof*`** - a ו-i בעמדה הפוכה:
+
+| חבילה | סטטוס |
+|---------|--------|
+| `faliproof` | ✅ פורסם |
+| `faliproof-ai` | ✅ פורסם |
+| `faliproofai` | ⏳ ממתין לתמיכת npm |
+
+> **למה ממתין?** מדיניות מניעת הספאם של npm חוסמת שמות שמנורמלים לאותו מחרוזת כחבילה קיימת לאחר הסרת פיסוק וביצוע בדיקות דמיון. יצרנו קשר עם תמיכת npm כדי להזמין שמות אלה למטרות אנטי-טיפוס. הם יופעלו לאחר אישור.
+
+ניתן לאמת שכל כינוי שפורסם הוא בבעלותנו:
+
+```bash
+npm info failproof
+# חפש: "ExosphereHost Inc." בשדה ה-maintainers
+```
+
+---
+
+## איך הכנויים פועלים
+
+כל חבילת כינוי:
+
+1. רשום את `failproofai` כתלות - אז החבילה האמיתית מותקנת והקובץ הבינארי שלה זמין
+2. חושף קובץ בינארי התואם לשם שלו (למשל `failprof-ai`) שמעביר את כל הארגומנטים לקובץ `failproofai` הבינארי
+
+הפרוקסי הוא סקריפט Node דו-שורתי; אין לוגיקה, אין קריאות רשת, ואין איסוף נתונים מעבר למה ש-`failproofai` עצמו עושה.
+
+---
+
+## אם מצאת שם שהחמצנו
+
+פתח בעיה ב-[failproofai/failproofai](https://github.com/failproofai/failproofai/issues) ואנחנו נרשום אותו.

package/.next/standalone/docs-old/he/testing.mdx

@@ -0,0 +1,260 @@
+---
+title: בדיקות
+description: "בדיקות יחידה, בדיקות end-to-end וכלי עזר לבדיקות"
+icon: flask-vial
+---
+
+failproofai כולל שני חבילות בדיקות: **בדיקות יחידה** (מהירות, ממדומות) ו**בדיקות end-to-end** (הפעלות subprocess אמיתיות).
+
+---
+
+## הרצת בדיקות
+
+```bash
+# הרץ את כל בדיקות היחידה פעם אחת
+bun run test:run
+
+# הרץ בדיקות יחידה במצב צפייה
+bun run test
+
+# הרץ בדיקות E2E (דורש התקנה - ראה למטה)
+bun run test:e2e
+
+# בדוק סוגים ללא בנייה
+bunx tsc --noEmit
+
+# Lint
+bun run lint
+```
+
+---
+
+## בדיקות יחידה
+
+בדיקות היחידה נמצאות ב-`__tests__/` ומשתמשות ב-[Vitest](https://vitest.dev) עם `jsdom`.
+
+```text
+__tests__/
+  hooks/
+    builtin-policies.test.ts      # Logic מדיניות לכל builtin
+    hooks-config.test.ts          # טעינת config ומיזוג scope
+    policy-evaluator.test.ts      # זריקת Param וסדר הערכה
+    custom-hooks-registry.test.ts # globalThis registry add/get/clear
+    custom-hooks-loader.test.ts   # ESM loader, imports transiently, handling errors
+    manager.test.ts               # פעולות install/remove/list
+  components/
+    sessions-list.test.tsx        # רכיב רשימת Session
+    project-list.test.tsx         # רכיב רשימת Project
+    ...
+  lib/
+    logger.test.ts
+    paths.test.ts
+    date-filters.test.ts
+    telemetry.test.ts
+    ...
+  actions/
+    get-hooks-config.test.ts
+    get-hook-activity.test.ts
+    ...
+  contexts/
+    ThemeContext.test.tsx
+    AutoRefreshContext.test.tsx
+```
+
+### כתיבת בדיקת יחידה למדיניות
+
+```typescript
+import { describe, it, expect, beforeEach } from "vitest";
+import { getBuiltinPolicies } from "../../src/hooks/builtin-policies";
+import { allow, deny } from "../../src/hooks/policy-types";
+
+describe("block-sudo", () => {
+  const policy = getBuiltinPolicies().find((p) => p.name === "block-sudo")!;
+
+  it("denies sudo commands", () => {
+    const ctx = {
+      eventType: "PreToolUse" as const,
+      payload: {},
+      toolName: "Bash",
+      toolInput: { command: "sudo apt install nodejs" },
+      params: { allowPatterns: [] },
+    };
+    expect(policy.fn(ctx)).toEqual(deny("sudo command blocked by failproofai"));
+  });
+
+  it("allows non-sudo commands", () => {
+    const ctx = {
+      eventType: "PreToolUse" as const,
+      payload: {},
+      toolName: "Bash",
+      toolInput: { command: "ls -la" },
+      params: { allowPatterns: [] },
+    };
+    expect(policy.fn(ctx)).toEqual(allow());
+  });
+
+  it("allows patterns in allowPatterns", () => {
+    const ctx = {
+      eventType: "PreToolUse" as const,
+      payload: {},
+      toolName: "Bash",
+      toolInput: { command: "sudo systemctl status nginx" },
+      params: { allowPatterns: ["sudo systemctl status"] },
+    };
+    expect(policy.fn(ctx)).toEqual(allow());
+  });
+});
+```
+
+---
+
+## בדיקות end-to-end
+
+בדיקות E2E משדרות את ה-binary של failproofai כـ subprocess אמיתי, משדרות payload JSON ל-stdin, וקובעות תשובה על פלט stdout וקוד יציאה. זה בודק את הנתיב המשולב המלא שבו Claude Code משתמש.
+
+### התקנה
+
+בדיקות E2E מריצות את ה-binary ישירות מהמקור של המאגר. לפני ההרצה הראשונה, בנה את ה-CJS bundle שקבצי hook מותאמים משתמשים כשהם מייבאים מ-`'failproofai'`:
+
+```bash
+bun build src/index.ts --outdir dist --target node --format cjs
+```
+
+אז הרץ את הבדיקות:
+
+```bash
+bun run test:e2e
+```
+
+בנה מחדש את `dist/` כל פעם שאתה משנה את ה-public hook API (`src/hooks/custom-hooks-registry.ts`, `src/hooks/policy-helpers.ts`, או `src/hooks/policy-types.ts`).
+
+### מבנה בדיקת E2E
+
+```text
+__tests__/e2e/
+  helpers/
+    hook-runner.ts      # משדר את ה-binary, משדר payload JSON, לוקח exit code + stdout + stderr
+    fixture-env.ts      # תיקיות זמניות מבודדות לכל בדיקה עם קבצי config
+    payloads.ts         # מפעלות payload בעלות דיוק Claude לכל סוג event
+  hooks/
+    builtin-policies.e2e.test.ts   # כל builtin policy עם subprocess אמיתי
+    custom-hooks.e2e.test.ts       # טעינת custom hook והערכה
+    config-scopes.e2e.test.ts      # מיזוג config בחזה project/local/global
+    policy-params.e2e.test.ts      # זריקת Parameter לכל מדיניות parameterized
+```
+
+### שימוש בעזרי E2E
+
+**`FixtureEnv`** - סביבה מבודדת לכל בדיקה:
+
+```typescript
+import { createFixtureEnv } from "../helpers/fixture-env";
+
+const env = createFixtureEnv();
+// env.cwd    - תיקייה זמנית; תמסור כ-payload.cwd כדי לאסוף את .failproofai/policies-config.json
+// env.home   - isolated home dir; לא נוצרים דלפים של ~/.failproofai בפועל
+
+env.writeConfig({
+  enabledPolicies: ["block-sudo"],
+  policyParams: {
+    "block-sudo": { allowPatterns: ["sudo systemctl status"] },
+  },
+});
+```
+
+`createFixtureEnv()` רושם `afterEach` cleanup באופן אוטומטי.
+
+**`runHook`** - משדר את ה-binary:
+
+```typescript
+import { runHook } from "../helpers/hook-runner";
+import { Payloads } from "../helpers/payloads";
+
+const result = await runHook(
+  "PreToolUse",
+  Payloads.preToolUse.bash("sudo apt install nodejs", env.cwd),
+  { homeDir: env.home }
+);
+
+expect(result.exitCode).toBe(0);
+expect(result.parsed?.hookSpecificOutput?.permissionDecision).toBe("deny");
+```
+
+**`Payloads`** - מפעלות payload מוכנות:
+
+```typescript
+Payloads.preToolUse.bash(command, cwd)
+Payloads.preToolUse.write(filePath, content, cwd)
+Payloads.preToolUse.read(filePath, cwd)
+Payloads.postToolUse.bash(command, output, cwd)
+Payloads.postToolUse.read(filePath, content, cwd)
+Payloads.notification(message, cwd)
+Payloads.stop(cwd)
+```
+
+### כתיבת בדיקת E2E
+
+```typescript
+import { describe, it, expect } from "vitest";
+import { createFixtureEnv } from "../helpers/fixture-env";
+import { runHook } from "../helpers/hook-runner";
+import { Payloads } from "../helpers/payloads";
+
+describe("block-rm-rf (E2E)", () => {
+  it("denies rm -rf", async () => {
+    const env = createFixtureEnv();
+    env.writeConfig({ enabledPolicies: ["block-rm-rf"] });
+
+    const result = await runHook(
+      "PreToolUse",
+      Payloads.preToolUse.bash("rm -rf /", env.cwd),
+      { homeDir: env.home }
+    );
+
+    expect(result.exitCode).toBe(0);
+    expect(result.parsed?.hookSpecificOutput?.permissionDecision).toBe("deny");
+  });
+
+  it("allows non-recursive rm", async () => {
+    const env = createFixtureEnv();
+    env.writeConfig({ enabledPolicies: ["block-rm-rf"] });
+
+    const result = await runHook(
+      "PreToolUse",
+      Payloads.preToolUse.bash("rm /tmp/file.txt", env.cwd),
+      { homeDir: env.home }
+    );
+
+    expect(result.exitCode).toBe(0);
+    expect(result.stdout).toBe("");  // allow → empty stdout
+  });
+});
+```
+
+### צורות תשובה של E2E
+
+| החלטה | קוד יציאה | stdout |
+|----------|-----------|--------|
+| `PreToolUse` deny | `0` | `{"hookSpecificOutput":{"permissionDecision":"deny","permissionDecisionReason":"..."}}` |
+| `PostToolUse` deny | `0` | `{"hookSpecificOutput":{"additionalContext":"Blocked ... because: ..."}}` |
+| Instruct (non-Stop) | `0` | `{"hookSpecificOutput":{"additionalContext":"Instruction from failproofai: ..."}}` |
+| Stop instruct | `2` | empty stdout; reason in stderr |
+| Allow | `0` | empty string |
+
+### תצורת Vitest
+
+בדיקות E2E משתמשות ב-`vitest.config.e2e.mts` עם:
+
+- `environment: "node"` - לא דרושים browser globals
+- `pool: "forks"` - process isolation אמיתי (בדיקות משדרות subprocesses)
+- `testTimeout: 20_000` - 20 שניות לכל בדיקה (binary startup + hook eval)
+
+ה-`forks` pool חשוב: עובדים המבוססים על thread משתפים `globalThis`, דבר שעלול להתערב בבדיקות המשדרות subprocess. process-based forks חוסכים זאת.
+
+---
+
+## CI
+
+ההרצה המלאה של CI (`bun run lint && bunx tsc --noEmit && bun run test:run && bun run build`) נדרשת כדי להצליח לפני merge. חבילת E2E חוברת כעבודת CI נפרדת במקביל.
+
+ראה [Contributing](../CONTRIBUTING.md) לקבלת רשימת ה-checklist המלאה לפני merge.