@tantawowa/hosanna-tools 3.29.3 → 3.30.0

package/README.md

@@ -325,6 +325,7 @@ The CLI commands are organized into logical groups using colon-separated namespa
 
 ### Development Commands
 - `run` - Canonical cross-platform app launcher. Bare interactive runs show one destination picker; explicit platform options include Browser, Samsung Tizen, LG webOS, Roku, Apple, and Android hosts.
+- `launch` - Restart an already-installed Roku, iOS, Apple TV, Android, or Android TV app with launch arguments. No build, install, generated config, or development server is involved. See [launching installed apps](docs/launch-installed.md).
 - `build` - Build/package without device discovery, deployment, launch, browser opening, or log streaming. Successful Tizen/webOS builds print their absolute `.wgt`/`.ipk` path.
 - `device:setup <tizen|webos>` - Guided, dry-runnable vendor setup: connect/authorize Samsung with SDB and verify an external signing profile, or register an LG ares alias and optionally run the official interactive key flow. HST never stores keys, certificates, or passphrases.
 - `capture` - Record an Apple simulator, a physical-TV capture-card input, or a macOS screen/window. The default timeout is 180 seconds; use `--timeout` to override it.

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
-  "buildDate": "2026-09-17T07:51:43+00:00",
-  "buildDateISO": "2026-09-17T07:51:43.771Z",
+  "buildDate": "2026-09-30T18:30:38+00:00",
+  "buildDateISO": "2026-09-30T18:30:38.044Z",
   "timeZone": "UTC",
-  "gitHash": "8d45484"
+  "gitHash": "4d841e2"
 }

package/dist/cli.js

@@ -1943,6 +1943,42 @@ async function runEnvironmentCommand(action, verbose) {
         console.error(`❌ device:terminate failed: ${error instanceof Error ? error.message : String(error)}`);
         process.exitCode = 1;
     }
+})
+    .command('launch <platform>', 'Restart an installed app with launch arguments, without building or installing', yargs => yargs
+    .positional('platform', { type: 'string', choices: ['roku', 'ios', 'apple-tv', 'android', 'android-tv'], demandOption: true })
+    .option('app', { type: 'string', describe: 'Installed app selector from .hosanna-tools/run.json (env: HOSANNA_RUN_APP)' })
+    .option('launch-arg', { type: 'array', string: true, describe: 'Android Intent string extra or Roku ECP parameter, KEY=value; repeat for more values' })
+    .option('launch-env', { type: 'array', string: true, describe: 'Apple app process environment, KEY=value; repeat for more values' })
+    .option('device', { type: 'string', describe: 'Connected device IP, serial/UDID, or name' })
+    .option('target', { type: 'string', choices: ['device', 'sim', 'simulator'], describe: 'Physical device or an already-running native simulator' })
+    .option('app-id', { type: 'string', describe: 'Installed channel, bundle, or package ID; overrides project configuration' })
+    .option('dry-run', { type: 'boolean', default: false, describe: 'Resolve the launch and print its plan without stopping or launching the app' })
+    .option('json', { type: 'boolean', default: false, describe: 'Print the resolved launch as JSON' })
+    .example('$0 launch apple-tv --app demo --launch-env APP_MODE=preview --device "Demo TV"', 'Restart an installed app with a process environment value')
+    .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) => {
+    try {
+        const launcher = await Promise.resolve().then(() => __importStar(require('./run/launch-installed.js')));
+        const plan = await launcher.createInstalledLaunchPlan({
+            cwd: process.cwd(),
+            platform: args.platform,
+            app: args.app,
+            launchArgs: launcher.parseInstalledLaunchValues(args['launch-arg']),
+            launchEnv: launcher.parseInstalledLaunchValues(args['launch-env'], '--launch-env'),
+            appId: args['app-id'],
+            device: args.device,
+            target: args.target === 'simulator' ? 'sim' : args.target,
+        });
+        if (!args['dry-run'])
+            await launcher.executeInstalledLaunch(plan);
+        if (args.json || args['dry-run'])
+            console.info(JSON.stringify(plan, null, 2));
+        else
+            console.info(`Launched installed ${plan.appId} on ${plan.deviceName}.`);
+    }
+    catch (error) {
+        console.error(`hst launch failed: ${error instanceof Error ? error.message : String(error)}`);
+        process.exit(1);
+    }
 })
     .command('target:list [platform]', 'List run targets discovered by hst, including web emulators, sims, and physical devices', yargs => yargs
     .positional('platform', {