@axiomify/cli 5.0.0 → 6.0.0

package/dist/index.mjs

@@ -1,44 +1,14 @@
 #!/usr/bin/env node
+import { __commonJS, __require, __esm, __glob, __toESM } from './chunk-YZPZCUKZ.mjs';
 import * as esbuild from 'esbuild';
-import path4 from 'path';
+import path7 from 'path';
 import fs, { existsSync } from 'fs';
+import pc from 'picocolors';
+import fs5 from 'fs/promises';
 import { spawn } from 'child_process';
+import { createServer } from 'net';
 import { prompt } from 'enquirer';
 import { execa } from 'execa';
-import fs2 from 'fs/promises';
-import pc from 'picocolors';
-
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
-  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
-}) : x)(function(x) {
-  if (typeof require !== "undefined") return require.apply(this, arguments);
-  throw Error('Dynamic require of "' + x + '" is not supported');
-});
-var __commonJS = (cb, mod) => function __require2() {
-  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  __defProp(target, "default", { value: mod, enumerable: true }) ,
-  mod
-));
 
 // node_modules/commander/lib/error.js
 var require_error = __commonJS({
@@ -49,7 +19,6 @@ var require_error = __commonJS({
        * @param {number} exitCode suggested exit code which could be used with process.exit
        * @param {string} code an id string representing the error
        * @param {string} message human-readable description of the error
-       * @constructor
        */
       constructor(exitCode, code, message) {
         super(message);
@@ -64,7 +33,6 @@ var require_error = __commonJS({
       /**
        * Constructs the InvalidArgumentError class
        * @param {string} [message] explanation of why argument is invalid
-       * @constructor
        */
       constructor(message) {
         super(1, "commander.invalidArgument", message);
@@ -125,7 +93,7 @@ var require_argument = __commonJS({
         return this._name;
       }
       /**
-       * @package internal use only
+       * @package
        */
       _concatValue(value, previous) {
         if (previous === this.defaultValue || !Array.isArray(previous)) {
@@ -165,7 +133,9 @@ var require_argument = __commonJS({
         this.argChoices = values.slice();
         this.parseArg = (arg, previous) => {
           if (!this.argChoices.includes(arg)) {
-            throw new InvalidArgumentError2(`Allowed choices are ${this.argChoices.join(", ")}.`);
+            throw new InvalidArgumentError2(
+              `Allowed choices are ${this.argChoices.join(", ")}.`
+            );
           }
           if (this.variadic) {
             return this._concatValue(arg, previous);
@@ -176,6 +146,8 @@ var require_argument = __commonJS({
       }
       /**
        * Make argument required.
+       *
+       * @returns {Argument}
        */
       argRequired() {
         this.required = true;
@@ -183,6 +155,8 @@ var require_argument = __commonJS({
       }
       /**
        * Make argument optional.
+       *
+       * @returns {Argument}
        */
       argOptional() {
         this.required = false;
@@ -233,7 +207,7 @@ var require_help = __commonJS({
        *
        * @param {Option} a
        * @param {Option} b
-       * @returns number
+       * @returns {number}
        */
       compareOptions(a, b) {
         const getSortKey = (option) => {
@@ -256,9 +230,13 @@ var require_help = __commonJS({
           if (!removeShort && !removeLong) {
             visibleOptions.push(helpOption);
           } else if (helpOption.long && !removeLong) {
-            visibleOptions.push(cmd.createOption(helpOption.long, helpOption.description));
+            visibleOptions.push(
+              cmd.createOption(helpOption.long, helpOption.description)
+            );
           } else if (helpOption.short && !removeShort) {
-            visibleOptions.push(cmd.createOption(helpOption.short, helpOption.description));
+            visibleOptions.push(
+              cmd.createOption(helpOption.short, helpOption.description)
+            );
           }
         }
         if (this.sortOptions) {
@@ -276,7 +254,9 @@ var require_help = __commonJS({
         if (!this.showGlobalOptions) return [];
         const globalOptions = [];
         for (let ancestorCmd = cmd.parent; ancestorCmd; ancestorCmd = ancestorCmd.parent) {
-          const visibleOptions = ancestorCmd.options.filter((option) => !option.hidden);
+          const visibleOptions = ancestorCmd.options.filter(
+            (option) => !option.hidden
+          );
           globalOptions.push(...visibleOptions);
         }
         if (this.sortOptions) {
@@ -431,7 +411,9 @@ var require_help = __commonJS({
         if (option.defaultValue !== void 0) {
           const showDefault = option.required || option.optional || option.isBoolean() && typeof option.defaultValue === "boolean";
           if (showDefault) {
-            extraInfo.push(`default: ${option.defaultValueDescription || JSON.stringify(option.defaultValue)}`);
+            extraInfo.push(
+              `default: ${option.defaultValueDescription || JSON.stringify(option.defaultValue)}`
+            );
           }
         }
         if (option.presetArg !== void 0 && option.optional) {
@@ -460,7 +442,9 @@ var require_help = __commonJS({
           );
         }
         if (argument.defaultValue !== void 0) {
-          extraInfo.push(`default: ${argument.defaultValueDescription || JSON.stringify(argument.defaultValue)}`);
+          extraInfo.push(
+            `default: ${argument.defaultValueDescription || JSON.stringify(argument.defaultValue)}`
+          );
         }
         if (extraInfo.length > 0) {
           const extraDescripton = `(${extraInfo.join(", ")})`;
@@ -486,7 +470,11 @@ var require_help = __commonJS({
         function formatItem(term, description) {
           if (description) {
             const fullText = `${term.padEnd(termWidth + itemSeparatorWidth)}${description}`;
-            return helper.wrap(fullText, helpWidth - itemIndentWidth, termWidth + itemSeparatorWidth);
+            return helper.wrap(
+              fullText,
+              helpWidth - itemIndentWidth,
+              termWidth + itemSeparatorWidth
+            );
           }
           return term;
         }
@@ -496,30 +484,49 @@ var require_help = __commonJS({
         let output = [`Usage: ${helper.commandUsage(cmd)}`, ""];
         const commandDescription = helper.commandDescription(cmd);
         if (commandDescription.length > 0) {
-          output = output.concat([helper.wrap(commandDescription, helpWidth, 0), ""]);
+          output = output.concat([
+            helper.wrap(commandDescription, helpWidth, 0),
+            ""
+          ]);
         }
         const argumentList = helper.visibleArguments(cmd).map((argument) => {
-          return formatItem(helper.argumentTerm(argument), helper.argumentDescription(argument));
+          return formatItem(
+            helper.argumentTerm(argument),
+            helper.argumentDescription(argument)
+          );
         });
         if (argumentList.length > 0) {
           output = output.concat(["Arguments:", formatList(argumentList), ""]);
         }
         const optionList = helper.visibleOptions(cmd).map((option) => {
-          return formatItem(helper.optionTerm(option), helper.optionDescription(option));
+          return formatItem(
+            helper.optionTerm(option),
+            helper.optionDescription(option)
+          );
         });
         if (optionList.length > 0) {
           output = output.concat(["Options:", formatList(optionList), ""]);
         }
         if (this.showGlobalOptions) {
           const globalOptionList = helper.visibleGlobalOptions(cmd).map((option) => {
-            return formatItem(helper.optionTerm(option), helper.optionDescription(option));
+            return formatItem(
+              helper.optionTerm(option),
+              helper.optionDescription(option)
+            );
           });
           if (globalOptionList.length > 0) {
-            output = output.concat(["Global Options:", formatList(globalOptionList), ""]);
+            output = output.concat([
+              "Global Options:",
+              formatList(globalOptionList),
+              ""
+            ]);
           }
         }
         const commandList = helper.visibleCommands(cmd).map((cmd2) => {
-          return formatItem(helper.subcommandTerm(cmd2), helper.subcommandDescription(cmd2));
+          return formatItem(
+            helper.subcommandTerm(cmd2),
+            helper.subcommandDescription(cmd2)
+          );
         });
         if (commandList.length > 0) {
           output = output.concat(["Commands:", formatList(commandList), ""]);
@@ -563,8 +570,11 @@ var require_help = __commonJS({
         const indentString = " ".repeat(indent);
         const zeroWidthSpace = "\u200B";
         const breaks = `\\s${zeroWidthSpace}`;
-        const regex = new RegExp(`
-|.{1,${columnWidth - 1}}([${breaks}]|$)|[^${breaks}]+?([${breaks}]|$)`, "g");
+        const regex = new RegExp(
+          `
+|.{1,${columnWidth - 1}}([${breaks}]|$)|[^${breaks}]+?([${breaks}]|$)`,
+          "g"
+        );
         const lines = columnText.match(regex) || [];
         return leadingStr + lines.map((line, i) => {
           if (line === "\n") return "";
@@ -663,7 +673,7 @@ var require_option = __commonJS({
        *   .addOption(new Option('--log', 'write logging information to file'))
        *   .addOption(new Option('--trace', 'log extra details').implies({ log: 'trace.txt' }));
        *
-       * @param {Object} impliedOptionValues
+       * @param {object} impliedOptionValues
        * @return {Option}
        */
       implies(impliedOptionValues) {
@@ -718,7 +728,7 @@ var require_option = __commonJS({
         return this;
       }
       /**
-       * @package internal use only
+       * @package
        */
       _concatValue(value, previous) {
         if (previous === this.defaultValue || !Array.isArray(previous)) {
@@ -736,7 +746,9 @@ var require_option = __commonJS({
         this.argChoices = values.slice();
         this.parseArg = (arg, previous) => {
           if (!this.argChoices.includes(arg)) {
-            throw new InvalidArgumentError2(`Allowed choices are ${this.argChoices.join(", ")}.`);
+            throw new InvalidArgumentError2(
+              `Allowed choices are ${this.argChoices.join(", ")}.`
+            );
           }
           if (this.variadic) {
             return this._concatValue(arg, previous);
@@ -770,7 +782,7 @@ var require_option = __commonJS({
        *
        * @param {string} arg
        * @return {boolean}
-       * @package internal use only
+       * @package
        */
       is(arg) {
         return this.short === arg || this.long === arg;
@@ -781,7 +793,7 @@ var require_option = __commonJS({
        * Options are one of boolean, negated, required argument, or optional argument.
        *
        * @return {boolean}
-       * @package internal use only
+       * @package
        */
       isBoolean() {
         return !this.required && !this.optional && !this.negate;
@@ -832,7 +844,8 @@ var require_option = __commonJS({
       let shortFlag;
       let longFlag;
       const flagParts = flags.split(/[ |,]+/);
-      if (flagParts.length > 1 && !/^[[<]/.test(flagParts[1])) shortFlag = flagParts.shift();
+      if (flagParts.length > 1 && !/^[[<]/.test(flagParts[1]))
+        shortFlag = flagParts.shift();
       longFlag = flagParts.shift();
       if (!shortFlag && /^-[^-]$/.test(longFlag)) {
         shortFlag = longFlag;
@@ -850,7 +863,8 @@ var require_suggestSimilar = __commonJS({
   "node_modules/commander/lib/suggestSimilar.js"(exports) {
     var maxDistance = 3;
     function editDistance(a, b) {
-      if (Math.abs(a.length - b.length) > maxDistance) return Math.max(a.length, b.length);
+      if (Math.abs(a.length - b.length) > maxDistance)
+        return Math.max(a.length, b.length);
       const d = [];
       for (let i = 0; i <= a.length; i++) {
         d[i] = [i];
@@ -929,8 +943,8 @@ var require_command = __commonJS({
   "node_modules/commander/lib/command.js"(exports) {
     var EventEmitter = __require("events").EventEmitter;
     var childProcess = __require("child_process");
-    var path6 = __require("path");
-    var fs4 = __require("fs");
+    var path11 = __require("path");
+    var fs9 = __require("fs");
     var process2 = __require("process");
     var { Argument: Argument2, humanReadableArgName } = require_argument();
     var { CommanderError: CommanderError2 } = require_error();
@@ -1042,8 +1056,8 @@ var require_command = __commonJS({
        *   .command('stop [service]', 'stop named service, or all if no name supplied');
        *
        * @param {string} nameAndArgs - command name and arguments, args are `<required>` or `[optional]` and last may also be `variadic...`
-       * @param {(Object|string)} [actionOptsOrExecDesc] - configuration options (for action), or description (for executable)
-       * @param {Object} [execOpts] - configuration options (for executable)
+       * @param {(object | string)} [actionOptsOrExecDesc] - configuration options (for action), or description (for executable)
+       * @param {object} [execOpts] - configuration options (for executable)
        * @return {Command} returns new command for action handler, or `this` for executable command
        */
       command(nameAndArgs, actionOptsOrExecDesc, execOpts) {
@@ -1095,8 +1109,8 @@ var require_command = __commonJS({
        * You can customise the help by overriding Help properties using configureHelp(),
        * or with a subclass of Help by overriding createHelp().
        *
-       * @param {Object} [configuration] - configuration options
-       * @return {(Command|Object)} `this` command for chaining, or stored configuration
+       * @param {object} [configuration] - configuration options
+       * @return {(Command | object)} `this` command for chaining, or stored configuration
        */
       configureHelp(configuration) {
         if (configuration === void 0) return this._helpConfiguration;
@@ -1118,8 +1132,8 @@ var require_command = __commonJS({
        *     // functions based on what is being written out
        *     outputError(str, write) // used for displaying errors, and not used for displaying help
        *
-       * @param {Object} [configuration] - configuration options
-       * @return {(Command|Object)} `this` command for chaining, or stored configuration
+       * @param {object} [configuration] - configuration options
+       * @return {(Command | object)} `this` command for chaining, or stored configuration
        */
       configureOutput(configuration) {
         if (configuration === void 0) return this._outputConfiguration;
@@ -1153,7 +1167,7 @@ var require_command = __commonJS({
        * See .command() for creating an attached subcommand which inherits settings from its parent.
        *
        * @param {Command} cmd - new subcommand
-       * @param {Object} [opts] - configuration options
+       * @param {object} [opts] - configuration options
        * @return {Command} `this` command for chaining
        */
       addCommand(cmd, opts) {
@@ -1234,10 +1248,14 @@ var require_command = __commonJS({
       addArgument(argument) {
         const previousArgument = this.registeredArguments.slice(-1)[0];
         if (previousArgument && previousArgument.variadic) {
-          throw new Error(`only the last argument can be variadic '${previousArgument.name()}'`);
+          throw new Error(
+            `only the last argument can be variadic '${previousArgument.name()}'`
+          );
         }
         if (argument.required && argument.defaultValue !== void 0 && argument.parseArg === void 0) {
-          throw new Error(`a default value for a required argument is never used: '${argument.name()}'`);
+          throw new Error(
+            `a default value for a required argument is never used: '${argument.name()}'`
+          );
         }
         this.registeredArguments.push(argument);
         return this;
@@ -1245,6 +1263,7 @@ var require_command = __commonJS({
       /**
        * Customise or override default help command. By default a help command is automatically added if your command has subcommands.
        *
+       * @example
        *    program.helpCommand('help [cmd]');
        *    program.helpCommand('help [cmd]', 'show help');
        *    program.helpCommand(false); // suppress default help command
@@ -1422,7 +1441,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * Register option if no conflicts found, or throw on conflict.
        *
        * @param {Option} option
-       * @api private
+       * @private
        */
       _registerOption(option) {
         const matchingOption = option.short && this._findOption(option.short) || option.long && this._findOption(option.long);
@@ -1438,17 +1457,21 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * Register command if no conflicts found, or throw on conflict.
        *
        * @param {Command} command
-       * @api private
+       * @private
        */
       _registerCommand(command) {
         const knownBy = (cmd) => {
           return [cmd.name()].concat(cmd.aliases());
         };
-        const alreadyUsed = knownBy(command).find((name) => this._findCommand(name));
+        const alreadyUsed = knownBy(command).find(
+          (name) => this._findCommand(name)
+        );
         if (alreadyUsed) {
           const existingCmd = knownBy(this._findCommand(alreadyUsed)).join("|");
           const newCmd = knownBy(command).join("|");
-          throw new Error(`cannot add command '${newCmd}' as already have command '${existingCmd}'`);
+          throw new Error(
+            `cannot add command '${newCmd}' as already have command '${existingCmd}'`
+          );
         }
         this.commands.push(command);
       }
@@ -1465,7 +1488,11 @@ Expecting one of '${allowedValues.join("', '")}'`);
         if (option.negate) {
           const positiveLongFlag = option.long.replace(/^--no-/, "--");
           if (!this._findOption(positiveLongFlag)) {
-            this.setOptionValueWithSource(name, option.defaultValue === void 0 ? true : option.defaultValue, "default");
+            this.setOptionValueWithSource(
+              name,
+              option.defaultValue === void 0 ? true : option.defaultValue,
+              "default"
+            );
           }
         } else if (option.defaultValue !== void 0) {
           this.setOptionValueWithSource(name, option.defaultValue, "default");
@@ -1506,11 +1533,14 @@ Expecting one of '${allowedValues.join("', '")}'`);
       /**
        * Internal implementation shared by .option() and .requiredOption()
        *
+       * @return {Command} `this` command for chaining
        * @private
        */
       _optionEx(config, flags, description, fn, defaultValue) {
         if (typeof flags === "object" && flags instanceof Option2) {
-          throw new Error("To add an Option object use addOption() instead of option() or requiredOption()");
+          throw new Error(
+            "To add an Option object use addOption() instead of option() or requiredOption()"
+          );
         }
         const option = this.createOption(flags, description);
         option.makeOptionMandatory(!!config.mandatory);
@@ -1553,19 +1583,25 @@ Expecting one of '${allowedValues.join("', '")}'`);
         return this._optionEx({}, flags, description, parseArg, defaultValue);
       }
       /**
-      * Add a required option which must have a value after parsing. This usually means
-      * the option must be specified on the command line. (Otherwise the same as .option().)
-      *
-      * The `flags` string contains the short and/or long flags, separated by comma, a pipe or space.
-      *
-      * @param {string} flags
-      * @param {string} [description]
-      * @param {(Function|*)} [parseArg] - custom option processing function or default value
-      * @param {*} [defaultValue]
-      * @return {Command} `this` command for chaining
-      */
+       * Add a required option which must have a value after parsing. This usually means
+       * the option must be specified on the command line. (Otherwise the same as .option().)
+       *
+       * The `flags` string contains the short and/or long flags, separated by comma, a pipe or space.
+       *
+       * @param {string} flags
+       * @param {string} [description]
+       * @param {(Function|*)} [parseArg] - custom option processing function or default value
+       * @param {*} [defaultValue]
+       * @return {Command} `this` command for chaining
+       */
       requiredOption(flags, description, parseArg, defaultValue) {
-        return this._optionEx({ mandatory: true }, flags, description, parseArg, defaultValue);
+        return this._optionEx(
+          { mandatory: true },
+          flags,
+          description,
+          parseArg,
+          defaultValue
+        );
       }
       /**
        * Alter parsing of short flags with optional values.
@@ -1575,7 +1611,8 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * program.combineFlagAndOptionalValue(true);  // `-f80` is treated like `--flag=80`, this is the default behaviour
        * program.combineFlagAndOptionalValue(false) // `-fb` is treated like `-f -b`
        *
-       * @param {boolean} [combine=true] - if `true` or omitted, an optional value can be specified directly after the flag.
+       * @param {boolean} [combine] - if `true` or omitted, an optional value can be specified directly after the flag.
+       * @return {Command} `this` command for chaining
        */
       combineFlagAndOptionalValue(combine = true) {
         this._combineFlagAndOptionalValue = !!combine;
@@ -1584,8 +1621,8 @@ Expecting one of '${allowedValues.join("', '")}'`);
       /**
        * Allow unknown options on the command line.
        *
-       * @param {boolean} [allowUnknown=true] - if `true` or omitted, no error will be thrown
-       * for unknown options.
+       * @param {boolean} [allowUnknown] - if `true` or omitted, no error will be thrown for unknown options.
+       * @return {Command} `this` command for chaining
        */
       allowUnknownOption(allowUnknown = true) {
         this._allowUnknownOption = !!allowUnknown;
@@ -1594,8 +1631,8 @@ Expecting one of '${allowedValues.join("', '")}'`);
       /**
        * Allow excess command-arguments on the command line. Pass false to make excess arguments an error.
        *
-       * @param {boolean} [allowExcess=true] - if `true` or omitted, no error will be thrown
-       * for excess arguments.
+       * @param {boolean} [allowExcess] - if `true` or omitted, no error will be thrown for excess arguments.
+       * @return {Command} `this` command for chaining
        */
       allowExcessArguments(allowExcess = true) {
         this._allowExcessArguments = !!allowExcess;
@@ -1606,7 +1643,8 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * subcommands reuse the same option names, and also enables subcommands to turn on passThroughOptions.
        * The default behaviour is non-positional and global options may appear anywhere on the command line.
        *
-       * @param {boolean} [positional=true]
+       * @param {boolean} [positional]
+       * @return {Command} `this` command for chaining
        */
       enablePositionalOptions(positional = true) {
         this._enablePositionalOptions = !!positional;
@@ -1618,8 +1656,8 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * positional options to have been enabled on the program (parent commands).
        * The default behaviour is non-positional and options may appear before or after command-arguments.
        *
-       * @param {boolean} [passThrough=true]
-       * for unknown options.
+       * @param {boolean} [passThrough] for unknown options.
+       * @return {Command} `this` command for chaining
        */
       passThroughOptions(passThrough = true) {
         this._passThroughOptions = !!passThrough;
@@ -1631,22 +1669,26 @@ Expecting one of '${allowedValues.join("', '")}'`);
        */
       _checkForBrokenPassThrough() {
         if (this.parent && this._passThroughOptions && !this.parent._enablePositionalOptions) {
-          throw new Error(`passThroughOptions cannot be used for '${this._name}' without turning on enablePositionalOptions for parent command(s)`);
+          throw new Error(
+            `passThroughOptions cannot be used for '${this._name}' without turning on enablePositionalOptions for parent command(s)`
+          );
         }
       }
       /**
-        * Whether to store option values as properties on command object,
-        * or store separately (specify false). In both cases the option values can be accessed using .opts().
-        *
-        * @param {boolean} [storeAsProperties=true]
-        * @return {Command} `this` command for chaining
-        */
+       * Whether to store option values as properties on command object,
+       * or store separately (specify false). In both cases the option values can be accessed using .opts().
+       *
+       * @param {boolean} [storeAsProperties=true]
+       * @return {Command} `this` command for chaining
+       */
       storeOptionsAsProperties(storeAsProperties = true) {
         if (this.options.length) {
           throw new Error("call .storeOptionsAsProperties() before adding options");
         }
         if (Object.keys(this._optionValues).length) {
-          throw new Error("call .storeOptionsAsProperties() before setting option values");
+          throw new Error(
+            "call .storeOptionsAsProperties() before setting option values"
+          );
         }
         this._storeOptionsAsProperties = !!storeAsProperties;
         return this;
@@ -1655,7 +1697,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * Retrieve option value.
        *
        * @param {string} key
-       * @return {Object} value
+       * @return {object} value
        */
       getOptionValue(key) {
         if (this._storeOptionsAsProperties) {
@@ -1667,20 +1709,20 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * Store option value.
        *
        * @param {string} key
-       * @param {Object} value
+       * @param {object} value
        * @return {Command} `this` command for chaining
        */
       setOptionValue(key, value) {
         return this.setOptionValueWithSource(key, value, void 0);
       }
       /**
-        * Store option value and where the value came from.
-        *
-        * @param {string} key
-        * @param {Object} value
-        * @param {string} source - expected values are default/config/env/cli/implied
-        * @return {Command} `this` command for chaining
-        */
+       * Store option value and where the value came from.
+       *
+       * @param {string} key
+       * @param {object} value
+       * @param {string} source - expected values are default/config/env/cli/implied
+       * @return {Command} `this` command for chaining
+       */
       setOptionValueWithSource(key, value, source) {
         if (this._storeOptionsAsProperties) {
           this[key] = value;
@@ -1691,22 +1733,22 @@ Expecting one of '${allowedValues.join("', '")}'`);
         return this;
       }
       /**
-        * Get source of option value.
-        * Expected values are default | config | env | cli | implied
-        *
-        * @param {string} key
-        * @return {string}
-        */
+       * Get source of option value.
+       * Expected values are default | config | env | cli | implied
+       *
+       * @param {string} key
+       * @return {string}
+       */
       getOptionValueSource(key) {
         return this._optionValueSources[key];
       }
       /**
-        * Get source of option value. See also .optsWithGlobals().
-        * Expected values are default | config | env | cli | implied
-        *
-        * @param {string} key
-        * @return {string}
-        */
+       * Get source of option value. See also .optsWithGlobals().
+       * Expected values are default | config | env | cli | implied
+       *
+       * @param {string} key
+       * @return {string}
+       */
       getOptionValueSourceWithGlobals(key) {
         let source;
         this._getCommandAndAncestors().forEach((cmd) => {
@@ -1727,11 +1769,17 @@ Expecting one of '${allowedValues.join("', '")}'`);
           throw new Error("first parameter to parse must be array or undefined");
         }
         parseOptions = parseOptions || {};
-        if (argv === void 0) {
-          argv = process2.argv;
-          if (process2.versions && process2.versions.electron) {
+        if (argv === void 0 && parseOptions.from === void 0) {
+          if (process2.versions?.electron) {
             parseOptions.from = "electron";
           }
+          const execArgv = process2.execArgv ?? [];
+          if (execArgv.includes("-e") || execArgv.includes("--eval") || execArgv.includes("-p") || execArgv.includes("--print")) {
+            parseOptions.from = "eval";
+          }
+        }
+        if (argv === void 0) {
+          argv = process2.argv;
         }
         this.rawArgs = argv.slice();
         let userArgs;
@@ -1752,26 +1800,38 @@ Expecting one of '${allowedValues.join("', '")}'`);
           case "user":
             userArgs = argv.slice(0);
             break;
+          case "eval":
+            userArgs = argv.slice(1);
+            break;
           default:
-            throw new Error(`unexpected parse option { from: '${parseOptions.from}' }`);
+            throw new Error(
+              `unexpected parse option { from: '${parseOptions.from}' }`
+            );
         }
-        if (!this._name && this._scriptPath) this.nameFromFilename(this._scriptPath);
+        if (!this._name && this._scriptPath)
+          this.nameFromFilename(this._scriptPath);
         this._name = this._name || "program";
         return userArgs;
       }
       /**
        * Parse `argv`, setting options and invoking commands when defined.
        *
-       * The default expectation is that the arguments are from node and have the application as argv[0]
-       * and the script being run in argv[1], with user parameters after that.
+       * Use parseAsync instead of parse if any of your action handlers are async.
+       *
+       * Call with no parameters to parse `process.argv`. Detects Electron and special node options like `node --eval`. Easy mode!
+       *
+       * Or call with an array of strings to parse, and optionally where the user arguments start by specifying where the arguments are `from`:
+       * - `'node'`: default, `argv[0]` is the application and `argv[1]` is the script being run, with user arguments after that
+       * - `'electron'`: `argv[0]` is the application and `argv[1]` varies depending on whether the electron application is packaged
+       * - `'user'`: just user arguments
        *
        * @example
-       * program.parse(process.argv);
-       * program.parse(); // implicitly use process.argv and auto-detect node vs electron conventions
+       * program.parse(); // parse process.argv and auto-detect electron and special node flags
+       * program.parse(process.argv); // assume argv[0] is app and argv[1] is script
        * program.parse(my-args, { from: 'user' }); // just user supplied arguments, nothing special about argv[0]
        *
        * @param {string[]} [argv] - optional, defaults to process.argv
-       * @param {Object} [parseOptions] - optionally specify style of options with from: node/user/electron
+       * @param {object} [parseOptions] - optionally specify style of options with from: node/user/electron
        * @param {string} [parseOptions.from] - where the args are from: 'node', 'user', 'electron'
        * @return {Command} `this` command for chaining
        */
@@ -1783,18 +1843,20 @@ Expecting one of '${allowedValues.join("', '")}'`);
       /**
        * Parse `argv`, setting options and invoking commands when defined.
        *
-       * Use parseAsync instead of parse if any of your action handlers are async. Returns a Promise.
+       * Call with no parameters to parse `process.argv`. Detects Electron and special node options like `node --eval`. Easy mode!
        *
-       * The default expectation is that the arguments are from node and have the application as argv[0]
-       * and the script being run in argv[1], with user parameters after that.
+       * Or call with an array of strings to parse, and optionally where the user arguments start by specifying where the arguments are `from`:
+       * - `'node'`: default, `argv[0]` is the application and `argv[1]` is the script being run, with user arguments after that
+       * - `'electron'`: `argv[0]` is the application and `argv[1]` varies depending on whether the electron application is packaged
+       * - `'user'`: just user arguments
        *
        * @example
-       * await program.parseAsync(process.argv);
-       * await program.parseAsync(); // implicitly use process.argv and auto-detect node vs electron conventions
+       * await program.parseAsync(); // parse process.argv and auto-detect electron and special node flags
+       * await program.parseAsync(process.argv); // assume argv[0] is app and argv[1] is script
        * await program.parseAsync(my-args, { from: 'user' }); // just user supplied arguments, nothing special about argv[0]
        *
        * @param {string[]} [argv]
-       * @param {Object} [parseOptions]
+       * @param {object} [parseOptions]
        * @param {string} parseOptions.from - where the args are from: 'node', 'user', 'electron'
        * @return {Promise}
        */
@@ -1813,10 +1875,12 @@ Expecting one of '${allowedValues.join("', '")}'`);
         let launchWithNode = false;
         const sourceExt = [".js", ".ts", ".tsx", ".mjs", ".cjs"];
         function findFile(baseDir, baseName) {
-          const localBin = path6.resolve(baseDir, baseName);
-          if (fs4.existsSync(localBin)) return localBin;
-          if (sourceExt.includes(path6.extname(baseName))) return void 0;
-          const foundExt = sourceExt.find((ext) => fs4.existsSync(`${localBin}${ext}`));
+          const localBin = path11.resolve(baseDir, baseName);
+          if (fs9.existsSync(localBin)) return localBin;
+          if (sourceExt.includes(path11.extname(baseName))) return void 0;
+          const foundExt = sourceExt.find(
+            (ext) => fs9.existsSync(`${localBin}${ext}`)
+          );
           if (foundExt) return `${localBin}${foundExt}`;
           return void 0;
         }
@@ -1827,23 +1891,32 @@ Expecting one of '${allowedValues.join("', '")}'`);
         if (this._scriptPath) {
           let resolvedScriptPath;
           try {
-            resolvedScriptPath = fs4.realpathSync(this._scriptPath);
+            resolvedScriptPath = fs9.realpathSync(this._scriptPath);
           } catch (err) {
             resolvedScriptPath = this._scriptPath;
           }
-          executableDir = path6.resolve(path6.dirname(resolvedScriptPath), executableDir);
+          executableDir = path11.resolve(
+            path11.dirname(resolvedScriptPath),
+            executableDir
+          );
         }
         if (executableDir) {
           let localFile = findFile(executableDir, executableFile);
           if (!localFile && !subcommand._executableFile && this._scriptPath) {
-            const legacyName = path6.basename(this._scriptPath, path6.extname(this._scriptPath));
+            const legacyName = path11.basename(
+              this._scriptPath,
+              path11.extname(this._scriptPath)
+            );
             if (legacyName !== this._name) {
-              localFile = findFile(executableDir, `${legacyName}-${subcommand._name}`);
+              localFile = findFile(
+                executableDir,
+                `${legacyName}-${subcommand._name}`
+              );
             }
           }
           executableFile = localFile || executableFile;
         }
-        launchWithNode = sourceExt.includes(path6.extname(executableFile));
+        launchWithNode = sourceExt.includes(path11.extname(executableFile));
         let proc;
         if (process2.platform !== "win32") {
           if (launchWithNode) {
@@ -1869,12 +1942,18 @@ Expecting one of '${allowedValues.join("', '")}'`);
           });
         }
         const exitCallback = this._exitCallback;
-        proc.on("close", (code, _signal) => {
+        proc.on("close", (code) => {
           code = code ?? 1;
           if (!exitCallback) {
             process2.exit(code);
           } else {
-            exitCallback(new CommanderError2(code, "commander.executeSubCommandAsync", "(close)"));
+            exitCallback(
+              new CommanderError2(
+                code,
+                "commander.executeSubCommandAsync",
+                "(close)"
+              )
+            );
           }
         });
         proc.on("error", (err) => {
@@ -1891,7 +1970,11 @@ Expecting one of '${allowedValues.join("', '")}'`);
           if (!exitCallback) {
             process2.exit(1);
           } else {
-            const wrappedError = new CommanderError2(1, "commander.executeSubCommandAsync", "(error)");
+            const wrappedError = new CommanderError2(
+              1,
+              "commander.executeSubCommandAsync",
+              "(error)"
+            );
             wrappedError.nestedError = err;
             exitCallback(wrappedError);
           }
@@ -1905,7 +1988,11 @@ Expecting one of '${allowedValues.join("', '")}'`);
         const subCommand = this._findCommand(commandName);
         if (!subCommand) this.help({ error: true });
         let promiseChain;
-        promiseChain = this._chainOrCallSubCommandHook(promiseChain, subCommand, "preSubcommand");
+        promiseChain = this._chainOrCallSubCommandHook(
+          promiseChain,
+          subCommand,
+          "preSubcommand"
+        );
         promiseChain = this._chainOrCall(promiseChain, () => {
           if (subCommand._executableHandler) {
             this._executeSubCommand(subCommand, operands.concat(unknown));
@@ -1929,9 +2016,11 @@ Expecting one of '${allowedValues.join("', '")}'`);
         if (subCommand && !subCommand._executableHandler) {
           subCommand.help();
         }
-        return this._dispatchSubcommand(subcommandName, [], [
-          this._getHelpOption()?.long ?? this._getHelpOption()?.short ?? "--help"
-        ]);
+        return this._dispatchSubcommand(
+          subcommandName,
+          [],
+          [this._getHelpOption()?.long ?? this._getHelpOption()?.short ?? "--help"]
+        );
       }
       /**
        * Check this.args against expected this.registeredArguments.
@@ -1961,7 +2050,12 @@ Expecting one of '${allowedValues.join("', '")}'`);
           let parsedValue = value;
           if (value !== null && argument.parseArg) {
             const invalidValueMessage = `error: command-argument value '${value}' is invalid for argument '${argument.name()}'.`;
-            parsedValue = this._callParseArg(argument, value, previous, invalidValueMessage);
+            parsedValue = this._callParseArg(
+              argument,
+              value,
+              previous,
+              invalidValueMessage
+            );
           }
           return parsedValue;
         };
@@ -2069,7 +2163,11 @@ Expecting one of '${allowedValues.join("', '")}'`);
         }
         if (this._defaultCommandName) {
           this._outputHelpIfRequested(unknown);
-          return this._dispatchSubcommand(this._defaultCommandName, operands, unknown);
+          return this._dispatchSubcommand(
+            this._defaultCommandName,
+            operands,
+            unknown
+          );
         }
         if (this.commands.length && this.args.length === 0 && !this._actionHandler && !this._defaultCommandName) {
           this.help({ error: true });
@@ -2088,7 +2186,10 @@ Expecting one of '${allowedValues.join("', '")}'`);
           this._processArguments();
           let promiseChain;
           promiseChain = this._chainOrCallHooks(promiseChain, "preAction");
-          promiseChain = this._chainOrCall(promiseChain, () => this._actionHandler(this.processedArgs));
+          promiseChain = this._chainOrCall(
+            promiseChain,
+            () => this._actionHandler(this.processedArgs)
+          );
           if (this.parent) {
             promiseChain = this._chainOrCall(promiseChain, () => {
               this.parent.emit(commandEvent, operands, unknown);
@@ -2125,17 +2226,20 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * Find matching command.
        *
        * @private
+       * @return {Command | undefined}
        */
       _findCommand(name) {
         if (!name) return void 0;
-        return this.commands.find((cmd) => cmd._name === name || cmd._aliases.includes(name));
+        return this.commands.find(
+          (cmd) => cmd._name === name || cmd._aliases.includes(name)
+        );
       }
       /**
        * Return an option matching `arg` if any.
        *
        * @param {string} arg
        * @return {Option}
-       * @package internal use only
+       * @package
        */
       _findOption(arg) {
         return this.options.find((option) => option.is(arg));
@@ -2161,15 +2265,13 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @private
        */
       _checkForConflictingLocalOptions() {
-        const definedNonDefaultOptions = this.options.filter(
-          (option) => {
-            const optionKey = option.attributeName();
-            if (this.getOptionValue(optionKey) === void 0) {
-              return false;
-            }
-            return this.getOptionValueSource(optionKey) !== "default";
+        const definedNonDefaultOptions = this.options.filter((option) => {
+          const optionKey = option.attributeName();
+          if (this.getOptionValue(optionKey) === void 0) {
+            return false;
           }
-        );
+          return this.getOptionValueSource(optionKey) !== "default";
+        });
         const optionsWithConflicting = definedNonDefaultOptions.filter(
           (option) => option.conflictsWith.length > 0
         );
@@ -2299,7 +2401,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
       /**
        * Return an object containing local option values as key-value pairs.
        *
-       * @return {Object}
+       * @return {object}
        */
       opts() {
         if (this._storeOptionsAsProperties) {
@@ -2316,7 +2418,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
       /**
        * Return an object containing merged local and global option values as key-value pairs.
        *
-       * @return {Object}
+       * @return {object}
        */
       optsWithGlobals() {
         return this._getCommandAndAncestors().reduce(
@@ -2328,13 +2430,16 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * Display error message and exit (or call exitOverride).
        *
        * @param {string} message
-       * @param {Object} [errorOptions]
+       * @param {object} [errorOptions]
        * @param {string} [errorOptions.code] - an id string representing the error
        * @param {number} [errorOptions.exitCode] - used with process.exit
        */
       error(message, errorOptions) {
-        this._outputConfiguration.outputError(`${message}
-`, this._outputConfiguration.writeErr);
+        this._outputConfiguration.outputError(
+          `${message}
+`,
+          this._outputConfiguration.writeErr
+        );
         if (typeof this._showHelpAfterError === "string") {
           this._outputConfiguration.writeErr(`${this._showHelpAfterError}
 `);
@@ -2357,7 +2462,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
         this.options.forEach((option) => {
           if (option.envVar && option.envVar in process2.env) {
             const optionKey = option.attributeName();
-            if (this.getOptionValue(optionKey) === void 0 || ["default", "config", "env"].includes(this.getOptionValueSource(optionKey))) {
+            if (this.getOptionValue(optionKey) === void 0 || ["default", "config", "env"].includes(
+              this.getOptionValueSource(optionKey)
+            )) {
               if (option.required || option.optional) {
                 this.emit(`optionEnv:${option.name()}`, process2.env[option.envVar]);
               } else {
@@ -2377,9 +2484,18 @@ Expecting one of '${allowedValues.join("', '")}'`);
         const hasCustomOptionValue = (optionKey) => {
           return this.getOptionValue(optionKey) !== void 0 && !["default", "implied"].includes(this.getOptionValueSource(optionKey));
         };
-        this.options.filter((option) => option.implied !== void 0 && hasCustomOptionValue(option.attributeName()) && dualHelper.valueFromOption(this.getOptionValue(option.attributeName()), option)).forEach((option) => {
+        this.options.filter(
+          (option) => option.implied !== void 0 && hasCustomOptionValue(option.attributeName()) && dualHelper.valueFromOption(
+            this.getOptionValue(option.attributeName()),
+            option
+          )
+        ).forEach((option) => {
           Object.keys(option.implied).filter((impliedKey) => !hasCustomOptionValue(impliedKey)).forEach((impliedKey) => {
-            this.setOptionValueWithSource(impliedKey, option.implied[impliedKey], "implied");
+            this.setOptionValueWithSource(
+              impliedKey,
+              option.implied[impliedKey],
+              "implied"
+            );
           });
         });
       }
@@ -2424,8 +2540,12 @@ Expecting one of '${allowedValues.join("', '")}'`);
         const findBestOptionFromValue = (option2) => {
           const optionKey = option2.attributeName();
           const optionValue = this.getOptionValue(optionKey);
-          const negativeOption = this.options.find((target) => target.negate && optionKey === target.attributeName());
-          const positiveOption = this.options.find((target) => !target.negate && optionKey === target.attributeName());
+          const negativeOption = this.options.find(
+            (target) => target.negate && optionKey === target.attributeName()
+          );
+          const positiveOption = this.options.find(
+            (target) => !target.negate && optionKey === target.attributeName()
+          );
           if (negativeOption && (negativeOption.presetArg === void 0 && optionValue === false || negativeOption.presetArg !== void 0 && optionValue === negativeOption.presetArg)) {
             return negativeOption;
           }
@@ -2529,11 +2649,12 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * Set the description.
        *
        * @param {string} [str]
-       * @param {Object} [argsDescription]
+       * @param {object} [argsDescription]
        * @return {(string|Command)}
        */
       description(str, argsDescription) {
-        if (str === void 0 && argsDescription === void 0) return this._description;
+        if (str === void 0 && argsDescription === void 0)
+          return this._description;
         this._description = str;
         if (argsDescription) {
           this._argsDescription = argsDescription;
@@ -2565,11 +2686,14 @@ Expecting one of '${allowedValues.join("', '")}'`);
         if (this.commands.length !== 0 && this.commands[this.commands.length - 1]._executableHandler) {
           command = this.commands[this.commands.length - 1];
         }
-        if (alias === command._name) throw new Error("Command alias can't be the same as its name");
+        if (alias === command._name)
+          throw new Error("Command alias can't be the same as its name");
         const matchingCommand = this.parent?._findCommand(alias);
         if (matchingCommand) {
           const existingCmd = [matchingCommand.name()].concat(matchingCommand.aliases()).join("|");
-          throw new Error(`cannot add alias '${alias}' to command '${this.name()}' as already have command '${existingCmd}'`);
+          throw new Error(
+            `cannot add alias '${alias}' to command '${this.name()}' as already have command '${existingCmd}'`
+          );
         }
         command._aliases.push(alias);
         return this;
@@ -2632,7 +2756,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @return {Command}
        */
       nameFromFilename(filename) {
-        this._name = path6.basename(filename, path6.extname(filename));
+        this._name = path11.basename(filename, path11.extname(filename));
         return this;
       }
       /**
@@ -2646,9 +2770,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @param {string} [path]
        * @return {(string|null|Command)}
        */
-      executableDir(path7) {
-        if (path7 === void 0) return this._executableDir;
-        this._executableDir = path7;
+      executableDir(path12) {
+        if (path12 === void 0) return this._executableDir;
+        this._executableDir = path12;
         return this;
       }
       /**
@@ -2708,7 +2832,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
           this.emit(this._getHelpOption().long);
         }
         this.emit("afterHelp", context2);
-        this._getCommandAndAncestors().forEach((command) => command.emit("afterAllHelp", context2));
+        this._getCommandAndAncestors().forEach(
+          (command) => command.emit("afterAllHelp", context2)
+        );
       }
       /**
        * You can pass in flags and a description to customise the built-in help option.
@@ -2741,7 +2867,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * Returns null if has been disabled with .helpOption(false).
        *
        * @returns {(Option | null)} the help option
-       * @package internal use only
+       * @package
        */
       _getHelpOption() {
         if (this._helpOption === void 0) {
@@ -2876,8 +3002,206 @@ var require_commander = __commonJS({
   }
 });
 
+// ../../node_modules/uWebSockets.js/uws_darwin_arm64_127.node
+var require_uws_darwin_arm64_127 = __commonJS({
+  "../../node_modules/uWebSockets.js/uws_darwin_arm64_127.node"(exports, module) {
+    module.exports = "./uws_darwin_arm64_127-NGHTXN5Q.node";
+  }
+});
+
+// ../../node_modules/uWebSockets.js/uws_darwin_arm64_137.node
+var require_uws_darwin_arm64_137 = __commonJS({
+  "../../node_modules/uWebSockets.js/uws_darwin_arm64_137.node"(exports, module) {
+    module.exports = "./uws_darwin_arm64_137-ESY6MPLH.node";
+  }
+});
+
+// ../../node_modules/uWebSockets.js/uws_darwin_arm64_147.node
+var require_uws_darwin_arm64_147 = __commonJS({
+  "../../node_modules/uWebSockets.js/uws_darwin_arm64_147.node"(exports, module) {
+    module.exports = "./uws_darwin_arm64_147-V7BKA3SU.node";
+  }
+});
+
+// ../../node_modules/uWebSockets.js/uws_darwin_x64_127.node
+var require_uws_darwin_x64_127 = __commonJS({
+  "../../node_modules/uWebSockets.js/uws_darwin_x64_127.node"(exports, module) {
+    module.exports = "./uws_darwin_x64_127-WIZGG7MS.node";
+  }
+});
+
+// ../../node_modules/uWebSockets.js/uws_darwin_x64_137.node
+var require_uws_darwin_x64_137 = __commonJS({
+  "../../node_modules/uWebSockets.js/uws_darwin_x64_137.node"(exports, module) {
+    module.exports = "./uws_darwin_x64_137-APKZWL4Y.node";
+  }
+});
+
+// ../../node_modules/uWebSockets.js/uws_darwin_x64_147.node
+var require_uws_darwin_x64_147 = __commonJS({
+  "../../node_modules/uWebSockets.js/uws_darwin_x64_147.node"(exports, module) {
+    module.exports = "./uws_darwin_x64_147-W2HKFQZT.node";
+  }
+});
+
+// ../../node_modules/uWebSockets.js/uws_linux_arm64_127.node
+var require_uws_linux_arm64_127 = __commonJS({
+  "../../node_modules/uWebSockets.js/uws_linux_arm64_127.node"(exports, module) {
+    module.exports = "./uws_linux_arm64_127-3CO7NSFJ.node";
+  }
+});
+
+// ../../node_modules/uWebSockets.js/uws_linux_arm64_137.node
+var require_uws_linux_arm64_137 = __commonJS({
+  "../../node_modules/uWebSockets.js/uws_linux_arm64_137.node"(exports, module) {
+    module.exports = "./uws_linux_arm64_137-HWEDGGZV.node";
+  }
+});
+
+// ../../node_modules/uWebSockets.js/uws_linux_arm64_147.node
+var require_uws_linux_arm64_147 = __commonJS({
+  "../../node_modules/uWebSockets.js/uws_linux_arm64_147.node"(exports, module) {
+    module.exports = "./uws_linux_arm64_147-7UCIYMK2.node";
+  }
+});
+
+// ../../node_modules/uWebSockets.js/uws_linux_x64_127.node
+var require_uws_linux_x64_127 = __commonJS({
+  "../../node_modules/uWebSockets.js/uws_linux_x64_127.node"(exports, module) {
+    module.exports = "./uws_linux_x64_127-KA4E76LJ.node";
+  }
+});
+
+// ../../node_modules/uWebSockets.js/uws_linux_x64_137.node
+var require_uws_linux_x64_137 = __commonJS({
+  "../../node_modules/uWebSockets.js/uws_linux_x64_137.node"(exports, module) {
+    module.exports = "./uws_linux_x64_137-DDFLTTJR.node";
+  }
+});
+
+// ../../node_modules/uWebSockets.js/uws_linux_x64_147.node
+var require_uws_linux_x64_147 = __commonJS({
+  "../../node_modules/uWebSockets.js/uws_linux_x64_147.node"(exports, module) {
+    module.exports = "./uws_linux_x64_147-MJSFREL3.node";
+  }
+});
+
+// ../../node_modules/uWebSockets.js/uws_win32_x64_127.node
+var require_uws_win32_x64_127 = __commonJS({
+  "../../node_modules/uWebSockets.js/uws_win32_x64_127.node"(exports, module) {
+    module.exports = "./uws_win32_x64_127-O4US4Y4L.node";
+  }
+});
+
+// ../../node_modules/uWebSockets.js/uws_win32_x64_137.node
+var require_uws_win32_x64_137 = __commonJS({
+  "../../node_modules/uWebSockets.js/uws_win32_x64_137.node"(exports, module) {
+    module.exports = "./uws_win32_x64_137-L5OZROQ7.node";
+  }
+});
+
+// ../../node_modules/uWebSockets.js/uws_win32_x64_147.node
+var require_uws_win32_x64_147 = __commonJS({
+  "../../node_modules/uWebSockets.js/uws_win32_x64_147.node"(exports, module) {
+    module.exports = "./uws_win32_x64_147-D7MGKVRG.node";
+  }
+});
+
+// require("./uws_*_*_*.node") in ../../node_modules/uWebSockets.js/uws.js
+var globRequire_uws______node;
+var init_ = __esm({
+  'require("./uws_*_*_*.node") in ../../node_modules/uWebSockets.js/uws.js'() {
+    globRequire_uws______node = __glob({
+      "./uws_darwin_arm64_127.node": () => require_uws_darwin_arm64_127(),
+      "./uws_darwin_arm64_137.node": () => require_uws_darwin_arm64_137(),
+      "./uws_darwin_arm64_147.node": () => require_uws_darwin_arm64_147(),
+      "./uws_darwin_x64_127.node": () => require_uws_darwin_x64_127(),
+      "./uws_darwin_x64_137.node": () => require_uws_darwin_x64_137(),
+      "./uws_darwin_x64_147.node": () => require_uws_darwin_x64_147(),
+      "./uws_linux_arm64_127.node": () => require_uws_linux_arm64_127(),
+      "./uws_linux_arm64_137.node": () => require_uws_linux_arm64_137(),
+      "./uws_linux_arm64_147.node": () => require_uws_linux_arm64_147(),
+      "./uws_linux_x64_127.node": () => require_uws_linux_x64_127(),
+      "./uws_linux_x64_137.node": () => require_uws_linux_x64_137(),
+      "./uws_linux_x64_147.node": () => require_uws_linux_x64_147(),
+      "./uws_win32_x64_127.node": () => require_uws_win32_x64_127(),
+      "./uws_win32_x64_137.node": () => require_uws_win32_x64_137(),
+      "./uws_win32_x64_147.node": () => require_uws_win32_x64_147()
+    });
+  }
+});
+
+// ../../node_modules/uWebSockets.js/uws.js
+var require_uws = __commonJS({
+  "../../node_modules/uWebSockets.js/uws.js"(exports, module) {
+    init_();
+    module.exports = (() => {
+      try {
+        return globRequire_uws______node("./uws_" + process.platform + "_" + process.arch + "_" + process.versions.modules + ".node");
+      } catch (e) {
+        throw new Error("This version of uWS.js (v20.67.0) supports only Node.js versions 22, 24 and 26 on (glibc) Linux, macOS and Windows, on Tier 1 platforms (https://github.com/nodejs/node/blob/master/BUILDING.md#platform-list).\n\n" + e.toString());
+      }
+    })();
+    var MAX_U8 = Math.pow(2, 8) - 1;
+    var MAX_U16 = Math.pow(2, 16) - 1;
+    var textEncoder = new TextEncoder();
+    var toUint8Array = (value) => {
+      if (value === void 0) return new Uint8Array(0);
+      else if (typeof value === "string") return textEncoder.encode(value);
+      else if (value instanceof ArrayBuffer) return new Uint8Array(value);
+      else if (value instanceof SharedArrayBuffer) return new Uint8Array(value);
+      else return new Uint8Array(value.buffer, value.byteOffset, value.byteLength);
+    };
+    module.exports.DeclarativeResponse = class DeclarativeResponse {
+      constructor() {
+        this.instructions = [];
+      }
+      // Append instruction and 1-byte length values
+      _appendInstruction(opcode, ...values) {
+        this.instructions.push(opcode);
+        values.forEach((value) => {
+          const uint8Array = toUint8Array(value);
+          if (uint8Array.byteLength > MAX_U8) throw new RangeError("Data length exceeds " + MAX_U8);
+          this.instructions.push(uint8Array.byteLength, ...uint8Array);
+        });
+      }
+      // Append instruction and 2-byte length value
+      _appendInstructionWithLength(opcode, value) {
+        const uint8Array = toUint8Array(value);
+        if (uint8Array.byteLength > MAX_U16) throw new RangeError("Data length exceeds " + MAX_U16);
+        this.instructions.push(opcode, uint8Array.byteLength & 255, uint8Array.byteLength >> 8 & 255, ...uint8Array);
+      }
+      writeHeader(key, value) {
+        return this._appendInstruction(1, key, value), this;
+      }
+      writeBody() {
+        return this.instructions.push(2), this;
+      }
+      writeQueryValue(key) {
+        return this._appendInstruction(3, key), this;
+      }
+      writeHeaderValue(key) {
+        return this._appendInstruction(4, key), this;
+      }
+      write(value) {
+        return this._appendInstructionWithLength(5, value), this;
+      }
+      writeParameterValue(key) {
+        return this._appendInstruction(6, key), this;
+      }
+      writeStatus(status) {
+        return this._appendInstruction(7, status), this;
+      }
+      end(value) {
+        this._appendInstructionWithLength(0, value);
+        return new Uint8Array(this.instructions).buffer;
+      }
+    };
+  }
+});
+
 // node_modules/commander/esm.mjs
-var import_index = __toESM(require_commander());
+var import_index = __toESM(require_commander(), 1);
 var {
   program,
   createCommand,
@@ -2895,12 +3219,12 @@ var {
 
 // package.json
 var package_default = {
-  version: "5.0.0"};
+  version: "6.0.0"};
 var ALWAYS_EXTERNAL = ["uWebSockets.js"];
 function getUserExternals(cwd) {
   let pkgExternals = [];
   try {
-    const pkgPath = path4.join(cwd, "package.json");
+    const pkgPath = path7.join(cwd, "package.json");
     if (fs.existsSync(pkgPath)) {
       const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
       const deps = Object.keys(pkg.dependencies || {});
@@ -2918,8 +3242,8 @@ function getUserExternals(cwd) {
 
 // src/commands/build.ts
 async function buildProject(entry) {
-  const entryPath = path4.resolve(process.cwd(), entry);
-  const outPath = path4.resolve(process.cwd(), "dist/index.js");
+  const entryPath = path7.resolve(process.cwd(), entry);
+  const outPath = path7.resolve(process.cwd(), "dist/index.js");
   const userExternals = getUserExternals(process.cwd());
   console.log(`\u{1F528} Building production bundle from ${entry}...`);
   try {
@@ -2939,9 +3263,388 @@ async function buildProject(entry) {
     process.exit(1);
   }
 }
+function colourMethod(method) {
+  const m = method.toUpperCase();
+  const padded = m.padEnd(7);
+  switch (m) {
+    case "GET":
+      return pc.bold(pc.green(padded));
+    case "POST":
+      return pc.bold(pc.blue(padded));
+    case "PUT":
+      return pc.bold(pc.yellow(padded));
+    case "PATCH":
+      return pc.bold(pc.magenta(padded));
+    case "DELETE":
+      return pc.bold(pc.red(padded));
+    case "HEAD":
+      return pc.dim(padded);
+    case "OPTIONS":
+      return pc.dim(padded);
+    case "WS":
+      return pc.bold(pc.cyan(padded));
+    default:
+      return padded;
+  }
+}
+var badge = {
+  validation(label) {
+    return pc.cyan(label);
+  },
+  deprecated() {
+    return pc.bold(pc.red("\u2298 DEPRECATED"));
+  },
+  timeout(ms) {
+    return pc.dim(`${ms}ms`);
+  },
+  tags(tags) {
+    if (!tags.length) return "";
+    return tags.map((t) => pc.dim(`#${t}`)).join(" ");
+  }
+};
+function visibleLength(s) {
+  return s.replace(/\x1b\[[0-9;]*m/g, "").length;
+}
+function pad(s, width, align) {
+  const v = visibleLength(s);
+  if (v >= width) return s;
+  const filler = " ".repeat(width - v);
+  return align === "right" ? filler + s : s + filler;
+}
+function truncate(s, max) {
+  if (visibleLength(s) <= max) return s;
+  const stripped = s.replace(/\x1b\[[0-9;]*m/g, "");
+  return stripped.slice(0, max - 1) + pc.dim("\u2026");
+}
+function renderTable(columns, rows, terminalWidth = process.stdout.columns || 100) {
+  const widths = columns.map((col, i) => {
+    const headerW = visibleLength(col.header);
+    const cellW = Math.max(
+      headerW,
+      ...rows.map((r) => visibleLength(r[i] ?? ""))
+    );
+    let w = Math.max(headerW, cellW);
+    if (col.minWidth) w = Math.max(w, col.minWidth);
+    if (col.maxWidth) w = Math.min(w, col.maxWidth);
+    return w;
+  });
+  const overheadPerSep = 3;
+  const overhead = (columns.length + 1) * 2 + overheadPerSep * (columns.length - 1);
+  let total = widths.reduce((a, b) => a + b, 0) + overhead;
+  if (total > terminalWidth) {
+    const flexIdx = columns.map((c, i) => ({ c, i })).filter(({ c }) => !c.minWidth).map(({ i }) => i);
+    let excess = total - terminalWidth;
+    for (let pass = 0; pass < 8 && excess > 0; pass++) {
+      for (const i of flexIdx) {
+        if (excess <= 0) break;
+        if (widths[i] > 8) {
+          widths[i]--;
+          excess--;
+          total--;
+        }
+      }
+    }
+  }
+  const bar = (l, m, r) => l + widths.map((w) => "\u2500".repeat(w + 2)).join(m) + r;
+  const lines = [];
+  lines.push(pc.dim(bar("\u250C", "\u252C", "\u2510")));
+  lines.push(
+    pc.dim("\u2502 ") + columns.map((c, i) => pc.bold(pad(c.header, widths[i], c.align ?? "left"))).join(pc.dim(" \u2502 ")) + pc.dim(" \u2502")
+  );
+  lines.push(pc.dim(bar("\u251C", "\u253C", "\u2524")));
+  for (const row of rows) {
+    lines.push(
+      pc.dim("\u2502 ") + columns.map((c, i) => {
+        const cell = row[i] ?? "";
+        const truncated = c.maxWidth ? truncate(cell, widths[i]) : cell;
+        return pad(truncated, widths[i], c.align ?? "left");
+      }).join(pc.dim(" \u2502 ")) + pc.dim(" \u2502")
+    );
+  }
+  lines.push(pc.dim(bar("\u2514", "\u2534", "\u2518")));
+  return lines.join("\n");
+}
+function pluralise(n, singular, plural) {
+  return n === 1 ? `${n} ${singular}` : `${n} ${plural ?? singular + "s"}`;
+}
+var symbols = {
+  ok: pc.green("\u2713"),
+  warn: pc.yellow("\u26A0"),
+  fail: pc.red("\u2717"),
+  info: pc.cyan("\u2139"),
+  bullet: pc.dim("\u2022"),
+  arrow: pc.dim("\u2192")
+};
+async function loadApp(entry) {
+  const entryPath = path7.resolve(process.cwd(), entry);
+  const tempDir = path7.resolve(process.cwd(), ".axiomify");
+  const tempPath = path7.join(tempDir, "inspect.cjs");
+  const userExternals = getUserExternals(process.cwd());
+  await esbuild.build({
+    entryPoints: [entryPath],
+    bundle: true,
+    platform: "node",
+    format: "cjs",
+    outfile: tempPath,
+    external: [.../* @__PURE__ */ new Set([...userExternals, "node:*"])],
+    // Silence esbuild's own progress chatter — the CLI command above is
+    // responsible for its own user-facing output.
+    logLevel: "error"
+  });
+  try {
+    delete __require.cache[__require.resolve(tempPath)];
+  } catch {
+  }
+  const hangTimer = setTimeout(() => {
+    process.stderr.write(
+      "\n" + pc.yellow("\u26A0  CLI inspection is taking longer than expected.") + "\n   Your entry file may be starting a server unconditionally.\n   Wrap the listen() call in " + pc.cyan("if (require.main === module) { ... }") + " so it only runs when executed directly.\n\n"
+    );
+  }, 5e3);
+  hangTimer.unref();
+  let mod;
+  try {
+    mod = __require(tempPath);
+  } finally {
+    clearTimeout(hangTimer);
+  }
+  const app = mod.app ?? mod.default;
+  if (!app || typeof app.registeredRoutes === "undefined") {
+    await fs5.rm(tempDir, { recursive: true, force: true }).catch(() => {
+    });
+    throw new Error(
+      "Could not find an exported Axiomify instance.\nEnsure your entry file exports the app:\n  export const app = new Axiomify();\nor:\n  export default app;"
+    );
+  }
+  const cleanup = async () => {
+    await fs5.rm(tempDir, { recursive: true, force: true }).catch(() => {
+    });
+  };
+  return { app, cleanup };
+}
+
+// src/commands/check.ts
+function add(ctx, f) {
+  ctx.findings.push(f);
+}
+function checkRequestId(ctx) {
+  const onRequest = ctx.app.hooks?.hooks?.onRequest ?? [];
+  if (onRequest.length === 0) {
+    add(ctx, {
+      severity: "warn",
+      area: "observability",
+      message: "`app.enableRequestId()` has not been called",
+      hint: "Distributed-trace correlation will be impossible without an X-Request-Id header. Add `app.enableRequestId()` after construction unless you handle this elsewhere."
+    });
+    return;
+  }
+  add(ctx, {
+    severity: "ok",
+    area: "observability",
+    message: `onRequest hooks: ${onRequest.length} registered`
+  });
+}
+function checkEnvVars(ctx) {
+  const expectedInProd = ["JWT_SECRET", "NODE_ENV"];
+  for (const key of expectedInProd) {
+    if (!ctx.envKeys.has(key)) continue;
+    if (process.env[key]) {
+      add(ctx, { severity: "ok", area: "env", message: `${key} is set` });
+    } else {
+      add(ctx, {
+        severity: "warn",
+        area: "env",
+        message: `${key} referenced in source but not set in environment`,
+        hint: key === "JWT_SECRET" ? "Set this before deploying. Generate one via `node -e \"console.log(require('crypto').randomBytes(48).toString('base64'))\"`" : `Ensure ${key} is set in your deployment environment.`
+      });
+    }
+  }
+}
+function checkResponseSchemas(ctx) {
+  const routes = ctx.app.registeredRoutes ?? [];
+  const missing = routes.filter(
+    (r) => r.schema?.body && !r.schema?.response
+  );
+  if (missing.length > 0) {
+    add(ctx, {
+      severity: "warn",
+      area: "validation",
+      message: `${missing.length} route${missing.length === 1 ? "" : "s"} with body schema but no response schema`,
+      hint: `Declaring \`schema.response\` pins the API contract \u2014 without it, internal model field names leak to clients and breaking changes go undetected. First offender: ${missing[0].method} ${missing[0].path}`
+    });
+  } else if (routes.length > 0) {
+    add(ctx, {
+      severity: "ok",
+      area: "validation",
+      message: "every route with a body schema also declares a response schema"
+    });
+  }
+}
+function checkOpenApiNaming(ctx) {
+  const routes = ctx.app.registeredRoutes ?? [];
+  const usingMeta = routes.filter((r) => r.meta);
+  if (usingMeta.length > 0) {
+    add(ctx, {
+      severity: "fail",
+      area: "api",
+      message: `${usingMeta.length} route${usingMeta.length === 1 ? "" : "s"} use the removed \`meta:\` field`,
+      hint: `The \`meta:\` field was removed in 6.0. Move all metadata into \`schema:\` \u2014 e.g. schema: { tags: ['Users'], summary: '...' }. First offender: ${usingMeta[0].method} ${usingMeta[0].path}`
+    });
+  }
+  const usingOpenapi = routes.filter((r) => r.openapi);
+  if (usingOpenapi.length > 0) {
+    add(ctx, {
+      severity: "fail",
+      area: "api",
+      message: `${usingOpenapi.length} route${usingOpenapi.length === 1 ? "" : "s"} use the removed top-level \`openapi:\` field`,
+      hint: `The separate \`openapi:\` property was removed in 6.1. Move all metadata directly into \`schema:\` alongside your Zod fields. Run \`npx axiomify migrate\` to apply automatically. First offender: ${usingOpenapi[0].method} ${usingOpenapi[0].path}`
+    });
+  }
+}
+function checkHealthCheck(ctx) {
+  const routes = ctx.app.registeredRoutes ?? [];
+  const hasHealth = routes.some(
+    (r) => r.method === "GET" && ["/health", "/healthz", "/-/health", "/ping", "/live", "/ready"].some(
+      (p) => r.path === p
+    )
+  );
+  if (hasHealth) {
+    add(ctx, { severity: "ok", area: "ops", message: "health-check route registered" });
+  } else {
+    add(ctx, {
+      severity: "warn",
+      area: "ops",
+      message: "no health-check route detected",
+      hint: 'Kubernetes, ECS, and load balancers expect a `/health` (or similar) endpoint. Register one via `app.healthCheck("/health")` from `@axiomify/core`.'
+    });
+  }
+}
+function checkOpenApiExposure(ctx) {
+  const routes = ctx.app.registeredRoutes ?? [];
+  const docsRoute = routes.find(
+    (r) => r.method === "GET" && (r.path === "/docs" || r.path.endsWith("/docs"))
+  );
+  const specRoute = routes.find(
+    (r) => r.method === "GET" && r.path.endsWith("/openapi.json")
+  );
+  if (docsRoute || specRoute) {
+    add(ctx, {
+      severity: "warn",
+      area: "security",
+      message: "OpenAPI docs endpoint is registered",
+      hint: "In production, supply `protect: (req) => ...` to `useOpenAPI()` (or set `allowPublicInProduction: true` if exposure is intentional). The runtime warning is logged on the first request."
+    });
+  }
+}
+function checkRoutesLockState(ctx) {
+  if (ctx.app._routesLocked) {
+    add(ctx, {
+      severity: "warn",
+      area: "config",
+      message: "app.lockRoutes() has already been called",
+      hint: "The entry file appears to construct an adapter at the top level. Wrap adapter construction in `if (require.main === module) { ... }` so the CLI can introspect the app without triggering it."
+    });
+  }
+}
+function checkSecurityPlugins(ctx) {
+  const onRequest = ctx.app.hooks?.hooks?.onRequest ?? [];
+  if (onRequest.length < 2) {
+    add(ctx, {
+      severity: "warn",
+      area: "security",
+      message: "few onRequest hooks detected \u2014 security plugins may not be registered",
+      hint: "`@axiomify/helmet`, `@axiomify/cors`, and `@axiomify/security` each install onRequest hooks. If you are not using these, ensure equivalent defences are in place elsewhere."
+    });
+  } else {
+    add(ctx, {
+      severity: "ok",
+      area: "security",
+      message: `${onRequest.length} onRequest hooks registered (security plugins likely active)`
+    });
+  }
+}
+function collectEnvKeysFromBundle(bundlePath) {
+  const keys = /* @__PURE__ */ new Set();
+  try {
+    const src = fs.readFileSync(bundlePath, "utf8");
+    const re = /process\.env\.([A-Z][A-Z0-9_]*)|process\.env\[(['"])([A-Z][A-Z0-9_]*)\2\]/g;
+    let m;
+    while ((m = re.exec(src)) !== null) {
+      keys.add(m[1] ?? m[3]);
+    }
+  } catch {
+  }
+  return keys;
+}
+function loadPkgJson(cwd) {
+  try {
+    return JSON.parse(fs.readFileSync(path7.join(cwd, "package.json"), "utf8"));
+  } catch {
+    return null;
+  }
+}
+async function runCheck(entry) {
+  let app;
+  let cleanup = async () => {
+  };
+  let bundlePath = "";
+  try {
+    const loaded = await loadApp(entry);
+    app = loaded.app;
+    cleanup = loaded.cleanup;
+    bundlePath = path7.resolve(process.cwd(), ".axiomify/inspect.cjs");
+  } catch (err) {
+    console.error(pc.red("\u2717 Failed to load app:"));
+    console.error(err.message);
+    process.exit(1);
+  }
+  const ctx = {
+    app,
+    cwd: process.cwd(),
+    findings: [],
+    pkgJson: loadPkgJson(process.cwd()),
+    envKeys: collectEnvKeysFromBundle(bundlePath)
+  };
+  checkEnvVars(ctx);
+  checkRequestId(ctx);
+  checkRoutesLockState(ctx);
+  checkOpenApiNaming(ctx);
+  checkSecurityPlugins(ctx);
+  checkOpenApiExposure(ctx);
+  checkResponseSchemas(ctx);
+  checkHealthCheck(ctx);
+  await cleanup();
+  console.log();
+  console.log(pc.bold("  \u{1F50D} Production-readiness check"));
+  console.log();
+  const sevOrder = { fail: 0, warn: 1, ok: 2 };
+  ctx.findings.sort(
+    (a, b) => sevOrder[a.severity] - sevOrder[b.severity] || a.area.localeCompare(b.area)
+  );
+  const sym = {
+    ok: symbols.ok,
+    warn: symbols.warn,
+    fail: symbols.fail
+  };
+  for (const f of ctx.findings) {
+    const tag = pc.dim(`[${f.area}]`);
+    console.log(`  ${sym[f.severity]} ${tag} ${f.message}`);
+    if (f.hint && f.severity !== "ok") {
+      const wrapped = f.hint.replace(/(.{1,80})(\s+|$)/g, "\n      " + pc.dim("$1"));
+      console.log(wrapped);
+    }
+  }
+  const fails = ctx.findings.filter((f) => f.severity === "fail").length;
+  const warns = ctx.findings.filter((f) => f.severity === "warn").length;
+  const oks = ctx.findings.filter((f) => f.severity === "ok").length;
+  console.log();
+  const summary = `  ${symbols.ok} ${pluralise(oks, "pass", "passes")}` + pc.dim("  \xB7  ") + (warns > 0 ? `${symbols.warn} ${pluralise(warns, "warning")}` : pc.dim("0 warnings")) + pc.dim("  \xB7  ") + (fails > 0 ? `${symbols.fail} ${pluralise(fails, "failure")}` : pc.dim("0 failures"));
+  console.log(summary);
+  console.log();
+  if (fails > 0) process.exit(1);
+}
 async function devServer(entry) {
-  const entryPath = path4.resolve(process.cwd(), entry);
-  const outPath = path4.resolve(process.cwd(), ".axiomify/dev.js");
+  const entryPath = path7.resolve(process.cwd(), entry);
+  const outPath = path7.resolve(process.cwd(), ".axiomify/dev.js");
   let child = null;
   let firstBuild = true;
   const startChild = () => {
@@ -3021,6 +3724,213 @@ async function devServer(entry) {
   console.log(`\u{1F440} Axiomify Dev Engine watching for changes...`);
   await ctx.watch();
 }
+function add2(findings, f) {
+  findings.push(f);
+}
+function probePort(port) {
+  return new Promise((resolve) => {
+    const server = createServer();
+    server.once("error", (err) => {
+      if (err.code === "EADDRINUSE") resolve("busy");
+      else if (err.code === "EACCES") resolve("denied");
+      else resolve("busy");
+    });
+    server.once("listening", () => {
+      server.close(() => resolve("free"));
+    });
+    server.listen(port, "127.0.0.1");
+  });
+}
+function checkNodeVersion(findings) {
+  const major = parseInt(process.versions.node.split(".")[0], 10);
+  if (major < 18) {
+    add2(findings, {
+      severity: "fail",
+      area: "node",
+      message: `Node ${process.versions.node} is below the supported minimum`,
+      hint: "Axiomify requires Node 18 or later. Upgrade via nvm: `nvm install 22 && nvm use 22`."
+    });
+  } else if (major > 22) {
+    add2(findings, {
+      severity: "warn",
+      area: "node",
+      message: `Node ${process.versions.node} \u2014 uWebSockets.js has no prebuilt binary for this version`,
+      hint: "Tests and benchmarks that need a real uWS listener will skip; the framework still builds. For a runnable production deploy, downgrade to Node 22 LTS."
+    });
+  } else {
+    add2(findings, {
+      severity: "ok",
+      area: "node",
+      message: `Node ${process.versions.node} (uWS prebuilt available)`
+    });
+  }
+}
+function checkPlatform(findings) {
+  if (process.platform === "linux") {
+    add2(findings, {
+      severity: "ok",
+      area: "platform",
+      message: "Linux \u2014 SO_REUSEPORT clustering supported natively"
+    });
+  } else {
+    add2(findings, {
+      severity: "warn",
+      area: "platform",
+      message: `${process.platform} \u2014 \`listenClustered()\` requires \`allowUserspaceProxy: true\``,
+      hint: "Clustering on non-Linux falls back to a userspace L4 proxy that adds two event-loop hops per byte. Single-process `listen()` is the recommended path on this OS."
+    });
+  }
+}
+function checkDependencyDrift(findings) {
+  try {
+    const pkgPath = path7.join(process.cwd(), "package.json");
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+    const all = { ...pkg.dependencies, ...pkg.devDependencies };
+    const axiomifyDeps = Object.entries(all).filter(
+      ([k]) => k.startsWith("@axiomify/")
+    );
+    if (axiomifyDeps.length === 0) {
+      add2(findings, {
+        severity: "warn",
+        area: "deps",
+        message: "No @axiomify/* packages found in package.json",
+        hint: "Run this from the root of a project that uses Axiomify."
+      });
+      return;
+    }
+    const versions = new Set(
+      axiomifyDeps.map(([, v]) => v.replace(/^[\^~]/, "").replace(/^\*$/, "workspace"))
+    );
+    if (versions.size > 1) {
+      add2(findings, {
+        severity: "warn",
+        area: "deps",
+        message: `@axiomify/* packages are on ${versions.size} different versions`,
+        hint: "Mixed @axiomify/* versions can cause subtle compat issues. Pin them all to the same version: " + [...versions].join(", ")
+      });
+    } else {
+      add2(findings, {
+        severity: "ok",
+        area: "deps",
+        message: `${axiomifyDeps.length} @axiomify/* packages aligned (${[...versions][0]})`
+      });
+    }
+  } catch {
+    add2(findings, {
+      severity: "warn",
+      area: "deps",
+      message: "Could not read package.json",
+      hint: "Run `axiomify doctor` from a project root."
+    });
+  }
+}
+function checkUwsLoads(findings) {
+  try {
+    require_uws();
+    add2(findings, {
+      severity: "ok",
+      area: "uws",
+      message: "uWebSockets.js loads successfully"
+    });
+  } catch (err) {
+    const msg = String(err.message ?? err);
+    if (msg.includes("Cannot find module")) {
+      add2(findings, {
+        severity: "warn",
+        area: "uws",
+        message: "uWebSockets.js is not installed in this project",
+        hint: "It is a peer dependency of `@axiomify/native`. Install via `npm install --save-optional uWebSockets.js` (the package handles platform selection)."
+      });
+    } else {
+      add2(findings, {
+        severity: "fail",
+        area: "uws",
+        message: "uWebSockets.js native binding failed to load",
+        hint: msg.length > 200 ? msg.slice(0, 200) + "\u2026" : msg
+      });
+    }
+  }
+}
+async function checkPortAvailability(findings) {
+  const port = parseInt(process.env.PORT ?? "3000", 10);
+  const state = await probePort(port);
+  if (state === "free") {
+    add2(findings, {
+      severity: "ok",
+      area: "port",
+      message: `Port ${port} is available on 127.0.0.1`
+    });
+  } else if (state === "busy") {
+    add2(findings, {
+      severity: "warn",
+      area: "port",
+      message: `Port ${port} is already in use`,
+      hint: "Stop the conflicting process or set `PORT` to a different value."
+    });
+  } else {
+    add2(findings, {
+      severity: "warn",
+      area: "port",
+      message: `Port ${port}: bind denied (permission)`,
+      hint: "Ports below 1024 typically require root. Use a port \u2265 1024 in development."
+    });
+  }
+}
+function checkBuildArtifacts(findings) {
+  const dist = path7.join(process.cwd(), "dist");
+  if (fs.existsSync(dist)) {
+    add2(findings, {
+      severity: "ok",
+      area: "build",
+      message: "dist/ exists (recent `axiomify build`)"
+    });
+  } else {
+    add2(findings, {
+      severity: "warn",
+      area: "build",
+      message: "No dist/ directory \u2014 production build has not been run",
+      hint: "Run `axiomify build` before deploying."
+    });
+  }
+}
+async function runDoctor() {
+  const findings = [];
+  checkNodeVersion(findings);
+  checkPlatform(findings);
+  checkDependencyDrift(findings);
+  checkUwsLoads(findings);
+  checkBuildArtifacts(findings);
+  await checkPortAvailability(findings);
+  console.log();
+  console.log(pc.bold("  \u{1FA7A} Axiomify doctor"));
+  console.log();
+  const sevOrder = { fail: 0, warn: 1, ok: 2 };
+  findings.sort(
+    (a, b) => sevOrder[a.severity] - sevOrder[b.severity] || a.area.localeCompare(b.area)
+  );
+  const sym = {
+    ok: symbols.ok,
+    warn: symbols.warn,
+    fail: symbols.fail
+  };
+  for (const f of findings) {
+    const tag = pc.dim(`[${f.area}]`);
+    console.log(`  ${sym[f.severity]} ${tag} ${f.message}`);
+    if (f.hint && f.severity !== "ok") {
+      const wrapped = f.hint.replace(/(.{1,80})(\s+|$)/g, "\n      " + pc.dim("$1"));
+      console.log(wrapped);
+    }
+  }
+  const fails = findings.filter((f) => f.severity === "fail").length;
+  const warns = findings.filter((f) => f.severity === "warn").length;
+  const oks = findings.filter((f) => f.severity === "ok").length;
+  console.log();
+  console.log(
+    `  ${symbols.ok} ${pluralise(oks, "pass", "passes")}` + pc.dim("  \xB7  ") + (warns > 0 ? `${symbols.warn} ${pluralise(warns, "warning")}` : pc.dim("0 warnings")) + pc.dim("  \xB7  ") + (fails > 0 ? `${symbols.fail} ${pluralise(fails, "failure")}` : pc.dim("0 failures"))
+  );
+  console.log();
+  if (fails > 0) process.exit(1);
+}
 var DEV_COMMAND_BY_PM = {
   npm: "npm run dev",
   pnpm: "pnpm dev",
@@ -3038,20 +3948,6 @@ async function initProject(targetDir, options = {}) {
     });
   }
   questions.push(
-    {
-      type: "select",
-      name: "adapter",
-      message: "Which HTTP adapter do you want to use?",
-      choices: [
-        "Native (uWS \u2014 Fastest, 50k+ req/s)",
-        "Fastify (High-throughput, recommended)",
-        "Express (Max ecosystem compatibility)",
-        "Hapi (Enterprise, plugin-first)",
-        "Node HTTP (Zero dependency)"
-      ],
-      initial: 0
-      // Native is the recommended default
-    },
     {
       type: "input",
       name: "description",
@@ -3105,12 +4001,12 @@ async function initProject(targetDir, options = {}) {
     );
     process.exit(1);
   }
-  const dir = path4.resolve(process.cwd(), projectName);
+  const dir = path7.resolve(process.cwd(), projectName);
   if (existsSync(dir) && !options.force && targetDir) {
     const targets = [
-      path4.join(dir, "package.json"),
-      path4.join(dir, "tsconfig.json"),
-      path4.join(dir, "src", "index.ts")
+      path7.join(dir, "package.json"),
+      path7.join(dir, "tsconfig.json"),
+      path7.join(dir, "src", "index.ts")
     ];
     const collisions = targets.filter((p) => existsSync(p));
     if (collisions.length > 0) {
@@ -3122,28 +4018,11 @@ async function initProject(targetDir, options = {}) {
       process.exit(1);
     }
   }
-  await fs2.mkdir(path4.join(dir, "src"), { recursive: true });
+  await fs5.mkdir(path7.join(dir, "src"), { recursive: true });
   const AXIOMIFY_VERSION = `^${package_default.version}`;
-  let adapterPackage = "@axiomify/native";
-  let adapterImport = "import { NativeAdapter } from '@axiomify/native';";
-  let adapterInit = "const server = new NativeAdapter(app, { port: 3000 });\n  server.listen(() => console.log('  Axiomify Native on :3000'));";
-  if (answers.adapter.includes("Fastify")) {
-    adapterPackage = "@axiomify/fastify";
-    adapterImport = "import { FastifyAdapter } from '@axiomify/fastify';";
-    adapterInit = "const server = new FastifyAdapter(app);\n  await server.listen(3000);\n  console.log('  Axiomify Fastify on :3000');";
-  } else if (answers.adapter.includes("Express")) {
-    adapterPackage = "@axiomify/express";
-    adapterImport = "import { ExpressAdapter } from '@axiomify/express';";
-    adapterInit = "const server = new ExpressAdapter(app);\n  server.listen(3000, () => console.log('  Axiomify Express on :3000'));";
-  } else if (answers.adapter.includes("Hapi")) {
-    adapterPackage = "@axiomify/hapi";
-    adapterImport = "import { HapiAdapter } from '@axiomify/hapi';";
-    adapterInit = "const server = new HapiAdapter(app);\n  await server.listen(3000);\n  console.log('  Axiomify Hapi on :3000');";
-  } else if (answers.adapter.includes("HTTP")) {
-    adapterPackage = "@axiomify/http";
-    adapterImport = "import { HttpAdapter } from '@axiomify/http';";
-    adapterInit = "const server = new HttpAdapter(app);\n  server.listen(3000, () => console.log('  Axiomify HTTP on :3000'));";
-  }
+  const adapterPackage = "@axiomify/native";
+  const adapterImport = "import { NativeAdapter } from '@axiomify/native';";
+  const adapterInit = "const server = new NativeAdapter(app, { port: 3000 });\n  server.listen(() => console.log('  Axiomify Native on :3000'));";
   const pkgJson = {
     name: projectName,
     version: "1.0.0",
@@ -3211,14 +4090,14 @@ async function initProject(targetDir, options = {}) {
       "printWidth": 100,
       "tabWidth": 2
     }`;
-    await fs2.writeFile(path4.join(dir, ".eslintrc.cjs"), eslintConfig);
-    await fs2.writeFile(path4.join(dir, ".prettierrc"), prettierConfig);
-    await fs2.writeFile(
-      path4.join(dir, ".prettierignore"),
+    await fs5.writeFile(path7.join(dir, ".eslintrc.cjs"), eslintConfig);
+    await fs5.writeFile(path7.join(dir, ".prettierrc"), prettierConfig);
+    await fs5.writeFile(
+      path7.join(dir, ".prettierignore"),
       "dist\nnode_modules\ncoverage\n"
     );
-    await fs2.writeFile(
-      path4.join(dir, ".editorconfig"),
+    await fs5.writeFile(
+      path7.join(dir, ".editorconfig"),
       "root = true\n\n[*]\ncharset = utf-8\nend_of_line = lf\nindent_style = space\nindent_size = 2\ninsert_final_newline = true\ntrim_trailing_whitespace = true\n"
     );
   }
@@ -3279,19 +4158,19 @@ async function initProject(targetDir, options = {}) {
     "coverage",
     "*.log"
   ].join("\n") + "\n";
-  await fs2.writeFile(
-    path4.join(dir, "package.json"),
+  await fs5.writeFile(
+    path7.join(dir, "package.json"),
     JSON.stringify(pkgJson, null, 2)
   );
-  await fs2.writeFile(
-    path4.join(dir, "tsconfig.json"),
+  await fs5.writeFile(
+    path7.join(dir, "tsconfig.json"),
     JSON.stringify(tsConfig, null, 2)
   );
-  await fs2.writeFile(path4.join(dir, "src", "index.ts"), indexTs);
-  await fs2.writeFile(path4.join(dir, ".gitignore"), gitignore);
+  await fs5.writeFile(path7.join(dir, "src", "index.ts"), indexTs);
+  await fs5.writeFile(path7.join(dir, ".gitignore"), gitignore);
   console.log(pc.green(`
 \u2705 Axiomify project initialized in ${pc.bold(dir)}`));
-  if (answers.useGit && !existsSync(path4.join(dir, ".git"))) {
+  if (answers.useGit && !existsSync(path7.join(dir, ".git"))) {
     try {
       await execa("git", ["init"], { cwd: dir });
       console.log(pc.green("\u2705 Git repository initialized"));
@@ -3325,63 +4204,644 @@ async function initProject(targetDir, options = {}) {
 \u{1F525} Run "${devCommand}" to start your development server!`)
   );
 }
-async function inspectRoutes(entry) {
-  const entryPath = path4.resolve(process.cwd(), entry);
-  const tempPath = path4.resolve(process.cwd(), ".axiomify/inspect.cjs");
-  const userExternals = getUserExternals(process.cwd());
-  try {
-    await esbuild.build({
-      entryPoints: [entryPath],
-      bundle: true,
-      platform: "node",
-      format: "cjs",
-      outfile: tempPath,
-      external: [.../* @__PURE__ */ new Set([...userExternals, "node:*"])]
-    });
+var RULES = [
+  {
+    id: "meta-to-schema",
+    description: "`meta:` route field removed \u2014 metadata now lives inside `schema:` alongside Zod fields",
+    // NOTE: This rule renames `meta:` → a comment directing the dev to merge
+    // contents into schema:. A full structural AST merge is out of scope for
+    // the regex codemod; flag it for manual review instead (see report).
+    match: /^(\s*)meta:(\s*\{)/gm,
+    replace: "$1/* TODO(axiomify-migrate): merge meta fields into schema: */ openapi_REMOVE:$2"
+  },
+  {
+    id: "openapi-field-to-schema",
+    description: "`openapi:` top-level route field \u2192 contents merged into `schema:` (removed in 6.1)",
+    // Same conservative approach: flag for manual review via TODO comment.
+    match: /^(\s*)openapi:(\s*\{)/gm,
+    replace: "$1/* TODO(axiomify-migrate): merge openapi fields into schema: */ openapi_REMOVE:$2"
+  },
+  {
+    id: "useSwagger-import",
+    description: "`useSwagger` import \u2192 `useOpenAPI` (the function was never named `useSwagger` in shipped code \u2014 docs were wrong)",
+    match: /\buseSwagger\b/g,
+    replace: "useOpenAPI"
+  },
+  {
+    id: "routePrefix-option",
+    description: "`routePrefix:` \u2192 `prefix:` on `useOpenAPI()` options",
+    match: /(\buseOpenAPI\s*\([\s\S]*?)\brouteprefix(\s*:)/gi,
+    // Naive: just rename the property when it appears inside a useOpenAPI() call.
+    // The capture-group lookbehind avoids touching unrelated `routePrefix`
+    // properties in other contexts.
+    replace: (_match, before, suffix) => `${before}prefix${suffix}`
+  },
+  {
+    id: "RouteMeta-type",
+    description: "`RouteMeta` type \u2192 `OpenApiOperation` (alias removed in 6.0)",
+    // Match `RouteMeta` only as a type position (after `:` or `<` or
+    // `as`) — avoids hitting an unrelated variable named `RouteMeta`.
+    match: /(:\s*|<\s*|\bas\s+)RouteMeta\b/g,
+    replace: "$1OpenApiOperation"
+  },
+  {
+    id: "AppPlugin-type",
+    description: "`AppPlugin` type alias \u2192 `AppConfigurator` (removed in 5.0; runtime accepts 1-arg fns identically)",
+    match: /(:\s*|<\s*|\bas\s+)AppPlugin\b/g,
+    replace: "$1AppConfigurator"
+  }
+];
+async function listSourceFiles(rootAbs) {
+  const out = [];
+  const skip = /* @__PURE__ */ new Set(["node_modules", ".git", "dist", "build", ".axiomify", "coverage"]);
+  const walk = async (dir) => {
+    let entries;
     try {
-      delete __require.cache[__require.resolve(tempPath)];
-    } catch (e) {
+      entries = await fs5.readdir(dir, { withFileTypes: true });
+    } catch {
+      return;
     }
-    const inspectionTimeout = setTimeout(() => {
-      console.warn(
-        "\n\u26A0\uFE0F  Route inspection is taking longer than expected.\n   Your entry file may be starting a server unconditionally.\n   Wrap the listen() call in `if (require.main === module) { ... }`\n   so it only runs when the file is executed directly.\n"
-      );
-    }, 5e3);
-    inspectionTimeout.unref();
-    const mod = __require(tempPath);
-    const app = mod.app || mod.default;
-    if (!app || typeof app.registeredRoutes === "undefined") {
-      console.error("\u274C Error: Could not find an exported Axiomify instance.");
+    for (const e of entries) {
+      if (e.isDirectory()) {
+        if (skip.has(e.name) || e.name.startsWith(".")) continue;
+        await walk(path7.join(dir, e.name));
+      } else if (e.isFile()) {
+        const ext = path7.extname(e.name);
+        if ([".ts", ".tsx", ".js", ".mjs", ".cjs"].includes(ext)) {
+          out.push(path7.join(dir, e.name));
+        }
+      }
+    }
+  };
+  await walk(rootAbs);
+  return out;
+}
+function applyRules(src) {
+  let updated = src;
+  const counts = {};
+  for (const rule of RULES) {
+    const before = updated;
+    if (typeof rule.replace === "string") {
+      updated = updated.replace(rule.match, rule.replace);
+    } else {
+      updated = updated.replace(rule.match, rule.replace);
+    }
+    if (updated !== before) {
+      const matches = before.match(rule.match);
+      counts[rule.id] = matches ? matches.length : 1;
+    }
+  }
+  return { updated, counts };
+}
+function renderUnifiedDiff(file, original, updated) {
+  if (original === updated) return "";
+  const origLines = original.split("\n");
+  const updatedLines = updated.split("\n");
+  const out = [];
+  out.push(pc.bold(`--- ${file}`));
+  out.push(pc.bold(`+++ ${file}`));
+  const max = Math.max(origLines.length, updatedLines.length);
+  for (let i = 0; i < max; i++) {
+    const a = origLines[i];
+    const b = updatedLines[i];
+    if (a === b) continue;
+    if (a !== void 0) out.push(pc.red("- " + a));
+    if (b !== void 0) out.push(pc.green("+ " + b));
+  }
+  return out.join("\n");
+}
+async function runMigrate(opts = {}) {
+  const dir = opts.dir ?? "src";
+  const rootAbs = path7.resolve(process.cwd(), dir);
+  try {
+    const stat = await fs5.stat(rootAbs);
+    if (!stat.isDirectory()) throw new Error("not a directory");
+  } catch {
+    console.error(
+      pc.red(`\u2717 ${dir} does not exist or is not a directory.`),
+      `
+  Run from a project root that contains the directory you want to migrate.`
+    );
+    process.exit(1);
+  }
+  const files = await listSourceFiles(rootAbs);
+  if (files.length === 0) {
+    console.log(`${symbols.info} No source files found under ${pc.cyan(dir)}.`);
+    return;
+  }
+  const results = [];
+  for (const f of files) {
+    const original = await fs5.readFile(f, "utf8");
+    const { updated, counts } = applyRules(original);
+    if (Object.keys(counts).length > 0) {
+      results.push({ file: f, counts, original, updated });
+    }
+  }
+  console.log();
+  console.log(pc.bold("  \u{1F504} Axiomify v4 \u2192 v5 migration"));
+  console.log(
+    pc.dim(
+      `  Scanned ${pluralise(files.length, "file")} under ${path7.relative(process.cwd(), rootAbs) || "."}/.
+`
+    )
+  );
+  if (results.length === 0) {
+    console.log(`  ${symbols.ok} Nothing to migrate \u2014 all patterns look up to date.`);
+    console.log();
+    return;
+  }
+  const totalsByRule = {};
+  for (const r of results) {
+    for (const [rule, n] of Object.entries(r.counts)) {
+      totalsByRule[rule] = (totalsByRule[rule] ?? 0) + n;
+    }
+  }
+  for (const rule of RULES) {
+    const count = totalsByRule[rule.id];
+    if (!count) continue;
+    console.log(
+      `  ${pc.cyan(rule.id)} ${pc.dim("\u2014")} ${rule.description}`
+    );
+    console.log(
+      `    ${symbols.bullet} ${pluralise(count, "change")} across ${pluralise(
+        results.filter((r) => r.counts[rule.id]).length,
+        "file"
+      )}`
+    );
+  }
+  console.log();
+  if (opts.reportOnly) {
+    console.log(pc.dim("  --report-only: no files were modified."));
+    console.log();
+    return;
+  }
+  if (opts.dryRun) {
+    for (const r of results) {
+      const rel = path7.relative(process.cwd(), r.file);
+      console.log(renderUnifiedDiff(rel, r.original, r.updated));
+      console.log();
+    }
+    console.log(
+      `${symbols.info} ${pluralise(results.length, "file")} would be modified. Re-run without ${pc.cyan("--dry-run")} to apply.`
+    );
+    console.log();
+    return;
+  }
+  for (const r of results) {
+    await fs5.writeFile(r.file, r.updated, "utf8");
+    console.log(`  ${symbols.ok} ${pc.green("Updated")} ${path7.relative(process.cwd(), r.file)}`);
+  }
+  console.log();
+  console.log(
+    `  ${symbols.ok} ${pluralise(results.length, "file")} migrated, ${pluralise(
+      Object.values(totalsByRule).reduce((a, b) => a + b, 0),
+      "total change"
+    )} applied.`
+  );
+  console.log();
+  console.log(pc.dim("  Manual review needed for:"));
+  console.log(
+    pc.dim(
+      `    ${symbols.bullet} Dangling \`AppPlugin\` / \`RouteMeta\` in import statements \u2014 the codemod renames`
+    )
+  );
+  console.log(
+    pc.dim(
+      `        type USAGES but not the import bindings themselves. TypeScript flags the unused`
+    )
+  );
+  console.log(
+    pc.dim(
+      `        import; remove it (or run \`tsc --noUnusedLocals\` once and let your editor clean up).`
+    )
+  );
+  console.log(
+    pc.dim(
+      `    ${symbols.bullet} 5-arg positional \`SerializerFn\` signatures \u2014 the function body needs by-hand updates`
+    )
+  );
+  console.log(
+    pc.dim(
+      `    ${symbols.bullet} \`new Axiomify()\` callers that relied on automatic \`X-Request-Id\` injection`
+    )
+  );
+  console.log(
+    pc.dim(
+      `    ${symbols.bullet} JWT secrets \u2014 verify they are \u2265 32 BYTES (not chars) per RFC 7518 \xA73.2`
+    )
+  );
+  console.log();
+  console.log(
+    `  See ${pc.cyan("docs/migration-v4-to-v5.md")} for the full guide and ` + pc.cyan("axiomify check") + " to verify the migrated app.\n" + pc.yellow("  Note: `openapi:` / `meta:` merges into `schema:` require manual review \u2014 check TODO comments.")
+  );
+  console.log();
+}
+async function jsonToYaml(obj) {
+  const emit = (v, indent) => {
+    const pad2 = "  ".repeat(indent);
+    if (v === null) return "null";
+    if (typeof v === "boolean" || typeof v === "number") return String(v);
+    if (typeof v === "string") {
+      if (/[:#\n\r\t"'{}[\]&*!|>%@`]|^\s|\s$/.test(v) || v === "") {
+        return JSON.stringify(v);
+      }
+      return v;
+    }
+    if (Array.isArray(v)) {
+      if (v.length === 0) return "[]";
+      return v.map((item) => `
+${pad2}- ${emit(item, indent + 1).replace(/^/gm, "  ").trimStart()}`).join("");
+    }
+    if (typeof v === "object") {
+      const keys = Object.keys(v);
+      if (keys.length === 0) return "{}";
+      return keys.map((k) => {
+        const val = v[k];
+        const rendered = emit(val, indent + 1);
+        if (rendered.startsWith("\n")) return `
+${pad2}${k}:${rendered}`;
+        return `
+${pad2}${k}: ${rendered}`;
+      }).join("");
+    }
+    return JSON.stringify(v);
+  };
+  return emit(obj, 0).trimStart();
+}
+async function emitOpenApi(entry, opts = {}) {
+  let app;
+  let cleanup = async () => {
+  };
+  try {
+    const loaded = await loadApp(entry);
+    app = loaded.app;
+    cleanup = loaded.cleanup;
+  } catch (err) {
+    console.error(pc.red("\u2717 Failed to load app:"));
+    console.error(err.message);
+    process.exit(1);
+  }
+  try {
+    let OpenApiGenerator;
+    try {
+      ({ OpenApiGenerator } = await import('./dist-SYWHGZLI.mjs'));
+    } catch {
       console.error(
-        "Ensure your entry file exports the app: `export const app = new Axiomify();`"
+        pc.red("\u2717 @axiomify/openapi is not installed."),
+        "\n  Install it:",
+        pc.cyan("npm install @axiomify/openapi")
       );
       process.exit(1);
     }
-    console.log("\n\u{1F9ED} Registered Axiomify Routes:");
-    console.log("----------------------------------------------------");
-    console.log(`${"METHOD".padEnd(10)} | ${"PATH".padEnd(30)} | VALIDATION`);
-    console.log("----------------------------------------------------");
-    app.registeredRoutes.forEach((route) => {
-      const schemas = [];
-      if (route.schema?.body) schemas.push("Body");
-      if (route.schema?.query) schemas.push("Query");
-      if (route.schema?.params) schemas.push("Params");
-      if (route.schema?.response) schemas.push("Response");
-      if (route.schema?.files) schemas.push("Files");
-      const validationStr = schemas.length > 0 ? schemas.join(", ") : "None";
+    const info = {
+      title: opts.title ?? "API",
+      version: opts.version ?? "1.0.0"
+    };
+    const generator = new OpenApiGenerator(app, { info });
+    const spec = generator.generate();
+    if (opts.title) spec.info.title = opts.title;
+    if (opts.version) spec.info.version = opts.version;
+    const format = opts.format ?? "json";
+    const serialised = format === "yaml" ? await jsonToYaml(spec) : opts.minify ? JSON.stringify(spec) : JSON.stringify(spec, null, 2);
+    if (opts.output) {
+      const outPath = path7.resolve(process.cwd(), opts.output);
+      await fs5.mkdir(path7.dirname(outPath), { recursive: true });
+      await fs5.writeFile(outPath, serialised + "\n", "utf8");
+      const routeCount = (app.registeredRoutes ?? []).length;
       console.log(
-        `${route.method.padEnd(10)} | ${route.path.padEnd(
-          30
-        )} | ${validationStr}`
+        `${pc.green("\u2713")} OpenAPI spec written to ${pc.cyan(opts.output)} ` + pc.dim(`(${routeCount} route${routeCount === 1 ? "" : "s"}, ${format})`)
       );
-    });
-    console.log("----------------------------------------------------\n");
+    } else {
+      process.stdout.write(serialised + "\n");
+    }
   } catch (error) {
-    console.error("\u274C Failed to inspect routes:", error);
+    console.error(pc.red("\u2717 Failed to generate spec:"), error);
+    process.exit(1);
   } finally {
-    await fs2.rm(path4.dirname(tempPath), { recursive: true, force: true }).catch(() => {
+    await cleanup();
+  }
+}
+function normalise(raw, isWs) {
+  const validation = [];
+  if (raw.schema?.body) validation.push("Body");
+  if (raw.schema?.query) validation.push("Query");
+  if (raw.schema?.params) validation.push("Params");
+  if (raw.schema?.response) validation.push("Response");
+  if (raw.schema?.files) validation.push("Files");
+  if (raw.schema?.message) validation.push("Message");
+  const s = raw.schema ?? {};
+  return {
+    method: isWs ? "WS" : raw.method,
+    path: raw.path,
+    validation,
+    tags: Array.isArray(s.tags) ? s.tags : [],
+    operationId: typeof s.operationId === "string" ? s.operationId : void 0,
+    deprecated: s.deprecated === true,
+    timeout: typeof raw.timeout === "number" && raw.timeout > 0 ? raw.timeout : void 0,
+    plugins: Array.isArray(raw.plugins) ? raw.plugins.length : 0,
+    isWs
+  };
+}
+function matchesFilter(route, opts) {
+  if (opts.method) {
+    const wanted = opts.method.split(",").map((m) => m.trim().toUpperCase()).filter(Boolean);
+    if (wanted.length && !wanted.includes(route.method)) return false;
+  }
+  if (opts.filter) {
+    const pat = opts.filter;
+    if (pat.includes("*")) {
+      const re = new RegExp(
+        "^" + pat.split("*").map((s) => s.replace(/[.+?^${}()|[\]\\]/g, "\\$&")).join(".*") + "$"
+      );
+      if (!re.test(route.path)) return false;
+    } else if (!route.path.includes(pat)) {
+      return false;
+    }
+  }
+  return true;
+}
+function sortRoutes(routes, by) {
+  const methodOrder = {
+    GET: 0,
+    POST: 1,
+    PUT: 2,
+    PATCH: 3,
+    DELETE: 4,
+    HEAD: 5,
+    OPTIONS: 6,
+    WS: 7
+  };
+  return [...routes].sort((a, b) => {
+    if (by === "method") {
+      const am = methodOrder[a.method] ?? 99;
+      const bm = methodOrder[b.method] ?? 99;
+      if (am !== bm) return am - bm;
+      return a.path.localeCompare(b.path);
+    }
+    if (a.path !== b.path) return a.path.localeCompare(b.path);
+    return (methodOrder[a.method] ?? 99) - (methodOrder[b.method] ?? 99);
+  });
+}
+async function inspectRoutes(entry, opts = {}) {
+  let app;
+  let cleanup = async () => {
+  };
+  try {
+    const loaded = await loadApp(entry);
+    app = loaded.app;
+    cleanup = loaded.cleanup;
+  } catch (err) {
+    console.error(pc.red("\u2717 Failed to load app:"));
+    console.error(err.message);
+    process.exit(1);
+  }
+  try {
+    const httpRoutes = (app.registeredRoutes ?? []).map(
+      (r) => normalise(r, false)
+    );
+    const wsRoutes = (app.registeredWsRoutes ?? []).map(
+      (r) => normalise(r, true)
+    );
+    const all = sortRoutes([...httpRoutes, ...wsRoutes], opts.sort ?? "path");
+    const filtered = all.filter((r) => matchesFilter(r, opts));
+    if (opts.json) {
+      process.stdout.write(JSON.stringify(filtered, null, 2) + "\n");
+      return;
+    }
+    if (filtered.length === 0) {
+      console.log(
+        "\n" + symbols.info + pc.dim(
+          `  No routes match the current filter (${all.length} total registered).
+`
+        )
+      );
+      return;
+    }
+    console.log();
+    console.log(pc.bold("  \u{1F9ED} Axiomify routes"));
+    console.log();
+    const columns = [
+      { header: "METHOD", minWidth: 7 },
+      { header: "PATH", minWidth: 20, maxWidth: 60 },
+      { header: "VALIDATION", minWidth: 10, maxWidth: 32 },
+      { header: "META", maxWidth: 40 }
+    ];
+    const rows = filtered.map((r) => {
+      const method = colourMethod(r.method);
+      const path11 = r.deprecated ? pc.strikethrough(r.path) + " " + badge.deprecated() : r.path;
+      const validation = r.validation.length > 0 ? r.validation.map(badge.validation).join(pc.dim(",")) : pc.dim("\u2014");
+      const metaBits = [];
+      if (r.operationId) metaBits.push(pc.dim(`op:`) + r.operationId);
+      if (r.tags.length) metaBits.push(badge.tags(r.tags));
+      if (r.timeout !== void 0) metaBits.push(badge.timeout(r.timeout));
+      if (r.plugins > 0) metaBits.push(pc.dim(`+${r.plugins} plugin${r.plugins === 1 ? "" : "s"}`));
+      const meta = metaBits.length ? metaBits.join(" ") : pc.dim("\u2014");
+      return [method, path11, validation, meta];
     });
+    console.log(renderTable(columns, rows));
+    const byMethod = filtered.reduce((acc, r) => {
+      acc[r.method] = (acc[r.method] ?? 0) + 1;
+      return acc;
+    }, {});
+    const summaryParts = Object.entries(byMethod).sort(([a], [b]) => a.localeCompare(b)).map(([m, n]) => `${colourMethod(m).trimEnd()} ${pc.bold(String(n))}`);
+    console.log();
+    console.log(
+      `  ${symbols.ok} ${pluralise(filtered.length, "route")}` + (filtered.length < all.length ? pc.dim(` (filtered from ${all.length})`) : "") + "   " + summaryParts.join(pc.dim(" \xB7 "))
+    );
+    const filteredWs = filtered.filter((r) => r.isWs).length;
+    if (filteredWs > 0) {
+      console.log(
+        pc.dim(`    \u2514 ${pluralise(filteredWs, "WebSocket route")} included`)
+      );
+    }
+    console.log();
+  } catch (error) {
+    console.error(pc.red("\u2717 Failed to inspect routes:"), error);
+    process.exit(1);
+  } finally {
+    await cleanup();
+  }
+}
+var VALID_METHODS = /* @__PURE__ */ new Set([
+  "GET",
+  "POST",
+  "PUT",
+  "PATCH",
+  "DELETE",
+  "OPTIONS",
+  "HEAD",
+  "WS"
+]);
+function pathToFilename(routePath) {
+  const cleaned = routePath.split("/").filter(Boolean).map((seg) => seg.startsWith(":") ? `by-${seg.slice(1)}` : seg).join("-");
+  return cleaned || "root";
+}
+function generateRouteSource(method, routePath, opts) {
+  const isWs = method === "WS";
+  const params = routePath.match(/:[a-zA-Z_][a-zA-Z0-9_]*/g) ?? [];
+  const paramKeys = params.map((p) => p.slice(1));
+  const plugins = [];
+  const extraImports = [];
+  if (opts.auth) {
+    plugins.push("requireAuth");
+    extraImports.push(
+      `import { createAuthPlugin } from '@axiomify/auth';
+
+const requireAuth = createAuthPlugin({
+  secret: process.env.JWT_SECRET!,
+});`
+    );
+  }
+  if (opts.rateLimit) {
+    plugins.push("limiter");
+    extraImports.push(
+      `import { createRateLimitPlugin, MemoryStore } from '@axiomify/rate-limit';
+
+// Replace MemoryStore with RedisStore for multi-process / multi-host.
+const limiter = createRateLimitPlugin({
+  windowMs: 60_000,
+  max: 100,
+  store: new MemoryStore(),
+});`
+    );
+  }
+  if (isWs) {
+    return [
+      `import type { Axiomify } from '@axiomify/core';`,
+      `import { z } from 'zod';`,
+      extraImports.length ? extraImports.join("\n\n") + "\n" : "",
+      `/**`,
+      ` * Registers WebSocket route ${routePath}.`,
+      ` * Wire this into your entry file:`,
+      ` *   import { registerRoute } from './routes/${pathToFilename(routePath)}';`,
+      ` *   registerRoute(app);`,
+      ` */`,
+      `export function registerRoute(app: Axiomify): void {`,
+      `  app.ws({`,
+      `    path: '${routePath}',`,
+      paramKeys.length > 0 ? `    schema: {
+      params: z.object({ ${paramKeys.map((k) => `${k}: z.string()`).join(", ")} }),
+      // Define your message shape here \u2014 runtime-validated on every incoming frame.
+      message: z.object({
+        text: z.string(),
+      }),
+    },` : `    schema: {
+      // Define your message shape here \u2014 runtime-validated on every incoming frame.
+      message: z.object({
+        text: z.string(),
+      }),
+    },`,
+      plugins.length > 0 ? `    plugins: [${plugins.join(", ")}],` : "",
+      `    open: (client, _req) => {`,
+      `      client.send({ type: 'welcome' });`,
+      `    },`,
+      `    message: (client, data) => {`,
+      `      // \`data\` is typed and validated from the schema above.`,
+      `      client.send({ echo: data.text });`,
+      `    },`,
+      `    close: (_client, code, reason) => {`,
+      `      console.log('connection closed', code, reason);`,
+      `    },`,
+      `  });`,
+      `}`,
+      ``
+    ].filter(Boolean).join("\n");
   }
+  return [
+    `import type { Axiomify } from '@axiomify/core';`,
+    `import { z } from 'zod';`,
+    extraImports.length ? extraImports.join("\n\n") + "\n" : "",
+    `/**`,
+    ` * Registers ${method} ${routePath}.`,
+    ` * Wire this into your entry file:`,
+    ` *   import { registerRoute } from './routes/${pathToFilename(routePath)}';`,
+    ` *   registerRoute(app);`,
+    ` */`,
+    `export function registerRoute(app: Axiomify): void {`,
+    `  app.route({`,
+    `    method: '${method}',`,
+    `    path: '${routePath}',`,
+    `    schema: {`,
+    paramKeys.length > 0 ? `      params: z.object({ ${paramKeys.map((k) => `${k}: z.string()`).join(", ")} }),` : "",
+    method === "POST" || method === "PUT" || method === "PATCH" ? `      body: z.object({
+        // TODO \u2014 define request body shape
+      }),` : "",
+    `      // response: z.object({ /* response shape */ }),`,
+    `    },`,
+    `      // OpenAPI metadata (tags, summary, operationId etc.) lives in schema: too`,
+    `      tags: ['${pathToFilename(routePath).split("-")[0] || "general"}'],`,
+    `      summary: '${method} ${routePath}',`,
+    plugins.length > 0 ? `    plugins: [${plugins.join(", ")}],` : "",
+    `    handler: async (${paramKeys.length > 0 || method !== "GET" ? "req" : "_req"}, res) => {`,
+    method === "POST" ? `      // TODO \u2014 handler logic
+      res.status(201).send({ ok: true });` : method === "DELETE" ? `      // TODO \u2014 handler logic
+      res.status(204).send(null);` : `      // TODO \u2014 handler logic
+      res.send({ ok: true });`,
+    `    },`,
+    `  });`,
+    `}`,
+    ``
+  ].filter(Boolean).join("\n");
+}
+async function scaffoldRoute(method, routePath, opts = {}) {
+  const upperMethod = method.toUpperCase();
+  if (!VALID_METHODS.has(upperMethod)) {
+    console.error(
+      pc.red(`\u2717 Invalid method "${method}".`),
+      `Expected one of: ${[...VALID_METHODS].join(", ")}.`
+    );
+    process.exit(1);
+  }
+  if (!routePath.startsWith("/")) {
+    console.error(
+      pc.red('\u2717 Path must start with "/".'),
+      `Got: ${routePath}`
+    );
+    process.exit(1);
+  }
+  const dir = opts.dir ?? "src/routes";
+  const filename = pathToFilename(routePath) + ".ts";
+  const fileAbs = path7.resolve(process.cwd(), dir, filename);
+  const source = generateRouteSource(upperMethod, routePath, opts);
+  if (opts.dryRun) {
+    console.log(pc.dim(`# would write ${path7.relative(process.cwd(), fileAbs)}
+`));
+    console.log(source);
+    return;
+  }
+  let exists = false;
+  try {
+    await fs5.access(fileAbs);
+    exists = true;
+  } catch {
+  }
+  if (exists && !opts.force) {
+    console.log(
+      `${symbols.warn} ${pc.yellow("Already exists:")} ${path7.relative(process.cwd(), fileAbs)}
+   Pass ${pc.cyan("--force")} to overwrite, or pick a different path.`
+    );
+    return;
+  }
+  await fs5.mkdir(path7.dirname(fileAbs), { recursive: true });
+  await fs5.writeFile(fileAbs, source, "utf8");
+  console.log();
+  console.log(
+    `${symbols.ok} ${pc.green("Created")} ${pc.cyan(path7.relative(process.cwd(), fileAbs))}`
+  );
+  console.log();
+  console.log(pc.dim("  Next steps:"));
+  console.log(
+    `    1. Wire it into your entry file:
+` + pc.dim(`         import { registerRoute } from './routes/${pathToFilename(routePath)}';
+`) + pc.dim(`         registerRoute(app);`)
+  );
+  console.log(
+    `    2. Fill in the TODOs in ${pc.cyan(path7.relative(process.cwd(), fileAbs))}.`
+  );
+  console.log(
+    `    3. Verify with ${pc.cyan("npx axiomify routes")} and ${pc.cyan("npx axiomify check")}.`
+  );
+  console.log();
 }
 
 // src/index.ts
@@ -3392,5 +4852,37 @@ program2.command("init").description("Bootstrap a new Axiomify project").argumen
 );
 program2.command("dev").description("Start the development server with hot-reload").argument("[entry]", "Entry file", "src/index.ts").action(devServer);
 program2.command("build").description("Compile the application for production").argument("[entry]", "Entry file", "src/index.ts").action(buildProject);
-program2.command("routes").description("Inspect and list all registered routes in the application").argument("[entry]", "Entry file", "src/index.ts").action(inspectRoutes);
+program2.command("routes").description("Inspect and list all registered HTTP + WebSocket routes").argument("[entry]", "Entry file", "src/index.ts").option("--json", "Emit machine-readable JSON instead of the formatted table", false).option(
+  "-m, --method <list>",
+  "Comma-separated list of methods to include (e.g. GET,POST,WS)"
+).option(
+  "-f, --filter <pattern>",
+  'Path filter \u2014 substring match, or glob with "*" (e.g. /api/v1/*)'
+).option(
+  "-s, --sort <by>",
+  'Sort routes by "method" or "path"',
+  "path"
+).action(
+  (entry, options) => inspectRoutes(entry, options)
+);
+program2.command("openapi").description("Generate the OpenAPI spec from the app and emit it").argument("[entry]", "Entry file", "src/index.ts").option(
+  "-o, --output <file>",
+  "Write the spec to this file path instead of stdout"
+).option("--format <fmt>", 'Output format: "json" (default) or "yaml"', "json").option("--minify", "Minified JSON (single line). Ignored for yaml.", false).option("--title <title>", "Override info.title in the generated spec").option("--spec-version <version>", "Override info.version in the generated spec").action(
+  (entry, options) => emitOpenApi(entry, {
+    ...options,
+    // Map the CLI flag name (`spec-version` → camel `specVersion`) onto
+    // the internal `version` field that emitOpenApi() expects.
+    version: options.specVersion
+  })
+);
+program2.command("check").description("Run a static production-readiness audit against the app").argument("[entry]", "Entry file", "src/index.ts").action(runCheck);
+program2.command("doctor").description("Diagnose the host environment (Node, uWS, ports, dep drift)").action(runDoctor);
+var scaffold = program2.command("scaffold").description("Generate boilerplate (routes, modules, plugins)");
+scaffold.command("route <method> <path>").description("Create a new route file under src/routes/").option("--auth", "Include `requireAuth` plugin and import", false).option("--rate-limit", "Include a default rate-limit plugin", false).option("--dry-run", "Print the generated source without writing", false).option("--force", "Overwrite the file if it already exists", false).option("--dir <dir>", "Directory under cwd to create the file in", "src/routes").action(
+  (method, routePath, options) => scaffoldRoute(method, routePath, options)
+);
+program2.command("migrate").description("v5 \u2192 v6 codemod: merge meta: fields into schema:, fix routePrefix \u2192 prefix, etc").option("--dry-run", "Show the unified diff without writing", false).option("--report-only", "Print a migration report and exit; do not write", false).option("--dir <dir>", "Directory to scan recursively", "src").action(
+  (options) => runMigrate(options)
+);
 program2.parse(process.argv);