@drip-apex/apex-cli 0.6.3 → 0.8.0

package/dist/cli.js

@@ -6158,16 +6158,16 @@ __export(ora_exports, {
 function ora(options) {
   return new Ora(options);
 }
-async function oraPromise(action71, options) {
-  const actionIsFunction = typeof action71 === "function";
-  const actionIsPromise = typeof action71.then === "function";
+async function oraPromise(action74, options) {
+  const actionIsFunction = typeof action74 === "function";
+  const actionIsPromise = typeof action74.then === "function";
   if (!actionIsFunction && !actionIsPromise) {
     throw new TypeError("Parameter `action` must be a Function or a Promise");
   }
   const { successText, failText } = typeof options === "object" ? options : { successText: void 0, failText: void 0 };
   const spinner = ora(options).start();
   try {
-    const promise = actionIsFunction ? action71(spinner) : action71;
+    const promise = actionIsFunction ? action74(spinner) : action74;
     const result = await promise;
     spinner.succeed(
       successText === void 0 ? void 0 : typeof successText === "string" ? successText : successText(result)
@@ -7112,7 +7112,7 @@ var import_node_os3 = __toESM(require("node:os"));
 // package.json
 var package_default = {
   name: "@drip-apex/apex-cli",
-  version: "0.6.3",
+  version: "0.8.0",
   license: "MIT",
   description: "Apex CLI for managing experiments, approved roadmap ideas, and draft workspaces.",
   private: false,
@@ -7310,6 +7310,15 @@ function classifyApiError(status2, details) {
 function confirmationRequired(command, message, retry) {
   return fail(command, message, EXIT_CODES.confirmationRequired, { retry });
 }
+var liveSpinners = /* @__PURE__ */ new Set();
+var exitFallback;
+function drainAndExit(code) {
+  for (const spinner of liveSpinners) spinner.stop();
+  process.exitCode = code;
+  if (exitFallback) clearTimeout(exitFallback);
+  exitFallback = setTimeout(() => process.exit(code), 500);
+  exitFallback.unref();
+}
 async function createSpinner(message) {
   if (jsonMode || !process.stderr.isTTY) {
     return {
@@ -7328,7 +7337,20 @@ async function createSpinner(message) {
     };
   }
   const { default: ora2 } = await Promise.resolve().then(() => (init_ora(), ora_exports));
-  return ora2(message).start();
+  const spinner = ora2(message);
+  const start = spinner.start.bind(spinner);
+  spinner.start = (...args) => {
+    liveSpinners.add(spinner);
+    return start(...args);
+  };
+  for (const method of ["stop", "succeed", "fail"]) {
+    const original = spinner[method].bind(spinner);
+    spinner[method] = (...args) => {
+      liveSpinners.delete(spinner);
+      return original(...args);
+    };
+  }
+  return spinner.start();
 }
 async function maybeCheckForUpdate() {
   if (!process.stderr.isTTY || process.env.APEX_NO_UPDATE_CHECK === "1" || CLI_VERSION === "unknown")
@@ -7350,7 +7372,8 @@ async function maybeCheckForUpdate() {
 async function handleCliError(err, command) {
   if (err && typeof err === "object" && "exitCode" in err && err.exitCode === 0) {
     flushFallbackEnvelope();
-    process.exit(0);
+    drainAndExit(0);
+    return;
   }
   const commanderExitCode = err && typeof err === "object" && "exitCode" in err && typeof err.exitCode === "number" ? err.exitCode : null;
   const cliError = err instanceof CliError ? err : new CliError(
@@ -7371,7 +7394,7 @@ async function handleCliError(err, command) {
 `);
     }
   }
-  process.exit(cliError.exitCode);
+  drainAndExit(cliError.exitCode);
 }
 
 // ../api-client/src/credentials.ts
@@ -7754,6 +7777,15 @@ function upsertExperimentBySlug(creds, slug, body5) {
 function createExperiment(creds, body5) {
   return request(creds, "POST", "/api/v1/experiments", body5);
 }
+function updateExperiment(creds, id, body5) {
+  return request(creds, "PATCH", `/api/v1/experiments/${encodeURIComponent(id)}`, body5);
+}
+function attachExperimentIdea(creds, id, body5) {
+  return request(creds, "POST", `/api/v1/experiments/${encodeURIComponent(id)}/idea`, body5);
+}
+function detachExperimentIdea(creds, id) {
+  return request(creds, "DELETE", `/api/v1/experiments/${encodeURIComponent(id)}/idea`);
+}
 function pauseExperiment(creds, id) {
   return request(creds, "POST", `/api/v1/experiments/${id}/pause`);
 }
@@ -7781,7 +7813,13 @@ function createExperimentScreenshots(creds, id, body5) {
 }
 async function getScreenshotJob(creds, jobId, timeoutMs) {
   await testScreenshotDelay?.(timeoutMs);
-  return request(creds, "GET", `/api/v1/screenshots/${jobId}`, void 0, timeoutMs);
+  return request(
+    creds,
+    "GET",
+    `/api/v1/screenshots/${encodeURIComponent(jobId)}`,
+    void 0,
+    timeoutMs
+  );
 }
 function planExperimentFilesystem(creds, id, body5) {
   return request(
@@ -8122,8 +8160,8 @@ function requestTargetingResource(creds, method, kind5, id, body5, limit, cursor
   const path24 = `/api/v1/${kind5}${id ? `/${id.split("/").map(encodeURIComponent).join("/")}` : ""}${query ? `?${query}` : ""}`;
   return request(creds, method, path24, body5);
 }
-function managedPath(kind5, id, action71) {
-  return `/api/v1/${kind5}${id ? `/${encodeURIComponent(id)}` : ""}${action71 ? `/${action71}` : ""}`;
+function managedPath(kind5, id, action74) {
+  return `/api/v1/${kind5}${id ? `/${encodeURIComponent(id)}` : ""}${action74 ? `/${action74}` : ""}`;
 }
 function listManagedDeliveries(creds, kind5, limit) {
   const q = limit ? `?limit=${limit}` : "";
@@ -8141,8 +8179,8 @@ function createManagedDelivery(creds, kind5, body5) {
 function updateManagedDelivery(creds, kind5, id, body5) {
   return request(creds, "PATCH", managedPath(kind5, id), body5);
 }
-function transitionManagedDelivery(creds, kind5, id, action71) {
-  return request(creds, "POST", managedPath(kind5, id, action71));
+function transitionManagedDelivery(creds, kind5, id, action74) {
+  return request(creds, "POST", managedPath(kind5, id, action74));
 }
 function listConfigResources(creds, family, opts) {
   const params = new URLSearchParams();
@@ -8301,6 +8339,28 @@ function restoreBacklogInsight(creds, id) {
 function deleteInsight(creds, kind5, id) {
   return request(creds, "DELETE", insightPath(kind5, id));
 }
+function listBacklogFields(creds, includeArchived) {
+  const query = includeArchived ? "?include_archived=true" : "";
+  return request(creds, "GET", `/api/v1/backlog/fields${query}`);
+}
+function createBacklogField(creds, body5) {
+  return request(creds, "POST", "/api/v1/backlog/fields", body5);
+}
+function updateBacklogField(creds, id, body5) {
+  return request(
+    creds,
+    "PATCH",
+    `/api/v1/backlog/fields/${encodeURIComponent(id)}`,
+    body5
+  );
+}
+function archiveBacklogField(creds, id) {
+  return request(
+    creds,
+    "DELETE",
+    `/api/v1/backlog/fields/${encodeURIComponent(id)}`
+  );
+}
 var listShops = (c) => userRequest(c, "GET", "/api/v1/shops");
 var getShop = (c, id) => userRequest(c, "GET", `/api/v1/shops/${id}`);
 var createShop = (c, body5) => userRequest(c, "POST", "/api/v1/shops", body5);
@@ -8835,6 +8895,43 @@ var import_node_crypto4 = __toESM(require("node:crypto"));
 var import_node_fs7 = __toESM(require("node:fs"));
 var import_node_path5 = __toESM(require("node:path"));
 
+// src/lib/qa-vocabulary.ts
+var checklistStatuses = [
+  "pending",
+  "pass",
+  "warning",
+  "fail",
+  "accepted",
+  "skipped"
+];
+var evidenceStatuses = [
+  "captured",
+  "passed",
+  "warning",
+  "failed",
+  "pending",
+  "not_run"
+];
+var evidenceKinds = [
+  "screenshot",
+  "goal",
+  "summary",
+  "launch_capture",
+  "selector_audit",
+  "console_network",
+  "qa_audit",
+  "readiness"
+];
+
+// src/lib/dashboard-url.ts
+function buildDashboardUrl(baseUrl, shopId, experimentId) {
+  if (!shopId) return null;
+  const url = new URL("/api/shops/switch", baseUrl);
+  url.searchParams.set("shopId", shopId);
+  url.searchParams.set("redirect", "/experiments/" + experimentId);
+  return url.toString();
+}
+
 // ../api-client/src/qa-preview-url.ts
 var FORCE_ALIAS_PARAM_NAMES = ["drip_experiment_id", "drip_experiment", "drip_variation_id", "drip_variation"];
 function applyQaPreviewParams(url, params) {
@@ -8872,6 +8969,112 @@ function buildQaPreviewUrl2(storeUrl, experimentId, variationId) {
   return url;
 }
 
+// src/lib/test-key.ts
+var TEST_KEY_RE = /^([A-Z0-9]{2,8})-(\d+)$/;
+function isTestKeyReference(value) {
+  return value === value.toUpperCase() && TEST_KEY_RE.test(value.toUpperCase());
+}
+
+// src/lib/effective-page-targeting.ts
+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 arrayOf(value) {
+  if (Array.isArray(value)) return value;
+  if (value === void 0 || value === null) return [];
+  return [value];
+}
+function ruleKey(rule) {
+  if (typeof rule === "string") return JSON.stringify(["include", "simple", rule.trim(), ""]);
+  if (!isRecord(rule)) return "";
+  const candidate = rule;
+  return JSON.stringify([
+    candidate.include === false ? "exclude" : "include",
+    candidate.type ?? "simple",
+    typeof candidate.pattern === "string" ? candidate.pattern : "",
+    candidate.matchType ?? candidate.match_type ?? ""
+  ]);
+}
+function authoredUrlRules(raw) {
+  if (Array.isArray(raw.authorUrl)) return raw.authorUrl;
+  const url = [...arrayOf(raw.url), ...arrayOf(raw.urls), ...arrayOf(raw.rules)];
+  if (url.length === 0) return [];
+  const derived = /* @__PURE__ */ new Set();
+  for (const candidate of arrayOf(raw.pageRules)) {
+    if (!isRecord(candidate)) continue;
+    for (const rule of [...arrayOf(candidate.includeRules), ...arrayOf(candidate.excludeRules)]) {
+      derived.add(ruleKey(rule));
+    }
+  }
+  return url.filter((rule) => !derived.has(ruleKey(rule)));
+}
+function pageEntries(raw) {
+  const byId = /* @__PURE__ */ new Map();
+  for (const candidate of arrayOf(raw.pageRules)) {
+    if (!isRecord(candidate) || typeof candidate.id !== "string" || !candidate.id) continue;
+    byId.set(candidate.id, {
+      name: typeof candidate.name === "string" && candidate.name.trim() ? candidate.name.trim() : null,
+      include: candidate.include !== false
+    });
+  }
+  for (const candidate of arrayOf(raw.pages)) {
+    const id = typeof candidate === "string" ? candidate : isRecord(candidate) && typeof candidate.id === "string" ? candidate.id : "";
+    if (!id) continue;
+    byId.set(id, {
+      name: byId.get(id)?.name ?? null,
+      include: isRecord(candidate) && candidate.include === false ? false : true
+    });
+  }
+  return [...byId.values()];
+}
+function urlRuleClause(count) {
+  return count === 1 ? "1 URL rule" : `${count} URL rules`;
+}
+function effectivePageTargetingLabel(targeting) {
+  const raw = isRecord(targeting) ? targeting : {};
+  if (raw.surface === "checkout" || isRecord(raw.checkoutBlock) && raw.checkoutBlock.enabled === true) {
+    return CHECKOUT_LABEL;
+  }
+  const pages = pageEntries(raw);
+  const rules = authoredUrlRules(raw);
+  const pagesLabel = pages.map((page) => {
+    const readable = page.name ?? UNKNOWN_PAGE_NAME;
+    return page.include ? readable : `Exclude ${readable}`;
+  }).join(", ");
+  if (pages.length && rules.length) return `${pagesLabel} and ${urlRuleClause(rules.length)}`;
+  if (pages.length) return pagesLabel;
+  if (rules.length) return `${urlRuleClause(rules.length)} (no saved Page)`;
+  return ALL_PAGES_LABEL;
+}
+
+// ../api-client/src/idea-reference.ts
+var IDEA_UUID = /^[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 IDEA_KEY = /^[A-Za-z0-9]{2,8}-\d+$/;
+function classifyIdeaReference(reference) {
+  const trimmed = reference.trim();
+  if (IDEA_UUID.test(trimmed)) return { kind: "uuid", value: trimmed };
+  if (IDEA_KEY.test(trimmed))
+    return { kind: "key", value: trimmed.toUpperCase() };
+  return { kind: "invalid", value: trimmed };
+}
+
+// ../api-client/src/experiment-create.ts
+function deriveStoreUrl(patterns) {
+  for (const pattern of patterns) {
+    const trimmed = pattern.trim();
+    if (trimmed.includes("*")) continue;
+    try {
+      const url = new URL(trimmed);
+      if (url.protocol === "http:" || url.protocol === "https:") return trimmed;
+    } catch {
+    }
+  }
+  return null;
+}
+
 // src/lib/asset-upload.ts
 var import_node_crypto3 = __toESM(require("node:crypto"));
 var import_node_fs6 = __toESM(require("node:fs"));
@@ -8951,6 +9154,7 @@ function createAssetReferenceRewriter(options) {
     let pending = uploadsByHash.get(hash);
     if (!pending) {
       pending = options.upload(file).then((asset) => {
+        if (asset === null) return null;
         if (!asset.id) throw new Error(`Asset upload for ${file.name} returned no ID.`);
         const url = deliveryUrl(options.baseUrl, asset);
         options.onUpload?.({ name: file.name, url, source });
@@ -8979,7 +9183,7 @@ function createAssetReferenceRewriter(options) {
       const hash = contentHash(bytes);
       const name = `inline-${hash.slice(0, 12)}${extensionForMimeType(mimeType)}`;
       const url = await uploadOnce({ name, bytes, type: mimeType }, "inline");
-      rewritten = rewritten.split(uri).join(url);
+      if (url !== null) rewritten = rewritten.split(uri).join(url);
     }
     const localAssetUrl = async (reference) => {
       if (reference.startsWith("/") || reference.startsWith("data:") || reference.includes("://")) {
@@ -9066,14 +9270,24 @@ function formatDate(iso) {
     year: "numeric"
   });
 }
-function printExperiment(exp) {
+function printExperiment(exp, dashboardUrl = null) {
   console.log();
   console.log(source_default.bold(exp.name));
+  if (dashboardUrl) console.log(`  Dashboard: ${dashboardUrl}`);
   console.log(`  ID:      ${source_default.dim(exp.id)}`);
   if (exp.slug) console.log(`  Slug:    ${source_default.cyan(exp.slug)}`);
   console.log(`  Status:  ${statusBadge(exp.status)}`);
+  console.log(`  Classification: ${exp.counting_type}`);
   console.log(`  Traffic: ${(exp.traffic_allocation * 100).toFixed(0)}%`);
+  if (exp.targeting !== void 0) {
+    console.log(`  Targeting: ${effectivePageTargetingLabel(exp.targeting)}`);
+  }
   console.log(`  Created: ${formatDate(exp.created_at)}`);
+  if (exp.linked_idea) {
+    const label = exp.linked_idea.key ? `${exp.linked_idea.key}: ` : "";
+    const stage = exp.linked_idea.stage ? ` (${exp.linked_idea.stage})` : "";
+    console.log(`  Idea:    ${label}${exp.linked_idea.title}${stage}`);
+  }
   if (exp.variations && exp.variations.length > 0) {
     console.log(`  Variations:`);
     for (const v of exp.variations) {
@@ -9122,6 +9336,21 @@ function printExperimentResults(results2, currency) {
   console.log(`  Conversions: ${String(totals.primaryConversions ?? 0)}`);
   console.log(`  Revenue:     ${formatRevenue(totals.revenue, currency)}`);
   console.log(`  Outcome:     ${statisticsStateLabel(presentedOutcome)}${outcomeProvenance}`);
+  const resultsWeekdays = results2.results_weekdays;
+  if (resultsWeekdays && Array.isArray(resultsWeekdays.days)) {
+    const labels = {
+      monday: "Mon",
+      tuesday: "Tue",
+      wednesday: "Wed",
+      thursday: "Thu",
+      friday: "Fri",
+      saturday: "Sat",
+      sunday: "Sun"
+    };
+    console.log(
+      `  Judged on:   ${resultsWeekdays.days.map((day) => labels[String(day)] ?? day).join(", ")} (${String(resultsWeekdays.timezone)})`
+    );
+  }
   console.log(`  Statistics:  ${statisticsStateLabel(statisticsState)}`);
   if (decision.treatmentName) {
     console.log(`  Treatment:   ${String(decision.treatmentName)}`);
@@ -9275,21 +9504,26 @@ async function rewriteExperimentFilesystemAssets(input) {
     baseUrl: input.baseUrl,
     enabled: input.enabled,
     upload: async (file) => {
+      const hash = import_node_crypto4.default.createHash("sha256").update(file.bytes).digest("hex");
+      const cached = input.assets[hash];
+      if (cached) return cached;
+      if (input.upload === null) return null;
       const response = await input.upload(input.credentials, [file]);
       const asset = response.data?.assets?.[0];
       if (!response.ok || !asset?.id) {
         throw new Error(response.error ?? `Failed to upload ${file.name}.`);
       }
-      return {
+      const uploaded = {
         id: asset.id,
-        url: typeof asset.url === "string" ? asset.url : void 0,
-        deliveryUrl: typeof asset.deliveryUrl === "string" ? asset.deliveryUrl : void 0,
-        delivery_url: typeof asset.delivery_url === "string" ? asset.delivery_url : void 0
+        url: typeof asset.url === "string" ? asset.url : `${new URL(input.baseUrl).origin}/api/assets/${encodeURIComponent(asset.id)}/file`,
+        deliveryUrl: typeof asset.deliveryUrl === "string" ? asset.deliveryUrl : typeof asset.delivery_url === "string" ? asset.delivery_url : void 0
       };
-    },
-    onUpload: ({ name, url }) => {
-      process.stderr.write(`Uploaded asset ${name} -> ${url}
-`);
+      input.assets[hash] = uploaded;
+      process.stderr.write(
+        `Uploaded asset ${file.name} -> ${uploaded.deliveryUrl ?? uploaded.url}
+`
+      );
+      return uploaded;
     }
   });
   return Promise.all(
@@ -9335,6 +9569,7 @@ function printFilesystemPlan(plan) {
   }
   console.log();
   console.log(`QA invalidated: ${plan.invalidatesQa ? source_default.yellow("yes") : "no"}`);
+  console.log(`Acknowledgment: ${plan.invalidatesQa ? "--accept-qa-invalidation" : "none"}`);
   console.log(`Precompile:     ${plan.precompileRequired ? "yes" : "no"}`);
 }
 function blockingIssueSummary(issues) {
@@ -9343,11 +9578,21 @@ function blockingIssueSummary(issues) {
   return `Experiment filesystem plan has errors. ${issues[0].message}${remaining ? ` and ${remaining} more` : ""}`;
 }
 async function getQaPreviewUrls(creds, experimentId) {
+  const fallbackDashboardUrl = buildDashboardUrl(
+    creds.baseUrl,
+    creds.resolvedContext?.shopId,
+    experimentId
+  );
   try {
     const res = await getExperiment(creds, experimentId);
+    const dashboardUrl = buildDashboardUrl(
+      creds.baseUrl,
+      res.data?.shop_id ?? creds.resolvedContext?.shopId,
+      experimentId
+    );
     const storeUrl = res.data?.store_url;
     if (!res.ok || !res.data || !storeUrl) {
-      return { previewUrls: [], unavailable: true };
+      return { previewUrls: [], unavailable: true, dashboardUrl };
     }
     const experiment = res.data;
     const previewUrls = (experiment.variations ?? []).filter((variation) => !variation.is_control).map((variation) => ({
@@ -9355,9 +9600,9 @@ async function getQaPreviewUrls(creds, experimentId) {
       variationName: variation.name,
       url: buildQaPreviewUrl2(storeUrl, experiment.id, variation.id).toString()
     }));
-    return { previewUrls, unavailable: false };
+    return { previewUrls, unavailable: false, dashboardUrl };
   } catch {
-    return { previewUrls: [], unavailable: true };
+    return { previewUrls: [], unavailable: true, dashboardUrl: fallbackDashboardUrl };
   }
 }
 function printQaPreviewUrls(experimentId, result) {
@@ -9430,8 +9675,29 @@ function parseEvidenceInput(value) {
   }
   return parsed;
 }
-function isQaCheckStatus(value) {
-  return value === "pending" || value === "pass" || value === "warning" || value === "fail" || value === "accepted" || value === "skipped";
+function qaChoice(flags, description, choices) {
+  return new Option(flags, description).choices([...choices]).argParser((value) => value);
+}
+function validateQaChoice(command, option, value, allowed2) {
+  if (value !== void 0 && !allowed2.includes(value)) {
+    fail(command, `Invalid ${option}: ${value}`, EXIT_CODES.validation, {
+      option,
+      allowedValues: [...allowed2]
+    });
+  }
+}
+function qaSummary(run3, changed) {
+  return {
+    run: {
+      id: run3.id,
+      status: run3.status,
+      summary: run3.summary,
+      approvedAt: run3.approvedAt,
+      updatedAt: run3.updatedAt
+    },
+    changed,
+    validationErrors: []
+  };
 }
 function tryReadFilesystemSession(folder) {
   try {
@@ -9455,13 +9721,15 @@ async function resolveExperimentForFilesystemOrId(value) {
   return { experimentId: exp.id, folder: null, label: exp.name };
 }
 async function refreshExperimentFilesystemFolderIfNeeded(creds, folder, experimentId) {
-  if (!folder) return;
+  if (!folder) return false;
   try {
     const refreshed = await getExperimentFilesystem(creds, experimentId);
     if (refreshed.ok && refreshed.data) {
+      const assets = tryReadFilesystemSession(folder)?.assets;
       writeExperimentFilesystemFiles(folder, refreshed.data.files);
       writeFilesystemSession(folder, {
         schemaVersion: 1,
+        ...assets ? { assets } : {},
         baseUrl: creds.baseUrl,
         experimentId,
         pulledAt: (/* @__PURE__ */ new Date()).toISOString(),
@@ -9469,11 +9737,13 @@ async function refreshExperimentFilesystemFolderIfNeeded(creds, folder, experime
           refreshed.data.files.map((file) => [file.path, { sha256: file.sha256 }])
         )
       });
+      return true;
     }
   } catch {
   }
+  return false;
 }
-async function refreshServerOwnedFilesIfNeeded(creds, folder, experimentId) {
+async function refreshServerOwnedFilesIfNeeded(creds, folder, experimentId, updateManifest = true) {
   if (!folder) return;
   try {
     const refreshed = await getExperimentFilesystem(creds, experimentId);
@@ -9484,23 +9754,25 @@ async function refreshServerOwnedFilesIfNeeded(creds, folder, experimentId) {
     if (serverOwned.length === 0) return;
     const session = readFilesystemSession(folder);
     writeExperimentFilesystemFiles(folder, serverOwned);
-    writeFilesystemSession(folder, {
-      ...session,
-      files: {
-        ...session.files,
-        ...Object.fromEntries(serverOwned.map((file) => [file.path, { sha256: file.sha256 }]))
-      }
-    });
+    if (updateManifest)
+      writeFilesystemSession(folder, {
+        ...session,
+        files: {
+          ...session.files,
+          ...Object.fromEntries(serverOwned.map((file) => [file.path, { sha256: file.sha256 }]))
+        }
+      });
   } catch {
   }
 }
+var EXPERIMENT_REFERENCE_DESCRIPTION = "Experiment ID, slug, or test key (for example BIO-085)";
 async function resolveExperiment(idOrSlug) {
   const creds = requireCredentials();
-  if (/^[0-9a-f-]{36}$/i.test(idOrSlug)) {
+  if (/^[0-9a-f-]{36}$/i.test(idOrSlug) || /^[1-9][0-9]{9}$/.test(idOrSlug) || isTestKeyReference(idOrSlug)) {
     const res2 = await getExperiment(creds, idOrSlug);
     if (res2.ok) return res2.data;
     throw new CliError(
-      res2.error ?? `Experiment "${idOrSlug}" not found`,
+      res2.status === 404 && isTestKeyReference(idOrSlug) ? `Experiment "${idOrSlug}" not found in selected shop ${creds.resolvedContext?.shopId ?? "(API key shop)"}. Test keys resolve within the selected shop; use --shop <shop-id> to change it.` : res2.error ?? `Experiment "${idOrSlug}" not found`,
       classifyStatus(res2.status),
       res2.errorDetails
     );
@@ -9554,16 +9826,59 @@ var list = new Command("list").alias("ls").description("List experiments (archiv
     }
   });
 });
-var get = new Command("get").description("Get experiment details by ID or slug").argument("<id-or-slug>", "Experiment ID or slug").action(async function action4(idOrSlug) {
+var get = new Command("get").description("Get experiment details by ID or slug").argument("<id-or-slug>", EXPERIMENT_REFERENCE_DESCRIPTION).action(async function action4(idOrSlug) {
   const spinner = await createSpinner("Fetching experiment...");
   const exp = await resolveExperiment(idOrSlug);
   spinner?.stop();
   if (!exp) {
     fail(this, `Experiment "${idOrSlug}" not found.`, EXIT_CODES.validation);
   }
-  output(this, { experiment: exp }, () => printExperiment(exp));
+  const creds = requireCredentials();
+  const dashboardUrl = buildDashboardUrl(
+    creds.baseUrl,
+    exp.shop_id ?? creds.resolvedContext?.shopId,
+    exp.id
+  );
+  output(
+    this,
+    { experiment: exp, dashboard_url: dashboardUrl },
+    () => printExperiment(exp, dashboardUrl)
+  );
 });
-var results = new Command("results").description("Read experiment results and timeseries by ID or slug").argument("<id-or-slug>", "Experiment ID or slug").option("--currency <code>", "Currency code for revenue formatting").action(async function action5(idOrSlug, opts) {
+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) {
+  const experiment = await resolveExperiment(experimentRef);
+  if (!experiment) fail(this, `Experiment "${experimentRef}" not found.`, EXIT_CODES.validation);
+  const classified = classifyIdeaReference(opts.idea);
+  if (classified.kind === "invalid") {
+    fail(this, "--idea must be a UUID or Apex backlog key", EXIT_CODES.validation);
+  }
+  const res = await attachExperimentIdea(requireCredentials(), experiment.id, {
+    ...classified.kind === "uuid" ? { backlog_item_id: classified.value } : { idea_key: classified.value },
+    ...opts.followUp ? { as_follow_up: true } : {}
+  });
+  if (!res.ok)
+    fail(
+      this,
+      res.error ?? "Failed to attach idea",
+      classifyStatus(res.status),
+      res.errorDetails
+    );
+  output(this, res.data, () => printSuccess("Idea attached."));
+});
+var detachIdea = new Command("detach-idea").description("Detach an experiment from its idea").argument("<experiment>", EXPERIMENT_REFERENCE_DESCRIPTION).action(async function action6(experimentRef) {
+  const experiment = await resolveExperiment(experimentRef);
+  if (!experiment) fail(this, `Experiment "${experimentRef}" not found.`, EXIT_CODES.validation);
+  const res = await detachExperimentIdea(requireCredentials(), experiment.id);
+  if (!res.ok)
+    fail(
+      this,
+      res.error ?? "Failed to detach idea",
+      classifyStatus(res.status),
+      res.errorDetails
+    );
+  output(this, res.data, () => printSuccess("Idea detached."));
+});
+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").action(async function action7(idOrSlug, opts) {
   const creds = requireCredentials();
   const spinner = await createSpinner("Fetching experiment results...");
   try {
@@ -9594,6 +9909,62 @@ var results = new Command("results").description("Read experiment results and ti
     fail(this, error instanceof Error ? error.message : String(error));
   }
 });
+var DAY_NAMES = {
+  mon: "monday",
+  monday: "monday",
+  tue: "tuesday",
+  tuesday: "tuesday",
+  wed: "wednesday",
+  wednesday: "wednesday",
+  thu: "thursday",
+  thursday: "thursday",
+  fri: "friday",
+  friday: "friday",
+  sat: "saturday",
+  saturday: "saturday",
+  sun: "sunday",
+  sunday: "sunday"
+};
+var countingTypes = ["standard", "setup_test", "aa_test", "non_program"];
+var update = new Command("update").description("Update an experiment").addOption(
+  new Option("--counting-type <type>", "Draft experiment classification").choices(countingTypes)
+).argument("<id-or-slug>", EXPERIMENT_REFERENCE_DESCRIPTION).option("--results-weekdays <days>", "Comma-separated weekdays").option("--results-timezone <timezone>", "IANA timezone for the results window").option("--clear-results-weekdays", "Clear the results weekday window").action(async function action8(reference, opts) {
+  if (opts.clearResultsWeekdays && (opts.resultsWeekdays || opts.resultsTimezone)) {
+    fail(
+      this,
+      "--clear-results-weekdays cannot be combined with window options",
+      EXIT_CODES.validation
+    );
+  }
+  const hasWindowOption = opts.resultsWeekdays !== void 0 || opts.resultsTimezone !== void 0;
+  if (!opts.clearResultsWeekdays && (!opts.countingType && !hasWindowOption || hasWindowOption && (!opts.resultsWeekdays || !opts.resultsTimezone))) {
+    fail(
+      this,
+      "--results-weekdays and --results-timezone are required together",
+      EXIT_CODES.validation
+    );
+  }
+  const days = opts.resultsWeekdays?.split(",").map((day) => DAY_NAMES[day.trim().toLowerCase()]);
+  if (days?.some((day) => !day)) fail(this, "Invalid weekday token", EXIT_CODES.validation);
+  const exp = await resolveExperiment(reference);
+  if (!exp) fail(this, `Experiment "${reference}" not found.`, EXIT_CODES.validation);
+  const results_weekdays = opts.clearResultsWeekdays ? null : { days, timezone: opts.resultsTimezone };
+  const hasWindow = opts.clearResultsWeekdays || opts.resultsWeekdays !== void 0;
+  const res = await updateExperiment(requireCredentials(), exp.id, {
+    ...hasWindow ? { results_weekdays } : {},
+    ...opts.countingType !== void 0 ? { counting_type: opts.countingType } : {}
+  });
+  if (!res.ok) fail(this, res.error ?? "Failed to update experiment", classifyStatus(res.status));
+  const stored = res.data?.results_weekdays ?? null;
+  output(this, res.data, () => {
+    if (opts.countingType !== void 0)
+      console.log(`Classification: ${res.data.counting_type}`);
+    if (hasWindow)
+      console.log(
+        stored?.days?.length ? `Judged on: ${stored.days.map((day) => day.slice(0, 3).replace(/^./, (c) => c.toUpperCase())).join(", ")} (${stored.timezone})` : "Results weekday window cleared: judged on all days."
+      );
+  });
+});
 function collectCreateOption(value, previous) {
   return [...previous, value];
 }
@@ -9610,30 +9981,238 @@ function parseHttpDestination(value) {
   }
   return trimmed;
 }
-function sourceStoreUrl(sourceRules) {
-  for (const rule of sourceRules) {
-    if (rule.includes("*")) continue;
-    try {
-      const url = new URL(rule);
-      if (url.protocol === "http:" || url.protocol === "https:") {
-        return rule;
-      }
-    } catch {
+function readCreateJson(command, reference) {
+  const file = reference.startsWith("@") ? reference.slice(1) : reference;
+  try {
+    const parsed = JSON.parse(import_node_fs7.default.readFileSync(import_node_path5.default.resolve(process.cwd(), file), "utf8"));
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
+      throw new Error("expected an object");
+    return parsed;
+  } catch (error) {
+    fail(
+      command,
+      `Invalid audience JSON ${reference}: ${error instanceof Error ? error.message : String(error)}`,
+      EXIT_CODES.validation
+    );
+  }
+}
+var GOAL_TYPES = ["click", "pageview", "custom", "revenue"];
+var GOAL_MEASUREMENTS = ["conversion", "value"];
+var GOAL_VALUE_UNITS = ["currency", "number", "duration_seconds", "percent"];
+var INLINE_GOAL_FIELDS = [
+  "name",
+  "type",
+  "measurement",
+  "value_property",
+  "value_unit",
+  "selector",
+  "text_match",
+  "url_pattern",
+  "page_id",
+  "event_name",
+  "count_once"
+];
+var GOAL_UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+var GOAL_EVENT_NAME = /^[a-zA-Z0-9_.:-]{1,120}$/;
+var GOAL_VALUE_PROPERTY = /^[A-Za-z0-9_.-]{1,120}$/;
+function normalizeNewGoalKey(key) {
+  const normalized = key.trim().toLowerCase().replace(/-/g, "_");
+  return normalized === "page" ? "page_id" : normalized;
+}
+function validateNewGoal(command, value, body5) {
+  const invalid = (reason) => fail(command, `Invalid --goal "new:${value}"; ${reason}`, EXIT_CODES.validation);
+  const text = (field) => {
+    const raw = body5[field];
+    return typeof raw === "string" && raw.length > 0 ? raw : void 0;
+  };
+  for (const key of Object.keys(body5)) {
+    if (INLINE_GOAL_FIELDS.includes(key)) continue;
+    invalid(
+      key === "capture" || key === "filter" ? `${key} is not expressible inline; create the goal with \`apex goals create\` and pass its id` : `unknown field "${key}"; inline fields are ${INLINE_GOAL_FIELDS.join(", ")}`
+    );
+  }
+  const type = text("type");
+  const name = text("name");
+  if (!type || !name) invalid("type and name are required");
+  if (!GOAL_TYPES.includes(type)) invalid(`type must be one of ${GOAL_TYPES.join(", ")}`);
+  if (name.length > 255) invalid("name must be 255 characters or fewer");
+  const measurement = text("measurement") ?? "conversion";
+  if (!GOAL_MEASUREMENTS.includes(measurement))
+    invalid(`measurement must be one of ${GOAL_MEASUREMENTS.join(", ")}`);
+  if (body5.count_once !== void 0) {
+    const flag = String(body5.count_once).toLowerCase();
+    if (flag !== "true" && flag !== "false") invalid("count-once must be true or false");
+    body5.count_once = flag === "true";
+  }
+  if (type === "click" && !text("selector") && !text("text_match"))
+    invalid("click goals need selector=<css> or text-match=<text>");
+  if (type === "pageview" && !text("page_id") && !text("url_pattern"))
+    invalid("pageview goals need page=<page-id> or url-pattern=<pattern>");
+  if (type === "custom" && !text("event_name")) invalid("custom goals need event-name=<name>");
+  const eventName = text("event_name");
+  if (eventName && !GOAL_EVENT_NAME.test(eventName))
+    invalid("event-name must be 1-120 letters, numbers, dots, colons, underscores, or hyphens");
+  if ((type === "custom" || type === "revenue") && text("page_id"))
+    invalid(`page is not supported for ${type} goals`);
+  const pageId = text("page_id");
+  if (pageId && !GOAL_UUID.test(pageId))
+    invalid("page must be a page UUID (list them with `apex pages list`)");
+  const valueProperty = text("value_property");
+  const valueUnit = text("value_unit");
+  if (measurement !== "value" && (valueProperty || valueUnit))
+    invalid("value-property and value-unit need measurement=value");
+  if (type === "revenue" && valueProperty)
+    invalid("revenue goals read the order revenue; value-property is not supported");
+  if (valueProperty && !GOAL_VALUE_PROPERTY.test(valueProperty))
+    invalid("value-property must be 1-120 letters, numbers, dots, underscores, or hyphens");
+  if (valueUnit && !GOAL_VALUE_UNITS.includes(valueUnit))
+    invalid(`value-unit must be one of ${GOAL_VALUE_UNITS.join(", ")}`);
+}
+function parseNewGoal(command, value) {
+  const body5 = {};
+  for (const field of value.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>`,
+        EXIT_CODES.validation
+      );
     }
+    body5[normalizeNewGoalKey(field.slice(0, separator))] = field.slice(separator + 1).trim();
   }
-  return null;
+  validateNewGoal(command, value, body5);
+  return body5;
 }
-var create = new Command("create").description("Create a new experiment").requiredOption("--name <name>", "Experiment name").option("--slug <slug>", "URL-safe slug for GitOps").option("--description <desc>", "Description").option("--type <type>", "Experiment type: mutation or redirect", "mutation").option(
+async function resolveNewGoalPages(command, creds, goals, interactive) {
+  const pending = goals.filter((goal) => goal.body.type === "click" && !goal.body.page_id);
+  if (pending.length === 0) return;
+  if (!interactive) {
+    fail(
+      command,
+      `Invalid --goal "${pending[0].flagValue}"; click goals are page-scoped in v1 \u2014 add page=<page-id> (see \`apex pages list\`)`,
+      EXIT_CODES.validation
+    );
+  }
+  const listed = await requestTargetingResource(creds, "GET", "pages", void 0, void 0, 100);
+  if (!listed.ok || !listed.data)
+    fail(command, listed.error ?? "Failed to list pages", classifyStatus(listed.status));
+  const rows = listed.data.data;
+  if (rows.length === 0)
+    fail(
+      command,
+      "Click goals are page-scoped in v1 and this shop has no pages yet; create one with `apex pages create`.",
+      EXIT_CODES.validation
+    );
+  printChoices("Pages (enter id/number)", rows);
+  for (const goal of pending) {
+    const answer = await askCreate(`Page for click goal "${String(goal.body.name)}": `);
+    if (!answer)
+      fail(
+        command,
+        `Invalid --goal "${goal.flagValue}"; click goals need a page`,
+        EXIT_CODES.validation
+      );
+    const chosen = /^\d+$/.test(answer) && rows[Number(answer) - 1] ? rows[Number(answer) - 1].id : answer;
+    if (!GOAL_UUID.test(chosen))
+      fail(
+        command,
+        `Invalid page "${chosen}"; pick a listed number or a page UUID`,
+        EXIT_CODES.validation
+      );
+    goal.body.page_id = chosen;
+  }
+}
+async function askCreate(question) {
+  const readline3 = await import("node:readline");
+  const rl = readline3.createInterface({ input: process.stdin, output: process.stderr });
+  return new Promise(
+    (resolve2) => rl.question(question, (answer) => {
+      rl.close();
+      resolve2(answer.trim());
+    })
+  );
+}
+function printChoices(kind5, rows) {
+  process.stderr.write(
+    `${kind5}:
+${rows.map((row, index) => `  ${index + 1}. ${row.name} (${row.id})`).join("\n")}
+`
+  );
+}
+var create = new Command("create").description("Create a new experiment").addOption(
+  new Option("--counting-type <type>", "Experiment classification").choices(countingTypes).default("standard")
+).option("--name <name>", "Experiment name").option("--slug <slug>", "URL-safe slug for GitOps").option("--description <desc>", "Description").option("--type <type>", "Experiment type: mutation or redirect", "mutation").option(
   "--source-url <pattern>",
   "Positive source URL rule (repeatable; accepts exact URLs, paths, or wildcards)",
   collectCreateOption,
   []
+).option(
+  "--page-url <pattern>",
+  "Page URL targeting pattern (repeatable)",
+  collectCreateOption,
+  []
+).option(
+  "--audience <segment-id|new:@file.json>",
+  "Audience segment (repeatable)",
+  collectCreateOption,
+  []
+).option(
+  "--goal <goal-id|new:fields>",
+  "Goal id or new:type=...,selector=...,name=... (repeatable)",
+  collectCreateOption,
+  []
 ).option(
   "--destination <url>",
   "Redirect treatment destination (repeatable; creates one treatment per URL)",
   collectCreateOption,
   []
-).option("--traffic <pct>", "Traffic allocation (0-100)", "100").option("--backlog-item <id>", "Backlog item UUID or Apex backlog key").action(async function action6(opts) {
+).option("--traffic <pct>", "Traffic allocation (0-100)", "100").option("--idea <id>", "Idea UUID or Apex backlog key").option("--backlog-item <id>", "Alias for --idea").option("--preview", "Print a QA preview URL for the first treatment").option("--yes", "Do not prompt for missing values").action(async function action9(opts) {
+  const interactive = Boolean(process.stdin.isTTY && process.stdout.isTTY && !opts.yes);
+  if (!opts.name && interactive) opts.name = await askCreate("Experiment name: ");
+  if (!opts.name?.trim()) fail(this, "Missing required value: --name", EXIT_CODES.validation);
+  if (opts.pageUrl.length === 0 && opts.sourceUrl.length === 0 && interactive) {
+    const answer = await askCreate("Page URL (--page-url): ");
+    if (answer) opts.pageUrl.push(answer);
+  }
+  const creds = requireCredentials();
+  if (opts.audience.length === 0 && interactive) {
+    const listed = await requestTargetingResource(
+      creds,
+      "GET",
+      "segments",
+      void 0,
+      void 0,
+      100
+    );
+    if (!listed.ok || !listed.data)
+      fail(this, listed.error ?? "Failed to list segments", classifyStatus(listed.status));
+    const rows = listed.data.data;
+    printChoices("Audiences (enter id/number, or none)", rows);
+    const answer = await askCreate("Audience: ");
+    if (answer && answer.toLowerCase() !== "none")
+      opts.audience.push(
+        /^\d+$/.test(answer) && rows[Number(answer) - 1] ? rows[Number(answer) - 1].id : answer
+      );
+  }
+  if (opts.goal.length === 0 && interactive) {
+    const listed = await listGoals(creds, { limit: 100 });
+    if (!listed.ok || !listed.data)
+      fail(this, listed.error ?? "Failed to list goals", classifyStatus(listed.status));
+    const rows = listed.data.data;
+    printChoices("Goals (enter ids/numbers separated by commas, or none)", rows);
+    const answer = await askCreate("Goals: ");
+    if (answer && answer.toLowerCase() !== "none")
+      opts.goal.push(
+        ...answer.split(",").map((part) => part.trim()).filter(Boolean).map(
+          (part) => /^\d+$/.test(part) && rows[Number(part) - 1] ? rows[Number(part) - 1].id : part
+        )
+      );
+  }
+  if (this.getOptionValueSource("traffic") === "default" && interactive) {
+    const answer = await askCreate("Traffic percentage [100]: ");
+    if (answer) opts.traffic = answer;
+  }
   if (opts.type !== "mutation" && opts.type !== "redirect") {
     fail(this, "--type must be mutation or redirect", EXIT_CODES.validation);
   }
@@ -9641,9 +10220,9 @@ var create = new Command("create").description("Create a new experiment").requir
   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.map((value) => value.trim());
+  const sourceRules = [...opts.sourceUrl, ...opts.pageUrl].map((value) => value.trim());
   if (sourceRules.some((value) => value.length === 0)) {
-    fail(this, "--source-url cannot be empty", EXIT_CODES.validation);
+    fail(this, "--source-url/--page-url cannot be empty", EXIT_CODES.validation);
   }
   if (opts.type !== "redirect" && opts.destination.length > 0) {
     fail(this, "--destination is only valid with --type redirect", EXIT_CODES.validation);
@@ -9663,94 +10242,180 @@ var create = new Command("create").description("Create a new experiment").requir
     );
   }
   const destinations = opts.destination.map(parseHttpDestination);
+  const previewStoreUrl = deriveStoreUrl(sourceRules);
+  if (opts.preview && !previewStoreUrl) {
+    fail(
+      this,
+      "--preview needs an absolute page URL: pass --page-url https://store.example/path (wildcard and path-only rules cannot seed the preview link), or create the experiment without --preview and run `apex preview <id> --store-url <url>`",
+      EXIT_CODES.validation
+    );
+  }
   const armWeight = destinations.length > 0 ? 1 / (destinations.length + 1) : null;
-  const creds = requireCredentials();
   let backlogItemId;
-  if (opts.backlogItem !== void 0) {
-    const ref = opts.backlogItem.trim();
-    if (!ref) {
-      fail(this, "--backlog-item must be a UUID or Apex backlog key", EXIT_CODES.validation);
-    }
-    if (/^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(ref)) {
-      backlogItemId = ref;
-    } else if (/^[A-Za-z0-9]{2,8}-\d+$/i.test(ref)) {
-      let cursor;
-      let resolvedId;
-      do {
-        const page = await listInsights(creds, "backlog", 100, cursor);
-        if (!page.ok || !page.data) {
-          fail(
-            this,
-            page.error ?? `Unable to resolve backlog item "${ref}"`,
-            classifyStatus(page.status),
-            page.errorDetails
-          );
-        }
-        const match2 = page.data.data.find((item) => {
-          const metadata = item.metadata && typeof item.metadata === "object" && !Array.isArray(item.metadata) ? item.metadata : {};
-          return typeof metadata.backlog_key === "string" && metadata.backlog_key.toUpperCase() === ref.toUpperCase();
-        });
-        resolvedId = match2?.id;
-        cursor = page.data.pagination.has_more ? page.data.pagination.next_cursor ?? void 0 : void 0;
-      } while (!resolvedId && cursor);
-      const backlog = resolvedId ? { ok: true, status: 200, data: { id: resolvedId } } : await getInsight(creds, "backlog", ref);
-      if (!backlog.ok || !backlog.data?.id) {
-        fail(
-          this,
-          backlog.error ?? `Backlog item "${ref}" not found`,
-          classifyStatus(backlog.status),
-          backlog.errorDetails
-        );
-      }
-      if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(
-        backlog.data.id
-      )) {
-        fail(this, `Backlog item "${ref}" not found`, EXIT_CODES.validation);
-      }
-      backlogItemId = backlog.data.id;
+  let ideaKey;
+  if (opts.idea !== void 0 && opts.backlogItem !== void 0 && opts.idea.trim().toUpperCase() !== opts.backlogItem.trim().toUpperCase()) {
+    fail(
+      this,
+      "--idea and --backlog-item name the same idea; pass only one",
+      EXIT_CODES.validation
+    );
+  }
+  const ideaReference = opts.idea ?? opts.backlogItem;
+  if (ideaReference !== void 0) {
+    const classified = classifyIdeaReference(ideaReference);
+    if (classified.kind === "uuid") {
+      backlogItemId = classified.value;
+    } else if (classified.kind === "key") {
+      ideaKey = classified.value;
     } else {
-      fail(this, "--backlog-item must be a UUID or Apex backlog key", EXIT_CODES.validation);
+      fail(this, "--idea must be a UUID or Apex backlog key", EXIT_CODES.validation);
     }
   }
+  const newGoals = /* @__PURE__ */ new Map();
+  for (const [index, goal] of opts.goal.entries()) {
+    if (goal.startsWith("new:")) newGoals.set(index, parseNewGoal(this, goal.slice(4)));
+  }
+  await resolveNewGoalPages(
+    this,
+    creds,
+    [...newGoals].map(([index, body5]) => ({ flagValue: opts.goal[index], body: body5 })),
+    interactive
+  );
+  const createdSegments = [];
+  const createdGoals = [];
+  const segmentIds = [];
+  const goalIds = [];
+  const partial = () => [
+    ...createdSegments.map((item) => `segment ${item.id}`),
+    ...createdGoals.map((item) => `goal ${item.id}`)
+  ];
+  for (const audience of opts.audience) {
+    if (!audience.startsWith("new:")) {
+      segmentIds.push(audience);
+      continue;
+    }
+    const reference = audience.slice(4);
+    if (!reference.startsWith("@"))
+      fail(
+        this,
+        `Invalid --audience "${audience}"; new audiences use new:@file.json`,
+        EXIT_CODES.validation
+      );
+    const response = await requestTargetingResource(
+      creds,
+      "POST",
+      "segments",
+      void 0,
+      readCreateJson(this, reference)
+    );
+    if (!response.ok || !response.data)
+      fail(
+        this,
+        `${response.error ?? "Failed to create audience"}${partial().length ? `; already created: ${partial().join(", ")}` : ""}`,
+        classifyStatus(response.status)
+      );
+    const segment = response.data;
+    createdSegments.push(segment);
+    segmentIds.push(segment.id);
+  }
+  for (const [index, goal] of opts.goal.entries()) {
+    const body5 = newGoals.get(index);
+    if (!body5) {
+      goalIds.push(goal);
+      continue;
+    }
+    const response = await createGoal(creds, body5);
+    if (!response.ok || !response.data)
+      fail(
+        this,
+        `${response.error ?? "Failed to create goal"}${partial().length ? `; already created: ${partial().join(", ")}` : ""}`,
+        classifyStatus(response.status)
+      );
+    createdGoals.push(response.data);
+    goalIds.push(response.data.id);
+  }
   const spinner = await createSpinner("Creating experiment...");
-  const res = await createExperiment(creds, {
-    name: opts.name,
-    slug: opts.slug ?? null,
-    description: opts.description ?? null,
-    delivery_type: opts.type,
-    traffic_allocation: traffic / 100,
-    ...backlogItemId ? { backlog_item_id: backlogItemId } : {},
-    ...sourceRules.length > 0 ? {
-      store_url: sourceStoreUrl(sourceRules),
-      targeting: {
-        url: sourceRules.map((pattern) => ({
-          type: "simple",
-          pattern,
-          include: true
-        }))
-      }
-    } : {},
-    ...armWeight !== null ? {
-      variations: [
-        {
-          name: "Control",
-          weight: armWeight,
-          is_control: true
-        },
-        ...destinations.map((redirectUrl, index) => ({
-          name: destinations.length === 1 ? "Treatment" : `Treatment ${index + 1}`,
-          weight: armWeight,
-          is_control: false,
-          redirect_url: redirectUrl
-        }))
-      ]
-    } : {}
-  });
+  let res;
+  if (segmentIds.length === 0 && goalIds.length === 0) {
+    res = await createExperiment(creds, {
+      name: opts.name,
+      slug: opts.slug ?? null,
+      description: opts.description ?? null,
+      delivery_type: opts.type,
+      counting_type: opts.countingType,
+      traffic_allocation: traffic / 100,
+      ...backlogItemId ? { backlog_item_id: backlogItemId } : {},
+      ...ideaKey ? { idea_key: ideaKey } : {},
+      ...sourceRules.length > 0 ? {
+        store_url: previewStoreUrl,
+        targeting: {
+          url: sourceRules.map((pattern) => ({
+            type: "simple",
+            pattern,
+            include: true
+          }))
+        }
+      } : {},
+      ...armWeight !== null ? {
+        variations: [
+          {
+            name: "Control",
+            weight: armWeight,
+            is_control: true
+          },
+          ...destinations.map((redirectUrl, index) => ({
+            name: destinations.length === 1 ? "Treatment" : `Treatment ${index + 1}`,
+            weight: armWeight,
+            is_control: false,
+            redirect_url: redirectUrl
+          }))
+        ]
+      } : {}
+    });
+  } else {
+    res = await createExperiment(creds, {
+      name: opts.name,
+      slug: opts.slug ?? null,
+      description: opts.description ?? null,
+      delivery_type: opts.type,
+      counting_type: opts.countingType,
+      traffic_allocation: traffic / 100,
+      ...backlogItemId ? { backlog_item_id: backlogItemId } : {},
+      ...ideaKey ? { idea_key: ideaKey } : {},
+      ...sourceRules.length > 0 ? {
+        store_url: previewStoreUrl,
+        targeting: {
+          url: sourceRules.map((pattern) => ({
+            type: "simple",
+            pattern,
+            include: true
+          })),
+          ...segmentIds.length ? { segments: segmentIds.map((id) => ({ id, include: true })) } : {}
+        }
+      } : segmentIds.length ? { targeting: { segments: segmentIds.map((id) => ({ id, include: true })) } } : {},
+      ...goalIds.length ? { goal_ids: goalIds, primary_goal_id: goalIds[0] } : {},
+      ...armWeight !== null ? {
+        variations: [
+          {
+            name: "Control",
+            weight: armWeight,
+            is_control: true
+          },
+          ...destinations.map((redirectUrl, index) => ({
+            name: destinations.length === 1 ? "Treatment" : `Treatment ${index + 1}`,
+            weight: armWeight,
+            is_control: false,
+            redirect_url: redirectUrl
+          }))
+        ]
+      } : {}
+    });
+  }
   if (!res.ok || !res.data) {
     spinner?.fail("Failed to create experiment");
     fail(
       this,
-      res.error ?? "Failed to create experiment",
+      `${res.error ?? "Failed to create experiment"}${partial().length ? `; already created: ${partial().join(", ")}` : ""}`,
       classifyStatus(res.status),
       res.errorDetails
     );
@@ -9759,13 +10424,49 @@ var create = new Command("create").description("Create a new experiment").requir
   spinner?.succeed(
     outcome === "created" ? "Experiment created" : `Already linked \u2014 returning existing experiment ${res.data.test_key ?? res.data.slug ?? res.data.id}`
   );
+  let previewUrl = null;
+  let previewNote = null;
+  if (opts.preview) {
+    const variation = res.data.variations?.find((item) => !item.is_control);
+    const storeUrl = res.data.store_url ?? previewStoreUrl;
+    if (storeUrl && variation) {
+      previewUrl = buildQaPreviewUrl2(storeUrl, res.data.id, variation.id).toString();
+    } else {
+      previewNote = `No preview link: the experiment has no ${variation ? "store URL" : "treatment variation"} yet. Add one, then run \`apex preview ${res.data.id}\`.`;
+    }
+  }
   output(
     this,
-    { outcome, backlog_item_id: backlogItemId ?? null, experiment: res.data },
-    () => printExperiment(res.data)
+    {
+      outcome,
+      backlog_item_id: backlogItemId ?? null,
+      idea_key: ideaKey ?? null,
+      experiment: res.data,
+      segments: createdSegments,
+      goals: createdGoals,
+      dashboard_url: buildDashboardUrl(
+        creds.baseUrl,
+        res.data?.shop_id ?? creds.resolvedContext?.shopId,
+        res.data.id
+      ),
+      preview_url: previewUrl,
+      preview_note: previewNote
+    },
+    () => {
+      printExperiment(
+        res.data,
+        buildDashboardUrl(
+          creds.baseUrl,
+          res.data?.shop_id ?? creds.resolvedContext?.shopId,
+          res.data.id
+        )
+      );
+      if (previewUrl) console.log(`Preview: ${previewUrl}`);
+      if (previewNote) console.log(previewNote);
+    }
   );
 });
-var pause = new Command("pause").description("Pause a running experiment").argument("<id-or-slug>", "Experiment ID or slug").action(async function action7(idOrSlug) {
+var pause = new Command("pause").description("Pause a running experiment").argument("<id-or-slug>", EXPERIMENT_REFERENCE_DESCRIPTION).action(async function action10(idOrSlug) {
   const creds = requireCredentials();
   const spinner = await createSpinner("Pausing experiment...");
   const exp = await resolveExperiment(idOrSlug);
@@ -9787,7 +10488,7 @@ var pause = new Command("pause").description("Pause a running experiment").argum
     spinner.succeed(`Experiment "${exp.name}" is now ${statusBadge("paused")}`);
   });
 });
-var complete = new Command("complete").description("Complete/stop an experiment").argument("<id-or-slug>", "Experiment ID or slug").action(async function action8(idOrSlug) {
+var complete = new Command("complete").description("Complete/stop an experiment").argument("<id-or-slug>", EXPERIMENT_REFERENCE_DESCRIPTION).action(async function action11(idOrSlug) {
   const creds = requireCredentials();
   const spinner = await createSpinner("Completing experiment...");
   const exp = await resolveExperiment(idOrSlug);
@@ -9809,7 +10510,7 @@ var complete = new Command("complete").description("Complete/stop an experiment"
     spinner.succeed(`Experiment "${exp.name}" is now ${statusBadge("completed")}`);
   });
 });
-var del = new Command("delete").alias("rm").description("Delete an experiment").argument("<id-or-slug>", "Experiment ID or slug").option("-f, --force", "Skip confirmation").action(async function action9(idOrSlug, opts) {
+var del = new Command("delete").alias("rm").description("Delete an experiment").argument("<id-or-slug>", EXPERIMENT_REFERENCE_DESCRIPTION).option("-f, --force", "Skip confirmation").action(async function action12(idOrSlug, opts) {
   const creds = requireCredentials();
   const exp = await resolveExperiment(idOrSlug);
   if (!exp) {
@@ -9854,7 +10555,7 @@ var del = new Command("delete").alias("rm").description("Delete an experiment").
     () => spinner.succeed(`Experiment "${exp.name}" deleted.`)
   );
 });
-var pullFilesystem = new Command("pull").description("Pull an experiment as an editable filesystem").argument("<id-or-slug>", "Experiment ID or slug").option("--out <path>", "Target folder").action(async function action10(idOrSlug, opts) {
+var pullFilesystem = new Command("pull").description("Pull an experiment as an editable filesystem").argument("<id-or-slug>", EXPERIMENT_REFERENCE_DESCRIPTION).option("--out <path>", "Target folder").action(async function action13(idOrSlug, opts) {
   const creds = requireCredentials();
   const spinner = await createSpinner("Pulling experiment filesystem...");
   try {
@@ -9895,12 +10596,20 @@ var pullFilesystem = new Command("pull").description("Pull an experiment as an e
     throw error;
   }
 });
-var planFilesystem = new Command("plan").description("Plan experiment filesystem changes").argument("[folder]", "Experiment filesystem folder", ".").action(async function action11(folderArg) {
+var planFilesystem = new Command("plan").description("Plan experiment filesystem changes").argument("[folder]", "Experiment filesystem folder", ".").action(async function action14(folderArg) {
   const creds = requireCredentials();
   try {
     const folder = folderPath(folderArg);
     const session = readFilesystemSession(folder);
-    const files = listExperimentFilesystemFiles(folder, session);
+    const files = await rewriteExperimentFilesystemAssets({
+      files: listExperimentFilesystemFiles(folder, session),
+      folder,
+      baseUrl: creds.baseUrl,
+      enabled: true,
+      upload: null,
+      assets: session.assets ?? {},
+      credentials: creds
+    });
     const res = await planExperimentFilesystem(creds, session.experimentId, { files });
     if (!res.ok || !res.data) {
       fail(
@@ -9920,7 +10629,12 @@ var planFilesystem = new Command("plan").description("Plan experiment filesystem
     await refreshServerOwnedFilesIfNeeded(creds, folder, session.experimentId);
     output(
       this,
-      { folder, experimentId: session.experimentId, plan: res.data },
+      {
+        folder,
+        experimentId: session.experimentId,
+        plan: res.data,
+        requiredAcknowledgment: res.data.invalidatesQa ? "accept-qa-invalidation" : null
+      },
       () => printFilesystemPlan(res.data)
     );
   } catch (error) {
@@ -9928,19 +10642,27 @@ var planFilesystem = new Command("plan").description("Plan experiment filesystem
     fail(this, error instanceof Error ? error.message : String(error));
   }
 });
-var applyFilesystem = new Command("apply").description("Apply experiment filesystem changes to Apex").argument("[folder]", "Experiment filesystem folder", ".").option("-f, --force", "Skip confirmation when QA will be invalidated").option("--no-asset-upload", "Keep inline and local image references unchanged").action(async function action12(folderArg, opts) {
+var applyFilesystem = new Command("apply").option("--sync", "Refresh local authored files with the stored server bytes").description("Apply experiment filesystem changes to Apex").argument("[folder]", "Experiment filesystem folder", ".").option("--accept-qa-invalidation", "Acknowledge that applying changes invalidates QA approval").addOption(new Option("-f, --force", "Deprecated alias for --accept-qa-invalidation").hideHelp()).option("--no-asset-upload", "Keep inline and local image references unchanged").action(async function action15(folderArg, opts) {
   const creds = requireCredentials();
   try {
     const folder = folderPath(folderArg);
     const session = readFilesystemSession(folder);
+    if (opts.force)
+      process.stderr.write("--force is deprecated; use --accept-qa-invalidation instead.\n");
+    const assets = session.assets ?? {};
     const files = await rewriteExperimentFilesystemAssets({
       files: listExperimentFilesystemFiles(folder, session),
       folder,
       baseUrl: creds.baseUrl,
       enabled: opts.assetUpload !== false,
       upload: uploadAssets,
+      assets,
       credentials: creds
     });
+    if (Object.keys(assets).length > 0) {
+      session.assets = assets;
+      writeFilesystemSession(folder, session);
+    }
     const planRes = await planExperimentFilesystem(creds, session.experimentId, { files });
     if (!planRes.ok || !planRes.data) {
       fail(
@@ -9960,30 +10682,43 @@ var applyFilesystem = new Command("apply").description("Apply experiment filesys
       }
       fail(this, blockingIssueSummary(planRes.data.blockingIssues), EXIT_CODES.validation, {
         errors: planRes.data.errors,
-        plan: planRes.data
+        plan: planRes.data,
+        requiredAcknowledgment: planRes.data.invalidatesQa ? "accept-qa-invalidation" : null
       });
     }
     if (planRes.data.changes.length === 0) {
+      const synced2 = opts.sync ? await refreshExperimentFilesystemFolderIfNeeded(creds, folder, session.experimentId) : false;
+      if (!synced2)
+        await refreshServerOwnedFilesIfNeeded(creds, folder, session.experimentId, true);
+      const { dashboardUrl: dashboardUrl2 } = await getQaPreviewUrls(creds, session.experimentId);
       output(
         this,
         {
           folder,
           experimentId: session.experimentId,
           applied: false,
+          synced: synced2,
+          dashboardUrl: dashboardUrl2,
           plan: planRes.data,
+          requiredAcknowledgment: planRes.data.invalidatesQa ? "accept-qa-invalidation" : null,
           message: "No changes."
         },
-        () => printFilesystemPlan(planRes.data)
+        () => {
+          printFilesystemPlan(planRes.data);
+          console.log(
+            synced2 ? "Local files were synced." : opts.sync ? "Local file sync failed; retry --sync or apex experiments pull." : "Local authored files were left unchanged; use --sync or apex experiments pull to refresh."
+          );
+        }
       );
       return;
     }
-    if (planRes.data.invalidatesQa && !opts.force) {
+    if (planRes.data.invalidatesQa && !opts.force && !opts.acceptQaInvalidation) {
       const ok = await confirmApply("This apply invalidates QA approval. Continue?");
       if (ok === null) {
         confirmationRequired(
           this,
           "Applying these changes invalidates QA approval and requires confirmation.",
-          `apex experiments apply ${folderArg} --force`
+          `apex experiments apply ${folderArg} --accept-qa-invalidation`
         );
       }
       if (!ok) {
@@ -10001,9 +10736,29 @@ var applyFilesystem = new Command("apply").description("Apply experiment filesys
       });
     }
     spinner?.succeed("Applied experiment filesystem");
-    await refreshExperimentFilesystemFolderIfNeeded(creds, folder, session.experimentId);
+    const synced = opts.sync ? await refreshExperimentFilesystemFolderIfNeeded(creds, folder, session.experimentId) : false;
+    if (!synced) {
+      await refreshServerOwnedFilesIfNeeded(
+        creds,
+        folder,
+        session.experimentId,
+        !res.data?.receipt?.files
+      );
+      if (res.data?.receipt?.files) {
+        writeFilesystemSession(folder, {
+          ...session,
+          files: {
+            ...session.files,
+            ...Object.fromEntries(
+              res.data.receipt.files.map((file) => [file.path, { sha256: file.sha256 }])
+            )
+          }
+        });
+      }
+    }
+    const syncMessage = synced ? "Local files were synced." : opts.sync ? "Local file sync failed; retry --sync or apex experiments pull." : "Local authored files were left unchanged; use --sync or apex experiments pull to refresh." + (res.data?.receipt?.files ? "" : " No receipt file digests; authored-file manifest entries left unchanged.");
     const previewResult = await getQaPreviewUrls(creds, session.experimentId);
-    const { previewUrls } = previewResult;
+    const { previewUrls, dashboardUrl } = previewResult;
     output(
       this,
       {
@@ -10011,12 +10766,37 @@ var applyFilesystem = new Command("apply").description("Apply experiment filesys
         experimentId: session.experimentId,
         applied: true,
         plan: planRes.data,
+        requiredAcknowledgment: planRes.data.invalidatesQa ? "accept-qa-invalidation" : null,
         result: res.data,
+        synced,
+        dashboardUrl,
+        receipt: res.data?.receipt ?? null,
         previewUrls
       },
       () => {
         printFilesystemPlan(planRes.data);
+        const receipt = res.data?.receipt;
+        if (receipt) {
+          console.log("\nReceipt");
+          if (dashboardUrl) console.log(`  Dashboard: ${dashboardUrl}`);
+          console.log(`  Status: ${receipt.status}`);
+          console.log(`  Classification: ${receipt.delivery_type} / ${receipt.counting_type}`);
+          console.log(`  Traffic: ${(receipt.traffic_allocation * 100).toFixed(0)}%`);
+          console.log(
+            `  Schedule: ${receipt.schedule.scheduled_start_at ?? "none"} \u2192 ${receipt.schedule.scheduled_end_at ?? "none"}`
+          );
+          console.log(`  Goals: ${receipt.goal_count}`);
+          console.log(
+            `  QA: ${receipt.qa ? `${receipt.qa.status} (${receipt.qa.run_id}), approved: ${receipt.qa.approved_at ?? "none"}` : "none"}`
+          );
+          for (const variation of receipt.variations) {
+            console.log(
+              `  ${variation.name} (${variation.slug}): ${Object.entries(variation.digests).map(([key, value]) => `${key}=${value ?? "null"}`).join(" ")}`
+            );
+          }
+        }
         printQaPreviewUrls(session.experimentId, previewResult);
+        console.log(syncMessage);
       }
     );
   } catch (error) {
@@ -10024,7 +10804,11 @@ var applyFilesystem = new Command("apply").description("Apply experiment filesys
     fail(this, error instanceof Error ? error.message : String(error));
   }
 });
-var qaStatus = new Command("status").description("Show or create the latest experiment QA run").argument("[folder-or-id]", "Experiment filesystem folder, ID, or slug", ".").option("--json", "Print the QA run in the standard JSON envelope").action(async function action13(target) {
+var qaStatus = new Command("status").description("Show or create the latest experiment QA run").argument(
+  "[folder-or-id]",
+  "Experiment filesystem folder, ID, slug, or test key (for example BIO-085)",
+  "."
+).option("--json", "Print the QA run in the standard JSON envelope").action(async function action16(target) {
   const creds = requireCredentials();
   const spinner = await createSpinner("Fetching QA run...");
   try {
@@ -10048,15 +10832,17 @@ var qaStatus = new Command("status").description("Show or create the latest expe
     throw error;
   }
 });
-var qaCheck = new Command("check").description("Update one QA checklist item with status, notes, and evidence").argument("[folder-or-id]", "Experiment filesystem folder, ID, or slug", ".").requiredOption("--item <id>", "Checklist item id").requiredOption("--status <status>", "pending|pass|warning|fail|accepted|skipped").option("--notes <text>", "Checklist notes").option("--evidence <json-or-path>", "Evidence JSON object or @path/to/evidence.json").option("--json", "Print raw QA run JSON").action(async function action14(target, opts) {
+var qaCheck = new Command("check").description("Update one QA checklist item with status, notes, and evidence").argument(
+  "[folder-or-id]",
+  "Experiment filesystem folder, ID, slug, or test key (for example BIO-085)",
+  "."
+).requiredOption("--item <id>", "Checklist item id").addOption(
+  qaChoice("--status <status>", "Checklist status", checklistStatuses).makeOptionMandatory()
+).option("--notes <text>", "Checklist notes").option("--evidence <json-or-path>", "Evidence JSON object or @path/to/evidence.json").option("--summary", "Print a compact run and changed values").option("--json", "Print raw QA run JSON").action(async function action17(target, opts) {
+  validateQaChoice(this, "--status", opts.status, checklistStatuses);
   const creds = requireCredentials();
   const spinner = await createSpinner("Updating QA checklist...");
   try {
-    if (!isQaCheckStatus(opts.status)) {
-      throw new Error(
-        "Invalid QA status. Use pending, pass, warning, fail, accepted, or skipped."
-      );
-    }
     const evidence = parseEvidenceInput(opts.evidence);
     const resolved = await resolveExperimentForFilesystemOrId(target);
     const current = await getExperimentQaRun(creds, resolved.experimentId);
@@ -10082,16 +10868,23 @@ var qaCheck = new Command("check").description("Update one QA checklist item wit
       resolved.folder,
       resolved.experimentId
     );
-    output(this, { run: run3 }, () => {
+    const data = opts.summary ? qaSummary(run3, run3.checklist.find((item) => item.id === opts.item) ?? null) : { run: run3 };
+    output(this, data, () => {
       spinner.succeed("Updated QA checklist");
-      printQaRun(run3);
+      if (opts.summary) process.stdout.write(`${JSON.stringify(data, null, 2)}
+`);
+      else printQaRun(run3);
     });
   } catch (error) {
     spinner.fail("Failed to update QA checklist");
     throw error;
   }
 });
-var qaNotes = new Command("notes").description("Update QA run notes or acceptance criteria summary").argument("[folder-or-id]", "Experiment filesystem folder, ID, or slug", ".").option("--notes <text>", "QA run notes").option("--acceptance <text>", "Acceptance criteria summary").option("--json", "Print raw QA run JSON").action(async function action15(target, opts) {
+var qaNotes = new Command("notes").description("Update QA run notes or acceptance criteria summary").argument(
+  "[folder-or-id]",
+  "Experiment filesystem folder, ID, slug, or test key (for example BIO-085)",
+  "."
+).option("--notes <text>", "QA run notes").option("--acceptance <text>", "Acceptance criteria summary").option("--summary", "Print a compact run and changed values").option("--json", "Print raw QA run JSON").action(async function action18(target, opts) {
   const creds = requireCredentials();
   const spinner = await createSpinner("Updating QA notes...");
   try {
@@ -10103,9 +10896,10 @@ var qaNotes = new Command("notes").description("Update QA run notes or acceptanc
     if (!current.ok || !current.data) {
       throw new Error(current.error ?? "Failed to fetch QA run");
     }
-    const body5 = opts.notes !== void 0 ? { runId: current.data.run.id, runNotes: opts.notes } : {
+    const body5 = {
       runId: current.data.run.id,
-      acceptanceCriteriaSummary: opts.acceptance ?? null
+      ...opts.notes !== void 0 ? { runNotes: opts.notes } : {},
+      ...opts.acceptance !== void 0 ? { acceptanceCriteriaSummary: opts.acceptance } : {}
     };
     const res = await updateExperimentQaRun(creds, resolved.experimentId, body5);
     if (!res.ok || !res.data)
@@ -10120,20 +10914,32 @@ var qaNotes = new Command("notes").description("Update QA run notes or acceptanc
       resolved.folder,
       resolved.experimentId
     );
-    output(this, { run: run3 }, () => {
+    const data = opts.summary ? qaSummary(run3, {
+      notes: run3.notes,
+      acceptanceCriteriaSummary: run3.acceptanceCriteriaSummary
+    }) : { run: run3 };
+    output(this, data, () => {
       spinner.succeed("Updated QA notes");
-      printQaRun(run3);
+      if (opts.summary) process.stdout.write(`${JSON.stringify(data, null, 2)}
+`);
+      else printQaRun(run3);
     });
   } catch (error) {
     spinner.fail("Failed to update QA notes");
     throw error;
   }
 });
-var qaApprove = new Command("approve").description("Mark QA done after the checklist gates are ready").argument("[folder-or-id]", "Experiment filesystem folder, ID, or slug", ".").action(async function action16(target) {
+var qaApprove = new Command("approve").description("Approve QA and move the experiment to ready_to_launch; qa reopen returns it to QA").argument(
+  "[folder-or-id]",
+  "Experiment filesystem folder, ID, slug, or test key (for example BIO-085)",
+  "."
+).action(async function action19(target) {
   const creds = requireCredentials();
   const spinner = await createSpinner("Approving QA...");
   try {
     const resolved = await resolveExperimentForFilesystemOrId(target);
+    const before = await resolveExperiment(resolved.experimentId);
+    if (!before) fail(this, "Experiment not found.", EXIT_CODES.validation);
     const res = await approveExperimentQa(creds, resolved.experimentId);
     if (!res.ok)
       throw new CliError(
@@ -10146,17 +10952,35 @@ var qaApprove = new Command("approve").description("Mark QA done after the check
       resolved.folder,
       resolved.experimentId
     );
+    if (!res.data?.status) fail(this, "QA approval response is missing experiment status.");
+    const transition = {
+      from: before.status,
+      to: res.data.status,
+      reopen: `apex experiments qa reopen ${resolved.experimentId}`
+    };
     output(
       this,
-      { experimentId: resolved.experimentId, qaStatus: "done" },
-      () => spinner.succeed(`QA marked done for ${resolved.label}`)
+      {
+        experimentId: resolved.experimentId,
+        qaStatus: "done",
+        experiment_status_before: before.status,
+        experiment_status_after: res.data.status,
+        transition
+      },
+      () => spinner.succeed(
+        `QA approved: ${transition.from} \u2192 ${transition.to}; reopen: ${transition.reopen}`
+      )
     );
   } catch (error) {
     spinner.fail("Failed to approve QA");
     throw error;
   }
 });
-var qaReopen = new Command("reopen").description("Reopen QA and clear scheduled launch state").argument("[folder-or-id]", "Experiment filesystem folder, ID, or slug", ".").action(async function action17(target) {
+var qaReopen = new Command("reopen").description("Reopen QA and clear scheduled launch state").argument(
+  "[folder-or-id]",
+  "Experiment filesystem folder, ID, slug, or test key (for example BIO-085)",
+  "."
+).action(async function action20(target) {
   const creds = requireCredentials();
   const spinner = await createSpinner("Reopening QA...");
   try {
@@ -10214,7 +11038,13 @@ function resolveEvidenceVariation(experiment, ref) {
   }
   throw new Error(`Unknown --variation value: ${ref}`);
 }
-var qaEvidence = new Command("evidence").description("Attach screenshot jobs or upload typed QA evidence").argument("[folder-or-id]", "Experiment filesystem folder, ID, or slug", ".").option("--job <jobId>", "Attach a terminal screenshot job").option("--file <path>", "Upload an evidence image; repeat for more files", collectFile, []).option("--label <text>", "Evidence label").option("--device <device>", "desktop, mobile, tablet, or a raw device value").option("--variation <ref>", "Variation ID, slug, or name").option("--status <status>", "Evidence status").option("--kind <kind>", "Evidence kind", "screenshot").option("--records <json-or-@path>", "Typed evidence record array").option("--json", "Print the QA run in the standard JSON envelope").action(async function action18(target, opts) {
+var qaEvidence = new Command("evidence").description("Attach screenshot jobs or upload typed QA evidence").argument(
+  "[folder-or-id]",
+  "Experiment filesystem folder, ID, slug, or test key (for example BIO-085)",
+  "."
+).option("--job <jobId>", "Attach a terminal screenshot job").option("--file <path>", "Upload an evidence image; repeat for more files", collectFile, []).option("--label <text>", "Evidence label").option("--device <device>", "desktop, mobile, tablet, or a raw device value").option("--variation <ref>", "Variation ID, slug, or name").addOption(qaChoice("--status <status>", "Evidence status", evidenceStatuses)).addOption(qaChoice("--kind <kind>", "Evidence kind", evidenceKinds).default("screenshot")).option("--records <json-or-@path>", "Typed evidence record array").option("--summary", "Print a compact run and newly added evidence").option("--json", "Print the QA run in the standard JSON envelope").action(async function action21(target, opts) {
+  validateQaChoice(this, "--status", opts.status, evidenceStatuses);
+  validateQaChoice(this, "--kind", opts.kind, evidenceKinds);
   const modes = Number(Boolean(opts.job)) + Number(opts.file.length > 0) + Number(Boolean(opts.records));
   if (modes !== 1) {
     fail(this, "Provide exactly one of --job, --file, or --records.", EXIT_CODES.validation);
@@ -10223,6 +11053,17 @@ var qaEvidence = new Command("evidence").description("Attach screenshot jobs or
   const spinner = await createSpinner("Writing QA evidence...");
   try {
     const resolved = await resolveExperimentForFilesystemOrId(target);
+    const previousIds = /* @__PURE__ */ new Set();
+    if (opts.summary) {
+      const current = await getExperimentQaRun(creds, resolved.experimentId);
+      if (!current.ok || !current.data)
+        throw new CliError(
+          current.error ?? "Failed to fetch QA run",
+          classifyStatus(current.status),
+          current.errorDetails
+        );
+      for (const record2 of current.data.run.evidenceRecords) previousIds.add(record2.id);
+    }
     let response;
     if (opts.job) {
       response = await attachExperimentQaEvidence(creds, resolved.experimentId, {
@@ -10263,7 +11104,16 @@ var qaEvidence = new Command("evidence").description("Attach screenshot jobs or
       );
     }
     spinner.stop();
-    output(this, { run: response.data.run }, () => printQaRun(response.data.run));
+    const run3 = response.data.run;
+    const data = opts.summary ? qaSummary(
+      run3,
+      run3.evidenceRecords.filter((record2) => !previousIds.has(record2.id))
+    ) : { run: run3 };
+    output(this, data, () => {
+      if (opts.summary) process.stdout.write(`${JSON.stringify(data, null, 2)}
+`);
+      else printQaRun(run3);
+    });
   } catch (error) {
     spinner.fail("Failed to write QA evidence");
     throw error;
@@ -10279,102 +11129,255 @@ var SCREENSHOT_DEVICES = [
 ];
 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("'", "'\\''")}'`;
+}
+function isTransientResumeStatus(status2) {
+  return status2 === 429 || status2 !== void 0 && status2 >= 500;
+}
+function screenshotTimeoutMessage(job, experimentRef, out, seconds, flags = {}) {
+  const progress = job.progress ? ` Last progress: ${job.progress.captured}/${job.progress.total} captured.` : "";
+  const carried = [
+    flags.attachQa === false ? " --no-attach-qa" : "",
+    flags.labelPairs === false ? " --no-label-pairs" : "",
+    flags.json ? " --json" : ""
+  ].join("");
+  const resume = `apex experiments screenshots ${shellQuote(experimentRef)} --job ${shellQuote(job.job_id)} --out ${shellQuote(out)}${carried}`;
+  return `Screenshot job ${job.job_id} timed out after ${seconds}s.${progress} Resume with: ${resume}`;
+}
 var screenshots = new Command("screenshots").description(
   "Force-assign every capture, including control, to its variation server-side for deterministic screenshots"
-).argument("<experimentRef>", "Experiment ID or slug").option("--url <target>", "Target URL override (not supported by the current v1 API)").option("--devices <list>", `Comma-separated devices (default: ${SCREENSHOT_DEVICES.join(",")})`).option(
+).argument("<experimentRef>", EXPERIMENT_REFERENCE_DESCRIPTION).option("--url <target>", "Target URL override (not supported by the current v1 API)").option("--devices <list>", `Comma-separated devices (default: ${SCREENSHOT_DEVICES.join(",")})`).option(
   "--variations <list>",
   "Comma-separated treatment IDs, slugs, or names; control is always included and force-assigned"
-).option("--out <dir>", "Download directory", ".").option("--json", "Print the completed raw job payload with signed URLs").option("--no-attach-qa", "Do not attach the completed job to the QA run").option(
+).option("--out <dir>", "Download directory", ".").option("--job <id>", "Resume an existing screenshot job instead of creating one").option("--json", "Print the completed raw job payload with signed URLs").option("--no-attach-qa", "Do not attach the completed job to the QA run").option("--no-label-pairs", "Keep legacy screenshot filenames without before/after labels").option(
   "--timeout <seconds>",
   "Maximum wait for completion; finished results are always downloaded",
   "300"
-).action(async function action19(experimentRef, opts) {
+).action(async function action22(experimentRef, opts) {
   if (opts.url)
     fail(this, "--url is not supported by the current screenshot v1 API.", EXIT_CODES.validation);
   const timeoutSeconds = Number(opts.timeout);
+  const explicitJson = process.argv.includes("--json");
   if (!Number.isFinite(timeoutSeconds) || timeoutSeconds <= 0)
     fail(this, "--timeout must be a positive number of seconds.", EXIT_CODES.validation);
   const experiment = await resolveExperiment(experimentRef);
   if (!experiment?.variations?.length)
     fail(this, "Experiment has no variations to capture.", EXIT_CODES.validation);
-  const devices = opts.devices ? commaList(opts.devices) : SCREENSHOT_DEVICES;
-  if (!devices.length)
-    fail(this, "--devices must contain at least one device.", EXIT_CODES.validation);
-  const unknownDevices = devices.filter((device) => !SCREENSHOT_DEVICES.includes(device));
-  if (unknownDevices.length)
-    fail(
-      this,
-      `Unknown screenshot device(s): ${unknownDevices.join(", ")}`,
-      EXIT_CODES.validation
-    );
-  const requested = opts.variations ? commaList(opts.variations) : [];
-  const control = experiment.variations.find((variation) => variation.is_control);
-  if (!control) fail(this, "Experiment has no control variation.", EXIT_CODES.validation);
-  const matchedById = /* @__PURE__ */ new Map();
-  const unmatched = [];
-  for (const ref of requested) {
-    const exactMatch = experiment.variations.find(
-      (candidate) => ref === candidate.id || ref === candidate.slug
-    );
-    const nameMatches = exactMatch ? [] : experiment.variations.filter(
-      (candidate) => ref.toLowerCase() === candidate.name.toLowerCase()
-    );
-    if (nameMatches.length > 1) {
-      const matches = nameMatches.map(
-        (candidate) => `${candidate.name} (ID: ${candidate.id}${candidate.slug ? `, slug: ${candidate.slug}` : ""})`
+  const creds = requireCredentials();
+  let devices;
+  let variationIds;
+  let job;
+  let deadlineStart = null;
+  if (opts.job) {
+    const ignoredFlags = [
+      opts.devices ? "--devices" : null,
+      opts.variations ? "--variations" : null
+    ].filter((flag) => flag !== null);
+    if (ignoredFlags.length)
+      console.error(
+        source_default.yellow(
+          `Warning: ${ignoredFlags.join(" and ")} ${ignoredFlags.length > 1 ? "are" : "is"} ignored with --job; screenshot job ${opts.job} keeps its stored devices and variations.`
+        )
       );
+    deadlineStart = screenshotNow();
+    const resumeDeadline = deadlineStart + timeoutSeconds * 1e3;
+    let existing;
+    let resumeDelayMs = cliTestSetting("API") === "1" ? 1 : 1e3;
+    for (let attempt = 1; ; attempt += 1) {
+      try {
+        existing = await getScreenshotJob(
+          creds,
+          opts.job,
+          Math.max(1, resumeDeadline - screenshotNow())
+        );
+      } catch (error) {
+        if (attempt > 3 || screenshotNow() >= resumeDeadline) throw error;
+        await new Promise(
+          (resolve2) => setTimeout(
+            resolve2,
+            Math.min(resumeDelayMs, Math.max(0, resumeDeadline - screenshotNow()))
+          )
+        );
+        resumeDelayMs = Math.min(Math.round(resumeDelayMs * 1.6), 1e4);
+        continue;
+      }
+      if (!existing.ok && isTransientResumeStatus(existing.status) && attempt <= 3 && screenshotNow() < resumeDeadline) {
+        await new Promise(
+          (resolve2) => setTimeout(
+            resolve2,
+            Math.min(resumeDelayMs, Math.max(0, resumeDeadline - screenshotNow()))
+          )
+        );
+        resumeDelayMs = Math.min(Math.round(resumeDelayMs * 1.6), 1e4);
+        continue;
+      }
+      break;
+    }
+    if (!existing || !existing.ok || !existing.data)
       fail(
         this,
-        `Ambiguous --variations value "${ref}" matches: ${matches.join("; ")}. Use a variation ID or slug.`,
+        existing?.error ?? "Failed to resume screenshot job",
+        classifyStatus(existing?.status),
+        existing?.errorDetails
+      );
+    job = existing.data;
+    if (!job.experiment_id)
+      fail(
+        this,
+        `Screenshot job ${job.job_id} names no experiment; refusing to resume it under ${experimentRef} (${experiment.id}).`,
         EXIT_CODES.validation
       );
+    if (job.experiment_id !== experiment.id)
+      fail(
+        this,
+        `Screenshot job ${job.job_id} belongs to experiment ${job.experiment_id}, not ${experimentRef} (${experiment.id}).`,
+        EXIT_CODES.validation
+      );
+    const storedDevices = job.devices ?? [];
+    for (const device of storedDevices.filter((device2) => !SCREENSHOT_DEVICES.includes(device2)))
+      console.error(
+        source_default.yellow(
+          `Warning: screenshot job ${job.job_id} names device ${device}, which this CLI does not know; skipping it.`
+        )
+      );
+    devices = storedDevices.filter((device) => SCREENSHOT_DEVICES.includes(device));
+    if (!devices.length)
+      fail(
+        this,
+        storedDevices.length ? `Screenshot job ${job.job_id} names no device this CLI knows (${storedDevices.join(", ")}).` : `Screenshot job ${job.job_id} names no devices; it cannot be resumed.`,
+        EXIT_CODES.validation
+      );
+    if (Array.isArray(job.results))
+      fail(
+        this,
+        `Screenshot job ${job.job_id} stores its results in a legacy shape this CLI cannot download; create a new job instead of resuming it.`,
+        EXIT_CODES.validation
+      );
+    const knownVariationIds = new Set(experiment.variations.map((variation) => variation.id));
+    const storedVariationIds = job.variation_ids ?? [];
+    for (const id of storedVariationIds.filter((id2) => !knownVariationIds.has(id2)))
+      console.error(
+        source_default.yellow(
+          `Warning: screenshot job ${job.job_id} names variation ${id}, which is not part of this experiment; skipping it.`
+        )
+      );
+    variationIds = storedVariationIds.filter((id) => knownVariationIds.has(id));
+    if (!variationIds.length)
+      fail(
+        this,
+        `Screenshot job ${job.job_id} names no variation that belongs to experiment ${experimentRef}.`,
+        EXIT_CODES.validation
+      );
+  } else {
+    devices = opts.devices ? commaList(opts.devices) : SCREENSHOT_DEVICES;
+    if (!devices.length)
+      fail(this, "--devices must contain at least one device.", EXIT_CODES.validation);
+    const unknownDevices = devices.filter((device) => !SCREENSHOT_DEVICES.includes(device));
+    if (unknownDevices.length)
+      fail(
+        this,
+        `Unknown screenshot device(s): ${unknownDevices.join(", ")}`,
+        EXIT_CODES.validation
+      );
+    const requested = opts.variations ? commaList(opts.variations) : [];
+    const control = experiment.variations.find((variation) => variation.is_control);
+    if (!control) fail(this, "Experiment has no control variation.", EXIT_CODES.validation);
+    const matchedById = /* @__PURE__ */ new Map();
+    const unmatched = [];
+    for (const ref of requested) {
+      const exactMatch = experiment.variations.find(
+        (candidate) => ref === candidate.id || ref === candidate.slug
+      );
+      const nameMatches = exactMatch ? [] : experiment.variations.filter(
+        (candidate) => ref.toLowerCase() === candidate.name.toLowerCase()
+      );
+      if (nameMatches.length > 1) {
+        const matches = nameMatches.map(
+          (candidate) => `${candidate.name} (ID: ${candidate.id}${candidate.slug ? `, slug: ${candidate.slug}` : ""})`
+        );
+        fail(
+          this,
+          `Ambiguous --variations value "${ref}" matches: ${matches.join("; ")}. Use a variation ID or slug.`,
+          EXIT_CODES.validation
+        );
+      }
+      const variation = exactMatch ?? nameMatches[0];
+      if (variation) matchedById.set(variation.id, variation);
+      else unmatched.push(ref);
     }
-    const variation = exactMatch ?? nameMatches[0];
-    if (variation) matchedById.set(variation.id, variation);
-    else unmatched.push(ref);
-  }
-  if (unmatched.length)
-    fail(this, `Unknown --variations value(s): ${unmatched.join(", ")}`, EXIT_CODES.validation);
-  const selected2 = requested.length ? [...matchedById.values()] : experiment.variations;
-  const variationIds = [.../* @__PURE__ */ new Set([control.id, ...selected2.map((variation) => variation.id)])];
-  const creds = requireCredentials();
-  const created = await createExperimentScreenshots(creds, experiment.id, {
-    devices,
-    variation_ids: variationIds
-  });
-  if (!created.ok || !created.data)
-    fail(
-      this,
-      created.error ?? "Failed to create screenshot job",
-      classifyStatus(created.status),
-      created.errorDetails
-    );
-  let job = created.data;
-  const deadline = screenshotNow() + timeoutSeconds * 1e3;
+    if (unmatched.length)
+      fail(this, `Unknown --variations value(s): ${unmatched.join(", ")}`, EXIT_CODES.validation);
+    const selected2 = requested.length ? [...matchedById.values()] : experiment.variations;
+    variationIds = [.../* @__PURE__ */ new Set([control.id, ...selected2.map((variation) => variation.id)])];
+    const created = await createExperimentScreenshots(creds, experiment.id, {
+      devices,
+      variation_ids: variationIds
+    });
+    if (!created.ok || !created.data)
+      fail(
+        this,
+        created.error ?? "Failed to create screenshot job",
+        classifyStatus(created.status),
+        created.errorDetails
+      );
+    job = created.data;
+  }
+  const deadline = (deadlineStart ?? screenshotNow()) + timeoutSeconds * 1e3;
   let delayMs = cliTestSetting("API") === "1" ? 1 : 1e3;
   let consecutiveTransientFailures = 0;
   while (job.status === "queued" || job.status === "processing") {
     if (screenshotNow() >= deadline)
-      fail(this, `Screenshot job ${job.job_id} timed out after ${timeoutSeconds}s.`);
+      fail(
+        this,
+        screenshotTimeoutMessage(job, experimentRef, opts.out, timeoutSeconds, {
+          labelPairs: opts.labelPairs,
+          json: explicitJson,
+          attachQa: opts.attachQa
+        })
+      );
     await new Promise(
       (resolve2) => setTimeout(resolve2, Math.min(delayMs, Math.max(0, deadline - screenshotNow())))
     );
     if (screenshotNow() >= deadline)
-      fail(this, `Screenshot job ${job.job_id} timed out after ${timeoutSeconds}s.`);
+      fail(
+        this,
+        screenshotTimeoutMessage(job, experimentRef, opts.out, timeoutSeconds, {
+          labelPairs: opts.labelPairs,
+          json: explicitJson,
+          attachQa: opts.attachQa
+        })
+      );
     let polled;
     try {
       polled = await getScreenshotJob(creds, job.job_id, Math.max(1, deadline - screenshotNow()));
     } catch (error) {
       if (screenshotNow() >= deadline)
-        fail(this, `Screenshot job ${job.job_id} timed out after ${timeoutSeconds}s.`);
+        fail(
+          this,
+          screenshotTimeoutMessage(job, experimentRef, opts.out, timeoutSeconds, {
+            labelPairs: opts.labelPairs,
+            json: explicitJson,
+            attachQa: opts.attachQa
+          })
+        );
       consecutiveTransientFailures += 1;
       if (consecutiveTransientFailures > 3) throw error;
       delayMs = Math.min(Math.round(delayMs * 1.6), 1e4);
       continue;
     }
     const polledToTerminalState = polled.ok && polled.data && polled.data.status !== "queued" && polled.data.status !== "processing";
+    if (polled.ok && polled.data) job = polled.data;
     if (!polledToTerminalState && screenshotNow() >= deadline) {
-      fail(this, `Screenshot job ${job.job_id} timed out after ${timeoutSeconds}s.`);
+      fail(
+        this,
+        screenshotTimeoutMessage(job, experimentRef, opts.out, timeoutSeconds, {
+          labelPairs: opts.labelPairs,
+          json: explicitJson,
+          attachQa: opts.attachQa
+        })
+      );
     }
     if (!polled.ok || !polled.data) {
       const transient = polled.status === 429 || polled.status >= 500;
@@ -10390,7 +11393,6 @@ var screenshots = new Command("screenshots").description(
       continue;
     }
     consecutiveTransientFailures = 0;
-    job = polled.data;
     delayMs = Math.min(Math.round(delayMs * 1.6), 1e4);
   }
   if (opts.attachQa !== false) {
@@ -10421,16 +11423,32 @@ var screenshots = new Command("screenshots").description(
   const rows = [];
   const errors = [];
   const usedFilenames = /* @__PURE__ */ new Set();
+  const hasControlVariation = experiment.variations.some((item) => item.is_control);
   const downloads = [];
+  if (Array.isArray(job.results))
+    fail(
+      this,
+      `Screenshot job ${job.job_id} stores its results in a legacy shape this CLI cannot download; create a new job instead of resuming it.`,
+      EXIT_CODES.validation
+    );
   for (const variationId of variationIds) {
     const variation = experiment.variations.find((item) => item.id === variationId);
+    if (!variation) {
+      console.error(
+        source_default.yellow(
+          `Warning: variation ${variationId} is not part of this experiment; skipping it.`
+        )
+      );
+      continue;
+    }
     for (const device of devices) {
       const url = job.results?.[variationId]?.[device];
       if (!url) {
         downloads.push({ variation, device, url, filename: "" });
         continue;
       }
-      const baseFilename = `${safeFilenamePart(experiment.slug ?? experiment.name)}-${safeFilenamePart(variation.slug ?? variation.name)}-${safeFilenamePart(device)}`;
+      const pairPrefix = opts.labelPairs === false || !hasControlVariation ? "" : variation.is_control ? "before-" : "after-";
+      const baseFilename = `${pairPrefix}${safeFilenamePart(experiment.slug ?? experiment.name)}-${safeFilenamePart(variation.slug ?? variation.name)}-${safeFilenamePart(device)}`;
       let filename = `${baseFilename}.png`;
       if (usedFilenames.has(filename)) {
         const suffix = variation.id.replace(/[^a-z0-9]/gi, "").slice(-8).toLowerCase();
@@ -10487,7 +11505,7 @@ var screenshots = new Command("screenshots").description(
     printTable(["VARIATION", "DEVICE", "FILE"], rows, [24, 20, 48]);
   });
 });
-var experimentsCommand = new Command("experiments").alias("exp").description("Manage experiments").addCommand(list).addCommand(get).addCommand(results).addCommand(create).addCommand(pause).addCommand(complete).addCommand(del).addCommand(pullFilesystem).addCommand(planFilesystem).addCommand(applyFilesystem).addCommand(screenshots).addCommand(qa).addHelpText(
+var experimentsCommand = new Command("experiments").alias("exp").description("Manage experiments").addCommand(list).addCommand(get).addCommand(results).addCommand(update).addCommand(create).addCommand(attachIdea).addCommand(detachIdea).addCommand(pause).addCommand(complete).addCommand(del).addCommand(pullFilesystem).addCommand(planFilesystem).addCommand(applyFilesystem).addCommand(screenshots).addCommand(qa).addHelpText(
   "after",
   `
 Examples:
@@ -10581,10 +11599,10 @@ async function importConfigModule(absPath) {
   }
   throw new Error(`Unsupported config extension "${ext}". Use .drip.config.ts or .drip.config.js.`);
 }
-function isRecord(value) {
+function isRecord2(value) {
   return !!value && typeof value === "object" && !Array.isArray(value);
 }
-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 action20(opts) {
+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();
   const configPath = opts.config ?? findConfigPath();
   if (!configPath) {
@@ -10599,12 +11617,12 @@ var pushCommand = new Command("push").description("Push experiment definitions f
   let experiments;
   try {
     const mod = await importConfigModule(absoluteConfigPath);
-    const exported = isRecord(mod) && "default" in mod ? mod.default : mod;
+    const exported = isRecord2(mod) && "default" in mod ? mod.default : mod;
     if (Array.isArray(exported)) {
       experiments = exported;
-    } else if (isRecord(exported) && Array.isArray(exported.experiments)) {
+    } else if (isRecord2(exported) && Array.isArray(exported.experiments)) {
       experiments = exported.experiments;
-    } else if (isRecord(exported) && typeof exported.slug === "string" && Array.isArray(exported.variations)) {
+    } else if (isRecord2(exported) && typeof exported.slug === "string" && Array.isArray(exported.variations)) {
       experiments = [exported];
     } else {
       spinner?.fail("Invalid config format");
@@ -11028,7 +12046,7 @@ async function createSession(folder) {
 var harnessCommand = new Command("harness").description(
   "Develop AB Test Harness projects through Apex live QA sessions"
 );
-harnessCommand.command("init").argument("<folder>", "AB Test Harness experiment folder").option("--force", "Overwrite existing apex.harness.json").action(function action21(folderArg, opts) {
+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_fs9.default.existsSync(targetPath) && !opts.force) {
@@ -11048,7 +12066,7 @@ harnessCommand.command("init").argument("<folder>", "AB Test Harness experiment
     () => printSuccess(`Created ${targetPath}`)
   );
 });
-harnessCommand.command("dev").argument("<folder>", "AB Test Harness experiment folder").option("--no-open", "Print preview URL instead of opening it").action(async function action22(folderArg, opts) {
+harnessCommand.command("dev").argument("<folder>", "AB Test Harness experiment folder").option("--no-open", "Print preview URL instead of opening it").action(async function action25(folderArg, opts) {
   const folder = resolveFolder(folderArg);
   const created = await createSession(folder);
   await runAbHarness(["build", folder], folder);
@@ -11115,7 +12133,7 @@ harnessCommand.command("dev").argument("<folder>", "AB Test Harness experiment f
     process.exitCode = 0;
   });
 });
-harnessCommand.command("publish").argument("<folder>", "AB Test Harness experiment folder").action(async function action23(folderArg) {
+harnessCommand.command("publish").argument("<folder>", "AB Test Harness experiment folder").action(async function action26(folderArg) {
   const folder = resolveFolder(folderArg);
   const created = await createSession(folder);
   await runAbHarness(["verify", folder], folder);
@@ -11490,7 +12508,7 @@ Examples:
   apex workspace publish ./workspace
 `
 );
-operatorCommand.command("checkout").argument("<experiment-id>", "Apex experiment ID").requiredOption("--variation <id-or-slug>", "Variation ID, slug, or name").option("--out <path>", "Target folder").action(async function action24(experimentId, opts) {
+operatorCommand.command("checkout").argument("<experiment-id>", "Apex experiment ID").requiredOption("--variation <id-or-slug>", "Variation ID, slug, or name").option("--out <path>", "Target folder").action(async function action27(experimentId, opts) {
   try {
     const creds = requireCredentials();
     const expRes = await getExperiment(creds, experimentId);
@@ -11540,7 +12558,7 @@ operatorCommand.command("checkout").argument("<experiment-id>", "Apex experiment
     throw error;
   }
 });
-operatorCommand.command("status").argument("[folder]", "Operator workspace folder", ".").action(function action25(folderArg) {
+operatorCommand.command("status").argument("[folder]", "Operator workspace folder", ".").action(function action28(folderArg) {
   try {
     const folder = folderPath2(folderArg);
     const session = readSession(folder);
@@ -11572,7 +12590,7 @@ operatorCommand.command("status").argument("[folder]", "Operator workspace folde
     fail(this, error instanceof Error ? error.message : String(error));
   }
 });
-operatorCommand.command("dev").argument("[folder]", "Operator workspace folder", ".").option("--no-open", "Print preview URL instead of opening it").option("--once", "Upload one preview version and exit").action(async function action26(folderArg, opts) {
+operatorCommand.command("dev").argument("[folder]", "Operator workspace folder", ".").option("--no-open", "Print preview URL instead of opening it").option("--once", "Upload one preview version and exit").action(async function action29(folderArg, opts) {
   try {
     const folder = folderPath2(folderArg);
     const session = readSession(folder);
@@ -11651,7 +12669,7 @@ operatorCommand.command("dev").argument("[folder]", "Operator workspace folder",
     throw error;
   }
 });
-operatorCommand.command("publish").argument("[folder]", "Operator workspace folder", ".").option("--allow-goal-writes", "Allow metrics.json to create or update shared shop-level goals").action(async function action27(folderArg, opts) {
+operatorCommand.command("publish").argument("[folder]", "Operator workspace folder", ".").option("--allow-goal-writes", "Allow metrics.json to create or update shared shop-level goals").action(async function action30(folderArg, opts) {
   try {
     const result = await runPublish(folderArg, opts);
     const build = result.build;
@@ -11695,7 +12713,7 @@ function briefLine(item) {
   ].filter(Boolean);
   return parts.join("\n");
 }
-var approved = new Command("approved").description("List approved roadmap ideas ready to build in Apex").option("-n, --limit <n>", "Max results", "20").option("--cursor <id>", "Pagination cursor").option("-q, --query <text>", "Search title, hypothesis, brief, and notes").option("--unbuilt", "Only show approved ideas without a linked experiment").option("--built", "Only show approved ideas with a linked experiment").option("--json", "Print raw JSON").option("--brief", "Print each item with hypothesis and target URL").action(async function action28(opts) {
+var approved = new Command("approved").description("List approved roadmap ideas ready to build in Apex").option("-n, --limit <n>", "Max results", "20").option("--cursor <id>", "Pagination cursor").option("-q, --query <text>", "Search title, hypothesis, brief, and notes").option("--unbuilt", "Only show approved ideas without a linked experiment").option("--built", "Only show approved ideas with a linked experiment").option("--json", "Print raw JSON").option("--brief", "Print each item with hypothesis and target URL").action(async function action31(opts) {
   const creds = requireCredentials();
   const limit = parseInt(opts.limit, 10);
   const hasExperiment = opts.unbuilt ? false : opts.built ? true : void 0;
@@ -11749,7 +12767,7 @@ More results: --cursor ${res.data.pagination.next_cursor}`));
     }
   );
 });
-var handoff = new Command("handoff").description("Get the full build brief for an approved roadmap item").argument("<id>", "Roadmap/backlog item ID").option("--out <path>", "Write handoff JSON to a file").addOption(new Option("-o, --output <path>", "Legacy alias for --out").hideHelp()).option("--instructions", "Print only the build instructions").action(async function action29(id, opts) {
+var handoff = new Command("handoff").description("Get the full build brief for an approved roadmap item").argument("<id>", "Roadmap/backlog item ID").option("--out <path>", "Write handoff JSON to a file").addOption(new Option("-o, --output <path>", "Legacy alias for --out").hideHelp()).option("--instructions", "Print only the build instructions").action(async function action32(id, opts) {
   if (opts.output !== void 0) {
     process.stderr.write(
       `Warning: --output is deprecated for apex roadmap handoff; use --out instead. --output will be removed in v${LEGACY_OUTPUT_REMOVAL_VERSION}.
@@ -11968,7 +12986,7 @@ trackingCommand.command("qa").description("Print the QA checklist for a tracking
     console.log(`${index + 1}. ${check}`);
   });
 });
-trackingCommand.command("verify").description("Verify live tracking events for the current shop").option("--minutes <n>", "Lookback window in minutes", "120").option("--limit <n>", "Recent events to include", "20").option("--experiment <id>", "Filter to one experiment ID").option("--event-type <type>", "Filter to one event type; repeat with comma-separated values").action(async function action30(opts) {
+trackingCommand.command("verify").description("Verify live tracking events for the current shop").option("--minutes <n>", "Lookback window in minutes", "120").option("--limit <n>", "Recent events to include", "20").option("--experiment <id>", "Filter to one experiment ID").option("--event-type <type>", "Filter to one event type; repeat with comma-separated values").action(async function action33(opts) {
   const creds = requireCredentials();
   const res = await verifyTracking(creds, {
     minutes: Number.parseInt(opts.minutes, 10),
@@ -12225,7 +13243,7 @@ function printGoal(goal) {
   console.log(`  Count once: ${goal.count_once ? "yes" : "no"}`);
   console.log();
 }
-var list2 = new Command("list").alias("ls").description("List goals").option("-n, --limit <n>", "Max results", "50").action(async function action31(opts) {
+var list2 = new Command("list").alias("ls").description("List goals").option("-n, --limit <n>", "Max results", "50").action(async function action34(opts) {
   const creds = requireCredentials();
   const res = await listGoals(creds, { limit: Number.parseInt(opts.limit, 10) });
   if (!res.ok || !res.data) {
@@ -12249,7 +13267,7 @@ 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("--count-once", "Count only once per visitor").option("--capture <json-or-path>", "Capture JSON array or @path").action(async function action32(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("--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();
   const body5 = cleanBody({
     name: opts.name,
@@ -12275,10 +13293,10 @@ var create2 = new Command("create").description("Create a goal").requiredOption(
   }
   output(this, { goal: res.data }, () => printGoal(res.data));
 });
-var update = 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(
+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("--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 action33(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("--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 body5 = cleanBody({
     name: opts.name,
@@ -12310,7 +13328,7 @@ var update = new Command("update").description("Update a goal").argument("<id>",
 var test = new Command("test").description("Dry run a goal URL pattern against traffic").option(
   "--pattern <regex>",
   "URL regex pattern to test (matched against the full URL, as the SDK matches pageview goals)"
-).option("--goal <id>", "Existing goal ID whose URL pattern should be tested").option("--days <n>", "Traffic lookback days", "14").action(async function action34(opts) {
+).option("--goal <id>", "Existing goal ID whose URL pattern should be tested").option("--days <n>", "Traffic lookback days", "14").action(async function action37(opts) {
   if (!opts.pattern && !opts.goal)
     fail(this, "Provide --pattern or --goal.", EXIT_CODES.validation);
   if (opts.pattern && opts.goal)
@@ -12392,7 +13410,7 @@ var test = new Command("test").description("Dry run a goal URL pattern against t
     }
   );
 });
-var suggest = new Command("suggest").description("Suggest goals and funnels from analytics").option("--create", "Create selected goals after confirmation").option("--yes", "Skip prompts when used with create").action(async function action35(opts) {
+var suggest = new Command("suggest").description("Suggest goals and funnels from analytics").option("--create", "Create selected goals after confirmation").option("--yes", "Skip prompts when used with create").action(async function action38(opts) {
   const creds = requireCredentials();
   const res = await suggestGoals(creds);
   if (!res.ok || !res.data)
@@ -12440,7 +13458,7 @@ var suggest = new Command("suggest").description("Suggest goals and funnels from
       );
   }
 });
-var goalsCommand = new Command("goals").description("Manage conversion and revenue goals").addCommand(list2).addCommand(create2).addCommand(update).addCommand(test).addCommand(suggest).addHelpText(
+var goalsCommand = new Command("goals").description("Manage conversion and revenue goals").addCommand(list2).addCommand(create2).addCommand(update2).addCommand(test).addCommand(suggest).addHelpText(
   "after",
   `
 Examples:
@@ -12482,7 +13500,7 @@ function printFunnel(funnel) {
     console.log(`  ${step.order}. ${step.label} \u2014 ${step.url_pattern}`);
   console.log();
 }
-var list3 = new Command("list").alias("ls").description("List funnels").action(async function action36() {
+var list3 = new Command("list").alias("ls").description("List funnels").action(async function action39() {
   const res = await listFunnels(requireCredentials());
   if (!res.ok || !res.data)
     fail(
@@ -12501,7 +13519,7 @@ var list3 = new Command("list").alias("ls").description("List funnels").action(a
     )
   );
 });
-var create3 = new Command("create").description("Create a funnel").requiredOption("--name <name>", "Funnel name").requiredOption("--steps-file <file>", "JSON array of { label, pattern }").action(async function action37(opts) {
+var create3 = new Command("create").description("Create a funnel").requiredOption("--name <name>", "Funnel name").requiredOption("--steps-file <file>", "JSON array of { label, pattern }").action(async function action40(opts) {
   const res = await createFunnel(requireCredentials(), {
     name: opts.name,
     steps: readSteps(this, opts.stepsFile)
@@ -12515,7 +13533,7 @@ var create3 = new Command("create").description("Create a funnel").requiredOptio
     );
   output(this, { funnel: res.data }, () => printFunnel(res.data));
 });
-var update2 = new Command("update").description("Replace a funnel's steps").argument("<id>", "Funnel ID").requiredOption("--steps-file <file>", "JSON array of { label, pattern }").action(async function action38(id, opts) {
+var update3 = new Command("update").description("Replace a funnel's steps").argument("<id>", "Funnel ID").requiredOption("--steps-file <file>", "JSON array of { label, pattern }").action(async function action41(id, opts) {
   const res = await updateFunnel(requireCredentials(), id, {
     steps: readSteps(this, opts.stepsFile)
   });
@@ -12528,7 +13546,7 @@ var update2 = new Command("update").description("Replace a funnel's steps").argu
     );
   output(this, { funnel: res.data }, () => printFunnel(res.data));
 });
-var del2 = new Command("delete").description("Delete a funnel").argument("<id>", "Funnel ID").action(async function action39(id) {
+var del2 = new Command("delete").description("Delete a funnel").argument("<id>", "Funnel ID").action(async function action42(id) {
   const res = await deleteFunnel(requireCredentials(), id);
   if (!res.ok)
     fail(
@@ -12539,7 +13557,7 @@ var del2 = new Command("delete").description("Delete a funnel").argument("<id>",
     );
   output(this, { deleted: true, id }, () => console.log(`Deleted funnel ${id}`));
 });
-var run = new Command("run").description("Run funnel analysis").argument("<id>", "Funnel ID").option("--days <n>", "Analysis window", "30").action(async function action40(id, opts) {
+var run = new Command("run").description("Run funnel analysis").argument("<id>", "Funnel ID").option("--days <n>", "Analysis window", "30").action(async function action43(id, opts) {
   if (!/^[1-9]\d*$/.test(opts.days))
     fail(this, "--days must be a positive integer", EXIT_CODES.validation);
   const days = Number.parseInt(opts.days, 10);
@@ -12563,11 +13581,11 @@ var run = new Command("run").description("Run funnel analysis").argument("<id>",
     )
   );
 });
-var validate2 = new Command("validate").description("Validate funnel steps without writing").requiredOption("--steps-file <file>", "JSON array of { label, pattern }").action(function action41(opts) {
+var validate2 = new Command("validate").description("Validate funnel steps without writing").requiredOption("--steps-file <file>", "JSON array of { label, pattern }").action(function action44(opts) {
   const steps = readSteps(this, opts.stepsFile);
   output(this, { valid: true, steps }, () => console.log(`Valid funnel steps: ${steps.length}`));
 });
-var funnelsCommand = new Command("funnels").description("Manage analytics funnels").addCommand(list3).addCommand(create3).addCommand(update2).addCommand(del2).addCommand(run).addCommand(validate2);
+var funnelsCommand = new Command("funnels").description("Manage analytics funnels").addCommand(list3).addCommand(create3).addCommand(update3).addCommand(del2).addCommand(run).addCommand(validate2);
 
 // src/commands/environments.ts
 init_source();
@@ -12624,11 +13642,11 @@ async function load2(command) {
   }
   return result.data;
 }
-var list4 = new Command("list").alias("ls").description("List runtime environments and mapped domains").action(async function action42() {
+var list4 = new Command("list").alias("ls").description("List runtime environments and mapped domains").action(async function action45() {
   const { environments } = await load2(this);
   output(this, { environments }, () => printEnvironments(environments.items));
 });
-var setDomain = new Command("set-domain").description("Map a domain to a runtime environment").argument("<domain>", "Domain to map").requiredOption("--environment <env>", "Environment key").action(async function action43(domain, opts) {
+var setDomain = new Command("set-domain").description("Map a domain to a runtime environment").argument("<domain>", "Domain to map").requiredOption("--environment <env>", "Environment key").action(async function action46(domain, opts) {
   const normalizedDomain = normalizeEnvironmentDomain(domain);
   if (!normalizedDomain) {
     fail(this, "Domain must be a valid hostname containing a dot", EXIT_CODES.validation);
@@ -12675,7 +13693,7 @@ var setDomain = new Command("set-domain").description("Map a domain to a runtime
     () => printEnvironments(result.data.environments.items)
   );
 });
-var removeDomain = new Command("remove-domain").description("Remove a domain mapping").argument("<domain>", "Domain to remove").action(async function action44(domain) {
+var removeDomain = new Command("remove-domain").description("Remove a domain mapping").argument("<domain>", "Domain to remove").action(async function action47(domain) {
   const normalizedDomain = normalizeEnvironmentDomain(domain);
   if (!normalizedDomain) {
     fail(this, "Domain must be a valid hostname containing a dot", EXIT_CODES.validation);
@@ -12739,11 +13757,11 @@ function printConsent(data) {
     `Split: ${data.prerequisites.showVariationsRule && data.prerequisites.startTrackingRule ? "canonical" : "off"}`
   );
 }
-var get2 = new Command("get").description("Show consent settings").action(async function action45() {
+var get2 = new Command("get").description("Show consent settings").action(async function action48() {
   const data = await load3(this);
   output(this, data, () => printConsent(data));
 });
-var set = new Command("set").description("Enable and configure consent gating").requiredOption("--provider <provider>", "Consent provider").requiredOption("--group <group>", "Required consent group").option("--getter <path>", "Custom consent getter path").action(async function action46(opts) {
+var set = new Command("set").description("Enable and configure consent gating").requiredOption("--provider <provider>", "Consent provider").requiredOption("--group <group>", "Required consent group").option("--getter <path>", "Custom consent getter path").action(async function action49(opts) {
   const consentMode = {
     enabled: true,
     provider: opts.provider,
@@ -12764,7 +13782,7 @@ var set = new Command("set").description("Enable and configure consent gating").
   warn(this, result.data.precompile);
   output(this, result.data, () => printConsent(result.data));
 });
-var off = new Command("off").description("Disable consent gating").action(async function action47() {
+var off = new Command("off").description("Disable consent gating").action(async function action50() {
   const result = await updateConsent(requireCredentials(), { consentMode: { enabled: false } });
   if (!result.ok || !result.data)
     fail(
@@ -13078,8 +14096,8 @@ function score2(path24, patterns) {
     0
   );
 }
-function best(fields2, patterns, numeric2 = false) {
-  const ranked = fields2.filter(
+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
   ).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 [];
@@ -13104,15 +14122,15 @@ function proposeTriggers(report) {
       continue;
     const descriptors = candidate.fields ?? candidate.paths;
     const payload = candidate.properties ?? candidate.payload ?? candidate;
-    const fields2 = descriptors !== void 0 ? fieldsFrom(descriptors, "", true) : fieldsFrom(payload, "", isDescriptorArray(payload));
+    const fields3 = descriptors !== void 0 ? fieldsFrom(descriptors, "", true) : fieldsFrom(payload, "", isDescriptorArray(payload));
     const revenues = best(
-      fields2,
+      fields3,
       [/revenue/, /total.*amount|amount.*total/, /grand.*total|total/, /value|amount/],
       true
     );
-    const orderIds = best(fields2, [/order.*id|id.*order/, /transaction.*id/, /(^|\.)id$/]);
-    const currencies = best(fields2, [/currency/, /(^|\.)cur(rency)?$/]);
-    const items = best(fields2, [/(^|\.)((line_?)?items|products)$/]);
+    const orderIds = best(fields3, [/order.*id|id.*order/, /transaction.*id/, /(^|\.)id$/]);
+    const currencies = best(fields3, [/currency/, /(^|\.)cur(rency)?$/]);
+    const items = best(fields3, [/(^|\.)((line_?)?items|products)$/]);
     if (!revenues.length || !orderIds.length || !currencies.length) continue;
     for (const revenue of revenues)
       for (const orderId of orderIds)
@@ -13662,11 +14680,11 @@ async function patchWithRetry(command, build) {
   warn2(command, result.data.precompile);
   return result.data;
 }
-var list5 = new Command("list").alias("ls").description("List install domains").action(async function action48() {
+var list5 = new Command("list").alias("ls").description("List install domains").action(async function action51() {
   const data = await load4(this);
   output(this, data, () => printDomains(data));
 });
-var add = new Command("add").description("Add install domains").argument("<domain...>").action(async function action49(domain) {
+var add = new Command("add").description("Add install domains").argument("<domain...>").action(async function action52(domain) {
   const added = domain.map(normalizeDomain);
   const data = await patchWithRetry(
     this,
@@ -13674,7 +14692,7 @@ var add = new Command("add").description("Add install domains").argument("<domai
   );
   output(this, data, () => printDomains(data));
 });
-var remove = new Command("remove").description("Remove install domains").argument("<domain...>").action(async function action50(domain) {
+var remove = new Command("remove").description("Remove install domains").argument("<domain...>").action(async function action53(domain) {
   const removeSet = new Set(domain.map(normalizeDomain));
   const data = await patchWithRetry(
     this,
@@ -13682,7 +14700,7 @@ var remove = new Command("remove").description("Remove install domains").argumen
   );
   output(this, data, () => printDomains(data));
 });
-var set3 = new Command("set").description("Replace install domains").argument("<domain...>").action(async function action51(domain) {
+var set3 = new Command("set").description("Replace install domains").argument("<domain...>").action(async function action54(domain) {
   const replacement = domain.map(normalizeDomain);
   const data = await patchWithRetry(this, () => replacement);
   output(this, data, () => printDomains(data));
@@ -13774,14 +14792,14 @@ async function patchWithRetry2(command, build) {
     );
   return result.data;
 }
-var get4 = new Command("get").description("Show cross-domain handover settings").action(async function action52() {
+var get4 = new Command("get").description("Show cross-domain handover settings").action(async function action55() {
   const data = await load5(this);
   output(this, data, () => printSettings(data.externalTracking));
 });
 var set4 = new Command("set").description("Enable cross-domain identity handover").requiredOption("--domain <domain...>", "Bound handover domain(s)").option("--param <param>", "Handover query parameter").option(
   "--signed",
   "Require signed handover tokens (the default; unsigning is a platform-support action)"
-).action(async function action53(opts) {
+).action(async function action56(opts) {
   const domains = opts.domain.map(normalizeDomain2);
   if (domains.some((domain) => !domain))
     fail(
@@ -13801,14 +14819,14 @@ var set4 = new Command("set").description("Enable cross-domain identity handover
   }));
   output(this, data, () => printSettings(data.externalTracking));
 });
-var off2 = new Command("off").description("Disable cross-domain handover").action(async function action54() {
+var off2 = new Command("off").description("Disable cross-domain handover").action(async function action57() {
   const data = await patchWithRetry2(this, (current) => ({
     externalTracking: { domains: [], signed: true },
     ifRevision: current.revision
   }));
   output(this, data, () => printSettings(data.externalTracking));
 });
-var qa2 = new Command("qa").description("Check static link/form handover parameter carriage").requiredOption("--from <url>", "Page URL to inspect").requiredOption("--to-domain <domain>", "Target domain that should carry the handover parameter").action(async function action55(opts) {
+var qa2 = new Command("qa").description("Check static link/form handover parameter carriage").requiredOption("--from <url>", "Page URL to inspect").requiredOption("--to-domain <domain>", "Target domain that should carry the handover parameter").action(async function action58(opts) {
   const config = await load5(this);
   const target = normalizeDomain2(opts.toDomain);
   if (!target) fail(this, "--to-domain must be a valid hostname", EXIT_CODES.validation);
@@ -14851,7 +15869,7 @@ var doctorCommand = new Command("doctor").description("Check shop configuration
 ).option("--check <id>", "Run one check (for example purchase_capture)").option(
   "--worker <url>",
   `Apex Worker base URL; defaults to DRIP_WORKER_URL or ${PRODUCTION_WORKER_BASE_URL}`
-).action(async function action56(options) {
+).action(async function action59(options) {
   const data = await runDoctor(options);
   if (options.check && data.checks.length === 0)
     fail(this, `Unknown doctor check: ${options.check}`, EXIT_CODES.validation);
@@ -14873,7 +15891,7 @@ function printDoctorReport(checks) {
 var consentRateCommand = new Command("consent-rate").description("Estimate analytics consent acceptance from visitor series").option(
   "--since <date>",
   "Consent gating start date (YYYY-MM-DD); splits the baseline and gated windows"
-).action(async function action57(opts) {
+).action(async function action60(opts) {
   if (opts.since !== void 0 && parseDay(opts.since) === null)
     fail(this, "--since must be a calendar date in YYYY-MM-DD form", EXIT_CODES.validation);
   const result = await getVisitorSeries(requireCredentials(), { days: VISITOR_SERIES_DAYS });
@@ -14933,7 +15951,7 @@ function analyticsSubcommand(name, description, defaultDays) {
     command.option("--planning-days <n>", "Planning window in days", "180");
     command.option("--limit <n>", "Maximum page rows", "50");
   }
-  return command.action(async function action71(opts) {
+  return command.action(async function action74(opts) {
     const result = await getAnalytics(requireCredentials(), name, {
       days: positiveInteger(this, opts.days, "--days"),
       planningDays: positiveInteger(this, opts.planningDays, "--planning-days"),
@@ -14953,7 +15971,7 @@ function urlsCommand() {
   return new Command("urls").description("Show storefront URL inventory from pageview analytics").option("-d, --days <n>", "Analytics window in days", "14").option("--host <host>", "Filter inventory to one host").option("--contains <substring>", "Server-side path substring filter").option(
     "--match <regex>",
     "Client-side regex filter; exhausts inventory pages before filtering"
-  ).option("--limit <n>", "Maximum rows to print", "50").action(async function action71(opts) {
+  ).option("--limit <n>", "Maximum rows to print", "50").action(async function action74(opts) {
     const creds = requireCredentials();
     const days = positiveInteger(this, opts.days, "--days") ?? 14;
     const displayLimit = Math.min(200, positiveInteger(this, opts.limit, "--limit") ?? 50);
@@ -15147,10 +16165,10 @@ function decodeBody(raw, header, limits, hostname, inputTruncated = false) {
     const chunks = [];
     let bytes = 0;
     let settled = false;
-    const settle = (action71) => {
+    const settle = (action74) => {
       if (settled) return;
       settled = true;
-      action71();
+      action74();
     };
     stream.on("data", (chunk) => {
       if (settled) return;
@@ -15221,11 +16239,11 @@ function pinnedFetch(url, addresses, limits) {
       else callback(null, addresses[0], (0, import_node_net.isIP)(addresses[0]));
     };
     let settled = false;
-    const settle = (action71) => {
+    const settle = (action74) => {
       if (settled) return;
       settled = true;
       clearTimeout(deadline);
-      action71();
+      action74();
     };
     const req = send3(
       url,
@@ -15560,7 +16578,7 @@ async function checkServedConfig(configUrl, workerBaseUrl, workerBaseSource) {
 var installCommand = new Command("install").description("Check Apex storefront installation").command("check").description("Verify snippet, served config, and recent tracking for the current shop").option("--url <url>", "Check one explicit bound storefront URL").option("--shop-id <id>", "Apex shop ID to verify (falls back to DRIP_SHOP_ID)").option(
   "--worker-url <url>",
   "Apex Worker base URL that serves /config (defaults to the URL in the served snippet, then DRIP_WORKER_URL, then the production worker)"
-).option("--environment <key>", "Environment key to request from the worker", "production").action(async function action58(opts) {
+).option("--environment <key>", "Environment key to request from the worker", "production").action(async function action61(opts) {
   const creds = requireCredentials();
   const shopId = opts.shopId?.trim() || process.env.DRIP_SHOP_ID?.trim() || null;
   if (!shopId)
@@ -15860,11 +16878,11 @@ function write(name) {
   });
   return c;
 }
-function lifecycle(action71) {
-  return new Command(action71).description(`${action71[0].toUpperCase()}${action71.slice(1)} a flag`).argument("<id>").action(async function(id) {
-    const r = await transitionManagedDelivery(requireCredentials(), kind, id, action71);
+function lifecycle(action74) {
+  return new Command(action74).description(`${action74[0].toUpperCase()}${action74.slice(1)} a flag`).argument("<id>").action(async function(id) {
+    const r = await transitionManagedDelivery(requireCredentials(), kind, id, action74);
     if (!r.ok || !r.data)
-      fail(this, r.error ?? `Failed to ${action71}`, classifyStatus(r.status), r.errorDetails);
+      fail(this, r.error ?? `Failed to ${action74}`, classifyStatus(r.status), r.errorDetails);
     output(this, { flag: r.data }, () => detail(r.data));
   });
 }
@@ -15902,13 +16920,74 @@ function parse(command, value) {
     );
   }
 }
-function detail2(x) {
+function collect2(value, previous) {
+  return [...previous, value];
+}
+function customFieldsRecord(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+function typedFieldValue(definition, raw) {
+  if (raw === "null") return null;
+  if (raw.trim() === "") return null;
+  switch (definition?.type) {
+    case "number": {
+      const parsed = Number(raw.trim());
+      return Number.isFinite(parsed) ? parsed : raw;
+    }
+    case "boolean": {
+      const trimmed = raw.trim().toLowerCase();
+      if (["true", "yes", "y", "1"].includes(trimmed)) return true;
+      if (["false", "no", "n", "0"].includes(trimmed)) return false;
+      return raw;
+    }
+    default:
+      return raw;
+  }
+}
+async function customFieldsFromPairs(command, pairs) {
+  if (pairs.length === 0) return void 0;
+  const parsedPairs = pairs.map((pair) => {
+    const separator = pair.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) };
+  });
+  const fields3 = await listBacklogFields(requireCredentials());
+  if (!fields3.ok || !fields3.data) {
+    process.stderr.write(
+      `Could not read the shop's field definitions (${fields3.error ?? `HTTP ${fields3.status}`}). Sending every --field value as text, so a number or yes/no field will answer 422. Add the backlog:read scope to this key to type them.
+`
+    );
+  }
+  const byKey = new Map(
+    (fields3.ok && fields3.data ? fields3.data.data : []).map((field) => [field.key, field])
+  );
+  const values = {};
+  for (const { key, raw } of parsedPairs) values[key] = typedFieldValue(byKey.get(key), raw);
+  return values;
+}
+function detail2(x, labels) {
   console.log();
   console.log(source_default.bold(String(x.title ?? x.label ?? x.key ?? x.id)));
   console.log(`  ID: ${source_default.dim(x.id)}`);
   if (x.status) console.log(`  State: ${x.status}`);
+  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)}`);
+    }
+  }
   console.log();
 }
+async function fieldLabels(command, item) {
+  if (shouldUseJson(command)) return /* @__PURE__ */ new Map();
+  if (Object.keys(customFieldsRecord(item.custom_fields)).length === 0) return /* @__PURE__ */ new Map();
+  const fields3 = await listBacklogFields(requireCredentials());
+  return new Map(
+    (fields3.ok && fields3.data ? fields3.data.data : []).map((field) => [field.key, field.label])
+  );
+}
 var list7 = new Command("list").alias("ls").description("List backlog").option("-n, --limit <n>", "Max results", "50").option("--cursor <cursor>", "Continue from cursor").option("--include-archived", "Include archived backlog items").action(async function(o) {
   const r = await listInsights(
     requireCredentials(),
@@ -15937,27 +17016,35 @@ var get6 = new Command("get").description("Get a backlog item").argument("<id>",
   const r = await getInsight(requireCredentials(), kind2, id);
   if (!r.ok || !r.data)
     fail(this, r.error ?? "Failed to get", classifyStatus(r.status), r.errorDetails);
-  output(this, { backlog_item: r.data }, () => detail2(r.data));
+  const labels = await fieldLabels(this, r.data);
+  output(this, { backlog_item: r.data }, () => detail2(r.data, labels));
 });
-function write2(action71) {
-  const c = new Command(action71).description(
-    `${action71 === "create" ? "Create" : "Update"} a ${singular}`
+function write2(action74) {
+  const c = new Command(action74).description(
+    `${action74 === "create" ? "Create" : "Update"} a ${singular}`
   );
-  if (action71 === "update") c.argument("<id>", `${singular} ID`);
-  c.argument("[json]", "Inline JSON, @file, or file path").option(
-    "--file <path>",
-    "JSON body file"
+  if (action74 === "update") c.argument("<id>", `${singular} ID`);
+  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,
+    []
   );
   c.action(async function(...args) {
     const o = this.opts();
-    const id = action71 === "update" ? String(args[0]) : void 0;
-    const raw = o.file ? `@${o.file}` : String(args[action71 === "update" ? 1 : 0] ?? "") || void 0;
+    const id = action74 === "update" ? String(args[0]) : void 0;
+    const raw = o.file ? `@${o.file}` : String(args[action74 === "update" ? 1 : 0] ?? "") || void 0;
     const body5 = parse(this, raw);
+    const customFields = await customFieldsFromPairs(this, o.field);
+    if (customFields) {
+      body5.custom_fields = { ...customFieldsRecord(body5.custom_fields), ...customFields };
+    }
     if (!Object.keys(body5).length) fail(this, "Provide a JSON body.", EXIT_CODES.validation);
-    const r = action71 === "create" ? await createInsight(requireCredentials(), kind2, body5) : await updateInsight(requireCredentials(), kind2, id, body5);
+    const r = action74 === "create" ? await createInsight(requireCredentials(), kind2, body5) : await updateInsight(requireCredentials(), kind2, id, body5);
     if (!r.ok || !r.data)
-      fail(this, r.error ?? `Failed to ${action71}`, classifyStatus(r.status), r.errorDetails);
-    output(this, { backlog_item: r.data }, () => detail2(r.data));
+      fail(this, r.error ?? `Failed to ${action74}`, classifyStatus(r.status), r.errorDetails);
+    const labels = await fieldLabels(this, r.data);
+    output(this, { backlog_item: r.data }, () => detail2(r.data, labels));
   });
   return c;
 }
@@ -16002,7 +17089,99 @@ var remove2 = new Command("delete").description("Delete a backlog item").argumen
     fail(this, r.error ?? "Failed to delete", classifyStatus(r.status), r.errorDetails);
   output(this, { deleted: true, id }, () => console.log(`Deleted ${id}`));
 });
-var backlogCommand = new Command("backlog").description("Manage backlog").addCommand(list7).addCommand(get6).addCommand(write2("create")).addCommand(write2("update")).addCommand(archive).addCommand(restore).addCommand(remove2);
+function fieldDetail(field) {
+  console.log();
+  console.log(source_default.bold(field.label));
+  console.log(`  ID: ${source_default.dim(field.id)}`);
+  console.log(`  Key: ${field.key}`);
+  console.log(`  Type: ${field.type}`);
+  if (field.options.length > 0) console.log(`  Choices: ${field.options.join(", ")}`);
+  console.log(`  Required: ${field.required ? "yes" : "no"}`);
+  console.log(`  Visible to clients: ${field.client_visible ? "yes" : "no"}`);
+  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();
+  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);
+}
+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);
+  if (!r.ok || !r.data)
+    fail(this, r.error ?? "Failed to list fields", classifyStatus(r.status), r.errorDetails);
+  output(
+    this,
+    { fields: r.data.data },
+    () => printTable(
+      ["KEY", "LABEL", "TYPE", "REQUIRED", "CLIENT"],
+      r.data.data.map((field) => [
+        field.key,
+        field.label,
+        field.type,
+        field.required ? "yes" : "no",
+        field.client_visible ? "yes" : "no"
+      ]),
+      [24, 28, 14, 10, 8]
+    )
+  );
+});
+var fieldsCreate = new Command("create").description("Add an idea field").requiredOption("--label <text>", "What the field is called").requiredOption(
+  "--type <type>",
+  "short_text, long_text, number, boolean, single_choice, date, url or person"
+).option("--key <key>", "Field key; derived from the label when omitted").option(
+  "--option <value>",
+  "A choice for a single_choice field; repeatable",
+  collect2,
+  []
+).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);
+  const clientVisible = boolOption(this, "--client-visible", o.clientVisible);
+  const r = await createBacklogField(requireCredentials(), {
+    label: o.label,
+    type: o.type,
+    ...o.key ? { key: o.key } : {},
+    ...o.option.length > 0 ? { options: o.option } : {},
+    ...required === void 0 ? {} : { required },
+    ...clientVisible === void 0 ? {} : { client_visible: clientVisible }
+  });
+  if (!r.ok || !r.data)
+    fail(this, r.error ?? "Failed to create field", classifyStatus(r.status), r.errorDetails);
+  output(this, { field: r.data }, () => fieldDetail(r.data));
+});
+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,
+  []
+).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);
+  const clientVisible = boolOption(this, "--client-visible", o.clientVisible);
+  const archived = boolOption(this, "--archived", o.archived);
+  const body5 = {
+    ...o.label ? { label: o.label } : {},
+    ...o.option.length > 0 ? { options: o.option } : {},
+    ...required === void 0 ? {} : { required },
+    ...clientVisible === void 0 ? {} : { client_visible: clientVisible },
+    ...archived === void 0 ? {} : { archived }
+  };
+  if (!Object.keys(body5).length)
+    fail(this, "Provide at least one field option to change.", EXIT_CODES.validation);
+  const r = await updateBacklogField(requireCredentials(), id, body5);
+  if (!r.ok || !r.data)
+    fail(this, r.error ?? "Failed to update field", classifyStatus(r.status), r.errorDetails);
+  output(this, { field: r.data }, () => fieldDetail(r.data));
+});
+var fieldsArchive = new Command("archive").description("Archive an idea field; values already on ideas are kept").argument("<id>", "field ID").action(async function(id) {
+  const r = await archiveBacklogField(requireCredentials(), id);
+  if (!r.ok || !r.data)
+    fail(this, r.error ?? "Failed to archive field", classifyStatus(r.status), r.errorDetails);
+  output(this, { field: r.data }, () => fieldDetail(r.data));
+});
+var fields2 = new Command("fields").description("Manage the shop's own idea fields").addCommand(fieldsList).addCommand(fieldsCreate).addCommand(fieldsUpdate).addCommand(fieldsArchive);
+var backlogCommand = new Command("backlog").description("Manage backlog").addCommand(list7).addCommand(get6).addCommand(write2("create")).addCommand(write2("update")).addCommand(archive).addCommand(restore).addCommand(remove2).addCommand(fields2);
 
 // src/commands/signals.ts
 var import_node_fs19 = __toESM(require("node:fs"));
@@ -16064,24 +17243,24 @@ var get7 = new Command("get").description("Get a signal").argument("<id>", "sign
     fail(this, r.error ?? "Failed to get", classifyStatus(r.status), r.errorDetails);
   output(this, { signal: r.data }, () => detail3(r.data));
 });
-function write3(action71) {
-  const c = new Command(action71).description(
-    `${action71 === "create" ? "Create" : "Update"} a ${singular2}`
+function write3(action74) {
+  const c = new Command(action74).description(
+    `${action74 === "create" ? "Create" : "Update"} a ${singular2}`
   );
-  if (action71 === "update") c.argument("<id>", `${singular2} ID`);
+  if (action74 === "update") c.argument("<id>", `${singular2} ID`);
   c.argument("[json]", "Inline JSON, @file, or file path").option(
     "--file <path>",
     "JSON body file"
   );
   c.action(async function(...args) {
     const o = this.opts();
-    const id = action71 === "update" ? String(args[0]) : void 0;
-    const raw = o.file ? `@${o.file}` : String(args[action71 === "update" ? 1 : 0] ?? "") || void 0;
+    const id = action74 === "update" ? String(args[0]) : void 0;
+    const raw = o.file ? `@${o.file}` : String(args[action74 === "update" ? 1 : 0] ?? "") || void 0;
     const body5 = parse2(this, raw);
     if (!Object.keys(body5).length) fail(this, "Provide a JSON body.", EXIT_CODES.validation);
-    const r = action71 === "create" ? await createInsight(requireCredentials(), kind3, body5) : await updateInsight(requireCredentials(), kind3, id, body5);
+    const r = action74 === "create" ? await createInsight(requireCredentials(), kind3, body5) : await updateInsight(requireCredentials(), kind3, id, body5);
     if (!r.ok || !r.data)
-      fail(this, r.error ?? `Failed to ${action71}`, classifyStatus(r.status), r.errorDetails);
+      fail(this, r.error ?? `Failed to ${action74}`, classifyStatus(r.status), r.errorDetails);
     output(this, { signal: r.data }, () => detail3(r.data));
   });
   return c;
@@ -16173,11 +17352,11 @@ function write4(name) {
   });
   return c;
 }
-function lifecycle2(action71) {
-  return new Command(action71).description(`${action71[0].toUpperCase()}${action71.slice(1)} a personalization`).argument("<id>").action(async function(id) {
-    const r = await transitionManagedDelivery(requireCredentials(), kind4, id, action71);
+function lifecycle2(action74) {
+  return new Command(action74).description(`${action74[0].toUpperCase()}${action74.slice(1)} a personalization`).argument("<id>").action(async function(id) {
+    const r = await transitionManagedDelivery(requireCredentials(), kind4, id, action74);
     if (!r.ok || !r.data)
-      fail(this, r.error ?? `Failed to ${action71}`, classifyStatus(r.status), r.errorDetails);
+      fail(this, r.error ?? `Failed to ${action74}`, classifyStatus(r.status), r.errorDetails);
     output(this, { personalization: r.data }, () => detail4(r.data));
   });
 }
@@ -16259,21 +17438,21 @@ function targetingResourceCommand(kind5) {
         );
       })
     );
-  for (const action71 of ["create", "update"]) {
-    const command = new Command(action71).description(
-      `${action71 === "create" ? "Create" : "Update"} a ${singular3}`
+  for (const action74 of ["create", "update"]) {
+    const command = new Command(action74).description(
+      `${action74 === "create" ? "Create" : "Update"} a ${singular3}`
     );
-    if (action71 === "update") command.argument("<id>");
+    if (action74 === "update") command.argument("<id>");
     command.argument("[json]", "Inline JSON, @file, or file path").option("--file <path>", "JSON body file").action(async function(...args) {
       const opts = this.opts();
-      const id = action71 === "update" ? String(args[0]) : void 0;
-      const value = opts.file ? `@${opts.file}` : String(args[action71 === "update" ? 1 : 0] ?? "") || void 0;
+      const id = action74 === "update" ? String(args[0]) : void 0;
+      const value = opts.file ? `@${opts.file}` : String(args[action74 === "update" ? 1 : 0] ?? "") || void 0;
       const requestBody = body3(this, value);
-      if (action71 === "update" && typeof requestBody === "object" && requestBody !== null && !Array.isArray(requestBody) && Object.keys(requestBody).length === 0)
+      if (action74 === "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(
         requireCredentials(),
-        action71 === "create" ? "POST" : "PATCH",
+        action74 === "create" ? "POST" : "PATCH",
         kind5,
         id,
         requestBody
@@ -16281,7 +17460,7 @@ function targetingResourceCommand(kind5) {
       if (!response.ok || !response.data)
         fail(
           this,
-          response.error ?? `Failed to ${action71}`,
+          response.error ?? `Failed to ${action74}`,
           classifyStatus(response.status),
           response.errorDetails
         );
@@ -16290,7 +17469,7 @@ function targetingResourceCommand(kind5) {
         {
           [kind5 === "exclusion-groups" ? "exclusion_group" : singular3]: response.data
         },
-        () => console.log(source_default.green(`${action71}d ${singular3}`))
+        () => console.log(source_default.green(`${action74}d ${singular3}`))
       );
     });
     root.addCommand(command);
@@ -16364,7 +17543,7 @@ var exclusionGroupsCommand = targetingResourceCommand("exclusion-groups");
 // src/commands/brand.ts
 init_source();
 var NO_PROFILE_MESSAGE = "No brand profile yet \u2014 run onboarding or a site check";
-var brandCommand = new Command("brand").description("Print the shop brand context for external agents").action(async function action59() {
+var brandCommand = new Command("brand").description("Print the shop brand context for external agents").action(async function action62() {
   const creds = requireCredentials();
   const res = await getBrandContext(creds);
   if (res.status === 404) {
@@ -16397,7 +17576,7 @@ var brandCommand = new Command("brand").description("Print the shop brand contex
 
 // src/commands/targeting.ts
 init_source();
-var test2 = new Command("test").description("Evaluate experiment URL targeting for a page").argument("<url>", "URL to evaluate").option("--status <status>", "Comma-separated statuses to include, or all", "all").action(async function action60(url, opts) {
+var test2 = new Command("test").description("Evaluate experiment URL targeting for a page").argument("<url>", "URL to evaluate").option("--status <status>", "Comma-separated statuses to include, or all", "all").action(async function action63(url, opts) {
   const creds = requireCredentials();
   const res = await testTargeting(creds, url, { status: opts.status });
   if (!res.ok || !res.data) {
@@ -16482,7 +17661,7 @@ var create4 = new Command("create").description("Create an Apex SOS ticket").opt
   "--type <type>",
   "full_handover|design|development|qa|config|bug|help (internal types require a DRIP account)",
   "qa"
-).option("--loom <url>", "Loom URL with reproduction or QA context").option("--experiment <id>", "Experiment ID").option("--sub-class <text>", "SOS sub-classification").option("--description <text-or-@file>", "Description text or @path").argument("[description]", "Description text").action(async function action61(descriptionArg, opts) {
+).option("--loom <url>", "Loom URL with reproduction or QA context").option("--experiment <id>", "Experiment ID").option("--sub-class <text>", "SOS sub-classification").option("--description <text-or-@file>", "Description text or @path").argument("[description]", "Description text").action(async function action64(descriptionArg, opts) {
   if (!SOS_TYPES.has(opts.type)) {
     fail(
       this,
@@ -16509,7 +17688,7 @@ var create4 = new Command("create").description("Create an Apex SOS ticket").opt
   }
   output(this, res.data, () => printCreatedTicket(res.data));
 });
-var mine = new Command("mine").description("List SOS tickets created by this API key").action(async function action62() {
+var mine = new Command("mine").description("List SOS tickets created by this API key").action(async function action65() {
   const creds = requireCredentials();
   const res = await listMySos(creds);
   if (!res.ok || !res.data) {
@@ -16658,7 +17837,7 @@ var create5 = new Command("create").description("Create a shop").argument("[json
   const r = await createShop(requireUserCredentials(), payload);
   done(this, r, "create shop");
 });
-var update3 = new Command("update").description("Update a shop").argument("<id>").argument("[json]", "Inline JSON, @file, or file path").option("--holdout-pct <percent>", "Platform-operator global holdout percent (0-10)").option("--holdout-enabled", "Enable the platform-operator global holdout v1 setting").option("--holdout-disabled", "Disable the platform-operator global holdout v1 setting").option("--confirm-tier", "Confirm a commercially sensitive tier change").action(async function(id, raw, o) {
+var update4 = new Command("update").description("Update a shop").argument("<id>").argument("[json]", "Inline JSON, @file, or file path").option("--holdout-pct <percent>", "Platform-operator global holdout percent (0-10)").option("--holdout-enabled", "Enable the platform-operator global holdout v1 setting").option("--holdout-disabled", "Disable the platform-operator global holdout v1 setting").option("--confirm-tier", "Confirm a commercially sensitive tier change").action(async function(id, raw, o) {
   const b = raw === void 0 ? {} : body4(this, raw);
   if (o.holdoutEnabled && o.holdoutDisabled)
     fail(this, "Use only one of --holdout-enabled or --holdout-disabled", EXIT_CODES.validation);
@@ -16791,7 +17970,7 @@ shopware.addCommand(
     );
   })
 );
-var shopsCommand = new Command("shops").description("Manage organization shops").addCommand(list12).addCommand(get9).addCommand(create5).addCommand(update3).addCommand(doctorCommand).addCommand(
+var shopsCommand = new Command("shops").description("Manage organization shops").addCommand(list12).addCommand(get9).addCommand(create5).addCommand(update4).addCommand(doctorCommand).addCommand(
   settings("auto-stop", "Read or update auto-stop defaults", { on: "enable", off: "disable" })
 ).addCommand(settings("testing-defaults", "Read or update testing defaults")).addCommand(settings("guardian", "Read or update guardian defaults", { on: "on", off: "off" })).addCommand(profile).addCommand(shopware);
 
@@ -16799,6 +17978,7 @@ var shopsCommand = new Command("shops").description("Manage organization shops")
 function optionSchema(option) {
   return {
     flags: option.flags,
+    ...option.argChoices ? { choices: option.argChoices } : {},
     description: option.description,
     required: option.required,
     optional: option.optional,
@@ -16824,7 +18004,7 @@ function commandSchema(command) {
   };
 }
 function createSchemaCommand(program3) {
-  return new Command("schema").description("Print the current Apex CLI command and flag schema").option("--json", "Print JSON schema").action(function action71() {
+  return new Command("schema").description("Print the current Apex CLI command and flag schema").option("--json", "Print JSON schema").action(function action74() {
     const schema = commandSchema(program3);
     output(this, schema, () => {
       process.stdout.write(`${JSON.stringify(schema, null, 2)}
@@ -17239,7 +18419,7 @@ ${event.event || "(unnamed event)"} [${event.dlName}] \u2014 ${event.count} obse
   return `${lines.join("\n")}
 `;
 }
-var discoverCommand = new Command("discover").description("Read back the tracking schema observed for the current shop").option("--minutes <n>", "Observation window in minutes").option("--gtm <url-or-id>", "Mine a public page or GTM container locally").option("--gtm-url <url>", "Fetch an explicit GTM container URL, including first-party proxies").option("--create-dimension <path>", "Create a custom dimension from an observed dataLayer path").option("--event <name>", "Select the observed event when a path appears on multiple events").option("--key <signal-key>", "Override the dimension signal key").option("--label <text>", "Override the dimension label").action(async function action63(opts) {
+var discoverCommand = new Command("discover").description("Read back the tracking schema observed for the current shop").option("--minutes <n>", "Observation window in minutes").option("--gtm <url-or-id>", "Mine a public page or GTM container locally").option("--gtm-url <url>", "Fetch an explicit GTM container URL, including first-party proxies").option("--create-dimension <path>", "Create a custom dimension from an observed dataLayer path").option("--event <name>", "Select the observed event when a path appears on multiple events").option("--key <signal-key>", "Override the dimension signal key").option("--label <text>", "Override the dimension label").action(async function action66(opts) {
   if (opts.gtm && opts.gtmUrl)
     fail(this, "Use only one of --gtm or --gtm-url", EXIT_CODES.validation);
   if (opts.createDimension && (opts.gtm || opts.gtmUrl)) {
@@ -17442,7 +18622,7 @@ function installSkill(paths, targetRoot) {
   import_node_fs24.default.copyFileSync(paths.agents, import_node_path22.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 action64(opts) {
+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 action67(opts) {
   let paths;
   try {
     paths = skillPaths();
@@ -18066,7 +19246,7 @@ function selectedEvents(opts) {
 }
 var list14 = new Command("list").alias("ls").description(
   "List webhooks. JSON includes availableEvents; secrets are never returned after create."
-).action(async function action65() {
+).action(async function action68() {
   const data = await loadWebhookIndex(this);
   output(this, data, () => printWebhooks(data.data));
 });
@@ -18075,7 +19255,7 @@ var create7 = new Command("create").description(`Create a webhook. Prints the si
   "Webhook event to subscribe to; repeat for multiple events",
   (value, previous = []) => [...previous, value],
   []
-).action(async function action66(opts) {
+).action(async function action69(opts) {
   const events = selectedEvents(opts);
   if (events.length === 0) fail(this, "At least one --event is required", EXIT_CODES.validation);
   const index = await loadWebhookIndex(this);
@@ -18107,7 +19287,7 @@ var create7 = new Command("create").description(`Create a webhook. Prints the si
     }
   );
 });
-var remove4 = new Command("delete").alias("rm").description("Delete a webhook").argument("<id>", "Webhook id").action(async function action67(id) {
+var remove4 = new Command("delete").alias("rm").description("Delete a webhook").argument("<id>", "Webhook id").action(async function action70(id) {
   requireShopSecretKey(this);
   const result = handleResult(
     this,
@@ -18116,7 +19296,7 @@ var remove4 = new Command("delete").alias("rm").description("Delete a webhook").
   );
   output(this, result, () => console.log(source_default.green(`Deleted webhook ${id}`)));
 });
-var deliveries = new Command("deliveries").description("List webhook deliveries including failure and disabled state").argument("<id>", "Webhook id").option("--limit <n>", "Maximum deliveries to show", "20").action(async function action68(id, opts) {
+var deliveries = new Command("deliveries").description("List webhook deliveries including failure and disabled state").argument("<id>", "Webhook id").option("--limit <n>", "Maximum deliveries to show", "20").action(async function action71(id, opts) {
   const limit = Number.parseInt(opts.limit, 10);
   if (!Number.isInteger(limit) || limit < 1)
     fail(this, "--limit must be a positive integer", EXIT_CODES.validation);
@@ -18128,12 +19308,12 @@ var deliveries = new Command("deliveries").description("List webhook deliveries
   );
   output(this, result, () => printDeliveries(result.data, result.webhook));
 });
-var update4 = new Command("update").description("Update a webhook URL, events, or active state").argument("<id>", "Webhook id").option("--url <url>", "HTTPS callback URL").option(
+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],
   []
-).option("--active", "Enable the webhook").option("--inactive", "Disable the webhook").action(async function action69(id, opts) {
+).option("--active", "Enable the webhook").option("--inactive", "Disable the webhook").action(async function action72(id, opts) {
   if (opts.active && opts.inactive)
     fail(this, "Use only one of --active or --inactive", EXIT_CODES.validation);
   const events = selectedEvents(opts);
@@ -18166,7 +19346,7 @@ var update4 = new Command("update").description("Update a webhook URL, events, o
   );
   output(this, { webhook: result }, () => printWebhooks([result]));
 });
-var test3 = new Command("test").description("Send a signed test event to a webhook").argument("<id>", "Webhook id").action(async function action70(id) {
+var test3 = new Command("test").description("Send a signed test event to a webhook").argument("<id>", "Webhook id").action(async function action73(id) {
   requireShopSecretKey(this);
   const result = handleResult(
     this,
@@ -18181,7 +19361,7 @@ var test3 = new Command("test").description("Send a signed test event to a webho
     )
   );
 });
-var webhooksCommand = new Command("webhooks").description("Manage shop webhooks").addCommand(list14).addCommand(create7).addCommand(update4).addCommand(remove4).addCommand(deliveries).addCommand(test3);
+var webhooksCommand = new Command("webhooks").description("Manage shop webhooks").addCommand(list14).addCommand(create7).addCommand(update5).addCommand(remove4).addCommand(deliveries).addCommand(test3);
 
 // src/commands/simulate.ts
 init_source();