failproofai 0.0.5 → 0.0.6-beta.0

package/.next/standalone/docs/vi/configuration.mdx

@@ -4,7 +4,7 @@ description: "Định dạng tệp cấu hình, hệ thống ba phạm vi và qu
 icon: gear
 ---
 
-failproofai sử dụng các tệp cấu hình JSON để kiểm soát các chính sách nào được kích hoạt, cách chúng hoạt động và nơi tải các chính sách tùy chỉnh. Cấu hình được thiết kế để dễ dàng chia sẻ với nhóm của bạn - cam kết nó vào repo của bạn và mỗi nhà phát triển sẽ nhận được cùng một lưới an toàn tác nhân.
+failproofai sử dụng các tệp cấu hình JSON để kiểm soát những chính sách nào đang hoạt động, cách chúng hoạt động và nơi các chính sách tùy chỉnh được tải. Cấu hình được thiết kế để dễ dàng chia sẻ với đội của bạn - cam kết nó vào kho của bạn và mỗi nhà phát triển sẽ nhận được cùng một lưới bảo mạng cho agent.
 
 ---
 
@@ -13,32 +13,32 @@ failproofai sử dụng các tệp cấu hình JSON để kiểm soát các chí
 Có ba phạm vi cấu hình, được đánh giá theo thứ tự ưu tiên:
 
 | Phạm vi | Đường dẫn tệp | Mục đích |
-|--------|--------------|---------|
-| **project** | `.failproofai/policies-config.json` | Cài đặt trên mỗi repo, được cam kết vào kiểm soát phiên bản |
-| **local** | `.failproofai/policies-config.local.json` | Ghi đè cá nhân trên mỗi repo, được gitignore |
-| **global** | `~/.failproofai/policies-config.json` | Giá trị mặc định ở cấp người dùng trên tất cả các dự án |
+|-------|-----------|---------|
+| **project** | `.failproofai/policies-config.json` | Cài đặt cho mỗi kho, được cam kết vào kiểm soát phiên bản |
+| **local** | `.failproofai/policies-config.local.json` | Ghi đè cá nhân cho mỗi kho, được gitignore |
+| **global** | `~/.failproofai/policies-config.json` | Mặc định cấp người dùng trên tất cả các dự án |
 
-Khi failproofai nhận một sự kiện hook, nó tải và hợp nhất cả ba tệp tồn tại cho thư mục làm việc hiện tại.
+Khi failproofai nhận được sự kiện hook, nó tải và hợp nhất tất cả ba tệp tồn tại cho thư mục làm việc hiện tại.
 
 ### Quy tắc hợp nhất
 
-**`enabledPolicies`** - hợp của tất cả ba phạm vi. Một chính sách được kích hoạt ở bất kỳ mức nào sẽ hoạt động.
+**`enabledPolicies`** - hợp nhất của tất cả ba phạm vi. Một chính sách được bật ở bất kỳ cấp độ nào là hoạt động.
 
 ```text
 project:  ["block-sudo"]
 local:    ["block-rm-rf"]
 global:   ["block-sudo", "sanitize-api-keys"]
 
-resolved: ["block-sudo", "block-rm-rf", "sanitize-api-keys"]  ← loại bỏ trùng lặp
+resolved: ["block-sudo", "block-rm-rf", "sanitize-api-keys"]  ← hợp nhất, loại bỏ trùng lặp
 ```
 
-**`policyParams`** - phạm vi đầu tiên xác định các tham số cho một chính sách nào đó sẽ chiến thắng hoàn toàn. Không có hợp nhất sâu các giá trị trong tham số của một chính sách.
+**`policyParams`** - phạm vi đầu tiên xác định các tham số cho một chính sách cụ thể sẽ thắng hoàn toàn. Không có hợp nhất sâu các giá trị trong các tham số của một chính sách.
 
 ```text
 project:  block-sudo → { allowPatterns: ["sudo apt-get update"] }
 global:   block-sudo → { allowPatterns: ["sudo systemctl status"] }
 
-resolved: { allowPatterns: ["sudo apt-get update"] }   ← project chiến thắng, global bị bỏ qua
+resolved: { allowPatterns: ["sudo apt-get update"] }   ← project thắng, global bị bỏ qua
 ```
 
 ```text
@@ -49,9 +49,9 @@ global:   block-sudo → { allowPatterns: ["sudo systemctl status"] }
 resolved: { allowPatterns: ["sudo systemctl status"] }  ← rơi xuống global
 ```
 
-**`customPoliciesPath`** - phạm vi đầu tiên xác định nó sẽ chiến thắng.
+**`customPoliciesPath`** - phạm vi đầu tiên xác định nó sẽ thắng.
 
-**`llm`** - phạm vi đầu tiên xác định nó sẽ chiến thắng.
+**`llm`** - phạm vi đầu tiên xác định nó sẽ thắng.
 
 ---
 
@@ -102,48 +102,48 @@ resolved: { allowPatterns: ["sudo systemctl status"] }  ← rơi xuống global
 
 Loại: `string[]`
 
-Danh sách tên chính sách cần bật. Tên phải khớp chính xác với các định danh chính sách được hiển thị bởi `failproofai policies`. Xem [Chính sách tích hợp](/vi/built-in-policies) để có danh sách đầy đủ.
+Danh sách tên chính sách để bật. Tên phải khớp chính xác với các định danh chính sách được hiển thị bởi `failproofai policies`. Xem [Built-in Policies](/vi/built-in-policies) để có danh sách đầy đủ.
 
-Các chính sách không nằm trong `enabledPolicies` không hoạt động, ngay cả khi chúng có mục trong `policyParams`.
+Các chính sách không có trong `enabledPolicies` không hoạt động, ngay cả khi chúng có các mục trong `policyParams`.
 
 ### `policyParams`
 
 Loại: `Record<string, Record<string, unknown>>`
 
-Ghi đè tham số cho mỗi chính sách. Khóa bên ngoài là tên chính sách; các khóa bên trong là khóa dành riêng cho chính sách. Mỗi chính sách ghi lại các tham số khả dụng của nó trong [Chính sách tích hợp](/vi/built-in-policies).
+Ghi đè tham số cho mỗi chính sách. Khóa bên ngoài là tên chính sách; các khóa bên trong là dành riêng cho chính sách. Mỗi chính sách ghi lại các tham số có sẵn của nó trong [Built-in Policies](/vi/built-in-policies).
 
-Nếu một chính sách có các tham số nhưng bạn không chỉ định chúng, các giá trị mặc định tích hợp của chính sách sẽ được sử dụng. Người dùng không cấu hình `policyParams` sẽ nhận được hành vi giống hệt như các phiên bản trước đó.
+Nếu một chính sách có các tham số nhưng bạn không chỉ định chúng, các mặc định tích hợp của chính sách sẽ được sử dụng. Những người dùng không cấu hình `policyParams` sẽ nhận được hành vi giống hệt như các phiên bản trước đó.
 
-Các khóa không xác định bên trong khối tham số của một chính sách sẽ bị bỏ qua khi hook được kích hoạt nhưng được đánh dấu là cảnh báo khi bạn chạy `failproofai policies`.
+Các khóa không xác định bên trong khối tham số của một chính sách được bỏ qua âm thầm khi hook kích hoạt nhưng được gắn cờ là cảnh báo khi bạn chạy `failproofai policies`.
 
-#### `hint` (cross-cutting)
+#### `hint` (xuyên suốt)
 
 Loại: `string` (tùy chọn)
 
-Một thông điệp được thêm vào lý do khi một chính sách trả về `deny` hoặc `instruct`. Sử dụng nó để đưa ra hướng dẫn hành động cho Claude mà không cần sửa đổi chính sách.
+Một tin nhắn được nối thêm vào lý do khi một chính sách trả về `deny` hoặc `instruct`. Sử dụng nó để cung cấp hướng dẫn hành động cho Claude mà không cần sửa đổi chính sách.
 
-Hoạt động với bất kỳ loại chính sách nào — tích hợp, tùy chỉnh (`custom/`), quy ước dự án (`.failproofai-project/`), hoặc quy ước người dùng (`.failproofai-user/`).
+Hoạt động với bất kỳ loại chính sách nào — tích hợp sẵn, tùy chỉnh (`custom/`), quy ước dự án (`.failproofai-project/`), hoặc quy ước người dùng (`.failproofai-user/`).
 
 ```json
 {
   "policyParams": {
     "block-force-push": {
-      "hint": "Try creating a fresh branch instead."
+      "hint": "Hãy thử tạo một nhánh mới thay vào đó."
     },
     "block-sudo": {
       "allowPatterns": ["sudo apt-get"],
-      "hint": "Use apt-get directly without sudo."
+      "hint": "Sử dụng apt-get trực tiếp mà không cần sudo."
     },
     "custom/my-policy": {
-      "hint": "Ask the user for approval first."
+      "hint": "Hãy yêu cầu người dùng phê duyệt trước."
     }
   }
 }
 ```
 
-Khi `block-force-push` từ chối, Claude sẽ thấy: *"Force-pushing is blocked. Try creating a fresh branch instead."*
+Khi `block-force-push` từ chối, Claude sẽ thấy: *"Force-pushing bị chặn. Hãy thử tạo một nhánh mới thay vào đó."*
 
-Các giá trị không phải chuỗi và chuỗi rỗng sẽ bị bỏ qua. Nếu `hint` không được đặt, hành vi không thay đổi (tương thích ngược).
+Các giá trị không phải chuỗi và chuỗi trống bị bỏ qua âm thầm. Nếu `hint` không được đặt, hành vi không thay đổi (tương thích ngược).
 
 ### `customPoliciesPath`
 
@@ -151,30 +151,30 @@ Loại: `string` (đường dẫn tuyệt đối)
 
 Đường dẫn đến tệp JavaScript chứa các chính sách hook tùy chỉnh. Điều này được đặt tự động bởi `failproofai policies --install --custom <path>` (đường dẫn được giải quyết thành tuyệt đối trước khi được lưu trữ).
 
-Tệp được tải mới trên mỗi sự kiện hook - không có lưu cache. Xem [Chính sách tùy chỉnh](/vi/custom-policies) để biết chi tiết tác giả.
+Tệp được tải lại trên mỗi sự kiện hook - không có bộ nhớ đệm. Xem [Custom Policies](/vi/custom-policies) để biết chi tiết về tác giả.
 
 ### Chính sách dựa trên quy ước
 
-Ngoài `customPoliciesPath` rõ ràng, failproofai tự động phát hiện và tải các tệp chính sách từ thư mục `.failproofai/policies/`:
+Ngoài `customPoliciesPath` rõ ràng, failproofai tự động khám phá và tải các tệp chính sách từ các thư mục `.failproofai/policies/`:
 
-| Mức | Thư mục | Phạm vi |
-|-----|--------|--------|
-| Dự án | `.failproofai/policies/` | Chia sẻ với nhóm qua kiểm soát phiên bản |
+| Cấp độ | Thư mục | Phạm vi |
+|-------|-----------|-------|
+| Dự án | `.failproofai/policies/` | Được chia sẻ với đội thông qua kiểm soát phiên bản |
 | Người dùng | `~/.failproofai/policies/` | Cá nhân, áp dụng cho tất cả các dự án |
 
-**Khớp tệp:** Chỉ các tệp khớp `*policies.{js,mjs,ts}` được tải (ví dụ: `security-policies.mjs`, `workflow-policies.js`). Các tệp khác trong thư mục sẽ bị bỏ qua.
+**Khớp tệp:** Chỉ các tệp khớp với `*policies.{js,mjs,ts}` được tải (ví dụ `security-policies.mjs`, `workflow-policies.js`). Các tệp khác trong thư mục bị bỏ qua.
 
-**Không cần cấu hình:** Chính sách quy ước không yêu cầu mục nhập trong `policies-config.json`. Chỉ cần thả các tệp vào thư mục và chúng sẽ được nhận trên sự kiện hook tiếp theo.
+**Không cần cấu hình:** Các chính sách quy ước không yêu cầu các mục trong `policies-config.json`. Chỉ cần thả các tệp vào thư mục và chúng sẽ được chọn lên trên sự kiện hook tiếp theo.
 
-**Tải kết hợp:** Cả thư mục quy ước dự án và người dùng đều được quét. Tất cả các tệp phù hợp từ cả hai mức được tải (không giống như `customPoliciesPath` sử dụng first-scope-wins).
+**Tải union:** Cả hai thư mục quy ước dự án và người dùng đều được quét. Tất cả các tệp phù hợp từ cả hai cấp độ được tải (không giống như `customPoliciesPath` sử dụng first-scope-wins).
 
-Xem [Chính sách tùy chỉnh](/vi/custom-policies) để biết thêm chi tiết và ví dụ.
+Xem [Custom Policies](/vi/custom-policies) để biết thêm chi tiết và ví dụ.
 
 ### `llm`
 
 Loại: `object` (tùy chọn)
 
-Cấu hình máy khách LLM cho các chính sách thực hiện các lệnh gọi AI. Không bắt buộc đối với hầu hết các thiết lập.
+Cấu hình máy khách LLM cho các chính sách thực hiện các lệnh gọi AI. Không bắt buộc cho hầu hết các thiết lập.
 
 ```json
 {
@@ -189,18 +189,18 @@ Cấu hình máy khách LLM cho các chính sách thực hiện các lệnh gọ
 
 ## Quản lý cấu hình từ CLI
 
-Các lệnh `policies --install` và `policies --uninstall` ghi vào `settings.json` của Claude Code (các điểm vào hook), trong khi `policies-config.json` là tệp bạn quản lý trực tiếp. Hai cái này là riêng biệt:
+Các lệnh `policies --install` và `policies --uninstall` ghi vào `settings.json` của Claude Code (các điểm nhập hook), trong khi `policies-config.json` là tệp bạn quản lý trực tiếp. Hai tệp này là riêng biệt:
 
 - **`settings.json`** - yêu cầu Claude Code gọi `failproofai --hook <event>` trên mỗi lần sử dụng công cụ
-- **`policies-config.json`** - yêu cầu failproofai đánh giá chính sách nào và với những tham số nào
+- **`policies-config.json`** - yêu cầu failproofai đánh giá những chính sách nào và với những tham số nào
 
-Bạn có thể chỉnh sửa `policies-config.json` trực tiếp bất kỳ lúc nào; các thay đổi có hiệu lực ngay trên sự kiện hook tiếp theo mà không cần khởi động lại.
+Bạn có thể chỉnh sửa `policies-config.json` trực tiếp bất kỳ lúc nào; những thay đổi có hiệu lực ngay lập tức trên sự kiện hook tiếp theo mà không cần khởi động lại.
 
 ---
 
-## Ví dụ: cấu hình cấp dự án với giá trị mặc định nhóm
+## Ví dụ: cấu hình cấp dự án với mặc định đội
 
-Cam kết `.failproofai/policies-config.json` vào repo của bạn:
+Cam kết `.failproofai/policies-config.json` vào kho của bạn:
 
 ```json
 {
@@ -219,4 +219,4 @@ Cam kết `.failproofai/policies-config.json` vào repo của bạn:
 }
 ```
 
-Mỗi nhà phát triển sau đó có thể tạo `.failproofai/policies-config.local.json` (được gitignore) cho các ghi đè cá nhân mà không ảnh hưởng đến đồng nghiệp.
+Sau đó, mỗi nhà phát triển có thể tạo `.failproofai/policies-config.local.json` (được gitignore) cho các ghi đè cá nhân mà không ảnh hưởng đến đồng đội.

package/.next/standalone/docs/vi/custom-policies.mdx

@@ -1,10 +1,10 @@
 ---
-title: Chính sách Tùy chỉnh
-description: "Viết các quy tắc riêng của bạn bằng JavaScript - thực thi các quy ước, ngăn chặn sự trôi dạt, phát hiện các lỗi, tích hợp với các hệ thống bên ngoài"
+title: Chính sách tùy chỉnh
+description: "Viết các quy tắc của riêng bạn bằng JavaScript - thực thi các quy ước, ngăn chặn độ dịch, phát hiện lỗi, tích hợp với các hệ thống bên ngoài"
 icon: code
 ---
 
-Chính sách tùy chỉnh cho phép bạn viết các quy tắc cho bất kỳ hành động của agent nào: thực thi các quy ước dự án, ngăn chặn sự trôi dạt, chặn các hoạt động có tính hủy diệt, phát hiện các agent bị kẹt, hoặc tích hợp với Slack, quy trình phê duyệt, v.v. Chúng sử dụng cùng một hệ thống sự kiện hook và các quyết định `allow`, `deny`, `instruct` như các chính sách tích hợp.
+Chính sách tùy chỉnh cho phép bạn viết các quy tắc cho bất kỳ hành vi agent nào: thực thi quy ước dự án, ngăn chặn độ dịch, hạn chế các phép toán có tính chất phá hoại, phát hiện các agent bị kẹt, hoặc tích hợp với Slack, quy trình phê duyệt, và nhiều hơn nữa. Chúng sử dụng cùng hệ thống sự kiện hook và các quyết định `allow`, `deny`, `instruct` như các chính sách tích hợp sẵn.
 
 ---
 
@@ -39,31 +39,31 @@ failproofai policies --install --custom ./my-policies.js
 
 ## Hai cách để tải chính sách tùy chỉnh
 
-### Lựa chọn 1: Dựa trên quy ước (được khuyến nghị)
+### Tùy chọn 1: Dựa trên quy ước (được khuyên dùng)
 
-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ờ hoặc thay đổi cấu hình. Cách này hoạt động giống như git hooks: thả một tệp, nó sẽ hoạt động.
+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ờ hoặc thay đổi cấu hình. Điều này hoạt động giống như git hooks: thả một tệp, nó chỉ hoạt động.
 
 ```
-# Mức dự án — được cam kết với git, chia sẻ với đội
+# Cấp độ dự án — được cam kết với git, được chia sẻ với nhóm
 .failproofai/policies/security-policies.mjs
 .failproofai/policies/workflow-policies.mjs
 
-# Mức người dùng — cá nhân, áp dụng cho tất cả các dự án
+# 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ách hoạt động:**
-- Cả hai thư mục dự án và người dùng được quét (union — không phải first-scope-wins)
-- Các tệp được tải theo thứ tự bảng chữ cái trong mỗi thư mục. Thêm tiền tố `01-`, `02-` để kiểm soát thứ tự
+- Cả hai thư mục dự án và người dùng được quét (liên hợp — không phải first-scope-wins)
+- Các tệp được tải theo thứ tự bảng chữ cái trong mỗi thư mục. Đặt tiền tố với `01-`, `02-` để kiểm soát thứ tự
 - Chỉ các tệp khớp với `*policies.{js,mjs,ts}` được tải; các tệp khác bị bỏ qua
-- Mỗi tệp được tải độc lập (fail-open cho mỗi tệp)
-- Hoạt động cùng với các chính sách `--custom` rõ ràng và tích hợp
+- Mỗi tệp được tải độc lập (fail-open trên mỗi tệp)
+- Hoạt động cùng với các chính sách `--custom` tường minh và chính sách tích hợp sẵn
 
 <Tip>
-Chính sách quy ước là cách dễ nhất để chia sẻ chính sách trên toàn đội. Cam kết `.failproofai/policies/` với git và mỗi thành viên đội sẽ tự động nhận được chúng.
+Chính sách quy ước là cách dễ nhất để chia sẻ chính sách trên toàn nhóm. Cam kết `.failproofai/policies/` với git và mỗi thành viên nhóm sẽ nhận được chúng tự động.
 </Tip>
 
-### Lựa chọn 2: Đường dẫn tệp rõ ràng
+### Tùy chọn 2: Đường dẫn tệp tường minh
 
 ```bash
 # Cài đặt với tệp chính sách tùy chỉnh
@@ -76,13 +76,13 @@ failproofai policies --install --custom ./new-policies.js
 failproofai policies --uninstall --custom
 ```
 
-Đường dẫn tuyệt đối được phân giải được lưu trữ trong `policies-config.json` dưới dạng `customPoliciesPath`. Tệp được tải lại trên mỗi sự kiện hook - không có bộ nhớ cache giữa các sự kiện.
+Đường dẫn tuyệt đối đã được phân giải được lưu trữ trong `policies-config.json` dưới dạng `customPoliciesPath`. Tệp được tải lại trên mỗi sự kiện hook - không có bộ đệm ẩm giữa các sự kiện.
 
 ### Sử dụng cả hai cùng nhau
 
-Chính sách quy ước và tệp `--custom` rõ ràng có thể cùng tồn tại. Thứ tự tải:
+Chính sách quy ước và tệp `--custom` tường minh có thể cùng tồn tại. Thứ tự tải:
 
-1. Tệp `customPoliciesPath` rõ ràng (nếu được cấu hình)
+1. Tệp `customPoliciesPath` tường minh (nếu được cấu hình)
 2. Tệp quy ước dự án (`{cwd}/.failproofai/policies/`, theo thứ tự bảng chữ cái)
 3. Tệp quy ước người dùng (`~/.failproofai/policies/`, theo thứ tự bảng chữ cái)
 
@@ -98,7 +98,7 @@ import { customPolicies, allow, deny, instruct } from "failproofai";
 
 ### `customPolicies.add(hook)`
 
-Đăng ký một chính sách. Gọi hàm này bao nhiêu lần cần thiết cho nhiều chính sách trong cùng một tệp.
+Đăng ký một chính sách. Gọi nhiều lần nếu cần cho nhiều chính sách trong cùng một tệp.
 
 ```ts
 customPolicies.add({
@@ -111,33 +111,32 @@ customPolicies.add({
 
 ### Trợ giúp quyết định
 
-| Hàm | Tác động | Sử dụng khi |
-|-----|---------|-----------|
+| Hàm | Hiệu ứng | Sử dụng khi |
+|----------|--------|----------|
 | `allow()` | Cho phép hoạt động im lặng | Hành động an toàn, không cần tin nhắn |
 | `deny(message)` | Chặn hoạt động | Agent không nên thực hiện hành động này |
-| `instruct(message)` | Thêm bối cảnh mà không chặn | Cung cấp cho agent bối cảnh bổ sung để tiếp tục theo đúng hướng |
+| `instruct(message)` | Thêm ngữ cảnh mà không chặn | Cung cấp ngữ cảnh bổ sung để agent ở đúng track |
 
-`deny(message)` - thông báo sẽ xuất hiện cho Claude với tiền tố `"Blocked by failproofai:"`. Một `deny` duy nhất sẽ ngắt khoá tất cả các đánh giá tiếp theo.
+`deny(message)` - tin nhắn xuất hiện với Claude với tiền tố `"Blocked by failproofai:"`. Một `deny` duy nhất sẽ làm ngắn mạch tất cả đánh giá tiếp theo.
 
-`instruct(message)` - thông báo được nối thêm vào bối cảnh của Claude cho lệnh gọi công cụ hiện tại. Tất cả các thông báo `instruct` được tích lũy và gửi cùng nhau.
+`instruct(message)` - tin nhắn được thêm vào ngữ cảnh của Claude cho cuộc gọi công cụ hiện tại. Tất cả các tin nhắn `instruct` được tích lũy và gửi cùng nhau.
 
 <Tip>
-Bạn có thể nối thêm hướng dẫn bổ sung vào bất kỳ thông báo `deny` hoặc `instruct` nào bằng cách thêm trường `hint` trong `policyParams` — không cần thay đổi mã. Điều này hoạt động cho các chính sách tùy chỉnh (`custom/`), quy ước dự án (`.failproofai-project/`), và quy ước người dùng (`.failproofai-user/`) cũng vậy. Xem [Cấu hình → hint](/vi/configuration#hint-cross-cutting) để biết chi tiết.
+Bạn có thể thêm hướng dẫn bổ sung vào bất kỳ tin nhắn `deny` hoặc `instruct` nào bằng cách thêm trường `hint` trong `policyParams` — không cần thay đổi mã. Điều này hoạt động cho các chính sách tùy chỉnh (`custom/`), quy ước dự án (`.failproofai-project/`), và quy ước người dùng (`.failproofai-user/`) cũng vậy. Xem [Configuration → hint](/vi/configuration#hint-cross-cutting) để biết chi tiết.
 </Tip>
 
-### Thông báo allow thông tin
+### Tin nhắn allow mang tính thông tin
 
+`allow(message)` cho phép hoạt động **và** gửi lại một tin nhắn mang tính thông tin cho Claude. Tin nhắn được gửi dưới dạng `additionalContext` trong phản hồi stdout của trình xử lý hook — cùng một cơ chế được sử dụng bởi `instruct`, nhưng khác nhau về mặt ngữ nghĩa: đó là một bản cập nhật trạng thái, không phải một cảnh báo.
 
-`allow(message)` cho phép hoạt động **và** gửi một thông báo thông tin quay lại cho Claude. Thông báo được gửi dưới dạng `additionalContext` trong phản hồi stdout của trình xử lý hook — cơ chế tương tự được sử dụng bởi `instruct`, nhưng về mặt ngữ nghĩa khác: đó là một cập nhật trạng thái, không phải cảnh báo.
+| Hàm | Hiệu ứng | Sử dụng khi |
+|----------|--------|----------|
+| `allow(message)` | Cho phép và gửi ngữ cảnh cho Claude | Xác nhận kiểm tra đã vượt qua, hoặc giải thích tại sao kiểm tra bị bỏ qua |
 
-| Hàm | Tác động | Sử dụng khi |
-|-----|---------|-----------|
-| `allow(message)` | Cho phép và gửi bối cảnh cho Claude | Xác nhận kiểm tra đã vượt qua, hoặc giải thích tại sao một kiểm tra bị bỏ qua |
-
-Các trường hợp sử dụng:
-- **Xác nhận trạng thái:** `allow("All CI checks passed.")` — cho Claude biết mọi thứ đang ổn
-- **Giải thích fail-open:** `allow("GitHub CLI not installed, skipping CI check.")` — cho Claude biết tại sao một kiểm tra bị bỏ qua để nó có đầy đủ bối cảnh
-- **Nhiều thông báo tích lũy:** nếu nhiều chính sách mỗi cái trả về `allow(message)`, tất cả các thông báo được nối lại bằng dòng mới và gửi cùng nhau
+Trường hợp sử dụng:
+- **Xác nhận trạng thái:** `allow("All CI checks passed.")` — cho Claude biết tất cả đều xanh
+- **Giải thích fail-open:** `allow("GitHub CLI not installed, skipping CI check.")` — cho Claude biết tại sao kiểm tra bị bỏ qua để nó có bối cảnh đầy đủ
+- **Nhiều tin nhắn tích lũy:** nếu nhiều chính sách trả về `allow(message)`, tất cả các tin nhắn được nối với dòng mới và gửi cùng nhau
 
 ```js
 customPolicies.add({
@@ -158,29 +157,29 @@ customPolicies.add({
 
 ### Các trường `PolicyContext`
 
-| Trường | Loại | Mô tả |
-|--------|------|-------|
+| Trường | Kiểu | Mô tả |
+|-------|------|-------------|
 | `eventType` | `string` | `"PreToolUse"`, `"PostToolUse"`, `"Notification"`, `"Stop"` |
-| `toolName` | `string \| undefined` | Công cụ được gọi (ví dụ: `"Bash"`, `"Write"`, `"Read"`) |
+| `toolName` | `string \| undefined` | Công cụ đang được gọi (ví dụ: `"Bash"`, `"Write"`, `"Read"`) |
 | `toolInput` | `Record<string, unknown> \| undefined` | Các tham số đầu vào của công cụ |
-| `payload` | `Record<string, unknown>` | Toàn bộ tải trọng sự kiện thô từ Claude Code |
-| `session` | `SessionMetadata \| undefined` | Bối cảnh phiên (xem bên dưới) |
+| `payload` | `Record<string, unknown>` | Tải trọng sự kiện thô đầy đủ từ Claude Code |
+| `session` | `SessionMetadata \| undefined` | Ngữ cảnh phiên (xem bên dưới) |
 
 ### Các trường `SessionMetadata`
 
-| Trường | Loại | Mô tả |
-|--------|------|-------|
-| `sessionId` | `string` | Mã định danh phiên Claude Code |
+| Trường | Kiểu | Mô tả |
+|-------|------|-------------|
+| `sessionId` | `string` | Định danh phiên Claude Code |
 | `cwd` | `string` | Thư mục làm việc của phiên Claude Code |
-| `transcriptPath` | `string` | Đường dẫn đến tệp transcript JSONL của phiên |
+| `transcriptPath` | `string` | Đường dẫn đến tệp bản ghi JSONL của phiên |
 
 ### Các loại sự kiện
 
-| Sự kiện | Khi nó kích hoạt | Nội dung `toolInput` |
-|--------|-----------------|-----------------|
+| Sự kiện | Khi nó xảy ra | Nội dung `toolInput` |
+|-------|--------------|----------------------|
 | `PreToolUse` | Trước khi Claude chạy một công cụ | Đầu vào của công cụ (ví dụ: `{ command: "..." }` cho Bash) |
-| `PostToolUse` | Sau khi một công cụ hoàn thành | Đầu vào của công cụ + `tool_result` (đầu ra) |
-| `Notification` | Khi Claude gửi thông báo | `{ message: "...", notification_type: "idle" \| "permission_prompt" \| ... }` - hooks phải luôn trả về `allow()`, chúng không thể chặn thông báo |
+| `PostToolUse` | Sau khi một công cụ hoàn tất | Đầu vào của công cụ + `tool_result` (đầu ra) |
+| `Notification` | Khi Claude gửi thông báo | `{ message: "...", notification_type: "idle" \| "permission_prompt" \| ... }` - các hook phải luôn trả về `allow()`, chúng không thể chặn thông báo |
 | `Stop` | Khi phiên Claude kết thúc | Trống |
 
 ---
@@ -189,18 +188,18 @@ customPolicies.add({
 
 Chính sách được đánh giá theo thứ tự này:
 
-1. Chính sách tích hợp (theo thứ tự định nghĩa)
-2. Chính sách tùy chỉnh rõ ràng từ `customPoliciesPath` (theo thứ tự `.add()`)
-3. Chính sách quy ước từ dự án `.failproofai/policies/` (tệp theo thứ tự bảng chữ cái, `.add()` theo thứ tự trong)
-4. Chính sách quy ước từ người dùng `~/.failproofai/policies/` (tệp theo thứ tự bảng chữ cái, `.add()` theo thứ tự trong)
+1. Chính sách tích hợp sẵn (theo thứ tự định nghĩa)
+2. Chính sách tùy chỉnh tường minh từ `customPoliciesPath` (theo thứ tự `.add()`)
+3. Chính sách quy ước từ dự án `.failproofai/policies/` (tệp theo thứ tự bảng chữ cái, thứ tự `.add()` bên trong)
+4. Chính sách quy ước từ người dùng `~/.failproofai/policies/` (tệp theo thứ tự bảng chữ cái, thứ tự `.add()` bên trong)
 
 <Note>
-`deny` đầu tiên sẽ ngắt khoá tất cả các chính sách tiếp theo. Tất cả các thông báo `instruct` được tích lũy và gửi cùng nhau.
+`deny` đầu tiên làm ngắn mạch tất cả các chính sách tiếp theo. Tất cả các tin nhắn `instruct` được tích lũy và gửi cùng nhau.
 </Note>
 
 ---
 
-## Nhập transitive
+## Nhập khẩu Transitive
 
 Các tệp chính sách tùy chỉnh có thể nhập các mô-đun cục bộ bằng cách sử dụng đường dẫn tương đối:
 
@@ -219,13 +218,13 @@ customPolicies.add({
 });
 ```
 
-Tất cả các nhập tương đối có thể tiếp cận từ tệp nhập được phân giải. Điều này được triển khai bằng cách viết lại các nhập `from "failproofai"` thành đường dẫn dist thực tế và tạo các tệp `.mjs` tạm thời để đảm bảo tương thích ESM.
+Tất cả các nhập khẩu tương đối có thể đạt được từ tệp mục nhập được phân giải. Điều này được triển khai bằng cách viết lại các nhập `from "failproofai"` đến đường dẫn dist thực tế và tạo tệp `.mjs` tạm thời để đảm bảo tính tương thích ESM.
 
 ---
 
 ## Lọc loại sự kiện
 
-Sử dụng `match.events` để giới hạn khi một chính sách kích hoạt:
+Sử dụng `match.events` để hạn chế khi chính sách kích hoạt:
 
 ```js
 customPolicies.add({
@@ -239,22 +238,22 @@ customPolicies.add({
 });
 ```
 
-Bỏ qua `match` hoàn toàn để kích hoạt trên mọi loại sự kiện.
+Bỏ qua `match` hoàn toàn để kích hoạt cho mọi loại sự kiện.
 
 ---
 
 ## Xử lý lỗi và chế độ lỗi
 
-Chính sách tùy chỉnh là **fail-open**: các lỗi không bao giờ chặn chính sách tích hợp hoặc làm hỏng trình xử lý hook.
+Chính sách tùy chỉnh là **fail-open**: lỗi không bao giờ chặn các chính sách tích hợp sẵn hoặc làm xảy ra sự cố trình xử lý hook.
 
 | Lỗi | Hành vi |
-|-----|--------|
-| `customPoliciesPath` không được đặt | Không có chính sách tùy chỉnh rõ ràng chạy; chính sách quy ước và tích hợp tiếp tục bình thường |
-| Tệp không tìm thấy | Cảnh báo được ghi vào `~/.failproofai/hook.log`; tích hợp tiếp tục |
-| Lỗi cú pháp/nhập (rõ ràng) | Lỗi được ghi vào `~/.failproofai/hook.log`; chính sách tùy chỉnh rõ ràng bị bỏ qua |
+|---------|----------|
+| `customPoliciesPath` không được đặt | Không có chính sách tùy chỉnh tường minh chạy; chính sách quy ước và tích hợp sẵn tiếp tục bình thường |
+| Tệp không tìm thấy | Cảnh báo được ghi vào `~/.failproofai/hook.log`; tích hợp sẵn tiếp tục |
+| Lỗi cú pháp/nhập (tường minh) | Lỗi được ghi vào `~/.failproofai/hook.log`; chính sách tùy chỉnh tường minh bị bỏ qua |
 | Lỗi cú pháp/nhập (quy ước) | Lỗi được ghi; tệp đó bị bỏ qua, các tệp quy ước khác vẫn tải |
-| `fn` ném tại thời gian chạy | Lỗi được ghi; hook đó được coi là `allow`; các hook khác tiếp tục |
-| `fn` mất lâu hơn 10 giây | Timeout được ghi; được coi là `allow` |
+| `fn` ném lỗi ở thời gian chạy | Lỗi được ghi; hook đó được coi là `allow`; các hook khác tiếp tục |
+| `fn` mất thời gian lâu hơn 10 giây | Hết thời gian được ghi; được coi là `allow` |
 | Thư mục quy ước bị thiếu | Không có chính sách quy ước chạy; không có lỗi |
 
 <Tip>
@@ -324,22 +323,22 @@ export { customPolicies };
 
 ## Ví dụ
 
-Thư mục `examples/` chứa các tệp chính sách sẵn sàng để chạy:
+Thư mục `examples/` chứa các tệp chính sách sẵn sàng chạy:
 
 | Tệp | Nội dung |
-|-----|---------|
+|------|----------|
 | `examples/policies-basic.js` | Năm chính sách khởi động bao gồm các chế độ lỗi agent phổ biến |
-| `examples/policies-advanced/index.js` | Mô hình nâng cao: nhập transitive, gọi không đồng bộ, làm sạch đầu ra, và hook kết thúc phiên |
+| `examples/policies-advanced/index.js` | Các mẫu nâng cao: nhập khẩu transitive, cuộc gọi không đồng bộ, scrubbing đầu ra, và các hook khi kết thúc phiên |
 | `examples/convention-policies/security-policies.mjs` | Chính sách bảo mật dựa trên quy ước (chặn ghi .env, ngăn chặn viết lại lịch sử git) |
-| `examples/convention-policies/workflow-policies.mjs` | Chính sách quy trình làm việc dựa trên quy ước (nhắc nhở kiểm tra, tệp ghi kiểm toán) |
+| `examples/convention-policies/workflow-policies.mjs` | Chính sách quy trình làm việc dựa trên quy ước (nhắc nhở kiểm tra, kiểm toán ghi tệp) |
 
-### Sử dụng các ví dụ tệp rõ ràng
+### Sử dụng ví dụ tệp tường minh
 
 ```bash
 failproofai policies --install --custom ./examples/policies-basic.js
 ```
 
-### Sử dụng các ví dụ dựa trên quy ước
+### Sử dụng ví dụ dựa trên quy ước
 
 ```bash
 # Copy to project level
@@ -351,4 +350,4 @@ mkdir -p ~/.failproofai/policies
 cp examples/convention-policies/*.mjs ~/.failproofai/policies/
 ```
 
-Không cần lệnh cài đặt — các tệp sẽ được chọn tự động khi sự kiện hook tiếp theo.
+Không cần lệnh cài đặt — các tệp được nhặt lên tự động trên sự kiện hook tiếp theo.