@lark-apaas/miaoda-cli 0.1.1 → 0.1.2-alpha.b2b5ae5

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

@@ -0,0 +1,139 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerDeployCommands = registerDeployCommands;
+const commander_1 = require("commander");
+const shared_1 = require("../../../cli/commands/shared");
+const index_1 = require("../../../cli/handlers/deploy/index");
+const COMMON_TIME_HELP = `
+时间格式：
+  - 相对时间：1h（1 小时前）、2d（2 天前）、1w（1 周前）、30m（30 分钟前）
+  - 日期：2026-04-01（按当日 00:00:00 UTC）
+  - ISO 8601：2026-04-01T10:00:00Z
+`;
+function registerDeployCommands(program) {
+    // PRD：`miaoda deploy` 自身即为触发发布；get / history / error-log 是子命令
+    const deployCmd = program
+        .command("deploy")
+        .description("触发发布；支持 --wait 阻塞到终态。子命令：get / history / error-log")
+        .addOption((0, shared_1.appIdOption)().hideHelp())
+        .addOption((0, shared_1.branchOption)().hideHelp())
+        .option("--wait", "阻塞直到流水线终态", false)
+        .option("--timeout <sec>", "--wait 最长等待秒数（默认 300）", parseTimeout, 300)
+        .addHelpText("after", `
+JSON 输出
+  不带 --wait：{"data": {"pipelineTaskID": "..."}}（pipelineTaskID 即 deploy-id）
+  带 --wait：data 额外包含 detail（pipeline 终态）
+
+示例
+  $ miaoda deploy
+  $ miaoda deploy --wait --timeout 600
+  $ miaoda deploy get 12345
+  $ miaoda deploy history --status failed
+`);
+    deployCmd.action((0, shared_1.withHelp)(deployCmd, async (rawOpts) => {
+        (0, shared_1.rejectCliOverride)(deployCmd, "appId", "branch");
+        await (0, index_1.handleDeploy)({
+            appId: rawOpts.appId,
+            branch: rawOpts.branch,
+            wait: rawOpts.wait,
+            timeout: rawOpts.timeout,
+        });
+    }));
+    registerDeployGet(deployCmd);
+    registerDeployHistory(deployCmd);
+    registerDeployErrorLog(deployCmd);
+}
+function registerDeployGet(parent) {
+    const cmd = parent
+        .command("get")
+        .description("查看指定发布单的详情")
+        .argument("<deploy-id>", "发布单 ID")
+        .addOption((0, shared_1.appIdOption)().hideHelp())
+        .addHelpText("after", `
+JSON 输出
+  {"data": {"ID": ..., "status": ..., "creator": "...", "createdAt": ..., "updatedAt": ..., ...}, "next_cursor": null, "has_more": false}
+  ID 即 deploy-id（== pipelineTaskID）
+
+示例
+  $ miaoda deploy get 12345
+`);
+    cmd.action((0, shared_1.withHelp)(cmd, async (deployId, rawOpts) => {
+        (0, shared_1.rejectCliOverride)(cmd, "appId");
+        await (0, index_1.handleDeployGet)({
+            deployId,
+            appId: rawOpts.appId,
+        });
+    }));
+}
+function registerDeployHistory(parent) {
+    const cmd = parent
+        .command("history")
+        .description("查询发布历史（按时间倒序，分页）")
+        .addOption((0, shared_1.appIdOption)().hideHelp())
+        .addOption(new commander_1.Option("--status <status>", "状态过滤（pipeline 节点状态）").choices([
+        "todo",
+        "running",
+        "success",
+        "failed",
+        "canceled",
+        "hold_on",
+    ]))
+        .option("--since <time>", "起始时间")
+        .option("--until <time>", "截止时间")
+        .option("--limit <n>", "返回条数上限（1~100）", parseLimit, 50)
+        .option("--cursor <token>", "下一页游标")
+        .addHelpText("after", `${COMMON_TIME_HELP}
+JSON 输出
+  {"data": [...], "next_cursor": "...", "has_more": true|false}
+
+示例
+  $ miaoda deploy history --status failed
+  $ miaoda deploy history --since 7d
+`);
+    cmd.action((0, shared_1.withHelp)(cmd, async (rawOpts) => {
+        (0, shared_1.rejectCliOverride)(cmd, "appId");
+        await (0, index_1.handleDeployHistory)({
+            appId: rawOpts.appId,
+            status: rawOpts.status,
+            since: rawOpts.since,
+            until: rawOpts.until,
+            limit: rawOpts.limit,
+            cursor: rawOpts.cursor,
+        });
+    }));
+}
+function registerDeployErrorLog(parent) {
+    const cmd = parent
+        .command("error-log")
+        .description("查询指定发布的错误日志")
+        .argument("<deploy-id>", "发布单 ID")
+        .addOption((0, shared_1.appIdOption)().hideHelp())
+        .addHelpText("after", `
+JSON 输出
+  {"data": [{"jobID": ..., "componentName": ..., "errorMsg": ...}], "next_cursor": null, "has_more": false}
+
+示例
+  $ miaoda deploy error-log 12345 --json
+`);
+    cmd.action((0, shared_1.withHelp)(cmd, async (deployId, rawOpts) => {
+        (0, shared_1.rejectCliOverride)(cmd, "appId");
+        await (0, index_1.handleDeployErrorLog)({
+            deployId,
+            appId: rawOpts.appId,
+        });
+    }));
+}
+function parseLimit(value) {
+    const n = Number(value);
+    if (!Number.isFinite(n)) {
+        throw new Error(`--limit 必须是数字，收到 '${value}'`);
+    }
+    return n;
+}
+function parseTimeout(value) {
+    const n = Number(value);
+    if (!Number.isFinite(n) || n <= 0) {
+        throw new Error(`--timeout 必须是正数，收到 '${value}'`);
+    }
+    return n;
+}

package/dist/cli/commands/index.js

@@ -4,8 +4,14 @@ exports.registerCommands = registerCommands;
 const index_1 = require("../../cli/commands/plugin/index");
 const index_2 = require("../../cli/commands/file/index");
 const index_3 = require("../../cli/commands/db/index");
+const index_4 = require("../../cli/commands/observability/index");
+const index_5 = require("../../cli/commands/app/index");
+const index_6 = require("../../cli/commands/deploy/index");
 function registerCommands(program) {
     (0, index_1.registerPluginCommands)(program);
     (0, index_2.registerFileCommands)(program);
     (0, index_3.registerDbCommands)(program);
+    (0, index_4.registerObservabilityCommands)(program);
+    (0, index_5.registerAppCommands)(program);
+    (0, index_6.registerDeployCommands)(program);
 }

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

@@ -0,0 +1,227 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerObservabilityCommands = registerObservabilityCommands;
+const commander_1 = require("commander");
+const shared_1 = require("../../../cli/commands/shared");
+const index_1 = require("../../../cli/handlers/observability/index");
+const COMMON_TIME_HELP = `
+时间格式：
+  - 相对时间：1h（1 小时前）、2d（2 天前）、1w（1 周前）、30m（30 分钟前）
+  - 日期：2026-04-01（按当日 00:00:00 UTC）
+  - ISO 8601：2026-04-01T10:00:00Z
+`;
+function registerObservabilityCommands(program) {
+    const obCmd = program
+        .command("observability")
+        .description("可观测性：查询线上日志、链路、监控指标、运营指标");
+    obCmd.action(() => {
+        obCmd.outputHelp();
+    });
+    obCmd.addHelpText("after", `
+作用范围
+  仅供 Agent 在妙搭沙箱内调用，查询当前应用的线上观测数据。所有命令为只读。
+  应用上下文：--app-id <id> 或环境变量 MIAODA_APP_ID。
+
+应用环境
+  log/trace 命令需要 --env <dev|online>，默认 online，可设置 MIAODA_APP_ENV 覆盖。
+  metric/analytics 不需要 --env。
+`);
+    registerLog(obCmd);
+    registerTrace(obCmd);
+    registerMetric(obCmd);
+    registerAnalytics(obCmd);
+}
+// ── log ──
+function registerLog(parent) {
+    const cmd = parent
+        .command("log")
+        .description("查询线上运行日志（按时间倒序，分页）")
+        .addOption((0, shared_1.appIdOption)().hideHelp())
+        .addOption(new commander_1.Option("--level <level>", "日志级别").choices(["DEBUG", "INFO", "WARN", "ERROR"]))
+        .option("--since <time>", "开始时间")
+        .option("--until <time>", "截止时间")
+        .option("--trace-id <id>", "按 trace ID 过滤")
+        .option("--grep <pattern>", "按关键字模糊搜索 body")
+        .option("--module <name>", "按模块名过滤")
+        .option("--user-id <user-id>", "按触发用户 ID 过滤")
+        .option("--page <path>", "按页面路径过滤")
+        .option("--api <path>", "按接口路径过滤")
+        .option("--min-duration <ms>", "最小耗时过滤（毫秒）")
+        .option("--max-duration <ms>", "最大耗时过滤（毫秒）")
+        .option("--limit <n>", "返回条数上限（1~100）", parseLimit, 50)
+        .option("--cursor <token>", "下一页游标，从上一次返回的 next_cursor 取值")
+        .addHelpText("after", `${COMMON_TIME_HELP}
+JSON 输出
+  {"data": [...], "next_cursor": "...", "has_more": true|false}
+
+示例
+  $ miaoda observability log --since 1h --level error --json
+  $ miaoda observability log --trace-id 140ebb5ac9b... --json
+  $ miaoda observability log --api /api/orders --min-duration 200 --json
+`);
+    cmd.action((0, shared_1.withHelp)(cmd, async (rawOpts) => {
+        (0, shared_1.rejectCliOverride)(cmd, "appId");
+        await (0, index_1.handleObservabilityLog)({
+            appId: rawOpts.appId,
+            level: rawOpts.level,
+            since: rawOpts.since,
+            until: rawOpts.until,
+            traceId: rawOpts.traceId,
+            grep: rawOpts.grep,
+            module: rawOpts.module,
+            userId: rawOpts.userId,
+            page: rawOpts.page,
+            api: rawOpts.api,
+            minDuration: rawOpts.minDuration,
+            maxDuration: rawOpts.maxDuration,
+            limit: rawOpts.limit,
+            cursor: rawOpts.cursor,
+        });
+    }));
+}
+// ── trace ──
+function registerTrace(parent) {
+    const traceCmd = parent.command("trace").description("链路追踪：列表 / 详情");
+    traceCmd.action(() => {
+        traceCmd.outputHelp();
+    });
+    const listCmd = traceCmd
+        .command("list")
+        .description("查询线上链路列表（按链路时间倒序，分页）")
+        .addOption((0, shared_1.appIdOption)().hideHelp())
+        .option("--since <time>", "开始时间")
+        .option("--until <time>", "截止时间")
+        .option("--trace-id <id>", "按 trace ID 过滤")
+        .option("--root-span <span-name>", "按入口节点关键词过滤")
+        .option("--user-id <user-id>", "按触发用户 ID 过滤")
+        .option("--limit <n>", "返回条数上限（1~100）", parseLimit, 50)
+        .option("--cursor <token>", "下一页游标")
+        .addHelpText("after", `${COMMON_TIME_HELP}
+JSON 输出
+  {"data": [...], "next_cursor": "...", "has_more": true|false}
+
+示例
+  $ miaoda observability trace list --since 1h --json
+  $ miaoda observability trace list --root-span api-gateway --limit 20 --json
+`);
+    listCmd.action((0, shared_1.withHelp)(listCmd, async (rawOpts) => {
+        (0, shared_1.rejectCliOverride)(listCmd, "appId");
+        await (0, index_1.handleObservabilityTraceList)({
+            appId: rawOpts.appId,
+            since: rawOpts.since,
+            until: rawOpts.until,
+            traceId: rawOpts.traceId,
+            rootSpan: rawOpts.rootSpan,
+            userId: rawOpts.userId,
+            limit: rawOpts.limit,
+            cursor: rawOpts.cursor,
+        });
+    }));
+    const getCmd = traceCmd
+        .command("get")
+        .description("查询指定链路的完整详情")
+        .argument("<trace-id>", "链路 ID")
+        .addOption((0, shared_1.appIdOption)().hideHelp())
+        .option("--with-log-severity-count", "返回每个 Span 各日志级别的数量", false)
+        .addHelpText("after", `
+JSON 输出
+  {"data": {"spans": [...], "isBreak": false}}
+
+示例
+  $ miaoda observability trace get 140ebb5ac9b55ed50d6ed1090cad4d --json
+
+  # 报错：链路不存在
+  $ miaoda observability trace get not-exist
+  Error: Failed to get trace: 500 ...
+    hint: 检查 trace-id 是否正确，或链路已超出保留时长
+`);
+    getCmd.action((0, shared_1.withHelp)(getCmd, async (traceId, rawOpts) => {
+        (0, shared_1.rejectCliOverride)(getCmd, "appId");
+        await (0, index_1.handleObservabilityTraceGet)({
+            traceId,
+            appId: rawOpts.appId,
+            withLogSeverityCount: rawOpts.withLogSeverityCount,
+        });
+    }));
+}
+// ── metric ──
+function registerMetric(parent) {
+    const cmd = parent
+        .command("metric")
+        .description("查询监控指标：requests / latency / cpu / memory")
+        .argument("<metric-name>", "指标名：requests | latency | cpu | memory")
+        .addOption((0, shared_1.appIdOption)().hideHelp())
+        .option("--page <path>", "按页面路径过滤（仅对 requests/latency 生效）")
+        .option("--api <path>", "按接口路径过滤（仅对 requests/latency 生效）")
+        .option("--series <name>", "过滤图表中的某条线：latency 取 p50/p99；requests 取 total/error；缺省返回所有相关线")
+        .option("--since <time>", "开始时间")
+        .option("--until <time>", "截止时间")
+        .addOption(new commander_1.Option("--down-sample <duration>", "降采样粒度（1m=1分钟 / 1h=1小时 / 1d=1天）")
+        .choices(["1m", "1h", "1d"])
+        .default("1h"))
+        .addHelpText("after", `${COMMON_TIME_HELP}
+JSON 输出
+  {"data": [{"metricName": "...", "dimensions": {...}, "dataPoints": [...]}], "next_cursor": null, "has_more": false}
+
+示例
+  $ miaoda observability metric latency --since 1h --json
+  $ miaoda observability metric latency --since 1h --series p99 --json
+  $ miaoda observability metric requests --api /api/users --json
+  $ miaoda observability metric cpu --since 1d --down-sample 1d --json
+`);
+    cmd.action((0, shared_1.withHelp)(cmd, async (metricName, rawOpts) => {
+        (0, shared_1.rejectCliOverride)(cmd, "appId");
+        await (0, index_1.handleObservabilityMetric)({
+            metricName,
+            appId: rawOpts.appId,
+            page: rawOpts.page,
+            api: rawOpts.api,
+            series: rawOpts.series,
+            since: rawOpts.since,
+            until: rawOpts.until,
+            downSample: rawOpts.downSample,
+        });
+    }));
+}
+// ── analytics ──
+function registerAnalytics(parent) {
+    const cmd = parent
+        .command("analytics")
+        .description("查询运营指标：users（用户数）/ page-view（页面访问）")
+        .argument("<analytics-name>", "指标名：users | page-view")
+        .addOption((0, shared_1.appIdOption)().hideHelp())
+        .option("--page <path>", "按页面路径过滤（仅对 page-view 生效）")
+        .option("--series <name>", "过滤图表中的某条线：users 取 active-users/new-users/total-users；page-view 取 all-view/desktop-view/mobile-view；缺省返回所有相关线")
+        .option("--since <time>", "开始时间")
+        .option("--until <time>", "截止时间")
+        .option("--granularity <duration>", "时间粒度：day | week | month", "day")
+        .addHelpText("after", `${COMMON_TIME_HELP}
+JSON 输出
+  {"data": [{"metricType": "...", "points": [{"timestampNs": "...", "value": ..., "dimensions": {...}}]}], "next_cursor": null, "has_more": false}
+
+示例
+  $ miaoda observability analytics users --json                      # 同时返回 active/new/total 三条线
+  $ miaoda observability analytics users --series new-users --since 7d --json
+  $ miaoda observability analytics page-view --granularity week --json
+`);
+    cmd.action((0, shared_1.withHelp)(cmd, async (analyticsName, rawOpts) => {
+        (0, shared_1.rejectCliOverride)(cmd, "appId");
+        await (0, index_1.handleObservabilityAnalytics)({
+            analyticsName,
+            appId: rawOpts.appId,
+            env: rawOpts.env,
+            page: rawOpts.page,
+            series: rawOpts.series,
+            since: rawOpts.since,
+            until: rawOpts.until,
+            granularity: rawOpts.granularity,
+        });
+    }));
+}
+function parseLimit(value) {
+    const n = Number(value);
+    if (!Number.isFinite(n)) {
+        throw new Error(`--limit 必须是数字，收到 '${value}'`);
+    }
+    return n;
+}

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

@@ -58,7 +58,9 @@ JSON 输出
   Error: Invalid plugin name format: bad-name. Expected: @scope/name or @scope/name@version
     hint: 示例：@demo/example-plugin 或 @demo/example-plugin@1.2.3
 `)
-        .action(async (names) => { await (0, index_1.handlePluginInstall)({ names }); });
+        .action(async (names) => {
+        await (0, index_1.handlePluginInstall)({ names });
+    });
     pluginCmd
         .command("update")
         .description("把已安装插件升级到 latest 版本")
@@ -91,7 +93,9 @@ JSON 输出
   $ miaoda plugin update @demo/not-installed --json
   {"updated":[],"skipped":[],"notInstalled":["@demo/not-installed"],"failed":[]}
 `)
-        .action(async (names) => { await (0, index_1.handlePluginUpdate)({ names }); });
+        .action(async (names) => {
+        await (0, index_1.handlePluginUpdate)({ names });
+    });
     pluginCmd
         .command("remove")
         .description("从当前项目移除一个已安装的插件")
@@ -115,7 +119,9 @@ JSON 输出
   Error: Plugin @demo/not-installed is not installed
     hint: 运行 miaoda plugin list-packages 查看已安装插件
 `)
-        .action((name) => { (0, index_1.handlePluginRemove)({ name }); });
+        .action((name) => {
+        (0, index_1.handlePluginRemove)({ name });
+    });
     pluginCmd
         .command("init")
         .description("按 package.json 的 actionPlugins 批量安装所有插件")
@@ -146,7 +152,9 @@ JSON 输出
   Error: package.json not found in current directory
     hint: 在应用项目根目录运行
 `)
-        .action(async () => { await (0, index_1.handlePluginInit)(); });
+        .action(async () => {
+        await (0, index_1.handlePluginInit)();
+    });
     pluginCmd
         .command("list")
         .description("列出当前项目的 capability 实例（./server/capabilities/*.json）")
@@ -178,7 +186,9 @@ JSON 输出
   Error: server/capabilities directory not found
     hint: 当前目录必须是含 server/capabilities/ 的应用项目
 `)
-        .action(async (opts) => { await (0, index_1.handlePluginList)(opts); });
+        .action(async (opts) => {
+        await (0, index_1.handlePluginList)(opts);
+    });
     pluginCmd
         .command("list-packages")
         .description("列出 package.json actionPlugins 里已声明的插件包")
@@ -201,5 +211,7 @@ JSON 输出
   Error: package.json not found in current directory
     hint: 在应用项目根目录运行
 `)
-        .action(() => { (0, index_1.handlePluginListPlugins)(); });
+        .action(() => {
+        (0, index_1.handlePluginListPlugins)();
+    });
 }

package/dist/cli/commands/shared.js

@@ -1,11 +1,21 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.appIdOption = appIdOption;
+exports.branchOption = branchOption;
 exports.softRequiredOption = softRequiredOption;
 exports.resolveAppId = resolveAppId;
 exports.withHelp = withHelp;
 exports.failArgs = failArgs;
+exports.rejectCliOverride = rejectCliOverride;
 const commander_1 = require("commander");
 const error_1 = require("../../utils/error");
+/** --app-id option，需要应用上下文的命令自行 .addOption(appIdOption()) */
+function appIdOption() {
+    return new commander_1.Option("--app-id <id>", "指定目标应用").env("MIAODA_APP_ID");
+}
+function branchOption() {
+    return new commander_1.Option("--branch <branch>", "分支（优先级：--branch > 当前仓库 HEAD 分支；非 git 目录回退应用默认分支）").env("LOCAL_MOCK_MIAODA_DEPLOY_BRANCH");
+}
 /**
  * soft-required: Commander 类型上 optional，runtime 校验必填。
  */
@@ -22,18 +32,20 @@ function resolveAppId(opts) {
     const id = opts.appId ?? process.env.MIAODA_APP_ID ?? process.env.app_id;
     if (!id) {
         throw new error_1.AppError("APP_ID_MISSING", "未指定应用", {
-            next_actions: [
-                "设置 export MIAODA_APP_ID=<id>",
-            ],
+            next_actions: ["设置 export MIAODA_APP_ID=<id>"],
         });
     }
     return id;
 }
-/** 包裹 handler，缺 soft-required 参数时打 help 并退出 */
+/**
+ * 包裹 handler，缺 soft-required 参数 / 自定义校验失败时打 help 并退出。
+ *
+ * 兼容带位置参数的 action 签名（如 `(arg1: string, opts) => ...`）。
+ */
 function withHelp(cmd, handler) {
-    return async (opts) => {
+    return async (...args) => {
         try {
-            await handler(opts);
+            await handler(...args);
         }
         catch (err) {
             if (err instanceof error_1.AppError && err.code === "ARGS_INVALID") {
@@ -50,3 +62,23 @@ function withHelp(cmd, handler) {
 function failArgs(message) {
     throw new error_1.AppError("ARGS_INVALID", message);
 }
+/**
+ * 拒绝 CLI 显式覆盖：用于 hideHelp() + .env() 的"沙箱注入参数"（如 --app-id / --branch）。
+ *
+ * Commander 的 getOptionValueSource() 区分来源（cli / env / default / config / undefined）；
+ * 用户在 CLI 上显式传时 source === "cli"，此时抛 ARGS_INVALID（exit 2 + help）。
+ *
+ * 用法：在 action 头部一行调用——
+ *   cmd.action(withHelp(cmd, async (rawOpts) => {
+ *     rejectCliOverride(cmd, "appId", "branch");
+ *     ...
+ *   }));
+ */
+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} 由沙箱/本地配置注入，不允许显式传递`);
+        }
+    }
+}

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

@@ -0,0 +1,48 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+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 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);
+}

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

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleAppUpdate = exports.handleAppGet = void 0;
+var get_1 = require("./get");
+Object.defineProperty(exports, "handleAppGet", { enumerable: true, get: function () { return get_1.handleAppGet; } });
+var update_1 = require("./update");
+Object.defineProperty(exports, "handleAppUpdate", { enumerable: true, get: function () { return update_1.handleAppUpdate; } });

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

@@ -0,0 +1,59 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+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 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 中的一个");
+    }
+    const appID = (0, shared_1.resolveAppId)({ appId: opts.appId });
+    await api.app.updateAppMeta({
+        appID,
+        name: opts.name,
+        description: opts.description,
+    });
+    // 服务端不回写新 meta，本地再 fetch 一次拿最新值给用户
+    const resp = await api.app.getAppInfo(appID);
+    const meta = resp.appInfo?.appMeta ?? {};
+    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);
+}