release: prepare v1.2.4 and reconcile migration examples

[huangruiteng]

Prepare v1.2.4 from the latest merged main. Mirror runtime/package versions, update bilingual Developer Book anchors, and restore the existing offline migration command in the canonical help/manual catalog. Use the bootstrap-owned route in auto-research rather than duplicating its directory rule.

This PR prepares the release source. Tag publication remains subject to fresh qualification of the final merged commit. Upgrade diagnostics and Monitor recovery are already merged; #5338 remains outside this release.

Community Contributors

• @yuefengw — External contributor: Reward Memory utility attribution Stage 2 (#3829).
• @LIHUA919 — External contributor: explicit local-state migration, material monitor counting and offline ledger recovery guidance (#4915, #5393, #5247, #5235, #5251, #5418).
• @kokokoXUY — External contributor: LF-framed JSONL reads, missing scan-root refusal, Todo labels and documentation references (#5117, #5303, #5312, #5300, #5318).
• @karenchuu — External contributor: shared digest and identifier owners across control-plane, Lark, connector and benchmark boundaries (#5252, #5254, #5351, #5358, #5359, #5360, #5361, #5387, #5388).
• @songoow — Project contributor: confirmable Chat Todo proposals, running-Turn composer behavior, team execution facts prerequisite checks and dashboard CSS tokens (#5266, #5261, #5304, #5306, #5302, #5343, #5412).
• @Duang777 — Project contributor: GoalRef journal and outbox fencing, source fingerprint validation, atomic process markers and execution chips (#5324, #5278, #5367, #5365, #5345).
• @gcl-coder — External contributor: the shared public-safety local-path owner (#5296).
• @sakurahello1 — First-time external contributor: the diff semantic advisory, credential-word/value policy, shared SHA envelope and relative Lark fixtures (#5317, #5335, #5337, #5316).
• @cocolord — Project contributor: RFC lifecycle/delivery distinctions and current scoped-quota override projection (#5348, #5370, #5371).
• @AronSwan — First-time external contributor: the single-owner Windows scheme-list sentinel (#5356).
• @jackie-cqz — External contributor: exclude Windows lock-holder sidecars from inbox scans (#5400).
• @sundevilyang — First-time external contributor: preserve Todo completion result bindings across Markdown parity (#5437).

中文摘要

准备 v1.2.4 版本源码，修复帮助页和示例对已交付目录契约的兼容。升级保留既有状态目录，迁移仍须显式离线执行。

社区贡献者

• @yuefengw — 外部贡献者: Reward Memory 第二阶段效用归因 (#3829).
• @LIHUA919 — 外部贡献者: 显式状态目录迁移、实质 monitor 计数与离线日志恢复指南 (#4915, #5393, #5247, #5235, #5251, #5418).
• @kokokoXUY — 外部贡献者: JSONL 的 LF 分帧、缺失扫描路径拒绝、Todo 标签和文档引用 (#5117, #5303, #5312, #5300, #5318).
• @karenchuu — 外部贡献者: 控制面、Lark、connector 和 benchmark 边界中的共享摘要及标识符 owner (#5252, #5254, #5351, #5358, #5359, #5360, #5361, #5387, #5388).
• @songoow — 项目贡献者: Chat Todo 确认提案、运行中 Turn 的输入行为、团队执行事实、前提检查和 dashboard CSS token (#5266, #5261, #5304, #5306, #5302, #5343, #5412).
• @Duang777 — 项目贡献者: GoalRef 日志与 outbox fencing、来源指纹验证、原子进程标记和执行状态标签 (#5324, #5278, #5367, #5365, #5345).
• @gcl-coder — 外部贡献者: 公共安全中的共享本地路径 owner (#5296).
• @sakurahello1 — 首次贡献的外部贡献者: 差异语义 advisory、凭据词与值的分类、共享 SHA envelope 和相对路径 Lark fixture (#5317, #5335, #5337, #5316).
• @cocolord — 项目贡献者: RFC 生命周期与交付阶段区分，以及当前作用域 quota override 投影 (#5348, #5370, #5371).
• @AronSwan — 首次贡献的外部贡献者: Windows scheme-list sentinel 的单一 owner (#5356).
• @jackie-cqz — 外部贡献者: 从 inbox 扫描排除 Windows 锁持有者旁文件 (#5400).
• @sundevilyang — 首次贡献的外部贡献者: 在 Markdown parity 中保留 Todo 完成结果绑定 (#5437).

Validation

Focused migration, CLI budget, auto-research and worker tests: 129 passed, 3 skipped in 104.15s (0:01:44). Help/manual installer, bilingual book, version identity, release artifact and auto-research smokes pass. Ruff and configured mypy pass. The frontend release build preserves verified previous delivery assets. The initial concurrent dependency-install conflict was rerun sequentially and passed. Semantic diff advisory and public/private diff scan passed; matched strings are pre-existing generic example paths. Native risk canary and exact-head review follow before merge. Full release qualification will use the final merged commit.

Future-facing pass: use bootstrap state_file as the existing route owner; no new decision source or abstraction. No public first-screen change.

[huangruiteng]

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

Reviewed exact head: 445208a32b4c81514e9e9c74e80fe55ffc61616f; base: 46a8c9b65ee8e2df5123a5762317e28b40d167fa.

动机

用户恢复 v1.2.4 发布。这个已有 PR 先准备可冻结的版本源码，并修复迁移命令缺失于帮助目录、公开示例仍硬编码旧状态目录这两个实际兼容问题。合并此 PR 不等于发布验证完成。

改动思路

沿用已有 package/runtime 版本镜像、COMMAND_GROUPS 与生成手册，以及 bootstrap 的 state_file 返回值。Python 留在既有打包、文件系统和示例适配层；没有新增控制面决策源、权限或迁移执行器。相关小重构已去掉 demo 重复的目录知识，没有新增 helper。

具体改动

• loopx/__init__.py 与 pyproject.toml 同步为 1.2.4，四份中英 Developer Book 当前锚点随版本更新。
• help_surface.COMMAND_GROUPS 收录现有 migrate-local-state --help；man/loopx.1 由同一目录渲染，明确离线预览、停止 writer 与凭据绑定回退。
• CLI_OUTPUT_COMMAND_CLASSIFICATIONS 按精确 command id 使用既有 explicit_cold_path_exception。这条离线命令不进入自动轮询热路径，也不放宽任何输出预算。
• _seed_visible_demo_control_plane 使用 bootstrap 返回的实际状态文件；现有 worker-loop smoke 按新安装 .loopx 路由检查。已有登记旧目录仍由原 bootstrap/路径 owner 决定，没有搬动数据。

对主干的风险

完整差异仅 11 个文件，24 行增加、11 行删除。最强反例是版本镜像不一致、示例误写另一状态路径，或帮助出现被误认为迁移授权。现有版本不匹配、迁移 plan/receipt/活跃 writer 拒绝用例均通过；命令可见性不触发执行。129 项聚焦测试通过，3 项既有平台用例跳过，未算通过。帮助/真实隔离安装手册、书籍、版本、发布物和 auto-research smokes 全部通过；Ruff 零问题，mypy 的配置范围 19 文件通过。前端发布构建校验通过且保留上一交付资源。初次并发依赖安装造成的文件读取冲突已顺序重跑通过，未修改断言。

同一 auto-research smoke 在不可变主干 46a8c9b 因旧 .codex 状态文件不存在而失败，在本 head 的 .loopx 路由通过。native premerge 全部 14 项选定检查通过，零未解决 hold；最终质量 receipt cqr_91a43704d0c39ce4b44c 对应该精确 scope。差异语义 advisory 与公开边界检查通过；没有私有状态、日志或凭据进入改动。未改 UI 首屏、Lark/CLI 配置入口、PostgreSQL authority 或用户安装路由，因此无新增 companion 页面或真实 PG 重构验证要求。

最终合入提交仍需执行 pytest、Ruff、mypy、风险 canary、完整 public fleet、安装/升级/host、公开边界及真实默认 Doubao 八组发布验证。此评审不把旧 head 的结果移作最终 release 证明，也不声明完整发布或模型通过。

我的整体评价

APPROVE：这是完整而可回退的发布准备阶段，修复两个已交付契约的消费者问题，复用现有 owner。按用户恢复发布的授权完成合入后，继续在最终提交上验证、发布 tag/包和更新入口。本 Goal 不查询或等待 PR CI；没有未解决源码 blocker。

English verdict: APPROVE - exact head 445208a. Eleven focused release-preparation paths reuse canonical version/help/classification/bootstrap owners. 129 tests pass, three platform skips are disclosed; manual installer, book, version, artifact and demo smokes, Ruff, mypy, frontend build, native premerge and exact-scope quality pass. No migration execution or authority change. Final release qualification remains required on the merged commit before publication.

[huangruiteng]

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

Reviewed exact head: 2cb9505dc9bfb39291054f5a746ef34c7e99a471; base: 83faf456fa7d5a91f30a2be3e51efa482302be48.

动机

用户恢复 v1.2.4 发布。这个已有 PR 先准备可冻结的版本源码，并修复迁移命令缺失于帮助目录、公开示例仍硬编码旧状态目录这两个实际兼容问题。合并此 PR 不等于发布验证完成。

改动思路

沿用已有 package/runtime 版本镜像、COMMAND_GROUPS 与生成手册，以及 bootstrap 的 state_file 返回值。Python 留在既有打包、文件系统和示例适配层；没有新增控制面决策源、权限或迁移执行器。相关小重构已去掉 demo 重复的目录知识，没有新增 helper。

具体改动

• loopx/__init__.py 与 pyproject.toml 同步为 1.2.4，四份中英 Developer Book 当前锚点随版本更新。
• help_surface.COMMAND_GROUPS 收录现有 migrate-local-state --help；man/loopx.1 由同一目录渲染，明确离线预览、停止 writer 与凭据绑定回退。
• CLI_OUTPUT_COMMAND_CLASSIFICATIONS 按精确 command id 使用既有 explicit_cold_path_exception。这条离线命令不进入自动轮询热路径，也不放宽任何输出预算。
• _seed_visible_demo_control_plane 使用 bootstrap 返回的实际状态文件；现有 worker-loop smoke 按新安装 .loopx 路由检查。已有登记旧目录仍由原 bootstrap/路径 owner 决定，没有搬动数据。

对主干的风险

完整差异仅 11 个文件，24 行增加、11 行删除。最强反例是版本镜像不一致、示例误写另一状态路径，或帮助出现被误认为迁移授权。现有版本不匹配、迁移 plan/receipt/活跃 writer 拒绝用例均通过；命令可见性不触发执行。129 项聚焦测试通过，3 项既有平台用例跳过，未算通过。同步新主干后，真实隔离安装手册及 48 项安装/doctor/host 用例再次通过；11 个最终差异 blob 与已测前一 head 相同，已核验依赖和边界失效范围。帮助/真实隔离安装手册、书籍、版本、发布物和 auto-research smokes 全部通过；Ruff 零问题，mypy 的配置范围 19 文件通过。前端发布构建校验通过且保留上一交付资源。初次并发依赖安装造成的文件读取冲突已顺序重跑通过，未修改断言。

native premerge 全部选定检查通过，零未解决 hold；最终质量 receipt cqr_d8dd14f2456dc97cb857 对应该精确 scope。差异语义 advisory 与公开边界检查通过；没有私有状态、日志或凭据进入改动。未改 UI 首屏、Lark/CLI 配置入口、PostgreSQL authority 或用户安装路由，因此无新增 companion 页面或真实 PG 重构验证要求。

最终合入提交仍需执行 pytest、Ruff、mypy、风险 canary、完整 public fleet、安装/升级/host、公开边界及真实默认 Doubao 八组发布验证。此评审不把旧 head 的结果移作最终 release 证明，也不声明完整发布或模型通过。

我的整体评价

APPROVE：这是完整而可回退的发布准备阶段，修复两个已交付契约的消费者问题，复用现有 owner。按用户恢复发布的授权完成合入后，继续在最终提交上验证、发布 tag/包和更新入口。本 Goal 不查询或等待 PR CI；没有未解决源码 blocker。

English verdict: APPROVE - exact head 2cb9505. Eleven focused release-preparation paths reuse canonical version/help/classification/bootstrap owners. 129 tests pass, three platform skips are disclosed; manual installer, book, version, artifact and demo smokes, Ruff, mypy, frontend build, native premerge and exact-scope quality pass. No migration execution or authority change. Final release qualification remains required on the merged commit before publication.

[huangruiteng]

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

Reviewed exact head: 2e91aa19202e47faf4c8ae173192345b3b2729dd; base: f03ac9d89dccb67c71e0deea6ef999f6f7f95ddc.

动机

用户恢复 v1.2.4 发布。这个已有 PR 先准备可冻结的版本源码，并修复迁移命令缺失于帮助目录、公开示例仍硬编码旧状态目录这两个实际兼容问题。合并此 PR 不等于发布验证完成。

改动思路

沿用已有 package/runtime 版本镜像、COMMAND_GROUPS 与生成手册，以及 bootstrap 的 state_file 返回值。Python 留在既有打包、文件系统和示例适配层；没有新增控制面决策源、权限或迁移执行器。相关小重构已去掉 demo 重复的目录知识，没有新增 helper。

具体改动

• loopx/__init__.py 与 pyproject.toml 同步为 1.2.4，四份中英 Developer Book 当前锚点随版本更新。
• help_surface.COMMAND_GROUPS 收录现有 migrate-local-state --help；man/loopx.1 由同一目录渲染，明确离线预览、停止 writer 与凭据绑定回退。
• CLI_OUTPUT_COMMAND_CLASSIFICATIONS 按精确 command id 使用既有 explicit_cold_path_exception。这条离线命令不进入自动轮询热路径，也不放宽任何输出预算。
• _seed_visible_demo_control_plane 使用 bootstrap 返回的实际状态文件；现有 worker-loop smoke 按新安装 .loopx 路由检查。已有登记旧目录仍由原 bootstrap/路径 owner 决定，没有搬动数据。

对主干的风险

完整差异仅 11 个文件，24 行增加、11 行删除。最强反例是版本镜像不一致、示例误写另一状态路径，或帮助出现被误认为迁移授权。现有版本不匹配、迁移 plan/receipt/活跃 writer 拒绝用例均通过；命令可见性不触发执行。129 项聚焦测试通过，3 项既有平台用例跳过，未算通过。同步新主干后，真实隔离安装手册及 48 项安装/doctor/host 用例再次通过；11 个最终差异 blob 与已测前一 head 相同，已核验依赖和边界失效范围。帮助/真实隔离安装手册、书籍、版本、发布物和 auto-research smokes 全部通过；Ruff 零问题，mypy 的配置范围 19 文件通过。前端发布构建校验通过且保留上一交付资源。初次并发依赖安装造成的文件读取冲突已顺序重跑通过，未修改断言。

此前 2cb9505 的 native premerge 14 项检查通过；最终差异的 11 个 blob 及所有 production/build dependency 未改变，新增主干仅修改两个不相关恢复测试，已完整核验。当前 head 再运行版本负向、book、diff、静态检查和严格质量校验，作为相同风险边界的验证集合，零未解决 hold；最终质量 receipt cqr_6db5618d59f5e5379982 对应该精确 scope。差异语义 advisory 与公开边界检查通过；没有私有状态、日志或凭据进入改动。未改 UI 首屏、Lark/CLI 配置入口、PostgreSQL authority 或用户安装路由，因此无新增 companion 页面或真实 PG 重构验证要求。

最终合入提交仍需执行 pytest、Ruff、mypy、风险 canary、完整 public fleet、安装/升级/host、公开边界及真实默认 Doubao 八组发布验证。此评审不把旧 head 的结果移作最终 release 证明，也不声明完整发布或模型通过。

我的整体评价

APPROVE：这是完整而可回退的发布准备阶段，修复两个已交付契约的消费者问题，复用现有 owner。按用户恢复发布的授权完成合入后，继续在最终提交上验证、发布 tag/包和更新入口。本 Goal 不查询或等待 PR CI；没有未解决源码 blocker。

English verdict: APPROVE - exact head 2e91aa1. Eleven focused release-preparation paths reuse canonical version/help/classification/bootstrap owners. 129 tests pass, three platform skips are disclosed; manual installer, book, version, artifact and demo smokes, Ruff, mypy, frontend build, native premerge and exact-scope quality pass. No migration execution or authority change. Final release qualification remains required on the merged commit before publication.