用途：审计两个 DSH 版本之间仓库外部可观察到的所有变化，判断相对 from，to 是否包含更多变更或回退，并产出用户预期的报告集合。外部兼容面包括 npm 包公共 API、dsh CLI、wire 协议、磁盘会话数据、模型可见面以及 Python SDK 预期。
主要能力：按上下文路径、DSH_SOURCE_PATH、CWD 启发式或 npm 模式选择分析方式；source 模式审计 git 标签，npm 模式审计已发布产物。输出统一落在 tmp/<fromNorm>-to-<toNorm>/，包含 commits.txt、reverts.txt、files.txt、diffstat.txt、完整 diff、CHANGELOG.md 和 UPGRADE-ADAPTATION.md。报告含 Verdict、回退章节、按消费者影响排序的破坏性变更、确认未变部分、边界签名表和迁移清单。
使用方式：source 模式先运行 git merge-base <from> <to> 验证基线，再执行 node <skill-dir>/scripts/gen-artifacts.mjs <from> <to> tmp/<pair>；npm 模式执行 node <skill-dir>/scripts/materialize-npm.mjs <from> <to> tmp/<pair>。随后按提交规模决定 recon 范围，先建立共享事实（格式守卫、回退列表、Python SDK），再并行扫描各 facade，最后人工复核 REMOVED、回退和 wire 声明后撰写报告。
适用场景：升级前评估宿主版本兼容性、为 plugin-upgrade 提供证据、检测回退与数据格式破坏。
限制：只读，source 模式不触碰 tmp/<pair>/ 之外内容，npm 模式仅写入自身目录并用 --ignore-scripts 安装；npm 版本集不等于 git 标签集，CLI 闭包不含所有可发布包，Python SDK 在 npm 模式超出范围；无 GitHub 富化时无法检测回退意图；无法验证的结论标记 [INFERENCE] 或删除。报告语言跟随用户语言。