# Changelog

## v1.3.0 - 2026-05-14

- **基础设施对齐 (Infrastructure Alignment)**:
    - 升级 `apigo.cc/go/log` 至 `v1.3.2`。
    - 引入 `apigo.cc/go/timer` 模块支持 (预留用于未来更精细的时间调度)。
- **代码重构与类型对齐**:
    - 将 `Task.entryID` 类型从 `int` 修改为更严谨的 `cron.EntryID`。
    - 移除不必要的类型转换。
- **性能优化与基准测试**:
    - 新增 Benchmark 覆盖任务注册、获取与列表操作。
    - 优化了测试用例的稳定性，特别是优雅退出的验证。

## v1.2.0 - 2026-05-12

- **基础设施对齐 (Service Interface)**: `Scheduler` 现在实现了标准 `Service` 接口 (`Start`, `Stop`, `Health`)。
- **API 变更 (Breaking Change)**: 移除顶层 `task.Start()` 和 `task.Stop()` 函数。必须通过 `task.DefaultScheduler` 进行生命周期管理。
- **生命周期优化**:
    - `Start(ctx, logger)` 支持传入自定义 Logger。
    - `Stop(ctx)` 现在由调用方通过 `context` 控制优雅退出的超时时间。
- **健壮性增强**: 增加 `Health()` 接口用于基础设施监控。

## v1.1.0 - 2026-05-10

- **API 重构 (Breaking Change)**: `Add` 签名变更为 `Add(name, spec, func(context.Context) error, ...Config)`。
- **配置模式优化**: 引入 `Config` 结构体替代 Functional Options，遵循 AI-First 极简主义。
- **生命周期增强**: 
    - 增加显式的 `Start()` 和 `Stop()` 方法。
    - `Stop()` 支持优雅退出，自动取消任务 Context 并等待运行中的任务完成（默认 30s 超时）。
- **健壮性提升**: 
    - 内置 `recover` 机制，防止单个任务 Panic 导致调度器或进程崩溃。
    - 移除冗余且危险的 `PolicyQueue` 策略，推荐使用 `PolicySkip` 结合外部队列。
- **基础设施对齐**: 
    - 集成 `@go/log` 实现标准化的异步元数据日志记录。
    - 对齐 `apigo.cc/go/cast` 和 `apigo.cc/go/log` v1.3.0 标准。

## v1.0.0

- `New` 核心调度器实现，支持并发策略 (Parallel, Skip, Queue)。
- `New` 支持生命周期钩子 (OnSuccess, OnError) 和超时控制。
- `New` 支持通过对象方法对任务进行管理 (Disable, Enable, Remove)。
- `New` 支持全局查询任务列表和任务状态。