用途：把已有的 V1 干净室（调用 samooha_by_snowflake_local_db.provider.* / consumer.*）迁移到 V2 Collaboration API，产出本地 SQL 脚本、映射与验证报告，供人工审查后执行。
主要能力：V1 清单盘点；JinjaSQL 模板转换（去掉 join_policy 过滤器，改为硬编码 join 列）；生成 provider 与 consumer 安装脚本、清理脚本、映射报告与验证清单。范围不含执行生成的 SQL、V0 直共享方案、非 Snowflake 干净室。
使用方式：前置条件为两端已安装 SAMOOHA、Quick Start 完成且 CHECK_MOUNT_STATUS() 返回 TRUE，并能以 SAMOOHA_APP_ROLE 或 ACCOUNTADMIN 访问 V1 provider 账户。流程含多个确认点：先用 cortex connections list 确认连接并记为 provider_connection；加载 discover/INSTRUCTIONS.md 执行内省，输出 discovery_report.md；按 v1_v2_mapping.md 映射（provider→owner/INITIALIZE，consumer→runner/JOIN 与 RUN，secure view→REGISTER_DATA_OFFERING 且 allowed_analyses: template_only）；加载 generate/INSTRUCTIONS.md，用 date +%Y%m%d 取日期，建议输出目录 YYYYMMDD_V1_to_V2_Output，生成 v2_provider_setup.sql、v2_consumer_setup.sql、v2_cleanup.sql、mapping_report.md；随后生成 validation_checklist.md 与 cleanup_guidance.md，最后打印文件列表与后续步骤。
限制与注意事项：不自动执行生成的 SQL，必须交由人工审查；PII 原始表先包 secure view；模板中去掉 | join_policy；版本名正则 ^[A-Za-z0-9_]{1,20}$，不要用点；需授予 USAGE + SELECT + REFERENCE_USAGE WITH GRANT OPTION；调用 Collaboration API 前需 USE SECONDARY ROLES NONE；首次 RUN 前需 LINK_LOCAL_DATA_OFFERING；LEAVE/TEARDOWN 为两次调用异步，等待约 60 秒后再调；建议 2–4 周共存期。其他细节资料暂未提供。