@lark-apaas/miaoda-cli 0.1.2-alpha.55feccd → 0.1.2-alpha.5fec91b

package/dist/api/deploy/schemas.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.errorJobSchema = exports.deployGetSchema = exports.deployHistorySchema = void 0;
+exports.nodeStatusText = nodeStatusText;
+exports.nodeStatusFromText = nodeStatusFromText;
+const output_1 = require("../../utils/output");
+const types_1 = require("./types");
+const NODE_STATUS_TEXT = {
+    [types_1.NodeStatus.UNSPECIFIED]: "unknown",
+    [types_1.NodeStatus.TODO]: "todo",
+    [types_1.NodeStatus.RUNNING]: "running",
+    [types_1.NodeStatus.SUCCESS]: "success",
+    [types_1.NodeStatus.FAILED]: "failed",
+    [types_1.NodeStatus.CANCELED]: "canceled",
+    [types_1.NodeStatus.HOLD_ON]: "hold_on",
+};
+function nodeStatusText(v) {
+    if (typeof v !== "number")
+        return undefined;
+    return NODE_STATUS_TEXT[v];
+}
+/** NodeStatus 文本（CLI flag 字符串）→ 枚举数值 */
+function nodeStatusFromText(text) {
+    const lower = text.toLowerCase();
+    for (const [num, label] of Object.entries(NODE_STATUS_TEXT)) {
+        if (label === lower)
+            return Number(num);
+    }
+    return undefined;
+}
+function pipelineDurationMs(row) {
+    // SimpleInstance.createdAt / updatedAt：BAM IDL 未注单位，e2e 看是 ms。
+    const start = Number(row.createdAt);
+    const end = Number(row.updatedAt);
+    if (!Number.isFinite(start) || !Number.isFinite(end))
+        return undefined;
+    return end - start;
+}
+/**
+ * deploy history 列表的 pretty 渲染契约。
+ *
+ * BAM 返回 SimpleInstance（pipeline 实例），状态走 NodeStatus。
+ * 默认列：deploy-id（=ID）/ status / creator / created-at / duration（updatedAt-createdAt）。
+ */
+exports.deployHistorySchema = {
+    columns: [
+        { key: "ID", label: "deploy-id" },
+        {
+            key: "status_text",
+            label: "status",
+            derive: (row) => nodeStatusText(row.status),
+        },
+        { key: "creator", label: "creator" },
+        { key: "createdAt", label: "created-at", format: output_1.fmt.ms() },
+        {
+            key: "duration",
+            label: "duration",
+            format: output_1.fmt.durationMs(),
+            derive: pipelineDurationMs,
+        },
+    ],
+    strict: true,
+};
+/**
+ * deploy get 单条详情的 key-value 渲染契约（基于 SimpleInstance）。
+ *
+ * 由于 BAM 没有 by-ID 的查询接口，handler 用 listPipelineInstances 在最近窗口
+ * 里筛一条 SimpleInstance 透传过来。
+ */
+exports.deployGetSchema = {
+    columns: [
+        { key: "ID", label: "deploy-id" },
+        {
+            key: "status_text",
+            label: "status",
+            derive: (row) => nodeStatusText(row.status),
+        },
+        { key: "creator", label: "creator" },
+        { key: "updater", label: "updater" },
+        { key: "createdAt", label: "created-at", format: output_1.fmt.ms() },
+        { key: "updatedAt", label: "updated-at", format: output_1.fmt.ms() },
+        {
+            key: "duration",
+            label: "duration",
+            format: output_1.fmt.durationMs(),
+            derive: pipelineDurationMs,
+        },
+        { key: "templateID", label: "template" },
+        { key: "description" },
+        { key: "parameters" },
+        { key: "envVariables", label: "env-vars" },
+    ],
+    strict: true,
+};
+/** deploy error-log 表格渲染契约 */
+exports.errorJobSchema = {
+    columns: [
+        { key: "jobID", label: "job-id" },
+        { key: "componentName", label: "component" },
+        { key: "errorMsg", label: "error", format: output_1.fmt.truncate(120) },
+    ],
+    strict: true,
+};

package/dist/api/deploy/types.js

@@ -0,0 +1,22 @@
+"use strict";
+// 与 BAM lark.apaas.devops v1.0.326 / 1.0.327 + lark.apaas.devops_platform v1.0.247 对齐：
+//   - CLICreateForceRelease       (4070318)  创建发布          lark.apaas.devops
+//   - CliQueryPipelineInstance    (4069872)  轮询发布状态      lark.apaas.devops_platform
+//   - CliListPipelineInstances    (4073969)  分页获取发布历史  lark.apaas.devops_platform
+//   - CliGetToolInstanceErrorJobs (4073972)  获取发布错误日志  lark.apaas.devops_platform
+//
+// 发布单的唯一标识是 pipelineTaskID，对外即 deploy-id；error-log 等接口直接用它做
+// URL 路径段（instanceID）。曾经的 Release/releaseID 概念已全面废弃。
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeStatus = void 0;
+/** Pipeline 节点状态（devops_platform） */
+var NodeStatus;
+(function (NodeStatus) {
+    NodeStatus[NodeStatus["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    NodeStatus[NodeStatus["TODO"] = 1] = "TODO";
+    NodeStatus[NodeStatus["RUNNING"] = 2] = "RUNNING";
+    NodeStatus[NodeStatus["SUCCESS"] = 3] = "SUCCESS";
+    NodeStatus[NodeStatus["FAILED"] = 4] = "FAILED";
+    NodeStatus[NodeStatus["CANCELED"] = 5] = "CANCELED";
+    NodeStatus[NodeStatus["HOLD_ON"] = 6] = "HOLD_ON";
+})(NodeStatus || (exports.NodeStatus = NodeStatus = {}));

package/dist/api/file/api.js

@@ -8,7 +8,6 @@ exports.uploadFile = uploadFile;
 exports.signDownload = signDownload;
 exports.downloadFile = downloadFile;
 exports.deleteFiles = deleteFiles;
-exports.getStorageQuota = getStorageQuota;
 const error_1 = require("../../utils/error");
 const logger_1 = require("../../utils/logger");
 const client_1 = require("./client");
@@ -520,17 +519,3 @@ async function deleteFiles(opts) {
     }
     return { deleted, failed };
 }
-// ── storage quota ──
-/**
- * 后端：GET /v1/storage/app/{appId}/bucket/{bucketId}/quota
- * 单 bucket 用量；StorageQuotaBytes 暂未对接，CLI 拿到 0 时按 "—" 渲染。
- * bucketId 缺省时走默认 bucket（与 ls / stat / cp 等一致）。
- */
-async function getStorageQuota(opts) {
-    const bucketId = opts.bucketId ?? (await (0, client_1.getDefaultBucketId)(opts.appId));
-    const url = `/v1/storage/app/${encodeURIComponent(opts.appId)}/bucket/${encodeURIComponent(bucketId)}/quota`;
-    const body = await (0, client_1.doGet)(url, {
-        errorContext: `fetch storage quota for app '${opts.appId}' bucket '${bucketId}'`,
-    });
-    return extractEnvelope(body);
-}

package/dist/api/file/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.toAbsolutePath = exports.looksLikePath = exports.resetBucketCache = exports.getDefaultBucketId = exports.getStorageQuota = exports.parseTimeFilterMs = exports.resolveInputs = exports.deleteFiles = exports.downloadFile = exports.signDownload = exports.uploadFile = exports.statFile = exports.listFiles = void 0;
+exports.toAbsolutePath = exports.looksLikePath = exports.resetBucketCache = exports.getDefaultBucketId = exports.parseTimeFilterMs = exports.resolveInputs = exports.deleteFiles = exports.downloadFile = exports.signDownload = exports.uploadFile = exports.statFile = exports.listFiles = void 0;
 var api_1 = require("./api");
 Object.defineProperty(exports, "listFiles", { enumerable: true, get: function () { return api_1.listFiles; } });
 Object.defineProperty(exports, "statFile", { enumerable: true, get: function () { return api_1.statFile; } });
@@ -10,7 +10,6 @@ Object.defineProperty(exports, "downloadFile", { enumerable: true, get: function
 Object.defineProperty(exports, "deleteFiles", { enumerable: true, get: function () { return api_1.deleteFiles; } });
 Object.defineProperty(exports, "resolveInputs", { enumerable: true, get: function () { return api_1.resolveInputs; } });
 Object.defineProperty(exports, "parseTimeFilterMs", { enumerable: true, get: function () { return api_1.parseTimeFilterMs; } });
-Object.defineProperty(exports, "getStorageQuota", { enumerable: true, get: function () { return api_1.getStorageQuota; } });
 var client_1 = require("./client");
 Object.defineProperty(exports, "getDefaultBucketId", { enumerable: true, get: function () { return client_1.getDefaultBucketId; } });
 Object.defineProperty(exports, "resetBucketCache", { enumerable: true, get: function () { return client_1.resetBucketCache; } });

package/dist/api/index.js

@@ -33,10 +33,16 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.db = exports.file = exports.plugin = void 0;
+exports.deploy = exports.app = exports.observability = exports.db = exports.file = exports.plugin = void 0;
 const _plugin = __importStar(require("../api/plugin/index"));
 const _file = __importStar(require("../api/file/index"));
 const _db = __importStar(require("../api/db/index"));
+const _observability = __importStar(require("../api/observability/index"));
+const _app = __importStar(require("../api/app/index"));
+const _deploy = __importStar(require("../api/deploy/index"));
 exports.plugin = { ..._plugin };
 exports.file = { ..._file };
 exports.db = { ..._db };
+exports.observability = { ..._observability };
+exports.app = { ..._app };
+exports.deploy = { ..._deploy };

package/dist/api/observability/api.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.searchLogs = searchLogs;
+exports.searchTraces = searchTraces;
+exports.getTraces = getTraces;
+exports.queryMetricsData = queryMetricsData;
+exports.queryAnalyticsData = queryAnalyticsData;
+const http_1 = require("../../utils/http");
+const DEFAULT_ERR_CODE = "INTERNAL_OB_ERROR";
+// ── 日志 ──
+async function searchLogs(req) {
+    const url = `/v1/observability/app/${encodeURIComponent(req.appID)}/logs/search`;
+    return (0, http_1.postInnerApi)(url, req, {
+        errPrefix: "Failed to search logs",
+        defaultErrCode: DEFAULT_ERR_CODE,
+    });
+}
+// ── 链路 ──
+async function searchTraces(req) {
+    const url = `/v1/observability/app/${encodeURIComponent(req.appID)}/traces/search`;
+    return (0, http_1.postInnerApi)(url, req, {
+        errPrefix: "Failed to search traces",
+        defaultErrCode: DEFAULT_ERR_CODE,
+    });
+}
+async function getTraces(req) {
+    const url = `/v1/observability/app/${encodeURIComponent(req.appID)}/traces/${encodeURIComponent(req.traceID)}`;
+    return (0, http_1.postInnerApi)(url, req, {
+        errPrefix: "Failed to get trace",
+        defaultErrCode: DEFAULT_ERR_CODE,
+    });
+}
+// ── 监控指标 ──
+async function queryMetricsData(req) {
+    const url = `/v1/observability/app/${encodeURIComponent(req.appID)}/metrics/data/query`;
+    return (0, http_1.postInnerApi)(url, req, {
+        errPrefix: "Failed to query metrics",
+        defaultErrCode: DEFAULT_ERR_CODE,
+    });
+}
+// ── 运营指标 ──
+//
+// 走 BAM v1.0.122 起的批量端点 CLIBatchQueryAnalyticsData：
+//   - 路径 /analytics/data/batch_query（旧版 /analytics/data/query 已废弃）
+//   - 支持 metricTypes 数组，单次拉多个指标
+async function queryAnalyticsData(req) {
+    const url = `/v1/observability/app/${encodeURIComponent(req.appID)}/analytics/data/batch_query`;
+    return (0, http_1.postInnerApi)(url, req, {
+        errPrefix: "Failed to query analytics",
+        defaultErrCode: DEFAULT_ERR_CODE,
+    });
+}

package/dist/api/observability/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StatusCode = exports.SpanKind = exports.WordOperator = exports.spanSchema = exports.logItemSchema = exports.queryAnalyticsData = exports.queryMetricsData = exports.getTraces = exports.searchTraces = exports.searchLogs = void 0;
+var api_1 = require("./api");
+Object.defineProperty(exports, "searchLogs", { enumerable: true, get: function () { return api_1.searchLogs; } });
+Object.defineProperty(exports, "searchTraces", { enumerable: true, get: function () { return api_1.searchTraces; } });
+Object.defineProperty(exports, "getTraces", { enumerable: true, get: function () { return api_1.getTraces; } });
+Object.defineProperty(exports, "queryMetricsData", { enumerable: true, get: function () { return api_1.queryMetricsData; } });
+Object.defineProperty(exports, "queryAnalyticsData", { enumerable: true, get: function () { return api_1.queryAnalyticsData; } });
+var schemas_1 = require("./schemas");
+Object.defineProperty(exports, "logItemSchema", { enumerable: true, get: function () { return schemas_1.logItemSchema; } });
+Object.defineProperty(exports, "spanSchema", { enumerable: true, get: function () { return schemas_1.spanSchema; } });
+var types_1 = require("./types");
+Object.defineProperty(exports, "WordOperator", { enumerable: true, get: function () { return types_1.WordOperator; } });
+Object.defineProperty(exports, "SpanKind", { enumerable: true, get: function () { return types_1.SpanKind; } });
+Object.defineProperty(exports, "StatusCode", { enumerable: true, get: function () { return types_1.StatusCode; } });

package/dist/api/observability/schemas.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.spanSchema = exports.logItemSchema = void 0;
+const output_1 = require("../../utils/output");
+/** LogItem 渲染契约（log search） */
+exports.logItemSchema = {
+    columns: [
+        { key: "timestampNs", label: "time", format: output_1.fmt.ns("yyyy-MM-dd HH:mm:ss.SSS") },
+        { key: "severityText", label: "level" },
+        { key: "body" },
+    ],
+    strict: true,
+};
+/** Span 渲染契约（trace list / trace get 复用）。
+ *  duration 是 client-derived（BAM 只给 start/end，没有原生 durationNs 字段）。 */
+exports.spanSchema = {
+    columns: [
+        { key: "startTimeUnixNano", label: "start-time", format: output_1.fmt.ns("yyyy-MM-dd HH:mm:ss.SSS") },
+        { key: "name", label: "root-span" },
+        {
+            key: "user-id",
+            derive: (row) => {
+                return row.attributes?.user_id;
+            },
+        },
+        {
+            key: "duration",
+            label: "duration",
+            format: output_1.fmt.durationMs(),
+            derive: (row) => {
+                return row.attributes?.duration_ms;
+            },
+        },
+        { key: "traceID", label: "trace-id" },
+    ],
+    strict: true,
+};
+// metric / analytics 都改用 BAM v1.0.123 起的合并响应（points: {timestamp, values}），
+// pretty 渲染走 handler 内 pivot 后的临时 schema；不再导出固定 schema。

package/dist/api/observability/types.js

@@ -0,0 +1,27 @@
+"use strict";
+// ── 通用结构 ──
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StatusCode = exports.SpanKind = exports.WordOperator = void 0;
+/** 模糊搜索词运算符（对应后端 WordOperator） */
+var WordOperator;
+(function (WordOperator) {
+    WordOperator[WordOperator["AND"] = 0] = "AND";
+    WordOperator[WordOperator["OR"] = 1] = "OR";
+})(WordOperator || (exports.WordOperator = WordOperator = {}));
+/** OpenTelemetry SpanKind（BAM 透传） */
+var SpanKind;
+(function (SpanKind) {
+    SpanKind[SpanKind["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    SpanKind[SpanKind["INTERNAL"] = 1] = "INTERNAL";
+    SpanKind[SpanKind["SERVER"] = 2] = "SERVER";
+    SpanKind[SpanKind["CLIENT"] = 3] = "CLIENT";
+    SpanKind[SpanKind["PRODUCER"] = 4] = "PRODUCER";
+    SpanKind[SpanKind["CONSUMER"] = 5] = "CONSUMER";
+})(SpanKind || (exports.SpanKind = SpanKind = {}));
+/** Span 状态码（BAM 透传） */
+var StatusCode;
+(function (StatusCode) {
+    StatusCode[StatusCode["UNSET"] = 0] = "UNSET";
+    StatusCode[StatusCode["OK"] = 1] = "OK";
+    StatusCode[StatusCode["ERROR"] = 2] = "ERROR";
+})(StatusCode || (exports.StatusCode = StatusCode = {}));

package/dist/cli/commands/app/index.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerAppCommands = registerAppCommands;
+const shared_1 = require("../../../cli/commands/shared");
+const index_1 = require("../../../cli/handlers/app/index");
+function registerAppCommands(program) {
+    const appCmd = program.command("app").description("应用元数据管理：查看 / 修改");
+    appCmd.action(() => {
+        appCmd.outputHelp();
+    });
+    appCmd.addHelpText("after", `
+作用范围
+  仅供 Agent 在妙搭沙箱内调用。
+  应用上下文：沙箱内的默认应用。
+`);
+    registerAppGet(appCmd);
+    registerAppUpdate(appCmd);
+}
+function registerAppGet(parent) {
+    const cmd = parent
+        .command("get")
+        .description("查看应用元数据（status / type / mode / branch / 时间戳 等）")
+        .addOption((0, shared_1.appIdOption)().hideHelp())
+        .addHelpText("after", `
+JSON 输出
+  {"data": {"appID": "...", "name": "...", ...}}
+
+示例
+  $ miaoda app get
+  $ miaoda app get --json
+`);
+    cmd.action((0, shared_1.withHelp)(cmd, async (rawOpts) => {
+        (0, shared_1.rejectCliOverride)(cmd, "appId");
+        await (0, index_1.handleAppGet)({
+            appId: rawOpts.appId,
+        });
+    }));
+}
+function registerAppUpdate(parent) {
+    const cmd = parent
+        .command("update")
+        .description("修改应用名称 / 描述（至少传 --name 或 --description）")
+        .addOption((0, shared_1.appIdOption)().hideHelp())
+        .option("--name <name>", "新应用名称")
+        .option("--description <desc>", "新应用描述")
+        .addHelpText("after", `
+JSON 输出
+  与 'app get' 一致：{"data": {...新 meta...}, "next_cursor": null, "has_more": false}
+
+示例
+  $ miaoda app update --name my-store
+  $ miaoda app update --description "在线商城应用"
+`);
+    cmd.action((0, shared_1.withHelp)(cmd, async (rawOpts) => {
+        (0, shared_1.rejectCliOverride)(cmd, "appId");
+        await (0, index_1.handleAppUpdate)({
+            appId: rawOpts.appId,
+            name: rawOpts.name,
+            description: rawOpts.description,
+        });
+    }));
+}

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

@@ -1,15 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerDbCommands = registerDbCommands;
-const error_1 = require("../../../utils/error");
 const index_1 = require("../../../cli/handlers/db/index");
-function parsePositiveInt(raw) {
-    const n = Number(raw);
-    if (!Number.isInteger(n) || n < 1) {
-        throw new error_1.AppError("ARGS_INVALID", `--limit must be a positive integer (got '${raw}')`);
-    }
-    return n;
-}
 function registerDbCommands(program) {
     const dbCmd = program
         .command("db")
@@ -214,133 +206,4 @@ Examples:
   Error: Output file 'users.csv' already exists
     hint: Use -f to specify a different path, or --force to overwrite.
 `);
-    // ── changelog ──
-    dbCmd
-        .command("changelog")
-        .summary("查看 DDL 变更历史")
-        .description("列出 DDL 变更（CREATE / ALTER / DROP），支持按表、时间窗筛选与游标分页。")
-        .usage("[flags]")
-        .option("--table <name>", "只看某张表的 DDL 变更")
-        .option("--since <time>", "起始时间（含），相对 1h/2d / 日期 YYYY-MM-DD / ISO 8601")
-        .option("--until <time>", "结束时间（含），同 --since 格式")
-        .option("--limit <n>", "单次返回上限（默认 20）", parsePositiveInt, 20)
-        .option("--cursor <token>", "分页游标，从上次响应的 next_cursor 取值")
-        .option("--all", "自动翻页直到取完所有记录")
-        .action(async function () {
-        await (0, index_1.handleDbChangelog)(this.optsWithGlobals());
-    });
-    // ── audit ──
-    const auditCmd = dbCmd
-        .command("audit")
-        .summary("表级数据审计开关与查询")
-        .description("配置表的数据审计 (enable/disable/retention)，查询审计状态与日志。")
-        .usage("<command> [flags]");
-    auditCmd.action(() => {
-        auditCmd.outputHelp();
-    });
-    auditCmd
-        .command("status")
-        .summary("查看审计开关状态（不传 table 返列表）")
-        .usage("[table] [flags]")
-        .argument("[table]", "表名；省略时返所有已配置审计的表")
-        .action(async function (table) {
-        await (0, index_1.handleDbAuditStatus)(table, this.optsWithGlobals());
-    });
-    auditCmd
-        .command("enable")
-        .summary("启用表审计")
-        .usage("<table> [flags]")
-        .argument("<table>", "目标表名")
-        .option("--retention <ttl>", "保留时长 7d / 30d / 180d / 360d / forever", "7d")
-        .action(async function (table) {
-        await (0, index_1.handleDbAuditEnable)(table, this.optsWithGlobals());
-    });
-    auditCmd
-        .command("disable")
-        .summary("关闭表审计")
-        .usage("<table> [flags]")
-        .argument("<table>", "目标表名")
-        .action(async function (table) {
-        await (0, index_1.handleDbAuditDisable)(table, this.optsWithGlobals());
-    });
-    auditCmd
-        .command("list")
-        .summary("查询审计日志")
-        .description("按表 + 时间窗查询审计日志（INSERT / UPDATE / DELETE）。")
-        .usage("<table...> [flags]")
-        .argument("<tables...>", "一个或多个表名（多表时空表会汇总到 stderr）")
-        .option("--since <time>", "起始时间")
-        .option("--until <time>", "结束时间")
-        .option("--limit <n>", "单次返回上限（默认 50）", parsePositiveInt, 50)
-        .option("--cursor <ts>", "分页游标，传上一页末条 event_time")
-        .action(async function (tables) {
-        await (0, index_1.handleDbAuditList)(tables, this.optsWithGlobals());
-    });
-    // ── migration ──
-    const migrationCmd = dbCmd
-        .command("migration")
-        .summary("多环境管理（dev / online，仅专家模式应用）")
-        .description("init 拆分双环境，diff 预览待发布变更，apply 把 dev 同步到 online。")
-        .usage("<command> [flags]");
-    migrationCmd.action(() => {
-        migrationCmd.outputHelp();
-    });
-    migrationCmd
-        .command("init")
-        .summary("初始化多环境（不可逆）")
-        .usage("[flags]")
-        .option("--sync-data", "同时把现有数据复制到 dev")
-        .option("--yes", "跳过 TTY 确认")
-        .action(async function () {
-        await (0, index_1.handleDbMigrationInit)(this.optsWithGlobals());
-    });
-    migrationCmd
-        .command("diff")
-        .summary("预览 dev → online 待发布变更")
-        .usage("[flags]")
-        .action(async function () {
-        await (0, index_1.handleDbMigrationDiff)(this.optsWithGlobals());
-    });
-    migrationCmd
-        .command("apply")
-        .summary("应用 dev 变更到 online（多 DDL 单事务原子）")
-        .usage("[flags]")
-        .option("--yes", "跳过 TTY 二次确认")
-        .action(async function () {
-        await (0, index_1.handleDbMigrationApply)(this.optsWithGlobals());
-    });
-    // ── recovery（PITR）──
-    const recoveryCmd = dbCmd
-        .command("recovery")
-        .summary("基于时间点恢复（PITR）")
-        .description("把数据库整体恢复到指定时间点，diff 预览影响范围，apply 不可逆覆盖。")
-        .usage("<command> [flags]");
-    recoveryCmd.action(() => {
-        recoveryCmd.outputHelp();
-    });
-    recoveryCmd
-        .command("diff")
-        .summary("预览恢复到指定时间点的影响范围")
-        .usage("<timestamp> [flags]")
-        .argument("<timestamp>", "目标时间，YYYY-MM-DD / YYYY-MM-DD HH:MM[:SS] / ISO 8601")
-        .action(async function (target) {
-        await (0, index_1.handleDbRecoveryDiff)(target, this.optsWithGlobals());
-    });
-    recoveryCmd
-        .command("apply")
-        .summary("触发恢复到指定时间点（不可逆覆盖）")
-        .usage("<timestamp> [flags]")
-        .argument("<timestamp>", "目标时间，YYYY-MM-DD / YYYY-MM-DD HH:MM[:SS] / ISO 8601")
-        .option("--yes", "跳过 TTY 二次确认")
-        .action(async function (target) {
-        await (0, index_1.handleDbRecoveryApply)(target, this.optsWithGlobals());
-    });
-    // ── quota ──
-    dbCmd
-        .command("quota")
-        .summary("查看数据库用量与限额")
-        .usage("[flags]")
-        .action(async function () {
-        await (0, index_1.handleDbQuota)(this.optsWithGlobals());
-    });
 }