ADR-021: 录制包必须包含 manifest、checksum、校验和迁移入口

[ceilf6]

决策

录制包必须包含 manifest、schemaVersion、status、checksum，并在加载时先校验再建索引。P0 提供 validateRecordingPackageV1() 和 migrateRecordingPackage(input) 两个入口。

备选方案

• 直接保存 events/snapshots/media，不做 manifest。
• 保存 manifest 但不做 checksum。
• manifest + checksum + schema 校验 + migration registry。

理由

最新技术方案新增 RecordingManifest、PackageLoadResult、checksum mismatch、unsupported schema、incomplete package 等错误模型。录制包是后续云端、导入导出和 schema 演进的基础，必须从 P0 约束格式。

影响

包加载遇到未知事件可以 warning 并跳过；遇到已知事件 payload 校验失败、manifest 错误或 checksum mismatch 必须阻止加载。每次 schema 升级必须补迁移脚本和旧包 fixture。