Repository navigation
Protect archive rollback across authority roots and concurrent recovery - #8906
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; model=gpt-6.1-sol; provider=OpenAI; declaration=runtime_reported; effort=max.
Request changes conclusion (author-owned PR; GitHub blocks formal self-review)
动机 / Motivation
用户切回 2.3.0 后,需要用原来的权威存储继续任务。基线在 File 和 SQLite 上均能通过归档格式检查和两项 Doctor,随后旧版 todo list 拒绝 70 字段的 Todo。本提交在常规源路由能提前拒绝,兼容的 68 字段仍可回退并读回原回执。配对快照恢复和并发状态写入由整版发布验收。 发布操作契约 · 2.3.0 实发包
改动思路 / Approach
让目标版本自己的 Todo 解码器判断可读性,核对实际 provider 和 revision。归档回退替换全局启动链接,所以每个已登记的权威来源都需要对应的读回结果。 Todo 预检
具体改动 / Changes
核对基线的 Supported Install And Update Paths,以及本提交承诺的已登记来源的 Todo 可读性。 发布操作契约
authority_upgrade_roots和authority_upgrade_registries从归档 CLI 移到现有 Goal 生命周期服务。格式检查继续使用同一套来源发现。预检调用目标版本的普通todo list,核对 Goal、provider 和 revision,再替换启动链接并运行 Doctor。 注册来源解析 · 格式检查分发- 新测试覆盖正常源路由、旧版拒绝、revision 不符、fallback 和预检期间启动链接被替换。发布文档说明不兼容时会在切换前拒绝。 回退回归 · 发布文档
对主干的风险 / Risks
[P2] 显式指定另一个运行时根时,会漏检源项目的权威 Todo。 源 registry 登记的根是 A,B 的全局 registry 有同一项目的镜像。执行 loopx --registry PROJECT_REGISTRY --runtime-root B update --rollback previous 时,预检把源 registry 解析到 B,又因源 registry 已被发现而跳过其他镜像。A 的存储没有进入预检。用实发 2.3.0 和候选 wheel 在 File、SQLite 上复验,两种后端均返回 0 并切到 2.3.0,按 A 正常读 Todos 随即返回 canonical_snapshot_request_invalid,原权威数据字节保留。请检查源 registry 自身配置的根和调用覆盖的根,按照实际权威来源去重,并验证候选会在替换启动链接前拒绝。 覆盖根与镜像跳过
并发回退的失败恢复仍可覆盖另一条已成功的操作。 我让第一次切换后的 Doctor 等待,在第二次原生回退成功后使第一次 Doctor 失败。基线和候选都会把启动链接改回第一次操作之前。预检中途发现启动链接改变时,候选会保留第二次结果。切换后的失败恢复需要持有同一启动链接的变更权,或在条件不匹配时保留第二次结果。 预检后的链接检查 · Doctor 失败后的恢复
常规 70 字段路径在候选上拒绝切换,原启动链接、权威字节和回执保持一致。两种 68 字段的路径都能切换、通过两项 Doctor 并读取相同 revision。源码测试 72 项通过、6 项跳过。Lark 导入边界在基线和本提交均复现 native_chat.queue_api 到 lark.private_ingress 的导入。
我的整体评价 / Verdict
请求修正源 registry 的运行时覆盖路径。用同一组可读和不可读的 File、SQLite 数据复验,确认指定其他运行时根后,已登记的活动任务仍能阻止不可用的旧版本切换。
English verdict: REQUEST_CHANGES at 7f3c882. An explicit runtime override skips the registered authority and reports successful rollback to an unreadable 2.3.0 Todo on both local providers.
…e-before-rollback-20261117 Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com>
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; gpt-6.1-sol; OpenAI; reasoning effort max; runtime_reported.
Approval conclusion (author-owned PR; GitHub blocks formal self-approval)
Reviewed head: 8906@166f39e984aaa6e4e58e0e627fd8eecc4ebee6c5; actual base: d210e4cc1d002f92498b2811c565b9430e79f4c1.
动机 / Motivation
需要把本地 archive 安装回退到旧版本、并继续处理原任务的用户和维护者。以前回退只检查归档格式,项目配置根 A 与命令覆盖根 B 同时存在时会漏检 A;切换到旧版本后,用户可能仍有数据却读不到任务。并发失败恢复还可能覆盖另一进程刚完成的链接。现在会用待激活版本读回当前权威 Todo,并在替换链接前拒绝不兼容状态;失败操作只恢复自己仍持有的链接,保留其他已完成的替换。本次交付是本地 File/SQLite archive 回退的读取预检和安装链接恢复,整版发布、状态写入者协调及匹配备份恢复仍沿原 release 验收。
改动思路 / Approach
回退预检复用 Goal activation 的已登记路由发现,并共享安装器已有的 promotion guard;Todo 来源、版本和回执仍由现有 typed authority owner 判定。当前 PR 只修复回退前可读性和本次链接的失败补偿,不创建第二份状态、不自动降级数据,也不把安装锁当作状态写入者锁。仅补 CLI 参数检查不能覆盖其他已登记根,也不能解决补偿覆盖;复用原路由 owner 和现有安装 guard 是两项已证明失败的最小同域修复。入口、事实来源、拒绝和恢复的关系如下;表格是源码说明,实际验证另列。
| 触发 | 判定与结果 |
|---|---|
| 合法原请求 | update --rollback → configured and overridden registered routes → target todo list → same provider/revision proof → existing promotion guard → symlink replacement → Doctor/extension Doctor → inode-owned compensation |
| 失败或重试 | 沿原 authority/operation owner 拒绝或恢复原回执,不创建新的权限身份。 |
具体改动 / Changes
规格:docs/product/release-readiness.md at d210e4cc1d002f92498b2811c565b9430e79f4c1。以改动前的已接受要求判断,新增说明不是自我验收依据。
| Criterion | 当前映射 |
|---|---|
| atomic snapshot rollback | implemented:旧版本回退后仍可读回当前任务;不兼容须保留当前运行版本。 |
| Promotion guard held | implemented:与现有安装器使用相同 guard,等待者不能绕过仍存活的安装 owner。 |
| Incomplete candidate (doctor fail) | implemented:失败候选保留或恢复可用的此前默认目标,并读回恢复结果。 |
5 文件 +342/-69;路由发现从 CLI 移到现有 activation_service,CLI 保留导入兼容。其余新增为 Todo 可读性预检、原锁及恢复条件和聚焦回归。
关键代码讲解
- def _verify_rollback_todos(:检查完整已登记路由中每个真实根/Goal;目标必须给出同 provider、同 revision 的权威读回。
- def authority_upgrade_roots(:提取已存在的发现规则,并补上 source registry 本身的配置根;按真实根与 Goal 去重。
- promotion_guard = os.fdopen:复用 releases/.install-guard,持有至预检、激活、Doctor 和恢复结束。
- if os.path.samestat(:只在当前链接 inode 仍属于本次切换时补偿,避免恢复覆盖后续 legacy 替换。
前次公开 review 5932506345 的两项问题在该 head 已有独立复验:配置根漏检和并发失败补偿均修复。没有删除或撤销历史评审。
对主干的风险 / Risks
独立重建当前基线及 exact head 的 wheel,与实发 PyPI 2.3.0 配合,16 个不同安装场景完成对照。两种后端的兼容回退成功;真实 scoped Monitor 产生 70 字段后,全局 registry 和配置根 A/覆盖根 B 四组候选均在切换前拒绝,四组基线仍切到无法读 Todo 的旧版本。原创建回执一致,权威数据字节不变。两次 native 锁竞争与 legacy 无锁替换分别验证预检、失败恢复和后续重试;新提交保留后写入的链接,基线会覆盖它。
预检与状态写入者并未共享全局事务;其他进程在检查后写入新状态仍属于 release 协调缺口。File/SQLite 本地 POSIX 路径已验证,Windows、PG 回退及整版分发未申报通过。旧版不兼容时须使用匹配备份及其原恢复流程。CI 未查询或等待,精确 head 的评审和合并资格分开。私有测试脚本首轮曾因路径、生成资产、Monitor 原执行证明或冷启动预算出错,原失败记录保留;修正验证条件后只重跑受影响场景,没有修改产品或绕过原状态 owner。
我的整体评价 / Verdict
回退预检复用 Goal activation 的已登记路由发现,并共享安装器已有的 promotion guard;Todo 来源、版本和回执仍由现有 typed authority owner 判定。当前 PR 只修复回退前可读性和本次链接的失败补偿,不创建第二份状态、不自动降级数据,也不把安装锁当作状态写入者锁。未修改渲染页面;已检查 update CLI 的拒绝、切换、失败恢复及 Todo/原回执读回,截图不适用于该边界。本次批准限定于当前可逆切片和已验证调用路径,实际长期收益、其他平台与发布采用继续按各自验收。前次公开 review 5932506345 的两项问题在该 head 已有独立复验:配置根漏检和并发失败补偿均修复。没有删除或撤销历史评审。此结论不授予合并、安装、升级或发布权限。
English verdict: APPROVE — The registered-root rollback and compensation defects are fixed at this exact head; broader release qualification remains separate.
|
Merge qualification for
The source head is unchanged. Earlier failed fixture runs and the transient GitHub-read failures remain retained; no validation or review gate has been lowered. |
Problem and result / 问题与结果
Archive rollback can switch to 2.3.0 and pass Doctor while that version cannot read the current canonical Todos. An explicit runtime-root override can also hide the registered source root. A separate concurrent rollback can lose its successful launcher switch when an earlier rollback later fails Doctor.
归档回退可能切回 2.3.0 并通过 Doctor,却无法读取原有 Todo;指定其他运行目录时还可能漏检登记的原目录。并发回退中,较早操作的失败恢复也可能覆盖较晚操作已经切换成功的启动链接。
Implementation / 实现
Validation / 验证
Tested revision:
166f39e984aaa6e4e58e0e627fd8eecc4ebee6c5, based ond210e4cc1d002f92498b2811c565b9430e79f4c1(including merged #8902).Two additional installed journeys use genuine scoped-monitor values that widen the Todo declaration from 68 to 70 fields. On both File and SQLite, native rollback to the published 2.3.0 refuses activation and leaves the current work and its idempotent replay intact. Full-state archives taken before and after those writes were verified and extracted into inert directories. With the original source runtime directory unavailable, each matching package independently read its snapshot's Todo, original receipt and lease record. These checks do not reactivate a restored Goal or reuse historical execution authority.
另以真实监控范围字段完成两种存储的完整安装包验证:写入新字段后,原生回退拒绝不兼容降级,当前任务及幂等重放保持。写入前后的成对备份经校验;原 runtime 目录不可访问时,两版均从各自隔离副本读回原 Todo、回执和租约记录。该结果限定为隔离历史读回,不代表已恢复现代 Goal 的执行权限。
The preflight proves readability at the observed revision. Coordinating concurrent state writers and qualification of the complete release with matching runtime/state backups remain separate release obligations. This change does not qualify the final 2.4.0 release, all platforms or PostgreSQL rollout. Independent review of this exact revision is pending; prior findings are not treated as cleared by author tests.
预检结论对应观察到的版本;并发状态写入协调、成对运行时/状态快照恢复及最终完整 2.4.0 发布仍需整体验证。当前提交等待独立复审,作者验证不代替评审关闭发现。