@tailglow/cli 0.9.6 → 0.9.16

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tailglow/cli",
-  "version": "0.9.6",
+  "version": "0.9.16",
   "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": {
@@ -35,6 +35,6 @@
     "@clack/prompts": "^1.2.0"
   },
   "devDependencies": {
-    "@types/bun": "^1.4.3"
+    "@types/bun": "^1.4.4"
   }
 }

package/src/commands.generated.js

@@ -278,7 +278,7 @@ export const CLI_COMMANDS = [
         "name": "late_data_window_minutes",
         "type": "integer",
         "required": false,
-        "description": "How many minutes behind the completeness watermark an event with an overridden timestamp may arrive and still be included automatically. Later data is recorded and surfaced for manual re-backfill instead of being included. 0 means the watermark is final as it advances. Only events with overridden timestamps can be late; data sent live is never affected. Maximum 129600 (90 days). Optional. Minimum: `0`. Maximum: `129600`.",
+        "description": "Late-arrival window for older metrics that have not been rebuilt. New and rebuilt metrics automatically include accepted late input at any age. For older metrics, events outside this window are kept for manual re-backfill; 0 holds all late arrivals. Maximum 129600 (90 days). Optional. Minimum: `0`. Maximum: `129600`.",
         "allowed_values": [],
         "deprecated": null
       },
@@ -2157,6 +2157,14 @@ export const CLI_COMMANDS = [
           }
         ]
       },
+      {
+        "name": "display_fields",
+        "type": "object",
+        "required": false,
+        "description": "Which field labels which in charts: each key is a field of the view, its value the view field whose value names it, such as `{ \"user_id\": \"user_name\" }`. A key set to null is removed; on update, keys left out keep their value. Optional.",
+        "allowed_values": [],
+        "deprecated": null
+      },
       {
         "name": "project_id",
         "type": "string",
@@ -2296,6 +2304,7 @@ export const CLI_COMMANDS = [
     "notes": [
       "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.",
+      "`display_fields` changes only the keys it names: a key set to a field labels it, a key set to null is removed. Every field it names must be a field of the view; a stored entry whose field the view has since dropped is kept, labels nothing, and never blocks another change.",
       "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."
@@ -2419,6 +2428,14 @@ export const CLI_COMMANDS = [
         "allowed_values": [],
         "deprecated": null
       },
+      {
+        "name": "display_fields",
+        "type": "object",
+        "required": false,
+        "description": "Which field labels which in charts: each key is a field of the view, its value the view field whose value names it, such as `{ \"user_id\": \"user_name\" }`. A key set to null is removed; on update, keys left out keep their value. Optional.",
+        "allowed_values": [],
+        "deprecated": null
+      },
       {
         "name": "transform_mode",
         "type": "string",
@@ -2463,7 +2480,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 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."
+      "Backfill work for the whole cascade is cancelled immediately, so a deleted view stops consuming capacity before its rows are removed."
     ],
     "path_params": [
       {
@@ -3225,6 +3242,71 @@ export const CLI_COMMANDS = [
     "query_params": [],
     "body_fields": []
   },
+  {
+    "resource": "views",
+    "command": "update-version",
+    "operation_id": "updateViewVersion",
+    "summary": "Update View Version",
+    "description": "Exclude one settled schema version from a view.",
+    "method": "POST",
+    "path": "/v1/projects/:project_id/views/:view_id/versions/:version_id",
+    "alternate_paths": [],
+    "scopes": [
+      "views:write"
+    ],
+    "notes": [
+      "`version_id` is the schema version NUMBER, the `version` a row carries, not a `vta_` id.",
+      "An excluded version's records are left out of this view, those already ingested and those still to come, and the version no longer holds the view back from being ready for metrics. Other views reading the same collection are not affected.",
+      "Only a version still waiting on a script can be excluded. A version whose transform holds a script, or is already excluded, answers 409.",
+      "An exclusion is not undone here: `is_excluded: false` answers 400.",
+      "Excluding a version requires `exclusion_reason`."
+    ],
+    "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": "integer",
+        "required": true,
+        "description": "The schema version number: the `version` a view version carries.",
+        "allowed_values": [],
+        "deprecated": null
+      }
+    ],
+    "query_params": [],
+    "body_fields": [
+      {
+        "name": "is_excluded",
+        "type": "boolean",
+        "required": true,
+        "description": "Set to true to exclude this schema version from the view: its records are left out of the view, now and in the future.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "exclusion_reason",
+        "type": "string",
+        "required": false,
+        "description": "Why the version is excluded, kept with the exclusion for whoever reads it later. Optional. Minimum length: `1`. Maximum length: `2000`.",
+        "allowed_values": [],
+        "deprecated": null
+      }
+    ]
+  },
   {
     "resource": "views",
     "command": "create-transform",
@@ -3738,10 +3820,13 @@ export const CLI_COMMANDS = [
       "`complete_through_at` is the instant before which every number is final. Null means completeness is unknown, and then every bucket is incomplete.",
       "For complete buckets only, leave out every key at or after `first_incomplete_bucket_at`.",
       "`coverage_reasons` names unresolved view scopes; `excluded` is informational.",
-      "Series are ranked by their total over the range (the count for a `count` metric, the sum of Last readings for `last`, the sum otherwise), ties broken by series hash, and `limit` of them come back per page, the metric's `ui_chart_max_series` by default. Walk the pages with `pagination.next_cursor` and `pagination.prev_cursor`; `pagination.total` counts every series.",
-      "`__other__` folds in every series that is not on the current page, so the page plus Other always adds up to the range total and a share is right on every page.",
-      "When the metric has pinned series, they make up the whole first page and later pages walk the other series by rank.",
-      "`series` returns exactly the listed series on one page, unranked and without `__other__`.",
+      "Series are ranked by their total over the range (the count for a `count` metric, the sum of Last readings for `last`, the sum otherwise), ties broken by series hash, and `limit` of them come back per page, the metric's `ui_chart_max_series` by default, in rank order. Walk the pages with `pagination.next_cursor` and `pagination.prev_cursor`; `pagination.total` counts every series with data in the range.",
+      "Only series with data in the range come back. Without a `series` filter, when none has any, a metric whose `empty_bucket_handling` is `zero` returns one series of zeros labelled with the metric's name (hash `__default__`), unless `normalize` is false.",
+      "Without `sort`, series rank smallest first when the metric's `ui_chart_order` is `lowest` and largest first otherwise.",
+      "When the metric colors by series (`ui_chart_color_mode` is `by_series`), series that match one of its `ui_chart_series_rules` rank ahead of every other series, so they take the first page's places first, except on a `table` chart, which ranks all series together. Color a series by the first active rule it matches, and every other series gray once the metric has an active rule. In the other color modes rules color nothing and every series ranks together.",
+      "A read that shows a series value no color rule covers, on a field in the metric's `ai_color_fields`, asks for new default rules and AI color suggestions (`ai_colors_next_run_at`), at most once a day.",
+      "`__other__` folds in every series that is not on the current page, so the page plus Other always adds up to the range total and a share is right on every page. It comes last.",
+      "`series` returns the listed series that have data in the range, on one page, unranked and without `__other__`.",
       "A metric with a `time_dimension` returns its range folded instead of as a timeline: every hour merges into its hour of the day, weekday or hour of the week. Record keys are then the category as a decimal string (`\"0\"` to `\"23\"`, `\"1\"` for Monday to `\"7\"` for Sunday, `\"0\"` to `\"167\"`), every category is present whatever `normalize` says, and `time_dimension` echoes it.",
       "Data is stored by UTC hour. A fold places each hour in its category in the request `timezone` (echoed as `timezone`), one hour at a time, so a daylight saving change moves only the hours after it.",
       "A fold reads hourly data whatever `interval` says, covers at most 400 days (a longer range is refused), and includes the current hour's data so far.",
@@ -3901,7 +3986,7 @@ export const CLI_COMMANDS = [
         "name": "sort",
         "type": "string",
         "required": false,
-        "description": "Ranking direction of the series. `desc` returns the largest first. Optional. Defaults to `\"desc\"`.",
+        "description": "Ranking direction of the series. `desc` returns the largest first. Defaults to the metric's `ui_chart_order`: `asc` for `lowest`, `desc` otherwise. Optional.",
         "allowed_values": [
           "asc",
           "desc"
@@ -3927,15 +4012,16 @@ export const CLI_COMMANDS = [
       "`view_id` is required when creating a metric.",
       "Field references and filters must be compatible with the selected view.",
       "Custom chart ranges require both dates, with an interval of at least 30 minutes.",
-      "Color-mode configuration must match the selected chart color mode.",
+      "`ui_chart_color_base` is required in `by_intensity` mode and refused in `by_value` mode. In `by_series` mode it is optional and colors a metric without `group_by`.",
+      "`ui_chart_color_rules` needs at least one rule in `by_value` mode and is refused in the other modes.",
       "`ui_chart_color_mode` must be a mode the chart type supports. A metric created without a `ui_chart_type` is a `bar` chart and is checked as one.",
       "`time_dimension` must be one the chart type supports: `breakdown` takes `hour_of_day` or `weekday`, `heatmap` takes `hour_of_week`, `hour_of_day` or `weekday`, and every other chart type takes none.",
       "A `heatmap` chart requires a `time_dimension`.",
       "A `time_dimension` cannot be combined with a cumulative `ui_chart_value` (`cumulative_sum` or `cumulative_count`).",
-      "`ui_chart_order` is read by `breakdown` charts only; other chart types ignore it.",
       "`filters` must be a valid filter expression.",
       "`timestamp_field` cannot reference `__meta__` metadata.",
-      "`group_by_display_fields` is set at create and cannot be changed afterwards, because each series takes its label from the first record it sees. Map a `group_by` field to a view field that carries a readable value for the same record."
+      "`ui_chart_series_rules` holds at most 20 rules that are not dismissed, and each rule's `field` must be a field of the view.",
+      "A metric created with `group_by` and without `ui_chart_series_rules` gets default rules for the errors, warnings and successes its first series show, marked `is_default`, and then asks the AI for color rules, which arrive marked `is_suggested` and may replace the defaults of their field. A team with Tailglow AI off gets the defaults only."
     ],
     "path_params": [
       {
@@ -3973,14 +4059,6 @@ 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",
@@ -4073,7 +4151,7 @@ export const CLI_COMMANDS = [
         "name": "ui_chart_color_base",
         "type": "ChartColor",
         "required": false,
-        "description": "Base color used by intensity mode. Optional.",
+        "description": "Base color used by intensity mode. In series mode, the color of a metric without `group_by`, which draws one series; null draws it blue. Optional.",
         "allowed_values": [
           "blue",
           "red",
@@ -4093,6 +4171,14 @@ export const CLI_COMMANDS = [
         "allowed_values": [],
         "deprecated": null
       },
+      {
+        "name": "ui_chart_series_rules",
+        "type": "object[] | null",
+        "required": false,
+        "description": "Colors for series by value, in order: a series takes the color of the first rule it matches, and once a rule is active every other series is gray. Rules color only a metric with `group_by`. Rules Tailglow adds from its default list (errors red, warnings amber, successes green) are marked `is_default`, and rules the AI suggests are marked `is_suggested`. Optional.",
+        "allowed_values": [],
+        "deprecated": null
+      },
       {
         "name": "ui_chart_show_alerts",
         "type": "boolean",
@@ -4271,11 +4357,13 @@ export const CLI_COMMANDS = [
       },
       {
         "name": "ui_chart_order",
-        "type": "ChartOrder",
+        "type": "string | null",
         "required": false,
-        "description": "Order a breakdown chart shows its groups in. Null keeps a time dimension in its natural order and ranks field groups by value. Optional.",
+        "description": "Order the chart shows its series in: `highest` largest first, `lowest` smallest first, `natural` largest first with a time dimension kept in its own order (hour 0 to 23, Monday to Sunday). Null is `natural`, and `value` is read as `highest`. Optional.",
         "allowed_values": [
           "natural",
+          "highest",
+          "lowest",
           "value"
         ],
         "deprecated": null
@@ -4333,14 +4421,16 @@ export const CLI_COMMANDS = [
       "Field references and filters must be compatible with the selected view.",
       "Changing the metric's data feed rebuilds its historical rollups.",
       "Custom chart ranges require both dates, with an interval of at least 30 minutes.",
-      "Color-mode configuration must match the selected chart color mode.",
+      "`ui_chart_color_base` is required in `by_intensity` mode and refused in `by_value` mode. In `by_series` mode it is optional and colors a metric without `group_by`.",
+      "`ui_chart_color_rules` needs at least one rule in `by_value` mode and is refused in the other modes.",
       "`ui_chart_color_mode` must be a mode the chart type supports. Changing `ui_chart_type` keeps the current mode, so send a supported one with it.",
       "`time_dimension` must be one the chart type supports: `breakdown` takes `hour_of_day` or `weekday`, `heatmap` takes `hour_of_week`, `hour_of_day` or `weekday`, and every other chart type takes none. Send `time_dimension: null` when changing to a type that takes none.",
       "A `heatmap` chart requires a `time_dimension`.",
       "A `time_dimension` cannot be combined with a cumulative `ui_chart_value` (`cumulative_sum` or `cumulative_count`).",
-      "`ui_chart_order` is read by `breakdown` charts only; other chart types ignore it.",
       "`filters` must be a valid filter expression.",
-      "`timestamp_field` cannot reference `__meta__` metadata."
+      "`timestamp_field` cannot reference `__meta__` metadata.",
+      "`ui_chart_series_rules` holds at most 20 rules that are not dismissed. A rule you add must name a field of the view; a saved rule whose field the view has since dropped is kept and matches nothing.",
+      "Saving `ui_chart_series_rules` replaces your own rules. A suggestion or default you leave out is dismissed, and never added again, only when you also send `seen_suggestions_at` no older than its `suggested_at`; one added after the rules you loaded stays. A suggestion or default you change becomes your own rule."
     ],
     "path_params": [
       {
@@ -4478,7 +4568,7 @@ export const CLI_COMMANDS = [
         "name": "ui_chart_color_base",
         "type": "ChartColor",
         "required": false,
-        "description": "Base color used by intensity mode. Optional.",
+        "description": "Base color used by intensity mode. In series mode, the color of a metric without `group_by`, which draws one series; null draws it blue. Optional.",
         "allowed_values": [
           "blue",
           "red",
@@ -4498,6 +4588,22 @@ export const CLI_COMMANDS = [
         "allowed_values": [],
         "deprecated": null
       },
+      {
+        "name": "ui_chart_series_rules",
+        "type": "object[] | null",
+        "required": false,
+        "description": "Colors for series by value, in order: a series takes the color of the first rule it matches, and once a rule is active every other series is gray. Rules color only a metric with `group_by`. Rules Tailglow adds from its default list (errors red, warnings amber, successes green) are marked `is_default`, and rules the AI suggests are marked `is_suggested`. Optional.",
+        "allowed_values": [],
+        "deprecated": null
+      },
+      {
+        "name": "seen_suggestions_at",
+        "type": "ISODateString",
+        "required": false,
+        "description": "The newest `suggested_at` among the rules you loaded. A suggestion or default left out of `ui_chart_series_rules` is dismissed only when it is no newer than this; without it, nothing is dismissed. Optional.",
+        "allowed_values": [],
+        "deprecated": null
+      },
       {
         "name": "ui_chart_show_alerts",
         "type": "boolean",
@@ -4676,11 +4782,13 @@ export const CLI_COMMANDS = [
       },
       {
         "name": "ui_chart_order",
-        "type": "ChartOrder",
+        "type": "string | null",
         "required": false,
-        "description": "Order a breakdown chart shows its groups in. Null keeps a time dimension in its natural order and ranks field groups by value. Optional.",
+        "description": "Order the chart shows its series in: `highest` largest first, `lowest` smallest first, `natural` largest first with a time dimension kept in its own order (hour 0 to 23, Monday to Sunday). Null is `natural`, and `value` is read as `highest`. Optional.",
         "allowed_values": [
           "natural",
+          "highest",
+          "lowest",
           "value"
         ],
         "deprecated": null
@@ -4851,6 +4959,7 @@ export const CLI_COMMANDS = [
       "metrics:read"
     ],
     "notes": [
+      "Each series is labeled by its view's `display_fields`: per field in `group_by`, the value the series carries for its display field, else the raw value.",
       "`after` and `before` are mutually exclusive."
     ],
     "path_params": [
@@ -4922,90 +5031,13 @@ export const CLI_COMMANDS = [
         "name": "search",
         "type": "string",
         "required": false,
-        "description": "Substring matched against labels, hashes, and dimension values. Optional. Minimum length: `1`. Maximum length: `128`.",
+        "description": "Substring matched against hashes, dimension values and carried field values. Optional. Minimum length: `1`. Maximum length: `128`.",
         "allowed_values": [],
         "deprecated": null
       }
     ],
     "body_fields": []
   },
-  {
-    "resource": "metrics",
-    "command": "update-series",
-    "operation_id": "updateMetricSeries",
-    "summary": "Update Metric Series",
-    "description": "Update the appearance overrides for one metric series.",
-    "method": "POST",
-    "path": "/v1/projects/:project_id/metrics/:metric_id/series/:series_id",
-    "alternate_paths": [],
-    "scopes": [
-      "metrics:write"
-    ],
-    "notes": [
-      "At least one of `color`, `pinned`, or `display_label` must be provided."
-    ],
-    "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
-      },
-      {
-        "name": "series_id",
-        "type": "string",
-        "required": true,
-        "description": "Unique identifier of the sery.",
-        "allowed_values": [],
-        "deprecated": null
-      }
-    ],
-    "query_params": [],
-    "body_fields": [
-      {
-        "name": "color",
-        "type": "ChartColor",
-        "required": false,
-        "description": "Color override; null restores automatic color selection. Optional.",
-        "allowed_values": [
-          "blue",
-          "red",
-          "amber",
-          "green",
-          "teal",
-          "purple",
-          "pink"
-        ],
-        "deprecated": null
-      },
-      {
-        "name": "pinned",
-        "type": "boolean",
-        "required": false,
-        "description": "Whether the series is pinned ahead of ranked series. Optional.",
-        "allowed_values": [],
-        "deprecated": null
-      },
-      {
-        "name": "display_label",
-        "type": "string | null",
-        "required": false,
-        "description": "Display label override; null restores the derived label. Optional.",
-        "allowed_values": [],
-        "deprecated": null
-      }
-    ]
-  },
   {
     "resource": "monitors",
     "command": "list",
@@ -8257,7 +8289,7 @@ export const CLI_COMMANDS = [
         "deprecated": null
       },
       {
-        "name": "default_ai_model",
+        "name": "ai_default_model",
         "type": "AiChatSelection",
         "required": false,
         "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.",
@@ -8276,7 +8308,7 @@ export const CLI_COMMANDS = [
         "deprecated": null
       },
       {
-        "name": "default_ai_effort",
+        "name": "ai_default_effort",
         "type": "AiEffortLevel",
         "required": false,
         "description": "How hard the assistant is asked to work on each turn by default. Optional.",
@@ -8912,7 +8944,7 @@ export const CLI_COMMANDS = [
         "description": "Field used to order the domains. Optional. Defaults to `\"created_at\"`.",
         "allowed_values": [
           "created_at",
-          "domain",
+          "hostname",
           "certificate_status"
         ],
         "deprecated": null
@@ -9021,17 +9053,17 @@ export const CLI_COMMANDS = [
       "The number of custom domains a team can add is limited by its billing plan.",
       "A hostname can only be registered once. Adding one that already exists returns a conflict.",
       "Some hostnames are reserved and cannot be added.",
-      "`domain` cannot contain a wildcard (`*`). Add each hostname you want to serve as its own domain.",
-      "`domain` must be a valid hostname such as `analytics.example.com`. Labels may contain letters, digits and hyphens, cannot start or end with a hyphen, and the top level domain must be at least two letters."
+      "`hostname` cannot contain a wildcard (`*`). Add each hostname you want to serve as its own domain.",
+      "`hostname` must be a valid hostname such as `analytics.example.com`. Labels may contain letters, digits and hyphens, cannot start or end with a hyphen, and the top level domain must be at least two letters."
     ],
     "path_params": [],
     "query_params": [],
     "body_fields": [
       {
-        "name": "domain",
+        "name": "hostname",
         "type": "string",
         "required": true,
-        "description": "The custom domain to add, for example `analytics.example.com`. Stored in lowercase. Minimum length: `1`. Maximum length: `255`.",
+        "description": "The hostname to add, for example `analytics.example.com`. Stored in lowercase. Minimum length: `1`. Maximum length: `255`.",
         "allowed_values": [],
         "deprecated": null
       },
@@ -9868,14 +9900,6 @@ export const CLI_COMMANDS = [
         "allowed_values": [],
         "deprecated": null
       },
-      {
-        "name": "block_on_failure",
-        "type": "boolean",
-        "required": false,
-        "description": "Wait for acknowledgement before sending later deliveries. Defaults to false. Check block_on_failure in the response for availability; null means the setting is unavailable. Optional.",
-        "allowed_values": [],
-        "deprecated": null
-      },
       {
         "name": "exclude_fields",
         "type": "string[]",
@@ -9963,14 +9987,6 @@ export const CLI_COMMANDS = [
         ],
         "deprecated": null
       },
-      {
-        "name": "block_on_failure",
-        "type": "boolean",
-        "required": false,
-        "description": "Wait for acknowledgement before sending later deliveries. Defaults to false. Check block_on_failure in the response for availability; null means the setting is unavailable. Optional.",
-        "allowed_values": [],
-        "deprecated": null
-      },
       {
         "name": "exclude_fields",
         "type": "string[]",

package/src/config-command.js

@@ -79,12 +79,14 @@ export async function runConfigCommand(words, flags) {
   // `config set project prj_x --jsoon` writes the setting and silently drops the typo, and a
   // trailing word is ignored rather than questioned.
   const unknown = Object.keys(flags).filter((flag) => !RESERVED_FLAGS.has(flag));
+
   if (unknown.length > 0) {
     return fail(
       `Unknown flag${unknown.length === 1 ? "" : "s"}: ${unknown.map((flag) => `--${flag}`).join(", ")}.`,
       flags
     );
   }
+
   if (rest.length > 0) {
     return fail(`Unexpected argument${rest.length === 1 ? "" : "s"}: ${rest.join(", ")}.`, flags);
   }
@@ -115,6 +117,7 @@ export async function runConfigCommand(words, flags) {
     }
 
     const width = Math.max(...entries.map(([name]) => name.length));
+
     return {
       output: entries.map(([name, shown]) => `${name.padEnd(width)}  ${shown}`).join("\n"),
       code: 0
@@ -143,12 +146,15 @@ export async function runConfigCommand(words, flags) {
     }
 
     const current = (await loadConfig())[key];
+
     if (typeof current !== "string") return fail(`${key} is not set.`, flags);
+
     return succeed(current, { [key]: current }, flags);
   }
 
   if (action === "set") {
     if (!value) return fail(`Missing a value for ${key}.`, flags);
+
     const next = await updateConfig((stored) => ({ ...stored, [key]: value }));
 
     // A `tglow login` credential outranks a stored key, so setting one would otherwise look like it
@@ -157,6 +163,7 @@ export async function runConfigCommand(words, flags) {
     const note = outranked
       ? "\nYou are signed in with `tglow login`, which is used first. Run `tglow logout` to use this key."
       : "";
+
     return succeed(
       `Set ${key} to ${redactSetting(key, value)}.${note}`,
       { ok: true, key, value: redactSetting(key, value), outranked_by_login: outranked },