truthmark 2.2.2 → 2.2.5

package/docs/readmes/README.vi.md

@@ -0,0 +1,225 @@
+# Truthmark
+
+**Các tác tử của bạn viết mã. Truthmark duy trì tài liệu hướng tới con người và có thể được xem xét qua Git.**
+
+[🇺🇸 English](../../README.md) | [🇨🇳 简体中文](README.zh.md) | [🇯🇵 日本語](README.ja.md) | [🇰🇷 한국어](README.ko.md) | [🇩🇪 Deutsch](README.de.md) | [🇫🇷 Français](README.fr.md) | [🇪🇸 Español](README.es.md) | [🇧🇷 Português](README.pt.md) | [🇷🇺 Русский](README.ru.md) | [🇸🇦 العربية](README.ar.md) | [🇮🇹 Italiano](README.it.md) | [🇵🇱 Polski](README.pl.md) | [🇹🇷 Türkçe](README.tr.md) | [🇻🇳 Tiếng Việt](README.vi.md) | [🇮🇩 Bahasa Indonesia](README.id.md) | [🇬🇷 Ελληνικά](README.el.md)
+
+![Biểu ngữ Truthmark](../assets/truthmark-banner.png)
+
+## 🚀 Bắt đầu nhanh: chạy cục bộ trong năm phút
+
+Chạy lệnh này bên trong kho Git mà bạn muốn Truthmark quản lý:
+
+```bash
+cd /path/to/your-repo
+npm install -g truthmark
+truthmark config
+```
+
+Bật máy chủ AI mà bạn thực sự sử dụng. Cấu hình mới không gắn với máy chủ nào, vì vậy hãy thêm danh sách `platforms` ở cấp cao nhất vào `.truthmark/config.yml` trước khi khởi tạo:
+
+```yaml
+version: 2
+platforms:
+  - codex        # or: claude-code, github-copilot, opencode, antigravity, cursor
+truthmark:
+  workspace: docs/truthmark
+  generated:
+    portal:
+      enabled: false
+```
+
+Sau đó cài đặt tài liệu sự thật cục bộ của kho, định tuyến và các bề mặt quy trình làm việc cho tác tử:
+
+```bash
+truthmark init
+truthmark check
+git diff
+```
+
+Bây giờ hãy thử lộ trình áp dụng phổ biến nhất: ghi tài liệu cho một hành vi hiện có từ mã và kiểm thử. Trong máy chủ lập trình AI của bạn, hãy yêu cầu quy trình đã cài đặt:
+
+```text
+/truthmark-document document the implemented session timeout behavior across src/auth/session.ts and tests/auth/session.test.ts
+```
+
+Sau đó, người dùng thường không nên gọi Truth Sync trực tiếp. Hãy tiếp tục lập trình qua máy chủ AI của bạn; các chỉ dẫn kho đã cài đặt yêu cầu tác tử chạy các kiểm thử liên quan và thực hiện đánh giá Truth Sync trước khi bàn giao khi mã chức năng thay đổi. Bạn xem xét phần diff mã kết quả cùng với diff tài liệu truth.
+
+Nếu bạn chỉ muốn xác thực bằng CLI và chưa muốn các quy trình AI theo máy chủ, hãy để trống `platforms` và chạy `truthmark init && truthmark check`; bạn có thể thêm nền tảng sau và chạy lại `truthmark init`.
+
+## 💡 Vấn đề: khoảng trống tài liệu AI
+
+Các tác tử lập trình AI cực kỳ giỏi viết mã nhanh. Nhưng tốc độ này tạo ra một kiểu lỗi mới nguy hiểm: **câu chuyện của kho lệch khỏi thực tế.**
+
+* Hành vi bị mất trong lịch sử trò chuyện tạm thời.
+* Tài liệu kiến trúc nhanh chóng tụt lại phía sau.
+* Quyết định sản phẩm biến mất sau khi bàn giao.
+* Người xem xét mã phải xem các diff mã thô mà không hiểu "vì sao".
+* Mỗi phiên AI mới buộc phải khám phá lại sự thật của kho từ đầu.
+
+## 🎯 Giải pháp: Truthmark
+
+**Truthmark** cài đặt một lớp quy trình làm việc gốc Git vào kho của bạn. Nó khắc phục phần thường bị hỏng trong phát triển bằng AI: giúp tài liệu luôn khớp với mã.
+
+Thay vì hy vọng con người và tác tử AI nhớ cập nhật tài liệu, Truthmark biến việc ghi tài liệu thành một thói quen có hệ thống, có thể xem xét ngay trong kho của bạn.
+
+### ✨ Vì sao Truthmark khác biệt
+
+Truthmark không chỉ là một công cụ tài liệu khác. Nó được tích hợp sâu vào quy trình AI:
+
+* **🚫 Không bị khóa vào nhà cung cấp:** Không dịch vụ lưu trữ, không cơ sở dữ liệu ẩn, không máy chủ bổ sung để vận hành.
+* **🌳 100% gốc Git:** Mọi thứ nằm trong kho của bạn. Sự thật di chuyển cùng nhánh của bạn.
+* **🤝 Hợp đồng do con người sở hữu, tác tử tuân theo:** Người bảo trì sở hữu hợp đồng kho; tác tử tuân theo hướng dẫn đã cài đặt khi viết mã.
+* **✅ Tin cậy qua xác minh:** Công việc AI dễ được tin tưởng hơn vì công việc thay đổi hành vi bao gồm một quyết định hoặc diff tài liệu sự thật mà con người có thể xem xét.
+
+## 🔄 Cách hoạt động
+
+Khi một tác tử AI sửa mã của bạn, công việc chưa kết thúc. Truthmark cài đặt một chốt quy trình lúc hoàn tất mà tác tử tuân theo trước khi bàn giao:
+
+1. 💻 **Mã:** Tác tử sửa mã chức năng.
+2. 🧪 **Kiểm thử:** Các kiểm thử liên quan được chạy.
+3. 🔍 **Kiểm tra:** Truthmark kiểm tra tài liệu được ánh xạ như một phần của bước xem xét kết thúc đã cài đặt.
+4. 📝 **Ghi tài liệu:** Tài liệu được tác tử cập nhật khi sự thật của kho thay đổi.
+5. 👀 **Xem xét:** Con người xem xét *diff mã* + *diff sự thật*.
+
+## 🛠 Cách bạn tương tác với Truthmark
+
+Truthmark có một hợp đồng cục bộ trong kho và hai cách sử dụng nó.
+
+### Con người cài đặt và xác thực hợp đồng
+
+Người bảo trì và CI dùng CLI:
+
+* `truthmark config` - tạo cấu hình ban đầu.
+* `truthmark init` - cài đặt hoặc làm mới định tuyến, scaffold truth-doc và hướng dẫn cho AI host.
+* `truthmark check` - xác thực sự thật của kho từ terminal.
+
+### Tác tử tuân theo hợp đồng khi viết mã
+
+Truthmark cài đặt hướng dẫn cục bộ trong kho cho các AI coding host được hỗ trợ như Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity và Cursor.
+
+Vòng lặp bình thường rất đơn giản:
+
+1. Yêu cầu tác tử thay đổi mã hoặc ghi tài liệu cho một hành vi hiện có.
+2. Hướng dẫn đã cài đặt cho tác tử biết khi nào cần kiểm thử, khi nào cập nhật truth docs và khi nào dừng để con người xem xét.
+3. Bạn xem xét các Git diff thông thường: mã cộng với mọi thay đổi truth-doc.
+
+Các yêu cầu tác tử do người dùng khởi động được cố ý giữ ít:
+
+* `/truthmark-document` - ghi tài liệu cho hành vi đã triển khai hiện có từ mã và kiểm thử.
+* `/truthmark-realize` - triển khai mã từ truth docs hiện có.
+* `/truthmark-check` - kiểm toán sự thật của kho.
+
+Truth Sync không phải cách thông thường để bắt đầu công việc; đó là bước xem xét kết thúc sau các thay đổi mã chức năng.
+Truth Structure không phải lệnh hằng ngày; nó chỉ sửa định tuyến hoặc quyền sở hữu khi điều đó chặn công việc.
+
+## Bạn nhận được gì
+
+| Khả năng | Tác dụng |
+| --- | --- |
+| Sự thật gốc Git | Giữ sự thật của kho trong Markdown và cấu hình đã commit. |
+| Tài liệu theo phạm vi nhánh | Sự thật di chuyển cùng nhánh thay vì sống trong một phiên riêng tư. |
+| CLI dành cho con người | Cung cấp cho người bảo trì các lệnh thiết lập, làm mới, xác thực và kiểm tra. |
+| Hướng dẫn tác tử đã cài đặt | Cho tác tử lập trình biết khi nào ghi tài liệu, kiểm thử, đồng bộ sự thật, kiểm toán hoặc dừng để xem xét. |
+| Định tuyến rõ ràng | Ánh xạ các vùng mã tới tài liệu sự thật chuẩn. |
+| Bàn giao có thể xem xét | Tạo các diff Git thông thường cho cả mã và tài liệu sự thật. |
+| Vận hành ưu tiên cục bộ | Không yêu cầu dịch vụ lưu trữ, daemon, cơ sở dữ liệu hoặc máy chủ MCP. |
+| Ranh giới ghi an toàn hơn | Tách các quy trình code-first, doc-first, chỉ đọc và chỉ tài liệu. |
+| Xác thực | Báo cáo vấn đề về định tuyến, thẩm quyền, frontmatter, liên kết, bề mặt sinh ra, phạm vi nhánh, độ mới và độ phủ. |
+| Portal tùy chọn | Tạo một trang trình bày HTML tĩnh đã commit từ tài liệu sự thật Markdown khi được bật và yêu cầu rõ ràng. |
+
+## Tổng quan trực quan
+
+![Tính năng Truthmark](../assets/truthmark-features.png)
+
+**Tính năng:** Truthmark cài đặt gì và bề mặt quy trình được chia như thế nào.
+
+![Vị trí Truthmark](../assets/truthmark-position.png)
+
+**Vị trí:** Truthmark nằm ở đâu so với prompt, bộ nhớ và quy trình đặc tả.
+
+![Luồng đồng bộ Truthmark](../assets/truthmark-syncflow.png)
+
+**Luồng đồng bộ:** Truth Sync kết thúc các thay đổi mã thông thường trước khi bàn giao như thế nào.
+
+## Vì sao các nhóm áp dụng
+
+Truthmark dành cho các nhóm đã biết tác tử AI có thể tạo mã.
+
+Vấn đề tiếp theo là quản trị.
+
+Không phải quản trị như nghi thức. Quản trị như một câu hỏi đơn giản:
+
+> Sau thay đổi được AI hỗ trợ này, kho có còn nói đúng sự thật không?
+
+Truthmark giúp các nhóm trả lời điều đó bằng các tệp đã commit, định tuyến rõ ràng và diff có thể xem xét.
+
+Nó hữu ích khi bạn cần:
+
+- ít trôi lệch tài liệu hơn
+- bàn giao tốt hơn
+- sự thật sản phẩm theo từng nhánh
+- tài liệu kiến trúc và API bền vững
+- quyền sở hữu rõ ràng giữa tài liệu và mã
+- ranh giới ghi an toàn hơn cho tác tử
+- tài liệu có thể xem xét thay vì bộ nhớ ẩn
+- quy trình AI vẫn hoạt động từ các tệp kho đã commit
+
+## Truthmark phù hợp ở đâu
+
+Truthmark không thay thế prompt, bộ nhớ, đặc tả, kiểm thử hoặc xem xét mã.
+
+Nó cho các quy trình đó một nơi bền vững để hạ cánh trong Git.
+
+| Nhu cầu | Phù hợp hơn |
+| --- | --- |
+| Đầu ra tốt hơn từ một phiên tác tử | Prompt tốt hơn |
+| Tính liên tục cá nhân hoặc cấp phiên | Công cụ bộ nhớ |
+| Làm tính năng theo kế hoạch trước | Quy trình đặc tả |
+| Truth theo nhánh đi cùng mã | Truthmark |
+| Xác thực tính đúng của hành vi | Kiểm thử và xem xét |
+| Xem xét thay đổi tài liệu do AI hỗ trợ | Truthmark cộng với xem xét Git |
+
+Làn đường của Truthmark được thiết kế có chủ ý là hẹp:
+
+```text
+make repository truth explicit
+route it to code
+cài đặt hướng dẫn tác tử quanh nó
+keep the result reviewable in Git
+```
+
+## Tìm hiểu sâu hơn
+
+README là mặt tiền: ngữ cảnh nhanh, bắt đầu nhanh và mô hình tư duy cốt lõi.
+
+Để biết cách sử dụng từng lệnh, so sánh bề mặt, chi tiết nền tảng được hỗ trợ, cấu hình, định tuyến, Portal và ví dụ, hãy đọc [Hướng dẫn người dùng Truthmark](../user-guide.md).
+
+## Trạng thái dự án
+
+Bản phát hành hiện tại cung cấp:
+
+- các lệnh CLI cục bộ cho config, init, check, index, impact và trạng thái quy trình
+- hướng dẫn tác tử cục bộ trong kho được tạo cho Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity và Cursor
+- chẩn đoán về định tuyến, thẩm quyền, frontmatter, liên kết, độ mới, bề mặt sinh ra, phạm vi nhánh và độ phủ
+- tài liệu sự thật theo phạm vi nhánh và các hiện vật trí tuệ kho được suy dẫn
+
+## Tài liệu
+
+- [Hướng dẫn người dùng](../user-guide.md)
+- [Chỉ mục tài liệu](../README.md)
+- [Tổng quan kiến trúc](../truthmark/engineering/architecture/overview.md)
+- [Hợp đồng API và CLI](../truthmark/engineering/contracts/config-route-and-check-contracts.md)
+- [Hướng dẫn bảo trì sự thật của kho](../standards/maintaining-repository-truth.md)
+
+Để xem các lệnh phát triển cục bộ và đóng góp, hãy xem [CONTRIBUTING.md](../../CONTRIBUTING.md).
+
+## Ranh giới thiết kế
+
+Truthmark được cố ý giữ nhỏ: cục bộ, được commit, theo phạm vi nhánh và có thể xem xét.
+
+Nó không phải dịch vụ lưu trữ, máy chủ MCP, cơ sở dữ liệu vector, lớp bộ nhớ ẩn, sản phẩm cưỡng chế CI hay động cơ tự động viết lại mã. Nó giúp sự thật của kho luôn hiển thị; nó không thay thế kiểm thử, xem xét mã hay phán đoán của con người.
+
+## Giấy phép
+
+MIT. Xem [LICENSE](../../LICENSE).

package/docs/readmes/README.zh.md

@@ -0,0 +1,225 @@
+# Truthmark
+
+**你的代理会写代码。Truthmark 维护面向人类、可在 Git 中审查的文档。**
+
+[🇺🇸 English](../../README.md) | [🇨🇳 简体中文](README.zh.md) | [🇯🇵 日本語](README.ja.md) | [🇰🇷 한국어](README.ko.md) | [🇩🇪 Deutsch](README.de.md) | [🇫🇷 Français](README.fr.md) | [🇪🇸 Español](README.es.md) | [🇧🇷 Português](README.pt.md) | [🇷🇺 Русский](README.ru.md) | [🇸🇦 العربية](README.ar.md) | [🇮🇹 Italiano](README.it.md) | [🇵🇱 Polski](README.pl.md) | [🇹🇷 Türkçe](README.tr.md) | [🇻🇳 Tiếng Việt](README.vi.md) | [🇮🇩 Bahasa Indonesia](README.id.md) | [🇬🇷 Ελληνικά](README.el.md)
+
+![Truthmark 横幅](../assets/truthmark-banner.png)
+
+## 🚀 快速开始：五分钟本地运行
+
+在你希望由 Truthmark 管理的 Git 仓库中运行：
+
+```bash
+cd /path/to/your-repo
+npm install -g truthmark
+truthmark config
+```
+
+启用你实际使用的 AI 宿主。新配置默认与宿主无关，因此在初始化前，先把顶层 `platforms` 列表添加到 `.truthmark/config.yml`：
+
+```yaml
+version: 2
+platforms:
+  - codex        # or: claude-code, github-copilot, opencode, antigravity, cursor
+truthmark:
+  workspace: docs/truthmark
+  generated:
+    portal:
+      enabled: false
+```
+
+然后安装仓库本地的事实文档、路由和 AI 宿主指令：
+
+```bash
+truthmark init
+truthmark check
+git diff
+```
+
+现在尝试最常见的采用路径：根据代码和测试记录一个已有行为。在你的 AI 编码宿主中，请求已安装的工作流：
+
+```text
+/truthmark-document document the implemented session timeout behavior across src/auth/session.ts and tests/auth/session.test.ts
+```
+
+之后，用户通常不应直接调用 Truth Sync。继续通过你的 AI 宿主编写代码；已安装的仓库指令会告诉代理：当功能代码发生变化时，在交接前运行相关测试并执行 Truth Sync 审查。你审查最终的代码 diff 和事实文档 diff。
+
+如果你暂时只想要 CLI 验证，而不需要特定宿主的 AI 工作流，可以省略 `platforms`，并运行 `truthmark init && truthmark check`；之后你可以再添加平台并重新运行 `truthmark init`。
+
+## 💡 问题：AI 文档缺口
+
+AI 编码代理非常擅长快速编写代码。但这种速度会产生一种危险的新失效模式：**仓库所讲述的故事与现实发生偏移。**
+
+* 行为遗失在短暂的聊天历史中。
+* 架构文档很快落后。
+* 产品决策在交接后消失。
+* 代码审查者只能查看原始代码 diff，却不了解“为什么”。
+* 每个新的 AI 会话都被迫从头重新发现仓库事实。
+
+## 🎯 解决方案：Truthmark
+
+**Truthmark** 会在你的仓库中安装一个 Git 原生的工作流层。它修复 AI 开发中通常会坏掉的部分：帮助文档与代码保持一致。
+
+Truthmark 不是指望人类和 AI 代理都记得更新文档，而是在你的仓库中把文档变成一种系统化、可审查的习惯。
+
+### ✨ Truthmark 的独特之处
+
+Truthmark 不只是另一个文档工具。它深度集成到 AI 工作流中：
+
+* **🚫 零供应商锁定：** 没有托管服务、隐藏数据库，也没有需要额外运维的服务器。
+* **🌳 100% Git 原生：** 一切都存在于你的仓库中。事实随分支一起移动。
+* **🤝 人类拥有、代理遵循的契约：**维护者拥有仓库契约；代理在编码时遵循已安装的指令。
+* **✅ 通过验证建立信任：** 因为改变行为的工作会包含可由人类审查的事实文档决策或 diff，AI 工作更容易被信任。
+
+## 🔄 工作原理
+
+当 AI 代理修改你的代码时，工作并未完成。Truthmark 会安装一个交接前的收尾工作流保护，代理在交接前遵循它：
+
+1. 💻 **代码：** 代理修改功能代码。
+2. 🧪 **测试：** 执行相关测试。
+3. 🔍 **检查：**Truthmark 会把映射到的文档作为已安装收尾审查的一部分进行检查。
+4. 📝 **记录：** 当仓库事实发生变化时，代理更新文档。
+5. 👀 **审查：** 人类审查*代码 diff* + *事实 diff*。
+
+## 🛠 你如何使用 Truthmark
+
+Truthmark 有一个仓库本地契约，以及两种使用方式。
+
+### 人类安装并验证契约
+
+维护者和 CI 使用 CLI：
+
+* `truthmark config` - 创建初始配置。
+* `truthmark init` - 安装或刷新路由、事实文档脚手架和 AI 宿主指令。
+* `truthmark check` - 从终端验证仓库事实。
+
+### 代理在编码时遵循契约
+
+Truthmark 会为 Codex、Claude Code、GitHub Copilot、OpenCode、Antigravity 和 Cursor 等受支持的 AI 编码宿主安装仓库本地指令。
+
+正常循环很简单：
+
+1. 让代理修改代码，或让它记录已有行为。
+2. 已安装的指令会告诉代理何时测试、何时更新事实文档、何时停下来交给人类审查。
+3. 你审查普通的 Git diff：代码，以及任何事实文档变更。
+
+用户主动发起的代理请求刻意保持很少：
+
+* `/truthmark-document` - 根据代码和测试记录已有实现行为。
+* `/truthmark-realize` - 根据已有事实文档实现代码。
+* `/truthmark-check` - 审计仓库事实。
+
+Truth Sync 不是通常的开工方式；它是功能代码变更后的收尾审查。
+Truth Structure 不是日常命令；只有当路由或所有权阻塞工作时，它才进行修复。
+
+## 你会得到什么
+
+| 能力 | 作用 |
+| --- | --- |
+| Git 原生事实 | 将仓库事实保存在已提交的 Markdown 和配置中。 |
+| 按分支生效的文档 | 事实随分支移动，而不是存在于私有会话中。 |
+| 人类 CLI | 为维护者提供设置、刷新、验证和检查命令。 |
+| 已安装的代理指引 | 告诉编码代理何时记录文档、测试、同步事实、审计或停下来等待审查。 |
+| 显式路由 | 将代码区域映射到规范事实文档。 |
+| 可审查交接 | 为代码和事实文档都产生普通 Git diff。 |
+| 本地优先运行 | 不需要托管服务、守护进程、数据库或 MCP 服务器。 |
+| 更安全的写入边界 | 区分代码优先、文档优先、只读和仅文档工作流。 |
+| 验证 | 报告路由、权限、frontmatter、链接、生成界面、分支范围、新鲜度和覆盖率问题。 |
+| 可选 Portal | 在明确启用并请求时，从 Markdown 事实文档生成已提交的静态 HTML 展示站点。 |
+
+## 视觉概览
+
+![Truthmark 功能](../assets/truthmark-features.png)
+
+**功能：** Truthmark 会安装什么，以及代理如何使用仓库本地指令。
+
+![Truthmark 定位](../assets/truthmark-position.png)
+
+**定位：** Truthmark 相对于提示、记忆和规格工作流的位置。
+
+![Truthmark 同步流程](../assets/truthmark-syncflow.png)
+
+**同步流程：** Truth Sync 如何在交接前收尾普通代码变更。
+
+## 团队为什么采用它
+
+Truthmark 面向已经知道 AI 代理能够生成代码的团队。
+
+下一个问题是治理。
+
+不是作为仪式的治理。治理只是一个简单问题：
+
+> 在这次 AI 辅助变更之后，仓库仍然讲述事实吗？
+
+Truthmark 通过已提交文件、显式路由和可审查 diff 帮助团队回答这个问题。
+
+当你需要以下内容时，它很有用：
+
+- 减少文档漂移
+- 更好的交接
+- 按分支生效的产品事实
+- 持久的架构和 API 文档
+- 文档和代码之间的明确所有权
+- 更安全的代理写入边界
+- 可审查的文档，而不是隐藏记忆
+- 仍然能从已提交仓库文件运行的 AI 工作流
+
+## Truthmark 的位置
+
+Truthmark 不替代提示、记忆、规格、测试或代码审查。
+
+它为这些工作流提供一个可以持久落在 Git 中的位置。
+
+| 需求 | 更合适的选择 |
+| --- | --- |
+| 从单次代理会话获得更好输出 | 更好的提示 |
+| 个人或会话级连续性 | 记忆工具 |
+| 先计划后实现的功能工作 | 规格工作流 |
+| 随代码一起移动的按分支事实 | Truthmark |
+| 验证行为正确性 | 测试和审查 |
+| 审查 AI 辅助的文档变更 | Truthmark 加 Git 审查 |
+
+Truthmark 的边界有意很窄：
+
+```text
+make repository truth explicit
+route it to code
+围绕它安装代理指引
+keep the result reviewable in Git
+```
+
+## 深入了解
+
+README 是门面：快速背景、快速开始和核心心智模型。
+
+如需逐条命令的用法、界面对比、受支持平台详情、配置、路由、Portal 和示例，请阅读 [Truthmark 用户指南](../user-guide.md)。
+
+## 项目状态
+
+当前版本提供：
+
+- 用于 config、init、check、index、impact 和 workflow status 的本地 CLI 命令
+- 为 Codex、Claude Code、GitHub Copilot、OpenCode、Antigravity 和 Cursor 生成的仓库本地代理指令
+- 路由、权限、frontmatter、链接、新鲜度、生成界面、分支范围和覆盖率诊断
+- 按分支生效的事实文档和派生的仓库智能产物
+
+## 文档
+
+- [用户指南](../user-guide.md)
+- [文档索引](../README.md)
+- [架构概览](../truthmark/engineering/architecture/overview.md)
+- [API 和 CLI 契约](../truthmark/engineering/contracts/config-route-and-check-contracts.md)
+- [仓库事实维护指南](../standards/maintaining-repository-truth.md)
+
+有关本地开发和贡献命令，请参阅 [CONTRIBUTING.md](../../CONTRIBUTING.md)。
+
+## 设计边界
+
+Truthmark 有意保持小而明确：本地、已提交、按分支生效、可审查。
+
+它不是托管服务、MCP 服务器、向量数据库、隐藏记忆层、CI 强制执行产品，也不是自主代码重写引擎。它帮助仓库事实保持可见；它不替代测试、代码审查或人类判断。
+
+## 许可证
+
+MIT。见 [LICENSE](../../LICENSE)。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "truthmark",
-  "version": "2.2.2",
+  "version": "2.2.5",
   "description": "Git-native, branch-scoped truth workflow installer for local AI coding agents.",
   "license": "MIT",
   "type": "module",
@@ -24,10 +24,27 @@
     "truthmark": "dist/main.js"
   },
   "files": [
-    "dist"
+    "dist",
+    "README.md",
+    "docs/readmes/README.ar.md",
+    "docs/readmes/README.de.md",
+    "docs/readmes/README.el.md",
+    "docs/readmes/README.es.md",
+    "docs/readmes/README.fr.md",
+    "docs/readmes/README.id.md",
+    "docs/readmes/README.it.md",
+    "docs/readmes/README.ja.md",
+    "docs/readmes/README.ko.md",
+    "docs/README.md",
+    "docs/readmes/README.pl.md",
+    "docs/readmes/README.pt.md",
+    "docs/readmes/README.ru.md",
+    "docs/readmes/README.tr.md",
+    "docs/readmes/README.vi.md",
+    "docs/readmes/README.zh.md"
   ],
   "engines": {
-    "node": ">=20"
+    "node": ">=24"
   },
   "scripts": {
     "build": "tsup",