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

package/dist/api/db/client.js

@@ -27,11 +27,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;
         }
@@ -120,16 +116,19 @@ 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" },
+    k_dl_1300015: { code: "RESULT_SET_TOO_LARGE" },
 }));
 /** PG SQLSTATE → CLI code（当前 dataloom 不一定透传，预留未来使用） */
 exports.SQLSTATE_MAP = {

package/dist/api/db/sql-keywords.js

@@ -21,32 +21,103 @@ exports.SQL_KEYWORDS = void 0;
  */
 exports.SQL_KEYWORDS = [
     // DML 动词
-    "SELECT", "INSERT", "UPDATE", "DELETE", "MERGE",
+    "SELECT",
+    "INSERT",
+    "UPDATE",
+    "DELETE",
+    "MERGE",
     // FROM / JOIN 系列
-    "FROM", "WHERE", "JOIN", "LEFT", "RIGHT", "INNER", "OUTER", "FULL", "CROSS", "USING",
+    "FROM",
+    "WHERE",
+    "JOIN",
+    "LEFT",
+    "RIGHT",
+    "INNER",
+    "OUTER",
+    "FULL",
+    "CROSS",
+    "USING",
     // 聚合 / 排序 / 分页
-    "GROUP", "ORDER", "BY", "HAVING", "LIMIT", "OFFSET", "FETCH",
+    "GROUP",
+    "ORDER",
+    "BY",
+    "HAVING",
+    "LIMIT",
+    "OFFSET",
+    "FETCH",
     // 集合操作
-    "UNION", "INTERSECT", "EXCEPT", "DISTINCT", "ALL",
+    "UNION",
+    "INTERSECT",
+    "EXCEPT",
+    "DISTINCT",
+    "ALL",
     // 别名 / 关联
-    "AS", "ON",
+    "AS",
+    "ON",
     // 操作符词
-    "AND", "OR", "NOT", "IN", "IS", "NULL", "TRUE", "FALSE",
-    "BETWEEN", "LIKE", "ILIKE", "SIMILAR",
+    "AND",
+    "OR",
+    "NOT",
+    "IN",
+    "IS",
+    "NULL",
+    "TRUE",
+    "FALSE",
+    "BETWEEN",
+    "LIKE",
+    "ILIKE",
+    "SIMILAR",
     // DDL
-    "CREATE", "ALTER", "DROP", "TRUNCATE", "RENAME",
-    "TABLE", "INDEX", "VIEW", "DATABASE", "SCHEMA", "COLUMN", "CONSTRAINT", "SEQUENCE",
+    "CREATE",
+    "ALTER",
+    "DROP",
+    "TRUNCATE",
+    "RENAME",
+    "TABLE",
+    "INDEX",
+    "VIEW",
+    "DATABASE",
+    "SCHEMA",
+    "COLUMN",
+    "CONSTRAINT",
+    "SEQUENCE",
     // 约束
-    "PRIMARY", "KEY", "FOREIGN", "REFERENCES", "UNIQUE", "CHECK", "DEFAULT",
+    "PRIMARY",
+    "KEY",
+    "FOREIGN",
+    "REFERENCES",
+    "UNIQUE",
+    "CHECK",
+    "DEFAULT",
     // 写入
-    "VALUES", "SET", "RETURNING", "INTO",
+    "VALUES",
+    "SET",
+    "RETURNING",
+    "INTO",
     // 事务
-    "BEGIN", "COMMIT", "ROLLBACK", "SAVEPOINT", "TRANSACTION",
+    "BEGIN",
+    "COMMIT",
+    "ROLLBACK",
+    "SAVEPOINT",
+    "TRANSACTION",
     // 控制流 / CTE
-    "IF", "EXISTS", "REPLACE", "WITH", "RECURSIVE",
-    "CASE", "WHEN", "THEN", "ELSE", "END",
+    "IF",
+    "EXISTS",
+    "REPLACE",
+    "WITH",
+    "RECURSIVE",
+    "CASE",
+    "WHEN",
+    "THEN",
+    "ELSE",
+    "END",
     // 类型转换 / 时间提取
-    "CAST", "EXTRACT",
+    "CAST",
+    "EXTRACT",
     // 排序方向
-    "ASC", "DESC", "NULLS", "FIRST", "LAST",
+    "ASC",
+    "DESC",
+    "NULLS",
+    "FIRST",
+    "LAST",
 ];

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 无需反查。 */
@@ -309,7 +307,9 @@ async function preUpload(appId, req) {
  */
 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" });
+    const body = await (0, client_1.doPost)(url, req, {
+        errorContext: "upload callback",
+    });
     const data = extractEnvelope(body);
     const metadata = data.metadata;
     if (!metadata) {
@@ -389,7 +389,9 @@ async function uploadFile(opts) {
         (0, logger_1.debug)(`upload callback failed: ${err instanceof Error ? err.message : String(err)}`);
     }
     const path = metadata.filePath
-        ? (metadata.filePath.startsWith("/") ? metadata.filePath : "/" + metadata.filePath)
+        ? metadata.filePath.startsWith("/")
+            ? metadata.filePath
+            : "/" + metadata.filePath
         : (opts.remotePath ?? "/" + opts.fileName);
     const result = {
         // 优先取服务端 ObjectVO.name（来自 PUT 时带的 Content-Disposition），

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

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

package/dist/cli/commands/shared.js

@@ -22,9 +22,7 @@ function resolveAppId(opts) {
     const id = opts.appId ?? process.env.MIAODA_APP_ID ?? process.env.app_id;
     if (!id) {
         throw new error_1.AppError("APP_ID_MISSING", "未指定应用", {
-            next_actions: [
-                "设置 export MIAODA_APP_ID=<id>",
-            ],
+            next_actions: ["设置 export MIAODA_APP_ID=<id>"],
         });
     }
     return id;

package/dist/cli/handlers/db/data.js

@@ -56,7 +56,9 @@ async function handleDbDataImport(file, opts) {
     catch (err) {
         const code = err.code;
         if (code === "ENOENT") {
-            throw new error_1.AppError("IMPORT_FILE_NOT_FOUND", `Local file '${file}' does not exist`, { next_actions: ["Check the file path."] });
+            throw new error_1.AppError("IMPORT_FILE_NOT_FOUND", `Local file '${file}' does not exist`, {
+                next_actions: ["Check the file path."],
+            });
         }
         throw err;
     }
@@ -103,7 +105,9 @@ async function handleDbDataExport(table, opts) {
     if (!opts.force) {
         try {
             await fs.access(outputPath);
-            throw new error_1.AppError("FILE_ALREADY_EXISTS", `Output file '${outputPath}' already exists`, { next_actions: ["Use -f to specify a different path, or --force to overwrite."] });
+            throw new error_1.AppError("FILE_ALREADY_EXISTS", `Output file '${outputPath}' already exists`, {
+                next_actions: ["Use -f to specify a different path, or --force to overwrite."],
+            });
         }
         catch (err) {
             if (err instanceof error_1.AppError)
@@ -119,7 +123,11 @@ async function handleDbDataExport(table, opts) {
         limit,
     });
     if (result.body.length > MAX_SIZE_BYTES) {
-        throw new error_1.AppError("EXPORT_SIZE_EXCEEDED", `Export exceeds 1 MB limit (body is ${String(result.body.length)} bytes)`, { next_actions: [`Filter the table with "miaoda db sql" (e.g. WHERE/LIMIT) and export smaller subsets.`] });
+        throw new error_1.AppError("EXPORT_SIZE_EXCEEDED", `Export exceeds 1 MB limit (body is ${String(result.body.length)} bytes)`, {
+            next_actions: [
+                `Filter the table with "miaoda db sql" (e.g. WHERE/LIMIT) and export smaller subsets.`,
+            ],
+        });
     }
     await fs.writeFile(outputPath, result.body);
     // 优先信任后端 X-Miaoda-Record-Count header；header 缺失时再用 body 行数兜底

package/dist/cli/handlers/db/schema.js

@@ -45,7 +45,12 @@ const index_1 = require("../../../api/db/index");
 // ── schema list ──
 async function handleDbSchemaList(opts) {
     const appId = (0, shared_1.resolveAppId)(opts);
-    const resp = await api.db.getSchema({ appId, format: "schema", includeStats: true, dbBranch: opts.env });
+    const resp = await api.db.getSchema({
+        appId,
+        format: "schema",
+        includeStats: true,
+        dbBranch: opts.env,
+    });
     const tables = (0, index_1.flattenSchemaList)(resp.schema);
     if ((0, output_1.isJsonMode)()) {
         (0, output_1.emit)({ data: tables });
@@ -69,7 +74,7 @@ async function handleDbSchemaList(opts) {
         t.name,
         t.description ?? "—",
         t.estimated_row_count === null ? "—" : String(t.estimated_row_count),
-        t.size_bytes === null ? "—" : (tty ? (0, render_1.formatSize)(t.size_bytes) : String(t.size_bytes)),
+        t.size_bytes === null ? "—" : tty ? (0, render_1.formatSize)(t.size_bytes) : String(t.size_bytes),
         String(t.columns),
     ]);
     (0, output_1.emit)(tty ? (0, render_1.renderAlignedTable)(headers, rows) : (0, render_1.renderTsv)(headers, rows));
@@ -109,9 +114,7 @@ async function handleDbSchemaGet(table, opts) {
     const detail = (0, index_1.pickTableDetail)(resp.schema, table);
     if (!detail) {
         throw new error_1.AppError("TABLE_NOT_FOUND", `Table '${table}' does not exist`, {
-            next_actions: [
-                `Did you mean another table? Run "miaoda db schema list" to see all tables.`,
-            ],
+            next_actions: [`Did you mean another table? Run "miaoda db schema list" to see all tables.`],
         });
     }
     if ((0, output_1.isJsonMode)()) {

package/dist/cli/handlers/db/sql.js

@@ -309,7 +309,10 @@ function parseJsonFields() {
     const v = (0, config_1.getConfig)().json;
     if (typeof v !== "string" || v === "")
         return null;
-    return v.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+    return v
+        .split(",")
+        .map((s) => s.trim())
+        .filter((s) => s.length > 0);
 }
 /** 多语句 pretty：逐条 `Statement N: ...` + 末尾 `✓ N statements executed`。 */
 function renderMultiPretty(results) {
@@ -349,11 +352,16 @@ function renderMultiPretty(results) {
 }
 function dmlVerb(type) {
     switch (type) {
-        case "INSERT": return "inserted";
-        case "UPDATE": return "updated";
-        case "DELETE": return "deleted";
-        case "MERGE": return "merged";
-        case "DML": return "affected"; // 未识别子类的兜底
+        case "INSERT":
+            return "inserted";
+        case "UPDATE":
+            return "updated";
+        case "DELETE":
+            return "deleted";
+        case "MERGE":
+            return "merged";
+        case "DML":
+            return "affected"; // 未识别子类的兜底
     }
 }
 /** 从第一行收集列顺序；缺失列保留空白（兼容稀疏行）。 */
@@ -500,9 +508,7 @@ function enrichColumnNotExist(err, colMatch, tableMap) {
     // TS RegExpMatchArray 数字索引类型 = string，但 optional capture group `(...)?`
     // 没匹配时运行时返 undefined；as cast 把这个事实告诉类型系统。
     const relation = colMatch[2];
-    const relationCols = relation !== undefined
-        ? tableMap[relation]
-        : undefined;
+    const relationCols = relation !== undefined ? tableMap[relation] : undefined;
     if (relation !== undefined && relationCols !== undefined) {
         // 指定了表 → 在该表的列里找
         const guess = (0, fuzzy_match_1.suggest)(colName, relationCols);
@@ -609,9 +615,7 @@ function inferRolledBack(completed) {
  * dollar-quoted（$$..$$）等高级形态——估错 ±1 不影响 hint 可读性。
  */
 function countStatements(sql) {
-    const stripped = sql
-        .replace(/'(?:''|[^'])*'/g, "''")
-        .replace(/"(?:""|[^"])*"/g, '""');
+    const stripped = sql.replace(/'(?:''|[^'])*'/g, "''").replace(/"(?:""|[^"])*"/g, '""');
     return stripped.split(/;+/).filter((s) => s.trim().length > 0).length;
 }
 /**

package/dist/cli/handlers/file/cp.js

@@ -120,19 +120,30 @@ async function handleUpload(appId, localRaw, remoteRaw, rename) {
     const stat = node_fs_1.default.statSync(localPath);
     if (stat.size > MAX_UPLOAD_BYTES) {
         throw new error_1.AppError("FILE_SIZE_EXCEEDED", `File size ${(0, render_1.formatSize)(stat.size)} exceeds the 100 MB upload limit`, {
-            next_actions: [
-                "Split the file, or use the web console for large uploads.",
-            ],
+            next_actions: ["Split the file, or use the web console for large uploads."],
         });
     }
-    const fileName = rename ?? node_path_1.default.basename(localPath);
-    // remoteRaw 直接透传给服务端，由服务端按"是否以 / 结尾"区分两种语义：
-    //   - 以 / 结尾  → 目录前缀模式，服务端在前缀下生成 "<16位ID>.<扩展名>"
-    //                例：cp ./logo.png /images/  → /images/1858537546760216.png
-    //   - 不以 / 结尾 → 完整对象 key 模式（旧语义，原样落库）
-    //                例：cp ./photo.jpg /uploads/photo.jpg → /uploads/photo.jpg
-    // CLI 不做任何自动改写，避免猜测用户意图导致的 path 形态不可预测。
-    const remotePath = remoteRaw;
+    // PRD：path 末段**始终**由平台生成 16 位 ID 确保唯一，不受 dst 形态或
+    // --rename 影响；用户指定的 file_name 仅作为显示名（同目录下允许重名）。
+    // 因此 CLI 端把 dst 拆成"目录前缀 + file_name"两段：
+    //   - dst 以 / 结尾或为空  → 整段当目录前缀，file_name 用 --rename 或本地 basename
+    //                          例：cp ./logo.png /imgs/        → path=/imgs/<GID>.png, file_name=logo.png
+    //   - dst 不以 / 结尾      → 末段当 file_name，前段（含尾 /）当目录前缀
+    //                          例：cp ./1.jpg /post-covers/cover.jpg → path=/post-covers/<GID>.jpg, file_name=cover.jpg
+    // 这样无论用户怎么写 dst，都走服务端目录前缀模式（PreUpload `filePath`
+    // 末尾带 /），保证 path 全局唯一性，不会因用户指定了完整路径而退化成
+    // 完整对象 key 模式。--rename 始终覆盖 file_name 推断结果（PRD 优先级）。
+    let fileName;
+    let remotePath;
+    if (remoteRaw === "" || remoteRaw.endsWith("/")) {
+        fileName = rename ?? node_path_1.default.basename(localPath);
+        remotePath = remoteRaw;
+    }
+    else {
+        const lastSlash = remoteRaw.lastIndexOf("/");
+        fileName = rename ?? remoteRaw.slice(lastSlash + 1);
+        remotePath = remoteRaw.slice(0, lastSlash + 1);
+    }
     const contentType = detectMime(localPath);
     const result = await api.file.uploadFile({
         appId,

package/dist/cli/handlers/file/ls.js

@@ -101,9 +101,7 @@ async function handleFileLs(opts) {
         info.type,
         (0, render_1.formatTime)(info.uploaded_at, tty),
     ]);
-    const table = tty
-        ? (0, render_1.renderAlignedTable)(headers, rows)
-        : (0, render_1.renderTsv)(headers, rows);
+    const table = tty ? (0, render_1.renderAlignedTable)(headers, rows) : (0, render_1.renderTsv)(headers, rows);
     const hint = result.has_more && result.next_cursor
         ? `\n— ${String(result.items.length)} results. Next: --cursor ${result.next_cursor}`
         : "";

package/dist/cli/handlers/file/rm.js

@@ -170,7 +170,7 @@ async function handleFileRm(paths, opts) {
             results.push({
                 status: "ok",
                 input: entry?.input ?? p,
-                file_name: entry?.file_name ?? (p.split("/").pop() ?? p),
+                file_name: entry?.file_name ?? p.split("/").pop() ?? p,
                 path: p,
             });
         }

package/dist/cli/handlers/plugin/plugin-local.js

@@ -82,7 +82,9 @@ function parsePluginName(input) {
 function readPackageJson() {
     const pkgPath = getPackageJsonPath();
     if (!node_fs_1.default.existsSync(pkgPath)) {
-        throw new error_1.AppError("PKG_JSON_NOT_FOUND", "package.json not found in current directory", { next_actions: ["在应用项目根目录运行"] });
+        throw new error_1.AppError("PKG_JSON_NOT_FOUND", "package.json not found in current directory", {
+            next_actions: ["在应用项目根目录运行"],
+        });
     }
     const content = node_fs_1.default.readFileSync(pkgPath, "utf-8");
     return JSON.parse(content);
@@ -189,9 +191,14 @@ function installMissingDeps(deps) {
     if (deps.length === 0)
         return;
     (0, logger_1.log)("plugin", `Installing missing dependencies: ${deps.join(", ")}`);
-    const result = (0, node_child_process_1.spawnSync)("npm", ["install", ...deps, "--no-save", "--no-package-lock"], { cwd: getProjectRoot(), stdio: "inherit" });
+    const result = (0, node_child_process_1.spawnSync)("npm", ["install", ...deps, "--no-save", "--no-package-lock"], {
+        cwd: getProjectRoot(),
+        stdio: "inherit",
+    });
     if (result.error) {
-        throw new error_1.AppError("INTERNAL_NPM_FAILED", `npm install failed: ${result.error.message}`, { next_actions: ["确认本机已安装 npm，可 --verbose 查看执行详情"] });
+        throw new error_1.AppError("INTERNAL_NPM_FAILED", `npm install failed: ${result.error.message}`, {
+            next_actions: ["确认本机已安装 npm，可 --verbose 查看执行详情"],
+        });
     }
     if (result.status !== 0) {
         throw new error_1.AppError("INTERNAL_NPM_FAILED", `npm install failed with exit code ${String(result.status)}`, { next_actions: ["检查上方 npm 输出日志定位具体错误"] });
@@ -200,7 +207,9 @@ function installMissingDeps(deps) {
 function npmInstall(tgzPath) {
     const result = (0, node_child_process_1.spawnSync)("npm", ["install", tgzPath, "--no-save", "--no-package-lock", "--ignore-scripts"], { cwd: getProjectRoot(), stdio: "inherit" });
     if (result.error) {
-        throw new error_1.AppError("INTERNAL_NPM_FAILED", `npm install failed: ${result.error.message}`, { next_actions: ["确认本机已安装 npm，可 --verbose 查看执行详情"] });
+        throw new error_1.AppError("INTERNAL_NPM_FAILED", `npm install failed: ${result.error.message}`, {
+            next_actions: ["确认本机已安装 npm，可 --verbose 查看执行详情"],
+        });
     }
     if (result.status !== 0) {
         throw new error_1.AppError("INTERNAL_NPM_FAILED", `npm install failed with exit code ${String(result.status)}`, { next_actions: ["检查上方 npm 输出日志定位具体错误"] });
@@ -232,7 +241,9 @@ function listCapabilityIds() {
 function readCapability(id) {
     const filePath = node_path_1.default.join(getCapabilitiesDir(), `${id}.json`);
     if (!node_fs_1.default.existsSync(filePath)) {
-        throw new error_1.AppError("CAPABILITY_NOT_FOUND", `Capability not found: ${id}`, { next_actions: ["运行 miaoda plugin list 查看所有可用 capability id"] });
+        throw new error_1.AppError("CAPABILITY_NOT_FOUND", `Capability not found: ${id}`, {
+            next_actions: ["运行 miaoda plugin list 查看所有可用 capability id"],
+        });
     }
     try {
         const content = node_fs_1.default.readFileSync(filePath, "utf-8");
@@ -240,7 +251,9 @@ function readCapability(id) {
     }
     catch (error) {
         if (error instanceof SyntaxError) {
-            throw new error_1.AppError("INVALID_JSON", `Invalid JSON in capability file: ${id}.json`, { next_actions: [`检查 server/capabilities/${id}.json 的 JSON 语法`] });
+            throw new error_1.AppError("INVALID_JSON", `Invalid JSON in capability file: ${id}.json`, {
+                next_actions: [`检查 server/capabilities/${id}.json 的 JSON 语法`],
+            });
         }
         throw error;
     }
@@ -303,7 +316,9 @@ async function loadPlugin(pluginKey) {
     }
     catch (error) {
         if (error.code === "MODULE_NOT_FOUND") {
-            throw new error_1.AppError("PLUGIN_NOT_FOUND", `Plugin not installed: ${pluginKey}`, { next_actions: [`运行 miaoda plugin install ${pluginKey}`] });
+            throw new error_1.AppError("PLUGIN_NOT_FOUND", `Plugin not installed: ${pluginKey}`, {
+                next_actions: [`运行 miaoda plugin install ${pluginKey}`],
+            });
         }
         throw new error_1.AppError("INTERNAL_PLUGIN_LOAD_FAILED", `Failed to load plugin ${pluginKey}: ${error instanceof Error ? error.message : String(error)}`);
     }
@@ -314,8 +329,7 @@ async function hydrateCapability(capability) {
         if (manifest.actions.length === 0) {
             throw new error_1.AppError("INTERNAL_PLUGIN_LOAD_FAILED", `Plugin ${capability.pluginKey} has no actions defined`);
         }
-        const hasDynamic = manifest.actions.some((action) => isDynamicSchema(action.inputSchema) ||
-            isDynamicSchema(action.outputSchema));
+        const hasDynamic = manifest.actions.some((action) => isDynamicSchema(action.inputSchema) || isDynamicSchema(action.outputSchema));
         let pluginInstance = null;
         if (hasDynamic) {
             const plugin = await loadPlugin(capability.pluginKey);

package/dist/cli/handlers/plugin/plugin.js

@@ -44,7 +44,9 @@ const output_1 = require("../../../utils/output");
 const error_1 = require("../../../utils/error");
 const logger_1 = require("../../../utils/logger");
 const plugin_local_1 = require("./plugin-local");
-const log = (msg) => { (0, logger_1.log)("plugin", msg); };
+const log = (msg) => {
+    (0, logger_1.log)("plugin", msg);
+};
 // ── Install ──
 function syncActionPluginsRecord(name, version) {
     const plugins = (0, plugin_local_1.readActionPlugins)();
@@ -63,7 +65,9 @@ async function installOne(nameWithVersion) {
             if (actualVersion === requestedVersion) {
                 log(`${name}@${requestedVersion} already installed`);
                 syncActionPluginsRecord(name, actualVersion);
-                api.plugin.reportCreateInstanceEvent(name, actualVersion).catch(() => { });
+                api.plugin.reportCreateInstanceEvent(name, actualVersion).catch(() => {
+                    /* fire-and-forget */
+                });
                 return { name, version: actualVersion, success: true, skipped: true };
             }
         }
@@ -74,7 +78,9 @@ async function installOne(nameWithVersion) {
             if (actualVersion === targetVersion) {
                 log(`${name} already up to date (${actualVersion})`);
                 syncActionPluginsRecord(name, actualVersion);
-                api.plugin.reportCreateInstanceEvent(name, actualVersion).catch(() => { });
+                api.plugin.reportCreateInstanceEvent(name, actualVersion).catch(() => {
+                    /* fire-and-forget */
+                });
                 return { name, version: actualVersion, success: true, skipped: true };
             }
             log(`Found newer version: ${targetVersion} (installed: ${actualVersion ?? "none"})`);
@@ -106,8 +112,12 @@ async function installOne(nameWithVersion) {
         (0, plugin_local_1.writeActionPlugins)(plugins);
         const source = fromCache ? "from cache" : "downloaded";
         log(`Installed ${name}@${installedVersion} (${source})`);
-        api.plugin.reportInstallEvent(name, installedVersion).catch(() => { });
-        api.plugin.reportCreateInstanceEvent(name, installedVersion).catch(() => { });
+        api.plugin.reportInstallEvent(name, installedVersion).catch(() => {
+            /* fire-and-forget */
+        });
+        api.plugin.reportCreateInstanceEvent(name, installedVersion).catch(() => {
+            /* fire-and-forget */
+        });
         return { name, version: installedVersion, success: true };
     }
     catch (error) {
@@ -193,7 +203,9 @@ async function handlePluginUpdate(opts) {
 function handlePluginRemove(opts) {
     const { name } = (0, plugin_local_1.parsePluginName)(opts.name);
     if (!(0, plugin_local_1.isPluginInstalled)(name)) {
-        throw new error_1.AppError("PLUGIN_NOT_FOUND", `Plugin ${name} is not installed`, { next_actions: ["运行 miaoda plugin list-packages 查看已安装插件"] });
+        throw new error_1.AppError("PLUGIN_NOT_FOUND", `Plugin ${name} is not installed`, {
+            next_actions: ["运行 miaoda plugin list-packages 查看已安装插件"],
+        });
     }
     (0, plugin_local_1.removePluginDirectory)(name);
     const plugins = (0, plugin_local_1.readActionPlugins)();
@@ -263,7 +275,9 @@ async function handlePluginInit() {
 // ── List (capability configs) ──
 async function handlePluginList(opts) {
     if (!(0, plugin_local_1.capabilitiesDirExists)()) {
-        throw new error_1.AppError("CAPABILITIES_DIR_NOT_FOUND", "server/capabilities directory not found", { next_actions: ["当前目录必须是含 server/capabilities/ 的应用项目"] });
+        throw new error_1.AppError("CAPABILITIES_DIR_NOT_FOUND", "server/capabilities directory not found", {
+            next_actions: ["当前目录必须是含 server/capabilities/ 的应用项目"],
+        });
     }
     if (opts.id) {
         const capability = (0, plugin_local_1.readCapability)(opts.id);

package/dist/cli/help.js

@@ -115,7 +115,9 @@ class MiaodaHelp extends commander_1.Help {
         out.push("Usage:", `  ${helper.commandUsage(cmd)}`, "");
         // 3. Commands（仅父级命令组有，spec 要求 Commands 在 Flags 前）
         //    spec 不展示 Arguments 段，参数说明放在 description 文本里
-        const subs = helper.visibleCommands(cmd).map((c) => formatItem(helper.subcommandTerm(c), helper.subcommandDescription(c)));
+        const subs = helper
+            .visibleCommands(cmd)
+            .map((c) => formatItem(helper.subcommandTerm(c), helper.subcommandDescription(c)));
         if (subs.length) {
             out.push("Commands:", formatList(subs), "");
         }
@@ -125,7 +127,8 @@ class MiaodaHelp extends commander_1.Help {
         //    - `-h, --help` 永远不放 Flags 段，统一放 Global Flags（spec 约定）
         const isParent = subs.length > 0;
         if (!isRoot && !isParent) {
-            const opts = helper.visibleOptions(cmd)
+            const opts = helper
+                .visibleOptions(cmd)
                 .filter((o) => !isHelpOption(o))
                 .map((o) => formatItem(helper.optionTerm(o), helper.optionDescription(o)));
             if (opts.length) {

package/dist/utils/output.js

@@ -23,7 +23,7 @@ const SERVER_ERROR_HINTS = {
     // SELECT 结果集超过 1000 行硬拦：spec 多行引导。
     // key 用 BIZ_ERR_MAP 映射后的语义 code（不是原始服务端 k_dl_xxx），保持
     // 与 help / 文档里宣传的 RESULT_SET_TOO_LARGE 一致。
-    "RESULT_SET_TOO_LARGE": [
+    RESULT_SET_TOO_LARGE: [
         "Add `LIMIT <n>` to your SQL to narrow the result.",
         "For counts, use `SELECT count(*) FROM ...`; for aggregation, use GROUP BY with filters.",
     ],
@@ -90,9 +90,10 @@ function emitError(err) {
         if (typeof info.statement_index === "number") {
             const k = info.statement_index + 1;
             const n = info.total_statements;
-            errorLine += typeof n === "number" && n > 0
-                ? ` (at statement ${String(k)} of ${String(n)})`
-                : ` (at statement ${String(k)})`;
+            errorLine +=
+                typeof n === "number" && n > 0
+                    ? ` (at statement ${String(k)} of ${String(n)})`
+                    : ` (at statement ${String(k)})`;
         }
         process.stderr.write(errorLine + "\n");
         // 多行 hint：第一行带 "hint:" 标签，后续行用 8 空格缩进对齐 "  hint: " 之后的列。

package/dist/utils/render.js

@@ -81,20 +81,21 @@ const ANSI_SGR_RE = /\[[0-9;]*m/g;
  * 不实现合字 / 零宽字符（ZWJ / 变体选择符）等极端情况，CLI 表格场景够用。
  */
 function charWidth(cp) {
-    if ((cp >= 0x1100 && cp <= 0x115F) || // Hangul Jamo
-        cp === 0x2329 || cp === 0x232A ||
-        (cp >= 0x2E80 && cp <= 0x303E) || // CJK Radicals / Punctuation
-        (cp >= 0x3041 && cp <= 0x33FF) || // Hiragana / Katakana / CJK Symbols
-        (cp >= 0x3400 && cp <= 0x4DBF) || // CJK Ext A
-        (cp >= 0x4E00 && cp <= 0x9FFF) || // CJK Unified
-        (cp >= 0xA000 && cp <= 0xA4CF) || // Yi
-        (cp >= 0xAC00 && cp <= 0xD7A3) || // Hangul Syllables
-        (cp >= 0xF900 && cp <= 0xFAFF) || // CJK Compat Ideographs
-        (cp >= 0xFE30 && cp <= 0xFE4F) || // CJK Compat Forms
-        (cp >= 0xFF00 && cp <= 0xFF60) || // Fullwidth Forms
-        (cp >= 0xFFE0 && cp <= 0xFFE6) ||
-        (cp >= 0x20000 && cp <= 0x2FFFD) || // CJK Ext B-F
-        (cp >= 0x30000 && cp <= 0x3FFFD) // CJK Ext G-H
+    if ((cp >= 0x1100 && cp <= 0x115f) || // Hangul Jamo
+        cp === 0x2329 ||
+        cp === 0x232a ||
+        (cp >= 0x2e80 && cp <= 0x303e) || // CJK Radicals / Punctuation
+        (cp >= 0x3041 && cp <= 0x33ff) || // Hiragana / Katakana / CJK Symbols
+        (cp >= 0x3400 && cp <= 0x4dbf) || // CJK Ext A
+        (cp >= 0x4e00 && cp <= 0x9fff) || // CJK Unified
+        (cp >= 0xa000 && cp <= 0xa4cf) || // Yi
+        (cp >= 0xac00 && cp <= 0xd7a3) || // Hangul Syllables
+        (cp >= 0xf900 && cp <= 0xfaff) || // CJK Compat Ideographs
+        (cp >= 0xfe30 && cp <= 0xfe4f) || // CJK Compat Forms
+        (cp >= 0xff00 && cp <= 0xff60) || // Fullwidth Forms
+        (cp >= 0xffe0 && cp <= 0xffe6) ||
+        (cp >= 0x20000 && cp <= 0x2fffd) || // CJK Ext B-F
+        (cp >= 0x30000 && cp <= 0x3fffd) // CJK Ext G-H
     ) {
         return 2;
     }
@@ -126,9 +127,15 @@ function renderAlignedTable(headers, rows) {
         return w;
     });
     const lines = [];
-    lines.push(headers.map((h, i) => colors_1.c.header(padVisibleEnd(h, colWidths[i]))).join("  ").trimEnd());
+    lines.push(headers
+        .map((h, i) => colors_1.c.header(padVisibleEnd(h, colWidths[i])))
+        .join("  ")
+        .trimEnd());
     for (const row of rows) {
-        lines.push(row.map((cell, i) => padVisibleEnd(cell || "", colWidths[i])).join("  ").trimEnd());
+        lines.push(row
+            .map((cell, i) => padVisibleEnd(cell || "", colWidths[i]))
+            .join("  ")
+            .trimEnd());
     }
     return lines.join("\n");
 }
@@ -149,9 +156,7 @@ function renderKeyValue(pairs, isTty) {
         return pairs.map(([k, v]) => `${k}\t${v}`).join("\n");
     }
     const keyWidth = Math.max(...pairs.map(([k]) => k.length));
-    return pairs
-        .map(([k, v]) => `${colors_1.c.header(k.padStart(keyWidth))}:  ${v}`)
-        .join("\n");
+    return pairs.map(([k, v]) => `${colors_1.c.header(k.padStart(keyWidth))}:  ${v}`).join("\n");
 }
 /** 通用 isTTY 判定（stdout 是否交互终端）。Node 运行时 isTTY 为 true 或 undefined；TS 类型上 tty.WriteStream 定义为固定 true，绕开做运行时判断。 */
 function isStdoutTty() {
@@ -167,11 +172,16 @@ function parseDuration(input) {
     const n = Number(m[1]);
     const unit = m[2] || "s";
     switch (unit) {
-        case "s": return n;
-        case "m": return n * 60;
-        case "h": return n * 3600;
-        case "d": return n * 86400;
-        default: return n;
+        case "s":
+            return n;
+        case "m":
+            return n * 60;
+        case "h":
+            return n * 3600;
+        case "d":
+            return n * 86400;
+        default:
+            return n;
     }
 }
 /** 解析 size 字符串 `1MB` / `500KB` / `1GB` → 字节。 */
@@ -183,10 +193,15 @@ function parseSize(input) {
     const n = Number(m[1]);
     const unit = (m[2] || "B").toUpperCase();
     switch (unit) {
-        case "B": return Math.round(n);
-        case "KB": return Math.round(n * 1024);
-        case "MB": return Math.round(n * 1024 * 1024);
-        case "GB": return Math.round(n * 1024 * 1024 * 1024);
-        default: return Math.round(n);
+        case "B":
+            return Math.round(n);
+        case "KB":
+            return Math.round(n * 1024);
+        case "MB":
+            return Math.round(n * 1024 * 1024);
+        case "GB":
+            return Math.round(n * 1024 * 1024 * 1024);
+        default:
+            return Math.round(n);
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/miaoda-cli",
-  "version": "0.1.1-alpha.a1a5e34",
+  "version": "0.1.1-alpha.b2bef50",
   "description": "Miaoda 平台命令行工具，面向 Agent 调用",
   "type": "commonjs",
   "bin": {
@@ -35,7 +35,12 @@
     "@typescript-eslint/parser": "^8.58.2",
     "@vitest/coverage-v8": "^4.1.4",
     "eslint": "^9.25.1",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-import-resolver-typescript": "^4.4.4",
+    "eslint-plugin-boundaries": "^6.0.2",
+    "eslint-plugin-import": "^2.32.0",
     "husky": "^9.1.7",
+    "prettier": "^3.8.3",
     "tsc-alias": "^1.8.11",
     "tsx": "^4.19.4",
     "typescript": "^5.8.3",
@@ -46,6 +51,8 @@
     "build": "bash scripts/build.sh",
     "typecheck": "tsc --noEmit -p tsconfig.json",
     "lint": "eslint src/ --max-warnings 0",
+    "format": "prettier --write src/",
+    "format:check": "prettier --check src/",
     "test": "vitest run",
     "test:watch": "vitest",
     "test:integration": "vitest run --config vitest.integration.config.ts",