用途:归档已完成的计划与路线图里程碑。它把 paths.plans/ 下已完成的单文件计划或 ultra 计划目录移入 paths.archive/plans/,并可选地将 ROADMAP.md 中已关闭的里程碑裁剪为 paths.archive/roadmap/ 下的日期快照。
主要能力:读取 .ai-factory/config.yaml 解析路径与 plan_id_format(默认 slug);支持交互模式、list、--roadmap、--all 和指定计划名等模式;通过 ## Tasks 中所有复选框是否为 - [x] 判断完成;移动前做目标冲突检查,不覆盖已有文件;ultra 目录会校验入口标记与 Phase Index;归档后为完整计划写入 YAML frontmatter 的 archived 字段,为 ultra 在标记后插入 <!-- aif:archived:YYYY-MM-DD -->。
使用方式:无参数进入交互选择;list 查看归档内容;--roadmap 裁剪已关闭里程碑;--all 归档全部已完成计划(需确认);<plan-name> 归档指定计划。
限制:不归档未完成计划;--all 与 --roadmap 需确认;不修改 paths.plan 与 paths.fix_plan;归档计划不参与顺序编号扫描;目标已存在时不覆盖,单计划报错、批量跳过。