@drip-apex/apex-cli 0.15.2 → 0.15.3

package/dist/cli.js

@@ -7325,7 +7325,7 @@ async function checkForUpdate(current) {
 // package.json
 var package_default = {
   name: "@drip-apex/apex-cli",
-  version: "0.15.2",
+  version: "0.15.3",
   license: "MIT",
   description: "Apex CLI for managing experiments, approved roadmap ideas, and draft workspaces.",
   private: false,
@@ -7589,7 +7589,8 @@ function classifyApiError(status4, details) {
   const code = details?.code;
   if (code === "shop_context_required" || code === "org_context_required")
     return EXIT_CODES.validation;
-  if (code === "shop_access_denied" || code === "org_access_denied") return EXIT_CODES.auth;
+  if (code === "shop_access_denied" || code === "org_access_denied" || code === "member_suspended")
+    return EXIT_CODES.auth;
   return classifyStatus(status4);
 }
 function confirmationRequired(command, message, retry) {
@@ -7686,7 +7687,7 @@ function errorReason(error) {
   const body5 = error.api?.body;
   const code = body5?.code ?? body5?.error?.code ?? (error.api ? details?.code : void 0);
   if (typeof code === "string" && code) return code;
-  if (["shop_context_required", "local_file_error", "validation_failed"].includes(
+  if (["shop_context_required", "local_file_error", "validation_failed", "member_suspended"].includes(
     String(details?.code)
   ))
     return String(details?.code);
@@ -7704,6 +7705,13 @@ function errorReason(error) {
 function errorNextSteps(error) {
   const reason2 = errorReason(error);
   const steps = [];
+  if (reason2 === "member_suspended")
+    return [
+      {
+        command: "contact organization admin",
+        why: "Ask an organization owner or admin to reinstate your membership."
+      }
+    ];
   if (reason2 === "auth_required" || error.api?.status === 401) {
     steps.push({ command: "apex login", why: "Authenticate with a valid API key." });
     if (!error.api)
@@ -8438,6 +8446,7 @@ function listExperiments(creds, opts) {
   if (opts?.includeArchived) params.set("archived", "1");
   if (opts?.view) params.set("view", opts.view);
   if (opts?.fields !== void 0) params.set("fields", opts.fields);
+  if (opts?.url !== void 0) params.set("url", opts.url);
   const qs = params.toString();
   return request(creds, "GET", `/api/v1/experiments${qs ? `?${qs}` : ""}`);
 }
@@ -8485,6 +8494,8 @@ function getExperimentFilesystem(creds, id) {
 function getExperimentResults(creds, id, opts) {
   const params = new URLSearchParams();
   if (opts?.currency) params.set("currency", opts.currency);
+  for (const key of ["segment", "exclude_segment"])
+    if (opts?.[key] !== void 0) params.set(key, opts[key]);
   const qs = params.toString();
   return request(
     creds,
@@ -8538,6 +8549,17 @@ function applyExperimentFilesystem(creds, id, body5) {
 function getExperimentQaRun(creds, id) {
   return request(creds, "GET", `/api/v1/experiments/${id}/qa/run`);
 }
+function getExperimentQaEvents(creds, id, options = {}) {
+  const params = new URLSearchParams();
+  if (options.session) params.set("qa_session", options.session);
+  if (options.minutes !== void 0) params.set("minutes", String(options.minutes));
+  if (options.type) params.set("type", options.type);
+  return request(
+    creds,
+    "GET",
+    `/api/v1/experiments/${id}/qa/events${params.size ? `?${params}` : ""}`
+  );
+}
 function updateExperimentQaRun(creds, id, body5) {
   return request(creds, "PATCH", `/api/v1/experiments/${id}/qa/run`, body5);
 }
@@ -8891,6 +8913,12 @@ function createAdminCustomer(creds, body5) {
 function setAdminCustomerCategory(creds, orgId, body5) {
   return request(userCredentials(creds), "PATCH", `/api/v1/admin/customers/${orgId}`, body5);
 }
+function setAdminCustomerManagedBy(creds, orgId, body5) {
+  return request(userCredentials(creds), "PATCH", `/api/v1/admin/customers/${orgId}`, body5);
+}
+function setAdminCustomerWorkspaceType(creds, orgId, body5) {
+  return request(userCredentials(creds), "PATCH", `/api/v1/admin/customers/${orgId}`, body5);
+}
 function getAdminSettings(creds) {
   return request(userCredentials(creds), "GET", "/api/v1/admin/settings");
 }
@@ -9045,6 +9073,17 @@ function revokeOrgInvite(creds, id) {
 function setOrgMember(creds, id, body5) {
   return request(userCreds(creds), "PATCH", `/api/v1/org/members/${encodeURIComponent(id)}`, body5);
 }
+function suspendOrgMember(creds, id, reason2) {
+  return request(userCreds(creds), "PATCH", `/api/v1/org/members/${encodeURIComponent(id)}`, {
+    suspended: true,
+    ...reason2 ? { reason: reason2 } : {}
+  });
+}
+function reinstateOrgMember(creds, id) {
+  return request(userCreds(creds), "PATCH", `/api/v1/org/members/${encodeURIComponent(id)}`, {
+    suspended: false
+  });
+}
 function removeOrgMember(creds, id) {
   return request(userCreds(creds), "DELETE", `/api/v1/org/members/${encodeURIComponent(id)}`);
 }
@@ -9188,6 +9227,14 @@ function getOrderJourney(creds, opts) {
     45e3
   );
 }
+function moveAdminCustomerStores(creds, orgId, body5) {
+  return request(
+    userCredentials(creds),
+    "POST",
+    `/api/v1/admin/customers/${orgId}/move-stores`,
+    body5
+  );
+}
 
 // src/context.ts
 var import_node_readline = __toESM(require("node:readline"));
@@ -9399,10 +9446,14 @@ async function waitForBrowserLogin(baseUrl, userMode = false) {
         const returnedState = params.get("state");
         const apiKey = params.get("apiKey");
         const error = params.get("error");
+        const code = params.get("code");
         if (error) {
           res.writeHead(400, { "Content-Type": "text/html; charset=utf-8" });
           res.end("<h1>Apex CLI login failed</h1><p>You can close this window.</p>");
-          finish(new Error(error));
+          const details = code ? { code } : void 0;
+          finish(
+            details ? new CliError(error, classifyApiError(400, details), details) : new Error(error)
+          );
           return;
         }
         if (returnedState !== state) {
@@ -9486,6 +9537,7 @@ var loginCommand = new Command("login").description("Authenticate with Apex").op
     try {
       apiKey = await waitForBrowserLogin(baseUrl, true);
     } catch (err) {
+      if (err instanceof CliError) throw err;
       fail(this, err instanceof Error ? err.message : "Browser login failed.");
     }
   }
@@ -9777,13 +9829,18 @@ function buildQaPreviewUrl(experiment2, options = {}) {
 }
 
 // src/lib/qa-preview-url.ts
-function buildQaPreviewUrl2(storeUrl, experimentId, variationId) {
-  const url = buildQaPreviewUrl({
-    id: experimentId,
-    store_url: storeUrl,
-    variations: [{ id: variationId, is_control: false }]
-  });
+function buildQaPreviewUrl2(storeUrl, experimentId, variationId, qaSessionId) {
+  const url = buildQaPreviewUrl(
+    {
+      id: experimentId,
+      store_url: storeUrl,
+      variations: [{ id: variationId, is_control: false }]
+    },
+    { qaSessionId }
+  );
   if (!url) throw new TypeError("Invalid QA preview URL");
+  if (qaSessionId && url.searchParams.get("drip_qa_session") !== qaSessionId)
+    url.searchParams.set("drip_qa_session", qaSessionId);
   return url;
 }
 
@@ -10181,6 +10238,755 @@ function createAssetReferenceRewriter(options) {
   return { rewrite, rewriteUnknown };
 }
 
+// src/generated/experiment-filesystem.schema.json
+var experiment_filesystem_schema_default = {
+  $id: "https://api.drip-apex.com/schemas/experiment-filesystem-v1.json",
+  $schema: "https://json-schema.org/draft/2020-12/schema",
+  files: {
+    "experiment.json": {
+      $schema: "https://json-schema.org/draft/2020-12/schema",
+      additionalProperties: false,
+      properties: {
+        autoStopOverride: {
+          anyOf: [
+            {},
+            {
+              type: "null"
+            }
+          ]
+        },
+        countingType: {
+          anyOf: [
+            {
+              enum: ["standard", "setup_test", "aa_test", "non_program"],
+              type: "string"
+            },
+            {
+              type: "null"
+            }
+          ]
+        },
+        description: {
+          anyOf: [
+            {
+              type: "string"
+            },
+            {
+              type: "null"
+            }
+          ]
+        },
+        environmentKey: {
+          type: "string"
+        },
+        experimentType: {
+          enum: ["mutation", "redirect"],
+          type: "string"
+        },
+        id: {
+          anyOf: [
+            {
+              type: "string"
+            },
+            {
+              type: "null"
+            }
+          ]
+        },
+        name: {
+          type: "string"
+        },
+        schemaVersion: {
+          const: 1,
+          type: "number"
+        },
+        sequentialTestingEnabled: {
+          type: "boolean"
+        },
+        significanceLevel: {
+          type: "number"
+        },
+        slug: {
+          anyOf: [
+            {
+              type: "string"
+            },
+            {
+              type: "null"
+            }
+          ]
+        },
+        statisticalPower: {
+          type: "number"
+        },
+        storeUrl: {
+          anyOf: [
+            {
+              type: "string"
+            },
+            {
+              type: "null"
+            }
+          ]
+        },
+        testKey: {
+          anyOf: [
+            {
+              type: "string"
+            },
+            {
+              type: "null"
+            }
+          ]
+        },
+        trafficAllocation: {
+          maximum: 1,
+          minimum: 0,
+          type: "number"
+        }
+      },
+      required: ["schemaVersion"],
+      type: "object"
+    },
+    "experiment/index.css": {
+      $schema: "https://json-schema.org/draft/2020-12/schema",
+      contentMediaType: "text/css",
+      type: "string"
+    },
+    "experiment/index.js": {
+      $schema: "https://json-schema.org/draft/2020-12/schema",
+      contentMediaType: "text/javascript",
+      type: "string"
+    },
+    "experiment/reset.js": {
+      $schema: "https://json-schema.org/draft/2020-12/schema",
+      contentMediaType: "text/javascript",
+      type: "string"
+    },
+    "launch.json": {
+      $schema: "https://json-schema.org/draft/2020-12/schema",
+      additionalProperties: false,
+      properties: {
+        endedAt: {
+          anyOf: [
+            {
+              type: "string"
+            },
+            {
+              type: "null"
+            }
+          ]
+        },
+        launchApproval: {
+          anyOf: [
+            {
+              additionalProperties: false,
+              properties: {
+                decidedAt: {
+                  anyOf: [
+                    {
+                      type: "string"
+                    },
+                    {
+                      type: "null"
+                    }
+                  ]
+                },
+                note: {
+                  anyOf: [
+                    {
+                      type: "string"
+                    },
+                    {
+                      type: "null"
+                    }
+                  ]
+                },
+                status: {
+                  type: "string"
+                }
+              },
+              required: ["status", "decidedAt", "note"],
+              type: "object"
+            },
+            {
+              type: "null"
+            }
+          ]
+        },
+        launchGate: {
+          additionalProperties: false,
+          properties: {
+            qaApproved: {
+              type: "boolean"
+            },
+            treatmentArtifactsApproved: {
+              type: "boolean"
+            }
+          },
+          required: ["qaApproved", "treatmentArtifactsApproved"],
+          type: "object"
+        },
+        readonly: {
+          const: true,
+          type: "boolean"
+        },
+        scheduledEndAt: {
+          anyOf: [
+            {
+              type: "string"
+            },
+            {
+              type: "null"
+            }
+          ]
+        },
+        scheduledStartAt: {
+          anyOf: [
+            {
+              type: "string"
+            },
+            {
+              type: "null"
+            }
+          ]
+        },
+        schemaVersion: {
+          const: 1,
+          type: "number"
+        },
+        startedAt: {
+          anyOf: [
+            {
+              type: "string"
+            },
+            {
+              type: "null"
+            }
+          ]
+        },
+        status: {
+          type: "string"
+        }
+      },
+      readOnly: true,
+      required: [
+        "schemaVersion",
+        "readonly",
+        "status",
+        "scheduledStartAt",
+        "scheduledEndAt",
+        "startedAt",
+        "endedAt",
+        "launchApproval",
+        "launchGate"
+      ],
+      type: "object"
+    },
+    "metrics.json": {
+      $schema: "https://json-schema.org/draft/2020-12/schema",
+      additionalProperties: false,
+      properties: {
+        goals: {
+          items: {
+            additionalProperties: false,
+            properties: {
+              capture: {
+                anyOf: [
+                  {},
+                  {
+                    type: "null"
+                  }
+                ]
+              },
+              countOnce: {
+                type: "boolean"
+              },
+              eventName: {
+                anyOf: [
+                  {
+                    type: "string"
+                  },
+                  {
+                    type: "null"
+                  }
+                ]
+              },
+              filter: {
+                anyOf: [
+                  {},
+                  {
+                    type: "null"
+                  }
+                ]
+              },
+              id: {
+                anyOf: [
+                  {
+                    type: "string"
+                  },
+                  {
+                    type: "null"
+                  }
+                ]
+              },
+              isPrimary: {
+                type: "boolean"
+              },
+              measurement: {},
+              name: {
+                type: "string"
+              },
+              pageId: {
+                anyOf: [
+                  {
+                    type: "string"
+                  },
+                  {
+                    type: "null"
+                  }
+                ]
+              },
+              selector: {
+                anyOf: [
+                  {
+                    type: "string"
+                  },
+                  {
+                    type: "null"
+                  }
+                ]
+              },
+              textMatch: {
+                anyOf: [
+                  {
+                    type: "string"
+                  },
+                  {
+                    type: "null"
+                  }
+                ]
+              },
+              type: {
+                enum: ["click", "pageview", "custom", "revenue"],
+                type: "string"
+              },
+              urlPattern: {
+                anyOf: [
+                  {
+                    type: "string"
+                  },
+                  {
+                    type: "null"
+                  }
+                ]
+              },
+              valueProperty: {
+                anyOf: [
+                  {
+                    type: "string"
+                  },
+                  {
+                    type: "null"
+                  }
+                ]
+              },
+              valueUnit: {
+                anyOf: [
+                  {
+                    type: "string"
+                  },
+                  {
+                    type: "null"
+                  }
+                ]
+              }
+            },
+            required: ["name", "type"],
+            type: "object"
+          },
+          type: "array"
+        },
+        primaryGoalId: {
+          anyOf: [
+            {
+              type: "string"
+            },
+            {
+              type: "null"
+            }
+          ]
+        },
+        schemaVersion: {
+          const: 1,
+          type: "number"
+        }
+      },
+      required: ["schemaVersion", "primaryGoalId", "goals"],
+      type: "object"
+    },
+    "qa.json": {
+      $schema: "https://json-schema.org/draft/2020-12/schema",
+      additionalProperties: false,
+      properties: {
+        latestRun: {
+          anyOf: [
+            {
+              additionalProperties: false,
+              properties: {
+                approvedAt: {
+                  anyOf: [
+                    {
+                      type: "string"
+                    },
+                    {
+                      type: "null"
+                    }
+                  ]
+                },
+                completedAt: {
+                  anyOf: [
+                    {
+                      type: "string"
+                    },
+                    {
+                      type: "null"
+                    }
+                  ]
+                },
+                id: {
+                  type: "string"
+                },
+                source: {
+                  type: "string"
+                },
+                status: {
+                  type: "string"
+                },
+                summary: {
+                  anyOf: [
+                    {},
+                    {
+                      type: "null"
+                    }
+                  ]
+                }
+              },
+              required: ["id", "status", "source", "approvedAt", "completedAt", "summary"],
+              type: "object"
+            },
+            {
+              type: "null"
+            }
+          ]
+        },
+        qaApprovedAt: {
+          anyOf: [
+            {
+              type: "string"
+            },
+            {
+              type: "null"
+            }
+          ]
+        },
+        qaApprovedBy: {
+          anyOf: [
+            {
+              type: "string"
+            },
+            {
+              type: "null"
+            }
+          ]
+        },
+        readonly: {
+          const: true,
+          type: "boolean"
+        },
+        schemaVersion: {
+          const: 1,
+          type: "number"
+        }
+      },
+      readOnly: true,
+      required: ["schemaVersion", "readonly", "qaApprovedAt", "qaApprovedBy", "latestRun"],
+      type: "object"
+    },
+    "targeting.json": {
+      $schema: "https://json-schema.org/draft/2020-12/schema",
+      additionalProperties: {},
+      properties: {
+        authorUrl: {
+          items: {
+            additionalProperties: false,
+            properties: {
+              include: {
+                type: "boolean"
+              },
+              match_type: {
+                enum: ["exact", "contains", "wildcard", "regex"],
+                type: "string"
+              },
+              matchType: {
+                enum: ["exact", "contains", "wildcard", "regex"],
+                type: "string"
+              },
+              pattern: {
+                minLength: 1,
+                type: "string"
+              },
+              type: {
+                enum: ["regex", "simple"],
+                type: "string"
+              }
+            },
+            required: ["type", "pattern"],
+            type: "object"
+          },
+          type: "array"
+        },
+        custom: {},
+        device: {},
+        deviceType: {
+          type: "string"
+        },
+        lifecycle: {},
+        pageRules: {
+          items: {},
+          type: "array"
+        },
+        pages: {
+          items: {},
+          type: "array"
+        },
+        segments: {
+          items: {},
+          type: "array"
+        },
+        url: {
+          items: {
+            additionalProperties: false,
+            properties: {
+              include: {
+                type: "boolean"
+              },
+              match_type: {
+                enum: ["exact", "contains", "wildcard", "regex"],
+                type: "string"
+              },
+              matchType: {
+                enum: ["exact", "contains", "wildcard", "regex"],
+                type: "string"
+              },
+              pattern: {
+                minLength: 1,
+                type: "string"
+              },
+              type: {
+                enum: ["regex", "simple"],
+                type: "string"
+              }
+            },
+            required: ["type", "pattern"],
+            type: "object"
+          },
+          type: "array"
+        }
+      },
+      type: "object"
+    },
+    "variations/*/anti-flicker.json": {
+      $schema: "https://json-schema.org/draft/2020-12/schema",
+      items: {
+        type: "string"
+      },
+      type: "array"
+    },
+    "variations/*/index.css": {
+      $schema: "https://json-schema.org/draft/2020-12/schema",
+      contentMediaType: "text/css",
+      type: "string"
+    },
+    "variations/*/index.js": {
+      $schema: "https://json-schema.org/draft/2020-12/schema",
+      contentMediaType: "text/javascript",
+      type: "string"
+    },
+    "variations/*/mutations.json": {
+      $schema: "https://json-schema.org/draft/2020-12/schema",
+      items: {
+        additionalProperties: {},
+        anyOf: [
+          {
+            required: ["selector"]
+          },
+          {
+            properties: {
+              action: {
+                enum: [
+                  "priceTest",
+                  "shippingTest",
+                  "offerTest",
+                  "postPurchaseOffer",
+                  "checkoutBlock"
+                ]
+              }
+            },
+            required: ["action"]
+          }
+        ],
+        properties: {
+          action: {
+            type: "string"
+          },
+          selector: {
+            minLength: 1,
+            type: "string"
+          },
+          type: {
+            type: "string"
+          }
+        },
+        type: "object"
+      },
+      type: "array"
+    },
+    "variations/*/reset.js": {
+      $schema: "https://json-schema.org/draft/2020-12/schema",
+      contentMediaType: "text/javascript",
+      type: "string"
+    },
+    "variations/*/url-blocks.json": {
+      $schema: "https://json-schema.org/draft/2020-12/schema",
+      items: {},
+      type: "array"
+    },
+    "variations/*/variation.json": {
+      $schema: "https://json-schema.org/draft/2020-12/schema",
+      additionalProperties: false,
+      properties: {
+        artifactReview: {
+          additionalProperties: false,
+          properties: {
+            hash: {
+              anyOf: [
+                {
+                  type: "string"
+                },
+                {
+                  type: "null"
+                }
+              ]
+            },
+            reviewedAt: {
+              anyOf: [
+                {
+                  type: "string"
+                },
+                {
+                  type: "null"
+                }
+              ]
+            },
+            reviewedBy: {
+              anyOf: [
+                {
+                  type: "string"
+                },
+                {
+                  type: "null"
+                }
+              ]
+            },
+            source: {
+              anyOf: [
+                {
+                  type: "string"
+                },
+                {
+                  type: "null"
+                }
+              ]
+            },
+            status: {
+              type: "string"
+            }
+          },
+          required: ["status"],
+          type: "object"
+        },
+        codeDeliveryMode: {
+          enum: ["inline", "external"],
+          type: "string"
+        },
+        cssArtifactId: {
+          anyOf: [
+            {
+              type: "string"
+            },
+            {
+              type: "null"
+            }
+          ]
+        },
+        id: {
+          anyOf: [
+            {
+              type: "string"
+            },
+            {
+              type: "null"
+            }
+          ]
+        },
+        isControl: {
+          type: "boolean"
+        },
+        jsArtifactId: {
+          anyOf: [
+            {
+              type: "string"
+            },
+            {
+              type: "null"
+            }
+          ]
+        },
+        name: {
+          type: "string"
+        },
+        redirectUrl: {
+          anyOf: [
+            {
+              type: "string"
+            },
+            {
+              type: "null"
+            }
+          ]
+        },
+        schemaVersion: {
+          const: 1,
+          type: "number"
+        },
+        slug: {
+          type: "string"
+        },
+        weight: {
+          maximum: 1,
+          minimum: 0,
+          type: "number"
+        }
+      },
+      required: ["schemaVersion"],
+      type: "object"
+    }
+  },
+  schemaVersion: 1,
+  source: "experiment-filesystem"
+};
+
 // src/commands/experiments.ts
 function formatDate(iso) {
   return new Date(iso).toLocaleDateString("en-US", {
@@ -10244,6 +11050,13 @@ function formatRevenue(value, currency) {
     return String(value);
   }
 }
+function audienceLine(segmentApplied) {
+  if (!segmentApplied || typeof segmentApplied !== "object") return null;
+  const { requested, applied, reason: reason2 } = segmentApplied;
+  if (!requested) return null;
+  const label = `${requested.mode === "exclude" ? "excluding " : ""}${String(requested.dim)}=${String(requested.value)}`;
+  return applied === true ? label : `all visitors (${label} not applied: ${typeof reason2 === "string" ? reason2 : "unknown reason"})`;
+}
 function printExperimentResults(results2, currency) {
   const summary = summarizeResults(results2);
   const { experiment: experiment2, totals, decision, verdictWithheld, statisticsState, presentedOutcome } = summary;
@@ -10251,6 +11064,8 @@ function printExperimentResults(results2, currency) {
   console.log();
   console.log(source_default.bold(String(experiment2.name ?? experiment2.id ?? "Experiment results")));
   console.log(`  Status:      ${statusBadge(String(experiment2.status ?? "unknown"))}`);
+  const audience = audienceLine(results2.segment_applied);
+  if (audience) console.log(`  Audience:    ${audience}`);
   console.log(`  Visitors:    ${String(totals.visitors ?? 0)}`);
   console.log(`  Conversions: ${String(totals.primaryConversions ?? 0)}`);
   console.log(`  Revenue:     ${formatRevenue(totals.revenue, currency)}`);
@@ -10314,18 +11129,11 @@ function printExperimentResults(results2, currency) {
   }
   console.log();
 }
+var filesystemPaths = Object.keys(experiment_filesystem_schema_default.files);
 var EXPERIMENT_FILESYSTEM_PATH_SCHEMA = {
-  topLevel: ["experiment.json", "targeting.json", "metrics.json", "qa.json", "launch.json"],
-  experiment: ["index.css", "index.js", "reset.js"],
-  variation: [
-    "variation.json",
-    "mutations.json",
-    "url-blocks.json",
-    "index.css",
-    "index.js",
-    "reset.js",
-    "anti-flicker.json"
-  ]
+  topLevel: filesystemPaths.filter((entry) => !entry.includes("/")),
+  experiment: filesystemPaths.filter((entry) => entry.startsWith("experiment/")).map((entry) => entry.slice("experiment/".length)),
+  variation: filesystemPaths.filter((entry) => entry.startsWith("variations/*/")).map((entry) => entry.slice("variations/*/".length))
 };
 var SERVER_OWNED_EXPERIMENT_FILES = /* @__PURE__ */ new Set(["qa.json", "launch.json"]);
 var escapeRegex = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
@@ -10777,20 +11585,31 @@ var list = new Command("list").alias("ls").description(
   "List experiments in summary view by default; use --full for details or --fields for selected columns (archived experiments are hidden by default)"
 ).option(
   "-s, --status <status>",
-  "Filter by status (draft|awaiting_client_approval|changes_requested|client_approved|qa|ready_to_launch|running|paused|completed)"
+  "Filter by status (draft|awaiting_client_approval|changes_requested|client_approved|qa|ready_to_launch|running|paused|completed) (applied server-side)"
+).option(
+  "--url <absolute-url>",
+  "Filter by effective storefront URL targeting (applied server-side)"
 ).option("-n, --limit <n>", "Max results", "20").option("--include-archived", "Include archived experiments").option("--full", "Return full experiment details instead of the default summary").option(
   "--fields <list>",
   "Comma-separated fields to return and table columns in order (JSON always keeps id)"
 ).action(async function action3(opts) {
   const creds = requireCredentials();
   const spinner = await createSpinner("Fetching experiments...");
-  const res = await listExperiments(creds, {
+  const listDefault = () => listExperiments(creds, {
     status: opts.status,
     limit: parseInt(opts.limit, 10),
     includeArchived: opts.includeArchived,
     view: opts.full ? "full" : "summary",
     fields: opts.fields
   });
+  const res = opts.url !== void 0 ? await listExperiments(creds, {
+    status: opts.status,
+    limit: parseInt(opts.limit, 10),
+    includeArchived: opts.includeArchived,
+    view: opts.full ? "full" : "summary",
+    fields: opts.fields,
+    url: opts.url
+  }) : await listDefault();
   if (!res.ok) {
     spinner?.fail("Failed to fetch experiments");
     fail(this, res.error, classifyStatus(res.status), res.errorDetails);
@@ -10928,7 +11747,13 @@ ${JSON.stringify(data.order, null, 2)}`);
   console.log(`
 Definitions: ${data.definitions_url}`);
 }
-var results = new Command("results").description("Read experiment results and timeseries by ID or slug").argument("<id-or-slug>", EXPERIMENT_REFERENCE_DESCRIPTION).option("--currency <code>", "Currency code for revenue formatting").option("--explain", "Explain raw-event exclusions and residuals").option("--goal <id>", "Goal ID or event key for --explain").option("--order <key>", "Order label trail for --explain").option("--samples", "Show sample identifiers with --explain").action(async function action7(idOrSlug, opts) {
+var results = new Command("results").description("Read experiment results and timeseries by ID or slug").argument("<id-or-slug>", EXPERIMENT_REFERENCE_DESCRIPTION).option("--currency <code>", "Currency code for revenue formatting").option("--segment <dim:value>", "Include one audience segment").option("--exclude-segment <dim:value>", "Exclude one audience segment (include wins)").option("--explain", "Explain raw-event exclusions and residuals").option("--goal <id>", "Goal ID or event key for --explain").option("--order <key>", "Order label trail for --explain").option("--samples", "Show sample identifiers with --explain").action(async function action7(idOrSlug, opts) {
+  if (opts.explain && (opts.segment !== void 0 || opts.excludeSegment !== void 0))
+    fail(
+      this,
+      "--segment and --exclude-segment are only available for results, without --explain",
+      EXIT_CODES.validation
+    );
   if (!opts.explain && (opts.goal || opts.order || opts.samples))
     fail(this, "--goal, --order and --samples require --explain", EXIT_CODES.validation);
   const creds = requireCredentials();
@@ -10939,7 +11764,11 @@ var results = new Command("results").description("Read experiment results and ti
       spinner?.fail(`Experiment "${idOrSlug}" not found`);
       fail(this, `Experiment "${idOrSlug}" not found.`, EXIT_CODES.validation);
     }
-    const res = opts.explain ? await getExperimentResultsExplain(creds, exp.id, opts) : await getExperimentResults(creds, exp.id, { currency: opts.currency });
+    const res = opts.explain ? await getExperimentResultsExplain(creds, exp.id, opts) : await getExperimentResults(creds, exp.id, {
+      currency: opts.currency,
+      segment: opts.segment,
+      exclude_segment: opts.excludeSegment
+    });
     if (!res.ok || !res.data) {
       spinner?.fail("Failed to fetch experiment results");
       fail(
@@ -11213,7 +12042,7 @@ var create = new Command("create").description(
   []
 ).option(
   "--goal <goal-id|new:fields>",
-  "Goal id or new:type=...,selector=...,name=... (repeatable)",
+  "Goal id or new:type=...,selector=...,name=... (repeatable; omitted uses the shop default main goal)",
   collectCreateOption,
   []
 ).option(
@@ -11632,6 +12461,7 @@ var pullFilesystem = new Command("pull").description("Pull an experiment as an e
     output(
       this,
       {
+        schemaVersion: 1,
         folder,
         experimentId: exp.id,
         files: res.data.files.map((file) => import_node_path6.default.join(folder, file.path))
@@ -12460,7 +13290,55 @@ var qaEvidence = new Command("evidence").description("Attach screenshot jobs or
     throw error;
   }
 });
-var qa = new Command("qa").description("Manage experiment QA runs from the CLI").addCommand(qaStatus).addCommand(qaCheck).addCommand(qaNotes).addCommand(qaApprove).addCommand(qaReopen).addCommand(qaEvidence);
+var qa = new Command("qa").description("Manage experiment QA runs from the CLI").addCommand(qaStatus).addCommand(
+  new Command("events").description("List QA-tagged events for an experiment session").argument("<id-or-slug>", EXPERIMENT_REFERENCE_DESCRIPTION).option("--session <id>", "QA session id (defaults to the latest QA run)").option("--minutes <n>", "Lookback window in minutes", "60").option("--type <type>", "Event type: all, goal, or custom", "all").action(async function(target, opts) {
+    const minutes = Number(opts.minutes);
+    if (!Number.isInteger(minutes) || minutes < 5 || minutes > 1440)
+      fail(this, "--minutes must be an integer between 5 and 1440", EXIT_CODES.validation);
+    if (!["all", "goal", "custom"].includes(opts.type))
+      fail(this, "--type must be all, goal, or custom", EXIT_CODES.validation);
+    const creds = requireCredentials();
+    const experiment2 = { id: (await resolveExperimentForFilesystemOrId(target)).experimentId };
+    let session = opts.session;
+    if (!session) {
+      const status4 = await getExperimentQaRun(creds, experiment2.id);
+      if (!status4.ok || !status4.data)
+        throw new CliError(
+          status4.error ?? "Failed to fetch QA run",
+          classifyStatus(status4.status),
+          status4.errorDetails
+        );
+      session = status4.data.run.id;
+    }
+    const response = await getExperimentQaEvents(creds, experiment2.id, {
+      session,
+      minutes,
+      type: opts.type
+    });
+    if (!response.ok || !response.data)
+      throw new CliError(
+        response.error ?? "Failed to fetch QA events",
+        classifyStatus(response.status),
+        response.errorDetails
+      );
+    output(
+      this,
+      response.data,
+      () => printTable(
+        ["TYPE", "EVENT", "VARIATION", "SESSION", "COUNT", "LAST SEEN", "LAST URL"],
+        response.data.data.map((row) => [
+          row.event_type === "goal" ? "goal" : "custom",
+          row.event_name || row.goal_id,
+          row.variation_id,
+          row.qa_session_id,
+          String(row.events),
+          row.last_event_at ?? "\u2014",
+          row.last_url ?? "\u2014"
+        ])
+      )
+    );
+  })
+).addCommand(qaCheck).addCommand(qaNotes).addCommand(qaApprove).addCommand(qaReopen).addCommand(qaEvidence);
 var SCREENSHOT_DEVICES = [
   "desktop_chrome",
   "iphone_15_pro",
@@ -13246,9 +14124,21 @@ var previewCommand = new Command("preview").description(
         'Experiment is missing "store_url". Set it on the experiment or pass --store-url <url>.'
       );
     }
+    const snapshot = await getExperimentFilesystem(creds, exp.id).catch(() => null);
+    let qaRun;
+    if (snapshot?.ok && snapshot.data) {
+      const qaFile = snapshot.data.files.find((file) => file.path === "qa.json");
+      if (qaFile) {
+        try {
+          const run3 = JSON.parse(qaFile.content)?.latestRun;
+          if (run3 && typeof run3.id === "string" && run3.id.trim()) qaRun = run3;
+        } catch {
+        }
+      }
+    }
     let previewUrl;
     try {
-      previewUrl = buildQaPreviewUrl2(storeUrl, exp.id, variation.id);
+      previewUrl = buildQaPreviewUrl2(storeUrl, exp.id, variation.id, qaRun?.id);
     } catch {
       fail(
         previewCommand,
@@ -13257,6 +14147,10 @@ var previewCommand = new Command("preview").description(
     }
     const signed = await signedPreviewFromReadiness(creds, exp.id, variation.id, storeUrl);
     const selectedPreviewUrl = signed?.signed_preview_url ?? previewUrl.toString();
+    if (signed?.signed_preview_url) {
+      const signedSessionId = signed.signed_preview_qa_session_id;
+      qaRun = signedSessionId ? qaRun?.id === signedSessionId ? qaRun : { id: signedSessionId } : void 0;
+    }
     const warning = signed?.signed_preview_url ? null : "Test images may not load on this unsigned link. Open Apex \u2192 QA for a signed link.";
     if (warning) console.error(warning);
     output(
@@ -13267,6 +14161,7 @@ var previewCommand = new Command("preview").description(
         previewUrl: selectedPreviewUrl,
         expiresAt: signed?.signed_preview_expires_at ?? null,
         ...warning ? { warning } : {},
+        ...qaRun ? { qa_run: qaRun, qa_session_id: qaRun.id } : {},
         ...!opts?.storeUrl && exp.preview_target ? { previewTarget: exp.preview_target } : {}
       },
       () => {
@@ -20146,7 +21041,8 @@ function createSchemaCommand(program3) {
         mandatoryOptions: "An option's mandatory field is true only when the flag itself must be passed.",
         requiredArguments: "An argument's required field means the positional is mandatory."
       },
-      ...commandSchema(program3)
+      ...commandSchema(program3),
+      files: experiment_filesystem_schema_default
     };
     output(this, schema, () => {
       process.stdout.write(`${JSON.stringify(schema, null, 2)}
@@ -20787,8 +21683,15 @@ var skillsCommand = new Command("skills").description("Print or install the Apex
   });
 });
 
+// ../../ops/org-split/move-plan.mjs
+var uuid = /^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/;
+function validateMoveInput(shopIds, toOrgId) {
+  if (typeof toOrgId !== "string" || !uuid.test(toOrgId) || !Array.isArray(shopIds) || !shopIds.length || shopIds.some((id) => typeof id !== "string" || !uuid.test(id))) throw new Error("Choose valid store and destination UUIDs");
+  return { shopIds: [...new Set(shopIds.map((id) => id.toLowerCase()))].sort(), toOrgId: toOrgId.toLowerCase() };
+}
+
 // src/commands/admin.ts
-var 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 uuid2 = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
 function switchValue(value) {
   if (value === "on") return true;
   if (value === "off") return false;
@@ -20915,7 +21818,7 @@ var create6 = new Command("create").description("Create an internal, demo or dog
     fail(this, "--name must be 1 to 60 characters", 3);
   if (opts.reason.trim().length < 8 || opts.reason.trim().length > 500)
     fail(this, "--reason must be 8 to 500 characters", 3);
-  if (opts.claimShop && !uuid.test(opts.claimShop)) fail(this, "--claim-shop must be a UUID", 3);
+  if (opts.claimShop && !uuid2.test(opts.claimShop)) fail(this, "--claim-shop must be a UUID", 3);
   if (opts.claimShop && (opts.domain || opts.platform))
     fail(this, "Use --claim-shop or --domain with --platform", 3);
   if (!!opts.domain !== !!opts.platform)
@@ -20936,7 +21839,7 @@ var create6 = new Command("create").description("Create an internal, demo or dog
     fail(this, "--owner requires a store for the invitation", 3);
   if (opts.plan !== "self_managed" && (!opts.consultant || !opts.consultantTitle?.trim()))
     fail(this, "Managed plans require --consultant and --consultant-title", 3);
-  if (opts.consultant && !uuid.test(opts.consultant))
+  if (opts.consultant && !uuid2.test(opts.consultant))
     fail(this, "--consultant must be a platform access UUID", 3);
   if (!!opts.consultant !== !!opts.consultantTitle?.trim())
     fail(this, "Provide --consultant and --consultant-title together", 3);
@@ -21001,7 +21904,7 @@ var create6 = new Command("create").description("Create an internal, demo or dog
   });
 });
 var setCategory = new Command("set-category").description("Change an existing account's category with an audit reason").argument("<org-id>", "Organization UUID").requiredOption("--category <category>", "internal, demo, dogfood or customer").requiredOption("--reason <text>", "Audit reason, 8 to 500 characters").option("--confirm", "Confirm category change").option("--json", "Output JSON").action(async function(orgId, opts) {
-  if (!uuid.test(orgId)) fail(this, "<org-id> must be a UUID", 3);
+  if (!uuid2.test(orgId)) fail(this, "<org-id> must be a UUID", 3);
   if (!["internal", "demo", "dogfood", "customer"].includes(opts.category))
     fail(this, "--category must be internal, demo, dogfood or customer", 3);
   const reason2 = opts.reason.trim();
@@ -21032,14 +21935,137 @@ var setCategory = new Command("set-category").description("Change an existing ac
     printTable(["RESULT"], [[`Customer ${result.customerId} moved to ${result.category}`]]);
   });
 });
-var customers = new Command("customers").description("Create engineering accounts and manage existing account categories").addCommand(create6).addCommand(setCategory);
+var setManagedBy = new Command("set-managed-by").description("Assign or clear a managing agency with an audit reason").argument("<org-id>", "Organization UUID").option("--by <org-id>", "Managing agency UUID").option("--clear", "Clear the managing agency").requiredOption("--reason <text>", "Audit reason, 8 to 500 characters").option("--confirm", "Confirm manager change").option("--json", "Output JSON").action(async function(orgId, opts) {
+  if (!uuid2.test(orgId)) fail(this, "<org-id> must be a UUID", 3);
+  if (!!opts.by === !!opts.clear) fail(this, "Use exactly one of --by or --clear", 3);
+  if (opts.by && !uuid2.test(opts.by)) fail(this, "--by must be a UUID", 3);
+  const reason2 = opts.reason.trim();
+  if (reason2.length < 8 || reason2.length > 500)
+    fail(this, "--reason must be 8 to 500 characters", 3);
+  if (!opts.confirm) {
+    const quote = (value) => `'${value.replaceAll("'", "'\\''")}'`;
+    confirmationRequired(
+      this,
+      "--confirm is required to change a managing agency",
+      `apex admin customers set-managed-by ${orgId} ${opts.by ? `--by ${opts.by}` : "--clear"} --reason ${quote(reason2)} --confirm`
+    );
+  }
+  const res = await setAdminCustomerManagedBy(requireUserCredentials(), orgId, {
+    managed_by_org_id: opts.by ?? null,
+    reason: reason2
+  });
+  if (!res.ok || !res.data)
+    fail(
+      this,
+      res.error ?? "Failed to change managing agency",
+      classifyStatus(res.status),
+      res.errorDetails
+    );
+  output(
+    this,
+    res.data,
+    () => printTable(
+      ["CUSTOMER", "MANAGING AGENCY"],
+      [[res.data.data.customerId, res.data.data.managed_by_org_id ?? "None"]]
+    )
+  );
+});
+var setWorkspaceType = new Command("set-workspace-type").description("Change a workspace type with an audit reason").argument("<org-id>", "Organization UUID").requiredOption("--type <company|agency>", "Workspace type").requiredOption("--reason <text>", "Audit reason, 8 to 500 characters").option("--confirm", "Confirm workspace type change").option("--json", "Output JSON").action(async function(orgId, opts) {
+  if (!uuid2.test(orgId)) fail(this, "<org-id> must be a UUID", 3);
+  if (opts.type !== "company" && opts.type !== "agency")
+    fail(this, "--type must be company or agency", 3);
+  const reason2 = opts.reason.trim();
+  if (reason2.length < 8 || reason2.length > 500)
+    fail(this, "--reason must be 8 to 500 characters", 3);
+  if (!opts.confirm) {
+    const quote = (value) => `'${value.replaceAll("'", "'\\''")}'`;
+    confirmationRequired(
+      this,
+      "--confirm is required to change a workspace type",
+      `apex admin customers set-workspace-type ${orgId} --type ${opts.type} --reason ${quote(reason2)} --confirm`
+    );
+  }
+  const res = await setAdminCustomerWorkspaceType(requireUserCredentials(), orgId, {
+    workspace_type: opts.type,
+    reason: reason2
+  });
+  if (!res.ok || !res.data)
+    fail(
+      this,
+      res.error ?? "Failed to change workspace type",
+      classifyStatus(res.status),
+      res.errorDetails
+    );
+  output(
+    this,
+    res.data,
+    () => printTable(
+      ["CUSTOMER", "WORKSPACE TYPE"],
+      [[res.data.data.customerId, res.data.data.workspace_type]]
+    )
+  );
+});
+function storeMoveRequest(opts) {
+  const { shopIds, toOrgId } = validateMoveInput(opts.shop, opts.to);
+  const reason2 = opts.reason.trim();
+  if (reason2.length < 8 || reason2.length > 500)
+    throw new Error("--reason must be 8 to 500 characters");
+  return {
+    toOrgId,
+    body: {
+      shop_ids: shopIds,
+      reason: reason2,
+      keep_grants: !!opts.keepGrants,
+      dry_run: !opts.confirm
+    }
+  };
+}
+var moveStores = new Command("move-stores").description("Preview or confirm an audited set of store moves").requiredOption("--to <org-id>", "Destination organization UUID").requiredOption(
+  "--shop <shop-id>",
+  "Store UUID, repeat for each store",
+  (value, previous) => [...previous, value],
+  []
+).requiredOption("--reason <text>", "Audit reason, 8 to 500 characters").option("--keep-grants", "Preserve explicit store roles and overrides").option("--confirm", "Perform the move; otherwise return a read-only plan").option("--json", "Output JSON").action(async function(opts) {
+  let request2;
+  try {
+    request2 = storeMoveRequest(opts);
+  } catch (error) {
+    fail(this, error instanceof Error ? error.message : "Invalid move request", 3);
+  }
+  const res = await moveAdminCustomerStores(
+    requireUserCredentials(),
+    request2.toOrgId,
+    request2.body
+  );
+  if (!res.ok || !res.data)
+    fail(
+      this,
+      res.error ?? "Failed to move stores",
+      classifyStatus(res.status),
+      res.errorDetails
+    );
+  output(this, res.data, () => {
+    printTable(
+      ["FIELD", "VALUE"],
+      Object.entries(res.data.data).map(([key, value]) => [key, JSON.stringify(value)])
+    );
+  });
+});
+var customers = new Command("customers").description("Create engineering accounts and manage existing account categories").addCommand(create6).addCommand(setCategory).addCommand(setManagedBy).addCommand(setWorkspaceType).addCommand(moveStores);
 var adminCommand = new Command("admin").description("Operate allowlisted platform controls").addCommand(settingsGet).addCommand(quarantine).addCommand(shops).addCommand(customers);
 
 // src/commands/membership.ts
 init_source();
 async function run2(c, p, label) {
   const r = await p;
-  if (!r.ok) fail(c, r.error ?? `Failed to ${label}`, classifyStatus(r.status), r.errorDetails);
+  if (!r.ok)
+    fail(
+      c,
+      r.error ?? `Failed to ${label}`,
+      classifyStatus(r.status),
+      r.errorDetails,
+      apiFailureOf(r)
+    );
   output(c, r.data ?? {}, () => process.stdout.write(`${JSON.stringify(r.data, null, 2)}
 `));
 }
@@ -21075,7 +22101,27 @@ orgCommand.command("update").option("--name <name>").option("--slug <slug>").opt
   );
 });
 orgCommand.command("members").action(async function() {
-  await run2(this, listOrgMembers(requireUserCredentials()), "list members");
+  const r = await listOrgMembers(requireUserCredentials());
+  if (!r.ok)
+    fail(
+      this,
+      r.error ?? "Failed to list members",
+      classifyStatus(r.status),
+      r.errorDetails,
+      apiFailureOf(r)
+    );
+  const rows = r.data?.data ?? [];
+  output(this, r.data ?? {}, () => {
+    printTable(
+      ["ID", "MEMBER", "ROLE", "SUSPENDED"],
+      rows.map((row) => [
+        String(row.id),
+        String(row.email ?? row.name ?? "-"),
+        String(row.role),
+        String(row.suspended_at ?? "-")
+      ])
+    );
+  });
 });
 orgCommand.command("invite").argument("<email>").option("--role <role>", "Alias for --org-role").option("--org-role <role>", "Organization role", "member").addOption(
   new Option(
@@ -21112,6 +22158,26 @@ orgCommand.command("set-role").argument("<memberId>").argument("<role>").option(
     "set role"
   );
 });
+orgCommand.command("suspend-member").argument("<memberId>").option("--reason <text>").option("-f, --force").action(async function(id, o) {
+  if (!await confirm(
+    this,
+    o.force,
+    `Suspend organization member ${id}`,
+    `apex org suspend-member ${id} --force`
+  ))
+    return;
+  await run2(this, suspendOrgMember(requireUserCredentials(), id, o.reason), "suspend member");
+});
+orgCommand.command("reinstate-member").argument("<memberId>").option("-f, --force").action(async function(id, o) {
+  if (!await confirm(
+    this,
+    o.force,
+    `Reinstate organization member ${id}`,
+    `apex org reinstate-member ${id} --force`
+  ))
+    return;
+  await run2(this, reinstateOrgMember(requireUserCredentials(), id), "reinstate member");
+});
 orgCommand.command("remove-member").argument("<memberId>").option("-f, --force").action(async function(id, o) {
   if (!await confirm(
     this,