@siteoshq/cli 2.1.0 → 2.3.0

package/README.md

@@ -1,7 +1,7 @@
 # SiteOS CLI
 
 `@siteoshq/cli` exposes one `siteos` binary for Auth, common Projects, Pulse, Cookie, Forms,
-Search, Trace, SEO/GEO and Integrations. This source is version 2.1.0; source changes require a separate release to reach npm.
+Search, Trace, SEO/GEO and Integrations. This source is version 2.2.0; source changes require a separate release to reach npm.
 
 CLI 2 requires `siteos project use <id-or-slug> --environment <slug>` once per repository.
 It stores only the common selection in private `projects.json`; older service bindings are not
@@ -389,3 +389,16 @@ definitions. Creation uses `--file <definition.json>`; reports and realtime read
 to Analytics and the operation, with editor roles required for writes. Analytics is Unlimited in
 Usage during early access. See the canonical plugin's website Analytics skill for event contracts
 and the browser-to-report verification workflow; Search reports use `search analytics` separately.
+
+### Trace actionable monitoring (2.2.0)
+
+`trace coverage`, `trace gtm summary`, `trace notifications show` and
+`trace notifications destinations` read the selected environment. `trace observations list`
+accepts `--kind tag_execution`, `--container-id`, `--tag-id` and `--result`;
+`trace issues list` accepts the same GTM identity filters.
+`trace notifications save|retry --input <file>` and
+`trace schema-baselines reset --input <file>` are explicit, version-guarded writes.
+See the [Trace workflow](../../plugins/siteos/skills/siteos-trace/references/actionable-monitoring.md)
+for exact inputs, thresholds and installation of the common GTM execution monitor.
+The installation response supplies `gtmExecutionMonitor.templateUrl` and its trigger contract.
+MCP exposes read-only issue, event, observation, coverage, GTM and notification views.

package/dist/cli.js

@@ -7840,11 +7840,16 @@ var filters = [
   "cursor"
 ];
 var TRACE_EXPLORER_FLAGS = {
+  coverage: ["environment"],
+  "gtm summary": ["environment", "period"],
+  "ga4 show": ["environment"],
+  "notifications show": ["environment"],
+  "notifications destinations": ["environment", "cursor"],
   destinations: filters,
   events: filters,
   properties: filters,
-  issues: filters,
-  observations: filters,
+  issues: [...filters, "container-id", "tag-id"],
+  observations: [...filters, "container-id", "tag-id", "result"],
   "issue show": ["environment", "id", "cursor"],
   "observation show": ["environment", "batch-id", "event-id"]
 };
@@ -7860,6 +7865,21 @@ var FilterValues = z11.object({
   event: z11.string().min(1).max(160).optional(),
   property: z11.string().min(1).max(160).optional(),
   "page-view": z11.string().uuid().optional(),
+  "container-id": z11.string().regex(/^GTM-[A-Z0-9]{4,20}$/u).optional(),
+  "tag-id": z11.string().regex(/^[0-9]{1,20}$/u).optional(),
+  result: z11.enum([
+    "success",
+    "failure",
+    "exception",
+    "timeout",
+    "initiated",
+    "completed_2xx",
+    "completed_4xx",
+    "completed_5xx",
+    "network_error",
+    "beacon_accepted",
+    "result_unknown"
+  ]).optional(),
   search: z11.string().max(160).optional(),
   state: z11.enum([
     "all",
@@ -7873,6 +7893,7 @@ var FilterValues = z11.object({
   ]).optional(),
   rule: z11.string().min(1).max(80).optional(),
   kind: z11.enum([
+    "tag_execution",
     "data_layer",
     "fetch",
     "xhr",
@@ -7891,18 +7912,22 @@ function traceExplorerSuffix(route, values) {
   if (route === "issue show" || route === "observation show") {
     const keys = route === "issue show" ? ["id"] : ["batch-id", "event-id"];
     for (const key of keys) {
-      if (!z11.string().uuid().safeParse(values[key]).success)
+      const value = values[key];
+      const plain = key === "id" && typeof value === "string" ? value.replace(/^trc_incident_/u, "") : value;
+      if (!z11.string().uuid().safeParse(plain).success)
         throw new Error(`Use --${key} with the UUID returned by Trace.`);
     }
     if (values.cursor !== void 0) {
-      if (!z11.string().uuid().safeParse(values.cursor).success)
+      if (!z11.string().uuid().safeParse(
+        typeof values.cursor === "string" ? values.cursor.replace(/^trc_finding_/u, "") : 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 suffix2 = route === "issue show" ? `/issues/${encodeURIComponent(values.id)}` : `/observations/${encodeURIComponent(values["batch-id"])}/${encodeURIComponent(values["event-id"])}`;
+    return `${suffix2}${query.size ? `?${query}` : ""}`;
   }
   const parsed = FilterValues.safeParse(values);
   if (!parsed.success) {
@@ -7913,9 +7938,22 @@ function traceExplorerSuffix(route, values) {
   }
   for (const [key, value] of Object.entries(parsed.data)) {
     if (value !== void 0)
-      query.set(key === "page-view" ? "pageView" : key, value);
+      query.set(
+        {
+          "page-view": "pageView",
+          "container-id": "containerId",
+          "tag-id": "tagId"
+        }[key] ?? key,
+        value
+      );
   }
-  return `/${route}${query.size ? `?${query}` : ""}`;
+  const suffix = {
+    "gtm summary": "gtm/summary",
+    "ga4 show": "ga4",
+    "notifications show": "notifications",
+    "notifications destinations": "notification-destinations"
+  }[route] ?? route;
+  return `/${suffix}${query.size ? `?${query}` : ""}`;
 }
 function tracePublicationVersion(value) {
   if (value === void 0) return void 0;
@@ -7956,11 +7994,22 @@ Usage:
   siteos trace status [--json]
   siteos trace environments [--json]
   siteos trace report [--environment <slug>] [--json]
+  siteos trace coverage [--environment <slug>] [--json]
+  siteos trace ga4 show [--environment <slug>] [--json]
+  siteos trace ga4 bind --input <json-file> [--environment <slug>] [--json]
+  siteos trace ga4 sync --input <json-file> [--environment <slug>] [--json]
+  siteos trace ga4 disconnect --input <json-file> [--environment <slug>] [--json]
+  siteos trace gtm summary [--environment <slug>] [--period <24h|7d>] [--json]
+  siteos trace notifications show [--environment <slug>] [--json]
+  siteos trace notifications destinations [--environment <slug>] [--cursor <cursor>] [--json]
+  siteos trace notifications save --input <settings.json> [--environment <slug>] [--json]
+  siteos trace notifications retry --input <retry.json> [--environment <slug>] [--json]
+  siteos trace schema restart --input <baseline.json> [--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 issues [--environment <slug>] [--provider <provider>] [--event <name>] [--state <all|active|snoozed|resolved|new>] [--rule <rule>] [--container-id <GTM-ID>] [--tag-id <id>] [--search <text>] [--period <24h|7d>] [--cursor <cursor>] [--json]
+  siteos trace observations [--environment <slug>] [--provider <provider>] [--event <name>] [--kind <kind>] [--page-view <uuid>] [--container-id <GTM-ID>] [--tag-id <id>] [--result <result>] [--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]
@@ -7974,7 +8023,7 @@ Use --expected-draft-version when publishing a reviewed tracking plan; a conflic
 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.
+Kinds: data_layer, fetch, xhr, beacon, resource, consent, heartbeat, runtime_diagnostic, tag_execution.
 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.
@@ -8016,6 +8065,9 @@ async function runServiceCommand(service, options) {
         event: { type: "string" },
         property: { type: "string" },
         "page-view": { type: "string" },
+        "container-id": { type: "string" },
+        "tag-id": { type: "string" },
+        result: { type: "string" },
         search: { type: "string" },
         state: { type: "string" },
         rule: { type: "string" },
@@ -8050,6 +8102,12 @@ async function runServiceCommand(service, options) {
         environments: [],
         report: ["environment"],
         ...TRACE_EXPLORER_FLAGS,
+        "ga4 bind": ["environment", "input"],
+        "ga4 sync": ["environment", "input"],
+        "ga4 disconnect": ["environment", "input"],
+        "notifications save": ["environment", "input"],
+        "notifications retry": ["environment", "input"],
+        "schema restart": ["environment", "input"],
         ...Object.fromEntries(
           ["installation", "tracking-plan"].flatMap(
             (section) => ["show", "ensure", "save", "publish"].map((operation) => [
@@ -8246,7 +8304,7 @@ 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" || explorerSuffix !== null) {
+      else if (action === "ga4" || action === "notifications" || action === "schema" || action === "report" || action === "installation" || action === "tracking-plan" || explorerSuffix !== null) {
         const response = z13.object({
           environments: z13.array(
             z13.object({ id: z13.string(), slug: z13.string() })
@@ -8275,6 +8333,18 @@ async function runServiceCommand(service, options) {
         const base = `/environments/${encodeURIComponent(matches[0].id)}`;
         if (explorerSuffix !== null) {
           result = await request(`${base}${explorerSuffix}`);
+        } else if (action === "ga4") {
+          result = await request(
+            `${base}/ga4/${subaction}`,
+            "POST",
+            await inputFile()
+          );
+        } else if (route === "notifications retry" || route === "schema restart") {
+          result = await request(
+            `${base}/${route === "schema restart" ? "schema-baselines/reset" : "notification-retries"}`,
+            "POST",
+            await inputFile()
+          );
         } else if (action === "report" && positionals.length === 1) {
           const detail = z13.object({
             site: z13.object({