@automattic/vip 4.1.6 → 4.1.8

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

@@ -1,53 +1,63 @@
 #!/usr/bin/env node
 "use strict";
-
-var _debug = _interopRequireDefault(require("debug"));
-var _command = _interopRequireDefault(require("../lib/cli/command"));
-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(e) { return e && e.__esModule ? e : { default: e }; }
-const debug = (0, _debug.default)('@automattic/vip:bin:dev-environment');
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const debug_1 = __importDefault(require("debug"));
+const command_1 = __importDefault(require("../lib/cli/command"));
+const dev_environment_cli_1 = require("../lib/dev-environment/dev-environment-cli");
+const dev_environment_core_1 = require("../lib/dev-environment/dev-environment-core");
+const dev_environment_lando_1 = require("../lib/dev-environment/dev-environment-lando");
+const tracker_1 = require("../lib/tracker");
+const debug = (0, debug_1.default)('@automattic/vip:bin:dev-environment');
 const exampleUsage = 'vip dev-env logs';
 const usage = 'vip dev-env logs';
-const examples = [{
-  usage: `${exampleUsage} --slug=example-site`,
-  description: 'Retrieve logs for all running services of the local environment named "example-site".'
-}, {
-  usage: `${exampleUsage} --service=elasticsearch --slug=example-site`,
-  description: 'Retrieve logs only for the "elasticsearch" service of the local environment named "example-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)({
-  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)({
-    logFile: (0, _devEnvironmentCli.getDevEnvLogFile)(slug)
-  });
-  (0, _devEnvironmentCli.validateDependencies)(lando);
-  const trackingInfo = (0, _devEnvironmentCli.getEnvTrackingInfo)(slug);
-  await (0, _tracker.trackEvent)('dev_env_logs_command_execute', trackingInfo);
-  debug('Args: ', arg, 'Options: ', opt);
-  if (!opt.follow) {
-    opt.follow = false;
-  }
-  if (!opt.service) {
-    opt.service = false;
-  }
-  const options = {
-    follow: opt.follow,
-    service: opt.service,
-    timestamps: true
-  };
-  try {
-    await (0, _devEnvironmentCore.showLogs)(lando, slug, options);
-    await (0, _tracker.trackEvent)('dev_env_logs_command_success', trackingInfo);
-  } catch (error) {
-    await (0, _devEnvironmentCli.handleCLIException)(error, 'dev_env_logs_command_error', trackingInfo);
-    process.exitCode = 1;
-  }
-});
+const examples = [
+    {
+        usage: `${exampleUsage} --slug=example-site`,
+        description: 'Retrieve logs for all running services of the local environment named "example-site".',
+    },
+    {
+        usage: `${exampleUsage} --service=elasticsearch --slug=example-site`,
+        description: 'Retrieve logs only for the "elasticsearch" service of the local environment named "example-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_1.default)({
+    usage,
+})
+    .option('slug', 'A unique name for a local environment. Default is "vip-local".', undefined, dev_environment_cli_1.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, dev_environment_cli_1.getEnvironmentName)(opt);
+    const lando = await (0, dev_environment_lando_1.bootstrapLando)({ logFile: (0, dev_environment_cli_1.getDevEnvLogFile)(slug) });
+    (0, dev_environment_cli_1.validateDependencies)(lando);
+    const trackingInfo = (0, dev_environment_cli_1.getEnvTrackingInfo)(slug);
+    await (0, tracker_1.trackEvent)('dev_env_logs_command_execute', trackingInfo);
+    debug('Args: ', arg, 'Options: ', opt);
+    if (!opt.follow) {
+        opt.follow = false;
+    }
+    if (!opt.service) {
+        opt.service = false;
+    }
+    const options = {
+        follow: opt.follow,
+        service: opt.service,
+        timestamps: true,
+    };
+    try {
+        await (0, dev_environment_core_1.showLogs)(lando, slug, options);
+        await (0, tracker_1.trackEvent)('dev_env_logs_command_success', trackingInfo);
+    }
+    catch (error) {
+        await (0, dev_environment_cli_1.handleCLIException)(error, 'dev_env_logs_command_error', trackingInfo);
+        process.exitCode = 1;
+    }
+});

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

@@ -1,75 +1,83 @@
 #!/usr/bin/env node
-
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
 /**
  * External dependencies
  */
-"use strict";
-
-var _chalk = _interopRequireDefault(require("chalk"));
-var _debug = _interopRequireDefault(require("debug"));
-var _command = _interopRequireDefault(require("../lib/cli/command"));
-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(e) { return e && e.__esModule ? e : { default: e }; }
+const chalk_1 = __importDefault(require("chalk"));
+const debug_1 = __importDefault(require("debug"));
 /**
  * Internal dependencies
  */
-const debug = (0, _debug.default)('@automattic/vip:bin:dev-environment');
+const command_1 = __importDefault(require("../lib/cli/command"));
+const dev_environment_cli_1 = require("../lib/dev-environment/dev-environment-cli");
+const dev_environment_core_1 = require("../lib/dev-environment/dev-environment-core");
+const dev_environment_lando_1 = require("../lib/dev-environment/dev-environment-lando");
+const tracker_1 = require("../lib/tracker");
+const debug = (0, debug_1.default)('@automattic/vip:bin:dev-environment');
 const exampleUsage = 'vip dev-env purge';
 const usage = 'vip dev-env purge';
-const examples = [{
-  usage: `${exampleUsage}`,
-  description: 'Destroy all local environments.'
-}, {
-  usage: `${exampleUsage} --force`,
-  description: 'Destroy all local environments without requiring confirmation from the user.'
-}, {
-  usage: `${exampleUsage} --soft`,
-  description: 'Remove the Docker containers and volumes of all local environments but preserve their configuration files.\n' + '      * Preserving the configuration files allows the local environments to be regenerated; new Docker containers and volumes will be created.'
-}];
-(0, _command.default)({
-  usage
-}).option('soft', 'Preserve an environment’s configuration files; allows an environment to be regenerated with the start command.').option('force', 'Skip confirmation.').examples(examples).argv(process.argv, async (arg, opt) => {
-  debug('Args: ', arg, 'Options: ', opt);
-  const allEnvNames = (0, _devEnvironmentCore.getAllEnvironmentNames)();
-  const lando = await (0, _devEnvironmentLando.bootstrapLando)({
-    logFile: (0, _devEnvironmentCli.getDevEnvLogFile)()
-  });
-  if (allEnvNames.length === 0) {
-    console.log('No environments to purge!');
-    return;
-  }
-  if (!opt.force) {
-    const purge = await (0, _devEnvironmentCli.promptForBoolean)('Are you sure you want to purge ALL existing local environments?', true);
-    if (!purge) {
-      return;
+const examples = [
+    {
+        usage: `${exampleUsage}`,
+        description: 'Destroy all local environments.',
+    },
+    {
+        usage: `${exampleUsage} --force`,
+        description: 'Destroy all local environments without requiring confirmation from the user.',
+    },
+    {
+        usage: `${exampleUsage} --soft`,
+        description: 'Remove the Docker containers and volumes of all local environments but preserve their configuration files.\n' +
+            '      * Preserving the configuration files allows the local environments to be regenerated; new Docker containers and volumes will be created.',
+    },
+];
+(0, command_1.default)({
+    usage,
+})
+    .option('soft', 'Preserve an environment’s configuration files; allows an environment to be regenerated with the start command.')
+    .option('force', 'Skip confirmation.')
+    .examples(examples)
+    .argv(process.argv, async (arg, opt) => {
+    debug('Args: ', arg, 'Options: ', opt);
+    const allEnvNames = (0, dev_environment_core_1.getAllEnvironmentNames)();
+    const lando = await (0, dev_environment_lando_1.bootstrapLando)({ logFile: (0, dev_environment_cli_1.getDevEnvLogFile)() });
+    if (allEnvNames.length === 0) {
+        console.log('No environments to purge!');
+        return;
+    }
+    if (!opt.force) {
+        const purge = await (0, dev_environment_cli_1.promptForBoolean)('Are you sure you want to purge ALL existing local environments?', true);
+        if (!purge) {
+            return;
+        }
+    }
+    const trackingInfo = { all: true };
+    await (0, tracker_1.trackEvent)('dev_env_purge_command_execute', trackingInfo);
+    (0, dev_environment_cli_1.validateDependencies)(lando);
+    const removeFiles = !(opt.soft || false);
+    try {
+        for (const slug of allEnvNames) {
+            try {
+                // eslint-disable-next-line no-await-in-loop
+                await (0, dev_environment_core_1.destroyEnvironment)(lando, slug, removeFiles);
+                const message = chalk_1.default.green('✓') + ' Environments purged.\n';
+                console.log(message);
+            }
+            catch (error) {
+                const trackingInfoChild = (0, dev_environment_cli_1.getEnvTrackingInfo)(slug);
+                // eslint-disable-next-line no-await-in-loop
+                await (0, dev_environment_cli_1.handleCLIException)(error, 'dev_env_purge_command_error', trackingInfoChild);
+                process.exitCode = 1;
+            }
+        }
+        await (0, tracker_1.trackEvent)('dev_env_purge_command_success', trackingInfo);
     }
-  }
-  const trackingInfo = {
-    all: true
-  };
-  await (0, _tracker.trackEvent)('dev_env_purge_command_execute', trackingInfo);
-  (0, _devEnvironmentCli.validateDependencies)(lando);
-  const removeFiles = !(opt.soft || false);
-  try {
-    for (const slug of allEnvNames) {
-      try {
-        // eslint-disable-next-line no-await-in-loop
-        await (0, _devEnvironmentCore.destroyEnvironment)(lando, slug, removeFiles);
-        const message = _chalk.default.green('✓') + ' Environments purged.\n';
-        console.log(message);
-      } catch (error) {
-        const trackingInfoChild = (0, _devEnvironmentCli.getEnvTrackingInfo)(slug);
-        // eslint-disable-next-line no-await-in-loop
-        await (0, _devEnvironmentCli.handleCLIException)(error, 'dev_env_purge_command_error', trackingInfoChild);
+    catch (error) {
+        await (0, dev_environment_cli_1.handleCLIException)(error, 'dev_env_purge_command_error', trackingInfo);
         process.exitCode = 1;
-      }
     }
-    await (0, _tracker.trackEvent)('dev_env_purge_command_success', trackingInfo);
-  } catch (error) {
-    await (0, _devEnvironmentCli.handleCLIException)(error, 'dev_env_purge_command_error', trackingInfo);
-    process.exitCode = 1;
-  }
-});
+});

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

@@ -1,84 +1,95 @@
 #!/usr/bin/env node
 "use strict";
-
-var _debug = _interopRequireDefault(require("debug"));
-var _command = _interopRequireDefault(require("../lib/cli/command"));
-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(e) { return e && e.__esModule ? e : { default: e }; }
-const debug = (0, _debug.default)('@automattic/vip:bin:dev-environment');
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const debug_1 = __importDefault(require("debug"));
+const command_1 = __importDefault(require("../lib/cli/command"));
+const dev_environment_cli_1 = require("../lib/dev-environment/dev-environment-cli");
+const dev_environment_core_1 = require("../lib/dev-environment/dev-environment-core");
+const dev_environment_lando_1 = require("../lib/dev-environment/dev-environment-lando");
+const tracker_1 = require("../lib/tracker");
+const debug = (0, debug_1.default)('@automattic/vip:bin:dev-environment');
 const exampleUsage = 'vip dev-env shell';
 const usage = 'vip dev-env shell';
 const userMap = {
-  nginx: 'www-data',
-  php: 'www-data',
-  database: 'mysql',
-  memcached: 'memcache',
-  elasticsearch: 'elasticsearch',
-  phpmyadmin: 'www-data',
-  mailpit: 'root',
-  photon: 'root'
+    nginx: 'www-data',
+    php: 'www-data',
+    database: 'mysql',
+    memcached: 'memcache',
+    elasticsearch: 'elasticsearch',
+    phpmyadmin: 'www-data',
+    mailpit: 'root',
+    photon: 'root',
 };
-const examples = [{
-  usage: `${exampleUsage} --slug=example-site`,
-  description: 'Create and enter an SSH command shell for the PHP service (default) of the local environment named "example-site".'
-}, {
-  usage: `${exampleUsage} --root --slug=example-site`,
-  description: 'Create and enter an SSH command shell with root privileges for the local environment.'
-}, {
-  usage: `${exampleUsage} --slug=example-site -- ls -lha`,
-  description: 'Create an SSH command shell for the local environment and run the command "ls -lha".\n' + '      * A double dash ("--") must separate the arguments of "vip" from those of the command.'
-}, {
-  usage: `${exampleUsage} --service=database --slug=example-site -- ls -lha`,
-  description: 'Create an SSH command shell for the database service of the local environment and run the command "ls -lha".'
-}];
-
+const examples = [
+    {
+        usage: `${exampleUsage} --slug=example-site`,
+        description: 'Create and enter an SSH command shell for the PHP service (default) of the local environment named "example-site".',
+    },
+    {
+        usage: `${exampleUsage} --root --slug=example-site`,
+        description: 'Create and enter an SSH command shell with root privileges for the local environment.',
+    },
+    {
+        usage: `${exampleUsage} --slug=example-site -- ls -lha`,
+        description: 'Create an SSH command shell for the local environment and run the command "ls -lha".\n' +
+            '      * A double dash ("--") must separate the arguments of "vip" from those of the command.',
+    },
+    {
+        usage: `${exampleUsage} --service=database --slug=example-site -- ls -lha`,
+        description: 'Create an SSH command shell for the database service of the local environment and run the command "ls -lha".',
+    },
+];
 /**
  * @param {string[]} args
  * @return {string[]}
  */
 function getCommand(args) {
-  const splitterIdx = process.argv.findIndex(argument => '--' === argument);
-  if (args.length > 0 && splitterIdx === -1) {
-    throw new Error('A double dash ("--") must separate the arguments of "vip" from those of the command to be executed. Run "vip dev-env shell --help" for examples.');
-  }
-
-  /** @type {string[]} */
-  let cmd = [];
-  if (splitterIdx !== -1 && splitterIdx + 1 < process.argv.length) {
-    cmd = process.argv.slice(splitterIdx + 1);
-  }
-  return cmd;
+    const splitterIdx = process.argv.findIndex(argument => '--' === argument);
+    if (args.length > 0 && splitterIdx === -1) {
+        throw new Error('A double dash ("--") must separate the arguments of "vip" from those of the command to be executed. Run "vip dev-env shell --help" for examples.');
+    }
+    /** @type {string[]} */
+    let cmd = [];
+    if (splitterIdx !== -1 && splitterIdx + 1 < process.argv.length) {
+        cmd = process.argv.slice(splitterIdx + 1);
+    }
+    return cmd;
 }
-(0, _command.default)({
-  wildcardCommand: true,
-  usage
-}).option('slug', 'A unique name for a local environment. Default is "vip-local".', undefined, _devEnvironmentCli.processSlug).option('root', 'Create with root privileges.').option('service', 'Restrict to a single service.').examples(examples).argv(process.argv, async (args, opt) => {
-  const slug = await (0, _devEnvironmentCli.getEnvironmentName)(opt);
-  const lando = await (0, _devEnvironmentLando.bootstrapLando)({
-    logFile: (0, _devEnvironmentCli.getDevEnvLogFile)(slug)
-  });
-  (0, _devEnvironmentCli.validateDependencies)(lando);
-  const trackingInfo = (0, _devEnvironmentCli.getEnvTrackingInfo)(slug);
-  await (0, _tracker.trackEvent)('dev_env_shell_command_execute', trackingInfo);
-  debug('Args: ', args, 'Options: ', opt);
-  const isRoot = Boolean(opt.root);
-  const service = opt.service || 'php';
-  const user = isRoot ? 'root' : userMap[service] || 'www-data';
-  const cmd = getCommand(args);
-  try {
-    await (0, _devEnvironmentLando.landoShell)(lando, (0, _devEnvironmentCore.getEnvironmentPath)(slug), service, user, cmd);
-    await (0, _tracker.trackEvent)('dev_env_shell_command_success', trackingInfo);
-  } catch (error) {
-    // error.hide comes from Lando to  between normal errors and non-zero exit code from commands.
-    // We don't want to track the latter as errors.
-    if (!error.hide) {
-      await (0, _devEnvironmentCli.handleCLIException)(error, 'dev_env_shell_command_error', trackingInfo);
-      process.exitCode = 1;
-    } else {
-      await (0, _tracker.trackEvent)('dev_env_shell_command_success', trackingInfo);
+(0, command_1.default)({
+    wildcardCommand: true,
+    usage,
+})
+    .option('slug', 'A unique name for a local environment. Default is "vip-local".', undefined, dev_environment_cli_1.processSlug)
+    .option('root', 'Create with root privileges.')
+    .option('service', 'Restrict to a single service.')
+    .examples(examples)
+    .argv(process.argv, async (args, opt) => {
+    const slug = await (0, dev_environment_cli_1.getEnvironmentName)(opt);
+    const lando = await (0, dev_environment_lando_1.bootstrapLando)({ logFile: (0, dev_environment_cli_1.getDevEnvLogFile)(slug) });
+    (0, dev_environment_cli_1.validateDependencies)(lando);
+    const trackingInfo = (0, dev_environment_cli_1.getEnvTrackingInfo)(slug);
+    await (0, tracker_1.trackEvent)('dev_env_shell_command_execute', trackingInfo);
+    debug('Args: ', args, 'Options: ', opt);
+    const isRoot = Boolean(opt.root);
+    const service = opt.service || 'php';
+    const user = isRoot ? 'root' : userMap[service] || 'www-data';
+    const cmd = getCommand(args);
+    try {
+        await (0, dev_environment_lando_1.landoShell)(lando, (0, dev_environment_core_1.getEnvironmentPath)(slug), service, user, cmd);
+        await (0, tracker_1.trackEvent)('dev_env_shell_command_success', trackingInfo);
+    }
+    catch (error) {
+        // error.hide comes from Lando to  between normal errors and non-zero exit code from commands.
+        // We don't want to track the latter as errors.
+        if (!error.hide) {
+            await (0, dev_environment_cli_1.handleCLIException)(error, 'dev_env_shell_command_error', trackingInfo);
+            process.exitCode = 1;
+        }
+        else {
+            await (0, tracker_1.trackEvent)('dev_env_shell_command_success', trackingInfo);
+        }
     }
-  }
-});
+});

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

@@ -1,70 +1,82 @@
 #!/usr/bin/env node
 "use strict";
-
-var _debug = _interopRequireDefault(require("debug"));
-var _command = _interopRequireDefault(require("../lib/cli/command"));
-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(e) { return e && e.__esModule ? e : { default: e }; }
-const debug = (0, _debug.default)('@automattic/vip:bin:dev-environment');
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const debug_1 = __importDefault(require("debug"));
+const command_1 = __importDefault(require("../lib/cli/command"));
+const dev_environment_cli_1 = require("../lib/dev-environment/dev-environment-cli");
+const dev_environment_core_1 = require("../lib/dev-environment/dev-environment-core");
+const dev_environment_lando_1 = require("../lib/dev-environment/dev-environment-lando");
+const tracker_1 = require("../lib/tracker");
+const debug = (0, debug_1.default)('@automattic/vip:bin:dev-environment');
 const exampleUsage = 'vip dev-env start';
 const usage = 'vip dev-env start';
-const examples = [{
-  usage: `${exampleUsage} --slug=example-site`,
-  description: 'Start a local environment named "example-site".'
-}, {
-  usage: `${exampleUsage} --skip-wp-versions-check --slug=example-site`,
-  description: 'Skip the prompt to upgrade WordPress to the latest release version and start a local environment with the less recent version of WordPress currently configured.'
-}, {
-  usage: `${exampleUsage} --skip-rebuild --slug=example-site`,
-  description: 'Start only the services of a local environment that are not currently in a running state.'
-}, {
-  usage: `${exampleUsage} --editor=vscode --slug=example-site`,
-  description: 'Start a local environment and generate a Workspace file for developing in Visual Studio Code.'
-}, {
-  usage: `${exampleUsage} --editor=cursor --slug=example-site`,
-  description: 'Start a local environment and generate a Workspace file for developing in Cursor Editor.'
-}, {
-  usage: `${exampleUsage} --editor=phpstorm --slug=example-site`,
-  description: 'Start a local environment and generate a Workspace file for developing in PhpStorm.'
-}];
-(0, _command.default)({
-  usage
-}).option('slug', 'A unique name for a local environment. Default is "vip-local".', undefined, _devEnvironmentCli.processSlug).option('skip-rebuild', 'Only start services that are not in a running state.').option(['w', 'skip-wp-versions-check'], 'Skip the prompt to update WordPress; occurs if the last major release version is not configured.').option('vscode', 'Generate a Visual Studio Code Workspace file (deprecated, use --editor=vscode instead).').option('editor', 'Generate a workspace file for the specified editor (supports: vscode, cursor, windsurf, phpstorm).').examples(examples).argv(process.argv, async (arg, opt) => {
-  const slug = await (0, _devEnvironmentCli.getEnvironmentName)(opt);
-  const lando = await (0, _devEnvironmentLando.bootstrapLando)({
-    logFile: (0, _devEnvironmentCli.getDevEnvLogFile)(slug)
-  });
-  (0, _devEnvironmentCli.validateDependencies)(lando);
-  const startProcessing = new Date();
-  const trackingInfo = (0, _devEnvironmentCli.getEnvTrackingInfo)(slug);
-  trackingInfo.editor = opt.editor || (opt.vscode ? 'vscode' : undefined);
-  trackingInfo.vscode = Boolean(opt.vscode);
-  trackingInfo.docker = lando.config.versions.engine;
-  trackingInfo.docker_compose = lando.config.versions.compose;
-  trackingInfo.compose_plugin = lando.config.versions.composePlugin;
-  await (0, _tracker.trackEvent)('dev_env_start_command_execute', trackingInfo);
-  debug('Args: ', arg, 'Options: ', opt);
-  const options = {
-    skipRebuild: Boolean(opt.skipRebuild),
-    skipWpVersionsCheck: Boolean(opt.skipWpVersionsCheck)
-  };
-  try {
-    await (0, _devEnvironmentCore.startEnvironment)(lando, slug, options);
-    const processingTime = Math.ceil((new Date() - startProcessing) / 1000); // in seconds
-    const successTrackingInfo = {
-      ...trackingInfo,
-      processing_time: processingTime
+const examples = [
+    {
+        usage: `${exampleUsage} --slug=example-site`,
+        description: 'Start a local environment named "example-site".',
+    },
+    {
+        usage: `${exampleUsage} --skip-wp-versions-check --slug=example-site`,
+        description: 'Skip the prompt to upgrade WordPress to the latest release version and start a local environment with the less recent version of WordPress currently configured.',
+    },
+    {
+        usage: `${exampleUsage} --skip-rebuild --slug=example-site`,
+        description: 'Start only the services of a local environment that are not currently in a running state.',
+    },
+    {
+        usage: `${exampleUsage} --editor=vscode --slug=example-site`,
+        description: 'Start a local environment and generate a Workspace file for developing in Visual Studio Code.',
+    },
+    {
+        usage: `${exampleUsage} --editor=cursor --slug=example-site`,
+        description: 'Start a local environment and generate a Workspace file for developing in Cursor Editor.',
+    },
+    {
+        usage: `${exampleUsage} --editor=phpstorm --slug=example-site`,
+        description: 'Start a local environment and generate a Workspace file for developing in PhpStorm.',
+    },
+];
+(0, command_1.default)({
+    usage,
+})
+    .option('slug', 'A unique name for a local environment. Default is "vip-local".', undefined, dev_environment_cli_1.processSlug)
+    .option('skip-rebuild', 'Only start services that are not in a running state.')
+    .option(['w', 'skip-wp-versions-check'], 'Skip the prompt to update WordPress; occurs if the last major release version is not configured.')
+    .option('vscode', 'Generate a Visual Studio Code Workspace file (deprecated, use --editor=vscode instead).')
+    .option('editor', 'Generate a workspace file for the specified editor (supports: vscode, cursor, windsurf, phpstorm).')
+    .examples(examples)
+    .argv(process.argv, async (arg, opt) => {
+    const slug = await (0, dev_environment_cli_1.getEnvironmentName)(opt);
+    const lando = await (0, dev_environment_lando_1.bootstrapLando)({ logFile: (0, dev_environment_cli_1.getDevEnvLogFile)(slug) });
+    (0, dev_environment_cli_1.validateDependencies)(lando);
+    const startProcessing = new Date();
+    const trackingInfo = (0, dev_environment_cli_1.getEnvTrackingInfo)(slug);
+    trackingInfo.editor = opt.editor || (opt.vscode ? 'vscode' : undefined);
+    trackingInfo.vscode = Boolean(opt.vscode);
+    trackingInfo.docker = lando.config.versions.engine;
+    trackingInfo.docker_compose = lando.config.versions.compose;
+    trackingInfo.compose_plugin = lando.config.versions.composePlugin;
+    await (0, tracker_1.trackEvent)('dev_env_start_command_execute', trackingInfo);
+    debug('Args: ', arg, 'Options: ', opt);
+    const options = {
+        skipRebuild: Boolean(opt.skipRebuild),
+        skipWpVersionsCheck: Boolean(opt.skipWpVersionsCheck),
     };
-    await (0, _tracker.trackEvent)('dev_env_start_command_success', successTrackingInfo);
-  } catch (error) {
-    await (0, _devEnvironmentCli.handleCLIException)(error, 'dev_env_start_command_error', trackingInfo);
-    process.exitCode = 1;
-  }
-  (0, _devEnvironmentCli.postStart)(slug, {
-    editor: opt.editor,
-    vscode: Boolean(opt.vscode)
-  });
-});
+    try {
+        await (0, dev_environment_core_1.startEnvironment)(lando, slug, options);
+        const processingTime = Math.ceil((new Date() - startProcessing) / 1000); // in seconds
+        const successTrackingInfo = { ...trackingInfo, processing_time: processingTime };
+        await (0, tracker_1.trackEvent)('dev_env_start_command_success', successTrackingInfo);
+    }
+    catch (error) {
+        await (0, dev_environment_cli_1.handleCLIException)(error, 'dev_env_start_command_error', trackingInfo);
+        process.exitCode = 1;
+    }
+    (0, dev_environment_cli_1.postStart)(slug, {
+        editor: opt.editor,
+        vscode: Boolean(opt.vscode),
+    });
+});