@tailglow/cli 0.6.5 → 0.8.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",
@@ -3323,6 +3334,7 @@ export const CLI_COMMANDS = [
       "`transform_script` is TGL and must compile. A script that does not parse is rejected rather than stored, because an unparseable script would fail on every record it later touched.",
       "The script must write every field the view's output schema declares.",
       "Omitting the script queues the transform for generation instead of rejecting it.",
+      "`collection_schema_version` must be settled. A candidate stays out of views until it settles, so naming one is refused with a 409; settle it with Update Collection Schema first.",
       "A transform on a collection-backed view must name the `collection_schema_version` it covers. View-to-view transforms pass null, because they read another view's output rather than a collection schema.",
       "`transform_script` cannot be whitespace-only. Omit it to have TGL generated instead."
     ],
@@ -3815,13 +3827,24 @@ 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.",
+      "Series are ranked by their total over the range (the count for a `count` metric, the sum of Last readings for `last`, the sum otherwise), ties broken by series hash, and `limit` of them come back per page, the metric's `ui_chart_max_series` by default. Walk the pages with `pagination.next_cursor` and `pagination.prev_cursor`; `pagination.total` counts every series.",
+      "`__other__` folds in every series that is not on the current page, so the page plus Other always adds up to the range total and a share is right on every page.",
+      "When the metric has pinned series, they make up the whole first page and later pages walk the other series by rank.",
+      "`series` returns exactly the listed series on one page, unranked and without `__other__`.",
+      "A metric with a `time_dimension` returns its range folded instead of as a timeline: every hour merges into its hour of the day, weekday or hour of the week. Record keys are then the category as a decimal string (`\"0\"` to `\"23\"`, `\"1\"` for Monday to `\"7\"` for Sunday, `\"0\"` to `\"167\"`), every category is present whatever `normalize` says, and `time_dimension` echoes it.",
+      "Data is stored by UTC hour. A fold places each hour in its category in the request `timezone` (echoed as `timezone`), one hour at a time, so a daylight saving change moves only the hours after it.",
+      "A fold reads hourly data whatever `interval` says, covers at most 400 days (a longer range is refused), and includes the current hour's data so far.",
+      "In a fold an empty category is `0` when `empty_bucket_handling` is `zero` and `null` when it is `gaps`, cumulative values are `null`, and there is no trend line.",
       "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`.",
       "`time_range=custom` without explicit dates falls back to the saved custom range of `page_id`, then the metric, then the project.",
-      "`timezone` must be a valid IANA timezone name, or `UTC`."
+      "`timezone` must be a valid IANA timezone name, or `UTC`.",
+      "`after` and `before` are mutually exclusive."
     ],
     "path_params": [
       {
@@ -3842,17 +3865,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",
@@ -3873,7 +3885,7 @@ export const CLI_COMMANDS = [
         "name": "interval",
         "type": "ChartInterval",
         "required": false,
-        "description": "Requested aggregation bucket interval. Optional.",
+        "description": "Requested aggregation bucket interval. A metric with a time dimension ignores it and always folds hourly data. Optional.",
         "allowed_values": [
           "minute",
           "hour",
@@ -3918,7 +3930,7 @@ export const CLI_COMMANDS = [
         "name": "timezone",
         "type": "string",
         "required": false,
-        "description": "IANA timezone used to calculate date boundaries. Optional.",
+        "description": "IANA timezone used to calculate date boundaries and to place each hour in a time dimension's categories. Optional.",
         "allowed_values": [],
         "deprecated": null
       },
@@ -3947,20 +3959,47 @@ export const CLI_COMMANDS = [
         "deprecated": null
       },
       {
-        "name": "max_series",
+        "name": "series",
+        "type": "string",
+        "required": false,
+        "description": "Comma-separated series hashes to return. Optional.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "limit",
         "type": "integer",
         "required": false,
-        "description": "Maximum number of individual series to return. Optional. Minimum: `1`. Maximum: `50`.",
+        "description": "Number of series to return per page. Defaults to the metric's `ui_chart_max_series`. Optional. Minimum: `1`. Maximum: `200`.",
         "allowed_values": [],
         "deprecated": null
       },
       {
-        "name": "series",
+        "name": "after",
         "type": "string",
         "required": false,
-        "description": "Comma-separated series hashes to return. Optional.",
+        "description": "Cursor from `pagination.next_cursor` of a previous response. Returns the resources after that page. Optional.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "before",
+        "type": "string",
+        "required": false,
+        "description": "Cursor from `pagination.prev_cursor` of a previous response. Returns the resources before that page. Optional.",
         "allowed_values": [],
         "deprecated": null
+      },
+      {
+        "name": "sort",
+        "type": "string",
+        "required": false,
+        "description": "Ranking direction of the series. `desc` returns the largest first. Optional. Defaults to `\"desc\"`.",
+        "allowed_values": [
+          "asc",
+          "desc"
+        ],
+        "deprecated": null
       }
     ],
     "body_fields": []
@@ -3982,6 +4021,11 @@ export const CLI_COMMANDS = [
       "Field references and filters must be compatible with the selected view.",
       "Custom chart ranges require both dates, with an interval of at least 30 minutes.",
       "Color-mode configuration must match the selected chart color mode.",
+      "`ui_chart_color_mode` must be a mode the chart type supports. A metric created without a `ui_chart_type` is a `bar` chart and is checked as one.",
+      "`time_dimension` must be one the chart type supports: `breakdown` takes `hour_of_day` or `weekday`, `heatmap` takes `hour_of_week`, `hour_of_day` or `weekday`, and every other chart type takes none.",
+      "A `heatmap` chart requires a `time_dimension`.",
+      "A `time_dimension` cannot be combined with a cumulative `ui_chart_value` (`cumulative_sum` or `cumulative_count`).",
+      "`ui_chart_order` is read by `breakdown` charts only; other chart types ignore it.",
       "`filters` must be a valid filter expression.",
       "`timestamp_field` cannot reference `__meta__` metadata.",
       "`group_by_display_fields` is set at create and cannot be changed afterwards, because each series takes its label from the first record it sees. Map a `group_by` field to a view field that carries a readable value for the same record."
@@ -4099,7 +4143,10 @@ export const CLI_COMMANDS = [
           "stat",
           "gauge",
           "calendar",
-          "uptime"
+          "uptime",
+          "breakdown",
+          "heatmap",
+          "table"
         ],
         "deprecated": null
       },
@@ -4147,14 +4194,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",
@@ -4311,6 +4350,29 @@ export const CLI_COMMANDS = [
         ],
         "deprecated": null
       },
+      {
+        "name": "time_dimension",
+        "type": "TimeDimension",
+        "required": false,
+        "description": "Calendar position the chart folds the metric's hourly data into, such as the hour of the day. Null charts the data over time. Optional.",
+        "allowed_values": [
+          "hour_of_day",
+          "weekday",
+          "hour_of_week"
+        ],
+        "deprecated": null
+      },
+      {
+        "name": "ui_chart_order",
+        "type": "ChartOrder",
+        "required": false,
+        "description": "Order a breakdown chart shows its groups in. Null keeps a time dimension in its natural order and ranks field groups by value. Optional.",
+        "allowed_values": [
+          "natural",
+          "value"
+        ],
+        "deprecated": null
+      },
       {
         "name": "ui_chart_custom_range_start_at",
         "type": "ISODateString",
@@ -4331,7 +4393,7 @@ export const CLI_COMMANDS = [
         "name": "ui_chart_max_series",
         "type": "integer",
         "required": false,
-        "description": "Maximum number of individual series displayed by default. Optional. Minimum: `1`. Maximum: `50`.",
+        "description": "Number of series an aggregation returns per page when the request sends no `limit`. Optional. Minimum: `1`. Maximum: `50`.",
         "allowed_values": [],
         "deprecated": null
       },
@@ -4365,6 +4427,11 @@ export const CLI_COMMANDS = [
       "Changing the metric's data feed rebuilds its historical rollups.",
       "Custom chart ranges require both dates, with an interval of at least 30 minutes.",
       "Color-mode configuration must match the selected chart color mode.",
+      "`ui_chart_color_mode` must be a mode the chart type supports. Changing `ui_chart_type` keeps the current mode, so send a supported one with it.",
+      "`time_dimension` must be one the chart type supports: `breakdown` takes `hour_of_day` or `weekday`, `heatmap` takes `hour_of_week`, `hour_of_day` or `weekday`, and every other chart type takes none. Send `time_dimension: null` when changing to a type that takes none.",
+      "A `heatmap` chart requires a `time_dimension`.",
+      "A `time_dimension` cannot be combined with a cumulative `ui_chart_value` (`cumulative_sum` or `cumulative_count`).",
+      "`ui_chart_order` is read by `breakdown` charts only; other chart types ignore it.",
       "`filters` must be a valid filter expression.",
       "`timestamp_field` cannot reference `__meta__` metadata."
     ],
@@ -4481,7 +4548,10 @@ export const CLI_COMMANDS = [
           "stat",
           "gauge",
           "calendar",
-          "uptime"
+          "uptime",
+          "breakdown",
+          "heatmap",
+          "table"
         ],
         "deprecated": null
       },
@@ -4529,14 +4599,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",
@@ -4693,6 +4755,29 @@ export const CLI_COMMANDS = [
         ],
         "deprecated": null
       },
+      {
+        "name": "time_dimension",
+        "type": "TimeDimension",
+        "required": false,
+        "description": "Calendar position the chart folds the metric's hourly data into, such as the hour of the day. Null charts the data over time. Optional.",
+        "allowed_values": [
+          "hour_of_day",
+          "weekday",
+          "hour_of_week"
+        ],
+        "deprecated": null
+      },
+      {
+        "name": "ui_chart_order",
+        "type": "ChartOrder",
+        "required": false,
+        "description": "Order a breakdown chart shows its groups in. Null keeps a time dimension in its natural order and ranks field groups by value. Optional.",
+        "allowed_values": [
+          "natural",
+          "value"
+        ],
+        "deprecated": null
+      },
       {
         "name": "ui_chart_custom_range_start_at",
         "type": "ISODateString",
@@ -4713,7 +4798,7 @@ export const CLI_COMMANDS = [
         "name": "ui_chart_max_series",
         "type": "integer",
         "required": false,
-        "description": "Maximum number of individual series displayed by default. Optional. Minimum: `1`. Maximum: `50`.",
+        "description": "Number of series an aggregation returns per page when the request sends no `limit`. Optional. Minimum: `1`. Maximum: `50`.",
         "allowed_values": [],
         "deprecated": null
       },
@@ -5177,12 +5262,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 +5311,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 +5319,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 +5346,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 +5501,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 +5561,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 +5610,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 +5618,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 +5645,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 +5805,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 +5813,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 +5871,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.",
+        "description": "When the monitor stops checking. Leave null for no expiry. Optional.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "statistic",
+        "type": "MonitorStatistic",
+        "required": false,
+        "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 +5898,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 +6050,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 +6058,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 +6095,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 +6103,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 +6192,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 +6223,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 +6666,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 +6676,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 +6810,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 +7043,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,8 +7051,10 @@ 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 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.",
+      "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`.",
       "A page holds a limited number of components. Adding one past the limit is rejected."
     ],
     "path_params": [
@@ -6779,6 +7077,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",
@@ -6799,10 +7105,10 @@ export const CLI_COMMANDS = [
         "deprecated": null
       },
       {
-        "name": "metric_id",
-        "type": "string",
+        "name": "metric_ids",
+        "type": "string[]",
         "required": true,
-        "description": "Metric this component displays.",
+        "description": "Metrics the card shows together, in order.",
         "allowed_values": [],
         "deprecated": null
       },
@@ -6821,7 +7127,7 @@ export const CLI_COMMANDS = [
     "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 +7137,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 +7168,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 +7196,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 +7218,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 +9933,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 +10028,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[]",