Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
60 changes: 30 additions & 30 deletions docs/i18n/README.ar.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,9 +19,9 @@

**الترجمات:** [简体中文](./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. تقبض على الحلقات والإجراءات الخطرة ويسريب الأسرار
قبل أن تصبح حوادث. بدون تأخير. يعمل محليًا.
**حل أعطال وقت التشغيل لوكلاء البرمجة.**
يتكامل مع Claude Code و Codex. يوقف الحلقات اللانهائية والإجراءات الخطيرة وتسريب الأسرار
قبل أن تصبح حوادث. بدون تأخير. يعمل محلياً.

</div>

Expand All @@ -31,7 +31,7 @@

---

## واجهات سطر الأوامر المدعومة للعوامل
## واجهات سطر الأوامر المدعومة للوكلاء

<p align="center">
<a href="https://claude.com/claude-code" title="Claude Code">
Expand Down Expand Up @@ -82,40 +82,40 @@
</a>
</p>

> تثبيت الخطافات لواحد أو أي مزيج: `failproofai policies --install --cli opencode pi gemini` (أو `--cli claude codex copilot cursor opencode pi gemini`). حذف `--cli` للكشف التلقائي عن واجهات سطر الأوامر المثبتة والمطالبة.
> تثبيت الخطافات لواحد أو أي مزيج: `failproofai policies --install --cli opencode pi gemini` (أو `--cli claude codex copilot cursor opencode pi gemini`). تجاهل `--cli` للكشف التلقائي عن واجهات سطر الأوامر المثبتة والمطالبة بها.

---

## التثبيت

```sh
npm install -g failproofai
failproofai policies --install # أو فقط قم بتشغيل `failproofai` وقبول سؤال التشغيل الأول
failproofai policies --install # أو ما عليك سوى تشغيل `failproofai` وقبول المطالبة عند أول تشغيل
failproofai
```

30 سياسة مدمجة تنشط فورًا. لوحة معلومات في `localhost:8020`. تعطيل سؤال التشغيل الأول باستخدام `FAILPROOFAI_NO_FIRST_RUN=1`.
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 إلى سياق العامل |
| `block-work-on-main` | التزامات وعمليات دمج وإعادة تأسيس على `main` / `master` |
| `block-rm-rf` | حذف الملفات بشكل متكرر |
| `sanitize-api-keys` | تسريب مفاتيح API إلى سياق الوكيل |

→ [جميع 30 سياسة مدمجة](https://docs.befailproof.ai/built-in-policies)
→ [جميع السياسات المدمجة البالغ عددها 30](https://docs.befailproof.ai/built-in-policies)

---

## سياساتك الخاصة

أسقط ملفًا في `.failproofai/policies/` - يتم تحميله تلقائيًا، بدون حاجة إلى أعلام.
التزم به وسيحصل الفريق بأكمله عليه في السحب التالي.
ضع ملف في `.failproofai/policies/` — سيتم تحميله تلقائياً، لا حاجة لأي علامات.
التزم به وستحصل الفريق بأكمله عليه في الطلب التالي.

```js
import { customPolicies, deny, allow } from "failproofai";
Expand All @@ -125,7 +125,7 @@ customPolicies.add({
match: { events: ["PreToolUse"] },
fn: async (ctx) => {
if (ctx.toolInput?.file_path?.includes("production"))
return deny("عمليات الكتابة إلى مسارات الإنتاج محظورة.");
return deny("الكتابة إلى مسارات الإنتاج محظورة.");
return allow();
},
});
Expand All @@ -136,18 +136,18 @@ customPolicies.add({
| القرار | التأثير |
|---|---|
| `allow()` | السماح بالعملية |
| `deny(message)` | حظرها - الرسالة تعود إلى العامل |
| `instruct(message)` | دعها تمر، لكن أضف سياقًا إلى موجه العامل التالي |
| `deny(message)` | منعها — ترجع الرسالة إلى الوكيل |
| `instruct(message)` | السماح بها، لكن أضف سياقاً لمطالبة الوكيل التالية |

→ [دليل السياسات المخصصة](https://docs.befailproof.ai/custom-policies)

---

## رؤية الجلسة

كل استدعاء أداة يقوم به العامل يتم تسجيله محليًا. لوحة المعلومات توضح ما يعمل،
وما تم حجبه، وما قالته السياسة للعامل - لذا أنت لا تخمن
عندما يحدث خطأ ما. → [دليل لوحة المعلومات](https://docs.befailproof.ai/dashboard)
كل استدعاء أداة يجريها وكيلك يُسجل محلياً. تعرض لوحة التحكم ما تم تشغيله،
وما تم منعه، وما أخبرت به السياسة الوكيل — لذا لن تكون تخميناً
عندما يحدث خطأ ما. → [دليل لوحة التحكم](https://docs.befailproof.ai/dashboard)

---

Expand All @@ -156,33 +156,33 @@ customPolicies.add({
| | |
|---|---|
| [البدء السريع](https://docs.befailproof.ai/getting-started) | التثبيت والخطوات الأولى |
| [السياسات المدمجة](https://docs.befailproof.ai/built-in-policies) | جميع 30 سياسة مع المعاملات |
| [السياسات المخصصة](https://docs.befailproof.ai/custom-policies) | اكتب الخاصة بك |
| [السياسات المدمجة](https://docs.befailproof.ai/built-in-policies) | جميع السياسات الثلاثون مع المعاملات |
| [السياسات المخصصة](https://docs.befailproof.ai/custom-policies) | اكتب سياساتك الخاصة |
| [التكوين](https://docs.befailproof.ai/configuration) | نطاقات التكوين وقواعد الدمج |
| [لوحة المعلومات](https://docs.befailproof.ai/dashboard) | مراقب الجلسة ونشاط السياسة |
| [لوحة التحكم](https://docs.befailproof.ai/dashboard) | مراقب الجلسة ونشاط السياسة |
| [العمارة](https://docs.befailproof.ai/architecture) | كيفية عمل نظام الخطافات |

---

## الترخيص

MIT مع [Commons Clause](https://commonsclause.com/) - مجاني للاستخدام الداخلي والشخصي؛ إعادة بيع failproofai نفسه تجاريًا يتطلب اتفاقية منفصلة. انظر [LICENSE](./LICENSE) للنص الكامل.
MIT مع [Commons Clause](https://commonsclause.com/) مجاني للاستخدام الداخلي والشخصي؛ إعادة البيع التجاري لـ failproofai نفسه يتطلب اتفاقية منفصلة. انظر [LICENSE](./LICENSE) للنص الكامل.

---

## المساهمة

انظر [CONTRIBUTING.md](./CONTRIBUTING.md). السياسات الجديدة والحالات الحدية والترجمات كلها مرحب بها.
انظر [CONTRIBUTING.md](./CONTRIBUTING.md). السياسات الجديدة والحالات الحدية والترجمات جميعها مرحب بها.

> **بناء قبل أن تبدأ.** قم بتشغيل `bun install && bun run build` أولاً. يقوم هذا المستودع بتشغيل
> خطافات failproofai الخاصة به على نفسه، وتحل فهرس failproofai ضد
> حزمة `dist/` المترجمة - بدون بناء ستصطدم بـ `Cannot find package 'failproofai'`
> أخطاء الخطافات. أعد البناء بعد تغيير `src/`. انظر
> **بناء قبل أن تبدأ.** شغّل `bun install && bun run build` أولاً. يقوم هذا المستودع بتشغيل
> خطافات failproofai الخاصة به على نفسه، ويحل استيراد `failproofai` مقابل
> حزمة `dist/` المترجمة بدون بناء ستواجه أخطاء خطافات `Cannot find package 'failproofai'`
>. أعد البناء بعد تغيير `src/`. انظر
> [بناء قبل أن تعمل خطافات dev في المستودع](./CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work).

---

تم بناؤه بواسطة [Nivedit Jain](https://github.com/NiveditJain) و [Nikita Agarwal](https://github.com/nk-ag).
بنتج من قبل [Nivedit Jain](https://github.com/NiveditJain) و [Nikita Agarwal](https://github.com/nk-ag).
[befailproof.ai](https://befailproof.ai)


Expand Down
46 changes: 23 additions & 23 deletions docs/i18n/README.de.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,8 +17,8 @@

**Übersetzungen:** [简体中文](./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)

**Laufzeit-Fehlerbehebung für Coding-Agents.**
Greift in Claude Code und Codex ein. Erkennt Endlosschleifen, gefährliche Aktionen und geheime Datenlecks,
**Laufzeit-Fehlerbehebung für Coding-Agenten.**
Klinkt sich in Claude Code und Codex ein. Erkennt Endlosschleifen, gefährliche Aktionen und geheime Datenlecks,
bevor sie zu Vorfällen werden. Keine zusätzliche Latenz. Läuft lokal.

</div>
Expand All @@ -29,7 +29,7 @@ bevor sie zu Vorfällen werden. Keine zusätzliche Latenz. Läuft lokal.

---

## Unterstützte Agent-CLIs
## Unterstützte Agenten-CLIs

<p align="center">
<a href="https://claude.com/claude-code" title="Claude Code">
Expand Down Expand Up @@ -80,40 +80,40 @@ bevor sie zu Vorfällen werden. Keine zusätzliche Latenz. Läuft lokal.
</a>
</p>

> Hooks für eine oder mehrere Kombinationen installieren: `failproofai policies --install --cli opencode pi gemini` (oder `--cli claude codex copilot cursor opencode pi gemini`). `--cli` weglassen, um installierte CLIs automatisch zu erkennen und eine Auswahl anzuzeigen.
> Hooks für eine oder mehrere CLIs installieren: `failproofai policies --install --cli opencode pi gemini` (oder `--cli claude codex copilot cursor opencode pi gemini`). `--cli` weglassen, um installierte CLIs automatisch zu erkennen und eine Auswahl zu erhalten.

---

## Installation

```sh
npm install -g failproofai
failproofai policies --install # oder einfach `failproofai` ausführen und die Erststart-Abfrage bestätigen
failproofai policies --install # oder einfach `failproofai` ausführen und beim ersten Start bestätigen
failproofai
```

30 integrierte Richtlinien werden sofort aktiviert. Dashboard unter `localhost:8020`. Die Erststart-Abfrage lässt sich mit `FAILPROOFAI_NO_FIRST_RUN=1` deaktivieren.
30 integrierte Richtlinien werden sofort aktiv. Dashboard unter `localhost:8020`. Den Erststart-Dialog mit `FAILPROOFAI_NO_FIRST_RUN=1` deaktivieren.

---

## Was blockiert wird

| Richtlinie | Was sie verhindert |
| Richtlinie | Was sie blockiert |
|---|---|
| `block-push-master` | Direkte Pushes nach `main` / `master` |
| `block-push-master` | Direkte Pushes auf `main` / `master` |
| `block-force-push` | `git push --force` |
| `block-work-on-main` | Commits, Merges und Rebases auf `main` / `master` |
| `block-rm-rf` | Rekursives Löschen von Dateien |
| `sanitize-api-keys` | API-Schlüssel, die in den Agent-Kontext gelangen |
| `sanitize-api-keys` | API-Keys, die in den Agenten-Kontext gelangen |

→ [Alle 30 integrierten Richtlinien](https://docs.befailproof.ai/built-in-policies)

---

## Eigene Richtlinien

Eine Datei in `.failproofai/policies/` ablegen sie wird automatisch geladen, ohne zusätzliche Parameter.
Ins Repository einchecken und das gesamte Team erhält sie beim nächsten Pull.
Eine Datei in `.failproofai/policies/` ablegen sie wird automatisch geladen, ohne weitere Optionen.
Ins Repository committen, und das gesamte Team erhält sie beim nächsten Pull.

```js
import { customPolicies, deny, allow } from "failproofai";
Expand All @@ -129,23 +129,23 @@ customPolicies.add({
});
```

Drei Entscheidungen stehen jeder Richtlinie zur Verfügung:
Drei Entscheidungstypen stehen jeder Richtlinie zur Verfügung:

| Entscheidung | Wirkung |
|---|---|
| `allow()` | Operation zulassen |
| `deny(message)` | Blockieren die Nachricht wird an den Agent zurückgegeben |
| `instruct(message)` | Durchlassen, aber dem nächsten Prompt des Agents Kontext hinzufügen |
| `deny(message)` | Blockieren die Nachricht wird an den Agenten zurückgegeben |
| `instruct(message)` | Durchlassen, aber dem nächsten Agenten-Prompt zusätzlichen Kontext hinzufügen |

→ [Leitfaden für eigene Richtlinien](https://docs.befailproof.ai/custom-policies)

---

## Sitzungstransparenz
## Sitzungsübersicht

Jeder Tool-Aufruf des Agents wird lokal protokolliert. Das Dashboard zeigt, was ausgeführt wurde,
was blockiert wurde und was die Richtlinie dem Agent mitgeteilt hat damit Sie bei Problemen
nicht im Dunkeln tappen. → [Dashboard-Leitfaden](https://docs.befailproof.ai/dashboard)
Jeder Tool-Aufruf des Agenten wird lokal protokolliert. Das Dashboard zeigt, was ausgeführt wurde,
was blockiert wurde und was die Richtlinie dem Agenten mitgeteilt hat damit man bei Problemen
nicht im Dunkeln tappt. → [Dashboard-Leitfaden](https://docs.befailproof.ai/dashboard)

---

Expand All @@ -164,18 +164,18 @@ nicht im Dunkeln tappen. → [Dashboard-Leitfaden](https://docs.befailproof.ai/d

## Lizenz

MIT mit [Commons Clause](https://commonsclause.com/) kostenlos für den internen und privaten Einsatz; der kommerzielle Weiterverkauf von failproofai selbst erfordert eine gesonderte Vereinbarung. Den vollständigen Text finden Sie in [LICENSE](./LICENSE).
MIT mit [Commons Clause](https://commonsclause.com/) kostenlos für den internen und persönlichen Gebrauch; der kommerzielle Weiterverkauf von failproofai selbst erfordert eine separate Vereinbarung. Den vollständigen Text findet man in der [LICENSE](./LICENSE)-Datei.

---

## Mitwirken

Siehe [CONTRIBUTING.md](./CONTRIBUTING.md). Neue Richtlinien, Grenzfälle und Übersetzungen sind herzlich willkommen.
Siehe [CONTRIBUTING.md](./CONTRIBUTING.md). Neue Richtlinien, Grenzfälle und Übersetzungen sind stets willkommen.

> **Vor dem Start bauen.** Zuerst `bun install && bun run build` ausführen. Dieses Repository verwendet
> failproofai's eigene Hooks auf sich selbst, und diese lösen den `failproofai`-Import gegen das
> kompilierte `dist/`-Bundle auf ohne einen Build treten `Cannot find package 'failproofai'`
> Hook-Fehler auf. Nach Änderungen an `src/` neu bauen. Siehe
> failproofai's eigene Hooks auf sich selbst, und diese lösen den `failproofai`-Import anhand des
> kompilierten `dist/`-Bundles auf ohne Build tritt der Hook-Fehler `Cannot find package 'failproofai'` auf.
> Nach Änderungen an `src/` neu bauen. Siehe
> [Build before the in-repo dev hooks will work](./CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work).

---
Expand Down
Loading