heroku 10.0.0-alpha.0 → 10.0.0-alpha.2

package/oclif.manifest.json

@@ -81,8 +81,8 @@
       "examples": [
         "heroku logs --app=my-app",
         "heroku logs --num=50 --app=my-app",
-        "heroku logs --dyno=web-123-456 --app=my-app",
-        "heroku logs --type=web --app=my-app",
+        "heroku logs --dyno-name=web-123-456 --app=my-app",
+        "heroku logs --process-type=web --app=my-app",
         "heroku logs --app=my-app --tail"
       ],
       "flags": {
@@ -95,10 +95,13 @@
           "multiple": false,
           "type": "option"
         },
-        "dyno": {
+        "dyno-name": {
+          "aliases": [
+            "dyno"
+          ],
           "char": "d",
           "description": "only show output from this dyno (such as \"web-123-456\" or \"worker.2\")",
-          "name": "dyno",
+          "name": "dyno-name",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -140,7 +143,7 @@
             {
               "type": "none",
               "flags": [
-                "dyno"
+                "dyno-name"
               ]
             }
           ],
@@ -171,14 +174,15 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "type": {
+        "process-type": {
+          "char": "p",
           "description": "only show output from this process type (such as \"web\" or \"worker\")",
-          "name": "type",
+          "name": "process-type",
           "relationships": [
             {
               "type": "none",
               "flags": [
-                "dyno",
+                "dyno-name",
                 "ps"
               ]
             }
@@ -337,6 +341,7 @@
       "aliases": [],
       "args": {
         "email": {
+          "description": "email address of the team member",
           "name": "email",
           "required": true
         }
@@ -478,6 +483,7 @@
       "aliases": [],
       "args": {
         "email": {
+          "description": "email address of the team member",
           "name": "email",
           "required": true
         }
@@ -1058,6 +1064,7 @@
       "aliases": [],
       "args": {
         "path": {
+          "description": "base URL path of app",
           "name": "path",
           "required": false
         }
@@ -1108,6 +1115,7 @@
       "aliases": [],
       "args": {
         "newname": {
+          "description": "new unique name of the app",
           "name": "newname",
           "required": true
         }
@@ -1269,6 +1277,7 @@
       "aliases": [],
       "args": {
         "addon_name": {
+          "description": "unique identifier or globally unique name of the add-on",
           "name": "addon_name",
           "required": true
         }
@@ -1334,6 +1343,7 @@
       "aliases": [],
       "args": {
         "service:plan": {
+          "description": "unique identifier or unique name of the add-on service plan",
           "name": "service:plan",
           "required": true
         }
@@ -1409,6 +1419,7 @@
       "aliases": [],
       "args": {
         "addonName": {
+          "description": "unique identifier or globally unique name of the add-on",
           "name": "addonName",
           "required": true
         }
@@ -1477,6 +1488,7 @@
       "aliases": [],
       "args": {
         "attachment_name": {
+          "description": "unique identifier of the add-on attachment",
           "name": "attachment_name",
           "required": true
         }
@@ -1521,6 +1533,7 @@
       "aliases": [],
       "args": {
         "addon": {
+          "description": "unique identifier or globally unique name of the add-on",
           "name": "addon",
           "required": true
         }
@@ -1626,6 +1639,7 @@
       "aliases": [],
       "args": {
         "addon": {
+          "description": "unique identifier or globally unique name of the add-on",
           "name": "addon",
           "required": true
         }
@@ -1670,6 +1684,7 @@
       "aliases": [],
       "args": {
         "addon": {
+          "description": "unique identifier or globally unique name of the add-on",
           "name": "addon",
           "required": true
         }
@@ -1719,6 +1734,7 @@
       "aliases": [],
       "args": {
         "service": {
+          "description": "unique identifier or globally unique name of the add-on",
           "name": "service",
           "required": true
         }
@@ -1752,10 +1768,12 @@
       "aliases": [],
       "args": {
         "addon_name": {
+          "description": "unique identifier or globally unique name of the add-on",
           "name": "addon_name",
           "required": true
         },
         "new_name": {
+          "description": "new globally unique name of the add-on",
           "name": "new_name",
           "required": true
         }
@@ -1812,10 +1830,12 @@
       ],
       "args": {
         "addon": {
+          "description": "unique identifier or globally unique name of the add-on",
           "name": "addon",
           "required": true
         },
         "plan": {
+          "description": "unique identifier or name of the plan",
           "name": "plan"
         }
       },
@@ -1861,6 +1881,7 @@
       "aliases": [],
       "args": {
         "addon": {
+          "description": "unique identifier or globally unique name of the add-on",
           "name": "addon"
         }
       },
@@ -2128,6 +2149,7 @@
       "aliases": [],
       "args": {
         "id": {
+          "description": "ID of the authorization",
           "name": "id",
           "required": true
         }
@@ -2164,6 +2186,7 @@
       ],
       "args": {
         "id": {
+          "description": "ID of the authorization",
           "name": "id",
           "required": true
         }
@@ -2192,6 +2215,7 @@
       "aliases": [],
       "args": {
         "id": {
+          "description": "ID of the authorization",
           "name": "id",
           "required": true
         }
@@ -2217,6 +2241,7 @@
       "aliases": [],
       "args": {
         "id": {
+          "description": "ID of the authorization",
           "name": "id",
           "required": true
         }
@@ -2758,10 +2783,12 @@
       "aliases": [],
       "args": {
         "CRT": {
+          "description": "absolute path of the certificate file on disk",
           "name": "CRT",
           "required": true
         },
         "KEY": {
+          "description": "absolute path of the key file on disk",
           "name": "KEY",
           "required": true
         }
@@ -2809,6 +2836,7 @@
       "aliases": [],
       "args": {
         "domain": {
+          "description": "domain name to generate",
           "name": "domain",
           "required": true
         }
@@ -3068,10 +3096,12 @@
       "aliases": [],
       "args": {
         "CRT": {
+          "description": "absolute path of the certificate file on disk",
           "name": "CRT",
           "required": true
         },
         "KEY": {
+          "description": "absolute path of the key file on disk",
           "name": "KEY",
           "required": true
         }
@@ -3254,6 +3284,7 @@
       "aliases": [],
       "args": {
         "test-run": {
+          "description": "auto-incremented test run number",
           "name": "test-run",
           "required": true
         }
@@ -3455,6 +3486,7 @@
       "aliases": [],
       "args": {
         "number": {
+          "description": "auto-incremented test run number",
           "name": "number",
           "required": false
         }
@@ -3558,10 +3590,12 @@
       "aliases": [],
       "args": {
         "name": {
+          "description": "name of the OAuth client",
           "name": "name",
           "required": true
         },
         "redirect_uri": {
+          "description": "redirect URL of the OAuth client",
           "name": "redirect_uri",
           "required": true
         }
@@ -3605,6 +3639,7 @@
       "aliases": [],
       "args": {
         "id": {
+          "description": "ID of the OAuth client",
           "name": "id",
           "required": true
         }
@@ -3658,6 +3693,7 @@
       "aliases": [],
       "args": {
         "id": {
+          "description": "ID of the OAuth client",
           "name": "id",
           "required": true
         }
@@ -3701,6 +3737,7 @@
       "aliases": [],
       "args": {
         "id": {
+          "description": "ID of the OAuth client",
           "name": "id",
           "required": true
         }
@@ -3741,6 +3778,7 @@
       "aliases": [],
       "args": {
         "id": {
+          "description": "ID of the OAuth client",
           "name": "id",
           "required": true
         }
@@ -3834,6 +3872,7 @@
       "aliases": [],
       "args": {
         "KEY": {
+          "description": "key name of the config var value",
           "name": "KEY",
           "required": true
         }
@@ -4372,6 +4411,7 @@
       "aliases": [],
       "args": {
         "hostname": {
+          "description": "unique identifier of the domain or full hostname",
           "name": "hostname",
           "required": true
         }
@@ -4617,6 +4657,7 @@
       "aliases": [],
       "args": {
         "hostname": {
+          "description": "unique identifier of the domain or full hostname",
           "name": "hostname",
           "required": true
         }
@@ -4670,6 +4711,7 @@
       "aliases": [],
       "args": {
         "hostname": {
+          "description": "unique identifier of the domain or full hostname",
           "name": "hostname",
           "required": true
         }
@@ -4723,6 +4765,7 @@
       "aliases": [],
       "args": {
         "hostname": {
+          "description": "unique identifier of the domain or full hostname",
           "name": "hostname",
           "required": true
         }
@@ -4784,6 +4827,7 @@
       "aliases": [],
       "args": {
         "hostname": {
+          "description": "unique identifier of the domain or full hostname",
           "name": "hostname"
         }
       },
@@ -4833,6 +4877,7 @@
       "aliases": [],
       "args": {
         "url": {
+          "description": "URL of the log drain",
           "name": "url",
           "required": true
         }
@@ -4927,6 +4972,7 @@
       "aliases": [],
       "args": {
         "url": {
+          "description": "URL of the log drain",
           "name": "url",
           "required": true
         }
@@ -4972,6 +5018,7 @@
       "aliases": [],
       "args": {
         "feature": {
+          "description": "unique identifier or name of the app feature",
           "name": "feature",
           "required": true
         }
@@ -5015,6 +5062,7 @@
       "aliases": [],
       "args": {
         "feature": {
+          "description": "unique identifier or name of the app feature",
           "name": "feature",
           "required": true
         }
@@ -5102,6 +5150,7 @@
       "aliases": [],
       "args": {
         "feature": {
+          "description": "unique identifier or name of the app feature",
           "name": "feature",
           "required": true
         }
@@ -5197,6 +5246,7 @@
       "aliases": [],
       "args": {
         "command": {
+          "description": "command name of the git credentials",
           "name": "command",
           "required": true
         }
@@ -5262,6 +5312,7 @@
       "aliases": [],
       "args": {
         "key": {
+          "description": "absolute path to the key located on disk. If omitted, we use the default rsa key.",
           "name": "key"
         }
       },
@@ -5357,6 +5408,7 @@
       "aliases": [],
       "args": {
         "key": {
+          "description": "email address of the user",
           "name": "key",
           "required": true
         }
@@ -5384,6 +5436,7 @@
       "aliases": [],
       "args": {
         "feature": {
+          "description": "unique identifier or name of the account feature",
           "name": "feature",
           "required": true
         }
@@ -5433,6 +5486,7 @@
       "aliases": [],
       "args": {
         "feature": {
+          "description": "unique identifier or name of the account feature",
           "name": "feature",
           "required": true
         }
@@ -5523,6 +5577,7 @@
       "aliases": [],
       "args": {
         "feature": {
+          "description": "unique identifier or name of the account feature",
           "name": "feature",
           "required": true
         }
@@ -5576,6 +5631,7 @@
       ],
       "args": {
         "processname": {
+          "description": "name of the process",
           "name": "processname",
           "required": false
         }
@@ -5821,6 +5877,7 @@
       "aliases": [],
       "args": {
         "email": {
+          "description": "email address of the team member",
           "name": "email",
           "required": true
         }
@@ -6117,6 +6174,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -6160,6 +6218,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -6203,10 +6262,12 @@
       "aliases": [],
       "args": {
         "source": {
+          "description": "config var exposed to the owning app containing the source database URL",
           "name": "source",
           "required": true
         },
         "target": {
+          "description": "config var exposed to the owning app containing the target database URL",
           "name": "target",
           "required": true
         }
@@ -6269,6 +6330,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -6312,6 +6374,7 @@
       "aliases": [],
       "args": {
         "DATABASE|REPORT_ID": {
+          "description": "config var exposed to the owning app containing the database URL or the report ID",
           "name": "DATABASE|REPORT_ID"
         }
       },
@@ -6363,6 +6426,7 @@
       ],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use all databases.",
           "name": "database"
         }
       },
@@ -6406,10 +6470,12 @@
       "aliases": [],
       "args": {
         "pid": {
+          "description": "ID of the process",
           "name": "pid",
           "required": true
         },
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -6459,6 +6525,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -6502,6 +6569,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -6552,6 +6620,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -6616,6 +6685,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::`",
           "name": "database",
           "required": true
         }
@@ -6666,6 +6736,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -6717,6 +6788,7 @@
       ],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -6782,10 +6854,12 @@
       "aliases": [],
       "args": {
         "source": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "source",
           "required": true
         },
         "target": {
+          "description": "PostgreSQL connection string for the target database",
           "name": "target",
           "required": true
         }
@@ -6841,10 +6915,12 @@
       "aliases": [],
       "args": {
         "source": {
+          "description": "PostgreSQL connection string for the source database",
           "name": "source",
           "required": true
         },
         "target": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "target",
           "required": true
         }
@@ -6900,6 +6976,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -6958,6 +7035,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::`",
           "name": "database",
           "required": true
         }
@@ -7009,6 +7087,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -7067,6 +7146,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -7110,6 +7190,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use all databases.",
           "name": "database"
         }
       },
@@ -7826,15 +7907,16 @@
       ],
       "args": {
         "dyno": {
+          "description": "name of the dyno to restart",
           "name": "dyno",
           "required": false
         }
       },
-      "description": "restart app dynos",
+      "description": "restart an app dyno or process type\nif neither --dyno nor --type are specified, restarts all dynos on app\n",
       "examples": [
-        "$ heroku ps:restart web.1",
-        "$ heroku ps:restart web",
-        "$ heroku ps:restart"
+        "$ heroku ps:restart --app myapp --dyno-name web.1",
+        "$ heroku ps:restart --app myapp --process-type web",
+        "$ heroku ps:restart --app myapp"
       ],
       "flags": {
         "app": {
@@ -7853,6 +7935,25 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "dyno-name": {
+          "char": "d",
+          "description": "name of the dyno to restart",
+          "name": "dyno-name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "process-type": {
+          "char": "p",
+          "description": "name of the process type to restart",
+          "exclusive": [
+            "dyno-name"
+          ],
+          "name": "process-type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -7865,7 +7966,6 @@
       "pluginType": "core",
       "strict": true,
       "topic": "ps",
-      "help": "if DYNO is not specified, restarts all dynos on app",
       "isESM": false,
       "relativePath": [
         "lib",
@@ -7928,14 +8028,15 @@
       ],
       "args": {
         "dyno": {
+          "description": "name of the dyno to stop",
           "name": "dyno",
-          "required": true
+          "required": false
         }
       },
-      "description": "stop app dyno",
+      "description": "stop an app dyno or process type",
       "examples": [
-        "$ heroku ps:stop run.1828",
-        "$ heroku ps:stop run"
+        "$ heroku ps:stop --app myapp --dyno-name run.1828",
+        "$ heroku ps:stop --app myapp --process-type run"
       ],
       "flags": {
         "app": {
@@ -7954,6 +8055,25 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "dyno-name": {
+          "char": "d",
+          "description": "name of the dyno to stop",
+          "name": "dyno-name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "process-type": {
+          "char": "p",
+          "description": "name of the process type to stop",
+          "exclusive": [
+            "dyno-name"
+          ],
+          "name": "process-type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -7967,7 +8087,6 @@
       "pluginType": "core",
       "strict": true,
       "topic": "ps",
-      "help": "stop app dyno or dyno type",
       "isESM": false,
       "relativePath": [
         "lib",
@@ -8089,6 +8208,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app.",
           "name": "database"
         }
       },
@@ -8143,6 +8263,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app.",
           "name": "database",
           "required": false
         }
@@ -8195,6 +8316,7 @@
       ],
       "args": {
         "database": {
+          "description": "name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app.",
           "name": "database"
         }
       },
@@ -8245,6 +8367,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app.",
           "name": "database"
         }
       },
@@ -8297,6 +8420,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app.",
           "name": "database",
           "required": false
         }
@@ -8365,6 +8489,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app.",
           "name": "database"
         }
       },
@@ -8417,6 +8542,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app.",
           "name": "database",
           "required": false
         }
@@ -8461,6 +8587,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app.",
           "name": "database"
         }
       },
@@ -8511,6 +8638,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app.",
           "name": "database"
         }
       },
@@ -8563,6 +8691,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app.",
           "name": "database"
         }
       },
@@ -8621,6 +8750,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app.",
           "name": "database",
           "required": false
         }
@@ -8737,6 +8867,7 @@
       "aliases": [],
       "args": {
         "release": {
+          "description": "ID of the release. If omitted, we use the last release ID.",
           "name": "release"
         }
       },
@@ -8793,6 +8924,7 @@
       "aliases": [],
       "args": {
         "release": {
+          "description": "ID of the release. If omitted, we use the last release ID.",
           "name": "release"
         }
       },
@@ -8836,10 +8968,11 @@
       "aliases": [],
       "args": {
         "release": {
+          "description": "ID of the release. If omitted, we use the last eligible release.",
           "name": "release"
         }
       },
-      "description": "Roll back to a previous release.\n\n    If RELEASE is not specified, it will roll back one release.\n    ",
+      "description": "Roll back to a previous release.\n\n    If RELEASE is not specified, it will roll back to the last eligible release.\n    ",
       "flags": {
         "remote": {
           "char": "r",
@@ -9254,6 +9387,7 @@
       "aliases": [],
       "args": {
         "id": {
+          "description": "ID of the OAuth session",
           "name": "id",
           "required": true
         }
@@ -9313,7 +9447,7 @@
       },
       "description": "create a new space\n",
       "examples": [
-        "Example:\n\n$ heroku spaces:create --space my-space --team my-team --region oregon\nCreating space my-space in team my-team... done\n=== my-space\nID:         e7b99e37-69b3-4475-ad47-a5cc5d75fd9f\nTeam:       my-team\nRegion:     oregon\nCIDR:       10.0.0.0/16\nData CIDR:  172.23.0.0/20\nState:      allocating\nCreated at: 2016-01-06T03:23:13Z\n"
+        "Example:\n\n$ heroku spaces:create --space my-space --team my-team --region oregon\nCreating space my-space in team my-team... done\n=== my-space\nID:         e7b99e37-69b3-4475-ad47-a5cc5d75fd9f\nTeam:       my-team\nRegion:     oregon\nCIDR:       10.0.0.0/16\nData CIDR:  172.23.0.0/20\nState:      allocating\nGeneration: cedar\nCreated at: 2016-01-06T03:23:13Z\n"
       ],
       "flags": {
         "channel": {
@@ -9337,6 +9471,14 @@
           "multiple": false,
           "type": "option"
         },
+        "features": {
+          "description": "a list of features separated by commas",
+          "hidden": true,
+          "name": "features",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "generation": {
           "description": "generation for space",
           "name": "generation",
@@ -9841,7 +9983,7 @@
         }
       },
       "description": "Add and configure a new telemetry drain. Defaults to collecting all telemetry unless otherwise specified.",
-      "examples": "Add a telemetry drain to an app to collect logs and traces:\n$ heroku telemetry:add --signals logs,traces --endpoint https://my-endpoint.com --transport http 'x-drain-example-team: API_KEY x-drain-example-dataset: METRICS_DATASET'\n",
+      "examples": "Add a telemetry drain to an app to collect logs and traces:\n$ heroku telemetry:add --app myapp --signals logs,traces --endpoint https://my-endpoint.com --transport http '{\"x-drain-example-team\": \"API_KEY\", \"x-drain-example-dataset\": \"METRICS_DATASET\"}'\n",
       "flags": {
         "app": {
           "char": "a",
@@ -9903,7 +10045,7 @@
       "pluginName": "heroku",
       "pluginType": "core",
       "strict": true,
-      "example": "Add a telemetry drain to an app to collect logs and traces:\n$ heroku telemetry:add --signals logs,traces --endpoint https://my-endpoint.com --transport http 'x-drain-example-team: API_KEY x-drain-example-dataset: METRICS_DATASET'\n",
+      "example": "Add a telemetry drain to an app to collect logs and traces:\n$ heroku telemetry:add --app myapp --signals logs,traces --endpoint https://my-endpoint.com --transport http '{\"x-drain-example-team\": \"API_KEY\", \"x-drain-example-dataset\": \"METRICS_DATASET\"}'\n",
       "isESM": false,
       "relativePath": [
         "lib",
@@ -10228,6 +10370,7 @@
       "aliases": [],
       "args": {
         "id": {
+          "description": "ID of the webhook",
           "name": "id",
           "required": true
         }
@@ -10340,6 +10483,7 @@
       "aliases": [],
       "args": {
         "id": {
+          "description": "ID of the webhook",
           "name": "id",
           "required": true
         }
@@ -10589,6 +10733,7 @@
       "aliases": [],
       "args": {
         "stack": {
+          "description": "unique name or identifier of the stack",
           "name": "stack",
           "required": true
         }
@@ -10897,6 +11042,7 @@
       "aliases": [],
       "args": {
         "key": {
+          "description": "name of the config var key",
           "name": "key",
           "required": true
         }
@@ -11128,6 +11274,7 @@
       "aliases": [],
       "args": {
         "backup_id": {
+          "description": "ID of the backup. If omitted, we use the last unfinished backup ID.",
           "name": "backup_id"
         }
       },
@@ -11172,6 +11319,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -11228,6 +11376,7 @@
       "aliases": [],
       "args": {
         "backup_id": {
+          "description": "ID of the backup",
           "name": "backup_id",
           "required": true
         }
@@ -11283,6 +11432,7 @@
       "aliases": [],
       "args": {
         "backup_id": {
+          "description": "ID of the backup. If omitted, we use the last backup ID.",
           "name": "backup_id"
         }
       },
@@ -11419,6 +11569,7 @@
       "aliases": [],
       "args": {
         "backup_id": {
+          "description": "ID of the backup. If omitted, we use the last backup ID.",
           "name": "backup_id"
         }
       },
@@ -11463,13 +11614,23 @@
       "aliases": [],
       "args": {
         "backup": {
+          "description": "URL or backup ID from another app",
           "name": "backup"
         },
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
       "description": "restore a backup (default latest) to a database",
+      "examples": [
+        "# Basic Restore from Backup ID\n$ heroku pg:backups:restore b101 DATABASE_URL --app my-heroku-app\n",
+        "# Restore from Another App\n$ heroku pg:backups:restore example-app::b101 DATABASE_URL --app my-heroku-app\n",
+        "# Restore from a Public URL\n$ heroku pg:backups:restore 'https://s3.amazonaws.com/my-bucket/mydb.dump' DATABASE_URL --app my-heroku-app\n",
+        "# Verbose Output\n$ heroku pg:backups:restore b101 DATABASE_URL --app my-heroku-app --verbose\n",
+        "# Restore with Confirmation Prompt\n$ heroku pg:backups:restore b101 DATABASE_URL --app my-heroku-app --confirm my-heroku-app\n",
+        "# Restore with a Specific Database Name\n$ heroku pg:backups:restore b101 HEROKU_POSTGRESQL_PINK --app my-heroku-app\n"
+      ],
       "flags": {
         "wait-interval": {
           "name": "wait-interval",
@@ -11538,6 +11699,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -11630,6 +11792,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use a random database attached to the app.",
           "name": "database"
         }
       },
@@ -11674,6 +11837,7 @@
       "aliases": [],
       "args": {
         "backup_id": {
+          "description": "ID of the backup. If omitted, we use the last backup ID.",
           "name": "backup_id"
         }
       },
@@ -11718,6 +11882,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -11772,6 +11937,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -11825,6 +11991,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -11887,6 +12054,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -11940,6 +12108,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -12014,6 +12183,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -12067,10 +12237,12 @@
       "aliases": [],
       "args": {
         "remote": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::`",
           "name": "remote",
           "required": true
         },
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::`",
           "name": "database",
           "required": true
         }
@@ -12123,10 +12295,12 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::`",
           "name": "database",
           "required": true
         },
         "link": {
+          "description": "name of the linked data store",
           "name": "link",
           "required": true
         }
@@ -12181,6 +12355,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -12225,6 +12400,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -12269,6 +12445,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -12319,10 +12496,12 @@
       "aliases": [],
       "args": {
         "window": {
+          "description": "timestamp of the maintenance window",
           "name": "window",
           "required": true
         },
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -12369,9 +12548,11 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         },
         "value": {
+          "description": "boolean indicating if execution plans of queries will be logged for future connections",
           "name": "value"
         }
       },
@@ -12416,9 +12597,11 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         },
         "value": {
+          "description": "boolean indicating if data replication slot details get logged",
           "name": "value"
         }
       },
@@ -12462,6 +12645,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         }
       },
@@ -12506,9 +12690,11 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         },
         "value": {
+          "description": "boolean indicating if database login attempts get logged",
           "name": "value"
         }
       },
@@ -12552,9 +12738,11 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         },
         "value": {
+          "description": "boolean indicating if a message gets logged when a session waits longer than the deadlock_timeout to acquire a lock",
           "name": "value"
         }
       },
@@ -12598,9 +12786,11 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         },
         "value": {
+          "description": "milliseconds to wait for a statement to complete before logging it",
           "name": "value"
         }
       },
@@ -12644,6 +12834,7 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         },
         "value": {
@@ -12696,9 +12887,11 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         },
         "value": {
+          "description": "type of SQL statements to log\n<options: none|ddl|mod|all>",
           "name": "value",
           "options": [
             "none",
@@ -12748,9 +12941,11 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         },
         "value": {
+          "description": "function type to track\n<options: none|pl|all>",
           "name": "value",
           "options": [
             "none",
@@ -12949,6 +13144,7 @@
       ],
       "args": {
         "url": {
+          "description": "URL to replace the log drain with",
           "name": "url",
           "required": true
         }
@@ -13181,6 +13377,7 @@
       "aliases": [],
       "args": {
         "source": {
+          "description": "IP address in CIDR notation",
           "name": "source",
           "required": true
         }
@@ -13274,6 +13471,7 @@
       "aliases": [],
       "args": {
         "source": {
+          "description": "IP address in CIDR notation",
           "name": "source",
           "required": true
         }
@@ -13733,6 +13931,7 @@
       "aliases": [],
       "args": {
         "id": {
+          "description": "ID of the webhook event",
           "name": "id",
           "required": true
         }
@@ -13838,6 +14037,7 @@
       "aliases": [],
       "args": {
         "id": {
+          "description": "ID of the webhook event",
           "name": "id",
           "required": true
         }
@@ -13893,9 +14093,11 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         },
         "value": {
+          "description": "boolean indicating if execution plans get logged",
           "name": "value"
         }
       },
@@ -13940,9 +14142,11 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         },
         "value": {
+          "description": "boolean indicating if the database has buffer statistics enabled",
           "name": "value"
         }
       },
@@ -13987,9 +14191,11 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         },
         "value": {
+          "description": "format of the log output\n<options: text|json|yaml|xml>",
           "name": "value",
           "options": [
             "text",
@@ -14040,9 +14246,11 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         },
         "value": {
+          "description": "minimum duration in milliseconds for queries before logging execution plans. A value of -1 disables it. A value of 0 logs all query execution plans.",
           "name": "value"
         }
       },
@@ -14087,9 +14295,11 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         },
         "value": {
+          "description": "boolean indicating if execution plan logs include nested statements",
           "name": "value"
         }
       },
@@ -14134,9 +14344,11 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         },
         "value": {
+          "description": "boolean indicating if the database has trigger execution statistics enabled",
           "name": "value"
         }
       },
@@ -14181,9 +14393,11 @@
       "aliases": [],
       "args": {
         "database": {
+          "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
           "name": "database"
         },
         "value": {
+          "description": "boolean indicating if the database has verbose execution plan logging enabled",
           "name": "value"
         }
       },
@@ -14225,5 +14439,5 @@
       ]
     }
   },
-  "version": "10.0.0-alpha.0"
+  "version": "10.0.0-alpha.2"
 }