heroku 10.0.0-alpha.1 → 10.0.0-alpha.2

package/oclif.manifest.json

@@ -341,6 +341,7 @@
       "aliases": [],
       "args": {
         "email": {
+          "description": "email address of the team member",
           "name": "email",
           "required": true
         }
@@ -482,6 +483,7 @@
       "aliases": [],
       "args": {
         "email": {
+          "description": "email address of the team member",
           "name": "email",
           "required": true
         }
@@ -531,122 +533,125 @@
         "update.js"
       ]
     },
-    "addons:attach": {
+    "apps:create": {
       "aliases": [],
       "args": {
-        "addon_name": {
-          "name": "addon_name",
-          "required": true
+        "app": {
+          "description": "name of app to create",
+          "name": "app",
+          "required": false
         }
       },
-      "description": "attach an existing add-on resource to an app",
+      "description": "creates a new app",
+      "examples": [
+        "$ heroku apps:create\nCreating app... done, stack is heroku-24\nhttps://floating-dragon-42.heroku.com/ | https://git.heroku.com/floating-dragon-42.git\n\n# or just\n$ heroku create\n\n# use a heroku.yml manifest file\n$ heroku apps:create --manifest\n\n# specify a buildpack\n$ heroku apps:create --buildpack https://github.com/some/buildpack.git\n\n# specify a name\n$ heroku apps:create example\n\n# create a staging app\n$ heroku apps:create example-staging --remote staging\n\n# create an app in the eu region\n$ heroku apps:create --region eu"
+      ],
       "flags": {
-        "as": {
-          "description": "name for add-on attachment",
-          "name": "as",
+        "app": {
+          "hidden": true,
+          "name": "app",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "credential": {
-          "description": "credential name for scoped access to Heroku Postgres",
-          "name": "credential",
+        "addons": {
+          "description": "comma-delimited list of addons to install",
+          "name": "addons",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "confirm": {
-          "description": "overwrite existing add-on attachment with same name",
-          "name": "confirm",
+        "buildpack": {
+          "char": "b",
+          "description": "buildpack url to use for this app",
+          "name": "buildpack",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "app": {
-          "char": "a",
-          "description": "app to run command against",
-          "name": "app",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "manifest": {
+          "char": "m",
+          "description": "use heroku.yml settings for this app",
+          "hidden": true,
+          "name": "manifest",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "no-remote": {
+          "char": "n",
+          "description": "do not create a git remote",
+          "name": "no-remote",
+          "allowNo": false,
+          "type": "boolean"
         },
         "remote": {
           "char": "r",
-          "description": "git remote of app to use",
+          "description": "the git remote to create, default \"heroku\"",
           "name": "remote",
+          "default": "heroku",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "addons:attach",
-      "pluginAlias": "heroku",
-      "pluginName": "heroku",
-      "pluginType": "core",
-      "strict": true,
-      "topic": "addons",
-      "isESM": false,
-      "relativePath": [
-        "lib",
-        "commands",
-        "addons",
-        "attach.js"
-      ]
-    },
-    "addons:create": {
-      "aliases": [],
-      "args": {
-        "service:plan": {
-          "name": "service:plan",
-          "required": true
-        }
-      },
-      "description": "Create a new add-on resource.\n\nIn order to add additional config items, please place them at the end of the command after a double-dash (--).\n",
-      "examples": "Create an add-on resource:\n$heroku addons:create heroku-redis --app my-app\n\nCreate an add-on resource with additional config items:\n$heroku addons:create heroku-postgresql:standard-0 --app my-app -- --fork DATABASE\n",
-      "flags": {
-        "name": {
-          "description": "name for the add-on resource",
-          "name": "name",
+        },
+        "stack": {
+          "char": "s",
+          "description": "the stack to create the app on",
+          "name": "stack",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "as": {
-          "description": "name for the initial add-on attachment",
-          "name": "as",
+        "space": {
+          "description": "the private space to create the app in",
+          "name": "space",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "confirm": {
-          "description": "overwrite existing config vars or existing add-on attachments",
-          "name": "confirm",
+        "region": {
+          "description": "specify region for the app to run in",
+          "name": "region",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "wait": {
-          "description": "watch add-on creation status and exit when complete",
-          "name": "wait",
+        "internal-routing": {
+          "description": "private space-only. create as an Internal Web App that is only routable in the local network.",
+          "hidden": true,
+          "name": "internal-routing",
           "allowNo": false,
           "type": "boolean"
         },
-        "app": {
-          "char": "a",
-          "description": "app to run command against",
-          "name": "app",
-          "required": true,
+        "features": {
+          "hidden": true,
+          "name": "features",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "remote": {
-          "char": "r",
-          "description": "git remote of app to use",
-          "name": "remote",
+        "kernel": {
+          "hidden": true,
+          "name": "kernel",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "locked": {
+          "hidden": true,
+          "name": "locked",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "json": {
+          "description": "output in json format",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "team": {
+          "char": "t",
+          "description": "team to use",
+          "name": "team",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -654,56 +659,31 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [
-        "addons:add"
+        "create"
       ],
-      "id": "addons:create",
+      "id": "apps:create",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
-      "strict": false,
-      "topic": "addons",
-      "example": "Create an add-on resource:\n$heroku addons:create heroku-redis --app my-app\n\nCreate an add-on resource with additional config items:\n$heroku addons:create heroku-postgresql:standard-0 --app my-app -- --fork DATABASE\n",
+      "strict": true,
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "addons",
+        "apps",
         "create.js"
       ]
     },
-    "addons:destroy": {
+    "apps:destroy": {
       "aliases": [],
       "args": {
-        "addonName": {
-          "name": "addonName",
-          "required": true
+        "app": {
+          "hidden": true,
+          "name": "app"
         }
       },
-      "description": "permanently destroy an add-on resource",
-      "examples": [
-        "addons:destroy [ADDON]... [flags]"
-      ],
+      "description": "permanently destroy an app",
       "flags": {
-        "force": {
-          "char": "f",
-          "description": "allow destruction even if connected to other apps",
-          "name": "force",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "confirm": {
-          "char": "c",
-          "name": "confirm",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "wait": {
-          "description": "watch add-on destruction status and exit when complete",
-          "name": "wait",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "app": {
           "char": "a",
           "description": "app to run command against",
@@ -719,35 +699,38 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "confirm": {
+          "char": "c",
+          "name": "confirm",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [
-        "addons:remove"
+        "destroy",
+        "apps:delete"
       ],
-      "id": "addons:destroy",
+      "id": "apps:destroy",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
-      "strict": false,
-      "topic": "addons",
+      "strict": true,
+      "help": "This will also destroy all add-ons on the app.",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "addons",
+        "apps",
         "destroy.js"
       ]
     },
-    "addons:detach": {
+    "apps:errors": {
       "aliases": [],
-      "args": {
-        "attachment_name": {
-          "name": "attachment_name",
-          "required": true
-        }
-      },
-      "description": "detach an existing add-on resource from an app",
+      "args": {},
+      "description": "view app errors",
       "flags": {
         "app": {
           "char": "a",
@@ -765,40 +748,136 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "json": {
+          "description": "output in json format",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "hours": {
+          "description": "number of hours to look back (default 24)",
+          "name": "hours",
+          "default": "24",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "router": {
+          "description": "show only router errors",
+          "name": "router",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "dyno": {
+          "description": "show only dyno errors",
+          "name": "dyno",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "apps:errors",
+      "pluginAlias": "heroku",
+      "pluginName": "heroku",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": false,
+      "relativePath": [
+        "lib",
+        "commands",
+        "apps",
+        "errors.js"
+      ]
+    },
+    "apps": {
+      "aliases": [],
+      "args": {},
+      "description": "list your apps",
+      "examples": [
+        "$ heroku apps"
+      ],
+      "flags": {
+        "all": {
+          "char": "A",
+          "description": "include apps in all teams",
+          "name": "all",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "json": {
+          "char": "j",
+          "description": "output in json format",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "space": {
+          "char": "s",
+          "description": "filter by space",
+          "name": "space",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "personal": {
+          "char": "p",
+          "description": "list apps in personal account when a default team is set",
+          "name": "personal",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "internal-routing": {
+          "char": "i",
+          "description": "filter to Internal Web Apps",
+          "hidden": true,
+          "name": "internal-routing",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "team": {
+          "char": "t",
+          "description": "team to use",
+          "name": "team",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "addons:detach",
+      "hiddenAliases": [
+        "list",
+        "apps:list"
+      ],
+      "id": "apps",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "topic": "addons",
+      "topic": "apps",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "addons",
-        "detach.js"
+        "apps",
+        "index.js"
       ]
     },
-    "addons:docs": {
+    "apps:info": {
       "aliases": [],
       "args": {
-        "addon": {
-          "name": "addon",
-          "required": true
+        "app": {
+          "hidden": true,
+          "name": "app"
         }
       },
-      "description": "open an add-on's Dev Center documentation in your browser",
+      "description": "show detailed app information",
+      "examples": [
+        "$ heroku apps:info",
+        "$ heroku apps:info --shell"
+      ],
       "flags": {
-        "show-url": {
-          "description": "show URL, do not open browser",
-          "name": "show-url",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "app": {
           "char": "a",
           "description": "app to run command against",
@@ -814,50 +893,60 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "shell": {
+          "char": "s",
+          "description": "output more shell friendly key/value pairs",
+          "name": "shell",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "extended": {
+          "char": "x",
+          "hidden": true,
+          "name": "extended",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "json": {
+          "char": "j",
+          "description": "output in json format",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "addons:docs",
+      "hiddenAliases": [
+        "info"
+      ],
+      "id": "apps:info",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "topic": "addons",
+      "topic": "apps",
+      "help": "$ heroku apps:info\n=== example\nGit URL:   https://git.heroku.com/example.git\nRepo Size: 5M\n...\n\n$ heroku apps:info --shell\ngit_url=https://git.heroku.com/example.git\nrepo_size=5000000\n...",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "addons",
-        "docs.js"
+        "apps",
+        "info.js"
       ]
     },
-    "addons": {
-      "aliases": [],
-      "args": {},
-      "description": "Lists your add-ons and attachments.\n\n  The default filter applied depends on whether you are in a Heroku app\n  directory. If so, the --app flag is implied. If not, the default of --all\n  is implied. Explicitly providing either flag overrides the default\n  behavior.\n  ",
-      "examples": [
-        "$ heroku addons --all",
-        "$ heroku addons --app acme-inc-www"
+    "apps:join": {
+      "aliases": [
+        "join"
       ],
+      "args": {},
+      "description": "add yourself to a team app",
       "flags": {
-        "all": {
-          "char": "A",
-          "description": "show add-ons and attachments for all accessible apps",
-          "name": "all",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "json": {
-          "description": "return add-ons in json format",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "app": {
           "char": "a",
           "description": "app to run command against",
           "name": "app",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -873,35 +962,33 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "addons",
+      "id": "apps:join",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "usage": "addons [--all|--app APP]",
-      "topic": "addons",
+      "topic": "apps",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "addons",
-        "index.js"
+        "apps",
+        "join.js"
       ]
     },
-    "addons:info": {
-      "aliases": [],
-      "args": {
-        "addon": {
-          "name": "addon",
-          "required": true
-        }
-      },
-      "description": "show detailed add-on resource and attachment information",
+    "apps:leave": {
+      "aliases": [
+        "leave"
+      ],
+      "args": {},
+      "description": "remove yourself from a team app",
+      "examples": "heroku apps:leave -a APP",
       "flags": {
         "app": {
           "char": "a",
           "description": "app to run command against",
           "name": "app",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -917,41 +1004,33 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "addons:info",
+      "id": "apps:leave",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "usage": "addons:info ADDON",
-      "topic": "addons",
+      "topic": "apps",
+      "example": "heroku apps:leave -a APP",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "addons",
-        "info.js"
+        "apps",
+        "leave.js"
       ]
     },
-    "addons:open": {
-      "aliases": [],
-      "args": {
-        "addon": {
-          "name": "addon",
-          "required": true
-        }
-      },
-      "description": "open an add-on's dashboard in your browser",
+    "apps:lock": {
+      "aliases": [
+        "lock"
+      ],
+      "args": {},
+      "description": "prevent team members from joining an app",
       "flags": {
-        "show-url": {
-          "description": "show URL, do not open browser",
-          "name": "show-url",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "app": {
           "char": "a",
           "description": "app to run command against",
           "name": "app",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -967,133 +1046,90 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "addons:open",
+      "id": "apps:lock",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "topic": "addons",
+      "topic": "apps",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "addons",
-        "open.js"
+        "apps",
+        "lock.js"
       ]
     },
-    "addons:plans": {
+    "apps:open": {
       "aliases": [],
       "args": {
-        "service": {
-          "name": "service",
-          "required": true
+        "path": {
+          "description": "base URL path of app",
+          "name": "path",
+          "required": false
         }
       },
-      "description": "list all available plans for an add-on service",
+      "description": "open the app in a web browser",
+      "examples": [
+        "$ heroku open -a myapp",
+        "$ heroku open -a myapp /foo"
+      ],
       "flags": {
-        "json": {
-          "description": "output in json format",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "addons:plans",
-      "pluginAlias": "heroku",
-      "pluginName": "heroku",
-      "pluginType": "core",
-      "strict": true,
-      "topic": "addons",
-      "isESM": false,
-      "relativePath": [
-        "lib",
-        "commands",
-        "addons",
-        "plans.js"
-      ]
-    },
-    "addons:rename": {
-      "aliases": [],
-      "args": {
-        "addon_name": {
-          "name": "addon_name",
-          "required": true
+        "app": {
+          "char": "a",
+          "description": "app to run command against",
+          "name": "app",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "new_name": {
-          "name": "new_name",
-          "required": true
-        }
-      },
-      "description": "rename an add-on",
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "addons:rename",
-      "pluginAlias": "heroku",
-      "pluginName": "heroku",
-      "pluginType": "core",
-      "strict": true,
-      "topic": "addons",
-      "isESM": false,
-      "relativePath": [
-        "lib",
-        "commands",
-        "addons",
-        "rename.js"
-      ]
-    },
-    "addons:services": {
-      "aliases": [],
-      "args": {},
-      "description": "list all available add-on services",
-      "flags": {
-        "json": {
-          "description": "output in json format",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
+        "remote": {
+          "char": "r",
+          "description": "git remote of app to use",
+          "name": "remote",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "addons:services",
+      "hiddenAliases": [
+        "open"
+      ],
+      "id": "apps:open",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "topic": "addons",
+      "topic": "apps",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "addons",
-        "services.js"
+        "apps",
+        "open.js"
       ]
     },
-    "addons:upgrade": {
-      "aliases": [
-        "addons:downgrade"
-      ],
+    "apps:rename": {
+      "aliases": [],
       "args": {
-        "addon": {
-          "name": "addon",
+        "newname": {
+          "description": "new unique name of the app",
+          "name": "newname",
           "required": true
-        },
-        "plan": {
-          "name": "plan"
         }
       },
-      "description": "change add-on plan.\n  See available plans with `heroku addons:plans SERVICE`.\n\n  Note that `heroku addons:upgrade` and `heroku addons:downgrade` are the same.  Either one can be used to change an add-on plan up or down.\n\n  https://devcenter.heroku.com/articles/managing-add-ons\n  ",
+      "description": "rename an app",
       "examples": [
-        "Upgrade an add-on by service name:\n$ heroku addons:upgrade heroku-redis:premium-2\n\nUpgrade a specific add-on:\n$ heroku addons:upgrade swimming-briskly-123 heroku-redis:premium-2"
+        "$ heroku apps:rename --app oldname newname"
       ],
       "flags": {
         "app": {
           "char": "a",
           "description": "app to run command against",
           "name": "app",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1108,36 +1144,52 @@
         }
       },
       "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "addons:upgrade",
+      "hiddenAliases": [
+        "rename"
+      ],
+      "id": "apps:rename",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "topic": "addons",
+      "help": "This will locally update the git remote if it is set to the old app.",
+      "topic": "apps",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "addons",
-        "upgrade.js"
+        "apps",
+        "rename.js"
       ]
     },
-    "addons:wait": {
+    "apps:transfer": {
       "aliases": [],
       "args": {
-        "addon": {
-          "name": "addon"
+        "recipient": {
+          "description": "user or team to transfer applications to",
+          "name": "recipient",
+          "required": true
         }
       },
-      "description": "show provisioning status of the add-ons on the app",
+      "description": "transfer applications to another user or team",
+      "examples": [
+        "$ heroku apps:transfer collaborator@example.com\nTransferring example to collaborator@example.com... done\n\n$ heroku apps:transfer acme-widgets\nTransferring example to acme-widgets... done\n\n$ heroku apps:transfer --bulk acme-widgets\n..."
+      ],
       "flags": {
-        "wait-interval": {
-          "description": "how frequently to poll in seconds",
-          "name": "wait-interval",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "locked": {
+          "char": "l",
+          "description": "lock the app upon transfer",
+          "name": "locked",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "bulk": {
+          "description": "transfer applications in bulk",
+          "name": "bulk",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
         },
         "app": {
           "char": "a",
@@ -1154,223 +1206,178 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "confirm": {
+          "char": "c",
+          "hidden": true,
+          "name": "confirm",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "addons:wait",
+      "id": "apps:transfer",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "topic": "addons",
+      "topic": "apps",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "addons",
-        "wait.js"
+        "apps",
+        "transfer.js"
       ]
     },
-    "apps:create": {
-      "aliases": [],
-      "args": {
-        "app": {
-          "description": "name of app to create",
-          "name": "app",
-          "required": false
-        }
-      },
-      "description": "creates a new app",
-      "examples": [
-        "$ heroku apps:create\nCreating app... done, stack is heroku-24\nhttps://floating-dragon-42.heroku.com/ | https://git.heroku.com/floating-dragon-42.git\n\n# or just\n$ heroku create\n\n# use a heroku.yml manifest file\n$ heroku apps:create --manifest\n\n# specify a buildpack\n$ heroku apps:create --buildpack https://github.com/some/buildpack.git\n\n# specify a name\n$ heroku apps:create example\n\n# create a staging app\n$ heroku apps:create example-staging --remote staging\n\n# create an app in the eu region\n$ heroku apps:create --region eu"
+    "apps:unlock": {
+      "aliases": [
+        "unlock"
       ],
+      "args": {},
+      "description": "unlock an app so any team member can join",
       "flags": {
         "app": {
-          "hidden": true,
+          "char": "a",
+          "description": "app to run command against",
           "name": "app",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "addons": {
-          "description": "comma-delimited list of addons to install",
-          "name": "addons",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "buildpack": {
-          "char": "b",
-          "description": "buildpack url to use for this app",
-          "name": "buildpack",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "manifest": {
-          "char": "m",
-          "description": "use heroku.yml settings for this app",
-          "hidden": true,
-          "name": "manifest",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "no-remote": {
-          "char": "n",
-          "description": "do not create a git remote",
-          "name": "no-remote",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "remote": {
           "char": "r",
-          "description": "the git remote to create, default \"heroku\"",
+          "description": "git remote of app to use",
           "name": "remote",
-          "default": "heroku",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "stack": {
-          "char": "s",
-          "description": "the stack to create the app on",
-          "name": "stack",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "space": {
-          "description": "the private space to create the app in",
-          "name": "space",
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "apps:unlock",
+      "pluginAlias": "heroku",
+      "pluginName": "heroku",
+      "pluginType": "core",
+      "strict": true,
+      "topic": "apps",
+      "isESM": false,
+      "relativePath": [
+        "lib",
+        "commands",
+        "apps",
+        "unlock.js"
+      ]
+    },
+    "addons:attach": {
+      "aliases": [],
+      "args": {
+        "addon_name": {
+          "description": "unique identifier or globally unique name of the add-on",
+          "name": "addon_name",
+          "required": true
+        }
+      },
+      "description": "attach an existing add-on resource to an app",
+      "flags": {
+        "as": {
+          "description": "name for add-on attachment",
+          "name": "as",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "region": {
-          "description": "specify region for the app to run in",
-          "name": "region",
+        "credential": {
+          "description": "credential name for scoped access to Heroku Postgres",
+          "name": "credential",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "internal-routing": {
-          "description": "private space-only. create as an Internal Web App that is only routable in the local network.",
-          "hidden": true,
-          "name": "internal-routing",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "features": {
-          "hidden": true,
-          "name": "features",
+        "confirm": {
+          "description": "overwrite existing add-on attachment with same name",
+          "name": "confirm",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "kernel": {
-          "hidden": true,
-          "name": "kernel",
+        "app": {
+          "char": "a",
+          "description": "app to run command against",
+          "name": "app",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "locked": {
-          "hidden": true,
-          "name": "locked",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "json": {
-          "description": "output in json format",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "team": {
-          "char": "t",
-          "description": "team to use",
-          "name": "team",
+        "remote": {
+          "char": "r",
+          "description": "git remote of app to use",
+          "name": "remote",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
-      "hiddenAliases": [
-        "create"
-      ],
-      "id": "apps:create",
+      "hiddenAliases": [],
+      "id": "addons:attach",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
+      "topic": "addons",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "apps",
-        "create.js"
+        "addons",
+        "attach.js"
       ]
     },
-    "apps:destroy": {
+    "addons:create": {
       "aliases": [],
       "args": {
-        "app": {
-          "hidden": true,
-          "name": "app"
+        "service:plan": {
+          "description": "unique identifier or unique name of the add-on service plan",
+          "name": "service:plan",
+          "required": true
         }
       },
-      "description": "permanently destroy an app",
+      "description": "Create a new add-on resource.\n\nIn order to add additional config items, please place them at the end of the command after a double-dash (--).\n",
+      "examples": "Create an add-on resource:\n$heroku addons:create heroku-redis --app my-app\n\nCreate an add-on resource with additional config items:\n$heroku addons:create heroku-postgresql:standard-0 --app my-app -- --fork DATABASE\n",
       "flags": {
-        "app": {
-          "char": "a",
-          "description": "app to run command against",
-          "name": "app",
+        "name": {
+          "description": "name for the add-on resource",
+          "name": "name",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "remote": {
-          "char": "r",
-          "description": "git remote of app to use",
-          "name": "remote",
+        "as": {
+          "description": "name for the initial add-on attachment",
+          "name": "as",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "confirm": {
-          "char": "c",
+          "description": "overwrite existing config vars or existing add-on attachments",
           "name": "confirm",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [
-        "destroy",
-        "apps:delete"
-      ],
-      "id": "apps:destroy",
-      "pluginAlias": "heroku",
-      "pluginName": "heroku",
-      "pluginType": "core",
-      "strict": true,
-      "help": "This will also destroy all add-ons on the app.",
-      "isESM": false,
-      "relativePath": [
-        "lib",
-        "commands",
-        "apps",
-        "destroy.js"
-      ]
-    },
-    "apps:errors": {
-      "aliases": [],
-      "args": {},
-      "description": "view app errors",
-      "flags": {
+        },
+        "wait": {
+          "description": "watch add-on creation status and exit when complete",
+          "name": "wait",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "app": {
           "char": "a",
           "description": "app to run command against",
@@ -1387,98 +1394,73 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "json": {
-          "description": "output in json format",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "hours": {
-          "description": "number of hours to look back (default 24)",
-          "name": "hours",
-          "default": "24",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "router": {
-          "description": "show only router errors",
-          "name": "router",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "dyno": {
-          "description": "show only dyno errors",
-          "name": "dyno",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "apps:errors",
+      "hiddenAliases": [
+        "addons:add"
+      ],
+      "id": "addons:create",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
-      "strict": true,
+      "strict": false,
+      "topic": "addons",
+      "example": "Create an add-on resource:\n$heroku addons:create heroku-redis --app my-app\n\nCreate an add-on resource with additional config items:\n$heroku addons:create heroku-postgresql:standard-0 --app my-app -- --fork DATABASE\n",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "apps",
-        "errors.js"
+        "addons",
+        "create.js"
       ]
     },
-    "apps": {
+    "addons:destroy": {
       "aliases": [],
-      "args": {},
-      "description": "list your apps",
+      "args": {
+        "addonName": {
+          "description": "unique identifier or globally unique name of the add-on",
+          "name": "addonName",
+          "required": true
+        }
+      },
+      "description": "permanently destroy an add-on resource",
       "examples": [
-        "$ heroku apps"
+        "addons:destroy [ADDON]... [flags]"
       ],
       "flags": {
-        "all": {
-          "char": "A",
-          "description": "include apps in all teams",
-          "name": "all",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "json": {
-          "char": "j",
-          "description": "output in json format",
-          "name": "json",
+        "force": {
+          "char": "f",
+          "description": "allow destruction even if connected to other apps",
+          "name": "force",
           "allowNo": false,
           "type": "boolean"
         },
-        "space": {
-          "char": "s",
-          "description": "filter by space",
-          "name": "space",
+        "confirm": {
+          "char": "c",
+          "name": "confirm",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "personal": {
-          "char": "p",
-          "description": "list apps in personal account when a default team is set",
-          "name": "personal",
+        "wait": {
+          "description": "watch add-on destruction status and exit when complete",
+          "name": "wait",
           "allowNo": false,
           "type": "boolean"
         },
-        "internal-routing": {
-          "char": "i",
-          "description": "filter to Internal Web Apps",
-          "hidden": true,
-          "name": "internal-routing",
-          "allowNo": false,
-          "type": "boolean"
+        "app": {
+          "char": "a",
+          "description": "app to run command against",
+          "name": "app",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "team": {
-          "char": "t",
-          "description": "team to use",
-          "name": "team",
+        "remote": {
+          "char": "r",
+          "description": "git remote of app to use",
+          "name": "remote",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1486,41 +1468,38 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [
-        "list",
-        "apps:list"
+        "addons:remove"
       ],
-      "id": "apps",
+      "id": "addons:destroy",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
-      "strict": true,
-      "topic": "apps",
+      "strict": false,
+      "topic": "addons",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "apps",
-        "index.js"
+        "addons",
+        "destroy.js"
       ]
     },
-    "apps:info": {
+    "addons:detach": {
       "aliases": [],
       "args": {
-        "app": {
-          "hidden": true,
-          "name": "app"
+        "attachment_name": {
+          "description": "unique identifier of the add-on attachment",
+          "name": "attachment_name",
+          "required": true
         }
       },
-      "description": "show detailed app information",
-      "examples": [
-        "$ heroku apps:info",
-        "$ heroku apps:info --shell"
-      ],
+      "description": "detach an existing add-on resource from an app",
       "flags": {
         "app": {
           "char": "a",
           "description": "app to run command against",
           "name": "app",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1532,60 +1511,45 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "shell": {
-          "char": "s",
-          "description": "output more shell friendly key/value pairs",
-          "name": "shell",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "extended": {
-          "char": "x",
-          "hidden": true,
-          "name": "extended",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "json": {
-          "char": "j",
-          "description": "output in json format",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
-      "hiddenAliases": [
-        "info"
-      ],
-      "id": "apps:info",
+      "hiddenAliases": [],
+      "id": "addons:detach",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "topic": "apps",
-      "help": "$ heroku apps:info\n=== example\nGit URL:   https://git.heroku.com/example.git\nRepo Size: 5M\n...\n\n$ heroku apps:info --shell\ngit_url=https://git.heroku.com/example.git\nrepo_size=5000000\n...",
+      "topic": "addons",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "apps",
-        "info.js"
+        "addons",
+        "detach.js"
       ]
     },
-    "apps:join": {
-      "aliases": [
-        "join"
-      ],
-      "args": {},
-      "description": "add yourself to a team app",
+    "addons:docs": {
+      "aliases": [],
+      "args": {
+        "addon": {
+          "description": "unique identifier or globally unique name of the add-on",
+          "name": "addon",
+          "required": true
+        }
+      },
+      "description": "open an add-on's Dev Center documentation in your browser",
       "flags": {
+        "show-url": {
+          "description": "show URL, do not open browser",
+          "name": "show-url",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "app": {
           "char": "a",
           "description": "app to run command against",
           "name": "app",
-          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1601,33 +1565,46 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "apps:join",
+      "id": "addons:docs",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "topic": "apps",
+      "topic": "addons",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "apps",
-        "join.js"
+        "addons",
+        "docs.js"
       ]
     },
-    "apps:leave": {
-      "aliases": [
-        "leave"
-      ],
+    "addons": {
+      "aliases": [],
       "args": {},
-      "description": "remove yourself from a team app",
-      "examples": "heroku apps:leave -a APP",
+      "description": "Lists your add-ons and attachments.\n\n  The default filter applied depends on whether you are in a Heroku app\n  directory. If so, the --app flag is implied. If not, the default of --all\n  is implied. Explicitly providing either flag overrides the default\n  behavior.\n  ",
+      "examples": [
+        "$ heroku addons --all",
+        "$ heroku addons --app acme-inc-www"
+      ],
       "flags": {
+        "all": {
+          "char": "A",
+          "description": "show add-ons and attachments for all accessible apps",
+          "name": "all",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "json": {
+          "description": "return add-ons in json format",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "app": {
           "char": "a",
           "description": "app to run command against",
           "name": "app",
-          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1643,33 +1620,36 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "apps:leave",
+      "id": "addons",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "topic": "apps",
-      "example": "heroku apps:leave -a APP",
+      "usage": "addons [--all|--app APP]",
+      "topic": "addons",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "apps",
-        "leave.js"
+        "addons",
+        "index.js"
       ]
     },
-    "apps:lock": {
-      "aliases": [
-        "lock"
-      ],
-      "args": {},
-      "description": "prevent team members from joining an app",
+    "addons:info": {
+      "aliases": [],
+      "args": {
+        "addon": {
+          "description": "unique identifier or globally unique name of the add-on",
+          "name": "addon",
+          "required": true
+        }
+      },
+      "description": "show detailed add-on resource and attachment information",
       "flags": {
         "app": {
           "char": "a",
           "description": "app to run command against",
           "name": "app",
-          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1685,39 +1665,42 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "apps:lock",
+      "id": "addons:info",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "topic": "apps",
+      "usage": "addons:info ADDON",
+      "topic": "addons",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "apps",
-        "lock.js"
+        "addons",
+        "info.js"
       ]
     },
-    "apps:open": {
+    "addons:open": {
       "aliases": [],
       "args": {
-        "path": {
-          "name": "path",
-          "required": false
+        "addon": {
+          "description": "unique identifier or globally unique name of the add-on",
+          "name": "addon",
+          "required": true
         }
       },
-      "description": "open the app in a web browser",
-      "examples": [
-        "$ heroku open -a myapp",
-        "$ heroku open -a myapp /foo"
-      ],
+      "description": "open an add-on's dashboard in your browser",
       "flags": {
+        "show-url": {
+          "description": "show URL, do not open browser",
+          "name": "show-url",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "app": {
           "char": "a",
           "description": "app to run command against",
           "name": "app",
-          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1732,102 +1715,135 @@
         }
       },
       "hasDynamicHelp": false,
-      "hiddenAliases": [
-        "open"
-      ],
-      "id": "apps:open",
+      "hiddenAliases": [],
+      "id": "addons:open",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "topic": "apps",
+      "topic": "addons",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "apps",
+        "addons",
         "open.js"
       ]
     },
-    "apps:rename": {
+    "addons:plans": {
       "aliases": [],
       "args": {
-        "newname": {
-          "name": "newname",
+        "service": {
+          "description": "unique identifier or globally unique name of the add-on",
+          "name": "service",
           "required": true
         }
       },
-      "description": "rename an app",
-      "examples": [
-        "$ heroku apps:rename --app oldname newname"
-      ],
+      "description": "list all available plans for an add-on service",
       "flags": {
-        "app": {
-          "char": "a",
-          "description": "app to run command against",
-          "name": "app",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "json": {
+          "description": "output in json format",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "addons:plans",
+      "pluginAlias": "heroku",
+      "pluginName": "heroku",
+      "pluginType": "core",
+      "strict": true,
+      "topic": "addons",
+      "isESM": false,
+      "relativePath": [
+        "lib",
+        "commands",
+        "addons",
+        "plans.js"
+      ]
+    },
+    "addons:rename": {
+      "aliases": [],
+      "args": {
+        "addon_name": {
+          "description": "unique identifier or globally unique name of the add-on",
+          "name": "addon_name",
+          "required": true
         },
-        "remote": {
-          "char": "r",
-          "description": "git remote of app to use",
-          "name": "remote",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "new_name": {
+          "description": "new globally unique name of the add-on",
+          "name": "new_name",
+          "required": true
         }
       },
+      "description": "rename an add-on",
+      "flags": {},
       "hasDynamicHelp": false,
-      "hiddenAliases": [
-        "rename"
-      ],
-      "id": "apps:rename",
+      "hiddenAliases": [],
+      "id": "addons:rename",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "help": "This will locally update the git remote if it is set to the old app.",
-      "topic": "apps",
+      "topic": "addons",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "apps",
+        "addons",
         "rename.js"
       ]
     },
-    "apps:transfer": {
+    "addons:services": {
       "aliases": [],
+      "args": {},
+      "description": "list all available add-on services",
+      "flags": {
+        "json": {
+          "description": "output in json format",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "addons:services",
+      "pluginAlias": "heroku",
+      "pluginName": "heroku",
+      "pluginType": "core",
+      "strict": true,
+      "topic": "addons",
+      "isESM": false,
+      "relativePath": [
+        "lib",
+        "commands",
+        "addons",
+        "services.js"
+      ]
+    },
+    "addons:upgrade": {
+      "aliases": [
+        "addons:downgrade"
+      ],
       "args": {
-        "recipient": {
-          "description": "user or team to transfer applications to",
-          "name": "recipient",
+        "addon": {
+          "description": "unique identifier or globally unique name of the add-on",
+          "name": "addon",
           "required": true
+        },
+        "plan": {
+          "description": "unique identifier or name of the plan",
+          "name": "plan"
         }
       },
-      "description": "transfer applications to another user or team",
+      "description": "change add-on plan.\n  See available plans with `heroku addons:plans SERVICE`.\n\n  Note that `heroku addons:upgrade` and `heroku addons:downgrade` are the same.  Either one can be used to change an add-on plan up or down.\n\n  https://devcenter.heroku.com/articles/managing-add-ons\n  ",
       "examples": [
-        "$ heroku apps:transfer collaborator@example.com\nTransferring example to collaborator@example.com... done\n\n$ heroku apps:transfer acme-widgets\nTransferring example to acme-widgets... done\n\n$ heroku apps:transfer --bulk acme-widgets\n..."
+        "Upgrade an add-on by service name:\n$ heroku addons:upgrade heroku-redis:premium-2\n\nUpgrade a specific add-on:\n$ heroku addons:upgrade swimming-briskly-123 heroku-redis:premium-2"
       ],
       "flags": {
-        "locked": {
-          "char": "l",
-          "description": "lock the app upon transfer",
-          "name": "locked",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "bulk": {
-          "description": "transfer applications in bulk",
-          "name": "bulk",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
-        },
         "app": {
           "char": "a",
           "description": "app to run command against",
@@ -1843,44 +1859,45 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "confirm": {
-          "char": "c",
-          "hidden": true,
-          "name": "confirm",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "apps:transfer",
+      "id": "addons:upgrade",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "topic": "apps",
+      "topic": "addons",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "apps",
-        "transfer.js"
+        "addons",
+        "upgrade.js"
       ]
     },
-    "apps:unlock": {
-      "aliases": [
-        "unlock"
-      ],
-      "args": {},
-      "description": "unlock an app so any team member can join",
+    "addons:wait": {
+      "aliases": [],
+      "args": {
+        "addon": {
+          "description": "unique identifier or globally unique name of the add-on",
+          "name": "addon"
+        }
+      },
+      "description": "show provisioning status of the add-ons on the app",
       "flags": {
+        "wait-interval": {
+          "description": "how frequently to poll in seconds",
+          "name": "wait-interval",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "app": {
           "char": "a",
           "description": "app to run command against",
           "name": "app",
-          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1896,18 +1913,18 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "apps:unlock",
+      "id": "addons:wait",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "topic": "apps",
+      "topic": "addons",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "apps",
-        "unlock.js"
+        "addons",
+        "wait.js"
       ]
     },
     "auth:login": {
@@ -2132,6 +2149,7 @@
       "aliases": [],
       "args": {
         "id": {
+          "description": "ID of the authorization",
           "name": "id",
           "required": true
         }
@@ -2168,6 +2186,7 @@
       ],
       "args": {
         "id": {
+          "description": "ID of the authorization",
           "name": "id",
           "required": true
         }
@@ -2196,6 +2215,7 @@
       "aliases": [],
       "args": {
         "id": {
+          "description": "ID of the authorization",
           "name": "id",
           "required": true
         }
@@ -2221,6 +2241,7 @@
       "aliases": [],
       "args": {
         "id": {
+          "description": "ID of the authorization",
           "name": "id",
           "required": true
         }
@@ -2762,10 +2783,12 @@
       "aliases": [],
       "args": {
         "CRT": {
+          "description": "absolute path of the certificate file on disk",
           "name": "CRT",
           "required": true
         },
         "KEY": {
+          "description": "absolute path of the key file on disk",
           "name": "KEY",
           "required": true
         }
@@ -2813,6 +2836,7 @@
       "aliases": [],
       "args": {
         "domain": {
+          "description": "domain name to generate",
           "name": "domain",
           "required": true
         }
@@ -3072,10 +3096,12 @@
       "aliases": [],
       "args": {
         "CRT": {
+          "description": "absolute path of the certificate file on disk",
           "name": "CRT",
           "required": true
         },
         "KEY": {
+          "description": "absolute path of the key file on disk",
           "name": "KEY",
           "required": true
         }
@@ -3258,6 +3284,7 @@
       "aliases": [],
       "args": {
         "test-run": {
+          "description": "auto-incremented test run number",
           "name": "test-run",
           "required": true
         }
@@ -3459,6 +3486,7 @@
       "aliases": [],
       "args": {
         "number": {
+          "description": "auto-incremented test run number",
           "name": "number",
           "required": false
         }
@@ -3562,10 +3590,12 @@
       "aliases": [],
       "args": {
         "name": {
+          "description": "name of the OAuth client",
           "name": "name",
           "required": true
         },
         "redirect_uri": {
+          "description": "redirect URL of the OAuth client",
           "name": "redirect_uri",
           "required": true
         }
@@ -3609,6 +3639,7 @@
       "aliases": [],
       "args": {
         "id": {
+          "description": "ID of the OAuth client",
           "name": "id",
           "required": true
         }
@@ -3662,6 +3693,7 @@
       "aliases": [],
       "args": {
         "id": {
+          "description": "ID of the OAuth client",
           "name": "id",
           "required": true
         }
@@ -3705,6 +3737,7 @@
       "aliases": [],
       "args": {
         "id": {
+          "description": "ID of the OAuth client",
           "name": "id",
           "required": true
         }
@@ -3745,6 +3778,7 @@
       "aliases": [],
       "args": {
         "id": {
+          "description": "ID of the OAuth client",
           "name": "id",
           "required": true
         }
@@ -3838,6 +3872,7 @@
       "aliases": [],
       "args": {
         "KEY": {
+          "description": "key name of the config var value",
           "name": "KEY",
           "required": true
         }
@@ -4376,6 +4411,7 @@
       "aliases": [],
       "args": {
         "hostname": {
+          "description": "unique identifier of the domain or full hostname",
           "name": "hostname",
           "required": true
         }
@@ -4621,6 +4657,7 @@
       "aliases": [],
       "args": {
         "hostname": {
+          "description": "unique identifier of the domain or full hostname",
           "name": "hostname",
           "required": true
         }
@@ -4674,6 +4711,7 @@
       "aliases": [],
       "args": {
         "hostname": {
+          "description": "unique identifier of the domain or full hostname",
           "name": "hostname",
           "required": true
         }
@@ -4727,6 +4765,7 @@
       "aliases": [],
       "args": {
         "hostname": {
+          "description": "unique identifier of the domain or full hostname",
           "name": "hostname",
           "required": true
         }
@@ -4788,6 +4827,7 @@
       "aliases": [],
       "args": {
         "hostname": {
+          "description": "unique identifier of the domain or full hostname",
           "name": "hostname"
         }
       },
@@ -4837,6 +4877,7 @@
       "aliases": [],
       "args": {
         "url": {
+          "description": "URL of the log drain",
           "name": "url",
           "required": true
         }
@@ -4931,6 +4972,7 @@
       "aliases": [],
       "args": {
         "url": {
+          "description": "URL of the log drain",
           "name": "url",
           "required": true
         }
@@ -4976,6 +5018,7 @@
       "aliases": [],
       "args": {
         "feature": {
+          "description": "unique identifier or name of the app feature",
           "name": "feature",
           "required": true
         }
@@ -5019,6 +5062,7 @@
       "aliases": [],
       "args": {
         "feature": {
+          "description": "unique identifier or name of the app feature",
           "name": "feature",
           "required": true
         }
@@ -5106,6 +5150,7 @@
       "aliases": [],
       "args": {
         "feature": {
+          "description": "unique identifier or name of the app feature",
           "name": "feature",
           "required": true
         }
@@ -5201,6 +5246,7 @@
       "aliases": [],
       "args": {
         "command": {
+          "description": "command name of the git credentials",
           "name": "command",
           "required": true
         }
@@ -5266,6 +5312,7 @@
       "aliases": [],
       "args": {
         "key": {
+          "description": "absolute path to the key located on disk. If omitted, we use the default rsa key.",
           "name": "key"
         }
       },
@@ -5361,6 +5408,7 @@
       "aliases": [],
       "args": {
         "key": {
+          "description": "email address of the user",
           "name": "key",
           "required": true
         }
@@ -5388,6 +5436,7 @@
       "aliases": [],
       "args": {
         "feature": {
+          "description": "unique identifier or name of the account feature",
           "name": "feature",
           "required": true
         }
@@ -5437,6 +5486,7 @@
       "aliases": [],
       "args": {
         "feature": {
+          "description": "unique identifier or name of the account feature",
           "name": "feature",
           "required": true
         }
@@ -5527,6 +5577,7 @@
       "aliases": [],
       "args": {
         "feature": {
+          "description": "unique identifier or name of the account feature",
           "name": "feature",
           "required": true
         }
@@ -5580,6 +5631,7 @@
       ],
       "args": {
         "processname": {
+          "description": "name of the process",
           "name": "processname",
           "required": false
         }
@@ -5825,6 +5877,7 @@
       "aliases": [],
       "args": {
         "email": {
+          "description": "email address of the team member",
           "name": "email",
           "required": true
         }
@@ -6121,6 +6174,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -6164,6 +6218,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -6207,10 +6262,12 @@
       "aliases": [],
       "args": {
         "source": {
+          "description": "config var exposed to the owning app containing the source database URL",
           "name": "source",
           "required": true
         },
         "target": {
+          "description": "config var exposed to the owning app containing the target database URL",
           "name": "target",
           "required": true
         }
@@ -6273,6 +6330,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -6316,6 +6374,7 @@
       "aliases": [],
       "args": {
         "DATABASE|REPORT_ID": {
+          "description": "config var exposed to the owning app containing the database URL or the report ID",
           "name": "DATABASE|REPORT_ID"
         }
       },
@@ -6367,6 +6426,7 @@
       ],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use all databases.",
           "name": "database"
         }
       },
@@ -6410,10 +6470,12 @@
       "aliases": [],
       "args": {
         "pid": {
+          "description": "ID of the process",
           "name": "pid",
           "required": true
         },
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -6463,6 +6525,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -6506,6 +6569,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -6556,6 +6620,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -6620,6 +6685,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::`",
           "name": "database",
           "required": true
         }
@@ -6670,6 +6736,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -6721,6 +6788,7 @@
       ],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -6786,10 +6854,12 @@
       "aliases": [],
       "args": {
         "source": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "source",
           "required": true
         },
         "target": {
+          "description": "PostgreSQL connection string for the target database",
           "name": "target",
           "required": true
         }
@@ -6845,10 +6915,12 @@
       "aliases": [],
       "args": {
         "source": {
+          "description": "PostgreSQL connection string for the source database",
           "name": "source",
           "required": true
         },
         "target": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "target",
           "required": true
         }
@@ -6904,6 +6976,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -6962,6 +7035,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::`",
           "name": "database",
           "required": true
         }
@@ -7013,6 +7087,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -7071,6 +7146,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -7114,6 +7190,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use all databases.",
           "name": "database"
         }
       },
@@ -8131,6 +8208,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app.",
           "name": "database"
         }
       },
@@ -8185,6 +8263,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app.",
           "name": "database",
           "required": false
         }
@@ -8237,6 +8316,7 @@
       ],
       "args": {
         "database": {
+          "description": "name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app.",
           "name": "database"
         }
       },
@@ -8287,6 +8367,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app.",
           "name": "database"
         }
       },
@@ -8339,6 +8420,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app.",
           "name": "database",
           "required": false
         }
@@ -8407,6 +8489,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app.",
           "name": "database"
         }
       },
@@ -8459,6 +8542,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app.",
           "name": "database",
           "required": false
         }
@@ -8503,6 +8587,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app.",
           "name": "database"
         }
       },
@@ -8553,6 +8638,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app.",
           "name": "database"
         }
       },
@@ -8605,6 +8691,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app.",
           "name": "database"
         }
       },
@@ -8663,6 +8750,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app.",
           "name": "database",
           "required": false
         }
@@ -8779,6 +8867,7 @@
       "aliases": [],
       "args": {
         "release": {
+          "description": "ID of the release. If omitted, we use the last release ID.",
           "name": "release"
         }
       },
@@ -8835,6 +8924,7 @@
       "aliases": [],
       "args": {
         "release": {
+          "description": "ID of the release. If omitted, we use the last release ID.",
           "name": "release"
         }
       },
@@ -8878,10 +8968,11 @@
       "aliases": [],
       "args": {
         "release": {
+          "description": "ID of the release. If omitted, we use the last eligible release.",
           "name": "release"
         }
       },
-      "description": "Roll back to a previous release.\n\n    If RELEASE is not specified, it will roll back one release.\n    ",
+      "description": "Roll back to a previous release.\n\n    If RELEASE is not specified, it will roll back to the last eligible release.\n    ",
       "flags": {
         "remote": {
           "char": "r",
@@ -9296,6 +9387,7 @@
       "aliases": [],
       "args": {
         "id": {
+          "description": "ID of the OAuth session",
           "name": "id",
           "required": true
         }
@@ -9355,7 +9447,7 @@
       },
       "description": "create a new space\n",
       "examples": [
-        "Example:\n\n$ heroku spaces:create --space my-space --team my-team --region oregon\nCreating space my-space in team my-team... done\n=== my-space\nID:         e7b99e37-69b3-4475-ad47-a5cc5d75fd9f\nTeam:       my-team\nRegion:     oregon\nCIDR:       10.0.0.0/16\nData CIDR:  172.23.0.0/20\nState:      allocating\nGeneration: fir\nCreated at: 2016-01-06T03:23:13Z\n"
+        "Example:\n\n$ heroku spaces:create --space my-space --team my-team --region oregon\nCreating space my-space in team my-team... done\n=== my-space\nID:         e7b99e37-69b3-4475-ad47-a5cc5d75fd9f\nTeam:       my-team\nRegion:     oregon\nCIDR:       10.0.0.0/16\nData CIDR:  172.23.0.0/20\nState:      allocating\nGeneration: cedar\nCreated at: 2016-01-06T03:23:13Z\n"
       ],
       "flags": {
         "channel": {
@@ -10278,6 +10370,7 @@
       "aliases": [],
       "args": {
         "id": {
+          "description": "ID of the webhook",
           "name": "id",
           "required": true
         }
@@ -10390,6 +10483,7 @@
       "aliases": [],
       "args": {
         "id": {
+          "description": "ID of the webhook",
           "name": "id",
           "required": true
         }
@@ -10639,6 +10733,7 @@
       "aliases": [],
       "args": {
         "stack": {
+          "description": "unique name or identifier of the stack",
           "name": "stack",
           "required": true
         }
@@ -10947,6 +11042,7 @@
       "aliases": [],
       "args": {
         "key": {
+          "description": "name of the config var key",
           "name": "key",
           "required": true
         }
@@ -11178,6 +11274,7 @@
       "aliases": [],
       "args": {
         "backup_id": {
+          "description": "ID of the backup. If omitted, we use the last unfinished backup ID.",
           "name": "backup_id"
         }
       },
@@ -11222,6 +11319,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -11278,6 +11376,7 @@
       "aliases": [],
       "args": {
         "backup_id": {
+          "description": "ID of the backup",
           "name": "backup_id",
           "required": true
         }
@@ -11333,6 +11432,7 @@
       "aliases": [],
       "args": {
         "backup_id": {
+          "description": "ID of the backup. If omitted, we use the last backup ID.",
           "name": "backup_id"
         }
       },
@@ -11469,6 +11569,7 @@
       "aliases": [],
       "args": {
         "backup_id": {
+          "description": "ID of the backup. If omitted, we use the last backup ID.",
           "name": "backup_id"
         }
       },
@@ -11513,13 +11614,23 @@
       "aliases": [],
       "args": {
         "backup": {
+          "description": "URL or backup ID from another app",
           "name": "backup"
         },
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
       "description": "restore a backup (default latest) to a database",
+      "examples": [
+        "# Basic Restore from Backup ID\n$ heroku pg:backups:restore b101 DATABASE_URL --app my-heroku-app\n",
+        "# Restore from Another App\n$ heroku pg:backups:restore example-app::b101 DATABASE_URL --app my-heroku-app\n",
+        "# Restore from a Public URL\n$ heroku pg:backups:restore 'https://s3.amazonaws.com/my-bucket/mydb.dump' DATABASE_URL --app my-heroku-app\n",
+        "# Verbose Output\n$ heroku pg:backups:restore b101 DATABASE_URL --app my-heroku-app --verbose\n",
+        "# Restore with Confirmation Prompt\n$ heroku pg:backups:restore b101 DATABASE_URL --app my-heroku-app --confirm my-heroku-app\n",
+        "# Restore with a Specific Database Name\n$ heroku pg:backups:restore b101 HEROKU_POSTGRESQL_PINK --app my-heroku-app\n"
+      ],
       "flags": {
         "wait-interval": {
           "name": "wait-interval",
@@ -11588,6 +11699,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -11680,6 +11792,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use a random database attached to the app.",
           "name": "database"
         }
       },
@@ -11724,6 +11837,7 @@
       "aliases": [],
       "args": {
         "backup_id": {
+          "description": "ID of the backup. If omitted, we use the last backup ID.",
           "name": "backup_id"
         }
       },
@@ -11768,6 +11882,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -11822,6 +11937,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -11875,6 +11991,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -11937,6 +12054,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -11990,6 +12108,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -12064,6 +12183,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -12117,10 +12237,12 @@
       "aliases": [],
       "args": {
         "remote": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::`",
           "name": "remote",
           "required": true
         },
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::`",
           "name": "database",
           "required": true
         }
@@ -12173,10 +12295,12 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::`",
           "name": "database",
           "required": true
         },
         "link": {
+          "description": "name of the linked data store",
           "name": "link",
           "required": true
         }
@@ -12231,6 +12355,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -12275,6 +12400,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -12319,6 +12445,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -12369,10 +12496,12 @@
       "aliases": [],
       "args": {
         "window": {
+          "description": "timestamp of the maintenance window",
           "name": "window",
           "required": true
         },
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -12419,9 +12548,11 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         },
         "value": {
+          "description": "boolean indicating if execution plans of queries will be logged for future connections",
           "name": "value"
         }
       },
@@ -12466,9 +12597,11 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         },
         "value": {
+          "description": "boolean indicating if data replication slot details get logged",
           "name": "value"
         }
       },
@@ -12512,6 +12645,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -12556,9 +12690,11 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         },
         "value": {
+          "description": "boolean indicating if database login attempts get logged",
           "name": "value"
         }
       },
@@ -12602,9 +12738,11 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         },
         "value": {
+          "description": "boolean indicating if a message gets logged when a session waits longer than the deadlock_timeout to acquire a lock",
           "name": "value"
         }
       },
@@ -12648,9 +12786,11 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         },
         "value": {
+          "description": "milliseconds to wait for a statement to complete before logging it",
           "name": "value"
         }
       },
@@ -12694,6 +12834,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         },
         "value": {
@@ -12746,9 +12887,11 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         },
         "value": {
+          "description": "type of SQL statements to log\n<options: none|ddl|mod|all>",
           "name": "value",
           "options": [
             "none",
@@ -12798,9 +12941,11 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         },
         "value": {
+          "description": "function type to track\n<options: none|pl|all>",
           "name": "value",
           "options": [
             "none",
@@ -12999,6 +13144,7 @@
       ],
       "args": {
         "url": {
+          "description": "URL to replace the log drain with",
           "name": "url",
           "required": true
         }
@@ -13231,6 +13377,7 @@
       "aliases": [],
       "args": {
         "source": {
+          "description": "IP address in CIDR notation",
           "name": "source",
           "required": true
         }
@@ -13324,6 +13471,7 @@
       "aliases": [],
       "args": {
         "source": {
+          "description": "IP address in CIDR notation",
           "name": "source",
           "required": true
         }
@@ -13783,6 +13931,7 @@
       "aliases": [],
       "args": {
         "id": {
+          "description": "ID of the webhook event",
           "name": "id",
           "required": true
         }
@@ -13888,6 +14037,7 @@
       "aliases": [],
       "args": {
         "id": {
+          "description": "ID of the webhook event",
           "name": "id",
           "required": true
         }
@@ -13943,9 +14093,11 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         },
         "value": {
+          "description": "boolean indicating if execution plans get logged",
           "name": "value"
         }
       },
@@ -13990,9 +14142,11 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         },
         "value": {
+          "description": "boolean indicating if the database has buffer statistics enabled",
           "name": "value"
         }
       },
@@ -14037,9 +14191,11 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         },
         "value": {
+          "description": "format of the log output\n<options: text|json|yaml|xml>",
           "name": "value",
           "options": [
             "text",
@@ -14090,9 +14246,11 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         },
         "value": {
+          "description": "minimum duration in milliseconds for queries before logging execution plans. A value of -1 disables it. A value of 0 logs all query execution plans.",
           "name": "value"
         }
       },
@@ -14137,9 +14295,11 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         },
         "value": {
+          "description": "boolean indicating if execution plan logs include nested statements",
           "name": "value"
         }
       },
@@ -14184,9 +14344,11 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         },
         "value": {
+          "description": "boolean indicating if the database has trigger execution statistics enabled",
           "name": "value"
         }
       },
@@ -14231,9 +14393,11 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         },
         "value": {
+          "description": "boolean indicating if the database has verbose execution plan logging enabled",
           "name": "value"
         }
       },
@@ -14275,5 +14439,5 @@
       ]
     }
   },
-  "version": "10.0.0-alpha.1"
+  "version": "10.0.0-alpha.2"
 }