@drip-apex/apex-cli 0.20.0 → 0.21.0

package/README.md

@@ -184,6 +184,7 @@ including every subcommand, argument, option, and alias.
 - `apex keys` — manage shop API keys.
 - `apex org` — inspect and manage the organization.
 - `apex team` — manage shop-scoped members and invitations.
+- `apex notifications` — choose Ready to launch email recipients and toggle ready messages on an existing Slack destination.
 
 ### Experiments and delivery
 
@@ -742,3 +743,23 @@ Unavailable values print `–` (empty in CSV); `*` marks a denominator below 50.
 `apex tracking manifest [manifest]` includes the shop's form definitions in a schemaVersion 1 manifest.
 
 Flag goals: `apex flags create --key banner --name "Banner" --goal <uuid> --goal <uuid> --primary-goal <uuid>`. The same options work on `flags update <id>`; `--goal` replaces the attached set. `flags get <id>` prints goals and marks the primary goal. JSON input can clear the set with `{"goal_ids":[]}`.
+
+### Ready to launch notifications
+
+Use a user API key with `team:read` / `team:write` and the shop permission `members:manage`.
+Every command accepts `--shop <id>` and `--json`; otherwise the selected shop is used.
+
+```sh
+apex notifications ready get --shop <id> --json
+apex notifications ready email set --recipients a@example.com,b@example.com --shop <id>
+apex notifications ready email add --recipients c@example.com --shop <id>
+apex notifications ready email remove --recipients a@example.com --shop <id>
+apex notifications ready email off --shop <id>
+apex notifications ready slack on --shop <id>
+apex notifications ready slack off --shop <id>
+```
+
+Recipients must already be current shop members. Email `off` clears the recipient list.
+Slack `off` removes only `experiment.ready_to_launch` from the existing destination's events.
+Connect or resume Slack in Settings > Integrations; selecting the ready event preserves its pause state.
+There is no master switch. If settings change concurrently, retry the command to read the new version.

package/dist/cli.js

@@ -3074,14 +3074,14 @@ Expecting one of '${allowedValues.join("', '")}'`);
        */
       helpInformation(contextOptions) {
         const helper = this.createHelp();
-        const context = this._getOutputContext(contextOptions);
+        const context2 = this._getOutputContext(contextOptions);
         helper.prepareContext({
-          error: context.error,
-          helpWidth: context.helpWidth,
-          outputHasColors: context.hasColors
+          error: context2.error,
+          helpWidth: context2.helpWidth,
+          outputHasColors: context2.hasColors
         });
         const text2 = helper.formatHelp(this, helper);
-        if (context.hasColors) return text2;
+        if (context2.hasColors) return text2;
         return this._outputConfiguration.stripColor(text2);
       }
       /**
@@ -3243,15 +3243,15 @@ Expecting one of '${allowedValues.join("', '")}'`);
 Expecting one of '${allowedValues.join("', '")}'`);
         }
         const helpEvent = `${position}Help`;
-        this.on(helpEvent, (context) => {
+        this.on(helpEvent, (context2) => {
           let helpStr;
           if (typeof text2 === "function") {
-            helpStr = text2({ error: context.error, command: context.command });
+            helpStr = text2({ error: context2.error, command: context2.command });
           } else {
             helpStr = text2;
           }
           if (helpStr) {
-            context.write(`${helpStr}
+            context2.write(`${helpStr}
 `);
           }
         });
@@ -7210,7 +7210,7 @@ function readStoredCredentials(file = import_node_path.default.join(import_node_
   }
 }
 function resolveCredentials(env2 = process.env, stored = readStoredCredentials()) {
-  const context = {
+  const context2 = {
     orgId: env2.DRIP_ORG || stored?.context?.orgId,
     shopId: env2.DRIP_SHOP || stored?.context?.shopId
   };
@@ -7223,7 +7223,7 @@ function resolveCredentials(env2 = process.env, stored = readStoredCredentials()
       apiKey: environmentApiKey,
       baseUrl: environmentBaseUrl ?? "https://app.drip-apex.com",
       credentialKind: user ? "user" : "shop",
-      resolvedContext: context
+      resolvedContext: context2
     };
   }
   if (stored?.userApiKey) return {
@@ -7231,9 +7231,9 @@ function resolveCredentials(env2 = process.env, stored = readStoredCredentials()
     apiKey: stored.userApiKey,
     baseUrl: stored.userBaseUrl ?? stored.baseUrl,
     credentialKind: "user",
-    resolvedContext: context
+    resolvedContext: context2
   };
-  if (stored?.apiKey) return { ...stored, credentialKind: "shop", resolvedContext: context };
+  if (stored?.apiKey) return { ...stored, credentialKind: "shop", resolvedContext: context2 };
   return null;
 }
 
@@ -7423,7 +7423,7 @@ async function checkForUpdate(current) {
 // package.json
 var package_default = {
   name: "@drip-apex/apex-cli",
-  version: "0.20.0",
+  version: "0.21.0",
   license: "MIT",
   description: "Apex by DRIP CLI: build, preview and run A/B tests on your online shop from the terminal or an AI coding agent (Claude Code, Codex, Cursor).",
   keywords: [
@@ -7546,8 +7546,8 @@ var envelopeContext = {
   shop_id: null,
   credential: initialEnvironmentApiKey?.startsWith("apx_uk_") ? "user" : "shop"
 };
-function setEnvelopeContext(context) {
-  envelopeContext = { ...envelopeContext, ...context };
+function setEnvelopeContext(context2) {
+  envelopeContext = { ...envelopeContext, ...context2 };
 }
 var jsonMode = false;
 var commandName = "apex";
@@ -7955,14 +7955,14 @@ function argvOption(name) {
   return void 0;
 }
 var didWarnStoredContext = false;
-function warnStoredContextFallback(creds, flags, context) {
+function warnStoredContextFallback(creds, flags, context2) {
   if (didWarnStoredContext) return;
   const storedOrg = !flags.orgId && !process.env.DRIP_ORG && Boolean(creds?.context?.orgId);
   const storedShop = !flags.shopId && !process.env.DRIP_SHOP && Boolean(creds?.context?.shopId);
   if (!storedOrg && !storedShop) return;
   const selections = [
-    storedOrg ? `org ${context.orgId}` : null,
-    storedShop ? `shop ${context.shopId}` : null
+    storedOrg ? `org ${context2.orgId}` : null,
+    storedShop ? `shop ${context2.shopId}` : null
   ].filter(Boolean).join(" / ");
   console.error(`Using ${selections} from 'apex use' context (pass --org/--shop to override).`);
   didWarnStoredContext = true;
@@ -7996,21 +7996,21 @@ function resolveContext(creds = getCredentials(), flags = { orgId: argvOption("o
       shopId: flags.shopId || process.env.DRIP_SHOP || void 0
     };
   }
-  const context = {
+  const context2 = {
     orgId: flags.orgId || process.env.DRIP_ORG || creds?.context?.orgId,
     shopId: flags.shopId || process.env.DRIP_SHOP || creds?.context?.shopId
   };
-  warnStoredContextFallback(creds, flags, context);
-  return context;
+  warnStoredContextFallback(creds, flags, context2);
+  return context2;
 }
 function configureInvocationContext() {
   const creds = getCredentials();
   const credential = defaultCredentialKind(creds);
-  const context = resolveContext(creds, void 0, credential);
+  const context2 = resolveContext(creds, void 0, credential);
   setEnvelopeContext({
     credential,
-    org_id: context.orgId ?? null,
-    shop_id: context.shopId ?? null
+    org_id: context2.orgId ?? null,
+    shop_id: context2.shopId ?? null
   });
 }
 var DRIP_DIR = import_node_path3.default.join(import_node_os4.default.homedir(), ".drip");
@@ -8059,15 +8059,15 @@ function requireCredentials(fallbackShopId) {
       EXIT_CODES.auth
     );
   }
-  const context = resolveContext(creds, void 0, defaultCredentialKind(creds));
-  if (!context.shopId) context.shopId = fallbackShopId?.trim() || void 0;
+  const context2 = resolveContext(creds, void 0, defaultCredentialKind(creds));
+  if (!context2.shopId) context2.shopId = fallbackShopId?.trim() || void 0;
   if (defaultCredentialKind(creds) === "user") {
     setEnvelopeContext({
       credential: "user",
-      org_id: context.orgId ?? null,
-      shop_id: context.shopId ?? null
+      org_id: context2.orgId ?? null,
+      shop_id: context2.shopId ?? null
     });
-    if (!context.shopId && !getEnvironmentApiKey()) {
+    if (!context2.shopId && !getEnvironmentApiKey()) {
       throw new CliError(
         'Shop context is required. Run "apex use", or pass --shop <id>.',
         EXIT_CODES.validation,
@@ -8083,22 +8083,22 @@ function requireCredentials(fallbackShopId) {
         userApiKey: environmentApiKey,
         userBaseUrl: creds.baseUrl,
         credentialKind: "user",
-        resolvedContext: context
+        resolvedContext: context2
       }
     ) : {
       ...creds,
       apiKey: creds.userApiKey,
       baseUrl: creds.userBaseUrl ?? creds.baseUrl,
       credentialKind: "user",
-      resolvedContext: context
+      resolvedContext: context2
     };
   }
   setEnvelopeContext({
     credential: "shop",
-    org_id: context.orgId ?? null,
-    shop_id: context.shopId ?? null
+    org_id: context2.orgId ?? null,
+    shop_id: context2.shopId ?? null
   });
-  return { ...creds, credentialKind: "shop", resolvedContext: context };
+  return { ...creds, credentialKind: "shop", resolvedContext: context2 };
 }
 function resolveCheckShop(explicitShopId, fallbackShopId) {
   const explicit = explicitShopId?.trim() || null;
@@ -8157,11 +8157,11 @@ function requireUserCredentials() {
     );
   }
   const resolvedCredentials = creds;
-  const context = resolveContext(creds, void 0, "user");
+  const context2 = resolveContext(creds, void 0, "user");
   setEnvelopeContext({
     credential: "user",
-    org_id: context.orgId ?? null,
-    shop_id: context.shopId ?? null
+    org_id: context2.orgId ?? null,
+    shop_id: context2.shopId ?? null
   });
   return environmentUserKey ? (
     // The user-plane request path reads userApiKey/userBaseUrl, so the
@@ -8172,14 +8172,14 @@ function requireUserCredentials() {
       userApiKey: environmentUserKey,
       userBaseUrl: resolvedCredentials.baseUrl,
       credentialKind: "user",
-      resolvedContext: context
+      resolvedContext: context2
     }
   ) : {
     ...resolvedCredentials,
     apiKey: resolvedCredentials.userApiKey,
     baseUrl: resolvedCredentials.userBaseUrl ?? resolvedCredentials.baseUrl,
     credentialKind: "user",
-    resolvedContext: context
+    resolvedContext: context2
   };
 }
 var CONFIG_NAMES = [".drip.config.ts", ".drip.config.js", "drip.config.ts", "drip.config.js"];
@@ -8257,7 +8257,7 @@ function detectSessionId(env2) {
   const hostId = env2.CLAUDE_CODE_SESSION_ID || env2.CODEX_THREAD_ID;
   return hostId ? `h_${(0, import_node_crypto2.createHash)("sha256").update(hostId).digest("hex").slice(0, 32)}` : void 0;
 }
-function beginInvocation(command, context = {}) {
+function beginInvocation(command, context2 = {}) {
   resolvedPath = telemetryCommandPath(command);
   helpPath = void 0;
   attempted = void 0;
@@ -8280,8 +8280,8 @@ function beginInvocation(command, context = {}) {
     json_mode: shouldUseJson(command),
     tty: process.stdout.isTTY === true,
     credential_kind: process.env.APEX_API_KEY || process.env.DRIP_API_KEY ? "env" : defaultCredentialKind(getCredentials()),
-    org_id: context.orgId,
-    shop_id: context.shopId
+    org_id: context2.orgId,
+    shop_id: context2.shopId
   };
 }
 var staticRouteSegments = /* @__PURE__ */ new Set([
@@ -9555,9 +9555,9 @@ function listOrgMembers(creds) {
     "/api/v1/org/members"
   );
 }
-function inviteOrg(creds, email, org_role, default_shop_role) {
+function inviteOrg(creds, email2, org_role, default_shop_role) {
   return request(userCreds(creds), "POST", "/api/v1/org/invitations", {
-    email,
+    email: email2,
     org_role,
     default_shop_role
   });
@@ -9589,9 +9589,9 @@ function listTeamMembers(creds, shop) {
     `/api/v1/team/members?shop_id=${encodeURIComponent(shop)}`
   );
 }
-function inviteTeam(creds, email, shop_id, role, permission_overrides) {
+function inviteTeam(creds, email2, shop_id, role, permission_overrides) {
   return request(userCreds(creds), "POST", "/api/v1/team/invitations", {
-    email,
+    email: email2,
     shop_id,
     role,
     ...permission_overrides ? { permission_overrides } : {}
@@ -9882,6 +9882,21 @@ function putCommerceDefinition(creds, experiment2, definition2, expectedRevision
     expectedRevision
   });
 }
+function notificationCredentials(creds, shopId) {
+  return { ...creds, resolvedContext: { ...creds.resolvedContext, shopId } };
+}
+function getReadyEmail(creds, shopId) {
+  return userRequest(notificationCredentials(creds, shopId), "GET", `/api/v1/notifications/ready/email?shop_id=${encodeURIComponent(shopId)}`);
+}
+function setReadyEmail(creds, shopId, body6) {
+  return userRequest(notificationCredentials(creds, shopId), "PUT", `/api/v1/notifications/ready/email?shop_id=${encodeURIComponent(shopId)}`, body6);
+}
+function getReadySlack(creds, shopId) {
+  return userRequest(notificationCredentials(creds, shopId), "GET", `/api/v1/notifications/ready/slack?shop_id=${encodeURIComponent(shopId)}`);
+}
+function setReadySlack(creds, shopId, body6) {
+  return userRequest(notificationCredentials(creds, shopId), "PUT", `/api/v1/notifications/ready/slack?shop_id=${encodeURIComponent(shopId)}`, body6);
+}
 
 // src/context.ts
 var import_node_readline = __toESM(require("node:readline"));
@@ -10322,21 +10337,21 @@ var whoamiCommand = new Command("whoami").description("Show your identity, crede
     return;
   }
   if (defaultCredentialKind(stored) === "shop") {
-    const context = resolveContext(stored, void 0, "shop");
+    const context2 = resolveContext(stored, void 0, "shop");
     setEnvelopeContext({
       credential: "shop",
-      org_id: context.orgId ?? null,
-      shop_id: context.shopId ?? null
+      org_id: context2.orgId ?? null,
+      shop_id: context2.shopId ?? null
     });
     const data2 = {
       logged_in: true,
       credential: { kind: "shop" },
-      context: { org_id: context.orgId ?? null, shop_id: context.shopId ?? null }
+      context: { org_id: context2.orgId ?? null, shop_id: context2.shopId ?? null }
     };
     output(this, data2, () => {
       console.log(
         `Credential: shop key (pre-bound server-side)
-Declared shop: ${context.shopId ?? "none \u2014 set DRIP_SHOP to assert one"}
+Declared shop: ${context2.shopId ?? "none \u2014 set DRIP_SHOP to assert one"}
 For account-wide visibility run "apex login" and "apex whoami" without APEX_API_KEY (or DRIP_API_KEY).`
       );
     });
@@ -16181,8 +16196,8 @@ function printFilesystemPlan(plan2) {
   if ((plan2.blockingIssues?.length ?? 0) > 0) {
     console.log(source_default.red("\nBlocking issues"));
     (plan2.blockingIssues ?? []).forEach((issue) => {
-      const context = [issue.path, issue.variation ? `variation: ${issue.variation}` : null].filter(Boolean).join(", ");
-      console.log(`  - [${issue.code}] ${issue.message}${context ? ` (${context})` : ""}`);
+      const context2 = [issue.path, issue.variation ? `variation: ${issue.variation}` : null].filter(Boolean).join(", ");
+      console.log(`  - [${issue.code}] ${issue.message}${context2 ? ` (${context2})` : ""}`);
     });
   }
   if ((plan2.commerceLaunchPreview?.length ?? 0) > 0) {
@@ -17709,8 +17724,8 @@ var experimentStatus = new Command("status").description(
       "Versions are unavailable without a pulled folder. Pull the experiment to compare local files."
     );
   if (creds.credentialKind === "user") {
-    const context = await getAccountContext(creds);
-    const owner = context.data?.data?.orgs?.find(
+    const context2 = await getAccountContext(creds);
+    const owner = context2.data?.data?.orgs?.find(
       (item) => item.shops?.some((item2) => item2.id === shopId)
     );
     if (owner) {
@@ -19096,6 +19111,10 @@ var import_node_path10 = __toESM(require("node:path"));
 var import_node_url2 = require("node:url");
 function toApiBody(exp) {
   return {
+    ...exp.commerce !== void 0 ? {
+      expectedCommerceRevision: exp.commerce.revision,
+      ...exp.commerce.definition !== void 0 ? { definition: exp.commerce.definition } : {}
+    } : {},
     name: exp.name,
     description: exp.description ?? null,
     traffic_allocation: exp.trafficAllocation === void 0 ? 1 : exp.trafficAllocation,
@@ -19106,7 +19125,8 @@ function toApiBody(exp) {
       name: v.name ?? v.id ?? "Unnamed",
       weight: v.weight,
       is_control: v.isControl ?? v.is_control ?? false,
-      mutations: v.mutations ?? [],
+      ...v.mutations !== void 0 ? { mutations: v.mutations } : {},
+      ...(v.artifactHash ?? v.artifact_hash) !== void 0 ? { expectedArtifactHash: v.artifactHash ?? v.artifact_hash } : {},
       custom_css: v.css ?? v.custom_css ?? null,
       custom_js: v.js ?? v.custom_js ?? null,
       reset_js: v.resetJs ?? v.reset_js ?? null,
@@ -19121,7 +19141,7 @@ async function rewriteExperimentAssets(exp, rewrite, baseDir) {
     variations: await Promise.all(
       exp.variations.map(async (variation) => ({
         ...variation,
-        mutations: await rewrite.rewriteUnknown(variation.mutations ?? [], baseDir),
+        ...variation.mutations !== void 0 ? { mutations: await rewrite.rewriteUnknown(variation.mutations, baseDir) } : {},
         css: variation.css === void 0 ? void 0 : await rewrite.rewrite(variation.css, baseDir),
         custom_css: variation.custom_css === void 0 ? void 0 : await rewrite.rewrite(variation.custom_css, baseDir),
         js: variation.js === void 0 ? void 0 : await rewrite.rewrite(variation.js, baseDir),
@@ -19310,7 +19330,9 @@ var pushCommand = new Command("push").description("Push experiment definitions f
         slug: exp.slug,
         status: "failed",
         error: res.error,
-        statusCode: res.status
+        statusCode: res.status,
+        code: typeof res.errorDetails?.code === "string" ? res.errorDetails.code : void 0,
+        details: res.errorDetails
       });
       continue;
     }
@@ -19813,6 +19835,8 @@ function sessionFromWorkspace(input) {
     variationId: input.variationId,
     workspaceId: input.workspace.workspace.id,
     workspaceRevisionId: input.workspace.workspace.currentRevisionId,
+    commerceRevision: input.workspace.commerceRevision,
+    artifactHash: input.workspace.artifactHash,
     checkedOutAt: (/* @__PURE__ */ new Date()).toISOString(),
     files: Object.fromEntries(
       input.workspace.files.map((file) => [
@@ -19902,6 +19926,7 @@ async function syncChangedFiles(folder, session) {
       file.path,
       {
         content: file.content,
+        expected_version: session.files[file.path]?.sha256,
         source: "operator",
         title: `CLI sync ${file.path}`
       }
@@ -19912,6 +19937,13 @@ async function syncChangedFiles(folder, session) {
         classifyStatus(res.status),
         res.errorDetails
       );
+    const saved = res.data;
+    if (saved?.revision?.id) session.workspaceRevisionId = saved.revision.id;
+    session.files[file.path] = {
+      sha256: saved?.file?.sha256 ?? file.sha256,
+      sizeBytes: file.sizeBytes
+    };
+    writeSession(folder, session);
   }
   return { localFiles, changed };
 }
@@ -19920,12 +19952,15 @@ async function runPublish(folderArg, opts = {}) {
   const session = readSession(folder);
   const { localFiles, changed } = await syncChangedFiles(folder, session);
   const creds = requireCredentials();
-  const build = await buildOperatorWorkspace(
-    creds,
-    session.experimentId,
-    session.variationId,
-    opts.allowGoalWrites ? { allowGoalWrites: true } : void 0
-  );
+  const build = await buildOperatorWorkspace(creds, session.experimentId, session.variationId, {
+    ...opts.allowGoalWrites ? { allowGoalWrites: true } : {},
+    expectedCommerceRevision: session.commerceRevision,
+    expectedArtifactHash: session.artifactHash,
+    expectedWorkspaceRevision: session.workspaceRevisionId ?? void 0,
+    expectedFileVersions: Object.fromEntries(
+      Object.entries(session.files).filter(([path22]) => path22 !== "brand.md").map(([path22, file]) => [path22, file.sha256])
+    )
+  });
   if (!build.ok || !build.data?.ok) {
     const issueDetails = formatWorkspaceBlockingIssues(build.data);
     throw new CliError(
@@ -21862,13 +21897,13 @@ async function identifyRuntimeSettingsShop(command, requested) {
   if (credentials.credentialKind === "user") {
     let shopId = requested;
     if (!uuidPattern.test(requested)) {
-      const context = await getAccountContext({
+      const context2 = 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 (!context2.ok || !context2.data)
+        fail(command, context2.error ?? "Shop discovery failed", classifyStatus(context2.status));
+      const match2 = context2.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;
@@ -22484,17 +22519,17 @@ async function identify(command, requestedShop) {
       ...credentials,
       resolvedContext: { ...credentials.resolvedContext, shopId: void 0 }
     };
-    const context = await getAccountContext(discoveryCredentials);
-    if (!context.ok) {
+    const context2 = await getAccountContext(discoveryCredentials);
+    if (!context2.ok) {
       fail(
         command,
-        `${context.status === 401 || context.status === 403 ? "TRIGGERS_AUTH" : "TRIGGERS_CONFIG_ABSENT"}: ${context.error ?? "account context unavailable"}`,
-        classifyStatus(context.status),
-        context.errorDetails,
-        apiFailureOf(context)
+        `${context2.status === 401 || context2.status === 403 ? "TRIGGERS_AUTH" : "TRIGGERS_CONFIG_ABSENT"}: ${context2.error ?? "account context unavailable"}`,
+        classifyStatus(context2.status),
+        context2.errorDetails,
+        apiFailureOf(context2)
       );
     }
-    const match2 = context.data?.data?.orgs?.flatMap((org) => org.shops).find((shop) => shop.domain.toLowerCase() === requestedShop.toLowerCase());
+    const match2 = context2.data?.data?.orgs?.flatMap((org) => org.shops).find((shop) => shop.domain.toLowerCase() === requestedShop.toLowerCase());
     if (!match2) {
       fail(
         command,
@@ -22829,9 +22864,9 @@ async function findLandingDomain(command, host) {
   return row;
 }
 async function verifyOnce(command, id) {
-  const checked = await verifyLandingPageDomain(requireCredentials(), id);
-  if (!checked.ok || !checked.data) domainFail(command, checked, "Failed to verify the domain");
-  return checked.data.data;
+  const checked2 = await verifyLandingPageDomain(requireCredentials(), id);
+  if (!checked2.ok || !checked2.data) domainFail(command, checked2, "Failed to verify the domain");
+  return checked2.data.data;
 }
 var claim = new Command("claim").description("Claim a client hostname for landing pages (CNAME to the Apex edge)").argument("<host>", "hostname the client controls, for example offers.example.com").option("--wait", "check DNS and the certificate every 10 seconds for up to two minutes").action(async function action56(host, opts) {
   const result = await createLandingPageDomain(requireCredentials(), {
@@ -29089,13 +29124,28 @@ var settingsGet = new Command("settings").description("Show platform operator se
     res.data,
     () => printTable(
       ["SETTING", "VALUE"],
-      Object.entries(res.data.data).map(([k, v]) => [k, v ? "on" : "off"])
+      Object.entries(res.data.data).map(([k, v]) => [
+        k,
+        typeof v === "boolean" ? v ? "on" : "off" : String(v)
+      ])
     )
   );
 });
-var set5 = new Command("set").description("Set platform kill switches").option("--guardian <on|off>").option("--srm-check <on|off>").option("--confirm", "Confirm immediate production impact").action(async function(opts) {
-  if (!opts.guardian && !opts.srmCheck) fail(this, "Provide --guardian or --srm-check", 3);
-  let body6 = {};
+var set5 = new Command("set").description("Set platform kill switches").option("--guardian <on|off>").option("--srm-check <on|off>").option("--undo-completion-window-days <days>", "Integer 0..365; 0 disables undo").option("--expected-version <version>", "Policy version returned by admin settings").option("--reason <text>", "Audit reason for a policy change").option("--confirm", "Confirm immediate production impact").action(async function(opts) {
+  if (!opts.guardian && !opts.srmCheck && opts.undoCompletionWindowDays === void 0)
+    fail(this, "Provide --guardian, --srm-check or --undo-completion-window-days", 3);
+  const body6 = {};
+  if (opts.undoCompletionWindowDays !== void 0) {
+    const days = Number(opts.undoCompletionWindowDays);
+    if (!/^(0|[1-9]\d*)$/.test(opts.undoCompletionWindowDays) || days > 365)
+      fail(this, "--undo-completion-window-days must be an integer from 0 to 365", 3);
+    if (!opts.expectedVersion || !opts.reason?.trim() || opts.reason.trim().length > 500)
+      fail(this, "Policy changes require --expected-version and --reason (1..500 characters)", 3);
+    body6.experiment_undo_completion_window_days = days;
+    body6.expected_version = opts.expectedVersion;
+    body6.reason = opts.reason.trim();
+  } else if (opts.expectedVersion || opts.reason)
+    fail(this, "--expected-version and --reason require --undo-completion-window-days", 3);
   try {
     if (opts.guardian) body6.guardian_enabled = switchValue(opts.guardian);
     if (opts.srmCheck) body6.srm_check_enabled = switchValue(opts.srmCheck);
@@ -29105,7 +29155,10 @@ var set5 = new Command("set").description("Set platform kill switches").option("
   if (!opts.confirm) {
     const switches = [
       opts.guardian ? `--guardian ${opts.guardian}` : "",
-      opts.srmCheck ? `--srm-check ${opts.srmCheck}` : ""
+      opts.srmCheck ? `--srm-check ${opts.srmCheck}` : "",
+      opts.undoCompletionWindowDays !== void 0 ? `--undo-completion-window-days ${opts.undoCompletionWindowDays}` : "",
+      opts.expectedVersion ? `--expected-version '${opts.expectedVersion.replaceAll("'", `'"'"'`)}'` : "",
+      opts.reason ? `--reason '${opts.reason.replaceAll("'", `'"'"'`)}'` : ""
     ].filter(Boolean).join(" ");
     confirmationRequired(
       this,
@@ -29619,11 +29672,11 @@ function adminClientLinkRequest(opts) {
     throw new Error("--consultant must be a UUID");
   const teammates = (opts.teammate ?? []).map((value2) => {
     const split = value2.lastIndexOf(":");
-    const email = value2.slice(0, split).trim().toLowerCase();
+    const email2 = value2.slice(0, split).trim().toLowerCase();
     const role = value2.slice(split + 1);
-    if (split < 1 || !/^[^@\s]+@[^@\s]+\.[^@\s]+$/.test(email) || !["editor", "client_viewer"].includes(role))
+    if (split < 1 || !/^[^@\s]+@[^@\s]+\.[^@\s]+$/.test(email2) || !["editor", "client_viewer"].includes(role))
       throw new Error("--teammate must be email:editor or email:client_viewer");
-    return { email, role };
+    return { email: email2, role };
   });
   const discountMonths = opts.discountMonths === "forever" ? null : integerFlag("--discount-months", opts.discountMonths, 1);
   return {
@@ -29677,6 +29730,117 @@ var createClient = new Command("create").description("Create a personal managed-
 var clients = new Command("clients").description("Create managed-client links").addCommand(createClient);
 var adminCommand = new Command("admin").description("Operate allowlisted platform controls").addCommand(settingsGet).addCommand(quarantine).addCommand(shops).addCommand(clients).addCommand(customers);
 
+// src/commands/notifications.ts
+var notificationsCommand = new Command("notifications").description(
+  "Manage notification settings"
+);
+var ready = notificationsCommand.command("ready").description("Ready to launch email recipients and Slack event toggle");
+function context(command, explicit) {
+  const creds = requireUserCredentials();
+  const shopId = explicit ?? creds.resolvedContext?.shopId;
+  if (!shopId) fail(command, "Choose a shop with --shop <id> or apex use <org>/<shop>.", 3);
+  return { creds, shopId };
+}
+function checked(command, response) {
+  if (!response.ok)
+    fail(
+      command,
+      response.status === 409 ? "Notification settings changed. Retry the command." : response.error ?? "Could not read or save notification settings.",
+      classifyStatus(response.status),
+      response.errorDetails,
+      apiFailureOf(response)
+    );
+  if (!response.data) fail(command, "The API returned no notification settings.", 1);
+  return response.data;
+}
+function print(command, data, lines) {
+  output(command, data, () => {
+    for (const line of lines) console.log(line);
+  });
+}
+function emailLine(members, ids) {
+  if (ids.length === 0) return "Email: off (no recipients)";
+  const names = ids.map((id) => members.find((member2) => member2.user_id === id)?.email ?? id);
+  return `Email: ${names.length} recipient${names.length === 1 ? "" : "s"}: ${names.join(", ")}`;
+}
+function slackLine(settings2) {
+  const destination = settings2.destination;
+  if (!destination) return "Slack: not connected";
+  const paused = !destination.active || destination.disabled_at ? " (delivery paused)" : "";
+  return `Slack: ${destination.ready_to_launch ? "on" : "off"}${paused}`;
+}
+ready.command("get").option("--shop <id>").action(async function(options) {
+  const { creds, shopId } = context(this, options.shop);
+  const email2 = checked(this, await getReadyEmail(creds, shopId)).data;
+  assertResponseShop(email2.shop_id, shopId, creds.credentialKind);
+  const slack2 = checked(this, await getReadySlack(creds, shopId)).data;
+  assertResponseShop(slack2.shop_id, shopId, creds.credentialKind);
+  print(this, { email: email2, slack: slack2 }, [
+    emailLine(
+      email2.members,
+      email2.members.filter((member2) => member2.selected).map((member2) => member2.user_id)
+    ),
+    slackLine(slack2)
+  ]);
+});
+var email = ready.command("email").description("Choose current shop members to receive ready emails; off clears recipients");
+for (const operation of ["set", "add", "remove", "off"]) {
+  const command = email.command(operation).option("--shop <id>");
+  if (operation !== "off")
+    command.requiredOption("--recipients <emails>", "Comma-separated shop member emails");
+  command.action(async function(options) {
+    const { creds, shopId } = context(this, options.shop);
+    const current = checked(this, await getReadyEmail(creds, shopId)).data;
+    assertResponseShop(current.shop_id, shopId, creds.credentialKind);
+    const ids = [];
+    if (operation !== "off") {
+      const emails = options.recipients.split(",").map((value2) => value2.trim().toLowerCase());
+      if (emails.some((value2) => !value2))
+        fail(this, "Provide a comma-separated list of member emails without empty entries.", 3);
+      for (const address of new Set(emails)) {
+        const matches = current.members.filter((member2) => member2.email?.toLowerCase() === address);
+        if (matches.length !== 1)
+          fail(this, `Unknown or ambiguous shop member email: ${address}`, 3);
+        ids.push(matches[0].user_id);
+      }
+    }
+    const selected2 = current.members.filter((member2) => member2.selected).map((member2) => member2.user_id);
+    const recipient_user_ids = operation === "off" ? [] : operation === "set" ? ids : operation === "add" ? [.../* @__PURE__ */ new Set([...selected2, ...ids])] : selected2.filter((id) => !ids.includes(id));
+    const saved = checked(
+      this,
+      await setReadyEmail(creds, shopId, { version: current.version, recipient_user_ids })
+    );
+    assertResponseShop(saved.data.shop_id, shopId, creds.credentialKind);
+    print(this, saved, [emailLine(current.members, saved.data.recipient_user_ids)]);
+  });
+}
+var slack = ready.command("slack").description(
+  "Toggle the ready event on an existing Slack destination; other events and pause state stay as configured"
+);
+for (const enabled of [true, false]) {
+  slack.command(enabled ? "on" : "off").option("--shop <id>").action(async function(options) {
+    const { creds, shopId } = context(this, options.shop);
+    const current = checked(this, await getReadySlack(creds, shopId)).data;
+    assertResponseShop(current.shop_id, shopId, creds.credentialKind);
+    if (!current.destination || !current.version)
+      fail(this, "Connect a Slack destination in Settings > Integrations first.", 3);
+    const result = checked(
+      this,
+      await setReadySlack(creds, shopId, {
+        version: current.version,
+        ready_to_launch: enabled
+      })
+    );
+    assertResponseShop(result.data.shop_id, shopId, creds.credentialKind);
+    if (enabled && result.data.destination && (!result.data.destination.active || result.data.destination.disabled_at)) {
+      process.stderr.write(
+        "Ready to launch is selected, but Slack delivery is paused. Resume the destination in Settings > Integrations.\n"
+      );
+    }
+    print(this, result, [slackLine(result.data)]);
+  });
+}
+
 // src/commands/membership.ts
 init_source();
 async function run2(c, p, label) {
@@ -29751,7 +29915,7 @@ orgCommand.command("invite").argument("<email>").option("--role <role>", "Alias
     "--default-shop-role <role>",
     "Default shop role for every brand in the workspace (workspace defaults are internal roles)"
   ).choices(["editor"]).default("editor")
-).action(async function(email, o) {
+).action(async function(email2, o) {
   if (o.role !== void 0) {
     process.stderr.write(
       "Warning: --role is deprecated for apex org invite; use --org-role instead. --role will be removed in v0.7.0.\n"
@@ -29764,7 +29928,7 @@ orgCommand.command("invite").argument("<email>").option("--role <role>", "Alias
   }
   await run2(
     this,
-    inviteOrg(requireUserCredentials(), email, o.role ?? o.orgRole, o.defaultShopRole),
+    inviteOrg(requireUserCredentials(), email2, o.role ?? o.orgRole, o.defaultShopRole),
     "invite member"
   );
 });
@@ -29836,13 +30000,13 @@ teamCommand.command("invite").argument("<email>").option("--shop <id>", teamShop
 ).option(
   "--design-approver",
   "Also let them sign off designs once they accept (a client_viewer with this is a Client approver). Needs store owner or admin rights."
-).action(async function(email, o) {
+).action(async function(email2, o) {
   o.shop = teamShop(this, o.shop);
   await run2(
     this,
     inviteTeam(
       requireUserCredentials(),
-      email,
+      email2,
       o.shop,
       o.role,
       o.designApprover ? { "approvals:design": true } : void 0
@@ -31532,6 +31696,7 @@ program2.addCommand(skillsCommand);
 program2.addCommand(adminCommand, { hidden: true });
 program2.addCommand(orgCommand);
 program2.addCommand(teamCommand);
+program2.addCommand(notificationsCommand);
 program2.addCommand(upgradeCommand);
 addJsonOption(program2);
 registerTelemetryProgram(program2);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@drip-apex/apex-cli",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "license": "MIT",
   "description": "Apex by DRIP CLI: build, preview and run A/B tests on your online shop from the terminal or an AI coding agent (Claude Code, Codex, Cursor).",
   "keywords": [