@lark-apaas/miaoda-cli 0.1.2-alpha.08ca9fb → 0.1.2-alpha.10113dd

package/dist/cli/commands/app/index.js

@@ -32,7 +32,7 @@ JSON 输出
     cmd.action((0, shared_1.withHelp)(cmd, async (rawOpts) => {
         (0, shared_1.rejectCliOverride)(cmd, "appId");
         await (0, index_1.handleAppGet)({
-            appId: rawOpts.appId,
+            appId: (0, shared_1.resolveAppId)({ appId: rawOpts.appId }),
         });
     }));
 }
@@ -45,7 +45,7 @@ function registerAppUpdate(parent) {
         .option("--description <desc>", "新应用描述")
         .addHelpText("after", `
 JSON 输出
-  与 'app get' 一致：{"data": {...新 meta...}, "next_cursor": null, "has_more": false}
+  与 'app get' 一致：{"data": {...新 meta...}}
 
 示例
   $ miaoda app update --name my-store
@@ -54,7 +54,7 @@ JSON 输出
     cmd.action((0, shared_1.withHelp)(cmd, async (rawOpts) => {
         (0, shared_1.rejectCliOverride)(cmd, "appId");
         await (0, index_1.handleAppUpdate)({
-            appId: rawOpts.appId,
+            appId: (0, shared_1.resolveAppId)({ appId: rawOpts.appId }),
             name: rawOpts.name,
             description: rawOpts.description,
         });

package/dist/cli/commands/db/index.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerDbCommands = registerDbCommands;
 const index_1 = require("../../../cli/handlers/db/index");
+const shared_1 = require("../../../cli/commands/shared");
 function registerDbCommands(program) {
     const dbCmd = program
         .command("db")
@@ -22,7 +23,7 @@ function registerDbCommands(program) {
         .usage("<query> [flags]")
         .argument("[query]", "要执行的 SQL 语句；省略时从标准输入读取")
         .action(async function (query) {
-        await (0, index_1.handleDbSql)(query, this.optsWithGlobals());
+        await (0, index_1.handleDbSql)(query, { ...this.optsWithGlobals(), appId: (0, shared_1.resolveAppId)({}) });
     })
         .addHelpText("after", `
 Notes:
@@ -73,7 +74,7 @@ Examples:
         "查看单表完整结构请用 `schema get`；查看 DDL 变更历史请用 `changelog`（P1）。")
         .usage("[flags]")
         .action(async function () {
-        await (0, index_1.handleDbSchemaList)(this.optsWithGlobals());
+        await (0, index_1.handleDbSchemaList)({ ...this.optsWithGlobals(), appId: (0, shared_1.resolveAppId)({}) });
     })
         .addHelpText("after", `
 Examples:
@@ -103,7 +104,7 @@ Examples:
         .argument("<table>", "表名（无需带 schema 前缀）")
         .option("--ddl", "强制输出 CREATE TABLE 建表语句（pretty 默认就是 DDL，--json 时配合此 flag 返 SQL 文本）")
         .action(async function (table) {
-        await (0, index_1.handleDbSchemaGet)(table, this.optsWithGlobals());
+        await (0, index_1.handleDbSchemaGet)(table, { ...this.optsWithGlobals(), appId: (0, shared_1.resolveAppId)({}) });
     })
         .addHelpText("after", `
 Examples:
@@ -144,7 +145,7 @@ Examples:
         .option("--table <name>", "目标表名；未指定时按文件名（不含扩展名）推断（如 users.csv → users）")
         .option("--format <fmt>", "文件格式 csv / json；未指定时按文件扩展名推断")
         .action(async function (file) {
-        await (0, index_1.handleDbDataImport)(file, this.optsWithGlobals());
+        await (0, index_1.handleDbDataImport)(file, { ...this.optsWithGlobals(), appId: (0, shared_1.resolveAppId)({}) });
     })
         .addHelpText("after", `
 Notes:
@@ -181,7 +182,7 @@ Examples:
         .option("--limit <n>", "最多导出行数（不超过 5000）")
         .option("--force", "输出文件已存在时覆盖（默认报错）")
         .action(async function (table) {
-        await (0, index_1.handleDbDataExport)(table, this.optsWithGlobals());
+        await (0, index_1.handleDbDataExport)(table, { ...this.optsWithGlobals(), appId: (0, shared_1.resolveAppId)({}) });
     })
         .addHelpText("after", `
 Notes:

package/dist/cli/commands/deploy/index.js

@@ -35,6 +35,12 @@ JSON 输出
   带 --wait：data 额外包含 detail（pipeline 终态）
   detail/status 字段为可读字符串；对应 *_code 字段保留 BAM 原始数字枚举。
 
+状态确认（Agent 必须执行）
+  优先使用 --wait，但无论是否传 --wait，只要 deploy 调用后没有明确的 success / failed / canceled 终态，
+  都必须每 2s 轮询一次当前发布状态：拿到 pipelineTaskID 就执行 \`miaoda deploy get <pipelineTaskID> --json\`；
+  如果没有拿到 deploy-id 或输出为空，先执行 \`miaoda deploy history --limit 1 --json\` 找到对应发布记录并取得 ID，
+  再用这个 ID 每 2s 执行一次 \`miaoda deploy get <ID> --json\`，直到 status 进入终态。
+
 示例
   $ miaoda deploy
   $ miaoda deploy --wait --timeout 600
@@ -44,7 +50,7 @@ JSON 输出
     deployCmd.action((0, shared_1.withHelp)(deployCmd, async (rawOpts) => {
         (0, shared_1.rejectCliOverride)(deployCmd, "appId", "branch");
         await (0, index_1.handleDeploy)({
-            appId: rawOpts.appId,
+            appId: (0, shared_1.resolveAppId)({ appId: rawOpts.appId }),
             branch: rawOpts.branch,
             wait: rawOpts.wait,
             timeout: rawOpts.timeout,
@@ -73,7 +79,7 @@ JSON 输出
         (0, shared_1.rejectCliOverride)(cmd, "appId");
         await (0, index_1.handleDeployGet)({
             deployId,
-            appId: rawOpts.appId,
+            appId: (0, shared_1.resolveAppId)({ appId: rawOpts.appId }),
         });
     }));
 }
@@ -102,7 +108,7 @@ JSON 输出
         (0, shared_1.validateTimeOptions)(rawOpts, "since", "until");
         (0, shared_1.rejectCliOverride)(cmd, "appId");
         await (0, index_1.handleDeployHistory)({
-            appId: rawOpts.appId,
+            appId: (0, shared_1.resolveAppId)({ appId: rawOpts.appId }),
             status: rawOpts.status,
             since: rawOpts.since,
             until: rawOpts.until,
@@ -128,7 +134,7 @@ JSON 输出
         (0, shared_1.rejectCliOverride)(cmd, "appId");
         await (0, index_1.handleDeployErrorLog)({
             deployId,
-            appId: rawOpts.appId,
+            appId: (0, shared_1.resolveAppId)({ appId: rawOpts.appId }),
         });
     }));
 }

package/dist/cli/commands/file/index.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerFileCommands = registerFileCommands;
 const index_1 = require("../../../cli/handlers/file/index");
 const error_1 = require("../../../utils/error");
+const shared_1 = require("../../../cli/commands/shared");
 /**
  * commander option 校验器：把 --limit <n> 解析成正整数（≥1）。
  * 默认值（如 "50"）会先经过这里被规范化成 number。
@@ -43,7 +44,7 @@ function registerFileCommands(program) {
         .option("--cursor <token>", "分页游标，从上次响应的 next_cursor 取值")
         .option("--all", "自动翻页返回全部结果")
         .action(async (query, opts) => {
-        await (0, index_1.handleFileLs)({ ...opts, query });
+        await (0, index_1.handleFileLs)({ ...opts, appId: (0, shared_1.resolveAppId)({}), query });
     })
         .addHelpText("after", `
 Examples:
@@ -68,7 +69,7 @@ Examples:
         .usage("<file> [flags]")
         .argument("<file>", "文件的路径或文件名（自动识别）")
         .action(async (file, opts) => {
-        await (0, index_1.handleFileStat)(file, opts);
+        await (0, index_1.handleFileStat)(file, { ...opts, appId: (0, shared_1.resolveAppId)({}) });
     })
         .addHelpText("after", `
 Notes:
@@ -101,7 +102,7 @@ Examples:
         .argument("<dst>", "目标：本地路径或远程路径")
         .option("--rename <name>", "上传后在远端使用的新文件名")
         .action(async (src, dst, opts) => {
-        await (0, index_1.handleFileCp)(src, dst, opts);
+        await (0, index_1.handleFileCp)(src, dst, { ...opts, appId: (0, shared_1.resolveAppId)({}) });
     })
         .addHelpText("after", `
 Notes:
@@ -147,7 +148,7 @@ Examples:
         .option("-n, --name <name>", "按文件名删除（可重复指定）", (value, prev) => [...(prev ?? []), value])
         .option("-y, --yes", "跳过交互确认；非交互场景必加")
         .action(async (paths, opts) => {
-        await (0, index_1.handleFileRm)(paths, opts);
+        await (0, index_1.handleFileRm)(paths, { ...opts, appId: (0, shared_1.resolveAppId)({}) });
     })
         .addHelpText("after", `
 Notes:
@@ -190,7 +191,7 @@ Examples:
         .argument("<file>", "文件的路径或文件名")
         .option("--expires <duration>", "链接有效期，支持 30m / 24h / 7d 等单位（默认 1d，最长 30d）")
         .action(async (file, opts) => {
-        await (0, index_1.handleFileSign)(file, opts);
+        await (0, index_1.handleFileSign)(file, { ...opts, appId: (0, shared_1.resolveAppId)({}) });
     })
         .addHelpText("after", `
 Notes:

package/dist/cli/commands/observability/index.js

@@ -45,7 +45,7 @@ function registerLog(parent) {
         .argParser((0, shared_1.caseInsensitiveChoice)(["DEBUG", "INFO", "WARN", "ERROR"])))
         .option("--since <time>", "开始时间")
         .option("--until <time>", "截止时间")
-        .option("--log-id <id>", "按 log ID 过滤")
+        .option("--log-id <id>", "按请求 logid 过滤（attributes.ob_data_id）")
         .option("--trace-id <id>", "按 trace ID 过滤")
         .option("--grep <pattern>", "按关键字模糊搜索 body")
         .option("--module <name>", "按模块名过滤")
@@ -70,7 +70,7 @@ JSON 输出
         (0, shared_1.validateTimeOptions)(rawOpts, "since", "until");
         (0, shared_1.rejectCliOverride)(cmd, "appId");
         await (0, index_1.handleObservabilityLog)({
-            appId: rawOpts.appId,
+            appId: (0, shared_1.resolveAppId)({ appId: rawOpts.appId }),
             level: rawOpts.level,
             since: rawOpts.since,
             until: rawOpts.until,
@@ -117,7 +117,7 @@ JSON 输出
         (0, shared_1.validateTimeOptions)(rawOpts, "since", "until");
         (0, shared_1.rejectCliOverride)(listCmd, "appId");
         await (0, index_1.handleObservabilityTraceList)({
-            appId: rawOpts.appId,
+            appId: (0, shared_1.resolveAppId)({ appId: rawOpts.appId }),
             since: rawOpts.since,
             until: rawOpts.until,
             traceId: rawOpts.traceId,
@@ -149,7 +149,7 @@ JSON 输出
         (0, shared_1.rejectCliOverride)(getCmd, "appId");
         await (0, index_1.handleObservabilityTraceGet)({
             traceId,
-            appId: rawOpts.appId,
+            appId: (0, shared_1.resolveAppId)({ appId: rawOpts.appId }),
             withLogSeverityCount: rawOpts.withLogSeverityCount,
         });
     }));
@@ -185,7 +185,7 @@ JSON 输出
         (0, shared_1.rejectCliOverride)(cmd, "appId");
         await (0, index_1.handleObservabilityMetric)({
             metricName,
-            appId: rawOpts.appId,
+            appId: (0, shared_1.resolveAppId)({ appId: rawOpts.appId }),
             page: rawOpts.page,
             api: rawOpts.api,
             series: rawOpts.series,
@@ -221,7 +221,7 @@ JSON 输出
         (0, shared_1.rejectCliOverride)(cmd, "appId");
         await (0, index_1.handleObservabilityAnalytics)({
             analyticsName,
-            appId: rawOpts.appId,
+            appId: (0, shared_1.resolveAppId)({ appId: rawOpts.appId }),
             env: rawOpts.env,
             page: rawOpts.page,
             series: rawOpts.series,

package/dist/cli/commands/shared.js

@@ -1,17 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.failArgs = void 0;
 exports.appIdOption = appIdOption;
 exports.branchOption = branchOption;
 exports.softRequiredOption = softRequiredOption;
 exports.resolveAppId = resolveAppId;
 exports.withHelp = withHelp;
-exports.failArgs = failArgs;
 exports.caseInsensitiveChoice = caseInsensitiveChoice;
 exports.validateTimeOptions = validateTimeOptions;
 exports.rejectCliOverride = rejectCliOverride;
 const commander_1 = require("commander");
 const error_1 = require("../../utils/error");
 const time_1 = require("../../utils/time");
+const args_1 = require("../../utils/args");
+Object.defineProperty(exports, "failArgs", { enumerable: true, get: function () { return args_1.failArgs; } });
 /** --app-id option，需要应用上下文的命令自行 .addOption(appIdOption()) */
 function appIdOption() {
     return new commander_1.Option("--app-id <id>", "指定目标应用").env("MIAODA_APP_ID");
@@ -61,10 +63,6 @@ function withHelp(cmd, handler) {
         }
     };
 }
-/** 参数校验失败时抛出，配合 withHelp 自动打 help */
-function failArgs(message) {
-    throw new error_1.AppError("ARGS_INVALID", message);
-}
 /**
  * 大小写不敏感的 choice argParser：把用户输入按 lowerCase 匹配回 canonical 数组里
  * 的同名值（保留 canonical 大小写），未命中抛 Commander 的 InvalidArgumentError
@@ -101,7 +99,7 @@ function validateTimeOptions(opts, ...names) {
         if (value === undefined)
             continue;
         if (typeof value !== "string") {
-            failArgs(`--${name.replace(/([A-Z])/g, "-$1").toLowerCase()} 必须是时间字符串`);
+            (0, args_1.failArgs)(`--${name.replace(/([A-Z])/g, "-$1").toLowerCase()} 必须是时间字符串`);
         }
         (0, time_1.parseTimeToMs)(value);
     }
@@ -122,7 +120,7 @@ function rejectCliOverride(cmd, ...optNames) {
     for (const name of optNames) {
         if (cmd.getOptionValueSource(name) === "cli") {
             const flag = "--" + name.replace(/([A-Z])/g, "-$1").toLowerCase();
-            failArgs(`${flag} 由沙箱/本地配置注入，不允许显式传递`);
+            (0, args_1.failArgs)(`${flag} 由沙箱/本地配置注入，不允许显式传递`);
         }
     }
 }

package/dist/cli/handlers/app/get.js

@@ -36,13 +36,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.handleAppGet = handleAppGet;
 const api = __importStar(require("../../../api/index"));
 const output_1 = require("../../../utils/output");
-const shared_1 = require("../../../cli/commands/shared");
 const index_1 = require("../../../api/app/index");
 /** miaoda app get [--app-id <id>] */
 async function handleAppGet(opts) {
-    const appID = (0, shared_1.resolveAppId)({ appId: opts.appId });
+    const appID = opts.appId;
     const resp = await api.app.getAppInfo(appID);
     // BAM 在 status_code=0 时 data 字段含 appInfo；不存在则 fallback 空对象
     const meta = resp.appInfo?.appMeta ?? {};
-    (0, output_1.emit)({ data: meta, next_cursor: null, has_more: false }, index_1.appMetaSchema);
+    (0, output_1.emit)({ data: meta }, index_1.appMetaSchema);
 }

package/dist/cli/handlers/app/update.js

@@ -36,14 +36,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.handleAppUpdate = handleAppUpdate;
 const api = __importStar(require("../../../api/index"));
 const output_1 = require("../../../utils/output");
-const shared_1 = require("../../../cli/commands/shared");
+const args_1 = require("../../../utils/args");
 const index_1 = require("../../../api/app/index");
 /** miaoda app update [--app-id <id>] [--name <n>] [--description <d>] */
 async function handleAppUpdate(opts) {
     if (opts.name === undefined && opts.description === undefined) {
-        (0, shared_1.failArgs)("至少需要 --name 或 --description 中的一个");
+        (0, args_1.failArgs)("至少需要 --name 或 --description 中的一个");
     }
-    const appID = (0, shared_1.resolveAppId)({ appId: opts.appId });
+    const appID = opts.appId;
     await api.app.updateAppMeta({
         appID,
         name: opts.name,
@@ -55,5 +55,5 @@ async function handleAppUpdate(opts) {
     if (!(0, output_1.isJsonMode)()) {
         process.stdout.write("✓ App updated successfully\n");
     }
-    (0, output_1.emit)({ data: meta, next_cursor: null, has_more: false }, index_1.appMetaSchema);
+    (0, output_1.emit)({ data: meta }, index_1.appMetaSchema);
 }

package/dist/cli/handlers/db/data.js

@@ -40,13 +40,12 @@ const path = __importStar(require("node:path"));
 const api = __importStar(require("../../../api/index"));
 const error_1 = require("../../../utils/error");
 const output_1 = require("../../../utils/output");
-const shared_1 = require("../../../cli/commands/shared");
 const render_1 = require("../../../utils/render");
 // P0 规格（对齐技术方案关键决策 2）
 const MAX_SIZE_BYTES = 1 * 1024 * 1024; // 1 MB
 const MAX_ROWS = 5000;
 async function handleDbDataImport(file, opts) {
-    const appId = (0, shared_1.resolveAppId)(opts);
+    const appId = opts.appId;
     const ext = path.extname(file).toLowerCase();
     const format = resolveFormat(opts.format, ext, "import");
     let body;
@@ -95,7 +94,7 @@ async function handleDbDataImport(file, opts) {
         : `OK Imported ${file} -> table '${result.tableName}' (${String(result.recordCount)} rows)`);
 }
 async function handleDbDataExport(table, opts) {
-    const appId = (0, shared_1.resolveAppId)(opts);
+    const appId = opts.appId;
     const format = resolveFormat(opts.format, undefined, "export", "csv");
     const outputPath = opts.file ?? `${table}.${format}`;
     const limit = opts.limit ? Number(opts.limit) : MAX_ROWS;

package/dist/cli/handlers/db/schema.js

@@ -39,12 +39,11 @@ const api = __importStar(require("../../../api/index"));
 const error_1 = require("../../../utils/error");
 const output_1 = require("../../../utils/output");
 const render_1 = require("../../../utils/render");
-const shared_1 = require("../../../cli/commands/shared");
 const colors_1 = require("../../../utils/colors");
 const index_1 = require("../../../api/db/index");
 // ── schema list ──
 async function handleDbSchemaList(opts) {
-    const appId = (0, shared_1.resolveAppId)(opts);
+    const appId = opts.appId;
     const resp = await api.db.getSchema({
         appId,
         format: "schema",
@@ -80,7 +79,7 @@ async function handleDbSchemaList(opts) {
     (0, output_1.emit)(tty ? (0, render_1.renderAlignedTable)(headers, rows) : (0, render_1.renderTsv)(headers, rows));
 }
 async function handleDbSchemaGet(table, opts) {
-    const appId = (0, shared_1.resolveAppId)(opts);
+    const appId = opts.appId;
     const tty = (0, render_1.isStdoutTty)();
     const forceDdl = Boolean(opts.ddl);
     const wantsStructured = (0, output_1.isJsonMode)() || (tty && !forceDdl);

package/dist/cli/handlers/db/sql.js

@@ -42,7 +42,6 @@ const error_1 = require("../../../utils/error");
 const output_1 = require("../../../utils/output");
 const config_1 = require("../../../utils/config");
 const logger_1 = require("../../../utils/logger");
-const shared_1 = require("../../../cli/commands/shared");
 const render_1 = require("../../../utils/render");
 const colors_1 = require("../../../utils/colors");
 const fuzzy_match_1 = require("../../../utils/fuzzy-match");
@@ -62,7 +61,7 @@ const node_path_1 = __importDefault(require("node:path"));
  *   末尾汇总，--json 输出 data 数组。
  */
 async function handleDbSql(query, opts) {
-    const appId = (0, shared_1.resolveAppId)(opts);
+    const appId = opts.appId;
     const sql = await readSql(query);
     if (!sql.trim()) {
         throw new error_1.AppError("ARGS_INVALID", "Empty SQL (no inline query and stdin is empty)");

package/dist/cli/handlers/deploy/deploy.js

@@ -36,18 +36,18 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.handleDeploy = handleDeploy;
 const api = __importStar(require("../../../api/index"));
 const output_1 = require("../../../utils/output");
-const shared_1 = require("../../../cli/commands/shared");
 const index_1 = require("../../../api/deploy/index");
 const polling_1 = require("./polling");
 const format_1 = require("./format");
 /** miaoda deploy [--branch ...] [--wait] [--timeout 300] */
 async function handleDeploy(opts) {
-    const appID = (0, shared_1.resolveAppId)({ appId: opts.appId });
+    const appID = opts.appId;
     const resp = await api.deploy.createRelease({ appID, branch: opts.branch });
     const pipelineTaskID = resp.pipelineTaskID ?? "";
     if (!opts.wait) {
         if (!(0, output_1.isJsonMode)()) {
             process.stdout.write(`✓ Deployment triggered. (deploy-id: ${pipelineTaskID})\n`);
+            process.stdout.write(`  hint: No terminal status yet. Poll every 2s with \`miaoda deploy get ${pipelineTaskID} --json\`; if no deploy-id is visible, first get it from \`miaoda deploy history --limit 1 --json\`.\n`);
         }
         (0, output_1.emit)({
             data: { pipelineTaskID },

package/dist/cli/handlers/deploy/error-log.js

@@ -36,14 +36,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.handleDeployErrorLog = handleDeployErrorLog;
 const api = __importStar(require("../../../api/index"));
 const output_1 = require("../../../utils/output");
-const shared_1 = require("../../../cli/commands/shared");
+const args_1 = require("../../../utils/args");
 const index_1 = require("../../../api/deploy/index");
 const helpers_1 = require("./helpers");
 /** miaoda deploy error-log <deploy-id> */
 async function handleDeployErrorLog(opts) {
     if (!opts.deployId)
-        (0, shared_1.failArgs)("<deploy-id> 必填");
-    const appID = (0, shared_1.resolveAppId)({ appId: opts.appId });
+        (0, args_1.failArgs)("<deploy-id> 必填");
+    const appID = opts.appId;
     (0, helpers_1.parseDeployId)(opts.deployId); // 仅校验数字形式；URL 直接用原字符串
     const instanceID = opts.deployId;
     const resp = await api.deploy.getErrorLog({ appID, instanceID });

package/dist/cli/handlers/deploy/get.js

@@ -36,7 +36,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.handleDeployGet = handleDeployGet;
 const api = __importStar(require("../../../api/index"));
 const output_1 = require("../../../utils/output");
-const shared_1 = require("../../../cli/commands/shared");
+const args_1 = require("../../../utils/args");
 const error_1 = require("../../../utils/error");
 const index_1 = require("../../../api/deploy/index");
 const helpers_1 = require("./helpers");
@@ -54,8 +54,8 @@ const DEPLOY_GET_LOOKUP_LIMIT = 500;
  */
 async function handleDeployGet(opts) {
     if (!opts.deployId)
-        (0, shared_1.failArgs)("<deploy-id> 必填");
-    const appID = (0, shared_1.resolveAppId)({ appId: opts.appId });
+        (0, args_1.failArgs)("<deploy-id> 必填");
+    const appID = opts.appId;
     const deployId = (0, helpers_1.parseDeployId)(opts.deployId);
     const resp = await api.deploy.listPipelineInstances({
         appID,

package/dist/cli/handlers/deploy/helpers.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseStatusFlag = parseStatusFlag;
 exports.validateLimit = validateLimit;
 exports.parseDeployId = parseDeployId;
-const shared_1 = require("../../../cli/commands/shared");
+const args_1 = require("../../../utils/args");
 const index_1 = require("../../../api/deploy/index");
 /**
  * 把 CLI --status 字符串映射成 BAM NodeStatus 数字；非法值抛 ARGS_INVALID。
@@ -14,7 +14,7 @@ const index_1 = require("../../../api/deploy/index");
 function parseStatusFlag(text) {
     const value = (0, index_1.nodeStatusFromText)(text);
     if (value === undefined) {
-        (0, shared_1.failArgs)(`--status 无效：'${text}'。可选值：todo | running | success | failed | canceled | hold_on`);
+        (0, args_1.failArgs)(`--status 无效：'${text}'。可选值：todo | running | success | failed | canceled | hold_on`);
     }
     return value;
 }
@@ -22,7 +22,7 @@ function parseStatusFlag(text) {
 function validateLimit(limit, defaultLimit = 50) {
     const n = Number.isFinite(limit) ? limit : defaultLimit;
     if (n <= 0 || n > 100) {
-        (0, shared_1.failArgs)(`--limit 必须在 1~100 之间，收到 ${String(n)}`);
+        (0, args_1.failArgs)(`--limit 必须在 1~100 之间，收到 ${String(n)}`);
     }
     return n;
 }
@@ -35,7 +35,7 @@ function validateLimit(limit, defaultLimit = 50) {
 function parseDeployId(text) {
     const n = Number(text);
     if (!Number.isFinite(n) || !/^\d+$/.test(text)) {
-        (0, shared_1.failArgs)(`<deploy-id> 必须是数字 ID，收到 '${text}'`);
+        (0, args_1.failArgs)(`<deploy-id> 必须是数字 ID，收到 '${text}'`);
     }
     return n;
 }

package/dist/cli/handlers/deploy/history.js

@@ -36,14 +36,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.handleDeployHistory = handleDeployHistory;
 const api = __importStar(require("../../../api/index"));
 const output_1 = require("../../../utils/output");
-const shared_1 = require("../../../cli/commands/shared");
 const time_1 = require("../../../utils/time");
 const index_1 = require("../../../api/deploy/index");
 const helpers_1 = require("./helpers");
 const format_1 = require("./format");
 /** miaoda deploy history */
 async function handleDeployHistory(opts) {
-    const appID = (0, shared_1.resolveAppId)({ appId: opts.appId });
+    const appID = opts.appId;
     const limit = (0, helpers_1.validateLimit)(opts.limit ?? 50);
     const req = {
         appID,

package/dist/cli/handlers/file/cp.js

@@ -44,7 +44,6 @@ const api = __importStar(require("../../../api/index"));
 const output_1 = require("../../../utils/output");
 const render_1 = require("../../../utils/render");
 const error_1 = require("../../../utils/error");
-const shared_1 = require("../../../cli/commands/shared");
 const colors_1 = require("../../../utils/colors");
 const MAX_UPLOAD_BYTES = 100 * 1024 * 1024;
 /**
@@ -233,7 +232,7 @@ async function handleDownload(appId, remoteRaw, localRaw) {
     }
 }
 async function handleFileCp(src, dst, opts) {
-    const appId = (0, shared_1.resolveAppId)(opts);
+    const appId = opts.appId;
     // src 本地存在 → upload；其他情况（file_ref / `/path` / 裸文件名）→ download
     if (isLocalSrc(src)) {
         return handleUpload(appId, src, dst, opts.rename);

package/dist/cli/handlers/file/ls.js

@@ -38,7 +38,6 @@ const api = __importStar(require("../../../api/index"));
 const output_1 = require("../../../utils/output");
 const render_1 = require("../../../utils/render");
 const error_1 = require("../../../utils/error");
-const shared_1 = require("../../../cli/commands/shared");
 const index_1 = require("../../../api/file/index");
 /**
  * 把位置参数 `query` 路由到 `--path` 或 `--name`：
@@ -65,7 +64,7 @@ function resolveQueryRouting(opts) {
     return { name: opts.query };
 }
 async function handleFileLs(opts) {
-    const appId = (0, shared_1.resolveAppId)(opts);
+    const appId = opts.appId;
     // commander 已经把 --limit 解析为 number；保留 ?? undefined 兼容老调用
     const limit = opts.limit;
     const sizeGt = opts.sizeGt ? (0, render_1.parseSize)(opts.sizeGt) : undefined;

package/dist/cli/handlers/file/rm.js

@@ -40,7 +40,6 @@ exports.handleFileRm = handleFileRm;
 const api = __importStar(require("../../../api/index"));
 const output_1 = require("../../../utils/output");
 const error_1 = require("../../../utils/error");
-const shared_1 = require("../../../cli/commands/shared");
 const index_1 = require("../../../api/file/index");
 const render_1 = require("../../../utils/render");
 const colors_1 = require("../../../utils/colors");
@@ -133,7 +132,7 @@ async function handleFileRm(paths, opts) {
     if (totalCount > MAX_BATCH) {
         throw new error_1.AppError("FILE_BATCH_TOO_MANY", `Batch size ${String(totalCount)} exceeds the 100 limit`);
     }
-    const appId = (0, shared_1.resolveAppId)(opts);
+    const appId = opts.appId;
     // destructive guardrail
     const tty = (0, render_1.isStdoutTty)();
     if (tty && !opts.yes) {

package/dist/cli/handlers/file/sign.js

@@ -38,7 +38,6 @@ const api = __importStar(require("../../../api/index"));
 const output_1 = require("../../../utils/output");
 const render_1 = require("../../../utils/render");
 const error_1 = require("../../../utils/error");
-const shared_1 = require("../../../cli/commands/shared");
 const index_1 = require("../../../api/file/index");
 const MAX_EXPIRES_SECONDS = 30 * 86400;
 const DEFAULT_EXPIRES_SECONDS = 86400; // 1d（PRD 规定）
@@ -64,7 +63,7 @@ async function resolveFilePath(appId, input) {
     return resolved.file.path;
 }
 async function handleFileSign(file, opts) {
-    const appId = (0, shared_1.resolveAppId)(opts);
+    const appId = opts.appId;
     let expiresSec = DEFAULT_EXPIRES_SECONDS;
     if (opts.expires) {
         expiresSec = (0, render_1.parseDuration)(opts.expires);

package/dist/cli/handlers/file/stat.js

@@ -38,7 +38,6 @@ const api = __importStar(require("../../../api/index"));
 const output_1 = require("../../../utils/output");
 const render_1 = require("../../../utils/render");
 const error_1 = require("../../../utils/error");
-const shared_1 = require("../../../cli/commands/shared");
 const index_1 = require("../../../api/file/index");
 /**
  * 解析 `<file>` 为后端 head 可用的 filePath。
@@ -67,7 +66,7 @@ async function resolveFile(appId, input) {
     return head;
 }
 async function handleFileStat(file, opts) {
-    const appId = (0, shared_1.resolveAppId)(opts);
+    const appId = opts.appId;
     const info = await resolveFile(appId, file);
     if ((0, output_1.isJsonMode)()) {
         (0, output_1.emitOk)(info);

package/dist/cli/handlers/observability/analytics.js

@@ -36,7 +36,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.handleObservabilityAnalytics = handleObservabilityAnalytics;
 const api = __importStar(require("../../../api/index"));
 const output_1 = require("../../../utils/output");
-const shared_1 = require("../../../cli/commands/shared");
+const args_1 = require("../../../utils/args");
 const helpers_1 = require("./helpers");
 const GRANULARITY_TO_UNIT = {
     day: "DAY",
@@ -68,8 +68,8 @@ const ANALYTICS_LABELS = {
 /** miaoda observability analytics <analytics-name> */
 async function handleObservabilityAnalytics(opts) {
     if (!opts.analyticsName)
-        (0, shared_1.failArgs)("<analytics-name> 必填");
-    const appID = (0, shared_1.resolveAppId)({ appId: opts.appId });
+        (0, args_1.failArgs)("<analytics-name> 必填");
+    const appID = opts.appId;
     const { metricTypes, labelByMetric, extraFilters } = resolveAnalyticsSelection(opts.analyticsName, opts.series);
     const timeAggregationUnit = opts.granularity
         ? (GRANULARITY_TO_UNIT[opts.granularity] ?? opts.granularity.toUpperCase())

package/dist/cli/handlers/observability/helpers.js

@@ -6,7 +6,7 @@ exports.rangeFilter = rangeFilter;
 exports.fuzzyFilter = fuzzyFilter;
 exports.buildFieldFilters = buildFieldFilters;
 exports.validateLimit = validateLimit;
-const shared_1 = require("../../../cli/commands/shared");
+const args_1 = require("../../../utils/args");
 const index_1 = require("../../../api/observability/index");
 // 时间解析助手已抽到 utils/time.ts；这里 re-export 维持 observability handler 的旧 import 路径。
 var time_1 = require("../../../utils/time");
@@ -60,7 +60,7 @@ function buildFieldFilters(entries) {
 function validateLimit(limit, defaultLimit = 50) {
     const n = Number.isFinite(limit) ? limit : defaultLimit;
     if (n <= 0 || n > 100) {
-        (0, shared_1.failArgs)(`--limit 必须在 1~100 之间，收到 ${String(n)}`);
+        (0, args_1.failArgs)(`--limit 必须在 1~100 之间，收到 ${String(n)}`);
     }
     return n;
 }

package/dist/cli/handlers/observability/log.js

@@ -36,22 +36,21 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.handleObservabilityLog = handleObservabilityLog;
 const api = __importStar(require("../../../api/index"));
 const output_1 = require("../../../utils/output");
-const shared_1 = require("../../../cli/commands/shared");
 const index_1 = require("../../../api/observability/index");
 const helpers_1 = require("./helpers");
 /** miaoda observability log */
 async function handleObservabilityLog(opts) {
-    const appID = (0, shared_1.resolveAppId)({ appId: opts.appId });
+    const appID = opts.appId;
     const appEnv = "runtime";
     const limit = (0, helpers_1.validateLimit)(opts.limit ?? 50);
-    // 过滤 key 对齐 BAM LogItem 字段名：
-    //   - 顶层字段：id / severityText / traceID（注意大小写）
-    //   - attributes 里的业务字段：module / user_id / page / api（snake_case，
+    // 过滤 key 对齐 BAM 查询字段名：
+    //   - 顶层字段：severity_text / trace_id（输出仍映射成 severityText / traceID）
+    //   - attributes 里的业务字段：module / user_id / page / api / ob_data_id（snake_case，
     //     依据 BAM IDL 的 LogItem.attributes 描述："包括 tenant_id, module, user_id, page, api 等"）
     //   - duration_ms 暂未在 BAM 描述里明确列出，留 TODO 等 e2e 验证
     const fieldFilters = (0, helpers_1.buildFieldFilters)([
         { key: "severity_text", value: opts.level ? (0, helpers_1.eqFilter)(opts.level) : undefined },
-        { key: "id", value: opts.logId ? (0, helpers_1.eqFilter)(opts.logId) : undefined },
+        { key: "attributes.ob_data_id", value: opts.logId ? (0, helpers_1.eqFilter)(opts.logId) : undefined },
         { key: "trace_id", value: opts.traceId ? (0, helpers_1.eqFilter)(opts.traceId) : undefined },
         { key: "module", value: opts.module ? (0, helpers_1.eqFilter)(opts.module) : undefined },
         { key: "user_id", value: opts.userId ? (0, helpers_1.eqFilter)(opts.userId, "i64") : undefined },

package/dist/cli/handlers/observability/metric.js

@@ -36,7 +36,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.handleObservabilityMetric = handleObservabilityMetric;
 const api = __importStar(require("../../../api/index"));
 const output_1 = require("../../../utils/output");
-const shared_1 = require("../../../cli/commands/shared");
+const args_1 = require("../../../utils/args");
 const helpers_1 = require("./helpers");
 /**
  * PRD <metric-name> + --series → 服务端 metric name → 表头列名（=对应 --series 取值）。
@@ -61,8 +61,8 @@ const METRIC_LABELS = {
 /** miaoda observability metric <metric-name> */
 async function handleObservabilityMetric(opts) {
     if (!opts.metricName)
-        (0, shared_1.failArgs)("<metric-name> 必填");
-    const appID = (0, shared_1.resolveAppId)({ appId: opts.appId });
+        (0, args_1.failArgs)("<metric-name> 必填");
+    const appID = opts.appId;
     const { metricNames, labelByMetric, extraFilters } = resolveMetricSelection(opts.metricName, opts.series);
     const filters = (0, helpers_1.buildFieldFilters)([
         { key: "referer_path", value: opts.page ? (0, helpers_1.eqFilter)(opts.page) : undefined },

package/dist/cli/handlers/observability/trace.js

@@ -37,12 +37,12 @@ exports.handleObservabilityTraceList = handleObservabilityTraceList;
 exports.handleObservabilityTraceGet = handleObservabilityTraceGet;
 const api = __importStar(require("../../../api/index"));
 const output_1 = require("../../../utils/output");
-const shared_1 = require("../../../cli/commands/shared");
+const args_1 = require("../../../utils/args");
 const index_1 = require("../../../api/observability/index");
 const helpers_1 = require("./helpers");
 /** miaoda observability trace list */
 async function handleObservabilityTraceList(opts) {
-    const appID = (0, shared_1.resolveAppId)({ appId: opts.appId });
+    const appID = opts.appId;
     const appEnv = "runtime";
     const limit = (0, helpers_1.validateLimit)(opts.limit ?? 50);
     // 过滤 key 对齐 BAM Span 字段名：
@@ -77,8 +77,8 @@ function emitSearchTracesResponse(resp) {
 /** miaoda observability trace get <trace-id> */
 async function handleObservabilityTraceGet(opts) {
     if (!opts.traceId)
-        (0, shared_1.failArgs)("<trace-id> 必填");
-    const appID = (0, shared_1.resolveAppId)({ appId: opts.appId });
+        (0, args_1.failArgs)("<trace-id> 必填");
+    const appID = opts.appId;
     const appEnv = "runtime";
     const resp = await api.observability.getTraces({
         appID,

package/dist/utils/args.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.failArgs = failArgs;
+const error_1 = require("./error");
+/** 参数校验失败时抛出；命令层可配合 withHelp 自动打 help。 */
+function failArgs(message) {
+    throw new error_1.AppError("ARGS_INVALID", message);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/miaoda-cli",
-  "version": "0.1.2-alpha.08ca9fb",
+  "version": "0.1.2-alpha.10113dd",
   "description": "Miaoda 平台命令行工具，面向 Agent 调用",
   "type": "commonjs",
   "bin": {