@scandipwa/magento-scripts 2.4.12-alpha.0 → 2.4.13

package/.oxlintrc.json

@@ -0,0 +1,32 @@
+{
+    "$schema": "../../node_modules/oxlint/configuration_schema.json",
+    "env": {
+        "node": true,
+        "es2022": true
+    },
+    "globals": {
+        "verbose": "readonly",
+        "NodeJS": "readonly",
+        "BufferEncoding": "readonly"
+    },
+    "categories": {
+        "correctness": "error"
+    },
+    "ignorePatterns": [
+        "**/node_modules/**",
+        "**/lib/config/templates/**",
+        "**/typings/**",
+        "**/*.d.ts"
+    ],
+    "rules": {
+        "no-unused-vars": [
+            "warn",
+            {
+                "argsIgnorePattern": "^_",
+                "caughtErrorsIgnorePattern": "^_",
+                "varsIgnorePattern": "^_"
+            }
+        ],
+        "unicorn/no-useless-fallback-in-spread": "off"
+    }
+}

package/exec.js

@@ -93,7 +93,7 @@ const newVersionIsAPatch = (latestVersion, currentVersion) => {
             process.isOutOfDateVersion = true
             process.isOutOfDateVersionMessage = message
         }
-    } catch (e) {
+    } catch {
         logger.warn(`Package ${logger.style.misc(name)} is not yet published.`)
         logger.log() // add empty line
     }

package/index.js

@@ -6,7 +6,6 @@ const logger = require('@scandipwa/scandipwa-dev-utils/logger')
 const semver = require('semver')
 const isInstalledGlobally = require('is-installed-globally')
 const isRunningRoot = require('./lib/util/is-running-root')
-const ensureAgentsMd = require('./lib/util/ensure-agents-md')
 
 if (isRunningRoot()) {
     logger.error('Root privileges detected!')
@@ -28,8 +27,6 @@ If you are experiencing problems with ${logger.style.misc(
     process.exit(1)
 }
 
-ensureAgentsMd()
-
 const commands = [
     require('./lib/commands/link'),
     require('./lib/commands/logs'),
@@ -118,7 +115,7 @@ const newVersionIsAPatch = (latestVersion, currentVersion) => {
             process.isOutOfDateVersion = true
             process.isOutOfDateVersionMessage = message
         }
-    } catch (e) {
+    } catch {
         logger.warn(`Package ${logger.style.misc(name)} is not yet published.`)
         logger.log() // add empty line
     }

package/lib/commands/status.js

@@ -3,7 +3,7 @@ const { Listr } = require('listr2')
 const getMagentoVersionConfig = require('../config/get-magento-version-config')
 const { getCachedPorts } = require('../config/get-port-config')
 
-const { prettyStatus } = require('../tasks/status')
+const { prettyStatus, simpleStatus } = require('../tasks/status')
 const { checkRequirements } = require('../tasks/requirements')
 const { statusContainers } = require('../tasks/docker/containers')
 const getProjectConfiguration = require('../config/get-project-configuration')
@@ -20,10 +20,35 @@ module.exports = (yargs) => {
     yargs.command(
         'status',
         'Show application status',
-        // eslint-disable-next-line @typescript-eslint/no-empty-function
-        () => {},
+        (yargs) => {
+            yargs
+                .option('non-interactive', {
+                    alias: 'n',
+                    type: 'boolean',
+                    default: false,
+                    description:
+                        'Print a plain-text status summary (for AI terminals and scripts)'
+                })
+                .option('verbose', {
+                    alias: 'v',
+                    type: 'boolean',
+                    default: false,
+                    description:
+                        'Retrieve Docker image and volume sizes (slower, off by default)'
+                })
+        },
         async (args) => {
             const silent = /** @type {boolean} */ (args.silent)
+            // A non-TTY stdout (pipe, CI, AI terminal) is inherently
+            // non-interactive; the -n flag forces it even inside a TTY.
+            const nonInteractive =
+                !!(args.nonInteractive || args.n) || !process.stdout.isTTY
+            // Enumerating per-image/-volume sizes shells out to
+            // `docker system df --verbose`, which is slow; skip it by default.
+            // The non-interactive report already prints the full status; the
+            // --verbose flag only adds the Docker image/volume sizes (and is
+            // what the pretty renderer needs to render them at all).
+            const verbose = !!(args.verbose || args.v)
             const tasks = new Listr(
                 [
                     checkRequirements(),
@@ -40,6 +65,9 @@ module.exports = (yargs) => {
                                     checkSearchEngineVersion(),
                                     {
                                         title: 'Retrieving Docker System data',
+                                        skip: () =>
+                                            !verbose &&
+                                            'Docker image and volume sizes omitted (pass --verbose to include them)',
                                         task: async (ctx) => {
                                             ctx.systemDFData =
                                                 await systemApi.df({
@@ -59,15 +87,25 @@ module.exports = (yargs) => {
                 {
                     concurrent: false,
                     exitOnError: false,
-                    ctx: { throwMagentoVersionMissing: true, ...args, silent },
-                    renderer:
-                        silent || !process.stdout.isTTY ? 'silent' : 'default',
+                    ctx: {
+                        throwMagentoVersionMissing: true,
+                        ...args,
+                        silent,
+                        nonInteractive,
+                        verbose
+                    },
+                    renderer: silent || nonInteractive ? 'silent' : 'default',
                     rendererOptions: { collapse: false, clearOutput: false }
                 }
             )
 
             try {
-                await prettyStatus(await tasks.run())
+                const ctx = await tasks.run()
+                if (nonInteractive) {
+                    simpleStatus(ctx)
+                } else {
+                    await prettyStatus(ctx)
+                }
             } catch (e) {
                 logger.error(e.message || e)
                 process.exit(1)

package/lib/config/docker.js

@@ -23,7 +23,7 @@ const rosettaTranslatedContainers =
  */
 const volumeDirectives = (directives) => {
     const directivesResult = Object.entries(directives)
-        .filter(([name, value]) => value === true)
+        .filter(([, value]) => value === true)
         .map(([name]) => name)
         .join(',')
 

package/lib/config/system-config.js

@@ -25,7 +25,7 @@ const getSystemConfig = async ({ validate = true } = {}) => {
         let userSystemConfigParsed
         try {
             userSystemConfigParsed = JSON.parse(userSystemConfig)
-        } catch (e) {
+        } catch {
             throw new KnownError(
                 `System configuration file is not a valid JSON!\n\nFile location: ${systemConfigPath}`
             )
@@ -61,7 +61,7 @@ const getSystemConfigSync = ({ validate = true } = {}) => {
         let userSystemConfigParsed
         try {
             userSystemConfigParsed = JSON.parse(userSystemConfig)
-        } catch (e) {
+        } catch {
             throw new KnownError(
                 `System configuration file is not a valid JSON!\n\nFile location: ${systemConfigPath}`
             )

package/lib/tasks/database/import-remote-db/ssh/readymage.js

@@ -38,7 +38,8 @@ const readymageSSH = () => ({
                     ...databaseDumpCommandWithOptions,
                     '--no-data',
                     '--result-file=dump-1.sql',
-                    ...[...orderTables, ...customerTables]
+                    ...orderTables,
+                    ...customerTables
                 ].join(' ')
 
                 await ssh.execCommand(secondCommand)

package/lib/tasks/docker/containers/tasks.js

@@ -172,7 +172,7 @@ const startContainers = () => ({
 
         const missingContainers = Object.entries(containers)
             .filter(
-                ([nameWithoutPrefix, { name }]) =>
+                ([, { name }]) =>
                     !containerList.some((c) => c.Names === name)
             )
             .map(([nameWithoutPrefix, containerOptions]) => ({

package/lib/tasks/file-system/create-git-hook-notification.js

@@ -11,7 +11,7 @@ function isExec(p) {
     try {
         fs.accessSync(p, fs.constants.X_OK)
         return true
-    } catch (e) {
+    } catch {
         return false
     }
 }

package/lib/tasks/file-system/create-nginx-config.js

@@ -1,6 +1,9 @@
 const path = require('path')
 const setConfigFile = require('../../util/set-config')
 const UnknownError = require('../../errors/unknown-error')
+const {
+    shouldUseStoreDomainMapping
+} = require('../../util/store-domains')
 
 /**
  * @returns {import('listr2').ListrTask<import('../../../typings/context').ListrContext>}
@@ -35,7 +38,7 @@ const createNginxConfig = () => ({
         }
 
         const useStoreDomainMapping =
-            storeDomains && Object.keys(storeDomains).length > 1
+            shouldUseStoreDomainMapping(storeDomains)
 
         try {
             await setConfigFile({

package/lib/tasks/file-system/create-phpstorm-config/php-docker-settings-config/index.js

@@ -18,14 +18,12 @@ const setupPhpDockerSettingsConfig = () => ({
             )
             const phpDockerSettingsConfigs =
                 phpDockerSettingsConfigContent.project.component
-            const hasChanges = await Promise.all([
-                setupPHPDockerContainerSettingsConfig(
-                    phpDockerSettingsConfigs,
-                    ctx
-                )
-            ])
+            const hasChanges = await setupPHPDockerContainerSettingsConfig(
+                phpDockerSettingsConfigs,
+                ctx
+            )
 
-            if (hasChanges.includes(true)) {
+            if (hasChanges === true) {
                 await buildXmlFile(
                     phpDockerSettingsConfig.path,
                     phpDockerSettingsConfigContent
@@ -41,9 +39,7 @@ const setupPhpDockerSettingsConfig = () => ({
         const phpDockerSettingsConfigs =
             phpDockerSettingsConfigContent.project.component
 
-        await Promise.all([
-            setupPHPDockerContainerSettingsConfig(phpDockerSettingsConfigs, ctx)
-        ])
+        await setupPHPDockerContainerSettingsConfig(phpDockerSettingsConfigs, ctx)
 
         await buildXmlFile(
             phpDockerSettingsConfig.path,

package/lib/tasks/magento/install-magento-project.js

@@ -283,7 +283,7 @@ const installMagentoProject = () => ({
             isVendorFolderCorrupted = await getIsVendorFolderCorrupted(
                 baseConfig.magentoDir
             )
-        } catch (e) {
+        } catch {
             // ignore error just in case
         }
 

package/lib/tasks/magento/setup-magento/set-base-url.js

@@ -1,5 +1,8 @@
 const { updateTableValues, databaseQuery } = require('../../../util/database')
 const KnownError = require('../../../errors/known-error')
+const {
+    resolveStoreDomainsForScopes
+} = require('../../../util/store-domains')
 
 /**
  * @param {number} scopeId
@@ -129,25 +132,10 @@ const setBaseUrl = () => ({
             )
         }
 
-        const storeDomainsWithMapping = Object.entries(storeDomains).reduce(
-            (acc, [key, val]) => {
-                const entity = entities.find(
-                    /** @param {{ code: string }} entity */
-                    (entity) => entity.code === key
-                )
-                if (entity) {
-                    return {
-                        ...acc,
-                        [entity.code]: {
-                            scopeId: entity[idField],
-                            domain: val
-                        }
-                    }
-                }
-
-                return acc
-            },
-            {}
+        const storeDomainsWithMapping = resolveStoreDomainsForScopes(
+            storeDomains,
+            entities,
+            idField
         )
 
         // Check for missing store codes when runType is 'store'

package/lib/tasks/magento/setup-magento/waiting-for-varnish.js

@@ -80,7 +80,7 @@ const waitingForVarnish = () => ({
                 } else {
                     break
                 }
-            } catch (e) {
+            } catch {
                 tries++
                 await sleep(200)
             }
@@ -155,7 +155,7 @@ Do you want to try resolving this issue by replacing ${logger.style.file(
                                 connectionFixed = true
                                 break
                             }
-                        } catch (e) {
+                        } catch {
                             await sleep(200)
                         }
                     }

package/lib/tasks/requirements/docker/running-status.js

@@ -94,7 +94,7 @@ const checkDockerStatusMacOS = () => ({
                             } else {
                                 ready = true
                             }
-                        } catch (e) {
+                        } catch {
                             //
                         }
                     }

package/lib/tasks/requirements/searchengine-version.js

@@ -79,7 +79,7 @@ const checkSearchEngineVersion = () => ({
                                             : 'OpenSearch'
                                     } version ${searchEngineVersion} in container`
                                 }
-                            } catch (e) {
+                            } catch {
                                 subTask.skip()
                             }
                         }

package/lib/tasks/status/index.js

@@ -8,6 +8,16 @@ const { getArchSync } = require('../../util/arch')
 const ConsoleBlock = require('../../util/console-block')
 const { getInstanceMetadata } = require('../../util/instance-metadata')
 
+// eslint-disable-next-line no-control-regex
+const consoleStyleReplacer = /[]\[\S+?m/g
+
+/**
+ * chalk already drops styling when stdout is not a TTY, but strip defensively
+ * so the plain output stays clean even under FORCE_COLOR.
+ * @param {string} str
+ */
+const stripStyle = (str) => String(str).replace(consoleStyleReplacer, '')
+
 /**
  * @param {any} str
  * @returns {str is string}
@@ -18,7 +28,7 @@ const isJSON = (str) => {
         if (typeof result === 'object') {
             return true
         }
-    } catch (e) {
+    } catch {
         //
     }
 
@@ -230,9 +240,10 @@ const prettyStatus = async (ctx) => {
 
     Object.values(volumes)
         .map((volume) => {
-            volume.volumeData = systemDFData.Volumes.find(
-                (v) => v.Name === volume.name
-            )
+            volume.volumeData =
+                systemDFData &&
+                systemDFData.Volumes &&
+                systemDFData.Volumes.find((v) => v.Name === volume.name)
 
             return volume
         })
@@ -273,4 +284,174 @@ const prettyStatus = async (ctx) => {
     block.log()
 }
 
-module.exports = { prettyStatus }
+/**
+ * Plain-text status summary for non-interactive environments (AI agents, CI,
+ * pipes). No box drawing or ANSI styling — just the facts an agent needs to
+ * act, plus the commands to run next.
+ * @param {import('../../../typings/context').ListrContext & { containers: ReturnType<Awaited<ReturnType<import('../../config/docker')>>['getContainers']> }} ctx
+ */
+const simpleStatus = (ctx) => {
+    const {
+        config: { baseConfig },
+        magentoVersion,
+        composerVersion,
+        dockerVersion,
+        containers,
+        systemDFData,
+        verbose
+    } = ctx
+
+    const lines = []
+
+    lines.push(
+        `magento-scripts ${packageVersion} — status (non-interactive)`,
+        '',
+        `Project: ${baseConfig.prefix}`,
+        `Location: ${process.cwd()}`,
+        `Magento: ${magentoVersion || 'unknown'}`,
+        `PHP: ${ctx.phpVersion || 'unknown'}`,
+        `Composer: ${composerVersion || 'unknown'}`,
+        `Docker: ${dockerVersion || 'unknown'}`,
+        `Platform: ${ctx.platform} (${getArchSync()})`
+    )
+
+    lines.push(
+        `Platform version: ${ctx.platformVersion || 'unknown'}`,
+        `CGroup version: ${ctx.cgroupVersion || 'unknown'}`
+    )
+
+    const projectCreatedAt = getProjectCreatedAt()
+    if (projectCreatedAt) {
+        lines.push(
+            `Project created: ${projectCreatedAt.toDateString()} ${projectCreatedAt.toTimeString()}`
+        )
+    }
+
+    lines.push('', 'Containers:')
+
+    let anyRunning = false
+
+    Object.values(containers).forEach((container) => {
+        const state = container.status && container.status.State
+        let status
+
+        if (state && state.Health && state.Status === 'running') {
+            status = `running (${state.Health.Status})`
+            anyRunning = true
+        } else if (state && state.Status && state.Status !== 'exited') {
+            status = state.Status
+            if (state.Status === 'running') {
+                anyRunning = true
+            }
+        } else {
+            status = 'not running'
+        }
+
+        lines.push(`  ${container._ || container.name}: ${status}`)
+
+        lines.push(`    Name: ${container.name}`)
+
+        const image =
+            container.status &&
+            container.status.Config &&
+            container.status.Config.Image
+                ? container.status.Config.Image
+                : container.image
+        lines.push(`    Image: ${image}`, `    Network: ${container.network}`)
+
+        if (
+            status !== 'not running' &&
+            container.forwardedPorts &&
+            container.forwardedPorts.length > 0
+        ) {
+            lines.push('    Port forwarding:')
+            container.forwardedPorts.forEach((port) => {
+                const { host, hostPort, containerPort } = parsePort(port)
+                if (container.network !== 'host') {
+                    lines.push(
+                        `      ${host}:${hostPort} -> ${containerPort} (host -> container)`
+                    )
+                } else {
+                    lines.push(
+                        `      Running on host network - ${host}:${hostPort}`
+                    )
+                }
+            })
+        }
+
+        if (container.env && Object.keys(container.env).length > 0) {
+            lines.push('    Environment variables:')
+            for (const [envName, envValue] of Object.entries(container.env)) {
+                lines.push(`      ${envName}=${envValue}`)
+            }
+        }
+
+        if (container.description) {
+            lines.push('    Description:')
+            container.description.split('\n').forEach((line) => {
+                lines.push(`      ${stripStyle(line)}`)
+            })
+        }
+    })
+
+    lines.push('', 'Volumes:')
+
+    const { volumes } = ctx.config.docker
+
+    Object.values(volumes).forEach((volume) => {
+        const volumeData =
+            systemDFData &&
+            systemDFData.Volumes &&
+            systemDFData.Volumes.find((v) => v.Name === volume.name)
+
+        lines.push(`  ${volume.name}`)
+
+        if (volumeData) {
+            lines.push(`    Size: ${volumeData.Size}`)
+        }
+
+        if (ctx.isDockerDesktop && volume.opt && volume.opt.device) {
+            lines.push(
+                `    Mountpoint: ${volume.opt.device.replace(
+                    process.cwd(),
+                    '<project location>'
+                )}`
+            )
+        }
+    })
+
+    if (!verbose) {
+        lines.push('  (volume sizes omitted — pass --verbose to include them)')
+    }
+
+    const instanceMetadata = getInstanceMetadata(ctx)
+
+    lines.push('', 'Frontend:')
+    instanceMetadata.frontend.forEach(({ title, text }) => {
+        lines.push(`  ${stripStyle(title)}: ${stripStyle(text)}`)
+    })
+
+    lines.push('', 'Admin:')
+    instanceMetadata.admin.forEach(({ title, text }) => {
+        lines.push(`  ${stripStyle(title)}: ${stripStyle(text)}`)
+    })
+
+    lines.push('', 'MailDev:')
+    instanceMetadata.maildev.forEach(({ title, text }) => {
+        lines.push(`  ${stripStyle(title)}: ${stripStyle(text)}`)
+    })
+
+    lines.push('')
+    if (!anyRunning) {
+        lines.push(
+            'Environment is not running. Start it with: magento-scripts start'
+        )
+    }
+    lines.push(
+        'Run Magento CLI: magento-scripts exec php bin/magento <command>'
+    )
+
+    logger.log(lines.join('\n'))
+}
+
+module.exports = { prettyStatus, simpleStatus }

package/lib/tasks/theme/build-theme.js

@@ -30,7 +30,7 @@ const buildTheme = ({ themePath }) => ({
                               task.output = t
                           }
                 })
-            } catch (e) {
+            } catch {
                 throw new UnknownError(`We were unable to install theme dependencies in ${themePath} using ${logger.style.code(
                     commandToInstallDependencies
                 )} command!

package/lib/util/analytics.js

@@ -168,7 +168,7 @@ class Analytics {
 
         try {
             this.setClientIdentifier(generateUUID())
-        } catch (e) {
+        } catch {
             this.setClientIdentifier(`${Date.now()}`)
         }
     }
@@ -233,7 +233,7 @@ class Analytics {
             analyticsParameters.session = {
                 ipOverride: await getExternalIpAddress()
             }
-        } catch (e) {
+        } catch {
             // Do nothing
         }
 

package/lib/util/exec-async-command.js

@@ -67,7 +67,7 @@ const execAsyncSpawn = (
                 .split('\n')
                 .map((str) => str.trim())
                 .forEach((str) => {
-                    callback && callback(str)
+                    callback?.(str)
                 })
             if (logOutput) {
                 newData

package/lib/util/ip.js

@@ -39,7 +39,7 @@ const getExternalIpAddress = async () => {
                 ip = response.data
                 break
             }
-        } catch (e) {
+        } catch {
             //
         }
     }

package/lib/util/is-wsl.js

@@ -22,7 +22,7 @@ const getIsWsl = async () => {
         const procVersion = await fs.promises.readFile('/proc/version', 'utf8')
 
         return procVersion.toLowerCase().includes('microsoft')
-    } catch (e) {
+    } catch {
         return false
     }
 }

package/lib/util/path-exists-sync.js

@@ -7,7 +7,7 @@ const fs = require('fs')
 const pathExistsSync = (path) => {
     try {
         fs.accessSync(path, fs.constants.F_OK)
-    } catch (e) {
+    } catch {
         return false
     }
 

package/lib/util/path-exists.js

@@ -8,7 +8,7 @@ const fs = require('fs')
 const pathExists = async (path) => {
     try {
         await fs.promises.access(path, fs.constants.F_OK)
-    } catch (e) {
+    } catch {
         return false
     }
 

package/lib/util/store-domains.js

@@ -0,0 +1,71 @@
+/**
+ * Enable nginx host → store mapping only when multiple stores use distinct domains.
+ * Duplicate hostnames produce invalid nginx map directives.
+ *
+ * @param {Record<string, string> | undefined} storeDomains
+ * @returns {boolean}
+ */
+const shouldUseStoreDomainMapping = (storeDomains) => {
+    if (!storeDomains) {
+        return false
+    }
+
+    const entries = Object.entries(storeDomains)
+
+    if (entries.length <= 1) {
+        return false
+    }
+
+    const domains = entries.map(([, domain]) => domain)
+
+    return new Set(domains).size === domains.length
+}
+
+/**
+ * Map store/website entities to domains from storeDomains, falling back to admin
+ * for scopes not explicitly configured (e.g. website "base" on single-domain setups).
+ *
+ * @param {Record<string, string>} storeDomains
+ * @param {{ code: string }[]} entities
+ * @param {'website_id' | 'store_id'} idField
+ * @returns {Record<string, { scopeId: number, domain: string }>}
+ */
+const resolveStoreDomainsForScopes = (storeDomains, entities, idField) => {
+    const defaultDomain = storeDomains.admin
+
+    /** @type {Record<string, { scopeId: number, domain: string }>} */
+    const mapped = Object.entries(storeDomains).reduce(
+        (acc, [key, val]) => {
+            const entity = entities.find((entity) => entity.code === key)
+
+            if (entity) {
+                return {
+                    ...acc,
+                    [entity.code]: {
+                        scopeId: entity[idField],
+                        domain: val
+                    }
+                }
+            }
+
+            return acc
+        },
+        {}
+    )
+
+    for (const entity of entities) {
+        if (!mapped[entity.code]) {
+            mapped[entity.code] = {
+                scopeId: entity[idField],
+                domain: defaultDomain
+            }
+        }
+    }
+
+    return mapped
+}
+
+module.exports = {
+    shouldUseStoreDomainMapping,
+    resolveStoreDomainsForScopes
+}

package/lib/util/store-domains.test.js

@@ -0,0 +1,52 @@
+const assert = require('assert')
+const {
+    shouldUseStoreDomainMapping,
+    resolveStoreDomainsForScopes
+} = require('./store-domains')
+
+assert.strictEqual(shouldUseStoreDomainMapping(undefined), false)
+assert.strictEqual(shouldUseStoreDomainMapping({ admin: 'localhost' }), false)
+assert.strictEqual(
+    shouldUseStoreDomainMapping({
+        admin: 'shop.local',
+        base: 'shop.local'
+    }),
+    false
+)
+assert.strictEqual(
+    shouldUseStoreDomainMapping({
+        admin: 'admin.local',
+        base: 'shop.local'
+    }),
+    true
+)
+
+const websites = [
+    { website_id: 0, code: 'admin' },
+    { website_id: 1, code: 'base' }
+]
+
+const resolved = resolveStoreDomainsForScopes(
+    { admin: 'jollyes.local' },
+    websites,
+    'website_id'
+)
+
+assert.deepStrictEqual(resolved, {
+    admin: { scopeId: 0, domain: 'jollyes.local' },
+    base: { scopeId: 1, domain: 'jollyes.local' }
+})
+
+assert.deepStrictEqual(
+    resolveStoreDomainsForScopes(
+        { admin: 'jollyes.local', base: 'other.local' },
+        websites,
+        'website_id'
+    ),
+    {
+        admin: { scopeId: 0, domain: 'jollyes.local' },
+        base: { scopeId: 1, domain: 'other.local' }
+    }
+)
+
+console.log('store-domains.test.js: ok')

package/lib/util/systemctl.js

@@ -66,7 +66,7 @@ const systemctlControl = (serviceName, defaultOptions = {}) => ({
                 ...options
             })
             return result.includes('enabled')
-        } catch (e) {
+        } catch {
             return false
         }
     },
@@ -81,7 +81,7 @@ const systemctlControl = (serviceName, defaultOptions = {}) => ({
             })
 
             return result.includes('active (running)')
-        } catch (e) {
+        } catch {
             return false
         }
     },
@@ -101,7 +101,7 @@ const systemctlControl = (serviceName, defaultOptions = {}) => ({
             const result = await execAsyncSpawn(command)
 
             return result === '1'
-        } catch (e) {
+        } catch {
             return false
         }
     }

package/package.json

@@ -3,7 +3,7 @@
     "description": "Scripts and configuration used by CMA.",
     "homepage": "https://docs.create-magento-app.com/",
     "repository": "github:scandipwa/create-magento-app",
-    "version": "2.4.12-alpha.0",
+    "version": "2.4.13",
     "main": "./index.js",
     "types": "./typings/index.d.ts",
     "license": "OSL-3.0",
@@ -59,5 +59,9 @@
         "@types/node": "^20.14.11",
         "@types/yargs": "^17.0.32"
     },
-    "gitHead": "0fe2409c4e619ff985cf90a7f3d6cc4d45ca2552"
+    "scripts": {
+        "lint": "oxlint",
+        "test:store-domains": "node lib/util/store-domains.test.js"
+    },
+    "gitHead": "a6d5ac78bf24f1ebd5b725248bb775e3e7c3d3ef"
 }

package/.eslintrc

@@ -1,10 +0,0 @@
-{
-    "globals": {
-        "verbose":true,
-        "NodeJS": true,
-        "BufferEncoding": true
-    },
-    "env": {
-        "node": true
-    }
-}

package/lib/util/ensure-agents-md.js

@@ -1,79 +0,0 @@
-const fs = require('fs')
-const path = require('path')
-
-const AGENTS_MD_CONTENT = `# CMA (magento-scripts) — AI/CI Reference
-
-> Auto-generated by magento-scripts. Do not delete.
-
-## Critical
-
-- **Cannot run as root** — exits immediately with code 1, no override.
-- **Non-TTY safe** — silent renderer activates automatically in CI/pipes; no \`-q\` needed.
-- **Do NOT use \`--\` with exec** — it gets passed as the command and fails. Correct: \`magento-scripts exec php bin/magento cache:flush\`
-- **\`cli\` is TTY-only** — use \`exec php bin/magento <cmd>\` in automation instead.
-- **\`import-db\` is self-contained** — it stops running containers, assigns ports, starts services, waits for MariaDB, and imports. Do NOT run \`start\` before or between \`import-db\` attempts — that creates port conflicts. Just run \`import-db\` directly.
-- **Do NOT run \`start\` then \`import-db\`** — each command manages its own container lifecycle. Running both creates split-brain port assignments. Use one or the other.
-- **Long-running commands** — \`start\` and \`import-db\` can take 10+ minutes (container setup, large dumps). Set timeouts to at least 600000ms (10 min) or run without a timeout.
-- **Shell escaping** — Avoid \`!\` in SQL strings passed via \`exec\` (e.g., \`!=\`), as the shell may interpret it. Use SQL alternatives like \`<>\` instead of \`!=\`.
-
-## Commands
-
-| Command | What it does | Key flags |
-|---------|-------------|-----------|
-| \`start\` | Start Docker environment | \`--no-open\`, \`--skip-setup\`, \`--port\` |
-| \`stop\` | Stop all containers | — |
-| \`status\` | Show container/DB status | — |
-| \`exec <container> [cmd...]\` | Run command in container | use \`--\` before flags |
-| \`import-db [file]\` | Import SQL dump into MariaDB | \`-y\` (non-interactive), \`--remote-db=ssh://user@host\` |
-| \`logs <container>\` | Stream container logs | \`--tail N\`, \`--follow\` |
-| \`cleanup\` | Remove cached/generated files | \`--force\` |
-| \`cli\` | Interactive shell (TTY only) | — |
-| \`link <path>\` | Link ScandiPWA theme | — |
-
-## Containers
-
-\`php\`, \`phpWithXdebug\`, \`nginx\`, \`sslTerminator\`, \`redis\`, \`mariadb\`, \`elasticsearch\`, \`maildev\`, \`varnish\` (if enabled)
-
-## Examples
-
-\`\`\`bash
-magento-scripts start --no-open --skip-setup
-magento-scripts import-db dump.sql -y
-magento-scripts import-db -y --remote-db=ssh://user@host
-magento-scripts exec php bin/magento cache:flush
-magento-scripts exec php bin/magento indexer:reindex
-
-# Query MariaDB (use mariadb binary, not mysql)
-magento-scripts exec mariadb mariadb -u magento -pmagento magento -e "SELECT COUNT(*) FROM store"
-magento-scripts logs magento --tail 100
-magento-scripts stop
-\`\`\`
-`
-
-/**
- * Write AGENTS.md and CLAUDE.md to the current working directory if they do not already exist.
- * This gives AI agents and CI pipelines a command reference for the project.
- */
-function ensureAgentsMd() {
-    const cwd = process.cwd()
-
-    const agentsDest = path.join(cwd, 'AGENTS.md')
-    if (!fs.existsSync(agentsDest)) {
-        try {
-            fs.writeFileSync(agentsDest, AGENTS_MD_CONTENT, 'utf8')
-        } catch (e) {
-            // Non-fatal — silently skip if the directory is not writable
-        }
-    }
-
-    const claudeDest = path.join(cwd, 'CLAUDE.md')
-    if (!fs.existsSync(claudeDest)) {
-        try {
-            fs.writeFileSync(claudeDest, '@AGENTS.md\n', 'utf8')
-        } catch (e) {
-            // Non-fatal
-        }
-    }
-}
-
-module.exports = ensureAgentsMd