@tantawowa/hosanna-tools 3.5.1 → 3.6.0

package/README.md

@@ -18,6 +18,22 @@ Note, if you are developing hosanna-tools, you will install the package locally.
 npm install . -g # path to the hosanna-tools directory
 ```
 
+## Hosanna source install modes
+
+Client projects can switch between Keygen source tarballs, git checkouts, and a
+local SDK checkout:
+
+```bash
+hst config source                 # show current mode
+hst config source keygen --fix    # default: full + roku,web from @nightly
+hst config source git --fix       # use the configured git checkout again
+hst config source local --fix     # use LOCAL_SDK for framework development
+```
+
+Keygen mode writes `distribution: "keygen"` to `hosanna.json` and installs
+license-gated artifacts with `hst env fix` / `hst sdk:install`. Git mode keeps
+the legacy clone/update path for developers who need it.
+
 ## Embedding as a library
 
 Hosanna Tools can also be imported by app build chains. The CLI remains available as `hst`, but package imports are library-safe and do not parse CLI arguments or call `process.exit` during import. Public wrappers for process-oriented commands use no-exit mode where supported, so API callers receive structured results or thrown errors instead of forced process termination.
@@ -124,6 +140,10 @@ npm run release -- minor   # 2.14.0 → 2.15.0
 npm run release -- major   # 2.14.0 → 3.0.0
 ```
 
+For tokenless agent releases, dispatch **Release Patch** or **Release Minor**
+in GitHub Actions. Both wrappers invoke the OIDC-trusted `release.yml`
+workflow on `main`; agents do not need npm credentials.
+
 ## CLI: configure-hosanna-url
 
 - **purpose**: Updates `hosanna.json` with a new Hosanna UI Git URL under the `git-url` key.

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
-  "buildDate": "2026-07-07T14:16:34+01:00",
-  "buildDateISO": "2026-07-07T13:16:34.976Z",
-  "timeZone": "Europe/London",
-  "gitHash": "6626b1f"
+  "buildDate": "2026-07-10T23:25:28+00:00",
+  "buildDateISO": "2026-07-10T23:25:28.378Z",
+  "timeZone": "UTC",
+  "gitHash": "fd26e90"
 }

package/dist/cli.js

@@ -211,6 +211,14 @@ function nativeFormatArg(args) {
 function stringArg(value) {
     return typeof value === 'string' && value.trim() ? value.trim() : undefined;
 }
+function stringArrayArg(value) {
+    if (typeof value === 'string')
+        return [value];
+    if (Array.isArray(value)) {
+        return value.filter((item) => typeof item === 'string');
+    }
+    return undefined;
+}
 function numberOrStringArg(value) {
     if (typeof value === 'number' && Number.isFinite(value))
         return value;
@@ -731,11 +739,16 @@ catch (err) {
     }
 })
     // remove old --env flag; env is now a subcommand
-    .command('config [action]', 'Show or update hosanna.json configuration from a curated catalog', yargs => yargs
+    .command('config [action] [mode]', 'Show or update hosanna.json configuration from a curated catalog', yargs => yargs
     .positional('action', {
     type: 'string',
-    choices: ['show', 'set', 'wizard'],
-    describe: 'show prints current config, set writes values from flags, wizard runs the interactive setup',
+    choices: ['show', 'set', 'wizard', 'source'],
+    describe: 'show prints current config, set writes values from flags, wizard runs the interactive setup, source switches install mode',
+})
+    .positional('mode', {
+    type: 'string',
+    choices: ['show', 'keygen', 'git', 'local'],
+    describe: 'Source install mode when action is source',
 })
     .option('git-url', { type: 'string', describe: 'Set hosanna.json git-url' })
     .option('sdk-version', { type: 'string', describe: 'Set hosanna.json sdk-version' })
@@ -743,12 +756,57 @@ catch (err) {
     .option('transpiler-version', { type: 'string', describe: 'Set hosanna.json transpiler-version' })
     .option('config-catalog-url', { type: 'string', describe: 'Persist a remote catalog URL into hosanna.json' })
     .option('catalog-url', { type: 'string', describe: 'Use a remote catalog URL for this run without writing it' })
+    .option('flavour', { type: 'string', choices: ['core', 'game', 'full'], describe: 'Keygen source flavour when action is source (default: full)' })
+    .option('platforms', { type: 'string', array: true, describe: 'Keygen platforms when action is source, comma-separated or repeatable (default: roku,web)' })
+    .option('install', { type: 'boolean', default: false, describe: 'Install the selected source mode atomically after updating config' })
+    .option('replace-existing', { type: 'boolean', default: false, describe: 'Allow --install to replace an existing hosanna-ui source root when switching modes' })
+    .option('force', { type: 'boolean', default: false, describe: 'Allow --install to replace a dirty git checkout when used with --replace-existing' })
     .option('fix', { type: 'boolean', default: false, describe: 'Run hst env fix after updating config' }), async (args) => {
     if (args.verbose) {
         process.env.HOSANNA_VERBOSE = '1';
         process.env.HOSANNA_UPDATER_VERBOSE = '1';
     }
     const actionArg = typeof args.action === 'string' ? args.action : undefined;
+    if (actionArg === 'source') {
+        try {
+            const result = await (0, hosanna_config_js_1.runHosannaSourceConfig)({
+                cwd: process.cwd(),
+                mode: (typeof args.mode === 'string' ? args.mode : 'show'),
+                flavour: args.flavour,
+                platforms: (0, hosanna_config_js_1.parsePlatformList)(stringArrayArg(args.platforms)),
+                sdkVersion: typeof args.sdkVersion === 'string' ? args.sdkVersion : undefined,
+                gitUrl: typeof args.gitUrl === 'string' ? args.gitUrl : undefined,
+                branch: typeof args.branch === 'string' ? args.branch : undefined,
+                install: Boolean(args.install),
+                replaceExisting: Boolean(args.replaceExisting),
+                force: Boolean(args.force),
+                writeStdout: text => console.info(text),
+            });
+            if (args.fix && result.updated) {
+                const { fixAllEnvironmentIssues } = await Promise.resolve().then(() => __importStar(require('./lib/env-info.js')));
+                const fixResult = await fixAllEnvironmentIssues(process.cwd());
+                console.info(`\n${fixResult.message}`);
+                if (fixResult.remainingIssues.length > 0) {
+                    console.info('\n❌ Remaining issues:');
+                    for (const issue of fixResult.remainingIssues) {
+                        console.info(`   • ${issue}`);
+                    }
+                }
+                if (!process.env.VITEST)
+                    process.exit(fixResult.success ? 0 : 1);
+                return;
+            }
+            if (!process.env.VITEST)
+                process.exit(0);
+            return;
+        }
+        catch (err) {
+            console.error('❌ Failed to configure source install mode:', err instanceof Error ? err.message : err);
+            if (!process.env.VITEST)
+                process.exit(1);
+            return;
+        }
+    }
     const action = actionArg === 'show' || actionArg === 'set' ? actionArg : 'wizard';
     const updates = {};
     if (typeof args.gitUrl === 'string')
@@ -1297,7 +1355,7 @@ catch (err) {
         const key = String(args.key).trim();
         const validation = await mod.validateLicense(key);
         if (!validation.valid) {
-            console.error(`❌ License is not valid: ${validation.code} ${validation.detail}`.trim());
+            console.error(`❌ License is not valid for the Hosanna source product: ${validation.code} ${validation.detail}`.trim());
             process.exit(1);
         }
         const filePath = mod.storeLicenseKey(key);