@drip-apex/apex-cli 0.6.2 → 0.7.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)
@@ -6988,14 +6988,14 @@ var init_open = __esm({
       }
       const subprocess = import_node_child_process5.default.spawn(command, cliArguments, childProcessOptions);
       if (options.wait) {
-        return new Promise((resolve, reject) => {
+        return new Promise((resolve2, reject) => {
           subprocess.once("error", reject);
           subprocess.once("close", (exitCode) => {
             if (!options.allowNonzeroExitCode && exitCode > 0) {
               reject(new Error(`Exited with code ${exitCode}`));
               return;
             }
-            resolve(subprocess);
+            resolve2(subprocess);
           });
         });
       }
@@ -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.2",
+  version: "0.7.0",
   license: "MIT",
   description: "Apex CLI for managing experiments, approved roadmap ideas, and draft workspaces.",
   private: false,
@@ -7754,6 +7754,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 +7790,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 +8137,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 +8156,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 +8316,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);
@@ -8369,9 +8406,9 @@ function resolveSelection(tree, input) {
 function ask(question) {
   const rl = import_node_readline.default.createInterface({ input: process.stdin, output: process.stderr });
   return new Promise(
-    (resolve) => rl.question(question, (answer) => {
+    (resolve2) => rl.question(question, (answer) => {
       rl.close();
-      resolve(answer.trim());
+      resolve2(answer.trim());
     })
   );
 }
@@ -8449,7 +8486,7 @@ function prompt(question, hide = false) {
   if (!process.stdin.isTTY || !process.stdout.isTTY) {
     throw new Error("Interactive input is unavailable in non-TTY mode.");
   }
-  return new Promise((resolve) => {
+  return new Promise((resolve2) => {
     const rl = import_node_readline2.default.createInterface({
       input: process.stdin,
       output: process.stderr
@@ -8469,13 +8506,13 @@ function prompt(question, hide = false) {
         stdout.write = originalWrite;
         console.error();
         rl.close();
-        resolve(answer.trim());
+        resolve2(answer.trim());
       });
       masking = true;
     } else {
       rl.question(question, (answer) => {
         rl.close();
-        resolve(answer.trim());
+        resolve2(answer.trim());
       });
     }
   });
@@ -8501,7 +8538,7 @@ function parseFormBody(body5) {
 async function waitForBrowserLogin(baseUrl, userMode = false) {
   const state = import_node_crypto2.default.randomBytes(24).toString("base64url");
   const clientName = import_node_os5.default.hostname() || "Local machine";
-  return new Promise((resolve, reject) => {
+  return new Promise((resolve2, reject) => {
     let settled = false;
     let timeout = null;
     const finish = (err, apiKey) => {
@@ -8513,7 +8550,7 @@ async function waitForBrowserLogin(baseUrl, userMode = false) {
       } catch {
       }
       if (err) reject(err);
-      else resolve(apiKey ?? "");
+      else resolve2(apiKey ?? "");
     };
     const server = import_node_http.default.createServer((req, res) => {
       if (req.method === "OPTIONS") {
@@ -8835,6 +8872,34 @@ 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"
+];
+
 // ../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 +8937,92 @@ function buildQaPreviewUrl2(storeUrl, experimentId, variationId) {
   return url;
 }
 
+// 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 };
+}
+
 // src/lib/asset-upload.ts
 var import_node_crypto3 = __toESM(require("node:crypto"));
 var import_node_fs6 = __toESM(require("node:fs"));
@@ -9072,8 +9223,17 @@ function printExperiment(exp) {
   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 +9282,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)}`);
@@ -9335,6 +9510,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) {
@@ -9414,8 +9590,8 @@ async function confirmApply(message) {
   }
   const readline3 = await import("node:readline");
   const rl = readline3.createInterface({ input: process.stdin, output: process.stderr });
-  const answer = await new Promise((resolve) => {
-    rl.question(source_default.yellow(`${message} [y/N] `), resolve);
+  const answer = await new Promise((resolve2) => {
+    rl.question(source_default.yellow(`${message} [y/N] `), resolve2);
   });
   rl.close();
   return answer.toLowerCase() === "y";
@@ -9430,8 +9606,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 {
@@ -9563,7 +9760,40 @@ var get = new Command("get").description("Get experiment details by ID or slug")
   }
   output(this, { experiment: exp }, () => printExperiment(exp));
 });
-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 ID or slug").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 ID or slug").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 ID or slug").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 +9824,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 ID or slug").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];
 }
@@ -9623,7 +9909,9 @@ function sourceStoreUrl(sourceRules) {
   }
   return null;
 }
-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(
+var create = new Command("create").description("Create a new experiment").addOption(
+  new Option("--counting-type <type>", "Experiment classification").choices(countingTypes).default("standard")
+).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(
   "--source-url <pattern>",
   "Positive source URL rule (repeatable; accepts exact URLs, paths, or wildcards)",
   collectCreateOption,
@@ -9633,7 +9921,7 @@ var create = new Command("create").description("Create a new experiment").requir
   "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").action(async function action9(opts) {
   if (opts.type !== "mutation" && opts.type !== "redirect") {
     fail(this, "--type must be mutation or redirect", EXIT_CODES.validation);
   }
@@ -9666,50 +9954,23 @@ var create = new Command("create").description("Create a new experiment").requir
   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 spinner = await createSpinner("Creating experiment...");
@@ -9718,8 +9979,10 @@ var create = new Command("create").description("Create a new experiment").requir
     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: sourceStoreUrl(sourceRules),
       targeting: {
@@ -9761,11 +10024,16 @@ var create = new Command("create").description("Create a new experiment").requir
   );
   output(
     this,
-    { outcome, backlog_item_id: backlogItemId ?? null, experiment: res.data },
+    {
+      outcome,
+      backlog_item_id: backlogItemId ?? null,
+      idea_key: ideaKey ?? null,
+      experiment: res.data
+    },
     () => printExperiment(res.data)
   );
 });
-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 ID or slug").action(async function action10(idOrSlug) {
   const creds = requireCredentials();
   const spinner = await createSpinner("Pausing experiment...");
   const exp = await resolveExperiment(idOrSlug);
@@ -9787,7 +10055,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 ID or slug").action(async function action11(idOrSlug) {
   const creds = requireCredentials();
   const spinner = await createSpinner("Completing experiment...");
   const exp = await resolveExperiment(idOrSlug);
@@ -9809,7 +10077,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 ID or slug").option("-f, --force", "Skip confirmation").action(async function action12(idOrSlug, opts) {
   const creds = requireCredentials();
   const exp = await resolveExperiment(idOrSlug);
   if (!exp) {
@@ -9828,8 +10096,8 @@ var del = new Command("delete").alias("rm").description("Delete an experiment").
       input: process.stdin,
       output: process.stderr
     });
-    const answer = await new Promise((resolve) => {
-      rl.question(source_default.yellow(`Delete experiment "${exp.name}" (${exp.id})? [y/N] `), resolve);
+    const answer = await new Promise((resolve2) => {
+      rl.question(source_default.yellow(`Delete experiment "${exp.name}" (${exp.id})? [y/N] `), resolve2);
     });
     rl.close();
     if (answer.toLowerCase() !== "y") {
@@ -9854,7 +10122,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 ID or slug").option("--out <path>", "Target folder").action(async function action13(idOrSlug, opts) {
   const creds = requireCredentials();
   const spinner = await createSpinner("Pulling experiment filesystem...");
   try {
@@ -9895,7 +10163,7 @@ 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);
@@ -9920,7 +10188,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,11 +10201,13 @@ 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").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 files = await rewriteExperimentFilesystemAssets({
       files: listExperimentFilesystemFiles(folder, session),
       folder,
@@ -9960,7 +10235,8 @@ 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) {
@@ -9971,19 +10247,20 @@ var applyFilesystem = new Command("apply").description("Apply experiment filesys
           experimentId: session.experimentId,
           applied: false,
           plan: planRes.data,
+          requiredAcknowledgment: planRes.data.invalidatesQa ? "accept-qa-invalidation" : null,
           message: "No changes."
         },
         () => printFilesystemPlan(planRes.data)
       );
       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) {
@@ -10011,11 +10288,32 @@ 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,
+        receipt: res.data?.receipt ?? null,
         previewUrls
       },
       () => {
         printFilesystemPlan(planRes.data);
+        const receipt = res.data?.receipt;
+        if (receipt) {
+          console.log("\nReceipt");
+          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);
       }
     );
@@ -10024,7 +10322,7 @@ 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, or slug", ".").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 +10346,13 @@ 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, or slug", ".").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 +10378,19 @@ 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, or slug", ".").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 +10402,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 +10420,28 @@ 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, or slug", ".").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 +10454,31 @@ 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, or slug", ".").action(async function action20(target) {
   const creds = requireCredentials();
   const spinner = await createSpinner("Reopening QA...");
   try {
@@ -10214,7 +10536,9 @@ 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, 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").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 +10547,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 +10598,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 +10623,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(
   "--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,
+        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,
-        `Ambiguous --variations value "${ref}" matches: ${matches.join("; ")}. Use a variation ID or slug.`,
+        `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(
-      (resolve) => setTimeout(resolve, Math.min(delayMs, Math.max(0, deadline - screenshotNow())))
+      (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 +10887,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 +10917,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 +10999,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 +11093,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 +11111,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");
@@ -10938,11 +11450,11 @@ function cleanupResetJs(experiment) {
 }
 function runAbHarness(args, cwd) {
   const bin = process.env.AB_HARNESS_BIN || "ab-harness";
-  return new Promise((resolve, reject) => {
+  return new Promise((resolve2, reject) => {
     const child = (0, import_node_child_process6.spawn)(bin, args, { cwd, stdio: "inherit" });
     child.on("error", reject);
     child.on("exit", (code) => {
-      if (code === 0) resolve();
+      if (code === 0) resolve2();
       else reject(new Error(`${bin} ${args.join(" ")} exited with ${code}`));
     });
   });
@@ -11028,7 +11540,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 +11560,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 +11627,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 +12002,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 +12052,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 +12084,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 +12163,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 +12207,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 +12261,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 +12480,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 +12737,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 +12761,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 +12787,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 +12822,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 +12904,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)
@@ -12416,7 +12928,7 @@ var suggest = new Command("suggest").description("Suggest goals and funnels from
       const readline3 = await import("node:readline");
       const rl = readline3.createInterface({ input: process.stdin, output: process.stderr });
       const answer = await new Promise(
-        (resolve) => rl.question(source_default.yellow("Create this goal? [y/N] "), resolve)
+        (resolve2) => rl.question(source_default.yellow("Create this goal? [y/N] "), resolve2)
       );
       rl.close();
       if (answer.toLowerCase() !== "y") continue;
@@ -12440,7 +12952,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 +12994,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 +13013,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 +13027,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 +13040,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 +13051,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 +13075,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 +13136,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 +13187,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 +13251,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 +13276,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(
@@ -12778,9 +13290,219 @@ var off = new Command("off").description("Disable consent gating").action(async
 });
 var consentCommand = new Command("consent").description("Manage consent gating").addCommand(get2).addCommand(set).addCommand(off);
 
+// src/commands/project-code.ts
+var import_node_fs15 = require("node:fs");
+var import_node_path13 = require("node:path");
+
+// src/commands/runtime-settings-shop.ts
+var uuidPattern = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+async function identifyRuntimeSettingsShop(command, requested) {
+  let credentials = requireCredentials();
+  if (credentials.credentialKind === "user") {
+    let shopId = requested;
+    if (!uuidPattern.test(requested)) {
+      const context = await getAccountContext({
+        ...credentials,
+        resolvedContext: { ...credentials.resolvedContext, shopId: void 0 }
+      });
+      if (!context.ok || !context.data)
+        fail(command, context.error ?? "Shop discovery failed", classifyStatus(context.status));
+      const match2 = context.data.data.orgs.flatMap((org) => org.shops).find((shop) => shop.domain.toLowerCase() === requested.toLowerCase());
+      if (!match2)
+        fail(command, "--shop domain is not available to this user", EXIT_CODES.validation);
+      shopId = match2.id;
+    }
+    credentials = { ...credentials, resolvedContext: { ...credentials.resolvedContext, shopId } };
+  }
+  const response = await getInstallDomains(credentials);
+  if (!response.ok || !response.data)
+    fail(command, response.error ?? "Shop identity unavailable", classifyStatus(response.status));
+  const { shop_id, domain } = response.data;
+  if (credentials.credentialKind === "user" && shop_id.toLowerCase() !== credentials.resolvedContext?.shopId?.toLowerCase()) {
+    fail(
+      command,
+      "Shop identity does not match the requested user-key context",
+      EXIT_CODES.validation
+    );
+  }
+  if (requested.toLowerCase() !== shop_id.toLowerCase() && requested.toLowerCase() !== domain.toLowerCase()) {
+    fail(command, "--shop does not match the authenticated shop", EXIT_CODES.validation);
+  }
+  setEnvelopeContext({ shop_id, credential: credentials.credentialKind ?? "shop" });
+  return { shop_id, domain, credentials };
+}
+
+// src/commands/project-code.ts
+var fields = ["enabled", "css", "helperJs", "js"];
+function readPatch(command, file) {
+  let input;
+  try {
+    input = JSON.parse((0, import_node_fs15.readFileSync)(file, "utf8"));
+  } catch (error) {
+    fail(command, `Cannot read project code JSON: ${String(error)}`, EXIT_CODES.validation);
+  }
+  if (!input || typeof input !== "object" || Array.isArray(input) || Object.keys(input).length === 0) {
+    fail(command, "Project code must be a nonempty partial object", EXIT_CODES.validation);
+  }
+  for (const [key, value] of Object.entries(input)) {
+    if (!fields.includes(key))
+      fail(command, `Unknown project code field: ${key}`, EXIT_CODES.validation);
+    if (key === "enabled" ? typeof value !== "boolean" : value !== null && (typeof value !== "string" || value.length > 2e4)) {
+      fail(
+        command,
+        `${key} must be ${key === "enabled" ? "a boolean" : "null or a string of at most 20,000 characters"}`,
+        EXIT_CODES.validation
+      );
+    }
+  }
+  return input;
+}
+async function readCurrent(command, shop) {
+  const response = await getRuntimeSettings(shop.credentials);
+  if (!response.ok || !response.data)
+    fail(
+      command,
+      response.error ?? "Runtime settings read failed",
+      classifyStatus(response.status)
+    );
+  const data = response.data;
+  if (data.shop_id !== shop.shop_id)
+    fail(command, "Runtime settings returned a different shop", EXIT_CODES.validation);
+  const projectCode = data.runtime_settings?.projectCode;
+  if (!projectCode || typeof projectCode.enabled !== "boolean" || [projectCode.css, projectCode.helperJs, projectCode.js].some(
+    (code) => typeof code !== "string"
+  ) || !(data.version === null || typeof data.version === "string" && data.version.length > 0)) {
+    fail(
+      command,
+      "Runtime settings must include complete project code and an opaque version",
+      EXIT_CODES.general
+    );
+  }
+  return { projectCode, version: data.version };
+}
+function effectiveDiff(before, patch) {
+  const after = { ...before };
+  if (patch.enabled !== void 0) after.enabled = patch.enabled;
+  for (const key of ["css", "helperJs", "js"]) {
+    if (patch[key] !== void 0) after[key] = patch[key]?.trim() || "";
+  }
+  const changedFields = fields.filter((field) => before[field] !== after[field]);
+  const changes = Object.fromEntries(
+    changedFields.map((field) => [field, { before: before[field], after: after[field] }])
+  );
+  return { changedFields, changes, before, after };
+}
+var projectCodeCommand = new Command("project-code").description(
+  "Inspect, preview, and back up shop project code"
+);
+projectCodeCommand.addCommand(
+  new Command("get").description("Read complete project code and its opaque version").requiredOption("--shop <domain-or-id>", "Shop domain or UUID").action(async (options, command) => {
+    const { credentials: _credentials, ...identity } = await identifyRuntimeSettingsShop(
+      command,
+      options.shop
+    );
+    const current = await readCurrent(command, { ...identity, credentials: _credentials });
+    output(
+      command,
+      { ...identity, ...current },
+      () => process.stdout.write(`${JSON.stringify({ ...identity, ...current }, null, 2)}
+`)
+    );
+  })
+);
+for (const mode of ["diff", "set"]) {
+  const command = new Command(mode).description(
+    mode === "diff" ? "Preview an effective partial project code change without writing" : "Back up prior code and apply a version-checked partial change"
+  ).requiredOption("--file <path>", "Partial projectCode JSON file").requiredOption("--shop <domain-or-id>", "Shop domain or UUID");
+  if (mode === "set")
+    command.requiredOption(
+      "--backup <path>",
+      "New backup file; an existing file is never replaced"
+    );
+  command.action(async (options, actionCommand) => {
+    const patch = readPatch(actionCommand, options.file);
+    const shop = await identifyRuntimeSettingsShop(actionCommand, options.shop);
+    const current = await readCurrent(actionCommand, shop);
+    const { credentials: _credentials, ...identity } = shop;
+    const diff = effectiveDiff(current.projectCode, patch);
+    if (mode === "diff" || diff.changedFields.length === 0) {
+      const result2 = {
+        ...identity,
+        status: diff.changedFields.length ? "changed" : "unchanged",
+        version: current.version,
+        diff
+      };
+      output(
+        actionCommand,
+        result2,
+        () => process.stdout.write(`${JSON.stringify(result2, null, 2)}
+`)
+      );
+      return;
+    }
+    const backupPath = (0, import_node_path13.resolve)(options.backup);
+    try {
+      (0, import_node_fs15.writeFileSync)(
+        backupPath,
+        `${JSON.stringify({ ...identity, ...current, capturedAt: (/* @__PURE__ */ new Date()).toISOString() }, null, 2)}
+`,
+        { flag: "wx", mode: 384 }
+      );
+    } catch (error) {
+      fail(
+        actionCommand,
+        `Backup failed; project code was not sent: ${String(error)}`,
+        EXIT_CODES.general
+      );
+    }
+    const response = await updateRuntimeSettings(shop.credentials, {
+      projectCode: patch,
+      expectedVersion: current.version
+    });
+    if (!response.ok || !response.data) {
+      fail(
+        actionCommand,
+        response.error ?? "Project code update failed",
+        classifyStatus(response.status),
+        { ...response.errorDetails, backupPath }
+      );
+    }
+    const data = response.data;
+    const warnings = [...data.warnings ?? []];
+    if (data.precompile?.status === "warning" || data.precompile?.status === "error") {
+      warnings.push(
+        `Project code saved; publication ${data.precompile.status}: ${data.precompile.summary}`
+      );
+    }
+    if (data.shop_id !== identity.shop_id)
+      warnings.push(
+        "The write response has a different shop identity; inspect the saved state before another write."
+      );
+    for (const warning of warnings) process.stderr.write(`WARNING: ${warning}
+`);
+    const result = {
+      ...identity,
+      status: "saved",
+      diff,
+      backupPath,
+      version: data.version,
+      writtenVersion: data.writtenVersion,
+      precompile: data.precompile,
+      warnings
+    };
+    output(
+      actionCommand,
+      result,
+      () => process.stdout.write(`${JSON.stringify(result, null, 2)}
+`)
+    );
+  });
+  projectCodeCommand.addCommand(command);
+}
+
 // src/commands/triggers.ts
-var import_node_fs15 = __toESM(require("node:fs"));
-var import_node_path13 = __toESM(require("node:path"));
+var import_node_fs16 = __toESM(require("node:fs"));
+var import_node_path14 = __toESM(require("node:path"));
 
 // src/trigger-proposal.ts
 function runtimePath(path24) {
@@ -12868,8 +13590,8 @@ function score2(path24, patterns) {
     0
   );
 }
-function best(fields, patterns, numeric2 = false) {
-  const ranked = fields.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 [];
@@ -12894,15 +13616,15 @@ function proposeTriggers(report) {
       continue;
     const descriptors = candidate.fields ?? candidate.paths;
     const payload = candidate.properties ?? candidate.payload ?? candidate;
-    const fields = 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(
-      fields,
+      fields3,
       [/revenue/, /total.*amount|amount.*total/, /grand.*total|total/, /value|amount/],
       true
     );
-    const orderIds = best(fields, [/order.*id|id.*order/, /transaction.*id/, /(^|\.)id$/]);
-    const currencies = best(fields, [/currency/, /(^|\.)cur(rency)?$/]);
-    const items = best(fields, [/(^|\.)((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)
@@ -13197,10 +13919,10 @@ function writeWarnings(result) {
 `);
   }
 }
-var uuidPattern = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+var uuidPattern2 = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
 async function identify(command, requestedShop) {
   let credentials = requireCredentials();
-  if (credentials.credentialKind === "user" && !uuidPattern.test(requestedShop)) {
+  if (credentials.credentialKind === "user" && !uuidPattern2.test(requestedShop)) {
     const discoveryCredentials = {
       ...credentials,
       resolvedContext: { ...credentials.resolvedContext, shopId: void 0 }
@@ -13273,7 +13995,7 @@ var get3 = new Command("get").description("Get data layer triggers").requiredOpt
 var set2 = new Command("set").requiredOption("--file <json>", "JSON trigger array").requiredOption("--shop <domain-or-id>", "Shop domain or Apex shop ID").action(async function(opts) {
   let triggers;
   try {
-    triggers = strictTriggers(JSON.parse(import_node_fs15.default.readFileSync(import_node_path13.default.resolve(opts.file), "utf8")));
+    triggers = strictTriggers(JSON.parse(import_node_fs16.default.readFileSync(import_node_path14.default.resolve(opts.file), "utf8")));
   } catch (error) {
     fail(
       this,
@@ -13300,7 +14022,7 @@ var propose = new Command("propose").requiredOption("--from-file <u2-report.json
   let proposals;
   let report;
   try {
-    report = JSON.parse(import_node_fs15.default.readFileSync(import_node_path13.default.resolve(opts.fromFile), "utf8"));
+    report = JSON.parse(import_node_fs16.default.readFileSync(import_node_path14.default.resolve(opts.fromFile), "utf8"));
     proposals = proposeTriggers(report);
   } catch (error) {
     fail(this, error instanceof Error ? error.message : String(error), 2);
@@ -13452,11 +14174,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,
@@ -13464,7 +14186,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,
@@ -13472,7 +14194,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));
@@ -13564,14 +14286,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(
@@ -13591,14 +14313,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);
@@ -14641,7 +15363,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);
@@ -14663,7 +15385,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 });
@@ -14723,7 +15445,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"),
@@ -14743,7 +15465,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);
@@ -14932,15 +15654,15 @@ function decodeBody(raw, header, limits, hostname, inputTruncated = false) {
         `Response from ${hostname} uses unsupported content encoding "${encoding}"`
       )
     );
-  return new Promise((resolve, reject) => {
+  return new Promise((resolve2, reject) => {
     const stream = decoderFor(encoding);
     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;
@@ -14952,7 +15674,7 @@ function decodeBody(raw, header, limits, hostname, inputTruncated = false) {
         }
         chunks.push(chunk.subarray(0, limits.maxBytes - bytes));
         stream.destroy();
-        settle(() => resolve({ body: Buffer.concat(chunks), truncated: true }));
+        settle(() => resolve2({ body: Buffer.concat(chunks), truncated: true }));
         return;
       }
       chunks.push(chunk);
@@ -14962,7 +15684,7 @@ function decodeBody(raw, header, limits, hostname, inputTruncated = false) {
       "error",
       (error) => settle(() => {
         if (limits.onExceed === "truncate" && inputTruncated && chunks.length > 0)
-          resolve({ body: Buffer.concat(chunks), truncated: true });
+          resolve2({ body: Buffer.concat(chunks), truncated: true });
         else
           reject(
             new BodyDecodeError(
@@ -14973,7 +15695,7 @@ function decodeBody(raw, header, limits, hostname, inputTruncated = false) {
     );
     stream.on(
       "end",
-      () => settle(() => resolve({ body: Buffer.concat(chunks), truncated: false }))
+      () => settle(() => resolve2({ body: Buffer.concat(chunks), truncated: false }))
     );
     stream.end(raw);
   });
@@ -15000,7 +15722,7 @@ function responseFromIncoming(res, body5, decoded) {
   });
 }
 function pinnedFetch(url, addresses, limits) {
-  return new Promise((resolve, reject) => {
+  return new Promise((resolve2, reject) => {
     const send3 = url.protocol === "https:" ? import_node_https.request : import_node_http2.request;
     const pinnedLookup = (_hostname, options, callback) => {
       if (options?.all)
@@ -15011,11 +15733,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,
@@ -15047,7 +15769,7 @@ function pinnedFetch(url, addresses, limits) {
             chunks.push(chunk.subarray(0, limits.maxBytes - bytes));
             req.destroy();
             settle(
-              () => finalizeIncoming(url, res, Buffer.concat(chunks), true, limits).then(resolve, reject)
+              () => finalizeIncoming(url, res, Buffer.concat(chunks), true, limits).then(resolve2, reject)
             );
             return;
           }
@@ -15062,7 +15784,7 @@ function pinnedFetch(url, addresses, limits) {
               reject(new Error(`No HTTP status from ${url.hostname}`));
               return;
             }
-            finalizeIncoming(url, res, Buffer.concat(chunks), false, limits).then(resolve, reject);
+            finalizeIncoming(url, res, Buffer.concat(chunks), false, limits).then(resolve2, reject);
           })
         );
       }
@@ -15350,7 +16072,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)
@@ -15494,8 +16216,8 @@ var installCommand = new Command("install").description("Check Apex storefront i
 
 // src/commands/flags.ts
 init_source();
-var import_node_fs16 = __toESM(require("node:fs"));
-var import_node_path14 = __toESM(require("node:path"));
+var import_node_fs17 = __toESM(require("node:fs"));
+var import_node_path15 = __toESM(require("node:path"));
 
 // src/edge-status.ts
 function getEdgeDeliveryStatus(deliveryType, expectedWorstCaseSeconds = 360) {
@@ -15537,7 +16259,7 @@ function body(command, value, opts) {
   let parsed = {};
   if (value) {
     const source = value.startsWith("@") ? value.slice(1) : value;
-    const text = value.startsWith("@") || import_node_fs16.default.existsSync(source) ? import_node_fs16.default.readFileSync(import_node_path14.default.resolve(process.cwd(), source), "utf8") : value;
+    const text = value.startsWith("@") || import_node_fs17.default.existsSync(source) ? import_node_fs17.default.readFileSync(import_node_path15.default.resolve(process.cwd(), source), "utf8") : value;
     try {
       parsed = JSON.parse(text);
     } catch (e) {
@@ -15650,11 +16372,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));
   });
 }
@@ -15670,8 +16392,8 @@ Examples:
 );
 
 // src/commands/backlog.ts
-var import_node_fs17 = __toESM(require("node:fs"));
-var import_node_path15 = __toESM(require("node:path"));
+var import_node_fs18 = __toESM(require("node:fs"));
+var import_node_path16 = __toESM(require("node:path"));
 init_source();
 var kind2 = "backlog";
 var singular = "backlog item";
@@ -15679,7 +16401,7 @@ function parse(command, value) {
   if (!value) return {};
   try {
     const source = value.startsWith("@") ? value.slice(1) : value;
-    const text = value.startsWith("@") || import_node_fs17.default.existsSync(source) ? import_node_fs17.default.readFileSync(import_node_path15.default.resolve(process.cwd(), source), "utf8") : value;
+    const text = value.startsWith("@") || import_node_fs18.default.existsSync(source) ? import_node_fs18.default.readFileSync(import_node_path16.default.resolve(process.cwd(), source), "utf8") : value;
     const body5 = JSON.parse(text);
     if (!body5 || typeof body5 !== "object" || Array.isArray(body5))
       throw new Error("body must be an object");
@@ -15692,13 +16414,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(),
@@ -15727,27 +16510,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;
 }
@@ -15779,7 +16570,7 @@ var remove2 = new Command("delete").description("Delete a backlog item").argumen
     const readline3 = await import("node:readline");
     const rl = readline3.createInterface({ input: process.stdin, output: process.stderr });
     const answer = await new Promise(
-      (resolve) => rl.question(source_default.yellow(`Delete backlog item ${id}? [y/N] `), resolve)
+      (resolve2) => rl.question(source_default.yellow(`Delete backlog item ${id}? [y/N] `), resolve2)
     );
     rl.close();
     if (answer.toLowerCase() !== "y") {
@@ -15792,11 +16583,103 @@ 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_fs18 = __toESM(require("node:fs"));
-var import_node_path16 = __toESM(require("node:path"));
+var import_node_fs19 = __toESM(require("node:fs"));
+var import_node_path17 = __toESM(require("node:path"));
 init_source();
 var kind3 = "signals";
 var singular2 = "signal";
@@ -15804,7 +16687,7 @@ function parse2(command, value) {
   if (!value) return {};
   try {
     const source = value.startsWith("@") ? value.slice(1) : value;
-    const text = value.startsWith("@") || import_node_fs18.default.existsSync(source) ? import_node_fs18.default.readFileSync(import_node_path16.default.resolve(process.cwd(), source), "utf8") : value;
+    const text = value.startsWith("@") || import_node_fs19.default.existsSync(source) ? import_node_fs19.default.readFileSync(import_node_path17.default.resolve(process.cwd(), source), "utf8") : value;
     const body5 = JSON.parse(text);
     if (!body5 || typeof body5 !== "object" || Array.isArray(body5))
       throw new Error("body must be an object");
@@ -15854,24 +16737,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;
@@ -15886,14 +16769,14 @@ var signalsCommand = new Command("signals").description("Manage signals").addCom
 
 // src/commands/personalizations.ts
 init_source();
-var import_node_fs19 = __toESM(require("node:fs"));
-var import_node_path17 = __toESM(require("node:path"));
+var import_node_fs20 = __toESM(require("node:fs"));
+var import_node_path18 = __toESM(require("node:path"));
 var kind4 = "personalizations";
 function body2(command, value, opts) {
   let parsed = {};
   if (value) {
     const source = value.startsWith("@") ? value.slice(1) : value;
-    const text = value.startsWith("@") || import_node_fs19.default.existsSync(source) ? import_node_fs19.default.readFileSync(import_node_path17.default.resolve(process.cwd(), source), "utf8") : value;
+    const text = value.startsWith("@") || import_node_fs20.default.existsSync(source) ? import_node_fs20.default.readFileSync(import_node_path18.default.resolve(process.cwd(), source), "utf8") : value;
     try {
       parsed = JSON.parse(text);
     } catch (e) {
@@ -15963,11 +16846,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));
   });
 }
@@ -15975,13 +16858,13 @@ var personalizationsCommand = new Command("personalizations").description("Manag
 
 // src/commands/targeting-resources.ts
 init_source();
-var import_node_fs20 = __toESM(require("node:fs"));
-var import_node_path18 = __toESM(require("node:path"));
+var import_node_fs21 = __toESM(require("node:fs"));
+var import_node_path19 = __toESM(require("node:path"));
 function body3(command, value) {
   if (!value) return {};
   const source = value.startsWith("@") ? value.slice(1) : value;
   try {
-    const text = value.startsWith("@") || import_node_fs20.default.existsSync(source) ? import_node_fs20.default.readFileSync(import_node_path18.default.resolve(process.cwd(), source), "utf8") : value;
+    const text = value.startsWith("@") || import_node_fs21.default.existsSync(source) ? import_node_fs21.default.readFileSync(import_node_path19.default.resolve(process.cwd(), source), "utf8") : value;
     return JSON.parse(text);
   } catch (error) {
     fail(
@@ -16049,21 +16932,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
@@ -16071,7 +16954,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
         );
@@ -16080,7 +16963,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);
@@ -16101,8 +16984,8 @@ function targetingResourceCommand(kind5) {
           input: process.stdin,
           output: process.stderr
         });
-        const answer = await new Promise((resolve) => {
-          rl.question(source_default.yellow(`Delete exclusion group "${id}"? [y/N] `), resolve);
+        const answer = await new Promise((resolve2) => {
+          rl.question(source_default.yellow(`Delete exclusion group "${id}"? [y/N] `), resolve2);
         });
         rl.close();
         if (answer.toLowerCase() !== "y") {
@@ -16154,7 +17037,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) {
@@ -16187,7 +17070,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) {
@@ -16232,8 +17115,8 @@ var targetingCommand = new Command("targeting").description("Test experiment tar
 
 // src/commands/sos.ts
 init_source();
-var import_node_fs21 = __toESM(require("node:fs"));
-var import_node_path19 = __toESM(require("node:path"));
+var import_node_fs22 = __toESM(require("node:fs"));
+var import_node_path20 = __toESM(require("node:path"));
 var SOS_TYPES = /* @__PURE__ */ new Set([
   "full_handover",
   "design",
@@ -16246,7 +17129,7 @@ var SOS_TYPES = /* @__PURE__ */ new Set([
 function readText(value) {
   if (!value) return void 0;
   if (!value.startsWith("@")) return value;
-  return import_node_fs21.default.readFileSync(import_node_path19.default.resolve(process.cwd(), value.slice(1)), "utf8");
+  return import_node_fs22.default.readFileSync(import_node_path20.default.resolve(process.cwd(), value.slice(1)), "utf8");
 }
 function printTicket(ticket, reused) {
   console.log();
@@ -16272,7 +17155,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,
@@ -16299,7 +17182,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) {
@@ -16380,13 +17263,13 @@ var markRead = new Command("mark-read").option("--channel <key>", "Mark one chan
 var inboxCommand = new Command("inbox").description("Read and send inbox messages").addCommand(list11).addCommand(send2).addCommand(markRead);
 
 // src/commands/shops.ts
-var import_node_fs22 = __toESM(require("node:fs"));
-var import_node_path20 = __toESM(require("node:path"));
+var import_node_fs23 = __toESM(require("node:fs"));
+var import_node_path21 = __toESM(require("node:path"));
 function body4(command, raw) {
   if (!raw) return {};
   try {
     const source = raw.startsWith("@") ? raw.slice(1) : raw;
-    const text = raw.startsWith("@") || import_node_fs22.default.existsSync(source) ? import_node_fs22.default.readFileSync(import_node_path20.default.resolve(source), "utf8") : raw;
+    const text = raw.startsWith("@") || import_node_fs23.default.existsSync(source) ? import_node_fs23.default.readFileSync(import_node_path21.default.resolve(source), "utf8") : raw;
     const value = JSON.parse(text);
     if (!value || typeof value !== "object" || Array.isArray(value))
       throw new Error("body must be an object");
@@ -16448,7 +17331,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);
@@ -16581,7 +17464,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);
 
@@ -16589,6 +17472,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,
@@ -16614,7 +17498,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)}
@@ -17029,7 +17913,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)) {
@@ -17199,16 +18083,16 @@ var discoverCommand = new Command("discover").description("Read back the trackin
 });
 
 // src/commands/skills.ts
-var import_node_fs23 = __toESM(require("node:fs"));
-var import_node_path21 = __toESM(require("node:path"));
+var import_node_fs24 = __toESM(require("node:fs"));
+var import_node_path22 = __toESM(require("node:path"));
 function packageRoot() {
   const candidates = [
-    import_node_path21.default.resolve(__dirname, ".."),
-    import_node_path21.default.resolve(import_node_path21.default.dirname(process.argv[1] ?? process.cwd()), ".."),
-    import_node_path21.default.resolve(process.cwd(), "packages/cli")
+    import_node_path22.default.resolve(__dirname, ".."),
+    import_node_path22.default.resolve(import_node_path22.default.dirname(process.argv[1] ?? process.cwd()), ".."),
+    import_node_path22.default.resolve(process.cwd(), "packages/cli")
   ];
   for (const candidate of candidates) {
-    if (import_node_fs23.default.existsSync(import_node_path21.default.join(candidate, "AGENTS.md"))) return candidate;
+    if (import_node_fs24.default.existsSync(import_node_path22.default.join(candidate, "AGENTS.md"))) return candidate;
   }
   throw new Error(
     `Apex CLI package files not found. Looked for AGENTS.md in: ${candidates.join(", ")}`
@@ -17217,22 +18101,22 @@ function packageRoot() {
 function skillPaths() {
   const root = packageRoot();
   return {
-    agents: import_node_path21.default.join(root, "AGENTS.md"),
-    skill: import_node_path21.default.join(root, "skills", "apex-cli", "SKILL.md")
+    agents: import_node_path22.default.join(root, "AGENTS.md"),
+    skill: import_node_path22.default.join(root, "skills", "apex-cli", "SKILL.md")
   };
 }
 function installSkill(paths, targetRoot) {
-  const missing = [paths.skill, paths.agents].filter((filePath) => !import_node_fs23.default.existsSync(filePath));
+  const missing = [paths.skill, paths.agents].filter((filePath) => !import_node_fs24.default.existsSync(filePath));
   if (missing.length > 0) {
     throw new Error(`Apex CLI package files not found. Missing: ${missing.join(", ")}`);
   }
-  const target = import_node_path21.default.resolve(targetRoot, "apex-cli");
-  import_node_fs23.default.mkdirSync(target, { recursive: true });
-  import_node_fs23.default.copyFileSync(paths.skill, import_node_path21.default.join(target, "SKILL.md"));
-  import_node_fs23.default.copyFileSync(paths.agents, import_node_path21.default.join(target, "AGENTS.md"));
+  const target = import_node_path22.default.resolve(targetRoot, "apex-cli");
+  import_node_fs24.default.mkdirSync(target, { recursive: true });
+  import_node_fs24.default.copyFileSync(paths.skill, import_node_path22.default.join(target, "SKILL.md"));
+  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();
@@ -17329,8 +18213,8 @@ async function confirmArchive(command, shopId, force) {
   }
   const readline3 = await import("node:readline");
   const rl = readline3.createInterface({ input: process.stdin, output: process.stderr });
-  const answer = await new Promise((resolve) => {
-    rl.question("Archive this shop? Apex delivery will be disabled. [y/N] ", resolve);
+  const answer = await new Promise((resolve2) => {
+    rl.question("Archive this shop? Apex delivery will be disabled. [y/N] ", resolve2);
   });
   rl.close();
   if (answer.toLowerCase() !== "y") {
@@ -17384,7 +18268,7 @@ async function confirm(c, force, label, retry) {
   const readline3 = await import("node:readline");
   const rl = readline3.createInterface({ input: process.stdin, output: process.stderr });
   const answer = await new Promise(
-    (resolve) => rl.question(source_default.yellow(`${label}? [y/N] `), resolve)
+    (resolve2) => rl.question(source_default.yellow(`${label}? [y/N] `), resolve2)
   );
   rl.close();
   if (answer.toLowerCase() !== "y") {
@@ -17856,7 +18740,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));
 });
@@ -17865,7 +18749,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);
@@ -17897,7 +18781,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,
@@ -17906,7 +18790,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);
@@ -17918,12 +18802,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);
@@ -17956,7 +18840,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,
@@ -17971,14 +18855,14 @@ 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();
-var import_node_fs24 = __toESM(require("node:fs"));
-var import_node_path22 = __toESM(require("node:path"));
+var import_node_fs25 = __toESM(require("node:fs"));
+var import_node_path23 = __toESM(require("node:path"));
 function readJson2(file) {
-  const text = file === "-" ? import_node_fs24.default.readFileSync(0, "utf8") : import_node_fs24.default.readFileSync(import_node_path22.default.resolve(file), "utf8");
+  const text = file === "-" ? import_node_fs25.default.readFileSync(0, "utf8") : import_node_fs25.default.readFileSync(import_node_path23.default.resolve(file), "utf8");
   try {
     return JSON.parse(text);
   } catch (error) {
@@ -18100,8 +18984,8 @@ var simulateCommand = new Command("simulate").description("Simulate data-layer t
 });
 
 // src/commands/config-resources.ts
-var import_node_fs25 = __toESM(require("node:fs"));
-var import_node_path23 = __toESM(require("node:path"));
+var import_node_fs26 = __toESM(require("node:fs"));
+var import_node_path24 = __toESM(require("node:path"));
 function show(resource) {
   process.stdout.write(`${JSON.stringify(resource, null, 2)}
 `);
@@ -18127,8 +19011,8 @@ async function confirmAssetDelete(id) {
     input: process.stdin,
     output: process.stderr
   });
-  const answer = await new Promise((resolve) => {
-    rl.question(`Delete asset "${id}"? This cannot be undone. [y/N] `, resolve);
+  const answer = await new Promise((resolve2) => {
+    rl.question(`Delete asset "${id}"? This cannot be undone. [y/N] `, resolve2);
   });
   rl.close();
   return answer.trim().toLowerCase() === "y";
@@ -18174,12 +19058,12 @@ function readFamily(family, label) {
 }
 var assetReads = readFamily("assets", "assets");
 var upload = new Command("upload").description("Upload an asset").argument("<file>").action(async function(file) {
-  const absolute = import_node_path23.default.resolve(process.cwd(), file);
-  if (!import_node_fs25.default.existsSync(absolute)) fail(this, `File not found: ${file}`, 3);
-  const fileStat = import_node_fs25.default.statSync(absolute);
+  const absolute = import_node_path24.default.resolve(process.cwd(), file);
+  if (!import_node_fs26.default.existsSync(absolute)) fail(this, `File not found: ${file}`, 3);
+  const fileStat = import_node_fs26.default.statSync(absolute);
   if (!fileStat.isFile()) fail(this, `File not found: ${file}`, 3);
   if (fileStat.size > MAX_ASSET_SIZE_BYTES) fail(this, `${file} is larger than 10 MB`, 3);
-  const mimeType = ASSET_MIME_TYPES[import_node_path23.default.extname(absolute).toLowerCase()];
+  const mimeType = ASSET_MIME_TYPES[import_node_path24.default.extname(absolute).toLowerCase()];
   if (!mimeType)
     fail(
       this,
@@ -18188,8 +19072,8 @@ var upload = new Command("upload").description("Upload an asset").argument("<fil
     );
   const r = await uploadAssets(requireCredentials(), [
     {
-      name: import_node_path23.default.basename(absolute),
-      bytes: import_node_fs25.default.readFileSync(absolute),
+      name: import_node_path24.default.basename(absolute),
+      bytes: import_node_fs26.default.readFileSync(absolute),
       type: mimeType
     }
   ]);
@@ -18279,6 +19163,7 @@ program2.addCommand(funnelsCommand);
 program2.addCommand(environmentsCommand);
 program2.addCommand(consentCommand);
 program2.addCommand(triggersCommand);
+program2.addCommand(projectCodeCommand);
 program2.addCommand(domainsCommand);
 program2.addCommand(handoverCommand);
 program2.addCommand(analyticsCommand);