用途：在 maestro-flow 工作流中归档一个已完成的里程碑（milestone），并把项目状态推进到下一阶段。
主要能力：校验里程碑审计报告（要求 Verdict 严格为 PASS）；把各产物的 scratch 目录复制到 .workflow/milestones/{milestone}/artifacts/；对含 archive.json 且 lifecycle.status 为 sealed 的产物进行归档标记，并按非破坏性规则修剪 context-package.json 生成 context-package.pruned.json；快照 roadmap.md；从任务总结和 reflection-log.md 提取经验，去重后以 <spec-entry> 格式追加到 .workflow/specs/learnings.md；进行知识提升询问、约定漂移检查与 wiki 连接提示；把产物从 state.json.artifacts[] 移入 milestone_history[]；推进 current_milestone 或标记项目完成；清理 scratch；生成 summary.md 并更新 project.md 的 Context 段。
使用方式：$maestro-milestone-complete "M1"；$maestro-milestone-complete（使用 state.json 中 current_milestone）；$maestro-milestone-complete --force "M1"（跳过审计检查）。输出目录为 .workflow/milestones/{milestone}/。
错误码：E001 未提供里程碑标识；E002 审计未通过，需先运行 milestone-audit；E003 仍有未完成产物。--force 可绕过 E002 与 E003。
限制：仅依据资料整理，未提供收费、平台、性能等额外信息；具体行为取决于本地 .workflow 目录状态。