用途:pocket-closing 是 Pocket 流水线的收尾阶段,在用户明确要求关闭已评审的阶段或计划时使用;包含收尾的端到端请求也视为授权。它只做核对与关闭,不重新评审代码。
主要能力:读取 log.json 与评审结论文件,将每个可评审任务与其结论核对;仅当所有任务为 DONE、有 done_sha 且当前结论为 REVIEW_PASS 时推进阶段;追加阶段记录到 closeout.md,并调用 log close 关闭计划。会校验结论新鲜度,若评审早于当前 done_sha 则视为过期并阻止关闭。
使用方式:/pocketto:pocket-closing <path-to-execution-plan-or-plan-dir>。推进阶段使用 npx -y pocketto-pi log update <plan_dir> <phase_file> DONE --json --contract 3(仅阶段级,禁止传 --task);关闭使用 npx -y pocketto-pi log close <plan_dir> --json --contract 3。若投影写入需恢复,先运行 pocketto-pi lifecycle repair <spec_dir> --json --contract 3,再运行 pocketto-pi lifecycle drain <spec_dir> --json --contract 3。
适用场景:多阶段计划中当前处于 REVIEW 的阶段收尾;已 DONE 但缺少 closeout 段落的恢复;全部阶段完成后关闭计划。
限制:不评审、不覆盖结论,不手工编辑 log.json,不执行 GitHub 操作、不合并 PR、不关闭 issue;无当前干净结论则不推进阶段。失败或缺失结论时返回 CLOSE_BLOCKED 并给出恢复路径。Enterprise 适配器为可选,本地关闭无需它。