Migration CLI - Wraithbound Engineering

wraithbound-migration нужен для однократного импорта уже существующих сборок. Новые релизы публикуются через wraithbound-publisher. CLI объединяет два старых источника:

profile.json с launch-параметрами Minecraft;
файловый SHA-256 manifest, созданный manifest-builder.

На выходе получается manifest.envelope.pb: BuildManifest из общего protobuf-контракта, подписанный Ed25519-ключом релизов. Эту подпись проверяют launcher-server и клиентский SDK.

Сборка

cargo build --release -p wraithbound-migration

Импорт профиля

target\release\wraithbound-migration.exe legacy-profile `
  --profile E:\Wraithbound\profiles\Architechnica.json `
  --file-manifest E:\Wraithbound\work\client-manifest.json `
  --signing-key E:\Wraithbound\keys\manifest.key `
  --output E:\Wraithbound\work\manifest.envelope.pb `
  --build-id 4 `
  --release-id release-1 `
  --generation 1 `
  --loader forge `
  --mirror cdn=https://cdn.wraithbound.com/launcher/servers/4/releases/release-1/files `
  --java-executable runtimes/java-17/bin/javaw.exe

--build-id не зафиксирован в коде: для каждого сервера передаётся его фактический ID. --mirror можно указывать несколько раз; порядок аргументов становится приоритетом CDN.

Что переносится

Старое поле	Protobuf
`uuid`, `title`, `version`, `assetIndex`	идентификаторы и метаданные сборки
`mainClass`, `classPath`	`LaunchDefinition`
`jvmArgs`, `clientArgs`	аргументы запуска
`update`	`FILE_POLICY_REPLACE_ON_UPDATE`
`updateExclusions`	`FILE_POLICY_USER_WRITABLE`
`updateVerify`	Guardian verify paths и managed inventory
`recommendJavaVersion`	версия bundled Java, если указан executable

Legacy-only поля не попадают в envelope, но CLI перечисляет их имена после импорта. Это позволяет проверить потерю семантики до установки release в control-plane.

Не передавайте приватный ключ через командную строку или JSON. Используйте путь к файлу либо WB_MIGRATION_SIGNING_KEY. Сам ключ не встраивается в envelope.