failproofai 1.0.1-beta.1 → 1.0.1

package/.next/standalone/docs-old/vi/cli/audit.mdx

@@ -0,0 +1,120 @@
+---
+title: Kiểm toàn lịch sử phiên (beta)
+description: "Đếm tần suất agent thực hiện những điều lãng phí hoặc rủi ro trên các phiên ghi âm trong quá khứ"
+---
+
+<Note>
+  **Tính năng beta.** Kiểm toàn được phát hành dưới dạng beta trong khi chúng tôi thu thập phản hồi sớm.
+  Danh mục detector và định dạng báo cáo có thể thay đổi trước bản phát hành ổn định tiếp theo.
+  Vui lòng mở một vấn đề nếu bất kỳ điều gì không đúng.
+</Note>
+
+Kiểm toàn phát lại các phiên ghi âm agent-CLI trong quá khứ của bạn thông qua công cụ chính sách của failproofai và hiển thị một báo cáo trực quan có thể chia sẻ trên **trang bảng điều khiển `/audit`** — kiểu hình nguyên mẫu của agent, điểm từ 0–100, và chính xác những chính sách nào sẽ bắt được điều gì.
+
+## Chạy nó
+
+Ba cách vào — tất cả đều dẫn đến báo cáo `/audit` giống nhau.
+
+<CodeGroup>
+
+```bash npx (không cài đặt)
+npx -y failproofai audit
+```
+
+```bash failproofai audit
+failproofai audit
+```
+
+```bash failproofai (bảng điều khiển)
+failproofai
+```
+
+</CodeGroup>
+
+<CardGroup cols={3}>
+  <Card title="Không cài đặt" icon="bolt">
+    `npx -y failproofai audit` tìm nạp failproofai, chạy quét và mở bảng điều khiển cho bạn — không cần cài đặt trước.
+  </Card>
+  <Card title="Từ CLI" icon="terminal">
+    `failproofai audit` chạy quét trong terminal của bạn, sau đó tự động mở `localhost:8020/audit` khi hoàn thành.
+  </Card>
+  <Card title="Từ bảng điều khiển" icon="gauge">
+    Chạy `failproofai` và nhấp vào **Audit** trong thanh điều hướng (giữa Policies và Projects), hoặc mở `/audit` trực tiếp.
+  </Card>
+</CardGroup>
+
+<Tip>
+  Chạy `failproofai audit -h` (hoặc `--help`) để xem cách sử dụng. Kiểm toàn chạy **hoàn toàn ngoại tuyến** — không cần tài khoản hoặc mạng — và bảng điều khiển tiếp tục phục vụ cho đến khi bạn dừng nó bằng `Ctrl+C`.
+</Tip>
+
+Bảng điều khiển quét các phiên ghi âm agent CLI trong quá khứ trên máy này (Claude Code, Codex, Copilot, Cursor, OpenCode, Pi) và báo cáo tần suất agent thực hiện những điều mà failproofai được xây dựng để dừng — kiểm tra biến môi trường, force push, tiền tố `cd <cwd>` dư thừa, vòng lặp sleep-polling, đọc lại các tệp vừa được chỉnh sửa, và hơn thế nữa.
+
+Đối với mỗi phiên ghi âm, mọi sự kiện sử dụng công cụ được phát lại thông qua 39 chính sách tích hợp **và** thông qua 8 detector chỉ dành cho kiểm toàn bắt các mẫu chưa được bao gồm bởi các chính sách thời gian chạy. Số lượng được tổng hợp trên mỗi chính sách/detector trên tất cả các phiên.
+
+## Bạn nhận được gì
+
+Trang `/audit` là một **poster** trên một màn hình có thể chia sẻ, theo sau là bốn phần dưới đây nếp gấp:
+
+1. **Poster** — danh tính của agent của bạn trong thoáng qua: **kiểu hình nguyên mẫu** của nó (một trong 8 — `optimist`, `cowboy`, `explorer`, `goldfish`, `paranoid architect`, `precision builder`, `hammer`, `ghost`), các từ khóa persona của nó, độ hiếm của kiểu hình nguyên mẫu đó, và **điểm từ 0–100** với dải cấp bậc (`S` xuống `cấp thấp nhất`). Được xây dựng để chia sẻ — đăng trên X hoặc LinkedIn, hoặc tải xuống dưới dạng PNG.
+2. **`// strengths`** — những điều mà agent của bạn đã làm tốt, dưới dạng các số thực từ quét (ví dụ: phần trăm clean-tool-call, `0` nỗ lực push-to-main), chỉ hiển thị khi chính sách liên quan có hồ sơ sạch.
+3. **`// quirks`** — những gì đã trượt qua: một bảng xếp hạng các hành vi mà failproofai sẽ bắt được — *khi* lần cuối cùng nó xảy ra, *những gì đã trượt* (và tính năng tích hợp sẽ chặn nó), **mức độ nghiêm trọng** của nó, và tần suất *được nhìn thấy* (`new` / `recurring` / `N× seen`).
+4. **`// how to improve`** — danh sách sửa chữa được quy định: một hàng cho mỗi chính sách với `failproofai policy add <slug>` sao chép dán, cộng với nút **cài đặt tất cả** kích hoạt mọi khuyến nghị cùng một lúc và hiển thị **điểm dự báo** của bạn nếu bạn làm như vậy.
+5. **`// come back better`** — xây dựng thói quen: đặt **nhắc nhở** kiểm toàn lại qua email (`3d` / `7d` / `14d` / `30d`) hoặc kiểm toàn ngay bây giờ, và **mời một bạn** chạy kiểm toàn của riêng họ (được gửi từ failproof.ai, Cc cho bạn). Nhắc nhở và lời mời yêu cầu đăng nhập.
+
+## Kiểm toàn được lên lịch
+
+Nếu bạn chạy **daemon failproofaid** (xem [`failproofai config`](/vi/cli/install-policies)),
+nó có thể chạy lại kiểm toàn cho bạn theo lịch trình và làm mới báo cáo `/audit` ở chế độ nền. Nó **tắt theo mặc định**, vì quét đọc *nội dung*
+của mọi phiên ghi âm agent session trên máy này — không có gì quét theo bộ hẹn giờ
+cho đến khi bạn yêu cầu.
+
+Bật nó trong `~/.failproofai/config.toml`:
+
+```toml
+[audit]
+auto = true
+interval_days = 7
+```
+
+| Khóa | Ý nghĩa |
+|---|---|
+| `auto` | `true` kích hoạt quét được lên lịch. Bất cứ điều gì khác — vắng mặt, `false`, `"yes"` — là tắt. |
+| `interval_days` | Ngày giữa các lần quét. Được giới hạn từ 1–90; `0`, âm hoặc không phải số sẽ quay lại `7`. |
+
+- Lịch trình là **wall-clock**, vì vậy nó sống sót qua tạm dừng và khởi động lại: một máy tính xách tay
+  đã ngủ quá thời gian đến hạn chạy **một lần** trên thức dậy, không bao giờ một khối lượng công việc dữ liệu.
+- Mỗi lần chạy là một quá trình riêng biệt, mức độ ưu tiên thấp (`nice 19`) — không bao giờ đường dẫn hook của daemon, vốn luôn sẵn sàng để trả lời các lệnh gọi công cụ.
+- Quét bị bỏ qua nếu `failproofai audit` hoặc re-run của bảng điều khiển đã đang hoạt động; nó được thử lại trong thời gian ngắn sau thay vì được coi là một thất bại.
+- Tiến độ được ghi vào `~/.failproofai/state/audit-schedule.json` (lần chạy cuối cùng, tiếp theo đến hạn). Daemon sở hữu tệp đó — thay đổi tốc độ trong `config.toml`.
+
+<Note>
+Nếu bạn kích hoạt điều này trên máy được thiết lập bởi failproofai cũ hơn, hãy chạy
+`failproofai config` một lần. Định nghĩa dịch vụ của daemon cần một bản nhập bổ sung
+trước khi nó có thể khởi chạy CLI, và làm mới là một phần của lệnh đó.
+</Note>
+
+## Các detector chỉ dành cho kiểm toàn
+
+Những cái này phát hiện các mẫu hành vi độc xuất không (yet) được thực thi trong thời gian thực. Chúng chỉ chạy trong kiểm toàn và không bao giờ chặn một lệnh gọi công cụ trực tiếp.
+
+| Detector | Những gì nó đếm |
+|---|---|
+| `redundant-cd-cwd` | Các lệnh Bash bắt đầu bằng `cd <cwd> && …` mặc dù các lệnh đã chạy trong `cwd`. |
+| `prefer-edit-over-read-cat` | `cat`/`head`/`tail`/`less`/`more` trên một tệp nguồn duy nhất — sử dụng công cụ `Read`. |
+| `prefer-edit-over-sed-awk` | `sed -i` / `awk … > file` chỉnh sửa tại chỗ — sử dụng công cụ `Edit`. |
+| `prefer-write-over-heredoc` | Heredoc / đa dòng `echo > file` ghi tệp — sử dụng công cụ `Write`. |
+| `sleep-polling-loop` | `sleep N` dài (≥ 30s) hoặc `while …; sleep …; done` vòng lặp polling. |
+| `find-from-root` | `find /`, `find /home`, `find /usr`, vv — scope to `cwd` thay thế. |
+| `git-commit-no-verify` | `git commit … --no-verify` / `-n`, bỏ qua hooks. |
+| `reread-after-edit` | `Read` của một tệp vừa được `Edit`/`Write` trong cùng một phiên. |
+
+## Bộ nhớ đệm
+
+- **Bộ nhớ đệm trên mỗi phiên ghi âm** tại `~/.failproofai/cache/audit/<sha1>.json` được khóa bằng `(mtime, size, engineVersion, detectorVersion)` — bất hợp lệ tự động khi phiên ghi âm hoặc code chính sách/detector thay đổi. Mỗi mục cũng lưu trữ dấu thời gian `cachedAt` làm **siêu dữ liệu TTL** (không phải một phần của khóa bộ nhớ đệm); các mục cũ hơn **7 ngày** bị từ chối khi đọc để kết quả lâu dài không sống sót ngoài ý định detector phát triển.
+- **Bộ nhớ đệm kết quả toàn bộ** tại `~/.failproofai/audit-dashboard.json` (chế độ 0600). Cho phép bảng điều khiển hiển thị ngay lập tức khi điều hướng mà không cần chạy lại. Cũng bị từ chối khi đọc quá **TTL 7 ngày** — `/audit` sau đó rơi vào trạng thái trống của nó và nhắc nhở chạy lại. Nhấp vào `[ re-audit now ]` gần phía dưới của báo cáo để làm mới — re-audit gửi `noCache: true`, vì vậy nó bỏ qua bộ nhớ đệm trên mỗi phiên ghi âm và quét lại mỗi phiên ghi âm thay vì trả về kết quả được lưu trong bộ nhớ đệm; lần chạy truyền phát tiến độ qua dải trên cùng (sticky) và hoán đổi kết quả tại chỗ khi thành công (không tải lại trang; re-audit thất bại giữ báo cáo trước đó).
+
+## Ghi chú
+
+- **Không đột biến.** Kiểm toàn phát lại ở chế độ chỉ đọc. `warn-repeated-tool-calls` bị bỏ qua vì xe đặt hàng sidecar trên mỗi phiên của nó sẽ bị sửa đổi.
+- **Chính sách quy trình làm việc bị bỏ qua.** Các chính sách `require-*-before-stop` chỉ kích hoạt trên các sự kiện `Stop` và `execSync` so với trạng thái git trực tiếp — chúng không có diễn giải có ý nghĩa nào (what would have happened in 2025), vì vậy chúng không xuất hiện trong số lượng kiểm toàn.
+- **Chính sách tùy chỉnh bị bỏ qua.** Các hook tùy chỉnh do người dùng cung cấp không được phát lại (chúng có thể đã thay đổi kể từ phiên ban đầu).

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

@@ -0,0 +1,29 @@
+---
+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 tác nhân 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`.
+
+## Các tùy chọn
+
+| Cờ | Mô tả |
+|------|-------------|
+| `--port <number>` | Cổng để lắng nghe (mặc định: `8020`) |
+| `--allowed-origins <origins>` | Các máy chủ/IP được phân tách bằng dấu phẩy được phép truy cập tài nguyên phát triển |
+
+Để trỏ bảng điều khiển tới thư mục dự án Claude không phải mặc định, hãy đặt biến môi trường `CLAUDE_PROJECTS_PATH` khi khởi động.
+
+## Ví dụ
+
+```bash
+# Khởi động trên một cổng khác
+failproofai --port 9000
+
+# Sử dụng đường dẫn dự án Claude tùy chỉnh thông qua biến môi trường
+CLAUDE_PROJECTS_PATH=~/my-claude-projects failproofai
+```

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

@@ -0,0 +1,69 @@
+---
+title: Biến môi trường
+description: "Cấu hình hành vi failproofai bằng 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 kiếm thư mục dự án Claude Code |
+| `FAILPROOFAI_DISABLE_PAGES=policies,projects` | Các trang dashboard được ẩn, cách nhau bằng 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. Giống như `--allowed-origins`. |
+
+## Ghi nhật ký
+
+| Biến | Mô tả |
+|----------|-------------|
+| `FAILPROOFAI_LOG_LEVEL=info\|warn\|error` | Mức độ ghi nhật ký của 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`) |
+
+## Dữ liệu kỹ thuật
+
+failproofai báo cáo dữ liệu kỹ thuật sử dụng ẩn danh theo mặc định. Có hai cách
+để tắt nó, và chúng được giải quyết theo cách hạn chế nhất — một biến môi trường
+không bao giờ có thể bật lại cái gì mà tệp cấu hình đã tắt.
+
+| Biến | Mô tả |
+|----------|-------------|
+| `FAILPROOFAI_TELEMETRY_DISABLED=1` | Vô hiệu hóa dữ liệu kỹ thuật sử dụng ẩn danh cho quy trình này |
+
+Để vô hiệu hóa nó vĩnh viễn cho máy, hãy thêm điều này vào `~/.failproofai/config.toml`:
+
+```toml
+[telemetry]
+enabled = false
+```
+
+<Note>
+Tệp cấu hình là tùy chọn được sử dụng nếu bạn chạy **daemon failproofaid**.
+Daemon là một dịch vụ phạm vi hệ thống, và môi trường của nó không bao gồm
+các biến được xuất từ shell của bạn — vì vậy `FAILPROOFAI_TELEMETRY_DISABLED` không thể
+đến được nó. `[telemetry] enabled = false` được đọc bởi cả CLI và daemon.
+</Note>
+
+Daemon chỉ báo cáo **vòng đời** của nó: rằng nó đã khởi động (và liệu lần chạy trước có thoát sạch), rằng nó đã dừng, khi công nhân đánh giá của nó được
+sinh ra hoặc khởi động lại, khi một tác vụ collector không thành công, và kết quả của một
+lần kéo chính sách đám mây. Những cái này mang các giá trị và số lượng có tính chất thấp — không bao giờ là đường dẫn tệp, lệnh, chính sách, lời nhắc, hoặc bất cứ điều gì được đọc từ bản ghi. Không có sự kiện trên mỗi lệnh gọi công cụ.
+
+## Xác thực
+
+| Biến | Mô tả |
+|----------|-------------|
+| `FAILPROOF_API_URL` | Ghi đè URL cơ sở máy chủ api được sử dụng bởi hộp thoại xác thực dashboard. Mặc định là `https://api.befailproof.ai`; đặt thành `http://localhost:8080` (hoặc ở đâu đó) khi chạy máy chủ api cục bộ. |
+| `FAILPROOFAI_AUTH_DIR` | Ghi đè nơi `auth.json` được lưu trữ (mặc định: `~/.failproofai`). Hầu hết hữu ích cho các bài kiểm tra cách ly. |
+
+## Lời nhắc chạy lần đầu tiên
+
+| Biến | Mô tả |
+|----------|-------------|
+| `FAILPROOFAI_NO_FIRST_RUN=1` | Bỏ qua lời nhắc cung cấp cài đặt chính sách khi gọi failproofai trần lần đầu tiên |
+
+## 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-old/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 tool"
+---
+
+```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 lệnh này trực tiếp.
+
+Đọ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ột mã chỉ ra 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` | Chèn 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 tool** | `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 & tasks** | `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` |

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

@@ -0,0 +1,57 @@
+---
+title: Cài đặt policies
+description: "Bật policies để chúng chạy trên mọi lần gọi tool của agent"
+---
+
+```bash
+failproofai policies --install [policy-names...] [options]
+```
+
+Ghi các mục hook vào tệp cài đặt của CLI agent đã cài đặt (Claude Code, OpenAI Codex, hoặc GitHub Copilot CLI _(beta)_) để failproofai có thể chặn các lệnh gọi tool.
+
+Bí danh: `failproofai p -i`
+
+## Tùy chọn
+
+| Cờ | Mô tả |
+|------|-------------|
+| `--cli claude\|codex\|copilot` | CLI agent để cài đặt; cách nhau bằng khoảng trắng (ví dụ: `--cli claude codex copilot`) hoặc lặp lại. Bỏ qua để phát hiện CLI đã cài đặt và nhắc. |
+| `--scope user` | Cài đặt vào tệp cài đặt phạm vi người dùng (Claude: `~/.claude/settings.json`; Codex: `~/.codex/hooks.json`; Copilot: `~/.copilot/hooks/failproofai.json`). Mặc định. |
+| `--scope project` | Cài đặt vào tệp cài đặt phạm vi dự án (Claude: `<cwd>/.claude/settings.json`; Codex: `<cwd>/.codex/hooks.json`; Copilot: `<cwd>/.github/hooks/failproofai.json`). |
+| `--scope local` | Chỉ Claude — cài đặt vào `<cwd>/.claude/settings.local.json`. Codex và Copilot không có phạm vi `local`. |
+| `--custom <path>` / `-c` | Đường dẫn đến tệp JS chứa các policies hook tùy chỉnh |
+
+## Hành độ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à cộng dồn: chạy `--install` lại sẽ thêm các policies mới mà không xóa các 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 tệp policies tùy chỉnh
+failproofai policies --install --custom ./my-policies.js
+
+# Cài đặt cho OpenAI Codex (phạm vi dự án)
+failproofai policies --install --cli codex --scope project
+
+# Cài đặt cho GitHub Copilot CLI (beta) cho dự án hiện tại
+failproofai policies --install --cli copilot --scope project
+
+# Cài đặt cho cả ba CLI cùng một lúc
+failproofai policies --install --cli claude codex copilot
+```
+
+Khi `--custom <path>` được cung cấp, tệp đượ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 giải quyết được lưu vào `policies-config.json` dưới dạng `customPoliciesPath`.

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

@@ -0,0 +1,32 @@
+---
+---
+title: Liệt kê các chính sách
+description: "Xem các chính sách nào được bật, các tham số của chúng và các 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, các tham số được cấu hình và các 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 ở đây để bạn có thể phát hiện lỗi đánh máy sớm.

package/.next/standalone/docs-old/vi/cli/migrate.mdx

@@ -0,0 +1,122 @@
+---
+title: Di chuyển thư mục home
+description: "Nâng cấp ~/.failproofai lên bản cục bộ mà phiên bản này hỗ trợ, và xem trước những gì sẽ xảy ra"
+---
+
+```bash
+failproofai migrate --dry-run   # in ra kế hoạch, không thay đổi gì
+failproofai migrate             # chạy nó
+```
+
+Hầu hết mọi người không bao giờ gõ lệnh này. Nó tự chạy trên lệnh đầu tiên sau
+một lần nâng cấp, và [`failproofai update`](/vi/cli/update) cũng bao gồm nó. Sử dụng
+nó trực tiếp khi bạn muốn xem kế hoạch trước khi nó xảy ra, hoặc để chạy quá
+trình di chuyển một cách độc lập.
+
+## Dựa trên bản cục bộ, không phải phiên bản
+
+`~/.failproofai/VERSION` ghi lại một số **bản cục bộ** — hình dạng của thư mục,
+không phải bản phát hành đã ghi nó. Các quá trình di chuyển dựa trên số đó, điều
+này giúp khoảng cách lớn trở nên rẻ tiền:
+
+- Các phiên bản npm thay đổi ở mỗi bản phát hành, hàng chục phiên bản giữa hai
+  bản cục bộ khác nhau.
+- Vì vậy, một máy bỏ qua ba mươi bản phát hành với **không có thay đổi bản cục
+  bộ** sẽ chạy **không** quá trình di chuyển, không phải ba mươi thao tác trống.
+- Và một máy bỏ qua nhiều bản cục bộ cùng một lúc sẽ chạy từng bước theo thứ tự,
+  mỗi bước chỉ biết hai điểm cuối của nó.
+
+Điều này quan trọng vì npm không thể tự động cập nhật một gói đã cài đặt. Một máy
+nằm trên một phiên bản trong vài tháng rồi nhảy sang nhiều bản cục bộ cùng một lúc
+là trường hợp bình thường, không phải trường hợp hiếm gặp.
+
+## Chạy thử
+
+`--dry-run` in ra chuỗi chính xác và các tệp sẽ được lưu đầu tiên, và không thay
+đổi gì cả — không di chuyển, không sao lưu, không mục nhật ký:
+
+```
+Bản cục bộ 2 trên đĩa; phiên bản này hỗ trợ 3.
+Sẽ chạy 1 bước:
+  2 → 3  bản cục bộ 2 → 3: chuyển config.toml và credentials.toml vào JSON,
+         di chuyển custom-policies/ trở lại policies/, lồng cấu hình chính sách
+         ở gốc
+
+Những tệp này sẽ được sao chép đến ~/.failproofai/migrations/backup-layout2
+trước tiên:
+  VERSION
+  config.toml
+  credentials.toml
+```
+
+## Những gì được mang theo và những gì được xây dựng lại
+
+Mỗi đường dẫn trong thư mục home khai báo loại dữ liệu nó chứa, và điều đó quyết
+định xem liệu một quá trình di chuyển có thể loại bỏ nó hay không. Nguyên tắc:
+**những gì dẫn xuất và có thể lấy lại có thể bị bỏ; bất kỳ thứ gì bạn đã nhập,
+bất kỳ thứ gì chưa được gửi, và bất kỳ thứ gì xác định máy đều được mang theo.**
+
+| Mang theo | Xây dựng lại hoặc lấy lại |
+|---|---|
+| `config.json` — cài đặt, `daemon.configured`, đường dẫn chụp bổ sung | Bộ đệm kiểm toán |
+| `credentials.json` — ghi danh đám mây của bạn | Triển khai được quản lý bởi đám mây (lấy lại và xác minh tiêu chuẩn tại lần kiểm tra tiếp theo) |
+| `policies-config.json` — lựa chọn chính sách và tham số của bạn | Trạng thái tạm thời daemon |
+| `policies/` — tệp chính sách của riêng bạn và trình trợ giúp mà chúng nhập | |
+| `hook-activity/` — nhật ký quyết định mà bảng điều khiển đọc | |
+| Các sự kiện chưa được gửi vẫn còn trong hàng chờ để tải lên | |
+| `cursors/` — dấu nước trình thu thập | |
+| Daemon nhị phân trong `bin/` | |
+
+<Note>
+  Các sự kiện chưa được gửi được mang theo thay vì bị bỏ vì mất mát sẽ là vĩnh
+  viễn, không phải chậm: dấu nước của trình thu thập đã tiến lên quá bất kỳ thứ
+  gì nằm trong spool, vì vậy không có gì sẽ bao giờ đọc lại phạm vi đó của một
+  bản ghi. Quá trình di chuyển cũng yêu cầu daemon gửi những gì được spool ngay
+  sau khi nó hoàn thành, vì vậy kết quả thông thường là không còn gì để mang theo.
+</Note>
+
+Các khóa mà phiên bản *mới hơn* đã ghi vào `config.json`, `credentials.json` hoặc
+`policies-config.json` cũng được giữ lại thay vì bị bỏ bởi một trình đọc cũ hơn.
+
+## Bản ghi nó để lại
+
+```
+~/.failproofai/migrations/
+  applied.json                 một mục cho mỗi bước: bản cục bộ, CLI, dấu thời gian,
+                               thời lượng, kết quả
+  backup-layout<n>/            bản sao của các tệp không thể thay thế, được lấy trước
+                               bước đầu tiên
+```
+
+`applied.json` là những gì trả lời câu hỏi "máy này thực sự đã trải qua những gì"
+— câu hỏi đầu tiên đáng xem xét khi có gì đó trông sai sau một lần nâng cấp. Đính
+kèm nó vào một báo cáo lỗi.
+
+Bản sao lưu được cố ý nhỏ thay vì sao chép toàn bộ thư mục: quá trình di chuyển
+không còn xóa bất kỳ thứ gì không thể thay thế theo thiết kế, vì vậy những gì đáng
+bảo hiểm là *một lỗi trong một bước*, và những tệp ít ỏi này là nơi một lỗi như vậy
+sẽ gây hại.
+
+## Nếu một bước không thành công
+
+Chuỗi dừng ở đó. `VERSION` chỉ được đánh dấu bởi một bước đã hoàn thành, vì vậy
+thư mục home vẫn được đánh dấu bằng bản cục bộ cũ của nó và lệnh tiếp theo sẽ thử
+lại — thư mục home không bao giờ được đánh dấu hiện tại dựa trên một quá trình di
+chuyển một phần. Bước được ghi lại trong `applied.json` với `"ok": false`, và bản
+sao lưu là nơi nó được lấy.
+
+## Thư mục home mới hơn bị từ chối, không được di chuyển
+
+Nếu `~/.failproofai/` được viết bởi một phiên bản failproofai **mới hơn** so với
+phiên bản bạn đang chạy, lệnh sẽ dừng và bảo bạn nâng cấp thay vào đó. Dữ liệu
+đó là ổn định và một CLI mới hơn đọc nó; di chuyển sang phía trước từ nó không phải
+là thứ tồn tại, và đặt lại nó sẽ phá hủy một thứ có thể phục hồi.
+
+```
+Thư mục failproofai của máy này được viết bởi một phiên bản mới hơn (bản cục bộ
+4; phiên bản này hỗ trợ 3). Nâng cấp thay vì di chuyển:
+  npm install -g failproofai@latest
+```
+
+Daemon áp dụng quy tắc tương tự: `failproofaid` từ chối khởi động đối với một bản
+cục bộ mà nó không hỗ trợ, thay vì đọc và ghi các đường dẫn đã di chuyển.

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

@@ -0,0 +1,43 @@
+---
+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 hook entries của failproofai từ `settings.json` của Claude Code.
+
+Bí danh: `failproofai p -u`
+
+## Options
+
+| Flag | Description |
+|------|-------------|
+| `--scope user` | Xóa từ cài đặt toàn cục (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 |
+
+## Behavior
+
+- **Không có tên policy** - xóa tất cả các hook entries của failproofai khỏi tệp cài đặt
+- **Tên cụ thể** - vô hiệu hóa các policies đó nhưng giữ nguyên hooks được cài đặt
+
+## Examples
+
+```bash
+# Xóa tất cả hooks toàn cục
+failproofai policies --uninstall
+
+# Vô hiệu hóa một policy cụ thể (giữ nguyên hooks được 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-old/vi/cli/update.mdx

@@ -0,0 +1,95 @@
+---
+title: Cập nhật sau khi nâng cấp
+description: "Hoàn thành nửa còn lại của quá trình nâng cấp mà npm không thể thực hiện: di chuyển thư mục home và đồng bộ daemon"
+---
+
+```bash
+npm install -g failproofai@latest && failproofai update
+```
+
+Đó là toàn bộ quá trình nâng cấp. `npm` thay thế CLI; `failproofai update` thực hiện
+phần còn lại.
+
+## Tại sao lại cần một lệnh thứ hai
+
+`npm install -g` chỉ thay thế một thứ — CLI. Hai phần khác của bản cài đặt failproofai
+nằm ngoài package một cách cố ý, và cả hai đều không di chuyển khi npm chạy:
+
+- **`~/.failproofai/`**, cài đặt của bạn, đăng ký cloud, lựa chọn chính sách và
+  lịch sử. Một phiên bản mới có thể sắp xếp nó khác đi, và việc sắp xếp lại phải
+  được thực hiện bởi code biết cả hai cách sắp xếp.
+- **Tệp nhị phân daemon `failproofaid`**, tại
+  `~/.failproofai/bin/failproofaid-<version>`. Nó cố ý *không* nằm trong
+  `node_modules`: một nâng cấp tráo đổi tệp dưới một dịch vụ đang chạy sẽ hướng
+  daemon hoạt động đến một tệp nhị phân được xây dựng từ mã nguồn khác, và xóa
+  package sẽ xóa nó khỏi dưới dịch vụ đó, dẫn đến crash-loop ở mỗi lần khởi động.
+
+Vì vậy sau khi chỉ chạy `npm install -g`, CLI là mới nhưng daemon vẫn cũ.
+`failproofaid` từ chối khởi động khi gặp bố cục home mà nó không hiểu — phiên bản
+"to tiếng" của sự không khớp đó hơn là im lặng — vì vậy hai nửa cần được ghép lại
+với nhau. `failproofai update` là bước đó.
+
+## Nó làm gì
+
+<Steps>
+  <Step title="Chạy bất kỳ di chuyển bố cục nào đang chờ xử lý">
+    Đọc bố cục được ghi lại trong `~/.failproofai/VERSION` và chạy các bước
+    đưa nó đến bố cục mà phiên bản này hiểu. Thường là không có — xem
+    [`failproofai migrate`](/vi/cli/migrate).
+  </Step>
+  <Step title="Đặt tệp nhị phân daemon phù hợp vào chỗ">
+    Từ package dành cho nền tảng mà npm đã tải xuống nếu có thể (không cần mạng),
+    nếu không thì từ release asset cho phiên bản chính xác này, được xác minh SHA-256
+    trước khi sử dụng.
+  </Step>
+  <Step title="Khởi động lại dịch vụ và xác nhận nó đã quay lại">
+    Được kiểm tra chứ không phải là giả định — trình quản lý dịch vụ báo cáo
+    một quy trình đang hoạt động ngay khi nó fork, điều này không giống như
+    nó đang hoạt động.
+  </Step>
+</Steps>
+
+## Tùy chọn
+
+| Cờ | Hiệu ứng |
+|------|--------|
+| `--no-daemon` | Chỉ di chuyển home, giữ daemon ở phiên bản hiện tại. |
+
+<Warning>
+  `--no-daemon` giữ lại daemon có phiên bản không khớp. Trên máy được cấu hình
+  để yêu cầu daemon, mọi sự kiện hook **thất bại và đóng** nếu daemon không thể
+  trả lời — và daemon từ chối khởi động khi gặp home đã được di chuyển không thể
+  trả lời. Tốt hơn là để nửa daemon chạy.
+</Warning>
+
+## Nếu có sự cố
+
+Lệnh thoát với mã khác không và cho biết nửa nào thất bại. Hai trường hợp đáng
+biết:
+
+- **Một bước di chuyển không hoàn thành.** Home được đánh dấu bằng bố cục *cũ*
+  của nó, vì vậy lệnh tiếp theo sẽ thử lại — home không bao giờ được đánh dấu
+  là hiện tại dựa trên di chuyển một phần. Các bản sao cài đặt và đăng ký của bạn
+  được lưu trước khi bất cứ điều gì chạy, trong `~/.failproofai/migrations/backup-layout<n>/`.
+- **Daemon không thể khởi động lại mà không cần mật khẩu.** `sudo -n` được sử dụng
+  cố ý, vì vậy không bao giờ có gợi ý từ dưới màn hình tiến độ. Lệnh in ra
+  dòng chính xác để bạn tự chạy.
+
+<Note>
+  Không có gì ở đây cần trình hướng dẫn thiết lập tương tác. Cài đặt, đăng ký cloud
+  và lựa chọn chính sách của bạn vẫn còn sau nâng cấp, vì vậy máy đã di chuyển
+  thực thi chính xác như trước — điều này quan trọng nhất trên những máy không
+  có ai ngồi ở đó: CI runner, hộp fleet, gateway không đầu.
+</Note>
+
+## Tự động hóa nó
+
+`failproofai update` không tương tác và an toàn để chạy khi không có gì phải làm —
+nó báo cáo "không cần di chuyển" và thoát với 0. Đặt nó sau mỗi nâng cấp trong
+script provisioning hoặc Dockerfile là cách sử dụng dự định:
+
+```dockerfile
+RUN npm install -g failproofai@latest && failproofai update --no-daemon
+```
+
+(`--no-daemon` trong xây dựng image, nơi chưa có dịch vụ để khởi động lại.)

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

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