failproofai 0.0.2 → 0.0.4-beta.0

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

@@ -0,0 +1,308 @@
+> **⚠️** 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 ajanlarınızı güvenilir, görev odaklı ve otonom şekilde çalışmasını sağlayan politikaları yönetmenin en kolay yolu - **Claude Code** ve **Agents SDK** için.
+
+- **30 Yerleşik Politika** - Yaygın ajan başarısızlık modlarını hemen tespit edin. Yıkıcı komutları engelleyin, gizli bilgilerin sızmasını önleyin, ajanları proje sınırları içinde tutun, döngüleri tespit edin ve daha fazlası.
+- **Özel Politikalar** - JavaScript'te kendi güvenilirlik kurallarınızı yazın. Kuralları zorunlu kılmak, sürüklenmeyi önlemek, işlemleri kontrol etmek veya harici sistemlerle entegre olmak için `allow`/`deny`/`instruct` API'sini kullanın.
+- **Kolay Yapılandırma** - Herhangi bir politikayı kod yazmadan ayarlayın. İzin listelerini, korumalı dalları, eşikleri proje başına veya küresel olarak ayarlayın. Üç kapsamlı konfigürasyon otomatik olarak birleştirilir.
+- **Ajan İzleyici** - Ajanlarınız uzakta iken ne yaptığını görün. Oturumları göz atın, her araç çağrısını inceleyin ve politikaların tam olarak nerede etkinleştirildiğini gözden geçirin.
+
+Her şey yerel olarak çalışır - hiçbir veri makinenizi terk etmez.
+
+---
+
+## Gereksinimler
+
+- Node.js >= 20.9.0
+- Bun >= 1.3.0 (isteğe bağlı - yalnızca geliştirme / kaynaktan oluşturma için gerekli)
+
+---
+
+## Kurulum
+
+```bash
+npm install -g failproofai
+# veya
+bun add -g failproofai
+```
+
+---
+
+## Hızlı başlangıç
+
+### 1. Politikaları küresel olarak etkinleştirin
+
+```bash
+failproofai policies --install
+```
+
+`~/.claude/settings.json` dosyasına hook girişleri yazar. Claude Code artık her araç çağrısından önce ve sonra failproofai'ı çağıracaktır.
+
+### 2. Pano başlatın
+
+```bash
+failproofai
+```
+
+`http://localhost:8020` açılır - oturumları göz atın, günlükleri inceleyin, politikaları yönetin.
+
+### 3. Etkin olanları kontrol edin
+
+```bash
+failproofai policies
+```
+
+---
+
+## Politika kurulumu
+
+### Kapsamlar
+
+| Kapsam | Komut | Nereye yazar |
+|--------|-------|-------------|
+| Küresel (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` dosyasında (küresel) veya projenizin `.failproofai/policies-config.json` dosyasında (proje başına) 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 doğrudan apt-get 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
+    }
+  }
+}
+```
+
+**Üç konfigürasyon kapsamı** otomatik olarak birleştirilir (proje → yerel → küresel). Tam birleştirme kuralları için bkz. [docs/configuration.mdx](docs/configuration.mdx).
+
+---
+
+## Yerleşik politikalar
+
+| Politika | Açıklama | Yapılandırılabilir |
+|----------|----------|:---:|
+| `block-sudo` | Ajanları ayrıcalıklı sistem komutlarını çalıştırmaktan engelle | `allowPatterns` |
+| `block-rm-rf` | Kazara özyinelemeli dosya silmeyi engelle | `allowPaths` |
+| `block-curl-pipe-sh` | Ajanları güvenilmeyen betikleri kabuğa yöneltmekten engelle | |
+| `block-failproofai-commands` | Kendi kaldırılmasını engelle | |
+| `sanitize-jwt` | JWT belirteçlerinin ajan bağlamına sızmasını durdur | |
+| `sanitize-api-keys` | API anahtarlarının ajan bağlamına sızmasını durdur | `additionalPatterns` |
+| `sanitize-connection-strings` | Veritabanı kimlik bilgilerinin ajan bağlamına sızmasını durdur | |
+| `sanitize-private-key-content` | Çıktıdan PEM özel anahtar bloklarını gizle | |
+| `sanitize-bearer-tokens` | Authorization Bearer belirteçlerini çıktıdan gizle | |
+| `block-env-files` | Ajanları .env dosyalarını okumaktan engelle | |
+| `protect-env-vars` | Ajanları ortam değişkenlerini yazdırmaktan engelle | |
+| `block-read-outside-cwd` | Ajanları proje sınırları içinde tut | `allowPaths` |
+| `block-secrets-write` | Özel anahtar ve sertifika dosyalarına yazmaları engelle | `additionalPatterns` |
+| `block-push-master` | main/master'a kazara yapılan gönderişleri engelle | `protectedBranches` |
+| `block-work-on-main` | Ajanları korumalı dallardan uzak tut | `protectedBranches` |
+| `block-force-push` | `git push --force` komutunu engelle | |
+| `warn-git-amend` | Ajanları commit'leri düzenlemeden önce uyar | |
+| `warn-git-stash-drop` | Ajanları stash'leri bırakmadan önce uyar | |
+| `warn-all-files-staged` | Kazara `git add -A` komutunu yakala | |
+| `warn-destructive-sql` | DROP/DELETE SQL'i yürütülmeden önce yakala | |
+| `warn-schema-alteration` | ALTER TABLE'ı yürütülmeden önce yakala | |
+| `warn-large-file-write` | Beklenmedik şekilde büyük dosya yazmaları yakala | `thresholdKb` |
+| `warn-package-publish` | Kazara `npm publish` komutunu yakala | |
+| `warn-background-process` | Istenmeyen arka plan işlemi başlatmalarını yakala | |
+| `warn-global-package-install` | Istenmeyen küresel paket yüklemelerini yakala | |
+| …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örev odaklı 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ı engelle",
+  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 komutla kurun:
+
+```bash
+failproofai policies --install --custom ./my-policies.js
+```
+
+### Karar yardımcıları
+
+| İşlev | Etki |
+|-------|------|
+| `allow()` | İşleme izin ver |
+| `allow(message)` | İzin ver ve bilgilendirici bağlam Claude'a gönder *(beta)* |
+| `deny(message)` | İşlemi engelle; ileti Claude'a gösterilir |
+| `instruct(message)` | Claude'un istemine bağlam ekle; engelleme yapmaz |
+
+### 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 transkript dosyasının yolu |
+
+Özel hooklar geçişli yerel içe aktarmaları, async/await'i ve `process.env` erişimini destekler. Hatalar açık başarısızlık modunda yapılır (günlüklenir: `~/.failproofai/hook.log`, yerleşik politikalar devam eder). Tam rehber için bkz. [docs/custom-hooks.mdx](docs/custom-hooks.mdx).
+
+### Kural tabanlı politikalar (v0.0.2-beta.7+)
+
+`*policies.{js,mjs,ts}` dosyalarını `.failproofai/policies/` klasörüne bırakın ve otomatik olarak yüklenir — `--custom` bayrağı veya yapılandırma değişiklikleri gerekmez. Git hook'ları gibi çalışır: bir dosya bırakın, her şey çalışır.
+
+```text
+# Proje seviyesi — git'e yürütülen, takım ile paylaşılır
+.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. ile ön ek ekleyin. Hazır kullanılabilir örnekler için bkz. [examples/convention-policies/](examples/convention-policies/).
+
+---
+
+## 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 hiçbir zaman gönderilmez.
+
+Devre dışı bırakmak için:
+
+```bash
+FAILPROOFAI_TELEMETRY_DISABLED=1 failproofai
+```
+
+---
+
+## Belgeler
+
+| Rehber | Açıklama |
+|--------|----------|
+| [Başlangıç](docs/getting-started.mdx) | Kurulum ve ilk adımlar |
+| [Yerleşik Politikalar](docs/built-in-policies.mdx) | 30 yerleşik politikanın tümü parametrelerle birlikte |
+| [Özel Politikalar](docs/custom-policies.mdx) | Kendi politikalarınızı yazın |
+| [Yapılandırma](docs/configuration.mdx) | Konfigürasyon 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 Etme](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 belgeler sitesini `http://localhost:3000` adresinde açar. Belgeler dizinini bağlarsanız kapsayıcı değişiklikleri izler:
+
+```bash
+docker run --rm -p 3000:3000 -v $(pwd)/docs:/app/docs failproofai-docs
+```
+
+---
+
+## failproofai katkıda bulunanları için not
+
+Bu deponun `.claude/settings.json` dosyası standart `npx -y failproofai` komutu yerine `bun ./bin/failproofai.mjs --hook <EventType>` komutunu kullanır. Bunun nedeni, failproofai projesi içinde `npx -y failproofai` çalıştırmanın kendi kendine referans çatışması oluşturmasıdır.
+
+Diğer tüm depolar için önerilen yaklaşım `npx -y failproofai` komutudur ve şu şekilde yüklenir:
+
+```bash
+failproofai policies --install --scope project
+```
+
+## Katkıda bulunun
+
+Bkz. [CONTRIBUTING.md](CONTRIBUTING.md).
+
+---
+
+## Lisans
+
+Bkz. [LICENSE](LICENSE).
+
+---
+
+**ExosphereHost: Ajanlarınız için Güvenilirlik Araştırması Laboratuvarı** tarafından inşa edilmiş ve sürdürülmektedir. Ajanlarımız, yazılımımız ve uzmanlığımız aracılığıyla kuruluşların ve startupların AI ajanlarının güvenilirliğini artırmasına yardımcı oluyoruz. [exosphere.host](https://exosphere.host) adresinde daha fazla bilgi edinin.
+```

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

@@ -0,0 +1,308 @@
+> **⚠️** 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)
+
+**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)
+
+Cách dễ nhất để quản lý các chính sách giữ cho các agent AI 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 sẵn** - Bắt các lỗi phổ biến của agent ngay từ đầu. 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à nhiều hơn nữa.
+- **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 sự trôi dạt, kiểm soát các phép toán 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, nhánh được bảo vệ, ngưỡng cho từng dự án hoặc toàn cầu. Hợp nhất cấu hình ba phạm vi 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 các phiên, kiểm tra từng lệnh gọi công cụ và xem xét chính xác nơi các chính sách được 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 tính 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 để 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 trên toàn cầu
+
+```bash
+failproofai policies --install
+```
+
+Ghi các mục hook vào `~/.claude/settings.json`. Claude Code sẽ 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 các phiên, kiểm tra nhật ký, quản lý chính sách.
+
+### 3. Kiểm tra những 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 nó 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 chính sách cụ thể
+
+```bash
+failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
+```
+
+### Gỡ bỏ 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 (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 vào đó."
+    },
+    "sanitize-api-keys": {
+      "additionalPatterns": [
+        { "regex": "myco_[A-Za-z0-9]{32}", "label": "Khóa API MyCo" }
+      ]
+    },
+    "warn-large-file-write": {
+      "thresholdKb": 512
+    }
+  }
+}
+```
+
+**Ba phạm vi cấu hình** được hợp nhất tự động (dự án → cục bộ → toàn cầu). 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 sẵn
+
+| 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 xóa tệp đệ quy vô tình | `allowPaths` |
+| `block-curl-pipe-sh` | Ngăn chặn các agent đưa các tập lệnh không đáng tin cậy vào shell | |
+| `block-failproofai-commands` | Ngăn chặn tự dỡ cài đặt | |
+| `sanitize-jwt` | Dừng các mã thông báo JWT bị rò rỉ vào ngữ cảnh agent | |
+| `sanitize-api-keys` | Dừng các khóa API bị rò rỉ vào ngữ cảnh agent | `additionalPatterns` |
+| `sanitize-connection-strings` | Dừng thông tin xác thực cơ sở dữ liệu bị rò rỉ vào ngữ 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 Bearer Authorization khỏi đầu ra | |
+| `block-env-files` | Ngăn chặn các agent đọc tệp .env | |
+| `protect-env-vars` | Ngăn chặn các agent in các biến môi trường | |
+| `block-read-outside-cwd` | Giữ các agent 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 đẩy vô tình tới main/master | `protectedBranches` |
+| `block-work-on-main` | Giữ các agent không ở 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 xóa stashes | |
+| `warn-all-files-staged` | Bắt `git add -A` vô tình | |
+| `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 bất ngờ | `thresholdKb` |
+| `warn-package-publish` | Bắt `npm publish` vô tình | |
+| `warn-background-process` | Bắt khởi chạy quá trình nền không dự định | |
+| `warn-global-package-install` | Bắt cài đặt gói toàn cầu không dự định | |
+| …và nhiều 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 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 với:
+
+```bash
+failproofai policies --install --custom ./my-policies.js
+```
+
+### Trợ giúp quyết định
+
+| Hàm | Hiệu ứng |
+|-----|---------|
+| `allow()` | Cho phép thao tác |
+| `allow(message)` | Cho phép và gửi ngữ cảnh thông tin tới Claude *(beta)* |
+| `deny(message)` | Chặn thao tác; thông báo được hiển thị tới Claude |
+| `instruct(message)` | Thêm ngữ cảnh vào yêu cầu của Claude; không chặn |
+
+### Đối tượng ngữ 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` | Tham số đầu vào của công cụ |
+| `payload` | `object` | Tải trọng sự kiện thô đầy đủ |
+| `session.cwd` | `string` | Thư mục làm việc của phiên Claude Code |
+| `session.sessionId` | `string` | Mã định danh phiên |
+| `session.transcriptPath` | `string` | Đường dẫn đến tệp phiên ghi âm |
+
+Các hook tùy chỉnh hỗ trợ nhập cục bộ chuyển tiếp, async/await và truy cập `process.env`. Các lỗi là fail-open (được ghi vào `~/.failproofai/hook.log`, các chính sách tích hợp sẵn 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 (v0.0.2-beta.7+)
+
+Thả các tệp `*policies.{js,mjs,ts}` vào `.failproofai/policies/` và chúng sẽ được tải tự động — không cần cờ `--custom` hoặc thay đổi cấu hình. Hoạt động giống như git hooks: thả một tệp, nó hoạt động.
+
+```text
+# Cấp độ dự án — được commit 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ả các dự án
+~/.failproofai/policies/my-policies.mjs
+```
+
+Cả hai cấp độ đều tải (union). 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ự. Xem [examples/convention-policies/](examples/convention-policies/) để biết các ví dụ sẵn sàng sử dụng.
+
+---
+
+## Đo lường hiệu suất
+
+Failproof AI thu thập telemetry sử dụng ẩn danh thông 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.
+
+Tắt 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 sẵn với các tham số |
+| [Custom Policies](docs/custom-policies.mdx) | Viết 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 các phiên và xem xét 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 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 Mintlify docs tại `http://localhost:3000`. Container theo dõi những thay đổi nếu bạn gắn thư mục tài liệu:
+
+```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
+
+Tệp `.claude/settings.json` của kho 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 xung đột tự tham chiếu.
+
+Đối với tất cả các kho khác, phương pháp được khuyến nghị là `npx -y failproofai`, được cài đặt thông 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à duy trì bởi **ExosphereHost: Phòng thí nghiệm nghiên cứu độ tin cậy cho các Agent của bạn**. Chúng tôi giúp các doanh nghiệp và các công ty khởi nghiệp cải thiện độ tin cậy của các agent AI của họ thông qua các agent, phần mềm và chuyên môn của chúng tôi. Tìm hiểu thêm tại [exosphere.host](https://exosphere.host).
+```