WIP refactor(tower): rebase worktree before merge

[tpoisonooo]

Requirement or Bug

背景与问题

Tower 目前的多 worker 编排主要依赖 prompt 约束和顺序执行，实际使用中暴露出四类问题：

1. 热点文件冲突导致并行收益下降
   多个 mission 同时修改 config.go 等高频文件时，很容易在 merge/rebase 阶段集中发生冲突。冲突最终仍要串行处理，导致多个 worker 的实际交付速度接近线性。

2. 用户调整 worker 行为不够及时
   Worker 主要通过下一次主动读取 inbox 获取新指令。用户中途调整需求时，消息可能要等 worker 当前任务结束后才会被处理。

3. 切换 base 的约束过硬
   /tower <base> 同时受当前 checkout、已有 commit 和未完成 worktree 状态影响。只要仍有 mission 未完成，切换 base 就很容易产生冲突或被迫等待。

4. 机械编排过度依赖 LLM
   状态判断、完成通知、review 路由、merge gate 和状态展示都由 prompt 指导 LLM 执行。规则容易在多处实现中漂移，也会增加上下文和 token 开销。

行为调整

热点文件允许并行开发，交付仍按序集成

多个 worker 可以并行修改同一个热点文件。Mission 仍然按照依赖关系或明确的 scope 规划交付顺序，但不再要求开发阶段完全串行等待。

合并前由 Tower 使用 TowerRebase 将 mission branch 更新到当前 base：

• 无冲突：继续原合并流程，并保留原 clean review 的 exact-tip 绑定；
• 有冲突：标记该 mission 需要 worker 处理，由 worker 在对应 worktree 中解决；
• 非冲突类 git 错误：不会误报为 conflict，而是返回明确的恢复要求。

这样可以减少开发阶段的等待，同时保留集成阶段的确定性。

用户指令更快传递给 worker

TowerSend 的消息仍会先持久化到 inbox。对于正在运行的 worker，消息会 steer 到当前 turn，在下一个步骤边界可见。

正在执行的 tool call 不会被打断，避免工具调用中途失败或产生不完整状态。需要立即停止 worker 时，仍应使用显式的 stop/cancel 操作，而不是依赖普通消息。

支持存在未完成 worktree 时切换 base

/tower <base> 支持在仍有 open missions 时 re-anchor base。系统会逐个 mission 返回：

• no-branch：branch 尚未创建；
• up-to-date：已经包含新 base；
• stale：需要先执行 TowerRebase。

只有 stale mission 需要 rebase，不再笼统要求所有 worktree 先完成。

边界仍然保留：base 必须是本地分支，最终 merge 仍要求主 checkout 位于记录的 base 上。

重构内容

这次重构的核心是：将机械协议从 prompt 驱动改为代码驱动，只把需要判断的工作留给 LLM。

统一 merge 判定

新增统一的 mission gate evaluator，供 Status、Merge 和 wake digest 共用，避免同一规则在多处实现中漂移。

代码现在统一检查：

• mission 是否 completed；
• open tasks 和 blockers；
• worker 是否仍在运行；
• 依赖是否已关闭；
• review 是否为 clean + merge；
• hold、fix-then-merge 是否阻断；
• reviewed tip 是否匹配，或是否符合 clean-rebase waiver；
• scope、base、dirty files 和 branch SHA。

Merge 使用固定 SHA 执行，避免检查完成后 branch 被继续移动。

确定性完成与通知

新增 TowerComplete(report)：

• worker 只负责编写完成报告；
• 代码统一检查任务、blocker、diff 和未读消息；
• build mission 自动生成 review-request；
• survey mission 自动生成 survey-summary；
• 避免漏发、重复发送，以及完成状态与通知之间的竞态。

Review 提交后，代码也会自动将 review-result 路由给正确的 owner/tower，不再要求 reviewer 手工发送通知或 resume 其他 Agent。

加强消息与并发协议

• Inbox 改为按 message ID ack，分页不再吞掉未展示的旧消息；
• wake 携带消息引用和紧凑的 gate digest；
• spawn、resume、merge 和 rebase 使用 branch lease，减少托管写操作之间的竞争；
• Status 和 Merge 使用同一份 gate 结果，不再各自解释 review/base 状态。

/tower status 不再启动 LLM

/tower 与 /tower status 改为通过 SDK 直接读取并本地渲染状态，不再向主 Agent 发送提示词。

公共 SDK 只暴露该命令所需的最小状态文本接口，不把内部 mission、roster、review 和 gate 结构泄漏给客户端。

LLM 仍负责需要判断的工作：

• 拆解 mission；
• 编写和调试代码；
• 核对任务与实际 diff；
• review 代码质量；
• 处理 rebase/merge 冲突；
• 诊断异常 worker 并决定恢复方式。

兼容性说明

• 以前存在 open tasks、blockers、未完成 mission 或 review 未明确批准时，部分 branch 仍可能被合并；现在这些路径会被拒绝。
• clean + hold 和 clean + fix-then-merge 不再被视为 merge-ready。
• 只有 clean + merge 且 branch tip 满足绑定条件的 review 才能批准合并。
• 直接通过通用 mission patch 写入 merged 的旧路径不再可用；只有 TowerMerge 可以记录 merged。

效果

• 热点文件可以在开发阶段并行修改，冲突集中到明确的 rebase/merge 边界处理；
• 用户发送给运行中 worker 的指令可在下一个步骤边界生效；
• 未完成 worktree 不再阻止切换 base，只有 stale branch 需要 rebase；
• /tower status 不再消耗 LLM 请求；
• 完成、review 通知和 merge 判定由代码统一执行，减少协议漂移；
• Tower full reminder 从 11,583 字符降至 6,354 字符，减少约 45%；
• 减少机械编排消耗的 token，但不改变 worker/reviewer 完成实际判断所需的成本。

[changeset-bot]

🦋 Changeset detected

Latest commit: b1dc66c

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@moonshot-ai/kimi-code	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[pkg-pr-new]

pnpm dlx https://pkg.pr.new/@moonshot-ai/kimi-code@b1dc66c

npx https://pkg.pr.new/@moonshot-ai/kimi-code@b1dc66c

commit: b1dc66c

[tpoisonooo]

• 增加 tower 和 goal 互斥
• 给 LLM 误删 .tower 做简单规避 && 兜底（无法完全避免）