v0.21.42～v0.21.43：唯讀狀態檢查與 Goal 調解 · Oh My Codex (OMX)

概述

OMX 在同一天連發兩個 patch release：v0.21.42（2026-10-30 06:48 UTC）與 v0.21.43（2026-10-30 11:36 UTC）。官方定位：v0.21.42「a patch release that makes Team and tmux status inspection read-only and improves native Codex goal reconciliation」；v0.21.43「a small patch release that corrects native process identity recovery guidance in omx doctor」。兩版官方皆明言無 breaking API changes。

v0.21.42：唯讀的 Team 與 tmux 狀態檢查（#3963）

「檢查」與「維護」分離——status 指令不再有副作用：

omx team status 變成純觀測：不再執行 monitor maintenance、不再寫入 state、不再恢復 (recover) claims——因此在 read-only OMX root 下，inspection 仍維持安全。
省略 team 名稱的解析規則：只從唯一的 current-leader 匹配解析——沒有唯一匹配就不猜。
omx tmux-hook status 不再初始化設定：只回報缺少的設定 (missing configuration)，不順手把它建出來。

v0.21.42：native goal 調解（#3964）

正規化 native Codex 的 goal 回應，並誠實面對「驗證不了」：

回應正規化：normalize structured 與 serialized 兩種 get_goal response envelopes。
錯誤分類：區分「native goal tool 缺失」與 database／schema／context 錯誤——工具不存在不是資料庫故障。
如實回報：verification 無法使用時，允許如實 (truthful) 的 non-terminal blocked checkpoints，不虛構 goal completion。

v0.21.42：history 竄改偵測（#3959）

即使 writer 還原了檔案的 size 與 modification time，仍能偵測 same-inode history 檔案的內容變更；被竄改的 history artifact 不會被發布。另穩定 detached-launch 與 Windows 平台的 test fixtures，含 per-fixture sidecar 隔離（#3963）。

v0.21.43：doctor 修復指引修正（#3971）

小修補，但對診斷文字的正確性很重要：

當 native process identity provider 不支援或無法使用時，omx doctor 改建議 omx update 以 hydrate release-asset runtime cache；指引保留「session pointer recovery 不需要 native runtime 也能運作」的說明。
從 Process identity 的 cache-repair hint 移除 omx setup——setup 並不會修復 native runtime cache；其他 failure cases 維持既有的 reinstall／update 指引。
官方明言：本版只修正 remediation 文字，不宣稱修復 #3968 回報的底層 provider failure（該回報仍未證實，evidence was requested）。

已知問題與排除項

#3898（live-pin 修復）兩版皆維持 held for the owner design decision；相關 PR #3939、#3900、#3907、#3915、#3919 續遭排除。
#3965 不含於兩版——changes requested，工作拆分待處理。
#3968（回報者 Kevin-wenyu）的 provider-unavailable 回報仍未證實。

既有使用者影響

omx team status／omx tmux-hook status 的輸出語意不變，但不再有副作用；在 read-only OMX root 下執行檢查是安全的。若曾有腳本依賴 status 順帶觸發的維護行為，該效果已不存在。
native goal 驗證：verification 無法使用時會看到如實的 non-terminal blocked checkpoints，而不是虛構的完成狀態。
omx doctor 的 Process identity 修復建議改指 omx update；cache-repair hint 不再建議 omx setup。
無 breaking API changes；套件與 plugin metadata 已由前置 PR（#3962／#3970）同步至對應版本，release 本身不重複 bump。

隨堂測驗

v0.21.42 之後，在 read-only OMX root 下執行 omx team status 為什麼是安全的？

💡 想先看個提示？

關鍵是 status 指令變成無副作用。

動手升級檢查清單

升級 v0.21.43：動手檢查清單

逐項勾選，確認你已完成升級必要的步驟（進度會保存在此瀏覽器）

0 / 5

（read-only OMX root 環境）確認 omx team status 可安全執行v0.21.42 #3963：status 不再寫 state、不做維護、不恢復 claims
（省略 team 名稱叫用 status）確認只從唯一 current-leader 匹配解析v0.21.42 #3963：An omitted team name resolves only from a unique current-leader match
（檢查 tmux-hook）確認 status 只回報缺設定、不初始化v0.21.42 #3963：omx tmux-hook status reports missing configuration without initializing it
（native goal 驗證）確認 blocked checkpoints 如實呈現v0.21.42 #3964：verification 無法使用時回報 non-terminal blocked，不虛構 completion
（看 doctor 的 Process identity 建議）確認改指 omx update 而非 omx setupv0.21.43 #3971：setup 不修復 native runtime cache