heroku 9.0.0-alpha.3 → 9.0.0-beta.1

package/oclif.manifest.json

@@ -488,121 +488,125 @@
         "update.js"
       ]
     },
-    "addons:attach": {
+    "apps:create": {
       "aliases": [],
       "args": {
-        "addon_name": {
-          "name": "addon_name",
-          "required": true
+        "app": {
+          "description": "name of app to create",
+          "name": "app",
+          "required": false
         }
       },
-      "description": "attach an existing add-on resource to an app",
+      "description": "creates a new app",
+      "examples": [
+        "$ heroku apps:create\nCreating app... done, stack is heroku-22\nhttps://floating-dragon-42.heroku.com/ | https://git.heroku.com/floating-dragon-42.git\n\n# or just\n$ heroku create\n\n# use a heroku.yml manifest file\n$ heroku apps:create --manifest\n\n# specify a buildpack\n$ heroku apps:create --buildpack https://github.com/some/buildpack.git\n\n# specify a name\n$ heroku apps:create example\n\n# create a staging app\n$ heroku apps:create example-staging --remote staging\n\n# create an app in the eu region\n$ heroku apps:create --region eu"
+      ],
       "flags": {
-        "as": {
-          "description": "name for add-on attachment",
-          "name": "as",
+        "app": {
+          "hidden": true,
+          "name": "app",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "credential": {
-          "description": "credential name for scoped access to Heroku Postgres",
-          "name": "credential",
+        "addons": {
+          "description": "comma-delimited list of addons to install",
+          "name": "addons",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "confirm": {
-          "description": "overwrite existing add-on attachment with same name",
-          "name": "confirm",
+        "buildpack": {
+          "char": "b",
+          "description": "buildpack url to use for this app",
+          "name": "buildpack",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "app": {
-          "char": "a",
-          "description": "app to run command against",
-          "name": "app",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "manifest": {
+          "char": "m",
+          "description": "use heroku.yml settings for this app",
+          "hidden": true,
+          "name": "manifest",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "no-remote": {
+          "char": "n",
+          "description": "do not create a git remote",
+          "name": "no-remote",
+          "allowNo": false,
+          "type": "boolean"
         },
         "remote": {
           "char": "r",
-          "description": "git remote of app to use",
+          "description": "the git remote to create, default \"heroku\"",
           "name": "remote",
+          "default": "heroku",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "addons:attach",
-      "pluginAlias": "heroku",
-      "pluginName": "heroku",
-      "pluginType": "core",
-      "strict": true,
-      "topic": "addons",
-      "isESM": false,
-      "relativePath": [
-        "lib",
-        "commands",
-        "addons",
-        "attach.js"
-      ]
-    },
-    "addons:create": {
-      "aliases": [],
-      "args": {
-        "service:plan": {
-          "name": "service:plan",
-          "required": true
-        }
-      },
-      "description": "create a new add-on resource",
-      "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"
@@ -610,55 +614,31 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [
-        "addons:add"
+        "create"
       ],
-      "id": "addons:create",
+      "id": "apps:create",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
-      "strict": false,
-      "topic": "addons",
+      "strict": true,
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "addons",
+        "apps",
         "create.js"
       ]
     },
-    "addons:destroy": {
+    "apps:destroy": {
       "aliases": [],
       "args": {
-        "addonName": {
-          "name": "addonName",
-          "required": true
+        "app": {
+          "hidden": true,
+          "name": "app"
         }
       },
-      "description": "permanently destroy an add-on resource",
-      "examples": [
-        "addons:destroy [ADDON]... [flags]"
-      ],
+      "description": "permanently destroy an app",
       "flags": {
-        "force": {
-          "char": "f",
-          "description": "allow destruction even if connected to other apps",
-          "name": "force",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "confirm": {
-          "char": "c",
-          "name": "confirm",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "wait": {
-          "description": "watch add-on destruction status and exit when complete",
-          "name": "wait",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "app": {
           "char": "a",
           "description": "app to run command against",
@@ -674,35 +654,38 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "confirm": {
+          "char": "c",
+          "name": "confirm",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [
-        "addons:remove"
+        "destroy",
+        "apps:delete"
       ],
-      "id": "addons:destroy",
+      "id": "apps:destroy",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
-      "strict": false,
-      "topic": "addons",
+      "strict": true,
+      "help": "This will also destroy all add-ons on the app.",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "addons",
+        "apps",
         "destroy.js"
       ]
     },
-    "addons:detach": {
+    "apps:errors": {
       "aliases": [],
-      "args": {
-        "attachment_name": {
-          "name": "attachment_name",
-          "required": true
-        }
-      },
-      "description": "detach an existing add-on resource from an app",
+      "args": {},
+      "description": "view app errors",
       "flags": {
         "app": {
           "char": "a",
@@ -720,99 +703,205 @@
           "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": {
-          "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",
+        "app": {
+          "char": "a",
+          "description": "app to run command against",
+          "name": "app",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "remote": {
+          "char": "r",
+          "description": "git remote of app to use",
+          "name": "remote",
+          "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": {
-          "description": "return add-ons in json format",
+          "char": "j",
+          "description": "output in json format",
           "name": "json",
           "allowNo": false,
           "type": "boolean"
-        },
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [
+        "info"
+      ],
+      "id": "apps:info",
+      "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...",
+      "isESM": false,
+      "relativePath": [
+        "lib",
+        "commands",
+        "apps",
+        "info.js"
+      ]
+    },
+    "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"
@@ -828,35 +917,33 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "addons",
+      "id": "apps:join",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "usage": "addons [--all|--app APP]",
-      "topic": "addons",
+      "topic": "apps",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "addons",
-        "index.js"
+        "apps",
+        "join.js"
       ]
     },
-    "addons:info": {
-      "aliases": [],
-      "args": {
-        "addon": {
-          "name": "addon",
-          "required": true
-        }
-      },
-      "description": "show detailed add-on resource and attachment information",
+    "apps:leave": {
+      "aliases": [
+        "leave"
+      ],
+      "args": {},
+      "description": "remove yourself from a team app",
+      "examples": "heroku apps:leave -a APP",
       "flags": {
         "app": {
           "char": "a",
           "description": "app to run command against",
           "name": "app",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -872,41 +959,33 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "addons:info",
+      "id": "apps:leave",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "usage": "addons:info ADDON",
-      "topic": "addons",
+      "topic": "apps",
+      "example": "heroku apps:leave -a APP",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "addons",
-        "info.js"
+        "apps",
+        "leave.js"
       ]
     },
-    "addons:open": {
-      "aliases": [],
-      "args": {
-        "addon": {
-          "name": "addon",
-          "required": true
-        }
-      },
-      "description": "open an add-on's dashboard in your browser",
+    "apps:lock": {
+      "aliases": [
+        "lock"
+      ],
+      "args": {},
+      "description": "prevent team members from joining an app",
       "flags": {
-        "show-url": {
-          "description": "show URL, do not open browser",
-          "name": "show-url",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "app": {
           "char": "a",
           "description": "app to run command against",
           "name": "app",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -922,129 +1001,149 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "addons:open",
+      "id": "apps:lock",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "topic": "addons",
+      "topic": "apps",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "addons",
-        "open.js"
+        "apps",
+        "lock.js"
       ]
     },
-    "addons:plans": {
+    "apps:open": {
       "aliases": [],
       "args": {
-        "service": {
-          "name": "service",
-          "required": true
+        "path": {
+          "name": "path",
+          "required": false
         }
       },
-      "description": "list all available plans for an add-on service",
+      "description": "open the app in a web browser",
+      "examples": [
+        "$ heroku open -a myapp",
+        "$ heroku open -a myapp /foo"
+      ],
       "flags": {
-        "json": {
-          "description": "output in json format",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
+        "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",
+      "hiddenAliases": [
+        "open"
+      ],
+      "id": "apps:open",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "topic": "addons",
+      "topic": "apps",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "addons",
-        "plans.js"
+        "apps",
+        "open.js"
       ]
     },
-    "addons:rename": {
+    "apps:rename": {
       "aliases": [],
       "args": {
-        "addon_name": {
-          "name": "addon_name",
-          "required": true
-        },
-        "new_name": {
-          "name": "new_name",
+        "newname": {
+          "name": "newname",
           "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",
+      "description": "rename an app",
+      "examples": [
+        "$ heroku apps:rename --app oldname newname"
+      ],
       "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": [
+        "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",
-        "services.js"
+        "apps",
+        "rename.js"
       ]
     },
-    "addons:upgrade": {
-      "aliases": [
-        "addons:downgrade"
-      ],
+    "apps:transfer": {
+      "aliases": [],
       "args": {
-        "addon": {
-          "name": "addon",
+        "recipient": {
+          "description": "user or team to transfer applications to",
+          "name": "recipient",
           "required": true
-        },
-        "plan": {
-          "name": "plan"
         }
       },
-      "description": "change add-on plan.\n  See available plans with `heroku addons:plans SERVICE`.\n\n  Note that `heroku addons:upgrade` and `heroku addons:downgrade` are the same.  Either one can be used to change an add-on plan up or down.\n\n  https://devcenter.heroku.com/articles/managing-add-ons\n  ",
+      "description": "transfer applications to another user or team",
       "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: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": {
+        "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",
@@ -1060,44 +1159,44 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "confirm": {
+          "char": "c",
+          "hidden": true,
+          "name": "confirm",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "addons:upgrade",
+      "id": "apps:transfer",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "topic": "addons",
+      "topic": "apps",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "addons",
-        "upgrade.js"
+        "apps",
+        "transfer.js"
       ]
     },
-    "addons:wait": {
-      "aliases": [],
-      "args": {
-        "addon": {
-          "name": "addon"
-        }
-      },
-      "description": "show provisioning status of the add-ons on the app",
+    "apps:unlock": {
+      "aliases": [
+        "unlock"
+      ],
+      "args": {},
+      "description": "unlock an app so any team member can join",
       "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"
@@ -1113,219 +1212,123 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "addons:wait",
+      "id": "apps:unlock",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "topic": "addons",
+      "topic": "apps",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "addons",
-        "wait.js"
+        "apps",
+        "unlock.js"
       ]
     },
-    "apps:create": {
+    "addons:attach": {
       "aliases": [],
       "args": {
-        "app": {
-          "description": "name of app to create",
-          "name": "app",
-          "required": false
+        "addon_name": {
+          "name": "addon_name",
+          "required": true
         }
       },
-      "description": "creates a new app",
-      "examples": [
-        "$ heroku apps:create\nCreating app... done, stack is heroku-22\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"
-      ],
+      "description": "attach an existing add-on resource to an app",
       "flags": {
-        "app": {
-          "hidden": true,
-          "name": "app",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "addons": {
-          "description": "comma-delimited list of addons to install",
-          "name": "addons",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "buildpack": {
-          "char": "b",
-          "description": "buildpack url to use for this app",
-          "name": "buildpack",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "manifest": {
-          "char": "m",
-          "description": "use heroku.yml settings for this app",
-          "hidden": true,
-          "name": "manifest",
-          "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\"",
-          "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",
+        "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": {
+          "name": "service:plan",
+          "required": true
         }
       },
-      "description": "permanently destroy an app",
+      "description": "Create a new add-on resource.\n\nIn order to add additional config items, please place them at the end of the command after a double-dash (--).\n",
+      "examples": "Create an add-on resource:\n$heroku addons:create heroku-redis --app my-app\n\nCreate an add-on resource with additional config items:\n$heroku addons:create heroku-postgresql:standard-0 --app my-app -- --fork DATABASE\n",
       "flags": {
-        "app": {
-          "char": "a",
-          "description": "app to run command against",
-          "name": "app",
+        "name": {
+          "description": "name for the add-on resource",
+          "name": "name",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "remote": {
-          "char": "r",
-          "description": "git remote of app to use",
-          "name": "remote",
+        "as": {
+          "description": "name for the initial add-on attachment",
+          "name": "as",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "confirm": {
-          "char": "c",
+          "description": "overwrite existing config vars or existing add-on attachments",
           "name": "confirm",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [
-        "destroy",
-        "apps:delete"
-      ],
-      "id": "apps:destroy",
-      "pluginAlias": "heroku",
-      "pluginName": "heroku",
-      "pluginType": "core",
-      "strict": true,
-      "help": "This will also destroy all add-ons on the app.",
-      "isESM": false,
-      "relativePath": [
-        "lib",
-        "commands",
-        "apps",
-        "destroy.js"
-      ]
-    },
-    "apps:errors": {
-      "aliases": [],
-      "args": {},
-      "description": "view app errors",
-      "flags": {
+        },
+        "wait": {
+          "description": "watch add-on creation status and exit when complete",
+          "name": "wait",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "app": {
           "char": "a",
           "description": "app to run command against",
@@ -1342,98 +1345,72 @@
           "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": {
+          "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"
@@ -1441,41 +1418,37 @@
       },
       "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": {
+          "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"
@@ -1487,60 +1460,44 @@
           "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": {
+          "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"
@@ -1556,33 +1513,46 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "apps:join",
+      "id": "addons:docs",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "topic": "apps",
+      "topic": "addons",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "apps",
-        "join.js"
+        "addons",
+        "docs.js"
       ]
     },
-    "apps:leave": {
-      "aliases": [
-        "leave"
-      ],
+    "addons": {
+      "aliases": [],
       "args": {},
-      "description": "remove yourself from a team app",
-      "examples": "heroku apps:leave -a APP",
+      "description": "Lists your add-ons and attachments.\n\n  The default filter applied depends on whether you are in a Heroku app\n  directory. If so, the --app flag is implied. If not, the default of --all\n  is implied. Explicitly providing either flag overrides the default\n  behavior.\n  ",
+      "examples": [
+        "$ heroku addons --all",
+        "$ heroku addons --app acme-inc-www"
+      ],
       "flags": {
+        "all": {
+          "char": "A",
+          "description": "show add-ons and attachments for all accessible apps",
+          "name": "all",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "json": {
+          "description": "return add-ons in json format",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "app": {
           "char": "a",
           "description": "app to run command against",
           "name": "app",
-          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1598,33 +1568,35 @@
       },
       "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": {
+          "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"
@@ -1640,39 +1612,41 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "apps:lock",
+      "id": "addons:info",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "topic": "apps",
+      "usage": "addons:info ADDON",
+      "topic": "addons",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "apps",
-        "lock.js"
+        "addons",
+        "info.js"
       ]
     },
-    "apps:open": {
+    "addons:open": {
       "aliases": [],
       "args": {
-        "path": {
-          "name": "path",
-          "required": false
+        "addon": {
+          "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"
@@ -1687,102 +1661,130 @@
         }
       },
       "hasDynamicHelp": false,
-      "hiddenAliases": [
-        "open"
-      ],
-      "id": "apps:open",
+      "hiddenAliases": [],
+      "id": "addons:open",
       "pluginAlias": "heroku",
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "topic": "apps",
+      "topic": "addons",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "apps",
+        "addons",
         "open.js"
       ]
     },
-    "apps:rename": {
+    "addons:plans": {
       "aliases": [],
       "args": {
-        "newname": {
-          "name": "newname",
+        "service": {
+          "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": {
+          "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": {
+          "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",
+        "addons",
+        "rename.js"
+      ]
+    },
+    "addons:services": {
+      "aliases": [],
+      "args": {},
+      "description": "list all available add-on services",
+      "flags": {
+        "json": {
+          "description": "output in json format",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "addons:services",
+      "pluginAlias": "heroku",
+      "pluginName": "heroku",
+      "pluginType": "core",
+      "strict": true,
+      "topic": "addons",
       "isESM": false,
       "relativePath": [
         "lib",
         "commands",
-        "apps",
-        "rename.js"
+        "addons",
+        "services.js"
       ]
     },
-    "apps:transfer": {
-      "aliases": [],
+    "addons:upgrade": {
+      "aliases": [
+        "addons:downgrade"
+      ],
       "args": {
-        "recipient": {
-          "description": "user or team to transfer applications to",
-          "name": "recipient",
+        "addon": {
+          "name": "addon",
           "required": true
+        },
+        "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",
@@ -1798,44 +1800,44 @@
           "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": {
+          "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"
@@ -1851,18 +1853,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": {
@@ -9657,6 +9659,7 @@
       ],
       "flags": {
         "space": {
+          "char": "s",
           "description": "name of space",
           "name": "space",
           "required": true,
@@ -9665,6 +9668,7 @@
           "type": "option"
         },
         "team": {
+          "char": "t",
           "description": "desired owner of space",
           "name": "team",
           "required": true,
@@ -10610,7 +10614,6 @@
           "char": "a",
           "description": "app to run command against",
           "name": "app",
-          "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -10627,7 +10630,6 @@
           "char": "p",
           "description": "name of pipeline",
           "name": "pipeline",
-          "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -10667,12 +10669,20 @@
       "flags": {
         "app": {
           "char": "a",
-          "description": "app name",
+          "description": "app to run command against",
           "name": "app",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
+        "remote": {
+          "char": "r",
+          "description": "git remote of app to use",
+          "name": "remote",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "shell": {
           "char": "s",
           "description": "output config vars in shell format",
@@ -10739,7 +10749,6 @@
           "char": "p",
           "description": "name of pipeline",
           "name": "pipeline",
-          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -10770,18 +10779,10 @@
         "$ heroku ci:config:unset RAILS_ENV"
       ],
       "flags": {
-        "help": {
-          "char": "h",
-          "description": "Show CLI help.",
-          "name": "help",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "app": {
           "char": "a",
           "description": "app to run command against",
           "name": "app",
-          "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -10798,7 +10799,6 @@
           "char": "p",
           "description": "name of pipeline",
           "name": "pipeline",
-          "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -12574,169 +12574,6 @@
         "set.js"
       ]
     },
-    "spaces:outbound-rules:add": {
-      "aliases": [
-        "outbound-rules:add"
-      ],
-      "args": {},
-      "description": "Add outbound rules to a Private Space\n\nThe destination flag uses CIDR notation.\n\nICMP Rules\nThe ICMP protocol has types, not ports, but the underlying systems treat them as the same. For this reason,\nwhen you want to allow ICMP traffic you will use the --port flag to specify the ICMP types you want to\nallow. ICMP types are numbered, 0-255.\n",
-      "examples": [
-        "$ heroku outbound-rules:add --space my-space --dest 192.168.2.0/24 --protocol tcp --port 80\nAdding rule to the Outbound Rules of my-space... done\n",
-        "# with port range:\n$ heroku outbound-rules:add --space my-space --dest 192.168.2.0/24 --protocol tcp --port 80-100\nAdding rule to the Outbound Rules of my-space... done\n",
-        "# opening up everything\n$ heroku outbound-rules:add --space my-space --dest 0.0.0.0/0 --protocol any --port any\nAdding rule to the Outbound Rules of my-space... done\n"
-      ],
-      "flags": {
-        "space": {
-          "char": "s",
-          "description": "space to add rule to",
-          "name": "space",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "dest": {
-          "description": "target CIDR block dynos are allowed to communicate with",
-          "name": "dest",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "protocol": {
-          "description": "the protocol dynos are allowed to use when communicating with hosts in destination CIDR block.",
-          "name": "protocol",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "tcp",
-            "udp",
-            "icmp",
-            "0-255",
-            "any"
-          ],
-          "type": "option"
-        },
-        "port": {
-          "description": "the port dynos are allowed to use when communicating with hosts in destination CIDR block. Accepts a range in `<lowest port>-<highest port>` format. 0 is the minimum. The maximum port allowed is 65535, except for ICMP with a maximum of 255.",
-          "name": "port",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hidden": true,
-      "hiddenAliases": [],
-      "id": "spaces:outbound-rules:add",
-      "pluginAlias": "heroku",
-      "pluginName": "heroku",
-      "pluginType": "core",
-      "strict": true,
-      "topic": "spaces",
-      "isESM": false,
-      "relativePath": [
-        "lib",
-        "commands",
-        "spaces",
-        "outbound-rules",
-        "add.js"
-      ]
-    },
-    "spaces:outbound-rules": {
-      "aliases": [
-        "outbound-rules"
-      ],
-      "args": {
-        "space": {
-          "hidden": true,
-          "name": "space"
-        }
-      },
-      "description": "list Outbound Rules for a space\nOutbound Rules are only available on Private Spaces.\n\nNewly created spaces will have an \"Allow All\" rule set by default\nallowing all egress dyno traffic outside of the space.  You can\nremove this default rule to completely stop your private dynos from\ntalking to the world.\n\nYou can add specific rules that only allow your dyno to communicate with trusted hosts.\n",
-      "flags": {
-        "space": {
-          "char": "s",
-          "description": "space to get outbound rules from",
-          "name": "space",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "json": {
-          "description": "output in json format",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hidden": true,
-      "hiddenAliases": [],
-      "id": "spaces:outbound-rules",
-      "pluginAlias": "heroku",
-      "pluginName": "heroku",
-      "pluginType": "core",
-      "strict": true,
-      "topic": "spaces",
-      "isESM": false,
-      "relativePath": [
-        "lib",
-        "commands",
-        "spaces",
-        "outbound-rules",
-        "index.js"
-      ]
-    },
-    "spaces:outbound-rules:remove": {
-      "aliases": [
-        "outbound-rules:remove"
-      ],
-      "args": {
-        "ruleNumber": {
-          "name": "ruleNumber",
-          "required": true
-        }
-      },
-      "description": "Remove a Rules from the list of Outbound Rules",
-      "examples": [
-        "$ heroku outbound-rules:remove --space my-space 4\n    Removed 192.168.2.0/24 from trusted IP ranges on my-space\n"
-      ],
-      "flags": {
-        "space": {
-          "description": "space to remove rule from",
-          "name": "space",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "confirm": {
-          "description": "set to space name to bypass confirm prompt",
-          "name": "confirm",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hidden": true,
-      "hiddenAliases": [],
-      "id": "spaces:outbound-rules:remove",
-      "pluginAlias": "heroku",
-      "pluginName": "heroku",
-      "pluginType": "core",
-      "strict": true,
-      "topic": "spaces",
-      "isESM": false,
-      "relativePath": [
-        "lib",
-        "commands",
-        "spaces",
-        "outbound-rules",
-        "remove.js"
-      ]
-    },
     "spaces:peerings:accept": {
       "aliases": [],
       "args": {
@@ -13038,8 +12875,10 @@
       ],
       "flags": {
         "space": {
+          "char": "s",
           "description": "space to remove rule from",
           "name": "space",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -13081,7 +12920,7 @@
         }
       },
       "description": "display the configuration information for VPN\n\nYou will use the information provided by this command to establish a Private Space VPN Connection.\n\n- You must configure your VPN Gateway to use both Tunnels provided by Heroku\n- The VPN Gateway values are the IP addresses of the Private Space Tunnels\n- The Customer Gateway value is the Public IP of your VPN Gateway\n- The VPN Gateway must use the IKE Version shown and the Pre-shared Keys as the authentication method\n",
-      "examples": "$ heroku spaces:vpn:config --space my-space vpn-connection-name\n=== vpn-connection-name VPN Tunnels\n VPN Tunnel Customer Gateway VPN Gateway    Pre-shared Key Routable Subnets IKE Version\n ────────── ──────────────── ────────────── ────────────── ──────────────── ───────────\n Tunnel 1    104.196.121.200   35.171.237.136  abcdef12345     10.0.0.0/16       1\n Tunnel 2    104.196.121.200   52.44.7.216     fedcba54321     10.0.0.0/16       1\n",
+      "examples": "$ heroku spaces:vpn:config vpn-connection-name --space my-space\n=== vpn-connection-name VPN Tunnels\n VPN Tunnel Customer Gateway VPN Gateway    Pre-shared Key Routable Subnets IKE Version\n ────────── ──────────────── ────────────── ────────────── ──────────────── ───────────\n Tunnel 1    104.196.121.200   35.171.237.136  abcdef12345     10.0.0.0/16       1\n Tunnel 2    104.196.121.200   52.44.7.216     fedcba54321     10.0.0.0/16       1\n",
       "flags": {
         "space": {
           "char": "s",
@@ -13107,7 +12946,7 @@
       "pluginType": "core",
       "strict": true,
       "topic": "spaces",
-      "example": "$ heroku spaces:vpn:config --space my-space vpn-connection-name\n=== vpn-connection-name VPN Tunnels\n VPN Tunnel Customer Gateway VPN Gateway    Pre-shared Key Routable Subnets IKE Version\n ────────── ──────────────── ────────────── ────────────── ──────────────── ───────────\n Tunnel 1    104.196.121.200   35.171.237.136  abcdef12345     10.0.0.0/16       1\n Tunnel 2    104.196.121.200   52.44.7.216     fedcba54321     10.0.0.0/16       1\n",
+      "example": "$ heroku spaces:vpn:config vpn-connection-name --space my-space\n=== vpn-connection-name VPN Tunnels\n VPN Tunnel Customer Gateway VPN Gateway    Pre-shared Key Routable Subnets IKE Version\n ────────── ──────────────── ────────────── ────────────── ──────────────── ───────────\n Tunnel 1    104.196.121.200   35.171.237.136  abcdef12345     10.0.0.0/16       1\n Tunnel 2    104.196.121.200   52.44.7.216     fedcba54321     10.0.0.0/16       1\n",
       "isESM": false,
       "relativePath": [
         "lib",
@@ -13121,13 +12960,14 @@
       "aliases": [],
       "args": {
         "name": {
+          "description": "name or id of the VPN connection to create",
           "name": "name",
           "required": true
         }
       },
       "description": "create VPN\nPrivate Spaces can be connected to another private network via an IPSec VPN connection allowing dynos to connect to hosts on your private networks and vice versa.\nThe connection is established over the public Internet but all traffic is encrypted using IPSec.\n",
       "examples": [
-        "$ heroku spaces:vpn:connect --name office --ip 35.161.69.30 --cidrs 172.16.0.0/16,10.0.0.0/24 --space my-space\nCreating VPN Connection in space my-space... done\n▸    Use spaces:vpn:wait to track allocation.\n"
+        "$ heroku spaces:vpn:connect vpn-connection-name --ip 35.161.69.30 --cidrs 172.16.0.0/16,10.0.0.0/24 --space my-space\nCreating VPN Connection in space my-space... done\n▸    Use spaces:vpn:wait to track allocation.\n"
       ],
       "flags": {
         "ip": {
@@ -13219,7 +13059,7 @@
       "aliases": [],
       "args": {
         "name": {
-          "description": "name of the VPN connection to destroy",
+          "description": "name or id of the VPN connection to destroy",
           "name": "name",
           "required": true
         }
@@ -13274,7 +13114,7 @@
         }
       },
       "description": "display the information for VPN",
-      "examples": "$ heroku spaces:vpn:info --space my-space vpn-connection-name\n=== vpn-connection-name VPN Tunnel Info\nName:           vpn-connection-name\nID:             123456789012\nPublic IP:      35.161.69.30\nRoutable CIDRs: 172.16.0.0/16\nStatus:         failed\nStatus Message: supplied CIDR block already in use\n=== my-space Tunnel Info\n VPN Tunnel IP Address    Status Last Changed         Details\n ────────── ───────────── ────── ──────────────────── ─────────────\n Tunnel 1   52.44.146.197 UP     2016-10-25T22:09:05Z status message\n Tunnel 2   52.44.146.197 UP     2016-10-25T22:09:05Z status message\n",
+      "examples": "$ heroku spaces:vpn:info vpn-connection-name --space my-space\n=== vpn-connection-name VPN Tunnel Info\nName:           vpn-connection-name\nID:             123456789012\nPublic IP:      35.161.69.30\nRoutable CIDRs: 172.16.0.0/16\nStatus:         failed\nStatus Message: supplied CIDR block already in use\n=== my-space Tunnel Info\n VPN Tunnel IP Address    Status Last Changed         Details\n ────────── ───────────── ────── ──────────────────── ─────────────\n Tunnel 1   52.44.146.197 UP     2016-10-25T22:09:05Z status message\n Tunnel 2   52.44.146.197 UP     2016-10-25T22:09:05Z status message\n",
       "flags": {
         "space": {
           "char": "s",
@@ -13300,7 +13140,7 @@
       "pluginType": "core",
       "strict": true,
       "topic": "spaces",
-      "example": "$ heroku spaces:vpn:info --space my-space vpn-connection-name\n=== vpn-connection-name VPN Tunnel Info\nName:           vpn-connection-name\nID:             123456789012\nPublic IP:      35.161.69.30\nRoutable CIDRs: 172.16.0.0/16\nStatus:         failed\nStatus Message: supplied CIDR block already in use\n=== my-space Tunnel Info\n VPN Tunnel IP Address    Status Last Changed         Details\n ────────── ───────────── ────── ──────────────────── ─────────────\n Tunnel 1   52.44.146.197 UP     2016-10-25T22:09:05Z status message\n Tunnel 2   52.44.146.197 UP     2016-10-25T22:09:05Z status message\n",
+      "example": "$ heroku spaces:vpn:info vpn-connection-name --space my-space\n=== vpn-connection-name VPN Tunnel Info\nName:           vpn-connection-name\nID:             123456789012\nPublic IP:      35.161.69.30\nRoutable CIDRs: 172.16.0.0/16\nStatus:         failed\nStatus Message: supplied CIDR block already in use\n=== my-space Tunnel Info\n VPN Tunnel IP Address    Status Last Changed         Details\n ────────── ───────────── ────── ──────────────────── ─────────────\n Tunnel 1   52.44.146.197 UP     2016-10-25T22:09:05Z status message\n Tunnel 2   52.44.146.197 UP     2016-10-25T22:09:05Z status message\n",
       "isESM": false,
       "relativePath": [
         "lib",
@@ -13314,12 +13154,13 @@
       "aliases": [],
       "args": {
         "name": {
+          "description": "name or id of the VPN connection to update",
           "name": "name",
           "required": true
         }
       },
       "description": "update VPN\nPrivate Spaces can be connected to another private network via an IPSec VPN connection allowing dynos to connect to hosts on your private networks and vice versa.\nThe connection is established over the public Internet but all traffic is encrypted using IPSec.\n",
-      "examples": "$ heroku spaces:vpn:update office --space my-space --cidrs 172.16.0.0/16,10.0.0.0/24\nUpdating VPN Connection in space my-space... done\n",
+      "examples": "$ heroku spaces:vpn:update vpn-connection-name --space my-space --cidrs 172.16.0.0/16,10.0.0.0/24\nUpdating VPN Connection in space my-space... done\n",
       "flags": {
         "cidrs": {
           "char": "c",
@@ -13348,7 +13189,7 @@
       "pluginType": "core",
       "strict": true,
       "topic": "spaces",
-      "example": "$ heroku spaces:vpn:update office --space my-space --cidrs 172.16.0.0/16,10.0.0.0/24\nUpdating VPN Connection in space my-space... done\n",
+      "example": "$ heroku spaces:vpn:update vpn-connection-name --space my-space --cidrs 172.16.0.0/16,10.0.0.0/24\nUpdating VPN Connection in space my-space... done\n",
       "isESM": false,
       "relativePath": [
         "lib",
@@ -13360,8 +13201,17 @@
     },
     "spaces:vpn:wait": {
       "aliases": [],
-      "args": {},
+      "args": {
+        "name": {
+          "description": "name or id of the VPN connection you are waiting on for allocation.",
+          "name": "name",
+          "required": true
+        }
+      },
       "description": "wait for VPN Connection to be created",
+      "examples": [
+        " $ heroku spaces:vpn:wait vpn-connection-name --space my-space\n Waiting for VPN Connection vpn-connection-name to allocate... done\n === my-space VPN Tunnels\n\nVPN Tunnel Customer Gateway VPN Gateway    Pre-shared Key Routable Subnets IKE Version\n────────── ──────────────── ────────────── ────────────── ──────────────── ───────────\nTunnel 1    104.196.121.200   35.171.237.136  abcdef12345     10.0.0.0/16       1\nTunnel 2    104.196.121.200   52.44.7.216     fedcba54321     10.0.0.0/16       1\n"
+      ],
       "flags": {
         "space": {
           "char": "s",
@@ -13372,15 +13222,6 @@
           "multiple": false,
           "type": "option"
         },
-        "name": {
-          "char": "n",
-          "description": "name or id of the vpn connection to wait for",
-          "name": "name",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "json": {
           "description": "output in json format",
           "name": "json",
@@ -13922,5 +13763,5 @@
       ]
     }
   },
-  "version": "9.0.0-alpha.3"
+  "version": "9.0.0-beta.1"
 }