@automattic/vip 3.23.2 → 3.23.4-dev.0

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

@@ -49,7 +49,9 @@ cmd.argv(process.argv, async (arg, opt) => {
   if (hasConfiguration) {
     slug = await (0, _devEnvironmentCli.getEnvironmentName)(environmentNameOptions);
   }
-  const lando = await (0, _devEnvironmentLando.bootstrapLando)();
+  const lando = await (0, _devEnvironmentLando.bootstrapLando)({
+    logFile: (0, _devEnvironmentCli.getDevEnvLogFile)(slug)
+  });
   (0, _devEnvironmentCli.validateDependencies)(lando);
   debug('Args: ', arg, 'Options: ', opt);
   const trackingInfo = {

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

@@ -23,7 +23,9 @@ const examples = [{
   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)();
+  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_destroy_command_execute', trackingInfo);

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

@@ -25,7 +25,9 @@ const examples = [{
   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)();
+  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_exec_command_execute', trackingInfo);

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

@@ -23,16 +23,18 @@ const examples = [{
 }).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', 'Deprecated, not used.').examples(examples).argv(process.argv, async (arg, opt) => {
   let trackingInfo;
   let slug;
-  const lando = await (0, _devEnvironmentLando.bootstrapLando)();
   if (opt.all) {
     trackingInfo = {
       all: true
     };
-    slug = '';
+    slug = undefined;
   } else {
     slug = await (0, _devEnvironmentCli.getEnvironmentName)(opt);
     trackingInfo = (0, _devEnvironmentCli.getEnvTrackingInfo)(slug);
   }
+  const lando = await (0, _devEnvironmentLando.bootstrapLando)({
+    logFile: (0, _devEnvironmentCli.getDevEnvLogFile)(slug)
+  });
   (0, _devEnvironmentCli.validateDependencies)(lando);
   await (0, _tracker.trackEvent)('dev_env_info_command_execute', trackingInfo);
   debug('Args: ', arg, 'Options: ', opt);

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

@@ -16,7 +16,9 @@ const examples = [{
 (0, _command.default)({
   usage
 }).examples(examples).argv(process.argv, async () => {
-  const lando = await (0, _devEnvironmentLando.bootstrapLando)();
+  const lando = await (0, _devEnvironmentLando.bootstrapLando)({
+    logFile: (0, _devEnvironmentCli.getDevEnvLogFile)()
+  });
   lando.events.constructor.prototype.setMaxListeners(1024);
   (0, _devEnvironmentCli.validateDependencies)(lando);
   const trackingInfo = {

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

@@ -25,7 +25,9 @@ const examples = [{
   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)();
+  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);

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

@@ -34,7 +34,9 @@ const examples = [{
 }).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)();
+  const lando = await (0, _devEnvironmentLando.bootstrapLando)({
+    logFile: (0, _devEnvironmentCli.getDevEnvLogFile)()
+  });
   if (allEnvNames.length === 0) {
     console.log('No environments to purge!');
     return;

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

@@ -57,7 +57,9 @@ function getCommand(args) {
   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)();
+  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);

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

@@ -34,7 +34,9 @@ const examples = [{
   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)();
+  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);

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

@@ -22,24 +22,30 @@ const examples = [{
 (0, _command.default)({
   usage
 }).option('slug', 'A unique name for a local environment. Default is "vip-local".', undefined, _devEnvironmentCli.processSlug).option('all', 'Stop all local environments.').examples(examples).argv(process.argv, async (arg, opt) => {
-  const lando = await (0, _devEnvironmentLando.bootstrapLando)();
-  (0, _devEnvironmentCli.validateDependencies)(lando);
   debug('Args: ', arg, 'Options: ', opt);
 
   /** @type {Record< string, unknown >} */
   let trackingInfo;
   /** @type {string[]} */
   let environments;
+  /** @type {string|undefined} */
+  let logSlug;
   if (opt.all) {
     trackingInfo = {
       all: true
     };
     environments = (0, _devEnvironmentCore.getAllEnvironmentNames)();
+    logSlug = undefined;
   } else {
     const slug = await (0, _devEnvironmentCli.getEnvironmentName)(opt);
     trackingInfo = (0, _devEnvironmentCli.getEnvTrackingInfo)(slug);
     environments = [slug];
+    logSlug = slug;
   }
+  const lando = await (0, _devEnvironmentLando.bootstrapLando)({
+    logFile: (0, _devEnvironmentCli.getDevEnvLogFile)(logSlug)
+  });
+  (0, _devEnvironmentCli.validateDependencies)(lando);
   await (0, _tracker.trackEvent)('dev_env_stop_command_execute', trackingInfo);
   for (const slug of environments) {
     try {

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

@@ -70,7 +70,9 @@ const appQuery = `
     multisite: env.isMultisite
   });
   await trackerFn('execute');
-  const lando = await (0, _devEnvironmentLando.bootstrapLando)();
+  const lando = await (0, _devEnvironmentLando.bootstrapLando)({
+    logFile: (0, _devEnvironmentCli.getDevEnvLogFile)(slug)
+  });
   const isUp = (await Promise.all([(0, _devEnvironmentLando.isContainerRunning)(lando, slug, 'php'), (0, _devEnvironmentLando.isContainerRunning)(lando, slug, 'database')])).every(Boolean);
   if (!isUp && !opt.force) {
     await trackerFn('env_not_running_error', {

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

@@ -31,7 +31,9 @@ const cmd = (0, _command.default)({
 cmd.examples(examples);
 cmd.argv(process.argv, async (arg, opt) => {
   const slug = await (0, _devEnvironmentCli.getEnvironmentName)(opt);
-  const lando = await (0, _devEnvironmentLando.bootstrapLando)();
+  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_update_command_execute', trackingInfo);

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

@@ -131,6 +131,7 @@ Are you sure you want to import the contents of the URL?
     sourceIsLocal = true;
     const fileMeta = await (0, _clientFileUploader.getFileMeta)(fileNameOrURL);
     fileMeta.fileName = fileNameOrURL;
+    let lastProgress = '';
     const {
       fileMeta: {
         basename
@@ -141,8 +142,15 @@ Are you sure you want to import the contents of the URL?
       app,
       env,
       fileMeta,
-      progressCallback: percentage => console.log(`Upload progress: ${percentage}%`)
+      progressCallback: percentage => {
+        if (percentage === lastProgress) {
+          return;
+        }
+        lastProgress = percentage;
+        process.stdout.write(`\rUpload progress: ${percentage}   `);
+      }
     });
+    process.stdout.write('\n');
 
     // small debug info to keep variables used
     debug('Uploaded file basename:', basename);

package/dist/commands/dev-env-import-sql.js

@@ -24,7 +24,9 @@ class DevEnvImportSQLCommand {
     this.slug = slug;
   }
   async run() {
-    const lando = await (0, _devEnvironmentLando.bootstrapLando)();
+    const lando = await (0, _devEnvironmentLando.bootstrapLando)({
+      logFile: (0, _devEnvironmentCli.getDevEnvLogFile)(this.slug)
+    });
     (0, _devEnvironmentCli.validateDependencies)(lando);
     (0, _sql.validateImportFileExtension)(this.fileName);
     const dumpDetails = await (0, _database.getSqlDumpDetails)(this.fileName);

package/dist/lib/cli/command.js

@@ -440,30 +440,39 @@ _args.default.argv = async function (argv, cb) {
           break;
         }
       case 'import-media':
-        info.push({
-          key: 'Archive URL',
-          value: _chalk.default.blue.underline(this.sub)
-        });
-        options.overwriteExistingFiles = Object.hasOwn(options, 'overwriteExistingFiles') && Boolean(options.overwriteExistingFiles) && !['false', 'no'].includes(options.overwriteExistingFiles);
-        info.push({
-          key: 'Overwrite any existing files',
-          value: options.overwriteExistingFiles ? '✅ Yes' : `${_chalk.default.red('x')} No`
-        });
-        options.importIntermediateImages = Object.hasOwn(options, 'importIntermediateImages') && Boolean(options.importIntermediateImages) && !['false', 'no'].includes(options.importIntermediateImages);
-        info.push({
-          key: 'Import intermediate image files',
-          value: options.importIntermediateImages ? '✅ Yes' : `${_chalk.default.red('x')} No`
-        });
-        options.exportFileErrorsToJson = Object.hasOwn(options, 'exportFileErrorsToJson') && Boolean(options.exportFileErrorsToJson) && !['false', 'no'].includes(options.exportFileErrorsToJson);
-        info.push({
-          key: 'Export any file errors encountered to a JSON file instead of a plain text file.',
-          value: options.exportFileErrorsToJson ? '✅ Yes' : `${_chalk.default.red('x')} No`
-        });
-        info.push({
-          key: 'Download file-error logs?',
-          value: options.saveErrorLog
-        });
-        break;
+        {
+          const isUrl = this.sub && (String(this.sub).startsWith('http://') || String(this.sub).startsWith('https://'));
+          const archiveLabel = isUrl ? 'Archive URL' : 'Archive Path';
+          info.push({
+            key: archiveLabel,
+            value: _chalk.default.blue.underline(this.sub)
+          });
+
+          // Update confirmation message if it's a local path
+          if (!isUrl && 'string' === typeof _opts.requireConfirm) {
+            message = message.replaceAll('the URL', 'the path');
+          }
+          options.overwriteExistingFiles = Object.hasOwn(options, 'overwriteExistingFiles') && Boolean(options.overwriteExistingFiles) && !['false', 'no'].includes(options.overwriteExistingFiles);
+          info.push({
+            key: 'Overwrite any existing files',
+            value: options.overwriteExistingFiles ? '✅ Yes' : `${_chalk.default.red('x')} No`
+          });
+          options.importIntermediateImages = Object.hasOwn(options, 'importIntermediateImages') && Boolean(options.importIntermediateImages) && !['false', 'no'].includes(options.importIntermediateImages);
+          info.push({
+            key: 'Import intermediate image files',
+            value: options.importIntermediateImages ? '✅ Yes' : `${_chalk.default.red('x')} No`
+          });
+          options.exportFileErrorsToJson = Object.hasOwn(options, 'exportFileErrorsToJson') && Boolean(options.exportFileErrorsToJson) && !['false', 'no'].includes(options.exportFileErrorsToJson);
+          info.push({
+            key: 'Export any file errors encountered to a JSON file instead of a plain text file.',
+            value: options.exportFileErrorsToJson ? '✅ Yes' : `${_chalk.default.red('x')} No`
+          });
+          info.push({
+            key: 'Download file-error logs?',
+            value: options.saveErrorLog
+          });
+          break;
+        }
       default:
     }
     const skipPrompt = _opts.skipConfirmPrompt || false;

package/dist/lib/dev-environment/dev-environment-cli.js

@@ -4,6 +4,9 @@ exports.__esModule = true;
 exports.DEFAULT_SLUG = exports.CONFIGURATION_FOLDER = void 0;
 exports.addDevEnvConfigurationOptions = addDevEnvConfigurationOptions;
 exports.ensureValidPathsInOptions = ensureValidPathsInOptions;
+exports.formatDevEnvLogSlug = formatDevEnvLogSlug;
+exports.formatDevEnvLogTimestamp = formatDevEnvLogTimestamp;
+exports.getDevEnvLogFile = getDevEnvLogFile;
 exports.getEnvTrackingInfo = getEnvTrackingInfo;
 exports.getEnvironmentName = getEnvironmentName;
 exports.getEnvironmentStartCommand = getEnvironmentStartCommand;
@@ -666,6 +669,16 @@ function processSlug(value) {
   // eslint-disable-next-line @typescript-eslint/no-base-to-string
   return (value ?? '').toString().toLowerCase();
 }
+function formatDevEnvLogTimestamp(date) {
+  return date.toISOString().replace(/\..*$/, '').replace(/[-:]/g, '').replace('T', '-');
+}
+function formatDevEnvLogSlug(slug) {
+  return slug.replace(/[^a-z0-9_-]+/gi, '-').toLowerCase();
+}
+function getDevEnvLogFile(slug) {
+  const slugPart = slug ? formatDevEnvLogSlug(slug) : 'all';
+  return `vip-dev-env-${slugPart}-${formatDevEnvLogTimestamp(new Date())}.log`;
+}
 function processVersionOption(value) {
   if (typeof value === 'string' || typeof value === 'number') {
     if (!isNaN(value) && Number(value) % 1 === 0) {

package/dist/lib/dev-environment/dev-environment-lando.js

@@ -22,14 +22,17 @@ var _bootstrap = require("lando/lib/bootstrap");
 var _lando = _interopRequireDefault(require("lando/lib/lando"));
 var _utils = _interopRequireDefault(require("lando/plugins/lando-core/lib/utils"));
 var _build = _interopRequireDefault(require("lando/plugins/lando-tooling/lib/build"));
+var _nodeChild_process = require("node:child_process");
 var _promises = require("node:dns/promises");
 var _promises2 = require("node:fs/promises");
 var _nodeOs = require("node:os");
 var _nodePath = _interopRequireWildcard(require("node:path"));
+var _nodeUtil = require("node:util");
 var _semver = require("semver");
 var _devEnvironmentCore = require("./dev-environment-core");
 var _dockerUtils = require("./docker-utils");
 var _devEnvironment = require("../constants/dev-environment");
+var _env = _interopRequireDefault(require("../env"));
 var _userError = _interopRequireDefault(require("../user-error"));
 var _xdgData = require("../xdg-data");
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
@@ -39,11 +42,117 @@ function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e
  */
 const DEBUG_KEY = '@automattic/vip:bin:dev-environment';
 const debug = (0, _debug.default)(DEBUG_KEY);
+const execFileAsync = (0, _nodeUtil.promisify)(_nodeChild_process.execFile);
+const bannerLabelWidth = 18;
+let logPathRegistered = false;
+let resolvedLogPath = null;
+const getLogFilePath = config => {
+  if (config.logFile) {
+    return _nodePath.default.isAbsolute(config.logFile) ? config.logFile : _nodePath.default.join(config.logDir ?? '', config.logFile);
+  }
+  if (config.logDir && config.logName) {
+    return _nodePath.default.join(config.logDir, `${config.logName}.log`);
+  }
+  return null;
+};
+const registerLogPathOutput = config => {
+  if (logPathRegistered) {
+    return;
+  }
+  resolvedLogPath = getLogFilePath(config);
+  if (!resolvedLogPath) {
+    return;
+  }
+  logPathRegistered = true;
+  process.once('exit', () => {
+    if (resolvedLogPath && process.stdout.isTTY) {
+      console.log(`\n ${formatBannerLine(_chalk.default.cyan('COMMAND LOG FILE'.padEnd(bannerLabelWidth)), resolvedLogPath)}`);
+    }
+  });
+};
+const formatBytes = bytes => {
+  const gb = bytes / 1024 ** 3;
+  return `${gb.toFixed(1)} GB`;
+};
+const isRecord = value => typeof value === 'object' && value !== null;
+const isDockerPluginInfo = value => isRecord(value);
+const getDockerVersions = async config => {
+  const dockerBin = config.dockerBin ?? '';
+  const composeBin = config.composeBin ?? '';
+  let engine = 'unknown';
+  let compose = 'unknown';
+  let composePlugin = 'unknown';
+  try {
+    if (dockerBin) {
+      const {
+        stdout
+      } = await execFileAsync(dockerBin, ['info', '--format', 'json']);
+      const dockerData = JSON.parse(stdout);
+      if (isRecord(dockerData)) {
+        const serverVersion = dockerData.ServerVersion;
+        if (typeof serverVersion === 'string') {
+          engine = serverVersion;
+        }
+        const clientInfo = dockerData.ClientInfo;
+        if (isRecord(clientInfo)) {
+          const plugins = clientInfo.Plugins;
+          if (Array.isArray(plugins)) {
+            const composePluginEntry = plugins.find(plugin => isDockerPluginInfo(plugin) && plugin.Name === 'compose');
+            if (composePluginEntry && typeof composePluginEntry.Version === 'string') {
+              composePlugin = composePluginEntry.Version;
+            }
+          }
+        }
+      }
+    }
+  } catch (error) {
+    debug('Failed to read docker version info: %O', error);
+  }
+  try {
+    if (composeBin) {
+      const {
+        stdout
+      } = await execFileAsync(composeBin, ['version', '--short']);
+      compose = stdout.trim() || compose;
+    }
+  } catch (error) {
+    debug('Failed to read docker-compose version info: %O', error);
+  }
+  return {
+    engine,
+    compose,
+    composePlugin
+  };
+};
+const formatBannerLine = (label, value) => `${label.padEnd(bannerLabelWidth)} ${value}`;
+const writeLogBanner = async config => {
+  const logFilePath = getLogFilePath(config);
+  if (!logFilePath) {
+    return;
+  }
+  try {
+    const existing = await (0, _promises2.stat)(logFilePath);
+    if (existing.size > 0) {
+      return;
+    }
+  } catch {
+    // File does not exist yet.
+  }
+  await (0, _promises2.mkdir)(_nodePath.default.dirname(logFilePath), {
+    recursive: true
+  });
+  const dockerVersions = await getDockerVersions(config);
+  const command = process.argv.slice(1).join(' ');
+  const bannerLines = ['=== VIP Dev Env Log ===', formatBannerLine('COMMAND', command), formatBannerLine('OS', `${_env.default.os.name} ${_env.default.os.version} ${_env.default.os.arch}`), formatBannerLine('NODE', _env.default.node.version), formatBannerLine('VIP-CLI', _env.default.app.version), formatBannerLine('DOCKER ENGINE', dockerVersions.engine), formatBannerLine('DOCKER COMPOSE', dockerVersions.compose), formatBannerLine('COMPOSE PLUGIN', dockerVersions.composePlugin), formatBannerLine('DOCKER BIN', config.dockerBin ?? 'unknown'), formatBannerLine('COMPOSE BIN', config.composeBin ?? 'unknown'), formatBannerLine('RAM', formatBytes((0, _nodeOs.totalmem)())), formatBannerLine('CPU', String((0, _nodeOs.cpus)().length)), '===', '', ''];
+  await (0, _promises2.writeFile)(logFilePath, bannerLines.join('\n'), {
+    flag: 'a'
+  });
+};
 
 /**
  * @return {Promise<LandoConfig>} Lando configuration
  */
-async function getLandoConfig() {
+async function getLandoConfig(options = {}) {
   // The path will be smth like `yarn/global/node_modules/lando/lib/lando.js`; we need the path up to `lando` (inclusive)
   const landoPath = (0, _nodePath.dirname)((0, _nodePath.dirname)(require.resolve('lando')));
   debug(`Getting Lando config, using paths '${landoPath}' for plugins`);
@@ -60,6 +169,7 @@ async function getLandoConfig() {
   const vipDir = _nodePath.default.join((0, _xdgData.xdgData)(), 'vip');
   const landoDir = _nodePath.default.join(vipDir, 'lando');
   const fakeHomeDir = _nodePath.default.join(landoDir, 'home');
+  const logDir = _nodePath.default.join(landoDir, 'logs');
   try {
     await (0, _promises2.mkdir)(fakeHomeDir, {
       recursive: true
@@ -69,6 +179,9 @@ async function getLandoConfig() {
   }
   const config = {
     logLevelConsole,
+    logDir,
+    logFile: options.logFile ?? 'vip-dev-env.log',
+    logName: options.logName ?? 'vip-dev-env',
     configSources: [_nodePath.default.join(landoDir, 'config.yml')],
     landoFile: '.lando.yml',
     preLandoFiles: ['.lando.base.yml', '.lando.dist.yml', '.lando.upstream.yml'],
@@ -159,17 +272,25 @@ async function getLandoApplication(lando, instancePath) {
     debug('getLandoApplication() took %d ms', duration);
   }
 }
-async function bootstrapLando() {
+async function bootstrapLando(options = {}) {
   const started = new Date();
   try {
+    if (process.env.DEBUG && !process.env.DEBUG.includes('-winston:*')) {
+      process.env.DEBUG = `${process.env.DEBUG},-winston:*`;
+    }
     const socket = await (0, _dockerUtils.getDockerSocket)();
-    const config = await getLandoConfig();
+    const config = await getLandoConfig(options);
     debug('Docker socket: %j', socket);
     if (socket) {
       config.engineConfig = await (0, _dockerUtils.getEngineConfig)(socket);
       debug('Engine config: %j', config.engineConfig);
     }
+    registerLogPathOutput(config);
+    await writeLogBanner(config);
     const lando = new _lando.default(config);
+    _debug.default.log = (message, ...args) => {
+      lando.log.debug(message, ...args);
+    };
     lando.events.once('pre-engine-build', async data => {
       const instanceData = (0, _devEnvironmentCore.readEnvironmentData)(data.name);
       let registryResolvable = false;