@easysociable/cli 0.1.1 → 0.1.3

package/dist/easysociable.js

@@ -4,2783 +4,32 @@ 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 __esm = (fn, res) => function __init() {
-  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
-};
-var __commonJS = (cb, mod) => function __require2() {
-  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
-};
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-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.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-
-// ../../node_modules/.pnpm/commander@11.1.0/node_modules/commander/lib/error.js
-var require_error = __commonJS({
-  "../../node_modules/.pnpm/commander@11.1.0/node_modules/commander/lib/error.js"(exports) {
-    "use strict";
-    var CommanderError2 = class extends Error {
-      /**
-       * Constructs the CommanderError class
-       * @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(exitCode2, code, message) {
-        super(message);
-        Error.captureStackTrace(this, this.constructor);
-        this.name = this.constructor.name;
-        this.code = code;
-        this.exitCode = exitCode2;
-        this.nestedError = void 0;
-      }
-    };
-    var InvalidArgumentError2 = class extends CommanderError2 {
-      /**
-       * Constructs the InvalidArgumentError class
-       * @param {string} [message] explanation of why argument is invalid
-       * @constructor
-       */
-      constructor(message) {
-        super(1, "commander.invalidArgument", message);
-        Error.captureStackTrace(this, this.constructor);
-        this.name = this.constructor.name;
-      }
-    };
-    exports.CommanderError = CommanderError2;
-    exports.InvalidArgumentError = InvalidArgumentError2;
-  }
-});
-
-// ../../node_modules/.pnpm/commander@11.1.0/node_modules/commander/lib/argument.js
-var require_argument = __commonJS({
-  "../../node_modules/.pnpm/commander@11.1.0/node_modules/commander/lib/argument.js"(exports) {
-    "use strict";
-    var { InvalidArgumentError: InvalidArgumentError2 } = require_error();
-    var Argument2 = class {
-      /**
-       * Initialize a new command argument with the given name and description.
-       * The default is that the argument is required, and you can explicitly
-       * indicate this with <> around the name. Put [] around the name for an optional argument.
-       *
-       * @param {string} name
-       * @param {string} [description]
-       */
-      constructor(name, description) {
-        this.description = description || "";
-        this.variadic = false;
-        this.parseArg = void 0;
-        this.defaultValue = void 0;
-        this.defaultValueDescription = void 0;
-        this.argChoices = void 0;
-        switch (name[0]) {
-          case "<":
-            this.required = true;
-            this._name = name.slice(1, -1);
-            break;
-          case "[":
-            this.required = false;
-            this._name = name.slice(1, -1);
-            break;
-          default:
-            this.required = true;
-            this._name = name;
-            break;
-        }
-        if (this._name.length > 3 && this._name.slice(-3) === "...") {
-          this.variadic = true;
-          this._name = this._name.slice(0, -3);
-        }
-      }
-      /**
-       * Return argument name.
-       *
-       * @return {string}
-       */
-      name() {
-        return this._name;
-      }
-      /**
-       * @api private
-       */
-      _concatValue(value, previous) {
-        if (previous === this.defaultValue || !Array.isArray(previous)) {
-          return [value];
-        }
-        return previous.concat(value);
-      }
-      /**
-       * Set the default value, and optionally supply the description to be displayed in the help.
-       *
-       * @param {*} value
-       * @param {string} [description]
-       * @return {Argument}
-       */
-      default(value, description) {
-        this.defaultValue = value;
-        this.defaultValueDescription = description;
-        return this;
-      }
-      /**
-       * Set the custom handler for processing CLI command arguments into argument values.
-       *
-       * @param {Function} [fn]
-       * @return {Argument}
-       */
-      argParser(fn) {
-        this.parseArg = fn;
-        return this;
-      }
-      /**
-       * Only allow argument value to be one of choices.
-       *
-       * @param {string[]} values
-       * @return {Argument}
-       */
-      choices(values) {
-        this.argChoices = values.slice();
-        this.parseArg = (arg, previous) => {
-          if (!this.argChoices.includes(arg)) {
-            throw new InvalidArgumentError2(`Allowed choices are ${this.argChoices.join(", ")}.`);
-          }
-          if (this.variadic) {
-            return this._concatValue(arg, previous);
-          }
-          return arg;
-        };
-        return this;
-      }
-      /**
-       * Make argument required.
-       */
-      argRequired() {
-        this.required = true;
-        return this;
-      }
-      /**
-       * Make argument optional.
-       */
-      argOptional() {
-        this.required = false;
-        return this;
-      }
-    };
-    function humanReadableArgName(arg) {
-      const nameOutput = arg.name() + (arg.variadic === true ? "..." : "");
-      return arg.required ? "<" + nameOutput + ">" : "[" + nameOutput + "]";
-    }
-    exports.Argument = Argument2;
-    exports.humanReadableArgName = humanReadableArgName;
-  }
-});
-
-// ../../node_modules/.pnpm/commander@11.1.0/node_modules/commander/lib/help.js
-var require_help = __commonJS({
-  "../../node_modules/.pnpm/commander@11.1.0/node_modules/commander/lib/help.js"(exports) {
-    "use strict";
-    var { humanReadableArgName } = require_argument();
-    var Help2 = class {
-      constructor() {
-        this.helpWidth = void 0;
-        this.sortSubcommands = false;
-        this.sortOptions = false;
-        this.showGlobalOptions = false;
-      }
-      /**
-       * Get an array of the visible subcommands. Includes a placeholder for the implicit help command, if there is one.
-       *
-       * @param {Command} cmd
-       * @returns {Command[]}
-       */
-      visibleCommands(cmd) {
-        const visibleCommands = cmd.commands.filter((cmd2) => !cmd2._hidden);
-        if (cmd._hasImplicitHelpCommand()) {
-          const [, helpName, helpArgs] = cmd._helpCommandnameAndArgs.match(/([^ ]+) *(.*)/);
-          const helpCommand = cmd.createCommand(helpName).helpOption(false);
-          helpCommand.description(cmd._helpCommandDescription);
-          if (helpArgs) helpCommand.arguments(helpArgs);
-          visibleCommands.push(helpCommand);
-        }
-        if (this.sortSubcommands) {
-          visibleCommands.sort((a, b) => {
-            return a.name().localeCompare(b.name());
-          });
-        }
-        return visibleCommands;
-      }
-      /**
-       * Compare options for sort.
-       *
-       * @param {Option} a
-       * @param {Option} b
-       * @returns number
-       */
-      compareOptions(a, b) {
-        const getSortKey = (option) => {
-          return option.short ? option.short.replace(/^-/, "") : option.long.replace(/^--/, "");
-        };
-        return getSortKey(a).localeCompare(getSortKey(b));
-      }
-      /**
-       * Get an array of the visible options. Includes a placeholder for the implicit help option, if there is one.
-       *
-       * @param {Command} cmd
-       * @returns {Option[]}
-       */
-      visibleOptions(cmd) {
-        const visibleOptions = cmd.options.filter((option) => !option.hidden);
-        const showShortHelpFlag = cmd._hasHelpOption && cmd._helpShortFlag && !cmd._findOption(cmd._helpShortFlag);
-        const showLongHelpFlag = cmd._hasHelpOption && !cmd._findOption(cmd._helpLongFlag);
-        if (showShortHelpFlag || showLongHelpFlag) {
-          let helpOption;
-          if (!showShortHelpFlag) {
-            helpOption = cmd.createOption(cmd._helpLongFlag, cmd._helpDescription);
-          } else if (!showLongHelpFlag) {
-            helpOption = cmd.createOption(cmd._helpShortFlag, cmd._helpDescription);
-          } else {
-            helpOption = cmd.createOption(cmd._helpFlags, cmd._helpDescription);
-          }
-          visibleOptions.push(helpOption);
-        }
-        if (this.sortOptions) {
-          visibleOptions.sort(this.compareOptions);
-        }
-        return visibleOptions;
-      }
-      /**
-       * Get an array of the visible global options. (Not including help.)
-       *
-       * @param {Command} cmd
-       * @returns {Option[]}
-       */
-      visibleGlobalOptions(cmd) {
-        if (!this.showGlobalOptions) return [];
-        const globalOptions = [];
-        for (let ancestorCmd = cmd.parent; ancestorCmd; ancestorCmd = ancestorCmd.parent) {
-          const visibleOptions = ancestorCmd.options.filter((option) => !option.hidden);
-          globalOptions.push(...visibleOptions);
-        }
-        if (this.sortOptions) {
-          globalOptions.sort(this.compareOptions);
-        }
-        return globalOptions;
-      }
-      /**
-       * Get an array of the arguments if any have a description.
-       *
-       * @param {Command} cmd
-       * @returns {Argument[]}
-       */
-      visibleArguments(cmd) {
-        if (cmd._argsDescription) {
-          cmd.registeredArguments.forEach((argument) => {
-            argument.description = argument.description || cmd._argsDescription[argument.name()] || "";
-          });
-        }
-        if (cmd.registeredArguments.find((argument) => argument.description)) {
-          return cmd.registeredArguments;
-        }
-        return [];
-      }
-      /**
-       * Get the command term to show in the list of subcommands.
-       *
-       * @param {Command} cmd
-       * @returns {string}
-       */
-      subcommandTerm(cmd) {
-        const args = cmd.registeredArguments.map((arg) => humanReadableArgName(arg)).join(" ");
-        return cmd._name + (cmd._aliases[0] ? "|" + cmd._aliases[0] : "") + (cmd.options.length ? " [options]" : "") + // simplistic check for non-help option
-        (args ? " " + args : "");
-      }
-      /**
-       * Get the option term to show in the list of options.
-       *
-       * @param {Option} option
-       * @returns {string}
-       */
-      optionTerm(option) {
-        return option.flags;
-      }
-      /**
-       * Get the argument term to show in the list of arguments.
-       *
-       * @param {Argument} argument
-       * @returns {string}
-       */
-      argumentTerm(argument) {
-        return argument.name();
-      }
-      /**
-       * Get the longest command term length.
-       *
-       * @param {Command} cmd
-       * @param {Help} helper
-       * @returns {number}
-       */
-      longestSubcommandTermLength(cmd, helper) {
-        return helper.visibleCommands(cmd).reduce((max, command) => {
-          return Math.max(max, helper.subcommandTerm(command).length);
-        }, 0);
-      }
-      /**
-       * Get the longest option term length.
-       *
-       * @param {Command} cmd
-       * @param {Help} helper
-       * @returns {number}
-       */
-      longestOptionTermLength(cmd, helper) {
-        return helper.visibleOptions(cmd).reduce((max, option) => {
-          return Math.max(max, helper.optionTerm(option).length);
-        }, 0);
-      }
-      /**
-       * Get the longest global option term length.
-       *
-       * @param {Command} cmd
-       * @param {Help} helper
-       * @returns {number}
-       */
-      longestGlobalOptionTermLength(cmd, helper) {
-        return helper.visibleGlobalOptions(cmd).reduce((max, option) => {
-          return Math.max(max, helper.optionTerm(option).length);
-        }, 0);
-      }
-      /**
-       * Get the longest argument term length.
-       *
-       * @param {Command} cmd
-       * @param {Help} helper
-       * @returns {number}
-       */
-      longestArgumentTermLength(cmd, helper) {
-        return helper.visibleArguments(cmd).reduce((max, argument) => {
-          return Math.max(max, helper.argumentTerm(argument).length);
-        }, 0);
-      }
-      /**
-       * Get the command usage to be displayed at the top of the built-in help.
-       *
-       * @param {Command} cmd
-       * @returns {string}
-       */
-      commandUsage(cmd) {
-        let cmdName = cmd._name;
-        if (cmd._aliases[0]) {
-          cmdName = cmdName + "|" + cmd._aliases[0];
-        }
-        let ancestorCmdNames = "";
-        for (let ancestorCmd = cmd.parent; ancestorCmd; ancestorCmd = ancestorCmd.parent) {
-          ancestorCmdNames = ancestorCmd.name() + " " + ancestorCmdNames;
-        }
-        return ancestorCmdNames + cmdName + " " + cmd.usage();
-      }
-      /**
-       * Get the description for the command.
-       *
-       * @param {Command} cmd
-       * @returns {string}
-       */
-      commandDescription(cmd) {
-        return cmd.description();
-      }
-      /**
-       * Get the subcommand summary to show in the list of subcommands.
-       * (Fallback to description for backwards compatibility.)
-       *
-       * @param {Command} cmd
-       * @returns {string}
-       */
-      subcommandDescription(cmd) {
-        return cmd.summary() || cmd.description();
-      }
-      /**
-       * Get the option description to show in the list of options.
-       *
-       * @param {Option} option
-       * @return {string}
-       */
-      optionDescription(option) {
-        const extraInfo = [];
-        if (option.argChoices) {
-          extraInfo.push(
-            // use stringify to match the display of the default value
-            `choices: ${option.argChoices.map((choice) => JSON.stringify(choice)).join(", ")}`
-          );
-        }
-        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)}`);
-          }
-        }
-        if (option.presetArg !== void 0 && option.optional) {
-          extraInfo.push(`preset: ${JSON.stringify(option.presetArg)}`);
-        }
-        if (option.envVar !== void 0) {
-          extraInfo.push(`env: ${option.envVar}`);
-        }
-        if (extraInfo.length > 0) {
-          return `${option.description} (${extraInfo.join(", ")})`;
-        }
-        return option.description;
-      }
-      /**
-       * Get the argument description to show in the list of arguments.
-       *
-       * @param {Argument} argument
-       * @return {string}
-       */
-      argumentDescription(argument) {
-        const extraInfo = [];
-        if (argument.argChoices) {
-          extraInfo.push(
-            // use stringify to match the display of the default value
-            `choices: ${argument.argChoices.map((choice) => JSON.stringify(choice)).join(", ")}`
-          );
-        }
-        if (argument.defaultValue !== void 0) {
-          extraInfo.push(`default: ${argument.defaultValueDescription || JSON.stringify(argument.defaultValue)}`);
-        }
-        if (extraInfo.length > 0) {
-          const extraDescripton = `(${extraInfo.join(", ")})`;
-          if (argument.description) {
-            return `${argument.description} ${extraDescripton}`;
-          }
-          return extraDescripton;
-        }
-        return argument.description;
-      }
-      /**
-       * Generate the built-in help text.
-       *
-       * @param {Command} cmd
-       * @param {Help} helper
-       * @returns {string}
-       */
-      formatHelp(cmd, helper) {
-        const termWidth = helper.padWidth(cmd, helper);
-        const helpWidth = helper.helpWidth || 80;
-        const itemIndentWidth = 2;
-        const itemSeparatorWidth = 2;
-        function formatItem(term, description) {
-          if (description) {
-            const fullText = `${term.padEnd(termWidth + itemSeparatorWidth)}${description}`;
-            return helper.wrap(fullText, helpWidth - itemIndentWidth, termWidth + itemSeparatorWidth);
-          }
-          return term;
-        }
-        function formatList(textArray) {
-          return textArray.join("\n").replace(/^/gm, " ".repeat(itemIndentWidth));
-        }
-        let output = [`Usage: ${helper.commandUsage(cmd)}`, ""];
-        const commandDescription = helper.commandDescription(cmd);
-        if (commandDescription.length > 0) {
-          output = output.concat([helper.wrap(commandDescription, helpWidth, 0), ""]);
-        }
-        const argumentList = helper.visibleArguments(cmd).map((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));
-        });
-        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));
-          });
-          if (globalOptionList.length > 0) {
-            output = output.concat(["Global Options:", formatList(globalOptionList), ""]);
-          }
-        }
-        const commandList = helper.visibleCommands(cmd).map((cmd2) => {
-          return formatItem(helper.subcommandTerm(cmd2), helper.subcommandDescription(cmd2));
-        });
-        if (commandList.length > 0) {
-          output = output.concat(["Commands:", formatList(commandList), ""]);
-        }
-        return output.join("\n");
-      }
-      /**
-       * Calculate the pad width from the maximum term length.
-       *
-       * @param {Command} cmd
-       * @param {Help} helper
-       * @returns {number}
-       */
-      padWidth(cmd, helper) {
-        return Math.max(
-          helper.longestOptionTermLength(cmd, helper),
-          helper.longestGlobalOptionTermLength(cmd, helper),
-          helper.longestSubcommandTermLength(cmd, helper),
-          helper.longestArgumentTermLength(cmd, helper)
-        );
-      }
-      /**
-       * Wrap the given string to width characters per line, with lines after the first indented.
-       * Do not wrap if insufficient room for wrapping (minColumnWidth), or string is manually formatted.
-       *
-       * @param {string} str
-       * @param {number} width
-       * @param {number} indent
-       * @param {number} [minColumnWidth=40]
-       * @return {string}
-       *
-       */
-      wrap(str, width, indent, minColumnWidth = 40) {
-        const indents = " \\f\\t\\v\xA0\u1680\u2000-\u200A\u202F\u205F\u3000\uFEFF";
-        const manualIndent = new RegExp(`[\\n][${indents}]+`);
-        if (str.match(manualIndent)) return str;
-        const columnWidth = width - indent;
-        if (columnWidth < minColumnWidth) return str;
-        const leadingStr = str.slice(0, indent);
-        const columnText = str.slice(indent).replace("\r\n", "\n");
-        const indentString = " ".repeat(indent);
-        const zeroWidthSpace = "\u200B";
-        const breaks = `\\s${zeroWidthSpace}`;
-        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 "";
-          return (i > 0 ? indentString : "") + line.trimEnd();
-        }).join("\n");
-      }
-    };
-    exports.Help = Help2;
-  }
-});
-
-// ../../node_modules/.pnpm/commander@11.1.0/node_modules/commander/lib/option.js
-var require_option = __commonJS({
-  "../../node_modules/.pnpm/commander@11.1.0/node_modules/commander/lib/option.js"(exports) {
-    "use strict";
-    var { InvalidArgumentError: InvalidArgumentError2 } = require_error();
-    var Option2 = class {
-      /**
-       * Initialize a new `Option` with the given `flags` and `description`.
-       *
-       * @param {string} flags
-       * @param {string} [description]
-       */
-      constructor(flags, description) {
-        this.flags = flags;
-        this.description = description || "";
-        this.required = flags.includes("<");
-        this.optional = flags.includes("[");
-        this.variadic = /\w\.\.\.[>\]]$/.test(flags);
-        this.mandatory = false;
-        const optionFlags = splitOptionFlags(flags);
-        this.short = optionFlags.shortFlag;
-        this.long = optionFlags.longFlag;
-        this.negate = false;
-        if (this.long) {
-          this.negate = this.long.startsWith("--no-");
-        }
-        this.defaultValue = void 0;
-        this.defaultValueDescription = void 0;
-        this.presetArg = void 0;
-        this.envVar = void 0;
-        this.parseArg = void 0;
-        this.hidden = false;
-        this.argChoices = void 0;
-        this.conflictsWith = [];
-        this.implied = void 0;
-      }
-      /**
-       * Set the default value, and optionally supply the description to be displayed in the help.
-       *
-       * @param {*} value
-       * @param {string} [description]
-       * @return {Option}
-       */
-      default(value, description) {
-        this.defaultValue = value;
-        this.defaultValueDescription = description;
-        return this;
-      }
-      /**
-       * Preset to use when option used without option-argument, especially optional but also boolean and negated.
-       * The custom processing (parseArg) is called.
-       *
-       * @example
-       * new Option('--color').default('GREYSCALE').preset('RGB');
-       * new Option('--donate [amount]').preset('20').argParser(parseFloat);
-       *
-       * @param {*} arg
-       * @return {Option}
-       */
-      preset(arg) {
-        this.presetArg = arg;
-        return this;
-      }
-      /**
-       * Add option name(s) that conflict with this option.
-       * An error will be displayed if conflicting options are found during parsing.
-       *
-       * @example
-       * new Option('--rgb').conflicts('cmyk');
-       * new Option('--js').conflicts(['ts', 'jsx']);
-       *
-       * @param {string | string[]} names
-       * @return {Option}
-       */
-      conflicts(names) {
-        this.conflictsWith = this.conflictsWith.concat(names);
-        return this;
-      }
-      /**
-       * Specify implied option values for when this option is set and the implied options are not.
-       *
-       * The custom processing (parseArg) is not called on the implied values.
-       *
-       * @example
-       * program
-       *   .addOption(new Option('--log', 'write logging information to file'))
-       *   .addOption(new Option('--trace', 'log extra details').implies({ log: 'trace.txt' }));
-       *
-       * @param {Object} impliedOptionValues
-       * @return {Option}
-       */
-      implies(impliedOptionValues) {
-        let newImplied = impliedOptionValues;
-        if (typeof impliedOptionValues === "string") {
-          newImplied = { [impliedOptionValues]: true };
-        }
-        this.implied = Object.assign(this.implied || {}, newImplied);
-        return this;
-      }
-      /**
-       * Set environment variable to check for option value.
-       *
-       * An environment variable is only used if when processed the current option value is
-       * undefined, or the source of the current value is 'default' or 'config' or 'env'.
-       *
-       * @param {string} name
-       * @return {Option}
-       */
-      env(name) {
-        this.envVar = name;
-        return this;
-      }
-      /**
-       * Set the custom handler for processing CLI option arguments into option values.
-       *
-       * @param {Function} [fn]
-       * @return {Option}
-       */
-      argParser(fn) {
-        this.parseArg = fn;
-        return this;
-      }
-      /**
-       * Whether the option is mandatory and must have a value after parsing.
-       *
-       * @param {boolean} [mandatory=true]
-       * @return {Option}
-       */
-      makeOptionMandatory(mandatory = true) {
-        this.mandatory = !!mandatory;
-        return this;
-      }
-      /**
-       * Hide option in help.
-       *
-       * @param {boolean} [hide=true]
-       * @return {Option}
-       */
-      hideHelp(hide = true) {
-        this.hidden = !!hide;
-        return this;
-      }
-      /**
-       * @api private
-       */
-      _concatValue(value, previous) {
-        if (previous === this.defaultValue || !Array.isArray(previous)) {
-          return [value];
-        }
-        return previous.concat(value);
-      }
-      /**
-       * Only allow option value to be one of choices.
-       *
-       * @param {string[]} values
-       * @return {Option}
-       */
-      choices(values) {
-        this.argChoices = values.slice();
-        this.parseArg = (arg, previous) => {
-          if (!this.argChoices.includes(arg)) {
-            throw new InvalidArgumentError2(`Allowed choices are ${this.argChoices.join(", ")}.`);
-          }
-          if (this.variadic) {
-            return this._concatValue(arg, previous);
-          }
-          return arg;
-        };
-        return this;
-      }
-      /**
-       * Return option name.
-       *
-       * @return {string}
-       */
-      name() {
-        if (this.long) {
-          return this.long.replace(/^--/, "");
-        }
-        return this.short.replace(/^-/, "");
-      }
-      /**
-       * Return option name, in a camelcase format that can be used
-       * as a object attribute key.
-       *
-       * @return {string}
-       * @api private
-       */
-      attributeName() {
-        return camelcase(this.name().replace(/^no-/, ""));
-      }
-      /**
-       * Check if `arg` matches the short or long flag.
-       *
-       * @param {string} arg
-       * @return {boolean}
-       * @api private
-       */
-      is(arg) {
-        return this.short === arg || this.long === arg;
-      }
-      /**
-       * Return whether a boolean option.
-       *
-       * Options are one of boolean, negated, required argument, or optional argument.
-       *
-       * @return {boolean}
-       * @api private
-       */
-      isBoolean() {
-        return !this.required && !this.optional && !this.negate;
-      }
-    };
-    var DualOptions = class {
-      /**
-       * @param {Option[]} options
-       */
-      constructor(options) {
-        this.positiveOptions = /* @__PURE__ */ new Map();
-        this.negativeOptions = /* @__PURE__ */ new Map();
-        this.dualOptions = /* @__PURE__ */ new Set();
-        options.forEach((option) => {
-          if (option.negate) {
-            this.negativeOptions.set(option.attributeName(), option);
-          } else {
-            this.positiveOptions.set(option.attributeName(), option);
-          }
-        });
-        this.negativeOptions.forEach((value, key) => {
-          if (this.positiveOptions.has(key)) {
-            this.dualOptions.add(key);
-          }
-        });
-      }
-      /**
-       * Did the value come from the option, and not from possible matching dual option?
-       *
-       * @param {*} value
-       * @param {Option} option
-       * @returns {boolean}
-       */
-      valueFromOption(value, option) {
-        const optionKey = option.attributeName();
-        if (!this.dualOptions.has(optionKey)) return true;
-        const preset = this.negativeOptions.get(optionKey).presetArg;
-        const negativeValue = preset !== void 0 ? preset : false;
-        return option.negate === (negativeValue === value);
-      }
-    };
-    function camelcase(str) {
-      return str.split("-").reduce((str2, word) => {
-        return str2 + word[0].toUpperCase() + word.slice(1);
-      });
-    }
-    function splitOptionFlags(flags) {
-      let shortFlag;
-      let longFlag;
-      const flagParts = flags.split(/[ |,]+/);
-      if (flagParts.length > 1 && !/^[[<]/.test(flagParts[1])) shortFlag = flagParts.shift();
-      longFlag = flagParts.shift();
-      if (!shortFlag && /^-[^-]$/.test(longFlag)) {
-        shortFlag = longFlag;
-        longFlag = void 0;
-      }
-      return { shortFlag, longFlag };
-    }
-    exports.Option = Option2;
-    exports.splitOptionFlags = splitOptionFlags;
-    exports.DualOptions = DualOptions;
-  }
-});
-
-// ../../node_modules/.pnpm/commander@11.1.0/node_modules/commander/lib/suggestSimilar.js
-var require_suggestSimilar = __commonJS({
-  "../../node_modules/.pnpm/commander@11.1.0/node_modules/commander/lib/suggestSimilar.js"(exports) {
-    "use strict";
-    var maxDistance = 3;
-    function editDistance(a, b) {
-      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];
-      }
-      for (let j = 0; j <= b.length; j++) {
-        d[0][j] = j;
-      }
-      for (let j = 1; j <= b.length; j++) {
-        for (let i = 1; i <= a.length; i++) {
-          let cost = 1;
-          if (a[i - 1] === b[j - 1]) {
-            cost = 0;
-          } else {
-            cost = 1;
-          }
-          d[i][j] = Math.min(
-            d[i - 1][j] + 1,
-            // deletion
-            d[i][j - 1] + 1,
-            // insertion
-            d[i - 1][j - 1] + cost
-            // substitution
-          );
-          if (i > 1 && j > 1 && a[i - 1] === b[j - 2] && a[i - 2] === b[j - 1]) {
-            d[i][j] = Math.min(d[i][j], d[i - 2][j - 2] + 1);
-          }
-        }
-      }
-      return d[a.length][b.length];
-    }
-    function suggestSimilar(word, candidates) {
-      if (!candidates || candidates.length === 0) return "";
-      candidates = Array.from(new Set(candidates));
-      const searchingOptions = word.startsWith("--");
-      if (searchingOptions) {
-        word = word.slice(2);
-        candidates = candidates.map((candidate) => candidate.slice(2));
-      }
-      let similar = [];
-      let bestDistance = maxDistance;
-      const minSimilarity = 0.4;
-      candidates.forEach((candidate) => {
-        if (candidate.length <= 1) return;
-        const distance = editDistance(word, candidate);
-        const length = Math.max(word.length, candidate.length);
-        const similarity = (length - distance) / length;
-        if (similarity > minSimilarity) {
-          if (distance < bestDistance) {
-            bestDistance = distance;
-            similar = [candidate];
-          } else if (distance === bestDistance) {
-            similar.push(candidate);
-          }
-        }
-      });
-      similar.sort((a, b) => a.localeCompare(b));
-      if (searchingOptions) {
-        similar = similar.map((candidate) => `--${candidate}`);
-      }
-      if (similar.length > 1) {
-        return `
-(Did you mean one of ${similar.join(", ")}?)`;
-      }
-      if (similar.length === 1) {
-        return `
-(Did you mean ${similar[0]}?)`;
-      }
-      return "";
-    }
-    exports.suggestSimilar = suggestSimilar;
-  }
-});
-
-// ../../node_modules/.pnpm/commander@11.1.0/node_modules/commander/lib/command.js
-var require_command = __commonJS({
-  "../../node_modules/.pnpm/commander@11.1.0/node_modules/commander/lib/command.js"(exports) {
-    "use strict";
-    var EventEmitter = __require("events").EventEmitter;
-    var childProcess = __require("child_process");
-    var path = __require("path");
-    var fs = __require("fs");
-    var process4 = __require("process");
-    var { Argument: Argument2, humanReadableArgName } = require_argument();
-    var { CommanderError: CommanderError2 } = require_error();
-    var { Help: Help2 } = require_help();
-    var { Option: Option2, splitOptionFlags, DualOptions } = require_option();
-    var { suggestSimilar } = require_suggestSimilar();
-    var Command2 = class _Command extends EventEmitter {
-      /**
-       * Initialize a new `Command`.
-       *
-       * @param {string} [name]
-       */
-      constructor(name) {
-        super();
-        this.commands = [];
-        this.options = [];
-        this.parent = null;
-        this._allowUnknownOption = false;
-        this._allowExcessArguments = true;
-        this.registeredArguments = [];
-        this._args = this.registeredArguments;
-        this.args = [];
-        this.rawArgs = [];
-        this.processedArgs = [];
-        this._scriptPath = null;
-        this._name = name || "";
-        this._optionValues = {};
-        this._optionValueSources = {};
-        this._storeOptionsAsProperties = false;
-        this._actionHandler = null;
-        this._executableHandler = false;
-        this._executableFile = null;
-        this._executableDir = null;
-        this._defaultCommandName = null;
-        this._exitCallback = null;
-        this._aliases = [];
-        this._combineFlagAndOptionalValue = true;
-        this._description = "";
-        this._summary = "";
-        this._argsDescription = void 0;
-        this._enablePositionalOptions = false;
-        this._passThroughOptions = false;
-        this._lifeCycleHooks = {};
-        this._showHelpAfterError = false;
-        this._showSuggestionAfterError = true;
-        this._outputConfiguration = {
-          writeOut: (str) => process4.stdout.write(str),
-          writeErr: (str) => process4.stderr.write(str),
-          getOutHelpWidth: () => process4.stdout.isTTY ? process4.stdout.columns : void 0,
-          getErrHelpWidth: () => process4.stderr.isTTY ? process4.stderr.columns : void 0,
-          outputError: (str, write) => write(str)
-        };
-        this._hidden = false;
-        this._hasHelpOption = true;
-        this._helpFlags = "-h, --help";
-        this._helpDescription = "display help for command";
-        this._helpShortFlag = "-h";
-        this._helpLongFlag = "--help";
-        this._addImplicitHelpCommand = void 0;
-        this._helpCommandName = "help";
-        this._helpCommandnameAndArgs = "help [command]";
-        this._helpCommandDescription = "display help for command";
-        this._helpConfiguration = {};
-      }
-      /**
-       * Copy settings that are useful to have in common across root command and subcommands.
-       *
-       * (Used internally when adding a command using `.command()` so subcommands inherit parent settings.)
-       *
-       * @param {Command} sourceCommand
-       * @return {Command} `this` command for chaining
-       */
-      copyInheritedSettings(sourceCommand) {
-        this._outputConfiguration = sourceCommand._outputConfiguration;
-        this._hasHelpOption = sourceCommand._hasHelpOption;
-        this._helpFlags = sourceCommand._helpFlags;
-        this._helpDescription = sourceCommand._helpDescription;
-        this._helpShortFlag = sourceCommand._helpShortFlag;
-        this._helpLongFlag = sourceCommand._helpLongFlag;
-        this._helpCommandName = sourceCommand._helpCommandName;
-        this._helpCommandnameAndArgs = sourceCommand._helpCommandnameAndArgs;
-        this._helpCommandDescription = sourceCommand._helpCommandDescription;
-        this._helpConfiguration = sourceCommand._helpConfiguration;
-        this._exitCallback = sourceCommand._exitCallback;
-        this._storeOptionsAsProperties = sourceCommand._storeOptionsAsProperties;
-        this._combineFlagAndOptionalValue = sourceCommand._combineFlagAndOptionalValue;
-        this._allowExcessArguments = sourceCommand._allowExcessArguments;
-        this._enablePositionalOptions = sourceCommand._enablePositionalOptions;
-        this._showHelpAfterError = sourceCommand._showHelpAfterError;
-        this._showSuggestionAfterError = sourceCommand._showSuggestionAfterError;
-        return this;
-      }
-      /**
-       * @returns {Command[]}
-       * @api private
-       */
-      _getCommandAndAncestors() {
-        const result = [];
-        for (let command = this; command; command = command.parent) {
-          result.push(command);
-        }
-        return result;
-      }
-      /**
-       * Define a command.
-       *
-       * There are two styles of command: pay attention to where to put the description.
-       *
-       * @example
-       * // Command implemented using action handler (description is supplied separately to `.command`)
-       * program
-       *   .command('clone <source> [destination]')
-       *   .description('clone a repository into a newly created directory')
-       *   .action((source, destination) => {
-       *     console.log('clone command called');
-       *   });
-       *
-       * // Command implemented using separate executable file (description is second parameter to `.command`)
-       * program
-       *   .command('start <service>', 'start named service')
-       *   .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)
-       * @return {Command} returns new command for action handler, or `this` for executable command
-       */
-      command(nameAndArgs, actionOptsOrExecDesc, execOpts) {
-        let desc = actionOptsOrExecDesc;
-        let opts = execOpts;
-        if (typeof desc === "object" && desc !== null) {
-          opts = desc;
-          desc = null;
-        }
-        opts = opts || {};
-        const [, name, args] = nameAndArgs.match(/([^ ]+) *(.*)/);
-        const cmd = this.createCommand(name);
-        if (desc) {
-          cmd.description(desc);
-          cmd._executableHandler = true;
-        }
-        if (opts.isDefault) this._defaultCommandName = cmd._name;
-        cmd._hidden = !!(opts.noHelp || opts.hidden);
-        cmd._executableFile = opts.executableFile || null;
-        if (args) cmd.arguments(args);
-        this.commands.push(cmd);
-        cmd.parent = this;
-        cmd.copyInheritedSettings(this);
-        if (desc) return this;
-        return cmd;
-      }
-      /**
-       * Factory routine to create a new unattached command.
-       *
-       * See .command() for creating an attached subcommand, which uses this routine to
-       * create the command. You can override createCommand to customise subcommands.
-       *
-       * @param {string} [name]
-       * @return {Command} new command
-       */
-      createCommand(name) {
-        return new _Command(name);
-      }
-      /**
-       * You can customise the help with a subclass of Help by overriding createHelp,
-       * or by overriding Help properties using configureHelp().
-       *
-       * @return {Help}
-       */
-      createHelp() {
-        return Object.assign(new Help2(), this.configureHelp());
-      }
-      /**
-       * 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
-       */
-      configureHelp(configuration) {
-        if (configuration === void 0) return this._helpConfiguration;
-        this._helpConfiguration = configuration;
-        return this;
-      }
-      /**
-       * The default output goes to stdout and stderr. You can customise this for special
-       * applications. You can also customise the display of errors by overriding outputError.
-       *
-       * The configuration properties are all functions:
-       *
-       *     // functions to change where being written, stdout and stderr
-       *     writeOut(str)
-       *     writeErr(str)
-       *     // matching functions to specify width for wrapping help
-       *     getOutHelpWidth()
-       *     getErrHelpWidth()
-       *     // 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
-       */
-      configureOutput(configuration) {
-        if (configuration === void 0) return this._outputConfiguration;
-        Object.assign(this._outputConfiguration, configuration);
-        return this;
-      }
-      /**
-       * Display the help or a custom message after an error occurs.
-       *
-       * @param {boolean|string} [displayHelp]
-       * @return {Command} `this` command for chaining
-       */
-      showHelpAfterError(displayHelp = true) {
-        if (typeof displayHelp !== "string") displayHelp = !!displayHelp;
-        this._showHelpAfterError = displayHelp;
-        return this;
-      }
-      /**
-       * Display suggestion of similar commands for unknown commands, or options for unknown options.
-       *
-       * @param {boolean} [displaySuggestion]
-       * @return {Command} `this` command for chaining
-       */
-      showSuggestionAfterError(displaySuggestion = true) {
-        this._showSuggestionAfterError = !!displaySuggestion;
-        return this;
-      }
-      /**
-       * Add a prepared subcommand.
-       *
-       * See .command() for creating an attached subcommand which inherits settings from its parent.
-       *
-       * @param {Command} cmd - new subcommand
-       * @param {Object} [opts] - configuration options
-       * @return {Command} `this` command for chaining
-       */
-      addCommand(cmd, opts) {
-        if (!cmd._name) {
-          throw new Error(`Command passed to .addCommand() must have a name
-- specify the name in Command constructor or using .name()`);
-        }
-        opts = opts || {};
-        if (opts.isDefault) this._defaultCommandName = cmd._name;
-        if (opts.noHelp || opts.hidden) cmd._hidden = true;
-        this.commands.push(cmd);
-        cmd.parent = this;
-        return this;
-      }
-      /**
-       * Factory routine to create a new unattached argument.
-       *
-       * See .argument() for creating an attached argument, which uses this routine to
-       * create the argument. You can override createArgument to return a custom argument.
-       *
-       * @param {string} name
-       * @param {string} [description]
-       * @return {Argument} new argument
-       */
-      createArgument(name, description) {
-        return new Argument2(name, description);
-      }
-      /**
-       * Define argument syntax for command.
-       *
-       * The default is that the argument is required, and you can explicitly
-       * indicate this with <> around the name. Put [] around the name for an optional argument.
-       *
-       * @example
-       * program.argument('<input-file>');
-       * program.argument('[output-file]');
-       *
-       * @param {string} name
-       * @param {string} [description]
-       * @param {Function|*} [fn] - custom argument processing function
-       * @param {*} [defaultValue]
-       * @return {Command} `this` command for chaining
-       */
-      argument(name, description, fn, defaultValue) {
-        const argument = this.createArgument(name, description);
-        if (typeof fn === "function") {
-          argument.default(defaultValue).argParser(fn);
-        } else {
-          argument.default(fn);
-        }
-        this.addArgument(argument);
-        return this;
-      }
-      /**
-       * Define argument syntax for command, adding multiple at once (without descriptions).
-       *
-       * See also .argument().
-       *
-       * @example
-       * program.arguments('<cmd> [env]');
-       *
-       * @param {string} names
-       * @return {Command} `this` command for chaining
-       */
-      arguments(names) {
-        names.trim().split(/ +/).forEach((detail) => {
-          this.argument(detail);
-        });
-        return this;
-      }
-      /**
-       * Define argument syntax for command, adding a prepared argument.
-       *
-       * @param {Argument} argument
-       * @return {Command} `this` command for chaining
-       */
-      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()}'`);
-        }
-        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()}'`);
-        }
-        this.registeredArguments.push(argument);
-        return this;
-      }
-      /**
-       * Override default decision whether to add implicit help command.
-       *
-       *    addHelpCommand() // force on
-       *    addHelpCommand(false); // force off
-       *    addHelpCommand('help [cmd]', 'display help for [cmd]'); // force on with custom details
-       *
-       * @return {Command} `this` command for chaining
-       */
-      addHelpCommand(enableOrNameAndArgs, description) {
-        if (enableOrNameAndArgs === false) {
-          this._addImplicitHelpCommand = false;
-        } else {
-          this._addImplicitHelpCommand = true;
-          if (typeof enableOrNameAndArgs === "string") {
-            this._helpCommandName = enableOrNameAndArgs.split(" ")[0];
-            this._helpCommandnameAndArgs = enableOrNameAndArgs;
-          }
-          this._helpCommandDescription = description || this._helpCommandDescription;
-        }
-        return this;
-      }
-      /**
-       * @return {boolean}
-       * @api private
-       */
-      _hasImplicitHelpCommand() {
-        if (this._addImplicitHelpCommand === void 0) {
-          return this.commands.length && !this._actionHandler && !this._findCommand("help");
-        }
-        return this._addImplicitHelpCommand;
-      }
-      /**
-       * Add hook for life cycle event.
-       *
-       * @param {string} event
-       * @param {Function} listener
-       * @return {Command} `this` command for chaining
-       */
-      hook(event, listener) {
-        const allowedValues = ["preSubcommand", "preAction", "postAction"];
-        if (!allowedValues.includes(event)) {
-          throw new Error(`Unexpected value for event passed to hook : '${event}'.
-Expecting one of '${allowedValues.join("', '")}'`);
-        }
-        if (this._lifeCycleHooks[event]) {
-          this._lifeCycleHooks[event].push(listener);
-        } else {
-          this._lifeCycleHooks[event] = [listener];
-        }
-        return this;
-      }
-      /**
-       * Register callback to use as replacement for calling process.exit.
-       *
-       * @param {Function} [fn] optional callback which will be passed a CommanderError, defaults to throwing
-       * @return {Command} `this` command for chaining
-       */
-      exitOverride(fn) {
-        if (fn) {
-          this._exitCallback = fn;
-        } else {
-          this._exitCallback = (err) => {
-            if (err.code !== "commander.executeSubCommandAsync") {
-              throw err;
-            } else {
-            }
-          };
-        }
-        return this;
-      }
-      /**
-       * Call process.exit, and _exitCallback if defined.
-       *
-       * @param {number} exitCode exit code for using with process.exit
-       * @param {string} code an id string representing the error
-       * @param {string} message human-readable description of the error
-       * @return never
-       * @api private
-       */
-      _exit(exitCode2, code, message) {
-        if (this._exitCallback) {
-          this._exitCallback(new CommanderError2(exitCode2, code, message));
-        }
-        process4.exit(exitCode2);
-      }
-      /**
-       * Register callback `fn` for the command.
-       *
-       * @example
-       * program
-       *   .command('serve')
-       *   .description('start service')
-       *   .action(function() {
-       *      // do work here
-       *   });
-       *
-       * @param {Function} fn
-       * @return {Command} `this` command for chaining
-       */
-      action(fn) {
-        const listener = (args) => {
-          const expectedArgsCount = this.registeredArguments.length;
-          const actionArgs = args.slice(0, expectedArgsCount);
-          if (this._storeOptionsAsProperties) {
-            actionArgs[expectedArgsCount] = this;
-          } else {
-            actionArgs[expectedArgsCount] = this.opts();
-          }
-          actionArgs.push(this);
-          return fn.apply(this, actionArgs);
-        };
-        this._actionHandler = listener;
-        return this;
-      }
-      /**
-       * Factory routine to create a new unattached option.
-       *
-       * See .option() for creating an attached option, which uses this routine to
-       * create the option. You can override createOption to return a custom option.
-       *
-       * @param {string} flags
-       * @param {string} [description]
-       * @return {Option} new option
-       */
-      createOption(flags, description) {
-        return new Option2(flags, description);
-      }
-      /**
-       * Wrap parseArgs to catch 'commander.invalidArgument'.
-       *
-       * @param {Option | Argument} target
-       * @param {string} value
-       * @param {*} previous
-       * @param {string} invalidArgumentMessage
-       * @api private
-       */
-      _callParseArg(target, value, previous, invalidArgumentMessage) {
-        try {
-          return target.parseArg(value, previous);
-        } catch (err) {
-          if (err.code === "commander.invalidArgument") {
-            const message = `${invalidArgumentMessage} ${err.message}`;
-            this.error(message, { exitCode: err.exitCode, code: err.code });
-          }
-          throw err;
-        }
-      }
-      /**
-       * Add an option.
-       *
-       * @param {Option} option
-       * @return {Command} `this` command for chaining
-       */
-      addOption(option) {
-        const oname = option.name();
-        const name = option.attributeName();
-        if (option.negate) {
-          const positiveLongFlag = option.long.replace(/^--no-/, "--");
-          if (!this._findOption(positiveLongFlag)) {
-            this.setOptionValueWithSource(name, option.defaultValue === void 0 ? true : option.defaultValue, "default");
-          }
-        } else if (option.defaultValue !== void 0) {
-          this.setOptionValueWithSource(name, option.defaultValue, "default");
-        }
-        this.options.push(option);
-        const handleOptionValue = (val, invalidValueMessage, valueSource) => {
-          if (val == null && option.presetArg !== void 0) {
-            val = option.presetArg;
-          }
-          const oldValue = this.getOptionValue(name);
-          if (val !== null && option.parseArg) {
-            val = this._callParseArg(option, val, oldValue, invalidValueMessage);
-          } else if (val !== null && option.variadic) {
-            val = option._concatValue(val, oldValue);
-          }
-          if (val == null) {
-            if (option.negate) {
-              val = false;
-            } else if (option.isBoolean() || option.optional) {
-              val = true;
-            } else {
-              val = "";
-            }
-          }
-          this.setOptionValueWithSource(name, val, valueSource);
-        };
-        this.on("option:" + oname, (val) => {
-          const invalidValueMessage = `error: option '${option.flags}' argument '${val}' is invalid.`;
-          handleOptionValue(val, invalidValueMessage, "cli");
-        });
-        if (option.envVar) {
-          this.on("optionEnv:" + oname, (val) => {
-            const invalidValueMessage = `error: option '${option.flags}' value '${val}' from env '${option.envVar}' is invalid.`;
-            handleOptionValue(val, invalidValueMessage, "env");
-          });
-        }
-        return this;
-      }
-      /**
-       * Internal implementation shared by .option() and .requiredOption()
-       *
-       * @api private
-       */
-      _optionEx(config3, 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()");
-        }
-        const option = this.createOption(flags, description);
-        option.makeOptionMandatory(!!config3.mandatory);
-        if (typeof fn === "function") {
-          option.default(defaultValue).argParser(fn);
-        } else if (fn instanceof RegExp) {
-          const regex = fn;
-          fn = (val, def) => {
-            const m = regex.exec(val);
-            return m ? m[0] : def;
-          };
-          option.default(defaultValue).argParser(fn);
-        } else {
-          option.default(fn);
-        }
-        return this.addOption(option);
-      }
-      /**
-       * Define option with `flags`, `description`, and optional argument parsing function or `defaultValue` or both.
-       *
-       * The `flags` string contains the short and/or long flags, separated by comma, a pipe or space. A required
-       * option-argument is indicated by `<>` and an optional option-argument by `[]`.
-       *
-       * See the README for more details, and see also addOption() and requiredOption().
-       *
-       * @example
-       * program
-       *     .option('-p, --pepper', 'add pepper')
-       *     .option('-p, --pizza-type <TYPE>', 'type of pizza') // required option-argument
-       *     .option('-c, --cheese [CHEESE]', 'add extra cheese', 'mozzarella') // optional option-argument with default
-       *     .option('-t, --tip <VALUE>', 'add tip to purchase cost', parseFloat) // custom parse function
-       *
-       * @param {string} flags
-       * @param {string} [description]
-       * @param {Function|*} [parseArg] - custom option processing function or default value
-       * @param {*} [defaultValue]
-       * @return {Command} `this` command for chaining
-       */
-      option(flags, description, parseArg, defaultValue) {
-        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
-      */
-      requiredOption(flags, description, parseArg, defaultValue) {
-        return this._optionEx({ mandatory: true }, flags, description, parseArg, defaultValue);
-      }
-      /**
-       * Alter parsing of short flags with optional values.
-       *
-       * @example
-       * // for `.option('-f,--flag [value]'):
-       * 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.
-       */
-      combineFlagAndOptionalValue(combine = true) {
-        this._combineFlagAndOptionalValue = !!combine;
-        return this;
-      }
-      /**
-       * Allow unknown options on the command line.
-       *
-       * @param {Boolean} [allowUnknown=true] - if `true` or omitted, no error will be thrown
-       * for unknown options.
-       */
-      allowUnknownOption(allowUnknown = true) {
-        this._allowUnknownOption = !!allowUnknown;
-        return this;
-      }
-      /**
-       * 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.
-       */
-      allowExcessArguments(allowExcess = true) {
-        this._allowExcessArguments = !!allowExcess;
-        return this;
-      }
-      /**
-       * Enable positional options. Positional means global options are specified before subcommands which lets
-       * 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]
-       */
-      enablePositionalOptions(positional = true) {
-        this._enablePositionalOptions = !!positional;
-        return this;
-      }
-      /**
-       * Pass through options that come after command-arguments rather than treat them as command-options,
-       * so actual command-options come before command-arguments. Turning this on for a subcommand requires
-       * 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.
-       */
-      passThroughOptions(passThrough = true) {
-        this._passThroughOptions = !!passThrough;
-        if (!!this.parent && passThrough && !this.parent._enablePositionalOptions) {
-          throw new Error("passThroughOptions can not be used without turning on enablePositionalOptions for parent command(s)");
-        }
-        return this;
-      }
-      /**
-        * 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");
-        }
-        this._storeOptionsAsProperties = !!storeAsProperties;
-        return this;
-      }
-      /**
-       * Retrieve option value.
-       *
-       * @param {string} key
-       * @return {Object} value
-       */
-      getOptionValue(key) {
-        if (this._storeOptionsAsProperties) {
-          return this[key];
-        }
-        return this._optionValues[key];
-      }
-      /**
-       * Store option value.
-       *
-       * @param {string} key
-       * @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
-        */
-      setOptionValueWithSource(key, value, source) {
-        if (this._storeOptionsAsProperties) {
-          this[key] = value;
-        } else {
-          this._optionValues[key] = value;
-        }
-        this._optionValueSources[key] = source;
-        return this;
-      }
-      /**
-        * 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}
-        */
-      getOptionValueSourceWithGlobals(key) {
-        let source;
-        this._getCommandAndAncestors().forEach((cmd) => {
-          if (cmd.getOptionValueSource(key) !== void 0) {
-            source = cmd.getOptionValueSource(key);
-          }
-        });
-        return source;
-      }
-      /**
-       * Get user arguments from implied or explicit arguments.
-       * Side-effects: set _scriptPath if args included script. Used for default program name, and subcommand searches.
-       *
-       * @api private
-       */
-      _prepareUserArgs(argv, parseOptions) {
-        if (argv !== void 0 && !Array.isArray(argv)) {
-          throw new Error("first parameter to parse must be array or undefined");
-        }
-        parseOptions = parseOptions || {};
-        if (argv === void 0) {
-          argv = process4.argv;
-          if (process4.versions && process4.versions.electron) {
-            parseOptions.from = "electron";
-          }
-        }
-        this.rawArgs = argv.slice();
-        let userArgs;
-        switch (parseOptions.from) {
-          case void 0:
-          case "node":
-            this._scriptPath = argv[1];
-            userArgs = argv.slice(2);
-            break;
-          case "electron":
-            if (process4.defaultApp) {
-              this._scriptPath = argv[1];
-              userArgs = argv.slice(2);
-            } else {
-              userArgs = argv.slice(1);
-            }
-            break;
-          case "user":
-            userArgs = argv.slice(0);
-            break;
-          default:
-            throw new Error(`unexpected parse option { from: '${parseOptions.from}' }`);
-        }
-        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.
-       *
-       * @example
-       * program.parse(process.argv);
-       * program.parse(); // implicitly use process.argv and auto-detect node vs electron conventions
-       * 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 {string} [parseOptions.from] - where the args are from: 'node', 'user', 'electron'
-       * @return {Command} `this` command for chaining
-       */
-      parse(argv, parseOptions) {
-        const userArgs = this._prepareUserArgs(argv, parseOptions);
-        this._parseCommand([], userArgs);
-        return this;
-      }
-      /**
-       * 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.
-       *
-       * 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.
-       *
-       * @example
-       * await program.parseAsync(process.argv);
-       * await program.parseAsync(); // implicitly use process.argv and auto-detect node vs electron conventions
-       * await program.parseAsync(my-args, { from: 'user' }); // just user supplied arguments, nothing special about argv[0]
-       *
-       * @param {string[]} [argv]
-       * @param {Object} [parseOptions]
-       * @param {string} parseOptions.from - where the args are from: 'node', 'user', 'electron'
-       * @return {Promise}
-       */
-      async parseAsync(argv, parseOptions) {
-        const userArgs = this._prepareUserArgs(argv, parseOptions);
-        await this._parseCommand([], userArgs);
-        return this;
-      }
-      /**
-       * Execute a sub-command executable.
-       *
-       * @api private
-       */
-      _executeSubCommand(subcommand, args) {
-        args = args.slice();
-        let launchWithNode = false;
-        const sourceExt = [".js", ".ts", ".tsx", ".mjs", ".cjs"];
-        function findFile(baseDir, baseName) {
-          const localBin = path.resolve(baseDir, baseName);
-          if (fs.existsSync(localBin)) return localBin;
-          if (sourceExt.includes(path.extname(baseName))) return void 0;
-          const foundExt = sourceExt.find((ext) => fs.existsSync(`${localBin}${ext}`));
-          if (foundExt) return `${localBin}${foundExt}`;
-          return void 0;
-        }
-        this._checkForMissingMandatoryOptions();
-        this._checkForConflictingOptions();
-        let executableFile = subcommand._executableFile || `${this._name}-${subcommand._name}`;
-        let executableDir = this._executableDir || "";
-        if (this._scriptPath) {
-          let resolvedScriptPath;
-          try {
-            resolvedScriptPath = fs.realpathSync(this._scriptPath);
-          } catch (err) {
-            resolvedScriptPath = this._scriptPath;
-          }
-          executableDir = path.resolve(path.dirname(resolvedScriptPath), executableDir);
-        }
-        if (executableDir) {
-          let localFile = findFile(executableDir, executableFile);
-          if (!localFile && !subcommand._executableFile && this._scriptPath) {
-            const legacyName = path.basename(this._scriptPath, path.extname(this._scriptPath));
-            if (legacyName !== this._name) {
-              localFile = findFile(executableDir, `${legacyName}-${subcommand._name}`);
-            }
-          }
-          executableFile = localFile || executableFile;
-        }
-        launchWithNode = sourceExt.includes(path.extname(executableFile));
-        let proc;
-        if (process4.platform !== "win32") {
-          if (launchWithNode) {
-            args.unshift(executableFile);
-            args = incrementNodeInspectorPort(process4.execArgv).concat(args);
-            proc = childProcess.spawn(process4.argv[0], args, { stdio: "inherit" });
-          } else {
-            proc = childProcess.spawn(executableFile, args, { stdio: "inherit" });
-          }
-        } else {
-          args.unshift(executableFile);
-          args = incrementNodeInspectorPort(process4.execArgv).concat(args);
-          proc = childProcess.spawn(process4.execPath, args, { stdio: "inherit" });
-        }
-        if (!proc.killed) {
-          const signals = ["SIGUSR1", "SIGUSR2", "SIGTERM", "SIGINT", "SIGHUP"];
-          signals.forEach((signal) => {
-            process4.on(signal, () => {
-              if (proc.killed === false && proc.exitCode === null) {
-                proc.kill(signal);
-              }
-            });
-          });
-        }
-        const exitCallback = this._exitCallback;
-        if (!exitCallback) {
-          proc.on("close", process4.exit.bind(process4));
-        } else {
-          proc.on("close", () => {
-            exitCallback(new CommanderError2(process4.exitCode || 0, "commander.executeSubCommandAsync", "(close)"));
-          });
-        }
-        proc.on("error", (err) => {
-          if (err.code === "ENOENT") {
-            const executableDirMessage = executableDir ? `searched for local subcommand relative to directory '${executableDir}'` : "no directory for search for local subcommand, use .executableDir() to supply a custom directory";
-            const executableMissing = `'${executableFile}' does not exist
- - if '${subcommand._name}' is not meant to be an executable command, remove description parameter from '.command()' and use '.description()' instead
- - if the default executable name is not suitable, use the executableFile option to supply a custom name or path
- - ${executableDirMessage}`;
-            throw new Error(executableMissing);
-          } else if (err.code === "EACCES") {
-            throw new Error(`'${executableFile}' not executable`);
-          }
-          if (!exitCallback) {
-            process4.exit(1);
-          } else {
-            const wrappedError = new CommanderError2(1, "commander.executeSubCommandAsync", "(error)");
-            wrappedError.nestedError = err;
-            exitCallback(wrappedError);
-          }
-        });
-        this.runningCommand = proc;
-      }
-      /**
-       * @api private
-       */
-      _dispatchSubcommand(commandName, operands, unknown3) {
-        const subCommand = this._findCommand(commandName);
-        if (!subCommand) this.help({ error: true });
-        let promiseChain;
-        promiseChain = this._chainOrCallSubCommandHook(promiseChain, subCommand, "preSubcommand");
-        promiseChain = this._chainOrCall(promiseChain, () => {
-          if (subCommand._executableHandler) {
-            this._executeSubCommand(subCommand, operands.concat(unknown3));
-          } else {
-            return subCommand._parseCommand(operands, unknown3);
-          }
-        });
-        return promiseChain;
-      }
-      /**
-       * Invoke help directly if possible, or dispatch if necessary.
-       * e.g. help foo
-       *
-       * @api private
-       */
-      _dispatchHelpCommand(subcommandName) {
-        if (!subcommandName) {
-          this.help();
-        }
-        const subCommand = this._findCommand(subcommandName);
-        if (subCommand && !subCommand._executableHandler) {
-          subCommand.help();
-        }
-        return this._dispatchSubcommand(subcommandName, [], [
-          this._helpLongFlag || this._helpShortFlag
-        ]);
-      }
-      /**
-       * Check this.args against expected this.registeredArguments.
-       *
-       * @api private
-       */
-      _checkNumberOfArguments() {
-        this.registeredArguments.forEach((arg, i) => {
-          if (arg.required && this.args[i] == null) {
-            this.missingArgument(arg.name());
-          }
-        });
-        if (this.registeredArguments.length > 0 && this.registeredArguments[this.registeredArguments.length - 1].variadic) {
-          return;
-        }
-        if (this.args.length > this.registeredArguments.length) {
-          this._excessArguments(this.args);
-        }
-      }
-      /**
-       * Process this.args using this.registeredArguments and save as this.processedArgs!
-       *
-       * @api private
-       */
-      _processArguments() {
-        const myParseArg = (argument, value, previous) => {
-          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);
-          }
-          return parsedValue;
-        };
-        this._checkNumberOfArguments();
-        const processedArgs = [];
-        this.registeredArguments.forEach((declaredArg, index) => {
-          let value = declaredArg.defaultValue;
-          if (declaredArg.variadic) {
-            if (index < this.args.length) {
-              value = this.args.slice(index);
-              if (declaredArg.parseArg) {
-                value = value.reduce((processed, v) => {
-                  return myParseArg(declaredArg, v, processed);
-                }, declaredArg.defaultValue);
-              }
-            } else if (value === void 0) {
-              value = [];
-            }
-          } else if (index < this.args.length) {
-            value = this.args[index];
-            if (declaredArg.parseArg) {
-              value = myParseArg(declaredArg, value, declaredArg.defaultValue);
-            }
-          }
-          processedArgs[index] = value;
-        });
-        this.processedArgs = processedArgs;
-      }
-      /**
-       * Once we have a promise we chain, but call synchronously until then.
-       *
-       * @param {Promise|undefined} promise
-       * @param {Function} fn
-       * @return {Promise|undefined}
-       * @api private
-       */
-      _chainOrCall(promise2, fn) {
-        if (promise2 && promise2.then && typeof promise2.then === "function") {
-          return promise2.then(() => fn());
-        }
-        return fn();
-      }
-      /**
-       *
-       * @param {Promise|undefined} promise
-       * @param {string} event
-       * @return {Promise|undefined}
-       * @api private
-       */
-      _chainOrCallHooks(promise2, event) {
-        let result = promise2;
-        const hooks = [];
-        this._getCommandAndAncestors().reverse().filter((cmd) => cmd._lifeCycleHooks[event] !== void 0).forEach((hookedCommand) => {
-          hookedCommand._lifeCycleHooks[event].forEach((callback) => {
-            hooks.push({ hookedCommand, callback });
-          });
-        });
-        if (event === "postAction") {
-          hooks.reverse();
-        }
-        hooks.forEach((hookDetail) => {
-          result = this._chainOrCall(result, () => {
-            return hookDetail.callback(hookDetail.hookedCommand, this);
-          });
-        });
-        return result;
-      }
-      /**
-       *
-       * @param {Promise|undefined} promise
-       * @param {Command} subCommand
-       * @param {string} event
-       * @return {Promise|undefined}
-       * @api private
-       */
-      _chainOrCallSubCommandHook(promise2, subCommand, event) {
-        let result = promise2;
-        if (this._lifeCycleHooks[event] !== void 0) {
-          this._lifeCycleHooks[event].forEach((hook) => {
-            result = this._chainOrCall(result, () => {
-              return hook(this, subCommand);
-            });
-          });
-        }
-        return result;
-      }
-      /**
-       * Process arguments in context of this command.
-       * Returns action result, in case it is a promise.
-       *
-       * @api private
-       */
-      _parseCommand(operands, unknown3) {
-        const parsed = this.parseOptions(unknown3);
-        this._parseOptionsEnv();
-        this._parseOptionsImplied();
-        operands = operands.concat(parsed.operands);
-        unknown3 = parsed.unknown;
-        this.args = operands.concat(unknown3);
-        if (operands && this._findCommand(operands[0])) {
-          return this._dispatchSubcommand(operands[0], operands.slice(1), unknown3);
-        }
-        if (this._hasImplicitHelpCommand() && operands[0] === this._helpCommandName) {
-          return this._dispatchHelpCommand(operands[1]);
-        }
-        if (this._defaultCommandName) {
-          outputHelpIfRequested(this, unknown3);
-          return this._dispatchSubcommand(this._defaultCommandName, operands, unknown3);
-        }
-        if (this.commands.length && this.args.length === 0 && !this._actionHandler && !this._defaultCommandName) {
-          this.help({ error: true });
-        }
-        outputHelpIfRequested(this, parsed.unknown);
-        this._checkForMissingMandatoryOptions();
-        this._checkForConflictingOptions();
-        const checkForUnknownOptions = () => {
-          if (parsed.unknown.length > 0) {
-            this.unknownOption(parsed.unknown[0]);
-          }
-        };
-        const commandEvent = `command:${this.name()}`;
-        if (this._actionHandler) {
-          checkForUnknownOptions();
-          this._processArguments();
-          let promiseChain;
-          promiseChain = this._chainOrCallHooks(promiseChain, "preAction");
-          promiseChain = this._chainOrCall(promiseChain, () => this._actionHandler(this.processedArgs));
-          if (this.parent) {
-            promiseChain = this._chainOrCall(promiseChain, () => {
-              this.parent.emit(commandEvent, operands, unknown3);
-            });
-          }
-          promiseChain = this._chainOrCallHooks(promiseChain, "postAction");
-          return promiseChain;
-        }
-        if (this.parent && this.parent.listenerCount(commandEvent)) {
-          checkForUnknownOptions();
-          this._processArguments();
-          this.parent.emit(commandEvent, operands, unknown3);
-        } else if (operands.length) {
-          if (this._findCommand("*")) {
-            return this._dispatchSubcommand("*", operands, unknown3);
-          }
-          if (this.listenerCount("command:*")) {
-            this.emit("command:*", operands, unknown3);
-          } else if (this.commands.length) {
-            this.unknownCommand();
-          } else {
-            checkForUnknownOptions();
-            this._processArguments();
-          }
-        } else if (this.commands.length) {
-          checkForUnknownOptions();
-          this.help({ error: true });
-        } else {
-          checkForUnknownOptions();
-          this._processArguments();
-        }
-      }
-      /**
-       * Find matching command.
-       *
-       * @api private
-       */
-      _findCommand(name) {
-        if (!name) return void 0;
-        return this.commands.find((cmd) => cmd._name === name || cmd._aliases.includes(name));
-      }
-      /**
-       * Return an option matching `arg` if any.
-       *
-       * @param {string} arg
-       * @return {Option}
-       * @api private
-       */
-      _findOption(arg) {
-        return this.options.find((option) => option.is(arg));
-      }
-      /**
-       * Display an error message if a mandatory option does not have a value.
-       * Called after checking for help flags in leaf subcommand.
-       *
-       * @api private
-       */
-      _checkForMissingMandatoryOptions() {
-        this._getCommandAndAncestors().forEach((cmd) => {
-          cmd.options.forEach((anOption) => {
-            if (anOption.mandatory && cmd.getOptionValue(anOption.attributeName()) === void 0) {
-              cmd.missingMandatoryOptionValue(anOption);
-            }
-          });
-        });
-      }
-      /**
-       * Display an error message if conflicting options are used together in this.
-       *
-       * @api 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 optionsWithConflicting = definedNonDefaultOptions.filter(
-          (option) => option.conflictsWith.length > 0
-        );
-        optionsWithConflicting.forEach((option) => {
-          const conflictingAndDefined = definedNonDefaultOptions.find(
-            (defined) => option.conflictsWith.includes(defined.attributeName())
-          );
-          if (conflictingAndDefined) {
-            this._conflictingOption(option, conflictingAndDefined);
-          }
-        });
-      }
-      /**
-       * Display an error message if conflicting options are used together.
-       * Called after checking for help flags in leaf subcommand.
-       *
-       * @api private
-       */
-      _checkForConflictingOptions() {
-        this._getCommandAndAncestors().forEach((cmd) => {
-          cmd._checkForConflictingLocalOptions();
-        });
-      }
-      /**
-       * Parse options from `argv` removing known options,
-       * and return argv split into operands and unknown arguments.
-       *
-       * Examples:
-       *
-       *     argv => operands, unknown
-       *     --known kkk op => [op], []
-       *     op --known kkk => [op], []
-       *     sub --unknown uuu op => [sub], [--unknown uuu op]
-       *     sub -- --unknown uuu op => [sub --unknown uuu op], []
-       *
-       * @param {String[]} argv
-       * @return {{operands: String[], unknown: String[]}}
-       */
-      parseOptions(argv) {
-        const operands = [];
-        const unknown3 = [];
-        let dest = operands;
-        const args = argv.slice();
-        function maybeOption(arg) {
-          return arg.length > 1 && arg[0] === "-";
-        }
-        let activeVariadicOption = null;
-        while (args.length) {
-          const arg = args.shift();
-          if (arg === "--") {
-            if (dest === unknown3) dest.push(arg);
-            dest.push(...args);
-            break;
-          }
-          if (activeVariadicOption && !maybeOption(arg)) {
-            this.emit(`option:${activeVariadicOption.name()}`, arg);
-            continue;
-          }
-          activeVariadicOption = null;
-          if (maybeOption(arg)) {
-            const option = this._findOption(arg);
-            if (option) {
-              if (option.required) {
-                const value = args.shift();
-                if (value === void 0) this.optionMissingArgument(option);
-                this.emit(`option:${option.name()}`, value);
-              } else if (option.optional) {
-                let value = null;
-                if (args.length > 0 && !maybeOption(args[0])) {
-                  value = args.shift();
-                }
-                this.emit(`option:${option.name()}`, value);
-              } else {
-                this.emit(`option:${option.name()}`);
-              }
-              activeVariadicOption = option.variadic ? option : null;
-              continue;
-            }
-          }
-          if (arg.length > 2 && arg[0] === "-" && arg[1] !== "-") {
-            const option = this._findOption(`-${arg[1]}`);
-            if (option) {
-              if (option.required || option.optional && this._combineFlagAndOptionalValue) {
-                this.emit(`option:${option.name()}`, arg.slice(2));
-              } else {
-                this.emit(`option:${option.name()}`);
-                args.unshift(`-${arg.slice(2)}`);
-              }
-              continue;
-            }
-          }
-          if (/^--[^=]+=/.test(arg)) {
-            const index = arg.indexOf("=");
-            const option = this._findOption(arg.slice(0, index));
-            if (option && (option.required || option.optional)) {
-              this.emit(`option:${option.name()}`, arg.slice(index + 1));
-              continue;
-            }
-          }
-          if (maybeOption(arg)) {
-            dest = unknown3;
-          }
-          if ((this._enablePositionalOptions || this._passThroughOptions) && operands.length === 0 && unknown3.length === 0) {
-            if (this._findCommand(arg)) {
-              operands.push(arg);
-              if (args.length > 0) unknown3.push(...args);
-              break;
-            } else if (arg === this._helpCommandName && this._hasImplicitHelpCommand()) {
-              operands.push(arg);
-              if (args.length > 0) operands.push(...args);
-              break;
-            } else if (this._defaultCommandName) {
-              unknown3.push(arg);
-              if (args.length > 0) unknown3.push(...args);
-              break;
-            }
-          }
-          if (this._passThroughOptions) {
-            dest.push(arg);
-            if (args.length > 0) dest.push(...args);
-            break;
-          }
-          dest.push(arg);
-        }
-        return { operands, unknown: unknown3 };
-      }
-      /**
-       * Return an object containing local option values as key-value pairs.
-       *
-       * @return {Object}
-       */
-      opts() {
-        if (this._storeOptionsAsProperties) {
-          const result = {};
-          const len = this.options.length;
-          for (let i = 0; i < len; i++) {
-            const key = this.options[i].attributeName();
-            result[key] = key === this._versionOptionName ? this._version : this[key];
-          }
-          return result;
-        }
-        return this._optionValues;
-      }
-      /**
-       * Return an object containing merged local and global option values as key-value pairs.
-       *
-       * @return {Object}
-       */
-      optsWithGlobals() {
-        return this._getCommandAndAncestors().reduce(
-          (combinedOptions, cmd) => Object.assign(combinedOptions, cmd.opts()),
-          {}
-        );
-      }
-      /**
-       * Display error message and exit (or call exitOverride).
-       *
-       * @param {string} message
-       * @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);
-        if (typeof this._showHelpAfterError === "string") {
-          this._outputConfiguration.writeErr(`${this._showHelpAfterError}
-`);
-        } else if (this._showHelpAfterError) {
-          this._outputConfiguration.writeErr("\n");
-          this.outputHelp({ error: true });
-        }
-        const config3 = errorOptions || {};
-        const exitCode2 = config3.exitCode || 1;
-        const code = config3.code || "commander.error";
-        this._exit(exitCode2, code, message);
-      }
-      /**
-       * Apply any option related environment variables, if option does
-       * not have a value from cli or client code.
-       *
-       * @api private
-       */
-      _parseOptionsEnv() {
-        this.options.forEach((option) => {
-          if (option.envVar && option.envVar in process4.env) {
-            const optionKey = option.attributeName();
-            if (this.getOptionValue(optionKey) === void 0 || ["default", "config", "env"].includes(this.getOptionValueSource(optionKey))) {
-              if (option.required || option.optional) {
-                this.emit(`optionEnv:${option.name()}`, process4.env[option.envVar]);
-              } else {
-                this.emit(`optionEnv:${option.name()}`);
-              }
-            }
-          }
-        });
-      }
-      /**
-       * Apply any implied option values, if option is undefined or default value.
-       *
-       * @api private
-       */
-      _parseOptionsImplied() {
-        const dualHelper = new DualOptions(this.options);
-        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) => {
-          Object.keys(option.implied).filter((impliedKey) => !hasCustomOptionValue(impliedKey)).forEach((impliedKey) => {
-            this.setOptionValueWithSource(impliedKey, option.implied[impliedKey], "implied");
-          });
-        });
-      }
-      /**
-       * Argument `name` is missing.
-       *
-       * @param {string} name
-       * @api private
-       */
-      missingArgument(name) {
-        const message = `error: missing required argument '${name}'`;
-        this.error(message, { code: "commander.missingArgument" });
-      }
-      /**
-       * `Option` is missing an argument.
-       *
-       * @param {Option} option
-       * @api private
-       */
-      optionMissingArgument(option) {
-        const message = `error: option '${option.flags}' argument missing`;
-        this.error(message, { code: "commander.optionMissingArgument" });
-      }
-      /**
-       * `Option` does not have a value, and is a mandatory option.
-       *
-       * @param {Option} option
-       * @api private
-       */
-      missingMandatoryOptionValue(option) {
-        const message = `error: required option '${option.flags}' not specified`;
-        this.error(message, { code: "commander.missingMandatoryOptionValue" });
-      }
-      /**
-       * `Option` conflicts with another option.
-       *
-       * @param {Option} option
-       * @param {Option} conflictingOption
-       * @api private
-       */
-      _conflictingOption(option, conflictingOption) {
-        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());
-          if (negativeOption && (negativeOption.presetArg === void 0 && optionValue === false || negativeOption.presetArg !== void 0 && optionValue === negativeOption.presetArg)) {
-            return negativeOption;
-          }
-          return positiveOption || option2;
-        };
-        const getErrorMessage = (option2) => {
-          const bestOption = findBestOptionFromValue(option2);
-          const optionKey = bestOption.attributeName();
-          const source = this.getOptionValueSource(optionKey);
-          if (source === "env") {
-            return `environment variable '${bestOption.envVar}'`;
-          }
-          return `option '${bestOption.flags}'`;
-        };
-        const message = `error: ${getErrorMessage(option)} cannot be used with ${getErrorMessage(conflictingOption)}`;
-        this.error(message, { code: "commander.conflictingOption" });
-      }
-      /**
-       * Unknown option `flag`.
-       *
-       * @param {string} flag
-       * @api private
-       */
-      unknownOption(flag) {
-        if (this._allowUnknownOption) return;
-        let suggestion = "";
-        if (flag.startsWith("--") && this._showSuggestionAfterError) {
-          let candidateFlags = [];
-          let command = this;
-          do {
-            const moreFlags = command.createHelp().visibleOptions(command).filter((option) => option.long).map((option) => option.long);
-            candidateFlags = candidateFlags.concat(moreFlags);
-            command = command.parent;
-          } while (command && !command._enablePositionalOptions);
-          suggestion = suggestSimilar(flag, candidateFlags);
-        }
-        const message = `error: unknown option '${flag}'${suggestion}`;
-        this.error(message, { code: "commander.unknownOption" });
-      }
-      /**
-       * Excess arguments, more than expected.
-       *
-       * @param {string[]} receivedArgs
-       * @api private
-       */
-      _excessArguments(receivedArgs) {
-        if (this._allowExcessArguments) return;
-        const expected = this.registeredArguments.length;
-        const s = expected === 1 ? "" : "s";
-        const forSubcommand = this.parent ? ` for '${this.name()}'` : "";
-        const message = `error: too many arguments${forSubcommand}. Expected ${expected} argument${s} but got ${receivedArgs.length}.`;
-        this.error(message, { code: "commander.excessArguments" });
-      }
-      /**
-       * Unknown command.
-       *
-       * @api private
-       */
-      unknownCommand() {
-        const unknownName = this.args[0];
-        let suggestion = "";
-        if (this._showSuggestionAfterError) {
-          const candidateNames = [];
-          this.createHelp().visibleCommands(this).forEach((command) => {
-            candidateNames.push(command.name());
-            if (command.alias()) candidateNames.push(command.alias());
-          });
-          suggestion = suggestSimilar(unknownName, candidateNames);
-        }
-        const message = `error: unknown command '${unknownName}'${suggestion}`;
-        this.error(message, { code: "commander.unknownCommand" });
-      }
-      /**
-       * Get or set the program version.
-       *
-       * This method auto-registers the "-V, --version" option which will print the version number.
-       *
-       * You can optionally supply the flags and description to override the defaults.
-       *
-       * @param {string} [str]
-       * @param {string} [flags]
-       * @param {string} [description]
-       * @return {this | string | undefined} `this` command for chaining, or version string if no arguments
-       */
-      version(str, flags, description) {
-        if (str === void 0) return this._version;
-        this._version = str;
-        flags = flags || "-V, --version";
-        description = description || "output the version number";
-        const versionOption = this.createOption(flags, description);
-        this._versionOptionName = versionOption.attributeName();
-        this.options.push(versionOption);
-        this.on("option:" + versionOption.name(), () => {
-          this._outputConfiguration.writeOut(`${str}
-`);
-          this._exit(0, "commander.version", str);
-        });
-        return this;
-      }
-      /**
-       * Set the description.
-       *
-       * @param {string} [str]
-       * @param {Object} [argsDescription]
-       * @return {string|Command}
-       */
-      description(str, argsDescription) {
-        if (str === void 0 && argsDescription === void 0) return this._description;
-        this._description = str;
-        if (argsDescription) {
-          this._argsDescription = argsDescription;
-        }
-        return this;
-      }
-      /**
-       * Set the summary. Used when listed as subcommand of parent.
-       *
-       * @param {string} [str]
-       * @return {string|Command}
-       */
-      summary(str) {
-        if (str === void 0) return this._summary;
-        this._summary = str;
-        return this;
-      }
-      /**
-       * Set an alias for the command.
-       *
-       * You may call more than once to add multiple aliases. Only the first alias is shown in the auto-generated help.
-       *
-       * @param {string} [alias]
-       * @return {string|Command}
-       */
-      alias(alias) {
-        if (alias === void 0) return this._aliases[0];
-        let command = this;
-        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");
-        command._aliases.push(alias);
-        return this;
-      }
-      /**
-       * Set aliases for the command.
-       *
-       * Only the first alias is shown in the auto-generated help.
-       *
-       * @param {string[]} [aliases]
-       * @return {string[]|Command}
-       */
-      aliases(aliases) {
-        if (aliases === void 0) return this._aliases;
-        aliases.forEach((alias) => this.alias(alias));
-        return this;
-      }
-      /**
-       * Set / get the command usage `str`.
-       *
-       * @param {string} [str]
-       * @return {String|Command}
-       */
-      usage(str) {
-        if (str === void 0) {
-          if (this._usage) return this._usage;
-          const args = this.registeredArguments.map((arg) => {
-            return humanReadableArgName(arg);
-          });
-          return [].concat(
-            this.options.length || this._hasHelpOption ? "[options]" : [],
-            this.commands.length ? "[command]" : [],
-            this.registeredArguments.length ? args : []
-          ).join(" ");
-        }
-        this._usage = str;
-        return this;
-      }
-      /**
-       * Get or set the name of the command.
-       *
-       * @param {string} [str]
-       * @return {string|Command}
-       */
-      name(str) {
-        if (str === void 0) return this._name;
-        this._name = str;
-        return this;
-      }
-      /**
-       * Set the name of the command from script filename, such as process.argv[1],
-       * or require.main.filename, or __filename.
-       *
-       * (Used internally and public although not documented in README.)
-       *
-       * @example
-       * program.nameFromFilename(require.main.filename);
-       *
-       * @param {string} filename
-       * @return {Command}
-       */
-      nameFromFilename(filename) {
-        this._name = path.basename(filename, path.extname(filename));
-        return this;
-      }
-      /**
-       * Get or set the directory for searching for executable subcommands of this command.
-       *
-       * @example
-       * program.executableDir(__dirname);
-       * // or
-       * program.executableDir('subcommands');
-       *
-       * @param {string} [path]
-       * @return {string|null|Command}
-       */
-      executableDir(path2) {
-        if (path2 === void 0) return this._executableDir;
-        this._executableDir = path2;
-        return this;
-      }
-      /**
-       * Return program help documentation.
-       *
-       * @param {{ error: boolean }} [contextOptions] - pass {error:true} to wrap for stderr instead of stdout
-       * @return {string}
-       */
-      helpInformation(contextOptions) {
-        const helper = this.createHelp();
-        if (helper.helpWidth === void 0) {
-          helper.helpWidth = contextOptions && contextOptions.error ? this._outputConfiguration.getErrHelpWidth() : this._outputConfiguration.getOutHelpWidth();
-        }
-        return helper.formatHelp(this, helper);
-      }
-      /**
-       * @api private
-       */
-      _getHelpContext(contextOptions) {
-        contextOptions = contextOptions || {};
-        const context = { error: !!contextOptions.error };
-        let write;
-        if (context.error) {
-          write = (arg) => this._outputConfiguration.writeErr(arg);
-        } else {
-          write = (arg) => this._outputConfiguration.writeOut(arg);
-        }
-        context.write = contextOptions.write || write;
-        context.command = this;
-        return context;
-      }
-      /**
-       * Output help information for this command.
-       *
-       * Outputs built-in help, and custom text added using `.addHelpText()`.
-       *
-       * @param {{ error: boolean } | Function} [contextOptions] - pass {error:true} to write to stderr instead of stdout
-       */
-      outputHelp(contextOptions) {
-        let deprecatedCallback;
-        if (typeof contextOptions === "function") {
-          deprecatedCallback = contextOptions;
-          contextOptions = void 0;
-        }
-        const context = this._getHelpContext(contextOptions);
-        this._getCommandAndAncestors().reverse().forEach((command) => command.emit("beforeAllHelp", context));
-        this.emit("beforeHelp", context);
-        let helpInformation = this.helpInformation(context);
-        if (deprecatedCallback) {
-          helpInformation = deprecatedCallback(helpInformation);
-          if (typeof helpInformation !== "string" && !Buffer.isBuffer(helpInformation)) {
-            throw new Error("outputHelp callback must return a string or a Buffer");
-          }
-        }
-        context.write(helpInformation);
-        if (this._helpLongFlag) {
-          this.emit(this._helpLongFlag);
-        }
-        this.emit("afterHelp", context);
-        this._getCommandAndAncestors().forEach((command) => command.emit("afterAllHelp", context));
-      }
-      /**
-       * You can pass in flags and a description to override the help
-       * flags and help description for your command. Pass in false to
-       * disable the built-in help option.
-       *
-       * @param {string | boolean} [flags]
-       * @param {string} [description]
-       * @return {Command} `this` command for chaining
-       */
-      helpOption(flags, description) {
-        if (typeof flags === "boolean") {
-          this._hasHelpOption = flags;
-          return this;
-        }
-        this._helpFlags = flags || this._helpFlags;
-        this._helpDescription = description || this._helpDescription;
-        const helpFlags = splitOptionFlags(this._helpFlags);
-        this._helpShortFlag = helpFlags.shortFlag;
-        this._helpLongFlag = helpFlags.longFlag;
-        return this;
-      }
-      /**
-       * Output help information and exit.
-       *
-       * Outputs built-in help, and custom text added using `.addHelpText()`.
-       *
-       * @param {{ error: boolean }} [contextOptions] - pass {error:true} to write to stderr instead of stdout
-       */
-      help(contextOptions) {
-        this.outputHelp(contextOptions);
-        let exitCode2 = process4.exitCode || 0;
-        if (exitCode2 === 0 && contextOptions && typeof contextOptions !== "function" && contextOptions.error) {
-          exitCode2 = 1;
-        }
-        this._exit(exitCode2, "commander.help", "(outputHelp)");
-      }
-      /**
-       * Add additional text to be displayed with the built-in help.
-       *
-       * Position is 'before' or 'after' to affect just this command,
-       * and 'beforeAll' or 'afterAll' to affect this command and all its subcommands.
-       *
-       * @param {string} position - before or after built-in help
-       * @param {string | Function} text - string to add, or a function returning a string
-       * @return {Command} `this` command for chaining
-       */
-      addHelpText(position, text) {
-        const allowedValues = ["beforeAll", "before", "after", "afterAll"];
-        if (!allowedValues.includes(position)) {
-          throw new Error(`Unexpected value for position to addHelpText.
-Expecting one of '${allowedValues.join("', '")}'`);
-        }
-        const helpEvent = `${position}Help`;
-        this.on(helpEvent, (context) => {
-          let helpStr;
-          if (typeof text === "function") {
-            helpStr = text({ error: context.error, command: context.command });
-          } else {
-            helpStr = text;
-          }
-          if (helpStr) {
-            context.write(`${helpStr}
-`);
-          }
-        });
-        return this;
-      }
-    };
-    function outputHelpIfRequested(cmd, args) {
-      const helpOption = cmd._hasHelpOption && args.find((arg) => arg === cmd._helpLongFlag || arg === cmd._helpShortFlag);
-      if (helpOption) {
-        cmd.outputHelp();
-        cmd._exit(0, "commander.helpDisplayed", "(outputHelp)");
-      }
-    }
-    function incrementNodeInspectorPort(args) {
-      return args.map((arg) => {
-        if (!arg.startsWith("--inspect")) {
-          return arg;
-        }
-        let debugOption;
-        let debugHost = "127.0.0.1";
-        let debugPort = "9229";
-        let match;
-        if ((match = arg.match(/^(--inspect(-brk)?)$/)) !== null) {
-          debugOption = match[1];
-        } else if ((match = arg.match(/^(--inspect(-brk|-port)?)=([^:]+)$/)) !== null) {
-          debugOption = match[1];
-          if (/^\d+$/.test(match[3])) {
-            debugPort = match[3];
-          } else {
-            debugHost = match[3];
-          }
-        } else if ((match = arg.match(/^(--inspect(-brk|-port)?)=([^:]+):(\d+)$/)) !== null) {
-          debugOption = match[1];
-          debugHost = match[3];
-          debugPort = match[4];
-        }
-        if (debugOption && debugPort !== "0") {
-          return `${debugOption}=${debugHost}:${parseInt(debugPort) + 1}`;
-        }
-        return arg;
-      });
-    }
-    exports.Command = Command2;
-  }
-});
-
-// ../../node_modules/.pnpm/commander@11.1.0/node_modules/commander/index.js
-var require_commander = __commonJS({
-  "../../node_modules/.pnpm/commander@11.1.0/node_modules/commander/index.js"(exports, module) {
-    "use strict";
-    var { Argument: Argument2 } = require_argument();
-    var { Command: Command2 } = require_command();
-    var { CommanderError: CommanderError2, InvalidArgumentError: InvalidArgumentError2 } = require_error();
-    var { Help: Help2 } = require_help();
-    var { Option: Option2 } = require_option();
-    exports = module.exports = new Command2();
-    exports.program = exports;
-    exports.Command = Command2;
-    exports.Option = Option2;
-    exports.Argument = Argument2;
-    exports.Help = Help2;
-    exports.CommanderError = CommanderError2;
-    exports.InvalidArgumentError = InvalidArgumentError2;
-    exports.InvalidOptionArgumentError = InvalidArgumentError2;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __commonJS = (cb, mod) => function __require() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+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.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/core/core.js
 // @__NO_SIDE_EFFECTS__
@@ -18098,13 +15347,17 @@ function parseSlideshowRun(payload) {
   assertNoPrivateTemplateFields(payload);
   return parseDataEnvelope(payload, slideshowRunSchema);
 }
-function parseBrandProfile(payload) {
-  return parseDataEnvelope(payload, brandProfileSchema);
+function parseSlideshowRunSummaryList(payload) {
+  assertNoPrivateTemplateFields(payload);
+  return parseDataEnvelope(payload, external_exports.array(slideshowRunSummarySchema));
+}
+function parseBrand(payload) {
+  return parseDataEnvelope(payload, brandSchema);
 }
-function parseBrandProfileList(payload) {
-  return parseDataEnvelope(payload, external_exports.array(brandProfileSchema));
+function parseBrandList(payload) {
+  return parseDataEnvelope(payload, external_exports.array(brandSchema));
 }
-var FORBIDDEN_PUBLIC_KEYS, templatePlatformSchema, canvasPresetSchema, pageRoleSchema, contentFamilySchema, contentArchetypeSchema, densityLevelSchema, visualStyleSchema, imageRoleSchema, slotSummarySchema, selectionMetadataSchema, selectionMetadataDraftSchema, listTemplatesQuerySchema, templateSummarySchema, publicTemplateSlotTypeSchema, publicTemplateSlotSchema, templateDetailSchema, templateSelectionSchema, presentationIntentSchema, renderSlotValueSchema, renderJobRequestSchema, legacyRenderJobRequestSchema, renderJobStatusSchema, renderCaptureHintSchema, renderJobViewSchema, renderPreviewMaterializationSchema, renderSelectionSummarySchema, renderManifestSchema, templateAuthoringCanvasSchema, templateAuthoringProvenanceSchema, templateImageModeSchema, templateImageNodeSchema, authoringImageNodeSchema, authoringIconNodeSchema, templateAuthoringSourceSchema, themeContrastEntrySchema, themePaletteSchema, themeTokensSchema, themeSummarySchema, themeDetailSchema, gradientTextSafeZoneSchema, gradientStopSchema, gradientSummarySchema, gradientDetailSchema, listGradientsQuerySchema, templateSurfaceKindSchema, templateSurfacePreviewSchema, templateImageProviderSchema, templateImageRightsStatusSchema, templateImageProvenanceSchema, importTemplateImageFileSchema, importTemplateImageInputSchema, importTemplateImageBodySchema, createRenderAssetInputSchema, renderAssetReferenceSchema, iconStyleSchema, templateIconLicenseSchema, searchTemplateIconsRequestSchema, templateIconCandidateSchema, getTemplateIconRequestSchema, templateIconProvenanceSchema, templateIconAssetReferenceSchema, templateIconErrorCodeSchema, templateImageReferenceSchema, themeCreateInputSchema, draftThemeInputSchema, createTemplateDraftInputSchema, updateTemplateDraftInputSchema, templateAuthoringDraftSchema, DEFAULT_AUTHORING_STUDIO_BASE_URL, templatePrincipalErrorSchema, slideshowPlatformCaps, slideshowPlatformSchema, slideshowRunStatusSchema, publicSlotValueSchema, contentPackPageSchema, contentPackSchema, slideshowRunPageSchema, brandProfilePreferenceSchema, brandProfileSchema, createBrandProfileInputSchema, updateBrandProfileInputSchema, slideshowRunSchema, createSlideshowRunInputSchema, updateSlideshowRunInputSchema, renderSlideshowRunInputSchema;
+var FORBIDDEN_PUBLIC_KEYS, templatePlatformSchema, canvasPresetSchema, pageRoleSchema, contentFamilySchema, contentArchetypeSchema, densityLevelSchema, visualStyleSchema, imageRoleSchema, slotSummarySchema, selectionMetadataSchema, selectionMetadataDraftSchema, listTemplatesQuerySchema, templateSummarySchema, publicTemplateSlotTypeSchema, publicTemplateSlotSchema, templateDetailSchema, templateSelectionSchema, presentationIntentSchema, renderSlotValueSchema, renderJobRequestSchema, legacyRenderJobRequestSchema, renderJobStatusSchema, renderCaptureHintSchema, renderJobViewSchema, renderPreviewMaterializationSchema, renderSelectionSummarySchema, renderManifestSchema, templateAuthoringCanvasSchema, templateAuthoringProvenanceSchema, templateImageModeSchema, templateImageNodeSchema, authoringImageNodeSchema, authoringIconNodeSchema, templateAuthoringSourceSchema, themeContrastEntrySchema, themePaletteSchema, themeTokensSchema, themeSummarySchema, themeDetailSchema, gradientTextSafeZoneSchema, gradientStopSchema, gradientSummarySchema, gradientDetailSchema, listGradientsQuerySchema, templateSurfaceKindSchema, templateSurfacePreviewSchema, templateImageProviderSchema, templateImageRightsStatusSchema, templateImageProvenanceSchema, importTemplateImageFileSchema, importTemplateImageInputSchema, importTemplateImageBodySchema, createRenderAssetInputSchema, renderAssetReferenceSchema, iconStyleSchema, templateIconLicenseSchema, searchTemplateIconsRequestSchema, templateIconCandidateSchema, getTemplateIconRequestSchema, templateIconProvenanceSchema, templateIconAssetReferenceSchema, templateIconErrorCodeSchema, templateImageReferenceSchema, themeCreateInputSchema, draftThemeInputSchema, createTemplateDraftInputSchema, updateTemplateDraftInputSchema, authoringDraftVariantSchema, templateAuthoringDraftSchema, DEFAULT_AUTHORING_STUDIO_BASE_URL, templatePrincipalErrorSchema, slideshowPlatformCaps, slideshowPlatformSchema, slideshowRunStatusSchema, publicSlotValueSchema, contentPackPageSchema, contentPackSchema, slideshowRunPageSchema, brandProfilePreferenceSchema, brandProfileSchema, createBrandProfileInputSchema, updateBrandProfileInputSchema, brandTypographySchema, brandColorsSchema, brandSchema, createBrandInputSchema, updateBrandInputSchema, slideshowRunSummarySchema, slideshowRunSchema, createSlideshowRunInputSchema, updateSlideshowRunInputSchema, renderSlideshowRunInputSchema, listSlideshowRunsQuerySchema;
 var init_src = __esm({
   "../../packages/template-public-contracts/src/index.ts"() {
     "use strict";
@@ -18234,8 +15487,8 @@ var init_src = __esm({
       notFor: external_exports.array(external_exports.string()).min(1).max(3).optional(),
       selectionHints: external_exports.string().optional(),
       visualStyle: visualStyleSchema.optional(),
-      defaultThemeId: external_exports.string().optional(),
-      compatibleThemeIds: external_exports.array(external_exports.string()).optional(),
+      // ADR-0033: published selection metadata must not bind a Theme.
+      // Runtime appearance comes from Brand themeSnapshot at fill/render.
       locale: external_exports.enum(["zh-CN", "en", "bilingual"]).optional(),
       exampleFilledPreviewUrl: external_exports.string().url().optional(),
       // P2
@@ -18377,7 +15630,11 @@ var init_src = __esm({
     }).strict();
     renderSelectionSummarySchema = external_exports.object({
       templateId: external_exports.string().min(1),
-      themeId: external_exports.string().min(1),
+      /**
+       * Optional audit id for the tokens used (Brand snapshot / preview fallback).
+       * Not a Template→Theme publish binding (ADR-0033).
+       */
+      themeId: external_exports.string().min(1).optional(),
       role: external_exports.string().min(1),
       canvas: external_exports.object({
         width: external_exports.number().int().positive(),
@@ -18746,23 +16003,18 @@ var init_src = __esm({
       tokens: themeTokensSchema
     }).strict();
     draftThemeInputSchema = external_exports.object({
+      /** @deprecated TemplateTheme retired — ignored; use create.tokens or tokens. */
       themeId: external_exports.string().min(1).optional(),
-      /** With themeId: fork a new Theme when tokens differ (never mutate shared themes). */
+      /** Preferred: write these onto LayoutFamily.preview_tokens. */
       tokens: themeTokensSchema.optional(),
       create: themeCreateInputSchema.optional()
     }).strict().refine(
       (value) => {
-        const hasId = Boolean(value.themeId);
         const hasCreate = Boolean(value.create);
-        if (hasId && hasCreate)
-          return false;
-        if (!hasId && !hasCreate)
-          return false;
-        if (value.tokens && !hasId)
-          return false;
-        return true;
+        const hasTokens = Boolean(value.tokens);
+        return hasCreate || hasTokens;
       },
-      { message: "theme must provide themeId (optionally with tokens) or create" }
+      { message: "theme must provide create.tokens or tokens for Family.preview_tokens" }
     );
     createTemplateDraftInputSchema = external_exports.object({
       name: external_exports.string().min(1),
@@ -18782,12 +16034,28 @@ var init_src = __esm({
       theme: draftThemeInputSchema.optional(),
       selectionMetadata: selectionMetadataDraftSchema.optional()
     }).strict();
+    authoringDraftVariantSchema = external_exports.object({
+      pageId: external_exports.string(),
+      familyRole: external_exports.enum(["master", "variant"]),
+      canvasPreset: external_exports.string().nullable().optional(),
+      canvas: external_exports.object({
+        width: external_exports.number(),
+        height: external_exports.number()
+      }),
+      platforms: external_exports.array(external_exports.string())
+    }).strict();
     templateAuthoringDraftSchema = external_exports.object({
       id: external_exports.string(),
       /** Equals draft id — drafts are folded into TemplatePage. */
       templateId: external_exports.string().optional(),
       /** Soft theme preview reference; tokens are not stored on the draft. */
       themeId: external_exports.string().optional(),
+      /** Alias of themeId after Layout Family / Theme unbind. */
+      previewThemeId: external_exports.string().nullable().optional(),
+      familyId: external_exports.string().optional(),
+      familyRole: external_exports.enum(["master", "variant"]).optional(),
+      variants: external_exports.array(authoringDraftVariantSchema).optional(),
+      intendedPlatforms: external_exports.array(external_exports.string()).optional(),
       name: external_exports.string(),
       status: external_exports.enum(["draft", "validated", "published", "archived", "trashed"]),
       revision: external_exports.number().int().positive().optional(),
@@ -18830,10 +16098,13 @@ var init_src = __esm({
     ]);
     slideshowRunStatusSchema = external_exports.enum([
       "draft",
+      "ready",
       "rendering",
       "completed",
       "failed",
-      "expired"
+      "expired",
+      "archived",
+      "trashed"
     ]);
     publicSlotValueSchema = external_exports.union([external_exports.string(), external_exports.number(), external_exports.boolean(), external_exports.null()]);
     contentPackPageSchema = external_exports.object({
@@ -18845,6 +16116,7 @@ var init_src = __esm({
       schemaVersion: external_exports.literal("content-pack.v1"),
       platform: slideshowPlatformSchema,
       title: external_exports.string().optional(),
+      contentSlug: external_exports.string().optional(),
       pages: external_exports.array(contentPackPageSchema).min(1)
     }).strict().superRefine((value, ctx) => {
       const forbidden = JSON.stringify(value).toLowerCase();
@@ -18891,11 +16163,63 @@ var init_src = __esm({
       preference: brandProfilePreferenceSchema.default({})
     }).strict();
     updateBrandProfileInputSchema = createBrandProfileInputSchema.partial().strict();
+    brandTypographySchema = external_exports.object({
+      headingFontId: external_exports.string(),
+      bodyFontId: external_exports.string()
+    }).strict();
+    brandColorsSchema = external_exports.object({
+      canvas: external_exports.string(),
+      surface: external_exports.string(),
+      text: external_exports.string(),
+      textMuted: external_exports.string(),
+      primary: external_exports.string(),
+      accent: external_exports.string()
+    }).strict();
+    brandSchema = external_exports.object({
+      id: external_exports.string(),
+      brandId: external_exports.string().optional(),
+      name: external_exports.string(),
+      displayName: external_exports.string().optional(),
+      handle: external_exports.string().optional(),
+      typography: brandTypographySchema.optional(),
+      colors: brandColorsSchema.partial().optional(),
+      logoAssetId: external_exports.string().nullable().optional(),
+      revision: external_exports.number().int().positive().optional(),
+      status: external_exports.string(),
+      createdAt: external_exports.string().optional(),
+      updatedAt: external_exports.string().optional()
+    }).strict();
+    createBrandInputSchema = external_exports.object({
+      name: external_exports.string().min(1),
+      displayName: external_exports.string().optional(),
+      handle: external_exports.string().optional(),
+      typography: brandTypographySchema.partial().optional(),
+      colors: brandColorsSchema.partial().optional(),
+      logoAssetId: external_exports.string().nullable().optional()
+    }).strict();
+    updateBrandInputSchema = createBrandInputSchema.partial().extend({
+      baseRevision: external_exports.number().int().positive()
+    }).strict();
+    slideshowRunSummarySchema = external_exports.object({
+      id: external_exports.string(),
+      platform: slideshowPlatformSchema,
+      title: external_exports.string().optional(),
+      contentSlug: external_exports.string().optional(),
+      status: slideshowRunStatusSchema,
+      revision: external_exports.number().int().positive(),
+      pageCount: external_exports.number().int().nonnegative(),
+      brandProfileId: external_exports.string().optional(),
+      studioUrl: external_exports.string().url().optional(),
+      lastActivityAt: external_exports.string().optional(),
+      createdAt: external_exports.string(),
+      updatedAt: external_exports.string()
+    }).strict();
     slideshowRunSchema = external_exports.object({
       id: external_exports.string(),
       ownerId: external_exports.string().optional(),
       platform: slideshowPlatformSchema,
       title: external_exports.string().optional(),
+      contentSlug: external_exports.string().optional(),
       status: slideshowRunStatusSchema,
       revision: external_exports.number().int().positive().optional(),
       packSnapshot: contentPackSchema,
@@ -18903,18 +16227,23 @@ var init_src = __esm({
       pages: external_exports.array(slideshowRunPageSchema),
       brandProfileId: external_exports.string().optional(),
       studioUrl: external_exports.string().url().optional(),
+      lastActivityAt: external_exports.string().optional(),
       updatedAt: external_exports.string(),
       createdAt: external_exports.string()
     }).strict();
     createSlideshowRunInputSchema = external_exports.object({
       pack: contentPackSchema,
+      brandId: external_exports.string().optional(),
       brandProfileId: external_exports.string().optional(),
-      themeSnapshot: external_exports.record(external_exports.string(), external_exports.unknown()).optional()
+      themeSnapshot: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
+      contentSlug: external_exports.string().optional()
     }).strict();
     updateSlideshowRunInputSchema = external_exports.object({
       pack: contentPackSchema.optional(),
+      brandId: external_exports.string().optional(),
       brandProfileId: external_exports.string().optional(),
       themeSnapshot: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
+      contentSlug: external_exports.string().optional(),
       baseRevision: external_exports.number().int().positive().optional(),
       pageIndex: external_exports.number().int().nonnegative().optional(),
       slots: external_exports.record(external_exports.string(), publicSlotValueSchema).optional(),
@@ -18926,6 +16255,14 @@ var init_src = __esm({
       outputFormats: external_exports.array(external_exports.literal("png")).length(1).default(["png"]),
       idempotencyKey: external_exports.string().min(1).max(128)
     }).strict();
+    listSlideshowRunsQuerySchema = external_exports.object({
+      q: external_exports.string().optional(),
+      platform: slideshowPlatformSchema.optional(),
+      profileId: external_exports.string().optional(),
+      brandProfileId: external_exports.string().optional(),
+      contentSlug: external_exports.string().optional(),
+      status: slideshowRunStatusSchema.optional()
+    }).strict();
   }
 });
 
@@ -18951,7 +16288,7 @@ function isRetryableStatus(status) {
   return status === 429 || status === 502 || status === 503 || status === 504;
 }
 function sleep(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
+  return new Promise((resolve2) => setTimeout(resolve2, ms));
 }
 var TemplateGatewayError, TemplateGatewayClient;
 var init_client = __esm({
@@ -19127,6 +16464,25 @@ var init_client = __esm({
           this.options.authoringStudioBaseUrl
         );
       }
+      async getTemplateFamily(familyId) {
+        const response = await this.request("GET", `/v1/template-families/${encodeURIComponent(familyId)}`);
+        this.throwIfError(response.status, response.json);
+        return response.json.data ?? response.json;
+      }
+      async deriveTemplateFamily(familyId, body = {}) {
+        const response = await this.request(
+          "POST",
+          `/v1/template-families/${encodeURIComponent(familyId)}/derive`,
+          body
+        );
+        this.throwIfError(response.status, response.json);
+        return response.json.data ?? response.json;
+      }
+      async migrateLegacyTemplateFamilies() {
+        const response = await this.request("POST", "/v1/template-families/migrate-legacy", {});
+        this.throwIfError(response.status, response.json);
+        return response.json.data;
+      }
       async updateDraft(draftId, body) {
         const input = parseUpdateTemplateDraftInput(body);
         const response = await this.request("PUT", `/v1/template-drafts/${encodeURIComponent(draftId)}`, input);
@@ -19180,6 +16536,18 @@ var init_client = __esm({
         this.throwIfError(response.status, response.json);
         return parseSlideshowRun(response.json);
       }
+      async listSlideshowRuns(query = {}) {
+        const input = listSlideshowRunsQuerySchema.parse(query);
+        const params = new URLSearchParams();
+        for (const [key, value] of Object.entries(input)) {
+          if (value !== void 0 && value !== "")
+            params.set(key, String(value));
+        }
+        const suffix = params.size > 0 ? `?${params.toString()}` : "";
+        const response = await this.request("GET", `/v1/slideshow/runs${suffix}`);
+        this.throwIfError(response.status, response.json);
+        return parseSlideshowRunSummaryList(response.json);
+      }
       async getSlideshowRun(runId) {
         const response = await this.request("GET", `/v1/slideshow/runs/${encodeURIComponent(runId)}`);
         this.throwIfError(response.status, response.json);
@@ -19191,6 +16559,22 @@ var init_client = __esm({
         this.throwIfError(response.status, response.json);
         return parseSlideshowRun(response.json);
       }
+      async archiveSlideshowRun(runId) {
+        const response = await this.request("POST", `/v1/slideshow/runs/${encodeURIComponent(runId)}/archive`);
+        this.throwIfError(response.status, response.json);
+        return parseSlideshowRun(response.json);
+      }
+      async restoreSlideshowRun(runId) {
+        const response = await this.request("POST", `/v1/slideshow/runs/${encodeURIComponent(runId)}/restore`);
+        this.throwIfError(response.status, response.json);
+        return parseSlideshowRun(response.json);
+      }
+      async trashSlideshowRun(runId) {
+        const response = await this.request("DELETE", `/v1/slideshow/runs/${encodeURIComponent(runId)}`);
+        this.throwIfError(response.status, response.json);
+        const rows = parseSlideshowRunSummaryList(response.json);
+        return rows[0];
+      }
       async renderSlideshowRun(runId, body) {
         const input = renderSlideshowRunInputSchema.parse(body ?? {});
         const response = await this.request("POST", `/v1/slideshow/runs/${encodeURIComponent(runId)}/render`, input, { idempotencyKey: input.idempotencyKey });
@@ -19231,22 +16615,83 @@ var init_client = __esm({
           throw new Error(`Artifact download failed (${response.status})`);
         return new Uint8Array(await response.arrayBuffer());
       }
-      async listBrandProfiles() {
-        const response = await this.request("GET", "/v1/slideshow/brand-profiles");
+      async listBrands() {
+        const response = await this.request("GET", "/v1/brands");
         this.throwIfError(response.status, response.json);
-        return parseBrandProfileList(response.json);
+        return parseBrandList(response.json);
       }
-      async createBrandProfile(body) {
-        const input = createBrandProfileInputSchema.parse(body);
-        const response = await this.request("POST", "/v1/slideshow/brand-profiles", input);
+      async getBrand(brandId) {
+        const response = await this.request("GET", `/v1/brands/${encodeURIComponent(brandId)}`);
         this.throwIfError(response.status, response.json);
-        return parseBrandProfile(response.json);
+        return parseBrand(response.json);
       }
-      async updateBrandProfile(id, body) {
-        const input = updateBrandProfileInputSchema.parse(body);
-        const response = await this.request("PATCH", `/v1/slideshow/brand-profiles/${encodeURIComponent(id)}`, input);
+      async createBrand(body) {
+        const input = createBrandInputSchema.parse(body);
+        const response = await this.request("POST", "/v1/brands", input);
+        this.throwIfError(response.status, response.json);
+        return parseBrand(response.json);
+      }
+      async updateBrand(brandId, body) {
+        const input = updateBrandInputSchema.parse(body);
+        const response = await this.request("PATCH", `/v1/brands/${encodeURIComponent(brandId)}`, input);
+        this.throwIfError(response.status, response.json);
+        return parseBrand(response.json);
+      }
+      async archiveBrand(brandId) {
+        const response = await this.request("POST", `/v1/brands/${encodeURIComponent(brandId)}/archive`);
         this.throwIfError(response.status, response.json);
-        return parseBrandProfile(response.json);
+        return parseBrand(response.json);
+      }
+      async restoreBrand(brandId) {
+        const response = await this.request("POST", `/v1/brands/${encodeURIComponent(brandId)}/restore`);
+        this.throwIfError(response.status, response.json);
+        return parseBrand(response.json);
+      }
+      async trashBrand(brandId) {
+        const response = await this.request("DELETE", `/v1/brands/${encodeURIComponent(brandId)}`);
+        this.throwIfError(response.status, response.json);
+        return parseBrand(response.json);
+      }
+      /** @deprecated Use listBrands */
+      async listBrandProfiles() {
+        const brands = await this.listBrands();
+        return brands.map((brand) => ({
+          id: brand.id,
+          name: brand.name,
+          preference: {
+            themeId: void 0,
+            fonts: brand.typography ? { heading: brand.typography.headingFontId, body: brand.typography.bodyFontId } : void 0,
+            brandHex: brand.colors?.primary
+          },
+          createdAt: brand.createdAt ?? (/* @__PURE__ */ new Date()).toISOString(),
+          updatedAt: brand.updatedAt ?? (/* @__PURE__ */ new Date()).toISOString()
+        }));
+      }
+      /** @deprecated Use createBrand */
+      async createBrandProfile(body) {
+        const brand = await this.createBrand({ name: body.name });
+        return (await this.listBrandProfiles()).find((item) => item.id === brand.id) ?? {
+          id: brand.id,
+          name: brand.name,
+          preference: body.preference,
+          createdAt: brand.createdAt ?? (/* @__PURE__ */ new Date()).toISOString(),
+          updatedAt: brand.updatedAt ?? (/* @__PURE__ */ new Date()).toISOString()
+        };
+      }
+      /** @deprecated Use updateBrand */
+      async updateBrandProfile(id, body) {
+        const current = await this.getBrand(id);
+        await this.updateBrand(id, {
+          baseRevision: current.revision ?? 1,
+          name: body.name
+        });
+        return (await this.listBrandProfiles()).find((item) => item.id === id) ?? {
+          id,
+          name: body.name ?? current.name,
+          preference: body.preference ?? {},
+          createdAt: current.createdAt ?? (/* @__PURE__ */ new Date()).toISOString(),
+          updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+        };
       }
       /**
        * Materialize a confirmed external/upload image into R2 + Directus Image.
@@ -26007,7 +23452,7 @@ var init_protocol = __esm({
               return;
             }
             const pollInterval = task2.pollInterval ?? this._options?.defaultTaskPollInterval ?? 1e3;
-            await new Promise((resolve) => setTimeout(resolve, pollInterval));
+            await new Promise((resolve2) => setTimeout(resolve2, pollInterval));
             options?.signal?.throwIfAborted();
           }
         } catch (error52) {
@@ -26024,7 +23469,7 @@ var init_protocol = __esm({
        */
       request(request, resultSchema, options) {
         const { relatedRequestId, resumptionToken, onresumptiontoken, task, relatedTask } = options ?? {};
-        return new Promise((resolve, reject) => {
+        return new Promise((resolve2, reject) => {
           const earlyReject = (error52) => {
             reject(error52);
           };
@@ -26102,7 +23547,7 @@ var init_protocol = __esm({
               if (!parseResult.success) {
                 reject(parseResult.error);
               } else {
-                resolve(parseResult.data);
+                resolve2(parseResult.data);
               }
             } catch (error52) {
               reject(error52);
@@ -26363,12 +23808,12 @@ var init_protocol = __esm({
           }
         } catch {
         }
-        return new Promise((resolve, reject) => {
+        return new Promise((resolve2, reject) => {
           if (signal.aborted) {
             reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
             return;
           }
-          const timeoutId = setTimeout(resolve, interval);
+          const timeoutId = setTimeout(resolve2, interval);
           signal.addEventListener("abort", () => {
             clearTimeout(timeoutId);
             reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
@@ -29395,7 +26840,7 @@ var require_compile = __commonJS({
       const schOrFunc = root.refs[ref];
       if (schOrFunc)
         return schOrFunc;
-      let _sch = resolve.call(this, root, ref);
+      let _sch = resolve2.call(this, root, ref);
       if (_sch === void 0) {
         const schema = (_a3 = root.localRefs) === null || _a3 === void 0 ? void 0 : _a3[ref];
         const { schemaId } = this.opts;
@@ -29422,7 +26867,7 @@ var require_compile = __commonJS({
     function sameSchemaEnv(s1, s2) {
       return s1.schema === s2.schema && s1.root === s2.root && s1.baseId === s2.baseId;
     }
-    function resolve(root, ref) {
+    function resolve2(root, ref) {
       let sch;
       while (typeof (sch = this.refs[ref]) == "string")
         ref = sch;
@@ -29997,7 +27442,7 @@ var require_fast_uri = __commonJS({
       }
       return uri;
     }
-    function resolve(baseURI, relativeURI, options) {
+    function resolve2(baseURI, relativeURI, options) {
       const schemelessOptions = options ? Object.assign({ scheme: "null" }, options) : { scheme: "null" };
       const resolved = resolveComponent(parse5(baseURI, schemelessOptions), parse5(relativeURI, schemelessOptions), schemelessOptions, true);
       schemelessOptions.skipEscape = true;
@@ -30224,7 +27669,7 @@ var require_fast_uri = __commonJS({
     var fastUri = {
       SCHEMES,
       normalize,
-      resolve,
+      resolve: resolve2,
       resolveComponent,
       equal,
       serialize,
@@ -34123,12 +31568,12 @@ var init_stdio2 = __esm({
         this.onclose?.();
       }
       send(message) {
-        return new Promise((resolve) => {
+        return new Promise((resolve2) => {
           const json2 = serializeMessage(message);
           if (this._stdout.write(json2)) {
-            resolve();
+            resolve2();
           } else {
-            this._stdout.once("drain", resolve);
+            this._stdout.once("drain", resolve2);
           }
         });
       }
@@ -34199,8 +31644,8 @@ async function serveStdioMcp(options) {
   await waitForStdioServerClose(server, process.stdin);
 }
 async function waitForStdioServerClose(server, stdin = process.stdin) {
-  await new Promise((resolve) => {
-    server.onclose = () => resolve();
+  await new Promise((resolve2) => {
+    server.onclose = () => resolve2();
     if (stdin.readableEnded || stdin.destroyed) {
       void server.close().catch(() => void 0);
       return;
@@ -34824,13 +32269,14 @@ var init_src5 = __esm({
     init_src2();
     objectSchema = { type: "object", properties: {}, additionalProperties: true };
     slideshowToolRegistry = [
-      { name: "create_run", title: "Create slideshow run", description: "Create an ADR-0026 Slideshow Run from a ContentPack.", effect: "local-write-job", inputSchema: { ...objectSchema, properties: { pack: { type: "object" }, brandProfileId: { type: "string" } }, required: ["pack"] }, outputSchema: objectSchema },
+      { name: "list_runs", title: "List slideshow runs", description: "List owner-scoped Slideshow Runs with optional filters.", effect: "read-only", inputSchema: { ...objectSchema, properties: { q: { type: "string" }, platform: { type: "string" }, profileId: { type: "string" }, brandProfileId: { type: "string" }, contentSlug: { type: "string" }, status: { type: "string" } } }, outputSchema: objectSchema },
+      { name: "create_run", title: "Create slideshow run", description: "Create an ADR-0026 Slideshow Run from a ContentPack.", effect: "local-write-job", inputSchema: { ...objectSchema, properties: { pack: { type: "object" }, brandId: { type: "string" }, brandProfileId: { type: "string" }, contentSlug: { type: "string" } }, required: ["pack"] }, outputSchema: objectSchema },
       { name: "get_run", title: "Get slideshow run", description: "Get an owner-scoped Slideshow Run.", effect: "read-only", inputSchema: { ...objectSchema, properties: { runId: { type: "string" } }, required: ["runId"] }, outputSchema: objectSchema },
-      { name: "update_run", title: "Update slideshow run", description: "Edit page-instance slots/layout/style/decorations or presentation preference with optimistic revision.", effect: "local-write-job", inputSchema: { ...objectSchema, properties: { runId: { type: "string" }, pack: { type: "object" }, brandProfileId: { type: "string" }, baseRevision: { type: "integer", minimum: 1 }, pageIndex: { type: "integer", minimum: 0 }, slots: { type: "object" }, layout: { type: "object" }, style: { type: "object" }, decorations: { type: "array" } }, required: ["runId"] }, outputSchema: objectSchema },
-      { name: "render_run", title: "Render slideshow run", description: "Render a topology-locked Run as an atomic PNG set.", effect: "local-write-job", inputSchema: { ...objectSchema, properties: { runId: { type: "string" }, idempotencyKey: { type: "string", minLength: 1, maxLength: 128 } }, required: ["runId", "idempotencyKey"] }, outputSchema: objectSchema },
-      { name: "list_brand_profiles", title: "List brand profiles", description: "List owner-scoped Brand Profiles.", effect: "read-only", inputSchema: { ...objectSchema, properties: {} }, outputSchema: objectSchema },
-      { name: "create_brand_profile", title: "Create brand profile", description: "Create a Brand Profile; Free workspaces are limited to one.", effect: "local-write-job", inputSchema: { ...objectSchema, properties: { name: { type: "string" }, preference: { type: "object" } }, required: ["name"] }, outputSchema: objectSchema },
-      { name: "update_brand_profile", title: "Update brand profile", description: "Update a Brand Profile preference.", effect: "local-write-job", inputSchema: { ...objectSchema, properties: { profileId: { type: "string" }, name: { type: "string" }, preference: { type: "object" } }, required: ["profileId"] }, outputSchema: objectSchema }
+      { name: "update_run", title: "Update slideshow run", description: "Edit page-instance slots/layout/style/decorations or presentation preference with optimistic revision.", effect: "local-write-job", inputSchema: { ...objectSchema, properties: { runId: { type: "string" }, pack: { type: "object" }, brandId: { type: "string" }, brandProfileId: { type: "string" }, contentSlug: { type: "string" }, baseRevision: { type: "integer", minimum: 1 }, pageIndex: { type: "integer", minimum: 0 }, slots: { type: "object" }, layout: { type: "object" }, style: { type: "object" }, decorations: { type: "array" } }, required: ["runId"] }, outputSchema: objectSchema },
+      { name: "archive_run", title: "Archive slideshow run", description: "Hide a Run from default lists without deleting it.", effect: "local-write-job", inputSchema: { ...objectSchema, properties: { runId: { type: "string" } }, required: ["runId"] }, outputSchema: objectSchema },
+      { name: "restore_run", title: "Restore slideshow run", description: "Restore an archived or trashed Run.", effect: "local-write-job", inputSchema: { ...objectSchema, properties: { runId: { type: "string" } }, required: ["runId"] }, outputSchema: objectSchema },
+      { name: "trash_run", title: "Trash slideshow run", description: "Move a Run to trash (recoverable for 30 days).", effect: "explicit-approval", inputSchema: { ...objectSchema, properties: { runId: { type: "string" } }, required: ["runId"] }, outputSchema: objectSchema },
+      { name: "render_run", title: "Render slideshow run", description: "Render a topology-locked Run as an atomic PNG set.", effect: "local-write-job", inputSchema: { ...objectSchema, properties: { runId: { type: "string" }, idempotencyKey: { type: "string", minLength: 1, maxLength: 128 } }, required: ["runId", "idempotencyKey"] }, outputSchema: objectSchema }
     ];
     slideshowResourceTemplates = [
       { uriTemplate: "slideshow://runs/{runId}", name: "Slideshow Run", description: "Owner-scoped Run JSON snapshot", mimeType: "application/json" }
@@ -34843,20 +32289,29 @@ var init_src5 = __esm({
         const m = meta3();
         try {
           switch (toolName) {
+            case "list_runs":
+              return { ok: true, data: await this.client.listSlideshowRuns({
+                q: args.q,
+                platform: args.platform,
+                profileId: args.profileId,
+                brandProfileId: args.brandProfileId,
+                contentSlug: args.contentSlug,
+                status: args.status
+              }), meta: m };
             case "create_run":
-              return { ok: true, data: await this.client.createSlideshowRun({ pack: args.pack, brandProfileId: args.brandProfileId }), meta: m };
+              return { ok: true, data: await this.client.createSlideshowRun({ pack: args.pack, brandId: args.brandId, brandProfileId: args.brandProfileId, contentSlug: args.contentSlug }), meta: m };
             case "get_run":
               return { ok: true, data: await this.client.getSlideshowRun(String(args.runId)), meta: m };
             case "update_run":
-              return { ok: true, data: await this.client.updateSlideshowRun(String(args.runId), { pack: args.pack, brandProfileId: args.brandProfileId, baseRevision: args.baseRevision, pageIndex: args.pageIndex, slots: args.slots, layout: args.layout, style: args.style, decorations: args.decorations }), meta: m };
+              return { ok: true, data: await this.client.updateSlideshowRun(String(args.runId), { pack: args.pack, brandId: args.brandId, brandProfileId: args.brandProfileId, contentSlug: args.contentSlug, baseRevision: args.baseRevision, pageIndex: args.pageIndex, slots: args.slots, layout: args.layout, style: args.style, decorations: args.decorations }), meta: m };
+            case "archive_run":
+              return { ok: true, data: await this.client.archiveSlideshowRun(String(args.runId)), meta: m };
+            case "restore_run":
+              return { ok: true, data: await this.client.restoreSlideshowRun(String(args.runId)), meta: m };
+            case "trash_run":
+              return { ok: true, data: await this.client.trashSlideshowRun(String(args.runId)), meta: m };
             case "render_run":
               return { ok: true, data: await this.client.renderSlideshowRun(String(args.runId), { outputFormats: args.outputFormats ?? ["png"], idempotencyKey: String(args.idempotencyKey) }), meta: m };
-            case "list_brand_profiles":
-              return { ok: true, data: await this.client.listBrandProfiles(), meta: m };
-            case "create_brand_profile":
-              return { ok: true, data: await this.client.createBrandProfile({ name: String(args.name), preference: args.preference ?? {} }), meta: m };
-            case "update_brand_profile":
-              return { ok: true, data: await this.client.updateBrandProfile(String(args.profileId), { name: args.name, preference: args.preference }), meta: m };
             default:
               return { ok: false, error: { code: "UNKNOWN_TOOL", message: `Unknown tool: ${toolName}`, retryable: false }, meta: m };
           }
@@ -34888,7 +32343,7 @@ async function serveUnifiedStdioMcp(client) {
     resourceTemplates: unifiedResourceTemplates
   }, { backendName: "gateway" });
 }
-var removedTools, templateNames, slideshowNames, rename, templateTools, slideshowTools, imageTools, unifiedToolRegistry, unifiedResourceTemplates, UnifiedMcpBackend;
+var removedTools, templateNames, slideshowNames, brandTools, rename, templateTools, slideshowTools, imageTools, unifiedToolRegistry, unifiedResourceTemplates, UnifiedMcpBackend;
 var init_src6 = __esm({
   "../../packages/mcp-server/src/index.ts"() {
     "use strict";
@@ -34906,14 +32361,24 @@ var init_src6 = __esm({
       get_render_job: "get_template_render_job"
     };
     slideshowNames = {
+      list_runs: "list_slideshow_runs",
       create_run: "create_slideshow_run",
       get_run: "get_slideshow_run",
       update_run: "update_slideshow_run",
-      render_run: "render_slideshow_run",
-      list_brand_profiles: "list_profiles",
-      create_brand_profile: "create_profile",
-      update_brand_profile: "update_profile"
-    };
+      archive_run: "archive_slideshow_run",
+      restore_run: "restore_slideshow_run",
+      trash_run: "trash_slideshow_run",
+      render_run: "render_slideshow_run"
+    };
+    brandTools = [
+      { name: "list_brands", title: "List brands", description: "List owner-scoped Brands (identity + fonts + colors + logo).", effect: "read-only", inputSchema: { type: "object", properties: {}, additionalProperties: false }, outputSchema: { type: "object", properties: {} } },
+      { name: "get_brand", title: "Get brand", description: "Get one Brand by id.", effect: "read-only", inputSchema: { type: "object", properties: { brandId: { type: "string" } }, required: ["brandId"], additionalProperties: false }, outputSchema: { type: "object", properties: {} } },
+      { name: "create_brand", title: "Create brand", description: "Create a Brand with optional fonts, colors and logoAssetId.", effect: "local-write-job", inputSchema: { type: "object", properties: { name: { type: "string" }, displayName: { type: "string" }, handle: { type: "string" }, typography: { type: "object" }, colors: { type: "object" }, logoAssetId: { type: "string" } }, required: ["name"], additionalProperties: false }, outputSchema: { type: "object", properties: {} } },
+      { name: "update_brand", title: "Update brand", description: "Patch Brand appearance with optimistic baseRevision.", effect: "local-write-job", inputSchema: { type: "object", properties: { brandId: { type: "string" }, baseRevision: { type: "integer", minimum: 1 }, name: { type: "string" }, displayName: { type: "string" }, handle: { type: "string" }, typography: { type: "object" }, colors: { type: "object" }, logoAssetId: { type: "string" } }, required: ["brandId", "baseRevision"], additionalProperties: false }, outputSchema: { type: "object", properties: {} } },
+      { name: "archive_brand", title: "Archive brand", description: "Archive a Brand.", effect: "local-write-job", inputSchema: { type: "object", properties: { brandId: { type: "string" } }, required: ["brandId"], additionalProperties: false }, outputSchema: { type: "object", properties: {} } },
+      { name: "restore_brand", title: "Restore brand", description: "Restore an archived Brand.", effect: "local-write-job", inputSchema: { type: "object", properties: { brandId: { type: "string" } }, required: ["brandId"], additionalProperties: false }, outputSchema: { type: "object", properties: {} } },
+      { name: "trash_brand", title: "Trash brand", description: "Move a Brand to trash.", effect: "explicit-approval", inputSchema: { type: "object", properties: { brandId: { type: "string" } }, required: ["brandId"], additionalProperties: false }, outputSchema: { type: "object", properties: {} } }
+    ];
     rename = (tool, names) => ({ ...tool, name: names[tool.name] ?? tool.name });
     templateTools = templateToolRegistry.map((tool) => rename(tool, templateNames));
     slideshowTools = slideshowToolRegistry.filter((tool) => !removedTools.has(tool.name)).map((tool) => rename(tool, slideshowNames));
@@ -34926,7 +32391,7 @@ var init_src6 = __esm({
       { name: "restore_image", title: "Restore image", description: "Restore an image asset.", effect: "local-write-job", inputSchema: { type: "object", properties: { imageId: { type: "string" } }, required: ["imageId"], additionalProperties: false }, outputSchema: { type: "object", properties: {} } },
       { name: "delete_image", title: "Trash image", description: "Move an image asset to trash.", effect: "explicit-approval", inputSchema: { type: "object", properties: { imageId: { type: "string" } }, required: ["imageId"], additionalProperties: false }, outputSchema: { type: "object", properties: {} } }
     ];
-    unifiedToolRegistry = [...templateTools, ...slideshowTools, ...imageTools];
+    unifiedToolRegistry = [...templateTools, ...slideshowTools, ...brandTools, ...imageTools];
     unifiedResourceTemplates = slideshowResourceTemplates;
     UnifiedMcpBackend = class {
       client;
@@ -34942,6 +32407,47 @@ var init_src6 = __esm({
         if (templateTool) return this.template.invoke(Object.entries(templateNames).find(([, name]) => name === toolName)?.[0] ?? toolName, args);
         const slideshowTool = slideshowTools.find((tool) => tool.name === toolName);
         if (slideshowTool) return this.slideshow.invoke(Object.entries(slideshowNames).find(([, name]) => name === toolName)?.[0] ?? toolName, args);
+        const brandTool = brandTools.find((tool) => tool.name === toolName);
+        if (brandTool) {
+          const meta4 = { requestId: `mcp_${Date.now().toString(36)}`, runtimeVersion: "0.0.0", schemaVersion: 1, toolContractVersion: "2026-08-28" };
+          const brandId = typeof args.brandId === "string" ? args.brandId : "";
+          const run = async () => {
+            switch (toolName) {
+              case "list_brands":
+                return this.client.listBrands();
+              case "get_brand":
+                return this.client.getBrand(brandId);
+              case "create_brand":
+                return this.client.createBrand({
+                  name: String(args.name),
+                  displayName: args.displayName,
+                  handle: args.handle,
+                  typography: args.typography,
+                  colors: args.colors,
+                  logoAssetId: args.logoAssetId
+                });
+              case "update_brand":
+                return this.client.updateBrand(brandId, {
+                  baseRevision: Number(args.baseRevision),
+                  name: args.name,
+                  displayName: args.displayName,
+                  handle: args.handle,
+                  typography: args.typography,
+                  colors: args.colors,
+                  logoAssetId: args.logoAssetId
+                });
+              case "archive_brand":
+                return this.client.archiveBrand(brandId);
+              case "restore_brand":
+                return this.client.restoreBrand(brandId);
+              case "trash_brand":
+                return this.client.trashBrand(brandId);
+              default:
+                throw new Error(`Unknown brand tool: ${toolName}`);
+            }
+          };
+          return run().then((data) => ({ ok: true, data, meta: meta4 })).catch((e) => ({ ok: false, error: { code: e?.code ?? "GATEWAY_ERROR", message: e?.message ?? "Gateway request failed", retryable: Boolean(e?.retryable) }, meta: meta4 }));
+        }
         const imageTool = imageTools.find((tool) => tool.name === toolName);
         if (imageTool) {
           const imageId = typeof args.imageId === "string" ? encodeURIComponent(args.imageId) : "";
@@ -34979,32 +32485,13 @@ var init_v1_mcp = __esm({
 });
 
 // src/v1-cli.ts
+init_src2();
 import { cp, mkdtemp, readFile, rename as rename2, rm, writeFile, mkdir, chmod, copyFile } from "fs/promises";
-import { existsSync as existsSync3, readFileSync as readFileSync2 } from "fs";
+import { existsSync as existsSync4, readFileSync as readFileSync3, statSync as statSync2 } from "fs";
 import { createHash } from "crypto";
-import { homedir as homedir2, tmpdir } from "os";
-import { join as join3 } from "path";
-import { fileURLToPath as fileURLToPath2 } from "url";
-
-// ../../node_modules/.pnpm/commander@11.1.0/node_modules/commander/esm.mjs
-var import_index = __toESM(require_commander(), 1);
-var {
-  program,
-  createCommand,
-  createArgument,
-  createOption,
-  CommanderError,
-  InvalidArgumentError,
-  InvalidOptionArgumentError,
-  // deprecated old name
-  Command,
-  Argument,
-  Option,
-  Help
-} = import_index.default;
-
-// src/v1-cli.ts
-init_src2();
+import { homedir as homedir3, tmpdir } from "os";
+import { join as join4 } from "path";
+import { Command } from "commander";
 
 // src/runtime/mcp-hosts.ts
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
@@ -35128,16 +32615,330 @@ function resolveDefaultSkillsSource(moduleUrl) {
   return bundled;
 }
 
+// src/engine.ts
+import { spawn, spawnSync } from "child_process";
+import {
+  copyFileSync,
+  existsSync as existsSync3,
+  mkdirSync as mkdirSync2,
+  readdirSync,
+  readFileSync as readFileSync2,
+  statSync,
+  writeFileSync as writeFileSync2
+} from "fs";
+import net from "net";
+import { homedir as homedir2 } from "os";
+import { basename, dirname as dirname3, join as join3, resolve } from "path";
+var ENGINE_ROOT_NAME = "Content Engine";
+var WORKBENCH_PORT = 8765;
+var WORKBENCH_URL = `http://127.0.0.1:${WORKBENCH_PORT}/workbench/`;
+var WORKBENCH_FILES = ["template.html", "build.py", "serve.py"];
+function contentEnginePackageRoot(moduleUrl) {
+  const pkg = cliPackageRoot(moduleUrl);
+  const bundled = join3(pkg, "content-engine");
+  if (existsSync3(join3(bundled, "starter")))
+    return bundled;
+  const sibling = join3(pkg, "content-engine");
+  if (existsSync3(join3(sibling, "starter")))
+    return sibling;
+  return bundled;
+}
+function starterDir(moduleUrl) {
+  return join3(contentEnginePackageRoot(moduleUrl), "starter");
+}
+function workbenchSrc(moduleUrl) {
+  return join3(contentEnginePackageRoot(moduleUrl), "workbench");
+}
+function scriptsDir(moduleUrl) {
+  return join3(contentEnginePackageRoot(moduleUrl), "scripts");
+}
+function isDir(path) {
+  return existsSync3(path) && statSync(path).isDirectory();
+}
+function isEngine(path) {
+  return isDir(path) && existsSync3(join3(path, "CLAUDE.md")) && isDir(join3(path, "runs"));
+}
+function resolveEngine(rootOrEngine) {
+  const absolute = resolve(rootOrEngine);
+  if (isEngine(absolute) || basename(absolute) === ENGINE_ROOT_NAME)
+    return absolute;
+  return join3(absolute, ENGINE_ROOT_NAME);
+}
+function walkFiles(dir) {
+  const out = [];
+  if (!existsSync3(dir))
+    return out;
+  for (const name of readdirSync(dir)) {
+    if (name === ".DS_Store")
+      continue;
+    const path = join3(dir, name);
+    if (statSync(path).isDirectory())
+      out.push(...walkFiles(path));
+    else
+      out.push(path);
+  }
+  return out;
+}
+function engineJson() {
+  return `${JSON.stringify({
+    schemaVersion: "content-engine.v1",
+    locale: "en",
+    root: ENGINE_ROOT_NAME,
+    paths: {
+      runs: "runs",
+      exports: "exports",
+      topics: "topics",
+      discovery: "discovery",
+      swipe: "swipe",
+      profiles: "profiles",
+      inbox: "inbox",
+      accounts: "accounts",
+      raw: "raw",
+      published: "published",
+      wiki: "wiki",
+      platforms: "platforms",
+      workbench: "workbench"
+    }
+  }, null, 2)}
+`;
+}
+function starterFiles(moduleUrl) {
+  const root = starterDir(moduleUrl);
+  const files = {};
+  for (const path of walkFiles(root)) {
+    const relativePath = path.slice(root.length + 1).split("\\").join("/");
+    files[relativePath] = readFileSync2(path, "utf8");
+  }
+  files["engine.json"] = engineJson();
+  return files;
+}
+function inventory(engine, moduleUrl) {
+  const files = starterFiles(moduleUrl);
+  const missing = [];
+  const existing = [];
+  for (const relative of Object.keys(files)) {
+    const path = join3(engine, relative);
+    (existsSync3(path) ? existing : missing).push(relative);
+  }
+  return {
+    engine,
+    engineExists: isDir(engine),
+    rootName: ENGINE_ROOT_NAME,
+    missing,
+    existing,
+    starterComplete: missing.length === 0
+  };
+}
+function validateEngine(rootOrEngine, moduleUrl, { strict = false } = {}) {
+  const engine = resolveEngine(rootOrEngine);
+  const parent = resolve(engine, "..");
+  const errors = [];
+  if (!existsSync3(parent) || !statSync(parent).isDirectory()) {
+    errors.push("Parent directory does not exist");
+    return { ...inventory(engine, moduleUrl), valid: false, errors, created: [] };
+  }
+  const result = inventory(engine, moduleUrl);
+  if (existsSync3(engine) && !isDir(engine))
+    errors.push("Content Engine exists but is not a directory");
+  if (strict) {
+    if (!result.engineExists)
+      errors.push("Content Engine/ folder does not exist");
+    else if (result.missing.length > 0)
+      errors.push(`Starter incomplete: ${result.missing.length} file(s) missing (use engine init --yes to add only missing files)`);
+  }
+  return { ...result, valid: errors.length === 0, errors, created: [] };
+}
+function python3Bin() {
+  const result = spawnSync("python3", ["--version"], { encoding: "utf8" });
+  return result.status === 0 ? "python3" : "";
+}
+function ensureWorkbench(engine, moduleUrl) {
+  const destDir = join3(engine, "workbench");
+  mkdirSync2(destDir, { recursive: true });
+  const copied = [];
+  const skipped = [];
+  const src = workbenchSrc(moduleUrl);
+  for (const name of WORKBENCH_FILES) {
+    const dest = join3(destDir, name);
+    if (existsSync3(dest)) {
+      skipped.push(name);
+      continue;
+    }
+    copyFileSync(join3(src, name), dest);
+    copied.push(name);
+  }
+  return { destDir, copied, skipped };
+}
+function buildWorkbench(engine) {
+  const python = python3Bin();
+  if (!python)
+    return { ok: false, code: "PYTHON3_REQUIRED", message: "python3 is required for the workbench. Install Python 3 and retry." };
+  const script = join3(engine, "workbench", "build.py");
+  if (!existsSync3(script))
+    return { ok: false, code: "WORKBENCH_MISSING", message: "workbench/build.py is missing. Re-run easysociable engine init --yes." };
+  const result = spawnSync(python, [script], { encoding: "utf8", cwd: engine });
+  if (result.status !== 0)
+    return { ok: false, code: "WORKBENCH_BUILD_FAILED", message: result.stderr.trim() || result.stdout.trim() || "workbench build failed" };
+  return { ok: true, message: result.stdout.trim() };
+}
+function portInUse(port = WORKBENCH_PORT) {
+  return new Promise((resolvePort) => {
+    const socket = net.connect({ port, host: "127.0.0.1" }, () => {
+      socket.end();
+      resolvePort(true);
+    });
+    socket.on("error", () => resolvePort(false));
+  });
+}
+function openUrl(url2) {
+  const command = process.platform === "darwin" ? "open" : process.platform === "win32" ? "cmd" : "xdg-open";
+  const args = process.platform === "win32" ? ["/c", "start", url2] : [url2];
+  spawn(command, args, { stdio: "ignore", detached: true }).unref();
+}
+async function startWorkbench(engine, moduleUrl, { noOpen = false } = {}) {
+  const python = python3Bin();
+  if (!python)
+    return { ok: false, code: "PYTHON3_REQUIRED", message: "python3 is required for the workbench. Install Python 3 and retry." };
+  ensureWorkbench(engine, moduleUrl);
+  const built = buildWorkbench(engine);
+  if (!built.ok)
+    return built;
+  const url2 = WORKBENCH_URL;
+  if (await portInUse()) {
+    if (!noOpen && process.env.EASYSOCIABLE_NO_OPEN !== "true")
+      openUrl(url2);
+    return { ok: true, alreadyRunning: true, url: url2, build: built.message };
+  }
+  const args = [join3(engine, "workbench", "serve.py")];
+  if (noOpen)
+    args.push("--no-open");
+  const child = spawn(python, args, { cwd: engine, detached: true, stdio: "ignore" });
+  child.unref();
+  return { ok: true, alreadyRunning: false, url: url2, pid: child.pid, build: built.message };
+}
+async function initEngine(rootOrEngine, moduleUrl, {
+  yes = false,
+  noOpen = false,
+  serve = false
+} = {}) {
+  const engine = resolveEngine(rootOrEngine);
+  if (!yes) {
+    const preview = validateEngine(engine, moduleUrl);
+    return {
+      ...preview,
+      action: "preview",
+      next: "Review missing files and re-run with --yes"
+    };
+  }
+  const parent = resolve(engine, "..");
+  if (!existsSync3(parent) || !statSync(parent).isDirectory()) {
+    return {
+      engine,
+      action: "applied",
+      valid: false,
+      code: "PARENT_MISSING",
+      errors: ["Parent directory does not exist"],
+      created: []
+    };
+  }
+  mkdirSync2(engine, { recursive: true });
+  const report = inventory(engine, moduleUrl);
+  const created = [];
+  const files = starterFiles(moduleUrl);
+  for (const relative of report.missing) {
+    const path = join3(engine, relative);
+    mkdirSync2(dirname3(path), { recursive: true });
+    writeFileSync2(path, files[relative], { encoding: "utf8", flag: "wx" });
+    created.push(relative);
+  }
+  const workbench = ensureWorkbench(engine, moduleUrl);
+  const python = python3Bin();
+  if (!python) {
+    return {
+      ...validateEngine(engine, moduleUrl),
+      created,
+      workbench,
+      action: "applied",
+      valid: false,
+      code: "PYTHON3_REQUIRED",
+      errors: ["python3 is required for the workbench. Install Python 3 and retry. Starter files were written; workbench was not started."]
+    };
+  }
+  const built = buildWorkbench(engine);
+  const started = serve ? await startWorkbench(engine, moduleUrl, { noOpen }) : { skipped: true, build: built };
+  return {
+    ...validateEngine(engine, moduleUrl),
+    created,
+    workbench,
+    workbenchBuild: built,
+    workbenchStart: started,
+    action: "applied"
+  };
+}
+function detectEngines() {
+  const extra = (process.env.EASYSOCIABLE_ENGINE_SEARCH_ROOTS || "").split(process.platform === "win32" ? ";" : ":").map((item) => item.trim()).filter(Boolean);
+  const home = homedir2();
+  const roots = [...extra, join3(home, "Documents"), home];
+  const found = [];
+  for (const root of roots) {
+    if (!isDir(root))
+      continue;
+    const direct = join3(root, ENGINE_ROOT_NAME);
+    if (isEngine(direct) || isDir(direct))
+      found.push(direct);
+    try {
+      for (const name of readdirSync(root)) {
+        const child = join3(root, name, ENGINE_ROOT_NAME);
+        if (isDir(child))
+          found.push(child);
+      }
+    } catch {
+      continue;
+    }
+  }
+  return [...new Set(found)];
+}
+function validateRun(moduleUrl, args) {
+  const script = join3(scriptsDir(moduleUrl), "validate-run.mjs");
+  if (!existsSync3(script))
+    throw new Error(`Missing validate-run script at ${script}`);
+  const argv = ["--run", args.run];
+  if (args.requirePack)
+    argv.push("--require-pack");
+  if (args.requireExport)
+    argv.push("--require-export");
+  if (args.exportDir)
+    argv.push("--export", args.exportDir);
+  if (args.requirePageTemplateId)
+    argv.push("--require-page-template-id");
+  if (args.json !== false)
+    argv.push("--json");
+  const result = spawnSync(process.execPath, [script, ...argv], { encoding: "utf8" });
+  return {
+    status: result.status ?? 1,
+    stdout: result.stdout,
+    stderr: result.stderr
+  };
+}
+
 // src/v1-cli.ts
-var CLI_MODULE_URL = fileURLToPath2(import.meta.url);
-var credentialPath = join3(homedir2(), ".config", "easysociable", "credentials.json");
+var CLI_MODULE_URL = import.meta.url;
+function readCliVersion() {
+  try {
+    const pkg = JSON.parse(readFileSync3(join4(cliPackageRoot(CLI_MODULE_URL), "package.json"), "utf8"));
+    return typeof pkg.version === "string" && pkg.version ? pkg.version : "0.0.0";
+  } catch {
+    return "0.0.0";
+  }
+}
+var credentialPath = join4(homedir3(), ".config", "easysociable", "credentials.json");
 function resolveInstallSkillIds(options) {
   return parseInstallSkills(typeof options.skills === "string" ? options.skills : void 0);
 }
 function readStoredCredentials() {
   try {
-    if (!existsSync3(credentialPath)) return null;
-    const parsed = JSON.parse(readFileSync2(credentialPath, "utf8"));
+    if (!existsSync4(credentialPath)) return null;
+    const parsed = JSON.parse(readFileSync3(credentialPath, "utf8"));
     if (typeof parsed.apiKey !== "string" || typeof parsed.baseUrl !== "string") return null;
     return { apiKey: parsed.apiKey, baseUrl: parsed.baseUrl };
   } catch {
@@ -35145,7 +32946,7 @@ function readStoredCredentials() {
   }
 }
 async function writeStoredCredentials(credentials) {
-  await mkdir(join3(homedir2(), ".config", "easysociable"), { recursive: true, mode: 448 });
+  await mkdir(join4(homedir3(), ".config", "easysociable"), { recursive: true, mode: 448 });
   await writeFile(credentialPath, `${JSON.stringify(credentials, null, 2)}
 `, { mode: 384 });
   await chmod(credentialPath, 384);
@@ -35161,6 +32962,13 @@ function print(value, json2) {
   else process.stdout.write(`${JSON.stringify(value, null, 2)}
 `);
 }
+function commandWantsJson(command) {
+  const local = command.opts();
+  if (local.json === true)
+    return true;
+  const withGlobals = typeof command.optsWithGlobals === "function" ? command.optsWithGlobals() : {};
+  return withGlobals.json === true;
+}
 function clientFromEnv() {
   const stored = readStoredCredentials();
   const allowEnv = process.env.EASYSOCIABLE_ALLOW_ENV_CREDENTIALS === "true";
@@ -35177,8 +32985,16 @@ function clientFromEnv() {
 function jsonOption(command) {
   return command.option("--json", "Emit a JSON envelope");
 }
+function defaultEngineRoot() {
+  try {
+    if (existsSync4("/workspace") && statSync2("/workspace").isDirectory())
+      return "/workspace";
+  } catch {
+  }
+  return process.cwd();
+}
 function installHome(options) {
-  return typeof options.home === "string" && options.home ? String(options.home) : homedir2();
+  return typeof options.home === "string" && options.home ? String(options.home) : homedir3();
 }
 function installSource(options) {
   if (typeof options.source === "string" && options.source)
@@ -35189,17 +33005,17 @@ function installSource(options) {
 }
 function detectedHosts(home) {
   const candidates = [
-    { host: "codex", dir: join3(home, ".codex") },
-    { host: "claude", dir: join3(home, ".claude") }
+    { host: "codex", dir: join4(home, ".codex") },
+    { host: "claude", dir: join4(home, ".claude") }
   ];
-  return candidates.filter((item) => existsSync3(item.dir)).map((item) => ({ host: item.host, configPath: join3(item.dir, "mcp.json"), skillsPath: join3(item.dir, "skills") }));
+  return candidates.filter((item) => existsSync4(item.dir)).map((item) => ({ host: item.host, configPath: join4(item.dir, "mcp.json"), skillsPath: join4(item.dir, "skills") }));
 }
 async function planInstallation(options) {
   const home = installHome(options);
   const source = installSource(options);
   const hosts = detectedHosts(home);
   const skillNames = resolveInstallSkillIds(options);
-  const missingSkills = skillNames.filter((name) => !existsSync3(join3(source, name)));
+  const missingSkills = skillNames.filter((name) => !existsSync4(join4(source, name)));
   return {
     source,
     home,
@@ -35208,7 +33024,7 @@ async function planInstallation(options) {
     missingSkills,
     changes: hosts.flatMap((host) => [
       `merge ${host.configPath} with one easysociable MCP registration`,
-      ...skillNames.map((name) => `install ${join3(host.skillsPath, name)}`)
+      ...skillNames.map((name) => `install ${join4(host.skillsPath, name)}`)
     ])
   };
 }
@@ -35224,7 +33040,7 @@ async function applyInstallation(options) {
   const backupSuffix = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
   const backups = [];
   for (const host of detectedHosts(String(plan.home))) {
-    if (existsSync3(host.configPath)) {
+    if (existsSync4(host.configPath)) {
       const backupPath = `${host.configPath}.bak.${backupSuffix}`;
       await copyFile(host.configPath, backupPath);
       backups.push(backupPath);
@@ -35232,12 +33048,12 @@ async function applyInstallation(options) {
     await installHostConfig({ host: host.host, dataDir: "", configPath: host.configPath });
     await mkdir(host.skillsPath, { recursive: true, mode: 448 });
     for (const skill of resolveInstallSkillIds(options))
-      await cp(join3(String(plan.source), skill), join3(host.skillsPath, skill), { recursive: true, force: false, errorOnExist: false });
+      await cp(join4(String(plan.source), skill), join4(host.skillsPath, skill), { recursive: true, force: false, errorOnExist: false });
   }
   return { ...plan, applied: true, backups };
 }
 async function readJsonArgument(value) {
-  if (existsSync3(value))
+  if (existsSync4(value))
     return JSON.parse(await readFile(value, "utf8"));
   return JSON.parse(value);
 }
@@ -35275,7 +33091,7 @@ async function exportManifest(client, jobId, output) {
   const job = await client.getRenderJob(jobId);
   if (job.status !== "completed" || !job.manifest)
     throw new Error(`Render job ${jobId} is not completed or has no manifest`);
-  const staging = await mkdtemp(join3(tmpdir(), "easysociable-export-"));
+  const staging = await mkdtemp(join4(tmpdir(), "easysociable-export-"));
   try {
     for (const [index, artifact] of job.manifest.artifacts.entries()) {
       const response = await fetch(artifact.url);
@@ -35283,9 +33099,9 @@ async function exportManifest(client, jobId, output) {
       const bytes = Buffer.from(await response.arrayBuffer());
       const checksum = createHash("sha256").update(bytes).digest("hex");
       if (checksum !== artifact.sha256) throw new Error(`Artifact checksum mismatch for page ${index + 1}`);
-      await writeFile(join3(staging, `${String(index + 1).padStart(2, "0")}.png`), bytes);
+      await writeFile(join4(staging, `${String(index + 1).padStart(2, "0")}.png`), bytes);
     }
-    await writeFile(join3(staging, "manifest.json"), `${JSON.stringify(job.manifest, null, 2)}
+    await writeFile(join4(staging, "manifest.json"), `${JSON.stringify(job.manifest, null, 2)}
 `);
     await rm(output, { recursive: true, force: true });
     await rename2(staging, output);
@@ -35297,7 +33113,7 @@ async function exportManifest(client, jobId, output) {
 }
 async function exportSlideshowRun(client, runId, output) {
   const manifest = await client.getSlideshowRunManifest(runId);
-  const staging = await mkdtemp(join3(tmpdir(), "easysociable-slideshow-export-"));
+  const staging = await mkdtemp(join4(tmpdir(), "easysociable-slideshow-export-"));
   try {
     const pages = [];
     for (const artifact of manifest.artifacts) {
@@ -35307,7 +33123,7 @@ async function exportSlideshowRun(client, runId, output) {
         throw new Error(`Artifact checksum mismatch for page ${artifact.pageIndex + 1}`);
       const role = artifact.role || `page${artifact.pageIndex}`;
       const fileName = `${String(artifact.pageIndex + 1).padStart(2, "0")}-${role}.png`;
-      await writeFile(join3(staging, fileName), bytes);
+      await writeFile(join4(staging, fileName), bytes);
       pages.push({
         pageIndex: artifact.pageIndex,
         role,
@@ -35324,7 +33140,7 @@ async function exportSlideshowRun(client, runId, output) {
       deckJobId: manifest.deckJobId,
       pages
     };
-    await writeFile(join3(staging, "manifest.json"), `${JSON.stringify(localManifest, null, 2)}
+    await writeFile(join4(staging, "manifest.json"), `${JSON.stringify(localManifest, null, 2)}
 `);
     await rm(output, { recursive: true, force: true });
     await rename2(staging, output);
@@ -35345,22 +33161,89 @@ function addCrudCommands(parent, resource, routes) {
   }
 }
 function buildV1Cli() {
-  const program2 = new Command().name("easysociable").description("EasySociable Gateway CLI for Template and Slideshow V1").version("0.0.0").option("--json", "Emit a JSON envelope");
-  jsonOption(program2.command("install").description("Install Skills and one MCP registration for detected Codex/Claude hosts").option("--yes", "Apply the reviewed changes").option("--skills <list>", "Skills to install: content,template,slideshow (default: template,slideshow)").option("--source <path>", "Skill source root").option("--home <path>", "Home directory fixture for tests")).action(async (...args) => {
+  const program = new Command().name("easysociable").description("EasySociable Gateway CLI for Template and Slideshow V1").version(readCliVersion()).option("--json", "Emit a JSON envelope");
+  jsonOption(program.command("install").description("Install Skills and one MCP registration for detected Codex/Claude hosts").option("--yes", "Apply the reviewed changes").option("--skills <list>", "Skills to install: content,template,slideshow (default: template,slideshow)").option("--source <path>", "Skill source root").option("--home <path>", "Home directory fixture for tests")).action(async (...args) => {
     const command = args.at(-1);
     const opts = command.opts();
     const plan = await planInstallation(opts);
     const result = opts.yes === true ? await applyInstallation(opts) : { ...plan, applied: false, next: "Review changes and re-run with --yes" };
     print(result, Boolean(opts.json));
   });
-  jsonOption(program2.command("update").description("Update installed Skills and MCP registration with backup").option("--yes", "Apply the reviewed changes").option("--skills <list>", "Skills to install: content,template,slideshow (default: template,slideshow)").option("--source <path>", "Skill source root").option("--home <path>", "Home directory fixture for tests")).action(async (...args) => {
+  jsonOption(program.command("update").description("Update installed Skills and MCP registration with backup").option("--yes", "Apply the reviewed changes").option("--skills <list>", "Skills to install: content,template,slideshow (default: template,slideshow)").option("--source <path>", "Skill source root").option("--home <path>", "Home directory fixture for tests")).action(async (...args) => {
     const command = args.at(-1);
     const opts = command.opts();
     const plan = await planInstallation(opts);
     const result = opts.yes === true ? await applyInstallation(opts) : { ...plan, applied: false, next: "Review changes and re-run with --yes" };
     print(result, Boolean(opts.json));
   });
-  const auth = program2.command("auth").description("Manage the shared EasySociable credential");
+  const engine = program.command("engine").description("Create and operate a local Content Engine + workbench");
+  jsonOption(engine.command("detect").description("Find Content Engine folders under search roots")).action((...args) => {
+    const command = args.at(-1);
+    print({ action: "detect", engines: detectEngines() }, commandWantsJson(command));
+  });
+  jsonOption(engine.command("init").description("Scaffold Content Engine starter files (never overwrites existing)").option("--root <path>", "Parent directory or Content Engine path", defaultEngineRoot()).option("--yes", "Write missing starter files").option("--serve", "Also start the workbench server").option("--no-open", "Do not open a browser when starting the workbench")).action(async (...args) => {
+    const command = args.at(-1);
+    const opts = command.opts();
+    const result = await initEngine(String(opts.root), CLI_MODULE_URL, {
+      yes: opts.yes === true,
+      noOpen: opts.noOpen === true,
+      serve: opts.serve === true
+    });
+    print(result, commandWantsJson(command));
+    if (opts.yes === true && (result.valid === false || result.code)) {
+      const errors = result.errors;
+      throw new Error(errors?.[0] ?? result.code ?? "engine init failed");
+    }
+  });
+  jsonOption(engine.command("validate").description("Validate engine starter completeness or a run folder").option("--root <path>", "Parent directory or Content Engine path").option("--run <path>", "Run directory to validate").option("--require-pack", "Require pack-*.json on the run").option("--require-export", "Require export directory").option("--export <path>", "Export directory for --require-export")).action((...args) => {
+    const command = args.at(-1);
+    const opts = command.opts();
+    if (opts.run) {
+      const result = validateRun(CLI_MODULE_URL, {
+        run: String(opts.run),
+        requirePack: opts.requirePack === true,
+        requireExport: opts.requireExport === true,
+        exportDir: opts.export ? String(opts.export) : void 0,
+        json: true
+      });
+      if (result.stdout)
+        process.stdout.write(result.stdout.endsWith("\n") ? result.stdout : `${result.stdout}
+`);
+      if (result.status !== 0)
+        throw new Error(result.stderr.trim() || "engine validate --run failed");
+      return;
+    }
+    if (!opts.root)
+      throw new Error("Pass --root <path> or --run <path>.");
+    const report = validateEngine(String(opts.root), CLI_MODULE_URL, { strict: true });
+    print({ ...report, action: "validated" }, commandWantsJson(command));
+    if (!report.valid)
+      throw new Error(report.errors[0] ?? "engine validate failed");
+  });
+  jsonOption(engine.command("serve").description("Build and start the workbench on :8765").option("--engine <path>", "Content Engine path or parent", defaultEngineRoot()).option("--no-open", "Do not open a browser")).action(async (...args) => {
+    const command = args.at(-1);
+    const opts = command.opts();
+    const enginePath = resolveEngine(String(opts.engine));
+    ensureWorkbench(enginePath, CLI_MODULE_URL);
+    const built = buildWorkbench(enginePath);
+    if (!built.ok)
+      throw new Error(built.message);
+    const started = await startWorkbench(enginePath, CLI_MODULE_URL, { noOpen: opts.noOpen === true });
+    print({ action: "serve", engine: enginePath, ...started }, commandWantsJson(command));
+    if (!started.ok)
+      throw new Error("message" in started ? String(started.message) : "engine serve failed");
+  });
+  jsonOption(engine.command("build").description("Rebuild workbench/index.html from markdown indexes").option("--engine <path>", "Content Engine path or parent", defaultEngineRoot())).action((...args) => {
+    const command = args.at(-1);
+    const opts = command.opts();
+    const enginePath = resolveEngine(String(opts.engine));
+    ensureWorkbench(enginePath, CLI_MODULE_URL);
+    const built = buildWorkbench(enginePath);
+    print({ action: "build", engine: enginePath, ...built }, commandWantsJson(command));
+    if (!built.ok)
+      throw new Error(built.message);
+  });
+  const auth = program.command("auth").description("Manage the shared EasySociable credential");
   jsonOption(auth.command("status").description("Show authentication status")).action(async (...args) => {
     const command = args.at(-1);
     const stored = readStoredCredentials();
@@ -35377,17 +33260,18 @@ function buildV1Cli() {
     await rm(credentialPath, { force: true });
     process.stdout.write("Removed the stored EasySociable credential.\n");
   });
-  addCrudCommands(program2.command("profiles"), "profiles", { list: "/v1/profiles", get: "/v1/profiles/:id", create: "/v1/profiles", update: "/v1/profiles/:id", archive: "/v1/profiles/:id/archive", restore: "/v1/profiles/:id/restore", delete: "/v1/profiles/:id" });
-  const themes = program2.command("themes").description("Manage Profile-owned Themes");
+  addCrudCommands(program.command("brands").description("Manage workspace Brands (identity, fonts, colors, logo)"), "brands", { list: "/v1/brands", get: "/v1/brands/:id", create: "/v1/brands", update: "/v1/brands/:id", archive: "/v1/brands/:id/archive", restore: "/v1/brands/:id/restore", delete: "/v1/brands/:id" });
+  addCrudCommands(program.command("profiles").description("Deprecated \u2014 use brands"), "profiles", { list: "/v1/profiles", get: "/v1/profiles/:id", create: "/v1/profiles", update: "/v1/profiles/:id", archive: "/v1/profiles/:id/archive", restore: "/v1/profiles/:id/restore", delete: "/v1/profiles/:id" });
+  const themes = program.command("themes").description("Deprecated \u2014 use brands");
   addCrudCommands(themes, "themes", { list: "/v1/themes", get: "/v1/themes/:id", create: "/v1/themes", update: "/v1/themes/:id", archive: "/v1/themes/:id/archive", restore: "/v1/themes/:id/restore", delete: "/v1/themes/:id" });
   jsonOption(themes.command("set-default").requiredOption("--profile-id <profileId>").requiredOption("--theme-id <themeId>")).action(withClient(async (client, opts) => client.requestJson("POST", `/v1/profiles/${opts.profileId}/default-theme`, { themeId: opts.themeId })));
-  const images = program2.command("images").description("Manage account image assets");
+  const images = program.command("images").description("Manage account image assets");
   addCrudCommands(images, "images", { list: "/v1/images", get: "/v1/images/:id", create: "/v1/images/imports", update: "/v1/images/:id", archive: "/v1/images/:id/archive", restore: "/v1/images/:id/restore", delete: "/v1/images/:id" });
   jsonOption(images.command("upload").requiredOption("--file <path>")).action(withClient(async (client, opts) => client.requestJson("POST", "/v1/images/imports", JSON.parse(await readFile(String(opts.file), "utf8")))));
   jsonOption(images.command("import-url").requiredOption("--url <url>").option("--name <name>")).action(withClient(async (client, opts) => client.requestJson("POST", "/v1/images/imports", { sourceUrl: String(opts.url), ...opts.name ? { name: String(opts.name) } : {} })));
   jsonOption(images.command("search").requiredOption("--q <query>")).action(withClient(async (client, opts) => client.requestJson("GET", `/v1/images?q=${encodeURIComponent(String(opts.q))}`)));
   jsonOption(images.command("attest").requiredOption("--id <id>")).action(withClient(async (client, opts) => client.requestJson("POST", `/v1/images/${opts.id}/attest`, { accepted: true })));
-  const templates = program2.command("templates").description("Create and manage Page Template drafts");
+  const templates = program.command("templates").description("Create and manage Page Template drafts");
   jsonOption(templates.command("list")).action(withClient(async (client) => client.listTemplates()));
   jsonOption(templates.command("get").requiredOption("--id <id>")).action(withClient(async (client, opts) => client.getTemplate(String(opts.id))));
   jsonOption(templates.command("create-draft").requiredOption("--file <path>")).action(withClient(async (client, opts) => client.createDraft(JSON.parse(await readFile(String(opts.file), "utf8")))));
@@ -35398,16 +33282,33 @@ function buildV1Cli() {
   jsonOption(templates.command("archive").requiredOption("--id <id>")).action(withClient(async (client, opts) => client.archiveDraft(String(opts.id))));
   jsonOption(templates.command("restore").requiredOption("--id <id>")).action(withClient(async (client, opts) => client.restoreDraft(String(opts.id))));
   jsonOption(templates.command("delete").requiredOption("--id <id>")).action(withClient(async (client, opts) => client.deleteDraft(String(opts.id))));
-  const icons = program2.command("icons").description("Search the internal safe icon catalog");
+  const families = templates.command("families").description("Layout Family (multi-platform template identity)");
+  jsonOption(families.command("get").requiredOption("--id <id>")).action(withClient(async (client, opts) => client.getTemplateFamily(String(opts.id))));
+  jsonOption(families.command("derive").requiredOption("--id <id>").option("--presets <list>", "Comma-separated presets e.g. 4:5,9:16")).action(withClient(async (client, opts) => {
+    const presets = typeof opts.presets === "string" && opts.presets.trim() ? String(opts.presets).split(",").map((item) => item.trim()).filter(Boolean) : void 0;
+    return client.deriveTemplateFamily(String(opts.id), { presets });
+  }));
+  jsonOption(families.command("migrate-legacy").description("Wrap pages missing familyId into single-variant families")).action(withClient(async (client) => client.migrateLegacyTemplateFamilies()));
+  const icons = program.command("icons").description("Search the internal safe icon catalog");
   jsonOption(icons.command("search").requiredOption("--query <query>")).action(withClient(async (client, opts) => client.searchIcons({ query: String(opts.query) })));
   jsonOption(icons.command("get").requiredOption("--id <id>").requiredOption("--idempotency-key <key>")).action(withClient(async (client, opts) => client.getIcon({ iconId: String(opts.id), idempotencyKey: String(opts.idempotencyKey) })));
-  const slideshows = program2.command("slideshows").description("Create and render temporary Slideshow Runs");
-  jsonOption(slideshows.command("create").requiredOption("--file <path>")).action(withClient(async (client, opts) => client.createSlideshowRun(JSON.parse(await readFile(String(opts.file), "utf8")))));
+  const slideshows = program.command("slideshows").description("List, create, update and render Slideshow Runs");
+  jsonOption(slideshows.command("list").option("--q <text>").option("--platform <platform>").option("--profile-id <id>").option("--content-slug <slug>").option("--status <status>")).action(withClient(async (client, opts) => client.listSlideshowRuns({
+    q: opts.q ? String(opts.q) : void 0,
+    platform: opts.platform ? String(opts.platform) : void 0,
+    profileId: opts.profileId ? String(opts.profileId) : void 0,
+    contentSlug: opts.contentSlug ? String(opts.contentSlug) : void 0,
+    status: opts.status ? String(opts.status) : void 0
+  })));
+  jsonOption(slideshows.command("create").requiredOption("--file <path>")).action(withClient(async (client, opts) => client.createSlideshowRun({ pack: JSON.parse(await readFile(String(opts.file), "utf8")) })));
   jsonOption(slideshows.command("get").requiredOption("--id <id>")).action(withClient(async (client, opts) => client.getSlideshowRun(String(opts.id))));
   jsonOption(slideshows.command("update").requiredOption("--id <id>").requiredOption("--file <path>")).action(withClient(async (client, opts) => client.updateSlideshowRun(String(opts.id), JSON.parse(await readFile(String(opts.file), "utf8")))));
+  jsonOption(slideshows.command("archive").requiredOption("--id <id>")).action(withClient(async (client, opts) => client.archiveSlideshowRun(String(opts.id))));
+  jsonOption(slideshows.command("restore").requiredOption("--id <id>")).action(withClient(async (client, opts) => client.restoreSlideshowRun(String(opts.id))));
+  jsonOption(slideshows.command("delete").requiredOption("--id <id>")).action(withClient(async (client, opts) => client.trashSlideshowRun(String(opts.id))));
   jsonOption(slideshows.command("render").requiredOption("--id <id>").requiredOption("--idempotency-key <key>")).action(withClient(async (client, opts) => client.renderSlideshowRun(String(opts.id), { outputFormats: ["png"], idempotencyKey: String(opts.idempotencyKey) })));
   jsonOption(slideshows.command("export").requiredOption("--id <id>").requiredOption("--output <path>")).action(withClient(async (client, opts) => exportSlideshowRun(client, String(opts.id), String(opts.output))));
-  const renders = program2.command("renders").description("Inspect final render jobs");
+  const renders = program.command("renders").description("Inspect final render jobs");
   jsonOption(renders.command("create-asset").requiredOption("--file <path>").requiredOption("--idempotency-key <key>")).action(withClient(async (client, opts) => {
     const fileName = String(opts.file);
     const bytes = await readFile(fileName);
@@ -35431,7 +33332,7 @@ function buildV1Cli() {
   jsonOption(renders.command("manifest").requiredOption("--id <id>")).action(withClient(async (client, opts) => client.getRenderManifest(String(opts.id))));
   jsonOption(renders.command("wait").requiredOption("--id <id>")).action(withClient(async (client, opts) => client.pollRenderJob(String(opts.id))));
   jsonOption(renders.command("export").requiredOption("--id <id>").requiredOption("--output <path>")).action(withClient(async (client, opts) => exportManifest(client, String(opts.id), String(opts.output))));
-  const mcp = program2.command("mcp").description("Install and run the unified EasySociable MCP server");
+  const mcp = program.command("mcp").description("Install and run the unified EasySociable MCP server");
   jsonOption(mcp.command("install").requiredOption("--host <host>", "codex, claude, hermes, or openclaw").option("--config-path <path>")).action((...args) => {
     const command = args.at(-1);
     const opts = command.opts();
@@ -35444,12 +33345,12 @@ function buildV1Cli() {
     const { serveUnifiedStdioMcp: serveUnifiedStdioMcp2 } = await Promise.resolve().then(() => (init_v1_mcp(), v1_mcp_exports));
     await serveUnifiedStdioMcp2(clientFromEnv());
   });
-  return program2;
+  return program;
 }
 async function runV1Cli(argv = process.argv) {
-  const program2 = buildV1Cli();
+  const program = buildV1Cli();
   try {
-    await program2.parseAsync(argv);
+    await program.parseAsync(argv);
     return 0;
   } catch (error52) {
     process.stderr.write(`${error52 instanceof Error ? error52.message : String(error52)}