docs(codex): align Codex caveats with v1.87.0 auto-discovery behavior

[Pheobe-Southwood]

Motivation

The Codex caveats section in README.md still claims:

The Codex CLI ... does not emit a session transcript file the way Cursor / Claude Code / opencode do. That means evolver --review cannot read raw session logs on Codex.

This is factually incorrect and was already addressed in v1.87.0 (2026-05-26). The issue was raised in #540 and closed by the maintainer (@autogame-17), but the README was never updated to reflect the fix. The maintainer themselves acknowledged in the issue thread that the previous README description over-promised (承诺面比实际宽).

What actually happened (per #540 closing comment):

• readCursorTranscripts() was enhanced to auto-discover transcripts under ~/.codex/sessions/ and ~/.claude/projects/ without requiring manual EVOLVER_CURSOR_TRANSCRIPTS_DIR export.
• readMemoryGraphAnyTail() was added as a tier-2 fallback for memory_graph.jsonl.

Changes

README.md (Codex caveats section)

• Fixed factual error: Replaced "does not emit a session transcript file" with the accurate statement that Codex writes transcripts to ~/.codex/sessions/*.jsonl, but the Stop hook payload does not include transcript_path.
• Documented v1.87.0 auto-discovery: Added that Evolver auto-discovers transcripts under ~/.codex/sessions/ (and ~/.claude/projects/ for Claude Code) without manual EVOLVER_CURSOR_TRANSCRIPTS_DIR export.
• Adjusted wording: Changed "Evolver compensates by reading" to "For additional context, Evolver reads" (transcript discovery is no longer a gap to compensate for, but a working source of session logs).
• Preserved: lifecycle integration note, 3-layer memory fallback, advisory signals description.

README.zh-CN.md (platform integration section)

• Added missing Codex platform section: The zh-CN README previously listed only Cursor / Claude Code / OpenClaw — Codex was entirely missing. Added the setup-hooks --platform=codex command, description, and a translated Codex 注意事项 subsection with the same content as the English caveats.

Verification

• git diff reviewed: 2 files changed, 29 insertions(+), 4 deletions(-)
• No code changes (docs-only PR); node index.js self-check skipped (no node_modules in fresh clone)

References

• Refs: README 声称支持 Codex，但当前适配只接了 hooks，没有打通 review 依赖的上下文输入 #540
• v1.87.0 release: https://github.com/EvoMap/evolver/releases/tag/v1.87.0
• Maintainer closing comment in README 声称支持 Codex，但当前适配只接了 hooks，没有打通 review 依赖的上下文输入 #540: README 声称支持 Codex，但当前适配只接了 hooks，没有打通 review 依赖的上下文输入 #540 (comment)

---

Note

Low Risk
Documentation-only changes with no runtime or configuration behavior modified.

Overview
English README: The Codex caveats section no longer claims Codex lacks session transcripts or that evolver --review cannot read Codex logs. It now states that transcripts live under ~/.codex/sessions/*.jsonl, that the Stop hook omits transcript_path, and that since v1.87.0 Evolver auto-discovers those paths (and ~/.claude/projects/ for Claude Code) without EVOLVER_CURSOR_TRANSCRIPTS_DIR. The memory fallback list is reframed from “compensates” to “For additional context, Evolver reads”; proxy/lifecycle notes are unchanged.

Chinese README: Adds a full Codex platform block (setup command, proxy note, caveats, memory fallback, advisory signals) that was missing from README.zh-CN.md, aligned with the updated English text.

^{Reviewed by Cursor Bugbot for commit b1d1044. Bugbot is set up for automated code reviews on this repo. Configure here.}

[autogame-17]

Thanks @Pheobe-Southwood — this is a good catch and we accepted it.

I ported the change into the private source repo and synced the public README updates to main in 8ffa889e.

For the contribution reward, please leave your EvoMap account and contact email here, and we will add 200 credits to your account.

Thanks again for keeping the Codex docs accurate.

[owen-agent-control]

👋 这个 PR 开着 7 天没动了,还在推进吗?如果和 main 有冲突就 rebase 一下解掉,需要帮忙说一声;若已不需要也可以直接关掉 🙏

[owen-agent-control]

👋 这个 PR 开着 7 天没动了,还在推进吗?如果和 main 有冲突就 rebase 一下解掉,需要帮忙说一声;若已不需要也可以直接关掉 🙏

[owen-agent-control]

👋 这个 PR 开着 7 天没动了,还在推进吗?如果和 main 有冲突就 rebase 一下解掉,需要帮忙说一声;若已不需要也可以直接关掉 🙏

[owen-agent-control]

👋 这个 PR 开着 7 天没动了,还在推进吗?如果和 main 有冲突就 rebase 一下解掉,需要帮忙说一声;若已不需要也可以直接关掉 🙏

[owen-agent-control]

👋 这个 PR 开着 9 天没动了,还在推进吗?如果和 main 有冲突就 rebase 一下解掉,需要帮忙说一声;若已不需要也可以直接关掉 🙏

[evomap-aiqa-bot]

Sentinel 已审核此变更，未发现需要报告的问题。

GitHub CI 未通过。 此状态来自当前 CI gate，不是 Sentinel finding；请以最新 CI attempt 的日志为准。

开发 agent 查询详情： 调用 MCP 工具 sentinel_pr_review_context，传入 owner_repo="evomap/evolver"、pr_number=601、head_sha="b1d104401a89d8538c5889d9c01ff4000e6af48c"，并按条目追加 finding_id 或 finding_key。

由 Sentinel 审核 · 目标提交 b1d104401a89