heroku 11.0.0-alpha.10 → 11.0.0-alpha.12

package/lib/commands/config/get.js

@@ -1,30 +1,51 @@
+import { color } from '@heroku/heroku-cli-util';
+import { hux } from '@heroku/heroku-cli-util';
 import { Command, flags } from '@heroku-cli/command';
-import { Args, ux } from '@oclif/core';
+import { Args } from '@oclif/core';
 import { quote } from '../../lib/config/quote.js';
 export class ConfigGet extends Command {
-    static usage = 'config:get KEY...';
-    static description = 'display a single config value for an app';
-    static example = `$ heroku config:get RAILS_ENV
-production`;
-    static strict = false;
     static args = {
-        KEY: Args.string({ required: true, description: 'key name of the config var value' }),
+        KEY: Args.string({ description: 'key name of the config var value', required: true }),
     };
+    static description = 'display a single config value for an app';
+    static example = `${color.command(`heroku config:get RAILS_ENV
+production`)}`;
     static flags = {
         app: flags.app({ required: true }),
+        json: flags.boolean({ char: 'j', description: 'output in json format' }),
         remote: flags.remote(),
         shell: flags.boolean({ char: 's', description: 'output config vars in shell format' }),
     };
+    static strict = false;
+    static usage = 'config:get KEY...';
     async run() {
-        const { flags, argv } = await this.parse(ConfigGet);
+        const { argv, flags } = await this.parse(ConfigGet);
         const { body: config } = await this.heroku.get(`/apps/${flags.app}/config-vars`);
-        for (const key of argv) {
-            const v = config[key];
-            if (flags.shell) {
-                ux.stdout(`${key}=${quote(v || '')}`);
+        if (flags.json) {
+            const results = argv.map(key => {
+                const exists = key in config;
+                return {
+                    key,
+                    value: exists ? config[key] : null,
+                };
+            });
+            if (results.length === 1) {
+                hux.styledJSON(results[0]);
             }
             else {
-                ux.stdout(v || '');
+                hux.styledJSON(results);
+            }
+        }
+        else if (flags.shell) {
+            for (const key of argv) {
+                const v = config[key];
+                this.log(`${key}=${quote(v || '')}`);
+            }
+        }
+        else {
+            for (const key of argv) {
+                const v = config[key];
+                this.log(v || '');
             }
         }
     }

package/lib/commands/config/index.d.ts

@@ -3,9 +3,9 @@ export declare class ConfigIndex extends Command {
     static description: string;
     static flags: {
         app: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         remote: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         shell: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
 }

package/lib/commands/config/index.js

@@ -1,15 +1,14 @@
-import { color } from '@heroku-cli/color';
+import { color, hux } from '@heroku/heroku-cli-util';
 import { Command, flags } from '@heroku-cli/command';
 import { ux } from '@oclif/core';
-import { hux } from '@heroku/heroku-cli-util';
 import { quote } from '../../lib/config/quote.js';
 export class ConfigIndex extends Command {
     static description = 'display the config vars for an app';
     static flags = {
         app: flags.app({ required: true }),
+        json: flags.boolean({ char: 'j', description: 'output config vars in json format' }),
         remote: flags.remote(),
         shell: flags.boolean({ char: 's', description: 'output config vars in shell format' }),
-        json: flags.boolean({ char: 'j', description: 'output config vars in json format' }),
     };
     async run() {
         const { flags } = await this.parse(ConfigIndex);
@@ -22,8 +21,8 @@ export class ConfigIndex extends Command {
             hux.styledJSON(config);
         }
         else {
-            hux.styledHeader(`${flags.app} Config Vars`);
-            const coloredConfig = Object.fromEntries(Object.entries(config).map(([key, value]) => [color.configVar(key), value]));
+            hux.styledHeader(`${color.app(flags.app)} Config Vars`);
+            const coloredConfig = Object.fromEntries(Object.entries(config).map(([key, value]) => [color.name(key), value]));
             hux.styledObject(coloredConfig);
         }
     }

package/lib/commands/config/set.d.ts

@@ -1,12 +1,12 @@
 import { Command } from '@heroku-cli/command';
 export default class Set extends Command {
     static description: string;
-    static strict: boolean;
-    static hiddenAliases: string[];
     static examples: string[];
     static flags: {
         app: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         remote: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
+    static hiddenAliases: string[];
+    static strict: boolean;
     run(): Promise<void>;
 }

package/lib/commands/config/set.js

@@ -1,35 +1,34 @@
-import { color } from '@heroku-cli/color';
+import { color, hux } from '@heroku/heroku-cli-util';
 import { Command, flags } from '@heroku-cli/command';
 import { ux } from '@oclif/core';
-import { hux } from '@heroku/heroku-cli-util';
+import tsheredoc from 'tsheredoc';
+const heredoc = tsheredoc.default;
 const lastRelease = async (client, app) => {
     const { body: releases } = await client.get(`/apps/${app}/releases`, {
+        headers: { Range: 'version ..; order=desc,max=1' },
         method: 'GET',
         partial: true,
-        headers: { Range: 'version ..; order=desc,max=1' },
     });
     return releases[0];
 };
 export default class Set extends Command {
     static description = 'set one or more config vars';
-    static strict = false;
-    static hiddenAliases = ['config:add'];
-    static examples = [
-        `$ heroku config:set RAILS_ENV=staging
+    static examples = [heredoc(`
+${color.command('heroku config:set RAILS_ENV=staging')}
 Setting config vars and restarting example... done, v10
-RAILS_ENV: staging
-
-$ heroku config:set RAILS_ENV=staging RACK_ENV=staging
+RAILS_ENV: staging)`), heredoc(`
+${color.command('heroku config:set RAILS_ENV=staging RACK_ENV=staging')}
 Setting config vars and restarting example... done, v11
 RAILS_ENV: staging
-RACK_ENV:  staging`,
-    ];
+RACK_ENV:  staging`)];
     static flags = {
         app: flags.app({ required: true }),
         remote: flags.remote(),
     };
+    static hiddenAliases = ['config:add'];
+    static strict = false;
     async run() {
-        const { flags, argv: _argv } = await this.parse(Set);
+        const { argv: _argv, flags } = await this.parse(Set);
         const argv = _argv;
         if (argv.length === 0) {
             ux.error('Usage: heroku config:set KEY1=VALUE1 [KEY2=VALUE2 ...]\nMust specify KEY and VALUE to set.', { exit: 1 });
@@ -38,21 +37,21 @@ RACK_ENV:  staging`,
         argv.forEach((v) => {
             const idx = v.indexOf('=');
             if (idx === -1) {
-                ux.error(`${color.cyan(v)} is invalid. Must be in the format ${color.cyan('FOO=bar')}.`, { exit: 1 });
+                ux.error(`${color.name(v)} is invalid. Must be in the format ${color.code('FOO=bar')}.`, { exit: 1 });
             }
             vars[v.slice(0, idx)] = v.slice(idx + 1);
         });
-        const varsCopy = argv.map((v) => color.green(v.split('=')[0])).join(', ');
+        const varsCopy = argv.map((v) => color.name(v.split('=')[0])).join(', ');
         ux.action.start(`Setting ${varsCopy} and restarting ${color.app(flags.app)}`);
         let { body: config } = await this.heroku.patch(`/apps/${flags.app}/config-vars`, {
             body: vars,
         });
         const release = await lastRelease(this.heroku, flags.app);
-        ux.action.stop(`done, ${color.release('v' + release.version)}`);
+        ux.action.stop(`done, ${color.name('v' + release.version)}`);
         config = Object.fromEntries(Object.entries(config)
             .filter(([k]) => vars[k])
-            .map(([k, v]) => [color.green(k), v]));
+            .map(([k, v]) => [color.name(k), v]));
         hux.styledObject(config);
-        await this.config.runHook('recache', { type: 'config', app: flags.app });
+        await this.config.runHook('recache', { app: flags.app, type: 'config' });
     }
 }

package/lib/commands/config/unset.d.ts

@@ -3,10 +3,10 @@ export declare class ConfigUnset extends Command {
     static aliases: string[];
     static description: string;
     static examples: string[];
-    static strict: boolean;
     static flags: {
         app: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         remote: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
+    static strict: boolean;
     run(): Promise<void>;
 }

package/lib/commands/config/unset.js

@@ -1,43 +1,44 @@
-import { color } from '@heroku-cli/color';
+import { color } from '@heroku/heroku-cli-util';
 import { Command, flags } from '@heroku-cli/command';
 import { ux } from '@oclif/core';
+import tsheredoc from 'tsheredoc';
+const heredoc = tsheredoc.default;
 export class ConfigUnset extends Command {
     static aliases = [
         'config:remove',
     ];
     static description = 'unset one or more config vars';
-    static examples = [
-        `$ heroku config:unset RAILS_ENV
-Unsetting RAILS_ENV and restarting example... done, v10`,
-        `$ heroku config:unset RAILS_ENV RACK_ENV
-Unsetting RAILS_ENV, RACK_ENV and restarting example... done, v10`,
-    ];
-    static strict = false;
+    static examples = [heredoc(`
+    ${color.command('heroku config:unset RAILS_ENV')}
+Unsetting RAILS_ENV and restarting example... done, v10`), heredoc(`
+    ${color.command('heroku config:unset RAILS_ENV RACK_ENV')}
+Unsetting RAILS_ENV, RACK_ENV and restarting example... done, v10`)];
     static flags = {
         app: flags.app({ char: 'a', required: true }),
         remote: flags.remote({ char: 'r' }),
     };
+    static strict = false;
     async run() {
         const parsed = await this.parse(ConfigUnset);
         const { flags } = parsed;
         const argv = parsed.argv;
         const lastRelease = async () => {
             const { body: releases } = await this.heroku.get(`/apps/${flags.app}/releases`, {
-                partial: true,
                 headers: { Range: 'version ..; order=desc,max=1' },
+                partial: true,
             });
             return releases[0];
         };
         if (argv.length === 0) {
             this.error('Usage: heroku config:unset KEY1 [KEY2 ...]\nMust specify KEY to unset.');
         }
-        const vars = argv.map(v => color.configVar(v)).join(', ');
+        const vars = argv.map(v => color.name(v)).join(', ');
         ux.action.start(`Unsetting ${vars} and restarting ${color.app(flags.app)}`);
         await this.heroku.patch(`/apps/${flags.app}/config-vars`, {
             // body will be like {FOO: null, BAR: null}
             body: Object.fromEntries(argv.map(v => [v, null])),
         });
         const release = await lastRelease();
-        ux.action.stop('done, ' + color.release(`v${release.version}`));
+        ux.action.stop('done, ' + color.name(`v${release.version}`));
     }
 }

package/lib/commands/container/pull.d.ts

@@ -1,16 +1,16 @@
 import { Command } from '@heroku-cli/command';
 import { DockerHelper } from '../../lib/container/docker_helper.js';
 export default class Pull extends Command {
-    static topic: string;
     static description: string;
-    static usage: string;
-    static example: string;
-    static strict: boolean;
+    static examples: string[];
     static flags: {
         app: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         remote: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
+    static strict: boolean;
+    static topic: string;
+    static usage: string;
     dockerHelper: DockerHelper;
     run(): Promise<void>;
 }

package/lib/commands/container/pull.js

@@ -1,29 +1,29 @@
+import { color, hux } from '@heroku/heroku-cli-util';
 import { Command, flags } from '@heroku-cli/command';
-import { hux } from '@heroku/heroku-cli-util';
+import { debug } from '../../lib/container/debug.js';
 import { DockerHelper } from '../../lib/container/docker_helper.js';
 import { ensureContainerStack } from '../../lib/container/helpers.js';
-import { debug } from '../../lib/container/debug.js';
-import { color } from '@heroku-cli/color';
 export default class Pull extends Command {
-    static topic = 'container';
     static description = 'pulls an image from an app\'s process type';
-    static usage = 'container:pull -a APP [-v] PROCESS_TYPE...';
-    static example = `
-  ${color.cmd('$ heroku container:pull web')}        # Pulls the web image from the app
-  ${color.cmd('$ heroku container:pull web worker')} # Pulls both the web and worker images from the app
-  ${color.cmd('$ heroku container:pull web:latest')} # Pulls the latest tag from the web image`;
-    static strict = false;
+    static examples = [
+        `${color.command('heroku container:pull web')}        # Pulls the web image from the app`,
+        `${color.command('heroku container:pull web worker')} # Pulls both the web and worker images from the app`,
+        `${color.command('heroku container:pull web:latest')} # Pulls the latest tag from the web image`,
+    ];
     static flags = {
         app: flags.app({ required: true }),
         remote: flags.remote(),
         verbose: flags.boolean({ char: 'v' }),
     };
+    static strict = false;
+    static topic = 'container';
+    static usage = 'container:pull -a APP [-v] PROCESS_TYPE...';
     dockerHelper = new DockerHelper();
     async run() {
         const { argv, flags } = await this.parse(Pull);
-        const { verbose, app } = flags;
+        const { app, verbose } = flags;
         if (argv.length === 0) {
-            this.error(`Error: Requires one or more process types\n${Pull.example}`);
+            this.error(`Error: Requires one or more process types\n${Pull.examples.join('\n')}`);
         }
         const { body: appBody } = await this.heroku.get(`/apps/${app}`);
         ensureContainerStack(appBody, 'pull');

package/lib/commands/container/push.d.ts

@@ -1,18 +1,18 @@
 import { Command } from '@heroku-cli/command';
-import { DockerHelper, GroupedDockerJobs, DockerJob } from '../../lib/container/docker_helper.js';
+import { DockerHelper, DockerJob, GroupedDockerJobs } from '../../lib/container/docker_helper.js';
 export default class Push extends Command {
-    static topic: string;
     static description: string;
-    static strict: boolean;
+    static examples: string[];
     static flags: {
         app: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        recursive: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         arg: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'context-path': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        recursive: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         remote: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
-    static examples: string[];
+    static strict: boolean;
+    static topic: string;
     dockerHelper: DockerHelper;
     run(): Promise<void>;
     selectJobs(jobs: GroupedDockerJobs, processTypes: string[], recursive: boolean): Promise<DockerJob[]>;

package/lib/commands/container/push.js

@@ -1,33 +1,33 @@
+import { color, hux } from '@heroku/heroku-cli-util';
 import { Command, flags } from '@heroku-cli/command';
 import { ux } from '@oclif/core';
-import { hux } from '@heroku/heroku-cli-util';
+import { debug } from '../../lib/container/debug.js';
 import { DockerHelper } from '../../lib/container/docker_helper.js';
 import { ensureContainerStack } from '../../lib/container/helpers.js';
-import { debug } from '../../lib/container/debug.js';
 export default class Push extends Command {
-    static topic = 'container';
     static description = 'builds, then pushes Docker images to deploy your Heroku app';
-    static strict = false;
+    static examples = [
+        `${color.command('heroku container:push web')}                          # Pushes Dockerfile to web process type`,
+        `${color.command('heroku container:push worker')}                       # Pushes Dockerfile to worker process type`,
+        `${color.command('heroku container:push web worker --recursive')}       # Pushes Dockerfile.web and Dockerfile.worker`,
+        `${color.command('heroku container:push --recursive')}                  # Pushes Dockerfile.*`,
+        `${color.command('heroku container:push web --arg ENV=live,HTTPS=on')}  # Build-time variables`,
+        `${color.command('heroku container:push --recursive --context-path .')} # Pushes Dockerfile.* using current dir as build context`,
+    ];
     static flags = {
         app: flags.app({ required: true }),
-        verbose: flags.boolean({ char: 'v' }),
-        recursive: flags.boolean({ char: 'R', description: 'pushes Dockerfile.<process> found in current and subdirectories' }),
         arg: flags.string({ description: 'set build-time variables' }),
         'context-path': flags.string({ description: 'path to use as build context (defaults to Dockerfile dir)' }),
+        recursive: flags.boolean({ char: 'R', description: 'pushes Dockerfile.<process> found in current and subdirectories' }),
         remote: flags.remote({ char: 'r' }),
+        verbose: flags.boolean({ char: 'v' }),
     };
-    static examples = [
-        '$ heroku container:push web                          # Pushes Dockerfile to web process type',
-        '$ heroku container:push worker                       # Pushes Dockerfile to worker process type',
-        '$ heroku container:push web worker --recursive       # Pushes Dockerfile.web and Dockerfile.worker',
-        '$ heroku container:push --recursive                  # Pushes Dockerfile.*',
-        '$ heroku container:push web --arg ENV=live,HTTPS=on  # Build-time variables',
-        '$ heroku container:push --recursive --context-path . # Pushes Dockerfile.* using current dir as build context',
-    ];
+    static strict = false;
+    static topic = 'container';
     dockerHelper = new DockerHelper();
     async run() {
         const { argv: processTypes, flags } = await this.parse(Push);
-        const { verbose, app, recursive, arg, 'context-path': contextPath } = flags;
+        const { app, arg, 'context-path': contextPath, recursive, verbose } = flags;
         if (verbose) {
             debug.enabled = true;
         }
@@ -57,11 +57,11 @@ export default class Push extends Command {
                     hux.styledHeader(`Building ${job.name} (${job.dockerfile})`);
                 }
                 await this.dockerHelper.buildImage({
-                    dockerfile: job.dockerfile,
-                    resource: job.resource,
+                    arch: this.config.arch,
                     buildArgs,
+                    dockerfile: job.dockerfile,
                     path: contextPath,
-                    arch: this.config.arch,
+                    resource: job.resource,
                 });
             }
         }

package/lib/commands/container/release.d.ts

@@ -1,14 +1,14 @@
 import { Command } from '@heroku-cli/command';
 export default class ContainerRelease extends Command {
-    static topic: string;
     static description: string;
-    static usage: string;
-    static example: string;
-    static strict: boolean;
+    static examples: string[];
     static flags: {
         app: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         remote: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
+    static strict: boolean;
+    static topic: string;
+    static usage: string;
     run(): Promise<void>;
 }

package/lib/commands/container/release.js

@@ -1,27 +1,28 @@
-import { color } from '@heroku-cli/color';
+import { color } from '@heroku/heroku-cli-util';
 import { Command, flags } from '@heroku-cli/command';
 import { ux } from '@oclif/core';
 import { debug } from '../../lib/container/debug.js';
-import { streamer } from '../../lib/container/streamer.js';
 import { ensureContainerStack } from '../../lib/container/helpers.js';
+import { streamer } from '../../lib/container/streamer.js';
 export default class ContainerRelease extends Command {
-    static topic = 'container';
     static description = 'Releases previously pushed Docker images to your Heroku app';
-    static usage = 'container:release';
-    static example = `
-  ${color.cmd('heroku container:release web')}        # Releases the previously pushed web process type
-  ${color.cmd('heroku container:release web worker')} # Releases the previously pushed web and worker process types`;
-    static strict = false;
+    static examples = [
+        `${color.command('heroku container:release web')}        # Releases the previously pushed web process type`,
+        `${color.command('heroku container:release web worker')} # Releases the previously pushed web and worker process types`,
+    ];
     static flags = {
         app: flags.app({ required: true }),
         remote: flags.remote(),
         verbose: flags.boolean({ char: 'v' }),
     };
+    static strict = false;
+    static topic = 'container';
+    static usage = 'container:release';
     async run() {
-        const { flags, argv } = await this.parse(ContainerRelease);
+        const { argv, flags } = await this.parse(ContainerRelease);
         const { app, verbose } = flags;
         if (argv.length === 0) {
-            this.error(`Error: Requires one or more process types\n ${ContainerRelease.example}`);
+            this.error(`Error: Requires one or more process types\n ${ContainerRelease.examples.join('\n')}`);
         }
         if (verbose) {
             debug.enabled = true;
@@ -34,11 +35,11 @@ export default class ContainerRelease extends Command {
             const image = `${app}/${process}`;
             const tag = 'latest';
             const { body: imageResp } = await this.heroku.get(`/v2/${image}/manifests/${tag}`, {
-                hostname: `registry.${herokuHost}`,
                 headers: {
                     Accept: 'application/vnd.docker.distribution.manifest.v2+json',
                     Authorization: `Basic ${Buffer.from(`:${this.heroku.auth}`).toString('base64')}`,
-                }
+                },
+                hostname: `registry.${herokuHost}`,
             });
             let imageID;
             let v1Comp;
@@ -54,11 +55,11 @@ export default class ContainerRelease extends Command {
                 }
             }
             updateData.push({
-                type: process, docker_image: imageID,
+                docker_image: imageID, type: process,
             });
         }
         const { body: oldReleases } = await this.heroku.get(`/apps/${app}/releases`, {
-            partial: true, headers: { Range: 'version ..; max=1, order=desc' },
+            headers: { Range: 'version ..; max=1, order=desc' }, partial: true,
         });
         const oldRelease = oldReleases[0];
         ux.action.start(`Releasing images ${argv.join(',')} to ${app}`);
@@ -69,7 +70,7 @@ export default class ContainerRelease extends Command {
         });
         ux.action.stop();
         const { body: updatedReleases } = await this.heroku.get(`/apps/${app}/releases`, {
-            partial: true, headers: { Range: 'version ..; max=1, order=desc' },
+            headers: { Range: 'version ..; max=1, order=desc' }, partial: true,
         });
         const release = updatedReleases[0];
         if ((!oldRelease && !release) || (oldRelease && (oldRelease.id === release.id))) {

package/lib/commands/container/rm.d.ts

@@ -1,13 +1,13 @@
 import { Command } from '@heroku-cli/command';
 export default class Rm extends Command {
-    static topic: string;
     static description: string;
-    static usage: string;
-    static example: string;
-    static strict: boolean;
+    static examples: string[];
     static flags: {
         app: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         remote: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
+    static strict: boolean;
+    static topic: string;
+    static usage: string;
     run(): Promise<void>;
 }

package/lib/commands/container/rm.js

@@ -1,34 +1,35 @@
+import { color } from '@heroku/heroku-cli-util';
 import { Command, flags } from '@heroku-cli/command';
 import { ux } from '@oclif/core';
-import { color } from '@heroku-cli/color';
 import { ensureContainerStack } from '../../lib/container/helpers.js';
 export default class Rm extends Command {
-    static topic = 'container';
     static description = 'remove the process type from your app';
-    static usage = 'container:rm -a APP [-v] PROCESS_TYPE...';
-    static example = `
-  ${color.cmd('heroku container:rm web')}        # Destroys the web container
-  ${color.cmd('heroku container:rm web worker')} # Destroys the web and worker containers`;
-    static strict = false;
+    static examples = [
+        `${color.command('heroku container:rm web')}        # Destroys the web container`,
+        `${color.command('heroku container:rm web worker')} # Destroys the web and worker containers`,
+    ];
     static flags = {
         app: flags.app({ required: true }),
         remote: flags.remote(),
     };
+    static strict = false;
+    static topic = 'container';
+    static usage = 'container:rm -a APP [-v] PROCESS_TYPE...';
     async run() {
         const { argv, flags } = await this.parse(Rm);
         const { app } = flags;
         if (argv.length === 0) {
-            this.error(`Error: Requires one or more process types\n${Rm.example}`);
+            this.error(`Error: Requires one or more process types\n${Rm.examples.join('\n')}`);
         }
         const { body: appBody } = await this.heroku.get(`/apps/${app}`);
         ensureContainerStack(appBody, 'rm');
         for (const process of argv) {
             ux.action.start(`Removing container ${process} for ${color.app(app)}`);
             await this.heroku.patch(`/apps/${app}/formation/${process}`, {
+                body: { docker_image: null },
                 headers: {
                     Accept: 'application/vnd.heroku+json; version=3.docker-releases',
                 },
-                body: { docker_image: null },
             });
             ux.action.stop();
         }

package/lib/commands/container/run.d.ts

@@ -1,17 +1,17 @@
 import { Command } from '@heroku-cli/command';
 import { DockerHelper } from '../../lib/container/docker_helper.js';
 export default class Run extends Command {
-    static topic: string;
     static description: string;
-    static usage: string;
-    static example: string;
-    static strict: boolean;
+    static examples: string[];
     static flags: {
         app: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        remote: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         port: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        remote: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
+    static strict: boolean;
+    static topic: string;
+    static usage: string;
     dockerHelper: DockerHelper;
     run(): Promise<void>;
 }