@tantawowa/hosanna-tools 3.32.0 → 4.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (197) hide show
  1. package/README.md +38 -100
  2. package/dist/artwork/app-artwork.d.ts +2 -59
  3. package/dist/artwork/app-artwork.js +26 -243
  4. package/dist/artwork/app-artwork.js.map +1 -1
  5. package/dist/build-info.json +3 -3
  6. package/dist/capture/mcp-tools.d.ts +1 -1
  7. package/dist/capture/mcp-tools.js +2 -4
  8. package/dist/capture/mcp-tools.js.map +1 -1
  9. package/dist/capture/video-capture.d.ts +2 -13
  10. package/dist/capture/video-capture.js +8 -53
  11. package/dist/capture/video-capture.js.map +1 -1
  12. package/dist/cli.js +44 -338
  13. package/dist/cli.js.map +1 -1
  14. package/dist/device/device-cli.js +4 -19
  15. package/dist/device/device-cli.js.map +1 -1
  16. package/dist/device/devices-file.js +4 -7
  17. package/dist/device/devices-file.js.map +1 -1
  18. package/dist/device/driver-registry.js +3 -31
  19. package/dist/device/driver-registry.js.map +1 -1
  20. package/dist/device/types.d.ts +1 -1
  21. package/dist/generation/shapes/shape-compiler.js +9 -0
  22. package/dist/generation/shapes/shape-compiler.js.map +1 -1
  23. package/dist/index.d.ts +3 -16
  24. package/dist/index.js +1 -22
  25. package/dist/index.js.map +1 -1
  26. package/dist/lib/app-config-resolver.js +10 -19
  27. package/dist/lib/app-config-resolver.js.map +1 -1
  28. package/dist/run/destination-picker.js +5 -60
  29. package/dist/run/destination-picker.js.map +1 -1
  30. package/dist/run/executor.d.ts +0 -9
  31. package/dist/run/executor.js +50 -119
  32. package/dist/run/executor.js.map +1 -1
  33. package/dist/run/launch-installed.d.ts +5 -14
  34. package/dist/run/launch-installed.js +17 -58
  35. package/dist/run/launch-installed.js.map +1 -1
  36. package/dist/run/planner.d.ts +2 -10
  37. package/dist/run/planner.js +26 -778
  38. package/dist/run/planner.js.map +1 -1
  39. package/dist/run/run-config.d.ts +5 -12
  40. package/dist/run/run-config.js +8 -36
  41. package/dist/run/run-config.js.map +1 -1
  42. package/dist/run/run-controller.d.ts +1 -43
  43. package/dist/run/run-controller.js +14 -1572
  44. package/dist/run/run-controller.js.map +1 -1
  45. package/dist/run/targets.d.ts +1 -65
  46. package/dist/run/targets.js +13 -282
  47. package/dist/run/targets.js.map +1 -1
  48. package/dist/run/types.d.ts +8 -13
  49. package/dist/run/types.js +14 -19
  50. package/dist/run/types.js.map +1 -1
  51. package/dist/run/web-build.d.ts +1 -0
  52. package/dist/run/web-build.js +15 -0
  53. package/dist/run/web-build.js.map +1 -1
  54. package/dist/support-tools/build-config-resolver.js +7 -77
  55. package/dist/support-tools/build-config-resolver.js.map +1 -1
  56. package/dist/support-tools/dev-runner.js +2 -2
  57. package/dist/support-tools/dev-runner.js.map +1 -1
  58. package/dist/support-tools/mcp-server/tools.js +2 -2
  59. package/dist/support-tools/mcp-server/tools.js.map +1 -1
  60. package/dist/testing/client.js +1 -35
  61. package/dist/testing/client.js.map +1 -1
  62. package/dist/testing/launch-args.d.ts +11 -0
  63. package/dist/testing/launch-args.js +8 -0
  64. package/dist/testing/launch-args.js.map +1 -0
  65. package/dist/testing/launcher.d.ts +1 -1
  66. package/dist/testing/launcher.js +44 -153
  67. package/dist/testing/launcher.js.map +1 -1
  68. package/dist/testing/physical-tv.d.ts +0 -11
  69. package/dist/testing/physical-tv.js +0 -49
  70. package/dist/testing/physical-tv.js.map +1 -1
  71. package/dist/testing/stream-config.d.ts +7 -0
  72. package/dist/testing/stream-config.js +31 -0
  73. package/dist/testing/stream-config.js.map +1 -0
  74. package/dist/testing/target.js +6 -3
  75. package/dist/testing/target.js.map +1 -1
  76. package/dist/testing/types.d.ts +5 -10
  77. package/dist/updater/framework-installer.d.ts +0 -1
  78. package/dist/updater/framework-installer.js +0 -13
  79. package/dist/updater/framework-installer.js.map +1 -1
  80. package/dist/updater/license-manager.d.ts +1 -2
  81. package/dist/updater/license-manager.js +1 -14
  82. package/dist/updater/license-manager.js.map +1 -1
  83. package/dist/updater/sdk-manager.d.ts +1 -1
  84. package/dist/updater/sdk-manager.js +1 -1
  85. package/dist/vite-app-artwork.js +1 -6
  86. package/dist/vite-app-artwork.js.map +1 -1
  87. package/dist/vite-pwa.d.ts +0 -3
  88. package/dist/vite-pwa.js +0 -9
  89. package/dist/vite-pwa.js.map +1 -1
  90. package/package.json +2 -8
  91. package/dist/artwork/native-artwork.d.ts +0 -33
  92. package/dist/artwork/native-artwork.js +0 -297
  93. package/dist/artwork/native-artwork.js.map +0 -1
  94. package/dist/artwork/packaged-artwork.d.ts +0 -10
  95. package/dist/artwork/packaged-artwork.js +0 -465
  96. package/dist/artwork/packaged-artwork.js.map +0 -1
  97. package/dist/device/drivers/tizen-driver.d.ts +0 -19
  98. package/dist/device/drivers/tizen-driver.js +0 -178
  99. package/dist/device/drivers/tizen-driver.js.map +0 -1
  100. package/dist/device/drivers/webos-driver.d.ts +0 -15
  101. package/dist/device/drivers/webos-driver.js +0 -175
  102. package/dist/device/drivers/webos-driver.js.map +0 -1
  103. package/dist/device/setup.d.ts +0 -39
  104. package/dist/device/setup.js +0 -168
  105. package/dist/device/setup.js.map +0 -1
  106. package/dist/native/app-entry-generation.d.ts +0 -9
  107. package/dist/native/app-entry-generation.js +0 -100
  108. package/dist/native/app-entry-generation.js.map +0 -1
  109. package/dist/native/artifacts.d.ts +0 -104
  110. package/dist/native/artifacts.js +0 -747
  111. package/dist/native/artifacts.js.map +0 -1
  112. package/dist/native/native-project.d.ts +0 -108
  113. package/dist/native/native-project.js +0 -1590
  114. package/dist/native/native-project.js.map +0 -1
  115. package/dist/native/prepared-runtime.d.ts +0 -14
  116. package/dist/native/prepared-runtime.js +0 -20
  117. package/dist/native/prepared-runtime.js.map +0 -1
  118. package/dist/native/templates/android/AndroidAutoManifest.xml +0 -33
  119. package/dist/native/templates/android/AndroidManifest.xml +0 -20
  120. package/dist/native/templates/android/WearOsManifest.xml +0 -31
  121. package/dist/native/templates/android/app-build.gradle.kts +0 -300
  122. package/dist/native/templates/android/automotive_app_desc.xml +0 -5
  123. package/dist/native/templates/android/build.gradle.kts +0 -5
  124. package/dist/native/templates/android/car_attribution_icon.xml +0 -10
  125. package/dist/native/templates/android/colors.xml +0 -3
  126. package/dist/native/templates/android/gradle-wrapper.jar +0 -0
  127. package/dist/native/templates/android/gradle-wrapper.properties +0 -7
  128. package/dist/native/templates/android/gradle.properties +0 -3
  129. package/dist/native/templates/android/gradlew +0 -251
  130. package/dist/native/templates/android/gradlew.bat +0 -94
  131. package/dist/native/templates/android/hosanna-animated-image-proguard-rules.pro +0 -5
  132. package/dist/native/templates/android/launcher.xml +0 -12
  133. package/dist/native/templates/android/settings.gradle.kts +0 -18
  134. package/dist/native/templates/android/strings.xml +0 -3
  135. package/dist/native/templates/android/styles.xml +0 -8
  136. package/dist/native/templates/apple/AppIconContents.json +0 -7
  137. package/dist/native/templates/apple/HosannaCarPlay.entitlements +0 -8
  138. package/dist/native/templates/apple/HosannaIosApp.swift +0 -110
  139. package/dist/native/templates/apple/HosannaTvApp.swift +0 -118
  140. package/dist/native/templates/apple/HosannaWatchApp.swift +0 -10
  141. package/dist/native/templates/apple/Info.carplay.plist +0 -43
  142. package/dist/native/templates/apple/Info.plist +0 -24
  143. package/dist/native/templates/apple/Info.watchos.plist +0 -26
  144. package/dist/native/templates/apple/Podfile.example +0 -7
  145. package/dist/native/templates/apple/project.yml +0 -107
  146. package/dist/native/templates/artifacts/verify-aab.mjs +0 -11
  147. package/dist/run/android-auto.d.ts +0 -11
  148. package/dist/run/android-auto.js +0 -121
  149. package/dist/run/android-auto.js.map +0 -1
  150. package/dist/run/android-emulator.d.ts +0 -80
  151. package/dist/run/android-emulator.js +0 -1208
  152. package/dist/run/android-emulator.js.map +0 -1
  153. package/dist/run/apple-tv.d.ts +0 -35
  154. package/dist/run/apple-tv.js +0 -410
  155. package/dist/run/apple-tv.js.map +0 -1
  156. package/dist/run/apple-watch.d.ts +0 -49
  157. package/dist/run/apple-watch.js +0 -389
  158. package/dist/run/apple-watch.js.map +0 -1
  159. package/dist/run/carplay.d.ts +0 -17
  160. package/dist/run/carplay.js +0 -232
  161. package/dist/run/carplay.js.map +0 -1
  162. package/dist/run/code-bundle-descriptor.d.ts +0 -31
  163. package/dist/run/code-bundle-descriptor.js +0 -68
  164. package/dist/run/code-bundle-descriptor.js.map +0 -1
  165. package/dist/run/installed-native-launch.d.ts +0 -12
  166. package/dist/run/installed-native-launch.js +0 -46
  167. package/dist/run/installed-native-launch.js.map +0 -1
  168. package/dist/run/ios-device.d.ts +0 -21
  169. package/dist/run/ios-device.js +0 -254
  170. package/dist/run/ios-device.js.map +0 -1
  171. package/dist/run/ios-simulator.d.ts +0 -23
  172. package/dist/run/ios-simulator.js +0 -217
  173. package/dist/run/ios-simulator.js.map +0 -1
  174. package/dist/run/native-build.d.ts +0 -21
  175. package/dist/run/native-build.js +0 -178
  176. package/dist/run/native-build.js.map +0 -1
  177. package/dist/run/tv-build.d.ts +0 -56
  178. package/dist/run/tv-build.js +0 -670
  179. package/dist/run/tv-build.js.map +0 -1
  180. package/dist/run/tv-test-config.d.ts +0 -13
  181. package/dist/run/tv-test-config.js +0 -70
  182. package/dist/run/tv-test-config.js.map +0 -1
  183. package/dist/support-tools/android-dev-server.d.ts +0 -2
  184. package/dist/support-tools/android-dev-server.js +0 -124
  185. package/dist/support-tools/android-dev-server.js.map +0 -1
  186. package/dist/support-tools/android-log-transformer.d.ts +0 -10
  187. package/dist/support-tools/android-log-transformer.js +0 -77
  188. package/dist/support-tools/android-log-transformer.js.map +0 -1
  189. package/dist/support-tools/android-metro-build.d.ts +0 -15
  190. package/dist/support-tools/android-metro-build.js +0 -373
  191. package/dist/support-tools/android-metro-build.js.map +0 -1
  192. package/dist/support-tools/apple-bundler.d.ts +0 -9
  193. package/dist/support-tools/apple-bundler.js +0 -426
  194. package/dist/support-tools/apple-bundler.js.map +0 -1
  195. package/dist/testing/native-simulator.d.ts +0 -42
  196. package/dist/testing/native-simulator.js +0 -222
  197. package/dist/testing/native-simulator.js.map +0 -1
package/dist/cli.js CHANGED
@@ -110,8 +110,6 @@ function runPlanFlagsFromCliArgs(args, format) {
110
110
  device: rawHasFlag('device') ? args.device : undefined,
111
111
  profile: rawHasFlag('profile') ? args.profile : undefined,
112
112
  appConfig: rawHasFlag('app-config') ? args['app-config'] : undefined,
113
- hotReload: rawHasFlag('hot-reload') ? Boolean(args['hot-reload']) : undefined,
114
- bundled: rawHasFlag('bundled') ? Boolean(args.bundled) : undefined,
115
113
  noBuild: rawHasFlag('no-build') ? Boolean(args['no-build']) : undefined,
116
114
  buildOnly: rawHasFlag('build-only') ? Boolean(args['build-only']) : undefined,
117
115
  noLogs: rawHasFlag('no-logs') ? Boolean(args['no-logs']) : undefined,
@@ -142,9 +140,7 @@ function runPlanFlagsFromCliArgs(args, format) {
142
140
  rebuildAppConfig: rawHasFlag('rebuild-app-config') ? Boolean(args['rebuild-app-config']) : undefined,
143
141
  buildCmd: rawHasFlag('build-cmd') ? args['build-cmd'] : undefined,
144
142
  viteConfig: rawHasFlag('vite-config') ? args['vite-config'] : undefined,
145
- signingProfile: rawHasFlag('signing-profile') ? args['signing-profile'] : undefined,
146
143
  appId: rawHasFlag('app-id') ? args['app-id'] : undefined,
147
- connectOrigins: rawHasFlag('connect-origin') ? args['connect-origin'] : undefined,
148
144
  passthroughArgs: args['--'],
149
145
  };
150
146
  }
@@ -243,47 +239,7 @@ function rememberedExplicitDestination(plan, hasExplicitDestination) {
243
239
  return undefined;
244
240
  return Object.assign({ platform: plan.resolved.platform, target }, (plan.resolved.deviceSelector ? { device: plan.resolved.deviceSelector } : {}));
245
241
  }
246
- const NATIVE_PLATFORM_CHOICES = [
247
- 'apple', 'ios', 'apple-tv', 'carplay', 'apple-watch', 'watchos',
248
- 'android', 'android-tv', 'android-auto', 'wear-os', 'wearos', 'android-watch',
249
- 'cars', 'watches', 'all',
250
- ];
251
- const RUN_PLATFORM_CHOICES = [
252
- 'browser', 'web', 'tizen', 'webos', 'roku', 'ios', 'apple-tv', 'carplay', 'apple-watch', 'watchos',
253
- 'android', 'android-tv', 'android-auto', 'wear-os', 'wearos', 'android-watch',
254
- ];
255
- function nativeInputFromArgs(args) {
256
- return {
257
- cwd: process.cwd(),
258
- platform: nativePlatformArg(args.platform),
259
- app: stringArg(args.app),
260
- displayName: stringArg(args['display-name']),
261
- bundleId: stringArg(args['bundle-id']),
262
- iosBundleId: stringArg(args['ios-bundle-id']),
263
- appleTvBundleId: stringArg(args['apple-tv-bundle-id']),
264
- appleWatchBundleId: stringArg(args['apple-watch-bundle-id']),
265
- androidPackage: stringArg(args['android-package']),
266
- androidTvPackage: stringArg(args['android-tv-package']),
267
- androidAutoPackage: stringArg(args['android-auto-package']),
268
- androidAutoMediaBrowserService: stringArg(args['android-auto-media-browser-service']),
269
- wearOsPackage: stringArg(args['wear-os-package']),
270
- teamId: stringArg(args['team-id']),
271
- versionName: stringArg(args['version-name']),
272
- versionCode: numberOrStringArg(args['version-code']),
273
- referenceRoot: stringArg(args['reference-root']),
274
- replace: Boolean(args.replace),
275
- dryRun: Boolean(args['dry-run']),
276
- nonInteractive: Boolean(args['non-interactive']),
277
- };
278
- }
279
- function nativePlatformArg(value) {
280
- return typeof value === 'string' && value.trim()
281
- ? value.trim()
282
- : undefined;
283
- }
284
- function nativeFormatArg(args) {
285
- return args.format === 'json' ? 'json' : 'text';
286
- }
242
+ const RUN_PLATFORM_CHOICES = ['browser', 'web', 'roku'];
287
243
  function stringArg(value) {
288
244
  return typeof value === 'string' && value.trim() ? value.trim() : undefined;
289
245
  }
@@ -314,7 +270,7 @@ async function runVideoCaptureCommand(args) {
314
270
  try {
315
271
  const platform = ((_a = args.platform) !== null && _a !== void 0 ? _a : args.platformArg);
316
272
  if (!platform)
317
- throw new Error('Capture platform is required. Use ios, apple-tv, roku, tizen, webos, or macos.');
273
+ throw new Error('Capture platform is required. Use roku or web.');
318
274
  const mod = await Promise.resolve().then(() => __importStar(require('./capture/video-capture.js')));
319
275
  const session = await mod.startVideoCapture({
320
276
  platform,
@@ -322,8 +278,6 @@ async function runVideoCaptureCommand(args) {
322
278
  cwd: process.cwd(),
323
279
  outputPath: stringArg(args.output),
324
280
  timeoutSeconds: args['timeout-seconds'],
325
- device: stringArg(args.device),
326
- codec: args.codec,
327
281
  videoDevice: stringArg(args['video-device']),
328
282
  audioDevice: stringArg(args['audio-device']),
329
283
  frameRate: args['frame-rate'],
@@ -372,11 +326,6 @@ async function runVideoCaptureCommand(args) {
372
326
  process.exitCode = 1;
373
327
  }
374
328
  }
375
- function numberOrStringArg(value) {
376
- if (typeof value === 'number' && Number.isFinite(value))
377
- return value;
378
- return stringArg(value);
379
- }
380
329
  // Read build date, version, and git hash embedded at build time
381
330
  let buildDate = 'unknown';
382
331
  let buildVersion = 'unknown';
@@ -442,27 +391,27 @@ async function runEnvironmentCommand(action, verbose) {
442
391
  // Let yargs handle all commands including env
443
392
  (0, yargs_1.default)((0, helpers_1.hideBin)(process.argv))
444
393
  .version(`${buildVersion}\n git: ${buildGitHash}\n built: ${buildDate}`)
445
- .usage('$0 [command] [options]', `Hosanna Tools CLI\nVersion: ${buildVersion}\nBuild Date: ${buildDate}\n\nCommand Groups:\n compiler:* Compiler lifecycle (install, status, list)\n config hosanna.json management (wizard, show, set)\n doctor Friendly environment/package check (use --fix to repair)\n env Environment checks and repair (check, fix, prepare-gitignore)\n dev:* Local development execution\n debugger:* Command debugger control\n mcp:* Hosanna MCP server control\n build Cross-platform build orchestration\n run Cross-platform launch orchestration\n capture Standalone scenario video capture\n native:* Native platform bootstrap and validation\n target:* Run target discovery and inventory\n roku:* Roku deployment, commands & packaging (run, command, package, map-stack)\n device:* Device discovery and run workflows\n generate:* Code and asset generation\n sdk:* Hosanna SDK/framework installation\n build-config:* Build/runtime configuration resolution\n ci:* Continuous integration helpers\n framework:* Framework distribution helpers\n license:* Hosanna framework licensing\n secrets:* Portable .secrets files\n rasp:* RASP cert scripts`)
394
+ .usage(`Hosanna Tools CLI\nVersion: ${buildVersion}\nBuild Date: ${buildDate}\n\nCommand Groups:\n compiler:* Compiler lifecycle (install, status, list)\n config hosanna.json management (wizard, show, set)\n doctor Friendly environment/package check (use --fix to repair)\n env Environment checks and repair (check, fix, prepare-gitignore)\n dev:* Local development execution\n debugger:* Command debugger control\n mcp:* Hosanna MCP server control\n build Roku and Roku browser emulator builds\n run Roku and Roku browser emulator launches\n capture Standalone scenario video capture\n target:* Run target discovery and inventory\n roku:* Roku deployment, commands & packaging (run, command, package, map-stack)\n device:* Device discovery and run workflows\n generate:* Code and asset generation\n sdk:* Hosanna SDK/framework installation\n build-config:* Build/runtime configuration resolution\n ci:* Continuous integration helpers\n framework:* Framework distribution helpers\n license:* Hosanna framework licensing\n secrets:* Portable .secrets files\n rasp:* RASP cert scripts`)
446
395
  .option('verbose', {
447
396
  type: 'boolean',
448
397
  default: false,
449
398
  describe: 'Enable verbose logging for all operations',
450
399
  global: true
451
400
  })
452
- .command('capture [platformArg]', 'Record an Apple simulator, capture-card input, or macOS screen/window', yargs => yargs
401
+ .command('capture [platformArg]', 'Record Roku through a capture card or its web simulator through a host screen/window', yargs => yargs
453
402
  .positional('platformArg', {
454
403
  type: 'string',
455
- choices: ['ios', 'apple-tv', 'roku', 'tizen', 'webos', 'macos'],
404
+ choices: ['roku', 'web'],
456
405
  describe: 'Platform being recorded',
457
406
  })
458
407
  .option('platform', {
459
408
  type: 'string',
460
- choices: ['ios', 'apple-tv', 'roku', 'tizen', 'webos', 'macos'],
409
+ choices: ['roku', 'web'],
461
410
  describe: 'Platform being recorded (alternative to the positional argument)',
462
411
  })
463
412
  .option('source', {
464
413
  type: 'string',
465
- choices: ['apple-simulator', 'avfoundation', 'macos-screen', 'macos-window'],
414
+ choices: ['avfoundation', 'macos-screen', 'macos-window'],
466
415
  describe: 'Capture source; defaults from platform and window/screen options',
467
416
  })
468
417
  .option('output', { alias: 'o', type: 'string', describe: 'Output video path (default: recordings/<platform>-<timestamp>.<ext>)' })
@@ -472,8 +421,6 @@ async function runEnvironmentCommand(action, verbose) {
472
421
  default: 180,
473
422
  describe: 'Automatically stop and finalize after this many seconds',
474
423
  })
475
- .option('device', { type: 'string', describe: 'Booted Apple simulator name or UDID' })
476
- .option('codec', { type: 'string', choices: ['h264', 'hevc'], default: 'h264', describe: 'Apple simulator codec' })
477
424
  .option('video-device', { type: 'string', describe: 'AVFoundation video device name or index' })
478
425
  .option('audio-device', { type: 'string', describe: 'Optional AVFoundation audio device name or index' })
479
426
  .option('frame-rate', { type: 'number', default: 30, describe: 'AVFoundation capture frame rate' })
@@ -486,7 +433,6 @@ async function runEnvironmentCommand(action, verbose) {
486
433
  .option('show-cursor', { type: 'boolean', default: false, describe: 'Include the pointer in macOS capture' })
487
434
  .option('show-clicks', { type: 'boolean', default: false, describe: 'Show clicks in macOS capture' })
488
435
  .option('format', { type: 'string', choices: ['text', 'json'], default: 'text', describe: 'Completion output format' })
489
- .example('$0 capture ios --device "iPhone 17 Pro"', 'Record the booted iOS simulator for up to 180 seconds')
490
436
  .example('$0 capture roku --video-device "USB Video" --audio-device "USB Digital Audio" --timeout 300', 'Record a Roku capture card for five minutes')
491
437
  .example('$0 capture roku --source macos-window --application "QuickTime Player"', 'Record a QuickTime capture window'), async (args) => runVideoCaptureCommand(args))
492
438
  .command('game:prep-level <input>', 'Normalize a Tiled JSON map into the Hs2d canonical runtime subset', yargs => yargs
@@ -525,7 +471,7 @@ async function runEnvironmentCommand(action, verbose) {
525
471
  })
526
472
  .command('build-config:resolve', 'Resolve Hosanna build config overlays into the canonical runtime build-config.json', yargs => yargs
527
473
  .option('env', { type: 'string', describe: 'Environment, e.g. dev, qa, or prod (or HS_ENV / HOSANNA_BUILD_ENV)' })
528
- .option('platform', { type: 'string', describe: 'Platform, e.g. web, roku, android, apple, or ios (or HS_PLATFORM / HOSANNA_BUILD_PLATFORM)' })
474
+ .option('platform', { type: 'string', describe: 'Platform: roku or web (or HS_PLATFORM / HOSANNA_BUILD_PLATFORM)' })
529
475
  .option('profile', { type: 'string', describe: 'Optional explicit local developer profile (or HS_BUILD_PROFILE)' })
530
476
  .option('format', { type: 'string', choices: ['json'], describe: 'Print resolved config to stdout as JSON' })
531
477
  .option('out', { type: 'string', describe: 'Write resolved config to this file' })
@@ -613,10 +559,10 @@ async function runEnvironmentCommand(action, verbose) {
613
559
  process.exit(0);
614
560
  })
615
561
  .command('app-config:resolve', 'Resolve a Hosanna app config file, including root-level $extendFile inheritance', yargs => yargs
616
- .option('input', { type: 'string', describe: 'Input path, app.config.<name>.json filename, or short selector such as phone' })
562
+ .option('input', { type: 'string', describe: 'Input path, app.config.<name>.json filename, or short selector such as tv' })
617
563
  .option('cwd', { type: 'string', describe: 'Project root (default: current working directory)' })
618
- .option('expression', { type: 'string', describe: 'Expression selector used when --input is omitted, such as tv, phone, or tablet' })
619
- .option('platform', { type: 'string', describe: 'Platform selector used when --input is omitted, such as roku, web, ios-capacitor, or android-capacitor' })
564
+ .option('expression', { type: 'string', describe: 'Expression selector used when --input is omitted, such as tv' })
565
+ .option('platform', { type: 'string', describe: 'Platform selector used when --input is omitted, roku or web' })
620
566
  .option('out', { type: 'string', describe: 'Write resolved JSON to this file instead of stdout' }), args => {
621
567
  try {
622
568
  (0, cli_app_config_resolve_js_1.runAppConfigResolveCommand)({
@@ -637,7 +583,7 @@ async function runEnvironmentCommand(action, verbose) {
637
583
  .command('app-config:compile', 'Resolve AppConfig and materialize precompiled theme shapes, bundled fonts, and static asset bundles', yargs => yargs
638
584
  .option('input', { type: 'string', describe: 'Input path, app.config.<name>.json filename, or short selector' })
639
585
  .option('cwd', { type: 'string', describe: 'Project root (default: current working directory)' })
640
- .option('expression', { type: 'string', describe: 'Expression selector such as tv, phone, or tablet' })
586
+ .option('expression', { type: 'string', describe: 'Expression selector such as tv' })
641
587
  .option('platform', { type: 'string', default: 'roku', describe: 'Compilation platform' })
642
588
  .option('out', { type: 'string', describe: 'Final resolved AppConfig output path' })
643
589
  .option('generated-dir', { type: 'string', describe: 'Generated target root (contains package/)' })
@@ -686,7 +632,7 @@ async function runEnvironmentCommand(action, verbose) {
686
632
  .command('app-config:clean', 'Remove compiler-owned AppConfig package, asset bundle, and incremental caches for one target', yargs => yargs
687
633
  .option('input', { type: 'string', describe: 'Input path, app.config.<name>.json filename, or short selector used to infer the target' })
688
634
  .option('cwd', { type: 'string', describe: 'Project root (default: current working directory)' })
689
- .option('expression', { type: 'string', describe: 'Expression selector such as tv, phone, or tablet' })
635
+ .option('expression', { type: 'string', describe: 'Expression selector such as tv' })
690
636
  .option('platform', { type: 'string', default: 'roku', describe: 'Compilation platform' })
691
637
  .option('generated-dir', { type: 'string', describe: 'Generated target root (contains package/)' })
692
638
  .option('bundle-id', { type: 'string', describe: 'Asset bundle id to remove' })
@@ -710,125 +656,6 @@ async function runEnvironmentCommand(action, verbose) {
710
656
  console.error(`Failed to clean app config: ${message}`);
711
657
  process.exit(1);
712
658
  }
713
- })
714
- .command('native:init [platform]', 'Initialize app-owned Hosanna native thin projects and config', yargs => yargs
715
- .positional('platform', { type: 'string', choices: NATIVE_PLATFORM_CHOICES, default: 'all', describe: 'Native platform family to initialize' })
716
- .option('app', { type: 'string', describe: 'App key/name used when inferring defaults' })
717
- .option('display-name', { type: 'string', describe: 'Native display name' })
718
- .option('bundle-id', { type: 'string', describe: 'Base bundle/package identifier' })
719
- .option('ios-bundle-id', { type: 'string', describe: 'iOS bundle identifier' })
720
- .option('apple-tv-bundle-id', { type: 'string', describe: 'tvOS bundle identifier' })
721
- .option('apple-watch-bundle-id', { type: 'string', describe: 'watchOS bundle identifier' })
722
- .option('android-package', { type: 'string', describe: 'Android namespace and phone package base' })
723
- .option('android-tv-package', { type: 'string', describe: 'Android TV application id' })
724
- .option('android-auto-package', { type: 'string', describe: 'Android Auto application id' })
725
- .option('android-auto-media-browser-service', { type: 'string', describe: 'App-owned Android Auto MediaBrowserService or MediaLibraryService class' })
726
- .option('wear-os-package', { type: 'string', describe: 'Wear OS application id' })
727
- .option('team-id', { type: 'string', describe: 'Apple development team id for generated xcconfig files' })
728
- .option('version-name', { type: 'string', describe: 'Native marketing/versionName value' })
729
- .option('version-code', { type: 'number', describe: 'Native build/versionCode value' })
730
- .option('reference-root', { type: 'string', default: 'hosanna-ui', describe: 'Installed framework/runtime root inside the app repo' })
731
- .option('replace', { type: 'boolean', default: false, describe: 'Replace unchanged hst-managed native template files' })
732
- .option('dry-run', { type: 'boolean', default: false, describe: 'Print the native init plan without writing files' })
733
- .option('format', { type: 'string', choices: ['text', 'json'], default: 'text', describe: 'Output format' })
734
- .option('non-interactive', { type: 'boolean', default: false, describe: 'Fail instead of prompting when a decision is needed' })
735
- .example('$0 native:init all --display-name "Hope Stream"', 'Initialize Apple and Android app-owned native projects')
736
- .example('$0 native:init watches --display-name "Hope Stream"', 'Initialize Apple Watch and Wear OS native targets')
737
- .example('$0 native:init android-tv --dry-run --format json', 'Preview Android TV native setup as JSON'), async (args) => {
738
- try {
739
- const mod = await Promise.resolve().then(() => __importStar(require('./native/native-project.js')));
740
- const input = nativeInputFromArgs(args);
741
- const format = nativeFormatArg(args);
742
- const plan = mod.createNativeInitPlan(input);
743
- if (input.dryRun) {
744
- console.info(format === 'json' ? JSON.stringify(plan, null, 2) : mod.formatNativeInitPlanText(plan));
745
- process.exit(plan.errors.length > 0 ? 1 : 0);
746
- }
747
- const result = await mod.executeNativeInitPlan(plan);
748
- if (format === 'json') {
749
- console.info(JSON.stringify(result, null, 2));
750
- }
751
- else {
752
- console.info(`hst native:init applied for ${plan.requestedPlatforms.join(', ')}`);
753
- console.info(mod.formatNativeInitPlanText(plan));
754
- }
755
- process.exit(0);
756
- }
757
- catch (err) {
758
- console.error('❌ native:init failed');
759
- console.error(err instanceof Error ? err.message : String(err));
760
- process.exit(1);
761
- }
762
- })
763
- .command('native:doctor [platform]', 'Validate Hosanna native platform setup and print actionable fixes', yargs => yargs
764
- .positional('platform', { type: 'string', choices: NATIVE_PLATFORM_CHOICES, default: 'all', describe: 'Native platform family to validate' })
765
- .option('app', { type: 'string', describe: 'App key/name used when inferring defaults' })
766
- .option('display-name', { type: 'string', describe: 'Native display name' })
767
- .option('bundle-id', { type: 'string', describe: 'Base bundle/package identifier' })
768
- .option('ios-bundle-id', { type: 'string', describe: 'iOS bundle identifier' })
769
- .option('apple-tv-bundle-id', { type: 'string', describe: 'tvOS bundle identifier' })
770
- .option('apple-watch-bundle-id', { type: 'string', describe: 'watchOS bundle identifier' })
771
- .option('android-package', { type: 'string', describe: 'Android namespace and phone package base' })
772
- .option('android-tv-package', { type: 'string', describe: 'Android TV application id' })
773
- .option('android-auto-package', { type: 'string', describe: 'Android Auto application id' })
774
- .option('android-auto-media-browser-service', { type: 'string', describe: 'App-owned Android Auto MediaBrowserService or MediaLibraryService class' })
775
- .option('wear-os-package', { type: 'string', describe: 'Wear OS application id' })
776
- .option('team-id', { type: 'string', describe: 'Apple development team id for generated xcconfig files' })
777
- .option('version-name', { type: 'string', describe: 'Native marketing/versionName value' })
778
- .option('version-code', { type: 'number', describe: 'Native build/versionCode value' })
779
- .option('reference-root', { type: 'string', default: 'hosanna-ui', describe: 'Installed framework/runtime root inside the app repo' })
780
- .option('replace', { type: 'boolean', default: false, describe: 'Plan replacement checks for unchanged hst-managed native files' })
781
- .option('dry-run', { type: 'boolean', default: false, describe: 'Accepted for script parity; doctor never writes files' })
782
- .option('format', { type: 'string', choices: ['text', 'json'], default: 'text', describe: 'Output format' })
783
- .option('non-interactive', { type: 'boolean', default: false, describe: 'Fail instead of prompting when a decision is needed' })
784
- .example('$0 native:doctor all --format json', 'Validate native setup as JSON'), async (args) => {
785
- try {
786
- const mod = await Promise.resolve().then(() => __importStar(require('./native/native-project.js')));
787
- const report = mod.createNativeDoctorReport(nativeInputFromArgs(args));
788
- const format = nativeFormatArg(args);
789
- console.info(format === 'json' ? JSON.stringify(report, null, 2) : mod.formatNativeDoctorReportText(report));
790
- process.exit(0);
791
- }
792
- catch (err) {
793
- console.error('❌ native:doctor failed');
794
- console.error(err instanceof Error ? err.message : String(err));
795
- process.exit(1);
796
- }
797
- })
798
- .command('native:prepare [platform]', 'Run lightweight Hosanna native prebuild validation', yargs => yargs
799
- .positional('platform', { type: 'string', choices: NATIVE_PLATFORM_CHOICES, default: 'all', describe: 'Native platform family to prepare' })
800
- .option('app', { type: 'string', describe: 'App key/name used when inferring defaults' })
801
- .option('display-name', { type: 'string', describe: 'Native display name' })
802
- .option('bundle-id', { type: 'string', describe: 'Base bundle/package identifier' })
803
- .option('ios-bundle-id', { type: 'string', describe: 'iOS bundle identifier' })
804
- .option('apple-tv-bundle-id', { type: 'string', describe: 'tvOS bundle identifier' })
805
- .option('apple-watch-bundle-id', { type: 'string', describe: 'watchOS bundle identifier' })
806
- .option('android-package', { type: 'string', describe: 'Android namespace and phone package base' })
807
- .option('android-tv-package', { type: 'string', describe: 'Android TV application id' })
808
- .option('android-auto-package', { type: 'string', describe: 'Android Auto application id' })
809
- .option('android-auto-media-browser-service', { type: 'string', describe: 'App-owned Android Auto MediaBrowserService or MediaLibraryService class' })
810
- .option('wear-os-package', { type: 'string', describe: 'Wear OS application id' })
811
- .option('team-id', { type: 'string', describe: 'Apple development team id for generated xcconfig files' })
812
- .option('version-name', { type: 'string', describe: 'Native marketing/versionName value' })
813
- .option('version-code', { type: 'number', describe: 'Native build/versionCode value' })
814
- .option('reference-root', { type: 'string', default: 'hosanna-ui', describe: 'Installed framework/runtime root inside the app repo' })
815
- .option('replace', { type: 'boolean', default: false, describe: 'Accepted for script parity; prepare never writes files' })
816
- .option('dry-run', { type: 'boolean', default: false, describe: 'Accepted for script parity; prepare never writes files' })
817
- .option('format', { type: 'string', choices: ['text', 'json'], default: 'text', describe: 'Output format' })
818
- .option('non-interactive', { type: 'boolean', default: false, describe: 'Fail instead of prompting when a decision is needed' })
819
- .example('$0 native:prepare ios', 'Validate native iOS setup before building'), async (args) => {
820
- try {
821
- const mod = await Promise.resolve().then(() => __importStar(require('./native/native-project.js')));
822
- const result = await mod.prepareNativeProject(nativeInputFromArgs(args));
823
- const format = nativeFormatArg(args);
824
- console.info(format === 'json' ? JSON.stringify(result, null, 2) : mod.formatNativeDoctorReportText(result.report));
825
- process.exit(0);
826
- }
827
- catch (err) {
828
- console.error('❌ native:prepare failed');
829
- console.error(err instanceof Error ? err.message : String(err));
830
- process.exit(1);
831
- }
832
659
  })
833
660
  .command('roku:package', 'Package and sign a Roku channel using roku-deploy. Flags fall back to env vars.', yargs => yargs
834
661
  .option('ip', { type: 'string', describe: 'Roku device IP (env: ROKU_IP)' })
@@ -1528,7 +1355,7 @@ async function runEnvironmentCommand(action, verbose) {
1528
1355
  console.info('Clean completed.');
1529
1356
  process.exit(0);
1530
1357
  })
1531
- .command('generate:9patch', 'Generate 9-patch images for OTT/Android UI elements', yargs => yargs
1358
+ .command('generate:9patch', 'Generate 9-patch images for Roku UI elements', yargs => yargs
1532
1359
  .option('output', {
1533
1360
  type: 'string',
1534
1361
  demandOption: true,
@@ -1839,45 +1666,11 @@ async function runEnvironmentCommand(action, verbose) {
1839
1666
  console.error('❌ complib:serve failed:', err instanceof Error ? err.message : err);
1840
1667
  process.exit(1);
1841
1668
  }
1842
- })
1843
- .command('device:setup <type>', 'Run the automatable, credential-safe portion of Samsung Tizen or LG webOS device setup', yargs => yargs
1844
- .positional('type', { type: 'string', choices: ['tizen', 'webos'] })
1845
- .option('host', { type: 'string', demandOption: true, describe: 'TV IP address or hostname' })
1846
- .option('alias', { type: 'string', default: 'myTV', describe: 'webOS ares device alias' })
1847
- .option('port', { type: 'number', default: 9922, describe: 'webOS Developer Mode SSH port' })
1848
- .option('username', { type: 'string', default: 'prisoner', describe: 'webOS Developer Mode SSH username' })
1849
- .option('default', { type: 'boolean', default: false, describe: 'Make the webOS alias the ares default' })
1850
- .option('get-key', { type: 'boolean', default: false, describe: 'Run the official interactive webOS ares-novacom key flow' })
1851
- .option('signing-profile', { type: 'string', describe: 'Verify an existing external Samsung signing profile' })
1852
- .option('dry-run', { type: 'boolean', default: false, describe: 'Print exact commands and manual prerequisites without changing vendor state' })
1853
- .example('$0 device:setup tizen --host 192.168.1.50 --signing-profile samsung-tv-dev --dry-run', 'Preview Samsung connection/profile checks')
1854
- .example('$0 device:setup webos --host 192.168.1.60 --alias living-room --get-key', 'Register an LG alias and enter the passphrase only in the official ares prompt'), async (args) => {
1855
- try {
1856
- const mod = await Promise.resolve().then(() => __importStar(require('./device/setup.js')));
1857
- const result = await mod.setupTvDevice({
1858
- cwd: process.cwd(),
1859
- type: args.type,
1860
- host: args.host,
1861
- alias: stringArg(args.alias),
1862
- port: args.port,
1863
- username: stringArg(args.username),
1864
- makeDefault: Boolean(args.default),
1865
- getKey: Boolean(args['get-key']),
1866
- signingProfile: stringArg(args['signing-profile']),
1867
- dryRun: Boolean(args['dry-run']),
1868
- env: process.env,
1869
- });
1870
- console.info(mod.formatDeviceSetupResult(result, Boolean(args['dry-run'])));
1871
- }
1872
- catch (error) {
1873
- console.error(`❌ device:setup failed: ${error instanceof Error ? error.message : String(error)}`);
1874
- process.exitCode = 1;
1875
- }
1876
1669
  })
1877
1670
  .command('device:list', 'List devices discovered by hst, merged with .hosanna-tools/devices.json preferences', yargs => yargs
1878
1671
  .option('type', {
1879
1672
  type: 'string',
1880
- choices: ['roku', 'tizen', 'webos', 'ios', 'apple-tv', 'android', 'android-tv'],
1673
+ choices: ['roku'],
1881
1674
  describe: 'Filter devices by platform type',
1882
1675
  })
1883
1676
  .option('json', {
@@ -1903,60 +1696,16 @@ async function runEnvironmentCommand(action, verbose) {
1903
1696
  console.error(err instanceof Error ? err.message : String(err));
1904
1697
  process.exit(1);
1905
1698
  }
1906
- })
1907
- .command('device:inspect <type>', 'Open the supported vendor inspector for an installed application', yargs => yargs
1908
- .positional('type', { type: 'string', choices: ['tizen', 'webos'] })
1909
- .option('device', { type: 'string', describe: 'Configured device alias, serial, IP, or name' })
1910
- .option('app-id', { type: 'string', describe: 'Application id override' })
1911
- .option('source-root', { type: 'string', describe: 'Staged project root containing the platform manifest' }), async (args) => {
1912
- try {
1913
- const mod = await Promise.resolve().then(() => __importStar(require('./device/device-cli.js')));
1914
- await mod.runDeviceInspectCommand({
1915
- cwd: process.cwd(),
1916
- type: args.type,
1917
- device: stringArg(args.device),
1918
- appId: stringArg(args['app-id']),
1919
- sourceRoot: stringArg(args['source-root']),
1920
- env: process.env,
1921
- });
1922
- }
1923
- catch (error) {
1924
- console.error(`❌ device:inspect failed: ${error instanceof Error ? error.message : String(error)}`);
1925
- process.exitCode = 1;
1926
- }
1927
- })
1928
- .command('device:terminate <type>', 'Terminate an installed application through the supported vendor CLI', yargs => yargs
1929
- .positional('type', { type: 'string', choices: ['tizen', 'webos'] })
1930
- .option('device', { type: 'string', describe: 'Configured device alias, serial, IP, or name' })
1931
- .option('app-id', { type: 'string', describe: 'Application id override' })
1932
- .option('source-root', { type: 'string', describe: 'Staged project root containing the platform manifest' }), async (args) => {
1933
- try {
1934
- const mod = await Promise.resolve().then(() => __importStar(require('./device/device-cli.js')));
1935
- await mod.runDeviceTerminateCommand({
1936
- cwd: process.cwd(),
1937
- type: args.type,
1938
- device: stringArg(args.device),
1939
- appId: stringArg(args['app-id']),
1940
- sourceRoot: stringArg(args['source-root']),
1941
- env: process.env,
1942
- });
1943
- }
1944
- catch (error) {
1945
- console.error(`❌ device:terminate failed: ${error instanceof Error ? error.message : String(error)}`);
1946
- process.exitCode = 1;
1947
- }
1948
1699
  })
1949
1700
  .command('launch <platform>', 'Restart an installed app with launch arguments, without building or installing', yargs => yargs
1950
- .positional('platform', { type: 'string', choices: ['roku', 'ios', 'apple-tv', 'android', 'android-tv'], demandOption: true })
1701
+ .positional('platform', { type: 'string', choices: ['roku'], demandOption: true })
1951
1702
  .option('app', { type: 'string', describe: 'Installed app selector from .hosanna-tools/run.json (env: HOSANNA_RUN_APP)' })
1952
- .option('launch-arg', { type: 'array', string: true, describe: 'Android Intent string extra or Roku ECP parameter, KEY=value; repeat for more values' })
1953
- .option('launch-env', { type: 'array', string: true, describe: 'Apple app process environment, KEY=value; repeat for more values' })
1954
- .option('device', { type: 'string', describe: 'Connected device IP, serial/UDID, or name' })
1955
- .option('target', { type: 'string', choices: ['device', 'sim', 'simulator'], describe: 'Physical device or an already-running native simulator' })
1956
- .option('app-id', { type: 'string', describe: 'Installed channel, bundle, or package ID; overrides project configuration' })
1703
+ .option('launch-arg', { type: 'array', string: true, describe: 'Roku ECP parameter, KEY=value; repeat for more values' })
1704
+ .option('device', { type: 'string', describe: 'Connected Roku IP or name' })
1705
+ .option('target', { type: 'string', choices: ['device'], describe: 'Physical Roku device' })
1706
+ .option('app-id', { type: 'string', describe: 'Installed Roku channel ID; overrides project configuration' })
1957
1707
  .option('dry-run', { type: 'boolean', default: false, describe: 'Resolve the launch and print its plan without stopping or launching the app' })
1958
1708
  .option('json', { type: 'boolean', default: false, describe: 'Print the resolved launch as JSON' })
1959
- .example('$0 launch apple-tv --app demo --launch-env APP_MODE=preview --device "Demo TV"', 'Restart an installed app with a process environment value')
1960
1709
  .example('$0 launch roku --app-id dev --launch-arg contentId=123 --device 192.168.1.50', 'Return Home and launch the sideloaded Roku app with a content ID'), async (args) => {
1961
1710
  try {
1962
1711
  const launcher = await Promise.resolve().then(() => __importStar(require('./run/launch-installed.js')));
@@ -1965,10 +1714,9 @@ async function runEnvironmentCommand(action, verbose) {
1965
1714
  platform: args.platform,
1966
1715
  app: args.app,
1967
1716
  launchArgs: launcher.parseInstalledLaunchValues(args['launch-arg']),
1968
- launchEnv: launcher.parseInstalledLaunchValues(args['launch-env'], '--launch-env'),
1969
1717
  appId: args['app-id'],
1970
1718
  device: args.device,
1971
- target: args.target === 'simulator' ? 'sim' : args.target,
1719
+ target: args.target,
1972
1720
  });
1973
1721
  if (!args['dry-run'])
1974
1722
  await launcher.executeInstalledLaunch(plan);
@@ -1982,7 +1730,7 @@ async function runEnvironmentCommand(action, verbose) {
1982
1730
  process.exit(1);
1983
1731
  }
1984
1732
  })
1985
- .command('target:list [platform]', 'List run targets discovered by hst, including web emulators, sims, and physical devices', yargs => yargs
1733
+ .command('target:list [platform]', 'List physical Roku devices and Roku browser emulation', yargs => yargs
1986
1734
  .positional('platform', {
1987
1735
  type: 'string',
1988
1736
  choices: RUN_PLATFORM_CHOICES,
@@ -2000,7 +1748,7 @@ async function runEnvironmentCommand(action, verbose) {
2000
1748
  })
2001
1749
  .option('form-factor', {
2002
1750
  type: 'string',
2003
- choices: ['desktop', 'mobile', 'tablet', 'tv', 'car', 'watch'],
1751
+ choices: ['tv'],
2004
1752
  describe: 'Filter by form factor for broad agent inventory queries',
2005
1753
  })
2006
1754
  .option('json', {
@@ -2015,15 +1763,6 @@ async function runEnvironmentCommand(action, verbose) {
2015
1763
  describe: 'Output format',
2016
1764
  })
2017
1765
  .example('$0 target:list --platform roku', 'List Roku web emulator and device targets')
2018
- .example('$0 target:list --platform ios --target emulator --json', 'List the iOS web emulator target as JSON')
2019
- .example('$0 target:list --platform ios --target sim --json', 'List iOS simulator targets as JSON')
2020
- .example('$0 target:list --platform ios --target device --json', 'List physical iOS device targets as JSON')
2021
- .example('$0 target:list --platform android --target sim --json', 'List Android phone emulator targets as JSON')
2022
- .example('$0 target:list --platform android --target device --json', 'List physical Android device targets as JSON')
2023
- .example('$0 target:list --platform android-tv --target sim --json', 'List Android TV emulator targets as JSON')
2024
- .example('$0 target:list --platform apple-tv --target sim --json', 'List Apple TV simulator targets as JSON')
2025
- .example('$0 target:list --platform apple-watch --target sim --json', 'List Apple Watch simulator targets as JSON')
2026
- .example('$0 target:list --platform wear-os --target sim --json', 'List Wear OS emulator targets as JSON')
2027
1766
  .example('$0 target:list --form-factor tv --json', 'List TV-class targets as JSON'), async (args) => {
2028
1767
  try {
2029
1768
  const mod = await Promise.resolve().then(() => __importStar(require('./run/targets.js')));
@@ -2059,11 +1798,11 @@ async function runEnvironmentCommand(action, verbose) {
2059
1798
  })
2060
1799
  .positional('target', {
2061
1800
  type: 'string',
2062
- describe: 'Target kind: emulator, sim, or device.',
1801
+ describe: 'Target kind: Roku browser emulator or physical device.',
2063
1802
  })
2064
1803
  .positional('deviceSelector', {
2065
1804
  type: 'string',
2066
- describe: 'Device IP, serial/UDID, AVD name, simulator name, web preset id, or case-insensitive name substring.',
1805
+ describe: 'Roku IP, device name, or Roku browser preset (rokuhd/rokufhd).',
2067
1806
  })
2068
1807
  .option('platform', {
2069
1808
  type: 'string',
@@ -2081,7 +1820,7 @@ async function runEnvironmentCommand(action, verbose) {
2081
1820
  })
2082
1821
  .option('device', {
2083
1822
  type: 'string',
2084
- describe: 'Device IP, serial/UDID, case-insensitive name substring, or web preset id for --target emulator',
1823
+ describe: 'Roku IP, device name, or Roku browser preset for --target emulator',
2085
1824
  })
2086
1825
  .option('appName', {
2087
1826
  type: 'string',
@@ -2090,13 +1829,11 @@ async function runEnvironmentCommand(action, verbose) {
2090
1829
  .option('app', { type: 'string', describe: 'Run config app/flavor selector (env: HOSANNA_RUN_APP)' })
2091
1830
  .option('profile', { type: 'string', describe: 'Build config profile (env: HS_BUILD_PROFILE)' })
2092
1831
  .option('allow-profile-in-prod', { type: 'boolean', default: false, describe: 'Allow applying --profile with --env prod' })
2093
- .option('app-config', { type: 'string', describe: 'Runtime app config selector passed to web/native launch inputs' })
1832
+ .option('app-config', { type: 'string', describe: 'Runtime app config selector passed to Roku or browser launch inputs' })
2094
1833
  .option('shape-delivery', { type: 'string', choices: ['runtime', 'embedded', 'bundled'], describe: 'Override the build AppConfig shape delivery policy' })
2095
1834
  .option('font-delivery', { type: 'string', choices: ['embedded', 'bundled'], describe: 'Override the build AppConfig font delivery policy' })
2096
1835
  .option('bundle-revision', { type: 'string', describe: 'Override the build asset-bundle cache revision' })
2097
1836
  .option('rebuild-app-config', { type: 'boolean', default: false, describe: 'Re-render AppConfig compiler assets for this build' })
2098
- .option('hot-reload', { type: 'boolean', default: false, describe: 'Use native JS dev server where supported' })
2099
- .option('bundled', { type: 'boolean', default: false, describe: 'Use bundled native JS/assets where supported' })
2100
1837
  .option('vitePort', { type: 'number', description: 'Port for Vite dev server', default: 5173 })
2101
1838
  .option('webAppPort', { type: 'number', description: 'Port for web app debugger client', default: 59151 })
2102
1839
  .option('deviceAppPort', { type: 'number', description: 'Port for device app debugger client', default: 59152 })
@@ -2107,28 +1844,21 @@ async function runEnvironmentCommand(action, verbose) {
2107
1844
  .option('dry-run', { type: 'boolean', default: false, describe: 'Print the resolved build RunPlan without executing it' })
2108
1845
  .option('format', { type: 'string', choices: ['text', 'json'], default: 'text', describe: 'Output format for --dry-run and build result' })
2109
1846
  .option('explain', { type: 'boolean', default: false, describe: 'Include resolution source details in text dry-run output' })
2110
- .option('hsconfig', { type: 'string', describe: 'Explicit hsconfig file for Roku/native build planning' })
1847
+ .option('hsconfig', { type: 'string', describe: 'Explicit hsconfig file for Roku build planning' })
2111
1848
  .option('hsc-project', { type: 'string', describe: 'Explicit Roku HSC project file for hst build planning' })
2112
1849
  .option('config', { type: 'string', describe: 'Back-compatible alias for --hsconfig / --hsc-project' })
2113
1850
  .option('source-root', { type: 'string', describe: 'Roku source root to preserve in build planning output' })
2114
1851
  .option('output-root', { type: 'string', describe: 'Project-relative root for an isolated Browser or Roku build and all generated intermediates' })
2115
1852
  .option('build-cmd', { type: 'string', describe: 'Override the platform bundle command; parsed and executed without a shell' })
2116
- .option('vite-config', { type: 'string', describe: 'Target Vite config for Browser/Tizen/webOS builds' })
2117
- .option('signing-profile', { type: 'string', describe: 'External Samsung certificate profile name (env: TIZEN_SECURITY_PROFILE)' })
1853
+ .option('vite-config', { type: 'string', describe: 'Vite config for the Roku browser emulator' })
2118
1854
  .option('app-id', { type: 'string', describe: 'Override the packaged TV application id for launch/inspect' })
2119
- .option('connect-origin', { type: 'array', string: true, describe: 'Exact non-secret origin to allow in packaged-TV CSP/WARP; repeat as needed' })
2120
1855
  .example('$0 build roku dev device', 'Build the dev Roku output without deploying or streaming logs')
2121
1856
  .example('$0 build roku prod device --hsc-project platforms/hsconfig-roku.prod.json', 'Build Roku with an explicit HSC project file')
2122
- .example('$0 build ios dev sim --device "iPhone 17 Pro"', 'Build an iOS simulator target without install, launch, or logs')
2123
- .example('$0 build apple-watch dev sim --device "Apple Watch Series 11 (46mm)"', 'Build the paired Apple Watch simulator target')
2124
- .example('$0 build wear-os dev sim --device "Wear_OS_Large_Round"', 'Build the Wear OS emulator target')
2125
1857
  .example('$0 build browser dev emulator', 'Resolve Browser runtime build config without opening a browser')
2126
- .example('$0 build roku dev device --output-root .hosanna-tools/build/roku-dev', 'Build Roku into an isolated output tree')
2127
- .example('$0 build tizen dev device --signing-profile samsung-tv-dev', 'Create a signed Samsung .wgt without contacting a TV')
2128
- .example('$0 build webos dev device', 'Create an LG .ipk without contacting a TV'), async (args) => {
1858
+ .example('$0 build roku dev device --output-root .hosanna-tools/build/roku-dev', 'Build Roku into an isolated output tree'), async (args) => {
2129
1859
  await runRunPlanCommand('build', args);
2130
1860
  })
2131
- .command('run [platform] [env] [target] [deviceSelector]', 'Launch a Hosanna app on a platform target, including car and watch surfaces', yargs => yargs
1861
+ .command('run [platform] [env] [target] [deviceSelector]', 'Launch native Roku or Roku emulated in a browser', yargs => yargs
2132
1862
  .parserConfiguration({ 'boolean-negation': false, 'populate--': true })
2133
1863
  .positional('platform', {
2134
1864
  type: 'string',
@@ -2140,11 +1870,11 @@ async function runEnvironmentCommand(action, verbose) {
2140
1870
  })
2141
1871
  .positional('target', {
2142
1872
  type: 'string',
2143
- describe: 'Target kind: emulator, sim, or device.',
1873
+ describe: 'Target kind: Roku browser emulator or physical device.',
2144
1874
  })
2145
1875
  .positional('deviceSelector', {
2146
1876
  type: 'string',
2147
- describe: 'Device IP, serial/UDID, AVD name, simulator name, web preset id, or case-insensitive name substring.',
1877
+ describe: 'Roku IP, device name, or Roku browser preset (rokuhd/rokufhd).',
2148
1878
  })
2149
1879
  .option('platform', {
2150
1880
  type: 'string',
@@ -2162,7 +1892,7 @@ async function runEnvironmentCommand(action, verbose) {
2162
1892
  })
2163
1893
  .option('device', {
2164
1894
  type: 'string',
2165
- describe: 'Device IP, serial/UDID, case-insensitive name substring, or web preset id for --target emulator',
1895
+ describe: 'Roku IP, device name, or Roku browser preset for --target emulator',
2166
1896
  })
2167
1897
  .option('appName', {
2168
1898
  type: 'string',
@@ -2171,13 +1901,11 @@ async function runEnvironmentCommand(action, verbose) {
2171
1901
  .option('app', { type: 'string', describe: 'Run config app/flavor selector (env: HOSANNA_RUN_APP)' })
2172
1902
  .option('profile', { type: 'string', describe: 'Build config profile (env: HS_BUILD_PROFILE)' })
2173
1903
  .option('allow-profile-in-prod', { type: 'boolean', default: false, describe: 'Allow applying --profile with --env prod' })
2174
- .option('app-config', { type: 'string', describe: 'Runtime app config selector passed to web/native launch inputs' })
1904
+ .option('app-config', { type: 'string', describe: 'Runtime app config selector passed to Roku or browser launch inputs' })
2175
1905
  .option('shape-delivery', { type: 'string', choices: ['runtime', 'embedded', 'bundled'], describe: 'Override the build AppConfig shape delivery policy' })
2176
1906
  .option('font-delivery', { type: 'string', choices: ['embedded', 'bundled'], describe: 'Override the build AppConfig font delivery policy' })
2177
1907
  .option('bundle-revision', { type: 'string', describe: 'Override the build asset-bundle cache revision' })
2178
1908
  .option('rebuild-app-config', { type: 'boolean', default: false, describe: 'Re-render AppConfig compiler assets for this run' })
2179
- .option('hot-reload', { type: 'boolean', default: false, describe: 'Use native JS dev server where supported' })
2180
- .option('bundled', { type: 'boolean', default: false, describe: 'Use bundled native JS/assets where supported' })
2181
1909
  .option('vitePort', { type: 'number', description: 'Port for Vite dev server', default: 5173 })
2182
1910
  .option('webAppPort', { type: 'number', description: 'Port for web app debugger client', default: 59151 })
2183
1911
  .option('deviceAppPort', { type: 'number', description: 'Port for device app debugger client', default: 59152 })
@@ -2197,11 +1925,9 @@ async function runEnvironmentCommand(action, verbose) {
2197
1925
  .option('build-only', { type: 'boolean', default: false, describe: 'Plan or run build steps without opening browser/log streams where supported' })
2198
1926
  .option('no-logs', { type: 'boolean', default: false, describe: 'Do not stream device logs after launch where supported' })
2199
1927
  .option('build-cmd', { type: 'string', describe: 'Override the platform bundle or emulator dev command; parsed and executed without a shell' })
2200
- .option('vite-config', { type: 'string', describe: 'Target Vite config for Browser/Tizen/webOS builds' })
2201
- .option('signing-profile', { type: 'string', describe: 'External Samsung certificate profile name (env: TIZEN_SECURITY_PROFILE)' })
1928
+ .option('vite-config', { type: 'string', describe: 'Vite config for the Roku browser emulator' })
2202
1929
  .option('app-id', { type: 'string', describe: 'Override the packaged TV application id for launch/inspect' })
2203
- .option('connect-origin', { type: 'array', string: true, describe: 'Exact non-secret origin to allow in packaged-TV CSP/WARP; repeat as needed' })
2204
- .option('hsconfig', { type: 'string', describe: 'Explicit hsconfig file for Roku/native run planning' })
1930
+ .option('hsconfig', { type: 'string', describe: 'Explicit hsconfig file for Roku run planning' })
2205
1931
  .option('hsc-project', { type: 'string', describe: 'Explicit Roku HSC project file for hst run planning' })
2206
1932
  .option('config', { type: 'string', describe: 'Back-compatible alias for --hsconfig / --hsc-project' })
2207
1933
  .option('app-package', { type: 'string', describe: 'Roku app .zip or folder to deploy for device runs' })
@@ -2212,29 +1938,11 @@ async function runEnvironmentCommand(action, verbose) {
2212
1938
  .option('installer-password', { type: 'string', describe: 'Roku installer password (env: ROKU_DEVPASSWORD)' })
2213
1939
  .option('logs', { type: 'boolean', default: false, describe: 'Enable verbose deploy logging where supported' })
2214
1940
  .option('applySourceMapToPaths', { type: 'boolean', default: true, describe: 'Resolve Roku stack trace paths with source maps during log streaming' })
2215
- .example('$0 run browser dev emulator', 'Start or reuse the canonical Browser preview')
2216
- .example('$0 run tizen dev emulator', 'Start or reuse the Samsung Tizen desktop preview')
2217
- .example('$0 run webos dev emulator', 'Start or reuse the LG webOS desktop preview')
2218
- .example('$0 run', 'Choose once from all available web, simulator, and physical-device destinations')
1941
+ .example('$0 run browser dev emulator', 'Start or reuse the Roku browser emulator')
1942
+ .example('$0 run', 'Choose a physical Roku or Roku browser emulation')
2219
1943
  .example('$0 run --last', 'Immediately run on the last selected destination')
2220
1944
  .example('$0 run --platform roku --target emulator', 'Start/reuse the Roku TV web emulator')
2221
- .example('$0 run --platform ios --target emulator', 'Start/reuse the iPhone-shaped web emulator profile')
2222
- .example('$0 run --platform android --target emulator --device pixel-8', 'Start/reuse the Android-shaped web emulator profile')
2223
- .example('$0 run --platform apple-tv --target emulator --no-open', 'Start/reuse the Apple TV web emulator profile without opening a browser')
2224
- .example('$0 run --platform android-tv --target emulator', 'Start/reuse the Android TV web emulator profile')
2225
- .example('$0 run --platform ios --target sim --device "iPhone 17 Pro"', 'Build, install, and launch on an iOS simulator')
2226
- .example('$0 run --platform ios --target device --device "George iPhone" --no-logs', 'Build, install, and launch on a physical iPhone')
2227
- .example('$0 run --platform android --target sim --device "Pixel_8" --no-logs', 'Build, install, and launch on an Android phone emulator')
2228
- .example('$0 run --platform android --target device --device "RF8M62694QT" --no-logs', 'Build, install, and launch on a physical Android device')
2229
- .example('$0 run --platform android-tv --target sim --device "Television_1080p" --no-logs', 'Build, install, and launch on an Android TV emulator')
2230
- .example('$0 run --platform apple-tv --target sim --device "Apple TV 4K"', 'Build, install, and launch on an Apple TV simulator')
2231
- .example('$0 run --platform carplay --target sim --device "iPhone 17 Pro"', 'Launch the iPhone host and open the CarPlay Simulator display')
2232
- .example('$0 run --platform android-auto --target sim --device "Pixel_8"', 'Launch Android Auto through the Desktop Head Unit')
2233
- .example('$0 run --platform apple-watch --target sim --device "Apple Watch Series 11 (46mm)"', 'Build and launch through the paired Apple Watch simulator')
2234
- .example('$0 run --platform wear-os --target sim --device "Wear_OS_Large_Round"', 'Build, install, and launch on a Wear OS emulator')
2235
1945
  .example('$0 run --platform roku --target device --device "living room"', 'Build, deploy, launch, and stream logs on a Roku device')
2236
- .example('$0 run tizen dev device "living room" --signing-profile samsung-tv-dev', 'Build, install, and launch on a trusted Samsung TV')
2237
- .example('$0 run webos dev device "living room"', 'Build, install, and launch on a paired LG TV')
2238
1946
  .example('$0 run roku dev device --app criterion', 'Run a configured monorepo app/flavor')
2239
1947
  .example('$0 run roku prod device --hsc-project platforms/hsconfig.criterion.prod.json', 'Override the Roku HSC project file'), async (args) => {
2240
1948
  await runRunPlanCommand('run', args);
@@ -2243,13 +1951,13 @@ async function runEnvironmentCommand(action, verbose) {
2243
1951
  .parserConfiguration({ 'boolean-negation': false })
2244
1952
  .option('type', {
2245
1953
  type: 'string',
2246
- choices: ['roku', 'tizen', 'webos', 'ios', 'apple-tv', 'android', 'android-tv'],
1954
+ choices: ['roku'],
2247
1955
  demandOption: true,
2248
1956
  describe: 'Target platform type',
2249
1957
  })
2250
1958
  .option('device', {
2251
1959
  type: 'string',
2252
- describe: 'Device IP, serial/UDID, or case-insensitive name substring',
1960
+ describe: 'Roku IP or case-insensitive device name',
2253
1961
  })
2254
1962
  .option('no-build', {
2255
1963
  type: 'boolean',
@@ -2267,11 +1975,11 @@ async function runEnvironmentCommand(action, verbose) {
2267
1975
  })
2268
1976
  .option('app-package', {
2269
1977
  type: 'string',
2270
- describe: 'Built Roku .zip/folder, Tizen .wgt, or webOS .ipk to deploy',
1978
+ describe: 'Built Roku .zip or folder to deploy',
2271
1979
  })
2272
1980
  .option('app-id', {
2273
1981
  type: 'string',
2274
- describe: 'Packaged Tizen/webOS application id override',
1982
+ describe: 'Roku application id override',
2275
1983
  })
2276
1984
  .option('source-root', {
2277
1985
  type: 'string',
@@ -2300,9 +2008,7 @@ async function runEnvironmentCommand(action, verbose) {
2300
2008
  describe: 'Resolve Roku stack trace paths with source maps during log streaming',
2301
2009
  })
2302
2010
  .example('$0 device:run --type roku', 'Build, deploy, launch, and stream Roku logs')
2303
- .example('$0 device:run --type roku --device "living room" --no-build', 'Deploy to a preferred Roku by name')
2304
- .example('$0 device:run --type tizen --device "living room" --no-build --app-package ./app.wgt', 'Install and launch an existing Samsung package')
2305
- .example('$0 device:run --type webos --device "living room" --no-build --app-package ./app.ipk', 'Install and launch an existing LG package'), async (args) => {
2011
+ .example('$0 device:run --type roku --device "living room" --no-build', 'Deploy to a preferred Roku by name'), async (args) => {
2306
2012
  try {
2307
2013
  const mod = await Promise.resolve().then(() => __importStar(require('./device/device-cli.js')));
2308
2014
  await mod.runDeviceRunCommand({