failproofai 0.0.2 → 0.0.3

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

@@ -0,0 +1,48 @@
+---
+title: Cài đặt policies
+description: "Bật 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 chặn các lệnh gọi tool.
+
+Các alias: `failproofai p -i`
+
+## Options
+
+| Flag | Description |
+|------|-------------|
+| `--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 đến tệp JS chứa các custom hook policies |
+| `--beta` | Bao gồm các beta policies |
+
+## Behavior
+
+- **Không có tên policy** - mở một prompt tương tác để chọn policies
+- **Tên cụ thể** - bật các policies đó (được thêm vào các policies đã bật)
+- **`all`** - bật tất cả các policies có sẵn
+
+Cài đặt là cộng dồn: chạy `--install` lại sẽ thêm các policies mới mà không loại bỏ các policies hiện có.
+
+## Examples
+
+```bash
+# Cài đặt tất cả các default policies toàn cục (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 lúc
+failproofai policies --install all
+
+# Cài đặt với một tệp custom policies
+failproofai policies --install --custom ./my-policies.js
+```
+
+Khi `--custom <path>` được cung cấp, tệp 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 đã giải quyết được lưu vào `policies-config.json` dưới dạng `customPoliciesPath`.

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

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

@@ -0,0 +1,44 @@
+---
+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ừ cài đặt toàn cầu (mặc định) |
+| `--scope project` | Xóa từ cài đặt dự án |
+| `--scope local` | Xóa từ cài đặt cục bộ |
+| `--scope all` | Xóa từ tất cả các phạm vi cùng một lúc |
+| `--custom` / `-c` | Xóa `customPoliciesPath` khỏi cấu hình |
+| `--beta` | Chỉ xóa các beta policies khỏi cấu hình |
+
+## Hành vi
+
+- **Không có tên policy** - xóa tất cả failproofai hook entries khỏi file cài đặt
+- **Các tên cụ thể** - vô hiệu hóa các policies đó nhưng giữ lại các hooks đã cài đặt
+
+## Ví dụ
+
+```bash
+# Xóa tất cả hooks toàn cầu
+failproofai policies --uninstall
+
+# Vô hiệu hóa một policy cụ thể (giữ lại hooks đã cài đặt)
+failproofai policies --uninstall block-sudo
+
+# Xóa hooks từ mọi phạm vi
+failproofai policies --uninstall --scope all
+
+# Xóa đường dẫn custom policies
+failproofai policies --uninstall --custom
+```

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

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

@@ -0,0 +1,222 @@
+---
+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 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.
+
+---
+
+## 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 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 |
+
+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.
+
+### 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.
+
+```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
+```
+
+**`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.
+
+```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
+```
+
+```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ẽ chiến thắng.
+
+**`llm`** - phạm vi đầu tiên xác định nó sẽ chiến 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 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 đủ.
+
+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`.
+
+### `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).
+
+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 đó.
+
+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`.
+
+#### `hint` (cross-cutting)
+
+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.
+
+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/`).
+
+```json
+{
+  "policyParams": {
+    "block-force-push": {
+      "hint": "Try creating a fresh branch instead."
+    },
+    "block-sudo": {
+      "allowPatterns": ["sudo apt-get"],
+      "hint": "Use apt-get directly without sudo."
+    },
+    "custom/my-policy": {
+      "hint": "Ask the user for approval first."
+    }
+  }
+}
+```
+
+Khi `block-force-push` từ chối, Claude sẽ thấy: *"Force-pushing is blocked. Try creating a fresh branch instead."*
+
+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).
+
+### `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 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ả.
+
+### Chính sách dựa trên quy ước (v0.0.2-beta.7+)
+
+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/`:
+
+| 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 |
+| 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ô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.
+
+**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).
+
+Xem [Chính sách tùy chỉnh](/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.
+
+```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 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:
+
+- **`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
+
+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.
+
+---
+
+## Ví dụ: cấu hình cấp dự án với giá trị mặc định nhóm
+
+Cam kết `.failproofai/policies-config.json` vào repo 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"]
+    }
+  }
+}
+```
+
+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.