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

package/.next/standalone/docs/vi/cli/install-policies.mdx

@@ -1,47 +0,0 @@
----
-title: Cài đặt policies
-description: "Bật các policies để chúng chạy trên mỗi lệnh gọi tool của agent"
----
-
-```bash
-failproofai policies --install [policy-names...] [options]
-```
-
-Ghi các hook entries vào `settings.json` của Claude Code để failproofai có thể chặn các lệnh gọi tool.
-
-Tên viết tắt: `failproofai p -i`
-
-## Tùy chọn
-
-| Flag | Mô tả |
-|------|-------|
-| `--scope user` | Cài đặt vào `~/.claude/settings.json` (mặc định - tất cả các phiên) |
-| `--scope project` | Cài đặt vào `.claude/settings.json` trong thư mục hiện tại |
-| `--scope local` | Cài đặt vào `.claude/settings.local.json` trong thư mục hiện tại |
-| `--custom <path>` / `-c` | Đường dẫn tới file JS chứa các custom hook policies |
-
-## Hoạt động
-
-- **Không có tên policy** - mở lời nhắc tương tác để chọn policies
-- **Tên cụ thể** - bật các policies đó (thêm vào bất kỳ policies nào đã được bật)
-- **`all`** - bật mọi policy có sẵn
-
-Cài đặt là tích lũy: chạy `--install` lại sẽ thêm các policies mới mà không loại bỏ những policies hiện có.
-
-## Ví dụ
-
-```bash
-# Cài đặt tất cả các policies mặc định toàn cầu (tương tác)
-failproofai policies --install
-
-# Cài đặt các policies cụ thể cho dự án hiện tại
-failproofai policies --install block-sudo sanitize-api-keys --scope project
-
-# Bật tất cả các policies cùng một lúc
-failproofai policies --install all
-
-# Cài đặt với file policies tùy chỉnh
-failproofai policies --install --custom ./my-policies.js
-```
-
-Khi `--custom <path>` được cung cấp, file sẽ được xác thực ngay lập tức - nó phải gọi `customPolicies.add()` ít nhất một lần. Đường dẫn được phân giải sẽ được lưu vào `policies-config.json` dưới dạng `customPoliciesPath`.

package/.next/standalone/docs/vi/cli/list-policies.mdx

@@ -1,31 +0,0 @@
----
-title: Liệt kê các chính sách
-description: "Xem các chính sách đã bật, tham số của chúng và chính sách tùy chỉnh"
----
-
-```bash
-failproofai policies
-```
-
-Hiển thị tất cả các chính sách với trạng thái, tham số được cấu hình và chính sách tùy chỉnh.
-
-## Kết quả mẫu
-
-```text
-Failproof AI Hook Policies (user)
-
-  Status  Name                          Description
-  ──────  ──────────────────────────────────────────────────────────────
-  ✓       block-sudo                    Block sudo commands
-            allowPatterns: ["sudo systemctl status"]
-  ✓       block-rm-rf                   Block recursive deletions
-  ✗       block-curl-pipe-sh            Block curl|bash patterns
-  ✓       sanitize-api-keys             Redact API keys from output
-            additionalPatterns: [{ regex: "MY_TOKEN_...", label: "..." }]
-
-  ── Custom Policies (/home/alice/myproject/my-policies.js) ──────────────
-  ✓       require-jira-ticket           Block commits without ticket
-  ✓       approval-gate                 Approval gate for destructive ops
-```
-
-Các khóa không xác định trong `policyParams` sẽ được đánh dấu tại đây để bạn có thể phát hiện lỗi đánh máy sớm.

package/.next/standalone/docs/vi/cli/remove-policies.mdx

@@ -1,43 +0,0 @@
----
-title: Gỡ cài đặt policies
-description: "Xóa các hook entries từ settings của Claude Code"
----
-
-```bash
-failproofai policies --uninstall [policy-names...] [options]
-```
-
-Xóa các failproofai hook entries từ `settings.json` của Claude Code.
-
-Bí danh: `failproofai p -u`
-
-## Options
-
-| Flag | Mô tả |
-|------|-------------|
-| `--scope user` | Xóa từ global settings (mặc định) |
-| `--scope project` | Xóa từ project settings |
-| `--scope local` | Xóa từ local settings |
-| `--scope all` | Xóa từ tất cả các scopes cùng lúc |
-| `--custom` / `-c` | Xóa `customPoliciesPath` khỏi config |
-
-## Hành vi
-
-- **Không có tên policy** - xóa tất cả failproofai hook entries khỏi file settings
-- **Tên cụ thể** - tắt các policies đó nhưng giữ lại hooks đã cài đặt
-
-## Ví dụ
-
-```bash
-# Remove all hooks globally
-failproofai policies --uninstall
-
-# Disable a specific policy (keeps hooks installed)
-failproofai policies --uninstall block-sudo
-
-# Remove hooks from every scope
-failproofai policies --uninstall --scope all
-
-# Clear custom policies path
-failproofai policies --uninstall --custom
-```

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

@@ -1,13 +0,0 @@
----
----
-title: Kiểm tra phiên bản
-description: "In ra phiên bản failproofai đã cài đặt"
----
-
-```bash
-failproofai --version
-# or
-failproofai -v
-```
-
-In ra số phiên bản đã cài đặt.

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

@@ -1,222 +0,0 @@
----
-title: Cấu hình
-description: "Định dạng tệp cấu hình, hệ thống ba phạm vi và quy tắc hợp nhất"
-icon: gear
----
-
-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.
-
----
-
-## Phạm vi cấu hình
-
-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 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 đượ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 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"]  ← 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 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 thắng, global bị bỏ qua
-```
-
-```text
-project:  (không có mục block-sudo)
-local:    (không có mục block-sudo)
-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ẽ thắng.
-
-**`llm`** - phạm vi đầu tiên xác định nó sẽ thắng.
-
----
-
-## Định dạng tệp cấu hình
-
-```json
-{
-  "enabledPolicies": [
-    "block-sudo",
-    "block-rm-rf",
-    "block-push-master",
-    "sanitize-api-keys",
-    "sanitize-jwt",
-    "block-env-files",
-    "block-read-outside-cwd"
-  ],
-  "policyParams": {
-    "block-sudo": {
-      "allowPatterns": ["sudo systemctl status", "sudo journalctl"]
-    },
-    "block-push-master": {
-      "protectedBranches": ["main", "release", "prod"]
-    },
-    "block-rm-rf": {
-      "allowPaths": ["/tmp"]
-    },
-    "block-read-outside-cwd": {
-      "allowPaths": ["/shared/data", "/opt/company"]
-    },
-    "sanitize-api-keys": {
-      "additionalPatterns": [
-        { "regex": "myco_[A-Za-z0-9]{32}", "label": "MyCo API key" }
-      ]
-    },
-    "warn-large-file-write": {
-      "thresholdKb": 512
-    }
-  },
-  "customPoliciesPath": "/home/alice/myproject/my-policies.js"
-}
-```
-
----
-
-## Tham chiếu trường
-
-### `enabledPolicies`
-
-Loại: `string[]`
-
-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 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à 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 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 đượ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` (xuyên suốt)
-
-Loại: `string` (tùy chọn)
-
-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 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": "Hãy thử tạo một nhánh mới thay vào đó."
-    },
-    "block-sudo": {
-      "allowPatterns": ["sudo apt-get"],
-      "hint": "Sử dụng apt-get trực tiếp mà không cần sudo."
-    },
-    "custom/my-policy": {
-      "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 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 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`
-
-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 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 khám phá và tải các tệp chính sách từ các thư mục `.failproofai/policies/`:
-
-| 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 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:** 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 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 [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 cho hầu hết các thiết lập.
-
-```json
-{
-  "llm": {
-    "model": "claude-sonnet-4-6",
-    "apiKey": "sk-ant-..."
-  }
-}
-```
-
----
-
-## 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 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á 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; 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 mặc định đội
-
-Cam kết `.failproofai/policies-config.json` vào kho của bạn:
-
-```json
-{
-  "enabledPolicies": [
-    "block-sudo",
-    "block-rm-rf",
-    "block-push-master",
-    "sanitize-api-keys",
-    "block-env-files"
-  ],
-  "policyParams": {
-    "block-push-master": {
-      "protectedBranches": ["main", "release", "hotfix"]
-    }
-  }
-}
-```
-
-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.