@tailglow/cli 0.2.1 → 0.4.1

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": [
@@ -1920,15 +2230,240 @@ export const CLI_COMMANDS = [
         "name": "project_id",
         "type": "string",
         "required": true,
-        "description": "Unique identifier of the project.",
+        "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": [],
+    "body_fields": []
+  },
+  {
+    "resource": "views",
+    "command": "list-records",
+    "operation_id": "listViewRecords",
+    "summary": "List View Records",
+    "description": "Retrieve the transformed records a view has produced.",
+    "method": "GET",
+    "path": "/v1/projects/:project_id/views/:view_id/records",
+    "alternate_paths": [],
+    "scopes": [
+      "views:read"
+    ],
+    "notes": [
+      "Records are only filterable on fields that have a facet. Filtering on any other field is rejected, so create a facet for a field before querying it.",
+      "Paging is forward-only. Pass `pagination.next_cursor` back as `after` to get the next page; a null `next_cursor` means there is nothing more to read. No `prev_cursor` is issued, and `before` is ignored.",
+      "A cursor is only valid for the query that produced it. Changing the sort direction, the filter, or (on a filtered read) the time range and reusing an older cursor returns a 400 rather than a page of skipped or repeated records, so start again without a cursor after any of those change.",
+      "`start_at` and `end_at` narrow a filtered read only. An unfiltered read returns the view's records regardless of the window, so pass a facet filter when you need a time-bounded result.",
+      "A cursor stays valid while Tailglow reorganizes stored data in the background, so a paging client is never interrupted by storage maintenance. It is a position in this result set, not a snapshot: records that arrive while you page appear only if they sort after your position.",
+      "`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": [],
+    "body_fields": []
+  },
+  {
+    "resource": "views",
+    "command": "list-deferrals",
+    "operation_id": "listViewDeferrals",
+    "summary": "List Waiting Shapes",
+    "description": "Retrieve the event shapes a view has deferred because no transform serves them yet.",
+    "method": "GET",
+    "path": "/v1/projects/:project_id/views/:view_id/deferrals",
+    "alternate_paths": [],
+    "scopes": [
+      "views:read"
+    ],
+    "notes": [
+      "Deferred records are stored, not lost. They backfill automatically once a script covers the shape, and each entry's `reason` says what unblocks it.",
+      "`event_count` is approximate: ingest retries can count an event more than once.",
+      "`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": "resolved",
+        "type": "string",
+        "required": false,
+        "description": "Filter by resolution. `false` returns only shapes still waiting. Optional.",
+        "allowed_values": [
+          "true",
+          "false"
+        ],
+        "deprecated": null
+      },
+      {
+        "name": "order_by",
+        "type": "string",
+        "required": false,
+        "description": "Sort field. Defaults to `last_deferred_at`. Optional.",
+        "allowed_values": [
+          "first_deferred_at",
+          "last_deferred_at"
+        ],
+        "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": "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": "view_id",
+        "name": "deferral_id",
         "type": "string",
         "required": true,
-        "description": "Unique identifier of the view.",
+        "description": "Unique identifier of the deferral.",
         "allowed_values": [],
         "deprecated": null
       }
@@ -1938,23 +2473,20 @@ export const CLI_COMMANDS = [
   },
   {
     "resource": "views",
-    "command": "list-records",
-    "operation_id": "listViewRecords",
-    "summary": "List View Records",
-    "description": "Retrieve the transformed records a view has produced.",
-    "method": "GET",
-    "path": "/v1/projects/:project_id/views/:view_id/records",
+    "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:read"
+      "views:write"
     ],
     "notes": [
-      "Records are only filterable on fields that have a facet. Filtering on any other field is rejected, so create a facet for a field before querying it.",
-      "Paging is forward-only. Pass `pagination.next_cursor` back as `after` to get the next page; a null `next_cursor` means there is nothing more to read. No `prev_cursor` is issued, and `before` is ignored.",
-      "A cursor is only valid for the query that produced it. Changing the sort direction, the filter, or (on a filtered read) the time range and reusing an older cursor returns a 400 rather than a page of skipped or repeated records, so start again without a cursor after any of those change.",
-      "`start_at` and `end_at` narrow a filtered read only. An unfiltered read returns the view's records regardless of the window, so pass a facet filter when you need a time-bounded result.",
-      "A cursor stays valid while Tailglow reorganizes stored data in the background, so a paging client is never interrupted by storage maintenance. It is a position in this result set, not a snapshot: records that arrive while you page appear only if they sort after your position.",
-      "`after` and `before` are mutually exclusive."
+      "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": [
       {
@@ -1972,26 +2504,101 @@ export const CLI_COMMANDS = [
         "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": []
+    "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-deferrals",
-    "operation_id": "listViewDeferrals",
-    "summary": "List Waiting Shapes",
-    "description": "Retrieve the event shapes a view has deferred because no transform serves them yet.",
+    "command": "list-transforms",
+    "operation_id": "listViewTransforms",
+    "summary": "List View Transforms",
+    "description": "Retrieve a list of a view's transforms.",
     "method": "GET",
-    "path": "/v1/projects/:project_id/views/:view_id/deferrals",
+    "path": "/v1/projects/:project_id/views/:view_id/transforms",
     "alternate_paths": [],
     "scopes": [
       "views:read"
     ],
     "notes": [
-      "Deferred records are stored, not lost. They backfill automatically once a script covers the shape, and each entry's `reason` says what unblocks it.",
-      "`event_count` is approximate: ingest retries can count an event more than once.",
       "`after` and `before` are mutually exclusive."
     ],
     "path_params": [
@@ -2014,24 +2621,27 @@ export const CLI_COMMANDS = [
     ],
     "query_params": [
       {
-        "name": "resolved",
+        "name": "order_by",
         "type": "string",
         "required": false,
-        "description": "Filter by resolution. `false` returns only shapes still waiting. Optional.",
+        "description": "Field the results are sorted by. Creation order matches schema version order. Optional. Defaults to `\"created_at\"`.",
         "allowed_values": [
-          "true",
-          "false"
+          "created_at",
+          "updated_at"
         ],
         "deprecated": null
       },
       {
-        "name": "order_by",
-        "type": "string",
+        "name": "status",
+        "type": "ViewTransformStatus",
         "required": false,
-        "description": "Sort field. Defaults to `last_deferred_at`. Optional.",
+        "description": "Return only transforms in this state. Optional.",
         "allowed_values": [
-          "first_deferred_at",
-          "last_deferred_at"
+          "queued",
+          "analyzing",
+          "active",
+          "error",
+          "draft"
         ],
         "deprecated": null
       },
@@ -2039,7 +2649,7 @@ export const CLI_COMMANDS = [
         "name": "limit",
         "type": "number",
         "required": false,
-        "description": "Maximum number of items to return. Optional. Defaults to `25`. Minimum: `1`. Maximum: `200`.",
+        "description": "Optional. Defaults to `25`. Minimum: `1`. Maximum: `200`.",
         "allowed_values": [],
         "deprecated": null
       },
@@ -2063,7 +2673,7 @@ export const CLI_COMMANDS = [
         "name": "sort",
         "type": "string",
         "required": false,
-        "description": "Sort direction for the result set. Optional. Defaults to `\"desc\"`.",
+        "description": "Optional. Defaults to `\"asc\"`.",
         "allowed_values": [
           "asc",
           "desc"
@@ -2075,17 +2685,61 @@ export const CLI_COMMANDS = [
   },
   {
     "resource": "views",
-    "command": "list-transforms",
-    "operation_id": "listViewTransforms",
-    "summary": "List View Transforms",
-    "description": "Retrieve a list of a view's transforms.",
+    "command": "retrieve-transform",
+    "operation_id": "getViewTransform",
+    "summary": "Retrieve View Transform",
+    "description": "Retrieve a single transform.",
     "method": "GET",
-    "path": "/v1/projects/:project_id/views/:view_id/transforms",
+    "path": "/v1/projects/:project_id/views/:view_id/transforms/:transform_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": "transform_id",
+        "type": "string",
+        "required": true,
+        "description": "Unique identifier of the transform.",
+        "allowed_values": [],
+        "deprecated": null
+      }
+    ],
+    "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": [
@@ -2111,10 +2765,9 @@ export const CLI_COMMANDS = [
         "name": "order_by",
         "type": "string",
         "required": false,
-        "description": "Field the results are sorted by. Creation order matches schema version order. Optional. Defaults to `\"created_at\"`.",
+        "description": "Field the results are sorted by. Optional. Defaults to `\"version\"`.",
         "allowed_values": [
-          "created_at",
-          "updated_at"
+          "version"
         ],
         "deprecated": null
       },
@@ -2122,7 +2775,7 @@ export const CLI_COMMANDS = [
         "name": "status",
         "type": "ViewTransformStatus",
         "required": false,
-        "description": "Return only transforms in this state. Optional.",
+        "description": "Return only versions whose transform is in this state. Optional.",
         "allowed_values": [
           "queued",
           "analyzing",
@@ -2132,11 +2785,19 @@ export const CLI_COMMANDS = [
         ],
         "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": "Optional. Defaults to `25`. Minimum: `1`. Maximum: `200`.",
+        "description": "Maximum number of items to return. Optional. Defaults to `25`. Minimum: `1`. Maximum: `200`.",
         "allowed_values": [],
         "deprecated": null
       },
@@ -2160,7 +2821,7 @@ export const CLI_COMMANDS = [
         "name": "sort",
         "type": "string",
         "required": false,
-        "description": "Optional. Defaults to `\"asc\"`.",
+        "description": "Sort direction for the result set. Optional. Defaults to `\"desc\"`.",
         "allowed_values": [
           "asc",
           "desc"
@@ -2172,17 +2833,19 @@ export const CLI_COMMANDS = [
   },
   {
     "resource": "views",
-    "command": "retrieve-transform",
-    "operation_id": "getViewTransform",
-    "summary": "Retrieve View Transform",
-    "description": "Retrieve a single transform.",
+    "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/transforms/:transform_id",
+    "path": "/v1/projects/:project_id/views/:view_id/versions/:version_id",
     "alternate_paths": [],
     "scopes": [
       "views:read"
     ],
-    "notes": [],
+    "notes": [
+      "`version_id` is the schema version NUMBER, the `version` a row carries, not a `vta_` id."
+    ],
     "path_params": [
       {
         "name": "project_id",
@@ -2201,10 +2864,10 @@ export const CLI_COMMANDS = [
         "deprecated": null
       },
       {
-        "name": "transform_id",
+        "name": "version_id",
         "type": "string",
         "required": true,
-        "description": "Unique identifier of the transform.",
+        "description": "Unique identifier of the version.",
         "allowed_values": [],
         "deprecated": null
       }
@@ -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."
@@ -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": [
       {
@@ -2871,6 +3556,14 @@ export const CLI_COMMANDS = [
         "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
+      },
       {
         "name": "filters",
         "type": "string",
@@ -4949,6 +5642,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 +5791,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 +6390,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 +7210,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 +8255,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 +8406,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 +9789,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."
     ],