@lark-apaas/miaoda-cli 0.1.2 → 0.1.3

package/dist/cli/commands/shared.js

@@ -1,11 +1,26 @@
 "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");
+}
+function branchOption() {
+    return new commander_1.Option("--branch <branch>", "分支（优先级：--branch > 当前仓库 HEAD 分支；非 git 目录回退应用默认分支）").env("LOCAL_MOCK_MIAODA_DEPLOY_BRANCH");
+}
 /**
  * soft-required: Commander 类型上 optional，runtime 校验必填。
  */
@@ -27,11 +42,15 @@ function resolveAppId(opts) {
     }
     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") {
@@ -44,7 +63,64 @@ function withHelp(cmd, handler) {
         }
     };
 }
-/** 参数校验失败时抛出，配合 withHelp 自动打 help */
-function failArgs(message) {
-    throw new error_1.AppError("ARGS_INVALID", message);
+/**
+ * 大小写不敏感的 choice argParser：把用户输入按 lowerCase 匹配回 canonical 数组里
+ * 的同名值（保留 canonical 大小写），未命中抛 Commander 的 InvalidArgumentError
+ * （exit code 1，自带友好错误）。
+ *
+ * 必须先 .choices(canonical)、再 .argParser()——Commander 内部 .choices() 会
+ * 重置 parseArg，反过来调会让 argParser 失效。.choices() 仅留给 help 渲染
+ * "choices: A, B, C"，实际白名单校验由 argParser 接管。
+ *
+ *   new Option("--level <level>", "日志级别（不区分大小写）")
+ *     .choices(["DEBUG", "INFO", "WARN", "ERROR"])
+ *     .argParser(caseInsensitiveChoice(["DEBUG", "INFO", "WARN", "ERROR"]));
+ */
+function caseInsensitiveChoice(canonical) {
+    const map = new Map(canonical.map((v) => [v.toLowerCase(), v]));
+    return (raw) => {
+        const hit = map.get(raw.toLowerCase());
+        if (hit === undefined) {
+            throw new commander_1.InvalidArgumentError(`Allowed choices are ${canonical.join(", ")} (case-insensitive).`);
+        }
+        return hit;
+    };
+}
+/**
+ * --since / --until 等时间参数的 action 阶段校验。
+ *
+ * Commander 的 argParser 会在 action 前直接按 parser error 退出（exit 1），
+ * 绕过 withHelp 的 ARGS_INVALID → exit 2 路径；所以时间参数在 action 内先
+ * 校验一遍，再把原始字符串交给 handler 解析成接口需要的单位。
+ */
+function validateTimeOptions(opts, ...names) {
+    for (const name of names) {
+        const value = opts[name];
+        if (value === undefined)
+            continue;
+        if (typeof value !== "string") {
+            (0, args_1.failArgs)(`--${name.replace(/([A-Z])/g, "-$1").toLowerCase()} 必须是时间字符串`);
+        }
+        (0, time_1.parseTimeToMs)(value);
+    }
+}
+/**
+ * 拒绝 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();
+            (0, args_1.failArgs)(`${flag} 由沙箱/本地配置注入，不允许显式传递`);
+        }
+    }
 }

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

@@ -0,0 +1,47 @@
+"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 index_1 = require("../../../api/app/index");
+/** miaoda app get [--app-id <id>] */
+async function handleAppGet(opts) {
+    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 }, 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 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, args_1.failArgs)("至少需要 --name 或 --description 中的一个");
+    }
+    const 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 }, 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

@@ -0,0 +1,84 @@
+"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.handleDeploy = handleDeploy;
+const api = __importStar(require("../../../api/index"));
+const output_1 = require("../../../utils/output");
+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 = 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 },
+            next_cursor: null,
+            has_more: false,
+        });
+        return;
+    }
+    if (!(0, output_1.isJsonMode)()) {
+        process.stdout.write(`Waiting for deployment to complete... (deploy-id: ${pipelineTaskID})\n`);
+    }
+    const detail = await (0, polling_1.waitForPipeline)({
+        appID,
+        pipelineTaskID,
+        timeoutSec: opts.timeout ?? 300,
+    });
+    if (!(0, output_1.isJsonMode)()) {
+        if (detail.status === index_1.NodeStatus.SUCCESS) {
+            process.stdout.write("✓ 发布成功\n");
+        }
+        else if (detail.status === index_1.NodeStatus.FAILED) {
+            process.stdout.write("✗ 发布失败\n");
+            process.stdout.write(`  hint: Run \`miaoda deploy error-log ${pipelineTaskID}\` to view error logs\n`);
+        }
+        else {
+            process.stdout.write("• 发布已取消\n");
+        }
+    }
+    (0, output_1.emit)({
+        data: { pipelineTaskID, detail: (0, format_1.formatPipelineInstance)(detail) },
+        next_cursor: null,
+        has_more: false,
+    });
+}

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

@@ -0,0 +1,60 @@
+"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.handleDeployErrorLog = handleDeployErrorLog;
+const api = __importStar(require("../../../api/index"));
+const output_1 = require("../../../utils/output");
+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, 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 });
+    (0, output_1.emit)({
+        data: resp.errorJobs,
+        next_cursor: null,
+        has_more: false,
+    }, index_1.errorJobSchema);
+    // pretty 模式额外打一行整体状态。
+    if (!process.stdout.isTTY)
+        return;
+    const statusText = (0, index_1.nodeStatusText)(resp.status) ?? String(resp.status);
+    process.stdout.write(`\n— pipeline status: ${statusText}\n`);
+}

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

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatStatusMetadata = formatStatusMetadata;
+exports.formatSimpleInstance = formatSimpleInstance;
+exports.formatPipelineInstance = formatPipelineInstance;
+const index_1 = require("../../../api/deploy/index");
+function formatStatusMetadata(statusCode) {
+    return {
+        status: (0, index_1.nodeStatusText)(statusCode) ?? `unknown(${String(statusCode)})`,
+        status_code: statusCode,
+    };
+}
+function formatSimpleInstance(instance) {
+    if (instance.status === undefined)
+        return { ...instance };
+    return {
+        ...instance,
+        ...formatStatusMetadata(instance.status),
+    };
+}
+function formatPipelineInstance(detail) {
+    const stages = Array.isArray(detail.stages) ? detail.stages : [];
+    return {
+        ...detail,
+        ...formatStatusMetadata(detail.status),
+        stages: stages.map((stage) => ({
+            ...stage,
+            ...formatStatusMetadata(stage.status),
+            jobs: stage.jobs.map((group) => group.map((job) => ({
+                ...job,
+                ...formatStatusMetadata(job.status),
+                steps: job.steps?.map((step) => ({
+                    ...step,
+                    ...formatStatusMetadata(step.status),
+                })),
+            }))),
+        })),
+    };
+}

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

@@ -0,0 +1,71 @@
+"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.handleDeployGet = handleDeployGet;
+const api = __importStar(require("../../../api/index"));
+const output_1 = require("../../../utils/output");
+const args_1 = require("../../../utils/args");
+const error_1 = require("../../../utils/error");
+const index_1 = require("../../../api/deploy/index");
+const helpers_1 = require("./helpers");
+const format_1 = require("./format");
+/**
+ * 单页拉取上限：BAM listPipelineInstances 限制 1~500，取 500 让 deploy get
+ * 在最近 500 条记录里按 ID 命中。
+ */
+const DEPLOY_GET_LOOKUP_LIMIT = 500;
+/**
+ * miaoda deploy get <deploy-id>
+ *
+ * BAM 没有 by-ID 的查询接口，复用 listPipelineInstances 在最近窗口里按 ID 筛一条。
+ * 命中失败时抛 DEPLOY_NOT_FOUND，提示用户用 history 查窗口。
+ */
+async function handleDeployGet(opts) {
+    if (!opts.deployId)
+        (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,
+        limit: DEPLOY_GET_LOOKUP_LIMIT,
+    });
+    const instance = resp.instances?.find((it) => Number(it.ID) === deployId);
+    if (!instance) {
+        throw new error_1.AppError("DEPLOY_NOT_FOUND", `未在最近 ${String(DEPLOY_GET_LOOKUP_LIMIT)} 条记录中找到 deploy-id=${opts.deployId}`, {
+            next_actions: ["运行 `miaoda deploy history` 确认 deploy-id 是否在最近窗口内"],
+        });
+    }
+    (0, output_1.emit)({ data: (0, format_1.formatSimpleInstance)(instance), next_cursor: null, has_more: false }, index_1.deployGetSchema);
+}

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

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseStatusFlag = parseStatusFlag;
+exports.validateLimit = validateLimit;
+exports.parseDeployId = parseDeployId;
+const args_1 = require("../../../utils/args");
+const index_1 = require("../../../api/deploy/index");
+/**
+ * 把 CLI --status 字符串映射成 BAM NodeStatus 数字；非法值抛 ARGS_INVALID。
+ *
+ * 历史接口（CliListPipelineInstances）返回 SimpleInstance，状态语义是 pipeline 节点状态，
+ * 取值 todo / running / success / failed / canceled / hold_on。
+ */
+function parseStatusFlag(text) {
+    const value = (0, index_1.nodeStatusFromText)(text);
+    if (value === undefined) {
+        (0, args_1.failArgs)(`--status 无效：'${text}'。可选值：todo | running | success | failed | canceled | hold_on`);
+    }
+    return value;
+}
+/** limit/pageSize 校验（API 限制 1~100） */
+function validateLimit(limit, defaultLimit = 50) {
+    const n = Number.isFinite(limit) ? limit : defaultLimit;
+    if (n <= 0 || n > 100) {
+        (0, args_1.failArgs)(`--limit 必须在 1~100 之间，收到 ${String(n)}`);
+    }
+    return n;
+}
+/**
+ * 把 CLI <deploy-id> 字符串转成 i64 number。
+ *
+ * 语义上 deploy-id 即 pipelineTaskID（pipeline 实例 ID）；BAM CLIGetReleaseLogs
+ * IDL 历史命名为 releaseID，但传入的就是这同一个值。
+ */
+function parseDeployId(text) {
+    const n = Number(text);
+    if (!Number.isFinite(n) || !/^\d+$/.test(text)) {
+        (0, args_1.failArgs)(`<deploy-id> 必须是数字 ID，收到 '${text}'`);
+    }
+    return n;
+}

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

@@ -0,0 +1,70 @@
+"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.handleDeployHistory = handleDeployHistory;
+const api = __importStar(require("../../../api/index"));
+const output_1 = require("../../../utils/output");
+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 = opts.appId;
+    const limit = (0, helpers_1.validateLimit)(opts.limit ?? 50);
+    const req = {
+        appID,
+        limit,
+        pageToken: opts.cursor,
+    };
+    if (opts.status)
+        req.status = [(0, helpers_1.parseStatusFlag)(opts.status)];
+    // BAM startTimestamp / endTimestamp 单位是秒（IDL desc：单位：秒）
+    if (opts.since !== undefined)
+        req.startTimestamp = msToSec((0, time_1.parseToMs)(opts.since));
+    if (opts.until !== undefined)
+        req.endTimestamp = msToSec((0, time_1.parseToMs)(opts.until));
+    const resp = await api.deploy.listPipelineInstances(req);
+    (0, output_1.emit)({
+        data: (resp.instances ?? []).map(format_1.formatSimpleInstance),
+        next_cursor: resp.hasMore ? (resp.nextPageToken ?? null) : null,
+        has_more: resp.hasMore ?? false,
+    }, index_1.deployHistorySchema);
+}
+function msToSec(ms) {
+    if (ms === undefined)
+        return undefined;
+    return Math.floor(ms / 1000);
+}