Module plan 

Structs

Issue

格式问题。 验证发现的格式问题。

VersionProgress

单个版本的规划进度。

Functions

clean_roadmap

删除 ROADMAP.md 中所有已完成条目。

doctor_roadmap

诊断并修复 ROADMAP.md 的格式问题。

is_version_line

检测一行是否为版本标题，成功时返回版本号（去除 v 前缀）。 支持 ## [X.Y.Z]、## [X.Y.Z] — 已发布、## [vX.Y.Z] 等格式。

parse_roadmap

解析 ROADMAP.md，返回各版本进度列表。

print_status

格式化输出 scope 规划进度。

print_status_to

写入指定 writer 的版本（可测试）。

resolve_roadmap_path

解析 scope 参数，返回实际 ROADMAP.md 路径。