@lark-apaas/miaoda-cli 0.1.3 → 0.1.4

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

@@ -0,0 +1,413 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleDbRecoveryDiff = handleDbRecoveryDiff;
+exports.handleDbRecoveryApply = handleDbRecoveryApply;
+exports.formatRecoveryTargetForDisplay = formatRecoveryTargetForDisplay;
+const api = __importStar(require("../../../api/index"));
+const shared_1 = require("../../../cli/commands/shared");
+const colors_1 = require("../../../utils/colors");
+const error_1 = require("../../../utils/error");
+const output_1 = require("../../../utils/output");
+const poll_1 = require("../../../utils/poll");
+const render_1 = require("../../../utils/render");
+const time_1 = require("../../../utils/time");
+const _destructive_1 = require("../../../cli/handlers/db/_destructive");
+// ── recovery diff ──
+//
+// PITR preview 是异步任务：dataloom 立即返 previewRequestId，CLI 自己 poll 直到 success/failed。
+// 失败时 dataloom 已用 translateRestoreErr 把中文窗口错误翻成 PRD 英文 + k_dl_1300036 code，
+// CLI 走 decorateRecoveryError 补 hint。
+async function handleDbRecoveryDiff(target, opts) {
+    const appId = (0, shared_1.resolveAppId)(opts);
+    const ts = normalizeTimestamp(target);
+    const preview = await runRecoveryPreview(appId, ts, target);
+    renderDiff(ts, preview);
+}
+async function handleDbRecoveryApply(target, opts) {
+    const appId = (0, shared_1.resolveAppId)(opts);
+    const ts = normalizeTimestamp(target);
+    // 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, target);
+    const tablesAffected = preview.tablesAffected ?? preview.changes?.length ?? 0;
+    // 0 changes 短路：目标时间点与当前一致，apply 没意义。pretty 模式渲染 preview
+    // 的 "No changes — database is already at this state." 后直接退；--json 模式
+    // 返 status="no_changes" envelope 让下游识别。不进 confirm 也不下发 apply。
+    if ((preview.changes?.length ?? 0) === 0) {
+        if ((0, output_1.isJsonMode)()) {
+            (0, output_1.emitOk)((0, output_1.snakeCaseKeys)({
+                status: 'no_changes',
+                target: ts,
+                tablesAffected: 0,
+                elapsedSeconds: 0,
+            }));
+        }
+        else {
+            renderDiff(ts, preview);
+        }
+        return;
+    }
+    // --yes 跳过；非 TTY 抛 DESTRUCTIVE_REQUIRES_CONFIRM；TTY 渲染 diff（pretty）+ 交互确认。
+    // 不再用 isJsonMode() 做门 —— 见 _destructive.ts 注释。
+    if (opts.yes !== true) {
+        (0, _destructive_1.assertDestructiveAllowedInTty)(opts.yes);
+        // --json 模式跳过 pretty diff 渲染避免污染 stdout envelope；TTY pretty 模式渲染
+        if (!(0, output_1.isJsonMode)())
+            renderDiff(ts, preview);
+        const ok = await (0, _destructive_1.askYesNo)(`? Restore database to ${ts}? This will overwrite current data. (y/N) `);
+        if (!ok) {
+            (0, output_1.emit)('Aborted.');
+            return;
+        }
+    }
+    let result;
+    try {
+        result = await api.db.recover({ appId, target: ts, dryRun: false });
+    }
+    catch (err) {
+        throw decorateRecoveryError(err);
+    }
+    // 关键：墙钟从 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, target);
+    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)({
+            status: 'restored',
+            target: result.target,
+            tablesAffected,
+            elapsedSeconds: elapsed,
+        }));
+        return;
+    }
+    const tty = (0, render_1.isStdoutTty)();
+    const body = `Database restored to ${result.target} ` +
+        `(${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, rawTarget) {
+    try {
+        return await (0, poll_1.pollUntilDone)({
+            label: 'recovery apply',
+            spinnerLabel: `Restoring database (target: ${formatRecoveryTargetForDisplay(rawTarget)})`,
+            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
+ *   2. GET /db/recovery/preview?previewRequestId 直到 previewStatus=success/failed
+ *
+ * 错误透传：业务错误（窗口超限 / 格式错）由 dataloom 直接 throw，CLI 在 catch 里
+ * 补 hint。failed 状态下 dataloom 已把 errorMessage 翻好，CLI 包成 k_dl_1300036
+ * 让 decorateRecoveryError 命中窗口超限 hint。
+ */
+async function runRecoveryPreview(appId, ts, rawTarget) {
+    let triggered;
+    try {
+        triggered = await api.db.recover({ appId, target: ts, dryRun: true });
+    }
+    catch (err) {
+        throw decorateRecoveryError(err);
+    }
+    if (triggered.previewRequestId === undefined || triggered.previewRequestId === '') {
+        throw new error_1.AppError('INTERNAL_DB_ERROR', 'recovery diff did not return previewRequestId');
+    }
+    const previewRequestId = triggered.previewRequestId;
+    try {
+        return await (0, poll_1.pollUntilDone)({
+            label: 'recovery preview',
+            spinnerLabel: `Previewing recovery impact (target: ${formatRecoveryTargetForDisplay(rawTarget)})`,
+            intervalMs: 1000,
+            fetch: () => api.db.getRecoveryPreview({ appId, previewRequestId }),
+            isDone: (cur) => {
+                // dataloom 内部 pgsvc 返回首字母大写枚举（Pending/Running/Success/Failed），
+                // 但 admin-inner thrift 契约里写的是小写。客户端做大小写归一兜底，避免依赖
+                // 上游 case 一致性导致死循环。
+                const status = cur.previewStatus.toLowerCase();
+                if (status === 'success')
+                    return { done: true, value: cur };
+                if (status === 'failed') {
+                    // 复用 k_dl_1300036（窗口超限 / 预览失败的统一对外码），让 decorateRecoveryError
+                    // 命中后给 PITR 7 天窗口的 hint。errorMessage 优先用 dataloom 翻好的 PRD 文案。
+                    throw new error_1.AppError('DB_API_k_dl_1300036', cur.errorMessage ?? 'recovery preview failed');
+                }
+                return { done: false };
+            },
+        });
+    }
+    catch (err) {
+        throw decorateRecoveryError(err);
+    }
+}
+// ── helpers ──
+/**
+ * 把用户传入的 recovery target 解析成本地时区的 ISO 8601 字符串，
+ * 如 "2026-05-20T22:32:00+08:00"。无论用户传相对值（30m / 2h / 3d）还是绝对值，
+ * 都统一展示成"具体几点"，让用户一眼看清楚"目标恢复点是我本地几点"——
+ * "30m ago"这种相对描述虽然原样直观，但跟 backend dataloom 收到的实际时间点没有
+ * 显式对照，遇到长 poll 时间过去后会让人怀疑"算的到底是哪个点"。
+ *
+ * 不用 UTC 'Z' 后缀：用户读时间不直观；带 +/-HH:MM offset 一眼即懂时差。
+ * 解析失败 → 原样返回兜底，避免 spinner 渲染崩。
+ */
+function formatRecoveryTargetForDisplay(rawInput) {
+    const trimmed = rawInput.trim();
+    let ms;
+    try {
+        ms = (0, time_1.parseTimeToMs)(trimmed);
+    }
+    catch {
+        return trimmed;
+    }
+    return formatIsoWithLocalOffset(ms);
+}
+function formatIsoWithLocalOffset(ms) {
+    const d = new Date(ms);
+    const pad = (n) => String(n).padStart(2, '0');
+    // getTimezoneOffset 返回本地相对 UTC 的差值（分钟）— UTC 在东八区是 -480
+    const offsetMinutes = -d.getTimezoneOffset();
+    const sign = offsetMinutes >= 0 ? '+' : '-';
+    const absOffset = Math.abs(offsetMinutes);
+    const tz = `${sign}${pad(Math.floor(absOffset / 60))}:${pad(absOffset % 60)}`;
+    return (`${String(d.getFullYear())}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}` +
+        `T${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}${tz}`);
+}
+/**
+ * 把用户传入的时间统一成 ISO 8601 UTC 字符串发给 dataloom。
+ *
+ * 复用 utils/time.ts::parseTimeToMs（跟 file ls / db changelog / db audit list 同一套
+ * 解析器），支持四种形态：
+ *   - 相对时间：30s / 5m / 2h / 3d / 1w（从 now 往前推）
+ *   - 仅日期：  2026-04-15           → 本地时区当日 00:00:00
+ *   - 本地 datetime: 2026-04-15T10:00:00 → 本地时区
+ *   - ISO 8601 with TZ: 2026-04-15T10:00:00Z 或 2026-04-15T10:00:00+08:00
+ *
+ * 不接受松散 / 区域性格式（YYYY/MM/DD、'April 1 2026' 等）——parseTimeToMs 内部
+ * 用严格 regex 把这些拒掉，避免之前用 new Date(input) 兜底把脏值送到后端的坑。
+ */
+function normalizeTimestamp(input) {
+    if (input === '') {
+        throw new error_1.AppError('ARGS_INVALID', 'target timestamp is required', {
+            next_actions: ['Usage: miaoda db recovery diff|apply <timestamp>'],
+        });
+    }
+    return new Date((0, time_1.parseTimeToMs)(input)).toISOString();
+}
+// PRD diff 输出，三套：
+//
+// TTY pretty（缩进 prose、带 Unicode 箭头、表名按列对齐）：
+//   Recovery preview (→ 2026-04-15T10:00:00Z):
+//
+//     tables affected: 2
+//     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
+//   orders\ttable will be restored
+//   estimated_time\t30
+//
+// --json：标准 envelope，字段名固定 snake_case。
+function renderDiff(target, preview) {
+    const changes = preview.changes ?? [];
+    const tablesAffected = preview.tablesAffected ?? changes.length;
+    const estimated = preview.estimatedSeconds;
+    if ((0, output_1.isJsonMode)()) {
+        (0, output_1.emitOk)((0, output_1.snakeCaseKeys)({
+            target,
+            tablesAffected,
+            changes: changes.map((c) => ({
+                table: c.table,
+                inserted: c.inserted,
+                deleted: c.deleted,
+                action: c.action,
+                droppedAt: c.droppedAt,
+            })),
+            estimatedSeconds: estimated ?? 30,
+        }));
+        return;
+    }
+    const tty = (0, render_1.isStdoutTty)();
+    if (tty) {
+        (0, output_1.emit)(renderDiffTty(target, changes, tablesAffected, estimated));
+        return;
+    }
+    (0, output_1.emit)(renderDiffPipe(target, changes, tablesAffected, estimated));
+}
+function renderDiffTty(target, changes, tablesAffected, estimated) {
+    const header = `Recovery preview (→ ${target}):`;
+    if (changes.length === 0) {
+        return `${header}\n\n  No changes — database is already at this state.`;
+    }
+    // 对齐：所有表名右侧补到 max(len) + 1 个 ":" + 1 个空格再起描述。PRD 用例里
+    // "users:   " / "orders:  " 三/二空格其实就是按 6 个 char 列宽对齐出来的。
+    const maxName = Math.max(...changes.map((c) => c.table.length));
+    const lines = [header, '', `  tables affected: ${String(tablesAffected)}`];
+    for (const c of changes) {
+        const pad = ' '.repeat(Math.max(1, maxName - c.table.length + 2));
+        lines.push(`  ${c.table}:${pad}${describeChange(c)}`);
+    }
+    // PRD 要求 estimated time 块固定出现（即便 dataloom 当前没填 EstimatedSeconds，
+    // CLI 也用 30s 兜底——PRD 示例展示的就是 30s，统一一个不至于误导的常量）。
+    lines.push('');
+    lines.push(`  estimated time: ~${String(estimated ?? 30)}s`);
+    return lines.join('\n');
+}
+function renderDiffPipe(target, changes, tablesAffected, estimated) {
+    // 管道场景：去掉缩进，TAB 分列，箭头降级为 ->，key 用 snake_case，
+    // estimated_time 只输出秒数（不带 ~/s），方便 awk/grep。
+    const header = `Recovery preview (-> ${target}):`;
+    if (changes.length === 0) {
+        return `${header}\nNo changes — database is already at this state.`;
+    }
+    const lines = [header, `tables_affected\t${String(tablesAffected)}`];
+    for (const c of changes) {
+        lines.push(`${c.table}\t${describeChange(c)}`);
+    }
+    // 与 TTY 一致，始终输出 estimated_time（默认 30），让 awk 解析时不用兜底。
+    lines.push(`estimated_time\t${String(estimated ?? 30)}`);
+    return lines.join('\n');
+}
+function describeChange(c) {
+    // 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') {
+        return 'table will be restored';
+    }
+    if (c.action === 'drop_table') {
+        return 'table will be dropped';
+    }
+    if (c.action === 'alter_table') {
+        return 'table will be altered';
+    }
+    if (c.action === 'unavailable') {
+        return `diff unavailable${c.droppedAt !== undefined && c.droppedAt !== '' ? `: ${c.droppedAt}` : ''}`;
+    }
+    // 数据变更：+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'}`);
+    }
+    return parts.length === 0 ? 'no changes' : parts.join(', ');
+}
+/**
+ * 解析 dataloom 嵌在 message 末尾的窗口边界，形如 `[2026-04-09T12:00:00Z ~ 2026-04-16T12:00:00Z]`。
+ * 命中返 `{start, end}`，否则 null。两侧时间字符串原样透传给 hint，不做归一化。
+ */
+function parseWindowBounds(message) {
+    const m = /\[([^[\]]+?)\s*~\s*([^[\]]+?)\]\s*$/.exec(message);
+    if (!m)
+        return null;
+    const start = m[1].trim();
+    const end = m[2].trim();
+    if (start === '' || end === '')
+        return null;
+    return { start, end };
+}
+// decorateRecoveryError 给 recovery 路径上的几个错误码补 PRD 规定的 hint。
+// dataloom 后端只返 message + code，hint 由 CLI 端按错误码映射；其它错误码原样透传。
+function decorateRecoveryError(err) {
+    if (!(err instanceof error_1.AppError))
+        return err;
+    switch (err.code) {
+        case 'DB_API_k_dl_1300036': {
+            // 窗口超限：dataloom 端会把当前窗口边界拼成 `[<startISO> ~ <endISO>]` 嵌到 message
+            // 末尾，CLI 在这里提取出来按 PRD 格式 hint。提取失败时退回通用提示。
+            const bounds = parseWindowBounds(err.message);
+            if (bounds === null) {
+                return new error_1.AppError(err.code, err.message, {
+                    next_actions: [
+                        'PITR window is up to 7 days back, limited by your last `db migration apply` time.',
+                    ],
+                });
+            }
+            // message 里把 [start ~ end] 段移除掉，避免重复
+            const cleanMsg = err.message.replace(/\s*\[[^\]]*\]\s*$/, '');
+            return new error_1.AppError(err.code, cleanMsg, {
+                next_actions: [
+                    `Current recoverable window: ${bounds.start} ~ ${bounds.end}`,
+                    `(limited by last migration apply at ${bounds.start})`,
+                ],
+            });
+        }
+        case 'DB_API_k_dl_1300038':
+            // 时间格式错误：引导 ISO 8601
+            return new error_1.AppError(err.code, err.message, {
+                next_actions: ['Use ISO 8601 format, e.g. 2026-04-15 or 2026-04-15T10:00:00Z'],
+            });
+        default:
+            return err;
+    }
+}

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

@@ -46,7 +46,7 @@ async function handleDbSchemaList(opts) {
     const appId = opts.appId;
     const resp = await api.db.getSchema({
         appId,
-        format: "schema",
+        format: 'schema',
         includeStats: true,
         dbBranch: opts.env,
     });
@@ -56,24 +56,24 @@ async function handleDbSchemaList(opts) {
         return;
     }
     if (tables.length === 0) {
-        (0, output_1.emit)("No tables found.");
+        (0, output_1.emit)('No tables found.');
         return;
     }
     const tty = (0, render_1.isStdoutTty)();
     // PRD 对齐：TTY 表头用 `size`（友好格式），non-TTY 用 `size_bytes`（原始整数）。
     // updated_at 暂时不展示——PG pg_catalog 不存真实表时间，详见 renderDetail 注释。
     const headers = [
-        "name",
-        "description",
-        "estimated_row_count",
-        tty ? "size" : "size_bytes",
-        "columns",
+        'name',
+        'description',
+        'estimated_row_count',
+        tty ? 'size' : 'size_bytes',
+        'columns',
     ];
     const rows = tables.map((t) => [
         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.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),
         String(t.columns),
     ]);
     (0, output_1.emit)(tty ? (0, render_1.renderAlignedTable)(headers, rows) : (0, render_1.renderTsv)(headers, rows));
@@ -87,13 +87,13 @@ async function handleDbSchemaGet(table, opts) {
         // non-TTY 或 --ddl：直接取完整 DDL 输出
         const ddlResp = await api.db.getSchema({
             appId,
-            format: "ddl",
+            format: 'ddl',
             tableNames: table,
             dbBranch: opts.env,
         });
         const sql = ddlResp.ddl?.[table];
         if (!sql) {
-            throw new error_1.AppError("TABLE_NOT_FOUND", `Table '${table}' does not exist`, {
+            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.`,
                 ],
@@ -105,14 +105,14 @@ async function handleDbSchemaGet(table, opts) {
     // TTY / JSON：取结构化
     const resp = await api.db.getSchema({
         appId,
-        format: "schema",
+        format: 'schema',
         tableNames: table,
         includeStats: true,
         dbBranch: opts.env,
     });
     const detail = (0, index_1.pickTableDetail)(resp.schema, table);
     if (!detail) {
-        throw new error_1.AppError("TABLE_NOT_FOUND", `Table '${table}' does not exist`, {
+        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.`],
         });
     }
@@ -123,54 +123,54 @@ async function handleDbSchemaGet(table, opts) {
     (0, output_1.emit)(renderDetail(detail, tty));
 }
 function renderDetail(d, tty) {
-    const systemFields = d.columns.filter((c) => c.name.startsWith("_"));
-    const userFields = d.columns.filter((c) => !c.name.startsWith("_"));
+    const systemFields = d.columns.filter((c) => c.name.startsWith('_'));
+    const userFields = d.columns.filter((c) => !c.name.startsWith('_'));
     // header 布局：Name / Description / Columns(含"+ N system") / Estimated Rows / Size。
     // 不展示 Created / Updated：PG pg_catalog 不存表创建时间，dataloom 用 OID
     // 构造的伪时间戳（baseTime=2020-01-01 + OID 秒偏移），仅保排序意义、绝对值
     // 误导性强，先去掉。后续如果接 ddl_change_log 取真实时间再加回。
     const header = [
         // 表名做 cyan 强调（spec：spec 里的"命令名/表名"类强调值都走 highlight）
-        ["Name", tty ? colors_1.c.highlight(d.name) : d.name],
-        ["Description", d.description ?? "—"],
+        ['Name', tty ? colors_1.c.highlight(d.name) : d.name],
+        ['Description', d.description ?? '—'],
         [
-            "Columns",
+            'Columns',
             systemFields.length > 0
                 ? `${String(userFields.length)} (+ ${String(systemFields.length)} system)`
                 : String(userFields.length),
         ],
-        ["Estimated Rows", d.estimated_row_count === null ? "—" : String(d.estimated_row_count)],
-        ["Size", d.size_bytes === null ? "—" : (0, render_1.formatSize)(d.size_bytes)],
+        ['Estimated Rows', d.estimated_row_count === null ? '—' : String(d.estimated_row_count)],
+        ['Size', d.size_bytes === null ? '—' : (0, render_1.formatSize)(d.size_bytes)],
     ];
-    const colHeaders = ["column", "type", "nullable", "default", "comment"];
+    const colHeaders = ['column', 'type', 'nullable', 'default', 'comment'];
     const colRows = userFields.map((c) => [
         c.name,
         c.type,
-        c.nullable ? "yes" : "no",
-        c.default ?? "—",
-        c.comment ?? "—",
+        c.nullable ? 'yes' : 'no',
+        c.default ?? '—',
+        c.comment ?? '—',
     ]);
     const parts = [];
     parts.push((0, render_1.renderKeyValue)(header, tty));
-    parts.push("");
+    parts.push('');
     parts.push(tty ? (0, render_1.renderAlignedTable)(colHeaders, colRows) : (0, render_1.renderTsv)(colHeaders, colRows));
     // Constraints 段（PRIMARY KEY / UNIQUE）：表级约束独立成段，与普通索引分离展示
     if (d.constraints.length > 0) {
-        parts.push("");
-        parts.push(tty ? "  Constraints:" : "Constraints:");
+        parts.push('');
+        parts.push(tty ? '  Constraints:' : 'Constraints:');
         for (const c of d.constraints) {
-            const line = `${c.type} (${c.columns.join(", ")})`;
+            const line = `${c.type} (${c.columns.join(', ')})`;
             parts.push(tty ? `    ${line}` : line);
         }
     }
     // Indexes 段：普通索引，格式 "<name> ON <col1, col2> USING <method>"
     if (d.indexes.length > 0) {
-        parts.push("");
-        parts.push(tty ? "  Indexes:" : "Indexes:");
+        parts.push('');
+        parts.push(tty ? '  Indexes:' : 'Indexes:');
         for (const idx of d.indexes) {
-            const line = `${idx.name} ON ${idx.columns.join(", ")} USING ${idx.method}`;
+            const line = `${idx.name} ON ${idx.columns.join(', ')} USING ${idx.method}`;
             parts.push(tty ? `    ${line}` : line);
         }
     }
-    return parts.join("\n");
+    return parts.join('\n');
 }