Repository navigation
[Enhancement] 补齐 SDK 生命周期与升级兼容性，并跟踪 legacy 队列替换 #533
Description
对照 liujuanjuan1984/codex-a2a#338 审查 SDK 1.1.5 适配。实现及回归见 Draft PR #534。
- 修复执行异常的失败持久化、队列与后台资源清理。
- 关闭时排空缓冲输出，再补写失败状态并释放依赖；GetTask 复用 SDK 校验。
- 补齐旧数据库升级工具、事务转换、身份保留、终态保护和查询回归。
- 替换 EventQueueLegacy/LegacyRequestHandler，保持输出协商、身份、取消、订阅、断连和关闭契约。新版 handler 忽略第二个完整 Task，且强制关闭不提供当前输出排空语义，需要适配事件和生命周期。
#534 使用 Refs，合并时不关闭本 issue。最新修复 34a9f81；doctor 通过 907 项测试，覆盖率 93.46%；协议检查 8/8、远端 5 项 CI 全部通过。
Activity
liujuanjuan1984 commentedon Sep 29, 2026
已开始在
chore/review-sdk-lifecycle独立 worktree 实施。范围：producer 异常持久化和可靠清理；handler 显式关闭与 lifespan 顺序；GetTask 委托上游校验；回归和文档。保持客户端断连继续执行。服务关闭取消本地执行并在存储可用时持久化 FAILED，不等同于远端 OpenCode 会话已 abort。EventQueueLegacy 整体迁移本次明确边界和后续触发条件，不直接替换父类。完成 doctor、协议探针与 Python 兼容验证后发起 Draft PR。liujuanjuan1984 commentedon Sep 29, 2026
实现已交付 Draft PR #534（
ded7a23），等待审核。新增 42 项回归，完整 doctor、Python 3.11–3.14 各 873 项测试、8/8 协议探针通过；覆盖率 93.45%。issue 顶部已同步实施状态和验收勾选，原审查快照与复现证据保留。当前远端 5 项 CI 运行中。liujuanjuan1984 commentedon Sep 29, 2026
最终验证：#534 的提交
ded7a23远端 5 项检查全部通过，包括默认工具链（运行时安全审计、wheel/sdist 安装冒烟）、Python 3.11/3.12/3.13 矩阵和 protobuf 6 兼容性。PR 保持 Draft，等待人工审核，尚未合并。主目录保持干净的最新 main，独立开发 worktree 已提交并推送且工作区干净。fix(server): preserve terminal drains and shutdown barriers (#533)
fix(storage): make historical database upgrades reproducible (#533)
[-][Enhancement] 补齐 SDK legacy handler 的失败持久化与关闭生命周期，并规划队列迁移[/-][+][Enhancement] 补齐 SDK 生命周期与升级兼容性，并跟踪 legacy 队列替换[/+]docs: condense lifecycle and upgrade guidance (#533)
fix(server): drain buffered output before shutdown failure (#533)