@lark-apaas/miaoda-cli 0.1.2 → 0.1.3-alpha.4bf312e

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);
+}

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

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_POLL_INTERVAL_MS = exports.waitForPipeline = exports.handleDeployErrorLog = exports.handleDeployHistory = exports.handleDeployGet = exports.handleDeploy = void 0;
+var deploy_1 = require("./deploy");
+Object.defineProperty(exports, "handleDeploy", { enumerable: true, get: function () { return deploy_1.handleDeploy; } });
+var get_1 = require("./get");
+Object.defineProperty(exports, "handleDeployGet", { enumerable: true, get: function () { return get_1.handleDeployGet; } });
+var history_1 = require("./history");
+Object.defineProperty(exports, "handleDeployHistory", { enumerable: true, get: function () { return history_1.handleDeployHistory; } });
+var error_log_1 = require("./error-log");
+Object.defineProperty(exports, "handleDeployErrorLog", { enumerable: true, get: function () { return error_log_1.handleDeployErrorLog; } });
+var polling_1 = require("./polling");
+Object.defineProperty(exports, "waitForPipeline", { enumerable: true, get: function () { return polling_1.waitForPipeline; } });
+Object.defineProperty(exports, "DEFAULT_POLL_INTERVAL_MS", { enumerable: true, get: function () { return polling_1.DEFAULT_POLL_INTERVAL_MS; } });

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

@@ -0,0 +1,162 @@
+"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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_POLL_INTERVAL_MS = void 0;
+exports.waitForPipeline = waitForPipeline;
+const ora_1 = __importDefault(require("ora"));
+const api = __importStar(require("../../../api/index"));
+const error_1 = require("../../../utils/error");
+const output_1 = require("../../../utils/output");
+const index_1 = require("../../../api/deploy/index");
+/** 默认轮询间隔（毫秒） */
+exports.DEFAULT_POLL_INTERVAL_MS = 2_000;
+const TERMINAL_STATUSES = [
+    index_1.NodeStatus.SUCCESS,
+    index_1.NodeStatus.FAILED,
+    index_1.NodeStatus.CANCELED,
+];
+function defaultSleep(ms) {
+    return new Promise((res) => setTimeout(res, ms));
+}
+/**
+ * 轮询 pipeline 状态直到终态或超时。
+ *
+ * - JSON 模式：轮询期间静默；终态后由 caller 输出最终信封。
+ * - Pretty 非 TTY：同 JSON。
+ * - Pretty TTY：底部行用 braille spinner 显示当前正在跑的 stage（每 80ms 跳一帧），
+ *   stage 转终态时把 ✓ stage(12.3s) 打到 spinner 上方然后清掉 spinner 行。
+ *
+ * 终态返回最终 PipelineInstance，调用方再决定怎么 emit。
+ */
+async function waitForPipeline(opts) {
+    const interval = opts.intervalMs ?? exports.DEFAULT_POLL_INTERVAL_MS;
+    const timeoutMs = opts.timeoutSec * 1000;
+    const sleep = opts.sleep ?? defaultSleep;
+    const now = opts.now ?? Date.now;
+    const start = now();
+    // ora 自身在非 TTY 下会降级为不动画，但我们额外加 isJsonMode 闸门：JSON / 字段选择
+    // 模式下完全静默。
+    const showProgress = !(0, output_1.isJsonMode)() && process.stdout.isTTY;
+    const printedStages = new Set();
+    const spinner = showProgress
+        ? (0, ora_1.default)({ text: "等待调度", spinner: "dots", stream: process.stdout }).start()
+        : null;
+    try {
+        for (;;) {
+            const resp = await api.deploy.queryPipelineInstance({
+                appID: opts.appID,
+                instanceID: opts.pipelineTaskID,
+            });
+            const detail = normalizePipelineInstance(resp);
+            if (spinner)
+                advanceProgress(detail, printedStages, spinner);
+            if (TERMINAL_STATUSES.includes(detail.status)) {
+                return detail;
+            }
+            if (now() - start >= timeoutMs) {
+                throw new error_1.AppError("DEPLOY_TIMEOUT", `轮询发布状态超时（${String(opts.timeoutSec)}s）`, {
+                    retryable: true,
+                    next_actions: [
+                        `Run \`miaoda deploy get <deploy-id>\` 查看最新状态`,
+                        `加大 --timeout 后重试`,
+                    ],
+                });
+            }
+            await sleep(interval);
+        }
+    }
+    finally {
+        spinner?.stop();
+    }
+}
+/**
+ * 每轮 poll 的进度推进：刚转终态的 stage 用 stopAndPersist 落定为永久行，
+ * 再把 spinner 文本切到当前 running stage；没有 running 时显示"等待调度"。
+ */
+function advanceProgress(detail, printed, spinner) {
+    const stages = Array.isArray(detail.stages) ? detail.stages : [];
+    for (const stage of stages) {
+        if (printed.has(stage.id))
+            continue;
+        if (!TERMINAL_STATUSES.includes(stage.status))
+            continue;
+        spinner.stopAndPersist({
+            symbol: stageSymbol(stage),
+            text: formatStageBody(stage),
+        });
+        printed.add(stage.id);
+    }
+    const running = stages.find((s) => s.status === index_1.NodeStatus.RUNNING);
+    const text = running ? `${running.name} 执行中` : "等待调度";
+    if (spinner.isSpinning) {
+        spinner.text = text;
+    }
+    else {
+        spinner.start(text);
+    }
+}
+function normalizePipelineInstance(resp) {
+    const keyedDetail = readPipelineDetail(resp, "pipelineInstanceDetail") ?? readPipelineDetail(resp, "detail");
+    if (keyedDetail)
+        return keyedDetail;
+    if (isPipelineInstance(resp))
+        return resp;
+    throw new error_1.AppError("DEPLOY_RESPONSE_INVALID", "发布状态响应缺少 pipeline detail", {
+        next_actions: ["使用 --verbose 重试以查看请求 logid，并联系平台排查响应结构"],
+    });
+}
+function readPipelineDetail(resp, key) {
+    if (!(key in resp))
+        return undefined;
+    const detail = resp[key];
+    return isPipelineInstance(detail) ? detail : undefined;
+}
+function isPipelineInstance(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const item = value;
+    return typeof item.status === "number";
+}
+function stageSymbol(stage) {
+    return stage.status === index_1.NodeStatus.SUCCESS ? "✓" : stage.status === index_1.NodeStatus.FAILED ? "✗" : "•";
+}
+function formatStageBody(stage) {
+    const cost = stage.costTime >= 0 ? `(${(stage.costTime / 1000).toFixed(1)}s)` : "";
+    const status = (0, index_1.nodeStatusText)(stage.status) ?? String(stage.status);
+    return `${stage.name}${cost ? ` ${cost}` : ""} ${status}`.trim();
+}

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/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.handleFileSign = exports.handleFileRm = exports.handleFileCp = exports.handleFileStat = exports.handleFileLs = void 0;
+exports.handleFileQuota = exports.handleFileSign = exports.handleFileRm = exports.handleFileCp = exports.handleFileStat = exports.handleFileLs = void 0;
 var ls_1 = require("./ls");
 Object.defineProperty(exports, "handleFileLs", { enumerable: true, get: function () { return ls_1.handleFileLs; } });
 var stat_1 = require("./stat");
@@ -11,3 +11,5 @@ var rm_1 = require("./rm");
 Object.defineProperty(exports, "handleFileRm", { enumerable: true, get: function () { return rm_1.handleFileRm; } });
 var sign_1 = require("./sign");
 Object.defineProperty(exports, "handleFileSign", { enumerable: true, get: function () { return sign_1.handleFileSign; } });
+var quota_1 = require("./quota");
+Object.defineProperty(exports, "handleFileQuota", { enumerable: true, get: function () { return quota_1.handleFileQuota; } });

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/quota.js

@@ -0,0 +1,66 @@
+"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.handleFileQuota = handleFileQuota;
+const api = __importStar(require("../../../api/index"));
+const shared_1 = require("../../../cli/commands/shared");
+const output_1 = require("../../../utils/output");
+const render_1 = require("../../../utils/render");
+async function handleFileQuota(opts) {
+    const appId = (0, shared_1.resolveAppId)(opts);
+    const data = await api.file.getStorageQuota({ appId });
+    if ((0, output_1.isJsonMode)()) {
+        // 配额未对接（storageQuotaBytes=0）时，quota / usage_percent 字段都不输出
+        const out = {
+            storageUsedBytes: data.storageUsedBytes,
+            files: data.files,
+        };
+        if (data.storageQuotaBytes > 0) {
+            out.storageQuotaBytes = data.storageQuotaBytes;
+            out.usagePercent = data.usagePercent;
+        }
+        (0, output_1.emitOk)((0, output_1.snakeCaseKeys)(out));
+        return;
+    }
+    // PRD：单行 "Storage: 150 MB / 1 GB (15%)"；配额未对接时只显示 used
+    const tty = (0, render_1.isStdoutTty)();
+    const storageLine = data.storageQuotaBytes > 0
+        ? `${(0, render_1.formatSize)(data.storageUsedBytes)} / ${(0, render_1.formatSize)(data.storageQuotaBytes)} (${data.usagePercent.toFixed(1)}%)`
+        : (0, render_1.formatSize)(data.storageUsedBytes);
+    (0, output_1.emit)((0, render_1.renderKeyValue)([
+        ["Storage", storageLine],
+        ["Files", String(data.files)],
+    ], tty));
+}