@lark-apaas/miaoda-cli 0.1.2 → 0.1.3

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

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_POLL_INTERVAL_MS = exports.waitForPipeline = exports.handleDeployErrorLog = exports.handleDeployHistory = exports.handleDeployGet = exports.handleDeploy = void 0;
+var deploy_1 = require("./deploy");
+Object.defineProperty(exports, "handleDeploy", { enumerable: true, get: function () { return deploy_1.handleDeploy; } });
+var get_1 = require("./get");
+Object.defineProperty(exports, "handleDeployGet", { enumerable: true, get: function () { return get_1.handleDeployGet; } });
+var history_1 = require("./history");
+Object.defineProperty(exports, "handleDeployHistory", { enumerable: true, get: function () { return history_1.handleDeployHistory; } });
+var error_log_1 = require("./error-log");
+Object.defineProperty(exports, "handleDeployErrorLog", { enumerable: true, get: function () { return error_log_1.handleDeployErrorLog; } });
+var polling_1 = require("./polling");
+Object.defineProperty(exports, "waitForPipeline", { enumerable: true, get: function () { return polling_1.waitForPipeline; } });
+Object.defineProperty(exports, "DEFAULT_POLL_INTERVAL_MS", { enumerable: true, get: function () { return polling_1.DEFAULT_POLL_INTERVAL_MS; } });

package/dist/cli/handlers/deploy/polling.js

@@ -0,0 +1,162 @@
+"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.DEFAULT_POLL_INTERVAL_MS = void 0;
+exports.waitForPipeline = waitForPipeline;
+const ora_1 = __importDefault(require("ora"));
+const api = __importStar(require("../../../api/index"));
+const error_1 = require("../../../utils/error");
+const output_1 = require("../../../utils/output");
+const index_1 = require("../../../api/deploy/index");
+/** 默认轮询间隔（毫秒） */
+exports.DEFAULT_POLL_INTERVAL_MS = 2_000;
+const TERMINAL_STATUSES = [
+    index_1.NodeStatus.SUCCESS,
+    index_1.NodeStatus.FAILED,
+    index_1.NodeStatus.CANCELED,
+];
+function defaultSleep(ms) {
+    return new Promise((res) => setTimeout(res, ms));
+}
+/**
+ * 轮询 pipeline 状态直到终态或超时。
+ *
+ * - JSON 模式：轮询期间静默；终态后由 caller 输出最终信封。
+ * - Pretty 非 TTY：同 JSON。
+ * - Pretty TTY：底部行用 braille spinner 显示当前正在跑的 stage（每 80ms 跳一帧），
+ *   stage 转终态时把 ✓ stage(12.3s) 打到 spinner 上方然后清掉 spinner 行。
+ *
+ * 终态返回最终 PipelineInstance，调用方再决定怎么 emit。
+ */
+async function waitForPipeline(opts) {
+    const interval = opts.intervalMs ?? exports.DEFAULT_POLL_INTERVAL_MS;
+    const timeoutMs = opts.timeoutSec * 1000;
+    const sleep = opts.sleep ?? defaultSleep;
+    const now = opts.now ?? Date.now;
+    const start = now();
+    // ora 自身在非 TTY 下会降级为不动画，但我们额外加 isJsonMode 闸门：JSON / 字段选择
+    // 模式下完全静默。
+    const showProgress = !(0, output_1.isJsonMode)() && process.stdout.isTTY;
+    const printedStages = new Set();
+    const spinner = showProgress
+        ? (0, ora_1.default)({ text: "等待调度", spinner: "dots", stream: process.stdout }).start()
+        : null;
+    try {
+        for (;;) {
+            const resp = await api.deploy.queryPipelineInstance({
+                appID: opts.appID,
+                instanceID: opts.pipelineTaskID,
+            });
+            const detail = normalizePipelineInstance(resp);
+            if (spinner)
+                advanceProgress(detail, printedStages, spinner);
+            if (TERMINAL_STATUSES.includes(detail.status)) {
+                return detail;
+            }
+            if (now() - start >= timeoutMs) {
+                throw new error_1.AppError("DEPLOY_TIMEOUT", `轮询发布状态超时（${String(opts.timeoutSec)}s）`, {
+                    retryable: true,
+                    next_actions: [
+                        `Run \`miaoda deploy get <deploy-id>\` 查看最新状态`,
+                        `加大 --timeout 后重试`,
+                    ],
+                });
+            }
+            await sleep(interval);
+        }
+    }
+    finally {
+        spinner?.stop();
+    }
+}
+/**
+ * 每轮 poll 的进度推进：刚转终态的 stage 用 stopAndPersist 落定为永久行，
+ * 再把 spinner 文本切到当前 running stage；没有 running 时显示"等待调度"。
+ */
+function advanceProgress(detail, printed, spinner) {
+    const stages = Array.isArray(detail.stages) ? detail.stages : [];
+    for (const stage of stages) {
+        if (printed.has(stage.id))
+            continue;
+        if (!TERMINAL_STATUSES.includes(stage.status))
+            continue;
+        spinner.stopAndPersist({
+            symbol: stageSymbol(stage),
+            text: formatStageBody(stage),
+        });
+        printed.add(stage.id);
+    }
+    const running = stages.find((s) => s.status === index_1.NodeStatus.RUNNING);
+    const text = running ? `${running.name} 执行中` : "等待调度";
+    if (spinner.isSpinning) {
+        spinner.text = text;
+    }
+    else {
+        spinner.start(text);
+    }
+}
+function normalizePipelineInstance(resp) {
+    const keyedDetail = readPipelineDetail(resp, "pipelineInstanceDetail") ?? readPipelineDetail(resp, "detail");
+    if (keyedDetail)
+        return keyedDetail;
+    if (isPipelineInstance(resp))
+        return resp;
+    throw new error_1.AppError("DEPLOY_RESPONSE_INVALID", "发布状态响应缺少 pipeline detail", {
+        next_actions: ["使用 --verbose 重试以查看请求 logid，并联系平台排查响应结构"],
+    });
+}
+function readPipelineDetail(resp, key) {
+    if (!(key in resp))
+        return undefined;
+    const detail = resp[key];
+    return isPipelineInstance(detail) ? detail : undefined;
+}
+function isPipelineInstance(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const item = value;
+    return typeof item.status === "number";
+}
+function stageSymbol(stage) {
+    return stage.status === index_1.NodeStatus.SUCCESS ? "✓" : stage.status === index_1.NodeStatus.FAILED ? "✗" : "•";
+}
+function formatStageBody(stage) {
+    const cost = stage.costTime >= 0 ? `(${(stage.costTime / 1000).toFixed(1)}s)` : "";
+    const status = (0, index_1.nodeStatusText)(stage.status) ?? String(stage.status);
+    return `${stage.name}${cost ? ` ${cost}` : ""} ${status}`.trim();
+}

package/dist/cli/handlers/file/cp.js

@@ -44,7 +44,6 @@ const api = __importStar(require("../../../api/index"));
 const output_1 = require("../../../utils/output");
 const render_1 = require("../../../utils/render");
 const error_1 = require("../../../utils/error");
-const shared_1 = require("../../../cli/commands/shared");
 const colors_1 = require("../../../utils/colors");
 const MAX_UPLOAD_BYTES = 100 * 1024 * 1024;
 /**
@@ -233,7 +232,7 @@ async function handleDownload(appId, remoteRaw, localRaw) {
     }
 }
 async function handleFileCp(src, dst, opts) {
-    const appId = (0, shared_1.resolveAppId)(opts);
+    const appId = opts.appId;
     // src 本地存在 → upload；其他情况（file_ref / `/path` / 裸文件名）→ download
     if (isLocalSrc(src)) {
         return handleUpload(appId, src, dst, opts.rename);

package/dist/cli/handlers/file/ls.js

@@ -38,7 +38,6 @@ const api = __importStar(require("../../../api/index"));
 const output_1 = require("../../../utils/output");
 const render_1 = require("../../../utils/render");
 const error_1 = require("../../../utils/error");
-const shared_1 = require("../../../cli/commands/shared");
 const index_1 = require("../../../api/file/index");
 /**
  * 把位置参数 `query` 路由到 `--path` 或 `--name`：
@@ -65,7 +64,7 @@ function resolveQueryRouting(opts) {
     return { name: opts.query };
 }
 async function handleFileLs(opts) {
-    const appId = (0, shared_1.resolveAppId)(opts);
+    const appId = opts.appId;
     // commander 已经把 --limit 解析为 number；保留 ?? undefined 兼容老调用
     const limit = opts.limit;
     const sizeGt = opts.sizeGt ? (0, render_1.parseSize)(opts.sizeGt) : undefined;

package/dist/cli/handlers/file/rm.js

@@ -40,7 +40,6 @@ exports.handleFileRm = handleFileRm;
 const api = __importStar(require("../../../api/index"));
 const output_1 = require("../../../utils/output");
 const error_1 = require("../../../utils/error");
-const shared_1 = require("../../../cli/commands/shared");
 const index_1 = require("../../../api/file/index");
 const render_1 = require("../../../utils/render");
 const colors_1 = require("../../../utils/colors");
@@ -133,7 +132,7 @@ async function handleFileRm(paths, opts) {
     if (totalCount > MAX_BATCH) {
         throw new error_1.AppError("FILE_BATCH_TOO_MANY", `Batch size ${String(totalCount)} exceeds the 100 limit`);
     }
-    const appId = (0, shared_1.resolveAppId)(opts);
+    const appId = opts.appId;
     // destructive guardrail
     const tty = (0, render_1.isStdoutTty)();
     if (tty && !opts.yes) {

package/dist/cli/handlers/file/sign.js

@@ -38,7 +38,6 @@ const api = __importStar(require("../../../api/index"));
 const output_1 = require("../../../utils/output");
 const render_1 = require("../../../utils/render");
 const error_1 = require("../../../utils/error");
-const shared_1 = require("../../../cli/commands/shared");
 const index_1 = require("../../../api/file/index");
 const MAX_EXPIRES_SECONDS = 30 * 86400;
 const DEFAULT_EXPIRES_SECONDS = 86400; // 1d（PRD 规定）
@@ -64,7 +63,7 @@ async function resolveFilePath(appId, input) {
     return resolved.file.path;
 }
 async function handleFileSign(file, opts) {
-    const appId = (0, shared_1.resolveAppId)(opts);
+    const appId = opts.appId;
     let expiresSec = DEFAULT_EXPIRES_SECONDS;
     if (opts.expires) {
         expiresSec = (0, render_1.parseDuration)(opts.expires);

package/dist/cli/handlers/file/stat.js

@@ -38,7 +38,6 @@ const api = __importStar(require("../../../api/index"));
 const output_1 = require("../../../utils/output");
 const render_1 = require("../../../utils/render");
 const error_1 = require("../../../utils/error");
-const shared_1 = require("../../../cli/commands/shared");
 const index_1 = require("../../../api/file/index");
 /**
  * 解析 `<file>` 为后端 head 可用的 filePath。
@@ -67,7 +66,7 @@ async function resolveFile(appId, input) {
     return head;
 }
 async function handleFileStat(file, opts) {
-    const appId = (0, shared_1.resolveAppId)(opts);
+    const appId = opts.appId;
     const info = await resolveFile(appId, file);
     if ((0, output_1.isJsonMode)()) {
         (0, output_1.emitOk)(info);

package/dist/cli/handlers/observability/analytics.js

@@ -0,0 +1,212 @@
+"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.handleObservabilityAnalytics = handleObservabilityAnalytics;
+const api = __importStar(require("../../../api/index"));
+const output_1 = require("../../../utils/output");
+const args_1 = require("../../../utils/args");
+const helpers_1 = require("./helpers");
+const GRANULARITY_TO_UNIT = {
+    day: "DAY",
+    daily: "DAY",
+    "1d": "DAY",
+    "1h": "HOUR",
+    hour: "HOUR",
+    week: "WEEK",
+    weekly: "WEEK",
+    "1w": "WEEK",
+    month: "MONTH",
+    monthly: "MONTH",
+    "1M": "MONTH",
+};
+/**
+ * <analytics-name> + --series → metricType → 表头列名（=对应 --series 取值）。
+ *
+ * - users 缺省返回 active/new/total 三条线（多线视图）。
+ * - page-view 当前 BAM 只有一个 PAGE_VIEW metricType；不同 series 通过 device_type 过滤区分；
+ *   表头 label 直接对应 --series 取值（all-view / desktop-view / mobile-view）。
+ */
+const ANALYTICS_LABELS = {
+    users: {
+        ACTIVE_USER: "active-users",
+        NEW_USER: "new-users",
+        TOTAL_USER: "total-users",
+    },
+};
+/** miaoda observability analytics <analytics-name> */
+async function handleObservabilityAnalytics(opts) {
+    if (!opts.analyticsName)
+        (0, args_1.failArgs)("<analytics-name> 必填");
+    const appID = opts.appId;
+    const { metricTypes, labelByMetric, extraFilters } = resolveAnalyticsSelection(opts.analyticsName, opts.series);
+    const timeAggregationUnit = opts.granularity
+        ? (GRANULARITY_TO_UNIT[opts.granularity] ?? opts.granularity.toUpperCase())
+        : "DAY";
+    const nowMs = Date.now();
+    const sinceMs = (0, helpers_1.parseToMs)(opts.since) ?? nowMs - 30 * 86_400_000;
+    const untilMs = (0, helpers_1.parseToMs)(opts.until) ?? nowMs;
+    const bucket = timeAggregationUnit;
+    const fieldFilters = (0, helpers_1.buildFieldFilters)([
+        { key: "path", value: opts.page ? (0, helpers_1.eqFilter)(opts.page) : undefined },
+        ...extraFilters,
+    ]);
+    const req = {
+        appID,
+        metricTypes,
+        startTimestampNs: (0, helpers_1.msToNs)(sinceMs),
+        endTimestampNs: (0, helpers_1.msToNs)((0, helpers_1.ceilMsToBucket)(untilMs, bucket)),
+        timeAggregationUnit,
+        fieldFilters,
+    };
+    const resp = await api.observability.queryAnalyticsData(req);
+    emitAnalyticsResponse(resp, labelByMetric);
+}
+// ── 渲染 ────────────
+//
+// BAM v1.0.123 起返回 points: [{timestampNs, dimensions, values: {metricType: v}}]——
+// 服务端已把多 metricType 合并到同 timestampNs 的 row，下游直接平铺即可。
+// JSON 模式：原样透传 points（保留 BAM 原 metricType 作为 values 的 key）。
+// Pretty 模式：把 values 里的 metricType 重命名成 CLI label（active-users 等），
+//   再走 buildAnalyticsPivotSchema 渲染。
+function emitAnalyticsResponse(resp, labelByMetric) {
+    const points = resp.points ?? [];
+    // analytics 不分页，但补齐 has_more / next_cursor 与 log/trace 信封形状对齐
+    if ((0, output_1.isJsonMode)()) {
+        (0, output_1.emit)({ data: points, next_cursor: null, has_more: false });
+        return;
+    }
+    const { rows, seriesLabels } = renameAndSort(points, labelByMetric);
+    if (rows.length === 0) {
+        (0, output_1.emit)({ data: [], next_cursor: null, has_more: false });
+        return;
+    }
+    (0, output_1.emit)({ data: rows, next_cursor: null, has_more: false }, buildAnalyticsPivotSchema(seriesLabels));
+}
+function renameAndSort(points, labelByMetric) {
+    // 列顺序按 labelByMetric 声明顺序，避免 BAM 返回顺序波动影响表头
+    const seriesLabels = Object.values(labelByMetric);
+    const rows = points.map((point) => {
+        const row = { timestampNs: point.timestampNs };
+        for (const [metricType, value] of Object.entries(point.values)) {
+            const label = labelByMetric[metricType] ?? metricType;
+            row[label] = value;
+        }
+        return row;
+    });
+    rows.sort((a, b) => b.timestampNs - a.timestampNs);
+    return { rows, seriesLabels };
+}
+function buildAnalyticsPivotSchema(seriesLabels) {
+    return {
+        columns: [
+            { key: "timestampNs", label: "time", format: output_1.fmt.ns() },
+            ...seriesLabels.map((label) => ({ key: label, label })),
+        ],
+        strict: true,
+    };
+}
+/**
+ * <analytics-name> + --series → metricTypes[] + label 映射 + 附加过滤
+ *
+ * users:
+ *   - 缺省 series → 三条线全返回（active-users/new-users/total-users）
+ *   - 单值 series → 对应单条线
+ * page-view:
+ *   - 缺省/all-view → 单条 PAGE_VIEW，无 device 过滤，label = "all-view"
+ *   - desktop-view / mobile-view → 单条 PAGE_VIEW + device_type 过滤，label = --series 值
+ */
+function resolveAnalyticsSelection(cliName, series) {
+    const extras = [];
+    const normalizedSeries = normalizeAnalyticsSeries(cliName, series);
+    if (cliName === "users") {
+        if (normalizedSeries === "active-users")
+            return single("ACTIVE_USER", "active-users", extras);
+        if (normalizedSeries === "new-users")
+            return single("NEW_USER", "new-users", extras);
+        if (normalizedSeries === "total-users")
+            return single("TOTAL_USER", "total-users", extras);
+        // 缺省：三条线
+        return all(ANALYTICS_LABELS.users, extras);
+    }
+    if (cliName === "page-view") {
+        if (normalizedSeries === "desktop-view") {
+            extras.push({ key: "device_type", value: (0, helpers_1.eqFilter)("desktop") });
+            return single("PAGE_VIEW", "desktop-view", extras);
+        }
+        if (normalizedSeries === "mobile-view") {
+            extras.push({ key: "device_type", value: (0, helpers_1.eqFilter)("mobile") });
+            return single("PAGE_VIEW", "mobile-view", extras);
+        }
+        // 缺省 / all-view → 不附加 device 过滤
+        return single("PAGE_VIEW", "all-view", extras);
+    }
+    // 兜底：CLI 名直接当 metricType + label
+    return single(cliName, cliName, extras);
+}
+function normalizeAnalyticsSeries(cliName, series) {
+    if (series === undefined)
+        return undefined;
+    if (cliName === "users") {
+        if (series === "active")
+            return "active-users";
+        if (series === "new")
+            return "new-users";
+        if (series === "total")
+            return "total-users";
+    }
+    if (cliName === "page-view") {
+        if (series === "all")
+            return "all-view";
+        if (series === "desktop")
+            return "desktop-view";
+        if (series === "mobile")
+            return "mobile-view";
+    }
+    return series;
+}
+function single(metricType, label, extras) {
+    return {
+        metricTypes: [metricType],
+        labelByMetric: { [metricType]: label },
+        extraFilters: extras,
+    };
+}
+function all(labelByMetric, extras) {
+    return {
+        metricTypes: Object.keys(labelByMetric),
+        labelByMetric,
+        extraFilters: extras,
+    };
+}

package/dist/cli/handlers/observability/helpers.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ceilMsToBucket = exports.floorMsToBucket = exports.msToSec = exports.msToNs = exports.parseToSec = exports.parseToNs = exports.parseToMs = exports.parseTimeToMs = void 0;
+exports.eqFilter = eqFilter;
+exports.rangeFilter = rangeFilter;
+exports.fuzzyFilter = fuzzyFilter;
+exports.buildFieldFilters = buildFieldFilters;
+exports.validateLimit = validateLimit;
+const args_1 = require("../../../utils/args");
+const index_1 = require("../../../api/observability/index");
+// 时间解析助手已抽到 utils/time.ts；这里 re-export 维持 observability handler 的旧 import 路径。
+var time_1 = require("../../../utils/time");
+Object.defineProperty(exports, "parseTimeToMs", { enumerable: true, get: function () { return time_1.parseTimeToMs; } });
+Object.defineProperty(exports, "parseToMs", { enumerable: true, get: function () { return time_1.parseToMs; } });
+Object.defineProperty(exports, "parseToNs", { enumerable: true, get: function () { return time_1.parseToNs; } });
+Object.defineProperty(exports, "parseToSec", { enumerable: true, get: function () { return time_1.parseToSec; } });
+Object.defineProperty(exports, "msToNs", { enumerable: true, get: function () { return time_1.msToNs; } });
+Object.defineProperty(exports, "msToSec", { enumerable: true, get: function () { return time_1.msToSec; } });
+Object.defineProperty(exports, "floorMsToBucket", { enumerable: true, get: function () { return time_1.floorMsToBucket; } });
+Object.defineProperty(exports, "ceilMsToBucket", { enumerable: true, get: function () { return time_1.ceilMsToBucket; } });
+// ── filter 构造 ──
+//
+// BAM FieldFilter 是「类型分桶 + 算子」结构（str/i64/double），不是扁平字段；
+// 字符串字段无 server-side contains，模糊匹配走 fuzzyFilter。
+/** 字符串字段等值过滤 → { str: { eq } } */
+function eqFilter(value, type = "str") {
+    const v = type !== "str" ? Number(value) : value;
+    return { [type]: { eq: v } };
+}
+/** i64 数值范围过滤 → { i64: { gte, lte } }；输入接受 string（CLI flag）或 number */
+function rangeFilter(opts) {
+    const i64 = {};
+    if (opts.gte !== undefined)
+        i64.gte = Number(opts.gte);
+    if (opts.lte !== undefined)
+        i64.lte = Number(opts.lte);
+    return { i64 };
+}
+/** 模糊搜索过滤器；默认 AND 运算符 */
+function fuzzyFilter(keyword, operator = index_1.WordOperator.AND) {
+    return { include: { words: [keyword], operator } };
+}
+/**
+ * 把若干条件按 key 装到 fieldFilters。值为 undefined 的条目跳过；
+ * 全部跳过时返回 undefined（避免传空 map）。
+ */
+function buildFieldFilters(entries) {
+    const out = {};
+    let added = false;
+    for (const { key, value } of entries) {
+        if (value === undefined)
+            continue;
+        out[key] = value;
+        added = true;
+    }
+    return added ? out : undefined;
+}
+// ── 校验 ──
+/** limit 校验（API 限制 1~100） */
+function validateLimit(limit, defaultLimit = 50) {
+    const n = Number.isFinite(limit) ? limit : defaultLimit;
+    if (n <= 0 || n > 100) {
+        (0, args_1.failArgs)(`--limit 必须在 1~100 之间，收到 ${String(n)}`);
+    }
+    return n;
+}

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

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleObservabilityAnalytics = exports.handleObservabilityMetric = exports.handleObservabilityTraceGet = exports.handleObservabilityTraceList = exports.handleObservabilityLog = void 0;
+var log_1 = require("./log");
+Object.defineProperty(exports, "handleObservabilityLog", { enumerable: true, get: function () { return log_1.handleObservabilityLog; } });
+var trace_1 = require("./trace");
+Object.defineProperty(exports, "handleObservabilityTraceList", { enumerable: true, get: function () { return trace_1.handleObservabilityTraceList; } });
+Object.defineProperty(exports, "handleObservabilityTraceGet", { enumerable: true, get: function () { return trace_1.handleObservabilityTraceGet; } });
+var metric_1 = require("./metric");
+Object.defineProperty(exports, "handleObservabilityMetric", { enumerable: true, get: function () { return metric_1.handleObservabilityMetric; } });
+var analytics_1 = require("./analytics");
+Object.defineProperty(exports, "handleObservabilityAnalytics", { enumerable: true, get: function () { return analytics_1.handleObservabilityAnalytics; } });

package/dist/cli/handlers/observability/log.js

@@ -0,0 +1,94 @@
+"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.handleObservabilityLog = handleObservabilityLog;
+const api = __importStar(require("../../../api/index"));
+const output_1 = require("../../../utils/output");
+const index_1 = require("../../../api/observability/index");
+const helpers_1 = require("./helpers");
+/** miaoda observability log */
+async function handleObservabilityLog(opts) {
+    const appID = opts.appId;
+    const appEnv = "runtime";
+    const limit = (0, helpers_1.validateLimit)(opts.limit ?? 50);
+    // 过滤 key 对齐 BAM 查询字段名：
+    //   - 顶层字段：severity_text / trace_id（输出仍映射成 severityText / traceID）
+    //   - attributes 里的业务字段：module / user_id / page / api / ob_data_id（snake_case，
+    //     依据 BAM IDL 的 LogItem.attributes 描述："包括 tenant_id, module, user_id, page, api 等"）
+    //   - duration_ms 暂未在 BAM 描述里明确列出，留 TODO 等 e2e 验证
+    const fieldFilters = (0, helpers_1.buildFieldFilters)([
+        { key: "severity_text", value: opts.level ? (0, helpers_1.eqFilter)(opts.level) : undefined },
+        { key: "attributes.ob_data_id", value: opts.logId ? (0, helpers_1.eqFilter)(opts.logId) : undefined },
+        { key: "trace_id", value: opts.traceId ? (0, helpers_1.eqFilter)(opts.traceId) : undefined },
+        { key: "module", value: opts.module ? (0, helpers_1.eqFilter)(opts.module) : undefined },
+        { key: "user_id", value: opts.userId ? (0, helpers_1.eqFilter)(opts.userId, "i64") : undefined },
+        { key: "page", value: opts.page ? (0, helpers_1.eqFilter)(opts.page) : undefined },
+        { key: "api", value: opts.api ? (0, helpers_1.eqFilter)(opts.api) : undefined },
+        {
+            // TODO: 确认 BAM 是否真用 duration_ms 作为 attribute key
+            key: "duration_ms",
+            value: opts.minDuration !== undefined || opts.maxDuration !== undefined
+                ? (0, helpers_1.rangeFilter)({ gte: opts.minDuration, lte: opts.maxDuration })
+                : undefined,
+        },
+    ]);
+    const fuzzyFilter = opts.grep
+        ? {
+            include: {
+                words: [opts.grep],
+                operator: 1, // AND
+            },
+        }
+        : undefined;
+    const req = {
+        appID,
+        appEnv,
+        startTimestampNs: (0, helpers_1.parseToNs)(opts.since),
+        endTimestampNs: (0, helpers_1.parseToNs)(opts.until),
+        limit,
+        pageToken: opts.cursor,
+        fieldFilters,
+        fuzzyFilter,
+    };
+    const resp = await api.observability.searchLogs(req);
+    emitSearchLogsResponse(resp);
+}
+function emitSearchLogsResponse(resp) {
+    (0, output_1.emit)({
+        data: resp.logItems ?? [],
+        next_cursor: resp.hasMore ? resp.nextPageToken : null,
+        has_more: resp.hasMore,
+    }, index_1.logItemSchema);
+}