failproofai 0.0.6-beta.3 → 0.0.6-beta.4

package/.next/standalone/docs/i18n/README.tr.md

@@ -1,307 +0,0 @@
-> **⚠️** This is an auto-generated translation. For the latest version, see the [English README](../../README.md). Community corrections welcome!
-
-[🇺🇸 English](../../README.md) | [🇨🇳 简体中文](README.zh.md) | [🇯🇵 日本語](README.ja.md) | [🇰🇷 한국어](README.ko.md) | [🇪🇸 Español](README.es.md) | [🇧🇷 Português](README.pt-br.md) | [🇩🇪 Deutsch](README.de.md) | [🇫🇷 Français](README.fr.md) | [🇷🇺 Русский](README.ru.md) | [🇮🇳 हिन्दी](README.hi.md) | **🇹🇷 Türkçe** | [🇻🇳 Tiếng Việt](README.vi.md) | [🇮🇹 Italiano](README.it.md) | [🇸🇦 العربية](README.ar.md) | [🇮🇱 עברית](README.he.md)
-
----
-
-```
-    ______      _ __                       ____   ___    ____
-   / ____/___ _(_) /___  _________  ____  / __/  /   |  /  _/
-  / /_  / __ `/ / / __ \/ ___/ __ \/ __ \/ /_   / /| |  / /
- / __/ / /_/ / / / /_/ / /  / /_/ / /_/ / __/  / ___ |_/ /
-/_/    \__,_/_/_/ .___/_/   \____/\____/_/    /_/  |_/___/
-               /_/
-```
-
-# Failproof AI
-
-[![Docs](https://img.shields.io/badge/docs-befailproof.ai-002CA7?style=flat-square)](https://befailproof.ai)
-[![npm](https://img.shields.io/npm/v/failproofai?style=flat-square&color=CB3837)](https://www.npmjs.com/package/failproofai)
-[![License](https://img.shields.io/badge/license-MIT%20%2B%20Commons%20Clause-blue?style=flat-square)](LICENSE)
-[![CI](https://img.shields.io/github/actions/workflow/status/exospherehost/failproofai/ci.yml?branch=main&style=flat-square&label=CI)](https://github.com/exospherehost/failproofai/actions)
-[![Slack](https://img.shields.io/badge/Slack-join%20us-4A154B?style=flat-square&logo=slack)](https://join.slack.com/t/failproofai/shared_invite/zt-3v63b7k5e-O3NBHmj8X6n9gZSGDx6ggQ)
-
-**Ç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)
-
-AI aracılarınızı güvenilir, görevlerine odaklanmış ve özerk olarak çalışır durumda tutmak için politikaları yönetmenin en kolay yolu - **Claude Code** ve **Agents SDK** için.
-
-- **30 Yerleşik Politika** - Ortak ajan başarısızlık modlarını kutudan çıkar çıkmaz yakalayın. Yıkıcı komutları engelleyin, gizli sızıntılarını önleyin, ajanları proje sınırları içinde tutun, döngüleri algılayın ve daha fazlasını yapın.
-- **Özel Politikalar** - JavaScript'te kendi güvenilirlik kurallarınızı yazın. `allow`/`deny`/`instruct` API'sini kullanarak kuralları zorunlu kılın, sapmaları önleyin, işlemleri sınırlandırın veya harici sistemlerle entegre olun.
-- **Kolay Yapılandırma** - Herhangi bir politikayı kod yazmadan ayarlayın. İzin listeleri, korumalı dallar, eşikleri proje başına veya genel olarak belirleyin. Üç kapsamlı yapılandırma otomatik olarak birleşir.
-- **Ajan Monitörü** - Aracılarınızın yokken neler yaptığını görün. Oturumları inceleyin, her araç çağrısını denetleyin ve politikaların tam olarak nerede çalıştığını gözden geçirin.
-
-Her şey yerel olarak çalışır - veriler makinenizi terk etmez.
-
----
-
-## Gereksinimler
-
-- Node.js >= 20.9.0
-- Bun >= 1.3.0 (isteğe bağlı - yalnızca geliştirme / kaynaktan derleme için gerekli)
-
----
-
-## Yükleme
-
-```bash
-npm install -g failproofai
-# veya
-bun add -g failproofai
-```
-
----
-
-## Hızlı başlangıç
-
-### 1. Politikaları genel olarak etkinleştirin
-
-```bash
-failproofai policies --install
-```
-
-Hook girdilerini `~/.claude/settings.json` dosyasına yazar. Claude Code artık her araç çağrısından önce ve sonra failproofai'yi çağıracaktır.
-
-### 2. Panoyu başlatın
-
-```bash
-failproofai
-```
-
-`http://localhost:8020` adresini açar - oturumları inceleyin, günlükleri denetleyin, politikaları yönetin.
-
-### 3. Nelerin etkin olduğunu kontrol edin
-
-```bash
-failproofai policies
-```
-
----
-
-## Politika yüklemesi
-
-### Kapsamlar
-
-| Kapsam | Komut | Nereye yazıyor |
-|--------|-------|---|
-| Genel (varsayılan) | `failproofai policies --install` | `~/.claude/settings.json` |
-| Proje | `failproofai policies --install --scope project` | `.claude/settings.json` |
-| Yerel | `failproofai policies --install --scope local` | `.claude/settings.local.json` |
-
-### Belirli politikaları yükleyin
-
-```bash
-failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
-```
-
-### Politikaları kaldırın
-
-```bash
-failproofai policies --uninstall
-# veya belirli bir kapsam için:
-failproofai policies --uninstall --scope project
-```
-
----
-
-## Yapılandırma
-
-Politika yapılandırması `~/.failproofai/policies-config.json` (genel) veya projenizde `.failproofai/policies-config.json` (proje başına) dosyasında bulunur.
-
-```json
-{
-  "enabledPolicies": [
-    "block-sudo",
-    "block-rm-rf",
-    "sanitize-api-keys",
-    "block-push-master",
-    "block-env-files",
-    "block-read-outside-cwd"
-  ],
-  "policyParams": {
-    "block-sudo": {
-      "allowPatterns": ["sudo systemctl status", "sudo journalctl"],
-      "hint": "sudo olmadan apt-get'i doğrudan kullanın."
-    },
-    "block-push-master": {
-      "protectedBranches": ["main", "release", "prod"],
-      "hint": "Bunun yerine yeni bir dal oluşturmayı deneyin."
-    },
-    "sanitize-api-keys": {
-      "additionalPatterns": [
-        { "regex": "myco_[A-Za-z0-9]{32}", "label": "MyCo API anahtarı" }
-      ]
-    },
-    "warn-large-file-write": {
-      "thresholdKb": 512
-    }
-  }
-}
-```
-
-**Üç yapılandırma kapsamı** otomatik olarak birleştirilir (proje → yerel → genel). Tam birleştirme kuralları için [docs/configuration.mdx](docs/configuration.mdx) bölümüne bakın.
-
----
-
-## Yerleşik politikalar
-
-| Politika | Açıklama | Yapılandırılabilir |
-|----------|----------|:---:|
-| `block-sudo` | Ajanların ayrıcalıklı sistem komutlarını çalıştırmasını önleyin | `allowPatterns` |
-| `block-rm-rf` | Yanlışlıkla özyinelemeli dosya silmeyi önleyin | `allowPaths` |
-| `block-curl-pipe-sh` | Ajanların güvenilmeyen betikleri shell'e aktarmasını önleyin | |
-| `block-failproofai-commands` | Kendi kendine kaldırmayı önleyin | |
-| `sanitize-jwt` | JWT belirteçlerinin ajan bağlamında sızmasını durdurun | |
-| `sanitize-api-keys` | API anahtarlarının ajan bağlamında sızmasını durdurun | `additionalPatterns` |
-| `sanitize-connection-strings` | Veritabanı kimlik bilgilerinin ajan bağlamında sızmasını durdurun | |
-| `sanitize-private-key-content` | PEM özel anahtar bloklarını çıktıdan kaldırın | |
-| `sanitize-bearer-tokens` | Authorization Bearer belirteçlerini çıktıdan kaldırın | |
-| `block-env-files` | Ajanları .env dosyalarını okumasından tutun | |
-| `protect-env-vars` | Ajanların ortam değişkenlerini yazdırmasını önleyin | |
-| `block-read-outside-cwd` | Ajanları proje sınırları içinde tutun | `allowPaths` |
-| `block-secrets-write` | Özel anahtar ve sertifika dosyalarına yazmaları önleyin | `additionalPatterns` |
-| `block-push-master` | Ana/master'a yanlışlıkla itmeyi önleyin | `protectedBranches` |
-| `block-work-on-main` | Ajanları korumalı dallardan uzak tutun | `protectedBranches` |
-| `block-force-push` | `git push --force` komutunu önleyin | |
-| `warn-git-amend` | Ajanları commit'leri değiştirmeden önce uyarın | |
-| `warn-git-stash-drop` | Ajanları stash'leri bırakmadan önce uyarın | |
-| `warn-all-files-staged` | Yanlışlıkla `git add -A` komutunu yakalayın | |
-| `warn-destructive-sql` | DROP/DELETE SQL komutlarını yürütmeden önce yakalayın | |
-| `warn-schema-alteration` | ALTER TABLE komutlarını yürütmeden önce yakalayın | |
-| `warn-large-file-write` | Beklenmedik şekilde büyük dosya yazımlarını yakalayın | `thresholdKb` |
-| `warn-package-publish` | Yanlışlıkla `npm publish` komutunu yakalayın | |
-| `warn-background-process` | İstenmeyen arka plan işlemi başlatmalarını yakalayın | |
-| `warn-global-package-install` | İstenmeyen genel paket kurulumlarını yakalayın | |
-| …ve daha fazlası | | |
-
-Tam politika ayrıntıları ve parametre referansı: [docs/built-in-policies.mdx](docs/built-in-policies.mdx)
-
----
-
-## Özel politikalar
-
-Ajanlarınızı güvenilir ve görevlerine odaklanmış tutmak için kendi politikalarınızı yazın:
-
-```js
-import { customPolicies, allow, deny, instruct } from "failproofai";
-
-customPolicies.add({
-  name: "no-production-writes",
-  description: "'production' içeren yollara yazmaları engelleyin",
-  match: { events: ["PreToolUse"] },
-  fn: async (ctx) => {
-    if (!["Write", "Edit"].includes(ctx.toolName ?? "")) return allow();
-    const path = ctx.toolInput?.file_path ?? "";
-    if (path.includes("production")) return deny("Production yollarına yazma işlemleri engellendi");
-    return allow();
-  },
-});
-```
-
-Şu komutuyla yükleyin:
-
-```bash
-failproofai policies --install --custom ./my-policies.js
-```
-
-### Karar yardımcıları
-
-| İşlev | Etki |
-|-------|------|
-| `allow()` | İşleme izin verin |
-| `allow(message)` | İzin verin ve Claude'a bilgilendirici bağlam gönderin |
-| `deny(message)` | İşlemi engelleyin; ileti Claude'a gösterilir |
-| `instruct(message)` | Claude'un istemine bağlam ekleyin; engellemez |
-
-### Bağlam nesnesi (`ctx`)
-
-| Alan | Tür | Açıklama |
-|------|-----|---------|
-| `eventType` | `string` | `"PreToolUse"`, `"PostToolUse"`, `"Notification"`, `"Stop"` |
-| `toolName` | `string` | Çağrılan araç (`"Bash"`, `"Write"`, `"Read"`, …) |
-| `toolInput` | `object` | Aracın giriş parametreleri |
-| `payload` | `object` | Tam ham olay yükü |
-| `session.cwd` | `string` | Claude Code oturumunun çalışma dizini |
-| `session.sessionId` | `string` | Oturum tanımlayıcısı |
-| `session.transcriptPath` | `string` | Oturum döküm dosyasının yolu |
-
-Özel hook'lar geçişli yerel içe aktarmaları, async/await ve `process.env` erişimini destekler. Hatalar açık başarısız olur (hatalara `~/.failproofai/hook.log` dosyasında kaydedilir, yerleşik politikalar devam eder). Tam rehber için [docs/custom-hooks.mdx](docs/custom-hooks.mdx) bölümüne bakın.
-
-### Kural tabanlı politikalar
-
-`*policies.{js,mjs,ts}` dosyalarını `.failproofai/policies/` dizinine bırakın ve otomatik olarak yüklenir - bayrak veya yapılandırma değişikliği yapılmaz. Dizini git'e commit edin ve her takım üyesi aynı kalite standartlarını otomatik olarak alır.
-
-```text
-# Proje seviyesi — git'e commit edilmiş, takım ile paylaşılan
-.failproofai/policies/security-policies.mjs
-.failproofai/policies/workflow-policies.mjs
-
-# Kullanıcı seviyesi — kişisel, tüm projelere uygulanır
-~/.failproofai/policies/my-policies.mjs
-```
-
-Her iki seviye de yüklenir (birleşim). Dosyalar her dizin içinde alfabetik olarak yüklenir. Sırayı kontrol etmek için `01-`, `02-` vb. ön ekle ekleyin. Takımınız yeni başarısızlık modlarını keşfettikçe, bir politika ekleyin ve gönderin — herkes kendi sonraki pull'larında güncellemeyi alır. Kullanıma hazır örnekler için [examples/convention-policies/](examples/convention-policies/) bölümüne bakın.
-
----
-
-## Telemetri
-
-Failproof AI, özellik kullanımını anlamak için PostHog aracılığıyla anonim kullanım telemetrisi toplar. Oturum içeriği, dosya adları, araç girdileri veya kişisel bilgiler asla gönderilmez.
-
-Devre dışı bırakmak için:
-
-```bash
-FAILPROOFAI_TELEMETRY_DISABLED=1 failproofai
-```
-
----
-
-## Belgeler
-
-| Rehber | Açıklama |
-|--------|----------|
-| [Başlangıç Kılavuzu](docs/getting-started.mdx) | Kurulum ve ilk adımlar |
-| [Yerleşik Politikalar](docs/built-in-policies.mdx) | 30 yerleşik politika ve parametreleri |
-| [Özel Politikalar](docs/custom-policies.mdx) | Kendi politikalarınızı yazın |
-| [Yapılandırma](docs/configuration.mdx) | Yapılandırma dosyası biçimi ve kapsam birleştirme |
-| [Pano](docs/dashboard.mdx) | Oturumları izleyin ve politika etkinliğini gözden geçirin |
-| [Mimari](docs/architecture.mdx) | Hook sistemi nasıl çalışır |
-| [Test](docs/testing.mdx) | Testleri çalıştırın ve yenilerini yazın |
-
-### Belgeleri yerel olarak çalıştırın
-
-```bash
-docker build -f Dockerfile.docs -t failproofai-docs .
-docker run --rm -p 3000:3000 failproofai-docs
-```
-
-Mintlify belgeleri sitesini `http://localhost:3000` adresinde açar. Belge dizinini bağlarsanız, konteyner değişiklikleri izler:
-
-```bash
-docker run --rm -p 3000:3000 -v $(pwd)/docs:/app/docs failproofai-docs
-```
-
----
-
-## failproofai katılımcıları için not
-
-Bu depo'nun `.claude/settings.json` dosyası, standart `npx -y failproofai` komutu yerine `bun ./bin/failproofai.mjs --hook <EventType>` komutunu kullanır. Bunun nedeni, `npx -y failproofai` komutunu failproofai projesi içinde çalıştırmanın kendine referans bir çatışma oluşturmasıdır.
-
-Diğer tüm repolar için önerilen yaklaşım `npx -y failproofai` olup, şu komutla kurulur:
-
-```bash
-failproofai policies --install --scope project
-```
-
-## Katkıda bulunma
-
-[CONTRIBUTING.md](CONTRIBUTING.md) bölümüne bakın.
-
----
-
-## Lisans
-
-[LICENSE](LICENSE) bölümüne bakın.
-
----
-
-**ExosphereHost tarafından inşa edilmiş ve bakımı yapılmaktadır: Aracılarınız için Güvenilirlik Araştırma Laboratuvarı**. Kuruluşların ve girişimlerin kendi aracıları, yazılımları ve uzmanlıkları aracılığıyla AI aracılarının güvenilirliğini iyileştirmelerine yardımcı oluruz. Daha fazla bilgi için [exosphere.host](https://exosphere.host) adresini ziyaret edin.

package/.next/standalone/docs/i18n/README.vi.md

@@ -1,307 +0,0 @@
-> **⚠️** This is an auto-generated translation. For the latest version, see the [English README](../../README.md). Community corrections welcome!
-
-[🇺🇸 English](../../README.md) | [🇨🇳 简体中文](README.zh.md) | [🇯🇵 日本語](README.ja.md) | [🇰🇷 한국어](README.ko.md) | [🇪🇸 Español](README.es.md) | [🇧🇷 Português](README.pt-br.md) | [🇩🇪 Deutsch](README.de.md) | [🇫🇷 Français](README.fr.md) | [🇷🇺 Русский](README.ru.md) | [🇮🇳 हिन्दी](README.hi.md) | [🇹🇷 Türkçe](README.tr.md) | **🇻🇳 Tiếng Việt** | [🇮🇹 Italiano](README.it.md) | [🇸🇦 العربية](README.ar.md) | [🇮🇱 עברית](README.he.md)
-
----
-
-```
-    ______      _ __                       ____   ___    ____
-   / ____/___ _(_) /___  _________  ____  / __/  /   |  /  _/
-  / /_  / __ `/ / / __ \/ ___/ __ \/ __ \/ /_   / /| |  / /
- / __/ / /_/ / / / /_/ / /  / /_/ / /_/ / __/  / ___ |_/ /
-/_/    \__,_/_/_/ .___/_/   \____/\____/_/    /_/  |_/___/
-               /_/
-```
-
-# Failproof AI
-
-[![Docs](https://img.shields.io/badge/docs-befailproof.ai-002CA7?style=flat-square)](https://befailproof.ai)
-[![npm](https://img.shields.io/npm/v/failproofai?style=flat-square&color=CB3837)](https://www.npmjs.com/package/failproofai)
-[![License](https://img.shields.io/badge/license-MIT%20%2B%20Commons%20Clause-blue?style=flat-square)](LICENSE)
-[![CI](https://img.shields.io/github/actions/workflow/status/exospherehost/failproofai/ci.yml?branch=main&style=flat-square&label=CI)](https://github.com/exospherehost/failproofai/actions)
-[![Slack](https://img.shields.io/badge/Slack-join%20us-4A154B?style=flat-square&logo=slack)](https://join.slack.com/t/failproofai/shared_invite/zt-3v63b7k5e-O3NBHmj8X6n9gZSGDx6ggQ)
-
-**Translations**: [简体中文](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)
-
-Cách dễ nhất để quản lý các chính sách giữ cho các AI agent của bạn đáng tin cậy, tập trung vào mục tiêu và chạy tự động - cho **Claude Code** & **Agents SDK**.
-
-- **30 Chính sách tích hợp** - Bắt các chế độ lỗi phổ biến của agent ngay lập tức. Chặn các lệnh phá hoại, ngăn chặn rò rỉ bí mật, giữ các agent trong ranh giới dự án, phát hiện vòng lặp, v.v.
-- **Chính sách tùy chỉnh** - Viết các quy tắc độ tin cậy của riêng bạn bằng JavaScript. Sử dụng API `allow`/`deny`/`instruct` để thực thi các quy ước, ngăn chặn sai lệch, gating các hoạt động hoặc tích hợp với các hệ thống bên ngoài.
-- **Cấu hình dễ dàng** - Điều chỉnh bất kỳ chính sách nào mà không cần viết mã. Đặt danh sách cho phép, các nhánh được bảo vệ, ngưỡng cho mỗi dự án hoặc toàn cầu. Ba cấu hình phạm vi hợp nhất tự động.
-- **Agent Monitor** - Xem những gì các agent của bạn đã làm khi bạn vắng mặt. Duyệt qua các phiên, kiểm tra từng lệnh gọi công cụ, và xem lại chính xác nơi các chính sách đã kích hoạt.
-
-Mọi thứ chạy cục bộ - không có dữ liệu nào rời khỏi máy của bạn.
-
----
-
-## Yêu cầu
-
-- Node.js >= 20.9.0
-- Bun >= 1.3.0 (tùy chọn - chỉ cần thiết cho phát triển / xây dựng từ nguồn)
-
----
-
-## Cài đặt
-
-```bash
-npm install -g failproofai
-# hoặc
-bun add -g failproofai
-```
-
----
-
-## Bắt đầu nhanh
-
-### 1. Bật chính sách toàn cầu
-
-```bash
-failproofai policies --install
-```
-
-Ghi các mục hook vào `~/.claude/settings.json`. Claude Code sẽ bây giờ gọi failproofai trước và sau mỗi lệnh gọi công cụ.
-
-### 2. Khởi chạy bảng điều khiển
-
-```bash
-failproofai
-```
-
-Mở `http://localhost:8020` - duyệt qua các phiên, kiểm tra nhật ký, quản lý chính sách.
-
-### 3. Kiểm tra cái gì đang hoạt động
-
-```bash
-failproofai policies
-```
-
----
-
-## Cài đặt chính sách
-
-### Phạm vi
-
-| Phạm vi | Lệnh | Nơi ghi |
-|--------|------|---------|
-| Toàn cầu (mặc định) | `failproofai policies --install` | `~/.claude/settings.json` |
-| Dự án | `failproofai policies --install --scope project` | `.claude/settings.json` |
-| Cục bộ | `failproofai policies --install --scope local` | `.claude/settings.local.json` |
-
-### Cài đặt các chính sách cụ thể
-
-```bash
-failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
-```
-
-### Xóa chính sách
-
-```bash
-failproofai policies --uninstall
-# hoặc cho một phạm vi cụ thể:
-failproofai policies --uninstall --scope project
-```
-
----
-
-## Cấu hình
-
-Cấu hình chính sách nằm trong `~/.failproofai/policies-config.json` (toàn cầu) hoặc `.failproofai/policies-config.json` trong dự án của bạn (cho mỗi dự án).
-
-```json
-{
-  "enabledPolicies": [
-    "block-sudo",
-    "block-rm-rf",
-    "sanitize-api-keys",
-    "block-push-master",
-    "block-env-files",
-    "block-read-outside-cwd"
-  ],
-  "policyParams": {
-    "block-sudo": {
-      "allowPatterns": ["sudo systemctl status", "sudo journalctl"],
-      "hint": "Sử dụng apt-get trực tiếp mà không cần sudo."
-    },
-    "block-push-master": {
-      "protectedBranches": ["main", "release", "prod"],
-      "hint": "Hãy thử tạo một nhánh mới thay thế."
-    },
-    "sanitize-api-keys": {
-      "additionalPatterns": [
-        { "regex": "myco_[A-Za-z0-9]{32}", "label": "MyCo API key" }
-      ]
-    },
-    "warn-large-file-write": {
-      "thresholdKb": 512
-    }
-  }
-}
-```
-
-**Ba phạm vi cấu hình** được hợp nhất tự động (project → local → global). Xem [docs/configuration.mdx](docs/configuration.mdx) để biết các quy tắc hợp nhất đầy đủ.
-
----
-
-## Chính sách tích hợp
-
-| Chính sách | Mô tả | Có thể cấu hình |
-|-----------|-------|:---:|
-| `block-sudo` | Ngăn chặn các agent chạy các lệnh hệ thống có đặc quyền | `allowPatterns` |
-| `block-rm-rf` | Ngăn chặn việc xóa tệp đệ quy ngẫu nhiên | `allowPaths` |
-| `block-curl-pipe-sh` | Ngăn chặn các agent từ piping các tập lệnh không tin cậy vào shell | |
-| `block-failproofai-commands` | Ngăn chặn tự gỡ cài đặt | |
-| `sanitize-jwt` | Dừng các mã thông báo JWT rò rỉ vào bối cảnh agent | |
-| `sanitize-api-keys` | Dừng các khóa API rò rỉ vào bối cảnh agent | `additionalPatterns` |
-| `sanitize-connection-strings` | Dừng thông tin xác thực cơ sở dữ liệu rò rỉ vào bối cảnh agent | |
-| `sanitize-private-key-content` | Che đi các khối khóa riêng PEM khỏi đầu ra | |
-| `sanitize-bearer-tokens` | Che đi các mã thông báo Authorization Bearer khỏi đầu ra | |
-| `block-env-files` | Giữ các agent khỏi đọc các tệp .env | |
-| `protect-env-vars` | Ngăn chặn các agent từ in các biến môi trường | |
-| `block-read-outside-cwd` | Giữ các agent bên trong ranh giới dự án | `allowPaths` |
-| `block-secrets-write` | Ngăn chặn ghi vào các tệp khóa riêng và chứng chỉ | `additionalPatterns` |
-| `block-push-master` | Ngăn chặn các push ngẫu nhiên vào main/master | `protectedBranches` |
-| `block-work-on-main` | Giữ các agent khỏi các nhánh được bảo vệ | `protectedBranches` |
-| `block-force-push` | Ngăn chặn `git push --force` | |
-| `warn-git-amend` | Nhắc nhở các agent trước khi sửa đổi commit | |
-| `warn-git-stash-drop` | Nhắc nhở các agent trước khi bỏ stash | |
-| `warn-all-files-staged` | Bắt `git add -A` ngẫu nhiên | |
-| `warn-destructive-sql` | Bắt DROP/DELETE SQL trước khi thực thi | |
-| `warn-schema-alteration` | Bắt ALTER TABLE trước khi thực thi | |
-| `warn-large-file-write` | Bắt ghi tệp lớn ngoài dự kiến | `thresholdKb` |
-| `warn-package-publish` | Bắt `npm publish` ngẫu nhiên | |
-| `warn-background-process` | Bắt các khởi chạy quy trình nền không dự định | |
-| `warn-global-package-install` | Bắt các cài đặt gói toàn cầu không dự định | |
-| …và hơn nữa | | |
-
-Chi tiết chính sách đầy đủ và tham chiếu tham số: [docs/built-in-policies.mdx](docs/built-in-policies.mdx)
-
----
-
-## Chính sách tùy chỉnh
-
-Viết các chính sách của riêng bạn để giữ cho các agent đáng tin cậy và tập trung vào mục tiêu:
-
-```js
-import { customPolicies, allow, deny, instruct } from "failproofai";
-
-customPolicies.add({
-  name: "no-production-writes",
-  description: "Chặn ghi vào các đường dẫn chứa 'production'",
-  match: { events: ["PreToolUse"] },
-  fn: async (ctx) => {
-    if (!["Write", "Edit"].includes(ctx.toolName ?? "")) return allow();
-    const path = ctx.toolInput?.file_path ?? "";
-    if (path.includes("production")) return deny("Ghi vào các đường dẫn production bị chặn");
-    return allow();
-  },
-});
-```
-
-Cài đặt bằng:
-
-```bash
-failproofai policies --install --custom ./my-policies.js
-```
-
-### Trợ giúp quyết định
-
-| Hàm | Hiệu ứng |
-|-----|---------|
-| `allow()` | Cho phép hoạt động |
-| `allow(message)` | Cho phép và gửi bối cảnh thông tin tới Claude |
-| `deny(message)` | Chặn hoạt động; tin nhắn được hiển thị cho Claude |
-| `instruct(message)` | Thêm bối cảnh vào lời nhắc của Claude; không chặn |
-
-### Đối tượng bối cảnh (`ctx`)
-
-| Trường | Loại | Mô tả |
-|-------|------|-------|
-| `eventType` | `string` | `"PreToolUse"`, `"PostToolUse"`, `"Notification"`, `"Stop"` |
-| `toolName` | `string` | Công cụ được gọi (`"Bash"`, `"Write"`, `"Read"`, …) |
-| `toolInput` | `object` | Các tham số đầu vào của công cụ |
-| `payload` | `object` | Toàn bộ tải trọng sự kiện thô |
-| `session.cwd` | `string` | Thư mục làm việc của phiên Claude Code |
-| `session.sessionId` | `string` | Định danh phiên |
-| `session.transcriptPath` | `string` | Đường dẫn tới tệp bảng lưu ý phiên |
-
-Các hook tùy chỉnh hỗ trợ nhập cục bộ chuyên chở, async/await, và truy cập vào `process.env`. Các lỗi được mở rộng (ghi vào `~/.failproofai/hook.log`, các chính sách tích hợp tiếp tục). Xem [docs/custom-hooks.mdx](docs/custom-hooks.mdx) để biết hướng dẫn đầy đủ.
-
-### Chính sách dựa trên quy ước
-
-Thả các tệp `*policies.{js,mjs,ts}` vào `.failproofai/policies/` và chúng sẽ được tự động tải - không cần cờ hoặc thay đổi cấu hình. Cam kết thư mục vào git và mọi thành viên trong nhóm sẽ tự động có được cùng tiêu chuẩn chất lượng.
-
-```text
-# Cấp độ dự án — cam kết vào git, chia sẻ với nhóm
-.failproofai/policies/security-policies.mjs
-.failproofai/policies/workflow-policies.mjs
-
-# Cấp độ người dùng — cá nhân, áp dụng cho tất cả dự án
-~/.failproofai/policies/my-policies.mjs
-```
-
-Cả hai cấp độ tải (hợp nhất). Các tệp được tải theo thứ tự bảng chữ cái trong mỗi thư mục. Tiền tố với `01-`, `02-`, v.v. để kiểm soát thứ tự. Khi nhóm của bạn khám phá ra các chế độ lỗi mới, hãy thêm một chính sách và đẩy - mọi người sẽ nhận được cập nhật trên pull tiếp theo của họ. Xem [examples/convention-policies/](examples/convention-policies/) để biết các ví dụ sẵn sàng sử dụng.
-
----
-
-## Viễn thông
-
-Failproof AI thu thập telemetry sử dụng ẩn danh qua PostHog để hiểu cách sử dụng tính năng. Không bao giờ gửi nội dung phiên, tên tệp, đầu vào công cụ hoặc thông tin cá nhân.
-
-Vô hiệu hóa nó:
-
-```bash
-FAILPROOFAI_TELEMETRY_DISABLED=1 failproofai
-```
-
----
-
-## Tài liệu
-
-| Hướng dẫn | Mô tả |
-|---------|-------|
-| [Getting Started](docs/getting-started.mdx) | Cài đặt và các bước đầu tiên |
-| [Built-in Policies](docs/built-in-policies.mdx) | Tất cả 30 chính sách tích hợp với các tham số |
-| [Custom Policies](docs/custom-policies.mdx) | Viết các chính sách của riêng bạn |
-| [Configuration](docs/configuration.mdx) | Định dạng tệp cấu hình và hợp nhất phạm vi |
-| [Dashboard](docs/dashboard.mdx) | Giám sát phiên và xem lại hoạt động chính sách |
-| [Architecture](docs/architecture.mdx) | Cách hệ thống hook hoạt động |
-| [Testing](docs/testing.mdx) | Chạy các bài kiểm tra và viết các bài kiểm tra mới |
-
-### Chạy tài liệu cục bộ
-
-```bash
-docker build -f Dockerfile.docs -t failproofai-docs .
-docker run --rm -p 3000:3000 failproofai-docs
-```
-
-Mở trang web Mintlify docs tại `http://localhost:3000`. Container sẽ theo dõi các thay đổi nếu bạn gắn thư mục docs:
-
-```bash
-docker run --rm -p 3000:3000 -v $(pwd)/docs:/app/docs failproofai-docs
-```
-
----
-
-## Ghi chú cho những người đóng góp failproofai
-
-`.claude/settings.json` của repo này sử dụng `bun ./bin/failproofai.mjs --hook <EventType>` thay vì lệnh `npx -y failproofai` tiêu chuẩn. Điều này là vì chạy `npx -y failproofai` bên trong chính dự án failproofai tạo ra một xung đột tự tham chiếu.
-
-Đối với tất cả các repo khác, cách tiếp cận được khuyến nghị là `npx -y failproofai`, được cài đặt qua:
-
-```bash
-failproofai policies --install --scope project
-```
-
-## Đóng góp
-
-Xem [CONTRIBUTING.md](CONTRIBUTING.md).
-
----
-
-## Giấy phép
-
-Xem [LICENSE](LICENSE).
-
----
-
-Được xây dựng và Bảo trì bởi **ExosphereHost: Reliability Research Lab cho các Agent của bạn**. Chúng tôi giúp các doanh nghiệp và startups cải thiện độ tin cậy của các AI agent của họ thông qua các agent, phần mềm và chuyên môn của riêng chúng tôi. Tìm hiểu thêm tại [exosphere.host](https://exosphere.host).