failproofai 1.0.1-beta.0 → 1.0.1

package/.next/standalone/docs-old/he/cli/audit.mdx

@@ -0,0 +1,116 @@
+---
+---
+title: 审计过去的会话 (beta)
+description: "统计代理在过去的文字记录中执行浪费或风险操作的频率"
+---
+
+<Note>
+  **Beta 功能。** 审计以 beta 版本发布，同时我们收集早期反馈。
+  检测器目录和报告格式在下一个稳定版本发布前可能会更改。如果您发现任何问题，请提交 issue。
+</Note>
+
+审计通过 failproofai 的策略引擎重放您过去的代理 CLI 文字记录，并在 **`/audit` 仪表板页面** 上呈现可共享的可视化报告 — 您的代理的原型、0–100 分数，以及具体哪些策略会捕获什么。
+
+## 运行它
+
+三种方式 — 都会转到同一个 `/audit` 报告。
+
+<CodeGroup>
+
+```bash npx (no install)
+npx -y failproofai audit
+```
+
+```bash failproofai audit
+failproofai audit
+```
+
+```bash failproofai (dashboard)
+failproofai
+```
+
+</CodeGroup>
+
+<CardGroup cols={3}>
+  <Card title="无需安装" icon="bolt">
+    `npx -y failproofai audit` 获取 failproofai、运行扫描，并为您打开仪表板 — 无需事先安装任何内容。
+  </Card>
+  <Card title="从 CLI 运行" icon="terminal">
+    `failproofai audit` 在终端中运行扫描，然后在完成时自动打开 `localhost:8020/audit`。
+  </Card>
+  <Card title="从仪表板运行" icon="gauge">
+    运行 `failproofai` 并在导航栏中点击 **Audit**（位于"策略"和"项目"之间），或直接打开 `/audit`。
+  </Card>
+</CardGroup>
+
+<Tip>
+  运行 `failproofai audit -h`（或 `--help`）查看使用方法。审计 **完全离线运行** — 无需账户或网络 — 仪表板将一直提供服务，直到您用 `Ctrl+C` 停止它。
+</Tip>
+
+仪表板扫描这台机器上的过去代理 CLI 文字记录（Claude Code、Codex、Copilot、Cursor、OpenCode、Pi），并报告代理执行 failproofai 被构建用来阻止的操作的频率 — 环境变量检查、强制推送、冗余的 `cd <cwd>` 前缀、睡眠轮询循环、重新读取刚编辑的文件等。
+
+对于每个文字记录，每个工具使用事件都会通过 39 个内置策略 **以及** 8 个仅审计检测器重放，这些检测器捕获运行时策略尚未覆盖的模式。计数会跨所有会话按策略/检测器聚合。
+
+## 您获得什么
+
+`/audit` 页面是一个单屏、可共享的 **海报**，后面跟着四个下方部分：
+
+1. **海报** — 一览您的代理标识：其 **原型**（8 种之一 — `optimist`、`cowboy`、`explorer`、`goldfish`、`paranoid architect`、`precision builder`、`hammer`、`ghost`）、其角色关键字、该原型的罕见程度，以及一个带等级带的 **0–100 分数**（`S` 到 `bottom tier`）。为了便于分享而构建 — 发布到 X 或 LinkedIn，或将其下载为 PNG。
+2. **`// strengths`** — 您的代理已经做得很好的地方，作为来自扫描的真实数字（例如 clean-tool-call %、`0` push-to-main 尝试），仅在相关策略有清晰记录的地方显示。
+3. **`// quirks`** — 滑过的内容：failproofai 会捕获的行为的排名表 — *最后发生的时间*、*滑过的内容*（以及会阻止它的内置程序）、其 *严重程度*，以及 *看到* 它的频率（`new` / `recurring` / `N× seen`）。
+4. **`// how to improve`** — 推荐的修复列表：每个策略一行，包含可复制粘贴的 `failproofai policy add <slug>`，加上一个 **install all** 按钮，可一次启用每项建议并显示您的 **projected score**。
+5. **`// come back better`** — 养成习惯：设置重新审计电子邮件 **提醒**（`3d` / `7d` / `14d` / `30d`）或立即重新审计，以及 **邀请朋友** 运行他们自己的审计（从 failproof.ai 发送，抄送给您）。提醒和邀请需要登录。
+
+## 计划审计
+
+如果您运行 **failproofaid 守护进程**（请参阅 [`failproofai config`](/he/cli/install-policies)），
+它可以为您按计划重新运行审计，并在后台刷新 `/audit` 报告。
+它 **默认关闭**，因为扫描会读取这台机器上每个代理会话文字记录的 *内容* — 在您要求之前，没有任何内容在计时器上扫描。
+
+在 `~/.failproofai/config.toml` 中将其打开：
+
+```toml
+[audit]
+auto = true
+interval_days = 7
+```
+
+| 键 | 含义 |
+|---|---|
+| `auto` | `true` 启用计划扫描。任何其他内容 — 缺失、`false`、`"yes"` — 均为关闭。 |
+| `interval_days` | 扫描之间的天数。限制为 1–90；`0`、负数或非数字返回默认值 `7`。 |
+
+- 计划是 **挂钟时间**，所以它能在暂停和重启后继续：睡眠时间超过到期时间的笔记本电脑在唤醒时 **运行一次**，永远不会出现积压。
+- 每次运行都是一个独立的低优先级（`nice 19`）进程 — 永远不是守护进程的钩子路径，该路径保持空闲以响应工具调用。
+- 如果 `failproofai audit` 或仪表板的重新运行已在进行中，则会跳过扫描；此后不久会重试，而不是被视为失败。
+- 进度被写入 `~/.failproofai/state/audit-schedule.json`（上次运行、下次到期）。守护进程拥有该文件 — 在 `config.toml` 中更改节奏。
+
+<Note>
+如果您在由较早版本的 failproofai 设置的机器上启用了此功能，请运行一次 `failproofai config`。守护进程的服务定义在启动 CLI 之前需要一个额外的条目，该刷新是该命令的一部分。
+</Note>
+
+## 仅审计检测器
+
+这些检测"愚蠢行为"模式，这些模式（尚）未在实时中执行。它们仅在审计期间运行，永远不会阻止实时工具调用。
+
+| 检测器 | 它计数的内容 |
+|---|---|
+| `redundant-cd-cwd` | 以 `cd <cwd> && …` 开头的 Bash 命令，即使命令已在 `cwd` 中运行。 |
+| `prefer-edit-over-read-cat` | 单个源文件上的 `cat`/`head`/`tail`/`less`/`more` — 使用 `Read` 工具。 |
+| `prefer-edit-over-sed-awk` | `sed -i` / `awk … > file` 就地编辑 — 使用 `Edit` 工具。 |
+| `prefer-write-over-heredoc` | Heredoc / 多行 `echo > file` 写入文件 — 使用 `Write` 工具。 |
+| `sleep-polling-loop` | 长 `sleep N`（≥ 30s）或 `while …; sleep …; done` 轮询循环。 |
+| `find-from-root` | `find /`、`find /home`、`find /usr` 等 — 改为限制在 `cwd`。 |
+| `git-commit-no-verify` | `git commit … --no-verify` / `-n`，跳过钩子。 |
+| `reread-after-edit` | `Read` 在同一会话中刚刚被 `Edit`/`Write` 的文件。 |
+
+## 缓存
+
+- **按文字记录缓存** 位于 `~/.failproofai/cache/audit/<sha1>.json`，由 `(mtime, size, engineVersion, detectorVersion)` 作为键 — 当文字记录或策略/检测器代码更改时自动失效。每个条目还存储一个 `cachedAt` 时间戳作为 **TTL 元数据**（不是缓存键的一部分）；超过 **7 天** 的条目在读取时被拒绝，以便长期结果不会超过不断演变的检测器意图。
+- **整体结果缓存** 位于 `~/.failproofai/audit-dashboard.json`（mode 0600）。让仪表板在导航时立即呈现，无需重新运行。在读取超过 **7 天 TTL** 时也会被拒绝 — `/audit` 然后下降到其空状态并提示进行新的运行。点击报告底部附近的 `[ re-audit now ]` 刷新 — 重新审计发送 `noCache: true`，因此它绕过按文字记录缓存并重新扫描每个文字记录，而不是返回缓存结果；运行通过粘性顶部条纹流式传输进度，并在成功时就地交换结果（无页面重新加载；失败的重新审计保留之前的报告）。
+
+## 注意
+
+- **无变动。** 审计以只读模式重放。`warn-repeated-tool-calls` 被跳过，因为其按会话的伴侣文件会被修改。
+- **工作流策略被跳过。** `require-*-before-stop` 策略仅在 `Stop` 事件和对实时 git 状态的 `execSync` 上触发 — 它们没有有意义的"2025 年会发生什么"解释，所以它们不会出现在审计计数中。
+- **自定义策略被跳过。** 用户提供的自定义钩子不会重放（它们自原始会话以来可能已更改）。

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

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

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

@@ -0,0 +1,69 @@
+---
+title: משתנים סביבתיים
+description: "הגדר את התנהגות failproofai באמצעות משתנים סביבתיים"
+---
+
+## לוח בקרה
+
+| משתנה | תיאור |
+|----------|-------------|
+| `PORT` | פורט לוח הבקרה (ברירת מחדל: `8020`) |
+| `CLAUDE_PROJECTS_PATH` | שנה את המיקום שבו נמצאים תיקיות פרויקט Claude Code |
+| `FAILPROOFAI_DISABLE_PAGES=policies,projects` | דפי לוח בקרה מופרדים בפסיקים להסתרה |
+| `FAILPROOFAI_ALLOWED_DEV_ORIGINS` | hosts/IPs המורשים לגשת למשאבי פיתוח. זהה ל-`--allowed-origins`. |
+
+## רישום ביומן
+
+| משתנה | תיאור |
+|----------|-------------|
+| `FAILPROOFAI_LOG_LEVEL=info\|warn\|error` | רמת רישום השרת (ברירת מחדל: `warn`) |
+| `FAILPROOFAI_HOOK_LOG_FILE` | נתיב קובץ רישום hook מותאם אישית, או `true` לברירת מחדל (`~/.failproofai/logs/hooks.log`) |
+
+## טלמטריה
+
+failproofai מדווח על טלמטריית שימוש אנונימית כברירת מחדל. יש שתי דרכים
+להשבית זאת, והן מפתרות לפי מה שהוא מגביל יותר — משתנה סביבתי לא יכול
+לעולם להפעיל מחדש משהו שקובץ קונפיגורציה השבית.
+
+| משתנה | תיאור |
+|----------|-------------|
+| `FAILPROOFAI_TELEMETRY_DISABLED=1` | השבת טלמטריית שימוש אנונימית לתהליך זה |
+
+כדי להשבית זאת באופן קבוע עבור המכונה, הוסף זאת ל-`~/.failproofai/config.toml`:
+
+```toml
+[telemetry]
+enabled = false
+```
+
+<Note>
+קובץ הקונפיגורציה הוא האפשרות להשתמש אם אתה מריץ את **שרת failproofaid**.
+השרת הוא שירות בסקופ מערכת, וסביבתו אינה כוללת משתנים שיוצאו מהשל שלך — אז `FAILPROOFAI_TELEMETRY_DISABLED` לא יכול
+להגיע אליו. `[telemetry] enabled = false` נקרא גם על ידי CLI וגם על ידי השרת.
+</Note>
+
+השרת מדווח על **מחזור חיים** משלו בלבד: שהוא התחיל (ואם ההפעלה הקודמת סיימה בצורה נקייה), שהוא עצר, כאשר סדן הערכה שלו
+נוצר או הופעל מחדש, כאשר משימת אוסף נכשלה, ותוצאה של
+משיכת מדיניות ענן. אלה נושאים ערכים בעלי קרדינליות נמוכה וספירות — לעולם לא נתיב קובץ, פקודה, מדיניות, הנמקה, או משהו
+שנקרא מתוך תמלול. אין אירוע לכל קריאת כלי.
+
+## אימות
+
+| משתנה | תיאור |
+|----------|-------------|
+| `FAILPROOF_API_URL` | שנה את URL הבסיס של שרת ה-API שבו משתמש דיאלוג אימות לוח הבקרה. ברירת מחדל היא `https://api.befailproof.ai`; הגדר ל-`http://localhost:8080` (או למקום אחר) בעת הפעלת שרת api מקומי. |
+| `FAILPROOFAI_AUTH_DIR` | שנה היכן מאוחסן `auth.json` (ברירת מחדל: `~/.failproofai`). שימושי בעיקר לבדיקות מבודדות. |
+
+## הנמקה בהפעלה ראשונה
+
+| משתנה | תיאור |
+|----------|-------------|
+| `FAILPROOFAI_NO_FIRST_RUN=1` | דלג על ההנמקה המציעה להתקין מדיניויות בהזעקה ראשונה של failproofai |
+
+## 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-old/he/cli/hook.mdx

@@ -0,0 +1,30 @@
+---
+title: Hook handler (internal)
+description: "תת-תהליך שClaude Code קוראה בכל אירוע כלי"
+---
+
+```bash
+failproofai --hook <EventType>
+```
+
+זה הפקודה שנרשמת ב-`settings.json` של Claude Code על ידי `failproofai policies --install`. בדרך כלל אתה לא קורא לזה ישירות.
+
+קוראה JSON payload מ-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` |

package/.next/standalone/docs-old/he/cli/install-policies.mdx

@@ -0,0 +1,58 @@
+---
+---
+title: התקנת מדיניויות
+description: "הפעל מדיניויות כך שהן יפעלו בכל קריאת כלי סוכן"
+---
+
+```bash
+failproofai policies --install [policy-names...] [options]
+```
+
+כותב ערכי hook לתוך קובץ ההגדרות של ממשק ה-CLI המותקן שלך (Claude Code, OpenAI Codex, או GitHub Copilot CLI _(beta)_) כך ש-failproofai יחתוך קריאות כלים.
+
+כינויים: `failproofai p -i`
+
+## אפשרויות
+
+| דגל | תיאור |
+|------|-------------|
+| `--cli claude\|codex\|copilot` | ממשקי CLI של סוכן להתקנה עבורם; מופרדים ברווח (למשל `--cli claude codex copilot`) או חוזרים על עצמם. השמט כדי לזהות ממשקי CLI מותקנים ולהנחות. |
+| `--scope user` | התקן לתוך קובץ הגדרות בהיקף משתמש (Claude: `~/.claude/settings.json`; Codex: `~/.codex/hooks.json`; Copilot: `~/.copilot/hooks/failproofai.json`). ברירת המחדל. |
+| `--scope project` | התקן לתוך קובץ הגדרות בהיקף פרויקט (Claude: `<cwd>/.claude/settings.json`; Codex: `<cwd>/.codex/hooks.json`; Copilot: `<cwd>/.github/hooks/failproofai.json`). |
+| `--scope local` | Claude בלבד — התקן לתוך `<cwd>/.claude/settings.local.json`. ל-Codex ול-Copilot אין היקף `local`. |
+| `--custom <path>` / `-c` | נתיב לקובץ JS המכיל מדיניויות hook מותאמות אישית |
+
+## התנהגות
+
+- **ללא שמות מדיניויות** - פותח הנחיה אינטראקטיבית לבחירת מדיניויות
+- **שמות ספציפיים** - מפעיל את המדיניויות הללו (מתווסף לכל המדיניויות שכבר מופעלות)
+- **`all`** - מפעיל כל מדיניות זמינה
+
+התקנה היא צבירתית: הפעלת `--install` שוב תוסיף מדיניויות חדשות ללא הסרת קיימות.
+
+## דוגמאות
+
+```bash
+# התקן את כל המדיניויות ברירת המחדל בעולם (אינטראקטיבי)
+failproofai policies --install
+
+# התקן מדיניויות ספציפיות עבור הפרויקט הנוכחי
+failproofai policies --install block-sudo sanitize-api-keys --scope project
+
+# הפעל את כל המדיניויות בבת אחת
+failproofai policies --install all
+
+# התקן עם קובץ מדיניויות מותאם אישית
+failproofai policies --install --custom ./my-policies.js
+
+# התקן עבור OpenAI Codex (היקף פרויקט)
+failproofai policies --install --cli codex --scope project
+
+# התקן עבור GitHub Copilot CLI (beta) עבור הפרויקט הנוכחי
+failproofai policies --install --cli copilot --scope project
+
+# התקן עבור כל שלושת ממשקי ה-CLI בבת אחת
+failproofai policies --install --cli claude codex copilot
+```
+
+כאשר `--custom <path>` מסופק, הקובץ מאומת מיד - עליו להפעיל את `customPolicies.add()` לפחות פעם אחת. הנתיב המוקל נשמר ל-`policies-config.json` כ-`customPoliciesPath`.

package/.next/standalone/docs-old/he/cli/list-policies.mdx

@@ -0,0 +1,32 @@
+---
+---
+title: רשימת מדיניויות
+description: "ראה אילו מדיניויות מופעלות, הפרמטרים שלהן, ומדיניויות מותאמות אישית"
+---
+
+```bash
+failproofai policies
+```
+
+מציג את כל המדיניויות עם הסטטוס שלהן, הפרמטרים המוגדרים, והמדיניויות המותאמות אישית.
+
+## דוגמה לפלט
+
+```text
+Failproof AI Hook Policies (user)
+
+  Status  Name                          Description
+  ──────  ──────────────────────────────────────────────────────────────
+  ✓       block-sudo                    Block sudo commands
+            allowPatterns: ["sudo systemctl status"]
+  ✓       block-rm-rf                   Block recursive deletions
+  ✗       block-curl-pipe-sh            Block curl|bash patterns
+  ✓       sanitize-api-keys             Redact API keys from output
+            additionalPatterns: [{ regex: "MY_TOKEN_...", label: "..." }]
+
+  ── Custom Policies (/home/alice/myproject/my-policies.js) ──────────────
+  ✓       require-jira-ticket           Block commits without ticket
+  ✓       approval-gate                 Approval gate for destructive ops
+```
+
+מפתחות לא ידועים ב־`policyParams` מסומנים כאן כדי שתוכל לתפוס שגיאות הקלדה מוקדם.

package/.next/standalone/docs-old/he/cli/migrate.mdx

@@ -0,0 +1,87 @@
+---
+---
+title: העברת ספריית הבית
+description: "הבא את ~/.failproofai לתצורה שגרסה זו מכירה, וראה קודם כל מה היה קורה"
+---
+
+```bash
+failproofai migrate --dry-run   # print the plan, change nothing
+failproofai migrate             # run it
+```
+
+רוב האנשים לעולם לא מקלידים את זה. הוא רץ באופן אוטומטי בפקודה הראשונה לאחר שדרוג, וגם [`failproofai update`](/he/cli/update) כולל אותו. השתמש בו ישירות כשאתה רוצה לראות את התוכנית לפני שזה קורה, או כדי להריץ את ההעברה בעצמה.
+
+## מבוסס על התצורה, לא על הגרסה
+
+`~/.failproofai/VERSION` מתעד מספר **תצורה** — צורת הספריה, לא הגרסה שכתבה אותה. העברות מופעלות לפי המספר הזה, וזה מה שהופך פער ארוך לזול:
+
+- גרסאות npm משתנות בכל הוצאה לאור, עשרות אלה בין שתי תצורות.
+- אז מכונה שדילגה על שלוש עשרה הוצאות לאור ללא **שינוי תצורה** מריצה **אפס** העברות, לא שלוש עשרה בלא-פעולה.
+- ומכונה שדילגה על כמה תצורות בבת אחת מריצה כל שלב בסדר, כשכל שלב יודע רק על שני הקצוות שלו.
+
+זה חשוב כי npm לא יכול לעדכן חבילה מותקנת בעצמו. מכונה שישבה על גרסה אחת למשך חודשים ואז קפצה כמה תצורות הלאה היא המקרה הרגיל, לא המוזר.
+
+## הריצת ניסיון
+
+`--dry-run` מדפיס את השרשרת המדויקת והקבצים שיושמרו תחילה, ולא משנה כלל — לא העברה, לא גיבוי, לא ערך רישום:
+
+```
+Layout 2 on disk; this build speaks 3.
+1 step(s) would run:
+  2 → 3  layout 2 → 3: carry config.toml and credentials.toml into JSON, move
+         custom-policies/ back up into policies/, nest the policy config at the root
+
+These would be copied to ~/.failproofai/migrations/backup-layout2 first:
+  VERSION
+  config.toml
+  credentials.toml
+```
+
+## מה מועבר ומה בנוי מחדש
+
+כל נתיב בספריית הבית מצהיר איזה סוג נתונים הוא מכיל, וזה קובע אם העברה יכולה להשליך אותו. הכלל: **נגזר ו-re-fetchable אפשר להוריד; כל דבר שהקלדת, כל דבר שעדיין לא סופק, וכל דבר שמזהה את המכונה מועבר.**
+
+| מועבר | בנוי מחדש או re-fetched |
+|---|---|
+| `config.json` — הגדרות, `daemon.configured`, נתיבי capture נוספים | cache האודיט |
+| `credentials.json` — הרישום שלך בענן | הפריסות המנוהלות בענן (re-fetched ו-digest-verified בסקר הבא) |
+| `policies-config.json` — בחירת המדיניות שלך והפרמטרים שלה | מצב scratch של ה-daemon |
+| `policies/` — קבצי המדיניות שלך וה-helpers שהם מייבאים | |
+| `hook-activity/` — יומן ההחלטות שהדשבורד קורא | |
+| אירועים שלא סופקו עדיין בתור להעלאה | |
+| `cursors/` — סימניות של collector | |
+| binary ה-daemon ב-`bin/` | |
+
+<Note>
+  אירועים שלא סופקו מועברים במקום להיות מושמטים כי ההפסד יהיה קבוע, לא איטי: סימנית ה-collector כבר התקדמה מעבר לכל דבר שיושב ב-spool, כך שלא היה קורא כלום בטווח הזה של טרנסקריפציה שוב. ההעברה גם מבקשת מה-daemon להעביר מה שב-spool בהקדם שהוא מסיים, אז התוצאה הרגילה היא שלא נשאר כלום להעביר.
+</Note>
+
+מפתחות שגרסה *חדשה יותר* כתבה ל-`config.json`, `credentials.json` או `policies-config.json` גם כן משמרים, במקום להיות מושמטים על ידי קורא ישן יותר.
+
+## הרישום שהוא משאיר
+
+```
+~/.failproofai/migrations/
+  applied.json                 ערך אחד לשלב: layout, CLI, timestamp, duration, result
+  backup-layout<n>/            עותקים של הקבצים שלא ניתן להחליף, שנלקחו לפני השלב הראשון
+```
+
+`applied.json` זה מה שעונה "מה המכונה הזו באמת עברה" — השאלה הראשונה שכדאי לשאול כשמשהו נראה לא בסדר לאחר שדרוג. צרף אותו לדוח באג.
+
+הגיבוי בעלי גודל קטן בכוונה במקום עותק של כל הספריה: ההעברה כבר לא מוחקת כלום שלא ניתן להחליף בתכנון, אז מה שכדאי לבטח נגדו הוא *פגם בשלב*, וקבצים ספורים אלה הם המקום שבו פגם כזה יכול להוציא נזק.
+
+## אם שלב נכשל
+
+השרשרת עוצרת שם. `VERSION` מתועד רק על ידי שלב שהושלם, אז הבית נשאר מסומן עם התצורה הישנה שלו והפקודה הבאה מנסה אותה שוב — בית לעולם לא מסומן כעדכני על כוח העברה חלקית. השלב נרשם ב-`applied.json` עם `"ok": false`, והגיבוי הוא המקום בו הוא נלקח.
+
+## בית חדש יותר מורחק, לא מוקצה
+
+אם `~/.failproofai/` נכתב על ידי failproofai **חדש יותר** מה-CLI שאתה מריץ, הפקודה עוצרת ואומרת לך לשדרג במקום. הנתונים הללו בסדר וקורא חדש יותר קורא אותם; ביצוע "מעבר קדימה" מזה לא דבר שקיים, והגדרה מחדש של זה תהרוס משהו שניתן לשחזר.
+
+```
+This machine's failproofai directory was written by a newer version (layout 4;
+this build speaks 3). Upgrade rather than migrate:
+  npm install -g failproofai@latest
+```
+
+ה-daemon מחיל את אותו הכלל: `failproofaid` מסרב להתחיל נגד layout שהוא לא מדבר עליו, במקום לקרוא ולכתוב נתיבים שהעברו.

package/.next/standalone/docs-old/he/cli/remove-policies.mdx

@@ -0,0 +1,44 @@
+---
+---
+title: הסרת מדיניות
+description: "הסר ערכי hook מהגדרות Claude Code"
+---
+
+```bash
+failproofai policies --uninstall [policy-names...] [options]
+```
+
+מסיר ערכי failproofai hook מ-`settings.json` של Claude Code.
+
+כינויים: `failproofai p -u`
+
+## אפשרויות
+
+| דגל | תיאור |
+|------|-------------|
+| `--scope user` | הסר מהגדרות גלובליות (ברירת מחדל) |
+| `--scope project` | הסר מהגדרות הפרויקט |
+| `--scope local` | הסר מהגדרות מקומיות |
+| `--scope all` | הסר מכל ההיקפים בו-זמנית |
+| `--custom` / `-c` | נקה את `customPoliciesPath` מהתצורה |
+
+## התנהגות
+
+- **ללא שמות מדיניות** - מסיר את כל ערכי failproofai hook מקובץ ההגדרות
+- **שמות ספציפיים** - מכבה מדיניות אלה אך משאיר hooks מותקנים
+
+## דוגמאות
+
+```bash
+# הסר את כל ה-hooks באופן גלובלי
+failproofai policies --uninstall
+
+# כבה מדיניות ספציפית (שמור hooks מותקנים)
+failproofai policies --uninstall block-sudo
+
+# הסר hooks מכל היקף
+failproofai policies --uninstall --scope all
+
+# נקה את נתיב המדיניות המותאמות
+failproofai policies --uninstall --custom
+```

package/.next/standalone/docs-old/he/cli/update.mdx

@@ -0,0 +1,64 @@
+---
+title: עדכון לאחר שדרוג
+description: "השלם את החצי של שדרוג שnpm לא יכול לעשות: הצג הבית והתאם את ה-daemon"
+---
+
+```bash
+npm install -g failproofai@latest && failproofai update
+```
+
+זה כל השדרוג. `npm` מחליף את ה-CLI; `failproofai update` עושה את השאר.
+
+## למה קיימת פקודה שנייה
+
+`npm install -g` מחליף דבר אחד בלבד — ה-CLI. שני חלקים נוספים של התקנת failproofai חיים מחוץ לחבילה בכוונה, וגם לא זז כשnpm רץ:
+
+- **`~/.failproofai/`**, ההגדרות שלך, הרישום בענן, בחירת המדיניות והיסטוריה. גרסה חדשה עשויה לארגן זאת אחרת, וההארגון מחדש חייב להיעשות על ידי קוד שמכיר שתי צורות.
+- **ה-daemon binary של `failproofaid`**, בכתובת `~/.failproofai/bin/failproofaid-<version>`. הוא בכוונה *לא* בתוך `node_modules`: שדרוג שהחליף את הקובץ תחת שירות פעיל היה מפנה daemon חי לבינארי שנבנה מקוד שונה, והסרת החבילה היתה מחקה אותו תחת שירות שהיה ואז crash-loops בכל איתחול.
+
+אז אחרי `npm install -g` בלבד, ה-CLI חדש ו-daemon לא. `failproofaid` מסרב להתחיל מול פריסת בית שהוא לא מדבר — הגרסה החזקה של ההתאמה ההיא ולא השקטה — אז שני החצאים צריכים להיות מובאים ביחד. `failproofai update` היא הצעד הזה.
+
+## מה הוא עושה
+
+<Steps>
+  <Step title="מפעיל כל הגדרות פריסה שממתינות">
+    קוראת את הפריסה המתועדת ב-`~/.failproofai/VERSION` והפעיל את הצעדים שמביאים אותה לזו שגרסה זו דוברת. בדרך כלל אין — ראה [`failproofai migrate`](/he/cli/migrate).
+  </Step>
+  <Step title="מציבה את ה-daemon binary התואם במקום">
+    מחבילת הפלטפורמה שnpm כבר הורידה במידת האפשר (ללא רשת), אחרת מנכס השחרור לגרסה זו בדיוק, SHA-256 מאומת לפני שהוא משמש.
+  </Step>
+  <Step title="מפעילה מחדש את השירות ומאשרת שהוא חזר">
+    בדוקה ולא בהנחה — מנהל שירות דיווח על תהליך פעיל ברגע שהוא fork, וזה לא אותו דבר כמו שהוא עובד.
+  </Step>
+</Steps>
+
+## אפשרויות
+
+| דגל | השפעה |
+|------|--------|
+| `--no-daemon` | הצג את הבית בלבד, להשאיר את ה-daemon בגרסה הנוכחית שלו. |
+
+<Warning>
+  `--no-daemon` משאיר daemon בעל גרסה מוטה במקום. על מכונה המוגדרת להדרוש את ה-daemon, כל אירוע hook **נכשל סגור** אם ה-daemon לא יכול לענות — ו-daemon שמסרב להתחיל מול בית מהוגר לא יכול לענות. עדיף לתת לחצי ה-daemon לרוץ.
+</Warning>
+
+## אם משהו הולך לא בסדר
+
+הפקודה יוצאת לא-אפס ואומרת איזה חצי נכשל. שתי מקרים שכדאי לדעת:
+
+- **צעד הגדרה לא הסתיים.** הבית נשאר מסומן עם הפריסה *הישנה* שלו, אז הפקודה הבאה חוזרת עליה — הבית לעולם לא מסומן כעדכני בחוזק של הגדרה חלקית. עותקים של ההגדרות שלך והרישום בענן נשמרו לפני שהיה כל דבר, ב-`~/.failproofai/migrations/backup-layout<n>/`.
+- **ה-daemon לא יכול היה להיות מופעל מחדש ללא סיסמה.** `sudo -n` משמש בכוונה, אז כלום לעולם לא מבקש מתוך תצוגת התקדמות. הפקודה מדפיסה את השורה המדויקת להפעלה בעצמך.
+
+<Note>
+  כלום כאן לא צריך את אשף ההתקנה האינטראקטיבי. ההגדרות שלך, הרישום בענן וגם בחירת המדיניות שורדים שדרוג, אז מכונה מהוגרת אוכפת בדיוק כמו שהיא עשתה קודם — מה שחשוב ביותר על מכונות שאין להן אף אחד יושב בהן: CI runner, fleet box, headless gateway.
+</Note>
+
+## אוטומציה שלה
+
+`failproofai update` לא אינטראקטיבי וניתן להפעלה בבטחה כשאין כלום לעשות — היא מדווחת "לא הייתה צורך בהגדרה" ויוצאת 0. הצבתו אחרי כל שדרוג בתסריט הספקה או Dockerfile היא השימוש הכוונה:
+
+```dockerfile
+RUN npm install -g failproofai@latest && failproofai update --no-daemon
+```
+
+(`--no-daemon` בבנייה של תמונה, שם אין שירות להפעלה מחדש עדיין.)

package/.next/standalone/docs-old/he/cli/version.mdx

@@ -0,0 +1,13 @@
+---
+---
+title: בדוק גרסה
+description: "הדפס את גרסת failproofai המותקנת"
+---
+
+```bash
+failproofai --version
+# or
+failproofai -v
+```
+
+הדפס את מספר הגרסה המותקנת.