@lark-apaas/miaoda-cli 0.1.1 → 0.1.2-alpha.4d0ff57

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

@@ -0,0 +1,250 @@
+"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 index_1 = require("../../../api/file/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 index_2 = require("../../../api/db/index");
+// "forever" 不在后端支持范围（pg_audit ValidDay 只接 int64 天数），CLI 提前拦截
+const VALID_RETENTION = new Set(["7d", "30d", "180d", "360d"]);
+async function handleDbAuditStatus(table, opts) {
+    const appId = (0, shared_1.resolveAppId)(opts);
+    const sql = table !== undefined && table !== ""
+        ? `SELECT "table", enabled, enabled_at, retention FROM _dl_audit_config WHERE "table" = '${escapeSqlLiteral(table)}'`
+        : `SELECT "table", enabled, enabled_at, retention FROM _dl_audit_config ORDER BY "table"`;
+    const results = await api.db.execSql({ appId, sql, dbBranch: opts.env });
+    const rows = collectSelectRows(results);
+    // 单表查询：表未配置时给个 enabled=false 占位项，让 CLI 输出语义统一
+    if (table !== undefined && table !== "" && rows.length === 0) {
+        rows.push({ table, enabled: false });
+    }
+    const items = rows.map(toAuditStatus);
+    if ((0, output_1.isJsonMode)()) {
+        (0, output_1.emitOk)({ items });
+        return;
+    }
+    if (items.length === 0) {
+        (0, output_1.emit)("No audit configuration found.");
+        return;
+    }
+    const tty = (0, render_1.isStdoutTty)();
+    // 单表显式查询（rows.length=1 且对应输入 table）走 key/value 形态，更可读
+    if (table !== undefined && items.length === 1) {
+        const it = items[0];
+        (0, output_1.emit)((0, render_1.renderKeyValue)([
+            ["table", it.table],
+            ["enabled", String(it.enabled)],
+            ["enabled_at", it.enabled_at ? (0, render_1.formatTime)(it.enabled_at, tty) : "—"],
+            ["retention", it.retention ?? "—"],
+        ], tty));
+        return;
+    }
+    const headers = ["table", "enabled", "enabled_at", "retention"];
+    const out = items.map((it) => [
+        it.table,
+        String(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(row) {
+    return {
+        table: asString(row.table),
+        enabled: Boolean(row.enabled),
+        enabled_at: row.enabled_at == null ? null : asString(row.enabled_at),
+        retention: row.retention == null ? null : asString(row.retention),
+    };
+}
+// asString 把 SELECT 结果里的列值（unknown）安全地转成字符串。SQL 返回值通常是
+// string / number / boolean / null，但极端情况下也可能是 JSON 反序列化出的对象。
+// 直接 String(obj) 会得到 "[object Object]"，这里改用 typeof 分类避免。
+function asString(v, fallback = "") {
+    if (v == null)
+        return fallback;
+    if (typeof v === "string")
+        return v;
+    if (typeof v === "number" || typeof v === "boolean" || typeof v === "bigint")
+        return String(v);
+    return JSON.stringify(v);
+}
+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]"],
+        });
+    }
+    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."],
+        });
+    }
+    const appId = (0, shared_1.resolveAppId)(opts);
+    const status = await api.db.setAuditConfig({
+        appId,
+        table,
+        enabled: true,
+        retention,
+        dbBranch: opts.env,
+    });
+    if ((0, output_1.isJsonMode)()) {
+        (0, output_1.emitOk)({ status });
+        return;
+    }
+    (0, output_1.emit)(`✓ Audit enabled for '${status.table}' (retention=${status.retention ?? retention})`);
+}
+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);
+    const status = await api.db.setAuditConfig({
+        appId,
+        table,
+        enabled: false,
+        dbBranch: opts.env,
+    });
+    if ((0, output_1.isJsonMode)()) {
+        (0, output_1.emitOk)({ status });
+        return;
+    }
+    (0, output_1.emit)(`✓ Audit disabled for '${status.table}'`);
+}
+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 ?? 50;
+    // since 优先级：opts.cursor（前一页末条 event_time）> opts.since
+    const sinceRaw = opts.cursor ?? opts.since;
+    const since = normalizeTime(sinceRaw, "--since/--cursor");
+    const until = normalizeTime(opts.until, "--until");
+    const inList = tables.map((t) => `'${escapeSqlLiteral(t)}'`).join(",");
+    const whereParts = [`target_table IN (${inList})`];
+    if (since !== undefined)
+        whereParts.push(`event_time >= '${since}'`);
+    if (until !== undefined)
+        whereParts.push(`event_time <= '${until}'`);
+    const sql = `SELECT event_id, event_time, target_table, type, operator, summary, details ` +
+        `FROM _dl_audit_log WHERE ${whereParts.join(" AND ")} ORDER BY event_time DESC LIMIT ${String(limit + 1)}`;
+    const results = await api.db.execSql({ appId, sql, dbBranch: opts.env });
+    const allRows = collectSelectRows(results);
+    // 多取一条用于判断 hasMore；最终只展示 limit 行
+    const hasMore = allRows.length > limit;
+    const visible = hasMore ? allRows.slice(0, limit) : allRows;
+    const nextCursor = hasMore && visible.length > 0 ? asString(visible[visible.length - 1].event_time) : null;
+    // 多表混合时统计哪些表无记录，PRD 要求末尾汇总
+    const seen = new Set();
+    for (const r of visible)
+        seen.add(asString(r.target_table));
+    const skipped = tables.filter((t) => !seen.has(t));
+    if ((0, output_1.isJsonMode)()) {
+        (0, output_1.emitPaged)(visible, nextCursor, hasMore);
+        if (skipped.length > 0) {
+            process.stderr.write(`(${String(skipped.length)} table(s) skipped: ${skipped.join(", ")})\n`);
+        }
+        // 退出码：任一表有数据 → 0；全空 → 1（PRD 约定）
+        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)();
+    const headers = ["event_time", "target_table", "type", "operator", "summary"];
+    const rows = visible.map((it) => [
+        (0, render_1.formatTime)(asString(it.event_time), tty),
+        asString(it.target_table),
+        asString(it.type),
+        asString(it.operator, "—"),
+        asString(it.summary),
+    ]);
+    (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 (hasMore && nextCursor) {
+        process.stderr.write(`(more results; use --cursor '${nextCursor}')\n`);
+    }
+}
+// ── helpers ──
+function normalizeTime(input, flagName) {
+    if (input === undefined || input === "")
+        return undefined;
+    // ISO 8601 形如 2026-05-07T08:00:00Z 直接透传，避免 parseTimeFilterMs 在
+    // 严格 ISO 上重做一次会损精度
+    if (/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:?\d{2})$/.test(input)) {
+        return new Date(input).toISOString();
+    }
+    const ms = (0, index_1.parseTimeFilterMs)(input, flagName);
+    return new Date(ms).toISOString();
+}
+function collectSelectRows(results) {
+    const out = [];
+    for (const r of results) {
+        const parsed = (0, index_2.parseSqlResult)(r);
+        if (parsed.kind === "select")
+            out.push(...parsed.rows);
+    }
+    return out;
+}
+/**
+ * SQL 字符串字面量转义。仅处理单引号；表名 / 时间戳由调用方控制范围（白名单或
+ * 严格 ISO 8601 正则），不在此函数内做。
+ */
+function escapeSqlLiteral(s) {
+    return s.replace(/'/g, "''");
+}

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

@@ -0,0 +1,104 @@
+"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 index_1 = require("../../../api/file/index");
+const shared_1 = require("../../../cli/commands/shared");
+const output_1 = require("../../../utils/output");
+const render_1 = require("../../../utils/render");
+/** 把用户传入的 since/until 归一成 ISO 8601 UTC 字符串；空串返 undefined。 */
+function normalizeTime(input, flagName) {
+    if (input === undefined || input === "")
+        return undefined;
+    const ms = (0, index_1.parseTimeFilterMs)(input, flagName);
+    return new Date(ms).toISOString();
+}
+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)()) {
+        // --all 时已经把所有页合一起返，has_more=false / next_cursor=null
+        if (opts.all) {
+            (0, output_1.emitPaged)(allItems, null, false);
+        }
+        else {
+            (0, output_1.emitPaged)(allItems, lastCursor, lastHasMore);
+        }
+        return;
+    }
+    if (allItems.length === 0) {
+        (0, output_1.emit)("No DDL changes found.");
+        return;
+    }
+    const tty = (0, render_1.isStdoutTty)();
+    const headers = ["change_id", "changed_at", "operator", "target_table", "type", "summary"];
+    const rows = allItems.map((it) => [
+        it.changeId,
+        (0, render_1.formatTime)(it.changedAt, tty),
+        it.operator || "—",
+        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

@@ -42,7 +42,7 @@ 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) {
@@ -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;
     }
@@ -100,6 +102,20 @@ async function handleDbDataExport(table, opts) {
     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)}`);
     }
+    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."],
+            });
+        }
+        catch (err) {
+            if (err instanceof error_1.AppError)
+                throw err;
+            if (err.code !== "ENOENT")
+                throw err;
+        }
+    }
     const result = await api.db.exportData({
         appId,
         tableName: table,
@@ -107,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/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; } });

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

@@ -0,0 +1,127 @@
+"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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleDbMigrationInit = handleDbMigrationInit;
+exports.handleDbMigrationDiff = handleDbMigrationDiff;
+exports.handleDbMigrationApply = handleDbMigrationApply;
+const node_readline_1 = __importDefault(require("node:readline"));
+const api = __importStar(require("../../../api/index"));
+const shared_1 = require("../../../cli/commands/shared");
+const output_1 = require("../../../utils/output");
+const render_1 = require("../../../utils/render");
+async function handleDbMigrationInit(opts) {
+    const appId = (0, shared_1.resolveAppId)(opts);
+    // PRD：不可逆操作，TTY 默认要求 y/N；--yes 跳过
+    if (!opts.yes && !(0, output_1.isJsonMode)()) {
+        const ok = await confirm(`? Initialize multi-env (single → dev/online), this is IRREVERSIBLE${opts.syncData ? " and will copy existing data to dev" : ""}? (y/N) `);
+        if (!ok) {
+            (0, output_1.emit)("Aborted.");
+            return;
+        }
+    }
+    const result = await api.db.migrationInit({ appId, syncData: opts.syncData });
+    if ((0, output_1.isJsonMode)()) {
+        (0, output_1.emitOk)(result);
+        return;
+    }
+    const tty = (0, render_1.isStdoutTty)();
+    (0, output_1.emit)((0, render_1.renderKeyValue)([
+        ["status", result.status],
+        ["environments", result.environments.join(", ")],
+        ["data_synced", String(result.dataSynced)],
+    ], tty));
+}
+async function handleDbMigrationDiff(opts) {
+    const appId = (0, shared_1.resolveAppId)(opts);
+    const result = await api.db.migrate({ appId, dryRun: true });
+    renderMigrate(result);
+}
+async function handleDbMigrationApply(opts) {
+    const appId = (0, shared_1.resolveAppId)(opts);
+    // 先 diff 一次给用户确认
+    const preview = await api.db.migrate({ appId, dryRun: true });
+    if (preview.changes.length === 0) {
+        if ((0, output_1.isJsonMode)()) {
+            (0, output_1.emitOk)({ ...preview, status: "no_pending_changes" });
+        }
+        else {
+            (0, output_1.emit)("No pending changes from dev to online.");
+        }
+        return;
+    }
+    if (!opts.yes && !(0, output_1.isJsonMode)()) {
+        renderMigrate(preview);
+        const ok = await confirm(`? Apply ${String(preview.changes.length)} change(s) from ${preview.from} to ${preview.to}? (y/N) `);
+        if (!ok) {
+            (0, output_1.emit)("Aborted.");
+            return;
+        }
+    }
+    const result = await api.db.migrate({ appId, dryRun: false });
+    renderMigrate(result);
+}
+function renderMigrate(result) {
+    if ((0, output_1.isJsonMode)()) {
+        (0, output_1.emitOk)(result);
+        return;
+    }
+    const tty = (0, render_1.isStdoutTty)();
+    if (result.changes.length === 0) {
+        (0, output_1.emit)(`No pending changes from ${result.from} to ${result.to}.`);
+        return;
+    }
+    const headers = ["type", "table", "statement"];
+    const rows = result.changes.map((c) => [c.type, c.table, c.statement]);
+    (0, output_1.emit)(tty ? (0, render_1.renderAlignedTable)(headers, rows) : (0, render_1.renderTsv)(headers, rows));
+    if (result.dryRun) {
+        (0, output_1.emit)(`(dry-run: ${String(result.changes.length)} change(s) preview, run \`db migration apply\` to commit)`);
+    }
+    else {
+        (0, output_1.emit)(`✓ Applied ${String(result.changesApplied ?? result.changes.length)} change(s) from ${result.from} to ${result.to}`);
+    }
+}
+// ── confirm ──
+async function confirm(prompt) {
+    const rl = node_readline_1.default.createInterface({ input: process.stdin, output: process.stderr });
+    return new Promise((resolve) => {
+        rl.question(prompt, (answer) => {
+            rl.close();
+            resolve(answer.trim().toLowerCase() === "y");
+        });
+    });
+}

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

@@ -0,0 +1,60 @@
+"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.handleDbQuota = handleDbQuota;
+const api = __importStar(require("../../../api/index"));
+const shared_1 = require("../../../cli/commands/shared");
+const output_1 = require("../../../utils/output");
+const render_1 = require("../../../utils/render");
+async function handleDbQuota(opts) {
+    const appId = (0, shared_1.resolveAppId)(opts);
+    const data = await api.db.getDbQuota({ appId, dbBranch: opts.env });
+    if ((0, output_1.isJsonMode)()) {
+        (0, output_1.emitOk)(data);
+        return;
+    }
+    const tty = (0, render_1.isStdoutTty)();
+    // quota=0 表示后端未对接配额上限，按 PRD 渲染 "—"
+    const used = (0, render_1.formatSize)(data.storageUsedBytes);
+    const total = data.storageQuotaBytes > 0 ? (0, render_1.formatSize)(data.storageQuotaBytes) : "—";
+    const pct = data.storageQuotaBytes > 0 ? `${data.usagePercent.toFixed(1)}%` : "—";
+    (0, output_1.emit)((0, render_1.renderKeyValue)([
+        ["used", used],
+        ["quota", total],
+        ["usage", pct],
+        ["tables", String(data.tables)],
+        ["views", String(data.views)],
+    ], tty));
+}