npm - failproofai - Versions diffs - 0.0.6-beta.2 → 0.0.6-beta.4 - Mend

failproofai 0.0.6-beta.2 → 0.0.6-beta.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (511) hide show

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

@@ -1,575 +0,0 @@
----
----
-title: Chính sách tích hợp sẵn
-description: "30 chính sách tích hợp sẵn giúp bắt các chế độ lỗi thông thường của agent"
-icon: shield
----
-failproofai được cung cấp với 30 chính sách tích hợp sẵn giúp bắt các chế độ lỗi thông thường của agent. Mỗi chính sách được kích hoạt trên một loại sự kiện hook cụ thể và tên công cụ. 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 mã. Bốn chính sách quy trình làm việc thực thi đường ống commit → push → PR → CI trước khi Claude dừng lại.
----
-## Tổng quan
-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](#lệnh-nguy-hiểm) | block-sudo, block-rm-rf, block-curl-pipe-sh, block-failproofai-commands | PreToolUse |
-| [Bí mật (bộ làm sạch)](#bí-mật-bộ-làm-sạch) | sanitize-jwt, sanitize-api-keys, sanitize-connection-strings, sanitize-private-key-content, sanitize-bearer-tokens | PostToolUse |
-| [Môi trường](#môi-trường) | block-env-files, protect-env-vars | PreToolUse |
-| [Truy cập tệp](#truy-cập-tệp) | 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](#cơ-sở-dữ-liệu) | warn-destructive-sql, warn-schema-alteration | PreToolUse |
-| [Cảnh báo](#cảnh-báo) | warn-large-file-write, warn-package-publish, warn-background-process, warn-global-package-install | PreToolUse |
-| [Trình quản lý gói](#trình-quản-lý-gói) | prefer-package-manager | PreToolUse |
-| [Quy trình làm việc](#quy-trình-làm-việc) | require-commit-before-stop, require-push-before-stop, require-pr-before-stop, require-ci-green-before-stop | Stop |
-- **`block-`** — dừng agent không được tiếp tục.
-- **`warn-`** — cung cấp cho agent ngữ cảnh bổ sung để nó có thể tự sửa.
-- **`sanitize-`** — loại bỏ dữ liệu nhạy cảm từ đầu ra công cụ 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ợ một trường `hint` tùy chọn trong `policyParams`. Hint được thêm vào thông báo deny hoặc instruct mà Claude nhìn thấy, cung cấp hướng dẫn có thể hành động mà không cần sửa đổi mã 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 chặ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ủ.
-### `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ời gọi bao gồm 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, không phải chuỗi thô, để ngăn chặn vòng qua injection toán tử shell.
-**Tham số:**
-| Tham số | Loại | 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. |
-**Ví dụ:**
-```json
-{
-  "policyParams": {
-    "block-sudo": {
-      "allowPatterns": ["sudo systemctl status", "sudo journalctl"]
-    }
-  }
-}
-```
-Với cấu hình 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, không phải chuỗi lệnh thô. Điều này ngăn chặn vòng qua các toán tử shell được nối thêm (ví dụ: `sudo systemctl status x; rm -rf /` không khớp `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ố | Loại | Mặc định | Mô tả |
-|-------|------|---------|-------------|
-| `allowPaths` | `string[]` | `[]` | Đườ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 (bộ làm sạch)
-Ngăn chặn agent rò rỉ thông tin xác thực vào ngữ cảnh hoặc đầu ra của chúng. Chính sách bộ làm sạch được 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ỳ công cụ nào, những chính sách này kiểm tra đầu ra trước khi nó được trả lại 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 không được chuyển lại.
-### `sanitize-jwt`
-**Sự kiện:** PostToolUse (tất cả công cụ)
-**Mặc định:** Redact các token JWT (ba segment base64url được phân tách bằng `.`).
-Không có tham số.
----
-### `sanitize-api-keys`
-**Sự kiện:** PostToolUse (tất cả công cụ)
-**Mặc định:** Redact các định dạng khóa API thông thường: Anthropic (`sk-ant-`), OpenAI (`sk-`), GitHub PATs (`ghp_`), khóa truy cập AWS (`AKIA`), khóa Stripe (`sk_live_`, `sk_test_`) và khóa Google API (`AIza`).
-**Tham số:**
-| Tham số | Loại | 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ả công cụ)
-**Mặc định:** Redact các chuỗi kết nối cơ sở dữ liệu chứa thông tin xác thực đượ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ả công cụ)
-**Mặc định:** Redact 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ả công cụ)
-**Mặc định:** Redact 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ếp xúc.
-### `block-env-files`
-**Sự kiện:** PreToolUse (Bash, Read)
-**Mặc định:** Từ chối đọc các tệp `.env` thông qua `cat .env`, gọi công cụ Read với `.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 tên chính xác `.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 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 bên trong ranh giới dự án và xa khỏi 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 bên ngoài thư mục làm việc hiện tại (gốc dự án).
-**Tham số:**
-| Tham số | Loại | Mặc định | Mô tả |
-|-------|------|---------|-------------|
-| `allowPaths` | `string[]` | `[]` | Tiền tố đường dẫn tuyệt đối được phép ngay cả khi bên 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 và chứng chỉ: `id_rsa`, `id_ed25519`, `*.key`, `*.pem`, `*.p12`, `*.pfx`.
-**Tham số:**
-| Tham số | Loại | 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 đẩy (push) không cố ý, force-push và các sai lầm nhánh 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ố | Loại | Mặc định | Mô tả |
-|-------|------|---------|-------------|
-| `protectedBranches` | `string[]` | `["main", "master"]` | Tên nhánh không thể được đẩy trực tiếp. |
-**Ví dụ:**
-```json
-{
-  "policyParams": {
-    "block-push-master": {
-      "protectedBranches": ["main", "master", "release", "prod"]
-    }
-  }
-}
-```
-<Tip>
-Để cho phép đẩy đến tất cả các nhánh (có hiệu lực vô hiệu hóa chính sách này mà không xóa nó khỏi `enabledPolicies`), hãy đặt `protectedBranches: []`.
-</Tip>
----
-### `block-work-on-main`
-**Sự kiện:** PreToolUse (Bash)
-**Mặc định:** Từ chối kiểm tra trực tiếp các nhánh `main` hoặc `master`.
-**Tham số:**
-| Tham số | Loại | Mặc định | Mô tả |
-|-------|------|---------|-------------|
-| `protectedBranches` | `string[]` | `["main", "master"]` | Tên nhánh không thể được kiểm tra 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ố cụ thể chính sách. Sử dụng [`hint`](/vi/configuration#hint-cross-cutting) xuyên suốt để gợi ý các lựa chọn thay thế:
-```json
-{
-  "policyParams": {
-    "block-force-push": {
-      "hint": "Create a new branch from your current HEAD (e.g. `git checkout -b <new-branch>`) and push that instead."
-    }
-  }
-}
-```
----
-### `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 staging 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
-Bắt các hoạt động SQL tàn phá trước khi chúng thực thi đối 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 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 viết các tệp lớn hơn 1024 KB.
-**Tham số:**
-| Tham số | Loại | Mặc định | Mô tả |
-|-------|------|---------|-------------|
-| `thresholdKb` | `number` | `1024` | Ngưỡng kích thước tệp tính bằng kilobyte 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 1 MB stdin trên tải trọng. Để kiểm tra chính sách này với nội dung nhỏ, hãy đặt `thresholdKb` thành giá trị nằm 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 các quy trình nền 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ố.
----
-## Trình quản lý gói
-Thực thi trình quản lý gói nào được agent phép sử dụng.
-### `prefer-package-manager`
-**Sự kiện:** PreToolUse (Bash)
-**Mặc định:** Bị vô hiệu hóa. Khi được bật, chặn bất kỳ lệnh trình quản lý gói nào không có trong danh sách `allowed` và yêu cầu Claude viết lại lệnh bằng trình quản lý được phép.
-Phát hiện: pip, pip3, python -m pip, npm, npx, yarn, pnpm, pnpx, bun, bunx, uv, poetry, pipenv, conda, cargo.
-| Tham số | Loại | Mặc định | Mô tả |
-|-----------|------|---------|-------------|
-| `allowed` | string[] | `[]` | Tên trình quản lý gói được phép. Bất kỳ trình quản lý được phát hiện nào không có trong danh sách này sẽ bị chặn. Khi trống, chính sách là no-op. |
-| `blocked` | string[] | `[]` | Tên trình quản lý bổ sung để chặn ngoài danh sách được xây dựng sẵn (ví dụ: `['pdm', 'pipx']`). |
-Danh sách chặn tích hợp sẵn bao gồm: pip, pip3, npm, npx, yarn, pnpm, pnpx, bun, bunx, uv, poetry, pipenv, conda, cargo. Sử dụng `blocked` để thêm các trình quản lý không có trong danh sách này.
-**Cấu hình ví dụ:**
-```json
-{
-  "enabledPolicies": ["prefer-package-manager"],
-  "policyParams": {
-    "prefer-package-manager": {
-      "allowed": ["uv", "bun"],
-      "blocked": ["pdm", "pipx"]
-    }
-  }
-}
-```
-Với cấu hình này, `pip install flask` và `pdm install flask` đều bị từ chối với thông báo yêu cầu Claude sử dụng `uv` hoặc `bun` thay thế. Các lệnh như `uv pip install flask` được phép vì `uv` có trong danh sách cho phép và được kiểm tra trước tiên.
----
-## Hành vi AI
-Phát hiện khi agent bị mắc kẹt hoặc hành xử bất thường.
-### `warn-repeated-tool-calls`
-**Sự kiện:** PreToolUse (tất cả công cụ)
-**Mặc định:** Hướng dẫn Claude cân nhắc lại khi cùng một công cụ được gọi 3 lần trở lên với các tham số giống nhau - dấu hiệu thông thường cho thấy agent bị mắc kẹt trong một vòng lặp.
-Không có tham số.
----
-## Quy trình làm việc
-Thực thi quy trình làm việc kết thúc phiên làm việc theo kỷ luật. Những chính sách này được 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 một 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 rút ngắn).
-Tất cả chính sách quy trình làm việc đều **fail-open**: nếu công cụ được yêu cầu không khả dụng (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ó các thay đổi chưa được commit (các tệp đã sửa đổi, được staging hoặc không được theo dõi). Trả về thông báo 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 đẩy hoặc khi nhánh hiện tại không có nhánh theo dõi từ xa. Gợi ý `git push -u` để tạo một nhánh theo dõi nếu cần. Fails open nếu không có remote được cấu hình.
-**Tham số:**
-| Tham số | Loại | Mặc định | Mô tả |
-|-------|------|---------|-------------|
-| `remote` | `string` | `"origin"` | Tên remote để đẩy tới. |
-**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 nào tồn tại cho nhánh hiện tại hoặc khi PR hiện có bị đóng/hợp nhất. Hướng dẫn Claude tạo một PR bằng `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ột token truy cập cá nhân có phạm vi `repo` để truy cập đọc đến
-các yêu cầu kéo. Nếu `gh` không được cài đặt hoặc không được xác thực, chính sách fails 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 thất bại hoặc vẫn đang chạy trên nhánh hiện tại. Kiểm tra cả các lần chạy quy trình làm 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 báo 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ột token truy cập cá nhân có phạm vi `repo` để truy cập đọc đến
-các lần chạy quy trình làm 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 fails open và báo cáo lý do cho Claude.
-</Note>
----
----
-## Vô hiệu hóa các chính sách riêng lẻ
-Xóa chính sách cụ thể khỏi `enabledPolicies` trong cấu hình 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ác mục `policyParams` tồn tại cho chúng.

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

@@ -1,28 +0,0 @@
----
-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 DELETED Viewed

@@ -1,34 +0,0 @@
----
-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 DELETED Viewed

@@ -1,30 +0,0 @@
----
-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` |