failproofai 0.0.2 → 0.0.4-beta.0

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

@@ -0,0 +1,142 @@
+---
+title: לוח בקרה
+description: "ניטור סשנים של סוכנים, בדיקת קריאות כלים וניהול מדיניות"
+icon: chart-line
+---
+
+לוח הבקרה של failproofai היא אפליקציית ווב מקומית לניטור סשנים של סוכנים AI שלך וניהול מדיניות. ראה מה עשו הסוכנים שלך בזמן שלא היית.
+
+---
+
+## הפעלת לוח הבקרה
+
+```bash
+failproofai
+```
+
+נפתח ב-`http://localhost:8020`.
+
+לוח הבקרה קורא ישירות מקובץ המערכת - תיקיות פרויקטי Claude Code שלך וקבצי הקונפיגורציה של failproofai. לא נכתב כלום לשירות מרחוק.
+
+---
+
+## עמודים
+
+### Projects
+
+מוצג רשימה של כל פרויקטי Claude Code שנמצאו במכונה שלך. פרויקטים מגוקלים מ-`~/.claude/projects/` (או הנתיב שהוגדר על ידי `CLAUDE_PROJECTS_PATH`).
+
+כל פרויקט מוצג עם:
+- שם הפרויקט (נגזר מנתיב התיקייה)
+- מספר סשנים
+- תאריך של פעילות הסשן הקודם
+
+לחץ על פרויקט כדי לראות את הסשנים שלו.
+
+### Sessions
+
+מוצג רשימה של כל הסשנים בתוך פרויקט. כל סשן מוצג עם:
+- מזהה סשן
+- חותמות זמן של התחלה וסיום
+- מספר קריאות כלים
+- ספירת פעילות hook (מדיניות שהופעלו)
+
+השתמש בסינון טווח התאריכים וחיפוש מזהה סשן כדי לצמצם את הרשימה. סשנים מחולקים לעמודים.
+
+לחץ על סשן כדי לפתוח את מציג הסשן.
+
+### Session viewer
+
+מציג הסשן עונה על השאלה המרכזית עבור סוכנים עצמאיים: מה עשה הסוכן, והאם הוא נשאר בנתיב? הוא מוצג בציר הזמן של כל מה שקרה בסשן:
+
+- **Messages** - תגובות הטקסט של Claude והנושאים של המשתמש
+- **Tool calls** - כל כלי שClaude הפעיל, עם הקלט והפלט שלו
+- **Policy activity** - לכל קריאת כלים, איזו מדיניות הופעלה ואיזה החלטה היא החזירה
+
+פס הסטטיסטיקה בחלק העליון מציג משך הסשן, סה"כ קריאות כלים וסיכום של החלטות hook (מספרי allow / deny / instruct).
+
+אתה יכול לייצא את הסשן כקובץ ZIP או JSONL באמצעות כפתור ההורדה.
+
+### Policies
+
+עמוד דו-לשוני לניהול מדיניות ובדיקת פעילות.
+
+<Tabs>
+  <Tab title="Policies tab">
+  - הפוך מדיניות בודדות או כבויה בלחיצה יחידה (כותב ל-`~/.failproofai/policies-config.json`)
+  - הרחב מדיניות כדי להגדיר את הפרמטרים שלה (עבור מדיניות התומכת ב-`policyParams`)
+  - התקן או הסר hook עבור scope מסוים
+  - הגדר נתיב קובץ מדיניות מותאם אישית
+  </Tab>
+  <Tab title="Activity tab">
+  - היסטוריה מחולקת לעמודים מלאה של כל אירוע hook שהופעל על פני כל הסשנים
+  - חיפוש לפי שם מדיניות, מזהה סשן, שם כלי או החלטה
+  - כל שורה מציגה: חותמת זמן, שם מדיניות, החלטה, שם כלי, מזהה סשן והסיבה להחלטות deny/instruct
+  </Tab>
+</Tabs>
+
+---
+
+## רענון אוטומטי
+
+לוח הבקרה יש כפתור רענון אוטומטי בניווט העליון. כאשר הוא מופעל, הדף הנוכחי מרענן בתדירות קבועה כדי להציג סשנים חדשים ופעילות מדיניות כפי שהם מופיעים. חיוני לניטור סשנים של סוכן עצמאי שרץ לפי זמן.
+
+---
+
+## השבתת עמודים
+
+אם אתה צריך רק חלקים מסוימים של לוח הבקרה, הגדר את `FAILPROOFAI_DISABLE_PAGES` לרשימה מופרדת בפסיקים של שמות עמודים:
+
+```bash
+FAILPROOFAI_DISABLE_PAGES=policies failproofai
+```
+
+ערכים חוקיים: `policies`, `projects`.
+
+---
+
+## ערכת נושאים
+
+לוח הבקרה תומך במצב בהיר וכהה. הפוך דרך הכפתור בסרגל הניווט. ההעדפה מאוחסנת בפחיות האחסון המקומי של הדפדפן שלך.
+
+---
+
+## הגדרת נתיב הפרויקטים
+
+כברירת מחדל, לוח הבקרה קורא מספרייה הפרויקטים הסטנדרטית של Claude Code. עקוף אותו להגדרות מותאמות אישית:
+
+```bash
+CLAUDE_PROJECTS_PATH=/custom/path/to/projects failproofai
+```
+
+---
+
+## גישה מחשב יחידה שלא localhost
+
+כאשר מפעילים את לוח הבקרה ב-**dev mode** (`npm run dev`) וגישה אליו מ-hostname שאינו `localhost` - לדוגמה, דומיין מותאם אישית, IP מרחוק או URL מנהור - ייתכן שתראה אזהרה כמו:
+
+```text
+⚠ Blocked cross-origin request to Next.js dev resource /_next/webpack-hmr from "dashboard.example.com".
+```
+
+זה Next.js חוסם גישה חוצה-origin ל-websocket HMR (hot module reload) שלו, שהיא תכונה dev-only. כדי לאפשר את ה-host שלך, השתמש בדגל `--allowed-origins`:
+
+```bash
+npm run dev -- --allowed-origins dashboard.example.com
+```
+
+עבור מספר hosts או IPs, העבר רשימה מופרדת בפסיקים:
+
+```bash
+npm run dev -- --allowed-origins dashboard.example.com,192.168.1.5
+```
+
+אתה יכול גם להגדיר את משתנה הסביבה `FAILPROOFAI_ALLOWED_DEV_ORIGINS` במקום:
+
+```bash
+FAILPROOFAI_ALLOWED_DEV_ORIGINS=dashboard.example.com npm run dev
+```
+
+<Note>
+זה חל רק על dev mode. כאשר מפעילים `failproofai` (production mode), אין websocket HMR ואין בעיית משאב dev cross-origin.
+</Note>

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) לעיון מלא.