failproofai 1.0.1-beta.0 → 1.0.1

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

@@ -0,0 +1,151 @@
+---
+title: Bảng điều khiển
+description: "Giám sát các phiên làm việc của agent, xem xét các lệnh gọi tool và quản lý chính sách"
+icon: chart-line
+---
+
+Bảng điều khiển failproofai là một ứng dụng web cục bộ để giám sát các phiên làm việc của AI agent và quản lý chính sách. Xem những gì các agent của bạn đã làm khi bạn không có mặt.
+
+---
+
+## Khởi động bảng điều khiển
+
+```bash
+failproofai
+```
+
+Mở tại `http://localhost:8020`.
+
+Bảng điều khiển đọc dữ liệu cấu hình dự án, phiên và failproofai cục bộ trực tiếp từ hệ thống tệp. Các tính năng xác thực tùy chọn, chẳng hạn như nhắc nhở kiểm toán và lời mời, gửi thông tin cần thiết cho các yêu cầu đó (bao gồm địa chỉ email) đến các API từ xa.
+
+---
+
+## Các trang
+
+### Dự án
+
+Liệt kê tất cả Claude Code, OpenAI Codex, GitHub Copilot CLI _(beta)_, Cursor Agent _(beta)_, OpenCode _(beta)_, Pi _(beta)_, Hermes, OpenClaw, Factory Droid, Devin, Antigravity và Goose projects được tìm thấy trên máy của bạn. Các dự án Claude được phát hiện từ `~/.claude/projects/` (hoặc đường dẫn được đặt bằng `CLAUDE_PROJECTS_PATH`); các dự án Codex được phát hiện bằng cách quét từng bản ghi tạm nhất dưới `~/.codex/sessions/<YYYY>/<MM>/<DD>/*.jsonl` và nhóm theo `cwd` được ghi lại trong bản ghi đầu tiên của mỗi phiên; các dự án Copilot CLI được phát hiện bằng cách quét từng `~/.copilot/session-state/<sessionId>/workspace.yaml` (có thể cấu hình thông qua `COPILOT_HOME`) và nhóm theo trường `cwd` của nó; các dự án Cursor Agent được phát hiện bằng cách quét siêu dữ liệu cho từng phiên dưới `~/.cursor/agent-sessions/<sessionId>/` (có thể cấu hình thông qua `CURSOR_HOME`, với `conversations/` và `sessions/` được kiểm tra dự phòng) để tìm `cwd` vô hướng trong `meta.json` / `session.json` / `workspace.yaml`; các dự án OpenCode được phát hiện bằng cách truy vấn cơ sở dữ liệu SQLite của nó tại `~/.local/share/opencode/opencode.db` thông qua `opencode db --format json` (chúng tôi đọc các bảng `session` và `project` và nhóm theo `project_id`); các dự án Pi được phát hiện bằng cách quét các bản ghi tạm nhất JSONL cho từng phiên dưới `~/.pi/agent/sessions/<encoded-cwd>/<timestamp>_<uuid>.jsonl` (có thể cấu hình thông qua `PI_SESSIONS_DIR`) và lấy `cwd` từ bản ghi đầu tiên của mỗi phiên; các phiên cổng Hermes được đọc trực tiếp từ kho lưu trữ SQLite của mỗi hồ sơ — `~/.hermes/state.db` cộng với `~/.hermes/profiles/<name>/state.db` (có thể ghi đè thông qua `HERMES_HOME` hoặc `HERMES_DB_PATH` cho một cơ sở dữ liệu duy nhất) — và được nhóm thành các dự án `hermes-<profile>-<source>` theo hồ sơ và `source` (Slack/Telegram/cli/cron — các phiên cổng không có cwd); các phiên cổng OpenClaw được đọc từ `~/.openclaw/agents/<agentId>/sessions/*.jsonl` và được nhóm thành các dự án `openclaw-<agentId>-<channel>` theo agent và kênh (cũng không có cwd); các dự án Factory Droid được phát hiện từ các bản ghi tạm nhất JSONL tại `~/.factory/sessions/<encoded-cwd>/*.jsonl` và được nhóm theo cwd; các dự án Devin từ cơ sở dữ liệu SQLite của nó tại `~/.local/share/devin/cli/sessions.db` (được nhóm theo `working_directory` của mỗi phiên); các dự án Antigravity từ các bản ghi tạm nhất JSONL tại `~/.gemini/antigravity-cli/brain/<conversationId>/…/transcript_full.jsonl` và được nhóm theo cwd; và các dự án Goose từ cơ sở dữ liệu SQLite của nó tại `~/.local/share/goose/sessions/sessions.db` (được nhóm theo `working_dir` của mỗi phiên). Một dự án đã được sử dụng bởi nhiều CLI sẽ hiển thị dưới dạng một hàng duy nhất với tất cả các badge phù hợp. Sử dụng dropdown **CLI** phía trên bảng để lọc theo một agent CLI cụ thể; URL sẽ lưu giữ lựa chọn của bạn dưới dạng `?cli=claude|codex|copilot|cursor|opencode|pi|hermes|openclaw|factory|devin|antigravity|goose`.
+
+Hermes và OpenClaw là phạm vi người dùng và không có thư mục làm việc để nhóm, vì vậy chúng hiển thị dưới dạng **cây thư mục có thể thu gọn** — hồ sơ (hoặc agent) ở cấp cao nhất, các kênh của nó bên dưới — trong khi mọi CLI dựa trên cwd vẫn là một hàng phẳng. Các hàng thư mục tính tổng số phiên và hoạt động gần đây nhất của mọi thứ bên dưới chúng, các thư mục bị thu gọn được ghi nhớ giữa các lần truy cập, và tìm kiếm từ khóa sẽ mở rộng bất cứ thứ gì nó phù hợp.
+
+Mỗi dự án hiển thị:
+- Tên dự án (được lấy từ đường dẫn thư mục)
+- Một badge CLI — `Claude Code` (cam), `OpenAI Codex` (tím), `GitHub Copilot` (xanh), `Cursor Agent` (xanh lục), `OpenCode` (hổphách), `Pi` (hồng), và/hoặc `Hermes` (chàm)
+- Ngày hoạt động phiên gần đây nhất
+
+Nhấp vào dự án để xem các phiên của nó.
+
+### Các phiên
+
+Liệt kê tất cả các phiên trong một dự án. Mỗi phiên hiển thị:
+- ID phiên
+- Dấu thời gian bắt đầu và kết thúc
+- Số lượng lệnh gọi tool
+- Số lượng hoạt động hook (chính sách đã kích hoạt)
+
+Sử dụng bộ lọc phạm vi ngày và tìm kiếm ID phiên để thu hẹp danh sách. Các phiên được phân trang.
+
+Nhấp vào một phiên để mở trình xem phiên.
+
+### Trình xem phiên
+
+Trình xem phiên trả lời câu hỏi chính cho các agent tự trị: agent đã làm gì, và liệu nó có duy trì hướng đúng không? Một badge CLI bên cạnh tiêu đề cho biết phiên là Claude Code, OpenAI Codex, GitHub Copilot CLI, Cursor Agent, OpenCode, Pi, Hermes, OpenClaw, Factory Droid, Devin, Antigravity hay Goose transcript. Nó hiển thị một dòng thời gian của mọi thứ đã xảy ra trong một phiên:
+
+- **Tin nhắn** - Các phản hồi văn bản của Claude và lời nhắc của người dùng
+- **Lệnh gọi tool** - Mọi tool mà Claude đã gọi, với đầu vào và đầu ra của nó
+- **Hoạt động chính sách** - Với mỗi lệnh gọi tool, chính sách nào đã kích hoạt và quyết định nào họ trả lại
+
+Thanh thống kê ở đầu trang hiển thị thời lượng phiên, tổng số lệnh gọi tool và một tóm tắt quyết định hook (số lượng allow / deny / instruct).
+
+Nhấp vào nút **Download Logs** để xuất phiên. Đối với các phiên Claude Code, Codex, Copilot, Cursor và Pi, bạn sẽ nhận được bản ghi tạm nhất JSONL trên đĩa nguyên gốc theo từng byte; đối với OpenCode (các phiên của nó nằm trong SQLite, không phải trên đĩa), bạn sẽ nhận được một tài liệu JSON phản chiếu các bảng `session` / `messages` / `parts` cơ bản.
+
+### Kiểm toán
+
+Một báo cáo được hướng dẫn bởi tính cách về cách agent của bạn thực sự đã hoạt động trong các phiên quá khứ. Chạy cùng một quét như CLI `failproofai audit` nhưng hiển thị nó dưới dạng một tấm áp phích có thể chia sẻ trên một màn hình + bốn phần phía dưới gấp:
+
+1. **Tấm áp phích** — điền vào viewport đầu tiên. Vùng tự chứa để chụp PNG với logo từ failproof_ai + nhãn kiểm toán · chỉ số kiểu mẫu (`№ NN of 08`) + ngày kiểm toán · điểm số (0–100) + viên xếp hạng phần trăm (`top 15%`) · tên kiểu mẫu (một trong `the optimist`, `the cowboy`, `the explorer`, `the goldfish`, `the paranoid architect`, `the precision builder`, `the hammer`, `the ghost`) + dải 3 từ khóa · dòng hiếm `// only N% of agents are this archetype` · ô ký tự 8×8 pixel · chân trang `audit yours → failproof.ai`. Ba nút chia sẻ nằm ngoài hộp chụp: `post your archetype` (X intent), `share on linkedin`, `download poster`. Chụp chạy qua `html-to-image` vì vậy PNG khớp với hiển thị trên màn hình pixel-for-pixel (đường viền chấm chấm, SVG logo mask, gradient, số liệu phông chữ — tất cả được bảo toàn).
+2. **Điểm mạnh** — calming ✓ danh sách hàng các hành vi mà agent của bạn đã làm đúng, được lấy từ dữ liệu kiểm toán trực tiếp (tỷ lệ lệnh gọi tool sạch sẽ, không có đẩy trực tiếp đến main, không rò rỉ thông tin xác thực, không có trận bão thử lại) — mỗi cái chỉ được hiển thị khi chính sách liên quan có hồ sơ sạch sẽ trên toàn cửa sổ kiểm toán.
+3. **Những điều lẻ** — bảng của những gì đã lọt qua, xếp hạng theo mức độ nghiêm trọng: `when · what slipped + the policy that would've caught it · severity pill · seen`, trong đó sự tái diễn đọc `new` (một lần), `N× seen` (2–9 lần), hoặc `recurring` (10+).
+4. **Cách để cải thiện** — danh sách hàng tĩnh, một cho mỗi chính sách được quy định: tên chính sách bằng trắng, mô tả một dòng, lệnh cài đặt + nút sao chép ở bên phải. Tiêu đề phần đọc `enable all N → projected <score> · <tier>` (điểm số bạn sẽ đạt được với mọi bản sửa chữa được áp dụng), và nút `[install all]` của nó sao chép lệnh `failproofai policy add a b c …` kết hợp cho mỗi chính sách được quy định.
+5. **Quay lại tốt hơn** — hai thẻ cạnh nhau. Bên trái: đặt nhắc nhở (`3d` / `7d` / `14d` / `30d` bộ chọn nhịp độ; tồn tại thông qua `/api/auth/reminder` khi xác thực). Bên phải: mở khóa các quyền lợi failproof — `invite a friend` mở một modal nhận một danh sách email bạn bè được phân tách bằng dấu phẩy/khoảng trắng/dòng mới (tối đa 10 trên mỗi lần gửi), POSTs chúng đến `/api/audit/invite`, được chuyển tiếp đến `POST /v0/invite` của máy chủ api. Máy chủ api gửi một email cho mỗi người nhận từ `invite@failproof.ai` với người gửi được Cc và `Reply-To` được đặt, vì vậy người nhận sẽ thấy ai đã mời họ và người gửi nhận được một bản sao trong hộp thư đến của họ. Người dùng ẩn danh được chuyển hướng qua `AuthDialog` trước tiên để email của người gửi được biết trước khi lời mời được gửi đi. Hoàn thành quyền lợi / quyền lợi là một công việc tiếp theo.
+
+Được điều khiển bởi quá trình chạy `failproofai audit` — xem [Audit CLI](/vi/cli/audit) để biết công cụ quét cơ bản, các cờ được hỗ trợ và bất biến bộ nhớ cache cho mỗi bản ghi. Bảng điều khiển lưu cache kết quả mới nhất tại `~/.failproofai/audit-dashboard.json` (chế độ `0600`, khe duy nhất, các bộ chạy mới ghi đè) vì vậy các lần truy cập lại là tức thì; **cả bộ nhớ cache cho mỗi bản ghi và toàn bộ kết quả đều bị từ chối khi đọc sau khi chúng cũ hơn 7 ngày** vì vậy bảng điều khiển không bao giờ im lặng cung cấp kết quả cách đây một tuần — quá TTL `/audit` rơi vào trạng thái trống của nó và nhắc nhở một lần chạy tươi. Nhấp vào `[ re-audit now ]` gần dưới cùng của báo cáo POSTs `/api/audit/run` với `noCache: true` — re-audit bỏ qua bộ nhớ cache cho mỗi bản ghi và quét lại mọi bản ghi từ đầu thay vì im lặng trả lại kết quả được lưu cache — và bảng điều khiển thăm dò `/api/audit/status` ở 1Hz cho đến khi lần chạy hoàn thành; một dải tiến trình hồng dính ghép đỉnh viewport trong lần chạy có bộ đếm thời gian trôi qua, và kết quả tươi tho hoán đổi tại chỗ khi thành công (không có tải lại trang đầy đủ; kiểm toán lại không thành công để lại báo cáo trước đó nguyên vẹn). Khi thất bại, dải quay sang màu đỏ với bản sao được tính khóa từ `RerunError.kind` (`timeout` / `network` / `post_failed`). Trạng thái trống (không có bộ nhớ cache hoặc hết hạn) và trạng thái không có phiên (bộ nhớ cache tồn tại nhưng quét không tìm thấy bản ghi nào) được hiển thị riêng biệt.
+
+### Chính sách
+
+Một trang hai tab để quản lý chính sách và xem xét hoạt động.
+
+<Tabs>
+  <Tab title="Tab Chính sách">
+  - Chọn nhiều tùy chọn mà CLI agent nào failproofai bảo vệ từ một bảng duy nhất — Claude Code, OpenAI Codex, GitHub Copilot, Cursor Agent, OpenCode, Pi và Hermes đều có một hàng với trạng thái cài đặt (`Active` / `Detected` / `Inactive`), đường dẫn cài đặt phạm vi người dùng và một acent màu thương hiệu. Chọn hoặc bỏ chọn các CLI mà bạn muốn và nhấp vào `Apply changes` để cài đặt/gỡ cài đặt sự khác biệt trong một bước. Các CLI có tệp nhị phân được phát hiện trên PATH sẽ được đánh dấu trước.
+  - Bật hoặc tắt các chính sách riêng lẻ bằng một cú nhấp duy nhất (ghi vào `~/.failproofai/policies-config.json` — chia sẻ trên mọi CLI được cài đặt)
+  - Mở rộng một chính sách để cấu hình các tham số của nó (đối với các chính sách hỗ trợ `policyParams`)
+  - Đặt đường dẫn tệp chính sách tùy chỉnh
+  </Tab>
+  <Tab title="Tab Hoạt động">
+  - Lịch sử trang đầy đủ của mỗi sự kiện hook đã kích hoạt trên tất cả các phiên
+  - Lọc theo quyết định, loại sự kiện, CLI (Claude Code / OpenAI Codex / GitHub Copilot _(beta)_ / Cursor Agent _(beta)_ / OpenCode _(beta)_ / Pi _(beta)_ / Hermes / OpenClaw / Factory Droid / Devin / Antigravity / Goose), tên chính sách hoặc ID phiên
+  - Mỗi hàng hiển thị: dấu thời gian, tên chính sách, quyết định, badge CLI (cam = Claude Code, tím = OpenAI Codex, xanh = GitHub Copilot, xanh lục = Cursor Agent, hổphách = OpenCode, hồng = Pi, chàm = Hermes, xanh mặt = OpenClaw, hồng nhạt = Factory Droid, tím = Devin, lục = Antigravity, vôi = Goose), tên tool, ID phiên và lý do cho các quyết định deny/instruct
+  - Nhấp vào ID phiên để mở bản ghi của nó — trình xem tự động phát hiện CLI nào kích hoạt hook (Claude `~/.claude/projects/…`, Codex `~/.codex/sessions/…`, Copilot CLI `~/.copilot/session-state/<id>/events.jsonl`, Cursor Agent `~/.cursor/agent-sessions/<id>/events.jsonl`, OpenCode `~/.local/share/opencode/opencode.db`, Pi `~/.pi/agent/sessions/<encoded-cwd>/<id>.jsonl`, Hermes `~/.hermes/state.db`, OpenClaw `~/.openclaw/agents/<id>/sessions/*.jsonl`, Factory Droid `~/.factory/sessions/<encoded-cwd>/<id>.jsonl`, Devin `~/.local/share/devin/cli/sessions.db`, Antigravity `~/.gemini/antigravity-cli/brain/<id>/…/transcript_full.jsonl`, Goose `~/.local/share/goose/sessions/sessions.db`) và hiển thị badge CLI phù hợp trong tiêu đề
+  </Tab>
+</Tabs>
+
+---
+
+## Làm mới tự động
+
+Bảng điều khiển có một công tắc làm mới tự động trong thanh điều hướng trên cùng. Khi được bật, trang hiện tại làm mới định kỳ để hiển thị các phiên mới và hoạt động chính sách khi chúng xuất hiện. Cần thiết để giám sát các phiên agent tự trị chạy dài.
+
+---
+
+## Vô hiệu hóa các trang
+
+Nếu bạn chỉ cần một số phần của bảng điều khiển, hãy đặt `FAILPROOFAI_DISABLE_PAGES` thành một danh sách các tên trang được phân tách bằng dấu phẩy:
+
+```bash
+FAILPROOFAI_DISABLE_PAGES=policies failproofai
+```
+
+Các giá trị hợp lệ: `policies`, `projects`, `audit`.
+
+---
+
+## Cấu hình đường dẫn dự án
+
+Theo mặc định, bảng điều khiển đọc từ thư mục dự án Claude Code tiêu chuẩn. Ghi đè nó cho các thiết lập tùy chỉnh:
+
+```bash
+CLAUDE_PROJECTS_PATH=/custom/path/to/projects failproofai
+```
+
+---
+
+## Truy cập từ máy chủ không phải localhost
+
+Khi chạy bảng điều khiển ở **chế độ dev** (`npm run dev`) và truy cập nó từ tên máy chủ khác với `localhost` - ví dụ, một tên miền tùy chỉnh, một IP từ xa hoặc một URL được kết hợp - bạn có thể thấy một cảnh báo như:
+
+```text
+⚠ Blocked cross-origin request to Next.js dev resource /_next/webpack-hmr from "dashboard.example.com".
+```
+
+Đây là Next.js chặn truy cập xuyên nguồn gốc vào HMR (hot module reload) websocket của nó, là một tính năng chỉ dành cho dev. Để cho phép máy chủ của bạn, hãy sử dụng cờ `--allowed-origins`:
+
+```bash
+npm run dev -- --allowed-origins dashboard.example.com
+```
+
+Đối với nhiều máy chủ hoặc IP, hãy chuyển một danh sách được phân tách bằng dấu phẩy:
+
+```bash
+npm run dev -- --allowed-origins dashboard.example.com,192.168.1.5
+```
+
+Bạn cũng có thể đặt biến môi trường `FAILPROOFAI_ALLOWED_DEV_ORIGINS`:
+
+```bash
+FAILPROOFAI_ALLOWED_DEV_ORIGINS=dashboard.example.com npm run dev
+```
+
+<Note>
+Điều này chỉ áp dụng cho chế độ dev. Khi chạy `failproofai` (chế độ production), không có websocket HMR và không có vấn đề tài nguyên dev xuyên nguồn gốc.
+</Note>

package/.next/standalone/docs-old/vi/examples.mdx

@@ -0,0 +1,308 @@
+---
+---
+title: Ví dụ
+description: "Cách thiết lập hooks cho Claude Code và Agents SDK"
+icon: book-open
+---
+
+Các ví dụ sẵn sàng sử dụng cho các tình huống phổ biến. Mỗi ví dụ cho thấy cách cài đặt và những gì bạn có thể mong đợi.
+
+---
+
+## Thiết lập hooks cho Claude Code
+
+Failproof AI tích hợp với Claude Code thông qua [hệ thống hooks](https://docs.anthropic.com/en/docs/claude-code/hooks) của nó. Khi bạn chạy `failproofai policies --install`, nó đăng ký các lệnh hook trong `settings.json` của Claude Code sẽ kích hoạt trên mỗi lệnh gọi công cụ.
+
+<Steps>
+  <Step title="Cài đặt failproofai">
+    ```bash
+    npm install -g failproofai
+    ```
+  </Step>
+  <Step title="Bật tất cả các chính sách tích hợp sẵn">
+    ```bash
+    failproofai policies --install
+    ```
+  </Step>
+  <Step title="Xác minh hooks đã được đăng ký">
+    ```bash
+    cat ~/.claude/settings.json | grep failproofai
+    ```
+
+    Bạn sẽ thấy các mục hook cho các sự kiện `PreToolUse`, `PostToolUse`, `Notification`, và `Stop`.
+  </Step>
+  <Step title="Chạy Claude Code">
+    ```bash
+    claude
+    ```
+
+    Các chính sách giờ đây chạy tự động trên mỗi lệnh gọi công cụ. Hãy thử yêu cầu Claude chạy `sudo rm -rf /` - nó sẽ bị chặn.
+  </Step>
+</Steps>
+
+---
+
+## Thiết lập hooks cho Agents SDK
+
+Nếu bạn đang xây dựng với [Agents SDK](https://docs.anthropic.com/en/docs/agents-sdk), bạn có thể sử dụng cùng hệ thống hook theo chương trình.
+
+<Steps>
+  <Step title="Cài đặt failproofai trong dự án của bạn">
+    ```bash
+    npm install failproofai
+    ```
+  </Step>
+  <Step title="Cấu hình hooks trong agent của bạn">
+    Truyền các lệnh hook khi tạo quy trình agent của bạn. Các hooks kích hoạt theo cách tương tự như trong Claude Code - thông qua JSON stdin/stdout:
+
+    ```bash
+    failproofai --hook PreToolUse   # gọi trước mỗi công cụ
+    failproofai --hook PostToolUse  # gọi sau mỗi công cụ
+    ```
+  </Step>
+  <Step title="Viết một chính sách tùy chỉnh cho agent của bạn">
+    ```javascript
+    import { customPolicies, allow, deny } from "failproofai";
+
+    customPolicies.add({
+      name: "limit-to-project-dir",
+      description: "Giữ agent trong thư mục dự án",
+      match: { events: ["PreToolUse"] },
+      fn: async (ctx) => {
+        const path = String(ctx.toolInput?.file_path ?? "");
+        if (path.startsWith("/") && !path.startsWith(ctx.session?.cwd ?? "")) {
+          return deny("Agent bị giới hạn trong thư mục dự án");
+        }
+        return allow();
+      },
+    });
+    ```
+  </Step>
+  <Step title="Cài đặt chính sách tùy chỉnh">
+    ```bash
+    failproofai policies --install --custom ./my-agent-policies.js
+    ```
+  </Step>
+</Steps>
+
+---
+
+## Chặn các lệnh phá hủy
+
+Thiết lập phổ biến nhất - ngăn agents thực hiện các hành động không thể đảo ngược.
+
+```bash
+failproofai policies --install block-sudo block-rm-rf block-force-push block-curl-pipe-sh
+```
+
+Điều này làm gì:
+- `block-sudo` - chặn tất cả các lệnh `sudo`
+- `block-rm-rf` - chặn xóa tệp đệ quy
+- `block-force-push` - chặn `git push --force`
+- `block-curl-pipe-sh` - chặn piping các script từ xa tới shell
+
+---
+
+## Ngăn chặn rò rỉ bí mật
+
+Ngăn agents nhìn thấy hoặc rò rỉ thông tin xác thực trong đầu ra công cụ.
+
+```bash
+failproofai policies --install sanitize-api-keys sanitize-jwt sanitize-connection-strings sanitize-bearer-tokens
+```
+
+Những chính sách này kích hoạt trên `PostToolUse` - sau khi một công cụ chạy, chúng sẽ xóa sạch đầu ra trước khi agent nhìn thấy nó.
+
+---
+
+## Nhận thông báo Slack khi agents cần chú ý
+
+Sử dụng hook thông báo để chuyển tiếp các cảnh báo không hoạt động tới Slack.
+
+```javascript
+import { customPolicies, allow, instruct } from "failproofai";
+
+customPolicies.add({
+  name: "slack-on-idle",
+  description: "Cảnh báo Slack khi agent đang chờ đầu vào",
+  match: { events: ["Notification"] },
+  fn: async (ctx) => {
+    const webhookUrl = process.env.SLACK_WEBHOOK_URL;
+    if (!webhookUrl) return allow();
+
+    const message = String(ctx.payload?.message ?? "Agent đang chờ");
+    const project = ctx.session?.cwd ?? "không xác định";
+
+    try {
+      await fetch(webhookUrl, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          text: `*${message}*\nDự án: \`${project}\``,
+        }),
+        signal: AbortSignal.timeout(5000),
+      });
+    } catch {
+      // không bao giờ chặn agent nếu Slack không thể tiếp cận
+    }
+
+    return allow();
+  },
+});
+```
+
+Cài đặt nó:
+
+```bash
+SLACK_WEBHOOK_URL=https://hooks.slack.com/... failproofai policies --install --custom ./slack-alerts.js
+```
+
+---
+
+## Giữ agents trên một nhánh
+
+Ngăn agents chuyển đổi nhánh hoặc đẩy tới các nhánh được bảo vệ.
+
+```javascript
+import { customPolicies, allow, deny } from "failproofai";
+
+customPolicies.add({
+  name: "stay-on-branch",
+  description: "Ngăn agent kiểm tra các nhánh khác",
+  match: { events: ["PreToolUse"] },
+  fn: async (ctx) => {
+    if (ctx.toolName !== "Bash") return allow();
+    const cmd = String(ctx.toolInput?.command ?? "");
+    if (/git\s+checkout\s+(?!-b)/.test(cmd)) {
+      return deny("Ở lại trên nhánh hiện tại. Tạo một nhánh mới với -b nếu cần.");
+    }
+    return allow();
+  },
+});
+```
+
+---
+
+## Yêu cầu kiểm thử trước commit
+
+Nhắc nhở agents chạy kiểm thử trước khi commit.
+
+```javascript
+import { customPolicies, allow, instruct } from "failproofai";
+
+customPolicies.add({
+  name: "test-before-commit",
+  description: "Nhắc nhở agent chạy kiểm thử trước khi commit",
+  match: { events: ["PreToolUse"] },
+  fn: async (ctx) => {
+    if (ctx.toolName !== "Bash") return allow();
+    const cmd = String(ctx.toolInput?.command ?? "");
+    if (/git\s+commit/.test(cmd)) {
+      return instruct("Chạy kiểm thử trước khi commit. Sử dụng `npm test` hoặc `bun test` trước tiên.");
+    }
+    return allow();
+  },
+});
+```
+
+---
+
+## Khóa một kho lưu trữ production
+
+Commit một cấu hình cấp độ dự án để mọi nhà phát triển trong nhóm của bạn có được cùng các chính sách.
+
+Tạo `.failproofai/policies-config.json` trong kho lưu trữ của bạn:
+
+```json
+{
+  "enabledPolicies": [
+    "block-sudo",
+    "block-rm-rf",
+    "block-force-push",
+    "block-push-master",
+    "block-env-files",
+    "sanitize-api-keys",
+    "sanitize-jwt"
+  ],
+  "policyParams": {
+    "block-push-master": {
+      "protectedBranches": ["main", "release", "production"]
+    }
+  }
+}
+```
+
+Sau đó commit nó:
+
+```bash
+git add .failproofai/policies-config.json
+git commit -m "Thêm chính sách failproofai của nhóm"
+```
+
+Mọi thành viên trong nhóm có cài đặt failproofai sẽ tự động áp dụng các quy tắc này.
+
+---
+
+## Xây dựng tiêu chuẩn chất lượng toàn tổ chức bằng các chính sách quy ước
+
+Thiết lập có tác động nhất: commit `.failproofai/policies/` tới kho lưu trữ của bạn với các chính sách được điều chỉnh cho dự án của bạn. Mọi thành viên trong nhóm có được chúng tự động — không có lệnh cài đặt, không có thay đổi cấu hình.
+
+<Steps>
+  <Step title="Tạo thư mục và thêm chính sách">
+    ```bash
+    mkdir -p .failproofai/policies
+    ```
+
+    ```js
+    // .failproofai/policies/team-policies.mjs
+    import { customPolicies, allow, deny, instruct } from "failproofai";
+
+    // Thực thi trình quản lý gói ưa thích của nhóm
+    // (hoặc bật chính sách prefer-package-manager tích hợp sẵn)
+    customPolicies.add({
+      name: "enforce-bun",
+      match: { events: ["PreToolUse"] },
+      fn: async (ctx) => {
+        if (ctx.toolName !== "Bash") return allow();
+        const cmd = String(ctx.toolInput?.command ?? "");
+        if (/\bnpm\b/.test(cmd)) return deny("Sử dụng bun thay vì npm.");
+        return allow();
+      },
+    });
+
+    // Nhắc nhở agent chạy kiểm thử trước khi commit
+    customPolicies.add({
+      name: "test-before-commit",
+      match: { events: ["PreToolUse"] },
+      fn: async (ctx) => {
+        if (ctx.toolName !== "Bash") return allow();
+        if (/git\s+commit/.test(ctx.toolInput?.command ?? "")) {
+          return instruct("Chạy kiểm thử trước khi commit.");
+        }
+        return allow();
+      },
+    });
+    ```
+  </Step>
+  <Step title="Commit tới git">
+    ```bash
+    git add .failproofai/policies/
+    git commit -m "Thêm chính sách chất lượng của nhóm"
+    ```
+  </Step>
+  <Step title="Tiếp tục cải thiện">
+    Khi nhóm của bạn gặp phải các chế độ lỗi mới, hãy thêm chính sách và đẩy. Mọi người sẽ nhận được cập nhật trong lần `git pull` tiếp theo của họ. Các chính sách này trở thành một tiêu chuẩn chất lượng sống động phát triển cùng với nhóm của bạn.
+  </Step>
+</Steps>
+
+---
+
+## Các ví dụ khác
+
+Thư mục [`examples/`](https://github.com/failproofai/failproofai/tree/main/examples) trong kho lưu trữ chứa:
+
+| Tệp | Nó hiển thị cái gì |
+|------|---------------|
+| `policies-basic.js` | Chính sách khởi đầu - chặn ghi production, force-push, piped scripts |
+| `policies-notification.js` | Cảnh báo Slack cho các thông báo không hoạt động và kết thúc phiên |
+| `policies-advanced/index.js` | Nhập dịch vụ, hooks async, xóa sạch đầu ra PostToolUse, xử lý sự kiện Stop |

package/.next/standalone/docs-old/vi/for-agents.mdx

@@ -0,0 +1,39 @@
+---
+---
+title: "For agents"
+description: "Thêm kiến thức Failproof AI vào agent viết code của bạn chỉ bằng một lệnh. Hoạt động với Claude Code, Cursor, Windsurf và nhiều hơn nữa."
+---
+
+Thêm toàn bộ tài liệu tham khảo Failproof AI vào agent viết code của bạn chỉ bằng một lệnh. Hoạt động với Claude Code, Cursor, Windsurf và bất kỳ agent nào khác hỗ trợ skills.
+
+```bash
+npx skills add https://docs.befailproof.ai
+```
+
+`npx skills` phát hiện các agent bạn đã cài đặt và tự động thêm skill ở định dạng phù hợp cho từng agent.
+
+## Skill bao gồm những gì
+
+| Lĩnh vực | Nội dung bao gồm |
+|------|----------------|
+| Policies | Tên policy được tích hợp sẵn, loại sự kiện, tham số, bật/tắt |
+| Custom policies | `customPolicies.add()`, match filters, API `allow`/`deny`/`instruct` |
+| Context object | `ctx.eventType`, `ctx.toolName`, `ctx.toolInput`, `ctx.session` |
+| Configuration | Cấu trúc `policies-config.json`, scope merging, `policyParams` |
+| CLI | `failproofai policies --install`, `--uninstall`, `--custom`, scopes |
+| Dashboard | Session viewer, policy activity, biến môi trường |
+| Architecture | Hook handler flow, exit codes, hợp đồng stdin/stdout |
+
+## Skill có hoàn chỉnh không?
+
+Mintlify tạo `llms.txt` từ tất cả các trang trong navigation. Tài liệu Failproof AI bao gồm toàn bộ API - mọi policy, tùy chọn và ví dụ đều có. Nếu bạn thấy thiếu điều gì, nguồn là tại `https://docs.befailproof.ai/llms-full.txt`.
+
+Để có nội dung được lọc lại, hãy liên kết trực tiếp đến một trang cụ thể:
+
+```bash
+# Chỉ API custom policies
+npx skills add https://docs.befailproof.ai/custom-policies
+
+# Chỉ các built-in policies
+npx skills add https://docs.befailproof.ai/built-in-policies
+```