@hypersoniclabs/helix-cli 0.1.24-helix3.450 → 0.1.24-helix3.451

package/dist/earlyAccessNotice.d.ts

@@ -0,0 +1,9 @@
+/** The notice line for a command path such as ["vehicle", "validate"], or null when there is none. */
+export declare function earlyAccessNoticeFor(commandPath: readonly string[]): string | null;
+/** Print the notice for this command at most once per process. Never throws. */
+export declare function printEarlyAccessNotice(commandPath: readonly string[], env?: NodeJS.ProcessEnv): void;
+/** The names from the root command's direct child down to the executing command. */
+export declare function commandPathOf(command: {
+    name(): string;
+    parent: unknown;
+}): string[];

package/dist/earlyAccessNotice.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.earlyAccessNoticeFor = earlyAccessNoticeFor;
+exports.printEarlyAccessNotice = printEarlyAccessNotice;
+exports.commandPathOf = commandPathOf;
+// The "Early access" notice for creation commands whose kind is not yet stable.
+//
+// The kind -> stability map and the disclaimer wording live in @hypersoniclabs/helix-manifest
+// (creation-stability) so the MCP, this CLI and the website agree. This file only decides which
+// command is which kind and prints the line once per run.
+//
+// It goes to STDERR, always: `--json` output on stdout stays one parseable document. Set
+// HELIX_NO_EARLY_ACCESS_NOTICE=1 to silence it (scripts, and wrappers that already tell the user).
+const helix_manifest_1 = require("@hypersoniclabs/helix-manifest");
+/** Command path -> creation kind. Longest prefix wins; a path with no match prints nothing. */
+const COMMAND_KINDS = [
+    ['vehicle addon', 'vehicle-addon'],
+    ['vehicle', 'vehicle'],
+    ['device', 'device'],
+    ['pack', 'locomotion-pack'],
+    // Interactive item definitions are weapons and emotes today; neither kind is stable yet.
+    ['item-def', 'Weapon and emote'],
+];
+/** The notice line for a command path such as ["vehicle", "validate"], or null when there is none. */
+function earlyAccessNoticeFor(commandPath) {
+    const joined = commandPath.join(' ');
+    let best = null;
+    for (const entry of COMMAND_KINDS) {
+        const [prefix] = entry;
+        if ((joined === prefix || joined.startsWith(`${prefix} `)) && (!best || prefix.length > best[0].length))
+            best = entry;
+    }
+    if (!best)
+        return null;
+    return (0, helix_manifest_1.isEarlyAccessCreationKind)(best[1]) ? (0, helix_manifest_1.earlyAccessDisclaimer)(best[1]) : null;
+}
+let printed = false;
+/** Print the notice for this command at most once per process. Never throws. */
+function printEarlyAccessNotice(commandPath, env = process.env) {
+    if (printed || env.HELIX_NO_EARLY_ACCESS_NOTICE === '1')
+        return;
+    const notice = earlyAccessNoticeFor(commandPath);
+    if (!notice)
+        return;
+    printed = true;
+    try {
+        process.stderr.write(`${notice}\n`);
+    }
+    catch {
+        /* a closed stderr must never fail the command */
+    }
+}
+/** The names from the root command's direct child down to the executing command. */
+function commandPathOf(command) {
+    const names = [];
+    let current = command;
+    while (current && current.parent) {
+        names.unshift(current.name());
+        current = current.parent;
+    }
+    return names;
+}
+//# sourceMappingURL=earlyAccessNotice.js.map

package/dist/earlyAccessNotice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"earlyAccessNotice.js","sourceRoot":"","sources":["../src/earlyAccessNotice.ts"],"names":[],"mappings":";;AAqBA,oDASC;AAKD,wDAUC;AAGD,sCAQC;AAxDD,gFAAgF;AAChF,EAAE;AACF,8FAA8F;AAC9F,gGAAgG;AAChG,0DAA0D;AAC1D,EAAE;AACF,yFAAyF;AACzF,mGAAmG;AACnG,mEAAkG;AAElG,+FAA+F;AAC/F,MAAM,aAAa,GAA2D;IAC5E,CAAC,eAAe,EAAE,eAAe,CAAC;IAClC,CAAC,SAAS,EAAE,SAAS,CAAC;IACtB,CAAC,QAAQ,EAAE,QAAQ,CAAC;IACpB,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAC3B,yFAAyF;IACzF,CAAC,UAAU,EAAE,kBAAkB,CAAC;CACjC,CAAC;AAEF,sGAAsG;AACtG,SAAgB,oBAAoB,CAAC,WAA8B;IACjE,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,IAAI,GAAqC,IAAI,CAAC;IAClD,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;QAClC,MAAM,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC;QACvB,IAAI,CAAC,MAAM,KAAK,MAAM,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YAAE,IAAI,GAAG,KAAK,CAAC;IACxH,CAAC;IACD,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,OAAO,IAAA,0CAAyB,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAA,sCAAqB,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACpF,CAAC;AAED,IAAI,OAAO,GAAG,KAAK,CAAC;AAEpB,gFAAgF;AAChF,SAAgB,sBAAsB,CAAC,WAA8B,EAAE,MAAyB,OAAO,CAAC,GAAG;IACzG,IAAI,OAAO,IAAI,GAAG,CAAC,4BAA4B,KAAK,GAAG;QAAE,OAAO;IAChE,MAAM,MAAM,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC;IACjD,IAAI,CAAC,MAAM;QAAE,OAAO;IACpB,OAAO,GAAG,IAAI,CAAC;IACf,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,iDAAiD;IACnD,CAAC;AACH,CAAC;AAED,oFAAoF;AACpF,SAAgB,aAAa,CAAC,OAA4C;IACxE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,OAAO,GAA+C,OAAO,CAAC;IAClE,OAAO,OAAO,IAAK,OAA+B,CAAC,MAAM,EAAE,CAAC;QAC1D,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9B,OAAO,GAAI,OAAkE,CAAC,MAAM,CAAC;IACvF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/index.js

@@ -74,6 +74,7 @@ const browserLogin_1 = require("./browserLogin");
 const unreal_1 = require("./unreal");
 const unrealPublish_1 = require("./unrealPublish");
 const device_1 = require("./device");
+const earlyAccessNotice_1 = require("./earlyAccessNotice");
 const types_1 = require("./bridge/types");
 const cliAuthority_1 = require("./continuum/cliAuthority");
 const adminPackagePinCommand_1 = require("./continuum/adminPackagePinCommand");
@@ -85,6 +86,10 @@ program
     .name('helix')
     .description('HELIX creator CLI — scaffold, validate, and publish Instant Worlds')
     .version((0, lib_1.cliVersion)());
+// Early-access kinds (device, vehicle, add-on, ...) say so once per run, on stderr, before the work starts.
+program.hook('preAction', (_thisCommand, actionCommand) => {
+    (0, earlyAccessNotice_1.printEarlyAccessNotice)((0, earlyAccessNotice_1.commandPathOf)(actionCommand));
+});
 function fail(message) {
     // Synchronous: stderr is an ASYNC pipe on macOS, so console.error + process.exit cut a long refusal at ~512 bytes
     // whenever the output was piped — exactly how an agent or CI reads it — losing the next command it names.