@siteoshq/cli 1.7.0 → 1.8.1

package/dist/cli.js

@@ -17,7 +17,7 @@ __export(cookie_verification_exports, {
   verificationTarget: () => verificationTarget,
   verifyCookieWebsite: () => verifyCookieWebsite
 });
-import { z as z14 } from "zod";
+import { z as z15 } from "zod";
 function verificationTarget(websiteUrl, candidate) {
   const website = new URL(websiteUrl);
   const target = new URL(candidate ?? websiteUrl, website);
@@ -362,73 +362,73 @@ var Names, Service, Envelope, State, VerificationInstallation;
 var init_cookie_verification = __esm({
   "src/services/cookie-verification.ts"() {
     "use strict";
-    Names = z14.object({
-      exact: z14.array(z14.string()),
-      prefixes: z14.array(z14.string())
-    });
-    Service = z14.object({
-      key: z14.string(),
-      purposeKey: z14.string(),
-      lifecycle: z14.object({
-        scriptOrigins: z14.array(z14.string()),
-        iframeOrigins: z14.array(z14.string()),
-        pixelOrigins: z14.array(z14.string()),
+    Names = z15.object({
+      exact: z15.array(z15.string()),
+      prefixes: z15.array(z15.string())
+    });
+    Service = z15.object({
+      key: z15.string(),
+      purposeKey: z15.string(),
+      lifecycle: z15.object({
+        scriptOrigins: z15.array(z15.string()),
+        iframeOrigins: z15.array(z15.string()),
+        pixelOrigins: z15.array(z15.string()),
         firstPartyCookies: Names,
         localStorage: Names
       }).optional()
     });
-    Envelope = z14.object({
-      publicKey: z14.string(),
-      revision: z14.number(),
-      ruleKey: z14.string(),
-      profileKey: z14.string(),
-      trustedSignals: z14.object({
-        region: z14.object({
-          countryCode: z14.string().nullable(),
-          subdivisionCode: z14.string().nullable()
+    Envelope = z15.object({
+      publicKey: z15.string(),
+      revision: z15.number(),
+      ruleKey: z15.string(),
+      profileKey: z15.string(),
+      trustedSignals: z15.object({
+        region: z15.object({
+          countryCode: z15.string().nullable(),
+          subdivisionCode: z15.string().nullable()
         }).optional()
       }).optional(),
-      config: z14.object({
-        services: z14.array(Service),
-        categories: z14.array(z14.object({ key: z14.string(), required: z14.boolean() })),
-        integrations: z14.object({ googleConsentMode: z14.string() })
+      config: z15.object({
+        services: z15.array(Service),
+        categories: z15.array(z15.object({ key: z15.string(), required: z15.boolean() })),
+        integrations: z15.object({ googleConsentMode: z15.string() })
       })
     });
-    State = z14.object({
-      runtimeVersion: z14.string(),
-      preview: z14.boolean(),
-      resolved: z14.object({
-        publicKey: z14.string(),
-        revision: z14.number(),
-        ruleKey: z14.string(),
-        profileKey: z14.string()
+    State = z15.object({
+      runtimeVersion: z15.string(),
+      preview: z15.boolean(),
+      resolved: z15.object({
+        publicKey: z15.string(),
+        revision: z15.number(),
+        ruleKey: z15.string(),
+        profileKey: z15.string()
       }).nullable(),
-      consent: z14.object({
-        categories: z14.array(z14.string()),
-        decision: z14.string(),
-        globalPrivacyControl: z14.boolean(),
-        privacyChoices: z14.object({
-          saleOrShareOptOut: z14.boolean(),
-          targetedAdvertisingOptOut: z14.boolean()
+      consent: z15.object({
+        categories: z15.array(z15.string()),
+        decision: z15.string(),
+        globalPrivacyControl: z15.boolean(),
+        privacyChoices: z15.object({
+          saleOrShareOptOut: z15.boolean(),
+          targetedAdvertisingOptOut: z15.boolean()
         })
       }),
-      services: z14.array(
-        z14.object({
-          key: z14.string(),
-          allowed: z14.boolean(),
-          footprintPresent: z14.boolean()
+      services: z15.array(
+        z15.object({
+          key: z15.string(),
+          allowed: z15.boolean(),
+          footprintPresent: z15.boolean()
         })
       )
     });
-    VerificationInstallation = z14.object({
-      publicKey: z14.string(),
-      currentPublishedRevision: z14.number().int().positive(),
-      delivery: z14.object({
-        runtimeUrl: z14.string().url(),
-        configUrl: z14.string().url(),
-        analyticsUrl: z14.string().url().nullable(),
-        receiptsUrl: z14.string().url(),
-        handshakeUrl: z14.string().url()
+    VerificationInstallation = z15.object({
+      publicKey: z15.string(),
+      currentPublishedRevision: z15.number().int().positive(),
+      delivery: z15.object({
+        runtimeUrl: z15.string().url(),
+        configUrl: z15.string().url(),
+        analyticsUrl: z15.string().url().nullable(),
+        receiptsUrl: z15.string().url(),
+        handshakeUrl: z15.string().url()
       })
     });
   }
@@ -3816,10 +3816,10 @@ async function runSubmissionsCommand(options) {
     return usageError2(
       "Use new, read, archived or spam for --status and --expected-status."
     );
-  const filters = new URLSearchParams();
+  const filters2 = new URLSearchParams();
   for (const key of ["query", "status", "from", "to", "limit", "cursor"]) {
     const item = value(key);
-    if (item) filters.set(key, item);
+    if (item) filters2.set(key, item);
   }
   const limit = Number(value("limit") ?? 50);
   if (!Number.isInteger(limit) || limit < 1 || limit > 100)
@@ -3856,7 +3856,7 @@ async function runSubmissionsCommand(options) {
       environmentId: environment.id,
       formId
     };
-    const response = action === "list" ? await context.client.listSubmissions({ ...input, filters }) : action === "read" ? await context.client.readSubmission({
+    const response = action === "list" ? await context.client.listSubmissions({ ...input, filters: filters2 }) : action === "read" ? await context.client.readSubmission({
       ...input,
       submissionId
     }) : await context.client.updateSubmissionStatus({
@@ -9479,7 +9479,111 @@ async function runEnvironmentCommand3(options) {
 import { readFile as readFile16, stat } from "fs/promises";
 import path28 from "path";
 import { parseArgs as parseArgs3 } from "util";
-import { z as z15 } from "zod";
+import { z as z16 } from "zod";
+
+// src/services/trace-explorer-command.ts
+import { z as z14 } from "zod";
+var filters = [
+  "environment",
+  "provider",
+  "event",
+  "property",
+  "page-view",
+  "search",
+  "state",
+  "rule",
+  "kind",
+  "period",
+  "cursor"
+];
+var TRACE_EXPLORER_FLAGS = {
+  destinations: filters,
+  events: filters,
+  properties: filters,
+  issues: filters,
+  observations: filters,
+  "issue show": ["environment", "id", "cursor"],
+  "observation show": ["environment", "batch-id", "event-id"]
+};
+var FilterValues = z14.object({
+  provider: z14.enum([
+    "siteos_analytics",
+    "ga4",
+    "google_ads",
+    "hubspot",
+    "meta",
+    "custom"
+  ]).optional(),
+  event: z14.string().min(1).max(160).optional(),
+  property: z14.string().min(1).max(160).optional(),
+  "page-view": z14.string().uuid().optional(),
+  search: z14.string().max(160).optional(),
+  state: z14.enum([
+    "all",
+    "active",
+    "snoozed",
+    "resolved",
+    "new",
+    "issues",
+    "tracked",
+    "ignored"
+  ]).optional(),
+  rule: z14.string().min(1).max(80).optional(),
+  kind: z14.enum([
+    "data_layer",
+    "fetch",
+    "xhr",
+    "beacon",
+    "resource",
+    "consent",
+    "heartbeat",
+    "runtime_diagnostic"
+  ]).optional(),
+  period: z14.enum(["24h", "7d"]).optional(),
+  cursor: z14.string().min(1).max(4096).optional()
+});
+function traceExplorerSuffix(route, values) {
+  if (!TRACE_EXPLORER_FLAGS[route]) return null;
+  const query = new URLSearchParams();
+  if (route === "issue show" || route === "observation show") {
+    const keys = route === "issue show" ? ["id"] : ["batch-id", "event-id"];
+    for (const key of keys) {
+      if (!z14.string().uuid().safeParse(values[key]).success)
+        throw new Error(`Use --${key} with the UUID returned by Trace.`);
+    }
+    if (values.cursor !== void 0) {
+      if (!z14.string().uuid().safeParse(values.cursor).success)
+        throw new Error(
+          "Use --cursor with the nextCursor returned by this issue."
+        );
+      query.set("cursor", values.cursor);
+    }
+    const suffix = route === "issue show" ? `/issues/${encodeURIComponent(values.id)}` : `/observations/${encodeURIComponent(values["batch-id"])}/${encodeURIComponent(values["event-id"])}`;
+    return `${suffix}${query.size ? `?${query}` : ""}`;
+  }
+  const parsed = FilterValues.safeParse(values);
+  if (!parsed.success) {
+    const flag = parsed.error.issues[0]?.path[0];
+    throw new Error(
+      `Invalid --${String(flag)} filter. Run \`siteos trace --help\`.`
+    );
+  }
+  for (const [key, value] of Object.entries(parsed.data)) {
+    if (value !== void 0)
+      query.set(key === "page-view" ? "pageView" : key, value);
+  }
+  return `/${route}${query.size ? `?${query}` : ""}`;
+}
+function tracePublicationVersion(value) {
+  if (value === void 0) return void 0;
+  if (!/^[1-9]\d*$/u.test(value) || !Number.isSafeInteger(Number(value)))
+    throw new Error(
+      "Use --expected-draft-version with a positive integer from the reviewed plan."
+    );
+  return Number(value);
+}
+
+// src/services/service-command.ts
 var SERVICE_HELP = {
   cookie: `Manage Cookie for the selected SiteOS Project.
 
@@ -9506,12 +9610,27 @@ Usage:
   siteos trace status [--json]
   siteos trace environments [--json]
   siteos trace report [--environment <slug>] [--json]
+  siteos trace destinations [--environment <slug>] [--period <24h|7d>] [--cursor <cursor>] [--json]
+  siteos trace events [--environment <slug>] [--provider <provider>] [--event <name>] [--search <text>] [--state <all|new|issues|tracked|ignored>] [--period <24h|7d>] [--cursor <cursor>] [--json]
+  siteos trace properties [--environment <slug>] [--provider <provider>] [--event <name>] [--property <name>] [--search <text>] [--period <24h|7d>] [--cursor <cursor>] [--json]
+  siteos trace issues [--environment <slug>] [--provider <provider>] [--event <name>] [--state <all|active|snoozed|resolved|new>] [--rule <rule>] [--search <text>] [--period <24h|7d>] [--cursor <cursor>] [--json]
+  siteos trace observations [--environment <slug>] [--provider <provider>] [--event <name>] [--kind <kind>] [--page-view <uuid>] [--search <text>] [--period <24h|7d>] [--cursor <cursor>] [--json]
+  siteos trace issue show --id <uuid> [--environment <slug>] [--cursor <finding-cursor>] [--json]
+  siteos trace observation show --batch-id <uuid> --event-id <uuid> [--environment <slug>] [--json]
   siteos trace installation <show|ensure|save|publish> [--environment <slug>] [--input <draft.json>] [--json]
   siteos trace tracking-plan <show|ensure|save|publish> [--environment <slug>] [--input <plan.json>] [--json]
+  siteos trace tracking-plan publish --expected-draft-version <number> [--environment <slug>] [--json]
 
 Start with siteos project use, then siteos project connect trace.
 Commands use the selected Project environment. Save requires --input with expectedDraftVersion.
-Ensure creates a draft; publish activates the reviewed configuration.`,
+Ensure creates a draft; publish activates the reviewed configuration.
+Use --expected-draft-version when publishing a reviewed tracking plan; a conflict needs a fresh review.
+Explorer commands require the matching Trace server. They read one page and return nextCursor.
+Reuse the same filters with that cursor; omit it to start a fresh time window.
+Providers: siteos_analytics, ga4, google_ads, hubspot, meta, custom (data layer source).
+Kinds: data_layer, fetch, xhr, beacon, resource, consent, heartbeat, runtime_diagnostic.
+Lists also accept --provider, --event, --property, --page-view, --search, --state, --rule and --kind.
+Destinations are observed analytics services; a data layer event alone does not prove delivery.`,
   integrations: `Manage shared Organization connections and notification destinations.
 
 Usage:
@@ -9544,7 +9663,20 @@ async function runServiceCommand(service, options) {
         subdivision: { type: "string" },
         source: { type: "string" },
         url: { type: "string" },
-        browser: { type: "string" }
+        browser: { type: "string" },
+        provider: { type: "string" },
+        event: { type: "string" },
+        property: { type: "string" },
+        "page-view": { type: "string" },
+        search: { type: "string" },
+        state: { type: "string" },
+        rule: { type: "string" },
+        kind: { type: "string" },
+        period: { type: "string" },
+        id: { type: "string" },
+        "batch-id": { type: "string" },
+        "event-id": { type: "string" },
+        "expected-draft-version": { type: "string" }
       }
     });
     const [action, subaction] = positionals;
@@ -9567,6 +9699,7 @@ async function runServiceCommand(service, options) {
         status: [],
         environments: [],
         report: ["environment"],
+        ...TRACE_EXPLORER_FLAGS,
         ...Object.fromEntries(
           ["installation", "tracking-plan"].flatMap(
             (section) => ["show", "ensure", "save", "publish"].map((operation) => [
@@ -9574,7 +9707,8 @@ async function runServiceCommand(service, options) {
               operation === "save" ? ["environment", "input"] : ["environment"]
             ])
           )
-        )
+        ),
+        "tracking-plan publish": ["environment", "expected-draft-version"]
       },
       integrations: {
         status: [],
@@ -9598,6 +9732,10 @@ async function runServiceCommand(service, options) {
       throw new Error(
         "Destination creation requires --channel <provider-channel-id>."
       );
+    const explorerSuffix = service === "trace" ? traceExplorerSuffix(route, values) : null;
+    const expectedDraftVersion = tracePublicationVersion(
+      values["expected-draft-version"]
+    );
     const runtime = commonProjectRuntime(options);
     const common = service === "integrations" ? null : await commonServiceContext(
       options,
@@ -9637,8 +9775,8 @@ async function runServiceCommand(service, options) {
       );
       const result2 = await response.json();
       if (!response.ok) {
-        const error = z15.object({
-          error: z15.object({ code: z15.string(), message: z15.string().max(500) })
+        const error = z16.object({
+          error: z16.object({ code: z16.string(), message: z16.string().max(500) })
         }).safeParse(result2);
         throw new SiteOSAuthApiError({
           code: error.success ? error.data.error.code : "SERVICE_REQUEST_FAILED",
@@ -9670,9 +9808,9 @@ async function runServiceCommand(service, options) {
           await inputFile(),
           "cookie:workspace:read"
         );
-        const validation = z15.object({
-          valid: z15.boolean(),
-          draftVersionMatches: z15.boolean().optional()
+        const validation = z16.object({
+          valid: z16.boolean(),
+          draftVersionMatches: z16.boolean().optional()
         }).parse(result);
         if (!validation.valid || validation.draftVersionMatches === false)
           return { exitCode: 2, stdout: JSON.stringify(result, null, 2) };
@@ -9711,11 +9849,11 @@ async function runServiceCommand(service, options) {
       } else if (action === "installation")
         result = await request(`${site}/installation`);
       else if (action === "draft" && subaction === "get" && positionals.length === 2) {
-        const response = z15.object({
-          name: z15.string(),
-          hostname: z15.string(),
-          draftVersion: z15.number(),
-          draft: z15.unknown()
+        const response = z16.object({
+          name: z16.string(),
+          hostname: z16.string(),
+          draftVersion: z16.number(),
+          draft: z16.unknown()
         }).parse(await request(site));
         result = {
           name: response.name,
@@ -9746,10 +9884,10 @@ async function runServiceCommand(service, options) {
         result = await request(site);
       else if (action === "environments" && positionals.length === 1)
         result = await request(`${site}/environments`);
-      else if (action === "report" || action === "installation" || action === "tracking-plan") {
-        const response = z15.object({
-          environments: z15.array(
-            z15.object({ id: z15.string(), slug: z15.string() })
+      else if (action === "report" || action === "installation" || action === "tracking-plan" || explorerSuffix !== null) {
+        const response = z16.object({
+          environments: z16.array(
+            z16.object({ id: z16.string(), slug: z16.string() })
           )
         }).parse(await request(`${site}/environments`));
         const environment = common.overview.project.environments.find(
@@ -9773,12 +9911,14 @@ async function runServiceCommand(service, options) {
             "Choose an environment from `siteos trace environments`."
           );
         const base = `/environments/${encodeURIComponent(matches[0].id)}`;
-        if (action === "report" && positionals.length === 1) {
-          const detail = z15.object({
-            site: z15.object({
-              id: z15.literal(common.resourceId),
-              environments: z15.array(
-                z15.object({ id: z15.string(), evidence: z15.unknown() })
+        if (explorerSuffix !== null) {
+          result = await request(`${base}${explorerSuffix}`);
+        } else if (action === "report" && positionals.length === 1) {
+          const detail = z16.object({
+            site: z16.object({
+              id: z16.literal(common.resourceId),
+              environments: z16.array(
+                z16.object({ id: z16.string(), evidence: z16.unknown() })
               )
             })
           }).parse(await request(site));
@@ -9800,7 +9940,7 @@ async function runServiceCommand(service, options) {
           result = await request(
             `${base}/${action}/${subaction}`,
             "POST",
-            {},
+            expectedDraftVersion === void 0 ? {} : { expectedDraftVersion },
             subaction === "publish" ? "trace:publication:write" : void 0
           );
         else
@@ -9836,7 +9976,7 @@ async function runServiceCommand(service, options) {
   } catch (cause) {
     return {
       exitCode: cause instanceof SiteOSAuthApiError ? 1 : 2,
-      stderr: cause instanceof SiteOSAuthApiError || !(cause instanceof z15.ZodError) && cause instanceof Error ? cause.message : "The service returned an invalid response."
+      stderr: cause instanceof SiteOSAuthApiError || !(cause instanceof z16.ZodError) && cause instanceof Error ? cause.message : "The service returned an invalid response."
     };
   }
 }
@@ -9845,7 +9985,7 @@ async function runServiceCommand(service, options) {
 import { readFile as readFile17, stat as stat2 } from "fs/promises";
 import path29 from "path";
 import { parseArgs as parseArgs4 } from "util";
-import { z as z16 } from "zod";
+import { z as z17 } from "zod";
 var ANALYTICS_HELP = `Set up website Analytics in the selected Project environment.
 
 Usage:
@@ -9876,27 +10016,27 @@ Settings require an owner/admin, the current revision and at least one change.
 Catalog files are bounded JSON using the documented event/campaign/goal/funnel contracts.
 Monitoring preparation creates a Trace draft only; publication remains a separate operation.
 Analytics is Unlimited during early access. No synthetic events are sent by these commands.`;
-var EventInput = z16.object({
-  name: z16.string().regex(/^[a-z][a-z0-9_]{0,63}$/u).refine((v) => v !== "pageview" && !v.startsWith("cookie_")),
-  label: z16.string().trim().min(1).max(80),
-  properties: z16.record(
-    z16.string().regex(/^[a-z][a-z0-9_]{0,39}$/u),
-    z16.array(
-      z16.string().min(1).max(80).regex(/^[a-zA-Z0-9 _./:-]+$/u)
+var EventInput = z17.object({
+  name: z17.string().regex(/^[a-z][a-z0-9_]{0,63}$/u).refine((v) => v !== "pageview" && !v.startsWith("cookie_")),
+  label: z17.string().trim().min(1).max(80),
+  properties: z17.record(
+    z17.string().regex(/^[a-z][a-z0-9_]{0,39}$/u),
+    z17.array(
+      z17.string().min(1).max(80).regex(/^[a-zA-Z0-9 _./:-]+$/u)
     ).min(1).max(20)
   ).refine((v) => Object.keys(v).length <= 8)
 }).strict();
-var Resource = z16.object({
-  id: z16.string(),
-  organizationId: z16.string(),
-  name: z16.string(),
-  slug: z16.string(),
-  origin: z16.string().url(),
-  publicKey: z16.string(),
-  revision: z16.number().int().positive(),
-  enabled: z16.boolean(),
-  cookieEvents: z16.boolean(),
-  minimalRealtime: z16.boolean()
+var Resource = z17.object({
+  id: z17.string(),
+  organizationId: z17.string(),
+  name: z17.string(),
+  slug: z17.string(),
+  origin: z17.string().url(),
+  publicKey: z17.string(),
+  revision: z17.number().int().positive(),
+  enabled: z17.boolean(),
+  cookieEvents: z17.boolean(),
+  minimalRealtime: z17.boolean()
 });
 var readKeys = [
   "days",
@@ -10022,7 +10162,7 @@ async function runAnalyticsCommand(options) {
       throw new Error("Use --days 1, 7 or 28.");
     if (values.country && !/^(?:[A-Z]{2}|unknown)$/u.test(values.country))
       throw new Error("Use an uppercase ISO country code or unknown.");
-    if (values.campaign) z16.string().uuid().parse(values.campaign);
+    if (values.campaign) z17.string().uuid().parse(values.campaign);
     const setting = route === "settings set", creating = positionals[1] === "create", archive = positionals[1] === "archive";
     let body;
     if (setting) {
@@ -10058,9 +10198,9 @@ async function runAnalyticsCommand(options) {
       } catch {
         throw new Error("The definition must contain valid JSON.");
       }
-      body = z16.record(z16.unknown()).parse(definition);
+      body = z17.record(z17.unknown()).parse(definition);
       if (action === "events") body = EventInput.parse(body);
-    } else if (archive) body = { id: z16.string().uuid().parse(positionals[2]) };
+    } else if (archive) body = { id: z17.string().uuid().parse(positionals[2]) };
     const context = await commonServiceContext(
       options,
       "analytics",
@@ -10101,8 +10241,8 @@ async function runAnalyticsCommand(options) {
     );
     const value = await response.json();
     if (!response.ok) {
-      const error = z16.object({
-        error: z16.object({ code: z16.string(), message: z16.string().max(500) })
+      const error = z17.object({
+        error: z17.object({ code: z17.string(), message: z17.string().max(500) })
       }).safeParse(value);
       throw new SiteOSAuthApiError({
         code: error.success ? error.data.error.code : "ANALYTICS_REQUEST_FAILED",
@@ -10110,9 +10250,9 @@ async function runAnalyticsCommand(options) {
         status: response.status
       });
     }
-    const record = z16.object({
-      contractVersion: z16.literal(1),
-      resourceId: z16.literal(context.resourceId)
+    const record = z17.object({
+      contractVersion: z17.literal(1),
+      resourceId: z17.literal(context.resourceId)
     }).passthrough().parse(value);
     let output;
     if (setting) {
@@ -10131,16 +10271,16 @@ async function runAnalyticsCommand(options) {
           throw new Error("The saved event does not match this definition.");
       } else
         output = {
-          id: z16.string().uuid().parse(record.id),
+          id: z17.string().uuid().parse(record.id),
           ...pick(
             record,
             action === "campaigns" ? ["label", "source", "medium", "campaign"] : action === "goals" ? ["label", "match"] : ["label", "steps"]
           )
         };
     } else if (archive)
-      output = { archived: z16.literal(true).parse(record.archived) };
+      output = { archived: z17.literal(true).parse(record.archived) };
     else if (route === "monitoring prepare")
-      output = { state: z16.literal("prepared").parse(record.state) };
+      output = { state: z17.literal("prepared").parse(record.state) };
     else if (action === "realtime") output = pick(record, liveKeys);
     else {
       const resource = Resource.parse(record.resource);
@@ -10152,8 +10292,8 @@ async function runAnalyticsCommand(options) {
         output = {
           resource,
           lastReceivedAt: record.lastReceivedAt,
-          consentSource: z16.object({
-            consentSource: z16.enum([
+          consentSource: z17.object({
+            consentSource: z17.enum([
               "cookie",
               "external",
               "waiting_for_cookie",
@@ -10165,11 +10305,11 @@ async function runAnalyticsCommand(options) {
       else if (action === "installation")
         output = {
           resource,
-          installation: z16.string().parse(record.installation),
+          installation: z17.string().parse(record.installation),
           configuration: record.configuration
         };
       else if (action === "events") {
-        const definitions = z16.array(EventInput).parse(record.definitions);
+        const definitions = z17.array(EventInput).parse(record.definitions);
         if (route === "events snippet") {
           const definition = definitions.find((d) => d.name === positionals[2]);
           if (!definition)
@@ -10183,13 +10323,13 @@ async function runAnalyticsCommand(options) {
           };
         } else output = { definitions, eventCounts: record.eventCounts };
       } else
-        output = action === "report" ? pick(record, readKeys) : { [action]: z16.array(z16.unknown()).parse(record[action]) };
+        output = action === "report" ? pick(record, readKeys) : { [action]: z17.array(z17.unknown()).parse(record[action]) };
     }
     return { exitCode: 0, stdout: JSON.stringify(output, null, 2) };
   } catch (cause) {
     const error = cause instanceof SiteOSAuthApiError ? { code: cause.code, message: cause.message } : {
       code: "ANALYTICS_COMMAND_FAILED",
-      message: cause instanceof z16.ZodError ? "The Analytics input or response does not match the supported contract." : cause instanceof Error ? cause.message : "The Analytics command failed."
+      message: cause instanceof z17.ZodError ? "The Analytics input or response does not match the supported contract." : cause instanceof Error ? cause.message : "The Analytics command failed."
     };
     return {
       exitCode: cause instanceof SiteOSAuthApiError ? 1 : 2,
@@ -10202,7 +10342,7 @@ async function runAnalyticsCommand(options) {
 import { writeFile as writeFile9 } from "fs/promises";
 import path31 from "path";
 import { parseArgs as parseArgs6 } from "util";
-import { z as z18 } from "zod";
+import { z as z19 } from "zod";
 
 // src/services/seo-performance-command.ts
 import { randomUUID as randomUUID6 } from "crypto";
@@ -10210,7 +10350,7 @@ import { writeFile as writeFile8 } from "fs/promises";
 import path30 from "path";
 import { setTimeout as setTimeout2 } from "timers/promises";
 import { parseArgs as parseArgs5 } from "util";
-import { z as z17 } from "zod";
+import { z as z18 } from "zod";
 var PERFORMANCE_HELP = `
   siteos seo performance run --audit <id> --url <url> [--url <url>...] [--device <mobile|desktop>] [--idempotency-key <key>] [--environment <slug>] [--json]
   siteos seo performance list [--device <mobile|desktop>] [--environment <slug>] [--json]
@@ -10298,12 +10438,12 @@ async function runSeoPerformanceCommand(options) {
     const runtime = commonProjectRuntime(options);
     const writing = ["run", "cancel"].includes(action);
     const scope = writing ? "seo:audits:write" : "seo:workspace:read";
-    const batchSchema = z17.object({
-      id: z17.string(),
-      resourceId: z17.literal(context.resourceId),
-      organizationId: z17.literal(context.overview.project.organizationId),
-      sourceAuditId: z17.string(),
-      state: z17.enum([
+    const batchSchema = z18.object({
+      id: z18.string(),
+      resourceId: z18.literal(context.resourceId),
+      organizationId: z18.literal(context.overview.project.organizationId),
+      sourceAuditId: z18.string(),
+      state: z18.enum([
         "queued",
         "running",
         "completed",
@@ -10311,8 +10451,8 @@ async function runSeoPerformanceCommand(options) {
         "failed",
         "cancelled"
       ]),
-      device: z17.enum(["mobile", "desktop"]),
-      urls: z17.array(z17.string()).min(1).max(10)
+      device: z18.enum(["mobile", "desktop"]),
+      urls: z18.array(z18.string()).min(1).max(10)
     }).passthrough();
     const query = new URLSearchParams();
     if (values.device) query.set("device", values.device);
@@ -10360,10 +10500,10 @@ async function runSeoPerformanceCommand(options) {
           );
         const text = await response.text();
         if (values.format === "json") {
-          const parsed = z17.object({
-            contractVersion: z17.literal(1),
+          const parsed = z18.object({
+            contractVersion: z18.literal(1),
             batch: batchSchema,
-            pages: z17.array(z17.unknown())
+            pages: z18.array(z18.unknown())
           }).parse(JSON.parse(text));
           if (parsed.batch.id !== id)
             throw new Error(
@@ -10386,8 +10526,8 @@ async function runSeoPerformanceCommand(options) {
       }
       const data = await response.json();
       if (!response.ok) {
-        const error = z17.object({
-          error: z17.object({ code: z17.string(), message: z17.string().max(500) })
+        const error = z18.object({
+          error: z18.object({ code: z18.string(), message: z18.string().max(500) })
         }).safeParse(data);
         throw new SiteOSAuthApiError({
           code: error.success ? error.data.error.code : "SEO_REQUEST_FAILED",
@@ -10395,8 +10535,8 @@ async function runSeoPerformanceCommand(options) {
           status: response.status
         });
       }
-      const record = z17.object({ contractVersion: z17.literal(1) }).passthrough().parse(data);
-      if (action === "cancel") z17.literal(true).parse(record.cancelled);
+      const record = z18.object({ contractVersion: z18.literal(1) }).passthrough().parse(data);
+      if (action === "cancel") z18.literal(true).parse(record.cancelled);
       else if (action === "run") {
         const accepted = batchSchema.parse(record.batch);
         const normalize = (url) => {
@@ -10409,8 +10549,8 @@ async function runSeoPerformanceCommand(options) {
             "The queued check does not match the requested source, device and URLs."
           );
       } else {
-        z17.literal(context.resourceId).parse(record.resourceId);
-        z17.array(batchSchema).parse(record.batches);
+        z18.literal(context.resourceId).parse(record.resourceId);
+        z18.array(batchSchema).parse(record.batches);
         const selected = batchSchema.nullable().parse(record.batch);
         if (id && selected?.id !== id)
           throw new Error(
@@ -10437,7 +10577,7 @@ async function runSeoPerformanceCommand(options) {
   } catch (cause) {
     const error = {
       code: cause instanceof SiteOSAuthApiError ? cause.code : "SEO_COMMAND_FAILED",
-      message: cause instanceof z17.ZodError ? "The SEO service returned an invalid response." : cause instanceof Error ? cause.message : "The performance command failed."
+      message: cause instanceof z18.ZodError ? "The SEO service returned an invalid response." : cause instanceof Error ? cause.message : "The performance command failed."
     };
     return {
       exitCode: cause instanceof SiteOSAuthApiError ? 1 : 2,
@@ -10703,15 +10843,15 @@ async function runSeoCommand(options) {
         );
       const text = await response.text();
       if (values.format === "json")
-        z18.object({
-          contractVersion: z18.literal(1),
-          audit: z18.object({
-            id: z18.literal(values.audit),
-            resourceId: z18.literal(context.resourceId)
+        z19.object({
+          contractVersion: z19.literal(1),
+          audit: z19.object({
+            id: z19.literal(values.audit),
+            resourceId: z19.literal(context.resourceId)
           }),
-          kind: z18.literal(values.kind),
-          totalRows: z18.literal(rows),
-          rows: z18.array(z18.unknown()).length(rows)
+          kind: z19.literal(values.kind),
+          totalRows: z19.literal(rows),
+          rows: z19.array(z19.unknown()).length(rows)
         }).parse(JSON.parse(text));
       const output = path31.resolve(options.cwd ?? process.cwd(), values.output);
       await writeFile9(output, text, { flag: "wx", mode: 384 });
@@ -10732,8 +10872,8 @@ async function runSeoCommand(options) {
     }
     const data = await response.json();
     if (!response.ok) {
-      const result = z18.object({
-        error: z18.object({ code: z18.string(), message: z18.string().max(500) })
+      const result = z19.object({
+        error: z19.object({ code: z19.string(), message: z19.string().max(500) })
       }).safeParse(data);
       throw new SiteOSAuthApiError({
         code: result.success ? result.data.error.code : "SEO_REQUEST_FAILED",
@@ -10741,34 +10881,34 @@ async function runSeoCommand(options) {
         status: response.status
       });
     }
-    const record = z18.object({ contractVersion: z18.literal(1) }).passthrough().parse(data);
+    const record = z19.object({ contractVersion: z19.literal(1) }).passthrough().parse(data);
     if (automation) {
-      z18.literal(context.resourceId).parse(record.resourceId);
-      const schedule = z18.object({
-        enabled: z18.boolean(),
-        weekday: z18.number().int().min(1).max(7),
-        time: z18.string(),
-        timeZone: z18.string(),
-        revision: z18.number().int().min(0),
-        nextRunAt: z18.string().nullable()
+      z19.literal(context.resourceId).parse(record.resourceId);
+      const schedule = z19.object({
+        enabled: z19.boolean(),
+        weekday: z19.number().int().min(1).max(7),
+        time: z19.string(),
+        timeZone: z19.string(),
+        revision: z19.number().int().min(0),
+        nextRunAt: z19.string().nullable()
       });
-      const notificationRoute = z18.object({
-        enabled: z18.boolean(),
-        minimumSeverity: z18.enum(["error", "warning"]),
-        includeFailures: z18.boolean(),
-        revision: z18.number().int().min(0),
-        destinationId: z18.string().nullable()
+      const notificationRoute = z19.object({
+        enabled: z19.boolean(),
+        minimumSeverity: z19.enum(["error", "warning"]),
+        includeFailures: z19.boolean(),
+        revision: z19.number().int().min(0),
+        destinationId: z19.string().nullable()
       });
       if (retryNotification) {
-        z18.literal(true).parse(record.retryQueued);
-        z18.literal(positionals[2]).parse(record.notificationId);
+        z19.literal(true).parse(record.retryQueued);
+        z19.literal(positionals[2]).parse(record.notificationId);
       } else if (route === "notifications destinations")
-        z18.object({
-          candidates: z18.array(
-            z18.object({
-              candidateId: z18.string(),
-              label: z18.string(),
-              availability: z18.literal("available")
+        z19.object({
+          candidates: z19.array(
+            z19.object({
+              candidateId: z19.string(),
+              label: z19.string(),
+              availability: z19.literal("available")
             })
           )
         }).parse(record);
@@ -10781,46 +10921,46 @@ async function runSeoCommand(options) {
         notificationRoute.parse(record.route);
       }
     } else if (!writing) {
-      const validated = z18.object({
-        resource: z18.object({
-          id: z18.literal(context.resourceId),
-          organizationId: z18.literal(context.overview.project.organizationId)
+      const validated = z19.object({
+        resource: z19.object({
+          id: z19.literal(context.resourceId),
+          organizationId: z19.literal(context.overview.project.organizationId)
         }),
-        audits: z18.array(z18.object({ id: z18.string() }).passthrough()),
-        audit: z18.object({
-          id: z18.string(),
-          resourceId: z18.literal(context.resourceId)
+        audits: z19.array(z19.object({ id: z19.string() }).passthrough()),
+        audit: z19.object({
+          id: z19.string(),
+          resourceId: z19.literal(context.resourceId)
         }).passthrough().nullable(),
-        pages: z18.array(z18.unknown()),
-        issues: z18.array(z18.unknown()),
-        changes: z18.array(z18.unknown()),
-        totalChanges: z18.number(),
-        dispositions: z18.array(z18.unknown())
+        pages: z19.array(z19.unknown()),
+        issues: z19.array(z19.unknown()),
+        changes: z19.array(z19.unknown()),
+        totalChanges: z19.number(),
+        dispositions: z19.array(z19.unknown())
       }).passthrough().parse(record);
       const selected = query.get("audit");
       if (selected && validated.audit?.id !== selected)
         throw new Error("The SEO response does not match the requested audit.");
     } else if (record.audit)
-      z18.object({
-        id: z18.string(),
-        resourceId: z18.literal(context.resourceId),
-        organizationId: z18.literal(context.overview.project.organizationId),
-        state: z18.literal("queued")
+      z19.object({
+        id: z19.string(),
+        resourceId: z19.literal(context.resourceId),
+        organizationId: z19.literal(context.overview.project.organizationId),
+        state: z19.literal("queued")
       }).parse(record.audit);
-    else if (route === "audit cancel") z18.literal(true).parse(record.cancelled);
+    else if (route === "audit cancel") z19.literal(true).parse(record.cancelled);
     else if (action === "issue")
-      z18.object({
-        url: z18.literal(values.url),
-        ruleId: z18.literal(values.rule),
-        ignored: z18.literal(positionals[1] === "ignore"),
-        revision: z18.literal(Number(values.revision) + 1)
+      z19.object({
+        url: z19.literal(values.url),
+        ruleId: z19.literal(values.rule),
+        ignored: z19.literal(positionals[1] === "ignore"),
+        revision: z19.literal(Number(values.revision) + 1)
       }).parse(record.disposition);
     else throw new Error("The SEO service returned an invalid response.");
     return { exitCode: 0, stdout: JSON.stringify(record, null, 2) };
   } catch (cause) {
     const error = {
       code: cause instanceof SiteOSAuthApiError ? cause.code : "SEO_COMMAND_FAILED",
-      message: cause instanceof z18.ZodError ? "The SEO service returned an invalid response." : cause instanceof Error ? cause.message : "The SEO command failed."
+      message: cause instanceof z19.ZodError ? "The SEO service returned an invalid response." : cause instanceof Error ? cause.message : "The SEO command failed."
     };
     return {
       exitCode: cause instanceof SiteOSAuthApiError ? 1 : 2,