@automattic/vip 2.40.0-dev.4 → 3.1.0

package/dist/bin/vip-app-deploy.js

@@ -22,7 +22,7 @@ var _customDeploy = require("../lib/custom-deploy/custom-deploy");
 var _tracker = require("../lib/tracker");
 function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
 function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 /**
  * Internal dependencies
  */

package/dist/bin/vip-app-list.js

@@ -5,7 +5,7 @@ var _graphqlTag = _interopRequireDefault(require("graphql-tag"));
 var _api = _interopRequireDefault(require("../lib/api"));
 var _command = _interopRequireDefault(require("../lib/cli/command"));
 var _tracker = require("../lib/tracker");
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 (0, _command.default)({
   format: true
 }).argv(process.argv, async () => {

package/dist/bin/vip-app.js

@@ -7,7 +7,7 @@ var _command = _interopRequireWildcard(require("../lib/cli/command"));
 var _tracker = require("../lib/tracker");
 function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
 function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 (0, _command.default)({
   requiredArgs: 1,
   format: true

package/dist/bin/vip-backup-db.js

@@ -4,7 +4,7 @@
 var _backupDb = require("../commands/backup-db");
 var _command = _interopRequireDefault(require("../lib/cli/command"));
 var _tracker = require("../lib/tracker");
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 const examples = [{
   usage: 'vip @example-app.develop backup db\n' + '      Generating a new database backup...\n' + '      ✓ Preparing for backup generation\n' + '      ✓ Generating backup\n' + '      New database backup created',
   description: 'Generate a new database backup of an environment.'

package/dist/bin/vip-backup.js

@@ -3,7 +3,7 @@
 
 var _command = _interopRequireDefault(require("../lib/cli/command"));
 var _tracker = require("../lib/tracker");
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 void (0, _command.default)({
   usage: 'vip backup'
 }).command('db', 'Generate a new database backup of an environment.').example('vip @example-app.develop backup db\n' + '      Generating a new database backup...\n' + '      ✓ Preparing for backup generation\n' + '      ✓ Generating backup\n' + '      New database backup created', 'Generate a new database backup of an environment.').argv(process.argv, async () => {

package/dist/bin/vip-cache-purge-url.js

@@ -10,7 +10,7 @@ var _readFile = require("../lib/read-file");
 var _tracker = require("../lib/tracker");
 function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
 function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 const examples = [{
   usage: 'vip cache purge-url <URL>',
   description: 'Purge a URL from page cache'

package/dist/bin/vip-cache.js

@@ -2,7 +2,7 @@
 "use strict";
 
 var _command = _interopRequireDefault(require("../lib/cli/command"));
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 (0, _command.default)({
   requiredArgs: 1
 }).command('purge-url', 'Purge page cache').argv(process.argv);

package/dist/bin/vip-config-envvar-delete.js

@@ -9,7 +9,7 @@ var _api = require("../lib/envvar/api");
 var _input = require("../lib/envvar/input");
 var _logging = require("../lib/envvar/logging");
 var _tracker = require("../lib/tracker");
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 const baseUsage = 'vip config envvar delete';
 const exampleUsage = 'vip @example-app.develop config envvar delete';
 

package/dist/bin/vip-config-envvar-get-all.js

@@ -9,7 +9,7 @@ var _format = require("../lib/cli/format");
 var _api = require("../lib/envvar/api");
 var _logging = require("../lib/envvar/logging");
 var _tracker = require("../lib/tracker");
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 const exampleUsage = 'vip @example-app.develop config envvar get-all';
 const usage = 'vip config envvar get-all';
 

package/dist/bin/vip-config-envvar-get.js

@@ -8,7 +8,7 @@ var _command = _interopRequireDefault(require("../lib/cli/command"));
 var _api = require("../lib/envvar/api");
 var _logging = require("../lib/envvar/logging");
 var _tracker = require("../lib/tracker");
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 const baseUsage = 'vip config envvar get';
 const exampleUsage = 'vip @example-app.develop config envvar get';
 

package/dist/bin/vip-config-envvar-list.js

@@ -9,7 +9,7 @@ var _format = require("../lib/cli/format");
 var _api = require("../lib/envvar/api");
 var _logging = require("../lib/envvar/logging");
 var _tracker = require("../lib/tracker");
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 const usage = 'vip config envvar list';
 const exampleUsage = 'vip @example-app.develop config envvar list';
 

package/dist/bin/vip-config-envvar-set.js

@@ -10,7 +10,7 @@ var _input = require("../lib/envvar/input");
 var _logging = require("../lib/envvar/logging");
 var _readFile = require("../lib/envvar/read-file");
 var _tracker = require("../lib/tracker");
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 const baseUsage = 'vip config envvar set';
 const exampleUsage = 'vip @example-app.develop config envvar set';
 const NEW_RELIC_ENVVAR_KEY = 'NEW_RELIC_LICENSE_KEY';

package/dist/bin/vip-config-envvar.js

@@ -2,7 +2,7 @@
 "use strict";
 
 var _command = _interopRequireDefault(require("../lib/cli/command"));
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 const usage = 'vip config envvar';
 const exampleUsage = 'vip @example-app.develop config envvar';
 

package/dist/bin/vip-config-software-get.js

@@ -6,7 +6,7 @@ var _format = require("../lib/cli/format");
 var _software = require("../lib/config/software");
 var _tracker = require("../lib/tracker");
 var _userError = _interopRequireDefault(require("../lib/user-error"));
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 const usage = 'vip config software get <wordpress|php|nodejs|muplugins>';
 const exampleUsage = 'vip @example-app.develop config software get';
 const exampleUsageNode = 'vip @example-node-app.develop config software get';

package/dist/bin/vip-config-software-update.js

@@ -8,7 +8,7 @@ var _progress = require("../lib/cli/progress");
 var _software = require("../lib/config/software");
 var _tracker = require("../lib/tracker");
 var _userError = _interopRequireDefault(require("../lib/user-error"));
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 const debug = (0, _debug.default)('@automattic/vip:bin:config-software');
 const UPDATE_SOFTWARE_PROGRESS_STEPS = [{
   id: 'trigger',

package/dist/bin/vip-config-software.js

@@ -2,7 +2,7 @@
 "use strict";
 
 var _command = _interopRequireDefault(require("../lib/cli/command"));
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 const usage = 'vip config software';
 const exampleUsage = 'vip @example-app.develop config software';
 const exampleUsageNode = 'vip @example-node-app.develop config software';

package/dist/bin/vip-config.js

@@ -2,7 +2,7 @@
 "use strict";
 
 var _command = _interopRequireDefault(require("../lib/cli/command"));
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 const usage = 'vip config';
 const exampleUsage = 'vip @example-app.develop config';
 

package/dist/bin/vip-db-phpmyadmin.js

@@ -12,7 +12,7 @@
 var _phpmyadmin = require("../commands/phpmyadmin");
 var _command = _interopRequireDefault(require("../lib/cli/command"));
 var _tracker = require("../lib/tracker");
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 const examples = [{
   usage: 'vip @example-app.develop db phpmyadmin',
   description: "Generate access to a read-only phpMyAdmin web interface for the environment's database."

package/dist/bin/vip-db.js

@@ -11,7 +11,7 @@
 
 var _command = _interopRequireDefault(require("../lib/cli/command"));
 var _tracker = require("../lib/tracker");
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 void (0, _command.default)({
   usage: 'vip db'
 }).command('phpmyadmin', 'Generate access to a read-only phpMyAdmin web interface for an environment database.').example('vip @example-app.develop db phpmyadmin', "Generate access to a read-only phpMyAdmin web interface for the environment's database.").argv(process.argv, async () => {

package/dist/bin/vip-dev-env-create.js

@@ -5,7 +5,6 @@ var _chalk = _interopRequireDefault(require("chalk"));
 var _debug = _interopRequireDefault(require("debug"));
 var _command = _interopRequireDefault(require("../lib/cli/command"));
 var exit = _interopRequireWildcard(require("../lib/cli/exit"));
-var _devEnvironment = require("../lib/constants/dev-environment");
 var _devEnvironmentCli = require("../lib/dev-environment/dev-environment-cli");
 var _devEnvironmentConfigurationFile = require("../lib/dev-environment/dev-environment-configuration-file");
 var _devEnvironmentCore = require("../lib/dev-environment/dev-environment-core");
@@ -13,28 +12,28 @@ var _devEnvironmentLando = require("../lib/dev-environment/dev-environment-lando
 var _tracker = require("../lib/tracker");
 function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
 function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 const debug = (0, _debug.default)('@automattic/vip:bin:dev-environment');
+const exampleUsage = 'vip dev-env create';
+const usage = 'vip dev-env create';
+
+// Command examples
 const examples = [{
-  usage: `${_devEnvironment.DEV_ENVIRONMENT_FULL_COMMAND} create`,
-  description: 'Creates a local dev environment'
-}, {
-  usage: `vip @123.production ${_devEnvironment.DEV_ENVIRONMENT_SUBCOMMAND} create`,
-  description: 'Creates a local dev environment for production site for id 123'
-}, {
-  usage: `vip ${_devEnvironment.DEV_ENVIRONMENT_SUBCOMMAND} create --slug=my_site`,
-  description: 'Creates a local dev environment aliased as "my_site"'
+  usage: exampleUsage,
+  description: 'Create a new VIP Local Development Environment.\n' + '       * The environment will be named "vip-local" by default if a custom name is not assigned with "--slug" .'
 }, {
-  usage: `${_devEnvironment.DEV_ENVIRONMENT_FULL_COMMAND} create --slug=test`,
-  description: 'Assigning unique slugs to environments allows multiple environments to be created.'
+  usage: `${exampleUsage} --slug=example-site`,
+  description: 'Create a new local environment with the unique name "example-site".\n' + '       * Unique names allow multiple local environments to exist simultaneously.'
 }, {
-  usage: `${_devEnvironment.DEV_ENVIRONMENT_FULL_COMMAND} create --multisite --wordpress="5.8" --app-code="~/git/my_code"`,
-  description: 'Creates a local multisite dev environment using WP 5.8 and application code is expected to be in "~/git/my_code"'
+  usage: `${exampleUsage} --slug=example-site --multisite=y --php=8.2 --wordpress=6.4`,
+  description: 'Create a new local environment configured as a multisite running PHP 8.2 and WordPress version 6.4.\n' + '       * Options that are set in the `create` command will be skipped in the setup wizard.'
 }, {
-  usage: `${_devEnvironment.DEV_ENVIRONMENT_FULL_COMMAND} create --multisite=subdirectory --wordpress="5.8" --app-code="~/git/my_code"`,
-  description: 'Creates a local multisite dev environment with a subdirectory URL structure using WP 5.8 and application code is expected to be in "~/git/my_code"'
+  usage: `vip @example-app.production dev-env create --slug=example-site --app-code=/Users/example/Desktop/example-repo`,
+  description: 'Create a new local environment with settings based on the production environment of the "example-app" application and load the locally git-cloned application repository "example-repo".'
 }];
-const cmd = (0, _command.default)().option('slug', 'Custom name of the dev environment', undefined, _devEnvironmentCli.processSlug).option('title', 'Title for the WordPress site').option('multisite', 'Enable multisite install', undefined, _devEnvironmentCli.processStringOrBooleanOption);
+const cmd = (0, _command.default)({
+  usage
+}).option('slug', 'A unique name for a local environment. Default is "vip-local".', undefined, _devEnvironmentCli.processSlug).option('title', 'A descriptive value for the WordPress Site Title. Default is "VIP Dev").').option('multisite', 'Create environment as a multisite. Accepts "y" for a subdomain multisite, "subdirectory" (recommended) for a subdirectory multisite, or "false". Default is "y".', undefined, _devEnvironmentCli.processStringOrBooleanOption);
 (0, _devEnvironmentCli.addDevEnvConfigurationOptions)(cmd);
 cmd.examples(examples);
 cmd.argv(process.argv, async (arg, opt) => {
@@ -93,7 +92,7 @@ cmd.argv(process.argv, async (arg, opt) => {
       extended: false,
       suppressWarnings: true
     });
-    const message = '\n' + _chalk.default.green('✓') + ` environment created.\n\nTo start it please run:\n\n${startCommand}\n`;
+    const message = '\n' + _chalk.default.green('✓') + ` environment created.\n\nTo start the environment run:\n\n${startCommand}\n`;
     console.log(message);
     await (0, _tracker.trackEvent)('dev_env_create_command_success', trackingInfo);
   } catch (error) {

package/dist/bin/vip-dev-env-destroy.js

@@ -4,21 +4,24 @@
 var _chalk = _interopRequireDefault(require("chalk"));
 var _debug = _interopRequireDefault(require("debug"));
 var _command = _interopRequireDefault(require("../lib/cli/command"));
-var _devEnvironment = require("../lib/constants/dev-environment");
 var _devEnvironmentCli = require("../lib/dev-environment/dev-environment-cli");
 var _devEnvironmentCore = require("../lib/dev-environment/dev-environment-core");
 var _devEnvironmentLando = require("../lib/dev-environment/dev-environment-lando");
 var _tracker = require("../lib/tracker");
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 const debug = (0, _debug.default)('@automattic/vip:bin:dev-environment');
+const exampleUsage = 'vip dev-env destroy';
+const usage = 'vip dev-env destroy';
 const examples = [{
-  usage: `${_devEnvironment.DEV_ENVIRONMENT_FULL_COMMAND} destroy`,
-  description: 'Destroys the default local dev environment'
+  usage: `${exampleUsage} --slug=example-site`,
+  description: 'Completely remove a local environment named "example-site" by removing all Docker containers, volumes, and configuration files.'
 }, {
-  usage: `${_devEnvironment.DEV_ENVIRONMENT_FULL_COMMAND} destroy --slug=foo`,
-  description: 'Destroys a local dev environment named foo'
+  usage: `${exampleUsage} --soft --slug=example-site`,
+  description: 'Remove the Docker containers and volumes of a local environment named "example-site" but preserve the configuration files.\n' + '      * The preserved configuration files allow the local environment to be restarted with new Docker containers and volumes.'
 }];
-(0, _command.default)().option('slug', 'Custom name of the dev environment', undefined, _devEnvironmentCli.processSlug).option('soft', 'Keep config files needed to start an environment intact').examples(examples).argv(process.argv, async (arg, opt) => {
+(0, _command.default)({
+  usage
+}).option('slug', 'A unique name for a local environment. Default is "vip-local".', undefined, _devEnvironmentCli.processSlug).option('soft', 'Preserve an environment’s configuration files; allows an environment to be regenerated with the start command.').examples(examples).argv(process.argv, async (arg, opt) => {
   const slug = await (0, _devEnvironmentCli.getEnvironmentName)(opt);
   const lando = await (0, _devEnvironmentLando.bootstrapLando)();
   await (0, _devEnvironmentCli.validateDependencies)(lando, slug);

package/dist/bin/vip-dev-env-exec.js

@@ -2,26 +2,28 @@
 "use strict";
 
 var _command = _interopRequireDefault(require("../lib/cli/command"));
-var _devEnvironment = require("../lib/constants/dev-environment");
 var _devEnvironmentCli = require("../lib/dev-environment/dev-environment-cli");
 var _devEnvironmentCore = require("../lib/dev-environment/dev-environment-core");
 var _devEnvironmentLando = require("../lib/dev-environment/dev-environment-lando");
 var _tracker = require("../lib/tracker");
 var _userError = _interopRequireDefault(require("../lib/user-error"));
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const exampleUsage = 'vip dev-env exec';
+const usage = 'vip dev-env exec';
 const examples = [{
-  usage: `${_devEnvironment.DEV_ENVIRONMENT_FULL_COMMAND} exec -- wp post list`,
-  description: 'Use dev-environment to run `wp post list`'
+  usage: `${exampleUsage} --slug=example-site -- wp post list`,
+  description: 'Run a WP-CLI command against a local environment named "example-site".\n' + '      * A double dash ("--") must separate the arguments of "vip" from those of the "wp" command.'
 }, {
-  usage: `${_devEnvironment.DEV_ENVIRONMENT_FULL_COMMAND} exec --slug my_site -- wp post list --posts_per_page=500`,
-  description: 'Use dev-environment "my-site" to run `wp post list --posts_per_page=500`'
+  usage: `${exampleUsage} --slug=example-site -- wp user list --url=example.example-site.vipdev.lndo.site`,
+  description: 'Target the WP-CLI command against the network site "example.example-site.vipdev.lndo.site" of a local multisite environment.'
 }, {
-  usage: `${_devEnvironment.DEV_ENVIRONMENT_FULL_COMMAND} exec --slug my_site -- wp shell`,
-  description: 'Use dev-environment "my_site" to run interactive wp shell'
+  usage: `${exampleUsage} --slug=example-site -- wp shell`,
+  description: 'Run the WP-CLI command "wp shell" against a local environment to open an interactive PHP console.'
 }];
 (0, _command.default)({
-  wildcardCommand: true
-}).option('slug', 'Custom name of the dev environment', undefined, _devEnvironmentCli.processSlug).option('force', 'Disable validations before task execution', undefined, _devEnvironmentCli.processBooleanOption).option('quiet', 'Suppress output', undefined, _devEnvironmentCli.processBooleanOption).examples(examples).argv(process.argv, async (unmatchedArgs, opt) => {
+  wildcardCommand: true,
+  usage
+}).option('slug', 'A unique name for a local environment. Default is "vip-local".', undefined, _devEnvironmentCli.processSlug).option('force', 'Skip validation for a local environment to be in a running state.', undefined, _devEnvironmentCli.processBooleanOption).option('quiet', 'Suppress informational messages.', undefined, _devEnvironmentCli.processBooleanOption).examples(examples).argv(process.argv, async (unmatchedArgs, opt) => {
   const slug = await (0, _devEnvironmentCli.getEnvironmentName)(opt);
   const lando = await (0, _devEnvironmentLando.bootstrapLando)();
   await (0, _devEnvironmentCli.validateDependencies)(lando, slug);
@@ -32,7 +34,7 @@ const examples = [{
     const argSplitterIx = process.argv.findIndex(argument => '--' === argument);
     const argSplitterFound = argSplitterIx > -1;
     if (unmatchedArgs.length > 0 && !argSplitterFound) {
-      throw new Error('Please provide "--" argument to separate arguments for "vip" and command to be executed (see "--help" for examples)');
+      throw new Error('A double dash ("--") must separate the arguments of "vip" from those of the "wp" command. Run "vip dev-env exec --help" for examples.');
     }
 
     /** @type {string[]} */
@@ -43,7 +45,7 @@ const examples = [{
     if (!opt.force) {
       const isUp = await (0, _devEnvironmentLando.isEnvUp)(lando, (0, _devEnvironmentCore.getEnvironmentPath)(slug));
       if (!isUp) {
-        throw new _userError.default('Environment needs to be started before running a command');
+        throw new _userError.default('A WP-CLI command can only be executed on a running local environment.');
       }
     }
     try {

package/dist/bin/vip-dev-env-import-media.js

@@ -2,21 +2,20 @@
 "use strict";
 
 var _command = _interopRequireDefault(require("../lib/cli/command"));
-var _devEnvironment = require("../lib/constants/dev-environment");
 var _devEnvironmentCli = require("../lib/dev-environment/dev-environment-cli");
 var _devEnvironmentCore = require("../lib/dev-environment/dev-environment-core");
 var _tracker = require("../lib/tracker");
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const exampleUsage = 'vip dev-env import media';
+const usage = 'vip dev-env import media';
 const examples = [{
-  usage: `${_devEnvironment.DEV_ENVIRONMENT_FULL_COMMAND} import media path/to/wp-content/uploads`,
-  description: 'Import contents of the given WP uploads folder file into the media library of the default dev environment'
-}, {
-  usage: `${_devEnvironment.DEV_ENVIRONMENT_FULL_COMMAND} import media path/to/wp-content/uploads --slug=mysite`,
-  description: 'Import contents of the given WP uploads folder file into the media library of a dev environment named `mysite`'
+  usage: `${exampleUsage} /Users/example/Desktop/uploads --slug="example-site"`,
+  description: 'Import the contents of the "uploads" directory from a path on the user\'s local machine to the "/wp-content/uploads" directory of the local environment named "example-site".'
 }];
 (0, _command.default)({
-  requiredArgs: 1
-}).examples(examples).option('slug', 'Custom name of the dev environment', undefined, _devEnvironmentCli.processSlug).argv(process.argv, async (unmatchedArgs, opt) => {
+  requiredArgs: 1,
+  usage
+}).examples(examples).option('slug', 'A unique name for a local environment. Default is "vip-local".', undefined, _devEnvironmentCli.processSlug).argv(process.argv, async (unmatchedArgs, opt) => {
   const [filePath] = unmatchedArgs;
   const slug = await (0, _devEnvironmentCli.getEnvironmentName)(opt);
   const trackingInfo = (0, _devEnvironmentCli.getEnvTrackingInfo)(slug);

package/dist/bin/vip-dev-env-import-sql.js

@@ -3,26 +3,31 @@
 
 var _devEnvImportSql = require("../commands/dev-env-import-sql");
 var _command = _interopRequireDefault(require("../lib/cli/command"));
-var _devEnvironment = require("../lib/constants/dev-environment");
 var _devEnvironmentCli = require("../lib/dev-environment/dev-environment-cli");
 var _tracker = require("../lib/tracker");
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const exampleUsage = 'vip dev-env import sql';
+const usage = 'vip dev-env import sql';
 const examples = [{
-  usage: `${_devEnvironment.DEV_ENVIRONMENT_FULL_COMMAND} import sql some-wp-db-file.sql`,
-  description: 'Import the contents of a WordPress database from an SQL file'
+  usage: `${exampleUsage} /Users/example/Downloads/file.sql --slug="example-site"`,
+  description: 'Import the SQL file named "file.sql" from a path on the user\'s local machine to a running local environment named "example-site".'
 }, {
-  usage: `${_devEnvironment.DEV_ENVIRONMENT_FULL_COMMAND} import sql wordpress.sql --slug=my_site`,
-  description: 'Import the contents of a WordPress database from an SQL file into `my_site`'
+  usage: `${exampleUsage} /Users/example/Downloads/file.sql --search-replace="example-site.com,example-site.vipdev.lndo.site" --slug="example-site"`,
+  description: 'Search for the string "example-site.com" in the SQL file and replace it with "example-site.vipdev.lndo.site" during the import.'
 }, {
-  usage: `${_devEnvironment.DEV_ENVIRONMENT_FULL_COMMAND} import sql wordpress.sql --search-replace="testsite.com,test-site.go-vip.net"`,
-  description: 'Import the contents of a WordPress database from an SQL file and replace the occurrences of `testsite.com` with `test-site.go-vip.net`'
+  usage: `${exampleUsage} /Users/example/Downloads/file.sql --search-replace="example-site.com,example-site.vipdev.lndo.site" --skip-reindex --slug="example-site"`,
+  description: 'Import the SQL file to a local environment with Elasticsearch enabled, and do not reindex after the import is completed.'
 }, {
-  usage: `${_devEnvironment.DEV_ENVIRONMENT_FULL_COMMAND} import sql wordpress.sql --search-replace="testsite.com,test-site.go-vip.net" --in-place`,
-  description: 'Import the contents of a WordPress database from an SQL file and replace the occurrences of `testsite.com` with `test-site.go-vip.net` in place (modifies the original SQL file)'
+  usage: `${exampleUsage} /Users/example/Downloads/file.sql --search-replace="example-site.com,example-site.vipdev.lndo.site" --in-place`,
+  description: 'Perform the search and replace operation on the local SQL file ("file.sql"), save the changes, and import the updated file to the local environment.'
+}, {
+  usage: `${exampleUsage} /Users/example/Downloads/file.sql --search-replace="example-site.com/site-three,site-three.example-site.vipdev.lndo.site" --search-replace="example-site.com,example-site.vipdev.lndo.site" --slug="example-site"`,
+  description: 'Search and replace 2 pairs of strings during the import of the SQL file to a local multisite environment.'
 }];
 (0, _command.default)({
-  requiredArgs: 1
-}).option('slug', 'Custom name of the dev environment', undefined, _devEnvironmentCli.processSlug).option(['r', 'search-replace'], 'Perform Search and Replace on the specified SQL file').option('in-place', 'Search and Replace explicitly on the given input file').option('skip-validate', 'Do not perform file validation').option(['k', 'skip-reindex'], 'Do not reindex data in Elasticsearch after import').option('quiet', 'Suppress prompts and informational messages').examples(examples).argv(process.argv, async (unmatchedArgs, opt) => {
+  requiredArgs: 1,
+  usage
+}).option('slug', 'A unique name for a local environment. Default is "vip-local".', undefined, _devEnvironmentCli.processSlug).option(['r', 'search-replace'], 'Search for a string in the SQL file and replace it with a new string.').option('in-place', 'Perform a search and replace operation on the local SQL file and save the results.').option('skip-validate', 'Skip file validation.').option(['k', 'skip-reindex'], 'Skip Elasticsearch reindex after import.').option('quiet', 'Skip confirmation and suppress informational messages.').examples(examples).argv(process.argv, async (unmatchedArgs, opt) => {
   const [fileName] = unmatchedArgs;
   const slug = await (0, _devEnvironmentCli.getEnvironmentName)(opt);
   const cmd = new _devEnvImportSql.DevEnvImportSQLCommand(fileName, opt, slug);

package/dist/bin/vip-dev-env-import.js

@@ -2,15 +2,17 @@
 "use strict";
 
 var _command = _interopRequireDefault(require("../lib/cli/command"));
-var _devEnvironment = require("../lib/constants/dev-environment");
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const exampleUsage = 'vip dev-env import';
+const usage = 'vip dev-env import';
 const examples = [{
-  usage: `${_devEnvironment.DEV_ENVIRONMENT_FULL_COMMAND} import sql file.sql`,
-  description: 'Import the given SQL file to your site'
+  usage: `${exampleUsage} sql /Users/example/Downloads/file.sql`,
+  description: 'Import the SQL file named "file.sql" from a path on the user\'s local machine to a running local environment.'
 }, {
-  usage: `${_devEnvironment.DEV_ENVIRONMENT_FULL_COMMAND} import media path/to/wp-content/uploads`,
-  description: 'Import contents of the given WP uploads folder file into the media library of the default dev environment'
+  usage: `${exampleUsage} media /Users/example/Desktop/uploads`,
+  description: 'Import the contents of the "uploads" directory from a path on the user\'s local machine to the "/wp-content/uploads" directory of a running local environment.'
 }];
 (0, _command.default)({
-  requiredArgs: 1
-}).examples(examples).command('sql', 'Import SQL to your dev-env database from a file').command('media', 'Import media files to the dev environment of your application from a compressed web archive. ' + 'This command will copy the contents of a folder to the `uploads` folder of the target dev environment.').argv(process.argv);
+  requiredArgs: 1,
+  usage
+}).examples(examples).command('sql', 'Import a SQL file to a running local environment.').command('media', 'Import media files to a running local environment.').argv(process.argv);

package/dist/bin/vip-dev-env-info.js

@@ -3,21 +3,27 @@
 
 var _debug = _interopRequireDefault(require("debug"));
 var _command = _interopRequireDefault(require("../lib/cli/command"));
-var _devEnvironment = require("../lib/constants/dev-environment");
 var _devEnvironmentCli = require("../lib/dev-environment/dev-environment-cli");
 var _devEnvironmentCore = require("../lib/dev-environment/dev-environment-core");
 var _devEnvironmentLando = require("../lib/dev-environment/dev-environment-lando");
 var _tracker = require("../lib/tracker");
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 const debug = (0, _debug.default)('@automattic/vip:bin:dev-environment');
+const exampleUsage = 'vip dev-env info';
+const usage = 'vip dev-env info';
 const examples = [{
-  usage: `${_devEnvironment.DEV_ENVIRONMENT_FULL_COMMAND} info --all`,
-  description: 'Return information about all local dev environments'
+  usage: `${exampleUsage} --slug=example-site`,
+  description: 'Retrieve basic information about the local environment named "example-site".'
 }, {
-  usage: `${_devEnvironment.DEV_ENVIRONMENT_FULL_COMMAND} info --slug=my_site`,
-  description: 'Return information about a local dev environment named "my_site"'
+  usage: `${exampleUsage} --slug=example-site --extended`,
+  description: 'Retrieve a larger amount of information about the local environment named "example-site".'
+}, {
+  usage: `${exampleUsage} --all`,
+  description: 'Retrieve basic information about all local environments.'
 }];
-(0, _command.default)().option('slug', 'Custom name of the dev environment', undefined, _devEnvironmentCli.processSlug).option('all', 'Show Info for all local dev environments').option('extended', 'Show extended information about the dev environment').examples(examples).argv(process.argv, async (arg, opt) => {
+(0, _command.default)({
+  usage
+}).option('slug', 'A unique name for a local environment. Default is "vip-local".', undefined, _devEnvironmentCli.processSlug).option('all', 'Retrieve information about all local environments.').option('extended', 'Retrieve a larger amount of information.').examples(examples).argv(process.argv, async (arg, opt) => {
   let trackingInfo;
   let slug;
   const lando = await (0, _devEnvironmentLando.bootstrapLando)();

package/dist/bin/vip-dev-env-list.js

@@ -2,17 +2,20 @@
 "use strict";
 
 var _command = _interopRequireDefault(require("../lib/cli/command"));
-var _devEnvironment = require("../lib/constants/dev-environment");
 var _devEnvironmentCli = require("../lib/dev-environment/dev-environment-cli");
 var _devEnvironmentCore = require("../lib/dev-environment/dev-environment-core");
 var _devEnvironmentLando = require("../lib/dev-environment/dev-environment-lando");
 var _tracker = require("../lib/tracker");
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const exampleUsage = 'vip dev-env list';
+const usage = 'vip dev-env list';
 const examples = [{
-  usage: `${_devEnvironment.DEV_ENVIRONMENT_FULL_COMMAND} list`,
-  description: 'Return information about all local dev environments'
+  usage: `${exampleUsage}`,
+  description: 'Retrieve basic information about all local environments.'
 }];
-(0, _command.default)().examples(examples).argv(process.argv, async () => {
+(0, _command.default)({
+  usage
+}).examples(examples).argv(process.argv, async () => {
   const lando = await (0, _devEnvironmentLando.bootstrapLando)();
   lando.events.constructor.prototype.setMaxListeners(1024);
   await (0, _devEnvironmentCli.validateDependencies)(lando, '');

package/dist/bin/vip-dev-env-logs.js

@@ -3,24 +3,27 @@
 
 var _debug = _interopRequireDefault(require("debug"));
 var _command = _interopRequireDefault(require("../lib/cli/command"));
-var _devEnvironment = require("../lib/constants/dev-environment");
 var _devEnvironmentCli = require("../lib/dev-environment/dev-environment-cli");
 var _devEnvironmentCore = require("../lib/dev-environment/dev-environment-core");
 var _devEnvironmentLando = require("../lib/dev-environment/dev-environment-lando");
 var _tracker = require("../lib/tracker");
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 const debug = (0, _debug.default)('@automattic/vip:bin:dev-environment');
+const exampleUsage = 'vip dev-env logs';
+const usage = 'vip dev-env logs';
 const examples = [{
-  usage: `${_devEnvironment.DEV_ENVIRONMENT_FULL_COMMAND} logs --slug=my_site`,
-  description: 'Return all logs from a local dev environment named "my_site"'
+  usage: `${exampleUsage} --slug=example-site`,
+  description: 'Retrieve logs for all running services of the local environment named "example-site".'
 }, {
-  usage: `${_devEnvironment.DEV_ENVIRONMENT_FULL_COMMAND} logs --slug=my_site --service=elasticsearch`,
-  description: 'Return logs from the "elasticsearch" service from a local dev environment named "my_site"'
+  usage: `${exampleUsage} --service=elasticsearch --slug=example-site`,
+  description: 'Retrieve logs only for the "elasticsearch" service of the local environment named "example-site".'
 }, {
-  usage: `${_devEnvironment.DEV_ENVIRONMENT_FULL_COMMAND} logs --slug=my_site --service=elasticsearch -f`,
-  description: 'Follow logs from the "elasticsearch" service from a local dev environment named "my_site"'
+  usage: `${exampleUsage} --service=database --follow --slug=example-site`,
+  description: 'Retrieve and continually output logs for the "database" service of the local environment named "example-site".'
 }];
-(0, _command.default)().option('slug', 'Custom name of the dev environment', undefined, _devEnvironmentCli.processSlug).option(['f', 'follow'], 'Follow logs for a specific service in local dev environment').option('service', 'Show logs for a specific service in local dev environment. Defaults to all if none passed in.').examples(examples).argv(process.argv, async (arg, opt) => {
+(0, _command.default)({
+  usage
+}).option('slug', 'A unique name for a local environment. Default is "vip-local".', undefined, _devEnvironmentCli.processSlug).option(['f', 'follow'], 'Continually output logs as they are generated.').option('service', 'Restrict to a single service.').examples(examples).argv(process.argv, async (arg, opt) => {
   const slug = await (0, _devEnvironmentCli.getEnvironmentName)(opt);
   const lando = await (0, _devEnvironmentLando.bootstrapLando)();
   await (0, _devEnvironmentCli.validateDependencies)(lando, slug);