failproofai 1.0.1-beta.0 → 1.0.1

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

@@ -0,0 +1,83 @@
+---
+---
+title: Package Aliases
+description: "पंजीकृत typosquat-prevention aliases और वे कैसे काम करती हैं"
+icon: copy
+---
+
+## Official package
+
+Canonical npm package **`failproofai`** है:
+
+```bash
+npm install -g failproofai
+# या
+bun add -g failproofai
+```
+
+---
+
+## हम alias names का स्वामित्व क्यों रखते हैं
+
+Typosquatting एक आम supply-chain attack है जहाँ एक malicious actor एक package name को register करता है जो एक लोकप्रिय package से एक keystroke दूर होता है। जो उपयोगकर्ता install command को गलत तरीके से type करते हैं, वे attacker-controlled code चलाते हैं जिसके पास पूर्ण system access होता है - बिल्कुल वही threat जिससे Failproof AI की रक्षा करने के लिए डिज़ाइन किया गया है।
+
+इस surface को खत्म करने के लिए, **हम `failproofai` के सभी common misspellings और formatting variants को npm पर पहले से ही अपने कब्जे में करते हैं**। इनमें से कोई भी नाम किसी third party द्वारा register नहीं किया जा सकता। प्रत्येक एक thin proxy है जो real `failproofai` package को install करता है और सौंपता है।
+
+---
+
+## Registered aliases
+
+**Formatting variants** - "failproof ai" लिखने के विभिन्न तरीके:
+
+| Package | Status |
+|---------|--------|
+| `failproof` | ✅ Published |
+| `failproof-ai` | ⏳ npm support के लिए लंबित |
+| `fail-proof-ai` | ⏳ npm support के लिए लंबित |
+| `failproof_ai` | ⏳ npm support के लिए लंबित |
+| `fail_proof_ai` | ⏳ npm support के लिए लंबित |
+| `fail-proofai` | ⏳ npm support के लिए लंबित |
+
+**`failprof*` typos** - "proof" से एक `o` गायब:
+
+| Package | Status |
+|---------|--------|
+| `failprof` | ✅ Published |
+| `failprof-ai` | ✅ Published |
+| `failprofai` | ⏳ npm support के लिए लंबित |
+| `fail-prof-ai` | ⏳ npm support के लिए लंबित |
+| `failprof_ai` | ⏳ npm support के लिए लंबित |
+
+**`faliproof*` typos** - transposed `a` और `i`:
+
+| Package | Status |
+|---------|--------|
+| `faliproof` | ✅ Published |
+| `faliproof-ai` | ✅ Published |
+| `faliproofai` | ⏳ npm support के लिए लंबित |
+
+> **लंबित क्यों?** npm की spam-prevention policy उन नामों को block करती है जो punctuation को हटाने और similarity checks चलाने के बाद एक existing package के समान string में normalize होते हैं। हमने इन नामों को anti-squatting के उद्देश्यों के लिए reserve करने के लिए npm support से संपर्क किया है। ये approval के बाद activate किए जाएंगे।
+
+आप यह सत्यापित कर सकते हैं कि कोई भी published alias हमारे द्वारा owned है:
+
+```bash
+npm info failproof
+# देखें: maintainers field में "ExosphereHost Inc."
+```
+
+---
+
+## Aliases कैसे काम करती हैं
+
+प्रत्येक alias package:
+
+1. `failproofai` को एक dependency के रूप में सूचीबद्ध करता है - तो real package install होता है और इसका binary available हो जाता है
+2. अपने स्वयं के नाम के अनुरूप एक binary को expose करता है (उदाहरण के लिए `failprof-ai`) जो सभी arguments को `failproofai` binary को proxy करता है
+
+Proxy एक two-line Node script है; कोई logic नहीं है, कोई network calls नहीं हैं, और कोई data collection नहीं है जो `failproofai` स्वयं करता है उसके अलावा।
+
+---
+
+## यदि आपको कोई ऐसा नाम मिले जिसे हमने miss किया है
+
+[failproofai/failproofai](https://github.com/failproofai/failproofai/issues) पर एक issue खोलें और हम इसे register करेंगे।

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

@@ -0,0 +1,260 @@
+---
+title: परीक्षण
+description: "यूनिट टेस्ट, E2E टेस्ट और टेस्ट हेल्पर्स"
+icon: flask-vial
+---
+
+failproofai के दो टेस्ट सूट हैं: **यूनिट टेस्ट** (तेज़, मॉक किए गए) और **एंड-टू-एंड टेस्ट** (वास्तविक सबप्रोसेस आह्वान)।
+
+---
+
+## टेस्ट चलाना
+
+```bash
+# सभी यूनिट टेस्ट एक बार चलाएं
+bun run test:run
+
+# यूनिट टेस्ट को वॉच मोड में चलाएं
+bun run test
+
+# E2E टेस्ट चलाएं (सेटअप की आवश्यकता है - नीचे देखें)
+bun run test:e2e
+
+# बिना बिल्ड किए टाइप-चेक करें
+bunx tsc --noEmit
+
+# लिंट करें
+bun run lint
+```
+
+---
+
+## यूनिट टेस्ट
+
+यूनिट टेस्ट `__tests__/` में रहते हैं और [Vitest](https://vitest.dev) को `jsdom` के साथ उपयोग करते हैं।
+
+```text
+__tests__/
+  hooks/
+    builtin-policies.test.ts      # प्रत्येक बिल्टइन के लिए नीति तर्क
+    hooks-config.test.ts          # कॉन्फ़िग लोडिंग और स्कोप मर्जिंग
+    policy-evaluator.test.ts      # पैरामीटर इंजेक्शन और मूल्यांकन क्रम
+    custom-hooks-registry.test.ts # globalThis रजिस्ट्री add/get/clear
+    custom-hooks-loader.test.ts   # ESM लोडर, ट्रांजिटिव इंपोर्ट, एरर हैंडलिंग
+    manager.test.ts               # install/remove/list ऑपरेशन
+  components/
+    sessions-list.test.tsx        # सेशन सूची घटक
+    project-list.test.tsx         # प्रोजेक्ट सूची घटक
+    ...
+  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());
+  });
+});
+```
+
+---
+
+## एंड-टू-एंड टेस्ट
+
+E2E टेस्ट वास्तविक `failproofai` बाइनरी को एक सबप्रोसेस के रूप में आह्वान करते हैं, एक JSON पेलोड को stdin में पाइप करते हैं, और stdout आउटपुट और एक्जिट कोड पर आश्वास करते हैं। यह पूर्ण एकीकरण पथ का परीक्षण करता है जो Claude Code उपयोग करता है।
+
+### सेटअप
+
+E2E टेस्ट रेपो स्रोत से सीधे बाइनरी चलाते हैं। पहली बार चलाने से पहले, CJS बंडल को बनाएं जो कस्टम हुक फाइलें `'failproofai'` से इंपोर्ट करते समय उपयोग करती हैं:
+
+```bash
+bun build src/index.ts --outdir dist --target node --format cjs
+```
+
+फिर टेस्ट चलाएं:
+
+```bash
+bun run test:e2e
+```
+
+जब भी आप सार्वजनिक हुक API (`src/hooks/custom-hooks-registry.ts`, `src/hooks/policy-helpers.ts`, या `src/hooks/policy-types.ts`) को बदलते हैं, तो `dist/` को पुनः बनाएं।
+
+### E2E टेस्ट संरचना
+
+```text
+__tests__/e2e/
+  helpers/
+    hook-runner.ts      # बाइनरी स्पॉन करें, पेलोड JSON पाइप करें, एक्जिट कोड + stdout + stderr कैप्चर करें
+    fixture-env.ts      # कॉन्फ़िग फाइलों के साथ प्रति-टेस्ट अलग-थलग अस्थायी निर्देशिकाएं
+    payloads.ts         # प्रत्येक इवेंट प्रकार के लिए Claude-सटीक पेलोड फैक्टरीज़
+  hooks/
+    builtin-policies.e2e.test.ts   # वास्तविक सबप्रोसेस के साथ प्रत्येक बिल्टइन नीति
+    custom-hooks.e2e.test.ts       # कस्टम हुक लोडिंग और मूल्यांकन
+    config-scopes.e2e.test.ts      # प्रोजेक्ट/लोकल/ग्लोबल भर में कॉन्फ़िग मर्जिंग
+    policy-params.e2e.test.ts      # प्रत्येक पैरामीटराइज़्ड नीति के लिए पैरामीटर इंजेक्शन
+```
+
+### E2E हेल्पर्स का उपयोग करना
+
+**`FixtureEnv`** - प्रति-टेस्ट अलग-थलग वातावरण:
+
+```typescript
+import { createFixtureEnv } from "../helpers/fixture-env";
+
+const env = createFixtureEnv();
+// env.cwd    - अस्थायी डायरेक्टरी; payload.cwd के रूप में पास करें .failproofai/policies-config.json को उठाने के लिए
+// env.home   - अलग-थलग होम डायरेक्टरी; कोई वास्तविक ~/.failproofai लीक नहीं
+
+env.writeConfig({
+  enabledPolicies: ["block-sudo"],
+  policyParams: {
+    "block-sudo": { allowPatterns: ["sudo systemctl status"] },
+  },
+});
+```
+
+`createFixtureEnv()` `afterEach` क्लीनअप को स्वचालित रूप से पंजीकृत करता है।
+
+**`runHook`** - बाइनरी को आह्वान करें:
+
+```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`** - तैयार पेलोड फैक्टरीज़:
+
+```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 → खाली stdout
+  });
+});
+```
+
+### E2E प्रतिक्रिया आकार
+
+| निर्णय | एक्जिट कोड | stdout |
+|----------|-----------|--------|
+| `PreToolUse` deny | `0` | `{"hookSpecificOutput":{"permissionDecision":"deny","permissionDecisionReason":"..."}}` |
+| `PostToolUse` deny | `0` | `{"hookSpecificOutput":{"additionalContext":"Blocked ... because: ..."}}` |
+| Instruct (गैर-Stop) | `0` | `{"hookSpecificOutput":{"additionalContext":"Instruction from failproofai: ..."}}` |
+| Stop instruct | `2` | खाली stdout; कारण stderr में |
+| Allow | `0` | खाली स्ट्रिंग |
+
+### Vitest कॉन्फ़िग
+
+E2E टेस्ट `vitest.config.e2e.mts` का उपयोग करते हैं:
+
+- `environment: "node"` - ब्राउज़र ग्लोबल्स की आवश्यकता नहीं है
+- `pool: "forks"` - सच्चा प्रक्रिया अलगाव (टेस्ट सबप्रोसेस स्पॉन करते हैं)
+- `testTimeout: 20_000` - प्रति टेस्ट 20 सेकंड (बाइनरी स्टार्टअप + हुक मूल्यांकन)
+
+`forks` पूल महत्वपूर्ण है: थ्रेड-आधारित वर्कर्स `globalThis` साझा करते हैं, जो सबप्रोसेस-स्पॉनिंग टेस्ट में हस्तक्षेप कर सकता है। प्रक्रिया-आधारित फोर्क इससे बचते हैं।
+
+---
+
+## CI
+
+पूरा CI रन (`bun run lint && bunx tsc --noEmit && bun run test:run && bun run build`) मर्ज करने से पहले पास होना आवश्यक है। E2E सूट समानांतर में एक अलग CI कार्य के रूप में चलता है।
+
+पूर्ण प्री-मर्ज चेकलिस्ट के लिए [Contributing](../CONTRIBUTING.md) देखें।

package/.next/standalone/docs-old/i18n/README.ar.md

@@ -0,0 +1,230 @@
+> **⚠️** هذه ترجمة آلية. للاطلاع على أحدث إصدار، راجع [English README](../../README.md).
+
+[🇺🇸 English](../../README.md) | [🇨🇳 简体中文](README.zh.md) | [🇯🇵 日本語](README.ja.md) | [🇰🇷 한국어](README.ko.md) | [🇪🇸 Español](README.es.md) | [🇧🇷 Português](README.pt-br.md) | [🇩🇪 Deutsch](README.de.md) | [🇫🇷 Français](README.fr.md) | [🇷🇺 Русский](README.ru.md) | [🇮🇳 हिन्दी](README.hi.md) | [🇹🇷 Türkçe](README.tr.md) | [🇻🇳 Tiếng Việt](README.vi.md) | [🇮🇹 Italiano](README.it.md) | **🇸🇦 العربية** | [🇮🇱 עברית](README.he.md)
+
+---
+<div dir="rtl">
+
+
+<div align="center">
+
+<img src="https://d2wq11aau0arks.cloudfront.net/failproof/fa_updated_full.svg" alt="failproof ai" width="220" />
+
+[![npm](https://img.shields.io/npm/v/failproofai?style=flat-square&color=CB3837)](https://www.npmjs.com/package/failproofai)
+[![CI](https://img.shields.io/github/actions/workflow/status/failproofai/failproofai/ci.yml?branch=main&style=flat-square&label=CI)](https://github.com/failproofai/failproofai/actions)
+[![Supply Chain](https://img.shields.io/badge/supply%20chain-secure-brightgreen?style=flat-square)](https://github.com/failproofai/failproofai/actions/workflows/osv-scanner.yml)
+[![Discord](https://img.shields.io/badge/Discord-join%20us-5865F2?style=flat-square&logo=discord)](https://discord.befailproof.ai/)
+[![Docs](https://img.shields.io/badge/docs-befailproof.ai-002CA7?style=flat-square)](https://docs.befailproof.ai/introduction)
+[![License](https://img.shields.io/badge/license-MIT%20%2B%20Commons%20Clause-blue?style=flat-square)](../../LICENSE)
+
+**الترجمات:** [简体中文](../../docs/i18n/README.zh.md) · [日本語](../../docs/i18n/README.ja.md) · [한국어](../../docs/i18n/README.ko.md) · [Español](../../docs/i18n/README.es.md) · [Português](../../docs/i18n/README.pt-br.md) · [Deutsch](../../docs/i18n/README.de.md) · [Français](../../docs/i18n/README.fr.md) · [Русский](../../docs/i18n/README.ru.md) · [हिन्दी](../../docs/i18n/README.hi.md) · [Türkçe](../../docs/i18n/README.tr.md) · [Tiếng Việt](../../docs/i18n/README.vi.md) · [Italiano](../../docs/i18n/README.it.md) · [العربية](../../docs/i18n/README.ar.md) · [עברית](../../docs/i18n/README.he.md)
+
+**حل فشل وقت التشغيل لعملاء الترميز.**
+يربط Claude Code و Codex. يمسك الحلقات والإجراءات الخطيرة وتسرب الأسرار
+قبل أن تصبح حوادث. بدون تأخير. يعمل محليًا.
+
+</div>
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/FailproofAI/failproofai/main/readme-arch-hq.gif" alt="Failproof AI in action" width="800" />
+</p>
+
+---
+
+## واجهات سطر الأوامر المدعومة للعملاء
+
+{/* A 6-column table instead of inline <img> runs: table columns never re-wrap,
+     so the grid stays 2×6 at any window width (scrolling on very narrow screens
+     instead of collapsing into ragged orphan rows). */}
+<table align="center">
+  <tr>
+    <td align="center" width="96">
+      <a href="https://claude.com/claude-code" title="Claude Code">
+        <img src="https://raw.githubusercontent.com/FailproofAI/failproofai/main/assets/logos/claude.svg" alt="Claude Code" width="56" height="56" />
+      </a>
+    </td>
+    <td align="center" width="96">
+      <a href="https://learn.chatgpt.com" title="OpenAI Codex">
+        <picture>
+          <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/FailproofAI/failproofai/main/assets/logos/openai-dark.svg" />
+          <img src="https://raw.githubusercontent.com/FailproofAI/failproofai/main/assets/logos/openai-light.svg" alt="OpenAI Codex" width="56" height="56" />
+        </picture>
+      </a>
+    </td>
+    <td align="center" width="96">
+      <a href="https://github.com/features/copilot/cli" title="GitHub Copilot CLI">
+        <picture>
+          <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/FailproofAI/failproofai/main/assets/logos/copilot-dark.svg" />
+          <img src="https://raw.githubusercontent.com/FailproofAI/failproofai/main/assets/logos/copilot-light.svg" alt="GitHub Copilot" width="56" height="56" />
+        </picture>
+      </a>
+    </td>
+    <td align="center" width="96">
+      <a href="https://cursor.com" title="Cursor Agent CLI">
+        <picture>
+          <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/FailproofAI/failproofai/main/assets/logos/cursor-dark.svg" />
+          <img src="https://raw.githubusercontent.com/FailproofAI/failproofai/main/assets/logos/cursor-light.svg" alt="Cursor Agent" width="56" height="56" />
+        </picture>
+      </a>
+    </td>
+    <td align="center" width="96">
+      <a href="https://opencode.ai/" title="OpenCode">
+        <picture>
+          <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/FailproofAI/failproofai/main/assets/logos/opencode-dark.svg" />
+          <img src="https://raw.githubusercontent.com/FailproofAI/failproofai/main/assets/logos/opencode-light.svg" alt="OpenCode" width="56" height="56" />
+        </picture>
+      </a>
+    </td>
+    <td align="center" width="96">
+      <a href="https://pi.dev/" title="Pi (pi-coding-agent)">
+        <picture>
+          <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/FailproofAI/failproofai/main/assets/logos/pi-dark.svg" />
+          <img src="https://raw.githubusercontent.com/FailproofAI/failproofai/main/assets/logos/pi-light.svg" alt="Pi" width="56" height="56" />
+        </picture>
+      </a>
+    </td>
+  </tr>
+  <tr>
+    <td align="center" width="96">
+      <a href="https://hermes-agent.nousresearch.com/" title="Hermes (hermes-agent)">
+        <picture>
+          <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/FailproofAI/failproofai/main/assets/logos/hermes-dark.svg" />
+          <img src="https://raw.githubusercontent.com/FailproofAI/failproofai/main/assets/logos/hermes-light.svg" alt="Hermes" width="56" height="56" />
+        </picture>
+      </a>
+    </td>
+    <td align="center" width="96">
+      <a href="https://openclaw.ai/" title="OpenClaw (openclaw gateway)">
+        <img src="https://raw.githubusercontent.com/FailproofAI/failproofai/main/assets/logos/openclaw.svg" alt="OpenClaw" width="56" height="56" />
+      </a>
+    </td>
+    <td align="center" width="96">
+      <a href="https://factory.ai/" title="Factory Droid (droid)">
+        <picture>
+          <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/FailproofAI/failproofai/main/assets/logos/factory-dark.png" />
+          <img src="https://raw.githubusercontent.com/FailproofAI/failproofai/main/assets/logos/factory-light.png" alt="Factory Droid" width="56" height="56" />
+        </picture>
+      </a>
+    </td>
+    <td align="center" width="96">
+      <a href="https://devin.ai" title="Devin CLI (Cognition)">
+        <img src="https://raw.githubusercontent.com/FailproofAI/failproofai/main/assets/logos/devin.svg" alt="Devin CLI" width="56" height="56" />
+      </a>
+    </td>
+    <td align="center" width="96">
+      <a href="https://antigravity.google" title="Antigravity CLI (agy)">
+        <img src="https://raw.githubusercontent.com/FailproofAI/failproofai/main/assets/logos/antigravity.svg" alt="Antigravity CLI" width="56" height="56" />
+      </a>
+    </td>
+    <td align="center" width="96">
+      <a href="https://goose-docs.ai/" title="Goose (codename goose)">
+        <picture>
+          <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/FailproofAI/failproofai/main/assets/logos/goose-dark.svg" />
+          <img src="https://raw.githubusercontent.com/FailproofAI/failproofai/main/assets/logos/goose-light.svg" alt="Goose" width="56" height="56" />
+        </picture>
+      </a>
+    </td>
+  </tr>
+</table>
+
+## التثبيت
+
+```sh
+npm install -g failproofai
+failproofai policies --install   # أو فقط قم بتشغيل `failproofai` وقبل المطالبة الأولى
+failproofai
+```
+
+30 سياسة مدمجة تنشط على الفور. لوحة المعلومات في `localhost:8020`. قم بتعطيل مطالبة الحالة الأولى باستخدام `FAILPROOFAI_NO_FIRST_RUN=1`.
+
+---
+
+## ما الذي يوقفه
+
+| السياسة | ما يتم حظره |
+|---|---|
+| `block-push-master` | الدفع المباشر إلى `main` / `master` |
+| `block-force-push` | `git push --force` |
+| `block-work-on-main` | الالتزامات والدمج وإعادة الأساس على `main` / `master` |
+| `block-rm-rf` | حذف الملفات بشكل متكرر |
+| `sanitize-api-keys` | مفاتيح API تسرب في سياق العامل |
+
+→ [جميع السياسات المدمجة الـ 30](https://docs.befailproof.ai/built-in-policies)
+
+---
+
+## سياساتك الخاصة
+
+أسقط ملفًا في `.failproofai/policies/` - يتم تحميله تلقائيًا، لا توجد علامات مطلوبة.
+قم بالالتزام بها والفريق بأكمله سيحصل عليها في السحب التالي.
+
+```js
+import { customPolicies, deny, allow } from "failproofai";
+
+customPolicies.add({
+  name: "no-production-writes",
+  match: { events: ["PreToolUse"] },
+  fn: async (ctx) => {
+    if (ctx.toolInput?.file_path?.includes("production"))
+      return deny("Writes to production paths are blocked.");
+    return allow();
+  },
+});
+```
+
+ثلاثة قرارات متاحة لكل سياسة:
+
+| القرار | التأثير |
+|---|---|
+| `allow()` | السماح بالعملية |
+| `deny(message)` | حظره - الرسالة تعود إلى العامل |
+| `instruct(message)` | دعه يمر، لكن أضف السياق إلى السؤال التالي للعامل |
+
+→ [دليل السياسات المخصصة](https://docs.befailproof.ai/custom-policies)
+
+---
+
+## رؤية الجلسة
+
+تم تسجيل كل استدعاء أداة يقوم به العامل محليًا. تعرض لوحة المعلومات ما تم تشغيله،
+ما تم حظره، وما قالته السياسة للعامل - لذا لا تخمن
+عندما يحدث خطأ ما. → [دليل لوحة المعلومات](https://docs.befailproof.ai/dashboard)
+
+---
+
+## التوثيق
+
+| | |
+|---|---|
+| [البدء](https://docs.befailproof.ai/getting-started) | التثبيت والخطوات الأولى |
+| [السياسات المدمجة](https://docs.befailproof.ai/built-in-policies) | جميع السياسات الـ 30 مع المعاملات |
+| [السياسات المخصصة](https://docs.befailproof.ai/custom-policies) | اكتب الخاصة بك |
+| [الإعدادات](https://docs.befailproof.ai/configuration) | نطاقات الإعدادات وقواعد الدمج |
+| [لوحة المعلومات](https://docs.befailproof.ai/dashboard) | مراقب الجلسة ونشاط السياسة |
+| [الهندسة المعمارية](https://docs.befailproof.ai/architecture) | كيف يعمل نظام الخطاف |
+
+---
+
+## الترخيص
+
+MIT مع [Commons Clause](https://commonsclause.com/) - مجاني للاستخدام الداخلي والشخصي؛ إعادة بيع failproofai نفسها تجاريًا يتطلب اتفاقية منفصلة. انظر [LICENSE](../../LICENSE) للنص الكامل.
+
+---
+
+## المساهمة
+
+انظر [CONTRIBUTING.md](../../CONTRIBUTING.md). السياسات الجديدة وحالات الحافة والترجمات كلها مرحب بها.
+
+> **بناء قبل أن تبدأ.** قم بتشغيل `bun install && bun run build` أولاً. يعمل هذا المستودع
+> خطاطيف failproofai الخاصة بها على نفسها، وهي تحل استيراد `failproofai` ضد
+> حزمة `dist/` المترجمة - بدون بناء ستصاب بأخطاء خطاف `Cannot find package 'failproofai'`. 
+> أعد البناء بعد تغيير `src/`. انظر
+> [Build before the in-repo dev hooks will work](../../CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work).
+
+---
+
+بني بواسطة [Nivedit Jain](https://github.com/NiveditJain) و [Nikita Agarwal](https://github.com/nk-ag).
+[befailproof.ai](https://befailproof.ai)
+
+
+</div>