@lark-apaas/miaoda-cli 0.1.2-alpha.ccfdc05 → 0.1.2-alpha.d0d2ae1

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

@@ -0,0 +1,213 @@
+"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 error_1 = require("../../../utils/error");
+const output_1 = require("../../../utils/output");
+const render_1 = require("../../../utils/render");
+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 prefix = tty ? "✓" : "OK";
+    const body = result.dataSynced
+        ? "Multi-env initialized, data synced to dev"
+        : `Multi-env initialized (${result.environments.join(" / ")})`;
+    (0, output_1.emit)(`${prefix} ${body}`);
+}
+async function handleDbMigrationDiff(opts) {
+    const appId = (0, shared_1.resolveAppId)(opts);
+    let result;
+    try {
+        result = await api.db.migrate({ appId, dryRun: true });
+    }
+    catch (err) {
+        throw decorateMigrationError(err);
+    }
+    // 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;
+        try {
+            preview = await api.db.migrate({ appId, dryRun: true });
+        }
+        catch (err) {
+            throw decorateMigrationError(err);
+        }
+        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);
+    }
+    if ((0, output_1.isJsonMode)()) {
+        // PRD：{"status": "applied", "from": "dev", "to": "online", "changes_applied": 2}
+        (0, output_1.emitOk)((0, output_1.snakeCaseKeys)({
+            status: result.status ?? "applied",
+            from: result.from,
+            to: result.to,
+            changesApplied: result.changesApplied ?? result.changes.length,
+        }));
+        return;
+    }
+    const tty = (0, render_1.isStdoutTty)();
+    const prefix = tty ? "✓" : "OK";
+    const arrow = tty ? "→" : "->";
+    const applied = result.changesApplied ?? result.changes.length;
+    (0, output_1.emit)(`${prefix} Applied ${result.from} ${arrow} ${result.to} (${String(applied)} changes)`);
+}
+// ── 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/{app/update.js → db/quota.js}

@@ -33,27 +33,36 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.handleAppUpdate = handleAppUpdate;
+exports.handleDbQuota = handleDbQuota;
 const api = __importStar(require("../../../api/index"));
-const output_1 = require("../../../utils/output");
 const shared_1 = require("../../../cli/commands/shared");
-const index_1 = require("../../../api/app/index");
-/** miaoda app update [--app-id <id>] [--name <n>] [--description <d>] */
-async function handleAppUpdate(opts) {
-    if (opts.name === undefined && opts.description === undefined) {
-        (0, shared_1.failArgs)("至少需要 --name 或 --description 中的一个");
-    }
-    const appID = (0, shared_1.resolveAppId)({ appId: opts.appId });
-    await api.app.updateAppMeta({
-        appID,
-        name: opts.name,
-        description: opts.description,
-    });
-    // 服务端不回写新 meta，本地再 fetch 一次拿最新值给用户
-    const resp = await api.app.getAppInfo(appID);
-    const meta = resp.appInfo?.appMeta ?? {};
-    if (!(0, output_1.isJsonMode)()) {
-        process.stdout.write("✓ App updated successfully\n");
+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;
     }
-    (0, output_1.emit)({ data: meta, next_cursor: null, has_more: false }, index_1.appMetaSchema);
+    // 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));
 }

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

@@ -0,0 +1,228 @@
+"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.handleDbRecoveryDiff = handleDbRecoveryDiff;
+exports.handleDbRecoveryApply = handleDbRecoveryApply;
+const node_readline_1 = __importDefault(require("node:readline"));
+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");
+// ── recovery diff ──
+async function handleDbRecoveryDiff(target, opts) {
+    const appId = (0, shared_1.resolveAppId)(opts);
+    const ts = normalizeTimestamp(target);
+    let result;
+    try {
+        result = await api.db.recover({ appId, target: ts, dryRun: true });
+    }
+    catch (err) {
+        throw decorateRecoveryError(err);
+    }
+    renderDiff(result);
+}
+async function handleDbRecoveryApply(target, opts) {
+    const appId = (0, shared_1.resolveAppId)(opts);
+    const ts = normalizeTimestamp(target);
+    // PITR 高危：TTY 下先 diff 给用户审；--yes 直接执行
+    if (!opts.yes && !(0, output_1.isJsonMode)()) {
+        let preview;
+        try {
+            preview = await api.db.recover({ appId, target: ts, dryRun: true });
+        }
+        catch (err) {
+            throw decorateRecoveryError(err);
+        }
+        renderDiff(preview);
+        const ok = await confirm(`? Restore database to ${preview.target}? 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);
+    }
+    if ((0, output_1.isJsonMode)()) {
+        // PRD：{"status": "restored", "target": "...", "tables_affected": 2, "elapsed_seconds": 30}
+        (0, output_1.emitOk)((0, output_1.snakeCaseKeys)({
+            status: result.status ?? "restored",
+            target: result.target,
+            tablesAffected: result.tablesAffected,
+            elapsedSeconds: result.elapsedSeconds ?? 0,
+        }));
+        return;
+    }
+    const tty = (0, render_1.isStdoutTty)();
+    const prefix = tty ? "✓" : "OK";
+    (0, output_1.emit)(`${prefix} Database restored to ${result.target} ` +
+        `(${String(result.tablesAffected)} tables affected, ${String(result.elapsedSeconds ?? 0)}s elapsed)`);
+}
+// ── helpers ──
+/**
+ * 把用户传入的时间统一成 ISO 8601 UTC。
+ * 接受：`YYYY-MM-DD` / `YYYY-MM-DD HH:MM:SS` / 完整 ISO 8601。
+ */
+function normalizeTimestamp(input) {
+    const FORMAT_HINT = "Use ISO 8601 / yyyy-mm-dd / yyyy-mm-dd HH:MM:SS.";
+    if (input === "") {
+        throw new error_1.AppError("ARGS_INVALID", "target timestamp is required", {
+            next_actions: ["Usage: miaoda db recovery diff|apply <timestamp>"],
+        });
+    }
+    if (/^\d{4}-\d{2}-\d{2}$/.test(input)) {
+        return new Date(`${input}T00:00:00Z`).toISOString();
+    }
+    if (/^\d{4}-\d{2}-\d{2} \d{2}:\d{2}(:\d{2})?$/.test(input)) {
+        const d = new Date(input.replace(" ", "T"));
+        if (Number.isNaN(d.getTime())) {
+            throw new error_1.AppError("INVALID_TIMESTAMP", `Invalid timestamp format '${input}'`, {
+                next_actions: [FORMAT_HINT],
+            });
+        }
+        return d.toISOString();
+    }
+    const d = new Date(input);
+    if (Number.isNaN(d.getTime())) {
+        throw new error_1.AppError("INVALID_TIMESTAMP", `Invalid timestamp format '${input}'`, {
+            next_actions: [FORMAT_HINT],
+        });
+    }
+    return d.toISOString();
+}
+// PRD diff 输出（结构化 prose）：
+//   Recovery preview (→ 2026-04-15T10:00:00Z):
+//
+//     tables affected: 2
+//     users:   +3 rows, -1 row, ~5 rows modified
+//     orders:  table will be restored (was dropped at 10:25:00)
+//
+//     estimated time: ~30s
+function renderDiff(result) {
+    if ((0, output_1.isJsonMode)()) {
+        (0, output_1.emitOk)((0, output_1.snakeCaseKeys)({
+            target: result.target,
+            tablesAffected: result.tablesAffected,
+            changes: result.changes.map((c) => ({
+                table: c.table,
+                inserted: c.inserted,
+                deleted: c.deleted,
+                modified: c.modified,
+                action: c.action,
+                droppedAt: c.droppedAt,
+            })),
+            estimatedSeconds: result.estimatedSeconds ?? 0,
+        }));
+        return;
+    }
+    const tty = (0, render_1.isStdoutTty)();
+    const arrow = tty ? "→" : "->";
+    if (result.changes.length === 0) {
+        (0, output_1.emit)(`Recovery preview (${arrow} ${result.target}):\n\n` +
+            `  No changes — database is already at this state.`);
+        return;
+    }
+    const lines = [
+        `Recovery preview (${arrow} ${result.target}):`,
+        "",
+        `  tables affected: ${String(result.tablesAffected)}`,
+    ];
+    for (const c of result.changes) {
+        lines.push(`  ${c.table}:  ${describeChange(c)}`);
+    }
+    if (result.estimatedSeconds !== undefined) {
+        lines.push("");
+        lines.push(`  estimated time: ~${String(result.estimatedSeconds)}s`);
+    }
+    (0, output_1.emit)(lines.join("\n"));
+}
+function describeChange(c) {
+    if (c.action === "restore_table" || c.action === "drop" || c.action === "create") {
+        const ts = c.droppedAt ? ` (was dropped at ${c.droppedAt})` : "";
+        if (c.action === "restore_table")
+            return `table will be restored${ts}`;
+        if (c.action === "drop")
+            return `table will be dropped${ts}`;
+        return `table will be created${ts}`;
+    }
+    const parts = [];
+    if (c.inserted !== undefined && c.inserted !== 0)
+        parts.push(`+${String(c.inserted)} rows`);
+    if (c.deleted !== undefined && c.deleted !== 0) {
+        parts.push(`-${String(c.deleted)} ${c.deleted === 1 ? "row" : "rows"}`);
+    }
+    if (c.modified !== undefined && c.modified !== 0)
+        parts.push(`~${String(c.modified)} rows modified`);
+    return parts.length === 0 ? "no changes" : parts.join(", ");
+}
+// 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":
+            // 窗口超限：引导用户检查 last migration apply 时间
+            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.",
+                ],
+            });
+        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;
+    }
+}
+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/file/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.handleFileSign = exports.handleFileRm = exports.handleFileCp = exports.handleFileStat = exports.handleFileLs = void 0;
+exports.handleFileQuota = exports.handleFileSign = exports.handleFileRm = exports.handleFileCp = exports.handleFileStat = exports.handleFileLs = void 0;
 var ls_1 = require("./ls");
 Object.defineProperty(exports, "handleFileLs", { enumerable: true, get: function () { return ls_1.handleFileLs; } });
 var stat_1 = require("./stat");
@@ -11,3 +11,5 @@ var rm_1 = require("./rm");
 Object.defineProperty(exports, "handleFileRm", { enumerable: true, get: function () { return rm_1.handleFileRm; } });
 var sign_1 = require("./sign");
 Object.defineProperty(exports, "handleFileSign", { enumerable: true, get: function () { return sign_1.handleFileSign; } });
+var quota_1 = require("./quota");
+Object.defineProperty(exports, "handleFileQuota", { enumerable: true, get: function () { return quota_1.handleFileQuota; } });

package/dist/cli/handlers/{deploy/error-log.js → file/quota.js}

@@ -33,29 +33,34 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.handleDeployErrorLog = handleDeployErrorLog;
+exports.handleFileQuota = handleFileQuota;
 const api = __importStar(require("../../../api/index"));
-const output_1 = require("../../../utils/output");
 const shared_1 = require("../../../cli/commands/shared");
-const index_1 = require("../../../api/deploy/index");
-const helpers_1 = require("./helpers");
-/** miaoda deploy error-log <deploy-id> */
-async function handleDeployErrorLog(opts) {
-    if (!opts.deployId)
-        (0, shared_1.failArgs)("<deploy-id> 必填");
-    const appID = (0, shared_1.resolveAppId)({ appId: opts.appId });
-    (0, helpers_1.parseDeployId)(opts.deployId); // 仅校验数字形式；URL 直接用原字符串
-    const instanceID = opts.deployId;
-    const resp = await api.deploy.getErrorLog({ appID, instanceID });
-    // 信封带上 status 元信息（非 errorJobs 主体），便于 JSON 消费方读取
-    (0, output_1.emit)({
-        data: resp.errorJobs,
-        next_cursor: null,
-        has_more: false,
-    }, index_1.errorJobSchema);
-    // pretty 模式额外打一行整体状态（status 是 NodeStatus 数字）
-    if (!process.stdout.isTTY)
+const output_1 = require("../../../utils/output");
+const render_1 = require("../../../utils/render");
+async function handleFileQuota(opts) {
+    const appId = (0, shared_1.resolveAppId)(opts);
+    const data = await api.file.getStorageQuota({ appId });
+    if ((0, output_1.isJsonMode)()) {
+        // 配额未对接（storageQuotaBytes=0）时，quota / usage_percent 字段都不输出
+        const out = {
+            storageUsedBytes: data.storageUsedBytes,
+            files: data.files,
+        };
+        if (data.storageQuotaBytes > 0) {
+            out.storageQuotaBytes = data.storageQuotaBytes;
+            out.usagePercent = data.usagePercent;
+        }
+        (0, output_1.emitOk)((0, output_1.snakeCaseKeys)(out));
         return;
-    const statusText = (0, index_1.nodeStatusText)(resp.status) ?? String(resp.status);
-    process.stdout.write(`\n— pipeline status: ${statusText}\n`);
+    }
+    // PRD：单行 "Storage: 150 MB / 1 GB (15%)"；配额未对接时只显示 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],
+        ["Files", String(data.files)],
+    ], tty));
 }

package/dist/main.js

@@ -5,13 +5,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 const commander_1 = require("commander");
 const index_1 = require("./cli/commands/index");
-const shared_1 = require("./cli/commands/shared");
 const help_1 = require("./cli/help");
 const config_1 = require("./utils/config");
 const log_id_1 = require("./utils/log_id");
 const output_1 = require("./utils/output");
-const error_1 = require("./utils/error");
-const version_1 = require("./cli/version");
 const package_json_1 = __importDefault(require("../package.json"));
 // MiaodaHelp 对齐 CLI 规范（描述置顶 / Flags / Global Flags / 段顺序）：
 // 在 Command.prototype 上 patch createHelp，让所有命令实例（含动态注册的
@@ -23,14 +20,11 @@ const program = new commander_1.Command();
 const { version } = package_json_1.default;
 program
     .name("miaoda")
-    .description("妙搭平台 CLI，提供数据服务、文件存储等命令行操作。")
+    .description("妙搭平台 CLI，提供数据服务、文件存储、插件管理等命令行操作。")
     .usage("<command> [flags]")
-    .option("-v, --version", "显示版本号")
+    .version(version, "-v, --version", "显示版本号")
     .option("--json [fields]", "JSON 输出，可选字段级选择")
-    .addOption(new commander_1.Option("--output <format>", "输出格式（pretty | json，大小写不敏感）")
-    .choices(["pretty", "json"])
-    .argParser((0, shared_1.caseInsensitiveChoice)(["pretty", "json"]))
-    .default("pretty"))
+    .option("--output <format>", "输出格式（pretty|json）", "pretty")
     .option("--verbose", "debug 日志到 stderr")
     .helpOption("-h, --help", "显示帮助信息")
     .hook("preAction", (_thisCmd, actionCmd) => {
@@ -39,21 +33,7 @@ program
     (0, config_1.initConfigFromOpts)(opts);
 });
 (0, index_1.registerCommands)(program);
-const versionArg = (0, version_1.resolveRootVersionArg)(process.argv.slice(2));
-if (versionArg === "show") {
-    process.stdout.write(`${version}\n`);
-}
-else if (versionArg === "invalid-variant") {
-    (0, output_1.emitError)(new error_1.AppError("ARGS_INVALID", "版本参数仅支持精确的 -v 或 --version"));
-    process.exitCode = 2;
-}
-else if (versionArg === "invalid-placement") {
-    (0, output_1.emitError)(new error_1.AppError("ARGS_INVALID", "-v / --version 仅可在根命令单独使用，不能与其他命令或参数混用"));
-    process.exitCode = 2;
-}
-else {
-    program.parseAsync(process.argv).catch((err) => {
-        (0, output_1.emitError)(err);
-        process.exitCode = 1;
-    });
-}
+program.parseAsync(process.argv).catch((err) => {
+    (0, output_1.emitError)(err);
+    process.exitCode = 1;
+});