用途：帮助开发者安全、渐进地完成 MaintainX API 版本升级，处理弃用与破坏性变更。
主要能力：审计代码库中的 API 调用；构建版本兼容层，通过请求/响应适配器在 v1 与 v2 间转换；用功能开关按端点逐步迁移；编写迁移测试验证 v1/v2 等价性；提供回滚流程。
使用方式：先运行审计脚本扫描 src 目录中的 API 调用并按端点分组；再实现 VersionedClient 与适配器（如 v2 将 assignees 映射为 assignedTo）；通过 MIGRATION_FLAGS 控制各端点版本；用 vitest 测试等价性；必要时按 rollback-api-version.sh 回退。
适用场景：已有 MaintainX 集成、需要升级 API 版本或处理弃用的项目。
限制：需现有集成、独立测试环境 API key 与版本控制；示例中的字段映射与端点仅为示意，实际变更需以官方 API 参考为准；资料未提供具体收费、平台支持范围与效果数据。