heroku 10.2.0-beta.0 → 10.2.0

package/oclif.manifest.json

@@ -169,7 +169,7 @@
         },
         "tail": {
           "char": "t",
-          "description": "continually stream logs (defaults to true for Fir generation apps)",
+          "description": "continually stream logs (always enabled for Fir-generation apps)",
           "name": "tail",
           "allowNo": false,
           "type": "boolean"
@@ -533,124 +533,125 @@
         "update.js"
       ]
     },
-    "addons:attach": {
+    "apps:create": {
       "aliases": [],
       "args": {
-        "addon_name": {
-          "description": "unique identifier or globally unique name of the add-on",
-          "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": {
-          "description": "unique identifier or unique name of the add-on 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"
@@ -658,57 +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": {
-          "description": "unique identifier or globally unique name of the add-on",
-          "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",
@@ -724,36 +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": {
-          "description": "unique identifier of the add-on attachment",
-          "name": "attachment_name",
-          "required": true
-        }
-      },
-      "description": "detach an existing add-on resource from an app",
+      "args": {},
+      "description": "view app errors",
       "flags": {
         "app": {
           "char": "a",
@@ -771,96 +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": "addons:detach",
+      "id": "apps:errors",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "topic": "addons",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "addons",
-        "detach.js"
+        "apps",
+        "errors.js"
       ]
     },
-    "addons:docs": {
+    "apps": {
       "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",
+      "args": {},
+      "description": "list your apps",
+      "examples": [
+        "$ heroku apps"
+      ],
       "flags": {
-        "show-url": {
-          "description": "show URL, do not open browser",
-          "name": "show-url",
+        "all": {
+          "char": "A",
+          "description": "include apps in all teams",
+          "name": "all",
           "allowNo": false,
           "type": "boolean"
         },
-        "app": {
-          "char": "a",
-          "description": "app to run command against",
-          "name": "app",
+        "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"
         },
-        "remote": {
-          "char": "r",
-          "description": "git remote of app to use",
-          "name": "remote",
+        "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:docs",
+      "hiddenAliases": [
+        "list",
+        "apps:list"
+      ],
+      "id": "apps",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "topic": "addons",
+      "topic": "apps",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "addons",
-        "docs.js"
+        "apps",
+        "index.js"
       ]
     },
-    "addons": {
+    "apps:info": {
       "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  ",
+      "args": {
+        "app": {
+          "hidden": true,
+          "name": "app"
+        }
+      },
+      "description": "show detailed app information",
       "examples": [
-        "$ heroku addons --all",
-        "$ heroku addons --app acme-inc-www"
+        "$ heroku apps:info",
+        "$ heroku apps:info --shell"
       ],
       "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",
@@ -876,40 +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",
+      "hiddenAliases": [
+        "info"
+      ],
+      "id": "apps:info",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "usage": "addons [--all|--app APP]",
-      "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",
-        "index.js"
+        "apps",
+        "info.js"
       ]
     },
-    "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",
+    "apps:join": {
+      "aliases": [
+        "join"
+      ],
+      "args": {},
+      "description": "add yourself to a team app",
       "flags": {
         "app": {
           "char": "a",
           "description": "app to run command against",
           "name": "app",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -925,42 +962,33 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "addons:info",
+      "id": "apps:join",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "usage": "addons:info ADDON",
-      "topic": "addons",
+      "topic": "apps",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "addons",
-        "info.js"
+        "apps",
+        "join.js"
       ]
     },
-    "addons:open": {
-      "aliases": [],
-      "args": {
-        "addon": {
-          "description": "unique identifier or globally unique name of the add-on",
-          "name": "addon",
-          "required": true
-        }
-      },
-      "description": "open an add-on's dashboard in your browser",
+    "apps:leave": {
+      "aliases": [
+        "leave"
+      ],
+      "args": {},
+      "description": "remove yourself from a team app",
+      "examples": "heroku apps:leave -a 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"
@@ -976,138 +1004,82 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "addons:open",
+      "id": "apps:leave",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "topic": "addons",
+      "topic": "apps",
+      "example": "heroku apps:leave -a APP",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "addons",
-        "open.js"
+        "apps",
+        "leave.js"
       ]
     },
-    "addons:plans": {
-      "aliases": [],
-      "args": {
-        "service": {
-          "description": "unique identifier or globally unique name of the add-on",
-          "name": "service",
-          "required": true
-        }
-      },
-      "description": "list all available plans for an add-on service",
+    "apps:lock": {
+      "aliases": [
+        "lock"
+      ],
+      "args": {},
+      "description": "prevent team members from joining an app",
       "flags": {
-        "json": {
-          "description": "output 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"
+        },
+        "remote": {
+          "char": "r",
+          "description": "git remote of app to use",
+          "name": "remote",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "addons:plans",
+      "id": "apps:lock",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "topic": "addons",
+      "topic": "apps",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "addons",
-        "plans.js"
+        "apps",
+        "lock.js"
       ]
     },
-    "addons:rename": {
+    "apps:open": {
       "aliases": [],
       "args": {
-        "addon_name": {
-          "description": "unique identifier or globally unique name of the add-on",
-          "name": "addon_name",
-          "required": true
-        },
-        "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": [],
-      "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"
-        }
-      },
-      "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": {
-        "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"
+        "path": {
+          "description": "base URL path of app",
+          "name": "path",
+          "required": false
         }
       },
-      "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": "open the app in a web browser",
       "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 open -a myapp",
+        "$ heroku open -a myapp /foo"
       ],
       "flags": {
         "app": {
           "char": "a",
           "description": "app to run command against",
           "name": "app",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1122,42 +1094,42 @@
         }
       },
       "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "addons:upgrade",
+      "hiddenAliases": [
+        "open"
+      ],
+      "id": "apps:open",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "topic": "addons",
+      "topic": "apps",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "addons",
-        "upgrade.js"
+        "apps",
+        "open.js"
       ]
     },
-    "addons:wait": {
+    "apps:rename": {
       "aliases": [],
       "args": {
-        "addon": {
-          "description": "unique identifier or globally unique name of the add-on",
-          "name": "addon"
+        "newname": {
+          "description": "new unique name of the app",
+          "name": "newname",
+          "required": true
         }
       },
-      "description": "show provisioning status of the add-ons on the app",
+      "description": "rename an app",
+      "examples": [
+        "$ heroku apps:rename --app oldname newname"
+      ],
       "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"
@@ -1172,176 +1144,172 @@
         }
       },
       "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "addons:wait",
+      "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",
-        "wait.js"
+        "apps",
+        "rename.js"
       ]
     },
-    "apps:create": {
+    "apps:transfer": {
       "aliases": [],
       "args": {
-        "app": {
-          "description": "name of app to create",
-          "name": "app",
-          "required": false
+        "recipient": {
+          "description": "user or team to transfer applications to",
+          "name": "recipient",
+          "required": true
         }
       },
-      "description": "creates a new app",
+      "description": "transfer applications to another user or team",
       "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"
+        "$ 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": {
-        "app": {
-          "hidden": true,
-          "name": "app",
-          "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",
+        "locked": {
+          "char": "l",
+          "description": "lock the app upon transfer",
+          "name": "locked",
+          "required": false,
           "allowNo": false,
           "type": "boolean"
         },
-        "no-remote": {
-          "char": "n",
-          "description": "do not create a git remote",
-          "name": "no-remote",
+        "bulk": {
+          "description": "transfer applications in bulk",
+          "name": "bulk",
+          "required": false,
           "allowNo": false,
           "type": "boolean"
         },
-        "remote": {
-          "char": "r",
-          "description": "the git remote to create, default \"heroku\"",
-          "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",
+        "app": {
+          "char": "a",
+          "description": "app to run command against",
+          "name": "app",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "region": {
-          "description": "specify region for the app to run in",
-          "name": "region",
+        "remote": {
+          "char": "r",
+          "description": "git remote of app to use",
+          "name": "remote",
           "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": {
+        "confirm": {
+          "char": "c",
           "hidden": true,
-          "name": "features",
+          "name": "confirm",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "kernel": {
-          "hidden": true,
-          "name": "kernel",
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "apps:transfer",
+      "pluginAlias": "heroku",
+      "pluginName": "heroku",
+      "pluginType": "core",
+      "strict": true,
+      "topic": "apps",
+      "isESM": false,
+      "relativePath": [
+        "lib",
+        "commands",
+        "apps",
+        "transfer.js"
+      ]
+    },
+    "apps:unlock": {
+      "aliases": [
+        "unlock"
+      ],
+      "args": {},
+      "description": "unlock an app so any team member can join",
+      "flags": {
+        "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": "apps:unlock",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
+      "topic": "apps",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
         "apps",
-        "create.js"
+        "unlock.js"
       ]
     },
-    "apps:destroy": {
+    "addons:attach": {
       "aliases": [],
       "args": {
-        "app": {
-          "hidden": true,
-          "name": "app"
+        "addon_name": {
+          "description": "unique identifier or globally unique name of the add-on",
+          "name": "addon_name",
+          "required": true
         }
       },
-      "description": "permanently destroy an app",
+      "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"
+        },
+        "credential": {
+          "description": "credential name for scoped access to Heroku Postgres",
+          "name": "credential",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "confirm": {
+          "description": "overwrite existing add-on attachment with same name",
+          "name": "confirm",
+          "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"
@@ -1353,39 +1321,63 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "confirm": {
-          "char": "c",
-          "name": "confirm",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
-      "hiddenAliases": [
-        "destroy",
-        "apps:delete"
-      ],
-      "id": "apps:destroy",
+      "hiddenAliases": [],
+      "id": "addons:attach",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "help": "This will also destroy all add-ons on the app.",
+      "topic": "addons",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "apps",
-        "destroy.js"
+        "addons",
+        "attach.js"
       ]
     },
-    "apps:errors": {
+    "addons:create": {
       "aliases": [],
-      "args": {},
-      "description": "view app errors",
+      "args": {
+        "service:plan": {
+          "description": "unique identifier or unique name of the add-on 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",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "as": {
+          "description": "name for the initial add-on attachment",
+          "name": "as",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "confirm": {
+          "description": "overwrite existing config vars or existing add-on attachments",
+          "name": "confirm",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "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",
@@ -1402,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"
@@ -1501,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"
@@ -1547,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"
@@ -1616,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"
@@ -1658,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"
@@ -1700,40 +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": {
-          "description": "base URL path of app",
-          "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"
@@ -1748,103 +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": {
-          "description": "new unique name of the app",
-          "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",
@@ -1852,19 +1851,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "remote": {
-          "char": "r",
-          "description": "git remote of app to use",
-          "name": "remote",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "confirm": {
-          "char": "c",
-          "hidden": true,
-          "name": "confirm",
+        },
+        "remote": {
+          "char": "r",
+          "description": "git remote of app to use",
+          "name": "remote",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1872,32 +1863,41 @@
       },
       "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"
@@ -1913,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": {
@@ -10790,252 +10790,42 @@
       ]
     },
     "auth:2fa:disable": {
-      "aliases": [
-        "twofactor:disable",
-        "2fa:disable"
-      ],
-      "args": {},
-      "description": "disables 2fa on account",
-      "examples": "$ heroku auth:2fa:disable",
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "auth:2fa:disable",
-      "pluginAlias": "heroku",
-      "pluginName": "heroku",
-      "pluginType": "core",
-      "strict": true,
-      "example": "$ heroku auth:2fa:disable",
-      "isESM": false,
-      "relativePath": [
-        "lib",
-        "commands",
-        "auth",
-        "2fa",
-        "disable.js"
-      ]
-    },
-    "auth:2fa": {
-      "aliases": [
-        "2fa",
-        "twofactor"
-      ],
-      "args": {},
-      "description": "check 2fa status",
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "auth:2fa",
-      "pluginAlias": "heroku",
-      "pluginName": "heroku",
-      "pluginType": "core",
-      "strict": true,
-      "isESM": false,
-      "relativePath": [
-        "lib",
-        "commands",
-        "auth",
-        "2fa",
-        "index.js"
-      ]
-    },
-    "certs:auto:disable": {
-      "aliases": [],
-      "args": {},
-      "description": "disable ACM for an app",
-      "flags": {
-        "confirm": {
-          "char": "c",
-          "hidden": true,
-          "name": "confirm",
-          "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"
-        },
-        "remote": {
-          "char": "r",
-          "description": "git remote of app to use",
-          "name": "remote",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "certs:auto:disable",
-      "pluginAlias": "heroku",
-      "pluginName": "heroku",
-      "pluginType": "core",
-      "strict": true,
-      "topic": "certs",
-      "isESM": false,
-      "relativePath": [
-        "lib",
-        "commands",
-        "certs",
-        "auto",
-        "disable.js"
-      ]
-    },
-    "certs:auto:enable": {
-      "aliases": [],
-      "args": {},
-      "description": "enable ACM status for an app",
-      "flags": {
-        "wait": {
-          "description": "watch ACM status and exit when complete",
-          "name": "wait",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "app": {
-          "char": "a",
-          "description": "app to run command against",
-          "name": "app",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "remote": {
-          "char": "r",
-          "description": "git remote of app to use",
-          "name": "remote",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "certs:auto:enable",
-      "pluginAlias": "heroku",
-      "pluginName": "heroku",
-      "pluginType": "core",
-      "strict": true,
-      "topic": "certs",
-      "isESM": false,
-      "relativePath": [
-        "lib",
-        "commands",
-        "certs",
-        "auto",
-        "enable.js"
-      ]
-    },
-    "certs:auto": {
-      "aliases": [],
-      "args": {},
-      "description": "show ACM status for an app",
-      "flags": {
-        "wait": {
-          "description": "watch ACM status and display the status when complete",
-          "name": "wait",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "app": {
-          "char": "a",
-          "description": "app to run command against",
-          "name": "app",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "remote": {
-          "char": "r",
-          "description": "git remote of app to use",
-          "name": "remote",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "certs:auto",
-      "pluginAlias": "heroku",
-      "pluginName": "heroku",
-      "pluginType": "core",
-      "strict": true,
-      "topic": "certs",
-      "isESM": false,
-      "relativePath": [
-        "lib",
-        "commands",
-        "certs",
-        "auto",
-        "index.js"
-      ]
-    },
-    "certs:auto:refresh": {
-      "aliases": [],
-      "args": {},
-      "description": "refresh ACM for an app",
-      "flags": {
-        "app": {
-          "char": "a",
-          "description": "app to run command against",
-          "name": "app",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "remote": {
-          "char": "r",
-          "description": "git remote of app to use",
-          "name": "remote",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
+      "aliases": [
+        "twofactor:disable",
+        "2fa:disable"
+      ],
+      "args": {},
+      "description": "disables 2fa on account",
+      "examples": "$ heroku auth:2fa:disable",
+      "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "certs:auto:refresh",
+      "id": "auth:2fa:disable",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "topic": "certs",
+      "example": "$ heroku auth:2fa:disable",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "certs",
-        "auto",
-        "refresh.js"
+        "auth",
+        "2fa",
+        "disable.js"
       ]
     },
-    "certs:auto:wait": {
-      "aliases": [],
+    "auth:2fa": {
+      "aliases": [
+        "2fa",
+        "twofactor"
+      ],
       "args": {},
-      "description": "waits for the certificate to be activated",
-      "flags": {
-        "help": {
-          "char": "h",
-          "description": "Show CLI help.",
-          "name": "help",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
+      "description": "check 2fa status",
+      "flags": {},
       "hasDynamicHelp": false,
-      "hidden": true,
       "hiddenAliases": [],
-      "id": "certs:auto:wait",
+      "id": "auth:2fa",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
@@ -11044,9 +10834,9 @@
       "relativePath": [
         "lib",
         "commands",
-        "certs",
-        "auto",
-        "wait.js"
+        "auth",
+        "2fa",
+        "index.js"
       ]
     },
     "ci:config:get": {
@@ -11281,6 +11071,216 @@
         "unset.js"
       ]
     },
+    "certs:auto:disable": {
+      "aliases": [],
+      "args": {},
+      "description": "disable ACM for an app",
+      "flags": {
+        "confirm": {
+          "char": "c",
+          "hidden": true,
+          "name": "confirm",
+          "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"
+        },
+        "remote": {
+          "char": "r",
+          "description": "git remote of app to use",
+          "name": "remote",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "certs:auto:disable",
+      "pluginAlias": "heroku",
+      "pluginName": "heroku",
+      "pluginType": "core",
+      "strict": true,
+      "topic": "certs",
+      "isESM": false,
+      "relativePath": [
+        "lib",
+        "commands",
+        "certs",
+        "auto",
+        "disable.js"
+      ]
+    },
+    "certs:auto:enable": {
+      "aliases": [],
+      "args": {},
+      "description": "enable ACM status for an app",
+      "flags": {
+        "wait": {
+          "description": "watch ACM status and exit when complete",
+          "name": "wait",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "app": {
+          "char": "a",
+          "description": "app to run command against",
+          "name": "app",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "remote": {
+          "char": "r",
+          "description": "git remote of app to use",
+          "name": "remote",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "certs:auto:enable",
+      "pluginAlias": "heroku",
+      "pluginName": "heroku",
+      "pluginType": "core",
+      "strict": true,
+      "topic": "certs",
+      "isESM": false,
+      "relativePath": [
+        "lib",
+        "commands",
+        "certs",
+        "auto",
+        "enable.js"
+      ]
+    },
+    "certs:auto": {
+      "aliases": [],
+      "args": {},
+      "description": "show ACM status for an app",
+      "flags": {
+        "wait": {
+          "description": "watch ACM status and display the status when complete",
+          "name": "wait",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "app": {
+          "char": "a",
+          "description": "app to run command against",
+          "name": "app",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "remote": {
+          "char": "r",
+          "description": "git remote of app to use",
+          "name": "remote",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "certs:auto",
+      "pluginAlias": "heroku",
+      "pluginName": "heroku",
+      "pluginType": "core",
+      "strict": true,
+      "topic": "certs",
+      "isESM": false,
+      "relativePath": [
+        "lib",
+        "commands",
+        "certs",
+        "auto",
+        "index.js"
+      ]
+    },
+    "certs:auto:refresh": {
+      "aliases": [],
+      "args": {},
+      "description": "refresh ACM for an app",
+      "flags": {
+        "app": {
+          "char": "a",
+          "description": "app to run command against",
+          "name": "app",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "remote": {
+          "char": "r",
+          "description": "git remote of app to use",
+          "name": "remote",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "certs:auto:refresh",
+      "pluginAlias": "heroku",
+      "pluginName": "heroku",
+      "pluginType": "core",
+      "strict": true,
+      "topic": "certs",
+      "isESM": false,
+      "relativePath": [
+        "lib",
+        "commands",
+        "certs",
+        "auto",
+        "refresh.js"
+      ]
+    },
+    "certs:auto:wait": {
+      "aliases": [],
+      "args": {},
+      "description": "waits for the certificate to be activated",
+      "flags": {
+        "help": {
+          "char": "h",
+          "description": "Show CLI help.",
+          "name": "help",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hidden": true,
+      "hiddenAliases": [],
+      "id": "certs:auto:wait",
+      "pluginAlias": "heroku",
+      "pluginName": "heroku",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": false,
+      "relativePath": [
+        "lib",
+        "commands",
+        "certs",
+        "auto",
+        "wait.js"
+      ]
+    },
     "pg:backups:cancel": {
       "aliases": [],
       "args": {
@@ -14450,5 +14450,5 @@
       ]
     }
   },
-  "version": "10.2.0-beta.0"
+  "version": "10.2.0"
 }