用途：把已有的 Auth0.swift v2 集成迁移到 v3。适用于已有 v2 集成、Xcode 可干净构建、项目处于 git 版本控制且工作区干净的情况。新集成、小版本更新、Android、React Native/Expo 项目不适用。
主要能力：按顺序执行迁移流程。先做预检与安全备份（git status --porcelain、创建备份分支、用 xcodebuild 确认可构建）；再从 Package.resolved、Podfile.lock、Cartfile.resolved 或 Package.swift 检测当前版本，并解析目标 v3 版本（校验是否为已发布 v3 标签、是否降级）；随后拉取目标标签的 SDK 源码作为 API 签名依据；接着用 grep -rl "import Auth0" --include="*.swift" . 找出所有相关文件并完整阅读，建立“使用/未使用”清单；再按包管理器更新依赖（SPM、CocoaPods、Carthage 或 Xcode 托管 SPM）；最后只对实际使用的 API 应用破坏性变更。
覆盖的变更包括：clearSession 重命名为 logout；WebAuthError 移除与新增 case；移除多余主线程派发；Request 类型改为 Requestable；CredentialsManager 的 store/clear 由返回 Bool 改为 throws；user 属性改为 userProfile() 方法；revoke 新增错误路径；UserInfo 重命名为 UserProfile；expiresIn 重命名为 expiresAt；CredentialsStorage 签名变化；移除 Management 客户端与 MFA 方法；默认 scope 与默认 minTTL 变化。
限制：每一步代码修改都以审计结果为准，未使用的 API 不触碰；不添加项目未调用的代码；不改变周边代码风格；目标版本校验失败时停止并询问用户；若不存在已发布的 v3 版本则终止。具体命令与代码示例以原始资料为准。