@lark-apaas/miaoda-cli 0.1.3-alpha.fbac0be → 0.1.3-alpha.fc1e1a9

package/dist/api/db/api.js

@@ -13,6 +13,7 @@ exports.migrate = migrate;
 exports.getMigrationStatus = getMigrationStatus;
 exports.recover = recover;
 exports.getRecoveryPreview = getRecoveryPreview;
+exports.getRecoveryStatus = getRecoveryStatus;
 exports.getDbQuota = getDbQuota;
 const http_1 = require("../../utils/http");
 const error_1 = require("../../utils/error");
@@ -572,6 +573,29 @@ async function getRecoveryPreview(opts) {
     const body = (await response.json());
     return (0, client_1.extractData)(body);
 }
+/**
+ * 后端：GET /v1/dataloom/app/{appId}/db/recovery/status
+ * CLI apply 触发后定时调本接口直到 status=success/failed。dataloom 内部 Redis
+ * 维护 workspace 级 restore 状态，无需传 task id；workspace+dbBranch 维度同时
+ * 只允许一个 restore 进行中。
+ */
+async function getRecoveryStatus(opts) {
+    const client = (0, http_1.getHttpClient)();
+    const url = (0, client_1.buildInnerUrl)(opts.appId, '/db/recovery/status', { dbBranch: opts.dbBranch });
+    const start = Date.now();
+    let response;
+    try {
+        response = await client.get(url);
+        (0, client_1.traceHttp)('GET', url, start, response);
+    }
+    catch (err) {
+        (0, client_1.traceHttp)('GET', url, start, err instanceof http_client_1.HttpError ? err.response : undefined, err);
+        await mapDbHttpError(err, url, 'Failed to get recovery status');
+        throw err; // 不可达
+    }
+    const body = (await response.json());
+    return (0, client_1.extractData)(body);
+}
 // ── db quota → InnerAdminGetDbQuota ──
 /**
  * 后端：GET /v1/dataloom/app/{appId}/db/quota?dbBranch=

package/dist/api/db/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.pickTableDetail = exports.flattenSchemaList = exports.parseSqlResult = exports.SQLSTATE_MAP = exports.ensureInnerSuccess = exports.buildInnerUrl = exports.getDbQuota = exports.getRecoveryPreview = exports.recover = exports.getMigrationStatus = exports.migrate = exports.migrationInit = exports.listAuditLog = exports.setAuditConfig = exports.getAuditStatus = exports.listDDLChangelog = exports.exportData = exports.importData = exports.getSchema = exports.execSql = void 0;
+exports.pickTableDetail = exports.flattenSchemaList = exports.parseSqlResult = exports.SQLSTATE_MAP = exports.ensureInnerSuccess = exports.buildInnerUrl = exports.getDbQuota = exports.getRecoveryStatus = exports.getRecoveryPreview = exports.recover = exports.getMigrationStatus = exports.migrate = exports.migrationInit = exports.listAuditLog = exports.setAuditConfig = exports.getAuditStatus = exports.listDDLChangelog = exports.exportData = exports.importData = exports.getSchema = exports.execSql = void 0;
 var api_1 = require("./api");
 Object.defineProperty(exports, "execSql", { enumerable: true, get: function () { return api_1.execSql; } });
 Object.defineProperty(exports, "getSchema", { enumerable: true, get: function () { return api_1.getSchema; } });
@@ -15,6 +15,7 @@ Object.defineProperty(exports, "migrate", { enumerable: true, get: function () {
 Object.defineProperty(exports, "getMigrationStatus", { enumerable: true, get: function () { return api_1.getMigrationStatus; } });
 Object.defineProperty(exports, "recover", { enumerable: true, get: function () { return api_1.recover; } });
 Object.defineProperty(exports, "getRecoveryPreview", { enumerable: true, get: function () { return api_1.getRecoveryPreview; } });
+Object.defineProperty(exports, "getRecoveryStatus", { enumerable: true, get: function () { return api_1.getRecoveryStatus; } });
 Object.defineProperty(exports, "getDbQuota", { enumerable: true, get: function () { return api_1.getDbQuota; } });
 var client_1 = require("./client");
 Object.defineProperty(exports, "buildInnerUrl", { enumerable: true, get: function () { return client_1.buildInnerUrl; } });

package/dist/api/file/client.js

@@ -90,7 +90,20 @@ const BIZ_ERR_MAP = new Map(Object.entries({
         message: 'A file at this path already exists',
         hint: 'Rename the target or delete the existing file first (`miaoda file rm`).',
     },
+    // k_ec_000040：file-storage 上游引擎层连不上下游服务（依赖抖动 / 远端 RPC 失败）。
+    // 文案不向用户暴露内部 code，统一成 INTERNAL_API_ERROR + 重试引导。
+    k_ec_000040: {
+        code: 'INTERNAL_API_ERROR',
+        message: 'Service temporarily unavailable',
+        hint: 'Please retry the command. If it keeps failing, share the x-tt-logid (via --verbose) with the on-call team.',
+    },
 }));
+// k_ec_* 命名空间是 file-storage 引擎层通用错误（基础设施 / 上游 RPC），不是
+// 用户输入问题。无显式条目时统一兜底成 INTERNAL_API_ERROR + 重试 hint，避免
+// 暴露内部 code 给最终用户。
+function isEngineCommonError(code) {
+    return /^k_ec_\d+$/.test(code);
+}
 function ensureSuccess(body) {
     // 后端 envelope 字段历史遗留多种命名：
     //   - ErrorCode / error_code: 部分接口
@@ -106,6 +119,15 @@ function ensureSuccess(body) {
             next_actions: mapped.hint ? [mapped.hint] : undefined,
         });
     }
+    // k_ec_* 引擎层错误统一兜底：用户视角是"服务暂时不可用"，重试即可，
+    // 不要把 `File API error [k_ec_000xxx]: <内部翻译>` 这种半成品文案抛给用户。
+    if (isEngineCommonError(code)) {
+        throw new error_1.AppError('INTERNAL_API_ERROR', 'Service temporarily unavailable', {
+            next_actions: [
+                `Please retry the command. If it keeps failing, share the x-tt-logid (via --verbose) with the on-call team. (upstream code: ${code})`,
+            ],
+        });
+    }
     throw new error_1.AppError(`FILE_API_${code}`, `File API error [${code}]: ${backendMsg}`);
 }
 /** 从 HttpError 的 response 里尝试读 body，用于拿后端返的业务 ErrorCode。 */
@@ -130,6 +152,24 @@ async function mapHttpError(err, opts) {
         if (body) {
             const code = body.ErrorCode ?? body.error_code ?? '';
             if (code && code !== '0') {
+                const mapped = BIZ_ERR_MAP.get(code);
+                if (mapped) {
+                    const msg = body.ErrorMessage ??
+                        body.error_message ??
+                        body.Message ??
+                        mapped.message ??
+                        err.message;
+                    throw new error_1.AppError(mapped.code, mapped.message ?? msg, {
+                        next_actions: mapped.hint ? [mapped.hint] : undefined,
+                    });
+                }
+                if (isEngineCommonError(code)) {
+                    throw new error_1.AppError('INTERNAL_API_ERROR', 'Service temporarily unavailable', {
+                        next_actions: [
+                            `Please retry the command. If it keeps failing, share the x-tt-logid (via --verbose) with the on-call team. (upstream code: ${code})`,
+                        ],
+                    });
+                }
                 const msg = body.ErrorMessage ?? body.error_message ?? body.Message ?? err.message;
                 throw new error_1.AppError(`FILE_API_${code}`, `File API error [${code}]: ${msg}`);
             }

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

@@ -79,7 +79,7 @@ Examples:
         .command('list')
         .summary('列出所有表的概览（表名、行数、大小等）')
         .description('列出当前应用所有表的概览信息：表名、描述、行数、大小、列数、最近更新时间。\n' +
-        '查看单表完整结构请用 `schema get`；查看 DDL 变更历史请用 `changelog`（P1）。')
+        '查看单表完整结构请用 `schema get`；查看 DDL 变更历史请用 `changelog`。')
         .usage('[flags]')
         .action(async function () {
         await (0, index_1.handleDbSchemaList)({ ...this.optsWithGlobals(), appId: (0, shared_1.resolveAppId)({}) });

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

@@ -212,9 +212,29 @@ Examples:
 `);
     fileCmd
         .command('quota')
-        .summary('查看文件存储用量与限额')
+        .summary('查看文件存储的用量与配额')
+        .description('查看文件存储的用量与配额。')
         .usage('[flags]')
         .action(async function () {
         await (0, index_1.handleFileQuota)(this.optsWithGlobals());
-    });
+    })
+        .addHelpText('after', `
+Examples:
+  $ miaoda file quota
+   Storage:  150 MB / 1 GB (15%)
+     Files:  42
+
+  # --json
+  $ miaoda file quota --json
+  {
+    "data": {
+      "storage_used_bytes": 157286400,
+      "storage_quota_bytes": 1073741824,
+      "usage_percent": 15,
+      "files": 42
+    },
+    "next_cursor": null,
+    "has_more": false
+  }
+`);
 }

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

@@ -0,0 +1,35 @@
+"use strict";
+// changelog / audit 共用：把后端透传的 operator 字符串还原成 {id, name}。
+//
+// 后端约定：Operator 字段值是 `{"id":"<user_id>","name":"<resolved_name>"}` JSON
+// 字符串（dataloom inner_service.encodeOperator 生成），用同一字段同时承载机器可
+// 识别的 user_id 与人类可读 name。
+//
+// 选择"字符串内嵌 JSON"而不是 IDL struct，是为了避免 dataloom_inner.thrift +
+// kitex_gen 跨仓库改造；CLI 端 JSON.parse 拆开即可分场景渲染：
+//   - --json 模式：返 {id, name} 对象（agent / 下游能区分同名用户）
+//   - pretty 模式：只取 name（兼容 PRD 原始 string 形态）
+//
+// 历史数据 / 旧版后端没接这层时，operator 仍是纯字符串。该函数兼容：
+//   - 解析失败 → 当作 {id: raw, name: raw}
+//   - 解析成功但缺字段 → 用现有字段兜底另一个
+// 解析失败默认不报错，保留 raw 作为兜底显示文本。
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseOperator = parseOperator;
+function parseOperator(raw) {
+    if (raw === undefined || raw === null || raw === '') {
+        return { id: '', name: '' };
+    }
+    if (!raw.startsWith('{')) {
+        return { id: raw, name: raw };
+    }
+    try {
+        const obj = JSON.parse(raw);
+        const id = typeof obj.id === 'string' ? obj.id : '';
+        const name = typeof obj.name === 'string' && obj.name !== '' ? obj.name : id;
+        return { id, name };
+    }
+    catch {
+        return { id: raw, name: raw };
+    }
+}

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

@@ -44,6 +44,7 @@ const error_1 = require("../../../utils/error");
 const output_1 = require("../../../utils/output");
 const render_1 = require("../../../utils/render");
 const time_1 = require("../../../utils/time");
+const _operator_1 = require("../../../cli/handlers/db/_operator");
 const VALID_RETENTION = new Set(['7d', '30d', '180d', '360d', 'forever']);
 async function handleDbAuditStatus(table, opts) {
     const appId = (0, shared_1.resolveAppId)(opts);
@@ -198,25 +199,32 @@ async function handleDbAuditList(tables, opts) {
     // 后端管理（本质也是 ISO 时间），CLI 不再混用 cursor/since。
     const since = normalizeTime(opts.since, '--since');
     const until = normalizeTime(opts.until, '--until');
-    const result = await api.db.listAuditLog({
-        appId,
-        tables,
-        since,
-        until,
-        limit,
-        cursor: opts.cursor,
-        dbBranch: opts.env,
-    });
+    let result;
+    try {
+        result = await api.db.listAuditLog({
+            appId,
+            tables,
+            since,
+            until,
+            limit,
+            cursor: opts.cursor,
+            dbBranch: opts.env,
+        });
+    }
+    catch (err) {
+        throw decorateAuditListError(err, tables);
+    }
     const visible = result.items;
     const skipped = result.skipped;
     // PRD JSON：data 是数组，元素是事件对象（snake_case），分页信封 next_cursor / has_more
+    // operator 后端用 JSON 字符串内嵌 {id, name}，--json 输出还原成对象供下游消费
     if ((0, output_1.isJsonMode)()) {
         const items = visible.map((it) => ({
             event_id: it.eventId,
             event_time: it.eventTime,
             target_table: it.targetTable,
             type: it.type,
-            operator: it.operator,
+            operator: (0, _operator_1.parseOperator)(it.operator),
             summary: it.summary,
             // before/after 服务端是 JSON 字符串，反序列化回结构化对象供下游消费
             ...(it.before !== undefined ? { before: safeParseJson(it.before) } : {}),
@@ -224,7 +232,7 @@ async function handleDbAuditList(tables, opts) {
         }));
         (0, output_1.emitPaged)(items, result.nextCursor, result.hasMore);
         if (skipped.length > 0) {
-            process.stderr.write(`(${String(skipped.length)} table(s) skipped: ${skipped.join(', ')})\n`);
+            process.stderr.write(formatSkippedHint(skipped, tables.length) + '\n');
         }
         if (visible.length === 0)
             process.exitCode = 1;
@@ -233,7 +241,7 @@ async function handleDbAuditList(tables, opts) {
     if (visible.length === 0) {
         (0, output_1.emit)('No audit log entries found.');
         if (skipped.length > 0) {
-            process.stderr.write(`(${String(skipped.length)} table(s) skipped: ${skipped.join(', ')})\n`);
+            process.stderr.write(formatSkippedHint(skipped, tables.length) + '\n');
         }
         process.exitCode = 1;
         return;
@@ -247,12 +255,19 @@ async function handleDbAuditList(tables, opts) {
     const rows = visible.map((it) => {
         const eventTime = (0, render_1.formatTime)(it.eventTime, tty);
         // event_id 完整透传——PRD 截图里的 "..." 只是文档省略写法，不是 CLI 行为
-        const cells = [eventTime, it.type, it.eventId, it.operator || '—', it.summary];
+        // operator pretty 只展示 name；--json 上面已经走 parseOperator 输出 {id, name}
+        const cells = [
+            eventTime,
+            it.type,
+            it.eventId,
+            (0, _operator_1.parseOperator)(it.operator).name || '—',
+            it.summary,
+        ];
         return isMultiTable ? [it.targetTable, ...cells] : cells;
     });
     (0, output_1.emit)(tty ? (0, render_1.renderAlignedTable)(headers, rows) : (0, render_1.renderTsv)(headers, rows));
     if (skipped.length > 0) {
-        process.stderr.write(`(${String(skipped.length)} table(s) skipped: ${skipped.join(', ')})\n`);
+        process.stderr.write(formatSkippedHint(skipped, tables.length) + '\n');
     }
     if (result.hasMore && result.nextCursor) {
         process.stderr.write(`(more results; use --cursor '${result.nextCursor}')\n`);
@@ -278,6 +293,53 @@ function normalizeTime(input, flagName) {
         throw err;
     }
 }
+// PRD 41-48 行格式：`— Skipped 1 of 3 tables: orders (audit not enabled)`
+// 服务端约定 skipped 列表 = audit 未启用的表（表不存在直接 raise k_dl_000005），
+// 所以原因固定为 "audit not enabled"，无需带每项 reason。
+function formatSkippedHint(skipped, totalRequested) {
+    const items = skipped.map((t) => `${t} (audit not enabled)`).join(', ');
+    return `— Skipped ${String(skipped.length)} of ${String(totalRequested)} tables: ${items}`;
+}
+// audit list 后端错误码加 hint：
+//   - k_dl_000005  表不存在 → 文案与 hint 对齐 `db schema get` 的统一格式
+//   - k_dl_1300040 单表 audit 未启用 → 指引 enable
+//   - k_dl_1300041 多表全部未启用 → 指引 status
+function decorateAuditListError(err, tables) {
+    if (!(err instanceof error_1.AppError))
+        return err;
+    if (err.code === 'DB_API_k_dl_000005') {
+        // 不复用 dataloom 透传的 message（旧版/新版文案不一致：`table [x] not exist` /
+        // `table x not found`），统一改写成跟 schema get 一样的 `Table '<name>' does not exist`，
+        // 单表传 tables[0]，多表场景兜底用解析到的 raw message 里第一个表名。
+        const t = tables.length > 0 ? tables[0] : (extractMissingTable(err.message) ?? '<table>');
+        return new error_1.AppError('TABLE_NOT_FOUND', `Table '${t}' does not exist`, {
+            next_actions: [`Did you mean another table? Run "miaoda db schema list" to see all tables.`],
+        });
+    }
+    if (err.code === 'DB_API_k_dl_1300040') {
+        const t = tables[0] ?? '<table>';
+        return new error_1.AppError(err.code, err.message, {
+            next_actions: [`Enable with: miaoda db audit enable ${t}`],
+        });
+    }
+    if (err.code === 'DB_API_k_dl_1300041') {
+        return new error_1.AppError(err.code, err.message, {
+            next_actions: ['Check audit status with: miaoda db audit status'],
+        });
+    }
+    return err;
+}
+// extractMissingTable 从 dataloom 原始文案里抠表名兜底。dataloom 端有两种格式：
+//   - 旧版：`Table [foo] doesn't exist` / `table [foo] not exist`
+//   - 新版（本次 commits）：`table foo not found`
+// 都失配时返 null，调用方走 `<table>` 占位。
+function extractMissingTable(msg) {
+    const bracket = /\[([^\]]+)\]/.exec(msg);
+    if (bracket)
+        return bracket[1];
+    const m = /table\s+([\w.]+)\s+not (?:exist|found)/i.exec(msg);
+    return m ? m[1] : null;
+}
 // 服务端 before/after 是 JSON 字符串透传，CLI JSON 输出再反序列化回对象，
 // 给下游 jq 等工具消费。失败时透传原始字符串避免数据丢失。
 function safeParseJson(s) {

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

@@ -40,11 +40,12 @@ const error_1 = require("../../../utils/error");
 const output_1 = require("../../../utils/output");
 const render_1 = require("../../../utils/render");
 const time_1 = require("../../../utils/time");
+const _operator_1 = require("../../../cli/handlers/db/_operator");
 function toRow(it) {
     return {
         change_id: it.changeId,
         changed_at: it.changedAt,
-        operator: it.operator,
+        operator: (0, _operator_1.parseOperator)(it.operator),
         target_table: it.targetTable,
         change_type: it.changeType,
         summary: it.summary,
@@ -115,10 +116,11 @@ async function handleDbChangelog(opts) {
     const tty = (0, render_1.isStdoutTty)();
     // PRD: change_id / changed_at / operator / target_table / change_type / summary
     const headers = ['change_id', 'changed_at', 'operator', 'target_table', 'change_type', 'summary'];
+    // pretty 渲染只展示 operator.name（兼容 PRD 原 string 形态）；--json 走 toRow 输出完整对象
     const rows = allItems.map((it) => [
         it.changeId,
         (0, render_1.formatTime)(it.changedAt, tty),
-        it.operator || '—',
+        (0, _operator_1.parseOperator)(it.operator).name || '—',
         it.targetTable || '—',
         it.changeType,
         it.summary || '—',

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

@@ -61,15 +61,11 @@ async function handleDbRecoveryDiff(target, opts) {
 async function handleDbRecoveryApply(target, opts) {
     const appId = (0, shared_1.resolveAppId)(opts);
     const ts = normalizeTimestamp(target);
-    // PRD 要求 apply 输出包含 N tables affected / Ms elapsed，dataloom apply 路径不
-    // 回带这俩信息（pgsvc.BranchRestore 是异步触发、不等终态）。所以 CLI 这里始终
-    // 先跑一次 preview——它本来就是 PITR 推荐流程，--yes 时静默跑、TTY 时同时给用户审。
+    // PRD 要求 apply 输出包含 N tables affected / Ms elapsed。
+    // tables_affected 从 preview 拿；elapsed 用 CLI 端墙钟（dataloom apply 是异步
+    // 触发，server-side elapsed=0；下面 poll 真终态后用本地计时器算 elapsed）。
     const preview = await runRecoveryPreview(appId, ts);
     const tablesAffected = preview.tablesAffected ?? preview.changes?.length ?? 0;
-    // dataloom 端 apply 是异步触发，elapsed_seconds 返 0。这里改用 preview 给出的
-    // estimated_seconds 当 "预计耗时"，更贴近 PRD 示例的 30s elapsed 含义；
-    // 都没填时按 PRD 默认值 30 兜底。
-    const elapsedFromPreview = preview.estimatedSeconds ?? 30;
     if (!opts.yes && !(0, output_1.isJsonMode)()) {
         renderDiff(ts, preview);
         const ok = await confirm(`? Restore database to ${ts}? This will overwrite current data. (y/N) `);
@@ -85,7 +81,12 @@ async function handleDbRecoveryApply(target, opts) {
     catch (err) {
         throw decorateRecoveryError(err);
     }
-    const elapsed = result.elapsedSeconds && result.elapsedSeconds > 0 ? result.elapsedSeconds : elapsedFromPreview;
+    // 关键：墙钟从 apply 触发瞬间开始，poll 真完成时停。dataloom restore 是异步触发，
+    // 立即返 status="restore_triggered"，CLI 必须 poll GET /db/recovery/status 拿
+    // Redis 缓存的 Resetting/Ready/Failed，否则用户会被误导以为已恢复完。
+    const startedAt = Date.now();
+    await waitRecoveryDone(appId, ts);
+    const elapsed = Math.max(1, Math.round((Date.now() - startedAt) / 1000));
     if ((0, output_1.isJsonMode)()) {
         // PRD：{"status": "restored", "target": "...", "tables_affected": N, "elapsed_seconds": M}
         (0, output_1.emitOk)((0, output_1.snakeCaseKeys)({
@@ -101,6 +102,37 @@ async function handleDbRecoveryApply(target, opts) {
         `(${String(tablesAffected)} tables affected, ${String(elapsed)}s elapsed)`;
     (0, output_1.emit)(tty ? colors_1.c.success(`✓ ${body}`) : `OK ${body}`);
 }
+/**
+ * 触发 BranchRestore 后 poll 直到任务终态。dataloom 端 Redis 缓存 workspace 级
+ * status，归一成 running / success / failed：
+ *   - running → 继续 poll
+ *   - success → 退出，CLI 渲染 ✓
+ *   - failed  → 抛 DB_API_k_dl_1300036 + errorMessage
+ *
+ * 不设固定超时：BranchRestore 实际时长依库大小变化（前端文案示例 1 分钟，大库可能
+ * 几分钟），由 pollUntilDone 内置 60 分钟上限兜底，远超正常场景。
+ */
+async function waitRecoveryDone(appId, target) {
+    try {
+        return await (0, poll_1.pollUntilDone)({
+            label: 'recovery apply',
+            intervalMs: 2000,
+            fetch: () => api.db.getRecoveryStatus({ appId }),
+            isDone: (cur) => {
+                const status = (cur.status || '').toLowerCase();
+                if (status === 'success')
+                    return { done: true, value: cur };
+                if (status === 'failed') {
+                    throw new error_1.AppError('DB_API_k_dl_1300036', cur.errorMessage ?? `recovery to ${target} failed`);
+                }
+                return { done: false };
+            },
+        });
+    }
+    catch (err) {
+        throw decorateRecoveryError(err);
+    }
+}
 /**
  * 触发 PITR 预览任务并轮询到终态：
  *   1. POST /db/recovery dryRun=true → previewRequestId
@@ -171,20 +203,20 @@ function normalizeTimestamp(input) {
 }
 // PRD diff 输出，三套：
 //
-// TTY pretty（缩进 prose、带 Unicode 箭头 / 波浪号、表名按列对齐）：
+// TTY pretty（缩进 prose、带 Unicode 箭头、表名按列对齐）：
 //   Recovery preview (→ 2026-04-15T10:00:00Z):
 //
 //     tables affected: 2
-//     users:   +3 rows, -1 row, ~5 rows modified
-//     orders:  table will be restored (was dropped at 10:25:00)
+//     users:   +3 rows, -1 row
+//     orders:  table will be restored
 //
 //     estimated time: ~30s
 //
 // non-TTY pretty（管道友好，扁平 TSV、ASCII 箭头、snake_case key、estimated_time 不带 ~/s）：
 //   Recovery preview (-> 2026-04-15T10:00:00Z):
 //   tables_affected\t2
-//   users\t+3 rows, -1 row, ~5 rows modified
-//   orders\ttable will be restored (was dropped at 10:25:00)
+//   users\t+3 rows, -1 row
+//   orders\ttable will be restored
 //   estimated_time\t30
 //
 // --json：标准 envelope，字段名固定 snake_case。
@@ -200,7 +232,6 @@ function renderDiff(target, preview) {
                 table: c.table,
                 inserted: c.inserted,
                 deleted: c.deleted,
-                modified: c.modified,
                 action: c.action,
                 droppedAt: c.droppedAt,
             })),
@@ -250,51 +281,31 @@ function renderDiffPipe(target, changes, tablesAffected, estimated) {
     return lines.join('\n');
 }
 function describeChange(c) {
-    // 表级操作：dataloom 现在把 schema diff 透出为 action="schema_<diffType>"，
-    // 老协议的 restore_table / drop / create 一并保留兼容。
+    // dataloom 端 action 是 PRD 三态 + unavailable 边界：
+    //   restore_table — schema diff 显示该表在目标时间点存在但当前没有
+    //   drop_table    — 该表当前有但目标时间点没有
+    //   alter_table   — 两侧都在但结构有差异（列 / 索引 / 关系等）
+    //   unavailable   — PITR diff 算不出来，droppedAt 字段复用透传 message
+    // 没 action 时是数据行数变化，走下面的 +N / -N 渲染。
     if (c.action === 'restore_table') {
-        const ts = c.droppedAt ? ` (was dropped at ${c.droppedAt})` : '';
-        return `table will be restored${ts}`;
+        return 'table will be restored';
     }
-    if (c.action === 'drop') {
-        const ts = c.droppedAt ? ` (was dropped at ${c.droppedAt})` : '';
-        return `table will be dropped${ts}`;
+    if (c.action === 'drop_table') {
+        return 'table will be dropped';
     }
-    if (c.action === 'create') {
-        const ts = c.droppedAt ? ` (was dropped at ${c.droppedAt})` : '';
-        return `table will be created${ts}`;
-    }
-    if (c.action?.startsWith('schema_') === true) {
-        // dataloom 透出的 schema diffType 来自 schema_handler/common/constants：
-        //   - create: 当前没这表 / 目标时间点有 → 恢复后表会被建出来（PRD 用 restored 表达）
-        //   - drop:   当前有 / 目标时间点没 → 恢复后会被删掉
-        //   - alter:  两侧都在但结构有差异 → 列 / 索引 / 关系等会被改回
-        const diffType = c.action.slice('schema_'.length);
-        const ts = c.droppedAt ? ` (was dropped at ${c.droppedAt})` : '';
-        switch (diffType) {
-            case 'create':
-                return `table will be restored${ts}`;
-            case 'drop':
-                return `table will be dropped${ts}`;
-            case 'alter':
-                return `schema will be altered${ts}`;
-            default:
-                return `schema changed${diffType !== '' ? ` (${diffType})` : ''}${ts}`;
-        }
+    if (c.action === 'alter_table') {
+        return 'table will be altered';
     }
     if (c.action === 'unavailable') {
-        // dataloom 端 count 失败的表，复用 droppedAt 透传 message
         return `diff unavailable${c.droppedAt !== undefined && c.droppedAt !== '' ? `: ${c.droppedAt}` : ''}`;
     }
-    // 数据变更：+N rows / -N rows / ~N rows modified
+    // 数据变更：+N rows / -N rows
     const parts = [];
     if (c.inserted !== undefined && c.inserted !== 0)
         parts.push(`+${String(c.inserted)} rows`);
     if (c.deleted !== undefined && c.deleted !== 0) {
         parts.push(`-${String(c.deleted)} ${c.deleted === 1 ? 'row' : 'rows'}`);
     }
-    if (c.modified !== undefined && c.modified !== 0)
-        parts.push(`~${String(c.modified)} rows modified`);
     return parts.length === 0 ? 'no changes' : parts.join(', ');
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/miaoda-cli",
-  "version": "0.1.3-alpha.fbac0be",
+  "version": "0.1.3-alpha.fc1e1a9",
   "description": "Miaoda 平台命令行工具，面向 Agent 调用",
   "type": "commonjs",
   "bin": {