# CHANGELOG
## [0.2.0] - 2026-07-05
### Added
- 新增 pre_publish 配置（package archetype）
### Changed
- 重构源代码版本管理模块：合并 language 到 config_file，重命名 VersionSource 为 TagSource，分解 version 为 git_tag 和 config_file，迁移 git 后端至 gix，集成 semver 并调整相关测试
- 模块边界清理，完成 SourceType 接线及 verify_version 重命名，移动 read_config_versions 至 source::version
- 添加 GitSubmoduleEditor 及 submodule 示例，更新文档以反映 gix 优先的混合策略
- 将默认测试阈值从 70% 提升至 80%，清理完成的路标项
### Removed
- 移除 contract.yaml（功能已由 auto-detect 覆盖）
## [0.2.0-alpha.1] - 2026-07-05
### Changed
- **破坏性重构**：`source::git` → `source::git_tag` + `source::config_file`，职责分离
- **破坏性重构**：`version_status` → `verify_version`，移至 `contract::version`
- **破坏性重构**：`VersionStatus` → `VersionState`，命名反映多字段快照语义
- **破坏性重构**：`detect_language_by_files` → `source::language::detect`
- **破坏性重构**：`read_all_config_versions` → `source::config_file::read_config_versions`
- **破坏性重构**：`VersionSourceError` → `TagError`
- git tag 读取从 `git2` 迁移至 `gix`（快 14x）
- 引入 `semver` crate 替代手写 semver 解析
- `Contract::load()` 现在展开 `Auto` → `SourceType::detect()`
- 测试文件按模块一一对应拆分（contract_* / source_*）
- 所有测试零 CLI git 依赖
### Added
- `VersionSource` trait（原 `TagSource`）
- `source::language` 模块
- 35 个单元测试覆盖纯逻辑全分支
- 7 个集成测试覆盖 I/O 边界
- 10 个版本号异常场景测试（pre-release、build metadata、大写 V）
## [0.1.5] - 2026-07-03
### Added
- `source::roadmap` 模块：ROADMAP.md 解析、进度统计、格式验证（纯文本，零新增依赖）
- `RoadmapVersion`、`RoadmapProgress`、`RoadmapChecklistItem`、`RoadmapIssue` 类型
- 101 单元测试覆盖解析、进度统计、格式验证、v 前缀标准化
- 5 集成测试覆盖端到端解析、错误显示、真实文件验证
### Fixed
- `test-rust` CI coverage 阈值检查：LCOV 直解析增加空 LF/LH 守卫和除零防护
### Coverage
- 行覆盖率：98.85%（514 / 520）
- 全部 142 测试：101 单元 + 36 集成 + 5 文档
## [0.1.4] - 2026-07-03
### Added
- `source::changelog` 模块：CHANGELOG 解析、release notes 提取、版本存在性校验（`parse-changelog`）
- 集成测试套件：15 个测试覆盖 contract 加载、SourceType 检测、Registry 序列化
- `.githooks/pre-commit`：Rust 变更自动跑测试
- `test-rust` CI workflow：release 触发，build + test + coverage 阈值 95%
### Changed
- 依赖：新增 `parse-changelog = "0.6"`（零额外依赖）
- `contract/mod.rs` 的 `load()` / `load_from_str()` 调用者以外不再直接使用
- `contract/source.rs` 的 `SourceType::detect()` 通过集成测试覆盖全部 5 种文件
### Coverage
- 单位测试覆盖率：98.39%（区域）/ 99.31%（行）
- 全部 115 测试：75 单元 + 36 集成 + 4 文档
## [0.1.3] - 2026-07-03
### Added
- `source::git` 模块：Git tag 读取、scope 过滤、版本一致性检查
- `GitSourceError` 类型化错误处理
- `VersionStatus` 版本一致性检查结果
- semver 排序（修复字符串排序 `v10 < v9` 问题）
- 43 单元测试覆盖 tag 读取、scope 过滤、semver 排序
### Changed
- 依赖：新增 `git2 = "0.19"`（必选）
- `contract/source.rs` 保持单文件，`source/` 以顶层模块存在
- `lib.rs` 新增 `pub mod source`
## [0.1.2] - 2026-07-02
### Changed
- `contract/model.rs` 拆分为 4 个独立模块：`stage.rs`、`platform.rs`、`source.rs`、`scope.rs`
- `model.rs` 更名为 `core.rs`
### Added
- `version.rs` 独立模块（已有，确认结构）
- README.md、CHANGELOG.md（首次补充）
## [0.1.1] - 2026-07-02
### Added
- `Language::as_str()` / `BuildTool::as_str()` 显示方法
- `Registry: Display`
- `SourceType::detect()` 按文件自动检测
- `Contract::validate()` 契约验算（scope 目录存在性检查）
- `validate_version()` / `normalize_version()` 版本号工具
- `read_all_config_versions()` 配置文件版本提取
- 可选的 `clap` feature（`SourceControl` / `Pipeline` / `Registry` / `SourceType`）
- `version.rs` 独立模块（31 单元测试 + 4 文档测试）
## [0.1.0] - 2026-07-02
### Added
- 四维契约模型：`Stage` / `Platform` / `Source` / `Scope`
- YAML 序列化（`serde` 直接标注，零镜像类型）
- 枚举类型替代字符串：`SourceControl`、`Pipeline`、`Registry`、`Language`、`BuildTool`
- `Contract::default()` 全维度默认值
- 便捷访问器：`scope_release()`、`scope_test_threshold()`、`find_scope_by_path()`
- `detect_language_by_files()` 语言探测
- `ContractError` 类型化错误处理