@tailglow/cli 0.2.1 → 0.5.0

package/src/commands.generated.js

@@ -103,6 +103,91 @@ export const CLI_COMMANDS = [
     "query_params": [],
     "body_fields": []
   },
+  {
+    "resource": "projects",
+    "command": "pipeline",
+    "operation_id": "getProjectPipeline",
+    "summary": "Retrieve Project Pipeline",
+    "description": "Retrieve ingest activity across all of a project's servers.",
+    "method": "GET",
+    "path": "/v1/projects/:project_id/pipeline",
+    "alternate_paths": [],
+    "scopes": [
+      "servers:read"
+    ],
+    "notes": [
+      "Includes temporary deployment servers and their archived history. Pending averages valid queued records; throughput counts drained records. Older pending history without record counts is unknown."
+    ],
+    "path_params": [
+      {
+        "name": "project_id",
+        "type": "string",
+        "required": true,
+        "description": "Unique identifier of the project.",
+        "allowed_values": [],
+        "deprecated": null
+      }
+    ],
+    "query_params": [
+      {
+        "name": "start_at",
+        "type": "ISODateString",
+        "required": false,
+        "description": "Start time (ISO format, default: 12 hours ago). Optional.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "end_at",
+        "type": "ISODateString",
+        "required": false,
+        "description": "End time (ISO format, default: now). Optional.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "interval",
+        "type": "string",
+        "required": false,
+        "description": "Aggregation interval. Optional. Defaults to `\"minute\"`.",
+        "allowed_values": [
+          "minute",
+          "hour"
+        ],
+        "deprecated": null
+      }
+    ],
+    "body_fields": []
+  },
+  {
+    "resource": "projects",
+    "command": "pipeline-live",
+    "operation_id": "getProjectPipelineLive",
+    "summary": "Retrieve Live Project Pipeline",
+    "description": "Retrieve the current project queue and ingest totals for the last completed minute.",
+    "method": "GET",
+    "path": "/v1/projects/:project_id/pipeline/live",
+    "alternate_paths": [],
+    "scopes": [
+      "servers:read"
+    ],
+    "notes": [
+      "Includes temporary deployment servers. Queue freshness is independent of heartbeat freshness. Observations taken while queues change return estimated counts from durable records; unreadable observations or unknown write outcomes return null counts.",
+      "Throughput and error totals cover the last completed minute. Errors count requests or frames, and totals are null when telemetry is incomplete."
+    ],
+    "path_params": [
+      {
+        "name": "project_id",
+        "type": "string",
+        "required": true,
+        "description": "Unique identifier of the project.",
+        "allowed_values": [],
+        "deprecated": null
+      }
+    ],
+    "query_params": [],
+    "body_fields": []
+  },
   {
     "resource": "projects",
     "command": "create",
@@ -134,14 +219,6 @@ export const CLI_COMMANDS = [
         "description": "Date and time when the project began collecting data. Optional.",
         "allowed_values": [],
         "deprecated": null
-      },
-      {
-        "name": "show_onboarding_ui",
-        "type": "boolean",
-        "required": false,
-        "description": "Whether to show the onboarding UI. Optional.",
-        "allowed_values": [],
-        "deprecated": null
       }
     ]
   },
@@ -186,14 +263,6 @@ export const CLI_COMMANDS = [
         "allowed_values": [],
         "deprecated": null
       },
-      {
-        "name": "show_onboarding_ui",
-        "type": "boolean",
-        "required": false,
-        "description": "Whether to show the onboarding UI. Optional.",
-        "allowed_values": [],
-        "deprecated": null
-      },
       {
         "name": "late_data_window_minutes",
         "type": "integer",
@@ -556,30 +625,6 @@ export const CLI_COMMANDS = [
         "allowed_values": [],
         "deprecated": null
       },
-      {
-        "name": "bloom_depth",
-        "type": "integer",
-        "required": false,
-        "description": "How many bloom filter layers are built for this source. Optional. Minimum: `1`. Maximum: `10`.",
-        "allowed_values": [],
-        "deprecated": null
-      },
-      {
-        "name": "schema_promotion_threshold",
-        "type": "integer",
-        "required": false,
-        "description": "How many records are sampled before a provisional schema is promoted. Optional. Minimum: `100`. Maximum: `10000`.",
-        "allowed_values": [],
-        "deprecated": null
-      },
-      {
-        "name": "provisional_schema_ttl_days",
-        "type": "integer",
-        "required": false,
-        "description": "How long a provisional schema is kept before it is cleaned up. Optional. Minimum: `1`. Maximum: `90`.",
-        "allowed_values": [],
-        "deprecated": null
-      },
       {
         "name": "project_id",
         "type": "string",
@@ -633,30 +678,6 @@ export const CLI_COMMANDS = [
         "allowed_values": [],
         "deprecated": null
       },
-      {
-        "name": "bloom_depth",
-        "type": "integer",
-        "required": false,
-        "description": "How many bloom filter layers are built for this source. Optional. Minimum: `1`. Maximum: `10`.",
-        "allowed_values": [],
-        "deprecated": null
-      },
-      {
-        "name": "schema_promotion_threshold",
-        "type": "integer",
-        "required": false,
-        "description": "How many records are sampled before a provisional schema is promoted. Optional. Minimum: `100`. Maximum: `10000`.",
-        "allowed_values": [],
-        "deprecated": null
-      },
-      {
-        "name": "provisional_schema_ttl_days",
-        "type": "integer",
-        "required": false,
-        "description": "How long a provisional schema is kept before it is cleaned up. Optional. Minimum: `1`. Maximum: `90`.",
-        "allowed_values": [],
-        "deprecated": null
-      },
       {
         "name": "deleted_at",
         "type": "null",
@@ -741,11 +762,11 @@ export const CLI_COMMANDS = [
     "body_fields": []
   },
   {
-    "resource": "ingestKeys",
+    "resource": "ingest_keys",
     "command": "list",
     "operation_id": "listIngestKeys",
     "summary": "List Ingest Keys",
-    "description": "Retrieve a list of ingest keys for a source.",
+    "description": "Retrieve every address that can send records to a source.",
     "method": "GET",
     "path": "/v1/projects/:project_id/sources/:source_id/ingest_keys",
     "alternate_paths": [],
@@ -789,7 +810,7 @@ export const CLI_COMMANDS = [
         "name": "status",
         "type": "IngestKeyStatus",
         "required": false,
-        "description": "Filter by ingest key status. Optional.",
+        "description": "Filter by whether the URL still accepts records. Optional.",
         "allowed_values": [
           "active",
           "revoked",
@@ -801,7 +822,7 @@ export const CLI_COMMANDS = [
         "name": "project_id",
         "type": "string",
         "required": false,
-        "description": "Filter to keys whose source belongs to a project. Optional.",
+        "description": "Filter to URLs whose source belongs to a project. Optional.",
         "allowed_values": [],
         "deprecated": null
       },
@@ -809,7 +830,7 @@ export const CLI_COMMANDS = [
         "name": "source_id",
         "type": "string",
         "required": false,
-        "description": "Filter to keys belonging to a single source. Optional.",
+        "description": "Filter to URLs belonging to a single source. Optional.",
         "allowed_values": [],
         "deprecated": null
       },
@@ -852,7 +873,7 @@ export const CLI_COMMANDS = [
     "body_fields": []
   },
   {
-    "resource": "ingestKeys",
+    "resource": "ingest_keys",
     "command": "retrieve",
     "operation_id": "getIngestKey",
     "summary": "Retrieve Ingest Key",
@@ -894,11 +915,11 @@ export const CLI_COMMANDS = [
     "body_fields": []
   },
   {
-    "resource": "ingestKeys",
+    "resource": "ingest_keys",
     "command": "create",
     "operation_id": "createIngestKey",
     "summary": "Create Ingest Key",
-    "description": "Create an ingest key for a source.",
+    "description": "Create an ingest key for a source. Use this to rotate: create the replacement, deploy it, then delete the old one.",
     "method": "POST",
     "path": "/v1/projects/:project_id/sources/:source_id/ingest_keys",
     "alternate_paths": [],
@@ -934,18 +955,18 @@ export const CLI_COMMANDS = [
         "name": "source_id",
         "type": "string",
         "required": false,
-        "description": "Source the ingest key writes into. Ignored when the nested path supplies it. Optional.",
+        "description": "Source the URL writes into. Ignored when the nested path supplies it. Optional.",
         "allowed_values": [],
         "deprecated": null
       }
     ]
   },
   {
-    "resource": "ingestKeys",
+    "resource": "ingest_keys",
     "command": "delete",
     "operation_id": "deleteIngestKey",
     "summary": "Delete Ingest Key",
-    "description": "Delete an ingest key. Data already sent with it is unaffected.",
+    "description": "Delete an ingest key. Records already sent to it are unaffected; the address stops being accepted.",
     "method": "DELETE",
     "path": "/v1/projects/:project_id/sources/:source_id/ingest_keys/:ingest_key_id",
     "alternate_paths": [],
@@ -1216,6 +1237,135 @@ export const CLI_COMMANDS = [
         "allowed_values": [],
         "deprecated": null
       },
+      {
+        "name": "expected_updated_at",
+        "type": "ISODateString",
+        "required": false,
+        "description": "Reject this update if the collection changed since this inspected update time. Optional.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "schema_opaque_paths",
+        "type": "string[][]",
+        "required": false,
+        "description": "Object paths whose contents do not take part in schema identity, each written as its key segments (`[\"metadata\", \"id\"]`). A path that names an array covers its elements and their children. Records that differ only inside an opaque path share one schema version; the raw values are still stored. Changing this re-keys the collection. Optional.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "schema_tracked_paths",
+        "type": "string[][]",
+        "required": false,
+        "description": "Children of opaque paths that stay part of schema identity, written like `schema_opaque_paths`. Changing this re-keys the collection. Optional.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "schema_max_depth",
+        "type": "integer",
+        "required": false,
+        "description": "How many levels of nesting take part in schema identity. Changing this re-keys the collection. Optional. Minimum: `1`. Maximum: `10`.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "schema_nulls",
+        "type": "string",
+        "required": false,
+        "description": "`auto` accepts null and absent values at any path a mapping reads; `manual` waits for a person to approve each nullable input per view. Optional.",
+        "allowed_values": [
+          "auto",
+          "manual"
+        ],
+        "deprecated": null
+      },
+      {
+        "name": "schema_optional_keys",
+        "type": "string",
+        "required": false,
+        "description": "`auto` lets a record whose keys are a subset of a version's keys join that version; `manual` treats every absent key as a different shape. Optional.",
+        "allowed_values": [
+          "auto",
+          "manual"
+        ],
+        "deprecated": null
+      },
+      {
+        "name": "schema_detector",
+        "type": "string",
+        "required": false,
+        "description": "`auto` applies a safe opaque-path proposal from the detector on its own; `manual` holds every proposal for a person. Optional.",
+        "allowed_values": [
+          "auto",
+          "manual"
+        ],
+        "deprecated": null
+      },
+      {
+        "name": "schema_recurrence_gap_ms",
+        "type": "integer",
+        "required": false,
+        "description": "How long after first sight a shape must be seen again before its version settles, in milliseconds. Optional. Minimum: `60000`. Maximum: `604800000`.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "schema_bulk_rows",
+        "type": "integer",
+        "required": false,
+        "description": "A single batch carrying at least this many rows of a shape settles its version immediately. `0` disables the bulk path. Optional. Minimum: `0`. Maximum: `1000000`.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "schema_stale_after_ms",
+        "type": "integer",
+        "required": false,
+        "description": "How long a candidate version waits to be seen again before it goes stale, in milliseconds. Optional. Minimum: `3600000`. Maximum: `7776000000`.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "schema_identity_limit",
+        "type": "integer",
+        "required": false,
+        "description": "How many settled schema versions the collection may hold. Past it, new shapes stay unclassified with their signatures kept. Optional. Minimum: `1`. Maximum: `4096`.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "schema_candidate_pool",
+        "type": "integer",
+        "required": false,
+        "description": "How many candidate and stale versions the collection may hold. Past it, new shapes stay unclassified. Optional. Minimum: `1`. Maximum: `8192`.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "schema_alias_pool",
+        "type": "integer",
+        "required": false,
+        "description": "How many exact signature hashes the collection remembers for fast lookup. Past it, a new hash is still resolved but not cached. Optional. Minimum: `16`. Maximum: `100000`.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "schema_writer_limit",
+        "type": "integer",
+        "required": false,
+        "description": "How many collection files one ingest batch may open for this collection. Shapes past the candidate pool get the same number of files per batch, the shapes with the most rows first; the rows of shapes past that budget stay unclassified and cannot be linked to a version later. Optional. Minimum: `1`. Maximum: `256`.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "schema_unclassified_retention_days",
+        "type": "integer | null",
+        "required": false,
+        "description": "How many days rows without a settled schema version are kept before they are deleted. `null` keeps them forever. Optional.",
+        "allowed_values": [],
+        "deprecated": null
+      },
       {
         "name": "deleted_at",
         "type": "null",
@@ -1304,7 +1454,7 @@ export const CLI_COMMANDS = [
     "command": "list-schemas",
     "operation_id": "listCollectionSchemas",
     "summary": "List Collection Schemas",
-    "description": "Retrieve the promoted schema versions for a collection.",
+    "description": "Retrieve the schema versions for a collection.",
     "method": "GET",
     "path": "/v1/projects/:project_id/collections/:collection_id/schemas",
     "alternate_paths": [],
@@ -1312,6 +1462,7 @@ export const CLI_COMMANDS = [
       "sources:read"
     ],
     "notes": [
+      "`state` is `candidate` from first sight, `settled` once the shape recurs or arrives in bulk, and `stale` when a candidate is not seen again. Only a settled version is offered to views for authoring.",
       "`after` and `before` are mutually exclusive."
     ],
     "path_params": [
@@ -1332,46 +1483,212 @@ export const CLI_COMMANDS = [
         "deprecated": null
       }
     ],
-    "query_params": [],
-    "body_fields": []
-  },
-  {
-    "resource": "collections",
-    "command": "list-provisional-schemas",
-    "operation_id": "listCollectionProvisionalSchemas",
-    "summary": "List Provisional Schemas",
-    "description": "Retrieve the schemas seen but not yet promoted for a collection.",
-    "method": "GET",
-    "path": "/v1/projects/:project_id/collections/:collection_id/provisional_schemas",
-    "alternate_paths": [],
-    "scopes": [
-      "sources:read"
-    ],
-    "notes": [
-      "A provisional schema is promoted once enough records match it, and cleaned up if it goes stale first. Both thresholds are set on the collection's source.",
-      "`after` and `before` are mutually exclusive."
-    ],
-    "path_params": [
+    "query_params": [
       {
-        "name": "project_id",
+        "name": "limit",
+        "type": "number",
+        "required": false,
+        "description": "Maximum number of items to return. Optional. Defaults to `25`. Minimum: `1`. Maximum: `200`.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "after",
         "type": "string",
-        "required": true,
-        "description": "Unique identifier of the project.",
+        "required": false,
+        "description": "Cursor from `pagination.next_cursor` of a previous response. Returns the resources after that page. Optional.",
         "allowed_values": [],
         "deprecated": null
       },
       {
-        "name": "collection_id",
+        "name": "before",
         "type": "string",
-        "required": true,
-        "description": "Unique identifier of the collection.",
+        "required": false,
+        "description": "Cursor from `pagination.prev_cursor` of a previous response. Returns the resources before that page. Optional.",
         "allowed_values": [],
         "deprecated": null
-      }
-    ],
-    "query_params": [],
+      },
+      {
+        "name": "sort",
+        "type": "string",
+        "required": false,
+        "description": "Sort direction for the result set. Optional. Defaults to `\"desc\"`.",
+        "allowed_values": [
+          "asc",
+          "desc"
+        ],
+        "deprecated": null
+      },
+      {
+        "name": "state",
+        "type": "string",
+        "required": false,
+        "description": "Return only schema versions in this state. Optional.",
+        "allowed_values": [
+          "candidate",
+          "settled",
+          "stale"
+        ],
+        "deprecated": null
+      }
+    ],
     "body_fields": []
   },
+  {
+    "resource": "collections",
+    "command": "update-schema",
+    "operation_id": "updateCollectionSchema",
+    "summary": "Update Collection Schema",
+    "description": "Settle a schema version by hand, so views can author against it before its shape recurs.",
+    "method": "POST",
+    "path": "/v1/projects/:project_id/collections/:collection_id/schemas/:schema_version_id",
+    "alternate_paths": [],
+    "scopes": [
+      "sources:write"
+    ],
+    "notes": [
+      "`state` accepts only `settled`; a settled version never returns to candidate or stale.",
+      "A version that is already settled is left as it is and responds with `request_no_update`."
+    ],
+    "path_params": [
+      {
+        "name": "project_id",
+        "type": "string",
+        "required": true,
+        "description": "Unique identifier of the project.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "collection_id",
+        "type": "string",
+        "required": true,
+        "description": "Unique identifier of the collection.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "schema_version_id",
+        "type": "string",
+        "required": true,
+        "description": "Unique identifier of the schema.",
+        "allowed_values": [],
+        "deprecated": null
+      }
+    ],
+    "query_params": [],
+    "body_fields": [
+      {
+        "name": "state",
+        "type": "string",
+        "required": true,
+        "description": "The only state a person sets. `settled` trusts the version for view authoring now, without waiting for its shape to recur; a settled version never goes back.",
+        "allowed_values": [
+          "settled"
+        ],
+        "deprecated": null
+      }
+    ]
+  },
+  {
+    "resource": "collections",
+    "command": "retrieve-schema-report",
+    "operation_id": "getCollectionSchemaReport",
+    "summary": "Retrieve Collection Schema Report",
+    "description": "Retrieve the detector's view of a collection: the opaque paths it proposes, whether the top-level keys are data, and how many shapes sit unclassified past the collection's pools.",
+    "method": "GET",
+    "path": "/v1/projects/:project_id/collections/:collection_id/schema_report",
+    "alternate_paths": [],
+    "scopes": [
+      "sources:read"
+    ],
+    "notes": [
+      "A proposal a bound mapping reads inside is reported and never applied on its own, whatever the detector switch; apply it by adding its path to the collection's `schema_opaque_paths` and its tracked children to `schema_tracked_paths`.",
+      "`shapes.before` and `shapes.after` are equal here; the preview is where they differ."
+    ],
+    "path_params": [
+      {
+        "name": "project_id",
+        "type": "string",
+        "required": true,
+        "description": "Unique identifier of the project.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "collection_id",
+        "type": "string",
+        "required": true,
+        "description": "Unique identifier of the collection.",
+        "allowed_values": [],
+        "deprecated": null
+      }
+    ],
+    "query_params": [],
+    "body_fields": []
+  },
+  {
+    "resource": "collections",
+    "command": "preview-schema-rules",
+    "operation_id": "previewCollectionSchemaRules",
+    "summary": "Preview Collection Schema Rules",
+    "description": "Preview a rule change: the schema report the collection would read under the rules sent, with how many shapes it holds now and how many it would hold. Nothing is changed.",
+    "method": "POST",
+    "path": "/v1/projects/:project_id/collections/:collection_id/schema_preview",
+    "alternate_paths": [],
+    "scopes": [
+      "sources:read"
+    ],
+    "notes": [
+      "A rule left out of the body keeps the collection's current value.",
+      "`shapes.before` counts the shapes under the collection's current rules and `shapes.after` under the rules sent; the difference is what updating the collection with those rules would merge."
+    ],
+    "path_params": [
+      {
+        "name": "project_id",
+        "type": "string",
+        "required": true,
+        "description": "Unique identifier of the project.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "collection_id",
+        "type": "string",
+        "required": true,
+        "description": "Unique identifier of the collection.",
+        "allowed_values": [],
+        "deprecated": null
+      }
+    ],
+    "query_params": [],
+    "body_fields": [
+      {
+        "name": "schema_opaque_paths",
+        "type": "string[][]",
+        "required": false,
+        "description": "Opaque paths to preview, written like the collection's `schema_opaque_paths`. Omitted, the collection's current opaque paths apply. Optional.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "schema_tracked_paths",
+        "type": "string[][]",
+        "required": false,
+        "description": "Tracked paths to preview, written like the collection's `schema_tracked_paths`. Omitted, the collection's current tracked paths apply. Optional.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "schema_max_depth",
+        "type": "integer",
+        "required": false,
+        "description": "Max depth to preview. Omitted, the collection's current max depth applies. Optional. Minimum: `1`. Maximum: `10`.",
+        "allowed_values": [],
+        "deprecated": null
+      }
+    ]
+  },
   {
     "resource": "collections",
     "command": "list-docs",
@@ -1594,14 +1911,6 @@ export const CLI_COMMANDS = [
         "allowed_values": [],
         "deprecated": null
       },
-      {
-        "name": "description",
-        "type": "string | null",
-        "required": false,
-        "description": "Description of the view. Optional.",
-        "allowed_values": [],
-        "deprecated": null
-      },
       {
         "name": "output_schema",
         "type": "object[]",
@@ -1618,6 +1927,14 @@ export const CLI_COMMANDS = [
         "allowed_values": [],
         "deprecated": null
       },
+      {
+        "name": "mapping_policy",
+        "type": "object",
+        "required": false,
+        "description": "Optional.",
+        "allowed_values": [],
+        "deprecated": null
+      },
       {
         "name": "project_id",
         "type": "string",
@@ -1652,7 +1969,7 @@ export const CLI_COMMANDS = [
       },
       {
         "name": "transform_mode",
-        "type": "ViewTransformMode",
+        "type": "string",
         "required": false,
         "description": "Whether a new schema version that no existing transform covers gets a script generated for it, or waits for you to write one. Defaults to auto. Optional.",
         "allowed_values": [
@@ -1704,14 +2021,6 @@ export const CLI_COMMANDS = [
         "allowed_values": [],
         "deprecated": null
       },
-      {
-        "name": "description",
-        "type": "string",
-        "required": false,
-        "description": "What this join view is for. Optional. Maximum length: `2048`.",
-        "allowed_values": [],
-        "deprecated": null
-      },
       {
         "name": "project_id",
         "type": "string",
@@ -1767,7 +2076,7 @@ export const CLI_COMMANDS = [
     "command": "update",
     "operation_id": "updateView",
     "summary": "Update View",
-    "description": "Update a view's name, description, or output schema.",
+    "description": "Update a view's name or output schema.",
     "method": "POST",
     "path": "/v1/projects/:project_id/views/:view_id",
     "alternate_paths": [],
@@ -1775,7 +2084,8 @@ export const CLI_COMMANDS = [
       "views:write"
     ],
     "notes": [
-      "Changing the output schema does not re-run existing records on its own. Use regenerate to rebuild the view against the new schema.",
+      "Output schema changes are accepted only before a mapping or stored output exists. Changing an existing view's output schema requires a recovery transition that is not yet supported.",
+      "Mapping policy changes on an existing mapping require reviewed coverage recovery. Hint changes preserve accepted mappings and retry undecided work with the new hint.",
       "What a view reads from is fixed at creation, so `collection_id` and `parent_view_id` are not accepted here. Create a new view to read from something else.",
       "`output_schema` field names must be unique by name, cannot conflict on type, and cannot collide with a reserved query key such as `limit` or `cursor`.",
       "Use `hint` for rules the generator cannot read off the field names: a formatting rule (\"display_name should be Name (Type)\"), a business threshold (\"classify as high above 500\"), or a disambiguation when a source field could map more than one way. Skip it for obvious mappings like renames and type conversions, which the generator already handles."
@@ -1801,18 +2111,18 @@ export const CLI_COMMANDS = [
     "query_params": [],
     "body_fields": [
       {
-        "name": "name",
-        "type": "string",
+        "name": "mapping_policy",
+        "type": "object",
         "required": false,
-        "description": "Name for the view. Optional. Minimum length: `1`. Maximum length: `128`.",
+        "description": "Optional.",
         "allowed_values": [],
         "deprecated": null
       },
       {
-        "name": "description",
-        "type": "string | null",
+        "name": "name",
+        "type": "string",
         "required": false,
-        "description": "Description of the view. Optional.",
+        "description": "Name for the view. Optional. Minimum length: `1`. Maximum length: `128`.",
         "allowed_values": [],
         "deprecated": null
       },
@@ -1834,7 +2144,7 @@ export const CLI_COMMANDS = [
       },
       {
         "name": "transform_mode",
-        "type": "ViewTransformMode",
+        "type": "string",
         "required": false,
         "description": "Whether a new schema version that no existing transform covers gets a script generated for it, or waits for you to write one. Optional.",
         "allowed_values": [
@@ -1875,7 +2185,7 @@ export const CLI_COMMANDS = [
     ],
     "notes": [
       "Views derived from this one are deleted with it.",
-      "The delete is refused while an active drain reads from this view or from any view that would cascade with it. Delete or pause those drains first. Draft drains are removed silently.",
+      "The delete is refused while an active drain reads from this view or from any view that would cascade with it. Delete those drains first. Draft drains are removed silently.",
       "Backfill and indexing work for the whole cascade is cancelled immediately, so a deleted view stops consuming capacity before its rows are removed."
     ],
     "path_params": [
@@ -2073,6 +2383,209 @@ export const CLI_COMMANDS = [
     ],
     "body_fields": []
   },
+  {
+    "resource": "views",
+    "command": "inspect-deferral",
+    "operation_id": "inspectViewDeferral",
+    "summary": "Inspect Waiting Shape",
+    "description": "Inspect structural differences and candidate output bindings for a waiting shape.",
+    "method": "GET",
+    "path": "/v1/projects/:project_id/views/:view_id/deferrals/:deferral_id",
+    "alternate_paths": [],
+    "scopes": [
+      "views:read"
+    ],
+    "notes": [],
+    "path_params": [
+      {
+        "name": "project_id",
+        "type": "string",
+        "required": true,
+        "description": "Unique identifier of the project.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "view_id",
+        "type": "string",
+        "required": true,
+        "description": "Unique identifier of the view.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "deferral_id",
+        "type": "string",
+        "required": true,
+        "description": "Unique identifier of the deferral.",
+        "allowed_values": [],
+        "deprecated": null
+      }
+    ],
+    "query_params": [],
+    "body_fields": []
+  },
+  {
+    "resource": "views",
+    "command": "retrieve-deferral-hint",
+    "operation_id": "retrieveViewDeferralHint",
+    "summary": "Retrieve Waiting Shape Hint",
+    "description": "Retrieve the model's current binding question for a waiting shape.",
+    "method": "GET",
+    "path": "/v1/projects/:project_id/views/:view_id/deferrals/:deferral_id/hint",
+    "alternate_paths": [],
+    "scopes": [
+      "views:read",
+      "sources:read"
+    ],
+    "notes": [
+      "Requires both views:read and sources:read because model prose may refer to source records. Suggested paths are verified source fields in unambiguous JSON bracket notation.",
+      "Returns null when no current question remains. Answer using this question's episode, mapping_generation, requested_at, and transform_id."
+    ],
+    "path_params": [
+      {
+        "name": "project_id",
+        "type": "string",
+        "required": true,
+        "description": "Unique identifier of the project.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "view_id",
+        "type": "string",
+        "required": true,
+        "description": "Unique identifier of the view.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "deferral_id",
+        "type": "string",
+        "required": true,
+        "description": "Unique identifier of the deferral.",
+        "allowed_values": [],
+        "deprecated": null
+      }
+    ],
+    "query_params": [],
+    "body_fields": []
+  },
+  {
+    "resource": "views",
+    "command": "decide-deferral",
+    "operation_id": "decideViewDeferral",
+    "summary": "Decide Waiting Shape",
+    "description": "Resolve the next action for one view and schema version.",
+    "method": "POST",
+    "path": "/v1/projects/:project_id/views/:view_id/deferrals/:deferral_id/decision",
+    "alternate_paths": [],
+    "scopes": [
+      "views:write"
+    ],
+    "notes": [
+      "Authoring and hint answers reserve a bounded model budget. Exclusion covers unprocessed and future records of this exact version in this view.",
+      "Answering a hint requires `hint`; excluding a version requires `reason`. Exclusion covers unprocessed and future records with this exact schema version in this view.",
+      "Answering a pending model question also requires its exact `hint_requested_at` and `hint_transform_id`. Superseded or answered questions return a conflict; manual guidance without a pending question may omit both fields."
+    ],
+    "path_params": [
+      {
+        "name": "project_id",
+        "type": "string",
+        "required": true,
+        "description": "Unique identifier of the project.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "view_id",
+        "type": "string",
+        "required": true,
+        "description": "Unique identifier of the view.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "deferral_id",
+        "type": "string",
+        "required": true,
+        "description": "Unique identifier of the deferral.",
+        "allowed_values": [],
+        "deprecated": null
+      }
+    ],
+    "query_params": [],
+    "body_fields": [
+      {
+        "name": "episode",
+        "type": "integer",
+        "required": true,
+        "description": "The deferral episode shown when the decision was inspected. Minimum: `1`.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "action",
+        "type": "string",
+        "required": true,
+        "description": "Authorize a bounded authoring attempt, answer a hint, or exclude this exact version in this view.",
+        "allowed_values": [
+          "author",
+          "hint",
+          "exclude"
+        ],
+        "deprecated": null
+      },
+      {
+        "name": "mapping_generation",
+        "type": "integer",
+        "required": true,
+        "description": "The mapping generation shown when the decision was inspected. Minimum: `1`.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "hint",
+        "type": "string",
+        "required": false,
+        "description": "Answer to the model's binding question. Optional. Minimum length: `1`. Maximum length: `4096`.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "hint_requested_at",
+        "type": "ISODateString",
+        "required": false,
+        "description": "Exact requested_at of the pending hint being answered. Optional.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "hint_transform_id",
+        "type": "string",
+        "required": false,
+        "description": "Transform that owns the pending hint being answered. Optional. Minimum length: `1`. Maximum length: `32`.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "reason",
+        "type": "string",
+        "required": false,
+        "description": "Required audit reason for an exclusion. Optional. Minimum length: `1`. Maximum length: `2000`.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "mapping_policy",
+        "type": "object",
+        "required": false,
+        "description": "Explicit null, fallback, drop, and source-binding rules. Optional.",
+        "allowed_values": [],
+        "deprecated": null
+      }
+    ]
+  },
   {
     "resource": "views",
     "command": "list-transforms",
@@ -2212,6 +2725,156 @@ export const CLI_COMMANDS = [
     "query_params": [],
     "body_fields": []
   },
+  {
+    "resource": "views",
+    "command": "list-versions",
+    "operation_id": "listViewVersions",
+    "summary": "List View Versions",
+    "description": "Retrieve a list of the schema versions a view covers.",
+    "method": "GET",
+    "path": "/v1/projects/:project_id/views/:view_id/versions",
+    "alternate_paths": [],
+    "scopes": [
+      "views:read"
+    ],
+    "notes": [
+      "One row per source schema version the view covers, newest version first. A view that reads another view has no schema versions, so its list is empty.",
+      "Versions sharing a `script_hash` run the same transform. Filter by it to see every version one script serves.",
+      "`after` and `before` are mutually exclusive."
+    ],
+    "path_params": [
+      {
+        "name": "project_id",
+        "type": "string",
+        "required": true,
+        "description": "Unique identifier of the project.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "view_id",
+        "type": "string",
+        "required": true,
+        "description": "Unique identifier of the view.",
+        "allowed_values": [],
+        "deprecated": null
+      }
+    ],
+    "query_params": [
+      {
+        "name": "order_by",
+        "type": "string",
+        "required": false,
+        "description": "Field the results are sorted by. Optional. Defaults to `\"version\"`.",
+        "allowed_values": [
+          "version"
+        ],
+        "deprecated": null
+      },
+      {
+        "name": "status",
+        "type": "ViewTransformStatus",
+        "required": false,
+        "description": "Return only versions whose transform is in this state. Optional.",
+        "allowed_values": [
+          "queued",
+          "analyzing",
+          "active",
+          "error",
+          "draft"
+        ],
+        "deprecated": null
+      },
+      {
+        "name": "script_hash",
+        "type": "string",
+        "required": false,
+        "description": "Return only versions served by this script. Take the value from a version's row. Optional. Minimum length: `64`. Maximum length: `64`.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "limit",
+        "type": "number",
+        "required": false,
+        "description": "Maximum number of items to return. Optional. Defaults to `25`. Minimum: `1`. Maximum: `200`.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "after",
+        "type": "string",
+        "required": false,
+        "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": "Sort direction for the result set. Optional. Defaults to `\"desc\"`.",
+        "allowed_values": [
+          "asc",
+          "desc"
+        ],
+        "deprecated": null
+      }
+    ],
+    "body_fields": []
+  },
+  {
+    "resource": "views",
+    "command": "retrieve-version",
+    "operation_id": "getViewVersion",
+    "summary": "Retrieve View Version",
+    "description": "Retrieve one schema version a view covers.",
+    "method": "GET",
+    "path": "/v1/projects/:project_id/views/:view_id/versions/:version_id",
+    "alternate_paths": [],
+    "scopes": [
+      "views:read"
+    ],
+    "notes": [
+      "`version_id` is the schema version NUMBER, the `version` a row carries, not a `vta_` id."
+    ],
+    "path_params": [
+      {
+        "name": "project_id",
+        "type": "string",
+        "required": true,
+        "description": "Unique identifier of the project.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "view_id",
+        "type": "string",
+        "required": true,
+        "description": "Unique identifier of the view.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "version_id",
+        "type": "string",
+        "required": true,
+        "description": "Unique identifier of the version.",
+        "allowed_values": [],
+        "deprecated": null
+      }
+    ],
+    "query_params": [],
+    "body_fields": []
+  },
   {
     "resource": "views",
     "command": "create-transform",
@@ -2287,7 +2950,7 @@ export const CLI_COMMANDS = [
       "Conflicting versions are moved to queued placeholders by default. Set `conflict_resolution` to `keep` to leave those versions on their prior script.",
       "Removing an output field is rejected while a metric, facet, child view, or join clause reads it. Consumer checks use the complete nested output path. Records already produced keep their existing values until the transform is re-backfilled.",
       "Set `dry_run` to preview the per-version verdict report without saving. A dry run changes nothing and triggers nothing, and returns a `preview_token` alongside the report.",
-      "Saving requires the `preview_token` from that dry run. It pins the save to the set of schema versions the report described, so a version promoted or reassigned between the preview and the save cannot be silently included.",
+      "Saving requires the `preview_token` from that dry run. It pins the save to the set of schema versions the report described, so a version added or reassigned between the preview and the save cannot be silently included.",
       "A save with a missing or outdated token is rejected with 409 and changes nothing. The error carries the report as it stands now, so the next preview is already in hand.",
       "`transform_script` cannot be whitespace-only. To clear a script and have it regenerated, use the regenerate endpoint rather than sending an empty one.",
       "Saving is a two-step gesture: send `dry_run` to get the report and its `preview_token`, then send the same edit with that token. A save without one, or with a token whose set has since changed, is rejected with 409 and a fresh report."
@@ -2351,7 +3014,7 @@ export const CLI_COMMANDS = [
         "name": "preview_token",
         "type": "string",
         "required": false,
-        "description": "The `edit_report.preview_token` from this edit's dry run. Required to save: it pins the save to the set of schema versions the preview reported on, so a version promoted or reassigned in between is rejected instead of silently included. Optional. Minimum length: `1`. Maximum length: `128`.",
+        "description": "The `edit_report.preview_token` from this edit's dry run. Required to save: it pins the save to the set of schema versions the preview reported on, so a version assigned or reassigned in between is rejected instead of silently included. Optional. Minimum length: `1`. Maximum length: `128`.",
         "allowed_values": [],
         "deprecated": null
       }
@@ -2574,6 +3237,14 @@ export const CLI_COMMANDS = [
       }
     ],
     "query_params": [
+      {
+        "name": "view_id",
+        "type": "string",
+        "required": false,
+        "description": "Return metrics that read from this view. Optional.",
+        "allowed_values": [],
+        "deprecated": null
+      },
       {
         "name": "order_by",
         "type": "string",
@@ -2677,7 +3348,9 @@ export const CLI_COMMANDS = [
       "metrics:read"
     ],
     "notes": [
-      "`complete_through_at` is the end-exclusive instant through which the result is final. A null value means no completeness statement can currently be made.",
+      "`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.",
       "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`.",
@@ -2703,6 +3376,17 @@ 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",
@@ -2833,7 +3517,8 @@ export const CLI_COMMANDS = [
       "Custom chart ranges require both dates, with an interval of at least 30 minutes.",
       "Color-mode configuration must match the selected chart color mode.",
       "`filters` must be a valid filter expression.",
-      "`timestamp_field` cannot reference `__meta__` metadata."
+      "`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."
     ],
     "path_params": [
       {
@@ -2867,7 +3552,15 @@ export const CLI_COMMANDS = [
         "name": "group_by",
         "type": "string[]",
         "required": false,
-        "description": "View fields used to split records into series. Optional. Defaults to `[]`.",
+        "description": "View fields used to split records into series. Optional. Defaults to `[]`.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "group_by_display_fields",
+        "type": "object | null",
+        "required": false,
+        "description": "Maps a field in `group_by` to another view field whose value labels the series, so a chart grouped on an opaque id reads as `api.example.com` instead of `chk_a1b2c3`. Each label is read from the first record of a series and kept from then on. Optional.",
         "allowed_values": [],
         "deprecated": null
       },
@@ -4020,9 +4713,10 @@ export const CLI_COMMANDS = [
     "notes": [
       "The monitor starts evaluating on its schedule as soon as it is created.",
       "`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.",
+      "`schedule_cron` must be a valid 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": [
@@ -4107,9 +4801,223 @@ export const CLI_COMMANDS = [
       },
       {
         "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.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "condition_type",
+        "type": "MonitorConditionType",
+        "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\"`.",
+        "allowed_values": [
+          "threshold",
+          "sustained",
+          "existence",
+          "absence"
+        ],
+        "deprecated": null
+      },
+      {
+        "name": "operator",
+        "type": "MonitorOperator",
+        "required": false,
+        "description": "How the metric value is compared against the threshold. Optional. Defaults to `\"gt\"`.",
+        "allowed_values": [
+          "gt",
+          "gte",
+          "lt",
+          "lte",
+          "eq",
+          "neq"
+        ],
+        "deprecated": null
+      },
+      {
+        "name": "threshold_value",
+        "type": "number | null",
+        "required": false,
+        "description": "The value the metric is compared against. Optional.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "sustained_minutes",
         "type": "number | null",
         "required": false,
-        "description": "How far back each evaluation looks when it reads the metric. Optional.",
+        "description": "How long the condition must hold before the monitor fires. Optional.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "schedule_cron",
+        "type": "string",
+        "required": false,
+        "description": "Cron expression, in UTC, setting how often the monitor evaluates. Optional. Defaults to `\"* * * * *\"`. Minimum length: `1`. Maximum length: `128`.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "alert_mode",
+        "type": "MonitorAlertMode",
+        "required": false,
+        "description": "Whether an alert stays open until the condition clears, or opens and ends in one moment. Optional. Defaults to `\"spanning\"`.",
+        "allowed_values": [
+          "spanning",
+          "instant"
+        ],
+        "deprecated": null
+      },
+      {
+        "name": "expires_at",
+        "type": "ISODateString | null",
+        "required": false,
+        "description": "When the monitor stops evaluating. Leave null for no expiry. Optional.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "series_filters",
+        "type": "object | null",
+        "required": false,
+        "description": "Narrows which of the metric's series this monitor watches. Optional.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "min_occurrences",
+        "type": "integer | null",
+        "required": false,
+        "description": "How many times the condition must be met before the monitor fires. Optional.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "occurrence_window_minutes",
+        "type": "integer | null",
+        "required": false,
+        "description": "The window those occurrences have to fall within. Optional.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "metric_id",
+        "type": "string",
+        "required": false,
+        "description": "Metric to watch. Optional when using the /metrics/:metric/monitors route. Optional.",
+        "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.",
+    "method": "POST",
+    "path": "/v1/projects/:project_id/metrics/:metric_id/monitors/preview",
+    "alternate_paths": [],
+    "scopes": [
+      "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.",
+      "A monitor cannot be created active with an `expires_at` already in the past."
+    ],
+    "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": "name",
+        "type": "string",
+        "required": false,
+        "description": "Name shown for this monitor. Optional. Minimum length: `2`. Maximum length: `64`.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "description",
+        "type": "string | null",
+        "required": false,
+        "description": "What this monitor watches for. Optional.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "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\"`.",
+        "allowed_values": [
+          "active",
+          "paused"
+        ],
+        "deprecated": null
+      },
+      {
+        "name": "chart_value",
+        "type": "MetricChartValue",
+        "required": false,
+        "description": "Which value of the metric is compared against the threshold. Optional. Defaults to `\"sum\"`.",
+        "allowed_values": [
+          "count",
+          "average",
+          "min",
+          "max",
+          "sum",
+          "last",
+          "cumulative_count",
+          "cumulative_sum",
+          "p50",
+          "p95",
+          "p99",
+          "count_unique"
+        ],
+        "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\"`.",
+        "allowed_values": [
+          "total",
+          "any_series",
+          "each_series"
+        ],
+        "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.",
         "allowed_values": [],
         "deprecated": null
       },
@@ -4117,11 +5025,12 @@ export const CLI_COMMANDS = [
         "name": "condition_type",
         "type": "MonitorConditionType",
         "required": false,
-        "description": "Whether the condition is a plain threshold or one that must hold for a duration. Optional. Defaults to `\"threshold\"`.",
+        "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\"`.",
         "allowed_values": [
           "threshold",
           "sustained",
-          "existence"
+          "existence",
+          "absence"
         ],
         "deprecated": null
       },
@@ -4234,9 +5143,10 @@ export const CLI_COMMANDS = [
       "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.",
       "`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.",
+      "`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."
@@ -4320,9 +5230,9 @@ export const CLI_COMMANDS = [
       },
       {
         "name": "time_window_minutes",
-        "type": "number | null",
+        "type": "integer | null",
         "required": false,
-        "description": "How far back each evaluation looks when it reads the metric. Optional.",
+        "description": "Evaluation lookback in whole minutes (1 to 525600). Null means since the metric was created. No-data conditions require a finite window. Optional.",
         "allowed_values": [],
         "deprecated": null
       },
@@ -4330,11 +5240,12 @@ export const CLI_COMMANDS = [
         "name": "condition_type",
         "type": "MonitorConditionType",
         "required": false,
-        "description": "Whether the condition is a plain threshold or one that must hold for a duration. Optional.",
+        "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.",
         "allowed_values": [
           "threshold",
           "sustained",
-          "existence"
+          "existence",
+          "absence"
         ],
         "deprecated": null
       },
@@ -4949,6 +5860,22 @@ export const CLI_COMMANDS = [
         "allowed_values": [],
         "deprecated": null
       },
+      {
+        "name": "public_ui_show_trends",
+        "type": "boolean",
+        "required": false,
+        "description": "Whether trend lines enabled on each metric are shown on the public page. Defaults to true. Optional.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "public_ui_show_forecast",
+        "type": "boolean",
+        "required": false,
+        "description": "Whether forecasts enabled on each metric are shown on the public page. Defaults to true. Optional.",
+        "allowed_values": [],
+        "deprecated": null
+      },
       {
         "name": "access_code",
         "type": "string | null",
@@ -5082,6 +6009,22 @@ export const CLI_COMMANDS = [
         "allowed_values": [],
         "deprecated": null
       },
+      {
+        "name": "public_ui_show_trends",
+        "type": "boolean",
+        "required": false,
+        "description": "Whether trend lines enabled on each metric are shown on the public page. Defaults to true. Optional.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "public_ui_show_forecast",
+        "type": "boolean",
+        "required": false,
+        "description": "Whether forecasts enabled on each metric are shown on the public page. Defaults to true. Optional.",
+        "allowed_values": [],
+        "deprecated": null
+      },
       {
         "name": "access_code",
         "type": "string | null",
@@ -5665,6 +6608,36 @@ export const CLI_COMMANDS = [
     "query_params": [],
     "body_fields": []
   },
+  {
+    "resource": "teams",
+    "command": "billing",
+    "operation_id": "getTeamBilling",
+    "summary": "Retrieve Team Billing",
+    "description": "Retrieve the team's current billing summary.",
+    "method": "GET",
+    "path": "/v1/teams/:team_id/billing",
+    "alternate_paths": [],
+    "scopes": [
+      "billing:read"
+    ],
+    "notes": [
+      "Requires `billing:read` and credentials scoped to this team. Every response includes accrued and projected charges, stored and available promotional credits, and server usage.",
+      "Available credits account for uninvoiced usage, including the preceding month before its invoice is saved. Reading this summary does not consume credits or create an invoice.",
+      "Amounts exclude tax and credit notes applied at payment. Projections assume current usage continues; the final invoice can differ."
+    ],
+    "path_params": [
+      {
+        "name": "team_id",
+        "type": "string",
+        "required": true,
+        "description": "Unique identifier of the team.",
+        "allowed_values": [],
+        "deprecated": null
+      }
+    ],
+    "query_params": [],
+    "body_fields": []
+  },
   {
     "resource": "teams",
     "command": "create",
@@ -6455,16 +7428,20 @@ export const CLI_COMMANDS = [
       },
       {
         "name": "default_ai_model",
-        "type": "AiModel",
+        "type": "AiChatSelection",
         "required": false,
-        "description": "Model a new chat opens on. Null clears the preference. Only used when that model is available on the current team, so a chat can still run on a different one. Optional.",
+        "description": "Model a new chat opens on. Null clears the preference. An unavailable selection asks the member to choose again; it never changes who pays automatically. Optional.",
         "allowed_values": [
-          "claude-opus-5",
+          "claude-opus-5-5",
           "claude-sonnet-5",
-          "gpt-5.6-sol",
+          "gpt-6-sol",
           "gpt-5.6-terra",
+          "gpt-6-luna",
+          "claude-opus-5",
+          "gpt-5.6-sol",
           "gpt-5.6-luna",
-          "claude-opus-4-6"
+          "claude-opus-4-6",
+          "tailglow"
         ],
         "deprecated": null
       },
@@ -7496,7 +8473,9 @@ export const CLI_COMMANDS = [
       "Scaling up requires the team to have a payment method, and `count` must stay within the team's per-project server limit.",
       "The response is the project's whole fleet after the request, not only the servers that changed.",
       "Requesting the count the project already runs, with nothing in flight, returns a `409`.",
-      "A project with a platform deploy in progress returns a `409` until that deploy completes."
+      "During a platform update, a scale request is queued and answered with a `202`; it is applied once the update finishes, and the project's `queued_server_count` shows it meanwhile. A project that has no servers yet still gets its first server immediately.",
+      "Adding servers to a project that has not finished moving to the current platform version is queued the same way, even with no update in progress. Removing servers is not held back by it.",
+      "Requesting the count the project currently runs while a change is queued cancels the queued change, or returns a `409` if that change has already started. A newer request replaces an older queued one."
     ],
     "path_params": [
       {
@@ -7645,7 +8624,7 @@ export const CLI_COMMANDS = [
       "servers:read"
     ],
     "notes": [
-      "Pending counts the request frames waiting in the server's queue, Throughput counts the events it drained, and Errors counts rejected requests and dropped frames, with one series per reason.",
+      "Pending averages valid queued records, Throughput counts drained records, and Errors counts rejected requests and dropped frames. Older pending history without record counts is unknown.",
       "Takes the same range and interval parameters as the vitals endpoint, so the two can be read over the same window.",
       "Without `start_at` and `end_at` the range is the last 12 hours."
     ],
@@ -9028,7 +10007,8 @@ export const CLI_COMMANDS = [
       "`schedule_cron` must be a valid cron expression. It is evaluated in UTC, and the finest granularity is one minute.",
       "`collection_slug` is required, and must be lowercase, start with a letter or digit, and may otherwise contain digits, letters, hyphens and underscores. Naming it here is what lets several checks deliberately share one collection and chart together; renaming the check later never moves the series, because the slug is stored rather than derived.",
       "`check_retry_seconds` is between 1 and 20, and defaults to 10. A failed run waits this long and requests once more before it is recorded, so a single flake does not become a recorded minute of downtime. Send `null` to record the first result as it stands.",
-      "Each run writes one observation to `collection_slug` carrying `check_id`, `checked_at`, `up`, `http_status`, `response_time_ms`, `error_stage`, `error_message` and `attempts`. `up` is 1 when the endpoint returned a 2xx and 0 when it did not answer or answered with an error status, so the average of `up` over a period is the uptime for that period.",
+      "Each run writes one observation to `collection_slug` carrying `check_id`, `check_name`, `checked_at`, `up`, `http_status`, `response_time_ms`, `error_stage`, `error_message` and `attempts`. `up` is 1 when the endpoint returned a 2xx and 0 when it did not answer or answered with an error status, so the average of `up` over a period is the uptime for that period.",
+      "`check_name` is the name the check carried when the run was recorded, so a chart grouped on `check_id` can label its series with something readable. Renaming the check does not rewrite observations already stored.",
       "`checked_at` is the scheduled minute rather than the moment the observation was written, so a run delayed by a confirming request still lands in the minute it describes.",
       "`name` must be unique within the project, so a check is identifiable in a list and in the strip it charts as."
     ],