Skip to content

0.8.0:任务分流、spec 锁外预检与维护验证

Choose a tag to compare

@Inmata Inmata released this 30 Oct 08:05

自 v0.7.0 以来,任务分流、spec 检查和接入预检得到改进。

主要变化

  • 新任务必须明确声明 route(operation-only、lead-direct 或 delegated);已有历史任务保留兼容路径。
  • task-end 和 Stop 的 spec Git 预检移到状态锁外,并绑定提交、spec、受管文件和索引快照;检查期间发生变化时拒绝过期结果。
  • 预检 Git 调用共享从检查开始计算的 4 秒截止预算。同步文件快照无法强制中断,锁内 ref 复核另有预算,因此这不是整个 Hook 的严格 4 秒上限。
  • onboard 先完成核心预检,再调用配置的执行器;PowerShell 参数按字面传递,兼容参数还原需要显式启用。
  • 对齐读取故障报告 errors 并标记 stale/incomplete;未应用的对齐事务保持 pending 可见。
  • 为仓库维护新增 npm run verify,组合已有检查并保留日志和摘要;明确直接调用协议函数时的回滚责任。

耗时实测

同一台 Windows 机器、合成宿主事件和小型 spec 夹具下,普通路径无稳定提速证据;正常 spec 收尾中位数增加约 65–73 ms。注入慢 Git 时,竞争者拿锁从 0/3 超时变为 3/3 成功、等待中位数约 6 ms。模拟 Git 超时的单次诊断样本中,拒绝回执从约 10.28 秒降到 4.24 秒。该测量不代表真实宿主端到端耗时,也不验证严格超时上限。

完整方法、174 个样本和复现脚本见基准报告。

升级

Claude Code 和 Codex 共用安装入口,升级时请在没有活动任务时按仓库 README 的安装说明更新两个宿主,并在新会话验证入口。已有项目无需仅因升级而重新接入。