@lark-apaas/miaoda-cli 0.1.2 → 0.1.3-alpha.2a09432

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

@@ -0,0 +1,303 @@
+"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.handleDbAuditStatus = handleDbAuditStatus;
+exports.handleDbAuditEnable = handleDbAuditEnable;
+exports.handleDbAuditDisable = handleDbAuditDisable;
+exports.handleDbAuditList = handleDbAuditList;
+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 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);
+    const items = await api.db.getAuditStatus({ appId, table, dbBranch: opts.env });
+    const rows = items.map(toAuditStatus);
+    // 单表查询但后端没记录 → 占位 enabled=false
+    if (table !== undefined && table !== '' && rows.length === 0) {
+        rows.push({ table, enabled: false, enabled_at: null, retention: null });
+    }
+    // PRD JSON：单表返 object，多表返 array
+    if ((0, output_1.isJsonMode)()) {
+        if (table !== undefined && rows.length === 1) {
+            (0, output_1.emitOk)((0, output_1.snakeCaseKeys)(rows[0]));
+        }
+        else {
+            (0, output_1.emitOk)((0, output_1.snakeCaseKeys)(rows));
+        }
+        return;
+    }
+    if (rows.length === 0) {
+        (0, output_1.emit)('No audit configuration found.');
+        return;
+    }
+    const tty = (0, render_1.isStdoutTty)();
+    // 单表 → key:value 形态
+    if (table !== undefined && rows.length === 1) {
+        const it = rows[0];
+        (0, output_1.emit)((0, render_1.renderKeyValue)([
+            ['Table', it.table],
+            ['Enabled', boolToYesNo(it.enabled)],
+            ['Enabled at', it.enabled_at ? (0, render_1.formatTime)(it.enabled_at, tty) : '—'],
+            ['Retention', it.retention ?? '—'],
+        ], tty));
+        return;
+    }
+    // 列表 → table 形态
+    const headers = ['table', 'enabled', 'enabled_at', 'retention'];
+    const out = rows.map((it) => [
+        it.table,
+        boolToYesNo(it.enabled),
+        it.enabled_at ? (0, render_1.formatTime)(it.enabled_at, tty) : '—',
+        it.retention ?? '—',
+    ]);
+    (0, output_1.emit)(tty ? (0, render_1.renderAlignedTable)(headers, out) : (0, render_1.renderTsv)(headers, out));
+}
+function toAuditStatus(s) {
+    return {
+        table: s.table,
+        enabled: s.enabled,
+        enabled_at: s.enabledAt ?? null,
+        retention: s.retention ?? null,
+    };
+}
+async function handleDbAuditEnable(table, opts) {
+    if (!table) {
+        throw new error_1.AppError('ARGS_INVALID', 'table name is required', {
+            next_actions: [
+                'Usage: miaoda db audit enable <table> [--retention 7d|30d|180d|360d|forever]',
+            ],
+        });
+    }
+    const retention = opts.retention ?? '7d';
+    if (!VALID_RETENTION.has(retention)) {
+        throw new error_1.AppError('INVALID_RETENTION', `Invalid retention '${retention}'`, {
+            next_actions: ['Allowed values: 7d, 30d, 180d, 360d, forever.'],
+        });
+    }
+    const appId = (0, shared_1.resolveAppId)(opts);
+    let status;
+    try {
+        status = await api.db.setAuditConfig({
+            appId,
+            table,
+            enabled: true,
+            retention,
+            dbBranch: opts.env,
+        });
+    }
+    catch (err) {
+        // PRD: 重复 enable 报错时附带 hint，引导用户去 status 看 retention 或换值更新
+        if (err instanceof error_1.AppError && err.code === 'DB_API_k_dl_1300030') {
+            throw new error_1.AppError(err.code, err.message, {
+                next_actions: [
+                    `Use \`miaoda db audit status ${table}\` to check current retention, or run this command with a different --retention to update.`,
+                ],
+            });
+        }
+        throw err;
+    }
+    // PRD JSON：{"data": {"table": "...", "enabled": true, "retention": "..."}}
+    if ((0, output_1.isJsonMode)()) {
+        (0, output_1.emitOk)((0, output_1.snakeCaseKeys)({
+            table: status.table,
+            enabled: status.enabled,
+            retention: status.retention ?? retention,
+        }));
+        return;
+    }
+    const tty = (0, render_1.isStdoutTty)();
+    // c.highlight 内部按 TTY/NO_COLOR/FORCE_COLOR 自动决定是否染色，无需再判 tty
+    const tableLabel = colors_1.c.highlight(`'${status.table}'`);
+    const body = `Audit enabled for table ${tableLabel} (retention: ${status.retention ?? retention})`;
+    (0, output_1.emit)(tty ? colors_1.c.success(`✓ ${body}`) : `OK ${body}`);
+}
+async function handleDbAuditDisable(table, opts) {
+    if (!table) {
+        throw new error_1.AppError('ARGS_INVALID', 'table name is required', {
+            next_actions: ['Usage: miaoda db audit disable <table>'],
+        });
+    }
+    const appId = (0, shared_1.resolveAppId)(opts);
+    let status;
+    try {
+        status = await api.db.setAuditConfig({
+            appId,
+            table,
+            enabled: false,
+            dbBranch: opts.env,
+        });
+    }
+    catch (err) {
+        // PRD: 重复 disable / 未启用就 disable 报错时附带 hint，引导用户去看哪些表已开启
+        if (err instanceof error_1.AppError && err.code === 'DB_API_k_dl_1300031') {
+            throw new error_1.AppError(err.code, err.message, {
+                next_actions: ['Use `miaoda db audit status` to see which tables have audit enabled.'],
+            });
+        }
+        throw err;
+    }
+    if ((0, output_1.isJsonMode)()) {
+        (0, output_1.emitOk)((0, output_1.snakeCaseKeys)({
+            table: status.table,
+            enabled: status.enabled,
+        }));
+        return;
+    }
+    const tty = (0, render_1.isStdoutTty)();
+    const body = `Audit disabled for table ${colors_1.c.highlight(`'${status.table}'`)}`;
+    (0, output_1.emit)(tty ? colors_1.c.success(`✓ ${body}`) : `OK ${body}`);
+}
+async function handleDbAuditList(tables, opts) {
+    if (tables.length === 0) {
+        throw new error_1.AppError('ARGS_INVALID', 'at least one table is required', {
+            next_actions: [
+                'Usage: miaoda db audit list <table> [<table>...] [--since ...] [--until ...]',
+            ],
+        });
+    }
+    const appId = (0, shared_1.resolveAppId)(opts);
+    const limit = opts.limit ?? 20;
+    // 时间字段归一化为 ISO 8601 UTC（服务端按 event_time 字段比较）。cursor 由
+    // 后端管理（本质也是 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,
+    });
+    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: (0, _operator_1.parseOperator)(it.operator),
+            summary: it.summary,
+            // before/after 服务端是 JSON 字符串，反序列化回结构化对象供下游消费
+            ...(it.before !== undefined ? { before: safeParseJson(it.before) } : {}),
+            ...(it.after !== undefined ? { after: safeParseJson(it.after) } : {}),
+        }));
+        (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`);
+        }
+        if (visible.length === 0)
+            process.exitCode = 1;
+        return;
+    }
+    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.exitCode = 1;
+        return;
+    }
+    const tty = (0, render_1.isStdoutTty)();
+    // PRD：多表渲染时第一列是 target_table，单表时去掉这一列
+    const isMultiTable = tables.length > 1;
+    const headers = isMultiTable
+        ? ['target_table', 'event_time', 'type', 'event_id', 'operator', 'summary']
+        : ['event_time', 'type', 'event_id', 'operator', 'summary'];
+    const rows = visible.map((it) => {
+        const eventTime = (0, render_1.formatTime)(it.eventTime, tty);
+        // event_id 完整透传——PRD 截图里的 "..." 只是文档省略写法，不是 CLI 行为
+        // 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`);
+    }
+    if (result.hasMore && result.nextCursor) {
+        process.stderr.write(`(more results; use --cursor '${result.nextCursor}')\n`);
+    }
+}
+// ── helpers ──
+/**
+ * 把用户传入的 since/until 归一成 ISO 8601 UTC 字符串；空串返 undefined。
+ * 支持格式见 utils/time.ts::TIMESTAMP_HELP（相对时间 / 日期 / 本地 datetime / ISO 8601）。
+ */
+function normalizeTime(input, flagName) {
+    if (input === undefined || input === '')
+        return undefined;
+    try {
+        return new Date((0, time_1.parseTimeToMs)(input)).toISOString();
+    }
+    catch (err) {
+        if (err instanceof error_1.AppError) {
+            throw new error_1.AppError(err.code, `${flagName}: ${err.message}`, {
+                next_actions: err.next_actions,
+            });
+        }
+        throw err;
+    }
+}
+// 服务端 before/after 是 JSON 字符串透传，CLI JSON 输出再反序列化回对象，
+// 给下游 jq 等工具消费。失败时透传原始字符串避免数据丢失。
+function safeParseJson(s) {
+    try {
+        return JSON.parse(s);
+    }
+    catch {
+        return s;
+    }
+}
+// PRD 输出 enabled 列用 yes/no 而非 true/false
+function boolToYesNo(b) {
+    return b ? 'yes' : 'no';
+}

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

@@ -0,0 +1,132 @@
+"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.handleDbChangelog = handleDbChangelog;
+const api = __importStar(require("../../../api/index"));
+const shared_1 = require("../../../cli/commands/shared");
+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: (0, _operator_1.parseOperator)(it.operator),
+        target_table: it.targetTable,
+        change_type: it.changeType,
+        summary: it.summary,
+        statement: it.statement,
+    };
+}
+/**
+ * 把用户传入的 since/until 归一成 ISO 8601 UTC 字符串；空串返 undefined。
+ * 支持格式见 utils/time.ts::TIMESTAMP_HELP（相对时间 / 日期 / 本地 datetime / ISO 8601）。
+ */
+function normalizeTime(input, flagName) {
+    if (input === undefined || input === '')
+        return undefined;
+    try {
+        return new Date((0, time_1.parseTimeToMs)(input)).toISOString();
+    }
+    catch (err) {
+        if (err instanceof error_1.AppError) {
+            throw new error_1.AppError(err.code, `${flagName}: ${err.message}`, {
+                next_actions: err.next_actions,
+            });
+        }
+        throw err;
+    }
+}
+async function handleDbChangelog(opts) {
+    const appId = (0, shared_1.resolveAppId)(opts);
+    const since = normalizeTime(opts.since, '--since');
+    const until = normalizeTime(opts.until, '--until');
+    const allItems = [];
+    let cursor = opts.cursor;
+    let lastCursor = null;
+    let lastHasMore = false;
+    // --all：循环到 hasMore=false；否则只拉一页
+    // 没传 --all 时翻页由调用方自己用 --cursor 串
+    for (;;) {
+        const page = await api.db.listDDLChangelog({
+            appId,
+            table: opts.table,
+            since,
+            until,
+            limit: opts.limit,
+            cursor,
+            dbBranch: opts.env,
+        });
+        allItems.push(...page.items);
+        lastCursor = page.nextCursor;
+        lastHasMore = page.hasMore;
+        if (!opts.all || !page.hasMore || !page.nextCursor)
+            break;
+        cursor = page.nextCursor;
+    }
+    if ((0, output_1.isJsonMode)()) {
+        const rows = allItems.map(toRow);
+        // --all 时已经把所有页合一起返，has_more=false / next_cursor=null
+        if (opts.all) {
+            (0, output_1.emitPaged)((0, output_1.snakeCaseKeys)(rows), null, false);
+        }
+        else {
+            (0, output_1.emitPaged)((0, output_1.snakeCaseKeys)(rows), lastCursor, lastHasMore);
+        }
+        return;
+    }
+    if (allItems.length === 0) {
+        (0, output_1.emit)('No DDL changes found.');
+        return;
+    }
+    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),
+        (0, _operator_1.parseOperator)(it.operator).name || '—',
+        it.targetTable || '—',
+        it.changeType,
+        it.summary || '—',
+    ]);
+    (0, output_1.emit)(tty ? (0, render_1.renderAlignedTable)(headers, rows) : (0, render_1.renderTsv)(headers, rows));
+    if (!opts.all && lastHasMore && lastCursor) {
+        process.stderr.write(`(more results; use --cursor ${lastCursor} or --all)\n`);
+    }
+}

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

@@ -38,40 +38,40 @@ exports.handleDbDataExport = handleDbDataExport;
 const fs = __importStar(require("node:fs/promises"));
 const path = __importStar(require("node:path"));
 const api = __importStar(require("../../../api/index"));
+const colors_1 = require("../../../utils/colors");
 const error_1 = require("../../../utils/error");
 const output_1 = require("../../../utils/output");
-const shared_1 = require("../../../cli/commands/shared");
 const render_1 = require("../../../utils/render");
-// P0 规格（对齐技术方案关键决策 2）
+// import / export 体积上限
 const MAX_SIZE_BYTES = 1 * 1024 * 1024; // 1 MB
 const MAX_ROWS = 5000;
 async function handleDbDataImport(file, opts) {
-    const appId = (0, shared_1.resolveAppId)(opts);
+    const appId = opts.appId;
     const ext = path.extname(file).toLowerCase();
-    const format = resolveFormat(opts.format, ext, "import");
+    const format = resolveFormat(opts.format, ext, 'import');
     let body;
     try {
         body = await fs.readFile(file);
     }
     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."],
+        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 err;
     }
     if (body.length > MAX_SIZE_BYTES) {
-        throw new error_1.AppError("IMPORT_SIZE_EXCEEDED", `Import exceeds 1 MB limit (file is ${String(body.length)} bytes)`, { next_actions: ["Split the file into chunks of ≤ 5000 rows / 1 MB and import separately."] });
+        throw new error_1.AppError('IMPORT_SIZE_EXCEEDED', `Import exceeds 1 MB limit (file is ${String(body.length)} bytes)`, { next_actions: ['Split the file into chunks of ≤ 5000 rows / 1 MB and import separately.'] });
     }
     const rowCount = countRows(body, format);
     if (rowCount > MAX_ROWS) {
-        throw new error_1.AppError("IMPORT_ROWS_EXCEEDED", `Import exceeds 5000 rows limit (file has ${String(rowCount)} rows)`, { next_actions: ["Split the file into chunks of ≤ 5000 rows / 1 MB and import separately."] });
+        throw new error_1.AppError('IMPORT_ROWS_EXCEEDED', `Import exceeds 5000 rows limit (file has ${String(rowCount)} rows)`, { next_actions: ['Split the file into chunks of ≤ 5000 rows / 1 MB and import separately.'] });
     }
     const tableName = opts.table ?? path.basename(file, ext);
     if (!tableName) {
-        throw new error_1.AppError("ARGS_INVALID", "Cannot infer target table from file name; specify --table");
+        throw new error_1.AppError('ARGS_INVALID', 'Cannot infer target table from file name; specify --table');
     }
     const result = await api.db.importData({
         appId,
@@ -91,28 +91,28 @@ async function handleDbDataImport(file, opts) {
     }
     const tty = (0, render_1.isStdoutTty)();
     (0, output_1.emit)(tty
-        ? `✓ Imported ${file} → table '${result.tableName}' (${String(result.recordCount)} rows)`
+        ? colors_1.c.success(`✓ Imported ${file} → table '${result.tableName}' (${String(result.recordCount)} rows)`)
         : `OK Imported ${file} -> table '${result.tableName}' (${String(result.recordCount)} rows)`);
 }
 async function handleDbDataExport(table, opts) {
-    const appId = (0, shared_1.resolveAppId)(opts);
-    const format = resolveFormat(opts.format, undefined, "export", "csv");
+    const appId = opts.appId;
+    const format = resolveFormat(opts.format, undefined, 'export', 'csv');
     const outputPath = opts.file ?? `${table}.${format}`;
     const limit = opts.limit ? Number(opts.limit) : MAX_ROWS;
     if (!Number.isInteger(limit) || limit <= 0 || limit > MAX_ROWS) {
-        throw new error_1.AppError("ARGS_INVALID", `--limit must be a positive integer ≤ ${String(MAX_ROWS)}`);
+        throw new error_1.AppError('ARGS_INVALID', `--limit must be a positive integer ≤ ${String(MAX_ROWS)}`);
     }
     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)
                 throw err;
-            if (err.code !== "ENOENT")
+            if (err.code !== 'ENOENT')
                 throw err;
         }
     }
@@ -123,7 +123,7 @@ 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)`, {
+        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.`,
             ],
@@ -145,33 +145,33 @@ async function handleDbDataExport(table, opts) {
     }
     const tty = (0, render_1.isStdoutTty)();
     (0, output_1.emit)(tty
-        ? `✓ Exported ${table} → ${outputPath} (${String(rows)} rows)`
+        ? colors_1.c.success(`✓ Exported ${table} → ${outputPath} (${String(rows)} rows)`)
         : `OK Exported ${table} -> ${outputPath} (${String(rows)} rows)`);
 }
 // ── 共用辅助 ──
 function resolveFormat(explicit, ext, scope, fallback) {
-    const raw = (explicit ?? ext ?? fallback ?? "").replace(/^\./, "").toLowerCase();
-    if (raw === "csv")
-        return "csv";
-    if (raw === "json")
-        return "json";
+    const raw = (explicit ?? ext ?? fallback ?? '').replace(/^\./, '').toLowerCase();
+    if (raw === 'csv')
+        return 'csv';
+    if (raw === 'json')
+        return 'json';
     // sql 仅 export 路径接受 —— import 端后端仍只支持 csv/json。
-    if (raw === "sql" && scope === "export")
-        return "sql";
-    const code = scope === "import" ? "IMPORT_FORMAT_UNSUPPORTED" : "EXPORT_FORMAT_UNSUPPORTED";
-    throw new error_1.AppError(code, `Unrecognized format '${raw || "(unspecified)"}'`, {
+    if (raw === 'sql' && scope === 'export')
+        return 'sql';
+    const code = scope === 'import' ? 'IMPORT_FORMAT_UNSUPPORTED' : 'EXPORT_FORMAT_UNSUPPORTED';
+    throw new error_1.AppError(code, `Unrecognized format '${raw || '(unspecified)'}'`, {
         next_actions: [
-            scope === "import"
-                ? "Supported formats: .csv, .json. Convert the file first, or rename with the correct extension."
-                : "Supported formats: csv, json, sql. Pass --format csv|json|sql.",
+            scope === 'import'
+                ? 'Supported formats: .csv, .json. Convert the file first, or rename with the correct extension.'
+                : 'Supported formats: csv, json, sql. Pass --format csv|json|sql.',
         ],
     });
 }
 function countRows(body, format) {
-    if (format === "csv") {
+    if (format === 'csv') {
         // 粗估：非空行数 - 表头 1 行
         let lines = 0;
-        const text = body.toString("utf8");
+        const text = body.toString('utf8');
         for (const line of text.split(/\r?\n/)) {
             if (line.length > 0)
                 lines += 1;
@@ -180,7 +180,7 @@ function countRows(body, format) {
     }
     // JSON：期望是顶层数组
     try {
-        const parsed = JSON.parse(body.toString("utf8"));
+        const parsed = JSON.parse(body.toString('utf8'));
         if (Array.isArray(parsed))
             return parsed.length;
         return 1;

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.handleDbDataExport = exports.handleDbDataImport = exports.handleDbSchemaGet = exports.handleDbSchemaList = exports.handleDbSql = void 0;
+exports.handleDbQuota = exports.handleDbRecoveryApply = exports.handleDbRecoveryDiff = exports.handleDbMigrationApply = exports.handleDbMigrationDiff = exports.handleDbMigrationInit = exports.handleDbAuditList = exports.handleDbAuditDisable = exports.handleDbAuditEnable = exports.handleDbAuditStatus = exports.handleDbChangelog = exports.handleDbDataExport = exports.handleDbDataImport = exports.handleDbSchemaGet = exports.handleDbSchemaList = exports.handleDbSql = void 0;
 var sql_1 = require("./sql");
 Object.defineProperty(exports, "handleDbSql", { enumerable: true, get: function () { return sql_1.handleDbSql; } });
 var schema_1 = require("./schema");
@@ -9,3 +9,19 @@ Object.defineProperty(exports, "handleDbSchemaGet", { enumerable: true, get: fun
 var data_1 = require("./data");
 Object.defineProperty(exports, "handleDbDataImport", { enumerable: true, get: function () { return data_1.handleDbDataImport; } });
 Object.defineProperty(exports, "handleDbDataExport", { enumerable: true, get: function () { return data_1.handleDbDataExport; } });
+var changelog_1 = require("./changelog");
+Object.defineProperty(exports, "handleDbChangelog", { enumerable: true, get: function () { return changelog_1.handleDbChangelog; } });
+var audit_1 = require("./audit");
+Object.defineProperty(exports, "handleDbAuditStatus", { enumerable: true, get: function () { return audit_1.handleDbAuditStatus; } });
+Object.defineProperty(exports, "handleDbAuditEnable", { enumerable: true, get: function () { return audit_1.handleDbAuditEnable; } });
+Object.defineProperty(exports, "handleDbAuditDisable", { enumerable: true, get: function () { return audit_1.handleDbAuditDisable; } });
+Object.defineProperty(exports, "handleDbAuditList", { enumerable: true, get: function () { return audit_1.handleDbAuditList; } });
+var migration_1 = require("./migration");
+Object.defineProperty(exports, "handleDbMigrationInit", { enumerable: true, get: function () { return migration_1.handleDbMigrationInit; } });
+Object.defineProperty(exports, "handleDbMigrationDiff", { enumerable: true, get: function () { return migration_1.handleDbMigrationDiff; } });
+Object.defineProperty(exports, "handleDbMigrationApply", { enumerable: true, get: function () { return migration_1.handleDbMigrationApply; } });
+var recovery_1 = require("./recovery");
+Object.defineProperty(exports, "handleDbRecoveryDiff", { enumerable: true, get: function () { return recovery_1.handleDbRecoveryDiff; } });
+Object.defineProperty(exports, "handleDbRecoveryApply", { enumerable: true, get: function () { return recovery_1.handleDbRecoveryApply; } });
+var quota_1 = require("./quota");
+Object.defineProperty(exports, "handleDbQuota", { enumerable: true, get: function () { return quota_1.handleDbQuota; } });