failproofai 0.0.2 → 0.0.3

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

@@ -0,0 +1,253 @@
+---
+title: דוגמאות
+description: "כיצד להגדיר hooks עבור Claude Code ו-Agents SDK"
+icon: book-open
+---
+
+דוגמאות מוכנות לשימוש עבור תרחישים נפוצים. כל אחת מהן מציגה כיצד להתקין ומה לצפות.
+
+---
+
+## הגדרת hooks עבור Claude Code
+
+Failproof AI משתלב עם Claude Code דרך [מערכת ה-hooks](https://docs.anthropic.com/en/docs/claude-code/hooks) שלו. כאשר אתה מריץ `failproofai policies --install`, הוא רושם פקודות hook בקובץ `settings.json` של Claude Code שמופעלות בכל קריאת כלי.
+
+<Steps>
+  <Step title="התקן את failproofai">
+    ```bash
+    npm install -g failproofai
+    ```
+  </Step>
+  <Step title="הפוך את כל המדיניות המובנית לזמינה">
+    ```bash
+    failproofai policies --install
+    ```
+  </Step>
+  <Step title="וודא שה-hooks רשומים">
+    ```bash
+    cat ~/.claude/settings.json | grep failproofai
+    ```
+
+    אתה אמור לראות ערכי hook עבור אירועי `PreToolUse`, `PostToolUse`, `Notification`, ו-`Stop`.
+  </Step>
+  <Step title="הרץ את Claude Code">
+    ```bash
+    claude
+    ```
+
+    המדיניות פועלת כעת באופן אוטומטי בכל קריאת כלי. נסה לבקש מ-Claude להריץ `sudo rm -rf /` - זה יחסום.
+  </Step>
+</Steps>
+
+---
+
+## הגדרת hooks עבור Agents SDK
+
+אם אתה בונה עם [Agents SDK](https://docs.anthropic.com/en/docs/agents-sdk), אתה יכול להשתמש באותה מערכת hooks בצורה תכנותית.
+
+<Steps>
+  <Step title="התקן את failproofai בפרויקט שלך">
+    ```bash
+    npm install failproofai
+    ```
+  </Step>
+  <Step title="הגדר hooks ב-agent שלך">
+    העבר פקודות hook בעת יצירת תהליך ה-agent שלך. ה-hooks פועלים באותו אופן כמו ב-Claude Code - דרך JSON של stdin/stdout:
+
+    ```bash
+    failproofai --hook PreToolUse   # called before each tool
+    failproofai --hook PostToolUse  # called after each tool
+    ```
+  </Step>
+  <Step title="כתוב מדיניות מותאמת אישית עבור ה-agent שלך">
+    ```javascript
+    import { customPolicies, allow, deny } from "failproofai";
+
+    customPolicies.add({
+      name: "limit-to-project-dir",
+      description: "Keep the agent inside the project directory",
+      match: { events: ["PreToolUse"] },
+      fn: async (ctx) => {
+        const path = String(ctx.toolInput?.file_path ?? "");
+        if (path.startsWith("/") && !path.startsWith(ctx.session?.cwd ?? "")) {
+          return deny("Agent is restricted to the project directory");
+        }
+        return allow();
+      },
+    });
+    ```
+  </Step>
+  <Step title="התקן את המדיניות המותאמת אישית">
+    ```bash
+    failproofai policies --install --custom ./my-agent-policies.js
+    ```
+  </Step>
+</Steps>
+
+---
+
+## חסום פקודות הרסניות
+
+ההגדרה הנפוצה ביותר - מנע מ-agents לפעול בנזק בלתי הפיך.
+
+```bash
+failproofai policies --install block-sudo block-rm-rf block-force-push block-curl-pipe-sh
+```
+
+מה זה עושה:
+- `block-sudo` - חוסם את כל פקודות `sudo`
+- `block-rm-rf` - חוסם מחיקת קובץ רקורסיבית
+- `block-force-push` - חוסם `git push --force`
+- `block-curl-pipe-sh` - חוסם צנרת של סקריפטים מרחוקים לשל
+
+---
+
+## מנע דליפת סודות
+
+עצור agents מלראות או לדלוף אישורים בפלט הכלי.
+
+```bash
+failproofai policies --install sanitize-api-keys sanitize-jwt sanitize-connection-strings sanitize-bearer-tokens
+```
+
+אלה פועלים על `PostToolUse` - לאחר הרצת כלי, הם מנקים את הפלט לפני שה-agent רואה זאת.
+
+---
+
+## קבל התראות Slack כאשר agents צריכים תשומת לב
+
+השתמש בה-notification hook כדי להעביר התראות במצב חמלה ל-Slack.
+
+```javascript
+import { customPolicies, allow, instruct } from "failproofai";
+
+customPolicies.add({
+  name: "slack-on-idle",
+  description: "Alert Slack when the agent is waiting for input",
+  match: { events: ["Notification"] },
+  fn: async (ctx) => {
+    const webhookUrl = process.env.SLACK_WEBHOOK_URL;
+    if (!webhookUrl) return allow();
+
+    const message = String(ctx.payload?.message ?? "Agent is waiting");
+    const project = ctx.session?.cwd ?? "unknown";
+
+    try {
+      await fetch(webhookUrl, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          text: `*${message}*\nProject: \`${project}\``,
+        }),
+        signal: AbortSignal.timeout(5000),
+      });
+    } catch {
+      // never block the agent if Slack is unreachable
+    }
+
+    return allow();
+  },
+});
+```
+
+התקן אותו:
+
+```bash
+SLACK_WEBHOOK_URL=https://hooks.slack.com/... failproofai policies --install --custom ./slack-alerts.js
+```
+
+---
+
+## שמור agents בענף
+
+מנע מ-agents להחליף ענפים או לדחוף לענפים מוגנים.
+
+```javascript
+import { customPolicies, allow, deny } from "failproofai";
+
+customPolicies.add({
+  name: "stay-on-branch",
+  description: "Prevent the agent from checking out other branches",
+  match: { events: ["PreToolUse"] },
+  fn: async (ctx) => {
+    if (ctx.toolName !== "Bash") return allow();
+    const cmd = String(ctx.toolInput?.command ?? "");
+    if (/git\s+checkout\s+(?!-b)/.test(cmd)) {
+      return deny("Stay on the current branch. Create a new branch with -b if needed.");
+    }
+    return allow();
+  },
+});
+```
+
+---
+
+## דרוש בדיקות לפני commits
+
+הזכר ל-agents להריץ בדיקות לפני commit.
+
+```javascript
+import { customPolicies, allow, instruct } from "failproofai";
+
+customPolicies.add({
+  name: "test-before-commit",
+  description: "Remind the agent to run tests before committing",
+  match: { events: ["PreToolUse"] },
+  fn: async (ctx) => {
+    if (ctx.toolName !== "Bash") return allow();
+    const cmd = String(ctx.toolInput?.command ?? "");
+    if (/git\s+commit/.test(cmd)) {
+      return instruct("Run tests before committing. Use `npm test` or `bun test` first.");
+    }
+    return allow();
+  },
+});
+```
+
+---
+
+## נעל ריפוזיטוריום ייצור
+
+בצע commit לקונפיג ברמת פרויקט כדי שלכל מפתח בצוות שלך תהיה אותה מדיניות.
+
+צור `.failproofai/policies-config.json` בריפוזיטוריום שלך:
+
+```json
+{
+  "enabledPolicies": [
+    "block-sudo",
+    "block-rm-rf",
+    "block-force-push",
+    "block-push-master",
+    "block-env-files",
+    "sanitize-api-keys",
+    "sanitize-jwt"
+  ],
+  "policyParams": {
+    "block-push-master": {
+      "protectedBranches": ["main", "release", "production"]
+    }
+  }
+}
+```
+
+לאחר מכן בצע commit:
+
+```bash
+git add .failproofai/policies-config.json
+git commit -m "Add failproofai team policies"
+```
+
+כל חברי הצוות שיש להם failproofai מותקן יבחרו באופן אוטומטי את הכללים הללו.
+
+---
+
+## דוגמאות נוספות
+
+תיקיית [`examples/`](https://github.com/exospherehost/failproofai/tree/main/examples) בריפוזיטוריום מכילה:
+
+| קובץ | מה הוא מציג |
+|------|---------------|
+| `policies-basic.js` | מדיניות התחלתית - חסום כתיבה בייצור, force-push, סקריפטים צנורים |
+| `policies-notification.js` | התראות Slack עבור התראות במצב חמלה וסיום הפעילות |
+| `policies-advanced/index.js` | יבוא טרנזיטיבי, hooks אסינכרונים, ניקוי פלט PostToolUse, טיפול באירוע Stop |

package/.next/standalone/docs/he/for-agents.mdx

@@ -0,0 +1,38 @@
+---
+title: "עבור agents"
+description: "הוסף ידע של Failproof AI לאגנט הקידוד שלך בפקודה אחת. עובד עם Claude Code, Cursor, Windsurf ועוד."
+---
+
+הוסף את ההתייחסות המלאה של Failproof AI לאגנט הקידוד שלך בפקודה אחת. עובד עם Claude Code, Cursor, Windsurf וכל אגנט אחר התומך ב-skills.
+
+```bash
+npx skills add https://docs.befailproof.ai
+```
+
+`npx skills` מגלה איזה אגנטים מותקנים אצלך ומוסיף את ה-skill בפורמט הנכון לכל אחד באופן אוטומטי.
+
+## מה הממוצע של ה-skill
+
+| אזור | מה כלול |
+|------|----------------|
+| Policies | שמות policy מובנים, סוגי אירועים, פרמטרים, הפעלה/השבתה |
+| Custom policies | `customPolicies.add()`, מסננים התאמה, API `allow`/`deny`/`instruct` |
+| Context object | `ctx.eventType`, `ctx.toolName`, `ctx.toolInput`, `ctx.session` |
+| Configuration | מבנה `policies-config.json`, מיזוג scope, `policyParams` |
+| CLI | `failproofai policies --install`, `--uninstall`, `--custom`, scopes |
+| Dashboard | מציג הפעילות, פעילות policy, משתנים סביבה |
+| Architecture | זרימת hook handler, קודי יציאה, חוזה stdin/stdout |
+
+## האם ה-skill שלם?
+
+Mintlify יוצר `llms.txt` מכל הדפים בניווט. תיעוד Failproof AI מכסה את ה-API המלא - כל policy, אפשרות וכל דוגמה כלולים. אם אתה מוצא משהו חסר, המקור נמצא בכתובת `https://docs.befailproof.ai/llms-full.txt`.
+
+עבור הקשר ממוקד, קשר ישירות לדף ספציפי:
+
+```bash
+# רק ה-API של custom policies
+npx skills add https://docs.befailproof.ai/custom-policies
+
+# רק ה-built-in policies
+npx skills add https://docs.befailproof.ai/built-in-policies
+```

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

@@ -0,0 +1,135 @@
+---
+---
+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 ל-`settings.json` של Claude Code. אתה יכול גם להתקין עבור פרויקט יחיד או לבחור מדיניויות ספציפיות:
+
+    ```bash
+    failproofai policies --install --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-config.json` | תצורת מדיניות גלובלית |
+| `~/.failproofai/hook-activity.jsonl` | היסטוריית הוכן |
+| `~/.failproofai/hook.log` | יומן ניפוי עבור שגיאות hook מותאמות |
+| `.failproofai/policies-config.json` | תצורה לכל-פרויקט (מחויבת) |
+| `.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/he/introduction.mdx

@@ -0,0 +1,57 @@
+---
+title:  Failproof AI
+description: "ניהול hooks ו-policies המשמרים את סוכני ה-AI שלך אמינים ופועלים באופן אוטונומי"
+---
+
+[![npm weekly downloads](https://img.shields.io/npm/dw/failproofai?style=flat-square&color=2ea44f)](https://www.npmjs.com/package/failproofai)
+
+Hooks ו-policies המשמרים את סוכני ה-AI שלך אמינים ופועלים באופן אוטונומי - עבור **Claude Code** וה-**Agents SDK**.
+
+סוכני AI נכשלים בדרכים צפויות. הם מפעילים פקודות הרסניות, משחררים סודות, סוטים מהמשימה, נתקעים בלולאות, או דוחפים ישירות ל-main. אם מושאר ללא השגחה, כשלים קטנים גדלים בהשפעה.
+
+Failproof AI פותר זאת באמצעות **policies** - כללים המתחברים לכל קריאת כלי של סוכן ויכולים **לזהות כשלים**, **למתן אותם** (חסימה, הוראה, ניקוי), ו**להתריע** כשדברים דורשים תשומת לב. לוח מחוונים מקומי מאפשר לך לבדוק הכל לאחר מכן.
+
+הכל פועל באופן מקומי. אף נתון לא עוזב את המכונה שלך.
+
+## בואו נתחיל
+
+<CardGroup cols={2}>
+
+<Card title="26 policies מובנות" icon="shield" href="/he/built-in-policies">
+  חסום פקודות הרסניות, מנע שליפת סודות, שמור על סוכנים בתוך גבולות פרויקט, ועוד - מחוץ לקופסה.
+</Card>
+
+<Card title="Custom policies" icon="code" href="/he/custom-policies">
+  כתוב כללים משלך ב-JavaScript עם ממשק allow / deny / instruct פשוט.
+</Card>
+
+<Card title="Agent monitor" icon="chart-line" href="/he/dashboard">
+  ראה מה עשו סוכניך כשהיית רחוק. עיין בסשנים, בדוק קריאות כלים, סקור היכן policies הופעלו.
+</Card>
+
+<Card title="קונפיגורציה קלה" icon="gear" href="/he/configuration">
+  כוונן כל policy ללא קוד. הגדר allowlists, ענפים מוגנים, או ערכי סף לפי פרויקט או באופן גלובלי.
+</Card>
+
+</CardGroup>
+
+## התחלה מהירה
+
+<CodeGroup>
+
+```bash npm
+npm install -g failproofai
+```
+
+```bash bun
+bun add -g failproofai
+```
+
+</CodeGroup>
+
+```bash
+failproofai policies --install   # enable policies
+failproofai                      # launch the dashboard
+```
+
+ראה את הדרכת [בואו נתחיל](/he/getting-started) לעיון מלא.

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

@@ -0,0 +1,82 @@
+---
+title: כינויי חבילה
+description: "כינויים שנרשמו למניעת typosquat וכיצד הם פועלים"
+icon: copy
+---
+
+## החבילה הרשמית
+
+החבילה npm הקנונית היא **`failproofai`**:
+
+```bash
+npm install -g failproofai
+# או
+bun add -g failproofai
+```
+
+---
+
+## למה אנחנו בעלים של שמות הכינויים
+
+Typosquatting הוא התקפת שרשרת אספקה נפוצה שבה פעיל זדוני רושם שם חבילה שנמצא במרחק של לחיצת מקש אחת מחבילה פופולרית. משתמשים שלא משגיחים שטעו בהקלדת פקודת ההתקנה בסופו של דבר מריצים קוד שנשלט על ידי התוקף עם גישה מלאה למערכת - בדיוק סוג איום שFailproof AI מעוצב להגן עליו.
+
+כדי למחוק את הפן הזה, **אנחנו בעלים קדום של כל הטעויות הנפוצות וגרסאות פורמט של `failproofai` ב-npm**. לא ניתן לרשום אף אחד משמות אלה על ידי צד שלישי. כל אחד מהם הוא proxy דק שמתקין ומעביר ל-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 |
+
+> **למה בהמתנה?** מדיניות מניעת spam של npm חוסמת שמות שמנורמלים לאותו מחרוזת כחבילה קיימת לאחר הסרת פונקטואציה וביצוע בדיקות דמיון. היינו בקשר עם תמיכת npm כדי להזמין שמות אלה למטרות anti-squatting. הם יופעלו לאחר אישור.
+
+אתה יכול לאמת שכל כינוי פורסם הוא בעלות שלנו:
+
+```bash
+npm info failproof
+# חפש: "ExosphereHost Inc." בשדה המתחזקים
+```
+
+---
+
+## כיצד הכינויים עובדים
+
+כל חבילת כינוי:
+
+1. מציינת את `failproofai` כתלות - כך החבילה האמיתית (כולל הגדרת ה-hook של `postinstall` שלה) רצה בהתקנה
+2. חושפת binary התואם לשמה שלה (למשל `failproof-ai`) שמעביר את כל הארגומנטים ל-binary של `failproofai`
+
+ה-proxy הוא סקריפט Node בשתי שורות; אין לוגיקה, אין קריאות רשת, ואין אוספי נתונים מעבר לאלה שעושה `failproofai` עצמו.
+
+---
+
+## אם מצאת שם שחייבנו
+
+פתח issue ב-[exospherehost/failproofai](https://github.com/exospherehost/failproofai/issues) ואנחנו נרשום אותו.