oh-my-codex 0.11.12 → 0.11.13

package/Cargo.lock

@@ -32,11 +32,11 @@ checksum = "f8ca58f447f06ed17d5fc4043ce1b10dd205e060fb3ce5b979b8ed8e59ff3f79"
 
 [[package]]
 name = "omx-explore-harness"
-version = "0.11.12"
+version = "0.11.13"
 
 [[package]]
 name = "omx-mux"
-version = "0.11.12"
+version = "0.11.13"
 dependencies = [
  "serde",
  "serde_json",
@@ -44,7 +44,7 @@ dependencies = [
 
 [[package]]
 name = "omx-runtime"
-version = "0.11.12"
+version = "0.11.13"
 dependencies = [
  "omx-mux",
  "omx-runtime-core",
@@ -53,7 +53,7 @@ dependencies = [
 
 [[package]]
 name = "omx-runtime-core"
-version = "0.11.12"
+version = "0.11.13"
 dependencies = [
  "fs2",
  "serde",
@@ -62,7 +62,7 @@ dependencies = [
 
 [[package]]
 name = "omx-sparkshell"
-version = "0.11.12"
+version = "0.11.13"
 dependencies = [
  "omx-mux",
 ]

package/Cargo.toml

@@ -10,7 +10,7 @@ resolver = "2"
 
 [workspace.package]
 
-version = "0.11.12"
+version = "0.11.13"
 
 edition = "2021"
 license = "MIT"

package/README.md

@@ -22,6 +22,29 @@ It keeps Codex as the execution engine and makes it easier to:
 - invoke the canonical skills with `$deep-interview`, `$ralplan`, `$team`, and `$ralph`
 - keep project guidance, plans, logs, and state in `.omx/`
 
+## Core Maintainers
+
+| Role | Name | GitHub |
+| --- | --- | --- |
+| Creator & Lead | Yeachan Heo | [@Yeachan-Heo](https://github.com/Yeachan-Heo) |
+| Maintainer | HaD0Yun | [@HaD0Yun](https://github.com/HaD0Yun) |
+
+## Ambassadors
+
+| Name | GitHub |
+| --- | --- |
+| Sigrid Jin | [@sigridjineth](https://github.com/sigridjineth) |
+
+## Top Collaborators
+
+| Name | GitHub |
+| --- | --- |
+| HaD0Yun | [@HaD0Yun](https://github.com/HaD0Yun) |
+| Junho Yeo | [@junhoyeo](https://github.com/junhoyeo) |
+| JiHongKim98 | [@JiHongKim98](https://github.com/JiHongKim98) |
+| Lor | — |
+| HyunjunJeon | [@HyunjunJeon](https://github.com/HyunjunJeon) |
+
 ## Recommended default flow
 
 If you want the default OMX experience, start here:

package/README.vi.md

@@ -3,7 +3,7 @@
 <p align="center">
   <img src="https://yeachan-heo.github.io/oh-my-codex-website/omx-character-nobg.png" alt="oh-my-codex character" width="280">
   <br>
-  <em>Codex của bạn không đơn độc.</em>
+  <em>Dùng Codex hiệu quả hơn — OMX lo phần prompt, workflow và runtime khi dự án phức tạp dần.</em>
 </p>
 
 [![npm version](https://img.shields.io/npm/v/oh-my-codex)](https://www.npmjs.com/package/oh-my-codex)
@@ -11,253 +11,212 @@
 [![Node.js](https://img.shields.io/badge/node-%3E%3D20-brightgreen)](https://nodejs.org)
 [![Discord](https://img.shields.io/discord/1452487457085063218?color=5865F2&logo=discord&logoColor=white&label=Discord)](https://discord.gg/PUwSMR9XNk)
 
-> **[Website](https://yeachan-heo.github.io/oh-my-codex-website/)** | **[Documentation](https://yeachan-heo.github.io/oh-my-codex-website/docs.html)** | **[CLI Reference](https://yeachan-heo.github.io/oh-my-codex-website/docs.html#cli-reference)** | **[Workflows](https://yeachan-heo.github.io/oh-my-codex-website/docs.html#workflows)** | **[Hướng dẫn tích hợp OpenClaw](./docs/openclaw-integration.vi.md)** | **[GitHub](https://github.com/Yeachan-Heo/oh-my-codex)** | **[npm](https://www.npmjs.com/package/oh-my-codex)**
+**Website:** https://yeachan-heo.github.io/oh-my-codex-website/
+**Tài liệu:** [Bắt đầu](./docs/getting-started.html) · [Agent](./docs/agents.html) · [Skill](./docs/skills.html) · [Tích hợp](./docs/integrations.html) · [Demo](./DEMO.md) · [Hướng dẫn OpenClaw](./docs/openclaw-integration.md)
 
-Lớp điều phối đa tác nhân cho [OpenAI Codex CLI](https://github.com/openai/codex).
+OMX là lớp workflow mở rộng cho [OpenAI Codex CLI](https://github.com/openai/codex).
 
-## Điểm mới trong v0.9.0 — Spark Initiative
+Codex vẫn là engine chính, OMX giúp bạn:
+- cấu hình Codex tốt hơn ngay từ phiên đầu tiên
+- chạy workflow nhất quán từ làm rõ yêu cầu đến hoàn thành
+- gọi các skill chính bằng `$deep-interview`, `$ralplan`, `$team` và `$ralph`
+- lưu trữ hướng dẫn dự án, kế hoạch, log và trạng thái trong `.omx/`
 
-Spark Initiative là bản phát hành tăng cường đường đi native cho khám phá và kiểm tra trong OMX.
+## Workflow mặc định
 
-- **Native harness cho `omx explore`** — chạy khám phá kho mã chỉ đọc nhanh hơn và chặt chẽ hơn bằng harness Rust.
-- **`omx sparkshell`** — bề mặt kiểm tra native cho operator, hỗ trợ tóm tắt đầu ra dài và chụp tmux pane.
-- **Tài sản phát hành native đa nền tảng** — đường hydration cho `omx-explore-harness`, `omx-sparkshell` và `native-release-manifest.json` nay đã nằm trong pipeline phát hành.
-- **CI/CD được tăng cường** — thêm thiết lập Rust toolchain tường minh cho `build` job cùng với `cargo fmt --check` và `cargo clippy -- -D warnings`.
+Nếu bạn muốn trải nghiệm OMX nhanh nhất, bắt đầu từ đây:
 
-Xem thêm tại [ghi chú phát hành v0.9.0](./docs/release-notes-0.9.0.md) và [release body](./docs/release-body-0.9.0.md).
-
-## Phiên đầu tiên
+```bash
+npm install -g @openai/codex oh-my-codex
+omx setup
+omx --madmax --high
+```
 
-Trong Codex:
+Sau đó làm việc bình thường trong Codex:
 
 ```text
-$deep-interview "clarify the auth change"
+$deep-interview "clarify the authentication change"
 $ralplan "approve the auth plan and review tradeoffs"
 $ralph "carry the approved plan to completion"
 $team 3:executor "execute the approved plan in parallel"
 ```
 
-Từ terminal:
+Đó là flow chính.
+Khởi động OMX, làm rõ yêu cầu khi cần, duyệt kế hoạch, rồi chọn `$team` để chạy song song hoặc `$ralph` để một agent lo đến khi xong.
 
-```bash
-omx team 4:executor "parallelize a multi-module refactor"
-omx team status <team-name>
-omx team shutdown <team-name>
-```
+## OMX dùng để làm gì
 
-## Quy trình được khuyến nghị
+Dùng OMX nếu bạn đã quen Codex và muốn trải nghiệm tốt hơn:
+- workflow chuẩn xoay quanh `$deep-interview`, `$ralplan`, `$team` và `$ralph`
+- các role chuyên biệt và skill hỗ trợ cho từng loại task
+- hướng dẫn dự án qua `AGENTS.md` theo scope
+- lưu trạng thái lâu dài trong `.omx/` — kế hoạch, log, memory và theo dõi mode
 
-1. `$deep-interview` — khi phạm vi hoặc ranh giới vẫn chưa rõ.
-2. `$ralplan` — để biến phạm vi đã làm rõ thành kế hoạch kiến trúc và triển khai đã được chốt.
-3. `$team` hoặc `$ralph` — dùng `$team` cho thực thi song song có phối hợp, hoặc `$ralph` cho vòng lặp bền bỉ để hoàn tất/xác minh với một chủ sở hữu duy nhất.
+Nếu bạn chỉ muốn dùng Codex thuần mà không cần thêm workflow, thì có lẽ không cần OMX.
 
-## Mô hình cốt lõi
+## Bắt đầu nhanh
 
-OMX cài đặt và kết nối các lớp sau:
+### Yêu cầu
 
-```text
-User
-  -> Codex CLI
-    -> AGENTS.md (bộ não điều phối)
-    -> ~/.codex/prompts/*.md (danh mục prompt tác nhân)
-    -> ~/.codex/skills/*/SKILL.md (danh mục skill)
-    -> ~/.codex/config.toml (tính năng, thông báo, MCP)
-    -> .omx/ (trạng thái runtime, bộ nhớ, kế hoạch, nhật ký)
-```
+- Node.js 20+
+- Codex CLI đã cài: `npm install -g @openai/codex`
+- Codex đã xác thực (auth)
+- `tmux` trên macOS/Linux nếu muốn dùng team runtime
+- `psmux` trên Windows nếu muốn dùng team mode
+
+### Phiên đầu tiên
 
-## Các lệnh chính
+Khởi chạy OMX:
 
 ```bash
-omx                # Khởi chạy Codex (+ HUD trong tmux khi có sẵn)
-omx setup          # Cài đặt prompt/skill/config theo phạm vi + .omx của dự án + AGENTS.md theo phạm vi
-omx doctor         # Chẩn đoán cài đặt/runtime
-omx doctor --team  # Chẩn đoán Team/swarm
-omx team ...       # Khởi động/trạng thái/tiếp tục/tắt worker tmux của đội
-omx status         # Hiển thị các chế độ đang hoạt động
-omx cancel         # Hủy các chế độ thực thi đang hoạt động
-omx reasoning <mode> # low|medium|high|xhigh
-omx tmux-hook ...  # init|status|validate|test
-omx hooks ...      # init|status|validate|test (quy trình mở rộng plugin)
-omx hud ...        # --watch|--json|--preset
-omx help
+omx --madmax --high
 ```
 
-## Mở rộng Hooks (Bề mặt bổ sung)
+Rồi thử workflow chính:
 
-OMX hiện bao gồm `omx hooks` cho scaffolding và xác thực plugin.
-
-- `omx tmux-hook` vẫn được hỗ trợ và không thay đổi.
-- `omx hooks` là bổ sung và không thay thế quy trình tmux-hook.
-- Tệp plugin nằm tại `.omx/hooks/*.mjs`.
-- Plugin tắt theo mặc định; kích hoạt bằng `OMX_HOOK_PLUGINS=1`.
-
-Xem `docs/hooks-extension.md` cho quy trình mở rộng đầy đủ và mô hình sự kiện.
-
-## Cờ khởi chạy
-
-```bash
---yolo
---high
---xhigh
---madmax
---force
---dry-run
---verbose
---scope <user|project>  # chỉ dành cho setup
+```text
+$deep-interview "clarify the authentication change"
+$ralplan "approve the safest implementation path"
+$ralph "carry the approved plan to completion"
+$team 3:executor "execute the approved plan in parallel"
 ```
 
-`--madmax` ánh xạ đến Codex `--dangerously-bypass-approvals-and-sandbox`.
-Chỉ sử dụng trong môi trường sandbox tin cậy hoặc bên ngoài.
+Dùng `$team` khi cần nhiều worker chạy song song, hoặc `$ralph` khi muốn một agent lo từ đầu đến cuối.
 
-### Chính sách workingDirectory MCP (tăng cường tùy chọn)
+## Mô hình đơn giản
 
-Theo mặc định, các công cụ MCP state/memory/trace chấp nhận `workingDirectory` do người gọi cung cấp.
-Để hạn chế điều này, đặt danh sách gốc được phép:
+OMX **không** thay thế Codex.
 
-```bash
-export OMX_MCP_WORKDIR_ROOTS="/path/to/project:/path/to/another-root"
-```
+OMX bổ sung một lớp hỗ trợ phía trên Codex:
+- **Codex** vẫn làm toàn bộ việc thực thi
+- **Role của OMX** giúp gọi nhanh các vai trò chuyên biệt
+- **Skill của OMX** đóng gói các workflow phổ biến thành lệnh
+- **`.omx/`** lưu kế hoạch, log, memory và trạng thái runtime
 
-Khi được đặt, các giá trị `workingDirectory` ngoài các gốc này sẽ bị từ chối.
+Nói đơn giản: OMX giúp **phân task đúng chỗ + workflow rõ ràng + runtime ổn định hơn** — không phải một bảng điều khiển để gõ lệnh cả ngày.
 
-## Kiểm soát Prompt Codex-First
+## Hướng dẫn cho người mới
 
-Theo mặc định, OMX tiêm:
+1. Chạy `omx setup`
+2. Khởi động với `omx --madmax --high`
+3. Dùng `$deep-interview "..."` khi yêu cầu còn mơ hồ
+4. Dùng `$ralplan "..."` để duyệt kế hoạch và cân nhắc trade-off
+5. Chọn `$team` để chạy song song hoặc `$ralph` để một agent lo đến khi xong
 
-```text
--c model_instructions_file="<cwd>/AGENTS.md"
-```
-
-Điều này kết hợp `AGENTS.md` trong `CODEX_HOME` với `AGENTS.md` của dự án (nếu có), rồi thêm lớp phủ runtime.
-Mở rộng hành vi Codex, nhưng không thay thế/bỏ qua các chính sách hệ thống cốt lõi của Codex.
+## Workflow khuyến nghị
 
-Điều khiển:
+1. `$deep-interview` — làm rõ scope khi yêu cầu còn mơ hồ.
+2. `$ralplan` — chuyển scope đã rõ thành kế hoạch triển khai được duyệt.
+3. `$team` hoặc `$ralph` — dùng `$team` khi cần nhiều worker song song, hoặc `$ralph` khi muốn một agent chạy liên tục đến khi xong.
 
-```bash
-OMX_BYPASS_DEFAULT_SYSTEM_PROMPT=0 omx     # tắt tiêm AGENTS.md
-OMX_MODEL_INSTRUCTIONS_FILE=/path/to/instructions.md omx
-```
+## Các lệnh thường dùng trong phiên
 
-## Chế độ đội
+| Lệnh | Dùng khi |
+| --- | --- |
+| `$deep-interview "..."` | Làm rõ ý định, scope và non-goal |
+| `$ralplan "..."` | Duyệt kế hoạch triển khai và trade-off |
+| `$ralph "..."` | Chạy liên tục đến khi hoàn thành và verify |
+| `$team "..."` | Chạy song song khi task đủ lớn |
+| `/skills` | Xem danh sách skill và helper đã cài |
 
-Sử dụng chế độ đội cho công việc lớn được hưởng lợi từ worker song song.
+## Nâng cao
 
-Vòng đời:
+Các phần dưới đây hữu ích nhưng không phải là bước bắt đầu chính.
 
-```text
-start -> assign scoped lanes -> monitor -> verify terminal tasks -> shutdown
-```
+### Team runtime
 
-Các lệnh vận hành:
+Dùng team runtime khi cần phối hợp nhiều worker qua tmux/worktree — đây không phải bước bắt đầu mặc định.
 
 ```bash
-omx team <args>
+omx team 3:executor "fix the failing tests with verification"
 omx team status <team-name>
 omx team resume <team-name>
 omx team shutdown <team-name>
 ```
 
-Quy tắc quan trọng: không tắt khi các tác vụ vẫn đang ở trạng thái `in_progress` trừ khi đang hủy bỏ.
-
-### Team shutdown policy
+### Setup, doctor và HUD
 
-Use `omx team shutdown <team-name>` after the team reaches a terminal state.
-Team cleanup now follows one standalone path; legacy linked-Ralph shutdown handling is no longer a separate public workflow.
+Đây là các công cụ vận hành/hỗ trợ:
+- `omx setup` cài prompt, skill, config và scaffold AGENTS
+- `omx doctor` kiểm tra cài đặt khi có vấn đề
+- `omx hud --watch` theo dõi trạng thái, không phải workflow chính
 
-Chọn Worker CLI cho worker của đội:
+### Explore và sparkshell
 
-```bash
-OMX_TEAM_WORKER_CLI=auto    # mặc định; sử dụng claude khi worker --model chứa "claude"
-OMX_TEAM_WORKER_CLI=codex   # ép buộc worker Codex CLI
-OMX_TEAM_WORKER_CLI=claude  # ép buộc worker Claude CLI
-OMX_TEAM_WORKER_CLI_MAP=codex,codex,claude,claude  # hỗn hợp CLI theo worker (độ dài=1 hoặc số worker)
-OMX_TEAM_AUTO_INTERRUPT_RETRY=0  # tùy chọn: tắt fallback thích ứng queue->resend
-```
-
-Lưu ý:
-- Tham số khởi chạy worker vẫn được chia sẻ qua `OMX_TEAM_WORKER_LAUNCH_ARGS`.
-- `OMX_TEAM_WORKER_CLI_MAP` ghi đè `OMX_TEAM_WORKER_CLI` cho lựa chọn theo worker.
-- Gửi trigger sử dụng thử lại thích ứng theo mặc định (queue/submit, sau đó fallback an toàn clear-line+resend khi cần).
-- Trong chế độ Claude worker, OMX khởi chạy worker dưới dạng `claude` thuần túy (không có tham số khởi chạy thêm) và bỏ qua các ghi đè rõ ràng `--model` / `--config` / `--effort` để Claude sử dụng `settings.json` mặc định.
-
-## `omx setup` ghi những gì
-
-- `.omx/setup-scope.json` (phạm vi cài đặt được lưu trữ)
-- Cài đặt phụ thuộc phạm vi:
-  - `user`: `~/.codex/prompts/`, `~/.codex/skills/`, `~/.codex/config.toml`, `~/.omx/agents/`, `~/.codex/AGENTS.md`
-  - `project`: `./.codex/prompts/`, `./.codex/skills/`, `./.codex/config.toml`, `./.omx/agents/`, `./AGENTS.md`
-- Hành vi khởi chạy: nếu phạm vi được lưu trữ là `project`, khởi chạy `omx` tự động sử dụng `CODEX_HOME=./.codex` (trừ khi `CODEX_HOME` đã được đặt).
-- Hướng dẫn khởi chạy sẽ kết hợp `~/.codex/AGENTS.md` (hoặc `CODEX_HOME/AGENTS.md` nếu đã ghi đè) với `./AGENTS.md` của dự án, rồi thêm lớp phủ runtime.
-- Các tệp `AGENTS.md` hiện có sẽ không bao giờ bị ghi đè âm thầm: ở TTY tương tác, setup hỏi trước khi thay thế; ở chế độ không tương tác, việc thay thế sẽ bị bỏ qua trừ khi dùng `--force` (kiểm tra an toàn phiên hoạt động vẫn áp dụng).
-- Cập nhật `config.toml` (cho cả hai phạm vi):
-  - `notify = ["node", "..."]`
-  - `model_reasoning_effort = "high"`
-  - `developer_instructions = "..."`
-  - `[features] multi_agent = true, child_agents_md = true`
-  - Mục máy chủ MCP (`omx_state`, `omx_memory`, `omx_code_intel`, `omx_trace`)
-  - `[tui] status_line`
-- `AGENTS.md` theo phạm vi
-- Thư mục `.omx/` runtime và cấu hình HUD
-
-## Tác nhân và skill
-
-- Prompt: `prompts/*.md` (cài vào `~/.codex/prompts/` cho `user`, `./.codex/prompts/` cho `project`)
-- Skill: `skills/*/SKILL.md` (cài vào `~/.codex/skills/` cho `user`, `./.codex/skills/` cho `project`)
+- `omx explore --prompt "..."` tìm kiếm chỉ đọc trong repository
+- `omx sparkshell <command>` chạy lệnh shell có kiểm soát output
 
 Ví dụ:
-- Tác nhân: `architect`, `planner`, `executor`, `debugger`, `verifier`, `security-reviewer`
-- Skill: `deep-interview`, `ralplan`, `team`, `ralph`, `plan`, `cancel`
-
-## Cấu trúc dự án
 
-```text
-oh-my-codex/
-  bin/omx.js
-  src/
-    cli/
-    team/
-    mcp/
-    hooks/
-    hud/
-    config/
-    modes/
-    notifications/
-    verification/
-  prompts/
-  skills/
-  templates/
-  scripts/
+```bash
+omx explore --prompt "find where team state is written"
+omx sparkshell git status
+omx sparkshell --tmux-pane %12 --tail-lines 400
 ```
 
-## Phát triển
+### Cài tmux theo nền tảng
 
-```bash
-git clone https://github.com/Yeachan-Heo/oh-my-codex.git
-cd oh-my-codex
-npm install
-npm run build
-npm test
-```
+`omx team` cần backend tương thích tmux:
 
-## Tài liệu
+| Nền tảng | Cài đặt |
+| --- | --- |
+| macOS | `brew install tmux` |
+| Ubuntu/Debian | `sudo apt install tmux` |
+| Fedora | `sudo dnf install tmux` |
+| Arch | `sudo pacman -S tmux` |
+| Windows | `winget install psmux` |
+| Windows (WSL2) | `sudo apt install tmux` |
 
-- **[Tài liệu đầy đủ](https://yeachan-heo.github.io/oh-my-codex-website/docs.html)** — Hướng dẫn hoàn chỉnh
-- **[Tham chiếu CLI](https://yeachan-heo.github.io/oh-my-codex-website/docs.html#cli-reference)** — Tất cả lệnh `omx`, cờ và công cụ
-- **[Hướng dẫn thông báo](https://yeachan-heo.github.io/oh-my-codex-website/docs.html#notifications)** — Cài đặt Discord, Telegram, Slack và webhook
-- **[Quy trình công việc khuyến nghị](https://yeachan-heo.github.io/oh-my-codex-website/docs.html#workflows)** — Chuỗi skill đã thử nghiệm thực chiến cho các tác vụ phổ biến
-- **[Ghi chú phát hành](https://yeachan-heo.github.io/oh-my-codex-website/docs.html#release-notes)** — Tính năng mới trong mỗi phiên bản
+## Vấn đề đã biết
 
-## Ghi chú
+### Intel Mac: CPU `syspolicyd` / `trustd` cao khi khởi động
 
-- Nhật ký thay đổi đầy đủ: `CHANGELOG.md`
-- Hướng dẫn di chuyển (sau v0.4.4 mainline): `docs/migration-mainline-post-v0.4.4.md`
-- Ghi chú về độ bao phủ và tương đương: `COVERAGE.md`
-- Quy trình mở rộng hook: `docs/hooks-extension.md`
-- Chi tiết cài đặt và đóng góp: `CONTRIBUTING.md`
+Trên một số máy Intel Mac, khi khởi động OMX — đặc biệt với `--madmax --high` — CPU có thể tăng đột biến do macOS Gatekeeper xác thực nhiều tiến trình đồng thời.
 
-## Lời cảm ơn
+Nếu gặp tình trạng này, thử:
+- `xattr -dr com.apple.quarantine $(which omx)`
+- Thêm ứng dụng terminal vào danh sách Developer Tools trong cài đặt Security của macOS
+- Dùng cấu hình nhẹ hơn (bỏ `--madmax --high`)
+
+## Tài liệu
 
-Lấy cảm hứng từ [oh-my-claudecode](https://github.com/Yeachan-Heo/oh-my-claudecode), được điều chỉnh cho Codex CLI.
+- [Bắt đầu](./docs/getting-started.html)
+- [Hướng dẫn demo](./DEMO.md)
+- [Danh mục agent](./docs/agents.html)
+- [Tham chiếu skill](./docs/skills.html)
+- [Tích hợp](./docs/integrations.html)
+- [Hướng dẫn OpenClaw / notification gateway](./docs/openclaw-integration.md)
+- [Đóng góp](./CONTRIBUTING.md)
+- [Nhật ký thay đổi](./CHANGELOG.md)
+
+## Ngôn ngữ
+
+- [English](./README.md)
+- [한국어](./README.ko.md)
+- [日本語](./README.ja.md)
+- [简体中文](./README.zh.md)
+- [繁體中文](./README.zh-TW.md)
+- [Tiếng Việt](./README.vi.md)
+- [Español](./README.es.md)
+- [Português](./README.pt.md)
+- [Русский](./README.ru.md)
+- [Türkçe](./README.tr.md)
+- [Deutsch](./README.de.md)
+- [Français](./README.fr.md)
+- [Italiano](./README.it.md)
+- [Ελληνικά](./README.el.md)
+- [Polski](./README.pl.md)
+
+## Đóng góp
+
+| Vai trò | Tên | GitHub |
+| --- | --- | --- |
+| Tác giả & Lead | Yeachan Heo | [@Yeachan-Heo](https://github.com/Yeachan-Heo) |
+| Maintainer | HaD0Yun | [@HaD0Yun](https://github.com/HaD0Yun) |
+
+## Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=Yeachan-Heo/oh-my-codex&type=date&legend=top-left)](https://www.star-history.com/#Yeachan-Heo/oh-my-codex&type=date&legend=top-left)
 
 ## Giấy phép
 

package/crates/omx-runtime-core/src/engine.rs

@@ -173,6 +173,7 @@ impl RuntimeEngine {
                     message_id,
                     from_worker,
                     to_worker,
+                    body: Some(body),
                 }
             }
             RuntimeCommand::MarkMailboxNotified { message_id } => {
@@ -293,7 +294,10 @@ impl RuntimeEngine {
         lock_file.lock_shared()?;
 
         let events_json = std::fs::read_to_string(dir.join("events.json"))?;
-        let events: Vec<RuntimeEvent> = serde_json::from_str(&events_json)?;
+        let mut events: Vec<RuntimeEvent> = serde_json::from_str(&events_json)?;
+        let mailbox = std::fs::read_to_string(dir.join("mailbox.json"))
+            .ok()
+            .and_then(|mailbox_json| serde_json::from_str::<MailboxLog>(&mailbox_json).ok());
 
         drop(lock_file);
 
@@ -302,6 +306,32 @@ impl RuntimeEngine {
         for event in &events {
             replay_event(&mut engine, event);
         }
+
+        if let Some(mailbox_state) = mailbox {
+            let body_by_message_id: std::collections::HashMap<&str, &str> = mailbox_state
+                .records()
+                .iter()
+                .map(|record| (record.message_id.as_str(), record.body.as_str()))
+                .collect();
+
+            for event in &mut events {
+                if let RuntimeEvent::MailboxMessageCreated {
+                    message_id, body, ..
+                } = event
+                {
+                    if body.is_none() {
+                        if let Some(record_body) = body_by_message_id.get(message_id.as_str()) {
+                            if !record_body.is_empty() {
+                                *body = Some((*record_body).to_string());
+                            }
+                        }
+                    }
+                }
+            }
+
+            engine.mailbox = mailbox_state;
+        }
+
         engine.event_log = events;
 
         Ok(engine)
@@ -357,10 +387,14 @@ fn replay_event(engine: &mut RuntimeEngine, event: &RuntimeEvent) {
             message_id,
             from_worker,
             to_worker,
+            body,
         } => {
-            engine
-                .mailbox
-                .create(message_id, from_worker, to_worker, "");
+            engine.mailbox.create(
+                message_id,
+                from_worker,
+                to_worker,
+                body.as_deref().unwrap_or(""),
+            );
         }
         RuntimeEvent::MailboxNotified { message_id } => {
             let _ = engine.mailbox.mark_notified(message_id);
@@ -515,6 +549,90 @@ mod tests {
         let _ = std::fs::remove_dir_all(&dir);
     }
 
+    #[test]
+    fn persist_and_load_round_trip_preserves_mailbox_body() {
+        let dir = std::env::temp_dir().join("omx-runtime-test-mailbox-body");
+        let _ = std::fs::remove_dir_all(&dir);
+
+        let mut engine = RuntimeEngine::new().with_state_dir(&dir);
+        engine
+            .process(RuntimeCommand::CreateMailboxMessage {
+                message_id: "msg-1".into(),
+                from_worker: "worker-1".into(),
+                to_worker: "leader-fixed".into(),
+                body: "ACK: worker-1 initialized".into(),
+            })
+            .unwrap();
+        engine.persist().unwrap();
+
+        let loaded = RuntimeEngine::load(&dir).unwrap();
+        loaded.write_compatibility_view().unwrap();
+
+        let mailbox_json = std::fs::read_to_string(dir.join("mailbox.json")).unwrap();
+        let mailbox: serde_json::Value = serde_json::from_str(&mailbox_json).unwrap();
+        assert_eq!(
+            mailbox["records"][0]["body"],
+            serde_json::Value::String("ACK: worker-1 initialized".into())
+        );
+
+        let _ = std::fs::remove_dir_all(&dir);
+    }
+
+    #[test]
+    fn load_backfills_legacy_mailbox_event_body_from_mailbox_json() {
+        let dir = std::env::temp_dir().join("omx-runtime-test-mailbox-backfill");
+        let _ = std::fs::remove_dir_all(&dir);
+        std::fs::create_dir_all(&dir).unwrap();
+
+        std::fs::write(
+            dir.join("events.json"),
+            serde_json::to_string_pretty(&vec![RuntimeEvent::MailboxMessageCreated {
+                message_id: "msg-legacy".into(),
+                from_worker: "worker-1".into(),
+                to_worker: "leader-fixed".into(),
+                body: None,
+            }])
+            .unwrap(),
+        )
+        .unwrap();
+        std::fs::write(
+            dir.join("mailbox.json"),
+            serde_json::to_string_pretty(&serde_json::json!({
+                "records": [{
+                    "message_id": "msg-legacy",
+                    "from_worker": "worker-1",
+                    "to_worker": "leader-fixed",
+                    "body": "recovered body",
+                    "created_at": "2026-04-04T00:00:00.000Z",
+                    "notified_at": null,
+                    "delivered_at": null
+                }]
+            }))
+            .unwrap(),
+        )
+        .unwrap();
+        std::fs::write(dir.join("engine.lock"), "").unwrap();
+
+        let loaded = RuntimeEngine::load(&dir).unwrap();
+        loaded.persist().unwrap();
+
+        let events_json = std::fs::read_to_string(dir.join("events.json")).unwrap();
+        let persisted_events: Vec<RuntimeEvent> = serde_json::from_str(&events_json).unwrap();
+        assert!(matches!(
+            &persisted_events[0],
+            RuntimeEvent::MailboxMessageCreated { body: Some(body), .. } if body == "recovered body"
+        ));
+
+        let mailbox_json = std::fs::read_to_string(dir.join("mailbox.json")).unwrap();
+        let mailbox: serde_json::Value = serde_json::from_str(&mailbox_json).unwrap();
+        assert_eq!(
+            mailbox["records"][0]["body"],
+            serde_json::Value::String("recovered body".into())
+        );
+
+        let _ = std::fs::remove_dir_all(&dir);
+    }
+
     #[test]
     fn derive_readiness_stale_authority() {
         let mut authority = AuthorityLease::new();