# Changelog

yms-daemon 面向用户的版本历史，遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/) 风格与语义化版本（SemVer）。

当前版本：**0.1.0**（POC 阶段，尚未达到 RC/GA）。

版本号策略：POC 阶段沿用 `0.1.x`；功能达到 RC 时发布 `0.1.0-rc.N`（或按规模升 `0.2.0-rc.N`）；达到 GA 时发布 `1.0.0`，并把对应条目从 `[Unreleased]` 移入正式版本号。

## [Unreleased]

### Added

- 命令入口拆分：`ymsd`（守护进程，监听 Unix Socket）/ `ymsctl`（运维 CLI），chrony 风格分离。
- backend native 更新：repack ZIP（`-f`）与直传 JAR（`--native-jar`）两种互斥输入。
- backend container 更新：`--container-image`（pull 后冻结 repository digest，蓝绿切流，含全新机器首次部署）。
- 同版本零停机重启：`ymsctl restart --service backend`（native + container）。
- 历史查询：`ymsctl list [--limit/--service/--state/--json]`。
- 诊断与对账：`ymsctl status` / `doctor` / `reconcile [--apply]`。
- 宿主 Nginx 蓝绿切流：managed upstream 块 + `nginx -s reload`。
- 服务端 SQLite 事务、步骤幂等与 backend container 部署记录。
- 启动日志跟随：update / restart 期间实时输出容器启动日志，直到 Actuator 健康。

### Changed

- 更新命令由旧 `yms-daemon update` 迁移为 `ymsctl update`。
- `hostnginx.NewController` 简化为两参数，重载改走 `nginx -s reload`。
- 容器停止旧容器改为显式超时（默认 30 秒后强制终止），可通过 `backend.stop_grace_seconds` 配置，覆盖原先 9000 秒 StopTimeout。
- 示例配置 `yms-daemon.toml` 同时给出 native / container 两套 `[backend]` 块与切换说明。

### Known limitations

- native 后端的 `reconcile --apply` 尚无自动修复项（JAR 链接漂移修复待实现）。
- `rollback`、`frontend`/`nodeSsr`/`all` 更新入口、离线 repack 交付尚未实现。