@lark-apaas/miaoda-cli 0.1.1-alpha.b2bef50 → 0.1.1-alpha.c294fef

package/dist/api/app/api.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapDevopsError = mapDevopsError;
+exports.getAppInfo = getAppInfo;
+exports.updateAppMeta = updateAppMeta;
+const http_1 = require("../../utils/http");
+const error_1 = require("../../utils/error");
+const DEFAULT_ERR_CODE = "INTERNAL_DEVOPS_ERROR";
+/**
+ * 把 BAM lark.apaas.devops 的业务码（数字字符串）映射成 CLI 错误码。
+ * 来源：服务端技术方案 wiki L7P8wlNQ5iyShLkxzlOcCo8LnTg「业务错误码映射表」。
+ */
+function mapDevopsError(bizCode, message) {
+    switch (bizCode) {
+        case "400002577":
+        case "400002569":
+            return new error_1.AppError("APP_NOT_FOUND", message, {
+                next_actions: ["Run `miaoda app list` to see available apps"],
+            });
+        case "400002579":
+            return new error_1.AppError("APP_PERMISSION_DENIED", message);
+        case "400002575":
+            return new error_1.AppError("INVALID_ARG_VALUE", message, {
+                next_actions: ["缩短 --name / --description 后重试（后端有长度限制）"],
+            });
+        default:
+            return undefined;
+    }
+}
+function envelopeOpts(errPrefix) {
+    return {
+        errPrefix,
+        defaultErrCode: DEFAULT_ERR_CODE,
+        mapErr: mapDevopsError,
+    };
+}
+/** GET /v1/devops/app/:appID — 获取应用详情 */
+async function getAppInfo(appID) {
+    const url = `/v1/devops/app/${encodeURIComponent(appID)}`;
+    return (0, http_1.getInnerApi)(url, envelopeOpts("Failed to get app info"));
+}
+/** POST /v1/devops/app/:appID/meta — 更新应用元数据 */
+async function updateAppMeta(req) {
+    const url = `/v1/devops/app/${encodeURIComponent(req.appID)}/meta`;
+    // 路径已带 appID，body 里也保留以匹配 BAM IDL 的 sensitive:"no" 透传约定
+    return (0, http_1.postInnerApi)(url, req, envelopeOpts("Failed to update app"));
+}

package/dist/api/app/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArchType = exports.Source = exports.BizType = exports.AppType = exports.AppMode = exports.AppStatus = exports.appMetaSchema = exports.mapDevopsError = exports.updateAppMeta = exports.getAppInfo = void 0;
+var api_1 = require("./api");
+Object.defineProperty(exports, "getAppInfo", { enumerable: true, get: function () { return api_1.getAppInfo; } });
+Object.defineProperty(exports, "updateAppMeta", { enumerable: true, get: function () { return api_1.updateAppMeta; } });
+Object.defineProperty(exports, "mapDevopsError", { enumerable: true, get: function () { return api_1.mapDevopsError; } });
+var schemas_1 = require("./schemas");
+Object.defineProperty(exports, "appMetaSchema", { enumerable: true, get: function () { return schemas_1.appMetaSchema; } });
+var types_1 = require("./types");
+Object.defineProperty(exports, "AppStatus", { enumerable: true, get: function () { return types_1.AppStatus; } });
+Object.defineProperty(exports, "AppMode", { enumerable: true, get: function () { return types_1.AppMode; } });
+Object.defineProperty(exports, "AppType", { enumerable: true, get: function () { return types_1.AppType; } });
+Object.defineProperty(exports, "BizType", { enumerable: true, get: function () { return types_1.BizType; } });
+Object.defineProperty(exports, "Source", { enumerable: true, get: function () { return types_1.Source; } });
+Object.defineProperty(exports, "ArchType", { enumerable: true, get: function () { return types_1.ArchType; } });

package/dist/api/app/schemas.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.appMetaSchema = void 0;
+const output_1 = require("../../utils/output");
+const types_1 = require("./types");
+// Partial<Record<...>>：未来 BAM 加新枚举值时这里没声明也不报错，运行期 lookup 自然得 undefined
+const STATUS_TEXT = {
+    [types_1.AppStatus.UNSPECIFIED]: "unknown",
+    [types_1.AppStatus.PREPARING]: "preparing",
+    [types_1.AppStatus.UNRELEASED]: "unreleased",
+    [types_1.AppStatus.RELEASED]: "released",
+    [types_1.AppStatus.DELETED]: "deleted",
+    [types_1.AppStatus.UPGRADING]: "upgrading",
+};
+const MODE_TEXT = {
+    [types_1.AppMode.UNSPECIFIED]: "unknown",
+    [types_1.AppMode.STANDARD]: "standard",
+    [types_1.AppMode.EXPERT]: "expert",
+};
+const TYPE_TEXT = {
+    [types_1.AppType.UNSPECIFIED]: "unknown",
+    [types_1.AppType.STANDARD]: "standard",
+    [types_1.AppType.PROTOTYPE]: "prototype",
+    [types_1.AppType.APPLICATION]: "application",
+    [types_1.AppType.DESIGN]: "design",
+    [types_1.AppType.OPENCLAW]: "openclaw",
+    [types_1.AppType.CLAW_SUB]: "claw_sub",
+};
+const BIZ_TYPE_TEXT = {
+    [types_1.BizType.UNSPECIFIED]: "unknown",
+    [types_1.BizType.MIAODA]: "miaoda",
+    [types_1.BizType.FORCE]: "force",
+};
+const ARCH_TYPE_TEXT = {
+    [types_1.ArchType.UNSPECIFIED]: "unknown",
+    [types_1.ArchType.FULL_STACK]: "full_stack",
+    [types_1.ArchType.NOT_FULL_STACK]: "not_full_stack",
+};
+const SOURCE_TEXT = {
+    [types_1.Source.UNSPECIFIED]: "unknown",
+    [types_1.Source.CHAT]: "chat",
+    [types_1.Source.TEMPLATE]: "template",
+    [types_1.Source.IMPORT_ZIP]: "import_zip",
+    [types_1.Source.IMPORT_BASE]: "import_base",
+};
+function lookup(table) {
+    return (v) => {
+        if (typeof v !== "number")
+            return undefined;
+        return table[v];
+    };
+}
+/**
+ * AppMeta 的 pretty 渲染契约。
+ *
+ * 注：BAM 没给 createdAt / updatedAt 的单位注解；先按 ms（fmt.ms）渲染，
+ * 待 e2e 真值确认后调整。enum 字段通过 derive 翻译成可读字符串，JSON 模式
+ * 仍是 BAM 原值（数字枚举），与 BAM 接口契约保持一致。
+ */
+exports.appMetaSchema = {
+    columns: [
+        { key: "appID", label: "app-id" },
+        { key: "name" },
+        { key: "description" },
+        { key: "status_text", label: "status", derive: (row) => lookup(STATUS_TEXT)(row.status) },
+        { key: "appType_text", label: "type", derive: (row) => lookup(TYPE_TEXT)(row.appType) },
+        { key: "appMode_text", label: "mode", derive: (row) => lookup(MODE_TEXT)(row.appMode) },
+        { key: "bizType_text", label: "biz-type", derive: (row) => lookup(BIZ_TYPE_TEXT)(row.bizType) },
+        { key: "archType_text", label: "arch", derive: (row) => lookup(ARCH_TYPE_TEXT)(row.archType) },
+        { key: "source_text", label: "source", derive: (row) => lookup(SOURCE_TEXT)(row.source) },
+        { key: "ownedBy", label: "owner" },
+        { key: "createdBy", label: "creator" },
+        { key: "dataBranchID", label: "branch" },
+        { key: "parentAppID", label: "parent-app" },
+        { key: "createdAt", label: "created-at", format: output_1.fmt.ms() },
+        { key: "updatedAt", label: "updated-at", format: output_1.fmt.ms() },
+    ],
+    strict: true,
+};

package/dist/api/app/types.js

@@ -0,0 +1,58 @@
+"use strict";
+// 与 BAM lark.apaas.devops v1.0.326 对齐：
+//   - CLIGetAppInfo (4070322)  → AppInfo / AppMeta
+//   - CLIUpdateAppMeta (4070323) → 入参 name? / description?
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArchType = exports.Source = exports.BizType = exports.AppType = exports.AppMode = exports.AppStatus = void 0;
+/** 应用状态 */
+var AppStatus;
+(function (AppStatus) {
+    AppStatus[AppStatus["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    AppStatus[AppStatus["PREPARING"] = 1] = "PREPARING";
+    AppStatus[AppStatus["UNRELEASED"] = 2] = "UNRELEASED";
+    AppStatus[AppStatus["RELEASED"] = 3] = "RELEASED";
+    /** BAM 注释为 Deprecated；保留枚举以兼容历史响应数据 */
+    AppStatus[AppStatus["DELETED"] = 4] = "DELETED";
+    AppStatus[AppStatus["UPGRADING"] = 5] = "UPGRADING";
+})(AppStatus || (exports.AppStatus = AppStatus = {}));
+/** 应用模式 */
+var AppMode;
+(function (AppMode) {
+    AppMode[AppMode["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    AppMode[AppMode["STANDARD"] = 1] = "STANDARD";
+    AppMode[AppMode["EXPERT"] = 2] = "EXPERT";
+})(AppMode || (exports.AppMode = AppMode = {}));
+/** 应用类型 */
+var AppType;
+(function (AppType) {
+    AppType[AppType["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    AppType[AppType["STANDARD"] = 1] = "STANDARD";
+    AppType[AppType["PROTOTYPE"] = 2] = "PROTOTYPE";
+    AppType[AppType["APPLICATION"] = 3] = "APPLICATION";
+    AppType[AppType["DESIGN"] = 4] = "DESIGN";
+    AppType[AppType["OPENCLAW"] = 5] = "OPENCLAW";
+    AppType[AppType["CLAW_SUB"] = 6] = "CLAW_SUB";
+})(AppType || (exports.AppType = AppType = {}));
+/** 业务线 */
+var BizType;
+(function (BizType) {
+    BizType[BizType["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    BizType[BizType["MIAODA"] = 1] = "MIAODA";
+    BizType[BizType["FORCE"] = 2] = "FORCE";
+})(BizType || (exports.BizType = BizType = {}));
+/** 应用来源 */
+var Source;
+(function (Source) {
+    Source[Source["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    Source[Source["CHAT"] = 1] = "CHAT";
+    Source[Source["TEMPLATE"] = 2] = "TEMPLATE";
+    Source[Source["IMPORT_ZIP"] = 3] = "IMPORT_ZIP";
+    Source[Source["IMPORT_BASE"] = 4] = "IMPORT_BASE";
+})(Source || (exports.Source = Source = {}));
+/** 架构类型 */
+var ArchType;
+(function (ArchType) {
+    ArchType[ArchType["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    ArchType[ArchType["FULL_STACK"] = 1] = "FULL_STACK";
+    ArchType[ArchType["NOT_FULL_STACK"] = 2] = "NOT_FULL_STACK";
+})(ArchType || (exports.ArchType = ArchType = {}));

package/dist/api/db/api.js

@@ -16,13 +16,7 @@ const client_1 = require("./client");
  * 配合调用点的 try/catch + traceHttp，让 --verbose 在错误路径上也能拿到
  * x-tt-logid 与 status，方便定位线上问题。
  */
-async function mapDbHttpError(err, url, ctx, 
-/**
- * 可选 hook：解析到响应 body 后，如果 envelope 命中业务错误并抛出 AppError，
- * 调用方可以借此把 body 里的额外字段（如 multi-statement 的 partial results）
- * 挂到 AppError 上。
- */
-onErrorBody) {
+async function mapDbHttpError(err, url, ctx) {
     if (err instanceof error_1.AppError)
         throw err;
     if (err instanceof http_client_1.HttpError) {
@@ -30,17 +24,8 @@ onErrorBody) {
         const statusText = err.response?.statusText ?? "";
         try {
             const body = (await err.response?.json());
-            if (body) {
-                try {
-                    (0, client_1.extractData)(body); // 业务 code 命中 → 抛 AppError；不命中走兜底
-                }
-                catch (appErr) {
-                    if (appErr instanceof error_1.AppError && onErrorBody) {
-                        onErrorBody(body, appErr);
-                    }
-                    throw appErr;
-                }
-            }
+            if (body)
+                (0, client_1.extractData)(body); // 业务 code 命中 → 抛 AppError；不命中走兜底
         }
         catch (innerErr) {
             if (innerErr instanceof error_1.AppError)
@@ -51,20 +36,6 @@ onErrorBody) {
     }
     throw err;
 }
-/**
- * 多语句 SQL 失败时把已成功 statement 的 results 挂到 AppError.partial_results 上，
- * 供上层 handler 构造 PRD 要求的 `completed` 数组。
- *
- * 注意参数顺序：(body, appErr) — 与 mapDbHttpError 的 onErrorBody hook 签名对齐。
- */
-function attachSqlPartialResults(body, appErr) {
-    const data = body.data;
-    if (!data)
-        return;
-    if (!Array.isArray(data.results) || data.results.length === 0)
-        return;
-    appErr.partial_results = data.results;
-}
 // CLI 不再为 dbBranch 设默认值：
 // 用户没传 --env 就完全不携带 dbBranch query 参数，由后端 admin-inner 中间件
 // 按 workspace 多环境状态决定（多环境 → dev / 单环境 → main）。
@@ -90,60 +61,12 @@ async function execSql(opts) {
     }
     catch (err) {
         (0, client_1.traceHttp)("POST", url, start, err instanceof http_client_1.HttpError ? err.response : undefined, err);
-        await mapDbHttpError(err, url, "Failed to execute SQL", attachSqlPartialResults);
+        await mapDbHttpError(err, url, "Failed to execute SQL");
         throw err; // 不可达
     }
     const body = (await response.json());
-    try {
-        const data = (0, client_1.extractData)(body);
-        const results = data.results ?? [];
-        // 新协议（dataloom 端 InnerAdminExecuteSQL 错误统一走 success envelope）：
-        // results 末尾追加一条 SqlType="ERROR" 的哨兵，data 字段是 {code,message} JSON。
-        // 这样网关在错误路径不会吞业务字段，CLI 拿到完整 partial_results + statement_index。
-        const last = results.at(-1);
-        if (last?.sqlType === "ERROR") {
-            const appErr = parseSqlErrorSentinel(last.data);
-            appErr.partial_results = results.slice(0, -1);
-            const stmtIdx = data.errorStatementIndex;
-            if (typeof stmtIdx === "number")
-                appErr.statement_index = stmtIdx;
-            throw appErr;
-        }
-        return results;
-    }
-    catch (appErr) {
-        // 旧协议兼容（dataloom 服务端未部署新协议时）：HTTP 2xx 但 envelope status_code != 0
-        // 走 mapDbHttpError → AppError，partial_results 已被网关吞，仅保留 code+message。
-        //
-        // 新协议下上面的 try 块里已经手动 slice 设置了 partial_results（剥离了 ERROR 哨兵），
-        // 这里必须跳过 attach，否则会被 body.data.results 完整数组（含哨兵）覆盖回去。
-        if (appErr instanceof error_1.AppError && appErr.partial_results === undefined) {
-            attachSqlPartialResults(body, appErr);
-        }
-        throw appErr;
-    }
-}
-/**
- * 解析 InnerAdminExecuteSQL 错误哨兵（results 末尾那条 SqlType="ERROR" 项）的 data 字段。
- * 服务端约定：data 是 `{"code":"k_dl_xxx","message":"..."}` 形态的 JSON 字符串。
- *
- * 拿到 code+message 后复用 mapDataloomBizError 走与旧协议（ensureInnerSuccess）
- * 完全一致的映射规则——k_dl_1300015 → RESULT_SET_TOO_LARGE、SQLSTATE 透传等
- * hint / 语义 code 重写不能丢。否则新协议下 SERVER_ERROR_HINTS 会因为 code key
- * 不匹配而 miss，CLI 用户看不到 LIMIT 引导这种关键 hint。
- *
- * 解析失败则降级为 INTERNAL_DB_ERROR + 原始字符串，避免哨兵格式异常时整条调用炸掉。
- */
-function parseSqlErrorSentinel(payload) {
-    try {
-        const parsed = JSON.parse(payload);
-        const code = typeof parsed.code === "string" && parsed.code !== "" ? parsed.code : "INTERNAL_DB_ERROR";
-        const message = typeof parsed.message === "string" ? parsed.message : payload;
-        return (0, client_1.mapDataloomBizError)(code, message);
-    }
-    catch {
-        return new error_1.AppError("INTERNAL_DB_ERROR", payload);
-    }
+    const data = (0, client_1.extractData)(body);
+    return data.results ?? [];
 }
 // ── db schema → InnerGetSchema ──
 /**

package/dist/api/db/client.js

@@ -3,7 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SQLSTATE_MAP = void 0;
 exports.traceHttp = traceHttp;
 exports.ensureInnerSuccess = ensureInnerSuccess;
-exports.mapDataloomBizError = mapDataloomBizError;
 exports.extractData = extractData;
 exports.buildInnerUrl = buildInnerUrl;
 const error_1 = require("../../utils/error");
@@ -27,7 +26,11 @@ 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;
         }
@@ -51,48 +54,40 @@ function ensureInnerSuccess(body) {
     const code = body.status_code ?? body.ErrorCode ?? "0";
     if (code === "0" || code === "")
         return;
-    const appErr = mapDataloomBizError(code, body.error_msg ?? body.ErrorMessage ?? `dataloom API error [${code}]`);
+    const message = stripPgPrefix(body.error_msg ?? body.ErrorMessage ?? `dataloom API error [${code}]`);
     // PRD 多语句失败：后端在 envelope 顶层透出 errorStatementIndex（从 0 起计），
-    // 单语句 / 单元执行不会带这个字段。挂到 AppError 上让 emitError 落到错误信封
-    // statement_index 字段。
-    if (typeof body.errorStatementIndex === "number") {
-        appErr.statement_index = body.errorStatementIndex;
-    }
-    throw appErr;
-}
-/**
- * 把 dataloom 业务错误码 + 原始 message 映射为语义化 AppError。
- *
- * 同时被两条错误路径共用：
- *   - ensureInnerSuccess（旧协议：BaseResp.status_code != "0"）
- *   - api.ts 的 parseSqlErrorSentinel（新协议：success envelope + ERROR 哨兵）
- *
- * 优先级：
- *   1. k_dl_1300002 + SQLSTATE 透传     → SQLSTATE_MAP
- *   2. k_dl_1600000 + "Invalid DB Branch" → MULTI_ENV_NOT_INITIALIZED
- *   3. BIZ_ERR_MAP 命中 → 语义 code（可能带 hint）
- *   4. 兜底 DB_API_<code>
- *
- * stripPgPrefix 在这里做一次，调用方传 raw message 即可。
- */
-function mapDataloomBizError(code, rawMessage) {
-    const message = stripPgPrefix(rawMessage);
+    // 单语句 / 单元执行不会带这个字段。下面的 AppError 都把它带上，让最终
+    // CLI JSON envelope 写到 error.statement_index。
+    const stmtIdx = typeof body.errorStatementIndex === "number" ? body.errorStatementIndex : undefined;
+    // k_dl_1300002 是 PG 执行透传错误；error_msg 里常带 SQLSTATE，优先按 SQLSTATE 映射
     if (code === "k_dl_1300002") {
         const sqlstate = extractSqlstate(message);
         if (sqlstate && exports.SQLSTATE_MAP[sqlstate]) {
-            return new error_1.AppError(exports.SQLSTATE_MAP[sqlstate], message);
+            throw new error_1.AppError(exports.SQLSTATE_MAP[sqlstate], message, { statement_index: stmtIdx });
         }
     }
+    // k_dl_1600000 是 dataloom 通用参数错误，不能整体映射；
+    // message 以 "Invalid DB Branch" 开头的两种触发场景：
+    //   1) 单环境应用使用 --env（多环境未初始化）
+    //   2) 多环境应用传入了不存在的 env 名（如 --env staging）
+    // 两者外部表象一致：dbBranch 在 db_branch 表里查不到，固定映射为 MULTI_ENV_NOT_INITIALIZED。
     if (code === "k_dl_1600000" && message.startsWith("Invalid DB Branch")) {
-        return new error_1.AppError("MULTI_ENV_NOT_INITIALIZED", "--env is not available (multi-env not initialized)", { next_actions: ["Verify the --env value matches an existing dbBranch."] });
+        throw new error_1.AppError("MULTI_ENV_NOT_INITIALIZED", "--env is not available (multi-env not initialized)", {
+            next_actions: [
+                "Verify the --env value matches an existing dbBranch.",
+            ],
+        });
     }
+    // 业务 code 优先映射到语义 CLI code；未知 code 透传为 DB_API_<code> 样式
     const mapped = BIZ_ERR_MAP.get(code);
     if (mapped) {
-        return new error_1.AppError(mapped.code, mapped.message ?? message, {
+        throw new error_1.AppError(mapped.code, mapped.message ?? message, {
             next_actions: mapped.hint ? [mapped.hint] : undefined,
+            statement_index: stmtIdx,
         });
     }
-    return new error_1.AppError(`DB_API_${code}`, message);
+    // 兜底：dataloom 未映射的 code 原样透传
+    throw new error_1.AppError(`DB_API_${code}`, message, { statement_index: stmtIdx });
 }
 /**
  * 剥掉 PG 透传错误的 "ERROR:" 前缀：CLI 输出本身就会前缀 "Error:"，
@@ -116,19 +111,13 @@ function extractSqlstate(msg) {
 const BIZ_ERR_MAP = new Map(Object.entries({
     // 来源：真实环境探测（dataloom InnerExecuteSQL / InnerGetSchema）
     // k_dl_000001：DB 连接 / QPS 限流 等基础设施层错误
-    k_dl_000001: {
-        code: "INTERNAL_DB_ERROR",
-        hint: "检查 dbBranch 与应用 PG 实例状态，或稍后重试",
-    },
+    "k_dl_000001": { code: "INTERNAL_DB_ERROR", hint: "检查 dbBranch 与应用 PG 实例状态，或稍后重试" },
     // k_dl_000002：SQL 解析 / 不支持的 SQL 类型（VACUUM、COPY、SET、SHOW 等）
-    k_dl_000002: { code: "SQL_SYNTAX_ERROR" },
+    "k_dl_000002": { code: "SQL_SYNTAX_ERROR" },
     // k_dl_000003：查询命中系统表（pg_tables / pg_user 等）被拒
-    k_dl_000003: { code: "SQL_OPERATION_FORBIDDEN" },
+    "k_dl_000003": { code: "SQL_OPERATION_FORBIDDEN" },
     // k_dl_1300002：PG 执行错误；实际 SQLSTATE 由 extractSqlstate 单独映射
     // 未匹配到 SQLSTATE 时走下面兜底 DB_API_<code>
-    // k_dl_1300015：SELECT 结果超过 1000 行硬拦；多行 hint 由 output.ts 的
-    // SERVER_ERROR_HINTS 按语义 code 兜底，这里只做 code 改名
-    k_dl_1300015: { code: "RESULT_SET_TOO_LARGE" },
 }));
 /** PG SQLSTATE → CLI code（当前 dataloom 不一定透传，预留未来使用） */
 exports.SQLSTATE_MAP = {

package/dist/api/db/parsers.js

@@ -117,35 +117,11 @@ function toDetail(t, stats) {
     // 优先用 tableStats.indexes（PRIMARY + UNIQUE + INDEX 统一视图）；
     // 回退到 TableVO.indexes（仅二级索引，老后端没返回 tableStats 时使用）
     const rawIndexes = stats?.indexes ?? t.indexes ?? [];
-    const constraints = [];
-    const indexes = [];
-    for (const i of rawIndexes) {
-        const cols = i.indexColumns ?? [];
-        // 过滤掉空列条目（后端偶发返 indexColumns=[] 的占位项），渲染成 "UNIQUE ()" 看起来像 bug
-        if (cols.length === 0)
-            continue;
-        const kind = i.indexType.toLowerCase();
-        if (kind === "primary") {
-            constraints.push({ type: "PRIMARY KEY", columns: cols });
-        }
-        else if (kind === "unique") {
-            constraints.push({ type: "UNIQUE", columns: cols });
-        }
-        else {
-            // foreign / normal / 其它统一进 indexes 段；method 从 indexDef 的 USING 段解析
-            indexes.push({
-                name: i.indexName,
-                columns: cols,
-                method: parseIndexMethod(i.indexDef) ?? "btree",
-            });
-        }
-    }
     return {
         name: t.tableName,
         description: t.comment && t.comment.length > 0 ? t.comment : null,
         columns: (t.fields ?? []).map(toColumn),
-        constraints,
-        indexes,
+        indexes: rawIndexes.map(toIndex),
         estimated_row_count: typeof stats?.estimatedRowCount === "number" ? stats.estimatedRowCount : null,
         size_bytes: typeof stats?.sizeBytes === "number" ? stats.sizeBytes : null,
     };
@@ -161,14 +137,25 @@ function toColumn(f) {
         comment: f.comment && f.comment.length > 0 ? f.comment : null,
     };
 }
+function toIndex(i) {
+    return {
+        name: i.indexName,
+        type: translateIndexType(i.indexType),
+        columns: i.indexColumns ?? [],
+    };
+}
 /**
- * 从 PG 的 CREATE INDEX 语句里提取访问方法（btree / gin / gist / hash 等）。
- * indexDef 示例: "CREATE INDEX idx_users_name ON public.users USING btree (name)"
- * 解析失败返 null，由调用方兜底成 PG 默认的 "btree"。
+ * 把后端原始 IndexType（小写：primary / unique / normal / foreign）翻译为 PRD 约定的展示值。
+ * 规则：
+ *   primary  → "PRIMARY KEY"
+ *   unique   → "UNIQUE"
+ *   其它    → "INDEX"（foreign 外键通过 relationships 表达，不进 indexes；真的遇到也归 INDEX）
  */
-function parseIndexMethod(indexDef) {
-    if (!indexDef)
-        return null;
-    const m = /USING\s+(\w+)/i.exec(indexDef);
-    return m ? m[1].toLowerCase() : null;
+function translateIndexType(raw) {
+    const s = raw.toLowerCase();
+    if (s === "primary")
+        return "PRIMARY KEY";
+    if (s === "unique")
+        return "UNIQUE";
+    return "INDEX";
 }

package/dist/api/deploy/api.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRelease = createRelease;
+exports.getRelease = getRelease;
+exports.listPipelineInstances = listPipelineInstances;
+exports.getReleaseLogs = getReleaseLogs;
+exports.queryPipelineInstance = queryPipelineInstance;
+const http_1 = require("../../utils/http");
+const index_1 = require("../../api/app/index");
+const DEFAULT_ERR_CODE = "INTERNAL_DEVOPS_ERROR";
+function envelopeOpts(errPrefix) {
+    return {
+        errPrefix,
+        defaultErrCode: DEFAULT_ERR_CODE,
+        // deploy 与 app 走同一个 PSM；业务码映射复用
+        mapErr: index_1.mapDevopsError,
+    };
+}
+/** POST /v1/devops/app/:appID/release — 触发发布 */
+async function createRelease(req) {
+    const url = `/v1/devops/app/${encodeURIComponent(req.appID)}/release`;
+    return (0, http_1.postInnerApi)(url, req, envelopeOpts("Failed to create release"));
+}
+/**
+ * GET /v1/devops/app/:appID/release — 获取发布单详情
+ *
+ * BAM 路径不带 releaseID，IDL 也未在 request body 暴露字段；按 query string 透传。
+ * 如 BAM 真没接收 releaseID，会返回最新发布单（待 e2e 验证）。
+ */
+async function getRelease(req) {
+    const base = `/v1/devops/app/${encodeURIComponent(req.appID)}/release`;
+    const url = req.releaseID
+        ? `${base}?releaseID=${encodeURIComponent(req.releaseID)}`
+        : base;
+    return (0, http_1.getInnerApi)(url, envelopeOpts("Failed to get release"));
+}
+/**
+ * POST /v1/pipeline/app/:appID/instance/list — 分页查询发布历史
+ *
+ * 走 lark.apaas.devops_platform PSM（同 queryPipelineInstance）。
+ * 不复用 mapDevopsError——那是 lark.apaas.devops 的业务码映射。
+ */
+async function listPipelineInstances(req) {
+    const url = `/v1/pipeline/app/${encodeURIComponent(req.appID)}/instance/list`;
+    return (0, http_1.postInnerApi)(url, req, {
+        errPrefix: "Failed to list deploys",
+        defaultErrCode: DEFAULT_ERR_CODE,
+    });
+}
+/** POST /v1/devops/app/:appID/release/logs — 获取发布错误日志 */
+async function getReleaseLogs(req) {
+    const url = `/v1/devops/app/${encodeURIComponent(req.appID)}/release/logs`;
+    return (0, http_1.postInnerApi)(url, req, envelopeOpts("Failed to get release logs"));
+}
+/**
+ * GET /v1/pipeline/app/:appID/instance/:instanceID/detail — 轮询发布状态
+ *
+ * 走 lark.apaas.devops_platform PSM；URL 前缀不同但共用同一管理端 gateway。
+ */
+async function queryPipelineInstance(req) {
+    const url = `/v1/pipeline/app/${encodeURIComponent(req.appID)}/instance/${encodeURIComponent(req.instanceID)}/detail`;
+    return (0, http_1.getInnerApi)(url, {
+        errPrefix: "Failed to query pipeline",
+        defaultErrCode: DEFAULT_ERR_CODE,
+    });
+}

package/dist/api/deploy/index.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeStatus = exports.ReleaseStatus = exports.nodeStatusFromText = exports.nodeStatusText = exports.releaseStatusFromText = exports.releaseStatusText = exports.errorJobSchema = exports.deployGetSchema = exports.deployHistorySchema = exports.queryPipelineInstance = exports.getReleaseLogs = exports.listPipelineInstances = exports.getRelease = exports.createRelease = void 0;
+var api_1 = require("./api");
+Object.defineProperty(exports, "createRelease", { enumerable: true, get: function () { return api_1.createRelease; } });
+Object.defineProperty(exports, "getRelease", { enumerable: true, get: function () { return api_1.getRelease; } });
+Object.defineProperty(exports, "listPipelineInstances", { enumerable: true, get: function () { return api_1.listPipelineInstances; } });
+Object.defineProperty(exports, "getReleaseLogs", { enumerable: true, get: function () { return api_1.getReleaseLogs; } });
+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, "releaseStatusText", { enumerable: true, get: function () { return schemas_1.releaseStatusText; } });
+Object.defineProperty(exports, "releaseStatusFromText", { enumerable: true, get: function () { return schemas_1.releaseStatusFromText; } });
+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, "ReleaseStatus", { enumerable: true, get: function () { return types_1.ReleaseStatus; } });
+Object.defineProperty(exports, "NodeStatus", { enumerable: true, get: function () { return types_1.NodeStatus; } });