@drip-apex/apex-cli 0.17.0 → 0.18.0

package/AGENTS.md

@@ -71,6 +71,8 @@ the first writes: `apex experiments create`, `apex goals create`,
 - Stale workspace or filesystem: pull fresh files, reapply your edits, and plan again.
 - Server limit errors: read the JSON error details; Apex includes server-owned limits when available.
 
+- Windows text corruption: use UTF-8 console settings; Apex repairs reversible Windows-1252 arguments and warns on stderr for U+FFFD. Set `APEX_ARGV_ENCODING=off` to disable repair.
+
 ## Platform Shop Administration
 
 - `apex admin shops archive <shopId>` archives a shop; headless callers must

package/README.md

@@ -199,7 +199,7 @@ including every subcommand, argument, option, and alias.
 - `apex roadmap` — consume approved roadmap ideas and handoffs.
 - `apex harness` — develop AB Test Harness projects with live QA sessions.
 - `apex workspace` — check out, preview, and publish draft workspace files.
-- `apex goals` — manage conversion and revenue goals.
+- `apex goals` — manage conversion and revenue goals. Create/update accept `--page-id <id>` (UUID only, no lookup) or `--page <id-or-key>` (keys need `pages:read` for lookup); use one option.
 - `apex flags` — manage feature flags.
 - `apex personalizations` — manage personalization deliveries.
 - `apex backlog` — manage experiment backlog items.
@@ -222,7 +222,7 @@ including every subcommand, argument, option, and alias.
 ### Shop configuration and operations
 
 - `apex external-pixels` — manage external pixel snippets.
-- `apex assets` — manage uploaded assets.
+- `apex assets` — manage uploaded assets. Upload returns `delivery_url`; embed that permanent URL in variation code. `public_url` expires after 300 seconds. Delivery is anonymous once the referencing experiment or snippet is published, and resolves through the owning shop's dashboard session or a QA preview before that. Only the absolute https form is recognized as an owned reference; protocol-relative or http forms are not granted at publication.
 - `apex landing-pages` — build landing pages with your own tools, then apply, preview, deploy and roll them back.
 - `apex brand` — manage brand context.
 - `apex shops` — manage shops and active-shop context.
@@ -526,6 +526,27 @@ latest/minimum policy is cached for seven days, so offline commands still enforc
 known floor. `APEX_NO_UPDATE_CHECK=1` disables the npm lookup and optional update
 notice, but never hides a required server-floor upgrade.
 
+### Windows: UTF-8 arguments
+
+A Windows console or launcher can decode UTF-8 as Windows-1252, turning `A – B · C`
+into `A – B · C`. On Windows, Apex automatically repairs reversible argument
+values at startup and writes a note to stderr. Set `APEX_ARGV_ENCODING=off` to
+keep arguments unchanged, or `APEX_ARGV_ENCODING=repair` to enable repair on
+another platform.
+
+Use UTF-8 in PowerShell:
+
+```powershell
+[Console]::InputEncoding = [Console]::OutputEncoding = [Text.Encoding]::UTF8
+```
+
+For Git Bash, set `LANG=C.UTF-8` and run `chcp 65001`.
+
+A replacement character (`�`, U+FFFD) means the shell already lost a character.
+Apex sends that value as given and warns on stderr. It also warns when stored
+experiment names, descriptions, variation names, or goal names contain U+FFFD.
+These notes leave JSON stdout unchanged.
+
 ## Usage telemetry
 
 Authenticated invocations send a process invocation ID, full command path, explicitly set

package/dist/cli.js

@@ -7423,7 +7423,7 @@ async function checkForUpdate(current) {
 // package.json
 var package_default = {
   name: "@drip-apex/apex-cli",
-  version: "0.17.0",
+  version: "0.18.0",
   license: "MIT",
   description: "Apex CLI for managing experiments, approved roadmap ideas, and draft workspaces.",
   private: false,
@@ -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;
 }
 
@@ -9621,6 +9630,13 @@ 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"));
@@ -10526,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`;
@@ -10684,6 +10700,114 @@ function createAssetReferenceRewriter(options) {
   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",
@@ -13601,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) {
@@ -13636,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");
@@ -13680,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,
@@ -13702,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;
@@ -13737,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");
@@ -13796,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)
@@ -14278,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,
     {
@@ -18042,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;
@@ -18238,6 +18389,24 @@ async function resolveGoalPageId(command, creds, value2) {
     { 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));
@@ -18260,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."));
@@ -18278,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,
@@ -18317,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,
@@ -18351,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(
@@ -26411,9 +26586,11 @@ 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]
       )
     );
   });
@@ -26484,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";
@@ -26586,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", () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@drip-apex/apex-cli",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "license": "MIT",
   "description": "Apex CLI for managing experiments, approved roadmap ideas, and draft workspaces.",
   "private": false,