heroku 10.1.1-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,132 @@
       },
       "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",
+        "path": {
+          "description": "base URL path of app",
+          "name": "path",
+          "required": false
+        }
+      },
+      "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"
+        "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: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": {
-          "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
-        },
-        "plan": {
-          "description": "unique identifier or name of the 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"
@@ -1122,37 +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": {
-          "description": "unique identifier or globally unique name of the add-on",
-          "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",
@@ -1169,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",
-      "flags": {
-        "app": {
-          "char": "a",
-          "description": "app to run command against",
-          "name": "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": {
+        "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",
@@ -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": "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"
       ],
-      "args": {},
-      "description": "remove yourself from a team app",
-      "examples": "heroku apps:leave -a 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"
@@ -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",
@@ -1860,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"
@@ -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": {
@@ -10741,248 +10741,16 @@
       ]
     },
     "apps:stacks:set": {
-      "aliases": [],
-      "args": {
-        "stack": {
-          "description": "unique name or identifier of the stack",
-          "name": "stack",
-          "required": true
-        }
-      },
-      "description": "set the stack of an app",
-      "examples": "$ heroku stack:set heroku-24 -a myapp\nSetting stack to heroku-24... done\nYou will need to redeploy myapp for the change to take effect.\nRun git push heroku main to trigger a new build on myapp.",
-      "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": [
-        "stack:set"
-      ],
-      "id": "apps:stacks:set",
-      "pluginAlias": "heroku",
-      "pluginName": "heroku",
-      "pluginType": "core",
-      "strict": true,
-      "example": "$ heroku stack:set heroku-24 -a myapp\nSetting stack to heroku-24... done\nYou will need to redeploy myapp for the change to take effect.\nRun git push heroku main to trigger a new build on myapp.",
-      "isESM": false,
-      "relativePath": [
-        "lib",
-        "commands",
-        "apps",
-        "stacks",
-        "set.js"
-      ]
-    },
-    "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",
+      "aliases": [],
+      "args": {
+        "stack": {
+          "description": "unique name or identifier of the stack",
+          "name": "stack",
+          "required": true
+        }
+      },
+      "description": "set the stack of an app",
+      "examples": "$ heroku stack:set heroku-24 -a myapp\nSetting stack to heroku-24... done\nYou will need to redeploy myapp for the change to take effect.\nRun git push heroku main to trigger a new build on myapp.",
       "flags": {
         "app": {
           "char": "a",
@@ -11003,39 +10771,61 @@
         }
       },
       "hasDynamicHelp": false,
+      "hiddenAliases": [
+        "stack:set"
+      ],
+      "id": "apps:stacks:set",
+      "pluginAlias": "heroku",
+      "pluginName": "heroku",
+      "pluginType": "core",
+      "strict": true,
+      "example": "$ heroku stack:set heroku-24 -a myapp\nSetting stack to heroku-24... done\nYou will need to redeploy myapp for the change to take effect.\nRun git push heroku main to trigger a new build on myapp.",
+      "isESM": false,
+      "relativePath": [
+        "lib",
+        "commands",
+        "apps",
+        "stacks",
+        "set.js"
+      ]
+    },
+    "auth:2fa:disable": {
+      "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": {
@@ -11266,19 +11056,229 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "ci:config:unset",
+      "id": "ci:config:unset",
+      "pluginAlias": "heroku",
+      "pluginName": "heroku",
+      "pluginType": "core",
+      "strict": false,
+      "topic": "ci",
+      "isESM": false,
+      "relativePath": [
+        "lib",
+        "commands",
+        "ci",
+        "config",
+        "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": false,
-      "topic": "ci",
+      "strict": true,
+      "topic": "certs",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "ci",
-        "config",
-        "unset.js"
+        "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": {
@@ -11652,7 +11652,7 @@
         },
         "extensions": {
           "char": "e",
-          "description": "comma-separated list of extensions to pre-install in the public schema\ndefaults to saving the latest database to DATABASE_URL\n",
+          "description": "comma-separated list of extensions to pre-install in the default \npublic schema or an optional custom schema \n(for example: hstore or myschema.hstore)\n",
           "name": "extensions",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -12407,19 +12407,15 @@
         "index.js"
       ]
     },
-    "pg:settings:auto-explain": {
+    "pg:maintenance": {
       "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"
         }
       },
-      "description": "Automatically log execution plans of queries without running EXPLAIN by hand.\nThe auto_explain module is loaded at session-time so existing connections will not be logged.\nRestart your Heroku app and/or restart existing connections for logging to start taking place.\n",
+      "description": "show current maintenance information",
       "flags": {
         "app": {
           "char": "a",
@@ -12441,35 +12437,37 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "pg:settings:auto-explain",
+      "id": "pg:maintenance",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
-      "strict": false,
+      "strict": true,
       "topic": "pg",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
         "pg",
-        "settings",
-        "auto-explain.js"
+        "maintenance",
+        "index.js"
       ]
     },
-    "pg:settings:explain-data-connector-details": {
+    "pg:maintenance:run": {
       "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"
         }
       },
-      "description": "displays stats on replication slots on your database, the default value is \"off\"\n",
+      "description": "start maintenance",
       "flags": {
+        "force": {
+          "char": "f",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "app": {
           "char": "a",
           "description": "app to run command against",
@@ -12490,29 +12488,36 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "pg:settings:explain-data-connector-details",
+      "id": "pg:maintenance:run",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
+      "strict": true,
       "topic": "pg",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
         "pg",
-        "settings",
-        "explain-data-connector-details.js"
+        "maintenance",
+        "run.js"
       ]
     },
-    "pg:settings": {
+    "pg:maintenance:window": {
       "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"
         }
       },
-      "description": "show your current database settings",
+      "description": "Set weekly maintenance window.\nAll times are in UTC.\n",
+      "examples": "$ heroku pg:maintenance:window \"Sunday 06:00\" postgres-slippery-100",
       "flags": {
         "app": {
           "char": "a",
@@ -12534,22 +12539,23 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "pg:settings",
+      "id": "pg:maintenance:window",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
       "topic": "pg",
+      "example": "$ heroku pg:maintenance:window \"Sunday 06:00\" postgres-slippery-100",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
         "pg",
-        "settings",
-        "index.js"
+        "maintenance",
+        "window.js"
       ]
     },
-    "pg:settings:log-connections": {
+    "pg:settings:auto-explain": {
       "aliases": [],
       "args": {
         "database": {
@@ -12557,11 +12563,11 @@
           "name": "database"
         },
         "value": {
-          "description": "boolean indicating if database login attempts get logged",
+          "description": "boolean indicating if execution plans of queries will be logged for future connections",
           "name": "value"
         }
       },
-      "description": "Controls whether a log message is produced when a login attempt is made. Default is true.\nSetting log_connections to false stops emitting log messages for all attempts to login to the database.",
+      "description": "Automatically log execution plans of queries without running EXPLAIN by hand.\nThe auto_explain module is loaded at session-time so existing connections will not be logged.\nRestart your Heroku app and/or restart existing connections for logging to start taking place.\n",
       "flags": {
         "app": {
           "char": "a",
@@ -12583,10 +12589,11 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "pg:settings:log-connections",
+      "id": "pg:settings:auto-explain",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
+      "strict": false,
       "topic": "pg",
       "isESM": false,
       "relativePath": [
@@ -12594,10 +12601,10 @@
         "commands",
         "pg",
         "settings",
-        "log-connections.js"
+        "auto-explain.js"
       ]
     },
-    "pg:settings:log-lock-waits": {
+    "pg:settings:explain-data-connector-details": {
       "aliases": [],
       "args": {
         "database": {
@@ -12605,11 +12612,11 @@
           "name": "database"
         },
         "value": {
-          "description": "boolean indicating if a message gets logged when a session waits longer than the deadlock_timeout to acquire a lock",
+          "description": "boolean indicating if data replication slot details get logged",
           "name": "value"
         }
       },
-      "description": "Controls whether a log message is produced when a session waits longer than the deadlock_timeout to acquire a lock. deadlock_timeout is set to 1 second\nDelays due to lock contention occur when multiple transactions are trying to access the same resource at the same time.\nApplications and their query patterns should try to avoid changes to many different tables within the same transaction.\n",
+      "description": "displays stats on replication slots on your database, the default value is \"off\"\n",
       "flags": {
         "app": {
           "char": "a",
@@ -12631,7 +12638,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "pg:settings:log-lock-waits",
+      "id": "pg:settings:explain-data-connector-details",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
@@ -12642,22 +12649,18 @@
         "commands",
         "pg",
         "settings",
-        "log-lock-waits.js"
+        "explain-data-connector-details.js"
       ]
     },
-    "pg:settings:log-min-duration-statement": {
+    "pg:settings": {
       "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"
         }
       },
-      "description": "The duration of each completed statement will be logged if the statement completes after the time specified by VALUE.\nVALUE needs to specified as a whole number, in milliseconds.\nSetting log_min_duration_statement to zero prints all statement durations and -1 will disable logging statement durations.\n",
+      "description": "show your current database settings",
       "flags": {
         "app": {
           "char": "a",
@@ -12679,10 +12682,11 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "pg:settings:log-min-duration-statement",
+      "id": "pg:settings",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
+      "strict": true,
       "topic": "pg",
       "isESM": false,
       "relativePath": [
@@ -12690,10 +12694,10 @@
         "commands",
         "pg",
         "settings",
-        "log-min-duration-statement.js"
+        "index.js"
       ]
     },
-    "pg:settings:log-min-error-statement": {
+    "pg:settings:log-connections": {
       "aliases": [],
       "args": {
         "database": {
@@ -12701,16 +12705,11 @@
           "name": "database"
         },
         "value": {
-          "name": "value",
-          "options": [
-            "error",
-            "log",
-            "fatal",
-            "panic"
-          ]
+          "description": "boolean indicating if database login attempts get logged",
+          "name": "value"
         }
       },
-      "description": "log-min-error-statement controls the logging of SQL statements that cause an error at a specified severity level.\nThis setting is useful to prevent logging SQL queries that might contain sensitive information.\nUse this setting to prevent logging SQL queries that contain sensitive information. Default is \"error\".\n",
+      "description": "Controls whether a log message is produced when a login attempt is made. Default is true.\nSetting log_connections to false stops emitting log messages for all attempts to login to the database.",
       "flags": {
         "app": {
           "char": "a",
@@ -12732,7 +12731,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "pg:settings:log-min-error-statement",
+      "id": "pg:settings:log-connections",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
@@ -12743,10 +12742,10 @@
         "commands",
         "pg",
         "settings",
-        "log-min-error-statement.js"
+        "log-connections.js"
       ]
     },
-    "pg:settings:log-statement": {
+    "pg:settings:log-lock-waits": {
       "aliases": [],
       "args": {
         "database": {
@@ -12754,17 +12753,11 @@
           "name": "database"
         },
         "value": {
-          "description": "type of SQL statements to log\n<options: none|ddl|mod|all>",
-          "name": "value",
-          "options": [
-            "none",
-            "ddl",
-            "mod",
-            "all"
-          ]
+          "description": "boolean indicating if a message gets logged when a session waits longer than the deadlock_timeout to acquire a lock",
+          "name": "value"
         }
       },
-      "description": "log_statement controls which SQL statements are logged.\nValid values for VALUE:\nnone - No statements are logged\nddl  - All data definition statements, such as CREATE, ALTER and DROP will be logged\nmod  - Includes all statements from ddl as well as data-modifying statements such as INSERT, UPDATE, DELETE, TRUNCATE, COPY\nall  - All statements are logged\n",
+      "description": "Controls whether a log message is produced when a session waits longer than the deadlock_timeout to acquire a lock. deadlock_timeout is set to 1 second\nDelays due to lock contention occur when multiple transactions are trying to access the same resource at the same time.\nApplications and their query patterns should try to avoid changes to many different tables within the same transaction.\n",
       "flags": {
         "app": {
           "char": "a",
@@ -12786,7 +12779,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "pg:settings:log-statement",
+      "id": "pg:settings:log-lock-waits",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
@@ -12797,10 +12790,10 @@
         "commands",
         "pg",
         "settings",
-        "log-statement.js"
+        "log-lock-waits.js"
       ]
     },
-    "pg:settings:track-functions": {
+    "pg:settings:log-min-duration-statement": {
       "aliases": [],
       "args": {
         "database": {
@@ -12808,16 +12801,11 @@
           "name": "database"
         },
         "value": {
-          "description": "function type to track\n<options: none|pl|all>",
-          "name": "value",
-          "options": [
-            "none",
-            "pl",
-            "all"
-          ]
+          "description": "milliseconds to wait for a statement to complete before logging it",
+          "name": "value"
         }
       },
-      "description": "track_functions controls tracking of function call counts and time used. Default is none.\nValid values for VALUE:\nnone - No functions are tracked (default)\npl   - Only procedural language functions are tracked\nall  - All functions, including SQL and C language functions, are tracked. Simple SQL-language that are inlined are not tracked",
+      "description": "The duration of each completed statement will be logged if the statement completes after the time specified by VALUE.\nVALUE needs to specified as a whole number, in milliseconds.\nSetting log_min_duration_statement to zero prints all statement durations and -1 will disable logging statement durations.\n",
       "flags": {
         "app": {
           "char": "a",
@@ -12839,7 +12827,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "pg:settings:track-functions",
+      "id": "pg:settings:log-min-duration-statement",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
@@ -12850,18 +12838,27 @@
         "commands",
         "pg",
         "settings",
-        "track-functions.js"
+        "log-min-duration-statement.js"
       ]
     },
-    "pg:maintenance": {
+    "pg:settings:log-min-error-statement": {
       "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": {
+          "name": "value",
+          "options": [
+            "error",
+            "log",
+            "fatal",
+            "panic"
+          ]
         }
       },
-      "description": "show current maintenance information",
+      "description": "log-min-error-statement controls the logging of SQL statements that cause an error at a specified severity level.\nThis setting is useful to prevent logging SQL queries that might contain sensitive information.\nUse this setting to prevent logging SQL queries that contain sensitive information. Default is \"error\".\n",
       "flags": {
         "app": {
           "char": "a",
@@ -12883,37 +12880,40 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "pg:maintenance",
+      "id": "pg:settings:log-min-error-statement",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
-      "strict": true,
       "topic": "pg",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
         "pg",
-        "maintenance",
-        "index.js"
+        "settings",
+        "log-min-error-statement.js"
       ]
     },
-    "pg:maintenance:run": {
+    "pg:settings:log-statement": {
       "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",
+            "ddl",
+            "mod",
+            "all"
+          ]
         }
       },
-      "description": "start maintenance",
+      "description": "log_statement controls which SQL statements are logged.\nValid values for VALUE:\nnone - No statements are logged\nddl  - All data definition statements, such as CREATE, ALTER and DROP will be logged\nmod  - Includes all statements from ddl as well as data-modifying statements such as INSERT, UPDATE, DELETE, TRUNCATE, COPY\nall  - All statements are logged\n",
       "flags": {
-        "force": {
-          "char": "f",
-          "name": "force",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "app": {
           "char": "a",
           "description": "app to run command against",
@@ -12934,36 +12934,38 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "pg:maintenance:run",
+      "id": "pg:settings:log-statement",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
-      "strict": true,
       "topic": "pg",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
         "pg",
-        "maintenance",
-        "run.js"
+        "settings",
+        "log-statement.js"
       ]
     },
-    "pg:maintenance:window": {
+    "pg:settings:track-functions": {
       "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"
+        },
+        "value": {
+          "description": "function type to track\n<options: none|pl|all>",
+          "name": "value",
+          "options": [
+            "none",
+            "pl",
+            "all"
+          ]
         }
       },
-      "description": "Set weekly maintenance window.\nAll times are in UTC.\n",
-      "examples": "$ heroku pg:maintenance:window \"Sunday 06:00\" postgres-slippery-100",
+      "description": "track_functions controls tracking of function call counts and time used. Default is none.\nValid values for VALUE:\nnone - No functions are tracked (default)\npl   - Only procedural language functions are tracked\nall  - All functions, including SQL and C language functions, are tracked. Simple SQL-language that are inlined are not tracked",
       "flags": {
         "app": {
           "char": "a",
@@ -12985,20 +12987,18 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "pg:maintenance:window",
+      "id": "pg:settings:track-functions",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
-      "strict": true,
       "topic": "pg",
-      "example": "$ heroku pg:maintenance:window \"Sunday 06:00\" postgres-slippery-100",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
         "pg",
-        "maintenance",
-        "window.js"
+        "settings",
+        "track-functions.js"
       ]
     },
     "ps:autoscale:disable": {
@@ -14450,5 +14450,5 @@
       ]
     }
   },
-  "version": "10.1.1-beta.0"
+  "version": "10.2.0"
 }