@tailglow/cli 0.5.0 → 0.5.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tailglow/cli",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "type": "module",
   "description": "The Tailglow command line. Every command is generated from the Tailglow API reference, so the CLI and the documentation can never describe different APIs.",
   "bin": {

package/src/commands.generated.js

@@ -463,6 +463,97 @@ export const CLI_COMMANDS = [
     "query_params": [],
     "body_fields": []
   },
+  {
+    "resource": "projects",
+    "command": "usage",
+    "operation_id": "getProjectUsage",
+    "summary": "Retrieve Project Usage",
+    "description": "Retrieve how much the project stored over a time range.",
+    "method": "GET",
+    "path": "/v1/projects/:project_id/usage",
+    "alternate_paths": [],
+    "scopes": [
+      "projects:read"
+    ],
+    "notes": [
+      "Readings are taken hourly and are the same measurements the project is billed on. Gigabytes are logical (uncompressed) bytes.",
+      "`interval=day` returns the last reading of each UTC day rather than an average, so a row is what the project held when the day closed. Its `sampled_at` is that reading's own hour.",
+      "Readings start when Tailglow began recording them, so a range reaching further back returns nothing for the hours before that.",
+      "`start_at` must be earlier than `end_at`, and the range cannot be longer than 400 days."
+    ],
+    "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": true,
+        "description": "Start of the range, inclusive (ISO format).",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "end_at",
+        "type": "ISODateString",
+        "required": false,
+        "description": "End of the range, inclusive (ISO format, default: now). Optional.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "interval",
+        "type": "string",
+        "required": false,
+        "description": "Reading cadence returned: every hourly reading, or one reading per UTC day. Optional. Defaults to `\"hour\"`.",
+        "allowed_values": [
+          "hour",
+          "day"
+        ],
+        "deprecated": null
+      }
+    ],
+    "body_fields": []
+  },
+  {
+    "resource": "projects",
+    "command": "attention",
+    "operation_id": "getProjectAttention",
+    "summary": "Retrieve Project Attention",
+    "description": "Retrieve everything in the project that is asking for a human right now.",
+    "method": "GET",
+    "path": "/v1/projects/:project_id/attention",
+    "alternate_paths": [],
+    "scopes": [
+      "projects:read"
+    ],
+    "notes": [
+      "An item appears only when Tailglow entered a state on its own. Anything a project chose, such as a paused pull, a paused drain, or a paused monitor, is never reported here.",
+      "`tier` orders the list. `losing_data` means requests are being refused right now, within the last 5 minutes: for a reason a retry cannot fix, or for capacity after at least 5 minutes of unbroken refusals. `firing` means a monitor or check the project set up is currently triggered, or a server has run under sustained heavy load. `stalled` means a pipeline stopped making progress and its data is going stale. `suspended` means Tailglow switched something off and it stays off until it is fixed. `resolved` means refusals that lost data have stopped; `ended_at` says when.",
+      "Items disappear the moment their condition clears, with one exception so a loss is not missed: refusals that stop stay as `resolved`, for up to 24 hours for a key or payload refusal and up to an hour for capacity. A refusal item's `count` covers that whole window, not only the current spell. Refusals only count as stopped once every running server that was refusing has reported since; until then the item stays `losing_data`. Readings from the project's servers are cached briefly, so a condition that just started can take up to a minute to appear.",
+      "Items cover only resources the caller's key or role can read: without a resource's read permission, its conditions are left out. Refusal and server load items need `servers:read`, and firing monitors need `alerts:read`.",
+      "Items are already ranked, most urgent first. One item covers each firing monitor, and each view's failing transforms, joins, or shape waits. The response is capped per condition so a project in a bad state returns a readable list rather than every affected resource."
+    ],
+    "path_params": [
+      {
+        "name": "project_id",
+        "type": "string",
+        "required": true,
+        "description": "Unique identifier of the project.",
+        "allowed_values": [],
+        "deprecated": null
+      }
+    ],
+    "query_params": [],
+    "body_fields": []
+  },
   {
     "resource": "sources",
     "command": "list",
@@ -6749,6 +6840,7 @@ export const CLI_COMMANDS = [
       "At least one field must be provided.",
       "Only team Owners can change billing, security, or account settings. Other members can update `name` and `logo_url` only.",
       "`status`, `max_servers_per_project`, and `deleted_at` are managed by Tailglow and cannot be set by team members.",
+      "`status` requires `expected_status`, the status you loaded; the change is refused with a conflict if the team's status has changed since.",
       "Changing `is_mfa_required` requires a recently verified multi-factor sign-in.",
       "Moving to a plan that bills a payment method requires a valid payment method on the team.",
       "`billing_email` cannot use the `@tailglow.io` domain.",
@@ -6806,6 +6898,19 @@ export const CLI_COMMANDS = [
         ],
         "deprecated": null
       },
+      {
+        "name": "expected_status",
+        "type": "TeamStatus",
+        "required": false,
+        "description": "The status the team had when you loaded it. Required with `status`; the change is refused if the status has changed since. Optional.",
+        "allowed_values": [
+          "active",
+          "restricted",
+          "delinquent",
+          "blocked"
+        ],
+        "deprecated": null
+      },
       {
         "name": "is_mfa_required",
         "type": "boolean",
@@ -10374,7 +10479,8 @@ export const CLI_COMMANDS = [
     "alternate_paths": [],
     "scopes": [],
     "notes": [
-      "You can retrieve your own authentication logs without `logs:read`. All other log reads require `logs:read`.",
+      "You can retrieve your own authentication logs without `logs:read`. Billing logs require `billing:read`; all other log reads require `logs:read`.",
+      "Without `type`, the list includes every type you can read. `admin_auth` logs exist only on Tailglow's own admin team.",
       "`after` and `before` are mutually exclusive."
     ],
     "path_params": [],
@@ -10429,7 +10535,8 @@ export const CLI_COMMANDS = [
         "allowed_values": [
           "auth",
           "admin_auth",
-          "audit"
+          "audit",
+          "billing"
         ],
         "deprecated": null
       },