heroku 8.7.1 → 9.0.0-alpha.1

package/oclif.manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "8.7.1",
+  "version": "9.0.0-alpha.1",
   "commands": {
     "console": {
       "id": "console",
@@ -220,6 +220,386 @@
       },
       "args": {}
     },
+    "apps:create": {
+      "id": "apps:create",
+      "description": "creates a new app",
+      "strict": true,
+      "pluginName": "heroku",
+      "pluginAlias": "heroku",
+      "pluginType": "core",
+      "aliases": [
+        "create"
+      ],
+      "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": {
+        "app": {
+          "name": "app",
+          "type": "option",
+          "hidden": true,
+          "multiple": false
+        },
+        "addons": {
+          "name": "addons",
+          "type": "option",
+          "description": "comma-delimited list of addons to install",
+          "multiple": false
+        },
+        "buildpack": {
+          "name": "buildpack",
+          "type": "option",
+          "char": "b",
+          "description": "buildpack url to use for this app",
+          "multiple": false
+        },
+        "manifest": {
+          "name": "manifest",
+          "type": "boolean",
+          "char": "m",
+          "description": "use heroku.yml settings for this app",
+          "hidden": true,
+          "allowNo": false
+        },
+        "no-remote": {
+          "name": "no-remote",
+          "type": "boolean",
+          "char": "n",
+          "description": "do not create a git remote",
+          "allowNo": false
+        },
+        "remote": {
+          "name": "remote",
+          "type": "option",
+          "char": "r",
+          "description": "the git remote to create, default \"heroku\"",
+          "multiple": false,
+          "default": "heroku"
+        },
+        "stack": {
+          "name": "stack",
+          "type": "option",
+          "char": "s",
+          "description": "the stack to create the app on",
+          "multiple": false
+        },
+        "space": {
+          "name": "space",
+          "type": "option",
+          "description": "the private space to create the app in",
+          "multiple": false
+        },
+        "region": {
+          "name": "region",
+          "type": "option",
+          "description": "specify region for the app to run in",
+          "multiple": false
+        },
+        "internal-routing": {
+          "name": "internal-routing",
+          "type": "boolean",
+          "description": "private space-only. create as an Internal Web App that is only routable in the local network.",
+          "hidden": true,
+          "allowNo": false
+        },
+        "features": {
+          "name": "features",
+          "type": "option",
+          "hidden": true,
+          "multiple": false
+        },
+        "kernel": {
+          "name": "kernel",
+          "type": "option",
+          "hidden": true,
+          "multiple": false
+        },
+        "locked": {
+          "name": "locked",
+          "type": "boolean",
+          "hidden": true,
+          "allowNo": false
+        },
+        "json": {
+          "name": "json",
+          "type": "boolean",
+          "description": "output in json format",
+          "allowNo": false
+        },
+        "team": {
+          "name": "team",
+          "type": "option",
+          "char": "t",
+          "description": "team to use",
+          "multiple": false
+        }
+      },
+      "args": {
+        "apps": {
+          "name": "apps",
+          "description": "name of app to create",
+          "required": false
+        }
+      }
+    },
+    "apps:destroy": {
+      "id": "apps:destroy",
+      "description": "permanently destroy an app",
+      "strict": true,
+      "pluginName": "heroku",
+      "pluginAlias": "heroku",
+      "pluginType": "core",
+      "aliases": [
+        "destroy",
+        "apps:delete"
+      ],
+      "flags": {
+        "app": {
+          "name": "app",
+          "type": "option",
+          "char": "a",
+          "description": "app to run command against",
+          "multiple": false
+        },
+        "confirm": {
+          "name": "confirm",
+          "type": "option",
+          "char": "c",
+          "multiple": false
+        }
+      },
+      "args": {
+        "app": {
+          "name": "app",
+          "hidden": true
+        }
+      },
+      "help": "This will also destroy all add-ons on the app."
+    },
+    "apps:errors": {
+      "id": "apps:errors",
+      "description": "view app errors",
+      "strict": true,
+      "pluginName": "heroku",
+      "pluginAlias": "heroku",
+      "pluginType": "core",
+      "aliases": [],
+      "flags": {
+        "app": {
+          "name": "app",
+          "type": "option",
+          "char": "a",
+          "description": "app to run command against",
+          "required": true,
+          "multiple": false
+        },
+        "json": {
+          "name": "json",
+          "type": "boolean",
+          "description": "output in json format",
+          "allowNo": false
+        },
+        "hours": {
+          "name": "hours",
+          "type": "option",
+          "description": "number of hours to look back (default 24)",
+          "multiple": false,
+          "default": "24"
+        },
+        "router": {
+          "name": "router",
+          "type": "boolean",
+          "description": "show only router errors",
+          "allowNo": false
+        },
+        "dyno": {
+          "name": "dyno",
+          "type": "boolean",
+          "description": "show only dyno errors",
+          "allowNo": false
+        }
+      },
+      "args": {}
+    },
+    "apps": {
+      "id": "apps",
+      "description": "list your apps",
+      "strict": true,
+      "pluginName": "heroku",
+      "pluginAlias": "heroku",
+      "pluginType": "core",
+      "aliases": [
+        "list",
+        "apps:list"
+      ],
+      "examples": [
+        "$ heroku apps"
+      ],
+      "flags": {
+        "all": {
+          "name": "all",
+          "type": "boolean",
+          "char": "A",
+          "description": "include apps in all teams",
+          "allowNo": false
+        },
+        "json": {
+          "name": "json",
+          "type": "boolean",
+          "char": "j",
+          "description": "output in json format",
+          "allowNo": false
+        },
+        "space": {
+          "name": "space",
+          "type": "option",
+          "char": "s",
+          "description": "filter by space",
+          "multiple": false
+        },
+        "personal": {
+          "name": "personal",
+          "type": "boolean",
+          "char": "p",
+          "description": "list apps in personal account when a default team is set",
+          "allowNo": false
+        },
+        "internal-routing": {
+          "name": "internal-routing",
+          "type": "boolean",
+          "char": "i",
+          "description": "filter to Internal Web Apps",
+          "hidden": true,
+          "allowNo": false
+        },
+        "team": {
+          "name": "team",
+          "type": "option",
+          "char": "t",
+          "description": "team to use",
+          "multiple": false
+        }
+      },
+      "args": {},
+      "topic": "apps"
+    },
+    "apps:info": {
+      "id": "apps:info",
+      "description": "show detailed app information",
+      "strict": true,
+      "pluginName": "heroku",
+      "pluginAlias": "heroku",
+      "pluginType": "core",
+      "aliases": [
+        "info"
+      ],
+      "examples": [
+        "$ heroku apps:info",
+        "$ heroku apps:info --shell"
+      ],
+      "flags": {
+        "app": {
+          "name": "app",
+          "type": "option",
+          "char": "a",
+          "description": "app to run command against",
+          "multiple": false
+        },
+        "shell": {
+          "name": "shell",
+          "type": "boolean",
+          "char": "s",
+          "description": "output more shell friendly key/value pairs",
+          "allowNo": false
+        },
+        "extended": {
+          "name": "extended",
+          "type": "boolean",
+          "char": "x",
+          "hidden": true,
+          "allowNo": false
+        },
+        "json": {
+          "name": "json",
+          "type": "boolean",
+          "char": "j",
+          "description": "output in json format",
+          "allowNo": false
+        }
+      },
+      "args": {
+        "app": {
+          "name": "app",
+          "hidden": 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..."
+    },
+    "apps:open": {
+      "id": "apps:open",
+      "description": "open the app in a web browser",
+      "strict": true,
+      "pluginName": "heroku",
+      "pluginAlias": "heroku",
+      "pluginType": "core",
+      "aliases": [
+        "open"
+      ],
+      "examples": [
+        "$ heroku open -a myapp",
+        "$ heroku open -a myapp /foo"
+      ],
+      "flags": {
+        "app": {
+          "name": "app",
+          "type": "option",
+          "char": "a",
+          "description": "app to run command against",
+          "required": true,
+          "multiple": false
+        }
+      },
+      "args": {
+        "path": {
+          "name": "path",
+          "required": false
+        }
+      },
+      "topic": "apps"
+    },
+    "apps:rename": {
+      "id": "apps:rename",
+      "description": "rename an app",
+      "strict": true,
+      "pluginName": "heroku",
+      "pluginAlias": "heroku",
+      "pluginType": "core",
+      "aliases": [
+        "rename"
+      ],
+      "examples": [
+        "$ heroku apps:rename --app oldname newname"
+      ],
+      "flags": {
+        "app": {
+          "name": "app",
+          "type": "option",
+          "char": "a",
+          "description": "app to run command against",
+          "required": true,
+          "multiple": false
+        }
+      },
+      "args": {
+        "newname": {
+          "name": "newname",
+          "required": true
+        }
+      },
+      "help": "This will locally update the git remote if it is set to the old app.",
+      "topic": "apps"
+    },
     "auth:login": {
       "id": "auth:login",
       "description": "login with your Heroku credentials",
@@ -836,6 +1216,46 @@
         }
       }
     },
+    "ci:debug": {
+      "id": "ci:debug",
+      "description": "opens an interactive test debugging session with the contents of the current directory",
+      "strict": true,
+      "pluginName": "heroku",
+      "pluginAlias": "heroku",
+      "pluginType": "core",
+      "aliases": [],
+      "flags": {
+        "app": {
+          "name": "app",
+          "type": "option",
+          "char": "a",
+          "description": "app to run command against",
+          "multiple": false
+        },
+        "no-cache": {
+          "name": "no-cache",
+          "type": "boolean",
+          "description": "start test run with an empty cache",
+          "allowNo": false
+        },
+        "no-setup": {
+          "name": "no-setup",
+          "type": "boolean",
+          "description": "start test dyno without running test-setup",
+          "allowNo": false
+        },
+        "pipeline": {
+          "name": "pipeline",
+          "type": "option",
+          "char": "p",
+          "description": "name of pipeline",
+          "multiple": false
+        }
+      },
+      "args": {},
+      "help": "Example:\n\n    $ heroku ci:debug --pipeline PIPELINE\n    Preparing source... done\n    Creating test run... done\n    Running setup and attaching to test dyno...\n\n~ $\n",
+      "topic": "ci"
+    },
     "ci": {
       "id": "ci",
       "description": "display the most recent CI runs for the given pipeline",
@@ -959,6 +1379,60 @@
       },
       "args": {}
     },
+    "ci:migrate-manifest": {
+      "id": "ci:migrate-manifest",
+      "description": "app-ci.json is deprecated. Run this command to migrate to app.json with an environments key.",
+      "strict": true,
+      "pluginName": "heroku",
+      "pluginAlias": "heroku",
+      "pluginType": "core",
+      "aliases": [],
+      "examples": [
+        "$ heroku ci:migrate-manifest"
+      ],
+      "flags": {},
+      "args": {},
+      "topic": "ci"
+    },
+    "ci:open": {
+      "id": "ci:open",
+      "description": "open the Dashboard version of Heroku CI",
+      "strict": true,
+      "pluginName": "heroku",
+      "pluginAlias": "heroku",
+      "pluginType": "core",
+      "aliases": [],
+      "examples": [
+        "$ heroku ci:open --app murmuring-headland-14719"
+      ],
+      "flags": {
+        "help": {
+          "name": "help",
+          "type": "boolean",
+          "char": "h",
+          "description": "Show CLI help.",
+          "allowNo": false
+        },
+        "app": {
+          "name": "app",
+          "type": "option",
+          "char": "a",
+          "description": "app to run command against",
+          "required": true,
+          "multiple": false
+        },
+        "pipeline": {
+          "name": "pipeline",
+          "type": "option",
+          "char": "p",
+          "description": "name of pipeline",
+          "required": false,
+          "multiple": false
+        }
+      },
+      "args": {},
+      "topic": "ci"
+    },
     "ci:rerun": {
       "id": "ci:rerun",
       "description": "rerun tests against current directory",
@@ -1316,6 +1790,31 @@
       },
       "args": {}
     },
+    "config:set": {
+      "id": "config:set",
+      "description": "set one or more config vars",
+      "strict": false,
+      "pluginName": "heroku",
+      "pluginAlias": "heroku",
+      "pluginType": "core",
+      "aliases": [
+        "config:add"
+      ],
+      "examples": [
+        "$ heroku config:set RAILS_ENV=staging\nSetting config vars and restarting example... done, v10\nRAILS_ENV: staging\n\n$ heroku config:set RAILS_ENV=staging RACK_ENV=staging\nSetting config vars and restarting example... done, v11\nRAILS_ENV: staging\nRACK_ENV:  staging"
+      ],
+      "flags": {
+        "app": {
+          "name": "app",
+          "type": "option",
+          "char": "a",
+          "description": "app to run command against",
+          "required": true,
+          "multiple": false
+        }
+      },
+      "args": {}
+    },
     "config:unset": {
       "id": "config:unset",
       "description": "unset one or more config vars",
@@ -1712,20 +2211,105 @@
           "description": "app to run command against",
           "required": true,
           "multiple": false
-        },
-        "remote": {
-          "name": "remote",
-          "type": "option",
-          "char": "r",
-          "description": "git remote of app to use",
-          "multiple": false
+        },
+        "remote": {
+          "name": "remote",
+          "type": "option",
+          "char": "r",
+          "description": "git remote of app to use",
+          "multiple": false
+        }
+      },
+      "args": {
+        "hostname": {
+          "name": "hostname"
+        }
+      }
+    },
+    "drains:add": {
+      "id": "drains:add",
+      "description": "adds a log drain to an app",
+      "strict": true,
+      "pluginName": "heroku",
+      "pluginAlias": "heroku",
+      "pluginType": "core",
+      "aliases": [],
+      "flags": {
+        "app": {
+          "name": "app",
+          "type": "option",
+          "char": "a",
+          "description": "app to run command against",
+          "required": true,
+          "multiple": false
+        }
+      },
+      "args": {
+        "url": {
+          "name": "url",
+          "required": true
+        }
+      }
+    },
+    "drains": {
+      "id": "drains",
+      "description": "display the log drains of an app",
+      "strict": true,
+      "pluginName": "heroku",
+      "pluginAlias": "heroku",
+      "pluginType": "core",
+      "aliases": [],
+      "flags": {
+        "app": {
+          "name": "app",
+          "type": "option",
+          "char": "a",
+          "description": "app to run command against",
+          "required": true,
+          "multiple": false
+        },
+        "extended": {
+          "name": "extended",
+          "type": "boolean",
+          "char": "x",
+          "hidden": true,
+          "allowNo": false
+        },
+        "json": {
+          "name": "json",
+          "type": "boolean",
+          "description": "output in json format",
+          "allowNo": false
+        }
+      },
+      "args": {}
+    },
+    "drains:remove": {
+      "id": "drains:remove",
+      "description": "removes a log drain from an app",
+      "strict": true,
+      "pluginName": "heroku",
+      "pluginAlias": "heroku",
+      "pluginType": "core",
+      "aliases": [],
+      "examples": "drains:remove [URL|TOKEN]",
+      "flags": {
+        "app": {
+          "name": "app",
+          "type": "option",
+          "char": "a",
+          "description": "app to run command against",
+          "required": true,
+          "multiple": false
         }
       },
       "args": {
-        "hostname": {
-          "name": "hostname"
+        "url": {
+          "name": "url",
+          "required": true
         }
-      }
+      },
+      "example": "drains:remove [URL|TOKEN]"
     },
     "git:clone": {
       "id": "git:clone",
@@ -3080,6 +3664,127 @@
         }
       }
     },
+    "apps:favorites:add": {
+      "id": "apps:favorites:add",
+      "description": "favorites an app",
+      "strict": true,
+      "pluginName": "heroku",
+      "pluginAlias": "heroku",
+      "pluginType": "core",
+      "aliases": [],
+      "flags": {
+        "app": {
+          "name": "app",
+          "type": "option",
+          "char": "a",
+          "description": "app to run command against",
+          "required": true,
+          "multiple": false
+        }
+      },
+      "args": {},
+      "topic": "apps"
+    },
+    "apps:favorites": {
+      "id": "apps:favorites",
+      "description": "list favorited apps",
+      "strict": true,
+      "pluginName": "heroku",
+      "pluginAlias": "heroku",
+      "pluginType": "core",
+      "aliases": [],
+      "flags": {
+        "json": {
+          "name": "json",
+          "type": "boolean",
+          "char": "j",
+          "description": "output in json format",
+          "allowNo": false
+        }
+      },
+      "args": {},
+      "topic": "apps"
+    },
+    "apps:favorites:remove": {
+      "id": "apps:favorites:remove",
+      "description": "unfavorites an app",
+      "strict": true,
+      "pluginName": "heroku",
+      "pluginAlias": "heroku",
+      "pluginType": "core",
+      "aliases": [],
+      "flags": {
+        "app": {
+          "name": "app",
+          "type": "option",
+          "char": "a",
+          "description": "app to run command against",
+          "required": true,
+          "multiple": false
+        }
+      },
+      "args": {},
+      "topic": "apps"
+    },
+    "apps:stacks": {
+      "id": "apps:stacks",
+      "description": "show the list of available stacks",
+      "strict": true,
+      "pluginName": "heroku",
+      "pluginAlias": "heroku",
+      "pluginType": "core",
+      "aliases": [
+        "stack"
+      ],
+      "flags": {
+        "app": {
+          "name": "app",
+          "type": "option",
+          "char": "a",
+          "description": "app to run command against",
+          "required": true,
+          "multiple": false
+        }
+      },
+      "args": {},
+      "topic": "apps"
+    },
+    "apps:stacks:set": {
+      "id": "apps:stacks:set",
+      "description": "set the stack of an app",
+      "strict": true,
+      "pluginName": "heroku",
+      "pluginAlias": "heroku",
+      "pluginType": "core",
+      "aliases": [
+        "stack:set"
+      ],
+      "examples": "$ heroku stack:set heroku-22 -a myapp\nSetting stack to heroku-22... 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": {
+          "name": "app",
+          "type": "option",
+          "char": "a",
+          "description": "app to run command against",
+          "required": true,
+          "multiple": false
+        },
+        "remote": {
+          "name": "remote",
+          "type": "option",
+          "char": "r",
+          "description": "git remote of app to use",
+          "multiple": false
+        }
+      },
+      "args": {
+        "stack": {
+          "name": "stack",
+          "required": true
+        }
+      },
+      "example": "$ heroku stack:set heroku-22 -a myapp\nSetting stack to heroku-22... 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."
+    },
     "auth:2fa:disable": {
       "id": "auth:2fa:disable",
       "description": "disables 2fa on account",
@@ -3130,6 +3835,169 @@
       },
       "args": {}
     },
+    "ci:config:get": {
+      "id": "ci:config:get",
+      "description": "get a CI config var",
+      "strict": true,
+      "pluginName": "heroku",
+      "pluginAlias": "heroku",
+      "pluginType": "core",
+      "aliases": [],
+      "examples": [
+        "$ heroku ci:config:get --pipeline=PIPELINE RAILS_ENV\n    test"
+      ],
+      "flags": {
+        "help": {
+          "name": "help",
+          "type": "boolean",
+          "char": "h",
+          "description": "Show CLI help.",
+          "allowNo": false
+        },
+        "app": {
+          "name": "app",
+          "type": "option",
+          "char": "a",
+          "description": "app to run command against",
+          "required": false,
+          "multiple": false
+        },
+        "pipeline": {
+          "name": "pipeline",
+          "type": "option",
+          "char": "p",
+          "description": "name of pipeline",
+          "required": false,
+          "multiple": false
+        },
+        "shell": {
+          "name": "shell",
+          "type": "boolean",
+          "char": "s",
+          "description": "output config var in shell format",
+          "allowNo": false
+        }
+      },
+      "args": {
+        "key": {
+          "name": "key",
+          "required": true
+        }
+      },
+      "topic": "ci"
+    },
+    "ci:config": {
+      "id": "ci:config",
+      "description": "display CI config vars",
+      "strict": true,
+      "pluginName": "heroku",
+      "pluginAlias": "heroku",
+      "pluginType": "core",
+      "aliases": [],
+      "examples": [
+        "$ heroku ci:config --app murmuring-headland-14719 --json\n"
+      ],
+      "flags": {
+        "app": {
+          "name": "app",
+          "type": "option",
+          "char": "a",
+          "description": "app name",
+          "multiple": false
+        },
+        "shell": {
+          "name": "shell",
+          "type": "boolean",
+          "char": "s",
+          "description": "output config vars in shell format",
+          "allowNo": false
+        },
+        "json": {
+          "name": "json",
+          "type": "boolean",
+          "description": "output config vars in json format",
+          "allowNo": false
+        },
+        "pipeline": {
+          "name": "pipeline",
+          "type": "option",
+          "char": "p",
+          "description": "name of pipeline",
+          "multiple": false
+        }
+      },
+      "args": {}
+    },
+    "ci:config:set": {
+      "id": "ci:config:set",
+      "description": "set CI config vars",
+      "strict": false,
+      "pluginName": "heroku",
+      "pluginAlias": "heroku",
+      "pluginType": "core",
+      "aliases": [],
+      "examples": [
+        "$ heroku ci:config:set --pipeline PIPELINE RAILS_ENV=test\n    Setting test config vars... done\n    RAILS_ENV: test"
+      ],
+      "flags": {
+        "app": {
+          "name": "app",
+          "type": "option",
+          "char": "a",
+          "description": "app to run command against",
+          "multiple": false
+        },
+        "pipeline": {
+          "name": "pipeline",
+          "type": "option",
+          "char": "p",
+          "description": "name of pipeline",
+          "required": true,
+          "multiple": false
+        }
+      },
+      "args": {},
+      "topic": "ci"
+    },
+    "ci:config:unset": {
+      "id": "ci:config:unset",
+      "description": "unset CI config vars",
+      "strict": false,
+      "pluginName": "heroku",
+      "pluginAlias": "heroku",
+      "pluginType": "core",
+      "aliases": [],
+      "examples": [
+        "$ heroku ci:config:unset RAILS_ENV"
+      ],
+      "flags": {
+        "help": {
+          "name": "help",
+          "type": "boolean",
+          "char": "h",
+          "description": "Show CLI help.",
+          "allowNo": false
+        },
+        "app": {
+          "name": "app",
+          "type": "option",
+          "char": "a",
+          "description": "app to run command against",
+          "required": false,
+          "multiple": false
+        },
+        "pipeline": {
+          "name": "pipeline",
+          "type": "option",
+          "char": "p",
+          "description": "name of pipeline",
+          "required": false,
+          "multiple": false
+        }
+      },
+      "args": {},
+      "topic": "ci"
+    },
     "ps:autoscale:disable": {
       "id": "ps:autoscale:disable",
       "description": "disable web dyno autoscaling",