heroku 10.0.0-alpha.1 → 10.0.0-beta.0

package/lib/commands/pg/settings/auto-explain.js

@@ -4,6 +4,7 @@ const command_1 = require("@heroku-cli/command");
 const core_1 = require("@oclif/core");
 const tsheredoc_1 = require("tsheredoc");
 const setter_1 = require("../../../lib/pg/setter");
+const nls_1 = require("../../../nls");
 // ref: https://www.postgresql.org/docs/current/auto-explain.html
 class AutoExplain extends setter_1.PGSettingsCommand {
     constructor() {
@@ -32,7 +33,7 @@ AutoExplain.flags = {
     remote: command_1.flags.remote(),
 };
 AutoExplain.args = {
-    database: core_1.Args.string(),
-    value: core_1.Args.string(),
+    database: core_1.Args.string({ description: `${(0, nls_1.nls)('pg:database:arg:description')} ${(0, nls_1.nls)('pg:database:arg:description:default:suffix')}` }),
+    value: core_1.Args.string({ description: 'boolean indicating if execution plans of queries will be logged for future connections' }),
 };
 AutoExplain.strict = false;

package/lib/commands/pg/settings/explain-data-connector-details.js

@@ -4,6 +4,7 @@ const command_1 = require("@heroku-cli/command");
 const core_1 = require("@oclif/core");
 const tsheredoc_1 = require("tsheredoc");
 const setter_1 = require("../../../lib/pg/setter");
+const nls_1 = require("../../../nls");
 class ExplainDataConnectorDetails extends setter_1.PGSettingsCommand {
     constructor() {
         super(...arguments);
@@ -28,6 +29,6 @@ ExplainDataConnectorDetails.flags = {
     remote: command_1.flags.remote(),
 };
 ExplainDataConnectorDetails.args = {
-    database: core_1.Args.string(),
-    value: core_1.Args.string(),
+    database: core_1.Args.string({ description: `${(0, nls_1.nls)('pg:database:arg:description')} ${(0, nls_1.nls)('pg:database:arg:description:default:suffix')}` }),
+    value: core_1.Args.string({ description: 'boolean indicating if data replication slot details get logged' }),
 };

package/lib/commands/pg/settings/index.js

@@ -5,6 +5,7 @@ const core_1 = require("@oclif/core");
 const resolve_1 = require("../../../lib/addons/resolve");
 const util_1 = require("../../../lib/pg/util");
 const host_1 = require("../../../lib/pg/host");
+const nls_1 = require("../../../nls");
 class Index extends command_1.Command {
     async run() {
         const { flags, args } = await this.parse(Index);
@@ -30,5 +31,5 @@ Index.flags = {
     remote: command_1.flags.remote(),
 };
 Index.args = {
-    database: core_1.Args.string(),
+    database: core_1.Args.string({ description: `${(0, nls_1.nls)('pg:database:arg:description')} ${(0, nls_1.nls)('pg:database:arg:description:default:suffix')}` }),
 };

package/lib/commands/pg/settings/log-connections.js

@@ -4,6 +4,7 @@ const command_1 = require("@heroku-cli/command");
 const core_1 = require("@oclif/core");
 const tsheredoc_1 = require("tsheredoc");
 const setter_1 = require("../../../lib/pg/setter");
+const nls_1 = require("../../../nls");
 class LogConnections extends setter_1.PGSettingsCommand {
     constructor() {
         super(...arguments);
@@ -29,6 +30,6 @@ LogConnections.flags = {
     remote: command_1.flags.remote(),
 };
 LogConnections.args = {
-    database: core_1.Args.string(),
-    value: core_1.Args.string(),
+    database: core_1.Args.string({ description: `${(0, nls_1.nls)('pg:database:arg:description')} ${(0, nls_1.nls)('pg:database:arg:description:default:suffix')}` }),
+    value: core_1.Args.string({ description: 'boolean indicating if database login attempts get logged' }),
 };

package/lib/commands/pg/settings/log-lock-waits.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@oclif/core");
 const tsheredoc_1 = require("tsheredoc");
 const setter_1 = require("../../../lib/pg/setter");
+const nls_1 = require("../../../nls");
 class LogLockWaits extends setter_1.PGSettingsCommand {
     constructor() {
         super(...arguments);
@@ -26,6 +27,6 @@ LogLockWaits.description = (0, tsheredoc_1.default)(`
     Applications and their query patterns should try to avoid changes to many different tables within the same transaction.
   `);
 LogLockWaits.args = {
-    database: core_1.Args.string(),
-    value: core_1.Args.string(),
+    database: core_1.Args.string({ description: `${(0, nls_1.nls)('pg:database:arg:description')} ${(0, nls_1.nls)('pg:database:arg:description:default:suffix')}` }),
+    value: core_1.Args.string({ description: 'boolean indicating if a message gets logged when a session waits longer than the deadlock_timeout to acquire a lock' }),
 };

package/lib/commands/pg/settings/log-min-duration-statement.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@oclif/core");
 const tsheredoc_1 = require("tsheredoc");
 const setter_1 = require("../../../lib/pg/setter");
+const nls_1 = require("../../../nls");
 class LogMinDurationStatement extends setter_1.PGSettingsCommand {
     constructor() {
         super(...arguments);
@@ -28,6 +29,6 @@ LogMinDurationStatement.description = (0, tsheredoc_1.default)(`
     Setting log_min_duration_statement to zero prints all statement durations and -1 will disable logging statement durations.
   `);
 LogMinDurationStatement.args = {
-    database: core_1.Args.string(),
-    value: core_1.Args.string(),
+    database: core_1.Args.string({ description: `${(0, nls_1.nls)('pg:database:arg:description')} ${(0, nls_1.nls)('pg:database:arg:description:default:suffix')}` }),
+    value: core_1.Args.string({ description: 'milliseconds to wait for a statement to complete before logging it' }),
 };

package/lib/commands/pg/settings/log-min-error-statement.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@oclif/core");
 const tsheredoc_1 = require("tsheredoc");
 const setter_1 = require("../../../lib/pg/setter");
+const nls_1 = require("../../../nls");
 class LogMinErrorStatement extends setter_1.PGSettingsCommand {
     constructor() {
         super(...arguments);
@@ -22,6 +23,6 @@ LogMinErrorStatement.description = (0, tsheredoc_1.default)(`
     Use this setting to prevent logging SQL queries that contain sensitive information. Default is "error".
   `);
 LogMinErrorStatement.args = {
-    database: core_1.Args.string(),
+    database: core_1.Args.string({ description: `${(0, nls_1.nls)('pg:database:arg:description')} ${(0, nls_1.nls)('pg:database:arg:description:default:suffix')}` }),
     value: core_1.Args.string({ options: ['error', 'log', 'fatal', 'panic'] }),
 };

package/lib/commands/pg/settings/log-statement.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@oclif/core");
 const tsheredoc_1 = require("tsheredoc");
 const setter_1 = require("../../../lib/pg/setter");
+const nls_1 = require("../../../nls");
 class LogStatement extends setter_1.PGSettingsCommand {
     constructor() {
         super(...arguments);
@@ -25,6 +26,6 @@ LogStatement.description = (0, tsheredoc_1.default)(`
     all  - All statements are logged
   `);
 LogStatement.args = {
-    database: core_1.Args.string(),
-    value: core_1.Args.string({ options: ['none', 'ddl', 'mod', 'all'] }),
+    database: core_1.Args.string({ description: `${(0, nls_1.nls)('pg:database:arg:description')} ${(0, nls_1.nls)('pg:database:arg:description:default:suffix')}` }),
+    value: core_1.Args.string({ options: ['none', 'ddl', 'mod', 'all'], description: 'type of SQL statements to log\n<options: none|ddl|mod|all>' }),
 };

package/lib/commands/pg/settings/track-functions.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@oclif/core");
 const tsheredoc_1 = require("tsheredoc");
 const setter_1 = require("../../../lib/pg/setter");
+const nls_1 = require("../../../nls");
 // ref: https://www.postgresql.org/docs/current/runtime-config-statistics.html#GUC-TRACK-FUNCTIONS
 class TrackFunctions extends setter_1.PGSettingsCommand {
     constructor() {
@@ -24,6 +25,6 @@ TrackFunctions.description = (0, tsheredoc_1.default)(`
     pl   - Only procedural language functions are tracked
     all  - All functions, including SQL and C language functions, are tracked. Simple SQL-language that are inlined are not tracked`);
 TrackFunctions.args = {
-    database: core_1.Args.string(),
-    value: core_1.Args.string({ options: ['none', 'pl', 'all'] }),
+    database: core_1.Args.string({ description: `${(0, nls_1.nls)('pg:database:arg:description')} ${(0, nls_1.nls)('pg:database:arg:description:default:suffix')}` }),
+    value: core_1.Args.string({ options: ['none', 'pl', 'all'], description: 'function type to track\n<options: none|pl|all>' }),
 };

package/lib/commands/pg/unfollow.js

@@ -8,6 +8,7 @@ const host_1 = require("../../lib/pg/host");
 const util_1 = require("../../lib/pg/util");
 const confirmCommand_1 = require("../../lib/confirmCommand");
 const tsheredoc_1 = require("tsheredoc");
+const nls_1 = require("../../nls");
 class Unfollow extends command_1.Command {
     async run() {
         const { flags, args } = await this.parse(Unfollow);
@@ -36,5 +37,5 @@ Unfollow.flags = {
     remote: command_1.flags.remote(),
 };
 Unfollow.args = {
-    database: core_1.Args.string({ required: true }),
+    database: core_1.Args.string({ required: true, description: (0, nls_1.nls)('pg:database:arg:description') }),
 };

package/lib/commands/pg/upgrade.js

@@ -8,6 +8,7 @@ const fetcher_1 = require("../../lib/pg/fetcher");
 const host_1 = require("../../lib/pg/host");
 const util_1 = require("../../lib/pg/util");
 const confirmCommand_1 = require("../../lib/confirmCommand");
+const nls_1 = require("../../nls");
 class Upgrade extends command_1.Command {
     async run() {
         const { flags, args } = await this.parse(Upgrade);
@@ -54,5 +55,5 @@ Upgrade.flags = {
     remote: command_1.flags.remote(),
 };
 Upgrade.args = {
-    database: core_1.Args.string(),
+    database: core_1.Args.string({ description: `${(0, nls_1.nls)('pg:database:arg:description')} ${(0, nls_1.nls)('pg:database:arg:description:default:suffix')}` }),
 };

package/lib/commands/pg/vacuum-stats.js

@@ -5,6 +5,7 @@ const core_1 = require("@oclif/core");
 const fetcher_1 = require("../../lib/pg/fetcher");
 const psql_1 = require("../../lib/pg/psql");
 const tsheredoc_1 = require("tsheredoc");
+const nls_1 = require("../../nls");
 class VacuumStats extends command_1.Command {
     async run() {
         const { flags, args } = await this.parse(VacuumStats);
@@ -61,5 +62,5 @@ VacuumStats.flags = {
     remote: command_1.flags.remote(),
 };
 VacuumStats.args = {
-    database: core_1.Args.string(),
+    database: core_1.Args.string({ description: `${(0, nls_1.nls)('pg:database:arg:description')} ${(0, nls_1.nls)('pg:database:arg:description:default:suffix')}` }),
 };

package/lib/commands/pg/wait.js

@@ -7,6 +7,7 @@ const debug_1 = require("debug");
 const fetcher_1 = require("../../lib/pg/fetcher");
 const host_1 = require("../../lib/pg/host");
 const notify_1 = require("../../lib/notify");
+const nls_1 = require("../../nls");
 const wait = (ms) => new Promise(resolve => {
     setTimeout(resolve, ms);
 });
@@ -75,5 +76,5 @@ Wait.flags = {
     remote: command_1.flags.remote(),
 };
 Wait.args = {
-    database: core_1.Args.string(),
+    database: core_1.Args.string({ description: `${(0, nls_1.nls)('pg:database:arg:description')} ${(0, nls_1.nls)('pg:database:arg:description:all-dbs:suffix')}` }),
 };

package/lib/commands/pipelines/diff.d.ts

@@ -13,7 +13,7 @@ export default class PipelinesDiff extends Command {
         remote: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
     };
     kolkrabbi: KolkrabbiAPI;
-    getAppInfo: (appName: string, appId: string) => Promise<AppInfo>;
+    getAppInfo: (appName: string, appId: string, generation: string) => Promise<AppInfo>;
     run(): Promise<undefined>;
 }
 export {};

package/lib/commands/pipelines/diff.js

@@ -60,7 +60,8 @@ class PipelinesDiff extends command_1.Command {
     constructor() {
         super(...arguments);
         this.kolkrabbi = new kolkrabbi_api_1.default(this.config.userAgent, () => this.heroku.auth);
-        this.getAppInfo = async (appName, appId) => {
+        this.getAppInfo = async (appName, appId, generation) => {
+            var _a;
             // Find GitHub connection for the app
             const githubApp = await this.kolkrabbi.getAppLink(appId)
                 .catch(() => {
@@ -68,21 +69,31 @@ class PipelinesDiff extends command_1.Command {
             });
             // Find the commit hash of the latest release for this app
             let slug;
+            let ociImages;
+            let commit;
             try {
                 const { body: releases } = await (0, api_1.getReleases)(this.heroku, appId);
                 const release = releases.find(r => r.status === 'succeeded');
-                if (!release || !release.slug) {
+                if (!release || !(release.slug || release.oci_image)) {
                     throw new Error(`no release found for ${appName}`);
                 }
-                slug = await this.heroku.get(`/apps/${appId}/slugs/${release.slug.id}`, {
-                    headers: { Accept: api_1.V3_HEADER },
-                }).then(res => res.body);
-                // tslint:disable-next-line: no-unused
+                if (generation === 'cedar' && release.slug) {
+                    slug = await this.heroku.get(`/apps/${appId}/slugs/${release.slug.id}`, {
+                        headers: { Accept: api_1.SDK_HEADER },
+                    }).then(res => res.body);
+                    commit = slug.commit;
+                }
+                else if (generation === 'fir' && release.oci_image) {
+                    ociImages = await this.heroku.get(`/apps/${appId}/oci-images/${release.oci_image.id}`, {
+                        headers: { Accept: api_1.SDK_HEADER },
+                    }).then(res => res.body);
+                    commit = (_a = ociImages[0]) === null || _a === void 0 ? void 0 : _a.commit;
+                }
             }
-            catch (_a) {
+            catch (_b) {
                 return { name: appName, repo: githubApp.repo, hash: undefined };
             }
-            return { name: appName, repo: githubApp.repo, hash: slug.commit };
+            return { name: appName, repo: githubApp.repo, hash: commit };
         };
     }
     async run() {
@@ -96,6 +107,7 @@ class PipelinesDiff extends command_1.Command {
             return;
         }
         const targetAppId = coupling.app.id;
+        const generation = coupling.generation;
         core_1.ux.action.start('Fetching apps from pipeline');
         const allApps = await (0, api_1.listPipelineApps)(this.heroku, coupling.pipeline.id);
         core_1.ux.action.stop();
@@ -104,20 +116,18 @@ class PipelinesDiff extends command_1.Command {
             return core_1.ux.error(`Unable to diff ${targetAppName}`);
         }
         const downstreamStage = PROMOTION_ORDER[PROMOTION_ORDER.indexOf(sourceStage) + 1];
-        if (!downstreamStage || PROMOTION_ORDER.indexOf(sourceStage) < 0) { // eslint-disable-line unicorn/prefer-includes
+        if (!downstreamStage || !PROMOTION_ORDER.includes(sourceStage)) {
             return core_1.ux.error(`Unable to diff ${targetAppName}`);
         }
-        const downstreamApps = allApps.filter(function (app) {
-            return app.coupling.stage === downstreamStage;
-        });
+        const downstreamApps = allApps.filter(app => app.pipelineCoupling.stage === downstreamStage);
         if (downstreamApps.length === 0) {
             return core_1.ux.error(`Cannot diff ${targetAppName} as there are no downstream apps configured`);
         }
         // Fetch GitHub repo/latest release hash for [target, downstream[0], .., downstream[n]] apps
-        const appInfoPromises = [this.getAppInfo(targetAppName, targetAppId)];
+        const appInfoPromises = [this.getAppInfo(targetAppName, targetAppId, generation)];
         downstreamApps.forEach(app => {
             if (app.name && app.id) {
-                appInfoPromises.push(this.getAppInfo(app.name, app.id));
+                appInfoPromises.push(this.getAppInfo(app.name, app.id, generation));
             }
         });
         core_1.ux.action.start('Fetching release info for all apps');

package/lib/commands/pipelines/promote.js

@@ -166,7 +166,7 @@ class Promote extends command_1.Command {
         else {
             const targetStage = PROMOTION_ORDER[PROMOTION_ORDER.indexOf(sourceStage) + 1];
             assertValidPromotion(appNameOrId, sourceStage, targetStage);
-            targetApps = allApps.filter(app => app.coupling.stage === targetStage);
+            targetApps = allApps.filter(app => app.pipelineCoupling.stage === targetStage);
             assertApps(appNameOrId, targetApps, targetStage);
             promotionActionName = `Starting promotion to ${targetStage}`;
         }

package/lib/commands/ps/autoscale/enable.js

@@ -12,12 +12,23 @@ class Enable extends command_1.Command {
         const { flags } = await this.parse(Enable);
         core_1.ux.action.start('Enabling dyno autoscaling');
         const [appResponse, formationResponse] = await Promise.all([
-            this.heroku.get(`/apps/${flags.app}`),
-            this.heroku.get(`/apps/${flags.app}/formation`),
+            this.heroku.get(`/apps/${flags.app}`, {
+                headers: {
+                    Accept: 'application/vnd.heroku+json; version=3.sdk',
+                },
+            }),
+            this.heroku.get(`/apps/${flags.app}/formation`, {
+                headers: {
+                    Accept: 'application/vnd.heroku+json; version=3.sdk',
+                },
+            }),
         ]);
         const app = appResponse.body;
         const formations = formationResponse.body;
         const webFormation = formations.find((f) => f.type === 'web');
+        if (app.generation === 'fir') {
+            throw new Error('Autoscaling is unavailable for apps in this space. See https://devcenter.heroku.com/articles/generations.');
+        }
         if (!webFormation)
             throw new Error(`${flags.app} does not have any web dynos to scale`);
         const { size } = webFormation;

package/lib/commands/ps/index.js

@@ -7,7 +7,10 @@ const core_1 = require("@oclif/core");
 const time_1 = require("../../lib/time");
 const tsheredoc_1 = require("tsheredoc");
 function getProcessNumber(s) {
-    return Number.parseInt(s.split('.', 2)[1], 10);
+    const [processType, dynoNumber] = (s.match(/^([^.]+)\.(.*)$/) || []).slice(1, 3);
+    if (!processType || !(dynoNumber === null || dynoNumber === void 0 ? void 0 : dynoNumber.match(/^\d+$/)))
+        return 0;
+    return Number.parseInt(dynoNumber, 10);
 }
 function uniqueValues(value, index, self) {
     return self.indexOf(value) === index;
@@ -135,11 +138,17 @@ class Index extends command_1.Command {
         const _a = await this.parse(Index), { flags } = _a, restParse = tslib_1.__rest(_a, ["flags"]);
         const { app, json, extended } = flags;
         const types = restParse.argv;
-        const suffix = extended ? '?extended=true' : ''; // read previous comment, including this on the request doesn't make any difference.
+        const suffix = extended ? '?extended=true' : '';
         const promises = {
-            dynos: this.heroku.request(`/apps/${app}/dynos${suffix}`),
-            appInfo: this.heroku.request(`/apps/${app}`, { headers: { Accept: 'application/vnd.heroku+json; version=3.process-tier' } }),
-            accountInfo: this.heroku.request('/account'),
+            dynos: this.heroku.request(`/apps/${app}/dynos${suffix}`, {
+                headers: { Accept: 'application/vnd.heroku+json; version=3.sdk' },
+            }),
+            appInfo: this.heroku.request(`/apps/${app}`, {
+                headers: { Accept: 'application/vnd.heroku+json; version=3.sdk' },
+            }),
+            accountInfo: this.heroku.request('/account', {
+                headers: { Accept: 'application/vnd.heroku+json; version=3.sdk' },
+            }),
         };
         const [{ body: dynos }, { body: appInfo }, { body: accountInfo }] = await Promise.all([promises.dynos, promises.appInfo, promises.accountInfo]);
         const shielded = appInfo.space && appInfo.space.shield;
@@ -191,5 +200,5 @@ Index.flags = {
     app: command_1.flags.app({ required: true }),
     remote: command_1.flags.remote(),
     json: command_1.flags.boolean({ description: 'display as json' }),
-    extended: command_1.flags.boolean({ char: 'x', hidden: true }), // should be removed? Platform API doesn't serialize extended attributes even if the query param `extended=true` is sent.
+    extended: command_1.flags.boolean({ char: 'x', hidden: true }), // only works with sudo privileges
 };

package/lib/commands/redis/cli.js

@@ -187,7 +187,7 @@ Cli.flags = {
     remote: command_1.flags.remote(),
 };
 Cli.args = {
-    database: core_1.Args.string(),
+    database: core_1.Args.string({ description: 'name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app.' }),
 };
 Cli.examples = [
     '$ heroku redis:cli --app=my-app my-database',

package/lib/commands/redis/credentials.js

@@ -28,5 +28,5 @@ Credentials.flags = {
     reset: command_1.flags.boolean({ description: 'reset credentials' }),
 };
 Credentials.args = {
-    database: core_1.Args.string({ required: false }),
+    database: core_1.Args.string({ required: false, description: 'name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app.' }),
 };

package/lib/commands/redis/info.js

@@ -21,5 +21,5 @@ Info.flags = {
     json: command_1.flags.boolean({ char: 'j', description: 'output in json format' }),
 };
 Info.args = {
-    database: core_1.Args.string(),
+    database: core_1.Args.string({ description: 'name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app.' }),
 };

package/lib/commands/redis/keyspace-notifications.js

@@ -43,5 +43,5 @@ KeyspaceNotifications.flags = {
     config: command_1.flags.string({ char: 'c', description: 'set keyspace notifications configuration', hasValue: true, required: true }),
 };
 KeyspaceNotifications.args = {
-    database: core_1.Args.string(),
+    database: core_1.Args.string({ description: 'name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app.' }),
 };

package/lib/commands/redis/maintenance.js

@@ -59,5 +59,5 @@ Maintenance.flags = {
     }),
 };
 Maintenance.args = {
-    database: core_1.Args.string({ required: false }),
+    database: core_1.Args.string({ required: false, description: 'name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app.' }),
 };

package/lib/commands/redis/maxmemory.js

@@ -36,5 +36,5 @@ MaxMemory.flags = {
     remote: command_1.flags.remote(),
 };
 MaxMemory.args = {
-    database: core_1.Args.string(),
+    database: core_1.Args.string({ description: 'name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app.' }),
 };

package/lib/commands/redis/promote.js

@@ -35,5 +35,5 @@ Promote.flags = {
     remote: command_1.flags.remote(),
 };
 Promote.args = {
-    database: core_1.Args.string({ required: false }),
+    database: core_1.Args.string({ required: false, description: 'name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app.' }),
 };

package/lib/commands/redis/stats-reset.js

@@ -32,5 +32,5 @@ StatsReset.flags = {
     confirm: command_1.flags.string({ char: 'c' }),
 };
 StatsReset.args = {
-    database: core_1.Args.string(),
+    database: core_1.Args.string({ description: 'name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app.' }),
 };

package/lib/commands/redis/timeout.js

@@ -31,5 +31,5 @@ Timeout.flags = {
     seconds: command_1.flags.integer({ char: 's', description: 'set timeout value', required: true }),
 };
 Timeout.args = {
-    database: core_1.Args.string(),
+    database: core_1.Args.string({ description: 'name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app.' }),
 };

package/lib/commands/redis/upgrade.js

@@ -33,5 +33,5 @@ Upgrade.flags = {
     confirm: command_1.flags.string({ char: 'c' }),
 };
 Upgrade.args = {
-    database: core_1.Args.string(),
+    database: core_1.Args.string({ description: 'name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app.' }),
 };

package/lib/commands/redis/wait.js

@@ -56,5 +56,5 @@ Wait.flags = {
     remote: command_1.flags.remote(),
 };
 Wait.args = {
-    database: core_1.Args.string({ required: false }),
+    database: core_1.Args.string({ required: false, description: 'name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app.' }),
 };

package/lib/commands/releases/index.js

@@ -57,8 +57,10 @@ class Index extends command_1.Command {
         const { app, num, json, extended } = flags;
         const url = `/apps/${app}/releases${extended ? '?extended=true' : ''}`;
         const { body: releases } = await this.heroku.request(url, {
-            partial: true, headers: {
+            partial: true,
+            headers: {
                 Range: `version ..; max=${num || 15}, order=desc`,
+                Accept: 'application/vnd.heroku+json; version=3.sdk',
             },
         });
         let optimizationWidth = 0;
@@ -100,7 +102,7 @@ class Index extends command_1.Command {
             let header = `${app} Releases`;
             const currentRelease = releases.find(r => r.current === true);
             if (currentRelease) {
-                header += ' - ' + color_1.default.blue(`Current: v${currentRelease.version}`);
+                header += ' - ' + color_1.default.cyan(`Current: v${currentRelease.version}`);
             }
             core_1.ux.styledHeader(header);
             core_1.ux.table(releases, columns, { 'no-header': true, 'no-truncate': true, extended });

package/lib/commands/releases/info.js

@@ -27,7 +27,11 @@ class Info extends command_1.Command {
             }
             core_1.ux.styledHeader(`Release ${color_1.default.cyan('v' + release.version)}`);
             core_1.ux.styledObject({
-                'Add-ons': release.addon_plan_names, Change: releaseChange, By: userEmail, When: release.created_at,
+                'Add-ons': release.addon_plan_names,
+                Change: releaseChange,
+                By: userEmail,
+                'Eligible for Rollback?': release.eligible_for_rollback ? 'Yes' : 'No',
+                When: release.created_at,
             });
             core_1.ux.log();
             core_1.ux.styledHeader(`${color_1.default.cyan('v' + release.version)} Config vars`);
@@ -52,5 +56,5 @@ Info.flags = {
     app: command_1.flags.app({ required: true }),
 };
 Info.args = {
-    release: core_1.Args.string(),
+    release: core_1.Args.string({ description: 'ID of the release. If omitted, we use the last release ID.' }),
 };

package/lib/commands/releases/output.js

@@ -33,5 +33,5 @@ Output.flags = {
     app: command_1.flags.app({ required: true }),
 };
 Output.args = {
-    release: core_1.Args.string(),
+    release: core_1.Args.string({ description: 'ID of the release. If omitted, we use the last release ID.' }),
 };

package/lib/commands/releases/rollback.js

@@ -10,8 +10,18 @@ class Rollback extends command_1.Command {
         const { flags, args } = await this.parse(Rollback);
         const { app } = flags;
         const release = await (0, releases_1.findByPreviousOrId)(this.heroku, app, args.release);
-        core_1.ux.action.start(`Rolling back ${color_1.default.magenta(app)} to ${color_1.default.green('v' + release.version)}`);
-        const { body: latest } = await this.heroku.post(`/apps/${app}/releases`, { body: { release: release.id } });
+        if (!release) {
+            core_1.ux.error(`No eligible release found for ${color_1.default.app(app)} to roll back to.`);
+        }
+        core_1.ux.action.start(`Rolling back ${color_1.default.app(app)} to ${color_1.default.green('v' + release.version)}`);
+        const { body: latest } = await this.heroku.post(`/apps/${app}/releases`, {
+            body: {
+                release: release.id,
+            },
+            headers: {
+                Accept: 'application/vnd.heroku+json; version=3.sdk',
+            },
+        });
         const streamUrl = latest.output_stream_url;
         core_1.ux.action.stop(`done, ${color_1.default.green('v' + latest.version)}`);
         core_1.ux.warn("Rollback affects code and config vars; it doesn't add or remove addons.");
@@ -37,12 +47,12 @@ Rollback.topic = 'releases';
 Rollback.hiddenAliases = ['rollback'];
 Rollback.description = `Roll back to a previous release.
 
-    If RELEASE is not specified, it will roll back one release.
+    If RELEASE is not specified, it will roll back to the last eligible release.
     `;
 Rollback.flags = {
     remote: command_1.flags.remote(),
     app: command_1.flags.app({ required: true }),
 };
 Rollback.args = {
-    release: core_1.Args.string(),
+    release: core_1.Args.string({ description: 'ID of the release. If omitted, we use the last eligible release.' }),
 };

package/lib/commands/sessions/destroy.js

@@ -14,5 +14,5 @@ class SessionsDestroy extends command_1.Command {
 exports.default = SessionsDestroy;
 SessionsDestroy.description = 'delete (logout) OAuth session by ID';
 SessionsDestroy.args = {
-    id: core_1.Args.string({ required: true }),
+    id: core_1.Args.string({ required: true, description: 'ID of the OAuth session' }),
 };

package/lib/commands/spaces/create.js

@@ -66,7 +66,7 @@ Create.examples = [(0, tsheredoc_1.default) `
     CIDR:       10.0.0.0/16
     Data CIDR:  172.23.0.0/20
     State:      allocating
-    Generation: fir
+    Generation: cedar
     Created at: 2016-01-06T03:23:13Z
   `];
 Create.flags = {

package/lib/commands/spaces/drains/set.js

@@ -25,5 +25,5 @@ Set.flags = {
     space: command_1.flags.string({ char: 's', description: 'space for which to set log drain', required: true }),
 };
 Set.args = {
-    url: core_1.Args.string({ required: true }),
+    url: core_1.Args.string({ required: true, description: 'URL to replace the log drain with' }),
 };

package/lib/commands/spaces/trusted-ips/add.js

@@ -9,15 +9,12 @@ class Add extends command_1.Command {
         const { flags, args } = await this.parse(Add);
         const { space } = flags;
         const url = `/spaces/${space}/inbound-ruleset`;
-        const options = {
-            headers: { Accept: 'application/vnd.heroku+json; version=3.dogwood' },
-        };
-        const { body: ruleset } = await this.heroku.get(url, options);
+        const { body: ruleset } = await this.heroku.get(url);
         if (!this.isUniqueRule(ruleset, args.source)) {
             throw new Error(`A rule already exists for ${args.source}.`);
         }
         ruleset.rules.push({ action: 'allow', source: args.source });
-        await this.heroku.put(url, Object.assign(Object.assign({}, options), { body: ruleset }));
+        await this.heroku.put(url, { body: ruleset });
         core_1.ux.log(`Added ${color_1.default.cyan.bold(args.source)} to trusted IP ranges on ${color_1.default.cyan.bold(space)}`);
         core_1.ux.warn('It may take a few moments for the changes to take effect.');
     }
@@ -39,5 +36,5 @@ Add.flags = {
     confirm: command_1.flags.string({ description: 'set to space name to bypass confirm prompt' }),
 };
 Add.args = {
-    source: core_1.Args.string({ required: true }),
+    source: core_1.Args.string({ required: true, description: 'IP address in CIDR notation' }),
 };