标准诊断顺序
.comet/config.yaml中启用的 workflow、native.artifact_root和native.clarification_mode是否正确;comet native status是否能看到目标 change;.comet/current-change.json是否选择了正确 workflow/change;status --details返回的 phase、findings、checkpoint、acceptance page 和 continuation;- doctor 是否报告未完成事务、陈旧锁、workspace 身份或证据清理问题。
acceptancePage.nextCursor 非空时,使用 --acceptance-cursor 逐页获取;不要把当前页面之外的验收项当作不存在。
跨设备找不到 change
Native 只从配置的 artifact root 发现 change。同步了docs/comet/changes/...,但另一台设备的 .comet/config.yaml 缺失、仍指向 . 或启用了另一套默认 workflow 时,resume-probe 会正确返回“没有可恢复 change”。change 自己的 comet-state.yaml 不会反向选择项目根目录。
处理步骤:
- 确认已同步的真实目录,例如
docs/comet/changes/<name>; - 在目标设备通过
comet init --workflow native --root docs恢复匹配的项目配置和托管资产,或恢复可信的.comet/config.yaml; - 运行
comet native status和show; - 目标无歧义后运行
comet native select <change-name>; - 再从
/comet或/comet-native继续。
未完成 transition
普通 phase 推进会先写runtime/transition.json,再更新 Run state、comet-state.yaml、trajectory 和 checkpoint。中断后,status 与 doctor 会报告 recovery required。
普通 transition 只支持继续:
Archive 与 root move 中断
Archive 和 artifact root move 是多步骤事务。doctor 会根据 journal 所处阶段说明能否continue 或 rollback:
.comet/config.yaml 中出现 native.pending_root_move,先运行 doctor。不要手工删除该字段或直接移动目录。
Baseline 或验证证据异常
锁与 evidence retention
普通new、next、archive 和 root move 不会自动接管看似超时的锁。只有显式 doctor --repair 会在本机 owner 已不存在、锁身份未变化且没有冲突事务时接管。活动锁或无法证明来源的锁保持不动。
Evidence retention 默认只报告候选。显式 repair 仅清理 active change 中至少 30 天、每种 evidence kind 最新 32 份之外且依赖闭包证明未引用的派生证据;归档证据、当前引用、未知文件和恢复中的事务不会被清理。

