From d876c564acb1b53ac0d792e4a48cc2b411a62c1b Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Wed, 24 Jun 2026 11:49:22 +0000 Subject: [PATCH] docs: update translations for changed English sources --- docs/i18n/README.ar.md | 64 ++++++++++++++++++------------------- docs/i18n/README.de.md | 48 ++++++++++++++-------------- docs/i18n/README.es.md | 42 ++++++++++++------------- docs/i18n/README.fr.md | 42 ++++++++++++------------- docs/i18n/README.he.md | 66 +++++++++++++++++++-------------------- docs/i18n/README.hi.md | 61 +++++++++++++++++------------------- docs/i18n/README.it.md | 56 ++++++++++++++++----------------- docs/i18n/README.ja.md | 46 +++++++++++++-------------- docs/i18n/README.ko.md | 54 ++++++++++++++++---------------- docs/i18n/README.pt-br.md | 32 +++++++++---------- docs/i18n/README.ru.md | 55 ++++++++++++++++---------------- docs/i18n/README.tr.md | 64 +++++++++++++++++++------------------ docs/i18n/README.vi.md | 50 ++++++++++++++--------------- docs/i18n/README.zh.md | 38 +++++++++++----------- 14 files changed, 359 insertions(+), 359 deletions(-) diff --git a/docs/i18n/README.ar.md b/docs/i18n/README.ar.md index c9a44b38..da926d28 100644 --- a/docs/i18n/README.ar.md +++ b/docs/i18n/README.ar.md @@ -19,19 +19,19 @@ **الترجمات:** [简体中文](./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. تقبض على الحلقات والإجراءات الخطرة ويسريب الأسرار +قبل أن تصبح حوادث. بدون تأخير. يعمل محليًا.

- Failproof AI قيد العمل + Failproof AI في العمل

--- -## واجهات الخط أمر الوكيل المدعومة +## واجهات سطر الأوامر المدعومة للعوامل

@@ -82,40 +82,40 @@

-> تثبيت المشاريع لواحد أو أي مزيج: `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"; @@ -125,7 +125,7 @@ customPolicies.add({ match: { events: ["PreToolUse"] }, fn: async (ctx) => { if (ctx.toolInput?.file_path?.includes("production")) - return deny("Writes to production paths are blocked."); + return deny("عمليات الكتابة إلى مسارات الإنتاج محظورة."); return allow(); }, }); @@ -136,8 +136,8 @@ customPolicies.add({ | القرار | التأثير | |---|---| | `allow()` | السماح بالعملية | -| `deny(message)` | حظرها — تعود الرسالة إلى الوكيل | -| `instruct(message)` | اسمح بها، لكن أضف سياقاً لموجه الوكيل التالي | +| `deny(message)` | حظرها - الرسالة تعود إلى العامل | +| `instruct(message)` | دعها تمر، لكن أضف سياقًا إلى موجه العامل التالي | → [دليل السياسات المخصصة](https://docs.befailproof.ai/custom-policies) @@ -145,8 +145,8 @@ customPolicies.add({ ## رؤية الجلسة -كل استدعاء أداة يقوم به وكيلك يتم تسجيله محلياً. لوحة المعلومات توضح ما الذي تم تشغيله، -ما الذي تم حظره، وما قالته السياسة للوكيل — بحيث لا تكون تخمين +كل استدعاء أداة يقوم به العامل يتم تسجيله محليًا. لوحة المعلومات توضح ما يعمل، +وما تم حجبه، وما قالته السياسة للعامل - لذا أنت لا تخمن عندما يحدث خطأ ما. → [دليل لوحة المعلومات](https://docs.befailproof.ai/dashboard) --- @@ -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) | جميع 30 سياسة مع المعاملات | +| [السياسات المخصصة](https://docs.befailproof.ai/custom-policies) | اكتب الخاصة بك | | [التكوين](https://docs.befailproof.ai/configuration) | نطاقات التكوين وقواعد الدمج | | [لوحة المعلومات](https://docs.befailproof.ai/dashboard) | مراقب الجلسة ونشاط السياسة | -| [العمارة](https://docs.befailproof.ai/architecture) | كيفية عمل نظام الخطاف | +| [العمارة](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/`. انظر -> [البناء قبل أن تعمل خطافات المستودع داخلي](./CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work). +> **بناء قبل أن تبدأ.** قم بتشغيل `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) diff --git a/docs/i18n/README.de.md b/docs/i18n/README.de.md index f4481a9c..5042d475 100644 --- a/docs/i18n/README.de.md +++ b/docs/i18n/README.de.md @@ -17,9 +17,9 @@ **Ü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-Agenten.** -Hängt sich in Claude Code und Codex ein. Erkennt Schleifen, gefährliche Aktionen und Secret-Leaks, -bevor sie zu Vorfällen werden. Keine Latenz. Läuft lokal. +**Laufzeit-Fehlerbehebung für Coding-Agents.** +Greift 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. @@ -29,7 +29,7 @@ bevor sie zu Vorfällen werden. Keine Latenz. Läuft lokal. --- -## Unterstützte Agenten-CLIs +## Unterstützte Agent-CLIs

@@ -80,7 +80,7 @@ bevor sie zu Vorfällen werden. Keine Latenz. Läuft lokal.

-> 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 anzuzeigen. +> 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. --- @@ -88,23 +88,23 @@ bevor sie zu Vorfällen werden. Keine Latenz. Läuft lokal. ```sh npm install -g failproofai -failproofai policies --install # oder einfach `failproofai` ausführen und den Erststart-Dialog bestätigen +failproofai policies --install # oder einfach `failproofai` ausführen und die Erststart-Abfrage bestätigen failproofai ``` -30 integrierte Richtlinien werden sofort aktiviert. Dashboard unter `localhost:8020`. Den Erststart-Dialog mit `FAILPROOFAI_NO_FIRST_RUN=1` deaktivieren. +30 integrierte Richtlinien werden sofort aktiviert. Dashboard unter `localhost:8020`. Die Erststart-Abfrage lässt sich mit `FAILPROOFAI_NO_FIRST_RUN=1` deaktivieren. --- ## Was blockiert wird -| Richtlinie | Was sie blockiert | +| Richtlinie | Was sie verhindert | |---|---| -| `block-push-master` | Direkte Pushes auf `main` / `master` | +| `block-push-master` | Direkte Pushes nach `main` / `master` | | `block-force-push` | `git push --force` | -| `block-work-on-main` | Commits, Merges, Rebases auf `main` / `master` | +| `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 Agenten-Kontext gelangen | +| `sanitize-api-keys` | API-Schlüssel, die in den Agent-Kontext gelangen | → [Alle 30 integrierten Richtlinien](https://docs.befailproof.ai/built-in-policies) @@ -112,8 +112,8 @@ failproofai ## Eigene Richtlinien -Eine Datei in `.failproofai/policies/` ablegen — sie wird automatisch geladen, ohne zusätzliche Flags. -Ins Repository committen, und das gesamte Team erhält sie beim nächsten Pull. +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. ```js import { customPolicies, deny, allow } from "failproofai"; @@ -133,19 +133,19 @@ Drei Entscheidungen stehen jeder Richtlinie zur Verfügung: | Entscheidung | Wirkung | |---|---| -| `allow()` | Operation erlauben | -| `deny(message)` | Blockieren — die Nachricht wird an den Agenten zurückgegeben | -| `instruct(message)` | Durchlassen, aber dem nächsten Prompt des Agenten Kontext hinzufügen | +| `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 | -→ [Anleitung für eigene Richtlinien](https://docs.befailproof.ai/custom-policies) +→ [Leitfaden für eigene Richtlinien](https://docs.befailproof.ai/custom-policies) --- ## Sitzungstransparenz -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 keine Raterei nötig ist, -wenn etwas schiefläuft. → [Dashboard-Anleitung](https://docs.befailproof.ai/dashboard) +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) --- @@ -170,12 +170,12 @@ MIT mit [Commons Clause](https://commonsclause.com/) — kostenlos für den inte ## Mitwirken -Siehe [CONTRIBUTING.md](./CONTRIBUTING.md). Neue Richtlinien, Randfälle und Übersetzungen sind herzlich willkommen. +Siehe [CONTRIBUTING.md](./CONTRIBUTING.md). Neue Richtlinien, Grenzfälle und Übersetzungen sind herzlich willkommen. > **Vor dem Start bauen.** Zuerst `bun install && bun run build` ausführen. Dieses Repository verwendet -> failproofais eigene Hooks auf sich selbst, und diese lösen den `failproofai`-Import gegen das -> kompilierte `dist/`-Bundle auf — ohne einen Build tritt der Hook-Fehler `Cannot find package 'failproofai'` -> auf. Nach Änderungen in `src/` neu bauen. Siehe +> 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 > [Build before the in-repo dev hooks will work](./CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work). --- diff --git a/docs/i18n/README.es.md b/docs/i18n/README.es.md index 03ab49e3..8ba7eacf 100644 --- a/docs/i18n/README.es.md +++ b/docs/i18n/README.es.md @@ -17,9 +17,9 @@ **Traducciones:** [简体中文](./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) -**Resolución de fallos en tiempo de ejecución para agentes de código.** +**Resolución de fallos en tiempo de ejecución para agentes de codificación.** Se integra con Claude Code y Codex. Detecta bucles, acciones peligrosas y filtraciones de secretos -antes de que se conviertan en incidentes. Sin latencia. Funciona localmente. +antes de que se conviertan en incidentes. Latencia cero. Se ejecuta localmente. @@ -80,7 +80,7 @@ antes de que se conviertan en incidentes. Sin latencia. Funciona localmente.

-> Instala hooks para uno o cualquier combinación: `failproofai policies --install --cli opencode pi gemini` (o `--cli claude codex copilot cursor opencode pi gemini`). Omite `--cli` para detectar automáticamente los CLIs instalados y que te solicite confirmación. +> Instala hooks para uno o cualquier combinación: `failproofai policies --install --cli opencode pi gemini` (o `--cli claude codex copilot cursor opencode pi gemini`). Omite `--cli` para detectar automáticamente los CLIs instalados y recibir un aviso. --- @@ -88,11 +88,11 @@ antes de que se conviertan en incidentes. Sin latencia. Funciona localmente. ```sh npm install -g failproofai -failproofai policies --install # o simplemente ejecuta `failproofai` y acepta el aviso de primera ejecución +failproofai policies --install # o simplemente ejecuta `failproofai` y acepta el aviso del primer inicio failproofai ``` -30 políticas integradas se activan de inmediato. Panel en `localhost:8020`. Desactiva el aviso de primera ejecución con `FAILPROOFAI_NO_FIRST_RUN=1`. +30 políticas integradas se activan de inmediato. Panel de control en `localhost:8020`. Desactiva el aviso del primer inicio con `FAILPROOFAI_NO_FIRST_RUN=1`. --- @@ -100,9 +100,9 @@ failproofai | Política | Qué bloquea | |---|---| -| `block-push-master` | Pushes directos a `main` / `master` | +| `block-push-master` | Envíos directos a `main` / `master` | | `block-force-push` | `git push --force` | -| `block-work-on-main` | Commits, merges y rebases en `main` / `master` | +| `block-work-on-main` | Commits, merges, rebases en `main` / `master` | | `block-rm-rf` | Eliminación recursiva de archivos | | `sanitize-api-keys` | Claves de API que se filtran al contexto del agente | @@ -112,8 +112,8 @@ failproofai ## Tus propias políticas -Coloca un archivo en `.failproofai/policies/` — se carga automáticamente, sin necesidad de flags. -Confírmalo en el repositorio y todo el equipo lo obtiene en el siguiente pull. +Coloca un archivo en `.failproofai/policies/` — se carga automáticamente, sin necesidad de indicadores. +Confírmalo y todo el equipo lo obtendrá en el próximo pull. ```js import { customPolicies, deny, allow } from "failproofai"; @@ -143,9 +143,9 @@ Tres decisiones disponibles para cada política: ## Visibilidad de la sesión -Cada llamada a herramienta que realiza tu agente se registra localmente. El panel muestra qué se ejecutó, -qué fue bloqueado y qué le indicó la política al agente — así no tienes que adivinar -cuando algo sale mal. → [Guía del panel](https://docs.befailproof.ai/dashboard) +Cada llamada a herramienta que realiza tu agente se registra localmente. El panel de control muestra qué se ejecutó, +qué fue bloqueado y qué le indicó la política al agente — para que no tengas que adivinar +cuando algo sale mal. → [Guía del panel de control](https://docs.befailproof.ai/dashboard) --- @@ -153,29 +153,29 @@ cuando algo sale mal. → [Guía del panel](https://docs.befailproof.ai/dashboar | | | |---|---| -| [Primeros pasos](https://docs.befailproof.ai/getting-started) | Instalación y primeros pasos | +| [Primeros pasos](https://docs.befailproof.ai/getting-started) | Instalación y pasos iniciales | | [Políticas integradas](https://docs.befailproof.ai/built-in-policies) | Las 30 políticas con sus parámetros | | [Políticas personalizadas](https://docs.befailproof.ai/custom-policies) | Escribe las tuyas propias | -| [Configuración](https://docs.befailproof.ai/configuration) | Ámbitos de configuración y reglas de fusión | -| [Panel](https://docs.befailproof.ai/dashboard) | Monitor de sesión y actividad de políticas | +| [Configuración](https://docs.befailproof.ai/configuration) | Ámbitos de configuración y reglas de combinación | +| [Panel de control](https://docs.befailproof.ai/dashboard) | Monitor de sesión y actividad de políticas | | [Arquitectura](https://docs.befailproof.ai/architecture) | Cómo funciona el sistema de hooks | --- ## Licencia -MIT con [Commons Clause](https://commonsclause.com/) — gratuita para uso interno y personal; la reventa comercial de failproofai en sí requiere un acuerdo separado. Consulta [LICENSE](./LICENSE) para el texto completo. +MIT con [Commons Clause](https://commonsclause.com/) — gratuito para uso interno y personal; la reventa comercial de failproofai en sí requiere un acuerdo por separado. Consulta [LICENSE](./LICENSE) para el texto completo. --- ## Contribuciones -Consulta [CONTRIBUTING.md](./CONTRIBUTING.md). Se aceptan nuevas políticas, casos límite y traducciones. +Consulta [CONTRIBUTING.md](./CONTRIBUTING.md). Son bienvenidas nuevas políticas, casos límite y traducciones. -> **Compila antes de empezar.** Ejecuta primero `bun install && bun run build`. Este repositorio ejecuta -> los propios hooks de failproofai sobre sí mismo, y resuelven la importación de `failproofai` contra el -> bundle compilado en `dist/` — sin una compilación obtendrás errores de hook `Cannot find package 'failproofai'`. -> Vuelve a compilar después de modificar `src/`. Consulta +> **Compila antes de empezar.** Ejecuta `bun install && bun run build` primero. Este repositorio ejecuta +> los propios hooks de failproofai sobre sí mismo, y resuelven la importación `failproofai` contra el +> paquete compilado `dist/` — sin una compilación obtendrás errores de hook `Cannot find package 'failproofai'`. +> Recompila después de modificar `src/`. Consulta > [Build before the in-repo dev hooks will work](./CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work). --- diff --git a/docs/i18n/README.fr.md b/docs/i18n/README.fr.md index 2653d518..c3da4407 100644 --- a/docs/i18n/README.fr.md +++ b/docs/i18n/README.fr.md @@ -17,8 +17,8 @@ **Traductions :** [简体中文](./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) -**Résolution des erreurs d'exécution pour les agents de codage.** -S'intègre à Claude Code et Codex. Détecte les boucles, les actions dangereuses et les fuites de secrets +**Résolution des erreurs d'exécution pour les agents de code.** +Se connecte à Claude Code et Codex. Détecte les boucles, les actions dangereuses et les fuites de secrets avant qu'ils ne deviennent des incidents. Zéro latence. Fonctionne en local. @@ -29,7 +29,7 @@ avant qu'ils ne deviennent des incidents. Zéro latence. Fonctionne en local. --- -## CLIs d'agents pris en charge +## CLI d'agents pris en charge

@@ -80,7 +80,7 @@ avant qu'ils ne deviennent des incidents. Zéro latence. Fonctionne en local.

-> Installez les hooks pour un ou plusieurs agents en combinaison : `failproofai policies --install --cli opencode pi gemini` (ou `--cli claude codex copilot cursor opencode pi gemini`). Omettez `--cli` pour détecter automatiquement les CLIs installés et être invité à choisir. +> Installez les hooks pour un ou plusieurs CLI au choix : `failproofai policies --install --cli opencode pi gemini` (ou `--cli claude codex copilot cursor opencode pi gemini`). Omettez `--cli` pour détecter automatiquement les CLI installés et afficher une invite. --- @@ -88,23 +88,23 @@ avant qu'ils ne deviennent des incidents. Zéro latence. Fonctionne en local. ```sh npm install -g failproofai -failproofai policies --install # ou lancez simplement `failproofai` et acceptez l'invite au premier démarrage +failproofai policies --install # or just run `failproofai` and accept the first-run prompt failproofai ``` -30 politiques intégrées s'activent immédiatement. Tableau de bord disponible sur `localhost:8020`. Désactivez l'invite au premier démarrage avec `FAILPROOFAI_NO_FIRST_RUN=1`. +30 politiques intégrées s'activent immédiatement. Tableau de bord disponible sur `localhost:8020`. Désactivez l'invite de premier démarrage avec `FAILPROOFAI_NO_FIRST_RUN=1`. --- -## Ce qu'il bloque +## Ce que ça bloque -| Politique | Ce qu'elle bloque | +| Politique | Ce qui est bloqué | |---|---| -| `block-push-master` | Pushs directs vers `main` / `master` | +| `block-push-master` | Les push directs vers `main` / `master` | | `block-force-push` | `git push --force` | -| `block-work-on-main` | Commits, fusions et rebases sur `main` / `master` | -| `block-rm-rf` | Suppression récursive de fichiers | -| `sanitize-api-keys` | Fuites de clés API dans le contexte de l'agent | +| `block-work-on-main` | Les commits, merges et rebases sur `main` / `master` | +| `block-rm-rf` | La suppression récursive de fichiers | +| `sanitize-api-keys` | Les clés API qui fuient dans le contexte de l'agent | → [Les 30 politiques intégrées](https://docs.befailproof.ai/built-in-policies) @@ -112,7 +112,7 @@ failproofai ## Vos propres politiques -Déposez un fichier dans `.failproofai/policies/` — il se charge automatiquement, sans aucun paramètre. +Déposez un fichier dans `.failproofai/policies/` — il se charge automatiquement, aucun flag requis. Commitez-le et toute l'équipe en bénéficiera au prochain pull. ```js @@ -135,7 +135,7 @@ Trois décisions disponibles pour chaque politique : |---|---| | `allow()` | Autorise l'opération | | `deny(message)` | La bloque — le message est renvoyé à l'agent | -| `instruct(message)` | Laisse passer, mais ajoute du contexte au prochain prompt de l'agent | +| `instruct(message)` | La laisse passer, mais ajoute du contexte au prochain prompt de l'agent | → [Guide des politiques personnalisées](https://docs.befailproof.ai/custom-policies) @@ -143,9 +143,9 @@ Trois décisions disponibles pour chaque politique : ## Visibilité de session -Chaque appel d'outil effectué par votre agent est enregistré localement. Le tableau de bord affiche ce qui s'est exécuté, -ce qui a été bloqué et ce que la politique a communiqué à l'agent — pour ne plus jamais avoir à deviner -ce qui s'est passé en cas de problème. → [Guide du tableau de bord](https://docs.befailproof.ai/dashboard) +Chaque appel d'outil effectué par votre agent est enregistré en local. Le tableau de bord affiche ce qui a été exécuté, +ce qui a été bloqué et ce que la politique a indiqué à l'agent — pour ne plus jamais être dans le flou +quand quelque chose tourne mal. → [Guide du tableau de bord](https://docs.befailproof.ai/dashboard) --- @@ -164,18 +164,18 @@ ce qui s'est passé en cas de problème. → [Guide du tableau de bord](https:// ## Licence -MIT avec [Commons Clause](https://commonsclause.com/) — gratuit pour usage interne et personnel ; la revente commerciale de failproofai lui-même nécessite un accord séparé. Consultez [LICENSE](./LICENSE) pour le texte intégral. +MIT avec [Commons Clause](https://commonsclause.com/) — gratuit pour usage interne et personnel ; la revente commerciale de failproofai lui-même nécessite un accord séparé. Voir [LICENSE](./LICENSE) pour le texte complet. --- ## Contribution -Consultez [CONTRIBUTING.md](./CONTRIBUTING.md). Les nouvelles politiques, cas limites et traductions sont les bienvenus. +Voir [CONTRIBUTING.md](./CONTRIBUTING.md). Nouvelles politiques, cas limites et traductions sont les bienvenus. -> **Compilez avant de commencer.** Exécutez d'abord `bun install && bun run build`. Ce dépôt fait tourner ses propres hooks failproofai sur lui-même, et ils résolvent l'import `failproofai` depuis le bundle compilé `dist/` — sans compilation, vous obtiendrez des erreurs de hook `Cannot find package 'failproofai'`. Recompilez après toute modification dans `src/`. Consultez +> **Compilez avant de commencer.** Exécutez d'abord `bun install && bun run build`. Ce dépôt fait tourner ses propres hooks sur lui-même, et ils résolvent l'import `failproofai` depuis le bundle compilé `dist/` — sans compilation, vous obtiendrez des erreurs de hook `Cannot find package 'failproofai'`. Recompilez après avoir modifié `src/`. Voir > [Build before the in-repo dev hooks will work](./CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work). --- -Développé par [Nivedit Jain](https://github.com/NiveditJain) et [Nikita Agarwal](https://github.com/nk-ag). +Créé par [Nivedit Jain](https://github.com/NiveditJain) et [Nikita Agarwal](https://github.com/nk-ag). [befailproof.ai](https://befailproof.ai) diff --git a/docs/i18n/README.he.md b/docs/i18n/README.he.md index 5cbe6ecb..adaf73fb 100644 --- a/docs/i18n/README.he.md +++ b/docs/i18n/README.he.md @@ -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. תופסים לולאות, פעולות מסוכנות, ודיפוזיות של סודות +לפני שהם הופכים לתקריות. אפס השהיה. רץ מקומי. @@ -31,7 +31,7 @@ --- -## CLI של סוכנים נתמכים +## CLI סוכנים נתמכים

@@ -82,7 +82,7 @@

-> התקן hooks לאחד או לכל שילוב: `failproofai policies --install --cli opencode pi gemini` (או `--cli claude codex copilot cursor opencode pi gemini`). השמט את `--cli` כדי לגלות CLI מותקנים באופן אוטומטי ולהיבקש. +> התקינו hooks עבור אחד או כל שילוב: `failproofai policies --install --cli opencode pi gemini` (או `--cli claude codex copilot cursor opencode pi gemini`). השמיטו `--cli` לזיהוי אוטומטי של CLI מותקנות והנחיה. --- @@ -90,11 +90,11 @@ ```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`. --- @@ -102,20 +102,20 @@ failproofai | מדיניות | מה זה חוסם | |---|---| -| `block-push-master` | דחיפה ישירה ל-`main` / `master` | +| `block-push-master` | דחיפות ישירות ל-`main` / `master` | | `block-force-push` | `git push --force` | -| `block-work-on-main` | commits, merges, rebases על `main` / `master` | +| `block-work-on-main` | קומיטים, מיזוגים, rebases על `main` / `master` | | `block-rm-rf` | מחיקת קבצים רקורסיבית | -| `sanitize-api-keys` | מפתחות API שדולפים להקשר הסוכן | +| `sanitize-api-keys` | מפתחות API דולפים לתוך הקשר הסוכן | -→ [כל 30 המדיניויות המובנות](https://docs.befailproof.ai/built-in-policies) +→ [כל 30 המדיניות המובנות](https://docs.befailproof.ai/built-in-policies) --- -## המדיניויות שלך +## המדיניות שלך -שחרר קובץ אל `.failproofai/policies/` — הוא נטען באופן אוטומטי, ללא דגלים נדרשים. -שנה אותו וכל הצוות שלך מקבל אותו בעת ה-pull הבא. +הנח קובץ ל-`.failproofai/policies/` — הוא נטען אוטומטית, ללא דגלים נדרשים. +קומיטו אותו והצוות כולו מקבל אותו בפול הבא. ```js import { customPolicies, deny, allow } from "failproofai"; @@ -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/custom-policies) --- -## נראות הפגישה +## נראות הסדרה -כל קריאת כלי שהסוכן שלך מבצע מנויה באופן מקומי. לוח הבקרה מציג מה רץ, -מה היה חסום ומה אמרה המדיניות לסוכן — כך שאתה לא בניחוש -כשמשהו משתבש. → [מדריך לוח בקרה](https://docs.befailproof.ai/dashboard) +כל קריאת כלים שהסוכן שלך מבצע נרשמת מקומית. לוח המחוונים מראה מה רץ, +מה נחסם, ומה המדיניות אמרה לסוכן — כך שאתה לא מנחש +כשמשהו הולך לא טוב. → [מדריך לוח המחוונים](https://docs.befailproof.ai/dashboard) --- @@ -155,30 +155,30 @@ 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/configuration) | היקפי הגדרה וכללי מיזוג | -| [לוח בקרה](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) | איך מערכת ה-hook עובדת | --- ## רישיון -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` תחילה. מאגר זה מריץ -> את ה-hooks שלו על עצמו, והם פותרים את ייבוא ה-`failproofai` כנגד ה-bundle -> המהודר `dist/` — ללא בנייה תקבל `Cannot find package 'failproofai'` -> שגיאות hook. בנה מחדש לאחר שינוי `src/`. ראה -> [בנה לפני שה-dev hooks בתוך המאגר יעבדו](./CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work). +> **בנו לפני שתתחילו.** הריצו `bun install && bun run build` תחילה. מאגר זה מריץ +> hooks של failproofai על עצמו, והם פותרים את היבוא `failproofai` כנגד +> bundle המהדר `dist/` — ללא build תפגעו ב-`Cannot find package 'failproofai'` +> שגיאות hook. בנו מחדש לאחר שינוי `src/`. ראה +> [בנו לפני שה-in-repo dev hooks יעבדו](./CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work). --- diff --git a/docs/i18n/README.hi.md b/docs/i18n/README.hi.md index 57a05e02..5e6dfbc2 100644 --- a/docs/i18n/README.hi.md +++ b/docs/i18n/README.hi.md @@ -17,9 +17,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 में हुक किया गया। लूप्स, खतरनाक क्रियाएं, और सीक्रेट लीक को +समस्याओं से पहले पकड़ता है। शून्य विलंबता। स्थानीय रूप से चलता है। @@ -80,7 +80,7 @@ Claude Code और Codex में हुक करता है। लूप्

-> एक या कई के लिए हुक इंस्टॉल करें: `failproofai policies --install --cli opencode pi gemini` (या `--cli claude codex copilot cursor opencode pi gemini`)। स्वचालित रूप से इंस्टॉल किए गए CLIs का पता लगाने और प्रॉम्प्ट करने के लिए `--cli` छोड़ दें। +> एक या किसी भी संयोजन के लिए हुक इंस्टॉल करें: `failproofai policies --install --cli opencode pi gemini` (या `--cli claude codex copilot cursor opencode pi gemini`)। स्वचालित रूप से इंस्टॉल किए गए CLIs का पता लगाने और संकेत देने के लिए `--cli` को छोड़ दें। --- @@ -88,31 +88,31 @@ Claude Code और Codex में हुक करता है। लूप् ```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-push-master` | `main` / `master` के लिए सीधे पुश | | `block-force-push` | `git push --force` | | `block-work-on-main` | `main` / `master` पर कमिट, मर्ज, रीबेस | -| `block-rm-rf` | पुनरावर्ती फ़ाइल विलोपन | -| `sanitize-api-keys` | एजेंट संदर्भ में API कुंजी लीक होना | +| `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 @@ -129,23 +129,22 @@ customPolicies.add({ }); ``` -हर पॉलिसी के लिए तीन निर्णय उपलब्ध हैं: +हर नीति के लिए तीन निर्णय उपलब्ध हैं: | निर्णय | प्रभाव | |---|---| -| `allow()` | ऑपरेशन की अनुमति दें | +| `allow()` | संचालन की अनुमति दें | | `deny(message)` | इसे ब्लॉक करें — संदेश एजेंट को वापस जाता है | -| `instruct(message)` | इसे पास करें, लेकिन एजेंट के अगले प्रॉम्प्ट में संदर्भ जोड़ें | +| `instruct(message)` | इसे जारी रखें, लेकिन एजेंट के अगले संकेत में संदर्भ जोड़ें | -→ [कस्टम पॉलिसीज गाइड](https://docs.befailproof.ai/custom-policies) +→ [कस्टम नीतियां गाइड](https://docs.befailproof.ai/custom-policies) --- -## सेशन दृश्यमानता +## सत्र दृश्यता -आपके एजेंट द्वारा किया जाने वाला हर टूल कॉल स्थानीय रूप से लॉग किया जाता है। डैशबोर्ड दिखाता है कि क्या चला, -क्या ब्लॉक किया गया, और पॉलिसी ने एजेंट को क्या कहा — इसलिए आप अनुमान नहीं लगा रहे हैं -जब कुछ गलत हो जाता है। → [डैशबोर्ड गाइड](https://docs.befailproof.ai/dashboard) +आपके एजेंट द्वारा किया गया प्रत्येक टूल कॉल स्थानीय रूप से लॉग किया जाता है। डैशबोर्ड दिखाता है कि क्या चला, +क्या ब्लॉक किया गया, और नीति ने एजेंट को क्या बताया — इसलिए जब कुछ गलत हो जाए तो आप अनुमान नहीं लगाते हैं। → [डैशबोर्ड गाइड](https://docs.befailproof.ai/dashboard) --- @@ -154,31 +153,27 @@ 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/configuration) | कॉन्फ़िग स्कोप और मर्ज नियम | -| [डैशबोर्ड](https://docs.befailproof.ai/dashboard) | सेशन मॉनिटर और पॉलिसी गतिविधि | +| [बिल्ट-इन नीतियां](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 with [Commons Clause](https://commonsclause.com/) — आंतरिक और व्यक्तिगत उपयोग के लिए निःशुल्क; failproofai के वाणिज्यिक पुनर्विक्रय के लिए एक अलग समझौते की आवश्यकता है। पूरे पाठ के लिए [LICENSE](./LICENSE) देखें। +MIT with [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/` में परिवर्तन के बाद पुनः बिल्ड करें। देखें -> [बिल्ड करें ताकि रेपो-में डेव हुक्स काम करेंगे](./CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work)। +> **शुरू करने से पहले बिल्ड करें।** पहले `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) diff --git a/docs/i18n/README.it.md b/docs/i18n/README.it.md index e2872dec..b5d27fc7 100644 --- a/docs/i18n/README.it.md +++ b/docs/i18n/README.it.md @@ -17,9 +17,9 @@ **Traduzioni:** [简体中文](./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) -**Risoluzione dei guasti runtime per agenti di codifica.** -Si integra con Claude Code e Codex. Intercetta loop, azioni pericolose e fughe di segreti -prima che diventino incidenti. Latenza zero. Eseguito in locale. +**Risoluzione dei guasti in tempo reale per agenti di codifica.** +Si integra con Claude Code e Codex. Cattura loop, azioni pericolose e perdite di segreti +prima che diventino incidenti. Zero latenza. Esecuzione locale. @@ -80,7 +80,7 @@ prima che diventino incidenti. Latenza zero. Eseguito in locale.

-> Installa hook per uno o qualsiasi combinazione: `failproofai policies --install --cli opencode pi gemini` (oppure `--cli claude codex copilot cursor opencode pi gemini`). Ometti `--cli` per il rilevamento automatico dei CLI installati e un prompt. +> Installa gli hook per uno o una qualsiasi combinazione: `failproofai policies --install --cli opencode pi gemini` (oppure `--cli claude codex copilot cursor opencode pi gemini`). Ometti `--cli` per rilevare automaticamente i CLI installati e ricevere un prompt. --- @@ -88,11 +88,11 @@ prima che diventino incidenti. Latenza zero. Eseguito in locale. ```sh npm install -g failproofai -failproofai policies --install # o semplicemente esegui `failproofai` e accetta il prompt alla prima esecuzione +failproofai policies --install # oppure esegui semplicemente `failproofai` e accetta il prompt al primo avvio failproofai ``` -30 policy integrate si attivano immediatamente. Dashboard su `localhost:8020`. Disabilita il prompt alla prima esecuzione con `FAILPROOFAI_NO_FIRST_RUN=1`. +30 policy predefinite si attivano immediatamente. Dashboard disponibile su `localhost:8020`. Disabilita il prompt al primo avvio con `FAILPROOFAI_NO_FIRST_RUN=1`. --- @@ -104,16 +104,16 @@ failproofai | `block-force-push` | `git push --force` | | `block-work-on-main` | Commit, merge, rebase su `main` / `master` | | `block-rm-rf` | Eliminazione ricorsiva di file | -| `sanitize-api-keys` | Chiavi API che perdono nel contesto dell'agente | +| `sanitize-api-keys` | API key che si perdono nel contesto dell'agente | -→ [Tutte le 30 policy integrate](https://docs.befailproof.ai/built-in-policies) +→ [Tutte le 30 policy predefinite](https://docs.befailproof.ai/built-in-policies) --- -## Le tue policy +## Le tue policy personalizzate -Inserisci un file in `.failproofai/policies/` — si carica automaticamente, nessun flag necessario. -Esegui il commit e tutto il team lo avrà al prossimo pull. +Rilascia un file in `.failproofai/policies/` — viene caricato automaticamente, senza flag necessari. +Eseguine il commit e l'intero team la riceverà al prossimo pull. ```js import { customPolicies, deny, allow } from "failproofai"; @@ -123,7 +123,7 @@ customPolicies.add({ match: { events: ["PreToolUse"] }, fn: async (ctx) => { if (ctx.toolInput?.file_path?.includes("production")) - return deny("Writes to production paths are blocked."); + return deny("Le scritture su percorsi di produzione sono bloccate."); return allow(); }, }); @@ -143,9 +143,9 @@ Tre decisioni disponibili per ogni policy: ## Visibilità della sessione -Ogni chiamata di strumento che il tuo agente esegue viene registrata localmente. La dashboard mostra cosa è stato eseguito, -cosa è stato bloccato e cosa la policy ha detto all'agente — così non stai indovinando -quando qualcosa va storto. → [Guida della dashboard](https://docs.befailproof.ai/dashboard) +Ogni chiamata di tool che il tuo agente fa viene registrata localmente. Il dashboard mostra cosa è stato eseguito, +cosa è stato bloccato e cosa la policy ha comunicato all'agente — così non devi indovinare +quando qualcosa va storto. → [Guida al dashboard](https://docs.befailproof.ai/dashboard) --- @@ -153,32 +153,32 @@ quando qualcosa va storto. → [Guida della dashboard](https://docs.befailproof. | | | |---|---| -| [Getting Started](https://docs.befailproof.ai/getting-started) | Installazione e primi passi | -| [Built-in Policies](https://docs.befailproof.ai/built-in-policies) | Tutte le 30 policy con parametri | -| [Custom Policies](https://docs.befailproof.ai/custom-policies) | Scrivi le tue | -| [Configuration](https://docs.befailproof.ai/configuration) | Ambiti di configurazione e regole di merge | -| [Dashboard](https://docs.befailproof.ai/dashboard) | Monitor della sessione e attività della policy | -| [Architecture](https://docs.befailproof.ai/architecture) | Come funziona il sistema di hook | +| [Iniziare](https://docs.befailproof.ai/getting-started) | Installazione e primi passi | +| [Policy predefinite](https://docs.befailproof.ai/built-in-policies) | Tutte le 30 policy con parametri | +| [Policy personalizzate](https://docs.befailproof.ai/custom-policies) | Scrivi le tue | +| [Configurazione](https://docs.befailproof.ai/configuration) | Ambiti di configurazione e regole di merge | +| [Dashboard](https://docs.befailproof.ai/dashboard) | Monitor di sessione e attività delle policy | +| [Architettura](https://docs.befailproof.ai/architecture) | Come funziona il sistema di hook | --- ## Licenza -MIT con [Commons Clause](https://commonsclause.com/) — gratuito per uso interno e personale; la rivendita commerciale di failproofai richiede un accordo separato. Vedi [LICENSE](./LICENSE) per il testo completo. +MIT con [Commons Clause](https://commonsclause.com/) — gratuito per uso interno e personale; la rivendita commerciale di failproofai stesso richiede un accordo separato. Consulta [LICENSE](./LICENSE) per il testo completo. --- ## Contribuire -Vedi [CONTRIBUTING.md](./CONTRIBUTING.md). Sono benvenute nuove policy, casi limite e traduzioni. +Consulta [CONTRIBUTING.md](./CONTRIBUTING.md). Nuove policy, casi limite e traduzioni sono tutti benvenuti. > **Compila prima di iniziare.** Esegui `bun install && bun run build` per primo. Questo repository esegue -> i propri hook di failproofai su se stesso, e risolvono l'import `failproofai` nel bundle -> compilato `dist/` — senza una compilazione otterrai errori di hook `Cannot find package 'failproofai'`. -> Ricompila dopo aver modificato `src/`. Vedi -> [Build before the in-repo dev hooks will work](./CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work). +> gli hook di failproofai su se stesso e risolvono l'import di `failproofai` rispetto al +> bundle compilato `dist/` — senza una compilazione riceverai errori di hook `Cannot find package 'failproofai'`. +> Ricompila dopo aver modificato `src/`. Consulta +> [Compilare prima che gli hook di sviluppo in-repo funzionino](./CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work). --- -Creato da [Nivedit Jain](https://github.com/NiveditJain) e [Nikita Agarwal](https://github.com/nk-ag). +Costruito da [Nivedit Jain](https://github.com/NiveditJain) e [Nikita Agarwal](https://github.com/nk-ag). [befailproof.ai](https://befailproof.ai) diff --git a/docs/i18n/README.ja.md b/docs/i18n/README.ja.md index b468ecbf..2bc537d2 100644 --- a/docs/i18n/README.ja.md +++ b/docs/i18n/README.ja.md @@ -17,9 +17,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 にフックして、ループ・危険な操作・シークレットの漏洩を +インシデントになる前に検出します。レイテンシーゼロ。ローカル実行。 @@ -80,7 +80,7 @@ Claude Code および Codex にフックし、ループや危険な操作、シ

-> 1つまたは複数の組み合わせでフックをインストールできます: `failproofai policies --install --cli opencode pi gemini`（または `--cli claude codex copilot cursor opencode pi gemini`）。`--cli` を省略すると、インストール済みの CLI を自動検出してプロンプトを表示します。 +> 1つまたは任意の組み合わせでフックをインストールできます: `failproofai policies --install --cli opencode pi gemini`（または `--cli claude codex copilot cursor opencode pi gemini`）。`--cli` を省略すると、インストール済み CLI を自動検出してプロンプトを表示します。 --- @@ -88,32 +88,32 @@ Claude Code および Codex にフックし、ループや危険な操作、シ ```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-work-on-main` | `main` / `master` へのコミット・マージ・リベース | | `block-rm-rf` | 再帰的なファイル削除 | -| `sanitize-api-keys` | エージェントコンテキストへの API キー漏洩 | +| `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"; @@ -129,13 +129,13 @@ customPolicies.add({ }); ``` -各ポリシーで使用できる3つの判断: +すべてのポリシーで使用できる 3 種類の判定: -| 判断 | 効果 | +| 判定 | 効果 | |---|---| | `allow()` | 操作を許可する | -| `deny(message)` | ブロックする — メッセージがエージェントに返される | -| `instruct(message)` | 通過させるが、エージェントの次のプロンプトにコンテキストを追加する | +| `deny(message)` | 操作をブロックし、メッセージをエージェントに返す | +| `instruct(message)` | 操作を通過させ、エージェントの次のプロンプトにコンテキストを追加する | → [カスタムポリシーガイド](https://docs.befailproof.ai/custom-policies) @@ -143,7 +143,7 @@ customPolicies.add({ ## セッションの可視化 -エージェントが行うすべてのツール呼び出しはローカルに記録されます。ダッシュボードでは、実行された内容、ブロックされた内容、ポリシーがエージェントに伝えた内容を確認できます。問題が発生したとき、原因を推測する必要はありません。→ [ダッシュボードガイド](https://docs.befailproof.ai/dashboard) +エージェントが行ったすべてのツール呼び出しはローカルに記録されます。ダッシュボードには実行内容・ブロックされた操作・ポリシーがエージェントに伝えた内容が表示されるため、問題発生時に推測で対処する必要がありません。→ [ダッシュボードガイド](https://docs.befailproof.ai/dashboard) --- @@ -152,8 +152,8 @@ 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) | パラメーター付き全 30 ポリシー | +| [カスタムポリシー](https://docs.befailproof.ai/custom-policies) | 独自ポリシーの作成方法 | | [設定](https://docs.befailproof.ai/configuration) | 設定スコープとマージルール | | [ダッシュボード](https://docs.befailproof.ai/dashboard) | セッションモニターとポリシーアクティビティ | | [アーキテクチャ](https://docs.befailproof.ai/architecture) | フックシステムの仕組み | @@ -162,17 +162,17 @@ customPolicies.add({ ## ライセンス -MIT with [Commons Clause](https://commonsclause.com/) — 社内利用および個人利用は無料。failproofai 自体の商業的再販には別途契約が必要です。全文は [LICENSE](./LICENSE) をご覧ください。 +MIT with [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/` を変更した後は再ビルドしてください。詳細は [リポジトリ内の開発用フックを動かす前にビルドする](./CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work) を参照してください。 +> **開発を始める前にビルドしてください。** 最初に `bun install && bun run build` を実行してください。このリポジトリは failproofai 自身のフックを自身に対して実行しており、`failproofai` のインポートはコンパイル済みの `dist/` バンドルに対して解決されます。ビルドなしで実行すると `Cannot find package 'failproofai'` というフックエラーが発生します。`src/` を変更した後は再ビルドしてください。詳細は [リポジトリ内の開発フックを動作させるためのビルド手順](./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) diff --git a/docs/i18n/README.ko.md b/docs/i18n/README.ko.md index 07786d5d..eef6584e 100644 --- a/docs/i18n/README.ko.md +++ b/docs/i18n/README.ko.md @@ -17,9 +17,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에 연동됩니다. 루프, 위험한 동작, 시크릿 유출을 -인시던트가 되기 전에 포착합니다. 지연 없음. 로컬에서 실행됩니다. +인시던트가 되기 전에 차단합니다. 지연 시간 없음. 로컬에서 실행. @@ -29,7 +29,7 @@ Claude Code 및 Codex에 연동됩니다. 루프, 위험한 동작, 시크릿 --- -## 지원되는 에이전트 CLI +## 지원하는 에이전트 CLI

@@ -80,7 +80,7 @@ Claude Code 및 Codex에 연동됩니다. 루프, 위험한 동작, 시크릿

-> 하나 또는 여러 CLI에 훅을 설치하려면: `failproofai policies --install --cli opencode pi gemini` (또는 `--cli claude codex copilot cursor opencode pi gemini`). `--cli`를 생략하면 설치된 CLI를 자동으로 감지하고 프롬프트가 표시됩니다. +> 하나 또는 원하는 조합으로 훅을 설치하세요: `failproofai policies --install --cli opencode pi gemini` (또는 `--cli claude codex copilot cursor opencode pi gemini`). `--cli`를 생략하면 설치된 CLI를 자동으로 감지하고 선택을 묻습니다. --- @@ -88,15 +88,15 @@ Claude Code 및 Codex에 연동됩니다. 루프, 위험한 동작, 시크릿 ```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`을 설정하세요. --- -## 차단 항목 +## 차단하는 항목 | 정책 | 차단 내용 | |---|---| @@ -106,14 +106,14 @@ failproofai | `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/` 폴더에 파일을 추가하면 별도 설정 없이 자동으로 로드됩니다. +커밋하면 팀 전체가 다음 pull 시 적용받습니다. ```js import { customPolicies, deny, allow } from "failproofai"; @@ -131,21 +131,21 @@ customPolicies.add({ 모든 정책에서 사용할 수 있는 세 가지 결정: -| 결정 | 효과 | +| 결정 | 동작 | |---|---| | `allow()` | 작업 허용 | | `deny(message)` | 차단 — 메시지가 에이전트에게 반환됨 | -| `instruct(message)` | 통과시키되, 에이전트의 다음 프롬프트에 컨텍스트 추가 | +| `instruct(message)` | 통과 허용, 단 에이전트의 다음 프롬프트에 컨텍스트 추가 | -→ [사용자 정의 정책 가이드](https://docs.befailproof.ai/custom-policies) +→ [커스텀 정책 가이드](https://docs.befailproof.ai/custom-policies) --- ## 세션 가시성 -에이전트가 수행하는 모든 도구 호출은 로컬에 기록됩니다. 대시보드에서 실행된 항목, -차단된 항목, 정책이 에이전트에게 전달한 내용을 확인할 수 있어 — 문제가 발생했을 때 -추측하지 않아도 됩니다. → [대시보드 가이드](https://docs.befailproof.ai/dashboard) +에이전트가 실행하는 모든 도구 호출이 로컬에 기록됩니다. 대시보드에서 실행된 내용, +차단된 내용, 정책이 에이전트에게 전달한 내용을 확인할 수 있어 — 문제가 발생했을 때 +추측에 의존할 필요가 없습니다. → [대시보드 가이드](https://docs.befailproof.ai/dashboard) --- @@ -154,29 +154,29 @@ 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) | 파라미터를 포함한 30개 정책 전체 | +| [커스텀 정책](https://docs.befailproof.ai/custom-policies) | 직접 작성하기 | | [설정](https://docs.befailproof.ai/configuration) | 설정 범위 및 병합 규칙 | | [대시보드](https://docs.befailproof.ai/dashboard) | 세션 모니터 및 정책 활동 | -| [아키텍처](https://docs.befailproof.ai/architecture) | 훅 시스템 동작 방식 | +| [아키텍처](https://docs.befailproof.ai/architecture) | 훅 시스템 동작 원리 | --- ## 라이선스 -MIT에 [Commons Clause](https://commonsclause.com/) 적용 — 내부 및 개인 사용은 무료이며, failproofai 자체의 상업적 재판매는 별도 계약이 필요합니다. 전문은 [LICENSE](./LICENSE)를 참고하세요. +[Commons Clause](https://commonsclause.com/)가 포함된 MIT 라이선스 — 내부 및 개인 사용은 무료이며, failproofai 자체의 상업적 재판매는 별도 계약이 필요합니다. 전문은 [LICENSE](./LICENSE)를 참고하세요. --- -## 기여 +## 기여하기 [CONTRIBUTING.md](./CONTRIBUTING.md)를 참고하세요. 새로운 정책, 엣지 케이스, 번역 모두 환영합니다. -> **시작 전에 빌드하세요.** 먼저 `bun install && bun run build`를 실행하세요. 이 저장소는 -> failproofai의 자체 훅을 자신에게 적용하며, `failproofai` 임포트를 컴파일된 `dist/` 번들에서 -> 해석합니다 — 빌드 없이 시작하면 `Cannot find package 'failproofai'` 훅 오류가 발생합니다. -> `src/` 변경 후에는 다시 빌드하세요. 자세한 내용은 -> [빌드 전에 인-레포 개발 훅이 작동하지 않습니다](./CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work)를 참고하세요. +> **시작하기 전에 빌드하세요.** 먼저 `bun install && bun run build`를 실행하세요. 이 저장소는 +> failproofai 자체 훅을 스스로에게 적용하며, `failproofai` 임포트를 컴파일된 `dist/` 번들로 +> 해석합니다 — 빌드 없이는 `Cannot find package 'failproofai'` 훅 오류가 발생합니다. +> `src/`를 수정한 후에는 다시 빌드하세요. 자세한 내용은 +> [저장소 내 개발 훅이 동작하려면 빌드가 먼저입니다](./CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work)를 참고하세요. --- diff --git a/docs/i18n/README.pt-br.md b/docs/i18n/README.pt-br.md index 9300bc83..124aa8e2 100644 --- a/docs/i18n/README.pt-br.md +++ b/docs/i18n/README.pt-br.md @@ -18,8 +18,8 @@ **Traduções:** [简体中文](./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) **Resolução de falhas em tempo de execução para agentes de código.** -Se integra ao Claude Code e ao Codex. Detecta loops, ações perigosas e vazamentos de segredos -antes que se tornem incidentes. Zero latência. Executa localmente. +Integra-se ao Claude Code e ao Codex. Detecta loops, ações perigosas e vazamentos de segredos +antes que se tornem incidentes. Latência zero. Roda localmente. @@ -80,7 +80,7 @@ antes que se tornem incidentes. Zero latência. Executa localmente.

-> Instale hooks para um ou qualquer combinação: `failproofai policies --install --cli opencode pi gemini` (ou `--cli claude codex copilot cursor opencode pi gemini`). Omita `--cli` para detectar automaticamente as CLIs instaladas e receber uma solicitação de confirmação. +> Instale hooks para um ou qualquer combinação: `failproofai policies --install --cli opencode pi gemini` (ou `--cli claude codex copilot cursor opencode pi gemini`). Omita `--cli` para detectar automaticamente as CLIs instaladas e ser guiado por um prompt. --- @@ -92,11 +92,11 @@ failproofai policies --install # ou simplesmente execute `failproofai` e aceit failproofai ``` -30 políticas integradas são ativadas imediatamente. Dashboard disponível em `localhost:8020`. Desative o prompt da primeira execução com `FAILPROOFAI_NO_FIRST_RUN=1`. +30 políticas integradas são ativadas imediatamente. Dashboard em `localhost:8020`. Desative o prompt da primeira execução com `FAILPROOFAI_NO_FIRST_RUN=1`. --- -## O que ele bloqueia +## O que é bloqueado | Política | O que bloqueia | |---|---| @@ -104,7 +104,7 @@ failproofai | `block-force-push` | `git push --force` | | `block-work-on-main` | Commits, merges e rebases em `main` / `master` | | `block-rm-rf` | Exclusão recursiva de arquivos | -| `sanitize-api-keys` | Chaves de API vazando para o contexto do agente | +| `sanitize-api-keys` | Vazamento de chaves de API para o contexto do agente | → [Todas as 30 políticas integradas](https://docs.befailproof.ai/built-in-policies) @@ -112,8 +112,8 @@ failproofai ## Suas próprias políticas -Coloque um arquivo em `.failproofai/policies/` — ele é carregado automaticamente, sem flags necessárias. -Faça commit e toda a equipe receberá na próxima atualização. +Coloque um arquivo em `.failproofai/policies/` — ele é carregado automaticamente, sem necessidade de flags. +Faça o commit e toda a equipe receberá a política no próximo pull. ```js import { customPolicies, deny, allow } from "failproofai"; @@ -134,7 +134,7 @@ Três decisões disponíveis para cada política: | Decisão | Efeito | |---|---| | `allow()` | Permite a operação | -| `deny(message)` | Bloqueia — a mensagem é retornada ao agente | +| `deny(message)` | Bloqueia — a mensagem é enviada de volta ao agente | | `instruct(message)` | Deixa passar, mas adiciona contexto ao próximo prompt do agente | → [Guia de políticas personalizadas](https://docs.befailproof.ai/custom-policies) @@ -144,8 +144,8 @@ Três decisões disponíveis para cada política: ## Visibilidade da sessão Cada chamada de ferramenta feita pelo seu agente é registrada localmente. O dashboard mostra o que foi executado, -o que foi bloqueado e o que a política informou ao agente — para que você não fique no escuro -quando algo der errado. → [Guia do dashboard](https://docs.befailproof.ai/dashboard) +o que foi bloqueado e o que a política comunicou ao agente — para que você não fique no escuro +quando algo der errado. → [Guia do Dashboard](https://docs.befailproof.ai/dashboard) --- @@ -153,7 +153,7 @@ quando algo der errado. → [Guia do dashboard](https://docs.befailproof.ai/dash | | | |---|---| -| [Primeiros Passos](https://docs.befailproof.ai/getting-started) | Instalação e configuração inicial | +| [Primeiros Passos](https://docs.befailproof.ai/getting-started) | Instalação e primeiros passos | | [Políticas Integradas](https://docs.befailproof.ai/built-in-policies) | Todas as 30 políticas com parâmetros | | [Políticas Personalizadas](https://docs.befailproof.ai/custom-policies) | Escreva as suas próprias | | [Configuração](https://docs.befailproof.ai/configuration) | Escopos de configuração e regras de mesclagem | @@ -172,10 +172,10 @@ MIT com [Commons Clause](https://commonsclause.com/) — gratuito para uso inter Consulte [CONTRIBUTING.md](./CONTRIBUTING.md). Novas políticas, casos extremos e traduções são bem-vindos. -> **Faça o build antes de começar.** Execute `bun install && bun run build` primeiro. Este repositório executa -> os próprios hooks do failproofai sobre si mesmo, e eles resolvem o import do `failproofai` contra o -> bundle compilado em `dist/` — sem um build você receberá erros de hook `Cannot find package 'failproofai'`. -> Refaça o build após alterar `src/`. Consulte +> **Faça o build antes de começar.** Execute `bun install && bun run build` primeiro. Este repositório roda +> os próprios hooks do failproofai sobre si mesmo, e eles resolvem o import `failproofai` em relação ao +> bundle compilado em `dist/` — sem um build, você receberá erros de hook como `Cannot find package 'failproofai'`. +> Refaça o build após alterar `src/`. Veja > [Build before the in-repo dev hooks will work](./CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work). --- diff --git a/docs/i18n/README.ru.md b/docs/i18n/README.ru.md index f4985ddc..d921b86e 100644 --- a/docs/i18n/README.ru.md +++ b/docs/i18n/README.ru.md @@ -17,9 +17,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. Перехватывает бесконечные циклы, опасные действия и утечки секретов +прежде, чем они станут инцидентами. Нулевая задержка. Работает локально. @@ -80,7 +80,7 @@

-> Установите хуки для одного или любой комбинации: `failproofai policies --install --cli opencode pi gemini` (или `--cli claude codex copilot cursor opencode pi gemini`). Пропустите `--cli` для автоопределения установленных CLI и запроса. +> Установите hooks для одного или нескольких: `failproofai policies --install --cli opencode pi gemini` (или `--cli claude codex copilot cursor opencode pi gemini`). Пропустите `--cli` для автоматического определения установленных CLI и подтверждения. --- @@ -88,32 +88,32 @@ ```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-push-master` | Прямые push в `main` / `master` | | `block-force-push` | `git push --force` | -| `block-work-on-main` | Коммиты, слияния, переводы базы на `main` / `master` | +| `block-work-on-main` | Commits, merges, rebases на `main` / `master` | | `block-rm-rf` | Рекурсивное удаление файлов | -| `sanitize-api-keys` | Утечки ключей API в контекст агента | +| `sanitize-api-keys` | Утечки API ключей в контекст агента | → [Все 30 встроенных политик](https://docs.befailproof.ai/built-in-policies) --- -## Ваши собственные политики +## Собственные политики -Поместите файл в `.failproofai/policies/` — он загружается автоматически, никаких флагов не требуется. -Закоммитьте его, и вся команда получит его при следующем пуле. +Поместите файл в `.failproofai/policies/` — он загружается автоматически без дополнительных флагов. +Заcommitьте его, и вся команда получит обновление при следующем pull. ```js import { customPolicies, deny, allow } from "failproofai"; @@ -129,23 +129,23 @@ customPolicies.add({ }); ``` -Три решения доступны каждой политике: +Три решения доступны для каждой политики: | Решение | Эффект | |---|---| | `allow()` | Разрешить операцию | -| `deny(message)` | Заблокировать её — сообщение передается обратно агенту | -| `instruct(message)` | Пропустить, но добавить контекст в следующий запрос агента | +| `deny(message)` | Заблокировать — сообщение вернётся агенту | +| `instruct(message)` | Пропустить, но добавить контекст в следующий prompt агента | → [Руководство по пользовательским политикам](https://docs.befailproof.ai/custom-policies) --- -## Видимость сессии +## Видимость сеанса -Каждый вызов инструмента, который делает ваш агент, логируется локально. Панель управления показывает, что работало, -что было заблокировано и что политика сообщила агенту — так что вы не гадаете, -когда что-то идет не так. → [Руководство по панели управления](https://docs.befailproof.ai/dashboard) +Каждый вызов инструмента, который делает ваш агент, логируется локально. Панель управления показывает, что запустилось, +что было заблокировано и что политика сказала агенту — так что вы не гадаете, +когда что-то идёт не так. → [Руководство по панели управления](https://docs.befailproof.ai/dashboard) --- @@ -155,10 +155,10 @@ 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/configuration) | Области конфигурации и правила слияния | -| [Панель управления](https://docs.befailproof.ai/dashboard) | Монитор сессии и активность политик | -| [Архитектура](https://docs.befailproof.ai/architecture) | Как работает система хуков | +| [Пользовательские политики](https://docs.befailproof.ai/custom-policies) | Напишите свои собственные | +| [Конфигурация](https://docs.befailproof.ai/configuration) | Области конфигурации и правила объединения | +| [Панель управления](https://docs.befailproof.ai/dashboard) | Мониторинг сеанса и активность политик | +| [Архитектура](https://docs.befailproof.ai/architecture) | Как работает система hooks | --- @@ -168,11 +168,12 @@ MIT с [Commons Clause](https://commonsclause.com/) — бесплатно дл --- -## Участие в разработке +## Вклад -См. [CONTRIBUTING.md](./CONTRIBUTING.md). Приветствуются новые политики, граничные случаи и переводы. +См. [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). +> **Сначала выполните сборку.** Запустите `bun install && bun run build`. Этот репозиторий запускает собственные hooks failproofai на себе, и они разрешают импорт `failproofai` относительно скомпилированного пакета `dist/` — без сборки вы получите ошибки hooks `Cannot find package 'failproofai'`. Пересоберите после изменений в `src/`. See +> [Build before the in-repo dev hooks will work](./CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work). --- diff --git a/docs/i18n/README.tr.md b/docs/i18n/README.tr.md index 914079e2..1a7c50c5 100644 --- a/docs/i18n/README.tr.md +++ b/docs/i18n/README.tr.md @@ -17,9 +17,9 @@ **Çeviriler:** [简体中文](./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) -**Kodlama ajanları için çalışma zamanı hatası çözümü.** -Claude Code ve Codex'e bağlanır. Döngüleri, tehlikeli işlemleri ve gizli sızıntılarını -olay haline gelmeden önce yakalar. Sıfır gecikme. Yerel olarak çalışır. +**Kodlama ajanları için runtime hata çözümü.** +Claude Code ve Codex ile entegrasyon. Döngüleri, tehlikeli işlemleri ve gizli bilgilerin sızmasını +bunlar sorun olmadan önce yakalar. Sıfır gecikme. Yerel olarak çalışır. @@ -29,7 +29,7 @@ olay haline gelmeden önce yakalar. Sıfır gecikme. Yerel olarak çalışır. --- -## Desteklenen ajan CLI'ları +## Desteklenen ajan CLIleri

@@ -80,29 +80,29 @@ olay haline gelmeden önce yakalar. Sıfır gecikme. Yerel olarak çalışır.

-> Bir veya birden fazla kombinasyon için kancaları yükleyin: `failproofai policies --install --cli opencode pi gemini` (ya da `--cli claude codex copilot cursor opencode pi gemini`). Yüklü CLI'ları otomatik olarak algılamak ve seçim yapmak için `--cli` seçeneğini atlayın. +> Hook'ları bir veya birkaç kombinasyon için yükleyin: `failproofai policies --install --cli opencode pi gemini` (veya `--cli claude codex copilot cursor opencode pi gemini`). Kurulu CLIleri otomatik olarak algılamak ve seçim yapmak için `--cli` parametresini ihmal edin. --- -## Kurulum +## Yükleme ```sh npm install -g failproofai -failproofai policies --install # veya sadece `failproofai` komutunu çalıştırıp ilk çalıştırma komutunu kabul edin +failproofai policies --install # veya sadece `failproofai` komutunu çalıştırın ve ilk çalıştırma istemini kabul edin failproofai ``` -30 yerleşik politika hemen etkinleştirilir. Kontrol paneli `localhost:8020` adresindedir. İlk çalıştırma komutunu `FAILPROOFAI_NO_FIRST_RUN=1` ile devre dışı bırakın. +30 yerleşik politika hemen etkinleşir. Pano adresinde `localhost:8020` bulunur. İlk çalıştırma istemini `FAILPROOFAI_NO_FIRST_RUN=1` ile devre dışı bırakabilirsiniz. --- -## Neyi engeller +## Neyi durdurur -| Politika | Engellediği şey | +| Politika | Neyi engeller | |---|---| -| `block-push-master` | `main` / `master` dalına doğrudan gönderimler | -| `block-force-push` | `git push --force` | -| `block-work-on-main` | `main` / `master` dalında işlemler, birleştirmeler, yeniden tabanlama | +| `block-push-master` | `main` / `master` dalına doğrudan push işlemleri | +| `block-force-push` | `git push --force` komutu | +| `block-work-on-main` | `main` / `master` dalında commit, merge, rebase işlemleri | | `block-rm-rf` | Özyinelemeli dosya silme | | `sanitize-api-keys` | API anahtarlarının ajan bağlamına sızması | @@ -112,8 +112,8 @@ failproofai ## Kendi politikalarınız -`.failproofai/policies/` klasörüne bir dosya bırakın — bayrak gerekmeksizin otomatik olarak yüklenecektir. -Bunu işleyin ve bütün takım bir sonraki çekme operasyonunda bunu alacaktır. +`.failproofai/policies/` klasörüne bir dosya koyun — otomatik olarak yüklenir, bayrak gerekmez. +Commit edin ve tüm takım bir sonraki pull'da bunu alır. ```js import { customPolicies, deny, allow } from "failproofai"; @@ -123,7 +123,7 @@ customPolicies.add({ match: { events: ["PreToolUse"] }, fn: async (ctx) => { if (ctx.toolInput?.file_path?.includes("production")) - return deny("Üretim yollarına yazma işlemleri engellenir."); + return deny("Writes to production paths are blocked."); return allow(); }, }); @@ -134,18 +134,18 @@ Her politika için üç karar mevcuttur: | Karar | Etki | |---|---| | `allow()` | İşleme izin ver | -| `deny(message)` | Engelle — ileti ajana geri gönderilir | -| `instruct(message)` | Geçit ver, ancak ajanın sonraki isteminine bağlam ekle | +| `deny(message)` | Engelle — mesaj ajana geri gönderilir | +| `instruct(message)` | Geçişe izin ver, ama ajana bir sonraki komutuna bağlam ekle | -→ [Özel politikalar rehberi](https://docs.befailproof.ai/custom-policies) +→ [Özel politikalar kılavuzu](https://docs.befailproof.ai/custom-policies) --- ## Oturum görünürlüğü -Ajanınızın yaptığı her araç çağrısı yerel olarak kaydedilir. Kontrol paneli, ne çalıştığını, -ne engellendi ve politikanın ajana ne söylediğini gösterir — böylece bir şey yanlış gittiğinde -tahmin etmek zorunda kalmazsınız. → [Kontrol paneli rehberi](https://docs.befailproof.ai/dashboard) +Ajanınızın yaptığı her araç çağrısı yerel olarak günlüğe kaydedilir. Pano, neyin çalıştığını, +neyin engellendiğini ve politikanın ajana ne söylediğini gösterir — böylece bir şey yanlış gittiğinde +tahmin etmeniz gerekmez. → [Pano kılavuzu](https://docs.befailproof.ai/dashboard) --- @@ -153,28 +153,32 @@ tahmin etmek zorunda kalmazsınız. → [Kontrol paneli rehberi](https://docs.be | | | |---|---| -| [Başlarken](https://docs.befailproof.ai/getting-started) | Kurulum ve ilk adımlar | +| [Başlangıç](https://docs.befailproof.ai/getting-started) | Yükleme ve ilk adımlar | | [Yerleşik Politikalar](https://docs.befailproof.ai/built-in-policies) | Tüm 30 politika ve parametreleri | | [Özel Politikalar](https://docs.befailproof.ai/custom-policies) | Kendi politikalarınızı yazın | | [Yapılandırma](https://docs.befailproof.ai/configuration) | Yapılandırma kapsamları ve birleştirme kuralları | -| [Kontrol Paneli](https://docs.befailproof.ai/dashboard) | Oturum monitörü ve politika etkinliği | -| [Mimari](https://docs.befailproof.ai/architecture) | Kanca sisteminin nasıl çalıştığı | +| [Pano](https://docs.befailproof.ai/dashboard) | Oturum izleyici ve politika aktivitesi | +| [Mimari](https://docs.befailproof.ai/architecture) | Hook sistemi nasıl çalışır | --- ## Lisans -Commons Clause ile MIT — dahili ve kişisel kullanım için ücretsiz; failproofai'nin kendisinin ticari olarak yeniden satışı ayrı bir anlaşma gerektirir. Tam metin için [LICENSE](./LICENSE) dosyasına bakın. +MIT with [Commons Clause](https://commonsclause.com/) — dahili ve kişisel kullanım için ücretsiz; failproofai'nin ticari yeniden satışı ayrı bir anlaşma gerektirir. Tam metin için [LICENSE](./LICENSE) bölümüne bakın. --- -## Katkıda bulunma +## Katkıda Bulunma -[CONTRIBUTING.md](./CONTRIBUTING.md) dosyasına bakın. Yeni politikalar, kenar durumları ve çeviriler hoş karşılanır. +[CONTRIBUTING.md](./CONTRIBUTING.md) bölümüne bakın. Yeni politikalar, kenar durumları ve çeviriler her zaman hoş karşılanır. -> **Başlamadan önce derleyin.** Önce `bun install && bun run build` komutunu çalıştırın. Bu depo failproofai'nin kendi kancalarını kendisine uyguluyor ve `failproofai` içe aktarımını derlenmiş `dist/` paketi ile çözüyor — derleme olmaksızın `Cannot find package 'failproofai'` kanca hataları alacaksınız. `src/` değişikliklerinden sonra yeniden derleyin. Bkz. [In-repo dev hooks'larının çalışması için önce derleyin](./CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work). +> **Başlamadan önce derleyin.** Önce `bun install && bun run build` komutunu çalıştırın. Bu repo, +> failproofai'nin kendi hook'larını kendisinde çalıştırır ve `failproofai` importunu +> derlenmiş `dist/` paketi ile çözer — derleme olmadan `Cannot find package 'failproofai'` +> hook hataları alırsınız. `src/` dosyalarında değişiklik yaptıktan sonra yeniden derleyin. Bkz. +> [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) ve [Nikita Agarwal](https://github.com/nk-ag) tarafından yapılmıştır. +[Nivedit Jain](https://github.com/NiveditJain) ve [Nikita Agarwal](https://github.com/nk-ag) tarafından yapıldı. [befailproof.ai](https://befailproof.ai) diff --git a/docs/i18n/README.vi.md b/docs/i18n/README.vi.md index 06d977cf..aead6a3c 100644 --- a/docs/i18n/README.vi.md +++ b/docs/i18n/README.vi.md @@ -17,8 +17,8 @@ **Bản dịch:** [简体中文](./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) -**Giải pháp xử lý lỗi thời gian chạy cho các agent lập trình.** -Kết hợp với Claude Code và Codex. Bắt các vòng lặp, hành động nguy hiểm và rò rỉ bí mật +**Giải pháp xử lý lỗi trong thời gian chạy cho các agent lập trình.** +Kết hợp với Claude Code và Codex. Phát hiện vòng lặp, hành động nguy hiểm và rò rỉ bí mật trước khi chúng trở thành sự cố. Độ trễ bằng không. Chạy cục bộ. @@ -80,7 +80,7 @@ trước khi chúng trở thành sự cố. Độ trễ bằng không. Chạy c

-> Cài đặt hook cho một hoặc bất kỳ sự kết hợp nào: `failproofai policies --install --cli opencode pi gemini` (hoặc `--cli claude codex copilot cursor opencode pi gemini`). Bỏ qua `--cli` để tự động phát hiện các CLI được cài đặt và nhắc lựa chọn. +> Cài đặt hook cho một hoặc nhiều: `failproofai policies --install --cli opencode pi gemini` (hoặc `--cli claude codex copilot cursor opencode pi gemini`). Bỏ qua `--cli` để tự động phát hiện các CLI được cài đặt và nhắc lựa chọn. --- @@ -92,7 +92,7 @@ failproofai policies --install # hoặc chỉ cần chạy `failproofai` và c failproofai ``` -30 chính sách tích hợp sẵn kích hoạt ngay lập tức. Bảng điều khiển tại `localhost:8020`. Vô hiệu hóa lời nhắc lần đầu với `FAILPROOFAI_NO_FIRST_RUN=1`. +30 chính sách tích hợp được kích hoạt ngay lập tức. Bảng điều khiển tại `localhost:8020`. Vô hiệu hóa lời nhắc lần đầu bằng `FAILPROOFAI_NO_FIRST_RUN=1`. --- @@ -100,20 +100,20 @@ failproofai | Chính sách | Những gì nó chặn | |---|---| -| `block-push-master` | Push trực tiếp đến `main` / `master` | +| `block-push-master` | Đẩy trực tiếp đến `main` / `master` | | `block-force-push` | `git push --force` | | `block-work-on-main` | Commit, merge, rebase trên `main` / `master` | | `block-rm-rf` | Xóa tệp đệ quy | -| `sanitize-api-keys` | Khóa API rò rỉ vào ngữ cảnh agent | +| `sanitize-api-keys` | API key rò rỉ vào ngữ cảnh agent | -→ [Tất cả 30 chính sách tích hợp sẵn](https://docs.befailproof.ai/built-in-policies) +→ [Tất cả 30 chính sách tích hợp](https://docs.befailproof.ai/built-in-policies) --- ## Chính sách của riêng bạn -Thả một tệp vào `.failproofai/policies/` — nó tải tự động, không cần cờ. -Commit nó và toàn bộ đội sẽ nhận được nó vào lần kéo tiếp theo. +Thả một tệp vào `.failproofai/policies/` — nó tải tự động, không cần cờ nào. +Commit nó và toàn bộ nhóm sẽ nhận được nó ở lần kéo tiếp theo. ```js import { customPolicies, deny, allow } from "failproofai"; @@ -129,23 +129,23 @@ customPolicies.add({ }); ``` -Ba quyết định có sẵn cho mỗi chính sách: +Ba quyết định có sẵn cho mọi chính sách: -| Quyết định | Tác dụng | +| Quyết định | Hiệu ứng | |---|---| | `allow()` | Cho phép hoạt động | -| `deny(message)` | Chặn nó — thông báo quay lại agent | -| `instruct(message)` | Cho nó qua, nhưng thêm ngữ cảnh vào lời nhắc tiếp theo của agent | +| `deny(message)` | Chặn nó — thông báo quay trở lại agent | +| `instruct(message)` | Để nó tiếp tục, nhưng thêm ngữ cảnh vào lời nhắc tiếp theo của agent | → [Hướng dẫn chính sách tùy chỉnh](https://docs.befailproof.ai/custom-policies) --- -## Khả năng hiển thị phiên +## Tính nhìn thấy phiên -Mọi cuộc gọi công cụ mà agent của bạn thực hiện đều được ghi lại cục bộ. Bảng điều khiển hiển thị những gì đã chạy, -những gì bị chặn và những gì chính sách đã nói với agent — vì vậy bạn không phải đoán -khi có sự cố. → [Hướng dẫn bảng điều khiển](https://docs.befailproof.ai/dashboard) +Mọi lệnh công cụ mà agent của bạn thực hiện đều được ghi nhật ký cục bộ. Bảng điều khiển hiển thị những gì đã chạy, +những gì bị chặn và những gì chính sách nói với agent — vì vậy bạn không phải đoán +khi có gì đó không ổn. → [Hướng dẫn bảng điều khiển](https://docs.befailproof.ai/dashboard) --- @@ -154,8 +154,8 @@ khi có sự cố. → [Hướng dẫn bảng điều khiển](https://docs.befa | | | |---|---| | [Bắt đầu](https://docs.befailproof.ai/getting-started) | Cài đặt và các bước đầu tiên | -| [Chính sách tích hợp sẵn](https://docs.befailproof.ai/built-in-policies) | Tất cả 30 chính sách với các tham số | -| [Chính sách tùy chỉnh](https://docs.befailproof.ai/custom-policies) | Viết chính sách của riêng bạn | +| [Chính sách tích hợp](https://docs.befailproof.ai/built-in-policies) | Tất cả 30 chính sách với tham số | +| [Chính sách tùy chỉnh](https://docs.befailproof.ai/custom-policies) | Viết của riêng bạn | | [Cấu hình](https://docs.befailproof.ai/configuration) | Phạm vi cấu hình và quy tắc hợp nhất | | [Bảng điều khiển](https://docs.befailproof.ai/dashboard) | Giám sát phiên và hoạt động chính sách | | [Kiến trúc](https://docs.befailproof.ai/architecture) | Cách hệ thống hook hoạt động | @@ -164,18 +164,18 @@ khi có sự cố. → [Hướng dẫn bảng điều khiển](https://docs.befa ## Giấy phép -MIT với [Commons Clause](https://commonsclause.com/) — miễn phí cho mục đích nội bộ và cá nhân; bán lại thương mại của failproofai yêu cầu thỏa thuận riêng. Xem [LICENSE](./LICENSE) để xem toàn bộ văn bản. +MIT với [Commons Clause](https://commonsclause.com/) — miễn phí cho sử dụng nội bộ và cá nhân; tái bán thương mại của failproofai cần thỏa thuận riêng. Xem [LICENSE](./LICENSE) để xem toàn bộ văn bản. --- ## Đóng góp -Xem [CONTRIBUTING.md](./CONTRIBUTING.md). Các chính sách mới, trường hợp cạnh và bản dịch đều được chào đón. +Xem [CONTRIBUTING.md](./CONTRIBUTING.md). Các chính sách mới, trường hợp biên, và bản dịch đều được chào đón. -> **Build trước khi bạn bắt đầu.** Chạy `bun install && bun run build` trước. Kho lưu trữ này chạy -> các hook của failproofai trên chính nó, và chúng phân giải import `failproofai` dựa trên -> bundle `dist/` được biên dịch — nếu không build, bạn sẽ gặp lỗi -> `Cannot find package 'failproofai'` từ các hook. Rebuild sau khi thay đổi `src/`. Xem +> **Xây dựng trước khi bắt đầu.** Chạy `bun install && bun run build` trước tiên. Repository này chạy +> các hook của failproofai trên chính nó, và chúng giải quyết import `failproofai` đối với +> bundle `dist/` được biên dịch — nếu không xây dựng bạn sẽ gặp lỗi hook `Cannot find package 'failproofai'`. +> Xây dựng lại sau khi thay đổi `src/`. Xem > [Build before the in-repo dev hooks will work](./CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work). --- diff --git a/docs/i18n/README.zh.md b/docs/i18n/README.zh.md index 32e1d156..36d1e36c 100644 --- a/docs/i18n/README.zh.md +++ b/docs/i18n/README.zh.md @@ -17,8 +17,8 @@ **翻译版本：** [简体中文](./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，在死循环、危险操作和密钥泄漏演变为事故之前将其拦截。零延迟，本地运行。 @@ -79,7 +79,7 @@

-> 可为一个或多个 CLI 安装 hook：`failproofai policies --install --cli opencode pi gemini`（或 `--cli claude codex copilot cursor opencode pi gemini`）。省略 `--cli` 参数将自动检测已安装的 CLI 并提示选择。 +> 为一个或多个 CLI 安装 hook：`failproofai policies --install --cli opencode pi gemini`（或 `--cli claude codex copilot cursor opencode pi gemini`）。省略 `--cli` 参数可自动检测已安装的 CLI 并提示选择。 --- @@ -91,7 +91,7 @@ failproofai policies --install # 或直接运行 `failproofai` 并接受首次 failproofai ``` -30 条内置策略即刻生效。控制台地址：`localhost:8020`。通过设置 `FAILPROOFAI_NO_FIRST_RUN=1` 可禁用首次运行提示。 +30 条内置策略即刻生效。控制台访问地址：`localhost:8020`。可通过设置 `FAILPROOFAI_NO_FIRST_RUN=1` 禁用首次运行提示。 --- @@ -99,11 +99,11 @@ failproofai | 策略 | 拦截内容 | |---|---| -| `block-push-master` | 直接推送到 `main` / `master` 分支 | +| `block-push-master` | 直接推送至 `main` / `master` 分支 | | `block-force-push` | `git push --force` | -| `block-work-on-main` | 在 `main` / `master` 上执行提交、合并、变基 | +| `block-work-on-main` | 在 `main` / `master` 上的提交、合并、变基操作 | | `block-rm-rf` | 递归删除文件 | -| `sanitize-api-keys` | API 密钥泄露进智能体上下文 | +| `sanitize-api-keys` | 防止 API 密钥泄漏到智能体上下文中 | → [全部 30 条内置策略](https://docs.befailproof.ai/built-in-policies) @@ -111,7 +111,7 @@ failproofai ## 自定义策略 -将文件放入 `.failproofai/policies/` 目录即可自动加载，无需任何额外参数。提交到代码库后，团队所有成员在下次拉取时即可同步生效。 +将文件放入 `.failproofai/policies/` 目录即可自动加载，无需任何额外参数。将其提交到版本库，团队成员下次拉取后即可同步生效。 ```js import { customPolicies, deny, allow } from "failproofai"; @@ -132,16 +132,16 @@ 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) --- @@ -149,26 +149,26 @@ customPolicies.add({ | | | |---|---| -| [快速入门](https://docs.befailproof.ai/getting-started) | 安装与初步使用 | +| [快速开始](https://docs.befailproof.ai/getting-started) | 安装与初始配置 | | [内置策略](https://docs.befailproof.ai/built-in-policies) | 全部 30 条策略及其参数说明 | -| [自定义策略](https://docs.befailproof.ai/custom-policies) | 编写你自己的策略 | +| [自定义策略](https://docs.befailproof.ai/custom-policies) | 编写自己的策略 | | [配置说明](https://docs.befailproof.ai/configuration) | 配置作用域与合并规则 | -| [控制台](https://docs.befailproof.ai/dashboard) | 会话监控与策略活动记录 | -| [架构设计](https://docs.befailproof.ai/architecture) | Hook 系统的工作原理 | +| [控制台](https://docs.befailproof.ai/dashboard) | 会话监控与策略活动 | +| [架构](https://docs.befailproof.ai/architecture) | hook 系统的工作原理 | --- ## 许可证 -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 的 hook，这些 hook 会从编译后的 `dist/` 包中解析 `failproofai` 导入——若未先构建，将触发 `Cannot find package 'failproofai'` 的 hook 报错。修改 `src/` 后需重新构建。详见[构建说明：使仓库内开发 hook 正常工作](./CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work)。 +> **开始前请先构建项目。** 首先运行 `bun install && bun run build`。本仓库会对自身运行 failproofai 的 hook，这些 hook 会从编译后的 `dist/` 包中解析 `failproofai` 导入——若未先构建，将出现 `Cannot find package 'failproofai'` 的 hook 错误。修改 `src/` 后需重新构建。详见 [构建后仓库内开发 hook 方可正常工作](./CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work)。 ---