@drip-apex/apex-cli 0.16.0 → 0.18.0

package/dist/cli.js

@@ -127,11 +127,11 @@ var require_argument = __commonJS({
       /**
        * @package
        */
-      _concatValue(value, previous) {
+      _concatValue(value2, previous) {
         if (previous === this.defaultValue || !Array.isArray(previous)) {
-          return [value];
+          return [value2];
         }
-        return previous.concat(value);
+        return previous.concat(value2);
       }
       /**
        * Set the default value, and optionally supply the description to be displayed in the help.
@@ -140,8 +140,8 @@ var require_argument = __commonJS({
        * @param {string} [description]
        * @return {Argument}
        */
-      default(value, description) {
-        this.defaultValue = value;
+      default(value2, description) {
+        this.defaultValue = value2;
         this.defaultValueDescription = description;
         return this;
       }
@@ -815,8 +815,8 @@ var require_option = __commonJS({
        * @param {string} [description]
        * @return {Option}
        */
-      default(value, description) {
-        this.defaultValue = value;
+      default(value2, description) {
+        this.defaultValue = value2;
         this.defaultValueDescription = description;
         return this;
       }
@@ -917,11 +917,11 @@ var require_option = __commonJS({
       /**
        * @package
        */
-      _concatValue(value, previous) {
+      _concatValue(value2, previous) {
         if (previous === this.defaultValue || !Array.isArray(previous)) {
-          return [value];
+          return [value2];
         }
-        return previous.concat(value);
+        return previous.concat(value2);
       }
       /**
        * Only allow option value to be one of choices.
@@ -1004,7 +1004,7 @@ var require_option = __commonJS({
             this.positiveOptions.set(option.attributeName(), option);
           }
         });
-        this.negativeOptions.forEach((value, key) => {
+        this.negativeOptions.forEach((value2, key) => {
           if (this.positiveOptions.has(key)) {
             this.dualOptions.add(key);
           }
@@ -1017,12 +1017,12 @@ var require_option = __commonJS({
        * @param {Option} option
        * @returns {boolean}
        */
-      valueFromOption(value, option) {
+      valueFromOption(value2, 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);
+        return option.negate === (negativeValue === value2);
       }
     };
     function camelcase(str) {
@@ -1159,8 +1159,8 @@ var require_command = __commonJS({
   "node_modules/commander/lib/command.js"(exports2) {
     var EventEmitter = require("node:events").EventEmitter;
     var childProcess2 = require("node:child_process");
-    var path26 = require("node:path");
-    var fs30 = require("node:fs");
+    var path27 = require("node:path");
+    var fs31 = require("node:fs");
     var process16 = require("node:process");
     var { Argument: Argument2, humanReadableArgName } = require_argument();
     var { CommanderError: CommanderError2 } = require_error();
@@ -1650,9 +1650,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @param {string} invalidArgumentMessage
        * @private
        */
-      _callParseArg(target, value, previous, invalidArgumentMessage) {
+      _callParseArg(target, value2, previous, invalidArgumentMessage) {
         try {
-          return target.parseArg(value, previous);
+          return target.parseArg(value2, previous);
         } catch (err) {
           if (err.code === "commander.invalidArgument") {
             const message = `${invalidArgumentMessage} ${err.message}`;
@@ -1937,8 +1937,8 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @param {object} value
        * @return {Command} `this` command for chaining
        */
-      setOptionValue(key, value) {
-        return this.setOptionValueWithSource(key, value, void 0);
+      setOptionValue(key, value2) {
+        return this.setOptionValueWithSource(key, value2, void 0);
       }
       /**
        * Store option value and where the value came from.
@@ -1948,11 +1948,11 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @param {string} source - expected values are default/config/env/cli/implied
        * @return {Command} `this` command for chaining
        */
-      setOptionValueWithSource(key, value, source) {
+      setOptionValueWithSource(key, value2, source) {
         if (this._storeOptionsAsProperties) {
-          this[key] = value;
+          this[key] = value2;
         } else {
-          this._optionValues[key] = value;
+          this._optionValues[key] = value2;
         }
         this._optionValueSources[key] = source;
         return this;
@@ -2141,7 +2141,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @param {string} subcommandName
        */
       _checkForMissingExecutable(executableFile, executableDir, subcommandName) {
-        if (fs30.existsSync(executableFile)) return;
+        if (fs31.existsSync(executableFile)) return;
         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 '${subcommandName}' is not meant to be an executable command, remove description parameter from '.command()' and use '.description()' instead
@@ -2159,11 +2159,11 @@ Expecting one of '${allowedValues.join("', '")}'`);
         let launchWithNode = false;
         const sourceExt = [".js", ".ts", ".tsx", ".mjs", ".cjs"];
         function findFile(baseDir, baseName) {
-          const localBin = path26.resolve(baseDir, baseName);
-          if (fs30.existsSync(localBin)) return localBin;
-          if (sourceExt.includes(path26.extname(baseName))) return void 0;
+          const localBin = path27.resolve(baseDir, baseName);
+          if (fs31.existsSync(localBin)) return localBin;
+          if (sourceExt.includes(path27.extname(baseName))) return void 0;
           const foundExt = sourceExt.find(
-            (ext) => fs30.existsSync(`${localBin}${ext}`)
+            (ext) => fs31.existsSync(`${localBin}${ext}`)
           );
           if (foundExt) return `${localBin}${foundExt}`;
           return void 0;
@@ -2175,21 +2175,21 @@ Expecting one of '${allowedValues.join("', '")}'`);
         if (this._scriptPath) {
           let resolvedScriptPath;
           try {
-            resolvedScriptPath = fs30.realpathSync(this._scriptPath);
+            resolvedScriptPath = fs31.realpathSync(this._scriptPath);
           } catch {
             resolvedScriptPath = this._scriptPath;
           }
-          executableDir = path26.resolve(
-            path26.dirname(resolvedScriptPath),
+          executableDir = path27.resolve(
+            path27.dirname(resolvedScriptPath),
             executableDir
           );
         }
         if (executableDir) {
           let localFile = findFile(executableDir, executableFile);
           if (!localFile && !subcommand._executableFile && this._scriptPath) {
-            const legacyName = path26.basename(
+            const legacyName = path27.basename(
               this._scriptPath,
-              path26.extname(this._scriptPath)
+              path27.extname(this._scriptPath)
             );
             if (legacyName !== this._name) {
               localFile = findFile(
@@ -2200,7 +2200,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
           }
           executableFile = localFile || executableFile;
         }
-        launchWithNode = sourceExt.includes(path26.extname(executableFile));
+        launchWithNode = sourceExt.includes(path27.extname(executableFile));
         let proc;
         if (process16.platform !== "win32") {
           if (launchWithNode) {
@@ -2335,13 +2335,13 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @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()}'.`;
+        const myParseArg = (argument, value2, previous) => {
+          let parsedValue = value2;
+          if (value2 !== null && argument.parseArg) {
+            const invalidValueMessage = `error: command-argument value '${value2}' is invalid for argument '${argument.name()}'.`;
             parsedValue = this._callParseArg(
               argument,
-              value,
+              value2,
               previous,
               invalidValueMessage
             );
@@ -2351,25 +2351,25 @@ Expecting one of '${allowedValues.join("', '")}'`);
         this._checkNumberOfArguments();
         const processedArgs = [];
         this.registeredArguments.forEach((declaredArg, index) => {
-          let value = declaredArg.defaultValue;
+          let value2 = declaredArg.defaultValue;
           if (declaredArg.variadic) {
             if (index < this.args.length) {
-              value = this.args.slice(index);
+              value2 = this.args.slice(index);
               if (declaredArg.parseArg) {
-                value = value.reduce((processed, v) => {
+                value2 = value2.reduce((processed, v) => {
                   return myParseArg(declaredArg, v, processed);
                 }, declaredArg.defaultValue);
               }
-            } else if (value === void 0) {
-              value = [];
+            } else if (value2 === void 0) {
+              value2 = [];
             }
           } else if (index < this.args.length) {
-            value = this.args[index];
+            value2 = this.args[index];
             if (declaredArg.parseArg) {
-              value = myParseArg(declaredArg, value, declaredArg.defaultValue);
+              value2 = myParseArg(declaredArg, value2, declaredArg.defaultValue);
             }
           }
-          processedArgs[index] = value;
+          processedArgs[index] = value2;
         });
         this.processedArgs = processedArgs;
       }
@@ -2626,15 +2626,15 @@ Expecting one of '${allowedValues.join("', '")}'`);
             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);
+                const value2 = args.shift();
+                if (value2 === void 0) this.optionMissingArgument(option);
+                this.emit(`option:${option.name()}`, value2);
               } else if (option.optional) {
-                let value = null;
+                let value2 = null;
                 if (args.length > 0 && !maybeOption(args[0])) {
-                  value = args.shift();
+                  value2 = args.shift();
                 }
-                this.emit(`option:${option.name()}`, value);
+                this.emit(`option:${option.name()}`, value2);
               } else {
                 this.emit(`option:${option.name()}`);
               }
@@ -3047,7 +3047,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @return {Command}
        */
       nameFromFilename(filename) {
-        this._name = path26.basename(filename, path26.extname(filename));
+        this._name = path27.basename(filename, path27.extname(filename));
         return this;
       }
       /**
@@ -3061,9 +3061,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @param {string} [path]
        * @return {(string|null|Command)}
        */
-      executableDir(path27) {
-        if (path27 === void 0) return this._executableDir;
-        this._executableDir = path27;
+      executableDir(path28) {
+        if (path28 === void 0) return this._executableDir;
+        this._executableDir = path28;
         return this;
       }
       /**
@@ -3427,12 +3427,12 @@ function assembleStyles() {
           green = Math.floor(remainder / 6) / 5;
           blue = remainder % 6 / 5;
         }
-        const value = Math.max(red, green, blue) * 2;
-        if (value === 0) {
+        const value2 = Math.max(red, green, blue) * 2;
+        if (value2 === 0) {
           return 30;
         }
         let result = 30 + (Math.round(blue) << 2 | Math.round(green) << 1 | Math.round(red));
-        if (value === 2) {
+        if (value2 === 2) {
           result += 60;
         }
         return result;
@@ -6295,22 +6295,22 @@ var init_ora = __esm({
       get text() {
         return this.#text;
       }
-      set text(value = "") {
-        this.#text = value;
+      set text(value2 = "") {
+        this.#text = value2;
         this.#updateLineCount();
       }
       get prefixText() {
         return this.#prefixText;
       }
-      set prefixText(value = "") {
-        this.#prefixText = value;
+      set prefixText(value2 = "") {
+        this.#prefixText = value2;
         this.#updateLineCount();
       }
       get suffixText() {
         return this.#suffixText;
       }
-      set suffixText(value = "") {
-        this.#suffixText = value;
+      set suffixText(value2 = "") {
+        this.#suffixText = value2;
         this.#updateLineCount();
       }
       get isSpinning() {
@@ -6347,20 +6347,20 @@ var init_ora = __esm({
       get isEnabled() {
         return this.#isEnabled && !this.#isSilent;
       }
-      set isEnabled(value) {
-        if (typeof value !== "boolean") {
+      set isEnabled(value2) {
+        if (typeof value2 !== "boolean") {
           throw new TypeError("The `isEnabled` option must be a boolean");
         }
-        this.#isEnabled = value;
+        this.#isEnabled = value2;
       }
       get isSilent() {
         return this.#isSilent;
       }
-      set isSilent(value) {
-        if (typeof value !== "boolean") {
+      set isSilent(value2) {
+        if (typeof value2 !== "boolean") {
           throw new TypeError("The `isSilent` option must be a boolean");
         }
-        this.#isSilent = value;
+        this.#isSilent = value2;
       }
       frame() {
         const now = Date.now();
@@ -6613,7 +6613,7 @@ var init_wsl_utils = __esm({
 
 // node_modules/define-lazy-prop/index.js
 function defineLazyProperty(object, propertyName, valueGetter) {
-  const define = (value) => Object.defineProperty(object, propertyName, { value, enumerable: true, writable: true });
+  const define = (value2) => Object.defineProperty(object, propertyName, { value: value2, enumerable: true, writable: true });
   Object.defineProperty(object, propertyName, {
     configurable: true,
     enumerable: true,
@@ -6622,8 +6622,8 @@ function defineLazyProperty(object, propertyName, valueGetter) {
       define(result);
       return result;
     },
-    set(value) {
-      define(value);
+    set(value2) {
+      define(value2);
     }
   });
   return object;
@@ -7092,8 +7092,8 @@ var import_node_crypto2 = require("node:crypto");
 var import_node_crypto = require("node:crypto");
 var invocationId = (0, import_node_crypto.randomUUID)();
 var identity;
-function setClientIdentity(value) {
-  identity = { ...value, invocationId };
+function setClientIdentity(value2) {
+  identity = { ...value2, invocationId };
 }
 function getClientIdentity() {
   return identity ? { ...identity } : void 0;
@@ -7124,7 +7124,7 @@ function extractErrorDetails(json) {
   if (!json) return void 0;
   const nested = json.error && typeof json.error === "object" && !Array.isArray(json.error) ? json.error : null;
   const code = typeof json.code === "string" ? json.code : typeof nested?.code === "string" ? nested.code : void 0;
-  for (const value of [json.details, json.meta, nested?.details]) if (value && typeof value === "object" && !Array.isArray(value)) return { ...value, ...code ? { code } : {} };
+  for (const value2 of [json.details, json.meta, nested?.details]) if (value2 && typeof value2 === "object" && !Array.isArray(value2)) return { ...value2, ...code ? { code } : {} };
   const details = Object.fromEntries(["limit", "current", "max", "actual", "field", "code"].filter((key) => key in json).map((key) => [key, json[key]]));
   if (code) details.code = code;
   return Object.keys(details).length ? details : void 0;
@@ -7133,23 +7133,23 @@ var warnedAboutVersionSkew = false;
 function createHttpClient(creds, options) {
   const warn3 = options.warn ?? ((message) => process.stderr.write(message));
   function inspectVersion(headers) {
-    const value = headers.get(APEX_API_VERSION_HEADER);
-    if (!value || warnedAboutVersionSkew) return;
-    const version = Number(value);
+    const value2 = headers.get(APEX_API_VERSION_HEADER);
+    if (!value2 || warnedAboutVersionSkew) return;
+    const version = Number(value2);
     if (!Number.isFinite(version) || version === Number(SUPPORTED_APEX_API_VERSION)) return;
     warnedAboutVersionSkew = true;
     warn3(version > 1 ? "CLI is behind the server \u2014 update.\n" : "Server API is older than this CLI supports.\n");
   }
-  async function request2(method, path26, body5, requestTimeoutMs, form = false, requestOptions) {
+  async function request2(method, path27, body5, requestTimeoutMs, form = false, requestOptions) {
     const started2 = performance.now();
     const observe = (status4, requestId2, errorCode, responseHeaders) => {
       const semver = (name) => {
-        const value = responseHeaders?.get(name) ?? void 0;
-        return value && /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/.test(value) ? value : void 0;
+        const value2 = responseHeaders?.get(name) ?? void 0;
+        return value2 && /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/.test(value2) ? value2 : void 0;
       };
       const serverTiming = responseHeaders?.get("server-timing");
       try {
-        options.onResponse?.({ method, path: path26, status: status4, requestId: requestId2, errorCode: typeof errorCode === "string" ? errorCode : void 0, durationMs: Math.max(0, Math.round(performance.now() - started2)), serverTiming: serverTiming?.slice(0, 300) || void 0, cliLatest: semver("x-apex-cli-latest"), cliMinimum: semver("x-apex-cli-minimum") });
+        options.onResponse?.({ method, path: path27, status: status4, requestId: requestId2, errorCode: typeof errorCode === "string" ? errorCode : void 0, durationMs: Math.max(0, Math.round(performance.now() - started2)), serverTiming: serverTiming?.slice(0, 300) || void 0, cliLatest: semver("x-apex-cli-latest"), cliMinimum: semver("x-apex-cli-minimum") });
       } catch {
       }
     };
@@ -7165,7 +7165,7 @@ function createHttpClient(creds, options) {
       if (creds.resolvedContext?.orgId) headers["X-Apex-Org"] = creds.resolvedContext.orgId;
       if (creds.resolvedContext?.shopId) headers["X-Apex-Shop"] = creds.resolvedContext.shopId;
     }
-    const mock = options.transport?.(method, path26, body5, headers);
+    const mock = options.transport?.(method, path27, body5, headers);
     if (mock !== void 0) {
       const version = options.testTransportVersion?.();
       if (version) inspectVersion(new Headers({ [APEX_API_VERSION_HEADER]: version }));
@@ -7174,7 +7174,7 @@ function createHttpClient(creds, options) {
     }
     let response;
     try {
-      response = await fetch(`${creds.baseUrl}${path26}`, { method, headers, body: form ? body5 : body5 ? JSON.stringify(body5) : void 0, signal: AbortSignal.timeout(timeoutMs) });
+      response = await fetch(`${creds.baseUrl}${path27}`, { method, headers, body: form ? body5 : body5 ? JSON.stringify(body5) : void 0, signal: AbortSignal.timeout(timeoutMs) });
     } catch (error) {
       const outer = error && typeof error === "object" ? error : void 0;
       const nested = outer?.cause && typeof outer.cause === "object" ? outer.cause : void 0;
@@ -7195,7 +7195,7 @@ function createHttpClient(creds, options) {
     if (!response.ok) return { ok: false, status: response.status, data: json, error: extractErrorMessage(json, response.status), errorDetails: extractErrorDetails(json), requestId, retryAfter: response.headers.get("retry-after"), rateLimit: { limit: response.headers.get("x-ratelimit-limit"), remaining: response.headers.get("x-ratelimit-remaining"), reset: response.headers.get("x-ratelimit-reset") } };
     return { ok: true, status: response.status, data: json };
   }
-  return { request: (method, path26, body5, timeoutMs, requestOptions) => request2(method, path26, body5, timeoutMs, false, requestOptions), requestForm: (method, path26, body5) => request2(method, path26, body5, void 0, true) };
+  return { request: (method, path27, body5, timeoutMs, requestOptions) => request2(method, path27, body5, timeoutMs, false, requestOptions), requestForm: (method, path27, body5) => request2(method, path27, body5, void 0, true) };
 }
 
 // ../api-client/src/credentials.ts
@@ -7286,18 +7286,18 @@ function compareVersions(left, right) {
 }
 function readCache() {
   try {
-    const value = JSON.parse((0, import_node_fs2.readFileSync)(cachePath(), "utf8"));
-    return value && typeof value === "object" ? value : {};
+    const value2 = JSON.parse((0, import_node_fs2.readFileSync)(cachePath(), "utf8"));
+    return value2 && typeof value2 === "object" ? value2 : {};
   } catch {
     return {};
   }
 }
 function writeCache(patch, remove5 = []) {
   try {
-    const value = { ...readCache(), ...patch };
-    for (const key of remove5) delete value[key];
+    const value2 = { ...readCache(), ...patch };
+    for (const key of remove5) delete value2[key];
     (0, import_node_fs2.mkdirSync)(import_node_path2.default.dirname(cachePath()), { recursive: true });
-    (0, import_node_fs2.writeFileSync)(cachePath(), JSON.stringify(value), { mode: 384 });
+    (0, import_node_fs2.writeFileSync)(cachePath(), JSON.stringify(value2), { mode: 384 });
   } catch {
   }
 }
@@ -7362,7 +7362,7 @@ function clearUpdateCache() {
 function currentUpdateState(current, minimumOverride) {
   if (minimumOverride && versionParts(minimumOverride))
     recordServerCliPolicy({ cliMinimum: minimumOverride });
-  const latest = [npmLatest, serverLatest, serverMinimum, current].filter((value) => Boolean(value)).reduce((highest, value) => compareVersions(value, highest) > 0 ? value : highest, current);
+  const latest = [npmLatest, serverLatest, serverMinimum, current].filter((value2) => Boolean(value2)).reduce((highest, value2) => compareVersions(value2, highest) > 0 ? value2 : highest, current);
   const minimum = serverMinimum;
   const required = Boolean(minimum && compareVersions(current, minimum) < 0);
   if (!required && process.env.APEX_NO_UPDATE_CHECK === "1") return;
@@ -7423,7 +7423,7 @@ async function checkForUpdate(current) {
 // package.json
 var package_default = {
   name: "@drip-apex/apex-cli",
-  version: "0.16.0",
+  version: "0.18.0",
   license: "MIT",
   description: "Apex CLI for managing experiments, approved roadmap ideas, and draft workspaces.",
   private: false,
@@ -7771,8 +7771,8 @@ process.on?.("beforeExit", writePendingUpdateNotice);
 function minimumFromError(error, reason2) {
   if (reason2 !== "cli_upgrade_required") return;
   const api = error.api?.body;
-  const value = error.details?.minimum ?? api?.error?.details?.minimum;
-  return typeof value === "string" ? value : void 0;
+  const value2 = error.details?.minimum ?? api?.error?.details?.minimum;
+  return typeof value2 === "string" ? value2 : void 0;
 }
 async function handleCliError(err, command) {
   if (err && typeof err === "object" && "exitCode" in err && err.exitCode === 0) {
@@ -7907,6 +7907,13 @@ function errorNextSteps(error) {
       command: error.details.retry,
       why: "Review the requested action before retrying."
     });
+  const body5 = error.api?.body;
+  const next = body5?.error?.next ?? body5?.next;
+  if (reason2 === "page_required")
+    steps.push({
+      command: "apex pages list",
+      why: typeof next === "string" ? next : "Click goals need a page: pass --page-id <page ID> or --page <page ID or key> (list pages with apex pages list)"
+    });
   const hints = error.details?.next_steps;
   if (Array.isArray(hints))
     for (const hint of hints) {
@@ -7920,6 +7927,8 @@ function errorNextSteps(error) {
       command: "apex experiments plan",
       why: "Correct the reported blocking issues, then validate the folder again."
     });
+  if (steps.length === 0 && typeof next === "string" && next)
+    steps.push({ command: "see next", why: next });
   return steps;
 }
 
@@ -8384,9 +8393,9 @@ var staticRouteSegments = /* @__PURE__ */ new Set([
   "webhooks",
   "workspace"
 ]);
-function normalizeRoute(path26) {
-  if (!path26.startsWith("/api/")) return ":route";
-  const parts = path26.split(/[?#]/, 1)[0].split("/");
+function normalizeRoute(path27) {
+  if (!path27.startsWith("/api/")) return ":route";
+  const parts = path27.split(/[?#]/, 1)[0].split("/");
   const files = parts.indexOf("files");
   if (files !== -1 && parts.length > files + 1) parts.splice(files + 1, parts.length, ":id");
   return parts.map((part) => !part || staticRouteSegments.has(part) ? part : ":id").join("/");
@@ -8438,19 +8447,19 @@ function classifyError(exitCode, error, status4) {
 function redactAttempted(token) {
   return /^(?:apx_|sk_|pk_|rk_|ghp_|gho_|xox|Bearer)/.test(token) || /^[A-Za-z0-9_-]{24,}$/.test(token) || /:\/\/|[/\\@=]/.test(token) || token.length > 40 ? "(redacted)" : token;
 }
-function normalizeErrorCode(value, exitCode) {
-  const normalized = value.toLowerCase();
+function normalizeErrorCode(value2, exitCode) {
+  const normalized = value2.toLowerCase();
   return normalized.length <= 64 && /^[a-z0-9._-]+$/.test(normalized) ? normalized : `exit_${exitCode}`;
 }
 function invocationErrorCode(exitCode, error, commanderExit) {
   if (exitCode === 0) return void 0;
-  let value = firstError?.errorCode;
-  if (!value && firstError)
-    value = firstError.status === 410 ? "gone" : `http_${firstError.status}`;
+  let value2 = firstError?.errorCode;
+  if (!value2 && firstError)
+    value2 = firstError.status === 410 ? "gone" : `http_${firstError.status}`;
   const detail5 = error && typeof error === "object" ? error : {};
-  if (!value && typeof detail5.details?.reason === "string" && !detail5.api) {
+  if (!value2 && typeof detail5.details?.reason === "string" && !detail5.api) {
     const reason2 = detail5.details.reason.toLowerCase();
-    value = [
+    value2 = [
       "network",
       "dns",
       "timeout",
@@ -8461,20 +8470,20 @@ function invocationErrorCode(exitCode, error, commanderExit) {
       "unknown"
     ].includes(reason2) ? `network_${reason2}` : reason2 || void 0;
   }
-  if (!value && commanderExit && typeof detail5.code === "string")
-    value = detail5.code.slice("commander.".length).replace(/([a-z])([A-Z])/g, "$1_$2");
-  if (!value) {
+  if (!value2 && commanderExit && typeof detail5.code === "string")
+    value2 = detail5.code.slice("commander.".length).replace(/([a-z])([A-Z])/g, "$1_$2");
+  if (!value2) {
     const apiCode = detail5.api?.body?.code ?? detail5.api?.body?.error?.code ?? detail5.details?.code;
-    if (typeof apiCode === "string" && apiCode) value = apiCode;
-    else if (detail5.api?.status === 401 || exitCode === 2) value = "auth_required";
-    else if (detail5.api?.status === 403) value = "auth_forbidden";
-    else if (detail5.api?.status === 404) value = "not_found";
-    else if (detail5.api?.status === 429) value = "rate_limited";
-    else if (detail5.api?.status === 409 || exitCode === 5) value = "conflict";
-    else if (exitCode === 4) value = "confirmation_required";
-    else if (exitCode === 3) value = "validation_failed";
+    if (typeof apiCode === "string" && apiCode) value2 = apiCode;
+    else if (detail5.api?.status === 401 || exitCode === 2) value2 = "auth_required";
+    else if (detail5.api?.status === 403) value2 = "auth_forbidden";
+    else if (detail5.api?.status === 404) value2 = "not_found";
+    else if (detail5.api?.status === 429) value2 = "rate_limited";
+    else if (detail5.api?.status === 409 || exitCode === 5) value2 = "conflict";
+    else if (exitCode === 4) value2 = "confirmation_required";
+    else if (exitCode === 3) value2 = "validation_failed";
   }
-  return normalizeErrorCode(value ?? `exit_${exitCode}`, exitCode);
+  return normalizeErrorCode(value2 ?? `exit_${exitCode}`, exitCode);
 }
 async function finishInvocation({
   exitCode: rawExitCode,
@@ -8563,8 +8572,8 @@ function pagePath(id, action78) {
   return `/api/v1/landing-pages/${encodeURIComponent(id)}${action78 ? `/${action78}` : ""}`;
 }
 function landingPagesApi(request2) {
-  const call = async (method, path26, body5) => {
-    const response = await request2(method, path26, body5);
+  const call = async (method, path27, body5) => {
+    const response = await request2(method, path27, body5);
     return { ...response, data: response.data?.data };
   };
   return {
@@ -8650,6 +8659,19 @@ function validateLandingPageLocalFiles(files) {
 }
 
 // src/api.ts
+function lookupCommerceCatalog(creds, params) {
+  const query = new URLSearchParams();
+  if (params.query) query.set("q", params.query);
+  if (params.handle) query.set("handle", params.handle);
+  if (params.product_id) query.set("product_id", params.product_id);
+  if (params.cursor) query.set("cursor", params.cursor);
+  if (params.limit !== void 0) query.set("limit", String(params.limit));
+  return request(
+    creds,
+    "GET",
+    `/api/v1/commerce/catalog${query.size ? `?${query}` : ""}`
+  );
+}
 function simulateTriggers(creds, body5) {
   return request(creds, "POST", "/api/v1/tracking/simulate-trigger", body5);
 }
@@ -8673,11 +8695,11 @@ function getUserKeyIdentity(creds) {
 function getAccountContext(creds) {
   return userRequest(creds, "GET", "/api/v1/me/context");
 }
-function userRequest(creds, method, path26, body5) {
+function userRequest(creds, method, path27, body5) {
   return request(
     { ...creds, apiKey: creds.userApiKey ?? "", baseUrl: creds.userBaseUrl ?? creds.baseUrl },
     method,
-    path26,
+    path27,
     body5
   );
 }
@@ -8763,10 +8785,10 @@ function sharedClient(creds) {
   }
   return client;
 }
-async function request(creds, method, path26, body5, requestTimeoutMs, options) {
+async function request(creds, method, path27, body5, requestTimeoutMs, options) {
   const response = await sharedClient(creds).request(
     method,
-    path26,
+    path27,
     body5,
     requestTimeoutMs,
     options
@@ -8774,8 +8796,8 @@ async function request(creds, method, path26, body5, requestTimeoutMs, options)
   recordApiResponse(response);
   return response;
 }
-async function requestForm(creds, method, path26, body5) {
-  const response = await sharedClient(creds).requestForm(method, path26, body5);
+async function requestForm(creds, method, path27, body5) {
+  const response = await sharedClient(creds).requestForm(method, path27, body5);
   recordApiResponse(response);
   return response;
 }
@@ -9299,6 +9321,17 @@ function getAdminQuarantine(creds) {
     "/api/v1/admin/tracking/quarantine"
   );
 }
+function getAdminShopSettings(creds, shopRef) {
+  return request(
+    userCredentials(creds),
+    "GET",
+    `/api/v1/admin/shops/${encodeURIComponent(shopRef)}/settings`
+  );
+}
+function setAdminShopSetting(creds, shopId, body5) {
+  const pinned = { ...userCredentials(creds), resolvedContext: { shopId } };
+  return request(pinned, "PATCH", `/api/v1/admin/shops/${encodeURIComponent(shopId)}/settings`, body5);
+}
 function archiveAdminShop(creds, shopId) {
   return request(
     userCredentials(creds),
@@ -9318,8 +9351,8 @@ function requestTargetingResource(creds, method, kind5, id, body5, limit, cursor
   if (limit) params.set("limit", String(limit));
   if (cursor) params.set("cursor", cursor);
   const query = params.toString();
-  const path26 = `/api/v1/${kind5}${id ? `/${id.split("/").map(encodeURIComponent).join("/")}` : ""}${query ? `?${query}` : ""}`;
-  return request(creds, method, path26, body5);
+  const path27 = `/api/v1/${kind5}${id ? `/${id.split("/").map(encodeURIComponent).join("/")}` : ""}${query ? `?${query}` : ""}`;
+  return request(creds, method, path27, body5);
 }
 function managedPath(kind5, id, action78) {
   return `/api/v1/${kind5}${id ? `/${encodeURIComponent(id)}` : ""}${action78 ? `/${action78}` : ""}`;
@@ -9355,7 +9388,7 @@ function getConfigResource(creds, family, id) {
 }
 function landingPages(creds) {
   return landingPagesApi(
-    (method, path26, body5) => request(creds, method, path26, body5)
+    (method, path27, body5) => request(creds, method, path27, body5)
   );
 }
 function deleteAsset(creds, id) {
@@ -9597,29 +9630,36 @@ function moveAdminCustomerStores(creds, orgId, body5) {
     body5
   );
 }
+function getExperimentResultsByChannel(creds, id) {
+  return request(
+    creds,
+    "GET",
+    `/api/v1/experiments/${encodeURIComponent(id)}/results/by-channel`
+  );
+}
 
 // src/context.ts
 var import_node_readline = __toESM(require("node:readline"));
-function match(value, rows, kind5) {
-  const byId = rows.find((row) => row.id === value);
+function match(value2, rows, kind5) {
+  const byId = rows.find((row) => row.id === value2);
   if (byId) return byId;
-  const exact = rows.filter((row) => row.name.toLowerCase() === value.toLowerCase());
+  const exact = rows.filter((row) => row.name.toLowerCase() === value2.toLowerCase());
   if (exact.length === 1) return exact[0];
   if (exact.length > 1)
     throw new CliError(
-      `Ambiguous ${kind5} "${value}". Candidates: ${exact.map((row) => `${row.name} (${row.id})`).join(", ")}`,
+      `Ambiguous ${kind5} "${value2}". Candidates: ${exact.map((row) => `${row.name} (${row.id})`).join(", ")}`,
       EXIT_CODES.validation,
       { code: "ambiguous_context", candidates: exact.map(({ id, name }) => ({ id, name })) }
     );
-  const candidates = rows.filter((row) => row.name.toLowerCase().startsWith(value.toLowerCase()));
+  const candidates = rows.filter((row) => row.name.toLowerCase().startsWith(value2.toLowerCase()));
   if (candidates.length === 1) return candidates[0];
   if (candidates.length > 1)
     throw new CliError(
-      `Ambiguous ${kind5} "${value}". Candidates: ${candidates.map((row) => `${row.name} (${row.id})`).join(", ")}`,
+      `Ambiguous ${kind5} "${value2}". Candidates: ${candidates.map((row) => `${row.name} (${row.id})`).join(", ")}`,
       EXIT_CODES.validation,
       { code: "ambiguous_context", candidates: candidates.map(({ id, name }) => ({ id, name })) }
     );
-  throw new CliError(`Unknown ${kind5} "${value}".`, EXIT_CODES.validation);
+  throw new CliError(`Unknown ${kind5} "${value2}".`, EXIT_CODES.validation);
 }
 function resolveSelection(tree, input) {
   const [orgValue, shopValue, extra] = input.split("/");
@@ -10188,12 +10228,12 @@ var evidenceKinds = [
 ];
 
 // src/lib/experiment-handover.ts
-function summarizeHandoverQa(value) {
-  const record4 = (value2) => value2 !== null && typeof value2 === "object" && !Array.isArray(value2) ? value2 : {};
-  const qa3 = record4(value);
-  const run3 = record4(qa3.latestRun);
-  const summary = record4(run3.summary);
-  const count2 = (value2) => typeof value2 === "number" && Number.isInteger(value2) && value2 >= 0 ? value2 : null;
+function summarizeHandoverQa(value2) {
+  const record4 = (value3) => value3 !== null && typeof value3 === "object" && !Array.isArray(value3) ? value3 : {};
+  const qa3 = record4(value2);
+  const run4 = record4(qa3.latestRun);
+  const summary = record4(run4.summary);
+  const count2 = (value3) => typeof value3 === "number" && Number.isInteger(value3) && value3 >= 0 ? value3 : null;
   let requiredDone = count2(summary.completedRequired);
   let requiredTotal = count2(summary.required);
   if (requiredDone !== null && requiredTotal !== null && requiredDone > requiredTotal) {
@@ -10203,7 +10243,7 @@ function summarizeHandoverQa(value) {
   const blockers = Array.isArray(summary.blockers) && summary.blockers.every((item) => typeof item === "string") ? summary.blockers : null;
   const approvedAt = typeof qa3.qaApprovedAt === "string" ? Date.parse(qa3.qaApprovedAt) : Number.NaN;
   return {
-    run_status: typeof run3.status === "string" ? run3.status : null,
+    run_status: typeof run4.status === "string" ? run4.status : null,
     required_done: requiredDone,
     required_total: requiredTotal,
     blockers,
@@ -10276,13 +10316,13 @@ function deviceLabel(targeting) {
 var ALL_PAGES_LABEL = "All pages";
 var CHECKOUT_LABEL = "Checkout";
 var UNKNOWN_PAGE_NAME = "Saved Page";
-function isRecord(value) {
-  return Boolean(value && typeof value === "object" && !Array.isArray(value));
+function isRecord(value2) {
+  return Boolean(value2 && typeof value2 === "object" && !Array.isArray(value2));
 }
-function arrayOf(value) {
-  if (Array.isArray(value)) return value;
-  if (value === void 0 || value === null) return [];
-  return [value];
+function arrayOf(value2) {
+  if (Array.isArray(value2)) return value2;
+  if (value2 === void 0 || value2 === null) return [];
+  return [value2];
 }
 function ruleKey(rule) {
   if (typeof rule === "string") return JSON.stringify(["include", "simple", rule.trim(), ""]);
@@ -10360,11 +10400,11 @@ function classifyIdeaReference(reference) {
 
 // ../api-client/src/experiments.ts
 var ID_REFERENCE = /^(?:[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}|[1-9][0-9]{9})$/i;
-function isExperimentTestKey(value) {
-  return /^([A-Z0-9]{2,8})-(\d+)$/.test(value);
+function isExperimentTestKey(value2) {
+  return /^([A-Z0-9]{2,8})-(\d+)$/.test(value2);
 }
-function record(value) {
-  return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+function record(value2) {
+  return value2 && typeof value2 === "object" && !Array.isArray(value2) ? value2 : {};
 }
 async function resolveExperimentReference(request2, idOrSlug, variationRef) {
   const explicitSlug = idOrSlug.startsWith("slug:");
@@ -10448,9 +10488,9 @@ function summarizeResults(payload) {
     degraded: Object.values(degradedFlags).some(Boolean),
     degradedFlags,
     missingMetrics: [...missing],
-    warnings: Array.isArray(data.warnings) ? data.warnings.map((value) => ({
-      message: record(value).message,
-      value
+    warnings: Array.isArray(data.warnings) ? data.warnings.map((value2) => ({
+      message: record(value2).message,
+      value: value2
     })) : [],
     metrics: Array.isArray(data.metrics) ? data.metrics.map(record) : [],
     resultsWeekdays: data.results_weekdays,
@@ -10502,7 +10542,7 @@ function contentHash(bytes) {
   return import_node_crypto5.default.createHash("sha256").update(bytes).digest("hex");
 }
 function deliveryUrl(baseUrl, asset) {
-  const returnedUrl = asset.deliveryUrl ?? asset.delivery_url ?? asset.url;
+  const returnedUrl = asset.delivery_url ?? asset.deliveryUrl ?? asset.url;
   if (returnedUrl) return returnedUrl;
   const origin = new URL(baseUrl).origin;
   return `${origin}/api/assets/${encodeURIComponent(asset.id)}/file`;
@@ -10514,25 +10554,25 @@ function extensionForMimeType(mimeType) {
   const safeSubtype = subtype?.replace(/[^a-z0-9.+-]/g, "");
   return safeSubtype ? `.${safeSubtype}` : ".bin";
 }
-function dataUriFromMatch(value, match2) {
+function dataUriFromMatch(value2, match2) {
   let uri = match2[0];
   const start = match2.index ?? 0;
-  if (/url\(\s*$/i.test(value.slice(0, start))) {
+  if (/url\(\s*$/i.test(value2.slice(0, start))) {
     const closingParenthesis = uri.indexOf(")");
     if (closingParenthesis >= 0) uri = uri.slice(0, closingParenthesis);
   }
   return uri;
 }
-function surroundingNonWhitespaceNonQuoteRun(value, start, end) {
-  const before = value.slice(0, start).match(/[^\s"']*$/)?.[0] ?? "";
-  const after = value.slice(end).match(/^[^\s"']*/)?.[0] ?? "";
-  return `${before}${value.slice(start, end)}${after}`;
+function surroundingNonWhitespaceNonQuoteRun(value2, start, end) {
+  const before = value2.slice(0, start).match(/[^\s"']*$/)?.[0] ?? "";
+  const after = value2.slice(end).match(/^[^\s"']*/)?.[0] ?? "";
+  return `${before}${value2.slice(start, end)}${after}`;
 }
 function isInsideRange(start, end, ranges) {
   return ranges.some((range) => start >= range.start && end <= range.end);
 }
-function applyReplacements(value, replacements) {
-  let rewritten = value;
+function applyReplacements(value2, replacements) {
+  let rewritten = value2;
   for (const replacement of replacements.sort((a, b) => b.start - a.start)) {
     rewritten = rewritten.slice(0, replacement.start) + replacement.value + rewritten.slice(replacement.end);
   }
@@ -10563,9 +10603,9 @@ function createAssetReferenceRewriter(options) {
     }
     return pending;
   };
-  const rewrite = async (value, baseDir = options.baseDir) => {
-    if (options.enabled === false || !value) return value;
-    let rewritten = value;
+  const rewrite = async (value2, baseDir = options.baseDir) => {
+    if (options.enabled === false || !value2) return value2;
+    let rewritten = value2;
     const inlineMatches = [...rewritten.matchAll(DATA_IMAGE_URI_PATTERN)].map((match2) => ({ match: match2, uri: dataUriFromMatch(rewritten, match2) })).filter(({ uri }) => uri.length > INLINE_DATA_URI_MAX_CHARS);
     for (const { uri } of inlineMatches) {
       const commaIndex = uri.indexOf(",");
@@ -10640,26 +10680,134 @@ function createAssetReferenceRewriter(options) {
     }
     return applyReplacements(rewritten, bareReplacements);
   };
-  const rewriteUnknown = async (value, baseDir = options.baseDir) => {
-    if (typeof value === "string") return rewrite(value, baseDir);
-    if (Array.isArray(value)) {
-      return Promise.all(value.map((entry) => rewriteUnknown(entry, baseDir)));
+  const rewriteUnknown = async (value2, baseDir = options.baseDir) => {
+    if (typeof value2 === "string") return rewrite(value2, baseDir);
+    if (Array.isArray(value2)) {
+      return Promise.all(value2.map((entry) => rewriteUnknown(entry, baseDir)));
     }
-    if (value !== null && typeof value === "object") {
+    if (value2 !== null && typeof value2 === "object") {
       return Object.fromEntries(
         await Promise.all(
-          Object.entries(value).map(async ([key, entry]) => [
+          Object.entries(value2).map(async ([key, entry]) => [
             key,
             await rewriteUnknown(entry, baseDir)
           ])
         )
       );
     }
-    return value;
+    return value2;
   };
   return { rewrite, rewriteUnknown };
 }
 
+// src/lib/argv-encoding.ts
+var cp1252Characters = /* @__PURE__ */ new Map([
+  [8364, 128],
+  [8218, 130],
+  [402, 131],
+  [8222, 132],
+  [8230, 133],
+  [8224, 134],
+  [8225, 135],
+  [710, 136],
+  [8240, 137],
+  [352, 138],
+  [8249, 139],
+  [338, 140],
+  [381, 142],
+  [8216, 145],
+  [8217, 146],
+  [8220, 147],
+  [8221, 148],
+  [8226, 149],
+  [8211, 150],
+  [8212, 151],
+  [732, 152],
+  [8482, 153],
+  [353, 154],
+  [8250, 155],
+  [339, 156],
+  [382, 158],
+  [376, 159]
+]);
+function repairCp1252Mojibake(value2) {
+  if (!/[^\x00-\x7f]/.test(value2) || value2.includes("\uFFFD")) return null;
+  const bytes = [];
+  for (const character of value2) {
+    const codePoint = character.codePointAt(0);
+    const byte = codePoint <= 255 ? codePoint : cp1252Characters.get(codePoint);
+    if (byte === void 0) return null;
+    bytes.push(byte);
+  }
+  try {
+    const repaired = new TextDecoder("utf-8", { fatal: true }).decode(new Uint8Array(bytes));
+    return /[^\x00-\x7f]/.test(repaired) ? repaired : null;
+  } catch {
+    return null;
+  }
+}
+function argumentValues(argv) {
+  let precedingOption;
+  return argv.slice(2).map((token, offset) => {
+    const index = offset + 2;
+    const equals = token.startsWith("--") ? token.indexOf("=") : -1;
+    if (token.startsWith("-")) {
+      precedingOption = equals === -1 ? token : token.slice(0, equals);
+    }
+    return {
+      index,
+      option: precedingOption ?? `argument ${offset + 1}`,
+      prefix: equals === -1 ? "" : token.slice(0, equals + 1),
+      value: equals === -1 ? token : token.slice(equals + 1)
+    };
+  });
+}
+function repairArgv(argv, options) {
+  const active = options.env.APEX_ARGV_ENCODING === "repair" || options.platform === "win32" && options.env.APEX_ARGV_ENCODING !== "off";
+  if (!active) return { argv, repairs: [] };
+  const repairedArgv = [...argv];
+  const repairs = [];
+  for (const { index, option, prefix, value: value2 } of argumentValues(argv)) {
+    const repaired = repairCp1252Mojibake(value2);
+    if (repaired !== null) {
+      repairedArgv[index] = prefix + repaired;
+      repairs.push({ index, option });
+    }
+  }
+  return { argv: repairedArgv, repairs };
+}
+function replacementCharacterOptions(argv) {
+  return argumentValues(argv).filter(({ value: value2 }) => value2.includes("\uFFFD")).map(({ option }) => option);
+}
+function replacementCharacterFields(record4, fields3) {
+  const paths = [];
+  function visit2(value2, parts, path27) {
+    if (parts.length === 0) {
+      if (typeof value2 === "string" && value2.includes("\uFFFD")) paths.push(path27);
+      return;
+    }
+    if (value2 === null || typeof value2 !== "object") return;
+    const [part, ...rest] = parts;
+    const array = part.endsWith("[]");
+    const key = array ? part.slice(0, -2) : part;
+    const next = value2[key];
+    const nextPath = path27 ? `${path27}.${key}` : key;
+    if (array) {
+      if (Array.isArray(next)) {
+        next.forEach((item, index) => visit2(item, rest, `${nextPath}[${index}]`));
+      }
+    } else visit2(next, rest, nextPath);
+  }
+  for (const field of fields3) visit2(record4, field.split("."), "");
+  return paths;
+}
+function warnReplacementCharacters(label, record4, fields3) {
+  for (const path27 of replacementCharacterFields(record4, fields3)) {
+    process.stderr.write(`apex: stored name contains U+FFFD: ${label}.${path27}
+`);
+  }
+}
+
 // src/generated/experiment-filesystem.schema.json
 var experiment_filesystem_schema_default = {
   $id: "https://api.drip-apex.com/schemas/experiment-filesystem-v1.json",
@@ -12862,27 +13010,27 @@ function printExperiment(exp, dashboardUrl = null) {
   }
   console.log();
 }
-function formatPct(value, digits = 1) {
-  return typeof value === "number" && Number.isFinite(value) ? `${value.toFixed(digits)}%` : "-";
+function formatPct(value2, digits = 1) {
+  return typeof value2 === "number" && Number.isFinite(value2) ? `${value2.toFixed(digits)}%` : "-";
 }
-function confidenceBasisLabel(value) {
-  if (value === "fixed_horizon") return "fixed-horizon";
-  if (value === "sequential") return "always-valid";
+function confidenceBasisLabel(value2) {
+  if (value2 === "fixed_horizon") return "fixed-horizon";
+  if (value2 === "sequential") return "always-valid";
   return "unknown";
 }
-function statisticsStateLabel(value) {
-  return value === "untrustworthy" ? "verdict withheld" : String(value ?? "unknown");
+function statisticsStateLabel(value2) {
+  return value2 === "untrustworthy" ? "verdict withheld" : String(value2 ?? "unknown");
 }
-function formatRevenue(value, currency) {
-  if (value === null || value === void 0) return "\u2014";
-  if (!currency || typeof value !== "number" || !Number.isFinite(value)) return String(value);
+function formatRevenue(value2, currency) {
+  if (value2 === null || value2 === void 0) return "\u2014";
+  if (!currency || typeof value2 !== "number" || !Number.isFinite(value2)) return String(value2);
   try {
     return new Intl.NumberFormat("en-US", {
       style: "currency",
       currency: currency.trim().toUpperCase()
-    }).format(value);
+    }).format(value2);
   } catch {
-    return String(value);
+    return String(value2);
   }
 }
 function audienceLine(segmentApplied) {
@@ -12971,8 +13119,8 @@ function printExperimentResults(results2, currency) {
           const deltas = arm.deltaVsControl;
           const cm = deltas?.cm;
           const ci = cm?.ci95;
-          const count2 = (value) => typeof value === "number" && Number.isFinite(value) ? String(value) : "-";
-          const money = (value) => typeof value === "number" ? formatRevenue(value, String(plane.currency ?? currency ?? "")) : "-";
+          const count2 = (value2) => typeof value2 === "number" && Number.isFinite(value2) ? String(value2) : "-";
+          const money = (value2) => typeof value2 === "number" ? formatRevenue(value2, String(plane.currency ?? currency ?? "")) : "-";
           return [
             String(arm.name ?? arm.variationId ?? "-"),
             // Fail closed: a missing count is unavailable, never a measured 0.
@@ -13025,13 +13173,13 @@ var EXPERIMENT_FILESYSTEM_PATH_SCHEMA = {
   variation: filesystemPaths.filter((entry) => entry.startsWith("variations/*/")).map((entry) => entry.slice("variations/*/".length))
 };
 var SERVER_OWNED_EXPERIMENT_FILES = /* @__PURE__ */ new Set(["qa.json", "launch.json"]);
-var escapeRegex = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+var escapeRegex = (value2) => value2.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 var pathAlternation = (paths) => paths.map(escapeRegex).join("|");
 var FILESYSTEM_FILE_RE = new RegExp(
   `^(?:${pathAlternation(EXPERIMENT_FILESYSTEM_PATH_SCHEMA.topLevel)}|experiment/(?:${pathAlternation(EXPERIMENT_FILESYSTEM_PATH_SCHEMA.experiment)})|commerce/(?:${pathAlternation(EXPERIMENT_FILESYSTEM_PATH_SCHEMA.commerce)})|variations/[^/]+/(?:${pathAlternation(EXPERIMENT_FILESYSTEM_PATH_SCHEMA.variation)}))$`
 );
-function sha256Text(value) {
-  return import_node_crypto6.default.createHash("sha256").update(value).digest("hex");
+function sha256Text(value2) {
+  return import_node_crypto6.default.createHash("sha256").update(value2).digest("hex");
 }
 function folderPath(folder) {
   return import_node_path6.default.resolve(process.cwd(), folder);
@@ -13216,6 +13364,19 @@ function printFilesystemPlan(plan2) {
       console.log(`  - [${issue.code}] ${issue.message}${context ? ` (${context})` : ""}`);
     });
   }
+  if ((plan2.commerceLaunchPreview?.length ?? 0) > 0) {
+    console.log(source_default.bold("\nLaunch preview"));
+    for (const preview2 of plan2.commerceLaunchPreview ?? []) {
+      console.log(`  ${preview2.kind} (${preview2.path})`);
+      for (const issue of preview2.issues) {
+        const variation = issue.variation ? ` (variation: ${issue.variation})` : "";
+        console.log(source_default.yellow(`    - [${issue.code}] ${issue.message}${variation}`));
+      }
+      console.log(`    Checked at plan: ${preview2.checked.join(", ") || "none"}`);
+      for (const item of preview2.launchOnly)
+        console.log(`    Checked at ${item.when ?? "launch"}: ${item.check}: ${item.reason}`);
+    }
+  }
   console.log(source_default.bold("\nChanges"));
   if (plan2.changes.length === 0) {
     console.log(source_default.dim("  No changes."));
@@ -13299,38 +13460,38 @@ function printQaPreviewUrls(experimentId, result) {
     );
   }
 }
-function qaVersionMarker(value) {
-  const version = value;
+function qaVersionMarker(value2) {
+  const version = value2;
   return version.stale ? " [stale: checked against an earlier version]" : version.unversioned ? " [unversioned]" : "";
 }
-function printQaRun(run3) {
+function printQaRun(run4) {
   console.log();
-  console.log(source_default.bold(`QA run ${run3.id}`));
-  console.log(`  computedAt: ${run3.computedAt}`);
-  console.log(`  Status:   ${statusBadge(run3.summary.status)}`);
-  console.log(`  Required: ${run3.summary.completedRequired}/${run3.summary.required}`);
-  if (run3.approvedAt) console.log(`  Approved: ${run3.approvedAt}`);
-  if (run3.completedAt) console.log(`  Complete: ${run3.completedAt}`);
-  if (run3.summary.blockers.length > 0) {
+  console.log(source_default.bold(`QA run ${run4.id}`));
+  console.log(`  computedAt: ${run4.computedAt}`);
+  console.log(`  Status:   ${statusBadge(run4.summary.status)}`);
+  console.log(`  Required: ${run4.summary.completedRequired}/${run4.summary.required}`);
+  if (run4.approvedAt) console.log(`  Approved: ${run4.approvedAt}`);
+  if (run4.completedAt) console.log(`  Complete: ${run4.completedAt}`);
+  if (run4.summary.blockers.length > 0) {
     console.log(source_default.yellow("\nBlockers"));
-    run3.summary.blockers.forEach((blocker) => console.log(`  - ${blocker}`));
+    run4.summary.blockers.forEach((blocker) => console.log(`  - ${blocker}`));
   }
   console.log(source_default.bold("\nChecklist"));
-  for (const item of run3.checklist) {
+  for (const item of run4.checklist) {
     const required = item.required ? source_default.yellow(" required") : "";
     const notes = item.notes ? source_default.dim(` \u2014 ${item.notes}`) : "";
     console.log(`  ${statusBadge(item.status)} ${item.id}${required}${qaVersionMarker(item)}`);
     console.log(`    ${item.title}${notes}`);
   }
-  if (run3.urls.length > 0) {
+  if (run4.urls.length > 0) {
     console.log(source_default.bold("\nQA URLs"));
-    run3.urls.forEach((url) => {
+    run4.urls.forEach((url) => {
       console.log(`  - ${url.label}: ${source_default.cyan(url.url)}`);
     });
   }
-  if ((run3.evidenceRecords ?? []).length > 0) {
+  if ((run4.evidenceRecords ?? []).length > 0) {
     console.log(source_default.bold("\nEvidence records"));
-    for (const record4 of run3.evidenceRecords ?? []) {
+    for (const record4 of run4.evidenceRecords ?? []) {
       const device = record4.device ? ` \xB7 ${record4.device}` : "";
       console.log(
         `  - ${record4.kind} \xB7 ${record4.label} \xB7 ${record4.status}${device} \xB7 ${record4.capturedAt}${qaVersionMarker(record4)}`
@@ -13343,18 +13504,18 @@ async function confirmApply(message) {
   if (!process.stdin.isTTY || !process.stdout.isTTY) {
     return null;
   }
-  const readline3 = await import("node:readline");
-  const rl = readline3.createInterface({ input: process.stdin, output: process.stderr });
+  const readline4 = await import("node:readline");
+  const rl = readline4.createInterface({ input: process.stdin, output: process.stderr });
   const answer = await new Promise((resolve2) => {
     rl.question(source_default.yellow(`${message} [y/N] `), resolve2);
   });
   rl.close();
   return answer.toLowerCase() === "y";
 }
-function parseEvidenceInput(value) {
-  if (!value) return void 0;
-  const source = value.startsWith("@") ? value.slice(1) : value;
-  const text2 = value.startsWith("@") || import_node_fs8.default.existsSync(source) ? import_node_fs8.default.readFileSync(import_node_path6.default.resolve(process.cwd(), source), "utf8") : value;
+function parseEvidenceInput(value2) {
+  if (!value2) return void 0;
+  const source = value2.startsWith("@") ? value2.slice(1) : value2;
+  const text2 = value2.startsWith("@") || import_node_fs8.default.existsSync(source) ? import_node_fs8.default.readFileSync(import_node_path6.default.resolve(process.cwd(), source), "utf8") : value2;
   const parsed = JSON.parse(text2);
   if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
     throw new Error("QA evidence must be a JSON object");
@@ -13362,24 +13523,24 @@ function parseEvidenceInput(value) {
   return parsed;
 }
 function qaChoice(flags, description, choices) {
-  return new Option(flags, description).choices([...choices]).argParser((value) => value);
+  return new Option(flags, description).choices([...choices]).argParser((value2) => value2);
 }
-function validateQaChoice(command, option, value, allowed2) {
-  if (value !== void 0 && !allowed2.includes(value)) {
-    fail(command, `Invalid ${option}: ${value}`, EXIT_CODES.validation, {
+function validateQaChoice(command, option, value2, allowed2) {
+  if (value2 !== void 0 && !allowed2.includes(value2)) {
+    fail(command, `Invalid ${option}: ${value2}`, EXIT_CODES.validation, {
       option,
       allowedValues: [...allowed2]
     });
   }
 }
-function qaSummary(run3, changed) {
+function qaSummary(run4, changed) {
   return {
     run: {
-      id: run3.id,
-      status: run3.status,
-      summary: run3.summary,
-      approvedAt: run3.approvedAt,
-      updatedAt: run3.updatedAt
+      id: run4.id,
+      status: run4.status,
+      summary: run4.summary,
+      approvedAt: run4.approvedAt,
+      updatedAt: run4.updatedAt
     },
     changed,
     validationErrors: []
@@ -13392,8 +13553,8 @@ function tryReadFilesystemSession(folder) {
     return null;
   }
 }
-async function resolveExperimentForFilesystemOrId(value) {
-  const candidate = folderPath(value);
+async function resolveExperimentForFilesystemOrId(value2) {
+  const candidate = folderPath(value2);
   const session = tryReadFilesystemSession(candidate);
   if (session) {
     return {
@@ -13402,8 +13563,8 @@ async function resolveExperimentForFilesystemOrId(value) {
       label: import_node_path6.default.basename(candidate)
     };
   }
-  const exp = await resolveExperiment(value);
-  if (!exp) throw new Error(`Experiment "${value}" not found.`);
+  const exp = await resolveExperiment(value2);
+  if (!exp) throw new Error(`Experiment "${value2}" not found.`);
   return { experimentId: exp.id, folder: null, label: exp.name };
 }
 async function refreshExperimentFilesystemFolderIfNeeded(creds, folder, experimentId) {
@@ -13525,8 +13686,8 @@ var list = new Command("list").alias("ls").description(
         fields3.map((field) => field.toUpperCase()),
         experiments.map(
           (experiment2) => fields3.map((field) => {
-            const value = experiment2[field];
-            return value == null ? "-" : typeof value === "object" ? JSON.stringify(value) : String(value);
+            const value2 = experiment2[field];
+            return value2 == null ? "-" : typeof value2 === "object" ? JSON.stringify(value2) : String(value2);
           })
         )
       );
@@ -13564,6 +13725,7 @@ var get = new Command("get").description(
     exp.shop_id ?? creds.resolvedContext?.shopId,
     exp.id
   );
+  warnReplacementCharacters("experiment", exp, ["name", "description", "variations[].name"]);
   output(this, { ...exp, dashboard_url: dashboardUrl }, () => printExperiment(exp, dashboardUrl));
 });
 var attachIdea = new Command("attach-idea").description("Attach an experiment to an idea").argument("<experiment>", EXPERIMENT_REFERENCE_DESCRIPTION).requiredOption("--idea <key>", "Idea UUID or Apex backlog key").option("--follow-up", "Attach as a follow-up test").action(async function action5(experimentRef, opts) {
@@ -13599,6 +13761,22 @@ var detachIdea = new Command("detach-idea").description("Detach an experiment fr
     );
   output(this, res.data, () => printSuccess("Idea detached."));
 });
+function printResultsByChannel(body5) {
+  const data = body5.data ?? body5;
+  if (data.status !== "ready") {
+    console.log(`Channel split ${data.status}: ${data.reason}`);
+    return;
+  }
+  console.log(`By channel through ${data.as_of} (${data.metric}, ${data.currency})`);
+  const channels = data.channels;
+  for (const row of channels) {
+    console.log(`${row.channel}: ${row.state}`);
+    if (row.state !== "readable" || !row.arms) continue;
+    for (const [arm, values] of Object.entries(row.arms))
+      console.log(`  ${arm}: ${values.visitors} visitors, ${values.perVisitor} per visitor`);
+  }
+  console.log("Channel comparisons are hypotheses for follow-up tests.");
+}
 function printResultsExplain(body5, samples) {
   const data = body5.data;
   console.log("Diagnostic results explanation");
@@ -13643,7 +13821,13 @@ ${JSON.stringify(data.order, null, 2)}`);
   console.log(`
 Definitions: ${data.definitions_url}`);
 }
-var results = new Command("results").description("Read experiment results and timeseries by ID or slug").argument("<id-or-slug>", EXPERIMENT_REFERENCE_DESCRIPTION).option("--currency <code>", "Currency code for revenue formatting").option("--segment <dim:value>", "Include one audience segment").option("--exclude-segment <dim:value>", "Exclude one audience segment (include wins)").option("--explain", "Explain raw-event exclusions and residuals").option("--goal <id>", "Goal ID or event key for --explain").option("--order <key>", "Order label trail for --explain").option("--samples", "Show sample identifiers with --explain").option("--wait <seconds>", "Wait for a cold server-side results build", "120").action(async function action7(idOrSlug, opts) {
+var results = new Command("results").description("Read experiment results and timeseries by ID or slug").argument("<id-or-slug>", EXPERIMENT_REFERENCE_DESCRIPTION).option("--currency <code>", "Currency code for revenue formatting").option("--segment <dim:value>", "Include one audience segment").option("--exclude-segment <dim:value>", "Exclude one audience segment (include wins)").option("--by-channel", "Read the hourly arrival-channel money snapshot").option("--explain", "Explain raw-event exclusions and residuals").option("--goal <id>", "Goal ID or event key for --explain").option("--order <key>", "Order label trail for --explain").option("--samples", "Show sample identifiers with --explain").option("--wait <seconds>", "Wait for a cold server-side results build", "120").action(async function action7(idOrSlug, opts) {
+  if (opts.byChannel && (opts.explain || opts.segment || opts.excludeSegment || opts.currency || opts.goal || opts.order || opts.samples || this.getOptionValueSource("wait") !== "default"))
+    fail(
+      this,
+      "--by-channel reads the current run without other result filters",
+      EXIT_CODES.validation
+    );
   if (opts.explain && (opts.segment !== void 0 || opts.excludeSegment !== void 0))
     fail(
       this,
@@ -13665,12 +13849,12 @@ var results = new Command("results").description("Read experiment results and ti
       fail(this, "--wait must be a non-negative number of seconds", EXIT_CODES.validation);
     }
     const startedWaitingAt = Date.now();
-    let res = opts.explain ? await getExperimentResultsExplain(creds, exp.id, opts) : await getExperimentResults(creds, exp.id, {
+    let res = opts.byChannel ? await getExperimentResultsByChannel(creds, exp.id) : opts.explain ? await getExperimentResultsExplain(creds, exp.id, opts) : await getExperimentResults(creds, exp.id, {
       currency: opts.currency,
       segment: opts.segment,
       exclude_segment: opts.excludeSegment
     });
-    while (!opts.explain && isResultsComputing(res)) {
+    while (!opts.byChannel && !opts.explain && isResultsComputing(res)) {
       const elapsedSeconds = (Date.now() - startedWaitingAt) / 1e3;
       const remainingSeconds = waitSeconds - elapsedSeconds;
       if (remainingSeconds <= 0) break;
@@ -13700,7 +13884,7 @@ var results = new Command("results").description("Read experiment results and ti
     output(
       this,
       res.data,
-      () => opts.explain ? printResultsExplain(res.data, Boolean(opts.samples)) : printExperimentResults(res.data, opts.currency)
+      () => opts.byChannel ? printResultsByChannel(res.data) : opts.explain ? printResultsExplain(res.data, Boolean(opts.samples)) : printExperimentResults(res.data, opts.currency)
     );
   } catch (error) {
     spinner?.fail("Failed to fetch experiment results");
@@ -13759,6 +13943,7 @@ var update = new Command("update").description("Update an experiment").addOption
     ...opts.countingType !== void 0 ? { counting_type: opts.countingType } : {}
   });
   if (!res.ok) fail(this, res.error ?? "Failed to update experiment", classifyStatus(res.status));
+  warnReplacementCharacters("experiment", res.data, ["name", "description", "variations[].name"]);
   const stored = res.data?.results_weekdays ?? null;
   output(this, res.data, () => {
     if (opts.countingType !== void 0)
@@ -13769,17 +13954,17 @@ var update = new Command("update").description("Update an experiment").addOption
       );
   });
 });
-function collectCreateOption(value, previous) {
-  return [...previous, value];
+function collectCreateOption(value2, previous) {
+  return [...previous, value2];
 }
-function parseHttpDestination(value) {
-  const trimmed = value.trim();
+function parseHttpDestination(value2) {
+  const trimmed = value2.trim();
   try {
     const url = new URL(trimmed);
     if (url.protocol !== "http:" && url.protocol !== "https:") throw new Error();
   } catch {
     throw new CliError(
-      `Invalid redirect destination "${value}": expected an HTTP(S) URL.`,
+      `Invalid redirect destination "${value2}": expected an HTTP(S) URL.`,
       EXIT_CODES.validation
     );
   }
@@ -13823,8 +14008,8 @@ function normalizeNewGoalKey(key) {
   const normalized = key.trim().toLowerCase().replace(/-/g, "_");
   return normalized === "page" ? "page_id" : normalized;
 }
-function validateNewGoal(command, value, body5) {
-  const invalid = (reason2) => fail(command, `Invalid --goal "new:${value}"; ${reason2}`, EXIT_CODES.validation);
+function validateNewGoal(command, value2, body5) {
+  const invalid = (reason2) => fail(command, `Invalid --goal "new:${value2}"; ${reason2}`, EXIT_CODES.validation);
   const text2 = (field) => {
     const raw = body5[field];
     return typeof raw === "string" && raw.length > 0 ? raw : void 0;
@@ -13872,20 +14057,20 @@ function validateNewGoal(command, value, body5) {
   if (valueUnit && !GOAL_VALUE_UNITS.includes(valueUnit))
     invalid(`value-unit must be one of ${GOAL_VALUE_UNITS.join(", ")}`);
 }
-function parseNewGoal(command, value) {
+function parseNewGoal(command, value2) {
   const body5 = {};
-  for (const field of value.split(",")) {
+  for (const field of value2.split(",")) {
     const separator = field.indexOf("=");
     if (separator <= 0 || separator === field.length - 1) {
       fail(
         command,
-        `Invalid --goal "new:${value}"; use new:type=<type>,selector=<css>,name=<text>`,
+        `Invalid --goal "new:${value2}"; use new:type=<type>,selector=<css>,name=<text>`,
         EXIT_CODES.validation
       );
     }
     body5[normalizeNewGoalKey(field.slice(0, separator))] = field.slice(separator + 1).trim();
   }
-  validateNewGoal(command, value, body5);
+  validateNewGoal(command, value2, body5);
   return body5;
 }
 async function resolveNewGoalPages(command, creds, goals, interactive) {
@@ -13928,8 +14113,8 @@ async function resolveNewGoalPages(command, creds, goals, interactive) {
   }
 }
 async function askCreate(question) {
-  const readline3 = await import("node:readline");
-  const rl = readline3.createInterface({ input: process.stdin, output: process.stderr });
+  const readline4 = await import("node:readline");
+  const rl = readline4.createInterface({ input: process.stdin, output: process.stderr });
   return new Promise(
     (resolve2) => rl.question(question, (answer) => {
       rl.close();
@@ -14026,8 +14211,8 @@ var create = new Command("create").description(
   if (!Number.isFinite(traffic) || traffic < 0 || traffic > 100) {
     fail(this, "--traffic must be a number from 0 to 100", EXIT_CODES.validation);
   }
-  const sourceRules = [...opts.sourceUrl, ...opts.pageUrl].map((value) => value.trim());
-  if (sourceRules.some((value) => value.length === 0)) {
+  const sourceRules = [...opts.sourceUrl, ...opts.pageUrl].map((value2) => value2.trim());
+  if (sourceRules.some((value2) => value2.length === 0)) {
     fail(this, "--source-url/--page-url cannot be empty", EXIT_CODES.validation);
   }
   if (opts.type !== "redirect" && opts.destination.length > 0) {
@@ -14241,6 +14426,7 @@ var create = new Command("create").description(
       previewNote = `No preview link: the experiment has no ${variation ? "store URL" : "treatment variation"} yet. Add one, then run \`apex preview ${res.data.id}\`.`;
     }
   }
+  warnReplacementCharacters("experiment", res.data, ["name", "description", "variations[].name"]);
   output(
     this,
     {
@@ -14330,8 +14516,8 @@ var del = new Command("delete").alias("rm").description("Delete an experiment").
         `apex experiments delete ${idOrSlug} --force`
       );
     }
-    const readline3 = await import("node:readline");
-    const rl = readline3.createInterface({
+    const readline4 = await import("node:readline");
+    const rl = readline4.createInterface({
       input: process.stdin,
       output: process.stderr
     });
@@ -14946,7 +15132,7 @@ var applyFilesystem = new Command("apply").option(
           );
           for (const variation of receipt.variations) {
             console.log(
-              `  ${variation.name} (${variation.slug}): ${Object.entries(variation.digests).map(([key, value]) => `${key}=${value ?? "null"}`).join(" ")}`
+              `  ${variation.name} (${variation.slug}): ${Object.entries(variation.digests).map(([key, value2]) => `${key}=${value2 ?? "null"}`).join(" ")}`
             );
           }
         }
@@ -15019,18 +15205,18 @@ var qaCheck = new Command("check").description("Update one QA checklist item wit
         classifyStatus(res.status),
         res.errorDetails
       );
-    const run3 = res.data.run;
+    const run4 = res.data.run;
     await refreshExperimentFilesystemFolderIfNeeded(
       creds,
       resolved.folder,
       resolved.experimentId
     );
-    const data = opts.summary ? qaSummary(run3, run3.checklist.find((item) => item.id === opts.item) ?? null) : res.data;
+    const data = opts.summary ? qaSummary(run4, run4.checklist.find((item) => item.id === opts.item) ?? null) : res.data;
     output(this, data, () => {
       spinner.succeed("Updated QA checklist");
       if (opts.summary) process.stdout.write(`${JSON.stringify(data, null, 2)}
 `);
-      else printQaRun(run3);
+      else printQaRun(run4);
     });
   } catch (error) {
     spinner.fail("Failed to update QA checklist");
@@ -15065,21 +15251,21 @@ var qaNotes = new Command("notes").description("Update QA run notes or acceptanc
         classifyStatus(res.status),
         res.errorDetails
       );
-    const run3 = res.data.run;
+    const run4 = res.data.run;
     await refreshExperimentFilesystemFolderIfNeeded(
       creds,
       resolved.folder,
       resolved.experimentId
     );
-    const data = opts.summary ? qaSummary(run3, {
-      notes: run3.notes,
-      acceptanceCriteriaSummary: run3.acceptanceCriteriaSummary
+    const data = opts.summary ? qaSummary(run4, {
+      notes: run4.notes,
+      acceptanceCriteriaSummary: run4.acceptanceCriteriaSummary
     }) : res.data;
     output(this, data, () => {
       spinner.succeed("Updated QA notes");
       if (opts.summary) process.stdout.write(`${JSON.stringify(data, null, 2)}
 `);
-      else printQaRun(run3);
+      else printQaRun(run4);
     });
   } catch (error) {
     spinner.fail("Failed to update QA notes");
@@ -15119,9 +15305,9 @@ var qaApprove = new Command("approve").description("Approve QA and move the expe
       }
       if (typeof details.split_hash === "string" && details.split_hash.length > 0) {
         const weights = Array.isArray(details.variation_weights) ? details.variation_weights : [];
-        for (const value of weights) {
-          if (value && typeof value === "object") {
-            const variation = value;
+        for (const value2 of weights) {
+          if (value2 && typeof value2 === "object") {
+            const variation = value2;
             process.stderr.write(
               `${variation.name ?? variation.id ?? "Variation"}: ${(variation.weight ?? 0) * 100}%${variation.weight === 0 ? " (no traffic)" : ""}
 `
@@ -15197,17 +15383,17 @@ var qaReopen = new Command("reopen").description("Reopen QA and clear scheduled
     throw error;
   }
 });
-function parseJsonValue(value) {
-  const source = value.startsWith("@") ? value.slice(1) : value;
-  const text2 = value.startsWith("@") || import_node_fs8.default.existsSync(source) ? import_node_fs8.default.readFileSync(import_node_path6.default.resolve(process.cwd(), source), "utf8") : value;
+function parseJsonValue(value2) {
+  const source = value2.startsWith("@") ? value2.slice(1) : value2;
+  const text2 = value2.startsWith("@") || import_node_fs8.default.existsSync(source) ? import_node_fs8.default.readFileSync(import_node_path6.default.resolve(process.cwd(), source), "utf8") : value2;
   return JSON.parse(text2);
 }
-function collectFile(value, previous = []) {
-  return [...previous, value];
+function collectFile(value2, previous = []) {
+  return [...previous, value2];
 }
-function normalizeEvidenceDevice(value) {
-  if (!value) return void 0;
-  const normalized = value.trim().toLowerCase();
+function normalizeEvidenceDevice(value2) {
+  if (!value2) return void 0;
+  const normalized = value2.trim().toLowerCase();
   if (normalized === "desktop_chrome" || normalized === "desktop_safari") return "desktop";
   if (normalized === "iphone_15_pro" || normalized === "galaxy_s24") return "mobile";
   if (normalized === "ipad_pro") return "tablet";
@@ -15294,15 +15480,15 @@ var qaEvidence = new Command("evidence").description("Attach screenshot jobs or
       );
     }
     spinner.stop();
-    const run3 = response.data.run;
+    const run4 = response.data.run;
     const data = opts.summary ? qaSummary(
-      run3,
-      run3.evidenceRecords.filter((record4) => !previousIds.has(record4.id))
+      run4,
+      run4.evidenceRecords.filter((record4) => !previousIds.has(record4.id))
     ) : response.data;
     output(this, data, () => {
       if (opts.summary) process.stdout.write(`${JSON.stringify(data, null, 2)}
 `);
-      else printQaRun(run3);
+      else printQaRun(run4);
     });
   } catch (error) {
     spinner.fail("Failed to write QA evidence");
@@ -15334,14 +15520,14 @@ var qa = new Command("qa").description("Manage experiment QA runs from the CLI")
       data,
       () => printTable(
         ["KIND", "STATE", "SUMMARY"],
-        Object.entries(data.kinds).map(([kind5, value]) => [
+        Object.entries(data.kinds).map(([kind5, value2]) => [
           kind5,
-          value.evidence.state,
-          value.result?.summary ?? value.evidence.reasons[0] ?? "Saved evidence is current."
+          value2.evidence.state,
+          value2.result?.summary ?? value2.evidence.reasons[0] ?? "Saved evidence is current."
         ])
       )
     );
-    const states = Object.values(data.kinds).map((value) => value?.evidence.state);
+    const states = Object.values(data.kinds).map((value2) => value2?.evidence.state);
     if (states.some((state) => state !== "pass")) {
       console.error(
         "Next: fix stale, pending, or failing evidence and run apex experiments qa probe again."
@@ -15405,11 +15591,11 @@ var SCREENSHOT_DEVICES = [
   "ipad_pro",
   "desktop_safari"
 ];
-var safeFilenamePart = (value) => value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "") || "screenshot";
-var commaList = (value) => value.split(",").map((item) => item.trim()).filter(Boolean);
-function shellQuote(value) {
-  if (value.length > 0 && /^[A-Za-z0-9_@%+=:,./-]+$/.test(value)) return value;
-  return `'${value.replaceAll("'", "'\\''")}'`;
+var safeFilenamePart = (value2) => value2.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "") || "screenshot";
+var commaList = (value2) => value2.split(",").map((item) => item.trim()).filter(Boolean);
+function shellQuote(value2) {
+  if (value2.length > 0 && /^[A-Za-z0-9_@%+=:,./-]+$/.test(value2)) return value2;
+  return `'${value2.replaceAll("'", "'\\''")}'`;
 }
 function isTransientResumeStatus(status4) {
   return status4 === 429 || status4 !== void 0 && status4 >= 500;
@@ -15794,11 +15980,197 @@ Examples:
 `
 );
 
+// src/commands/results.ts
+var import_node_fs9 = __toESM(require("node:fs"));
+var import_node_path7 = __toESM(require("node:path"));
+var import_promises3 = __toESM(require("node:readline/promises"));
+var OUTCOMES = /* @__PURE__ */ new Set(["won", "lost", "inconclusive"]);
+function collect(value2, previous) {
+  return [...previous, value2];
+}
+function pair(command, value2, flag) {
+  const index = value2.indexOf("=");
+  if (index <= 0 || index === value2.length - 1)
+    fail(command, `Invalid ${flag} "${value2}": use left=right.`, EXIT_CODES.validation);
+  return [value2.slice(0, index).trim(), value2.slice(index + 1).trim()];
+}
+function apiFailure(command, response) {
+  const body5 = response.data;
+  fail(
+    command,
+    body5?.error?.message ?? response.error ?? `Request failed (HTTP ${response.status})`,
+    classifyStatus(response.status),
+    void 0,
+    { status: response.status, body: response.data }
+  );
+}
+function value(row, key) {
+  const item = row[key];
+  return item == null ? "-" : String(item);
+}
+function printPreview(preview2) {
+  printTable(
+    ["ROW", "TITLE", "OUTCOME", "METRIC", "LIFT", "SAMPLE", "CONF", "DEVICE", "DATES", "LEARNING"],
+    preview2.rows.map((row, index) => [
+      String(row.source_row ?? index + 1),
+      value(row, "title"),
+      value(row, "outcome"),
+      value(row, "primary_metric"),
+      value(row, "primary_lift"),
+      value(row, "sample_size"),
+      value(row, "confidence"),
+      value(row, "device"),
+      [row.started_at, row.ended_at].filter(Boolean).join(" \u2013 ") || "-",
+      value(row, "learning").slice(0, 60)
+    ])
+  );
+  for (const error of preview2.error_rows ?? [])
+    console.error(`${error.source_name}:${error.source_row} ${error.field}: ${error.error}`);
+  for (const warning of preview2.warnings ?? [])
+    console.error(`Warning: ${typeof warning === "string" ? warning : JSON.stringify(warning)}`);
+}
+var importCommand = new Command("import").description("Upload past test results from CSV or JSON files").requiredOption("--file <path>", "CSV or JSON file (repeatable)", collect, []).option(
+  "--map <column=field>",
+  "Map a file column to an Apex field (repeatable). Fields: title, outcome, learning, primary_lift, sample_size, page_url, page_label, device, description, started_at, ended_at, legacy_id",
+  collect,
+  []
+).option(
+  "--outcome-value <value=outcome>",
+  "Map a value of the outcome column to won, lost or inconclusive (repeatable)",
+  collect,
+  []
+).option("--source <name>", "Source name stored on every imported row (default: the file name)").option("--dry-run", "Inspect and preview without importing").option("--yes", "Confirm the import without prompting").action(async function(options) {
+  const creds = requireCredentials();
+  const shopId = creds.resolvedContext?.shopId;
+  const shopCredentials = creds;
+  const shopLabel = shopCredentials.shopDomain ?? shopCredentials.domain ?? shopId ?? "the selected shop";
+  const makeForm = () => {
+    const form = new FormData();
+    for (const fileArg of options.file) {
+      const resolved = import_node_path7.default.resolve(fileArg);
+      let bytes;
+      try {
+        bytes = import_node_fs9.default.readFileSync(resolved);
+      } catch (error) {
+        fail(
+          this,
+          `Could not read ${fileArg}: ${error instanceof Error ? error.message : String(error)}`,
+          EXIT_CODES.validation,
+          { code: "local_file_error" }
+        );
+      }
+      form.append("files", new Blob([bytes]), import_node_path7.default.basename(resolved));
+    }
+    return form;
+  };
+  const inspected = await requestForm(creds, "POST", "/api/v1/test-results/import/inspect", makeForm());
+  if (!inspected.ok || !inspected.data) apiFailure(this, inspected);
+  const mapping = { ...inspected.data.data.suggested_mapping.columns };
+  for (const raw of options.map) {
+    const [column, field] = pair(this, raw, "--map");
+    mapping[field] = column;
+  }
+  const outcomeValues = { ...inspected.data.data.suggested_mapping.outcome_values };
+  for (const raw of options.outcomeValue) {
+    const [source, outcome] = pair(this, raw, "--outcome-value");
+    if (!OUTCOMES.has(outcome))
+      fail(
+        this,
+        `Invalid outcome "${outcome}": use won, lost, or inconclusive.`,
+        EXIT_CODES.validation
+      );
+    outcomeValues[source] = outcome;
+  }
+  const missing = ["title", "outcome", "learning"].filter((field) => !mapping[field]);
+  if (missing.length)
+    fail(
+      this,
+      `Unmapped required columns: ${missing.join(", ")}. Use --map <column=field>.`,
+      EXIT_CODES.validation
+    );
+  const previewForm = makeForm();
+  previewForm.append(
+    "mapping",
+    JSON.stringify({ columns: mapping, outcome_values: outcomeValues })
+  );
+  const previewResponse = await requestForm(
+    creds,
+    "POST",
+    "/api/v1/test-results/import/preview",
+    previewForm
+  );
+  if (!previewResponse.ok || !previewResponse.data) apiFailure(this, previewResponse);
+  const preview2 = previewResponse.data.data;
+  if (preview2.error_rows?.length) {
+    if (!shouldUseJson(this)) printPreview(preview2);
+    fail(
+      this,
+      `Preview found ${preview2.error_rows.length} row error(s); nothing was imported.`,
+      EXIT_CODES.validation,
+      { preview: preview2 }
+    );
+  }
+  if (options.dryRun) {
+    output(this, previewResponse.data, () => printPreview(preview2));
+    return;
+  }
+  if (!shouldUseJson(this)) printPreview(preview2);
+  if (!options.yes) {
+    const globals = this.optsWithGlobals();
+    const retryArgs = [
+      ...options.file.map((file) => `--file ${JSON.stringify(file)}`),
+      ...options.map.map((value2) => `--map ${JSON.stringify(value2)}`),
+      ...options.outcomeValue.map((value2) => `--outcome-value ${JSON.stringify(value2)}`),
+      ...options.source !== void 0 ? [`--source ${JSON.stringify(options.source)}`] : [],
+      ...globals.shop ? [`--shop ${JSON.stringify(globals.shop)}`] : [],
+      ...globals.org ? [`--org ${JSON.stringify(globals.org)}`] : []
+    ];
+    const retry = `apex results import ${retryArgs.join(" ")} --yes`;
+    if (!process.stdin.isTTY)
+      confirmationRequired(
+        this,
+        "Import confirmation is required in non-TTY mode; rerun with --yes.",
+        retry
+      );
+    const rl = import_promises3.default.createInterface({ input: process.stdin, output: process.stderr });
+    const answer = await rl.question(
+      `Import ${preview2.rows.length} rows into ${shopLabel}? [y/N] `
+    );
+    rl.close();
+    if (!/^y(es)?$/i.test(answer.trim()))
+      confirmationRequired(this, "Import cancelled; rerun with --yes to confirm.", retry);
+  }
+  const merged = { imported: 0, skipped: 0, test_results: [] };
+  for (let offset = 0; offset < preview2.rows.length; offset += 500) {
+    const response = await request(
+      creds,
+      "POST",
+      "/api/v1/test-results/import/confirm",
+      {
+        rows: preview2.rows.slice(offset, offset + 500).map((row) => options.source ? { ...row, source_name: options.source } : row)
+      }
+    );
+    if (!response.ok || !response.data) apiFailure(this, response);
+    merged.imported += response.data.data.imported;
+    merged.skipped += response.data.data.skipped;
+    merged.test_results.push(...response.data.data.test_results);
+  }
+  for (const row of merged.test_results)
+    if (row.shop_id != null)
+      assertResponseShop(String(row.shop_id), shopId, creds.credentialKind);
+  output(
+    this,
+    merged,
+    () => console.log(`Imported ${merged.imported}, skipped ${merged.skipped} (already present).`)
+  );
+});
+var resultsCommand = new Command("results").description("Import and manage test results").addCommand(importCommand);
+
 // src/commands/push.ts
 init_source();
-var import_node_fs9 = __toESM(require("node:fs"));
+var import_node_fs10 = __toESM(require("node:fs"));
 var import_node_os7 = __toESM(require("node:os"));
-var import_node_path7 = __toESM(require("node:path"));
+var import_node_path8 = __toESM(require("node:path"));
 var import_node_url2 = require("node:url");
 function toApiBody(exp) {
   return {
@@ -15839,7 +16211,7 @@ async function rewriteExperimentAssets(exp, rewrite, baseDir) {
   };
 }
 async function importConfigModule(absPath) {
-  const ext = import_node_path7.default.extname(absPath).toLowerCase();
+  const ext = import_node_path8.default.extname(absPath).toLowerCase();
   if (ext === ".js" || ext === ".mjs" || ext === ".cjs") {
     return await import((0, import_node_url2.pathToFileURL)(absPath).href);
   }
@@ -15853,8 +16225,8 @@ async function importConfigModule(absPath) {
 ` + (err instanceof Error ? err.message : String(err))
       );
     }
-    const tmpDir = import_node_fs9.default.mkdtempSync(import_node_path7.default.join(import_node_os7.default.tmpdir(), "drip-config-"));
-    const outFile = import_node_path7.default.join(tmpDir, "config.mjs");
+    const tmpDir = import_node_fs10.default.mkdtempSync(import_node_path8.default.join(import_node_os7.default.tmpdir(), "drip-config-"));
+    const outFile = import_node_path8.default.join(tmpDir, "config.mjs");
     try {
       await esbuild.build({
         entryPoints: [absPath],
@@ -15870,15 +16242,15 @@ async function importConfigModule(absPath) {
       return await import(href);
     } finally {
       try {
-        import_node_fs9.default.rmSync(tmpDir, { recursive: true, force: true });
+        import_node_fs10.default.rmSync(tmpDir, { recursive: true, force: true });
       } catch {
       }
     }
   }
   throw new Error(`Unsupported config extension "${ext}". Use .drip.config.ts or .drip.config.js.`);
 }
-function isRecord2(value) {
-  return !!value && typeof value === "object" && !Array.isArray(value);
+function isRecord2(value2) {
+  return !!value2 && typeof value2 === "object" && !Array.isArray(value2);
 }
 var pushCommand = new Command("push").description("Push experiment definitions from config file to the API (idempotent by slug)").option("-c, --config <path>", "Config file path").option("--dry-run", "Show what would be pushed without making changes").option("--no-asset-upload", "Keep inline and local image references unchanged").action(async function action23(opts) {
   const creds = requireCredentials();
@@ -15891,7 +16263,7 @@ var pushCommand = new Command("push").description("Push experiment definitions f
     );
   }
   const spinner = process.stderr.isTTY ? await createSpinner(`Loading config from ${source_default.cyan(configPath)}...`) : null;
-  const absoluteConfigPath = import_node_path7.default.resolve(configPath);
+  const absoluteConfigPath = import_node_path8.default.resolve(configPath);
   let experiments;
   try {
     const mod = await importConfigModule(absoluteConfigPath);
@@ -15958,7 +16330,7 @@ var pushCommand = new Command("push").description("Push experiment definitions f
     return;
   }
   const assetRewriter = createAssetReferenceRewriter({
-    baseDir: import_node_path7.default.dirname(absoluteConfigPath),
+    baseDir: import_node_path8.default.dirname(absoluteConfigPath),
     baseUrl: creds.baseUrl,
     enabled: opts.assetUpload !== false,
     upload: async (file) => {
@@ -15988,7 +16360,7 @@ var pushCommand = new Command("push").description("Push experiment definitions f
     let body5;
     try {
       body5 = toApiBody(
-        await rewriteExperimentAssets(exp, assetRewriter, import_node_path7.default.dirname(absoluteConfigPath))
+        await rewriteExperimentAssets(exp, assetRewriter, import_node_path8.default.dirname(absoluteConfigPath))
       );
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
@@ -16110,9 +16482,9 @@ var previewCommand = new Command("preview").description(
         );
         const expiresAt = new Date(data.expires_at);
         const remainingMs = expiresAt.getTime() - Date.now();
-        const value = remainingMs < 864e5 ? Math.max(1, Math.round(remainingMs / 36e5)) : Math.round(remainingMs / 864e5);
+        const value2 = remainingMs < 864e5 ? Math.max(1, Math.round(remainingMs / 36e5)) : Math.round(remainingMs / 864e5);
         const unit = remainingMs < 864e5 ? "hour" : "day";
-        const duration = `${value} ${unit}${value === 1 ? "" : "s"}`;
+        const duration = `${value2} ${unit}${value2 === 1 ? "" : "s"}`;
         console.log(
           `Valid until ${expiresAt.toISOString()} (${duration}). Re-run this command for a fresh link.`
         );
@@ -16191,8 +16563,8 @@ var previewCommand = new Command("preview").description(
       const qaFile = snapshot.data.files.find((file) => file.path === "qa.json");
       if (qaFile) {
         try {
-          const run3 = JSON.parse(qaFile.content)?.latestRun;
-          if (run3 && typeof run3.id === "string" && run3.id.trim()) qaRun = run3;
+          const run4 = JSON.parse(qaFile.content)?.latestRun;
+          if (run4 && typeof run4.id === "string" && run4.id.trim()) qaRun = run4;
         } catch {
         }
       }
@@ -16258,25 +16630,25 @@ var previewCommand = new Command("preview").description(
 
 // src/commands/harness.ts
 init_source();
-var import_node_fs10 = __toESM(require("node:fs"));
-var import_node_path8 = __toESM(require("node:path"));
+var import_node_fs11 = __toESM(require("node:fs"));
+var import_node_path9 = __toESM(require("node:path"));
 var import_node_child_process6 = require("node:child_process");
-function slugify(value, fallback2 = "variation") {
-  const slug = value.normalize("NFKD").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 80);
+function slugify(value2, fallback2 = "variation") {
+  const slug = value2.normalize("NFKD").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 80);
   return slug || fallback2;
 }
 function readJson(filePath) {
-  if (!import_node_fs10.default.existsSync(filePath)) return null;
-  return JSON.parse(import_node_fs10.default.readFileSync(filePath, "utf8"));
+  if (!import_node_fs11.default.existsSync(filePath)) return null;
+  return JSON.parse(import_node_fs11.default.readFileSync(filePath, "utf8"));
 }
 function resolveFolder(folder) {
-  return import_node_path8.default.resolve(process.cwd(), folder);
+  return import_node_path9.default.resolve(process.cwd(), folder);
 }
 function experimentConfigPath(folder) {
-  return import_node_path8.default.join(folder, "experiment.config.json");
+  return import_node_path9.default.join(folder, "experiment.config.json");
 }
 function apexConfigPath(folder) {
-  return import_node_path8.default.join(folder, "apex.harness.json");
+  return import_node_path9.default.join(folder, "apex.harness.json");
 }
 function loadHarnessConfig(folder) {
   const experiment2 = readJson(experimentConfigPath(folder)) ?? {};
@@ -16285,8 +16657,8 @@ function loadHarnessConfig(folder) {
   const targetOrigin = experiment2.targetOrigin?.replace(/\/+$/, "") ?? "";
   const defaultPath = experiment2.defaultPath ?? "/";
   const targetUrl = targetOrigin ? new URL(defaultPath, targetOrigin).toString() : "";
-  const id = experiment2.id ?? import_node_path8.default.basename(import_node_path8.default.dirname(folder));
-  const variation = import_node_path8.default.basename(folder);
+  const id = experiment2.id ?? import_node_path9.default.basename(import_node_path9.default.dirname(folder));
+  const variation = import_node_path9.default.basename(folder);
   return {
     experiment: experiment2,
     apex: {
@@ -16320,37 +16692,37 @@ function runAbHarness(args, cwd) {
 function artifactPaths(folder, experiment2) {
   const variant = experiment2.variant;
   if (variant?.endsWith(".bundle.js")) {
-    const jsPath = import_node_path8.default.join(folder, variant.replace(/\.bundle\.js$/, ".js"));
-    const cssPath = import_node_path8.default.join(folder, variant.replace(/\.bundle\.js$/, ".css"));
-    return { jsPath, cssPath: import_node_fs10.default.existsSync(cssPath) ? cssPath : null };
+    const jsPath = import_node_path9.default.join(folder, variant.replace(/\.bundle\.js$/, ".js"));
+    const cssPath = import_node_path9.default.join(folder, variant.replace(/\.bundle\.js$/, ".css"));
+    return { jsPath, cssPath: import_node_fs11.default.existsSync(cssPath) ? cssPath : null };
   }
-  const buildDir = import_node_path8.default.join(folder, "build");
-  const files = import_node_fs10.default.existsSync(buildDir) ? import_node_fs10.default.readdirSync(buildDir) : [];
+  const buildDir = import_node_path9.default.join(folder, "build");
+  const files = import_node_fs11.default.existsSync(buildDir) ? import_node_fs11.default.readdirSync(buildDir) : [];
   const js = files.find(
     (file) => file.endsWith(".js") && !file.endsWith(".bundle.js") && !file.endsWith(".min.js")
   );
   const css = files.find((file) => file.endsWith(".css") && !file.endsWith(".min.css"));
   if (!js) throw new Error("Could not find harness JS artifact in build/");
   return {
-    jsPath: import_node_path8.default.join(buildDir, js),
-    cssPath: css ? import_node_path8.default.join(buildDir, css) : null
+    jsPath: import_node_path9.default.join(buildDir, js),
+    cssPath: css ? import_node_path9.default.join(buildDir, css) : null
   };
 }
 async function uploadVersion(params) {
   const creds = requireCredentials();
   const { jsPath, cssPath } = artifactPaths(params.folder, params.experiment);
-  if (!import_node_fs10.default.existsSync(jsPath)) throw new Error(`Missing JS artifact: ${jsPath}`);
+  if (!import_node_fs11.default.existsSync(jsPath)) throw new Error(`Missing JS artifact: ${jsPath}`);
   const form = new FormData();
   form.append(
     "js",
-    new Blob([import_node_fs10.default.readFileSync(jsPath)], { type: "application/javascript" }),
-    import_node_path8.default.basename(jsPath)
+    new Blob([import_node_fs11.default.readFileSync(jsPath)], { type: "application/javascript" }),
+    import_node_path9.default.basename(jsPath)
   );
-  if (cssPath && import_node_fs10.default.existsSync(cssPath) && import_node_fs10.default.statSync(cssPath).size > 0) {
+  if (cssPath && import_node_fs11.default.existsSync(cssPath) && import_node_fs11.default.statSync(cssPath).size > 0) {
     form.append(
       "css",
-      new Blob([import_node_fs10.default.readFileSync(cssPath)], { type: "text/css" }),
-      import_node_path8.default.basename(cssPath)
+      new Blob([import_node_fs11.default.readFileSync(cssPath)], { type: "text/css" }),
+      import_node_path9.default.basename(cssPath)
     );
   }
   form.append(
@@ -16359,8 +16731,8 @@ async function uploadVersion(params) {
       ...params.apex,
       resetJs: cleanupResetJs(params.experiment),
       builtAt: (/* @__PURE__ */ new Date()).toISOString(),
-      jsPath: import_node_path8.default.relative(params.folder, jsPath),
-      cssPath: cssPath ? import_node_path8.default.relative(params.folder, cssPath) : null
+      jsPath: import_node_path9.default.relative(params.folder, jsPath),
+      cssPath: cssPath ? import_node_path9.default.relative(params.folder, cssPath) : null
     })
   );
   const res = await uploadHarnessVersion(creds, params.session.sessionId, form);
@@ -16402,11 +16774,11 @@ var harnessCommand = new Command("harness").description(
 harnessCommand.command("init").argument("<folder>", "AB Test Harness experiment folder").option("--force", "Overwrite existing apex.harness.json").action(function action24(folderArg, opts) {
   const folder = resolveFolder(folderArg);
   const targetPath = apexConfigPath(folder);
-  if (import_node_fs10.default.existsSync(targetPath) && !opts.force) {
+  if (import_node_fs11.default.existsSync(targetPath) && !opts.force) {
     fail(this, `${targetPath} already exists. Use --force to overwrite.`, EXIT_CODES.conflict);
   }
   const { apex } = loadHarnessConfig(folder);
-  import_node_fs10.default.writeFileSync(targetPath, `${JSON.stringify(apex, null, 2)}
+  import_node_fs11.default.writeFileSync(targetPath, `${JSON.stringify(apex, null, 2)}
 `, "utf8");
   output(
     this,
@@ -16472,7 +16844,7 @@ harnessCommand.command("dev").argument("<folder>", "AB Test Harness experiment f
     }
   };
   let debounce = null;
-  const watcher = import_node_fs10.default.watch(folder, { recursive: true }, (_event, filename) => {
+  const watcher = import_node_fs11.default.watch(folder, { recursive: true }, (_event, filename) => {
     const name = String(filename ?? "");
     if (!name || name.startsWith("build/") || name.includes("/build/")) return;
     if (debounce) clearTimeout(debounce);
@@ -16515,8 +16887,8 @@ harnessCommand.command("publish").argument("<folder>", "AB Test Harness experime
 // src/commands/operator.ts
 init_source();
 var import_node_crypto7 = __toESM(require("node:crypto"));
-var import_node_fs11 = __toESM(require("node:fs"));
-var import_node_path9 = __toESM(require("node:path"));
+var import_node_fs12 = __toESM(require("node:fs"));
+var import_node_path10 = __toESM(require("node:path"));
 var CANONICAL_FILE_RE = /^(src\/(?:index\.js|index\.scss|info\.js|mutations\.json)|experiment\.config\.json|metrics\.json|targeting\.json|dev-doc\.md|brand\.md|goals\/[a-zA-Z0-9_.-]+\.json|segments\/[a-zA-Z0-9_.-]+\.json|network\/[a-zA-Z0-9_.-]+\.recipe\.json)$/;
 function workspaceIssueFile(field, evidence) {
   if (field === "custom_js" || field === "reset_js") return "src/index.js";
@@ -16530,9 +16902,9 @@ function workspaceIssueFile(field, evidence) {
   if (field === "anti_flicker_selectors") return "experiment.config.json";
   return null;
 }
-function formatWorkspaceBlockingIssues(value) {
-  if (!value || typeof value !== "object") return null;
-  const issues = value.blockingIssues;
+function formatWorkspaceBlockingIssues(value2) {
+  if (!value2 || typeof value2 !== "object") return null;
+  const issues = value2.blockingIssues;
   if (!Array.isArray(issues) || issues.length === 0) return null;
   return issues.map((rawIssue, index) => {
     const issue = rawIssue && typeof rawIssue === "object" ? rawIssue : {};
@@ -16564,39 +16936,39 @@ function formatHarnessRefusal(message, details) {
   return issues ? `${message}
 ${issues}` : message;
 }
-function sha256Text2(value) {
-  return import_node_crypto7.default.createHash("sha256").update(value).digest("hex");
+function sha256Text2(value2) {
+  return import_node_crypto7.default.createHash("sha256").update(value2).digest("hex");
 }
-function byteLength(value) {
-  return Buffer.byteLength(value, "utf8");
+function byteLength(value2) {
+  return Buffer.byteLength(value2, "utf8");
 }
-function slugify2(value, fallback2 = "operator") {
-  const slug = value.normalize("NFKD").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 80);
+function slugify2(value2, fallback2 = "operator") {
+  const slug = value2.normalize("NFKD").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 80);
   return slug || fallback2;
 }
 function folderPath2(folder) {
-  return import_node_path9.default.resolve(process.cwd(), folder);
+  return import_node_path10.default.resolve(process.cwd(), folder);
 }
 function apexDir(folder) {
-  return import_node_path9.default.join(folder, ".apex");
+  return import_node_path10.default.join(folder, ".apex");
 }
 function sessionPath(folder) {
-  return import_node_path9.default.join(apexDir(folder), "session.json");
+  return import_node_path10.default.join(apexDir(folder), "session.json");
 }
 function readJsonFile(filePath) {
-  if (!import_node_fs11.default.existsSync(filePath)) return null;
-  return JSON.parse(import_node_fs11.default.readFileSync(filePath, "utf8"));
+  if (!import_node_fs12.default.existsSync(filePath)) return null;
+  return JSON.parse(import_node_fs12.default.readFileSync(filePath, "utf8"));
 }
-function writeJsonFile(filePath, value) {
-  import_node_fs11.default.mkdirSync(import_node_path9.default.dirname(filePath), { recursive: true });
-  import_node_fs11.default.writeFileSync(filePath, `${JSON.stringify(value, null, 2)}
+function writeJsonFile(filePath, value2) {
+  import_node_fs12.default.mkdirSync(import_node_path10.default.dirname(filePath), { recursive: true });
+  import_node_fs12.default.writeFileSync(filePath, `${JSON.stringify(value2, null, 2)}
 `, "utf8");
 }
 function readSession(folder) {
   const session = readJsonFile(sessionPath(folder));
   if (!session) {
-    const filesystemMarker = import_node_path9.default.join(apexDir(folder), "experiment-filesystem.json");
-    if (import_node_fs11.default.existsSync(filesystemMarker)) {
+    const filesystemMarker = import_node_path10.default.join(apexDir(folder), "experiment-filesystem.json");
+    if (import_node_fs12.default.existsSync(filesystemMarker)) {
       throw new CliError(
         "This folder is an experiment filesystem (apex experiments \u2026), not an operator workspace \u2014 run `apex experiments plan` here, or `apex workspace checkout` into a different folder.",
         EXIT_CODES.general,
@@ -16626,9 +16998,9 @@ function readSession(folder) {
   return session;
 }
 function writeSession(folder, session) {
-  import_node_fs11.default.mkdirSync(apexDir(folder), { recursive: true });
-  import_node_fs11.default.writeFileSync(
-    import_node_path9.default.join(apexDir(folder), ".gitignore"),
+  import_node_fs12.default.mkdirSync(apexDir(folder), { recursive: true });
+  import_node_fs12.default.writeFileSync(
+    import_node_path10.default.join(apexDir(folder), ".gitignore"),
     "session.json\nharness-session.json\n",
     "utf8"
   );
@@ -16652,15 +17024,15 @@ function listLocalWorkspaceFiles(folder) {
     "brand.md"
   ];
   function visit2(dir) {
-    if (!import_node_fs11.default.existsSync(dir)) return;
-    for (const entry of import_node_fs11.default.readdirSync(dir, { withFileTypes: true })) {
-      const absPath = import_node_path9.default.join(dir, entry.name);
+    if (!import_node_fs12.default.existsSync(dir)) return;
+    for (const entry of import_node_fs12.default.readdirSync(dir, { withFileTypes: true })) {
+      const absPath = import_node_path10.default.join(dir, entry.name);
       if (entry.isDirectory()) {
         visit2(absPath);
         continue;
       }
-      const relativePath = validateCanonicalPath(import_node_path9.default.relative(folder, absPath));
-      const content = import_node_fs11.default.readFileSync(absPath, "utf8");
+      const relativePath = validateCanonicalPath(import_node_path10.default.relative(folder, absPath));
+      const content = import_node_fs12.default.readFileSync(absPath, "utf8");
       files.push({
         path: relativePath,
         absPath,
@@ -16670,11 +17042,11 @@ function listLocalWorkspaceFiles(folder) {
       });
     }
   }
-  for (const root of roots) visit2(import_node_path9.default.join(folder, root));
+  for (const root of roots) visit2(import_node_path10.default.join(folder, root));
   for (const file of topLevel) {
-    const absPath = import_node_path9.default.join(folder, file);
-    if (!import_node_fs11.default.existsSync(absPath)) continue;
-    const content = import_node_fs11.default.readFileSync(absPath, "utf8");
+    const absPath = import_node_path10.default.join(folder, file);
+    if (!import_node_fs12.default.existsSync(absPath)) continue;
+    const content = import_node_fs12.default.readFileSync(absPath, "utf8");
     files.push({
       path: file,
       absPath,
@@ -16698,7 +17070,7 @@ function validateJsonFiles(files) {
   }
 }
 function readExperimentConfig(folder) {
-  return readJsonFile(import_node_path9.default.join(folder, "experiment.config.json")) ?? {};
+  return readJsonFile(import_node_path10.default.join(folder, "experiment.config.json")) ?? {};
 }
 function resolveVariation(exp, variationArg) {
   const variations = exp.variations ?? [];
@@ -16715,9 +17087,9 @@ function resolveVariation(exp, variationArg) {
 function writeWorkspaceFiles(folder, workspace) {
   for (const file of workspace.files) {
     const relativePath = validateCanonicalPath(file.path);
-    const absPath = import_node_path9.default.join(folder, relativePath);
-    import_node_fs11.default.mkdirSync(import_node_path9.default.dirname(absPath), { recursive: true });
-    import_node_fs11.default.writeFileSync(absPath, file.content, "utf8");
+    const absPath = import_node_path10.default.join(folder, relativePath);
+    import_node_fs12.default.mkdirSync(import_node_path10.default.dirname(absPath), { recursive: true });
+    import_node_fs12.default.writeFileSync(absPath, file.content, "utf8");
   }
 }
 function sessionFromWorkspace(input) {
@@ -16785,10 +17157,10 @@ async function uploadCurrentArtifactVersion(folder, sessionId) {
   form.append(
     "js",
     new Blob([js.content], { type: "application/javascript" }),
-    import_node_path9.default.basename(js.path)
+    import_node_path10.default.basename(js.path)
   );
   if (css && css.content.trim()) {
-    form.append("css", new Blob([css.content], { type: "text/css" }), import_node_path9.default.basename(css.path));
+    form.append("css", new Blob([css.content], { type: "text/css" }), import_node_path10.default.basename(css.path));
   }
   form.append("manifest", JSON.stringify(manifest));
   const res = await uploadHarnessVersion(creds, sessionId, form);
@@ -16915,7 +17287,7 @@ operatorCommand.command("checkout").argument("<experiment-id>", "Apex experiment
         classifyStatus(workspace.status),
         workspace.errorDetails
       );
-    import_node_fs11.default.mkdirSync(folder, { recursive: true });
+    import_node_fs12.default.mkdirSync(folder, { recursive: true });
     writeWorkspaceFiles(folder, workspace.data);
     writeSession(
       folder,
@@ -16982,8 +17354,8 @@ operatorCommand.command("dev").argument("[folder]", "Operator workspace folder",
     const session = readSession(folder);
     const harnessSession = await createExactHarnessSession(folder, session);
     const version = await uploadCurrentArtifactVersion(folder, harnessSession.sessionId);
-    import_node_fs11.default.mkdirSync(apexDir(folder), { recursive: true });
-    writeJsonFile(import_node_path9.default.join(apexDir(folder), "harness-session.json"), {
+    import_node_fs12.default.mkdirSync(apexDir(folder), { recursive: true });
+    writeJsonFile(import_node_path10.default.join(apexDir(folder), "harness-session.json"), {
       sessionId: harnessSession.sessionId,
       experimentId: harnessSession.experimentId,
       variationId: harnessSession.variationId,
@@ -17038,7 +17410,7 @@ operatorCommand.command("dev").argument("[folder]", "Operator workspace folder",
       }
     };
     let timer = null;
-    const watcher = import_node_fs11.default.watch(folder, { recursive: true }, (_event, filename) => {
+    const watcher = import_node_fs12.default.watch(folder, { recursive: true }, (_event, filename) => {
       const name = String(filename ?? "");
       if (!name || name.startsWith(".apex/") || name.includes("/.apex/")) return;
       if (timer) clearTimeout(timer);
@@ -17073,17 +17445,17 @@ operatorCommand.command("publish").argument("[folder]", "Operator workspace fold
 
 // src/commands/roadmap.ts
 init_source();
-var import_node_fs12 = __toESM(require("node:fs"));
-var import_node_path10 = __toESM(require("node:path"));
+var import_node_fs13 = __toESM(require("node:fs"));
+var import_node_path11 = __toESM(require("node:path"));
 var LEGACY_OUTPUT_REMOVAL_VERSION = "0.7.0";
-function truncate(value, max) {
-  const text2 = typeof value === "string" ? value : value == null ? "" : String(value);
+function truncate(value2, max) {
+  const text2 = typeof value2 === "string" ? value2 : value2 == null ? "" : String(value2);
   if (text2.length <= max) return text2;
   return `${text2.slice(0, Math.max(0, max - 3))}...`;
 }
-function score(value) {
-  if (typeof value !== "number" || !Number.isFinite(value)) return "-";
-  return Number.isInteger(value) ? String(value) : value.toFixed(1);
+function score(value2) {
+  if (typeof value2 !== "number" || !Number.isFinite(value2)) return "-";
+  return Number.isInteger(value2) ? String(value2) : value2.toFixed(1);
 }
 function experimentState(item) {
   const linked = item.linked_experiments ?? [];
@@ -17184,9 +17556,9 @@ var handoff = new Command("handoff").description(
 `;
   const outputData = opts.instructions ? { roadmapItemId: id, instructions: String(payload.instructions ?? "") } : payload;
   if (opts.out || opts.output) {
-    const target = import_node_path10.default.resolve(process.cwd(), opts.out ?? opts.output);
-    import_node_fs12.default.mkdirSync(import_node_path10.default.dirname(target), { recursive: true });
-    import_node_fs12.default.writeFileSync(target, rendered, "utf8");
+    const target = import_node_path11.default.resolve(process.cwd(), opts.out ?? opts.output);
+    import_node_fs13.default.mkdirSync(import_node_path11.default.dirname(target), { recursive: true });
+    import_node_fs13.default.writeFileSync(target, rendered, "utf8");
     output(this, { path: target, roadmapItemId: id }, () => printSuccess(`Wrote ${target}`));
     return;
   }
@@ -17200,13 +17572,13 @@ roadmapCommand.addCommand(handoff);
 
 // src/commands/tracking.ts
 init_source();
-var import_node_fs13 = __toESM(require("node:fs"));
-var import_node_path11 = __toESM(require("node:path"));
+var import_node_fs14 = __toESM(require("node:fs"));
+var import_node_path12 = __toESM(require("node:path"));
 function normalizeUrl(input) {
-  const value = input.trim();
-  if (!value) throw new Error("URL cannot be empty");
+  const value2 = input.trim();
+  if (!value2) throw new Error("URL cannot be empty");
   try {
-    return new URL(value.includes("://") ? value : `https://${value}`);
+    return new URL(value2.includes("://") ? value2 : `https://${value2}`);
   } catch {
     throw new Error(`Invalid URL: ${input}`);
   }
@@ -17248,14 +17620,14 @@ function commonCookieDomain(hostnames) {
 }
 var DEFAULT_MANIFEST_PATH = ".apex/tracking-manifest.json";
 function readManifest(filePath) {
-  if (!import_node_fs13.default.existsSync(filePath)) throw new Error(`Manifest not found: ${filePath}`);
-  const parsed = JSON.parse(import_node_fs13.default.readFileSync(filePath, "utf8"));
+  if (!import_node_fs14.default.existsSync(filePath)) throw new Error(`Manifest not found: ${filePath}`);
+  const parsed = JSON.parse(import_node_fs14.default.readFileSync(filePath, "utf8"));
   if (parsed.schemaVersion !== 1) throw new Error("Unsupported tracking manifest schema");
   return parsed;
 }
 function writeManifest(filePath, manifest) {
-  import_node_fs13.default.mkdirSync(import_node_path11.default.dirname(filePath), { recursive: true });
-  import_node_fs13.default.writeFileSync(filePath, `${JSON.stringify(manifest, null, 2)}
+  import_node_fs14.default.mkdirSync(import_node_path12.default.dirname(filePath), { recursive: true });
+  import_node_fs14.default.writeFileSync(filePath, `${JSON.stringify(manifest, null, 2)}
 `, "utf8");
 }
 function buildSnippet(shopId, endpoint) {
@@ -17322,7 +17694,7 @@ function buildManifest(urlArgs, opts) {
   };
 }
 function manifestPath(input) {
-  return import_node_path11.default.resolve(process.cwd(), input ?? DEFAULT_MANIFEST_PATH);
+  return import_node_path12.default.resolve(process.cwd(), input ?? DEFAULT_MANIFEST_PATH);
 }
 function printManifestPlan(manifest) {
   console.log(source_default.bold("Apex tracking ingestion plan"));
@@ -17472,7 +17844,7 @@ trackingCommand.command("latency").description("Measure forced-preview versus na
       ["natural", summary.natural],
       ...summary.qa_session ? [["qa_session", summary.qa_session]] : []
     ];
-    const ms = (value) => value === null ? "-" : String(Math.round(value));
+    const ms = (value2) => value2 === null ? "-" : String(Math.round(value2));
     printTable(
       [
         "Bucket",
@@ -17508,7 +17880,7 @@ trackingCommand.command("latency").description("Measure forced-preview versus na
 });
 
 // src/commands/events.ts
-var import_node_fs14 = __toESM(require("node:fs"));
+var import_node_fs15 = __toESM(require("node:fs"));
 var maxWindowMs = 31 * 864e5;
 function correctedWindowStep(opts, nowMs) {
   const fromMs = Date.parse(opts.from);
@@ -17519,7 +17891,7 @@ function correctedWindowStep(opts, nowMs) {
       why: "No valid export window exists from this start; --to must be after --from and at or before now."
     };
   }
-  const quote = (value) => `'${value.replace(/'/g, "'\\''")}'`;
+  const quote = (value2) => `'${value2.replace(/'/g, "'\\''")}'`;
   const args = [
     "apex events export",
     `--from ${quote(opts.from)}`,
@@ -17611,7 +17983,7 @@ eventsCommand.command("export").description(
   if (opts.jsonSummary && !opts.out) {
     fail(command, "--json-summary requires --out for the event rows", EXIT_CODES.validation);
   }
-  const output2 = opts.out ? import_node_fs14.default.createWriteStream(opts.out, { flags: "wx" }) : null;
+  const output2 = opts.out ? import_node_fs15.default.createWriteStream(opts.out, { flags: "wx" }) : null;
   let outputError = null;
   output2?.on("error", (error) => {
     outputError = error;
@@ -17659,7 +18031,7 @@ eventsCommand.command("export").description(
         from: opts.from,
         to: opts.to,
         experiment: opts.experiment,
-        eventTypes: opts.eventType?.split(",").map((value) => value.trim()).filter(Boolean),
+        eventTypes: opts.eventType?.split(",").map((value2) => value2.trim()).filter(Boolean),
         qa: opts.qa,
         limit,
         cursor
@@ -17750,7 +18122,7 @@ eventsCommand.command("export").description(
   } catch (error) {
     if (output2 && opts.out) {
       output2.destroy();
-      import_node_fs14.default.rmSync(opts.out, { force: true });
+      import_node_fs15.default.rmSync(opts.out, { force: true });
       const suffix = `The partial file ${opts.out} was removed.`;
       if (error instanceof CliError)
         throw new CliError(
@@ -17771,8 +18143,8 @@ eventsCommand.command("export").description(
 
 // src/commands/goals.ts
 init_source();
-var import_node_fs15 = __toESM(require("node:fs"));
-var import_node_path12 = __toESM(require("node:path"));
+var import_node_fs16 = __toESM(require("node:fs"));
+var import_node_path13 = __toESM(require("node:path"));
 
 // ../sdk/src/safe-regex.ts
 var MAX_PATTERN_LENGTH = 1024;
@@ -17819,8 +18191,10 @@ var GOALS_PAGE_SIZE = 100;
 var MAX_GOAL_PAGES = 100;
 var MAX_PAGE_LOOKUP_PAGES = 1e3;
 var UUID_V1_TO_V8 = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
-var PAGE_OPTION_DESCRIPTION = "Page scope: page ID or page key (required for click goals, optional for pageview; a page key needs pages:read; a page ID does not; list pages with apex pages list)";
-var PAGE_NEXT_STEPS = [{ command: "apex pages list", why: "Find the page ID or key." }];
+var PAGE_OPTION_DESCRIPTION = "Page scope: page ID or page key with lookup (required for click goals, optional for pageview; a page key needs pages:read; a page ID does not; list pages with apex pages list)";
+var PAGE_REQUIRED_MESSAGE = "Click goals need a page: pass --page-id <page ID> or --page <page ID or key> (list pages with apex pages list)";
+var PAGE_NEXT_STEPS = [{ command: "apex pages list", why: PAGE_REQUIRED_MESSAGE }];
+var PAGE_ID_OPTION_DESCRIPTION = "Page ID only (UUID; no lookup or pages:read permission needed)";
 var NON_QUANTIFIABLE = /* @__PURE__ */ new Set(["(", "|", "^", "$"]);
 function urlPatternDependence(pattern) {
   let fragment = false;
@@ -17949,10 +18323,10 @@ function printSuggestions(data) {
     for (const trigger of data.triggers) console.log(`- ${trigger.page}: ${trigger.description}`);
   }
 }
-function parseCapture(command, value) {
-  if (!value) return void 0;
-  const source = value.startsWith("@") ? value.slice(1) : value;
-  const text2 = value.startsWith("@") || import_node_fs15.default.existsSync(source) ? import_node_fs15.default.readFileSync(import_node_path12.default.resolve(process.cwd(), source), "utf8") : value;
+function parseCapture(command, value2) {
+  if (!value2) return void 0;
+  const source = value2.startsWith("@") ? value2.slice(1) : value2;
+  const text2 = value2.startsWith("@") || import_node_fs16.default.existsSync(source) ? import_node_fs16.default.readFileSync(import_node_path13.default.resolve(process.cwd(), source), "utf8") : value2;
   try {
     return JSON.parse(text2);
   } catch (error) {
@@ -17961,10 +18335,10 @@ function parseCapture(command, value) {
   }
 }
 function cleanBody(input) {
-  return Object.fromEntries(Object.entries(input).filter(([, value]) => value !== void 0));
+  return Object.fromEntries(Object.entries(input).filter(([, value2]) => value2 !== void 0));
 }
-async function resolveGoalPageId(command, creds, value) {
-  if (UUID_V1_TO_V8.test(value)) return value;
+async function resolveGoalPageId(command, creds, value2) {
+  if (UUID_V1_TO_V8.test(value2)) return value2;
   let cursor;
   for (let page = 0; page < MAX_PAGE_LOOKUP_PAGES; page += 1) {
     const response = await requestTargetingResource(
@@ -18002,7 +18376,7 @@ async function resolveGoalPageId(command, creds, value) {
     }
     if (!("data" in response.data) || !Array.isArray(response.data.data)) break;
     const pageData = response.data;
-    const match2 = pageData.data.find((item) => item.key === value);
+    const match2 = pageData.data.find((item) => item.key === value2);
     if (match2) return match2.id;
     const next = pageData.pagination?.next_cursor ?? null;
     if (!pageData.pagination?.has_more || !next || next === cursor) break;
@@ -18010,11 +18384,29 @@ async function resolveGoalPageId(command, creds, value) {
   }
   fail(
     command,
-    `No active page with key ${value} in this shop; list pages with apex pages list`,
+    `No active page with key ${value2} in this shop; list pages with apex pages list`,
     EXIT_CODES.validation,
     { code: "page_not_found", next_steps: PAGE_NEXT_STEPS }
   );
 }
+async function goalPageOption(command, creds, opts, allowNull = false) {
+  if (opts.page !== void 0 && opts.pageId !== void 0) {
+    fail(command, "Use either --page or --page-id, not both", EXIT_CODES.validation, {
+      code: "page_options_conflict"
+    });
+  }
+  if (typeof opts.pageId === "string") {
+    if (allowNull && opts.pageId === "null") return null;
+    if (!UUID_V1_TO_V8.test(opts.pageId)) {
+      fail(command, "--page-id must be a page UUID", EXIT_CODES.validation, {
+        code: "page_id_invalid"
+      });
+    }
+    return opts.pageId;
+  }
+  if (allowNull && opts.page === "null") return null;
+  return typeof opts.page === "string" ? resolveGoalPageId(command, creds, opts.page) : void 0;
+}
 function printGoal(goal) {
   console.log();
   console.log(source_default.bold(goal.name));
@@ -18037,6 +18429,7 @@ var list2 = new Command("list").alias("ls").description("List goals").option("-n
   if (!res.ok || !res.data) {
     fail(this, res.error ?? "Failed to list goals", classifyStatus(res.status), res.errorDetails);
   }
+  warnReplacementCharacters("goals", res.data, ["data[].name"]);
   output(this, res.data, () => {
     if (res.data.data.length === 0) {
       console.log(source_default.dim("No goals found."));
@@ -18055,22 +18448,25 @@ var list2 = new Command("list").alias("ls").description("List goals").option("-n
     );
   });
 });
-var create2 = new Command("create").description("Create a goal").requiredOption("--name <name>", "Goal name").requiredOption("--type <type>", "click|pageview|custom|revenue").option("--measurement <measurement>", "conversion|value", "conversion").option("--value-property <property>", "Numeric event property for value goals").option("--value-unit <unit>", "currency|number|duration_seconds|percent").option("--selector <selector>", "CSS selector for click goals").option("--text-match <text>", "Text match for click goals").option("--url-pattern <pattern>", "URL pattern for pageview goals").option("--event-name <name>", "Event name for custom goals").option("--page <id-or-key>", PAGE_OPTION_DESCRIPTION).option("--count-once", "Count only once per visitor").option("--capture <json-or-path>", "Capture JSON array or @path").action(async function action35(opts) {
+var create2 = new Command("create").description("Create a goal").requiredOption("--name <name>", "Goal name").requiredOption("--type <type>", "click|pageview|custom|revenue").option("--measurement <measurement>", "conversion|value", "conversion").option("--value-property <property>", "Numeric event property for value goals").option("--value-unit <unit>", "currency|number|duration_seconds|percent").option("--selector <selector>", "CSS selector for click goals").option("--text-match <text>", "Text match for click goals").option("--url-pattern <pattern>", "URL pattern for pageview goals").option("--event-name <name>", "Event name for custom goals").option("--page <id-or-key>", PAGE_OPTION_DESCRIPTION).option("--page-id <id>", PAGE_ID_OPTION_DESCRIPTION).option("--count-once", "Count only once per visitor").option("--capture <json-or-path>", "Capture JSON array or @path").action(async function action35(opts) {
   const creds = requireCredentials();
-  if (opts.type === "click" && !opts.page) {
-    fail(
-      this,
-      "Click goals need a page: pass --page <page id or key> (list pages with apex pages list)",
-      EXIT_CODES.validation,
-      { code: "page_required", next_steps: PAGE_NEXT_STEPS }
-    );
+  if (opts.page !== void 0 && opts.pageId !== void 0) {
+    fail(this, "Use either --page or --page-id, not both", EXIT_CODES.validation, {
+      code: "page_options_conflict"
+    });
+  }
+  if (opts.type === "click" && !opts.page && !opts.pageId) {
+    fail(this, PAGE_REQUIRED_MESSAGE, EXIT_CODES.validation, {
+      code: "page_required",
+      next_steps: PAGE_NEXT_STEPS
+    });
   }
-  if ((opts.type === "custom" || opts.type === "revenue") && opts.page) {
-    fail(this, `--page is not supported for ${opts.type} goals`, EXIT_CODES.validation, {
+  if ((opts.type === "custom" || opts.type === "revenue") && (opts.page || opts.pageId)) {
+    fail(this, `Page scope is not supported for ${opts.type} goals`, EXIT_CODES.validation, {
       code: "page_not_supported"
     });
   }
-  const pageId = typeof opts.page === "string" ? await resolveGoalPageId(this, creds, opts.page) : void 0;
+  const pageId = await goalPageOption(this, creds, opts);
   const body5 = cleanBody({
     name: opts.name,
     type: opts.type,
@@ -18094,14 +18490,15 @@ var create2 = new Command("create").description("Create a goal").requiredOption(
       res.errorDetails
     );
   }
+  warnReplacementCharacters("goal", res.data, ["name"]);
   output(this, res.data, () => printGoal(res.data));
 });
 var update2 = new Command("update").description("Update a goal").argument("<id>", "Goal ID").option("--name <name>", "Goal name").option("--type <type>", "click|pageview|custom|revenue").option("--measurement <measurement>", "conversion|value").option(
   "--value-property <property>",
   "Numeric event property for value goals; pass null to clear"
-).option("--value-unit <unit>", "currency|number|duration_seconds|percent; pass null to clear").option("--selector <selector>", "CSS selector for click goals").option("--text-match <text>", "Text match for click goals").option("--url-pattern <pattern>", "URL pattern for pageview goals").option("--event-name <name>", "Event name for custom goals").option("--page <id-or-key>", `${PAGE_OPTION_DESCRIPTION}; pass null to clear`).option("--count-once", "Count only once per visitor").option("--no-count-once", "Do not count only once per visitor").option("--capture <json-or-path>", "Capture JSON array or @path").action(async function action36(id, opts) {
+).option("--value-unit <unit>", "currency|number|duration_seconds|percent; pass null to clear").option("--selector <selector>", "CSS selector for click goals").option("--text-match <text>", "Text match for click goals").option("--url-pattern <pattern>", "URL pattern for pageview goals").option("--event-name <name>", "Event name for custom goals").option("--page <id-or-key>", `${PAGE_OPTION_DESCRIPTION}; pass null to clear`).option("--page-id <id>", `${PAGE_ID_OPTION_DESCRIPTION}; pass null to clear`).option("--count-once", "Count only once per visitor").option("--no-count-once", "Do not count only once per visitor").option("--capture <json-or-path>", "Capture JSON array or @path").action(async function action36(id, opts) {
   const creds = requireCredentials();
-  const pageId = opts.page === "null" ? null : typeof opts.page === "string" ? await resolveGoalPageId(this, creds, opts.page) : void 0;
+  const pageId = await goalPageOption(this, creds, opts, true);
   const body5 = cleanBody({
     name: opts.name,
     type: opts.type,
@@ -18128,6 +18525,7 @@ var update2 = new Command("update").description("Update a goal").argument("<id>"
       res.errorDetails
     );
   }
+  warnReplacementCharacters("goal", res.data, ["name"]);
   output(this, res.data, () => printGoal(res.data));
 });
 var test = new Command("test").description("Dry run a goal URL pattern against traffic").option(
@@ -18235,8 +18633,8 @@ var suggest = new Command("suggest").description("Suggest goals and funnels from
           "Confirmation required; rerun with --yes to create suggested goals.",
           EXIT_CODES.confirmationRequired
         );
-      const readline3 = await import("node:readline");
-      const rl = readline3.createInterface({ input: process.stdin, output: process.stderr });
+      const readline4 = await import("node:readline");
+      const rl = readline4.createInterface({ input: process.stdin, output: process.stderr });
       const answer = await new Promise(
         (resolve2) => rl.question(source_default.yellow("Create this goal? [y/N] "), resolve2)
       );
@@ -18275,12 +18673,12 @@ Examples:
 
 // src/commands/funnels.ts
 init_source();
-var import_node_fs16 = __toESM(require("node:fs"));
-var import_node_path13 = __toESM(require("node:path"));
+var import_node_fs17 = __toESM(require("node:fs"));
+var import_node_path14 = __toESM(require("node:path"));
 function readSteps(command, file) {
   let parsed;
   try {
-    parsed = JSON.parse(import_node_fs16.default.readFileSync(import_node_path13.default.resolve(process.cwd(), file), "utf8"));
+    parsed = JSON.parse(import_node_fs17.default.readFileSync(import_node_path14.default.resolve(process.cwd(), file), "utf8"));
   } catch (error) {
     fail(
       command,
@@ -18410,8 +18808,8 @@ function printEnvironments(items) {
     [24, 32, 8, 64]
   );
 }
-function normalizeEnvironmentDomain(value) {
-  const candidate = value.trim().toLowerCase();
+function normalizeEnvironmentDomain(value2) {
+  const candidate = value2.trim().toLowerCase();
   if (!candidate) return "";
   try {
     const parsed = new URL(
@@ -18470,11 +18868,11 @@ var setDomain = new Command("set-domain").description("Map a domain to a runtime
       ...item,
       domains: item.key === opts.environment ? [
         ...item.domains.filter(
-          (value) => normalizeEnvironmentDomain(value) !== normalizedDomain
+          (value2) => normalizeEnvironmentDomain(value2) !== normalizedDomain
         ),
         normalizedDomain
       ] : item.domains.filter(
-        (value) => normalizeEnvironmentDomain(value) !== normalizedDomain
+        (value2) => normalizeEnvironmentDomain(value2) !== normalizedDomain
       )
     }));
     result = await updateEnvironments(requireCredentials(), {
@@ -18505,7 +18903,7 @@ var removeDomain = new Command("remove-domain").description("Remove a domain map
     const items = current.environments.items.map((item) => ({
       ...item,
       domains: item.domains.filter(
-        (value) => normalizeEnvironmentDomain(value) !== normalizedDomain
+        (value2) => normalizeEnvironmentDomain(value2) !== normalizedDomain
       )
     }));
     result = await updateEnvironments(requireCredentials(), {
@@ -18594,8 +18992,8 @@ var off = new Command("off").description("Disable consent gating").action(async
 var consentCommand = new Command("consent").description("Manage consent gating").addCommand(get2).addCommand(set).addCommand(off);
 
 // src/commands/project-code.ts
-var import_node_fs17 = require("node:fs");
-var import_node_path14 = require("node:path");
+var import_node_fs18 = require("node:fs");
+var import_node_path15 = require("node:path");
 
 // src/commands/runtime-settings-shop.ts
 var uuidPattern = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
@@ -18640,17 +19038,17 @@ var fields = ["enabled", "css", "helperJs", "js"];
 function readPatch(command, file) {
   let input;
   try {
-    input = JSON.parse((0, import_node_fs17.readFileSync)(file, "utf8"));
+    input = JSON.parse((0, import_node_fs18.readFileSync)(file, "utf8"));
   } catch (error) {
     fail(command, `Cannot read project code JSON: ${String(error)}`, EXIT_CODES.validation);
   }
   if (!input || typeof input !== "object" || Array.isArray(input) || Object.keys(input).length === 0) {
     fail(command, "Project code must be a nonempty partial object", EXIT_CODES.validation);
   }
-  for (const [key, value] of Object.entries(input)) {
+  for (const [key, value2] of Object.entries(input)) {
     if (!fields.includes(key))
       fail(command, `Unknown project code field: ${key}`, EXIT_CODES.validation);
-    if (key === "enabled" ? typeof value !== "boolean" : value !== null && (typeof value !== "string" || value.length > 2e4)) {
+    if (key === "enabled" ? typeof value2 !== "boolean" : value2 !== null && (typeof value2 !== "string" || value2.length > 2e4)) {
       fail(
         command,
         `${key} must be ${key === "enabled" ? "a boolean" : "null or a string of at most 20,000 characters"}`,
@@ -18743,9 +19141,9 @@ for (const mode of ["diff", "set"]) {
       );
       return;
     }
-    const backupPath = (0, import_node_path14.resolve)(options.backup);
+    const backupPath = (0, import_node_path15.resolve)(options.backup);
     try {
-      (0, import_node_fs17.writeFileSync)(
+      (0, import_node_fs18.writeFileSync)(
         backupPath,
         `${JSON.stringify({ ...identity2, ...current, capturedAt: (/* @__PURE__ */ new Date()).toISOString() }, null, 2)}
 `,
@@ -18804,17 +19202,17 @@ for (const mode of ["diff", "set"]) {
 }
 
 // src/commands/triggers.ts
-var import_node_fs18 = __toESM(require("node:fs"));
-var import_node_path15 = __toESM(require("node:path"));
+var import_node_fs19 = __toESM(require("node:fs"));
+var import_node_path16 = __toESM(require("node:path"));
 
 // src/trigger-proposal.ts
-function runtimePath(path26) {
-  return path26.replaceAll("[]", ".0");
+function runtimePath(path27) {
+  return path27.replaceAll("[]", ".0");
 }
-function fieldsFrom(value, prefix = "", descriptorList = false) {
-  if (!value || typeof value !== "object") return [];
-  if (Array.isArray(value)) {
-    return value.flatMap(
+function fieldsFrom(value2, prefix = "", descriptorList = false) {
+  if (!value2 || typeof value2 !== "object") return [];
+  if (Array.isArray(value2)) {
+    return value2.flatMap(
       (item, index) => fieldsFrom(
         item,
         descriptorList ? prefix : prefix ? `${prefix}.${index}` : String(index),
@@ -18822,7 +19220,7 @@ function fieldsFrom(value, prefix = "", descriptorList = false) {
       )
     );
   }
-  const record4 = value;
+  const record4 = value2;
   const explicitPath = typeof record4.path === "string" ? record4.path : void 0;
   if (descriptorList && explicitPath) {
     const rawValues = record4.values ?? record4.samples ?? record4.examples ?? record4.example;
@@ -18849,7 +19247,7 @@ function fieldsFrom(value, prefix = "", descriptorList = false) {
     return fieldsFrom(child, next);
   });
 }
-function isDescriptorArray(value) {
+function isDescriptorArray(value2) {
   const descriptorKeys = /* @__PURE__ */ new Set([
     "path",
     "values",
@@ -18864,7 +19262,7 @@ function isDescriptorArray(value) {
     "seen",
     "type_collision"
   ]);
-  return Array.isArray(value) && value.length > 0 && value.every((item) => {
+  return Array.isArray(value2) && value2.length > 0 && value2.every((item) => {
     if (!item || typeof item !== "object" || Array.isArray(item)) return false;
     const record4 = item;
     return typeof record4.path === "string" && record4.path.length > 0 && Object.keys(record4).every((key) => descriptorKeys.has(key));
@@ -18887,15 +19285,15 @@ function candidatesFrom(report) {
   }
   return [root];
 }
-function score2(path26, patterns) {
+function score2(path27, patterns) {
   return patterns.reduce(
-    (total, pattern, index) => total + (pattern.test(path26) ? patterns.length - index : 0),
+    (total, pattern, index) => total + (pattern.test(path27) ? patterns.length - index : 0),
     0
   );
 }
 function best(fields3, patterns, numeric2 = false) {
   const ranked = fields3.filter(
-    (field) => !numeric2 || field.numericType === true || field.values.some((value) => typeof value === "number") || field.magnitude !== void 0
+    (field) => !numeric2 || field.numericType === true || field.values.some((value2) => typeof value2 === "number") || field.magnitude !== void 0
   ).map((field) => ({ field, score: score2(field.path.toLowerCase(), patterns) })).filter((item) => item.score > 0).sort((a, b) => b.score - a.score || (b.field.magnitude ?? 0) - (a.field.magnitude ?? 0));
   if (!ranked.length) return [];
   const top = ranked[0].score;
@@ -19020,55 +19418,55 @@ var pathPattern = new RegExp(runtime_settings_trigger_constants_default.dotPathP
 var signalPathPattern = new RegExp(runtime_settings_trigger_constants_default.signalPathPattern);
 var valueTypes = new Set(runtime_settings_trigger_constants_default.valueTypes);
 var whenOps = new Set(runtime_settings_trigger_constants_default.whenOps);
-function strictObject(value, location, keys) {
-  if (!value || typeof value !== "object" || Array.isArray(value))
+function strictObject(value2, location, keys) {
+  if (!value2 || typeof value2 !== "object" || Array.isArray(value2))
     throw new Error(`${location} must be an object`);
-  const record4 = value;
+  const record4 = value2;
   for (const key of Object.keys(record4))
     if (!keys.has(key)) throw new Error(`${location}.${key} is not allowed`);
   return record4;
 }
-function optionalType(value, type, location) {
-  if (value !== void 0 && typeof value !== type)
+function optionalType(value2, type, location) {
+  if (value2 !== void 0 && typeof value2 !== type)
     throw new Error(`${location} must be a ${type}`);
 }
-function strictPath(value, location, required = false) {
-  if (value === void 0 && !required) return;
-  if (typeof value !== "string" || !pathPattern.test(value))
+function strictPath(value2, location, required = false) {
+  if (value2 === void 0 && !required) return;
+  if (typeof value2 !== "string" || !pathPattern.test(value2))
     throw new Error(
       `${location} must use dot-path syntax with property or array-index segments (for example: ecommerce.items.0.price); bracket syntax is not accepted`
     );
 }
-function strictSource(value, location, allowSignal, required = false) {
-  if (value === void 0 && !required) return;
-  const sources = Array.isArray(value) ? value : [value];
-  if (Array.isArray(value) && (value.length < 1 || value.length > runtime_settings_trigger_constants_default.maxSourcePaths))
+function strictSource(value2, location, allowSignal, required = false) {
+  if (value2 === void 0 && !required) return;
+  const sources = Array.isArray(value2) ? value2 : [value2];
+  if (Array.isArray(value2) && (value2.length < 1 || value2.length > runtime_settings_trigger_constants_default.maxSourcePaths))
     throw new Error(`${location} must contain 1 to ${runtime_settings_trigger_constants_default.maxSourcePaths} paths`);
   sources.forEach((source, index) => {
-    const sourceLocation = Array.isArray(value) ? `${location}[${index}]` : location;
+    const sourceLocation = Array.isArray(value2) ? `${location}[${index}]` : location;
     if (allowSignal && typeof source === "string" && signalPathPattern.test(source)) return;
     strictPath(source, sourceLocation, true);
   });
 }
-function defaultMatchesValueType(value, valueType) {
+function defaultMatchesValueType(value2, valueType) {
   if (valueType === "number") {
-    if (typeof value !== "string") return Number.isFinite(Number(value));
-    const text2 = String(value).trim();
+    if (typeof value2 !== "string") return Number.isFinite(Number(value2));
+    const text2 = String(value2).trim();
     const normalized = /^-?\d{1,3}(\.\d{3})+,\d+$/.test(text2) ? text2.replace(/\./g, "").replace(",", ".") : /^-?\d+,\d+$/.test(text2) ? text2.replace(",", ".") : text2;
     return Number.isFinite(Number(normalized));
   }
   if (valueType === "boolean") {
-    if (typeof value === "boolean") return true;
+    if (typeof value2 === "boolean") return true;
     return ["1", "true", "yes", "on", "0", "false", "no", "off"].includes(
-      String(value).trim().toLowerCase()
+      String(value2).trim().toLowerCase()
     );
   }
   return true;
 }
-function strictTransform(value, valueType, location) {
-  if (value === void 0) return;
+function strictTransform(value2, valueType, location) {
+  if (value2 === void 0) return;
   const transform = strictObject(
-    value,
+    value2,
     location,
     /* @__PURE__ */ new Set(["trim", "lowercase", "map", "scale", "default"])
   );
@@ -19101,7 +19499,7 @@ function strictTransform(value, valueType, location) {
   if (transform.default !== void 0 && !defaultMatchesValueType(transform.default, valueType))
     throw new Error(`${location}.default must coerce to the mapping valueType`);
 }
-function strictMapping(value, location, revenueProperty) {
+function strictMapping(value2, location, revenueProperty) {
   const keys = /* @__PURE__ */ new Set([
     "from",
     "to",
@@ -19109,7 +19507,7 @@ function strictMapping(value, location, revenueProperty) {
     "transform",
     ...revenueProperty ? [] : ["ttlDays", "persist"]
   ]);
-  const mapping = strictObject(value, location, keys);
+  const mapping = strictObject(value2, location, keys);
   strictSource(mapping.from, `${location}.from`, revenueProperty, true);
   strictPath(mapping.to, `${location}.to`, true);
   if (mapping.valueType !== void 0 && !valueTypes.has(String(mapping.valueType)))
@@ -19120,12 +19518,12 @@ function strictMapping(value, location, revenueProperty) {
     optionalType(mapping.persist, "boolean", `${location}.persist`);
   }
 }
-function strictWhen(value, location) {
-  if (value === void 0) return;
-  if (!Array.isArray(value) || value.length < 1 || value.length > runtime_settings_trigger_constants_default.maxWhenEntries) {
+function strictWhen(value2, location) {
+  if (value2 === void 0) return;
+  if (!Array.isArray(value2) || value2.length < 1 || value2.length > runtime_settings_trigger_constants_default.maxWhenEntries) {
     throw new Error(`${location} must contain 1 to ${runtime_settings_trigger_constants_default.maxWhenEntries} entries`);
   }
-  value.forEach((entry, index) => {
+  value2.forEach((entry, index) => {
     const entryLocation = `${location}[${index}]`;
     const condition = strictObject(entry, entryLocation, /* @__PURE__ */ new Set(["path", "op", "value"]));
     strictPath(condition.path, `${entryLocation}.path`, true);
@@ -19154,12 +19552,12 @@ function strictWhen(value, location) {
     }
   });
 }
-function strictTriggers(value) {
-  if (!Array.isArray(value) || value.length > runtime_settings_trigger_constants_default.maxTriggers)
+function strictTriggers(value2) {
+  if (!Array.isArray(value2) || value2.length > runtime_settings_trigger_constants_default.maxTriggers)
     throw new Error(
       `trigger file must contain an array of at most ${runtime_settings_trigger_constants_default.maxTriggers} triggers`
     );
-  return value.map((item, index) => {
+  return value2.map((item, index) => {
     if (!item || typeof item !== "object" || Array.isArray(item))
       throw new Error(`trigger[${index}] must be an object`);
     const record4 = item;
@@ -19314,7 +19712,7 @@ var get3 = new Command("get").description("Get data layer triggers").requiredOpt
 var set2 = new Command("set").requiredOption("--file <json>", "JSON trigger array").requiredOption("--shop <domain-or-id>", "Shop domain or Apex shop ID").action(async function(opts) {
   let triggers;
   try {
-    triggers = strictTriggers(JSON.parse(import_node_fs18.default.readFileSync(import_node_path15.default.resolve(opts.file), "utf8")));
+    triggers = strictTriggers(JSON.parse(import_node_fs19.default.readFileSync(import_node_path16.default.resolve(opts.file), "utf8")));
   } catch (error) {
     fail(
       this,
@@ -19341,7 +19739,7 @@ var propose = new Command("propose").requiredOption("--from-file <u2-report.json
   let proposals;
   let report;
   try {
-    report = JSON.parse(import_node_fs18.default.readFileSync(import_node_path15.default.resolve(opts.fromFile), "utf8"));
+    report = JSON.parse(import_node_fs19.default.readFileSync(import_node_path16.default.resolve(opts.fromFile), "utf8"));
     proposals = proposeTriggers(report);
   } catch (error) {
     fail(this, error instanceof Error ? error.message : String(error), EXIT_CODES.validation);
@@ -19369,28 +19767,28 @@ var propose = new Command("propose").requiredOption("--from-file <u2-report.json
 `);
   });
 });
-function collect(value, previous) {
-  return [...previous, value];
+function collect2(value2, previous) {
+  return [...previous, value2];
 }
-function parseParamValue(value) {
-  if (!value.startsWith("[") && !value.startsWith("{")) return value;
+function parseParamValue(value2) {
+  if (!value2.startsWith("[") && !value2.startsWith("{")) return value2;
   try {
-    return JSON.parse(value);
+    return JSON.parse(value2);
   } catch {
-    return value;
+    return value2;
   }
 }
-var recipe = new Command("apply-recipe").argument("<recipeId>").requiredOption("--shop <domain-or-id>", "Shop domain or Apex shop ID").option("--param <k=v>", "Recipe parameter", collect, []).action(async function(recipeId, opts) {
+var recipe = new Command("apply-recipe").argument("<recipeId>").requiredOption("--shop <domain-or-id>", "Shop domain or Apex shop ID").option("--param <k=v>", "Recipe parameter", collect2, []).action(async function(recipeId, opts) {
   const params = Object.fromEntries(
-    opts.param.map((pair) => {
-      const i = pair.indexOf("=");
+    opts.param.map((pair2) => {
+      const i = pair2.indexOf("=");
       if (i < 1)
         fail(
           this,
-          `TRIGGERS_CONFIG_ABSENT: invalid --param ${pair}; expected k=v`,
+          `TRIGGERS_CONFIG_ABSENT: invalid --param ${pair2}; expected k=v`,
           EXIT_CODES.validation
         );
-      return [pair.slice(0, i), parseParamValue(pair.slice(i + 1))];
+      return [pair2.slice(0, i), parseParamValue(pair2.slice(i + 1))];
     })
   );
   const identity2 = await identify(this, opts.shop);
@@ -19417,7 +19815,7 @@ var recipe = new Command("apply-recipe").argument("<recipeId>").requiredOption("
     writeWarnings(result);
   });
 });
-var enable = new Command("enable-capture").requiredOption("--hours <n>").requiredOption("--shop <domain-or-id>", "Shop domain or Apex shop ID").option("--url-pattern <p>", "URL pattern", collect, []).action(async function(opts) {
+var enable = new Command("enable-capture").requiredOption("--hours <n>").requiredOption("--shop <domain-or-id>", "Shop domain or Apex shop ID").option("--url-pattern <p>", "URL pattern", collect2, []).action(async function(opts) {
   const hours = Number(opts.hours);
   if (!Number.isFinite(hours) || hours <= 0 || hours > 48)
     fail(
@@ -19461,11 +19859,11 @@ var triggersCommand = new Command("triggers").description("Manage runtime data l
 
 // src/commands/domains.ts
 init_source();
-function normalizeDomain(value) {
-  return value.trim().replace(/^https?:\/\//i, "").replace(/[/?#].*$/, "").replace(/\.$/, "").toLowerCase();
+function normalizeDomain(value2) {
+  return value2.trim().replace(/^https?:\/\//i, "").replace(/[/?#].*$/, "").replace(/\.$/, "").toLowerCase();
 }
-function landingHost(value) {
-  const trimmed = value.trim();
+function landingHost(value2) {
+  const trimmed = value2.trim();
   try {
     const withScheme = /^https?:\/\//i.test(trimmed) ? trimmed : `https://${trimmed}`;
     return new URL(withScheme).hostname.toLowerCase().replace(/\.$/, "") || normalizeDomain(trimmed);
@@ -19643,8 +20041,8 @@ var register = new Command("register").description("Register a new domain on the
         `apex domains register ${host} --years ${years} --confirm-price "${quote.total} ${quote.currency}"`
       );
     }
-    const readline3 = await import("node:readline");
-    const rl = readline3.createInterface({ input: process.stdin, output: process.stderr });
+    const readline4 = await import("node:readline");
+    const rl = readline4.createInterface({ input: process.stdin, output: process.stderr });
     console.error(describeQuote(quote));
     const answer = await new Promise(
       (resolve2) => rl.question(
@@ -19731,9 +20129,9 @@ var domainsCommand = new Command("domains").description("Manage install domains
 
 // src/commands/handover.ts
 init_source();
-function normalizeDomain2(value) {
+function normalizeDomain2(value2) {
   try {
-    const candidate = value.trim().toLowerCase();
+    const candidate = value2.trim().toLowerCase();
     const parsed = new URL(
       /^[a-z][a-z0-9+.-]*:\/\//.test(candidate) ? candidate : `http://${candidate}`
     );
@@ -19756,8 +20154,8 @@ var NAMED_HTML_ENTITIES = {
   apos: "'",
   nbsp: "\xA0"
 };
-function decodeHtmlEntities(value) {
-  return value.replace(/&(#[0-9]+|#[xX][0-9a-fA-F]+|[a-zA-Z]+);/g, (match2, entity2) => {
+function decodeHtmlEntities(value2) {
+  return value2.replace(/&(#[0-9]+|#[xX][0-9a-fA-F]+|[a-zA-Z]+);/g, (match2, entity2) => {
     if (entity2.startsWith("#")) {
       const hex = entity2[1] === "x" || entity2[1] === "X";
       const code = Number.parseInt(hex ? entity2.slice(2) : entity2.slice(1), hex ? 16 : 10);
@@ -19917,9 +20315,9 @@ var qa2 = new Command("qa").description("Check static link/form handover paramet
 var handoverCommand = new Command("handover").description("Manage cross-domain identity handover").addCommand(get4).addCommand(set4).addCommand(off2).addCommand(qa2);
 
 // src/commands/order-journey.ts
-function instant(value) {
+function instant(value2) {
   const m = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2})(?::(\d{2})(?:\.(\d+))?)?(Z|[+-]\d{2}:\d{2})$/.exec(
-    value
+    value2
   );
   if (!m) return null;
   const year = Number(m[1]), month = Number(m[2]), day = Number(m[3]);
@@ -20223,22 +20621,22 @@ var CAVEAT = "Labeled estimate only: fail-closed consent tracking makes decliner
 var PRODUCTION_WORKER_BASE_URL = "https://events.drip-apex.com";
 var PRODUCTION_ENVIRONMENT_KEY = "production";
 var VISITOR_SERIES_DAYS = 60;
-function hostOnly(value) {
-  if (!value) return null;
+function hostOnly(value2) {
+  if (!value2) return null;
   try {
-    return new URL(value.includes("://") ? value : `https://${value}`).hostname.toLowerCase();
+    return new URL(value2.includes("://") ? value2 : `https://${value2}`).hostname.toLowerCase();
   } catch {
-    return value.toLowerCase().replace(/^https?:\/\//, "").split("/")[0] || null;
+    return value2.toLowerCase().replace(/^https?:\/\//, "").split("/")[0] || null;
   }
 }
 function configuredHosts(domains, envs) {
   const set7 = /* @__PURE__ */ new Set();
-  for (const value of [
+  for (const value2 of [
     domains.domain,
     ...domains.additionalDomains ?? [],
     ...domains.storeOrigins ?? []
   ]) {
-    const host = hostOnly(value);
+    const host = hostOnly(value2);
     if (host) set7.add(host);
   }
   for (const env2 of envs?.environments.items ?? [])
@@ -20339,8 +20737,8 @@ var PURCHASE_CADENCE_WINDOW_MINUTES = PURCHASE_WINDOW_MINUTES * 4;
 var MIN_CAPTURE_WINDOW_MINUTES = 60;
 var DUPLICATE_RATE_THRESHOLD = 0.02;
 var MAGNITUDE_TOLERANCE_RATE = 0.1;
-function record3(value) {
-  return value && typeof value === "object" && !Array.isArray(value) ? value : null;
+function record3(value2) {
+  return value2 && typeof value2 === "object" && !Array.isArray(value2) ? value2 : null;
 }
 function purchasePlane(config) {
   if (!config) return { present: false, names: [] };
@@ -20355,13 +20753,13 @@ function purchasePlane(config) {
   return { present: names.length > 0, names };
 }
 function publicationTime(config) {
-  for (const value of [
+  for (const value2 of [
     config?.generated_at,
     config?.publicationTimestamp,
     config?.publishedAt,
     config?.updatedAt
   ]) {
-    if (typeof value === "string" && Number.isFinite(Date.parse(value))) return Date.parse(value);
+    if (typeof value2 === "string" && Number.isFinite(Date.parse(value2))) return Date.parse(value2);
   }
   return null;
 }
@@ -20382,14 +20780,14 @@ function eventTime(event) {
   const raw = event.timestamp;
   return typeof raw === "string" && Number.isFinite(Date.parse(raw)) ? Date.parse(raw) : null;
 }
-function numeric(value) {
-  const parsed = typeof value === "number" ? value : typeof value === "string" && value.trim() !== "" ? Number(value) : NaN;
+function numeric(value2) {
+  const parsed = typeof value2 === "number" ? value2 : typeof value2 === "string" && value2.trim() !== "" ? Number(value2) : NaN;
   return Number.isFinite(parsed) ? parsed : null;
 }
-function lineItemSum(value) {
-  if (!Array.isArray(value)) return null;
+function lineItemSum(value2) {
+  if (!Array.isArray(value2)) return null;
   let sum = 0;
-  for (const item of value) {
+  for (const item of value2) {
     const row = record3(item);
     const price = numeric(row?.price);
     if (price === null) return null;
@@ -20592,8 +20990,8 @@ async function fetchServedConfig(workerBase, shopId) {
 }
 function originHosts(values) {
   const set7 = /* @__PURE__ */ new Set();
-  for (const value of values) {
-    const host = hostOnly(value);
+  for (const value2 of values) {
+    const host = hostOnly(value2);
     if (host) set7.add(host);
   }
   return [...set7].sort();
@@ -20970,15 +21368,15 @@ function withCaveat(check, caveat) {
   return caveat.length ? { ...check, evidence: [...check.evidence, ...caveat] } : check;
 }
 var DAY_MS = 864e5;
-function parseDay(value) {
-  const text2 = value?.trim();
+function parseDay(value2) {
+  const text2 = value2?.trim();
   if (!text2 || !/^\d{4}-\d{2}-\d{2}$/.test(text2)) return null;
   const parsed = Date.parse(`${text2}T00:00:00.000Z`);
   if (Number.isNaN(parsed)) return null;
   return toDay(parsed) === text2 ? parsed : null;
 }
-function toDay(value) {
-  return new Date(value).toISOString().slice(0, 10);
+function toDay(value2) {
+  return new Date(value2).toISOString().slice(0, 10);
 }
 function windowDays(from, to) {
   return to < from ? 0 : Math.round((to - from) / DAY_MS) + 1;
@@ -21085,18 +21483,18 @@ ${CAVEAT}`
 });
 
 // src/commands/analytics.ts
-function display(value) {
-  if (value === null || value === void 0) return "\u2014";
-  if (typeof value === "object") return JSON.stringify(value);
-  return String(value);
-}
-function positiveInteger(command, value, option) {
-  if (value === void 0) return void 0;
-  const parsed = Number(value);
+function display(value2) {
+  if (value2 === null || value2 === void 0) return "\u2014";
+  if (typeof value2 === "object") return JSON.stringify(value2);
+  return String(value2);
+}
+function positiveInteger(command, value2, option) {
+  if (value2 === void 0) return void 0;
+  const parsed = Number(value2);
   if (!Number.isInteger(parsed) || parsed <= 0)
     fail(command, `${option} must be a positive integer`, EXIT_CODES.validation, {
       field: option.slice(2),
-      actual: value
+      actual: value2
     });
   return parsed;
 }
@@ -21227,7 +21625,7 @@ Examples:
 );
 
 // src/commands/install.ts
-var import_promises3 = require("node:dns/promises");
+var import_promises4 = require("node:dns/promises");
 var import_node_http2 = require("node:http");
 var import_node_https = require("node:https");
 var import_node_net = require("node:net");
@@ -21285,7 +21683,7 @@ var testResolver;
 var testFetch;
 async function resolveHost(hostname) {
   const mocked = testResolver?.(hostname) ?? null;
-  const addresses = mocked ?? await (0, import_promises3.lookup)(hostname, { all: true });
+  const addresses = mocked ?? await (0, import_promises4.lookup)(hostname, { all: true });
   return addresses.map((entry) => entry.address);
 }
 async function validateUrl(raw, allowedHosts) {
@@ -21334,8 +21732,8 @@ function decoderFor(encoding) {
   return (0, import_node_zlib.createBrotliDecompress)();
 }
 function normalizeEncoding(header) {
-  const value = (header ?? "").trim().toLowerCase();
-  return !value || value === "identity" ? null : value;
+  const value2 = (header ?? "").trim().toLowerCase();
+  return !value2 || value2 === "identity" ? null : value2;
 }
 function decodeBody(raw, header, limits, hostname, inputTruncated = false) {
   const encoding = normalizeEncoding(header);
@@ -21398,9 +21796,9 @@ function overLimitMessage(hostname, maxBytes) {
 function responseFromIncoming(res, body5, decoded) {
   const status4 = res.statusCode ?? 0;
   const headers = new Headers();
-  for (const [key, value] of Object.entries(res.headers)) {
-    if (Array.isArray(value)) for (const entry of value) headers.append(key, entry);
-    else if (typeof value === "string") headers.set(key, value);
+  for (const [key, value2] of Object.entries(res.headers)) {
+    if (Array.isArray(value2)) for (const entry of value2) headers.append(key, entry);
+    else if (typeof value2 === "string") headers.set(key, value2);
   }
   if (decoded) {
     headers.delete("content-encoding");
@@ -21651,11 +22049,11 @@ function buildConfigUrl(workerBaseUrl, shopId, environmentKey) {
   if (normalized && normalized !== "production") url.searchParams.set("env", normalized);
   return url.toString();
 }
-function readNumber(value) {
-  return typeof value === "number" && Number.isFinite(value) ? value : null;
+function readNumber(value2) {
+  return typeof value2 === "number" && Number.isFinite(value2) ? value2 : null;
 }
-function readString(value) {
-  return typeof value === "string" && value.trim() ? value : null;
+function readString(value2) {
+  return typeof value2 === "string" && value2.trim() ? value2 : null;
 }
 function isRecognizedConfig(config) {
   const hasRevision = readNumber(config.publicationRevision) !== null || readNumber(config.publication_revision) !== null;
@@ -21927,7 +22325,7 @@ var installCommand = new Command("install").description("Check Apex storefront i
           "trackRevenue.enabled",
           servedConfig.revenueTriggerEnabled === null ? "unknown" : servedConfig.revenueTriggerEnabled ? "yes" : "no"
         ]
-      ].map(([field, value]) => [String(field), String(value)])
+      ].map(([field, value2]) => [String(field), String(value2)])
     );
     if (warnings.length)
       printTable(
@@ -21961,15 +22359,15 @@ var installCommand = new Command("install").description("Check Apex storefront i
 
 // src/commands/flags.ts
 init_source();
-var import_node_fs19 = __toESM(require("node:fs"));
-var import_node_path16 = __toESM(require("node:path"));
+var import_node_fs20 = __toESM(require("node:fs"));
+var import_node_path17 = __toESM(require("node:path"));
 
 // src/edge-status.ts
 function getEdgeDeliveryStatus(deliveryType, expectedWorstCaseSeconds = 360) {
   return deliveryType === "api" ? { edge_delivery: "not_applicable", message: `API-delivered flag \u2014 edge delivery is not applicable. A previously cached visual payload may remain at some PoPs for up to ~${expectedWorstCaseSeconds}s; a single-vantage status cannot prove global propagation.` } : { edge_delivery: "applicable", message: null };
 }
-function parsePublicationMetadata(value) {
-  const record4 = value && typeof value === "object" ? value : {};
+function parsePublicationMetadata(value2) {
+  const record4 = value2 && typeof value2 === "object" ? value2 : {};
   return {
     publication_revision: Number.isSafeInteger(record4.publication_revision) && record4.publication_revision >= 0 ? record4.publication_revision : null,
     generated_at: typeof record4.generated_at === "string" && !Number.isNaN(Date.parse(record4.generated_at)) ? record4.generated_at : null
@@ -22000,11 +22398,11 @@ function formatEdgePropagationStatus(status4) {
 
 // src/commands/flags.ts
 var kind = "flags";
-function body(command, value, opts) {
+function body(command, value2, opts) {
   let parsed = {};
-  if (value) {
-    const source = value.startsWith("@") ? value.slice(1) : value;
-    const text2 = value.startsWith("@") || import_node_fs19.default.existsSync(source) ? import_node_fs19.default.readFileSync(import_node_path16.default.resolve(process.cwd(), source), "utf8") : value;
+  if (value2) {
+    const source = value2.startsWith("@") ? value2.slice(1) : value2;
+    const text2 = value2.startsWith("@") || import_node_fs20.default.existsSync(source) ? import_node_fs20.default.readFileSync(import_node_path17.default.resolve(process.cwd(), source), "utf8") : value2;
     try {
       parsed = JSON.parse(text2);
     } catch (e) {
@@ -22106,8 +22504,8 @@ function write(name) {
   c.action(async function(...args) {
     const o = this.opts();
     const id = name === "update" ? String(args[0]) : void 0;
-    const value = o.file ? `@${o.file}` : String(args[name === "update" ? 1 : 0] ?? "") || void 0;
-    const b = body(this, value, o);
+    const value2 = o.file ? `@${o.file}` : String(args[name === "update" ? 1 : 0] ?? "") || void 0;
+    const b = body(this, value2, o);
     if (name === "update" && !Object.keys(b).length)
       fail(this, "Provide at least one field to update.", EXIT_CODES.validation);
     const r = name === "create" ? await createManagedDelivery(requireCredentials(), kind, b) : await updateManagedDelivery(requireCredentials(), kind, id, b);
@@ -22137,16 +22535,16 @@ Examples:
 );
 
 // src/commands/backlog.ts
-var import_node_fs20 = __toESM(require("node:fs"));
-var import_node_path17 = __toESM(require("node:path"));
+var import_node_fs21 = __toESM(require("node:fs"));
+var import_node_path18 = __toESM(require("node:path"));
 init_source();
 var kind2 = "backlog";
 var singular = "backlog item";
-function parse(command, value) {
-  if (!value) return {};
+function parse(command, value2) {
+  if (!value2) return {};
   try {
-    const source = value.startsWith("@") ? value.slice(1) : value;
-    const text2 = value.startsWith("@") || import_node_fs20.default.existsSync(source) ? import_node_fs20.default.readFileSync(import_node_path17.default.resolve(process.cwd(), source), "utf8") : value;
+    const source = value2.startsWith("@") ? value2.slice(1) : value2;
+    const text2 = value2.startsWith("@") || import_node_fs21.default.existsSync(source) ? import_node_fs21.default.readFileSync(import_node_path18.default.resolve(process.cwd(), source), "utf8") : value2;
     const body5 = JSON.parse(text2);
     if (!body5 || typeof body5 !== "object" || Array.isArray(body5))
       throw new Error("body must be an object");
@@ -22159,11 +22557,11 @@ function parse(command, value) {
     );
   }
 }
-function collect2(value, previous) {
-  return [...previous, value];
+function collect3(value2, previous) {
+  return [...previous, value2];
 }
-function customFieldsRecord(value) {
-  return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+function customFieldsRecord(value2) {
+  return value2 && typeof value2 === "object" && !Array.isArray(value2) ? value2 : {};
 }
 function typedFieldValue(definition, raw) {
   if (raw === "null") return null;
@@ -22185,11 +22583,11 @@ function typedFieldValue(definition, raw) {
 }
 async function customFieldsFromPairs(command, pairs) {
   if (pairs.length === 0) return void 0;
-  const parsedPairs = pairs.map((pair) => {
-    const separator = pair.indexOf("=");
+  const parsedPairs = pairs.map((pair2) => {
+    const separator = pair2.indexOf("=");
     if (separator <= 0)
-      fail(command, `Invalid --field "${pair}": use key=value.`, EXIT_CODES.validation);
-    return { key: pair.slice(0, separator), raw: pair.slice(separator + 1) };
+      fail(command, `Invalid --field "${pair2}": use key=value.`, EXIT_CODES.validation);
+    return { key: pair2.slice(0, separator), raw: pair2.slice(separator + 1) };
   });
   const fields3 = await listBacklogFields(requireCredentials());
   if (!fields3.ok || !fields3.data) {
@@ -22213,8 +22611,8 @@ function detail2(x, labels) {
   const custom = customFieldsRecord(x.custom_fields);
   if (Object.keys(custom).length > 0) {
     console.log();
-    for (const [key, value] of Object.entries(custom)) {
-      console.log(`  ${labels.get(key) ?? key}: ${value === null ? "-" : String(value)}`);
+    for (const [key, value2] of Object.entries(custom)) {
+      console.log(`  ${labels.get(key) ?? key}: ${value2 === null ? "-" : String(value2)}`);
     }
   }
   console.log();
@@ -22266,7 +22664,7 @@ function write2(action78) {
   c.argument("[json]", "Inline JSON, @file, or file path").option("--file <path>", "JSON body file").option(
     "--field <key=value>",
     "Set one of the shop's own fields; repeatable. Use key=null to clear it.",
-    collect2,
+    collect3,
     []
   );
   c.action(async function(...args) {
@@ -22312,8 +22710,8 @@ var remove = new Command("delete").description("Delete a backlog item").argument
         "Deleting a backlog item requires confirmation in non-TTY mode.",
         `apex backlog delete ${id} --force`
       );
-    const readline3 = await import("node:readline");
-    const rl = readline3.createInterface({ input: process.stdin, output: process.stderr });
+    const readline4 = await import("node:readline");
+    const rl = readline4.createInterface({ input: process.stdin, output: process.stderr });
     const answer = await new Promise(
       (resolve2) => rl.question(source_default.yellow(`Delete backlog item ${id}? [y/N] `), resolve2)
     );
@@ -22340,12 +22738,12 @@ function fieldDetail(field) {
   if (field.archived_at) console.log(`  Archived: ${field.archived_at}`);
   console.log();
 }
-function boolOption(command, flag, value) {
-  if (value === void 0) return void 0;
-  const trimmed = value.trim().toLowerCase();
+function boolOption(command, flag, value2) {
+  if (value2 === void 0) return void 0;
+  const trimmed = value2.trim().toLowerCase();
   if (["true", "yes", "y", "1"].includes(trimmed)) return true;
   if (["false", "no", "n", "0"].includes(trimmed)) return false;
-  fail(command, `Invalid ${flag} "${value}": use true or false.`, EXIT_CODES.validation);
+  fail(command, `Invalid ${flag} "${value2}": use true or false.`, EXIT_CODES.validation);
 }
 var fieldsList = new Command("list").alias("ls").description("List the shop's idea fields").option("--include-archived", "Include archived fields").action(async function(o) {
   const r = await listBacklogFields(requireCredentials(), o.includeArchived);
@@ -22373,7 +22771,7 @@ var fieldsCreate = new Command("create").description("Add an idea field").requir
 ).option("--key <key>", "Field key; derived from the label when omitted").option(
   "--option <value>",
   "A choice for a single_choice field; repeatable",
-  collect2,
+  collect3,
   []
 ).option("--required <true|false>", "Every idea must carry a value").option("--client-visible <true|false>", "Share the value with the client").action(async function(o) {
   const required = boolOption(this, "--required", o.required);
@@ -22393,7 +22791,7 @@ var fieldsCreate = new Command("create").description("Add an idea field").requir
 var fieldsUpdate = new Command("update").description("Update an idea field").argument("<id>", "field ID").option("--label <text>", "What the field is called").option(
   "--option <value>",
   "Replace the choices of a single_choice field; repeatable",
-  collect2,
+  collect3,
   []
 ).option("--required <true|false>", "Every idea must carry a value").option("--client-visible <true|false>", "Share the value with the client").option("--archived <true|false>", "Archive or restore the field").action(async function(id, o) {
   const required = boolOption(this, "--required", o.required);
@@ -22423,16 +22821,16 @@ var fields2 = new Command("fields").description("Manage the shop's own idea fiel
 var backlogCommand = new Command("backlog").description("Manage backlog").addCommand(list7).addCommand(get6).addCommand(write2("create")).addCommand(write2("update")).addCommand(archive).addCommand(restore).addCommand(remove).addCommand(fields2);
 
 // src/commands/signals.ts
-var import_node_fs21 = __toESM(require("node:fs"));
-var import_node_path18 = __toESM(require("node:path"));
+var import_node_fs22 = __toESM(require("node:fs"));
+var import_node_path19 = __toESM(require("node:path"));
 init_source();
 var kind3 = "signals";
 var singular2 = "signal";
-function parse2(command, value) {
-  if (!value) return {};
+function parse2(command, value2) {
+  if (!value2) return {};
   try {
-    const source = value.startsWith("@") ? value.slice(1) : value;
-    const text2 = value.startsWith("@") || import_node_fs21.default.existsSync(source) ? import_node_fs21.default.readFileSync(import_node_path18.default.resolve(process.cwd(), source), "utf8") : value;
+    const source = value2.startsWith("@") ? value2.slice(1) : value2;
+    const text2 = value2.startsWith("@") || import_node_fs22.default.existsSync(source) ? import_node_fs22.default.readFileSync(import_node_path19.default.resolve(process.cwd(), source), "utf8") : value2;
     const body5 = JSON.parse(text2);
     if (!body5 || typeof body5 !== "object" || Array.isArray(body5))
       throw new Error("body must be an object");
@@ -22514,14 +22912,14 @@ var signalsCommand = new Command("signals").description("Manage signals").addCom
 
 // src/commands/personalizations.ts
 init_source();
-var import_node_fs22 = __toESM(require("node:fs"));
-var import_node_path19 = __toESM(require("node:path"));
+var import_node_fs23 = __toESM(require("node:fs"));
+var import_node_path20 = __toESM(require("node:path"));
 var kind4 = "personalizations";
-function body2(command, value, opts) {
+function body2(command, value2, opts) {
   let parsed = {};
-  if (value) {
-    const source = value.startsWith("@") ? value.slice(1) : value;
-    const text2 = value.startsWith("@") || import_node_fs22.default.existsSync(source) ? import_node_fs22.default.readFileSync(import_node_path19.default.resolve(process.cwd(), source), "utf8") : value;
+  if (value2) {
+    const source = value2.startsWith("@") ? value2.slice(1) : value2;
+    const text2 = value2.startsWith("@") || import_node_fs23.default.existsSync(source) ? import_node_fs23.default.readFileSync(import_node_path20.default.resolve(process.cwd(), source), "utf8") : value2;
     try {
       parsed = JSON.parse(text2);
     } catch (e) {
@@ -22580,8 +22978,8 @@ function write4(name) {
   c.action(async function(...args) {
     const o = this.opts();
     const id = name === "update" ? String(args[0]) : void 0;
-    const value = o.file ? `@${o.file}` : String(args[name === "update" ? 1 : 0] ?? "") || void 0;
-    const b = body2(this, value, o);
+    const value2 = o.file ? `@${o.file}` : String(args[name === "update" ? 1 : 0] ?? "") || void 0;
+    const b = body2(this, value2, o);
     if (name === "update" && !Object.keys(b).length)
       fail(this, "Provide at least one field to update.", EXIT_CODES.validation);
     const r = name === "create" ? await createManagedDelivery(requireCredentials(), kind4, b) : await updateManagedDelivery(requireCredentials(), kind4, id, b);
@@ -22603,8 +23001,8 @@ var personalizationsCommand = new Command("personalizations").description("Manag
 
 // src/commands/targeting-resources.ts
 init_source();
-var import_node_fs23 = __toESM(require("node:fs"));
-var import_node_path20 = __toESM(require("node:path"));
+var import_node_fs24 = __toESM(require("node:fs"));
+var import_node_path21 = __toESM(require("node:path"));
 
 // src/generated/exclusion-group-body.schema.json
 var exclusion_group_body_schema_default = {
@@ -22857,11 +23255,11 @@ function exclusionFailureDetails(kind5, action78, status4, details) {
     ]
   };
 }
-function body3(command, value) {
-  if (!value) return {};
-  const source = value.startsWith("@") ? value.slice(1) : value;
+function body3(command, value2) {
+  if (!value2) return {};
+  const source = value2.startsWith("@") ? value2.slice(1) : value2;
   try {
-    const text2 = value.startsWith("@") || import_node_fs23.default.existsSync(source) ? import_node_fs23.default.readFileSync(import_node_path20.default.resolve(process.cwd(), source), "utf8") : value;
+    const text2 = value2.startsWith("@") || import_node_fs24.default.existsSync(source) ? import_node_fs24.default.readFileSync(import_node_path21.default.resolve(process.cwd(), source), "utf8") : value2;
     return JSON.parse(text2);
   } catch (error) {
     fail(
@@ -22940,8 +23338,8 @@ function targetingResourceCommand(kind5) {
     ).option("--file <path>", "JSON body file").action(async function(...args) {
       const opts = this.opts();
       const id = action78 === "update" ? String(args[0]) : void 0;
-      const value = opts.file ? `@${opts.file}` : String(args[action78 === "update" ? 1 : 0] ?? "") || void 0;
-      const requestBody = body3(this, value);
+      const value2 = opts.file ? `@${opts.file}` : String(args[action78 === "update" ? 1 : 0] ?? "") || void 0;
+      const requestBody = body3(this, value2);
       if (action78 === "update" && typeof requestBody === "object" && requestBody !== null && !Array.isArray(requestBody) && Object.keys(requestBody).length === 0)
         fail(this, `Updating a ${singular3} requires at least one field.`, EXIT_CODES.validation);
       const response = await requestTargetingResource(
@@ -22974,8 +23372,8 @@ function targetingResourceCommand(kind5) {
             "Deleting an exclusion group requires confirmation in non-TTY mode.",
             `apex exclusion-groups delete ${id} --force`
           );
-        const readline3 = await import("node:readline");
-        const rl = readline3.createInterface({
+        const readline4 = await import("node:readline");
+        const rl = readline4.createInterface({
           input: process.stdin,
           output: process.stderr
         });
@@ -23001,13 +23399,13 @@ function targetingResourceCommand(kind5) {
   );
   if (kind5 === "exclusion-groups") {
     root.addCommand(
-      new Command("replace-members").description("Replace exclusion group members").argument("<id>").argument("<json>", "Request body as inline JSON, @file, or a file path (shape below)").action(async function(id, value) {
+      new Command("replace-members").description("Replace exclusion group members").argument("<id>").argument("<json>", "Request body as inline JSON, @file, or a file path (shape below)").action(async function(id, value2) {
         const response = await requestTargetingResource(
           requireCredentials(),
           "PUT",
           kind5,
           `${id}/members`,
-          body3(this, value)
+          body3(this, value2)
         );
         if (!response.ok || !response.data)
           fail(
@@ -23116,8 +23514,8 @@ var targetingCommand = new Command("targeting").description("Test experiment tar
 // src/commands/sos.ts
 var import_node_crypto8 = require("node:crypto");
 init_source();
-var import_node_fs24 = __toESM(require("node:fs"));
-var import_node_path21 = __toESM(require("node:path"));
+var import_node_fs25 = __toESM(require("node:fs"));
+var import_node_path22 = __toESM(require("node:path"));
 var SOS_TYPES = /* @__PURE__ */ new Set([
   "full_handover",
   "design",
@@ -23127,10 +23525,10 @@ var SOS_TYPES = /* @__PURE__ */ new Set([
   "bug",
   "help"
 ]);
-function readText(value) {
-  if (!value) return void 0;
-  if (!value.startsWith("@")) return value;
-  return import_node_fs24.default.readFileSync(import_node_path21.default.resolve(process.cwd(), value.slice(1)), "utf8");
+function readText(value2) {
+  if (!value2) return void 0;
+  if (!value2.startsWith("@")) return value2;
+  return import_node_fs25.default.readFileSync(import_node_path22.default.resolve(process.cwd(), value2.slice(1)), "utf8");
 }
 function printTicket(ticket, reused) {
   console.log();
@@ -23184,12 +23582,12 @@ var create4 = new Command("create").description("Create an Apex SOS ticket").opt
   };
   if (opts.attach.length > 5) fail(this, "Attach no more than 5 files", 3);
   const files = opts.attach.map((file) => {
-    const filename = import_node_path21.default.basename(file);
-    const content_type = mediaTypes[import_node_path21.default.extname(file).toLowerCase()];
+    const filename = import_node_path22.default.basename(file);
+    const content_type = mediaTypes[import_node_path22.default.extname(file).toLowerCase()];
     if (!content_type) fail(this, "Unsupported attachment type", 3);
     let size;
     try {
-      size = import_node_fs24.default.statSync(file).size;
+      size = import_node_fs25.default.statSync(file).size;
     } catch {
       fail(this, `Attachment not found: ${file}`, 3);
     }
@@ -23197,7 +23595,7 @@ var create4 = new Command("create").description("Create an Apex SOS ticket").opt
     if (size <= 0 || size > cap) fail(this, "Attachment exceeds its size limit or is empty", 3);
     let bytes;
     try {
-      bytes = import_node_fs24.default.readFileSync(file);
+      bytes = import_node_fs25.default.readFileSync(file);
     } catch {
       fail(this, `Attachment not found: ${file}`, 3);
     }
@@ -23333,17 +23731,17 @@ var markRead = new Command("mark-read").option("--channel <key>", "Mark one chan
 var inboxCommand = new Command("inbox").description("Read and send inbox messages").addCommand(list11).addCommand(send2).addCommand(markRead);
 
 // src/commands/shops.ts
-var import_node_fs25 = __toESM(require("node:fs"));
-var import_node_path22 = __toESM(require("node:path"));
+var import_node_fs26 = __toESM(require("node:fs"));
+var import_node_path23 = __toESM(require("node:path"));
 function body4(command, raw) {
   if (!raw) return {};
   try {
     const source = raw.startsWith("@") ? raw.slice(1) : raw;
-    const text2 = raw.startsWith("@") || import_node_fs25.default.existsSync(source) ? import_node_fs25.default.readFileSync(import_node_path22.default.resolve(source), "utf8") : raw;
-    const value = JSON.parse(text2);
-    if (!value || typeof value !== "object" || Array.isArray(value))
+    const text2 = raw.startsWith("@") || import_node_fs26.default.existsSync(source) ? import_node_fs26.default.readFileSync(import_node_path23.default.resolve(source), "utf8") : raw;
+    const value2 = JSON.parse(text2);
+    if (!value2 || typeof value2 !== "object" || Array.isArray(value2))
       throw new Error("body must be an object");
-    return value;
+    return value2;
   } catch (e) {
     fail(
       command,
@@ -23448,15 +23846,15 @@ function settings(name, description, toggle) {
 }
 var profile = new Command("store-profile").description("Read and review a store profile");
 function printStoreProfile(data) {
-  const value = data;
+  const value2 = data;
   console.log(
-    `${value.shop?.name ?? "Store profile"}${value.shop?.domain ? ` (${value.shop.domain})` : ""}`
+    `${value2.shop?.name ?? "Store profile"}${value2.shop?.domain ? ` (${value2.shop.domain})` : ""}`
   );
   console.log(
-    `Audit: ${value.latestRun?.status ?? "not run"}; findings: ${value.findings?.length ?? 0} (${value.unreviewedCount ?? 0} unreviewed)`
+    `Audit: ${value2.latestRun?.status ?? "not run"}; findings: ${value2.findings?.length ?? 0} (${value2.unreviewedCount ?? 0} unreviewed)`
   );
-  console.log(`Facts: ${value.facts?.length ?? 0}; open reviews: ${value.openReviewCount ?? 0}`);
-  console.log(`Learning run: ${value.latestLearningRun?.status ?? "none"}`);
+  console.log(`Facts: ${value2.facts?.length ?? 0}; open reviews: ${value2.openReviewCount ?? 0}`);
+  console.log(`Learning run: ${value2.latestLearningRun?.status ?? "none"}`);
 }
 profile.addCommand(
   new Command("get").argument("<id>").action(async function(id) {
@@ -23603,13 +24001,13 @@ function dataJson(source) {
     error: { code: "malformed_container", message: "GTM container data is not balanced JSON" }
   };
 }
-function visit(value, callback) {
-  if (!value || typeof value !== "object") return;
-  if (Array.isArray(value)) {
-    for (const item of value) visit(item, callback);
+function visit(value2, callback) {
+  if (!value2 || typeof value2 !== "object") return;
+  if (Array.isArray(value2)) {
+    for (const item of value2) visit(item, callback);
     return;
   }
-  const object = value;
+  const object = value2;
   callback(object);
   for (const nested of Object.values(object)) visit(nested, callback);
 }
@@ -23656,13 +24054,13 @@ function parseContainer(source, id, dataLayerName = "dataLayer") {
   for (const rule of rules) {
     if (!Array.isArray(rule)) continue;
     const predicateIndexes = rule.flatMap(
-      (part) => Array.isArray(part) && part[0] === "if" ? part.slice(1).filter((value) => typeof value === "number") : []
+      (part) => Array.isArray(part) && part[0] === "if" ? part.slice(1).filter((value2) => typeof value2 === "number") : []
     );
     const predicateText = predicateIndexes.map((index) => JSON.stringify(predicates[index] ?? "")).join(" ");
     if (!/consent/i.test(predicateText) || !purchaseRelevantEventNames.some((name) => predicateText.includes(name)))
       continue;
     const tagIndexes = rule.flatMap(
-      (part) => Array.isArray(part) && part[0] === "add" ? part.slice(1).filter((value) => typeof value === "number") : []
+      (part) => Array.isArray(part) && part[0] === "add" ? part.slice(1).filter((value2) => typeof value2 === "number") : []
     );
     for (const index of tagIndexes) {
       const tag = recordObject(tags[index]);
@@ -23682,12 +24080,12 @@ function parseContainer(source, id, dataLayerName = "dataLayer") {
       vtpPaths,
       ecommerceFrom: [...ecommerce][0] ?? null,
       serverContainerUrl: [...serverUrls][0] ?? null,
-      piiPaths: vtpPaths.filter((path26) => /email|phone|address|name/i.test(path26))
+      piiPaths: vtpPaths.filter((path27) => /email|phone|address|name/i.test(path27))
     }
   };
 }
-function recordObject(value) {
-  return value && typeof value === "object" && !Array.isArray(value) ? value : null;
+function recordObject(value2) {
+  return value2 && typeof value2 === "object" && !Array.isArray(value2) ? value2 : null;
 }
 async function mineGtm(input, fetcher = fetch, explicitContainerUrl = false) {
   let refs;
@@ -23732,11 +24130,11 @@ async function mineGtm(input, fetcher = fetch, explicitContainerUrl = false) {
 }
 
 // src/commands/discover.ts
-function minutesValue(value) {
-  if (value === void 0) return void 0;
-  if (!/^\d+$/.test(value))
+function minutesValue(value2) {
+  if (value2 === void 0) return void 0;
+  if (!/^\d+$/.test(value2))
     throw new CliError("--minutes must be an integer between 1 and 20160", EXIT_CODES.validation);
-  const parsed = Number(value);
+  const parsed = Number(value2);
   if (!Number.isSafeInteger(parsed) || parsed < 1 || parsed > 20160)
     throw new CliError("--minutes must be an integer between 1 and 20160", EXIT_CODES.validation);
   return parsed;
@@ -23751,11 +24149,11 @@ function isContainerField(field) {
   const types = baseFieldTypes(field);
   return types.has("obj") || types.has("arr");
 }
-function hasSyntheticPlaceholder(path26) {
-  return path26.split(".").map((segment) => segment.replace(/\[\]$/, "")).some((segment) => /^<[^>]+>$/.test(segment));
+function hasSyntheticPlaceholder(path27) {
+  return path27.split(".").map((segment) => segment.replace(/\[\]$/, "")).some((segment) => /^<[^>]+>$/.test(segment));
 }
-function ambiguousDottedPrefix(event, path26) {
-  const segments = path26.split(".");
+function ambiguousDottedPrefix(event, path27) {
+  const segments = path27.split(".");
   for (let index = 1; index < segments.length; index += 1) {
     const prefix = segments.slice(0, index).join(".");
     const parent = event.fields.find((field) => field.path === prefix);
@@ -23764,42 +24162,42 @@ function ambiguousDottedPrefix(event, path26) {
   return void 0;
 }
 function dimensionEligibility(event, field) {
-  const path26 = field.path;
-  if (hasSyntheticPlaceholder(path26)) {
+  const path27 = field.path;
+  if (hasSyntheticPlaceholder(path27)) {
     return {
       eligible: false,
-      message: `Path ${JSON.stringify(path26)} is a synthetic placeholder and cannot create a dimension. Choose an observed scalar path.`
+      message: `Path ${JSON.stringify(path27)} is a synthetic placeholder and cannot create a dimension. Choose an observed scalar path.`
     };
   }
   if (isContainerField(field)) {
     return {
       eligible: false,
-      message: `Path ${JSON.stringify(path26)} is container-typed. Choose an observed scalar path.`
+      message: `Path ${JSON.stringify(path27)} is container-typed. Choose an observed scalar path.`
     };
   }
-  if (path26.includes("[]")) {
+  if (path27.includes("[]")) {
     return {
       eligible: false,
-      message: `Path ${JSON.stringify(path26)} includes an array-element segment and cannot create a reliable dimension. Choose a scalar path outside an array.`
+      message: `Path ${JSON.stringify(path27)} includes an array-element segment and cannot create a reliable dimension. Choose a scalar path outside an array.`
     };
   }
   if (!isStableField(field)) {
     return {
       eligible: false,
-      message: `Path ${JSON.stringify(path26)} does not have a stable observed type. Choose a path without a type collision.`
+      message: `Path ${JSON.stringify(path27)} does not have a stable observed type. Choose a path without a type collision.`
     };
   }
   if (!event.event) {
     return {
       eligible: false,
-      message: `Path ${JSON.stringify(path26)} has no observed event name. Choose a path from a named event.`
+      message: `Path ${JSON.stringify(path27)} has no observed event name. Choose a path from a named event.`
     };
   }
-  const ambiguousPrefix = ambiguousDottedPrefix(event, path26);
+  const ambiguousPrefix = ambiguousDottedPrefix(event, path27);
   if (ambiguousPrefix) {
     return {
       eligible: false,
-      message: `Path ${JSON.stringify(path26)} could be a literal key containing dots because the discovery report has no observed container at ${JSON.stringify(ambiguousPrefix)}. Apex cannot safely create a capture for it.`
+      message: `Path ${JSON.stringify(path27)} could be a literal key containing dots because the discovery report has no observed container at ${JSON.stringify(ambiguousPrefix)}. Apex cannot safely create a capture for it.`
     };
   }
   return { eligible: true };
@@ -23808,24 +24206,24 @@ function isNumericField(field) {
   const numericTypes = /* @__PURE__ */ new Set(["num", "numstr", "numstr_comma"]);
   return field.types.length > 0 && field.types.every((type) => numericTypes.has(type.split(":")[0]));
 }
-function defaultDimensionLabel(path26) {
-  const words = path26.split(/[._-]+/).filter(Boolean).join(" ");
-  return words ? `${words[0].toUpperCase()}${words.slice(1)}` : path26;
+function defaultDimensionLabel(path27) {
+  const words = path27.split(/[._-]+/).filter(Boolean).join(" ");
+  return words ? `${words[0].toUpperCase()}${words.slice(1)}` : path27;
 }
-function quoteShellArgument(value) {
-  return "'" + value.replaceAll("'", "'\\''") + "'";
+function quoteShellArgument(value2) {
+  return "'" + value2.replaceAll("'", "'\\''") + "'";
 }
-function createDimensionInvocation(path26, eventName) {
-  return `apex discover --create-dimension ${quoteShellArgument(path26)} --event ${quoteShellArgument(eventName)}`;
+function createDimensionInvocation(path27, eventName) {
+  return `apex discover --create-dimension ${quoteShellArgument(path27)} --event ${quoteShellArgument(eventName)}`;
 }
-function resolveDimensionObservation(command, report, path26, eventName) {
+function resolveDimensionObservation(command, report, path27, eventName) {
   const matches = report.data_layer.flatMap(
-    (event) => event.fields.filter((field) => field.path === path26).map((field) => ({ event, field }))
+    (event) => event.fields.filter((field) => field.path === path27).map((field) => ({ event, field }))
   );
   if (!matches.length) {
     fail(
       command,
-      `Path ${JSON.stringify(path26)} was not found in the current discovery report. Run apex discover and copy an observed path exactly.`,
+      `Path ${JSON.stringify(path27)} was not found in the current discovery report. Run apex discover and copy an observed path exactly.`,
       EXIT_CODES.validation
     );
   }
@@ -23835,7 +24233,7 @@ function resolveDimensionObservation(command, report, path26, eventName) {
     if (!eventMatches.length) {
       fail(
         command,
-        `Path ${JSON.stringify(path26)} was not observed on event ${JSON.stringify(eventName)}. Run apex discover and copy the event name exactly.`,
+        `Path ${JSON.stringify(path27)} was not observed on event ${JSON.stringify(eventName)}. Run apex discover and copy the event name exactly.`,
         EXIT_CODES.validation
       );
     }
@@ -23843,7 +24241,7 @@ function resolveDimensionObservation(command, report, path26, eventName) {
     if (layers.length > 1) {
       fail(
         command,
-        `Path ${JSON.stringify(path26)} on event ${JSON.stringify(eventName)} was observed on multiple data layers: ${layers.join(", ")}. Dimensions bind to one layer; this ambiguity cannot be resolved automatically \u2014 capture the value under one layer, or define the dimension in the dashboard with the data layer name set explicitly.`,
+        `Path ${JSON.stringify(path27)} on event ${JSON.stringify(eventName)} was observed on multiple data layers: ${layers.join(", ")}. Dimensions bind to one layer; this ambiguity cannot be resolved automatically \u2014 capture the value under one layer, or define the dimension in the dashboard with the data layer name set explicitly.`,
         EXIT_CODES.validation
       );
     }
@@ -23855,7 +24253,7 @@ function resolveDimensionObservation(command, report, path26, eventName) {
     if (namedEvents.length > 1) {
       fail(
         command,
-        `Path ${JSON.stringify(path26)} was observed on multiple events: ${namedEvents.join(", ")}. Retry with --event <name>.`,
+        `Path ${JSON.stringify(path27)} was observed on multiple events: ${namedEvents.join(", ")}. Retry with --event <name>.`,
         EXIT_CODES.validation
       );
     }
@@ -23864,7 +24262,7 @@ function resolveDimensionObservation(command, report, path26, eventName) {
     if (layers.length > 1) {
       fail(
         command,
-        `Path ${JSON.stringify(path26)} on event ${JSON.stringify(namedEvents[0] ?? "")} was observed on multiple data layers: ${layers.join(", ")}. Dimensions bind to one layer; this ambiguity cannot be resolved automatically \u2014 capture the value under one layer, or define the dimension in the dashboard with the data layer name set explicitly.`,
+        `Path ${JSON.stringify(path27)} on event ${JSON.stringify(namedEvents[0] ?? "")} was observed on multiple data layers: ${layers.join(", ")}. Dimensions bind to one layer; this ambiguity cannot be resolved automatically \u2014 capture the value under one layer, or define the dimension in the dashboard with the data layer name set explicitly.`,
         EXIT_CODES.validation
       );
     }
@@ -23899,9 +24297,9 @@ function renderDiscovery(report) {
       `
 ${event.event || "(unnamed event)"} [${event.dlName}] \u2014 ${event.count} observation(s)${event.matched ? " \u2014 matched" : ""}; t_ms p50=${event.t_ms_p50 ?? "n/a"}, p95=${event.t_ms_p95 ?? "n/a"}, pre-init=${event.pre_init_count}`
     );
-    for (const path26 of event.paths)
+    for (const path27 of event.paths)
       lines.push(
-        `  URL ${path26.path}: ${path26.pageviews} pageviews, ${path26.count} pushes, ${path26.pspReturn_count} PSP returns`
+        `  URL ${path27.path}: ${path27.pageviews} pageviews, ${path27.count} pushes, ${path27.pspReturn_count} PSP returns`
       );
     for (const field of event.fields) {
       lines.push(
@@ -23964,7 +24362,7 @@ var discoverCommand = new Command("discover").description("Read back the trackin
   let report;
   let apiSucceeded = false;
   let discoveryCredentials;
-  let apiFailure2;
+  let apiFailure3;
   try {
     discoveryCredentials = requireCredentials();
     const result = await discoverTrackingSchema(discoveryCredentials, minutes);
@@ -23972,24 +24370,24 @@ var discoverCommand = new Command("discover").description("Read back the trackin
       report = result.data;
       apiSucceeded = true;
     } else
-      apiFailure2 = {
+      apiFailure3 = {
         message: result.error ?? "Discovery API unavailable",
         status: result.status,
         details: result.errorDetails
       };
   } catch (error) {
-    apiFailure2 = {
+    apiFailure3 = {
       message: error instanceof Error ? error.message : String(error),
       ...error instanceof CliError ? { details: error.details, cliError: error } : {}
     };
   }
   if (!report && (!gtmInput || opts.createDimension)) {
-    if (apiFailure2?.cliError) throw apiFailure2.cliError;
+    if (apiFailure3?.cliError) throw apiFailure3.cliError;
     fail(
       this,
-      apiFailure2?.message ?? "Failed to discover tracking schema",
-      classifyStatus(apiFailure2?.status ?? 0),
-      apiFailure2?.details
+      apiFailure3?.message ?? "Failed to discover tracking schema",
+      classifyStatus(apiFailure3?.status ?? 0),
+      apiFailure3?.details
     );
   }
   report ??= {
@@ -24004,7 +24402,7 @@ var discoverCommand = new Command("discover").description("Read back the trackin
     trigger_diagnoses: [],
     storage: [],
     notes: [
-      `GTM static analysis completed without discovery API data: ${apiFailure2?.message ?? "platform credentials were not provided"}`
+      `GTM static analysis completed without discovery API data: ${apiFailure3?.message ?? "platform credentials were not provided"}`
     ]
   };
   if (gtmInput) {
@@ -24042,9 +24440,9 @@ var discoverCommand = new Command("discover").description("Read back the trackin
     if (!apiSucceeded || !discoveryCredentials) {
       fail(
         this,
-        apiFailure2?.message ?? "Discovery API data is required to create a dimension",
-        classifyStatus(apiFailure2?.status ?? 0),
-        apiFailure2?.details
+        apiFailure3?.message ?? "Discovery API data is required to create a dimension",
+        classifyStatus(apiFailure3?.status ?? 0),
+        apiFailure3?.details
       );
     }
     const observation = resolveDimensionObservation(
@@ -24114,16 +24512,16 @@ var discoverCommand = new Command("discover").description("Read back the trackin
 });
 
 // src/commands/skills.ts
-var import_node_fs26 = __toESM(require("node:fs"));
-var import_node_path23 = __toESM(require("node:path"));
+var import_node_fs27 = __toESM(require("node:fs"));
+var import_node_path24 = __toESM(require("node:path"));
 function packageRoot() {
   const candidates = [
-    import_node_path23.default.resolve(__dirname, ".."),
-    import_node_path23.default.resolve(import_node_path23.default.dirname(process.argv[1] ?? process.cwd()), ".."),
-    import_node_path23.default.resolve(process.cwd(), "packages/cli")
+    import_node_path24.default.resolve(__dirname, ".."),
+    import_node_path24.default.resolve(import_node_path24.default.dirname(process.argv[1] ?? process.cwd()), ".."),
+    import_node_path24.default.resolve(process.cwd(), "packages/cli")
   ];
   for (const candidate of candidates) {
-    if (import_node_fs26.default.existsSync(import_node_path23.default.join(candidate, "AGENTS.md"))) return candidate;
+    if (import_node_fs27.default.existsSync(import_node_path24.default.join(candidate, "AGENTS.md"))) return candidate;
   }
   throw new Error(
     `Apex CLI package files not found. Looked for AGENTS.md in: ${candidates.join(", ")}`
@@ -24132,19 +24530,19 @@ function packageRoot() {
 function skillPaths() {
   const root = packageRoot();
   return {
-    agents: import_node_path23.default.join(root, "AGENTS.md"),
-    skill: import_node_path23.default.join(root, "skills", "apex-cli", "SKILL.md")
+    agents: import_node_path24.default.join(root, "AGENTS.md"),
+    skill: import_node_path24.default.join(root, "skills", "apex-cli", "SKILL.md")
   };
 }
 function installSkill(paths, targetRoot) {
-  const missing = [paths.skill, paths.agents].filter((filePath) => !import_node_fs26.default.existsSync(filePath));
+  const missing = [paths.skill, paths.agents].filter((filePath) => !import_node_fs27.default.existsSync(filePath));
   if (missing.length > 0) {
     throw new Error(`Apex CLI package files not found. Missing: ${missing.join(", ")}`);
   }
-  const target = import_node_path23.default.resolve(targetRoot, "apex-cli");
-  import_node_fs26.default.mkdirSync(target, { recursive: true });
-  import_node_fs26.default.copyFileSync(paths.skill, import_node_path23.default.join(target, "SKILL.md"));
-  import_node_fs26.default.copyFileSync(paths.agents, import_node_path23.default.join(target, "AGENTS.md"));
+  const target = import_node_path24.default.resolve(targetRoot, "apex-cli");
+  import_node_fs27.default.mkdirSync(target, { recursive: true });
+  import_node_fs27.default.copyFileSync(paths.skill, import_node_path24.default.join(target, "SKILL.md"));
+  import_node_fs27.default.copyFileSync(paths.agents, import_node_path24.default.join(target, "AGENTS.md"));
   return target;
 }
 var skillsCommand = new Command("skills").description("Print or install the Apex CLI agent skill files").option("--install", "Copy the Apex CLI skill into ./.claude/skills/apex-cli").option("--target <dir>", "Install target skills directory", ".claude/skills").option("--json", "Print JSON").action(function action71(opts) {
@@ -24179,9 +24577,9 @@ function validateMoveInput(shopIds, toOrgId) {
 
 // src/commands/admin.ts
 var uuid2 = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
-function switchValue(value) {
-  if (value === "on") return true;
-  if (value === "off") return false;
+function switchValue(value2) {
+  if (value2 === "on") return true;
+  if (value2 === "off") return false;
   throw new Error("Use on or off");
 }
 var settingsGet = new Command("settings").description("Show platform operator settings").action(async function() {
@@ -24250,8 +24648,8 @@ async function confirmArchive(command, shopId, force) {
       `apex admin shops archive ${JSON.stringify(shopId)} --force`
     );
   }
-  const readline3 = await import("node:readline");
-  const rl = readline3.createInterface({ input: process.stdin, output: process.stderr });
+  const readline4 = await import("node:readline");
+  const rl = readline4.createInterface({ input: process.stdin, output: process.stderr });
   const answer = await new Promise((resolve2) => {
     rl.question("Archive this shop? Apex delivery will be disabled. [y/N] ", resolve2);
   });
@@ -24292,7 +24690,115 @@ var restore2 = new Command("restore").description("Restore an archived shop").ar
     () => console.log("Shop restored. Delivery remains controlled by the kill switch.")
   );
 });
-var shops = new Command("shops").description("Archive and restore shops on the platform admin plane").addCommand(archive2).addCommand(restore2);
+function settingValueText(value2) {
+  return value2 === null ? "null" : typeof value2 === "object" ? JSON.stringify(value2) : String(value2);
+}
+function printShopSettings(settings2) {
+  printTable(
+    ["KEY", "VALUE", "OVERRIDE", "GROUP"],
+    settings2.map((entry) => [
+      entry.key,
+      settingValueText(entry.value),
+      settingValueText(entry.override),
+      entry.group
+    ])
+  );
+}
+async function loadShopSettings(command, shopRef) {
+  const res = await getAdminShopSettings(requireUserCredentials(), shopRef);
+  if (!res.ok || !res.data) {
+    const candidates = res.errorDetails?.candidates;
+    const hint = res.status === 409 && Array.isArray(candidates) ? ` Candidate IDs: ${candidates.join(", ")}. Use --shop <uuid>.` : "";
+    fail(
+      command,
+      `${res.error ?? "Failed to read shop settings"}${hint}`,
+      classifyStatus(res.status),
+      res.errorDetails
+    );
+  }
+  return res.data;
+}
+function findShopSetting(command, settings2, key) {
+  const entry = settings2.find((setting) => setting.key === key);
+  if (!entry)
+    fail(
+      command,
+      `Unknown shop setting ${key}. Registry keys: ${settings2.map((setting) => setting.key).join(", ")}`,
+      3
+    );
+  return entry;
+}
+var shopSettings = new Command("settings").description(
+  "Read and write registered per-shop settings"
+);
+shopSettings.addCommand(
+  new Command("list").description("List every registered shop setting").requiredOption("--shop <uuid-or-domain>").option("--json", "Output JSON").action(async function(opts) {
+    const res = await loadShopSettings(this, opts.shop);
+    output(this, res, () => printShopSettings(res.data.settings));
+  })
+);
+shopSettings.addCommand(
+  new Command("get").description("Read one registered shop setting").requiredOption("--shop <uuid-or-domain>").requiredOption("--key <key>").option("--json", "Output JSON").action(async function(opts) {
+    const res = await loadShopSettings(this, opts.shop);
+    const entry = findShopSetting(this, res.data.settings, opts.key);
+    output(this, { data: { ...res.data, settings: [entry] } }, () => printShopSettings([entry]));
+  })
+);
+shopSettings.addCommand(
+  new Command("set").description("Write a registered shop setting through the audited admin path").requiredOption("--shop <uuid-or-domain>").requiredOption("--key <key>").requiredOption("--value <value>").option("--reason <text>", "Audit reason").option("--expected-version <v>", "Expected storage version").option("--confirm", "Confirm sensitive setting change").option("--json", "Output JSON").action(async function(opts) {
+    const resolved = (await loadShopSettings(this, opts.shop)).data;
+    const entry = findShopSetting(this, resolved.settings, opts.key);
+    let value2 = opts.value;
+    if (opts.value === "null") value2 = null;
+    else if (entry.value_type === "boolean") {
+      if (["on", "true"].includes(opts.value)) value2 = true;
+      else if (["off", "false"].includes(opts.value)) value2 = false;
+      else fail(this, "Boolean values must be on, off, true or false", 3);
+    } else if (entry.value_type === "number") {
+      if (!opts.value.trim() || !Number.isFinite(Number(opts.value)))
+        fail(this, "Number values must be finite numbers", 3);
+      value2 = Number(opts.value);
+    }
+    if (entry.sensitive && !opts.confirm) {
+      const quote = (text2) => "'" + text2.replaceAll("'", `'"'"'`) + "'";
+      const args = [
+        `--shop ${quote(resolved.shop_id)}`,
+        `--key ${quote(opts.key)}`,
+        `--value ${quote(opts.value)}`
+      ];
+      if (opts.reason !== void 0) args.push(`--reason ${quote(opts.reason)}`);
+      if (opts.expectedVersion !== void 0)
+        args.push(`--expected-version ${quote(opts.expectedVersion)}`);
+      if (this.optsWithGlobals().json) args.push("--json");
+      confirmationRequired(
+        this,
+        "--confirm is required because this changes a sensitive shop setting",
+        `apex admin shops settings set ${args.join(" ")} --confirm`
+      );
+    }
+    const res = await setAdminShopSetting(requireUserCredentials(), resolved.shop_id, {
+      key: opts.key,
+      value: value2,
+      ...opts.reason !== void 0 ? { reason: opts.reason } : {},
+      ...opts.expectedVersion !== void 0 ? { expectedVersion: opts.expectedVersion } : {}
+    });
+    if (!res.ok || !res.data)
+      fail(
+        this,
+        res.error ?? "Failed to write shop setting",
+        classifyStatus(res.status),
+        res.errorDetails
+      );
+    if (res.data.data?.shop_id !== resolved.shop_id)
+      fail(this, "The write response has a different shop identity", 2);
+    output(
+      this,
+      res.data,
+      () => console.log(`Setting ${opts.key} set to ${settingValueText(value2)} on ${resolved.domain}.`)
+    );
+  })
+);
+var shops = new Command("shops").description("Manage shops and their settings on the platform admin plane").addCommand(archive2).addCommand(restore2).addCommand(shopSettings);
 var create6 = new Command("create").description("Create an internal, demo or dogfood account").requiredOption("--name <text>").requiredOption("--category <category>", "internal, demo or dogfood").option("--type <type>", "company or agency", "company").option("--plan <plan>", "self_managed, apex_managed or drip_managed", "self_managed").option("--domain <host>").option("--platform <platform>", "shopify, shopware, woo or other").option("--claim-shop <uuid>").option("--owner <email>").option("--consultant <uuid>", "Platform access ID").option("--consultant-title <text>").requiredOption("--reason <text>", "Audit reason, 8 to 500 characters").option("--confirm", "Confirm account creation").option("--json", "Output JSON").action(async function(opts) {
   if (opts.category === "customer") fail(this, "Create customer accounts in Admin, Links", 3);
   if (!["internal", "demo", "dogfood"].includes(opts.category))
@@ -24346,7 +24852,7 @@ var create6 = new Command("create").description("Create an internal, demo or dog
       ["consultant", opts.consultant],
       ["consultant-title", opts.consultantTitle]
     ];
-    const retry = flags.filter((entry) => entry[1] !== void 0).map(([flag, value]) => `--${flag} '${value.replaceAll("'", "'\\''")}'`).join(" ");
+    const retry = flags.filter((entry) => entry[1] !== void 0).map(([flag, value2]) => `--${flag} '${value2.replaceAll("'", "'\\''")}'`).join(" ");
     confirmationRequired(
       this,
       "--confirm is required to create an account",
@@ -24398,7 +24904,7 @@ var setCategory = new Command("set-category").description("Change an existing ac
   if (reason2.length < 8 || reason2.length > 500)
     fail(this, "--reason must be 8 to 500 characters", 3);
   if (!opts.confirm) {
-    const quote = (value) => `'${value.replaceAll("'", "'\\''")}'`;
+    const quote = (value2) => `'${value2.replaceAll("'", "'\\''")}'`;
     confirmationRequired(
       this,
       "--confirm is required to change an account category",
@@ -24430,7 +24936,7 @@ var setManagedBy = new Command("set-managed-by").description("Assign or clear a
   if (reason2.length < 8 || reason2.length > 500)
     fail(this, "--reason must be 8 to 500 characters", 3);
   if (!opts.confirm) {
-    const quote = (value) => `'${value.replaceAll("'", "'\\''")}'`;
+    const quote = (value2) => `'${value2.replaceAll("'", "'\\''")}'`;
     confirmationRequired(
       this,
       "--confirm is required to change a managing agency",
@@ -24465,7 +24971,7 @@ var setWorkspaceType = new Command("set-workspace-type").description("Change a w
   if (reason2.length < 8 || reason2.length > 500)
     fail(this, "--reason must be 8 to 500 characters", 3);
   if (!opts.confirm) {
-    const quote = (value) => `'${value.replaceAll("'", "'\\''")}'`;
+    const quote = (value2) => `'${value2.replaceAll("'", "'\\''")}'`;
     confirmationRequired(
       this,
       "--confirm is required to change a workspace type",
@@ -24510,7 +25016,7 @@ function storeMoveRequest(opts) {
 var moveStores = new Command("move-stores").description("Preview or confirm an audited set of store moves").requiredOption("--to <org-id>", "Destination organization UUID").requiredOption(
   "--shop <shop-id>",
   "Store UUID, repeat for each store",
-  (value, previous) => [...previous, value],
+  (value2, previous) => [...previous, value2],
   []
 ).requiredOption("--reason <text>", "Audit reason, 8 to 500 characters").option("--keep-grants", "Preserve explicit store roles and overrides").option("--confirm", "Perform the move; otherwise return a read-only plan").option("--json", "Output JSON").action(async function(opts) {
   let request2;
@@ -24534,7 +25040,7 @@ var moveStores = new Command("move-stores").description("Preview or confirm an a
   output(this, res.data, () => {
     printTable(
       ["FIELD", "VALUE"],
-      Object.entries(res.data.data).map(([key, value]) => [key, JSON.stringify(value)])
+      Object.entries(res.data.data).map(([key, value2]) => [key, JSON.stringify(value2)])
     );
   });
 });
@@ -24560,8 +25066,8 @@ async function confirm(c, force, label, retry) {
   if (force) return true;
   if (!process.stdin.isTTY || !process.stdout.isTTY)
     confirmationRequired(c, `${label} requires confirmation in non-TTY mode.`, retry);
-  const readline3 = await import("node:readline");
-  const rl = readline3.createInterface({ input: process.stdin, output: process.stderr });
+  const readline4 = await import("node:readline");
+  const rl = readline4.createInterface({ input: process.stdin, output: process.stderr });
   const answer = await new Promise(
     (resolve2) => rl.question(source_default.yellow(`${label}? [y/N] `), resolve2)
   );
@@ -24800,6 +25306,48 @@ ${res.data.data.avatarDataUrl ?? "(no avatar)"}`
 }).addCommand(set6);
 var accountCommand = new Command("account").description("Manage your Apex account").addCommand(profile2);
 
+// src/commands/commerce.ts
+async function run3(command, params) {
+  const response = await lookupCommerceCatalog(requireCredentials(), params);
+  if (!response.ok || !response.data)
+    fail(
+      command,
+      response.error ?? "Catalog lookup failed",
+      classifyStatus(response.status),
+      response.errorDetails
+    );
+  output(command, response.data, () => {
+    const data = response.data.data;
+    const products = data.mode === "product" ? [data.product] : data.products;
+    const rows = products.flatMap(
+      (product) => product.variants.map((variant) => [
+        variant.id,
+        variant.title,
+        variant.sku ?? "",
+        variant.price,
+        variant.unit_cost ?? "unknown",
+        // Search results carry no exclusion data; never present them as eligible.
+        variant.price_test_exclusion ?? "unknown"
+      ])
+    );
+    printTable(
+      ["GID", "TITLE", "SKU", "PRICE", "COST", "EXCLUSION"],
+      rows,
+      [42, 24, 18, 12, 12, 14]
+    );
+  });
+}
+var search = new Command("search").description("Search the commerce product catalog").argument("[query]", "Product search query").option("--cursor <cursor>").option("--limit <limit>", "Products per page", (v) => Number(v)).action(async function(query, opts) {
+  await run3(this, { query, ...opts });
+});
+var get10 = new Command("get").description("Get one product and its variants").argument("[handle]", "Exact product handle").option("--product-id <id>", "Shopify product ID").option("--cursor <cursor>").action(async function(handle, opts) {
+  if (!handle && !opts.productId || handle && opts.productId)
+    fail(this, "Provide exactly one of <handle> or --product-id", 3);
+  await run3(this, { handle, product_id: opts.productId, cursor: opts.cursor });
+});
+var catalog = new Command("catalog").description("Look up products for commerce drafts").addCommand(search).addCommand(get10);
+var commerceCommand = new Command("commerce").description("Commerce catalog tools").addCommand(catalog);
+
 // src/commands/keys.ts
 function selected() {
   const credentials = requireUserCredentials();
@@ -24884,17 +25432,17 @@ async function readResponseText(res) {
   let totalBytes = 0;
   try {
     while (totalBytes < MAX_RESPONSE_BYTES) {
-      const { done: done2, value } = await reader.read();
+      const { done: done2, value: value2 } = await reader.read();
       if (done2) break;
       const remainingBytes = MAX_RESPONSE_BYTES - totalBytes;
-      if (value.byteLength >= remainingBytes) {
-        chunks.push(value.byteLength === remainingBytes ? value : value.slice(0, remainingBytes));
+      if (value2.byteLength >= remainingBytes) {
+        chunks.push(value2.byteLength === remainingBytes ? value2 : value2.slice(0, remainingBytes));
         totalBytes += remainingBytes;
         await reader.cancel().catch(() => void 0);
         break;
       }
-      chunks.push(value);
-      totalBytes += value.byteLength;
+      chunks.push(value2);
+      totalBytes += value2.byteLength;
     }
   } finally {
     reader.releaseLock();
@@ -24924,8 +25472,8 @@ async function fetchText(url) {
   });
   return { status: res.status, text: await readResponseText(res), finalUrl: res.url };
 }
-function abs(base, path26) {
-  return new URL(path26, base).toString();
+function abs(base, path27) {
+  return new URL(path27, base).toString();
 }
 function looksLikeShopifyCart(text2) {
   try {
@@ -24945,9 +25493,9 @@ async function collectSignals(url) {
   const chunks = [`__apex_primary_status_${primary.status}__`, primary.text];
   const protectedHit = primary.status === 403 || primary.status === 429 || matchDetectionMarkers(primary.text, "protected").length > 0;
   if (!protectedHit) {
-    for (const path26 of ["/cart.js"]) {
+    for (const path27 of ["/cart.js"]) {
       try {
-        const secondary = await fetchText(abs(primary.finalUrl || url, path26));
+        const secondary = await fetchText(abs(primary.finalUrl || url, path27));
         if (secondary.status >= 200 && secondary.status < 300 && looksLikeShopifyCart(secondary.text)) {
           chunks.push("__apex_secondary_shopify_cart_js__", secondary.text.slice(0, 2e3));
         }
@@ -25133,7 +25681,7 @@ var list14 = new Command("list").alias("ls").description(
 var create8 = new Command("create").description(`Create a webhook. Prints the signing secret once. Signature docs: ${SIGNATURE_DOC}`).requiredOption("--url <url>", "HTTPS callback URL").option(
   "--event <event>",
   "Webhook event to subscribe to; repeat for multiple events",
-  (value, previous = []) => [...previous, value],
+  (value2, previous = []) => [...previous, value2],
   []
 ).action(async function action73(opts) {
   const events = selectedEvents(opts);
@@ -25188,7 +25736,7 @@ var deliveries = new Command("deliveries").description("List webhook deliveries
 var update5 = new Command("update").description("Update a webhook URL, events, or active state").argument("<id>", "Webhook id").option("--url <url>", "HTTPS callback URL").option(
   "--event <event>",
   "Replacement event; repeat for multiple events",
-  (value, previous = []) => [...previous, value],
+  (value2, previous = []) => [...previous, value2],
   []
 ).option("--active", "Enable the webhook").option("--inactive", "Disable the webhook").action(async function action76(id, opts) {
   if (opts.active && opts.inactive)
@@ -25242,10 +25790,10 @@ var webhooksCommand = new Command("webhooks").description("Manage shop webhooks"
 
 // src/commands/simulate.ts
 init_source();
-var import_node_fs27 = __toESM(require("node:fs"));
-var import_node_path24 = __toESM(require("node:path"));
+var import_node_fs28 = __toESM(require("node:fs"));
+var import_node_path25 = __toESM(require("node:path"));
 function readJson2(file) {
-  const text2 = file === "-" ? import_node_fs27.default.readFileSync(0, "utf8") : import_node_fs27.default.readFileSync(import_node_path24.default.resolve(file), "utf8");
+  const text2 = file === "-" ? import_node_fs28.default.readFileSync(0, "utf8") : import_node_fs28.default.readFileSync(import_node_path25.default.resolve(file), "utf8");
   try {
     return JSON.parse(text2);
   } catch (error) {
@@ -25257,21 +25805,21 @@ function readJson2(file) {
 function plural(count2, singular3) {
   return `${count2} ${singular3}${count2 === 1 ? "" : "s"}`;
 }
-function isGtagEventTuple(value) {
-  return Array.isArray(value) && value[0] === "event" && typeof value[1] === "string";
+function isGtagEventTuple(value2) {
+  return Array.isArray(value2) && value2[0] === "event" && typeof value2[1] === "string";
 }
-function isPlainObject(value) {
-  if (value === null || typeof value !== "object" || Array.isArray(value)) return false;
-  const prototype = Object.getPrototypeOf(value);
+function isPlainObject(value2) {
+  if (value2 === null || typeof value2 !== "object" || Array.isArray(value2)) return false;
+  const prototype = Object.getPrototypeOf(value2);
   return prototype === Object.prototype || prototype === null;
 }
-function isExplicitPayloadBatch(value) {
-  if (!Array.isArray(value) || isGtagEventTuple(value)) return false;
-  if (value.length > 0 && value.every((entry) => isPlainObject(entry) || isGtagEventTuple(entry))) {
+function isExplicitPayloadBatch(value2) {
+  if (!Array.isArray(value2) || isGtagEventTuple(value2)) return false;
+  if (value2.length > 0 && value2.every((entry) => isPlainObject(entry) || isGtagEventTuple(entry))) {
     return true;
   }
-  if (value.length > 0 && typeof value[0] === "string") return false;
-  return value.some((entry) => isPlainObject(entry) || isGtagEventTuple(entry));
+  if (value2.length > 0 && typeof value2[0] === "string") return false;
+  return value2.some((entry) => isPlainObject(entry) || isGtagEventTuple(entry));
 }
 var simulateCommand = new Command("simulate").description("Simulate data-layer triggers without emitting events").option("--config <file>", "Trigger config JSON file").requiredOption("--payload <file|->", "Payload JSON file or stdin").option("--from-shop", "Load live triggers from the selected shop").action(async function(opts) {
   if (Boolean(opts.config) === Boolean(opts.fromShop)) {
@@ -25354,7 +25902,7 @@ var simulateCommand = new Command("simulate").description("Simulate data-layer t
       }
       if (!result.matches.length) {
         const numericPaths = result.diagnostics.numericPaths.map(
-          ({ path: numericPath, value }) => `${numericPath}=${value}`
+          ({ path: numericPath, value: value2 }) => `${numericPath}=${value2}`
         ).join(", ");
         console.log(`  numeric paths: ${numericPaths || "none"}`);
       }
@@ -25367,14 +25915,14 @@ var simulateCommand = new Command("simulate").description("Simulate data-layer t
 });
 
 // src/commands/config-resources.ts
-var import_node_fs29 = __toESM(require("node:fs"));
-var import_node_path26 = __toESM(require("node:path"));
+var import_node_fs30 = __toESM(require("node:fs"));
+var import_node_path27 = __toESM(require("node:path"));
 
 // src/commands/landing-pages.ts
 var import_node_crypto9 = __toESM(require("node:crypto"));
-var import_node_fs28 = __toESM(require("node:fs"));
-var import_node_path25 = __toESM(require("node:path"));
-function apiFailure(command, response, fallback2) {
+var import_node_fs29 = __toESM(require("node:fs"));
+var import_node_path26 = __toESM(require("node:path"));
+function apiFailure2(command, response, fallback2) {
   if (!response.ok || response.data === void 0) {
     fail(
       command,
@@ -25388,13 +25936,13 @@ function sha256(body5) {
   return import_node_crypto9.default.createHash("sha256").update(body5).digest("hex");
 }
 function markerPath(folder) {
-  return import_node_path25.default.join(folder, LANDING_PAGE_CHECKOUT_MARKER);
+  return import_node_path26.default.join(folder, LANDING_PAGE_CHECKOUT_MARKER);
 }
 function readMarker(folder) {
   const file = markerPath(folder);
-  if (!import_node_fs28.default.existsSync(file)) return null;
+  if (!import_node_fs29.default.existsSync(file)) return null;
   try {
-    return JSON.parse(import_node_fs28.default.readFileSync(file, "utf8"));
+    return JSON.parse(import_node_fs29.default.readFileSync(file, "utf8"));
   } catch (error) {
     throw new CliError(
       `${LANDING_PAGE_CHECKOUT_MARKER} is not valid JSON: ${error instanceof Error ? error.message : String(error)}`,
@@ -25412,14 +25960,14 @@ function readMarker(folder) {
   }
 }
 function writeMarker(folder, marker) {
-  import_node_fs28.default.mkdirSync(import_node_path25.default.dirname(markerPath(folder)), { recursive: true });
-  import_node_fs28.default.writeFileSync(import_node_path25.default.join(folder, ".apex", ".gitignore"), "landing-page.json\n", "utf8");
-  import_node_fs28.default.writeFileSync(markerPath(folder), `${JSON.stringify(marker, null, 2)}
+  import_node_fs29.default.mkdirSync(import_node_path26.default.dirname(markerPath(folder)), { recursive: true });
+  import_node_fs29.default.writeFileSync(import_node_path26.default.join(folder, ".apex", ".gitignore"), "landing-page.json\n", "utf8");
+  import_node_fs29.default.writeFileSync(markerPath(folder), `${JSON.stringify(marker, null, 2)}
 `, "utf8");
 }
 function requireCheckout(command, folderArg) {
-  const folder = import_node_path25.default.resolve(process.cwd(), folderArg);
-  const marker = import_node_fs28.default.existsSync(folder) && import_node_fs28.default.statSync(folder).isDirectory() ? readMarker(folder) : null;
+  const folder = import_node_path26.default.resolve(process.cwd(), folderArg);
+  const marker = import_node_fs29.default.existsSync(folder) && import_node_fs29.default.statSync(folder).isDirectory() ? readMarker(folder) : null;
   if (!marker) {
     fail(command, `${folderArg} is not a landing-page checkout.`, EXIT_CODES.validation, {
       code: "validation_failed",
@@ -25431,8 +25979,8 @@ function requireCheckout(command, folderArg) {
   return { folder, marker };
 }
 function resolvePageId(target) {
-  const folder = import_node_path25.default.resolve(process.cwd(), target);
-  if (import_node_fs28.default.existsSync(folder) && import_node_fs28.default.statSync(folder).isDirectory()) {
+  const folder = import_node_path26.default.resolve(process.cwd(), target);
+  if (import_node_fs29.default.existsSync(folder) && import_node_fs29.default.statSync(folder).isDirectory()) {
     const marker = readMarker(folder);
     if (marker) return marker.landingPageId;
     throw new CliError(
@@ -25454,16 +26002,16 @@ function resolvePageId(target) {
 function readCheckoutFiles(folder) {
   const files = [];
   const visit2 = (directory) => {
-    for (const entry of import_node_fs28.default.readdirSync(directory, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {
-      const absolute = import_node_path25.default.join(directory, entry.name);
-      const relative = import_node_path25.default.relative(folder, absolute).split(import_node_path25.default.sep).join("/");
+    for (const entry of import_node_fs29.default.readdirSync(directory, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {
+      const absolute = import_node_path26.default.join(directory, entry.name);
+      const relative = import_node_path26.default.relative(folder, absolute).split(import_node_path26.default.sep).join("/");
       if (!isLandingPageCheckoutPath(relative)) continue;
       if (entry.isDirectory()) visit2(absolute);
       else if (entry.isFile()) {
         try {
           validateLandingPageLocalFiles([
             ...files,
-            { path: relative, bytes: import_node_fs28.default.statSync(absolute).size, sha256: "" }
+            { path: relative, bytes: import_node_fs29.default.statSync(absolute).size, sha256: "" }
           ]);
         } catch (error) {
           throw new CliError(
@@ -25471,7 +26019,7 @@ function readCheckoutFiles(folder) {
             EXIT_CODES.validation
           );
         }
-        const body5 = import_node_fs28.default.readFileSync(absolute);
+        const body5 = import_node_fs29.default.readFileSync(absolute);
         files.push({ path: relative, sha256: sha256(body5), bytes: body5.byteLength, body: body5 });
       }
     }
@@ -25488,8 +26036,8 @@ function readCheckoutFiles(folder) {
   return files;
 }
 function readManifest2(command, folder) {
-  const file = import_node_path25.default.join(folder, LANDING_PAGE_MANIFEST_FILE);
-  if (!import_node_fs28.default.existsSync(file)) {
+  const file = import_node_path26.default.join(folder, LANDING_PAGE_MANIFEST_FILE);
+  if (!import_node_fs29.default.existsSync(file)) {
     fail(
       command,
       `${LANDING_PAGE_MANIFEST_FILE} is missing from the checkout.`,
@@ -25500,7 +26048,7 @@ function readManifest2(command, folder) {
     );
   }
   try {
-    return JSON.parse(import_node_fs28.default.readFileSync(file, "utf8"));
+    return JSON.parse(import_node_fs29.default.readFileSync(file, "utf8"));
   } catch (error) {
     fail(
       command,
@@ -25546,15 +26094,15 @@ function printPlan(plan2) {
 }
 async function confirm2(message) {
   if (!process.stdin.isTTY || !process.stdout.isTTY) return null;
-  const readline3 = await import("node:readline");
-  const rl = readline3.createInterface({ input: process.stdin, output: process.stderr });
+  const readline4 = await import("node:readline");
+  const rl = readline4.createInterface({ input: process.stdin, output: process.stderr });
   const answer = await new Promise((resolve2) => rl.question(`${message} [y/N] `, resolve2));
   rl.close();
   return answer.trim().toLowerCase() === "y";
 }
 function manifestDigest(folder) {
-  const file = import_node_path25.default.join(folder, LANDING_PAGE_MANIFEST_FILE);
-  return import_node_fs28.default.existsSync(file) ? sha256(import_node_fs28.default.readFileSync(file)) : null;
+  const file = import_node_path26.default.join(folder, LANDING_PAGE_MANIFEST_FILE);
+  return import_node_fs29.default.existsSync(file) ? sha256(import_node_fs29.default.readFileSync(file)) : null;
 }
 function localChanges(folder, marker) {
   const local = new Map(readCheckoutFiles(folder).map((file) => [file.path, file.sha256]));
@@ -25572,8 +26120,8 @@ function removeStaleFiles(folder, previous, next, added = []) {
   if (!previous) return;
   for (const file of [...Object.keys(previous.files), ...added]) {
     if (next.has(file) || !isLandingPageCheckoutPath(file)) continue;
-    const absolute = import_node_path25.default.resolve(folder, file);
-    if (absolute.startsWith(folder + import_node_path25.default.sep) && import_node_fs28.default.existsSync(absolute)) import_node_fs28.default.rmSync(absolute);
+    const absolute = import_node_path26.default.resolve(folder, file);
+    if (absolute.startsWith(folder + import_node_path26.default.sep) && import_node_fs29.default.existsSync(absolute)) import_node_fs29.default.rmSync(absolute);
   }
 }
 async function pullCheckout(command, creds, id, folder, force = false) {
@@ -25612,8 +26160,8 @@ async function pullCheckout(command, creds, id, folder, force = false) {
   }
   const api = landingPages(creds);
   const listing = await api.checkout(id);
-  apiFailure(command, listing, "Failed to pull landing page");
-  import_node_fs28.default.mkdirSync(folder, { recursive: true });
+  apiFailure2(command, listing, "Failed to pull landing page");
+  import_node_fs29.default.mkdirSync(folder, { recursive: true });
   const written = {};
   const downloaded = [];
   for (const batch of landingPageBatches(listing.data.files, (file) => file.bytes)) {
@@ -25621,14 +26169,14 @@ async function pullCheckout(command, creds, id, folder, force = false) {
       id,
       batch.map((file) => file.path)
     );
-    apiFailure(command, contents, "Failed to pull landing page files");
+    apiFailure2(command, contents, "Failed to pull landing page files");
     const returned2 = new Set(contents.data.files.map((file) => file.path));
     const missing = batch.filter((file) => !returned2.has(file.path)).map((file) => file.path);
     if (missing.length)
       fail(command, `The server did not return ${missing.slice(0, 5).join(", ")}. Pull again.`);
     for (const file of contents.data.files) {
-      const target = import_node_path25.default.resolve(folder, file.path);
-      if (!target.startsWith(folder + import_node_path25.default.sep))
+      const target = import_node_path26.default.resolve(folder, file.path);
+      if (!target.startsWith(folder + import_node_path26.default.sep))
         fail(command, `Refusing to write outside the checkout: ${file.path}`);
       const download = file.download_url ? await fetch(file.download_url, { signal: AbortSignal.timeout(6e4) }) : null;
       if (download && !download.ok)
@@ -25641,7 +26189,7 @@ async function pullCheckout(command, creds, id, folder, force = false) {
   }
   if (!existing && !force) {
     const clobbered = downloaded.filter(
-      ({ target, sha256: digest }) => import_node_fs28.default.existsSync(target) && sha256(import_node_fs28.default.readFileSync(target)) !== digest
+      ({ target, sha256: digest }) => import_node_fs29.default.existsSync(target) && sha256(import_node_fs29.default.readFileSync(target)) !== digest
     ).map((file) => file.path);
     if (clobbered.length) {
       fail(
@@ -25665,8 +26213,8 @@ async function pullCheckout(command, creds, id, folder, force = false) {
     }
   }
   for (const file of downloaded) {
-    import_node_fs28.default.mkdirSync(import_node_path25.default.dirname(file.target), { recursive: true });
-    import_node_fs28.default.writeFileSync(file.target, file.body);
+    import_node_fs29.default.mkdirSync(import_node_path26.default.dirname(file.target), { recursive: true });
+    import_node_fs29.default.writeFileSync(file.target, file.body);
     written[file.path] = file.sha256;
   }
   removeStaleFiles(
@@ -25675,24 +26223,24 @@ async function pullCheckout(command, creds, id, folder, force = false) {
     new Set(Object.keys(written)),
     force ? readCheckoutFiles(folder).map((file) => file.path) : []
   );
-  import_node_fs28.default.writeFileSync(
-    import_node_path25.default.join(folder, LANDING_PAGE_MANIFEST_FILE),
+  import_node_fs29.default.writeFileSync(
+    import_node_path26.default.join(folder, LANDING_PAGE_MANIFEST_FILE),
     `${JSON.stringify(listing.data.manifest ?? {}, null, 2)}
 `,
     "utf8"
   );
-  const contextDir = import_node_path25.default.join(folder, LANDING_PAGE_CONTEXT_DIR);
-  import_node_fs28.default.mkdirSync(contextDir, { recursive: true });
+  const contextDir = import_node_path26.default.join(folder, LANDING_PAGE_CONTEXT_DIR);
+  import_node_fs29.default.mkdirSync(contextDir, { recursive: true });
   const contextName = /^[a-z0-9_-]+\.json$/i;
   const contextEntries = Object.entries(listing.data.context ?? {}).filter(
     ([name]) => contextName.test(name)
   );
   const returned = new Set(contextEntries.map(([name]) => name));
-  for (const name of import_node_fs28.default.readdirSync(contextDir)) {
-    if (contextName.test(name) && !returned.has(name)) import_node_fs28.default.rmSync(import_node_path25.default.join(contextDir, name));
+  for (const name of import_node_fs29.default.readdirSync(contextDir)) {
+    if (contextName.test(name) && !returned.has(name)) import_node_fs29.default.rmSync(import_node_path26.default.join(contextDir, name));
   }
-  for (const [name, value] of contextEntries) {
-    import_node_fs28.default.writeFileSync(import_node_path25.default.join(contextDir, name), `${JSON.stringify(value, null, 2)}
+  for (const [name, value2] of contextEntries) {
+    import_node_fs29.default.writeFileSync(import_node_path26.default.join(contextDir, name), `${JSON.stringify(value2, null, 2)}
 `, "utf8");
   }
   writeMarker(folder, {
@@ -25723,8 +26271,8 @@ var create9 = new Command("create").description("Create a landing page to build
     ...opts.slug ? { slug: opts.slug } : {},
     ...opts.idea ? { idea_key: opts.idea } : {}
   });
-  apiFailure(this, created, "Failed to create landing page");
-  const pulled = opts.out ? await pullCheckout(this, creds, created.data.id, import_node_path25.default.resolve(process.cwd(), opts.out)) : null;
+  apiFailure2(this, created, "Failed to create landing page");
+  const pulled = opts.out ? await pullCheckout(this, creds, created.data.id, import_node_path26.default.resolve(process.cwd(), opts.out)) : null;
   output(
     this,
     { landing_page: created.data, ...pulled ? { folder: pulled.folder } : {} },
@@ -25736,7 +26284,7 @@ var create9 = new Command("create").description("Create a landing page to build
 });
 var pull = new Command("pull").description("Pull a landing page into a checkout folder").argument("<id>", "Landing page id").option("--out <folder>", "Target folder (default: a folder named after the id)").option("--force", "Overwrite changes in the checkout that are not applied").action(async function(id, opts) {
   const creds = requireCredentials();
-  const folder = import_node_path25.default.resolve(process.cwd(), opts.out ?? id);
+  const folder = import_node_path26.default.resolve(process.cwd(), opts.out ?? id);
   const result = await pullCheckout(this, creds, id, folder, opts.force === true);
   output(this, result, () => {
     console.log(
@@ -25754,7 +26302,7 @@ var plan = new Command("plan").description("Show what applying a checkout would
     manifest: readManifest2(this, folder),
     files: declared(files)
   });
-  apiFailure(this, response, "Failed to plan landing page");
+  apiFailure2(this, response, "Failed to plan landing page");
   output(
     this,
     { folder, landingPageId: marker.landingPageId, plan: response.data },
@@ -25768,7 +26316,7 @@ var apply = new Command("apply").description("Apply a checkout as a new version"
   const files = readCheckoutFiles(folder);
   const manifest = readManifest2(this, folder);
   const planned = await api.plan(marker.landingPageId, { manifest, files: declared(files) });
-  apiFailure(this, planned, "Failed to plan landing page");
+  apiFailure2(this, planned, "Failed to plan landing page");
   if (!planned.data.would_change) {
     output(
       this,
@@ -25801,7 +26349,7 @@ var apply = new Command("apply").description("Apply a checkout as a new version"
       sha256: file.sha256,
       base_version_id: planned.data.base_version_id
     });
-    apiFailure(this, granted, "Failed to grant video upload");
+    apiFailure2(this, granted, "Failed to grant video upload");
     await uploadLandingVideo(granted.data, file.body, {
       progress: (uploaded, total) => {
         console.error(`Uploading ${file.path}: ${uploaded}/${total} bytes`);
@@ -25820,7 +26368,7 @@ var apply = new Command("apply").description("Apply a checkout as a new version"
         encoding: "base64"
       }))
     );
-    apiFailure(this, uploaded, "Failed to upload landing page files");
+    apiFailure2(this, uploaded, "Failed to upload landing page files");
   }
   const applied = await api.apply(marker.landingPageId, {
     manifest,
@@ -25847,7 +26395,7 @@ var apply = new Command("apply").description("Apply a checkout as a new version"
       }
     );
   }
-  apiFailure(this, applied, "Failed to apply landing page");
+  apiFailure2(this, applied, "Failed to apply landing page");
   writeMarker(folder, {
     ...marker,
     versionId: applied.data.version_id,
@@ -25873,7 +26421,7 @@ var preview = new Command("preview").description("Print a signed preview link (v
     resolvePageId(target),
     versionNumber
   );
-  apiFailure(this, response, "Failed to get preview link");
+  apiFailure2(this, response, "Failed to get preview link");
   output(this, response.data, () => console.log(response.data.preview_url));
 });
 async function versionIdFor(command, creds, id, raw) {
@@ -25882,7 +26430,7 @@ async function versionIdFor(command, creds, id, raw) {
   if (!Number.isInteger(number) || number < 1)
     fail(command, "--version must be a version number.", EXIT_CODES.validation);
   const versions2 = await landingPages(creds).versions(id);
-  apiFailure(command, versions2, "Failed to list versions");
+  apiFailure2(command, versions2, "Failed to list versions");
   const match2 = versions2.data.find((version) => version.version_number === number);
   if (!match2) fail(command, `Version ${number} not found.`, EXIT_CODES.validation);
   return match2.id;
@@ -25902,7 +26450,7 @@ var deploy = new Command("deploy").description(
     ...opts.host ? { host: opts.host } : {},
     ...opts.path ? { path: opts.path } : {}
   });
-  apiFailure(this, response, "Failed to deploy landing page");
+  apiFailure2(this, response, "Failed to deploy landing page");
   output(this, response.data, () => {
     console.log(response.data.url);
     console.log(`Version ${response.data.version_number} is live.`);
@@ -25910,7 +26458,7 @@ var deploy = new Command("deploy").description(
 }).addHelpText("after", SPLIT_KEEPS_SERVING_HELP);
 var versions = new Command("versions").description("List versions").argument("[folder-or-id]", "Checkout folder or landing page id", ".").action(async function(target) {
   const response = await landingPages(requireCredentials()).versions(resolvePageId(target));
-  apiFailure(this, response, "Failed to list versions");
+  apiFailure2(this, response, "Failed to list versions");
   output(
     this,
     response.data,
@@ -25935,7 +26483,7 @@ var rollback = new Command("rollback").description("Deploy an earlier version to
   const response = await landingPages(requireCredentials()).rollback(resolvePageId(target), {
     version_number: number
   });
-  apiFailure(this, response, "Failed to roll back landing page");
+  apiFailure2(this, response, "Failed to roll back landing page");
   output(this, response.data, () => {
     console.log(response.data.url);
     console.log(`Version ${response.data.version_number} is live.`);
@@ -25948,8 +26496,8 @@ var experiment = new Command("experiment").description("Create a draft experimen
   "--variant <number>",
   "Variant version number (default: the manifest's experiment.variant)"
 ).option("--name <name>", "Experiment name").option("--primary-goal <key>", "Manifest goal key to make primary (default: the first goal)").action(async function(target, opts) {
-  const folder = import_node_path25.default.resolve(process.cwd(), target);
-  const fromManifest = import_node_fs28.default.existsSync(import_node_path25.default.join(folder, LANDING_PAGE_MANIFEST_FILE)) ? readManifest2(this, folder)?.experiment ?? {} : {};
+  const folder = import_node_path26.default.resolve(process.cwd(), target);
+  const fromManifest = import_node_fs29.default.existsSync(import_node_path26.default.join(folder, LANDING_PAGE_MANIFEST_FILE)) ? readManifest2(this, folder)?.experiment ?? {} : {};
   const control = Number(opts.control ?? fromManifest.control);
   const variant = Number(opts.variant ?? fromManifest.variant);
   if (!Number.isInteger(control) || !Number.isInteger(variant) || control < 1 || variant < 1) {
@@ -25965,7 +26513,7 @@ var experiment = new Command("experiment").description("Create a draft experimen
     ...opts.name ? { name: opts.name } : {},
     ...opts.primaryGoal ? { primary_goal: opts.primaryGoal } : {}
   });
-  apiFailure(this, response, "Failed to create experiment");
+  apiFailure2(this, response, "Failed to create experiment");
   output(this, response.data, () => {
     console.log(`Draft experiment ${String(response.data.experiment.id)} created.`);
     console.log("Start it in the Apex dashboard when it is ready.");
@@ -26009,8 +26557,8 @@ var ALLOWED_ASSET_EXTENSIONS = Object.keys(ASSET_MIME_TYPES).join(", ");
 var MAX_ASSET_SIZE_BYTES = 10 * 1024 * 1024;
 async function confirmAssetDelete(id) {
   if (!process.stdin.isTTY || !process.stdout.isTTY) return null;
-  const readline3 = await import("node:readline");
-  const rl = readline3.createInterface({
+  const readline4 = await import("node:readline");
+  const rl = readline4.createInterface({
     input: process.stdin,
     output: process.stderr
   });
@@ -26038,28 +26586,30 @@ function readFamily(family, label) {
       this,
       r.data,
       () => printTable(
-        ["ID", "NAME", "STATUS"],
-        r.data.data.map((x) => [x.id, x.name ?? "-", x.status ?? "-"]),
-        [38, 32, 14]
+        family === "assets" ? ["ID", "NAME", "DELIVERY URL", "STATUS"] : ["ID", "NAME", "STATUS"],
+        r.data.data.map(
+          (x) => family === "assets" ? [x.id, x.name ?? "-", x.delivery_url ?? "-", x.status ?? "-"] : [x.id, x.name ?? "-", x.status ?? "-"]
+        ),
+        family === "assets" ? [38, 32, 64, 14] : [38, 32, 14]
       )
     );
   });
-  const get10 = new Command("get").description(`Get one ${label.slice(0, -1)}`).argument("<id>").action(async function(id) {
+  const get11 = new Command("get").description(`Get one ${label.slice(0, -1)}`).argument("<id>").action(async function(id) {
     const r = await getConfigResource(requireCredentials(), family, id);
     if (!r.ok || !r.data)
       fail(this, r.error ?? "Failed to get resource", classifyStatus(r.status), r.errorDetails);
     output(this, r.data, () => show(r.data));
   });
-  return { list: list15, get: get10 };
+  return { list: list15, get: get11 };
 }
 var assetReads = readFamily("assets", "assets");
 var upload = new Command("upload").description("Upload an asset").argument("<file>").action(async function(file) {
-  const absolute = import_node_path26.default.resolve(process.cwd(), file);
-  if (!import_node_fs29.default.existsSync(absolute)) fail(this, `File not found: ${file}`, 3);
-  const fileStat = import_node_fs29.default.statSync(absolute);
+  const absolute = import_node_path27.default.resolve(process.cwd(), file);
+  if (!import_node_fs30.default.existsSync(absolute)) fail(this, `File not found: ${file}`, 3);
+  const fileStat = import_node_fs30.default.statSync(absolute);
   if (!fileStat.isFile()) fail(this, `File not found: ${file}`, 3);
   if (fileStat.size > MAX_ASSET_SIZE_BYTES) fail(this, `${file} is larger than 10 MB`, 3);
-  const mimeType = ASSET_MIME_TYPES[import_node_path26.default.extname(absolute).toLowerCase()];
+  const mimeType = ASSET_MIME_TYPES[import_node_path27.default.extname(absolute).toLowerCase()];
   if (!mimeType)
     fail(
       this,
@@ -26068,8 +26618,8 @@ var upload = new Command("upload").description("Upload an asset").argument("<fil
     );
   const r = await uploadAssets(requireCredentials(), [
     {
-      name: import_node_path26.default.basename(absolute),
-      bytes: import_node_fs29.default.readFileSync(absolute),
+      name: import_node_path27.default.basename(absolute),
+      bytes: import_node_fs30.default.readFileSync(absolute),
       type: mimeType
     }
   ]);
@@ -26101,7 +26651,7 @@ var landingPagesCommand = new Command("landing-pages").description(
 for (const command of landingPageWorkspaceCommands) landingPagesCommand.addCommand(command);
 var snippet = new Command("snippet").description("Generate an external purchase pixel snippet").option("--provider <name>").option("--handover-param <name>").option("--global-name <name>").action(async function(opts) {
   const body5 = Object.fromEntries(
-    Object.entries(opts).filter(([, value]) => value !== void 0)
+    Object.entries(opts).filter(([, value2]) => value2 !== void 0)
   );
   const r = await generateExternalPixelSnippet(requireCredentials(), body5);
   if (!r.ok || !r.data)
@@ -26111,6 +26661,9 @@ var snippet = new Command("snippet").description("Generate an external purchase
 var externalPixelsCommand = new Command("external-pixels").description("Manage external pixels").addCommand(snippet);
 
 // src/cli.ts
+var argvEncoding = repairArgv(process.argv, { platform: process.platform, env: process.env });
+process.argv = argvEncoding.argv;
+var damagedArgumentOptions = replacementCharacterOptions(process.argv);
 var mockApiEnvironmentKey = ["APEX", "CLI", "MOCK", "API"].join("_");
 if (process.env[mockApiEnvironmentKey] === "1" && !cliTestHarnessActive()) {
   const message = "mock harness is not part of the published CLI; use the test artifact";
@@ -26154,6 +26707,8 @@ program2.addCommand(prospectCommand, { hidden: true });
 program2.addCommand(webhooksCommand);
 program2.addCommand(simulateCommand);
 program2.addCommand(experimentsCommand);
+program2.addCommand(resultsCommand);
+program2.addCommand(commerceCommand);
 program2.addCommand(pushCommand);
 program2.addCommand(previewCommand);
 program2.addCommand(roadmapCommand);
@@ -26211,6 +26766,18 @@ program2.hook("preAction", (_thisCommand, actionCommand) => {
     throw error;
   }
   configureRuntime(actionCommand);
+  for (const { option } of argvEncoding.repairs) {
+    process.stderr.write(
+      `apex: repaired the text of ${option} (the console decoded UTF-8 as Windows-1252). Set the console to UTF-8: PowerShell [Console]::InputEncoding = [Console]::OutputEncoding = [Text.Encoding]::UTF8; Git Bash LANG=C.UTF-8 and chcp 65001. APEX_ARGV_ENCODING=off disables the repair.
+`
+    );
+  }
+  for (const option of damagedArgumentOptions) {
+    process.stderr.write(
+      `apex: ${option} contains U+FFFD (the shell replaced a character it could not encode); the value is sent as given.
+`
+    );
+  }
   beginInvocation(actionCommand, resolveContext());
 });
 process.on("beforeExit", () => {
@@ -26227,11 +26794,11 @@ function isExplicitJsonVersionRequest(args) {
     } else if (arg === "--version" || arg === "-V") {
       hasVersion = true;
     } else if (arg === "--org" || arg === "--shop") {
-      const value = args[++index];
-      if (!value || value.startsWith("-")) return false;
+      const value2 = args[++index];
+      if (!value2 || value2.startsWith("-")) return false;
     } else if (arg.startsWith("--org=") || arg.startsWith("--shop=")) {
-      const value = arg.slice(arg.indexOf("=") + 1);
-      if (!value || value.startsWith("-")) return false;
+      const value2 = arg.slice(arg.indexOf("=") + 1);
+      if (!value2 || value2.startsWith("-")) return false;
     } else {
       return false;
     }