oclif 3.0.1 → 3.1.2

package/.oclif.manifest.json

@@ -1 +1 @@
-{"version":"3.0.1","commands":{"generate":{"id":"generate","description":"generate a new CLI\nThis will clone the template repo 'oclif/hello-world' and update package properties","strict":true,"pluginName":"oclif","pluginAlias":"oclif","pluginType":"core","aliases":[],"flags":{},"args":[{"name":"name","description":"directory name of new project","required":true}],"_globalFlags":{}},"manifest":{"id":"manifest","description":"generates plugin manifest json","strict":true,"pluginName":"oclif","pluginAlias":"oclif","pluginType":"core","aliases":[],"flags":{},"args":[{"name":"path","description":"path to plugin","default":"."}]},"promote":{"id":"promote","description":"promote CLI builds to a S3 release channel","strict":true,"pluginName":"oclif","pluginAlias":"oclif","pluginType":"core","aliases":[],"flags":{"root":{"name":"root","type":"option","char":"r","description":"path to the oclif CLI project root","required":true,"multiple":false,"default":"."},"version":{"name":"version","type":"option","description":"semantic version of the CLI to promote","required":true,"multiple":false},"sha":{"name":"sha","type":"option","description":"7-digit short git commit SHA of the CLI to promote","required":true,"multiple":false},"channel":{"name":"channel","type":"option","description":"which channel to promote to","required":true,"multiple":false,"default":"stable"},"targets":{"name":"targets","type":"option","char":"t","description":"comma-separated targets to promote (e.g.: linux-arm,win32-x64)","multiple":false},"deb":{"name":"deb","type":"boolean","char":"d","description":"promote debian artifacts","allowNo":false},"macos":{"name":"macos","type":"boolean","char":"m","description":"promote macOS pkg","allowNo":false},"win":{"name":"win","type":"boolean","char":"w","description":"promote Windows exe","allowNo":false},"max-age":{"name":"max-age","type":"option","char":"a","description":"cache control max-age in seconds","multiple":false,"default":"86400"},"xz":{"name":"xz","type":"boolean","description":"also upload xz","allowNo":true},"indexes":{"name":"indexes","type":"boolean","description":"append the promoted urls into the index files","allowNo":false}},"args":[],"_globalFlags":{}},"readme":{"id":"readme","description":"adds commands to README.md in current directory\nThe readme must have any of the following tags inside of it for it to be replaced or else it will do nothing:\n# Usage\n<!-- usage -->\n# Commands\n<!-- commands -->\n\nCustomize the code URL prefix by setting oclif.repositoryPrefix in package.json.\n","strict":true,"pluginName":"oclif","pluginAlias":"oclif","pluginType":"core","aliases":[],"flags":{"dir":{"name":"dir","type":"option","description":"output directory for multi docs","required":true,"multiple":false,"default":"docs"},"multi":{"name":"multi","type":"boolean","description":"create a different markdown page for each topic","allowNo":false}},"args":[],"_globalFlags":{}},"generate:command":{"id":"generate:command","description":"add a command to an existing CLI or plugin","strict":true,"pluginName":"oclif","pluginAlias":"oclif","pluginType":"core","aliases":[],"flags":{"force":{"name":"force","type":"boolean","description":"overwrite existing files","allowNo":false}},"args":[{"name":"name","description":"name of command","required":true}],"_globalFlags":{}},"generate:hook":{"id":"generate:hook","description":"add a hook to an existing CLI or plugin","strict":true,"pluginName":"oclif","pluginAlias":"oclif","pluginType":"core","aliases":[],"flags":{"force":{"name":"force","type":"boolean","description":"overwrite existing files","allowNo":false},"event":{"name":"event","type":"option","description":"event to run hook on","multiple":false,"default":"init"}},"args":[{"name":"name","description":"name of hook (snake_case)","required":true}],"_globalFlags":{}},"pack:deb":{"id":"pack:deb","description":"pack CLI into debian package","strict":true,"pluginName":"oclif","pluginAlias":"oclif","pluginType":"core","aliases":[],"flags":{"root":{"name":"root","type":"option","char":"r","description":"path to oclif CLI root","required":true,"multiple":false,"default":"."},"tarball":{"name":"tarball","type":"option","char":"t","description":"optionally specify a path to a tarball already generated by NPM","required":false,"multiple":false}},"args":[],"_globalFlags":{}},"pack:macos":{"id":"pack:macos","description":"pack CLI into macOS .pkg","strict":true,"pluginName":"oclif","pluginAlias":"oclif","pluginType":"core","aliases":[],"flags":{"root":{"name":"root","type":"option","char":"r","description":"path to oclif CLI root","required":true,"multiple":false,"default":"."},"additional-cli":{"name":"additional-cli","type":"option","description":"an Oclif CLI other than the one listed in config.bin that should be made available to the user\nthe CLI should already exist in a directory named after the CLI that is the root of the tarball produced by \"oclif pack:tarballs\"","hidden":true,"multiple":false},"tarball":{"name":"tarball","type":"option","char":"t","description":"optionally specify a path to a tarball already generated by NPM","required":false,"multiple":false}},"args":[],"_globalFlags":{}},"pack:tarballs":{"id":"pack:tarballs","description":"packages oclif CLI into tarballs\n\nThis can be used to create oclif CLIs that use the system node or that come preloaded with a node binary.\n","strict":true,"pluginName":"oclif","pluginAlias":"oclif","pluginType":"core","aliases":[],"flags":{"root":{"name":"root","type":"option","char":"r","description":"path to oclif CLI root","required":true,"multiple":false,"default":"."},"targets":{"name":"targets","type":"option","char":"t","description":"comma-separated targets to pack (e.g.: linux-arm,win32-x64)","multiple":false},"xz":{"name":"xz","type":"boolean","description":"also build xz","allowNo":true},"tarball":{"name":"tarball","type":"option","char":"l","description":"optionally specify a path to a tarball already generated by NPM","required":false,"multiple":false}},"args":[],"_globalFlags":{}},"pack:win":{"id":"pack:win","description":"create windows installer from oclif CLI\n\n  This command requires WINDOWS_SIGNING (prefixed with the name of your executable, e.g. OCLIF_WINDOWS_SIGNING_PASS) to be set in the environment","strict":true,"pluginName":"oclif","pluginAlias":"oclif","pluginType":"core","aliases":[],"flags":{"root":{"name":"root","type":"option","char":"r","description":"path to oclif CLI root","required":true,"multiple":false,"default":"."},"additional-cli":{"name":"additional-cli","type":"option","description":"an Oclif CLI other than the one listed in config.bin that should be made available to the user\nthe CLI should already exist in a directory named after the CLI that is the root of the tarball produced by \"oclif pack:tarballs\"","hidden":true,"multiple":false},"tarball":{"name":"tarball","type":"option","char":"t","description":"optionally specify a path to a tarball already generated by NPM","required":false,"multiple":false}},"args":[],"_globalFlags":{}},"upload:deb":{"id":"upload:deb","description":"upload deb package built with pack:deb","strict":true,"pluginName":"oclif","pluginAlias":"oclif","pluginType":"core","aliases":[],"flags":{"root":{"name":"root","type":"option","char":"r","description":"path to oclif CLI root","required":true,"multiple":false,"default":"."}},"args":[],"_globalFlags":{}},"upload:macos":{"id":"upload:macos","description":"upload macos installers built with pack:macos","strict":true,"pluginName":"oclif","pluginAlias":"oclif","pluginType":"core","aliases":[],"flags":{"root":{"name":"root","type":"option","char":"r","description":"path to oclif CLI root","required":true,"multiple":false,"default":"."}},"args":[],"_globalFlags":{}},"upload:tarballs":{"id":"upload:tarballs","description":"upload an oclif CLI to S3\n\n\"aws-sdk\" will need to be installed as a devDependency to upload.\n","strict":true,"pluginName":"oclif","pluginAlias":"oclif","pluginType":"core","aliases":[],"flags":{"root":{"name":"root","type":"option","char":"r","description":"path to oclif CLI root","required":true,"multiple":false,"default":"."},"targets":{"name":"targets","type":"option","char":"t","description":"comma-separated targets to upload (e.g.: linux-arm,win32-x64)","multiple":false},"xz":{"name":"xz","type":"boolean","description":"also upload xz","allowNo":true}},"args":[],"_globalFlags":{}},"upload:win":{"id":"upload:win","description":"upload windows installers built with pack:win","strict":true,"pluginName":"oclif","pluginAlias":"oclif","pluginType":"core","aliases":[],"flags":{"root":{"name":"root","type":"option","char":"r","description":"path to oclif CLI root","required":true,"multiple":false,"default":"."}},"args":[],"_globalFlags":{}}}}
+{"version":"3.1.2","commands":{"generate":{"id":"generate","description":"generate a new CLI\nThis will clone the template repo 'oclif/hello-world' and update package properties","strict":true,"pluginName":"oclif","pluginAlias":"oclif","pluginType":"core","aliases":[],"flags":{},"args":[{"name":"name","description":"directory name of new project","required":true}],"_globalFlags":{}},"manifest":{"id":"manifest","description":"generates plugin manifest json","strict":true,"pluginName":"oclif","pluginAlias":"oclif","pluginType":"core","aliases":[],"flags":{},"args":[{"name":"path","description":"path to plugin","default":"."}]},"promote":{"id":"promote","description":"promote CLI builds to a S3 release channel","strict":true,"pluginName":"oclif","pluginAlias":"oclif","pluginType":"core","aliases":[],"flags":{"root":{"name":"root","type":"option","char":"r","description":"path to the oclif CLI project root","required":true,"multiple":false,"default":"."},"version":{"name":"version","type":"option","description":"semantic version of the CLI to promote","required":true,"multiple":false},"sha":{"name":"sha","type":"option","description":"7-digit short git commit SHA of the CLI to promote","required":true,"multiple":false},"channel":{"name":"channel","type":"option","description":"which channel to promote to","required":true,"multiple":false,"default":"stable"},"targets":{"name":"targets","type":"option","char":"t","description":"comma-separated targets to promote (e.g.: linux-arm,win32-x64)","multiple":false},"deb":{"name":"deb","type":"boolean","char":"d","description":"promote debian artifacts","allowNo":false},"macos":{"name":"macos","type":"boolean","char":"m","description":"promote macOS pkg","allowNo":false},"win":{"name":"win","type":"boolean","char":"w","description":"promote Windows exe","allowNo":false},"max-age":{"name":"max-age","type":"option","char":"a","description":"cache control max-age in seconds","multiple":false,"default":"86400"},"xz":{"name":"xz","type":"boolean","description":"also upload xz","allowNo":true},"indexes":{"name":"indexes","type":"boolean","description":"append the promoted urls into the index files","allowNo":false}},"args":[],"_globalFlags":{}},"readme":{"id":"readme","description":"adds commands to README.md in current directory\nThe readme must have any of the following tags inside of it for it to be replaced or else it will do nothing:\n# Usage\n<!-- usage -->\n# Commands\n<!-- commands -->\n\nCustomize the code URL prefix by setting oclif.repositoryPrefix in package.json.\n","strict":true,"pluginName":"oclif","pluginAlias":"oclif","pluginType":"core","aliases":[],"flags":{"dir":{"name":"dir","type":"option","description":"output directory for multi docs","required":true,"multiple":false,"default":"docs"},"multi":{"name":"multi","type":"boolean","description":"create a different markdown page for each topic","allowNo":false}},"args":[],"_globalFlags":{}},"generate:command":{"id":"generate:command","description":"add a command to an existing CLI or plugin","strict":true,"pluginName":"oclif","pluginAlias":"oclif","pluginType":"core","aliases":[],"flags":{"force":{"name":"force","type":"boolean","description":"overwrite existing files","allowNo":false}},"args":[{"name":"name","description":"name of command","required":true}],"_globalFlags":{}},"generate:hook":{"id":"generate:hook","description":"add a hook to an existing CLI or plugin","strict":true,"pluginName":"oclif","pluginAlias":"oclif","pluginType":"core","aliases":[],"flags":{"force":{"name":"force","type":"boolean","description":"overwrite existing files","allowNo":false},"event":{"name":"event","type":"option","description":"event to run hook on","multiple":false,"default":"init"}},"args":[{"name":"name","description":"name of hook (snake_case)","required":true}],"_globalFlags":{}},"pack:deb":{"id":"pack:deb","description":"pack CLI into debian package","strict":true,"pluginName":"oclif","pluginAlias":"oclif","pluginType":"core","aliases":[],"flags":{"root":{"name":"root","type":"option","char":"r","description":"path to oclif CLI root","required":true,"multiple":false,"default":"."},"tarball":{"name":"tarball","type":"option","char":"t","description":"optionally specify a path to a tarball already generated by NPM","required":false,"multiple":false}},"args":[],"_globalFlags":{}},"pack:macos":{"id":"pack:macos","description":"pack CLI into macOS .pkg","strict":true,"pluginName":"oclif","pluginAlias":"oclif","pluginType":"core","aliases":[],"flags":{"root":{"name":"root","type":"option","char":"r","description":"path to oclif CLI root","required":true,"multiple":false,"default":"."},"additional-cli":{"name":"additional-cli","type":"option","description":"an Oclif CLI other than the one listed in config.bin that should be made available to the user\nthe CLI should already exist in a directory named after the CLI that is the root of the tarball produced by \"oclif pack:tarballs\"","hidden":true,"multiple":false},"tarball":{"name":"tarball","type":"option","char":"t","description":"optionally specify a path to a tarball already generated by NPM","required":false,"multiple":false}},"args":[],"_globalFlags":{}},"pack:tarballs":{"id":"pack:tarballs","description":"packages oclif CLI into tarballs\n\nThis can be used to create oclif CLIs that use the system node or that come preloaded with a node binary.\n","strict":true,"pluginName":"oclif","pluginAlias":"oclif","pluginType":"core","aliases":[],"flags":{"root":{"name":"root","type":"option","char":"r","description":"path to oclif CLI root","required":true,"multiple":false,"default":"."},"targets":{"name":"targets","type":"option","char":"t","description":"comma-separated targets to pack (e.g.: linux-arm,win32-x64)","multiple":false},"xz":{"name":"xz","type":"boolean","description":"also build xz","allowNo":true},"parallel":{"name":"parallel","type":"boolean","description":"build tarballs in parallel","allowNo":false},"tarball":{"name":"tarball","type":"option","char":"l","description":"optionally specify a path to a tarball already generated by NPM","required":false,"multiple":false}},"args":[],"_globalFlags":{}},"pack:win":{"id":"pack:win","description":"create windows installer from oclif CLI\n\n  This command requires WINDOWS_SIGNING (prefixed with the name of your executable, e.g. OCLIF_WINDOWS_SIGNING_PASS) to be set in the environment","strict":true,"pluginName":"oclif","pluginAlias":"oclif","pluginType":"core","aliases":[],"flags":{"root":{"name":"root","type":"option","char":"r","description":"path to oclif CLI root","required":true,"multiple":false,"default":"."},"additional-cli":{"name":"additional-cli","type":"option","description":"an Oclif CLI other than the one listed in config.bin that should be made available to the user\nthe CLI should already exist in a directory named after the CLI that is the root of the tarball produced by \"oclif pack:tarballs\"","hidden":true,"multiple":false},"tarball":{"name":"tarball","type":"option","char":"t","description":"optionally specify a path to a tarball already generated by NPM","required":false,"multiple":false}},"args":[],"_globalFlags":{}},"upload:deb":{"id":"upload:deb","description":"upload deb package built with pack:deb","strict":true,"pluginName":"oclif","pluginAlias":"oclif","pluginType":"core","aliases":[],"flags":{"root":{"name":"root","type":"option","char":"r","description":"path to oclif CLI root","required":true,"multiple":false,"default":"."}},"args":[],"_globalFlags":{}},"upload:macos":{"id":"upload:macos","description":"upload macos installers built with pack:macos","strict":true,"pluginName":"oclif","pluginAlias":"oclif","pluginType":"core","aliases":[],"flags":{"root":{"name":"root","type":"option","char":"r","description":"path to oclif CLI root","required":true,"multiple":false,"default":"."}},"args":[],"_globalFlags":{}},"upload:tarballs":{"id":"upload:tarballs","description":"upload an oclif CLI to S3\n\n\"aws-sdk\" will need to be installed as a devDependency to upload.\n","strict":true,"pluginName":"oclif","pluginAlias":"oclif","pluginType":"core","aliases":[],"flags":{"root":{"name":"root","type":"option","char":"r","description":"path to oclif CLI root","required":true,"multiple":false,"default":"."},"targets":{"name":"targets","type":"option","char":"t","description":"comma-separated targets to upload (e.g.: linux-arm,win32-x64)","multiple":false},"xz":{"name":"xz","type":"boolean","description":"also upload xz","allowNo":true}},"args":[],"_globalFlags":{}},"upload:win":{"id":"upload:win","description":"upload windows installers built with pack:win","strict":true,"pluginName":"oclif","pluginAlias":"oclif","pluginType":"core","aliases":[],"flags":{"root":{"name":"root","type":"option","char":"r","description":"path to oclif CLI root","required":true,"multiple":false,"default":"."}},"args":[],"_globalFlags":{}}}}

package/CHANGELOG.md

@@ -2,6 +2,27 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+### [3.1.2](https://github.com/oclif/oclif/compare/v3.1.1...v3.1.2) (2022-07-27)
+
+
+### Bug Fixes
+
+* await yeoman generators ([#926](https://github.com/oclif/oclif/issues/926)) ([da5a4d2](https://github.com/oclif/oclif/commit/da5a4d202be114fe7f0c00d2737a9faf8f4e19ab))
+
+### [3.1.1](https://github.com/oclif/oclif/compare/v3.1.0...v3.1.1) (2022-07-15)
+
+
+### Bug Fixes
+
+* readme for single command cli ([#916](https://github.com/oclif/oclif/issues/916)) ([242b34f](https://github.com/oclif/oclif/commit/242b34f62656b2c6ee8a1d0ecda8d98f8c1c5bbc))
+
+## [3.1.0](https://github.com/oclif/oclif/compare/v3.0.1...v3.1.0) (2022-07-07)
+
+
+### Features
+
+* build/pack in parallel ([#914](https://github.com/oclif/oclif/issues/914)) ([d86c722](https://github.com/oclif/oclif/commit/d86c722d8de66560c672c2fbdb338cc9a024caa2))
+
 ### [3.0.1](https://github.com/oclif/oclif/compare/v3.0.0...v3.0.1) (2022-04-18)
 
 

package/README.md

@@ -146,7 +146,7 @@ DESCRIPTION
   This will clone the template repo 'oclif/hello-world' and update package properties
 ```
 
-_See code: [src/commands/generate.ts](https://github.com/oclif/oclif/blob/v3.0.0/src/commands/generate.ts)_
+_See code: [src/commands/generate.ts](https://github.com/oclif/oclif/blob/v3.1.1/src/commands/generate.ts)_
 
 ## `oclif generate command NAME`
 
@@ -220,7 +220,7 @@ DESCRIPTION
   generates plugin manifest json
 ```
 
-_See code: [src/commands/manifest.ts](https://github.com/oclif/oclif/blob/v3.0.0/src/commands/manifest.ts)_
+_See code: [src/commands/manifest.ts](https://github.com/oclif/oclif/blob/v3.1.1/src/commands/manifest.ts)_
 
 ## `oclif pack deb`
 
@@ -260,12 +260,13 @@ packages oclif CLI into tarballs
 
 ```
 USAGE
-  $ oclif pack tarballs -r <value> [-t <value>] [--xz] [-l <value>]
+  $ oclif pack tarballs -r <value> [-t <value>] [--xz] [--parallel] [-l <value>]
 
 FLAGS
   -l, --tarball=<value>  optionally specify a path to a tarball already generated by NPM
   -r, --root=<value>     (required) [default: .] path to oclif CLI root
   -t, --targets=<value>  comma-separated targets to pack (e.g.: linux-arm,win32-x64)
+  --parallel             build tarballs in parallel
   --[no-]xz              also build xz
 
 DESCRIPTION
@@ -319,7 +320,7 @@ DESCRIPTION
   promote CLI builds to a S3 release channel
 ```
 
-_See code: [src/commands/promote.ts](https://github.com/oclif/oclif/blob/v3.0.0/src/commands/promote.ts)_
+_See code: [src/commands/promote.ts](https://github.com/oclif/oclif/blob/v3.1.1/src/commands/promote.ts)_
 
 ## `oclif readme`
 
@@ -349,7 +350,7 @@ DESCRIPTION
   Customize the code URL prefix by setting oclif.repositoryPrefix in package.json.
 ```
 
-_See code: [src/commands/readme.ts](https://github.com/oclif/oclif/blob/v3.0.0/src/commands/readme.ts)_
+_See code: [src/commands/readme.ts](https://github.com/oclif/oclif/blob/v3.1.1/src/commands/readme.ts)_
 
 ## `oclif upload deb`
 

package/lib/command-base.d.ts

@@ -1,4 +1,4 @@
 import { Command } from '@oclif/core';
 export default abstract class CommandBase extends Command {
-    protected generate(type: string, generatorOptions?: Record<string, unknown>): void;
+    protected generate(type: string, generatorOptions?: Record<string, unknown>): Promise<void>;
 }

package/lib/command-base.js

@@ -3,12 +3,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@oclif/core");
 const yeoman_environment_1 = require("yeoman-environment");
 class CommandBase extends core_1.Command {
-    generate(type, generatorOptions = {}) {
+    async generate(type, generatorOptions = {}) {
         const env = (0, yeoman_environment_1.createEnv)();
         env.register(require.resolve(`./generators/${type}`), `oclif:${type}`);
         // eslint-disable-next-line @typescript-eslint/ban-ts-comment
         // @ts-ignore
-        env.run(`oclif:${type}`, generatorOptions);
+        await env.run(`oclif:${type}`, generatorOptions);
     }
 }
 exports.default = CommandBase;

package/lib/commands/generate/command.js

@@ -5,7 +5,7 @@ const core_1 = require("@oclif/core");
 class GenerateCommand extends command_base_1.default {
     async run() {
         const { args, flags } = await this.parse(GenerateCommand);
-        super.generate('command', {
+        await super.generate('command', {
             name: args.name,
             force: flags.force,
         });

package/lib/commands/generate/hook.js

@@ -5,7 +5,7 @@ const core_1 = require("@oclif/core");
 class GenerateHook extends command_base_1.default {
     async run() {
         const { args, flags } = await this.parse(GenerateHook);
-        super.generate('hook', {
+        await super.generate('hook', {
             name: args.name,
             event: flags.event,
             force: flags.force,

package/lib/commands/generate.js

@@ -4,7 +4,7 @@ const command_base_1 = require("./../command-base");
 class Generate extends command_base_1.default {
     async run() {
         const { args } = await this.parse(Generate);
-        super.generate('cli', {
+        await super.generate('cli', {
             name: args.name,
             force: true,
         });

package/lib/commands/pack/tarballs.d.ts

@@ -5,6 +5,7 @@ export default class PackTarballs extends Command {
         root: import("@oclif/core/lib/interfaces").OptionFlag<string>;
         targets: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined>;
         xz: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        parallel: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         tarball: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined>;
     };
     run(): Promise<void>;

package/lib/commands/pack/tarballs.js

@@ -16,6 +16,7 @@ class PackTarballs extends core_1.Command {
         }
         await Tarballs.build(buildConfig, {
             tarball: flags.tarball,
+            parallel: flags.parallel,
         });
         qq.cd(prevCwd);
     }
@@ -29,5 +30,6 @@ PackTarballs.flags = {
     root: core_1.Flags.string({ char: 'r', description: 'path to oclif CLI root', default: '.', required: true }),
     targets: core_1.Flags.string({ char: 't', description: 'comma-separated targets to pack (e.g.: linux-arm,win32-x64)' }),
     xz: core_1.Flags.boolean({ description: 'also build xz', allowNo: true }),
+    parallel: core_1.Flags.boolean({ description: 'build tarballs in parallel' }),
     tarball: core_1.Flags.string({ char: 'l', description: 'optionally specify a path to a tarball already generated by NPM', required: false }),
 };

package/lib/commands/readme.js

@@ -27,9 +27,9 @@ class Readme extends core_1.Command {
         await config.runHook('init', { id: 'readme', argv: this.argv });
         this.HelpClass = await (0, core_1.loadHelpClass)(config);
         let readme = await fs.readFile(readmePath, 'utf8');
-        let commands = config.commands;
-        commands = commands.filter(c => !c.hidden);
-        commands = commands.filter(c => c.pluginType === 'core');
+        let commands = config.commands
+            .filter(c => !c.hidden && c.pluginType === 'core')
+            .map(c => c.id === '.' ? Object.assign(Object.assign({}, c), { id: '' }) : c);
         this.debug('commands:', commands.map(c => c.id).length);
         commands = (0, util_1.uniqBy)(commands, c => c.id);
         commands = (0, util_1.sortBy)(commands, c => c.id);
@@ -108,7 +108,7 @@ USAGE
         return [
             ...commands.map(c => {
                 const usage = this.commandUsage(config, c);
-                return `* [\`${config.bin} ${usage}\`](#${slugify.slug(`${config.bin}-${usage}`)})`;
+                return usage ? `* [\`${config.bin} ${usage}\`](#${slugify.slug(`${config.bin}-${usage}`)})` : `* [\`${config.bin}\`](#${slugify.slug(`${config.bin}`)})`;
             }),
             '',
             ...commands.map(c => this.renderCommand(config, c)).map(s => s.trim() + '\n'),
@@ -119,7 +119,10 @@ USAGE
         const title = (0, util_1.template)({ config, command: c })(c.summary || c.description || '').trim().split('\n')[0];
         const help = new this.HelpClass(config, { stripAnsi: true, maxWidth: columns });
         const wrapper = new help_compatibility_1.HelpCompatibilityWrapper(help);
-        const header = () => `## \`${config.bin} ${this.commandUsage(config, c)}\``;
+        const header = () => {
+            const usage = this.commandUsage(config, c);
+            return usage ? `## \`${config.bin} ${usage}\`` : `## \`${config.bin}\``;
+        };
         try {
             return (0, util_1.compact)([
                 header(),
@@ -211,7 +214,7 @@ USAGE
                 return `${name}`;
             return `[${name}]`;
         };
-        const id = config.topicSeparator ? command.id.replace(/:/g, config.topicSeparator) : command.id;
+        const id = (0, core_1.toConfiguredId)(command.id, config);
         const defaultUsage = () => {
             return (0, util_1.compact)([
                 id,

package/lib/tarballs/build.d.ts

@@ -3,4 +3,5 @@ export declare function build(c: BuildConfig, options?: {
     platform?: string;
     pack?: boolean;
     tarball?: string;
+    parallel?: boolean;
 }): Promise<void>;

package/lib/tarballs/build.js

@@ -104,9 +104,15 @@ async function build(c, options = {}) {
         });
         if (options.pack === false)
             return;
-        await pack(workspace, c.dist(gzLocalKey));
-        if (xz)
-            await pack(workspace, c.dist(xzLocalKey));
+        if (options.parallel) {
+            await Promise.all([pack(workspace, c.dist(gzLocalKey))]
+                .concat(xz ? [pack(workspace, c.dist(xzLocalKey))] : []));
+        }
+        else {
+            await pack(workspace, c.dist(gzLocalKey));
+            if (xz)
+                await pack(workspace, c.dist(xzLocalKey));
+        }
         if (!c.updateConfig.s3.host)
             return;
         const rollout = (typeof c.updateConfig.autoupdate === 'object' && c.updateConfig.autoupdate.rollout);
@@ -141,8 +147,14 @@ async function build(c, options = {}) {
     await addDependencies();
     await (0, bin_1.writeBinScripts)({ config, baseWorkspace: c.workspace(), nodeVersion: c.nodeVersion });
     await pretarball();
-    for (const target of c.targets) {
-        if (!options.platform || options.platform === target.platform) {
+    const targetsToBuild = c.targets.filter(t => !options.platform || options.platform === t.platform);
+    if (options.parallel) {
+        (0, log_1.log)(`will build ${targetsToBuild.length} targets in parallel`);
+        await Promise.all(targetsToBuild.map(t => buildTarget(t)));
+    }
+    else {
+        (0, log_1.log)(`will build ${targetsToBuild.length} targets sequentially`);
+        for (const target of targetsToBuild) {
             // eslint-disable-next-line no-await-in-loop
             await buildTarget(target);
         }

package/lib/tarballs/node.js

@@ -41,19 +41,17 @@ async function fetchNodeBinary({ nodeVersion, output, platform, arch, tmp }) {
         const basedir = path.dirname(tarball);
         await qq.mkdirp(basedir);
         await qq.download(url, tarball);
-        await qq.x(`grep "${path.basename(tarball)}" "${shasums}" | shasum -a 256 -c -`, { cwd: basedir });
+        if (platform !== 'win32')
+            await qq.x(`grep "${path.basename(tarball)}" "${shasums}" | shasum -a 256 -c -`, { cwd: basedir });
     };
     const extract = async () => {
         (0, log_1.log)(`extracting ${nodeBase}`);
         const nodeTmp = path.join(tmp, 'node');
-        await qq.rm([nodeTmp, nodeBase]);
         await qq.mkdirp(nodeTmp);
         await qq.mkdirp(path.dirname(cache));
         if (platform === 'win32') {
-            qq.pushd(nodeTmp);
-            await qq.x(`7z x -bd -y "${tarball}" > /dev/null`);
-            await qq.mv([nodeBase, 'node.exe'], cache);
-            qq.popd();
+            await qq.x(`7z x -bd -y "${tarball}"`, { cwd: nodeTmp });
+            await qq.mv([nodeTmp, nodeBase, 'node.exe'], cache);
         }
         else {
             await qq.x(`tar -C "${tmp}/node" -xJf "${tarball}"`);

package/package.json

@@ -1,18 +1,18 @@
 {
   "name": "oclif",
   "description": "oclif: create your own CLI",
-  "version": "3.0.1",
+  "version": "3.1.2",
   "author": "Salesforce",
   "bin": {
     "oclif": "bin/run"
   },
   "bugs": "https://github.com/oclif/oclif/issues",
   "dependencies": {
-    "@oclif/core": "^1.6.4",
+    "@oclif/core": "^1.9.9",
     "@oclif/plugin-help": "^5.1.12",
     "@oclif/plugin-not-found": "^2.3.1",
     "@oclif/plugin-warn-if-update-available": "^2.0.4",
-    "aws-sdk": "^2.1069.0",
+    "aws-sdk": "^2.1116.0",
     "concurrently": "^7.0.0",
     "debug": "^4.3.3",
     "find-yarn-workspace-root": "^2.0.0",
@@ -29,7 +29,7 @@
   },
   "devDependencies": {
     "@oclif/plugin-legacy": "^1.2.7",
-    "@oclif/test": "^2.0.3",
+    "@oclif/test": "^2.1.0",
     "@types/chai": "^4.3.0",
     "@types/execa": "^0.9.0",
     "@types/fs-extra": "^9.0",
@@ -42,7 +42,7 @@
     "@types/shelljs": "^0.8.11",
     "@types/supports-color": "^7.2.1",
     "@types/write-json-file": "^3.2.1",
-    "@types/yeoman-generator": "^5.2.9",
+    "@types/yeoman-generator": "^5.2.10",
     "@types/yosay": "^2.0.1",
     "chai": "^4.3.6",
     "conventional-changelog-cli": "^2.2.2",
@@ -52,13 +52,13 @@
     "execa": "^0.11.0",
     "fancy-test": "^1.4.10",
     "globby": "^11.1.0",
-    "mocha": "^9.2.0",
+    "mocha": "^9.2.2",
     "npm-run-path": "^4.0.1",
     "nps": "^5.10.0",
     "shelljs": "^0.8.5",
     "shx": "^0.3.4",
     "tmp": "^0.2.1",
-    "ts-node": "^10.4.0",
+    "ts-node": "^10.7.0",
     "typescript": "4.5.5"
   },
   "resolutions": {