@tailglow/cli 0.6.4 → 0.7.1

package/src/commands.generated.js

@@ -247,6 +247,17 @@ export const CLI_COMMANDS = [
     ],
     "query_params": [],
     "body_fields": [
+      {
+        "name": "tgl_authoring_mode",
+        "type": "TglAuthoringMode",
+        "required": false,
+        "description": "Project-wide authoring behavior. Aggressive chooses a defensible mapping; normal requests clarification for competing meanings. Defaults to aggressive. Existing scripts are unchanged. Optional.",
+        "allowed_values": [
+          "normal",
+          "aggressive"
+        ],
+        "deprecated": null
+      },
       {
         "name": "name",
         "type": "string",
@@ -3815,8 +3826,10 @@ export const CLI_COMMANDS = [
     ],
     "notes": [
       "`last` returns the latest reading in each time bucket within the requested range.",
-      "`coverage_mode=observed` returns partial observed rows beyond the strict boundary without filling missing buckets. `coverage_reasons` names unresolved view scopes; `excluded` is informational.",
-      "Record keys are UTC bucket starts. A bucket is final only when its UTC calendar end (start plus one `interval`) is at or before `complete_through_at`; strict omits all other buckets. A null cutoff means unknown completeness. Observed may include populated partial buckets even when the requested end lies inside one, and does not synthesize empty partial buckets.",
+      "Record keys are UTC bucket starts. Buckets still filling come back with the data counted so far: every key at or after `first_incomplete_bucket_at` is incomplete and can still grow, so report it as \"so far\" and never compare it with a complete bucket. Incomplete buckets with no data yet are left out rather than returned as zero.",
+      "`complete_through_at` is the instant before which every number is final. Null means completeness is unknown, and then every bucket is incomplete.",
+      "For complete buckets only, leave out every key at or after `first_incomplete_bucket_at`.",
+      "`coverage_reasons` names unresolved view scopes; `excluded` is informational.",
       "The aggregation window is resolved in order: an explicit `start_at` plus `end_at` wins; otherwise `time_range` is used; otherwise the metric's saved chart range is used.",
       "`start_at` and `end_at` only take effect when sent together. Sending one without the other has no effect on the window.",
       "When both are provided, `start_at` must be earlier than `end_at`.",
@@ -3842,17 +3855,6 @@ export const CLI_COMMANDS = [
       }
     ],
     "query_params": [
-      {
-        "name": "coverage_mode",
-        "type": "string",
-        "required": false,
-        "description": "Strict returns only final data. Observed includes partial data beyond complete_through_at without filling missing buckets. Optional. Defaults to `\"strict\"`.",
-        "allowed_values": [
-          "strict",
-          "observed"
-        ],
-        "deprecated": null
-      },
       {
         "name": "start_at",
         "type": "ISODateString",
@@ -4147,14 +4149,6 @@ export const CLI_COMMANDS = [
         "allowed_values": [],
         "deprecated": null
       },
-      {
-        "name": "ui_chart_show_monitors",
-        "type": "boolean",
-        "required": false,
-        "description": "Whether the chart displays monitor thresholds. Optional.",
-        "allowed_values": [],
-        "deprecated": null
-      },
       {
         "name": "ui_chart_show_trends",
         "type": "boolean",
@@ -4529,14 +4523,6 @@ export const CLI_COMMANDS = [
         "allowed_values": [],
         "deprecated": null
       },
-      {
-        "name": "ui_chart_show_monitors",
-        "type": "boolean",
-        "required": false,
-        "description": "Whether the chart displays monitor thresholds. Optional.",
-        "allowed_values": [],
-        "deprecated": null
-      },
       {
         "name": "ui_chart_show_trends",
         "type": "boolean",
@@ -5177,12 +5163,13 @@ export const CLI_COMMANDS = [
       "monitors:write"
     ],
     "notes": [
-      "The monitor starts evaluating on its schedule as soon as it is created, unless it is created with `status` set to `paused`.",
-      "`scope` decides how many alerts a monitor can raise at once: `any_series` fires once for the metric as a whole, `each_series` tracks every series separately.",
-      "No-data (`absence`) conditions require `chart_value=count` and a finite `time_window_minutes`.",
-      "`sustained_minutes` is required when `condition_type` is `sustained`, and `threshold_value` is required when it is `threshold`.",
-      "`min_occurrences` and `occurrence_window_minutes` must both be set or both be null, and occurrence-based triggering cannot be combined with a sustained condition.",
-      "`schedule_cron` must be a valid cron expression. It is evaluated in UTC, and the finest granularity is one minute.",
+      "The monitor starts checking on its schedule as soon as it is created, unless it is created with `status` set to `paused`. Its first check is the first scheduled time after it is created.",
+      "`scope` decides how many alerts a monitor can raise at once: `any_series` raises one for the metric as a whole, `each_series` tracks every series separately.",
+      "A `rolling` window needs `window_minutes`. An `all_time` window takes `window_minutes: null`.",
+      "`count`, `sum` and `count_unique` require `empty_window_handling: \"zero\"`. Omitted, it is `zero` for those statistics and `no_value` for the others.",
+      "An `immediate` trigger takes no trigger fields. `sustained` needs `sustained_minutes` and no repeat fields. `repeated` needs `repeat_count` and `repeat_window_minutes` and no `sustained_minutes`.",
+      "A trigger the schedule can never satisfy is rejected. A gap between checks longer than `sustained_minutes` restarts the hold, so a `sustained` trigger needs checks that run for `sustained_minutes` without such a gap. A `repeated` trigger needs a `repeat_window_minutes` that can hold `repeat_count` checks. A schedule that only might satisfy the trigger is allowed.",
+      "`schedule_cron` must be a valid five-field cron expression. It is evaluated in UTC, and the finest granularity is one minute.",
       "A monitor cannot be created active with an `expires_at` already in the past."
     ],
     "path_params": [
@@ -5225,7 +5212,7 @@ export const CLI_COMMANDS = [
         "name": "status",
         "type": "string",
         "required": false,
-        "description": "Whether the monitor starts evaluating immediately or switched off. `disabled` is not accepted: the system uses it to record that it stopped the monitor itself. Optional. Defaults to `\"active\"`.",
+        "description": "Whether the monitor starts checking immediately or switched off. `disabled` is not accepted: the system uses it to record that it stopped the monitor itself. Optional. Defaults to `\"active\"`.",
         "allowed_values": [
           "active",
           "paused"
@@ -5233,19 +5220,25 @@ export const CLI_COMMANDS = [
         "deprecated": null
       },
       {
-        "name": "chart_value",
-        "type": "MetricChartValue",
+        "name": "expires_at",
+        "type": "ISODateString | null",
         "required": false,
-        "description": "Which value of the metric is compared against the threshold. Optional. Defaults to `\"sum\"`.",
+        "description": "When the monitor stops checking. Leave null for no expiry. Optional.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "statistic",
+        "type": "MonitorStatistic",
+        "required": true,
+        "description": "What is computed over each window. `count`, `sum` and `count_unique` measure how much happened; the others read a value from the window's observations.",
         "allowed_values": [
           "count",
-          "average",
           "sum",
+          "average",
           "min",
           "max",
           "last",
-          "cumulative_sum",
-          "cumulative_count",
           "p50",
           "p95",
           "p99",
@@ -5254,120 +5247,151 @@ export const CLI_COMMANDS = [
         "deprecated": null
       },
       {
-        "name": "scope",
-        "type": "MonitorScope",
-        "required": false,
-        "description": "Whether the monitor fires once for the metric as a whole, or tracks each series separately. Optional. Defaults to `\"total\"`.",
+        "name": "operator",
+        "type": "MonitorOperator",
+        "required": true,
+        "description": "How the statistic is compared with `threshold_value`.",
         "allowed_values": [
-          "total",
-          "any_series",
-          "each_series"
+          "gt",
+          "gte",
+          "lt",
+          "lte",
+          "eq",
+          "neq"
         ],
         "deprecated": null
       },
       {
-        "name": "time_window_minutes",
-        "type": "integer | null",
-        "required": false,
-        "description": "Evaluation lookback in whole minutes (1 to 525600). Null means since the metric was created. No-data conditions require a finite window. Optional.",
+        "name": "threshold_value",
+        "type": "number",
+        "required": true,
+        "description": "The value the statistic is compared with. `count` equal to 0 alerts when no data arrives.",
         "allowed_values": [],
         "deprecated": null
       },
       {
-        "name": "condition_type",
-        "type": "MonitorConditionType",
+        "name": "empty_window_handling",
+        "type": "MonitorEmptyWindowHandling",
         "required": false,
-        "description": "threshold compares a value, sustained requires that comparison to hold, existence fires when the selected value is greater than zero, and absence fires when no observations exist in the complete evaluation window, regardless of chart gap handling. Optional. Defaults to `\"threshold\"`.",
+        "description": "What the statistic reads when the window holds no data. `zero` reads 0. `no_value` reads nothing, so that check neither opens nor closes an alert. Optional.",
         "allowed_values": [
-          "threshold",
-          "sustained",
-          "existence",
-          "absence"
+          "no_value",
+          "zero"
         ],
         "deprecated": null
       },
       {
-        "name": "operator",
-        "type": "MonitorOperator",
+        "name": "window_type",
+        "type": "MonitorWindowType",
         "required": false,
-        "description": "How the metric value is compared against the threshold. Optional. Defaults to `\"gt\"`.",
+        "description": "`rolling` reads the `window_minutes` before each check. `all_time` reads everything from the start of the project. Optional. Defaults to `\"rolling\"`.",
         "allowed_values": [
-          "gt",
-          "gte",
-          "lt",
-          "lte",
-          "eq",
-          "neq"
+          "rolling",
+          "all_time"
         ],
         "deprecated": null
       },
       {
-        "name": "threshold_value",
-        "type": "number | null",
+        "name": "window_minutes",
+        "type": "integer | null",
         "required": false,
-        "description": "The value the metric is compared against. Optional.",
+        "description": "Length of a rolling window in whole minutes (1 to 525600). Null for `all_time`. Optional.",
         "allowed_values": [],
         "deprecated": null
       },
       {
-        "name": "sustained_minutes",
-        "type": "number | null",
+        "name": "scope",
+        "type": "MonitorScope",
         "required": false,
-        "description": "How long the condition must hold before the monitor fires. Optional.",
-        "allowed_values": [],
+        "description": "`total` checks the whole feed as one value. `any_series` keeps one alert open while any series matches. `each_series` checks every series separately. Optional. Defaults to `\"total\"`.",
+        "allowed_values": [
+          "total",
+          "any_series",
+          "each_series"
+        ],
         "deprecated": null
       },
       {
-        "name": "schedule_cron",
-        "type": "string",
+        "name": "series_filters",
+        "type": "object",
         "required": false,
-        "description": "Cron expression, in UTC, setting how often the monitor evaluates. Optional. Defaults to `\"* * * * *\"`. Minimum length: `1`. Maximum length: `128`.",
+        "description": "Narrows which of the metric's series this monitor watches. Property values may use `*` wildcards. Empty watches every series. Optional.",
         "allowed_values": [],
-        "deprecated": null
+        "deprecated": null,
+        "fields": [
+          {
+            "name": "include",
+            "type": "object[]",
+            "required": false,
+            "description": "Only series matching one of these property sets are watched. Optional.",
+            "allowed_values": [],
+            "deprecated": null
+          },
+          {
+            "name": "exclude",
+            "type": "object[]",
+            "required": false,
+            "description": "Series matching one of these property sets are ignored. Optional.",
+            "allowed_values": [],
+            "deprecated": null
+          }
+        ]
       },
       {
-        "name": "alert_mode",
-        "type": "MonitorAlertMode",
+        "name": "trigger_type",
+        "type": "MonitorTriggerType",
         "required": false,
-        "description": "Whether an alert stays open until the condition clears, or opens and ends in one moment. Optional. Defaults to `\"spanning\"`.",
+        "description": "When a match opens an alert. `immediate` on the first matching check, `sustained` once matches have held for `sustained_minutes`, `repeated` after `repeat_count` matching checks within `repeat_window_minutes`. Optional. Defaults to `\"immediate\"`.",
         "allowed_values": [
-          "spanning",
-          "instant"
+          "immediate",
+          "sustained",
+          "repeated"
         ],
         "deprecated": null
       },
       {
-        "name": "expires_at",
-        "type": "ISODateString | null",
+        "name": "sustained_minutes",
+        "type": "integer | null",
         "required": false,
-        "description": "When the monitor stops evaluating. Leave null for no expiry. Optional.",
+        "description": "How long matches must hold before an alert opens, in whole minutes. Only for `sustained`. Optional.",
         "allowed_values": [],
         "deprecated": null
       },
       {
-        "name": "series_filters",
-        "type": "object | null",
+        "name": "repeat_count",
+        "type": "integer | null",
         "required": false,
-        "description": "Narrows which of the metric's series this monitor watches. Optional.",
+        "description": "How many matching checks open an alert. Only for `repeated`. Optional.",
         "allowed_values": [],
         "deprecated": null
       },
       {
-        "name": "min_occurrences",
+        "name": "repeat_window_minutes",
         "type": "integer | null",
         "required": false,
-        "description": "How many times the condition must be met before the monitor fires. Optional.",
+        "description": "The window, in whole minutes, those matching checks must fall within. Only for `repeated`. Optional.",
         "allowed_values": [],
         "deprecated": null
       },
       {
-        "name": "occurrence_window_minutes",
-        "type": "integer | null",
+        "name": "schedule_cron",
+        "type": "string",
         "required": false,
-        "description": "The window those occurrences have to fall within. Optional.",
+        "description": "Five-field cron expression, in UTC, setting when the monitor checks. Optional. Defaults to `\"* * * * *\"`. Minimum length: `1`. Maximum length: `128`.",
         "allowed_values": [],
         "deprecated": null
       },
+      {
+        "name": "alert_mode",
+        "type": "MonitorAlertMode",
+        "required": false,
+        "description": "`spanning` keeps an alert open until the condition clears. `instant` opens and ends it at once. Optional. Defaults to `\"spanning\"`.",
+        "allowed_values": [
+          "spanning",
+          "instant"
+        ],
+        "deprecated": null
+      },
       {
         "name": "metric_id",
         "type": "string",
@@ -5378,12 +5402,59 @@ export const CLI_COMMANDS = [
       }
     ]
   },
+  {
+    "resource": "monitors",
+    "command": "draft",
+    "operation_id": "draftMonitor",
+    "summary": "Draft Monitor",
+    "description": "Draft a monitor rule from a description in your own words.",
+    "method": "POST",
+    "path": "/v1/projects/:project_id/metrics/:metric_id/monitors/draft",
+    "alternate_paths": [],
+    "scopes": [
+      "monitors:write"
+    ],
+    "notes": [
+      "Nothing is saved. Review the draft and its `assumptions`, then create the monitor with the draft as the body.",
+      "When the description is not enough for a rule (no threshold, no measurable condition), the outcome is `clarification` with a `question` to answer in a new description.",
+      "Drafts count against a per-team hourly budget (50 on Pro, 500 on Enterprise). Over budget the request is refused with `resource_limit_reached` and says when the budget resets."
+    ],
+    "path_params": [
+      {
+        "name": "project_id",
+        "type": "string",
+        "required": true,
+        "description": "Unique identifier of the project.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "metric_id",
+        "type": "string",
+        "required": true,
+        "description": "Unique identifier of the metric.",
+        "allowed_values": [],
+        "deprecated": null
+      }
+    ],
+    "query_params": [],
+    "body_fields": [
+      {
+        "name": "description",
+        "type": "string",
+        "required": true,
+        "description": "The alert in your own words, for example `Alert me if no data arrives for 10 minutes.`. Minimum length: `1`. Maximum length: `1000`.",
+        "allowed_values": [],
+        "deprecated": null
+      }
+    ]
+  },
   {
     "resource": "monitors",
     "command": "preview",
     "operation_id": "previewMonitor",
     "summary": "Preview Monitor",
-    "description": "Preview a monitor condition over its current evaluation window without saving or raising alerts.",
+    "description": "Preview a monitor's rule on its most recent scheduled check, without saving or raising alerts.",
     "method": "POST",
     "path": "/v1/projects/:project_id/metrics/:metric_id/monitors/preview",
     "alternate_paths": [],
@@ -5391,12 +5462,13 @@ export const CLI_COMMANDS = [
       "monitors:read"
     ],
     "notes": [
-      "Uses the same series filtering and condition evaluation as scheduled monitors. This is a condition preview, not a simulation of cron timing, sustained duration, or occurrence counting.",
-      "An incomplete window returns ready=false with no verdicts. No-data conditions count observations across the whole window, including when the chart displays missing buckets as gaps.",
-      "No-data (`absence`) conditions require `chart_value=count` and a finite `time_window_minutes`.",
-      "`sustained_minutes` is required when `condition_type` is `sustained`, and `threshold_value` is required when it is `threshold`.",
-      "`min_occurrences` and `occurrence_window_minutes` must both be set or both be null, and occurrence-based triggering cannot be combined with a sustained condition.",
-      "`schedule_cron` must be a valid cron expression. It is evaluated in UTC, and the finest granularity is one minute.",
+      "Reads the same window and computes the same statistic and verdict per target as a scheduled check of the most recent time on the rule's schedule. It shows one check: `trigger_note` explains when a `sustained` or `repeated` trigger would open an alert.",
+      "A window whose data is not complete yet returns `is_ready: false` with no verdicts.",
+      "A `rolling` window needs `window_minutes`. An `all_time` window takes `window_minutes: null`.",
+      "`count`, `sum` and `count_unique` require `empty_window_handling: \"zero\"`. Omitted, it is `zero` for those statistics and `no_value` for the others.",
+      "An `immediate` trigger takes no trigger fields. `sustained` needs `sustained_minutes` and no repeat fields. `repeated` needs `repeat_count` and `repeat_window_minutes` and no `sustained_minutes`.",
+      "A trigger the schedule can never satisfy is rejected. A gap between checks longer than `sustained_minutes` restarts the hold, so a `sustained` trigger needs checks that run for `sustained_minutes` without such a gap. A `repeated` trigger needs a `repeat_window_minutes` that can hold `repeat_count` checks. A schedule that only might satisfy the trigger is allowed.",
+      "`schedule_cron` must be a valid five-field cron expression. It is evaluated in UTC, and the finest granularity is one minute.",
       "A monitor cannot be created active with an `expires_at` already in the past."
     ],
     "path_params": [
@@ -5439,7 +5511,7 @@ export const CLI_COMMANDS = [
         "name": "status",
         "type": "string",
         "required": false,
-        "description": "Whether the monitor starts evaluating immediately or switched off. `disabled` is not accepted: the system uses it to record that it stopped the monitor itself. Optional. Defaults to `\"active\"`.",
+        "description": "Whether the monitor starts checking immediately or switched off. `disabled` is not accepted: the system uses it to record that it stopped the monitor itself. Optional. Defaults to `\"active\"`.",
         "allowed_values": [
           "active",
           "paused"
@@ -5447,19 +5519,25 @@ export const CLI_COMMANDS = [
         "deprecated": null
       },
       {
-        "name": "chart_value",
-        "type": "MetricChartValue",
+        "name": "expires_at",
+        "type": "ISODateString | null",
         "required": false,
-        "description": "Which value of the metric is compared against the threshold. Optional. Defaults to `\"sum\"`.",
+        "description": "When the monitor stops checking. Leave null for no expiry. Optional.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "statistic",
+        "type": "MonitorStatistic",
+        "required": true,
+        "description": "What is computed over each window. `count`, `sum` and `count_unique` measure how much happened; the others read a value from the window's observations.",
         "allowed_values": [
           "count",
-          "average",
           "sum",
+          "average",
           "min",
           "max",
           "last",
-          "cumulative_sum",
-          "cumulative_count",
           "p50",
           "p95",
           "p99",
@@ -5468,120 +5546,151 @@ export const CLI_COMMANDS = [
         "deprecated": null
       },
       {
-        "name": "scope",
-        "type": "MonitorScope",
-        "required": false,
-        "description": "Whether the monitor fires once for the metric as a whole, or tracks each series separately. Optional. Defaults to `\"total\"`.",
+        "name": "operator",
+        "type": "MonitorOperator",
+        "required": true,
+        "description": "How the statistic is compared with `threshold_value`.",
         "allowed_values": [
-          "total",
-          "any_series",
-          "each_series"
+          "gt",
+          "gte",
+          "lt",
+          "lte",
+          "eq",
+          "neq"
         ],
         "deprecated": null
       },
       {
-        "name": "time_window_minutes",
-        "type": "integer | null",
-        "required": false,
-        "description": "Evaluation lookback in whole minutes (1 to 525600). Null means since the metric was created. No-data conditions require a finite window. Optional.",
+        "name": "threshold_value",
+        "type": "number",
+        "required": true,
+        "description": "The value the statistic is compared with. `count` equal to 0 alerts when no data arrives.",
         "allowed_values": [],
         "deprecated": null
       },
       {
-        "name": "condition_type",
-        "type": "MonitorConditionType",
+        "name": "empty_window_handling",
+        "type": "MonitorEmptyWindowHandling",
         "required": false,
-        "description": "threshold compares a value, sustained requires that comparison to hold, existence fires when the selected value is greater than zero, and absence fires when no observations exist in the complete evaluation window, regardless of chart gap handling. Optional. Defaults to `\"threshold\"`.",
+        "description": "What the statistic reads when the window holds no data. `zero` reads 0. `no_value` reads nothing, so that check neither opens nor closes an alert. Optional.",
         "allowed_values": [
-          "threshold",
-          "sustained",
-          "existence",
-          "absence"
+          "no_value",
+          "zero"
         ],
         "deprecated": null
       },
       {
-        "name": "operator",
-        "type": "MonitorOperator",
+        "name": "window_type",
+        "type": "MonitorWindowType",
         "required": false,
-        "description": "How the metric value is compared against the threshold. Optional. Defaults to `\"gt\"`.",
+        "description": "`rolling` reads the `window_minutes` before each check. `all_time` reads everything from the start of the project. Optional. Defaults to `\"rolling\"`.",
         "allowed_values": [
-          "gt",
-          "gte",
-          "lt",
-          "lte",
-          "eq",
-          "neq"
+          "rolling",
+          "all_time"
         ],
         "deprecated": null
       },
       {
-        "name": "threshold_value",
-        "type": "number | null",
+        "name": "window_minutes",
+        "type": "integer | null",
         "required": false,
-        "description": "The value the metric is compared against. Optional.",
+        "description": "Length of a rolling window in whole minutes (1 to 525600). Null for `all_time`. Optional.",
         "allowed_values": [],
         "deprecated": null
       },
       {
-        "name": "sustained_minutes",
-        "type": "number | null",
+        "name": "scope",
+        "type": "MonitorScope",
         "required": false,
-        "description": "How long the condition must hold before the monitor fires. Optional.",
-        "allowed_values": [],
+        "description": "`total` checks the whole feed as one value. `any_series` keeps one alert open while any series matches. `each_series` checks every series separately. Optional. Defaults to `\"total\"`.",
+        "allowed_values": [
+          "total",
+          "any_series",
+          "each_series"
+        ],
         "deprecated": null
       },
       {
-        "name": "schedule_cron",
-        "type": "string",
+        "name": "series_filters",
+        "type": "object",
         "required": false,
-        "description": "Cron expression, in UTC, setting how often the monitor evaluates. Optional. Defaults to `\"* * * * *\"`. Minimum length: `1`. Maximum length: `128`.",
+        "description": "Narrows which of the metric's series this monitor watches. Property values may use `*` wildcards. Empty watches every series. Optional.",
         "allowed_values": [],
-        "deprecated": null
+        "deprecated": null,
+        "fields": [
+          {
+            "name": "include",
+            "type": "object[]",
+            "required": false,
+            "description": "Only series matching one of these property sets are watched. Optional.",
+            "allowed_values": [],
+            "deprecated": null
+          },
+          {
+            "name": "exclude",
+            "type": "object[]",
+            "required": false,
+            "description": "Series matching one of these property sets are ignored. Optional.",
+            "allowed_values": [],
+            "deprecated": null
+          }
+        ]
       },
       {
-        "name": "alert_mode",
-        "type": "MonitorAlertMode",
+        "name": "trigger_type",
+        "type": "MonitorTriggerType",
         "required": false,
-        "description": "Whether an alert stays open until the condition clears, or opens and ends in one moment. Optional. Defaults to `\"spanning\"`.",
+        "description": "When a match opens an alert. `immediate` on the first matching check, `sustained` once matches have held for `sustained_minutes`, `repeated` after `repeat_count` matching checks within `repeat_window_minutes`. Optional. Defaults to `\"immediate\"`.",
         "allowed_values": [
-          "spanning",
-          "instant"
+          "immediate",
+          "sustained",
+          "repeated"
         ],
         "deprecated": null
       },
       {
-        "name": "expires_at",
-        "type": "ISODateString | null",
+        "name": "sustained_minutes",
+        "type": "integer | null",
         "required": false,
-        "description": "When the monitor stops evaluating. Leave null for no expiry. Optional.",
+        "description": "How long matches must hold before an alert opens, in whole minutes. Only for `sustained`. Optional.",
         "allowed_values": [],
         "deprecated": null
       },
       {
-        "name": "series_filters",
-        "type": "object | null",
+        "name": "repeat_count",
+        "type": "integer | null",
         "required": false,
-        "description": "Narrows which of the metric's series this monitor watches. Optional.",
+        "description": "How many matching checks open an alert. Only for `repeated`. Optional.",
         "allowed_values": [],
         "deprecated": null
       },
       {
-        "name": "min_occurrences",
+        "name": "repeat_window_minutes",
         "type": "integer | null",
         "required": false,
-        "description": "How many times the condition must be met before the monitor fires. Optional.",
+        "description": "The window, in whole minutes, those matching checks must fall within. Only for `repeated`. Optional.",
         "allowed_values": [],
         "deprecated": null
       },
       {
-        "name": "occurrence_window_minutes",
-        "type": "integer | null",
+        "name": "schedule_cron",
+        "type": "string",
         "required": false,
-        "description": "The window those occurrences have to fall within. Optional.",
+        "description": "Five-field cron expression, in UTC, setting when the monitor checks. Optional. Defaults to `\"* * * * *\"`. Minimum length: `1`. Maximum length: `128`.",
         "allowed_values": [],
         "deprecated": null
       },
+      {
+        "name": "alert_mode",
+        "type": "MonitorAlertMode",
+        "required": false,
+        "description": "`spanning` keeps an alert open until the condition clears. `instant` opens and ends it at once. Optional. Defaults to `\"spanning\"`.",
+        "allowed_values": [
+          "spanning",
+          "instant"
+        ],
+        "deprecated": null
+      },
       {
         "name": "metric_id",
         "type": "string",
@@ -5597,7 +5706,7 @@ export const CLI_COMMANDS = [
     "command": "update",
     "operation_id": "updateMonitor",
     "summary": "Update Monitor",
-    "description": "Change a monitor's condition, schedule, or status.",
+    "description": "Change a monitor's rule, schedule, name, description or expiry.",
     "method": "POST",
     "path": "/v1/projects/:project_id/metrics/:metric_id/monitors/:monitor_id",
     "alternate_paths": [],
@@ -5605,17 +5714,18 @@ export const CLI_COMMANDS = [
       "monitors:write"
     ],
     "notes": [
-      "Send only the fields you are changing. Anything omitted keeps its current value.",
-      "Changing what the monitor MEANS (its condition, scope, series filters or alert mode) ends any period currently firing, because the old alert no longer describes the new rule.",
+      "Send the fields you are changing. A field sent with its current value changes nothing, so sending the whole monitor back is fine.",
+      "Changing the rule (statistic, comparison, empty window handling, window, scope, series filters, trigger or alert mode) ends the monitor's open alerts with `monitor_changed` and starts checking afresh at the next scheduled time.",
+      "Changing only `schedule_cron` keeps open alerts. Checks move to the new schedule, and a `sustained` or `repeated` trigger starts counting again.",
+      "Changing only `name`, `description` or `expires_at` affects nothing else.",
       "`metric_id` cannot be changed. Create a new monitor against the other metric instead.",
       "The metric a monitor watches cannot be changed. Create a second monitor instead.",
-      "No-data (`absence`) conditions require `chart_value=count` and a finite `time_window_minutes`.",
-      "`sustained_minutes` is required when `condition_type` is `sustained`, and `threshold_value` is required when it is `threshold`.",
-      "`min_occurrences` and `occurrence_window_minutes` must both be set or both be null, and occurrence-based triggering cannot be combined with a sustained condition.",
-      "`schedule_cron` must be a valid cron expression. It is evaluated in UTC, and the finest granularity is one minute.",
       "`status` is not editable here. Use the pause and resume operations, which is also what keeps a customer from writing the `disabled` the system uses for expiry.",
-      "Moving `expires_at` is rejected when that would leave an active monitor with an expiry already in the past. Editing a monitor that has already expired is allowed, including the update that extends its expiry.",
-      "Conditions are checked against the monitor as it will be stored, not against the fields you send, so a change that would leave the monitor in an invalid combination is rejected even when the conflicting value is one you did not send."
+      "The fields you send are merged into the stored monitor, and the result must satisfy the create rules for windows, `empty_window_handling`, trigger fields and the schedule, so a change is rejected even when the conflicting value is one you did not send.",
+      "An omitted `empty_window_handling` becomes `zero` when the new `statistic` is `count`, `sum` or `count_unique`, and `no_value` when the stored statistic was one of those and the new one is not. Otherwise it keeps its stored value.",
+      "Fields the new window or trigger does not use are cleared when you omit them or send null: switching to `all_time` clears `window_minutes`, and switching `trigger_type` clears the other triggers' fields. Sending a value for a field the new choice does not use is rejected.",
+      "`schedule_cron` must be a valid five-field cron expression. It is evaluated in UTC, and the finest granularity is one minute.",
+      "Moving `expires_at` is rejected when that would leave an active monitor with an expiry already in the past. Editing a monitor that has already expired is allowed, including the update that extends its expiry."
     ],
     "path_params": [
       {
@@ -5662,19 +5772,25 @@ export const CLI_COMMANDS = [
         "deprecated": null
       },
       {
-        "name": "chart_value",
-        "type": "MetricChartValue",
+        "name": "expires_at",
+        "type": "ISODateString | null",
+        "required": false,
+        "description": "When the monitor stops checking. Leave null for no expiry. Optional.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "statistic",
+        "type": "MonitorStatistic",
         "required": false,
-        "description": "Which value of the metric is compared against the threshold. Optional.",
+        "description": "What is computed over each window. `count`, `sum` and `count_unique` measure how much happened; the others read a value from the window's observations. Optional.",
         "allowed_values": [
           "count",
-          "average",
           "sum",
+          "average",
           "min",
           "max",
           "last",
-          "cumulative_sum",
-          "cumulative_count",
           "p50",
           "p95",
           "p99",
@@ -5683,119 +5799,150 @@ export const CLI_COMMANDS = [
         "deprecated": null
       },
       {
-        "name": "scope",
-        "type": "MonitorScope",
+        "name": "operator",
+        "type": "MonitorOperator",
         "required": false,
-        "description": "Whether the monitor fires once for the metric as a whole, or tracks each series separately. Optional.",
+        "description": "How the statistic is compared with `threshold_value`. Optional.",
         "allowed_values": [
-          "total",
-          "any_series",
-          "each_series"
+          "gt",
+          "gte",
+          "lt",
+          "lte",
+          "eq",
+          "neq"
         ],
         "deprecated": null
       },
       {
-        "name": "time_window_minutes",
-        "type": "integer | null",
+        "name": "threshold_value",
+        "type": "number",
         "required": false,
-        "description": "Evaluation lookback in whole minutes (1 to 525600). Null means since the metric was created. No-data conditions require a finite window. Optional.",
+        "description": "The value the statistic is compared with. `count` equal to 0 alerts when no data arrives. Optional.",
         "allowed_values": [],
         "deprecated": null
       },
       {
-        "name": "condition_type",
-        "type": "MonitorConditionType",
+        "name": "empty_window_handling",
+        "type": "MonitorEmptyWindowHandling",
         "required": false,
-        "description": "threshold compares a value, sustained requires that comparison to hold, existence fires when the selected value is greater than zero, and absence fires when no observations exist in the complete evaluation window, regardless of chart gap handling. Optional.",
+        "description": "What the statistic reads when the window holds no data. `zero` reads 0. `no_value` reads nothing, so that check neither opens nor closes an alert. Optional.",
         "allowed_values": [
-          "threshold",
-          "sustained",
-          "existence",
-          "absence"
+          "no_value",
+          "zero"
         ],
         "deprecated": null
       },
       {
-        "name": "operator",
-        "type": "MonitorOperator",
+        "name": "window_type",
+        "type": "MonitorWindowType",
         "required": false,
-        "description": "How the metric value is compared against the threshold. Optional.",
+        "description": "`rolling` reads the `window_minutes` before each check. `all_time` reads everything from the start of the project. Optional.",
         "allowed_values": [
-          "gt",
-          "gte",
-          "lt",
-          "lte",
-          "eq",
-          "neq"
+          "rolling",
+          "all_time"
         ],
         "deprecated": null
       },
       {
-        "name": "threshold_value",
-        "type": "number | null",
+        "name": "window_minutes",
+        "type": "integer | null",
         "required": false,
-        "description": "The value the metric is compared against. Optional.",
+        "description": "Length of a rolling window in whole minutes (1 to 525600). Null for `all_time`. Optional.",
         "allowed_values": [],
         "deprecated": null
       },
       {
-        "name": "sustained_minutes",
-        "type": "number | null",
+        "name": "scope",
+        "type": "MonitorScope",
         "required": false,
-        "description": "How long the condition must hold before the monitor fires. Optional.",
-        "allowed_values": [],
+        "description": "`total` checks the whole feed as one value. `any_series` keeps one alert open while any series matches. `each_series` checks every series separately. Optional.",
+        "allowed_values": [
+          "total",
+          "any_series",
+          "each_series"
+        ],
         "deprecated": null
       },
       {
-        "name": "schedule_cron",
-        "type": "string",
+        "name": "series_filters",
+        "type": "object",
         "required": false,
-        "description": "Cron expression, in UTC, setting how often the monitor evaluates. Optional. Minimum length: `1`. Maximum length: `128`.",
+        "description": "Narrows which of the metric's series this monitor watches. Property values may use `*` wildcards. Empty watches every series. Optional.",
         "allowed_values": [],
-        "deprecated": null
+        "deprecated": null,
+        "fields": [
+          {
+            "name": "include",
+            "type": "object[]",
+            "required": false,
+            "description": "Only series matching one of these property sets are watched. Optional.",
+            "allowed_values": [],
+            "deprecated": null
+          },
+          {
+            "name": "exclude",
+            "type": "object[]",
+            "required": false,
+            "description": "Series matching one of these property sets are ignored. Optional.",
+            "allowed_values": [],
+            "deprecated": null
+          }
+        ]
       },
       {
-        "name": "alert_mode",
-        "type": "MonitorAlertMode",
+        "name": "trigger_type",
+        "type": "MonitorTriggerType",
         "required": false,
-        "description": "Whether an alert stays open until the condition clears, or opens and ends in one moment. Optional.",
+        "description": "When a match opens an alert. `immediate` on the first matching check, `sustained` once matches have held for `sustained_minutes`, `repeated` after `repeat_count` matching checks within `repeat_window_minutes`. Optional.",
         "allowed_values": [
-          "spanning",
-          "instant"
+          "immediate",
+          "sustained",
+          "repeated"
         ],
         "deprecated": null
       },
       {
-        "name": "expires_at",
-        "type": "ISODateString | null",
+        "name": "sustained_minutes",
+        "type": "integer | null",
         "required": false,
-        "description": "When the monitor stops evaluating. Leave null for no expiry. Optional.",
+        "description": "How long matches must hold before an alert opens, in whole minutes. Only for `sustained`. Optional.",
         "allowed_values": [],
         "deprecated": null
       },
       {
-        "name": "series_filters",
-        "type": "object | null",
+        "name": "repeat_count",
+        "type": "integer | null",
         "required": false,
-        "description": "Narrows which of the metric's series this monitor watches. Optional.",
+        "description": "How many matching checks open an alert. Only for `repeated`. Optional.",
         "allowed_values": [],
         "deprecated": null
       },
       {
-        "name": "min_occurrences",
+        "name": "repeat_window_minutes",
         "type": "integer | null",
         "required": false,
-        "description": "How many times the condition must be met before the monitor fires. Optional.",
+        "description": "The window, in whole minutes, those matching checks must fall within. Only for `repeated`. Optional.",
         "allowed_values": [],
         "deprecated": null
       },
       {
-        "name": "occurrence_window_minutes",
-        "type": "integer | null",
+        "name": "schedule_cron",
+        "type": "string",
         "required": false,
-        "description": "The window those occurrences have to fall within. Optional.",
+        "description": "Five-field cron expression, in UTC, setting when the monitor checks. Optional. Minimum length: `1`. Maximum length: `128`.",
         "allowed_values": [],
         "deprecated": null
+      },
+      {
+        "name": "alert_mode",
+        "type": "MonitorAlertMode",
+        "required": false,
+        "description": "`spanning` keeps an alert open until the condition clears. `instant` opens and ends it at once. Optional.",
+        "allowed_values": [
+          "spanning",
+          "instant"
+        ],
+        "deprecated": null
       }
     ]
   },
@@ -5804,7 +5951,7 @@ export const CLI_COMMANDS = [
     "command": "pause",
     "operation_id": "pauseMonitor",
     "summary": "Pause Monitor",
-    "description": "Pause a monitor so it stops evaluating.",
+    "description": "Pause a monitor so it stops checking.",
     "method": "POST",
     "path": "/v1/projects/:project_id/metrics/:metric_id/monitors/:monitor_id/pause",
     "alternate_paths": [],
@@ -5812,7 +5959,8 @@ export const CLI_COMMANDS = [
       "monitors:write"
     ],
     "notes": [
-      "A paused monitor raises no alerts and closes nothing that is already firing. Resuming evaluates it again on its next scheduled tick."
+      "Pausing ends the monitor's open alerts with `monitor_paused`. A paused monitor is not checked, and resuming starts again at its next scheduled time: the paused period is never checked.",
+      "Pausing a paused monitor changes nothing. A monitor the system disabled when its expiry passed cannot be paused; resume it instead."
     ],
     "path_params": [
       {
@@ -5848,7 +5996,7 @@ export const CLI_COMMANDS = [
     "command": "resume",
     "operation_id": "resumeMonitor",
     "summary": "Resume Monitor",
-    "description": "Resume a paused monitor so it evaluates on its schedule again.",
+    "description": "Resume a paused monitor so it checks on its schedule again.",
     "method": "POST",
     "path": "/v1/projects/:project_id/metrics/:metric_id/monitors/:monitor_id/resume",
     "alternate_paths": [],
@@ -5856,6 +6004,7 @@ export const CLI_COMMANDS = [
       "monitors:write"
     ],
     "notes": [
+      "Checking starts again at the next scheduled time; the paused period is never checked.",
       "A monitor the system stopped because its expiry passed can be resumed once the expiry is moved into the future. Resuming one whose expiry is still in the past is rejected."
     ],
     "path_params": [
@@ -5944,7 +6093,7 @@ export const CLI_COMMANDS = [
       "alerts:read"
     ],
     "notes": [
-      "An alert is a firing PERIOD, not a single notification. `created_at` is when the condition started holding and `ended_at` is when it stopped, so one incident is one row for its whole duration.",
+      "An alert is a firing PERIOD, not a single notification. `triggered_at` is the check that opened it and `ended_at` is when it ended, with the reason in `end_reason`, so one incident is one row for its whole duration. `created_at` is only when the row was written.",
       "Results cover a time window. Send `start_at` and `end_at`, or a `time_range`; with neither, the metric's own configured chart range is used.",
       "An alert is returned when its period OVERLAPS the window, so a period that opened before the window and is still firing is included.",
       "Use `is_open=true` to see only what is currently firing.",
@@ -5975,9 +6124,9 @@ export const CLI_COMMANDS = [
         "name": "order_by",
         "type": "string",
         "required": false,
-        "description": "Field the results are sorted by. Alerts sort by when their period opened. Optional. Defaults to `\"created_at\"`.",
+        "description": "Field the results are sorted by. Alerts sort by when their period opened. Optional. Defaults to `\"triggered_at\"`.",
         "allowed_values": [
-          "created_at"
+          "triggered_at"
         ],
         "deprecated": null
       },
@@ -6418,7 +6567,7 @@ export const CLI_COMMANDS = [
     "command": "update",
     "operation_id": "updatePage",
     "summary": "Update Page",
-    "description": "Change a page's name, time range, or public access.",
+    "description": "Change a page's name, time range, public access, or its layout of cards.",
     "method": "POST",
     "path": "/v1/projects/:project_id/pages/:page_id",
     "alternate_paths": [],
@@ -6428,8 +6577,11 @@ export const CLI_COMMANDS = [
     "notes": [
       "Send only the fields you are changing. Anything omitted keeps its current value.",
       "Making a page private clears its public URL. Making it public again issues a new slug, so any previously shared link stops working.",
+      "`components` is the whole layout, in page order: each entry is a card's full state, an entry without an `id` adds a card, and a card you leave out is removed. Leave it out to change settings only. Settings and layout are saved together, or not at all.",
+      "Every listed card `id` must already be on this page, and every metric must belong to the page's project and not be scheduled for deletion.",
       "A `custom` time range requires both `custom_range_start_at` and `custom_range_end_at`, at least 30 minutes apart, with the start before the end. The rule is checked against the page as it will be after the update, not against the fields you send.",
-      "An `access_code` is trimmed, and an empty one clears the code."
+      "An `access_code` is trimmed, and an empty one clears the code.",
+      "A card can be listed only once in `components`, and a metric can be on only one card of the page."
     ],
     "path_params": [
       {
@@ -6559,6 +6711,51 @@ export const CLI_COMMANDS = [
         "description": "End of the window, when the time range is custom. Optional.",
         "allowed_values": [],
         "deprecated": null
+      },
+      {
+        "name": "components",
+        "type": "object[]",
+        "required": false,
+        "description": "The page's whole layout, in page order. Cards left out are removed. Optional.",
+        "allowed_values": [],
+        "deprecated": null,
+        "fields": [
+          {
+            "name": "id",
+            "type": "string",
+            "required": false,
+            "description": "Card to keep. Leave out to add a new card. Optional.",
+            "allowed_values": [],
+            "deprecated": null
+          },
+          {
+            "name": "name",
+            "type": "string | null",
+            "required": false,
+            "description": "Title of a card that shows several metrics. Leave out or send null to title it with their names. Optional.",
+            "allowed_values": [],
+            "deprecated": null
+          },
+          {
+            "name": "ui_card_size",
+            "type": "string",
+            "required": false,
+            "description": "How much of the page width the card occupies. Defaults to the full width. Optional.",
+            "allowed_values": [
+              "1/1",
+              "1/2"
+            ],
+            "deprecated": null
+          },
+          {
+            "name": "metric_ids",
+            "type": "string[]",
+            "required": true,
+            "description": "Metrics the card shows together, in order.",
+            "allowed_values": [],
+            "deprecated": null
+          }
+        ]
       }
     ]
   },
@@ -6747,7 +6944,7 @@ export const CLI_COMMANDS = [
     "command": "create",
     "operation_id": "createComponent",
     "summary": "Add Component",
-    "description": "Add a metric to a page.",
+    "description": "Add a card of one or more metrics to a page.",
     "method": "POST",
     "path": "/v1/projects/:project_id/pages/:page_id/components",
     "alternate_paths": [],
@@ -6755,9 +6952,8 @@ export const CLI_COMMANDS = [
       "pages:write"
     ],
     "notes": [
-      "A component is one metric placed on one page. The metric has to belong to the same project.",
-      "The metric must belong to the same project as the page.",
-      "A page holds a limited number of components. Adding one past the limit is rejected."
+      "A component is a card on one page showing one to six metrics together.",
+      "To change a whole page's layout in one write, send `components` to Update Page instead."
     ],
     "path_params": [
       {
@@ -6778,50 +6974,14 @@ export const CLI_COMMANDS = [
       }
     ],
     "query_params": [],
-    "body_fields": [
-      {
-        "name": "ui_sort_index",
-        "type": "integer",
-        "required": false,
-        "description": "Position of the component on the page. Lower appears first. Optional.",
-        "allowed_values": [],
-        "deprecated": null
-      },
-      {
-        "name": "ui_card_size",
-        "type": "ComponentCardSize",
-        "required": false,
-        "description": "How much of the page width the component occupies. Optional.",
-        "allowed_values": [
-          "1/1",
-          "1/2"
-        ],
-        "deprecated": null
-      },
-      {
-        "name": "metric_id",
-        "type": "string",
-        "required": true,
-        "description": "Metric this component displays.",
-        "allowed_values": [],
-        "deprecated": null
-      },
-      {
-        "name": "page_id",
-        "type": "string",
-        "required": false,
-        "description": "Page the component is added to. Optional.",
-        "allowed_values": [],
-        "deprecated": null
-      }
-    ]
+    "body_fields": []
   },
   {
     "resource": "components",
     "command": "update",
     "operation_id": "updateComponent",
     "summary": "Update Component",
-    "description": "Change which metric a component shows, its size, or its position.",
+    "description": "Change which metrics a component shows, its name, its size, or its position.",
     "method": "POST",
     "path": "/v1/projects/:project_id/pages/:page_id/components/:component_id",
     "alternate_paths": [],
@@ -6831,7 +6991,8 @@ export const CLI_COMMANDS = [
     "notes": [
       "Send only the fields you are changing. Anything omitted keeps its current value.",
       "Reorder a page by sending a new `ui_sort_index` for each component you are moving.",
-      "A new `metric_id` must belong to the same project as the page."
+      "`metric_ids` replaces the card's metrics. Every metric must belong to the same project as the page, and none can already be on another card of the page.",
+      "A metric can be listed only once in `metric_ids`."
     ],
     "path_params": [
       {
@@ -6861,6 +7022,14 @@ export const CLI_COMMANDS = [
     ],
     "query_params": [],
     "body_fields": [
+      {
+        "name": "name",
+        "type": "string | null",
+        "required": false,
+        "description": "Title of a card that shows several metrics. Send null to title it with their names. Optional.",
+        "allowed_values": [],
+        "deprecated": null
+      },
       {
         "name": "ui_sort_index",
         "type": "integer",
@@ -6881,10 +7050,10 @@ export const CLI_COMMANDS = [
         "deprecated": null
       },
       {
-        "name": "metric_id",
-        "type": "string",
+        "name": "metric_ids",
+        "type": "string[]",
         "required": false,
-        "description": "Metric this component displays. Optional.",
+        "description": "Metrics the card shows together, in order. Optional.",
         "allowed_values": [],
         "deprecated": null
       }
@@ -6903,7 +7072,7 @@ export const CLI_COMMANDS = [
       "pages:write"
     ],
     "notes": [
-      "The metric itself is not affected, only its placement on this page."
+      "The metrics themselves are not affected, only the card on this page."
     ],
     "path_params": [
       {
@@ -9618,6 +9787,14 @@ export const CLI_COMMANDS = [
         "allowed_values": [],
         "deprecated": null
       },
+      {
+        "name": "block_on_failure",
+        "type": "boolean",
+        "required": false,
+        "description": "Wait for acknowledgement before sending later deliveries. Defaults to false. Check block_on_failure in the response for availability; null means the setting is unavailable. Optional.",
+        "allowed_values": [],
+        "deprecated": null
+      },
       {
         "name": "exclude_fields",
         "type": "string[]",
@@ -9705,6 +9882,14 @@ export const CLI_COMMANDS = [
         ],
         "deprecated": null
       },
+      {
+        "name": "block_on_failure",
+        "type": "boolean",
+        "required": false,
+        "description": "Wait for acknowledgement before sending later deliveries. Defaults to false. Check block_on_failure in the response for availability; null means the setting is unavailable. Optional.",
+        "allowed_values": [],
+        "deprecated": null
+      },
       {
         "name": "exclude_fields",
         "type": "string[]",