@lark-apaas/miaoda-cli 0.1.2 → 0.1.3-alpha.09899c4

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; } });

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

@@ -0,0 +1,245 @@
+"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 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 spinner_1 = require("../../../utils/spinner");
+async function handleDbMigrationInit(opts) {
+    const appId = (0, shared_1.resolveAppId)(opts);
+    // 不可逆操作，TTY 默认要求 y/N；--yes 跳过
+    if (!opts.yes && !(0, output_1.isJsonMode)()) {
+        // 文案对齐 PRD：先讲不可逆，再问是否初始化；syncData 时追加一句而不是塞进同一句话
+        const suffix = opts.syncData ? ' (existing data will be copied to dev)' : '';
+        const ok = await confirm(`? This action is irreversible. Initialize multi-env (dev / online)${suffix}? (y/N) `);
+        if (!ok) {
+            (0, output_1.emit)('Aborted.');
+            return;
+        }
+    }
+    let result;
+    try {
+        result = await api.db.migrationInit({ appId, syncData: opts.syncData });
+    }
+    catch (err) {
+        // PRD: 重复 init 报错带 hint，引导用户去 diff 看待发布变更
+        if (err instanceof error_1.AppError && err.code === 'DB_API_k_dl_1300034') {
+            throw new error_1.AppError(err.code, err.message, {
+                next_actions: ['Run `miaoda db migration diff` to view pending changes.'],
+            });
+        }
+        throw err;
+    }
+    if ((0, output_1.isJsonMode)()) {
+        (0, output_1.emitOk)((0, output_1.snakeCaseKeys)(result));
+        return;
+    }
+    // PRD 单行格式（不用 key:value 表格）：
+    //   默认 ✓ / OK：     "Multi-env initialized (dev / online)"
+    //   --sync-data：      "Multi-env initialized, data synced to dev"
+    const tty = (0, render_1.isStdoutTty)();
+    const body = result.dataSynced
+        ? 'Multi-env initialized, data synced to dev'
+        : `Multi-env initialized (${result.environments.join(' / ')})`;
+    (0, output_1.emit)(tty ? colors_1.c.success(`✓ ${body}`) : `OK ${body}`);
+}
+async function handleDbMigrationDiff(opts) {
+    const appId = (0, shared_1.resolveAppId)(opts);
+    let result;
+    const stopSpinner = (0, spinner_1.startSpinner)('Computing migration diff');
+    try {
+        result = await api.db.migrate({ appId, dryRun: true });
+    }
+    catch (err) {
+        throw decorateMigrationError(err);
+    }
+    finally {
+        stopSpinner();
+    }
+    // PRD: diff 在无待发布变更时报错带 hint，而不是渲染空列表
+    if (result.changes.length === 0) {
+        throw new error_1.AppError('DB_API_k_dl_1300035', `No pending changes between ${result.from} and ${result.to}`, {
+            next_actions: [
+                'Make schema changes in dev first (e.g. `miaoda db sql "ALTER TABLE ..." --env dev`)',
+            ],
+        });
+    }
+    renderDiff(result);
+}
+async function handleDbMigrationApply(opts) {
+    const appId = (0, shared_1.resolveAppId)(opts);
+    // TTY 下先 diff 给用户审；--yes 直接打到 online
+    if (!opts.yes && !(0, output_1.isJsonMode)()) {
+        let preview;
+        const stopSpinner = (0, spinner_1.startSpinner)('Computing migration diff');
+        try {
+            preview = await api.db.migrate({ appId, dryRun: true });
+        }
+        catch (err) {
+            throw decorateMigrationError(err);
+        }
+        finally {
+            stopSpinner();
+        }
+        if (preview.changes.length === 0) {
+            // PRD 文案 + hint
+            throw new error_1.AppError('DB_API_k_dl_1300035', `No pending changes between ${preview.from} and ${preview.to}`, {
+                next_actions: [
+                    'Make schema changes in dev first (e.g. `miaoda db sql "ALTER TABLE ..." --env dev`)',
+                ],
+            });
+        }
+        renderDiff(preview);
+        const ok = await confirm(`? Apply ${String(preview.changes.length)} change(s) to ${preview.to}? (y/N) `);
+        if (!ok) {
+            (0, output_1.emit)('Aborted.');
+            return;
+        }
+    }
+    let result;
+    try {
+        result = await api.db.migrate({ appId, dryRun: false });
+    }
+    catch (err) {
+        throw decorateMigrationError(err);
+    }
+    // dataloom 立即返 taskId（apply 实际是异步流水线）。CLI 自己 poll 直到 success/failed，
+    // 避免单次 HTTP 长连接 30s+ 被网关 / SDK 中断。
+    if (result.taskId === undefined || result.taskId === '') {
+        throw new error_1.AppError('INTERNAL_DB_ERROR', 'migration apply did not return taskId');
+    }
+    const taskId = result.taskId;
+    const final = await (0, poll_1.pollUntilDone)({
+        label: 'migration apply',
+        spinnerLabel: 'Applying migration to online',
+        intervalMs: 1000,
+        fetch: () => api.db.getMigrationStatus({ appId, taskId }),
+        isDone: (cur) => {
+            // 同 recovery preview，dataloom 上下游枚举大小写不完全统一，客户端归一兜底。
+            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_1300030', cur.errorMessage ?? `migration apply failed (taskId=${taskId})`);
+            }
+            return { done: false };
+        },
+    });
+    const appliedCount = final.changesApplied ?? result.changes.length;
+    if ((0, output_1.isJsonMode)()) {
+        // PRD：{"status": "applied", "from": "dev", "to": "online", "changes_applied": 2}
+        (0, output_1.emitOk)((0, output_1.snakeCaseKeys)({
+            status: 'applied',
+            from: result.from,
+            to: result.to,
+            changesApplied: appliedCount,
+        }));
+        return;
+    }
+    const tty = (0, render_1.isStdoutTty)();
+    const arrow = tty ? '→' : '->';
+    const body = `Applied ${result.from} ${arrow} ${result.to} (${String(appliedCount)} changes)`;
+    (0, output_1.emit)(tty ? colors_1.c.success(`✓ ${body}`) : `OK ${body}`);
+}
+// ── helpers ──
+// PRD diff 输出：
+//   dev → online (2 changes):
+//
+//     ALTER TABLE users ADD COLUMN avatar_url text;
+//     CREATE INDEX idx_users_avatar ON users(avatar_url);
+function renderDiff(result) {
+    if ((0, output_1.isJsonMode)()) {
+        (0, output_1.emitOk)((0, output_1.snakeCaseKeys)({
+            from: result.from,
+            to: result.to,
+            changes: result.changes.map((c) => ({
+                type: c.type,
+                table: c.table,
+                statement: c.statement,
+            })),
+        }));
+        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 arrow = tty ? '→' : '->';
+    (0, output_1.emit)(`${result.from} ${arrow} ${result.to} (${String(result.changes.length)} changes):\n\n` +
+        result.changes.map((c) => `  ${c.statement}`).join('\n'));
+}
+// decorateMigrationError 给 migration / recovery 路径上的几个错误码补 PRD 规定的 hint。
+// dataloom 后端只返 message + code，hint 由 CLI 端按错误码映射；其它错误码原样透传。
+function decorateMigrationError(err) {
+    if (!(err instanceof error_1.AppError))
+        return err;
+    switch (err.code) {
+        case 'DB_API_k_dl_1300039':
+            // 多环境未初始化：引导先 init
+            return new error_1.AppError(err.code, err.message, {
+                next_actions: ['Run `miaoda db migration init` to set up multi-env first.'],
+            });
+        case 'DB_API_k_dl_1300035':
+            // 无待发布变更：引导先在 dev 改 schema
+            return new error_1.AppError(err.code, err.message, {
+                next_actions: [
+                    'Make schema changes in dev first (e.g. `miaoda db sql "ALTER TABLE ..." --env dev`)',
+                ],
+            });
+        default:
+            return err;
+    }
+}
+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,68 @@
+"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)()) {
+        // 配额未对接（storageQuotaBytes=0）时，quota / usage_percent 字段都不输出
+        const out = {
+            storageUsedBytes: data.storageUsedBytes,
+            tables: data.tables,
+            views: data.views,
+        };
+        if (data.storageQuotaBytes > 0) {
+            out.storageQuotaBytes = data.storageQuotaBytes;
+            out.usagePercent = data.usagePercent;
+        }
+        (0, output_1.emitOk)((0, output_1.snakeCaseKeys)(out));
+        return;
+    }
+    // PRD：单行 "Storage: 14.9 MB / 1 GB (1.5%)"；配额未对接时只显示 used
+    const tty = (0, render_1.isStdoutTty)();
+    const storageLine = data.storageQuotaBytes > 0
+        ? `${(0, render_1.formatSize)(data.storageUsedBytes)} / ${(0, render_1.formatSize)(data.storageQuotaBytes)} (${data.usagePercent.toFixed(1)}%)`
+        : (0, render_1.formatSize)(data.storageUsedBytes);
+    (0, output_1.emit)((0, render_1.renderKeyValue)([
+        ['Storage', storageLine],
+        ['Tables', String(data.tables)],
+        ['Views', String(data.views)],
+    ], tty));
+}