failproofai 0.0.2 → 0.0.3

package/.next/standalone/docs/vi/built-in-policies.mdx

@@ -0,0 +1,564 @@
+---
+title: Chính sách tích hợp sẵn
+description: "Tất cả 30 chính sách tích hợp sẵn giúp phát hiện các lỗi thường gặp của agent"
+icon: shield
+---
+
+failproofai được trang bị 30 chính sách tích hợp sẵn để phát hiện các lỗi thường gặp của agent. Mỗi chính sách kích hoạt trên một loại sự kiện hook cụ thể và tên tool. Chín chính sách chấp nhận các tham số cho phép bạn điều chỉnh hành vi của chúng mà không cần viết code. Bốn chính sách quy trình công việc beta buộc Claude phải thực hiện chuỗi commit → push → PR → CI trước khi dừng lại.
+
+---
+
+## Tổng quan
+
+Các chính sách được nhóm thành các danh mục:
+
+| Danh mục | Chính sách | Loại hook |
+|----------|-----------|-----------|
+| [Lệnh nguy hiểm](#dangerous-commands) | block-sudo, block-rm-rf, block-curl-pipe-sh, block-failproofai-commands | PreToolUse |
+| [Bí mật (sanitizer)](#secrets-sanitizers) | sanitize-jwt, sanitize-api-keys, sanitize-connection-strings, sanitize-private-key-content, sanitize-bearer-tokens | PostToolUse |
+| [Môi trường](#environment) | block-env-files, protect-env-vars | PreToolUse |
+| [Truy cập tệp](#file-access) | block-read-outside-cwd, block-secrets-write | PreToolUse |
+| [Git](#git) | block-push-master, block-work-on-main, block-force-push, warn-git-amend, warn-git-stash-drop, warn-all-files-staged | PreToolUse |
+| [Cơ sở dữ liệu](#database) | warn-destructive-sql, warn-schema-alteration | PreToolUse |
+| [Cảnh báo](#warnings) | warn-large-file-write, warn-package-publish, warn-background-process, warn-global-package-install | PreToolUse |
+| [Quy trình công việc (beta)](#workflow-beta) | require-commit-before-stop, require-push-before-stop, require-pr-before-stop, require-ci-green-before-stop | Stop |
+
+- **`block-`** — dừng agent thực hiện tiếp.
+- **`warn-`** — cung cấp ngữ cảnh bổ sung để agent có thể tự sửa.
+- **`sanitize-`** — xóa dữ liệu nhạy cảm từ đầu ra tool trước khi agent nhìn thấy.
+- **`require-`** — chặn sự kiện Stop cho đến khi các điều kiện được đáp ứng.
+
+---
+
+<Tip>
+Mỗi chính sách hỗ trợ trường `hint` tùy chọn trong `policyParams`. Hint được thêm vào thông điệp deny hoặc instruct mà Claude nhìn thấy, cung cấp hướng dẫn hữu ích mà không cần sửa đổi code chính sách. Hoạt động với chính sách tích hợp sẵn, tùy chỉnh và quy ước. Xem [Configuration → hint](/vi/configuration#hint-cross-cutting) để biết chi tiết.
+</Tip>
+
+---
+
+## Lệnh nguy hiểm
+
+Ngăn agent chạy các hoạt động khó hoàn tác hoặc có thể làm hại hệ thống chính.
+
+### `block-sudo`
+
+**Sự kiện:** PreToolUse (Bash)  
+**Mặc định:** Từ chối bất kỳ lệnh `sudo` nào.
+
+Chặn các lệnh gọi chứa từ khóa `sudo`. Khớp mẫu được thực hiện trên các token lệnh được phân tích cú pháp, không phải chuỗi thô, để ngăn chặn vòng qua việc tiêm toán tử shell.
+
+**Tham số:**
+
+| Tham số | Kiểu | Mặc định | Mô tả |
+|--------|------|---------|-------|
+| `allowPatterns` | `string[]` | `[]` | Tiền tố lệnh chính xác được phép. Mỗi mục được khớp với các token argv được phân tích cú pháp. |
+
+**Ví dụ:**
+
+```json
+{
+  "policyParams": {
+    "block-sudo": {
+      "allowPatterns": ["sudo systemctl status", "sudo journalctl"]
+    }
+  }
+}
+```
+
+Với config này, `sudo systemctl status nginx` được phép, nhưng `sudo rm /etc/hosts` bị từ chối.
+
+<Note>
+Mẫu được khớp với các token được phân tích cú pháp, không phải chuỗi lệnh thô. Điều này ngăn chặn vòng qua việc thêm toán tử shell (ví dụ: `sudo systemctl status x; rm -rf /` không khớp với `sudo systemctl status *`).
+</Note>
+
+---
+
+### `block-rm-rf`
+
+**Sự kiện:** PreToolUse (Bash)  
+**Mặc định:** Từ chối `rm -rf`, `rm -fr` và các dạng xóa đệ quy tương tự.
+
+**Tham số:**
+
+| Tham số | Kiểu | Mặc định | Mô tả |
+|--------|------|---------|-------|
+| `allowPaths` | `string[]` | `[]` | Các đường dẫn an toàn để xóa đệ quy (ví dụ: `/tmp`). |
+
+**Ví dụ:**
+
+```json
+{
+  "policyParams": {
+    "block-rm-rf": {
+      "allowPaths": ["/tmp", "/var/cache"]
+    }
+  }
+}
+```
+
+---
+
+### `block-curl-pipe-sh`
+
+**Sự kiện:** PreToolUse (Bash)  
+**Mặc định:** Từ chối `curl <url> | bash`, `curl <url> | sh`, `wget <url> | bash` và các mẫu tương tự.
+
+Không có tham số.
+
+---
+
+### `block-failproofai-commands`
+
+**Sự kiện:** PreToolUse (Bash)  
+**Mặc định:** Từ chối các lệnh sẽ gỡ cài đặt hoặc vô hiệu hóa failproofai (ví dụ: `npm uninstall failproofai`, `failproofai policies --uninstall`).
+
+Không có tham số.
+
+---
+
+## Bí mật (sanitizer)
+
+Ngăn agent rò rỉ thông tin xác thực vào ngữ cảnh hoặc đầu ra của chúng. Các chính sách sanitizer kích hoạt trên các sự kiện **PostToolUse**. Khi Claude chạy lệnh Bash, đọc tệp hoặc gọi bất kỳ tool nào, các chính sách này kiểm tra đầu ra trước khi nó được trả về Claude. Nếu phát hiện mẫu bí mật, chính sách sẽ trả về quyết định deny ngăn chặn đầu ra được truyền lại.
+
+### `sanitize-jwt`
+
+**Sự kiện:** PostToolUse (tất cả tool)  
+**Mặc định:** Che giấu các JWT token (ba đoạn base64url được ngăn cách bằng `.`).
+
+Không có tham số.
+
+---
+
+### `sanitize-api-keys`
+
+**Sự kiện:** PostToolUse (tất cả tool)  
+**Mặc định:** Che giấu các định dạng API key phổ biến: Anthropic (`sk-ant-`), OpenAI (`sk-`), GitHub PATs (`ghp_`), AWS access keys (`AKIA`), Stripe keys (`sk_live_`, `sk_test_`), và Google API keys (`AIza`).
+
+**Tham số:**
+
+| Tham số | Kiểu | Mặc định | Mô tả |
+|--------|------|---------|-------|
+| `additionalPatterns` | `{ regex: string; label: string }[]` | `[]` | Các mẫu regex bổ sung được coi là bí mật. |
+
+**Ví dụ:**
+
+```json
+{
+  "policyParams": {
+    "sanitize-api-keys": {
+      "additionalPatterns": [
+        { "regex": "myco_[A-Za-z0-9]{32}", "label": "MyCo internal API key" },
+        { "regex": "pat_[0-9a-f]{40}", "label": "Internal PAT" }
+      ]
+    }
+  }
+}
+```
+
+---
+
+### `sanitize-connection-strings`
+
+**Sự kiện:** PostToolUse (tất cả tool)  
+**Mặc định:** Che giấu các chuỗi kết nối cơ sở dữ liệu chứa thông tin xác thực nhúng (ví dụ: `postgresql://user:password@host/db`).
+
+Không có tham số.
+
+---
+
+### `sanitize-private-key-content`
+
+**Sự kiện:** PostToolUse (tất cả tool)  
+**Mặc định:** Che giấu các khối PEM (`-----BEGIN PRIVATE KEY-----`, `-----BEGIN RSA PRIVATE KEY-----`, v.v.).
+
+Không có tham số.
+
+---
+
+### `sanitize-bearer-tokens`
+
+**Sự kiện:** PostToolUse (tất cả tool)  
+**Mặc định:** Che giấu các header `Authorization: Bearer <token>` trong đó token có 20 ký tự trở lên.
+
+Không có tham số.
+
+---
+
+## Môi trường
+
+Bảo vệ cấu hình môi trường nhạy cảm khỏi bị agent đọc hoặc tiết lộ.
+
+### `block-env-files`
+
+**Sự kiện:** PreToolUse (Bash, Read)  
+**Mặc định:** Từ chối đọc tệp `.env` thông qua `cat .env`, gọi tool Read có `.env` làm đường dẫn tệp, v.v.
+
+Không chặn `.envrc` hoặc các tệp liên quan môi trường khác - chỉ các tệp có tên chính xác là `.env`.
+
+Không có tham số.
+
+---
+
+### `protect-env-vars`
+
+**Sự kiện:** PreToolUse (Bash)  
+**Mặc định:** Từ chối các lệnh in ra các biến môi trường: `printenv`, `env`, `echo $VAR`.
+
+Không có tham số.
+
+---
+
+## Truy cập tệp
+
+Giữ agent hoạt động trong ranh giới dự án và tránh xa các tệp nhạy cảm.
+
+### `block-read-outside-cwd`
+
+**Sự kiện:** PreToolUse (Read, Bash)  
+**Mặc định:** Từ chối đọc các tệp ngoài thư mục làm việc hiện tại (root dự án).
+
+**Tham số:**
+
+| Tham số | Kiểu | Mặc định | Mô tả |
+|--------|------|---------|-------|
+| `allowPaths` | `string[]` | `[]` | Tiền tố đường dẫn tuyệt đối được phép ngay cả khi nằm ngoài cwd. |
+
+**Ví dụ:**
+
+```json
+{
+  "policyParams": {
+    "block-read-outside-cwd": {
+      "allowPaths": ["/shared/data", "/opt/company/config"]
+    }
+  }
+}
+```
+
+---
+
+### `block-secrets-write`
+
+**Sự kiện:** PreToolUse (Write, Edit)  
+**Mặc định:** Từ chối ghi vào các tệp thường được sử dụng cho khóa riêng tư và chứng chỉ: `id_rsa`, `id_ed25519`, `*.key`, `*.pem`, `*.p12`, `*.pfx`.
+
+**Tham số:**
+
+| Tham số | Kiểu | Mặc định | Mô tả |
+|--------|------|---------|-------|
+| `additionalPatterns` | `string[]` | `[]` | Các mẫu tên tệp bổ sung (kiểu glob) để chặn. |
+
+**Ví dụ:**
+
+```json
+{
+  "policyParams": {
+    "block-secrets-write": {
+      "additionalPatterns": [".token", ".secret"]
+    }
+  }
+}
+```
+
+---
+
+## Git
+
+Ngăn chặn các push, force-push và sai lầm nhánh accidental khó hoàn tác.
+
+### `block-push-master`
+
+**Sự kiện:** PreToolUse (Bash)  
+**Mặc định:** Từ chối `git push origin main` và `git push origin master`.
+
+**Tham số:**
+
+| Tham số | Kiểu | Mặc định | Mô tả |
+|--------|------|---------|-------|
+| `protectedBranches` | `string[]` | `["main", "master"]` | Tên nhánh không thể được push trực tiếp. |
+
+**Ví dụ:**
+
+```json
+{
+  "policyParams": {
+    "block-push-master": {
+      "protectedBranches": ["main", "master", "release", "prod"]
+    }
+  }
+}
+```
+
+<Tip>
+Để cho phép push đến tất cả các nhánh (thực tế là vô hiệu hóa chính sách này mà không xóa nó khỏi `enabledPolicies`), đặt `protectedBranches: []`.
+</Tip>
+
+---
+
+### `block-work-on-main`
+
+**Sự kiện:** PreToolUse (Bash)  
+**Mặc định:** Từ chối checkout các nhánh `main` hoặc `master` trực tiếp.
+
+**Tham số:**
+
+| Tham số | Kiểu | Mặc định | Mô tả |
+|--------|------|---------|-------|
+| `protectedBranches` | `string[]` | `["main", "master"]` | Tên nhánh không thể được checkout trực tiếp. |
+
+---
+
+### `block-force-push`
+
+**Sự kiện:** PreToolUse (Bash)  
+**Mặc định:** Từ chối `git push --force` và `git push -f`.
+
+Không có tham số riêng cho chính sách. Sử dụng [`hint`](/vi/configuration#hint-cross-cutting) cắt ngang:
+
+```json
+{
+  "policyParams": {
+    "block-force-push": {
+      "hint": "Tạo một nhánh mới từ HEAD hiện tại của bạn (ví dụ: `git checkout -b <new-branch>`) và push nhánh đó thay vào đó."
+    }
+  }
+}
+```
+
+---
+
+### `warn-git-amend`
+
+**Sự kiện:** PreToolUse (Bash)  
+**Mặc định:** Hướng dẫn Claude tiến hành cẩn thận khi chạy `git commit --amend`. Không chặn lệnh.
+
+Không có tham số.
+
+---
+
+### `warn-git-stash-drop`
+
+**Sự kiện:** PreToolUse (Bash)  
+**Mặc định:** Hướng dẫn Claude xác nhận trước khi chạy `git stash drop`. Không chặn lệnh.
+
+Không có tham số.
+
+---
+
+### `warn-all-files-staged`
+
+**Sự kiện:** PreToolUse (Bash)  
+**Mặc định:** Hướng dẫn Claude xem xét những gì nó đang staged khi chạy `git add -A` hoặc `git add .`. Không chặn lệnh.
+
+Không có tham số.
+
+---
+
+## Cơ sở dữ liệu
+
+Phát hiện các hoạt động SQL phá hủy trước khi chúng thực thi với cơ sở dữ liệu của bạn.
+
+### `warn-destructive-sql`
+
+**Sự kiện:** PreToolUse (Bash)  
+**Mặc định:** Hướng dẫn Claude xác nhận trước khi chạy SQL chứa `DROP TABLE`, `DROP DATABASE` hoặc `DELETE` mà không có mệnh đề `WHERE`.
+
+Không có tham số.
+
+---
+
+### `warn-schema-alteration`
+
+**Sự kiện:** PreToolUse (Bash)  
+**Mặc định:** Hướng dẫn Claude xác nhận trước khi chạy các câu lệnh `ALTER TABLE`.
+
+Không có tham số.
+
+---
+
+## Cảnh báo
+
+Cung cấp cho agent ngữ cảnh bổ sung trước các hoạt động có rủi ro nhưng không phá hủy.
+
+### `warn-large-file-write`
+
+**Sự kiện:** PreToolUse (Write)  
+**Mặc định:** Hướng dẫn Claude xác nhận trước khi ghi các tệp lớn hơn 1024 KB.
+
+**Tham số:**
+
+| Tham số | Kiểu | Mặc định | Mô tả |
+|--------|------|---------|-------|
+| `thresholdKb` | `number` | `1024` | Ngưỡng kích thước tệp tính bằng kilobytes mà trên đó cảnh báo được phát hành. |
+
+**Ví dụ:**
+
+```json
+{
+  "policyParams": {
+    "warn-large-file-write": {
+      "thresholdKb": 256
+    }
+  }
+}
+```
+
+<Note>
+Trình xử lý hook thực thi giới hạn stdin 1 MB trên tải trọng. Để kiểm tra chính sách này với nội dung nhỏ, đặt `thresholdKb` thành giá trị tốt dưới 1024.
+</Note>
+
+---
+
+### `warn-package-publish`
+
+**Sự kiện:** PreToolUse (Bash)  
+**Mặc định:** Hướng dẫn Claude xác nhận trước khi chạy `npm publish`.
+
+Không có tham số.
+
+---
+
+### `warn-background-process`
+
+**Sự kiện:** PreToolUse (Bash)  
+**Mặc định:** Hướng dẫn Claude cẩn thận khi khởi chạy quy trình nền thông qua `nohup`, `&`, `disown` hoặc `screen`.
+
+Không có tham số.
+
+---
+
+### `warn-global-package-install`
+
+**Sự kiện:** PreToolUse (Bash)  
+**Mặc định:** Hướng dẫn Claude xác nhận trước khi chạy `npm install -g`, `yarn global add` hoặc `pip install` mà không có môi trường ảo.
+
+Không có tham số.
+
+---
+
+## Hành vi AI
+
+Phát hiện khi agent bị kẹt hoặc hành động bất ngờ.
+
+### `warn-repeated-tool-calls`
+
+**Sự kiện:** PreToolUse (tất cả tool)  
+**Mặc định:** Hướng dẫn Claude cân nhắc lại khi công cụ tương tự được gọi 3 lần trở lên với các tham số giống hệt nhau - dấu hiệu phổ biến của agent bị kẹt trong vòng lặp.
+
+Không có tham số.
+
+---
+
+## Quy trình công việc (beta)
+
+Thực thi một quy trình công việc cuối phiên có kỷ luật. Các chính sách này kích hoạt trên sự kiện **Stop** và từ chối Claude dừng lại cho đến khi mỗi điều kiện được đáp ứng. Chúng tuân theo chuỗi phụ thuộc tự nhiên: commit → push → PR → CI. Nếu chính sách từ chối, các chính sách sau trong chuỗi sẽ bị bỏ qua (deny short-circuits).
+
+Tất cả các chính sách quy trình công việc là **fail-open**: nếu tool bắt buộc không có sẵn (ví dụ: `gh` không được cài đặt, không có git remote), chính sách cho phép với thông báo thông tin giải thích tại sao kiểm tra bị bỏ qua.
+
+### `require-commit-before-stop`
+
+**Sự kiện:** Stop  
+**Mặc định:** Từ chối dừng khi có những thay đổi chưa được commit (tệp đã sửa đổi, staged hoặc chưa được tracked). Trả về thông điệp thông tin khi thư mục làm việc sạch.
+
+Không có tham số.
+
+---
+
+### `require-push-before-stop`
+
+**Sự kiện:** Stop  
+**Mặc định:** Từ chối dừng khi có các commit chưa được push hoặc khi nhánh hiện tại không có nhánh tracking từ xa. Gợi ý `git push -u` để tạo nhánh tracking nếu cần. Fail open nếu không có remote được cấu hình.
+
+**Tham số:**
+
+| Tham số | Kiểu | Mặc định | Mô tả |
+|--------|------|---------|-------|
+| `remote` | `string` | `"origin"` | Tên remote để push đến. |
+
+**Ví dụ:**
+
+```json
+{
+  "policyParams": {
+    "require-push-before-stop": {
+      "remote": "upstream"
+    }
+  }
+}
+```
+
+---
+
+### `require-pr-before-stop`
+
+**Sự kiện:** Stop  
+**Mặc định:** Từ chối dừng khi không có pull request cho nhánh hiện tại, hoặc khi PR hiện có bị đóng/merged. Hướng dẫn Claude tạo PR với `gh pr create`.
+
+Không có tham số.
+
+<Note>
+Chính sách này yêu cầu [GitHub CLI](https://cli.github.com/) (`gh`) được cài đặt và xác thực.
+Chạy `gh auth login` với mã thông báo truy cập cá nhân có phạm vi `repo` để truy cập đọc
+pull request. Nếu `gh` không được cài đặt hoặc không được xác thực, chính sách fail open và báo cáo lý do cho Claude.
+</Note>
+
+---
+
+### `require-ci-green-before-stop`
+
+**Sự kiện:** Stop  
+**Mặc định:** Từ chối dừng khi các kiểm tra CI đang failed hoặc vẫn đang chạy trên nhánh hiện tại. Kiểm tra cả các quy trình công việc GitHub Actions và các kiểm tra bot của bên thứ ba (ví dụ: CodeRabbit, SonarCloud, Codecov). Coi kết luận `skipped` là thành công. Trả về thông điệp thông tin khi tất cả các kiểm tra vượt qua.
+
+Không có tham số.
+
+<Note>
+Chính sách này yêu cầu [GitHub CLI](https://cli.github.com/) (`gh`) được cài đặt và xác thực.
+Chạy `gh auth login` với mã thông báo truy cập cá nhân có phạm vi `repo` để truy cập đọc
+quy trình công việc Actions và API Checks. Nếu `gh` không được cài đặt hoặc không được xác thực, chính sách fail open và báo cáo lý do cho Claude.
+</Note>
+
+---
+
+## Chính sách beta
+
+Một số chính sách được đánh dấu là `beta` và không được cài đặt theo mặc định. Các chính sách beta có thể có những sai sót hoặc tạo ra kết quả dương tính giả. Chúng sẽ được nâng cấp thành ổn định trong các bản phát hành tương lai.
+
+**Các chính sách beta hiện tại:**
+
+- `require-commit-before-stop` — commit tất cả các thay đổi trước khi dừng
+- `require-push-before-stop` — push tất cả các commit đến remote
+- `require-pr-before-stop` — đảm bảo PR tồn tại cho nhánh
+- `require-ci-green-before-stop` — tất cả các kiểm tra CI phải vượt qua
+
+Cùng với nhau, những chính sách này thực thi quy trình công việc **commit → push → PR → CI**.
+
+Để cài đặt tất cả các chính sách beta:
+
+```bash
+failproofai policies --install --beta
+```
+
+Hoặc cài đặt các chính sách quy trình công việc cụ thể:
+
+```bash
+failproofai policies --install require-commit-before-stop require-push-before-stop require-pr-before-stop require-ci-green-before-stop
+```
+
+Chạy `failproofai policies` để xem chính sách nào có cờ beta.
+
+---
+
+## Vô hiệu hóa các chính sách riêng lẻ
+
+Xóa một chính sách cụ thể từ `enabledPolicies` trong config của bạn, hoặc tắt nó trong tab Policies của dashboard.
+
+```json
+{
+  "enabledPolicies": [
+    "block-rm-rf",
+    "sanitize-api-keys"
+  ]
+}
+```
+
+Các chính sách không được liệt kê trong `enabledPolicies` không chạy, ngay cả khi có mục nhập `policyParams` cho chúng.

package/.next/standalone/docs/vi/cli/dashboard.mdx

@@ -0,0 +1,28 @@
+---
+title: Xem các phiên làm việc
+description: "Khởi động bảng điều khiển để duyệt các phiên agent và quản lý chính sách"
+---
+
+```bash
+failproofai
+```
+
+Khởi động bảng điều khiển web tại `http://localhost:8020`.
+
+## Tùy chọn
+
+| Flag | Mô tả |
+|------|-------|
+| `--port <number>` | Cổng để lắng nghe (mặc định: `8020`) |
+| `--projects-path <path>` | Ghi đè vị trí tìm kiếm các thư mục dự án Claude Code |
+| `--allowed-origins <origins>` | Các máy chủ/IP được phân cách bằng dấu phẩy được phép truy cập tài nguyên phát triển |
+
+## Ví dụ
+
+```bash
+# Khởi động trên cổng khác
+failproofai --port 9000
+
+# Sử dụng đường dẫn dự án tùy chỉnh
+failproofai --projects-path ~/my-claude-projects
+```

package/.next/standalone/docs/vi/cli/environment-variables.mdx

@@ -0,0 +1,34 @@
+---
+title: Biến môi trường
+description: "Cấu hình hành vi của failproofai bằng các biến môi trường"
+---
+
+## Dashboard
+
+| Biến | Mô tả |
+|----------|-------------|
+| `PORT` | Cổng dashboard (mặc định: `8020`) |
+| `CLAUDE_PROJECTS_PATH` | Ghi đè vị trí tìm thấy các thư mục dự án Claude Code |
+| `FAILPROOFAI_DISABLE_PAGES=policies,projects` | Các trang dashboard được ẩn, cách nhau bởi dấu phẩy |
+| `FAILPROOFAI_ALLOWED_DEV_ORIGINS` | Các máy chủ/IP được phép truy cập tài nguyên dev. Tương tự như `--allowed-origins`. |
+
+## Logging
+
+| Biến | Mô tả |
+|----------|-------------|
+| `FAILPROOFAI_LOG_LEVEL=info\|warn\|error` | Mức độ ghi nhật ký máy chủ (mặc định: `warn`) |
+| `FAILPROOFAI_HOOK_LOG_FILE` | Đường dẫn tệp nhật ký hook tùy chỉnh, hoặc `true` cho mặc định (`~/.failproofai/logs/hooks.log`) |
+
+## Telemetry
+
+| Biến | Mô tả |
+|----------|-------------|
+| `FAILPROOFAI_TELEMETRY_DISABLED=1` | Vô hiệu hóa telemetry sử dụng ẩn danh |
+
+## LLM (để đánh giá chính sách)
+
+| Biến | Mô tả |
+|----------|-------------|
+| `FAILPROOFAI_LLM_BASE_URL` | Điểm cuối API LLM (mặc định: `https://api.openai.com/v1`) |
+| `FAILPROOFAI_LLM_API_KEY` | Khóa API cho chính sách được hỗ trợ bởi LLM |
+| `FAILPROOFAI_LLM_MODEL` | Tên mô hình (mặc định: `gpt-4o-mini`) |

package/.next/standalone/docs/vi/cli/hook.mdx

@@ -0,0 +1,30 @@
+---
+title: Hook handler (internal)
+description: "Subprocess mà Claude Code gọi trên mỗi sự kiện công cụ"
+---
+
+```bash
+failproofai --hook <EventType>
+```
+
+Đây là lệnh được đăng ký trong `settings.json` của Claude Code bởi `failproofai policies --install`. Bạn thường không gọi trực tiếp lệnh này.
+
+Đọc một payload JSON từ stdin, đánh giá tất cả các chính sách được bật, và thoát với mã code chỉ định quyết định:
+
+| Mã thoát | Quyết định | Hiệu ứng |
+|-----------|------------|---------|
+| `0` | `allow` | Cho phép hành động |
+| `1` | `deny` | Chặn hành động - Claude sẽ thấy lý do từ chối |
+| `2` | `instruct` | Injected hướng dẫn vào ngữ cảnh của Claude |
+
+### Các loại sự kiện được hỗ trợ
+
+| Danh mục | Sự kiện |
+|----------|---------|
+| **Thực thi công cụ** | `PreToolUse`, `PostToolUse`, `PostToolUseFailure`, `PermissionRequest`, `PermissionDenied` |
+| **Vòng đời phiên** | `SessionStart`, `SessionEnd`, `Stop`, `StopFailure` |
+| **Tương tác người dùng** | `UserPromptSubmit`, `Notification`, `Elicitation`, `ElicitationResult` |
+| **Subagents & tác vụ** | `SubagentStart`, `SubagentStop`, `TaskCreated`, `TaskCompleted`, `TeammateIdle` |
+| **Cấu hình** | `InstructionsLoaded`, `ConfigChange`, `CwdChanged` |
+| **Hệ thống tệp** | `FileChanged`, `WorktreeCreate`, `WorktreeRemove` |
+| **Ngữ cảnh** | `PreCompact`, `PostCompact` |