Skip to content

docs: synchronize 1.2.2 manual and book release anchors - #5223

Merged
huangruiteng merged 1 commit into
mainfrom
codex/release-v1.2.2-doc-sync
Sep 27, 2026
Merged

huangruiteng merged 1 commit into
mainfrom
codex/release-v1.2.2-doc-sync

Conversation

@huangruiteng

Copy link
Copy Markdown
Collaborator

The 1.2.2 pre-publication workflows found that resolve-peer-route was absent from the canonical command catalog and that the generated manual and Developer Book still named 1.2.1. Add the shipped route command to the existing help owner, regenerate the manual, and align the four bilingual book version references with the package version.

Validation: existing CLI/manual and Developer Book publication smokes, changed Python Ruff, whitespace and public boundary checks pass. Existing checks remain intact; this changes documentation discovery and release identity only. Final merged-source qualification and publication follow separately.

@huangruiteng huangruiteng left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewed head: 5223@388249176be6a5af2425db343815d8b8ed74092f

动机

1.2.2 发布前验证发现两个真实缺口:现有 resolve-peer-route 命令未被命令目录或 help-only 集合覆盖,完整公开 smoke 因此失败;Developer Book 的四个当前版本锚点与生成的手册仍写 1.2.1,网站发布检查失败。维护者已授权本次发布所需修复与合并。

改动思路

复用 COMMAND_GROUPS 作为 commands 与 manpage 的单一公开目录,在既有 agent-directory 后加入已经存在的精确 peer 路由读取命令,再用 render-manpage 生成手册。双语书籍只同步当前发行版本;历史迁移里程碑保持其原有含义。无需新增文档生成体系或修改检查条件。

具体改动

完整差异为六个文件、13 行增加和 6 行删除。帮助目录增加四行,生成的手册增加该条目并更新头部版本;书籍四处当前版本说明对齐 1.2.2。实际 CLI、命令分类完整性、手册生成一致性及安装器路径均由既有 CLI/manual smoke 验证,Developer Book publication smoke 验证四个锚点,均已通过。Ruff、空白、公开边界、精确差异质量与风险预合入检查通过。没有新的执行或授权行为;commands 的目录增加一项,默认简洁 help 与 resolve-peer-route 参数和拒绝行为保留。网页变化位于已有版本基线正文下部,不涉及首屏、主 CTA 或导航。

对主干的风险

遗漏手册生成会继续造成发行身份不一致;当前提交保留生成一致性断言。添加错误命令分类会让 parser/manual 分类不符;原始失败及 head 的现有 smoke 证明分类敏感性。中英文 release anchor 必须一致,本次同时同步四处。没有放宽 CI、预算、权限或默认激活。发布前仍需在最终合入提交重新执行完整发布资格,不能把此次局部文档验证当成已发布或已安装。

我的整体评价

当前精确 head 可以批准,范围覆盖已证明的两个发行缺口。相邻边界已检查:继续使用现有目录、生成器与版本校验,不需要新增抽象;没有值得夹带的额外重构。已完成正向和原始失败对照,剩余完整 CI、实际模型与公开工件验收由同一次发行继续负责。评审发布于当前 head,合并使用维护者已有授权。

English verdict: APPROVE

Signed-off-by: huangruiteng <14976749+huangruiteng@users.noreply.github.com>
@huangruiteng
huangruiteng force-pushed the codex/release-v1.2.2-doc-sync branch from 3882491 to 6cb1b21 Compare September 27, 2026 19:58

@huangruiteng huangruiteng left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approval conclusion (author-owned PR; GitHub blocks formal self-approval)

Reviewed head: 5223@6cb1b21570cd5da791073c97e70dfae1d1ac01f8

动机

1.2.2 发布前验证发现两个真实缺口:现有 resolve-peer-route 命令未被命令目录或 help-only 集合覆盖,完整公开 smoke 因此失败;Developer Book 的四个当前版本锚点与生成的手册仍写 1.2.1,网站发布检查失败。维护者已授权本次发布所需修复与合并。

改动思路

复用 COMMAND_GROUPS 作为 commands 与 manpage 的单一公开目录,在既有 agent-directory 后加入已经存在的精确 peer 路由读取命令,再用 render-manpage 生成手册。双语书籍只同步当前发行版本;历史迁移里程碑保持其原有含义。无需新增文档生成体系或修改检查条件。

具体改动

完整差异为六个文件、13 行增加和 6 行删除。帮助目录增加四行,生成的手册增加该条目并更新头部版本;书籍四处当前版本说明对齐 1.2.2。实际 CLI、命令分类完整性、手册生成一致性及安装器路径均由既有 CLI/manual smoke 验证,Developer Book publication smoke 验证四个锚点,均已通过。Ruff、空白、公开边界、精确差异质量与风险预合入检查通过。没有新的执行或授权行为;commands 的目录增加一项,默认简洁 help 与 resolve-peer-route 参数和拒绝行为保留。网页变化位于已有版本基线正文下部,不涉及首屏、主 CTA 或导航。

对主干的风险

遗漏手册生成会继续造成发行身份不一致;当前提交保留生成一致性断言。添加错误命令分类会让 parser/manual 分类不符;原始失败及 head 的现有 smoke 证明分类敏感性。中英文 release anchor 必须一致,本次同时同步四处。没有放宽 CI、预算、权限或默认激活。发布前仍需在最终合入提交重新执行完整发布资格,不能把此次局部文档验证当成已发布或已安装。

我的整体评价

当前精确 head 可以批准,范围覆盖已证明的两个发行缺口。相邻边界已检查:继续使用现有目录、生成器与版本校验,不需要新增抽象;没有值得夹带的额外重构。已完成正向和原始失败对照,剩余完整 CI、实际模型与公开工件验收由同一次发行继续负责。评审发布于当前 head,合并使用维护者已有授权。

English verdict: APPROVE

@huangruiteng
huangruiteng merged commit d29d902 into main Sep 27, 2026
5 checks passed
@huangruiteng
huangruiteng deleted the codex/release-v1.2.2-doc-sync branch September 27, 2026 20:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant