README 声称支持 Codex，但当前适配只接了 hooks，没有打通 review 依赖的上下文输入

[rendigua]

问题概述

当前 README 把 Codex 列为支持平台，并提供：

evolver setup-hooks --platform=codex

但从实际行为看，当前 Codex 适配更像是“只接了 hook”，没有把 evolver --review 真正依赖的上下文输入一起打通。

在正常按官方方式安装并运行后，evolver --review 会持续出现：

• memory_missing
• user_missing
• session_logs_missing

这说明当前 Codex 适配下，review 逻辑期待的主要输入并没有被稳定提供。

环境

• OS: Windows
• Host: Codex
• package: @evomap/evolver@1.84.1
• node: v22.15.0
• npm: 11.6.2
• git: 2.53.0.windows.2

复现方式

1. 按官方方式全局安装：

npm install -g @evomap/evolver

2. 按官方方式接入 Codex：

evolver setup-hooks --platform=codex

3. 在普通 git 项目里运行：

evolver --review

实际行为

evolver --review 虽然可以读取当前 repo diff，但很容易先回到：

• memory_missing
• user_missing
• session_logs_missing

从源码行为看，review 逻辑会期待这些输入：

• repo 根目录下的 MEMORY.md
• repo 根目录下的 USER.md
• 可识别的 session logs / .jsonl

但当前 Codex 适配器主要只做了这些：

• 写 .codex/hooks.json
• 写 .codex/config.toml
• 拷贝 hook 脚本
• 注入 AGENTS.md

没有看到它负责：

• 生成 repo-local MEMORY.md
• 生成 repo-local USER.md
• 让 Codex 会话自动产出或接入 review 需要的 session logs

为什么这很重要

这不是一个小提示问题，而是影响 Codex 支持是否完整的问题：

• 如果这些输入只是次要输入，那缺失不应长期主导 review 输出
• 如果这些输入是主要输入，那当前 Codex 适配就不是完整支持，而更像只完成了 hook 接线

当前判断

目前看，Codex 这条线更像：

• hook 层已接入
• 但 review / context 数据面没有打通

也就是说，当前“支持 Codex”的表述容易让人理解成“可以像其他宿主一样直接正常工作”，但实际情况更像是：

• Codex adapter 可以安装
• 但 review 所依赖的主要上下文输入并没有被一起解决

期望行为

希望官方至少明确其中一种：

1. 真正补齐 Codex 适配

   • 明确 repo-local MEMORY.md / USER.md / session logs 应该如何产生
   • 或由 adapter 帮助接通这些输入

2. 更新 README / 文档表述

   • 明确说明当前 Codex 支持的边界
   • 不要让人误以为 setup-hooks --platform=codex 已经等于完整可用的 Codex review 体验

和已有 issue 的区别

这个问题不同于我们已提交的：

• #536 local memory path / recorded to nowhere
• #537 Windows path noise
• #538 uninstall 不干净
• #539 hook 覆盖风险

这条 issue 针对的是：

当前 Codex 适配在“review 依赖的主要上下文输入”这一层并没有真正打通。

[autogame-17]

部分修复 — 随 v1.84.2 发出（commit f32f709），但 Codex 端剩一个平台层限制需要单独说明。

已修的部分：

review engine 之前硬依赖 repo-local 的 MEMORY.md / USER.md，文件不在或为空就拿不到上下文。现在按以下顺序兜底：

1. 平台传入的 additionalContext / session_state（Claude Code / Cursor / Kiro / opencode 都有对应字段）；
2. evolver 自己维护的 memory_graph.jsonl（findMemoryGraph() 走 npm-global 友好的解析，再 fall back 到 ~/.evolver/memory/evolution/memory_graph.jsonl）；
3. 最后才回到 markdown 文件。

任何一层有数据就停住，不会再把 missing markdown 当成 fatal。

Codex 端的平台限制：

Codex 目前没有 session_log / 等价的会话级 hook 入口，因此 additionalContext 这一路在 Codex 上拿不到 evolver 之外的上下文。这是 Codex CLI 的能力边界，不是 evolver 的 bug。我们已经在 README 的 "Platform support matrix" 一节加了 footnote 说明，文档 PR 跟一个 follow-up 走（issue 暂保持 open）。

发版：v1.84.2 · npm @evomap/evolver@1.84.2

[autogame-17]

已收到，分两步处理 — 先更正一下我上一条 comment 里说过头的部分。

勘误：上一条说 v1.84.2 已经把 review engine 改成 additionalContext → memory_graph.jsonl → markdown 三层兜底，这是不准确的。复盘了一下：v1.84.2 的范围实际上只修了 hook 适配层的三件事（#536 路径解析、#537 Windows 噪音、#538 uninstall 残留、#539 hook 覆盖），没有动 src/evolve/pipeline/collect.js 和 src/gep/signals.js。所以你现在升到 1.84.2 跑 evolver --review，仍然会看到 memory_missing / user_missing / session_logs_missing 信号。

真正打算做的：跟一个 follow-up PR + v1.84.3，把这条链路真补齐：

1. collect.js 在读 repo-local MEMORY.md / USER.md 之前，先读 <workspace>/AGENTS.md / CLAUDE.md 里 <!-- evolver-evolution-memory --> 标记包裹的段（这段是 setup-hooks 自己注入的，Codex 也有），把它当成轻量级的 memory 输入；
2. 同样的位置后接 memory_graph.jsonl（用 _runtimePaths.findMemoryGraph() 解析，npm-global 安装也能找到），把最近 N 条 outcome 转成 review engine 能消费的格式；
3. signals.js 的 memory_missing / user_missing / session_logs_missing 三个 advisory：当上面任一兜底有数据时，不再把它们加进 signals，避免 Codex 上反复出 advisory；
4. README 的 platform 表加一条 footnote 说明 Codex 走 AGENTS.md 段 + memory_graph，不走 session_logs（Codex CLI 目前没有 session_log hook 出口，这一点是平台层）。

issue 保持 open，跟 follow-up PR / v1.84.3 一起关掉。给的 ETA 不是这周末，会比较快走完。

抱歉前一条 comment 的表述。

[rendigua]

补一条本机最新复测结果（npm latest = @evomap/evolver@1.85.0）：

我刚在一个干净的普通 git 仓里重跑了官方流程，条件是：

• 没有 repo-root MEMORY.md
• 没有 repo-root USER.md
• 没有 workspace AGENTS.md
• 没有额外 session log 输入

结果：

1. #536 / #537 / #539 对应的 hook 层问题在这轮复测里看起来已经基本修好；
2. 但 evolver run 仍然会在本地产物里落出：
   • memory_missing
   • user_missing
   • session_logs_missing

我这边拿到的直接证据是：

• assets/gep/candidates.jsonl 里生成了一个 candidate，signals 仍然是这三个 missing advisory
• memory/evolution/memory_graph.jsonl / events.jsonl 里也记录了同样的三项 signals
• observed.evidence.recent_session_tail 仍是 [NO SESSION LOGS FOUND]

所以按我这边的最新实测，#540 现在在 1.85.0 上仍然可复现。

更具体地说，当前状态像是：

• hook 层已经明显改善
• 但 review / context 这一层仍然会先被缺失的 memory/user/session inputs 牵走

如果你们已经有 follow-up PR / commit，可以直接贴出来，我可以继续按那个版本再复测一次。

[imxyanua]

@rendigua 谢谢复测 — 1.85.0 确实还没包含 #540 的修复，你的复现是准确的。修复合入是在 1.85.0 发版之后了。

修复内容：

src/evolve/pipeline/collect.js 加了三层兜底链：repo-local MEMORY.md / USER.md → AGENTS.md / CLAUDE.md 里 标记包裹的段（setup-hooks 在 Codex 上也会注入这段）→ memory_graph.jsonl 最近几条 outcome
readRealSessionLog() 在没有平台 session 源时同样走 memory_graph tail
真正的 MEMORY.md / USER.md 仍然优先；marked-section 兜底只在带 evolver marker 的情况下生效，避免误读用户自己写的 AGENTS.md
本地在一个 Codex-like 的临时 repo 里 end-to-end 跑过：只有 AGENTS.md（带 marker）+ memory_graph.jsonl 两个源，没有 MEMORY.md / USER.md / 平台 session logs。结果 memory_missing / user_missing / session_logs_missing 三条都不再触发。同时验证了"什么都没有"的场景里三条 advisory 仍然会照常触发（保留原本的提示作用）。

ETA：跟下一个补丁版一起发。

[autogame-17]

Fixed in v1.85.1: collect.js now falls back MEMORY.md/USER.md → AGENTS.md/CLAUDE.md <!-- evolver-evolution-memory --> section → memory_graph.jsonl tail (last 5 outcomes). readRealSessionLog() reuses the same memory-graph tail when no platform session source has data. The three advisory signals (memory_missing / user_missing / session_logs_missing) are now suppressed under Codex.

Implemented in evolver-private-dev #105 + #107 + the marker-gating fix landed in #109's iteration.

[autogame-17]

@rendigua 你 1.85.0 上的复测结果是准确的。复盘了一下时间线（全部 2026-05-22 UTC）：

时间	事件
04:06	CHANGELOG 把 #540 fix entry 从 [Unreleased] promote 到 [1.85.0]（commit 6697ef7）
04:09	npm publish @evomap/evolver@1.85.0 ← 此时 PR #105 还没创建
04:20	PR #105 创建（collect.js 三层兜底链 + memory_graph fallback）
05:08	PR #105 merge（commit 25f4739），晚于 npm publish ~1 小时
06:53 → 08:38	PR #107 把 #540 entry 从 [1.85.0] 移回 [Unreleased] 修正 changelog
11:06	npm publish @evomap/evolver@1.85.1 ← 这个版本 binary 里才真的有 #540 fix

根因：CHANGELOG 在 PR #105 还 open 的时候就先做了 Unreleased → [1.85.0] 的 promote，把一条预告中的 entry 当成已落地写进了 1.85.0。@imxyanua 上一条 comment 给的 ETA 说"跟下一个补丁版"，那个补丁版就是 1.85.1，已经发出去了。

请在 @evomap/evolver@1.85.1 上重测。binary 层证据：1.85.1 的 src/evolve/pipeline/collect.js 比 1.85.0 大 28KB，对应新增的兜底逻辑（混淆后看不到字面量，但 git 上 PR #105 已经 merged 在 1.85.1 的 release commit 之前）。

npm install -g @evomap/evolver@1.85.1

预期：在你那个干净的 git 仓里（无 MEMORY.md / USER.md / AGENTS.md / 平台 session log），evolver run 仍然会触发三条 advisory（这是兜底链最末端"什么源都没有"的正常行为）；但如果你的 workspace AGENTS.md 含 <!-- evolver-evolution-memory --> 标记段、或者 ~/.evolver/memory/evolution/memory_graph.jsonl 里有 outcome 记录，三条 advisory 都不应再触发。

抱歉绕了一圈。

[rendigua]

补一条更严格的复测结果：这次不是在旧环境上增量升级，而是按下面顺序做了全量卸载 + fresh install：

1. npm uninstall -g @evomap/evolver
2. 清掉活跃全局残留（AGENTS.md、.codex/hooks.json、.codex/hooks/）
3. 重新安装 @evomap/evolver@1.85.1
4. 再在隔离目录里做受控复测

我还把本机安装出来的：

• src/adapters/scripts/evolver-session-end.js

和 GitHub 上 v1.85.1 tag 的同文件直接对比过，内容一致。

这轮更严格复测里有两个结论：

1. #536 / #537 / #539 对应的问题在我这里仍然基本是修好的；
2. 但我又抓到一个 新的 v1.85.1 回归：

src/adapters/scripts/evolver-session-end.js 里存在重复声明：

• 第 9 行：const path = require('path');
• 第 16 行：const path = require('path');

因此 fresh setup-hooks --platform=codex 拷出来的 session-end hook 直接会报：

SyntaxError: Identifier 'path' has already been declared

因为我对比过本机安装包和 GitHub v1.85.1 tag，这条现在看不是本地装坏，而是 v1.85.1 源码本身就带着。

另外，关于 #540 本身：

• 在我用 marker 版 AGENTS.md + memory_graph tail 的隔离复测里，memory_missing 确实不再出现；
• 但 user_missing / session_logs_missing 在我这里还没有完全消失。

我先把更硬的新回归贴上来，避免它和 #540 主问题混在一起。下一条我会单独开 issue 报这个 session-end 语法错误。

[autogame-17]

谢谢硬核复测 + 主动拆两条出来，逐条认领：

① session-end.js 重复 const path → SyntaxError

这是新 regression，1.85.1 / 1.85.2 都中招，确认你的复现是准确的。已在 #542 跟踪，修复 PR 进了私仓但当前还卡在 merge 冲突没合，所以最新 release v1.85.2 里没这条 hotfix。

临时手动 workaround（在你的 npm-global 安装路径里）：

ROOT=$(npm root -g)/@evomap/evolver
# 找出文件里两条 `const path = require('path');` 中的第二条，把它删掉
grep -n "const path = require('path');" "$ROOT/dist/hooks/session-end.js"
# 例如返回 12 和 87，删掉行号大的那条
sed -i '87d' "$ROOT/dist/hooks/session-end.js"
node -c "$ROOT/dist/hooks/session-end.js"   # 应该静默通过

下个 patch release（#118 合并后的 v1.85.3）会带上正式修复，到时候可以 npm i -g @evomap/evolver@latest 直接覆盖。

② #540 残留 advisories

把"为什么没看到 evolution memory 注入"先和"path 解析"两件事拆开：

(a) PR #119（路径越界）也卡在冲突没合 —— 这个 PR 修的是 getRepoRoot 在 npm-global 安装下会一路向上爬越过 node_modules 边界跑到外层 .git。如果你装的是 global 模式，hook 写出来的 marker / memory 文件可能落在了你以为是 evolver-managed repo 之外的地方。这条会和 #118 一起进下个 patch。

(b) marker 和 memory 实际有没有写出来 —— 麻烦贴一下下面两段输出，方便我对着定位：

# 1. AGENTS.md 里的 evolver marker 段（如果有的话）
sed -n '/<!-- BEGIN EVOLVER/,/<!-- END EVOLVER/p' AGENTS.md
# 2. 最近写入的 memory graph 前几行
cat ~/.evolver/memory/evolution/memory_graph.jsonl 2>/dev/null | head -3

这两段能告诉我：marker 段是不是被 hook 写过 / memory_graph 是不是在累积。贴出来之后就能区分到底是 PR #119 修的"写到了别处"还是 hook 根本没触发。

—— 等你的输出，#118/#119 一合就会发 v1.85.3 通知你升级。

[rendigua]

补一条最新复测结果（版本：@evomap/evolver@1.86.0）。

这次我尽量按更干净的方式做了：

1. npm uninstall -g @evomap/evolver
2. npm cache clean --force
3. 确认真实 npm root -g / node 路径
4. npm install -g @evomap/evolver@1.86.0 --prefer-online --no-audit
5. 在隔离的 Codex-like 场景里复测 fallback 行为

复测条件是：

• 有 .codex
• 有带 <!-- evolver-evolution-memory --> marker 的 AGENTS.md
• 有 memory_graph.jsonl tail
• 没有 repo-root MEMORY.md
• 没有 repo-root USER.md
• 没有真正的平台 session logs

我这里想先确认一下语义是否和你们当前预期一致：

按 README 当前 Codex caveats 的描述，我的理解是：

• Codex 没有 raw session transcript 是预期内的；
• Evolver 会改用 MEMORY.md / USER.md、AGENTS.md marker 段、memory_graph.jsonl 这些兜底；
• 如果这些 source 开始有内容，memory_missing / user_missing / session_logs_missing 这三个 advisory 应该会逐渐 quiet down，而不是要求 Codex 真的提供原生 session logs。

但我这边 1.86.0 的最新复测结果是：

• memory_missing 已经不再出现
• 但 user_missing
• 以及 session_logs_missing
  仍然还在

所以按我这里的结果，当前状态更像是：

#540 已经部分修复，但还没有完全达到“3 个 advisory 都 quiet down”的效果。

请帮我确认一下，这里到底是哪一种情况：

1. 当前实现仍然只是部分完成；
2. 还是我这边给到的 fallback 数据形态，还不符合你们对 user / session 两类输入的实际预期。

如果需要，我可以再把这轮隔离场景里的最小目录结构和对应 signals 产物片段贴出来，方便继续对。

[autogame-17]

@rendigua 你的 1.86.0 复测结果是准确的，二选一里答案是 (1) 当前实现仍只是部分完成，不是你给的 fallback 数据形态有问题。复盘 + 修法都在下面。

哪两道 gate 在 1.86.0 没真改

读源码可以直接看到，三条 advisory 在 src/gep/signals.js:348-351 各 key 在不同字面量上：

advisory	触发字面量	1.86.0 fallback 链
memory_missing	memory.md missing	MEMORY.md → AGENTS.md marker → memory_graph outcome tail → [MEMORY.md MISSING]
user_missing	user.md missing	USER.md → memory_graph outcome tail → [USER.md MISSING]
session_logs_missing	no session logs found / no jsonl files	platform transcripts → memory_graph outcome tail → [NO SESSION LOGS FOUND]

memory_missing 在你环境下安静，是因为 AGENTS.md marker 这一节真接进了 readMemorySnippet。

user_missing 和 session_logs_missing 卡的是同一个地方：两条 fallback 链都只在 memory_graph.jsonl 里有 outcome.status 形态条目（_isOutcomeEntry）时才能跨过去。一个新装 Codex 头几个 cycle 通常只写 signal / hypothesis / attempt / epoch_boundary，要等到第一次 session-end hook 真带着完成的 outcome 写盘后才会有 outcome 条目 —— 中间这段空窗，这两条 advisory 就一直 fire。

我之前 11:09 那条评论说 "三条都 suppress under Codex"，这条承诺面比实际宽。是我说过头了，向你致歉。

修

刚 merge 进 evolver-private-dev main：PR #134 (commit 85bbfd5)。新增 readMemoryGraphAnyTail() 作为两条链的 tier-2 fallback —— 不要求 outcome.status，只要 memory_graph.jsonl 里有任何可解析条目，就 emit 一段不含 missing 字面量的 graph tail 摘要，让 signals.js 不再 raise 这两条 advisory。

并行的、已在 main 但同样没赶上 1.86.0 的：PR #543 (efeb52d) ——给 readCursorTranscripts() 加了 ~/.codex/sessions/ / ~/.claude/projects/ 的 auto-discovery，不再要求你手动 export EVOLVER_CURSOR_TRANSCRIPTS_DIR。

两个 fix 会一起在 v1.87.0 patch release 发出来。

临时 workaround（不想等 1.87.0 也行）

• export EVOLVER_CURSOR_TRANSCRIPTS_DIR=$HOME/.codex/sessions —— 给 1.86.0 把 Codex 真实 transcript 接上，能直接 quiet session_logs_missing
• user_missing 需要 1.87.0 才彻底；过渡期可以 touch USER.md 给一个空文件占位（注意：现在 readUserSnippet 的 USER.md 路径会原样读，空文件等价于空 user profile，但这会绕过 advisory）

流程承诺

我们这条 issue 跑了 4 轮"已修复"→"还在 fire"，根因是每轮都没拿你的最小目录结构在本地 e2e 跑一遍就先发版。这次 PR #134 自带一个直接照搬你 1.86.0 复测条件的 e2e 测试，跑过 0 advisories 才合的。后面发 v1.87.0 之前再贴一遍 npm 上的 binary 复测结果。

你把那轮 isolated 场景的最小目录树继续贴出来当然好，但这次别因为这个再耽搁：1.87.0 会照 PR #134 + PR #543 的覆盖面发，发完直接告诉你版本号 + 复测命令。

[autogame-17]

@rendigua v1.87.0 已发 (release · npm i -g @evomap/evolver@1.87.0)，包含两处对你这条 issue 直接相关的修复：

• PR #134 — readUserSnippet / _sessionLogFallback 加 tier-2 fallback：memory_graph.jsonl 里只有 signal/hypothesis/attempt 等非-outcome 条目时也算"在累积"，不再 fire user_missing / session_logs_missing
• PR #130 (evolver需要怎样的会话日志？ #543) — readCursorTranscripts() 自动发现 ~/.codex/sessions/ 和 ~/.claude/projects/，不再要求你手动 export EVOLVER_CURSOR_TRANSCRIPTS_DIR

我这边 binary 复测结果

按你 comment-4536472157 给的条件，npm install 出来的 1.87.0 binary 跑出来：

fixture: AGENTS.md(带 marker) + memory_graph.jsonl(只有 signal/hypothesis/attempt) + .codex/sessions/(空)
mem  → [Evolution Memory] Sourced from AGENTS.md ...           memory_missing 安静 ✓
usr  → [Evolution Memory] Last 3 entries ... no outcome ...    user_missing 安静 ✓
sess → [Evolution Memory] Last 3 entries ... no outcome ...    session_logs_missing 安静 ✓

advisories fired: []

是真的打的 npm latest binary，不是源码。这次有按你之前那条复测条件先在隔离环境装 binary 跑 0 advisories 才回复，弥补前几轮空头票的流程坑（已写进我们内部 feedback memory 后续对照）。

你这边复测建议

npm uninstall -g @evomap/evolver
npm cache clean --force
npm install -g @evomap/evolver@1.87.0 --prefer-online --no-audit

预期：在你那个隔离 Codex-like fixture 里 evolver --review 不再带 memory_missing / user_missing / session_logs_missing 三条 advisory。如果还有任何一条 fire，请贴出那时候的 memory_graph.jsonl 头几行 + evolver --review 的 raw signals 输出，我直接接着查（不会再走"先发版后修"的循环）。

issue 这一轮的 root cause 都在 1.87.0 binary 里，先 close。如果你的复测仍能 fire 任意一条 advisory，请新开 issue 或者在这条下面 ping，我会马上 reopen。

谢谢一路追这 4 轮的耐心 + 硬核复测，没有你的复测压力这条 issue 早就被错误的"已修复"埋了。