@tantawowa/hosanna-tools 3.0.0 → 3.2.0

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
-  "buildDate": "2026-06-22T13:40:28+01:00",
-  "buildDateISO": "2026-06-22T12:40:28.593Z",
+  "buildDate": "2026-06-22T23:10:19+01:00",
+  "buildDateISO": "2026-06-22T22:10:19.837Z",
   "timeZone": "Europe/London",
-  "gitHash": "cfead4b"
+  "gitHash": "925eb5d"
 }

package/dist/cli.js

@@ -60,9 +60,9 @@ const env_info_js_1 = require("./lib/env-info.js");
 const hosanna_tools_utils_js_1 = require("./lib/hosanna-tools-utils.js");
 const cli_app_config_resolve_js_1 = require("./lib/cli.app-config-resolve.js");
 const hosanna_config_js_1 = require("./lib/hosanna-config.js");
-function formatRunPlanText(plan, explain) {
+function formatRunPlanText(plan, explain, command = 'run') {
     const lines = [
-        `hst run plan: ${plan.resolved.platform} ${plan.resolved.env} ${plan.resolved.target}`,
+        `hst ${command} plan: ${plan.resolved.platform} ${plan.resolved.env} ${plan.resolved.target}`,
         '',
         ...plan.shellPreview.map(line => `  ${line}`),
     ];
@@ -91,6 +91,84 @@ function rawHasFlag(name) {
     const dashName = `--${name}`;
     return (0, helpers_1.hideBin)(process.argv).some(token => token === dashName || token.startsWith(`${dashName}=`));
 }
+function runPlanFlagsFromCliArgs(args, format) {
+    return {
+        platform: rawHasFlag('platform') ? args.platform : undefined,
+        env: rawHasFlag('env') ? args.env : undefined,
+        app: rawHasFlag('app') ? args.app : undefined,
+        target: rawHasFlag('target') ? args.target : undefined,
+        device: rawHasFlag('device') ? args.device : undefined,
+        profile: rawHasFlag('profile') ? args.profile : undefined,
+        appConfig: rawHasFlag('app-config') ? args['app-config'] : undefined,
+        hotReload: rawHasFlag('hot-reload') ? Boolean(args['hot-reload']) : undefined,
+        bundled: rawHasFlag('bundled') ? Boolean(args.bundled) : undefined,
+        noBuild: rawHasFlag('no-build') ? Boolean(args['no-build']) : undefined,
+        buildOnly: rawHasFlag('build-only') ? Boolean(args['build-only']) : undefined,
+        noLogs: rawHasFlag('no-logs') ? Boolean(args['no-logs']) : undefined,
+        logs: rawHasFlag('logs') ? Boolean(args.logs) : undefined,
+        sourceRoot: rawHasFlag('source-root') ? args['source-root'] : undefined,
+        appPackage: rawHasFlag('app-package') ? args['app-package'] : undefined,
+        files: rawHasFlag('files') ? args.files : undefined,
+        deployTimeoutMs: rawHasFlag('deploy-timeout-ms') ? args['deploy-timeout-ms'] : undefined,
+        config: rawHasFlag('config') ? args.config : undefined,
+        hscProject: rawHasFlag('hsc-project') ? args.hscProject : undefined,
+        vitePort: rawHasFlag('vitePort') ? args.vitePort : undefined,
+        webAppPort: rawHasFlag('webAppPort') ? args.webAppPort : undefined,
+        deviceAppPort: rawHasFlag('deviceAppPort') ? args.deviceAppPort : undefined,
+        extensionPort: rawHasFlag('extensionPort') ? args.extensionPort : undefined,
+        managementPort: rawHasFlag('managementPort') ? args.managementPort : undefined,
+        appName: rawHasFlag('appName') ? args.appName : undefined,
+        replace: rawHasFlag('replace') ? Boolean(args.replace) : undefined,
+        nonInteractive: rawHasFlag('non-interactive') ? Boolean(args['non-interactive']) : undefined,
+        dryRun: Boolean(args['dry-run']),
+        format,
+        explain: rawHasFlag('explain') ? Boolean(args.explain) : undefined,
+        allowProfileInProd: rawHasFlag('allow-profile-in-prod') ? Boolean(args['allow-profile-in-prod']) : undefined,
+        passthroughArgs: args['--'],
+    };
+}
+async function runRunPlanCommand(command, args) {
+    var _a, _b, _c;
+    try {
+        const planner = await Promise.resolve().then(() => __importStar(require('./run/planner.js')));
+        const executor = await Promise.resolve().then(() => __importStar(require('./run/executor.js')));
+        const positionalArgv = rawCommandPositionals(command);
+        const format = (args.json || args.format === 'json') ? 'json' : 'text';
+        const planInput = {
+            cwd: process.cwd(),
+            argv: positionalArgv,
+            flags: runPlanFlagsFromCliArgs(args, format),
+            env: process.env,
+        };
+        const plan = command === 'build'
+            ? planner.createBuildPlan(planInput)
+            : planner.createRunPlan(planInput);
+        if (args['dry-run']) {
+            if (format === 'json') {
+                console.info(JSON.stringify(plan, null, 2));
+            }
+            else {
+                console.info(formatRunPlanText(plan, Boolean(args.explain), command));
+            }
+            process.exit(0);
+        }
+        const result = await executor.executeRunPlan(plan);
+        if (format === 'json') {
+            console.info(JSON.stringify(result, null, 2));
+        }
+        else if (result.status === 'reused') {
+            console.info(`hst ${command}: reusing ${(_a = result.appName) !== null && _a !== void 0 ? _a : 'app'} at ${(_b = result.url) !== null && _b !== void 0 ? _b : '(unknown URL)'}`);
+        }
+        else if (result.url) {
+            console.info(`hst ${command}: ${(_c = result.appName) !== null && _c !== void 0 ? _c : 'app'} available at ${result.url}`);
+        }
+    }
+    catch (err) {
+        console.error(`❌ ${command} failed`);
+        console.error(err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    }
+}
 const NATIVE_PLATFORM_CHOICES = ['apple', 'ios', 'apple-tv', 'android', 'android-tv', 'all'];
 function nativeInputFromArgs(args) {
     return {
@@ -154,7 +232,7 @@ catch (err) {
 // Let yargs handle all commands including env
 (0, yargs_1.default)((0, helpers_1.hideBin)(process.argv))
     .version(`${buildVersion}\n  git: ${buildGitHash}\n  built: ${buildDate}`)
-    .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  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  run           Cross-platform launch orchestration\n  native:*      Native platform bootstrap and validation\n  target:*      Run target discovery and inventory\n  roku:*        Roku deployment & packaging (run, 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  test:*        UI testing\n  rasp:*        RASP cert scripts`)
+    .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  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  native:*      Native platform bootstrap and validation\n  target:*      Run target discovery and inventory\n  roku:*        Roku deployment & packaging (run, 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  test:*        UI testing\n  rasp:*        RASP cert scripts`)
     .option('verbose', {
     type: 'boolean',
     default: false,
@@ -1384,6 +1462,71 @@ catch (err) {
         console.error(err instanceof Error ? err.message : String(err));
         process.exit(1);
     }
+})
+    .command('build [platform] [env] [target] [deviceSelector]', 'Build a Hosanna app for a platform target without launching, deploying, opening browsers, or streaming logs', yargs => yargs
+    .parserConfiguration({ 'boolean-negation': false, 'populate--': true })
+    .positional('platform', {
+    type: 'string',
+    describe: 'Build platform. Defaults from flags, env, .hosanna-tools/run.json, then web.',
+})
+    .positional('env', {
+    type: 'string',
+    describe: 'Build environment, e.g. dev, qa, or prod.',
+})
+    .positional('target', {
+    type: 'string',
+    describe: 'Target kind: browser, device, simulator, or emulator.',
+})
+    .positional('deviceSelector', {
+    type: 'string',
+    describe: 'Device IP, serial/UDID, AVD name, simulator name, or case-insensitive name substring.',
+})
+    .option('platform', {
+    type: 'string',
+    choices: ['web', 'roku', 'ios', 'apple-tv', 'android', 'android-tv'],
+    describe: 'Build platform.',
+})
+    .option('env', {
+    type: 'string',
+    describe: 'Build environment, e.g. dev, qa, or prod.',
+})
+    .option('target', {
+    type: 'string',
+    choices: ['browser', 'web', 'device', 'simulator', 'emulator', 'simulated', 'emulated'],
+    describe: 'Target kind. Defaults by platform.',
+})
+    .option('device', {
+    type: 'string',
+    describe: 'Device IP, serial/UDID, case-insensitive name substring, or web preset id for --target browser',
+})
+    .option('appName', {
+    type: 'string',
+    describe: 'App name used for debugger/session identity',
+})
+    .option('app', { type: 'string', describe: 'Run config app/flavor selector (env: HOSANNA_RUN_APP)' })
+    .option('profile', { type: 'string', describe: 'Build config profile (env: HS_BUILD_PROFILE)' })
+    .option('allow-profile-in-prod', { type: 'boolean', default: false, describe: 'Allow applying --profile with --env prod' })
+    .option('app-config', { type: 'string', describe: 'Runtime app config selector passed to web/native launch inputs' })
+    .option('hot-reload', { type: 'boolean', default: false, describe: 'Use native JS dev server where supported' })
+    .option('bundled', { type: 'boolean', default: false, describe: 'Use bundled native JS/assets where supported' })
+    .option('vitePort', { type: 'number', description: 'Port for Vite dev server', default: 5173 })
+    .option('webAppPort', { type: 'number', description: 'Port for web app debugger client', default: 59151 })
+    .option('deviceAppPort', { type: 'number', description: 'Port for device app debugger client', default: 59152 })
+    .option('extensionPort', { type: 'number', description: 'Debugger extension WebSocket port', default: 59153 })
+    .option('managementPort', { type: 'number', description: 'Debugger management HTTP port', default: 59150 })
+    .option('non-interactive', { type: 'boolean', default: false, describe: 'Fail instead of prompting when a decision is needed' })
+    .option('json', { type: 'boolean', default: false, describe: 'Print build result as JSON when the command returns' })
+    .option('dry-run', { type: 'boolean', default: false, describe: 'Print the resolved build RunPlan without executing it' })
+    .option('format', { type: 'string', choices: ['text', 'json'], default: 'text', describe: 'Output format for --dry-run and build result' })
+    .option('explain', { type: 'boolean', default: false, describe: 'Include resolution source details in text dry-run output' })
+    .option('hsc-project', { type: 'string', describe: 'Explicit Roku HSC project file for hst build planning' })
+    .option('config', { type: 'string', describe: 'Alias for --hsc-project' })
+    .option('source-root', { type: 'string', describe: 'Roku source root to preserve in build planning output' })
+    .example('$0 build roku dev device', 'Build the dev Roku output without deploying or streaming logs')
+    .example('$0 build roku prod device --hsc-project platforms/hsconfig-roku.prod.json', 'Build Roku with an explicit HSC project file')
+    .example('$0 build ios dev simulator --device "iPhone 17 Pro"', 'Build an iOS simulator target without install, launch, or logs')
+    .example('$0 build web dev browser', 'Resolve web runtime build config without opening a browser'), async (args) => {
+    await runRunPlanCommand('build', args);
 })
     .command('run [platform] [env] [target] [deviceSelector]', 'Launch a Hosanna app on a platform target (web, Roku, iOS, Apple TV, Android, and Android TV targets are supported)', yargs => yargs
     .parserConfiguration({ 'boolean-negation': false, 'populate--': true })
@@ -1474,76 +1617,7 @@ catch (err) {
     .example('$0 run --platform roku --target device --device "living room"', 'Build, deploy, launch, and stream logs on a Roku device')
     .example('$0 run roku dev device --app criterion', 'Run a configured monorepo app/flavor')
     .example('$0 run roku prod device --hsc-project platforms/hsconfig.criterion.prod.json', 'Override the Roku HSC project file'), async (args) => {
-    var _a, _b, _c;
-    try {
-        const planner = await Promise.resolve().then(() => __importStar(require('./run/planner.js')));
-        const executor = await Promise.resolve().then(() => __importStar(require('./run/executor.js')));
-        const positionalArgv = rawCommandPositionals('run');
-        const format = (args.json || args.format === 'json') ? 'json' : 'text';
-        const plan = planner.createRunPlan({
-            cwd: process.cwd(),
-            argv: positionalArgv,
-            flags: {
-                platform: rawHasFlag('platform') ? args.platform : undefined,
-                env: rawHasFlag('env') ? args.env : undefined,
-                app: rawHasFlag('app') ? args.app : undefined,
-                target: rawHasFlag('target') ? args.target : undefined,
-                device: rawHasFlag('device') ? args.device : undefined,
-                profile: rawHasFlag('profile') ? args.profile : undefined,
-                appConfig: rawHasFlag('app-config') ? args['app-config'] : undefined,
-                hotReload: rawHasFlag('hot-reload') ? Boolean(args['hot-reload']) : undefined,
-                bundled: rawHasFlag('bundled') ? Boolean(args.bundled) : undefined,
-                noBuild: rawHasFlag('no-build') ? Boolean(args['no-build']) : undefined,
-                buildOnly: rawHasFlag('build-only') ? Boolean(args['build-only']) : undefined,
-                noLogs: rawHasFlag('no-logs') ? Boolean(args['no-logs']) : undefined,
-                logs: rawHasFlag('logs') ? Boolean(args.logs) : undefined,
-                sourceRoot: rawHasFlag('source-root') ? args['source-root'] : undefined,
-                appPackage: rawHasFlag('app-package') ? args['app-package'] : undefined,
-                files: rawHasFlag('files') ? args.files : undefined,
-                deployTimeoutMs: rawHasFlag('deploy-timeout-ms') ? args['deploy-timeout-ms'] : undefined,
-                config: rawHasFlag('config') ? args.config : undefined,
-                hscProject: rawHasFlag('hsc-project') ? args.hscProject : undefined,
-                vitePort: rawHasFlag('vitePort') ? args.vitePort : undefined,
-                webAppPort: rawHasFlag('webAppPort') ? args.webAppPort : undefined,
-                deviceAppPort: rawHasFlag('deviceAppPort') ? args.deviceAppPort : undefined,
-                extensionPort: rawHasFlag('extensionPort') ? args.extensionPort : undefined,
-                managementPort: rawHasFlag('managementPort') ? args.managementPort : undefined,
-                appName: rawHasFlag('appName') ? args.appName : undefined,
-                replace: rawHasFlag('replace') ? Boolean(args.replace) : undefined,
-                nonInteractive: rawHasFlag('non-interactive') ? Boolean(args['non-interactive']) : undefined,
-                dryRun: Boolean(args['dry-run']),
-                format,
-                explain: rawHasFlag('explain') ? Boolean(args.explain) : undefined,
-                allowProfileInProd: rawHasFlag('allow-profile-in-prod') ? Boolean(args['allow-profile-in-prod']) : undefined,
-                passthroughArgs: args['--'],
-            },
-            env: process.env,
-        });
-        if (args['dry-run']) {
-            if (format === 'json') {
-                console.info(JSON.stringify(plan, null, 2));
-            }
-            else {
-                console.info(formatRunPlanText(plan, Boolean(args.explain)));
-            }
-            process.exit(0);
-        }
-        const result = await executor.executeRunPlan(plan);
-        if (format === 'json') {
-            console.info(JSON.stringify(result, null, 2));
-        }
-        else if (result.status === 'reused') {
-            console.info(`hst run: reusing ${(_a = result.appName) !== null && _a !== void 0 ? _a : 'app'} at ${(_b = result.url) !== null && _b !== void 0 ? _b : '(unknown URL)'}`);
-        }
-        else if (result.url) {
-            console.info(`hst run: ${(_c = result.appName) !== null && _c !== void 0 ? _c : 'app'} available at ${result.url}`);
-        }
-    }
-    catch (err) {
-        console.error('❌ run failed');
-        console.error(err instanceof Error ? err.message : String(err));
-        process.exit(1);
-    }
+    await runRunPlanCommand('run', args);
 })
     .command('device:run', 'Build, deploy, launch, and stream logs for a device', yargs => yargs
     .parserConfiguration({ 'boolean-negation': false })