用途：把 ObjectStack 元数据项目从旧的协议大版本升级到当前版本。升级流程为 preflight → 机械转换链 → 语义残留 → 验收报告。
主要能力：os migrate meta --from N 会按顺序重放每个大版本的转换（无需逐版本升级），规范化栈配置并以当前 schema 校验结果；--step 可逐跳检查，--json 输出机器可读结果，--out 写出规范化的栈快照，--write 才会就地改写可证明来源的站点。默认不重写任何源文件。已存储的 sys_metadata 行在读取时通过 rehydration 投影为新形态，os migrate meta --stored 可预览或 --apply --yes 落盘。
必要用法：先确定 FROM 大版本，来源依次为 manifest.engines.protocol、锁文件历史、向负责人确认；建立升级分支与 .upgrade/ 工作目录；从移动后的目录重装 skills。转换链无法处理的语义残留分三类：R1 意图选择（键被移除且无唯一无损目标）、R2 自写代码调用已移除 API、R3 仍教授旧形态的文档与 AI 约定文件。指令来源随包发布，可用 spec-changes.json、tombstone 文本、CHANGELOG 与自身解析报错获取。
限制：不得手写链已能应用的改写，不得为加载旧元数据添加容错读取，不得猜测负责人意图；一次提交对应一个 conversionId。验收需四项：os validate 通过、tsc --noEmit 通过、os migrate meta --from 17 --json 的 applied 为 []、以及 .upgrade/REPORT.md；缺少任一项状态只能记为进行中。跨版本的数据迁移门在各自部署数据库上运行，元数据升级无法观测。
暂未提供：具体价格、许可与支持的平台信息。