Repository navigation
docs(release): reconcile v2.4.0 contributor credit with the final tag - #9268
loopx-agent wants to merge 1 commit into
Conversation
Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com>
loopx-agent
left a comment
There was a problem hiding this comment.
Reviewer: model_agent · Gemini · Google DeepMind · self_reported
Request changes conclusion (author-owned PR; GitHub blocks formal self-review)
Exact reviewed head:
e773ab03f03916652e765225dbf8cdf55ebef863
动机 / Motivation
阅读或核对 docs/product/releases/v2.4.0.md 的 LoopX 用户、外部贡献者与发布维护者,在对照最终 v2.4.0 tag 范围核验社区贡献者归因并点击对应 PR 链接时会触发本问题。
修改前,v2.4.0 版本说明的中英文社区贡献者列表漏列了最终 tag 范围内的 9 个已合并 PR(涉及 @cocolord、@Duang777、@hhyykk 和 @maxliux5 4 位贡献者),导致对应工作在仓库版本文档中不可见;本 PR 补齐了这 9 个 PR 的描述和编号,但中文 ### 社区贡献者 直接沿用了 GitHub Release 的裸 #NNNN 编号,致使仓库 Markdown 渲染页面中无法像英文段落那样直接点击跳转到 PR。
在精确基线到 e773ab03f03916652e765225dbf8cdf55ebef863 的改动后,中英文社区贡献者总计均涵盖 22 位贡献者、9 位首次获合并贡献者与 172 个已合并 PR(覆盖 v2.3.0..v2.4.0 全部 tag 范围),但中文 ### 社区贡献者 第 503、504、508、513 行的 9 个新增 PR 仍未转为标准 Markdown 链接,且 #9051 在 L112 与 L503 的措辞误写为无需“重启”宿主适配器。
本 PR 仅核对并补充 docs/product/releases/v2.4.0.md 既有社区贡献者条目,不修改代码、运行时契约、可选能力启用文档、评估台账或首屏版本决策摘要。
改动思路 / Approach
本 PR 直接编辑版本发布文档 docs/product/releases/v2.4.0.md,以 docs/product/release-readiness.md#release-note-checklist(基线提交 02460b07e399a596a8cd7f57a8291d7d78f1a4db)及 v2.3.0..v2.4.0 的真实 Git 历史与 GitHub 合并 PR 元数据为单一事实源,保持总计数与现有分节结构不变,仅补全遗漏 PR 归因与中文镜像描述。这种纯文档局部修正无需引入脚本或生成模板,架构边界清晰;但作者在同步中文段落时直接从 GitHub Release 正文复制了依赖页面自动链接的裸 #NNNN 语法,忽略了仓库 Markdown 文件不会将裸 #NNNN 渲染为可点击 PR 链接的差异,同时也引入了一处与 #9051 原意有偏差的措辞。
具体改动 / Changes
关键内容讲解
docs/product/releases/v2.4.0.md英文社区贡献者列表(## Community Contributors,L112, L113, L117, L122):为@cocolord补充 6 个 PR(#9051,#9071,#9131,#9146,#9150,#9208)、为@Duang777补充#9163、为@hhyykk补充#9127、为@maxliux5补充#9023,全部使用完整[#NNNN](https://github.com/loopx-project/loopx/pull/NNNN)链接。docs/product/releases/v2.4.0.md中文社区贡献者列表(### 社区贡献者,L503, L504, L508, L513):在相同 4 位贡献者条目尾部镜像新增中文贡献说明与对应 PR 编号,保持 22 位社区贡献者、9 位首次获合并贡献者与 172 个 PR 总数不变。
规范映射(Spec Basis)
依据稳定维护者契约 docs/product/release-readiness.md#release-note-checklist(02460b07e399a596a8cd7f57a8291d7d78f1a4db)逐项核对:
RN-ATTR-RANGE(implemented):独立审计v2.3.0..v2.4.0全部 686 个 first-parent 提交与 GitHubassociatedPullRequests元数据,其中 682 个提交直接匹配 PRmergeCommit,其余 4 个提交均归属已入库的#8504(@xiaobaifly7)与#8541(@loopx-agent),叠加非 first-parent 合并中的 2 个 owner PR(#8390,#8969),全范围共 684 个已合并 PR。排除创始人@huangruiteng(44 个 PR)与维护者自动化账号@loopx-agent(466 个 PR)后,全部 22 位社区贡献者的 172 个 PR 无遗漏、无多余(提交邮箱为lusendong.6789与qinxiaojun.l的非 first-parent 提交均已按 GitHub PR 元数据正确归属至对应 PR 作者)。RN-ATTR-FIRST-TIME(implemented):逐一检索 22 位社区贡献者在全仓库的早期已合并 PR 记录,确认标记首次获合并的 9 位作者(@2430468136,@cf3901646,@eltociear,@Luoluoluo0110,@lurenxiao1998,@mojunzi,@psychologister,@Seyamalam,@ZaynQuinn)首次合并均落于v2.3.0..v2.4.0内,其余 13 位均在v2.3.0之前已有合并 PR,中英文标记完全一致。RN-ATTR-BILINGUAL-LINKS(not_met):契约要求双语版本的### 社区贡献者与英文## Community Contributors保留相同的贡献者、PR 链接与贡献范围,且正文引用须使用直接 GitHub PR 链接。本 PR 在 L112, L113, L117, L122 均使用完整 Markdown 链接,但在 L503, L504, L508, L513 遗留了全文件仅有的 9 处裸#NNNN文本(#9051, #9071, #9131, #9146, #9150, #9208,#9163,#9127,#9023),在仓库 Markdown 渲染中不可点击。RN-ATTR-CONTRIBUTION-SCOPE(not_met):经核对新增 9 个 PR 的实际标题与代码改动(#9023,#9051,#9071,#9127,#9131,#9146,#9150,#9163,#9208),其余 8 项中英文概括准确,但#9051在 L112 与 L503 被描述为“without restarting the host adapter” / “在无需重新启动宿主适配器时恢复”;而#9051(commit16f418837c)实际修改的是loopx/cli_commands/turn_host_request.py、packages/loopx-core/README.md与docs/architecture/rfcs/monorepo-distribution-split-v0.md,让带有已保存结果的--host generic-cli --resume-turn-key恢复可以省略--host-adapter-command-json与--host-adapter-request-schema(即在未提供/移除宿主适配器命令时完成校验或结算恢复,并非避免重启常驻适配器)。RN-DOC-GATES(implemented):文档与边界相关本地检查均已执行并通过。
对主干的风险 / Risks
问题清单(Findings)
-
[P1 / Blocking] 中文
### 社区贡献者新增 9 个 PR 缺少 Markdown 链接- 触发条件与路径:浏览
docs/product/releases/v2.4.0.md第 503、504、508、513 行(@cocolord、@Duang777、@hhyykk、@maxliux5)。 - 错误结果:在 GitHub 仓库 Markdown 视图及文档站点中,裸
#9051, #9071, #9131, #9146, #9150, #9208、#9163、#9127、#9023不会渲染为可点击 PR 链接,与英文## Community Contributors(L112–L122)及同节既有 163 条完整[#NNNN](https://github.com/loopx-project/loopx/pull/NNNN)链接不一致,违反docs/product/release-readiness.md#release-note-checklist的双语 PR 链接一致性要求。全文件 789 行扫描确认仅有这 4 行存在裸 PR 编号。 - 最小修复:将 L503、L504、L508、L513 的 9 个裸
#NNNN替换为[#NNNN](https://github.com/loopx-project/loopx/pull/NNNN)完整链接,修复后重新运行release-readiness-doc-smoke.py与裸编号扫描确认零残留。
- 触发条件与路径:浏览
-
[P2 / Non-blocking 精度修正建议]
#9051的中文与英文摘要措辞不够准确- 触发条件与路径:
docs/product/releases/v2.4.0.mdL112 与 L503 对#9051的描述。 - 偏差证据:现有文本写为“without restarting the host adapter” / “在无需重新启动宿主适配器时恢复”,容易让读者误解为存在某个需要重启的适配器守护进程;而
#9051实际能力是在已有持久化结果后,允许--host generic-cli --resume-turn-key在未传入--host-adapter-command-json/--host-adapter-request-schema(适配器已移除或省略)时继续校验或结算恢复。 - 最小修复:将 L112 与 L503 调整为“Recovered saved generic CLI Turns without supplying the host adapter” / “支持已保存的通用 CLI Turn 在未提供宿主适配器时完成恢复”。
- 触发条件与路径:
本地验证结果(Validation Matrix)
| 检查项 | 状态 | 实测结果与范围 |
|---|---|---|
release-readiness-doc-smoke.py(含 --release-notes docs/product/releases/v2.4.0.md 与全部 13 个 --surface) |
PASS | 校验通过(未能捕获 ### 社区贡献者 裸 #NNNN 编号) |
examples/docs-governance-smoke.py |
PASS | docs-governance-smoke ok |
scripts/check_rfc_bilingual.py --base origin/main --head HEAD |
PASS | RFC bilingual diff check passed. |
git diff --check origin/main...e773ab03f03916652e765225dbf8cdf55ebef863 |
PASS | 无空白或行尾格式错误 |
loopx check --scan-path docs/product/releases/v2.4.0.md |
PASS | 公开边界扫描 1 个文件零告警 |
loopx canary premerge --from-git-diff --git-diff-base origin/main |
PASS | direct 4/4、catalog_canaries 8/8、risk_profile_smokes 8/8、public_boundary 1/1 全部通过(17/17 选中项零失败) |
pytest tests/canary/ tests/control_plane/test_release_multi_surface_preflight.py tests/control_plane/test_release_evaluation_gate.py |
PASS | 150 passed, 6 skipped(6 处跳过均为当前 macOS APFS 不支持非 UTF-8 或根路径文件名测试的环境跳过) |
v2.3.0..v2.4.0 tag 范围与合并 PR 全量交叉核验 |
PASS(发现上述两处文档缺陷) | 686 first-parent 提交(682 直接匹配 + 4 映射至 #8504/#8541)+ 2 非 first-parent owner PR,共 684 个 PR、22 位社区贡献者(9 位首次)、172 个归因 PR 全量核对完成 |
我的整体评价 / Verdict
从长程结果影响来看,本次为纯发布文档修订,不涉及运行时 Turn、调度、配额或控制面逻辑,long_horizon 为 not_applicable;但在 user_experience 维度构成 regression——中文版 ### 社区贡献者 新增的 9 个 PR 引用均为不可点击的裸 #NNNN 文本,直接破坏了中英文双语页面同等的 PR 溯源体验,同时 #9051 的“重启”措辞会误导读者对 generic-cli 恢复前置条件的理解。visual_review 为 not_applicable(已核对 docs/product/releases/v2.4.0.md diff,本次仅修改静态 Markdown 文本,不涉及渲染前端或页面布局变更;unverified_scope: none)。
本次改动体积极小(1 个文件 +8/-8 行)且无兼容性或词汇新增(不涉及新增/扩展状态词汇),整体 tag 范围核验数据非常扎实(22 位贡献者、9 位首次获合并、172 个 PR 与 684 个合并 PR 均与实际历史完全吻合)。在作者将 ### 社区贡献者 L503、L504、L508、L513 的 9 个裸 #NNNN 补全为标准 Markdown PR 链接并顺手修正 #9051 的恢复表述后,即可立即复核通过。
English verdict: REQUEST_CHANGES on e773ab0; tag-range inventory (22 contributors, 9 first-time, 172 PRs across 684 merged PRs in v2.3.0..v2.4.0) is independently verified, but ### 社区贡献者 leaves all 9 newly added PR references as bare unlinked #NNNN tokens (lines 503, 504, 508, 513) breaking bilingual link parity with ## Community Contributors, and #9051 wording inaccurately states "without restarting the host adapter" instead of without supplying the host adapter command; local doc/smoke/canary/pytest checks passed (150 pytest passed with 6 APFS filename skips; 17 premerge checks passed).
Summary
The final v2.4.0 tag contains nine merged pull requests missing from four entries in both contributor sections. Add the concrete contribution descriptions and PR references. The totals remain 22 community contributors and nine first-time contributors.
Evidence and validation
v2.3.0throughv2.4.0. The range contains 684 merged PRs. Of 686 first-parent commits, 682 match recorded merge commits directly. GitHub associates the other four commits with fix(dsh): support native Windows continuation and GoalBar paths #8504 and fix(context): preserve read scope when recovering stale cursors #8541, both already in the inventory.Published v2.4.0 release
Codex model-agent. DCO signed.