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

package/dist/api/deploy/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeStatus = exports.nodeStatusFromText = exports.nodeStatusText = exports.errorJobSchema = exports.deployGetSchema = exports.deployHistorySchema = exports.queryPipelineInstance = exports.getErrorLog = exports.listPipelineInstances = exports.createRelease = void 0;
+var api_1 = require("./api");
+Object.defineProperty(exports, "createRelease", { enumerable: true, get: function () { return api_1.createRelease; } });
+Object.defineProperty(exports, "listPipelineInstances", { enumerable: true, get: function () { return api_1.listPipelineInstances; } });
+Object.defineProperty(exports, "getErrorLog", { enumerable: true, get: function () { return api_1.getErrorLog; } });
+Object.defineProperty(exports, "queryPipelineInstance", { enumerable: true, get: function () { return api_1.queryPipelineInstance; } });
+var schemas_1 = require("./schemas");
+Object.defineProperty(exports, "deployHistorySchema", { enumerable: true, get: function () { return schemas_1.deployHistorySchema; } });
+Object.defineProperty(exports, "deployGetSchema", { enumerable: true, get: function () { return schemas_1.deployGetSchema; } });
+Object.defineProperty(exports, "errorJobSchema", { enumerable: true, get: function () { return schemas_1.errorJobSchema; } });
+Object.defineProperty(exports, "nodeStatusText", { enumerable: true, get: function () { return schemas_1.nodeStatusText; } });
+Object.defineProperty(exports, "nodeStatusFromText", { enumerable: true, get: function () { return schemas_1.nodeStatusFromText; } });
+var types_1 = require("./types");
+Object.defineProperty(exports, "NodeStatus", { enumerable: true, get: function () { return types_1.NodeStatus; } });

package/dist/api/deploy/schemas.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.errorJobSchema = exports.deployGetSchema = exports.deployHistorySchema = void 0;
+exports.nodeStatusText = nodeStatusText;
+exports.nodeStatusFromText = nodeStatusFromText;
+const output_1 = require("../../utils/output");
+const types_1 = require("./types");
+const NODE_STATUS_TEXT = {
+    [types_1.NodeStatus.UNSPECIFIED]: "unknown",
+    [types_1.NodeStatus.TODO]: "todo",
+    [types_1.NodeStatus.RUNNING]: "running",
+    [types_1.NodeStatus.SUCCESS]: "success",
+    [types_1.NodeStatus.FAILED]: "failed",
+    [types_1.NodeStatus.CANCELED]: "canceled",
+    [types_1.NodeStatus.HOLD_ON]: "hold_on",
+};
+function nodeStatusText(v) {
+    if (typeof v !== "number")
+        return undefined;
+    return NODE_STATUS_TEXT[v];
+}
+/** NodeStatus 文本（CLI flag 字符串）→ 枚举数值 */
+function nodeStatusFromText(text) {
+    const lower = text.toLowerCase();
+    for (const [num, label] of Object.entries(NODE_STATUS_TEXT)) {
+        if (label === lower)
+            return Number(num);
+    }
+    return undefined;
+}
+function pipelineDurationMs(row) {
+    // SimpleInstance.createdAt / updatedAt：BAM IDL 未注单位，e2e 看是 ms。
+    const start = Number(row.createdAt);
+    const end = Number(row.updatedAt);
+    if (!Number.isFinite(start) || !Number.isFinite(end))
+        return undefined;
+    return end - start;
+}
+/**
+ * deploy history 列表的 pretty 渲染契约。
+ *
+ * BAM 返回 SimpleInstance（pipeline 实例），状态走 NodeStatus。
+ * 默认列：deploy-id（=ID）/ status / creator / created-at / duration（updatedAt-createdAt）。
+ */
+exports.deployHistorySchema = {
+    columns: [
+        { key: "ID", label: "deploy-id" },
+        {
+            key: "status_text",
+            label: "status",
+            derive: (row) => nodeStatusText(row.status),
+        },
+        { key: "creator", label: "creator" },
+        { key: "createdAt", label: "created-at", format: output_1.fmt.ms() },
+        {
+            key: "duration",
+            label: "duration",
+            format: output_1.fmt.durationMs(),
+            derive: pipelineDurationMs,
+        },
+    ],
+    strict: true,
+};
+/**
+ * deploy get 单条详情的 key-value 渲染契约（基于 SimpleInstance）。
+ *
+ * 由于 BAM 没有 by-ID 的查询接口，handler 用 listPipelineInstances 在最近窗口
+ * 里筛一条 SimpleInstance 透传过来。
+ */
+exports.deployGetSchema = {
+    columns: [
+        { key: "ID", label: "deploy-id" },
+        {
+            key: "status_text",
+            label: "status",
+            derive: (row) => nodeStatusText(row.status),
+        },
+        { key: "creator", label: "creator" },
+        { key: "updater", label: "updater" },
+        { key: "createdAt", label: "created-at", format: output_1.fmt.ms() },
+        { key: "updatedAt", label: "updated-at", format: output_1.fmt.ms() },
+        {
+            key: "duration",
+            label: "duration",
+            format: output_1.fmt.durationMs(),
+            derive: pipelineDurationMs,
+        },
+        { key: "templateID", label: "template" },
+        { key: "description" },
+        { key: "parameters" },
+        { key: "envVariables", label: "env-vars" },
+    ],
+    strict: true,
+};
+/** deploy error-log 表格渲染契约 */
+exports.errorJobSchema = {
+    columns: [
+        { key: "jobID", label: "job-id" },
+        { key: "componentName", label: "component" },
+        { key: "errorMsg", label: "error", format: output_1.fmt.truncate(120) },
+    ],
+    strict: true,
+};

package/dist/api/deploy/types.js

@@ -0,0 +1,22 @@
+"use strict";
+// 与 BAM lark.apaas.devops v1.0.326 / 1.0.327 + lark.apaas.devops_platform v1.0.247 对齐：
+//   - CLICreateForceRelease       (4070318)  创建发布          lark.apaas.devops
+//   - CliQueryPipelineInstance    (4069872)  轮询发布状态      lark.apaas.devops_platform
+//   - CliListPipelineInstances    (4073969)  分页获取发布历史  lark.apaas.devops_platform
+//   - CliGetToolInstanceErrorJobs (4073972)  获取发布错误日志  lark.apaas.devops_platform
+//
+// 发布单的唯一标识是 pipelineTaskID，对外即 deploy-id；error-log 等接口直接用它做
+// URL 路径段（instanceID）。曾经的 Release/releaseID 概念已全面废弃。
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeStatus = void 0;
+/** Pipeline 节点状态（devops_platform） */
+var NodeStatus;
+(function (NodeStatus) {
+    NodeStatus[NodeStatus["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    NodeStatus[NodeStatus["TODO"] = 1] = "TODO";
+    NodeStatus[NodeStatus["RUNNING"] = 2] = "RUNNING";
+    NodeStatus[NodeStatus["SUCCESS"] = 3] = "SUCCESS";
+    NodeStatus[NodeStatus["FAILED"] = 4] = "FAILED";
+    NodeStatus[NodeStatus["CANCELED"] = 5] = "CANCELED";
+    NodeStatus[NodeStatus["HOLD_ON"] = 6] = "HOLD_ON";
+})(NodeStatus || (exports.NodeStatus = NodeStatus = {}));

package/dist/api/file/api.js

@@ -209,9 +209,7 @@ async function resolveInputs(opts) {
         return [];
     return Promise.all(opts.inputs.map((input) => {
         const kind = opts.forceAs ?? ((0, detect_1.looksLikePath)(input) ? "path" : "name");
-        return kind === "path"
-            ? resolveByPath(opts.appId, input)
-            : resolveByName(opts.appId, input);
+        return kind === "path" ? resolveByPath(opts.appId, input) : resolveByName(opts.appId, input);
     }));
 }
 /** path 输入：HEAD 判存在性，path 在 bucket 内 unique 无需反查。 */
@@ -297,14 +295,44 @@ async function preUpload(appId, req) {
     const body = await (0, client_1.doPost)(url, { bucketID: bucketId, appID: appId, ...req }, { errorContext: "pre-upload" });
     return extractEnvelope(body);
 }
+/**
+ * 调用 upload callback 拿到对象元数据。
+ *
+ * 网关 IDL 在 metadata 字段加了 api.response.converter = "decode"，正常路径下
+ * HTTP 响应里的 metadata 已经被网关从字符串解码成对象；这里两种形态都兼容：
+ *   - object → 直接当 CallbackObjectVO 用（网关解码场景）
+ *   - string → JSON.parse 出来用（后端原始形态 / 网关行为变化兜底）
+ *
+ * 解析失败 / metadata 缺失时返回空对象，由 uploadFile 用本地兜底字段填充。
+ */
 async function uploadCallback(appId, req) {
     const url = `/v1/storage/app/${encodeURIComponent(appId)}/object/callback`;
-    const body = await (0, client_1.doPost)(url, req, { errorContext: "upload callback" });
-    (0, client_1.ensureSuccess)(body);
+    const body = await (0, client_1.doPost)(url, req, {
+        errorContext: "upload callback",
+    });
+    const data = extractEnvelope(body);
+    const metadata = data.metadata;
+    if (!metadata) {
+        return {};
+    }
+    if (typeof metadata === "object") {
+        return metadata;
+    }
+    // string 形态兜底
+    try {
+        return JSON.parse(metadata);
+    }
+    catch (err) {
+        (0, logger_1.debug)(`upload callback metadata json parse failed: ${err instanceof Error ? err.message : String(err)}`);
+        return {};
+    }
 }
 /**
  * 上传文件（3 步：preUpload → PUT uploadURL → callback）。
  * PUT 步骤直接 fetch uploadURL（对象存储直传，绕开框架 HttpClient）。
+ *
+ * 注意：opts.remotePath 仅作为目录前缀传给服务端；最终对象 key 由服务端唯一生成
+ * （形如 "<前缀>/<16位ID>.<扩展名>"），从 preUpload 响应的 filePath 字段取回。
  */
 async function uploadFile(opts) {
     const pre = await preUpload(opts.appId, {
@@ -323,11 +351,15 @@ async function uploadFile(opts) {
         // 这里复制到独立 ArrayBuffer 以满足 lib.dom.d.ts 的 BodyInit 约束
         const ab = body.buffer.slice(body.byteOffset, body.byteOffset + body.byteLength);
         const uploadStart = Date.now();
+        // Content-Disposition 用 attachment + filename 编码原始文件名。TOS 会把这个
+        // header 作为对象 metadata 存住，服务端 callback 阶段 HeadObject 读回并解析
+        // filename 写入 DB。我们要不传 header，服务端走兜底会把 storage key 当文件名。
         const res = await fetch(pre.uploadURL, {
             method: "PUT",
             headers: {
                 "Content-Type": opts.contentType,
                 "Content-Length": String(opts.fileSize),
+                "Content-Disposition": `attachment; filename="${sanitizeFileName(opts.fileName)}"`,
             },
             body: ab,
         });
@@ -345,34 +377,56 @@ async function uploadFile(opts) {
     if (!etag) {
         throw new error_1.AppError("FILE_UPLOAD_FAILED", "Upload PUT returned no ETag");
     }
-    // callback 失败仅 warning，文件已经上传到对象存储
+    // callback 返回服务端实际生成的对象元数据（filePath / file_name / download_url）。
+    // path 末段是平台生成的 16 位 GID，CLI 无法靠本地信息推断；callback 失败 /
+    // metadata.filePath 缺失时直接抛 FILE_UPLOAD_CALLBACK_INCOMPLETE：对象已落
+    // TOS（PUT 已成功 + ETag 拿到），但 CLI 拿不到真实 path。把 fileName 写到
+    // hint 里引导用户走 `file ls --name` 查实际 path，避免返一个假 path 让后续
+    // stat/download/rm 全部 FILE_NOT_FOUND。
+    let metadata;
     try {
-        await uploadCallback(opts.appId, { uploadID: pre.uploadID, eTag: etag });
+        metadata = await uploadCallback(opts.appId, { uploadID: pre.uploadID, eTag: etag });
     }
     catch (err) {
-        (0, logger_1.debug)(`upload callback failed: ${err instanceof Error ? err.message : String(err)}`);
+        const reason = err instanceof Error ? err.message : String(err);
+        throw new error_1.AppError("FILE_UPLOAD_CALLBACK_INCOMPLETE", `Upload callback failed: ${reason}; file may already exist in storage`, {
+            next_actions: [
+                `Run \`miaoda file ls --name ${opts.fileName}\` to locate the uploaded file.`,
+            ],
+        });
     }
-    const remotePath = opts.remotePath ?? `/${opts.fileName}`;
+    if (!metadata.filePath) {
+        throw new error_1.AppError("FILE_UPLOAD_CALLBACK_INCOMPLETE", "Upload callback returned no filePath; file may already exist in storage", {
+            next_actions: [
+                `Run \`miaoda file ls --name ${opts.fileName}\` to locate the uploaded file.`,
+            ],
+        });
+    }
+    const path = metadata.filePath.startsWith("/") ? metadata.filePath : "/" + metadata.filePath;
     const result = {
-        file_name: opts.fileName,
-        path: remotePath,
-        size: opts.fileSize,
-        type: opts.contentType,
+        // 优先取服务端 ObjectVO.name（来自 PUT 时带的 Content-Disposition），
+        // 与后续 file ls / file stat 返回的展示名保持一致；缺失时降级用本地 fileName。
+        file_name: metadata.name ?? opts.fileName,
+        path,
+        size: metadata.metadata?.contentLength ?? opts.fileSize,
+        type: metadata.metadata?.mimeType ?? opts.contentType,
     };
-    // 上传完成后补一次 stat，拿到后端返回的 download_url（preUpload/callback 都不返）
-    // 非关键路径：拿不到就降级，只是 JSON 输出里缺 download_url 字段
-    try {
-        const info = await statFile({ appId: opts.appId, filePath: remotePath });
-        if (info.download_url)
-            result.download_url = info.download_url;
-        if (info.file_name)
-            result.file_name = info.file_name;
-    }
-    catch (err) {
-        (0, logger_1.debug)(`post-upload stat failed: ${err instanceof Error ? err.message : String(err)}`);
+    if (metadata.downloadURL) {
+        result.download_url = metadata.downloadURL;
     }
     return result;
 }
+/**
+ * 把文件名清理成可安全放进 Content-Disposition `filename="..."` 的形态。
+ * 与 fullstack-plugin 的 sanitizeFileName 行为一致：
+ *   1. 去掉对 TOS / 文件系统不友好的字符 [: " \ / * ? < > | , ;]
+ *   2. encodeURIComponent 把非 ASCII（中文等）做百分号编码，保证 header 合法
+ *   3. 处理后为空时退回 "download_file" 兜底
+ */
+function sanitizeFileName(fileName) {
+    const illegalChars = /[:"\\/*?<>|,;]/g;
+    return encodeURIComponent(fileName.replace(illegalChars, "")) || "download_file";
+}
 // ── 预签下载 URL ──
 /**
  * 获取预签下载 URL。

package/dist/api/file/client.js

@@ -22,11 +22,7 @@ function traceHttp(method, url, start, response, err) {
         const status = response?.status ?? 0;
         const logid = response?.headers?.get?.("x-tt-logid") ?? "-";
         if (err !== undefined) {
-            const errMsg = err instanceof Error
-                ? err.message
-                : typeof err === "string"
-                    ? err
-                    : JSON.stringify(err);
+            const errMsg = err instanceof Error ? err.message : typeof err === "string" ? err : JSON.stringify(err);
             (0, logger_1.debug)(`http ${method} ${url} ${String(status)} cost=${String(cost)}ms x-tt-logid=${logid} err=${errMsg}`);
             return;
         }

package/dist/api/file/parsers.js

@@ -16,11 +16,7 @@ function int(value) {
 function readSize(meta) {
     if (!meta)
         return 0;
-    const v = meta.size ??
-        meta.fileSize ??
-        meta.file_size ??
-        meta.contentLength ??
-        0;
+    const v = meta.size ?? meta.fileSize ?? meta.file_size ?? meta.contentLength ?? 0;
     return int(v);
 }
 /**

package/dist/api/index.js

@@ -33,10 +33,16 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.db = exports.file = exports.plugin = void 0;
+exports.deploy = exports.app = exports.observability = exports.db = exports.file = exports.plugin = void 0;
 const _plugin = __importStar(require("../api/plugin/index"));
 const _file = __importStar(require("../api/file/index"));
 const _db = __importStar(require("../api/db/index"));
+const _observability = __importStar(require("../api/observability/index"));
+const _app = __importStar(require("../api/app/index"));
+const _deploy = __importStar(require("../api/deploy/index"));
 exports.plugin = { ..._plugin };
 exports.file = { ..._file };
 exports.db = { ..._db };
+exports.observability = { ..._observability };
+exports.app = { ..._app };
+exports.deploy = { ..._deploy };

package/dist/api/observability/api.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.searchLogs = searchLogs;
+exports.searchTraces = searchTraces;
+exports.getTraces = getTraces;
+exports.queryMetricsData = queryMetricsData;
+exports.queryAnalyticsData = queryAnalyticsData;
+const http_1 = require("../../utils/http");
+const DEFAULT_ERR_CODE = "INTERNAL_OB_ERROR";
+// ── 日志 ──
+async function searchLogs(req) {
+    const url = `/v1/observability/app/${encodeURIComponent(req.appID)}/logs/search`;
+    return (0, http_1.postInnerApi)(url, req, {
+        errPrefix: "Failed to search logs",
+        defaultErrCode: DEFAULT_ERR_CODE,
+    });
+}
+// ── 链路 ──
+async function searchTraces(req) {
+    const url = `/v1/observability/app/${encodeURIComponent(req.appID)}/traces/search`;
+    return (0, http_1.postInnerApi)(url, req, {
+        errPrefix: "Failed to search traces",
+        defaultErrCode: DEFAULT_ERR_CODE,
+    });
+}
+async function getTraces(req) {
+    const url = `/v1/observability/app/${encodeURIComponent(req.appID)}/traces/${encodeURIComponent(req.traceID)}`;
+    return (0, http_1.postInnerApi)(url, req, {
+        errPrefix: "Failed to get trace",
+        defaultErrCode: DEFAULT_ERR_CODE,
+    });
+}
+// ── 监控指标 ──
+async function queryMetricsData(req) {
+    const url = `/v1/observability/app/${encodeURIComponent(req.appID)}/metrics/data/query`;
+    return (0, http_1.postInnerApi)(url, req, {
+        errPrefix: "Failed to query metrics",
+        defaultErrCode: DEFAULT_ERR_CODE,
+    });
+}
+// ── 运营指标 ──
+//
+// 走 BAM v1.0.122 起的批量端点 CLIBatchQueryAnalyticsData：
+//   - 路径 /analytics/data/batch_query（旧版 /analytics/data/query 已废弃）
+//   - 支持 metricTypes 数组，单次拉多个指标
+async function queryAnalyticsData(req) {
+    const url = `/v1/observability/app/${encodeURIComponent(req.appID)}/analytics/data/batch_query`;
+    return (0, http_1.postInnerApi)(url, req, {
+        errPrefix: "Failed to query analytics",
+        defaultErrCode: DEFAULT_ERR_CODE,
+    });
+}

package/dist/api/observability/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StatusCode = exports.SpanKind = exports.WordOperator = exports.spanSchema = exports.logItemSchema = exports.queryAnalyticsData = exports.queryMetricsData = exports.getTraces = exports.searchTraces = exports.searchLogs = void 0;
+var api_1 = require("./api");
+Object.defineProperty(exports, "searchLogs", { enumerable: true, get: function () { return api_1.searchLogs; } });
+Object.defineProperty(exports, "searchTraces", { enumerable: true, get: function () { return api_1.searchTraces; } });
+Object.defineProperty(exports, "getTraces", { enumerable: true, get: function () { return api_1.getTraces; } });
+Object.defineProperty(exports, "queryMetricsData", { enumerable: true, get: function () { return api_1.queryMetricsData; } });
+Object.defineProperty(exports, "queryAnalyticsData", { enumerable: true, get: function () { return api_1.queryAnalyticsData; } });
+var schemas_1 = require("./schemas");
+Object.defineProperty(exports, "logItemSchema", { enumerable: true, get: function () { return schemas_1.logItemSchema; } });
+Object.defineProperty(exports, "spanSchema", { enumerable: true, get: function () { return schemas_1.spanSchema; } });
+var types_1 = require("./types");
+Object.defineProperty(exports, "WordOperator", { enumerable: true, get: function () { return types_1.WordOperator; } });
+Object.defineProperty(exports, "SpanKind", { enumerable: true, get: function () { return types_1.SpanKind; } });
+Object.defineProperty(exports, "StatusCode", { enumerable: true, get: function () { return types_1.StatusCode; } });

package/dist/api/observability/schemas.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.spanSchema = exports.logItemSchema = void 0;
+const output_1 = require("../../utils/output");
+/** LogItem 渲染契约（log search） */
+exports.logItemSchema = {
+    columns: [
+        { key: "timestampNs", label: "time", format: output_1.fmt.ns("yyyy-MM-dd HH:mm:ss.SSS") },
+        { key: "severityText", label: "level" },
+        { key: "body" },
+    ],
+    strict: true,
+};
+/** Span 渲染契约（trace list / trace get 复用）。
+ *  duration 是 client-derived（BAM 只给 start/end，没有原生 durationNs 字段）。 */
+exports.spanSchema = {
+    columns: [
+        { key: "startTimeUnixNano", label: "start-time", format: output_1.fmt.ns("yyyy-MM-dd HH:mm:ss.SSS") },
+        { key: "name", label: "root-span" },
+        {
+            key: "user-id",
+            derive: (row) => {
+                return row.attributes?.user_id;
+            },
+        },
+        {
+            key: "duration",
+            label: "duration",
+            format: output_1.fmt.durationMs(),
+            derive: (row) => {
+                return row.attributes?.duration_ms;
+            },
+        },
+        { key: "traceID", label: "trace-id" },
+    ],
+    strict: true,
+};
+// metric / analytics 都改用 BAM v1.0.123 起的合并响应（points: {timestamp, values}），
+// pretty 渲染走 handler 内 pivot 后的临时 schema；不再导出固定 schema。

package/dist/api/observability/types.js

@@ -0,0 +1,27 @@
+"use strict";
+// ── 通用结构 ──
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StatusCode = exports.SpanKind = exports.WordOperator = void 0;
+/** 模糊搜索词运算符（对应后端 WordOperator） */
+var WordOperator;
+(function (WordOperator) {
+    WordOperator[WordOperator["AND"] = 0] = "AND";
+    WordOperator[WordOperator["OR"] = 1] = "OR";
+})(WordOperator || (exports.WordOperator = WordOperator = {}));
+/** OpenTelemetry SpanKind（BAM 透传） */
+var SpanKind;
+(function (SpanKind) {
+    SpanKind[SpanKind["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    SpanKind[SpanKind["INTERNAL"] = 1] = "INTERNAL";
+    SpanKind[SpanKind["SERVER"] = 2] = "SERVER";
+    SpanKind[SpanKind["CLIENT"] = 3] = "CLIENT";
+    SpanKind[SpanKind["PRODUCER"] = 4] = "PRODUCER";
+    SpanKind[SpanKind["CONSUMER"] = 5] = "CONSUMER";
+})(SpanKind || (exports.SpanKind = SpanKind = {}));
+/** Span 状态码（BAM 透传） */
+var StatusCode;
+(function (StatusCode) {
+    StatusCode[StatusCode["UNSET"] = 0] = "UNSET";
+    StatusCode[StatusCode["OK"] = 1] = "OK";
+    StatusCode[StatusCode["ERROR"] = 2] = "ERROR";
+})(StatusCode || (exports.StatusCode = StatusCode = {}));

package/dist/api/plugin/api.js

@@ -38,7 +38,9 @@ async function getPluginVersion(pluginKey, requestedVersion) {
     const versions = await getPluginVersions([pluginKey], isLatest);
     const pluginVersions = versions[pluginKey];
     if (!pluginVersions || pluginVersions.length === 0) {
-        throw new error_1.AppError("PLUGIN_NOT_FOUND", `Plugin not found: ${pluginKey}`, { next_actions: ["检查包名拼写，或确认该插件已在插件市场发布"] });
+        throw new error_1.AppError("PLUGIN_NOT_FOUND", `Plugin not found: ${pluginKey}`, {
+            next_actions: ["检查包名拼写，或确认该插件已在插件市场发布"],
+        });
     }
     if (isLatest) {
         return pluginVersions[0];
@@ -53,7 +55,9 @@ async function getPluginVersion(pluginKey, requestedVersion) {
 function parsePluginKey(key) {
     const match = /^(@[^/]+)\/(.+)$/.exec(key);
     if (!match) {
-        throw new error_1.AppError("INVALID_PLUGIN_KEY", `Invalid plugin key format: ${key}`, { next_actions: ["插件 key 必须形如 @scope/name"] });
+        throw new error_1.AppError("INVALID_PLUGIN_KEY", `Invalid plugin key format: ${key}`, {
+            next_actions: ["插件 key 必须形如 @scope/name"],
+        });
     }
     return { scope: match[1], name: match[2] };
 }
@@ -91,7 +95,8 @@ async function withRetry(operation, description, maxRetries = MAX_RETRIES) {
             }
         }
     }
-    throw lastError ?? new error_1.AppError("INTERNAL_RETRY_EXHAUSTED", `${description} failed after ${String(maxRetries)} retries`, { retryable: true, next_actions: ["检查网络后重试，--verbose 可查看重试日志"] });
+    throw (lastError ??
+        new error_1.AppError("INTERNAL_RETRY_EXHAUSTED", `${description} failed after ${String(maxRetries)} retries`, { retryable: true, next_actions: ["检查网络后重试，--verbose 可查看重试日志"] }));
 }
 /** 插件缓存目录 */
 const PLUGIN_CACHE_DIR = "node_modules/.cache/miaoda-cli/plugins";

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

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerAppCommands = registerAppCommands;
+const shared_1 = require("../../../cli/commands/shared");
+const index_1 = require("../../../cli/handlers/app/index");
+function registerAppCommands(program) {
+    const appCmd = program.command("app").description("应用元数据管理：查看 / 修改");
+    appCmd.action(() => {
+        appCmd.outputHelp();
+    });
+    appCmd.addHelpText("after", `
+作用范围
+  仅供 Agent 在妙搭沙箱内调用。
+  应用上下文：沙箱内的默认应用。
+`);
+    registerAppGet(appCmd);
+    registerAppUpdate(appCmd);
+}
+function registerAppGet(parent) {
+    const cmd = parent
+        .command("get")
+        .description("查看应用元数据（status / type / mode / branch / 时间戳 等）")
+        .addOption((0, shared_1.appIdOption)().hideHelp())
+        .addHelpText("after", `
+JSON 输出
+  {"data": {"appID": "...", "name": "...", ...}}
+
+示例
+  $ miaoda app get
+  $ miaoda app get --json
+`);
+    cmd.action((0, shared_1.withHelp)(cmd, async (rawOpts) => {
+        (0, shared_1.rejectCliOverride)(cmd, "appId");
+        await (0, index_1.handleAppGet)({
+            appId: rawOpts.appId,
+        });
+    }));
+}
+function registerAppUpdate(parent) {
+    const cmd = parent
+        .command("update")
+        .description("修改应用名称 / 描述（至少传 --name 或 --description）")
+        .addOption((0, shared_1.appIdOption)().hideHelp())
+        .option("--name <name>", "新应用名称")
+        .option("--description <desc>", "新应用描述")
+        .addHelpText("after", `
+JSON 输出
+  与 'app get' 一致：{"data": {...新 meta...}, "next_cursor": null, "has_more": false}
+
+示例
+  $ miaoda app update --name my-store
+  $ miaoda app update --description "在线商城应用"
+`);
+    cmd.action((0, shared_1.withHelp)(cmd, async (rawOpts) => {
+        (0, shared_1.rejectCliOverride)(cmd, "appId");
+        await (0, index_1.handleAppUpdate)({
+            appId: rawOpts.appId,
+            name: rawOpts.name,
+            description: rawOpts.description,
+        });
+    }));
+}

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

@@ -179,6 +179,7 @@ Examples:
         .option("--format <fmt>", "导出格式 csv / json / sql，默认 csv（sql 输出 INSERT 语句，可用 db sql < file.sql 回放）")
         .option("-f, --file <path>", "输出文件路径，默认 <表名>.<格式>")
         .option("--limit <n>", "最多导出行数（不超过 5000）")
+        .option("--force", "输出文件已存在时覆盖（默认报错）")
         .action(async function (table) {
         await (0, index_1.handleDbDataExport)(table, this.optsWithGlobals());
     })