@cvtoolman/huawei-lts-cli 1.0.2 → 2.0.0

package/dist/cli/commands/fields.js

@@ -0,0 +1,108 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createFieldsCommand = createFieldsCommand;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const cli_table3_1 = __importDefault(require("cli-table3"));
+const client_1 = require("../../lts/client");
+const common_1 = require("./common");
+/**
+ * 输出日志流的索引配置。
+ *
+ * 存在的理由：字段名、字段类型、大小写是否敏感、分词符，全都是**每条日志流各自一份**
+ * 的配置（SDK 里是 LTSFullTextIndexInfo / LTSFieldsInfo）。任何写进文档的字段表都只对
+ * 某一条流成立，换个环境就是错的。所以答案必须在运行时从 API 取。
+ */
+function boolLabel(value) {
+    if (value === undefined)
+        return '-';
+    return value ? 'yes' : 'no';
+}
+function formatJson(index) {
+    return JSON.stringify(index, null, 2);
+}
+function formatTable(index) {
+    const lines = [];
+    const summary = new cli_table3_1.default({ head: ['Full-text index', 'Value'] });
+    summary.push(['enabled', boolLabel(index.fullText.enabled)], ['caseSensitive', boolLabel(index.fullText.caseSensitive)], ['includeChinese', boolLabel(index.fullText.includeChinese)], ['tokenizer', index.fullText.tokenizer || '-']);
+    lines.push(summary.toString());
+    if (index.fields.length === 0) {
+        lines.push('');
+        lines.push('No field index configured — only full-text search is available on this stream.');
+        return lines.join('\n');
+    }
+    lines.push('');
+    const fields = new cli_table3_1.default({
+        head: ['Field', 'Type', 'Case-sensitive', 'Chinese', 'Tokenizer', 'Quick analysis'],
+    });
+    for (const f of index.fields) {
+        fields.push([
+            f.name,
+            f.type || '-',
+            boolLabel(f.caseSensitive),
+            boolLabel(f.includeChinese),
+            f.tokenizer || '-',
+            boolLabel(f.quickAnalysis),
+        ]);
+    }
+    lines.push(fields.toString());
+    return lines.join('\n');
+}
+function formatPretty(index) {
+    const lines = [];
+    lines.push(chalk_1.default.bold(`Stream ${index.streamId}`));
+    lines.push('');
+    lines.push(chalk_1.default.bold('Full-text index'));
+    lines.push(`  enabled:        ${boolLabel(index.fullText.enabled)}`);
+    lines.push(`  caseSensitive:  ${boolLabel(index.fullText.caseSensitive)}`);
+    lines.push(`  includeChinese: ${boolLabel(index.fullText.includeChinese)}`);
+    lines.push(`  tokenizer:      ${index.fullText.tokenizer || '-'}`);
+    lines.push('');
+    if (index.fields.length === 0) {
+        lines.push(chalk_1.default.yellow('No field index configured — only full-text search is available.'));
+        return lines.join('\n');
+    }
+    lines.push(chalk_1.default.bold(`Fields (${index.fields.length})`));
+    for (const f of index.fields) {
+        const flags = [
+            f.caseSensitive ? 'case-sensitive' : 'case-insensitive',
+            f.includeChinese ? 'chinese' : 'no-chinese',
+            f.quickAnalysis ? 'quick-analysis' : null,
+        ].filter(Boolean);
+        lines.push(`  ${chalk_1.default.cyan(f.name)}  ${chalk_1.default.gray(f.type || '-')}  ${chalk_1.default.gray(flags.join(', '))}`);
+        if (f.tokenizer) {
+            lines.push(chalk_1.default.gray(`    tokenizer: ${f.tokenizer}`));
+        }
+    }
+    return lines.join('\n');
+}
+function createFieldsCommand() {
+    const cmd = new commander_1.Command('fields');
+    cmd
+        .description('Show the index config of a log stream (fields, types, case sensitivity, tokenizer)')
+        .option('-g, --group-id <groupId>', 'Log group ID (can also be set via config)')
+        .option('-s, --stream-id <streamId>', 'Log stream ID (can also be set via config)')
+        .option('-f, --format <format>', 'Output format: json, table, pretty', 'pretty')
+        .action(async (options) => {
+        const config = (0, common_1.loadCheckedConfig)();
+        const { groupId, streamId } = (0, common_1.resolveGroupStream)(options, config);
+        const format = (0, common_1.resolveFormat)(options.format);
+        const client = new client_1.LTSClient(config);
+        try {
+            const index = await client.getStreamIndex(groupId, streamId);
+            const output = format === 'json'
+                ? formatJson(index)
+                : format === 'table'
+                    ? formatTable(index)
+                    : formatPretty(index);
+            console.log(output);
+        }
+        catch (error) {
+            (0, common_1.handleCommandError)(error);
+        }
+    });
+    return cmd;
+}

package/dist/cli/commands/init.js

@@ -37,11 +37,23 @@ exports.createInitCommand = createInitCommand;
 const commander_1 = require("commander");
 const readline = __importStar(require("readline"));
 const config_1 = require("../../config");
+const profile_1 = require("../../config/profile");
 function ask(rl, question) {
     return new Promise((resolve) => {
         rl.question(question, (answer) => resolve(answer.trim()));
     });
 }
+/** 写 profile.md 骨架并告知路径。已存在则绝不覆盖——那是用户手写的内容。 */
+function reportProfileSkeleton() {
+    const { path, created } = (0, profile_1.writeProfileSkeleton)();
+    if (created) {
+        console.log(`  profile.md = ${path} (skeleton created)`);
+        console.log('              业务词表：把「订单服务」这类称呼映射到日志里的实际取值');
+    }
+    else {
+        console.log(`  profile.md = ${path} (existing, left untouched)`);
+    }
+}
 const ENDPOINT_MAP = {
     'cn-north-1': 'lts.cn-north-1.myhuaweicloud.com',
     'cn-north-2': 'lts.cn-north-2.myhuaweicloud.com',
@@ -67,7 +79,13 @@ const ENDPOINT_MAP = {
 function createInitCommand() {
     const cmd = new commander_1.Command('init');
     cmd.description('Interactive setup wizard — configure credentials step by step')
-        .action(async () => {
+        .option('--from-url <url>', 'Import region/groupId/streamId from an LTS console URL (non-interactive)')
+        .action(async (options) => {
+        // 从控制台 URL 导入：解析 region、groupId、topicId（即 streamId），无需交互
+        if (options.fromUrl) {
+            importFromConsoleUrl(options.fromUrl);
+            return;
+        }
         const rl = readline.createInterface({
             input: process.stdin,
             output: process.stdout,
@@ -138,13 +156,17 @@ function createInitCommand() {
             }
             console.log('');
             console.log('✅ Configuration saved!');
+            reportProfileSkeleton();
             console.log('');
             console.log('Try it out:');
             if (groupId && streamId) {
-                console.log('  lts-cli query --start-time 2024-01-01T00:00:00Z --end-time 2024-01-02T00:00:00Z');
+                console.log('  lts-cli query --last 2h');
+                console.log('  lts-cli fields');
             }
             else {
-                console.log('  lts-cli query -g <group-id> -s <stream-id> --start-time 2024-01-01T00:00:00Z --end-time 2024-01-02T00:00:00Z');
+                console.log('  lts-cli groups                       # find your log group ID');
+                console.log('  lts-cli streams --group <group-name> # find your log stream ID');
+                console.log('  lts-cli query -g <groupId> -s <streamId> --last 2h');
             }
             console.log('');
         }
@@ -154,3 +176,54 @@ function createInitCommand() {
     });
     return cmd;
 }
+/** 从华为云 LTS 控制台 URL 中解析 region / groupId / streamId 并写入配置 */
+function importFromConsoleUrl(raw) {
+    let url;
+    try {
+        url = new URL(raw);
+    }
+    catch {
+        console.error('Error: Invalid URL. Please paste the full console URL, e.g.:');
+        console.error('  https://console.huaweicloud.com/lts/?region=cn-south-1#/cts/logEventsLeftMenu/events?groupId=...&topicId=...');
+        process.exit(1);
+    }
+    const region = url.searchParams.get('region') || undefined;
+    // groupId / topicId 位于 hash 段的查询参数中：#/cts/logEventsLeftMenu/events?groupId=...&topicId=...
+    const hash = url.hash || '';
+    const qIndex = hash.indexOf('?');
+    const hashParams = new URLSearchParams(qIndex >= 0 ? hash.slice(qIndex + 1) : '');
+    const groupId = hashParams.get('groupId') || url.searchParams.get('groupId') || undefined;
+    const streamId = hashParams.get('topicId') || hashParams.get('streamId') || url.searchParams.get('topicId') || undefined;
+    if (!region && !groupId && !streamId) {
+        console.error('Error: No region/groupId/topicId found in the URL. Make sure it is an LTS log search page URL.');
+        process.exit(1);
+    }
+    console.log('');
+    console.log('Importing from console URL:');
+    if (region) {
+        (0, config_1.setConfig)('region', region);
+        console.log(`  region   = ${region}`);
+        const autoEndpoint = ENDPOINT_MAP[region];
+        if (autoEndpoint) {
+            (0, config_1.setConfig)('endpoint', `https://${autoEndpoint}`);
+            console.log(`  endpoint = https://${autoEndpoint} (derived from region)`);
+        }
+    }
+    if (groupId) {
+        (0, config_1.setConfig)('groupId', groupId);
+        console.log(`  groupId  = ${groupId}`);
+    }
+    if (streamId) {
+        (0, config_1.setConfig)('streamId', streamId);
+        console.log(`  streamId = ${streamId}`);
+    }
+    console.log('');
+    console.log('✅ Configuration saved!');
+    reportProfileSkeleton();
+    console.log('');
+    console.log('Next steps:');
+    console.log('  1. Configure credentials if not done yet: lts-cli init');
+    console.log('  2. Check which fields this stream indexes: lts-cli fields');
+    console.log('  3. Query logs: lts-cli query --last 2h');
+    console.log('');
+}

package/dist/cli/commands/query.js

@@ -3,129 +3,74 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createQueryCommand = createQueryCommand;
 const commander_1 = require("commander");
 const client_1 = require("../../lts/client");
-const config_1 = require("../../config");
+const pagination_1 = require("../../lts/pagination");
 const output_1 = require("../../output");
+const common_1 = require("./common");
+// commander 的处理函数会收到 (value, previous)，直接传 parseInt 会把 previous 当作进制
+function parseIntOption(value) {
+    return parseInt(value, 10);
+}
 function createQueryCommand() {
     const cmd = new commander_1.Command('query');
     cmd.description('Query LTS logs')
         .option('-g, --group-id <groupId>', 'Log group ID (can also be set via config)')
         .option('-s, --stream-id <streamId>', 'Log stream ID (can also be set via config)')
-        .requiredOption('--start-time <startTime>', 'Start time (ISO 8601, e.g. 2024-01-01T00:00:00Z)')
-        .requiredOption('--end-time <endTime>', 'End time (ISO 8601, e.g. 2024-01-02T00:00:00Z)')
+        .option('--start-time <startTime>', 'Start time (ISO 8601, e.g. 2024-01-01T00:00:00Z)')
+        .option('--end-time <endTime>', 'End time (ISO 8601, e.g. 2024-01-02T00:00:00Z)')
         .option('--st <startTime>', 'Alias for --start-time')
         .option('--et <endTime>', 'Alias for --end-time')
-        .option('-k, --keyword <keyword>', 'Simple keyword search (legacy, use --query for advanced queries)')
-        .option('-q, --query <query>', 'Advanced query expression. Supports:\n' +
+        .option('--last <duration>', 'Relative time range: 30m, 2h, 1d, 7d (mutually exclusive with --st/--et)')
+        .option('-q, --query <query>', 'Query expression. Supports:\n' +
         '  - Field queries: content:error AND appName:myapp\n' +
         '  - Comparison: time>60 AND region:r\n' +
-        '  - SQL syntax: SELECT * FROM log WHERE content LIKE \'%error%\'\n' +
+        '  - Pipeline analysis: error | SELECT count(*) AS c\n' +
         '  - Logical operators: AND, OR, NOT (must be surrounded by spaces)')
-        .option('-l, --limit <limit>', 'Limit number of results', parseInt, 100)
-        .option('-o, --offset <offset>', 'Offset for pagination', parseInt, 0)
+        .option('--app <appName>', 'Filter by appName field, merged with -q via AND')
+        .option('--content <keyword>', 'Filter by log content (content:<keyword>), merged with -q via AND')
+        .option('--request-id <id>', 'Filter by REQUEST_ID field; output in chronological order')
+        .option('-l, --limit <limit>', 'Page size (also the cap for --all)', parseIntOption, 100)
         .option('-r, --reverse', 'Reverse order (newest first)')
         .option('-f, --format <format>', 'Output format: json, table, pretty', 'pretty')
-        .option('--no-paginate', 'Disable auto-pagination (single page only)')
+        .option('--all', 'Follow the cursor to the end (up to 10000 logs; default is a single page)')
         .action(async (options) => {
-        const config = (0, config_1.loadConfig)();
-        // Validate required credentials
-        if (!config.ak || !config.sk || !config.projectId) {
-            console.error('Error: Missing required credentials. Please configure them first:');
-            console.error('');
-            console.error('  Quick setup (recommended):');
-            console.error('    lts-cli init');
-            console.error('');
-            console.error('  Or set individually:');
-            console.error('    lts-cli config --set ak=<your-access-key>');
-            console.error('    lts-cli config --set sk=<your-secret-key>');
-            console.error('    lts-cli config --set projectId=<your-project-id>');
-            process.exit(1);
-        }
-        // groupId & streamId: CLI args take priority over config
-        const groupId = options.groupId || config.groupId;
-        const streamId = options.streamId || config.streamId;
-        if (!groupId || !streamId) {
-            console.error('Error: groupId and streamId are required. Provide them via:');
-            console.error('  lts-cli config --set groupId=<your-group-id>');
-            console.error('  lts-cli config --set streamId=<your-stream-id>');
-            console.error('  or use -g <groupId> -s <streamId> flags');
-            process.exit(1);
-        }
-        // --st / --et are aliases for --start-time / --end-time
-        const startTime = options.startTime || options.st;
-        const endTime = options.endTime || options.et;
-        if (!startTime || !endTime) {
-            console.error('Error: --start-time and --end-time are required.');
-            process.exit(1);
-        }
-        const format = ['json', 'table', 'pretty'].includes(options.format)
-            ? options.format
-            : 'pretty';
+        const config = (0, common_1.loadCheckedConfig)();
+        const { groupId, streamId } = (0, common_1.resolveGroupStream)(options, config);
+        const timeParams = (0, common_1.resolveTimeParams)(options);
+        const query = (0, common_1.buildQueryExpression)(options);
+        const format = (0, common_1.resolveFormat)(options.format);
+        // --request-id 用于链路定位，按时间正序输出
+        const reverse = options.requestId ? false : options.reverse;
         const client = new client_1.LTSClient(config);
         const params = {
             groupId,
             streamId,
-            startTime,
-            endTime,
-            keyword: options.keyword,
-            query: options.query,
+            ...timeParams,
+            query,
             limit: options.limit,
-            offset: options.offset,
-            reverse: options.reverse,
+            reverse,
         };
         try {
-            if (options.paginate) {
+            if (!options.all) {
+                // 默认单页查询，结果量由 --limit 控制
                 const result = await client.queryLogs(params);
+                (0, common_1.warnIfIncomplete)(result);
                 console.log((0, output_1.formatOutput)(result, format));
             }
             else {
-                // Auto-pagination: fetch all logs
-                const allLogs = [];
-                let offset = options.offset || 0;
-                const limit = options.limit || 100;
-                let hasMore = true;
-                while (hasMore) {
-                    const pageParams = {
-                        ...params,
-                        offset,
-                        limit,
-                    };
-                    const result = await client.queryLogs(pageParams);
-                    allLogs.push(...result.logs);
-                    if (result.logs.length < limit) {
-                        hasMore = false;
-                    }
-                    else {
-                        offset += limit;
-                    }
+                // --all：沿游标读到末尾，上限 10000 条防止失控
+                const result = await (0, pagination_1.fetchAllPages)((p) => client.queryLogs(p), params, {
+                    max: 10000,
+                    pageSize: options.limit,
+                });
+                (0, common_1.warnIfIncomplete)(result);
+                if (result.truncated) {
+                    console.error(`Warning: stopped at the ${result.logs.length}-log cap; more logs matched. Narrow the time range or add a filter.`);
                 }
-                const result = {
-                    logs: allLogs,
-                    total: allLogs.length,
-                };
-                console.log((0, output_1.formatOutput)(result, format));
+                console.log((0, output_1.formatOutput)({ logs: result.logs, total: result.total }, format));
             }
         }
         catch (error) {
-            const msg = error.message || String(error);
-            // Friendlier error messages for common issues
-            if (msg.includes('Invalid URL')) {
-                console.error('Error: Invalid endpoint URL. Make sure it starts with https://');
-                console.error('  Example: https://lts.cn-south-1.myhuaweicloud.com');
-            }
-            else if (msg.includes('Authentication failed') || msg.includes('401') || msg.includes('403')) {
-                console.error('Error: Authentication failed. Please check your AK/SK credentials:');
-                console.error('  lts-cli config --list');
-            }
-            else if (msg.includes('ENOTFOUND') || msg.includes('ECONNREFUSED')) {
-                console.error('Error: Cannot reach the LTS service. Please check your endpoint and network connection.');
-            }
-            else if (msg.includes('Request failed after retries')) {
-                console.error('Error: The service is temporarily unavailable. Please try again later.');
-            }
-            else {
-                console.error('Error querying logs:', msg);
-            }
-            process.exit(1);
+            (0, common_1.handleCommandError)(error);
         }
     });
     return cmd;

package/dist/cli/commands/streams.js

@@ -0,0 +1,81 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createGroupsCommand = createGroupsCommand;
+exports.createStreamsCommand = createStreamsCommand;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const client_1 = require("../../lts/client");
+const common_1 = require("./common");
+function printGroups(groups, format) {
+    if (format === 'json') {
+        console.log(JSON.stringify(groups, null, 2));
+        return;
+    }
+    if (groups.length === 0) {
+        console.log(chalk_1.default.yellow('No log groups found.'));
+        return;
+    }
+    console.log(chalk_1.default.bold.green(`Found ${groups.length} log groups:`));
+    console.log('');
+    for (const g of groups) {
+        console.log(`  ${chalk_1.default.cyan(g.name)}  ${chalk_1.default.gray(g.id)}`);
+    }
+    console.log('');
+    console.log(chalk_1.default.gray('Set default: lts-cli config --set groupId=<id>'));
+}
+function printStreams(streams, format) {
+    if (format === 'json') {
+        console.log(JSON.stringify(streams, null, 2));
+        return;
+    }
+    if (streams.length === 0) {
+        console.log(chalk_1.default.yellow('No log streams found.'));
+        return;
+    }
+    console.log(chalk_1.default.bold.green(`Found ${streams.length} log streams:`));
+    console.log('');
+    for (const s of streams) {
+        const group = s.groupId ? chalk_1.default.gray(`  group: ${s.groupId}`) : '';
+        console.log(`  ${chalk_1.default.cyan(s.name)}  ${chalk_1.default.gray(s.id)}${group}`);
+    }
+    console.log('');
+    console.log(chalk_1.default.gray('Set default: lts-cli config --set streamId=<id>'));
+}
+function createGroupsCommand() {
+    const cmd = new commander_1.Command('groups');
+    cmd.description('List all LTS log groups (name + ID)')
+        .option('-f, --format <format>', 'Output format: json, pretty', 'pretty')
+        .action(async (options) => {
+        const config = (0, common_1.loadCheckedConfig)();
+        const client = new client_1.LTSClient(config);
+        try {
+            const groups = await client.listGroups();
+            printGroups(groups, options.format);
+        }
+        catch (error) {
+            (0, common_1.handleCommandError)(error);
+        }
+    });
+    return cmd;
+}
+function createStreamsCommand() {
+    const cmd = new commander_1.Command('streams');
+    cmd.description('List LTS log streams, optionally filtered by log group name')
+        .option('--group <name>', 'Filter by log group NAME (the API filters by name, not ID)')
+        .option('-f, --format <format>', 'Output format: json, pretty', 'pretty')
+        .action(async (options) => {
+        const config = (0, common_1.loadCheckedConfig)();
+        const client = new client_1.LTSClient(config);
+        try {
+            const streams = await client.listStreams(options.group);
+            printStreams(streams, options.format);
+        }
+        catch (error) {
+            (0, common_1.handleCommandError)(error);
+        }
+    });
+    return cmd;
+}

package/dist/cli/commands/trace.js

@@ -0,0 +1,76 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTraceCommand = createTraceCommand;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const client_1 = require("../../lts/client");
+const pagination_1 = require("../../lts/pagination");
+const output_1 = require("../../output");
+const config_1 = require("../../config");
+const common_1 = require("./common");
+/**
+ * 默认按全文索引检索，而不是 REQUEST_ID。
+ *
+ * 理由：`REQUEST_ID` 是某类应用的字段命名约定，不是 LTS 的通用概念。新用户的日志流
+ * 里往往没有这个字段，写死它会让 `trace` 在正确的用法下返回空。全文检索总能命中，
+ * 而用到专用字段的人可以在 config 里设一次 `traceField`。
+ */
+const DEFAULT_TRACE_FIELD = 'content';
+function createTraceCommand() {
+    const cmd = new commander_1.Command('trace');
+    cmd.description('Trace a request by ID — fetch the full request chain in chronological order')
+        .argument('<requestId>', 'Value to trace (request ID, trace ID, or any search text)')
+        .option('-g, --group-id <groupId>', 'Log group ID (can also be set via config)')
+        .option('-s, --stream-id <streamId>', 'Log stream ID (can also be set via config)')
+        .option('--field <name>', `Field to match. Defaults to config.traceField, then "${DEFAULT_TRACE_FIELD}"`)
+        .option('--last <duration>', 'Relative time range: 30m, 2h, 1d, 7d (default: 24h)')
+        .option('--start-time <startTime>', 'Start time (ISO 8601)')
+        .option('--end-time <endTime>', 'End time (ISO 8601)')
+        .option('--st <startTime>', 'Alias for --start-time')
+        .option('--et <endTime>', 'Alias for --end-time')
+        .option('-l, --limit <limit>', 'Max number of logs to fetch', (v) => parseInt(v, 10), 200)
+        .option('-f, --format <format>', 'Output format: json, table, pretty', 'pretty')
+        .action(async (requestId, options) => {
+        const config = (0, common_1.loadCheckedConfig)();
+        const { groupId, streamId } = (0, common_1.resolveGroupStream)(options, config);
+        const timeParams = (0, common_1.resolveTimeParams)(options, '24h');
+        const format = (0, common_1.resolveFormat)(options.format);
+        const field = options.field || (0, config_1.getConfig)('traceField') || DEFAULT_TRACE_FIELD;
+        // 值加双引号：含连字符的 UUID 不加引号会被分词导致匹配不到
+        const query = `${field}:"${requestId}"`;
+        const client = new client_1.LTSClient(config);
+        const params = {
+            groupId,
+            streamId,
+            ...timeParams,
+            query,
+            reverse: false, // 链路按时间正序
+        };
+        try {
+            const maxTotal = options.limit || 200;
+            // 每页不超过 500：再大 LTS 会开始截断，且首屏延迟明显变差
+            const pageSize = Math.min(maxTotal, 500);
+            const result = await (0, pagination_1.fetchAllPages)((p) => client.queryLogs(p), params, {
+                max: maxTotal,
+                pageSize,
+            });
+            (0, common_1.warnIfIncomplete)(result);
+            if (result.truncated) {
+                console.error(`Warning: stopped at --limit ${maxTotal}; the chain may continue. Re-run with a larger --limit.`);
+            }
+            let output = (0, output_1.formatOutput)({ logs: result.logs, total: result.total }, format);
+            // pretty 格式下高亮 requestId，便于肉眼定位
+            if (format === 'pretty' && result.logs.length > 0) {
+                output = output.split(requestId).join(chalk_1.default.yellow.bold(requestId));
+            }
+            console.log(output);
+        }
+        catch (error) {
+            (0, common_1.handleCommandError)(error);
+        }
+    });
+    return cmd;
+}