esa-cli 0.0.2-beta.15 → 0.0.2-beta.18

package/dist/commands/routine/list.js

@@ -18,37 +18,55 @@ const list = {
     command: 'list',
     describe: `📋 ${t('list_describe').d('List all your routines')}`,
     builder: (yargs) => {
-        return yargs.usage(`${t('common_usage').d('Usage')}: \$0 list []`);
+        return yargs
+            .option('keyword', {
+            alias: 'k',
+            describe: t('deploy_option_keyword').d('Keyword to search for routines'),
+            type: 'string'
+        })
+            .usage(`${t('common_usage').d('Usage')}: \$0 list [--keyword <keyword>]`);
     },
     handler: (argv) => __awaiter(void 0, void 0, void 0, function* () {
         handleList(argv);
     })
 };
 export default list;
+export function getAllRoutines(options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const server = yield ApiService.getInstance();
+        const allRoutines = [];
+        let pageNumber = 1;
+        const pageSize = (options === null || options === void 0 ? void 0 : options.PageSize) || 50;
+        while (true) {
+            const res = yield server.listUserRoutines({
+                RegionId: options === null || options === void 0 ? void 0 : options.RegionId,
+                PageNumber: pageNumber,
+                PageSize: pageSize,
+                SearchKeyWord: options === null || options === void 0 ? void 0 : options.SearchKeyWord
+            });
+            if (!((_a = res === null || res === void 0 ? void 0 : res.body) === null || _a === void 0 ? void 0 : _a.Routines)) {
+                break;
+            }
+            allRoutines.push(...res.body.Routines);
+            const totalCount = res.body.TotalCount;
+            const currentCount = allRoutines.length;
+            if (currentCount >= totalCount) {
+                break;
+            }
+            pageNumber++;
+        }
+        return allRoutines;
+    });
+}
 export function handleList(argv) {
     return __awaiter(this, void 0, void 0, function* () {
-        var _a, _b;
-        const { site } = argv;
         const isSuccess = yield checkIsLoginSuccess();
         if (!isSuccess)
             return;
-        const server = yield ApiService.getInstance();
-        if (site) {
-            const req = {
-                SiteSearchType: 'fuzzy',
-                Status: 'active',
-                PageNumber: 1,
-                PageSize: 50
-            };
-            const res = yield server.listSites(req);
-            const siteList = (_a = res === null || res === void 0 ? void 0 : res.data.Sites) !== null && _a !== void 0 ? _a : [];
-            const siteNameList = siteList === null || siteList === void 0 ? void 0 : siteList.map((item) => item.SiteName);
-            logger.log(chalk.bold.bgGray(`📃 ${t('list_site_name_title').d('List all of site names')}:`));
-            logger.tree(siteNameList);
-            return;
-        }
-        const res = yield server.listUserRoutines();
-        const routineList = (_b = res === null || res === void 0 ? void 0 : res.body) === null || _b === void 0 ? void 0 : _b.Routines;
+        const routineList = yield getAllRoutines({
+            SearchKeyWord: argv.keyword
+        });
         if (routineList) {
             logger.log(chalk.bold.bgGray(`📃 ${t('list_routine_name_title').d('List all of routine')}:`));
             displayRoutineList(routineList);

package/dist/components/mutiLevelSelect.js

@@ -26,7 +26,8 @@ export default function multiLevelSelect(items_1) {
                 options: [
                     ...currentItems.map((item) => ({
                         label: item.label,
-                        value: item.value
+                        value: item.value,
+                        hint: item.hint
                     })),
                     ...(stack.length > 0 ? [{ label: 'Back', value: '__back__' }] : [])
                 ]

package/dist/components/routeBuilder.js

@@ -0,0 +1,68 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { Box, render, Text } from 'ink';
+import TextInput from 'ink-text-input';
+import React, { useState } from 'react';
+import t from '../i18n/index.js';
+export const RouteBuilder = ({ siteName, onSubmit, onCancel }) => {
+    const [prefix, setPrefix] = useState('');
+    const [suffix, setSuffix] = useState('');
+    const [currentInput, setCurrentInput] = useState('prefix');
+    const [error, setError] = useState('');
+    const handleSubmit = () => {
+        if (currentInput === 'prefix') {
+            setCurrentInput('suffix');
+            return;
+        }
+        // Build complete route, add dot before prefix and slash before suffix if not empty
+        const prefixWithDot = prefix ? `${prefix}.` : '';
+        const suffixWithDot = suffix ? `/${suffix}` : '';
+        const route = `${prefixWithDot}${siteName}${suffixWithDot}`;
+        onSubmit(route);
+    };
+    const handleCancel = () => {
+        onCancel();
+    };
+    const currentPrompt = currentInput === 'prefix'
+        ? t('route_builder_prefix_prompt')
+            .d(`Enter route prefix for ${siteName} (e.g., abc, def):`)
+            .replace('${siteName}', siteName)
+        : t('route_builder_suffix_prompt')
+            .d(`Enter route suffix for ${siteName} (e.g., *, users/*):`)
+            .replace('${siteName}', siteName);
+    const prefixWithDot = prefix ? `${prefix}.` : '';
+    const suffixWithDot = suffix ? `/${suffix}` : '';
+    const preview = `Preview: ${prefixWithDot}${siteName}${suffixWithDot}`;
+    return (React.createElement(Box, { flexDirection: "column" },
+        React.createElement(Box, null,
+            React.createElement(Text, null, "Building route for site: "),
+            React.createElement(Text, { color: "cyan" }, siteName)),
+        React.createElement(Box, { marginTop: 1 },
+            React.createElement(Text, null, currentPrompt)),
+        React.createElement(Box, { marginTop: 1 },
+            React.createElement(TextInput, { value: currentInput === 'prefix' ? prefix : suffix, onChange: currentInput === 'prefix' ? setPrefix : setSuffix, onSubmit: handleSubmit })),
+        preview && (React.createElement(Box, { marginTop: 1 },
+            React.createElement(Text, { color: "green" }, preview))),
+        React.createElement(Box, { marginTop: 1 },
+            React.createElement(Text, { color: "gray" }, t('route_builder_instructions').d('Press Enter to continue, Ctrl+C to cancel'))),
+        error && (React.createElement(Box, { marginTop: 1 },
+            React.createElement(Text, { color: "red" }, error)))));
+};
+export const routeBuilder = (siteName) => __awaiter(void 0, void 0, void 0, function* () {
+    return new Promise((resolve) => {
+        const { unmount } = render(React.createElement(RouteBuilder, { siteName: siteName, onSubmit: (route) => {
+                unmount();
+                resolve(route);
+            }, onCancel: () => {
+                unmount();
+                resolve(null);
+            } }));
+    });
+});

package/dist/docs/Commands_en.md

@@ -72,7 +72,7 @@ esa deploy [entry]
   - -v, --version string: Version to deploy (skip interactive selection)
   - -e, --environment string: Environment to deploy to. Choices: staging | production
   - -n, --name string: Name of the routine
-  - -a, --assets boolean: Deploy assets
+  - -a, --assets string: Assets directory (e.g., ./dist)
   - -d, --description string: Description of the version
   - -m, --minify boolean: Minify the code
 
@@ -153,6 +153,39 @@ esa route delete <routeName>
   - list: List all related routes
   - delete <routeName>: Delete a related route
 
+#### esa route add
+
+Bind a route to the current routine.
+
+```bash
+esa route add [route] [site] [--alias <routeName>] [--route <route>] [--site <site>]
+```
+
+- Positionals (optional):
+  - route: The route value, e.g. example.com/_ or _.example.com/\*
+  - site: The site name, e.g. example.com
+
+- Options:
+  - -r, --route string: Route value, e.g. example.com/\*
+    - Host supports leading `*` for suffix match (e.g., `*.example.com`)
+    - Path supports trailing `*` for prefix match (e.g., `/api/*`)
+  - -s, --site string: Site name (must be an active site)
+  - -a, --alias string: Route name (alias)
+
+- Interactive behavior:
+  - If `--alias` is missing, you will be prompted to input a route name
+  - If `--site` is missing, you will be prompted to choose from active sites
+  - If `--route` is missing, you will be prompted to input the route value
+
+- Route matching notes:
+  - Host supports `*` prefix: `*.example.com` matches any host ending with `.example.com`
+  - Path supports `*` suffix: `/api/*` matches any path starting with `/api/`
+  - Examples: `example.com/*`, `*.example.com/`, `*.example.com/api/*`
+
+- Examples:
+  - `esa route add -a home -s example.com -r example.com/*`
+  - `esa route add example.com/* example.com -a home`
+
 ---
 
 ### esa login

package/dist/docs/Commands_zh_CN.md

@@ -15,7 +15,7 @@ esa init [name]
   - -f, --framework string：选择前端框架（react/vue/nextjs...）
   - -l, --language string：选择语言（typescript/javascript）。可选：typescript | javascript
   - -t, --template string：指定模板名称
-  - -y, --yes boolean：对所有交互询问选择“是”（默认 false）
+  - -y, --yes boolean：对所有交互询问选择“是”（默认 false），模版采用helloworld
   - --git boolean：在项目中初始化 git
   - --deploy boolean：初始化完成后自动部署
 
@@ -65,14 +65,12 @@ esa commit [entry]
 esa deploy [entry]
 ```
 
-- 位置参数：
-  - entry：（可选的）边缘函数入口文件
-
 - 选项：
+  - entry 可选参数，默认以`esa.jsonc`中entry配置为准
   - -v, --version string：指定要部署的版本（跳过交互选择）
   - -e, --environment string：部署环境。可选：staging | production
   - -n, --name string：边缘函数名称
-  - -a, --assets boolean：是否部署静态资源
+  - -a, --assets string：静态资源目录（例如：./dist）
   - -d, --description string：版本描述
   - -m, --minify boolean：是否压缩代码
 
@@ -117,7 +115,7 @@ esa site list
 ```
 
 - 子命令：
-  - list：列出账户下所有已激活站点
+  - list：列出所有已激活站点
 
 ---
 
@@ -153,6 +151,39 @@ esa route delete <routeName>
   - list：查看所有已绑定路由
   - delete `<routeName>`：删除已绑定路由
 
+#### esa route add
+
+为当前边缘函数绑定一个路由。
+
+```bash
+esa route add [route] [site] [--alias <routeName>] [--route <route>] [--site <site>]
+```
+
+- 位置参数（可选）：
+  - route：路由值，例如：example.com/_ 或 _.example.com/\*
+  - site：站点名称，例如：example.com
+
+- 选项：
+  - -r, --route string：路由值，例如：example.com/\*
+    - 主机名支持以 `*` 开头表示后缀匹配（如：`*.example.com`）
+    - 路径支持以 `*` 结尾表示前缀匹配（如：`/api/*`）
+  - -s, --site string：站点名称（需为已激活站点）
+  - -a, --alias string：路由名称（别名）
+
+- 交互提示：
+  - 未提供 `--alias` 时，会提示输入路由名称
+  - 未提供 `--site` 时，会列出账号下已激活站点供选择
+  - 未提供 `--route` 时，会提示输入路由值
+
+- 路由匹配说明：
+  - host 支持前缀 `*`：`*.example.com` 表示匹配所有以 `.example.com` 结尾的域名
+  - path 支持后缀 `*`：`/api/*` 表示匹配以 `/api/` 开头的路径
+  - 示例：`example.com/*`、`*.example.com/`、`*.example.com/api/*`
+
+- 示例：
+  - `esa route add -a home -s example.com -r example.com/*`
+  - `esa route add example.com/* example.com -a home`
+
 ---
 
 ### esa login
@@ -166,6 +197,9 @@ esa login
 - 选项：
   - --access-key-id, --ak string：AccessKey ID (AK)
   - --access-key-secret, --sk string：AccessKey Secret (SK)
+- 从环境变量中读取process.env
+  - ESA_ACCESS_KEY_ID
+  - ESA_ACCESS_KEY_SECRET
 
 ---
 

package/dist/i18n/locales.json

@@ -1234,5 +1234,77 @@
   "step": {
     "en": "Step:",
     "zh_CN": ""
+  },
+  "version_title_update_available": {
+    "en": "ESA CLI Update Available",
+    "zh_CN": "ESA CLI 有新版本可用"
+  },
+  "version_current": {
+    "en": "Current",
+    "zh_CN": "当前版本"
+  },
+  "version_latest": {
+    "en": "Latest",
+    "zh_CN": "最新版本"
+  },
+  "version_note": {
+    "en": "Note",
+    "zh_CN": "提示"
+  },
+  "version_note_incompatible": {
+    "en": "This version may have incompatibilities, please upgrade soon.",
+    "zh_CN": "当前版本可能存在不兼容，建议尽快升级至最新版本。"
+  },
+  "version_update": {
+    "en": "Update",
+    "zh_CN": "升级"
+  },
+  "version_continue": {
+    "en": "You can continue using the current version; commands will proceed.",
+    "zh_CN": "你可以继续使用当前版本；命令将继续执行。"
+  },
+  "version_prompt_update_now": {
+    "en": "Update now to the latest version?",
+    "zh_CN": "是否立即更新到最新版本？"
+  },
+  "version_update_failed": {
+    "en": "Global update failed. You may need elevated permissions (sudo) or use yarn/pnpm:",
+    "zh_CN": "全局更新失败。你可能需要更高权限（sudo）或使用 yarn/pnpm："
+  },
+  "deploy_option_keyword": {
+    "en": "Keyword to search for routines",
+    "zh_CN": ""
+  },
+  "route_input_method": {
+    "en": "How would you like to input the route?",
+    "zh_CN": "您希望如何输入路由？"
+  },
+  "route_input_builder": {
+    "en": "Use route builder (prefix + suffix)",
+    "zh_CN": "使用路由构建器（前缀 + 后缀）"
+  },
+  "route_input_manual": {
+    "en": "Enter route manually",
+    "zh_CN": "手动输入路由"
+  },
+  "route_build_cancelled": {
+    "en": "Route building cancelled",
+    "zh_CN": "路由构建已取消"
+  },
+  "route_builder_prefix_prompt": {
+    "en": "Enter route prefix for ${siteName} (e.g., api, v1):",
+    "zh_CN": "为 ${siteName} 输入路由前缀（例如：api, v1）："
+  },
+  "route_builder_suffix_prompt": {
+    "en": "Enter route suffix for ${siteName} (e.g., *, users/*):",
+    "zh_CN": "为 ${siteName} 输入路由后缀（例如：*, users/*）："
+  },
+  "route_builder_preview": {
+    "en": "Preview: ${siteName}${prefix}${suffix}",
+    "zh_CN": "预览：{route}"
+  },
+  "route_builder_instructions": {
+    "en": "Press Enter to continue, Ctrl+C to cancel",
+    "zh_CN": "按回车键继续，Ctrl+C 取消"
   }
 }

package/dist/index.js

@@ -24,7 +24,7 @@ import routeCommand from './commands/route/index.js';
 import routine from './commands/routine/index.js';
 import site from './commands/site/index.js';
 import t from './i18n/index.js';
-import { handleCheckVersion } from './utils/checkVersion.js';
+import { handleCheckVersion, checkCLIVersion } from './utils/checkVersion.js';
 import { getCliConfig } from './utils/fileUtils/index.js';
 const main = () => __awaiter(void 0, void 0, void 0, function* () {
     const argv = hideBin(process.argv);
@@ -39,6 +39,16 @@ const main = () => __awaiter(void 0, void 0, void 0, function* () {
         .version(false)
         .wrap(null)
         .help()
+        .middleware((argv) => __awaiter(void 0, void 0, void 0, function* () {
+        try {
+            // Pass current command (first positional) so version check can decide prompting behavior
+            yield checkCLIVersion((argv._ && argv._[0] ? String(argv._[0]) : ''));
+        }
+        catch (e) {
+            console.log(e);
+            console.log('error');
+        }
+    }))
         .epilogue(`${t('main_epilogue').d('For more information, visit ESA')}: ${chalk.underline.blue('https://www.aliyun.com/product/esa')}`)
         .options('version', {
         describe: t('main_version_describe').d('Show version'),

package/dist/libs/apiService.js

@@ -219,7 +219,7 @@ export class ApiService {
             return null;
         });
     }
-    listUserRoutines() {
+    listUserRoutines(requestParams) {
         return __awaiter(this, void 0, void 0, function* () {
             try {
                 let params = {
@@ -236,7 +236,9 @@ export class ApiService {
                         return this;
                     }
                 };
-                let request = new $OpenApi.OpenApiRequest();
+                let request = new $OpenApi.OpenApiRequest({
+                    query: requestParams || {}
+                });
                 let runtime = {
                     toMap: function () {
                         return this;

package/dist/libs/logger.js

@@ -175,8 +175,47 @@ class Logger {
         console.log(message);
     }
     notInProject() {
-        const initCommand = chalk.green('esa init');
-        this.error(t('common_not_edge_project', { initCommand }).d(`You are not in an esa project, Please run ${initCommand} to initialize a project, or enter an esa project.`));
+        this.block();
+        this.error('Missing ESA project configuration (esa.jsonc or esa.toml)');
+        this.block();
+        this.log('If there is code to deploy, you can either:');
+        this.subLog(`- Specify an entry-point to your Routine via the command line (ex: ${chalk.green('esa deploy src/index.ts')})`);
+        this.subLog('- Or add the following to your "esa.jsonc" file:');
+        console.log('```jsonc\n' +
+            '{\n' +
+            '  "name": "my-routine",\n' +
+            '  "entry": "src/index.ts",\n' +
+            '  "dev": { "port": 18080 }\n' +
+            '}\n' +
+            '```');
+        this.subLog('- Or, if you prefer TOML, add to your "esa.toml":');
+        console.log('```toml\n' +
+            'name = "my-routine"\n' +
+            'entry = "src/index.ts"\n' +
+            '\n' +
+            '[dev]\n' +
+            'port = 18080\n' +
+            '```\n');
+        this.log('If you are deploying a directory of static assets, you can either:');
+        this.subLog(`- Add the assets directory to your "esa.jsonc" and run ${chalk.green('esa deploy -a ./dist')}`);
+        console.log('```jsonc\n' +
+            '{\n' +
+            '  "name": "my-routine",\n' +
+            '  "assets": {\n' +
+            '    "directory": "./dist"\n' +
+            '  }\n' +
+            '}\n' +
+            '```');
+        this.subLog(`- Or add to your "esa.toml" and run ${chalk.green('esa deploy -a ./dist')}`);
+        console.log('```toml\n' +
+            'name = "my-routine"\n' +
+            '\n' +
+            '[assets]\n' +
+            'directory = "./dist"\n' +
+            '```\n');
+        this.log('Alternatively, initialize a new ESA project:');
+        this.log(chalk.green('$ esa init my-routine'));
+        this.block();
     }
     pathEacces(localPath) {
         this.block();

package/dist/utils/checkIsRoutineCreated.js

@@ -8,11 +8,11 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import { exit } from 'process';
+import { log } from '@clack/prompts';
 import chalk from 'chalk';
 import t from '../i18n/index.js';
 import { ApiService } from '../libs/apiService.js';
 import logger from '../libs/logger.js';
-import { log } from '@clack/prompts';
 export function isRoutineExist(name) {
     return __awaiter(this, void 0, void 0, function* () {
         const server = yield ApiService.getInstance();
@@ -48,17 +48,10 @@ export function ensureRoutineExists(name) {
             });
             const isSuccess = (createRes === null || createRes === void 0 ? void 0 : createRes.data.Status) === 'OK';
             if (isSuccess) {
-                // logger.endSubStep(
-                //   t('routine_create_success').d('Routine created successfully.')
-                // );
                 logger.endSubStep('Routine created successfully');
-                // tlog.success(
-                //   t('routine_create_success').d('Routine created successfully.')
-                // );
             }
             else {
                 logger.endSubStep('Routine created failed');
-                // tlog.error(t('routine_create_fail').d('Routine created failed.'));
                 exit();
             }
         }

package/dist/utils/checkVersion.js

@@ -9,6 +9,12 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 import { promises as fs } from 'fs';
 import path from 'path';
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import fetch from 'node-fetch';
+import t from '../i18n/index.js';
+import logger from '../libs/logger.js';
+import execCommand from '../utils/command.js';
 import { getDirName } from '../utils/fileUtils/base.js';
 export function handleCheckVersion() {
     return __awaiter(this, void 0, void 0, function* () {
@@ -24,3 +30,115 @@ export function handleCheckVersion() {
         }
     });
 }
+/**
+ * 检查CLI是否为最新版本，如果不是则提示用户更新
+ * @returns 是否为最新版本
+ */
+export function checkCLIVersion(currentCommand) {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            const __dirname = getDirName(import.meta.url);
+            const packageJsonPath = path.join(__dirname, '..', '..', 'package.json');
+            const jsonString = yield fs.readFile(packageJsonPath, 'utf-8');
+            const packageJson = JSON.parse(jsonString);
+            const currentVersion = packageJson.version;
+            const response = yield fetch('https://registry.npmjs.org/esa-cli/latest');
+            if (!response.ok) {
+                return true;
+            }
+            const data = (yield response.json());
+            const latestVersion = data.version;
+            if (currentVersion !== latestVersion) {
+                const accent = chalk.hex('#7C3AED').bold;
+                const labelColor = chalk.hex('#22c55e');
+                const currentLabelRaw = t('version_current').d('Current');
+                const latestLabelRaw = t('version_latest').d('Latest');
+                const noteLabelRaw = t('version_note').d('Note');
+                const updateLabelRaw = t('version_update').d('Update');
+                const labelsRaw = [
+                    currentLabelRaw,
+                    latestLabelRaw,
+                    noteLabelRaw,
+                    updateLabelRaw
+                ];
+                const labelWidth = Math.max(...labelsRaw.map((l) => l.length));
+                const gap = '  ';
+                const padLabel = (raw, colored) => `${colored}${' '.repeat(labelWidth - raw.length)}`;
+                const lines = [
+                    `${accent('🚀  ' + t('version_title_update_available').d('ESA CLI Update Available'))}`,
+                    '',
+                    `${padLabel(currentLabelRaw, labelColor(currentLabelRaw))}${gap}${chalk.yellowBright('v' + currentVersion)}`,
+                    `${padLabel(latestLabelRaw, labelColor(latestLabelRaw))}${gap}${chalk.greenBright('v' + latestVersion)}`,
+                    '',
+                    `${padLabel(noteLabelRaw, chalk.yellowBright.bold(noteLabelRaw))}${gap}${chalk.yellowBright(t('version_note_incompatible').d('This version may have incompatibilities, please upgrade soon.'))}`,
+                    '',
+                    `${padLabel(updateLabelRaw, labelColor(updateLabelRaw))}${gap}${chalk.cyanBright('npm i -g esa-cli@latest')}`,
+                    `${' '.repeat(labelWidth)}${gap}${chalk.cyanBright('yarn global add esa-cli@latest')}`,
+                    `${' '.repeat(labelWidth)}${gap}${chalk.cyanBright('pnpm add -g esa-cli@latest')}`,
+                    '',
+                    `${chalk.gray(t('version_continue').d('You can continue using the current version; commands will proceed.'))}`
+                ];
+                // Render with deploy-success-style box (cyan double border)
+                const stripAnsi = (s) => s.replace(/\x1B\[[0-?]*[ -\/]*[@-~]/g, '');
+                const contentWidth = Math.max(...lines.map((l) => stripAnsi(l).length));
+                const borderColor = chalk.hex('#00D4FF').bold;
+                const top = `${borderColor('╔')}${borderColor('═'.repeat(contentWidth + 2))}${borderColor('╗')}`;
+                const bottom = `${borderColor('╚')}${borderColor('═'.repeat(contentWidth + 2))}${borderColor('╝')}`;
+                const box = [
+                    top,
+                    ...lines.map((l) => {
+                        const pad = ' '.repeat(contentWidth - stripAnsi(l).length);
+                        const left = borderColor('║');
+                        const right = borderColor('║');
+                        return `${left} ${l}${pad} ${right}`;
+                    }),
+                    bottom
+                ];
+                logger.block();
+                box.forEach((l) => logger.log(l));
+                logger.block();
+                // Only prompt interactively on init command; others just display notice
+                if (currentCommand === 'init') {
+                    const { updateNow } = yield inquirer.prompt([
+                        {
+                            type: 'confirm',
+                            name: 'updateNow',
+                            message: chalk.bold(t('version_prompt_update_now').d('Update now to the latest version?')),
+                            default: true
+                        }
+                    ]);
+                    if (updateNow) {
+                        const startText = 'Updating ESA CLI to latest (npm i -g esa-cli@latest)';
+                        const doneText = 'ESA CLI update finished';
+                        try {
+                            const res = yield execCommand(['npm', 'i', '-g', 'esa-cli@latest'], {
+                                startText,
+                                doneText,
+                                useSpinner: true,
+                                interactive: false
+                            });
+                            if (!res.success) {
+                                logger.warn(t('version_update_failed').d('Global update failed. You may need elevated permissions (sudo) or use yarn/pnpm:'));
+                                logger.subLog('sudo npm i -g esa-cli@latest');
+                                logger.subLog('yarn global add esa-cli@latest');
+                                logger.subLog('pnpm add -g esa-cli@latest');
+                            }
+                        }
+                        catch (e) {
+                            logger.warn(t('version_update_failed').d('Global update failed. You may need elevated permissions (sudo) or use yarn/pnpm:'));
+                            logger.subLog('sudo npm i -g esa-cli@latest');
+                            logger.subLog('yarn global add esa-cli@latest');
+                            logger.subLog('pnpm add -g esa-cli@latest');
+                        }
+                        logger.divider();
+                    }
+                }
+                return false;
+            }
+            return true;
+        }
+        catch (error) {
+            return true;
+        }
+    });
+}